name:
graphify
description:
Build and query local code/document knowledge graphs for architecture discovery, dependency tracing, impact analysis, documentation, and evidence-backed codebase understanding. IMPERIAL governed adapter for Graphify-Labs/graphify.
triggers:
knowledge-graph
codebase-map
architecture
dependency-analysis
impact-analysis
graph-rag
code-search
documentation-map

Graphify — IMPERIAL governed knowledge-graph capability

Upstream: Graphify-Labs/graphify Pinned commit reviewed: 522ea9662ead3a960f9a67d9d0f499e9b96580cf Upstream package/version observed: graphifyy 0.9.59 (CLI command remains graphify) License: Apache-2.0; repository also carries MIT-licensed material/notice files. Native runtime: Python >=3.10.

What upstream provides

Graphify turns code, docs and selected project artifacts into a queryable knowledge graph. Code parsing is local/deterministic through tree-sitter; graph edges distinguish extracted relationships from inferred ones. It supports graph queries, paths, explanations, community discovery and architecture/call-flow outputs.

IMPERIAL installation mode

Installed on the IMPERIAL three-node runtime mesh as a governed capability profile. The Val Town Deno runtimes are not falsely treated as native Python hosts. Native Graphify CLI execution becomes RUNTIME_VERIFIED only on a compatible Python 3.10+ host after locked installation and tests.

Native baseline on a compatible host:

uv tool install graphifyy # IMPORTANT: official package is graphifyy (double-y) graphify install --project --platform codex graphify --version

Do not install a similarly named graphify PyPI package as a substitute.

Allowed use

  • map IMPERIAL source trees, docs, schemas and configs;
  • trace imports/calls/dependencies and architecture paths;
  • identify high-connectivity components and cross-subsystem dependencies;
  • support code review, migration planning, incident analysis and documentation;
  • operate locally/keylessly for code parsing whenever possible;
  • preserve extracted-vs-inferred provenance in conclusions.

Security / privacy

  • Never upload PRIVATE/SECRET/RESTRICTED project material to an external semantic backend without explicit policy approval.
  • Code-only local AST extraction is preferred under FREE_ONLY.
  • Optional semantic processing of docs/media may only use an approved free route and permitted data classification.
  • Treat graph inference as analysis, not authority or execution permission.
  • Guardian Core, Approval Gateway, Audit Ledger, Zero Trust, AI Passport and Public/Private Boundary remain authoritative.

FREE_ONLY

No paid Graphify platform, paid model API or paid storage is required for the baseline local code graph. Paid/credentialed semantic backends remain disabled unless separately approved; current spend limit is 0 USD.

Truth boundaries

  • SKILL_BOUND != NATIVE_PYTHON_RUNTIME_LIVE
  • GRAPH_EDGE_INFERRED != SOURCE_FACT
  • KNOWLEDGE_GRAPH != EXECUTION_AUTHORITY
  • LOCAL_CODE_PARSE != PERMISSION_TO_EXPORT_PRIVATE_DATA
  • CAPABILITY != APPROVAL

Authorship of this IMPERIAL adapter: Alexander Romaskevich / RomaskevicH. Upstream authorship and licenses remain with Graphify-Labs and upstream contributors.