codebase-snapshot 0.9.9 → 0.9.14

package/dist/cli.js

@@ -1,5 +1,6 @@
-import { buildAgentContract, runStdioServer, COMMAND_OPTION_SCOPE, commandsForOption, SKILL_NAME, renderSkill, renderContractText } from './chunk-HQBEQ67K.js';
-import { shouldCheck, checkForUpdate, GENERATOR_VERSION, cacheFilePath, formatUpdateNotice, installKind, loadConfigFileDetailed, resolveConfig, validateSnapshot, describeManifestShapeProblem, explainPath, compareManifests, loadManifest, renderDiffText, generateSnapshot, formatNumber, isDiscoveryMode, ARTIFACT_NAMES, getPreset, unknownPresetMessage, GENERATOR_NAME, runInit, PromptCancelled, planFirstRun, isEffectivelyEmpty, isInteractive, defaultIO, hasPriorSnapshot, DEFAULT_ANSWERS, findConfigFile, firstRunMessage, parseByteSize, gitignorePath, appendGitignoreEntries, escapeControls, MIN_MAX_PART_BYTES, renderExplainText } from './chunk-KUVFTJHK.js';
+import { buildAgentContract, runStdioServer, COMMAND_OPTION_SCOPE, commandsForOption, SKILL_NAME, renderSkill, renderContractText } from './chunk-J4W74N4Y.js';
+export { buildAgentContract } from './chunk-J4W74N4Y.js';
+import { shouldCheck, checkForUpdate, GENERATOR_VERSION, cacheFilePath, formatUpdateNotice, installKind, loadConfigFileDetailed, resolveConfig, validateSnapshot, describeManifestShapeProblem, explainPath, compareManifests, loadManifest, renderDiffText, generateSnapshot, formatNumber, isDiscoveryMode, ARTIFACT_NAMES, getPreset, unknownPresetMessage, GENERATOR_NAME, runInit, installPreCommitHook, PromptCancelled, planFirstRun, isEffectivelyEmpty, isInteractive, defaultIO, hasPriorSnapshot, DEFAULT_ANSWERS, findConfigFile, firstRunMessage, parseByteSize, stripJsonComments, gitignorePath, appendGitignoreEntries, runWithStdoutCapture, escapeControls, MIN_MAX_PART_TOKENS, MIN_MAX_PART_BYTES, renderExplainText } from './chunk-DUZK5VL2.js';
 import { spawnSync } from 'child_process';
 import * as fs from 'fs';
 import * as path2 from 'path';
@@ -136,6 +137,7 @@ var CLI_OPTIONS = {
   watch: { type: "boolean" },
   "no-config": { type: "boolean" },
   discovery: { type: "string" },
+  "max-part-tokens": { type: "string" },
   preset: { type: "string" },
   include: { type: "string" },
   exclude: { type: "string" },
@@ -146,6 +148,12 @@ var CLI_OPTIONS = {
   "no-install": { type: "boolean" },
   target: { type: "string" },
   "no-update-check": { type: "boolean" },
+  "install-hook": { type: "boolean" },
+  "changed-since": { type: "string" },
+  "with-dependents": { type: "boolean" },
+  staged: { type: "boolean" },
+  skeleton: { type: "boolean" },
+  sarif: { type: "boolean" },
   help: { type: "boolean", short: "h" },
   version: { type: "boolean", short: "v" }
 };
@@ -185,7 +193,13 @@ Options:
   --max-monolith-bytes <n>      Skip monolith artefacts larger than n bytes
   --max-part-bytes <n>          Maximum byte budget per markdown part (default: 307200).
                                 Accepts units: 120k, 1.5mb
+  --max-part-tokens <n>         Per-part budget in tokens; narrows --max-part-bytes
   --large-file-bytes <n>        Threshold for head/tail truncation (default: 204800)
+  --changed-since <ref>         Only files changed since this git ref, plus untracked ones
+  --staged                      Only files staged for the next commit
+  --with-dependents             With the two above: also include their importers
+  --skeleton                    Emit TypeScript signatures instead of bodies
+  --sarif                       Also write reports/audit.sarif for GitHub Code Scanning
   --include-sensitive-files     Emit .env / *.pem / .npmrc / credential files
   --skip-artifacts <names>      Comma-separated artifacts to omit
                                 (readme, manifest, parts, navigation,
@@ -211,9 +225,12 @@ Options:
   --exclude <globs>             Comma-separated exclude patterns
   --yes                         Accept every default without prompting
   --force                       Overwrite an existing config
+  --install-hook                Write .git/hooks/pre-commit so a stale snapshot cannot be
+                                committed. An existing hook is never replaced.
 
   setup only:
   --no-install                  Skip installing the dependency before generating
+  --install-hook                As for init
   --preset / --include / --exclude / --force   As for init
 
   skill only:
@@ -241,12 +258,12 @@ function parsePositiveInteger(raw, optionName, minimum) {
   }
   return value;
 }
-function parseByteOption(raw, optionName, minimum) {
+function parseByteOption(raw, optionName, minimum, unit = "byte count") {
   if (raw === void 0) return void 0;
   const value = parseByteSize(raw);
   if (value === void 0 || !Number.isSafeInteger(value)) {
     throw new UsageError(
-      `--${optionName} expects a byte count such as 120000 or "120k", received "${raw}".`
+      `--${optionName} expects a ${unit} such as 120000 or "120k", received "${raw}".`
     );
   }
   if (value < minimum) {
@@ -402,8 +419,10 @@ function parseCliArgs(argv) {
     throw new UsageError("--skip-artifacts and --only-artifacts cannot be combined.");
   }
   let skipArtifacts;
+  let onlyArtifacts;
   if (rawOnly !== void 0) {
     const keep = parseArtifactList(String(rawOnly), "--only-artifacts");
+    onlyArtifacts = keep;
     onlyNamesMonolith = keep.includes("monolith");
     skipArtifacts = ARTIFACT_NAMES.filter(
       (name) => !keep.includes(name)
@@ -432,7 +451,7 @@ function parseCliArgs(argv) {
       `${ignored.join(", ")} ${ignored.length === 1 ? "does" : "do"} not apply to \`${command}\` and ${ignored.length === 1 ? "was" : "were"} not applied. ${ignored.length === 1 ? "It is" : "They are"} accepted by: ${owners.join(", ")}.${hint}`
     );
   }
-  if (command === "init" && values.preset !== void 0) {
+  if ((command === "init" || command === "setup") && values.preset !== void 0) {
     const requested = String(values.preset);
     if (!getPreset(requested)) throw new UsageError(unknownPresetMessage(requested));
   }
@@ -476,6 +495,15 @@ function parseCliArgs(argv) {
       "max-part-bytes",
       MIN_MAX_PART_BYTES
     ),
+    // Tokens are counted, so `32k` is a shorthand a context window is often named with; the
+    // same parser accepts a bare integer. The floor is the byte floor rewritten in tokens —
+    // clamping a smaller budget up to it accepted the flag and then applied a different number.
+    maxPartTokens: parseByteOption(
+      values["max-part-tokens"],
+      "max-part-tokens",
+      MIN_MAX_PART_TOKENS,
+      "token count"
+    ),
     largeFileBytes: parseByteOption(
       values["large-file-bytes"],
       "large-file-bytes",
@@ -487,7 +515,22 @@ function parseCliArgs(argv) {
       1
     ),
     skipArtifacts,
-    discovery: isDiscoveryMode(rawDiscovery) ? rawDiscovery : void 0
+    onlyArtifacts,
+    discovery: isDiscoveryMode(rawDiscovery) ? rawDiscovery : void 0,
+    noUpdateCheck: values["no-update-check"] === true,
+    installHook: values["install-hook"] === true,
+    changedSince: values["changed-since"] === void 0 ? void 0 : String(values["changed-since"]),
+    // `undefined` when the flag was not given, never `false`.
+    //
+    // `resolveConfig` reads these as `cliOptions.x ?? config.x`, so a `false` here is an
+    // *explicit override* — it beat `skeleton: true` in a `snapshot.config.ts` and turned the
+    // setting off without a word. Every run that did not pass the flag sent `false`, so a config
+    // file could not turn any of these four on at all, and a snapshot generated with `--skeleton`
+    // could never be validated against the config that describes it.
+    staged: values.staged === true ? true : void 0,
+    withDependents: values["with-dependents"] === true ? true : void 0,
+    skeleton: values.skeleton === true ? true : void 0,
+    sarif: values.sarif === true ? true : void 0
   };
 }
 var HelpRequested = class extends Error {
@@ -533,7 +576,9 @@ function nextStepHint(cwd, scriptsAddedNow) {
   let hasScript = scriptsAddedNow;
   if (!hasScript) {
     try {
-      const parsed = JSON.parse(fs.readFileSync(path2.join(cwd, "package.json"), "utf8"));
+      const parsed = JSON.parse(
+        stripJsonComments(fs.readFileSync(path2.join(cwd, "package.json"), "utf8"))
+      );
       hasScript = typeof parsed.scripts?.snapshot === "string";
     } catch {
       hasScript = false;
@@ -557,18 +602,24 @@ async function runInitCommand(invocation) {
       include: splitList(invocation.include),
       exclude: splitList(invocation.exclude),
       skipArtifacts: invocation.skipArtifacts,
+      onlyArtifacts: invocation.onlyArtifacts,
+      includeMonolith: invocation.includeMonolith,
       includeSensitiveFiles: invocation.includeSensitiveFiles,
       yes: invocation.yes,
       force: invocation.force,
       dryRun: invocation.dryRun
     });
+    const hook = invocation.installHook === true ? installPreCommitHook(invocation.cwd, result.outDir) : null;
     if (invocation.format === "json") {
-      process.stdout.write(`${JSON.stringify(result, null, 2)}
-`);
+      process.stdout.write(
+        `${JSON.stringify(hook === null ? result : { ...result, hook }, null, 2)}
+`
+      );
       return 0;
     }
     if (!result.written) {
       info(result.configText);
+      if (hook) for (const note of hook.notes) info(`   ${note}`);
       return 0;
     }
     info(`\u2705 Created ${path2.basename(result.configPath)} (${presetSummary(result)})`);
@@ -580,6 +631,7 @@ async function runInitCommand(invocation) {
       info(`   Added to .gitignore: ${result.gitignoreEntries.join(", ")}`);
     }
     for (const note of result.notes) info(`   \u26A0 ${note}`);
+    if (hook) for (const note of hook.notes) info(`   ${note}`);
     info("");
     info(`   Next:  ${nextStepHint(invocation.cwd, result.scripts.length > 0)}`);
     return 0;
@@ -628,18 +680,8 @@ function installDependencies(cwd) {
   return { manager: manager.name, command, ok: true, detail: seconds };
 }
 async function captureStdout(fn) {
-  const original = process.stdout.write.bind(process.stdout);
-  let text = "";
-  process.stdout.write = ((chunk) => {
-    text += typeof chunk === "string" ? chunk : Buffer.from(chunk).toString("utf8");
-    return true;
-  });
-  try {
-    const code = await fn();
-    return { code, text };
-  } finally {
-    process.stdout.write = original;
-  }
+  const { value, text } = await runWithStdoutCapture(fn);
+  return { code: value, text };
 }
 async function runSetupCommand(invocation, options = {}) {
   try {
@@ -649,15 +691,28 @@ async function runSetupCommand(invocation, options = {}) {
       preset: invocation.preset,
       outDir: invocation.outDir,
       maxPartBytes: invocation.maxPartBytesRaw ?? invocation.maxPartBytes,
+      // Written into the config, not just forwarded to the generation below. A setting that
+      // reaches the snapshot but not the file beside it is drift the very next run reports:
+      // `setup --discovery walk --large-file-bytes 100000` used to exit 0 and then fail its own
+      // `validate` with three configuration mismatches.
+      maxPartTokens: invocation.maxPartTokens,
+      largeFileBytes: invocation.largeFileBytes,
+      maxMonolithBytes: invocation.maxMonolithBytes ?? void 0,
+      discovery: invocation.discovery,
+      skeleton: invocation.skeleton === true ? true : void 0,
+      sarif: invocation.sarif === true ? true : void 0,
       include: splitList(invocation.include),
       exclude: splitList(invocation.exclude),
       skipArtifacts: invocation.skipArtifacts,
+      onlyArtifacts: invocation.onlyArtifacts,
+      includeMonolith: invocation.includeMonolith,
       includeSensitiveFiles: invocation.includeSensitiveFiles,
       yes: !interactive,
       force: invocation.force,
       reuseConfig: true,
       dryRun: invocation.dryRun
     });
+    const hook = invocation.installHook === true ? installPreCommitHook(invocation.cwd, init.outDir) : null;
     if (invocation.dryRun) {
       const manager = invocation.noInstall ? null : detectPackageManager(invocation.cwd).name;
       if (invocation.format === "json") {
@@ -703,6 +758,7 @@ async function runSetupCommand(invocation, options = {}) {
       if (init.gitignoreEntries.length > 0) {
         info(`   Added to .gitignore: ${init.gitignoreEntries.join(", ")}`);
       }
+      if (hook) for (const note of hook.notes) info(`   ${note}`);
     }
     let install = null;
     if (invocation.noInstall) {
@@ -723,33 +779,50 @@ async function runSetupCommand(invocation, options = {}) {
     if ((invocation.skipArtifacts ?? []).length > 0) {
       generateArgs.push("--skip-artifacts", (invocation.skipArtifacts ?? []).join(","));
     }
+    if (invocation.includeMonolith === true) generateArgs.push("--include-monolith");
+    if (invocation.discovery !== void 0) generateArgs.push("--discovery", invocation.discovery);
+    if (invocation.largeFileBytes !== void 0) {
+      generateArgs.push("--large-file-bytes", String(invocation.largeFileBytes));
+    }
+    if (invocation.maxMonolithBytes !== void 0 && invocation.maxMonolithBytes !== null) {
+      generateArgs.push("--max-monolith-bytes", String(invocation.maxMonolithBytes));
+    }
+    if (invocation.maxPartTokens !== void 0) {
+      generateArgs.push("--max-part-tokens", String(invocation.maxPartTokens));
+    }
+    if (invocation.skeleton === true) generateArgs.push("--skeleton");
+    if (invocation.sarif === true) generateArgs.push("--sarif");
+    if (invocation.noUpdateCheck) generateArgs.push("--no-update-check");
     if (invocation.watch) generateArgs.push("--watch");
     if (invocation.format === "json") {
       const generated = await captureStdout(() => main(generateArgs));
-      let manifest = null;
+      let parsed = null;
       try {
-        manifest = JSON.parse(generated.text);
+        parsed = JSON.parse(generated.text);
       } catch {
-        manifest = null;
+        parsed = null;
+      }
+      const setup = {
+        configPath: init.configPath,
+        configReused: init.reused,
+        preset: init.preset,
+        scripts: init.scripts,
+        dependency: init.dependency,
+        gitignoreEntries: init.gitignoreEntries,
+        install,
+        notes: init.notes,
+        hook
+      };
+      if (generated.code !== 0) {
+        const inner = parsed && typeof parsed.error === "object" && parsed.error !== null ? parsed.error : { message: "Snapshot generation failed during setup.", exitCode: generated.code };
+        process.stdout.write(
+          `${JSON.stringify({ error: inner, setup, manifest: null }, null, 2)}
+`
+        );
+        return generated.code;
       }
       process.stdout.write(
-        `${JSON.stringify(
-          {
-            setup: {
-              configPath: init.configPath,
-              configReused: init.reused,
-              preset: init.preset,
-              scripts: init.scripts,
-              dependency: init.dependency,
-              gitignoreEntries: init.gitignoreEntries,
-              install,
-              notes: init.notes
-            },
-            manifest
-          },
-          null,
-          2
-        )}
+        `${JSON.stringify({ setup, manifest: parsed }, null, 2)}
 `
       );
       return generated.code;
@@ -938,28 +1011,25 @@ ${USAGE}
       includeMonolith: invocation.includeMonolith,
       includeSensitiveFiles: invocation.includeSensitiveFiles,
       maxPartBytes: invocation.maxPartBytes,
+      maxPartTokens: invocation.maxPartTokens,
       largeFileBytes: invocation.largeFileBytes,
       maxMonolithBytes: invocation.maxMonolithBytes,
       skipArtifacts: invocation.skipArtifacts,
-      discovery: invocation.discovery
+      // `--only-artifacts` is forwarded as itself, not only as the derived suppression list:
+      // suppression cannot switch an artifact *on*, so a config that had turned one of the
+      // requested artifacts off left the run with nothing to write.
+      onlyArtifacts: invocation.onlyArtifacts,
+      discovery: invocation.discovery,
+      changedSince: invocation.changedSince,
+      staged: invocation.staged,
+      withDependents: invocation.withDependents,
+      skeleton: invocation.skeleton,
+      sarif: invocation.sarif
     },
     invocation.cwd
   );
   if (invocation.command === "validate") {
     const result = validateSnapshot(resolved);
-    if (result.valid) {
-      const manifestPath = path2.resolve(resolved.cwd, resolved.outDir, "manifest.json");
-      let manifest;
-      try {
-        manifest = JSON.parse(fs.readFileSync(manifestPath, "utf8"));
-      } catch {
-        manifest = void 0;
-      }
-      const shapeError = manifest === void 0 ? null : describeManifestShapeProblem(manifest);
-      if (shapeError) {
-        return fail(invocation.format, `${manifestPath} is not a snapshot manifest: ${shapeError}`);
-      }
-    }
     emit(invocation.format, result, () => renderValidateText(result));
     return result.valid ? 0 : 1;
   }
@@ -1017,6 +1087,10 @@ ${USAGE}
       return fail(invocation.format, err.message);
     }
   }
+  if (invocation.watch) {
+    const problem = watchSupportProblem();
+    if (problem !== null) return fail(invocation.format, problem);
+  }
   const started = performance.now();
   info(`\u{1F4F8} ${invocation.dryRun ? "Planning snapshot (dry run)" : "Generating snapshot"} for: ${resolved.cwd}`);
   info(
@@ -1057,7 +1131,11 @@ ${USAGE}
       const reports = [
         artifacts.projectTree && "project-tree",
         artifacts.navigation && "navigation",
-        artifacts.audit && "audit"
+        artifacts.audit && "audit",
+        // `--sarif` writes beside the audit rather than inside `artifacts`, so it is listed
+        // here by hand. Without it a run that produced `reports/audit.sarif` still reported
+        // that every artifact was disabled and only the ownership marker had been written.
+        resolved.sarif === true && "audit.sarif"
       ].filter(Boolean);
       if (reports.length > 0) {
         info(
@@ -1104,7 +1182,7 @@ ${USAGE}
 `);
     }
     if (invocation.watch) {
-      return await runWatchLoop(invocation, resolved);
+      return await runWatchLoop(invocation, resolved, { generatedAlready: true });
     }
     return manifest.validation.status === "passed" ? 0 : 1;
   } catch (err) {
@@ -1146,10 +1224,13 @@ function isGeneratedWatchPath(candidate, paths) {
   const outDir = comparablePath(path2.resolve(paths.cwd, paths.outDir));
   const tmpDir = comparablePath(path2.resolve(paths.cwd, paths.tmpDir));
   if (isSameOrInside(outDir, absolute) || isSameOrInside(tmpDir, absolute)) return true;
-  const parent = path2.dirname(absolute);
-  if (parent === path2.dirname(outDir) && path2.basename(absolute).startsWith(`${path2.basename(outDir)}.backup-`)) {
-    return true;
-  }
+  const offsets = [path2.basename(outDir), path2.basename(tmpDir)].filter((name) => name.length > 0);
+  const leftover = absolute.split(/[\\/]+/).some(
+    (segment) => offsets.some(
+      (name) => segment.startsWith(`${name}.backup-`) || segment.startsWith(`${name}.partial-`)
+    )
+  );
+  if (leftover) return true;
   return absolute.split(/[\\/]+/).some((segment) => VCS_SEGMENTS.has(segment));
 }
 function decideWatchEvent(state, event, paths) {
@@ -1163,10 +1244,22 @@ function decideWatchEvent(state, event, paths) {
   }
   return { state, action: "schedule" };
 }
-async function runWatchLoop(invocation, resolved) {
-  const outDir = path2.resolve(resolved.cwd, resolved.outDir);
-  const tmpDir = path2.resolve(resolved.cwd, resolved.tmpDir);
-  const paths = { cwd: resolved.cwd, outDir, tmpDir };
+function watchPathsFor(config) {
+  return {
+    cwd: config.cwd,
+    outDir: path2.resolve(config.cwd, config.outDir),
+    tmpDir: path2.resolve(config.cwd, config.tmpDir)
+  };
+}
+function watchSupportProblem(platform = process.platform, version = process.versions.node) {
+  if (platform !== "linux") return null;
+  const [major, minor] = version.split(".").map((part) => Number.parseInt(part, 10));
+  if (!Number.isFinite(major)) return null;
+  if (major > 20 || major === 20 && (minor ?? 0) >= 13) return null;
+  return `--watch needs recursive directory watching, which Node only provides on Linux from 20.13 (this is ${version}). Re-run \`generate\` after each change, or upgrade to Node 20.13 or later.`;
+}
+async function runWatchLoop(invocation, resolved, options) {
+  let paths = watchPathsFor(resolved);
   let state = initialWatchState();
   let timer = null;
   let stopped = false;
@@ -1208,14 +1301,22 @@ async function runWatchLoop(invocation, resolved) {
           includeMonolith: invocation.includeMonolith,
           includeSensitiveFiles: invocation.includeSensitiveFiles,
           maxPartBytes: invocation.maxPartBytes,
+          maxPartTokens: invocation.maxPartTokens,
           largeFileBytes: invocation.largeFileBytes,
           maxMonolithBytes: invocation.maxMonolithBytes,
           skipArtifacts: invocation.skipArtifacts,
-          discovery: invocation.discovery
+          onlyArtifacts: invocation.onlyArtifacts,
+          discovery: invocation.discovery,
+          changedSince: invocation.changedSince,
+          staged: invocation.staged,
+          withDependents: invocation.withDependents,
+          skeleton: invocation.skeleton,
+          sarif: invocation.sarif
         },
         invocation.cwd
       );
       const manifest = generateSnapshot(next, { dryRun: invocation.dryRun });
+      paths = watchPathsFor(next);
       const elapsed = ((performance.now() - started) / 1e3).toFixed(2);
       info(
         `\u267B\uFE0F  ${(/* @__PURE__ */ new Date()).toISOString()}  ${manifest.counts.totalFiles} file(s), ${manifest.counts.partsCount} part(s), ${manifest.validation.status} (${elapsed}s)`
@@ -1229,25 +1330,37 @@ async function runWatchLoop(invocation, resolved) {
     }
   };
   info("\u{1F440} Watching for changes. Press Ctrl+C to stop.");
-  void regenerate();
-  const watcher = fs.watch(resolved.cwd, { recursive: true }, (_event, filename) => {
-    const decision = decideWatchEvent(
-      state,
-      {
-        path: filename ? path2.resolve(resolved.cwd, filename.toString()) : null,
-        now: performance.now()
-      },
-      paths
-    );
-    state = decision.state;
-    if (decision.action === "pending") {
-      if (timer) {
-        clearTimeout(timer);
-        timer = null;
+  let watcher;
+  try {
+    watcher = fs.watch(resolved.cwd, { recursive: true }, (_event, filename) => {
+      const decision = decideWatchEvent(
+        state,
+        {
+          path: filename ? path2.resolve(resolved.cwd, filename.toString()) : null,
+          now: performance.now()
+        },
+        paths
+      );
+      state = decision.state;
+      if (decision.action === "pending") {
+        if (timer) {
+          clearTimeout(timer);
+          timer = null;
+        }
+        return;
       }
-      return;
-    }
-    if (decision.action === "schedule") schedule();
+      if (decision.action === "schedule") schedule();
+    });
+  } catch (err) {
+    const code = err.code;
+    const detail = code === "ENOSPC" ? "the operating system's file-watch limit is exhausted; raise it (`fs.inotify.max_user_watches` on Linux) or run `generate` by hand" : code === "ERR_FEATURE_UNAVAILABLE_ON_PLATFORM" ? watchSupportProblem() ?? "this platform has no recursive directory watching" : err.message;
+    warn(`\u274C Could not start watching ${resolved.cwd}: ${detail}`);
+    warn("   The snapshot that was just written is complete and valid.");
+    return 1;
+  }
+  watcher.on("error", (err) => {
+    info(`\u26A0 Watch error: ${err.message}`);
+    info("   The watcher may have missed changes. Restart with Ctrl+C if they stop arriving.");
   });
   await new Promise((resolve2) => {
     const stop = () => {
@@ -1277,6 +1390,4 @@ if (invokedDirectly) {
   );
 }
 
-export { UsageError, WATCH_DEBOUNCE_MS, WATCH_SETTLE_MS, beginWatchRun, cleanInstallEnv, decideWatchEvent, finishWatchRun, initialWatchState, isGeneratedWatchPath, main, parseByteOption, parseCliArgs, parsePositiveInteger };
-//# sourceMappingURL=cli.js.map
-//# sourceMappingURL=cli.js.map
+export { CLI_OPTIONS, UsageError, WATCH_DEBOUNCE_MS, WATCH_SETTLE_MS, beginWatchRun, cleanInstallEnv, decideWatchEvent, finishWatchRun, initialWatchState, isGeneratedWatchPath, main, parseByteOption, parseCliArgs, parsePositiveInteger, watchPathsFor, watchSupportProblem };

package/dist/generate-worker-D_mUjgXw.d.cts

@@ -0,0 +1,73 @@
+/** The options `resolveConfig` was called with, as the CLI would have passed them. */
+interface WorkspaceCliOptions {
+    cwd: string;
+    maxPartBytes?: number;
+    maxPartTokens?: number;
+    outDir?: string;
+    /**
+     * `true` or absent, never `false`.
+     *
+     * `resolveConfig` reads these as `cliOptions.x ?? config.x`, so a `false` here is an *explicit
+     * override* that beats `skeleton: true` in the project's configuration — the same trap the CLI
+     * documents. Absent means "whatever the configuration says".
+     */
+    skeleton?: true;
+    sarif?: true;
+    staged?: true;
+    withDependents?: true;
+    changedSince?: string;
+}
+
+/** What the caller needs from a finished run; the whole manifest can be megabytes. */
+interface GenerateSummary {
+    fingerprint: string;
+    totalFiles: number;
+    skippedCount: number;
+    partsCount: number;
+    parts: Array<{
+        filename: string;
+        byteSize: number;
+    }>;
+    totalContentBytes: number;
+    warnings: string[];
+}
+type WorkerResults = {
+    ok: true;
+    summary: GenerateSummary;
+} | {
+    ok: false;
+    message: string;
+};
+/**
+ * The absolute path of the package entry this process is running from.
+ *
+ * `__dirname` exists in the CJS build and `import.meta.url` in the ESM one, and `typeof` on an
+ * undeclared identifier does not throw — so this resolves correctly in both without a build-time
+ * substitution.
+ */
+/**
+ * Where the worker finds this package's entry: the path, and the URL the worker imports.
+ *
+ * Exported so the URL can be tested directly. The defect it fixes only shows up for an install
+ * path that contains a `#`, `?` or `%`, or on a Windows drive letter, and no test can move the
+ * package's own `dist/` to such a path.
+ *
+ * `pathToFileURL` rather than `` `file://${path}` ``: the interpolation form turns a Windows path
+ * into `file://C:/…`, whose **host** is the drive letter, reads a `#` as a fragment and a `?` as
+ * a query, and leaves a space unescaped. `config.ts` already carries this note for the same
+ * reason.
+ */
+declare function workerEntry(directory: string, isCjs: boolean): {
+    path: string;
+    url: string;
+};
+/**
+ * Generates in a worker and resolves with the summary.
+ *
+ * A worker that fails to start, exits without posting, or throws at the module level is reported
+ * as a tool failure naming the reason — never silently retried on the calling thread, because a
+ * quiet fallback would hide exactly the condition this exists to avoid.
+ */
+declare function generateInWorker(cwd: string, cliOptions: WorkspaceCliOptions): Promise<WorkerResults>;
+
+export { type GenerateSummary as G, type WorkerResults as W, generateInWorker as g, workerEntry as w };

package/dist/generate-worker-D_mUjgXw.d.ts

@@ -0,0 +1,73 @@
+/** The options `resolveConfig` was called with, as the CLI would have passed them. */
+interface WorkspaceCliOptions {
+    cwd: string;
+    maxPartBytes?: number;
+    maxPartTokens?: number;
+    outDir?: string;
+    /**
+     * `true` or absent, never `false`.
+     *
+     * `resolveConfig` reads these as `cliOptions.x ?? config.x`, so a `false` here is an *explicit
+     * override* that beats `skeleton: true` in the project's configuration — the same trap the CLI
+     * documents. Absent means "whatever the configuration says".
+     */
+    skeleton?: true;
+    sarif?: true;
+    staged?: true;
+    withDependents?: true;
+    changedSince?: string;
+}
+
+/** What the caller needs from a finished run; the whole manifest can be megabytes. */
+interface GenerateSummary {
+    fingerprint: string;
+    totalFiles: number;
+    skippedCount: number;
+    partsCount: number;
+    parts: Array<{
+        filename: string;
+        byteSize: number;
+    }>;
+    totalContentBytes: number;
+    warnings: string[];
+}
+type WorkerResults = {
+    ok: true;
+    summary: GenerateSummary;
+} | {
+    ok: false;
+    message: string;
+};
+/**
+ * The absolute path of the package entry this process is running from.
+ *
+ * `__dirname` exists in the CJS build and `import.meta.url` in the ESM one, and `typeof` on an
+ * undeclared identifier does not throw — so this resolves correctly in both without a build-time
+ * substitution.
+ */
+/**
+ * Where the worker finds this package's entry: the path, and the URL the worker imports.
+ *
+ * Exported so the URL can be tested directly. The defect it fixes only shows up for an install
+ * path that contains a `#`, `?` or `%`, or on a Windows drive letter, and no test can move the
+ * package's own `dist/` to such a path.
+ *
+ * `pathToFileURL` rather than `` `file://${path}` ``: the interpolation form turns a Windows path
+ * into `file://C:/…`, whose **host** is the drive letter, reads a `#` as a fragment and a `?` as
+ * a query, and leaves a space unescaped. `config.ts` already carries this note for the same
+ * reason.
+ */
+declare function workerEntry(directory: string, isCjs: boolean): {
+    path: string;
+    url: string;
+};
+/**
+ * Generates in a worker and resolves with the summary.
+ *
+ * A worker that fails to start, exits without posting, or throws at the module level is reported
+ * as a tool failure naming the reason — never silently retried on the calling thread, because a
+ * quiet fallback would hide exactly the condition this exists to avoid.
+ */
+declare function generateInWorker(cwd: string, cliOptions: WorkspaceCliOptions): Promise<WorkerResults>;
+
+export { type GenerateSummary as G, type WorkerResults as W, generateInWorker as g, workerEntry as w };