@dadado/agent-kit-cli 5.16.0 → 5.17.0

package/dist/{add-7UMSGVWC.js → add-HTYIFKMN.js}

@@ -5,7 +5,7 @@ import {
 import {
   REGISTRY_CLI_ARGS,
   resolveRegistryFromCli
-} from "./chunk-XWPO3VYQ.js";
+} from "./chunk-PNG7LO2F.js";
 import {
   logger
 } from "./chunk-ZB43YMHW.js";
@@ -22,7 +22,7 @@ import {
   resolveProtectedGlobs,
   saveManifest,
   upsertIdList
-} from "./chunk-VS2JD2XC.js";
+} from "./chunk-AW74INUW.js";
 import "./chunk-5VCOWTTP.js";
 import {
   KIT_VERSION

package/dist/{chunk-YGBBHKBE.js → chunk-2RDRMGD3.js}

@@ -1,11 +1,11 @@
 import {
   managedPairs
-} from "./chunk-6QV2BFGA.js";
+} from "./chunk-N3HTJVBR.js";
 import {
   isProtectedPath,
   resolveContained,
   resolveProtectedGlobs
-} from "./chunk-VS2JD2XC.js";
+} from "./chunk-AW74INUW.js";
 
 // src/lifecycle/diff.ts
 import { readFile } from "fs/promises";

package/dist/{chunk-VS2JD2XC.js → chunk-AW74INUW.js}

@@ -678,7 +678,10 @@ var KNOWN_SHIPPED_OVERLAY_HASHES = /* @__PURE__ */ new Set([
   "41d3eac7f116ec22535d830149979fe0a8dbf44625dd841bc9785cbd7c5ddc95",
   "80e11549ad3700d1e7345447aff1b3858e532e9347594ee4f028566c8c7b8a6a",
   "1ffbfa48a76d39f78db66f4ea250c451ae335c31d7e45d0fdc4d99bc714bae33",
-  "19a5aa359e740fa18d7cc19f0b11243bc53d8d016545bce35837deac7fe2ef7e"
+  "19a5aa359e740fa18d7cc19f0b11243bc53d8d016545bce35837deac7fe2ef7e",
+  "f1c7beac6a619520d744fd984bc16b322f3d545b9d8490801aee628dabd94aff",
+  "14d919d01637aa6b5acc92804dbb4ab56cecc88281aedd5cb7b5dcf8f7da958e",
+  "a8decf7b78e2b2c833b0808c3e108322cfb895fadaec159467973a681028d92a"
 ]);
 
 // src/lifecycle/paths.ts

package/dist/{chunk-OZ4QV6LM.js → chunk-B73KQ5KX.js}

@@ -2,7 +2,7 @@ import {
   NON_INTERACTIVE_ROOT_ARGS,
   installL0,
   syncFromManifest
-} from "./chunk-5OXPNVCF.js";
+} from "./chunk-DQA434Y4.js";
 import {
   SkippedSymlinkError,
   formatPersonalizationSkippedSymlinks,
@@ -11,16 +11,19 @@ import {
 import {
   REGISTRY_CLI_ARGS,
   resolveRegistryFromCli
-} from "./chunk-XWPO3VYQ.js";
+} from "./chunk-PNG7LO2F.js";
 import {
+  assessClaudeCommandAdapters,
   executeSafeReadinessFixes
-} from "./chunk-KI6ZHBPV.js";
+} from "./chunk-STGFBAYT.js";
 import {
   writeReadinessSnapshot
 } from "./chunk-ZXKZBTXE.js";
 import {
+  CLAUDE_HITL_FALLBACK,
+  generateClaudeCommandAdapters,
   writeClaudeSessionStartHook
-} from "./chunk-CGTE7DHN.js";
+} from "./chunk-W24CMQ32.js";
 import {
   shouldUseWelcomeColor,
   withCliProgress
@@ -47,36 +50,30 @@ import {
   npxPinned,
   pathCliStatus,
   syncPathCliToRuntime
-} from "./chunk-VGZBARQC.js";
+} from "./chunk-F4VMYR7U.js";
 import {
   assessEnvironment
 } from "./chunk-4IWG5CVE.js";
 import {
   warnIfRunningCliBehindNpm
-} from "./chunk-XZZAVHH4.js";
+} from "./chunk-SMGFN3Z4.js";
 import {
   DOMAIN_PACK_IDS,
   allPacks,
   allSkills,
   buildManifest,
-  contentHash,
   emptyStats,
   installPack,
   installSkill,
-  isRealWriteTargetContained,
   loadAgentKitManifest,
-  loadManagedHashLedger,
   loadPackManifest,
   loadRegistry,
   mergeStats,
   packMemberFileTargets,
-  resolveContained,
   resolveProtectedGlobs,
-  saveManagedHashLedger,
   saveManifest,
-  shouldPreserveCustomizedOverlay,
   skillTargetDir
-} from "./chunk-VS2JD2XC.js";
+} from "./chunk-AW74INUW.js";
 import {
   KIT_VERSION,
   pinnedCliSpec
@@ -88,123 +85,17 @@ import {
 } from "./chunk-77V75A7O.js";
 
 // src/commands/install.ts
-import path5 from "path";
+import path4 from "path";
 import { defineCommand } from "citty";
 import { bold, cyan, green, options as koloristOptions } from "kolorist";
 
 // src/generator/personalization.ts
-import { readFile as readFile2, writeFile as writeFile4 } from "fs/promises";
-import path4 from "path";
-
-// src/generator/claude-command-adapters.ts
-import { readFile, readdir, writeFile } from "fs/promises";
-import path from "path";
-var CURSOR_COMMANDS_DIR_REL = ".cursor/commands";
-var CLAUDE_COMMANDS_DIR_REL = ".claude/commands";
-var RESERVED_ADAPTER_NAMES = /* @__PURE__ */ new Set(["agent-kit"]);
-function parseCommandFrontmatter(name, raw) {
-  const match = /^---\r?\n([\s\S]*?)\r?\n---/.exec(raw);
-  if (!match) return null;
-  const body = match[1] ?? "";
-  const descMatch = /^description:\s*(.+)$/m.exec(body);
-  if (!descMatch) return null;
-  const description = (descMatch[1] ?? "").trim();
-  if (!description) return null;
-  return { name, description };
-}
-var CLAUDE_HITL_FALLBACK = `Cursor "Ask questions" is unavailable here: use AskUserQuestion when possible, else print one line \`HITL_GATE: <ask-id> | <label 1> | <label 2> | ...\` immediately followed by the same labels as one numbered list, one list per message, and WAIT for the answer (ask-id and labels: \`.cursor/skills/core/hitl-gates/SKILL.md\`). A headless reply arrives as \`HITL_REPLY: <ask-id> | operator reply <n> | <label>\`; cite that line as the Ask provenance.`;
-var MODEL_INVOCATION_DISABLED = /* @__PURE__ */ new Set([
-  "git-prod",
-  "kit-prod",
-  "backlog-delete",
-  "backlog-cancel",
-  "archive-plan",
-  "hotfix",
-  "run-plan-all"
-]);
-function renderClaudeCommandAdapter(command) {
-  const invocation = MODEL_INVOCATION_DISABLED.has(command.name) ? "disable-model-invocation: true\n" : "";
-  return `---
-description: ${command.description}
-${invocation}---
-
-Read \`.cursor/commands/${command.name}.md\` now and follow that contract exactly \u2014 it is the source of truth for /${command.name}; this file is only a thin adapter for Claude Code.
-
-Adapter rules (Claude Code CLI):
-- ${CLAUDE_HITL_FALLBACK}
-- Skip or cancel means stop.
-- Never \`/git-prod\` without an explicit operator yes.
-- Do not clone Cursor hooks or invent behavior beyond the SoT file.
-`;
-}
-async function discoverInstalledCommands(rootDir) {
-  const dir = path.join(rootDir, CURSOR_COMMANDS_DIR_REL);
-  let entries;
-  try {
-    entries = (await readdir(dir)).filter((f) => f.endsWith(".md"));
-  } catch {
-    return [];
-  }
-  const commands = [];
-  for (const file of entries.sort()) {
-    const name = file.slice(0, -3);
-    if (RESERVED_ADAPTER_NAMES.has(name)) continue;
-    try {
-      const raw = await readFile(path.join(dir, file), "utf8");
-      const parsed = parseCommandFrontmatter(name, raw);
-      if (parsed) commands.push(parsed);
-    } catch {
-    }
-  }
-  return commands;
-}
-async function generateClaudeCommandAdapters(rootDir) {
-  const commands = await discoverInstalledCommands(rootDir);
-  if (commands.length === 0) return [];
-  const ledger = await loadManagedHashLedger(rootDir);
-  const results = [];
-  let ledgerDirty = false;
-  for (const command of commands) {
-    const relPath = path.posix.join(CLAUDE_COMMANDS_DIR_REL, `${command.name}.md`);
-    const rendered = renderClaudeCommandAdapter(command);
-    const abs = resolveContained(rootDir, relPath);
-    if (!await isRealWriteTargetContained(rootDir, abs)) {
-      results.push({ relativePath: relPath, status: "skipped-symlink" });
-      continue;
-    }
-    if (!await fileExists(abs)) {
-      await ensureDir(path.dirname(abs));
-      await writeFile(abs, rendered, "utf8");
-      ledger.hashes[relPath] = contentHash(rendered);
-      ledgerDirty = true;
-      results.push({ relativePath: relPath, status: "applied" });
-      continue;
-    }
-    const localContent = await readFile(abs, "utf8");
-    if (localContent === rendered) {
-      if (ledger.hashes[relPath] !== contentHash(rendered)) {
-        ledger.hashes[relPath] = contentHash(rendered);
-        ledgerDirty = true;
-      }
-      results.push({ relativePath: relPath, status: "unchanged" });
-      continue;
-    }
-    if (shouldPreserveCustomizedOverlay(localContent, ledger.hashes[relPath])) {
-      results.push({ relativePath: relPath, status: "preserved-customized" });
-      continue;
-    }
-    await writeFile(abs, rendered, "utf8");
-    ledger.hashes[relPath] = contentHash(rendered);
-    ledgerDirty = true;
-    results.push({ relativePath: relPath, status: "refreshed" });
-  }
-  if (ledgerDirty) await saveManagedHashLedger(rootDir, ledger);
-  return results;
-}
+import { readFile, writeFile as writeFile3 } from "fs/promises";
+import path3 from "path";
 
 // src/generator/claude-kit-load.ts
-import { writeFile as writeFile2 } from "fs/promises";
-import path2 from "path";
+import { writeFile } from "fs/promises";
+import path from "path";
 var CLAUDE_MD_REL = "CLAUDE.md";
 var AGENT_KIT_COMMAND_REL = ".claude/commands/agent-kit.md";
 function renderClaudeMd() {
@@ -257,12 +148,12 @@ Non-goals: not audits / \`/plan-external-review\`, not a second tick dialect, no
 `;
 }
 async function writeUnlessExists(rootDir, relativePath, content) {
-  const target = path2.join(rootDir, relativePath);
+  const target = path.join(rootDir, relativePath);
   if (await fileExists(target)) {
     return { relativePath, status: "skipped-customized" };
   }
-  await ensureDir(path2.dirname(target));
-  await writeFile2(target, content, "utf8");
+  await ensureDir(path.dirname(target));
+  await writeFile(target, content, "utf8");
   return { relativePath, status: "applied" };
 }
 async function generateClaudeKitLoadArtifacts(rootDir) {
@@ -273,8 +164,8 @@ async function generateClaudeKitLoadArtifacts(rootDir) {
 }
 
 // src/generator/vscode.ts
-import { writeFile as writeFile3 } from "fs/promises";
-import path3 from "path";
+import { writeFile as writeFile2 } from "fs/promises";
+import path2 from "path";
 
 // src/generator/platform.ts
 function gitProviderLabel(profile) {
@@ -298,14 +189,14 @@ function prTerminology(profile) {
 // src/generator/vscode.ts
 async function generateVSCodeArtifacts(profile) {
   const results = [];
-  const vscodeDir = path3.join(profile.rootDir, ".vscode");
-  const githubDir = path3.join(profile.rootDir, ".github");
+  const vscodeDir = path2.join(profile.rootDir, ".vscode");
+  const githubDir = path2.join(profile.rootDir, ".github");
   await Promise.all([ensureDir(vscodeDir), ensureDir(githubDir)]);
-  const settingsPath = path3.join(vscodeDir, "settings.json");
+  const settingsPath = path2.join(vscodeDir, "settings.json");
   if (await fileExists(settingsPath)) {
     results.push({ relativePath: ".vscode/settings.json", status: "skipped-customized" });
   } else {
-    await writeFile3(
+    await writeFile2(
       settingsPath,
       `${JSON.stringify(
         {
@@ -325,11 +216,11 @@ async function generateVSCodeArtifacts(profile) {
   }
   const provider = gitProviderLabel(profile);
   const prTerm = prTerminology(profile);
-  const copilotPath = path3.join(githubDir, "copilot-instructions.md");
+  const copilotPath = path2.join(githubDir, "copilot-instructions.md");
   if (await fileExists(copilotPath)) {
     results.push({ relativePath: ".github/copilot-instructions.md", status: "skipped-customized" });
   } else {
-    await writeFile3(
+    await writeFile2(
       copilotPath,
       `# Copilot Instructions
 
@@ -343,14 +234,14 @@ async function generateVSCodeArtifacts(profile) {
     results.push({ relativePath: ".github/copilot-instructions.md", status: "applied" });
   }
   if (profile.ide.plan === "vscode-pro") {
-    const securityPath = path3.join(vscodeDir, "security-review.agent.md");
+    const securityPath = path2.join(vscodeDir, "security-review.agent.md");
     if (await fileExists(securityPath)) {
       results.push({
         relativePath: ".vscode/security-review.agent.md",
         status: "skipped-customized"
       });
     } else {
-      await writeFile3(
+      await writeFile2(
         securityPath,
         "# Security Review Agent\n\nSpecialized mode for security review.\n",
         "utf8"
@@ -555,7 +446,7 @@ function renderProjectContext(profile, skillItems = []) {
 `;
 }
 async function createOwnedFile(rootDir, relativePath, content, evidence) {
-  const target = path4.join(rootDir, relativePath);
+  const target = path3.join(rootDir, relativePath);
   if (await fileExists(target)) {
     return {
       kind: "file",
@@ -565,8 +456,8 @@ async function createOwnedFile(rootDir, relativePath, content, evidence) {
       evidence
     };
   }
-  await ensureDir(path4.dirname(target));
-  await writeFile4(target, content, "utf8");
+  await ensureDir(path3.dirname(target));
+  await writeFile3(target, content, "utf8");
   return {
     kind: "file",
     id: relativePath,
@@ -588,7 +479,7 @@ async function packTargets(registryRoot, packId) {
 async function existingTargets(projectRoot, targets) {
   const checks = await Promise.all(
     targets.map(
-      async (target) => await fileExists(path4.join(projectRoot, target)) ? target : null
+      async (target) => await fileExists(path3.join(projectRoot, target)) ? target : null
     )
   );
   return checks.filter((target) => target !== null);
@@ -612,8 +503,8 @@ async function applyPersonalization(input) {
         componentResults.push({ ...item, status: "unavailable" });
         continue;
       }
-      const target = path4.posix.join(skillTargetDir(skill.path, skill.id), "SKILL.md");
-      if (await fileExists(path4.join(input.rootDir, target))) {
+      const target = path3.posix.join(skillTargetDir(skill.path, skill.id), "SKILL.md");
+      if (await fileExists(path3.join(input.rootDir, target))) {
         componentResults.push({ ...item, status: "skipped-customized", path: target });
         protectedPaths.add(target);
         continue;
@@ -779,7 +670,7 @@ async function applyPersonalization(input) {
     protectedPaths: [...protectedPaths].sort(),
     ...claudeSessionStartInstructions ? { claudeSessionStartInstructions } : {}
   };
-  await writeJson(path4.join(input.rootDir, RESULT_PATH), result);
+  await writeJson(path3.join(input.rootDir, RESULT_PATH), result);
   return {
     result,
     stats,
@@ -799,9 +690,9 @@ async function applyPersonalization(input) {
   };
 }
 async function readRepositoryProfile(rootDir) {
-  const target = path4.join(rootDir, REPOSITORY_PROFILE_REL);
+  const target = path3.join(rootDir, REPOSITORY_PROFILE_REL);
   if (!await fileExists(target)) return null;
-  return JSON.parse(await readFile2(target, "utf8"));
+  return JSON.parse(await readFile(target, "utf8"));
 }
 
 // src/commands/install.ts
@@ -888,7 +779,7 @@ async function printPostInstallSummary(result) {
   printInstallEpilogue(sync.env, { runtimeVersion: KIT_VERSION });
 }
 async function performInstall(options) {
-  const projectRoot = path5.resolve(options.cwd);
+  const projectRoot = path4.resolve(options.cwd);
   const packs = parsePackList(options.pack);
   const existing = await loadAgentKitManifest(projectRoot, { onWarning: logger.warn });
   const registry = await resolveRegistryFromCli({
@@ -951,13 +842,15 @@ async function performInstall(options) {
       }
     }
     await writeReadinessSnapshot(projectRoot, readiness);
+    const claudeAdapterHint = options.claudeAdapters ? void 0 : (await assessClaudeCommandAdapters(projectRoot))[0];
     return {
       projectRoot,
       manifestPath,
       stats,
       readiness,
       safeChanges: readinessExecution.changes,
-      ...claudeSessionStartInstructions ? { claudeSessionStartInstructions } : {}
+      ...claudeSessionStartInstructions ? { claudeSessionStartInstructions } : {},
+      ...claudeAdapterHint ? { claudeAdapterHint } : {}
     };
   } finally {
     await registry.unlock?.();
@@ -1046,6 +939,7 @@ ${err.recovery}
 ${result.claudeSessionStartInstructions}
 `);
       }
+      if (result.claudeAdapterHint) logger.info(result.claudeAdapterHint);
     } catch (err) {
       if (err instanceof SkippedSymlinkError) {
         logApplyStats(err.stats);

package/dist/{chunk-5OXPNVCF.js → chunk-DQA434Y4.js}

@@ -1,6 +1,6 @@
 import {
   L0_ARTIFACTS
-} from "./chunk-6QV2BFGA.js";
+} from "./chunk-N3HTJVBR.js";
 import {
   copyRegistryFile,
   emptyStats,
@@ -12,7 +12,7 @@ import {
   recordOutcome,
   resolveProtectedGlobs,
   saveManagedHashLedger
-} from "./chunk-VS2JD2XC.js";
+} from "./chunk-AW74INUW.js";
 import {
   fileExists
 } from "./chunk-77V75A7O.js";

package/dist/{chunk-VGZBARQC.js → chunk-F4VMYR7U.js}

@@ -4,10 +4,10 @@ import {
 import {
   compareSemver,
   normalizeSemver
-} from "./chunk-XZZAVHH4.js";
+} from "./chunk-SMGFN3Z4.js";
 import {
   MANIFEST_RELATIVE_PATH
-} from "./chunk-VS2JD2XC.js";
+} from "./chunk-AW74INUW.js";
 import {
   KIT_VERSION,
   pinnedCliSpec

package/dist/{chunk-6QV2BFGA.js → chunk-N3HTJVBR.js}

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

package/dist/{chunk-XWPO3VYQ.js → chunk-PNG7LO2F.js}

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

package/dist/chunk-S6GMFDKV.js

@@ -0,0 +1,50 @@
+import {
+  MANIFEST_RELATIVE_PATH
+} from "./chunk-AW74INUW.js";
+import {
+  fileExists
+} from "./chunk-77V75A7O.js";
+
+// src/scanner/workspace-parent.ts
+import { readdir } from "fs/promises";
+import path from "path";
+var MAX_CHILDREN_INSPECTED = 200;
+var MAX_KIT_PROJECTS_REPORTED = 10;
+async function detectWorkspaceParent(rootDir) {
+  try {
+    if (await fileExists(path.join(rootDir, MANIFEST_RELATIVE_PATH))) return null;
+    const entries = await readdir(rootDir, { withFileTypes: true });
+    const children = entries.filter(
+      (entry) => entry.isDirectory() && !entry.name.startsWith(".") && entry.name !== "node_modules"
+    ).map((entry) => entry.name).sort().slice(0, MAX_CHILDREN_INSPECTED);
+    const hits = await Promise.all(
+      children.map(
+        async (name) => await fileExists(path.join(rootDir, name, MANIFEST_RELATIVE_PATH)) ? name : null
+      )
+    );
+    const kitProjects = hits.filter((name) => name !== null).slice(0, MAX_KIT_PROJECTS_REPORTED);
+    return kitProjects.length > 0 ? { kitProjects } : null;
+  } catch {
+    return null;
+  }
+}
+function shellArg(value) {
+  return /^[\w@%+=:,./-]+$/.test(value) ? value : `'${value.replace(/'/g, "'\\''")}'`;
+}
+function workspaceParentNextStep(detection, command) {
+  return `cd ${shellArg(detection.kitProjects[0] ?? "<project>")} && agent-kit ${command}`;
+}
+function workspaceParentAdvisoryLines(rootDir, detection, command) {
+  return [
+    `No Agent Kit here: ${rootDir} is a workspace folder, not a kit project.`,
+    "Kit projects in its direct subfolders:",
+    ...detection.kitProjects.map((name) => `  - ${name}`),
+    `Run \`agent-kit ${command}\` from inside one of them.`,
+    `Next: ${workspaceParentNextStep(detection, command)}`
+  ];
+}
+
+export {
+  detectWorkspaceParent,
+  workspaceParentAdvisoryLines
+};

package/dist/{chunk-XZZAVHH4.js → chunk-SMGFN3Z4.js}

@@ -6,13 +6,13 @@ import {
 import {
   diffAgainstRegistry,
   summarizeDiff
-} from "./chunk-YGBBHKBE.js";
+} from "./chunk-2RDRMGD3.js";
 import {
   DEFAULT_REGISTRY_URL,
   assertSafeRegistrySource,
   loadAgentKitManifest,
   resolveRegistryRoot
-} from "./chunk-VS2JD2XC.js";
+} from "./chunk-AW74INUW.js";
 import {
   KIT_PACKAGE_SPEC,
   KIT_VERSION