abinazebinoy commited on
Commit
f2840cc
·
1 Parent(s): 49ea00f

docs(roadmap): resolve audit Open Question #2 -- renumber the colliding Phase 34/35 proposals

Browse files

The audit's own Finding D-3 and Open Question #2: PHASE_ROADMAP.md's
Phase 33/34/35 headings describe different work than what the code
labels as Phase 33/34/35. Phase 33 was already resolved (see the prior
SUPERSEDED-note commit). This commit resolves the remaining two:

- 'Phase 34 -- Vector Search and Hybrid Retrieval' renumbered to
'Phase 76' -- the code already uses Phase 34 for the Forensic
Intelligence API (api/routes/forensics.py's own docstring,
tests/test_phase34_forensics.py), which is real, shipped, working
code.
- 'Phase 35 -- Plugin System and YAML Enrichers' renumbered to
'Phase 77' -- the code already uses Phase 35 for the entity-view
frontend tab wiring (tests/test_phase35_frontend.py), also real,
shipped, working code.

Chose to renumber the roadmap's still-unbuilt proposals rather than
rename the code's own docstrings/test file names, which would be far
more invasive. Moved to 76/77 (next unclaimed numbers after the
document's existing high point of 75) rather than inserting mid-
sequence, to avoid renumbering everything after them.

Verified: grepped the full document both before and after -- confirmed
neither 'Phase 34' nor 'Phase 35' is referenced as a dependency
anywhere else in the file before renumbering, and confirmed after the
edit that the only remaining mentions are inside this commit's own
explanatory notes.

Files changed (1) hide show
  1. PHASE_ROADMAP.md +25 -4
PHASE_ROADMAP.md CHANGED
@@ -311,8 +311,21 @@ Anti-forensics pattern: commit A -> commit B (change) -> commit C (reverts to A)
311
 
312
  ---
313
 
314
- ### Phase 34 -- Vector Search and Hybrid Retrieval
315
- **Branch:** `feature/phase-34-vector-search`
 
 
 
 
 
 
 
 
 
 
 
 
 
316
 
317
  **Problem:** Keyword search misses semantically similar documents. Searching
318
  "Maharashtra road contract irregularity" does not find CAG reports about
@@ -336,8 +349,16 @@ Anti-forensics pattern: commit A -> commit B (change) -> commit C (reverts to A)
336
 
337
  ---
338
 
339
- ### Phase 35 -- Plugin System and YAML Enrichers
340
- **Branch:** `feature/phase-35-plugins`
 
 
 
 
 
 
 
 
341
 
342
  **Lazy-loading plugin architecture** -- new data sources added by dropping
343
  a YAML file in `enrichers/` with no code changes.
 
311
 
312
  ---
313
 
314
+ ### Phase 76 -- Vector Search and Hybrid Retrieval
315
+
316
+ > **Renumbered from "Phase 34" (August 2026, audit Open Question #2).**
317
+ > The code already uses "Phase 34" for something else entirely --
318
+ > `api/routes/forensics.py`'s own docstring says "Phase 34: Forensic
319
+ > Intelligence API", and `tests/test_phase34_forensics.py` is a real,
320
+ > shipped test file for that work. Renumbering this still-unbuilt
321
+ > proposal to an unclaimed number was the smaller, less invasive fix
322
+ > compared to renaming the code's own docstrings and test file names,
323
+ > which are already referenced throughout this project's git history
324
+ > and this repository's own audit trail. Confirmed via grep before
325
+ > renumbering: nothing elsewhere in this document depends on or
326
+ > references "Phase 34" by number.
327
+
328
+ **Branch:** `feature/phase-76-vector-search`
329
 
330
  **Problem:** Keyword search misses semantically similar documents. Searching
331
  "Maharashtra road contract irregularity" does not find CAG reports about
 
349
 
350
  ---
351
 
352
+ ### Phase 77 -- Plugin System and YAML Enrichers
353
+
354
+ > **Renumbered from "Phase 35" (August 2026, audit Open Question #2).**
355
+ > Same reason as Phase 76 above: the code already uses "Phase 35" for
356
+ > the entity-view frontend tab wiring (`tests/test_phase35_frontend.py`,
357
+ > built and shipped as part of this same audit-driven fix batch).
358
+ > Confirmed via grep before renumbering: nothing elsewhere in this
359
+ > document depends on or references "Phase 35" by number.
360
+
361
+ **Branch:** `feature/phase-77-plugins`
362
 
363
  **Lazy-loading plugin architecture** -- new data sources added by dropping
364
  a YAML file in `enrichers/` with no code changes.