claudekit-cli 3.38.0-dev.4 → 3.38.0-dev.6

package/dist/index.js

@@ -12214,18 +12214,6 @@ function isUnknownChecksum(checksum) {
 var UNKNOWN_CHECKSUM = "unknown";
 
 // src/commands/portable/portable-registry.ts
-var exports_portable_registry = {};
-__export(exports_portable_registry, {
-  writePortableRegistry: () => writePortableRegistry,
-  updateAppliedManifestVersion: () => updateAppliedManifestVersion,
-  syncPortableRegistry: () => syncPortableRegistry,
-  removePortableInstallation: () => removePortableInstallation,
-  removeInstallationsByFilter: () => removeInstallationsByFilter,
-  readPortableRegistry: () => readPortableRegistry,
-  getInstallationsByType: () => getInstallationsByType,
-  findPortableInstallations: () => findPortableInstallations,
-  addPortableInstallation: () => addPortableInstallation
-});
 import { existsSync as existsSync2 } from "node:fs";
 import { mkdir, readFile as readFile2, rename, unlink, writeFile } from "node:fs/promises";
 import { homedir as homedir3 } from "node:os";
@@ -12485,9 +12473,6 @@ function findPortableInstallations(registry, item, type, provider, global2) {
     return true;
   });
 }
-function getInstallationsByType(registry, type) {
-  return registry.installations.filter((i) => i.type === type);
-}
 async function updateAppliedManifestVersion(version) {
   await withRegistryLock(async () => {
     const registry = await readPortableRegistry();
@@ -42046,6 +42031,7 @@ var init_commands = __esm(() => {
     only: exports_external.array(ExcludePatternSchema).optional().default([]),
     global: exports_external.boolean().default(false),
     fresh: exports_external.boolean().default(false),
+    force: exports_external.boolean().default(false),
     installSkills: exports_external.boolean().default(false),
     withSudo: exports_external.boolean().default(false),
     prefix: exports_external.boolean().default(false),
@@ -42432,7 +42418,7 @@ var init_ck_config = __esm(() => {
   }).passthrough();
   UpdatePipelineSchema = exports_external.object({
     autoInitAfterUpdate: exports_external.boolean().default(false),
-    autoMigrateAfterInit: exports_external.boolean().default(false),
+    autoMigrateAfterUpdate: exports_external.boolean().default(false),
     migrateProviders: exports_external.union([exports_external.literal("auto"), exports_external.array(exports_external.string())]).default("auto")
   });
   ResolvedModelConfigSchema = exports_external.object({
@@ -42543,7 +42529,7 @@ var init_ck_config = __esm(() => {
     },
     updatePipeline: {
       autoInitAfterUpdate: false,
-      autoMigrateAfterInit: false,
+      autoMigrateAfterUpdate: false,
       migrateProviders: "auto"
     }
   };
@@ -48551,17 +48537,17 @@ var init_ck_config_schema = __esm(() => {
       },
       updatePipeline: {
         type: "object",
-        description: "Auto-chaining behavior for update -> init -> migrate pipeline",
+        description: "3-step update pipeline: CLI update -> kit init -> provider migrate (each independent)",
         properties: {
           autoInitAfterUpdate: {
             type: "boolean",
             default: false,
             description: "Automatically run ck init after ck update when kit has new version"
           },
-          autoMigrateAfterInit: {
+          autoMigrateAfterUpdate: {
             type: "boolean",
             default: false,
-            description: "Automatically run ck migrate after ck init for detected providers"
+            description: "Automatically run ck migrate after ck update for detected providers (independent of init)"
           },
           migrateProviders: {
             oneOf: [
@@ -57258,7 +57244,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "claudekit-cli",
-    version: "3.38.0-dev.4",
+    version: "3.38.0-dev.6",
     description: "CLI tool for bootstrapping and updating ClaudeKit projects",
     type: "module",
     repository: {
@@ -58553,7 +58539,8 @@ function getDefaultUpdateCliCommandDeps() {
     execAsyncFn: execAsync2,
     packageManagerDetector: PackageManagerDetector,
     npmRegistryClient: NpmRegistryClient,
-    promptKitUpdateFn: promptKitUpdate
+    promptKitUpdateFn: promptKitUpdate,
+    promptMigrateUpdateFn: promptMigrateUpdate
   };
 }
 function extractCommandStdout(result) {
@@ -58678,14 +58665,14 @@ async function promptKitUpdate(beta, yes, deps) {
     if (selection.kit && kitVersion) {
       logger.info(`Current kit version: ${selection.kit}@${kitVersion}`);
     }
+    let alreadyAtLatest = false;
     if (yes && selection.kit && kitVersion) {
       const getTagFn = deps?.getLatestReleaseTagFn ?? fetchLatestReleaseTag;
       const latestTag = await getTagFn(selection.kit, beta || isBetaInstalled);
       if (latestTag && versionsMatch(kitVersion, latestTag)) {
         logger.success(`Already at latest version (${selection.kit}@${kitVersion}), skipping reinstall`);
-        return;
-      }
-      if (latestTag) {
+        alreadyAtLatest = true;
+      } else if (latestTag) {
         logger.info(`Kit update available: ${kitVersion} -> ${latestTag}`);
       }
     }
@@ -58694,6 +58681,9 @@ async function promptKitUpdate(beta, yes, deps) {
       const ckConfig = await loadFullConfigFn(null);
       autoInit = ckConfig.config.updatePipeline?.autoInitAfterUpdate ?? false;
     } catch {}
+    if (alreadyAtLatest && !autoInit) {
+      return;
+    }
     if (!yes && !autoInit) {
       logger.info("");
       const shouldUpdate = await confirmFn({
@@ -58742,6 +58732,77 @@ async function promptKitUpdate(beta, yes, deps) {
     logger.verbose(`Failed to prompt for kit update: ${error instanceof Error ? error.message : "unknown error"}`);
   }
 }
+async function promptMigrateUpdate(deps) {
+  try {
+    const providerRegistry = deps?.detectInstalledProvidersFn && deps?.getProviderConfigFn ? null : await Promise.resolve().then(() => (init_provider_registry(), exports_provider_registry));
+    const detectFn = deps?.detectInstalledProvidersFn ?? providerRegistry?.detectInstalledProviders;
+    const getConfigFn = deps?.getProviderConfigFn ?? providerRegistry?.getProviderConfig;
+    const getSetupFn = deps?.getSetupFn ?? getClaudeKitSetup;
+    const loadFullConfigFn = deps?.loadFullConfigFn ?? CkConfigManager.loadFull;
+    const execFn = deps?.execAsyncFn ?? execAsync2;
+    if (!detectFn || !getConfigFn)
+      return;
+    const allProviders = await detectFn();
+    const targets = allProviders.filter((p) => p !== "claude-code");
+    if (targets.length === 0) {
+      logger.verbose("No migration targets detected, skipping migrate step");
+      return;
+    }
+    let autoMigrate = false;
+    let migrateProviders = "auto";
+    try {
+      const ckConfig = await loadFullConfigFn(null);
+      const pipeline = ckConfig.config.updatePipeline;
+      autoMigrate = pipeline?.autoMigrateAfterUpdate ?? false;
+      migrateProviders = pipeline?.migrateProviders ?? "auto";
+    } catch {}
+    if (!autoMigrate)
+      return;
+    let providers2;
+    if (migrateProviders === "auto") {
+      providers2 = targets;
+    } else if (Array.isArray(migrateProviders)) {
+      const invalid = migrateProviders.filter((p) => !targets.includes(p));
+      if (invalid.length > 0) {
+        logger.warning(`Unknown/uninstalled providers in migrateProviders: ${invalid.join(", ")}`);
+      }
+      providers2 = migrateProviders.filter((p) => targets.includes(p));
+    } else {
+      return;
+    }
+    if (providers2.length === 0)
+      return;
+    const safeProviders = providers2.filter((p) => SAFE_PROVIDER_NAME.test(p));
+    if (safeProviders.length !== providers2.length) {
+      logger.warning("Some provider names contain invalid characters and were skipped");
+    }
+    if (safeProviders.length === 0)
+      return;
+    let isGlobal = false;
+    try {
+      const setup = await getSetupFn();
+      isGlobal = !!setup.global.metadata && !setup.project.metadata;
+    } catch {}
+    const providerNames = safeProviders.map((p) => getConfigFn(p).displayName).join(", ");
+    const parts = ["ck", "migrate"];
+    if (isGlobal)
+      parts.push("-g");
+    for (const p of safeProviders) {
+      parts.push("--agent", p);
+    }
+    parts.push("--yes");
+    const cmd = parts.join(" ");
+    logger.info(`Auto-migrating to: ${providerNames}`);
+    try {
+      await execFn(cmd, { timeout: 300000 });
+      logger.success("Auto-migration complete");
+    } catch (error) {
+      logger.warning(`Auto-migration failed: ${error instanceof Error ? error.message : "unknown"}. Run \`ck migrate\` manually to retry.`);
+    }
+  } catch (error) {
+    logger.verbose(`Migrate step skipped: ${error instanceof Error ? error.message : "unknown"}`);
+  }
+}
 async function updateCliCommand(options2, deps = getDefaultUpdateCliCommandDeps()) {
   const s = de();
   intro("[>] ClaudeKit CLI - Update");
@@ -58751,7 +58812,8 @@ async function updateCliCommand(options2, deps = getDefaultUpdateCliCommandDeps(
       execAsyncFn,
       packageManagerDetector,
       npmRegistryClient,
-      promptKitUpdateFn
+      promptKitUpdateFn,
+      promptMigrateUpdateFn
     } = deps;
     const opts = UpdateCliOptionsSchema.parse(options2);
     logger.info(`Current CLI version: ${currentVersion}`);
@@ -58812,12 +58874,14 @@ async function updateCliCommand(options2, deps = getDefaultUpdateCliCommandDeps(
     if (comparison === 0) {
       outro(`[+] Already on the latest CLI version (${currentVersion})`);
       await promptKitUpdateFn(targetIsPrerelease, opts.yes);
+      await promptMigrateUpdateFn();
       return;
     }
     const isDevChannelSwitch = (opts.dev || opts.beta) && isBetaVersion(targetVersion) && !isBetaVersion(currentVersion);
     if (comparison > 0 && !opts.release && !isDevChannelSwitch) {
       outro(`[+] Current version (${currentVersion}) is newer than latest (${targetVersion})`);
       await promptKitUpdateFn(targetIsPrerelease, opts.yes);
+      await promptMigrateUpdateFn();
       return;
     }
     const isUpgrade = comparison < 0 || isDevChannelSwitch;
@@ -58828,6 +58892,7 @@ async function updateCliCommand(options2, deps = getDefaultUpdateCliCommandDeps(
 
 Run 'ck update' to install`, "Update Check");
       await promptKitUpdateFn(targetIsPrerelease, opts.yes);
+      await promptMigrateUpdateFn();
       outro("Check complete");
       return;
     }
@@ -58894,6 +58959,7 @@ Run '${redactCommandForLog(updateCmd)}' manually, restart terminal, then check c
       }
       outro(`[+] Successfully updated ClaudeKit CLI to ${activeVersion}`);
       await promptKitUpdateFn(targetIsPrerelease, opts.yes);
+      await promptMigrateUpdateFn();
     } catch (error) {
       if (error instanceof CliUpdateError) {
         throw error;
@@ -58915,7 +58981,7 @@ Manual update: ${redactCommandForLog(updateCmd)}`;
     throw new CliUpdateError(errorMessage);
   }
 }
-var import_compare_versions3, import_fs_extra5, execAsync2, CliUpdateError;
+var import_compare_versions3, import_fs_extra5, execAsync2, CliUpdateError, SAFE_PROVIDER_NAME;
 var init_update_cli = __esm(() => {
   init_ck_config_manager();
   init_npm_registry();
@@ -58938,6 +59004,7 @@ var init_update_cli = __esm(() => {
       this.name = "CliUpdateError";
     }
   };
+  SAFE_PROVIDER_NAME = /^[a-z0-9-]+$/;
 });
 
 // src/domains/versioning/version-cache.ts
@@ -70762,6 +70829,10 @@ var init_init_command_help = __esm(() => {
           {
             flags: "--fresh",
             description: "Full reset: remove CK files, replace settings.json and CLAUDE.md, reinstall from scratch"
+          },
+          {
+            flags: "--force",
+            description: "Force reinstall even if already at latest version (use with --yes; re-onboards missing files without full reset)"
           }
         ]
       },
@@ -96046,6 +96117,7 @@ async function resolveOptions(ctx) {
     global: parsed.global ?? false,
     yes: parsed.yes ?? false,
     fresh: parsed.fresh ?? false,
+    force: parsed.force ?? false,
     refresh: parsed.refresh ?? false,
     exclude: parsed.exclude ?? [],
     only: parsed.only ?? [],
@@ -96115,116 +96187,6 @@ import { join as join109 } from "node:path";
 init_logger();
 init_path_resolver();
 var import_fs_extra30 = __toESM(require_lib3(), 1);
-
-// src/commands/init/phases/post-init-migrate-nudge.ts
-init_ck_config_manager();
-init_logger();
-init_safe_prompts();
-import { exec as exec8 } from "node:child_process";
-import { promisify as promisify14 } from "node:util";
-var execAsync8 = promisify14(exec8);
-var SAFE_PROVIDER_NAME = /^[a-z0-9-]+$/;
-async function maybePostInitMigrate(ctx, deps) {
-  if (ctx.cancelled || !ctx.resolvedDir)
-    return;
-  try {
-    const providerRegistry = deps?.detectInstalledProvidersFn && deps?.getProviderConfigFn ? null : await Promise.resolve().then(() => (init_provider_registry(), exports_provider_registry));
-    const portableRegistry = deps?.readPortableRegistryFn ? null : await Promise.resolve().then(() => (init_portable_registry(), exports_portable_registry));
-    const detectInstalledProvidersFn = deps?.detectInstalledProvidersFn ?? providerRegistry?.detectInstalledProviders;
-    const getProviderConfigFn = deps?.getProviderConfigFn ?? providerRegistry?.getProviderConfig;
-    const readPortableRegistryFn = deps?.readPortableRegistryFn ?? portableRegistry?.readPortableRegistry;
-    const loadFullConfigFn = deps?.loadFullConfigFn ?? CkConfigManager.loadFull;
-    if (!detectInstalledProvidersFn || !getProviderConfigFn || !readPortableRegistryFn) {
-      return;
-    }
-    const allProviders = await detectInstalledProvidersFn();
-    const targets = allProviders.filter((p) => p !== "claude-code");
-    if (targets.length === 0)
-      return;
-    const providerNames = targets.map((p) => getProviderConfigFn(p).displayName).join(", ");
-    const registry = await readPortableRegistryFn();
-    const hasHistory = registry.installations.some((i) => i.provider !== "claude-code");
-    const ckConfig = await loadFullConfigFn(ctx.options.global ? null : ctx.resolvedDir);
-    const pipeline = ckConfig.config.updatePipeline;
-    const autoMigrate = pipeline?.autoMigrateAfterInit ?? false;
-    if (autoMigrate) {
-      await runAutoMigrate(ctx, pipeline, targets, providerNames, deps);
-    } else if (!hasHistory && !ctx.isNonInteractive) {
-      await showNudge(ctx, providerNames, deps);
-    }
-  } catch (error) {
-    logger.debug(`Post-init migrate check skipped: ${error instanceof Error ? error.message : "unknown"}`);
-  }
-}
-async function showNudge(ctx, providerNames, deps) {
-  const noteFn = deps?.noteFn ?? note;
-  const confirmFn = deps?.confirmFn ?? se;
-  const isCancelFn = deps?.isCancelFn ?? lD;
-  const execAsyncFn = deps?.execAsyncFn ?? execAsync8;
-  noteFn([
-    `Detected providers: ${providerNames}`,
-    "Run `ck migrate` to sync your kit to these providers.",
-    "Set `autoMigrateAfterInit: true` in .ck.json to auto-sync on future updates."
-  ].join(`
-`), "[i] Provider Sync Available");
-  const shouldMigrate = await confirmFn({
-    message: "Run ck migrate now?"
-  });
-  if (isCancelFn(shouldMigrate) || !shouldMigrate)
-    return;
-  const parts = ["ck", "migrate"];
-  if (ctx.options.global)
-    parts.push("-g");
-  parts.push("--yes");
-  const cmd = parts.join(" ");
-  try {
-    logger.info(`Running: ${cmd}`);
-    await execAsyncFn(cmd, { timeout: 300000 });
-    logger.success("Migration complete");
-  } catch (error) {
-    logger.warning(`Migration failed: ${error instanceof Error ? error.message : "unknown"}. Run \`ck migrate\` manually to retry.`);
-  }
-}
-async function runAutoMigrate(ctx, pipeline, detectedTargets, providerNames, deps) {
-  const execAsyncFn = deps?.execAsyncFn ?? execAsync8;
-  let providers2;
-  if (!pipeline?.migrateProviders || pipeline.migrateProviders === "auto") {
-    providers2 = detectedTargets;
-  } else if (Array.isArray(pipeline.migrateProviders)) {
-    const invalid = pipeline.migrateProviders.filter((p) => !detectedTargets.includes(p));
-    if (invalid.length > 0) {
-      logger.warning(`Unknown/uninstalled providers in migrateProviders: ${invalid.join(", ")}`);
-    }
-    providers2 = pipeline.migrateProviders.filter((p) => detectedTargets.includes(p));
-  } else {
-    return;
-  }
-  if (providers2.length === 0)
-    return;
-  const safeProviders = providers2.filter((p) => SAFE_PROVIDER_NAME.test(p));
-  if (safeProviders.length !== providers2.length) {
-    logger.warning("Some provider names contain invalid characters and were skipped");
-  }
-  if (safeProviders.length === 0)
-    return;
-  const parts = ["ck", "migrate"];
-  if (ctx.options.global)
-    parts.push("-g");
-  for (const p of safeProviders) {
-    parts.push("--agent", p);
-  }
-  parts.push("--yes");
-  const cmd = parts.join(" ");
-  logger.info(`Auto-migrating to: ${providerNames}`);
-  try {
-    await execAsyncFn(cmd, { timeout: 300000 });
-    logger.success("Auto-migration complete");
-  } catch (error) {
-    logger.warning(`Auto-migration failed: ${error instanceof Error ? error.message : "unknown"}. Run \`ck migrate\` manually to retry.`);
-  }
-}
-
-// src/commands/init/phases/post-install-handler.ts
 async function handlePostInstall(ctx) {
   if (ctx.cancelled || !ctx.extractDir || !ctx.resolvedDir || !ctx.claudeDir) {
     return ctx;
@@ -96294,7 +96256,6 @@ async function handlePostInstall(ctx) {
       logger.debug(`Project auto-registration skipped: ${error instanceof Error ? error.message : "Unknown error"}`);
     }
   }
-  await maybePostInitMigrate(ctx);
   return {
     ...ctx,
     installSkills
@@ -96335,9 +96296,9 @@ async function detectAccessibleKits() {
 
 // src/domains/github/preflight-checker.ts
 init_logger();
-import { exec as exec9 } from "node:child_process";
-import { promisify as promisify15 } from "node:util";
-var execAsync9 = promisify15(exec9);
+import { exec as exec8 } from "node:child_process";
+import { promisify as promisify14 } from "node:util";
+var execAsync8 = promisify14(exec8);
 function createSuccessfulPreflightResult() {
   return {
     success: true,
@@ -96370,7 +96331,7 @@ async function runPreflightChecks() {
     errorLines: []
   };
   try {
-    const { stdout: stdout2 } = await execAsync9("gh --version", { timeout: GH_COMMAND_TIMEOUT_MS });
+    const { stdout: stdout2 } = await execAsync8("gh --version", { timeout: GH_COMMAND_TIMEOUT_MS });
     const match2 = stdout2.match(/(\d+\.\d+\.\d+)/);
     if (!match2) {
       logger.debug(`GitHub CLI version not detected from output: ${stdout2.trim()}`);
@@ -96408,7 +96369,7 @@ async function runPreflightChecks() {
     }
   }
   try {
-    await execAsync9("gh auth status -h github.com", {
+    await execAsync8("gh auth status -h github.com", {
       timeout: GH_COMMAND_TIMEOUT_MS,
       env: { ...process.env, GH_NO_UPDATE_NOTIFIER: "1" }
     });
@@ -96950,8 +96911,11 @@ async function handleSelection(ctx) {
       logger.success(`Found: ${release.tag_name}`);
     }
   }
+  if (ctx.options.force && !ctx.options.yes) {
+    logger.info("--force has no effect without --yes (the version-match skip only applies in non-interactive mode)");
+  }
   const releaseTag = release?.tag_name;
-  if (ctx.options.yes && !ctx.options.fresh && releaseTag && !isOfflineMode && !pendingKits?.length) {
+  if (ctx.options.yes && !ctx.options.fresh && !ctx.options.force && releaseTag && !isOfflineMode && !pendingKits?.length) {
     try {
       const prefix = PathResolver.getPathPrefix(ctx.options.global);
       const claudeDir2 = prefix ? join111(resolvedDir, prefix) : resolvedDir;
@@ -97882,6 +97846,7 @@ function createInitContext(rawOptions, prompts) {
     global: false,
     yes: false,
     fresh: false,
+    force: false,
     refresh: false,
     exclude: [],
     only: [],
@@ -100234,6 +100199,7 @@ async function handleKitSelection(ctx) {
       exclude: [],
       only: [],
       fresh: false,
+      force: false,
       installSkills: false,
       withSudo: false,
       prefix: false,
@@ -103163,7 +103129,7 @@ function registerCommands(cli) {
     }
     await newCommand(options2);
   });
-  cli.command("init", "Initialize or update ClaudeKit project (with interactive version selection)").option("--dir <dir>", "Target directory (default: .)").option("--kit <kit>", "Kit to use: engineer, marketing, all, or comma-separated").option("-r, --release <version>", "Skip version selection, use specific version (e.g., latest, v1.0.0)").option("--exclude <pattern>", "Exclude files matching glob pattern (can be used multiple times)").option("--only <pattern>", "Include only files matching glob pattern (can be used multiple times)").option("-g, --global", "Use platform-specific user configuration directory").option("--fresh", "Full reset: remove CK files, replace settings.json and CLAUDE.md, reinstall from scratch").option("--install-skills", "Install skills dependencies (non-interactive mode)").option("--with-sudo", "Include system packages requiring sudo (Linux: ffmpeg, imagemagick)").option("--prefix", "Add /ck: prefix to all slash commands by moving them to commands/ck/ subdirectory").option("--beta", "Show beta versions in selection prompt").option("--refresh", "Bypass release cache to fetch latest versions from GitHub").option("--dry-run", "Preview changes without applying them (requires --prefix)").option("--force-overwrite", "Override ownership protections and delete user-modified files (requires --prefix)").option("--force-overwrite-settings", "Fully replace settings.json instead of selective merge (destroys user customizations)").option("--skip-setup", "Skip interactive configuration wizard").option("--docs-dir <name>", "Custom docs folder name (default: docs)").option("--plans-dir <name>", "Custom plans folder name (default: plans)").option("-y, --yes", "Non-interactive mode with sensible defaults (skip all prompts)").option("--sync", "Sync config files from upstream with interactive hunk-by-hunk merge").option("--use-git", "Use git clone instead of GitHub API (uses SSH/HTTPS credentials)").option("--archive <path>", "Use local archive file instead of downloading (zip/tar.gz)").option("--kit-path <path>", "Use local kit directory instead of downloading").action(async (options2) => {
+  cli.command("init", "Initialize or update ClaudeKit project (with interactive version selection)").option("--dir <dir>", "Target directory (default: .)").option("--kit <kit>", "Kit to use: engineer, marketing, all, or comma-separated").option("-r, --release <version>", "Skip version selection, use specific version (e.g., latest, v1.0.0)").option("--exclude <pattern>", "Exclude files matching glob pattern (can be used multiple times)").option("--only <pattern>", "Include only files matching glob pattern (can be used multiple times)").option("-g, --global", "Use platform-specific user configuration directory").option("--fresh", "Full reset: remove CK files, replace settings.json and CLAUDE.md, reinstall from scratch").option("--force", "Force reinstall even if already at latest version (use with --yes; re-onboards missing files without full reset)").option("--install-skills", "Install skills dependencies (non-interactive mode)").option("--with-sudo", "Include system packages requiring sudo (Linux: ffmpeg, imagemagick)").option("--prefix", "Add /ck: prefix to all slash commands by moving them to commands/ck/ subdirectory").option("--beta", "Show beta versions in selection prompt").option("--refresh", "Bypass release cache to fetch latest versions from GitHub").option("--dry-run", "Preview changes without applying them (requires --prefix)").option("--force-overwrite", "Override ownership protections and delete user-modified files (requires --prefix)").option("--force-overwrite-settings", "Fully replace settings.json instead of selective merge (destroys user customizations)").option("--skip-setup", "Skip interactive configuration wizard").option("--docs-dir <name>", "Custom docs folder name (default: docs)").option("--plans-dir <name>", "Custom plans folder name (default: plans)").option("-y, --yes", "Non-interactive mode with sensible defaults (skip all prompts)").option("--sync", "Sync config files from upstream with interactive hunk-by-hunk merge").option("--use-git", "Use git clone instead of GitHub API (uses SSH/HTTPS credentials)").option("--archive <path>", "Use local archive file instead of downloading (zip/tar.gz)").option("--kit-path <path>", "Use local kit directory instead of downloading").action(async (options2) => {
     if (options2.exclude && !Array.isArray(options2.exclude)) {
       options2.exclude = [options2.exclude];
     }