@vibgrate/cli 2026.731.3 → 2026.801.1

package/dist/{chunk-EETK7S43.js → chunk-SDG242R4.js}

@@ -436,6 +436,350 @@ function safe(id) {
   return id.replace(/[^a-z0-9.-]+/gi, "_");
 }
 
+// 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;
+}
+
 // src/engine/query.ts
 var STOPWORDS = /* @__PURE__ */ new Set([
   "the",
@@ -587,14 +931,14 @@ function queryGraph(graph, question, options = {}) {
   const limit = options.limit ?? 12;
   const literals = extractLiteralNeedles(question);
   const forTokens = literals.length > 0 ? stripLiteralNeedles(question) : question;
-  const terms = tokenize(forTokens);
-  const weightOf = termWeights(graph, terms);
+  const prep = prepareTerms(forTokens);
+  const weightOf = termWeights(graph, prep.terms.map((t) => t.term));
   const index = indexFor(graph);
   const scored = [];
-  if (terms.length > 0) {
+  if (prep.hasContent) {
     for (const node of graph.nodes) {
       if (node.kind === "file" || node.kind === "external") continue;
-      const { score, why } = scoreNode(node, terms, weightOf);
+      const { score, why } = scoreNode(node, prep.terms, weightOf);
       if (score > 0) scored.push({ node, score: round(score * (1 + IMPORTANCE_WEIGHT * node.importance)), why });
     }
     scored.sort((a, b) => b.score - a.score || a.node.qualifiedName.localeCompare(b.node.qualifiedName));
@@ -608,17 +952,18 @@ async function queryGraphSemantic(graph, question, options) {
   const limit = options.limit ?? 12;
   const literals = extractLiteralNeedles(question);
   const forTokens = literals.length > 0 ? stripLiteralNeedles(question) : question;
-  const terms = tokenize(forTokens);
+  const prep = prepareTerms(forTokens);
+  const terms = prep.terms.map((t) => t.term);
   const weightOf = termWeights(graph, terms);
   const index = indexFor(graph);
   const queryVec = await options.embedder.embedQuery(forTokens || question);
   const lexRaw = /* @__PURE__ */ new Map();
   let lexMax = 0;
   const whyById = /* @__PURE__ */ new Map();
-  if (terms.length > 0) {
+  if (prep.hasContent) {
     for (const node of graph.nodes) {
       if (node.kind === "file" || node.kind === "external") continue;
-      const { score, why } = scoreNode(node, terms, weightOf);
+      const { score, why } = scoreNode(node, prep.terms, weightOf);
       lexRaw.set(node.id, score);
       whyById.set(node.id, why);
       if (score > lexMax) lexMax = score;
@@ -650,35 +995,66 @@ function tokenize(q) {
     )
   ];
 }
+function tokenizeOrdered(q) {
+  return q.toLowerCase().split(/[^\p{L}\p{N}]+/u).filter((t) => t.length >= 1);
+}
+var WEAK_TERM_WEIGHT = 0.25;
+var EXPANSION_WEIGHT = 0.7;
+var COVERAGE_BONUS = 0.35;
+function prepareTerms(forTokens) {
+  const base = tokenize(forTokens);
+  const ordered = tokenizeOrdered(forTokens);
+  const baseSet = new Set(base);
+  const terms = base.map((t) => ({ term: t, weak: WEAK_TERMS.has(t) }));
+  for (const e of expandConcepts(ordered)) {
+    if (baseSet.has(e.term)) continue;
+    terms.push({ term: e.term, weak: false, from: e.from });
+  }
+  const hasContent = terms.some((t) => !t.weak);
+  return { terms, hasContent };
+}
 function scoreNode(node, terms, weightOf = () => 1) {
   let score = 0;
+  let contentHits = 0;
   const hits = [];
   const name = node.name.toLowerCase();
   const qn = node.qualifiedName.toLowerCase();
   const file = node.file.toLowerCase();
+  const dirSegments = new Set(file.split("/").slice(0, -1));
   const nameParts = identifierParts(node.name);
-  for (const t of terms) {
-    const w = weightOf(t);
+  for (const { term: t, weak, from } of terms) {
+    const w = weightOf(t) * (weak ? WEAK_TERM_WEIGHT : 1) * (from ? EXPANSION_WEIGHT : 1);
+    const label = from ? `${from}\u2192${t}` : t;
+    let contribution = 0;
     if (name === t) {
-      score += 10 * w;
-      hits.push(t);
+      contribution = 10 * w;
+      hits.push(label);
     } else if (nameParts.has(t)) {
-      score += 6 * w;
-      hits.push(t);
+      contribution = 6 * w;
+      hits.push(label);
     } else if (name.includes(t)) {
-      score += 4 * w;
-      hits.push(t);
+      contribution = 4 * w;
+      hits.push(label);
     } else if (qn.includes(t)) {
-      score += 3 * w;
-      hits.push(t);
+      contribution = 3 * w;
+      hits.push(label);
     } else if (fuzzyPartMatch(t, nameParts)) {
-      score += 2 * w;
-      hits.push(`~${t}`);
+      contribution = 2 * w;
+      hits.push(from ? `~${from}\u2192${t}` : `~${t}`);
+    } else if (dirSegments.has(t)) {
+      contribution = 2 * w;
+      hits.push(label);
     } else if (file.includes(t)) {
-      score += 1 * w;
-      hits.push(t);
+      contribution = 1 * w;
+      hits.push(label);
+    }
+    if (contribution > 0) {
+      score += contribution;
+      if (!weak) contentHits += 1;
     }
   }
+  if (contentHits === 0) return { score: 0, why: "" };
+  score *= 1 + COVERAGE_BONUS * Math.min(contentHits - 1, 4);
   return { score, why: hits.length ? `matched: ${hits.join(", ")}` : "" };
 }
 var IMPORTANCE_WEIGHT = 0.4;
@@ -818,5 +1194,5 @@ function round2(x) {
 }
 
 export { GraphIndex, acquireLock, clearModelCache, cosine, countPending, embeddingsCached, extractLiteralNeedles, getNodeEmbeddings, identifierParts, impactOf, indexFor, isLocateOnlyInstruction, isModelReady, loadEmbedder, modelCacheInfo, nodeEmbedText, queryGraph, queryGraphSemantic, releaseLock, residualForSymbolSearch, resolveEmbedModel, unavailableMessage, withTimeout };
-//# sourceMappingURL=chunk-EETK7S43.js.map
-//# sourceMappingURL=chunk-EETK7S43.js.map
+//# sourceMappingURL=chunk-SDG242R4.js.map
+//# sourceMappingURL=chunk-SDG242R4.js.map