pi-vault-mind 0.13.0 → 0.14.0

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## 0.5.1 — 2026-06-28
+
+### Fixed
+
+- Bundled `json5` into the Obsidian plugin (`main.js`) so the plugin loads in Obsidian without requiring the dependency externally.
 
 ## 0.13.0 / 0.5.0 — 2026-06-28
 

package/dist/src/index.js

@@ -53,7 +53,11 @@ export default function (pi) {
             })()
             : {};
         const projectEmbed = projectCfg.vaultMind?.embedding;
-        const isSetup = !!(projectEmbed?.remoteUrl || projectEmbed?.localUrl);
+        const projectAgentLLM = projectCfg.vaultMind?.agentLLM;
+        const isSetup = !!(projectEmbed?.remoteUrl ||
+            projectEmbed?.localUrl ||
+            projectEmbed?.model ||
+            projectAgentLLM?.model);
         const sessionCfg = loadConfig(ctx.cwd);
         const piCtxCfg = sessionCfg.extensionCompatibility?.["pi-context"];
         if (isSetup && piCtxCfg?.enabled && piCtxCfg?.autoEnableAcm !== false) {

package/dist/src/server.js

@@ -224,6 +224,14 @@ export function startServer(pi, serverState, watcherState) {
                     }
                     withAuth(req, res, () => handleVmPending(res, serverState));
                     break;
+                case "/vm/stats":
+                    if (req.method !== "GET") {
+                        res.writeHead(405);
+                        res.end(JSON.stringify({ error: "Method not allowed" }));
+                        return;
+                    }
+                    withAuth(req, res, () => handleVmStatsRoute(res, serverState));
+                    break;
                 default:
                     if (url.pathname.startsWith("/agent/jobs/")) {
                         withAuth(req, res, () => handleAgentJob(req, res, url.pathname), {
@@ -1059,3 +1067,34 @@ function handleVmPending(res, serverState) {
     res.writeHead(200);
     res.end(JSON.stringify({ pending }));
 }
+function handleVmStatsRoute(res, serverState) {
+    const vaultPath = serverState.vaultPath || process.cwd();
+    const cfg = loadConfig(vaultPath);
+    const collections = [];
+    for (const [name, def] of Object.entries(cfg.collections)) {
+        let count = 0;
+        let malformed = 0;
+        let size = 0;
+        if (fs.existsSync(def.path)) {
+            try {
+                size = fs.statSync(def.path).size;
+                const lines = fs.readFileSync(def.path, "utf-8").split("\n").filter(Boolean);
+                for (const line of lines) {
+                    try {
+                        JSON.parse(line);
+                        count++;
+                    }
+                    catch {
+                        malformed++;
+                    }
+                }
+            }
+            catch {
+                // file unreadable — leave counts at 0
+            }
+        }
+        collections.push({ name, path: def.path, schema: def.schema, count, size, malformed });
+    }
+    res.writeHead(200);
+    res.end(JSON.stringify({ collections }));
+}

package/dist/src/tools/codegraph.d.ts

@@ -0,0 +1,15 @@
+import { type ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import { Type } from "typebox";
+/**
+ * Look up `symbol` in the `.codegraph/` index at `projectRoot` and return a
+ * concise, human-readable impact summary.
+ *
+ * Runs `codegraph impact` and `codegraph callers` in parallel, formats the
+ * results into a text block, and never throws — all errors surface as message
+ * strings suitable for direct tool output.
+ */
+export declare const getCodegraphImpact: (symbol: string, projectRoot: string) => Promise<string>;
+export declare const vmCodegraphImpactTool: import("@earendil-works/pi-coding-agent").ToolDefinition<Type.TObject<{
+    symbol: Type.TString;
+}>, {}, any> & import("@earendil-works/pi-coding-agent").ToolDefinition<any, any, any>;
+export declare const registerCodegraphTool: (pi: ExtensionAPI) => void;

package/dist/src/tools/codegraph.js

@@ -0,0 +1,118 @@
+import * as cp from "node:child_process";
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { promisify } from "node:util";
+import { defineTool, } from "@earendil-works/pi-coding-agent";
+import { Type } from "typebox";
+const execFile = promisify(cp.execFile);
+// ── Core helper ──────────────────────────────────────────────────────────────
+/**
+ * Look up `symbol` in the `.codegraph/` index at `projectRoot` and return a
+ * concise, human-readable impact summary.
+ *
+ * Runs `codegraph impact` and `codegraph callers` in parallel, formats the
+ * results into a text block, and never throws — all errors surface as message
+ * strings suitable for direct tool output.
+ */
+export const getCodegraphImpact = async (symbol, projectRoot) => {
+    if (!fs.existsSync(path.join(projectRoot, ".codegraph", "codegraph.db"))) {
+        return ("Codegraph index not found. A `.codegraph/` directory must exist at the " +
+            "project root. Run `codegraph init` then `codegraph index` to build it, " +
+            "and ensure the `codegraph` CLI is on PATH.");
+    }
+    const run = async (command) => {
+        try {
+            const { stdout } = await execFile("codegraph", [command, symbol, "--json"], {
+                cwd: projectRoot,
+                timeout: 15_000,
+            });
+            return stdout;
+        }
+        catch {
+            return null;
+        }
+    };
+    // Run both queries in parallel for speed.
+    const [impactRaw, callersRaw] = await Promise.all([run("impact"), run("callers")]);
+    let impactData = null;
+    let callersData = null;
+    if (impactRaw) {
+        try {
+            impactData = JSON.parse(impactRaw);
+        }
+        catch {
+            // Malformed JSON — treat as unavailable.
+        }
+    }
+    if (callersRaw) {
+        try {
+            callersData = JSON.parse(callersRaw);
+        }
+        catch {
+            // Malformed JSON — treat as unavailable.
+        }
+    }
+    if (!impactData && !callersData) {
+        return `Codegraph: no data returned for \`${symbol}\`. The symbol may not be in the index, or the \`codegraph\` CLI may be missing from PATH. Try running \`codegraph sync\` at the project root.`;
+    }
+    const lines = [`Codegraph impact for \`${symbol}\`:\n`];
+    // ── Direct callers ─────────────────────────────────────────────────────
+    if (callersData) {
+        const { callers } = callersData;
+        if (callers.length === 0) {
+            lines.push("Direct callers: none — this symbol may be an entry point or is not called directly.");
+        }
+        else {
+            lines.push(`Direct callers (${callers.length}):`);
+            for (const c of callers) {
+                lines.push(`  • ${c.name} [${c.kind}]  ${c.filePath}:${c.startLine}`);
+            }
+        }
+        lines.push("");
+    }
+    // ── Full impact set ────────────────────────────────────────────────────
+    if (impactData) {
+        // Exclude the queried symbol itself; report only downstream dependents.
+        const downstream = impactData.affected.filter((a) => a.name !== symbol);
+        if (downstream.length === 0) {
+            lines.push(`Full impact (depth ${impactData.depth}): no downstream dependents found.`);
+        }
+        else {
+            lines.push(`Full impact (depth ${impactData.depth}, ${impactData.nodeCount} nodes, ${impactData.edgeCount} edges):`);
+            for (const a of downstream) {
+                lines.push(`  • ${a.name} [${a.kind}]  ${a.filePath}:${a.startLine}`);
+            }
+        }
+    }
+    return lines.join("\n");
+};
+// ── Tool definition ──────────────────────────────────────────────────────────
+export const vmCodegraphImpactTool = defineTool({
+    name: "vm_codegraph_impact",
+    label: "Codegraph Impact",
+    description: "Report which code depends on a given symbol using the workspace codegraph index.",
+    promptSnippet: 'vm_codegraph_impact(symbol="registerTools")',
+    promptGuidelines: [
+        "Requires a `.codegraph/` index at the project root (`codegraph init && codegraph index`).",
+        "Returns direct callers and the full downstream impact set for the named symbol.",
+        "Useful for assessing blast radius before modifying an exported function, class, or type.",
+    ],
+    parameters: Type.Object({
+        symbol: Type.String({
+            description: "Symbol name to look up (function, class, variable, type, etc.)",
+        }),
+    }),
+    async execute(_id, params, _signal, _onUpdate, ctx) {
+        const summary = await getCodegraphImpact(params.symbol, ctx.cwd);
+        return {
+            content: [{ type: "text", text: summary }],
+            details: {},
+        };
+    },
+});
+// ── Registration ─────────────────────────────────────────────────────────────
+export const registerCodegraphTool = (pi) => {
+    const existing = new Set(pi.getAllTools().map((t) => t.name));
+    if (!existing.has("vm_codegraph_impact"))
+        pi.registerTool(vmCodegraphImpactTool);
+};

package/dist/src/tools.js

@@ -5,6 +5,7 @@ import { registerDiscoverSchemaTool } from "./discover-schema.js";
 import { graphUpsert, queryGraph } from "./graph.js";
 import { getStatus, queryCollection, searchFts, searchHybrid, upsertEntry, } from "./lance.js";
 import { registerTombstoneTool } from "./tombstone.js";
+import { registerCodegraphTool } from "./tools/codegraph.js";
 import { registerMarksmanTools } from "./tools/marksman.js";
 import { collectionNames, ensureDir, findConfig, loadConfig } from "./utils.js";
 import { registerVaultTools } from "./vault-tools.js";
@@ -807,4 +808,5 @@ export const registerTools = (pi) => {
     registerTombstoneTool(pi);
     registerVaultTools(pi);
     registerMarksmanTools(pi);
+    registerCodegraphTool(pi);
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-vault-mind",
-  "version": "0.13.0",
+  "version": "0.14.0",
   "description": "Passive Obsidian vault extension for pi. Watches @agent markers, dispatches forked subagents (Miner, Broadcaster, Heavy-Lifter), stores in LanceDB with vector + FTS + graph. Multi-agent 'Drop & Forget' workflow for the pi agent ecosystem.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",