Spine
Turn any repository into a queryable Program Knowledge Graph — symbols, calls, imports, database schema, and documentation, as universal facts that carry provenance back to the line they came from.
Extraction is deterministic and model-free. The same commit in always yields the same facts out, so the output is diffable, cacheable, and safe to gate CI on.
pip install spine-pkg
spine extract .
Commands
spine extract [path] |
Scan a repo, print a summary. --query <symbol> shows callers and blast radius; --json dumps facts. |
spine verify [path] |
Check graph invariants — dangling edges, unresolvable provenance, unjoined imports. Exits non-zero on error, so it can stand guard in CI. |
spine export [path] |
Export the whole graph as sqlite, graphml, dot, or json. Writes spine-facts.<ext> unless you pass --out. Never truncated. |
spine docs [path] -d FILE |
Reconcile documentation claims against the code graph and report drift. |
spine languages |
Show which language front-ends are active in this install. |
spine media extract PATHS |
OCR images and transcribe audio/video into reviewable artifacts. Opt-in; see below. |
Languages
Python works out of the box with no extra dependencies. Every other front-end lazy-imports its parser, so the base install stays small and you pay only for what you use:
pip install 'spine-pkg[java]' # or typescript, csharp, c, cpp, go, sql
pip install 'spine-pkg[all]' # every front-end at once
If a language's extra isn't installed, its files are invisible to the graph rather
than an error — so spine extract counts them and tells you what to install:
Scanned . — 0 grounded nodes, 0 external, 0 edges.
! 103 Go file(s) found but NOT extracted — install the front-end: pip install 'spine-pkg[go]'
spine languages shows the same thing ahead of time. Both warnings go to stderr, so
extract --json and export stay pipe-safe.
Documents and media
Markdown, reStructuredText, plain text, and HTML parse with the standard library.
PDF needs [docs]; Word and Excel need [office].
spine media extract is deliberately separate from the graph build. It MAY run a
model and be slow, so it is explicit and opt-in: it creates a .spine-media directory
on first run, writes reviewable artifacts there for you to commit, and the
deterministic extractor only ever reads those. Image OCR ([media], plus a system
tesseract binary) and --asr local ([asr]) run entirely on your machine.
--asr api uploads audio and video off-machine and refuses to run without an
explicit --allow-remote.
Caching
Facts are cached per commit under ~/.cache/spine/, and the cache is trusted only on
a clean working tree — a dirty tree always re-extracts, because a stale graph is
worse than a slow one.
Design notes
- The graph is the source of truth. Consumers render facts; they never re-derive
them from paths or filenames. A new fact means extending
facts.pyand the front-ends, not the renderer. - Bounded output is honest output. Aggregations cap their results and record what was elided. Exports are the exception — they are always complete, because the point of handing the graph to another tool is that its filtering is better than ours.
- Local paths only.
spinescans a checkout on disk and never clones for you.
License
MIT
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file spine_pkg-0.1.0.tar.gz.
File metadata
- Download URL: spine_pkg-0.1.0.tar.gz
- Upload date:
- Size: 152.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
c412b14b84fe0bc5e3698d9cc9860fc53b0c9afe6227b3e5925dbb996e7887f2
|
|
| MD5 |
ffec786ea367b2279416575dc19741c0
|
|
| BLAKE2b-256 |
7630377105fef0a087c430064c7df02f58fcb077d0679b1ed02d3fa2b6a9f52b
|
Provenance
The following attestation bundles were made for spine_pkg-0.1.0.tar.gz:
Publisher:
release.yml on synaptixs/spine-pkg
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
spine_pkg-0.1.0.tar.gz -
Subject digest:
c412b14b84fe0bc5e3698d9cc9860fc53b0c9afe6227b3e5925dbb996e7887f2 - Sigstore transparency entry: 2335736613
- Sigstore integration time:
-
Permalink:
synaptixs/spine-pkg@40f7fa495bad23fcafb82df30f948c314882daef -
Branch / Tag:
refs/tags/v0.1.0 - Owner: https://github.com/synaptixs
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@40f7fa495bad23fcafb82df30f948c314882daef -
Trigger Event:
push
-
Statement type:
File details
Details for the file spine_pkg-0.1.0-py3-none-any.whl.
File metadata
- Download URL: spine_pkg-0.1.0-py3-none-any.whl
- Upload date:
- Size: 125.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
30536bfb9a6533a79207ae86236f5fb06c9c703de5ecc1726e342bc5060e6c43
|
|
| MD5 |
b3c429b68c789b15b3ef1fab6c7503f0
|
|
| BLAKE2b-256 |
27b9fd6eac2d2d9a6be4d726fd8c733e1b3296bdbbb9f53590d83eab46b6d426
|
Provenance
The following attestation bundles were made for spine_pkg-0.1.0-py3-none-any.whl:
Publisher:
release.yml on synaptixs/spine-pkg
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
spine_pkg-0.1.0-py3-none-any.whl -
Subject digest:
30536bfb9a6533a79207ae86236f5fb06c9c703de5ecc1726e342bc5060e6c43 - Sigstore transparency entry: 2335736687
- Sigstore integration time:
-
Permalink:
synaptixs/spine-pkg@40f7fa495bad23fcafb82df30f948c314882daef -
Branch / Tag:
refs/tags/v0.1.0 - Owner: https://github.com/synaptixs
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@40f7fa495bad23fcafb82df30f948c314882daef -
Trigger Event:
push
-
Statement type:
