@kaddo/cli 3.70.1 → 3.72.0

package/dist/admin-dist/assets/index-J0BnLZHW.css

@@ -0,0 +1,2 @@
+/*! tailwindcss v4.3.3 | MIT License | https://tailwindcss.com */
+@layer properties{@supports (((-webkit-hyphens:none)) and (not (margin-trim:inline))) or ((-moz-orient:inline) and (not (color:rgb(from red r g b)))){*,:before,:after,::backdrop{--tw-rotate-x:initial;--tw-rotate-y:initial;--tw-rotate-z:initial;--tw-skew-x:initial;--tw-skew-y:initial;--tw-border-style:solid;--tw-outline-style:solid;--tw-blur:initial;--tw-brightness:initial;--tw-contrast:initial;--tw-grayscale:initial;--tw-hue-rotate:initial;--tw-invert:initial;--tw-opacity:initial;--tw-saturate:initial;--tw-sepia:initial;--tw-drop-shadow:initial;--tw-drop-shadow-color:initial;--tw-drop-shadow-alpha:100%;--tw-drop-shadow-size:initial;--tw-ease:initial}}}@layer theme{:root,:host{--font-sans:-apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", "Noto Sans", Arial, sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji";--font-mono:ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace;--ease-in-out:cubic-bezier(.4, 0, .2, 1);--default-transition-duration:.15s;--default-transition-timing-function:cubic-bezier(.4, 0, .2, 1);--default-font-family:var(--font-sans);--default-mono-font-family:var(--font-mono)}}@layer base{*,:after,:before,::backdrop{box-sizing:border-box;border:0 solid;margin:0;padding:0}::file-selector-button{box-sizing:border-box;border:0 solid;margin:0;padding:0}html,:host{-webkit-text-size-adjust:100%;tab-size:4;line-height:1.5;font-family:var(--default-font-family,-apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", "Noto Sans", Arial, sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji");font-feature-settings:var(--default-font-feature-settings,normal);font-variation-settings:var(--default-font-variation-settings,normal);-webkit-tap-highlight-color:transparent}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;-webkit-text-decoration:inherit;-webkit-text-decoration:inherit;-webkit-text-decoration:inherit;-webkit-text-decoration:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:var(--default-mono-font-family,ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace);font-feature-settings:var(--default-mono-font-feature-settings,normal);font-variation-settings:var(--default-mono-font-variation-settings,normal);font-size:1em}small{font-size:80%}sub,sup{vertical-align:baseline;font-size:75%;line-height:0;position:relative}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}:-moz-focusring:where(:not(iframe)){outline:auto}progress{vertical-align:baseline}summary{display:list-item}ol,ul,menu{list-style:none}img,svg,video,canvas,audio,iframe,embed,object{vertical-align:middle;display:block}img,video{max-width:100%;height:auto}button,input,select,optgroup,textarea{font:inherit;font-feature-settings:inherit;font-variation-settings:inherit;letter-spacing:inherit;color:inherit;opacity:1;background-color:#0000;border-radius:0}::file-selector-button{font:inherit;font-feature-settings:inherit;font-variation-settings:inherit;letter-spacing:inherit;color:inherit;opacity:1;background-color:#0000;border-radius:0}:where(select:is([multiple],[size])) optgroup{font-weight:bolder}:where(select:is([multiple],[size])) optgroup option{padding-inline-start:20px}::file-selector-button{margin-inline-end:4px}::placeholder{opacity:1}@supports (not ((-webkit-appearance:-apple-pay-button))) or (contain-intrinsic-size:1px){::placeholder{color:currentColor}@supports (color:color-mix(in lab, red, red)){::placeholder{color:color-mix(in oklab, currentcolor 50%, transparent)}}}textarea{resize:vertical}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-date-and-time-value{min-height:1lh;text-align:inherit}::-webkit-datetime-edit{display:inline-flex}::-webkit-datetime-edit-fields-wrapper{padding:0}::-webkit-datetime-edit{padding-block:0}::-webkit-datetime-edit-year-field{padding-block:0}::-webkit-datetime-edit-month-field{padding-block:0}::-webkit-datetime-edit-day-field{padding-block:0}::-webkit-datetime-edit-hour-field{padding-block:0}::-webkit-datetime-edit-minute-field{padding-block:0}::-webkit-datetime-edit-second-field{padding-block:0}::-webkit-datetime-edit-millisecond-field{padding-block:0}::-webkit-datetime-edit-meridiem-field{padding-block:0}::-webkit-calendar-picker-indicator{line-height:1}:-moz-ui-invalid{box-shadow:none}button,input:where([type=button],[type=reset],[type=submit]){appearance:button}::file-selector-button{appearance:button}::-webkit-inner-spin-button{height:auto}::-webkit-outer-spin-button{height:auto}[hidden]:where(:not([hidden=until-found])){display:none!important}}@layer components;@layer utilities{.collapse{visibility:collapse}.block{display:block}.flex{display:flex}.grid{display:grid}.hidden{display:none}.inline-block{display:inline-block}.inline-flex{display:inline-flex}.table{display:table}.transform{transform:var(--tw-rotate-x,) var(--tw-rotate-y,) var(--tw-rotate-z,) var(--tw-skew-x,) var(--tw-skew-y,)}.border{border-style:var(--tw-border-style);border-width:1px}.font-mono{font-family:var(--font-mono)}.break-all{word-break:break-all}.capitalize{text-transform:capitalize}.uppercase{text-transform:uppercase}.italic{font-style:italic}.outline{outline-style:var(--tw-outline-style);outline-width:1px}.filter{filter:var(--tw-blur,) var(--tw-brightness,) var(--tw-contrast,) var(--tw-grayscale,) var(--tw-hue-rotate,) var(--tw-invert,) var(--tw-saturate,) var(--tw-sepia,) var(--tw-drop-shadow,)}.transition{transition-property:color,background-color,border-color,outline-color,text-decoration-color,fill,stroke,--tw-gradient-from,--tw-gradient-via,--tw-gradient-to,opacity,box-shadow,transform,translate,scale,rotate,filter,-webkit-backdrop-filter,backdrop-filter,display,content-visibility,overlay,pointer-events;transition-timing-function:var(--tw-ease,var(--default-transition-timing-function));transition-duration:var(--tw-duration,var(--default-transition-duration))}.ease-in-out{--tw-ease:var(--ease-in-out);transition-timing-function:var(--ease-in-out)}}:root{--background:#fff;--surface:#f8f9fa;--surface-muted:#f1f3f5;--foreground:#1a1a2e;--foreground-muted:#6c757d;--border:#dee2e6;--border-strong:#adb5bd;--primary:#4361ee;--primary-foreground:#fff;--success:#2d9f5c;--warning:#e9a820;--danger:#dc3545;--info:#3b82f6;--finding-blocking:#dc3545;--finding-warning:#e9a820;--finding-fyi:#6c757d;--work-item-draft:#6c757d;--work-item-ready:#3b82f6;--work-item-progress:#8b5cf6;--work-item-blocked:#dc3545;--work-item-completed:#2d9f5c;--work-item-archived:#adb5bd;--knowledge-ready:#2d9f5c;--knowledge-missing:#dc3545;--knowledge-placeholder:#e9a820;--knowledge-unknown:#6c757d;--module-core:#4361ee;--module-module:#3b82f6;--module-unavailable:#dc3545;--readiness-ready:#2d9f5c;--readiness-warning:#e9a820;--readiness-blocked:#dc3545;--font-sans:"Inter", -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;--font-mono:"JetBrains Mono", "Fira Code", "Cascadia Code", monospace;--radius:6px}@media (prefers-color-scheme:dark){:root:not([data-theme=light]){--background:#0f0f23;--surface:#1a1a2e;--surface-muted:#16213e;--foreground:#e8e8e8;--foreground-muted:#a0a0b0;--border:#2a2a3e;--border-strong:#4a4a5e;--primary:#6580f5;--primary-foreground:#fff;--success:#3cb371;--warning:#f0b840;--danger:#ef4444;--info:#60a5fa;--finding-blocking:#ef4444;--finding-warning:#f0b840;--finding-fyi:#a0a0b0;--work-item-draft:#a0a0b0;--work-item-ready:#60a5fa;--work-item-progress:#a78bfa;--work-item-blocked:#ef4444;--work-item-completed:#3cb371;--work-item-archived:#6a6a7e;--knowledge-ready:#3cb371;--knowledge-missing:#ef4444;--knowledge-placeholder:#f0b840;--knowledge-unknown:#a0a0b0;--module-core:#6580f5;--module-module:#60a5fa;--module-unavailable:#ef4444;--readiness-ready:#3cb371;--readiness-warning:#f0b840;--readiness-blocked:#ef4444}}:root[data-theme=dark]{--background:#0f0f23;--surface:#1a1a2e;--surface-muted:#16213e;--foreground:#e8e8e8;--foreground-muted:#a0a0b0;--border:#2a2a3e;--border-strong:#4a4a5e;--primary:#6580f5;--primary-foreground:#fff;--success:#3cb371;--warning:#f0b840;--danger:#ef4444;--info:#60a5fa;--finding-blocking:#ef4444;--finding-warning:#f0b840;--finding-fyi:#a0a0b0;--work-item-draft:#a0a0b0;--work-item-ready:#60a5fa;--work-item-progress:#a78bfa;--work-item-blocked:#ef4444;--work-item-completed:#3cb371;--work-item-archived:#6a6a7e;--knowledge-ready:#3cb371;--knowledge-missing:#ef4444;--knowledge-placeholder:#f0b840;--knowledge-unknown:#a0a0b0;--module-core:#6580f5;--module-module:#60a5fa;--module-unavailable:#ef4444;--readiness-ready:#3cb371;--readiness-warning:#f0b840;--readiness-blocked:#ef4444}body{font-family:var(--font-sans);background:var(--background);color:var(--foreground);-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;margin:0}code,.font-mono{font-family:var(--font-mono)}@property --tw-rotate-x{syntax:"*";inherits:false}@property --tw-rotate-y{syntax:"*";inherits:false}@property --tw-rotate-z{syntax:"*";inherits:false}@property --tw-skew-x{syntax:"*";inherits:false}@property --tw-skew-y{syntax:"*";inherits:false}@property --tw-border-style{syntax:"*";inherits:false;initial-value:solid}@property --tw-outline-style{syntax:"*";inherits:false;initial-value:solid}@property --tw-blur{syntax:"*";inherits:false}@property --tw-brightness{syntax:"*";inherits:false}@property --tw-contrast{syntax:"*";inherits:false}@property --tw-grayscale{syntax:"*";inherits:false}@property --tw-hue-rotate{syntax:"*";inherits:false}@property --tw-invert{syntax:"*";inherits:false}@property --tw-opacity{syntax:"*";inherits:false}@property --tw-saturate{syntax:"*";inherits:false}@property --tw-sepia{syntax:"*";inherits:false}@property --tw-drop-shadow{syntax:"*";inherits:false}@property --tw-drop-shadow-color{syntax:"*";inherits:false}@property --tw-drop-shadow-alpha{syntax:"<percentage>";inherits:false;initial-value:100%}@property --tw-drop-shadow-size{syntax:"*";inherits:false}@property --tw-ease{syntax:"*";inherits:false}

package/dist/admin-dist/index.html

@@ -5,8 +5,8 @@
     <link rel="icon" type="image/svg+xml" href="/favicon.svg" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <title>admin</title>
-    <script type="module" crossorigin src="/assets/index-BrVaLM-z.js"></script>
-    <link rel="stylesheet" crossorigin href="/assets/index-zcGzKcF4.css">
+    <script type="module" crossorigin src="/assets/index-Bz7DGBBm.js"></script>
+    <link rel="stylesheet" crossorigin href="/assets/index-J0BnLZHW.css">
   </head>
   <body>
     <div id="root"></div>

package/dist/admin-server/index.js

@@ -54,8 +54,16 @@ import {
   buildProjectExplanation,
   buildReadinessReport,
   buildProjectRoute,
+  knowledgeLayers,
   loadConfig,
-  loadMappedModules
+  loadMappedModules,
+  discoverKnowledge,
+  getWorkItems as coreGetWorkItems,
+  getWorkItem as coreGetWorkItem,
+  WorkItemNotFoundError,
+  exists,
+  join,
+  readFile
 } from "@kaddo/cli/core";
 function getProjectSummary(dir) {
   const config = loadConfig(dir);
@@ -90,6 +98,22 @@ function getWorkItemSummary(dir) {
     }))
   };
 }
+function getWorkItemsList(dir, filters = {}) {
+  return coreGetWorkItems(dir, filters);
+}
+function getWorkItemDetail(dir, workItemId) {
+  if (!workItemId || workItemId.includes("..") || workItemId.includes("/") || workItemId.includes("\\") || workItemId.startsWith(".")) {
+    throw new CoreError("INVALID_WORK_ITEM_ID", "Invalid Work Item identifier.");
+  }
+  try {
+    return coreGetWorkItem(dir, workItemId);
+  } catch (err) {
+    if (err instanceof WorkItemNotFoundError) {
+      throw new CoreError("WORK_ITEM_NOT_FOUND", "This Work Item does not exist in the current project.");
+    }
+    throw err;
+  }
+}
 function getModules(dir) {
   const mapped = loadMappedModules(dir);
   return {
@@ -157,6 +181,71 @@ function getProjectOverview(dir) {
     findings: getFindings(dir)
   };
 }
+function getKnowledgeInventory(dir) {
+  const artifacts = discoverKnowledge(dir).filter((a) => !a.isWorkItem);
+  const layerSummary = knowledgeLayers(dir);
+  const layerMap = /* @__PURE__ */ new Map();
+  for (const ls of layerSummary) {
+    const id = ls.layer.toLowerCase();
+    layerMap.set(id, { id, label: ls.layer, status: ls.status, artifacts: [] });
+  }
+  for (const a of artifacts) {
+    const layerId = a.layer === "module" ? "tech" : a.layer;
+    if (!layerMap.has(layerId)) {
+      layerMap.set(layerId, { id: layerId, label: layerId.charAt(0).toUpperCase() + layerId.slice(1), status: "unknown", artifacts: [] });
+    }
+    const layer = layerMap.get(layerId);
+    const status = a.status || "available";
+    layer.artifacts.push({
+      id: a.id || a.relPath.replace(/[/\\]/g, "-").replace(/\.md$/, ""),
+      title: a.title || a.relPath.split("/").pop()?.replace(/\.md$/, "").replace(/[-_]/g, " ").replace(/\b\w/g, (c) => c.toUpperCase()) || "Untitled",
+      layer: layerId,
+      path: a.relPath,
+      status: normalizeArtifactStatus(status),
+      type: a.type || void 0
+    });
+  }
+  return { layers: Array.from(layerMap.values()) };
+}
+function normalizeArtifactStatus(status) {
+  if (!status || status === "active" || status === "ready") return "available";
+  if (status === "placeholder" || status === "draft") return "placeholder";
+  if (status === "missing") return "missing";
+  if (status === "not-applicable" || status === "n/a") return "not-applicable";
+  return "available";
+}
+function getKnowledgeArtifactDetail(dir, artifactId) {
+  if (artifactId.includes("..") || artifactId.startsWith("/") || artifactId.includes("\\")) {
+    throw new CoreError("INVALID_PATH", "Invalid artifact identifier.");
+  }
+  const artifacts = discoverKnowledge(dir).filter((a) => !a.isWorkItem);
+  const match = artifacts.find((a) => {
+    const derivedId = a.id || a.relPath.replace(/[/\\]/g, "-").replace(/\.md$/, "");
+    return derivedId === artifactId;
+  });
+  if (!match) {
+    throw new CoreError("ARTIFACT_NOT_FOUND", "Knowledge artifact not found.");
+  }
+  const fullPath = join(dir, match.relPath);
+  if (!exists(fullPath)) {
+    throw new CoreError("ARTIFACT_UNAVAILABLE", "This artifact existed when the Knowledge inventory was loaded but can no longer be read.");
+  }
+  const raw = readFile(fullPath);
+  const contentStart = raw.indexOf("---", raw.indexOf("---") + 3);
+  const content = contentStart > 0 ? raw.slice(contentStart + 3).trim() : raw;
+  const layerId = match.layer === "module" ? "tech" : match.layer;
+  const status = normalizeArtifactStatus(match.status || "available");
+  return {
+    id: match.id || match.relPath.replace(/[/\\]/g, "-").replace(/\.md$/, ""),
+    title: match.title || match.relPath.split("/").pop()?.replace(/\.md$/, "").replace(/[-_]/g, " ").replace(/\b\w/g, (c) => c.toUpperCase()) || "Untitled",
+    layer: layerId,
+    path: match.relPath,
+    status,
+    format: "markdown",
+    content,
+    type: match.type || void 0
+  };
+}
 var CoreError = class extends Error {
   constructor(code, message) {
     super(message);
@@ -218,11 +307,46 @@ async function createAdminServer(opts) {
   app.get("/api/v1/admin/overview", coreRoute(getProjectOverview));
   app.get("/api/v1/admin/project", coreRoute(getProjectSummary));
   app.get("/api/v1/admin/knowledge", coreRoute(getKnowledgeSummary));
-  app.get("/api/v1/admin/work-items", coreRoute(getWorkItemSummary));
+  app.get(
+    "/api/v1/admin/work-items",
+    async (request) => {
+      try {
+        const { status, module, query } = request.query;
+        return getWorkItemsList(projectDir, { status, module, query });
+      } catch (err) {
+        if (err instanceof CoreError) {
+          return { error: { code: err.code, message: err.message } };
+        }
+        throw err;
+      }
+    }
+  );
+  app.get("/api/v1/admin/work-items/:workItemId", async (request, reply) => {
+    try {
+      return getWorkItemDetail(projectDir, request.params.workItemId);
+    } catch (err) {
+      if (err instanceof CoreError) {
+        const code = err.code === "WORK_ITEM_NOT_FOUND" ? 404 : err.code === "INVALID_WORK_ITEM_ID" ? 400 : 500;
+        return reply.code(code).send({ error: { code: err.code, message: err.message } });
+      }
+      throw err;
+    }
+  });
   app.get("/api/v1/admin/modules", coreRoute(getModules));
   app.get("/api/v1/admin/readiness", coreRoute(getProjectReadiness));
   app.get("/api/v1/admin/route", coreRoute(getProjectRoute));
   app.get("/api/v1/admin/findings", coreRoute(getFindings));
+  app.get("/api/v1/admin/knowledge/inventory", coreRoute(getKnowledgeInventory));
+  app.get("/api/v1/admin/knowledge/artifact/:artifactId", async (request) => {
+    try {
+      return getKnowledgeArtifactDetail(projectDir, request.params.artifactId);
+    } catch (err) {
+      if (err instanceof CoreError) {
+        return { error: { code: err.code, message: err.message } };
+      }
+      throw err;
+    }
+  });
   if (staticDir) {
     app.setNotFoundHandler(async (_request, reply) => {
       return reply.sendFile("index.html");
@@ -427,6 +551,123 @@ var ProjectOverviewSchema = z.object({
   route: ProjectRouteSchema,
   findings: FindingsSummarySchema
 });
+var KnowledgeArtifactSummarySchema = z.object({
+  id: z.string(),
+  title: z.string(),
+  layer: z.string(),
+  path: z.string(),
+  status: z.string(),
+  type: z.string().optional()
+});
+var KnowledgeInventoryLayerSchema = z.object({
+  id: z.string(),
+  label: z.string(),
+  status: z.string(),
+  artifacts: z.array(KnowledgeArtifactSummarySchema)
+});
+var KnowledgeInventorySchema = z.object({
+  layers: z.array(KnowledgeInventoryLayerSchema)
+});
+var KnowledgeArtifactDetailSchema = z.object({
+  id: z.string(),
+  title: z.string(),
+  layer: z.string(),
+  path: z.string(),
+  status: z.string(),
+  format: z.string(),
+  content: z.string(),
+  type: z.string().optional()
+});
+var WorkItemsSummaryStatsSchema = z.object({
+  total: z.number(),
+  active: z.number(),
+  draft: z.number(),
+  ready: z.number(),
+  inProgress: z.number(),
+  blocked: z.number(),
+  completed: z.number(),
+  archived: z.number()
+});
+var WorkItemListItemSchema = z.object({
+  id: z.string(),
+  title: z.string(),
+  type: z.string(),
+  status: z.string(),
+  implementationStatus: z.string().nullable(),
+  validationStatus: z.string().nullable(),
+  releaseStatus: z.string().nullable(),
+  affectedModules: z.array(z.string()),
+  scopeConfidenceLevel: z.string().nullable(),
+  initiative: z.string().nullable()
+});
+var WorkItemsListSchema = z.object({
+  summary: WorkItemsSummaryStatsSchema,
+  items: z.array(WorkItemListItemSchema),
+  modules: z.array(z.string())
+});
+var CoverageEntrySchema = z.object({ id: z.string(), status: z.string(), reason: z.string().optional() });
+var ImpactEntrySchema = z.object({
+  surface: z.string(),
+  status: z.string(),
+  reason: z.string().optional(),
+  question: z.string().optional()
+});
+var AcceptanceCriterionSchema = z.object({ text: z.string(), checked: z.boolean().nullable() });
+var ReleaseGateEntrySchema = z.object({
+  id: z.string(),
+  status: z.string(),
+  reason: z.string().optional(),
+  requiredFor: z.string().optional()
+});
+var CompletionExceptionEntrySchema = z.object({
+  id: z.string(),
+  status: z.string(),
+  reason: z.string().optional(),
+  category: z.string().optional(),
+  impact: z.string().optional()
+});
+var RepoValidationSchema = z.object({ command: z.string(), status: z.string(), reason: z.string().optional() });
+var RepoMigrationSchema = z.object({
+  id: z.string(),
+  environment: z.string(),
+  status: z.string(),
+  reason: z.string().optional()
+});
+var EvidenceRepoSchema = z.object({
+  module: z.string(),
+  role: z.string(),
+  status: z.string(),
+  changedPaths: z.array(z.string()),
+  validations: z.array(RepoValidationSchema),
+  migrations: z.array(RepoMigrationSchema)
+});
+var LinkedDecisionSchema = z.object({
+  id: z.string(),
+  title: z.string().optional(),
+  knowledgeId: z.string().optional(),
+  knowledgeLayer: z.string().optional()
+});
+var LinkedKnowledgeSchema = z.object({ id: z.string(), title: z.string(), layer: z.string() });
+var WorkItemDetailSchema = WorkItemListItemSchema.extend({
+  actor: z.string().nullable(),
+  outcome: z.string().nullable(),
+  currentBehavior: z.string().nullable(),
+  targetBehavior: z.string().nullable(),
+  entryPoints: z.string().nullable(),
+  endToEndFlow: z.string().nullable(),
+  scopeConfidence: z.object({ level: z.string(), reasons: z.array(z.string()) }).nullable(),
+  scopeUnknowns: z.array(z.string()),
+  moduleCoverage: z.array(CoverageEntrySchema),
+  impactAnalysis: z.array(ImpactEntrySchema),
+  acceptanceCriteria: z.array(AcceptanceCriterionSchema),
+  implementationEvidence: z.array(EvidenceRepoSchema),
+  releaseGates: z.array(ReleaseGateEntrySchema),
+  completionExceptions: z.array(CompletionExceptionEntrySchema),
+  decisions: z.array(LinkedDecisionSchema),
+  relatedKnowledge: z.array(LinkedKnowledgeSchema),
+  source: z.object({ type: z.string(), id: z.string().optional(), inferred: z.boolean() }).passthrough(),
+  path: z.string()
+});
 var ErrorResponseSchema = z.object({
   error: z.object({
     code: z.string(),
@@ -436,6 +677,10 @@ var ErrorResponseSchema = z.object({
 export {
   ErrorResponseSchema,
   FindingsSummarySchema,
+  KnowledgeArtifactDetailSchema,
+  KnowledgeArtifactSummarySchema,
+  KnowledgeInventoryLayerSchema,
+  KnowledgeInventorySchema,
   KnowledgeSummarySchema,
   ModuleSummarySchema,
   ProjectOverviewSchema,
@@ -445,6 +690,10 @@ export {
   RouteStepSchema,
   SQLiteAdminStorage,
   SessionManager,
+  WorkItemDetailSchema,
+  WorkItemListItemSchema,
   WorkItemSummarySchema,
+  WorkItemsListSchema,
+  WorkItemsSummaryStatsSchema,
   createAdminServer
 };

package/dist/core.js

@@ -7450,15 +7450,285 @@ function analyzeCrossRepoEvidence(input) {
     repoEvidence
   };
 }
+
+// src/core/work-items.ts
+import matter6 from "gray-matter";
+var WorkItemNotFoundError = class extends Error {
+  constructor(workItemId) {
+    super(`Work Item "${workItemId}" was not found.`);
+    this.workItemId = workItemId;
+    this.name = "WorkItemNotFoundError";
+  }
+  workItemId;
+};
+function getWorkItemsSummary(dir) {
+  return summarize2(discoverWorkItems(dir));
+}
+function summarize2(artifacts) {
+  const states = artifacts.map((a) => lifecycleStateOf({ status: a.status, filePath: a.filePath }));
+  const count = (s) => states.filter((x) => x === s).length;
+  return {
+    total: states.length,
+    active: states.filter((s) => isActiveState(s)).length,
+    draft: count("draft"),
+    ready: count("ready"),
+    inProgress: count("in-progress"),
+    blocked: count("blocked"),
+    completed: count("completed"),
+    archived: count("archived")
+  };
+}
+function getWorkItems(dir, filters = {}) {
+  const artifacts = discoverWorkItems(dir);
+  const summary = summarize2(artifacts);
+  const allModules = /* @__PURE__ */ new Set();
+  for (const a of artifacts) for (const m of a.affectedModules) allModules.add(m);
+  let items = artifacts.map(toListItem);
+  if (filters.status && filters.status !== "all") {
+    items = items.filter((i) => i.status === filters.status);
+  }
+  if (filters.module && filters.module !== "all") {
+    items = items.filter((i) => i.affectedModules.includes(filters.module));
+  }
+  if (filters.query && filters.query.trim()) {
+    const q = filters.query.trim().toLowerCase();
+    items = items.filter(
+      (i) => i.id.toLowerCase().includes(q) || i.title.toLowerCase().includes(q) || i.affectedModules.some((m) => m.toLowerCase().includes(q))
+    );
+  }
+  items.sort((a, b) => {
+    const rank = (s) => isActiveState(s) ? 0 : s === "completed" ? 1 : 2;
+    const r = rank(a.status) - rank(b.status);
+    if (r !== 0) return r;
+    return a.id.localeCompare(b.id, void 0, { numeric: true });
+  });
+  return { summary, items, modules: [...allModules].sort() };
+}
+function toListItem(a) {
+  return {
+    id: a.id || a.title,
+    title: a.title || a.id,
+    type: a.type,
+    status: lifecycleStateOf({ status: a.status, filePath: a.filePath }),
+    implementationStatus: a.implementationStatus || null,
+    validationStatus: a.validationStatus || null,
+    releaseStatus: a.releaseStatus || null,
+    affectedModules: a.affectedModules,
+    scopeConfidenceLevel: a.scopeConfidence?.level ?? null,
+    initiative: a.initiative || null
+  };
+}
+function getWorkItem(dir, workItemId) {
+  const artifacts = discoverWorkItems(dir);
+  const match = artifacts.find((a) => (a.id || a.title) === workItemId);
+  if (!match) throw new WorkItemNotFoundError(workItemId);
+  const base = toListItem(match);
+  const body = readBody(match.filePath);
+  const sections = splitSections(body);
+  const fm = match.rawFrontmatter;
+  const knowledge = discoverKnowledge(dir).filter((a) => !a.isWorkItem);
+  const knowledgeById = new Map(knowledge.filter((k) => k.id).map((k) => [k.id, k]));
+  return {
+    ...base,
+    actor: sectionText(sections, ["actor"]),
+    outcome: sectionText(sections, ["actor and outcome", "outcome", "expected result"]),
+    currentBehavior: sectionText(sections, ["current behavior", "current behaviour"]),
+    targetBehavior: sectionText(sections, ["target behavior", "target behaviour"]),
+    entryPoints: sectionText(sections, ["entry points"]),
+    endToEndFlow: sectionText(sections, ["end-to-end flow", "end to end flow", "flow"]),
+    scopeConfidence: match.scopeConfidence,
+    scopeUnknowns: sectionBullets(sections, ["scope unknowns", "open scope questions"]),
+    moduleCoverage: normalizeCoverage(match.moduleCoverage),
+    impactAnalysis: normalizeImpact(match.impactAnalysis),
+    acceptanceCriteria: parseAcceptanceCriteria(sections),
+    implementationEvidence: parseEvidence(fm),
+    releaseGates: parseReleaseGates(fm),
+    completionExceptions: parseExceptions(fm),
+    decisions: parseDecisions(match.decisions, knowledgeById),
+    relatedKnowledge: parseRelatedKnowledge(fm, knowledgeById),
+    source: parseWorkItemSource(fm),
+    path: match.relPath
+  };
+}
+function readBody(filePath) {
+  try {
+    const raw = readFile(filePath);
+    return matter6(raw).content;
+  } catch {
+    return "";
+  }
+}
+function splitSections(body) {
+  const sections = /* @__PURE__ */ new Map();
+  const lines = body.split(/\r?\n/);
+  let current = null;
+  let buffer = [];
+  const flush = () => {
+    if (current !== null) sections.set(current, buffer.join("\n").trim());
+    buffer = [];
+  };
+  for (const line of lines) {
+    const m = line.match(/^#{1,6}\s+(.*?)\s*$/);
+    if (m) {
+      flush();
+      current = m[1].toLowerCase().replace(/[`*_]/g, "").trim();
+    } else if (current !== null) {
+      buffer.push(line);
+    }
+  }
+  flush();
+  return sections;
+}
+function isPlaceholder(text3) {
+  const t = text3.trim();
+  if (!t) return true;
+  if (/^tbd$/i.test(t)) return true;
+  if (/^_[^_]*_$/.test(t) && !t.includes("\n")) return true;
+  return false;
+}
+function sectionText(sections, headings) {
+  for (const h of headings) {
+    const body = sections.get(h);
+    if (body != null && !isPlaceholder(body)) return body.trim();
+  }
+  return null;
+}
+function sectionBullets(sections, headings) {
+  for (const h of headings) {
+    const body = sections.get(h);
+    if (body == null || isPlaceholder(body)) continue;
+    const bullets = extractBullets(body);
+    if (bullets.length > 0) return bullets.map((b) => b.text);
+  }
+  return [];
+}
+function extractBullets(body) {
+  const out = [];
+  for (const line of body.split(/\r?\n/)) {
+    const m = line.match(/^\s*[-*+]\s+(.*)$/);
+    if (!m) continue;
+    let text3 = m[1].trim();
+    let checked = null;
+    const cb = text3.match(/^\[([ xX])\]\s*(.*)$/);
+    if (cb) {
+      checked = cb[1].toLowerCase() === "x";
+      text3 = cb[2].trim();
+    }
+    if (!text3 || isPlaceholder(text3)) continue;
+    out.push({ text: text3, checked });
+  }
+  return out;
+}
+function parseAcceptanceCriteria(sections) {
+  const body = sections.get("acceptance criteria");
+  if (body == null || isPlaceholder(body)) return [];
+  return extractBullets(body).map((b) => ({ text: b.text, checked: b.checked }));
+}
+function normalizeCoverage(mc) {
+  if (!mc) return [];
+  return Object.entries(mc).map(([id, v]) => ({ id, status: v.status, ...v.reason ? { reason: v.reason } : {} }));
+}
+function normalizeImpact(ia) {
+  if (!ia) return [];
+  return Object.entries(ia).map(([surface, v]) => ({
+    surface,
+    status: v.status,
+    ...v.reason ? { reason: v.reason } : {},
+    ...v.question ? { question: v.question } : {}
+  }));
+}
+function optStr2(v) {
+  if (typeof v === "string" && v.trim()) return v.trim();
+  return void 0;
+}
+function parseEvidence(fm) {
+  const evidence = fm.implementation_evidence;
+  const repos = evidence?.repositories;
+  if (!repos || typeof repos !== "object" || Array.isArray(repos)) return [];
+  const out = [];
+  for (const [module, val] of Object.entries(repos)) {
+    if (!val || typeof val !== "object" || Array.isArray(val)) continue;
+    const d = val;
+    const validations = Array.isArray(d.validations) ? d.validations.map((v) => ({
+      command: String(v.command ?? ""),
+      status: String(v.status ?? "unknown"),
+      ...optStr2(v.reason) ? { reason: optStr2(v.reason) } : {}
+    })) : [];
+    const migrations = Array.isArray(d.migrations) ? d.migrations.map((m) => ({
+      id: String(m.id ?? ""),
+      environment: String(m.environment ?? ""),
+      status: String(m.status ?? "unknown"),
+      ...optStr2(m.reason) ? { reason: optStr2(m.reason) } : {}
+    })) : [];
+    out.push({
+      module,
+      role: String(d.role ?? (module === "core" ? "core" : "module")),
+      status: String(d.status ?? "unknown"),
+      changedPaths: Array.isArray(d.changed_paths) ? d.changed_paths.map(String).filter(Boolean) : [],
+      validations,
+      migrations
+    });
+  }
+  return out;
+}
+function parseReleaseGates(fm) {
+  if (!Array.isArray(fm.release_gates)) return [];
+  return fm.release_gates.filter((g) => g && typeof g === "object").map((g) => ({
+    id: String(g.id ?? ""),
+    status: String(g.status ?? "pending"),
+    ...optStr2(g.reason) ? { reason: optStr2(g.reason) } : {},
+    ...optStr2(g.required_for) ? { requiredFor: optStr2(g.required_for) } : {}
+  }));
+}
+function parseExceptions(fm) {
+  if (!Array.isArray(fm.completion_exceptions)) return [];
+  return fm.completion_exceptions.filter((e) => e && typeof e === "object").map((e) => ({
+    id: String(e.id ?? ""),
+    status: String(e.status ?? "proposed"),
+    ...optStr2(e.reason) ? { reason: optStr2(e.reason) } : {},
+    ...optStr2(e.category) ? { category: optStr2(e.category) } : {},
+    ...optStr2(e.impact) ? { impact: optStr2(e.impact) } : {}
+  }));
+}
+function parseDecisions(decisions, knowledgeById) {
+  return decisions.map((id) => {
+    const k = knowledgeById.get(id);
+    return {
+      id,
+      ...k?.title ? { title: k.title } : {},
+      ...k ? { knowledgeId: k.id, knowledgeLayer: k.layer } : {}
+    };
+  });
+}
+function parseRelatedKnowledge(fm, knowledgeById) {
+  const refs = /* @__PURE__ */ new Set();
+  for (const field of ["related_knowledge", "knowledge", "related"]) {
+    const v = fm[field];
+    if (Array.isArray(v)) {
+      for (const r of v) if (typeof r === "string" && r.trim()) refs.add(r.trim());
+    }
+  }
+  const out = [];
+  for (const ref of refs) {
+    const k = knowledgeById.get(ref);
+    if (k && k.id) out.push({ id: k.id, title: k.title || k.id, layer: k.layer });
+  }
+  return out;
+}
 export {
+  WorkItemNotFoundError,
   analyzeCrossRepoEvidence,
   analyzeScopeCoverage,
   buildProjectExplanation,
   buildProjectRoute,
   buildReadinessReport,
   cwd,
+  discoverKnowledge,
   discoverWorkItems,
   exists,
+  getWorkItem,
+  getWorkItems,
+  getWorkItemsSummary,
   isActiveState,
   isModule,
   join,

package/package.json

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