@kaddo/cli 3.48.0 → 3.49.0

package/dist/index.js

@@ -5396,6 +5396,7 @@ function buildFrontMatter(id, type, level, title, answers) {
     `domains: []`,
     `code: []`,
     `created_at: ${today2}`,
+    `source: manual`,
     `summary: "${answers.problem?.split(".")[0] ?? title}"`,
     "---"
   ];
@@ -5482,6 +5483,7 @@ function buildModuleFrontMatter(id, modType, title, answers) {
     `domains: []`,
     `code: []`,
     `created_at: ${today2}`,
+    `source: manual`,
     `summary: "${title}"`,
     ...extraLines,
     "---"
@@ -5661,6 +5663,8 @@ function buildRoadmapFrontMatter(id, type, level, title, candidate, answers) {
     // from the specific Work Item candidate it was materialized from.
     `source_roadmap_initiative: ${candidate.initiative?.id ?? "unknown"}`,
     `source_work_item_candidate: ${candidate.id}`,
+    `source_title: "${q(candidate.title)}"`,
+    `source_context: "Materialized from roadmap candidate ${candidate.id}${candidate.initiative?.id ? ` under initiative ${candidate.initiative.id}` : ""}."`,
     ...candidate.initiative?.title ? [`source_initiative_title: "${q(candidate.initiative.title)}"`] : [],
     ...candidate.domain ? [`related_domain: "${q(candidate.domain)}"`] : [],
     ...yamlList2("related_capabilities", relatedCapabilities),
@@ -5930,6 +5934,7 @@ function parseArtifact(filePath, raw) {
       initiative: String(data.initiative ?? data.source_initiative ?? ""),
       source: data.source ? String(data.source) : "",
       sourceId: String(data.source_id ?? ""),
+      rawFrontmatter: data,
       decisions: Array.isArray(data.decisions) ? data.decisions.map(String).filter(Boolean) : [],
       capsules: Array.isArray(data.capsules) ? data.capsules.map(String).filter(Boolean) : []
     };
@@ -9241,6 +9246,84 @@ function buildRoadmapQuality(dir) {
   return { initiatives, work_item_candidates };
 }
 
+// src/core/work-item-source.ts
+var VALID_SOURCES = [
+  "manual",
+  "roadmap",
+  "jira",
+  "github",
+  "notion",
+  "xlsx",
+  "csv",
+  "api",
+  "external",
+  "unknown"
+];
+function isValidSource(s) {
+  return VALID_SOURCES.includes(s);
+}
+function parseWorkItemSource(frontmatter) {
+  const raw = frontmatter.source ? String(frontmatter.source) : "";
+  if (raw && isValidSource(raw)) {
+    return {
+      type: raw,
+      id: optStr(frontmatter.source_id),
+      title: optStr(frontmatter.source_title),
+      context: optStr(frontmatter.source_context),
+      provider: optStr(frontmatter.source_provider),
+      url: optStr(frontmatter.source_url),
+      imported_at: optStr(frontmatter.source_imported_at),
+      synced_at: optStr(frontmatter.source_synced_at),
+      inferred: false
+    };
+  }
+  if (raw && !isValidSource(raw)) {
+    return {
+      type: "unknown",
+      id: optStr(frontmatter.source_id),
+      title: optStr(frontmatter.source_title),
+      context: optStr(frontmatter.source_context),
+      provider: optStr(frontmatter.source_provider),
+      url: optStr(frontmatter.source_url),
+      imported_at: optStr(frontmatter.source_imported_at),
+      synced_at: optStr(frontmatter.source_synced_at),
+      inferred: true,
+      reason: `Invalid source value: "${raw}".`
+    };
+  }
+  if (frontmatter.source_work_item_candidate || frontmatter.source_roadmap_initiative) {
+    return {
+      type: "roadmap",
+      id: optStr(frontmatter.source_id) ?? optStr(frontmatter.source_work_item_candidate),
+      title: optStr(frontmatter.source_initiative_title),
+      inferred: true,
+      reason: "Inferred from legacy roadmap fields."
+    };
+  }
+  if (frontmatter.source_id) {
+    return {
+      type: "unknown",
+      id: optStr(frontmatter.source_id),
+      inferred: true,
+      reason: "Has source_id but no source type."
+    };
+  }
+  return {
+    type: "unknown",
+    inferred: true,
+    reason: "No source metadata found."
+  };
+}
+function renderSourceCompact(source) {
+  const parts = [source.type];
+  if (source.id) parts.push(source.id);
+  return parts.join(" \xB7 ");
+}
+function optStr(v) {
+  if (typeof v === "string" && v.trim()) return v.trim();
+  return void 0;
+}
+
 // src/core/project-route.ts
 function isUseful(q) {
   return q === "useful";
@@ -9327,12 +9410,12 @@ var captureTechDecisions = {
 var createWorkSource = {
   id: "create-work-source",
   label: "Create or connect work source",
-  evaluate: (ctx) => ({
-    status: ctx.hasRoadmap || ctx.totalWorkItems > 0 ? "done" : "pending",
-    evidence: ctx.hasRoadmap ? ["knowledge/delivery/roadmap.md"] : void 0,
-    command: ctx.hasRoadmap ? void 0 : "kaddo roadmap",
-    agent: ctx.hasRoadmap ? void 0 : "roadmap-agent"
-  })
+  evaluate: (ctx) => {
+    if (!ctx.hasRoadmap && ctx.totalWorkItems === 0) return { status: "pending", command: "kaddo roadmap", agent: "roadmap-agent" };
+    if (ctx.hasUnknownSources) return { status: "warning", evidence: ["Work Items with unknown source"], reason: "Some Work Items have no source metadata." };
+    const evidence = ctx.hasRoadmap ? ["knowledge/delivery/roadmap.md"] : void 0;
+    return { status: "done", evidence };
+  }
 };
 var materializeWorkItem = {
   id: "materialize-work-item",
@@ -9549,6 +9632,10 @@ function buildRouteContext(dir) {
     adaptersInstalled: adapters.length,
     hasGuardHistory: exists(join(dir, ".kaddo", "history", "guard-runs.jsonl")),
     hasScanWarnings: hasScan ? loadScanWarnings(dir) : false,
+    hasUnknownSources: wis.some((w) => {
+      const src = parseWorkItemSource(w.rawFrontmatter);
+      return src.type === "unknown" && src.inferred;
+    }),
     nextStepId: mapNextStepId(nextStep.id)
   };
 }
@@ -9764,17 +9851,21 @@ function buildProjectExplanation(dir) {
     hasAgents: hasAgents(dir)
   };
   const workItemArtifacts = discoverWorkItems(dir);
-  const items = workItemArtifacts.map((a) => ({
-    id: a.id || a.title,
-    title: a.title,
-    type: a.type,
-    status: a.status,
-    lifecycle: lifecycleStateOf({ status: a.status, filePath: a.filePath }),
-    initiative: a.initiative,
-    knowledgeLevel: a.knowledgeLevel,
-    hasOwnership: a.codeGlobs.length > 0,
-    domains: a.domains
-  }));
+  const items = workItemArtifacts.map((a) => {
+    const src = parseWorkItemSource(a.rawFrontmatter);
+    return {
+      id: a.id || a.title,
+      title: a.title,
+      type: a.type,
+      status: a.status,
+      lifecycle: lifecycleStateOf({ status: a.status, filePath: a.filePath }),
+      initiative: a.initiative,
+      knowledgeLevel: a.knowledgeLevel,
+      hasOwnership: a.codeGlobs.length > 0,
+      domains: a.domains,
+      source: { type: src.type, ...src.id ? { id: src.id } : {}, inferred: src.inferred }
+    };
+  });
   const byState = lifecycleCounts(items.map((i) => i.lifecycle));
   const byType = {};
   for (const i of items) {
@@ -9971,6 +10062,17 @@ function renderExplanationHuman(exp) {
       for (const [t, n] of typeEntries) lines.push(`- ${typeLabel(t)}: ${n}`);
       lines.push("");
     }
+    const sourceCounts = {};
+    for (const i of exp.workItems.items) {
+      const t = i.source?.type ?? "unknown";
+      sourceCounts[t] = (sourceCounts[t] ?? 0) + 1;
+    }
+    const sourceEntries = Object.entries(sourceCounts).filter(([, n]) => n > 0);
+    if (sourceEntries.length > 0) {
+      lines.push("## Work Item Sources");
+      for (const [t, n] of sourceEntries) lines.push(`- ${t.charAt(0).toUpperCase() + t.slice(1)}: ${n}`);
+      lines.push("");
+    }
     const grouped = exp.workItems.initiatives.filter(
       (g) => LIFECYCLE_STATES.some((s2) => g.states[s2] > 0)
     );
@@ -10439,7 +10541,8 @@ function toContextWorkItem(a) {
     status: a.status,
     lifecycle: lifecycleStateOf({ status: a.status, filePath: a.filePath }),
     knowledgeLevel: a.knowledgeLevel,
-    domains: a.domains
+    domains: a.domains,
+    source: parseWorkItemSource(a.rawFrontmatter)
   };
 }
 function toContextArtifact(a) {
@@ -10780,7 +10883,10 @@ function renderContextPack(pack) {
       const level = wi.knowledgeLevel ? ` [${wi.knowledgeLevel}]` : "";
       const status = wi.lifecycle ? ` (${wi.lifecycle})` : wi.status ? ` (${wi.status})` : "";
       const domains = wi.domains.length > 0 ? ` \xB7 domains: ${wi.domains.join(", ")}` : "";
-      return `- ${wi.id || wi.title} [${wi.type}]${level}${status} \u2014 ${wi.title}${domains}`;
+      const line = `- ${wi.id || wi.title} [${wi.type}]${level}${status} \u2014 ${wi.title}${domains}`;
+      const src = wi.source && wi.source.type !== "unknown" ? `
+  - Source: ${renderSourceCompact(wi.source)}` : "";
+      return `${line}${src}`;
     });
     parts.push(lines.join("\n") + "\n");
   } else {
@@ -11090,7 +11196,11 @@ function renderUnderstand(plan) {
   if (plan.activeWorkItems && plan.activeWorkItems.length > 0) {
     parts.push("## Active Work Items\n");
     parts.push(
-      plan.activeWorkItems.map((w) => `- ${w.id} [${w.type}] ${w.lifecycle} \u2014 ${w.title}`).join("\n") + "\n"
+      plan.activeWorkItems.map((w) => {
+        const src = w.source && w.source.type !== "unknown" ? `
+  - Source: ${w.source.type}${w.source.id ? ` \xB7 ${w.source.id}` : ""}` : "";
+        return `- ${w.id} [${w.type}] ${w.lifecycle} \u2014 ${w.title}${src}`;
+      }).join("\n") + "\n"
     );
   }
   parts.push("## Context Pack\n");
@@ -11411,7 +11521,11 @@ function runUnderstand() {
     type: w.type,
     lifecycle: w.lifecycle ?? "draft",
     knowledgeLevel: w.knowledgeLevel,
-    hasOwnership: w.codeGlobs.length > 0
+    hasOwnership: w.codeGlobs.length > 0,
+    source: (() => {
+      const s = parseWorkItemSource(w.rawFrontmatter);
+      return { type: s.type, ...s.id ? { id: s.id } : {} };
+    })()
   }));
   const recommendedPaths = [];
   if (rec.agent) {

package/package.json

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