mrvn-cli 0.5.11 → 0.5.12

package/dist/marvin-serve.js

@@ -15711,7 +15711,9 @@ function collectSprintSummaryData(store, sprintId) {
       workFocus: focusTag ? focusTag.slice(6) : void 0,
       aboutArtifact: about,
       jiraKey: doc.frontmatter.jiraKey,
-      jiraUrl: doc.frontmatter.jiraUrl
+      jiraUrl: doc.frontmatter.jiraUrl,
+      confluenceUrl: doc.frontmatter.confluenceUrl,
+      confluenceTitle: doc.frontmatter.confluenceTitle
     };
     allItemsById.set(item.id, item);
     if (about && sprintItemIds.has(about)) {
@@ -19026,11 +19028,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(path11, method = "GET", body) {
@@ -19118,6 +19123,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;
@@ -20178,6 +20207,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",
@@ -20488,6 +20622,8 @@ 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).
@@ -21188,11 +21324,30 @@ 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="jira-link"><svg class="jira-icon" viewBox="0 0 24 24" width="14" height="14" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="M12.005 2L6.5 7.505l5.505 5.505L17.51 7.505 12.005 2z" fill="#2684FF"/><path d="M6.5 7.505L1 13.01l5.505 5.505L12.01 13.01 6.5 7.505z" fill="url(#jira-g1)"/><path d="M17.51 7.505L12.005 13.01l5.505 5.505L23.015 13.01 17.51 7.505z" fill="url(#jira-g2)"/><path d="M12.005 13.01L6.5 18.515l5.505 5.505 5.505-5.505-5.505-5.505z" fill="#2684FF"/><defs><linearGradient id="jira-g1" x1="9.25" y1="7.51" x2="3.85" y2="12.91" gradientUnits="userSpaceOnUse"><stop stop-color="#0052CC"/><stop offset="1" stop-color="#2684FF"/></linearGradient><linearGradient id="jira-g2" x1="14.76" y1="7.51" x2="20.16" y2="12.91" gradientUnits="userSpaceOnUse"><stop stop-color="#0052CC"/><stop offset="1" stop-color="#2684FF"/></linearGradient></defs></svg></a>`;
+  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");
@@ -23059,17 +23214,22 @@ 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); }
 
-/* Jira link icon */
-.jira-link {
+/* 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;
 }
-.jira-link:hover { opacity: 1; }
-.jira-icon { vertical-align: middle; }
+.integration-link:hover { opacity: 1; }
+.integration-icon { vertical-align: middle; }
 
 /* Group header rows (PO dashboard decisions/deps) */
 .group-header-row td {
@@ -23095,7 +23255,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>${jiraIcon(doc.frontmatter.jiraKey, doc.frontmatter.jiraUrl)}</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>
@@ -23184,7 +23344,7 @@ function documentDetailPage(doc) {
     </div>
 
     <div class="page-header">
-      <h2>${escapeHtml(fm.title)}${jiraIcon(fm.jiraKey, fm.jiraUrl)}</h2>
+      <h2>${escapeHtml(fm.title)}${integrationIcons(fm)}</h2>
       <div class="subtitle">${escapeHtml(fm.id)} &middot; ${escapeHtml(label)}</div>
     </div>
 
@@ -24615,7 +24775,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)}${jiraIcon(w.jiraKey, w.jiraUrl)}</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>
@@ -26240,7 +26400,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)}${jiraIcon(doc.frontmatter.jiraKey, doc.frontmatter.jiraUrl)}</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>`