Wire the security threat model for agent discoverability (AGENTS.md + SECURITY.md); rename draft-THREAT-MODEL.md -> THREAT_MODEL.md#363
Open
potiuk wants to merge 1 commit into
Conversation
Adds AGENTS.md (## Security pointer) + SECURITY.md wiring the conventional AGENTS.md -> SECURITY.md -> THREAT_MODEL.md chain, and renames the PMC-merged draft-THREAT-MODEL.md to the canonical THREAT_MODEL.md (no longer a draft; matches the discoverable convention). No model content changes. Generated-by: Claude Code (Claude Opus 4.8)
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.
This is a proposal for the Jackrabbit PMC to review — please correct, reject, or discuss as needed. Nothing here is a requirement; the maintainer is the decision-maker.
Thanks for merging the threat-model draft, Angela. Two small follow-ups make it mechanically discoverable to automated security scanners (and to any agent that follows the conventional file layout):
1. Wire the discoverability chain. This adds
AGENTS.md(a## Securitypointer) andSECURITY.md, so the conventionalAGENTS.md → SECURITY.md → THREAT_MODEL.mdchain resolves. An automated scanner mechanically follows that chain to locate the model; without it, the model file is present but the scanner can't find it — discoverability is the one hard gate before a scan can run. (On jackrabbit-oak this appends a## Securitypointer to the existingAGENTS.mdrather than creating a new one.)2. Rename
draft-THREAT-MODEL.md→THREAT_MODEL.md(optional proposal). Two reasons:draft-prefix now reads as "not yet adopted" when it is, in fact, the project's adopted model — the name undersells it.THREAT_MODEL.mdis the conventional, discoverable name. It's what theAGENTS.md → SECURITY.md → modelchain and the scanners look for by default, and it matches the layout used across the other Apache repos in this effort (e.g.apache/solr). The rename also normalizes the separator (THREAT-MODEL→THREAT_MODEL).If you'd rather keep the
draft-name (or pick a different one), just say so — the rename is the optional part; the wiring is the substantive fix, and we'll pointSECURITY.mdat whatever filename you prefer.Context: the ASF Security team is preparing the project for an automated agentic security scan. This PR changes no model content — only the file name and the discoverability wiring around it.