mrvn-cli 0.5.0 → 0.5.2

package/dist/marvin-serve.js

@@ -6474,13 +6474,13 @@ var error16 = () => {
     // no unit
   };
   const typeEntry = (t) => t ? TypeNames[t] : void 0;
-  const typeLabel4 = (t) => {
+  const typeLabel5 = (t) => {
     const e = typeEntry(t);
     if (e)
       return e.label;
     return t ?? TypeNames.unknown.label;
   };
-  const withDefinite = (t) => `\u05D4${typeLabel4(t)}`;
+  const withDefinite = (t) => `\u05D4${typeLabel5(t)}`;
   const verbFor = (t) => {
     const e = typeEntry(t);
     const gender = e?.gender ?? "m";
@@ -6530,7 +6530,7 @@ var error16 = () => {
     switch (issue2.code) {
       case "invalid_type": {
         const expectedKey = issue2.expected;
-        const expected = TypeDictionary[expectedKey ?? ""] ?? typeLabel4(expectedKey);
+        const expected = TypeDictionary[expectedKey ?? ""] ?? typeLabel5(expectedKey);
         const receivedType = parsedType(issue2.input);
         const received = TypeDictionary[receivedType] ?? TypeNames[receivedType]?.label ?? receivedType;
         if (/^[A-Z]/.test(issue2.expected)) {
@@ -14209,6 +14209,26 @@ config(en_default());
 
 // src/agent/tools/decisions.ts
 import { tool } from "@anthropic-ai/claude-agent-sdk";
+
+// src/personas/owner.ts
+var OWNER_SHORT = ["po", "dm", "tl"];
+var OWNER_LONG = ["product-owner", "delivery-manager", "tech-lead"];
+var VALID_OWNERS = [...OWNER_SHORT, ...OWNER_LONG];
+var LONG_TO_SHORT = {
+  "product-owner": "po",
+  "delivery-manager": "dm",
+  "tech-lead": "tl"
+};
+var ownerSchema = external_exports.enum(VALID_OWNERS);
+function normalizeOwner(owner) {
+  if (owner === void 0) return void 0;
+  return LONG_TO_SHORT[owner] ?? owner;
+}
+function isValidOwner(value) {
+  return VALID_OWNERS.includes(value);
+}
+
+// src/agent/tools/decisions.ts
 function createDecisionTools(store) {
   return [
     tool(
@@ -14263,7 +14283,8 @@ function createDecisionTools(store) {
         title: external_exports.string().describe("Title of the decision"),
         content: external_exports.string().describe("Decision description, context, and rationale"),
         status: external_exports.enum(["open", "decided", "superseded", "dismissed"]).optional().describe("Status (default: 'open')"),
-        owner: external_exports.string().optional().describe("Person responsible for this decision"),
+        owner: ownerSchema.optional().describe("Persona role responsible (po, dm, tl)"),
+        assignee: external_exports.string().optional().describe("Person assigned to do the work"),
         tags: external_exports.array(external_exports.string()).optional().describe("Tags for categorization")
       },
       async (args) => {
@@ -14272,7 +14293,8 @@ function createDecisionTools(store) {
           {
             title: args.title,
             status: args.status,
-            owner: args.owner,
+            owner: normalizeOwner(args.owner),
+            assignee: args.assignee,
             tags: args.tags
           },
           args.content
@@ -14295,11 +14317,14 @@ function createDecisionTools(store) {
         title: external_exports.string().optional().describe("New title"),
         status: external_exports.enum(["open", "decided", "superseded", "dismissed"]).optional().describe("New status"),
         content: external_exports.string().optional().describe("New content"),
-        owner: external_exports.string().optional().describe("New owner"),
+        owner: ownerSchema.optional().describe("Persona role responsible (po, dm, tl)"),
+        assignee: external_exports.string().optional().describe("Person assigned to do the work"),
         tags: external_exports.array(external_exports.string()).optional().describe("Replace tags (e.g. remove 'risk', add 'risk-mitigated')")
       },
       async (args) => {
-        const { id, content, ...updates } = args;
+        const { id, content, owner, assignee, ...updates } = args;
+        if (owner !== void 0) updates.owner = normalizeOwner(owner);
+        if (assignee !== void 0) updates.assignee = assignee;
         const doc = store.update(id, updates, content);
         return {
           content: [
@@ -14334,7 +14359,7 @@ function propagateProgressFromTask(store, taskId) {
       store.update(taskId, { progress: 100 });
       updated.push(taskId);
     }
-  } else {
+  } else if (!task.frontmatter.progressOverride) {
     const children = store.list({ type: "contribution" }).filter((d) => d.frontmatter.aboutArtifact === taskId);
     if (children.length > 0) {
       const avg = children.reduce((sum, c) => sum + getEffectiveProgress(c.frontmatter), 0) / children.length;
@@ -14365,27 +14390,29 @@ function propagateProgressToAction(store, actionId) {
     }
     return updated;
   }
-  const childTasks = store.list({ type: "task" }).filter((d) => d.frontmatter.aboutArtifact === actionId);
-  const directContribs = store.list({ type: "contribution" }).filter((d) => d.frontmatter.aboutArtifact === actionId);
-  const hasTasks = childTasks.length > 0;
-  const hasContribs = directContribs.length > 0;
-  let progress;
-  if (hasTasks && hasContribs) {
-    const taskAvg = childTasks.reduce((s, t) => s + getEffectiveProgress(t.frontmatter), 0) / childTasks.length;
-    const contribAvg = directContribs.reduce((s, c) => s + getEffectiveProgress(c.frontmatter), 0) / directContribs.length;
-    progress = Math.round(taskAvg * 0.8 + contribAvg * 0.2);
-  } else if (hasTasks) {
-    progress = Math.round(
-      childTasks.reduce((s, t) => s + getEffectiveProgress(t.frontmatter), 0) / childTasks.length
-    );
-  } else if (hasContribs) {
-    progress = Math.round(
-      directContribs.reduce((s, c) => s + getEffectiveProgress(c.frontmatter), 0) / directContribs.length
-    );
-  }
-  if (progress !== void 0) {
-    store.update(actionId, { progress });
-    updated.push(actionId);
+  if (!action.frontmatter.progressOverride) {
+    const childTasks = store.list({ type: "task" }).filter((d) => d.frontmatter.aboutArtifact === actionId);
+    const directContribs = store.list({ type: "contribution" }).filter((d) => d.frontmatter.aboutArtifact === actionId);
+    const hasTasks = childTasks.length > 0;
+    const hasContribs = directContribs.length > 0;
+    let progress;
+    if (hasTasks && hasContribs) {
+      const taskAvg = childTasks.reduce((s, t) => s + getEffectiveProgress(t.frontmatter), 0) / childTasks.length;
+      const contribAvg = directContribs.reduce((s, c) => s + getEffectiveProgress(c.frontmatter), 0) / directContribs.length;
+      progress = Math.round(taskAvg * 0.8 + contribAvg * 0.2);
+    } else if (hasTasks) {
+      progress = Math.round(
+        childTasks.reduce((s, t) => s + getEffectiveProgress(t.frontmatter), 0) / childTasks.length
+      );
+    } else if (hasContribs) {
+      progress = Math.round(
+        directContribs.reduce((s, c) => s + getEffectiveProgress(c.frontmatter), 0) / directContribs.length
+      );
+    }
+    if (progress !== void 0) {
+      store.update(actionId, { progress });
+      updated.push(actionId);
+    }
   }
   return updated;
 }
@@ -14480,12 +14507,13 @@ function createActionTools(store) {
         title: external_exports.string().describe("Title of the action item"),
         content: external_exports.string().describe("Description of what needs to be done"),
         status: external_exports.string().optional().describe("Status (default: 'open')"),
-        owner: external_exports.string().optional().describe("Person responsible"),
+        owner: ownerSchema.optional().describe("Persona role responsible (po, dm, tl)"),
+        assignee: external_exports.string().optional().describe("Person assigned to do the work"),
         priority: external_exports.string().optional().describe("Priority (high, medium, low)"),
         tags: external_exports.array(external_exports.string()).optional().describe("Tags for categorization"),
         dueDate: external_exports.string().optional().describe("Due date in ISO format (e.g. '2026-03-15')"),
         sprints: external_exports.array(external_exports.string()).optional().describe("Sprint IDs to assign (e.g. ['SP-001']). Adds sprint:SP-xxx tags."),
-        workStream: external_exports.string().optional().describe("Work stream name (e.g. 'Budget UX'). Adds a stream:<value> tag.")
+        workFocus: external_exports.string().optional().describe("Work focus name (e.g. 'Budget UX'). Adds a focus:<value> tag.")
       },
       async (args) => {
         const tags = [...args.tags ?? []];
@@ -14495,15 +14523,16 @@ function createActionTools(store) {
             if (!tags.includes(tag)) tags.push(tag);
           }
         }
-        if (args.workStream) {
-          tags.push(`stream:${args.workStream}`);
+        if (args.workFocus) {
+          tags.push(`focus:${args.workFocus}`);
         }
         const doc = store.create(
           "action",
           {
             title: args.title,
             status: args.status,
-            owner: args.owner,
+            owner: normalizeOwner(args.owner),
+            assignee: args.assignee,
             priority: args.priority,
             tags: tags.length > 0 ? tags : void 0,
             dueDate: args.dueDate
@@ -14531,16 +14560,19 @@ function createActionTools(store) {
         title: external_exports.string().optional().describe("New title"),
         status: external_exports.string().optional().describe("New status"),
         content: external_exports.string().optional().describe("New content"),
-        owner: external_exports.string().optional().describe("New owner"),
+        owner: ownerSchema.optional().describe("Persona role responsible (po, dm, tl)"),
+        assignee: external_exports.string().optional().describe("Person assigned to do the work"),
         priority: external_exports.string().optional().describe("New priority"),
         dueDate: external_exports.string().optional().describe("Due date in ISO format (e.g. '2026-03-15')"),
         tags: external_exports.array(external_exports.string()).optional().describe("Replace all tags. When provided with sprints, sprint tags are merged into this array."),
         sprints: external_exports.array(external_exports.string()).optional().describe("Sprint IDs to assign (replaces existing sprint tags). E.g. ['SP-001']."),
-        workStream: external_exports.string().optional().describe("Work stream name (e.g. 'Budget UX'). Replaces existing stream:<value> tag."),
+        workFocus: external_exports.string().optional().describe("Work focus name (e.g. 'Budget UX'). Replaces existing focus:<value> tag."),
         progress: external_exports.number().optional().describe("Explicit progress percentage (0-100).")
       },
       async (args) => {
-        const { id, content, sprints, tags, workStream, progress, ...updates } = args;
+        const { id, content, sprints, tags, workFocus, progress, owner, assignee, ...updates } = args;
+        if (owner !== void 0) updates.owner = normalizeOwner(owner);
+        if (assignee !== void 0) updates.assignee = assignee;
         if (tags !== void 0) {
           const merged = [...tags];
           if (sprints) {
@@ -14549,14 +14581,14 @@ function createActionTools(store) {
               if (!merged.includes(tag)) merged.push(tag);
             }
           }
-          if (workStream !== void 0) {
-            const filtered = merged.filter((t) => !t.startsWith("stream:"));
-            filtered.push(`stream:${workStream}`);
+          if (workFocus !== void 0) {
+            const filtered = merged.filter((t) => !t.startsWith("focus:"));
+            filtered.push(`focus:${workFocus}`);
             updates.tags = filtered;
           } else {
             updates.tags = merged;
           }
-        } else if (sprints !== void 0 || workStream !== void 0) {
+        } else if (sprints !== void 0 || workFocus !== void 0) {
           const existing = store.get(id);
           if (!existing) {
             return {
@@ -14569,14 +14601,15 @@ function createActionTools(store) {
             existingTags = existingTags.filter((t) => !t.startsWith("sprint:"));
             existingTags.push(...sprints.map((s) => `sprint:${s}`));
           }
-          if (workStream !== void 0) {
-            existingTags = existingTags.filter((t) => !t.startsWith("stream:"));
-            existingTags.push(`stream:${workStream}`);
+          if (workFocus !== void 0) {
+            existingTags = existingTags.filter((t) => !t.startsWith("focus:"));
+            existingTags.push(`focus:${workFocus}`);
           }
           updates.tags = existingTags;
         }
         if (typeof progress === "number") {
           updates.progress = Math.max(0, Math.min(100, Math.round(progress)));
+          updates.progressOverride = true;
         }
         const doc = store.update(id, updates, content);
         if (args.status !== void 0 || typeof progress === "number") {
@@ -14683,7 +14716,8 @@ function createQuestionTools(store) {
         title: external_exports.string().describe("The question being asked"),
         content: external_exports.string().describe("Context and details about the question"),
         status: external_exports.string().optional().describe("Status (default: 'open')"),
-        owner: external_exports.string().optional().describe("Person who should answer this"),
+        owner: ownerSchema.optional().describe("Persona role responsible (po, dm, tl)"),
+        assignee: external_exports.string().optional().describe("Person assigned to do the work"),
         tags: external_exports.array(external_exports.string()).optional().describe("Tags for categorization")
       },
       async (args) => {
@@ -14692,7 +14726,8 @@ function createQuestionTools(store) {
           {
             title: args.title,
             status: args.status,
-            owner: args.owner,
+            owner: normalizeOwner(args.owner),
+            assignee: args.assignee,
             tags: args.tags
           },
           args.content
@@ -14715,11 +14750,14 @@ function createQuestionTools(store) {
         title: external_exports.string().optional().describe("New title"),
         status: external_exports.string().optional().describe("New status (e.g. 'answered')"),
         content: external_exports.string().optional().describe("Updated content / answer"),
-        owner: external_exports.string().optional().describe("New owner"),
+        owner: ownerSchema.optional().describe("Persona role responsible (po, dm, tl)"),
+        assignee: external_exports.string().optional().describe("Person assigned to do the work"),
         tags: external_exports.array(external_exports.string()).optional().describe("Replace tags (e.g. remove 'risk', add 'risk-mitigated')")
       },
       async (args) => {
-        const { id, content, ...updates } = args;
+        const { id, content, owner, assignee, ...updates } = args;
+        if (owner !== void 0) updates.owner = normalizeOwner(owner);
+        if (assignee !== void 0) updates.assignee = assignee;
         const doc = store.update(id, updates, content);
         return {
           content: [
@@ -14744,18 +14782,20 @@ function createDocumentTools(store) {
       {
         type: external_exports.string().optional().describe(`Filter by document type (registered types: ${store.registeredTypes.join(", ")})`),
         status: external_exports.string().optional().describe("Filter by status"),
+        owner: external_exports.string().optional().describe("Filter by persona role owner (po, dm, tl)"),
         tag: external_exports.string().optional().describe("Filter by tag"),
-        workStream: external_exports.string().optional().describe("Filter by work stream name (matches stream:<value> tag)")
+        workFocus: external_exports.string().optional().describe("Filter by work focus name (matches focus:<value> tag)")
       },
       async (args) => {
         let docs = store.list({
           type: args.type,
           status: args.status,
+          owner: args.owner,
           tag: args.tag
         });
-        if (args.workStream) {
-          const streamTag = `stream:${args.workStream}`;
-          docs = docs.filter((d) => d.frontmatter.tags?.includes(streamTag));
+        if (args.workFocus) {
+          const focusTag = `focus:${args.workFocus}`;
+          docs = docs.filter((d) => d.frontmatter.tags?.includes(focusTag));
         }
         const summary = docs.map((d) => ({
           id: d.frontmatter.id,
@@ -15077,7 +15117,8 @@ function createMeetingTools(store) {
         title: external_exports.string().describe("Title of the meeting"),
         content: external_exports.string().describe("Meeting agenda, notes, or minutes"),
         status: external_exports.string().optional().describe("Status (default: 'scheduled')"),
-        owner: external_exports.string().optional().describe("Meeting organizer"),
+        owner: ownerSchema.optional().describe("Persona role responsible (po, dm, tl)"),
+        assignee: external_exports.string().optional().describe("Person assigned to do the work"),
         tags: external_exports.array(external_exports.string()).optional().describe("Tags for categorization"),
         attendees: external_exports.array(external_exports.string()).optional().describe("List of attendees"),
         date: external_exports.string().describe("Date the meeting took place (ISO format, e.g. '2025-01-15'). Extract from the meeting content. If not found, ask the user before calling this tool.")
@@ -15087,7 +15128,8 @@ function createMeetingTools(store) {
           title: args.title,
           status: args.status ?? "scheduled"
         };
-        if (args.owner) frontmatter.owner = args.owner;
+        if (args.owner) frontmatter.owner = normalizeOwner(args.owner);
+        if (args.assignee) frontmatter.assignee = args.assignee;
         if (args.tags) frontmatter.tags = args.tags;
         if (args.attendees) frontmatter.attendees = args.attendees;
         frontmatter.date = args.date;
@@ -15114,10 +15156,13 @@ function createMeetingTools(store) {
         title: external_exports.string().optional().describe("New title"),
         status: external_exports.string().optional().describe("New status"),
         content: external_exports.string().optional().describe("New content"),
-        owner: external_exports.string().optional().describe("New owner")
+        owner: ownerSchema.optional().describe("Persona role responsible (po, dm, tl)"),
+        assignee: external_exports.string().optional().describe("Person assigned to do the work")
       },
       async (args) => {
-        const { id, content, ...updates } = args;
+        const { id, content, owner, assignee, ...updates } = args;
+        if (owner !== void 0) updates.owner = normalizeOwner(owner);
+        if (assignee !== void 0) updates.assignee = assignee;
         const doc = store.update(id, updates, content);
         return {
           content: [
@@ -15650,14 +15695,14 @@ function collectSprintSummaryData(store, sprintId) {
   const sprintItemIds = new Set(workItemDocs.map((d) => d.frontmatter.id));
   for (const doc of workItemDocs) {
     const about = doc.frontmatter.aboutArtifact;
-    const streamTag = (doc.frontmatter.tags ?? []).find((t) => t.startsWith("stream:"));
+    const focusTag = (doc.frontmatter.tags ?? []).find((t) => t.startsWith("focus:"));
     const item = {
       id: doc.frontmatter.id,
       title: doc.frontmatter.title,
       type: doc.frontmatter.type,
       status: doc.frontmatter.status,
       progress: getEffectiveProgress(doc.frontmatter),
-      workStream: streamTag ? streamTag.slice(7) : void 0,
+      workFocus: focusTag ? focusTag.slice(6) : void 0,
       aboutArtifact: about
     };
     allItemsById.set(item.id, item);
@@ -16812,7 +16857,8 @@ function createFeatureTools(store) {
         title: external_exports.string().describe("Feature title"),
         content: external_exports.string().describe("Feature description and requirements"),
         status: external_exports.enum(["draft", "approved", "deferred", "done"]).optional().describe("Feature status (default: 'draft')"),
-        owner: external_exports.string().optional().describe("Feature owner"),
+        owner: ownerSchema.optional().describe("Persona role responsible (po, dm, tl)"),
+        assignee: external_exports.string().optional().describe("Person assigned to do the work"),
         priority: external_exports.enum(["critical", "high", "medium", "low"]).optional().describe("Feature priority"),
         tags: external_exports.array(external_exports.string()).optional().describe("Tags for categorization")
       },
@@ -16821,7 +16867,8 @@ function createFeatureTools(store) {
           title: args.title,
           status: args.status ?? "draft"
         };
-        if (args.owner) frontmatter.owner = args.owner;
+        if (args.owner) frontmatter.owner = normalizeOwner(args.owner);
+        if (args.assignee) frontmatter.assignee = args.assignee;
         if (args.priority) frontmatter.priority = args.priority;
         if (args.tags) frontmatter.tags = args.tags;
         const doc = store.create("feature", frontmatter, args.content);
@@ -16843,12 +16890,15 @@ function createFeatureTools(store) {
         title: external_exports.string().optional().describe("New title"),
         status: external_exports.enum(["draft", "approved", "deferred", "done"]).optional().describe("New status"),
         content: external_exports.string().optional().describe("New content"),
-        owner: external_exports.string().optional().describe("New owner"),
+        owner: ownerSchema.optional().describe("Persona role responsible (po, dm, tl)"),
+        assignee: external_exports.string().optional().describe("Person assigned to do the work"),
         priority: external_exports.enum(["critical", "high", "medium", "low"]).optional().describe("New priority"),
         tags: external_exports.array(external_exports.string()).optional().describe("Replace tags (e.g. remove 'risk', add 'risk-mitigated')")
       },
       async (args) => {
-        const { id, content, ...updates } = args;
+        const { id, content, owner, assignee, ...updates } = args;
+        if (owner !== void 0) updates.owner = normalizeOwner(owner);
+        if (assignee !== void 0) updates.assignee = assignee;
         const doc = store.update(id, updates, content);
         return {
           content: [
@@ -16946,7 +16996,8 @@ function createEpicTools(store) {
         content: external_exports.string().describe("Epic description and scope"),
         linkedFeature: linkedFeatureArray.describe("Feature ID(s) to link this epic to (e.g. ['F-001'] or ['F-001', 'F-002'])"),
         status: external_exports.enum(["planned", "in-progress", "done"]).optional().describe("Epic status (default: 'planned')"),
-        owner: external_exports.string().optional().describe("Epic owner"),
+        owner: ownerSchema.optional().describe("Persona role responsible (po, dm, tl)"),
+        assignee: external_exports.string().optional().describe("Person assigned to do the work"),
         targetDate: external_exports.string().optional().describe("Target completion date (ISO format)"),
         estimatedEffort: external_exports.string().optional().describe("Estimated effort (e.g. '2 weeks', '5 story points')"),
         tags: external_exports.array(external_exports.string()).optional().describe("Additional tags")
@@ -16995,7 +17046,8 @@ function createEpicTools(store) {
           linkedFeature: linkedFeatures,
           tags: [...generateFeatureTags(linkedFeatures), ...args.tags ?? []]
         };
-        if (args.owner) frontmatter.owner = args.owner;
+        if (args.owner) frontmatter.owner = normalizeOwner(args.owner);
+        if (args.assignee) frontmatter.assignee = args.assignee;
         if (args.targetDate) frontmatter.targetDate = args.targetDate;
         if (args.estimatedEffort) frontmatter.estimatedEffort = args.estimatedEffort;
         const doc = store.create("epic", frontmatter, args.content);
@@ -17017,14 +17069,17 @@ function createEpicTools(store) {
         title: external_exports.string().optional().describe("New title"),
         status: external_exports.enum(["planned", "in-progress", "done"]).optional().describe("New status"),
         content: external_exports.string().optional().describe("New content"),
-        owner: external_exports.string().optional().describe("New owner"),
+        owner: ownerSchema.optional().describe("Persona role responsible (po, dm, tl)"),
+        assignee: external_exports.string().optional().describe("Person assigned to do the work"),
         targetDate: external_exports.string().optional().describe("New target date"),
         estimatedEffort: external_exports.string().optional().describe("New estimated effort"),
         linkedFeature: linkedFeatureArray.optional().describe("New linked feature ID(s)"),
         tags: external_exports.array(external_exports.string()).optional().describe("Replace tags (e.g. remove 'risk', add 'risk-mitigated')")
       },
       async (args) => {
-        const { id, content, linkedFeature: rawLinkedFeature, tags: userTags, ...updates } = args;
+        const { id, content, linkedFeature: rawLinkedFeature, tags: userTags, owner, assignee, ...updates } = args;
+        if (owner !== void 0) updates.owner = normalizeOwner(owner);
+        if (assignee !== void 0) updates.assignee = assignee;
         if (rawLinkedFeature !== void 0) {
           const linkedFeatures = normalizeLinkedFeatures(rawLinkedFeature);
           for (const featureId of linkedFeatures) {
@@ -17151,7 +17206,7 @@ function createContributionTools(store) {
         aboutArtifact: external_exports.string().describe("Artifact ID this contribution relates to (e.g. 'A-001', 'T-003')"),
         status: external_exports.string().optional().describe("Status (default: 'done')"),
         tags: external_exports.array(external_exports.string()).optional().describe("Tags for categorization"),
-        workStream: external_exports.string().optional().describe("Work stream name (e.g. 'Budget UX'). Adds a stream:<value> tag."),
+        workFocus: external_exports.string().optional().describe("Work focus name (e.g. 'Budget UX'). Adds a focus:<value> tag."),
         parentProgress: external_exports.number().optional().describe("Set progress (0-100) on the parent artifact (e.g. task or action). Propagates up the hierarchy.")
       },
       async (args) => {
@@ -17163,7 +17218,7 @@ function createContributionTools(store) {
         };
         frontmatter.aboutArtifact = args.aboutArtifact;
         const tags = [...args.tags ?? []];
-        if (args.workStream) tags.push(`stream:${args.workStream}`);
+        if (args.workFocus) tags.push(`focus:${args.workFocus}`);
         if (tags.length > 0) frontmatter.tags = tags;
         const doc = store.create("contribution", frontmatter, args.content);
         const progressParts = [];
@@ -17172,7 +17227,7 @@ function createContributionTools(store) {
           if (parent) {
             if (typeof args.parentProgress === "number") {
               const clamped = Math.max(0, Math.min(100, Math.round(args.parentProgress)));
-              store.update(args.aboutArtifact, { progress: clamped });
+              store.update(args.aboutArtifact, { progress: clamped, progressOverride: true });
               progressParts.push(`${args.aboutArtifact} \u2192 ${clamped}%`);
               if (parent.frontmatter.type === "task") {
                 const grandparent = parent.frontmatter.aboutArtifact;
@@ -17219,15 +17274,15 @@ function createContributionTools(store) {
         title: external_exports.string().optional().describe("New title"),
         status: external_exports.string().optional().describe("New status"),
         content: external_exports.string().optional().describe("New content"),
-        workStream: external_exports.string().optional().describe("Work stream name (e.g. 'Budget UX'). Replaces existing stream:<value> tag.")
+        workFocus: external_exports.string().optional().describe("Work focus name (e.g. 'Budget UX'). Replaces existing focus:<value> tag.")
       },
       async (args) => {
-        const { id, content, workStream, ...updates } = args;
-        if (workStream !== void 0) {
+        const { id, content, workFocus, ...updates } = args;
+        if (workFocus !== void 0) {
           const existing = store.get(id);
           const existingTags = existing?.frontmatter.tags ?? [];
-          const filtered = existingTags.filter((t) => !t.startsWith("stream:"));
-          filtered.push(`stream:${workStream}`);
+          const filtered = existingTags.filter((t) => !t.startsWith("focus:"));
+          filtered.push(`focus:${workFocus}`);
           updates.tags = filtered;
         }
         const oldDoc = store.get(id);
@@ -17710,7 +17765,7 @@ function createTaskTools(store) {
         complexity: external_exports.enum(["trivial", "simple", "moderate", "complex", "very-complex"]).optional().describe("Task complexity"),
         priority: external_exports.enum(["critical", "high", "medium", "low"]).optional().describe("Task priority"),
         tags: external_exports.array(external_exports.string()).optional().describe("Additional tags"),
-        workStream: external_exports.string().optional().describe("Work stream name (e.g. 'Budget UX'). Adds a stream:<value> tag.")
+        workFocus: external_exports.string().optional().describe("Work focus name (e.g. 'Budget UX'). Adds a focus:<value> tag.")
       },
       async (args) => {
         const linkedEpics = normalizeLinkedEpics(args.linkedEpic);
@@ -17724,7 +17779,7 @@ function createTaskTools(store) {
           }
         }
         const baseTags = [...generateEpicTags(linkedEpics), ...args.tags ?? []];
-        if (args.workStream) baseTags.push(`stream:${args.workStream}`);
+        if (args.workFocus) baseTags.push(`focus:${args.workFocus}`);
         const frontmatter = {
           title: args.title,
           status: args.status ?? "backlog",
@@ -17765,11 +17820,11 @@ function createTaskTools(store) {
         complexity: external_exports.enum(["trivial", "simple", "moderate", "complex", "very-complex"]).optional().describe("New complexity"),
         priority: external_exports.enum(["critical", "high", "medium", "low"]).optional().describe("New priority"),
         tags: external_exports.array(external_exports.string()).optional().describe("Replace tags (e.g. remove old tags, add new ones)"),
-        workStream: external_exports.string().optional().describe("Work stream name (e.g. 'Budget UX'). Replaces existing stream:<value> tag."),
+        workFocus: external_exports.string().optional().describe("Work focus name (e.g. 'Budget UX'). Replaces existing focus:<value> tag."),
         progress: external_exports.number().optional().describe("Explicit progress percentage (0-100). Overrides auto-calculation from child contributions.")
       },
       async (args) => {
-        const { id, content, linkedEpic: rawLinkedEpic, tags: userTags, workStream, progress, ...updates } = args;
+        const { id, content, linkedEpic: rawLinkedEpic, tags: userTags, workFocus, progress, ...updates } = args;
         const warnings = [];
         if (rawLinkedEpic !== void 0) {
           const linkedEpics = normalizeLinkedEpics(rawLinkedEpic);
@@ -17790,14 +17845,15 @@ function createTaskTools(store) {
         } else if (userTags !== void 0) {
           updates.tags = userTags;
         }
-        if (workStream !== void 0) {
+        if (workFocus !== void 0) {
           const currentTags = updates.tags ?? store.get(id)?.frontmatter.tags ?? [];
-          const filtered = currentTags.filter((t) => !t.startsWith("stream:"));
-          filtered.push(`stream:${workStream}`);
+          const filtered = currentTags.filter((t) => !t.startsWith("focus:"));
+          filtered.push(`focus:${workFocus}`);
           updates.tags = filtered;
         }
         if (typeof progress === "number") {
           updates.progress = Math.max(0, Math.min(100, Math.round(progress)));
+          updates.progressOverride = true;
         }
         const doc = store.update(id, updates, content);
         if (args.status !== void 0 || typeof progress === "number") {
@@ -20019,7 +20075,7 @@ ${fragment}`);
 }
 
 // src/skills/action-tools.ts
-import { tool as tool23 } from "@anthropic-ai/claude-agent-sdk";
+import { tool as tool24 } from "@anthropic-ai/claude-agent-sdk";
 
 // src/skills/action-runner.ts
 import { query as query2 } from "@anthropic-ai/claude-agent-sdk";
@@ -20074,7 +20130,7 @@ function formatDate(iso) {
   if (!iso) return "";
   return iso.slice(0, 10);
 }
-function typeLabel(type) {
+function typeLabel2(type) {
   return type.replace(/-/g, " ").replace(/\b\w/g, (c) => c.toUpperCase());
 }
 function renderMarkdown(md) {
@@ -21829,12 +21885,45 @@ tr:hover td {
   font-weight: 700;
   color: var(--text);
 }
+
+/* Focus-grouped work items */
+.focus-row td:first-child {
+  border-left: 3px solid var(--focus-color, var(--border));
+}
+
+.focus-group-header td {
+  background: var(--bg-hover);
+  border-left: 3px solid var(--focus-color, var(--border));
+  padding-top: 0.5rem;
+  padding-bottom: 0.5rem;
+  border-bottom: 1px solid var(--border);
+}
+
+.focus-group-header td:first-child {
+  border-left-width: 3px;
+}
+
+.focus-group-name {
+  font-weight: 600;
+  font-size: 0.8rem;
+  color: var(--text);
+  margin-right: 0.75rem;
+}
+
+.focus-group-stats {
+  font-size: 0.75rem;
+  color: var(--text-dim);
+}
+
+.focus-group-progress {
+  width: 96px;
+}
 `;
 }
 
 // src/web/templates/pages/documents.ts
 function documentsPage(data) {
-  const label = typeLabel(data.type);
+  const label = typeLabel2(data.type);
   const statusOptions = data.statuses.map(
     (s) => `<option value="${escapeHtml(s)}"${data.filterStatus === s ? " selected" : ""}>${escapeHtml(s)}</option>`
   ).join("");
@@ -21908,7 +21997,7 @@ function documentsPage(data) {
 // src/web/templates/pages/document-detail.ts
 function documentDetailPage(doc) {
   const fm = doc.frontmatter;
-  const label = typeLabel(fm.type);
+  const label = typeLabel2(fm.type);
   const skipKeys = /* @__PURE__ */ new Set(["title", "type"]);
   const entries = Object.entries(fm).filter(
     ([key]) => !skipKeys.has(key) && fm[key] != null
@@ -22607,7 +22696,7 @@ function poDashboardPage(ctx) {
               <tr>
                 <td><a href="/docs/${d.frontmatter.type}/${escapeHtml(d.frontmatter.id)}">${escapeHtml(d.frontmatter.id)}</a></td>
                 <td>${escapeHtml(d.frontmatter.title)}</td>
-                <td>${escapeHtml(typeLabel(d.frontmatter.type))}</td>
+                <td>${escapeHtml(typeLabel2(d.frontmatter.type))}</td>
                 <td>${statusBadge(d.frontmatter.status)}</td>
                 <td>${formatDate(d.frontmatter.updated ?? d.frontmatter.created)}</td>
               </tr>`).join("")}
@@ -23115,7 +23204,7 @@ function poDeliveryPage(ctx) {
               <tr>
                 <td><a href="/docs/${escapeHtml(d.frontmatter.type)}/${escapeHtml(d.frontmatter.id)}">${escapeHtml(d.frontmatter.id)}</a></td>
                 <td>${escapeHtml(d.frontmatter.title)}</td>
-                <td>${escapeHtml(typeLabel(d.frontmatter.type))}</td>
+                <td>${escapeHtml(typeLabel2(d.frontmatter.type))}</td>
                 <td>${statusBadge(d.frontmatter.status)}</td>
                 <td>${formatDate(d.frontmatter.updated ?? d.frontmatter.created)}</td>
               </tr>`).join("")}
@@ -23433,15 +23522,15 @@ function sprintSummaryPage(data, cached2) {
         </div>`,
     { titleTag: "h3" }
   ) : "";
-  const STREAM_PALETTE = [
-    "hsla(220, 30%, 22%, 0.45)",
-    "hsla(160, 30%, 20%, 0.45)",
-    "hsla(280, 25%, 22%, 0.45)",
-    "hsla(30, 35%, 22%, 0.45)",
-    "hsla(340, 25%, 22%, 0.45)",
-    "hsla(190, 30%, 20%, 0.45)",
-    "hsla(60, 25%, 20%, 0.45)",
-    "hsla(120, 20%, 20%, 0.45)"
+  const FOCUS_BORDER_PALETTE = [
+    "hsl(220, 60%, 55%)",
+    "hsl(160, 50%, 45%)",
+    "hsl(280, 45%, 55%)",
+    "hsl(30, 65%, 55%)",
+    "hsl(340, 50%, 55%)",
+    "hsl(190, 50%, 45%)",
+    "hsl(60, 50%, 50%)",
+    "hsl(120, 40%, 45%)"
   ];
   function hashString(s) {
     let h = 0;
@@ -23450,68 +23539,92 @@ function sprintSummaryPage(data, cached2) {
     }
     return Math.abs(h);
   }
-  function collectStreams(items) {
-    const streams = /* @__PURE__ */ new Set();
-    for (const w of items) {
-      if (w.workStream) streams.add(w.workStream);
-      if (w.children) {
-        for (const s of collectStreams(w.children)) streams.add(s);
+  const focusGroups = /* @__PURE__ */ new Map();
+  for (const item of data.workItems.items) {
+    const focus = item.workFocus ?? "Unassigned";
+    if (!focusGroups.has(focus)) focusGroups.set(focus, []);
+    focusGroups.get(focus).push(item);
+  }
+  const focusColorMap = /* @__PURE__ */ new Map();
+  for (const name of focusGroups.keys()) {
+    focusColorMap.set(name, FOCUS_BORDER_PALETTE[hashString(name) % FOCUS_BORDER_PALETTE.length]);
+  }
+  function countFocusStats(items) {
+    let total = 0;
+    let done = 0;
+    let inProgress = 0;
+    function walk(list) {
+      for (const w of list) {
+        if (w.type !== "contribution") {
+          total++;
+          const s = w.status.toLowerCase();
+          if (s === "done" || s === "closed" || s === "resolved" || s === "decided") done++;
+          else if (s === "in-progress" || s === "in progress") inProgress++;
+        }
+        if (w.children) walk(w.children);
       }
     }
-    return streams;
+    walk(items);
+    return { total, done, inProgress };
   }
-  const uniqueStreams = collectStreams(data.workItems.items);
-  const streamColorMap = /* @__PURE__ */ new Map();
-  for (const name of uniqueStreams) {
-    streamColorMap.set(name, STREAM_PALETTE[hashString(name) % STREAM_PALETTE.length]);
-  }
-  const streamStyleRules = [...streamColorMap.entries()].map(([name, color]) => `tr[data-stream="${escapeHtml(name)}"] td { background: ${color}; }`).join("\n");
-  const streamStyleBlock = streamStyleRules ? `<style>${streamStyleRules}</style>` : "";
-  function renderItemRows(items, depth = 0) {
+  function renderItemRows(items, borderColor, depth = 0) {
     return items.flatMap((w) => {
       const isChild = depth > 0;
       const isContribution = w.type === "contribution";
-      const classes = [];
+      const classes = ["focus-row"];
       if (isContribution) classes.push("contribution-row");
       else if (isChild) classes.push("child-row");
-      const dataStream = w.workStream ? ` data-stream="${escapeHtml(w.workStream)}"` : "";
-      const rowAttrs = classes.length > 0 ? ` class="${classes.join(" ")}"` : "";
       const indent = depth > 0 ? ` style="padding-left: ${0.75 + depth * 1}rem"` : "";
-      const streamCell = w.workStream ? `<span class="badge badge-subtle">${escapeHtml(w.workStream)}</span>` : "";
       const progressCell = !isContribution && w.progress !== void 0 ? `<div class="mini-progress-bar"><div class="mini-progress-fill" style="width:${w.progress}%"></div><span class="mini-progress-label">${w.progress}%</span></div>` : "";
       const row = `
-              <tr${rowAttrs}${dataStream}>
+              <tr class="${classes.join(" ")}" style="--focus-color: ${borderColor}">
                 <td${indent}><a href="/docs/${escapeHtml(w.type)}/${escapeHtml(w.id)}">${escapeHtml(w.id)}</a></td>
                 <td>${escapeHtml(w.title)}</td>
-                <td>${streamCell}</td>
-                <td>${escapeHtml(typeLabel(w.type))}</td>
                 <td>${statusBadge(w.status)}</td>
                 <td>${progressCell}</td>
               </tr>`;
-      const childRows = w.children ? renderItemRows(w.children, depth + 1) : [];
+      const childRows = w.children ? renderItemRows(w.children, borderColor, depth + 1) : [];
       return [row, ...childRows];
     });
   }
-  const workItemRows = renderItemRows(data.workItems.items);
-  const sortableHeaders = `<tr>
-                <th class="sortable-th" onclick="sortWorkItems(0)">ID<span class="sort-arrow" id="sort-arrow-0"></span></th>
-                <th class="sortable-th" onclick="sortWorkItems(1)">Title<span class="sort-arrow" id="sort-arrow-1"></span></th>
-                <th class="sortable-th" onclick="sortWorkItems(2)">Stream<span class="sort-arrow" id="sort-arrow-2"></span></th>
-                <th class="sortable-th" onclick="sortWorkItems(3)">Type<span class="sort-arrow" id="sort-arrow-3"></span></th>
-                <th class="sortable-th" onclick="sortWorkItems(4)">Status<span class="sort-arrow" id="sort-arrow-4"></span></th>
-                <th class="sortable-th" onclick="sortWorkItems(5)">Progress<span class="sort-arrow" id="sort-arrow-5"></span></th>
+  const allWorkItemRows = [];
+  for (const [focus, items] of focusGroups) {
+    const color = focusColorMap.get(focus);
+    const stats = countFocusStats(items);
+    const pct = stats.total > 0 ? Math.round(stats.done / stats.total * 100) : 0;
+    const summaryParts = [];
+    if (stats.done > 0) summaryParts.push(`${stats.done} done`);
+    if (stats.inProgress > 0) summaryParts.push(`${stats.inProgress} in progress`);
+    const remaining = stats.total - stats.done - stats.inProgress;
+    if (remaining > 0) summaryParts.push(`${remaining} open`);
+    allWorkItemRows.push(`
+              <tr class="focus-group-header" style="--focus-color: ${color}">
+                <td colspan="2">
+                  <span class="focus-group-name">${escapeHtml(focus)}</span>
+                  <span class="focus-group-stats">${summaryParts.join(" / ")}</span>
+                </td>
+                <td colspan="2">
+                  <div class="mini-progress-bar focus-group-progress"><div class="mini-progress-fill" style="width:${pct}%"></div><span class="mini-progress-label">${pct}%</span></div>
+                </td>
+              </tr>`);
+    allWorkItemRows.push(...renderItemRows(items, color));
+  }
+  const tableHeaders = `<tr>
+                <th>ID</th>
+                <th>Title</th>
+                <th>Status</th>
+                <th>Progress</th>
               </tr>`;
-  const workItemsSection = workItemRows.length > 0 ? collapsibleSection(
+  const workItemsSection = allWorkItemRows.length > 0 ? collapsibleSection(
     "ss-work-items",
     "Work Items",
-    `${streamStyleBlock}
-        <div class="table-wrap">
+    `<div class="table-wrap">
           <table id="work-items-table">
             <thead>
-              ${sortableHeaders}
+              ${tableHeaders}
             </thead>
             <tbody>
-              ${workItemRows.join("")}
+              ${allWorkItemRows.join("")}
             </tbody>
           </table>
         </div>`,
@@ -23587,61 +23700,6 @@ function sprintSummaryPage(data, cached2) {
     </div>
 
     <script>
-      var _sortCol = -1;
-      var _sortAsc = true;
-
-      function sortWorkItems(col) {
-        var table = document.getElementById('work-items-table');
-        if (!table) return;
-        var tbody = table.querySelector('tbody');
-        var allRows = Array.from(tbody.querySelectorAll('tr'));
-
-        // Toggle direction if clicking the same column
-        if (_sortCol === col) {
-          _sortAsc = !_sortAsc;
-        } else {
-          _sortCol = col;
-          _sortAsc = true;
-        }
-
-        // Update sort arrows
-        for (var i = 0; i < 6; i++) {
-          var arrow = document.getElementById('sort-arrow-' + i);
-          if (arrow) arrow.textContent = i === col ? (_sortAsc ? ' \\u25B2' : ' \\u25BC') : '';
-        }
-
-        // Group rows: root rows + their child/contribution rows
-        var groups = [];
-        var current = null;
-        for (var r = 0; r < allRows.length; r++) {
-          var row = allRows[r];
-          var isChild = row.classList.contains('child-row') || row.classList.contains('contribution-row');
-          if (!isChild) {
-            current = { root: row, children: [] };
-            groups.push(current);
-          } else if (current) {
-            current.children.push(row);
-          }
-        }
-
-        // Sort groups by root row text content of target column
-        groups.sort(function(a, b) {
-          var aText = (a.root.children[col] ? a.root.children[col].textContent : '').trim().toLowerCase();
-          var bText = (b.root.children[col] ? b.root.children[col].textContent : '').trim().toLowerCase();
-          if (aText < bText) return _sortAsc ? -1 : 1;
-          if (aText > bText) return _sortAsc ? 1 : -1;
-          return 0;
-        });
-
-        // Re-append rows in sorted order
-        for (var g = 0; g < groups.length; g++) {
-          tbody.appendChild(groups[g].root);
-          for (var c = 0; c < groups[g].children.length; c++) {
-            tbody.appendChild(groups[g].children[c]);
-          }
-        }
-      }
-
       async function generateSummary() {
         var btn = document.getElementById('generate-btn');
         var loading = document.getElementById('summary-loading');
@@ -23843,7 +23901,7 @@ function dmRisksPage(ctx) {
               <tr>
                 <td><a href="/docs/${escapeHtml(d.frontmatter.type)}/${escapeHtml(d.frontmatter.id)}">${escapeHtml(d.frontmatter.id)}</a></td>
                 <td>${escapeHtml(d.frontmatter.title)}</td>
-                <td>${escapeHtml(typeLabel(d.frontmatter.type))}</td>
+                <td>${escapeHtml(typeLabel2(d.frontmatter.type))}</td>
                 <td>${d.frontmatter.owner ? escapeHtml(d.frontmatter.owner) : '<span class="text-dim">\u2014</span>'}</td>
                 <td>${formatDate(d.frontmatter.created)}</td>
               </tr>`).join("")}
@@ -23867,7 +23925,7 @@ function dmRisksPage(ctx) {
               <tr>
                 <td><a href="/docs/${escapeHtml(d.frontmatter.type)}/${escapeHtml(d.frontmatter.id)}">${escapeHtml(d.frontmatter.id)}</a></td>
                 <td>${escapeHtml(d.frontmatter.title)}</td>
-                <td>${escapeHtml(typeLabel(d.frontmatter.type))}</td>
+                <td>${escapeHtml(typeLabel2(d.frontmatter.type))}</td>
                 <td>${statusBadge(d.frontmatter.status)}</td>
                 <td>${formatDate(d.frontmatter.created)}</td>
                 <td><span class="${ageDays > 30 ? "priority-high" : "priority-medium"}">${ageDays}d</span></td>
@@ -24378,7 +24436,23 @@ function tlSprintPage(ctx) {
       </div>`;
   }
   const techTypes = /* @__PURE__ */ new Set(["epic", "task"]);
-  const techItems = data.workItems.items.filter((w) => techTypes.has(w.type));
+  const techItems = [];
+  for (const item of data.workItems.items) {
+    if (techTypes.has(item.type)) {
+      techItems.push(item);
+    } else if (item.children) {
+      const promoteChildren = (children) => {
+        for (const child of children) {
+          if (techTypes.has(child.type)) {
+            techItems.push(child);
+          } else if (child.children) {
+            promoteChildren(child.children);
+          }
+        }
+      };
+      promoteChildren(item.children);
+    }
+  }
   const techDone = techItems.filter((w) => DONE_STATUSES11.has(w.status)).length;
   const allDocs = ctx.store.list();
   const tlContributions = allDocs.filter((d) => TL_CONTRIBUTION_TYPES.has(d.frontmatter.type));
@@ -24416,16 +24490,16 @@ function tlSprintPage(ctx) {
     `<div class="table-wrap">
           <table>
             <thead>
-              <tr><th>ID</th><th>Title</th><th>Type</th><th>Status</th><th>Stream</th></tr>
+              <tr><th>ID</th><th>Title</th><th>Type</th><th>Status</th><th>Focus</th></tr>
             </thead>
             <tbody>
               ${techItems.map((w) => `
               <tr>
                 <td><a href="/docs/${escapeHtml(w.type)}/${escapeHtml(w.id)}">${escapeHtml(w.id)}</a></td>
                 <td>${escapeHtml(w.title)}</td>
-                <td>${escapeHtml(typeLabel(w.type))}</td>
+                <td>${escapeHtml(typeLabel2(w.type))}</td>
                 <td>${statusBadge(w.status)}</td>
-                <td>${w.workStream ? `<span class="badge badge-subtle">${escapeHtml(w.workStream)}</span>` : '<span class="text-dim">\u2014</span>'}</td>
+                <td>${w.workFocus ? `<span class="badge badge-subtle">${escapeHtml(w.workFocus)}</span>` : '<span class="text-dim">\u2014</span>'}</td>
               </tr>`).join("")}
             </tbody>
           </table>
@@ -24445,7 +24519,7 @@ function tlSprintPage(ctx) {
               <tr>
                 <td><a href="/docs/${escapeHtml(d.frontmatter.type)}/${escapeHtml(d.frontmatter.id)}">${escapeHtml(d.frontmatter.id)}</a></td>
                 <td>${escapeHtml(d.frontmatter.title)}</td>
-                <td>${escapeHtml(typeLabel(d.frontmatter.type))}</td>
+                <td>${escapeHtml(typeLabel2(d.frontmatter.type))}</td>
                 <td>${statusBadge(d.frontmatter.status)}</td>
                 <td>${formatDate(d.frontmatter.updated ?? d.frontmatter.created)}</td>
               </tr>`).join("")}
@@ -24634,7 +24708,7 @@ function timelinePage(diagrams) {
 // src/web/templates/pages/board.ts
 function boardPage(data, basePath = "/board") {
   const typeOptions = data.types.map(
-    (t) => `<option value="${escapeHtml(t)}"${data.type === t ? " selected" : ""}>${escapeHtml(typeLabel(t))}s</option>`
+    (t) => `<option value="${escapeHtml(t)}"${data.type === t ? " selected" : ""}>${escapeHtml(typeLabel2(t))}s</option>`
   ).join("");
   const columns = data.columns.map(
     (col) => `
@@ -24791,7 +24865,7 @@ function upcomingPage(data) {
             <td><span class="trending-rank">${i + 1}</span></td>
             <td><a href="/docs/${escapeHtml(t.type)}/${escapeHtml(t.id)}">${escapeHtml(t.id)}</a></td>
             <td>${escapeHtml(t.title)}</td>
-            <td>${escapeHtml(typeLabel(t.type))}</td>
+            <td>${escapeHtml(typeLabel2(t.type))}</td>
             <td>${statusBadge(t.status)}</td>
             <td><span class="trending-score">${t.score}</span></td>
             <td>${t.signals.map((s) => `<span class="signal-tag">${escapeHtml(s.factor)} +${s.points}</span>`).join(" ")}</td>
@@ -24885,7 +24959,7 @@ function buildPersonaLayoutOpts(persona, activePath, navGroups) {
   const artifactGroupsHtml = navGroups.map((group) => {
     const links = group.types.map((type) => {
       const href = `/docs/${type}?persona=${persona}`;
-      return `<a href="${href}" class="${isActive(`/docs/${type}`)}">${typeLabel(type)}s</a>`;
+      return `<a href="${href}" class="${isActive(`/docs/${type}`)}">${typeLabel2(type)}s</a>`;
     }).join("\n            ");
     const groupActive = group.types.some(
       (type) => isActive(`/docs/${type}`) !== ""
@@ -25311,6 +25385,556 @@ function createWebTools(store, projectName, navGroups) {
   ];
 }
 
+// src/agent/tools/doctor.ts
+import { tool as tool23 } from "@anthropic-ai/claude-agent-sdk";
+
+// src/doctor/rules/tag-migration.ts
+var RULE_ID = "tag-migration";
+var RULE_NAME = "Tag Migration";
+var tagMigrationRule = {
+  id: RULE_ID,
+  name: RULE_NAME,
+  description: "Detects deprecated stream:* tags and replaces them with focus:*",
+  scan(ctx) {
+    const issues = [];
+    for (const doc of ctx.allDocuments) {
+      const tags = doc.frontmatter.tags;
+      if (!Array.isArray(tags)) continue;
+      const streamTags = tags.filter((t) => t.startsWith("stream:"));
+      for (const tag of streamTags) {
+        issues.push({
+          ruleId: RULE_ID,
+          ruleName: RULE_NAME,
+          documentId: doc.frontmatter.id,
+          filePath: doc.filePath,
+          documentType: doc.frontmatter.type,
+          message: `Deprecated tag "${tag}" should be "${tag.replace("stream:", "focus:")}"`,
+          severity: "warning",
+          fixable: true
+        });
+      }
+    }
+    return issues;
+  },
+  fix(ctx) {
+    const fixes = [];
+    for (const doc of ctx.allDocuments) {
+      const tags = doc.frontmatter.tags;
+      if (!Array.isArray(tags)) continue;
+      const streamTags = tags.filter((t) => t.startsWith("stream:"));
+      if (streamTags.length === 0) continue;
+      const newTags = tags.map(
+        (t) => t.startsWith("stream:") ? t.replace("stream:", "focus:") : t
+      );
+      ctx.store.update(doc.frontmatter.id, { tags: newTags });
+      for (const tag of streamTags) {
+        fixes.push({
+          issue: {
+            ruleId: RULE_ID,
+            ruleName: RULE_NAME,
+            documentId: doc.frontmatter.id,
+            filePath: doc.filePath,
+            documentType: doc.frontmatter.type,
+            message: `Deprecated tag "${tag}" should be "${tag.replace("stream:", "focus:")}"`,
+            severity: "warning",
+            fixable: true
+          },
+          fixDescription: `Renamed "${tag}" to "${tag.replace("stream:", "focus:")}"`
+        });
+      }
+    }
+    return fixes;
+  }
+};
+
+// src/doctor/rules/array-normalization.ts
+var RULE_ID2 = "array-normalization";
+var RULE_NAME2 = "Array Normalization";
+var FIELDS = [
+  {
+    field: "linkedEpic",
+    aliases: ["linkedEpics"],
+    normalize: normalizeLinkedEpics
+  },
+  {
+    field: "linkedFeature",
+    aliases: ["linkedFeatures"],
+    normalize: normalizeLinkedFeatures
+  }
+];
+var arrayNormalizationRule = {
+  id: RULE_ID2,
+  name: RULE_NAME2,
+  description: "Normalizes linkedEpic/linkedFeature from strings to arrays and resolves field aliases",
+  scan(ctx) {
+    const issues = [];
+    for (const doc of ctx.allDocuments) {
+      const fm = doc.frontmatter;
+      for (const cfg of FIELDS) {
+        for (const alias of cfg.aliases) {
+          if (fm[alias] !== void 0) {
+            issues.push({
+              ruleId: RULE_ID2,
+              ruleName: RULE_NAME2,
+              documentId: doc.frontmatter.id,
+              filePath: doc.filePath,
+              documentType: doc.frontmatter.type,
+              message: `Field "${alias}" should be renamed to "${cfg.field}"`,
+              severity: "warning",
+              fixable: true
+            });
+          }
+        }
+        const value = fm[cfg.field];
+        if (typeof value === "string") {
+          issues.push({
+            ruleId: RULE_ID2,
+            ruleName: RULE_NAME2,
+            documentId: doc.frontmatter.id,
+            filePath: doc.filePath,
+            documentType: doc.frontmatter.type,
+            message: `Field "${cfg.field}" is a string ("${value}") but should be an array`,
+            severity: "warning",
+            fixable: true
+          });
+        }
+      }
+    }
+    return issues;
+  },
+  fix(ctx) {
+    const fixes = [];
+    for (const doc of ctx.allDocuments) {
+      const fm = doc.frontmatter;
+      const updates = {};
+      let needsUpdate = false;
+      for (const cfg of FIELDS) {
+        for (const alias of cfg.aliases) {
+          if (fm[alias] !== void 0) {
+            const aliasValues = cfg.normalize(fm[alias]);
+            const existing = cfg.normalize(fm[cfg.field]);
+            const merged = [.../* @__PURE__ */ new Set([...existing, ...aliasValues])];
+            updates[cfg.field] = merged;
+            updates[alias] = void 0;
+            needsUpdate = true;
+            fixes.push({
+              issue: {
+                ruleId: RULE_ID2,
+                ruleName: RULE_NAME2,
+                documentId: doc.frontmatter.id,
+                filePath: doc.filePath,
+                documentType: doc.frontmatter.type,
+                message: `Field "${alias}" should be renamed to "${cfg.field}"`,
+                severity: "warning",
+                fixable: true
+              },
+              fixDescription: `Merged "${alias}" into "${cfg.field}" and removed alias`
+            });
+          }
+        }
+        const value = updates[cfg.field] ?? fm[cfg.field];
+        if (typeof value === "string") {
+          updates[cfg.field] = cfg.normalize(value);
+          needsUpdate = true;
+          fixes.push({
+            issue: {
+              ruleId: RULE_ID2,
+              ruleName: RULE_NAME2,
+              documentId: doc.frontmatter.id,
+              filePath: doc.filePath,
+              documentType: doc.frontmatter.type,
+              message: `Field "${cfg.field}" is a string ("${value}") but should be an array`,
+              severity: "warning",
+              fixable: true
+            },
+            fixDescription: `Normalized "${cfg.field}" from string to array`
+          });
+        }
+      }
+      if (needsUpdate) {
+        ctx.store.update(doc.frontmatter.id, updates);
+      }
+    }
+    return fixes;
+  }
+};
+
+// src/doctor/rules/missing-auto-tags.ts
+var RULE_ID3 = "missing-auto-tags";
+var RULE_NAME3 = "Missing Auto Tags";
+var missingAutoTagsRule = {
+  id: RULE_ID3,
+  name: RULE_NAME3,
+  description: "Ensures tasks have epic:E-xxx tags for their linkedEpic and epics have feature:F-xxx tags",
+  scan(ctx) {
+    const issues = [];
+    for (const doc of ctx.allDocuments) {
+      const fm = doc.frontmatter;
+      const tags = doc.frontmatter.tags ?? [];
+      const linkedEpics = normalizeLinkedEpics(fm.linkedEpic);
+      if (linkedEpics.length > 0) {
+        const expected = generateEpicTags(linkedEpics);
+        const missing = expected.filter((t) => !tags.includes(t));
+        for (const tag of missing) {
+          issues.push({
+            ruleId: RULE_ID3,
+            ruleName: RULE_NAME3,
+            documentId: doc.frontmatter.id,
+            filePath: doc.filePath,
+            documentType: doc.frontmatter.type,
+            message: `Missing auto-tag "${tag}" for linkedEpic`,
+            severity: "warning",
+            fixable: true
+          });
+        }
+      }
+      const linkedFeatures = normalizeLinkedFeatures(fm.linkedFeature);
+      if (linkedFeatures.length > 0) {
+        const expected = generateFeatureTags(linkedFeatures);
+        const missing = expected.filter((t) => !tags.includes(t));
+        for (const tag of missing) {
+          issues.push({
+            ruleId: RULE_ID3,
+            ruleName: RULE_NAME3,
+            documentId: doc.frontmatter.id,
+            filePath: doc.filePath,
+            documentType: doc.frontmatter.type,
+            message: `Missing auto-tag "${tag}" for linkedFeature`,
+            severity: "warning",
+            fixable: true
+          });
+        }
+      }
+    }
+    return issues;
+  },
+  fix(ctx) {
+    const fixes = [];
+    for (const doc of ctx.allDocuments) {
+      const fm = doc.frontmatter;
+      const tags = [...doc.frontmatter.tags ?? []];
+      let changed = false;
+      const linkedEpics = normalizeLinkedEpics(fm.linkedEpic);
+      if (linkedEpics.length > 0) {
+        const expected = generateEpicTags(linkedEpics);
+        for (const tag of expected) {
+          if (!tags.includes(tag)) {
+            tags.push(tag);
+            changed = true;
+            fixes.push({
+              issue: {
+                ruleId: RULE_ID3,
+                ruleName: RULE_NAME3,
+                documentId: doc.frontmatter.id,
+                filePath: doc.filePath,
+                documentType: doc.frontmatter.type,
+                message: `Missing auto-tag "${tag}" for linkedEpic`,
+                severity: "warning",
+                fixable: true
+              },
+              fixDescription: `Added tag "${tag}"`
+            });
+          }
+        }
+      }
+      const linkedFeatures = normalizeLinkedFeatures(fm.linkedFeature);
+      if (linkedFeatures.length > 0) {
+        const expected = generateFeatureTags(linkedFeatures);
+        for (const tag of expected) {
+          if (!tags.includes(tag)) {
+            tags.push(tag);
+            changed = true;
+            fixes.push({
+              issue: {
+                ruleId: RULE_ID3,
+                ruleName: RULE_NAME3,
+                documentId: doc.frontmatter.id,
+                filePath: doc.filePath,
+                documentType: doc.frontmatter.type,
+                message: `Missing auto-tag "${tag}" for linkedFeature`,
+                severity: "warning",
+                fixable: true
+              },
+              fixDescription: `Added tag "${tag}"`
+            });
+          }
+        }
+      }
+      if (changed) {
+        ctx.store.update(doc.frontmatter.id, { tags });
+      }
+    }
+    return fixes;
+  }
+};
+
+// src/doctor/rules/progress-consistency.ts
+var RULE_ID4 = "progress-consistency";
+var RULE_NAME4 = "Progress Consistency";
+var progressConsistencyRule = {
+  id: RULE_ID4,
+  name: RULE_NAME4,
+  description: "Detects done-status documents with progress != 100 and progressOverride:true without a progress value",
+  scan(ctx) {
+    const issues = [];
+    for (const doc of ctx.allDocuments) {
+      const fm = doc.frontmatter;
+      const status = doc.frontmatter.status;
+      const progress = fm.progress;
+      const progressOverride = fm.progressOverride;
+      if (status === "done" && progress !== void 0 && progress !== 100) {
+        issues.push({
+          ruleId: RULE_ID4,
+          ruleName: RULE_NAME4,
+          documentId: doc.frontmatter.id,
+          filePath: doc.filePath,
+          documentType: doc.frontmatter.type,
+          message: `Status is "done" but progress is ${progress} (expected 100)`,
+          severity: "error",
+          fixable: true
+        });
+      }
+      if (progressOverride === true && progress === void 0) {
+        issues.push({
+          ruleId: RULE_ID4,
+          ruleName: RULE_NAME4,
+          documentId: doc.frontmatter.id,
+          filePath: doc.filePath,
+          documentType: doc.frontmatter.type,
+          message: `progressOverride is true but no progress value is set`,
+          severity: "warning",
+          fixable: true
+        });
+      }
+    }
+    return issues;
+  },
+  fix(ctx) {
+    const fixes = [];
+    for (const doc of ctx.allDocuments) {
+      const fm = doc.frontmatter;
+      const status = doc.frontmatter.status;
+      const progress = fm.progress;
+      const progressOverride = fm.progressOverride;
+      if (status === "done" && progress !== void 0 && progress !== 100) {
+        ctx.store.update(doc.frontmatter.id, { progress: 100 });
+        fixes.push({
+          issue: {
+            ruleId: RULE_ID4,
+            ruleName: RULE_NAME4,
+            documentId: doc.frontmatter.id,
+            filePath: doc.filePath,
+            documentType: doc.frontmatter.type,
+            message: `Status is "done" but progress is ${progress} (expected 100)`,
+            severity: "error",
+            fixable: true
+          },
+          fixDescription: `Set progress to 100`
+        });
+      }
+      if (progressOverride === true && progress === void 0) {
+        ctx.store.update(doc.frontmatter.id, { progressOverride: false });
+        fixes.push({
+          issue: {
+            ruleId: RULE_ID4,
+            ruleName: RULE_NAME4,
+            documentId: doc.frontmatter.id,
+            filePath: doc.filePath,
+            documentType: doc.frontmatter.type,
+            message: `progressOverride is true but no progress value is set`,
+            severity: "warning",
+            fixable: true
+          },
+          fixDescription: `Set progressOverride to false`
+        });
+      }
+    }
+    return fixes;
+  }
+};
+
+// src/doctor/rules/orphaned-references.ts
+var RULE_ID5 = "orphaned-references";
+var RULE_NAME5 = "Orphaned References";
+var REFERENCE_FIELDS = ["aboutArtifact", "linkedEpic", "linkedFeature"];
+var orphanedReferencesRule = {
+  id: RULE_ID5,
+  name: RULE_NAME5,
+  description: "Detects references (aboutArtifact, linkedEpic, linkedFeature) pointing to non-existent documents",
+  scan(ctx) {
+    const issues = [];
+    for (const doc of ctx.allDocuments) {
+      const fm = doc.frontmatter;
+      for (const field of REFERENCE_FIELDS) {
+        const value = fm[field];
+        if (value === void 0 || value === null) continue;
+        const refs = Array.isArray(value) ? value.filter((v) => typeof v === "string") : typeof value === "string" ? [value] : [];
+        for (const ref of refs) {
+          if (!ctx.documentIndex.has(ref)) {
+            issues.push({
+              ruleId: RULE_ID5,
+              ruleName: RULE_NAME5,
+              documentId: doc.frontmatter.id,
+              filePath: doc.filePath,
+              documentType: doc.frontmatter.type,
+              message: `Field "${field}" references "${ref}" which does not exist`,
+              severity: "warning",
+              fixable: false
+            });
+          }
+        }
+      }
+    }
+    return issues;
+  },
+  fix() {
+    return [];
+  }
+};
+
+// src/doctor/rules/owner-role.ts
+var RULE_ID6 = "owner-role";
+var RULE_NAME6 = "Owner Role";
+var ownerRoleRule = {
+  id: RULE_ID6,
+  name: RULE_NAME6,
+  description: `Detects owner values that are not valid persona roles (${OWNER_SHORT.join(", ")})`,
+  scan(ctx) {
+    const issues = [];
+    for (const doc of ctx.allDocuments) {
+      const owner = doc.frontmatter.owner;
+      if (owner === void 0 || owner === null || owner === "") continue;
+      if (!isValidOwner(owner)) {
+        issues.push({
+          ruleId: RULE_ID6,
+          ruleName: RULE_NAME6,
+          documentId: doc.frontmatter.id,
+          filePath: doc.filePath,
+          documentType: doc.frontmatter.type,
+          message: `Owner "${owner}" is not a valid persona role. Expected one of: ${OWNER_SHORT.join(", ")}`,
+          severity: "warning",
+          fixable: false
+        });
+      }
+    }
+    return issues;
+  },
+  fix() {
+    return [];
+  }
+};
+
+// src/doctor/rules/index.ts
+var allRules = [
+  tagMigrationRule,
+  arrayNormalizationRule,
+  missingAutoTagsRule,
+  progressConsistencyRule,
+  orphanedReferencesRule,
+  ownerRoleRule
+];
+
+// src/doctor/engine.ts
+function buildDoctorContext(store) {
+  const allDocuments = store.list();
+  const documentIndex = new Map(
+    allDocuments.map((doc) => [doc.frontmatter.id, doc])
+  );
+  return { store, allDocuments, documentIndex };
+}
+function runDoctorScan(store, ruleFilter) {
+  const rules = resolveRules(ruleFilter);
+  const ctx = buildDoctorContext(store);
+  const issues = rules.flatMap((rule) => rule.scan(ctx));
+  return buildReport(ctx, issues, []);
+}
+function runDoctorFix(store, ruleFilter) {
+  const rules = resolveRules(ruleFilter);
+  let ctx = buildDoctorContext(store);
+  const allIssues = rules.flatMap((rule) => rule.scan(ctx));
+  const allFixes = [];
+  for (const rule of rules) {
+    const fixes = rule.fix(ctx);
+    allFixes.push(...fixes);
+    if (fixes.length > 0) {
+      ctx = buildDoctorContext(store);
+    }
+  }
+  return buildReport(ctx, allIssues, allFixes);
+}
+function resolveRules(ruleFilter) {
+  if (!ruleFilter) return allRules;
+  const rule = allRules.find((r) => r.id === ruleFilter);
+  if (!rule) {
+    throw new Error(
+      `Unknown rule: ${ruleFilter}. Available: ${allRules.map((r) => r.id).join(", ")}`
+    );
+  }
+  return [rule];
+}
+function buildReport(ctx, issues, fixes) {
+  const byRule = {};
+  const bySeverity = { error: 0, warning: 0, info: 0 };
+  let fixableIssues = 0;
+  for (const issue2 of issues) {
+    byRule[issue2.ruleId] = (byRule[issue2.ruleId] ?? 0) + 1;
+    bySeverity[issue2.severity] = (bySeverity[issue2.severity] ?? 0) + 1;
+    if (issue2.fixable) fixableIssues++;
+  }
+  return {
+    scannedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    totalDocuments: ctx.allDocuments.length,
+    issues,
+    fixes,
+    summary: {
+      totalIssues: issues.length,
+      fixableIssues,
+      fixedIssues: fixes.length,
+      byRule,
+      bySeverity
+    }
+  };
+}
+
+// src/agent/tools/doctor.ts
+function createDoctorTools(store) {
+  return [
+    tool23(
+      "run_doctor",
+      "Scan project documents for structural issues and optionally auto-repair them. Returns a JSON report with all issues found and fixes applied.",
+      {
+        fix: external_exports.boolean().optional().default(false).describe("When true, auto-repair fixable issues"),
+        rule: external_exports.string().optional().describe(
+          "Run only a specific rule (e.g. tag-migration, array-normalization, missing-auto-tags, progress-consistency, orphaned-references)"
+        )
+      },
+      async (args) => {
+        try {
+          const report = args.fix ? runDoctorFix(store, args.rule) : runDoctorScan(store, args.rule);
+          return {
+            content: [
+              {
+                type: "text",
+                text: JSON.stringify(report, null, 2)
+              }
+            ]
+          };
+        } catch (err) {
+          return {
+            content: [
+              {
+                type: "text",
+                text: `Doctor error: ${err instanceof Error ? err.message : String(err)}`
+              }
+            ],
+            isError: true
+          };
+        }
+      }
+    )
+  ];
+}
+
 // src/agent/mcp-server.ts
 function createMarvinMcpServer(store, options) {
   const tools = [
@@ -25322,7 +25946,8 @@ function createMarvinMcpServer(store, options) {
     ...options?.sessionStore ? createSessionTools(options.sessionStore) : [],
     ...options?.pluginTools ?? [],
     ...options?.skillTools ?? [],
-    ...options?.projectName && options?.navGroups ? createWebTools(store, options.projectName, options.navGroups) : []
+    ...options?.projectName && options?.navGroups ? createWebTools(store, options.projectName, options.navGroups) : [],
+    ...createDoctorTools(store)
   ];
   return createSdkMcpServer({
     name: "marvin-governance",
@@ -25394,7 +26019,7 @@ function createSkillActionTools(skills, context) {
     if (!skill.actions) continue;
     for (const action of skill.actions) {
       tools.push(
-        tool23(
+        tool24(
           `${skill.id}__${action.id}`,
           action.description,
           {
@@ -25486,10 +26111,10 @@ ${lines.join("\n\n")}`;
 }
 
 // src/mcp/persona-tools.ts
-import { tool as tool24 } from "@anthropic-ai/claude-agent-sdk";
+import { tool as tool25 } from "@anthropic-ai/claude-agent-sdk";
 function createPersonaTools(ctx, marvinDir) {
   return [
-    tool24(
+    tool25(
       "set_persona",
       "Set the active persona for this session. Returns full guidance for the selected persona including behavioral rules, allowed document types, and scope. Call this before working to ensure persona-appropriate behavior.",
       {
@@ -25519,7 +26144,7 @@ ${summaries}`
         };
       }
     ),
-    tool24(
+    tool25(
       "get_persona_guidance",
       "Get guidance for a persona without changing the active persona. If no persona is specified, lists all available personas with summaries.",
       {