@dadado/agent-kit-cli 6.2.0 → 6.3.0

package/dist/{add-Y2426TGU.js → add-VA2W7I6P.js}

@@ -5,7 +5,7 @@ import {
 import {
   REGISTRY_CLI_ARGS,
   resolveRegistryFromCli
-} from "./chunk-C2SJDYAM.js";
+} from "./chunk-U26MRIWN.js";
 import {
   logger
 } from "./chunk-ZB43YMHW.js";
@@ -22,7 +22,7 @@ import {
   resolveProtectedGlobs,
   saveManifest,
   upsertIdList
-} from "./chunk-NSSXSZLL.js";
+} from "./chunk-6KUSG7BJ.js";
 import {
   KIT_VERSION
 } from "./chunk-7HDQEK6T.js";

package/dist/{chunk-X45O2AIE.js → chunk-25J2SMJQ.js}

@@ -4,7 +4,7 @@ import {
   loadRegistry,
   packMemberFileTargets,
   skillFileTargets
-} from "./chunk-NSSXSZLL.js";
+} from "./chunk-6KUSG7BJ.js";
 
 // src/lifecycle/l0.ts
 var L0_ARTIFACTS = [

package/dist/{chunk-TW4BF5OE.js → chunk-6GYKOHIL.js}

@@ -6,13 +6,13 @@ import {
 import {
   diffAgainstRegistry,
   summarizeDiff
-} from "./chunk-CWDXNBEU.js";
+} from "./chunk-VQBI3JVS.js";
 import {
   DEFAULT_REGISTRY_URL,
   assertSafeRegistrySource,
   loadAgentKitManifest,
   resolveRegistryRoot
-} from "./chunk-NSSXSZLL.js";
+} from "./chunk-6KUSG7BJ.js";
 import {
   KIT_PACKAGE_SPEC,
   KIT_VERSION

package/dist/{chunk-NSSXSZLL.js → chunk-6KUSG7BJ.js}

@@ -693,7 +693,9 @@ var KNOWN_SHIPPED_OVERLAY_HASHES = /* @__PURE__ */ new Set([
   "aef5e06c10d1166e1a3efc3cc1f1deda28430334aa7d3fc1e3fe04de478d4bc3",
   "2b7978c318169d00c7274e27e5082bd6bfe47168c36407c66c828a4e56dab4c1",
   "d92297c4675bf9b91d7aaa39fdfafcf2568c9b8b867c80e8121e6225bcf9d5a3",
-  "5656ec26963f4d43f9c440f4cae65ad7aa3a33a603de13d81400d3cb5acd1b40"
+  "5656ec26963f4d43f9c440f4cae65ad7aa3a33a603de13d81400d3cb5acd1b40",
+  "64cfb0dba5d6bcdcd919eaa73fe32e9e34689323d65c70c9ee8aa107bf228677",
+  "267537b445490788f4c146e0f5e9276b77a6cc4be77abca8f5696d758bbddaf9"
 ]);
 
 // src/lifecycle/paths.ts

package/dist/{chunk-SPYIP76F.js → chunk-NNKOWUWM.js}

@@ -10,7 +10,7 @@ import {
   resolveContained,
   saveManagedHashLedger,
   shouldPreserveCustomizedOverlay
-} from "./chunk-NSSXSZLL.js";
+} from "./chunk-6KUSG7BJ.js";
 import {
   ensureDir,
   fileExists

package/dist/{chunk-CER2APV2.js → chunk-OVOXRH5W.js}

@@ -1,6 +1,6 @@
 import {
   MANIFEST_RELATIVE_PATH
-} from "./chunk-NSSXSZLL.js";
+} from "./chunk-6KUSG7BJ.js";
 import {
   fileExists
 } from "./chunk-5B4DVO6C.js";

package/dist/{chunk-VO73OL5V.js → chunk-OWWFKGKS.js}

@@ -4,10 +4,10 @@ import {
 import {
   compareSemver,
   normalizeSemver
-} from "./chunk-TW4BF5OE.js";
+} from "./chunk-6GYKOHIL.js";
 import {
   MANIFEST_RELATIVE_PATH
-} from "./chunk-NSSXSZLL.js";
+} from "./chunk-6KUSG7BJ.js";
 import {
   KIT_VERSION,
   pinnedCliSpec

package/dist/{chunk-IR7FFPUU.js → chunk-SV2BR2LZ.js}

@@ -1,8 +1,12 @@
 import {
   NON_INTERACTIVE_ROOT_ARGS,
+  StaleCliError,
+  detectStaleCli,
+  formatRerunFlags,
+  formatStaleCliRefusal,
   installL0,
   syncFromManifest
-} from "./chunk-TGNFGMPV.js";
+} from "./chunk-Z7RYIHHX.js";
 import {
   SkippedSymlinkError,
   formatPersonalizationSkippedSymlinks,
@@ -11,11 +15,11 @@ import {
 import {
   REGISTRY_CLI_ARGS,
   resolveRegistryFromCli
-} from "./chunk-C2SJDYAM.js";
+} from "./chunk-U26MRIWN.js";
 import {
   assessClaudeCommandAdapters,
   executeSafeReadinessFixes
-} from "./chunk-BEKQ6PVD.js";
+} from "./chunk-WMVMBPCR.js";
 import {
   writeReadinessSnapshot
 } from "./chunk-HAFRAXGV.js";
@@ -23,7 +27,7 @@ import {
   CLAUDE_HITL_FALLBACK,
   generateClaudeCommandAdapters,
   writeClaudeSessionStartHook
-} from "./chunk-SPYIP76F.js";
+} from "./chunk-NNKOWUWM.js";
 import {
   shouldUseWelcomeColor,
   withCliProgress
@@ -50,13 +54,13 @@ import {
   npxPinned,
   pathCliStatus,
   syncPathCliToRuntime
-} from "./chunk-VO73OL5V.js";
+} from "./chunk-OWWFKGKS.js";
 import {
   assessEnvironment
 } from "./chunk-B3VR5YBQ.js";
 import {
   warnIfRunningCliBehindNpm
-} from "./chunk-TW4BF5OE.js";
+} from "./chunk-6GYKOHIL.js";
 import {
   DOMAIN_PACK_IDS,
   allPacks,
@@ -73,7 +77,7 @@ import {
   resolveProtectedGlobs,
   saveManifest,
   skillTargetDir
-} from "./chunk-NSSXSZLL.js";
+} from "./chunk-6KUSG7BJ.js";
 import {
   KIT_VERSION,
   pinnedCliSpec
@@ -791,6 +795,8 @@ async function performInstall(options) {
     manifest: existing
   });
   try {
+    const stale = await detectStaleCli(registry.root, { warn: logger.warn });
+    if (stale && !options.allowStaleCli) throw new StaleCliError(stale);
     const draft = buildManifest({
       version: KIT_VERSION,
       profile: options.profile ?? existing?.profile ?? "default",
@@ -856,6 +862,17 @@ async function performInstall(options) {
     await registry.unlock?.();
   }
 }
+var INSTALL_RERUN_FLAGS = [
+  "pack",
+  "claude",
+  "yes",
+  "force-root",
+  "cwd",
+  "registry",
+  "url",
+  "ref",
+  "refresh"
+];
 var installCommand = defineCommand({
   meta: {
     name: "install",
@@ -872,6 +889,11 @@ var installCommand = defineCommand({
       description: `Comma-separated L1 pack ids (e.g. cybersec,devops). Known: ${DOMAIN_PACK_IDS.join(", ")}`
     },
     ...NON_INTERACTIVE_ROOT_ARGS,
+    "allow-stale-cli": {
+      type: "boolean",
+      description: "Install even when this CLI is older than the registry it is syncing from; the manifest is then stamped with this CLI's version, not the registry's (factory/dev only)",
+      default: false
+    },
     claude: {
       type: "boolean",
       description: "Opt-in: generate .claude/commands/*.md thin pointer adapters for the installed .cursor/commands set, and merge a SessionStart context hook into .claude/settings.json (default install behavior is unchanged without this flag)",
@@ -926,7 +948,8 @@ ${err.recovery}
           url: args.url,
           ref: args.ref,
           refresh: args.refresh,
-          claudeAdapters: args.claude
+          claudeAdapters: args.claude,
+          allowStaleCli: args["allow-stale-cli"]
         })
       );
       logApplyStats(result.stats);
@@ -941,6 +964,18 @@ ${result.claudeSessionStartInstructions}
       }
       if (result.claudeAdapterHint) logger.info(result.claudeAdapterHint);
     } catch (err) {
+      if (err instanceof StaleCliError) {
+        const profile = typeof args.profile === "string" && args.profile ? `${args.profile} ` : "";
+        const refusal = formatStaleCliRefusal({
+          command: "install",
+          stale: err.stale,
+          rerun: `${profile}${formatRerunFlags(args, INSTALL_RERUN_FLAGS)}`.trim()
+        });
+        logger.error(refusal.error);
+        console.error(refusal.recovery);
+        process.exitCode = 1;
+        return;
+      }
       if (err instanceof SkippedSymlinkError) {
         logApplyStats(err.stats);
         logger.error(err.message);

package/dist/{chunk-C2SJDYAM.js → chunk-U26MRIWN.js}

@@ -5,7 +5,7 @@ import {
   DEFAULT_REGISTRY_REF,
   DEFAULT_REGISTRY_URL,
   resolveRegistryRoot
-} from "./chunk-NSSXSZLL.js";
+} from "./chunk-6KUSG7BJ.js";
 
 // src/lifecycle/resolve-cli.ts
 async function resolveRegistryFromCli(options) {

package/dist/{chunk-CWDXNBEU.js → chunk-VQBI3JVS.js}

@@ -1,11 +1,11 @@
 import {
   managedPairs
-} from "./chunk-X45O2AIE.js";
+} from "./chunk-25J2SMJQ.js";
 import {
   isProtectedPath,
   resolveContained,
   resolveProtectedGlobs
-} from "./chunk-NSSXSZLL.js";
+} from "./chunk-6KUSG7BJ.js";
 
 // src/lifecycle/diff.ts
 import { readFile } from "fs/promises";

package/dist/{chunk-BEKQ6PVD.js → chunk-WMVMBPCR.js}

@@ -5,7 +5,7 @@ import {
   RESOLVE_AGENT_KIT_REL,
   SESSION_START_HOOK_MARKER,
   discoverInstalledCommands
-} from "./chunk-SPYIP76F.js";
+} from "./chunk-NNKOWUWM.js";
 import {
   findOnPath
 } from "./chunk-WGLPZXNU.js";

package/dist/{chunk-TGNFGMPV.js → chunk-Z7RYIHHX.js}

@@ -1,6 +1,11 @@
+import {
+  compareSemver,
+  normalizeSemver,
+  readLocalKitVersion
+} from "./chunk-6GYKOHIL.js";
 import {
   L0_ARTIFACTS
-} from "./chunk-X45O2AIE.js";
+} from "./chunk-25J2SMJQ.js";
 import {
   copyRegistryFile,
   emptyStats,
@@ -12,24 +17,100 @@ import {
   recordOutcome,
   resolveProtectedGlobs,
   saveManagedHashLedger
-} from "./chunk-NSSXSZLL.js";
+} from "./chunk-6KUSG7BJ.js";
+import {
+  KIT_PACKAGE_SPEC,
+  KIT_VERSION
+} from "./chunk-7HDQEK6T.js";
 import {
   fileExists
 } from "./chunk-5B4DVO6C.js";
 
+// src/lifecycle/stale-cli.ts
+import path from "path";
+async function detectStaleCli(registryRoot, options) {
+  const registryVersionRaw = await readLocalKitVersion(registryRoot);
+  const registryVersion = registryVersionRaw ? normalizeSemver(registryVersionRaw) : null;
+  const cliVersion = normalizeSemver(options.cliVersion ?? KIT_VERSION);
+  if (!registryVersion) {
+    options.warn(
+      "Could not read a version from the registry checkout - skipping the CLI freshness check."
+    );
+    return null;
+  }
+  if (cliVersion && compareSemver(cliVersion, registryVersion) < 0) {
+    return { cliVersion, registryVersion };
+  }
+  return null;
+}
+var SHELL_SAFE = /^[A-Za-z0-9_./:@=+,-]+$/;
+function shellQuote(value) {
+  return SHELL_SAFE.test(value) ? value : `'${value.replaceAll("'", `'\\''`)}'`;
+}
+function formatRerunFlags(args, flags, currentDir = process.cwd()) {
+  const out = [];
+  for (const flag of flags) {
+    const value = args[flag];
+    if (value === true) {
+      out.push(flag === "yes" ? "-y" : `--${flag}`);
+    } else if (typeof value === "string" && value.length > 0) {
+      if (flag === "cwd" && path.resolve(value) === path.resolve(currentDir)) continue;
+      out.push(`--${flag}`, shellQuote(value));
+    }
+  }
+  return out.join(" ");
+}
+function formatStaleCliRefusal(input) {
+  const { command, stale, rerun } = input;
+  const { cliVersion, registryVersion } = stale;
+  const tail = rerun ? ` ${rerun}` : "";
+  return {
+    error: `This CLI is v${cliVersion}, older than the registry it would apply (v${registryVersion}).`,
+    recovery: [
+      "",
+      `\`agent-kit ${command}\` syncs registry content but stamps .cursor/agent-kit.json with the`,
+      `version of the CLI running it, so applying now would write v${cliVersion} again, not v${registryVersion}.`,
+      "",
+      "Upgrade the binary first, then re-run:",
+      `  npm i -g ${KIT_PACKAGE_SPEC}@${registryVersion}`,
+      `  agent-kit ${command}${tail}`,
+      "",
+      "Or run that version once without a global install:",
+      `  npx -y ${KIT_PACKAGE_SPEC}@${registryVersion} ${command}${tail}`,
+      "",
+      `If npm has no ${registryVersion} yet, the release is still mid-publish`,
+      "(content sync and npm publish run in parallel) - retry shortly.",
+      "",
+      "Factory/dev checkouts that intend to apply newer content with an older",
+      "binary can pass --allow-stale-cli.",
+      ""
+    ].join("\n")
+  };
+}
+var StaleCliError = class extends Error {
+  constructor(stale) {
+    super(
+      `This CLI is v${stale.cliVersion}, older than the registry it would apply (v${stale.registryVersion}).`
+    );
+    this.stale = stale;
+    this.name = "StaleCliError";
+  }
+  stale;
+};
+
 // src/lifecycle/onboard-migration.ts
 import { createHash } from "crypto";
 import { readFile, unlink } from "fs/promises";
-import path from "path";
+import path2 from "path";
 var LEGACY_ONBOARD_PATH = ".cursor/commands/onboard.md";
 var NAMESPACED_ONBOARD_PATH = ".cursor/commands/agent-kit-onboard.md";
 var MANAGED_LEGACY_HASHES = /* @__PURE__ */ new Set([
   "b274a68941813f19b185893cb7c5561dff027f53270890029992f208e24992fe"
 ]);
 async function migrateLegacyOnboardCommand(projectRoot, managedHashes = MANAGED_LEGACY_HASHES) {
-  const legacyPath = path.join(projectRoot, LEGACY_ONBOARD_PATH);
+  const legacyPath = path2.join(projectRoot, LEGACY_ONBOARD_PATH);
   if (!await fileExists(legacyPath)) return "absent";
-  const namespacedPath = path.join(projectRoot, NAMESPACED_ONBOARD_PATH);
+  const namespacedPath = path2.join(projectRoot, NAMESPACED_ONBOARD_PATH);
   if (!await fileExists(namespacedPath)) return "preserved-customized";
   const content = await readFile(legacyPath);
   const hash = createHash("sha256").update(content).digest("hex");
@@ -100,6 +181,10 @@ var NON_INTERACTIVE_ROOT_ARGS = {
 };
 
 export {
+  detectStaleCli,
+  formatRerunFlags,
+  formatStaleCliRefusal,
+  StaleCliError,
   installL0,
   syncFromManifest,
   NON_INTERACTIVE_ROOT_ARGS

package/dist/{contribute-TVST3CJO.js → contribute-NLM2BN6Z.js}

@@ -1,18 +1,18 @@
 import {
   REGISTRY_CLI_ARGS,
   resolveRegistryFromCli
-} from "./chunk-C2SJDYAM.js";
+} from "./chunk-U26MRIWN.js";
 import {
   logger
 } from "./chunk-ZB43YMHW.js";
 import {
   managedPairs
-} from "./chunk-X45O2AIE.js";
+} from "./chunk-25J2SMJQ.js";
 import {
   loadAgentKitManifest,
   normalizeRelPath,
   resolveContained
-} from "./chunk-NSSXSZLL.js";
+} from "./chunk-6KUSG7BJ.js";
 import "./chunk-C4Q77GGJ.js";
 import "./chunk-5B4DVO6C.js";
 

package/dist/{diff-MECE5RZB.js → diff-HHG4JEDE.js}

@@ -1,18 +1,18 @@
 import {
   REGISTRY_CLI_ARGS,
   resolveRegistryFromCli
-} from "./chunk-C2SJDYAM.js";
+} from "./chunk-U26MRIWN.js";
 import {
   logger
 } from "./chunk-ZB43YMHW.js";
 import {
   diffAgainstRegistry,
   summarizeDiff
-} from "./chunk-CWDXNBEU.js";
-import "./chunk-X45O2AIE.js";
+} from "./chunk-VQBI3JVS.js";
+import "./chunk-25J2SMJQ.js";
 import {
   loadAgentKitManifest
-} from "./chunk-NSSXSZLL.js";
+} from "./chunk-6KUSG7BJ.js";
 import "./chunk-C4Q77GGJ.js";
 import "./chunk-5B4DVO6C.js";
 

package/dist/{doctor-VLZNXJNA.js → doctor-TWF2M3S3.js}

@@ -2,11 +2,11 @@ import {
   assessHooksHealth,
   executeSafeReadinessFixes,
   refreshRepositoryProfile
-} from "./chunk-BEKQ6PVD.js";
+} from "./chunk-WMVMBPCR.js";
 import {
   writeReadinessSnapshot
 } from "./chunk-HAFRAXGV.js";
-import "./chunk-SPYIP76F.js";
+import "./chunk-NNKOWUWM.js";
 import "./chunk-WGLPZXNU.js";
 import "./chunk-MAPOQEA2.js";
 import {
@@ -15,7 +15,7 @@ import {
 import {
   detectWorkspaceParent,
   workspaceParentAdvisoryLines
-} from "./chunk-CER2APV2.js";
+} from "./chunk-OVOXRH5W.js";
 import {
   createReadinessReport
 } from "./chunk-PNFF6OU3.js";
@@ -32,11 +32,11 @@ import {
 } from "./chunk-B3VR5YBQ.js";
 import {
   warnIfRunningCliBehindNpm
-} from "./chunk-TW4BF5OE.js";
+} from "./chunk-6GYKOHIL.js";
 import "./chunk-PFEUZXVT.js";
-import "./chunk-CWDXNBEU.js";
-import "./chunk-X45O2AIE.js";
-import "./chunk-NSSXSZLL.js";
+import "./chunk-VQBI3JVS.js";
+import "./chunk-25J2SMJQ.js";
+import "./chunk-6KUSG7BJ.js";
 import {
   KIT_VERSION
 } from "./chunk-7HDQEK6T.js";

package/dist/{hook-XCZWX462.js → hook-VP7FHRSZ.js}

@@ -23,15 +23,15 @@ import {
 } from "./chunk-HAFRAXGV.js";
 import {
   stampLastCheckedAt
-} from "./chunk-TW4BF5OE.js";
+} from "./chunk-6GYKOHIL.js";
 import {
   loadContextConfig
 } from "./chunk-PFEUZXVT.js";
-import "./chunk-CWDXNBEU.js";
-import "./chunk-X45O2AIE.js";
+import "./chunk-VQBI3JVS.js";
+import "./chunk-25J2SMJQ.js";
 import {
   MANIFEST_RELATIVE_PATH
-} from "./chunk-NSSXSZLL.js";
+} from "./chunk-6KUSG7BJ.js";
 import "./chunk-7HDQEK6T.js";
 import {
   HANDOFF_REL

package/dist/index.js

@@ -221,20 +221,20 @@ var main = defineCommand({
     version: KIT_VERSION
   },
   subCommands: {
-    init: () => import("./init-HKMRU2V4.js").then((m) => m.initCommand),
-    install: () => import("./install-X2J6KWZ5.js").then((m) => m.installCommand),
+    init: () => import("./init-UOTV4ASJ.js").then((m) => m.initCommand),
+    install: () => import("./install-VCHPXQV3.js").then((m) => m.installCommand),
     scan: () => import("./scan-UX4HARMJ.js").then((m) => m.scanCommand),
-    add: () => import("./add-Y2426TGU.js").then((m) => m.addCommand),
-    doctor: () => import("./doctor-VLZNXJNA.js").then((m) => m.doctorCommand),
-    "setup-global": () => import("./setup-global-ADJFMOZX.js").then((m) => m.setupGlobalCommand),
-    status: () => import("./status-UB6NL3Q3.js").then((m) => m.statusCommand),
-    update: () => import("./update-PFBFY7GT.js").then((m) => m.updateCommand),
+    add: () => import("./add-VA2W7I6P.js").then((m) => m.addCommand),
+    doctor: () => import("./doctor-TWF2M3S3.js").then((m) => m.doctorCommand),
+    "setup-global": () => import("./setup-global-M6LKGJHQ.js").then((m) => m.setupGlobalCommand),
+    status: () => import("./status-5UKVIKOI.js").then((m) => m.statusCommand),
+    update: () => import("./update-VQBGEUWS.js").then((m) => m.updateCommand),
     "cursor-awareness": () => import("./cursor-awareness-TN5JXD2C.js").then((m) => m.cursorAwarenessCommand),
     "public-inbound-radar": () => import("./public-inbound-radar-5U4JMBRU.js").then((m) => m.publicInboundRadarCommand),
     "remote-issues": () => import("./remote-issues-APYOMIJC.js").then((m) => m.remoteIssuesCommand),
     dogfood: () => import("./dogfood-2JAHSYQA.js").then((m) => m.dogfoodCommand),
-    diff: () => import("./diff-MECE5RZB.js").then((m) => m.diffCommand),
-    contribute: () => import("./contribute-TVST3CJO.js").then((m) => m.contributeCommand),
+    diff: () => import("./diff-HHG4JEDE.js").then((m) => m.diffCommand),
+    contribute: () => import("./contribute-NLM2BN6Z.js").then((m) => m.contributeCommand),
     handoff: () => import("./handoff-5AGE2D3T.js").then((m) => m.handoffCommand),
     "plan-index": () => import("./plan-index-BNLUU6T5.js").then((m) => m.planIndexCommand),
     run: () => import("./run-R66G276Q.js").then((m) => m.runCommand),
@@ -245,7 +245,7 @@ var main = defineCommand({
     dashboard: () => import("./dashboard-YNCFISNO.js").then((m) => m.dashboardCommand),
     "dashboard-broadcast": () => import("./dashboard-broadcast-NK7PU72L.js").then((m) => m.dashboardBroadcastCommand),
     "mission-control": () => import("./mission-control-MHQU73XC.js").then((m) => m.missionControlCommand),
-    hook: () => import("./hook-XCZWX462.js").then((m) => m.hookCommand),
+    hook: () => import("./hook-VP7FHRSZ.js").then((m) => m.hookCommand),
     guard: () => import("./guard-EHXF76ID.js").then((m) => m.guardCommand),
     monitors: () => import("./monitors-PDXBLB3U.js").then((m) => m.monitorsCommand),
     validate: () => import("./validate-V2CW7J4B.js").then((m) => m.validateCommand)

package/dist/{init-HKMRU2V4.js → init-UOTV4ASJ.js}

@@ -2,18 +2,18 @@ import {
   nextStepAfterInstall,
   performInstall,
   printInstallEpilogue
-} from "./chunk-IR7FFPUU.js";
+} from "./chunk-SV2BR2LZ.js";
 import {
   NON_INTERACTIVE_ROOT_ARGS
-} from "./chunk-TGNFGMPV.js";
+} from "./chunk-Z7RYIHHX.js";
 import {
   SkippedSymlinkError,
   logApplyStats
 } from "./chunk-HS7LVVLO.js";
-import "./chunk-C2SJDYAM.js";
-import "./chunk-BEKQ6PVD.js";
+import "./chunk-U26MRIWN.js";
+import "./chunk-WMVMBPCR.js";
 import "./chunk-HAFRAXGV.js";
-import "./chunk-SPYIP76F.js";
+import "./chunk-NNKOWUWM.js";
 import "./chunk-WGLPZXNU.js";
 import "./chunk-MAPOQEA2.js";
 import {
@@ -31,15 +31,15 @@ import {
   confirmProjectRoot,
   isNonInteractive,
   syncPathCliToRuntime
-} from "./chunk-VO73OL5V.js";
+} from "./chunk-OWWFKGKS.js";
 import {
   assessEnvironment
 } from "./chunk-B3VR5YBQ.js";
-import "./chunk-TW4BF5OE.js";
+import "./chunk-6GYKOHIL.js";
 import "./chunk-PFEUZXVT.js";
-import "./chunk-CWDXNBEU.js";
-import "./chunk-X45O2AIE.js";
-import "./chunk-NSSXSZLL.js";
+import "./chunk-VQBI3JVS.js";
+import "./chunk-25J2SMJQ.js";
+import "./chunk-6KUSG7BJ.js";
 import {
   KIT_VERSION
 } from "./chunk-7HDQEK6T.js";

package/dist/{install-X2J6KWZ5.js → install-VCHPXQV3.js}

@@ -3,13 +3,13 @@ import {
   nextStepAfterInstall,
   performInstall,
   printInstallEpilogue
-} from "./chunk-IR7FFPUU.js";
-import "./chunk-TGNFGMPV.js";
+} from "./chunk-SV2BR2LZ.js";
+import "./chunk-Z7RYIHHX.js";
 import "./chunk-HS7LVVLO.js";
-import "./chunk-C2SJDYAM.js";
-import "./chunk-BEKQ6PVD.js";
+import "./chunk-U26MRIWN.js";
+import "./chunk-WMVMBPCR.js";
 import "./chunk-HAFRAXGV.js";
-import "./chunk-SPYIP76F.js";
+import "./chunk-NNKOWUWM.js";
 import "./chunk-WGLPZXNU.js";
 import "./chunk-MAPOQEA2.js";
 import "./chunk-QTON2GQX.js";
@@ -17,13 +17,13 @@ import "./chunk-PNFF6OU3.js";
 import "./chunk-GO3K752H.js";
 import "./chunk-F6C3GFKV.js";
 import "./chunk-ZB43YMHW.js";
-import "./chunk-VO73OL5V.js";
+import "./chunk-OWWFKGKS.js";
 import "./chunk-B3VR5YBQ.js";
-import "./chunk-TW4BF5OE.js";
+import "./chunk-6GYKOHIL.js";
 import "./chunk-PFEUZXVT.js";
-import "./chunk-CWDXNBEU.js";
-import "./chunk-X45O2AIE.js";
-import "./chunk-NSSXSZLL.js";
+import "./chunk-VQBI3JVS.js";
+import "./chunk-25J2SMJQ.js";
+import "./chunk-6KUSG7BJ.js";
 import "./chunk-7HDQEK6T.js";
 import "./chunk-C4Q77GGJ.js";
 import "./chunk-5B4DVO6C.js";

package/dist/{setup-global-ADJFMOZX.js → setup-global-M6LKGJHQ.js}

@@ -2,15 +2,15 @@ import {
   classifyInstallError,
   isNonInteractive,
   pathCliStatus
-} from "./chunk-VO73OL5V.js";
+} from "./chunk-OWWFKGKS.js";
 import {
   assessEnvironment
 } from "./chunk-B3VR5YBQ.js";
-import "./chunk-TW4BF5OE.js";
+import "./chunk-6GYKOHIL.js";
 import "./chunk-PFEUZXVT.js";
-import "./chunk-CWDXNBEU.js";
-import "./chunk-X45O2AIE.js";
-import "./chunk-NSSXSZLL.js";
+import "./chunk-VQBI3JVS.js";
+import "./chunk-25J2SMJQ.js";
+import "./chunk-6KUSG7BJ.js";
 import {
   KIT_VERSION,
   pinnedCliSpec

package/dist/{status-UB6NL3Q3.js → status-5UKVIKOI.js}

@@ -1,7 +1,7 @@
 import {
   detectWorkspaceParent,
   workspaceParentAdvisoryLines
-} from "./chunk-CER2APV2.js";
+} from "./chunk-OVOXRH5W.js";
 import {
   createReadinessReport
 } from "./chunk-PNFF6OU3.js";
@@ -15,19 +15,19 @@ import {
 import {
   npxPinned,
   pathCliStatus
-} from "./chunk-VO73OL5V.js";
+} from "./chunk-OWWFKGKS.js";
 import {
   assessEnvironment
 } from "./chunk-B3VR5YBQ.js";
-import "./chunk-TW4BF5OE.js";
+import "./chunk-6GYKOHIL.js";
 import "./chunk-PFEUZXVT.js";
-import "./chunk-CWDXNBEU.js";
-import "./chunk-X45O2AIE.js";
+import "./chunk-VQBI3JVS.js";
+import "./chunk-25J2SMJQ.js";
 import {
   MANIFEST_RELATIVE_PATH,
   loadAgentKitManifest,
   resolveProtectedGlobs
-} from "./chunk-NSSXSZLL.js";
+} from "./chunk-6KUSG7BJ.js";
 import {
   KIT_VERSION
 } from "./chunk-7HDQEK6T.js";

package/dist/{update-PFBFY7GT.js → update-VQBGEUWS.js}

@@ -1,7 +1,10 @@
 import {
   NON_INTERACTIVE_ROOT_ARGS,
+  detectStaleCli,
+  formatRerunFlags,
+  formatStaleCliRefusal,
   syncFromManifest
-} from "./chunk-TGNFGMPV.js";
+} from "./chunk-Z7RYIHHX.js";
 import {
   formatSkippedSymlinks,
   logApplyStats
@@ -9,14 +12,14 @@ import {
 import {
   REGISTRY_CLI_ARGS,
   resolveRegistryFromCli
-} from "./chunk-C2SJDYAM.js";
+} from "./chunk-U26MRIWN.js";
 import {
   CLAUDE_SETTINGS_REL,
   formatClaudeSettingsDrift,
   generateClaudeCommandAdapters,
   planClaudeSettingsDrift,
   writeClaudeSessionStartHook
-} from "./chunk-SPYIP76F.js";
+} from "./chunk-NNKOWUWM.js";
 import "./chunk-MAPOQEA2.js";
 import {
   withCliProgress
@@ -29,17 +32,14 @@ import {
   confirmProjectRoot,
   isNonInteractive,
   syncPathCliToRuntime
-} from "./chunk-VO73OL5V.js";
+} from "./chunk-OWWFKGKS.js";
 import "./chunk-B3VR5YBQ.js";
 import {
-  checkForUpdates,
-  compareSemver,
-  normalizeSemver,
-  readLocalKitVersion
-} from "./chunk-TW4BF5OE.js";
+  checkForUpdates
+} from "./chunk-6GYKOHIL.js";
 import "./chunk-PFEUZXVT.js";
-import "./chunk-CWDXNBEU.js";
-import "./chunk-X45O2AIE.js";
+import "./chunk-VQBI3JVS.js";
+import "./chunk-25J2SMJQ.js";
 import {
   buildManifest,
   isProtectedPath,
@@ -47,9 +47,8 @@ import {
   resolveProtectedGlobs,
   saveManifest,
   seedManagedHashLedger
-} from "./chunk-NSSXSZLL.js";
+} from "./chunk-6KUSG7BJ.js";
 import {
-  KIT_PACKAGE_SPEC,
   KIT_VERSION
 } from "./chunk-7HDQEK6T.js";
 import "./chunk-C4Q77GGJ.js";
@@ -57,6 +56,17 @@ import "./chunk-5B4DVO6C.js";
 
 // src/commands/update.ts
 import { defineCommand } from "citty";
+var UPDATE_RERUN_FLAGS = [
+  "claude",
+  "yes",
+  "force-root",
+  "seed-overlay",
+  "cwd",
+  "registry",
+  "url",
+  "ref",
+  "refresh"
+];
 var updateCommand = defineCommand({
   meta: {
     name: "update",
@@ -159,35 +169,15 @@ ${err.recovery}
     });
     try {
       logger.info(`Registry: ${registry.root} (${registry.source})`);
-      const registryVersionRaw = await readLocalKitVersion(registry.root);
-      const registryVersion = registryVersionRaw ? normalizeSemver(registryVersionRaw) : null;
-      const cliVersion = normalizeSemver(KIT_VERSION);
-      if (!registryVersion) {
-        logger.warn(
-          "Could not read a version from the registry checkout - skipping the CLI freshness check."
-        );
-      } else if (cliVersion && compareSemver(cliVersion, registryVersion) < 0 && !args["allow-stale-cli"]) {
-        logger.error(
-          `This CLI is v${cliVersion}, older than the registry it would apply (v${registryVersion}).`
-        );
-        console.error(
-          [
-            "",
-            "`agent-kit update` syncs registry content but stamps .cursor/agent-kit.json with the",
-            `version of the CLI running it, so applying now would write v${cliVersion} again, not v${registryVersion}.`,
-            "",
-            "Upgrade the binary first, then re-run:",
-            `  npm i -g ${KIT_PACKAGE_SPEC}@${registryVersion}`,
-            "  agent-kit update",
-            "",
-            `If npm has no ${registryVersion} yet, the release is still mid-publish`,
-            "(content sync and npm publish run in parallel) - retry shortly.",
-            "",
-            "Factory/dev checkouts that intend to apply newer content with an older",
-            "binary can pass --allow-stale-cli.",
-            ""
-          ].join("\n")
-        );
+      const stale = await detectStaleCli(registry.root, { warn: logger.warn });
+      if (stale && !args["allow-stale-cli"]) {
+        const refusal = formatStaleCliRefusal({
+          command: "update",
+          stale,
+          rerun: formatRerunFlags(args, UPDATE_RERUN_FLAGS)
+        });
+        logger.error(refusal.error);
+        console.error(refusal.recovery);
         process.exitCode = 1;
         return;
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dadado/agent-kit-cli",
-  "version": "6.2.0",
+  "version": "6.3.0",
   "description": "Agent Kit CLI: HITL framework install and tooling for AI-assisted IDEs (rules, skills, plan/handoff, context).",
   "license": "Apache-2.0",
   "type": "module",