@vibgrate/cli 2026.727.2 → 2026.727.4

package/DOCS.md

@@ -31,6 +31,7 @@ For a quick overview, see the [README](./README.md). This document covers everyt
 - [Code Graph Commands](#code-graph-commands)
   - [vg ask](#vg-ask)
   - [vg build](#vg-build)
+  - [vg watch](#vg-watch)
   - [vg bundle](#vg-bundle)
   - [vg code](#vg-code)
   - [vg embed](#vg-embed)
@@ -677,6 +678,25 @@ Maps source code into a graph artifact, enabling all downstream queries (`vg sho
 
 ---
 
+
+### vg watch
+
+Rebuild the code map when source files change (debounced). Useful for long agent sessions.
+
+```bash
+vg watch
+vg watch src/ --fast
+```
+
+| Flag | Default | Description |
+|------|---------|-------------|
+| `[paths...]` | `.` | Folders to watch |
+| `--debounce <ms>` | `400` | Settle time after a change before rebuild |
+| `--fast` | — | Skip precise TypeScript resolve on rebuilds |
+| `--no-html` | — | Do not rewrite `graph.html` |
+| `--no-report` | — | Do not rewrite `GRAPH_REPORT.md` |
+
+
 ### vg bundle
 
 Build an air-gapped bundle — grammars, the code graph, and the library catalog — for use on a machine with no network.
@@ -866,7 +886,7 @@ Deterministic open facts for a node (contract, invariant, characterization).
 vg facts <name>
 ```
 
-Epistemic-typed: declared/static → observed/derived. Requires `--deep` for derived facts beyond basic declarations.
+Epistemic-typed: declared/static → observed/derived. Open facts (contract / invariant / characterization) ship on every build.
 
 | Flag | Description |
 |------|-------------|

package/README.md

@@ -103,7 +103,7 @@ Browse all 21+ supported assistants and their skill descriptions at **[vibgrate.
 - **get_graph_summary** — code map overview: counts, languages, top areas and hubs.
 - **list_areas** — code areas (communities) by size.
 - **list_hubs** — most-depended-on symbols.
-- **get_facts** — deterministic facts for a node (contract/invariant; needs a `--deep` build).
+- **get_facts** — deterministic facts for a node (contract / invariant / characterization).
 - **guide_node** — cited standards and practices for a node (OWASP/CWE).
 - **check_drift** — offline dependency inventory with optional git who-added attribution.
 - **vuln_attribution** — who introduced each open vulnerability, exposure windows, CRA remediation metrics.
@@ -316,6 +316,7 @@ Under each set, commands are listed A–Z. A short **typical path** (usual order
 | `vg models` | Code Modes (Spark / Flow / Forge) + local fleet (Ollama / LM Studio / gguf); `install` / `pull` by default (`--dry-run` to preview) |
 | `vg path <from> <to>` | How A connects to B (shortest path) |
 | `vg savings` | Local report of tokens/$ saved vs a grep baseline (estimates) |
+| `vg watch` | Rebuild the map when files change |
 | `vg serve` | Start **Vibgrate AI Context** (local-first MCP: code map + drift + version-correct docs) |
 | `vg share` | Make the graph committable + auto-updating for your team |
 | `vg show <file>` | Explain a node: what it is, what it calls, what calls it |

package/dist/baseline-ENCOSJYQ.js

@@ -0,0 +1,8 @@
+export { baselineCommand, runBaseline } from './chunk-HYRAILGM.js';
+import './chunk-T3AYRS7J.js';
+import './chunk-CRAMOEBE.js';
+import './chunk-RXP66R2E.js';
+import './chunk-GI6W53LM.js';
+import './chunk-DGUM43GV.js';
+//# sourceMappingURL=baseline-ENCOSJYQ.js.map
+//# sourceMappingURL=baseline-ENCOSJYQ.js.map

package/dist/{baseline-TG4ATZGZ.js.map → baseline-ENCOSJYQ.js.map}

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"baseline-TG4ATZGZ.js"}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"baseline-ENCOSJYQ.js"}

package/dist/chunk-3SDV6ADQ.js

@@ -0,0 +1,78 @@
+import { listCachedWeights } from './chunk-GYSOQH5C.js';
+import * as fs from 'fs';
+import * as os from 'os';
+import * as path from 'path';
+
+function discoverModels(home = os.homedir()) {
+  return [...ollama(home), ...lmStudio(home), ...looseGguf(home), ...vibgrateWeightStore()].sort(
+    (a, b) => a.runtime.localeCompare(b.runtime) || a.name.localeCompare(b.name)
+  );
+}
+function vibgrateWeightStore() {
+  return listCachedWeights().map((w) => ({ runtime: "gguf", name: w.name, path: w.path }));
+}
+function ollama(home) {
+  const base = path.join(home, ".ollama", "models", "manifests");
+  const out = [];
+  walk(base, 4, (file) => {
+    const rel = path.relative(base, file).split(path.sep);
+    if (rel.length >= 2) {
+      const tag = rel[rel.length - 1];
+      const model = rel[rel.length - 2];
+      out.push({ runtime: "ollama", name: `${model}:${tag}`, path: file });
+    }
+  });
+  return dedupe(out);
+}
+function lmStudio(home) {
+  const bases = [path.join(home, ".lmstudio", "models"), path.join(home, ".cache", "lm-studio", "models")];
+  const out = [];
+  for (const base of bases) {
+    walk(base, 5, (file) => {
+      if (!file.endsWith(".gguf")) return;
+      const rel = path.relative(base, file).replace(/\\/g, "/");
+      out.push({ runtime: "lm-studio", name: rel, path: file });
+    });
+  }
+  return dedupe(out);
+}
+function looseGguf(home) {
+  const bases = [path.join(home, "models"), path.join(home, ".cache", "huggingface")];
+  const out = [];
+  for (const base of bases) {
+    walk(base, 4, (file) => {
+      if (!file.endsWith(".gguf")) return;
+      out.push({ runtime: "gguf", name: path.basename(file), path: file });
+    });
+  }
+  return dedupe(out);
+}
+function walk(dir, depth, onFile) {
+  if (depth < 0) return;
+  let entries;
+  try {
+    entries = fs.readdirSync(dir, { withFileTypes: true });
+  } catch {
+    return;
+  }
+  for (const e of entries.sort((a, b) => a.name.localeCompare(b.name))) {
+    const abs = path.join(dir, e.name);
+    if (e.isDirectory()) walk(abs, depth - 1, onFile);
+    else if (e.isFile()) onFile(abs);
+  }
+}
+function dedupe(models) {
+  const seen = /* @__PURE__ */ new Set();
+  const out = [];
+  for (const m of models) {
+    const key = `${m.runtime}:${m.name}`;
+    if (seen.has(key)) continue;
+    seen.add(key);
+    out.push(m);
+  }
+  return out;
+}
+
+export { discoverModels };
+//# sourceMappingURL=chunk-3SDV6ADQ.js.map
+//# sourceMappingURL=chunk-3SDV6ADQ.js.map

package/dist/chunk-3SDV6ADQ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/engine/models.ts"],"names":[],"mappings":"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","file":"chunk-3SDV6ADQ.js","sourcesContent":["import * as fs from 'node:fs';\nimport * as os from 'node:os';\nimport * as path from 'node:path';\nimport { listCachedWeights } from '../runtime/weight-store.js';\n\n/**\n * Local-model discovery (VG-LOCAL-MODELS §9.2) — be a no-key *consumer* of the\n * developer's local model fleet. Fully offline and deterministic: inspect the\n * on-disk layouts of Ollama / LM Studio / llama.cpp / the Vibgrate weight store,\n * never the network. No runtime is built or launched.\n */\n\nexport interface LocalModel {\n  runtime: 'ollama' | 'lm-studio' | 'gguf';\n  name: string;\n  path: string;\n}\n\nexport function discoverModels(home = os.homedir()): LocalModel[] {\n  return [...ollama(home), ...lmStudio(home), ...looseGguf(home), ...vibgrateWeightStore()].sort(\n    (a, b) => a.runtime.localeCompare(b.runtime) || a.name.localeCompare(b.name),\n  );\n}\n\n/** First-party GGUF cache (runtime/weight-store.ts). */\nfunction vibgrateWeightStore(): LocalModel[] {\n  return listCachedWeights().map((w) => ({ runtime: 'gguf' as const, name: w.name, path: w.path }));\n}\n\nfunction ollama(home: string): LocalModel[] {\n  const base = path.join(home, '.ollama', 'models', 'manifests');\n  const out: LocalModel[] = [];\n  walk(base, 4, (file) => {\n    // .../library/<model>/<tag>\n    const rel = path.relative(base, file).split(path.sep);\n    if (rel.length >= 2) {\n      const tag = rel[rel.length - 1];\n      const model = rel[rel.length - 2];\n      out.push({ runtime: 'ollama', name: `${model}:${tag}`, path: file });\n    }\n  });\n  return dedupe(out);\n}\n\nfunction lmStudio(home: string): LocalModel[] {\n  const bases = [path.join(home, '.lmstudio', 'models'), path.join(home, '.cache', 'lm-studio', 'models')];\n  const out: LocalModel[] = [];\n  for (const base of bases) {\n    walk(base, 5, (file) => {\n      if (!file.endsWith('.gguf')) return;\n      const rel = path.relative(base, file).replace(/\\\\/g, '/');\n      out.push({ runtime: 'lm-studio', name: rel, path: file });\n    });\n  }\n  return dedupe(out);\n}\n\nfunction looseGguf(home: string): LocalModel[] {\n  const bases = [path.join(home, 'models'), path.join(home, '.cache', 'huggingface')];\n  const out: LocalModel[] = [];\n  for (const base of bases) {\n    walk(base, 4, (file) => {\n      if (!file.endsWith('.gguf')) return;\n      out.push({ runtime: 'gguf', name: path.basename(file), path: file });\n    });\n  }\n  return dedupe(out);\n}\n\nfunction walk(dir: string, depth: number, onFile: (file: string) => void): void {\n  if (depth < 0) return;\n  let entries: fs.Dirent[];\n  try {\n    entries = fs.readdirSync(dir, { withFileTypes: true });\n  } catch {\n    return;\n  }\n  for (const e of entries.sort((a, b) => a.name.localeCompare(b.name))) {\n    const abs = path.join(dir, e.name);\n    if (e.isDirectory()) walk(abs, depth - 1, onFile);\n    else if (e.isFile()) onFile(abs);\n  }\n}\n\nfunction dedupe(models: LocalModel[]): LocalModel[] {\n  const seen = new Set<string>();\n  const out: LocalModel[] = [];\n  for (const m of models) {\n    const key = `${m.runtime}:${m.name}`;\n    if (seen.has(key)) continue;\n    seen.add(key);\n    out.push(m);\n  }\n  return out;\n}\n"]}

package/dist/{chunk-LKVMI67M.js → chunk-6AXHLQBV.js}

@@ -1,4 +1,4 @@
-import { stableStringify } from './chunk-K3MZIVZW.js';
+import { stableStringify } from './chunk-ZKNB4YH4.js';
 import { shortId, canonicalize, hashString } from './chunk-JFGYT6BI.js';
 import * as fs4 from 'fs';
 import * as path4 from 'path';
@@ -1241,20 +1241,95 @@ function npmPackageDir(root, name) {
   }
   return void 0;
 }
-function localPackageDocs(root, name) {
+var README_CANDIDATES = ["llms.txt", "README.md", "README.mdx", "README", "readme.md"];
+function packageDocsMarkdown(dir, query) {
+  const docsDir = path4.join(dir, "docs");
+  if (!fs4.existsSync(docsDir) || !fs4.statSync(docsDir).isDirectory()) return void 0;
+  const files = [];
+  const walk = (d, depth) => {
+    if (depth > 3 || files.length >= 40) return;
+    let entries;
+    try {
+      entries = fs4.readdirSync(d, { withFileTypes: true });
+    } catch {
+      return;
+    }
+    entries.sort((a, b) => a.name.localeCompare(b.name));
+    for (const e of entries) {
+      if (files.length >= 40) return;
+      const full = path4.join(d, e.name);
+      if (e.isDirectory()) {
+        if (e.name.startsWith(".") || e.name === "node_modules") continue;
+        walk(full, depth + 1);
+      } else if (e.isFile() && /\.(md|mdx)$/i.test(e.name)) {
+        files.push(full);
+      }
+    }
+  };
+  walk(docsDir, 0);
+  if (!files.length) return void 0;
+  const terms = (query ?? "").toLowerCase().split(/[^a-z0-9]+/).filter((w) => w.length > 2);
+  const scored = files.map((f) => {
+    let body = "";
+    try {
+      body = fs4.readFileSync(f, "utf8");
+    } catch {
+      return { f, body: "", score: -1 };
+    }
+    const lc = `${path4.basename(f)}
+${body}`.toLowerCase();
+    const score = terms.length ? terms.filter((t) => lc.includes(t)).length : 1;
+    return { f, body, score };
+  });
+  const picked = (terms.length ? scored.filter((s) => s.score > 0).sort((a, b) => b.score - a.score || a.f.localeCompare(b.f)) : scored).filter((s) => s.body.trim()).slice(0, terms.length ? 8 : 5);
+  if (!picked.length) return void 0;
+  const text = picked.map((s) => `<!-- ${path4.relative(dir, s.f).split(path4.sep).join("/")} -->
+${s.body.trim()}`).join("\n\n");
+  return {
+    text,
+    files: picked.map((s) => path4.relative(dir, s.f).split(path4.sep).join("/"))
+  };
+}
+function localPackageDocs(root, name, opts) {
   const dir = npmPackageDir(root, name);
   if (!dir) return void 0;
   const version = resolveVersion(root, name).served;
-  for (const f of ["llms.txt", "README.md", "README.mdx", "README", "readme.md"]) {
+  let primary;
+  for (const f of README_CANDIDATES) {
     const p = path4.join(dir, f);
     try {
       const docs = fs4.readFileSync(p, "utf8");
       if (docs.trim()) {
-        return { docs, version, source: path4.relative(root, p).split(path4.sep).join("/") };
+        primary = { docs, source: path4.relative(root, p).split(path4.sep).join("/") };
+        break;
       }
     } catch {
     }
   }
+  const extra = packageDocsMarkdown(dir, opts?.query);
+  if (primary && extra) {
+    return {
+      docs: `${primary.docs.trim()}
+
+## Package docs
+
+${extra.text}`,
+      version,
+      source: `${primary.source}+docs/`,
+      readmeOnly: false
+    };
+  }
+  if (primary) {
+    return { ...primary, version, readmeOnly: true };
+  }
+  if (extra) {
+    return {
+      docs: extra.text,
+      version,
+      source: path4.relative(root, path4.join(dir, "docs")).split(path4.sep).join("/") + "/",
+      readmeOnly: false
+    };
+  }
   try {
     const pkg = JSON.parse(fs4.readFileSync(path4.join(dir, "package.json"), "utf8"));
     if (pkg.description?.trim()) {
@@ -1263,35 +1338,104 @@ function localPackageDocs(root, name) {
 
 ${pkg.description}`,
         version: version ?? pkg.version,
-        source: path4.relative(root, path4.join(dir, "package.json")).split(path4.sep).join("/")
+        source: path4.relative(root, path4.join(dir, "package.json")).split(path4.sep).join("/"),
+        readmeOnly: true
       };
     }
   } catch {
   }
   return void 0;
 }
+function typesFromPkg(dir, pkg) {
+  const tryRel = (rel) => {
+    if (typeof rel !== "string") return void 0;
+    const p = path4.join(dir, rel);
+    return fs4.existsSync(p) ? p : void 0;
+  };
+  const top = tryRel(pkg.types) ?? tryRel(pkg.typings);
+  if (top) return top;
+  const exp = pkg.exports;
+  if (!exp || typeof exp !== "object") return void 0;
+  const roots = [];
+  if ("." in exp) roots.push(exp["."]);
+  else roots.push(...Object.values(exp));
+  for (const entry of roots) {
+    if (typeof entry === "string") {
+      const hit = tryRel(entry.endsWith(".d.ts") ? entry : void 0);
+      if (hit) return hit;
+      continue;
+    }
+    if (entry && typeof entry === "object") {
+      const o = entry;
+      for (const key of ["types", "typings", "import", "require", "default"]) {
+        const v = o[key];
+        if (typeof v === "string") {
+          const hit = tryRel(v.endsWith(".ts") || v.endsWith(".d.ts") || v.endsWith(".mts") || v.endsWith(".cts") ? v : void 0);
+          if (hit) return hit;
+        } else if (v && typeof v === "object" && typeof v.types === "string") {
+          const hit = tryRel(v.types);
+          if (hit) return hit;
+        }
+      }
+    }
+  }
+  return void 0;
+}
 function dtsEntry(dir) {
   try {
     const pkg = JSON.parse(fs4.readFileSync(path4.join(dir, "package.json"), "utf8"));
-    const rel = pkg.types ?? pkg.typings;
-    if (typeof rel === "string") {
-      const p = path4.join(dir, rel);
-      if (fs4.existsSync(p)) return p;
-    }
+    const fromPkg = typesFromPkg(dir, pkg);
+    if (fromPkg) return fromPkg;
   } catch {
   }
-  for (const c of ["index.d.ts", "dist/index.d.ts", "lib/index.d.ts", "types/index.d.ts"]) {
+  for (const c of [
+    "index.d.ts",
+    "dist/index.d.ts",
+    "dist/types/index.d.ts",
+    "lib/index.d.ts",
+    "types/index.d.ts",
+    "build/index.d.ts"
+  ]) {
     const p = path4.join(dir, c);
     if (fs4.existsSync(p)) return p;
   }
   return void 0;
 }
+var MAX_DTS_FILES = 30;
+var MAX_DTS_BYTES = 512e3;
+function collectDtsFiles(dir) {
+  const out = [];
+  const walk = (d, depth) => {
+    if (depth > 4 || out.length >= MAX_DTS_FILES) return;
+    let entries;
+    try {
+      entries = fs4.readdirSync(d, { withFileTypes: true });
+    } catch {
+      return;
+    }
+    entries.sort((a, b) => a.name.localeCompare(b.name));
+    for (const e of entries) {
+      if (out.length >= MAX_DTS_FILES) return;
+      if (e.name === "node_modules" || e.name.startsWith(".")) continue;
+      const full = path4.join(d, e.name);
+      if (e.isDirectory()) walk(full, depth + 1);
+      else if (e.isFile() && /\.d\.(ts|mts|cts)$/.test(e.name)) out.push(full);
+    }
+  };
+  walk(dir, 0);
+  return out;
+}
 function extractDtsApi(src, maxDecls = 200) {
   const out = [];
   let depth = 0;
   let capture = null;
   for (const raw of src.split("\n")) {
     const line = raw.trim();
+    if (capture === null && depth === 0 && /^export\s+\{[^}]+\}/.test(line)) {
+      out.push(raw.trim());
+      if (out.length >= maxDecls) break;
+      continue;
+    }
     if (capture === null && depth === 0 && /^export\b/.test(line) && !/^export\s+(\{|\*|default\b|type\s+\{)/.test(line)) {
       capture = [];
     }
@@ -1308,19 +1452,72 @@ function extractDtsApi(src, maxDecls = 200) {
   }
   return out;
 }
-function localApiSurface(root, name) {
+function reExportNames(decl) {
+  const m = /^export\s*\{([^}]+)\}/.exec(decl.trim());
+  if (!m) return [];
+  const names = [];
+  for (const part of m[1].split(",")) {
+    const n = part.trim().split(/\s+as\s+/i).pop()?.trim();
+    if (n && /^[A-Za-z_$][\w$]*$/.test(n)) names.push(n);
+  }
+  return names;
+}
+function localApiSurface(root, name, query) {
   const dir = npmPackageDir(root, name);
   if (!dir) return void 0;
-  const dts = dtsEntry(dir);
-  if (!dts) return void 0;
-  let src;
-  try {
-    src = fs4.readFileSync(dts, "utf8");
-  } catch {
-    return void 0;
+  const entry = dtsEntry(dir);
+  const files = entry ? [entry, ...collectDtsFiles(dir).filter((f) => f !== entry)] : collectDtsFiles(dir);
+  if (!files.length) return void 0;
+  const allDecls = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const f of files) {
+    let src;
+    try {
+      const st = fs4.statSync(f);
+      if (st.size > MAX_DTS_BYTES) continue;
+      src = fs4.readFileSync(f, "utf8");
+    } catch {
+      continue;
+    }
+    for (const d of extractDtsApi(src)) {
+      if (seen.has(d)) continue;
+      seen.add(d);
+      allDecls.push(d);
+      if (allDecls.length >= 400) break;
+    }
+    if (allDecls.length >= 400) break;
+  }
+  if (!allDecls.length) return void 0;
+  const terms = (query ?? "").split(/[^A-Za-z0-9_$]+/).filter((w) => w.length > 2);
+  if (terms.length) {
+    const lcTerms = terms.map((t) => t.toLowerCase());
+    const matched = allDecls.filter((d) => {
+      const lc = d.toLowerCase();
+      return lcTerms.some((t) => lc.includes(t));
+    });
+    const expanded = [];
+    const expandedSeen = /* @__PURE__ */ new Set();
+    for (const d of matched) {
+      const names = reExportNames(d);
+      if (names.length) {
+        for (const n of names) {
+          const fuller = allDecls.find(
+            (x) => !/^export\s*\{/.test(x) && new RegExp(`\\b${n}\\b`).test(x)
+          );
+          const pick = fuller ?? d;
+          if (!expandedSeen.has(pick)) {
+            expandedSeen.add(pick);
+            expanded.push(pick);
+          }
+        }
+      } else if (!expandedSeen.has(d)) {
+        expandedSeen.add(d);
+        expanded.push(d);
+      }
+    }
+    if (expanded.length) return expanded.slice(0, 40).join("\n\n");
   }
-  const decls = extractDtsApi(src);
-  return decls.length ? decls.join("\n\n") : void 0;
+  return allDecls.slice(0, 80).join("\n\n");
 }
 function cloneAndReadGit(url) {
   const dir = fs4.mkdtempSync(path4.join(os.tmpdir(), "vg-lib-git-"));
@@ -1691,5 +1888,5 @@ var EdgeSet = class {
 };
 
 export { ECOSYSTEMS, addLibrary, applyStaticTestLinkage, buildModuleResolver, catalogPath, driftFor, edgeId, enrichOnline, inventory, isTestFile, libDir, libId, loadCatalog, localApiSurface, localPackageDocs, nodeId, parseJsonc, readDoc, relativeResolver, resolve3 as resolve, resolveLib, resolveVersion, saveCatalog };
-//# sourceMappingURL=chunk-LKVMI67M.js.map
-//# sourceMappingURL=chunk-LKVMI67M.js.map
+//# sourceMappingURL=chunk-6AXHLQBV.js.map
+//# sourceMappingURL=chunk-6AXHLQBV.js.map