Releases: KKenny0/Tracework
Release list
Tracework 0.12.0
Direct reporting, protected Daily updates, and correction-aware project memory.
Changes:
- Reports now resolve work and personal scope consistently, can use scoped facts already visible in the conversation, and keep uncertain scope local until it is resolved.
- Daily reports use shorter prose and protected updates that preserve hand edits, unrelated content, and changes made after a draft was prepared.
- Weekly briefs load instructions to match the requested depth, Monthly reviews use raw evidence with editorial context, and Roadmaps disclose incomplete thread coverage.
- Corrections and retractions preserve original records while Daily, Weekly, Monthly, Recall, Query, and Roadmap share corrected facts, historical knowledge cutoffs, and period-end risk and question states.
- Decision queries distinguish recorded claims from verified effects, retain unresolved conflicts, and stop returning stale facts when their raw sources are missing.
- Targeted Capture Day recovery checks the selected project before opening transcripts, while temporary or partial inspection leaves stored evidence and recovery watermarks unchanged.
Compatibility:
- Once correction records exist, keep a correction-aware reader installed; fix forward instead of downgrading to an older plugin that ignores corrections.
- Existing reports are regenerated only when requested.
Validation:
- The full maintenance test suite passed, including 13 evidence-flow, 11 session, 9 semantic-admission, 9 Daily-reporting, 10 state, packaging checks, and 44 executable regression scenarios.
- All 8 skill bundles, the documentation build, Claude manifests, and a clean-candidate tag dry run passed.
- Isolated Codex and Claude installs passed with byte-matched 0.12.0 bundles, including protected Daily updates and current-versus-historical correction reads.
- Windows runtime behavior and independent reader acceptance remain unverified; 6 documented-only regression scenarios remain documented-only, and Daily file locks do not coordinate arbitrary external editors.
Tracework 0.9.1
Patch release for reliable capture and simpler report workflows.
Changes:
- Historical Capture Day entries now stay in the correct reporting period, while a separate capture timestamp records when they were recovered.
- Concurrent captures preserve every entry, and failed writes leave existing records intact.
- Monthly reviews can use raw entries without a Daily archive, and monthly archiving preserves Daily content with either supported date format.
- Weekly briefs load fewer instructions by keeping slide-specific rules behind explicit slide requests, while Capture retains stated goals and acceptance gates.
Validation:
- 8 skill bundle checks, TypeScript build, doctor tests, 7 evidence-flow tests, 10 session tests, 9 Semantic Admission tests, and 44 executable regressions passed in an isolated candidate.
- Codex and Claude marketplace installs passed in isolated configurations, including historical capture and raw-only Monthly checks from installed paths.
- Claude manifests and the clean-candidate tag dry run passed.
- Windows runtime locking and independent reader acceptance remain unverified; 6 documented-only regression scenarios remain documented-only.
Tracework 0.9.0
Minor release for clearer Weekly reporting through evidence-bounded change explanation cards.
Changes:
- Adds optional Change Explanation Cards to Weekly briefs and slide outlines when a material change needs a same-axis Before/After comparison and a grounded problem/solution explanation.
- Keeps proposed designs outside the current After state, uses one primary visual at most, and leaves simple results as compact text.
- Adds rejection probes for target-as-After claims, unsupported problems, comparison-axis drift, and decorative visuals.
Validation:
- 8 skill bundle parity checks passed.
- TypeScript build, doctor tests, 10 session tests, 8 Semantic Admission tests, and 44 executable regressions passed.
- Claude plugin manifests validated and
claude plugin tag --dry-runresolvedtracework--v0.9.0from a clean candidate.
Tracework 0.8.0
Minor release for clearer Weekly PPT reporting and safer source-grounded production.
Changes:
- Makes same-department Weekly decks start from each work goal, result, status, and remaining boundary instead of implementation inventory.
- Keeps independent work streams separate and chooses slide splits from the audience's cognitive task rather than a fixed page pattern.
- Adds source recovery that asks once for missing material, preserves proof responsibilities, and omits or degrades exact diagrams when grounding is unavailable.
- Adds an honest weak-model failure path, comparable-input cost accounting, and Capture warnings for design sources that may disappear.
Validation:
- 8 skill bundle parity checks passed.
- TypeScript build, doctor tests, 10 session tests, 8 Semantic Admission tests, and 44 executable regressions passed.
- W31 user semantic acceptance passed for the revised same-department Weekly candidate.
- Claude plugin manifests validated and
claude plugin tag --dry-runresolvedtracework--v0.8.0from a clean candidate.
Open acceptance:
- Exact code-grounded W31 P3-E remains open until rerun with the real storyboard repository and a qualified captured snapshot; 0.8.0 now asks for that grounding or omits the exact architecture view.
Tracework 0.7.1
Patch release for Weekly PPT evidence grounding and acceptance integrity.
Changes:
- Adds repository-qualified Capture snapshots for code-grounded Weekly architecture claims.
- Requires snapshot selection to match the target repository and contain the evidence commit in its ancestry.
- Makes Weekly PPT revision classification exhaustive and rejects missing, duplicate, or nonexistent slide IDs.
- Refines peer-facing Weekly PPT Markdown, audience framing, visual utility, and W31 revision benchmarks.
Validation:
- 8 skill bundle parity checks passed.
- TypeScript build, doctor tests, 10 session tests, and 37 executable regressions passed.
- Claude plugin manifests validated. The installed Claude CLI does not expose plugin tag dry-run.
Open acceptance:
- Real W31 P3-E remains documented-only until rerun on the computer that contains the storyboard repository and a real captured repository snapshot. See benchmarks/W31-P3E-TODO.md.
Tracework 0.7.0
Highlights
- Weekly briefs now start from the intended goal, explain material variance, and close with the next commitment instead of reading like an activity log.
- Weekly PPT mode now produces a standalone Markdown Deck organized by Story-level Why and Goal, with grounded facts, relationships, comparisons, mechanisms, numbers, and risks ready for visual translation.
- Complex results split only when design judgment and implementation mechanism need independent evidence and visual reasoning; simple results stay on one page.
Reliability
- Adds content-materialization, split-or-merge, standalone-reading, takeaway-inference, and blind-content-handoff gates to the Weekly benchmark.
- Keeps source skills and the generated Codex plugin bundle synchronized across the new Weekly contract, template, documentation, and regression fixtures.
Upgrade Note
No configuration or raw-schema migration is required. Update the installed Tracework plugin to 0.7.0 to use the new Weekly brief and PPT-ready Markdown output.
Validation
npm --prefix cli run copy-skillsnpm --prefix cli run check-skills- CLI build, doctor tests, 10 session-scan tests, and 33 executable regression fixtures
npm --prefix site run buildclaude plugin validate .claude-plugin/plugin.jsonclaude plugin validate .claude-plugin/marketplace.jsonclaude plugin tag --dry-run .- Real W28 standalone reading, takeaway inference, and blind PPT content handoff
- GitHub CI run
30265127804passed on commit1552e6d
Tracework 0.6.0
Highlights
- Adds three explicit Weekly output modes: a quick response, a management-facing brief, and an opt-in slide outline. The default brief keeps scope, evidence boundaries, results, risks, and next closure gates together.
- Lets Daily and Weekly reports provide a useful first-run local fallback when there is no configured vault, while clearly marking the available evidence boundary.
- Makes Capture receipts point to the next reporting surface, so session evidence naturally continues into the day or week closeout.
- Refreshes the public onboarding and before/after showcase to make the first useful Tracework action easier to understand.
Reliability
- Ships Tracework plugin
0.6.0consistently across Codex and Claude manifests and keeps private local evaluation files out of packaging checks. - Keeps local planning notes untracked, so working plans do not enter the public repository history.
Upgrade Note
No configuration or raw-schema migration is required. Update the installed Tracework plugin to 0.6.0 to use the new report modes and first-run fallback.
Validation
npm --prefix cli run copy-skillsnpm --prefix cli run check-skills- CLI build, doctor tests, 10 session-scan tests, and 24 executable regression fixtures
npm --prefix site run buildclaude plugin validate .claude-plugin/plugin.jsonclaude plugin validate .claude-plugin/marketplace.json- Isolated Codex and Claude installs of
tracework@tracework 0.6.0; installed Weekly skill SHA-256 matched the packaged source - CI run
29970538371and Deploy Site run29970538382passed on commit88e1dc6
Tracework 0.5.1
Highlights
- Upgrades explicit
weekly PPToutput into a department-ready 6-10 slide outline for individual contributors, with management conclusions, portfolio coverage, maturity, risks, and closure targets. - Makes core technical results explain four distinct layers: Before/After state change, solution-logic diagrams, implementation narrative, and separate data or validation evidence.
- Requires core mechanism pages to cover the main path, key branches, fallbacks, outputs, and invariants while keeping the main deck to at most two or three logic diagrams.
- Keeps routine maintenance visible without manufacturing decorative architecture diagrams, and keeps raw evidence mappings out of the main deck.
- Synchronizes the current Weekly presentation contract across the Chinese and English README and documentation site.
Reliability
- Makes release checks deterministic on Windows by isolating test configuration and subprocess working directories, forcing UTF-8 for Python fixtures, materializing platform-native absolute paths, and comparing canonical file paths.
- Updates
js-yamlto4.3.0, clearing the CLI dependency audit findings.
Upgrade Note
No configuration or raw-schema migration is required. Update the installed Tracework plugin to 0.5.1 to use the new Weekly presentation contract.
Validation
npm --prefix cli run copy-skillsnpm --prefix cli run check-skillsnpm --prefix cli run test— 24 executable regression fixtures and 10 session-scan tests passednpm --prefix cli audit --audit-level=high— 0 vulnerabilitiesnpm --prefix site run buildclaude plugin validate .claude-plugin/plugin.jsonclaude plugin validate .claude-plugin/marketplace.json- Clean-worktree packaging plus isolated Codex and Claude installs of
tracework@tracework 0.5.1; installed Weekly skill hashes matched the source - CI run
29820157780and Deploy Site run29820157768passed on commitecbb4bc
Tracework 0.4.1
Highlights
- Fixes Tracework session capture on Windows by replacing the Unix-only
fcntldependency with a platform-aware manifest lock using Windowsmsvcrtand POSIXfcntl. - Keeps the Stop hook silent and non-blocking when session scanning is disabled, while preserving serialized manifest writes for concurrent capture.
- Synchronizes the fix across the source tree, Codex and Claude plugin bundles, and the CLI skill mirror, with Windows regression coverage and local-time-safe fixtures.
Upgrade Note
No configuration migration is required. Update the installed Tracework plugin to 0.4.1 to pick up the cross-platform session-lock fix.
Validation
npm --prefix cli run buildnpm --prefix cli run copy-skillsnpm --prefix cli run check-skillsin a clean isolated worktreenpm --prefix cli run test:session-scannpm --prefix cli run test:doctorclaude plugin validate .claude-plugin/plugin.jsonclaude plugin validate .claude-plugin/marketplace.json- Package-content checks plus isolated Codex and Claude plugin installs for
0.4.1 - CI run
29303249660passed on commit5d8e725 - The installed Claude CLI does not expose
plugin tag; manifest validation and both isolated install smokes were used as the documented replacement gate.
Tracework 0.3.0
Highlights
- Refocuses Tracework on Daily, Weekly, and Monthly as the primary product surfaces, with Query, Recall, and Roadmap retained as lower-frequency trust and recovery tools.
- Adds
work,personal, and privateallreporting scopes so projects are partitioned before headline selection and personal evidence cannot leak into workplace reports. - Rebuilds Daily around daily judgment and state changes, and makes Weekly a management brief by default with slide outlines only when explicitly requested.
- Makes Monthly raw-first, using Daily and Weekly as prior human judgments while preserving later status changes, conflicts, recurring risks, and evidence boundaries from raw entries.
- Simplifies new Capture reporting metadata without migrating historical records, and reduces first-run setup to the vault, project identity, and reporting group.
Upgrade Note
Existing projects without reporting_group are treated as unassigned and excluded from scoped reports for safety. Run /tracework:cold-start-interview once in each existing project or add the field manually.
Validation
npm --prefix cli run check-skillsnpm --prefix cli run testnpm --prefix site run buildclaude plugin validate .claude-plugin/plugin.jsonclaude plugin validate .claude-plugin/marketplace.json- Package-content checks plus isolated Codex and Claude plugin installs for
0.3.0 - The installed Claude CLI does not expose
plugin tag; manifest validation and both isolated install smokes were used as the documented replacement gate.