mrvn-cli 0.5.9 → 0.5.11

package/dist/marvin-serve.js

@@ -15709,7 +15709,9 @@ 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
     };
     allItemsById.set(item.id, item);
     if (about && sprintItemIds.has(about)) {
@@ -19833,6 +19835,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",
@@ -19931,7 +19985,7 @@ function createJiraTools(store, projectConfig) {
     // --- Local → Jira tools ---
     tool20(
       "push_artifact_to_jira",
-      "Create a Jira issue from a Marvin artifact. For actions/tasks, links directly via jiraKey on the artifact. For other types, creates a JI-xxx tracking document.",
+      "Create a Jira issue from any Marvin artifact and link it directly via jiraKey on the artifact.",
       {
         artifactId: external_exports.string().describe("Marvin artifact ID (e.g. 'D-001', 'A-003', 'T-002')"),
         projectKey: external_exports.string().optional().describe("Jira project key (e.g. 'PROJ'). Falls back to jira.projectKey from .marvin/config.yaml if not provided."),
@@ -19974,46 +20028,18 @@ function createJiraTools(store, projectConfig) {
           description,
           issuetype: { name: args.issueType ?? "Task" }
         });
-        const isDirectLink = artifact.frontmatter.type === "action" || artifact.frontmatter.type === "task";
-        if (isDirectLink) {
-          const existingTags = artifact.frontmatter.tags ?? [];
-          store.update(args.artifactId, {
-            jiraKey: jiraResult.key,
-            jiraUrl: `https://${jira.host}/browse/${jiraResult.key}`,
-            lastJiraSyncAt: (/* @__PURE__ */ new Date()).toISOString(),
-            tags: [...existingTags.filter((t) => !t.startsWith("jira:")), `jira:${jiraResult.key}`]
-          });
-          return {
-            content: [
-              {
-                type: "text",
-                text: `Created Jira ${jiraResult.key} from ${args.artifactId}. Linked directly on the artifact.`
-              }
-            ]
-          };
-        }
-        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()
-          },
-          ""
-        );
+        const existingTags = artifact.frontmatter.tags ?? [];
+        store.update(args.artifactId, {
+          jiraKey: jiraResult.key,
+          jiraUrl: `https://${jira.host}/browse/${jiraResult.key}`,
+          lastJiraSyncAt: (/* @__PURE__ */ new Date()).toISOString(),
+          tags: [...existingTags.filter((t) => !t.startsWith("jira:")), `jira:${jiraResult.key}`]
+        });
         return {
           content: [
             {
               type: "text",
-              text: `Created Jira ${jiraResult.key} from ${args.artifactId}. Tracking locally as ${jiDoc.frontmatter.id}.`
+              text: `Created Jira ${jiraResult.key} from ${args.artifactId}. Linked directly on the artifact.`
             }
           ]
         };
@@ -20117,9 +20143,9 @@ function createJiraTools(store, projectConfig) {
     // --- Direct Jira linking for actions/tasks ---
     tool20(
       "link_to_jira",
-      "Link an existing Jira issue to a Marvin action or task (sets jiraKey directly on the artifact)",
+      "Link an existing Jira issue to any Marvin artifact (sets jiraKey directly on the artifact)",
       {
-        artifactId: external_exports.string().describe("Marvin artifact ID (e.g. 'A-001', 'T-003')"),
+        artifactId: external_exports.string().describe("Marvin artifact ID (e.g. 'A-001', 'D-003', 'T-002', 'Q-005')"),
         jiraKey: external_exports.string().describe("Jira issue key (e.g. 'PROJ-123')")
       },
       async (args) => {
@@ -20134,17 +20160,6 @@ function createJiraTools(store, projectConfig) {
             isError: true
           };
         }
-        if (artifact.frontmatter.type !== "action" && artifact.frontmatter.type !== "task") {
-          return {
-            content: [
-              {
-                type: "text",
-                text: `link_to_jira only supports action and task artifacts. ${args.artifactId} is type "${artifact.frontmatter.type}". Use link_artifact_to_jira for JI-xxx documents instead.`
-              }
-            ],
-            isError: true
-          };
-        }
         const issue2 = await jira.client.getIssue(args.jiraKey);
         const existingTags = artifact.frontmatter.tags ?? [];
         store.update(args.artifactId, {
@@ -20471,15 +20486,16 @@ function formatIssueEntry(issue2) {
 
 // src/skills/builtin/jira/index.ts
 var COMMON_TOOLS = `**Available tools:**
-- \`list_jira_issues\` / \`get_jira_issue\` \u2014 browse locally synced Jira issues (JI-xxx documents)
-- \`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. For **actions and tasks**, links directly via \`jiraKey\` on the artifact (no JI-xxx intermediary). For other types, creates a JI-xxx tracking document.
-- \`link_to_jira\` \u2014 link an existing Jira issue to a Marvin action or task (sets \`jiraKey\` directly on the artifact)
+- \`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).
 - \`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).
-- \`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`;
+- \`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.
+- \`link_artifact_to_jira\` \u2014 link a Marvin artifact to an existing JI-xxx document.`;
 var COMMON_WORKFLOW = `**Jira sync workflow:**
 1. Call \`fetch_jira_status\` to see what Jira reports for linked artifacts
 2. Analyze the proposed changes (status transitions, subtask progress, blockers from linked issues)
@@ -21172,6 +21188,12 @@ function formatDate(iso) {
 function typeLabel(type) {
   return type.replace(/-/g, " ").replace(/\b\w/g, (c) => c.toUpperCase());
 }
+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>`;
+}
 function renderMarkdown(md) {
   const lines = md.split("\n");
   const out = [];
@@ -23037,6 +23059,18 @@ 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 {
+  display: inline-flex;
+  align-items: center;
+  vertical-align: middle;
+  margin-left: 0.35rem;
+  opacity: 0.7;
+  transition: opacity 0.15s;
+}
+.jira-link:hover { opacity: 1; }
+.jira-icon { vertical-align: middle; }
+
 /* Group header rows (PO dashboard decisions/deps) */
 .group-header-row td {
   background: var(--bg-hover);
@@ -23061,7 +23095,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>${jiraIcon(doc.frontmatter.jiraKey, doc.frontmatter.jiraUrl)}</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>
@@ -23150,7 +23184,7 @@ function documentDetailPage(doc) {
     </div>
 
     <div class="page-header">
-      <h2>${escapeHtml(fm.title)}</h2>
+      <h2>${escapeHtml(fm.title)}${jiraIcon(fm.jiraKey, fm.jiraUrl)}</h2>
       <div class="subtitle">${escapeHtml(fm.id)} &middot; ${escapeHtml(label)}</div>
     </div>
 
@@ -24581,7 +24615,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)}</td>
                 ${ownerCell}
                 <td>${statusBadge(w.status)}</td>
                 <td>${progressCell}</td>
@@ -26206,7 +26240,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)}${jiraIcon(doc.frontmatter.jiraKey, doc.frontmatter.jiraUrl)}</div>
               ${doc.frontmatter.owner ? `<div class="bc-owner">${escapeHtml(doc.frontmatter.owner)}</div>` : ""}
             </a>
           </div>`
@@ -28112,22 +28146,22 @@ ${block.text}` };
 function collectTools(marvinDir) {
   const config2 = loadProjectConfig(marvinDir);
   const plugin = resolvePlugin(config2.methodology);
-  const registrations = plugin?.documentTypeRegistrations ?? [];
-  const store = new DocumentStore(marvinDir, registrations);
+  const pluginRegistrations = plugin?.documentTypeRegistrations ?? [];
+  const allSkills = loadAllSkills(marvinDir);
+  const allSkillIds = [...allSkills.keys()];
+  const allSkillRegs = collectSkillRegistrations(allSkillIds, allSkills);
+  const store = new DocumentStore(marvinDir, [...pluginRegistrations, ...allSkillRegs]);
   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 sessionStore = new SessionStore(marvinDir);
-  const allSkills = loadAllSkills(marvinDir);
-  const allSkillIds = [...allSkills.keys()];
   const codeSkillTools = getSkillTools(allSkillIds, allSkills, store, config2);
   const skillsWithActions = allSkillIds.map((id) => allSkills.get(id)).filter((s) => s.actions && s.actions.length > 0);
   const projectRoot = path9.dirname(marvinDir);
   const actionTools = createSkillActionTools(skillsWithActions, { store, marvinDir, projectRoot });
-  const allSkillRegs = collectSkillRegistrations(allSkillIds, allSkills);
   const navGroups = buildNavGroups({
-    pluginRegs: registrations,
+    pluginRegs: pluginRegistrations,
     skillRegs: allSkillRegs,
     pluginName: plugin?.name
   });