Skip to content

feat: blast-radius change-impact + doctor self-heal bootstrap#1

Merged
DKeken merged 1 commit into
mainfrom
feat/blast-radius-doctor
Jun 15, 2026
Merged

feat: blast-radius change-impact + doctor self-heal bootstrap#1
DKeken merged 1 commit into
mainfrom
feat/blast-radius-doctor

Conversation

@DKeken

@DKeken DKeken commented Jun 15, 2026

Copy link
Copy Markdown
Owner

Summary

  • scripts/blast_radius.py — change-impact axis. Walks dependents off graphify-out/graph.json N hops → impacted files/abstracts + per-seed test-coverage gaps + low/medium/high risk hint. Reverse-walk by default (--forward/--undirected to flip). Closes the gap vs dedicated graph-review tools using the graph codenav already builds.
  • scripts/doctor.sh — self-heal bootstrap. --fix installs graphify + python deps, builds/refreshes the graph vs HEAD, applies a taxonomy.py re-cluster if present, checks scripts, prints the agent-side MCP probes a shell can't run. Bare run = diagnose-only.
  • SKILL.md — change-impact + onboarding surfaces in the axis tables; self-healing section (each script names its own remedy on failure); self-improving loop (graphify_to_qdrant persists topology as architectural-facts).
  • README + tests — new scripts documented surgically into the rich README (mermaid/provenance preserved); 4 new TestBlastRadius cases.

Test plan

  • python3 tests/test_glue.py → 13/13 OK
  • py_compile all scripts (mirrors CI)
  • bash -n doctor.sh + locate.sh
  • blast_radius sanity-checked on a real 15MB graph: ids.ts hub → 34 dependents, HIGH risk, correct taxonomy labels

blast_radius.py walks dependents off graphify-out/graph.json N hops →
impacted files/abstracts + per-seed test-coverage gaps + risk hint
(reverse by default, --forward/--undirected to flip). Closes the
change-impact gap vs dedicated graph-review tools using the graph
codenav already builds.

doctor.sh diagnoses (--fix repairs) the whole environment: graphify +
python deps, graph presence/freshness vs HEAD, taxonomy re-cluster,
script integrity; prints the agent-side MCP checks a shell cannot run.
One-command bootstrap for a fresh install.

SKILL.md gains change-impact + onboarding surfaces in the axis tables,
a self-healing section (every script names its own remedy on failure),
and a self-improving loop (graphify_to_qdrant persists topology as
architectural-facts). README + tests updated; 13/13 glue tests green.
@DKeken DKeken merged commit d19b2f8 into main Jun 15, 2026
4 checks passed
@DKeken DKeken deleted the feat/blast-radius-doctor branch June 15, 2026 20:50
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant