Developer Guide

Jump to bottom

Your Name edited this page Jan 26, 2026 · 1 revision

Developer Guide

Repo Structure

src/ — core graph + CLI
spec/ — data model and concepts
tui/ — terminal UI
web/ — static web UI (no build)
tests/ — unit + integration
STATE.scm, META.scm, ECOSYSTEM.scm — 6SCM metadata

Build & Run

cargo build
cargo run -- scan /mnt/eclipse/repos
cargo run -- export --format json > web/export.json
just web-serve-port 1803

Data Contracts

JSON export is the stable handoff to UI and other tools.
DOT export supports Graphviz visualization.

Testing

cargo test

Contribution Notes

Keep edges evidence-backed and explainable.
Prefer manual-first updates; automated suggestions are proposals only.