Fix the 12 relative links broken since before this branch (defunct
docs/truth/workflows/ paths, moved .codex/skills/ -> .agents/skills/
paths, and one link to a test file that was never created) and correct
a stale generated-surfaces list in the same research note.
Remove "Maintaining repository truth" from all 16 READMEs and the user
guide's documentation list. It links docs/repo/standards/maintaining-
repository-truth.md, which states it is for Truthmark's own maintainers
and carries scope: repo-local, but sat in storefront lists next to
product-facing docs as if it were guidance for people installing
Truthmark.
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Repository policy lived only in docs/repo/ai/repo-rules.md, which an
agent reads once via a tool call and a summarizer drops first. The
instruction files are injected as session context instead, so they
survive compaction.
Generate a repo-rules region into both files from the source doc's
always-on section rather than moving or symlinking policy there. The doc
stays the authority and the region is generated output under rule 8, so
no second file claims authority. Symlinks were rejected: sync/classify.ts
already treats these files as derived, Git on Windows materializes
symlinks as text when core.symlinks is off, and init and uninstall write
each path independently.
Marker names are referenced without comment syntax in the source doc
because a literal marker inside the rendered region duplicates it in the
instruction files and makes the Truthmark managed block unparseable.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Drop github-copilot from .truthmark/config.yml and let the init lifecycle
prune the 29 generated surfaces it owned, then remove the leftover
.github/copilot-instructions.md preamble.
Copilot remains a supported platform of the product. Only this
repository's installation changed, so allPlatforms render assertions keep
their Copilot coverage; the checked-in path lists in
tests/templates/generated-surfaces.test.ts follow what this repository
actually installs and drop their .github entries.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Repo-local policy docs (ai, standards, architecture, research) sat as
siblings of the dogfooded product truth tree, so the only signal that
they ship to nobody was one sentence inside repo-rules.md. Agents reason
from paths continuously and read prose once, which made it easy to cite
repo-local policy as evidence about the installed product.
Move them under docs/repo/, declare scope: repo-local in frontmatter,
and enforce four invariants in tests/doc-scope.test.ts. The check is a
repo-local test rather than a src/checks diagnostic because truthmark
check runs in downstream repositories, which have no such boundary.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Merlin's CatGitHubCopilot Autofix powered by AI <62310815+github-advanced-security[bot]@users.noreply.github.com>MerlinHCopilot Autofix powered by AI <62310815+github-advanced-security[bot]@users.noreply.github.com>
* feat: add workflow eval framework
Add workflow evaluation scenarios, rubrics, schemas, and runner scripts for installed Truthmark workflows.
Move research notes under docs/research and migrate tests from Vitest to node:test.
* Potential fix for pull request finding 'CodeQL / Replacement of a substring with itself'
Co-authored-by: Copilot Autofix powered by AI <62310815+github-advanced-security[bot]@users.noreply.github.com>
---------
Co-authored-by: MerlinH <merlinh221@gmail.com>
Co-authored-by: Copilot Autofix powered by AI <62310815+github-advanced-security[bot]@users.noreply.github.com>
* Split Truthmark product and engineering truth lanes
* chore: align truthmark docs and runtime with lane updates
* chore: bump package version to 2.2.0
* chore: refresh truthmark surfaces for 2.2.0 and document release
* chore: migrate legacy truth docs to engineering legacy path
* chore: remove legacy docs/truth legacy docs from repository
* chore: trim document command prompts to adapter stubs
* chore: customize truth root README guidance per lane
* chore: make doc reviewer guidance lane-specific and helper-rendered
* fix: remove duplicate check lane-classification render in evidence gate
* fix: make realize doc example lane-agnostic to product and engineering
* feat: separate product and engineering truth lanes
* test: restore workflow surface coverage
* Fix workflow lane prompt boundaries
* test: guard read-only generated surface wording
* Fix manual Realize lane guidance
* fix: harden route relationship diagnostics
Validate reciprocal product and engineering route links, gate missing product-link review diagnostics on product evidence, and reject duplicate route entries with divergent relationship metadata.
* fix: merge duplicate route relationships
Allow repeated route entries for the same truth document, kind, and lane to contribute additive relationship metadata. Keep hard validation errors for kind and lane conflicts and emit merged relationships in RouteMap output.
* fix: make route relationships local
Treat realized_by and realizes metadata as route-local navigation edges. Validate target existence and lane compatibility without requiring reciprocal declarations, and document the chosen semantics.
---------
Co-authored-by: MerlinH <merlinh221@gmail.com>
* 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>
* 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.
MerlinH