@kaddo/cli 3.13.1 → 3.14.0

package/dist/index.js

@@ -101,6 +101,7 @@ project:
   name: "${meta.name}"
   state: ${meta.state}
   structure: ${meta.structure}
+  language: ${meta.language}
   domains: []
 team:
   size: ${meta.teamSize}
@@ -210,11 +211,20 @@ async function runInit() {
     ],
     initialValue: "monorepo"
   });
+  const language = await select2({
+    message: "Project knowledge language (the CLI stays in English)",
+    options: [
+      { value: "en", label: "English" },
+      { value: "es", label: "Spanish" }
+    ],
+    initialValue: "en"
+  });
   const meta = {
     name: projectName.trim(),
     state,
     teamSize,
-    structure
+    structure,
+    language
   };
   const kaddoConfigPath = join(dir, KADDO_DIR, "config.yml");
   writeFile(kaddoConfigPath, buildConfig(meta));
@@ -510,11 +520,20 @@ import { parse as parseYaml2 } from "yaml";
 var PROJECT_STATES = ["new", "pre-ai", "legacy"];
 var TEAM_SIZES = ["indie", "small", "medium", "enterprise"];
 var REPOSITORY_STRUCTURES = ["monorepo", "multirepo"];
+var PROJECT_LANGUAGES = ["en", "es"];
 var DEFAULTS = {
   state: "pre-ai",
   structure: "monorepo",
-  teamSize: "indie"
+  teamSize: "indie",
+  language: "en"
 };
+function languageLabel(lang) {
+  return lang === "es" ? "Spanish" : "English";
+}
+function projectLanguage(config) {
+  const lang = config.project.language;
+  return lang === "es" ? "es" : "en";
+}
 var ConfigError = class extends Error {
   constructor(message) {
     super(message);
@@ -536,12 +555,18 @@ var structureSchema = z.enum(["monorepo", "multirepo"], {
     message: `project.structure must be one of: ${REPOSITORY_STRUCTURES.join(", ")}`
   })
 });
+var languageSchema = z.enum(["en", "es"], {
+  errorMap: () => ({
+    message: `project.language must be one of: ${PROJECT_LANGUAGES.join(", ")}`
+  })
+});
 var configSchema = z.object({
   version: z.union([z.string(), z.number()]).optional(),
   project: z.object({
     name: z.string().default("project"),
     state: projectStateSchema.default(DEFAULTS.state),
     structure: structureSchema.default(DEFAULTS.structure),
+    language: languageSchema.default(DEFAULTS.language),
     domains: z.array(z.string()).optional()
   }).passthrough().default({}),
   team: z.object({
@@ -1654,11 +1679,24 @@ function renderAgentTrace(agent) {
     ""
   ].join("\n");
 }
+function renderLanguageRule() {
+  return [
+    "## Project Language",
+    "",
+    "The project knowledge language is defined in `.kaddo/config.yml` (`project.language`) and shown",
+    "in the context pack's Project Metadata (`Language:`). Write **all** generated knowledge",
+    "artifacts in that language (default: English).",
+    "",
+    "Do not translate: code, file names, CLI commands or configuration keys.",
+    ""
+  ].join("\n");
+}
 function withResponsibilityTrace(fileName, content) {
   const agent = fileName.replace(/\.md$/, "");
   if (!RESPONSIBILITY_MATRIX[agent]) return content;
   return `${content.trimEnd()}
 
+${renderLanguageRule()}
 ${renderAgentBoundaries(agent)}
 ${renderAgentTrace(agent)}`;
 }
@@ -2214,10 +2252,12 @@ A refined Work Item intended to be saved under the lifecycle workspace:
    Keep \`chore\` for maintenance/tooling/config/infra work \u2014 never upgrade a chore to a feature.
 4. Validate the Knowledge Level (K0\u2013K4) and propose a different one if needed.
 5. Propose acceptance criteria.
-6. Propose Out of scope and Validation sections.
-7. Propose a Definition of Done.
-8. Identify open questions and assumptions.
-9. Suggest ownership candidates (code globs) if evident.
+6. Propose an Out of scope section.
+7. Propose **how to test it** \u2014 concrete validation steps (commands to run, manual steps, or
+   test cases) that prove the change works once implemented. This is mandatory.
+8. Propose a Definition of Done.
+9. Identify open questions and assumptions.
+10. Suggest ownership candidates (code globs) if evident.
 
 ## Constraints
 
@@ -2241,7 +2281,11 @@ A refined Work Item intended to be saved under the lifecycle workspace:
 
 **Out of scope:**
 
-**Validation:**
+**How to test it (validation):**
+<!-- concrete steps to verify once implemented, e.g.:
+1. \`pnpm test path/to/spec\`  (or the project's test command)
+2. Manual: <action> \u2192 expected <result>
+3. \`kaddo guard\` shows no unexpected drift -->
 
 **Definition of Done:**
 
@@ -2261,7 +2305,7 @@ and \`blocked\` as active work; \`completed\` and \`archived\` are historical kn
 When the Work Item is refined and ready to build, **hand off to the implementation-agent**.
 You do **not** suggest branches, commits or pull requests \u2014 implementation (including any Git
 branch suggestion) is the implementation-agent's responsibility, and only by respecting the
-project Git strategy. Your job ends at a clear, traceable Work Item.
+project Git strategy. Your job ends at a clear, traceable Work Item that **states how to test it**.
 
 ## Quality Checklist
 
@@ -2269,7 +2313,8 @@ project Git strategy. Your job ends at a clear, traceable Work Item.
 - Large candidates are split.
 - Knowledge Level is justified.
 - Acceptance criteria are testable.
-- Out of scope and Validation are stated.
+- Out of scope is stated.
+- **How to test it** is concrete (commands, manual steps, or test cases).
 - Open questions are explicit.
 - Handoff: next step is the implementation-agent (never a branch or commit).
 `;
@@ -2822,7 +2867,9 @@ Conventional Commit message \u2014 as suggestions, never executed.
 4. Suggest running \`kaddo owners suggest\` and confirm the \`code:\` globs.
 5. Suggest running \`kaddo guard\` before committing to detect knowledge drift.
 6. Update affected knowledge (ADR / capabilities.md / current-state.md).
-7. Suggest a Conventional Commit message and **wait for explicit human confirmation**. Never
+7. **Explain how to test it** \u2014 the exact commands and/or manual steps to verify the change works
+   (run the Work Item's "How to test it" steps and report the result).
+8. Suggest a Conventional Commit message and **wait for explicit human confirmation**. Never
    commit, push or merge on your own.
 
 ## Constraints
@@ -2845,6 +2892,9 @@ Conventional Commit message \u2014 as suggestions, never executed.
 
 ## Tests
 
+## How to test it
+<!-- exact commands and/or manual steps to verify, e.g. run the test suite, start the app then <action> -->
+
 ## Knowledge to update
 
 ## Suggested commit (await human confirmation)
@@ -2858,6 +2908,7 @@ Code, tests and migrations live in the repository. Knowledge updates go under \`
 
 - A branch is suggested per the Git strategy (never executed).
 - Tests accompany the change.
+- **How to test it** is stated (exact commands / manual steps to verify).
 - \`kaddo scan\` / \`owners suggest\` / \`guard\` are suggested at the right moments.
 - Affected knowledge is updated.
 - Commit is suggested and awaits human confirmation \u2014 never run automatically.
@@ -5258,7 +5309,8 @@ function buildProjectExplanation(dir) {
     name: config?.project.name ?? "unknown",
     state: config?.project.state ?? "unknown",
     teamSize: config?.team.size ?? "unknown",
-    structure: config?.project.structure ?? "unknown"
+    structure: config?.project.structure ?? "unknown",
+    language: config ? languageLabel(projectLanguage(config)) : "English"
   };
   const scan2 = loadScan(dir);
   const stack = scan2 ? {
@@ -5404,6 +5456,7 @@ function renderExplanationHuman(exp) {
   lines.push(`- State: ${stateLabel(exp.project.state)}`);
   lines.push(`- Team: ${exp.project.teamSize}`);
   lines.push(`- Structure: ${exp.project.structure}`);
+  lines.push(`- Project language: ${exp.project.language}`);
   lines.push("");
   lines.push("## Knowledge Layers");
   lines.push(renderLayersMarkdown(exp.layers));
@@ -5873,7 +5926,8 @@ function buildContextPack(dir, config, now = /* @__PURE__ */ new Date()) {
       name: config.project.name,
       state,
       teamSize: config.team.size,
-      structure: config.project.structure
+      structure: config.project.structure,
+      language: languageLabel(projectLanguage(config))
     },
     scan: {
       available: scanJson !== null,
@@ -5929,7 +5983,8 @@ function renderContextPack(pack) {
       `- Name: ${project.name}`,
       `- State: ${project.state}`,
       `- Team size: ${project.teamSize}`,
-      `- Structure: ${project.structure}`
+      `- Structure: ${project.structure}`,
+      `- Language: ${project.language}`
     ].join("\n") + "\n"
   );
   parts.push("## Current Phase\n");
@@ -6352,6 +6407,7 @@ function runUnderstand() {
     );
   }
   console.log(renderUnderstandTerminal(plan));
+  console.log(`Project language: ${pack.project.language} (knowledge artifacts are written in this language)`);
   const exp = buildProjectExplanation(dir);
   const assessment = assessPhase(exp);
   console.log("");
@@ -8990,6 +9046,12 @@ var BOOTSTRAP_LAYERS = ["Business", "Product", "Tech"];
 function bootstrap(dir) {
   const written = [];
   const skipped = [];
+  let language = "en";
+  try {
+    const config = loadConfig(dir);
+    if (config) language = projectLanguage(config);
+  } catch {
+  }
   for (const target of TARGETS) {
     const full = join(dir, target.path);
     if (exists(full)) {
@@ -8997,13 +9059,22 @@ function bootstrap(dir) {
       continue;
     }
     const tpl = getTemplate(target.templateId);
-    const content = tpl ? tpl.content : "";
+    const base = tpl ? tpl.content : "";
+    const content = withLanguageDirective(base, language);
     writeFile(full, content.endsWith("\n") ? content : `${content}
 `);
     written.push(target.path);
   }
   return { written, skipped, layers: BOOTSTRAP_LAYERS };
 }
+function withLanguageDirective(content, language) {
+  if (language !== "es") return content;
+  const note = "> Idioma del proyecto: **espa\xF1ol**. Escribe este conocimiento en espa\xF1ol. Mant\xE9n en ingl\xE9s el c\xF3digo, los nombres de archivo, los comandos y las claves de configuraci\xF3n.\n";
+  const fm = content.match(/^---\n[\s\S]*?\n---\n/);
+  if (fm) return content.slice(0, fm[0].length) + "\n" + note + content.slice(fm[0].length);
+  return `${note}
+${content}`;
+}
 async function runBootstrap(dir = cwd()) {
   intro2("kaddo bootstrap");
   if (!exists(join(dir, CONFIG_PATH8))) {

package/package.json

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