Skip to content

docs: add SECURITY.md with disclosure policy#151

Open
mrbrandao wants to merge 2 commits into
LobsterTrap:mainfrom
mrbrandao:docs/security
Open

docs: add SECURITY.md with disclosure policy#151
mrbrandao wants to merge 2 commits into
LobsterTrap:mainfrom
mrbrandao:docs/security

Conversation

@mrbrandao
Copy link
Copy Markdown
Collaborator

@mrbrandao mrbrandao commented May 21, 2026

Summary

  • Add SECURITY.md with supported versions, vulnerability reporting process (GitHub private advisories), coordinated disclosure policy, security best practices, and scope definition
  • Link SECURITY.md from README.md (before Contributing section to avoid conflicts with governance PR) and docs/dev-guide/contributing.md

Related Issues

Part of AAIF readiness work. Required for OpenSSF Best Practices Badge application.

Test Plan

  • SECURITY.md is present at repo root
  • README.md links to SECURITY.md
  • docs/dev-guide/contributing.md links to SECURITY.md
  • GitHub private vulnerability reporting URL is valid

Checklist

  • Tests pass (pytest)
  • Linting passes (ruff check src tests)
  • Type checking passes (ty check)

AI Disclosure

AI-assisted with Claude Code

Summary by CodeRabbit

  • Documentation
    • Added a comprehensive security policy covering supported versions, private vulnerability reporting channels, required report contents, coordinated disclosure timeline, and user-facing security best practices.
    • Updated project README and contributing guide to point to the new security policy and reporting guidelines for handling vulnerabilities.

Review Change Stack

@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented May 21, 2026

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: f0b6ce71-414a-48ba-9c58-ffa316d35443

📥 Commits

Reviewing files that changed from the base of the PR and between 6a55a67 and 0c52035.

📒 Files selected for processing (1)
  • SECURITY.md
✅ Files skipped from review due to trivial changes (1)
  • SECURITY.md

📝 Walkthrough

Walkthrough

This PR adds a repository security policy by introducing SECURITY.md and updates README.md and docs/dev-guide/contributing.md with pointers to it for vulnerability reporting.

Changes

Security Policy Implementation

Layer / File(s) Summary
Security policy and repository references
SECURITY.md, README.md, docs/dev-guide/contributing.md
Adds SECURITY.md containing supported versions, private vulnerability reporting instructions (GitHub security advisories/private discussions), required report contents, disclosure timeline (ack within 5 business days; fix target within 30 days), user security best practices, and scope/in-scope/out-of-scope lists. README.md and contributing guide now point to SECURITY.md.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Suggested labels

documentation

Suggested reviewers

  • SecKatie
  • sergio-correia
  • rjeffman

Poem

🐰 I found a note, a secret door,
A place to tell of flaws no more.
Quiet channels, careful light,
We patch by day and sleep by night.
Hop, report, and all stays right.

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title directly and accurately summarizes the main change: adding a SECURITY.md file with a vulnerability disclosure policy to the repository.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@mrbrandao mrbrandao added the documentation Improvements or additions to documentation label May 21, 2026
Copy link
Copy Markdown

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🧹 Nitpick comments (1)
docs/dev-guide/contributing.md (1)

5-5: ⚡ Quick win

Use a repo-relative SECURITY.md link instead of blob/main.

Line 5 hardcodes main, which can drift for forks/releases and branch previews. Prefer a relative link so docs stay context-correct.

Suggested doc fix
-For security vulnerabilities, see [SECURITY.md](https://github.com/LobsterTrap/lola/blob/main/SECURITY.md).
+For security vulnerabilities, see [SECURITY.md](../../SECURITY.md).
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@docs/dev-guide/contributing.md` at line 5, Replace the hardcoded GitHub
blob/main URL in the contributing doc's security link—specifically the line that
reads "For security vulnerabilities, see
[SECURITY.md](https://github.com/.../blob/main/SECURITY.md)"—with a
repo-relative link like "[SECURITY.md](../SECURITY.md)" or simply
"[SECURITY.md](SECURITY.md)" so the link resolves correctly in forks, branch
previews, and releases.
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@SECURITY.md`:
- Around line 20-23: Remove the public "GitHub Discussions" contact suggestion
in SECURITY.md (the line linking to
https://github.com/LobsterTrap/lola/discussions and the phrase "GitHub
Discussions") and replace it with a private reporting option: either reference
the previously described private channel in this file (e.g., the email or secure
intake described above) or point reporters to GitHub's private Security
Advisories/SECURITY_EMAIL; update the sentence to instruct reporters to use a
private channel instead of Discussions and ensure the link and text no longer
suggest public discussion for vulnerability reports.

---

Nitpick comments:
In `@docs/dev-guide/contributing.md`:
- Line 5: Replace the hardcoded GitHub blob/main URL in the contributing doc's
security link—specifically the line that reads "For security vulnerabilities,
see [SECURITY.md](https://github.com/.../blob/main/SECURITY.md)"—with a
repo-relative link like "[SECURITY.md](../SECURITY.md)" or simply
"[SECURITY.md](SECURITY.md)" so the link resolves correctly in forks, branch
previews, and releases.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: c8cfaeab-1430-469b-80c0-1a69e91d233f

📥 Commits

Reviewing files that changed from the base of the PR and between de87f1c and 6a55a67.

📒 Files selected for processing (3)
  • README.md
  • SECURITY.md
  • docs/dev-guide/contributing.md

Comment thread SECURITY.md Outdated
@mrbrandao mrbrandao added the enhancement New feature or request label May 21, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant