SSpine3.8.2
pip install synaptixs-spine
● governed autonomous SDLC

Governed, provenance-grounded autonomous delivery

Turn requirements into reviewed, tested pull requests — with a human in control.

Spine reads your repo and its docs, grounds every change in what already exists, and stops at two gates you own.

pip install synaptixs-spine Try the free comprehension skill →

8 languages· 9 doc formats· 41 CLI commands· MIT· deterministic, no-LLM comprehension

living graph · flask-like repo ● seeded layout — identical every reload
models auth db routing

The 30-second proof

Show, don't claim. Every line below is real output. Every fact points at a file and a line.

1 · ASK
$ orchestrator blast_radius --symbol validate
→ 7 callers reach this symbol
auth.login app/auth.py:120
routing.POST /login routing.py:210
docs/auth.md MENTIONS
2 · FIND
$ orchestrator regression validate
⚠ 4 reachable symbols have no test
get_user models.py:70
commit db.py:88
password_hash models.py:20
3 · SHIP
$ orchestrator sdlc feature --safe
✓ branch feature/validate-guard
3 files · +148 −12 · 6 tests added
⏸ no push, no PR — awaiting your approval
what makes it different

Most tools map your codebase. Spine changes it — under governance.

01

It ships code, not answers

Requirements → grounded codegen → tests → a reviewed PR. Other tools hand you a map and leave the engineering to you.

02

Deterministic by construction

Same commit in, byte-identical output out. No LLM in comprehension. A report you can diff in code review.

03

You hold both gates

Nothing is pushed, merged, or written to your tracker without an explicit human approval. Every action is audited.

the money shot

Blast radius

The question every engineer asks before touching anything: what breaks if I change this? Spine answers it from facts, not guesses — symbols with no covering test stay marked.

source reached no covering test
0affected
0no test
0hops out
View as data (text equivalent)

    This is the question every engineer asks before touching anything. Spine answers it from facts, not guesses.

    the fact model

    7 node kinds. 9 edge kinds. Every fact carries a location.

    The Provenance Knowledge Graph — the schema every answer is grounded in.

    NODE KINDS · 7

    • Module a file or package
    • Type class, struct, interface
    • Function callable unit
    • Field attribute or constant
    • Endpoint HTTP route / handler
    • Entity data-layer table
    • Doc ingested documentation

    EDGE KINDS · 9

    IMPORTSCONTAINSCALLSIMPLEMENTSREADSWRITESEXPOSESREFERENCESMENTIONS

    auth.validate — CALLS → models.get_user
    models.get_user — READS → password_hash
    docs/auth.md — MENTIONS → auth.validate

    it reads your docs too

    Your architecture doc is a .docx nobody has opened in a year.

    Spine reads it — and tells you which parts are now lying about the code.

    9 FORMATS → DOC NODES

    .md.markdown.rst.txt.html.htm.pdf.docx.xlsx

    Each doc becomes a Doc node, linked to the symbols it MENTIONS. No OCR. No images. Text only — and we say so.

    doc_drift · docs/architecture.docx
    "The SessionStore class persists tokens…"
    → SessionStore no longer exists (removed 3.6.0)
    "Auth is covered by the validate test suite…"
    → validate has 0 covering tests
    → 3 of 5 claims still true · 2 drifted

    We run this same doc_drift check against this website in CI. Dogfooding as marketing.

    governance

    The machine stops here. You decide.

    watch a run flow — it pauses at each gate until you approve
    Requirementsthe ask
    →
    Intentsplanned changes
    →
    🔒
    GATE 1human approval
    →
    Grounded codegen+ tests
    →
    Reviewdiff you read
    →
    🔒
    GATE 2human approval
    →
    PRpushed on approval

    The two gates are the only places the machine writes to the outside world — and both need you.

    The full governance story →
    determinism, proven

    Run it again. It's identical.

    Same commit in, byte-identical report out — a claim other tools can't make. No force-directed layouts, no LLM in the loop, no jitter to diff around.

    run #1
    $ orchestrator understand . --report ✓ 0 changes
    nodes 1,284 · edges 3,907
    languages 4 · docs 18
    uncovered symbols 37
    report sha256: 9f2c7a41e0b8d5c3f6a29d17be04c81a
    diff vs previous run — 0 changes
    get started

    MIT licensed. Comprehension is read-only and writes nothing.

    pip install synaptixs-spine

    Then: orchestrator understand .

    Extras: pip install 'synaptixs-spine[docs,office]' adds PDF + Word/Excel ingestion · [mcp] adds the assistant plugin server.