@codazen/harmonica-mcp 0.28.1 → 0.29.0

package/dist/index.js

@@ -21503,9 +21503,9 @@ function registerBaselineTools(server, ctx, client) {
         return {
           content: [{
             type: "text",
-            text: `Project baseline started. Task ID: ${task.taskId}
+            text: `Project baseline started. Job ID: ${task.taskId}
 
-Poll progress with: get_task_status({ taskId: "${task.taskId}" })`
+Poll progress with: get_job_status({ jobId: "${task.taskId}" })`
           }]
         };
       } catch (err) {
@@ -21779,7 +21779,7 @@ ${d.rationale}${d.suggestions?.length ? `
 function registerBeatQualityTools(server, ctx, client) {
   server.tool(
     "check_beat_quality",
-    "Enqueue a Beat quality check across 6 dimensions (Distinctive, Harmonious, Substantial, Durable, Clear, Strategically Aligned). By default returns a taskId immediately (fire-and-forget) \u2014 use get_task_status or list_checks to retrieve results. Set wait=true to block until the check completes and receive the scorecard inline.",
+    "Enqueue a Beat quality check across 6 dimensions (Distinctive, Harmonious, Substantial, Durable, Clear, Strategically Aligned). 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.",
     {
       beatId: external_exports.string().describe("The beat ID (e.g., TF-B-001)"),
       projectId: external_exports.string().describe("The project ID"),
@@ -21794,9 +21794,9 @@ function registerBeatQualityTools(server, ctx, client) {
             content: [{
               type: "text",
               text: `Quality check enqueued for ${beatId}.
-Task ID: ${taskId}
+Job ID: ${taskId}
 
-Use get_task_status with taskId="${taskId}" to poll for results, or list_checks to retrieve the completed scorecard once done.`
+Use get_job_status with jobId="${taskId}" to poll for results, or list_checks to retrieve the completed scorecard once done.`
             }]
           };
         }
@@ -22939,7 +22939,7 @@ function registerCheckTools(server, ctx, client) {
           `**Check Type:** ${checkType}`,
           `**Target:** ${targetId}`,
           ``,
-          `Poll with \`get_task_status\` (taskId: \`${task.taskId}\`), then \`list_checks\` to view results.`
+          `Poll with \`get_job_status\` (jobId: \`${task.taskId}\`), then \`list_checks\` to view results.`
         ].join("\n");
         return { content: [{ type: "text", text }] };
       } catch (err) {
@@ -24587,7 +24587,7 @@ ${d.rationale}${d.suggestions?.length ? `
 function registerPlanQualityTools(server, ctx, client) {
   server.tool(
     "check_plan_quality",
-    "Enqueue a Revision plan quality check across 6 dimensions (Scoped, Directional, Testable, Traceable, Assignable, Risk-aware). By default returns a taskId immediately (fire-and-forget) \u2014 use get_task_status or list_checks to retrieve results. Set wait=true to block until the check completes and receive the scorecard inline.",
+    "Enqueue a Revision plan quality check across 6 dimensions (Scoped, Directional, Testable, Traceable, Assignable, Risk-aware). 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 revision), omit wait and poll get_job_status separately to avoid session exhaustion.",
     {
       revisionId: external_exports.string().describe("The revision or Beat Version ID (e.g., rev-abc123 or bv-abc123)"),
       projectId: external_exports.string().describe("The project ID"),
@@ -24602,9 +24602,9 @@ function registerPlanQualityTools(server, ctx, client) {
             content: [{
               type: "text",
               text: `Plan quality check enqueued for ${revisionId}.
-Task ID: ${task.taskId}
+Job ID: ${task.taskId}
 
-Use get_task_status with taskId="${task.taskId}" to poll for results, or list_checks to retrieve the completed scorecard once done.`
+Use get_job_status with jobId="${task.taskId}" to poll for results, or list_checks to retrieve the completed scorecard once done.`
             }]
           };
         }
@@ -24737,7 +24737,7 @@ function registerPortfolioCoherenceTools(server, ctx, client) {
                 `Portfolio coherence check enqueued for ${projectId}.`,
                 `Task ID: ${taskId}`,
                 "",
-                `Use get_task_status with taskId="${taskId}" to poll, or list_checks with projectId="${projectId}" and checkType="portfolio_coherence" to view results.`
+                `Use get_job_status with jobId="${taskId}" to poll, or list_checks with projectId="${projectId}" and checkType="portfolio_coherence" to view results.`
               ].join("\n")
             }]
           };
@@ -25938,7 +25938,7 @@ ${JSON.stringify(task.result, null, 2)}
   );
   server.tool(
     "draft_coda",
-    "Generate and apply a Coda (description) for a Beat that has a title but no description. Uses project context, sibling Beats, related Notes, and codebase grep to write a resolved expression of the capability. The Coda is applied directly to the Beat, making it eligible for plan_beat_versions once a beat_quality check passes. An activity is logged so the Beat owner can review and edit. Returns a task ID \u2014 use get_task_status to track progress.",
+    "Generate and apply a Coda (description) for a Beat that has a title but no description. Uses project context, sibling Beats, related Notes, and codebase grep to write a resolved expression of the capability. The Coda is applied directly to the Beat, making it eligible for plan_beat_versions once a beat_quality check passes. An activity is logged so the Beat owner can review and edit. Returns a job ID \u2014 use get_job_status to track progress.",
     {
       projectId: external_exports.string().describe("The project ID"),
       beatId: external_exports.string().describe("The beat ID (must have a title but no description)")
@@ -25959,7 +25959,7 @@ ${JSON.stringify(task.result, null, 2)}
               `**Status:** ${task.status}`,
               "",
               "The agent will gather context and apply a Coda directly to the Beat. An activity will be logged \u2014 review and edit if needed.",
-              "Use `get_task_status` with the task ID to check progress."
+              "Use `get_job_status` with the job ID to check progress."
             ].join("\n")
           }]
         };
@@ -25971,7 +25971,7 @@ ${JSON.stringify(task.result, null, 2)}
   );
   server.tool(
     "validate_assumptions",
-    "Validate unvalidated assumption Notes against the codebase. Checks if assumptions are confirmed (validated), contradicted (invalidated), or have insufficient evidence (unvalidated). Low-criticality assumptions are auto-resolved; high-criticality are flagged for human review. Returns a task ID \u2014 use get_task_status to track progress.",
+    "Validate unvalidated assumption Notes against the codebase. Checks if assumptions are confirmed (validated), contradicted (invalidated), or have insufficient evidence (unvalidated). Low-criticality assumptions are auto-resolved; high-criticality are flagged for human review. Returns a job ID \u2014 use get_job_status to track progress.",
     {
       projectId: external_exports.string().describe("The project ID"),
       noteIds: external_exports.array(external_exports.string()).optional().describe("Specific assumption note IDs to validate. If omitted, validates all unvalidated assumptions.")
@@ -25993,7 +25993,7 @@ ${JSON.stringify(task.result, null, 2)}
               "",
               "The validator will grep the codebase for evidence, then classify each assumption.",
               "Low-criticality assumptions are auto-resolved. High-criticality are flagged for your review.",
-              "Use `get_task_status` with the task ID to check progress."
+              "Use `get_job_status` with the job ID to check progress."
             ].join("\n")
           }]
         };
@@ -26005,7 +26005,7 @@ ${JSON.stringify(task.result, null, 2)}
   );
   server.tool(
     "implement_work_item",
-    "Trigger an agent session to implement a workItem Note. The agent explores the codebase, writes code, commits, pushes a branch, and creates a PR. Returns a task ID \u2014 use get_task_status to track progress. Requires agentCapabilities.implementation enabled on the project.",
+    "Trigger an agent session to implement a workItem Note. The agent explores the codebase, writes code, commits, pushes a branch, and creates a PR. Returns a job ID \u2014 use get_job_status to track progress. Requires agentCapabilities.implementation enabled on the project.",
     {
       noteId: external_exports.string().describe("The workItem note ID to implement (e.g., N-TF-001)"),
       projectId: external_exports.string().describe("The project ID")
@@ -26028,7 +26028,7 @@ ${JSON.stringify(task.result, null, 2)}
               `**Status:** ${task.status}`,
               "",
               "The agent will explore the codebase, implement the work item, and create a PR.",
-              "Use `get_task_status` with the task ID to check progress and see the result (branch, PR URL, tool count, duration)."
+              "Use `get_job_status` with the job ID to check progress and see the result (branch, PR URL, tool count, duration)."
             ].join("\n")
           }]
         };
@@ -26040,7 +26040,7 @@ ${JSON.stringify(task.result, null, 2)}
   );
   server.tool(
     "implement_revision",
-    "Trigger an agent session to implement a Revision. The agent reads the Revision spec and beat-level Notes, writes code, commits, pushes a branch named agent/rev-{id}-{title}, and creates a draft PR with the Revision ID pre-populated in the PR body. Returns a task ID \u2014 use get_task_status to track progress. Requires agentCapabilities.implementation enabled on the project.",
+    "Trigger an agent session to implement a Revision. The agent reads the Revision spec and beat-level Notes, writes code, commits, pushes a branch named agent/rev-{id}-{title}, and creates a draft PR with the Revision ID pre-populated in the PR body. Returns a job ID \u2014 use get_job_status to track progress. Requires agentCapabilities.implementation enabled on the project.",
     {
       revisionId: external_exports.string().min(1).describe("The Revision ID to implement (e.g., rev-abc123)"),
       projectId: external_exports.string().min(1).describe("The project ID")
@@ -26063,7 +26063,7 @@ ${JSON.stringify(task.result, null, 2)}
               `**Status:** ${task.status}`,
               "",
               "The agent will read the Revision spec and beat-level Notes, implement the code, and create a draft PR.",
-              "Use `get_task_status` with the task ID to check progress and see the result (branch, PR URL, tool count, duration)."
+              "Use `get_job_status` with the job ID to check progress and see the result (branch, PR URL, tool count, duration)."
             ].join("\n")
           }]
         };
@@ -26075,7 +26075,7 @@ ${JSON.stringify(task.result, null, 2)}
   );
   server.tool(
     "validate_work_items",
-    "Validate active workItem Notes against the codebase. Checks if work items are already implemented (resolved), no longer relevant (dismissed), or still needed (active). Active items get a solution plan for the implementation agent. Returns a task ID \u2014 use get_task_status to track progress.",
+    "Validate active workItem Notes against the codebase. Checks if work items are already implemented (resolved), no longer relevant (dismissed), or still needed (active). Active items get a solution plan for the implementation agent. Returns a job ID \u2014 use get_job_status to track progress.",
     {
       projectId: external_exports.string().describe("The project ID"),
       noteIds: external_exports.array(external_exports.string()).optional().describe("Specific note IDs to validate. If omitted, validates all active work items.")
@@ -26096,7 +26096,7 @@ ${JSON.stringify(task.result, null, 2)}
               `**Status:** ${task.status}`,
               "",
               "The validator will grep the codebase for evidence, then classify each item.",
-              "Use `get_task_status` with the task ID to check progress."
+              "Use `get_job_status` with the job ID to check progress."
             ].join("\n")
           }]
         };
@@ -26108,7 +26108,7 @@ ${JSON.stringify(task.result, null, 2)}
   );
   server.tool(
     "plan_revision_batch",
-    "Autonomously generate work items for planning Revisions. If revisionIds are omitted, discovers all planning Revisions with no scoped work items and plans them all. Uses codebase-aware agent sessions when available, LLM-only fallback otherwise. Returns a task ID \u2014 use get_task_status to track progress.",
+    "Autonomously generate work items for planning Revisions. If revisionIds are omitted, discovers all planning Revisions with no scoped work items and plans them all. Uses codebase-aware agent sessions when available, LLM-only fallback otherwise. Returns a job ID \u2014 use get_job_status to track progress.",
     {
       projectId: external_exports.string().describe("The project ID"),
       revisionIds: external_exports.array(external_exports.string()).optional().describe("Specific revision IDs to plan. If omitted, auto-discovers all unplanned planning revisions.")
@@ -26129,7 +26129,7 @@ ${JSON.stringify(task.result, null, 2)}
               `**Status:** ${task.status}`,
               "",
               "The agent will generate work items for each revision. Revisions stay in planning \u2014 review work items before advancing to building.",
-              "Use `get_task_status` with the task ID to check progress."
+              "Use `get_job_status` with the job ID to check progress."
             ].join("\n")
           }]
         };
@@ -26141,7 +26141,7 @@ ${JSON.stringify(task.result, null, 2)}
   );
   server.tool(
     "run_triage",
-    "Run the autonomous triage loop for a project. Analyzes next actions, validates work items against the codebase, auto-executes safe actions (draft_coda, plan_revision_batch, validate_work_items), and escalates items that need human judgment. Requires agentCapabilities.triage enabled on the project. Returns a task ID \u2014 use get_task_status to track progress.",
+    "Run the autonomous triage loop for a project. Analyzes next actions, validates work items against the codebase, auto-executes safe actions (draft_coda, plan_revision_batch, validate_work_items), and escalates items that need human judgment. Requires agentCapabilities.triage enabled on the project. Returns a job ID \u2014 use get_job_status to track progress.",
     {
       projectId: external_exports.string().describe("The project ID")
     },
@@ -26161,7 +26161,7 @@ ${JSON.stringify(task.result, null, 2)}
               "",
               "The triage engine will analyze next actions, filter by Beat lifecycle eligibility,",
               "auto-execute safe tasks, and escalate items needing human input.",
-              "Use `get_task_status` with the task ID to see the results."
+              "Use `get_job_status` with the job ID to see the results."
             ].join("\n")
           }]
         };
@@ -26183,7 +26183,7 @@ ${JSON.stringify(task.result, null, 2)}
       "Use this for .docx, .xlsx, .pptx, or .pdf files \u2014 the server parses them automatically.",
       "Example: run `base64 < report.docx` to get the base64 string.",
       "",
-      "Returns a task ID \u2014 use `get_task_status` to track progress."
+      "Returns a job ID \u2014 use `get_job_status` to track progress."
     ].join("\n"),
     {
       projectId: external_exports.string().describe("The project ID"),
@@ -26206,7 +26206,7 @@ ${JSON.stringify(task.result, null, 2)}
               `**Task ID:** ${result.taskId}`,
               `**Status:** ${result.status}`,
               "",
-              "Use `get_task_status` with the task ID to check when extraction is complete."
+              "Use `get_job_status` with the job ID to check when extraction is complete."
             ].join("\n")
           }]
         };
@@ -26219,7 +26219,58 @@ ${JSON.stringify(task.result, null, 2)}
 }
 
 // ../../libs/harmonica-services/src/mcp/tools/index.ts
-function registerAllTools(server, ctx, client) {
+var TOOL_PROFILES = Object.freeze({
+  "beat-planning": Object.freeze([
+    registerBeatTools,
+    registerBeatVersionTools,
+    registerNoteTools,
+    registerBeatQualityTools,
+    registerPlanQualityTools,
+    registerBeatPlanningTools,
+    registerCheckTools
+  ]),
+  "execution": Object.freeze([
+    registerRevisionLifecycleTools,
+    registerBeatLifecycleTools,
+    registerBeatVersionTools,
+    registerDropTools,
+    registerWorkflowTools,
+    registerCheckTools
+  ]),
+  "discovery": Object.freeze([
+    registerEmbeddingTools,
+    registerNextActionsTools,
+    registerBeatTools,
+    registerNoteTools,
+    registerProjectTools,
+    registerAnalysisTools
+  ]),
+  "admin": Object.freeze([
+    registerOrganizationTools,
+    registerTeamspaceTools,
+    registerMembershipTools,
+    registerProjectTools,
+    registerProjectLifecycleTools
+  ]),
+  "onboarding": Object.freeze([
+    registerOnboardingTools,
+    registerBaselineTools,
+    registerSnapshotTools,
+    registerBeatComposerTools,
+    registerProjectTools
+  ])
+});
+function registerAllTools(server, ctx, client, profile) {
+  if (profile && profile !== "all") {
+    if (!Object.hasOwn(TOOL_PROFILES, profile)) {
+      const valid = Object.keys(TOOL_PROFILES).join(", ");
+      throw new Error(`Unknown tool profile: "${profile}". Valid profiles: ${valid}`);
+    }
+    for (const register of TOOL_PROFILES[profile]) {
+      register(server, ctx, client);
+    }
+    return;
+  }
   registerProjectTools(server, ctx, client);
   registerProjectLifecycleTools(server, ctx, client);
   registerMembershipTools(server, ctx, client);
@@ -27406,7 +27457,7 @@ function loadConfig() {
   };
 }
 async function main() {
-  console.error(`[harmonica-mcp] v${"0.28.1"} starting\u2026`);
+  console.error(`[harmonica-mcp] v${"0.29.0"} starting\u2026`);
   const config2 = loadConfig();
   const client = createHttpClient({
     apiBaseUrl: config2.apiBaseUrl,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codazen/harmonica-mcp",
-  "version": "0.28.1",
+  "version": "0.29.0",
   "description": "MCP server for Harmonica — connect Claude to your Harmonica projects",
   "license": "MIT",
   "bin": {