@kaddo/cli 3.27.0 → 3.27.1

package/README.md

@@ -518,6 +518,7 @@ create --from roadmap → owners → guard → explain`.
 | v3.25.1 | Savings guard-history messaging fix: distinguishes "no history" from "history with 0 resolved warnings" (drift prevention available at 0 h) |
 | v3.26 | Open-questions readiness gate: `kaddo questions`/`readiness`, blocking/important/deferred classification; MCP open-questions + roadmap-readiness resources + tool; roadmap/work-item/implementation/bootstrap agents check it |
 | v3.27 | Codex adapter: `kaddo adapters install codex` (alias `kaddo export codex`) generates a compact `AGENTS.md` projection (`--dry-run`/`--force`) |
+| 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 |
 
 **Optional modules (installed with `kaddo add`):**
 

package/dist/index.js

@@ -12441,6 +12441,32 @@ function renderAgentsMd(ctx) {
     }
     L.push("");
   }
+  L.push("## Command fallback", "");
+  L.push("Prefer the direct command when available:", "");
+  L.push("```bash");
+  L.push("kaddo <command>");
+  L.push("```");
+  L.push("");
+  L.push("If the global `kaddo` command is not available in `PATH`, try the local project runner");
+  L.push("before reporting that Kaddo is unavailable:", "");
+  L.push("```bash");
+  L.push("corepack pnpm exec kaddo <command>");
+  L.push("```");
+  L.push("");
+  L.push("If that is not available, try:", "");
+  L.push("```bash");
+  L.push("pnpm exec kaddo <command>");
+  L.push("```");
+  L.push("");
+  L.push("As a last resort (may resolve/download the package):", "");
+  L.push("```bash");
+  L.push("npx kaddo <command>");
+  L.push("```");
+  L.push("");
+  L.push("Do not assume Kaddo is unavailable until these local fallbacks have been attempted. When you");
+  L.push('use a fallback, mention it briefly (e.g. "the global `kaddo` was not available, so I used');
+  L.push('`corepack pnpm exec kaddo`").');
+  L.push("");
   L.push("## Useful Kaddo commands", "");
   L.push("```bash");
   for (const c of ["kaddo context", "kaddo understand", "kaddo explain", "kaddo graph export", "kaddo questions", "kaddo guard", "kaddo impact", "kaddo savings", "kaddo drift"]) {

package/package.json

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