@kaddo/cli 3.27.3 → 3.28.1

package/README.md

@@ -521,6 +521,8 @@ create --from roadmap → owners → guard → explain`.
 | v3.27.1 | Codex adapter command fallbacks: AGENTS.md tells Codex to try `corepack pnpm exec` / `pnpm exec` / `npx` kaddo when the global binary isn't on PATH |
 | v3.27.2 | Codex adapter safe merge: `kaddo adapters install codex --inject` adds/updates only a delimited Kaddo block in an existing AGENTS.md, preserving team content |
 | v3.27.3 | Codex adapter reference stabilization: package-manager-aware command fallbacks (lockfile detection) + Adapter Contract & Custom Adapters docs (reference for future adapters) |
+| v3.28 | Claude Code adapter: `kaddo adapters install claude` (alias `kaddo export claude`) generates a `CLAUDE.md` projection reusing the shared adapter common core (`--dry-run`/`--force`) |
+| v3.28.1 | Claude adapter safe merge: `--inject` works for `CLAUDE.md` too; adapter markers are now target-neutral (`KADDO ADAPTER`) and legacy Codex markers auto-migrate on update |
 
 **Optional modules (installed with `kaddo add`):**
 

package/dist/index.js

@@ -12404,11 +12404,13 @@ var ROLE_HINTS = {
   "graph-agent": "use to turn graph hints into front matter.",
   "capsule-agent": "use to refine a Knowledge Capsule for sharing."
 };
-function renderAgentsMd(ctx) {
+var TARGET_FILE = { codex: "AGENTS.md", claude: "CLAUDE.md" };
+function renderAdapterMarkdown(ctx, target) {
+  const file = TARGET_FILE[target];
   const L = [];
-  L.push("<!-- Generated by `kaddo adapters install codex`. Kaddo is the source of truth \u2014");
+  L.push(`<!-- Generated by \`kaddo adapters install ${target}\`. Kaddo is the source of truth \u2014`);
   L.push("     regenerate this file instead of editing it by hand. Do not treat it as primary. -->");
-  L.push("# AGENTS.md", "");
+  L.push(`# ${file}`, "");
   L.push("## Project guidance", "");
   if (ctx.projectName) L.push(`Project: **${ctx.projectName}**${ctx.projectType ? ` (${ctx.projectType})` : ""}.`, "");
   L.push("This repository uses **Kaddo** for Knowledge Driven Development. Kaddo keeps business,");
@@ -12511,13 +12513,25 @@ function renderAgentsMd(ctx) {
   L.push("");
   return L.join("\n");
 }
-var KADDO_BEGIN_MARKER = "<!-- BEGIN KADDO CODEX ADAPTER -->";
-var KADDO_END_MARKER = "<!-- END KADDO CODEX ADAPTER -->";
-var GENERATED_HEADER = "Generated by `kaddo adapters install codex`";
+var KADDO_BEGIN_MARKER = "<!-- BEGIN KADDO ADAPTER -->";
+var KADDO_END_MARKER = "<!-- END KADDO ADAPTER -->";
+var LEGACY_BEGIN_MARKER = "<!-- BEGIN KADDO CODEX ADAPTER -->";
+var LEGACY_END_MARKER = "<!-- END KADDO CODEX ADAPTER -->";
+var GENERATED_HEADER = "Generated by `kaddo adapters install ";
+function findMarker(content, neutral, legacy) {
+  const a = content.indexOf(neutral);
+  const b = content.indexOf(legacy);
+  if (a === -1) return b;
+  if (b === -1) return a;
+  return Math.min(a, b);
+}
+function markerLength(content, neutral, legacy) {
+  return content.includes(neutral) ? neutral.length : legacy.length;
+}
 function detectAgentsState(content) {
   if (content === null) return "missing";
-  const hasBegin = content.includes(KADDO_BEGIN_MARKER);
-  const hasEnd = content.includes(KADDO_END_MARKER);
+  const hasBegin = content.includes(KADDO_BEGIN_MARKER) || content.includes(LEGACY_BEGIN_MARKER);
+  const hasEnd = content.includes(KADDO_END_MARKER) || content.includes(LEGACY_END_MARKER);
   if (hasBegin !== hasEnd) return "invalid_kaddo_block";
   if (hasBegin && hasEnd) return "existing_with_kaddo_block";
   if (content.includes(GENERATED_HEADER)) return "generated_by_kaddo";
@@ -12574,15 +12588,15 @@ function renderKaddoBlock(ctx) {
 }
 function injectKaddoBlock(existing, ctx) {
   const block = renderKaddoBlock(ctx);
-  const begin = existing.indexOf(KADDO_BEGIN_MARKER);
-  const end = existing.indexOf(KADDO_END_MARKER);
+  const begin = findMarker(existing, KADDO_BEGIN_MARKER, LEGACY_BEGIN_MARKER);
+  const end = findMarker(existing, KADDO_END_MARKER, LEGACY_END_MARKER);
   if (begin === -1 !== (end === -1)) {
     throw new Error("Invalid Kaddo adapter block: found one marker without its pair.");
   }
   if (begin !== -1 && end !== -1) {
     if (end < begin) throw new Error("Invalid Kaddo adapter block: END marker before BEGIN marker.");
     const before = existing.slice(0, begin);
-    const after = existing.slice(end + KADDO_END_MARKER.length);
+    const after = existing.slice(end + markerLength(existing, KADDO_END_MARKER, LEGACY_END_MARKER));
     return { content: `${before}${block}${after}`, status: "updated" };
   }
   const sep = existing.endsWith("\n") ? "\n" : "\n\n";
@@ -12592,77 +12606,85 @@ ${sep}${block}
 }
 
 // src/commands/adapters.ts
+var TARGETS2 = {
+  codex: { target: "codex", file: "AGENTS.md", label: "Codex", supportsInject: true },
+  claude: { target: "claude", file: "CLAUDE.md", label: "Claude Code", supportsInject: true }
+};
 function runAdaptersInstall(adapter, opts = {}) {
   const dir = cwd();
   requireConfig(dir);
-  if (adapter !== "codex") {
-    console.error(`Unknown adapter: "${adapter}". Available: codex.`);
+  const spec = TARGETS2[adapter];
+  if (!spec) {
+    console.error(`Unknown adapter: "${adapter}". Available: ${Object.keys(TARGETS2).join(", ")}.`);
     process.exit(1);
+    return;
   }
   const ctx = buildCodexAdapterContext(dir);
-  const rel = "AGENTS.md";
+  const rel = spec.file;
   const full = join(dir, rel);
   const existed = exists(full);
   const existing = existed ? readFile(full) : null;
-  if (opts.inject) {
+  const cmd = `kaddo adapters install ${adapter}`;
+  if (opts.inject && spec.supportsInject) {
     const state = detectAgentsState(existing);
     if (state === "invalid_kaddo_block") {
-      console.error("Invalid Kaddo adapter block detected in AGENTS.md.");
+      console.error(`Invalid Kaddo adapter block detected in ${rel}.`);
       console.error("Found one marker without its pair. Fix the file manually or use --force to overwrite.");
       console.error("Nothing changed.");
       process.exit(1);
+      return;
     }
     if (existing === null) {
-      const content2 = renderAgentsMd(ctx);
+      const content2 = renderAdapterMarkdown(ctx, spec.target);
       if (opts.dryRun) {
-        console.log("# AGENTS.md preview", "");
+        console.log(`# ${rel} preview`, "");
         console.log(content2);
         return;
       }
-      intro2("kaddo adapters install codex --inject");
+      intro2(`${cmd} --inject`);
       writeFile(full, content2);
-      log2.success("Created AGENTS.md for Codex.");
+      log2.success(`Created ${rel} for ${spec.label}.`);
       printCommandFooter("adapters install codex");
-      outro2("AGENTS.md ready.");
+      outro2(`${rel} ready.`);
       return;
     }
     const merged = injectKaddoBlock(existing, ctx);
     if (opts.dryRun) {
-      console.log("# AGENTS.md preview (inject)", "");
+      console.log(`# ${rel} preview (inject)`, "");
       console.log(merged.content);
       return;
     }
-    intro2("kaddo adapters install codex --inject");
+    intro2(`${cmd} --inject`);
     writeFile(full, merged.content);
     if (merged.status === "updated") {
-      log2.success("Updated existing Kaddo guidance block in AGENTS.md.");
+      log2.success(`Updated existing Kaddo guidance block in ${rel}.`);
     } else {
-      log2.success("Injected Kaddo guidance block into AGENTS.md.");
+      log2.success(`Injected Kaddo guidance block into ${rel}.`);
     }
     log2.info("Content outside the Kaddo markers was preserved.");
     printCommandFooter("adapters install codex");
-    outro2("AGENTS.md ready.");
+    outro2(`${rel} ready.`);
     return;
   }
-  const content = renderAgentsMd(ctx);
+  const content = renderAdapterMarkdown(ctx, spec.target);
   if (opts.dryRun) {
-    console.log("# AGENTS.md preview", "");
+    console.log(`# ${rel} preview`, "");
     console.log(content);
     return;
   }
-  intro2("kaddo adapters install codex");
+  intro2(cmd);
   if (existed && !opts.force) {
-    log2.warn("AGENTS.md already exists.");
-    log2.info("Use `--inject` to add or update only the Kaddo block,");
-    log2.info("`--force` to overwrite, or `--dry-run` to preview.");
+    log2.warn(`${rel} already exists.`);
+    if (spec.supportsInject) log2.info("Use `--inject` to add or update only the Kaddo block,");
+    log2.info(`Use \`--force\` to overwrite, or \`--dry-run\` to preview.`);
     outro2("Nothing changed.");
     return;
   }
   writeFile(full, content);
-  log2.success(`${existed ? "Overwrote" : "Created"} AGENTS.md for Codex.`);
+  log2.success(`${existed ? "Overwrote" : "Created"} ${rel} for ${spec.label}.`);
   log2.info("Source: Kaddo project knowledge. Regenerate it instead of editing by hand.");
   printCommandFooter("adapters install codex");
-  outro2("AGENTS.md ready.");
+  outro2(`${rel} ready.`);
 }
 
 // src/index.ts
@@ -12719,10 +12741,10 @@ var questionsAction = (opts) => runQuestions(opts);
 program.command("questions").description("Open-questions readiness gate: blocking/important/deferred decisions before the roadmap").option("--json", "Output JSON instead of a summary").option("--output <path>", "Write the report to a file (e.g. .kaddo/reports/questions-report.md)").action(questionsAction);
 program.command("readiness").description("Alias for `kaddo questions`").option("--json", "Output JSON instead of a summary").option("--output <path>", "Write the report to a file").action(questionsAction);
 var adaptersCmd = program.command("adapters").description("Generate adapters that project Kaddo knowledge for external coding agents");
-adaptersCmd.command("install <adapter>").description("Generate an adapter file (codex \u2192 AGENTS.md) from Kaddo knowledge").option("--force", "Overwrite an existing output file").option("--inject", "Add or update only the Kaddo block in an existing file, preserving the rest").option("--dry-run", "Print the content without writing files").action((adapter, opts) => {
+adaptersCmd.command("install <adapter>").description("Generate an adapter file (codex \u2192 AGENTS.md, claude \u2192 CLAUDE.md) from Kaddo knowledge").option("--force", "Overwrite an existing output file").option("--inject", "Add or update only the Kaddo block in an existing file, preserving the rest").option("--dry-run", "Print the content without writing files").action((adapter, opts) => {
   runAdaptersInstall(adapter, opts);
 });
-program.command("export <adapter>").description("Alias for `kaddo adapters install <adapter>` (codex \u2192 AGENTS.md)").option("--force", "Overwrite an existing output file").option("--inject", "Add or update only the Kaddo block in an existing file, preserving the rest").option("--dry-run", "Print the content without writing files").action((adapter, opts) => {
+program.command("export <adapter>").description("Alias for `kaddo adapters install <adapter>` (codex \u2192 AGENTS.md, claude \u2192 CLAUDE.md)").option("--force", "Overwrite an existing output file").option("--inject", "Add or update only the Kaddo block in an existing file, preserving the rest").option("--dry-run", "Print the content without writing files").action((adapter, opts) => {
   runAdaptersInstall(adapter, opts);
 });
 program.command("guard").description("Check if modified code has related artifacts that were not updated").option("--staged", "Check only staged files").option("--no-interactive", "Disable interactive ignore prompts").option("--ci", "CI mode: output JSON, no prompts, non-blocking").option("--json", "Output JSON (alias for --ci)").option("--workspace", "Also check local mapped module repos from .kaddo/modules.yml (opt-in)").option("--include-archived", "Include archived Work Items in ownership matching (excluded by default)").option("--record", "Record this run to .kaddo/history/ for drift trend reporting").action(async (opts) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kaddo/cli",
-  "version": "3.27.3",
+  "version": "3.28.1",
   "description": "Knowledge Driven Development toolkit",
   "license": "MIT",
   "repository": {