@ankurhalder/codebase-snapshot 4.0.3 → 4.0.5

package/dist/bin.js

@@ -1942,6 +1942,7 @@ import * as path7 from "path";
 
 // src/config.ts
 import * as fs4 from "fs";
+import { createHash } from "crypto";
 import * as path4 from "path";
 import { pathToFileURL } from "url";
 var CONFIG_FILENAMES = [
@@ -2621,6 +2622,27 @@ function classifyKind(filePath, kinds) {
   }
   return "other";
 }
+function configDigest(config) {
+  const material = {
+    maxPartBytes: config.maxPartBytes,
+    largeFileBytes: config.largeFileBytes,
+    previewHeadLines: config.previewHeadLines,
+    previewTailLines: config.previewTailLines,
+    includeMonolith: config.includeMonolith,
+    maxMonolithBytes: config.maxMonolithBytes ?? null,
+    includeSensitiveFiles: config.includeSensitiveFiles,
+    artifacts: config.artifacts,
+    include: config.include,
+    excludePatterns: config.excludePatterns,
+    preset: config.preset,
+    layersMode: config.layersMode,
+    budgets: config.budgets,
+    layers: config.layers.map((layer2) => layer2.name),
+    kinds: config.kinds.map((kind) => kind.kind),
+    secretRules: config.secretRules.map((rule) => `${rule.rule}:${rule.pattern.source}`).sort()
+  };
+  return createHash("sha256").update(JSON.stringify(material)).digest("hex");
+}
 
 // src/partitioner/preview.ts
 function countLines(content) {
@@ -4514,7 +4536,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 +4579,7 @@ function generateAuditReport(manifest, secretFindings, secretRules) {
     lines.push("");
   }
   lines.push(
-    "## 3. Architecture Layer Distribution",
+    "## 4. Architecture Layer Distribution",
     "",
     "| Layer | File Count | Percentage |",
     "| :--- | :--- | :--- |"
@@ -4547,7 +4593,7 @@ function generateAuditReport(manifest, secretFindings, secretRules) {
   }
   lines.push("");
   lines.push(
-    "## 4. File Kind Distribution",
+    "## 5. File Kind Distribution",
     "",
     "| Kind | File Count | Percentage |",
     "| :--- | :--- | :--- |"
@@ -4559,7 +4605,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 {
@@ -5232,6 +5278,11 @@ function validateSnapshot(configInput) {
   const currentExcludes = config.excludePatterns.map(maskValue);
   const currentInclude = config.include.map(maskValue);
   const recorded = manifest.config;
+  if (recorded?.digest && recorded.digest !== configDigest(config)) {
+    drift.configMismatches.push(
+      "configuration: the settings differ from the ones this snapshot was generated with (run generate)"
+    );
+  }
   if (recorded && typeof recorded === "object") {
     if (recorded.maxPartBytes !== config.maxPartBytes) {
       drift.configMismatches.push(
@@ -5447,7 +5498,7 @@ function validateSnapshot(configInput) {
 
 // src/index.ts
 var GENERATOR_NAME = "@ankurhalder/codebase-snapshot";
-var GENERATOR_VERSION = "4.0.3";
+var GENERATOR_VERSION = "4.0.5";
 var SCHEMA_VERSION = "3.0.0";
 function sha256Hex2(input) {
   return crypto3.createHash("sha256").update(input).digest("hex");
@@ -5654,6 +5705,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;
 }
@@ -6234,8 +6297,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(
@@ -6302,6 +6365,7 @@ function generateSnapshot(configInput, options) {
       largeFileBytes: config.largeFileBytes
     },
     config: {
+      digest: configDigest(config),
       maxPartBytes: config.maxPartBytes,
       largeFileBytes: config.largeFileBytes,
       previewHeadLines: config.previewHeadLines,
@@ -7782,7 +7846,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`
       );
@@ -7834,14 +7898,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 = [
@@ -7851,7 +7915,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) {
@@ -7979,6 +8043,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-L7QBLC4C.js → chunk-PCNDUNKT.js}

@@ -1,4 +1,5 @@
 import * as crypto from 'crypto';
+import { createHash } from 'crypto';
 import * as fs9 from 'fs';
 import * as os from 'os';
 import * as path10 from 'path';
@@ -3348,6 +3349,27 @@ function classifyKind(filePath, kinds) {
   }
   return "other";
 }
+function configDigest(config) {
+  const material = {
+    maxPartBytes: config.maxPartBytes,
+    largeFileBytes: config.largeFileBytes,
+    previewHeadLines: config.previewHeadLines,
+    previewTailLines: config.previewTailLines,
+    includeMonolith: config.includeMonolith,
+    maxMonolithBytes: config.maxMonolithBytes ?? null,
+    includeSensitiveFiles: config.includeSensitiveFiles,
+    artifacts: config.artifacts,
+    include: config.include,
+    excludePatterns: config.excludePatterns,
+    preset: config.preset,
+    layersMode: config.layersMode,
+    budgets: config.budgets,
+    layers: config.layers.map((layer2) => layer2.name),
+    kinds: config.kinds.map((kind) => kind.kind),
+    secretRules: config.secretRules.map((rule) => `${rule.rule}:${rule.pattern.source}`).sort()
+  };
+  return createHash("sha256").update(JSON.stringify(material)).digest("hex");
+}
 
 // src/define-config.ts
 function defineConfig(config) {
@@ -3399,7 +3421,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 +3464,7 @@ function generateAuditReport(manifest, secretFindings, secretRules) {
     lines.push("");
   }
   lines.push(
-    "## 3. Architecture Layer Distribution",
+    "## 4. Architecture Layer Distribution",
     "",
     "| Layer | File Count | Percentage |",
     "| :--- | :--- | :--- |"
@@ -3432,7 +3478,7 @@ function generateAuditReport(manifest, secretFindings, secretRules) {
   }
   lines.push("");
   lines.push(
-    "## 4. File Kind Distribution",
+    "## 5. File Kind Distribution",
     "",
     "| Kind | File Count | Percentage |",
     "| :--- | :--- | :--- |"
@@ -3444,7 +3490,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 {
@@ -4280,6 +4326,11 @@ function validateSnapshot(configInput) {
   const currentExcludes = config.excludePatterns.map(maskValue);
   const currentInclude = config.include.map(maskValue);
   const recorded = manifest.config;
+  if (recorded?.digest && recorded.digest !== configDigest(config)) {
+    drift.configMismatches.push(
+      "configuration: the settings differ from the ones this snapshot was generated with (run generate)"
+    );
+  }
   if (recorded && typeof recorded === "object") {
     if (recorded.maxPartBytes !== config.maxPartBytes) {
       drift.configMismatches.push(
@@ -5410,7 +5461,7 @@ async function runInit(options) {
 
 // src/index.ts
 var GENERATOR_NAME = "@ankurhalder/codebase-snapshot";
-var GENERATOR_VERSION = "4.0.3";
+var GENERATOR_VERSION = "4.0.5";
 var SCHEMA_VERSION = "3.0.0";
 function sha256Hex2(input) {
   return crypto.createHash("sha256").update(input).digest("hex");
@@ -5617,6 +5668,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;
 }
@@ -6197,8 +6260,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(
@@ -6265,6 +6328,7 @@ function generateSnapshot(configInput, options) {
       largeFileBytes: config.largeFileBytes
     },
     config: {
+      digest: configDigest(config),
       maxPartBytes: config.maxPartBytes,
       largeFileBytes: config.largeFileBytes,
       previewHeadLines: config.previewHeadLines,
@@ -6458,5 +6522,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-L7QBLC4C.js.map
-//# sourceMappingURL=chunk-L7QBLC4C.js.map
+//# sourceMappingURL=chunk-PCNDUNKT.js.map
+//# sourceMappingURL=chunk-PCNDUNKT.js.map

package/dist/cli.cjs

@@ -4,9 +4,9 @@ var fs9 = require('fs');
 var path10 = require('path');
 var util = require('util');
 var childProcess = require('child_process');
+var crypto = require('crypto');
 var url = require('url');
 var readline = require('readline');
-var crypto = require('crypto');
 var os = require('os');
 var ts = require('typescript');
 
@@ -33,8 +33,8 @@ function _interopNamespace(e) {
 var fs9__namespace = /*#__PURE__*/_interopNamespace(fs9);
 var path10__namespace = /*#__PURE__*/_interopNamespace(path10);
 var childProcess__namespace = /*#__PURE__*/_interopNamespace(childProcess);
-var readline__namespace = /*#__PURE__*/_interopNamespace(readline);
 var crypto__namespace = /*#__PURE__*/_interopNamespace(crypto);
+var readline__namespace = /*#__PURE__*/_interopNamespace(readline);
 var os__namespace = /*#__PURE__*/_interopNamespace(os);
 var ts__default = /*#__PURE__*/_interopDefault(ts);
 
@@ -2634,6 +2634,27 @@ function classifyKind(filePath, kinds) {
   }
   return "other";
 }
+function configDigest(config) {
+  const material = {
+    maxPartBytes: config.maxPartBytes,
+    largeFileBytes: config.largeFileBytes,
+    previewHeadLines: config.previewHeadLines,
+    previewTailLines: config.previewTailLines,
+    includeMonolith: config.includeMonolith,
+    maxMonolithBytes: config.maxMonolithBytes ?? null,
+    includeSensitiveFiles: config.includeSensitiveFiles,
+    artifacts: config.artifacts,
+    include: config.include,
+    excludePatterns: config.excludePatterns,
+    preset: config.preset,
+    layersMode: config.layersMode,
+    budgets: config.budgets,
+    layers: config.layers.map((layer2) => layer2.name),
+    kinds: config.kinds.map((kind) => kind.kind),
+    secretRules: config.secretRules.map((rule) => `${rule.rule}:${rule.pattern.source}`).sort()
+  };
+  return crypto.createHash("sha256").update(JSON.stringify(material)).digest("hex");
+}
 
 // src/partitioner/preview.ts
 function countLines(content) {
@@ -4502,7 +4523,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 +4566,7 @@ function generateAuditReport(manifest, secretFindings, secretRules) {
     lines.push("");
   }
   lines.push(
-    "## 3. Architecture Layer Distribution",
+    "## 4. Architecture Layer Distribution",
     "",
     "| Layer | File Count | Percentage |",
     "| :--- | :--- | :--- |"
@@ -4535,7 +4580,7 @@ function generateAuditReport(manifest, secretFindings, secretRules) {
   }
   lines.push("");
   lines.push(
-    "## 4. File Kind Distribution",
+    "## 5. File Kind Distribution",
     "",
     "| Kind | File Count | Percentage |",
     "| :--- | :--- | :--- |"
@@ -4547,7 +4592,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 {
@@ -5212,6 +5257,11 @@ function validateSnapshot(configInput) {
   const currentExcludes = config.excludePatterns.map(maskValue);
   const currentInclude = config.include.map(maskValue);
   const recorded = manifest.config;
+  if (recorded?.digest && recorded.digest !== configDigest(config)) {
+    drift.configMismatches.push(
+      "configuration: the settings differ from the ones this snapshot was generated with (run generate)"
+    );
+  }
   if (recorded && typeof recorded === "object") {
     if (recorded.maxPartBytes !== config.maxPartBytes) {
       drift.configMismatches.push(
@@ -5427,7 +5477,7 @@ function validateSnapshot(configInput) {
 
 // src/index.ts
 var GENERATOR_NAME = "@ankurhalder/codebase-snapshot";
-var GENERATOR_VERSION = "4.0.3";
+var GENERATOR_VERSION = "4.0.5";
 var SCHEMA_VERSION = "3.0.0";
 function sha256Hex2(input) {
   return crypto__namespace.createHash("sha256").update(input).digest("hex");
@@ -5634,6 +5684,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;
 }
@@ -6214,8 +6276,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(
@@ -6282,6 +6344,7 @@ function generateSnapshot(configInput, options) {
       largeFileBytes: config.largeFileBytes
     },
     config: {
+      digest: configDigest(config),
       maxPartBytes: config.maxPartBytes,
       largeFileBytes: config.largeFileBytes,
       previewHeadLines: config.previewHeadLines,
@@ -7770,7 +7833,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`
       );
@@ -7822,14 +7885,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 = [
@@ -7839,7 +7902,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) {
@@ -7967,6 +8030,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.d.cts

@@ -1,4 +1,4 @@
-import { O as OutputFormat } from './types-LSfwsKE-.cjs';
+import { O as OutputFormat } from './types-x7aogSer.cjs';
 
 type Command = "generate" | "validate" | "report" | "init" | "explain" | "diff" | "describe" | "skill";
 /** A user-input problem: printed without a stack trace, exits 2. */

package/dist/cli.d.ts

@@ -1,4 +1,4 @@
-import { O as OutputFormat } from './types-LSfwsKE-.js';
+import { O as OutputFormat } from './types-x7aogSer.js';
 
 type Command = "generate" | "validate" | "report" | "init" | "explain" | "diff" | "describe" | "skill";
 /** A user-input problem: printed without a stack trace, exits 2. */

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-L7QBLC4C.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-PCNDUNKT.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

@@ -3378,6 +3378,27 @@ function classifyKind(filePath, kinds) {
   }
   return "other";
 }
+function configDigest(config) {
+  const material = {
+    maxPartBytes: config.maxPartBytes,
+    largeFileBytes: config.largeFileBytes,
+    previewHeadLines: config.previewHeadLines,
+    previewTailLines: config.previewTailLines,
+    includeMonolith: config.includeMonolith,
+    maxMonolithBytes: config.maxMonolithBytes ?? null,
+    includeSensitiveFiles: config.includeSensitiveFiles,
+    artifacts: config.artifacts,
+    include: config.include,
+    excludePatterns: config.excludePatterns,
+    preset: config.preset,
+    layersMode: config.layersMode,
+    budgets: config.budgets,
+    layers: config.layers.map((layer2) => layer2.name),
+    kinds: config.kinds.map((kind) => kind.kind),
+    secretRules: config.secretRules.map((rule) => `${rule.rule}:${rule.pattern.source}`).sort()
+  };
+  return crypto.createHash("sha256").update(JSON.stringify(material)).digest("hex");
+}
 
 // src/define-config.ts
 function defineConfig(config) {
@@ -3429,7 +3450,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 +3493,7 @@ function generateAuditReport(manifest, secretFindings, secretRules) {
     lines.push("");
   }
   lines.push(
-    "## 3. Architecture Layer Distribution",
+    "## 4. Architecture Layer Distribution",
     "",
     "| Layer | File Count | Percentage |",
     "| :--- | :--- | :--- |"
@@ -3462,7 +3507,7 @@ function generateAuditReport(manifest, secretFindings, secretRules) {
   }
   lines.push("");
   lines.push(
-    "## 4. File Kind Distribution",
+    "## 5. File Kind Distribution",
     "",
     "| Kind | File Count | Percentage |",
     "| :--- | :--- | :--- |"
@@ -3474,7 +3519,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 {
@@ -4310,6 +4355,11 @@ function validateSnapshot(configInput) {
   const currentExcludes = config.excludePatterns.map(maskValue);
   const currentInclude = config.include.map(maskValue);
   const recorded = manifest.config;
+  if (recorded?.digest && recorded.digest !== configDigest(config)) {
+    drift.configMismatches.push(
+      "configuration: the settings differ from the ones this snapshot was generated with (run generate)"
+    );
+  }
   if (recorded && typeof recorded === "object") {
     if (recorded.maxPartBytes !== config.maxPartBytes) {
       drift.configMismatches.push(
@@ -5440,7 +5490,7 @@ async function runInit(options) {
 
 // src/index.ts
 var GENERATOR_NAME = "@ankurhalder/codebase-snapshot";
-var GENERATOR_VERSION = "4.0.3";
+var GENERATOR_VERSION = "4.0.5";
 var SCHEMA_VERSION = "3.0.0";
 function sha256Hex2(input) {
   return crypto__namespace.createHash("sha256").update(input).digest("hex");
@@ -5647,6 +5697,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;
 }
@@ -6227,8 +6289,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(
@@ -6295,6 +6357,7 @@ function generateSnapshot(configInput, options) {
       largeFileBytes: config.largeFileBytes
     },
     config: {
+      digest: configDigest(config),
       maxPartBytes: config.maxPartBytes,
       largeFileBytes: config.largeFileBytes,
       previewHeadLines: config.previewHeadLines,

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { J as JsonSummary, M as MarkdownSummary, S as SourceSummary, R as ResolvedSnapshotConfig, a as SnapshotConfig, B as ByteSize, C as CliOptions, F as FileEntry, P as PartMetadata, L as LayerRule, K as KindRule, b as SecretRule, c as SecretFinding, V as ValidationResult, d as Manifest, A as ArtifactSelection, e as SkipRecord } from './types-LSfwsKE-.cjs';
-export { f as BudgetConfig, H as HooksConfig, I as InclusionMode, g as ManifestArtifact, h as ManifestConfigSnapshot, i as ManifestIndexes, j as ManifestTotals, k as Mode, O as OutputFormat, l as PartFileEntry, m as ResolvedArtifacts, n as ResolvedBudgets, o as SecretRuleInput, p as SkipReason, q as SummaryQuality, r as ValidationDrift } from './types-LSfwsKE-.cjs';
+import { J as JsonSummary, M as MarkdownSummary, S as SourceSummary, R as ResolvedSnapshotConfig, a as SnapshotConfig, B as ByteSize, C as CliOptions, F as FileEntry, P as PartMetadata, L as LayerRule, K as KindRule, b as SecretRule, c as SecretFinding, V as ValidationResult, d as Manifest, A as ArtifactSelection, e as SkipRecord } from './types-x7aogSer.cjs';
+export { f as BudgetConfig, H as HooksConfig, I as InclusionMode, g as ManifestArtifact, h as ManifestConfigSnapshot, i as ManifestIndexes, j as ManifestTotals, k as Mode, O as OutputFormat, l as PartFileEntry, m as ResolvedArtifacts, n as ResolvedBudgets, o as SecretRuleInput, p as SkipReason, q as SummaryQuality, r as ValidationDrift } from './types-x7aogSer.cjs';
 
 /**
  * Strips `//` and block comments the way JSONC does, without touching anything
@@ -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.3";
+declare const GENERATOR_VERSION = "4.0.5";
 declare const SCHEMA_VERSION = "3.0.0";
 interface GenerateOptions {
     /** Compute the full manifest but write nothing to disk. */

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { J as JsonSummary, M as MarkdownSummary, S as SourceSummary, R as ResolvedSnapshotConfig, a as SnapshotConfig, B as ByteSize, C as CliOptions, F as FileEntry, P as PartMetadata, L as LayerRule, K as KindRule, b as SecretRule, c as SecretFinding, V as ValidationResult, d as Manifest, A as ArtifactSelection, e as SkipRecord } from './types-LSfwsKE-.js';
-export { f as BudgetConfig, H as HooksConfig, I as InclusionMode, g as ManifestArtifact, h as ManifestConfigSnapshot, i as ManifestIndexes, j as ManifestTotals, k as Mode, O as OutputFormat, l as PartFileEntry, m as ResolvedArtifacts, n as ResolvedBudgets, o as SecretRuleInput, p as SkipReason, q as SummaryQuality, r as ValidationDrift } from './types-LSfwsKE-.js';
+import { J as JsonSummary, M as MarkdownSummary, S as SourceSummary, R as ResolvedSnapshotConfig, a as SnapshotConfig, B as ByteSize, C as CliOptions, F as FileEntry, P as PartMetadata, L as LayerRule, K as KindRule, b as SecretRule, c as SecretFinding, V as ValidationResult, d as Manifest, A as ArtifactSelection, e as SkipRecord } from './types-x7aogSer.js';
+export { f as BudgetConfig, H as HooksConfig, I as InclusionMode, g as ManifestArtifact, h as ManifestConfigSnapshot, i as ManifestIndexes, j as ManifestTotals, k as Mode, O as OutputFormat, l as PartFileEntry, m as ResolvedArtifacts, n as ResolvedBudgets, o as SecretRuleInput, p as SkipReason, q as SummaryQuality, r as ValidationDrift } from './types-x7aogSer.js';
 
 /**
  * Strips `//` and block comments the way JSONC does, without touching anything
@@ -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.3";
+declare const GENERATOR_VERSION = "4.0.5";
 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-L7QBLC4C.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-PCNDUNKT.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/{types-LSfwsKE-.d.cts → types-x7aogSer.d.cts}

@@ -207,6 +207,8 @@ interface ManifestIndexes {
 }
 /** Effective configuration recorded so `validate` can detect config drift. */
 interface ManifestConfigSnapshot {
+    /** Digest of the effective settings; see `configDigest`. */
+    digest?: string;
     maxPartBytes: number;
     largeFileBytes: number;
     previewHeadLines: number;

package/dist/{types-LSfwsKE-.d.ts → types-x7aogSer.d.ts}

@@ -207,6 +207,8 @@ interface ManifestIndexes {
 }
 /** Effective configuration recorded so `validate` can detect config drift. */
 interface ManifestConfigSnapshot {
+    /** Digest of the effective settings; see `configDigest`. */
+    digest?: string;
     maxPartBytes: number;
     largeFileBytes: number;
     previewHeadLines: number;

package/package.json

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