feat: add workflow helper validators and host-native surfaces (#7)

* 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

---------

Co-authored-by: Hermes Agent <hermes-agent@users.noreply.github.com>

.opencode/agents/truth-claim-verifier.md

@@ -16,7 +16,7 @@ permission:
     "grep *": allow
 ---
 
-# Generated by Truthmark 1.4.0. Rerun truthmark init after upgrades.
+# Generated by Truthmark 1.5.0. Rerun truthmark init after upgrades.
 
 Manual invocation: @truth-claim-verifier
 

.opencode/agents/truth-doc-reviewer.md

@@ -16,7 +16,7 @@ permission:
     "grep *": allow
 ---
 
-# Generated by Truthmark 1.4.0. Rerun truthmark init after upgrades.
+# Generated by Truthmark 1.5.0. Rerun truthmark init after upgrades.
 
 Manual invocation: @truth-doc-reviewer
 

.opencode/agents/truth-doc-writer.md

@@ -21,7 +21,7 @@ permission:
     "git diff*": allow
 ---
 
-# Generated by Truthmark 1.4.0. Rerun truthmark init after upgrades.
+# Generated by Truthmark 1.5.0. Rerun truthmark init after upgrades.
 
 Manual invocation: @truth-doc-writer
 

.opencode/agents/truth-route-auditor.md

@@ -16,7 +16,7 @@ permission:
     "grep *": allow
 ---
 
-# Generated by Truthmark 1.4.0. Rerun truthmark init after upgrades.
+# Generated by Truthmark 1.5.0. Rerun truthmark init after upgrades.
 
 Manual invocation: @truth-route-auditor