mirror of
https://github.com/merlinhu1/truthmark.git
synced 2026-08-25 07:53:25 +02:00
fcfd5f7adc
* fix: harden workflow helper manifests and reports * docs: add helper script portability design * fix: reject failed helper statuses in completed reports * fix: align helper report sections metadata * fix: preserve sync helper statuses in parser * test: harden helper validator negatives * feat: add Copilot and Gemini Truthmark surfaces - generate Copilot and Gemini workflow skill packages with helper manifests - add Gemini subagent surfaces and validate helper CLI plumbing - update README/docs for helper-package support Verification: npm run check * docs: simplify README workflow surface overview Replace long generated file lists with conceptual layers and Mermaid architecture diagrams across localized READMEs. Verification: node dist/main.js check --json; npm run package:check * docs: show agent CLI feedback loop in README diagram Clarify that host-native agent workflows can call the installed Truthmark CLI for validation, indexing, and helper checks. Verification: node dist/main.js check --json; npm run package:check * fix: wrap validate JSON output in command envelope Return helper validation results under data.validation for --json output while preserving the existing human-readable validate output. Verification: npm run check; truthmark check/index JSON diagnostics. * fix: clarify helper validation status reporting Add explicit helper-status policy to Truth Sync and Truth Document surfaces so standalone Copilot prompts and Gemini commands only report ran/passed after the installed CLI validator succeeds. Update README and workflow docs to describe the shared installed-CLI validator contract instead of saying standalone surfaces mark helper packages unavailable. Verification: npm run check; npm run package:check; truthmark check/index JSON diagnostics. * fix: normalize helper status ids during validation Parse helper status entries with the same regex used for syntax validation and compare captured helper IDs against required helpers. Adds regressions for extra whitespace after helper bullets in Truth Sync and Truth Document reports. Verification: npm run check; npm run package:check; truthmark check/index JSON diagnostics. * fix: parse write lease YAML structurally * chore: bump version to 1.5.0 * docs: include validate in repo CLI boundary * fix: enforce workflow report validator contracts * fix: require manual review files in blocked sync reports * feat: add Truthmark Portal workflow surfaces - add Portal workflow guidance, config/defaults, and generated provider surfaces - cover Portal config path boundaries and generated surface contracts - clarify project-local policy docs are optional and config-driven --------- Co-authored-by: MerlinH <merlinh221@gmail.com>
2.7 KiB
2.7 KiB
Portal And Host-Native Workflow Surface Updates
Previous version: 1.4.0 New version: 1.6.0 Diff basis: release/1.4.0..HEAD plus working tree Version action: minor SemVer rationale: The pending payload adds backward-compatible generated-surface capabilities, including Copilot and Gemini host-native workflow support plus the optional manual Truthmark Portal presentation workflow, and hardens shipped helper validator contracts.
Release payload:
- Added GitHub Copilot and Gemini CLI host-native workflow surfaces, including skill packages, Gemini subagents, and Gemini command argument support.
- Added the optional manual Truthmark Portal workflow for generating a committed static HTML presentation site from Markdown truth docs when
truthmark-portal.enabledis set. - Added Portal config normalization and validation for safe repo-relative output and template settings.
- Reworked helper manifests to use installed Truthmark CLI validator commands instead of repo-local helper scripts.
- Hardened Truth Sync and Truth Document helper-report validation, including failed helper statuses, flexible helper-status whitespace, preserved helper-status parsing, blocked Truth Sync manual-review-file enforcement, and report-body validation before appending a validator's own helper status.
- Wrapped
truthmark validate ... --jsonhelper output in the standard command envelope underdata.validation. - Clarified helper validation status reporting across generated workflow surfaces and README diagrams.
- Parsed
truthmark validate write-leaseinputs structurally as YAML and validatedallowedWrites/forbiddenWritesbefore applying path-safety and pattern checks. - Removed hard assumptions that every repository has specific optional policy docs or route files in generated workflow wording.
User-facing release text:
- Truthmark now installs richer GitHub Copilot and Gemini CLI workflow surfaces, with generated skill packages, Gemini subagents, and command argument support where those hosts support them.
- Repositories can opt into Truthmark Portal, a manual presentation workflow that generates committed static HTML from Markdown truth docs while keeping Markdown canonical.
- Workflow helper validation now runs through installed
truthmark validate ... --jsoncommands with standard JSON envelopes and stricter report/write-lease validation. - Generated workflow wording is more portable across repositories that do not use the same optional policy-doc paths.
Verification:
npm run checkpasses after the Portal config-validation fixes and generated surface refresh.node dist/main.js check --jsonpasses with 0 error diagnostics and 0 review diagnostics after rerunningnode dist/main.js init --json.