Skip to content

docs(security): prefer private vulnerability reports - #537

Merged
ss-o merged 1 commit into
mainfrom
feature-315
Aug 24, 2026
Merged

docs(security): prefer private vulnerability reports#537
ss-o merged 1 commit into
mainfrom
feature-315

Conversation

@ss-o

@ss-o ss-o commented Aug 24, 2026

Copy link
Copy Markdown
Member

Problem

z-shell/zi#315 reports a missing repository security policy. Zi already inherits the organization policy from this repository, so adding a second Zi-local copy would create policy drift. The inherited policy still routes reporters to generic organization contacts instead of the enabled private vulnerability-reporting flow.

Approach

  • make the affected repository's private Report a vulnerability flow the primary intake path
  • keep organization-profile private contacts as the fallback
  • explicitly prohibit vulnerability details in public issues, pull requests, or discussions
  • retain coordinated-disclosure and reporter-credit expectations
  • link maintainers to the canonical incident-response runbook

Verification

  • python3 scripts/validate-agent-policy.py
  • python3 -m unittest scripts/test_validate_agent_policy.py -v — 75 passed
  • npx --yes markdownlint-cli2 .github/SECURITY.md — 0 issues
  • lychee .github/SECURITY.md — 2 links checked, 0 errors
  • actionlint .github/workflows/*.yml
  • git diff --check
  • confirmed z-shell/zi/security/policy currently inherits this organization file
  • confirmed private vulnerability reporting is enabled for z-shell/zi

Scope and risk

This updates the single organization-level reporter policy; it does not add per-repository copies, change repository settings, or alter the internal incident-response process.

Closes z-shell/zi#315

@ss-o
ss-o requested a review from a team as a code owner August 24, 2026 22:51
@ss-o
ss-o merged commit c220daa into main Aug 24, 2026
6 checks passed
@ss-o
ss-o deleted the feature-315 branch August 24, 2026 22:54
@ss-o ss-o mentioned this pull request Aug 24, 2026
3 tasks
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.

[docs]: SECURITY.md Missing

1 participant