diff --git a/docs/intent/agent-reporting/implementation-plan.md b/docs/intent/agent-reporting/implementation-plan.md index b44aa1d5..2674c242 100644 --- a/docs/intent/agent-reporting/implementation-plan.md +++ b/docs/intent/agent-reporting/implementation-plan.md @@ -1,5 +1,13 @@ # Agent reporting plan +Status on 2026-11-12, checked against origin/main `0bfb05ba`: + +- Step 1 shipped in #338. +- Step 2 shipped in #339 and #343. The fingerprinted cache was enough, so no snapshot artifact was built. +- Step 3 shipped in #339, #341, #345 and #347. +- Step 4 is partial. #345 and #347 add test leads and branch shape. Import, history and data-flow evidence per scope are not built. +- Step 5 is open. `skills/srcly-code-quality/SKILL.md` and the README document `explain --at`, but the frozen-repo evaluation is not recorded. + Build a concise, evidence-first CLI for repository, folder, file and symbol investigation. Fix misleading results first. Then prove that saved analysis and scoped queries improve a real agent audit before committing to a larger contract. The [research summary](../../research/agent-reporting-2026-10/README.md) records the decision and review. The [original Pro materials](assets/pro-results/2026-10-31/INDEX.md) include detailed examples and a 100-case craft ledger. ## 1. Repair the current commands diff --git a/docs/intent/dataflow-js-react-solid/README.md b/docs/intent/dataflow-js-react-solid/README.md index bf1b5113..fc2f5a42 100644 --- a/docs/intent/dataflow-js-react-solid/README.md +++ b/docs/intent/dataflow-js-react-solid/README.md @@ -1,6 +1,6 @@ # JavaScript, React, and SolidJS data-flow correctness -Status: researched; implementation has not started. Reviewed on 2026-11-01 at `e07cc510087b5c028273cad785b97ee36c6c3b35`. +Status on 2026-11-12: Stages 1–4 shipped in #316–#337, and `docs/dataflow-coverage.md` records their rules. One Stage 4 gap is open: graph and ledger still differ on 9 of 137 anchors (pgm `task-ledger-and-graph-agree-on-every-shared-expression`). Stages 5 and 6 have not started. Reviewed on 2026-11-01 at `e07cc510087b5c028273cad785b97ee36c6c3b35`. Start with the [research summary](../../research/dataflow-js-react-solid-2026-11-01/README.md), then the [implementation plan](implementation-plan.md). The [review ledger](review.md) records accepted findings, limits, and recommendation dispositions. Preserve the [seven original Pro assets](assets/pro-results/2026-11-01/README.md) as research evidence. diff --git a/docs/intent/dataflow-library-models/plan.md b/docs/intent/dataflow-library-models/plan.md index b14a9a15..cf84e206 100644 --- a/docs/intent/dataflow-library-models/plan.md +++ b/docs/intent/dataflow-library-models/plan.md @@ -3,11 +3,13 @@ title: "Data-flow library models as data — plan" slug: "dataflow-library-models" phase: plan status: in-progress -last_updated: "2026-10-26" +last_updated: "2026-11-12" --- # Library models as data +Status on 2026-11-12: steps 1–3 shipped (#206, #212, #211). Steps 4–7 shipped in part, and their remaining work is open in the pgm area "Data flow: library models as data". Step 8 (user rows) has not started. + **2026-11-01 follow-up:** the [JavaScript, React, and SolidJS research](../../research/dataflow-js-react-solid-2026-11-01/README.md) reviews incorrect summaries as well as missing models. Its [reviewed plan](../dataflow-js-react-solid/implementation-plan.md) extends this loader with finite callback/result roles. The original research assets are preserved; no new model behavior is implemented by that documentation. The engine knows what library code does in three different forms: diff --git a/docs/intent/dataflow-robustness/initiative-map.json b/docs/intent/dataflow-robustness/initiative-map.json index a4cf294f..37740b1b 100644 --- a/docs/intent/dataflow-robustness/initiative-map.json +++ b/docs/intent/dataflow-robustness/initiative-map.json @@ -4,11 +4,11 @@ "title": "Data flow robustness", "slug": "dataflow-robustness", "scale": "program", - "current_phase": "plan", - "last_updated": "2026-10-24", + "current_phase": "execution", + "last_updated": "2026-11-12", "summary": "Make srcly's Data flow mode dependable after the #104-#117 stack: never wrong (per-box status, no proof-less proven edges, dead ends named), never broken (fake-engine outcome shapes, Playwright smoke, stale end to end), then fast (<=10 s cold on visual-notes). Then carry M6, M4, M8, M7, call identity (M5 edits 1-2), Return, anchor extensions and two visual fixes. Graph is primary; ledger is detail.", - "status": "planned", - "next_action": "Maintainer approval, then T1 (per-box status in routeGraph) as a PR stacked on the docs PR." + "status": "active", + "next_action": "Remaining: T4 field lineage, T24 data-flow evidence in metrics and findings, T25 fork-ledger close-out, T26 registry stress test. Reconciled 2026-11-12 against origin/main 0bfb05ba." }, "artifacts": { "intent_brief": { @@ -361,7 +361,7 @@ { "id": "E1", "title": "Never wrong", - "status": "planned", + "status": "active", "tickets": [ "T1", "T2", @@ -374,12 +374,14 @@ "valid_intermediate_state": "Projection-only changes; analysis untouched until T4.", "rollback": "Revert each ticket PR; contracts re-emitted.", "dependencies_introduced": [], - "evidence": [] + "evidence": [ + "T1 #121, T2 #123, T3 #124 merged. T4 (field lineage from non-filesystem origins) not built: engine/test/srcly/route-graph-source.test.ts still expects lineage unavailable." + ] }, { "id": "E2", "title": "Never broken", - "status": "planned", + "status": "completed", "tickets": [ "T5", "T6", @@ -393,12 +395,14 @@ "valid_intermediate_state": "Tests only plus fake engine changes; product unchanged.", "rollback": "Revert the test PRs.", "dependencies_introduced": [], - "evidence": [] + "evidence": [ + "T5 #125, T6 #126, T7 #127 merged." + ] }, { "id": "E3", "title": "Fast", - "status": "planned", + "status": "completed", "tickets": [ "T8", "T9", @@ -416,12 +420,14 @@ "dependencies_introduced": [ "node-engine" ], - "evidence": [] + "evidence": [ + "T8 #128, T9 #130, T10 #129, T11 #131 merged; T12 scoped Program measured and kept off (#133)." + ] }, { "id": "E4", "title": "Call identity", - "status": "planned", + "status": "completed", "tickets": [ "T13" ], @@ -433,12 +439,14 @@ "valid_intermediate_state": "Older facts without callId keep the one-call-site rule.", "rollback": "Revert the two analysis edits; UPSTREAM.md row removed.", "dependencies_introduced": [], - "evidence": [] + "evidence": [ + "T13 #132 merged." + ] }, { "id": "E5", "title": "Effects (M6)", - "status": "planned", + "status": "completed", "tickets": [ "T14", "T15" @@ -451,12 +459,14 @@ "valid_intermediate_state": "Op available before UI.", "rollback": "Revert op and panel.", "dependencies_introduced": [], - "evidence": [] + "evidence": [ + "T14 #134, T15 #135 merged." + ] }, { "id": "E6", "title": "Graph surface", - "status": "planned", + "status": "completed", "tickets": [ "T16", "T17", @@ -474,12 +484,14 @@ "valid_intermediate_state": "Each ticket independent behind its own entry point.", "rollback": "Revert per ticket.", "dependencies_introduced": [], - "evidence": [] + "evidence": [ + "T16 #136, T17 #137, T18 #138, T19 #139, T20 #142, T21 #140, T22 #141 merged." + ] }, { "id": "E7", "title": "Ship", - "status": "planned", + "status": "active", "tickets": [ "T23", "T24" @@ -492,12 +504,14 @@ "valid_intermediate_state": "Released wheel shows N/A until M8 lands.", "rollback": "Revert build change; metrics N/A.", "dependencies_introduced": [], - "evidence": [] + "evidence": [ + "T23 wheel bundling #149 merged. T24 (metrics, findings, packets; same as tsx-dataflow-integration M7) not built." + ] }, { "id": "E8", "title": "Engine hygiene", - "status": "planned", + "status": "active", "tickets": [ "T25", "T26" @@ -508,7 +522,9 @@ "valid_intermediate_state": "Docs and tests only.", "rollback": "Revert.", "dependencies_introduced": [], - "evidence": [] + "evidence": [ + "engine/UPSTREAM.md exists; T25 close-out waits on T4. T26 registry stress test not built." + ] } ], "cut_line": [ @@ -535,7 +551,11 @@ "event": "created", "phase": "plan", "note": "Intent, shape, research, decision log, plan (T1-T3 ready), backlog after three question rounds." + }, + { + "date": "2026-11-12", + "change": "Set true milestone statuses from merged PRs: E2-E6 completed; E1, E7, E8 active with open tickets T4, T24, T25, T26." } ], "closure": null -} \ No newline at end of file +} diff --git a/docs/intent/imported-quality-evidence/initiative-map.json b/docs/intent/imported-quality-evidence/initiative-map.json index 8bd0efda..14c42f52 100644 --- a/docs/intent/imported-quality-evidence/initiative-map.json +++ b/docs/intent/imported-quality-evidence/initiative-map.json @@ -4,11 +4,11 @@ "title": "Complementary evidence without another analyzer platform", "slug": "imported-quality-evidence", "scale": "capability", - "current_phase": "plan", - "last_updated": "2026-10-15", + "current_phase": "execution", + "last_updated": "2026-11-12", "summary": "Test original dependency edges and artifact-based clone, typed-finding and coverage workflows separately.", - "status": "planned", - "next_action": "After metric-trust, prove original dependency-edge witnesses without changing existing graph geometry." + "status": "active", + "next_action": "m1 (cycles with original-edge witnesses), m2 (clone families) and m4 (coverage, then CRAP) are not built; the metric overhaul put clones, coverage and CRAP below its cut line. Byron decides whether to cancel them or keep them open. Reconciled 2026-11-12 against origin/main 0bfb05ba." }, "artifacts": { "intent_brief": { @@ -331,8 +331,10 @@ "proof": "Unsafe flow versus token count, expected errors, exact duplicates and a real configured report.", "valid_intermediate_state": "One typed report joins rule evidence without running a new engine. Existing source-only scanning remains usable.", "rollback": "Revert the scoped milestone commit or omit optional evidence; no stored-data migration.", - "status": "planned", - "evidence": [] + "status": "completed", + "evidence": [ + "Replaced by #78 (merged 2026-10-16): findings run the project tsc and eslint, else ruff and srcly TS rules, instead of importing a report; #361 later added ast-grep rule packs." + ] }, { "id": "m4", @@ -371,6 +373,10 @@ { "date": "2026-10-15", "change": "Created planned initiative from collected Pro research and independent source checks. Application proofs remain unrun." + }, + { + "date": "2026-11-12", + "change": "Marked m3 completed as replaced by #78. m1, m2 and m4 remain open." } ], "closure": null diff --git a/docs/intent/tsx-dataflow-integration/initiative-map.json b/docs/intent/tsx-dataflow-integration/initiative-map.json index a8c969c3..18921a5a 100644 --- a/docs/intent/tsx-dataflow-integration/initiative-map.json +++ b/docs/intent/tsx-dataflow-integration/initiative-map.json @@ -4,11 +4,11 @@ "title": "Bring tsx-data-flow into srcly", "slug": "tsx-dataflow-integration", "scale": "program", - "current_phase": "plan", - "last_updated": "2026-10-23", + "current_phase": "execution", + "last_updated": "2026-11-12", "summary": "One engine (tsx-data-flow analysis moved into engine/, one lazy Node child) feeds three srcly surfaces: route -> terminal graph in the dependency viewer (headline), value-path ledger from graph destinations or code-viewer expressions (PR #102), and a function-effects panel (PR #103); findings/metrics/markers/reports follow. detailed-plan.md adds the file-level design, contracts, two-tier engine session, view-state registry and the corrections a code review of both repositories forced.", - "status": "planned", - "next_action": "User approval to start M1 (three PRs). D1-D8 defaults accepted 2026-10-23; PR #101 stays docs only." + "status": "active", + "next_action": "Only M7 remains: data-flow evidence in srcly pipelines (fileSignals, findings tool, catalog metrics, markers, work packets, skill). Nothing on main yet. Reconciled 2026-11-12 against origin/main 0bfb05ba." }, "artifacts": { "intent_brief": { @@ -563,8 +563,10 @@ "proof": "pnpm --filter engine test; uv run pytest tests/test_dataflow_engine.py (fake engine lifecycle + real smoke)", "valid_intermediate_state": "No UI; base scan unchanged; status names N/A reasons.", "rollback": "Remove engine/ and routers/dataflow.py.", - "status": "planned", - "evidence": [], + "status": "completed", + "evidence": [ + "#104, #105, #106 merged; engine/bin/srcly-engine.ts, server/app/services/dataflow/engine.py." + ], "track": "foundation" }, { @@ -575,8 +577,10 @@ "proof": "engine contract tests on solid-route; client adapter vitest; screenshots of solid-route and /time-blocks; layout spike decision.", "valid_intermediate_state": "Mode hidden when engine N/A.", "rollback": "Revert mode switch + routeGraph op.", - "status": "planned", - "evidence": [], + "status": "completed", + "evidence": [ + "#107, #110, #111, #112, #130 merged; engine/src/srcly/ops/route-graph.ts, client/src/viz/deps/flow/." + ], "track": "A" }, { @@ -587,8 +591,10 @@ "proof": "engine fixtures + HotSpotItem anchor contract tests; client investigation tests; browser journey 1440/1024 with Back/Forward/Return.", "valid_intermediate_state": "Entry hidden when engine N/A.", "rollback": "Revert investigation/ + valueFlow op.", - "status": "planned", - "evidence": [], + "status": "completed", + "evidence": [ + "#108, #109, #114, #115, #116, #117 merged." + ], "track": "B" }, { @@ -599,8 +605,10 @@ "proof": "routePath contract test on /time-blocks; browser journey.", "valid_intermediate_state": "Graph still works without ledger link.", "rollback": "Revert routePath op and link.", - "status": "planned", - "evidence": [], + "status": "completed", + "evidence": [ + "#136 merged; GET /api/dataflow/route-path." + ], "track": "A+B" }, { @@ -611,8 +619,10 @@ "proof": "precision fixtures (two-call identity helper, returns-other-arg) + anchor tests.", "valid_intermediate_state": "M3 ledger unaffected for local paths.", "rollback": "Revert pairing; paths fall back to frontier rows.", - "status": "planned", - "evidence": [], + "status": "completed", + "evidence": [ + "#132 merged." + ], "track": "B" }, { @@ -623,8 +633,10 @@ "proof": "compact semantic fixture + three anchor contract tests; panel scenario test.", "valid_intermediate_state": "Panel shows unavailable without engine.", "rollback": "Revert EffectsPanel + functionEffects op.", - "status": "planned", - "evidence": [], + "status": "completed", + "evidence": [ + "#134, #135 merged; POST /api/dataflow/function-effects." + ], "track": "C" }, { @@ -649,8 +661,10 @@ "proof": "build-srcly.sh then clean-venv smoke on examples/solid-route; wheel size recorded.", "valid_intermediate_state": "Pre-M8 wheels show N/A.", "rollback": "Drop bundle step.", - "status": "planned", - "evidence": [], + "status": "completed", + "evidence": [ + "#149 merged; engine/scripts/bundle.mjs." + ], "track": "release" } ], @@ -812,6 +826,10 @@ "date": "2026-10-23", "event": "User accepted the D1-D8 defaults; PR #101 remains docs only, M1 awaits separate approval.", "phase": "plan" + }, + { + "date": "2026-11-12", + "change": "Set true milestone statuses from merged PRs: M1-M6 and M8 completed; M7 still planned." } ], "closure": null