mrvn-cli 0.2.6 → 0.2.8

package/dist/marvin.js

@@ -14101,6 +14101,128 @@ function createMeetingTools(store) {
 
 // src/plugins/builtin/tools/reports.ts
 import { tool as tool2 } from "@anthropic-ai/claude-agent-sdk";
+
+// src/reports/gar/collector.ts
+function collectGarMetrics(store) {
+  const allActions = store.list({ type: "action" });
+  const openActions = allActions.filter((d) => d.frontmatter.status === "open");
+  const doneActions = allActions.filter((d) => d.frontmatter.status === "done");
+  const allDocs = store.list();
+  const blockedItems = allDocs.filter(
+    (d) => d.frontmatter.tags?.includes("blocked")
+  );
+  const overdueItems = allDocs.filter(
+    (d) => d.frontmatter.tags?.includes("overdue")
+  );
+  const openQuestions = store.list({ type: "question", status: "open" });
+  const riskItems = allDocs.filter(
+    (d) => d.frontmatter.tags?.includes("risk")
+  );
+  const unownedActions = openActions.filter((d) => !d.frontmatter.owner);
+  const total = allActions.length;
+  const done = doneActions.length;
+  const completionPct = total > 0 ? Math.round(done / total * 100) : 100;
+  const scheduleItems = [
+    ...blockedItems,
+    ...overdueItems
+  ].filter(
+    (d, i, arr) => arr.findIndex((x) => x.frontmatter.id === d.frontmatter.id) === i
+  ).map((d) => ({ id: d.frontmatter.id, title: d.frontmatter.title }));
+  const qualityItems = [
+    ...riskItems,
+    ...openQuestions
+  ].filter(
+    (d, i, arr) => arr.findIndex((x) => x.frontmatter.id === d.frontmatter.id) === i
+  ).map((d) => ({ id: d.frontmatter.id, title: d.frontmatter.title }));
+  const resourceItems = unownedActions.map((d) => ({
+    id: d.frontmatter.id,
+    title: d.frontmatter.title
+  }));
+  return {
+    scope: {
+      total,
+      open: openActions.length,
+      done,
+      completionPct
+    },
+    schedule: {
+      blocked: blockedItems.length,
+      overdue: overdueItems.length,
+      items: scheduleItems
+    },
+    quality: {
+      risks: riskItems.length,
+      openQuestions: openQuestions.length,
+      items: qualityItems
+    },
+    resources: {
+      unowned: unownedActions.length,
+      items: resourceItems
+    }
+  };
+}
+
+// src/reports/gar/evaluator.ts
+function worstStatus(statuses) {
+  if (statuses.includes("red")) return "red";
+  if (statuses.includes("amber")) return "amber";
+  return "green";
+}
+function evaluateGar(projectName, metrics) {
+  const areas = [];
+  const scopePct = metrics.scope.completionPct;
+  const scopeStatus = scopePct >= 70 ? "green" : scopePct >= 40 ? "amber" : "red";
+  areas.push({
+    name: "Scope",
+    status: scopeStatus,
+    summary: `${scopePct}% complete (${metrics.scope.done}/${metrics.scope.total})`,
+    items: []
+  });
+  const scheduleCount = metrics.schedule.blocked + metrics.schedule.overdue;
+  const scheduleStatus = scheduleCount === 0 ? "green" : scheduleCount <= 2 ? "amber" : "red";
+  const scheduleParts = [];
+  if (metrics.schedule.blocked > 0)
+    scheduleParts.push(`${metrics.schedule.blocked} blocked`);
+  if (metrics.schedule.overdue > 0)
+    scheduleParts.push(`${metrics.schedule.overdue} overdue`);
+  areas.push({
+    name: "Schedule",
+    status: scheduleStatus,
+    summary: scheduleParts.length > 0 ? scheduleParts.join(", ") : "on track",
+    items: metrics.schedule.items
+  });
+  const qualityCount = metrics.quality.risks + metrics.quality.openQuestions;
+  const qualityStatus = qualityCount === 0 ? "green" : qualityCount <= 2 ? "amber" : "red";
+  const qualityParts = [];
+  if (metrics.quality.risks > 0)
+    qualityParts.push(`${metrics.quality.risks} risk(s)`);
+  if (metrics.quality.openQuestions > 0)
+    qualityParts.push(`${metrics.quality.openQuestions} open question(s)`);
+  areas.push({
+    name: "Quality",
+    status: qualityStatus,
+    summary: qualityParts.length > 0 ? qualityParts.join(", ") : "no issues",
+    items: metrics.quality.items
+  });
+  const resourceCount = metrics.resources.unowned;
+  const resourceStatus = resourceCount === 0 ? "green" : resourceCount <= 2 ? "amber" : "red";
+  areas.push({
+    name: "Resources",
+    status: resourceStatus,
+    summary: resourceCount > 0 ? `${resourceCount} unowned action(s)` : "all assigned",
+    items: metrics.resources.items
+  });
+  const overall = worstStatus(areas.map((a) => a.status));
+  return {
+    projectName,
+    generatedAt: (/* @__PURE__ */ new Date()).toISOString().slice(0, 10),
+    overall,
+    areas,
+    metrics
+  };
+}
+
+// src/plugins/builtin/tools/reports.ts
 function createReportTools(store) {
   return [
     tool2(
@@ -14189,41 +14311,10 @@ function createReportTools(store) {
       "Generate a Green-Amber-Red report with metrics across scope, schedule, quality, and resources",
       {},
       async () => {
-        const allActions = store.list({ type: "action" });
-        const openActions = allActions.filter((d) => d.frontmatter.status === "open");
-        const doneActions = allActions.filter((d) => d.frontmatter.status === "done");
-        const allDocs = store.list();
-        const blockedItems = allDocs.filter(
-          (d) => d.frontmatter.tags?.includes("blocked")
-        );
-        const overdueItems = allDocs.filter(
-          (d) => d.frontmatter.tags?.includes("overdue")
-        );
-        const openQuestions = store.list({ type: "question", status: "open" });
-        const riskItems = allDocs.filter(
-          (d) => d.frontmatter.tags?.includes("risk")
-        );
-        const unownedActions = openActions.filter((d) => !d.frontmatter.owner);
-        const areas = {
-          scope: {
-            total: allActions.length,
-            open: openActions.length,
-            done: doneActions.length
-          },
-          schedule: {
-            blocked: blockedItems.length,
-            overdue: overdueItems.length
-          },
-          quality: {
-            openQuestions: openQuestions.length,
-            risks: riskItems.length
-          },
-          resources: {
-            unowned: unownedActions.length
-          }
-        };
+        const metrics = collectGarMetrics(store);
+        const report = evaluateGar("project", metrics);
         return {
-          content: [{ type: "text", text: JSON.stringify({ areas }, null, 2) }]
+          content: [{ type: "text", text: JSON.stringify(report, null, 2) }]
         };
       },
       { annotations: { readOnly: true } }
@@ -17615,9 +17706,495 @@ Be thorough but concise. Focus on actionable insights.`,
   ]
 };
 
+// src/skills/builtin/jira/tools.ts
+import { tool as tool19 } from "@anthropic-ai/claude-agent-sdk";
+
+// src/skills/builtin/jira/client.ts
+var JiraClient = class {
+  baseUrl;
+  authHeader;
+  constructor(config2) {
+    this.baseUrl = `https://${config2.host}/rest/api/2`;
+    this.authHeader = "Basic " + Buffer.from(`${config2.email}:${config2.apiToken}`).toString("base64");
+  }
+  async request(path18, method = "GET", body) {
+    const url2 = `${this.baseUrl}${path18}`;
+    const headers = {
+      Authorization: this.authHeader,
+      "Content-Type": "application/json",
+      Accept: "application/json"
+    };
+    const response = await fetch(url2, {
+      method,
+      headers,
+      body: body ? JSON.stringify(body) : void 0
+    });
+    if (!response.ok) {
+      const text = await response.text().catch(() => "");
+      throw new Error(
+        `Jira API error ${response.status} ${method} ${path18}: ${text}`
+      );
+    }
+    if (response.status === 204) return void 0;
+    return response.json();
+  }
+  async searchIssues(jql, maxResults = 50) {
+    const params = new URLSearchParams({
+      jql,
+      maxResults: String(maxResults)
+    });
+    return this.request(`/search?${params}`);
+  }
+  async getIssue(key) {
+    return this.request(`/issue/${encodeURIComponent(key)}`);
+  }
+  async createIssue(fields) {
+    return this.request("/issue", "POST", { fields });
+  }
+  async updateIssue(key, fields) {
+    await this.request(
+      `/issue/${encodeURIComponent(key)}`,
+      "PUT",
+      { fields }
+    );
+  }
+  async addComment(key, body) {
+    await this.request(
+      `/issue/${encodeURIComponent(key)}/comment`,
+      "POST",
+      { body }
+    );
+  }
+};
+function createJiraClient() {
+  const host = process.env.JIRA_HOST;
+  const email3 = process.env.JIRA_EMAIL;
+  const apiToken = process.env.JIRA_API_TOKEN;
+  if (!host || !email3 || !apiToken) return null;
+  return new JiraClient({ host, email: email3, apiToken });
+}
+
+// src/skills/builtin/jira/tools.ts
+var JIRA_TYPE = "jira-issue";
+function jiraNotConfiguredError() {
+  return {
+    content: [
+      {
+        type: "text",
+        text: "Jira is not configured. Set JIRA_HOST, JIRA_EMAIL, and JIRA_API_TOKEN environment variables."
+      }
+    ],
+    isError: true
+  };
+}
+function mapJiraStatus(jiraStatus) {
+  const lower = jiraStatus.toLowerCase();
+  if (lower === "done" || lower === "closed" || lower === "resolved") return "done";
+  if (lower === "in progress" || lower === "in review") return "in-progress";
+  return "open";
+}
+function jiraIssueToFrontmatter(issue2, host, linkedArtifacts) {
+  return {
+    title: issue2.fields.summary,
+    status: mapJiraStatus(issue2.fields.status.name),
+    jiraKey: issue2.key,
+    jiraUrl: `https://${host}/browse/${issue2.key}`,
+    issueType: issue2.fields.issuetype.name,
+    priority: issue2.fields.priority?.name ?? "None",
+    assignee: issue2.fields.assignee?.displayName ?? "",
+    labels: issue2.fields.labels ?? [],
+    linkedArtifacts: linkedArtifacts ?? [],
+    tags: [`jira:${issue2.key}`],
+    lastSyncedAt: (/* @__PURE__ */ new Date()).toISOString()
+  };
+}
+function findByJiraKey(store, jiraKey) {
+  const docs = store.list({ type: JIRA_TYPE });
+  return docs.find((d) => d.frontmatter.jiraKey === jiraKey);
+}
+function createJiraTools(store) {
+  return [
+    // --- Local read tools ---
+    tool19(
+      "list_jira_issues",
+      "List locally synced Jira issues (JI-xxx documents), optionally filtered by status or Jira key",
+      {
+        status: external_exports.enum(["open", "in-progress", "done"]).optional().describe("Filter by local status"),
+        jiraKey: external_exports.string().optional().describe("Filter by Jira issue key (e.g. 'PROJ-123')")
+      },
+      async (args) => {
+        let docs = store.list({ type: JIRA_TYPE, status: args.status });
+        if (args.jiraKey) {
+          docs = docs.filter((d) => d.frontmatter.jiraKey === args.jiraKey);
+        }
+        const summary = docs.map((d) => ({
+          id: d.frontmatter.id,
+          title: d.frontmatter.title,
+          status: d.frontmatter.status,
+          jiraKey: d.frontmatter.jiraKey,
+          issueType: d.frontmatter.issueType,
+          priority: d.frontmatter.priority,
+          assignee: d.frontmatter.assignee,
+          linkedArtifacts: d.frontmatter.linkedArtifacts
+        }));
+        return {
+          content: [{ type: "text", text: JSON.stringify(summary, null, 2) }]
+        };
+      },
+      { annotations: { readOnly: true } }
+    ),
+    tool19(
+      "get_jira_issue",
+      "Get the full content of a locally synced Jira issue by local ID (JI-xxx) or Jira key (PROJ-123)",
+      {
+        id: external_exports.string().describe("Local ID (e.g. 'JI-001') or Jira key (e.g. 'PROJ-123')")
+      },
+      async (args) => {
+        let doc = store.get(args.id);
+        if (!doc) {
+          doc = findByJiraKey(store, args.id);
+        }
+        if (!doc) {
+          return {
+            content: [{ type: "text", text: `Jira issue ${args.id} not found locally` }],
+            isError: true
+          };
+        }
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify(
+                { ...doc.frontmatter, content: doc.content },
+                null,
+                2
+              )
+            }
+          ]
+        };
+      },
+      { annotations: { readOnly: true } }
+    ),
+    // --- Jira → Local tools ---
+    tool19(
+      "pull_jira_issue",
+      "Fetch a single Jira issue by key and create/update a local JI-xxx document",
+      {
+        key: external_exports.string().describe("Jira issue key (e.g. 'PROJ-123')")
+      },
+      async (args) => {
+        const client = createJiraClient();
+        if (!client) return jiraNotConfiguredError();
+        const issue2 = await client.getIssue(args.key);
+        const host = process.env.JIRA_HOST;
+        const existing = findByJiraKey(store, args.key);
+        if (existing) {
+          const fm2 = jiraIssueToFrontmatter(
+            issue2,
+            host,
+            existing.frontmatter.linkedArtifacts
+          );
+          const doc2 = store.update(
+            existing.frontmatter.id,
+            fm2,
+            issue2.fields.description ?? ""
+          );
+          return {
+            content: [
+              {
+                type: "text",
+                text: `Updated ${doc2.frontmatter.id} from Jira ${args.key}`
+              }
+            ]
+          };
+        }
+        const fm = jiraIssueToFrontmatter(issue2, host);
+        const doc = store.create(
+          JIRA_TYPE,
+          fm,
+          issue2.fields.description ?? ""
+        );
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Created ${doc.frontmatter.id} from Jira ${args.key}`
+            }
+          ]
+        };
+      }
+    ),
+    tool19(
+      "pull_jira_issues_jql",
+      "Bulk fetch Jira issues via JQL query and create/update local JI-xxx documents",
+      {
+        jql: external_exports.string().describe(`JQL query (e.g. 'project = PROJ AND status = "In Progress"')`),
+        maxResults: external_exports.number().optional().describe("Max issues to fetch (default 50)")
+      },
+      async (args) => {
+        const client = createJiraClient();
+        if (!client) return jiraNotConfiguredError();
+        const result = await client.searchIssues(args.jql, args.maxResults);
+        const host = process.env.JIRA_HOST;
+        const created = [];
+        const updated = [];
+        for (const issue2 of result.issues) {
+          const existing = findByJiraKey(store, issue2.key);
+          if (existing) {
+            const fm = jiraIssueToFrontmatter(
+              issue2,
+              host,
+              existing.frontmatter.linkedArtifacts
+            );
+            store.update(
+              existing.frontmatter.id,
+              fm,
+              issue2.fields.description ?? ""
+            );
+            updated.push(`${existing.frontmatter.id} (${issue2.key})`);
+          } else {
+            const fm = jiraIssueToFrontmatter(issue2, host);
+            const doc = store.create(
+              JIRA_TYPE,
+              fm,
+              issue2.fields.description ?? ""
+            );
+            created.push(`${doc.frontmatter.id} (${issue2.key})`);
+          }
+        }
+        const parts = [
+          `Fetched ${result.issues.length} of ${result.total} matching issues.`
+        ];
+        if (created.length > 0) parts.push(`Created: ${created.join(", ")}`);
+        if (updated.length > 0) parts.push(`Updated: ${updated.join(", ")}`);
+        return {
+          content: [{ type: "text", text: parts.join("\n") }]
+        };
+      }
+    ),
+    // --- Local → Jira tools ---
+    tool19(
+      "push_artifact_to_jira",
+      "Create a Jira issue from any Marvin artifact (D/A/Q/F/E) and create a tracking JI-xxx document",
+      {
+        artifactId: external_exports.string().describe("Marvin artifact ID (e.g. 'D-001', 'F-003', 'E-002')"),
+        projectKey: external_exports.string().describe("Jira project key (e.g. 'PROJ')"),
+        issueType: external_exports.enum(["Story", "Task", "Bug", "Epic"]).optional().describe("Jira issue type (default: 'Task')")
+      },
+      async (args) => {
+        const client = createJiraClient();
+        if (!client) return jiraNotConfiguredError();
+        const artifact = store.get(args.artifactId);
+        if (!artifact) {
+          return {
+            content: [
+              { type: "text", text: `Artifact ${args.artifactId} not found` }
+            ],
+            isError: true
+          };
+        }
+        const description = [
+          artifact.content,
+          "",
+          `---`,
+          `Marvin artifact: ${artifact.frontmatter.id} (${artifact.frontmatter.type})`,
+          `Status: ${artifact.frontmatter.status}`
+        ].join("\n");
+        const jiraResult = await client.createIssue({
+          project: { key: args.projectKey },
+          summary: artifact.frontmatter.title,
+          description,
+          issuetype: { name: args.issueType ?? "Task" }
+        });
+        const host = process.env.JIRA_HOST;
+        const jiDoc = store.create(
+          JIRA_TYPE,
+          {
+            title: artifact.frontmatter.title,
+            status: "open",
+            jiraKey: jiraResult.key,
+            jiraUrl: `https://${host}/browse/${jiraResult.key}`,
+            issueType: args.issueType ?? "Task",
+            priority: "Medium",
+            assignee: "",
+            labels: [],
+            linkedArtifacts: [args.artifactId],
+            tags: [`jira:${jiraResult.key}`],
+            lastSyncedAt: (/* @__PURE__ */ new Date()).toISOString()
+          },
+          ""
+        );
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Created Jira ${jiraResult.key} from ${args.artifactId}. Tracking locally as ${jiDoc.frontmatter.id}.`
+            }
+          ]
+        };
+      }
+    ),
+    // --- Bidirectional sync ---
+    tool19(
+      "sync_jira_issue",
+      "Bidirectional sync: push local title/description to Jira, pull latest status/assignee/labels back",
+      {
+        id: external_exports.string().describe("Local JI-xxx ID")
+      },
+      async (args) => {
+        const client = createJiraClient();
+        if (!client) return jiraNotConfiguredError();
+        const doc = store.get(args.id);
+        if (!doc || doc.frontmatter.type !== JIRA_TYPE) {
+          return {
+            content: [
+              { type: "text", text: `Jira issue ${args.id} not found locally` }
+            ],
+            isError: true
+          };
+        }
+        const jiraKey = doc.frontmatter.jiraKey;
+        await client.updateIssue(jiraKey, {
+          summary: doc.frontmatter.title,
+          description: doc.content || void 0
+        });
+        const issue2 = await client.getIssue(jiraKey);
+        const host = process.env.JIRA_HOST;
+        const fm = jiraIssueToFrontmatter(
+          issue2,
+          host,
+          doc.frontmatter.linkedArtifacts
+        );
+        store.update(args.id, fm, issue2.fields.description ?? "");
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Synced ${args.id} \u2194 ${jiraKey}. Status: ${fm.status}, Assignee: ${fm.assignee || "unassigned"}`
+            }
+          ]
+        };
+      }
+    ),
+    // --- Local link tool ---
+    tool19(
+      "link_artifact_to_jira",
+      "Add a Marvin artifact ID to a JI-xxx document's linkedArtifacts field",
+      {
+        jiraIssueId: external_exports.string().describe("Local JI-xxx ID"),
+        artifactId: external_exports.string().describe("Marvin artifact ID to link (e.g. 'D-001', 'F-003')")
+      },
+      async (args) => {
+        const doc = store.get(args.jiraIssueId);
+        if (!doc || doc.frontmatter.type !== JIRA_TYPE) {
+          return {
+            content: [
+              {
+                type: "text",
+                text: `Jira issue ${args.jiraIssueId} not found locally`
+              }
+            ],
+            isError: true
+          };
+        }
+        const artifact = store.get(args.artifactId);
+        if (!artifact) {
+          return {
+            content: [
+              { type: "text", text: `Artifact ${args.artifactId} not found` }
+            ],
+            isError: true
+          };
+        }
+        const linked = doc.frontmatter.linkedArtifacts ?? [];
+        if (linked.includes(args.artifactId)) {
+          return {
+            content: [
+              {
+                type: "text",
+                text: `${args.artifactId} is already linked to ${args.jiraIssueId}`
+              }
+            ]
+          };
+        }
+        store.update(args.jiraIssueId, {
+          linkedArtifacts: [...linked, args.artifactId]
+        });
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Linked ${args.artifactId} to ${args.jiraIssueId}`
+            }
+          ]
+        };
+      }
+    )
+  ];
+}
+
+// src/skills/builtin/jira/index.ts
+var jiraSkill = {
+  id: "jira",
+  name: "Jira Integration",
+  description: "Bidirectional sync between Marvin artifacts and Jira issues",
+  version: "1.0.0",
+  format: "builtin-ts",
+  // No default persona affinity — opt-in via config.yaml skills section
+  documentTypeRegistrations: [
+    { type: "jira-issue", dirName: "jira-issues", idPrefix: "JI" }
+  ],
+  tools: (store) => createJiraTools(store),
+  promptFragments: {
+    "product-owner": `You have the **Jira Integration** skill. You can pull issues from Jira and push Marvin artifacts to Jira.
+
+**Available tools:**
+- \`list_jira_issues\` / \`get_jira_issue\` \u2014 browse locally synced Jira issues
+- \`pull_jira_issue\` / \`pull_jira_issues_jql\` \u2014 import issues from Jira by key or JQL query
+- \`push_artifact_to_jira\` \u2014 create a Jira issue from a Marvin artifact (decision, feature, etc.)
+- \`sync_jira_issue\` \u2014 bidirectional sync of a local JI-xxx with Jira
+- \`link_artifact_to_jira\` \u2014 link a Marvin artifact to an existing JI-xxx
+
+**As Product Owner, use Jira integration to:**
+- Pull stakeholder-reported issues for triage and prioritization
+- Push approved features as Stories for development tracking
+- Link decisions to Jira issues for audit trail and traceability
+- Use JQL queries to review backlog status (e.g. \`project = PROJ AND status = "To Do"\`)`,
+    "tech-lead": `You have the **Jira Integration** skill. You can pull issues from Jira and push Marvin artifacts to Jira.
+
+**Available tools:**
+- \`list_jira_issues\` / \`get_jira_issue\` \u2014 browse locally synced Jira issues
+- \`pull_jira_issue\` / \`pull_jira_issues_jql\` \u2014 import issues from Jira by key or JQL query
+- \`push_artifact_to_jira\` \u2014 create a Jira issue from a Marvin artifact (decision, action, epic, etc.)
+- \`sync_jira_issue\` \u2014 bidirectional sync of a local JI-xxx with Jira
+- \`link_artifact_to_jira\` \u2014 link a Marvin artifact to an existing JI-xxx
+
+**As Tech Lead, use Jira integration to:**
+- Pull technical issues and bugs for sprint planning and estimation
+- Push epics and technical decisions to Jira for cross-team visibility
+- Bidirectional sync to keep local governance and Jira in alignment
+- Use JQL queries to track technical debt (e.g. \`labels = "tech-debt" AND status != "Done"\`)`,
+    "delivery-manager": `You have the **Jira Integration** skill. You can pull issues from Jira and push Marvin artifacts to Jira.
+
+**Available tools:**
+- \`list_jira_issues\` / \`get_jira_issue\` \u2014 browse locally synced Jira issues
+- \`pull_jira_issue\` / \`pull_jira_issues_jql\` \u2014 import issues from Jira by key or JQL query
+- \`push_artifact_to_jira\` \u2014 create a Jira issue from a Marvin artifact (decision, action, etc.)
+- \`sync_jira_issue\` \u2014 bidirectional sync of a local JI-xxx with Jira
+- \`link_artifact_to_jira\` \u2014 link a Marvin artifact to an existing JI-xxx
+
+**As Delivery Manager, use Jira integration to:**
+- Pull sprint issues for tracking progress and blockers
+- Push actions and decisions to Jira for stakeholder visibility
+- Use JQL queries for reporting (e.g. \`sprint in openSprints() AND assignee = currentUser()\`)
+- Sync status between Marvin governance items and Jira issues`
+  }
+};
+
 // src/skills/registry.ts
 var BUILTIN_SKILLS = {
-  "governance-review": governanceReviewSkill
+  "governance-review": governanceReviewSkill,
+  "jira": jiraSkill
 };
 var GOVERNANCE_TOOL_NAMES = [
   "mcp__marvin-governance__list_decisions",
@@ -17766,6 +18343,16 @@ function resolveSkillsForPersona(personaId, skillsConfig, allSkills) {
   }
   return result;
 }
+function collectSkillRegistrations(skillIds, allSkills) {
+  const registrations = [];
+  for (const id of skillIds) {
+    const skill = allSkills.get(id);
+    if (skill?.documentTypeRegistrations) {
+      registrations.push(...skill.documentTypeRegistrations);
+    }
+  }
+  return registrations;
+}
 function getSkillTools(skillIds, allSkills, store) {
   const tools = [];
   for (const id of skillIds) {
@@ -17877,16 +18464,17 @@ ${wildcardPrompt}
 async function startSession(options) {
   const { persona, config: config2, marvinDir, projectRoot } = options;
   const plugin = resolvePlugin(config2.project.methodology);
-  const registrations = plugin?.documentTypeRegistrations ?? [];
-  const store = new DocumentStore(marvinDir, registrations);
+  const pluginRegistrations = plugin?.documentTypeRegistrations ?? [];
+  const allSkills = loadAllSkills(marvinDir);
+  const skillIds = resolveSkillsForPersona(persona.id, config2.project.skills, allSkills);
+  const skillRegistrations = collectSkillRegistrations(skillIds, allSkills);
+  const store = new DocumentStore(marvinDir, [...pluginRegistrations, ...skillRegistrations]);
   const sessionStore = new SessionStore(marvinDir);
   const sourcesDir = path9.join(marvinDir, "sources");
   const hasSourcesDir = fs9.existsSync(sourcesDir);
   const manifest = hasSourcesDir ? new SourceManifestManager(marvinDir) : void 0;
   const pluginTools = plugin ? getPluginTools(plugin, store, marvinDir) : [];
   const pluginPromptFragment = plugin ? getPluginPromptFragment(plugin, persona.id) : void 0;
-  const allSkills = loadAllSkills(marvinDir);
-  const skillIds = resolveSkillsForPersona(persona.id, config2.project.skills, allSkills);
   const codeSkillTools = getSkillTools(skillIds, allSkills, store);
   const skillAgents = getSkillAgentDefinitions(skillIds, allSkills);
   const skillPromptFragment = getSkillPromptFragment(skillIds, allSkills, persona.id);
@@ -18976,7 +19564,7 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 
 // src/skills/action-tools.ts
-import { tool as tool19 } from "@anthropic-ai/claude-agent-sdk";
+import { tool as tool20 } from "@anthropic-ai/claude-agent-sdk";
 
 // src/skills/action-runner.ts
 import { query as query4 } from "@anthropic-ai/claude-agent-sdk";
@@ -19042,7 +19630,7 @@ function createSkillActionTools(skills, context) {
     if (!skill.actions) continue;
     for (const action of skill.actions) {
       tools.push(
-        tool19(
+        tool20(
           `${skill.id}__${action.id}`,
           action.description,
           {
@@ -19134,10 +19722,10 @@ ${lines.join("\n\n")}`;
 }
 
 // src/mcp/persona-tools.ts
-import { tool as tool20 } from "@anthropic-ai/claude-agent-sdk";
+import { tool as tool21 } from "@anthropic-ai/claude-agent-sdk";
 function createPersonaTools(ctx, marvinDir) {
   return [
-    tool20(
+    tool21(
       "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.",
       {
@@ -19167,7 +19755,7 @@ ${summaries}`
         };
       }
     ),
-    tool20(
+    tool21(
       "get_persona_guidance",
       "Get guidance for a persona without changing the active persona. If no persona is specified, lists all available personas with summaries.",
       {
@@ -19398,20 +19986,23 @@ async function skillsInstallCommand(skillId, options) {
     console.log(chalk10.red("Please specify a persona with --as <persona>."));
     return;
   }
+  const targets = persona === "all" ? listPersonas().map((p) => p.id) : [persona];
   const config2 = loadProjectConfig(project.marvinDir);
   if (!config2.skills) {
     config2.skills = {};
   }
-  if (!config2.skills[persona]) {
-    config2.skills[persona] = [];
-  }
-  if (config2.skills[persona].includes(skillId)) {
-    console.log(chalk10.yellow(`Skill "${skillId}" is already assigned to ${persona}.`));
-    return;
+  for (const target of targets) {
+    if (!config2.skills[target]) {
+      config2.skills[target] = [];
+    }
+    if (config2.skills[target].includes(skillId)) {
+      console.log(chalk10.yellow(`Skill "${skillId}" is already assigned to ${target}.`));
+      continue;
+    }
+    config2.skills[target].push(skillId);
+    console.log(chalk10.green(`Assigned skill "${skillId}" to ${target}.`));
   }
-  config2.skills[persona].push(skillId);
   saveProjectConfig(project.marvinDir, config2);
-  console.log(chalk10.green(`Assigned skill "${skillId}" to ${persona}.`));
 }
 async function skillsRemoveCommand(skillId, options) {
   const project = loadProject();
@@ -19420,25 +20011,28 @@ async function skillsRemoveCommand(skillId, options) {
     console.log(chalk10.red("Please specify a persona with --as <persona>."));
     return;
   }
+  const targets = persona === "all" ? listPersonas().map((p) => p.id) : [persona];
   const config2 = loadProjectConfig(project.marvinDir);
-  if (!config2.skills?.[persona]) {
-    console.log(chalk10.yellow(`No skills configured for ${persona}.`));
-    return;
-  }
-  const idx = config2.skills[persona].indexOf(skillId);
-  if (idx === -1) {
-    console.log(chalk10.yellow(`Skill "${skillId}" is not assigned to ${persona}.`));
-    return;
-  }
-  config2.skills[persona].splice(idx, 1);
-  if (config2.skills[persona].length === 0) {
-    delete config2.skills[persona];
+  for (const target of targets) {
+    if (!config2.skills?.[target]) {
+      console.log(chalk10.yellow(`No skills configured for ${target}.`));
+      continue;
+    }
+    const idx = config2.skills[target].indexOf(skillId);
+    if (idx === -1) {
+      console.log(chalk10.yellow(`Skill "${skillId}" is not assigned to ${target}.`));
+      continue;
+    }
+    config2.skills[target].splice(idx, 1);
+    if (config2.skills[target].length === 0) {
+      delete config2.skills[target];
+    }
+    console.log(chalk10.green(`Removed skill "${skillId}" from ${target}.`));
   }
-  if (Object.keys(config2.skills).length === 0) {
+  if (config2.skills && Object.keys(config2.skills).length === 0) {
     delete config2.skills;
   }
   saveProjectConfig(project.marvinDir, config2);
-  console.log(chalk10.green(`Removed skill "${skillId}" from ${persona}.`));
 }
 async function skillsCreateCommand(name) {
   const project = loadProject();
@@ -20685,12 +21279,94 @@ Contribution: ${options.type}`));
   });
 }
 
+// src/reports/gar/render-ascii.ts
+import chalk16 from "chalk";
+var STATUS_DOT = {
+  green: chalk16.green("\u25CF"),
+  amber: chalk16.yellow("\u25CF"),
+  red: chalk16.red("\u25CF")
+};
+var STATUS_LABEL = {
+  green: chalk16.green.bold("GREEN"),
+  amber: chalk16.yellow.bold("AMBER"),
+  red: chalk16.red.bold("RED")
+};
+var SEPARATOR = chalk16.dim("\u2500".repeat(60));
+function renderAscii(report) {
+  const lines = [];
+  lines.push("");
+  lines.push(chalk16.bold(`  GAR Report \xB7 ${report.projectName}`));
+  lines.push(chalk16.dim(`  ${report.generatedAt}`));
+  lines.push("");
+  lines.push(`  Overall:  ${STATUS_LABEL[report.overall]}`);
+  lines.push("");
+  lines.push(`  ${SEPARATOR}`);
+  for (const area of report.areas) {
+    lines.push(`  ${STATUS_DOT[area.status]} ${chalk16.bold(area.name.padEnd(12))} ${area.summary}`);
+    for (const item of area.items) {
+      lines.push(`    ${chalk16.dim("\u2514")} ${item.id} ${item.title}`);
+    }
+  }
+  lines.push(`  ${SEPARATOR}`);
+  lines.push("");
+  return lines.join("\n");
+}
+
+// src/reports/gar/render-confluence.ts
+var EMOJI = {
+  green: ":green_circle:",
+  amber: ":yellow_circle:",
+  red: ":red_circle:"
+};
+function renderConfluence(report) {
+  const lines = [];
+  lines.push(`# GAR Report \u2014 ${report.projectName}`);
+  lines.push("");
+  lines.push(`**Date:** ${report.generatedAt}`);
+  lines.push(`**Overall:** ${EMOJI[report.overall]} ${report.overall.toUpperCase()}`);
+  lines.push("");
+  lines.push("| Area | Status | Summary |");
+  lines.push("|------|--------|---------|");
+  for (const area of report.areas) {
+    lines.push(
+      `| ${area.name} | ${EMOJI[area.status]} ${area.status.toUpperCase()} | ${area.summary} |`
+    );
+  }
+  lines.push("");
+  for (const area of report.areas) {
+    if (area.items.length === 0) continue;
+    lines.push(`## ${area.name}`);
+    lines.push("");
+    for (const item of area.items) {
+      lines.push(`- **${item.id}** ${item.title}`);
+    }
+    lines.push("");
+  }
+  return lines.join("\n");
+}
+
+// src/cli/commands/report.ts
+async function garReportCommand(options) {
+  const project = loadProject();
+  const plugin = resolvePlugin(project.config.methodology);
+  const registrations = plugin?.documentTypeRegistrations ?? [];
+  const store = new DocumentStore(project.marvinDir, registrations);
+  const metrics = collectGarMetrics(store);
+  const report = evaluateGar(project.config.name, metrics);
+  const format = options.format ?? "ascii";
+  if (format === "confluence") {
+    console.log(renderConfluence(report));
+  } else {
+    console.log(renderAscii(report));
+  }
+}
+
 // src/cli/program.ts
 function createProgram() {
   const program2 = new Command();
   program2.name("marvin").description(
     "AI-powered product development assistant with Product Owner, Delivery Manager, and Technical Lead personas"
-  ).version("0.2.6");
+  ).version("0.2.8");
   program2.command("init").description("Initialize a new Marvin project in the current directory").action(async () => {
     await initCommand();
   });
@@ -20760,6 +21436,13 @@ function createProgram() {
   skillsCmd.command("migrate").description("Migrate YAML skill files to SKILL.md directory format").action(async () => {
     await skillsMigrateCommand();
   });
+  const reportCmd = program2.command("report").description("Generate project reports");
+  reportCmd.command("gar").description("Generate a Green/Amber/Red status report").option(
+    "--format <format>",
+    "Output format: ascii or confluence (default: ascii)"
+  ).action(async (options) => {
+    await garReportCommand(options);
+  });
   return program2;
 }