merlinhu1/truthmark

vrelease/2.1.0 Breaking

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

Published 1mo AI Agents & Assistants

View tool

✓ 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

ReleasePort's take

Light signal

editorial:auto 1mo

The release replaces the old `docs.roots` and top‑level `authority` configuration with a new `truthmark.workspace` contract, and adds a JSON Health Scorecard via `truthmark check --json`.

Why it matters: Refactoring config to `truthmark.workspace` simplifies deployments; the new JSON scorecard provides an actionable health metric for monitoring pipelines.

Summary

AI summary

Workspace refactor consolidates Truthmark config under docs/truthmark/ and adds a compact JSON Health Scorecard via truthmark check --json.

Changes in this release

Type	Severity	Summary	CVE
Feature	Medium	Adds `truthmark check --json` output with `data.scorecard`, a compact Truth Health Scorecard summary. Adds `truthmark check --json` output with `data.scorecard`, a compact Truth Health Scorecard summary. Source: llm_adapter@2026-06-12 Confidence: high	—
Refactor	Low	Replaces old `docs.roots` / top-level `authority` configuration with cleaner `truthmark.workspace` contract. Replaces old `docs.roots` / top-level `authority` configuration with cleaner `truthmark.workspace` contract. Source: llm_adapter@2026-06-12 Confidence: high	—
Refactor	Low	Removes stale preflight/instructions assumptions and broad context‑loading patterns from generated workflow surfaces. Removes stale preflight/instructions assumptions and broad context‑loading patterns from generated workflow surfaces. Source: llm_adapter@2026-06-12 Confidence: high	—

Full changelog

Truthmark 2.1.0 consolidates the v2 workspace refactor and adds a compact Truth Health Scorecard for machine-readable repository-truth review.

What changed since v1.6.1

Clean v2 workspace

Truthmark-owned routes, templates, truth docs, and generated presentation output now live under docs/truthmark/. The old broad docs.roots / top-level authority configuration model has been replaced by the cleaner truthmark.workspace contract.

Truth Health Scorecard

truthmark check --json now includes data.scorecard, a compact truthmark-scorecard/v0 summary over routing coverage, ownership clarity, source traceability, branch freshness, generated-surface freshness, truth-doc structure, and decision/rationale preservation.

Bounded agent workflows

Generated workflow surfaces for Codex, Claude Code, OpenCode, GitHub Copilot, and Gemini now favor committed host-native files, route-first fallback, progressive-disclosure support files, and explicit write boundaries. Stale preflight/instructions assumptions and broad context-loading patterns were removed.

Breaking Changes

Removed old `docs.roots` / top-level `authority` configuration model; replaced by `truthmark.workspace` contract.
Eliminated stale preflight/instructions assumptions and broad context‑loading patterns in generated agent workflow surfaces.

View diff on GitHub

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

Share on X Share on Bluesky

Track merlinhu1/truthmark

Get notified when new releases ship.

About merlinhu1/truthmark

All releases →