@dadado/agent-kit-cli 5.16.0 → 5.18.0

package/dist/index.js

@@ -1,8 +1,9 @@
 #!/usr/bin/env node
 import {
   rewriteRootArgvToRun
-} from "./chunk-WW3YZKHW.js";
-import "./chunk-OUQZC744.js";
+} from "./chunk-RZ5TNBHU.js";
+import "./chunk-B5CH47OS.js";
+import "./chunk-WGLPZXNU.js";
 import "./chunk-MAPOQEA2.js";
 import {
   HELMET_OUTLINE,
@@ -15,6 +16,7 @@ import {
 import {
   KIT_VERSION
 } from "./chunk-7HDQEK6T.js";
+import "./chunk-C26I6HTO.js";
 import "./chunk-77V75A7O.js";
 
 // src/index.ts
@@ -211,29 +213,29 @@ var main = defineCommand({
     version: KIT_VERSION
   },
   subCommands: {
-    init: () => import("./init-TTTKGC4C.js").then((m) => m.initCommand),
-    install: () => import("./install-ZMFJBPOI.js").then((m) => m.installCommand),
+    init: () => import("./init-XP5EAUSJ.js").then((m) => m.initCommand),
+    install: () => import("./install-SHDEX54F.js").then((m) => m.installCommand),
     scan: () => import("./scan-NI2SWJ2E.js").then((m) => m.scanCommand),
-    add: () => import("./add-7UMSGVWC.js").then((m) => m.addCommand),
-    doctor: () => import("./doctor-TA2FWREU.js").then((m) => m.doctorCommand),
-    "setup-global": () => import("./setup-global-JUVMJXJ5.js").then((m) => m.setupGlobalCommand),
-    status: () => import("./status-MVCUNCWX.js").then((m) => m.statusCommand),
-    update: () => import("./update-Q4EBIRUB.js").then((m) => m.updateCommand),
+    add: () => import("./add-KQJE3ZTG.js").then((m) => m.addCommand),
+    doctor: () => import("./doctor-AA64XVEY.js").then((m) => m.doctorCommand),
+    "setup-global": () => import("./setup-global-CBWLXOQG.js").then((m) => m.setupGlobalCommand),
+    status: () => import("./status-BSIXWZMY.js").then((m) => m.statusCommand),
+    update: () => import("./update-FJX3DA6X.js").then((m) => m.updateCommand),
     "cursor-awareness": () => import("./cursor-awareness-KTL2RGKD.js").then((m) => m.cursorAwarenessCommand),
     "public-inbound-radar": () => import("./public-inbound-radar-WP3XF7GS.js").then((m) => m.publicInboundRadarCommand),
     "remote-issues": () => import("./remote-issues-SZ4HDQL5.js").then((m) => m.remoteIssuesCommand),
     dogfood: () => import("./dogfood-KKFVRWT6.js").then((m) => m.dogfoodCommand),
-    diff: () => import("./diff-YTR7VOAN.js").then((m) => m.diffCommand),
-    contribute: () => import("./contribute-YKK6YCSI.js").then((m) => m.contributeCommand),
-    handoff: () => import("./handoff-3UI6VKVG.js").then((m) => m.handoffCommand),
-    "plan-index": () => import("./plan-index-JMC7Z4DW.js").then((m) => m.planIndexCommand),
-    run: () => import("./run-I3BFGULT.js").then((m) => m.runCommand),
-    "run-plan": () => import("./run-plan-FO7CL4M3.js").then((m) => m.runPlanCommand),
-    "run-plan-all": () => import("./run-I3BFGULT.js").then((m) => m.runPlanAllCommand),
+    diff: () => import("./diff-56KMRCER.js").then((m) => m.diffCommand),
+    contribute: () => import("./contribute-LFT762Y4.js").then((m) => m.contributeCommand),
+    handoff: () => import("./handoff-34SDU4FF.js").then((m) => m.handoffCommand),
+    "plan-index": () => import("./plan-index-O3545OA7.js").then((m) => m.planIndexCommand),
+    run: () => import("./run-FADX6QCP.js").then((m) => m.runCommand),
+    "run-plan": () => import("./run-plan-MO4IFAKV.js").then((m) => m.runPlanCommand),
+    "run-plan-all": () => import("./run-FADX6QCP.js").then((m) => m.runPlanAllCommand),
     dashboard: () => import("./dashboard-YSNUGBFY.js").then((m) => m.dashboardCommand),
     "dashboard-broadcast": () => import("./dashboard-broadcast-M4CMW7RX.js").then((m) => m.dashboardBroadcastCommand),
     "mission-control": () => import("./mission-control-LJACEVVN.js").then((m) => m.missionControlCommand),
-    hook: () => import("./hook-MUV6Y7UW.js").then((m) => m.hookCommand),
+    hook: () => import("./hook-KRIXBLNW.js").then((m) => m.hookCommand),
     guard: () => import("./guard-EHXF76ID.js").then((m) => m.guardCommand),
     monitors: () => import("./monitors-QV2IS3MP.js").then((m) => m.monitorsCommand),
     validate: () => import("./validate-V2CW7J4B.js").then((m) => m.validateCommand)

package/dist/{init-TTTKGC4C.js → init-XP5EAUSJ.js}

@@ -2,18 +2,19 @@ import {
   nextStepAfterInstall,
   performInstall,
   printInstallEpilogue
-} from "./chunk-OZ4QV6LM.js";
+} from "./chunk-KIXK7KOW.js";
 import {
   NON_INTERACTIVE_ROOT_ARGS
-} from "./chunk-5OXPNVCF.js";
+} from "./chunk-UEKWZ7BN.js";
 import {
   SkippedSymlinkError,
   logApplyStats
 } from "./chunk-HS7LVVLO.js";
-import "./chunk-XWPO3VYQ.js";
-import "./chunk-KI6ZHBPV.js";
+import "./chunk-ZDCEAGD4.js";
+import "./chunk-HRILMD5N.js";
 import "./chunk-ZXKZBTXE.js";
-import "./chunk-CGTE7DHN.js";
+import "./chunk-TZYKLR5J.js";
+import "./chunk-WGLPZXNU.js";
 import "./chunk-MAPOQEA2.js";
 import {
   withCliProgress
@@ -30,19 +31,19 @@ import {
   confirmProjectRoot,
   isNonInteractive,
   syncPathCliToRuntime
-} from "./chunk-VGZBARQC.js";
+} from "./chunk-YJMZ6UM2.js";
 import {
   assessEnvironment
 } from "./chunk-4IWG5CVE.js";
-import "./chunk-XZZAVHH4.js";
+import "./chunk-YMYLO5LG.js";
 import "./chunk-NQ7IQ5XT.js";
-import "./chunk-YGBBHKBE.js";
-import "./chunk-6QV2BFGA.js";
-import "./chunk-VS2JD2XC.js";
-import "./chunk-5VCOWTTP.js";
+import "./chunk-6FXQINND.js";
+import "./chunk-GSCXFJB7.js";
+import "./chunk-WSJ77EHO.js";
 import {
   KIT_VERSION
 } from "./chunk-7HDQEK6T.js";
+import "./chunk-C26I6HTO.js";
 import "./chunk-77V75A7O.js";
 
 // src/commands/init.ts

package/dist/{install-ZMFJBPOI.js → install-SHDEX54F.js}

@@ -3,28 +3,29 @@ import {
   nextStepAfterInstall,
   performInstall,
   printInstallEpilogue
-} from "./chunk-OZ4QV6LM.js";
-import "./chunk-5OXPNVCF.js";
+} from "./chunk-KIXK7KOW.js";
+import "./chunk-UEKWZ7BN.js";
 import "./chunk-HS7LVVLO.js";
-import "./chunk-XWPO3VYQ.js";
-import "./chunk-KI6ZHBPV.js";
+import "./chunk-ZDCEAGD4.js";
+import "./chunk-HRILMD5N.js";
 import "./chunk-ZXKZBTXE.js";
-import "./chunk-CGTE7DHN.js";
+import "./chunk-TZYKLR5J.js";
+import "./chunk-WGLPZXNU.js";
 import "./chunk-MAPOQEA2.js";
 import "./chunk-QTON2GQX.js";
 import "./chunk-PNFF6OU3.js";
 import "./chunk-ZCTSUQRR.js";
 import "./chunk-F6C3GFKV.js";
 import "./chunk-ZB43YMHW.js";
-import "./chunk-VGZBARQC.js";
+import "./chunk-YJMZ6UM2.js";
 import "./chunk-4IWG5CVE.js";
-import "./chunk-XZZAVHH4.js";
+import "./chunk-YMYLO5LG.js";
 import "./chunk-NQ7IQ5XT.js";
-import "./chunk-YGBBHKBE.js";
-import "./chunk-6QV2BFGA.js";
-import "./chunk-VS2JD2XC.js";
-import "./chunk-5VCOWTTP.js";
+import "./chunk-6FXQINND.js";
+import "./chunk-GSCXFJB7.js";
+import "./chunk-WSJ77EHO.js";
 import "./chunk-7HDQEK6T.js";
+import "./chunk-C26I6HTO.js";
 import "./chunk-77V75A7O.js";
 export {
   installCommand,

package/dist/{plan-index-JMC7Z4DW.js → plan-index-O3545OA7.js}

@@ -1,8 +1,8 @@
 import {
   formatPlanIndexLines,
   writePlanIndex
-} from "./chunk-KD2MYBB6.js";
-import "./chunk-5VCOWTTP.js";
+} from "./chunk-3J3I2W22.js";
+import "./chunk-C26I6HTO.js";
 import "./chunk-77V75A7O.js";
 
 // src/commands/plan-index.ts

package/dist/{run-I3BFGULT.js → run-FADX6QCP.js}

@@ -4,10 +4,10 @@ import {
   runPlanLoop,
   shouldUseLiveTui,
   withLiveTui
-} from "./chunk-TFZ2JUXH.js";
+} from "./chunk-TOWH3XCJ.js";
 import "./chunk-PCCQUWE5.js";
 import "./chunk-HFUH3HVS.js";
-import "./chunk-KD2MYBB6.js";
+import "./chunk-3J3I2W22.js";
 import {
   buildDispatchPrompt,
   classifySlash,
@@ -17,19 +17,20 @@ import {
   readCommandFile,
   runHeadlessDispatch,
   unknownSlashMessage
-} from "./chunk-WW3YZKHW.js";
+} from "./chunk-RZ5TNBHU.js";
 import {
   HITL_UNANSWERED_EXIT_CODE,
   formatHitlSummary,
   getBackend,
   hitlExitCode
-} from "./chunk-OUQZC744.js";
+} from "./chunk-B5CH47OS.js";
+import "./chunk-WGLPZXNU.js";
 import "./chunk-MAPOQEA2.js";
 import "./chunk-QTON2GQX.js";
 import {
   logger
 } from "./chunk-ZB43YMHW.js";
-import "./chunk-5VCOWTTP.js";
+import "./chunk-C26I6HTO.js";
 import "./chunk-77V75A7O.js";
 
 // src/commands/run.ts

package/dist/{run-plan-FO7CL4M3.js → run-plan-MO4IFAKV.js}

@@ -1,21 +1,23 @@
 import {
+  DRIVER_EVENTS_FORMATS,
   detectAgentBackend,
   listDetectBackendIds,
   runPlanLoop
-} from "./chunk-TFZ2JUXH.js";
+} from "./chunk-TOWH3XCJ.js";
 import "./chunk-PCCQUWE5.js";
 import "./chunk-HFUH3HVS.js";
-import "./chunk-KD2MYBB6.js";
+import "./chunk-3J3I2W22.js";
 import {
   HITL_UNANSWERED_EXIT_CODE,
   getBackend
-} from "./chunk-OUQZC744.js";
+} from "./chunk-B5CH47OS.js";
+import "./chunk-WGLPZXNU.js";
 import "./chunk-MAPOQEA2.js";
 import "./chunk-QTON2GQX.js";
 import {
   logger
 } from "./chunk-ZB43YMHW.js";
-import "./chunk-5VCOWTTP.js";
+import "./chunk-C26I6HTO.js";
 import "./chunk-77V75A7O.js";
 
 // src/commands/run-plan.ts
@@ -62,6 +64,16 @@ var runPlanCommand = defineCommand({
       description: `CI: never prompt; a HITL gate stops the run with exit ${HITL_UNANSWERED_EXIT_CODE} (no default answer)`,
       default: false
     },
+    "on-limit": {
+      type: "string",
+      description: "Backend for the next fresh tick when a tick stops on a vendor usage limit (once per run; default: stop)",
+      default: ""
+    },
+    events: {
+      type: "string",
+      description: "Driver mode for apps: `ndjson` writes only NDJSON events to stdout and reads HITL answers as JSON lines on stdin (no TTY needed; see docs/driver-events-protocol.md)",
+      default: ""
+    },
     plain: {
       type: "boolean",
       description: "Status lines instead of the Mission Control live view (the default on a TTY; non-TTY, NO_COLOR and CI are always plain)",
@@ -81,6 +93,12 @@ var runPlanCommand = defineCommand({
       process.exitCode = 1;
       return;
     }
+    const events = String(args.events ?? "");
+    if (events && !DRIVER_EVENTS_FORMATS.includes(events)) {
+      logger.error(`--events must be one of: ${DRIVER_EVENTS_FORMATS.join(", ")}`);
+      process.exitCode = 1;
+      return;
+    }
     let backend;
     try {
       const requested = String(args.backend);
@@ -100,6 +118,17 @@ var runPlanCommand = defineCommand({
       process.exitCode = 1;
       return;
     }
+    let onLimit;
+    const onLimitId = String(args["on-limit"] ?? "").trim();
+    if (onLimitId) {
+      try {
+        onLimit = getBackend(onLimitId);
+      } catch (err) {
+        logger.error(`--on-limit: ${String(err)}`);
+        process.exitCode = 1;
+        return;
+      }
+    }
     const code = await runPlanLoop({
       root: path.resolve(args.cwd),
       maxTicks,
@@ -108,7 +137,9 @@ var runPlanCommand = defineCommand({
       dryRun: Boolean(args["dry-run"]),
       backend,
       noHitl: Boolean(args["no-hitl"]),
-      plain: Boolean(args.plain)
+      plain: Boolean(args.plain),
+      ...events ? { events: {} } : {},
+      ...onLimit ? { onLimit } : {}
     });
     process.exitCode = code;
   }

package/dist/{setup-global-JUVMJXJ5.js → setup-global-CBWLXOQG.js}

@@ -2,20 +2,20 @@ import {
   classifyInstallError,
   isNonInteractive,
   pathCliStatus
-} from "./chunk-VGZBARQC.js";
+} from "./chunk-YJMZ6UM2.js";
 import {
   assessEnvironment
 } from "./chunk-4IWG5CVE.js";
-import "./chunk-XZZAVHH4.js";
+import "./chunk-YMYLO5LG.js";
 import "./chunk-NQ7IQ5XT.js";
-import "./chunk-YGBBHKBE.js";
-import "./chunk-6QV2BFGA.js";
-import "./chunk-VS2JD2XC.js";
-import "./chunk-5VCOWTTP.js";
+import "./chunk-6FXQINND.js";
+import "./chunk-GSCXFJB7.js";
+import "./chunk-WSJ77EHO.js";
 import {
   KIT_VERSION,
   pinnedCliSpec
 } from "./chunk-7HDQEK6T.js";
+import "./chunk-C26I6HTO.js";
 import "./chunk-77V75A7O.js";
 
 // src/commands/setup-global.ts

package/dist/{status-MVCUNCWX.js → status-BSIXWZMY.js}

@@ -1,3 +1,7 @@
+import {
+  detectWorkspaceParent,
+  workspaceParentAdvisoryLines
+} from "./chunk-P6PMKYWU.js";
 import {
   createReadinessReport
 } from "./chunk-PNFF6OU3.js";
@@ -11,23 +15,23 @@ import {
 import {
   npxPinned,
   pathCliStatus
-} from "./chunk-VGZBARQC.js";
+} from "./chunk-YJMZ6UM2.js";
 import {
   assessEnvironment
 } from "./chunk-4IWG5CVE.js";
-import "./chunk-XZZAVHH4.js";
+import "./chunk-YMYLO5LG.js";
 import "./chunk-NQ7IQ5XT.js";
-import "./chunk-YGBBHKBE.js";
-import "./chunk-6QV2BFGA.js";
+import "./chunk-6FXQINND.js";
+import "./chunk-GSCXFJB7.js";
 import {
   MANIFEST_RELATIVE_PATH,
   loadAgentKitManifest,
   resolveProtectedGlobs
-} from "./chunk-VS2JD2XC.js";
-import "./chunk-5VCOWTTP.js";
+} from "./chunk-WSJ77EHO.js";
 import {
   KIT_VERSION
 } from "./chunk-7HDQEK6T.js";
+import "./chunk-C26I6HTO.js";
 import {
   readJson
 } from "./chunk-77V75A7O.js";
@@ -65,6 +69,13 @@ var statusCommand = defineCommand({
   },
   async run({ args }) {
     const rootDir = path.resolve(args.cwd);
+    const workspaceParent = await detectWorkspaceParent(rootDir);
+    if (workspaceParent && !args.json) {
+      for (const line of workspaceParentAdvisoryLines(rootDir, workspaceParent, "status")) {
+        console.log(line);
+      }
+      return;
+    }
     const [manifest, rawProfile, scan, env] = await Promise.all([
       loadAgentKitManifest(rootDir, args.json ? {} : { onWarning: logger.warn }),
       readJson(
@@ -84,7 +95,8 @@ var statusCommand = defineCommand({
             manifest: manifest ?? null,
             readiness,
             pendingActions: readiness.pendingActions,
-            profile
+            profile,
+            ...workspaceParent ? { workspaceParent } : {}
           },
           null,
           2

package/dist/{update-Q4EBIRUB.js → update-FJX3DA6X.js}

@@ -1,7 +1,7 @@
 import {
   NON_INTERACTIVE_ROOT_ARGS,
   syncFromManifest
-} from "./chunk-5OXPNVCF.js";
+} from "./chunk-UEKWZ7BN.js";
 import {
   formatSkippedSymlinks,
   logApplyStats
@@ -9,13 +9,14 @@ import {
 import {
   REGISTRY_CLI_ARGS,
   resolveRegistryFromCli
-} from "./chunk-XWPO3VYQ.js";
+} from "./chunk-ZDCEAGD4.js";
 import {
   CLAUDE_SETTINGS_REL,
   formatClaudeSettingsDrift,
+  generateClaudeCommandAdapters,
   planClaudeSettingsDrift,
   writeClaudeSessionStartHook
-} from "./chunk-CGTE7DHN.js";
+} from "./chunk-TZYKLR5J.js";
 import "./chunk-MAPOQEA2.js";
 import {
   withCliProgress
@@ -28,17 +29,17 @@ import {
   confirmProjectRoot,
   isNonInteractive,
   syncPathCliToRuntime
-} from "./chunk-VGZBARQC.js";
+} from "./chunk-YJMZ6UM2.js";
 import "./chunk-4IWG5CVE.js";
 import {
   checkForUpdates,
   compareSemver,
   normalizeSemver,
   readLocalKitVersion
-} from "./chunk-XZZAVHH4.js";
+} from "./chunk-YMYLO5LG.js";
 import "./chunk-NQ7IQ5XT.js";
-import "./chunk-YGBBHKBE.js";
-import "./chunk-6QV2BFGA.js";
+import "./chunk-6FXQINND.js";
+import "./chunk-GSCXFJB7.js";
 import {
   buildManifest,
   isProtectedPath,
@@ -46,12 +47,12 @@ import {
   resolveProtectedGlobs,
   saveManifest,
   seedManagedHashLedger
-} from "./chunk-VS2JD2XC.js";
-import "./chunk-5VCOWTTP.js";
+} from "./chunk-WSJ77EHO.js";
 import {
   KIT_PACKAGE_SPEC,
   KIT_VERSION
 } from "./chunk-7HDQEK6T.js";
+import "./chunk-C26I6HTO.js";
 import "./chunk-77V75A7O.js";
 
 // src/commands/update.ts
@@ -98,7 +99,7 @@ var updateCommand = defineCommand({
     },
     claude: {
       type: "boolean",
-      description: "Also apply the ledger-aware Claude settings merge (.claude/settings.json + ledger) with install --claude authority; operator opt-in, never from hooks or plan-loop",
+      description: "Also apply the ledger-aware Claude settings merge (.claude/settings.json + ledger) and generate the .claude/commands/* pointer adapters with install --claude authority; operator opt-in, never from hooks or plan-loop",
       default: false
     },
     ...NON_INTERACTIVE_ROOT_ARGS,
@@ -237,6 +238,17 @@ ${err.recovery}
         } else {
           console.log(`Claude settings ${claude.status}: ${claude.relativePath}`);
         }
+        const adapters = await generateClaudeCommandAdapters(projectRoot);
+        const skipped = adapters.filter((a) => a.status === "skipped-symlink");
+        if (skipped.length > 0) {
+          logApplyStats(stats);
+          logger.error(
+            `Claude command adapters not written for: ${skipped.map((a) => a.relativePath).join(", ")} (symlink outside the project). Nothing was changed there.`
+          );
+          process.exitCode = 1;
+          return;
+        }
+        if (adapters.length > 0) console.log(formatClaudeAdapterSummary(adapters));
       } else {
         const drift = await planClaudeSettingsDrift(projectRoot);
         if (drift) {
@@ -255,6 +267,17 @@ ${err.recovery}
     }
   }
 });
+function formatClaudeAdapterSummary(results) {
+  const count = (status) => results.filter((r) => r.status === status).length;
+  const parts = [
+    `${count("applied")} written`,
+    `${count("refreshed")} refreshed`,
+    `${count("unchanged")} unchanged`
+  ];
+  const customized = count("preserved-customized");
+  if (customized > 0) parts.push(`${customized} preserved (customized)`);
+  return `Claude command adapters: ${parts.join(", ")} (.claude/commands/)`;
+}
 export {
   updateCommand
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dadado/agent-kit-cli",
-  "version": "5.16.0",
+  "version": "5.18.0",
   "description": "Agent Kit CLI: HITL framework install and tooling for AI-assisted IDEs (rules, skills, plan/handoff, context).",
   "license": "PolyForm-Noncommercial-1.0.0",
   "type": "module",
@@ -15,8 +15,8 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@clack/prompts": "^0.8.2",
-    "citty": "^0.1.6",
+    "@clack/prompts": "^1.8.1",
+    "citty": "^0.2.2",
     "kolorist": "^1.8.0"
   },
   "devDependencies": {

package/dist/chunk-5VCOWTTP.js

@@ -1,6 +0,0 @@
-// src/utils/kit-paths.ts
-var HANDOFF_REL = ".cursor/HANDOFF.md";
-
-export {
-  HANDOFF_REL
-};