mirror of https://github.com/merlinhu1/truthmark.git synced 2026-08-25 07:53:25 +02:00

Files

T

17ed1599a3 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>

2026-05-20 11:15:24 +10:00

2.1 KiB

Raw Permalink Blame History

Helper Validators And Host-Native Workflow Surfaces

Previous version: 1.4.0 New version: 1.5.0 Diff basis: release/1.4.0..HEAD plus working tree Version action: minor SemVer rationale: The pending payload adds backward-compatible Copilot and Gemini generated workflow surfaces and improves shipped helper validator contracts, which are generated-surface and user-visible workflow capabilities.

Release payload:

Added GitHub Copilot and Gemini CLI host-native workflow surfaces, including skill packages, Gemini subagents, and Gemini command argument support.
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 ... --json helper output in the standard command envelope under data.validation.
Clarified helper validation status reporting across generated workflow surfaces and README diagrams.
Parsed truthmark validate write-lease inputs structurally as YAML and validated allowedWrites / forbiddenWrites before applying path-safety and pattern checks.

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.
Workflow helper validation now runs through installed truthmark validate ... --json commands with standard JSON envelopes and stricter report/write-lease validation.

Verification:

npm test -- --run tests/agents/workflow-helper-scripts.test.ts tests/sync/report.test.ts tests/agents/truth-sync.test.ts tests/agents/truth-document.test.ts tests/cli/validate.test.ts
npm run check
npm run package:check
node dist/main.js check --json
node dist/main.js index --json
node dist/main.js init --json
node dist/main.js validate sync-report /tmp/truthmark-sync-report.md --json

2.1 KiB Raw Permalink Blame History

Helper Validators And Host-Native Workflow Surfaces

2.1 KiB

Raw Permalink Blame History