@codazen/harmonica-mcp 5.1.0 → 5.2.0

package/dist/index.js

@@ -22480,20 +22480,30 @@ var POLL_MAX_CONSECUTIVE_ERRORS = 3;
 async function pollForCheck(client, taskId) {
   const deadline = Date.now() + POLL_TIMEOUT_MS;
   let consecutiveErrors = 0;
+  let consecutiveMissing = 0;
   while (Date.now() < deadline) {
     const [task, err] = await client.getTask(taskId).then(
       (t) => [t, null],
       (e) => [null, e]
     );
     if (err) {
+      consecutiveMissing = 0;
       consecutiveErrors++;
       if (consecutiveErrors >= POLL_MAX_CONSECUTIVE_ERRORS)
         throw new Error(`getTask failed ${consecutiveErrors} consecutive times: ${err instanceof Error ? err.message : String(err)}`);
       await new Promise((r) => setTimeout(r, POLL_INTERVAL_MS));
       continue;
     }
+    if (!task) {
+      consecutiveErrors = 0;
+      consecutiveMissing++;
+      if (consecutiveMissing >= POLL_MAX_CONSECUTIVE_ERRORS)
+        throw new Error(`Task ${taskId} not found after ${consecutiveMissing} consecutive attempts`);
+      await new Promise((r) => setTimeout(r, POLL_INTERVAL_MS));
+      continue;
+    }
     consecutiveErrors = 0;
-    if (!task) throw new Error(`Task ${taskId} not found`);
+    consecutiveMissing = 0;
     if (task.status === "completed") {
       if (!task.result) throw new CheckResultPendingError(taskId);
       return task.result;
@@ -22801,6 +22811,18 @@ ${revision.description}`);
   }
   return sections.join("\n");
 }
+function formatRevisionPreview(revisionId, preview) {
+  if (!preview) return `No preview recorded for revision: ${revisionId}`;
+  const freshness = preview.isCurrent ? "Current \u2014 built from the head commit." : `Stale \u2014 built from ${preview.commitSha?.slice(0, 7) ?? "an unknown commit"}, which is no longer the head. Still opens.`;
+  return [
+    `# Preview: ${revisionId}`,
+    `**URL:** ${preview.url}`,
+    `**Built from:** ${preview.commitSha}`,
+    `**Recorded:** ${preview.recordedAt}`,
+    `
+${freshness}`
+  ].join("\n");
+}
 
 // ../../libs/harmonica-services/src/mcp/formatters/note-formatter.ts
 var TYPE_LABELS = {
@@ -23309,6 +23331,26 @@ ${formatDeliveryPolicy(
       }
     }
   );
+  server.tool(
+    "get_revision_preview",
+    "Get the preview link recorded for a Revision \u2014 the running environment its own pipeline published, and whether that build is still the pull request's head. A Revision with no recorded preview is reported plainly, not as an error: one whose change artifact is a document never gets one. A stale link still opens; it was built before the latest commit.",
+    {
+      revisionId: external_exports.string().describe("The revision ID (e.g., rev-abc123)")
+    },
+    async ({ revisionId }) => {
+      try {
+        const revision = await client.getRevision(revisionId);
+        if (!revision) {
+          return { content: [{ type: "text", text: `Revision not found: ${revisionId}` }], isError: true };
+        }
+        const preview = await client.resolveRevisionPreview(revisionId);
+        return { content: [{ type: "text", text: formatRevisionPreview(revisionId, preview) }] };
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { content: [{ type: "text", text: `Failed to get revision preview: ${message}` }], isError: true };
+      }
+    }
+  );
 }
 async function logBeatActivity(client, params) {
   try {
@@ -24227,12 +24269,14 @@ var POLL_MAX_CONSECUTIVE_ERRORS2 = 3;
 async function pollForCheck2(client, taskId) {
   const deadline = Date.now() + POLL_TIMEOUT_MS2;
   let consecutiveErrors = 0;
+  let consecutiveMissing = 0;
   while (Date.now() < deadline) {
     const [task, err] = await client.getTask(taskId).then(
       (t) => [t, null],
       (e) => [null, e]
     );
     if (err) {
+      consecutiveMissing = 0;
       consecutiveErrors++;
       if (consecutiveErrors >= POLL_MAX_CONSECUTIVE_ERRORS2) {
         throw new Error(`getTask failed ${consecutiveErrors} times: ${err instanceof Error ? err.message : String(err)}`);
@@ -24240,8 +24284,16 @@ async function pollForCheck2(client, taskId) {
       await new Promise((r) => setTimeout(r, POLL_INTERVAL_MS2));
       continue;
     }
+    if (!task) {
+      consecutiveErrors = 0;
+      consecutiveMissing++;
+      if (consecutiveMissing >= POLL_MAX_CONSECUTIVE_ERRORS2)
+        throw new Error(`Task ${taskId} not found after ${consecutiveMissing} consecutive attempts`);
+      await new Promise((r) => setTimeout(r, POLL_INTERVAL_MS2));
+      continue;
+    }
     consecutiveErrors = 0;
-    if (!task) throw new Error(`Task ${taskId} not found`);
+    consecutiveMissing = 0;
     if (task.status === "completed") {
       if (!task.result) throw new CheckResultPendingError(taskId);
       return task.result;
@@ -25344,6 +25396,14 @@ var RevisionScmSchema = external_exports.object({
   state: external_exports.enum(["draft", "open", "merged", "closed"]),
   mergeSha: external_exports.string().optional()
 });
+var RevisionPreviewSchema = external_exports.object({
+  url: external_exports.string(),
+  commitSha: external_exports.string(),
+  recordedAt: external_exports.string()
+});
+var RevisionPreviewApiSchema = RevisionPreviewSchema.extend({
+  isCurrent: external_exports.boolean()
+});
 var RevisionApiSchema = external_exports.object({
   revisionId: external_exports.string(),
   beatId: external_exports.string(),
@@ -28362,7 +28422,7 @@ ${formatTree(tree.root)}` }] };
   );
   server.tool(
     "update_notebook_collection",
-    "Reconfigure a placed live-collection section in place \u2014 change what it collects (note type, project scope, limit, order, significance tier) or its heading, without removing and re-adding it. Only the fields you pass change; the rest keep their current values. Identify the section by its elementId (from get_notebook_tree) and the page it sits on.",
+    "Reconfigure a placed live-collection section in place \u2014 change what it collects (note type, system scope, limit, order, significance tier) or its heading, without removing and re-adding it. Only the fields you pass change; the rest keep their current values. Identify the section by its elementId (from get_notebook_tree) and the page it sits on.",
     {
       notebookId: external_exports.string().describe("The Notebook ID"),
       elementId: external_exports.string().describe("The collection section's elementId (from get_notebook_tree)"),
@@ -28503,9 +28563,9 @@ ${scopeText}` }] };
   );
   server.tool(
     "list_notebooks",
-    "List Notebooks reachable from a scope (org, teamspace, or system). Returns all notebooks bound to that scope.",
+    "List Notebooks reachable from a scope (org, teamspace, system, or account). Returns all notebooks bound to that scope.",
     {
-      scopeType: external_exports.enum(SCOPE_TYPE_VALUES).describe("Scope type \u2014 org, teamspace, or project"),
+      scopeType: external_exports.enum(SCOPE_TYPE_VALUES).describe("Scope type \u2014 org, teamspace, system, or account"),
       scopeId: external_exports.string().min(1).describe("ID of the scope entity"),
       includeArchived: external_exports.boolean().optional().describe("Include archived Notebooks in the results. Default: false (archived excluded).")
     },
@@ -28566,10 +28626,10 @@ ${formatNotebook(updated)}` }] };
   );
   server.tool(
     "add_notebook_shortcut",
-    "Add a curated, read-only shortcut from a scope (org, teamspace, project, or account) to a Notebook owned elsewhere in the SAME organization. Unlike set_notebook_scopes, a shortcut grants no rename/archive/delete rights over the Notebook in the consuming scope \u2014 it is a link, not ownership.",
+    "Add a curated, read-only shortcut from a scope (org, teamspace, system, or account) to a Notebook owned elsewhere in the SAME organization. Unlike set_notebook_scopes, a shortcut grants no rename/archive/delete rights over the Notebook in the consuming scope \u2014 it is a link, not ownership.",
     {
       notebookId: external_exports.string().describe("The Notebook ID to shortcut"),
-      scopeType: external_exports.enum(SCOPE_TYPE_VALUES).describe("Consuming scope type \u2014 org, teamspace, project, or account"),
+      scopeType: external_exports.enum(SCOPE_TYPE_VALUES).describe("Consuming scope type \u2014 org, teamspace, system, or account"),
       scopeId: external_exports.string().min(1).describe("ID of the consuming scope entity"),
       createdBy: external_exports.string().optional().describe("Actor ID \u2014 defaults to the session user")
     },
@@ -28598,7 +28658,7 @@ ${formatNotebook(updated)}` }] };
     "Remove a Notebook shortcut from a scope. Only removes the shortcut reference \u2014 never affects the source Notebook or its real scope bindings.",
     {
       notebookId: external_exports.string().describe("The Notebook ID"),
-      scopeType: external_exports.enum(SCOPE_TYPE_VALUES).describe("Consuming scope type \u2014 org, teamspace, project, or account"),
+      scopeType: external_exports.enum(SCOPE_TYPE_VALUES).describe("Consuming scope type \u2014 org, teamspace, system, or account"),
       scopeId: external_exports.string().min(1).describe("ID of the consuming scope entity")
     },
     async ({ notebookId, scopeType, scopeId }) => {
@@ -28621,7 +28681,7 @@ ${formatNotebook(updated)}` }] };
     "list_notebook_shortcuts",
     "List a scope\u2019s curated Notebook shortcuts \u2014 Notebooks owned elsewhere in the org that this scope has chosen to surface, hydrated with each source Notebook\u2019s live title/status.",
     {
-      scopeType: external_exports.enum(SCOPE_TYPE_VALUES).describe("Scope type \u2014 org, teamspace, project, or account"),
+      scopeType: external_exports.enum(SCOPE_TYPE_VALUES).describe("Scope type \u2014 org, teamspace, system, or account"),
       scopeId: external_exports.string().min(1).describe("ID of the scope entity")
     },
     async ({ scopeType, scopeId }) => {
@@ -28976,12 +29036,14 @@ var ROOT_CODA_POLL_MAX_CONSECUTIVE_ERRORS = 3;
 async function pollForRootCodaCheck(client, taskId) {
   const deadline = Date.now() + ROOT_CODA_POLL_TIMEOUT_MS;
   let consecutiveErrors = 0;
+  let consecutiveMissing = 0;
   while (Date.now() < deadline) {
     const [task, err] = await client.getTask(taskId).then(
       (t) => [t, null],
       (e) => [null, e]
     );
     if (err) {
+      consecutiveMissing = 0;
       consecutiveErrors++;
       if (consecutiveErrors >= ROOT_CODA_POLL_MAX_CONSECUTIVE_ERRORS) {
         throw new Error(`getTask failed ${consecutiveErrors} times: ${err instanceof Error ? err.message : String(err)}`);
@@ -28989,8 +29051,16 @@ async function pollForRootCodaCheck(client, taskId) {
       await new Promise((r) => setTimeout(r, ROOT_CODA_POLL_INTERVAL_MS));
       continue;
     }
+    if (!task) {
+      consecutiveErrors = 0;
+      consecutiveMissing++;
+      if (consecutiveMissing >= ROOT_CODA_POLL_MAX_CONSECUTIVE_ERRORS)
+        throw new Error(`Task ${taskId} not found after ${consecutiveMissing} consecutive attempts`);
+      await new Promise((r) => setTimeout(r, ROOT_CODA_POLL_INTERVAL_MS));
+      continue;
+    }
     consecutiveErrors = 0;
-    if (!task) throw new Error(`Task ${taskId} not found`);
+    consecutiveMissing = 0;
     if (task.status === "completed") {
       if (!task.result) throw new CheckResultPendingError(taskId);
       const result = task.result;
@@ -29333,12 +29403,14 @@ var POLL_MAX_CONSECUTIVE_ERRORS4 = 3;
 async function pollForCheck4(client, taskId) {
   const deadline = Date.now() + POLL_TIMEOUT_MS4;
   let consecutiveErrors = 0;
+  let consecutiveMissing = 0;
   while (Date.now() < deadline) {
     const [task, err] = await client.getTask(taskId).then(
       (t) => [t, null],
       (e) => [null, e]
     );
     if (err) {
+      consecutiveMissing = 0;
       consecutiveErrors++;
       if (consecutiveErrors >= POLL_MAX_CONSECUTIVE_ERRORS4) {
         throw new Error(`getTask failed ${consecutiveErrors} times: ${err instanceof Error ? err.message : String(err)}`);
@@ -29346,8 +29418,16 @@ async function pollForCheck4(client, taskId) {
       await new Promise((r) => setTimeout(r, POLL_INTERVAL_MS4));
       continue;
     }
+    if (!task) {
+      consecutiveErrors = 0;
+      consecutiveMissing++;
+      if (consecutiveMissing >= POLL_MAX_CONSECUTIVE_ERRORS4)
+        throw new Error(`Task ${taskId} not found after ${consecutiveMissing} consecutive attempts`);
+      await new Promise((r) => setTimeout(r, POLL_INTERVAL_MS4));
+      continue;
+    }
     consecutiveErrors = 0;
-    if (!task) throw new Error(`Task ${taskId} not found`);
+    consecutiveMissing = 0;
     if (task.status === "completed") {
       if (!task.result) throw new CheckResultPendingError(taskId);
       return task.result;
@@ -33664,6 +33744,8 @@ function createHttpClient(config2) {
       return { revision: result.revision, warnings: result.warnings ?? [] };
     },
     getRevision: (revisionId) => request("GET", `/api/revisions/${encodeURIComponent(revisionId)}`),
+    // `request` maps 404 to undefined, which is what absence must be here.
+    resolveRevisionPreview: (revisionId) => request("GET", `/api/revisions/${encodeURIComponent(revisionId)}/preview`),
     listConceptRevisions: async (systemId, options) => {
       const qs = options?.includeArchived ? "?includeArchived=true" : "";
       const result = await request("GET", `/api/systems/${encodeURIComponent(systemId)}/revisions/pending${qs}`);
@@ -35471,7 +35553,7 @@ function loadConfig() {
   };
 }
 async function main() {
-  console.error(`[harmonica-mcp] v${"5.1.0"} starting\u2026`);
+  console.error(`[harmonica-mcp] v${"5.2.0"} starting\u2026`);
   const config2 = loadConfig();
   const client = createHttpClient({
     apiBaseUrl: config2.apiBaseUrl,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codazen/harmonica-mcp",
-  "version": "5.1.0",
+  "version": "5.2.0",
   "description": "MCP server for Harmonica — connect any MCP-compatible AI assistant to Harmonica",
   "license": "MIT",
   "bin": {