codebase-snapshot 0.9.6 → 0.9.8

package/CHANGELOG.md

@@ -21,6 +21,57 @@ Two versions exist on the registry that are not releases, and both are deprecate
 Deleting them requires account-level rights that the release pipeline does not have, so they are
 deprecated with an explanatory message instead. `latest` has pointed at 0.9.0 since it existed.
 
+## 0.9.8
+
+### A wrapped menu no longer changes height under the cursor
+
+Found while checking 0.9.7, by rendering it at 48 columns. The wrapping added there made a frame
+the height it claimed to be, but the wrap point was measured from a line's leading whitespace — and
+a selected row starts `  ❯ ` while an unselected one starts `    `. So the same hint wrapped one
+word differently depending on whether the cursor was on it, and at some widths the whole menu grew
+a row as you moved through it.
+
+Continuation rows now line up with the *content*: the marker gutter is measured rather than guessed,
+which keeps the wrap stable — and puts a wrapped hint under the label instead of two columns past
+it, which reads better at any width.
+
+`tests/wizard-frame.test.js` now also asserts that five repaints of the same menu are all the same
+height, at 48 columns: the width where it used to flicker.
+
+## 0.9.7
+
+### The setup menu stops eating its own screen
+
+Reported with a screenshot from a terminal about 70 columns wide: every keypress on `snapshot`'s
+first question added another `◆ How should I set this up?` line, until 28 of them were piled above
+the live menu.
+
+The wizard repaints a prompt in place by moving the cursor up by the height of the last frame it
+drew — and it counted that height in *lines*, while a terminal lays out *rows*. The recommended
+answer carries the hint `node-lib · config · npm scripts · install · generate`, which makes that
+line 83 cells wide. In a narrow terminal the terminal wrapped it into two rows itself, so the frame
+was one row taller than the erase believed, and moving up one row short left the top of the old
+frame behind. Every keypress. Notice that the leftover was always exactly one line: the question.
+
+Frames are now wrapped to the visible width before they are drawn, so the height that is counted is
+the height that is shown. Continuation lines keep their indent, a token longer than the line breaks
+rather than overflowing it, and the width is re-read on every draw so a window that changed size is
+measured as it is now rather than as it was. Two cells of slack are left for `◆ ❯ ◻ ←`, which some
+fonts draw double-width.
+
+No existing test could have caught this: every one of them pinned `columns` to 120, where nothing
+wraps and the two counts agree. `tests/wizard-frame.test.js` drives the real wizard at 70, 60 and 50
+columns, replays the escape sequences through a small terminal simulator, and asserts that the
+screen shows one question rather than one per keypress. Putting the old arithmetic back turns three
+of its seven tests red.
+
+### Install pins in the docs are now maintained, not remembered
+
+`docs/mcp.md` told clients to run `codebase-snapshot@0.9.6` in four places that have to change at
+every release, and a comment marker cannot live inside a JSON fence. `sync-docs` now rewrites any
+`codebase-snapshot@x.y.z` pin and the `Added devDependency:` examples by shape, so the next release
+cannot leave a copy-pasteable snippet pointing at an old version. `@latest` is untouched.
+
 ## 0.9.6
 
 ### It tells you when it is out of date

package/README.md

@@ -200,7 +200,7 @@ Everything an agent needs is available as data, and the tool can install its own
 ```bash
 npx codebase-snapshot describe --format json   # contract: workflow, options, exit codes
 npx codebase-snapshot skill --install          # into .claude/skills + .cursor/rules
-npx -y codebase-snapshot@0.9.6 mcp             # or serve it over MCP
+npx -y codebase-snapshot@0.9.8 mcp             # or serve it over MCP
 ```
 
 An agent told only "use `npx codebase-snapshot`" can read the contract, follow its ordered

package/dist/bin.js

@@ -4346,7 +4346,7 @@ function gitignorePath(cwd, filePath) {
 
 // src/version.ts
 var GENERATOR_NAME = "codebase-snapshot";
-var GENERATOR_VERSION = "0.9.6";
+var GENERATOR_VERSION = "0.9.8";
 var LEGACY_GENERATOR_NAMES = ["@ankurhalder/codebase-snapshot"];
 function isOurGeneratorName(name) {
   if (typeof name !== "string") return false;
@@ -4509,6 +4509,59 @@ function toggleIndex(selected, index) {
   else next.add(index);
   return next;
 }
+function isWideCodePoint(code) {
+  return code >= 4352 && code <= 4447 || // Hangul Jamo
+  code >= 11904 && code <= 12350 || // CJK radicals, Kangxi, CJK symbols
+  code >= 12353 && code <= 13311 || // kana through CJK compatibility
+  code >= 13312 && code <= 19903 || // CJK extension A
+  code >= 19968 && code <= 40959 || // CJK unified ideographs
+  code >= 40960 && code <= 42191 || // Yi
+  code >= 44032 && code <= 55203 || // Hangul syllables
+  code >= 63744 && code <= 64255 || // CJK compatibility ideographs
+  code >= 65072 && code <= 65135 || // CJK compatibility forms
+  code >= 65280 && code <= 65376 || // fullwidth forms
+  code >= 65504 && code <= 65510 || code >= 127744 && code <= 129535 || // emoji and pictographs
+  code >= 131072 && code <= 262141;
+}
+var ANSI_PATTERN = /\u001b\[[0-9;?]*[A-Za-z]/g;
+function displayWidth(line) {
+  let width = 0;
+  for (const character of line.replace(ANSI_PATTERN, "")) {
+    width += isWideCodePoint(character.codePointAt(0) ?? 0) ? 2 : 1;
+  }
+  return width;
+}
+var GUTTER_PATTERN = /^[ \t]*(?:[❯◆◻◼▏✖][ \t]+)*/;
+function wrapOneLine(line, limit) {
+  if (displayWidth(line) <= limit) return [line];
+  const gutter = GUTTER_PATTERN.exec(line)?.[0] ?? "";
+  const gutterWidth = displayWidth(gutter);
+  const continuation = " ".repeat(gutterWidth);
+  const rows = [];
+  let prefix = gutter;
+  let rest = line.slice(gutter.length).trimEnd();
+  while (rest.length > 0) {
+    const room = limit - displayWidth(prefix);
+    if (room <= 0 || displayWidth(rest) <= room) {
+      rows.push(prefix + rest);
+      break;
+    }
+    let cut = room;
+    const space = rest.slice(0, room).lastIndexOf(" ");
+    if (space > 0) cut = space;
+    const taken = rest.slice(0, cut).trimEnd();
+    rows.push(`${prefix}${taken.length > 0 ? taken : rest.slice(0, cut)}`);
+    rest = rest.slice(cut).trimStart();
+    prefix = continuation;
+  }
+  return rows;
+}
+function wrapLines(text2, limit) {
+  const width = Math.max(8, Math.floor(limit));
+  const rows = [];
+  for (const line of text2.split("\n")) rows.push(...wrapOneLine(line, width));
+  return rows;
+}
 function marker(active) {
   return active ? "\u276F" : " ";
 }
@@ -4586,14 +4639,27 @@ var Frame = class {
   drawn = 0;
   draw(text2) {
     this.erase();
-    this.output.write(`${text2}
+    const rows = wrapLines(text2, this.width());
+    this.output.write(`${rows.join("\n")}
 `);
-    this.drawn = text2.split("\n").length;
+    this.drawn = rows.length;
   }
   erase() {
     if (this.drawn > 0) this.output.write(`\x1B[${this.drawn}A\x1B[0J`);
     this.drawn = 0;
   }
+  /**
+   * The usable width, in cells.
+   *
+   * Two cells of slack: an ambiguous-width glyph (`◆`, `❯`, `←`) renders two cells in some fonts
+   * and one in others, and a row that lands exactly on the last column is the one case a terminal
+   * may or may not wrap. Below that, a line cannot reach the edge to begin with.
+   */
+  width() {
+    const columns = this.output.columns;
+    if (typeof columns !== "number" || !Number.isFinite(columns) || columns <= 0) return 80;
+    return Math.max(8, Math.floor(columns) - 2);
+  }
 };
 function isCancel(key) {
   return key.ctrl === true && key.name === "c" || key.ctrl === true && key.name === "d";

package/dist/{chunk-3KUL3QRH.js → chunk-C24OAT6T.js}

@@ -5474,7 +5474,7 @@ function validateSnapshot(configInput) {
 
 // src/version.ts
 var GENERATOR_NAME = "codebase-snapshot";
-var GENERATOR_VERSION = "0.9.6";
+var GENERATOR_VERSION = "0.9.8";
 var LEGACY_GENERATOR_NAMES = ["@ankurhalder/codebase-snapshot"];
 function isOurGeneratorName(name) {
   if (typeof name !== "string") return false;
@@ -6228,6 +6228,59 @@ function toggleIndex(selected, index) {
   else next.add(index);
   return next;
 }
+function isWideCodePoint(code) {
+  return code >= 4352 && code <= 4447 || // Hangul Jamo
+  code >= 11904 && code <= 12350 || // CJK radicals, Kangxi, CJK symbols
+  code >= 12353 && code <= 13311 || // kana through CJK compatibility
+  code >= 13312 && code <= 19903 || // CJK extension A
+  code >= 19968 && code <= 40959 || // CJK unified ideographs
+  code >= 40960 && code <= 42191 || // Yi
+  code >= 44032 && code <= 55203 || // Hangul syllables
+  code >= 63744 && code <= 64255 || // CJK compatibility ideographs
+  code >= 65072 && code <= 65135 || // CJK compatibility forms
+  code >= 65280 && code <= 65376 || // fullwidth forms
+  code >= 65504 && code <= 65510 || code >= 127744 && code <= 129535 || // emoji and pictographs
+  code >= 131072 && code <= 262141;
+}
+var ANSI_PATTERN = /\u001b\[[0-9;?]*[A-Za-z]/g;
+function displayWidth(line) {
+  let width = 0;
+  for (const character of line.replace(ANSI_PATTERN, "")) {
+    width += isWideCodePoint(character.codePointAt(0) ?? 0) ? 2 : 1;
+  }
+  return width;
+}
+var GUTTER_PATTERN = /^[ \t]*(?:[❯◆◻◼▏✖][ \t]+)*/;
+function wrapOneLine(line, limit) {
+  if (displayWidth(line) <= limit) return [line];
+  const gutter = GUTTER_PATTERN.exec(line)?.[0] ?? "";
+  const gutterWidth = displayWidth(gutter);
+  const continuation = " ".repeat(gutterWidth);
+  const rows = [];
+  let prefix = gutter;
+  let rest = line.slice(gutter.length).trimEnd();
+  while (rest.length > 0) {
+    const room = limit - displayWidth(prefix);
+    if (room <= 0 || displayWidth(rest) <= room) {
+      rows.push(prefix + rest);
+      break;
+    }
+    let cut = room;
+    const space = rest.slice(0, room).lastIndexOf(" ");
+    if (space > 0) cut = space;
+    const taken = rest.slice(0, cut).trimEnd();
+    rows.push(`${prefix}${taken.length > 0 ? taken : rest.slice(0, cut)}`);
+    rest = rest.slice(cut).trimStart();
+    prefix = continuation;
+  }
+  return rows;
+}
+function wrapLines(text2, limit) {
+  const width = Math.max(8, Math.floor(limit));
+  const rows = [];
+  for (const line of text2.split("\n")) rows.push(...wrapOneLine(line, width));
+  return rows;
+}
 function marker(active) {
   return active ? "\u276F" : " ";
 }
@@ -6305,14 +6358,27 @@ var Frame = class {
   drawn = 0;
   draw(text2) {
     this.erase();
-    this.output.write(`${text2}
+    const rows = wrapLines(text2, this.width());
+    this.output.write(`${rows.join("\n")}
 `);
-    this.drawn = text2.split("\n").length;
+    this.drawn = rows.length;
   }
   erase() {
     if (this.drawn > 0) this.output.write(`\x1B[${this.drawn}A\x1B[0J`);
     this.drawn = 0;
   }
+  /**
+   * The usable width, in cells.
+   *
+   * Two cells of slack: an ambiguous-width glyph (`◆`, `❯`, `←`) renders two cells in some fonts
+   * and one in others, and a row that lands exactly on the last column is the one case a terminal
+   * may or may not wrap. Below that, a line cannot reach the edge to begin with.
+   */
+  width() {
+    const columns = this.output.columns;
+    if (typeof columns !== "number" || !Number.isFinite(columns) || columns <= 0) return 80;
+    return Math.max(8, Math.floor(columns) - 2);
+  }
 };
 function isCancel(key) {
   return key.ctrl === true && key.name === "c" || key.ctrl === true && key.name === "d";
@@ -8257,6 +8323,6 @@ async function generateSnapshotAsync(configInput, options) {
   return generateSnapshot(configInput, options);
 }
 
-export { ARTIFACT_NAMES, CHECK_INTERVAL_MS, DEFAULT_ANSWERS, DEFAULT_SECRET_PATTERNS, FAILURE_INTERVAL_MS, GENERATOR_NAME, GENERATOR_VERSION, LANGUAGE_PROFILES, MIN_MAX_PART_BYTES, PACKAGE_LATEST_URL, PRESETS, PromptCancelled, REQUEST_TIMEOUT_MS, SCHEMA_VERSION, anchorForPath, appendGitignoreEntries, assertReplaceable, assertUsableConfigInput, cacheDirectory, cacheFilePath, checkForUpdate, collectFiles, compareManifests, countInvalidUtf8Bytes, countLines, decodeText, defaultIO, defineConfig, describeManifestShapeProblem, detectLanguage, detectPreset, escapeControls, explainPath, fenceForContent, fenceForText, fetchLatestVersion, findConfigFile, firstRunMessage, formatNumber, formatUpdateNotice, generateProjectTree, generateSnapshot, generateSnapshotAsync, getPreset, gitignorePath, globToRegExp, hasPriorSnapshot, isBinaryBuffer, isBinaryExtension, isBinaryFile, isDiscoveryMode, isEffectivelyEmpty, isInteractive, isNewer, isResolvedConfig, isSensitivePath, listPresetNames, loadConfigFile, loadConfigFileDetailed, loadManifest, markResolvedConfig, matchRule, matchesExclude, normalizeResolvedConfig, parseByteSize, partitionFiles, planFirstRun, profileForPath, renderConfig, renderDiffText, renderExplainText, renumberParts, resolveConfig, resolveSafeOutputDirs, runInit, scanAndRedactSecrets, shouldCheck, stripJsonComments, summarizeJson, summarizeMarkdown, summarizeTypeScriptSource, summarizeWithProfile, supportsTypeScriptImports, truncatePreview, truncateToBytes, unknownPresetMessage, validateSnapshot };
-//# sourceMappingURL=chunk-3KUL3QRH.js.map
-//# sourceMappingURL=chunk-3KUL3QRH.js.map
+export { ARTIFACT_NAMES, CHECK_INTERVAL_MS, DEFAULT_ANSWERS, DEFAULT_SECRET_PATTERNS, FAILURE_INTERVAL_MS, GENERATOR_NAME, GENERATOR_VERSION, LANGUAGE_PROFILES, MIN_MAX_PART_BYTES, PACKAGE_LATEST_URL, PRESETS, PromptBack, PromptCancelled, REQUEST_TIMEOUT_MS, SCHEMA_VERSION, anchorForPath, appendGitignoreEntries, assertReplaceable, assertUsableConfigInput, cacheDirectory, cacheFilePath, checkForUpdate, collectFiles, compareManifests, countInvalidUtf8Bytes, countLines, decodeText, defaultIO, defineConfig, describeManifestShapeProblem, detectLanguage, detectPreset, displayWidth, escapeControls, explainPath, fenceForContent, fenceForText, fetchLatestVersion, findConfigFile, firstRunMessage, formatNumber, formatUpdateNotice, generateProjectTree, generateSnapshot, generateSnapshotAsync, getPreset, gitignorePath, globToRegExp, hasPriorSnapshot, isBinaryBuffer, isBinaryExtension, isBinaryFile, isDiscoveryMode, isEffectivelyEmpty, isInteractive, isNewer, isResolvedConfig, isSensitivePath, listPresetNames, loadConfigFile, loadConfigFileDetailed, loadManifest, markResolvedConfig, matchRule, matchesExclude, normalizeResolvedConfig, parseByteSize, partitionFiles, planFirstRun, profileForPath, renderConfig, renderDiffText, renderExplainText, renumberParts, resolveConfig, resolveSafeOutputDirs, runInit, scanAndRedactSecrets, shouldCheck, stripJsonComments, summarizeJson, summarizeMarkdown, summarizeTypeScriptSource, summarizeWithProfile, supportsTypeScriptImports, truncatePreview, truncateToBytes, unknownPresetMessage, validateSnapshot, wrapLines };
+//# sourceMappingURL=chunk-C24OAT6T.js.map
+//# sourceMappingURL=chunk-C24OAT6T.js.map

package/dist/{chunk-ZKZOGGM3.js → chunk-RQKXZOD7.js}

@@ -1,4 +1,4 @@
-import { GENERATOR_VERSION, MIN_MAX_PART_BYTES, SCHEMA_VERSION, GENERATOR_NAME, ARTIFACT_NAMES, PRESETS, generateSnapshot, validateSnapshot, explainPath, renderExplainText, describeManifestShapeProblem, loadConfigFileDetailed, parseByteSize, resolveConfig } from './chunk-3KUL3QRH.js';
+import { GENERATOR_VERSION, MIN_MAX_PART_BYTES, SCHEMA_VERSION, GENERATOR_NAME, ARTIFACT_NAMES, PRESETS, generateSnapshot, validateSnapshot, explainPath, renderExplainText, describeManifestShapeProblem, loadConfigFileDetailed, parseByteSize, resolveConfig } from './chunk-C24OAT6T.js';
 import * as fs from 'fs';
 import * as path2 from 'path';
 
@@ -2599,5 +2599,5 @@ async function runStdioServer(options) {
 }
 
 export { COMMAND_OPTION_SCOPE, ERROR_CODES, LEGACY_PROTOCOL_VERSIONS, MAX_LINE_BYTES, METHOD, MODERN_PROTOCOL_VERSIONS, SERVER_INSTRUCTIONS, SKILL_NAME, SUPPORTED_PROTOCOL_VERSIONS, buildAgentContract, buildPrompts, buildResourceProvider, buildTools, classifyRequest, coerceNumericStrings, commandsForOption, createLineReader, createMcpServer, createServer, createSession, createWriter, inspectModernMeta, negotiateLegacyVersion, renderContractText, renderSkill, runStdioServer, validateArguments };
-//# sourceMappingURL=chunk-ZKZOGGM3.js.map
-//# sourceMappingURL=chunk-ZKZOGGM3.js.map
+//# sourceMappingURL=chunk-RQKXZOD7.js.map
+//# sourceMappingURL=chunk-RQKXZOD7.js.map

package/dist/cli.cjs

@@ -4340,7 +4340,7 @@ function gitignorePath(cwd, filePath) {
 
 // src/version.ts
 var GENERATOR_NAME = "codebase-snapshot";
-var GENERATOR_VERSION = "0.9.6";
+var GENERATOR_VERSION = "0.9.8";
 var LEGACY_GENERATOR_NAMES = ["@ankurhalder/codebase-snapshot"];
 function isOurGeneratorName(name) {
   if (typeof name !== "string") return false;
@@ -4496,6 +4496,59 @@ function toggleIndex(selected, index) {
   else next.add(index);
   return next;
 }
+function isWideCodePoint(code) {
+  return code >= 4352 && code <= 4447 || // Hangul Jamo
+  code >= 11904 && code <= 12350 || // CJK radicals, Kangxi, CJK symbols
+  code >= 12353 && code <= 13311 || // kana through CJK compatibility
+  code >= 13312 && code <= 19903 || // CJK extension A
+  code >= 19968 && code <= 40959 || // CJK unified ideographs
+  code >= 40960 && code <= 42191 || // Yi
+  code >= 44032 && code <= 55203 || // Hangul syllables
+  code >= 63744 && code <= 64255 || // CJK compatibility ideographs
+  code >= 65072 && code <= 65135 || // CJK compatibility forms
+  code >= 65280 && code <= 65376 || // fullwidth forms
+  code >= 65504 && code <= 65510 || code >= 127744 && code <= 129535 || // emoji and pictographs
+  code >= 131072 && code <= 262141;
+}
+var ANSI_PATTERN = /\u001b\[[0-9;?]*[A-Za-z]/g;
+function displayWidth(line) {
+  let width = 0;
+  for (const character of line.replace(ANSI_PATTERN, "")) {
+    width += isWideCodePoint(character.codePointAt(0) ?? 0) ? 2 : 1;
+  }
+  return width;
+}
+var GUTTER_PATTERN = /^[ \t]*(?:[❯◆◻◼▏✖][ \t]+)*/;
+function wrapOneLine(line, limit) {
+  if (displayWidth(line) <= limit) return [line];
+  const gutter = GUTTER_PATTERN.exec(line)?.[0] ?? "";
+  const gutterWidth = displayWidth(gutter);
+  const continuation = " ".repeat(gutterWidth);
+  const rows = [];
+  let prefix = gutter;
+  let rest = line.slice(gutter.length).trimEnd();
+  while (rest.length > 0) {
+    const room = limit - displayWidth(prefix);
+    if (room <= 0 || displayWidth(rest) <= room) {
+      rows.push(prefix + rest);
+      break;
+    }
+    let cut = room;
+    const space = rest.slice(0, room).lastIndexOf(" ");
+    if (space > 0) cut = space;
+    const taken = rest.slice(0, cut).trimEnd();
+    rows.push(`${prefix}${taken.length > 0 ? taken : rest.slice(0, cut)}`);
+    rest = rest.slice(cut).trimStart();
+    prefix = continuation;
+  }
+  return rows;
+}
+function wrapLines(text2, limit) {
+  const width = Math.max(8, Math.floor(limit));
+  const rows = [];
+  for (const line of text2.split("\n")) rows.push(...wrapOneLine(line, width));
+  return rows;
+}
 function marker(active) {
   return active ? "\u276F" : " ";
 }
@@ -4573,14 +4626,27 @@ var Frame = class {
   drawn = 0;
   draw(text2) {
     this.erase();
-    this.output.write(`${text2}
+    const rows = wrapLines(text2, this.width());
+    this.output.write(`${rows.join("\n")}
 `);
-    this.drawn = text2.split("\n").length;
+    this.drawn = rows.length;
   }
   erase() {
     if (this.drawn > 0) this.output.write(`\x1B[${this.drawn}A\x1B[0J`);
     this.drawn = 0;
   }
+  /**
+   * The usable width, in cells.
+   *
+   * Two cells of slack: an ambiguous-width glyph (`◆`, `❯`, `←`) renders two cells in some fonts
+   * and one in others, and a row that lands exactly on the last column is the one case a terminal
+   * may or may not wrap. Below that, a line cannot reach the edge to begin with.
+   */
+  width() {
+    const columns = this.output.columns;
+    if (typeof columns !== "number" || !Number.isFinite(columns) || columns <= 0) return 80;
+    return Math.max(8, Math.floor(columns) - 2);
+  }
 };
 function isCancel(key) {
   return key.ctrl === true && key.name === "c" || key.ctrl === true && key.name === "d";

package/dist/cli.js

@@ -1,5 +1,5 @@
-import { buildAgentContract, runStdioServer, COMMAND_OPTION_SCOPE, commandsForOption, SKILL_NAME, renderSkill, renderContractText } from './chunk-ZKZOGGM3.js';
-import { shouldCheck, checkForUpdate, GENERATOR_VERSION, cacheFilePath, formatUpdateNotice, loadConfigFileDetailed, resolveConfig, validateSnapshot, describeManifestShapeProblem, explainPath, compareManifests, loadManifest, renderDiffText, generateSnapshot, formatNumber, isDiscoveryMode, ARTIFACT_NAMES, getPreset, unknownPresetMessage, GENERATOR_NAME, runInit, PromptCancelled, planFirstRun, isEffectivelyEmpty, isInteractive, defaultIO, hasPriorSnapshot, DEFAULT_ANSWERS, findConfigFile, firstRunMessage, parseByteSize, gitignorePath, appendGitignoreEntries, escapeControls, MIN_MAX_PART_BYTES, renderExplainText } from './chunk-3KUL3QRH.js';
+import { buildAgentContract, runStdioServer, COMMAND_OPTION_SCOPE, commandsForOption, SKILL_NAME, renderSkill, renderContractText } from './chunk-RQKXZOD7.js';
+import { shouldCheck, checkForUpdate, GENERATOR_VERSION, cacheFilePath, formatUpdateNotice, loadConfigFileDetailed, resolveConfig, validateSnapshot, describeManifestShapeProblem, explainPath, compareManifests, loadManifest, renderDiffText, generateSnapshot, formatNumber, isDiscoveryMode, ARTIFACT_NAMES, getPreset, unknownPresetMessage, GENERATOR_NAME, runInit, PromptCancelled, planFirstRun, isEffectivelyEmpty, isInteractive, defaultIO, hasPriorSnapshot, DEFAULT_ANSWERS, findConfigFile, firstRunMessage, parseByteSize, gitignorePath, appendGitignoreEntries, escapeControls, MIN_MAX_PART_BYTES, renderExplainText } from './chunk-C24OAT6T.js';
 import { spawnSync } from 'child_process';
 import * as fs from 'fs';
 import * as path2 from 'path';

package/dist/index.cjs

@@ -5490,7 +5490,7 @@ function validateSnapshot(configInput) {
 
 // src/version.ts
 var GENERATOR_NAME = "codebase-snapshot";
-var GENERATOR_VERSION = "0.9.6";
+var GENERATOR_VERSION = "0.9.8";
 var LEGACY_GENERATOR_NAMES = ["@ankurhalder/codebase-snapshot"];
 function isOurGeneratorName(name) {
   if (typeof name !== "string") return false;
@@ -6241,6 +6241,59 @@ function toggleIndex(selected, index) {
   else next.add(index);
   return next;
 }
+function isWideCodePoint(code) {
+  return code >= 4352 && code <= 4447 || // Hangul Jamo
+  code >= 11904 && code <= 12350 || // CJK radicals, Kangxi, CJK symbols
+  code >= 12353 && code <= 13311 || // kana through CJK compatibility
+  code >= 13312 && code <= 19903 || // CJK extension A
+  code >= 19968 && code <= 40959 || // CJK unified ideographs
+  code >= 40960 && code <= 42191 || // Yi
+  code >= 44032 && code <= 55203 || // Hangul syllables
+  code >= 63744 && code <= 64255 || // CJK compatibility ideographs
+  code >= 65072 && code <= 65135 || // CJK compatibility forms
+  code >= 65280 && code <= 65376 || // fullwidth forms
+  code >= 65504 && code <= 65510 || code >= 127744 && code <= 129535 || // emoji and pictographs
+  code >= 131072 && code <= 262141;
+}
+var ANSI_PATTERN = /\u001b\[[0-9;?]*[A-Za-z]/g;
+function displayWidth(line) {
+  let width = 0;
+  for (const character of line.replace(ANSI_PATTERN, "")) {
+    width += isWideCodePoint(character.codePointAt(0) ?? 0) ? 2 : 1;
+  }
+  return width;
+}
+var GUTTER_PATTERN = /^[ \t]*(?:[❯◆◻◼▏✖][ \t]+)*/;
+function wrapOneLine(line, limit) {
+  if (displayWidth(line) <= limit) return [line];
+  const gutter = GUTTER_PATTERN.exec(line)?.[0] ?? "";
+  const gutterWidth = displayWidth(gutter);
+  const continuation = " ".repeat(gutterWidth);
+  const rows = [];
+  let prefix = gutter;
+  let rest = line.slice(gutter.length).trimEnd();
+  while (rest.length > 0) {
+    const room = limit - displayWidth(prefix);
+    if (room <= 0 || displayWidth(rest) <= room) {
+      rows.push(prefix + rest);
+      break;
+    }
+    let cut = room;
+    const space = rest.slice(0, room).lastIndexOf(" ");
+    if (space > 0) cut = space;
+    const taken = rest.slice(0, cut).trimEnd();
+    rows.push(`${prefix}${taken.length > 0 ? taken : rest.slice(0, cut)}`);
+    rest = rest.slice(cut).trimStart();
+    prefix = continuation;
+  }
+  return rows;
+}
+function wrapLines(text2, limit) {
+  const width = Math.max(8, Math.floor(limit));
+  const rows = [];
+  for (const line of text2.split("\n")) rows.push(...wrapOneLine(line, width));
+  return rows;
+}
 function marker(active) {
   return active ? "\u276F" : " ";
 }
@@ -6318,14 +6371,27 @@ var Frame = class {
   drawn = 0;
   draw(text2) {
     this.erase();
-    this.output.write(`${text2}
+    const rows = wrapLines(text2, this.width());
+    this.output.write(`${rows.join("\n")}
 `);
-    this.drawn = text2.split("\n").length;
+    this.drawn = rows.length;
   }
   erase() {
     if (this.drawn > 0) this.output.write(`\x1B[${this.drawn}A\x1B[0J`);
     this.drawn = 0;
   }
+  /**
+   * The usable width, in cells.
+   *
+   * Two cells of slack: an ambiguous-width glyph (`◆`, `❯`, `←`) renders two cells in some fonts
+   * and one in others, and a row that lands exactly on the last column is the one case a terminal
+   * may or may not wrap. Below that, a line cannot reach the edge to begin with.
+   */
+  width() {
+    const columns = this.output.columns;
+    if (typeof columns !== "number" || !Number.isFinite(columns) || columns <= 0) return 80;
+    return Math.max(8, Math.floor(columns) - 2);
+  }
 };
 function isCancel(key) {
   return key.ctrl === true && key.name === "c" || key.ctrl === true && key.name === "d";
@@ -8281,6 +8347,7 @@ exports.LANGUAGE_PROFILES = LANGUAGE_PROFILES;
 exports.MIN_MAX_PART_BYTES = MIN_MAX_PART_BYTES;
 exports.PACKAGE_LATEST_URL = PACKAGE_LATEST_URL;
 exports.PRESETS = PRESETS;
+exports.PromptBack = PromptBack;
 exports.PromptCancelled = PromptCancelled;
 exports.REQUEST_TIMEOUT_MS = REQUEST_TIMEOUT_MS;
 exports.SCHEMA_VERSION = SCHEMA_VERSION;
@@ -8298,6 +8365,7 @@ exports.decodeText = decodeText;
 exports.defineConfig = defineConfig;
 exports.detectLanguage = detectLanguage;
 exports.detectPreset = detectPreset;
+exports.displayWidth = displayWidth;
 exports.explainPath = explainPath;
 exports.fenceForContent = fenceForContent;
 exports.fenceForText = fenceForText;
@@ -8348,5 +8416,6 @@ exports.supportsTypeScriptImports = supportsTypeScriptImports;
 exports.truncatePreview = truncatePreview;
 exports.truncateToBytes = truncateToBytes;
 exports.validateSnapshot = validateSnapshot;
+exports.wrapLines = wrapLines;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/index.d.cts

@@ -422,7 +422,7 @@ declare function validateSnapshot(configInput: ResolvedSnapshotConfig | Snapshot
  * `package.json` carries the same version; `npm run verify` compares the two.
  */
 declare const GENERATOR_NAME = "codebase-snapshot";
-declare const GENERATOR_VERSION = "0.9.6";
+declare const GENERATOR_VERSION = "0.9.8";
 
 /** The one endpoint this package will ever request. */
 declare const PACKAGE_LATEST_URL = "https://registry.npmjs.org/codebase-snapshot/latest";
@@ -613,8 +613,22 @@ interface PromptIO {
 declare class PromptCancelled extends Error {
     constructor();
 }
+/** Thrown when the developer asks to return to the previous question. */
+declare class PromptBack extends Error {
+    constructor();
+}
 /** Both ends must be a TTY before anything interactive is attempted. */
 declare function isInteractive(io: PromptIO): boolean;
+/** Cells a line occupies on screen. Escape sequences occupy none. */
+declare function displayWidth(line: string): number;
+/**
+ * Breaks a block so that no row is wider than `limit` cells.
+ *
+ * A terminal wraps anything wider than itself without saying so, which is the whole reason this
+ * exists: a frame that wraps behind the renderer's back is one row taller than it claims to be.
+ * See {@link Frame}.
+ */
+declare function wrapLines(text: string, limit: number): string[];
 
 interface InitOptions {
     cwd: string;
@@ -865,4 +879,4 @@ declare function generateSnapshot(configInput?: SnapshotConfig | ResolvedSnapsho
 /** Promise-returning wrapper for consumers that prefer an async call site. */
 declare function generateSnapshotAsync(configInput?: SnapshotConfig | ResolvedSnapshotConfig | null, options?: GenerateOptions): Promise<Manifest>;
 
-export { ARTIFACT_NAMES, ArtifactSelection, ByteSize, CHECK_INTERVAL_MS, CliOptions, DEFAULT_ANSWERS, DEFAULT_SECRET_PATTERNS, DiscoveryMode, type ExplainResult, FAILURE_INTERVAL_MS, FileEntry, type FirstRunFacts, type FirstRunPlan, type FirstRunRefusal, GENERATOR_NAME, GENERATOR_VERSION, type GenerateOptions, type HeuristicResult, type InitDependency, type InitOptions, type InitResult, JsonSummary, KindRule, LANGUAGE_PROFILES, type LanguageProfile, LayerRule, MIN_MAX_PART_BYTES, Manifest, type ManifestDiff, MarkdownSummary, PACKAGE_LATEST_URL, PRESETS, PartMetadata, PromptCancelled, REQUEST_TIMEOUT_MS, ResolvedSnapshotConfig, SCHEMA_VERSION, SecretFinding, SecretRule, SkipRecord, SnapshotConfig, SourceSummary, TextEncoding, type UpdateCheckOptions, type UpdateNotice, ValidationResult, type WizardAnswers, anchorForPath, assertReplaceable, assertUsableConfigInput, cacheDirectory, cacheFilePath, checkForUpdate, collectFiles, compareManifests, countInvalidUtf8Bytes, countLines, decodeText, defineConfig, detectLanguage, detectPreset, explainPath, fenceForContent, fenceForText, fetchLatestVersion, firstRunMessage, formatUpdateNotice, generateProjectTree, generateSnapshot, generateSnapshotAsync, getPreset, globToRegExp, hasPriorSnapshot, isBinaryBuffer, isBinaryExtension, isBinaryFile, isEffectivelyEmpty, isInteractive, isNewer, isResolvedConfig, isSensitivePath, listPresetNames, loadConfigFile, loadConfigFileDetailed, loadManifest, markResolvedConfig, matchRule, matchesExclude, normalizeResolvedConfig, parseByteSize, partitionFiles, planFirstRun, profileForPath, renderConfig, renderDiffText, renderExplainText, renumberParts, resolveConfig, resolveSafeOutputDirs, runInit, scanAndRedactSecrets, shouldCheck, stripJsonComments, summarizeJson, summarizeMarkdown, summarizeTypeScriptSource, summarizeWithProfile, supportsTypeScriptImports, truncatePreview, truncateToBytes, validateSnapshot };
+export { ARTIFACT_NAMES, ArtifactSelection, ByteSize, CHECK_INTERVAL_MS, CliOptions, DEFAULT_ANSWERS, DEFAULT_SECRET_PATTERNS, DiscoveryMode, type ExplainResult, FAILURE_INTERVAL_MS, FileEntry, type FirstRunFacts, type FirstRunPlan, type FirstRunRefusal, GENERATOR_NAME, GENERATOR_VERSION, type GenerateOptions, type HeuristicResult, type InitDependency, type InitOptions, type InitResult, JsonSummary, KindRule, LANGUAGE_PROFILES, type LanguageProfile, LayerRule, MIN_MAX_PART_BYTES, Manifest, type ManifestDiff, MarkdownSummary, PACKAGE_LATEST_URL, PRESETS, PartMetadata, PromptBack, PromptCancelled, REQUEST_TIMEOUT_MS, ResolvedSnapshotConfig, SCHEMA_VERSION, SecretFinding, SecretRule, SkipRecord, SnapshotConfig, SourceSummary, TextEncoding, type UpdateCheckOptions, type UpdateNotice, ValidationResult, type WizardAnswers, anchorForPath, assertReplaceable, assertUsableConfigInput, cacheDirectory, cacheFilePath, checkForUpdate, collectFiles, compareManifests, countInvalidUtf8Bytes, countLines, decodeText, defineConfig, detectLanguage, detectPreset, displayWidth, explainPath, fenceForContent, fenceForText, fetchLatestVersion, firstRunMessage, formatUpdateNotice, generateProjectTree, generateSnapshot, generateSnapshotAsync, getPreset, globToRegExp, hasPriorSnapshot, isBinaryBuffer, isBinaryExtension, isBinaryFile, isEffectivelyEmpty, isInteractive, isNewer, isResolvedConfig, isSensitivePath, listPresetNames, loadConfigFile, loadConfigFileDetailed, loadManifest, markResolvedConfig, matchRule, matchesExclude, normalizeResolvedConfig, parseByteSize, partitionFiles, planFirstRun, profileForPath, renderConfig, renderDiffText, renderExplainText, renumberParts, resolveConfig, resolveSafeOutputDirs, runInit, scanAndRedactSecrets, shouldCheck, stripJsonComments, summarizeJson, summarizeMarkdown, summarizeTypeScriptSource, summarizeWithProfile, supportsTypeScriptImports, truncatePreview, truncateToBytes, validateSnapshot, wrapLines };

package/dist/index.d.ts

@@ -422,7 +422,7 @@ declare function validateSnapshot(configInput: ResolvedSnapshotConfig | Snapshot
  * `package.json` carries the same version; `npm run verify` compares the two.
  */
 declare const GENERATOR_NAME = "codebase-snapshot";
-declare const GENERATOR_VERSION = "0.9.6";
+declare const GENERATOR_VERSION = "0.9.8";
 
 /** The one endpoint this package will ever request. */
 declare const PACKAGE_LATEST_URL = "https://registry.npmjs.org/codebase-snapshot/latest";
@@ -613,8 +613,22 @@ interface PromptIO {
 declare class PromptCancelled extends Error {
     constructor();
 }
+/** Thrown when the developer asks to return to the previous question. */
+declare class PromptBack extends Error {
+    constructor();
+}
 /** Both ends must be a TTY before anything interactive is attempted. */
 declare function isInteractive(io: PromptIO): boolean;
+/** Cells a line occupies on screen. Escape sequences occupy none. */
+declare function displayWidth(line: string): number;
+/**
+ * Breaks a block so that no row is wider than `limit` cells.
+ *
+ * A terminal wraps anything wider than itself without saying so, which is the whole reason this
+ * exists: a frame that wraps behind the renderer's back is one row taller than it claims to be.
+ * See {@link Frame}.
+ */
+declare function wrapLines(text: string, limit: number): string[];
 
 interface InitOptions {
     cwd: string;
@@ -865,4 +879,4 @@ declare function generateSnapshot(configInput?: SnapshotConfig | ResolvedSnapsho
 /** Promise-returning wrapper for consumers that prefer an async call site. */
 declare function generateSnapshotAsync(configInput?: SnapshotConfig | ResolvedSnapshotConfig | null, options?: GenerateOptions): Promise<Manifest>;
 
-export { ARTIFACT_NAMES, ArtifactSelection, ByteSize, CHECK_INTERVAL_MS, CliOptions, DEFAULT_ANSWERS, DEFAULT_SECRET_PATTERNS, DiscoveryMode, type ExplainResult, FAILURE_INTERVAL_MS, FileEntry, type FirstRunFacts, type FirstRunPlan, type FirstRunRefusal, GENERATOR_NAME, GENERATOR_VERSION, type GenerateOptions, type HeuristicResult, type InitDependency, type InitOptions, type InitResult, JsonSummary, KindRule, LANGUAGE_PROFILES, type LanguageProfile, LayerRule, MIN_MAX_PART_BYTES, Manifest, type ManifestDiff, MarkdownSummary, PACKAGE_LATEST_URL, PRESETS, PartMetadata, PromptCancelled, REQUEST_TIMEOUT_MS, ResolvedSnapshotConfig, SCHEMA_VERSION, SecretFinding, SecretRule, SkipRecord, SnapshotConfig, SourceSummary, TextEncoding, type UpdateCheckOptions, type UpdateNotice, ValidationResult, type WizardAnswers, anchorForPath, assertReplaceable, assertUsableConfigInput, cacheDirectory, cacheFilePath, checkForUpdate, collectFiles, compareManifests, countInvalidUtf8Bytes, countLines, decodeText, defineConfig, detectLanguage, detectPreset, explainPath, fenceForContent, fenceForText, fetchLatestVersion, firstRunMessage, formatUpdateNotice, generateProjectTree, generateSnapshot, generateSnapshotAsync, getPreset, globToRegExp, hasPriorSnapshot, isBinaryBuffer, isBinaryExtension, isBinaryFile, isEffectivelyEmpty, isInteractive, isNewer, isResolvedConfig, isSensitivePath, listPresetNames, loadConfigFile, loadConfigFileDetailed, loadManifest, markResolvedConfig, matchRule, matchesExclude, normalizeResolvedConfig, parseByteSize, partitionFiles, planFirstRun, profileForPath, renderConfig, renderDiffText, renderExplainText, renumberParts, resolveConfig, resolveSafeOutputDirs, runInit, scanAndRedactSecrets, shouldCheck, stripJsonComments, summarizeJson, summarizeMarkdown, summarizeTypeScriptSource, summarizeWithProfile, supportsTypeScriptImports, truncatePreview, truncateToBytes, validateSnapshot };
+export { ARTIFACT_NAMES, ArtifactSelection, ByteSize, CHECK_INTERVAL_MS, CliOptions, DEFAULT_ANSWERS, DEFAULT_SECRET_PATTERNS, DiscoveryMode, type ExplainResult, FAILURE_INTERVAL_MS, FileEntry, type FirstRunFacts, type FirstRunPlan, type FirstRunRefusal, GENERATOR_NAME, GENERATOR_VERSION, type GenerateOptions, type HeuristicResult, type InitDependency, type InitOptions, type InitResult, JsonSummary, KindRule, LANGUAGE_PROFILES, type LanguageProfile, LayerRule, MIN_MAX_PART_BYTES, Manifest, type ManifestDiff, MarkdownSummary, PACKAGE_LATEST_URL, PRESETS, PartMetadata, PromptBack, PromptCancelled, REQUEST_TIMEOUT_MS, ResolvedSnapshotConfig, SCHEMA_VERSION, SecretFinding, SecretRule, SkipRecord, SnapshotConfig, SourceSummary, TextEncoding, type UpdateCheckOptions, type UpdateNotice, ValidationResult, type WizardAnswers, anchorForPath, assertReplaceable, assertUsableConfigInput, cacheDirectory, cacheFilePath, checkForUpdate, collectFiles, compareManifests, countInvalidUtf8Bytes, countLines, decodeText, defineConfig, detectLanguage, detectPreset, displayWidth, explainPath, fenceForContent, fenceForText, fetchLatestVersion, firstRunMessage, formatUpdateNotice, generateProjectTree, generateSnapshot, generateSnapshotAsync, getPreset, globToRegExp, hasPriorSnapshot, isBinaryBuffer, isBinaryExtension, isBinaryFile, isEffectivelyEmpty, isInteractive, isNewer, isResolvedConfig, isSensitivePath, listPresetNames, loadConfigFile, loadConfigFileDetailed, loadManifest, markResolvedConfig, matchRule, matchesExclude, normalizeResolvedConfig, parseByteSize, partitionFiles, planFirstRun, profileForPath, renderConfig, renderDiffText, renderExplainText, renumberParts, resolveConfig, resolveSafeOutputDirs, runInit, scanAndRedactSecrets, shouldCheck, stripJsonComments, summarizeJson, summarizeMarkdown, summarizeTypeScriptSource, summarizeWithProfile, supportsTypeScriptImports, truncatePreview, truncateToBytes, validateSnapshot, wrapLines };

package/dist/index.js

@@ -1,3 +1,3 @@
-export { ARTIFACT_NAMES, CHECK_INTERVAL_MS, DEFAULT_ANSWERS, DEFAULT_SECRET_PATTERNS, FAILURE_INTERVAL_MS, GENERATOR_NAME, GENERATOR_VERSION, LANGUAGE_PROFILES, MIN_MAX_PART_BYTES, PACKAGE_LATEST_URL, PRESETS, PromptCancelled, REQUEST_TIMEOUT_MS, SCHEMA_VERSION, anchorForPath, assertReplaceable, assertUsableConfigInput, cacheDirectory, cacheFilePath, checkForUpdate, collectFiles, compareManifests, countInvalidUtf8Bytes, countLines, decodeText, defineConfig, detectLanguage, detectPreset, explainPath, fenceForContent, fenceForText, fetchLatestVersion, firstRunMessage, formatUpdateNotice, generateProjectTree, generateSnapshot, generateSnapshotAsync, getPreset, globToRegExp, hasPriorSnapshot, isBinaryBuffer, isBinaryExtension, isBinaryFile, isEffectivelyEmpty, isInteractive, isNewer, isResolvedConfig, isSensitivePath, listPresetNames, loadConfigFile, loadConfigFileDetailed, loadManifest, markResolvedConfig, matchRule, matchesExclude, normalizeResolvedConfig, parseByteSize, partitionFiles, planFirstRun, profileForPath, renderConfig, renderDiffText, renderExplainText, renumberParts, resolveConfig, resolveSafeOutputDirs, runInit, scanAndRedactSecrets, shouldCheck, stripJsonComments, summarizeJson, summarizeMarkdown, summarizeTypeScriptSource, summarizeWithProfile, supportsTypeScriptImports, truncatePreview, truncateToBytes, validateSnapshot } from './chunk-3KUL3QRH.js';
+export { ARTIFACT_NAMES, CHECK_INTERVAL_MS, DEFAULT_ANSWERS, DEFAULT_SECRET_PATTERNS, FAILURE_INTERVAL_MS, GENERATOR_NAME, GENERATOR_VERSION, LANGUAGE_PROFILES, MIN_MAX_PART_BYTES, PACKAGE_LATEST_URL, PRESETS, PromptBack, PromptCancelled, REQUEST_TIMEOUT_MS, SCHEMA_VERSION, anchorForPath, assertReplaceable, assertUsableConfigInput, cacheDirectory, cacheFilePath, checkForUpdate, collectFiles, compareManifests, countInvalidUtf8Bytes, countLines, decodeText, defineConfig, detectLanguage, detectPreset, displayWidth, explainPath, fenceForContent, fenceForText, fetchLatestVersion, firstRunMessage, formatUpdateNotice, generateProjectTree, generateSnapshot, generateSnapshotAsync, getPreset, globToRegExp, hasPriorSnapshot, isBinaryBuffer, isBinaryExtension, isBinaryFile, isEffectivelyEmpty, isInteractive, isNewer, isResolvedConfig, isSensitivePath, listPresetNames, loadConfigFile, loadConfigFileDetailed, loadManifest, markResolvedConfig, matchRule, matchesExclude, normalizeResolvedConfig, parseByteSize, partitionFiles, planFirstRun, profileForPath, renderConfig, renderDiffText, renderExplainText, renumberParts, resolveConfig, resolveSafeOutputDirs, runInit, scanAndRedactSecrets, shouldCheck, stripJsonComments, summarizeJson, summarizeMarkdown, summarizeTypeScriptSource, summarizeWithProfile, supportsTypeScriptImports, truncatePreview, truncateToBytes, validateSnapshot, wrapLines } from './chunk-C24OAT6T.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/mcp.cjs

@@ -6128,7 +6128,7 @@ function validateSnapshot(configInput) {
 
 // src/version.ts
 var GENERATOR_NAME = "codebase-snapshot";
-var GENERATOR_VERSION = "0.9.6";
+var GENERATOR_VERSION = "0.9.8";
 var LEGACY_GENERATOR_NAMES = ["@ankurhalder/codebase-snapshot"];
 function isOurGeneratorName(name) {
   if (typeof name !== "string") return false;

package/dist/mcp.js

@@ -1,4 +1,4 @@
-export { ERROR_CODES, LEGACY_PROTOCOL_VERSIONS, MAX_LINE_BYTES, METHOD, MODERN_PROTOCOL_VERSIONS, SERVER_INSTRUCTIONS, SUPPORTED_PROTOCOL_VERSIONS, buildPrompts, buildResourceProvider, buildTools, classifyRequest, coerceNumericStrings, createLineReader, createMcpServer, createServer, createSession, createWriter, inspectModernMeta, negotiateLegacyVersion, runStdioServer, validateArguments } from './chunk-ZKZOGGM3.js';
-import './chunk-3KUL3QRH.js';
+export { ERROR_CODES, LEGACY_PROTOCOL_VERSIONS, MAX_LINE_BYTES, METHOD, MODERN_PROTOCOL_VERSIONS, SERVER_INSTRUCTIONS, SUPPORTED_PROTOCOL_VERSIONS, buildPrompts, buildResourceProvider, buildTools, classifyRequest, coerceNumericStrings, createLineReader, createMcpServer, createServer, createSession, createWriter, inspectModernMeta, negotiateLegacyVersion, runStdioServer, validateArguments } from './chunk-RQKXZOD7.js';
+import './chunk-C24OAT6T.js';
 //# sourceMappingURL=mcp.js.map
 //# sourceMappingURL=mcp.js.map

package/docs/cli.md

@@ -174,7 +174,7 @@ The whole first run in one command, with defaults and no prompts. This is the sa
 🚀 Setup for: /path/to/repo
 ✅ Created snapshot.config.ts (preset: nextjs)
    Added npm scripts: snapshot, snapshot:validate
-   Added devDependency: codebase-snapshot ^0.9.6
+   Added devDependency: codebase-snapshot ^0.9.8
    Added to .gitignore: snapshot/, snapshot.tmp/
 ⏳ Installing dependencies…
 ✅ Installed dependencies (npm install, 2.1s)
@@ -211,7 +211,7 @@ It also has three side effects on files you own, and it says so when it does the
 ```
 ✅ Created snapshot.config.ts (preset: node-lib)
    Added npm scripts: snapshot, snapshot:validate
-   Added devDependency: codebase-snapshot ^0.9.6
+   Added devDependency: codebase-snapshot ^0.9.8
    Added to .gitignore: snapshot/, snapshot.tmp/
 ```
 

package/docs/mcp.md

@@ -10,7 +10,7 @@ walk — that the client sees.
 ## Start it
 
 ```bash
-npx -y codebase-snapshot@0.9.6 mcp
+npx -y codebase-snapshot@0.9.8 mcp
 ```
 
 The server serves the directory it was started in. `--cwd <path>` points it elsewhere, and that
@@ -25,7 +25,7 @@ Claude Desktop and Cursor:
   "mcpServers": {
     "codebase-snapshot": {
       "command": "npx",
-      "args": ["-y", "codebase-snapshot@0.9.6", "mcp", "--cwd", "/absolute/path/to/repo"]
+      "args": ["-y", "codebase-snapshot@0.9.8", "mcp", "--cwd", "/absolute/path/to/repo"]
     }
   }
 }
@@ -34,7 +34,7 @@ Claude Desktop and Cursor:
 Claude Code registers the same thing from a shell:
 
 ```bash
-claude mcp add codebase-snapshot -- npx -y codebase-snapshot@0.9.6 mcp --cwd /absolute/path/to/repo
+claude mcp add codebase-snapshot -- npx -y codebase-snapshot@0.9.8 mcp --cwd /absolute/path/to/repo
 ```
 
 On Windows, wrap the command as `cmd /c npx` with the same arguments — `npx` is a `.cmd` shim

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codebase-snapshot",
-  "version": "0.9.6",
+  "version": "0.9.8",
   "description": "Pack a codebase for an LLM into budgeted Markdown parts, with a manifest of every file and skip, and validate to prove the snapshot is current.",
   "keywords": [
     "codebase",