@kaddo/cli 3.31.0 → 3.32.0

package/README.md

@@ -527,6 +527,7 @@ create --from roadmap → owners → guard → explain`.
 | v3.29 | OpenCode adapter: `kaddo adapters install opencode` (alias `kaddo export opencode`) generates an `AGENTS.md` projection reusing the shared adapter common core (`--dry-run`/`--force`/`--inject` + inject guard) |
 | v3.30 | Antigravity adapter: `kaddo adapters install antigravity` (alias `kaddo export antigravity`) generates an `AGENTS.md` projection reusing the shared adapter common core (`--dry-run`/`--force`/`--inject` + inject guard) |
 | v3.31 | Kiro adapter: `kaddo adapters install kiro` (alias `kaddo export kiro`) generates an `AGENTS.md` projection reusing the shared adapter common core (`--dry-run`/`--force`/`--inject` + inject guard) |
+| v3.32 | Adapter discovery & status: `kaddo adapters list` (alias `ls`) and `kaddo adapters status` (alias `check`) — read-only catalog + per-adapter install state (missing/team-owned/injected/legacy-injected/full-generated/broken-markers), shared-`AGENTS.md` origin detection, `--json` |
 
 **Optional modules (installed with `kaddo add`):**
 

package/dist/index.js

@@ -12610,21 +12610,92 @@ function injectKaddoBlock(existing, ctx) {
 ${sep}${block}
 `, status: "injected" };
 }
+var ADAPTERS = [
+  { id: "codex", label: "Codex", file: "AGENTS.md", supportsInject: true },
+  { id: "claude", label: "Claude Code", file: "CLAUDE.md", supportsInject: true },
+  { id: "opencode", label: "OpenCode", file: "AGENTS.md", supportsInject: true },
+  { id: "antigravity", label: "Antigravity", file: "AGENTS.md", supportsInject: true },
+  { id: "kiro", label: "Kiro", file: "AGENTS.md", supportsInject: true }
+];
+function findAdapter(id) {
+  return ADAPTERS.find((a) => a.id === id);
+}
+function parseOriginAdapter(content) {
+  const m = content.match(/Generated by `kaddo adapters install (\w+)`/);
+  const id = m?.[1];
+  return id && findAdapter(id) ? id : null;
+}
+function classifyAdapterState(content) {
+  const base = detectAgentsState(content);
+  switch (base) {
+    case "missing":
+      return "missing";
+    case "invalid_kaddo_block":
+      return "broken-markers";
+    case "generated_by_kaddo":
+      return "full-generated";
+    case "existing_with_kaddo_block":
+      return content.includes(LEGACY_BEGIN_MARKER) ? "legacy-injected" : "injected";
+    default:
+      return "team-owned";
+  }
+}
+function recommendedAction(a, state) {
+  const cmd = `kaddo adapters install ${a.id}`;
+  switch (state) {
+    case "missing":
+      return cmd;
+    case "team-owned":
+      return `${cmd} --inject`;
+    case "injected":
+      return "No action needed (run --inject to update the Kaddo block).";
+    case "legacy-injected":
+      return `${cmd} --inject (migrates legacy markers to neutral)`;
+    case "full-generated":
+      return `No action needed. Use \`${cmd} --force\` only to regenerate for ${a.label}.`;
+    case "broken-markers":
+      return "Fix the incomplete Kaddo adapter markers before running --inject.";
+  }
+}
+function buildAdapterStatuses(dir) {
+  const cache = /* @__PURE__ */ new Map();
+  const read = (file) => {
+    if (!cache.has(file)) {
+      const full = join(dir, file);
+      cache.set(file, exists(full) ? readFile(full) : null);
+    }
+    return cache.get(file);
+  };
+  return ADAPTERS.map((a) => {
+    const content = read(a.file);
+    const state = classifyAdapterState(content);
+    const originAdapter = content ? parseOriginAdapter(content) : null;
+    return { ...a, state, originAdapter, recommendedAction: recommendedAction(a, state) };
+  });
+}
+function buildSharedFileStatuses(statuses) {
+  const byFile = /* @__PURE__ */ new Map();
+  for (const s of statuses) {
+    const arr = byFile.get(s.file) ?? [];
+    arr.push(s);
+    byFile.set(s.file, arr);
+  }
+  return [...byFile.entries()].filter(([, arr]) => arr.length > 1).map(([file, arr]) => ({
+    file,
+    adapters: arr.map((s) => s.id),
+    state: arr[0].state,
+    originAdapter: arr[0].originAdapter
+  }));
+}
 
 // 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 },
-  opencode: { target: "opencode", file: "AGENTS.md", label: "OpenCode", supportsInject: true },
-  antigravity: { target: "antigravity", file: "AGENTS.md", label: "Antigravity", supportsInject: true },
-  kiro: { target: "kiro", file: "AGENTS.md", label: "Kiro", supportsInject: true }
-};
+var ADAPTER_LIST = ADAPTERS.map((a) => a.id).join(", ");
 function runAdaptersInstall(adapter, opts = {}) {
   const dir = cwd();
   requireConfig(dir);
-  const spec = TARGETS2[adapter];
+  const spec = findAdapter(adapter);
   if (!spec) {
-    console.error(`Unknown adapter: "${adapter}". Available: ${Object.keys(TARGETS2).join(", ")}.`);
+    console.error(`Unknown adapter: "${adapter}". Available: ${ADAPTER_LIST}.`);
     process.exit(1);
     return;
   }
@@ -12653,7 +12724,7 @@ function runAdaptersInstall(adapter, opts = {}) {
       return;
     }
     if (existing === null) {
-      const content2 = renderAdapterMarkdown(ctx, spec.target);
+      const content2 = renderAdapterMarkdown(ctx, spec.id);
       if (opts.dryRun) {
         console.log(`# ${rel} preview`, "");
         console.log(content2);
@@ -12684,7 +12755,7 @@ function runAdaptersInstall(adapter, opts = {}) {
     outro2(`${rel} ready.`);
     return;
   }
-  const content = renderAdapterMarkdown(ctx, spec.target);
+  const content = renderAdapterMarkdown(ctx, spec.id);
   if (opts.dryRun) {
     console.log(`# ${rel} preview`, "");
     console.log(content);
@@ -12704,6 +12775,58 @@ function runAdaptersInstall(adapter, opts = {}) {
   printCommandFooter("adapters install codex");
   outro2(`${rel} ready.`);
 }
+function runAdaptersList(opts = {}) {
+  if (opts.json) {
+    console.log(JSON.stringify({ adapters: ADAPTERS.map((a) => ({ id: a.id, label: a.label, file: a.file, supports_inject: a.supportsInject })) }, null, 2));
+    return;
+  }
+  const pad = Math.max(...ADAPTERS.map((a) => a.id.length));
+  console.log("Available adapters:\n");
+  for (const a of ADAPTERS) {
+    console.log(`  ${a.id.padEnd(pad)}  ${a.file.padEnd(10)} ${a.supportsInject ? "Supports --inject" : ""}`.trimEnd());
+  }
+  console.log("\nInstall one with:\n  kaddo adapters install <adapter>");
+  console.log("\nPreview with:\n  kaddo adapters install <adapter> --dry-run");
+}
+function runAdaptersStatus(opts = {}) {
+  const dir = cwd();
+  requireConfig(dir);
+  const statuses = buildAdapterStatuses(dir);
+  if (opts.json) {
+    console.log(JSON.stringify({
+      adapters: statuses.map((s) => ({
+        id: s.id,
+        label: s.label,
+        file: s.file,
+        state: s.state,
+        origin_adapter: s.originAdapter,
+        supports_inject: s.supportsInject,
+        recommended_action: s.recommendedAction
+      })),
+      shared_files: buildSharedFileStatuses(statuses).map((f) => ({
+        file: f.file,
+        adapters: f.adapters,
+        state: f.state,
+        origin_adapter: f.originAdapter
+      }))
+    }, null, 2));
+    return;
+  }
+  const idPad = Math.max(...statuses.map((s) => s.id.length));
+  console.log("Adapter status:\n");
+  for (const s of statuses) {
+    const origin = s.originAdapter && s.originAdapter !== s.id ? ` by ${s.originAdapter}` : "";
+    console.log(`  ${s.id.padEnd(idPad)}  ${s.file.padEnd(10)} ${s.state}${origin}`);
+  }
+  const actionable = statuses.filter((s) => s.state !== "injected" && s.state !== "full-generated");
+  if (actionable.length > 0) {
+    console.log("\nRecommended actions:\n");
+    for (const s of actionable) console.log(`  ${s.id}:
+    ${s.recommendedAction}`);
+  } else {
+    console.log("\nAll adapters are installed or up to date.");
+  }
+}
 
 // src/index.ts
 var require2 = createRequire(import.meta.url);
@@ -12762,6 +12885,12 @@ var adaptersCmd = program.command("adapters").description("Generate adapters tha
 adaptersCmd.command("install <adapter>").description("Generate an adapter file (codex/opencode/antigravity/kiro \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);
 });
+adaptersCmd.command("list").alias("ls").description("List the supported adapters and their target files").option("--json", "Output JSON").action((opts) => {
+  runAdaptersList(opts);
+});
+adaptersCmd.command("status").alias("check").description("Show the install state of each adapter in this project (read-only)").option("--json", "Output JSON").action((opts) => {
+  runAdaptersStatus(opts);
+});
 program.command("export <adapter>").description("Alias for `kaddo adapters install <adapter>` (codex/opencode/antigravity/kiro \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);
 });

package/package.json

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