codebase-snapshot 0.9.4 → 0.9.5

package/dist/index.cjs

@@ -5488,7 +5488,7 @@ function validateSnapshot(configInput) {
 
 // src/version.ts
 var GENERATOR_NAME = "codebase-snapshot";
-var GENERATOR_VERSION = "0.9.4";
+var GENERATOR_VERSION = "0.9.5";
 var LEGACY_GENERATOR_NAMES = ["@ankurhalder/codebase-snapshot"];
 function isOurGeneratorName(name) {
   if (typeof name !== "string") return false;
@@ -6061,6 +6061,12 @@ var PromptCancelled = class extends Error {
     this.name = "PromptCancelled";
   }
 };
+var PromptBack = class extends Error {
+  constructor() {
+    super("Prompt back");
+    this.name = "PromptBack";
+  }
+};
 function defaultIO() {
   return { input: process.stdin, output: process.stdout };
 }
@@ -6084,35 +6090,40 @@ function choiceLine(choice, active) {
   const hint = choice.hint ? `  ${choice.hint}` : "";
   return `  ${marker(active)} ${choice.label}${hint}`;
 }
-function renderSelect(message, choices, index) {
+function listFooter(base, allowBack) {
+  return allowBack ? `${base} \xB7 \u2190 back` : base;
+}
+function renderSelect(message, choices, index, allowBack = false) {
   const lines = [`\u25C6 ${message}`, ""];
   choices.forEach((choice, position) => lines.push(choiceLine(choice, position === index)));
-  lines.push("", "  \u2191\u2193 move \xB7 enter select");
+  lines.push("", `  ${listFooter("\u2191\u2193 move \xB7 enter select", allowBack)}`);
   return lines.join("\n");
 }
-function renderMultiSelect(message, choices, index, selected) {
+function renderMultiSelect(message, choices, index, selected, allowBack = false) {
   const lines = [`\u25C6 ${message}`, ""];
   choices.forEach((choice, position) => {
     const box = selected.has(position) ? "\u25FC" : "\u25FB";
     const hint = choice.hint ? `  ${choice.hint}` : "";
     lines.push(`  ${marker(position === index)} ${box} ${choice.label}${hint}`);
   });
-  lines.push("", "  \u2191\u2193 move \xB7 space toggle \xB7 enter confirm");
+  lines.push("", `  ${listFooter("\u2191\u2193 move \xB7 space toggle \xB7 enter confirm", allowBack)}`);
   return lines.join("\n");
 }
-function renderConfirm(message, value) {
+function renderConfirm(message, value, allowBack = false) {
+  const footer = allowBack ? "\u2190\u2192 or y/n \xB7 enter confirm \xB7 b back" : "\u2190\u2192 or y/n \xB7 enter confirm";
   return [
     `\u25C6 ${message}`,
     "",
     `  ${marker(value)} Yes`,
     `  ${marker(!value)} No`,
     "",
-    "  \u2190\u2192 or y/n \xB7 enter confirm"
+    `  ${footer}`
   ].join("\n");
 }
-function renderText(message, value, error) {
+function renderText(message, value, error, allowBack = false) {
   const lines = [`\u25C6 ${message}`, "", `  ${value || "\u258F"}`];
   if (error) lines.push("", `  \u2716 ${error}`);
+  if (allowBack) lines.push("", "  enter confirm \xB7 \u2190 back");
   return lines.join("\n");
 }
 function keyReader(input) {
@@ -6161,14 +6172,18 @@ var Frame = class {
 function isCancel(key) {
   return key.ctrl === true && key.name === "c" || key.ctrl === true && key.name === "d";
 }
+function isListBack(key, allowBack) {
+  return allowBack && (key.name === "left" || key.name === "b");
+}
 async function select(io, message, choices, options = {}) {
   if (choices.length === 0) throw new Error("select() requires at least one choice.");
+  const allowBack = options.allowBack === true;
   const fallbackIndex = Math.max(
     0,
     choices.findIndex((choice) => choice.value === options.defaultValue)
   );
   if (!isInteractive(io)) {
-    io.output.write(`${renderSelect(message, choices, fallbackIndex)}
+    io.output.write(`${renderSelect(message, choices, fallbackIndex, allowBack)}
 `);
     return choices[fallbackIndex].value;
   }
@@ -6177,9 +6192,10 @@ async function select(io, message, choices, options = {}) {
   let index = fallbackIndex;
   try {
     for (; ; ) {
-      frame.draw(renderSelect(message, choices, index));
+      frame.draw(renderSelect(message, choices, index, allowBack));
       const key = await reader.next();
       if (isCancel(key)) throw new PromptCancelled();
+      if (isListBack(key, allowBack)) throw new PromptBack();
       if (key.name === "up") index = moveSelection(index, -1, choices.length);
       else if (key.name === "down") index = moveSelection(index, 1, choices.length);
       else if (key.name === "return" || key.name === "enter") {
@@ -6188,18 +6204,22 @@ async function select(io, message, choices, options = {}) {
       } else if (key.name === "j") index = moveSelection(index, 1, choices.length);
       else if (key.name === "k") index = moveSelection(index, -1, choices.length);
     }
+  } catch (error) {
+    frame.erase();
+    throw error;
   } finally {
     reader.close();
   }
 }
 async function multiSelect(io, message, choices, options = {}) {
+  const allowBack = options.allowBack === true;
   const selected = /* @__PURE__ */ new Set();
   choices.forEach((choice, position) => {
     if (options.defaults?.includes(choice.value)) selected.add(position);
   });
   const result = () => choices.filter((_, position) => selected.has(position)).map((choice) => choice.value);
   if (!isInteractive(io)) {
-    io.output.write(`${renderMultiSelect(message, choices, 0, selected)}
+    io.output.write(`${renderMultiSelect(message, choices, 0, selected, allowBack)}
 `);
     return result();
   }
@@ -6208,9 +6228,10 @@ async function multiSelect(io, message, choices, options = {}) {
   let index = 0;
   try {
     for (; ; ) {
-      frame.draw(renderMultiSelect(message, choices, index, selected));
+      frame.draw(renderMultiSelect(message, choices, index, selected, allowBack));
       const key = await reader.next();
       if (isCancel(key)) throw new PromptCancelled();
+      if (isListBack(key, allowBack)) throw new PromptBack();
       if (key.name === "up") index = moveSelection(index, -1, choices.length);
       else if (key.name === "down") index = moveSelection(index, 1, choices.length);
       else if (key.name === "space") {
@@ -6225,14 +6246,18 @@ async function multiSelect(io, message, choices, options = {}) {
         return result();
       }
     }
+  } catch (error) {
+    frame.erase();
+    throw error;
   } finally {
     reader.close();
   }
 }
 async function confirm(io, message, options = {}) {
+  const allowBack = options.allowBack === true;
   let value = options.defaultValue ?? true;
   if (!isInteractive(io)) {
-    io.output.write(`${renderConfirm(message, value)}
+    io.output.write(`${renderConfirm(message, value, allowBack)}
 `);
     return value;
   }
@@ -6240,9 +6265,10 @@ async function confirm(io, message, options = {}) {
   const reader = keyReader(io.input);
   try {
     for (; ; ) {
-      frame.draw(renderConfirm(message, value));
+      frame.draw(renderConfirm(message, value, allowBack));
       const key = await reader.next();
       if (isCancel(key)) throw new PromptCancelled();
+      if (allowBack && key.name === "b") throw new PromptBack();
       if (key.name === "up" || key.name === "left") value = true;
       else if (key.name === "down" || key.name === "right") value = false;
       else if (key.name === "y") value = true;
@@ -6252,14 +6278,18 @@ async function confirm(io, message, options = {}) {
         return value;
       }
     }
+  } catch (error) {
+    frame.erase();
+    throw error;
   } finally {
     reader.close();
   }
 }
 async function text(io, message, options = {}) {
+  const allowBack = options.allowBack === true;
   const fallback = options.defaultValue ?? "";
   if (!isInteractive(io)) {
-    io.output.write(`${renderText(message, fallback)}
+    io.output.write(`${renderText(message, fallback, void 0, allowBack)}
 `);
     return fallback;
   }
@@ -6269,9 +6299,10 @@ async function text(io, message, options = {}) {
   let error;
   try {
     for (; ; ) {
-      frame.draw(renderText(message, value, error));
+      frame.draw(renderText(message, value, error, allowBack));
       const key = await reader.next();
       if (isCancel(key)) throw new PromptCancelled();
+      if (allowBack && key.name === "left") throw new PromptBack();
       error = void 0;
       if (key.name === "return" || key.name === "enter") {
         const problem = options.validate ? options.validate(value) : null;
@@ -6292,6 +6323,9 @@ async function text(io, message, options = {}) {
       }
       if (_isPrintable(key)) value += _keyText(key);
     }
+  } catch (error_) {
+    frame.erase();
+    throw error_;
   } finally {
     reader.close();
   }
@@ -6548,98 +6582,108 @@ async function runInit(options) {
       { value: "walk", label: "Go through each setting", hint: "every question starts on its default" },
       { value: "choose", label: "Pick a different preset", hint: "everything else stays at the defaults" }
     ];
-    const pace = await select(io, "How should I set this up?", paceChoices, {
-      defaultValue: fallback ? "choose" : "recommended"
-    });
-    if (pace === "choose") {
-      answers.preset = await select(
-        io,
-        "What kind of project is this?",
-        listPresetNames().map(
-          (name) => resolvePresetChoice(fallback ? null : detected.presetName, name)
-        ),
-        { defaultValue: answers.preset }
-      );
-      const chosen = detectPreset(options.cwd, answers.preset);
-      answers.preset = chosen.presetName;
-      reason = null;
-      fallback = false;
-    }
-    if (pace === "walk") {
-      const scope = await select(
-        io,
-        "What should go into the snapshot?",
-        [
-          { value: "all", label: "Everything the scanner finds", hint: "recommended \xB7 respects .gitignore" },
-          { value: "folders", label: "Only specific folders\u2026" },
-          { value: "no-tests", label: "Everything, but skip tests" },
-          { value: "custom", label: "Let me write glob patterns" }
-        ],
-        { defaultValue: "all" }
-      );
-      if (scope === "folders") {
-        const dirs = topLevelDirs(options.cwd).slice(0, 40);
-        if (dirs.length === 0) {
-          notes.push("No top-level directories found; the snapshot will include everything.");
-        } else {
-          const chosen = await multiSelect(
-            io,
-            "Select folders",
-            dirs.map((name) => ({ value: name, label: `${name}/` })),
-            { defaults: dirs }
-          );
-          answers.include = chosen.map((name) => `${name}/**`);
+    const baseInclude = [...answers.include];
+    const baseExclude = [...answers.excludePatterns];
+    let lastScope = "all";
+    const artifactChoices = [
+      { value: "readme", label: "README.md", hint: "orientation page" },
+      { value: "manifest", label: "manifest.json", hint: "required by validate and report" },
+      { value: "parts", label: "parts/", hint: "the code payload" },
+      { value: "navigation", label: "reports/navigation.md", hint: "file \u2192 part index" },
+      { value: "projectTree", label: "reports/project-tree.md", hint: "ASCII tree" },
+      { value: "audit", label: "reports/audit.md", hint: "security and health findings" },
+      { value: "monolith", label: "full-codebase.json + .md", hint: "roughly doubles output" }
+    ];
+    const scopeStep = async () => {
+      for (; ; ) {
+        const scope = await select(
+          io,
+          "What should go into the snapshot?",
+          [
+            { value: "all", label: "Everything the scanner finds", hint: "recommended \xB7 respects .gitignore" },
+            { value: "folders", label: "Only specific folders\u2026" },
+            { value: "no-tests", label: "Everything, but skip tests" },
+            { value: "custom", label: "Let me write glob patterns" }
+          ],
+          { defaultValue: lastScope, allowBack: true }
+        );
+        lastScope = scope;
+        answers.include = [...baseInclude];
+        answers.excludePatterns = [...baseExclude];
+        try {
+          if (scope === "folders") {
+            const dirs = topLevelDirs(options.cwd).slice(0, 40);
+            if (dirs.length === 0) {
+              notes.push("No top-level directories found; the snapshot will include everything.");
+            } else {
+              const chosen = await multiSelect(
+                io,
+                "Select folders",
+                dirs.map((name) => ({ value: name, label: `${name}/` })),
+                { defaults: dirs, allowBack: true }
+              );
+              answers.include = chosen.map((name) => `${name}/**`);
+            }
+          } else if (scope === "no-tests") {
+            answers.excludePatterns = [...baseExclude, "**/*.test.*", "**/*.spec.*", "tests", "test"];
+          } else if (scope === "custom") {
+            const raw = await text(io, "Glob patterns to include (comma separated)", {
+              defaultValue: baseInclude.join(", "),
+              allowBack: true
+            });
+            answers.include = raw.split(",").map((value) => value.trim()).filter(Boolean);
+          }
+          return;
+        } catch (error) {
+          if (error instanceof PromptBack) continue;
+          throw error;
         }
-      } else if (scope === "no-tests") {
-        answers.excludePatterns = [
-          ...answers.excludePatterns,
-          "**/*.test.*",
-          "**/*.spec.*",
-          "tests",
-          "test"
-        ];
-      } else if (scope === "custom") {
-        const raw = await text(io, "Glob patterns to include (comma separated)", {
-          defaultValue: ""
-        });
-        answers.include = raw.split(",").map((value) => value.trim()).filter(Boolean);
       }
-      const currentBudget = String(answers.maxPartBytes);
-      const sizeChoice = await select(io, "How large should each part be?", SIZE_CHOICES, {
-        defaultValue: SIZE_CHOICES.some((choice) => choice.value === currentBudget) ? currentBudget : "120k"
-      });
-      if (sizeChoice === "custom") {
-        const raw = await text(io, "Part size (e.g. 150k, 1.5mb, 900000)", {
-          defaultValue: String(answers.maxPartBytes),
-          validate: (value) => parseByteSize(value) === void 0 ? "Not a valid size." : null
+    };
+    const sizeStep = async () => {
+      for (; ; ) {
+        const currentBudget = String(answers.maxPartBytes);
+        const sizeChoice = await select(io, "How large should each part be?", SIZE_CHOICES, {
+          defaultValue: SIZE_CHOICES.some((choice) => choice.value === currentBudget) ? currentBudget : "custom",
+          allowBack: true
         });
-        answers.maxPartBytes = parseByteSize(raw) ?? answers.maxPartBytes;
-      } else {
-        answers.maxPartBytes = sizeChoice;
+        if (sizeChoice !== "custom") {
+          answers.maxPartBytes = sizeChoice;
+          return;
+        }
+        try {
+          const raw = await text(io, "Part size (e.g. 150k, 1.5mb, 900000)", {
+            defaultValue: currentBudget,
+            validate: (value) => parseByteSize(value) === void 0 ? "Not a valid size." : null,
+            allowBack: true
+          });
+          answers.maxPartBytes = parseByteSize(raw) ?? answers.maxPartBytes;
+          return;
+        } catch (error) {
+          if (error instanceof PromptBack) continue;
+          throw error;
+        }
       }
-      const artifactChoices = [
-        { value: "readme", label: "README.md", hint: "orientation page" },
-        { value: "manifest", label: "manifest.json", hint: "required by validate and report" },
-        { value: "parts", label: "parts/", hint: "the code payload" },
-        { value: "navigation", label: "reports/navigation.md", hint: "file \u2192 part index" },
-        { value: "projectTree", label: "reports/project-tree.md", hint: "ASCII tree" },
-        { value: "audit", label: "reports/audit.md", hint: "security and health findings" },
-        { value: "monolith", label: "full-codebase.json + .md", hint: "roughly doubles output" }
-      ];
-      const presetEnabled = ARTIFACT_NAMES.filter((name) => answers.artifacts[name]);
+    };
+    const artifactsStep = async () => {
+      const enabled = ARTIFACT_NAMES.filter((name) => answers.artifacts[name]);
       const selectedArtifacts = await multiSelect(
         io,
         "Which artifacts should be generated?",
         artifactChoices,
-        { defaults: presetEnabled }
+        { defaults: enabled, allowBack: true }
       );
       for (const name of ARTIFACT_NAMES) answers.artifacts[name] = selectedArtifacts.includes(name);
-      const enabledCount = ARTIFACT_NAMES.filter((name) => answers.artifacts[name]).length;
+    };
+    const credentialsStep = async () => {
       answers.includeSensitiveFiles = await confirm(
         io,
-        "Include credential files (.env, *.pem, .npmrc, .ssh/)?",
-        { defaultValue: false }
+        "Include credential files (.env, *.pem, *.npmrc, *.ssh/)?",
+        { defaultValue: answers.includeSensitiveFiles, allowBack: true }
       );
+    };
+    const reviewStep = async () => {
+      const enabledCount = ARTIFACT_NAMES.filter((name) => answers.artifacts[name]).length;
       io.output.write("\n  Review\n\n");
       io.output.write(`  project          ${answers.preset}
 `);
@@ -6654,8 +6698,53 @@ async function runInit(options) {
 `);
       io.output.write("  Will write snapshot.config with your answers, plus every other setting\n");
       io.output.write("  at its default \u2014 so nothing is hidden behind the docs.\n\n");
-      const proceed = await confirm(io, "Write this and continue?", { defaultValue: true });
-      if (!proceed) throw new PromptCancelled();
+      const proceed = await confirm(io, "Write this and continue?", {
+        defaultValue: true,
+        allowBack: true
+      });
+      if (!proceed) throw new PromptBack();
+    };
+    const walk = async () => {
+      const steps = [scopeStep, sizeStep, artifactsStep, credentialsStep, reviewStep];
+      let index = 0;
+      while (index < steps.length) {
+        try {
+          await steps[index]();
+          index += 1;
+        } catch (error) {
+          if (!(error instanceof PromptBack)) throw error;
+          if (index === 0) return false;
+          index -= 1;
+          io.output.write("\n");
+        }
+      }
+      return true;
+    };
+    for (; ; ) {
+      const pace = await select(io, "How should I set this up?", paceChoices, {
+        defaultValue: fallback ? "choose" : "recommended"
+      });
+      if (pace === "choose") {
+        try {
+          answers.preset = await select(
+            io,
+            "What kind of project is this?",
+            listPresetNames().map(
+              (name) => resolvePresetChoice(fallback ? null : detected.presetName, name)
+            ),
+            { defaultValue: answers.preset, allowBack: true }
+          );
+        } catch (error) {
+          if (error instanceof PromptBack) continue;
+          throw error;
+        }
+        const chosen = detectPreset(options.cwd, answers.preset);
+        answers.preset = chosen.presetName;
+        reason = null;
+        fallback = false;
+      }
+      if (pace === "walk" && !await walk()) continue;
+      break;
     }
   }
   const configText = renderConfig(answers);

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.4";
+declare const GENERATOR_VERSION = "0.9.5";
 
 declare const DEFAULT_SECRET_PATTERNS: SecretRule[];
 

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.4";
+declare const GENERATOR_VERSION = "0.9.5";
 
 declare const DEFAULT_SECRET_PATTERNS: SecretRule[];
 

package/dist/index.js

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

package/dist/mcp.cjs

@@ -6115,7 +6115,7 @@ function validateSnapshot(configInput) {
 
 // src/version.ts
 var GENERATOR_NAME = "codebase-snapshot";
-var GENERATOR_VERSION = "0.9.4";
+var GENERATOR_VERSION = "0.9.5";
 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, createLineReader, createMcpServer, createServer, createSession, createWriter, inspectModernMeta, negotiateLegacyVersion, runStdioServer, validateArguments } from './chunk-EWZYK3VX.js';
-import './chunk-FCWD4LY7.js';
+export { ERROR_CODES, LEGACY_PROTOCOL_VERSIONS, MAX_LINE_BYTES, METHOD, MODERN_PROTOCOL_VERSIONS, SERVER_INSTRUCTIONS, SUPPORTED_PROTOCOL_VERSIONS, buildPrompts, buildResourceProvider, buildTools, classifyRequest, createLineReader, createMcpServer, createServer, createSession, createWriter, inspectModernMeta, negotiateLegacyVersion, runStdioServer, validateArguments } from './chunk-4AHHSNGG.js';
+import './chunk-B336MMNC.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.4
+   Added devDependency: codebase-snapshot ^0.9.5
    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.4
+   Added devDependency: codebase-snapshot ^0.9.5
    Added to .gitignore: snapshot/, snapshot.tmp/
 ```
 
@@ -225,6 +225,16 @@ It also has three side effects on files you own, and it says so when it does the
 - `snapshot/` and `snapshot.tmp/` are appended to `.gitignore` if they are not already listed;
   the file is created if missing, and entries already present are not duplicated.
 
+### Going back
+
+At a terminal, `init` asks five questions and every one of them can be revisited: **`←`** goes back
+on a list or a text field, **`b`** on a list or a confirmation. `text` takes `←` alone because `b` is
+a character you may be typing, and `confirm` takes `b` alone because `←`/`→` already mean yes/no.
+
+Back steps to the previous question with your earlier answer still selected; back from the first one
+returns to *"How should I set this up?"*. Answering **No** at the review steps back rather than
+abandoning the run — Ctrl+C is how you abandon.
+
 Nothing else in the repository is touched: no `AGENTS.md`, no `.claude/`, no `.cursor/`. In a
 repository with a `package.json` and no config, `git status` shows the config as the only new
 file.

package/docs/mcp.md

@@ -10,7 +10,7 @@ walk — that the client sees.
 ## Start it
 
 ```bash
-npx -y codebase-snapshot@0.9.4 mcp
+npx -y codebase-snapshot@0.9.5 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.4", "mcp", "--cwd", "/absolute/path/to/repo"]
+      "args": ["-y", "codebase-snapshot@0.9.5", "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.4 mcp --cwd /absolute/path/to/repo
+claude mcp add codebase-snapshot -- npx -y codebase-snapshot@0.9.5 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.4",
+  "version": "0.9.5",
   "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",