Skip to content

docs(product): record S3+S7 and S1+S2 shipped and S4+S5 in review in the FSMA 204 gap analysis - #3763

Draft
PetrefiedThunder wants to merge 3 commits into
mainfrom
claude/gracious-edison-8fijxh-gap-status
Draft

PetrefiedThunder wants to merge 3 commits into
mainfrom
claude/gracious-edison-8fijxh-gap-status

Conversation

@PetrefiedThunder

Copy link
Copy Markdown
Collaborator

Summary

Docs-only status update of docs/product/FSMA_204_READINESS_GAP_ANALYSIS_2026-10-28.md (merged as #3701) now that three of its follow-up PRs have landed or are in review. Every original 2026-10-28 finding is kept verbatim; a dated "Status 2026-10-30" sentence is appended where the state changed, each checked against the code at the named main commits.

Left as written on purpose (outside the brief, listed for a later pass): section 4's "the depth-cap flag is untested because it does not exist", row 12's "neither the audit row nor the package records it", and section 8's KDE-coverage "not an audit row" are partly stale after #3713/#3714.

Type of Change

  • Bug fix
  • New feature
  • Enhancement to existing feature
  • Refactor (no behavior change)
  • Documentation
  • CI/CD or infrastructure
  • Security fix

Test Plan

  • Unit tests added/updated
  • Integration tests pass
  • Manual testing performed
  • N/A (docs, config, etc.)

Run locally: scripts/check_docs_links.py (pass), scripts/check_trust_safety_copy.py (pass), scripts/ci/check_secrets_baseline.sh on the file (pass), git diff --check (pass), a per-table column-count check over every table row (constant).

Checklist

  • My code follows the existing patterns in the codebase
  • I have not introduced hardcoded secrets or credentials
  • If this PR adds a test that uses sys.modules[X] = stub, I justified it in the PR description (none)
  • I have updated relevant documentation (if applicable)
  • My changes generate no new warnings or lint errors

Related Issues

Relates to #3701, #3713, #3714, #3717.


Generated by Claude Code

…A 204 gap analysis

The 2026-10-28 gap analysis (merged as #3701, main 8c977b9) described
four limits as unreported and two evidence gaps as open. Three of the
sibling PRs it spawned have since landed or reached review, so the
document's status columns no longer matched main. This change adds
dated "Status 2026-10-30" notes next to the original findings instead
of rewriting them, so the 2026-10-28 verification stays readable as
the baseline.

docs/product/FSMA_204_READINESS_GAP_ANALYSIS_2026-10-28.md:

- Verification basis (line 7): one status line naming #3714 (main
  2d43bf0), #3713 (main 80dfe96), #3717 (head 6c27050) and #3701.
- Section 3 rows 9, 11, 13 and 14: repo-state, evidence and
  disposition columns record what shipped. Row 11 cites
  depth_exhausted and max_depth on TraceResponse in
  services/ingestion/app/canonical_router.py, the validated direction
  argument and per-direction depth flag in
  services/shared/cte_persistence/queries.py, and the direction query
  parameter on GET /api/v1/fda/trace/{tlc}. Row 13 cites
  EXPORT_EVENT_LIMIT in services/ingestion/app/epcis/persistence.py
  and the regengine:limit, regengine:truncated and regengine:ordering
  fields in the regengine:metadata block of
  services/ingestion/app/epcis/router.py, plus the cap copy in
  frontend/src/lib/customer-readiness.ts and
  docs/PRODUCT_DESCRIPTION.md. Row 14 cites the hashed
  evidence_context_<scope>_<timestamp>.json member built by
  _build_fda_package in services/ingestion/app/fda_export_service.py,
  with rule_versions from services/shared/rules/versions.py and
  known_gaps (including coverage_gate_bypassed for the allow_incomplete
  bypass) from _build_known_gaps in the same file. Row 9 cites the v141
  append-only trigger (08c7cf36ddbe) on fsma.traceability_events, its
  column allowlist and the fsma.allow_mutation break-glass from #3717,
  and names role-gated break-glass authorization as a planned follow-up.
- Section 7: the waiver-approver bullet notes S5 in review in #3717
  (approver from the principal's key_id via _actor_from_principal).
- Section 8: the /trace depth cap, FDA lineage depth, lineage direction
  and EPCIS LIMIT 2000 rows keep the 2026-10-28 answer and add the
  post-PR answer with the field names and PR numbers.
- Section 9: the P1 list gains a status column per story (S1, S2, S3,
  S7 shipped; S4, S5 in review; S6, S8 open, unchanged).
- Section 11: the PRODUCT_DESCRIPTION.md EPCIS-cap debt item is marked
  resolved by #3714.

Departure from the brief: the brief described #3713 as in review. The
GitHub record shows it merged to main at 80dfe96 on 2026-10-30 (after
this branch's base fb4e5df), and its code was read at that commit, so
S1 and S2 are recorded as shipped. The brief's citation
services/ingestion/app/fda_export/known_gaps.py does not exist on main;
the known-gaps builder lives in fda_export_service.py and is cited
there. No other claim in the document was changed.

Checks: scripts/check_docs_links.py, scripts/check_trust_safety_copy.py,
scripts/ci/check_secrets_baseline.sh on the file, git diff --check, and
a per-table column-count check all pass.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01GyhDYG3ddQvVKyu2qtYfCj
@coderabbitai

coderabbitai Bot commented Oct 30, 2026 •

Copy link
Copy Markdown

Important

Draft PR not reviewed

Draft PRs are not automatically reviewed by default.

  • Trigger a manual review

To automatically review draft PRs, update your CodeRabbit configuration:

reviews:
  auto_review:
    drafts: true
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

@github-actions

github-actions Bot commented Oct 30, 2026 •

Copy link
Copy Markdown
Contributor

PR Blocker Checklist

Head SHA: 99caf59950f58934cc2db7056f5877f604f43c1e

Status: Ready

  • All review threads resolved
  • No reviews requesting changes
  • No blocked review engines

@github-actions github-actions Bot added the docs label Oct 30, 2026

PetrefiedThunder commented Oct 31, 2026 •

Copy link
Copy Markdown
Collaborator Author

Status 2026-11-02 12:30 UTC: head 99caf59 is green (PR Gate run 41431363775). It waits only on a REVIEW: PASS <engine> 99caf59… marker.


Generated by Claude Code

PetrefiedThunder and others added 2 commits November 2, 2026 10:45
#3717 merged as main 81f0ebc. The header, row 9,
the section 7 waiver note and stories S4 and S5 said "in review, head
6c27050" and called role-gated break-glass authorization a planned
follow-up with no PR; that follow-up is #3764
(v142 17fc5f9d1e69), now in review.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01GyhDYG3ddQvVKyu2qtYfCj
@vercel

vercel Bot commented Nov 2, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
regengine Ready Ready Preview Nov 2, 2026 10:47am UTC

Request Review

This branch was successfully deployed

1 active deployment
Preview — 99caf599 Deployed Nov 2, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant