docs(adr): promote proposals 0001 + 0002 → ADR-0002 + ADR-0003

[hyperpolymath]

Summary

Stacks on #115. Promotes the two [accepted] (2026-05-30) proposals to
architecture decision records under docs/decisions/. Closes the last
open gating item from PR #115's LEVEL-STATUS rewrite (#4 — "ADR
promotion").

Changes

New files:

• docs/decisions/0002-multi-producer-carrier-sections.adoc —
  ADR for typedwasm.regions + typedwasm.capabilities carriers,
  plus reserved slots for access-sites (→ ADR-0003) and region-imports
  (→ proposal 0003 [draft]). Adopted pins: WBool 4B wire, LEB128
  per field (option B), cardinality-1 producer surface in v1, opt-in
  Cargo features.
• docs/decisions/0003-access-site-carrier.adoc — ADR for
  typedwasm.access-sites per-instruction (region_id, field_id)
  carrier (proposal 0001 OQ §5 → option A). Realised by
  verify_access_sites_from_module in PR feat(verify): verify_capabilities + verify_access_sites passes (proposal 0002 §Gate 4) #109.

Updated files:

• docs/decisions/README.adoc — rewritten from 2-line stub to proper
  ADR index (ADR-0001 RSR + new ADR-0002 / 0003 + authoring guidance
  • cross-refs).
• docs/proposals/README.adoc — index entries gain promotion arrows;
  NOTE block updated to reflect the promotion instead of the deferral.
• docs/proposals/0001-multi-producer-carrier-section.adoc,
  docs/proposals/0002-access-site-carrier.adoc — add Promoted to
  metadata row + inline NOTE under the metadata table. Proposal
  content is unchanged; they remain canonical wire-format references.
• LEVEL-STATUS.md — Open-gating item Snapshot local work before sync #4 (ADR promotion) → DONE
  with file-path pointers.

Why now

#115 flipped proposals 0001 + 0002 to [accepted] but deliberately
deferred ADR promotion as a separate auditable PR (file moves +
numbering choices). This PR closes that follow-up:

• Existing ADR 0001 is adopt-rsr-standard (2026-02-14). New ADRs
  pick up at 0002 / 0003 in chronological order without renumbering
  anything else.
• Proposal files are retained rather than removed — the ADRs are
  short decision records; the proposals carry the wire-format detail,
  error variants, and producer-readiness checklists. Cross-references
  point in both directions.

Stacking note

Branched off PR #115's head commit d9869bb so the proposal status
fields and docs/proposals/README.adoc are already at the
[accepted] baseline. Will rebase cleanly when #115 merges; no
content conflict with #115.

Test plan

• AsciiDoc renders without broken anchors
• docs/decisions/README.adoc index entries link to the right files
• Proposal Promoted to rows resolve to the new ADRs
• CI green (no source changes; docs-only)

🤖 Generated with Claude Code

[github-actions]

🔍 Hypatia Security Scan

Findings: 96 issues detected

Severity	Count
🔴 Critical	8
🟠 High	19
🟡 Medium	69

⚠️ Action Required: Critical security issues found!

View findings

[
  {
    "reason": "Action perpolymath/standards/.github/workflows/governance-reusable.yml@main\n needs attention",
    "type": "unpinned_action",
    "file": "governance.yml",
    "action": "pin_sha",
    "rule_module": "workflow_audit",
    "severity": "medium"
  },
  {
    "reason": "Issue in boj-build.yml",
    "type": "unknown",
    "file": "boj-build.yml",
    "action": "flag",
    "rule_module": "workflow_audit",
    "severity": "medium"
  },
  {
    "reason": "Issue in c5-regenerate.yml",
    "type": "unknown",
    "file": "c5-regenerate.yml",
    "action": "flag",
    "rule_module": "workflow_audit",
    "severity": "medium"
  },
  {
    "reason": "Issue in cargo-audit.yml",
    "type": "unknown",
    "file": "cargo-audit.yml",
    "action": "flag",
    "rule_module": "workflow_audit",
    "severity": "medium"
  },
  {
    "reason": "Issue in codeql.yml",
    "type": "unknown",
    "file": "codeql.yml",
    "action": "flag",
    "rule_module": "workflow_audit",
    "severity": "medium"
  },
  {
    "reason": "Issue in dogfood-gate.yml",
    "type": "unknown",
    "file": "dogfood-gate.yml",
    "action": "flag",
    "rule_module": "workflow_audit",
    "severity": "medium"
  },
  {
    "reason": "Issue in dogfood-gate.yml",
    "type": "unknown",
    "file": "dogfood-gate.yml",
    "action": "flag",
    "rule_module": "workflow_audit",
    "severity": "medium"
  },
  {
    "reason": "Issue in dogfood-gate.yml",
    "type": "unknown",
    "file": "dogfood-gate.yml",
    "action": "flag",
    "rule_module": "workflow_audit",
    "severity": "medium"
  },
  {
    "reason": "Issue in dogfood-gate.yml",
    "type": "unknown",
    "file": "dogfood-gate.yml",
    "action": "flag",
    "rule_module": "workflow_audit",
    "severity": "medium"
  },
  {
    "reason": "Issue in dogfood-gate.yml",
    "type": "unknown",
    "file": "dogfood-gate.yml",
    "action": "flag",
    "rule_module": "workflow_audit",
    "severity": "medium"
  }
]

Powered by Hypatia Neurosymbolic CI/CD Intelligence