Files
truthmark/CONTRIBUTING.md
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

20 lines
827 B
Markdown

# Contributing
This guide is for people contributing to Truthmark itself from this checkout.
## Local Bootstrap
```bash
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](README.md) user-facing; put contributor setup here.