@vibgrate/cli 2026.803.5 → 2026.804.1

package/dist/{chunk-OCINHIPN.js → chunk-K5GPEWPI.js}

@@ -1,6 +1,4 @@
-import { VERSION } from './chunk-USO67ZEE.js';
-import { WEAK_TERMS } from './chunk-4LGDQBYK.js';
-import { parseGraph, stableStringify, serializeGraph } from './chunk-RBMKBYGV.js';
+import { VERSION } from './chunk-B2Y45PCA.js';
 import { globalGraphPathForRef, globalGraphPath, repositoryStoreDir } from './chunk-BWPBB45M.js';
 import { detectGitRef } from './chunk-BPF3YX2U.js';
 import * as fs3 from 'fs';
@@ -10,6 +8,45 @@ import * as os from 'os';
 import * as path2 from 'path';
 import { pathToFileURL } from 'url';
 
+// src/engine/serialize.ts
+function serializeGraph(graph, opts) {
+  const indent = opts?.compact ? 0 : 2;
+  return `${stableStringify(graph, indent)}
+`;
+}
+function slimGraphForExport(graph) {
+  return {
+    ...graph,
+    areas: graph.areas.map((a) => ({
+      ...a,
+      members: []
+      // member id lists dominate XL exports; area id still on nodes
+    })),
+    grounding: void 0,
+    facts: graph.facts
+    // Keep summaries/unknowns — small and useful to agents.
+  };
+}
+function stableStringify(value, indent = 2) {
+  return JSON.stringify(sortKeys(value), null, indent);
+}
+function sortKeys(value) {
+  if (Array.isArray(value)) return value.map(sortKeys);
+  if (value && typeof value === "object") {
+    const input = value;
+    const out = {};
+    for (const key of Object.keys(input).sort()) {
+      const v = input[key];
+      if (v === void 0) continue;
+      out[key] = sortKeys(v);
+    }
+    return out;
+  }
+  return value;
+}
+function parseGraph(json) {
+  return JSON.parse(json);
+}
 var MAGIC = Buffer.from("VGSNAP1\0", "latin1");
 var crc322 = zlib.crc32 ?? jsCrc32;
 var crcTable = null;
@@ -293,6 +330,363 @@ ${embedded}
 function esc(s) {
   return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
 }
+
+// src/engine/concepts.ts
+var WEAK_TERMS = /* @__PURE__ */ new Set([
+  "add",
+  "adds",
+  "added",
+  "adding",
+  "create",
+  "creates",
+  "created",
+  "creating",
+  "make",
+  "makes",
+  "making",
+  "made",
+  "new",
+  "newly",
+  "remove",
+  "removes",
+  "removed",
+  "removing",
+  "delete",
+  "deletes",
+  "deleted",
+  "deleting",
+  "update",
+  "updates",
+  "updated",
+  "updating",
+  "change",
+  "changes",
+  "changed",
+  "changing",
+  "set",
+  "sets",
+  "setting",
+  "setup",
+  "get",
+  "gets",
+  "getting",
+  "use",
+  "uses",
+  "used",
+  "using",
+  "want",
+  "wants",
+  "wanted",
+  "do",
+  "does",
+  "doing",
+  "done",
+  "support",
+  "supports",
+  "supported",
+  "supporting",
+  "enable",
+  "enables",
+  "enabled",
+  "enabling",
+  "disable",
+  "disables",
+  "disabled",
+  "disabling",
+  "allow",
+  "allows",
+  "allowed",
+  "implement",
+  "implements",
+  "implemented",
+  "implementing",
+  "build",
+  "builds",
+  "building",
+  "built",
+  "via",
+  "through",
+  "into",
+  "onto",
+  "way",
+  "ways",
+  "thing",
+  "things",
+  "stuff",
+  "feature",
+  "features",
+  "functionality",
+  "method",
+  "methods",
+  "option",
+  "options",
+  "ability",
+  "help",
+  "start",
+  "begin",
+  "work",
+  "works",
+  "working",
+  "also",
+  "currently",
+  "properly",
+  "correctly",
+  "please",
+  "happens",
+  "happen",
+  "something",
+  "somewhere",
+  "step",
+  "steps",
+  "flow",
+  "process",
+  "you",
+  "can"
+]);
+var CONCEPTS = {
+  // ---- payments / billing ----
+  payment: ["stripe", "billing", "invoice", "checkout", "charge", "subscription", "refund", "payout", "card", "debit", "mandate"],
+  pay: ["payment", "stripe", "charge", "billing", "invoice"],
+  paid: ["payment", "invoice", "charge"],
+  billing: ["invoice", "payment", "subscription", "stripe", "charge", "renewal"],
+  checkout: ["stripe", "payment", "cart", "session"],
+  debit: ["mandate", "sepa", "bacs", "ach", "bank", "payment"],
+  mandate: ["sepa", "bacs", "debit"],
+  sepa: ["mandate", "debit", "iban", "bank"],
+  bacs: ["mandate", "debit", "bank"],
+  ach: ["mandate", "debit", "bank"],
+  stripe: ["payment", "billing", "checkout", "webhook", "charge", "card"],
+  refund: ["payment", "invoice", "stripe", "charge"],
+  invoice: ["billing", "payment", "refund", "subscription"],
+  subscription: ["billing", "renewal", "invoice", "plan", "recurring"],
+  recurring: ["subscription", "renewal", "mandate", "debit"],
+  renewal: ["subscription", "billing", "renew"],
+  card: ["payment", "charge", "stripe"],
+  credit: ["card", "payment", "charge"],
+  bank: ["debit", "mandate", "sepa", "iban", "account"],
+  charge: ["payment", "card", "stripe"],
+  webhook: ["event", "handler", "callback"],
+  price: ["payment", "billing", "plan"],
+  customer: ["billing", "account", "user"],
+  // ---- auth ----
+  auth: ["login", "session", "token", "oauth", "password", "credential"],
+  authentication: ["auth", "login", "session", "token", "password"],
+  authenticated: ["auth", "login", "session"],
+  login: ["auth", "session", "password", "signin", "oauth"],
+  signin: ["login", "auth", "session"],
+  signup: ["register", "onboard", "account"],
+  logout: ["session", "auth", "signout"],
+  password: ["auth", "login", "credential", "hash"],
+  session: ["auth", "login", "token"],
+  token: ["session", "auth", "jwt"],
+  oauth: ["auth", "login", "callback", "provider"],
+  google: ["oauth", "login", "auth"],
+  github: ["oauth", "login", "auth"],
+  sso: ["oauth", "auth", "saml", "login"],
+  credential: ["auth", "password", "token", "secret"],
+  // ---- dependencies / supply chain ----
+  dependency: ["package", "audit", "vulnerability", "advisory", "lockfile", "version"],
+  package: ["dependency", "audit", "vulnerability", "advisory", "lockfile"],
+  vulnerability: ["advisory", "cve", "osv", "audit", "vulnerable"],
+  vulnerable: ["vulnerability", "advisory", "audit", "cve"],
+  advisory: ["vulnerability", "cve", "osv", "audit"],
+  cve: ["vulnerability", "advisory", "osv"],
+  risk: ["vulnerability", "audit", "advisory"],
+  security: ["vulnerability", "audit", "advisory"],
+  audit: ["dependency", "vulnerability", "advisory"],
+  scan: ["audit", "vulnerability", "scanner"],
+  // ---- notifications / messaging ----
+  email: ["mail", "smtp", "sender", "template", "message"],
+  mail: ["email", "smtp", "sender"],
+  notification: ["notify", "email", "sms", "push", "alert"],
+  notify: ["notification", "email", "alert"],
+  sms: ["notification", "message", "twilio"],
+  // ---- e-commerce ----
+  cart: ["checkout", "order", "shop", "basket", "discount"],
+  basket: ["cart", "checkout", "order"],
+  order: ["cart", "shipment", "fulfillment", "shop", "checkout"],
+  ship: ["order", "fulfillment", "delivery", "shipment"],
+  shipment: ["order", "fulfillment", "delivery", "track"],
+  shipping: ["order", "fulfillment", "delivery", "shipment"],
+  shipped: ["order", "fulfillment", "shipment"],
+  inventory: ["stock", "product", "catalog", "restock"],
+  stock: ["inventory", "product", "restock"],
+  product: ["catalog", "inventory", "shop"],
+  discount: ["coupon", "promo", "cart", "price"],
+  coupon: ["discount", "promo", "code"],
+  // ---- chat / social ----
+  chat: ["message", "room", "conversation", "presence"],
+  message: ["chat", "sms", "notification", "thread"],
+  conversation: ["chat", "message", "thread"],
+  presence: ["online", "typing", "status"],
+  online: ["presence", "status"],
+  typing: ["presence", "indicator", "broadcast"],
+  // ---- media / streaming ----
+  video: ["media", "transcode", "playback", "stream", "thumbnail"],
+  stream: ["video", "playback", "manifest", "media"],
+  streaming: ["video", "playback", "manifest", "media"],
+  playback: ["video", "stream", "media", "watch"],
+  transcode: ["video", "media", "encode"],
+  thumbnail: ["video", "image", "media"],
+  media: ["video", "stream", "playback", "asset"],
+  // ---- analytics ----
+  analytics: ["event", "track", "metric", "funnel", "report"],
+  event: ["track", "analytics", "webhook"],
+  track: ["event", "analytics"],
+  funnel: ["conversion", "analytics", "event"],
+  conversion: ["funnel", "analytics"],
+  report: ["metrics", "export", "analytics"],
+  // ---- content / CMS ----
+  article: ["publish", "content", "post", "cms"],
+  publish: ["article", "release", "post", "content"],
+  post: ["article", "publish", "message"],
+  blog: ["article", "publish", "post", "cms"],
+  content: ["cms", "article", "markdown"],
+  markdown: ["render", "article", "content"],
+  cms: ["article", "content", "publish"],
+  // ---- CI / deployment ----
+  deploy: ["release", "rollback", "pipeline", "deployment"],
+  deployment: ["deploy", "release", "rollback", "pipeline"],
+  release: ["deploy", "version", "rollback"],
+  rollback: ["deploy", "release", "deployment"],
+  pipeline: ["stage", "deploy", "runner", "ci"],
+  canary: ["deploy", "rollout", "release"],
+  // ---- mobile ----
+  push: ["notification", "device", "token", "mobile"],
+  device: ["push", "token", "mobile", "register"],
+  deeplink: ["link", "route", "universal"],
+  mobile: ["push", "device", "deeplink", "app"],
+  ios: ["mobile", "universal", "link", "app"],
+  android: ["mobile", "push", "device", "app"],
+  // ---- batch / ETL / mainframe ----
+  batch: ["settlement", "job", "etl", "reconcile"],
+  settlement: ["batch", "reconcile", "ledger", "clearing"],
+  reconcile: ["ledger", "settlement", "batch"],
+  ledger: ["settlement", "reconcile", "balance", "journal"],
+  mainframe: ["batch", "settlement", "ebcdic", "cobol", "fixed"],
+  ebcdic: ["mainframe", "record", "convert", "legacy"],
+  cobol: ["mainframe", "batch", "ebcdic"],
+  etl: ["batch", "pipeline", "extract", "load", "transform"],
+  nightly: ["batch", "cron", "schedule", "job"],
+  // ---- geo / maps ----
+  geocode: ["address", "location", "map", "geo"],
+  address: ["geocode", "location"],
+  map: ["geo", "route", "location"],
+  route: ["distance", "path", "planner", "geo"],
+  distance: ["route", "haversine", "geo"],
+  location: ["geo", "geocode", "map"],
+  arrival: ["route", "eta", "estimate"],
+  // ---- i18n ----
+  translation: ["locale", "i18n", "language", "translate"],
+  translate: ["translation", "locale", "language"],
+  locale: ["translation", "i18n", "language", "format"],
+  i18n: ["translation", "locale", "language"],
+  language: ["locale", "translation", "i18n"],
+  localized: ["locale", "translation", "format"],
+  // ---- observability ----
+  metric: ["counter", "prometheus", "telemetry", "export"],
+  prometheus: ["metric", "exporter", "monitoring"],
+  trace: ["span", "telemetry", "observability"],
+  span: ["trace", "telemetry"],
+  monitoring: ["metric", "trace", "alert", "observability"],
+  telemetry: ["metric", "trace", "span"],
+  counter: ["metric", "increment"],
+  // ---- feature flags / experimentation ----
+  flag: ["feature", "rollout", "toggle", "experiment"],
+  rollout: ["flag", "percentage", "release", "experiment"],
+  toggle: ["flag", "feature", "switch"],
+  experiment: ["variant", "assign", "flag", "exposure"],
+  variant: ["experiment", "assign"],
+  // ---- generic infrastructure ----
+  database: ["schema", "migration", "sql", "query", "orm"],
+  db: ["database", "schema", "migration", "sql"],
+  migration: ["database", "schema", "migrate", "sql"],
+  cache: ["redis", "ttl", "store"],
+  queue: ["job", "worker", "task", "batch"],
+  job: ["queue", "worker", "cron"],
+  upload: ["file", "storage", "blob", "asset"],
+  storage: ["file", "upload", "bucket", "blob"],
+  permission: ["role", "rbac", "acl", "access", "grant"],
+  role: ["permission", "rbac", "access"],
+  error: ["exception", "failure", "handler"],
+  config: ["settings", "env", "configuration"]
+};
+var BIGRAM_CONCEPTS = {
+  "direct debit": ["debit", "mandate", "sepa", "bacs", "bank"],
+  "direct debits": ["debit", "mandate", "sepa", "bacs", "bank"],
+  "sign in": ["login", "signin", "auth", "session"],
+  "signs in": ["login", "signin", "auth", "session"],
+  "log in": ["login", "auth", "session"],
+  "logs in": ["login", "auth", "session"],
+  "logged in": ["login", "auth", "session"],
+  "sign up": ["signup", "register", "account"],
+  "credit card": ["card", "payment", "charge", "stripe"],
+  "credit cards": ["card", "payment", "charge", "stripe"],
+  "bank transfer": ["bank", "payment", "sepa", "transfer"],
+  "rate limit": ["ratelimit", "throttle", "quota"],
+  "two factor": ["totp", "mfa", "otp", "auth"],
+  "payment method": ["payment", "stripe", "card", "debit"],
+  "payment methods": ["payment", "stripe", "card", "debit"],
+  "push notification": ["push", "device", "token", "notification"],
+  "push notifications": ["push", "device", "token", "notification"],
+  "deep link": ["deeplink", "link", "route"],
+  "deep links": ["deeplink", "link", "route"],
+  "universal link": ["deeplink", "link", "universal"],
+  "universal links": ["deeplink", "link", "universal"],
+  "feature flag": ["flag", "rollout", "toggle", "experiment"],
+  "feature flags": ["flag", "rollout", "toggle", "experiment"],
+  "shopping cart": ["cart", "checkout", "order"],
+  "roll back": ["rollback", "deploy", "release"],
+  "rolled back": ["rollback", "deploy", "release"],
+  "ab test": ["experiment", "variant"],
+  "sign out": ["logout", "session", "auth"],
+  "fixed width": ["record", "export", "mainframe", "batch"]
+};
+function lexiconKey(token) {
+  if (token in CONCEPTS) return token;
+  if (token.endsWith("ies")) {
+    const singular = token.slice(0, -3) + "y";
+    if (singular in CONCEPTS) return singular;
+  }
+  if (token.endsWith("s")) {
+    const singular = token.slice(0, -1);
+    if (singular in CONCEPTS) return singular;
+  }
+  return null;
+}
+function expandConcepts(orderedTokens) {
+  const present = new Set(orderedTokens);
+  const out = [];
+  const emitted = /* @__PURE__ */ new Set();
+  const emit = (term, from) => {
+    if (present.has(term) || emitted.has(term)) return;
+    emitted.add(term);
+    out.push({ term, from });
+  };
+  for (let i = 0; i + 1 < orderedTokens.length; i++) {
+    const bigram = `${orderedTokens[i]} ${orderedTokens[i + 1]}`;
+    const terms = BIGRAM_CONCEPTS[bigram];
+    if (terms) for (const t of terms) emit(t, bigram);
+  }
+  for (const token of orderedTokens) {
+    const key = lexiconKey(token);
+    if (key) for (const t of CONCEPTS[key]) emit(t, token);
+  }
+  return out;
+}
+function bigramConsumedTokens(orderedTokens) {
+  const consumed = /* @__PURE__ */ new Set();
+  for (let i = 0; i + 1 < orderedTokens.length; i++) {
+    const bigram = `${orderedTokens[i]} ${orderedTokens[i + 1]}`;
+    if (!BIGRAM_CONCEPTS[bigram]) continue;
+    for (const tok of [orderedTokens[i], orderedTokens[i + 1]]) {
+      if (!lexiconKey(tok)) consumed.add(tok);
+    }
+  }
+  return consumed;
+}
+
+// src/engine/relevance-provider.ts
 var MAX_PROVIDER_EXPANSIONS = 24;
 function disabled() {
   const v = process.env.VIBGRATE_NO_KERNEL;
@@ -411,6 +805,8 @@ var DEFAULT_GITIGNORE = [
   "graph.json",
   "graph.snap",
   "graph.tags.snap",
+  // Binary semantic index next to the map (never model-named; never under cache/).
+  "embeddings",
   "graph.html",
   "GRAPH_REPORT.md",
   "facts.jsonl",
@@ -580,7 +976,63 @@ async function loadTopicTags(graph, root, graphPath) {
   writeSidecar(file, { provider: providerVersion, corpusHash }, record);
   return tags;
 }
+var CACHE_VERSION = "vg-parse-cache/4";
+function cacheDir(root) {
+  return path2.join(root, ".vibgrate", "cache");
+}
+function cachePath(root) {
+  return path2.join(cacheDir(root), "parse-cache.json");
+}
+function loadCache(root, opts) {
+  const file = cachePath(root);
+  let data = {
+    version: CACHE_VERSION,
+    toolVersion: opts.toolVersion,
+    grammars: opts.grammars,
+    entries: {}
+  };
+  if (!opts.disabled && fs3.existsSync(file)) {
+    try {
+      const loaded = JSON.parse(fs3.readFileSync(file, "utf8"));
+      if ((loaded.version === CACHE_VERSION || loaded.version === "vg-parse-cache/3") && loaded.toolVersion === opts.toolVersion && loaded.grammars === opts.grammars && loaded.entries) {
+        data = { ...loaded, version: CACHE_VERSION };
+      }
+    } catch {
+    }
+  }
+  return {
+    get(rel, hash) {
+      const entry = data.entries[rel];
+      return entry && entry.hash === hash ? entry.parse : void 0;
+    },
+    getByStat(rel, mtimeMs, size) {
+      const entry = data.entries[rel];
+      if (!entry) return void 0;
+      if (entry.mtimeMs === mtimeMs && entry.size === size && entry.parse) {
+        return { parse: entry.parse, hash: entry.hash };
+      }
+      return void 0;
+    },
+    set(rel, parse, stat) {
+      data.entries[rel] = {
+        hash: parse.hash,
+        parse,
+        mtimeMs: stat?.mtimeMs,
+        size: stat?.size
+      };
+    },
+    prune(currentRels) {
+      for (const rel of Object.keys(data.entries)) {
+        if (!currentRels.has(rel)) delete data.entries[rel];
+      }
+    },
+    save() {
+      fs3.mkdirSync(cacheDir(root), { recursive: true });
+      fs3.writeFileSync(file, stableStringify(data, 0));
+    }
+  };
+}
 
-export { analyzeQuestion, defaultGraphPath, ensureVibgrateGitignore, legacyGraphPath, loadGraphFileWithSnapshot, loadRelevanceProvider, loadTopicTags, mapFileExists, mapFileStat, preferInRepoGraph, relevanceModuleDir, renderHtml, renderReport, resetRelevanceProviderCache, resolveGraphPath, vibgrateDir, writeArtifacts };
-//# sourceMappingURL=chunk-OCINHIPN.js.map
-//# sourceMappingURL=chunk-OCINHIPN.js.map
+export { WEAK_TERMS, analyzeQuestion, bigramConsumedTokens, cacheDir, defaultGraphPath, ensureVibgrateGitignore, expandConcepts, legacyGraphPath, loadCache, loadGraphFileWithSnapshot, loadRelevanceProvider, loadTopicTags, mapFileExists, mapFileStat, parseGraph, preferInRepoGraph, relevanceModuleDir, renderHtml, renderReport, resetRelevanceProviderCache, resolveGraphPath, serializeGraph, slimGraphForExport, stableStringify, vibgrateDir, writeArtifacts };
+//# sourceMappingURL=chunk-K5GPEWPI.js.map
+//# sourceMappingURL=chunk-K5GPEWPI.js.map