Skip to content

docs(decisions): record D-090 declared-reference admission at the D-028 seam - #107

Merged
verlyn13 merged 1 commit into
mainfrom
docs/d-090-declared-reference-admission
Sep 22, 2026
Merged

verlyn13 merged 1 commit into
mainfrom
docs/d-090-declared-reference-admission

Conversation

@verlyn13

Copy link
Copy Markdown
Member

Purpose

Record D-090's default-deny declared-reference admission contract at the host_secret_* seam. Calling the seam establishes the seam boundary but approves no particular reference. Per-consumer admission is a Ring 1 obligation; ADR 0062 defers a typed Capability link. This Class A documentation change authorizes no broker implementation.

Ring changed

  • Docs

Boundary checks

  • No policy duplicated into adapter or hook
  • No universal shell execution added
  • No audit-write agent endpoint added
  • OperationShape remains upstream of CommandShape
  • Evidence provenance and freshness considered; no evidence entity changes
  • Dashboard impact considered; no dashboard behavior changes
  • Citation discipline: ADR 0062's deferred typed linkage is stated as deferred, not as existing authorization
  • ADR precedence respected
  • Charter text untouched

Validation

just verify passed: node-tools, static-gates, and fixtures.

Charter compliance

Complies with implementation charter v1.6.0. Ring 3 documentation only; no cross-ring imports added.

Agent use

  • Implementer: Doc keeper (Codex)
  • Reviewer: hcs-security-reviewer (clear after amendments)
  • Subagents: one critic

…28 seam

A reference argument to the host_secret_* caller contract is a request to resolve a reference under an authorized operation, not authority in itself. Ring 1 admission must deny references not declared for the requesting consumer by default. Calling the seam establishes only the seam boundary; it approves no particular reference. The seam is not a general arbitrary-secret-read service.

ADR 0062 declares the kernel operation; ADR 0063 names secret_reference_ref in the CommandShape env value-source; ADR 0065 fixes the reference form. No new entity, field, endpoint, or signature change; no accepted decision reversed; per-consumer admission recorded as a Ring 1 obligation because the Capability linkage is deferred by ADR 0062; broker implementation remains blocked per ADR 0012/0040/0043. Change class A.
@verlyn13
verlyn13 requested a review from a team as a code owner September 22, 2026 00:55
@verlyn13
verlyn13 merged commit 34525b1 into main Sep 22, 2026
1 check passed
@verlyn13
verlyn13 deleted the docs/d-090-declared-reference-admission branch September 22, 2026 00:57
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant