External/truthmark
1
0
Fork 0
mirror of https://github.com/merlinhu1/truthmark.git synced 2026-08-25 07:53:25 +02:00
Code Issues Packages Projects Releases Wiki Activity

chore: refresh Truthmark to 2.2.0 (#15)

Browse Source 
* 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>
This commit is contained in:
Merlin's Cat
2026-06-16 00:54:46 +10:00
committed by GitHub
co-authored by MerlinH
parent 7e68f5d216
commit 2dc0da40ff
309 changed files with 6483 additions and 6151 deletions
Download Patch File Download Diff File Expand all files Collapse all files
.opencode/agents/truth-claim-verifier.md
+1 -1
View File
@@ -16,7 +16,7 @@ permission:
"grep *": allow
---
# Generated by Truthmark 2.1.0. Rerun truthmark init after upgrades.
# Generated by Truthmark 2.2.0. Rerun truthmark init after upgrades.
Manual invocation: @truth-claim-verifier
.opencode/agents/truth-doc-reviewer.md
+2 -2
View File
@@ -16,12 +16,12 @@ permission:
"grep *": allow
---
# Generated by Truthmark 2.1.0. Rerun truthmark init after upgrades.
# Generated by Truthmark 2.2.0. Rerun truthmark init after upgrades.
Manual invocation: @truth-doc-reviewer
Stay read-only.
Review assigned canonical truth docs for frontmatter, source_of_truth, required template sections, Evidence checked entries, Product Decisions, and Rationale.
Review assigned canonical truth docs for compact frontmatter, required template sections, final Source References entries, Evidence checked entries, and lane-appropriate decision sections (Product Decisions in product truth, Engineering Decisions in engineering truth).
Flag README.md files used as behavior truth targets, mixed-owner docs, and shape repairs that should move to Truth Structure.
Do not edit files, stage changes, or rewrite docs.
Return JSON only with keys: scope, filesReviewed, findings, evidence, confidence, recommendedWorkflow, notes.
.opencode/agents/truth-doc-writer.md
+3 -2
View File
@@ -8,7 +8,8 @@ permission:
glob: allow
edit:
"*": deny
"docs/truthmark/truth/**": allow
"docs/truthmark/product/**": allow
"docs/truthmark/engineering/**": allow
"docs/truthmark/routes/areas.md": allow
"docs/truthmark/routes/areas/**/*.md": allow
task: deny
@@ -21,7 +22,7 @@ permission:
"git diff*": allow
---
# Generated by Truthmark 2.1.0. Rerun truthmark init after upgrades.
# Generated by Truthmark 2.2.0. Rerun truthmark init after upgrades.
Manual invocation: @truth-doc-writer
.opencode/agents/truth-route-auditor.md
+8 -1
View File
@@ -16,14 +16,21 @@ permission:
"grep *": allow
---
# Generated by Truthmark 2.1.0. Rerun truthmark init after upgrades.
# Generated by Truthmark 2.2.0. Rerun truthmark init after upgrades.
Manual invocation: @truth-route-auditor
Stay read-only.
Audit one bounded Truthmark route, area, or doc shard assigned by the parent.
Inspect .truthmark/config.yml and route files only when they exist; then inspect mapped truth docs and relevant implementation files directly.
Use a route-first bounded strategy: narrow audits inspect only the routed area and directly linked counterpart docs; root-wide health first builds a cheap route-map/index from route files, then inspects only mismatches and linked leaves.
Find missing, stale, broad, overloaded, catch-all, mixed-owner, or unrouteable ownership.
Validate route ownership against lane-specific roots and route kind:
- confirm mapped truth docs resolve to the correct lane root (product or engineering) for their kind
- flag mismatch between assigned route kind and resolved doc kind (for example, product-capability routed to engineering paths)
- verify route-doc linkage for lane pairings via realized_by and realizes before recommending edits
- inspect product counterparts for engineering docs only when route YAML claims a product relationship, or when the parent explicitly asks for user-visible product coverage
- treat missing product links for user-visible engineering docs as a second-pass diagnostic, not a default full-document read.
Do not edit files, stage changes, or propose broad rewrites.
Return JSON only with keys: scope, filesReviewed, findings, evidence, confidence, recommendedWorkflow, notes.
recommendedWorkflow must be one of: none, truthmark-document, truthmark-structure.