Skip to content

docs(security): Soon-tier process + inventory docs (OSTIF T-11, T-14–T-21) - #83

Merged
tonibergholm merged 1 commit into
mainfrom
docs/ostif-soon-tier
Jul 18, 2026
Merged

tonibergholm merged 1 commit into
mainfrom
docs/ostif-soon-tier

Conversation

@tonibergholm

Copy link
Copy Markdown
Member

Executes the documentation half of the Soon tier from the OSTIF audit (#76). Closes G-010, G-011, G-012, G-013, G-016, G-020, G-021, G-022, G-025, G-030, G-031, G-032 (doc halves):

Todo File
T-16 docs/security/vulnerability-response.md — internal handling + private-report/agent-pipeline boundary + distinct-human-review rule for security fixes
T-17 docs/security/incident-response.md — 5 incident classes incl. compromised/prompt-injected agent
T-14 docs/agents/ACCESS.md — escrow custody first, humans, non-human principals
T-18 docs/security/data-handling.md — no-true-delete retention model, PII/erasure tension
T-19 docs/security/subscriptions.md — automated vs human feeds
T-20 docs/security/opsec-baseline.md — CI/account policy; org 2FA recorded as pending maintainer action (org-wide auth change deliberately left to a human)
T-21 docs/security/security.txt — RFC 9116 template for the website
T-11 docs/security/third-party-inventory.md — both ecosystems, patched glib flagged
T-15 CONTRIBUTING.md security-review triggers checklist

Plus a pointer section in SECURITY.md. Remaining Soon-tier work lands separately: SBOM CI job + audit.yml permission scoping (T-10/T-20), proptest roundtrip (T-12), cargo-fuzz nightly (T-13).

…T-21)

Executes the documentation half of the Soon tier from
docs/audit/ostif-best-practices-audit.md:

- T-16 (G-010/031/032): docs/security/vulnerability-response.md — internal
  handling steps, draft-advisory tracking, the boundary keeping private
  reports out of the public agent-triage pipeline, and a distinct-human-
  review rule for security fixes.
- T-17 (G-011/030): docs/security/incident-response.md — five incident
  classes incl. the compromised/prompt-injected-agent class with its own
  contain/audit/revert playbook.
- T-14 (G-012): docs/agents/ACCESS.md — access inventory with escrow-key
  custody first, then humans, then non-human principals (per-workflow
  GITHUB_TOKEN scopes, agent gh authority, dependabot).
- T-18 (G-021): docs/security/data-handling.md — what is stored, what
  leaves the machine, and the no-true-delete / rotation-≠-erasure
  retention model stated plainly, incl. the PII/erasure tension.
- T-19 (G-013/024): docs/security/subscriptions.md — automated feeds vs
  human subscriptions, with a confirm checkbox for the unverifiable half.
- T-20 (G-025): docs/security/opsec-baseline.md — CI/account rules as
  standing policy; org-2FA enforcement recorded as PENDING maintainer
  action (deliberately not automated).
- T-21 (G-016): docs/security/security.txt — RFC 9116 template for
  git-agentic.com/.well-known/ with yearly Expires.
- T-11 (G-020/033): docs/security/third-party-inventory.md — both
  ecosystems, vendored/patched glib flagged first with its removal gate.
- T-15 (G-022): CONTRIBUTING.md 'Security-review triggers' checklist
  (crypto/tlsio/transport changes, new deps, CI/permission changes,
  security fixes, first-release trigger).
- SECURITY.md gains a pointer section to docs/security/.
@tonibergholm
tonibergholm merged commit 45d4ee6 into main Jul 18, 2026
7 checks passed
@tonibergholm
tonibergholm deleted the docs/ostif-soon-tier branch July 18, 2026 09:22
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