mirror of
https://github.com/merlinhu1/truthmark.git
synced 2026-08-25 07:53:25 +02:00
fb2c469005
* feat: add Truth Sync intent checklist * feat: add canonical agent workflow package Add the .truthmark/agent canonical workflow package, convert duplicated host workflow bodies into adapter/expanded-adapter surfaces, and validate canonical/adapter freshness in Truthmark check. Refresh generated surfaces and package metadata for Truthmark 2.3.0, with OpenSpec tasks completed and release notes added. * fix: preserve native workflow skill packages * docs: record native skill package decision * fix: drop unused agent workflow package * chore: remove implemented OpenSpec docs * chore: release workflow fixes as 2.2.2 * fix: remove agent-visible version markers * fix: drop generated surface version markers * feat: capture decision context in Truth Sync --------- Co-authored-by: MerlinH <merlinh221@gmail.com>
1.5 KiB
1.5 KiB
Optional Helper CLI Policy
Truthmark-managed generated file. Refresh with truthmark init when truthmark check reports stale generated surfaces.
Optional helper CLI commands may collect deterministic checkout facts or validate artifacts. If the Truthmark CLI is unavailable or cannot return the declared helper output, continue manually using this procedure and report which helper was skipped. Helper output is derived evidence; it does not override direct checkout inspection, workflow write boundaries, or parent acceptance.
Runner detection:
- Check that the declared Truthmark CLI runner is available before invoking a helper.
- Invoke helpers through the installed
truthmark validate ... --jsonCLI command using argv-style arguments from helper-manifest.yml. - If unavailable, failing, or returning incompatible output, treat the helper as skipped and use the manual fallback.
- Do not fail the workflow solely because a helper cannot run.
Available helpers:
- validate-document-report: optional truthmark; manual fallback: manually validate support/report-template.md required sections and structured Evidence checked entries
- validate-write-lease: optional truthmark; manual fallback: manually compare declared allowedWrites and forbiddenWrites with the actual changed files
Final reports should include helper status when helpers are declared for this workflow:
Helper scripts:
- validate-document-report: ran, passed
- validate-write-lease: skipped, no write lease used