Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 8 additions & 0 deletions docs/intent/agent-reporting/implementation-plan.md
Original file line number Diff line number Diff line change
@@ -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
Expand Down
2 changes: 1 addition & 1 deletion docs/intent/dataflow-js-react-solid/README.md
Original file line number Diff line number Diff line change
@@ -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.

Expand Down
4 changes: 3 additions & 1 deletion docs/intent/dataflow-library-models/plan.md
Original file line number Diff line number Diff line change
Expand Up @@ -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:
Expand Down
62 changes: 41 additions & 21 deletions docs/intent/dataflow-robustness/initiative-map.json
Original file line number Diff line number Diff line change
Expand Up @@ -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": {
Expand Down Expand Up @@ -361,7 +361,7 @@
{
"id": "E1",
"title": "Never wrong",
"status": "planned",
"status": "active",
"tickets": [
"T1",
"T2",
Expand All @@ -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",
Expand All @@ -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",
Expand All @@ -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"
],
Expand All @@ -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"
Expand All @@ -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",
Expand All @@ -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"
Expand All @@ -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"
Expand All @@ -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": [
Expand All @@ -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
}
}
18 changes: 12 additions & 6 deletions docs/intent/imported-quality-evidence/initiative-map.json
Original file line number Diff line number Diff line change
Expand Up @@ -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": {
Expand Down Expand Up @@ -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",
Expand Down Expand Up @@ -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
Expand Down
54 changes: 36 additions & 18 deletions docs/intent/tsx-dataflow-integration/initiative-map.json
Original file line number Diff line number Diff line change
Expand Up @@ -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": {
Expand Down Expand Up @@ -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"
},
{
Expand All @@ -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"
},
{
Expand All @@ -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"
},
{
Expand All @@ -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"
},
{
Expand All @@ -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"
},
{
Expand All @@ -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"
},
{
Expand All @@ -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"
}
],
Expand Down Expand Up @@ -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
Expand Down
Loading