Input
- Code repository address or local path (required)
- Product architecture diagram path (optional, can be multiple)
- Product documentation path (optional, can be multiple)
Output
Fixed output to output/<repo_slug>/:
topology-model.jsoncore-links.mddependency-risk.mdobservability-gaps.mdevidence-index.json
Modeling dimensions
service graphrequest pathasync pathdependency graph(DB / Cache / MQ / Third-party)failure pointobservability hook point
Execution rules
- Each path and risk item must include an evidence source (file path).
- Core user paths, control plane paths, and data plane paths must be output separately.
- Risks and instrumentation gaps must be mappable to services or dependency nodes.
- When parsing fails, output diagnosable information; key inputs must not be silently ignored.
CLI
byted-sol-stability-architecture-path-extractor \
--repo tests/integration/fixtures/sample_repo \
--product-doc examples/product-doc.md \
--arch-diagram examples/arch-diagram.md \
--out-dir output