mrvn-cli 0.2.6 → 0.2.9

package/dist/marvin-serve.js

@@ -39,6 +39,26 @@ import * as fs from "fs";
 import * as path from "path";
 import * as os from "os";
 import * as YAML from "yaml";
+function userConfigDir() {
+  return path.join(os.homedir(), ".config", "marvin");
+}
+function userConfigPath() {
+  return path.join(userConfigDir(), "config.yaml");
+}
+function loadUserConfig() {
+  const configPath = userConfigPath();
+  if (!fs.existsSync(configPath)) {
+    return {};
+  }
+  try {
+    const raw = fs.readFileSync(configPath, "utf-8");
+    return YAML.parse(raw) ?? {};
+  } catch (err) {
+    throw new ConfigError(
+      `Failed to parse user config at ${configPath}: ${err}`
+    );
+  }
+}
 function loadProjectConfig(marvinDir) {
   const configPath = path.join(marvinDir, "config.yaml");
   if (!fs.existsSync(configPath)) {
@@ -266,13 +286,10 @@ var DocumentStore = class {
     if (!prefix) {
       throw new Error(`Unknown document type: ${type}`);
     }
-    const dirName = this.typeDirs[type];
-    const dir = path3.join(this.docsDir, dirName);
-    if (!fs3.existsSync(dir)) return `${prefix}-001`;
-    const files = fs3.readdirSync(dir).filter((f) => f.endsWith(".md"));
+    const pattern = new RegExp(`^${prefix}-(\\d+)$`);
     let maxNum = 0;
-    for (const file2 of files) {
-      const match = file2.match(new RegExp(`^${prefix}-(\\d+)\\.md$`));
+    for (const id of this.index.keys()) {
+      const match = id.match(pattern);
       if (match) {
         maxNum = Math.max(maxNum, parseInt(match[1], 10));
       }
@@ -14971,6 +14988,128 @@ function createMeetingTools(store) {
 
 // src/plugins/builtin/tools/reports.ts
 import { tool as tool8 } 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 [
     tool8(
@@ -15059,41 +15198,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 } }
@@ -17171,9 +17279,492 @@ 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(path10, method = "GET", body) {
+    const url2 = `${this.baseUrl}${path10}`;
+    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} ${path10}: ${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(jiraUserConfig) {
+  const host = jiraUserConfig?.host ?? process.env.JIRA_HOST;
+  const email3 = jiraUserConfig?.email ?? process.env.JIRA_EMAIL;
+  const apiToken = jiraUserConfig?.apiToken ?? process.env.JIRA_API_TOKEN;
+  if (!host || !email3 || !apiToken) return null;
+  return { client: new JiraClient({ host, email: email3, apiToken }), host };
+}
+
+// src/skills/builtin/jira/tools.ts
+var JIRA_TYPE = "jira-issue";
+function jiraNotConfiguredError() {
+  return {
+    content: [
+      {
+        type: "text",
+        text: 'Jira is not configured. Run "marvin config jira" or 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) {
+  const jiraUserConfig = loadUserConfig().jira;
+  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 jira = createJiraClient(jiraUserConfig);
+        if (!jira) return jiraNotConfiguredError();
+        const issue2 = await jira.client.getIssue(args.key);
+        const existing = findByJiraKey(store, args.key);
+        if (existing) {
+          const fm2 = jiraIssueToFrontmatter(
+            issue2,
+            jira.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, jira.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 jira = createJiraClient(jiraUserConfig);
+        if (!jira) return jiraNotConfiguredError();
+        const result = await jira.client.searchIssues(args.jql, args.maxResults);
+        const created = [];
+        const updated = [];
+        for (const issue2 of result.issues) {
+          const existing = findByJiraKey(store, issue2.key);
+          if (existing) {
+            const fm = jiraIssueToFrontmatter(
+              issue2,
+              jira.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, jira.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 jira = createJiraClient(jiraUserConfig);
+        if (!jira) 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 jira.client.createIssue({
+          project: { key: args.projectKey },
+          summary: artifact.frontmatter.title,
+          description,
+          issuetype: { name: args.issueType ?? "Task" }
+        });
+        const jiDoc = store.create(
+          JIRA_TYPE,
+          {
+            title: artifact.frontmatter.title,
+            status: "open",
+            jiraKey: jiraResult.key,
+            jiraUrl: `https://${jira.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 jira = createJiraClient(jiraUserConfig);
+        if (!jira) 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 jira.client.updateIssue(jiraKey, {
+          summary: doc.frontmatter.title,
+          description: doc.content || void 0
+        });
+        const issue2 = await jira.client.getIssue(jiraKey);
+        const fm = jiraIssueToFrontmatter(
+          issue2,
+          jira.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
 };
 function getBuiltinSkillsDir() {
   const thisFile = fileURLToPath(import.meta.url);
@@ -17330,7 +17921,7 @@ ${fragment}`);
 }
 
 // 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 } from "@anthropic-ai/claude-agent-sdk";
@@ -17420,7 +18011,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,
           {
@@ -17647,10 +18238,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.",
       {
@@ -17680,7 +18271,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.",
       {