Skip to content

docs(audit): OSTIF best-practices audit report + evidence - #76

Merged
tonibergholm merged 1 commit into
mainfrom
audit/ostif-best-practices-report
Jul 18, 2026
Merged

tonibergholm merged 1 commit into
mainfrom
audit/ostif-best-practices-report

Conversation

@tonibergholm

Copy link
Copy Markdown
Member

Summary

Adds the OSTIF Security Best Practices audit (docs/audit/):

  • ostif-best-practices-audit.md — 35 gaps (16 Missing / 12 Partial / 2 Divergent / 5 Implicit) with confidence ratings, technical details, swarm-validation findings, and the prioritized T-1…T-26 todo plan (Now / Soon / Deferred tiers).
  • gap-analysis-source.md — the full evidence trail (file:line citations, live GitHub API + code-scanning reconciliation, three evidence rounds).

Method: gap analysis against https://github.com/ostif-org/best-practices-guide with a 6-agent validation swarm (adversarial validator, evidence investigator, actor sweep, security + devops augmenters, PM synthesis); no first-pass finding was withdrawn.

Follow-up PRs will start on the Now-tier todos (SHA-pinning, CodeQL JS coverage, desktop CI job, dependabot npm, SECURITY.md reconciliation).

… todos

Full audit of the repo against the OSTIF/Least Authority Security Best
Practices Guide (github.com/ostif-org/best-practices-guide), run as a
gap analysis with a 6-agent validation swarm and three evidence rounds
(repo + live GitHub API + live code-scanning surface).

- docs/audit/ostif-best-practices-audit.md: the report — 35 gaps
  (16 Missing / 12 Partial / 2 Divergent / 5 Implicit), confidence
  ratings, technical details, and the T-1..T-26 prioritized todo plan.
- docs/audit/gap-analysis-source.md: the evidence trail with file:line
  citations and the per-round deltas.
@tonibergholm
tonibergholm merged commit d0afadf into main Jul 18, 2026
4 checks passed
@tonibergholm
tonibergholm deleted the audit/ostif-best-practices-report branch July 18, 2026 08:47
tonibergholm added a commit that referenced this pull request Jul 18, 2026
…bounty status, non-disclosure ask (#79)

Executes T-8 (G-014/G-015/G-017/G-018/G-019) from the OSTIF audit (#76):

- Reconcile stale pre-P32/P33 claims: protected paths are randomized-
  sealed since P33 (pre-P33 convergent content stays confirmable);
  sc+https:// and ssh:// are the confidential transports, with the
  plaintext --http warning scoped accordingly (TOFU caveat stated).
- Note that GitHub private vulnerability reporting is enabled (the
  toggle was flipped as part of this audit round — the documented
  channel now actually works).
- Add a good-faith-research safe-harbor statement (G-015).
- State bug-bounty status explicitly: none at this time (G-017).
- Ask reporters for confidentiality during the coordination window,
  mirroring the project's own 90-day commitment (G-018).
tonibergholm added a commit that referenced this pull request Jul 18, 2026
…en alerts (#88)

Now + Soon tiers shipped (PRs #76-#87 + settings + org 2FA). Adds a
Section 0 remediation banner to the report and a fourth-round delta to
the evidence file:

- code-scanning down 17 -> 3 open alerts: 12 auto-closed on re-scan
  (SHA-pins, token scoping, fuzzer integration, SAST/CI coverage), 2
  dismissed with rationale in round 3.
- CodeQL now clean across rust + actions + javascript-typescript
  (supersedes the round-3 note that JS-TS was absent).
- the 3 survivors all trace to required-approvals=0 (G-032/T-16,
  deferred until a second reviewer) plus the optional OpenSSF badge;
  BranchProtection already improved 3->4 via T-9's required checks.
- Deferred tier T-22-T-25 remains, each gated on a first distribution
  channel that does not exist yet.

Original Sections 1-5 kept verbatim as the audit-trail 'as first
audited' record; Section 0 is authoritative for current state.
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