Repository navigation
Releases
v0.11.10
0.11.10 — 2026-11-06
- An MCP client configuration named
.grok/config.tomlis never a contract, as in@coderifts/contract-path(contract-write.cjs:69, app commit2c7f503e, P65).src/contract-path.js:25MCP_CLIENT_CONFIGgains the|\.grok\/config\.tomlalternative; before, the pattern lacked it andtest/contract-path-mirror.test.js:48(MIRROR) was red against the package. - Vendored core: receipt-verifier v1.0.3 → v1.2.1 (signed tag, peeled
e1a346b).src/verify.jsandsrc/verify-grant.jsare byte copies of the tag; the other ten pinned.jsfiles were already byte-identical to it,receipt-from-commit.jsincluded (src/VENDOR.sha256). The verdict changes this brings, by the receipt-verifier release that made them: 1.1.1 a v1–v3 receipt is not authorization (P66) and a non-string signed field isMALFORMED; 1.1.4 a receipt verified beside an envelope must be v4; 1.1.5 Ed25519 only, and the result names the key that verified; 1.1.6--as-ofaudit evaluation, and expiry applies under a retired key; 1.1.7 strict JSON parse (duplicate keys, lone surrogates, non-finite numbers areMALFORMED), and inverify-grant.jsa grant whose key hasrevoked_atrefuses at every instant and grant bodies are parsed strictly; 1.1.8 an--as-ofinstant before the receipt'stsisNOT_YET_VALID_AT_AS_OF; 1.2.0 the RECEIPT_FORMAT §7.1 key-status order — a revoked key isREVOKED_KEYat every signing time (withcompromised_atin the result) and wins overretired_at,REVOKED_KEY_UNDECIDABLEis withdrawn, and a retired key signed beforeretired_atwith no time anchor isRETIRED_KEY_UNANCHORED: valid:true → valid:false (wasRETIRED_KEY_VALID_AT_ISSUE). The xlang corpus is regenerated with the receipt-verifier generator.
v0.11.9
0.11.9 — 2026-10-12
- Sends control-plane artifacts; v4-only receipts; a control-plane-only diff can now go green with two bound approvals and red without them. For every changed control-plane path the authorize request carries
{ id, type: "control_plane", before, after }beside any contract artifacts. Paths come fromgit diff -z --no-renames --name-only <base> <head>, so a rename is a delete of the old path plus an add of the new one. Keys and signing material under.coderifts/keys/,.coderifts/trust/,.coderifts/signing/, and.pem/.pubunder.coderifts/are sent as the path only (beforeandafterare""); the file text is not read. The list issrc/control-plane.js, the same list as coderifts-appsrc/mergegate/control-plane.jslines 58-100 (read 2026-10-12): top-level.github/workflows/*.yml|yaml,.coderifts.yml/.yaml, those key paths,.coderifts/audit.yml|yaml,coderifts-audit.yml|yaml,keyring/pinned-keys.json, a rootaction.yml|yaml, and.github/actions/**. A request missingpreflight_mode: authorize,repository,base,head, oroperation: mergeis not sent (invalid_context, and the summary names the slot). The issued receipt is still judged byjudgeReceipt(four-slot binding, v4-only).REQUIRE_APPROVALorBLOCKisreceipt_not_allow, and the title carriesCONTROL_PLANE_CHANGE.
v0.11.6
- The enforcing reader binds the receipt to this run. After the digest check,
judgeReceiptcomparespreflight_mode,repository,base, andheadwithmismatchReason(src/gate.js). A mismatch ismode_mismatch,repo_mismatch,base_mismatch, orhead_mismatch, and it is a failure, not the missing-trailer fall-through. A trailer or sidecar skips a slot only when that slot is unbound. An issued receipt always compares all four, so a missing slot fails closed. Onmerge_group,base_mismatchorhead_mismatchwithrequire-receipt-trailerleft false falls through to issuance for the queue SHAs.repo_mismatchandmode_mismatchstay failures. With the flag true, a mismatch stays a failure. require-receipt-trailer: truefails closed before preflight. No verifying trailer or sidecar postsfailurewith reasonreceipt_trailer_required, on every profile, and the preflight fetch is not called. The default staysfalse: on the enforcing profile a missing trailer still falls through to issuance, and a missing key still failsreceipt_trailer_missing.- The action job shows the receipt. It appends the five receipt lines, the conclusion, the receipt id (
envelope.receipt_idwhen set, otherwiseenvelope.decision_id),target_id,expires_at, and the reason toGITHUB_STEP_SUMMARY, and sets outputsreceipt-id,conclusion,reason, andtitle. The example aggregator prints those outputs. A job check-run'soutputcannot be set by this step.post-check-run: falsestill writes the summary and the outputs; it only skips the check-run POST. - The suggested workflow's permissions are
contents: readandpull-requests: read.checks: writestays commented, for the variant that posts its own check. The action reads the diff with localgit(src/artifacts.js) and, only when it posts,POST /repos/{owner}/{repo}/check-runs(src/check-run.js). It does not call the pulls API. The SHAs come fromGITHUB_EVENT_PATH. - README "Where it stops". A fork pull request receives no
CODERIFTS_API_KEY, so nothing is issued and the run fails closed unless the head carries a verifying trailer. The Actions-posted required context uses the workflowGITHUB_TOKEN(src/gate.js), so anyone who can edit.github/workflows/can turn it green. That is whyCodeRifts / issueris the second required check. Put CODEOWNERS on.github/workflows/**and, where the org has one, an org-level required workflow.pull_request_targetis not used and not recommended.
v0.11.5
P65d: a plain mcp.json that is both an MCP client configuration (mcpServers or servers) and a tool manifest (tools), or that does not parse as JSON, is not read from git and not sent; the run fails with outcome MCP_JSON_HELD and one sentence naming the file. A plain mcp.json with mcpServers or servers and no tools stays a client configuration (counted as no file); a file with tools only stays a contract. The mirror follows @coderifts/contract-path 1.3.1.
v0.11.4 — a plain mcp.json is decided by its content
P65c: by name the Action refuses only .mcp.json, .cursor/mcp.json, .vscode/mcp.json, claude_desktop_config.json and (cline_)mcp_settings.json (never read). Any other mcp.json is read with git show and decided as @coderifts/contract-path 1.3.0 decides it: mcpServers/servers and no tools → an MCP client configuration, counted as no file and never sent; tools, any other shape, or unparseable → a contract (fail-closed). A server's tool manifest named mcp.json is a contract again. Pin: 9359e7f
v0.11.3 — an MCP client configuration is never read or sent
P65: mcp.json, .cursor/mcp.json, .vscode/mcp.json, mcp_settings.json, cline_mcp_settings.json, .mcp.json and claude_desktop_config.json are not contract artifacts; the Action does not read them from git or send them to preflight. Pin: 97d4cea
v0.11.2 — the reader, described
No behaviour change. The action.yml description now says what the reader profile does: with a trailer, verifies the receipt offline against the pinned keyring; without one, issues a receipt with the repository key, verifies it the same way and puts it in the check summary — never in the commit. Two required contexts: CodeRifts / contract-gate (this Action) and CodeRifts / issuer (the App).
v0.11.0 — the reader is the required check
With a valid CodeRifts-Receipt trailer + sidecar the Action verifies the receipt offline against the pinned keyring and never calls the issuer. Without a trailer and with a key it issues a receipt, verifies it the same way and puts it in the check summary — never in the commit. Two required contexts: CodeRifts / contract-gate (this Action) and CodeRifts / issuer (the App). The customer workflow listens to merge_group. Five negative cases fail closed; skipped or timed-out runs do not pass.
v0.10.0 — require-receipt-trailer
require-receipt-trailer: off by default; when on, the head commit's receipt must verify offline, match the diff digest and be a continue
v0.9.4 — check output cites the grant_id and receipt-digest
The check output cites the grant_id and receipt-digest with a travelling scope claim. The grant_id (from the verified payload) and the receipt-digest appear in the human summary and a coderifts-citation block; does_not_prove travels with the token (the digest does not mean the merge happened, CI passed, or any third party witnessed it).