Skip to content

fix(minimal): classify the mint test connects, document the interim key

Minimal Arch / arch-review failed Oct 25, 2026 in 0s

CONDITIONS

Baseline. This is a re-review of 0682030d against the CONDITIONS ruling on 34ead5e8 (this PR), on arch checkout 109541a4. The checkout has no arch-map.md, so I started from Gatehouse §6.10 (specs/authn-authz/gatehouse-spec.md) lines 839 and 842, as the earlier rulings did. No findings.json was staged. since.diff equals git diff 34ead5e8 0682030d. It changes only docs, expect reasons, and the daemon-connection inventory in crates/minimal/src/tests.rs. The ledger gives the earlier rulings only as truncated text, and no gh was available, so I read their intent from the fix commits.

Governs. Line 842: un-enrolled, the client signs store handles "with its local key, registered with the helper over the UDS at first use", and a handle travels as {kind: "store", jws}. Line 839: an un-enrolled store handle's exp is the anchor's remaining validity at mint.

Ruling. The proxy half conforms, and the earlier ruling stands for it. The key is written and synced before the reply, a failed write refuses (fail closed), the file is checked on its O_NOFOLLOW handle, and the log records the restore count and each kid. mint_store_handle registers before it returns, and it sets exp from root_not_after (line 839). The two new inventory entries match the existing one-entry-per-connect pattern (grant_box_registers_its_declared_egress_with_the_proxy). The client still deviates from line 842: mint_grants (cmd/boxes/create.rs:526) makes a new key for each box. Each key now stays in the proxy's key file permanently, so the file grows by one line per creation. The head names this honestly as an interim with a flip condition. But the base interim said "The flip is T27 (#2288)". This PR is T27, it says Closes #2288, and it does not do the flip. It moves the flip to "a residual of #2288", so the merge closes the only issue that owns the interim and the four residuals the PR notes list (rules 2 and 6). C1 and C2 move them to open issues. No code change is required.

Not ruled. The interim is not surfaced at session start. I do not require that, because AGENTS.md forbids a new line before the shell on a healthy start, and the interim is not visible to the user. I did not compile (out of bounds), so I did not check that the duplicate inventory entry makes every_daemon_connection_is_classified pass. The fixed refusal text says "the proxy" where every other MintError says "the Box Egress Proxy". This is a message-rule question for minimal-review, not a design deviation.

Conditions

  • C1: File a new issue in gominimal/minimal for the flip: mint_grants in crates/minimal/src/cmd/boxes/create.rs reads local_client_key with a host-keychain ClientKeyStore, not ClientKey::generate(). Then replace each interim reference to #2288 with that new issue's full URL: crates/bep/src/control.rs module doc lines 49-53. crates/minimal/src/mint.rs module doc lines 25-31, the ClientKey doc lines 206-208, the ProxyRegistration doc lines 859-862, and every expect(dead_code, reason = ...) that says (#2288). This PR closes #2288, so an interim that is linked to #2288 has no open owner after the merge.
  • C2: In the PR body, add a Residuals list, and give each item an issue URL: (a) the mint_grants flip from C1. (b) a store member kind in bep::seal::MemberKind, so that a store handle travels sealed as {kind: "store", jws}. (c) the host-keychain ClientKeyStore backend. (d) the min box spec store-reference diagnostic that the task names. Items (a) and (c) can share one issue. Each issue must be open and must not be #2288.

Ruled at 0682030 against gominimal/arch@109541a48c31 by claude-opus-5-5; arch_rulings 254, job f83f0ac2-45ad-4c5f-9e9a-49db35864ffd.