@kaddo/cli 3.28.0 → 3.28.2

package/README.md

@@ -522,6 +522,8 @@ create --from roadmap → owners → guard → explain`.
 | 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 |
+| v3.28.2 | Adapter inject guard: `--inject` on a fully Kaddo-generated AGENTS.md/CLAUDE.md does nothing (suggests `--force`), preventing duplicated Kaddo guidance |
 
 **Optional modules (installed with `kaddo add`):**
 

package/dist/index.js

@@ -12513,16 +12513,25 @@ function renderAdapterMarkdown(ctx, target) {
   L.push("");
   return L.join("\n");
 }
-function renderAgentsMd(ctx) {
-  return renderAdapterMarkdown(ctx, "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;
 }
-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`";
 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";
@@ -12579,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";
@@ -12599,7 +12608,7 @@ ${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: false }
+  claude: { target: "claude", file: "CLAUDE.md", label: "Claude Code", supportsInject: true }
 };
 function runAdaptersInstall(adapter, opts = {}) {
   const dir = cwd();
@@ -12625,8 +12634,17 @@ function runAdaptersInstall(adapter, opts = {}) {
       process.exit(1);
       return;
     }
+    if (state === "generated_by_kaddo") {
+      intro2(`${cmd} --inject`);
+      log2.warn(`${rel} is already fully generated by Kaddo.`);
+      log2.info("Nothing injected to avoid duplicated Kaddo guidance.");
+      log2.info(`Use \`${cmd} --force\` to regenerate the full file.`);
+      log2.info(`\`--inject\` is for team-owned files: keep your own ${rel} and run \`${cmd} --inject\` to add the Kaddo block.`);
+      outro2("Nothing changed.");
+      return;
+    }
     if (existing === null) {
-      const content2 = renderAgentsMd(ctx);
+      const content2 = renderAdapterMarkdown(ctx, spec.target);
       if (opts.dryRun) {
         console.log(`# ${rel} preview`, "");
         console.log(content2);

package/package.json

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