Files
truthmark/.claude/skills/truthmark-document/support/helper-policy.md
T
9e330a0fd3 fix(cli): fail on error diagnostics (#11)
* fix(cli): fail on error diagnostics

* chore: release 1.6.1

* feat(init): refresh truth doc templates

* fix(init): preserve custom template preambles

* ci: limit GitHub token permissions

* ci: update setup-node action

---------

Co-authored-by: MerlinH <merlinh221@gmail.com>
2026-05-31 00:35:18 +10:00

1.4 KiB

Optional Helper CLI Policy

Generated by Truthmark 1.6.1. Rerun truthmark init after upgrades.

Optional helper CLI commands may collect deterministic checkout facts or validate artifacts. If the Truthmark CLI is unavailable or too old for a declared helper, 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 the declared Truthmark CLI runner before invoking a helper.
  • Invoke helpers through the installed truthmark validate ... --json CLI command using argv-style arguments from helper-manifest.yml.
  • If unavailable or version-mismatched, 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>=1.6.1; manual fallback: manually validate support/report-template.md required sections and structured Evidence checked entries
  • validate-write-lease: optional truthmark>=1.6.1; 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