Skip to content

docs: auto-sync architecture graph and MCP reference #509

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
zaebee merged 1 commit into from
Sep 25, 2026
Merged

docs: auto-sync architecture graph and MCP reference #509

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
59 changes: 38 additions & 21 deletions docs/architecture/HOW_IT_WORKS.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -188,37 +188,49 @@ classDef externalNode fill:#fff3e0,stroke:#e65100,stroke-width:1px,stroke-dashar
models_Node["Node (models.py:85)"]:::classNode
end
subgraph sg_pipeline["pipeline.py"]
pipeline_IngestionPipeline_cross_file_inputs_changed["_cross_file_inputs_changed (pipeline.py:249)"]:::methodNode
pipeline_IngestionPipeline_get_extractor["_get_extractor (pipeline.py:384)"]:::methodNode
pipeline_IngestionPipeline_is_noop_incremental["_is_noop_incremental (pipeline.py:310)"]:::methodNode
pipeline_IngestionPipeline_persist_incremental["_persist_incremental (pipeline.py:334)"]:::methodNode
pipeline_IngestionPipeline_process_file["_process_file (pipeline.py:212)"]:::methodNode
pipeline_IngestionPipeline_run["run (pipeline.py:99)"]:::methodNode
pipeline_IngestionPipeline_workspace_root["workspace_root (pipeline.py:82)"]:::methodNode
pipeline_IngestionPipeline_cross_file_inputs_changed["_cross_file_inputs_changed (pipeline.py:266)"]:::methodNode
pipeline_IngestionPipeline_get_extractor["_get_extractor (pipeline.py:401)"]:::methodNode
pipeline_IngestionPipeline_is_noop_incremental["_is_noop_incremental (pipeline.py:327)"]:::methodNode
pipeline_IngestionPipeline_persist_incremental["_persist_incremental (pipeline.py:351)"]:::methodNode
pipeline_IngestionPipeline_process_file["_process_file (pipeline.py:229)"]:::methodNode
pipeline_IngestionPipeline_run["run (pipeline.py:100)"]:::methodNode
pipeline_IngestionPipeline_workspace_root["workspace_root (pipeline.py:83)"]:::methodNode
end
subgraph sg_engine["engine.py"]
engine_ResolverEngine["ResolverEngine (engine.py:47)"]:::classNode
engine_ResolverEngine_resolve["resolve (engine.py:64)"]:::methodNode
engine_ResolverEngine["ResolverEngine (engine.py:49)"]:::classNode
engine_ResolverEngine_resolve["resolve (engine.py:77)"]:::methodNode
end
subgraph sg_uplift["uplift.py"]
uplift_SemanticUpliftEngine["SemanticUpliftEngine (uplift.py:66)"]:::classNode
uplift_SemanticUpliftEngine_execute_uplift["execute_uplift (uplift.py:91)"]:::methodNode
end
subgraph sg_sqlite_store["sqlite_store.py"]
sqlite_store_SQLiteStore["SQLiteStore (sqlite_store.py:53)"]:::classNode
sqlite_store_SQLiteStore["SQLiteStore (sqlite_store.py:56)"]:::classNode
sqlite_store_SQLiteStore_get_workspace_packages["get_workspace_packages (sqlite_store.py:1085)"]:::methodNode
sqlite_store_SQLiteStore_record_workspace_packages["record_workspace_packages (sqlite_store.py:1071)"]:::methodNode
end
subgraph sg_workspaces["workspaces.py"]
workspaces_WorkspacePackages["WorkspacePackages (workspaces.py:23)"]:::classNode
workspaces_WorkspacePackages_note["note (workspaces.py:39)"]:::methodNode
workspaces_WorkspacePackages_unambiguous["unambiguous (workspaces.py:67)"]:::methodNode
end
pipeline_IngestionPipeline_run -->|REFERENCES| models_Node
pipeline_IngestionPipeline_run -->|REFERENCES| models_Edge
pipeline_IngestionPipeline_run -->|REFERENCES| sqlite_store_SQLiteStore
pipeline_IngestionPipeline_run -->|CALLS| pipeline_IngestionPipeline_workspace_root
pipeline_IngestionPipeline_run -->|CALLS| workspaces_WorkspacePackages
pipeline_IngestionPipeline_run -->|CALLS| workspaces_WorkspacePackages_note
pipeline_IngestionPipeline_run -->|CALLS| pipeline_IngestionPipeline_get_extractor
pipeline_IngestionPipeline_run -->|CALLS| pipeline_IngestionPipeline_process_file
pipeline_IngestionPipeline_run -->|CALLS| workspaces_WorkspacePackages_unambiguous
pipeline_IngestionPipeline_run -->|CALLS| sqlite_store_SQLiteStore_get_workspace_packages
pipeline_IngestionPipeline_run -->|CALLS| pipeline_IngestionPipeline_is_noop_incremental
pipeline_IngestionPipeline_run -->|CALLS| engine_ResolverEngine
pipeline_IngestionPipeline_run -->|CALLS| engine_ResolverEngine_resolve
pipeline_IngestionPipeline_run -->|CALLS| pipeline_IngestionPipeline_cross_file_inputs_changed
pipeline_IngestionPipeline_run -->|CALLS| pipeline_IngestionPipeline_run
pipeline_IngestionPipeline_run -->|CALLS| pipeline_IngestionPipeline_cross_file_inputs_changed
pipeline_IngestionPipeline_run -->|CALLS| pipeline_IngestionPipeline_persist_incremental
pipeline_IngestionPipeline_run -->|CALLS| sqlite_store_SQLiteStore_record_workspace_packages
pipeline_IngestionPipeline_run -->|CALLS| uplift_SemanticUpliftEngine_execute_uplift
pipeline_IngestionPipeline_run -->|CALLS| uplift_SemanticUpliftEngine
```
Expand All @@ -227,16 +239,21 @@ classDef externalNode fill:#fff3e0,stroke:#e65100,stroke-width:1px,stroke-dashar
|--------|------|------|
| `Node` | CLASS | [`models.py:85`](https://github.com/zaebee/codegraph-brain/blob/main/src/cgis/core/models.py#L85) |
| `Edge` | CLASS | [`models.py:142`](https://github.com/zaebee/codegraph-brain/blob/main/src/cgis/core/models.py#L142) |
| `workspace_root` | METHOD | [`pipeline.py:82`](https://github.com/zaebee/codegraph-brain/blob/main/src/cgis/pipeline.py#L82) |
| `run` | METHOD | [`pipeline.py:99`](https://github.com/zaebee/codegraph-brain/blob/main/src/cgis/pipeline.py#L99) |
| `_process_file` | METHOD | [`pipeline.py:212`](https://github.com/zaebee/codegraph-brain/blob/main/src/cgis/pipeline.py#L212) |
| `_cross_file_inputs_changed` | METHOD | [`pipeline.py:249`](https://github.com/zaebee/codegraph-brain/blob/main/src/cgis/pipeline.py#L249) |
| `_is_noop_incremental` | METHOD | [`pipeline.py:310`](https://github.com/zaebee/codegraph-brain/blob/main/src/cgis/pipeline.py#L310) |
| `_persist_incremental` | METHOD | [`pipeline.py:334`](https://github.com/zaebee/codegraph-brain/blob/main/src/cgis/pipeline.py#L334) |
| `_get_extractor` | METHOD | [`pipeline.py:384`](https://github.com/zaebee/codegraph-brain/blob/main/src/cgis/pipeline.py#L384) |
| `ResolverEngine` | CLASS | [`engine.py:47`](https://github.com/zaebee/codegraph-brain/blob/main/src/cgis/resolver/engine.py#L47) |
| `resolve` | METHOD | [`engine.py:64`](https://github.com/zaebee/codegraph-brain/blob/main/src/cgis/resolver/engine.py#L64) |
| `workspace_root` | METHOD | [`pipeline.py:83`](https://github.com/zaebee/codegraph-brain/blob/main/src/cgis/pipeline.py#L83) |
| `run` | METHOD | [`pipeline.py:100`](https://github.com/zaebee/codegraph-brain/blob/main/src/cgis/pipeline.py#L100) |
| `_process_file` | METHOD | [`pipeline.py:229`](https://github.com/zaebee/codegraph-brain/blob/main/src/cgis/pipeline.py#L229) |
| `_cross_file_inputs_changed` | METHOD | [`pipeline.py:266`](https://github.com/zaebee/codegraph-brain/blob/main/src/cgis/pipeline.py#L266) |
| `_is_noop_incremental` | METHOD | [`pipeline.py:327`](https://github.com/zaebee/codegraph-brain/blob/main/src/cgis/pipeline.py#L327) |
| `_persist_incremental` | METHOD | [`pipeline.py:351`](https://github.com/zaebee/codegraph-brain/blob/main/src/cgis/pipeline.py#L351) |
| `_get_extractor` | METHOD | [`pipeline.py:401`](https://github.com/zaebee/codegraph-brain/blob/main/src/cgis/pipeline.py#L401) |
| `ResolverEngine` | CLASS | [`engine.py:49`](https://github.com/zaebee/codegraph-brain/blob/main/src/cgis/resolver/engine.py#L49) |
| `resolve` | METHOD | [`engine.py:77`](https://github.com/zaebee/codegraph-brain/blob/main/src/cgis/resolver/engine.py#L77) |
| `SemanticUpliftEngine` | CLASS | [`uplift.py:66`](https://github.com/zaebee/codegraph-brain/blob/main/src/cgis/resolver/uplift.py#L66) |
| `execute_uplift` | METHOD | [`uplift.py:91`](https://github.com/zaebee/codegraph-brain/blob/main/src/cgis/resolver/uplift.py#L91) |
| `SQLiteStore` | CLASS | [`sqlite_store.py:53`](https://github.com/zaebee/codegraph-brain/blob/main/src/cgis/storage/sqlite_store.py#L53) |
| `SQLiteStore` | CLASS | [`sqlite_store.py:56`](https://github.com/zaebee/codegraph-brain/blob/main/src/cgis/storage/sqlite_store.py#L56) |
| `record_workspace_packages` | METHOD | [`sqlite_store.py:1071`](https://github.com/zaebee/codegraph-brain/blob/main/src/cgis/storage/sqlite_store.py#L1071) |
| `get_workspace_packages` | METHOD | [`sqlite_store.py:1085`](https://github.com/zaebee/codegraph-brain/blob/main/src/cgis/storage/sqlite_store.py#L1085) |
| `WorkspacePackages` | CLASS | [`workspaces.py:23`](https://github.com/zaebee/codegraph-brain/blob/main/src/cgis/workspaces.py#L23) |
| `note` | METHOD | [`workspaces.py:39`](https://github.com/zaebee/codegraph-brain/blob/main/src/cgis/workspaces.py#L39) |
| `unambiguous` | METHOD | [`workspaces.py:67`](https://github.com/zaebee/codegraph-brain/blob/main/src/cgis/workspaces.py#L67) |
<!-- END_CGIS_GRAPH -->
34 changes: 23 additions & 11 deletions docs/architecture/diagrams/pipeline_flow.mermaid
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -12,36 +12,48 @@ classDef externalNode fill:#fff3e0,stroke:#e65100,stroke-width:1px,stroke-dashar
models_Node["Node (models.py:85)"]:::classNode
end
subgraph sg_pipeline["pipeline.py"]
pipeline_IngestionPipeline_cross_file_inputs_changed["_cross_file_inputs_changed (pipeline.py:249)"]:::methodNode
pipeline_IngestionPipeline_get_extractor["_get_extractor (pipeline.py:384)"]:::methodNode
pipeline_IngestionPipeline_is_noop_incremental["_is_noop_incremental (pipeline.py:310)"]:::methodNode
pipeline_IngestionPipeline_persist_incremental["_persist_incremental (pipeline.py:334)"]:::methodNode
pipeline_IngestionPipeline_process_file["_process_file (pipeline.py:212)"]:::methodNode
pipeline_IngestionPipeline_run["run (pipeline.py:99)"]:::methodNode
pipeline_IngestionPipeline_workspace_root["workspace_root (pipeline.py:82)"]:::methodNode
pipeline_IngestionPipeline_cross_file_inputs_changed["_cross_file_inputs_changed (pipeline.py:266)"]:::methodNode
pipeline_IngestionPipeline_get_extractor["_get_extractor (pipeline.py:401)"]:::methodNode
pipeline_IngestionPipeline_is_noop_incremental["_is_noop_incremental (pipeline.py:327)"]:::methodNode
pipeline_IngestionPipeline_persist_incremental["_persist_incremental (pipeline.py:351)"]:::methodNode
pipeline_IngestionPipeline_process_file["_process_file (pipeline.py:229)"]:::methodNode
pipeline_IngestionPipeline_run["run (pipeline.py:100)"]:::methodNode
pipeline_IngestionPipeline_workspace_root["workspace_root (pipeline.py:83)"]:::methodNode
end
subgraph sg_engine["engine.py"]
engine_ResolverEngine["ResolverEngine (engine.py:47)"]:::classNode
engine_ResolverEngine_resolve["resolve (engine.py:64)"]:::methodNode
engine_ResolverEngine["ResolverEngine (engine.py:49)"]:::classNode
engine_ResolverEngine_resolve["resolve (engine.py:77)"]:::methodNode
end
subgraph sg_uplift["uplift.py"]
uplift_SemanticUpliftEngine["SemanticUpliftEngine (uplift.py:66)"]:::classNode
uplift_SemanticUpliftEngine_execute_uplift["execute_uplift (uplift.py:91)"]:::methodNode
end
subgraph sg_sqlite_store["sqlite_store.py"]
sqlite_store_SQLiteStore["SQLiteStore (sqlite_store.py:53)"]:::classNode
sqlite_store_SQLiteStore["SQLiteStore (sqlite_store.py:56)"]:::classNode
sqlite_store_SQLiteStore_get_workspace_packages["get_workspace_packages (sqlite_store.py:1085)"]:::methodNode
sqlite_store_SQLiteStore_record_workspace_packages["record_workspace_packages (sqlite_store.py:1071)"]:::methodNode
end
subgraph sg_workspaces["workspaces.py"]
workspaces_WorkspacePackages["WorkspacePackages (workspaces.py:23)"]:::classNode
workspaces_WorkspacePackages_note["note (workspaces.py:39)"]:::methodNode
workspaces_WorkspacePackages_unambiguous["unambiguous (workspaces.py:67)"]:::methodNode
end
pipeline_IngestionPipeline_run -->|REFERENCES| models_Node
pipeline_IngestionPipeline_run -->|REFERENCES| models_Edge
pipeline_IngestionPipeline_run -->|REFERENCES| sqlite_store_SQLiteStore
pipeline_IngestionPipeline_run -->|CALLS| pipeline_IngestionPipeline_workspace_root
pipeline_IngestionPipeline_run -->|CALLS| workspaces_WorkspacePackages
pipeline_IngestionPipeline_run -->|CALLS| workspaces_WorkspacePackages_note
pipeline_IngestionPipeline_run -->|CALLS| pipeline_IngestionPipeline_get_extractor
pipeline_IngestionPipeline_run -->|CALLS| pipeline_IngestionPipeline_process_file
pipeline_IngestionPipeline_run -->|CALLS| workspaces_WorkspacePackages_unambiguous
pipeline_IngestionPipeline_run -->|CALLS| sqlite_store_SQLiteStore_get_workspace_packages
pipeline_IngestionPipeline_run -->|CALLS| pipeline_IngestionPipeline_is_noop_incremental
pipeline_IngestionPipeline_run -->|CALLS| engine_ResolverEngine
pipeline_IngestionPipeline_run -->|CALLS| engine_ResolverEngine_resolve
pipeline_IngestionPipeline_run -->|CALLS| pipeline_IngestionPipeline_cross_file_inputs_changed
pipeline_IngestionPipeline_run -->|CALLS| pipeline_IngestionPipeline_run
pipeline_IngestionPipeline_run -->|CALLS| pipeline_IngestionPipeline_cross_file_inputs_changed
pipeline_IngestionPipeline_run -->|CALLS| pipeline_IngestionPipeline_persist_incremental
pipeline_IngestionPipeline_run -->|CALLS| sqlite_store_SQLiteStore_record_workspace_packages
pipeline_IngestionPipeline_run -->|CALLS| uplift_SemanticUpliftEngine_execute_uplift
pipeline_IngestionPipeline_run -->|CALLS| uplift_SemanticUpliftEngine