mirror of https://github.com/merlinhu1/truthmark.git synced 2026-08-25 07:53:25 +02:00

Files

T

a083b703fa feat: add Truthmark health scorecard and bounded workflow contracts (#13 )

* feat: add OpenSpec-driven workflow state

* docs: plan generated playbooks workflow contract

* feat: add truth health scorecard

Release Truthmark 2.1.0 with check JSON scorecard output.

Archive the completed OpenSpec pass 4 scorecard change and update generated truth surfaces.

* fix: unblock truthmark scorecard review

- restore and update coverage for scorecard/evidence/workflow behavior
- make truthmark-sync select a cheap local base when --base is omitted
- report malformed evidence YAML blocks as diagnostics instead of throwing

* fix: tighten workflow boundaries

* fix: fail closed when sync has no comparison base

* fix: tighten truth health review coverage

- only parse fenced YAML evidence blocks with top-level evidence markers
- convert coverage fixtures to valid v2 config and assert non-vacuous diagnostics
- update Truthmark truth docs for source traceability and workflow-state tests

* docs: clarify source traceability diagnostics

* docs: harden optional CLI workflow boundary

* docs: clarify product boundary is repo-local

* fix: bound truthmark workflow fallback behavior

- make live workflow preflight use the one-call instructions contract
- keep missing-CLI fallback bounded for Sync, Document, Structure, and Realize
- add routing and generated-surface coverage plus refreshed host surfaces

* test: cover no-cli workflow fallback bounds

- assert route-first fallback wording in generated workflow surfaces
- clarify progressive-disclosure support files are conditional
- align overview docs with bounded no-CLI behavior

* docs: route workflow eval coverage

* fix: remove workflow instructions preflight

* fix: remove stale workflow preflight wording

* fix: remove generic workflow validation blocks

* fix: avoid duplicated markdown context JSON

* fix: keep workflow status manifest-only

* docs: align truth docs with v2 hierarchy

---------

Co-authored-by: MerlinH <merlinh221@gmail.com>

2026-06-13 04:09:45 +10:00

1.5 KiB

Raw Permalink Blame History

Truthmark v2 workspace refactor

Previous version: 1.6.1 New version: 2.0.0 Diff basis: release/1.6.1..HEAD plus working tree Version action: major SemVer rationale: The pending payload intentionally rejects legacy docs.roots and top-level authority config shapes and changes shipped default workspace, routing, scaffold, and generated workflow behavior.

Release payload:

Replace the old repo-doc hierarchy defaults with a version: 2 truthmark.workspace config model.
Move Truthmark-owned routes, truth docs, templates, and generated Portal output under docs/truthmark/ while leaving project-owned docs/ai, docs/architecture, and docs/standards outside the Truthmark workspace.
Refresh generated host-native workflow surfaces, managed instruction blocks, routing tests, and README examples for the clean v2 workspace.

User-facing release text:

Truthmark 2.0.0 introduces the clean workspace-scoped config model and removes compatibility loading for legacy docs.roots / top-level authority configs. Re-run truthmark config / truthmark init and update existing repositories to the truthmark.workspace layout before relying on generated workflows.

Verification:

npx tsx src/cli/main.ts init --json
npx vitest run tests/git/repository.test.ts tests/evidence/validate.test.ts tests/fs/paths.test.ts tests/evals/workflow-routing.test.ts
npm run release:check
npx tsx src/cli/main.ts check --json
npx tsx src/cli/main.ts index --json
README stale-path sweep and heading-depth parity check across localized READMEs.

1.5 KiB Raw Permalink Blame History

Truthmark v2 workspace refactor

1.5 KiB

Raw Permalink Blame History