@aroman22/codegraph-vba 1.17.2 → 2.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +8 -8
- package/dist/directory.d.ts +3 -1
- package/package.json +7 -7
package/README.md
CHANGED
|
@@ -128,7 +128,7 @@ cd your-project
|
|
|
128
128
|
codegraph-vba init
|
|
129
129
|
```
|
|
130
130
|
|
|
131
|
-
<sub>`codegraph-vba init` creates the local `.codegraph
|
|
131
|
+
<sub>`codegraph-vba init` creates the local `.codegraph/` directory and builds the full graph in the same step — one command, done.</sub>
|
|
132
132
|
|
|
133
133
|
<div align="center">
|
|
134
134
|
|
|
@@ -148,7 +148,7 @@ Changed your mind? One command removes CodeGraph from every agent it configured:
|
|
|
148
148
|
codegraph-vba uninstall
|
|
149
149
|
```
|
|
150
150
|
|
|
151
|
-
<sub>Reverses the installer — strips CodeGraph's MCP server config, instructions, and permissions from each configured agent. Your project indexes (`.codegraph
|
|
151
|
+
<sub>Reverses the installer — strips CodeGraph's MCP server config, instructions, and permissions from each configured agent. Your project indexes (`.codegraph/`) are left untouched; remove those per-project with `codegraph-vba uninit`. Use `--target` to remove from specific agents, or `--yes` to run non-interactively.</sub>
|
|
152
152
|
|
|
153
153
|
---
|
|
154
154
|
|
|
@@ -595,7 +595,7 @@ codegraph-vba init
|
|
|
595
595
|
|
|
596
596
|
Builds the per-project knowledge graph index, which then auto-syncs on every file change. A single global `codegraph-vba install` works in every project you open — no need to re-run the installer per project.
|
|
597
597
|
|
|
598
|
-
That's it — your agent will use CodeGraph tools automatically when a `.codegraph
|
|
598
|
+
That's it — your agent will use CodeGraph tools automatically when a `.codegraph/` directory exists.
|
|
599
599
|
|
|
600
600
|
<details>
|
|
601
601
|
<summary><strong>Manual Setup (Alternative)</strong></summary>
|
|
@@ -641,7 +641,7 @@ CodeGraph's MCP server delivers its usage guidance to your agent **automatically
|
|
|
641
641
|
- **Answer structural questions directly with CodeGraph** — it *is* the pre-built index, so a grep/read loop just repeats work it already did. Treat the returned source as already read.
|
|
642
642
|
- **Reach for `codegraph_explore` for almost anything** — "how does X work", a flow/"how does X reach Y", or surveying an area. One call returns the relevant symbols' verbatim source grouped by file, the call paths between them (dynamic-dispatch hops included), and a blast-radius summary. Name a file or symbol in the query to read its current line-numbered source.
|
|
643
643
|
- **Trust the results — don't re-verify with grep**, and check the staleness banner after edits.
|
|
644
|
-
- Works **per project**: query any project that has a `.codegraph
|
|
644
|
+
- Works **per project**: query any project that has a `.codegraph/` index by passing `projectPath` — so a monorepo where only some services are indexed, or a second repo, works in one session. A path with no index returns clean guidance to use built-in tools; indexing stays your decision.
|
|
645
645
|
|
|
646
646
|
The exact text is `src/mcp/server-instructions.ts` — the single source of truth for the main agent. Because subagents and non-MCP harnesses never see the MCP guidance, the installer also writes a short marker-fenced section into the agent's instructions file pointing at the `codegraph-vba explore` CLI equivalent.
|
|
647
647
|
|
|
@@ -674,7 +674,7 @@ The exact text is `src/mcp/server-instructions.ts` — the single source of trut
|
|
|
674
674
|
|
|
675
675
|
1. **Extraction** — [tree-sitter](https://tree-sitter.github.io/) parses source code into ASTs. Language-specific queries extract nodes (functions, classes, methods) and edges (calls, imports, extends, implements).
|
|
676
676
|
|
|
677
|
-
2. **Storage** — Everything goes into a local SQLite database (`.codegraph
|
|
677
|
+
2. **Storage** — Everything goes into a local SQLite database (`.codegraph/codegraph.db`) with FTS5 full-text search.
|
|
678
678
|
|
|
679
679
|
3. **Resolution** — After extraction, references are resolved: function calls → definitions, imports → source files, class inheritance, and framework-specific patterns.
|
|
680
680
|
|
|
@@ -750,7 +750,7 @@ When running as an MCP server, CodeGraph exposes a **single tool** — `codegrap
|
|
|
750
750
|
|
|
751
751
|
The other tools (`codegraph_node`, `codegraph_search`, `codegraph_callers`, `codegraph_callees`, `codegraph_impact`, `codegraph_files`, `codegraph_status`, and the Access-specific `codegraph_behavior_evidence`) stay fully functional but **unlisted by default** — everything they return already arrives inline on `codegraph_explore` (its blast-radius section, the relationship map, a symbol's body as its callee list). Re-enable any of them for the MCP surface with the `CODEGRAPH_MCP_TOOLS` environment variable (e.g. `CODEGRAPH_MCP_TOOLS=explore,node,search,callers`), or use their CLI equivalents (`codegraph-vba node` / `query` / `callers` / `callees` / `impact` / `files` / `status`).
|
|
752
752
|
|
|
753
|
-
Even when the server's own root has no `.codegraph
|
|
753
|
+
Even when the server's own root has no `.codegraph/` index, the tools stay available: pass `projectPath` to query any indexed project — a sub-service in a monorepo, or a second repo — in the same session. A path that has no index returns clean guidance to use built-in tools instead, so nothing fails loudly, and indexing stays your decision.
|
|
754
754
|
|
|
755
755
|
---
|
|
756
756
|
|
|
@@ -973,7 +973,7 @@ Framework routing is validated the same way, on a canonical app per framework: E
|
|
|
973
973
|
**MCP hits `database is locked`** — current builds shouldn't: CodeGraph bundles its own Node runtime and uses Node's built-in `node:sqlite` in WAL mode, where concurrent reads never block on a writer. If you still see it:
|
|
974
974
|
|
|
975
975
|
- **You're on an old (pre-0.9) install.** Reinstall to get the bundled runtime — `curl -fsSL https://raw.githubusercontent.com/ardelperal/codegraph-vba/main/install.sh | sh` (macOS/Linux), `irm https://raw.githubusercontent.com/ardelperal/codegraph-vba/main/install.ps1 | iex` (Windows), or `npm i -g @aroman22/codegraph-vba@latest`.
|
|
976
|
-
- **`codegraph-vba status` shows `Journal:` other than `wal`** — WAL couldn't be enabled on this filesystem (common on network shares and WSL2 `/mnt`), so reads can block on writes. Move the project (with its `.codegraph
|
|
976
|
+
- **`codegraph-vba status` shows `Journal:` other than `wal`** — WAL couldn't be enabled on this filesystem (common on network shares and WSL2 `/mnt`), so reads can block on writes. Move the project (with its `.codegraph/` folder) onto a local disk.
|
|
977
977
|
|
|
978
978
|
**MCP server not connecting** — Your agent starts the server itself, so you don't launch it by hand. Make sure the project is initialized and indexed (`codegraph-vba status`) and that the path in your MCP config is correct. If it still won't connect, re-run `codegraph-vba install` to rewrite the config.
|
|
979
979
|
|
|
@@ -981,7 +981,7 @@ Framework routing is validated the same way, on a canonical app per framework: E
|
|
|
981
981
|
|
|
982
982
|
**Missing symbols** — The MCP server auto-syncs on save (wait a couple seconds). Run `codegraph-vba sync` manually if needed. Check that the file's language is supported and isn't inside a `.gitignore`d or default-excluded directory (e.g. `node_modules`, `dist`).
|
|
983
983
|
|
|
984
|
-
**Sharing one checkout between Windows and WSL** — Don't point both at the same `.codegraph
|
|
984
|
+
**Sharing one checkout between Windows and WSL** — Don't point both at the same `.codegraph/`: the background-server lock and the SQLite index are tied to the OS that wrote them, and SQLite locking across the WSL2/Windows filesystem boundary is unreliable. Give each side its own index in the same tree by setting `CODEGRAPH_DIR` to a distinct name on one of them — e.g. `CODEGRAPH_DIR=.codegraph-win` on Windows, leaving WSL on the default `.codegraph`. CodeGraph skips any sibling `.codegraph-*` directory when indexing and watching, so the two never trip over each other.
|
|
985
985
|
|
|
986
986
|
## Star History
|
|
987
987
|
|
package/dist/directory.d.ts
CHANGED
|
@@ -36,7 +36,9 @@ export declare const CODEGRAPH_DIR: string;
|
|
|
36
36
|
* default `.codegraph`, the active `CODEGRAPH_DIR` override, and any
|
|
37
37
|
* `.codegraph-*` sibling. File-watching and the indexer skip ALL of these, so
|
|
38
38
|
* when two environments share one working tree (Windows + WSL, issue #636)
|
|
39
|
-
* neither indexes or watches the other's index directory.
|
|
39
|
+
* neither indexes or watches the other's index directory. The prefix match
|
|
40
|
+
* also covers the legacy `.codegraph-vba/` directory older releases of this
|
|
41
|
+
* fork wrote, so a stale one left in a consumer repo is never indexed.
|
|
40
42
|
*/
|
|
41
43
|
export declare function isCodeGraphDataDir(name: string): boolean;
|
|
42
44
|
/**
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@aroman22/codegraph-vba",
|
|
3
|
-
"version": "
|
|
3
|
+
"version": "2.0.0",
|
|
4
4
|
"description": "Local-first code intelligence for AI agents (MCP). Self-contained — bundles its own runtime.",
|
|
5
5
|
"bin": {
|
|
6
6
|
"codegraph-vba": "npm-shim.js"
|
|
@@ -15,12 +15,12 @@
|
|
|
15
15
|
"./package.json": "./package.json"
|
|
16
16
|
},
|
|
17
17
|
"optionalDependencies": {
|
|
18
|
-
"@aroman22/codegraph-vba-darwin-arm64": "
|
|
19
|
-
"@aroman22/codegraph-vba-darwin-x64": "
|
|
20
|
-
"@aroman22/codegraph-vba-linux-arm64": "
|
|
21
|
-
"@aroman22/codegraph-vba-linux-x64": "
|
|
22
|
-
"@aroman22/codegraph-vba-win32-arm64": "
|
|
23
|
-
"@aroman22/codegraph-vba-win32-x64": "
|
|
18
|
+
"@aroman22/codegraph-vba-darwin-arm64": "2.0.0",
|
|
19
|
+
"@aroman22/codegraph-vba-darwin-x64": "2.0.0",
|
|
20
|
+
"@aroman22/codegraph-vba-linux-arm64": "2.0.0",
|
|
21
|
+
"@aroman22/codegraph-vba-linux-x64": "2.0.0",
|
|
22
|
+
"@aroman22/codegraph-vba-win32-arm64": "2.0.0",
|
|
23
|
+
"@aroman22/codegraph-vba-win32-x64": "2.0.0"
|
|
24
24
|
},
|
|
25
25
|
"files": [
|
|
26
26
|
"npm-shim.js",
|