Skip to content

merlinhu1/truthmark

vrelease/1.2.4 Breaking

This release includes 3 breaking changes for platform teams planning a safe upgrade.

✓ No known CVEs patched
Read the diff → Tool health → What is this tool? →

✓ No known CVEs patched in this version

Topics

agentic-coding ai-agents ai-coding ai-tools ai-workflow code-review
+5 more
developer-tools devtools documentation opencode typescript

Affected surfaces

auth rbac

Summary

AI summary

Updates align truthmark-check, truthmark-document, and truthmark-realize with stricter ownership gates, evidence requirements, and clarified scopes for Truthmark 1.2.4.

Full changelog

Summary

This change updates the three Truthmark skill definitions to align behavior, boundaries, and safety gates with Truthmark 1.2.4 workflow expectations:

What changed

truthmark-check

  • Reclassifies the skill purpose and clarifies scope exclusions (not for normal lint/test/typecheck or finish-time sync).
  • Adds explicit ownership/topology checks (mixed-owner/index-like docs, route alignment).
  • Expands evidence requirements and documents evidence-backed reporting format.

truthmark-document

  • Tightens ownership gate before editing truth docs (prevents mixed-owner or broad doc in-place edits).
  • Adds explicit Product Decisions / Rationale preservation/restructure rules.
  • Upgrades doc-kind handling with docs/templates/<kind>-doc.md and adds evidence-first workflow.
  • Updates references from docs/features/**/*.md to docs/truth/**/*.md.
  • Adds stronger reporting structure for routed behavior, restructuring, and evidence.

truthmark-realize

  • Clarifies this skill is for doc-to-code realization only, excluding doc-first implementation, topological repair, or checks.
  • Adds ownership gate with explicit blocking conditions (broad/mixed-owner/unrouteable/stale docs).
  • Expands read scope to include area route files and tests before implementation updates.

Why this matters

These updates reduce accidental out-of-scope edits, prevent ownership-boundary violations, and force evidence-backed actions across check/document/realize workflows to keep truth and code alignment auditable.

Testing / validation

  • Not run (documentation-only changes to skill definitions).

Notes

  • truthmark-version was incremented to 1.2.4 in all three updated skills.

Breaking Changes

  • truthmark-check purpose reclassified; no longer used for normal lint/test/typecheck or finish‑time sync
  • truthmark-document now enforces strict ownership gate before edits, preventing mixed‑owner or broad doc in‑place changes
  • truthmark-realize clarified to be for doc‑to‑code realization only, excluding topological repair or checks

Weekly OSS security release digest.

The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.

No spam, unsubscribe anytime.

Share this release

Track merlinhu1/truthmark

Get notified when new releases ship.

Sign up free

About merlinhu1/truthmark

All releases →

Related context

Beta — feedback welcome: [email protected]