@kaddo/cli 3.21.0 → 3.22.1

package/README.md

@@ -508,6 +508,8 @@ create --from roadmap → owners → guard → explain`.
 | v3.19 | Read-only MCP server `@kaddo/mcp` (resources, tools, prompts over stdio) |
 | v3.20 | MCP derived tools: safe regeneration of context/explain/understand/graph/capsule-draft under `.kaddo/` |
 | v3.21 | Reusable Skills layer (`kaddo add skills`); skills in context/explain/understand, agent prompts and MCP |
+| v3.22 | Guard & graph scope semantics: graph scope metadata, contextual-empty messaging, Guard ownership scope (active + completed; `--include-archived`) |
+| v3.22.1 | Guard project-root path normalization: matches `code:` globs when the project is a subfolder of the Git root |
 
 **Optional modules (installed with `kaddo add`):**
 

package/dist/index.js

@@ -592,8 +592,8 @@ function loadConfig(dir) {
   const parsed = configSchema.safeParse(raw ?? {});
   if (!parsed.success) {
     const issues = parsed.error.issues.map((i) => {
-      const path5 = i.path.join(".");
-      return path5 ? `  - ${path5}: ${i.message}` : `  - ${i.message}`;
+      const path6 = i.path.join(".");
+      return path6 ? `  - ${path6}: ${i.message}` : `  - ${i.message}`;
     }).join("\n");
     throw new ConfigError(`Invalid .kaddo/config.yml:
 ${issues}`);
@@ -4902,6 +4902,14 @@ async function isGitRepo(dir) {
     return false;
   }
 }
+async function getGitRoot(dir) {
+  try {
+    const result = await execa("git", ["rev-parse", "--show-toplevel"], { cwd: dir });
+    return result.stdout.trim() || null;
+  } catch {
+    return null;
+  }
+}
 async function getUntrackedFiles() {
   try {
     const result = await execa("git", ["ls-files", "--others", "--exclude-standard"]);
@@ -5048,6 +5056,20 @@ function discoverWorkItems(dir) {
 
 // src/core/diff-analysis.ts
 import { minimatch } from "minimatch";
+import path3 from "path";
+function toPosix2(p2) {
+  return p2.replace(/\\/g, "/");
+}
+function normalizeTouchedPathForProject(touchedPath, gitRoot, projectRoot) {
+  const t = toPosix2(touchedPath).replace(/^\.\//, "").replace(/^\/+/, "");
+  if (!gitRoot) return t;
+  const prefix = toPosix2(path3.relative(gitRoot, projectRoot)).replace(/^\.\//, "").replace(/\/+$/, "");
+  if (prefix === "" || prefix === ".") return t;
+  if (prefix.startsWith("..")) return t;
+  if (t === prefix) return null;
+  if (t.startsWith(prefix + "/")) return t.slice(prefix.length + 1);
+  return null;
+}
 function normalizePath(p2) {
   return p2.replace(/\\/g, "/");
 }
@@ -5107,10 +5129,10 @@ function analyzeGuard(touchedFiles, artifacts, silentWithoutOwnership) {
 import { parse as parseYaml4, stringify as stringifyYaml2 } from "yaml";
 var IGNORE_FILE = ".kaddo/ignores.yml";
 function loadIgnores(dir) {
-  const path5 = join(dir, IGNORE_FILE);
-  if (!exists(path5)) return [];
+  const path6 = join(dir, IGNORE_FILE);
+  if (!exists(path6)) return [];
   try {
-    const raw = readFile(path5);
+    const raw = readFile(path6);
     const parsed = parseYaml4(raw);
     return Array.isArray(parsed) ? parsed : [];
   } catch {
@@ -5118,7 +5140,7 @@ function loadIgnores(dir) {
   }
 }
 function saveIgnore(dir, entry) {
-  const path5 = join(dir, IGNORE_FILE);
+  const path6 = join(dir, IGNORE_FILE);
   const existing = loadIgnores(dir);
   const idx = existing.findIndex((e) => e.artifact_id === entry.artifact_id);
   if (idx >= 0) {
@@ -5126,17 +5148,17 @@ function saveIgnore(dir, entry) {
   } else {
     existing.push(entry);
   }
-  writeFile(path5, stringifyYaml2(existing));
+  writeFile(path6, stringifyYaml2(existing));
 }
 function isIgnored(ignores, artifactId) {
   return ignores.find((e) => e.artifact_id === artifactId);
 }
 function removeIgnore(dir, artifactId) {
-  const path5 = join(dir, IGNORE_FILE);
+  const path6 = join(dir, IGNORE_FILE);
   const existing = loadIgnores(dir);
   const filtered = existing.filter((e) => e.artifact_id !== artifactId);
   if (filtered.length === existing.length) return false;
-  writeFile(path5, stringifyYaml2(filtered));
+  writeFile(path6, stringifyYaml2(filtered));
   return true;
 }
 
@@ -5158,11 +5180,11 @@ function moduleArtifactCoverage(dir, id) {
   };
 }
 function loadMappedModules(dir) {
-  const path5 = join(dir, DESCRIPTOR_PATH);
-  if (!exists(path5)) return [];
+  const path6 = join(dir, DESCRIPTOR_PATH);
+  if (!exists(path6)) return [];
   let parsed;
   try {
-    parsed = parseYaml5(readFile(path5));
+    parsed = parseYaml5(readFile(path6));
   } catch {
     return [];
   }
@@ -5254,7 +5276,7 @@ async function collectWorkspaceChanges(dir, mode = "head", deps = defaultDeps) {
 }
 
 // src/commands/guard.ts
-import path3 from "path";
+import path4 from "path";
 import { parse as parseYaml7 } from "yaml";
 
 // src/plugins/prisma.ts
@@ -5458,7 +5480,7 @@ function printHeader(touchedFiles) {
 function artifactLabel(artifact, dir) {
   if (artifact.id) return artifact.id;
   if (artifact.title) return artifact.title;
-  const rel = path3.relative(dir, artifact.filePath).split(path3.sep).join("/");
+  const rel = path4.relative(dir, artifact.filePath).split(path4.sep).join("/");
   return rel || artifact.filePath;
 }
 function printWorkspaceHeader(scan2) {
@@ -5524,10 +5546,17 @@ async function offerIgnore(dir, match) {
   log2.success(`${id} added to .kaddo/ignores.yml`);
   return true;
 }
-function printCIJson(dir, touchedFiles, activeMatches, ignoredCount, pluginSignals, affectedOwners, workspace) {
+function printCIJson(dir, touchedFiles, activeMatches, ignoredCount, pluginSignals, affectedOwners, workspace, includeArchived, normalizedFiles, outsideProjectFiles) {
   const output = {
     kaddo_guard: true,
     ci: true,
+    ownership_scope: {
+      included: includeArchived ? ["draft", "ready", "in-progress", "blocked", "completed", "archived"] : ["draft", "ready", "in-progress", "blocked", "completed"],
+      excluded: includeArchived ? [] : ["archived"]
+    },
+    // Git-root-relative → project-root-relative mapping used for matching (VS-060.1).
+    normalized_files: normalizedFiles,
+    files_outside_project: outsideProjectFiles,
     touched_files: touchedFiles.length,
     fyi_count: activeMatches.length,
     ignored_count: ignoredCount,
@@ -5556,6 +5585,12 @@ function printCIJson(dir, touchedFiles, activeMatches, ignoredCount, pluginSigna
   }
   console.log(JSON.stringify(output, null, 2));
 }
+function printOwnershipScope(includeArchived) {
+  console.log("Ownership scope:");
+  console.log("- Active and completed Work Items");
+  console.log(includeArchived ? "- Archived Work Items included (--include-archived)" : "- Archived Work Items excluded");
+  console.log("");
+}
 async function runGuard(opts = {}) {
   const dir = cwd();
   const interactive = opts.interactive !== false && !opts.ci && !opts.json;
@@ -5570,8 +5605,16 @@ async function runGuard(opts = {}) {
   const ignores = loadIgnores(dir);
   const plugins = resolvePlugins(config.plugins ?? []);
   const mode = opts.staged ? "staged" : "head";
-  const currentFiles = await getModifiedFiles(mode);
-  const untrackedFiles = opts.staged ? [] : await getUntrackedFiles();
+  const currentFilesRaw = await getModifiedFiles(mode);
+  const gitRoot = await getGitRoot(dir);
+  const currentPairs = currentFilesRaw.map((raw) => ({
+    raw,
+    project: normalizeTouchedPathForProject(raw, gitRoot, dir)
+  }));
+  const inProjectPairs = currentPairs.filter((p2) => p2.project !== null);
+  const currentFiles = inProjectPairs.map((p2) => p2.project);
+  const outsideProjectFiles = currentPairs.filter((p2) => p2.project === null).map((p2) => p2.raw);
+  const untrackedFiles = opts.staged ? [] : (await getUntrackedFiles()).map((f) => normalizeTouchedPathForProject(f, gitRoot, dir)).filter((f) => f !== null);
   const printUntracked = () => {
     if (untrackedFiles.length === 0 || jsonMode) return;
     console.log("");
@@ -5586,6 +5629,7 @@ async function runGuard(opts = {}) {
   }
   const workspaceFiles = workspaceScan ? workspaceScan.changedFiles.map((c) => c.normalizedPath) : [];
   const touchedFiles = [.../* @__PURE__ */ new Set([...currentFiles, ...workspaceFiles])];
+  const displayTouched = [.../* @__PURE__ */ new Set([...inProjectPairs.map((p2) => p2.raw), ...workspaceFiles])];
   if (touchedFiles.length === 0) {
     if (workspaceScan) printWorkspaceHeader(workspaceScan);
     console.log("kaddo guard: no modified files detected.");
@@ -5597,7 +5641,10 @@ async function runGuard(opts = {}) {
     console.log("kaddo guard: no knowledge/ directory found. Run `kaddo init` first.");
     return;
   }
-  const artifacts = discoverKnowledge(dir);
+  const includeArchived = opts.includeArchived === true;
+  const artifacts = discoverKnowledge(dir).filter(
+    (a) => !(a.isWorkItem && a.lifecycle === "archived" && !includeArchived)
+  );
   const result = analyzeGuard(touchedFiles, artifacts, silentWithoutOwnership);
   const pluginSignals = runPlugins(plugins, currentFiles, (filePath) => {
     const abs = join(dir, filePath);
@@ -5618,7 +5665,7 @@ async function runGuard(opts = {}) {
     const ownerMapCI = loadOwners(dir);
     const matchedDomainsCI = collectMatchedDomains(activeMatches.map((m) => m.artifact.domains));
     const affectedOwnersCI = resolveAffectedOwners(matchedDomainsCI, ownerMapCI);
-    printCIJson(dir, touchedFiles, activeMatches, alreadyIgnoredMatches.length, pluginSignals, affectedOwnersCI, workspaceScan);
+    printCIJson(dir, touchedFiles, activeMatches, alreadyIgnoredMatches.length, pluginSignals, affectedOwnersCI, workspaceScan, includeArchived, inProjectPairs.map((p2) => ({ raw_path: p2.raw, project_path: p2.project })), outsideProjectFiles);
     return;
   }
   if (result.silenced && pluginSignals.length === 0) {
@@ -5627,13 +5674,19 @@ async function runGuard(opts = {}) {
   }
   if (result.matches.length === 0 && pluginSignals.length === 0) {
     if (workspaceScan) printWorkspaceHeader(workspaceScan);
-    printHeader(touchedFiles);
+    printHeader(displayTouched);
+    printOwnershipScope(includeArchived);
     console.log("  No artifact ownership matches found.");
+    console.log("");
+    console.log("Note:");
+    console.log("Guard checks ownership from active and completed Work Items.");
+    console.log("Run `kaddo explain` to inspect ownership coverage.");
     printUntracked();
     return;
   }
   if (workspaceScan) printWorkspaceHeader(workspaceScan);
-  printHeader(touchedFiles);
+  printHeader(displayTouched);
+  printOwnershipScope(includeArchived);
   printUntracked();
   for (const match of activeMatches) {
     printFYI(match, dir);
@@ -5980,7 +6033,7 @@ function sectionParagraph(md, title) {
   }
   return "";
 }
-function parseCapsule(id, path5, md) {
+function parseCapsule(id, path6, md) {
   const { data } = matter2(md);
   const updatedAt = data.updated_at ? String(data.updated_at) : void 0;
   let ageDays = null;
@@ -5990,7 +6043,7 @@ function parseCapsule(id, path5, md) {
   }
   return {
     id,
-    path: path5,
+    path: path6,
     system: data.system ? String(data.system) : id,
     owner: data.owner ? String(data.owner) : void 0,
     updatedAt,
@@ -6040,14 +6093,19 @@ function loadExternalCapsules(dir) {
 
 // src/core/graph.ts
 var KNOWLEDGE2 = "knowledge";
-function toPosix2(p2) {
+var ACTIVE_STATUSES = ["draft", "ready", "in-progress", "blocked"];
+var ALL_STATUSES = ["draft", "ready", "in-progress", "blocked", "completed"];
+function scopeStatuses(scope) {
+  return scope === "all" ? { included: ALL_STATUSES, excluded: ["archived"] } : { included: ACTIVE_STATUSES, excluded: ["completed", "archived"] };
+}
+function toPosix3(p2) {
   return p2.replace(/\\/g, "/");
 }
 function slug(s) {
   return s.trim().toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
 }
 function isAdr(a) {
-  return toPosix2(a.filePath).includes("/tech/decisions/") && Boolean(a.type);
+  return toPosix3(a.filePath).includes("/tech/decisions/") && Boolean(a.type);
 }
 function buildGraph(dir, config, opts = {}, now = /* @__PURE__ */ new Date()) {
   const scope = opts.scope ?? "active";
@@ -6071,9 +6129,9 @@ function buildGraph(dir, config, opts = {}, now = /* @__PURE__ */ new Date()) {
   ];
   const presentLayers = [];
   for (const layer2 of layerDocs) {
-    const path5 = layer2.files.map((f) => `${KNOWLEDGE2}/${f}`).find((rel) => exists(join(dir, rel)));
-    if (path5) {
-      addNode({ id: layer2.id, type: layer2.type, label: layer2.label, path: path5 });
+    const path6 = layer2.files.map((f) => `${KNOWLEDGE2}/${f}`).find((rel) => exists(join(dir, rel)));
+    if (path6) {
+      addNode({ id: layer2.id, type: layer2.type, label: layer2.label, path: path6 });
       presentLayers.push(layer2.id);
     }
   }
@@ -6082,7 +6140,10 @@ function buildGraph(dir, config, opts = {}, now = /* @__PURE__ */ new Date()) {
   }
   const all = discoverKnowledge(dir);
   const workItems = all.filter((a) => a.isWorkItem);
-  const selectedWIs = scope === "active" ? workItems.filter((a) => a.lifecycle && isActiveState(a.lifecycle)) : workItems;
+  const { included, excluded } = scopeStatuses(scope);
+  const includedSet = new Set(included);
+  const activeWICount = workItems.filter((a) => a.lifecycle && isActiveState(a.lifecycle)).length;
+  const selectedWIs = workItems.filter((a) => a.lifecycle && includedSet.has(a.lifecycle));
   for (const wi of selectedWIs) {
     const id = wi.id || wi.title;
     const wiNodeId = `wi:${id}`;
@@ -6152,6 +6213,7 @@ function buildGraph(dir, config, opts = {}, now = /* @__PURE__ */ new Date()) {
       }
     }
   }
+  const scopeReason = scope === "all" ? "All supported Work Item statuses are included." : activeWICount === 0 ? "No active Work Items found. Completed Work Items are excluded from active scope." : "Active Work Items only; completed and archived are excluded.";
   return {
     generated_at: now.toISOString(),
     project: {
@@ -6159,6 +6221,10 @@ function buildGraph(dir, config, opts = {}, now = /* @__PURE__ */ new Date()) {
       state: config.project.state,
       structure: config.project.structure
     },
+    scope,
+    scope_reason: scopeReason,
+    included_statuses: included,
+    excluded_statuses: excluded,
     nodes: [...nodes.values()],
     edges
   };
@@ -6206,8 +6272,13 @@ function loadGraphSummary(dir) {
     const connected = new Set(
       edges.filter((e) => e.type === "owns" && activeWiIds.has(e.from)).map((e) => e.from)
     );
+    const scope = graph.scope === "all" ? "all" : "active";
     return {
       generatedAt: String(graph.generated_at ?? ""),
+      scope,
+      scopeReason: String(graph.scope_reason ?? ""),
+      includedStatuses: Array.isArray(graph.included_statuses) ? graph.included_statuses : [],
+      excludedStatuses: Array.isArray(graph.excluded_statuses) ? graph.excluded_statuses : [],
       nodes: nodes.length,
       edges: edges.length,
       activeWorkItemsConnectedToCode: connected.size
@@ -6219,14 +6290,14 @@ function loadGraphSummary(dir) {
 
 // src/core/graph-hints.ts
 var KNOWLEDGE3 = "knowledge";
-function toPosix3(p2) {
+function toPosix4(p2) {
   return p2.replace(/\\/g, "/");
 }
 function slug2(s) {
   return s.trim().toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
 }
 function isAdr2(a) {
-  return toPosix3(a.filePath).includes("/tech/decisions/") && Boolean(a.type);
+  return toPosix4(a.filePath).includes("/tech/decisions/") && Boolean(a.type);
 }
 function capabilityHeadings(dir) {
   const p2 = join(dir, KNOWLEDGE3, "product", "capabilities.md");
@@ -6359,6 +6430,8 @@ function buildGraphHints(dir, graph, now = /* @__PURE__ */ new Date()) {
   const quality = assessQuality(nodes, relationshipEdges, hints.length);
   return {
     generated_at: now.toISOString(),
+    scope: graph.scope,
+    scope_reason: graph.scope_reason,
     quality,
     summary: { nodes, edges: graph.edges.length, hints: hints.length },
     metrics,
@@ -6394,13 +6467,23 @@ function renderGraphHintsMarkdown(report) {
   lines.push("");
   lines.push("## Summary");
   lines.push("");
+  lines.push(`- Scope: ${report.scope} \u2014 ${report.scope_reason}`);
   lines.push(`- Relationship quality: ${report.quality} \u2014 ${QUALITY_NOTE[report.quality]}`);
   lines.push(`- Nodes: ${report.summary.nodes}`);
   lines.push(`- Edges: ${report.summary.edges}`);
   lines.push(`- Hints: ${report.summary.hints}`);
   lines.push("");
   if (report.hints.length === 0) {
-    lines.push("No hints \u2014 the declared relationships look healthy. \u{1F389}");
+    if (report.quality === "empty") {
+      lines.push("No active relationship hints were generated.");
+      lines.push("");
+      lines.push(`The graph is ${report.quality} for the **${report.scope}** scope \u2014 ${report.scope_reason}`);
+      if (report.scope !== "all") {
+        lines.push("Run `kaddo graph export --scope all` to inspect completed Work Items and historical relationships.");
+      }
+    } else {
+      lines.push("No hints \u2014 the declared relationships look healthy. \u{1F389}");
+    }
     lines.push("");
     return lines.join("\n");
   }
@@ -6436,6 +6519,8 @@ function loadGraphHints(dir) {
     const report = JSON.parse(readFile(p2));
     const hints = Array.isArray(report.hints) ? report.hints : [];
     return {
+      scope: String(report.scope ?? "active"),
+      scopeReason: String(report.scope_reason ?? ""),
       quality: report.quality ?? "empty",
       totalHints: hints.length,
       activeWorkItemHints: hints.filter((h) => h.artifact_type === "work-item").length,
@@ -6959,13 +7044,18 @@ function renderExplanationHuman(exp) {
   }
   if (exp.graph) {
     lines.push("## Knowledge Graph");
+    lines.push(`- Scope: ${exp.graph.scope}`);
     lines.push(`- Nodes: ${exp.graph.nodes}`);
     lines.push(`- Edges: ${exp.graph.edges}`);
     if (exp.graphHints) {
       lines.push(`- Quality: ${exp.graphHints.quality}`);
       lines.push(`- Hints: ${exp.graphHints.totalHints}`);
     }
+    if (exp.graph.scopeReason) lines.push(`- Reason: ${exp.graph.scopeReason}`);
     if (exp.graph.generatedAt) lines.push(`- Last exported: ${exp.graph.generatedAt}`);
+    if (exp.graph.scope === "active" && exp.graphHints?.quality === "empty") {
+      lines.push("- Tip: Run `kaddo graph export --scope all` to include completed Work Items");
+    }
     lines.push("");
   }
   if (exp.skills.total > 0) {
@@ -7557,9 +7647,12 @@ function renderContextPack(pack) {
     parts.push(
       [
         "- Available: yes",
+        `- Scope: ${pack.graph.scope}`,
         `- Nodes: ${pack.graph.nodes}`,
         `- Edges: ${pack.graph.edges}`,
-        `- Active Work Items connected to code: ${pack.graph.activeWorkItemsConnectedToCode}`
+        ...pack.graphHints ? [`- Quality: ${pack.graphHints.quality}`] : [],
+        `- Active Work Items connected to code: ${pack.graph.activeWorkItemsConnectedToCode}`,
+        ...pack.graph.scopeReason ? [`- Reason: ${pack.graph.scopeReason}`] : []
       ].join("\n") + "\n"
     );
     parts.push("Full graph: `.kaddo/graph.json` / `.kaddo/graph.mmd` (run `kaddo graph export` to refresh).\n");
@@ -7948,7 +8041,7 @@ function runUnderstand() {
 }
 
 // src/core/classifier.ts
-import path4 from "path";
+import path5 from "path";
 var MIGRATION_PATTERNS = [
   /supabase\/migrations\//,
   /prisma\/migrations\//,
@@ -7987,7 +8080,7 @@ var DEP_PATTERNS = [
   /^pom\.xml$/
 ];
 function normalizePath2(p2) {
-  return p2.split(path4.sep).join("/");
+  return p2.split(path5.sep).join("/");
 }
 function matchesAny(file, patterns) {
   const normalized = normalizePath2(file);
@@ -8819,10 +8912,10 @@ ${globs.map((g) => `  - ${g}`).join("\n")}`);
 import { parse as parseYaml13, stringify as stringifyYaml5 } from "yaml";
 var DESCRIPTOR_PATH2 = "knowledge/module.yml";
 function readDescriptor(dir) {
-  const path5 = join(dir, DESCRIPTOR_PATH2);
-  if (!exists(path5)) return null;
+  const path6 = join(dir, DESCRIPTOR_PATH2);
+  if (!exists(path6)) return null;
   try {
-    return parseYaml13(readFile(path5));
+    return parseYaml13(readFile(path6));
   } catch {
     return null;
   }
@@ -10427,10 +10520,10 @@ function slugify3(name) {
   return name.trim().toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
 }
 function readModulesDescriptor(dir) {
-  const path5 = join(dir, DESCRIPTOR_PATH3);
-  if (!exists(path5)) return { version: 1, modules: [] };
+  const path6 = join(dir, DESCRIPTOR_PATH3);
+  if (!exists(path6)) return { version: 1, modules: [] };
   try {
-    const parsed = parseYaml14(readFile(path5));
+    const parsed = parseYaml14(readFile(path6));
     return { version: parsed.version ?? 1, modules: parsed.modules ?? [] };
   } catch {
     return { version: 1, modules: [] };
@@ -10797,9 +10890,15 @@ function runGraphExport(opts = {}) {
   writeFile(join(dir, ".kaddo", "graph-hints.md"), renderGraphHintsMarkdown(hints));
   writeFile(join(dir, ".kaddo", "graph-hints.json"), serializeGraphHintsJson(hints));
   written.push(".kaddo/graph-hints.md", ".kaddo/graph-hints.json");
-  log2.success("Knowledge graph exported.");
+  log2.success(`Knowledge graph exported with ${scope} scope.`);
   log2.info(`Scope: ${scope} \xB7 Nodes: ${graph.nodes.length} \xB7 Edges: ${graph.edges.length}`);
   log2.info(`Relationship quality: ${hints.quality}`);
+  const hasWorkItemNodes = graph.nodes.some((n) => n.type === "work-item");
+  if (scope === "active" && !hasWorkItemNodes) {
+    log2.warn("No active Work Items found.");
+    log2.info("The active graph only includes knowledge layers.");
+    log2.info("Run `kaddo graph export --scope all` to include completed Work Items.");
+  }
   if (hints.hints.length > 0) {
     const shown = hints.hints.slice(0, 5);
     log2.warn(`${hints.hints.length} metadata hint(s) available:`);
@@ -10834,14 +10933,14 @@ var capsuleCmd = program.command("capsule").description("Export this project as
 capsuleCmd.command("export").description("Write a Knowledge Capsule about this project to .kaddo/exports/").action(() => {
   runCapsuleExport();
 });
-capsuleCmd.command("add <path>").description("Register an external Knowledge Capsule as project context (.kaddo/external.yml)").action((path5) => {
-  runCapsuleAdd(path5);
+capsuleCmd.command("add <path>").description("Register an external Knowledge Capsule as project context (.kaddo/external.yml)").action((path6) => {
+  runCapsuleAdd(path6);
 });
 var graphCmd = program.command("graph").description("Export the lightweight, file-based knowledge graph of the project");
 graphCmd.command("export").description("Write the knowledge graph to .kaddo/graph.json and .kaddo/graph.mmd").option("--scope <scope>", "Graph scope: active (default) or all").option("--format <format>", "Output format: json, mermaid (default: both)").action((opts) => {
   runGraphExport(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)").action(async (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)").action(async (opts) => {
   await runGuard(opts);
 });
 var ignoreCmd = program.command("ignore").description("Manage guard ignore list");

package/package.json

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