@ankurhalder/codebase-snapshot 2.0.0 → 2.1.1

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, e as SkipRecord } from './types-S-5eRuRc.cjs';
-export { A as ArtifactSelection, 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 ValidationDrift } from './types-S-5eRuRc.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-CJqkePM4.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-CJqkePM4.cjs';
 
 /**
  * Strips `//` and block comments the way JSONC does, without touching anything
@@ -59,6 +59,16 @@ interface ConfigLoadResult {
     file: string | null;
     /** Why a candidate config file was ignored. Never silently discarded. */
     warnings: string[];
+    /**
+     * Config files that exist but could not be read.
+     *
+     * These are fatal: a config that fails to parse used to be skipped in favour of
+     * the defaults, which meant a typo silently produced a snapshot with none of the
+     * developer's settings applied. A config that is merely unsupported on this Node
+     * version (a `.ts` file below Node 22.6) stays a warning — nothing is wrong with
+     * the file, and the message already says what to do.
+     */
+    errors: string[];
 }
 /** True when this Node can `import()` a `.ts` file natively (type stripping). */
 declare function supportsTypeScriptImports(): boolean;
@@ -164,11 +174,58 @@ declare function truncateToBytes(content: string, maxBytes: number): {
 };
 declare function truncatePreview(content: string, headLines: number, tailLines: number): PreviewResult;
 
-declare function detectPreset(cwd: string): {
+/**
+ * Everything preset detection is allowed to look at.
+ *
+ * Built once per run: the previous implementation re-read `package.json` inside
+ * every detector, which was both slow and incapable of seeing anything outside
+ * the JavaScript ecosystem.
+ */
+interface PresetContext {
+    cwd: string;
+    /** Top-level file names, e.g. `next.config.ts`. */
+    files: ReadonlySet<string>;
+    /** Top-level directory names. */
+    dirs: ReadonlySet<string>;
+    /** `dependencies` + `devDependencies` + `peerDependencies` names. */
+    dependencies: ReadonlySet<string>;
+    /** Small snapshots of well-known manifests, for keyword detection. */
+    manifests: Readonly<Record<string, string>>;
+}
+
+interface PresetDefinition {
+    readonly name: string;
+    /** Higher wins. Framework presets outrank repository shapes. */
+    readonly priority: number;
+    detect(context: PresetContext): boolean;
+    readonly layers: LayerRule[];
+    readonly kinds: KindRule[];
+    /** Ecosystem-specific ignores, merged with the user's `excludePatterns`. */
+    readonly exclude?: string[];
+    /** Advice for the setup wizard. Never applied automatically. */
+    readonly recommendedBudget?: ByteSize;
+}
+interface DetectedPreset {
     presetName: string;
     layers: LayerRule[];
     kinds: KindRule[];
-};
+    /** Ecosystem ignores the scanner should apply in addition to the user's. */
+    exclude: string[];
+    recommendedBudget: ByteSize | null;
+}
+/**
+ * Every preset, ordered by priority.
+ *
+ * Ordering is the whole detection model: the first definition whose `detect`
+ * returns true wins, so the list is sorted once at module load rather than being
+ * hand-maintained in the right order.
+ */
+declare const PRESETS: readonly PresetDefinition[];
+/** Every preset name, in priority order — used by the CLI and the wizard. */
+declare function listPresetNames(): string[];
+declare function getPreset(name: string): PresetDefinition | undefined;
+/** Detects the preset for `cwd`, reading the repository once. */
+declare function detectPreset(cwd: string, forced?: string): DetectedPreset;
 
 declare function isBinaryExtension(filePath: string): boolean;
 declare function isBinaryBuffer(buffer: Buffer): boolean;
@@ -284,6 +341,117 @@ declare function loadManifest(target: string): Manifest;
 /** Renders a diff for a terminal. */
 declare function renderDiffText(diff: ManifestDiff): string;
 
+interface PromptIO {
+    input: NodeJS.ReadStream;
+    output: NodeJS.WriteStream;
+}
+/** Thrown when the developer presses Ctrl+C or Ctrl+D mid-prompt. */
+declare class PromptCancelled extends Error {
+    constructor();
+}
+/** Both ends must be a TTY before anything interactive is attempted. */
+declare function isInteractive(io: PromptIO): boolean;
+
+interface InitOptions {
+    cwd: string;
+    /** Force a preset instead of detecting one. */
+    preset?: string;
+    maxPartBytes?: ByteSize;
+    include?: string[];
+    exclude?: string[];
+    skipArtifacts?: string[];
+    onlyArtifacts?: string[];
+    includeSensitiveFiles?: boolean;
+    /** Accept every default without prompting. */
+    yes?: boolean;
+    /** Write only the settings that differ from the defaults. */
+    minimal?: boolean;
+    /** Overwrite an existing config. */
+    force?: boolean;
+    /** Render the config without writing anything. */
+    dryRun?: boolean;
+    outDir?: string;
+    io?: PromptIO;
+}
+interface InitResult {
+    configPath: string;
+    configText: string;
+    written: boolean;
+    preset: string;
+    scripts: string[];
+    gitignoreEntries: string[];
+    /** Human-readable notes about anything that was skipped or could not be done. */
+    notes: string[];
+}
+/**
+ * Runs the interactive setup, or writes a config from flags.
+ *
+ * Interactive only when both ends are a TTY and `--yes` was not passed; every
+ * other path uses the flag values and the detected preset, and prints what it
+ * decided rather than prompting.
+ */
+declare function runInit(options: InitOptions): Promise<InitResult>;
+
+/** What the wizard decided, after prompts or flags. */
+interface WizardAnswers {
+    preset: string;
+    maxPartBytes: ByteSize;
+    largeFileBytes: ByteSize;
+    include: string[];
+    excludePatterns: string[];
+    artifacts: Required<ArtifactSelection>;
+    includeSensitiveFiles: boolean;
+    outDir: string;
+}
+declare const DEFAULT_ANSWERS: WizardAnswers;
+/**
+ * Renders the full, self-documenting config.
+ *
+ * Every setting appears at its current value, commented and grouped, because
+ * most developers never open the documentation — a file that lists only their
+ * changes cannot tell them what else exists. Deleting any line is safe: the
+ * defaults are real.
+ */
+declare function renderConfig(answers: WizardAnswers): string;
+/**
+ * The terse variant: only what differs from the defaults.
+ *
+ * `--minimal` exists for people who prefer a short file and will read the docs.
+ */
+declare function renderMinimalConfig(answers: WizardAnswers): string;
+
+interface HeuristicResult {
+    summary: SourceSummary;
+    /**
+     * `ast` only when a real parser produced this (TypeScript, and the script
+     * block of a Vue/Svelte/Astro component). Everything else is `heuristic`, and
+     * the manifest says so — a line-scan is not a parse.
+     */
+    quality: "ast" | "heuristic";
+}
+interface LanguageProfile {
+    readonly id: string;
+    readonly extensions: readonly string[];
+    summarize(path: string, content: string): HeuristicResult;
+}
+
+/**
+ * Every heuristic profile, in no particular order — lookup is by extension.
+ *
+ * Adding a language is one file exporting a `LanguageProfile` plus one line
+ * here; nothing else in the pipeline changes.
+ */
+declare const LANGUAGE_PROFILES: readonly LanguageProfile[];
+/** The profile that owns `path`, or `null` when no profile claims it. */
+declare function profileForPath(path: string): LanguageProfile | null;
+/**
+ * Summarizes `path` with whichever profile claims it.
+ *
+ * Returns `null` for files no profile handles — those still enter the snapshot,
+ * they just carry no structural summary.
+ */
+declare function summarizeWithProfile(path: string, content: string): HeuristicResult | null;
+
 interface CollectOptions {
     /**
      * When non-empty, only files matching at least one pattern are candidates.
@@ -329,7 +497,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 = "2.0.0";
+declare const GENERATOR_VERSION = "2.1.1";
 declare const SCHEMA_VERSION = "3.0.0";
 interface GenerateOptions {
     /** Compute the full manifest but write nothing to disk. */
@@ -350,6 +518,15 @@ declare function resolveSafeOutputDirs(config: {
     outDir: string;
     tmpDir: string;
 };
+/**
+ * Refuses to replace a directory that this generator did not write.
+ *
+ * `swapIntoPlace` renames the previous output aside and deletes it, and the
+ * scratch directory is deleted outright before every run. Path checks alone
+ * cannot make that safe: `outDir: "src"` is a plausible typo, and it used to
+ * delete the developer's entire source tree and exit 0.
+ */
+declare function assertReplaceable(target: string, label: "outDir" | "tmpDir"): void;
 /**
  * Generates the snapshot.
  *
@@ -361,4 +538,4 @@ declare function generateSnapshot(configInput?: SnapshotConfig | ResolvedSnapsho
 /** Promise-returning wrapper for consumers that prefer an async call site. */
 declare function generateSnapshotAsync(configInput?: SnapshotConfig | ResolvedSnapshotConfig | null, options?: GenerateOptions): Promise<Manifest>;
 
-export { ARTIFACT_NAMES, ByteSize, CliOptions, DEFAULT_SECRET_PATTERNS, type ExplainResult, FileEntry, GENERATOR_NAME, GENERATOR_VERSION, type GenerateOptions, JsonSummary, KindRule, LayerRule, MIN_MAX_PART_BYTES, Manifest, type ManifestDiff, MarkdownSummary, PartMetadata, ResolvedSnapshotConfig, SCHEMA_VERSION, SecretFinding, SecretRule, SkipRecord, SnapshotConfig, SourceSummary, ValidationResult, anchorForPath, assertUsableConfigInput, collectFiles, compareManifests, countLines, defineConfig, detectLanguage, detectPreset, explainPath, fenceForContent, generateProjectTree, generateSnapshot, generateSnapshotAsync, globToRegExp, isBinaryBuffer, isBinaryExtension, isBinaryFile, isResolvedConfig, isSensitivePath, loadConfigFile, loadConfigFileDetailed, loadManifest, markResolvedConfig, matchRule, matchesExclude, normalizeResolvedConfig, parseByteSize, partitionFiles, renderDiffText, renderExplainText, renumberParts, resolveConfig, resolveSafeOutputDirs, scanAndRedactSecrets, stripJsonComments, summarizeJson, summarizeMarkdown, summarizeTypeScriptSource, supportsTypeScriptImports, truncatePreview, truncateToBytes, validateSnapshot };
+export { ARTIFACT_NAMES, ArtifactSelection, ByteSize, CliOptions, DEFAULT_ANSWERS, DEFAULT_SECRET_PATTERNS, type ExplainResult, FileEntry, GENERATOR_NAME, GENERATOR_VERSION, type GenerateOptions, type HeuristicResult, type InitOptions, type InitResult, JsonSummary, KindRule, LANGUAGE_PROFILES, type LanguageProfile, LayerRule, MIN_MAX_PART_BYTES, Manifest, type ManifestDiff, MarkdownSummary, PRESETS, PartMetadata, PromptCancelled, ResolvedSnapshotConfig, SCHEMA_VERSION, SecretFinding, SecretRule, SkipRecord, SnapshotConfig, SourceSummary, ValidationResult, type WizardAnswers, anchorForPath, assertReplaceable, assertUsableConfigInput, collectFiles, compareManifests, countLines, defineConfig, detectLanguage, detectPreset, explainPath, fenceForContent, 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 };

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, e as SkipRecord } from './types-S-5eRuRc.js';
-export { A as ArtifactSelection, 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 ValidationDrift } from './types-S-5eRuRc.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-CJqkePM4.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-CJqkePM4.js';
 
 /**
  * Strips `//` and block comments the way JSONC does, without touching anything
@@ -59,6 +59,16 @@ interface ConfigLoadResult {
     file: string | null;
     /** Why a candidate config file was ignored. Never silently discarded. */
     warnings: string[];
+    /**
+     * Config files that exist but could not be read.
+     *
+     * These are fatal: a config that fails to parse used to be skipped in favour of
+     * the defaults, which meant a typo silently produced a snapshot with none of the
+     * developer's settings applied. A config that is merely unsupported on this Node
+     * version (a `.ts` file below Node 22.6) stays a warning — nothing is wrong with
+     * the file, and the message already says what to do.
+     */
+    errors: string[];
 }
 /** True when this Node can `import()` a `.ts` file natively (type stripping). */
 declare function supportsTypeScriptImports(): boolean;
@@ -164,11 +174,58 @@ declare function truncateToBytes(content: string, maxBytes: number): {
 };
 declare function truncatePreview(content: string, headLines: number, tailLines: number): PreviewResult;
 
-declare function detectPreset(cwd: string): {
+/**
+ * Everything preset detection is allowed to look at.
+ *
+ * Built once per run: the previous implementation re-read `package.json` inside
+ * every detector, which was both slow and incapable of seeing anything outside
+ * the JavaScript ecosystem.
+ */
+interface PresetContext {
+    cwd: string;
+    /** Top-level file names, e.g. `next.config.ts`. */
+    files: ReadonlySet<string>;
+    /** Top-level directory names. */
+    dirs: ReadonlySet<string>;
+    /** `dependencies` + `devDependencies` + `peerDependencies` names. */
+    dependencies: ReadonlySet<string>;
+    /** Small snapshots of well-known manifests, for keyword detection. */
+    manifests: Readonly<Record<string, string>>;
+}
+
+interface PresetDefinition {
+    readonly name: string;
+    /** Higher wins. Framework presets outrank repository shapes. */
+    readonly priority: number;
+    detect(context: PresetContext): boolean;
+    readonly layers: LayerRule[];
+    readonly kinds: KindRule[];
+    /** Ecosystem-specific ignores, merged with the user's `excludePatterns`. */
+    readonly exclude?: string[];
+    /** Advice for the setup wizard. Never applied automatically. */
+    readonly recommendedBudget?: ByteSize;
+}
+interface DetectedPreset {
     presetName: string;
     layers: LayerRule[];
     kinds: KindRule[];
-};
+    /** Ecosystem ignores the scanner should apply in addition to the user's. */
+    exclude: string[];
+    recommendedBudget: ByteSize | null;
+}
+/**
+ * Every preset, ordered by priority.
+ *
+ * Ordering is the whole detection model: the first definition whose `detect`
+ * returns true wins, so the list is sorted once at module load rather than being
+ * hand-maintained in the right order.
+ */
+declare const PRESETS: readonly PresetDefinition[];
+/** Every preset name, in priority order — used by the CLI and the wizard. */
+declare function listPresetNames(): string[];
+declare function getPreset(name: string): PresetDefinition | undefined;
+/** Detects the preset for `cwd`, reading the repository once. */
+declare function detectPreset(cwd: string, forced?: string): DetectedPreset;
 
 declare function isBinaryExtension(filePath: string): boolean;
 declare function isBinaryBuffer(buffer: Buffer): boolean;
@@ -284,6 +341,117 @@ declare function loadManifest(target: string): Manifest;
 /** Renders a diff for a terminal. */
 declare function renderDiffText(diff: ManifestDiff): string;
 
+interface PromptIO {
+    input: NodeJS.ReadStream;
+    output: NodeJS.WriteStream;
+}
+/** Thrown when the developer presses Ctrl+C or Ctrl+D mid-prompt. */
+declare class PromptCancelled extends Error {
+    constructor();
+}
+/** Both ends must be a TTY before anything interactive is attempted. */
+declare function isInteractive(io: PromptIO): boolean;
+
+interface InitOptions {
+    cwd: string;
+    /** Force a preset instead of detecting one. */
+    preset?: string;
+    maxPartBytes?: ByteSize;
+    include?: string[];
+    exclude?: string[];
+    skipArtifacts?: string[];
+    onlyArtifacts?: string[];
+    includeSensitiveFiles?: boolean;
+    /** Accept every default without prompting. */
+    yes?: boolean;
+    /** Write only the settings that differ from the defaults. */
+    minimal?: boolean;
+    /** Overwrite an existing config. */
+    force?: boolean;
+    /** Render the config without writing anything. */
+    dryRun?: boolean;
+    outDir?: string;
+    io?: PromptIO;
+}
+interface InitResult {
+    configPath: string;
+    configText: string;
+    written: boolean;
+    preset: string;
+    scripts: string[];
+    gitignoreEntries: string[];
+    /** Human-readable notes about anything that was skipped or could not be done. */
+    notes: string[];
+}
+/**
+ * Runs the interactive setup, or writes a config from flags.
+ *
+ * Interactive only when both ends are a TTY and `--yes` was not passed; every
+ * other path uses the flag values and the detected preset, and prints what it
+ * decided rather than prompting.
+ */
+declare function runInit(options: InitOptions): Promise<InitResult>;
+
+/** What the wizard decided, after prompts or flags. */
+interface WizardAnswers {
+    preset: string;
+    maxPartBytes: ByteSize;
+    largeFileBytes: ByteSize;
+    include: string[];
+    excludePatterns: string[];
+    artifacts: Required<ArtifactSelection>;
+    includeSensitiveFiles: boolean;
+    outDir: string;
+}
+declare const DEFAULT_ANSWERS: WizardAnswers;
+/**
+ * Renders the full, self-documenting config.
+ *
+ * Every setting appears at its current value, commented and grouped, because
+ * most developers never open the documentation — a file that lists only their
+ * changes cannot tell them what else exists. Deleting any line is safe: the
+ * defaults are real.
+ */
+declare function renderConfig(answers: WizardAnswers): string;
+/**
+ * The terse variant: only what differs from the defaults.
+ *
+ * `--minimal` exists for people who prefer a short file and will read the docs.
+ */
+declare function renderMinimalConfig(answers: WizardAnswers): string;
+
+interface HeuristicResult {
+    summary: SourceSummary;
+    /**
+     * `ast` only when a real parser produced this (TypeScript, and the script
+     * block of a Vue/Svelte/Astro component). Everything else is `heuristic`, and
+     * the manifest says so — a line-scan is not a parse.
+     */
+    quality: "ast" | "heuristic";
+}
+interface LanguageProfile {
+    readonly id: string;
+    readonly extensions: readonly string[];
+    summarize(path: string, content: string): HeuristicResult;
+}
+
+/**
+ * Every heuristic profile, in no particular order — lookup is by extension.
+ *
+ * Adding a language is one file exporting a `LanguageProfile` plus one line
+ * here; nothing else in the pipeline changes.
+ */
+declare const LANGUAGE_PROFILES: readonly LanguageProfile[];
+/** The profile that owns `path`, or `null` when no profile claims it. */
+declare function profileForPath(path: string): LanguageProfile | null;
+/**
+ * Summarizes `path` with whichever profile claims it.
+ *
+ * Returns `null` for files no profile handles — those still enter the snapshot,
+ * they just carry no structural summary.
+ */
+declare function summarizeWithProfile(path: string, content: string): HeuristicResult | null;
+
 interface CollectOptions {
     /**
      * When non-empty, only files matching at least one pattern are candidates.
@@ -329,7 +497,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 = "2.0.0";
+declare const GENERATOR_VERSION = "2.1.1";
 declare const SCHEMA_VERSION = "3.0.0";
 interface GenerateOptions {
     /** Compute the full manifest but write nothing to disk. */
@@ -350,6 +518,15 @@ declare function resolveSafeOutputDirs(config: {
     outDir: string;
     tmpDir: string;
 };
+/**
+ * Refuses to replace a directory that this generator did not write.
+ *
+ * `swapIntoPlace` renames the previous output aside and deletes it, and the
+ * scratch directory is deleted outright before every run. Path checks alone
+ * cannot make that safe: `outDir: "src"` is a plausible typo, and it used to
+ * delete the developer's entire source tree and exit 0.
+ */
+declare function assertReplaceable(target: string, label: "outDir" | "tmpDir"): void;
 /**
  * Generates the snapshot.
  *
@@ -361,4 +538,4 @@ declare function generateSnapshot(configInput?: SnapshotConfig | ResolvedSnapsho
 /** Promise-returning wrapper for consumers that prefer an async call site. */
 declare function generateSnapshotAsync(configInput?: SnapshotConfig | ResolvedSnapshotConfig | null, options?: GenerateOptions): Promise<Manifest>;
 
-export { ARTIFACT_NAMES, ByteSize, CliOptions, DEFAULT_SECRET_PATTERNS, type ExplainResult, FileEntry, GENERATOR_NAME, GENERATOR_VERSION, type GenerateOptions, JsonSummary, KindRule, LayerRule, MIN_MAX_PART_BYTES, Manifest, type ManifestDiff, MarkdownSummary, PartMetadata, ResolvedSnapshotConfig, SCHEMA_VERSION, SecretFinding, SecretRule, SkipRecord, SnapshotConfig, SourceSummary, ValidationResult, anchorForPath, assertUsableConfigInput, collectFiles, compareManifests, countLines, defineConfig, detectLanguage, detectPreset, explainPath, fenceForContent, generateProjectTree, generateSnapshot, generateSnapshotAsync, globToRegExp, isBinaryBuffer, isBinaryExtension, isBinaryFile, isResolvedConfig, isSensitivePath, loadConfigFile, loadConfigFileDetailed, loadManifest, markResolvedConfig, matchRule, matchesExclude, normalizeResolvedConfig, parseByteSize, partitionFiles, renderDiffText, renderExplainText, renumberParts, resolveConfig, resolveSafeOutputDirs, scanAndRedactSecrets, stripJsonComments, summarizeJson, summarizeMarkdown, summarizeTypeScriptSource, supportsTypeScriptImports, truncatePreview, truncateToBytes, validateSnapshot };
+export { ARTIFACT_NAMES, ArtifactSelection, ByteSize, CliOptions, DEFAULT_ANSWERS, DEFAULT_SECRET_PATTERNS, type ExplainResult, FileEntry, GENERATOR_NAME, GENERATOR_VERSION, type GenerateOptions, type HeuristicResult, type InitOptions, type InitResult, JsonSummary, KindRule, LANGUAGE_PROFILES, type LanguageProfile, LayerRule, MIN_MAX_PART_BYTES, Manifest, type ManifestDiff, MarkdownSummary, PRESETS, PartMetadata, PromptCancelled, ResolvedSnapshotConfig, SCHEMA_VERSION, SecretFinding, SecretRule, SkipRecord, SnapshotConfig, SourceSummary, ValidationResult, type WizardAnswers, anchorForPath, assertReplaceable, assertUsableConfigInput, collectFiles, compareManifests, countLines, defineConfig, detectLanguage, detectPreset, explainPath, fenceForContent, 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 };

package/dist/index.js

@@ -1,3 +1,3 @@
-export { ARTIFACT_NAMES, DEFAULT_SECRET_PATTERNS, GENERATOR_NAME, GENERATOR_VERSION, MIN_MAX_PART_BYTES, SCHEMA_VERSION, anchorForPath, assertUsableConfigInput, collectFiles, compareManifests, countLines, defineConfig, detectLanguage, detectPreset, explainPath, fenceForContent, generateProjectTree, generateSnapshot, generateSnapshotAsync, globToRegExp, isBinaryBuffer, isBinaryExtension, isBinaryFile, isResolvedConfig, isSensitivePath, loadConfigFile, loadConfigFileDetailed, loadManifest, markResolvedConfig, matchRule, matchesExclude, normalizeResolvedConfig, parseByteSize, partitionFiles, renderDiffText, renderExplainText, renumberParts, resolveConfig, resolveSafeOutputDirs, scanAndRedactSecrets, stripJsonComments, summarizeJson, summarizeMarkdown, summarizeTypeScriptSource, supportsTypeScriptImports, truncatePreview, truncateToBytes, validateSnapshot } from './chunk-RGDVLQTT.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, 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-SUOJL5EX.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/{types-S-5eRuRc.d.cts → types-CJqkePM4.d.cts}

@@ -34,6 +34,16 @@ interface MarkdownSummary {
     headings: string[];
     frontmatterKeys: string[];
 }
+/**
+ * How a summary was produced.
+ *
+ * `ast`        — a real parser (TypeScript compiler; the script block of a
+ *                Vue/Svelte/Astro component).
+ * `structural` — a real grammar for a data format (JSON, Markdown).
+ * `heuristic`  — line patterns. Useful, but not a parse, and never presented
+ *                as one.
+ */
+type SummaryQuality = "ast" | "structural" | "heuristic";
 type SkipReason = "asset" | "binary" | "read-error" | "not-file" | "sensitive-file" | "symlink" | "default-ignore" | "excluded";
 interface SkipRecord {
     path: string;
@@ -64,6 +74,8 @@ interface FileEntry {
     /** UTF-8 bytes of file content actually emitted into the snapshot. */
     includedBytes: number;
     summary?: SourceSummary | JsonSummary | MarkdownSummary;
+    /** How the summary was produced. Absent when there is no summary. */
+    summaryQuality?: SummaryQuality;
     /** True when the summary alone was too large for the part budget and was dropped. */
     summaryOmitted?: boolean;
     /** Emitted body after redaction/truncation. Never serialized into the manifest. */
@@ -169,6 +181,7 @@ interface ManifestConfigSnapshot {
     includeSensitiveFiles: boolean;
     artifacts: ResolvedArtifacts;
     include: string[];
+    preset: string;
     layersMode: "merge" | "replace";
     budgets: ResolvedBudgets;
     excludePatterns: string[];
@@ -286,6 +299,8 @@ interface SnapshotConfig {
     includeSensitiveFiles?: boolean;
     /** Allow-list of globs. When non-empty, only matching files are included. */
     include?: string[];
+    /** Force a preset by name instead of auto-detecting one. */
+    preset?: string;
     /** Switch individual snapshot artifacts off. Everything is on by default. */
     artifacts?: ArtifactSelection;
     /**
@@ -319,6 +334,10 @@ interface ResolvedSnapshotConfig {
     includeSensitiveFiles: boolean;
     /** Empty means "no allow-list"; every discovered file is a candidate. */
     include: string[];
+    /** The preset that was resolved (detected or forced). */
+    preset: string;
+    /** Ecosystem ignores contributed by the preset, merged with `excludePatterns`. */
+    presetExclude: string[];
     artifacts: ResolvedArtifacts;
     layersMode: "merge" | "replace";
     budgets: ResolvedBudgets;
@@ -369,4 +388,4 @@ interface ValidationResult {
     warnings: string[];
 }
 
-export type { ArtifactSelection as A, ByteSize as B, CliOptions as C, FileEntry as F, HooksConfig as H, InclusionMode as I, JsonSummary as J, KindRule as K, LayerRule as L, MarkdownSummary as M, OutputFormat as O, PartMetadata as P, ResolvedSnapshotConfig as R, SourceSummary as S, ValidationResult as V, SnapshotConfig as a, SecretRule as b, SecretFinding as c, Manifest as d, SkipRecord as e, BudgetConfig as f, ManifestArtifact as g, ManifestConfigSnapshot as h, ManifestIndexes as i, ManifestTotals as j, Mode as k, PartFileEntry as l, ResolvedArtifacts as m, ResolvedBudgets as n, SecretRuleInput as o, SkipReason as p, ValidationDrift as q };
+export type { ArtifactSelection as A, ByteSize as B, CliOptions as C, FileEntry as F, HooksConfig as H, InclusionMode as I, JsonSummary as J, KindRule as K, LayerRule as L, MarkdownSummary as M, OutputFormat as O, PartMetadata as P, ResolvedSnapshotConfig as R, SourceSummary as S, ValidationResult as V, SnapshotConfig as a, SecretRule as b, SecretFinding as c, Manifest as d, SkipRecord as e, BudgetConfig as f, ManifestArtifact as g, ManifestConfigSnapshot as h, ManifestIndexes as i, ManifestTotals as j, Mode as k, PartFileEntry as l, ResolvedArtifacts as m, ResolvedBudgets as n, SecretRuleInput as o, SkipReason as p, SummaryQuality as q, ValidationDrift as r };

package/dist/{types-S-5eRuRc.d.ts → types-CJqkePM4.d.ts}

@@ -34,6 +34,16 @@ interface MarkdownSummary {
     headings: string[];
     frontmatterKeys: string[];
 }
+/**
+ * How a summary was produced.
+ *
+ * `ast`        — a real parser (TypeScript compiler; the script block of a
+ *                Vue/Svelte/Astro component).
+ * `structural` — a real grammar for a data format (JSON, Markdown).
+ * `heuristic`  — line patterns. Useful, but not a parse, and never presented
+ *                as one.
+ */
+type SummaryQuality = "ast" | "structural" | "heuristic";
 type SkipReason = "asset" | "binary" | "read-error" | "not-file" | "sensitive-file" | "symlink" | "default-ignore" | "excluded";
 interface SkipRecord {
     path: string;
@@ -64,6 +74,8 @@ interface FileEntry {
     /** UTF-8 bytes of file content actually emitted into the snapshot. */
     includedBytes: number;
     summary?: SourceSummary | JsonSummary | MarkdownSummary;
+    /** How the summary was produced. Absent when there is no summary. */
+    summaryQuality?: SummaryQuality;
     /** True when the summary alone was too large for the part budget and was dropped. */
     summaryOmitted?: boolean;
     /** Emitted body after redaction/truncation. Never serialized into the manifest. */
@@ -169,6 +181,7 @@ interface ManifestConfigSnapshot {
     includeSensitiveFiles: boolean;
     artifacts: ResolvedArtifacts;
     include: string[];
+    preset: string;
     layersMode: "merge" | "replace";
     budgets: ResolvedBudgets;
     excludePatterns: string[];
@@ -286,6 +299,8 @@ interface SnapshotConfig {
     includeSensitiveFiles?: boolean;
     /** Allow-list of globs. When non-empty, only matching files are included. */
     include?: string[];
+    /** Force a preset by name instead of auto-detecting one. */
+    preset?: string;
     /** Switch individual snapshot artifacts off. Everything is on by default. */
     artifacts?: ArtifactSelection;
     /**
@@ -319,6 +334,10 @@ interface ResolvedSnapshotConfig {
     includeSensitiveFiles: boolean;
     /** Empty means "no allow-list"; every discovered file is a candidate. */
     include: string[];
+    /** The preset that was resolved (detected or forced). */
+    preset: string;
+    /** Ecosystem ignores contributed by the preset, merged with `excludePatterns`. */
+    presetExclude: string[];
     artifacts: ResolvedArtifacts;
     layersMode: "merge" | "replace";
     budgets: ResolvedBudgets;
@@ -369,4 +388,4 @@ interface ValidationResult {
     warnings: string[];
 }
 
-export type { ArtifactSelection as A, ByteSize as B, CliOptions as C, FileEntry as F, HooksConfig as H, InclusionMode as I, JsonSummary as J, KindRule as K, LayerRule as L, MarkdownSummary as M, OutputFormat as O, PartMetadata as P, ResolvedSnapshotConfig as R, SourceSummary as S, ValidationResult as V, SnapshotConfig as a, SecretRule as b, SecretFinding as c, Manifest as d, SkipRecord as e, BudgetConfig as f, ManifestArtifact as g, ManifestConfigSnapshot as h, ManifestIndexes as i, ManifestTotals as j, Mode as k, PartFileEntry as l, ResolvedArtifacts as m, ResolvedBudgets as n, SecretRuleInput as o, SkipReason as p, ValidationDrift as q };
+export type { ArtifactSelection as A, ByteSize as B, CliOptions as C, FileEntry as F, HooksConfig as H, InclusionMode as I, JsonSummary as J, KindRule as K, LayerRule as L, MarkdownSummary as M, OutputFormat as O, PartMetadata as P, ResolvedSnapshotConfig as R, SourceSummary as S, ValidationResult as V, SnapshotConfig as a, SecretRule as b, SecretFinding as c, Manifest as d, SkipRecord as e, BudgetConfig as f, ManifestArtifact as g, ManifestConfigSnapshot as h, ManifestIndexes as i, ManifestTotals as j, Mode as k, PartFileEntry as l, ResolvedArtifacts as m, ResolvedBudgets as n, SecretRuleInput as o, SkipReason as p, SummaryQuality as q, ValidationDrift as r };