codegraph

Overview ¶

Package codegraph is the CodeGrapher-snapshot ingestion adapter: it reads committed `codegraph/` snapshot recordsets (INGR encoding, inGitDB layout) and emits package entities and `derived` facts for `imports` edges at package granularity.

Feature: cli/studio/index (REQ: adapter-codegraph)

Emitted predicates:

• imports — one fact per distinct (importing package, imported package) pair found in the snapshot's `imports` edges

Snapshots usually store imports at file granularity (edge source `file:<path>`, target an `import:` node whose name is the import path); the adapter derives the package edge in the same single pass: the subject is the source file's directory as a repo-relative package (`#<dir>`, `#.` for the repo root) and the object is the imported path verbatim (a global package coordinate, matching the manifests adapter's object vocabulary). Where the snapshot already provides package-granularity nodes/edges (`package:` refs) they pass through as repo-relative packages (`#<name>`) with no extra parsing pass. Malformed or unreadable snapshot files become warnings and skip only that file (REQ: partial-tolerance); edges whose endpoints cannot be resolved to packages are counted into one warning per edges file.