-
codetruss journalturns receipts into the deliverable. A 2026-08-14
field report from a real contractor engagement said it plainly: the client
wanted a work journal, the receipts sat unread in.codetruss/, and the
contractor rebuilt our value proposition by hand with screenshots and
worklogs. The new command renders every verifiable receipt into one
self-contained HTML document — sessions in order, what changed, what
verified, verdicts, findings — that a client opens in a browser with nothing
installed. The rendering is a view; the evidence is the exact signed
receipts embedded in the file, downloadable from its appendix and checkable
withcodetruss verify-receipt, and the journal's session-and-digest
manifest is signed by the producing key; the page's presentation is not.
Receipts that fail verification are excluded and named in the document,
never silently dropped. The rendering reduces the absolute repository path
to its basename and omits verification output (--include-outputshows
it); the embedded receipts remain the exact unredacted records — the
document's appendix states precisely what that means before anything is
handed over. -
Scope detection now sees the repository instead of probing a name list.
The same engagement's monorepo kept its work in a product-named nested app;
detection suggestedserver/**anddocs/**(both on the fixed
fourteen-name list) and never looked at anything else, so the adopted scope
flagged every legitimate edit. Suggestion now also reads the roots your own
workspace manifests declare (package.jsonworkspaces,
pnpm-workspace.yamlpackages:) and scans the repository root for
directories carrying their own project manifest or asrc/child.
Hidden, symlinked, and build-output directories never qualify, and a
scanned directory must carry its own manifest or asrc/child — filters
chosen to keep an unattended--yesscope from adopting junk, though the
scan is a heuristic, not a guarantee. -
Setup now reads the checks a repository documents for itself. The same
repo's handover doc spelled out the exact gate (tsc --noEmit) and setup
still printed "no verification commands were detected". Detection now mines
README.md, docs/*.md, and workflowrun:steps for single plain commands
that begin with a known runner, and prints them with their source file as
suggestions only. Nothing mined is ever recorded or executed: shell
composition of any kind is rejected even for display, and adopting a
suggestion remains the deliberate two-step (write it intoverify:, then
codetruss verify-policy trust). Atypecheckscript is also a
first-class detection candidate now, besidelintandtest.
Install
curl -fsSL https://codetruss.com/install.sh | shWindows (PowerShell):
irm https://codetruss.com/install.ps1 | iexVerify what you installed
sha256 3f3b6372291d746a012d90833f2ec434d581b546838616fa0b2f8e16386bb81a
gh attestation verify codetruss-cli-0.2.64.tgz --repo CodeTruss/codetruss-cliThe archive ships with a CycloneDX SBOM and SLSA build provenance. You
should not have to take our word for what is in it.