Skip to content

data-model.md

Latest commit

 

History

History
57 lines (41 loc) · 2.02 KB

data-model.md

File metadata and controls

57 lines (41 loc) · 2.02 KB
Raw

Data model reference

All persistent state lives in two places: a Neo4j graph (structure and metadata) and an object store (file bytes, addressed by SHA-1).

Graph nodes

Label Module Key properties Purpose
Branch neogit.model.neo name Named pointer to a commit
Commit neogit.model.neo hash, sha1sum, name, date, description A snapshot
Tree neogit.model.merkle hash, sha1sum A directory in the Merkle tree
Blob neogit.model.merkle hash, sha1sum A file content reference
PluginRun neogit.model.neo (varies) Attaches downstream analysis state to a commit

hash is the Merkle hash of the node; sha1sum is the SHA-1 of the content (for Blob) or of the canonical serialization (for Tree / Commit).

Relationships

Branch --[TRACKS_COMMIT]--> Commit
Commit --[HAS_PREVIOUS]--> Commit          (commit history)
Commit --[OWNS_FILESYSTEM]--> Tree         (the root directory)
Tree   --[HAS_CHILD_TREE {name}]--> Tree   (subdirectories)
Tree   --[HAS_CHILD_BLOB {name}]--> Blob   (files)

Edge properties (name) carry the path component, so the same Tree or Blob can appear under different names in different parents — that's the whole point of content addressing.

Object storage layout

The object store contains one entry per unique Blob SHA-1. Keys are the hex SHA-1; values are the raw file bytes. Identical files across commits, branches, or snapshots deduplicate automatically.

Example Cypher queries

Latest commit on master:

MATCH (b:Branch {name: "master"})-[:TRACKS_COMMIT]->(c:Commit)
RETURN c

Full file tree of a commit:

MATCH (c:Commit {name: "snap-1"})-[:OWNS_FILESYSTEM]->(root:Tree)
MATCH path = (root)-[:HAS_CHILD_TREE|HAS_CHILD_BLOB*]->(n)
RETURN path

History walk:

MATCH (b:Branch {name: "master"})-[:TRACKS_COMMIT]->(head:Commit)
MATCH path = (head)-[:HAS_PREVIOUS*]->(ancestor)
RETURN ancestor.name, ancestor.date
ORDER BY ancestor.date DESC