@wrongstack/tools 0.319.1 → 1.0.0

package/dist/{chunk-MNP3GE7H.js → chunk-JDOO4P6Z.js}

@@ -13,7 +13,8 @@ var DEFAULT_IGNORE = /* @__PURE__ */ new Set([
   ".gnupg",
   ".aws"
 ]);
-var DEFAULT_MAX_ENTRIES = 5e3;
+var DEFAULT_MAX_TREE_ENTRIES = 5e3;
+var DEFAULT_MAX_ENTRIES = DEFAULT_MAX_TREE_ENTRIES;
 var MAX_TREE_OUTPUT_BYTES = 256 * 1024;
 var treeTool = {
   name: "tree",
@@ -84,10 +85,11 @@ var treeTool = {
     const showFiles = input.show_files ?? true;
     const showDirs = input.show_dirs ?? true;
     const showHidden = input.show_hidden ?? false;
+    const rawExclude = Array.isArray(input.exclude) ? input.exclude : typeof input.exclude === "string" ? [input.exclude] : [];
     const exclude = /* @__PURE__ */ new Set([
       ...DEFAULT_IGNORE,
-      ...(input.exclude ?? []).map(
-        (s) => s.trim().replace(/[\\/]+$/, "").replace(/^\.\//, "")
+      ...rawExclude.filter((s) => typeof s === "string").map(
+        (s) => s.trim().replace(/\\/g, "/").replace(/\/+$/, "").replace(/^\.\//, "")
       ).filter(Boolean)
     ]);
     const globRe = input.glob ? compileGlob(input.glob) : void 0;
@@ -203,7 +205,7 @@ async function walkDir(dir, depth, opts) {
   opts.totalDirs.value += dirCount;
   opts.totalFiles.value += fileCount;
   opts.onProgress?.();
-  const items = filtered.sort((a, b) => {
+  const items = filtered.filter((e) => e.isDirectory() || opts.showFiles).sort((a, b) => {
     if (a.isDirectory() && !b.isDirectory()) return -1;
     if (!a.isDirectory() && b.isDirectory()) return 1;
     return a.name.localeCompare(b.name);
@@ -218,19 +220,20 @@ async function walkDir(dir, depth, opts) {
     const branch = isLast ? "\u2514\u2500\u2500 " : "\u251C\u2500\u2500 ";
     const displayName = entry.name + (entry.isDirectory() ? "/" : "");
     const isDir = entry.isDirectory();
-    if (!opts.showDirs && isDir) continue;
-    if (!opts.showFiles && !isDir) continue;
-    const line = opts.prefix + branch + displayName;
-    const lineBytes = Buffer.byteLength(line, "utf8") + 1;
-    if (opts.retention.entries >= opts.retention.maxEntries || opts.retention.outputBytes + lineBytes > opts.retention.maxOutputBytes) {
-      opts.retention.truncated = true;
-      return;
+    const showEntry = isDir && opts.showDirs || !isDir && opts.showFiles;
+    if (showEntry) {
+      const line = opts.prefix + branch + displayName;
+      const lineBytes = Buffer.byteLength(line, "utf8") + 1;
+      if (opts.retention.entries >= opts.retention.maxEntries || opts.retention.outputBytes + lineBytes > opts.retention.maxOutputBytes) {
+        opts.retention.truncated = true;
+        return;
+      }
+      opts.lines.push(line);
+      opts.retention.entries++;
+      opts.retention.outputBytes += lineBytes;
     }
-    opts.lines.push(line);
-    opts.retention.entries++;
-    opts.retention.outputBytes += lineBytes;
     if (entry.isDirectory() && (opts.maxDepth === 0 || depth < opts.maxDepth)) {
-      const childPrefix = opts.prefix + connector;
+      const childPrefix = showEntry ? opts.prefix + connector : opts.prefix;
       await walkDir(path.join(dir, entry.name), depth + 1, {
         ...opts,
         prefix: childPrefix,
@@ -241,6 +244,8 @@ async function walkDir(dir, depth, opts) {
 }
 
 export {
+  DEFAULT_MAX_TREE_ENTRIES,
+  MAX_TREE_OUTPUT_BYTES,
   treeTool
 };
-//# sourceMappingURL=chunk-MNP3GE7H.js.map
+//# sourceMappingURL=chunk-JDOO4P6Z.js.map

package/dist/{chunk-BSJSNVGA.js → chunk-KDEXUQY7.js}

@@ -3,19 +3,19 @@ import {
 } from "./chunk-BTSFTGIL.js";
 import {
   getPersistentProcessRegistry
-} from "./chunk-NKNOBUBU.js";
+} from "./chunk-PVCB7RUZ.js";
 import {
   createOutputSpool,
   spoolNote
-} from "./chunk-2VSZC6QM.js";
+} from "./chunk-SCMRM6NL.js";
 import {
   getProcessRegistry,
   redactCommand
-} from "./chunk-3PVYQFRQ.js";
+} from "./chunk-HDYUBRMF.js";
 import {
   buildWin32CmdShimInvocation,
   resolveWin32Command
-} from "./chunk-V43EQ6VR.js";
+} from "./chunk-KE7A76VC.js";
 import {
   COMMAND_OUTPUT_MAX_BYTES,
   normalizeCommandOutput,
@@ -47,6 +47,7 @@ var flagLetters = (args) => {
   }
   return seen;
 };
+var isPowerShellCmd = (cmd) => /^(?:powershell|pwsh)(?:\.exe)?$/i.test(cmd);
 var RULES = [
   // ----- rm / rmdir: recursive force delete (any path) -----
   // Note: BLOCKED_ARG_PATTERNS already hard-denies root/home/glob paths,
@@ -85,7 +86,12 @@ var RULES = [
     id: "powershell-remove-item-recursive-force",
     level: "destructive",
     test: (cmd, args) => {
-      if (cmd !== "powershell" && cmd !== "pwsh") return false;
+      const isPwsh = isPowerShellCmd(cmd);
+      const isRemoveItemCmd = /^(?:remove-item|ri)(?:\.exe)?$/i.test(cmd);
+      if (!isPwsh && !isRemoveItemCmd) return false;
+      if (isPwsh && !args.some((a) => /^(?:Remove-Item|ri|rm|del|erase|rd|rmdir)(?:\.exe)?$/i.test(a))) {
+        return false;
+      }
       const hasRecurse = argMatches(args, /^-(?:r|recurse)(?::\$true)?$/i);
       const hasForce = argMatches(args, /^-(?:f|force)(?::\$true)?$/i);
       if (argMatches(args, /^-whatif(?::\$true)?$/i)) return false;
@@ -98,7 +104,7 @@ var RULES = [
     id: "powershell-disk-volume-destroy",
     level: "destructive",
     test: (cmd, args) => {
-      if (cmd !== "powershell" && cmd !== "pwsh") return false;
+      if (!isPowerShellCmd(cmd)) return false;
       return args.some(
         (a) => /^(?:Format-Volume|Clear-Disk|Initialize-Disk|Remove-Partition|Clear-Volume)(?:\s|$)/i.test(
           a
@@ -112,7 +118,7 @@ var RULES = [
     id: "powershell-stop-restart-computer",
     level: "destructive",
     test: (cmd, args) => {
-      if (cmd !== "powershell" && cmd !== "pwsh") return false;
+      if (!isPowerShellCmd(cmd)) return false;
       return args.some((a) => /^(?:Stop-Computer|Restart-Computer)(?:\s|$)/i.test(a));
     },
     reason: "PowerShell system shutdown or restart"
@@ -122,7 +128,7 @@ var RULES = [
     id: "powershell-execution-policy-bypass",
     level: "caution",
     test: (cmd, args) => {
-      if (cmd !== "powershell" && cmd !== "pwsh") return false;
+      if (!isPowerShellCmd(cmd)) return false;
       return args.some(
         (a) => /Set-ExecutionPolicy\s+(?:Bypass|Unrestricted)|-(?:EncodedCommand|enc)\b/i.test(a)
       );
@@ -269,7 +275,12 @@ var RULES = [
     level: "destructive",
     test: (cmd, args) => {
       if (!["npm", "pnpm", "yarn", "bun", "cargo"].includes(cmd)) return false;
-      return args.includes("publish") || cmd === "cargo" && args.includes("yank");
+      const firstPositional = args.find((a) => !a.startsWith("-"));
+      if (!firstPositional) return false;
+      if (cmd === "cargo") {
+        return firstPositional === "publish" || firstPositional === "yank";
+      }
+      return firstPositional === "publish";
     },
     reason: "publishing to a public package registry (hard to reverse)"
   },
@@ -428,12 +439,14 @@ var RULES = [
   }
 ];
 function detectDanger(cmd, args, bypass) {
+  if (typeof cmd !== "string") return { level: "safe", reasons: [] };
+  const safeArgs = Array.isArray(args) ? args : [];
   const reasons = [];
   let level = "safe";
   let matchedRule;
   for (const rule of RULES) {
     if (bypass?.has(rule.id)) continue;
-    if (!rule.test(cmd, args)) continue;
+    if (!rule.test(cmd, safeArgs)) continue;
     reasons.push(rule.reason);
     if (matchedRule === void 0 || levelRank(rule.level) >= levelRank(level)) {
       matchedRule = rule.id;
@@ -1819,4 +1832,4 @@ export {
   getExecAllowlist,
   execTool
 };
-//# sourceMappingURL=chunk-BSJSNVGA.js.map
+//# sourceMappingURL=chunk-KDEXUQY7.js.map

package/dist/{chunk-V43EQ6VR.js → chunk-KE7A76VC.js}

@@ -56,7 +56,8 @@ function buildWin32CmdShimInvocation(command, args = []) {
   };
 }
 function quoteWin32CmdArg(arg) {
-  return `"${arg}"`;
+  const escaped = arg.replace(/(\\+)$/, "$1$1");
+  return `"${escaped}"`;
 }
 
 export {
@@ -65,4 +66,4 @@ export {
   assertSafeWin32ShellArgs,
   buildWin32CmdShimInvocation
 };
-//# sourceMappingURL=chunk-V43EQ6VR.js.map
+//# sourceMappingURL=chunk-KE7A76VC.js.map

package/dist/{chunk-2OXHS3KZ.js → chunk-KLJZ4WV4.js}

@@ -100,7 +100,7 @@ describe('{{Name}}', () => {
 var scaffoldTool = {
   name: "scaffold",
   category: "Project",
-  description: "Generate new files and folder structures from built-in templates or custom definitions. This is the recommended way to bootstrap new packages, components, or modules instead of creating files one by one with `write`.",
+  description: "Generate or preview files and folder structures from built-in templates or custom definitions. Writes files to disk unless dry_run is set. This is the recommended way to bootstrap new packages, components, or modules instead of creating files one by one with `write`.",
   usageHint: "PREFERRED FOR SCAFFOLDING:\n\n- Use built-in templates when they match your needs (e.g. react-component, npm-package).\n- Supports `dry_run` so you can preview exactly what will be created.\n- Has the powerful `fs.write.outside-project` capability \u2014 review paths carefully.\nMuch cleaner and safer than manually writing multiple files.",
   permission: "confirm",
   mutating: true,
@@ -195,7 +195,7 @@ function escapeRegexLiteral(value) {
 }
 function substituteVars(content, name, vars) {
   const kebab = name.toLowerCase().replace(/\s+/g, "-");
-  const pascal = name.replace(/(?:^|[-_\s]+)([a-z])/g, (_, c) => c.toUpperCase());
+  const pascal = name.replace(/(?:^|[-_\s]+)([a-zA-Z])/g, (_, c) => c.toUpperCase());
   let result = content;
   result = result.replace(/\{\{name\}\}/g, () => kebab);
   result = result.replace(/\{\{Name\}\}/g, () => pascal);
@@ -207,6 +207,7 @@ function substituteVars(content, name, vars) {
 }
 
 export {
+  BUILT_IN_TEMPLATES,
   scaffoldTool
 };
-//# sourceMappingURL=chunk-2OXHS3KZ.js.map
+//# sourceMappingURL=chunk-KLJZ4WV4.js.map

package/dist/{chunk-3M7LLN7W.js → chunk-LQSOU63Z.js}

@@ -1,6 +1,6 @@
 import {
   todoTool
-} from "./chunk-BK732J7I.js";
+} from "./chunk-FBUP524S.js";
 import {
   mirrorSessionTasksToKanban
 } from "./chunk-X6KXNHUO.js";
@@ -17,13 +17,13 @@ import {
 import { ToolValidationError } from "@wrongstack/core/types";
 import { computeTaskItemProgress, formatTaskList } from "@wrongstack/core/utils";
 function findTaskIndex(tasks, query) {
-  const asNum = Number.parseInt(query, 10);
-  if (!Number.isNaN(asNum)) {
-    const idx = asNum - 1;
-    if (tasks[idx]) return idx;
-  }
   const byId = tasks.findIndex((t) => t.id === query);
   if (byId >= 0) return byId;
+  const trimmed = query.trim();
+  if (/^[1-9]\d*$/.test(trimmed)) {
+    const idx = Number.parseInt(trimmed, 10) - 1;
+    if (tasks[idx]) return idx;
+  }
   const lower = query.toLowerCase();
   return tasks.findIndex((t) => t.title.toLowerCase().includes(lower));
 }
@@ -384,7 +384,7 @@ var taskTool = {
             break;
           }
           case "promote": {
-            const target = input.target?.trim();
+            const target = (input.target ?? input.id)?.trim();
             if (!target) {
               early = {
                 ok: false,
@@ -438,11 +438,12 @@ var taskTool = {
                 promotedFromTask: match.id
               });
             }
-            if (input.subtasks && input.subtasks.length > 0) {
+            if (Array.isArray(input.subtasks) && input.subtasks.length > 0) {
               for (const st of input.subtasks) {
+                if (typeof st !== "string" || !st.trim()) continue;
                 todos.push({
                   id: `todo_${ts}_${randomUUID().slice(0, 6)}`,
-                  content: st,
+                  content: st.trim(),
                   status: "pending",
                   promotedFromTask: match.id
                 });
@@ -454,7 +455,7 @@ var taskTool = {
             break;
           }
           case "planify": {
-            const target = input.target?.trim();
+            const target = (input.target ?? input.id)?.trim();
             if (!target) {
               early = {
                 ok: false,
@@ -581,4 +582,4 @@ ${formatTaskList(file.tasks)}` : file.tasks.length > 0 ? formatTaskList(file.tas
 export {
   taskTool
 };
-//# sourceMappingURL=chunk-3M7LLN7W.js.map
+//# sourceMappingURL=chunk-LQSOU63Z.js.map

package/dist/{chunk-DC4KMPJO.js → chunk-M6UV67BH.js}

@@ -1,6 +1,6 @@
 import {
   builtinTools
-} from "./chunk-OTINMOKK.js";
+} from "./chunk-AB2CAUOP.js";
 
 // src/pack.ts
 var builtinToolsPack = {
@@ -12,4 +12,4 @@ var builtinToolsPack = {
 export {
   builtinToolsPack
 };
-//# sourceMappingURL=chunk-DC4KMPJO.js.map
+//# sourceMappingURL=chunk-M6UV67BH.js.map

package/dist/{chunk-C2DQKVLO.js → chunk-MJSJWXBF.js}

@@ -269,4 +269,4 @@ function prettyJson(s) {
 export {
   fetchTool
 };
-//# sourceMappingURL=chunk-C2DQKVLO.js.map
+//# sourceMappingURL=chunk-MJSJWXBF.js.map

package/dist/{chunk-RNWUCZ2U.js → chunk-MK2JK35J.js}

@@ -1,10 +1,10 @@
 import {
   getIndexState,
   searchCodebaseIndex
-} from "./chunk-DP6CXMJZ.js";
+} from "./chunk-ZTCJCYLN.js";
 import {
   codebaseIndexDirOverride
-} from "./chunk-KY4PXYSO.js";
+} from "./chunk-N3K2SFEI.js";
 import {
   isBinaryBuffer,
   safeResolveReal,
@@ -71,7 +71,7 @@ var readTool = {
     const signal = execOpts?.signal ?? ctx?.signal;
     signal?.throwIfAborted();
     const absPath = await safeResolveReal(input.path, ctx);
-    const shouldIncludeSymbols = input.includeSymbols === true || input.includeSymbols !== false && ctx.meta[ADVANCED_MODE_META_KEY] === true;
+    const shouldIncludeSymbols = input.includeSymbols === true || input.includeSymbols !== false && ctx.meta?.[ADVANCED_MODE_META_KEY] === true;
     let stat2;
     try {
       stat2 = await fs.stat(absPath);
@@ -109,12 +109,14 @@ var readTool = {
         context: { size: stat2.size, limit: MAX_BYTES, reason: "too-large" }
       });
     }
-    const offset = Math.max(1, input.offset ?? 1);
-    const limit = Math.max(0, Math.min(input.limit ?? 2e3, 5e3));
+    const rawOffset = typeof input.offset === "number" && Number.isFinite(input.offset) ? input.offset : 1;
+    const offset = Math.max(1, Math.floor(rawOffset));
+    const rawLimit = typeof input.limit === "number" && Number.isFinite(input.limit) ? input.limit : 2e3;
+    const limit = Math.max(0, Math.min(Math.floor(rawLimit), 5e3));
     const prior = getReadRangeRecord(ctx, absPath);
     const requestedEnd = prior ? Math.min(offset + limit - 1, prior.totalLines) : offset + limit - 1;
     if (input.mode !== "summary" && limit > 0 && prior && offset <= requestedEnd && coversRange(prior, stat2.mtimeMs, stat2.size, offset, requestedEnd)) {
-      ctx.recordRead(absPath, stat2.mtimeMs, "user", ctx.lastReadHash?.(absPath));
+      ctx.recordRead?.(absPath, stat2.mtimeMs, "user", ctx.lastReadHash?.(absPath));
       const symResult2 = shouldIncludeSymbols ? await fetchSymbolsForFile(absPath, ctx, signal) : void 0;
       return {
         text: `[unchanged since previous read: "${input.path}" mtime=${Math.round(stat2.mtimeMs)}; requested lines ${offset}-${requestedEnd} were already shown. Use offset/limit for a new range if needed.]`,
@@ -138,10 +140,22 @@ var readTool = {
     }
     const text = buf.toString("utf8");
     const contentHash = sha256hex(text);
-    const allLines = text.split(/\r?\n/);
+    const allLines = text.length === 0 ? [] : text.split(/\r?\n/);
     const total = allLines.length;
+    if (total === 0) {
+      ctx.recordRead?.(absPath, stat2.mtimeMs, "user", contentHash);
+      const symResult2 = shouldIncludeSymbols ? await fetchSymbolsForFile(absPath, ctx, signal) : void 0;
+      return {
+        text: "",
+        total_lines: 0,
+        encoding: "utf8",
+        truncated: false,
+        ...symResult2?.symbols ? { symbols: symResult2.symbols } : {},
+        ...symResult2?.note ? { note: symResult2.note } : {}
+      };
+    }
     if (input.mode === "summary") {
-      ctx.recordRead(absPath, stat2.mtimeMs, "user", contentHash);
+      ctx.recordRead?.(absPath, stat2.mtimeMs, "user", contentHash);
       rememberReadRange(ctx, absPath, stat2.mtimeMs, stat2.size, total, 1, Math.min(total, 200));
       const symResult2 = shouldIncludeSymbols ? await fetchSymbolsForFile(absPath, ctx, signal) : void 0;
       const summary = summarizeFile(input.path, stat2.size, allLines);
@@ -158,7 +172,7 @@ var readTool = {
       };
     }
     if (limit === 0) {
-      ctx.recordRead(absPath, stat2.mtimeMs, "user", contentHash);
+      ctx.recordRead?.(absPath, stat2.mtimeMs, "user", contentHash);
       rememberReadRange(ctx, absPath, stat2.mtimeMs, stat2.size, total, 1, 0);
       const symResult2 = shouldIncludeSymbols ? await fetchSymbolsForFile(absPath, ctx, signal) : void 0;
       return {
@@ -171,7 +185,7 @@ var readTool = {
       };
     }
     if (offset > total) {
-      ctx.recordRead(absPath, stat2.mtimeMs, "user", contentHash);
+      ctx.recordRead?.(absPath, stat2.mtimeMs, "user", contentHash);
       const symResult2 = shouldIncludeSymbols ? await fetchSymbolsForFile(absPath, ctx, signal) : void 0;
       return {
         text: `[offset ${offset} is past end of file "${input.path}" \u2014 file has ${total} line(s). Do not retry this offset.]`,
@@ -194,7 +208,7 @@ var readTool = {
       parts[i] = `${pad}${numStr}\u2192${slice[i]}`;
     }
     const numbered = parts.join("\n");
-    ctx.recordRead(absPath, stat2.mtimeMs, "user", contentHash);
+    ctx.recordRead?.(absPath, stat2.mtimeMs, "user", contentHash);
     rememberReadRange(
       ctx,
       absPath,
@@ -253,6 +267,9 @@ function mergeSymbolNote(note, symNote) {
 }
 var READ_RANGES_META_KEY = "tools.read.ranges.v1";
 function getReadRanges(ctx) {
+  if (!ctx.meta) {
+    ctx.meta = {};
+  }
   const existing = ctx.meta[READ_RANGES_META_KEY];
   if (existing && typeof existing === "object" && !Array.isArray(existing)) {
     return existing;
@@ -323,4 +340,4 @@ ${interesting.join("\n")}` : "symbols/imports: (none detected)"
 export {
   readTool
 };
-//# sourceMappingURL=chunk-RNWUCZ2U.js.map
+//# sourceMappingURL=chunk-MK2JK35J.js.map

package/dist/{chunk-FQZOHLG3.js → chunk-MSOAX3GC.js}

@@ -12,11 +12,12 @@ function loadTypescript() {
   return tsLoad;
 }
 async function checkSyntax(filePath, content, previousContent) {
+  if (typeof filePath !== "string" || typeof content !== "string") return void 0;
   const errors = await parseErrors(filePath, content);
   if (errors === void 0) return void 0;
   if (errors.length === 0) return { errors, preExisting: false };
   let preExisting = false;
-  if (previousContent !== void 0) {
+  if (typeof previousContent === "string") {
     const prevErrors = await parseErrors(filePath, previousContent);
     preExisting = prevErrors !== void 0 && prevErrors.length > 0;
   }
@@ -86,4 +87,4 @@ function formatDiag(ts, diag, content, sourceFile) {
 export {
   checkSyntax
 };
-//# sourceMappingURL=chunk-FQZOHLG3.js.map
+//# sourceMappingURL=chunk-MSOAX3GC.js.map