@vibgrate/cli 2026.728.3 → 2026.728.5

package/dist/baseline-Y5FBYWNJ.js

@@ -0,0 +1,8 @@
+export { baselineCommand, runBaseline } from './chunk-SGI5ZP2Y.js';
+import './chunk-4JD63RUR.js';
+import './chunk-CRAMOEBE.js';
+import './chunk-RXP66R2E.js';
+import './chunk-GI6W53LM.js';
+import './chunk-Z6ZWNWWR.js';
+//# sourceMappingURL=baseline-Y5FBYWNJ.js.map
+//# sourceMappingURL=baseline-Y5FBYWNJ.js.map

package/dist/{baseline-PPZJBYAJ.js.map → baseline-Y5FBYWNJ.js.map}

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

package/dist/{chunk-A2IYFNCQ.js → chunk-2ZHWF7C6.js}

@@ -1,11 +1,12 @@
-import { buildAgentMessages, redactSecrets, unifiedDiff, applyEdit } from './chunk-YF43FOPP.js';
-import { localGraphBackend } from './chunk-HK3AWUXH.js';
+import { buildAgentMessages, redactSecrets, unifiedDiff, applyEdit } from './chunk-RZEXHDCF.js';
+import { localGraphBackend } from './chunk-TCJTQGAO.js';
 import { buildIdentifierTrieFromGraph, KvBlockRegistry, graphDraftCandidates, extractIdentifiers, scanIdentifiersAgainstTrie } from './chunk-JIBOJTGS.js';
-import { resolve, resolveLib, loadCatalog, readDoc, localPackageDocs, resolveVersion } from './chunk-6AXHLQBV.js';
-import { summarizeCapsule, buildCodeContext, buildTaskCapsule, capsuleToCodeContext, recordCliCall, CLI_TOOL_ALIASES, CAPSULE_RANKING_VERSION } from './chunk-ZBTY6VV4.js';
+import { resolve } from './chunk-IPICO2RV.js';
+import { searchSymbols, resolveLib, loadCatalog, readDoc, localPackageDocs, resolveVersion } from './chunk-G4HTI4ZM.js';
+import { summarizeCapsule, CAPSULE_RANKING_VERSION, buildCodeContext, buildTaskCapsule, capsuleToCodeContext, recordCliCall, CLI_TOOL_ALIASES } from './chunk-US2DAKCM.js';
 import { resolveOne } from './chunk-J7LKEB2R.js';
-import { impactOf } from './chunk-6UK6QPTR.js';
-import { parseSource, langForExtension } from './chunk-ON25BX6T.js';
+import { isLocateOnlyInstruction, extractLiteralNeedles, impactOf } from './chunk-EETK7S43.js';
+import { parseSource, langForExtension } from './chunk-UTNNGKKX.js';
 import { repositoryIdFromRoot } from './chunk-BWPBB45M.js';
 import { hashString, canonicalize } from './chunk-JFGYT6BI.js';
 import { spawnSync } from 'child_process';
@@ -1138,8 +1139,17 @@ var MAX_OUTPUT = 12e3;
 var AGENT_TOOLS = [
   {
     name: "search_code",
-    description: "Search the codebase by concept or identifier using the deterministic code graph (preferred over reading files blindly). Returns the most relevant symbols with file:line.",
-    parameters: { type: "object", properties: { query: { type: "string", description: 'What to find, e.g. "where auth failures are handled"' } }, required: ["query"] }
+    description: 'Search the codebase by identifier, concept, or exact string/URL. Uses the deterministic code graph for symbols, plus a literal text sweep for phrases, quoted strings, and URLs (preferred over reading files blindly). For "find every occurrence of \u2026", pass the exact needle (optionally quoted).',
+    parameters: {
+      type: "object",
+      properties: {
+        query: {
+          type: "string",
+          description: 'What to find, e.g. "scanDir", "where auth failures are handled", or a URL / "exact phrase"'
+        }
+      },
+      required: ["query"]
+    }
   },
   {
     name: "read_file",
@@ -1230,14 +1240,39 @@ var AGENT_TOOLS = [
       }
     }
   },
+  {
+    name: "ask_user",
+    description: "Ask the human a clarifying question when intent, scope, or preferred approach is ambiguous. Prefer this over guessing. The host shows the question and returns their answer. Do not use for pure code facts you can look up with search_code/read_file.",
+    parameters: {
+      type: "object",
+      properties: {
+        question: { type: "string", description: "Clear question for the user" },
+        options: {
+          type: "array",
+          items: { type: "string" },
+          description: "Optional short multiple-choice options (user may still type free text)"
+        }
+      },
+      required: ["question"]
+    }
+  },
   {
     name: "finish",
-    description: "Finish the task. Call this when the change is complete, with a short summary of what you did.",
-    parameters: { type: "object", properties: { summary: { type: "string" } }, required: ["summary"] }
+    description: "Finish the task. Pass a user-facing summary in Markdown: what changed (or what you found), key file:line refs, and any follow-ups. For Q&A / locate tasks, the summary IS the answer.",
+    parameters: {
+      type: "object",
+      properties: {
+        summary: {
+          type: "string",
+          description: "Markdown summary or answer shown in the VG Code panel"
+        }
+      },
+      required: ["summary"]
+    }
   },
   {
     name: "abort",
-    description: "Stop the task without further edits. Use when the request is impossible or the user intent is unclear.",
+    description: "Stop without further edits when the request is impossible. Prefer ask_user when intent is merely unclear.",
     parameters: {
       type: "object",
       properties: { reason: { type: "string", description: "Why the task is aborted" } },
@@ -1275,6 +1310,8 @@ async function executeTool(call, ctx) {
         return inspectChangeTool(ctx, a);
       case "verify_change":
         return verifyChange(ctx, str(a.command) || void 0);
+      case "ask_user":
+        return askUser(ctx, str(a.question), arrStr(a.options));
       case "finish":
         return { content: "done", mutated: false, finished: true, finalSummary: str(a.summary) || "done" };
       case "abort":
@@ -1291,8 +1328,74 @@ async function executeTool(call, ctx) {
     return { content: `tool ${call.name} failed: ${e.message}`, mutated: false };
   }
 }
+async function askUser(ctx, question, options) {
+  if (!question.trim()) return { content: "ask_user needs a question", mutated: false };
+  if (!ctx.askUser) {
+    return {
+      content: "No interactive host for ask_user (headless). Proceed with your best judgment, state assumptions, and call finish \u2014 or abort if you cannot continue safely.",
+      mutated: false
+    };
+  }
+  if (ctx.auto) {
+    return {
+      content: "Autonomous mode: no human available. Proceed with the safest default, state assumptions clearly in finish, and do not block on clarification.",
+      mutated: false
+    };
+  }
+  try {
+    const answer = await ctx.askUser({
+      question: question.trim(),
+      options: options?.map((o) => o.trim()).filter(Boolean).slice(0, 8)
+    });
+    const text = (answer ?? "").trim();
+    if (!text) {
+      return {
+        content: "User dismissed the question without answering. Ask once more only if essential; otherwise finish with open questions listed.",
+        mutated: false
+      };
+    }
+    return { content: `User answered:
+${text}`, mutated: false };
+  } catch (e) {
+    return { content: `ask_user failed: ${e.message}`, mutated: false };
+  }
+}
+function arrStr(v) {
+  if (!Array.isArray(v)) return void 0;
+  return v.map((x) => typeof x === "string" ? x : String(x ?? "")).filter(Boolean);
+}
 async function search(ctx, query) {
   if (!query) return { content: "search_code needs a query", mutated: false };
+  if (ctx.root) {
+    try {
+      const hybrid = await searchSymbols(ctx.graph, ctx.root, query, 20);
+      if (hybrid.matches.length > 0) {
+        const lines2 = hybrid.matches.map((m) => {
+          if ("preview" in m) {
+            return `- text ${m.file}:${m.line}  ${m.preview}`;
+          }
+          return `- ${m.name} (${m.kind}) ${m.file}:${m.line}  score ${m.score}`;
+        });
+        const parts = [`Matches for "${query}":`, ...lines2];
+        if (hybrid.totalTextMatches !== void 0) {
+          parts.push(
+            `(${hybrid.totalTextMatches} literal match(es) in tree${hybrid.moreAvailable ? "; list truncated \u2014 raise limit or narrow the needle" : ""})`
+          );
+        }
+        if (hybrid.hint) parts.push(hybrid.hint);
+        return { content: parts.join("\n"), mutated: false };
+      }
+      if (hybrid.totalTextMatches === 0 || /\s|https?:\/\//i.test(query) || /^["'`]/.test(query.trim())) {
+        const hint = hybrid.hint ? `
+${hybrid.hint}` : "";
+        return {
+          content: `no symbol or text match for "${query}".${hint}`,
+          mutated: false
+        };
+      }
+    } catch {
+    }
+  }
   const backend = ctx.graphBackend ?? localGraphBackend(ctx.graph);
   const res = await backend.search(query, { limit: 10 });
   if (res.matches.length === 0) return { content: `no symbols matched "${query}"`, mutated: false };
@@ -1916,6 +2019,45 @@ function shouldUsePatchIrGrammar(profile) {
   return false;
 }
 
+// src/code/locate-answer.ts
+function primaryLocateNeedle(instruction) {
+  const needles = extractLiteralNeedles(instruction);
+  if (needles.length === 0) return instruction.trim();
+  return [...needles].sort((a, b) => b.length - a.length)[0];
+}
+function formatLocateAnswer(needle, hits, total) {
+  if (hits.length === 0) {
+    return `No occurrences of \`${needle}\` in this workspace.
+(Literal search complete \u2014 0 matches.)`;
+  }
+  const lines = hits.slice(0, 20).map((h) => `- ${h.file}:${h.line}  ${h.preview.trim().slice(0, 120)}`);
+  const more = total > hits.length ? `
+\u2026 and ${total - hits.length} more (showing ${hits.length} of ${total}).` : total > 1 ? `
+(${total} occurrence${total === 1 ? "" : "s"}.)` : "";
+  return `Found \`${needle}\`:
+${lines.join("\n")}${more}`;
+}
+async function answerLocateInstruction(graph, root, instruction, limit = 30) {
+  const needle = primaryLocateNeedle(instruction);
+  const result = await searchSymbols(graph, root, needle, limit);
+  const hits = result.matches.filter((m) => m.kind === "text").map((m) => ({ file: m.file, line: m.line, preview: m.preview }));
+  const total = result.totalTextMatches ?? hits.length;
+  return {
+    needle,
+    hits,
+    totalTextMatches: total,
+    summary: formatLocateAnswer(needle, hits, total)
+  };
+}
+function sanitizeAgentDisplayText(text) {
+  if (!text) return text;
+  let t = text.replace(/\n*\/\*\s*vg:\s*unknown identifiers[\s\S]*?\*\//gi, "").trim();
+  if (/"schemaVersion"\s*:\s*"patch-ir\/0"/i.test(t) || /"op"\s*:\s*"replace-text"/i.test(t) && /"operations"\s*:/i.test(t)) {
+    return "This looked like a locate/search question, but the model returned an edit payload instead of an answer. Ask again as \u201Cwhere is <url or string>?\u201D \u2014 VG Code will use the literal search path.";
+  }
+  return t;
+}
+
 // src/code/agent.ts
 var DEFAULT_MAX_STEPS = 24;
 var DEFAULT_CONTEXT_BUDGET = 16e3;
@@ -1973,6 +2115,7 @@ async function runAgent(options) {
   if (options.testCommand) {
     messages.push({ role: "user", content: `When you want to verify a change, the project's test command is: \`${options.testCommand}\`` });
   }
+  const locateOnly = isLocateOnlyInstruction(instruction);
   const spans = buildSpanIndex(graph);
   const changes = [];
   const repeats = /* @__PURE__ */ new Map();
@@ -1988,6 +2131,56 @@ async function runAgent(options) {
   let currentStep = 0;
   const capsuleSummary = capsule ? summarizeCapsule(capsule) : null;
   if (capsuleSummary) onEvent({ type: "capsule", summary: capsuleSummary });
+  if (locateOnly && options.deterministicLocate !== false) {
+    try {
+      const locate = await answerLocateInstruction(graph, root, instruction, 30);
+      providerInfo = { id: "deterministic-locate", model: "literal-sweep", fellBack: false };
+      onEvent({ type: "assistant", text: locate.summary });
+      const traj = trajectory.finalize({
+        taskId: instruction.slice(0, 48),
+        arm: capsule ? "capsule" : "metadata",
+        solved: true,
+        verified: true,
+        steps: 0,
+        stopped: "finished",
+        inferenceTurns: 0,
+        filesChanged: 0,
+        usedCapsule: !!capsule,
+        provider: { id: "deterministic-locate", model: "literal-sweep" }
+      });
+      const earlyMetrics = {
+        discoveryToolCalls: 0,
+        mutationToolCalls: 0,
+        shellCommands: 0,
+        znsAt1: true,
+        usedCapsule: !!capsule,
+        failureCapsuleBuilt: false,
+        trajectory: traj
+      };
+      onEvent({ type: "metrics", metrics: earlyMetrics });
+      return {
+        finalText: locate.summary,
+        changes: [],
+        steps: 0,
+        stopped: "finished",
+        provider: providerInfo,
+        usage,
+        metrics: earlyMetrics,
+        failureCapsule: null,
+        capsuleSummary,
+        provenance: buildRunProvenance({
+          modelProfileId: options.modelProfile?.id ?? capsule?.provenance.modelProfileId ?? null,
+          securityTier: options.executionEnv?.tier ?? options.modelProfile?.securityTier ?? capsule?.provenance.securityTier ?? null,
+          graphCorpusHash: capsule?.provenance.graphCorpusHash ?? graph.provenance?.corpusHash ?? null,
+          rankingVersion: capsule?.provenance.rankingVersion ?? CAPSULE_RANKING_VERSION,
+          policyVersion: capsule?.provenance.policyVersion ?? CONTEXT_POLICY_VERSION,
+          changes: [],
+          verification: []
+        })
+      };
+    } catch {
+    }
+  }
   const runShell = (command) => {
     if (options.executionEnv) return options.executionEnv.run(command, { cwd: root });
     return options.run(command);
@@ -1999,6 +2192,7 @@ async function runAgent(options) {
     spans,
     run: runShell,
     approve: options.approve,
+    askUser: options.askUser,
     auto: options.auto,
     denyCommands: options.denyCommands,
     capsule,
@@ -2233,7 +2427,9 @@ Fix the failing tests, then call finish again.${verifyRounds === 0 ? " (last ver
         options.modelProfile,
         identifierTrie,
         draftCandidates,
-        promptSegments
+        promptSegments,
+        /* skipPatchIrGrammar */
+        locateOnly
       );
       result = c.result;
       providerInfo = { id: c.provider.id, model: c.provider.model, fellBack: c.fellBack };
@@ -2248,11 +2444,15 @@ Fix the failing tests, then call finish again.${verifyRounds === 0 ? " (last ver
       trajectory.recordUsage(result.usage.promptTokens ?? 0, result.usage.completionTokens ?? 0);
       onEvent({ type: "usage", promptTokens: result.usage.promptTokens ?? 0, completionTokens: result.usage.completionTokens ?? 0 });
     }
-    if (result.text) onEvent({ type: "assistant", text: result.text });
+    const displayText = sanitizeAgentDisplayText(result.text ?? "");
+    if (displayText) onEvent({ type: "assistant", text: displayText });
     const toolCalls = result.toolCalls ?? [];
     if (toolCalls.length === 0) {
       messages.push({ role: "assistant", content: result.text });
-      return finish("no-tools", result.text, step);
+      if (isUserFacingProse(displayText)) {
+        return finish("finished", displayText, step);
+      }
+      return finish("no-tools", displayText || "done", step);
     }
     messages.push({ role: "assistant", content: result.text, toolCalls });
     for (const call of toolCalls) {
@@ -2274,7 +2474,7 @@ Fix the failing tests, then call finish again.${verifyRounds === 0 ? " (last ver
           call.__gateNote = gate.note;
         }
       }
-      const toolResult = options.externalTools?.owns(call.name) ? await options.externalTools.execute(call) : await executeTool(call, ctx);
+      const toolResult = options.externalTools?.owns(call.name) ? await options.externalTools.execute(call, { graph: ctx.graph }) : await executeTool(call, ctx);
       if (!options.externalTools?.owns(call.name)) {
         recordDiscoveryGateOutcome(call.name, discoveryGate, { mutated: toolResult.mutated });
       }
@@ -2315,10 +2515,10 @@ ${gateNote}`;
   }
   return finish("max-steps", "reached the step limit before finishing", maxSteps);
 }
-async function complete(providers, messages, tools, onEvent, stream, modelProfile, identifierTrie, draftCandidates, promptSegments) {
+async function complete(providers, messages, tools, onEvent, stream, modelProfile, identifierTrie, draftCandidates, promptSegments, skipPatchIrGrammar = false) {
   if (providers.length === 0) throw new Error("no model provider available");
   const onToken = stream ? (t) => onEvent({ type: "token", text: t }) : void 0;
-  const grammar = shouldUsePatchIrGrammar(modelProfile) ? patchIrGbnf() : void 0;
+  const grammar = !skipPatchIrGrammar && shouldUsePatchIrGrammar(modelProfile) ? patchIrGbnf() : void 0;
   const requireGrammar = !!(grammar && modelProfile?.constrainedDecoding && providers.some((p) => p.id === "llama-cpp"));
   let lastErr;
   for (let i = 0; i < providers.length; i++) {
@@ -2429,6 +2629,14 @@ function writeAgentAudit(fsImpl, rec, ts) {
   } catch {
   }
 }
+function isUserFacingProse(text) {
+  const t = (text ?? "").trim();
+  if (t.length < 12) return false;
+  if (/"schemaVersion"\s*:\s*"patch-ir\/0"/i.test(t)) return false;
+  if (/^\s*\{[\s\S]*"operations"\s*:/.test(t)) return false;
+  if (!/[A-Za-z]{4,}/.test(t)) return false;
+  return true;
+}
 function stableArgs(args) {
   const keys = Object.keys(args).sort();
   return JSON.stringify(keys.map((k) => [k, args[k]]));
@@ -2454,5 +2662,5 @@ function buildSpanIndex(graph) {
 }
 
 export { CONTEXT_POLICY_VERSION, computeFcsReport, createTrajectoryCollector, renderFcsReportMarkdown, runAgent };
-//# sourceMappingURL=chunk-A2IYFNCQ.js.map
-//# sourceMappingURL=chunk-A2IYFNCQ.js.map
+//# sourceMappingURL=chunk-2ZHWF7C6.js.map
+//# sourceMappingURL=chunk-2ZHWF7C6.js.map