@wrongstack/tools 1.0.2 → 1.0.4

package/dist/{chunk-HWXIRVKH.js → chunk-OSXM3O3J.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-XRNN44QY.js";
 import {
   spawnStream
-} from "./chunk-DRRY6SCM.js";
+} from "./chunk-EMA2XENR.js";
 import {
   codebaseContext,
   codebaseIndexStats,
@@ -15,7 +15,7 @@ import {
   outgoingCallsService,
   runStartupIndex,
   searchCodebaseIndex
-} from "./chunk-TI5COGLY.js";
+} from "./chunk-PVQBD3TA.js";
 import {
   IndexTimeoutError,
   SCHEMA_VERSION,
@@ -26,7 +26,7 @@ import {
   posixIndexPath,
   resolveIndexDir,
   xxhash64String
-} from "./chunk-52UXXQMP.js";
+} from "./chunk-AX5ZG5O5.js";
 import {
   EXT_TO_LANG,
   detectLang,
@@ -38,7 +38,7 @@ import {
 import {
   normalizeCommandOutput,
   safeResolveProjectPath
-} from "./chunk-ZUFHAHTE.js";
+} from "./chunk-HKR56VNF.js";
 
 // src/codebase-index/ast-invariant-engine.ts
 var tsModule = null;
@@ -875,6 +875,7 @@ var codebaseImpactAnalysisTool = {
 };
 
 // src/codebase-index/codebase-incoming-calls-tool.ts
+import { ToolValidationError } from "@wrongstack/core/types";
 import { toErrorMessage as toErrorMessage3 } from "@wrongstack/core/utils";
 var codebaseIncomingCallsTool = {
   name: "codebase-incoming-calls",
@@ -912,6 +913,12 @@ var codebaseIncomingCallsTool = {
     required: ["symbol"]
   },
   async execute(input, ctx) {
+    if (!input?.symbol || typeof input.symbol !== "string" || !input.symbol.trim()) {
+      throw new ToolValidationError({
+        message: "codebase-incoming-calls: symbol is required and cannot be empty",
+        field: "symbol"
+      });
+    }
     const state = getIndexState();
     if (state.lastError) {
       const circuit = state.circuit;
@@ -1007,10 +1014,10 @@ var codebaseIncomingCallsTool = {
 };
 
 // src/codebase-index/codebase-index-tool.ts
-import { ToolValidationError as ToolValidationError2 } from "@wrongstack/core/types";
+import { ToolValidationError as ToolValidationError3 } from "@wrongstack/core/types";
 
 // src/codebase-index/codebase-search-tool.ts
-import { ToolValidationError } from "@wrongstack/core/types";
+import { ToolValidationError as ToolValidationError2 } from "@wrongstack/core/types";
 import { toErrorMessage as toErrorMessage4 } from "@wrongstack/core/utils";
 var INDEXABLE_LANG_IDS = [
   ...new Set(Object.values(EXT_TO_LANG))
@@ -1019,7 +1026,7 @@ var codebaseSearchTool = {
   name: "codebase-search",
   category: "Project",
   icon: "index",
-  description: "Search code symbols using a fast SQLite+BM25 index, with optional LSP fallback. Prefer this before broad `tree`, `glob`, or `grep` exploration when finding code by name or concept. Use `grep` instead for exact text, regexes, unsupported content, or concrete usage sites. Set `preferLsp: true` for live precision when the LSP plugin is active (supersedes codebase-lsp-search).",
+  description: "Search code symbols using a fast SQLite+BM25 index. Prefer this before broad `tree`, `glob`, or `grep` exploration when finding code by name or concept. Use `grep` instead for exact text, regexes, unsupported content, or concrete usage sites. When LSP tools are active, use `codebase-lsp-search` for live workspace-symbol results.",
   usageHint: "FIRST CHOICE FOR INDEXABLE CODE UNDERSTANDING:\n\n- Call before broad `tree`, `glob`, or `grep` exploration when locating symbols, concepts, definitions, or candidate modules.\n- `kind` filter is very useful (e.g. only functions or only interfaces).\n- Combine with `file` filter to scope to a specific directory or module.\n- If `indexStatus` reports no persisted data, run `codebase-index` and retry.",
   permission: "auto",
   mutating: false,
@@ -1081,20 +1088,20 @@ var codebaseSearchTool = {
       },
       preferLsp: {
         type: "boolean",
-        description: "Prefer live LSP results over the index. Ignored unless the LSP plugin is active; when it is active and this is true, results come from live workspaceSymbol queries."
+        description: "Deprecated compatibility hint. This built-in remains index-only; use codebase-lsp-search for live LSP results."
       }
     },
     required: ["query"]
   },
   async execute(input, ctx, execOpts) {
     if (!input?.query || typeof input.query !== "string" || !input.query.trim()) {
-      throw new ToolValidationError({
+      throw new ToolValidationError2({
         message: "codebase-search: query is required and cannot be empty",
         field: "query"
       });
     }
     if (input.lspKind !== void 0 && (!Number.isInteger(input.lspKind) || input.lspKind < 1 || input.lspKind > 26)) {
-      throw new ToolValidationError({
+      throw new ToolValidationError2({
         message: "codebase-search: lspKind must be an integer between 1 and 26",
         field: "lspKind"
       });
@@ -1212,7 +1219,7 @@ var codebaseIndexTool = {
     signal?.throwIfAborted();
     if (input.langs) {
       if (!Array.isArray(input.langs) || input.langs.length === 0) {
-        throw new ToolValidationError2({
+        throw new ToolValidationError3({
           message: "codebase-index: langs cannot be an empty array. Pass at least one valid language or omit langs.",
           field: "langs"
         });
@@ -1221,7 +1228,7 @@ var codebaseIndexTool = {
         (lang) => !INDEXABLE_LANG_IDS.includes(lang)
       );
       if (unknown.length > 0) {
-        throw new ToolValidationError2({
+        throw new ToolValidationError3({
           message: `codebase-index: unknown lang(s) ${unknown.map((l) => `"${l}"`).join(", ")}. Valid ids: ${INDEXABLE_LANG_IDS.join(", ")}.`,
           field: "langs"
         });
@@ -1350,6 +1357,7 @@ var codebaseInvariantCheckTool = {
 };
 
 // src/codebase-index/codebase-outgoing-calls-tool.ts
+import { ToolValidationError as ToolValidationError4 } from "@wrongstack/core/types";
 import { toErrorMessage as toErrorMessage6 } from "@wrongstack/core/utils";
 var codebaseOutgoingCallsTool = {
   name: "codebase-outgoing-calls",
@@ -1387,6 +1395,12 @@ var codebaseOutgoingCallsTool = {
     required: ["symbol"]
   },
   async execute(input, ctx) {
+    if (!input?.symbol || typeof input.symbol !== "string" || !input.symbol.trim()) {
+      throw new ToolValidationError4({
+        message: "codebase-outgoing-calls: symbol is required and cannot be empty",
+        field: "symbol"
+      });
+    }
     const state = getIndexState();
     if (state.lastError) {
       const circuit = state.circuit;
@@ -3554,7 +3568,7 @@ async function buildProjectAtlasBrief(projectRoot, opts = {}) {
 }
 
 // src/codebase-index/codebase-context-tool.ts
-import { ToolValidationError as ToolValidationError3 } from "@wrongstack/core/types";
+import { ToolValidationError as ToolValidationError5 } from "@wrongstack/core/types";
 import { toErrorMessage as toErrorMessage11 } from "@wrongstack/core/utils";
 var TOOL_TIMEOUT_MS = 35e3;
 var VECTOR_HIT_LIMIT = 12;
@@ -3617,7 +3631,7 @@ var codebaseContextTool = {
   async execute(input, ctx, execOpts) {
     const query = typeof input.query === "string" ? input.query.trim() : "";
     if (query.length === 0) {
-      throw new ToolValidationError3({
+      throw new ToolValidationError5({
         message: "codebase-context requires a non-empty `query`.",
         field: "query"
       });
@@ -4033,4 +4047,4 @@ export {
   embedFiles,
   embedProjectFiles
 };
-//# sourceMappingURL=chunk-HWXIRVKH.js.map
+//# sourceMappingURL=chunk-OSXM3O3J.js.map

package/dist/{chunk-LQSOU63Z.js → chunk-OZVGRDCM.js}

@@ -1,9 +1,9 @@
 import {
   todoTool
-} from "./chunk-FBUP524S.js";
+} from "./chunk-TGVQMKVH.js";
 import {
   mirrorSessionTasksToKanban
-} from "./chunk-X6KXNHUO.js";
+} from "./chunk-5BKQVP56.js";
 
 // src/task.ts
 import { randomUUID } from "node:crypto";
@@ -582,4 +582,4 @@ ${formatTaskList(file.tasks)}` : file.tasks.length > 0 ? formatTaskList(file.tas
 export {
   taskTool
 };
-//# sourceMappingURL=chunk-LQSOU63Z.js.map
+//# sourceMappingURL=chunk-OZVGRDCM.js.map

package/dist/{chunk-TI5COGLY.js → chunk-PVQBD3TA.js}

@@ -2,14 +2,18 @@ import {
   MAX_BINARY_FRAME_BYTES,
   PROJECT_INDEX_SERVER_MAX_FRAME_CHARS,
   PROJECT_INDEX_SERVER_PROTOCOL_VERSION,
+  PROJECT_INDEX_SERVER_STDERR_MAX_BYTES,
   decodeBinaryFrame,
   encodeBinaryFrame,
   encodeProjectServerMessage,
+  formatProjectIndexServerCloseError,
   isBinaryFrame,
   projectIndexServerBuildId,
   projectIndexServerEndpoint,
-  projectIndexServerMetadataPath
-} from "./chunk-MBR5VAB5.js";
+  projectIndexServerMetadataPath,
+  projectIndexServerStderrPath,
+  readProjectIndexServerStderrTail
+} from "./chunk-VQDSIHAR.js";
 import {
   CircuitOpenError,
   IndexTimeoutError,
@@ -24,7 +28,7 @@ import {
   searchService,
   statsService,
   symbolGraphService
-} from "./chunk-52UXXQMP.js";
+} from "./chunk-AX5ZG5O5.js";
 import {
   recordIpcPending
 } from "./chunk-ZKC5UNGD.js";
@@ -158,6 +162,7 @@ function cancellationError(signal) {
 import { spawn } from "node:child_process";
 import * as fs2 from "node:fs";
 import * as net from "node:net";
+import * as path from "node:path";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
 var ProjectServerConnection = class {
   constructor(projectRoot, indexDir, endpoint) {
@@ -587,6 +592,21 @@ var ProjectServerConnection = class {
     if (message.ok) entry.resolve(message.result);
     else entry.reject(remoteError(message.error, message.errorName));
   }
+  /**
+   * Why the connection closed, as far as the daemon left evidence.
+   *
+   * A closed socket has two very different causes — an orderly shutdown, and
+   * the daemon dying — and they were reported identically. If the daemon
+   * wrote anything to stderr, that text is the difference between a failure
+   * someone can act on and one that reads as a flake.
+   */
+  closeReason() {
+    return formatProjectIndexServerCloseError(
+      readProjectIndexServerStderrTail(
+        projectIndexServerStderrPath(this.projectRoot, this.indexDir)
+      )
+    );
+  }
   onClose(socket) {
     if (socket !== this.socket) return;
     const wasConnected = this.info !== null;
@@ -594,7 +614,7 @@ var ProjectServerConnection = class {
     this.info = null;
     this.activity = null;
     this.health = null;
-    const error = new Error("codebase-index server connection closed");
+    const error = new Error(this.closeReason());
     this.connectReject?.(error);
     this.connectResolve = null;
     this.connectReject = null;
@@ -651,12 +671,32 @@ var ProjectServerConnection = class {
     }
     const args = [fileURLToPath2(url), "--project-root", this.projectRoot];
     if (this.indexDir) args.push("--index-dir", this.indexDir);
+    let stderrTarget = "ignore";
+    try {
+      const logPath = projectIndexServerStderrPath(this.projectRoot, this.indexDir);
+      fs2.mkdirSync(path.dirname(logPath), { recursive: true });
+      try {
+        if (fs2.statSync(logPath).size > PROJECT_INDEX_SERVER_STDERR_MAX_BYTES) {
+          fs2.truncateSync(logPath, 0);
+        }
+      } catch {
+      }
+      stderrTarget = fs2.openSync(logPath, "a");
+    } catch {
+      stderrTarget = "ignore";
+    }
     const child = spawn(process.execPath, args, {
       detached: true,
-      stdio: "ignore",
+      stdio: ["ignore", "ignore", stderrTarget],
       windowsHide: true,
       env: process.env
     });
+    if (typeof stderrTarget === "number") {
+      try {
+        fs2.closeSync(stderrTarget);
+      } catch {
+      }
+    }
     child.unref();
   }
   forceKillKnownServer() {
@@ -1312,4 +1352,4 @@ export {
   checkCodebaseIndexServerHealth,
   ensureCodebaseIndexServer
 };
-//# sourceMappingURL=chunk-TI5COGLY.js.map
+//# sourceMappingURL=chunk-PVQBD3TA.js.map

package/dist/{chunk-3D5DJWOE.js → chunk-R36RWYXE.js}

@@ -1,13 +1,13 @@
 import {
   tryLegacyCodeOperation
-} from "./chunk-T3SMFF5Q.js";
+} from "./chunk-JQ43NVFU.js";
 import {
   spawnStream
-} from "./chunk-DRRY6SCM.js";
+} from "./chunk-EMA2XENR.js";
 import {
   normalizeCommandOutput,
   safeResolveReal
-} from "./chunk-ZUFHAHTE.js";
+} from "./chunk-HKR56VNF.js";
 
 // src/lint.ts
 import { ToolValidationError } from "@wrongstack/core/types";
@@ -100,6 +100,14 @@ var lintTool = {
     }
     yield { type: "log", text: `Running ${detected}\u2026`, data: { linter: detected } };
     const files = input.files ? (Array.isArray(input.files) ? input.files : input.files.split(",")).map((f) => f.trim().replace(/\\/g, "/")).filter(Boolean) : [];
+    for (const f of files) {
+      if (f.startsWith("-")) {
+        throw new ToolValidationError({
+          message: `lint: file path "${f}" may not begin with '-' (flag injection)`,
+          field: "files"
+        });
+      }
+    }
     const args = [];
     if (detected === "eslint") {
       if (input.fix) args.push("--fix");
@@ -181,4 +189,4 @@ async function detectLinter(cwd) {
 export {
   lintTool
 };
-//# sourceMappingURL=chunk-3D5DJWOE.js.map
+//# sourceMappingURL=chunk-R36RWYXE.js.map

package/dist/{chunk-3AU6CZWL.js → chunk-REWOZIA4.js}

@@ -8,7 +8,7 @@ import {
 } from "./chunk-ZKC5UNGD.js";
 import {
   resolveWin32Command
-} from "./chunk-KE7A76VC.js";
+} from "./chunk-5U5ULQX2.js";
 
 // src/codebase-index/py-parser.ts
 import { spawn } from "node:child_process";
@@ -384,4 +384,4 @@ export {
   parseSymbols,
   resolvePythonBinary
 };
-//# sourceMappingURL=chunk-3AU6CZWL.js.map
+//# sourceMappingURL=chunk-REWOZIA4.js.map

package/dist/{chunk-QA6IASYX.js → chunk-S6E2AM4U.js}

@@ -1,13 +1,13 @@
 import {
   tryLegacyCodeOperation
-} from "./chunk-T3SMFF5Q.js";
+} from "./chunk-JQ43NVFU.js";
 import {
   spawnStream
-} from "./chunk-DRRY6SCM.js";
+} from "./chunk-EMA2XENR.js";
 import {
   normalizeCommandOutput,
   safeResolveReal
-} from "./chunk-ZUFHAHTE.js";
+} from "./chunk-HKR56VNF.js";
 
 // src/test.ts
 import * as path from "node:path";
@@ -231,4 +231,4 @@ ${result.stderr}` : result.stdout || result.stderr || result.error || "";
 export {
   testTool
 };
-//# sourceMappingURL=chunk-QA6IASYX.js.map
+//# sourceMappingURL=chunk-S6E2AM4U.js.map