@dadado/agent-kit-cli 5.0.0 → 5.2.0

package/dist/index.js

@@ -72,8 +72,11 @@ var KNOWN_SHIPPED_OVERLAY_HASHES = /* @__PURE__ */ new Set([
   "004d98f557942677264d053dcd8335f2bbcf19c5591123ec16a7a2697cb88932",
   "05ee6ecde4215e33ace0ee152ffbf2cd885d2bd4b032900f0f0bb001d350ef0f",
   "082bdbc584be3f3d8aa6e9d7b9f4e076450f3ff48f9147a1deb557e31475036b",
+  "09850afc201eccb3e700cb934400d49c9cbe7510d4a546ee84ee519771a8200e",
   "0b5fe4729c3c68654434837630d775b847c082418f25b0b2c581700fe84b797a",
   "1106b279558b6a20f87951102f172a680976f3e6530855d5dad083e1f89b9ba3",
+  "12bed56b332406477cf546d9e8360d3cab129bd82a638bea356726d00a6847a3",
+  "13f6a0711a2fcadcc7f1b751772448517ce4871cdef6a0269fc26dad51ebe26d",
   "15566765ec95dad3bc3160f20ac910e01a13471df536e6d990f4b263700784a9",
   "1681e6cf7b80a67cd999b94b8b6e16eb8caed0e11b32905848ba733da956e902",
   "17818e47e06349ee35c1d8e1cc16e8bcbbbcc89c664014e9096e1f08c8567807",
@@ -83,6 +86,7 @@ var KNOWN_SHIPPED_OVERLAY_HASHES = /* @__PURE__ */ new Set([
   "1c5c1af87951367ad04bb6fa5b1d6ebaaefbc0ee95989b624cabf406a1869907",
   "1ded5c7b7eefc355fc1d17feb65ec472e35ed96076e47ce95f7bff5c1b84746c",
   "1e58e0d4f2e8459b95a40d1b1e72c5c85a87230cbde945840a84073fe3a20422",
+  "2280e3ca96129ab2de8a85a301df7c2b15ffaa6204b734ed3b1f303e0055c41d",
   "285668d08f1b15d96286d27e29cc4a67e126e097fb8a940bdde33ccf25bd2bcd",
   "2acdb148b07f3a4872b896da419af796fd3fefaace7ac79cdee0aab447004a83",
   "2cd7fc018a384b0188737259ecf593ce25b4b75cc38b3e410063ac91745894b9",
@@ -95,6 +99,7 @@ var KNOWN_SHIPPED_OVERLAY_HASHES = /* @__PURE__ */ new Set([
   "46a1dd4a07a2190ab9fb09abc05a3962277209f8e0c28033bb41450301474c86",
   "48a0d55e21132a305946b195db7f6b75da78d44a1d32166fb0c69bef4a5ffbe2",
   "4b62a46c74e5fa6a80283f21e8e6711958fbcd577051dc73ff4050643a031475",
+  "4ba6e319ac79455a7d2713674f64fabbc9cd401b5d26b1c0edbd19c27a52297e",
   "4bf23acbc9bd4e0f8468e61f4970e182600b72d9025d29e81ddbd83cb7b1710a",
   "4c5167d0ebde685f266dce32c516a7c43876e0520647b93f07f2e2147e6a7b2f",
   "4dc4efcd1b43c643d3889fb349df8d4964d0867c3a67eb67e2ec168fbb70fc75",
@@ -113,11 +118,16 @@ var KNOWN_SHIPPED_OVERLAY_HASHES = /* @__PURE__ */ new Set([
   "6994595e3a62edb6c518006a6bece6848c7077977c041439cf7c822b89304a14",
   "6a42e76fc038ca69ddad18541b8df161770c58980fefaf9e5e80d87407074bec",
   "6a9af9e8a95dbb279347166c43dcee245ca673f9687841086b49911c54944c26",
+  "99fdd85310e658a1c1b0e8f92257493409c28c3d693f24deeaa665861788e1e4",
+  // public registry SoT n8n-workflows/SKILL.md (em dash description)
   "6b66ed7747ea2d19cb457f5af656e3c07f9f563f7f32b3951fa4ae5f27f0ac46",
   "6dede0588274f5b44d833bcc696ec4776eb978ed24a20efdcc9c38caf3df1576",
   "71991a10972b8b956cae93c88517e31741c95e351814082df65e44f813590210",
+  "75ae3018a70ed838428c0e63e8b6901ac05bf1f1cf1845faa6f73c3940d22e4a",
   "75e591bfde61ca1ca3ca1303cc9bc487197af2f713c68f346a46e94ca9432fd5",
   "76ae85bbc336c6f435d9653e8f254ae49774b4ebaecf7335697115933eb8797c",
+  "76c4361e70a73276771e841e2c939253b4124d690a0fd25aff2a3ac636d8f4b0",
+  // mission-kit-comms/SKILL.md
   "79878f0f6f59d1a0b65d94011c0cafe7b6f8e03e89f568aa638b8ba7a2c34076",
   "8108b202c829627c3c2df33575016ebe942df42acf4f1cc393900be3b82b402c",
   "819b7bd3ba9e8bf12dcd4f81a76c98e48261b34c397f339b36d36eb364d9c3f4",
@@ -126,6 +136,7 @@ var KNOWN_SHIPPED_OVERLAY_HASHES = /* @__PURE__ */ new Set([
   "8a11c80b0fbf6c4aabf60eec05b8cca7dccf5bca472787a8afa3028fd8fbedfa",
   "8b25659727063013e8bf6d7925f815b2630c2919b21e6fdac354362bf122bfab",
   "8c7edbacc74b1431fbecb04c9857c0e7a9cb1578fc6ca6367be888dbcec3c98f",
+  "8d8d60e929ebf717eed3c1a29ee0de7c71ae917d125eb1b220a77220597281ed",
   "8ffc181bb152c68a3353309bfdc87c42bdb925b98675cdba959c0cdb90b2adea",
   "91ce0c933e3c8ee81927b8224f944ec5ce5445098a2ad154773092e3541dbf69",
   "9309af07a0a99a56143386b3ddd2a35fae29378fba3f6b4c9297a5d1c02a9724",
@@ -137,6 +148,7 @@ var KNOWN_SHIPPED_OVERLAY_HASHES = /* @__PURE__ */ new Set([
   "9ccf52fe53c6fa4d731650ab4928ce50e201fa34f3e174fee70e3d29867fef2a",
   "9d905aca0123f3018c81c579217104f1749d8da802f3837b2407fbad8f2d803f",
   "9e324c52c1a9d1ceee738bccf47da92910aca9f7a5a21cc41738d9573c414830",
+  "9eb457654167df562481637b25ecd91f0ff3c9282ba79409089d644d3b09b926",
   "a013a6a476160183d6457ff6c1c51ec228bdca359b11eb15cd9b7fc177a705db",
   "a08d04f8efa121ad498f96873778c22630c9172c07c216839e348cd0bb7c2292",
   "a7cd7058bcb6fbd962c37317fa16893bc86a270d0164af5a0e6f3f026aa408ad",
@@ -145,6 +157,8 @@ var KNOWN_SHIPPED_OVERLAY_HASHES = /* @__PURE__ */ new Set([
   "b5c7a10df90d209be07159b7ff9bfa24e869538a0b6026bb5ce79e1cdd5b2528",
   "bd9fd1efacbd132c5dafc12cd0cf2b651a2b1fab7b2d7a9ba4a3e44128097f48",
   "be964ff33a40280e13ce6071fb3e30ce87c374527efbb74c25c9d4534084a634",
+  "c245035b539e41e822fab8c74fcde3b18c45f4b9f26f1c8583fc9e7254249698",
+  "c794accc6668d74a739c982c1b63985a8be4be08afe3766214ab1e08d25ea95c",
   "c96d522be440fbb638dbe953cebf1bb31185c431ac2e14446369cfb7d155a951",
   "cf2bd11891b934484171fa705f470de284e3874402e1e487750735dbc7692857",
   "d0e3bf82efbe32c09761689802ffea7838046dbdd4803b88ead5ec3dfc7efb7e",
@@ -174,11 +188,15 @@ var KNOWN_SHIPPED_OVERLAY_HASHES = /* @__PURE__ */ new Set([
   "f061432a2606049717c0cbf098ef07b1da4df2b136c4cb9cdaa7ea44c876bcd6",
   "f061d36a1180293519fbb560bbf659c621bd90885e995fca6eaf2eda9e418a50",
   "f28731a82f4b394a5765fdefe2d1b667810831f6dcea400ca62bc66e1d65371c",
+  "f43a5484e39aca4e6af86e7f8d2941773cdc1c960838ad88ae3540c49a1097df",
   "f46c108457e4fe12953dca75b409e06fca9cb264baffabe0c0d04c89af471e56",
   "f6bc17efa746680a44bbc49be67ac3f924d9c306c6d937f9959c57a1d3c5b9af",
   "f981764422d468567b5aff31148dc659aeee22cb13dc0ecd873d737deaf07372",
   "fa306a0cdb0f40c817e32164cd03b946564a02b4b7f7c3f4f0b9513096584d28",
-  "fa5cf460eb314437081f7cea30dc8041c0bd6fc3f560a74bc2d7be1bf07384b0"
+  "fa5cf460eb314437081f7cea30dc8041c0bd6fc3f560a74bc2d7be1bf07384b0",
+  "fc39ec6d8a22498697f968ffc0fe5f717bed97afd68f922c76a80ed1f10d6579",
+  "a8756742197c3a2e1a6d64f4bde2a88db48abb66a0f449d625cd2e1c7b8d0cb4",
+  "6a5f8795a4a26b419f167e249576b798781c95308dc1ea50958351de713231d4"
 ]);
 
 // src/lifecycle/paths.ts
@@ -572,18 +590,36 @@ async function readLockOwner(lockDir) {
 }
 async function writeLockOwner(lockDir, owner) {
   const finalPath = lockOwnerPath(lockDir);
-  const tmpPath = path5.join(lockDir, `owner.${owner.uuid}.tmp`);
+  const tmpPath = path5.join(lockDir, `owner.${owner.uuid}.${randomUUID()}.tmp`);
   await writeFile3(tmpPath, JSON.stringify(owner), "utf8");
   await rename(tmpPath, finalPath);
 }
 async function refreshLockOwner(lockDir, uuid) {
   const owner = await readLockOwner(lockDir);
-  if (!owner || owner.uuid !== uuid) return;
-  await writeLockOwner(lockDir, { ...owner, updatedAt: Date.now() });
+  if (owner && owner.uuid !== uuid) return;
+  await writeLockOwner(lockDir, { pid: process.pid, uuid, updatedAt: Date.now() });
 }
 async function releaseCacheLock(lockDir, uuid) {
-  const owner = await readLockOwner(lockDir);
-  if (!owner || owner.uuid !== uuid) {
+  const claimPath = path5.join(lockDir, `releasing.${uuid}`);
+  try {
+    await rename(lockOwnerPath(lockDir), claimPath);
+  } catch {
+    return;
+  }
+  let claimed = null;
+  try {
+    const raw = await readFile4(claimPath, "utf8");
+    const parsed = JSON.parse(raw);
+    if (typeof parsed.pid === "number" && typeof parsed.uuid === "string") {
+      claimed = parsed;
+    }
+  } catch {
+  }
+  if (!claimed || claimed.uuid !== uuid) {
+    try {
+      await rename(claimPath, lockOwnerPath(lockDir));
+    } catch {
+    }
     return;
   }
   try {
@@ -622,12 +658,18 @@ async function acquireCacheLock(cacheDir) {
   const uuid = randomUUID();
   const owner = { pid: process.pid, uuid, updatedAt: Date.now() };
   await mkdir4(path5.dirname(lockDir), { recursive: true });
+  let lastErrorCode;
   while (Date.now() < deadline) {
     try {
       await mkdir4(lockDir, { recursive: false });
       await writeLockOwner(lockDir, owner);
+      let refreshing = false;
       const refreshInterval = setInterval(() => {
+        if (refreshing) return;
+        refreshing = true;
         refreshLockOwner(lockDir, uuid).catch(() => {
+        }).finally(() => {
+          refreshing = false;
         });
       }, LOCK_REFRESH_MS);
       return async () => {
@@ -636,6 +678,7 @@ async function acquireCacheLock(cacheDir) {
       };
     } catch (err) {
       const code = err.code;
+      lastErrorCode = code;
       if (code === "EEXIST") {
         if (await tryReclaimStaleLock(lockDir)) {
           continue;
@@ -644,12 +687,16 @@ async function acquireCacheLock(cacheDir) {
         continue;
       }
       if (code === "ENOENT") {
+        await mkdir4(path5.dirname(lockDir), { recursive: true });
+        await new Promise((r) => setTimeout(r, LOCK_RETRY_MS + Math.random() * 100));
         continue;
       }
       throw err;
     }
   }
-  throw new Error(`Timed out waiting for cache lock on ${cacheDir}. Another install may be stuck.`);
+  throw new Error(
+    lastErrorCode === "ENOENT" ? `Timed out acquiring cache lock on ${cacheDir}: the lock parent directory kept vanishing (concurrent cache clear?).` : `Timed out waiting for cache lock on ${cacheDir}. Another install may be stuck.`
+  );
 }
 var DEFAULT_REGISTRY_URL = "https://github.com/agent-kit-startup/agent-kit";
 var DEFAULT_REGISTRY_REF = "main";
@@ -1835,6 +1882,7 @@ async function resolveInventoryRoot(cwd) {
       return dir;
     } catch {
     }
+    if (await fileExists(path10.join(dir, ".git"))) break;
     const parent = path10.dirname(dir);
     if (parent === dir) break;
     dir = parent;
@@ -2011,12 +2059,16 @@ function baseResult(partial) {
   };
 }
 async function checkCursorUpdateAwareness(cwd, options = {}) {
-  const prefs = readCursorUpdateCheckPrefs(await loadContextConfig(cwd));
+  const inventoryRoot = await resolveInventoryRoot(cwd);
+  const prefs = readCursorUpdateCheckPrefs(
+    inventoryRoot ? await loadContextConfig(inventoryRoot) : null
+  );
   const changelogUrl = options.changelogUrl ?? prefs.changelogUrl;
   if (options.respectPrefs) {
     if (!prefs.enabled) {
       return baseResult({
         status: "skipped-disabled",
+        inventoryRoot,
         inventoryPath: INVENTORY_REL,
         featuresPath: FEATURES_REL,
         changelogUrl,
@@ -2031,6 +2083,7 @@ async function checkCursorUpdateAwareness(cwd, options = {}) {
     if (!intervalElapsed(prefs.lastCheckedAt, prefs.intervalDays)) {
       return baseResult({
         status: "skipped-interval",
+        inventoryRoot,
         inventoryPath: INVENTORY_REL,
         featuresPath: FEATURES_REL,
         changelogUrl,
@@ -2043,10 +2096,10 @@ async function checkCursorUpdateAwareness(cwd, options = {}) {
       });
     }
   }
-  const inventoryRoot = await resolveInventoryRoot(cwd);
   if (!inventoryRoot) {
     return baseResult({
       status: "error",
+      inventoryRoot: null,
       inventoryPath: INVENTORY_REL,
       featuresPath: FEATURES_REL,
       changelogUrl,
@@ -2066,6 +2119,7 @@ async function checkCursorUpdateAwareness(cwd, options = {}) {
   } catch {
     return baseResult({
       status: "error",
+      inventoryRoot,
       inventoryPath: INVENTORY_REL,
       featuresPath: FEATURES_REL,
       changelogUrl,
@@ -2150,6 +2204,7 @@ async function checkCursorUpdateAwareness(cwd, options = {}) {
       const msg = err instanceof Error ? err.message : String(err);
       return baseResult({
         status: "error",
+        inventoryRoot,
         inventoryPath: INVENTORY_REL,
         featuresPath: FEATURES_REL,
         changelogUrl,
@@ -2162,8 +2217,8 @@ async function checkCursorUpdateAwareness(cwd, options = {}) {
       });
     }
   }
-  if (options.stamp) {
-    await stampCursorUpdateCheck(cwd, {
+  if (options.stamp && inventoryRoot) {
+    await stampCursorUpdateCheck(inventoryRoot, {
       lastSeenCursorVersion: latestCursorVersion ?? prefs.lastSeenCursorVersion
     });
   }
@@ -2171,6 +2226,7 @@ async function checkCursorUpdateAwareness(cwd, options = {}) {
   const message = status === "current" ? "No advisory Cursor-update gaps vs inventory (check-only)." : `Found ${gaps.length} advisory gap(s). ${CONVEYOR_HINT}`;
   return baseResult({
     status,
+    inventoryRoot,
     inventoryPath: INVENTORY_REL,
     featuresPath: FEATURES_REL,
     changelogUrl: options.offline ? null : changelogUrl,
@@ -2270,7 +2326,7 @@ var KIT_ROOT_ENV_KEYS = Object.freeze(["MISSION_CONTROL_KIT_ROOT", "AGENT_KIT_HO
 var CONTEXT_CONFIG_REL = ".cursor/context/config.json";
 var CONFIG_PERSONA_IDS = Object.freeze(["autopilot", "night-shift", "ghost-runner"]);
 var CONFIG_PERSONA_MODES = Object.freeze(["continue-plan", "run-plan", "cli-run-plan"]);
-var CONFIG_REVIEW_BACKENDS = Object.freeze(["claude"]);
+var CONFIG_REVIEW_BACKENDS = Object.freeze(["auto", "claude", "cursor"]);
 var CONFIG_REVIEW_MODES = Object.freeze(["paste", "autonomous"]);
 var CONFIG_REVIEW_PREFLIGHT = Object.freeze(["off", "warn", "block"]);
 function resolveContextConfigPath(repoRoot, fsHooks = {}) {
@@ -2367,6 +2423,14 @@ function applyDashboardOpenEnv(env, opts) {
   }
   return next;
 }
+function dashboardSpawnEnv(env, snapshotRoot, opts) {
+  const root = path11.resolve(snapshotRoot);
+  return applyDashboardOpenEnv({ ...env, MISSION_CONTROL_REPO_ROOT: root }, { ...opts, cwd: root });
+}
+function dashboardProcessTitle(snapshotRoot) {
+  const base = path11.basename(path11.resolve(snapshotRoot)) || "workspace";
+  return `Mission Control \xB7 ${base}`;
+}
 function bundledDashboardCandidates(filename, moduleUrl = import.meta.url) {
   const here = path11.dirname(fileURLToPath(moduleUrl));
   return [
@@ -2501,10 +2565,11 @@ var dashboardCommand = defineCommand4({
       process.exitCode = 1;
       return;
     }
-    const env = applyDashboardOpenEnv(
-      { ...process.env, MISSION_CONTROL_REPO_ROOT: snapshotRoot },
-      { noOpen: Boolean(args["no-open"]), browser: args.browser, cwd: snapshotRoot }
-    );
+    const env = dashboardSpawnEnv({ ...process.env }, snapshotRoot, {
+      noOpen: Boolean(args["no-open"]),
+      browser: args.browser
+    });
+    process.title = dashboardProcessTitle(snapshotRoot);
     const code = await runStartScript(startPath, env);
     if (code !== 0) process.exitCode = code;
   }
@@ -2601,10 +2666,11 @@ var dashboardBroadcastCommand = defineCommand5({
       return;
     }
     const snapshotRoot = resolveDashboardSnapshotRoot(args.cwd);
-    const env = applyDashboardOpenEnv(
-      { ...process.env },
-      { noOpen: Boolean(args["no-open"]), browser: args.browser, cwd: snapshotRoot }
-    );
+    const env = dashboardSpawnEnv({ ...process.env }, snapshotRoot, {
+      noOpen: Boolean(args["no-open"]),
+      browser: args.browser
+    });
+    process.title = dashboardProcessTitle(snapshotRoot);
     const code = await runStartScript2(startPath, env);
     if (code !== 0) process.exitCode = code;
   }
@@ -4115,6 +4181,169 @@ async function writeReadinessSnapshot(rootDir, report) {
   return snapshotPath;
 }
 
+// src/welcome/visual-kit.ts
+import { cyan as cyan2, gray, options as koloristOptions } from "kolorist";
+var HELMET_OUTLINE = "#e2e8f0";
+var SPINNER_FRAMES = ["\u280B", "\u2819", "\u2839", "\u2838", "\u283C", "\u2834", "\u2826", "\u2827", "\u2807", "\u280F"];
+var SPACE_MARKS = {
+  star: "\u2726",
+  tick: "\xB7",
+  diamond: "\u2727",
+  visor: "( )"
+};
+var KIT_TIPS = [
+  "Try agent-kit doctor for repository readiness.",
+  "HITL gates stay in Cursor slash commands.",
+  "/run-plan never promotes to production.",
+  "Mission Control is the dashboard, not the CLI name.",
+  "NO_COLOR and CI keep this output static.",
+  "agent-kit --help groups SETUP, MISSION, DASHBOARD, INTEGRITY."
+];
+function shouldUseWelcomeColor(opts = {}) {
+  if (opts.color === false) return false;
+  if (process.env.NO_COLOR) return false;
+  if (process.env.NODE_DISABLE_COLORS) return false;
+  if (process.env.FORCE_COLOR === "0") return false;
+  if (process.env.CI != null && process.env.CI !== "") return false;
+  if (opts.color === true) return true;
+  const tty = opts.stdoutIsTTY ?? Boolean(process.stdout.isTTY);
+  return tty;
+}
+function shouldUseVisualMotion(opts = {}) {
+  if (process.env.AGENT_KIT_REDUCED_MOTION === "1") return false;
+  return shouldUseWelcomeColor(opts);
+}
+function spinnerFrame(index) {
+  const n = SPINNER_FRAMES.length;
+  return SPINNER_FRAMES[(index % n + n) % n] ?? SPINNER_FRAMES[0];
+}
+function tipAt(index) {
+  const n = KIT_TIPS.length;
+  return KIT_TIPS[(index % n + n) % n] ?? KIT_TIPS[0];
+}
+function wrapNarrow(text, columns) {
+  const width = Math.max(8, Number.isFinite(columns) ? Math.floor(columns) : 80);
+  const words = text.trim().split(/\s+/).filter(Boolean);
+  if (words.length === 0) return "";
+  const lines = [];
+  let current = "";
+  for (const word of words) {
+    if (word.length > width) {
+      if (current) {
+        lines.push(current);
+        current = "";
+      }
+      for (let i = 0; i < word.length; i += width) {
+        const chunk = word.slice(i, i + width);
+        if (i + width >= word.length) current = chunk;
+        else lines.push(chunk);
+      }
+      continue;
+    }
+    const next = current ? `${current} ${word}` : word;
+    if (next.length > width) {
+      lines.push(current);
+      current = word;
+    } else {
+      current = next;
+    }
+  }
+  if (current) lines.push(current);
+  return lines.join("\n");
+}
+function renderProgressLine(opts) {
+  const motion = opts.motion ?? shouldUseVisualMotion();
+  const color = opts.color ?? shouldUseWelcomeColor();
+  const mark = motion ? spinnerFrame(opts.frameIndex) : SPACE_MARKS.tick;
+  const tip = tipAt(opts.tipIndex);
+  const label = opts.label?.trim() ?? "";
+  const raw = label ? `${mark} ${label} ${SPACE_MARKS.star} ${tip}` : `${mark} ${tip}`;
+  const cols = opts.columns ?? process.stdout.columns ?? 80;
+  const wrapped = wrapNarrow(raw, cols);
+  if (!color) return wrapped;
+  const prevEnabled = koloristOptions.enabled;
+  koloristOptions.enabled = true;
+  try {
+    return wrapped.split("\n").map((line, i) => i === 0 ? cyan2(line) : gray(line)).join("\n");
+  } finally {
+    koloristOptions.enabled = prevEnabled;
+  }
+}
+var TtySpinner = class {
+  timer = null;
+  frame = 0;
+  startedAt = 0;
+  label = "";
+  write;
+  columns;
+  motion;
+  color;
+  intervalMs;
+  now;
+  constructor(opts = {}) {
+    this.write = opts.write ?? ((chunk) => process.stdout.write(chunk));
+    this.columns = opts.columns ?? (() => process.stdout.columns ?? 80);
+    this.motion = opts.motion ?? shouldUseVisualMotion();
+    this.color = opts.color ?? shouldUseWelcomeColor();
+    this.intervalMs = opts.intervalMs ?? 80;
+    this.now = opts.now ?? (() => Date.now());
+  }
+  start(label = "") {
+    this.stop();
+    this.label = label;
+    this.frame = 0;
+    this.startedAt = this.now();
+    this.paint(false);
+    if (!this.motion) return;
+    this.timer = setInterval(() => {
+      this.frame += 1;
+      this.paint(true);
+    }, this.intervalMs);
+    this.timer.unref?.();
+  }
+  stop(finalLine) {
+    if (this.timer) {
+      clearInterval(this.timer);
+      this.timer = null;
+    }
+    if (this.motion) this.write("\r\x1B[K");
+    if (finalLine) this.write(`${finalLine}
+`);
+  }
+  paint(overwrite) {
+    const elapsed = this.now() - this.startedAt;
+    const tipIndex = Math.floor(elapsed / 4e3);
+    const line = renderProgressLine({
+      frameIndex: this.frame,
+      tipIndex,
+      columns: this.columns(),
+      label: this.label,
+      motion: this.motion,
+      color: this.color
+    }).split("\n")[0] ?? "";
+    if (overwrite && this.motion) this.write(`\r\x1B[K${line}`);
+    else if (this.motion) this.write(line);
+    else this.write(`${line}
+`);
+  }
+};
+async function withCliProgress(label, fn, opts) {
+  const motion = opts?.motion ?? shouldUseVisualMotion();
+  if (!motion) {
+    return fn();
+  }
+  const spinner = new TtySpinner({ ...opts, motion: true });
+  spinner.start(label);
+  try {
+    const result = await fn();
+    spinner.stop();
+    return result;
+  } catch (err) {
+    spinner.stop();
+    throw err;
+  }
+}
+
 // src/commands/doctor.ts
 async function runDoctor(cwd, options = {}) {
   const rootDir = path24.resolve(cwd);
@@ -4188,7 +4417,8 @@ var doctorCommand = defineCommand7({
     }
   },
   async run({ args }) {
-    const result = await runDoctor(args.cwd, { fixSafe: args["fix-safe"] });
+    const run = () => runDoctor(args.cwd, { fixSafe: args["fix-safe"] });
+    const result = args.json ? await run() : await withCliProgress("doctor", run);
     if (args.json) {
       console.log(JSON.stringify(result, null, 2));
       return;
@@ -4818,11 +5048,19 @@ async function fileExists2(p) {
     return false;
   }
 }
+function isMarkdownTableSeparator(line) {
+  const stripped = line.trim();
+  if (!stripped.startsWith("|")) return false;
+  const parts = stripped.replace(/^\|/, "").replace(/\|$/, "").split("|").map((cell) => cell.trim());
+  return parts.length > 0 && parts.every((cell) => /^:?-+:?$/.test(cell));
+}
 function parseUnprocessedDogfoodItems(readmeText) {
   const items = [];
   let inSection = false;
   let sectionLevel = 0;
-  for (const line of readmeText.split(/\r?\n/)) {
+  const lines = readmeText.split(/\r?\n/);
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i] ?? "";
     const unprocessedMatch = /^(#{2,3})\s+Unprocessed Files\b/.exec(line);
     if (unprocessedMatch) {
       const hashes = unprocessedMatch[1];
@@ -4834,11 +5072,14 @@ function parseUnprocessedDogfoodItems(readmeText) {
     if (!inSection) continue;
     const headingMatch = /^(#{1,6})\s+/.exec(line);
     if (headingMatch) {
-      if (/\bProcessed Files\b/.test(line)) break;
+      if (/^#{1,6}\s+Processed(?:\s+Files)?\b/.test(line)) break;
       const hashes = headingMatch[1];
       if (hashes && hashes.length <= sectionLevel) break;
       continue;
     }
+    if (line.trim().startsWith("|") && isMarkdownTableSeparator(lines[i + 1] ?? "")) {
+      continue;
+    }
     const body = extractUnprocessedDogfoodLine(line);
     if (!body) continue;
     items.push(body);
@@ -4856,13 +5097,10 @@ function extractUnprocessedDogfoodLine(line) {
     if (numbered?.[2]) {
       raw = numbered[2].trim();
     } else if (stripped.startsWith("|")) {
+      if (isMarkdownTableSeparator(stripped)) return null;
       const parts = stripped.replace(/^\|/, "").replace(/\|$/, "").split("|").map((cell) => cell.trim());
       if (parts.length === 0) return null;
-      if (parts.every((cell) => /^:?-+:?$/.test(cell))) return null;
-      const first = parts[0] ?? "";
-      const headerish = first.toLowerCase().replace(/[*_`]/g, "").trim();
-      if (/^(note|file|entrada|title|name|item|path)$/.test(headerish)) return null;
-      raw = first.trim();
+      raw = (parts[0] ?? "").trim();
     }
   }
   if (!raw) return null;
@@ -5340,16 +5578,83 @@ function classifyInstallError(err) {
 }
 
 // src/commands/install.ts
-import path32 from "path";
+import path33 from "path";
 import { defineCommand as defineCommand11 } from "citty";
 
 // src/generator/personalization.ts
-import { readFile as readFile15, writeFile as writeFile8 } from "fs/promises";
-import path30 from "path";
+import { readFile as readFile15, writeFile as writeFile9 } from "fs/promises";
+import path31 from "path";
 
-// src/generator/vscode.ts
+// src/generator/claude-kit-load.ts
 import { writeFile as writeFile7 } from "fs/promises";
 import path29 from "path";
+var CLAUDE_MD_REL = "CLAUDE.md";
+var AGENT_KIT_COMMAND_REL = ".claude/commands/agent-kit.md";
+function renderClaudeMd() {
+  return `# Agent Kit (Claude Code)
+
+This repository uses Agent Kit / Mission Control. Before rediscovering the tree, read the shared sources of truth (paths below are pointers; do not treat this file as a second rulebook).
+
+## Read first
+
+1. \`AGENTS.md\` - cross-IDE contract
+2. \`.cursor/project-context.md\` - verified repository facts (derived; prefer code, tests, SHAs when docs conflict)
+3. \`.cursor/HANDOFF.md\` - if present: active plan, next to-do, queue fields
+4. \`.cursor/commands/\` - slash catalog (Cursor). Follow the same HITL contracts here.
+
+Mid-session refresh: \`/agent-kit\`.
+
+## HITL
+
+Cursor Ask questions is not available in this CLI. When a command requires a choice, list the same labels as a numbered list and wait. Skip or cancel means stop. Never \`/git-prod\` without an explicit operator yes.
+
+## Non-goals
+
+- Not Action A7 (Windsurf / VS Code generator parity)
+- Not Claude external plan-review audits (\`/plan-external-review\`)
+- Not \`--backend claude\` plan-loop ticks
+- Not a copy of Cursor \`sessionStart\` / other IDE hooks
+`;
+}
+function renderAgentKitCommand() {
+  return `---
+description: Load Agent Kit session context (HANDOFF, project-context, commands). Manual refresh only.
+disable-model-invocation: true
+---
+
+Read these files if they exist, then summarize the active plan, next to-do, and any Gaps. Do not scan the whole repository first.
+
+1. \`AGENTS.md\`
+2. \`.cursor/project-context.md\`
+3. \`.cursor/HANDOFF.md\`
+4. The plan file named in HANDOFF \`- **Plan:**\` under \`.cursor/plans/\`
+
+If HANDOFF is missing, say so and point at \`/agent-kit-onboard\` or \`/start-project\` rather than inventing a plan.
+
+HITL: numbered-list fallback for Ask questions labels. Never \`/git-prod\` from this skill.
+
+Non-goals: not audits / \`/plan-external-review\`, not \`--backend claude\` ticks, not A7, not Cursor hook clones.
+`;
+}
+async function writeUnlessExists(rootDir, relativePath, content) {
+  const target = path29.join(rootDir, relativePath);
+  if (await fileExists(target)) {
+    return { relativePath, status: "skipped-customized" };
+  }
+  await ensureDir(path29.dirname(target));
+  await writeFile7(target, content, "utf8");
+  return { relativePath, status: "applied" };
+}
+async function generateClaudeKitLoadArtifacts(rootDir) {
+  return Promise.all([
+    writeUnlessExists(rootDir, CLAUDE_MD_REL, renderClaudeMd()),
+    writeUnlessExists(rootDir, AGENT_KIT_COMMAND_REL, renderAgentKitCommand())
+  ]);
+}
+
+// src/generator/vscode.ts
+import { writeFile as writeFile8 } from "fs/promises";
+import path30 from "path";
 
 // src/generator/platform.ts
 function gitProviderLabel(profile) {
@@ -5373,14 +5678,14 @@ function prTerminology(profile) {
 // src/generator/vscode.ts
 async function generateVSCodeArtifacts(profile) {
   const results = [];
-  const vscodeDir = path29.join(profile.rootDir, ".vscode");
-  const githubDir = path29.join(profile.rootDir, ".github");
+  const vscodeDir = path30.join(profile.rootDir, ".vscode");
+  const githubDir = path30.join(profile.rootDir, ".github");
   await Promise.all([ensureDir(vscodeDir), ensureDir(githubDir)]);
-  const settingsPath = path29.join(vscodeDir, "settings.json");
+  const settingsPath = path30.join(vscodeDir, "settings.json");
   if (await fileExists(settingsPath)) {
     results.push({ relativePath: ".vscode/settings.json", status: "skipped-customized" });
   } else {
-    await writeFile7(
+    await writeFile8(
       settingsPath,
       `${JSON.stringify(
         {
@@ -5400,11 +5705,11 @@ async function generateVSCodeArtifacts(profile) {
   }
   const provider = gitProviderLabel(profile);
   const prTerm = prTerminology(profile);
-  const copilotPath = path29.join(githubDir, "copilot-instructions.md");
+  const copilotPath = path30.join(githubDir, "copilot-instructions.md");
   if (await fileExists(copilotPath)) {
     results.push({ relativePath: ".github/copilot-instructions.md", status: "skipped-customized" });
   } else {
-    await writeFile7(
+    await writeFile8(
       copilotPath,
       `# Copilot Instructions
 
@@ -5418,14 +5723,14 @@ async function generateVSCodeArtifacts(profile) {
     results.push({ relativePath: ".github/copilot-instructions.md", status: "applied" });
   }
   if (profile.ide.plan === "vscode-pro") {
-    const securityPath = path29.join(vscodeDir, "security-review.agent.md");
+    const securityPath = path30.join(vscodeDir, "security-review.agent.md");
     if (await fileExists(securityPath)) {
       results.push({
         relativePath: ".vscode/security-review.agent.md",
         status: "skipped-customized"
       });
     } else {
-      await writeFile7(
+      await writeFile8(
         securityPath,
         "# Security Review Agent\n\nSpecialized mode for security review.\n",
         "utf8"
@@ -5561,7 +5866,40 @@ function buildPersonalizationPlan(profile, report, registry) {
     (item) => componentAvailable(registry, item) ? item : { ...item, status: "unavailable" }
   ).sort((left, right) => `${left.kind}:${left.id}`.localeCompare(`${right.kind}:${right.id}`));
 }
-function renderProjectContext(profile) {
+var INSTALLED_SKILL_STATUSES = /* @__PURE__ */ new Set(["applied", "skipped-customized"]);
+function installedSkillItems(items, installedIds = []) {
+  const rows = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const item of items) {
+    if (item.kind !== "skill" || !INSTALLED_SKILL_STATUSES.has(item.status)) continue;
+    if (seen.has(item.id)) continue;
+    seen.add(item.id);
+    rows.push(item);
+  }
+  for (const id of installedIds) {
+    if (seen.has(id)) continue;
+    seen.add(id);
+    rows.push({
+      kind: "skill",
+      id,
+      status: "applied",
+      evidence: [{ source: "configuration", value: `.cursor/agent-kit.json skills[]:${id}` }]
+    });
+  }
+  return rows.sort((left, right) => left.id.localeCompare(right.id));
+}
+function relevantSkillTableRows(skills) {
+  if (skills.length === 0) {
+    return ["| (none yet) | No installed or project-owned skills detected | \u2014 |"];
+  }
+  return skills.map((skill) => {
+    const label = skill.path ?? skill.id;
+    const role = skill.status === "skipped-customized" ? "Already present (customized)" : "Installed by personalization";
+    const evidence = skill.path ?? skill.evidence[0]?.value ?? "personalization";
+    return `| ${label} | ${role} | ${evidence} |`;
+  });
+}
+function renderProjectContext(profile, skillItems = []) {
   const sections = ["# Project Context", "", "Verified repository facts:"];
   const purpose = purposeEvidence(profile);
   if (purpose.length > 0 && profile.purpose.value !== "unknown") {
@@ -5588,7 +5926,7 @@ function renderProjectContext(profile) {
     "",
     "| Skill / path | Role | Evidence |",
     "|--------------|------|----------|",
-    "| (none yet) | Add rows when `/agent-kit-onboard` scaffolds domain skills or personalization installs packs | \u2014 |"
+    ...relevantSkillTableRows(installedSkillItems(skillItems))
   );
   if (profile.context.sources.length > 0) {
     sections.push("", "## Sources", ...profile.context.sources.map((item) => `- ${item.value}`));
@@ -5597,7 +5935,7 @@ function renderProjectContext(profile) {
 `;
 }
 async function createOwnedFile(rootDir, relativePath, content, evidence) {
-  const target = path30.join(rootDir, relativePath);
+  const target = path31.join(rootDir, relativePath);
   if (await fileExists(target)) {
     return {
       kind: "file",
@@ -5607,8 +5945,8 @@ async function createOwnedFile(rootDir, relativePath, content, evidence) {
       evidence
     };
   }
-  await ensureDir(path30.dirname(target));
-  await writeFile8(target, content, "utf8");
+  await ensureDir(path31.dirname(target));
+  await writeFile9(target, content, "utf8");
   return {
     kind: "file",
     id: relativePath,
@@ -5624,7 +5962,7 @@ async function packTargets(registryRoot, packId) {
 async function existingTargets(projectRoot, targets) {
   const checks = await Promise.all(
     targets.map(
-      async (target) => await fileExists(path30.join(projectRoot, target)) ? target : null
+      async (target) => await fileExists(path31.join(projectRoot, target)) ? target : null
     )
   );
   return checks.filter((target) => target !== null);
@@ -5646,14 +5984,14 @@ async function applyPersonalization(input) {
         componentResults.push({ ...item, status: "unavailable" });
         continue;
       }
-      const target = path30.posix.join(
+      const target = path31.posix.join(
         ".cursor",
         "skills",
         skill.path.includes("/core/") ? "core" : "community",
         skill.id,
         "SKILL.md"
       );
-      if (await fileExists(path30.join(input.rootDir, target))) {
+      if (await fileExists(path31.join(input.rootDir, target))) {
         componentResults.push({ ...item, status: "skipped-customized", path: target });
         protectedPaths.add(target);
         continue;
@@ -5689,7 +6027,7 @@ async function applyPersonalization(input) {
     createOwnedFile(
       input.rootDir,
       CONTEXT_PATH,
-      renderProjectContext(input.profile),
+      renderProjectContext(input.profile, installedSkillItems(componentResults, skills)),
       profileEvidence
     ),
     createOwnedFile(
@@ -5701,6 +6039,17 @@ async function applyPersonalization(input) {
   ]);
   protectedPaths.add(CONTEXT_PATH);
   protectedPaths.add(AGENTS_PATH);
+  const claudeResults = await generateClaudeKitLoadArtifacts(input.rootDir);
+  const claudeItems = claudeResults.map((artifact) => {
+    protectedPaths.add(artifact.relativePath);
+    return {
+      kind: "file",
+      id: artifact.relativePath,
+      path: artifact.relativePath,
+      status: artifact.status,
+      evidence: profileEvidence
+    };
+  });
   const ideDetection = await detectIde(input.rootDir);
   if (ideDetection.ide === "vscode" || ideDetection.ide === "other") {
     const git = {
@@ -5748,10 +6097,10 @@ async function applyPersonalization(input) {
     contractVersion: PERSONALIZATION_CONTRACT_VERSION,
     generatorVersion: input.generatorVersion,
     repositoryFingerprint: input.report.repositoryFingerprint,
-    items: [...fileResults, ...componentResults],
+    items: [...fileResults, ...claudeItems, ...componentResults],
     protectedPaths: [...protectedPaths].sort()
   };
-  await writeJson(path30.join(input.rootDir, RESULT_PATH), result);
+  await writeJson(path31.join(input.rootDir, RESULT_PATH), result);
   return {
     result,
     manifest: {
@@ -5769,7 +6118,7 @@ async function applyPersonalization(input) {
   };
 }
 async function readRepositoryProfile(rootDir) {
-  const target = path30.join(rootDir, ".cursor/agent-kit.config.json");
+  const target = path31.join(rootDir, ".cursor/agent-kit.config.json");
   if (!await fileExists(target)) return null;
   return JSON.parse(await readFile15(target, "utf8"));
 }
@@ -5777,16 +6126,16 @@ async function readRepositoryProfile(rootDir) {
 // src/lifecycle/onboard-migration.ts
 import { createHash as createHash4 } from "crypto";
 import { readFile as readFile16, unlink } from "fs/promises";
-import path31 from "path";
+import path32 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 = path31.join(projectRoot, LEGACY_ONBOARD_PATH);
+  const legacyPath = path32.join(projectRoot, LEGACY_ONBOARD_PATH);
   if (!await fileExists(legacyPath)) return "absent";
-  const namespacedPath = path31.join(projectRoot, NAMESPACED_ONBOARD_PATH);
+  const namespacedPath = path32.join(projectRoot, NAMESPACED_ONBOARD_PATH);
   if (!await fileExists(namespacedPath)) return "preserved-customized";
   const content = await readFile16(legacyPath);
   const hash = createHash4("sha256").update(content).digest("hex");
@@ -5861,7 +6210,7 @@ function printReadinessNarrative(result) {
   );
 }
 async function performInstall(options) {
-  const projectRoot = path32.resolve(options.cwd);
+  const projectRoot = path33.resolve(options.cwd);
   const packs = parsePackList(options.pack);
   const existing = await loadAgentKitManifest(projectRoot);
   const registry = await resolveRegistryFromCli({
@@ -5979,15 +6328,18 @@ var installCommand = defineCommand11({
       }
     }
     try {
-      const result = await performInstall({
-        cwd: projectRoot,
-        profile: args.profile,
-        pack: args.pack,
-        registry: args.registry,
-        url: args.url,
-        ref: args.ref,
-        refresh: args.refresh
-      });
+      const result = await withCliProgress(
+        "install",
+        () => performInstall({
+          cwd: projectRoot,
+          profile: args.profile,
+          pack: args.pack,
+          registry: args.registry,
+          url: args.url,
+          ref: args.ref,
+          refresh: args.refresh
+        })
+      );
       logApplyStats(result.stats);
       logger.success(`Manifest written: ${result.manifestPath}`);
       logger.success("Readiness snapshot written: .cursor/context/readiness.json");
@@ -5998,7 +6350,8 @@ var installCommand = defineCommand11({
       console.error(`
 ${hint.recovery}
 `);
-      process.exit(1);
+      process.exitCode = 1;
+      return;
     }
   }
 });
@@ -6028,7 +6381,7 @@ var initCommand = defineCommand12({
     }
     logger.info("init now uses the canonical install and readiness workflow.");
     try {
-      const result = await runInitCompatibility(args.cwd);
+      const result = await withCliProgress("init", () => runInitCompatibility(args.cwd));
       const pending = result.readiness.pendingActions.length;
       logger.success(`L0 and readiness prepared in ${result.projectRoot}`);
       const nextStep = pending > 0 ? "Next: run /agent-kit-onboard in Cursor to resolve the first pending action." : "Next: run /start-project in Cursor when you have a deliverable.";
@@ -6049,13 +6402,13 @@ ${hint.recovery}
 });
 
 // src/commands/monitors.ts
-import path34 from "path";
+import path35 from "path";
 import { defineCommand as defineCommand13 } from "citty";
 
 // src/invariants/monitors-untriaged.ts
 import { execFile as execFile5 } from "child_process";
 import { readFile as readFile17, readdir as readdir5, stat as stat3 } from "fs/promises";
-import path33 from "path";
+import path34 from "path";
 import { promisify as promisify5 } from "util";
 
 // src/invariants/triage-heading.ts
@@ -6096,7 +6449,7 @@ async function gitFreshMonitorNames(rootDir) {
     for (const line of stdout.split("\n")) {
       if (!line.trim()) continue;
       const file = line.slice(3).trim().replace(/^.* -> /, "");
-      const base = path33.basename(file);
+      const base = path34.basename(file);
       if (base.startsWith("plan-monitor-") && base.endsWith(".md")) {
         names.add(base);
       }
@@ -6119,13 +6472,13 @@ function monitorSlugFromName(fileName) {
   return fileName.replace(/^plan-monitor-/, "").replace(/\.md$/, "").toLowerCase();
 }
 async function selectUntriagedMonitors(rootDir) {
-  const root = path33.resolve(rootDir);
-  const memoryDir = path33.join(root, ".cursor", "memory");
+  const root = path34.resolve(rootDir);
+  const memoryDir = path34.join(root, ".cursor", "memory");
   const allNames = await listMonitorFiles(memoryDir);
   const selectionOrder = ["git-fresh", "handoff-aligned", "untriaged-scan"];
   const byName = /* @__PURE__ */ new Map();
   for (const name of allNames) {
-    const abs = path33.join(memoryDir, name);
+    const abs = path34.join(memoryDir, name);
     try {
       const [content, st] = await Promise.all([readFile17(abs, "utf8"), stat3(abs)]);
       byName.set(name, { content, mtimeMs: st.mtimeMs });
@@ -6140,7 +6493,7 @@ async function selectUntriagedMonitors(rootDir) {
   const gitFreshSet = [...gitFresh].filter(untriaged).sort();
   let handoff = "";
   try {
-    handoff = await readFile17(path33.join(root, ".cursor", "HANDOFF.md"), "utf8");
+    handoff = await readFile17(path34.join(root, ".cursor", "HANDOFF.md"), "utf8");
   } catch {
     handoff = "";
   }
@@ -6160,8 +6513,8 @@ async function selectUntriagedMonitors(rootDir) {
     const row = byName.get(name);
     if (!row) continue;
     entries.push({
-      path: path33.join(memoryDir, name),
-      relativePath: path33.relative(root, path33.join(memoryDir, name)).split(path33.sep).join("/"),
+      path: path34.join(memoryDir, name),
+      relativePath: path34.relative(root, path34.join(memoryDir, name)).split(path34.sep).join("/"),
       mtimeMs: row.mtimeMs,
       hasTriageHeading: false,
       hasOpenGaps: hasOpenGaps(row.content),
@@ -6207,7 +6560,7 @@ var monitorsCommand = defineCommand13({
       process.exitCode = 2;
       return;
     }
-    const result = await selectUntriagedMonitors(path34.resolve(args.cwd));
+    const result = await selectUntriagedMonitors(path35.resolve(args.cwd));
     if (args.json) {
       console.log(JSON.stringify(result, null, 2));
       return;
@@ -6223,7 +6576,7 @@ var monitorsCommand = defineCommand13({
 });
 
 // src/commands/run-plan.ts
-import path39 from "path";
+import path40 from "path";
 import { defineCommand as defineCommand14 } from "citty";
 
 // src/plan-loop/backends.ts
@@ -6309,13 +6662,13 @@ function listBackendIds() {
 
 // src/plan-loop/run-loop.ts
 import { mkdir as mkdir6, readFile as readFile20, rm as rm2, unlink as unlink2 } from "fs/promises";
-import path38 from "path";
+import path39 from "path";
 
 // src/plan-loop/external-review.ts
 import { spawn as spawn7 } from "child_process";
-import path35 from "path";
-var CANONICAL_REL = path35.join(".cursor", "scripts", "plan-external-review.sh");
-var FALLBACK_REL = path35.join("scripts", "plan-external-review.sh");
+import path36 from "path";
+var CANONICAL_REL = path36.join(".cursor", "scripts", "plan-external-review.sh");
+var FALLBACK_REL = path36.join("scripts", "plan-external-review.sh");
 function isPlanExhaustedReason(reason) {
   const r = reason.trim().toLowerCase();
   if (!r) return false;
@@ -6337,8 +6690,8 @@ async function armExternalPlanReview(root, options = {}) {
   const existsFn = options.existsFn ?? fileExists;
   const log = options.log ?? ((line) => console.log(line));
   const force = options.force === true;
-  const canonicalPath = path35.join(root, CANONICAL_REL);
-  const fallbackPath = path35.join(root, FALLBACK_REL);
+  const canonicalPath = path36.join(root, CANONICAL_REL);
+  const fallbackPath = path36.join(root, FALLBACK_REL);
   let scriptPath = null;
   let scriptRel = CANONICAL_REL;
   if (await existsFn(canonicalPath)) {
@@ -6391,11 +6744,11 @@ async function armExternalPlanReview(root, options = {}) {
 }
 
 // src/plan-loop/persona-banners.ts
-import path36 from "path";
+import path37 from "path";
 import {
   blue,
-  cyan as cyan2,
-  gray,
+  cyan as cyan3,
+  gray as gray2,
   green as green2,
   lightGray,
   lightGreen,
@@ -6408,9 +6761,9 @@ var CLI_RUN_PLAN_MODE = "cli-run-plan";
 var DEFAULT_CLI_PERSONA_ID = "ghost-runner";
 var COLORS = {
   white,
-  gray,
+  gray: gray2,
   green: green2,
-  cyan: cyan2,
+  cyan: cyan3,
   magenta,
   yellow: yellow2,
   red: red2,
@@ -6427,7 +6780,7 @@ function resolveColor(name, fallback) {
 async function resolveCliPersonaId(root) {
   try {
     const cfg = await readJson(
-      path36.join(root, ".cursor", "context", "config.json")
+      path37.join(root, ".cursor", "context", "config.json")
     );
     const modes = cfg?.agentPersona?.modes ?? cfg?.workspaceSkin?.modes;
     const id = modes?.[CLI_RUN_PLAN_MODE];
@@ -6438,7 +6791,7 @@ async function resolveCliPersonaId(root) {
 }
 async function loadPersonaPack(root, personaId) {
   try {
-    const personaPath = path36.join(root, "registry", "personas", "core", personaId, "persona.json");
+    const personaPath = path37.join(root, "registry", "personas", "core", personaId, "persona.json");
     const pack = await readJson(personaPath);
     if (!pack || typeof pack.id !== "string") return null;
     return pack;
@@ -6455,7 +6808,7 @@ function createPersonaBannerPrinter(persona) {
   const banners = persona.cliBanners;
   if (!banners.tickStart && !banners.tickEnd && !banners.phaseComplete) return null;
   const primary = resolveColor(persona.ansiPalette?.primary, white);
-  const secondary = resolveColor(persona.ansiPalette?.secondary, gray);
+  const secondary = resolveColor(persona.ansiPalette?.secondary, gray2);
   const accent = resolveColor(persona.ansiPalette?.accent, green2);
   return {
     tickStart(detail) {
@@ -6488,7 +6841,7 @@ function createPersonaBannerPrinter(persona) {
 
 // src/plan-loop/plan-state.ts
 import { readFile as readFile18, readdir as readdir6 } from "fs/promises";
-import path37 from "path";
+import path38 from "path";
 function countPendingTodos(raw) {
   const lines = raw.split(/\r?\n/);
   let inFront = 0;
@@ -6516,7 +6869,7 @@ function countPendingTodos(raw) {
 async function findActivePlanFile(plansDir) {
   if (!await fileExists(plansDir)) return null;
   const files = (await readdir6(plansDir)).filter((f) => f.endsWith(".plan.md")).sort();
-  return files[0] ? path37.join(plansDir, files[0]) : null;
+  return files[0] ? path38.join(plansDir, files[0]) : null;
 }
 async function readPlan(planPath) {
   return readFile18(planPath, "utf8");
@@ -6593,9 +6946,9 @@ function sleep(ms) {
   return new Promise((r) => setTimeout(r, ms));
 }
 async function runPlanLoop(opts) {
-  const plansDir = path38.join(opts.root, ".cursor", "plans");
-  const stopFile = path38.join(opts.root, ".cursor", "loop.stop");
-  const logDir = path38.join(opts.root, ".cursor", "loop-logs");
+  const plansDir = path39.join(opts.root, ".cursor", "plans");
+  const stopFile = path39.join(opts.root, ".cursor", "loop.stop");
+  const logDir = path39.join(opts.root, ".cursor", "loop-logs");
   const planPath = await findActivePlanFile(plansDir);
   if (!planPath) {
     logger.error("No active plan in .cursor/plans/");
@@ -6616,7 +6969,7 @@ async function runPlanLoop(opts) {
   try {
     const persona = await loadCliRunPlanPersona(opts.root);
     const banners = createPersonaBannerPrinter(persona);
-    console.log(`Active plan: ${path38.basename(planPath)}`);
+    console.log(`Active plan: ${path39.basename(planPath)}`);
     console.log(`Pending to-dos: ${await pending()} | max ticks: ${opts.maxTicks}`);
     console.log(`Backend: ${opts.backend.id}`);
     if (persona) {
@@ -6659,20 +7012,23 @@ async function runPlanLoop(opts) {
         planExhausted = true;
         break;
       }
-      const logPath = path38.join(logDir, `tick-${stamp()}.log`);
-      const relLog = path38.relative(opts.root, logPath);
+      const logPath = path39.join(logDir, `tick-${stamp()}.log`);
+      const relLog = path39.relative(opts.root, logPath);
       console.log("");
       const tickLine = `=== tick ${tick}/${opts.maxTicks} - pending: ${before} - log: ${relLog} ===`;
       if (banners) banners.tickStart(tickLine);
       else console.log(tickLine);
       let agentExit = 0;
       try {
-        const result = await opts.backend.run({
-          workspace: opts.root,
-          prompt: TICK_PROMPT,
-          model: opts.model,
-          logPath
-        });
+        const result = await withCliProgress(
+          `tick ${tick}`,
+          () => opts.backend.run({
+            workspace: opts.root,
+            prompt: TICK_PROMPT,
+            model: opts.model,
+            logPath
+          })
+        );
         agentExit = result.exitCode;
       } catch (err) {
         logger.error(String(err));
@@ -6728,7 +7084,7 @@ async function runPlanLoop(opts) {
       }
       if (opts.sleepSeconds > 0) {
         if (banners) banners.sleep(opts.sleepSeconds);
-        await sleep(opts.sleepSeconds * 1e3);
+        await withCliProgress(`sleep ${opts.sleepSeconds}s`, () => sleep(opts.sleepSeconds * 1e3));
       }
     }
     const pendingNow = await pending();
@@ -6736,7 +7092,7 @@ async function runPlanLoop(opts) {
     const finishDetail = `after ${tick} tick(s); pending: ${pendingNow}`;
     if (banners) banners.phaseComplete(finishDetail);
     console.log(
-      `Loop finished after ${tick} tick(s). Pending now: ${pendingNow}. Logs in ${path38.relative(opts.root, logDir)}/`
+      `Loop finished after ${tick} tick(s). Pending now: ${pendingNow}. Logs in ${path39.relative(opts.root, logDir)}/`
     );
     if (planExhausted || shouldArmExternalPlanReview({ pending: pendingNow, stopReason })) {
       await armExternalPlanReview(opts.root);
@@ -6807,7 +7163,7 @@ var runPlanCommand = defineCommand14({
       return;
     }
     const code = await runPlanLoop({
-      root: path39.resolve(args.cwd),
+      root: path40.resolve(args.cwd),
       maxTicks,
       sleepSeconds,
       model: args.model ? String(args.model) : void 0,
@@ -6841,7 +7197,7 @@ var scanCommand = defineCommand15({
 });
 
 // src/commands/status.ts
-import path40 from "path";
+import path41 from "path";
 import { defineCommand as defineCommand16 } from "citty";
 function profileStatus(profile) {
   if (!profile) return { origin: "none", evidence: [], profile: null };
@@ -6872,11 +7228,11 @@ var statusCommand = defineCommand16({
     }
   },
   async run({ args }) {
-    const rootDir = path40.resolve(args.cwd);
+    const rootDir = path41.resolve(args.cwd);
     const [manifest, rawProfile, scan] = await Promise.all([
       loadAgentKitManifest(rootDir),
       readJson(
-        path40.join(rootDir, ".cursor", "agent-kit.config.json")
+        path41.join(rootDir, ".cursor", "agent-kit.config.json")
       ),
       runScanner(rootDir)
     ]);
@@ -6935,7 +7291,7 @@ import { defineCommand as defineCommand17 } from "citty";
 
 // src/lifecycle/check-updates.ts
 import { execFile as execFile6 } from "child_process";
-import path41 from "path";
+import path42 from "path";
 import { promisify as promisify6 } from "util";
 var execFileAsync5 = promisify6(execFile6);
 var SEMVER_CORE = /^v?(\d+)\.(\d+)\.(\d+)(?:[-+].*)?$/i;
@@ -7026,11 +7382,11 @@ function intervalElapsed2(lastCheckedAt, intervalDays) {
   return Date.now() - last >= ms;
 }
 async function loadContextConfig2(cwd) {
-  const configPath = path41.join(cwd, ".cursor", "context", "config.json");
+  const configPath = path42.join(cwd, ".cursor", "context", "config.json");
   return readJson(configPath);
 }
 async function stampLastCheckedAt(cwd) {
-  const configPath = path41.join(cwd, ".cursor", "context", "config.json");
+  const configPath = path42.join(cwd, ".cursor", "context", "config.json");
   const existing = await loadContextConfig2(cwd) ?? {};
   const prev = existing.updateCheck && typeof existing.updateCheck === "object" ? { ...existing.updateCheck } : {};
   existing.updateCheck = {
@@ -7040,6 +7396,117 @@ async function stampLastCheckedAt(cwd) {
   };
   await writeJson(configPath, existing);
 }
+async function readLocalKitVersion(registryRoot) {
+  for (const rel of ["packages/cli/package.json", "package.json"]) {
+    const data = await readJson(path42.join(registryRoot, rel));
+    if (data && typeof data.version === "string" && data.version.length > 0) {
+      return data.version;
+    }
+  }
+  return null;
+}
+async function checkAgainstLocalRegistry(cwd, manifest, options) {
+  const registryPath = options.registryPath;
+  if (!registryPath) {
+    throw new Error("checkAgainstLocalRegistry requires registryPath");
+  }
+  let resolved;
+  try {
+    resolved = await resolveRegistryRoot({ cwd, registryPath });
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    return {
+      status: "error",
+      installedVersion: manifest.version,
+      latestVersion: null,
+      registryUrl: path42.resolve(registryPath),
+      registryRef: "local",
+      applyRecommended: false,
+      message: `Failed to resolve --registry: ${msg}`
+    };
+  }
+  const registryUrl = resolved.root;
+  const registryRef = "local";
+  try {
+    let latest;
+    if (options.latestVersion !== void 0) {
+      latest = options.latestVersion;
+    } else {
+      const raw = await readLocalKitVersion(resolved.root);
+      latest = raw ? normalizeSemver(raw) : null;
+    }
+    const summary = summarizeDiff(await diffAgainstRegistry(resolved.root, cwd, manifest));
+    const hasFileDrift = summary.drift > 0 || summary["missing-local"] > 0;
+    const installed = normalizeSemver(manifest.version);
+    if (!installed) {
+      return {
+        status: "error",
+        installedVersion: manifest.version,
+        latestVersion: latest,
+        registryUrl,
+        registryRef,
+        applyRecommended: false,
+        message: `Installed version "${manifest.version}" is not valid semver.`
+      };
+    }
+    if (!latest) {
+      return {
+        status: "error",
+        installedVersion: installed,
+        latestVersion: null,
+        registryUrl,
+        registryRef,
+        applyRecommended: false,
+        message: "No semver found in the local --registry checkout (packages/cli/package.json or package.json)."
+      };
+    }
+    const cmp = compareSemver(installed, latest);
+    if (hasFileDrift) {
+      return {
+        status: "update-available",
+        installedVersion: installed,
+        latestVersion: latest,
+        registryUrl,
+        registryRef,
+        applyRecommended: false,
+        message: `Local registry has drift vs this install (drift=${summary.drift}, missing-local=${summary["missing-local"]}; source v${latest}). Run /update --registry <path> (Ask confirm) to apply; never silent.`
+      };
+    }
+    if (cmp === 0) {
+      return {
+        status: "up-to-date",
+        installedVersion: installed,
+        latestVersion: latest,
+        registryUrl,
+        registryRef,
+        applyRecommended: false,
+        message: `Installed v${installed} matches local registry v${latest}.`
+      };
+    }
+    if (cmp < 0) {
+      return {
+        status: "update-available",
+        installedVersion: installed,
+        latestVersion: latest,
+        registryUrl,
+        registryRef,
+        applyRecommended: false,
+        message: `Update available from local registry: v${installed} \u2192 v${latest}. Run /update --registry <path> (Ask confirm) to apply; never silent.`
+      };
+    }
+    return {
+      status: "ahead-of-public",
+      installedVersion: installed,
+      latestVersion: latest,
+      registryUrl,
+      registryRef,
+      applyRecommended: false,
+      message: `Installed v${installed} is ahead of local registry v${latest}.`
+    };
+  } finally {
+    await resolved.unlock?.();
+  }
+}
 async function checkForUpdates(cwd, options = {}) {
   const manifest = await loadAgentKitManifest(cwd);
   if (!manifest) {
@@ -7053,7 +7520,10 @@ async function checkForUpdates(cwd, options = {}) {
       message: "No .cursor/agent-kit.json \u2014 run agent-kit install first."
     };
   }
-  const registryUrl = manifest.registry?.url ?? null;
+  if (options.registryPath) {
+    return checkAgainstLocalRegistry(cwd, manifest, options);
+  }
+  const registryUrl = options.publicRegistryUrl ?? manifest.registry?.url ?? null;
   const registryRef = manifest.registry?.ref ?? null;
   if (isFactoryOrDevRegistry(registryUrl, registryRef)) {
     return {
@@ -7183,7 +7653,7 @@ var updateCommand = defineCommand17({
     },
     check: {
       type: "boolean",
-      description: "Check-only: compare installed version to latest public tag; never apply L0 writes",
+      description: "Check-only: compare installed version to the resolved registry (public tags, or --registry local checkout); never apply L0 writes",
       default: false
     },
     json: {
@@ -7224,7 +7694,8 @@ var updateCommand = defineCommand17({
       const result = await checkForUpdates(args.cwd, {
         respectPrefs: Boolean(args["respect-prefs"]),
         stamp: Boolean(args.stamp),
-        publicRegistryUrl: typeof args.url === "string" && args.url ? args.url : void 0
+        publicRegistryUrl: typeof args.url === "string" && args.url ? args.url : void 0,
+        registryPath: typeof args.registry === "string" && args.registry ? args.registry : void 0
       });
       if (args.json) {
         console.log(JSON.stringify(result, null, 2));
@@ -7287,7 +7758,10 @@ var updateCommand = defineCommand17({
         await seedManagedHashLedger(projectRoot);
         logger.info("Seeded managed-hash ledger from current local overlay files.");
       }
-      const stats = await syncFromManifest(registry.root, projectRoot, next);
+      const stats = await withCliProgress(
+        "update",
+        () => syncFromManifest(registry.root, projectRoot, next)
+      );
       await saveManifest(projectRoot, next);
       logApplyStats(stats);
       logger.success("Update complete (L3 protected paths left untouched).");
@@ -7299,7 +7773,7 @@ var updateCommand = defineCommand17({
 
 // src/commands/validate.ts
 import { readFile as readFile21 } from "fs/promises";
-import path42 from "path";
+import path43 from "path";
 import { defineCommand as defineCommand18 } from "citty";
 
 // src/invariants/plan-schema.ts
@@ -7346,7 +7820,7 @@ function validatePlanFrontmatterText(text) {
 // src/commands/validate.ts
 async function resolveEditedPath(cwd, explicit) {
   if (explicit) {
-    const filePath2 = path42.resolve(cwd, explicit);
+    const filePath2 = path43.resolve(cwd, explicit);
     try {
       return { filePath: filePath2, content: await readFile21(filePath2, "utf8") };
     } catch {
@@ -7356,7 +7830,7 @@ async function resolveEditedPath(cwd, explicit) {
   const payload = await readStdinJson();
   const rel = typeof payload.file_path === "string" && payload.file_path || typeof payload.path === "string" && payload.path || typeof payload.file === "string" && payload.file || "";
   if (!rel) return null;
-  const filePath = path42.isAbsolute(rel) ? rel : path42.resolve(cwd, rel);
+  const filePath = path43.isAbsolute(rel) ? rel : path43.resolve(cwd, rel);
   try {
     return { filePath, content: await readFile21(filePath, "utf8") };
   } catch {
@@ -7386,7 +7860,7 @@ var validateCommand = defineCommand18({
       async run({ args }) {
         const cwd = typeof args.cwd === "string" ? args.cwd : process.cwd();
         const fileArg = typeof args.file === "string" ? args.file : void 0;
-        const filePath = fileArg ? path42.resolve(cwd, fileArg) : path42.join(path42.resolve(cwd), ".cursor", "HANDOFF.md");
+        const filePath = fileArg ? path43.resolve(cwd, fileArg) : path43.join(path43.resolve(cwd), ".cursor", "HANDOFF.md");
         let content = "";
         try {
           content = await readFile21(filePath, "utf8");
@@ -7413,7 +7887,7 @@ var validateCommand = defineCommand18({
           process.exitCode = 2;
           return;
         }
-        const filePath = path42.resolve(cwd, fileArg);
+        const filePath = path43.resolve(cwd, fileArg);
         let content = "";
         try {
           content = await readFile21(filePath, "utf8");
@@ -7435,7 +7909,7 @@ var validateCommand = defineCommand18({
       },
       async run({ args }) {
         const cwd = typeof args.cwd === "string" ? args.cwd : process.cwd();
-        const resolved = await resolveEditedPath(path42.resolve(cwd));
+        const resolved = await resolveEditedPath(path43.resolve(cwd));
         if (!resolved) {
           console.log(JSON.stringify({}));
           return;
@@ -7478,19 +7952,18 @@ var validateCommand = defineCommand18({
 });
 
 // src/welcome/help-groups.ts
-import { bold, gray as gray3, underline } from "kolorist";
+import { bold, gray as gray4, underline } from "kolorist";
 
 // src/welcome/screen.ts
 import {
   blue as blue2,
-  cyan as cyan3,
-  gray as gray2,
-  options as koloristOptions,
+  cyan as cyan4,
+  gray as gray3,
+  options as koloristOptions2,
   lightCyan,
   trueColor,
   white as white2
 } from "kolorist";
-var HELMET_OUTLINE = "#e2e8f0";
 var KOLORIST_TRUECOLOR = 3;
 var HELMET_ASCII = [
   "       ____",
@@ -7515,30 +7988,20 @@ function outlineAnsi(line) {
   return trueColor(r, g, b)(line);
 }
 function withKoloristColor(fn) {
-  const prevEnabled = koloristOptions.enabled;
-  const prevLevel = koloristOptions.supportLevel;
-  koloristOptions.enabled = true;
-  koloristOptions.supportLevel = KOLORIST_TRUECOLOR;
+  const prevEnabled = koloristOptions2.enabled;
+  const prevLevel = koloristOptions2.supportLevel;
+  koloristOptions2.enabled = true;
+  koloristOptions2.supportLevel = KOLORIST_TRUECOLOR;
   try {
     return fn();
   } finally {
-    koloristOptions.enabled = prevEnabled;
-    koloristOptions.supportLevel = prevLevel;
+    koloristOptions2.enabled = prevEnabled;
+    koloristOptions2.supportLevel = prevLevel;
   }
 }
 function hasCliSubcommand(rawArgs) {
   return Boolean(rawArgs?.some((arg) => !arg.startsWith("-")));
 }
-function shouldUseWelcomeColor(opts = {}) {
-  if (opts.color === false) return false;
-  if (process.env.NO_COLOR) return false;
-  if (process.env.NODE_DISABLE_COLORS) return false;
-  if (process.env.FORCE_COLOR === "0") return false;
-  if (process.env.CI != null && process.env.CI !== "") return false;
-  if (opts.color === true) return true;
-  const tty = opts.stdoutIsTTY ?? Boolean(process.stdout.isTTY);
-  return tty;
-}
 function renderHelmetAscii(color) {
   if (!color) return HELMET_ASCII.join("\n");
   return withKoloristColor(
@@ -7560,8 +8023,8 @@ function renderWelcomeScreen(opts = {}) {
   const version = opts.version ?? KIT_VERSION;
   const color = shouldUseWelcomeColor(opts);
   const title = color ? white2("Mission Kit") : "Mission Kit";
-  const product = color ? cyan3("agent-kit") : "agent-kit";
-  const muted = (s) => color ? gray2(s) : s;
+  const product = color ? cyan4("agent-kit") : "agent-kit";
+  const muted = (s) => color ? gray3(s) : s;
   const lines = [
     renderHelmetAscii(color),
     "",
@@ -7573,13 +8036,18 @@ function renderWelcomeScreen(opts = {}) {
       const width = Math.max(...WELCOME_UTILITY_HINTS.map(({ cmd }) => cmd.length));
       return WELCOME_UTILITY_HINTS.map(({ cmd, hint }) => {
         const pad = " ".repeat(width - cmd.length + 2);
-        const left = color ? cyan3(`  ${cmd}`) : `  ${cmd}`;
+        const left = color ? cyan4(`  ${cmd}`) : `  ${cmd}`;
         return `${left}${pad}${muted(hint)}`;
       });
     })(),
     "",
     muted(
       "Chat HITL (start-project, git-staging/prod, run-plan-all) stays in Cursor slash commands."
+    ),
+    muted(
+      `${shouldUseVisualMotion(opts) ? SPACE_MARKS.star : SPACE_MARKS.tick} ${tipAt(
+        [...version].reduce((n, c) => n + c.charCodeAt(0), 0)
+      )}`
     )
   ];
   return `${lines.join("\n")}
@@ -7630,7 +8098,7 @@ async function resolveSubMeta(subCommands) {
 async function renderGroupedRootHelp(cmd) {
   const color = shouldUseWelcomeColor();
   const u = (s) => color ? underline(bold(s)) : s;
-  const g = (s) => color ? gray3(s) : s;
+  const g = (s) => color ? gray4(s) : s;
   const meta = await resolveCommandMeta(cmd.meta);
   const name = meta?.name ?? "agent-kit";
   const version = meta?.version ?? KIT_VERSION;
@@ -7660,11 +8128,14 @@ async function renderGroupedRootHelp(cmd) {
     }
     lines.push("");
   }
+  const tipMark = shouldUseVisualMotion() ? SPACE_MARKS.star : SPACE_MARKS.tick;
+  const tip = tipAt([...version].reduce((n, c) => n + c.charCodeAt(0), 0));
   lines.push(
     g(`Use \`${name} <command> --help\` for more information about a command.`),
     g(
       "Chat-only HITL (start-project, backlog, git-staging/prod, run-plan-all) is not a CLI surface."
     ),
+    g(`${tipMark} ${tip}`),
     ""
   );
   return lines.join("\n");