@kaddo/cli 3.28.1 → 3.29.0

package/README.md

@@ -523,6 +523,8 @@ create --from roadmap → owners → guard → explain`.
 | 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 |
+| 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) |
 
 **Optional modules (installed with `kaddo add`):**
 

package/dist/index.js

@@ -12404,7 +12404,11 @@ var ROLE_HINTS = {
   "graph-agent": "use to turn graph hints into front matter.",
   "capsule-agent": "use to refine a Knowledge Capsule for sharing."
 };
-var TARGET_FILE = { codex: "AGENTS.md", claude: "CLAUDE.md" };
+var TARGET_FILE = {
+  codex: "AGENTS.md",
+  claude: "CLAUDE.md",
+  opencode: "AGENTS.md"
+};
 function renderAdapterMarkdown(ctx, target) {
   const file = TARGET_FILE[target];
   const L = [];
@@ -12608,7 +12612,8 @@ ${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 }
+  claude: { target: "claude", file: "CLAUDE.md", label: "Claude Code", supportsInject: true },
+  opencode: { target: "opencode", file: "AGENTS.md", label: "OpenCode", supportsInject: true }
 };
 function runAdaptersInstall(adapter, opts = {}) {
   const dir = cwd();
@@ -12634,6 +12639,15 @@ 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 = renderAdapterMarkdown(ctx, spec.target);
       if (opts.dryRun) {
@@ -12741,10 +12755,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, 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) => {
+adaptersCmd.command("install <adapter>").description("Generate an adapter file (codex/opencode \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, 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) => {
+program.command("export <adapter>").description("Alias for `kaddo adapters install <adapter>` (codex/opencode \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.28.1",
+  "version": "3.29.0",
   "description": "Knowledge Driven Development toolkit",
   "license": "MIT",
   "repository": {