mrvn-cli 0.4.7 → 0.4.9

package/README.md

@@ -751,4 +751,10 @@ npm run typecheck    # TypeScript check without emitting
 
 ## License
 
-MIT
+Marvin CLI is open-source and released under the MIT License with Commons Clause. This means you can:
+
+- Use Marvin for personal and commercial projects
+- Modify the source code to fit your needs
+- Distribute copies of the software
+- Contribute improvements back to the community
+- The Commons Clause adds one important restriction: you cannot sell Marvin itself as a service or product, but you can use it in your own applications and services.

package/dist/index.js

@@ -14557,7 +14557,8 @@ function createActionTools(store) {
         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.")
+        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.")
       },
       async (args) => {
         const tags = [...args.tags ?? []];
@@ -14567,6 +14568,9 @@ function createActionTools(store) {
             if (!tags.includes(tag)) tags.push(tag);
           }
         }
+        if (args.workStream) {
+          tags.push(`stream:${args.workStream}`);
+        }
         const doc = store.create(
           "action",
           {
@@ -14604,10 +14608,11 @@ function createActionTools(store) {
         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'].")
+        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.")
       },
       async (args) => {
-        const { id, content, sprints, tags, ...updates } = args;
+        const { id, content, sprints, tags, workStream, ...updates } = args;
         if (tags !== void 0) {
           const merged = [...tags];
           if (sprints) {
@@ -14616,8 +14621,14 @@ function createActionTools(store) {
               if (!merged.includes(tag)) merged.push(tag);
             }
           }
-          updates.tags = merged;
-        } else if (sprints !== void 0) {
+          if (workStream !== void 0) {
+            const filtered = merged.filter((t) => !t.startsWith("stream:"));
+            filtered.push(`stream:${workStream}`);
+            updates.tags = filtered;
+          } else {
+            updates.tags = merged;
+          }
+        } else if (sprints !== void 0 || workStream !== void 0) {
           const existing = store.get(id);
           if (!existing) {
             return {
@@ -14625,10 +14636,16 @@ function createActionTools(store) {
               isError: true
             };
           }
-          const existingTags = existing.frontmatter.tags ?? [];
-          const nonSprintTags = existingTags.filter((t) => !t.startsWith("sprint:"));
-          const newSprintTags = sprints.map((s) => `sprint:${s}`);
-          updates.tags = [...nonSprintTags, ...newSprintTags];
+          let existingTags = existing.frontmatter.tags ?? [];
+          if (sprints !== void 0) {
+            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}`);
+          }
+          updates.tags = existingTags;
         }
         const doc = store.update(id, updates, content);
         return {
@@ -14793,14 +14810,19 @@ 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"),
-        tag: external_exports.string().optional().describe("Filter by tag")
+        tag: external_exports.string().optional().describe("Filter by tag"),
+        workStream: external_exports.string().optional().describe("Filter by work stream name (matches stream:<value> tag)")
       },
       async (args) => {
-        const docs = store.list({
+        let docs = store.list({
           type: args.type,
           status: args.status,
           tag: args.tag
         });
+        if (args.workStream) {
+          const streamTag = `stream:${args.workStream}`;
+          docs = docs.filter((d) => d.frontmatter.tags?.includes(streamTag));
+        }
         const summary = docs.map((d) => ({
           id: d.frontmatter.id,
           title: d.frontmatter.title,
@@ -15472,13 +15494,14 @@ function collectSprintSummaryData(store, sprintId) {
   const workItemDocs = allDocs.filter(
     (d) => d.frontmatter.type !== "sprint" && d.frontmatter.type !== "epic" && d.frontmatter.tags?.includes(sprintTag)
   );
+  const primaryDocs = workItemDocs.filter((d) => d.frontmatter.type !== "contribution");
   const byStatus = {};
   const byType = {};
   let doneCount = 0;
   let inProgressCount = 0;
   let openCount = 0;
   let blockedCount = 0;
-  for (const doc of workItemDocs) {
+  for (const doc of primaryDocs) {
     const s = doc.frontmatter.status;
     byStatus[s] = (byStatus[s] ?? 0) + 1;
     byType[doc.frontmatter.type] = (byType[doc.frontmatter.type] ?? 0) + 1;
@@ -15487,21 +15510,61 @@ function collectSprintSummaryData(store, sprintId) {
     else if (s === "blocked") blockedCount++;
     else openCount++;
   }
+  const allItemsById = /* @__PURE__ */ new Map();
+  const childrenByParent = /* @__PURE__ */ new Map();
+  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 item = {
+      id: doc.frontmatter.id,
+      title: doc.frontmatter.title,
+      type: doc.frontmatter.type,
+      status: doc.frontmatter.status,
+      workStream: streamTag ? streamTag.slice(7) : void 0,
+      aboutArtifact: about
+    };
+    allItemsById.set(item.id, item);
+    if (about && sprintItemIds.has(about)) {
+      if (!childrenByParent.has(about)) childrenByParent.set(about, []);
+      childrenByParent.get(about).push(item);
+    }
+  }
+  const itemsWithChildren = /* @__PURE__ */ new Set();
+  for (const [parentId, children] of childrenByParent) {
+    const parent = allItemsById.get(parentId);
+    if (parent) {
+      parent.children = children;
+      for (const child of children) itemsWithChildren.add(child.id);
+    }
+  }
+  for (const item of allItemsById.values()) {
+    if (item.children) {
+      for (const child of item.children) {
+        const grandchildren = childrenByParent.get(child.id);
+        if (grandchildren) {
+          child.children = grandchildren;
+          for (const gc of grandchildren) itemsWithChildren.add(gc.id);
+        }
+      }
+    }
+  }
+  const items = [];
+  for (const doc of workItemDocs) {
+    if (!itemsWithChildren.has(doc.frontmatter.id)) {
+      items.push(allItemsById.get(doc.frontmatter.id));
+    }
+  }
   const workItems = {
-    total: workItemDocs.length,
+    total: primaryDocs.length,
     done: doneCount,
     inProgress: inProgressCount,
     open: openCount,
     blocked: blockedCount,
-    completionPct: workItemDocs.length > 0 ? Math.round(doneCount / workItemDocs.length * 100) : 0,
+    completionPct: primaryDocs.length > 0 ? Math.round(doneCount / primaryDocs.length * 100) : 0,
     byStatus,
     byType,
-    items: workItemDocs.map((d) => ({
-      id: d.frontmatter.id,
-      title: d.frontmatter.title,
-      type: d.frontmatter.type,
-      status: d.frontmatter.status
-    }))
+    items
   };
   const meetings = [];
   if (startDate && endDate) {
@@ -15583,7 +15646,7 @@ function collectSprintSummaryData(store, sprintId) {
     const prev = completedSprints[0];
     const prevTag = `sprint:${prev.frontmatter.id}`;
     const prevWorkItems = allDocs.filter(
-      (d) => d.frontmatter.type !== "sprint" && d.frontmatter.type !== "epic" && d.frontmatter.tags?.includes(prevTag)
+      (d) => d.frontmatter.type !== "sprint" && d.frontmatter.type !== "epic" && d.frontmatter.type !== "contribution" && d.frontmatter.tags?.includes(prevTag)
     );
     const prevDone = prevWorkItems.filter((d) => DONE_STATUSES.has(d.frontmatter.status)).length;
     const prevRate = prevWorkItems.length > 0 ? Math.round(prevDone / prevWorkItems.length * 100) : 0;
@@ -16453,6 +16516,17 @@ tr:hover td {
   background: var(--bg-hover);
 }
 
+/* Hierarchical work-item sub-rows */
+.child-row td {
+  font-size: 0.8125rem;
+  border-bottom-style: dashed;
+}
+.contribution-row td {
+  font-size: 0.8125rem;
+  color: var(--text-dim);
+  border-bottom-style: dashed;
+}
+
 /* GAR */
 .gar-overall {
   text-align: center;
@@ -18140,22 +18214,36 @@ function sprintSummaryPage(data, cached2) {
         </div>`,
     { titleTag: "h3" }
   ) : "";
-  const workItemsSection = data.workItems.total > 0 ? collapsibleSection(
+  function renderItemRows(items, depth = 0) {
+    return items.flatMap((w) => {
+      const isChild = depth > 0;
+      const isContribution = w.type === "contribution";
+      const rowClass = isContribution ? ' class="contribution-row"' : isChild ? ' class="child-row"' : "";
+      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 row = `
+              <tr${rowClass}>
+                <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>
+              </tr>`;
+      const childRows = w.children ? renderItemRows(w.children, depth + 1) : [];
+      return [row, ...childRows];
+    });
+  }
+  const workItemRows = renderItemRows(data.workItems.items);
+  const workItemsSection = workItemRows.length > 0 ? collapsibleSection(
     "ss-work-items",
     "Work Items",
     `<div class="table-wrap">
           <table>
             <thead>
-              <tr><th>ID</th><th>Title</th><th>Type</th><th>Status</th></tr>
+              <tr><th>ID</th><th>Title</th><th>Stream</th><th>Type</th><th>Status</th></tr>
             </thead>
             <tbody>
-              ${data.workItems.items.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>${statusBadge(w.status)}</td>
-              </tr>`).join("")}
+              ${workItemRows.join("")}
             </tbody>
           </table>
         </div>`,
@@ -19449,19 +19537,22 @@ function createContributionTools(store) {
         content: external_exports.string().describe("Contribution content \u2014 the input from the persona"),
         persona: external_exports.string().describe("Persona making the contribution (e.g. 'tech-lead')"),
         contributionType: external_exports.string().describe("Type of contribution (e.g. 'action-result', 'risk-finding')"),
-        aboutArtifact: external_exports.string().optional().describe("Artifact ID this contribution relates to (e.g. 'A-001')"),
-        status: external_exports.string().optional().describe("Status (default: 'open')"),
-        tags: external_exports.array(external_exports.string()).optional().describe("Tags for categorization")
+        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.")
       },
       async (args) => {
         const frontmatter = {
           title: args.title,
-          status: args.status ?? "open",
+          status: args.status ?? "done",
           persona: args.persona,
           contributionType: args.contributionType
         };
-        if (args.aboutArtifact) frontmatter.aboutArtifact = args.aboutArtifact;
-        if (args.tags) frontmatter.tags = args.tags;
+        frontmatter.aboutArtifact = args.aboutArtifact;
+        const tags = [...args.tags ?? []];
+        if (args.workStream) tags.push(`stream:${args.workStream}`);
+        if (tags.length > 0) frontmatter.tags = tags;
         const doc = store.create("contribution", frontmatter, args.content);
         return {
           content: [
@@ -19480,10 +19571,18 @@ function createContributionTools(store) {
         id: external_exports.string().describe("Contribution ID to update"),
         title: external_exports.string().optional().describe("New title"),
         status: external_exports.string().optional().describe("New status"),
-        content: external_exports.string().optional().describe("New content")
+        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.")
       },
       async (args) => {
-        const { id, content, ...updates } = args;
+        const { id, content, workStream, ...updates } = args;
+        if (workStream !== void 0) {
+          const existing = store.get(id);
+          const existingTags = existing?.frontmatter.tags ?? [];
+          const filtered = existingTags.filter((t) => !t.startsWith("stream:"));
+          filtered.push(`stream:${workStream}`);
+          updates.tags = filtered;
+        }
         const doc = store.update(id, updates, content);
         return {
           content: [
@@ -19944,13 +20043,15 @@ function createTaskTools(store) {
         title: external_exports.string().describe("Task title"),
         content: external_exports.string().describe("Task description and implementation details"),
         linkedEpic: linkedEpicArray.describe("Epic ID(s) to link this task to (e.g. ['E-001'] or ['E-001', 'E-002'])"),
+        aboutArtifact: external_exports.string().optional().describe("Parent artifact this task derives from (e.g. 'A-001')"),
         status: external_exports.enum(["backlog", "ready", "in-progress", "review", "done"]).optional().describe("Task status (default: 'backlog')"),
         acceptanceCriteria: external_exports.string().optional().describe("Acceptance criteria for the task"),
         technicalNotes: external_exports.string().optional().describe("Technical implementation notes"),
         estimatedPoints: external_exports.number().optional().describe("Story point estimate"),
         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")
+        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.")
       },
       async (args) => {
         const linkedEpics = normalizeLinkedEpics(args.linkedEpic);
@@ -19963,12 +20064,15 @@ function createTaskTools(store) {
             warnings.push(`Warning: ${epicId} is a ${epic.frontmatter.type}, not an epic`);
           }
         }
+        const baseTags = [...generateEpicTags(linkedEpics), ...args.tags ?? []];
+        if (args.workStream) baseTags.push(`stream:${args.workStream}`);
         const frontmatter = {
           title: args.title,
           status: args.status ?? "backlog",
           linkedEpic: linkedEpics,
-          tags: [...generateEpicTags(linkedEpics), ...args.tags ?? []]
+          tags: baseTags
         };
+        if (args.aboutArtifact) frontmatter.aboutArtifact = args.aboutArtifact;
         if (args.acceptanceCriteria) frontmatter.acceptanceCriteria = args.acceptanceCriteria;
         if (args.technicalNotes) frontmatter.technicalNotes = args.technicalNotes;
         if (args.estimatedPoints !== void 0) frontmatter.estimatedPoints = args.estimatedPoints;
@@ -19992,6 +20096,7 @@ function createTaskTools(store) {
       {
         id: external_exports.string().describe("Task ID to update"),
         title: external_exports.string().optional().describe("New title"),
+        aboutArtifact: external_exports.string().optional().describe("Parent artifact this task derives from (e.g. 'A-001')"),
         status: external_exports.enum(["backlog", "ready", "in-progress", "review", "done"]).optional().describe("New status"),
         content: external_exports.string().optional().describe("New content"),
         linkedEpic: linkedEpicArray.optional().describe("New linked epic ID(s)"),
@@ -20000,10 +20105,11 @@ function createTaskTools(store) {
         estimatedPoints: external_exports.number().optional().describe("New story point estimate"),
         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)")
+        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.")
       },
       async (args) => {
-        const { id, content, linkedEpic: rawLinkedEpic, tags: userTags, ...updates } = args;
+        const { id, content, linkedEpic: rawLinkedEpic, tags: userTags, workStream, ...updates } = args;
         const warnings = [];
         if (rawLinkedEpic !== void 0) {
           const linkedEpics = normalizeLinkedEpics(rawLinkedEpic);
@@ -20024,6 +20130,12 @@ function createTaskTools(store) {
         } else if (userTags !== void 0) {
           updates.tags = userTags;
         }
+        if (workStream !== void 0) {
+          const currentTags = updates.tags ?? store.get(id)?.frontmatter.tags ?? [];
+          const filtered = currentTags.filter((t) => !t.startsWith("stream:"));
+          filtered.push(`stream:${workStream}`);
+          updates.tags = filtered;
+        }
         const doc = store.update(id, updates, content);
         const parts = [`Updated task ${doc.frontmatter.id}: ${doc.frontmatter.title}`];
         if (warnings.length > 0) {
@@ -26165,7 +26277,7 @@ function createProgram() {
   const program = new Command();
   program.name("marvin").description(
     "AI-powered product development assistant with Product Owner, Delivery Manager, and Technical Lead personas"
-  ).version("0.4.7");
+  ).version("0.4.9");
   program.command("init").description("Initialize a new Marvin project in the current directory").action(async () => {
     await initCommand();
   });