diff --git a/.claude/scratchpad.md b/.claude/scratchpad.md index c61085a..95c72f1 100644 --- a/.claude/scratchpad.md +++ b/.claude/scratchpad.md @@ -12,14 +12,11 @@ ## Future Work - Antfly SDK: server-side path filter for `getDocsByFilePath` (eliminates 5k cap) -- Wire `shortestPath` into `dev_refs` as a "trace path" feature (graph.ts is ready, adapter wiring is separate scope) -- Wire `connectedComponents` into `dev_map` verbose output (graph.ts is ready) - Betweenness centrality — identifies bridge files between subsystems. Worth adding if agents need refactoring guidance. graphology (MIT, 1.6k stars) is the upgrade path if we need more than 3 hand-rolled algorithms. - **Connected components hub filtering** — widely-shared utility files (e.g., logger.ts imported by 50+ files) merge separate subsystems into one component. Filter out hub nodes (high in-degree) before computing components for better subsystem identification. - **PageRank at 10k+ nodes** — convergence tolerance 1e-6 may require all 100 iterations for large sparse graphs. Monitor performance. Consider reducing maxIterations or loosening tolerance for dev_map where approximate ranks are fine. - **getAll(limit: 10000) truncation** — medium-large monorepos may exceed 10k docs. Warning is logged but results are silently incomplete. Long-term: paginate or make limit configurable. - E2E tests in CI — blocked on Antfly memory requirements vs GitHub runner limits (7GB) -- **Python language support** — plan written at `.claude/da-plans/core/phase-4-python-support/`. 4 parts: bundle WASM + queries, PythonScanner, pattern rules, test fixtures + docs. - Vue/Svelte SFC support — `.vue`/`.svelte` files have embedded `