Files
truthmark/changes/2026-05-16-version-140.md
MerlinHandGitHub 403637022c Workflow Verifier And Writer Agents v1.4.0 (#5)
* feat(workflows): add verifier agent surfaces

Generate project-scoped read-only verifier agents for Codex, Claude Code, GitHub Copilot, and OpenCode.

Wire workflow manifests, generated surfaces, init diagnostics, sync classification, docs, and tests through the new subagent contract.

* feat(workflows): add leased truth doc writer agents

Add write-capable truth-doc-writer generated surfaces for Codex, Claude, Copilot, and OpenCode, guarded by explicit write leases. Tighten Truth Sync and Truth Document subagent contracts so parents validate leases, changed files, and worker reports before accepting doc updates.

* feat(workflows): add Truth Preview and workflow support files

Add the explicit read-only Truth Preview workflow across the manifest, generated host surfaces, docs, and tests.

Move generated skill hosts to compact SKILL.md entrypoints with support procedure, report, and lease files, and add write-worker report acceptance validation against actual lease diffs.
2026-05-16 22:26:28 +10:00

2.1 KiB

Workflow Verifier And Writer Agents

Previous version: 1.3.0 New version: 1.4.0 Diff basis: release/1.3.0..HEAD plus working tree Version action: minor SemVer rationale: The pending payload adds generated read-only verifier-agent workflow surfaces, leased truth-doc-writer workflow surfaces where hosts support agents, and workflow subagent guidance, which are backward-compatible generated-surface and shipped-workflow capabilities.

Release payload:

  • Added project-scoped read-only verifiers plus leased truth-doc-writer agents for Codex, Claude Code, GitHub Copilot, and OpenCode where hosts support agents.
  • Added workflow skill and prompt guidance for bounded subagent dispatch while keeping parent workflows responsible for final reports, write leases, and diff validation.
  • Added deterministic write-worker acceptance validation so parent workflows can parse worker reports and compare actual worker diffs against leases before accepting completed work.
  • Updated init, classification, markdown discovery, generated-surface tests, workflow truth docs, root README variants, and routing docs for the new verifier and leased writer agent surfaces.
  • Moved the external agent-skills workflow review out of docs/ai/ into non-canonical research/.
  • Renamed the host-neutral workflow renderer from src/templates/codex-skills.ts to src/templates/workflow-surfaces.ts.
  • Tightened versioning and change-note standards so requested package versions must be checked against the full pending release payload.

User-facing release text:

  • Truthmark now installs read-only verifiers plus leased truth-doc-writer agents where hosts support agents, so workflows can delegate bounded evidence checks and parent-leased doc shards without giving up parent-owned write control.
  • Package version bumps now require release notes that describe the actual release payload since the previous version, not just the version-number edit.

Verification:

  • npm test -- tests/package-files.test.ts
  • npm run check
  • npm run release:check
  • npm run dev -- init --json
  • npm run dev -- check --json