codebase-snapshot 0.9.12 → 0.9.14

package/dist/{chunk-5OR3WVPW.js → chunk-J4W74N4Y.js}

@@ -1,6 +1,6 @@
-import { GENERATOR_VERSION, anchorForPath, displayPath, MIN_MAX_PART_BYTES, SCHEMA_VERSION, GENERATOR_NAME, ARTIFACT_NAMES, PRESETS, generateSnapshot, generateInWorker, validateSnapshot, buildImportResolver, resolveSpecifier, truncateToBytes, explainPath, renderExplainText, describeManifestShapeProblem, loadConfigFileDetailed, parseByteSize, resolveConfig } from './chunk-3H45YMBG.js';
+import { GENERATOR_VERSION, anchorForPath, displayPath, MIN_MAX_PART_BYTES, SCHEMA_VERSION, GENERATOR_NAME, ARTIFACT_NAMES, PRESETS, generateSnapshot, generateInWorker, validateSnapshot, buildImportResolver, resolveSpecifier, truncateToBytes, explainPath, renderExplainText, describeManifestShapeProblem, loadConfigFileDetailed, parseByteSize, resolveConfig } from './chunk-DUZK5VL2.js';
 import * as fs from 'fs';
-import * as path2 from 'path';
+import * as path from 'path';
 
 // src/mcp/protocol.ts
 var LEGACY_PROTOCOL_VERSIONS = ["2025-11-25", "2025-06-18"];
@@ -617,7 +617,7 @@ function foldForComparison(value) {
   return process.platform === "win32" || process.platform === "darwin" ? value.toLowerCase() : value;
 }
 function canonicalPath(value) {
-  const absolute = path2.resolve(value);
+  const absolute = path.resolve(value);
   try {
     return fs.realpathSync(absolute);
   } catch {
@@ -627,14 +627,14 @@ function canonicalPath(value) {
 function isInside(parent, child) {
   const foldedParent = foldForComparison(parent);
   const foldedChild = foldForComparison(child);
-  return foldedChild === foldedParent || foldedChild.startsWith(`${foldedParent}${path2.sep}`);
+  return foldedChild === foldedParent || foldedChild.startsWith(`${foldedParent}${path.sep}`);
 }
 function resolveRoot(requested, context) {
   if (requested !== void 0 && (typeof requested !== "string" || requested.trim().length === 0)) {
     return { ok: false, message: '"root" must be a non-empty string when provided.' };
   }
   const wanted = typeof requested === "string" ? requested.trim() : context.cwd;
-  const absolute = path2.resolve(context.cwd, wanted);
+  const absolute = path.resolve(context.cwd, wanted);
   let stats;
   try {
     stats = fs.statSync(absolute);
@@ -673,12 +673,35 @@ async function openWorkspace(root, overrides = {}) {
     }
     cliOptions.maxPartBytes = parsed;
   }
+  if (overrides.maxPartTokens !== void 0) {
+    const parsed = parseByteSize(overrides.maxPartTokens);
+    if (parsed === void 0) {
+      return {
+        ok: false,
+        message: '"maxPartTokens" must be a token count, for example 32000 or "32k".'
+      };
+    }
+    cliOptions.maxPartTokens = parsed;
+  }
   if (overrides.outDir !== void 0) {
     if (typeof overrides.outDir !== "string" || overrides.outDir.trim().length === 0) {
       return { ok: false, message: '"outDir" must be a non-empty string.' };
     }
     cliOptions.outDir = overrides.outDir.trim();
   }
+  if (overrides.changedSince !== void 0) {
+    if (typeof overrides.changedSince !== "string" || overrides.changedSince.trim().length === 0) {
+      return {
+        ok: false,
+        message: '"changedSince" must be a git ref such as "main" or "HEAD~3".'
+      };
+    }
+    cliOptions.changedSince = overrides.changedSince.trim();
+  }
+  if (overrides.skeleton === true) cliOptions.skeleton = true;
+  if (overrides.sarif === true) cliOptions.sarif = true;
+  if (overrides.staged === true) cliOptions.staged = true;
+  if (overrides.withDependents === true) cliOptions.withDependents = true;
   try {
     const config = resolveConfig(loaded.config, cliOptions, root);
     return { ok: true, workspace: { root, config, configFile: loaded.file, cliOptions } };
@@ -688,11 +711,21 @@ async function openWorkspace(root, overrides = {}) {
 }
 var manifestCache = /* @__PURE__ */ new Map();
 function manifestPathFor(workspace) {
-  return path2.resolve(workspace.root, workspace.config.outDir, "manifest.json");
+  return path.resolve(workspace.root, workspace.config.outDir, "manifest.json");
+}
+function partPathFor(workspace, filename) {
+  if (filename.length === 0 || filename.includes("\0")) return null;
+  const partsDir = path.resolve(workspace.root, workspace.config.outDir, "parts");
+  const resolved = path.resolve(partsDir, filename);
+  const relative3 = path.relative(partsDir, resolved);
+  if (relative3.length === 0 || relative3.includes(path.sep) || relative3.includes("/") || relative3.includes("\\") || path.isAbsolute(relative3)) {
+    return null;
+  }
+  return resolved;
 }
 function readManifest(workspace) {
   const file = manifestPathFor(workspace);
-  const shown = path2.relative(workspace.root, file).split(path2.sep).join("/") || file;
+  const shown = path.relative(workspace.root, file).split(path.sep).join("/") || file;
   let stats;
   try {
     stats = fs.statSync(file);
@@ -760,6 +793,44 @@ var OUT_DIR_PROPERTY = {
   description: "Snapshot directory, relative to the root. Defaults to the project configuration's outDir."
 };
 var outDirOverride = (args) => ({ outDir: args.outDir });
+var SCOPE_PROPERTIES = {
+  maxPartTokens: {
+    type: "string",
+    description: 'Token ceiling per part, for example 32000 or "32k". Narrower than maxPartBytes; it converts at four bytes per token.'
+  },
+  skeleton: {
+    type: "boolean",
+    description: "Replace every function body with `{ /* ... */ }`, keeping signatures, imports and exports. Applies to TypeScript, JavaScript and JSX."
+  },
+  sarif: {
+    type: "boolean",
+    description: "Also write reports/audit.sarif beside reports/audit.md, for CI code scanning."
+  },
+  changedSince: {
+    type: "string",
+    description: 'Only files changed since this git ref, for example "main" or "HEAD~3".'
+  },
+  staged: {
+    type: "boolean",
+    description: "Only files staged in the git index."
+  },
+  withDependents: {
+    type: "boolean",
+    description: "With staged or changedSince, also include the files that import the changed ones (one hop)."
+  }
+};
+function workspaceOverrides(args) {
+  return {
+    outDir: args.outDir,
+    maxPartBytes: args.maxPartBytes,
+    maxPartTokens: args.maxPartTokens,
+    skeleton: args.skeleton,
+    sarif: args.sarif,
+    changedSince: args.changedSince,
+    staged: args.staged,
+    withDependents: args.withDependents
+  };
+}
 function failure(message) {
   return { text: message, isError: true };
 }
@@ -772,7 +843,7 @@ function formatBytes(bytes) {
   return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
 }
 function relativeFor(workspace, absolute) {
-  return path2.relative(workspace.root, absolute).split(path2.sep).join("/");
+  return path.relative(workspace.root, absolute).split(path.sep).join("/");
 }
 function capped(values, limit = 20) {
   return { count: values.length, sample: values.slice(0, limit) };
@@ -790,13 +861,14 @@ function summarizeDrift(drift) {
 }
 function toRelativePath(root, value) {
   const cleaned = value.trim();
-  if (cleaned.length === 0) return null;
-  if (!path2.isAbsolute(cleaned)) {
-    return cleaned.replace(/\\/g, "/").replace(/^\.\//, "");
+  if (cleaned.length === 0 || cleaned.includes("\0")) return null;
+  const resolvedRoot = path.resolve(root);
+  const absolute = path.resolve(resolvedRoot, cleaned);
+  const relative3 = path.relative(resolvedRoot, absolute);
+  if (relative3 === "" || relative3 === ".." || relative3.startsWith(`..${path.sep}`) || path.isAbsolute(relative3)) {
+    return null;
   }
-  const relative3 = path2.relative(root, cleaned);
-  if (relative3.startsWith("..") || path2.isAbsolute(relative3)) return null;
-  return relative3.split(path2.sep).join("/");
+  return relative3.split(path.sep).join("/");
 }
 function symbolsOf(entry) {
   const summary = entry.summary;
@@ -931,7 +1003,8 @@ var planTool = {
       maxPartBytes: {
         type: "string",
         description: 'Byte budget per part, for example 307200 or "300k". Defaults to the project configuration.'
-      }
+      },
+      ...SCOPE_PROPERTIES
     },
     additionalProperties: false
   },
@@ -948,7 +1021,7 @@ var planTool = {
   },
   annotations: READ_ONLY,
   async handler(args, context) {
-    const prepared = await prepare(args, context, { maxPartBytes: args.maxPartBytes, outDir: args.outDir });
+    const prepared = await prepare(args, context, workspaceOverrides(args));
     if (!prepared.ok) return prepared.outcome;
     const workspace = prepared.workspace;
     let manifest;
@@ -1006,7 +1079,8 @@ var generateTool = {
       maxPartBytes: {
         type: "string",
         description: 'Byte budget per part, for example 307200 or "300k". Defaults to the project configuration.'
-      }
+      },
+      ...SCOPE_PROPERTIES
     },
     additionalProperties: false
   },
@@ -1022,17 +1096,14 @@ var generateTool = {
   },
   annotations: WRITES,
   async handler(args, context) {
-    const prepared = await prepare(args, context, {
-      maxPartBytes: args.maxPartBytes,
-      outDir: args.outDir
-    });
+    const prepared = await prepare(args, context, workspaceOverrides(args));
     if (!prepared.ok) return prepared.outcome;
     const workspace = prepared.workspace;
     const result = await generateInWorker(workspace.root, workspace.cliOptions);
     if (!result.ok) return failure(result.message);
     const summary = result.summary;
     forgetManifest(manifestPathFor(workspace));
-    const written = relativeFor(workspace, path2.resolve(workspace.root, workspace.config.outDir));
+    const written = relativeFor(workspace, path.resolve(workspace.root, workspace.config.outDir));
     const lines = [
       `Wrote ${written}/`,
       `Files: ${summary.totalFiles} included, ${summary.skippedCount} skipped, ${plural(summary.partsCount, "part")}`,
@@ -1064,7 +1135,7 @@ var validateTool = {
   description: "Re-read the repository and report whether the snapshot on disk still matches it. Use it before trusting context that came from an earlier session, or after changing the config.",
   inputSchema: {
     type: "object",
-    properties: { root: ROOT_PROPERTY, outDir: OUT_DIR_PROPERTY },
+    properties: { root: ROOT_PROPERTY, outDir: OUT_DIR_PROPERTY, ...SCOPE_PROPERTIES },
     additionalProperties: false
   },
   outputSchema: {
@@ -1076,7 +1147,7 @@ var validateTool = {
   },
   annotations: READ_ONLY,
   async handler(args, context) {
-    const prepared = await prepare(args, context, outDirOverride(args));
+    const prepared = await prepare(args, context, workspaceOverrides(args));
     if (!prepared.ok) return prepared.outcome;
     const workspace = prepared.workspace;
     let result;
@@ -1421,7 +1492,12 @@ var readTool = {
         `${relativePath} is not in the snapshot. Call snapshot_locate to find the path, or snapshot_explain to learn why it was excluded.`
       );
     }
-    const partPath = path2.resolve(workspace.root, workspace.config.outDir, "parts", entry.part);
+    const partPath = partPathFor(workspace, entry.part);
+    if (partPath === null) {
+      return failure(
+        `${entry.part} is not a part of this snapshot: its name leaves ${workspace.config.outDir}/parts. Run snapshot_generate to rebuild it.`
+      );
+    }
     let partText;
     try {
       partText = fs.readFileSync(partPath, "utf8");
@@ -1501,7 +1577,8 @@ var explainTool = {
         description: "Path relative to the repository root. Directories are explained as a whole."
       },
       root: ROOT_PROPERTY,
-      outDir: OUT_DIR_PROPERTY
+      outDir: OUT_DIR_PROPERTY,
+      ...SCOPE_PROPERTIES
     },
     required: ["path"],
     additionalProperties: false
@@ -1516,7 +1593,7 @@ var explainTool = {
   },
   annotations: READ_ONLY,
   async handler(args, context) {
-    const prepared = await prepare(args, context, outDirOverride(args));
+    const prepared = await prepare(args, context, workspaceOverrides(args));
     if (!prepared.ok) return prepared.outcome;
     const workspace = prepared.workspace;
     if (typeof args.path !== "string") return failure('"path" must be a string.');
@@ -2298,7 +2375,7 @@ function buildAgentContract() {
         { key: "preset", type: "string", default: "detected", summary: "Force a preset. Unknown names are an error." },
         { key: "maxPartBytes", type: "number | string", default: 307200, summary: "Per-part byte budget." },
         { key: "maxPartTokens", type: "number | string | null", default: null, summary: "Per-part token ceiling; narrows maxPartBytes. Minimum 1024." },
-        { key: "skeleton", type: "boolean", default: false, summary: "Collapse function bodies to `{ /* ... */ }` in TypeScript files." },
+        { key: "skeleton", type: "boolean", default: false, summary: "Collapse function bodies to `{ /* ... */ }` in TS, JS, TSX and JSX files." },
         { key: "sarif", type: "boolean", default: false, summary: "Also write reports/audit.sarif." },
         { key: "changedSince", type: "string | null", default: null, summary: "Snapshot only files that differ from this git ref." },
         { key: "staged", type: "boolean", default: false, summary: "Snapshot only files staged in the index." },
@@ -2671,7 +2748,7 @@ function buildResourceProvider() {
       const report = REPORT_URIS.get(uri);
       if (report) {
         const text = readFileIfPresent(
-          path2.resolve(workspace.root, workspace.config.outDir, "reports", report.file)
+          path.resolve(workspace.root, workspace.config.outDir, "reports", report.file)
         );
         if (text === null) return null;
         return { uri, mimeType: "text/markdown", text: capUtf8(text, MAX_RESOURCE_BYTES).text };
@@ -2689,9 +2766,9 @@ function buildResourceProvider() {
         const index = Number(partMatch[1]);
         const part = read.manifest.parts.find((candidate) => candidate.index === index);
         if (!part) return null;
-        const text = readFileIfPresent(
-          path2.resolve(workspace.root, workspace.config.outDir, "parts", part.filename)
-        );
+        const partPath = partPathFor(workspace, part.filename);
+        if (partPath === null) return null;
+        const text = readFileIfPresent(partPath);
         if (text === null) return null;
         return { uri, mimeType: "text/markdown", text: capUtf8(text, MAX_RESOURCE_BYTES).text };
       }
@@ -2735,6 +2812,7 @@ function createWriter(output) {
 }
 function createLineReader(input, options) {
   let buffer = "";
+  let bufferBytes = 0;
   let discarding = false;
   let discardedBytes = 0;
   const deliver = (line) => {
@@ -2747,6 +2825,13 @@ function createLineReader(input, options) {
     if (trimmed.trim().length === 0) return;
     options.onLine(trimmed);
   };
+  const discardBuffered = () => {
+    discarding = true;
+    discardedBytes += bufferBytes;
+    buffer = "";
+    bufferBytes = 0;
+    options.onOverflow?.(discardedBytes);
+  };
   const drain = () => {
     let index = buffer.indexOf("\n");
     while (index >= 0) {
@@ -2754,42 +2839,57 @@ function createLineReader(input, options) {
       buffer = buffer.slice(index + 1);
       if (discarding) {
         deliver(line);
-      } else if (line.length > MAX_LINE_BYTES) {
-        options.onOverflow?.(line.length);
       } else {
-        deliver(line);
+        const lineBytes = Buffer.byteLength(line, "utf8");
+        if (lineBytes > MAX_LINE_BYTES) options.onOverflow?.(lineBytes);
+        else deliver(line);
       }
       index = buffer.indexOf("\n");
     }
+    bufferBytes = Buffer.byteLength(buffer, "utf8");
+    if (!discarding && bufferBytes > MAX_LINE_BYTES) discardBuffered();
   };
   const onData = (chunk) => {
+    const chunkBytes = Buffer.byteLength(chunk, "utf8");
     if (discarding) {
       const index = chunk.indexOf("\n");
       if (index < 0) {
-        discardedBytes += chunk.length;
+        discardedBytes += chunkBytes;
         return;
       }
       buffer = chunk.slice(index + 1);
+      bufferBytes = Buffer.byteLength(buffer, "utf8");
       deliver("");
       drain();
       return;
     }
-    buffer += chunk;
-    drain();
-    if (buffer.length > MAX_LINE_BYTES) {
+    if (chunk.indexOf("\n") < 0 && bufferBytes + chunkBytes > MAX_LINE_BYTES) {
       discarding = true;
-      discardedBytes = buffer.length;
+      discardedBytes = bufferBytes + chunkBytes;
       buffer = "";
+      bufferBytes = 0;
       options.onOverflow?.(discardedBytes);
       return;
     }
+    buffer += chunk;
+    drain();
   };
   const onEnd = () => {
-    if (buffer.length > 0) {
-      const rest = buffer;
-      buffer = "";
-      deliver(rest);
+    const rest = buffer;
+    const restBytes = bufferBytes || Buffer.byteLength(rest, "utf8");
+    buffer = "";
+    bufferBytes = 0;
+    if (rest.length === 0) return;
+    if (discarding) {
+      discarding = false;
+      discardedBytes = 0;
+      return;
+    }
+    if (restBytes > MAX_LINE_BYTES) {
+      options.onOverflow?.(restBytes);
+      return;
     }
+    deliver(rest);
   };
   input.setEncoding("utf8");
   input.on("data", onData);