[yshyn-iohk]

Summary

• add NeoPRISM ADR 0001 for adopting the SDK-Rust identus-prism-did method kernel behind existing NeoPRISM facades
• define exact-wire scanning, legacy/shadow/SDK execution boundaries, composite SSI/VDR state ownership, and target-network parity gates
• make shadow execution bounded and fail-open so differential evidence cannot interrupt the legacy writer
• define isolated PostgreSQL and SQLite candidate rehearsal, signed promotion/upgrade receipts, rollback, and profile-limit recovery

Stack

• stacked on refactor: adopt sdk-rust crypto and DID components #324 (codex/sdk-rust-beta)
• plans the implementation for refactor(did-prism): adopt the SDK-Rust method kernel behind NeoPRISM facades #345
• parity and QoS promotion evidence remains owned by test(indexer): compare published and sdk-rust snapshots on Preprod #325
• SDK method-kernel dependency remains SDK-Rust #521

This PR is documentation and architecture only. It does not enable SDK method execution, mutate persistence, or close #345.

Validation

• git diff --check
• nix develop --command just lint-text
• nix build .#docs-site --no-link
• Claude CLI final architecture review: CLEAN
• Codex CLI fallback path exercised successfully during local review; actionable findings were incorporated

Safety

• default remains did-method-engine=legacy
• shadow is non-writing, bounded, supervised, and fail-open
• sdk cannot serve before an externally signed, exact-candidate promotion receipt
• no branch protection, workflow, or production setting changes

Refs #345
Depends on #324

[yshyn-iohk]

Factory delivery metrics

• Exact head: 0af7af67246373b5e4a62c69a9354a833fa746e7
• Stack base: codex/sdk-rust-beta@e8c504c1d2f7ac39c33eb32c50ff6c99204bb91a (refactor: adopt sdk-rust crypto and DID components #324)
• Change size: 46 files changed, 1630 insertions(+), 1102 deletions(-)
• Commits: 1, signed and DCO-signed-off
• Local gates: git diff --check ✓; Nix just lint-text ✓; Nix docs-site build ✓
• Independent review: Claude CLI final gate CLEAN; Codex CLI fallback path exercised and all actionable blocker/high/medium findings resolved
• Scope: ADR/docs only; no runtime, persistence, workflow, or protection mutation

The generated local review transcripts were preserved outside the repository at /tmp/neoprism-345-review-20261027 and were not committed.

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud