Skip to content

Commit 09170fb

Browse files
HumanBean17claude
andcommitted
chore: remove stale INDEX-AUTO-MODE and TIER2-INCREMENTAL-REBUILD proposals
Remove stale proposal files and update all references across the codebase. These proposals were outdated and their content has been superseded by GitHub issue #73 for Kuzu incremental rebuild tracking. Changes: - Remove propose/stale/INDEX-AUTO-MODE-PROPOSE.md - Remove propose/stale/TIER2-INCREMENTAL-REBUILD-PROPOSE.md - Update references in README.md, plans/, and propose/completed/ files - Update automation/cursor_propose_only/README.md example Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
1 parent 84cef79 commit 09170fb

10 files changed

Lines changed: 22 additions & 672 deletions

README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -212,5 +212,5 @@ The default embedding model is `sentence-transformers/all-MiniLM-L6-v2` (downloa
212212

213213
- `get_service_topology` — microservice-level summary aggregating `HTTP_CALLS` / `ASYNC_CALLS`.
214214
- Agentic routing layer (query classifier → vector / graph / both).
215-
- Incremental Kuzu updates (per-changed-file) — see [`propose/TIER2-INCREMENTAL-REBUILD-PROPOSE.md`](./propose/TIER2-INCREMENTAL-REBUILD-PROPOSE.md) and [`propose/INDEX-AUTO-MODE-PROPOSE.md`](./propose/INDEX-AUTO-MODE-PROPOSE.md).
215+
- Incremental Kuzu updates (per-changed-file).
216216
- Optional `codegraph_nodes` LanceDB table embedding symbol summaries so the graph itself is vector-searchable.

automation/cursor_propose_only/README.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -32,7 +32,7 @@ Notes:
3232

3333
- `--proposal` paths may be absolute or relative to `--proposal-dir`
3434
- when `--proposal` is provided, `--glob` is ignored
35-
- add `--include-completed` if selected files can come from `propose/completed/`
35+
- add `--include-completed` if selected files can come from `propose/completed/` or `propose/stale/`
3636

3737
## Generate a propose-only workflow bundle
3838

@@ -109,7 +109,7 @@ use `autopilot.py`.
109109
--repo-root . \
110110
--proposal-dir propose \
111111
--output-dir .agents/reports/propose_automation_selected \
112-
--proposal TIER2-INCREMENTAL-REBUILD-PROPOSE.md \
112+
--proposal ENHANCED-ROLE-RECOGNITION-PROPOSE.md \
113113
--planning-rounds 2 \
114114
--planning-min-severity medium \
115115
--implementation-rounds 2 \

plans/completed/AGENT-PROMPTS-AGENT-GUIDE-SURGICAL-PATCHES.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -208,9 +208,9 @@ disagreement as evidence of staleness, not as a contradiction.
208208
209209
```markdown
210210
**Staleness rule:** after `java-codebase-rag increment`, Lance is fresh
211-
but Kuzu may be stale (see `propose/TIER2-INCREMENTAL-REBUILD-PROPOSE.md`).
212-
A graph older than the source tree is normal mid-development. When in
213-
doubt, run `meta` and compare against your working tree.
211+
but Kuzu may be stale. A graph older than the source tree is normal
212+
mid-development. When in doubt, run `meta` and compare against your
213+
working tree.
214214
```
215215
216216
### Patch C — `neighbors` subsection after Batching

plans/completed/PLAN-AGENT-GUIDE-SURGICAL-PATCHES.md

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -110,8 +110,7 @@ Landing order: **PR-AGP-1 → PR-AGP-2**.
110110
(disagreement vs open file; empty `search` with visible string in editor).
111111
- Leave `After two failed attempts on the same intent, stop and report tool name, args, and response.` **unchanged**.
112112
- Immediately **after** that line, append the **Staleness rule** paragraph
113-
(Lance vs Kuzu after `increment`, pointer to
114-
`propose/TIER2-INCREMENTAL-REBUILD-PROPOSE.md`, `meta` comparison).
113+
(Lance vs Kuzu after `increment`, `meta` comparison).
115114

116115
**Patch C — `neighbors` confidence**
117116

plans/completed/PLAN-CLI-SCENARIOS.md

Lines changed: 5 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -4,9 +4,8 @@ Status: **completed — shipped** to `master`. This plan implemented
44
[`propose/completed/CLI-SCENARIOS-PROPOSE.md`](../propose/completed/CLI-SCENARIOS-PROPOSE.md).
55
**PR-CLI-1** (propose approval + plan tracking) was [#72](https://github.com/HumanBean17/java-codebase-rag/pull/72).
66

7-
Depends on: **none** (engine work for Kuzu incremental rebuild stays under
8-
[`propose/TIER2-INCREMENTAL-REBUILD-PROPOSE.md`](../propose/TIER2-INCREMENTAL-REBUILD-PROPOSE.md)
9-
and the tracking issue created in PR-CLI-2). **Recommended ordering:** any
7+
Depends on: **none** (engine work for Kuzu incremental rebuild is tracked under
8+
GitHub issue #73, created in PR-CLI-2). **Recommended ordering:** any
109
standalone `cli.py` import-latency / deferred-import hardening PR should land
1110
before PR-CLI-2 so contributors exercising new subcommands do not pay multi-second
1211
`--help` cost (see propose §6 closing note).
@@ -201,8 +200,8 @@ Landing order: **PR-CLI-1 → PR-CLI-2 → PR-CLI-3**.
201200

202201
### 8. GitHub
203202

204-
- Open issue **AST graph (Kuzu) incremental rebuild”** referencing
205-
`propose/TIER2-INCREMENTAL-REBUILD-PROPOSE.md`; paste URL into cli constant.
203+
- Open issue **AST graph (Kuzu) incremental rebuild”** (tracking issue #73);
204+
paste URL into cli constant.
206205

207206
## Tests for PR-CLI-2
208207

@@ -283,9 +282,7 @@ Follow the **explicit file list** in propose §6 (`README.md`,
283282
`docs/MANUAL-VERIFICATION-CHECKLIST.md`, `docs/paper/paper.tex` + rebuild
284283
`paper.pdf`, `AGENTS.md`, **`.cursor/rules/*.mdc`** (agent rules audit),
285284
`CODEBASE_REQUIREMENTS.md`, `mcp.json.example` (comments only — keys from PR-CLI-2),
286-
`propose/INDEX-AUTO-MODE-PROPOSE.md`,
287-
`propose/TIER2-INCREMENTAL-REBUILD-PROPOSE.md`, `docs/PRODUCT-VISION.md`,
288-
`.gitignore`).
285+
`docs/PRODUCT-VISION.md`, `.gitignore`).
289286

290287
Add **Migration from legacy names** sections with explicit `mv` commands
291288
(`lancedb_data``.java-codebase-rag`, `.lancedb-mcp.yml`

plans/completed/PLAN-SCHEMA-V2.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -360,7 +360,7 @@ with every hit accounted for (fixed or justified).
360360
- Multi-target Client/Producer nodes; materialized composite edges.
361361
- Hints v3 implementation (PR-D — [`plans/completed/PLAN-HINTS-V3.md`](./PLAN-HINTS-V3.md)).
362362
- Ontology **15** or second re-index.
363-
- Ranking / incremental rebuild proposes (`RANKING-MICROSERVICE`, `TIER2-INCREMENTAL-REBUILD`).
363+
- Ranking / incremental rebuild proposals.
364364
- Special-casing `tests/bank-chat-system/` in production code.
365365

366366
# Whole-plan done definition

propose/completed/AGENT-GUIDE-SURGICAL-PATCHES-PROPOSE.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -96,9 +96,9 @@ Staleness paragraph (step 3, after the `After two failed attempts…` line):
9696

9797
```markdown
9898
**Staleness rule:** after `java-codebase-rag increment`, Lance is fresh
99-
but Kuzu may be stale (see `propose/TIER2-INCREMENTAL-REBUILD-PROPOSE.md`).
100-
A graph older than the source tree is normal mid-development. When in
101-
doubt, run `meta` and compare against your working tree.
99+
but Kuzu may be stale. A graph older than the source tree is normal
100+
mid-development. When in doubt, run `meta` and compare against your
101+
working tree.
102102
```
103103

104104
**Why the placement**: the recovery playbook is where agents land after a confusing result; the staleness note reads as a follow-on to the existing “stop thrashing” sentence, not as a stray table footer.
@@ -260,9 +260,9 @@ disagreement as evidence of staleness, not as a contradiction.
260260

261261
```markdown
262262
**Staleness rule:** after `java-codebase-rag increment`, Lance is fresh
263-
but Kuzu may be stale (see `propose/TIER2-INCREMENTAL-REBUILD-PROPOSE.md`).
264-
A graph older than the source tree is normal mid-development. When in
265-
doubt, run `meta` and compare against your working tree.
263+
but Kuzu may be stale. A graph older than the source tree is normal
264+
mid-development. When in doubt, run `meta` and compare against your
265+
working tree.
266266
```
267267

268268
### A.4 — Patch C (after `**Batching:**` under `#### neighbors`)

propose/completed/CLI-SCENARIOS-PROPOSE.md

Lines changed: 3 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@
1515
- **Rename `lancedb_data` default index directory** to `.java-codebase-rag/` (a hidden dotted directory under the project root, matching the dotted-config-file convention). All hardcoded `./lancedb_data` defaults updated.
1616
- **Rename Python package** `user_rag/``java_codebase_rag/`. Update `pyproject.toml [project.scripts]`, all imports, the test file `tests/test_user_rag_cli.py`, and the `python -m user_rag.cli` example in the operator playbook. Set `pyproject.toml [project].name` to **`java-codebase-rag`** (aligned with the GitHub repository basename).
1717
- One-release deprecation: `refresh` stays as a hidden alias for `reprocess` with a stderr warning, then drops. **No deprecation window for env vars / config / package rename** — breaking changes allowed (no users yet).
18-
- Migration shape: **3 PRs** — propose merge → CLI + config consolidation (this design) → docs update across the full tree. Engine work for true Kuzu incremental is out of scope and tracked under `propose/TIER2-INCREMENTAL-REBUILD-PROPOSE.md`.
18+
- Migration shape: **3 PRs** — propose merge → CLI + config consolidation (this design) → docs update across the full tree. Engine work for true Kuzu incremental is out of scope.
1919

2020
---
2121

@@ -230,7 +230,7 @@ Three more renames that the env-var work makes the natural moment for:
230230

231231
### 3.9 GitHub issue for Kuzu incremental tracking
232232

233-
Open a GitHub issue titled **"AST graph (Kuzu) incremental rebuild"** referencing `propose/TIER2-INCREMENTAL-REBUILD-PROPOSE.md`. Issue URL is hard-coded into the `increment` warning message. The issue is the user-facing handle the warning points at; the propose is the technical scope. Use the **canonical GitHub repo path for this project** when the issue is filed (see Appendix A); do not hard-code a stale org/repo slug in the merged propose.
233+
Open a GitHub issue titled **"AST graph (Kuzu) incremental rebuild"**. Issue URL is hard-coded into the `increment` warning message. The issue is the user-facing handle the warning points at. Use the **canonical GitHub repo path for this project** when the issue is filed (see Appendix A); do not hard-code a stale org/repo slug in the merged code.
234234

235235
---
236236

@@ -280,7 +280,7 @@ Open a GitHub issue titled **"AST graph (Kuzu) incremental rebuild"** referencin
280280

281281
| Question / feature | Why we skip it |
282282
|---|---|
283-
| Kuzu incremental rebuild | Engine work; tracked under `propose/TIER2-INCREMENTAL-REBUILD-PROPOSE.md` and the new tracking issue. Out of scope of a CLI restructure. |
283+
| Kuzu incremental rebuild | Engine work; tracked under the GitHub issue #73. Out of scope of a CLI restructure. |
284284
| Auto-detect "should this be `init` or `reprocess`?" | Violates principle 3 (one scenario, one safe default). Operator intent matters; refusing on `init` and being explicit on `reprocess` is the safety policy. |
285285
| Pipeline-stage subcommands (`build-graph`, `update-lance`) | Violates principle 1. Direct script invocation (`python build_ast_graph.py`) is the escape hatch for advanced users; documented in `docs/JAVA-CODEBASE-RAG-CLI.md` but not a first-class CLI verb. |
286286
| Graph-freshness query (`meta --graph-freshness`) | Useful but distinct surface; should ride with the Tier-2 incremental work where graph version tracking gets implemented. |
@@ -314,8 +314,6 @@ Open a GitHub issue titled **"AST graph (Kuzu) incremental rebuild"** referencin
314314
- `.cursor/rules/*.mdc` — agent workflow / env / CLI contract; see **Agent rules audit** below (must match post-rename surface).
315315
- `docs/CODEBASE_REQUIREMENTS.md` — every `.lancedb-mcp.yml` / `LANCEDB_MCP_*` / `lancedb_data` reference updated.
316316
- `mcp.json.example` — **PR-CLI-3 is a second pass only:** PR-CLI-2 updates this file so **env keys match the live server**; PR-CLI-3 reconciles comments, examples, and any doc drift — **no conflicting edits**; if both PRs touch it, **PR-CLI-2 wins** for structure, PR-CLI-3 for prose polish.
317-
- `propose/INDEX-AUTO-MODE-PROPOSE.md` — one-line note that `refresh` is being renamed to `reprocess`.
318-
- `propose/TIER2-INCREMENTAL-REBUILD-PROPOSE.md` — one-line note that the new tracking issue (created in PR-CLI-2) is the user-facing handle.
319317
- `docs/PRODUCT-VISION.md` — update `lancedb_data` mention (§ about Kuzu's on-disk footprint) and any `refresh` reference.
320318
- `.gitignore` — add `.java-codebase-rag/`, keep `lancedb_data/` for grace-period cleanup, or remove if PR-CLI-2 drops that grace-period entry.
321319

propose/stale/INDEX-AUTO-MODE-PROPOSE.md

Lines changed: 0 additions & 124 deletions
This file was deleted.

0 commit comments

Comments
 (0)