feat(silo): incubate the secret-silo design (ALARP handle/vault) - #50
Merged
Merged
Conversation
Adds `silo/` — the practical counterpart to epistemic-types/docs/secret-types.adoc. An ALARP consequence-reducer for the non-expert, low-effort user who leaks secrets in plaintext and never rotates. Design: every secret becomes a uniform `SILO-<uuid>-<hmac>` handle that contains *no* secret material (tokenisation) — a leaked handle is inert. The uniformity denies an attacker the value-triage that distinctive prefixes (AKIA/ghp_/sk_live_) hand them; a single Gitleaks rule on the envelope shape keeps leak *detection* while withholding value *disclosure*. RMO becomes crypto-shred-by-handle (destroy the 32-byte vault key), which is sound on SSDs where 3-pass overwrite is not — closing valence-shell's open `obliterate_overwrites_all_blocks` by changing the mechanism. - MOTIVATION.adoc — ALARP framing; problems→basis table; explicit non-goals. - docs/DESIGN.adoc — handle format, vault per platform, HMAC envelope, Echo-graded partial release, threat model, idea→alpha build order. Includes the load-bearing correctness note: a *public* permute+checksum is obfuscation; indistinguishability requires a key (FPE) or, better, no secret in the envelope at all (handle). 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
|
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.



Adds
silo/— the practical counterpart toepistemic-types/docs/secret-types.adoc. An ALARP consequence-reducer for the non-expert, low-effort user who leaks secrets in plaintext and never rotates.
Design: every secret becomes a uniform
SILO-<uuid>-<hmac>handle that contains no secret material (tokenisation) — a leaked handle is inert. The uniformity denies an attacker the value-triage that distinctive prefixes (AKIA/ghp_/sk_live_) hand them; a single Gitleaks rule on the envelope shape keeps leak detection while withholding value disclosure. RMO becomes crypto-shred-by-handle (destroy the 32-byte vault key), which is sound on SSDs where 3-pass overwrite is not — closing valence-shell's openobliterate_overwrites_all_blocksby changing the mechanism.Includes the load-bearing correctness note: a public permute+checksum is obfuscation; indistinguishability requires a key (FPE) or, better, no secret in the envelope at all (handle).
🤖 Generated with Claude Code
Summary
Changes
RSR Quality Checklist
Required
just testor equivalent)just fmtor equivalent)unsafeblocks without// SAFETY:commentsbelieve_me,unsafeCoerce,Obj.magic,Admitted,sorry).envfiles includedAs Applicable
.machine_readable/STATE.a2mlupdated (if project state changed).machine_readable/ECOSYSTEM.a2mlupdated (if integrations changed).machine_readable/META.a2mlupdated (if architectural decisions changed)TOPOLOGY.mdupdated (if architecture changed)CHANGELOGor release notes updatedsrc/interface/abi/andsrc/interface/ffi/consistent)Testing
Screenshots