@ankurhalder/codebase-snapshot 4.0.2 → 4.0.4

package/dist/bin.js

@@ -4514,7 +4514,31 @@ function generateAuditReport(manifest, secretFindings, secretRules) {
     }
     lines.push("");
   }
-  lines.push("## 2. Large Files Analysis", "");
+  const parseIssues = manifest.files.filter(
+    (file) => file.summary !== void 0 && typeof file.summary === "object" && "parseErrors" in file.summary && typeof file.summary.parseErrors === "number" && file.summary.parseErrors > 0
+  );
+  lines.push("## 2. Parse & AST Diagnostics", "");
+  if (parseIssues.length === 0) {
+    lines.push("\u2705 Every parsed file produced a complete structural summary.", "");
+  } else {
+    lines.push(
+      `${parseIssues.length} file(s) produced an incomplete summary:`,
+      "",
+      "| File | Parse Errors |",
+      "| :--- | ---: |"
+    );
+    for (const file of parseIssues) {
+      const errors = file.summary.parseErrors;
+      lines.push(`| \`${mask(file.relativePath)}\` | ${errors} |`);
+    }
+    lines.push(
+      "",
+      "A parse error here means the summary is incomplete, not that the file is excluded \u2014",
+      "the content is still in the parts.",
+      ""
+    );
+  }
+  lines.push("## 3. Large Files Analysis", "");
   const largeFiles = manifest.files.filter((file) => file.isLarge);
   if (largeFiles.length === 0) {
     lines.push("\u2705 No files exceeded the large file budget.", "");
@@ -4533,7 +4557,7 @@ function generateAuditReport(manifest, secretFindings, secretRules) {
     lines.push("");
   }
   lines.push(
-    "## 3. Architecture Layer Distribution",
+    "## 4. Architecture Layer Distribution",
     "",
     "| Layer | File Count | Percentage |",
     "| :--- | :--- | :--- |"
@@ -4547,7 +4571,7 @@ function generateAuditReport(manifest, secretFindings, secretRules) {
   }
   lines.push("");
   lines.push(
-    "## 4. File Kind Distribution",
+    "## 5. File Kind Distribution",
     "",
     "| Kind | File Count | Percentage |",
     "| :--- | :--- | :--- |"
@@ -4559,7 +4583,7 @@ function generateAuditReport(manifest, secretFindings, secretRules) {
     lines.push(`| \`${kind}\` | ${count} | ${pct}% |`);
   }
   lines.push("");
-  lines.push("## 5. Skipped / Non-Text Files", "");
+  lines.push("## 6. Skipped / Non-Text Files", "");
   if (manifest.skipped.length === 0) {
     lines.push("No files were skipped.", "");
   } else {
@@ -5228,6 +5252,9 @@ function validateSnapshot(configInput) {
       });
     }
   }
+  const maskValue = (value) => findSecretInPath(value, config.secretRules)?.masked ?? value;
+  const currentExcludes = config.excludePatterns.map(maskValue);
+  const currentInclude = config.include.map(maskValue);
   const recorded = manifest.config;
   if (recorded && typeof recorded === "object") {
     if (recorded.maxPartBytes !== config.maxPartBytes) {
@@ -5256,15 +5283,15 @@ function validateSnapshot(configInput) {
       );
     }
     const recordedExcludes = Array.isArray(recorded.excludePatterns) ? recorded.excludePatterns : [];
-    if (recordedExcludes.join("\0") !== config.excludePatterns.join("\0")) {
+    if (recordedExcludes.join("\0") !== currentExcludes.join("\0")) {
       drift.configMismatches.push(
-        `excludePatterns: manifest [${recordedExcludes.join(", ")}] vs current [${config.excludePatterns.join(", ")}]`
+        `excludePatterns: manifest [${recordedExcludes.join(", ")}] vs current [${currentExcludes.join(", ")}]`
       );
     }
     const recordedInclude = Array.isArray(recorded.include) ? recorded.include : [];
-    if (recordedInclude.join("\0") !== config.include.join("\0")) {
+    if (recordedInclude.join("\0") !== currentInclude.join("\0")) {
       drift.configMismatches.push(
-        `include: manifest [${recordedInclude.join(", ")}] vs current [${config.include.join(", ")}]`
+        `include: manifest [${recordedInclude.join(", ")}] vs current [${currentInclude.join(", ")}]`
       );
     }
     if (recorded?.artifacts && typeof recorded.artifacts === "object") {
@@ -5444,7 +5471,7 @@ function validateSnapshot(configInput) {
 
 // src/index.ts
 var GENERATOR_NAME = "@ankurhalder/codebase-snapshot";
-var GENERATOR_VERSION = "4.0.2";
+var GENERATOR_VERSION = "4.0.4";
 var SCHEMA_VERSION = "3.0.0";
 function sha256Hex2(input) {
   return crypto3.createHash("sha256").update(input).digest("hex");
@@ -5651,6 +5678,18 @@ function resolveSafeOutputDirs(config) {
 var PLACEHOLDER_ENTRIES = /* @__PURE__ */ new Set([".gitkeep", ".gitignore", ".DS_Store"]);
 var RUN_DIR_PREFIX = "run-";
 var STALE_RUN_MS = 60 * 60 * 1e3;
+function maskSummaryStrings(value, secretRules) {
+  if (typeof value === "string") return maskPathText(value, secretRules);
+  if (Array.isArray(value)) return value.map((item) => maskSummaryStrings(item, secretRules));
+  if (value && typeof value === "object") {
+    const out = {};
+    for (const [key, item] of Object.entries(value)) {
+      out[key] = maskSummaryStrings(item, secretRules);
+    }
+    return out;
+  }
+  return value;
+}
 function maskPathText(value, secretRules) {
   return findSecretInPath(value, secretRules)?.masked ?? value;
 }
@@ -6231,8 +6270,8 @@ function generateSnapshot(configInput, options) {
     let summary;
     let summaryQuality;
     try {
-      const outcome = summarizeFile(relativePath, redacted);
-      summary = outcome?.summary;
+      const outcome = summarizeFile(relativePath, rawContent);
+      summary = outcome?.summary ? maskSummaryStrings(outcome.summary, config.secretRules) : void 0;
       summaryQuality = outcome?.quality;
       if (isSourceSummary(summary) && summary.parseErrors) {
         warnings.push(
@@ -7779,7 +7818,7 @@ ${USAGE}
       info(`   - Schema:         ${manifest.schemaVersion}`);
       info(`   - Fingerprint:    ${manifest.fingerprint}`);
       info(`   - Files included: ${manifest.counts.totalFiles}`);
-      info(`   - Total lines:    ${manifest.counts.totalLines.toLocaleString()}`);
+      info(`   - Total lines:    ${manifest.counts.totalLines.toLocaleString("en-US")}`);
       info(
         `   - Total size:     ${(manifest.counts.totalSizeBytes / (1024 * 1024)).toFixed(2)} MB`
       );
@@ -7831,14 +7870,14 @@ ${USAGE}
       info(`
 \u2705 Snapshot generated in ${elapsed}s:`);
       info(`   - Tracked files: ${manifest.counts.totalFiles}`);
-      info(`   - Total lines:   ${manifest.counts.totalLines.toLocaleString()}`);
+      info(`   - Total lines:   ${manifest.counts.totalLines.toLocaleString("en-US")}`);
       info(
         `   - Total size:    ${(manifest.counts.totalSizeBytes / (1024 * 1024)).toFixed(2)} MB`
       );
       const { artifacts } = resolved;
       if (artifacts.parts) {
         info(
-          `   - Parts written: ${manifest.counts.partsCount} under ${displayOutPath(resolved.cwd, resolved.outDir, "parts")}/`
+          `   - Parts written: ${manifest.counts.partsCount} under ${displayOutPath(resolved.cwd, resolved.outDir, "parts")}`
         );
       }
       const reports = [
@@ -7848,7 +7887,7 @@ ${USAGE}
       ].filter(Boolean);
       if (reports.length > 0) {
         info(
-          `   - Reports:       ${displayOutPath(resolved.cwd, resolved.outDir, "reports")}/ (${reports.join(", ")})`
+          `   - Reports:       ${displayOutPath(resolved.cwd, resolved.outDir, "reports")} (${reports.join(", ")})`
         );
       }
       if (artifacts.manifest) {
@@ -7976,6 +8015,21 @@ async function runWatchLoop(invocation, resolved) {
   });
   return 0;
 }
+var entryFile = process.argv[1] ?? "";
+var entryName = path12.basename(entryFile).toLowerCase();
+var invokedDirectly = entryName === "cli.js" || entryName === "cli.cjs";
+if (invokedDirectly) {
+  void main().then(
+    (code) => {
+      process.exitCode = code;
+    },
+    (err) => {
+      process.stderr.write(`\u274C ${err.message}
+`);
+      process.exitCode = 1;
+    }
+  );
+}
 
 // src/bin.ts
 main().then(

package/dist/{chunk-CY3XU5TS.js → chunk-CDZDVU74.js}

@@ -3399,7 +3399,31 @@ function generateAuditReport(manifest, secretFindings, secretRules) {
     }
     lines.push("");
   }
-  lines.push("## 2. Large Files Analysis", "");
+  const parseIssues = manifest.files.filter(
+    (file) => file.summary !== void 0 && typeof file.summary === "object" && "parseErrors" in file.summary && typeof file.summary.parseErrors === "number" && file.summary.parseErrors > 0
+  );
+  lines.push("## 2. Parse & AST Diagnostics", "");
+  if (parseIssues.length === 0) {
+    lines.push("\u2705 Every parsed file produced a complete structural summary.", "");
+  } else {
+    lines.push(
+      `${parseIssues.length} file(s) produced an incomplete summary:`,
+      "",
+      "| File | Parse Errors |",
+      "| :--- | ---: |"
+    );
+    for (const file of parseIssues) {
+      const errors = file.summary.parseErrors;
+      lines.push(`| \`${mask(file.relativePath)}\` | ${errors} |`);
+    }
+    lines.push(
+      "",
+      "A parse error here means the summary is incomplete, not that the file is excluded \u2014",
+      "the content is still in the parts.",
+      ""
+    );
+  }
+  lines.push("## 3. Large Files Analysis", "");
   const largeFiles = manifest.files.filter((file) => file.isLarge);
   if (largeFiles.length === 0) {
     lines.push("\u2705 No files exceeded the large file budget.", "");
@@ -3418,7 +3442,7 @@ function generateAuditReport(manifest, secretFindings, secretRules) {
     lines.push("");
   }
   lines.push(
-    "## 3. Architecture Layer Distribution",
+    "## 4. Architecture Layer Distribution",
     "",
     "| Layer | File Count | Percentage |",
     "| :--- | :--- | :--- |"
@@ -3432,7 +3456,7 @@ function generateAuditReport(manifest, secretFindings, secretRules) {
   }
   lines.push("");
   lines.push(
-    "## 4. File Kind Distribution",
+    "## 5. File Kind Distribution",
     "",
     "| Kind | File Count | Percentage |",
     "| :--- | :--- | :--- |"
@@ -3444,7 +3468,7 @@ function generateAuditReport(manifest, secretFindings, secretRules) {
     lines.push(`| \`${kind}\` | ${count} | ${pct}% |`);
   }
   lines.push("");
-  lines.push("## 5. Skipped / Non-Text Files", "");
+  lines.push("## 6. Skipped / Non-Text Files", "");
   if (manifest.skipped.length === 0) {
     lines.push("No files were skipped.", "");
   } else {
@@ -4276,6 +4300,9 @@ function validateSnapshot(configInput) {
       });
     }
   }
+  const maskValue = (value) => findSecretInPath(value, config.secretRules)?.masked ?? value;
+  const currentExcludes = config.excludePatterns.map(maskValue);
+  const currentInclude = config.include.map(maskValue);
   const recorded = manifest.config;
   if (recorded && typeof recorded === "object") {
     if (recorded.maxPartBytes !== config.maxPartBytes) {
@@ -4304,15 +4331,15 @@ function validateSnapshot(configInput) {
       );
     }
     const recordedExcludes = Array.isArray(recorded.excludePatterns) ? recorded.excludePatterns : [];
-    if (recordedExcludes.join("\0") !== config.excludePatterns.join("\0")) {
+    if (recordedExcludes.join("\0") !== currentExcludes.join("\0")) {
       drift.configMismatches.push(
-        `excludePatterns: manifest [${recordedExcludes.join(", ")}] vs current [${config.excludePatterns.join(", ")}]`
+        `excludePatterns: manifest [${recordedExcludes.join(", ")}] vs current [${currentExcludes.join(", ")}]`
       );
     }
     const recordedInclude = Array.isArray(recorded.include) ? recorded.include : [];
-    if (recordedInclude.join("\0") !== config.include.join("\0")) {
+    if (recordedInclude.join("\0") !== currentInclude.join("\0")) {
       drift.configMismatches.push(
-        `include: manifest [${recordedInclude.join(", ")}] vs current [${config.include.join(", ")}]`
+        `include: manifest [${recordedInclude.join(", ")}] vs current [${currentInclude.join(", ")}]`
       );
     }
     if (recorded?.artifacts && typeof recorded.artifacts === "object") {
@@ -5407,7 +5434,7 @@ async function runInit(options) {
 
 // src/index.ts
 var GENERATOR_NAME = "@ankurhalder/codebase-snapshot";
-var GENERATOR_VERSION = "4.0.2";
+var GENERATOR_VERSION = "4.0.4";
 var SCHEMA_VERSION = "3.0.0";
 function sha256Hex2(input) {
   return crypto.createHash("sha256").update(input).digest("hex");
@@ -5614,6 +5641,18 @@ function resolveSafeOutputDirs(config) {
 var PLACEHOLDER_ENTRIES = /* @__PURE__ */ new Set([".gitkeep", ".gitignore", ".DS_Store"]);
 var RUN_DIR_PREFIX = "run-";
 var STALE_RUN_MS = 60 * 60 * 1e3;
+function maskSummaryStrings(value, secretRules) {
+  if (typeof value === "string") return maskPathText(value, secretRules);
+  if (Array.isArray(value)) return value.map((item) => maskSummaryStrings(item, secretRules));
+  if (value && typeof value === "object") {
+    const out = {};
+    for (const [key, item] of Object.entries(value)) {
+      out[key] = maskSummaryStrings(item, secretRules);
+    }
+    return out;
+  }
+  return value;
+}
 function maskPathText(value, secretRules) {
   return findSecretInPath(value, secretRules)?.masked ?? value;
 }
@@ -6194,8 +6233,8 @@ function generateSnapshot(configInput, options) {
     let summary;
     let summaryQuality;
     try {
-      const outcome = summarizeFile(relativePath, redacted);
-      summary = outcome?.summary;
+      const outcome = summarizeFile(relativePath, rawContent);
+      summary = outcome?.summary ? maskSummaryStrings(outcome.summary, config.secretRules) : void 0;
       summaryQuality = outcome?.quality;
       if (isSourceSummary(summary) && summary.parseErrors) {
         warnings.push(
@@ -6455,5 +6494,5 @@ async function generateSnapshotAsync(configInput, options) {
 }
 
 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, countLines, defineConfig, detectLanguage, detectPreset, explainPath, fenceForContent, fenceForText, generateProjectTree, generateSnapshot, generateSnapshotAsync, getPreset, globToRegExp, isBinaryBuffer, isBinaryExtension, isBinaryFile, isInteractive, isResolvedConfig, isSensitivePath, listPresetNames, loadConfigFile, loadConfigFileDetailed, loadManifest, markResolvedConfig, matchRule, matchesExclude, normalizeResolvedConfig, parseByteSize, partitionFiles, profileForPath, renderConfig, renderDiffText, renderExplainText, renderMinimalConfig, renumberParts, resolveConfig, resolveSafeOutputDirs, runInit, scanAndRedactSecrets, stripJsonComments, summarizeJson, summarizeMarkdown, summarizeTypeScriptSource, summarizeWithProfile, supportsTypeScriptImports, truncatePreview, truncateToBytes, unknownPresetMessage, validateSnapshot };
-//# sourceMappingURL=chunk-CY3XU5TS.js.map
-//# sourceMappingURL=chunk-CY3XU5TS.js.map
+//# sourceMappingURL=chunk-CDZDVU74.js.map
+//# sourceMappingURL=chunk-CDZDVU74.js.map

package/dist/cli.cjs

@@ -4502,7 +4502,31 @@ function generateAuditReport(manifest, secretFindings, secretRules) {
     }
     lines.push("");
   }
-  lines.push("## 2. Large Files Analysis", "");
+  const parseIssues = manifest.files.filter(
+    (file) => file.summary !== void 0 && typeof file.summary === "object" && "parseErrors" in file.summary && typeof file.summary.parseErrors === "number" && file.summary.parseErrors > 0
+  );
+  lines.push("## 2. Parse & AST Diagnostics", "");
+  if (parseIssues.length === 0) {
+    lines.push("\u2705 Every parsed file produced a complete structural summary.", "");
+  } else {
+    lines.push(
+      `${parseIssues.length} file(s) produced an incomplete summary:`,
+      "",
+      "| File | Parse Errors |",
+      "| :--- | ---: |"
+    );
+    for (const file of parseIssues) {
+      const errors = file.summary.parseErrors;
+      lines.push(`| \`${mask(file.relativePath)}\` | ${errors} |`);
+    }
+    lines.push(
+      "",
+      "A parse error here means the summary is incomplete, not that the file is excluded \u2014",
+      "the content is still in the parts.",
+      ""
+    );
+  }
+  lines.push("## 3. Large Files Analysis", "");
   const largeFiles = manifest.files.filter((file) => file.isLarge);
   if (largeFiles.length === 0) {
     lines.push("\u2705 No files exceeded the large file budget.", "");
@@ -4521,7 +4545,7 @@ function generateAuditReport(manifest, secretFindings, secretRules) {
     lines.push("");
   }
   lines.push(
-    "## 3. Architecture Layer Distribution",
+    "## 4. Architecture Layer Distribution",
     "",
     "| Layer | File Count | Percentage |",
     "| :--- | :--- | :--- |"
@@ -4535,7 +4559,7 @@ function generateAuditReport(manifest, secretFindings, secretRules) {
   }
   lines.push("");
   lines.push(
-    "## 4. File Kind Distribution",
+    "## 5. File Kind Distribution",
     "",
     "| Kind | File Count | Percentage |",
     "| :--- | :--- | :--- |"
@@ -4547,7 +4571,7 @@ function generateAuditReport(manifest, secretFindings, secretRules) {
     lines.push(`| \`${kind}\` | ${count} | ${pct}% |`);
   }
   lines.push("");
-  lines.push("## 5. Skipped / Non-Text Files", "");
+  lines.push("## 6. Skipped / Non-Text Files", "");
   if (manifest.skipped.length === 0) {
     lines.push("No files were skipped.", "");
   } else {
@@ -5208,6 +5232,9 @@ function validateSnapshot(configInput) {
       });
     }
   }
+  const maskValue = (value) => findSecretInPath(value, config.secretRules)?.masked ?? value;
+  const currentExcludes = config.excludePatterns.map(maskValue);
+  const currentInclude = config.include.map(maskValue);
   const recorded = manifest.config;
   if (recorded && typeof recorded === "object") {
     if (recorded.maxPartBytes !== config.maxPartBytes) {
@@ -5236,15 +5263,15 @@ function validateSnapshot(configInput) {
       );
     }
     const recordedExcludes = Array.isArray(recorded.excludePatterns) ? recorded.excludePatterns : [];
-    if (recordedExcludes.join("\0") !== config.excludePatterns.join("\0")) {
+    if (recordedExcludes.join("\0") !== currentExcludes.join("\0")) {
       drift.configMismatches.push(
-        `excludePatterns: manifest [${recordedExcludes.join(", ")}] vs current [${config.excludePatterns.join(", ")}]`
+        `excludePatterns: manifest [${recordedExcludes.join(", ")}] vs current [${currentExcludes.join(", ")}]`
       );
     }
     const recordedInclude = Array.isArray(recorded.include) ? recorded.include : [];
-    if (recordedInclude.join("\0") !== config.include.join("\0")) {
+    if (recordedInclude.join("\0") !== currentInclude.join("\0")) {
       drift.configMismatches.push(
-        `include: manifest [${recordedInclude.join(", ")}] vs current [${config.include.join(", ")}]`
+        `include: manifest [${recordedInclude.join(", ")}] vs current [${currentInclude.join(", ")}]`
       );
     }
     if (recorded?.artifacts && typeof recorded.artifacts === "object") {
@@ -5424,7 +5451,7 @@ function validateSnapshot(configInput) {
 
 // src/index.ts
 var GENERATOR_NAME = "@ankurhalder/codebase-snapshot";
-var GENERATOR_VERSION = "4.0.2";
+var GENERATOR_VERSION = "4.0.4";
 var SCHEMA_VERSION = "3.0.0";
 function sha256Hex2(input) {
   return crypto__namespace.createHash("sha256").update(input).digest("hex");
@@ -5631,6 +5658,18 @@ function resolveSafeOutputDirs(config) {
 var PLACEHOLDER_ENTRIES = /* @__PURE__ */ new Set([".gitkeep", ".gitignore", ".DS_Store"]);
 var RUN_DIR_PREFIX = "run-";
 var STALE_RUN_MS = 60 * 60 * 1e3;
+function maskSummaryStrings(value, secretRules) {
+  if (typeof value === "string") return maskPathText(value, secretRules);
+  if (Array.isArray(value)) return value.map((item) => maskSummaryStrings(item, secretRules));
+  if (value && typeof value === "object") {
+    const out = {};
+    for (const [key, item] of Object.entries(value)) {
+      out[key] = maskSummaryStrings(item, secretRules);
+    }
+    return out;
+  }
+  return value;
+}
 function maskPathText(value, secretRules) {
   return findSecretInPath(value, secretRules)?.masked ?? value;
 }
@@ -6211,8 +6250,8 @@ function generateSnapshot(configInput, options) {
     let summary;
     let summaryQuality;
     try {
-      const outcome = summarizeFile(relativePath, redacted);
-      summary = outcome?.summary;
+      const outcome = summarizeFile(relativePath, rawContent);
+      summary = outcome?.summary ? maskSummaryStrings(outcome.summary, config.secretRules) : void 0;
       summaryQuality = outcome?.quality;
       if (isSourceSummary(summary) && summary.parseErrors) {
         warnings.push(
@@ -7767,7 +7806,7 @@ ${USAGE}
       info(`   - Schema:         ${manifest.schemaVersion}`);
       info(`   - Fingerprint:    ${manifest.fingerprint}`);
       info(`   - Files included: ${manifest.counts.totalFiles}`);
-      info(`   - Total lines:    ${manifest.counts.totalLines.toLocaleString()}`);
+      info(`   - Total lines:    ${manifest.counts.totalLines.toLocaleString("en-US")}`);
       info(
         `   - Total size:     ${(manifest.counts.totalSizeBytes / (1024 * 1024)).toFixed(2)} MB`
       );
@@ -7819,14 +7858,14 @@ ${USAGE}
       info(`
 \u2705 Snapshot generated in ${elapsed}s:`);
       info(`   - Tracked files: ${manifest.counts.totalFiles}`);
-      info(`   - Total lines:   ${manifest.counts.totalLines.toLocaleString()}`);
+      info(`   - Total lines:   ${manifest.counts.totalLines.toLocaleString("en-US")}`);
       info(
         `   - Total size:    ${(manifest.counts.totalSizeBytes / (1024 * 1024)).toFixed(2)} MB`
       );
       const { artifacts } = resolved;
       if (artifacts.parts) {
         info(
-          `   - Parts written: ${manifest.counts.partsCount} under ${displayOutPath(resolved.cwd, resolved.outDir, "parts")}/`
+          `   - Parts written: ${manifest.counts.partsCount} under ${displayOutPath(resolved.cwd, resolved.outDir, "parts")}`
         );
       }
       const reports = [
@@ -7836,7 +7875,7 @@ ${USAGE}
       ].filter(Boolean);
       if (reports.length > 0) {
         info(
-          `   - Reports:       ${displayOutPath(resolved.cwd, resolved.outDir, "reports")}/ (${reports.join(", ")})`
+          `   - Reports:       ${displayOutPath(resolved.cwd, resolved.outDir, "reports")} (${reports.join(", ")})`
         );
       }
       if (artifacts.manifest) {
@@ -7964,6 +8003,21 @@ async function runWatchLoop(invocation, resolved) {
   });
   return 0;
 }
+var entryFile = process.argv[1] ?? "";
+var entryName = path10__namespace.basename(entryFile).toLowerCase();
+var invokedDirectly = entryName === "cli.js" || entryName === "cli.cjs";
+if (invokedDirectly) {
+  void main().then(
+    (code) => {
+      process.exitCode = code;
+    },
+    (err) => {
+      process.stderr.write(`\u274C ${err.message}
+`);
+      process.exitCode = 1;
+    }
+  );
+}
 
 exports.UsageError = UsageError;
 exports.main = main;

package/dist/cli.js

@@ -1,4 +1,4 @@
-import { parseByteSize, GENERATOR_VERSION, ARTIFACT_NAMES, getPreset, unknownPresetMessage, MIN_MAX_PART_BYTES, loadConfigFileDetailed, resolveConfig, validateSnapshot, explainPath, compareManifests, loadManifest, renderDiffText, generateSnapshot, GENERATOR_NAME, runInit, PromptCancelled, SCHEMA_VERSION, PRESETS, renderExplainText } from './chunk-CY3XU5TS.js';
+import { loadConfigFileDetailed, resolveConfig, validateSnapshot, explainPath, compareManifests, loadManifest, renderDiffText, generateSnapshot, GENERATOR_VERSION, ARTIFACT_NAMES, getPreset, unknownPresetMessage, GENERATOR_NAME, runInit, PromptCancelled, MIN_MAX_PART_BYTES, SCHEMA_VERSION, PRESETS, parseByteSize, renderExplainText } from './chunk-CDZDVU74.js';
 import * as fs from 'fs';
 import * as path2 from 'path';
 import { parseArgs } from 'util';
@@ -1302,7 +1302,7 @@ ${USAGE}
       info(`   - Schema:         ${manifest.schemaVersion}`);
       info(`   - Fingerprint:    ${manifest.fingerprint}`);
       info(`   - Files included: ${manifest.counts.totalFiles}`);
-      info(`   - Total lines:    ${manifest.counts.totalLines.toLocaleString()}`);
+      info(`   - Total lines:    ${manifest.counts.totalLines.toLocaleString("en-US")}`);
       info(
         `   - Total size:     ${(manifest.counts.totalSizeBytes / (1024 * 1024)).toFixed(2)} MB`
       );
@@ -1354,14 +1354,14 @@ ${USAGE}
       info(`
 \u2705 Snapshot generated in ${elapsed}s:`);
       info(`   - Tracked files: ${manifest.counts.totalFiles}`);
-      info(`   - Total lines:   ${manifest.counts.totalLines.toLocaleString()}`);
+      info(`   - Total lines:   ${manifest.counts.totalLines.toLocaleString("en-US")}`);
       info(
         `   - Total size:    ${(manifest.counts.totalSizeBytes / (1024 * 1024)).toFixed(2)} MB`
       );
       const { artifacts } = resolved;
       if (artifacts.parts) {
         info(
-          `   - Parts written: ${manifest.counts.partsCount} under ${displayOutPath(resolved.cwd, resolved.outDir, "parts")}/`
+          `   - Parts written: ${manifest.counts.partsCount} under ${displayOutPath(resolved.cwd, resolved.outDir, "parts")}`
         );
       }
       const reports = [
@@ -1371,7 +1371,7 @@ ${USAGE}
       ].filter(Boolean);
       if (reports.length > 0) {
         info(
-          `   - Reports:       ${displayOutPath(resolved.cwd, resolved.outDir, "reports")}/ (${reports.join(", ")})`
+          `   - Reports:       ${displayOutPath(resolved.cwd, resolved.outDir, "reports")} (${reports.join(", ")})`
         );
       }
       if (artifacts.manifest) {
@@ -1499,6 +1499,21 @@ async function runWatchLoop(invocation, resolved) {
   });
   return 0;
 }
+var entryFile = process.argv[1] ?? "";
+var entryName = path2.basename(entryFile).toLowerCase();
+var invokedDirectly = entryName === "cli.js" || entryName === "cli.cjs";
+if (invokedDirectly) {
+  void main().then(
+    (code) => {
+      process.exitCode = code;
+    },
+    (err) => {
+      process.stderr.write(`\u274C ${err.message}
+`);
+      process.exitCode = 1;
+    }
+  );
+}
 
 export { UsageError, main, parseByteOption, parseCliArgs, parsePositiveInteger };
 //# sourceMappingURL=cli.js.map

package/dist/index.cjs

@@ -3429,7 +3429,31 @@ function generateAuditReport(manifest, secretFindings, secretRules) {
     }
     lines.push("");
   }
-  lines.push("## 2. Large Files Analysis", "");
+  const parseIssues = manifest.files.filter(
+    (file) => file.summary !== void 0 && typeof file.summary === "object" && "parseErrors" in file.summary && typeof file.summary.parseErrors === "number" && file.summary.parseErrors > 0
+  );
+  lines.push("## 2. Parse & AST Diagnostics", "");
+  if (parseIssues.length === 0) {
+    lines.push("\u2705 Every parsed file produced a complete structural summary.", "");
+  } else {
+    lines.push(
+      `${parseIssues.length} file(s) produced an incomplete summary:`,
+      "",
+      "| File | Parse Errors |",
+      "| :--- | ---: |"
+    );
+    for (const file of parseIssues) {
+      const errors = file.summary.parseErrors;
+      lines.push(`| \`${mask(file.relativePath)}\` | ${errors} |`);
+    }
+    lines.push(
+      "",
+      "A parse error here means the summary is incomplete, not that the file is excluded \u2014",
+      "the content is still in the parts.",
+      ""
+    );
+  }
+  lines.push("## 3. Large Files Analysis", "");
   const largeFiles = manifest.files.filter((file) => file.isLarge);
   if (largeFiles.length === 0) {
     lines.push("\u2705 No files exceeded the large file budget.", "");
@@ -3448,7 +3472,7 @@ function generateAuditReport(manifest, secretFindings, secretRules) {
     lines.push("");
   }
   lines.push(
-    "## 3. Architecture Layer Distribution",
+    "## 4. Architecture Layer Distribution",
     "",
     "| Layer | File Count | Percentage |",
     "| :--- | :--- | :--- |"
@@ -3462,7 +3486,7 @@ function generateAuditReport(manifest, secretFindings, secretRules) {
   }
   lines.push("");
   lines.push(
-    "## 4. File Kind Distribution",
+    "## 5. File Kind Distribution",
     "",
     "| Kind | File Count | Percentage |",
     "| :--- | :--- | :--- |"
@@ -3474,7 +3498,7 @@ function generateAuditReport(manifest, secretFindings, secretRules) {
     lines.push(`| \`${kind}\` | ${count} | ${pct}% |`);
   }
   lines.push("");
-  lines.push("## 5. Skipped / Non-Text Files", "");
+  lines.push("## 6. Skipped / Non-Text Files", "");
   if (manifest.skipped.length === 0) {
     lines.push("No files were skipped.", "");
   } else {
@@ -4306,6 +4330,9 @@ function validateSnapshot(configInput) {
       });
     }
   }
+  const maskValue = (value) => findSecretInPath(value, config.secretRules)?.masked ?? value;
+  const currentExcludes = config.excludePatterns.map(maskValue);
+  const currentInclude = config.include.map(maskValue);
   const recorded = manifest.config;
   if (recorded && typeof recorded === "object") {
     if (recorded.maxPartBytes !== config.maxPartBytes) {
@@ -4334,15 +4361,15 @@ function validateSnapshot(configInput) {
       );
     }
     const recordedExcludes = Array.isArray(recorded.excludePatterns) ? recorded.excludePatterns : [];
-    if (recordedExcludes.join("\0") !== config.excludePatterns.join("\0")) {
+    if (recordedExcludes.join("\0") !== currentExcludes.join("\0")) {
       drift.configMismatches.push(
-        `excludePatterns: manifest [${recordedExcludes.join(", ")}] vs current [${config.excludePatterns.join(", ")}]`
+        `excludePatterns: manifest [${recordedExcludes.join(", ")}] vs current [${currentExcludes.join(", ")}]`
       );
     }
     const recordedInclude = Array.isArray(recorded.include) ? recorded.include : [];
-    if (recordedInclude.join("\0") !== config.include.join("\0")) {
+    if (recordedInclude.join("\0") !== currentInclude.join("\0")) {
       drift.configMismatches.push(
-        `include: manifest [${recordedInclude.join(", ")}] vs current [${config.include.join(", ")}]`
+        `include: manifest [${recordedInclude.join(", ")}] vs current [${currentInclude.join(", ")}]`
       );
     }
     if (recorded?.artifacts && typeof recorded.artifacts === "object") {
@@ -5437,7 +5464,7 @@ async function runInit(options) {
 
 // src/index.ts
 var GENERATOR_NAME = "@ankurhalder/codebase-snapshot";
-var GENERATOR_VERSION = "4.0.2";
+var GENERATOR_VERSION = "4.0.4";
 var SCHEMA_VERSION = "3.0.0";
 function sha256Hex2(input) {
   return crypto__namespace.createHash("sha256").update(input).digest("hex");
@@ -5644,6 +5671,18 @@ function resolveSafeOutputDirs(config) {
 var PLACEHOLDER_ENTRIES = /* @__PURE__ */ new Set([".gitkeep", ".gitignore", ".DS_Store"]);
 var RUN_DIR_PREFIX = "run-";
 var STALE_RUN_MS = 60 * 60 * 1e3;
+function maskSummaryStrings(value, secretRules) {
+  if (typeof value === "string") return maskPathText(value, secretRules);
+  if (Array.isArray(value)) return value.map((item) => maskSummaryStrings(item, secretRules));
+  if (value && typeof value === "object") {
+    const out = {};
+    for (const [key, item] of Object.entries(value)) {
+      out[key] = maskSummaryStrings(item, secretRules);
+    }
+    return out;
+  }
+  return value;
+}
 function maskPathText(value, secretRules) {
   return findSecretInPath(value, secretRules)?.masked ?? value;
 }
@@ -6224,8 +6263,8 @@ function generateSnapshot(configInput, options) {
     let summary;
     let summaryQuality;
     try {
-      const outcome = summarizeFile(relativePath, redacted);
-      summary = outcome?.summary;
+      const outcome = summarizeFile(relativePath, rawContent);
+      summary = outcome?.summary ? maskSummaryStrings(outcome.summary, config.secretRules) : void 0;
       summaryQuality = outcome?.quality;
       if (isSourceSummary(summary) && summary.parseErrors) {
         warnings.push(

package/dist/index.d.cts

@@ -495,7 +495,7 @@ declare function matchesExclude(relativePath: string, pattern: string): boolean;
 declare function collectFiles(cwd: string, options?: CollectOptions): CollectResult;
 
 declare const GENERATOR_NAME = "@ankurhalder/codebase-snapshot";
-declare const GENERATOR_VERSION = "4.0.2";
+declare const GENERATOR_VERSION = "4.0.4";
 declare const SCHEMA_VERSION = "3.0.0";
 interface GenerateOptions {
     /** Compute the full manifest but write nothing to disk. */

package/dist/index.d.ts

@@ -495,7 +495,7 @@ declare function matchesExclude(relativePath: string, pattern: string): boolean;
 declare function collectFiles(cwd: string, options?: CollectOptions): CollectResult;
 
 declare const GENERATOR_NAME = "@ankurhalder/codebase-snapshot";
-declare const GENERATOR_VERSION = "4.0.2";
+declare const GENERATOR_VERSION = "4.0.4";
 declare const SCHEMA_VERSION = "3.0.0";
 interface GenerateOptions {
     /** Compute the full manifest but write nothing to disk. */

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, countLines, defineConfig, detectLanguage, detectPreset, explainPath, fenceForContent, fenceForText, generateProjectTree, generateSnapshot, generateSnapshotAsync, getPreset, globToRegExp, isBinaryBuffer, isBinaryExtension, isBinaryFile, isInteractive, isResolvedConfig, isSensitivePath, listPresetNames, loadConfigFile, loadConfigFileDetailed, loadManifest, markResolvedConfig, matchRule, matchesExclude, normalizeResolvedConfig, parseByteSize, partitionFiles, profileForPath, renderConfig, renderDiffText, renderExplainText, renderMinimalConfig, renumberParts, resolveConfig, resolveSafeOutputDirs, runInit, scanAndRedactSecrets, stripJsonComments, summarizeJson, summarizeMarkdown, summarizeTypeScriptSource, summarizeWithProfile, supportsTypeScriptImports, truncatePreview, truncateToBytes, validateSnapshot } from './chunk-CY3XU5TS.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, countLines, defineConfig, detectLanguage, detectPreset, explainPath, fenceForContent, fenceForText, generateProjectTree, generateSnapshot, generateSnapshotAsync, getPreset, globToRegExp, isBinaryBuffer, isBinaryExtension, isBinaryFile, isInteractive, isResolvedConfig, isSensitivePath, listPresetNames, loadConfigFile, loadConfigFileDetailed, loadManifest, markResolvedConfig, matchRule, matchesExclude, normalizeResolvedConfig, parseByteSize, partitionFiles, profileForPath, renderConfig, renderDiffText, renderExplainText, renderMinimalConfig, renumberParts, resolveConfig, resolveSafeOutputDirs, runInit, scanAndRedactSecrets, stripJsonComments, summarizeJson, summarizeMarkdown, summarizeTypeScriptSource, summarizeWithProfile, supportsTypeScriptImports, truncatePreview, truncateToBytes, validateSnapshot } from './chunk-CDZDVU74.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ankurhalder/codebase-snapshot",
-  "version": "4.0.2",
+  "version": "4.0.4",
   "description": "Production-grade LLM codebase snapshot generator, auditor, and AST partitioner",
   "keywords": [
     "codebase",