@kaddo/cli 3.16.0 → 3.16.1

package/README.md

@@ -71,6 +71,10 @@ knowledge/
   config.yml               ← project config
 ```
 
+Asks for the project state (`new | pre-ai | legacy`), team size, repo structure and the
+**project knowledge language** (`en | es`) — the language your knowledge artifacts are
+written in; the CLI itself stays English.
+
 ---
 
 ### `kaddo scan`
@@ -265,12 +269,17 @@ concrete step (`kaddo scan` or `kaddo add agents`).
 Create a Work Item with the minimum context for its Knowledge Level.
 
 ```bash
-kaddo create feature   # K2: 4 questions
-kaddo create bugfix    # K2: 4 questions
-kaddo create hotfix    # K1: 2 questions
-kaddo create spike     # K3: 4 questions
+kaddo create feature   # K2: delivers a user-facing capability
+kaddo create bugfix    # K2: fixes a known defect
+kaddo create hotfix    # K1: urgent fix on a released version
+kaddo create spike     # K3: exploratory / reduce uncertainty
+kaddo create chore     # K1: maintenance, tooling, config, infra
 ```
 
+New Work Items land in `knowledge/delivery/work-items/draft/` with `status: draft`
+(lifecycle: `draft → ready → in-progress → blocked → completed → archived`). Aliases like
+`setup`, `tooling`, `maintenance`, `infrastructure` or `refactor` resolve to `chore`.
+
 **From a roadmap candidate:**
 
 ```bash
@@ -409,6 +418,25 @@ architecture baseline, roadmap, agents), work items, **ownership coverage**, the
 `kaddo explain` summarizes what Kaddo already knows. The focused flags
 (`--scope`, `--type`, `--since`) still explain a subset of artifacts.
 
+---
+
+### `kaddo capsule`
+
+Share or consume minimal, portable knowledge about a system — a **Knowledge Capsule** —
+without mapping it as multirepo or reading its source.
+
+```bash
+kaddo capsule export        # → .kaddo/exports/<project>.capsule.md / .json
+kaddo capsule add <path>    # import an external capsule → external/<id>.capsule.md
+```
+
+`export` builds a deterministic draft from `knowledge/` (purpose, capabilities, public
+contracts, risks, ADRs, owners — never source code or secrets); refine it with the
+`capsule-agent` before sharing. `add` registers the capsule in `.kaddo/external.yml`;
+`kaddo context` then includes an **External Knowledge** section and `kaddo explain` lists
+the capsules (warning when one looks stale). See the
+[Knowledge Capsules guide](https://kaddo.trycatch.tv/knowledge-capsules/).
+
 ## Roadmap
 
 The full knowledge loop ships today: `scan → context → agents → understand → roadmap →
@@ -441,6 +469,15 @@ create --from roadmap → owners → guard → explain`.
 | v3.6 | Flexible roadmap parsing and roadmap candidate/materialized Work Item reporting |
 | v3.7 | Work Item lifecycle active workspace (`draft`, `ready`, `in-progress`, `blocked`, `completed`, `archived`) |
 | v3.7.1 | Context Efficiency positioning: Repository Exploration Tax and structured-knowledge narrative |
+| v3.8 | Agent Trace & responsibility boundaries: every prompt declares Agent/Produced/Next; new `implementation-agent` (the only agent that may suggest a branch) |
+| v3.9 | New `chore` Work Item type (+ aliases setup/tooling/maintenance/infra); explain Work Items by Type; context Delivery Mix |
+| v3.9.1 | Unified knowledge artifact discovery: one service behind explain/context/owners/guard (fixes owners missing lifecycle subfolders) |
+| v3.10 | State-aware recommendations: real phase model (Discovery → Planning → Delivery Preparation → Active Delivery → Maintenance) drives understand/context/explain |
+| v3.11 | Command workflow clarity: official command matrix + "Question answered / Suggested next" footer on scan/context/explain/understand; `chore/` branch prefix |
+| v3.13 | New `backlog-agent`: capture raw ideas into a Work Item draft or roadmap candidate (human decides the next step) |
+| v3.14 | Project knowledge language (`project.language: en\|es`): knowledge in your language, CLI stays English; all agents respect it |
+| v3.15 | Delivery context consistency: phase-based handoff + per-phase LLM instructions; assisted `owners suggest` (normalize/validate globs); new `ownership-agent`; guard untracked-files warning; duplicate Work Item detection |
+| v3.16 | Knowledge Capsules: `kaddo capsule export/add`, External Knowledge in context/explain, new `capsule-agent` |
 
 **Optional modules (installed with `kaddo add`):**
 

package/dist/index.js

@@ -672,7 +672,15 @@ var COMMAND_HELP = {
     question: "Is knowledge drifting from code?",
     next: "Update the affected knowledge, then commit"
   },
-  "add agents": { question: "Which agents are available?", next: "kaddo understand" }
+  "add agents": { question: "Which agents are available?", next: "kaddo understand" },
+  "capsule export": {
+    question: "How do I share this project as external context?",
+    next: "Refine with the capsule-agent, then share the capsule file"
+  },
+  "capsule add": {
+    question: "How do I consume another system as external context?",
+    next: "kaddo context (the pack now includes External Knowledge)"
+  }
 };
 function commandFooterLines(name) {
   const help = COMMAND_HELP[name];
@@ -3345,6 +3353,9 @@ var agentReadme = {
     "- **pre-ai** \u2192 capability-agent \u2192 architecture-agent \u2192 roadmap-agent",
     "- **legacy** \u2192 legacy-agent \u2192 architecture-agent \u2192 capability-agent \u2192 roadmap-agent",
     "",
+    "Then, in delivery: backlog-agent (capture ideas) \u2192 work-item-agent (refine) \u2192",
+    "ownership-agent (propose code: globs) \u2192 implementation-agent (build).",
+    "",
     "## Installed agents",
     "",
     "### Bootstrap agents (new projects)",
@@ -3361,14 +3372,22 @@ var agentReadme = {
     "- `legacy-agent.md` \u2014 analyze risks/unknowns before changing legacy code.",
     "- `adr-agent.md` \u2014 propose candidate architecture decisions.",
     "",
-    "### Operational agents",
+    "### Delivery agents",
     "",
+    "- `backlog-agent.md` \u2014 capture raw ideas/notes into a Work Item draft or roadmap candidate.",
     "- `work-item-agent.md` \u2014 refine roadmap candidates or existing Work Items.",
+    "- `implementation-agent.md` \u2014 implement a refined Work Item (the only agent that may",
+    "  suggest a branch; never runs git).",
+    "- `ownership-agent.md` \u2014 propose precise `code:` globs (human applies with `kaddo owners suggest`).",
     "- `git-strategy-agent.md` \u2014 define branch/commit/tag/release strategy.",
+    "",
+    "### Operational agents",
+    "",
     "- `security-agent.md` \u2014 document security considerations (no scanning).",
     "- `standards-agent.md` \u2014 propose lightweight coding/docs/architecture standards.",
     "- `stack-agent.md` \u2014 document technologies and stack decisions.",
-    "- `module-design-agent.md` \u2014 document the design of a mapped module."
+    "- `module-design-agent.md` \u2014 document the design of a mapped module.",
+    "- `capsule-agent.md` \u2014 refine a Knowledge Capsule for external sharing (no secrets/source)."
   ].join("\n")
 };
 var agentFiles = AGENT_PROMPTS.map((a) => ({
@@ -9726,6 +9745,7 @@ function runCapsuleExport() {
   log2.success(`Wrote ${mdPath}`);
   log2.success(`Wrote ${jsonPath}`);
   log2.info("Refine it with the capsule-agent before sharing \u2014 and never include secrets or source code.");
+  printCommandFooter("capsule export");
   outro2("Knowledge Capsule exported.");
 }
 function runCapsuleAdd(srcPath) {
@@ -9749,6 +9769,7 @@ function runCapsuleAdd(srcPath) {
   log2.success(`Imported capsule "${result.id}" \u2192 ${result.destRel}`);
   log2.success("Registered in .kaddo/external.yml");
   log2.info('Run `kaddo context` \u2014 the pack now includes an "External Knowledge" section.');
+  printCommandFooter("capsule add");
   outro2("External capsule registered.");
 }
 

package/package.json

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