@vibgrate/cli 2026.704.3 → 2026.708.2

package/dist/index.d.ts

@@ -1,8 +1,8 @@
-import { G as GraphNode, a as GraphEdge, A as Area, R as ResolverKind, V as VgGraph, F as FileParse, E as EdgeKind, b as Fact, c as GroundingKind, d as GroundingEdge } from './types-C6ZyQpa9.js';
-export { C as Centrality, D as DerivedBy, e as FactConfidence, f as FactKind, g as GraphMeta, N as NodeKind, P as Provenance, S as SCHEMA_VERSION, h as Span } from './types-C6ZyQpa9.js';
+import { G as GraphNode, a as GraphEdge, A as Area, R as ResolverKind, V as VgGraph, F as FileParse, E as EdgeKind, b as Fact, c as GroundingKind, d as GroundingEdge } from './types-CXnp1uGj.js';
+export { C as Centrality, D as DerivedBy, e as EpistemicTier, f as FactConfidence, g as FactKind, h as GraphMeta, N as NodeKind, P as Provenance, S as SCHEMA_VERSION, i as Span, T as Toolchain, U as Unknown } from './types-CXnp1uGj.js';
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 
-declare const VERSION = "2026.704.3";
+declare const VERSION = "2026.708.2";
 
 /**
  * Analysis stage: importance, centrality, hubs, communities, and surprise.
@@ -107,9 +107,25 @@ declare function parseJsonc<T = unknown>(text: string): T;
  * dropping ambiguity). SCIP/stack-graphs rungs slot in above it later, recorded
  * via `edge.resolution`.
  */
+/**
+ * A reference the heuristic resolver could not connect to a definition — the raw
+ * material for `vg unknowns`. `from` is the node id of the enclosing definition
+ * (or file) where the reference occurs; `name` is the callee/type it names. We
+ * keep the source-relative path so a later precise rung that covers this file can
+ * suppress the unknown (the compiler is authoritative there).
+ */
+interface UnresolvedRef {
+    from: string;
+    name: string;
+    kind: 'call' | 'extends' | 'implements';
+    count: number;
+    fromRel: string;
+}
 interface ResolveResult {
     nodes: GraphNode[];
     edges: GraphEdge[];
+    /** References the heuristic rung could not resolve (deduped, sorted). */
+    unresolved: UnresolvedRef[];
     /** Diagnostic counts, surfaced by `vg status`. */
     stats: {
         callsResolved: number;
@@ -880,9 +896,17 @@ interface LocalModel {
 }
 declare function discoverModels(home?: string): LocalModel[];
 
+/**
+ * Outcome of a recorded navigation call:
+ *  - `complete` — returned results, with nothing capped or paginated;
+ *  - `partial`  — returned results, but more were available/truncated;
+ *  - `miss`     — returned no result (no match, not-found, not-connected).
+ */
+type Outcome = 'complete' | 'partial' | 'miss';
 interface SavingEntry {
     ts: number;
     tool: string;
+    outcome?: Outcome;
     vgTokens: number;
     baselineTokens: number;
 }
@@ -1005,7 +1029,7 @@ declare function uninstallAssistant(a: Assistant, root: string, purge: boolean):
  * import covers the same need offline). CycloneDX/SPDX power the SBOM/AI-BOM seam
  * (VG-LOCAL-MODELS §9.4).
  */
-type ExportFormat = 'json' | 'ndjson' | 'graphml' | 'dot' | 'cypher' | 'md' | 'html' | 'cyclonedx' | 'spdx';
+type ExportFormat = 'json' | 'ndjson' | 'graphml' | 'dot' | 'cypher' | 'sql' | 'md' | 'html' | 'cyclonedx' | 'spdx';
 declare function formatForExt(ext: string): ExportFormat | null;
 interface ExportContext {
     graph: VgGraph;

package/dist/index.js

@@ -1,6 +1,6 @@
-export { ASSISTANTS, FREE_PACK, GraphIndex, GraphSource, ResourceLimitError, SCHEMA_VERSION, SKIP_DIRS, SKIP_FILES, TOOLS, UsageError, addLibrary, analyze, applyCoverage, applyStaticTestLinkage, assistantById, buildFacts, buildGraph, buildModuleResolver, cosine, coveringTests, createServer, decodeScipIndex, defaultGraphPath, inventory as dependencyInventory, detectRunner, discover, discoverModels, driftCount, driftFor, enrichOnline, exportGraph, findNodes, formatForExt, getNodeEmbeddings, groundGraph, hasDrift, identifierParts, impactOf, installAssistant, isTestFile, libId, loadCatalog, loadCoverage, loadEmbedder, loadGraph, loadSnapshot, nodeById, nodeEmbedText, parseGraph, parseJsonc, probeFreshness, queryGraph, queryGraphSemantic, readDoc, readSavings, recordSaving, refreshIfStale, relativeResolver, renderHtml, renderReport, resolveLib, resolveLimits, resolveOne, saveCatalog, savingsRecorded, scipEdges, serializeGraph, serveStdio, shortestPath, stableStringify, testsToRun, uninstallAssistant, verifyDeterminism, vibgrateDir, writeArtifacts, writeSnapshot } from './chunk-JL7FIC6W.js';
+export { ASSISTANTS, FREE_PACK, GraphIndex, GraphSource, ResourceLimitError, SCHEMA_VERSION, SKIP_DIRS, SKIP_FILES, TOOLS, UsageError, addLibrary, analyze, applyCoverage, applyStaticTestLinkage, assistantById, buildFacts, buildGraph, buildModuleResolver, cosine, coveringTests, createServer, decodeScipIndex, defaultGraphPath, inventory as dependencyInventory, detectRunner, discover, discoverModels, driftCount, driftFor, enrichOnline, exportGraph, findNodes, formatForExt, getNodeEmbeddings, groundGraph, hasDrift, identifierParts, impactOf, installAssistant, isTestFile, libId, loadCatalog, loadCoverage, loadEmbedder, loadGraph, loadSnapshot, nodeById, nodeEmbedText, parseGraph, parseJsonc, probeFreshness, queryGraph, queryGraphSemantic, readDoc, readSavings, recordSaving, refreshIfStale, relativeResolver, renderHtml, renderReport, resolveLib, resolveLimits, resolveOne, saveCatalog, savingsRecorded, scipEdges, serializeGraph, serveStdio, shortestPath, stableStringify, testsToRun, uninstallAssistant, verifyDeterminism, vibgrateDir, writeArtifacts, writeSnapshot } from './chunk-AWEAREOE.js';
 export { LANGUAGES, allLanguageIds, grammarsSourceDir, langById, langForExtension, parseSource } from './chunk-X5YT263H.js';
-export { VERSION } from './chunk-YN5OGRWU.js';
+export { VERSION } from './chunk-ICBBG6U3.js';
 import { redactUrlCredentials, redactSecrets } from './chunk-RXP66R2E.js';
 import './chunk-GI6W53LM.js';
 import { execFileSync } from 'child_process';

package/dist/parse-worker.d.ts

@@ -1,4 +1,4 @@
-import { F as FileParse } from './types-C6ZyQpa9.js';
+import { F as FileParse } from './types-CXnp1uGj.js';
 
 /**
  * tinypool worker entry. Receives a chunk of files, reads and parses each, and

package/dist/{types-C6ZyQpa9.d.ts → types-CXnp1uGj.d.ts}

@@ -8,6 +8,23 @@
  */
 declare const SCHEMA_VERSION: "vg-graph/1.0";
 type ResolverKind = 'scip' | 'stackgraph' | 'tsc' | 'heuristic';
+/** Coarse, honest resolution tier for an edge (see engine/epistemic.ts). */
+type EpistemicTier = 'observed' | 'name-matched' | 'declared';
+/**
+ * The toolchain that produced this graph — the reproducibility fingerprint.
+ * Everything here deterministically affects graph *content* (parse trees change
+ * between grammar releases; resolvers change which edges resolve), so a CI run
+ * and a laptop run that disagree can be caught by comparing `fingerprint`.
+ * Deliberately excludes the Node/OS version so the graph stays byte-stable
+ * across host runtimes; `fingerprint` pins the parse/resolve toolchain only.
+ */
+interface Toolchain {
+    schema: string;
+    tool: string;
+    grammars: string;
+    resolvers: ResolverKind[];
+    fingerprint: string;
+}
 interface Provenance {
     tool: 'vg';
     version: string;
@@ -16,6 +33,7 @@ interface Provenance {
     deep: boolean;
     semanticModel?: string;
     corpusHash: string;
+    toolchain?: Toolchain;
 }
 interface GraphMeta {
     root: string;
@@ -68,6 +86,7 @@ interface GraphEdge {
     dst: string;
     resolution: ResolverKind;
     confidence: number;
+    epistemic?: EpistemicTier;
     surprise?: number;
     count?: number;
 }
@@ -94,6 +113,18 @@ interface Fact {
         span: Span;
     }[];
 }
+/**
+ * A reference the graph could not resolve — surfaced by `vg unknowns`. Reporting
+ * what it *cannot* connect (ranked by blast radius) is the honest inverse of a
+ * scanner that hides its unknowns. Only unknowns the precise rungs (tsc/scip)
+ * did not supersede are recorded, so a compiler-resolved file never shows here.
+ */
+interface Unknown {
+    from: string;
+    name: string;
+    kind: 'call' | 'extends' | 'implements';
+    count: number;
+}
 type GroundingKind = 'should_follow' | 'smells_like' | 'relevant_to';
 interface GroundingEdge {
     src: string;
@@ -116,6 +147,7 @@ interface VgGraph {
     areas: Area[];
     facts?: Fact[];
     grounding?: GroundingEdge[];
+    unknowns?: Unknown[];
 }
 
 /** A definition extracted from one file (pre-resolution, pre-id). */
@@ -165,4 +197,4 @@ interface FileParse {
     warnings?: string[];
 }
 
-export { type Area as A, type Centrality as C, type DerivedBy as D, type EdgeKind as E, type FileParse as F, type GraphNode as G, type NodeKind as N, type Provenance as P, type ResolverKind as R, SCHEMA_VERSION as S, type VgGraph as V, type GraphEdge as a, type Fact as b, type GroundingKind as c, type GroundingEdge as d, type FactConfidence as e, type FactKind as f, type GraphMeta as g, type Span as h };
+export { type Area as A, type Centrality as C, type DerivedBy as D, type EdgeKind as E, type FileParse as F, type GraphNode as G, type NodeKind as N, type Provenance as P, type ResolverKind as R, SCHEMA_VERSION as S, type Toolchain as T, type Unknown as U, type VgGraph as V, type GraphEdge as a, type Fact as b, type GroundingKind as c, type GroundingEdge as d, type EpistemicTier as e, type FactConfidence as f, type FactKind as g, type GraphMeta as h, type Span as i };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibgrate/cli",
-  "version": "2026.704.3",
+  "version": "2026.708.2",
   "description": "vg — local codebase intelligence CLI + MCP server for AI coding agents: deterministic code graph, drift reporting, and version-correct library docs (Apache-2.0)",
   "type": "module",
   "license": "Apache-2.0",
@@ -90,12 +90,12 @@
   "devDependencies": {
     "@types/node": "^26.1.0",
     "@types/semver": "^7.5.0",
-    "@typescript-eslint/eslint-plugin": "^8.61.0",
+    "@typescript-eslint/eslint-plugin": "^8.62.1",
     "@typescript-eslint/parser": "^8.62.1",
     "eslint": "^10.6.0",
     "graphology-types": "^0.24.8",
     "tsup": "^8.0.0",
-    "tsx": "^4.22.4",
+    "tsx": "^4.23.0",
     "vitest": "^4.0.0"
   },
   "engines": {

package/dist/baseline-64EUPWUH.js

@@ -1,6 +0,0 @@
-export { baselineCommand, runBaseline } from './chunk-WHQRV66O.js';
-import './chunk-YN5OGRWU.js';
-import './chunk-RXP66R2E.js';
-import './chunk-GI6W53LM.js';
-//# sourceMappingURL=baseline-64EUPWUH.js.map
-//# sourceMappingURL=baseline-64EUPWUH.js.map