OWASP / OWASP/OpenCRE

Continuity runbook: Gap analysis ops

Open
#1,069 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

existing-maintainers-only
Dominant language
Python
Stars
180
Forks
137
Avg merge
3d 23h
Merged PRs (30d)
21

Description

Task

A second maintainer can diagnose incomplete/503 map analysis on production and fix it by local backfill plus optional approved cache sync — never by computing gap analysis on Heroku.

Success criteria

  • HTTP diagnose: make monitor-ga-health-prod / make verify-ga-complete-prod
  • Can start local backfill: make backfill-gap-analysis or make backfill-gap-analysis-sync after local-stack
  • States clearly: prod is cache-only; miss → 404; no --ga_backfill_* against prod URLs
  • Runbook docs/continuity/runbooks/gap-analysis-ops.md (skill continuity-gap-analysis-ops)

Context

  • scripts/backfill_gap_analysis.sh, scripts/sync_gap_analysis_table.py
  • Worker dyno + Redis/Neo4j matter for 503s; restart may be the first prod action, still no GA compute on prod

Constraints

  • existing maintainers only
  • Do not sync GA tables to prod in the first drill unless asked
  • No authenticated chatbot prompts as a “test”

Agent prompt

See Agent prompt in docs/continuity/runbooks/gap-analysis-ops.md.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with docs/continuity/runbooks/gap-analysis-ops.md and its Agent prompt, then review scripts/backfill_gap_analysis.sh and scripts/sync_gap_analysis_table.py. Run the documented production health checks and local-stack backfill commands; done means the runbook covers diagnosis, local backfill, optional approved cache sync, cache-only production behavior, and the stated constraints.

Written by the indexing model from the issue text.

Assessment

Tech stack
python, shell
Domain
devops, documentation
Issue type
Documentation
Difficulty
4/5
Estimated time
3-5 days
Activity status
Active
Clarity
Clearly specified
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.