Files
truthmark/CONTRIBUTING.md
T
2dc0da40ff chore: refresh Truthmark to 2.2.0 (#15)
* 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>
2026-06-16 00:54:46 +10:00

827 B

Contributing

This guide is for people contributing to Truthmark itself from this checkout.

Local Bootstrap

npm install
npm run dev -- init
npm run dev -- check

Use this source-checkout flow when changing Truthmark's own code, templates, or generated workflow surfaces. Downstream repositories should rely on the committed workflow surfaces after truthmark init.

What To Verify

  • If you edit src/templates/**, src/agents/**, or generated workflow renderers, rerun npm run dev -- init and review the diffs in AGENTS.md, .agents/skills/, and .opencode/skills/.
  • If you change behavior in src/checks/**, src/init/**, src/sync/**, or src/realize/**, run the relevant tests and npm run dev -- check.
  • Keep the public README.md user-facing; put contributor setup here.