codebase-snapshot 0.9.8 → 0.9.12

package/dist/cli.js

@@ -1,5 +1,6 @@
-import { buildAgentContract, runStdioServer, COMMAND_OPTION_SCOPE, commandsForOption, SKILL_NAME, renderSkill, renderContractText } from './chunk-RQKXZOD7.js';
-import { shouldCheck, checkForUpdate, GENERATOR_VERSION, cacheFilePath, formatUpdateNotice, 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-C24OAT6T.js';
+import { buildAgentContract, runStdioServer, COMMAND_OPTION_SCOPE, commandsForOption, SKILL_NAME, renderSkill, renderContractText } from './chunk-5OR3WVPW.js';
+export { buildAgentContract } from './chunk-5OR3WVPW.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, gitignorePath, appendGitignoreEntries, escapeControls, MIN_MAX_PART_TOKENS, MIN_MAX_PART_BYTES, renderExplainText } from './chunk-3H45YMBG.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) {
@@ -269,7 +286,27 @@ function parseArtifactList(raw, flag) {
   }
   return names;
 }
+var SHORT_FLAGS = new Set(
+  Object.values(CLI_OPTIONS).map((spec) => spec.short).filter((short) => typeof short === "string").map((short) => `-${short}`)
+);
+function misdashedLongOption(argv) {
+  for (const token of argv) {
+    if (token === "--") break;
+    if (!/^-[A-Za-z][A-Za-z0-9-]+$/.test(token)) continue;
+    if ([...token.slice(1)].every((character) => SHORT_FLAGS.has(`-${character}`))) continue;
+    return token;
+  }
+  return null;
+}
 function parseCliArgs(argv) {
+  const misdashed = misdashedLongOption(argv);
+  if (misdashed !== null) {
+    const long = `--${misdashed.slice(1)}`;
+    const known = Object.prototype.hasOwnProperty.call(CLI_OPTIONS, misdashed.slice(1));
+    throw new UsageError(
+      known ? `Unknown option '${misdashed}'. Options start with two dashes \u2014 did you mean '${long}'?` : `Unknown option '${misdashed}'. Options start with two dashes; if '${misdashed}' is a path or an argument, put it after '--'.`
+    );
+  }
   let parsed;
   try {
     parsed = parseArgs({
@@ -382,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)
@@ -412,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));
   }
@@ -456,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",
@@ -467,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 {
@@ -537,18 +600,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)})`);
@@ -560,6 +629,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;
@@ -629,15 +699,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") {
@@ -683,6 +766,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) {
@@ -703,6 +787,20 @@ 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));
@@ -723,7 +821,8 @@ async function runSetupCommand(invocation, options = {}) {
               dependency: init.dependency,
               gitignoreEntries: init.gitignoreEntries,
               install,
-              notes: init.notes
+              notes: init.notes,
+              hook
             },
             manifest
           },
@@ -851,7 +950,7 @@ async function main(argv = process.argv.slice(2)) {
   if (pending) {
     const notice = await pending;
     if (notice) process.stderr.write(`
-${formatUpdateNotice(notice)}
+${formatUpdateNotice(notice, installKind())}
 `);
   }
   return code;
@@ -918,10 +1017,16 @@ ${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
+      discovery: invocation.discovery,
+      changedSince: invocation.changedSince,
+      staged: invocation.staged,
+      withDependents: invocation.withDependents,
+      skeleton: invocation.skeleton,
+      sarif: invocation.sarif
     },
     invocation.cwd
   );
@@ -997,6 +1102,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(
@@ -1037,7 +1146,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(
@@ -1084,7 +1197,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) {
@@ -1143,10 +1256,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;
@@ -1188,14 +1313,21 @@ 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
+          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)`
@@ -1209,25 +1341,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 = () => {
@@ -1257,6 +1401,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-D5Xgh27c.d.cts

@@ -0,0 +1,57 @@
+/** 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: {
+    cwd: string;
+    maxPartBytes?: number;
+    outDir?: string;
+}): Promise<WorkerResults>;
+
+export { type GenerateSummary as G, type WorkerResults as W, generateInWorker as g, workerEntry as w };

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

@@ -0,0 +1,57 @@
+/** 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: {
+    cwd: string;
+    maxPartBytes?: number;
+    outDir?: string;
+}): Promise<WorkerResults>;
+
+export { type GenerateSummary as G, type WorkerResults as W, generateInWorker as g, workerEntry as w };