@ankurhalder/codebase-snapshot 4.0.7 → 4.1.0

package/dist/cli.d.cts

@@ -1,4 +1,4 @@
-import { O as OutputFormat } from './types-x7aogSer.cjs';
+import { O as OutputFormat, D as DiscoveryMode } from './types-BMP676ER.cjs';
 
 type Command = "generate" | "validate" | "report" | "init" | "explain" | "diff" | "describe" | "skill";
 /** A user-input problem: printed without a stack trace, exits 2. */
@@ -33,6 +33,8 @@ interface ParsedInvocation {
     largeFileBytes?: number;
     maxMonolithBytes?: number | null;
     skipArtifacts?: string[];
+    /** How candidates are discovered; `auto` when unset. */
+    discovery?: DiscoveryMode;
 }
 declare function parsePositiveInteger(raw: string | undefined, optionName: string, minimum: number): number | undefined;
 /**
@@ -50,5 +52,61 @@ declare function parseByteOption(raw: string | undefined, optionName: string, mi
 declare function parseCliArgs(argv: string[]): ParsedInvocation;
 /** Runs the CLI and returns the process exit code. */
 declare function main(argv?: string[]): Promise<number>;
+/** Coalesce bursts of filesystem events into one run. */
+declare const WATCH_DEBOUNCE_MS = 250;
+/**
+ * Unattributed watcher events (no filename) are ignored this long after a run.
+ * Named source events are never ignored: that is how an edit in the quiet
+ * window or during a run reaches the loop.
+ */
+declare const WATCH_SETTLE_MS = 1500;
+interface WatchState {
+    running: boolean;
+    pending: boolean;
+    settleUntil: number;
+}
+interface WatchPaths {
+    cwd: string;
+    outDir: string;
+    tmpDir: string;
+}
+interface WatchEvent {
+    /** Absolute path, or null when `fs.watch` did not attribute the event. */
+    path: string | null;
+    /** `performance.now()` at delivery. */
+    now: number;
+}
+type WatchAction = "ignore" | "pending" | "schedule";
+interface WatchDecision {
+    state: WatchState;
+    action: WatchAction;
+}
+declare function initialWatchState(): WatchState;
+declare function beginWatchRun(state: WatchState): WatchState;
+/**
+ * Finish one run. `schedule` is true when a source event arrived while the run
+ * was in flight, so exactly one follow-up run is owed.
+ */
+declare function finishWatchRun(state: WatchState, now: number): {
+    state: WatchState;
+    schedule: boolean;
+};
+/**
+ * True only for the resolved output/staging paths and their contents.
+ *
+ * This deliberately does not match a directory just because its basename is
+ * `docs`: a source directory `src/docs` is not the output directory `docs`.
+ */
+declare function isGeneratedWatchPath(candidate: string, paths: WatchPaths): boolean;
+/**
+ * Decide what one watcher event means.
+ *
+ * - generated paths are always ignored;
+ * - a named source event is `pending` during a run and `schedule` otherwise,
+ *   including inside the settle window (an edit is never swallowed);
+ * - an unattributed event is ignored during a run and for the settle window,
+ *   because Windows does not always name the path our own writes produced.
+ */
+declare function decideWatchEvent(state: WatchState, event: WatchEvent, paths: WatchPaths): WatchDecision;
 
-export { UsageError, main, parseByteOption, parseCliArgs, parsePositiveInteger };
+export { UsageError, WATCH_DEBOUNCE_MS, WATCH_SETTLE_MS, type WatchAction, type WatchDecision, type WatchEvent, type WatchPaths, type WatchState, beginWatchRun, decideWatchEvent, finishWatchRun, initialWatchState, isGeneratedWatchPath, main, parseByteOption, parseCliArgs, parsePositiveInteger };

package/dist/cli.d.ts

@@ -1,4 +1,4 @@
-import { O as OutputFormat } from './types-x7aogSer.js';
+import { O as OutputFormat, D as DiscoveryMode } from './types-BMP676ER.js';
 
 type Command = "generate" | "validate" | "report" | "init" | "explain" | "diff" | "describe" | "skill";
 /** A user-input problem: printed without a stack trace, exits 2. */
@@ -33,6 +33,8 @@ interface ParsedInvocation {
     largeFileBytes?: number;
     maxMonolithBytes?: number | null;
     skipArtifacts?: string[];
+    /** How candidates are discovered; `auto` when unset. */
+    discovery?: DiscoveryMode;
 }
 declare function parsePositiveInteger(raw: string | undefined, optionName: string, minimum: number): number | undefined;
 /**
@@ -50,5 +52,61 @@ declare function parseByteOption(raw: string | undefined, optionName: string, mi
 declare function parseCliArgs(argv: string[]): ParsedInvocation;
 /** Runs the CLI and returns the process exit code. */
 declare function main(argv?: string[]): Promise<number>;
+/** Coalesce bursts of filesystem events into one run. */
+declare const WATCH_DEBOUNCE_MS = 250;
+/**
+ * Unattributed watcher events (no filename) are ignored this long after a run.
+ * Named source events are never ignored: that is how an edit in the quiet
+ * window or during a run reaches the loop.
+ */
+declare const WATCH_SETTLE_MS = 1500;
+interface WatchState {
+    running: boolean;
+    pending: boolean;
+    settleUntil: number;
+}
+interface WatchPaths {
+    cwd: string;
+    outDir: string;
+    tmpDir: string;
+}
+interface WatchEvent {
+    /** Absolute path, or null when `fs.watch` did not attribute the event. */
+    path: string | null;
+    /** `performance.now()` at delivery. */
+    now: number;
+}
+type WatchAction = "ignore" | "pending" | "schedule";
+interface WatchDecision {
+    state: WatchState;
+    action: WatchAction;
+}
+declare function initialWatchState(): WatchState;
+declare function beginWatchRun(state: WatchState): WatchState;
+/**
+ * Finish one run. `schedule` is true when a source event arrived while the run
+ * was in flight, so exactly one follow-up run is owed.
+ */
+declare function finishWatchRun(state: WatchState, now: number): {
+    state: WatchState;
+    schedule: boolean;
+};
+/**
+ * True only for the resolved output/staging paths and their contents.
+ *
+ * This deliberately does not match a directory just because its basename is
+ * `docs`: a source directory `src/docs` is not the output directory `docs`.
+ */
+declare function isGeneratedWatchPath(candidate: string, paths: WatchPaths): boolean;
+/**
+ * Decide what one watcher event means.
+ *
+ * - generated paths are always ignored;
+ * - a named source event is `pending` during a run and `schedule` otherwise,
+ *   including inside the settle window (an edit is never swallowed);
+ * - an unattributed event is ignored during a run and for the settle window,
+ *   because Windows does not always name the path our own writes produced.
+ */
+declare function decideWatchEvent(state: WatchState, event: WatchEvent, paths: WatchPaths): WatchDecision;
 
-export { UsageError, main, parseByteOption, parseCliArgs, parsePositiveInteger };
+export { UsageError, WATCH_DEBOUNCE_MS, WATCH_SETTLE_MS, type WatchAction, type WatchDecision, type WatchEvent, type WatchPaths, type WatchState, beginWatchRun, decideWatchEvent, finishWatchRun, initialWatchState, isGeneratedWatchPath, main, parseByteOption, parseCliArgs, parsePositiveInteger };