Skip to content

fix: repo review improvements — governance docs, gitleaks, tooling#8

Merged
BreakableHoodie merged 3 commits intomainfrom
fix/repo-review-improvements
Apr 15, 2026
Merged

fix: repo review improvements — governance docs, gitleaks, tooling#8
BreakableHoodie merged 3 commits intomainfrom
fix/repo-review-improvements

Conversation

@BreakableHoodie
Copy link
Copy Markdown
Contributor

Summary

  • Correct CODEOWNERS governance docs — CODEOWNERS in the org .github repo does NOT propagate to other repos. Reframed guidance so each project team manages its own review gates; organizers are no longer implied as default reviewers across the whole org.
  • Add break-glass procedure — documents the enforce_admins DELETE/POST pattern for merging Copilot-authored PRs blocked by GitHub's authorship restriction.
  • Consolidate gitleaks-response.md — merged the more actionable .github/docs/ version (Quick Checklist, real-vs-false-positive branching, exact commands) with the structured root docs/ version; deleted the orphaned duplicate.
  • Bump Gitleaks v8.18.2 → v8.30.1 — two-year-old version updated to current.
  • Add .gitleaks.toml — config skeleton so projects can add false-positive allowlists without editing the workflow.
  • Add .gitignore — suppresses .DS_Store, IDE dirs, .qodo/.
  • Update README.md — lists the docs/ governance directory in Contents.
  • Simplify SECURITY.md — replaces vestigial version table with a meaningful policy-maintenance note.

Test plan

  • Gitleaks workflow runs cleanly on this PR
  • Verify docs/gitleaks-response.md is the only copy (.github/docs/ version deleted)
  • Review governance doc CODEOWNERS section for accuracy

🤖 Generated with Claude Code

- Correct CODEOWNERS propagation docs: CODEOWNERS in the org .github
  repo does NOT apply to other org repos; each project must manage its
  own. Reframed guidance so organizers are not a required reviewer
  across the whole org.
- Add break-glass procedure for merging Copilot-authored PRs blocked by
  enforce_admins + Copilot-authorship restriction.
- Merge gitleaks-response.md: combined the more actionable .github/docs/
  version (Quick Checklist, real-secret vs. false-positive branches) with
  the structured docs/ version; deleted the now-orphaned duplicate.
- Bump Gitleaks from v8.18.2 to v8.30.1.
- Add .gitleaks.toml config skeleton for per-repo false-positive allowlists.
- Add .gitignore (.DS_Store, IDE dirs, .qodo/).
- Update README.md to list the docs/ governance directory.
- Replace vestigial SECURITY.md version table with a meaningful
  policy-maintenance note including last-reviewed and next-review dates.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@BreakableHoodie BreakableHoodie requested a review from a team as a code owner April 15, 2026 15:27
Trim to five links: website, events, Slack, feedback portal, CoLab.
Removes active-projects board and schedule links per organizer preference.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Copy link
Copy Markdown

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 017636623b

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread .gitleaks.toml
@@ -0,0 +1,13 @@
title = "CivicTechWR Gitleaks Config"
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P1 Badge Extend default rules in .gitleaks.toml

This new config file is loaded automatically by gitleaks detect --source ., and in Gitleaks a custom config does not include built-in rules unless [extend] useDefault = true is set. Because this file only defines a global allowlist and no [[rules]] or extend block, scans will effectively run with no detectors and can miss real secrets while still reporting success.

Useful? React with 👍 / 👎.

Without [extend] useDefault = true, a custom Gitleaks config replaces
all built-in detection rules, leaving the scanner with nothing to match
against. Flagged by Codex review on PR #8.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@BreakableHoodie
Copy link
Copy Markdown
Contributor Author

Good catch by @chatgpt-codex-connector — fixed in 243d039. Added [extend] useDefault = true so the custom config inherits all built-in Gitleaks detection rules rather than replacing them.

@chatgpt-codex-connector
Copy link
Copy Markdown

Summary

  • No additional code changes are needed. The PR head is already at commit 243d039, and .gitleaks.toml now includes the required default-rule extension via [extend] and useDefault = true, which addresses the review concern about disabling built-in detectors. .gitleaks.tomlL5-L6
  • I did not create a new commit or PR, since the trigger indicates the fix is already present and the repository is clean.

Testing / Checks

  • git rev-parse --short HEAD && git status --short
  • git log --oneline -n 5
  • sed -n '1,120p' .gitleaks.toml
  • nl -ba .gitleaks.toml | sed -n '1,80p'

View task →

@BreakableHoodie BreakableHoodie merged commit 37d7a9b into main Apr 15, 2026
2 checks passed
@BreakableHoodie BreakableHoodie deleted the fix/repo-review-improvements branch April 15, 2026 16:40
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