CLI
investigate command
Local-first structured investigation before agent execution.
investigate command
asa investigate implements the Investigation & Root Cause Engine (spec-my-A §25).
Basic usage
asa investigate "why onboarding fails after invite"
asa investigate "billing regression" --flow onboarding --depth deep --no-cloud
asa investigate "scope check" --estimate-onlyFailure-driven scope
asa investigate "fix failing tests" --from-failed-testsParses go test -json output to narrow scope to failing packages and test files.
Work integration
asa work "develop workspace-saas" --plan-only --investigate-first
asa verify billing-v2 --investigate-on-failureArtefacts
Each investigation writes under .asagiri/investigations/<id>/:
| File | Purpose |
|---|---|
report.md / report.json | Full investigation report |
context-pack.json | Minimal agent context |
replay-pack.json | Replay instructions |
graph.json | Root-cause graph |
Graph visualization
asa investigate graph <investigation-id>Modes
| Depth | Behavior |
|---|---|
quick | Smaller file cap, fast collectors |
standard | Default |
deep | Larger context pack |
ci | Tuned for CI / verify failures |
Safety
--no-clouddisables cloud model calls- Sensitive paths are excluded from context packs
- Hypotheses are scored candidates, not confirmed root causes