@codazen/harmonica-mcp 3.2.0 → 3.3.0

package/dist/index.js

@@ -22524,7 +22524,7 @@ Use get_job_status with jobId="${taskId}" to poll for results, or list_checks to
   };
   server.tool(
     "check_beat_coda_quality",
-    "Enqueue a Beat definition quality check across 7 dimensions (Distinctive, Harmonious, Substantial, Durable, Clear, Strategically Aligned, Business Outcome) \u2014 grades the Beat's Coda and directing context, persisted as beat_coda_quality. By default returns a jobId immediately (fire-and-forget) \u2014 use get_job_status or list_checks to retrieve results. Set wait=true to block until the check completes and receive the scorecard inline. WARNING: wait=true holds the MCP session open for 30\u201360s per check \u2014 for bulk operations (more than one Beat), omit wait and poll get_job_status separately to avoid session exhaustion.",
+    "Enqueue a Beat definition quality check across 7 dimensions (Distinctive, Harmonious, Substantial, Durable, Clear, Strategically Aligned, Outcome-Oriented) \u2014 grades the Beat's Coda and directing context, persisted as beat_coda_quality. By default returns a jobId immediately (fire-and-forget) \u2014 use get_job_status or list_checks to retrieve results. Set wait=true to block until the check completes and receive the scorecard inline. WARNING: wait=true holds the MCP session open for 30\u201360s per check \u2014 for bulk operations (more than one Beat), omit wait and poll get_job_status separately to avoid session exhaustion.",
     schema,
     handler
   );
@@ -25857,7 +25857,7 @@ var BEAT_QUALITY_DIMENSIONS = [
   "durable",
   "clear",
   "strategicallyAligned",
-  "businessOutcome"
+  "outcomeOriented"
 ];
 var BeatDimensionScoreSchema = external_exports.object({
   dimension: external_exports.enum(BEAT_QUALITY_DIMENSIONS),
@@ -28967,7 +28967,7 @@ function formatConsolidationResult(primaryId, primary, archivedBeatIds, notesRea
 function registerPortfolioCoherenceTools(server, ctx, client) {
   server.tool(
     "check_portfolio_coherence",
-    "Run a portfolio coherence check on a project. Clusters Beats by semantic similarity to surface fragmentation (merge candidates) and checks what fraction of Beats have a VP-readable business outcome score. By default returns a taskId immediately \u2014 set wait=true to block and receive the full report inline.",
+    "Run a portfolio coherence check on a project. Clusters Beats by semantic similarity to surface fragmentation (merge candidates) and checks what fraction of Beats name an outcome their authoriser would recognise. By default returns a taskId immediately \u2014 set wait=true to block and receive the full report inline.",
     {
       projectId: external_exports.string().min(1).describe("The project ID"),
       wait: external_exports.boolean().optional().describe("Block until the check completes and return the report inline. Default: false.")
@@ -30166,6 +30166,9 @@ async function resolveSnapshotInput(input) {
   return trimmed;
 }
 function formatImportSummary(result, targetTeamspaceId) {
+  if (!result.counts || result.counts.beats == null) {
+    throw new Error(`Import of system ${result.projectId} completed but returned no counts \u2014 check worker logs for a TransactionCanceledException`);
+  }
   const lines = [
     `Imported system: ${result.projectId}`,
     `  Beats: ${result.counts.beats}`,
@@ -33202,7 +33205,9 @@ function createHttpClient(config2) {
       if (!enqueued?.taskId) {
         throw new Error("importSystemSnapshotFromUrl: API did not return a taskId");
       }
-      return pollTaskResult(enqueued.taskId);
+      const importResult = await pollTaskResult(enqueued.taskId);
+      if (importResult == null) throw new Error(`Task ${enqueued.taskId} completed but returned no result \u2014 check worker logs for a TransactionCanceledException`);
+      return importResult;
     },
     // Embedding similarity
     embedProjectEntities: (projectId) => request("POST", `/api/systems/${encodeURIComponent(projectId)}/embeddings/generate`),
@@ -34046,7 +34051,7 @@ function loadConfig() {
   };
 }
 async function main() {
-  console.error(`[harmonica-mcp] v${"3.2.0"} starting\u2026`);
+  console.error(`[harmonica-mcp] v${"3.3.0"} starting\u2026`);
   const config2 = loadConfig();
   const client = createHttpClient({
     apiBaseUrl: config2.apiBaseUrl,

package/package.json

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