@vibgrate/cli 2026.825.2 → 2026.829.1

package/dist/{daemon-RZS5FPIW.js → daemon-NRIIDMX2.js}

@@ -1,7 +1,7 @@
-export { compareDaemonVersion, ensureVgd, ensureVgdSoft, registerDaemon, restartVgdIfRunning, retireWedgedVgd, startDetachedVgd, stopVgd, vgdCliVersion, vgdVersionSkew } from './chunk-DIZ5KI5Q.js';
-import './chunk-YENM3HT7.js';
+export { compareDaemonVersion, ensureVgd, ensureVgdSoft, registerDaemon, restartVgdIfRunning, retireWedgedVgd, startDetachedVgd, stopVgd, vgdCliVersion, vgdVersionSkew } from './chunk-FHSEK64W.js';
+import './chunk-N6R4XPLX.js';
 import './chunk-CT5BS56U.js';
-import './chunk-KYM55VZX.js';
+import './chunk-VOEEYCR3.js';
 import './chunk-3LOWJSAF.js';
 import './chunk-5HYCB55P.js';
 import './chunk-IS7VTH2Q.js';
@@ -11,20 +11,20 @@ import './chunk-EZ7UC5Y5.js';
 import './chunk-DBX3DL27.js';
 import './chunk-6BEBJCK4.js';
 import './chunk-J7LKEB2R.js';
-import './chunk-K3SXWOTT.js';
-import './chunk-7M4E7UGX.js';
+import './chunk-YL332BU2.js';
+import './chunk-RL7JYG3D.js';
 import './chunk-VHRSG6CF.js';
 import './chunk-6H2QV5DR.js';
 import './chunk-RTURQXQL.js';
 import './chunk-6WRG7VDO.js';
-import './chunk-FQHWPOTS.js';
-import './chunk-OIUVWCKM.js';
+import './chunk-BA6YBVNT.js';
+import './chunk-FPIMNVLI.js';
 import './chunk-MVPRPSXU.js';
 import './chunk-O3LABX6I.js';
-import './chunk-G3ACLBMG.js';
+import './chunk-UGRUG2FA.js';
 import './chunk-XP6UUCZZ.js';
 import './chunk-JFGYT6BI.js';
 import './chunk-XQNKCA2J.js';
 import './chunk-Z6ZWNWWR.js';
-//# sourceMappingURL=daemon-RZS5FPIW.js.map
-//# sourceMappingURL=daemon-RZS5FPIW.js.map
+//# sourceMappingURL=daemon-NRIIDMX2.js.map
+//# sourceMappingURL=daemon-NRIIDMX2.js.map

package/dist/{daemon-RZS5FPIW.js.map → daemon-NRIIDMX2.js.map}

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"daemon-RZS5FPIW.js"}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"daemon-NRIIDMX2.js"}

package/dist/embed-worker-main.js

@@ -1,8 +1,8 @@
-import { resolveEmbedModel, loadEmbedder } from './chunk-FQHWPOTS.js';
-import './chunk-OIUVWCKM.js';
+import { resolveEmbedModel, loadEmbedder } from './chunk-BA6YBVNT.js';
+import './chunk-FPIMNVLI.js';
 import './chunk-MVPRPSXU.js';
 import './chunk-O3LABX6I.js';
-import './chunk-G3ACLBMG.js';
+import './chunk-UGRUG2FA.js';
 import './chunk-XP6UUCZZ.js';
 import './chunk-JFGYT6BI.js';
 import './chunk-XQNKCA2J.js';

package/dist/{ensure-map-DL2S774J.js → ensure-map-VAIYCCEJ.js}

@@ -1,40 +1,41 @@
-export { ensureCodeMap } from './chunk-HFQIYM6E.js';
-import './chunk-27TS2AUJ.js';
-import './chunk-YENM3HT7.js';
+export { ensureCodeMap } from './chunk-JWQ2JCQS.js';
+import './chunk-K7QR7U3V.js';
+import './chunk-N6R4XPLX.js';
 import './chunk-H5Q4JUY4.js';
 import './chunk-CT5BS56U.js';
-import './chunk-NS4DL3QR.js';
-import './chunk-TT2J2TB6.js';
+import './chunk-HHMWE52J.js';
+import './chunk-EGMBHPXV.js';
+import './chunk-65YN3BG3.js';
 import './chunk-HTLDXEHW.js';
-import './chunk-5UG4UHKU.js';
+import './chunk-HUJZO4K5.js';
 import './chunk-VIWZ4QT7.js';
-import './chunk-NZES47ST.js';
+import './chunk-TWFPHXPN.js';
 import './chunk-WNKGRXUA.js';
 import './chunk-57ZRSCHY.js';
 import './chunk-MS6V5XKB.js';
-import './chunk-IJVWKZRS.js';
+import './chunk-KCKG3EEJ.js';
 import './chunk-PVNALGTG.js';
 import './chunk-CRAMOEBE.js';
 import './chunk-EZ7UC5Y5.js';
 import './chunk-A3WWRW7U.js';
 import './chunk-6BEBJCK4.js';
 import './chunk-J7LKEB2R.js';
-import './chunk-K3SXWOTT.js';
-import './chunk-7M4E7UGX.js';
+import './chunk-YL332BU2.js';
+import './chunk-RL7JYG3D.js';
 import './chunk-VHRSG6CF.js';
 import './chunk-6H2QV5DR.js';
 import './chunk-RTURQXQL.js';
-import './chunk-6MIJLO5B.js';
+import './chunk-NSC7ZK62.js';
 import './chunk-T7RSQ5WD.js';
 import './chunk-6WRG7VDO.js';
-import './chunk-FQHWPOTS.js';
-import './chunk-OIUVWCKM.js';
+import './chunk-BA6YBVNT.js';
+import './chunk-FPIMNVLI.js';
 import './chunk-MVPRPSXU.js';
 import './chunk-O3LABX6I.js';
-import './chunk-G3ACLBMG.js';
+import './chunk-UGRUG2FA.js';
 import './chunk-XP6UUCZZ.js';
 import './chunk-JFGYT6BI.js';
 import './chunk-XQNKCA2J.js';
 import './chunk-Z6ZWNWWR.js';
-//# sourceMappingURL=ensure-map-DL2S774J.js.map
-//# sourceMappingURL=ensure-map-DL2S774J.js.map
+//# sourceMappingURL=ensure-map-VAIYCCEJ.js.map
+//# sourceMappingURL=ensure-map-VAIYCCEJ.js.map

package/dist/{ensure-map-DL2S774J.js.map → ensure-map-VAIYCCEJ.js.map}

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"ensure-map-DL2S774J.js"}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"ensure-map-VAIYCCEJ.js"}

package/dist/explain-EXPJTCB5.js

@@ -0,0 +1,126 @@
+import { EmbeddedLlmHost } from './chunk-IASO2HCI.js';
+import { ensurePackage } from './chunk-3HNPVXUK.js';
+import './chunk-3LOWJSAF.js';
+import './chunk-5HYCB55P.js';
+import { discoverModels } from './chunk-WNKGRXUA.js';
+import './chunk-57ZRSCHY.js';
+import { CliError, ExitCode } from './chunk-MS6V5XKB.js';
+import './chunk-EZ7UC5Y5.js';
+import './chunk-XP6UUCZZ.js';
+import './chunk-JFGYT6BI.js';
+import './chunk-XQNKCA2J.js';
+import './chunk-Z6ZWNWWR.js';
+
+// src/review/explain.ts
+var EXPLAIN_GRAMMAR = String.raw`
+root        ::= "{" ws "\"implications\"" ws ":" ws implications ws "," ws "\"unknowns\"" ws ":" ws strings ws "}"
+implications ::= "[" ws (implication (ws "," ws implication)*)? ws "]"
+implication ::= "{" ws "\"finding_id\"" ws ":" ws string ws "," ws "\"implication\"" ws ":" ws string ws "," ws "\"remediation_intent\"" ws ":" ws string ws "}"
+strings     ::= "[" ws (string (ws "," ws string)*)? ws "]"
+string      ::= "\"" ([^"\\] | "\\" ["\\/bfnrt])* "\""
+ws          ::= [ \t\n]*
+`;
+function pickExplainModel(models = discoverModels()) {
+  const preferred = [/qwen.*coder/i, /granite/i, /coder/i, /instruct/i];
+  for (const pattern of preferred) {
+    const hit = models.find((m) => pattern.test(m.name));
+    if (hit) return hit;
+  }
+  return models[0] ?? null;
+}
+function quantizationOf(name) {
+  const m = name.match(/\b(Q\d(?:_K)?(?:_[SML])?|F16|BF16|Q\d)\b/i);
+  return m ? m[1].toUpperCase() : null;
+}
+function buildPrompt(capsule, findings) {
+  const findingLines = [...findings.architecture_findings, ...findings.security_findings].map(
+    (f) => `- ${f.id} (${f.kind}, ${f.severity}): ${f.claim}`
+  );
+  return [
+    "Analysis capsule (facts only \u2014 every fact below was produced by a deterministic analyzer):",
+    JSON.stringify(capsule),
+    "",
+    "Deterministic findings:",
+    findingLines.join("\n") || "(none)",
+    "",
+    "For each finding, state the implication the author may not have accounted for, and the",
+    "intent behind a fix. Add any unknown that the facts above do not settle.",
+    "You are not deciding whether this change merges. Do not claim anything is secure, safe,",
+    "approved, or free of vulnerabilities. Cite only finding ids listed above."
+  ].join("\n");
+}
+async function explainFindings(capsule, findings, opts = {}) {
+  const model = opts.model ?? pickExplainModel();
+  if (!model) {
+    throw new CliError(
+      "`--explain` needs a local model and none was found \u2014 install one (`vg models install`) or drop `--explain` to run the deterministic review",
+      ExitCode.ENGINE_UNAVAILABLE
+    );
+  }
+  const ensured = await ensurePackage("node-llama-cpp@^3", {
+    consent: false,
+    local: opts.offline === true,
+    interactive: false
+  });
+  if (!ensured.module) {
+    throw new CliError(
+      "`--explain` needs the local inference binding (node-llama-cpp) and it is not installed \u2014 run `vg models install`, or drop `--explain`",
+      ExitCode.ENGINE_UNAVAILABLE
+    );
+  }
+  const host = new EmbeddedLlmHost();
+  host.setBinding(ensured.module);
+  host.setPreferGrammar(true);
+  await host.load(model.path);
+  let raw;
+  try {
+    const result = await host.generate(
+      [
+        {
+          role: "system",
+          content: "You are the explanation layer of an architecture review. You annotate deterministic findings. You never decide, never invent evidence, and never assert that code is secure."
+        },
+        { role: "user", content: buildPrompt(capsule, findings) }
+      ],
+      { grammar: EXPLAIN_GRAMMAR, requireGrammar: true, temperature: 0, maxTokens: 1024 }
+    );
+    raw = result.text;
+  } finally {
+    await host.unload();
+  }
+  return {
+    model: model.name,
+    quantization: quantizationOf(model.name),
+    findings: mergeExplanations(findings, raw)
+  };
+}
+function mergeExplanations(findings, raw) {
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch {
+    return findings;
+  }
+  const byId = new Map((parsed.implications ?? []).map((i) => [i.finding_id, i]));
+  const annotate = (f) => {
+    const hit = byId.get(f.id);
+    if (!hit) return f;
+    return {
+      ...f,
+      claim: `${f.claim} ${hit.implication}`.trim(),
+      remediation: hit.remediation_intent?.trim() ? hit.remediation_intent.trim() : f.remediation,
+      source: "model"
+    };
+  };
+  const modelUnknowns = (parsed.unknowns ?? []).filter((u) => typeof u === "string" && u.trim());
+  return {
+    ...findings,
+    architecture_findings: findings.architecture_findings.map(annotate),
+    security_findings: findings.security_findings.map(annotate),
+    unknowns: [.../* @__PURE__ */ new Set([...findings.unknowns, ...modelUnknowns])]
+  };
+}
+
+export { EXPLAIN_GRAMMAR, explainFindings, mergeExplanations, pickExplainModel };
+//# sourceMappingURL=explain-EXPJTCB5.js.map
+//# sourceMappingURL=explain-EXPJTCB5.js.map

package/dist/explain-EXPJTCB5.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/review/explain.ts"],"names":[],"mappings":"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","file":"explain-EXPJTCB5.js","sourcesContent":["/**\n * `vg review --explain` — the optional local model layer (spec §1, §7).\n *\n * The model may add **implications, purpose, unsure-band judgement, and\n * remediation intent**. It may not:\n *   - write a `decision` (there is nowhere to put one; the verifier rejects it)\n *   - invent evidence (every citation is checked against the capsule)\n *   - claim something is secure, safe, approved, or vulnerability-free\n *\n * Output is constrained at sample time by a GBNF grammar and then re-checked by\n * {@link verifyFindings}. Constrained decoding is a convenience; the verifier is\n * the contract.\n *\n * Slice 0 ships no custom weights. `--explain` runs on an already-installed\n * local coder GGUF and records that id in `versions.model`. With no local model\n * — or with the binding missing — it **fails closed** (exit 6). It never\n * silently degrades to deterministic-only while the receipt claims a model ran.\n */\n\nimport { ensurePackage } from '../code/ensure.js';\nimport { discoverModels, type LocalModel } from '../engine/models.js';\nimport { EmbeddedLlmHost } from '../runtime/llm-host/index.js';\nimport { CliError, ExitCode } from '../util/exit.js';\nimport type { AnalysisCapsule, ReviewFinding, ReviewFindings } from './schemas.js';\n\n/**\n * GBNF for the model's contribution. Note what is *absent*: no `decision`, no\n * `severity` escalation, no new evidence ids — the model annotates findings the\n * scanners already produced and adds unknowns.\n */\nexport const EXPLAIN_GRAMMAR = String.raw`\nroot        ::= \"{\" ws \"\\\"implications\\\"\" ws \":\" ws implications ws \",\" ws \"\\\"unknowns\\\"\" ws \":\" ws strings ws \"}\"\nimplications ::= \"[\" ws (implication (ws \",\" ws implication)*)? ws \"]\"\nimplication ::= \"{\" ws \"\\\"finding_id\\\"\" ws \":\" ws string ws \",\" ws \"\\\"implication\\\"\" ws \":\" ws string ws \",\" ws \"\\\"remediation_intent\\\"\" ws \":\" ws string ws \"}\"\nstrings     ::= \"[\" ws (string (ws \",\" ws string)*)? ws \"]\"\nstring      ::= \"\\\"\" ([^\"\\\\] | \"\\\\\" [\"\\\\/bfnrt])* \"\\\"\"\nws          ::= [ \\t\\n]*\n`;\n\nexport interface ExplainResult {\n  /** The model id recorded in `versions.model`. */\n  model: string;\n  quantization: string | null;\n  findings: ReviewFindings;\n}\n\n/** A local coder model suitable for `task: analysis`. */\nexport function pickExplainModel(models: LocalModel[] = discoverModels()): LocalModel | null {\n  // Prefer a coder-tuned GGUF; the spec's bake-off candidates first.\n  const preferred = [/qwen.*coder/i, /granite/i, /coder/i, /instruct/i];\n  for (const pattern of preferred) {\n    const hit = models.find((m) => pattern.test(m.name));\n    if (hit) return hit;\n  }\n  return models[0] ?? null;\n}\n\nfunction quantizationOf(name: string): string | null {\n  const m = name.match(/\\b(Q\\d(?:_K)?(?:_[SML])?|F16|BF16|Q\\d)\\b/i);\n  return m ? m[1].toUpperCase() : null;\n}\n\n/**\n * The capsule as a prompt. Bounded by construction — the capsule compiler has\n * already enforced the token budget, so this is a serialization, not a packer.\n */\nfunction buildPrompt(capsule: AnalysisCapsule, findings: ReviewFindings): string {\n  const findingLines = [...findings.architecture_findings, ...findings.security_findings].map(\n    (f) => `- ${f.id} (${f.kind}, ${f.severity}): ${f.claim}`,\n  );\n  return [\n    'Analysis capsule (facts only — every fact below was produced by a deterministic analyzer):',\n    JSON.stringify(capsule),\n    '',\n    'Deterministic findings:',\n    findingLines.join('\\n') || '(none)',\n    '',\n    'For each finding, state the implication the author may not have accounted for, and the',\n    'intent behind a fix. Add any unknown that the facts above do not settle.',\n    'You are not deciding whether this change merges. Do not claim anything is secure, safe,',\n    'approved, or free of vulnerabilities. Cite only finding ids listed above.',\n  ].join('\\n');\n}\n\n/**\n * Run the explain pass. Throws {@link CliError} with exit 6 when a model or the\n * inference binding is unavailable — never returns un-explained findings while\n * claiming otherwise.\n */\nexport async function explainFindings(\n  capsule: AnalysisCapsule,\n  findings: ReviewFindings,\n  opts: { offline?: boolean; model?: LocalModel | null } = {},\n): Promise<ExplainResult> {\n  const model = opts.model ?? pickExplainModel();\n  if (!model) {\n    throw new CliError(\n      '`--explain` needs a local model and none was found — install one (`vg models install`) or drop `--explain` to run the deterministic review',\n      ExitCode.ENGINE_UNAVAILABLE,\n    );\n  }\n\n  const ensured = await ensurePackage('node-llama-cpp@^3', {\n    consent: false,\n    local: opts.offline === true,\n    interactive: false,\n  });\n  if (!ensured.module) {\n    throw new CliError(\n      '`--explain` needs the local inference binding (node-llama-cpp) and it is not installed — run `vg models install`, or drop `--explain`',\n      ExitCode.ENGINE_UNAVAILABLE,\n    );\n  }\n\n  const host = new EmbeddedLlmHost();\n  host.setBinding(ensured.module);\n  host.setPreferGrammar(true);\n  await host.load(model.path);\n\n  let raw: string;\n  try {\n    const result = await host.generate(\n      [\n        {\n          role: 'system',\n          content:\n            'You are the explanation layer of an architecture review. You annotate deterministic findings. You never decide, never invent evidence, and never assert that code is secure.',\n        },\n        { role: 'user', content: buildPrompt(capsule, findings) },\n      ],\n      { grammar: EXPLAIN_GRAMMAR, requireGrammar: true, temperature: 0, maxTokens: 1024 },\n    );\n    raw = result.text;\n  } finally {\n    await host.unload();\n  }\n\n  return {\n    model: model.name,\n    quantization: quantizationOf(model.name),\n    findings: mergeExplanations(findings, raw),\n  };\n}\n\n/**\n * Fold the model's annotations into the findings document. Unparseable output\n * is dropped, not guessed at — the deterministic findings stand on their own,\n * and the receipt still records which model was consulted.\n */\nexport function mergeExplanations(findings: ReviewFindings, raw: string): ReviewFindings {\n  let parsed: { implications?: { finding_id: string; implication: string; remediation_intent: string }[]; unknowns?: string[] };\n  try {\n    parsed = JSON.parse(raw) as typeof parsed;\n  } catch {\n    return findings;\n  }\n  const byId = new Map((parsed.implications ?? []).map((i) => [i.finding_id, i]));\n  const annotate = (f: ReviewFinding): ReviewFinding => {\n    const hit = byId.get(f.id);\n    if (!hit) return f;\n    return {\n      ...f,\n      claim: `${f.claim} ${hit.implication}`.trim(),\n      remediation: hit.remediation_intent?.trim() ? hit.remediation_intent.trim() : f.remediation,\n      source: 'model',\n    };\n  };\n  const modelUnknowns = (parsed.unknowns ?? []).filter((u) => typeof u === 'string' && u.trim());\n  return {\n    ...findings,\n    architecture_findings: findings.architecture_findings.map(annotate),\n    security_findings: findings.security_findings.map(annotate),\n    unknowns: [...new Set([...findings.unknowns, ...modelUnknowns])],\n  };\n}\n"]}

package/dist/{graph-backend-JXARVT3R.js → graph-backend-V5A2H5ZB.js}

@@ -1,16 +1,16 @@
-export { localGraphBackend, resolveGraphBackend, vgdGraphBackend } from './chunk-JAEHLTVX.js';
+export { localGraphBackend, resolveGraphBackend, vgdGraphBackend } from './chunk-5RW5PIBH.js';
 import './chunk-J7LKEB2R.js';
-import './chunk-K3SXWOTT.js';
+import './chunk-YL332BU2.js';
 import './chunk-VHRSG6CF.js';
 import './chunk-6H2QV5DR.js';
-import './chunk-FQHWPOTS.js';
-import './chunk-OIUVWCKM.js';
+import './chunk-BA6YBVNT.js';
+import './chunk-FPIMNVLI.js';
 import './chunk-MVPRPSXU.js';
 import './chunk-O3LABX6I.js';
-import './chunk-G3ACLBMG.js';
+import './chunk-UGRUG2FA.js';
 import './chunk-XP6UUCZZ.js';
 import './chunk-JFGYT6BI.js';
 import './chunk-XQNKCA2J.js';
 import './chunk-Z6ZWNWWR.js';
-//# sourceMappingURL=graph-backend-JXARVT3R.js.map
-//# sourceMappingURL=graph-backend-JXARVT3R.js.map
+//# sourceMappingURL=graph-backend-V5A2H5ZB.js.map
+//# sourceMappingURL=graph-backend-V5A2H5ZB.js.map

package/dist/{graph-backend-JXARVT3R.js.map → graph-backend-V5A2H5ZB.js.map}

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"graph-backend-JXARVT3R.js"}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"graph-backend-V5A2H5ZB.js"}

package/dist/index.d.ts

@@ -2,7 +2,7 @@ import { G as GraphNode, a as GraphEdge, A as Area, R as ResolverKind, V as VgGr
 export { e as AnalysisTier, C as Centrality, D as DerivedBy, f as EpistemicTier, g as FactConfidence, h as FactKind, i as GraphMeta, j as GraphSummaries, H as HubBlastSummary, N as NodeKind, P as Provenance, k as SUPPORTED_SCHEMA_VERSIONS, l as Span, m as SupportedSchemaVersion, T as Toolchain, U as Unknown } from './types-DHqH0XIE.js';
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 
-declare const VERSION = "2026.825.2";
+declare const VERSION = "2026.829.1";
 
 /**
  * Analysis stage: importance, centrality, hubs, communities, and surprise.
@@ -343,16 +343,6 @@ declare function preferInRepoGraph(env?: NodeJS.ProcessEnv): boolean;
  * overwrite another ref's on-disk map.
  */
 declare function defaultGraphPath(root: string, env?: NodeJS.ProcessEnv): string;
-/**
- * Resolve where to **read** the map from.
- * Order: explicit override → legacy in-repo when `VIBGRATE_GRAPH_IN_REPO` is set
- * → branch-keyed global (if on a git ref) → `current` global snapshot →
- * legacy in-repo → default write path.
- *
- * The in-repo env short-circuit matters for CI and the release benchmark: they
- * force portable `.vibgrate/graph.json` artifacts and must not pay a synchronous
- * `git rev-parse` (or prefer a leftover global snapshot) on every resolve.
- */
 declare function resolveGraphPath(root: string, override?: string, env?: NodeJS.ProcessEnv): string;
 declare function writeArtifacts(graph: VgGraph, options: WriteOptions): WrittenArtifacts;
 
@@ -572,11 +562,135 @@ type EmbedProgress = (done: number, total: number) => void;
  */
 declare function getNodeEmbeddings(graph: VgGraph, embedder: Embedder, root: string, onProgress?: EmbedProgress): Promise<Map<string, number[]>>;
 
+interface RelevanceExpansion {
+    /** Single lowercase word, ready for identifier-part matching. */
+    term: string;
+    /** The question token/phrase (or topic id) that produced it. */
+    from: string;
+    /** 0..1 relative confidence; scales the expansion's scoring contribution. */
+    weight: number;
+}
+interface RelevanceTopic {
+    id: string;
+    /** 0..1, normalized within one analysis. */
+    score: number;
+}
+/** One level of a matched taxonomy path, root-first. */
+interface RelevanceTaxonomyLevel {
+    id: string;
+    path: string;
+    /** 0..1 — never lower than the levels beneath it. */
+    score: number;
+    /** This level's own vocabulary. */
+    terms: string[];
+}
+/** A hierarchical match: the most specific node plus its ancestor chain. */
+interface RelevanceTaxonomyMatch {
+    /** "infrastructure/networking/dns/cname" */
+    path: string;
+    levels: RelevanceTaxonomyLevel[];
+    score: number;
+    /** Absolute evidence behind the match, not relative to other matches. */
+    evidence: number;
+    /** What matched — "~" prefixes a fuzzy repair. */
+    via: string[];
+    /** The matched node's OWN vocabulary, for explaining the domain. */
+    terms: string[];
+    /** Filenames and extensions this node's work lives in, nearest first. */
+    files: string[];
+    /** Standards governing this node, current revision first. */
+    standards: RelevanceStandard[];
+}
+/** A product the ask names, including through a misspelling. */
+interface RelevanceVendorMatch {
+    name: string;
+    from: string;
+    node?: string;
+    topic: string;
+    score: number;
+    /** Filenames and extensions this vendor's configuration lives in. */
+    files: string[];
+}
+/** A standard governing the matched area, at the revision the pack tracks. */
+interface RelevanceStandard {
+    name: string;
+    publisher: string;
+    node: string;
+    /** "standard" or "regulation". */
+    kind: string;
+    /** Lowercase category slugs from the website's own vocabulary. */
+    categories: string[];
+}
+/** A misspelling the provider resolved. */
+interface RelevanceCorrection {
+    from: string;
+    to: string;
+    distance: number;
+}
+interface RelevanceAnalysis {
+    version: string;
+    topics: RelevanceTopic[];
+    expansions: RelevanceExpansion[];
+    /** Hierarchical matches, most specific first. Absent from older providers. */
+    taxonomy?: RelevanceTaxonomyMatch[];
+    vendors?: RelevanceVendorMatch[];
+    corrections?: RelevanceCorrection[];
+    /** Every file hint the analysis implies, most specific first. */
+    files?: string[];
+    /** Standards governing what the ask is about, most specific node first. */
+    standards?: RelevanceStandard[];
+    /** Deduped lowercase category slugs across those standards. */
+    categories?: string[];
+}
+/** One graph symbol, as handed to the provider's ranker: identity and name
+ *  material only — never source contents. */
+interface RankableSymbol {
+    id: string;
+    name: string;
+    qualifiedName: string;
+    file: string;
+    importance: number;
+}
+interface RankOptions {
+    limit?: number;
+    priorQuestion?: string | null;
+    topicTags?: Record<string, readonly string[]> | null;
+}
 interface RankedSeed {
     id: string;
     score: number;
     why: string;
 }
+/** The provider's full ranking answer (schema 5), pre-sanitization. */
+interface RankResult {
+    version: string;
+    hasContent: boolean;
+    seeds: RankedSeed[];
+    conceptMap: string[];
+}
+interface RelevanceProvider {
+    version(): string;
+    analyzeQuery(question: string): RelevanceAnalysis;
+    /** Optional build-time enrichment: deterministic topic tags for one node
+     *  (path + identifier evidence). Providers without it still work. */
+    tagNode?(input: {
+        qualifiedName: string;
+        file: string;
+    }): string[];
+    /**
+     * Schema-5: rank the given symbols for one ask. When present, the module
+     * IS the relevance engine — the host delegates seed selection here and
+     * keeps only mechanical name matching as its module-less fallback. A
+     * provider without it is treated as no ranking engine at all.
+     */
+    rankSymbols?(question: string, symbols: RankableSymbol[], opts?: RankOptions): RankResult;
+}
+/**
+ * Load the optional relevance provider. Memoized per process; returns `null`
+ * when disabled, not installed, or the module fails to load or violates the
+ * contract — callers treat `null` as "no analysis" and proceed unchanged.
+ */
+declare function loadRelevanceProvider(): Promise<RelevanceProvider | null>;
 /** Sanitized module ranking, ready for `queryGraph({ ranked })`. */
 interface SanitizedRank {
     version: string;
@@ -584,6 +698,27 @@ interface SanitizedRank {
     seeds: RankedSeed[];
     conceptMap: string[];
 }
+/**
+ * Rank a question over a graph's symbols via the installed module. Returns
+ * `null` when no module is installed, the installed module predates the
+ * ranking API, or its output fails sanitization — callers fall back to the
+ * host's mechanical matcher and proceed unchanged. Every failure path is a
+ * degrade, never an error.
+ */
+declare function rankQuestion(graph: {
+    nodes: Array<{
+        id: string;
+        name: string;
+        qualifiedName: string;
+        file: string;
+        kind: string;
+        importance: number;
+    }>;
+}, question: string, opts?: {
+    limit?: number;
+    priorQuestion?: string | null;
+    topicTags?: Map<string, readonly string[]> | null;
+}): Promise<SanitizedRank | null>;
 
 /**
  * Retrieval front-end for `vg ask` / `vg code` capsule seeds (VG-CLI-SPEC
@@ -1472,6 +1607,12 @@ interface RefreshOptions {
      * exists (falls back to a fresh `defaultGraphPath` resolution).
      */
     graphPath?: string;
+    /**
+     * Live progress during the parse phase. A refresh is silent by default —
+     * callers own their surface — but `vg review`'s auto-prep needs to show a
+     * bar, because there the rebuild is the thing the user is waiting on.
+     */
+    onParseProgress?: (done: number, total: number) => void;
 }
 type RefreshOutcome = 
 /** Map already matches the working tree. */
@@ -2101,6 +2242,39 @@ declare function moduleInstalled(): {
     version?: string;
 };
 
+/**
+ * Topic tags for every scorable node of THIS graph, computed through the
+ * provider and cached in the graph's own sidecar. Returns `null` when no
+ * provider (or none with `tagNode`) is active — callers treat that as "no
+ * enrichment" and proceed unchanged.
+ *
+ * `graphPath` should be the path the graph was actually loaded from (the MCP
+ * server and `vg ask` pass it); when omitted it is re-resolved from the root
+ * with the same branch-keyed rules `loadGraph` uses, so the sidecar always
+ * sits beside the graph the current workspace state resolves to.
+ */
+declare function loadTopicTags(graph: VgGraph, root: string, graphPath?: string): Promise<Map<string, readonly string[]> | null>;
+
+/**
+ * Return only the user-authored portion of an instruction, dropping trailing
+ * host appendixes (attachments, @-mention / active-editor context). Unchanged
+ * when no appendix.
+ */
+declare function userAskFromInstruction(instruction: string): string;
+/**
+ * The ask the RANKER sees. Same as {@link userAskFromInstruction}: host
+ * appendixes stripped, user text otherwise intact.
+ *
+ * An earlier revision also deleted scope-fence sentences ("do not change the
+ * tax helper", "leave X alone") before ranking. That recovered 0 of the −5 pt
+ * fenced-ask penalty it targeted (docs/graph/VG-ASK-LENGTH-CAPSULE-ANALYSIS.md
+ * §7.3) and is sentence-level deletion — a negation can be a fence or the
+ * defect itself. It is not shipped. The alias stays so every caller
+ * (`vg code`, `vg ask`, MCP, token-bench) keeps one name for "the ranking
+ * input" without a second transformation.
+ */
+declare function rankingAskFrom(instruction: string): string;
+
 /** The graph-grounded context handed to the model, plus what fed it. */
 interface CodeContext {
     instruction: string;
@@ -2354,9 +2528,36 @@ declare function sourceTokenMass(contents: Iterable<string>): number;
  * names (F0/F1). Does not use the relevance module.
  */
 declare function askNamesSymbol(graph: VgGraph, instruction: string): boolean;
+/**
+ * @deprecated Not a shipped threshold — a compatibility shim. An earlier
+ * revision used 150 as an absolute ranking-score gate; it suppressed 3 of 114
+ * real measurements, all terse one-line symptom asks, two of which retrieve
+ * their target. Stand-down is now `rankConfidence === 0` only. Exported at 1
+ * so a harness comparing `confidence < MIN_RANK_CONFIDENCE` keeps compiling
+ * and matches the shipped rule (only honest-empty is suppressed).
+ */
+declare const MIN_RANK_CONFIDENCE = 1;
+/**
+ * Top ranking score from a module ranking, or null when there is nothing
+ * comparable to threshold — no module answered, or it returned no scored seed.
+ *
+ * **Zero means the module's honest-empty verdict** (`hasContent === false`):
+ * the ask named nothing this repo knows. Null means "no signal at all" and
+ * never suppresses. A weak but nonzero score is a real, if faint, match and
+ * compiles — a terse "invoice total is wrong" scoring 113 is the most common
+ * field shape there is, and silencing it is `vg code` feeling dumber.
+ */
+declare function rankConfidenceOf(ranked: {
+    hasContent?: boolean;
+    seeds?: Array<{
+        score?: number;
+    }>;
+} | null | undefined): number | null;
 declare function capsuleMode(input: {
     sourceTokens: number;
     askNamesSymbol: boolean;
+    /** Top module ranking score; 0 is the honest-empty verdict, null no signal. */
+    rankConfidence?: number | null;
 }): CapsuleMode;
 interface WholeRepoFile {
     path: string;
@@ -2372,8 +2573,11 @@ interface WholeRepoPacket {
  * First-turn packet = the mapped files, not a ranked dump. Files are sorted
  * by path. `budget` caps the paste (default {@link WHOLE_REPO_MAX_SOURCE_TOKENS});
  * at least one file is always included when any exist.
+ *
+ * The instruction is NOT echoed into the packet — the caller sends the ask as
+ * its own trailing turn, so echoing it here billed it twice per step.
  */
-declare function buildWholeRepoPacket(instruction: string, files: WholeRepoFile[], budget?: number): WholeRepoPacket;
+declare function buildWholeRepoPacket(files: WholeRepoFile[], budget?: number): WholeRepoPacket;
 
 /**
  * `search_symbols` — the hybrid flashlight next to the map
@@ -2424,4 +2628,4 @@ interface SearchResult {
 }
 declare function searchSymbols(graph: VgGraph, root: string, query: string, limit: number): Promise<SearchResult>;
 
-export { ASSISTANTS, type AnalyzeOptions, type AnalyzeResult, Area, type Assistant, type BuildCapsuleOptions, type BuildContextOptions, type BuildOptions, type BuildResult, type BuildScope, CAPSULE_COMPILER_ID, CAPSULE_RANKING_VERSION, COMPILE_MIN_SOURCE_TOKENS, type CapsuleMode, type CapsuleSummary, type CapsuleSymbolRef, type ClusterMode, type DepRecord, type DiscoverOptions, type DiscoveredFile, type Drift, type DriftInventory, type DriftNote, EdgeKind, type Embedder, type ExportContext, type ExportFormat, FREE_PACK, Fact, FileParse, GraphEdge, GraphIndex, GraphNode, GraphSource, type GraphUploadEnvelope, GroundingEdge, GroundingKind, type ImpactItem, type ImpactResult, type KnowledgePack, LANGUAGES, type LanguageDef, type LibCatalog, type LibEntry, type LibSource, type LoadEmbedderOptions, type LocalModel, type ModuleResolver, type PackEntry, type PathResult, type ProbeResult, type QueryMatch, type QueryOptions, type QueryResult, type RefreshOptions, type RefreshOutcome, ResolverKind, ResourceLimitError, type ResourceLimits, SCHEMA_VERSION, SKIP_DIRS, SKIP_FILES, type SavingsReport, type ScipDocument, type ScipIndex, type ScipOccurrence, type SearchResult, type SemanticQueryOptions, type ServeOptions, type SourceSlice, type SymbolHit, TASK_CAPSULE_SCHEMA_VERSION, TOOLS, type TaskCapsule, type TextHit, UsageError, VERSION, type VerifyResult, VgGraph, type VgTool, WHOLE_REPO_MAX_SOURCE_TOKENS, type WholeRepoFile, type WholeRepoPacket, type WriteOptions, type WrittenArtifacts, addLibrary, allLanguageIds, analyze, applyCoverage, applyStaticTestLinkage, askNamesSymbol, assistantById, buildCodeContext, buildEnvelope, buildFacts, buildGraph, buildModuleResolver, buildTaskCapsule, buildWholeRepoPacket, capsuleMode, capsuleToCodeContext, cosine, coveringTests, createServer, decodeScipIndex, defaultGraphPath, inventory as dependencyInventory, detectRunner, discover, discoverModels, driftCount, driftFor, embeddingsCached, embeddingsPath, embeddingsPathFor, enrichOnline, exportGraph, findNodes, formatForExt, getNodeEmbeddings, grammarsSourceDir, groundGraph, hasDrift, identifierParts, impactOf, installAssistant, isTestFile, langById, langForExtension, legacyGraphPath, libId, loadCatalog, loadCoverage, loadEmbedder, loadGraph, loadSnapshot, mappedFilePaths, nodeById, nodeEmbedText, parseGraph, parseJsonc, parseSource, preferInRepoGraph, probeFreshness, queryGraph, queryGraphSemantic, readDoc, readSavings, recordSaving, redactGraph, refreshIfStale, relativeResolver, moduleInstalled as relevanceModuleInstalled, renderHtml, renderReport, resolveGraphPath, resolveLib, resolveLimits, resolveOne, saveCatalog, savingsRecorded, scipEdges, searchSymbols, serializeGraph, serveStdio, shortestPath, sourceTokenMass, stableStringify, summarizeCapsule, testsToRun, uninstallAssistant, verifyDeterminism, vibgrateDir, writeArtifacts, writeSnapshot };
+export { ASSISTANTS, type AnalyzeOptions, type AnalyzeResult, Area, type Assistant, type BuildCapsuleOptions, type BuildContextOptions, type BuildOptions, type BuildResult, type BuildScope, CAPSULE_COMPILER_ID, CAPSULE_RANKING_VERSION, COMPILE_MIN_SOURCE_TOKENS, type CapsuleMode, type CapsuleSummary, type CapsuleSymbolRef, type ClusterMode, type DepRecord, type DiscoverOptions, type DiscoveredFile, type Drift, type DriftInventory, type DriftNote, EdgeKind, type Embedder, type ExportContext, type ExportFormat, FREE_PACK, Fact, FileParse, GraphEdge, GraphIndex, GraphNode, GraphSource, type GraphUploadEnvelope, GroundingEdge, GroundingKind, type ImpactItem, type ImpactResult, type KnowledgePack, LANGUAGES, type LanguageDef, type LibCatalog, type LibEntry, type LibSource, type LoadEmbedderOptions, type LocalModel, MIN_RANK_CONFIDENCE, type ModuleResolver, type PackEntry, type PathResult, type ProbeResult, type QueryMatch, type QueryOptions, type QueryResult, type RankedSeed, type RefreshOptions, type RefreshOutcome, type RelevanceProvider, ResolverKind, ResourceLimitError, type ResourceLimits, SCHEMA_VERSION, SKIP_DIRS, SKIP_FILES, type SanitizedRank, type SavingsReport, type ScipDocument, type ScipIndex, type ScipOccurrence, type SearchResult, type SemanticQueryOptions, type ServeOptions, type SourceSlice, type SymbolHit, TASK_CAPSULE_SCHEMA_VERSION, TOOLS, type TaskCapsule, type TextHit, UsageError, VERSION, type VerifyResult, VgGraph, type VgTool, WHOLE_REPO_MAX_SOURCE_TOKENS, type WholeRepoFile, type WholeRepoPacket, type WriteOptions, type WrittenArtifacts, addLibrary, allLanguageIds, analyze, applyCoverage, applyStaticTestLinkage, askNamesSymbol, assistantById, buildCodeContext, buildEnvelope, buildFacts, buildGraph, buildModuleResolver, buildTaskCapsule, buildWholeRepoPacket, capsuleMode, capsuleToCodeContext, cosine, coveringTests, createServer, decodeScipIndex, defaultGraphPath, inventory as dependencyInventory, detectRunner, discover, discoverModels, driftCount, driftFor, embeddingsCached, embeddingsPath, embeddingsPathFor, enrichOnline, exportGraph, findNodes, formatForExt, getNodeEmbeddings, grammarsSourceDir, groundGraph, hasDrift, identifierParts, impactOf, installAssistant, isTestFile, langById, langForExtension, legacyGraphPath, libId, loadCatalog, loadCoverage, loadEmbedder, loadGraph, loadRelevanceProvider, loadSnapshot, loadTopicTags, mappedFilePaths, nodeById, nodeEmbedText, parseGraph, parseJsonc, parseSource, preferInRepoGraph, probeFreshness, queryGraph, queryGraphSemantic, rankConfidenceOf, rankQuestion, rankingAskFrom, readDoc, readSavings, recordSaving, redactGraph, refreshIfStale, relativeResolver, moduleInstalled as relevanceModuleInstalled, renderHtml, renderReport, resolveGraphPath, resolveLib, resolveLimits, resolveOne, saveCatalog, savingsRecorded, scipEdges, searchSymbols, serializeGraph, serveStdio, shortestPath, sourceTokenMass, stableStringify, summarizeCapsule, testsToRun, uninstallAssistant, userAskFromInstruction, verifyDeterminism, vibgrateDir, writeArtifacts, writeSnapshot };