Skip to content

feat(security-model): add Component Map section to policy drafts - #191

Merged
markatsentry merged 1 commit into
mainfrom
mark/security-model-component-map
Nov 2, 2026
Merged

markatsentry merged 1 commit into
mainfrom
mark/security-model-component-map

Conversation

@markatsentry

Copy link
Copy Markdown
Contributor

security-model drafts now include a Component Map section between the threat model and the invariants. It lists the directories and files a reviewer must treat as security-critical, grouped into one table per input trust level. Each entry gives a one-line purpose and the invariants it bears. Examples of security-critical code: untrusted input parsing, enforcement points, unsafe or native code, authentication, tenant scoping, secrets, and language or network boundaries.

The invariants already named their enforcing symbols, but nothing gave reviewers an overview of where untrusted input enters or where unsafe code and bindings live. A real run on a public Rust library surfaced this when the user asked for the map after the first draft.

The drafting rule keeps the map narrow. It maps directories rather than files unless one file holds the control, and leaves out tests, fixtures, and paths with no security role. It marks a group Unresolved when its trust level is open. Every path is backticked so check catches it moving, and SPEC gains that as an acceptance gate. The old "paths that mark a real boundary" wording in the scope bullet is replaced by the new component map item rather than duplicated.

🤖 Generated with Claude Code

Drafts now map the security-critical directories and files, grouped by
the trust level of their input, with a one-line purpose and the
invariants each one bears. Paths are backticked so check catches them
moving.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@markatsentry
markatsentry marked this pull request as ready for review November 2, 2026 21:39
@markatsentry
markatsentry merged commit 0c464f4 into main Nov 2, 2026
12 checks passed
@markatsentry
markatsentry deleted the mark/security-model-component-map branch November 2, 2026 21:40
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