@codazen/harmonica-mcp 5.0.0 → 5.2.0

package/dist/index.js

@@ -22032,22 +22032,33 @@ function registerAuditIntegrityTools(server, ctx, client) {
   );
 }
 
-// ../../libs/harmonica-services/src/mcp/tools/bar-tools.ts
+// ../../libs/harmonica-services/src/tool-schemas/bar.ts
 var BAR_STATUSES = ["open", "closed"];
 var idSegmentSchema = external_exports.string().min(1).max(128).refine((id) => !id.includes("#"), {
   message: "must not contain '#' \u2014 it is a DynamoDB key delimiter"
 });
+var create_bar = {
+  accountId: idSegmentSchema.describe("The Account ID this Bar belongs to"),
+  barId: idSegmentSchema.describe(
+    'Caller-supplied Bar ID (must not contain "#")'
+  ),
+  startDate: external_exports.string().datetime().describe("ISO 8601 start of the planning period"),
+  endDate: external_exports.string().datetime().describe("ISO 8601 end of the planning period; must be after startDate"),
+  status: external_exports.enum(BAR_STATUSES).optional().describe('Defaults to "open"')
+};
+var get_bar = {
+  barId: idSegmentSchema.describe("The Bar ID")
+};
+var list_account_bars = {
+  accountId: idSegmentSchema.describe("The Account ID")
+};
+
+// ../../libs/harmonica-services/src/mcp/tools/bar-tools.ts
 function registerBarTools(server, _ctx, client) {
   server.tool(
     "create_bar",
     "Create a Bar \u2014 the recurring planning-period time-box a client Account plans and delivers within (e.g. one or two weeks). Bars are Account-scoped and independent of any CadenceConfig already set on the Account; the caller supplies explicit start/end dates.",
-    {
-      accountId: idSegmentSchema.describe("The Account ID this Bar belongs to"),
-      barId: idSegmentSchema.describe('Caller-supplied Bar ID (must not contain "#")'),
-      startDate: external_exports.string().datetime().describe("ISO 8601 start of the planning period"),
-      endDate: external_exports.string().datetime().describe("ISO 8601 end of the planning period; must be after startDate"),
-      status: external_exports.enum(BAR_STATUSES).optional().describe('Defaults to "open"')
-    },
+    create_bar,
     async ({ accountId, barId, startDate, endDate, status }) => {
       const startMs = new Date(startDate).getTime();
       const endMs = new Date(endDate).getTime();
@@ -22077,9 +22088,7 @@ function registerBarTools(server, _ctx, client) {
   server.tool(
     "get_bar",
     "Get a Bar by ID.",
-    {
-      barId: idSegmentSchema.describe("The Bar ID")
-    },
+    get_bar,
     async ({ barId }) => {
       try {
         const bar = await client.getBar(barId);
@@ -22098,28 +22107,28 @@ function registerBarTools(server, _ctx, client) {
       }
     }
   );
-  server.tool(
-    "list_account_bars",
-    "List an Account's Bars, chronological by start date.",
-    {
-      accountId: idSegmentSchema.describe("The Account ID")
-    },
-    async ({ accountId }) => {
-      try {
-        const bars = await client.listAccountBars(accountId);
-        if (bars === void 0) {
-          return { content: [{ type: "text", text: `Account not found: ${accountId}` }], isError: true };
-        }
-        if (bars.length === 0) {
-          return { content: [{ type: "text", text: "No bars found." }] };
+  for (const name of ["list_account_bars", "list_bars"]) {
+    server.tool(
+      name,
+      "List an Account's Bars, chronological by start date.",
+      list_account_bars,
+      async ({ accountId }) => {
+        try {
+          const bars = await client.listAccountBars(accountId);
+          if (bars === void 0) {
+            return { content: [{ type: "text", text: `Account not found: ${accountId}` }], isError: true };
+          }
+          if (bars.length === 0) {
+            return { content: [{ type: "text", text: "No bars found." }] };
+          }
+          const text = bars.map((b) => `${b.barId} ${b.startDate} \u2192 ${b.endDate} \u2014 ${b.status}`).join("\n");
+          return { content: [{ type: "text", text }] };
+        } catch (err) {
+          return { content: [{ type: "text", text: `Failed to list bars: ${err instanceof Error ? err.message : String(err)}` }], isError: true };
         }
-        const text = bars.map((b) => `${b.barId} ${b.startDate} \u2192 ${b.endDate} \u2014 ${b.status}`).join("\n");
-        return { content: [{ type: "text", text }] };
-      } catch (err) {
-        return { content: [{ type: "text", text: `Failed to list bars: ${err instanceof Error ? err.message : String(err)}` }], isError: true };
       }
-    }
-  );
+    );
+  }
 }
 
 // ../../libs/harmonica-services/src/mcp/tools/baseline-tools.ts
@@ -22471,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;
@@ -22792,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 = {
@@ -23300,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 {
@@ -24218,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)}`);
@@ -24231,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;
@@ -25212,6 +25273,41 @@ var BeatDraftSuggestionSchema = external_exports.object({
 });
 var BeatDraftSuggestionsSchema = external_exports.array(BeatDraftSuggestionSchema);
 
+// ../../libs/harmonica-schemas/src/progress-evidence.ts
+var ProgressEvidenceQuerySchema = external_exports.object({
+  start: external_exports.string().min(1).max(40),
+  end: external_exports.string().min(1).max(40),
+  timezone: external_exports.string().min(1).max(100),
+  contributor: external_exports.string().trim().min(1).max(256).optional(),
+  limit: external_exports.coerce.number().int().min(1).max(100).optional(),
+  cursor: external_exports.string().min(1).max(4096).optional()
+}).strict();
+var ProgressCitationSchema = external_exports.object({ kind: external_exports.string(), id: external_exports.string(), url: external_exports.string() });
+var ProgressEvidenceItemSchema = external_exports.object({
+  id: external_exports.string(),
+  source: external_exports.enum(["activity", "session"]),
+  occurredAt: external_exports.string(),
+  recordedAt: external_exports.string(),
+  summary: external_exports.string(),
+  classification: external_exports.enum(["planned", "progressed", "delivered"]),
+  attribution: external_exports.object({ basis: external_exports.enum(["recorded_actor", "session_initiator", "unknown"]), actorId: external_exports.string().nullable(), agentId: external_exports.string().optional() }),
+  citations: external_exports.array(ProgressCitationSchema),
+  context: external_exports.array(external_exports.object({ kind: external_exports.string(), id: external_exports.string(), title: external_exports.string().optional(), asOf: external_exports.literal("current") })),
+  deliveryProof: external_exports.object({ kind: external_exports.literal("recorded_release"), occurredAt: external_exports.string(), citation: ProgressCitationSchema }).nullable()
+});
+var ProgressCoverageGapSchema = external_exports.object({ source: external_exports.string(), code: external_exports.string(), message: external_exports.string(), entityId: external_exports.string().optional() });
+var ProgressEvidenceResponseSchema = external_exports.object({
+  systemId: external_exports.string(),
+  accountId: external_exports.string().nullable(),
+  window: external_exports.object({ start: external_exports.string(), end: external_exports.string(), timezone: external_exports.string() }),
+  contributor: external_exports.string().nullable(),
+  watermark: external_exports.string(),
+  items: external_exports.array(ProgressEvidenceItemSchema),
+  nextCursor: external_exports.string().optional(),
+  coverage: external_exports.object({ status: external_exports.literal("partial"), gaps: external_exports.array(ProgressCoverageGapSchema) }),
+  metrics: external_exports.object({ queryCalls: external_exports.number(), batchCalls: external_exports.number(), scannedCount: external_exports.number(), referenceCount: external_exports.number(), elapsedMs: external_exports.number() })
+});
+
 // ../../libs/harmonica-schemas/src/api-responses.ts
 var HumanAssigneeSchema = external_exports.object({ email: external_exports.string(), name: external_exports.string() });
 var AgentAssigneeSchema = external_exports.object({ agentId: external_exports.string(), name: external_exports.string() });
@@ -25300,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(),
@@ -25913,7 +26017,11 @@ var HumanAssigneeApiSchema = external_exports.object({
   name: external_exports.string(),
   email: external_exports.string()
 });
+var ArchiveWorkItemRequestSchema = external_exports.object({ reason: external_exports.string().trim().min(1).max(1e3) });
 var WorkItemApiSchema = external_exports.object({
+  archived: external_exports.boolean().optional(),
+  archivedAt: external_exports.string().optional(),
+  archivedReason: external_exports.string().optional(),
   workItemId: external_exports.string(),
   trackId: external_exports.string(),
   teamspaceId: external_exports.string(),
@@ -25947,6 +26055,12 @@ var WorkItemApiSchema = external_exports.object({
    * not, so a move on either side can separate the two.
    */
   barId: external_exports.string().min(1).optional(),
+  /**
+   * Optional per-Track fractional ordering rank (N-4E09-7665). Absent when
+   * the item is unranked — an unranked item is a first-class state. The
+   * Work Queue uses this to order items within their displayed group.
+   */
+  rank: external_exports.number().optional(),
   createdBy: external_exports.string().optional(),
   version: external_exports.number().optional(),
   createdAt: external_exports.string(),
@@ -27017,19 +27131,19 @@ function registerMovementTools(server, _ctx, client) {
   );
   server.tool(
     "create_movement",
-    'Create a Movement in a Teamspace. A Movement is a Teamspace-scoped client-SOW container for an engagement \u2014 it is NOT a Beat. Recognition cues: "new SOW", "create a contract scope", "start an engagement container" \u2192 create_movement.',
+    `Create a Movement for an Account, in one of that Account's Teamspaces. A Movement is a client-SOW container for an engagement \u2014 it is NOT a Beat. Recognition cues: "new SOW", "create a contract scope", "start an engagement container" \u2192 create_movement.`,
     {
       teamspaceId: external_exports.string().describe("The teamspace ID"),
       title: external_exports.string().min(1).max(300).describe('Movement title (e.g. "Q3 Platform Modernisation SOW")'),
       description: external_exports.string().max(2e3).optional().describe("Optional description"),
-      accountId: external_exports.string().min(1).max(128).optional().describe("Optional Account this Movement rolls up to. Must belong to the same org as the Teamspace.")
+      accountId: external_exports.string().min(1).max(128).describe("The Account this Movement belongs to. Required (rev-950e828e). Must be in the same org as the Teamspace and linked to it.")
     },
     async ({ teamspaceId, title, description, accountId }) => {
       const m = await client.createMovement({
         teamspaceId,
         title,
         ...description !== void 0 && { description },
-        ...accountId !== void 0 && { accountId }
+        accountId
       });
       return {
         content: [
@@ -27048,7 +27162,7 @@ function registerMovementTools(server, _ctx, client) {
       movementId: external_exports.string().describe("The movement ID"),
       title: external_exports.string().min(1).max(300).optional().describe("New title"),
       description: external_exports.string().max(2e3).optional().describe("New description"),
-      accountId: external_exports.string().max(128).nullable().optional().describe("Account this Movement rolls up to. Must belong to the same org. Pass null (or an empty string) to unlink.")
+      accountId: external_exports.string().min(1).max(128).optional().describe("Reassign this Movement to a different Account. Must be in the same org and linked to the teamspace. Omit to leave unchanged \u2014 a Movement cannot be left without an Account (rev-950e828e).")
     },
     async ({ movementId, title, description, accountId }) => {
       const hasUpdates = title !== void 0 || description !== void 0 || accountId !== void 0;
@@ -27058,12 +27172,11 @@ function registerMovementTools(server, _ctx, client) {
           isError: true
         };
       }
-      const resolvedAccountId = accountId === "" ? null : accountId;
       try {
         const m = await client.updateMovement(movementId, {
           ...title !== void 0 && { title },
           ...description !== void 0 && { description },
-          ...accountId !== void 0 && { accountId: resolvedAccountId }
+          ...accountId !== void 0 && { accountId }
         });
         if (!m) {
           return {
@@ -27071,7 +27184,7 @@ function registerMovementTools(server, _ctx, client) {
             isError: true
           };
         }
-        const account = accountId !== void 0 ? resolvedAccountId === null ? " \u2014 Account: (unlinked)" : ` \u2014 Account: ${resolvedAccountId}` : m.accountId ? ` \u2014 Account: ${m.accountId}` : "";
+        const account = ` \u2014 Account: ${accountId ?? m.accountId}`;
         return {
           content: [
             {
@@ -28309,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)"),
@@ -28450,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).")
     },
@@ -28513,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")
     },
@@ -28545,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 }) => {
@@ -28568,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 }) => {
@@ -28923,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)}`);
@@ -28936,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;
@@ -29280,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)}`);
@@ -29293,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;
@@ -29521,6 +29654,24 @@ function registerPortfolioCoherenceTools(server, ctx, client) {
   );
 }
 
+// ../../libs/harmonica-services/src/mcp/tools/progress-evidence-tools.ts
+function registerProgressEvidenceTools(server, _ctx, client) {
+  server.tool(
+    "get_progress_evidence",
+    "Read cited progress evidence for a system and [start,end) reporting window. Calendar dates use the required IANA timezone; timestamps need an offset. Optional contributor matches recorded actors or explicitly labeled session initiators, never assignees. Returns planned/progressed/delivered evidence, source gaps, a watermark and continuation. Follow nextCursor even on empty pages. No writes.",
+    { systemId: external_exports.string().min(1).max(128).regex(/^[^#]+$/), ...ProgressEvidenceQuerySchema.shape },
+    async ({ systemId, ...query }) => {
+      try {
+        const report = await client.getProgressEvidence(systemId, query);
+        if (!report) return { isError: true, content: [{ type: "text", text: "System not found." }] };
+        return { content: [{ type: "text", text: JSON.stringify(report, null, 2) }] };
+      } catch (error2) {
+        return { isError: true, content: [{ type: "text", text: `Progress evidence query failed: ${error2 instanceof Error ? error2.message : String(error2)}` }] };
+      }
+    }
+  );
+}
+
 // ../../libs/harmonica-services/src/mcp/tools/pulse-report-tools.ts
 function formatBeatRow(r) {
   const downbeatState = r.hasDownbeat ? "" : " \u2014 no Downbeat ever set";
@@ -31235,6 +31386,30 @@ function registerTeamspaceTools(server, ctx, client) {
   );
 }
 
+// ../../libs/harmonica-services/src/tool-schemas/track.ts
+var get_track = {
+  trackId: external_exports.string().describe("The Track ID")
+};
+var update_track = {
+  trackId: external_exports.string().describe("The Track ID"),
+  title: external_exports.string().min(1).max(300).optional().describe("New title"),
+  description: external_exports.string().max(2e3).optional().describe("New description"),
+  deliverables: external_exports.string().max(2e4).optional().describe(`Replace the Track's deliverables Markdown ("" clears)`),
+  acceptanceCriteria: external_exports.string().max(2e4).optional().describe(`Replace the Track's acceptance-criteria Markdown ("" clears)`),
+  vuRate: external_exports.number().nonnegative().optional().describe("New VU rate")
+};
+var transition_track = {
+  trackId: external_exports.string().describe("The Track ID"),
+  targetState: external_exports.enum(["proposed", "approved", "active", "fulfilled", "cancelled"]).describe("Target lifecycle state"),
+  approvalNoteId: external_exports.string().optional().describe(
+    'Required when transitioning to "approved" \u2014 the Note ID capturing the approval decision'
+  ),
+  reason: external_exports.string().optional().describe("Reason for the transition (especially useful for cancellation)"),
+  confirm: external_exports.boolean().optional().default(false).describe(
+    "false (default) = dry-run preview; true = execute the transition"
+  )
+};
+
 // ../../libs/harmonica-services/src/mcp/tools/track-tools.ts
 function registerTrackTools(server, ctx, client) {
   server.tool(
@@ -31255,9 +31430,7 @@ function registerTrackTools(server, ctx, client) {
   server.tool(
     "get_track",
     "Get a Track by ID. Returns full details including commercial lifecycle status, VU rate, and audit stamps.",
-    {
-      trackId: external_exports.string().describe("The Track ID")
-    },
+    get_track,
     async ({ trackId }) => {
       const t = await client.getTrack(trackId);
       if (!t) {
@@ -31331,14 +31504,7 @@ ${t.acceptanceCriteria}` : null,
   server.tool(
     "update_track",
     "Update mutable content fields on a Track (title, description, deliverables, acceptanceCriteria, vuRate). To change commercial status use transition_track instead.",
-    {
-      trackId: external_exports.string().describe("The Track ID"),
-      title: external_exports.string().min(1).max(300).optional().describe("New title"),
-      description: external_exports.string().max(2e3).optional().describe("New description"),
-      deliverables: external_exports.string().max(2e4).optional().describe(`Replace the Track's deliverables Markdown ("" clears)`),
-      acceptanceCriteria: external_exports.string().max(2e4).optional().describe(`Replace the Track's acceptance-criteria Markdown ("" clears)`),
-      vuRate: external_exports.number().nonnegative().optional().describe("New VU rate")
-    },
+    update_track,
     async ({ trackId, title, description, deliverables, acceptanceCriteria, vuRate }) => {
       const t = await client.updateTrack(trackId, {
         ...title !== void 0 && { title },
@@ -31365,13 +31531,7 @@ ${t.acceptanceCriteria}` : null,
   server.tool(
     "transition_track",
     'Transition a Track through its commercial lifecycle: draft \u2192 proposed \u2192 approved \u2192 active \u2192 fulfilled. Cancelled is reachable from any non-terminal state. Advancing to "approved" requires an approvalNoteId. Use confirm=false (default) to preview the transition without writing; confirm=true to execute.',
-    {
-      trackId: external_exports.string().describe("The Track ID"),
-      targetState: external_exports.enum(["proposed", "approved", "active", "fulfilled", "cancelled"]).describe("Target lifecycle state"),
-      approvalNoteId: external_exports.string().optional().describe('Required when transitioning to "approved" \u2014 the Note ID capturing the approval decision'),
-      reason: external_exports.string().optional().describe("Reason for the transition (especially useful for cancellation)"),
-      confirm: external_exports.boolean().optional().default(false).describe("false (default) = dry-run preview; true = execute the transition")
-    },
+    transition_track,
     async ({ trackId, targetState, approvalNoteId, reason, confirm }) => {
       if (!confirm) {
         return {
@@ -32002,6 +32162,24 @@ function registerWorkItemTools(server, _ctx, client) {
   );
 }
 
+// ../../libs/harmonica-services/src/tool-schemas/work-order.ts
+var WORK_ORDER_SIZE_ENUM = ["XS", "S", "M", "L", "XL"];
+var create_work_order = {
+  workRequestId: external_exports.string().min(1).describe("The Work Request this order was split from \u2014 immutable lineage"),
+  title: external_exports.string().min(1).max(300).describe("Work order title"),
+  description: external_exports.string().max(1e4).optional().describe("Optional detail beyond the title"),
+  size: external_exports.enum(WORK_ORDER_SIZE_ENUM).optional().describe(
+    "Optional t-shirt size. An order can arrive before it is sized; a request's composition counts unsized orders rather than hiding them."
+  ),
+  createdBy: external_exports.string().optional().describe("Optional creator identity for audit")
+};
+var get_work_order = {
+  workOrderId: external_exports.string().describe("The Work Order ID (e.g., wo-abc123)")
+};
+var list_movement_work_orders = {
+  movementId: external_exports.string().describe("The Movement (engagement) ID")
+};
+
 // ../../libs/harmonica-services/src/mcp/tools/work-order-tools.ts
 var WORK_INTAKE_STATUS_ENUM = [
   "requested",
@@ -32014,7 +32192,7 @@ var NEEDS_DECISION_REASON_ENUM = [
   "exceeds_capacity",
   "incoherent_with_decision"
 ];
-var WORK_ORDER_SIZE_ENUM = [
+var WORK_ORDER_SIZE_ENUM2 = [
   "XS",
   "S",
   "M",
@@ -32026,8 +32204,7 @@ function oneLine(value) {
 }
 function formatOrderLine(o) {
   const reason = o.needsDecisionReason ? ` [${o.needsDecisionReason}]` : "";
-  const track = o.trackId ? `on ${o.trackId}` : "unplaced";
-  return `[${o.workOrderId}] ${oneLine(o.title)} \u2014 ${o.status}${reason}, ${o.size ?? "unsized"}, ${track}`;
+  return `[${o.workOrderId}] ${oneLine(o.title)} \u2014 ${o.status}${reason}, ${o.size ?? "unsized"}`;
 }
 function registerWorkOrderTools(server, _ctx, client) {
   server.tool(
@@ -32057,7 +32234,7 @@ function registerWorkOrderTools(server, _ctx, client) {
   );
   server.tool(
     "list_work_request_work_orders",
-    "List the Work Orders one Work Request split into \u2014 the lineage view. A four-way split shows four orders here, each possibly on a different Track and in a different state.",
+    "List the Work Orders one Work Request split into \u2014 the lineage view. A four-way split shows four orders here, each with its own Items and independent state.",
     {
       workRequestId: external_exports.string().describe("The Work Request ID")
     },
@@ -32069,10 +32246,8 @@ function registerWorkOrderTools(server, _ctx, client) {
   );
   server.tool(
     "get_work_order",
-    "Get a Work Order by ID. Returns its title, status (with the routing reason when it is awaiting a decision), t-shirt size, the Track it sits on, and the Work Request it was split from.",
-    {
-      workOrderId: external_exports.string().describe("The Work Order ID (e.g., wo-abc123)")
-    },
+    "Get a Work Order by ID. Returns its title, status (with the routing reason when it is awaiting a decision), t-shirt size, and the Work Request it was split from.",
+    get_work_order,
     async ({ workOrderId }) => {
       const wo = await client.getWorkOrder(workOrderId);
       if (!wo) {
@@ -32082,7 +32257,6 @@ function registerWorkOrderTools(server, _ctx, client) {
         `ID: ${wo.workOrderId}`,
         `Title: ${oneLine(wo.title)}`,
         `From Work Request: ${wo.workRequestId}`,
-        `Track: ${wo.trackId}`,
         `Status: ${wo.status}`,
         wo.needsDecisionReason ? `Routing Reason: ${wo.needsDecisionReason}` : null,
         wo.size !== void 0 ? `Size: ${wo.size}` : "Size: unsized",
@@ -32094,41 +32268,37 @@ function registerWorkOrderTools(server, _ctx, client) {
       return { content: [{ type: "text", text: lines }] };
     }
   );
-  server.tool(
-    "create_work_order",
-    `Split a Work Request into an agreed Work Order. Called once per piece: a request covering two separate lines of work becomes two orders. Starts in "requested" status \u2014 moving it past the coherence gate is transition_work_order_status. The Order's scope is derived from the Work Request's Movement; no Track is required.`,
-    {
-      workRequestId: external_exports.string().min(1).describe("The Work Request this order was split from \u2014 immutable lineage"),
-      title: external_exports.string().min(1).max(300).describe("Work order title"),
-      description: external_exports.string().max(1e4).optional().describe("Optional detail beyond the title"),
-      size: external_exports.enum(WORK_ORDER_SIZE_ENUM).optional().describe("Optional t-shirt size. An order can arrive before it is sized; a request's composition counts unsized orders rather than hiding them."),
-      createdBy: external_exports.string().optional().describe("Optional creator identity for audit")
-    },
-    async ({ workRequestId, title, description, size, createdBy }) => {
-      const wo = await client.createWorkOrder({
-        workRequestId,
-        title,
-        ...description !== void 0 && { description },
-        ...size !== void 0 && { size },
-        ...createdBy !== void 0 && { createdBy }
-      });
-      return {
-        content: [{ type: "text", text: `Created work order: ${formatOrderLine(wo)}` }]
-      };
-    }
-  );
-  server.tool(
-    "list_movement_work_orders",
-    'List the Work Orders belonging to a Movement (engagement). A Work Order is the internal unit of agreed work \u2014 it is split from a Work Request and scoped to the Movement that owns the Request. Recognition cues: "what is committed on this engagement", "list the orders" \u2192 list_movement_work_orders.',
-    {
-      movementId: external_exports.string().describe("The Movement (engagement) ID")
-    },
-    async ({ movementId }) => {
-      const orders = await client.listMovementWorkOrders(movementId);
-      const text = orders.length === 0 ? "No work orders found." : orders.map(formatOrderLine).join("\n");
-      return { content: [{ type: "text", text }] };
-    }
-  );
+  for (const name of ["create_work_order", "promote_work_request"]) {
+    server.tool(
+      name,
+      `Create (promote) a Work Order from a Work Request. Each call creates another Order; it does not accept the Order or change Request status. Called once per piece: a request covering two separate lines of work becomes two orders. Starts in "requested" status \u2014 moving it past the coherence gate is transition_work_order_status. The Order's scope is derived from the Work Request's Movement; Tracks are assigned only to Work Items.`,
+      create_work_order,
+      async ({ workRequestId, title, description, size, createdBy }) => {
+        const wo = await client.createWorkOrder({
+          workRequestId,
+          title,
+          ...description !== void 0 && { description },
+          ...size !== void 0 && { size },
+          ...createdBy !== void 0 && { createdBy }
+        });
+        return {
+          content: [{ type: "text", text: `Created work order: ${formatOrderLine(wo)}` }]
+        };
+      }
+    );
+  }
+  for (const name of ["list_movement_work_orders", "list_work_orders"]) {
+    server.tool(
+      name,
+      'List the Work Orders belonging to a Movement (engagement). A Work Order is the internal unit of agreed work \u2014 it is split from a Work Request and scoped to the Movement that owns the Request. Recognition cues: "what is committed on this engagement", "list the orders" \u2192 list_movement_work_orders.',
+      list_movement_work_orders,
+      async ({ movementId }) => {
+        const orders = await client.listMovementWorkOrders(movementId);
+        const text = orders.length === 0 ? "No work orders found." : orders.map(formatOrderLine).join("\n");
+        return { content: [{ type: "text", text }] };
+      }
+    );
+  }
   server.tool(
     "update_work_order",
     "Update content fields on a Work Order (title, description, size). To change its status use transition_work_order_status. There is no moving an Order between Tracks \u2014 an Order belongs to its Work Request, and a Track is attribution carried by the Work Items (set workOrderId on them via update_work_item). The Work Request it came from cannot be changed \u2014 that lineage is immutable.",
@@ -32136,7 +32306,7 @@ function registerWorkOrderTools(server, _ctx, client) {
       workOrderId: external_exports.string().describe("The Work Order ID"),
       title: external_exports.string().min(1).max(300).optional().describe("New title"),
       description: external_exports.string().max(1e4).nullable().optional().describe("New description. Pass null to clear; omit to leave untouched."),
-      size: external_exports.enum(WORK_ORDER_SIZE_ENUM).nullable().optional().describe("New t-shirt size. Pass null to return it to unsized; omit to leave untouched.")
+      size: external_exports.enum(WORK_ORDER_SIZE_ENUM2).nullable().optional().describe("New t-shirt size. Pass null to return it to unsized; omit to leave untouched.")
     },
     async ({ workOrderId, title, description, size }) => {
       if (title === void 0 && description === void 0 && size === void 0) {
@@ -32225,11 +32395,27 @@ function registerWorkOrderTools(server, _ctx, client) {
   );
 }
 
+// ../../libs/harmonica-services/src/tool-schemas/work-request.ts
+var WORK_REQUEST_ORIGIN_ENUM = ["client", "internal"];
+var create_work_request = {
+  movementId: external_exports.string().describe("The Movement (engagement) this request is filed against"),
+  title: external_exports.string().min(1).max(300).describe("Short title for the ask"),
+  body: external_exports.string().max(1e4).optional().describe("The ask as written, in the requester's own words"),
+  requesterName: external_exports.string().min(1).describe("Who is asking \u2014 display name"),
+  requesterEmail: external_exports.string().email().describe("Who is asking \u2014 email"),
+  origin: external_exports.enum(WORK_REQUEST_ORIGIN_ENUM).describe(
+    'Where the ask came from: "client" or "internal". One entity covers both \u2014 only the entry point differs.'
+  ),
+  createdBy: external_exports.string().optional().describe("Optional creator identity for audit")
+};
+var get_work_request = {
+  workRequestId: external_exports.string().describe("The Work Request ID (e.g., wr-abc123)")
+};
+var list_movement_work_requests = {
+  movementId: external_exports.string().describe("The Movement (engagement) ID")
+};
+
 // ../../libs/harmonica-services/src/mcp/tools/work-request-tools.ts
-var WORK_REQUEST_ORIGIN_ENUM = [
-  "client",
-  "internal"
-];
 function oneLine2(value) {
   return value.replace(/[\r\n]+/g, " ");
 }
@@ -32243,9 +32429,7 @@ function registerWorkRequestTools(server, _ctx, client) {
   server.tool(
     "list_movement_work_requests",
     `List the Work Requests filed against a Movement. A Work Request is the customer's ask in their own language, before it is sized or agreed. Recognition cues: "what has the client asked for", "list the requests on this engagement" \u2192 list_movement_work_requests.`,
-    {
-      movementId: external_exports.string().describe("The Movement (engagement) ID")
-    },
+    list_movement_work_requests,
     async ({ movementId }) => {
       const requests = await client.listMovementWorkRequests(movementId);
       const text = requests.length === 0 ? "No work requests found." : requests.map((wr) => `[${wr.workRequestId}] ${oneLine2(wr.title)} \u2014 from ${oneLine2(wr.requester.name)} (${wr.origin})`).join("\n");
@@ -32255,9 +32439,7 @@ function registerWorkRequestTools(server, _ctx, client) {
   server.tool(
     "get_work_request",
     "Get a Work Request with the Work Orders it split into and their combined size composition. Note there is no request-level status: each Order carries its own, because a split whose halves sit in different states cannot be reduced to one word.",
-    {
-      workRequestId: external_exports.string().describe("The Work Request ID (e.g., wr-abc123)")
-    },
+    get_work_request,
     async ({ workRequestId }) => {
       const detail = await client.getWorkRequestDetail(workRequestId);
       if (!detail) {
@@ -32267,10 +32449,9 @@ function registerWorkRequestTools(server, _ctx, client) {
       const orderLines = orders.length === 0 ? ["Orders: none yet \u2014 this request has not been split"] : [
         "Orders:",
         ...orders.map((o) => {
-          const track = o.trackTitle ? `${oneLine2(o.trackTitle)} (${o.trackId})` : o.trackId;
           const reason = o.needsDecisionReason ? ` [${o.needsDecisionReason}]` : "";
           const sized = o.size ?? "unsized";
-          return `  [${o.workOrderId}] ${oneLine2(o.title)} \u2014 ${o.status}${reason}, ${sized}, on ${track}`;
+          return `  [${o.workOrderId}] ${oneLine2(o.title)} \u2014 ${o.status}${reason}, ${sized}`;
         })
       ];
       const lines = [
@@ -32292,15 +32473,7 @@ function registerWorkRequestTools(server, _ctx, client) {
   server.tool(
     "create_work_request",
     "File a Work Request against a Movement \u2014 how work arrives, in the requester's own language, before it is sized or agreed. Splitting it into Work Orders is a separate step (create_work_order).",
-    {
-      movementId: external_exports.string().describe("The Movement (engagement) this request is filed against"),
-      title: external_exports.string().min(1).max(300).describe("Short title for the ask"),
-      body: external_exports.string().max(1e4).optional().describe("The ask as written, in the requester's own words"),
-      requesterName: external_exports.string().min(1).describe("Who is asking \u2014 display name"),
-      requesterEmail: external_exports.string().email().describe("Who is asking \u2014 email"),
-      origin: external_exports.enum(WORK_REQUEST_ORIGIN_ENUM).describe('Where the ask came from: "client" or "internal". One entity covers both \u2014 only the entry point differs.'),
-      createdBy: external_exports.string().optional().describe("Optional creator identity for audit")
-    },
+    create_work_request,
     async ({ movementId, title, body, requesterName, requesterEmail, origin, createdBy }) => {
       const wr = await client.createWorkRequest({
         movementId,
@@ -32858,6 +33031,7 @@ function registerAllTools(server, ctx, client, profile) {
   registerNextActionsTools(server, ctx, client);
   registerCheckTools(server, ctx, client);
   registerActivityTools(server, ctx, client);
+  registerProgressEvidenceTools(server, ctx, client);
   registerAuditIntegrityTools(server, ctx, client);
   registerAnalysisTools(server, ctx, client);
   registerOrganizationTools(server, ctx, client);
@@ -33570,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}`);
@@ -34523,10 +34699,13 @@ function createHttpClient(config2) {
       const { teamspaceId, title, description, accountId } = input;
       const body = {
         title,
-        ...description !== void 0 && { description },
-        ...accountId !== void 0 && { accountId }
+        ...description !== void 0 && { description }
       };
-      const result = await request("POST", `/api/teamspaces/${encodeURIComponent(teamspaceId)}/movements`, body);
+      const result = await request(
+        "POST",
+        `/api/teamspaces/${encodeURIComponent(teamspaceId)}/accounts/${encodeURIComponent(accountId)}/movements`,
+        body
+      );
       if (result === void 0) throw new Error("Resource not found when creating Movement");
       const parsed = MovementApiSchema.safeParse(result);
       if (!parsed.success) throw new Error(`Unexpected Movement shape from API: ${parsed.error.message}`);
@@ -34936,6 +35115,11 @@ function createHttpClient(config2) {
       const qs = asOf ? `?asOf=${encodeURIComponent(asOf)}` : "";
       return request("GET", `/api/accounts/${encodeURIComponent(accountId)}/cadence-schedule${qs}`);
     },
+    getProgressEvidence: async (systemId, query) => {
+      const qs = new URLSearchParams();
+      for (const [key, value] of Object.entries(query)) if (value !== void 0) qs.set(key, String(value));
+      return request("GET", `/api/systems/${encodeURIComponent(systemId)}/progress-evidence?${qs}`);
+    },
     getPulseReport: async (accountId, asOf) => {
       const qs = asOf ? `?asOf=${encodeURIComponent(asOf)}` : "";
       return request("GET", `/api/accounts/${encodeURIComponent(accountId)}/pulse-report${qs}`);
@@ -35369,7 +35553,7 @@ function loadConfig() {
   };
 }
 async function main() {
-  console.error(`[harmonica-mcp] v${"5.0.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.0.0",
+  "version": "5.2.0",
   "description": "MCP server for Harmonica — connect any MCP-compatible AI assistant to Harmonica",
   "license": "MIT",
   "bin": {