mrvn-cli 0.5.10 → 0.5.12

package/dist/index.js

@@ -15773,7 +15773,11 @@ function collectSprintSummaryData(store, sprintId) {
       progress: getEffectiveProgress(doc.frontmatter),
       owner: doc.frontmatter.owner,
       workFocus: focusTag ? focusTag.slice(6) : void 0,
-      aboutArtifact: about
+      aboutArtifact: about,
+      jiraKey: doc.frontmatter.jiraKey,
+      jiraUrl: doc.frontmatter.jiraUrl,
+      confluenceUrl: doc.frontmatter.confluenceUrl,
+      confluenceTitle: doc.frontmatter.confluenceTitle
     };
     allItemsById.set(item.id, item);
     if (about && sprintItemIds.has(about)) {
@@ -16284,6 +16288,31 @@ function formatDate(iso) {
 function typeLabel(type) {
   return type.replace(/-/g, " ").replace(/\b\w/g, (c) => c.toUpperCase());
 }
+var JIRA_SVG = `<svg class="integration-icon" viewBox="0 0 256 256" width="14" height="14" xmlns="http://www.w3.org/2000/svg"><defs><linearGradient id="jg1" x1="98.03%" y1="0.16%" x2="58.89%" y2="40.87%"><stop offset="18%" stop-color="#0052CC"/><stop offset="100%" stop-color="#2684FF"/></linearGradient><linearGradient id="jg2" x1="100.17%" y1="0.05%" x2="55.76%" y2="45.19%"><stop offset="18%" stop-color="#0052CC"/><stop offset="100%" stop-color="#2684FF"/></linearGradient></defs><path d="M244.658 0H121.707a55.502 55.502 0 0 0 55.502 55.502h22.649V77.37c.02 30.625 24.841 55.447 55.466 55.502V10.666C255.324 4.777 250.55 0 244.658 0z" fill="#2684FF"/><path d="M183.822 61.262H60.872c.019 30.625 24.84 55.447 55.466 55.502h22.649v21.868c.02 30.597 24.798 55.408 55.395 55.502V71.928c0-5.891-4.776-10.666-10.56-10.666z" fill="url(#jg1)"/><path d="M122.951 122.489H0c0 30.653 24.85 55.502 55.502 55.502h22.72v21.868c.02 30.597 24.798 55.408 55.396 55.502V133.155c0-5.891-4.776-10.666-10.667-10.666z" fill="url(#jg2)"/></svg>`;
+var CONFLUENCE_SVG = `<svg class="integration-icon" viewBox="0 0 256 246" width="14" height="14" xmlns="http://www.w3.org/2000/svg"><defs><linearGradient id="cg1" x1="99.14%" y1="113.9%" x2="33.86%" y2="37.96%"><stop offset="18%" stop-color="#0052CC"/><stop offset="100%" stop-color="#2684FF"/></linearGradient><linearGradient id="cg2" x1="0.86%" y1="-13.9%" x2="66.14%" y2="62.04%"><stop offset="18%" stop-color="#0052CC"/><stop offset="100%" stop-color="#2684FF"/></linearGradient></defs><path d="M9.26 187.28c-3.14 5.06-6.71 10.98-9.26 15.53a7.84 7.84 0 0 0 2.83 10.72l67.58 40.48a7.85 7.85 0 0 0 10.72-2.63c2.14-3.54 5.01-8.25 8.15-13.41 22.18-36.47 44.67-32.02 85.83-13.41l68.59 31.05a7.85 7.85 0 0 0 10.42-3.94l29.24-66.24a7.85 7.85 0 0 0-3.84-10.32c-20.53-9.27-61.49-27.75-87.33-39.45-72.2-32.73-133.87-30.05-182.93 51.62z" fill="url(#cg1)"/><path d="M246.11 58.24c3.14-5.06 6.71-10.98 9.26-15.53a7.84 7.84 0 0 0-2.83-10.72L184.96 0a7.85 7.85 0 0 0-10.72 2.63c-2.14 3.54-5.01 8.25-8.15 13.41-22.18 36.47-44.67 32.02-85.83 13.41L12.37 -1.6a7.85 7.85 0 0 0-10.42 3.94L-27.29 68.58a7.85 7.85 0 0 0 3.84 10.32c20.53 9.27 61.49 27.75 87.33 39.45 72.2 32.73 133.87 30.05 182.23-60.11z" fill="url(#cg2)"/></svg>`;
+function jiraIcon(jiraKey, jiraUrl) {
+  if (!jiraKey) return "";
+  const href = jiraUrl ?? "#";
+  const title = escapeHtml(jiraKey);
+  return `<a href="${escapeHtml(href)}" target="_blank" rel="noopener" title="Jira: ${title}" class="integration-link jira-link">${JIRA_SVG}</a>`;
+}
+function confluenceIcon(confluenceUrl, confluenceTitle) {
+  if (!confluenceUrl) return "";
+  const title = confluenceTitle ? escapeHtml(confluenceTitle) : "Confluence";
+  return `<a href="${escapeHtml(confluenceUrl)}" target="_blank" rel="noopener" title="${title}" class="integration-link confluence-link">${CONFLUENCE_SVG}</a>`;
+}
+function integrationIcons(frontmatter) {
+  const jira = jiraIcon(
+    frontmatter.jiraKey,
+    frontmatter.jiraUrl
+  );
+  const confluence = confluenceIcon(
+    frontmatter.confluenceUrl,
+    frontmatter.confluenceTitle
+  );
+  if (!jira && !confluence) return "";
+  return `<span class="integration-icons">${jira}${confluence}</span>`;
+}
 function renderMarkdown(md) {
   const lines = md.split("\n");
   const out = [];
@@ -18149,6 +18178,23 @@ tr:hover td {
 .owner-badge-dm { background: rgba(52, 211, 153, 0.18); color: #34d399; }
 .owner-badge-other { background: rgba(139, 143, 164, 0.12); color: var(--text-dim); }
 
+/* Integration icons (Jira, Confluence) */
+.integration-icons {
+  display: inline-flex;
+  align-items: center;
+  gap: 0.2rem;
+  vertical-align: middle;
+  margin-left: 0.35rem;
+}
+.integration-link {
+  display: inline-flex;
+  align-items: center;
+  opacity: 0.7;
+  transition: opacity 0.15s;
+}
+.integration-link:hover { opacity: 1; }
+.integration-icon { vertical-align: middle; }
+
 /* Group header rows (PO dashboard decisions/deps) */
 .group-header-row td {
   background: var(--bg-hover);
@@ -18173,7 +18219,7 @@ function documentsPage(data) {
     (doc) => `
         <tr>
           <td><a href="/docs/${data.type}/${doc.frontmatter.id}">${escapeHtml(doc.frontmatter.id)}</a></td>
-          <td><a href="/docs/${data.type}/${doc.frontmatter.id}">${escapeHtml(doc.frontmatter.title)}</a></td>
+          <td><a href="/docs/${data.type}/${doc.frontmatter.id}">${escapeHtml(doc.frontmatter.title)}</a>${integrationIcons(doc.frontmatter)}</td>
           <td>${statusBadge(doc.frontmatter.status)}</td>
           <td>${escapeHtml(doc.frontmatter.owner ?? "\u2014")}</td>
           <td>${doc.frontmatter.priority ? `<span class="priority-${doc.frontmatter.priority.toLowerCase()}">${escapeHtml(doc.frontmatter.priority)}</span>` : "\u2014"}</td>
@@ -18262,7 +18308,7 @@ function documentDetailPage(doc) {
     </div>
 
     <div class="page-header">
-      <h2>${escapeHtml(fm.title)}</h2>
+      <h2>${escapeHtml(fm.title)}${integrationIcons(fm)}</h2>
       <div class="subtitle">${escapeHtml(fm.id)} &middot; ${escapeHtml(label)}</div>
     </div>
 
@@ -19684,7 +19730,7 @@ function renderItemRows(items, borderColor, showOwner, depth = 0) {
     const row = `
               <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>${escapeHtml(w.title)}${jiraIcon(w.jiraKey, w.jiraUrl)}${confluenceIcon(w.confluenceUrl, w.confluenceTitle)}</td>
                 ${ownerCell}
                 <td>${statusBadge(w.status)}</td>
                 <td>${progressCell}</td>
@@ -21309,7 +21355,7 @@ function boardPage(data, basePath = "/board") {
           <div class="board-card">
             <a href="/docs/${doc.frontmatter.type}/${doc.frontmatter.id}">
               <div class="bc-id">${escapeHtml(doc.frontmatter.id)}</div>
-              <div class="bc-title">${escapeHtml(doc.frontmatter.title)}</div>
+              <div class="bc-title">${escapeHtml(doc.frontmatter.title)}${integrationIcons(doc.frontmatter)}</div>
               ${doc.frontmatter.owner ? `<div class="bc-owner">${escapeHtml(doc.frontmatter.owner)}</div>` : ""}
             </a>
           </div>`
@@ -24896,11 +24942,14 @@ import { tool as tool20 } from "@anthropic-ai/claude-agent-sdk";
 var JiraClient = class {
   baseUrl;
   baseUrlV3;
+  confluenceBaseUrl;
   authHeader;
+  host;
   constructor(config2) {
-    const host = config2.host.replace(/^https?:\/\//, "").replace(/\/+$/, "");
-    this.baseUrl = `https://${host}/rest/api/2`;
-    this.baseUrlV3 = `https://${host}/rest/api/3`;
+    this.host = config2.host.replace(/^https?:\/\//, "").replace(/\/+$/, "");
+    this.baseUrl = `https://${this.host}/rest/api/2`;
+    this.baseUrlV3 = `https://${this.host}/rest/api/3`;
+    this.confluenceBaseUrl = `https://${this.host}/wiki/api/v2`;
     this.authHeader = "Basic " + Buffer.from(`${config2.email}:${config2.apiToken}`).toString("base64");
   }
   async request(path21, method = "GET", body) {
@@ -24988,6 +25037,30 @@ var JiraClient = class {
       { body }
     );
   }
+  // --- Confluence methods ---
+  async getConfluencePage(pageId) {
+    return this.doRequest(
+      `${this.confluenceBaseUrl}/pages/${encodeURIComponent(pageId)}?body-format=atlas_doc_format`,
+      "GET"
+    );
+  }
+  /**
+   * Extract a Confluence page ID from various URL formats.
+   * Returns null if the URL doesn't match any known pattern.
+   */
+  static extractPageId(url2) {
+    const pagesMatch = url2.match(/\/pages\/(\d+)/);
+    if (pagesMatch) return pagesMatch[1];
+    const paramMatch = url2.match(/[?&]pageId=(\d+)/);
+    if (paramMatch) return paramMatch[1];
+    return null;
+  }
+  /**
+   * Build a web URL for a Confluence page.
+   */
+  getConfluencePageUrl(pageId) {
+    return `https://${this.host}/wiki/pages/viewpage.action?pageId=${pageId}`;
+  }
 };
 function createJiraClient(jiraUserConfig) {
   const host = jiraUserConfig?.host ?? process.env.JIRA_HOST;
@@ -25745,6 +25818,58 @@ function createJiraTools(store, projectConfig) {
       },
       { annotations: { readOnlyHint: true } }
     ),
+    // --- Jira search (read-only) ---
+    tool20(
+      "search_jira",
+      "Search Jira issues via JQL query. Read-only \u2014 returns results without creating any local documents. Use this to preview before importing or to find issues for linking.",
+      {
+        jql: external_exports.string().describe(`JQL query (e.g. 'project = PROJ AND status = "In Progress"')`),
+        maxResults: external_exports.number().optional().describe("Max issues to return (default 20)")
+      },
+      async (args) => {
+        const jira = createJiraClient(jiraUserConfig);
+        if (!jira) return jiraNotConfiguredError();
+        const result = await jira.client.searchIssuesV3(
+          args.jql,
+          ["summary", "status", "issuetype", "priority", "assignee", "labels"],
+          args.maxResults ?? 20
+        );
+        const allDocs = store.registeredTypes.flatMap((t) => store.list({ type: t }));
+        const jiraKeyToArtifact = /* @__PURE__ */ new Map();
+        for (const doc of allDocs) {
+          const jk = doc.frontmatter.jiraKey;
+          if (jk) jiraKeyToArtifact.set(jk, doc.frontmatter.id);
+        }
+        const issues = result.issues.map((issue2) => {
+          const marvinId = jiraKeyToArtifact.get(issue2.key);
+          return {
+            key: issue2.key,
+            summary: issue2.fields.summary,
+            status: issue2.fields.status.name,
+            issueType: issue2.fields.issuetype.name,
+            priority: issue2.fields.priority?.name ?? "None",
+            assignee: issue2.fields.assignee?.displayName ?? "unassigned",
+            labels: issue2.fields.labels ?? [],
+            marvinArtifact: marvinId ?? null
+          };
+        });
+        const parts = [
+          `Found ${result.total ?? issues.length} issues (showing ${issues.length}).`,
+          ""
+        ];
+        for (const issue2 of issues) {
+          const linked = issue2.marvinArtifact ? ` \u2192 ${issue2.marvinArtifact}` : " (not linked)";
+          parts.push(`${issue2.key} \u2014 ${issue2.summary} [${issue2.status}]${linked}`);
+          parts.push(`  Type: ${issue2.issueType} | Priority: ${issue2.priority} | Assignee: ${issue2.assignee}`);
+        }
+        parts.push("");
+        parts.push("This is read-only. Use link_to_jira to link issues to Marvin artifacts, or pull_jira_issue to import as JI-xxx documents.");
+        return {
+          content: [{ type: "text", text: parts.join("\n") }]
+        };
+      },
+      { annotations: { readOnlyHint: true } }
+    ),
     // --- Jira → Local tools ---
     tool20(
       "pull_jira_issue",
@@ -26036,6 +26161,111 @@ function createJiraTools(store, projectConfig) {
         };
       }
     ),
+    // --- Confluence tools ---
+    tool20(
+      "link_to_confluence",
+      "Link a Confluence page to any Marvin artifact. Validates the page exists and fetches its title.",
+      {
+        artifactId: external_exports.string().describe("Marvin artifact ID (e.g. 'D-001', 'A-003', 'T-002')"),
+        confluenceUrl: external_exports.string().describe("Confluence page URL")
+      },
+      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 pageId = JiraClient.extractPageId(args.confluenceUrl);
+        if (!pageId) {
+          return {
+            content: [
+              { type: "text", text: `Could not extract page ID from URL: ${args.confluenceUrl}` }
+            ],
+            isError: true
+          };
+        }
+        const page = await jira.client.getConfluencePage(pageId);
+        const existingTags = artifact.frontmatter.tags ?? [];
+        store.update(args.artifactId, {
+          confluenceUrl: args.confluenceUrl,
+          confluencePageId: pageId,
+          confluenceTitle: page.title,
+          tags: [...existingTags.filter((t) => !t.startsWith("confluence:")), `confluence:${page.title}`]
+        });
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Linked ${args.artifactId} to Confluence page "${page.title}" (ID: ${pageId}).`
+            }
+          ]
+        };
+      }
+    ),
+    tool20(
+      "read_confluence_page",
+      "Read the content of a Confluence page by URL or page ID. Returns the page title, metadata, and body as plain text.",
+      {
+        pageUrl: external_exports.string().optional().describe("Confluence page URL"),
+        pageId: external_exports.string().optional().describe("Confluence page ID (alternative to URL)")
+      },
+      async (args) => {
+        const jira = createJiraClient(jiraUserConfig);
+        if (!jira) return jiraNotConfiguredError();
+        const resolvedId = args.pageId ?? (args.pageUrl ? JiraClient.extractPageId(args.pageUrl) : null);
+        if (!resolvedId) {
+          return {
+            content: [
+              {
+                type: "text",
+                text: "Provide either pageUrl or pageId. Could not extract page ID from the given URL."
+              }
+            ],
+            isError: true
+          };
+        }
+        const page = await jira.client.getConfluencePage(resolvedId);
+        let bodyText = "";
+        if (page.body?.atlas_doc_format?.value) {
+          try {
+            const adf = JSON.parse(page.body.atlas_doc_format.value);
+            bodyText = extractCommentText(adf);
+          } catch {
+            bodyText = page.body.atlas_doc_format.value;
+          }
+        }
+        const parts = [
+          `# ${page.title}`,
+          "",
+          `Page ID: ${page.id}`,
+          `Status: ${page.status}`,
+          `Version: ${page.version.number} (${page.version.createdAt.slice(0, 10)})`,
+          "",
+          "---",
+          "",
+          bodyText || "(empty page)"
+        ];
+        const allDocs = store.registeredTypes.flatMap((t) => store.list({ type: t }));
+        const linkedArtifacts = allDocs.filter(
+          (d) => d.frontmatter.confluencePageId === resolvedId || d.frontmatter.confluenceUrl === args.pageUrl
+        );
+        if (linkedArtifacts.length > 0) {
+          parts.push("");
+          parts.push("---");
+          parts.push(`Linked Marvin artifacts: ${linkedArtifacts.map((d) => d.frontmatter.id).join(", ")}`);
+        }
+        return {
+          content: [{ type: "text", text: parts.join("\n") }]
+        };
+      },
+      { annotations: { readOnlyHint: true } }
+    ),
     // --- Jira status fetch (read-only) ---
     tool20(
       "fetch_jira_status",
@@ -26346,9 +26576,12 @@ function formatIssueEntry(issue2) {
 var COMMON_TOOLS = `**Available tools:**
 - \`push_artifact_to_jira\` \u2014 create a Jira issue from any Marvin artifact and link it directly via \`jiraKey\` on the artifact.
 - \`link_to_jira\` \u2014 link an existing Jira issue to any Marvin artifact (sets \`jiraKey\` directly on the artifact).
+- \`link_to_confluence\` \u2014 link a Confluence page to any Marvin artifact. Validates the page exists and fetches its title.
+- \`read_confluence_page\` \u2014 **read-only**: fetch and return the content of a Confluence page by URL or page ID. Use this to review Confluence content for updating tasks, generating contributions, or answering questions.
 - \`fetch_jira_status\` \u2014 **read-only**: fetch current Jira status, subtask progress, and linked issues for Jira-linked actions/tasks. Returns proposed changes without applying them.
 - \`fetch_jira_daily\` \u2014 **read-only**: fetch a daily/range summary of all Jira changes \u2014 status transitions, comments, linked Confluence pages, and cross-references with Marvin artifacts. Returns proposed actions (status updates, unlinked issues, question candidates, Confluence pages to review).
 - \`fetch_jira_statuses\` \u2014 **read-only**: discover all Jira statuses in a project and show their Marvin mappings (mapped vs unmapped).
+- \`search_jira\` \u2014 **read-only**: search Jira via JQL and return results with Marvin cross-references. No documents created \u2014 use to preview before importing or find issues for linking.
 - \`pull_jira_issue\` / \`pull_jira_issues_jql\` \u2014 import Jira issues as local JI-xxx documents (for Jira-originated items with no existing Marvin artifact).
 - \`list_jira_issues\` / \`get_jira_issue\` \u2014 browse locally imported JI-xxx documents.
 - \`sync_jira_issue\` \u2014 bidirectional sync of a local JI-xxx with Jira.
@@ -31875,7 +32108,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.5.10");
+  ).version("0.5.12");
   program.command("init").description("Initialize a new Marvin project in the current directory").action(async () => {
     await initCommand();
   });