@codazen/harmonica-mcp 2.0.0 → 3.0.0

package/dist/index.js

@@ -21526,6 +21526,17 @@ async function assertProjectInOrg(client, projectId, orgId) {
     );
   }
 }
+async function assertRevisionInProject(client, revisionId, projectId) {
+  const revision = await client.getRevision(revisionId);
+  if (!revision) {
+    throw new Error(`Revision not found: "${revisionId}"`);
+  }
+  if (revision.projectId !== projectId) {
+    throw new Error(
+      `Revision "${revisionId}" does not belong to project "${projectId}". Access denied.`
+    );
+  }
+}
 async function assertBeatInOrg(client, beatId, orgId) {
   const beat = await client.getBeat(beatId);
   if (!beat) {
@@ -22421,11 +22432,18 @@ function registerBeatPlanningTools(server, ctx, client) {
 
 // ../../libs/harmonica-services/src/mcp/check.constants.ts
 var CHECK_MAX_SCORES = {
+  beat_coda_quality: 5,
+  // Legacy name for beat_coda_quality — kept until every caller passes the new name (N-4E09-6779).
   beat_quality: 5,
+  beat_version_quality: 5,
+  // Legacy name for beat_version_quality — kept until every caller passes the new name.
   plan_quality: 5,
   build_quality: 5,
+  // Retired from the taxonomy (B-308 v3) — kept so historical records still
+  // render with the right denominator.
   pii_scan: 100,
   portfolio_coherence: 5,
+  revision_quality: 5,
   drop_quality: 5
 };
 
@@ -22467,8 +22485,8 @@ ${d.rationale}${d.suggestions?.length ? `
 \u2022 ${d.suggestions.join("\n\u2022 ")}` : ""}`
   ).join("\n\n");
   return [
-    `## Beat Quality Check \u2014 ${check2.targetId}`,
-    `**Overall Score:** ${check2.overallScore}/${CHECK_MAX_SCORES.beat_quality}`,
+    `## Beat Coda Quality Check \u2014 ${check2.targetId}`,
+    `**Overall Score:** ${check2.overallScore}/${CHECK_MAX_SCORES.beat_coda_quality}`,
     `**Summary:** ${check2.summary}`,
     check2.topSuggestion ? `**Top Suggestion:** ${check2.topSuggestion}` : "",
     "",
@@ -22476,35 +22494,46 @@ ${d.rationale}${d.suggestions?.length ? `
   ].filter(Boolean).join("\n");
 }
 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 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"),
-      wait: external_exports.boolean().optional().describe("If true, block until the check completes and return the scorecard inline. Default: false (returns taskId immediately).")
-    },
-    async ({ beatId, projectId, wait }) => {
-      try {
-        await assertBeatInOrg(client, beatId, ctx.orgId);
-        const { taskId } = await client.checkBeatQuality(projectId, beatId);
-        if (!wait) {
-          return {
-            content: [{
-              type: "text",
-              text: `Quality check enqueued for ${beatId}.
+  const schema = {
+    beatId: external_exports.string().describe("The beat ID (e.g., TF-B-001)"),
+    projectId: external_exports.string().describe("The project ID"),
+    wait: external_exports.boolean().optional().describe("If true, block until the check completes and return the scorecard inline. Default: false (returns taskId immediately).")
+  };
+  const handler = async ({ beatId, projectId, wait }) => {
+    try {
+      await assertBeatInOrg(client, beatId, ctx.orgId);
+      const { taskId } = await client.checkBeatQuality(projectId, beatId);
+      if (!wait) {
+        return {
+          content: [{
+            type: "text",
+            text: `Quality check enqueued for ${beatId}.
 Job ID: ${taskId}
 
 Use get_job_status with jobId="${taskId}" to poll for results, or list_checks to retrieve the completed scorecard once done.`
-            }]
-          };
-        }
-        const check2 = await pollForCheck(client, taskId);
-        return { content: [{ type: "text", text: formatScorecard(check2) }] };
-      } catch (err) {
-        const message = err instanceof Error ? err.message : String(err);
-        return { content: [{ type: "text", text: `Quality check failed: ${message}` }], isError: true };
+          }]
+        };
       }
+      const check2 = await pollForCheck(client, taskId);
+      return { content: [{ type: "text", text: formatScorecard(check2) }] };
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      return { content: [{ type: "text", text: `Quality check failed: ${message}` }], isError: true };
+    }
+  };
+  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.",
+    schema,
+    handler
+  );
+  server.tool(
+    "check_beat_quality",
+    "DEPRECATED \u2014 renamed to check_beat_coda_quality (the check grades the Beat's definition: its Coda and directing context). This alias runs the same check and persists it as beat_coda_quality. Prefer check_beat_coda_quality.",
+    schema,
+    async (args) => {
+      console.warn("[deprecated-tool] check_beat_quality invoked \u2014 use check_beat_coda_quality (N-4E09-6779)");
+      return handler(args);
     }
   );
 }
@@ -22598,7 +22627,7 @@ ${beat.description}`);
   return sections.join("\n");
 }
 
-// ../../libs/harmonica-services/src/mcp/formatters/project-formatter.ts
+// ../../libs/harmonica-services/src/mcp/formatters/system-formatter.ts
 function formatProjectSummaryTable(projects) {
   if (projects.length === 0) return "_No projects found._";
   const header = "| Project ID | Title | Status |\n|------------|-------|--------|";
@@ -22747,7 +22776,8 @@ function formatNoteSummary(note) {
   const crit = note.criticality != null ? ` (criticality: ${note.criticality.toFixed(2)})` : "";
   const scope = note.beatId ? ` [Beat: ${note.beatId}]` : "";
   const rev = note.revisionId ? ` [Rev: ${note.revisionId}]` : "";
-  return `- **${type}** (${note.noteId})${status}${crit}${scope}${rev}: ${note.content}`;
+  const bv = note.beatVersionId ? ` [BV: ${note.beatVersionId}]` : "";
+  return `- **${type}** (${note.noteId})${status}${crit}${scope}${rev}${bv}: ${note.content}`;
 }
 function formatNoteList(notes) {
   if (notes.length === 0) {
@@ -22805,6 +22835,9 @@ function formatNoteDetail(note) {
   if (note.revisionId) {
     parts.push(`**Revision:** ${note.revisionId}`);
   }
+  if (note.beatVersionId) {
+    parts.push(`**Beat Version:** ${note.beatVersionId}`);
+  }
   if (note.assumptionMeta) {
     parts.push("", "### Assumption Details");
     parts.push(`- Confidence: ${note.assumptionMeta.confidence}`);
@@ -23018,7 +23051,7 @@ function registerBeatTools(server, ctx, client) {
     },
     async ({ projectId, offset = 0, limit = 100, includeArchived }) => {
       await assertProjectInOrg(client, projectId, ctx.orgId);
-      let beats = await client.listProjectBeats(projectId);
+      let beats = await client.listSystemBeats(projectId);
       if (!includeArchived) {
         beats = beats.filter((b) => b.beatStatus !== "archived");
       }
@@ -23360,7 +23393,7 @@ function registerBeatVersionTools(server, ctx, client) {
   );
   server.tool(
     "create_beat_version",
-    "Create a new Beat Version for an existing Beat. A Beat Version is a shippable increment \u2014 one planned delivery of the Beat's capability. Starts at active status (binary: active | archived). Run check_plan_quality on the Beat Version BEFORE creating its first Revision \u2014 the first Revision is gated on a recent, passing plan_quality check.",
+    "Create a new Beat Version for an existing Beat. A Beat Version is a shippable increment \u2014 one planned delivery of the Beat's capability. Starts at active status (binary: active | archived). Run check_beat_version_quality on the Beat Version BEFORE creating its first Revision \u2014 the first Revision is gated on a recent, passing beat_version_quality check.",
     {
       beatId: external_exports.string().describe("The Beat ID to create the Beat Version on"),
       title: external_exports.string().min(1).max(300).describe("What this Beat Version delivers (concise, outcome-focused)"),
@@ -23417,7 +23450,7 @@ function registerBeatVersionTools(server, ctx, client) {
           `**Status:** ${beatVersion.status}`,
           `**Version:** v${beatVersion.versionNumber}`,
           "",
-          `Next step: Run check_plan_quality on this Beat Version before creating its first Revision (the first Revision is gated on a passing plan_quality check).`
+          `Next step: Run check_beat_version_quality on this Beat Version before creating its first Revision (the first Revision is gated on a passing beat_version_quality check).`
         ];
         return { content: [{ type: "text", text: lines.join("\n") }] };
       } catch (err) {
@@ -23428,7 +23461,7 @@ function registerBeatVersionTools(server, ctx, client) {
   );
   server.tool(
     "update_beat_version",
-    "Update a Beat Version's content fields (title, description, scope, assignees, etc.). Does NOT change lifecycle state \u2014 use transition_beat_version for that. Editing the Beat Version after a plan_quality check will invalidate the check \u2014 re-run before creating its first Revision.",
+    "Update a Beat Version's content fields (title, description, scope, assignees, etc.). Does NOT change lifecycle state \u2014 use transition_beat_version for that. Editing the Beat Version after a beat_version_quality check will invalidate the check \u2014 re-run before creating its first Revision.",
     {
       beatVersionId: external_exports.string().describe("The Beat Version ID (e.g., bv-abc123)"),
       title: external_exports.string().min(1).max(300).optional().describe("New title"),
@@ -23481,9 +23514,9 @@ function registerBeatVersionTools(server, ctx, client) {
   );
   server.tool(
     "plan_beat_versions",
-    "Agent-decompose a composed Beat into 2-5 planning-state Beat Versions on the path to the Coda. Uses the Beat's Coda, project strategy, sibling Beats, Notes, and codebase grep as context. Requires a recent passing beat_quality check (run check_beat_quality first if needed). Idempotent: refuses when planned BVs already exist on the Beat unless force=true is set.",
+    "Agent-decompose a composed Beat into 2-5 planning-state Beat Versions on the path to the Coda. Uses the Beat's Coda, project strategy, sibling Beats, Notes, and codebase grep as context. Requires a recent passing beat_coda_quality check (run check_beat_coda_quality first if needed). Idempotent: refuses when planned BVs already exist on the Beat unless force=true is set.",
     {
-      beatId: external_exports.string().describe("The Beat ID to decompose (must have a Coda and a passing beat_quality check)"),
+      beatId: external_exports.string().describe("The Beat ID to decompose (must have a Coda and a passing beat_coda_quality check)"),
       force: external_exports.boolean().optional().describe("Bypass the idempotency guard and plan additional Beat Versions even when prior planned BVs are still active")
     },
     async ({ beatId, force }) => {
@@ -23499,7 +23532,7 @@ function registerBeatVersionTools(server, ctx, client) {
           lines.push(`- **${bv.beatVersionId}** v${bv.versionNumber} [${bv.status}]: ${bv.title}`);
           if (bv.changeSummary) lines.push(`  Change: ${bv.changeSummary}`);
         }
-        lines.push("", "Run check_plan_quality on each Beat Version before creating its first Revision (the first Revision is gated on a passing plan_quality check).");
+        lines.push("", "Run check_beat_version_quality on each Beat Version before creating its first Revision (the first Revision is gated on a passing beat_version_quality check).");
         return { content: [{ type: "text", text: lines.join("\n") }] };
       } catch (err) {
         if (err instanceof BeatQualityGateError) {
@@ -23536,7 +23569,7 @@ function registerBeatVersionTools(server, ctx, client) {
   );
   server.tool(
     "transition_beat_version",
-    'Transition a Beat Version between binary statuses: active \u2194 archived. Archiving requires a reason; reviving an archived Beat Version back to active does not. Pipeline position ("where is this?") is derived from child Revisions and the Drop, not from status. plan_quality is now enforced at first-Revision creation, not on any Beat Version transition.',
+    'Transition a Beat Version between binary statuses: active \u2194 archived. Archiving requires a reason; reviving an archived Beat Version back to active does not. Pipeline position ("where is this?") is derived from child Revisions and the Drop, not from status. beat_version_quality is now enforced at first-Revision creation, not on any Beat Version transition.',
     {
       beatVersionId: external_exports.string().describe("The Beat Version ID (e.g., bv-abc123)"),
       targetState: external_exports.enum(BEAT_VERSION_STATUSES).describe("The target status (active | archived)"),
@@ -23673,12 +23706,41 @@ function registerCadenceScheduleTools(server, _ctx, client) {
   );
 }
 
+// ../../libs/harmonica-services/src/check-target-validation.ts
+function isBeatVersionTargetId(targetId) {
+  return /^bv-\S/.test(targetId);
+}
+function beatVersionQualityTargetError(targetId) {
+  if (typeof targetId !== "string") {
+    return "beat_version_quality requires a Beat Version ID (bv-\u2026), but no targetId was provided.";
+  }
+  if (targetId.startsWith("rev-")) {
+    return "beat_version_quality targets a Beat Version, not a Revision \u2014 pass a Beat Version ID (bv-\u2026). Revisions inherit their parent Beat Version's plan and grade; run beat_version_quality on the parent Beat Version, or build_quality for a build-readiness grade.";
+  }
+  if (!isBeatVersionTargetId(targetId)) {
+    return `beat_version_quality requires a Beat Version ID (bv-\u2026), got '${targetId}'.`;
+  }
+  return null;
+}
+function isRevisionTargetId(targetId) {
+  return /^rev-\S/.test(targetId);
+}
+function revisionQualityTargetError(targetId) {
+  if (typeof targetId !== "string" || !isRevisionTargetId(targetId)) {
+    return `revision_quality runs only on Revisions (rev-*); got "${targetId ?? ""}". For a Beat Version, run beat_version_quality on the Beat Version.`;
+  }
+  return null;
+}
+
 // ../../libs/harmonica-services/src/build-quality/target-validation.ts
 function buildQualityTargetError(targetId) {
+  if (typeof targetId !== "string") {
+    return "build_quality requires a Beat Version ID (bv-\u2026), but no targetId was provided.";
+  }
   if (targetId.startsWith("rev-")) {
     return "build_quality now targets a Beat Version, not a Revision \u2014 pass a Beat Version ID (bv-\u2026). The check moved to the Beat Version so it grades the planned capability against the codebase and runs even when there are no Revisions yet.";
   }
-  if (!/^bv-\S/.test(targetId)) {
+  if (!isBeatVersionTargetId(targetId)) {
     return `build_quality requires a Beat Version ID (bv-\u2026), got '${targetId}'.`;
   }
   return null;
@@ -23713,7 +23775,7 @@ function registerCheckTools(server, ctx, client) {
       beatId: external_exports.string().optional().describe("List checks for this specific beat"),
       beatVersionId: external_exports.string().optional().describe("List checks for this specific beat version"),
       revisionId: external_exports.string().optional().describe("List checks for this specific revision"),
-      checkType: external_exports.enum(["beat_quality", "plan_quality", "build_quality", "pii_scan", "portfolio_coherence"]).optional().describe("Filter by check type")
+      checkType: external_exports.enum(["beat_coda_quality", "beat_quality", "beat_version_quality", "plan_quality", "build_quality", "pii_scan", "portfolio_coherence"]).optional().describe("Filter by check type. beat_quality is the DEPRECATED alias of beat_coda_quality. plan_quality is the DEPRECATED alias of beat_version_quality. pii_scan is RETIRED from the taxonomy (PII detection moved to the Scan family, N-4E09-6809) \u2014 it is still accepted here so historical records stay readable, but no new pii_scan checks are written.")
     },
     async ({ projectId, beatId, beatVersionId, revisionId, checkType }) => {
       try {
@@ -23803,7 +23865,7 @@ function registerCheckTools(server, ctx, client) {
           checks = await client.listBeatChecks(beatId, projectId, checkType);
           scope = `beat ${beatId}`;
         } else {
-          const result = await client.listProjectChecks(projectId, checkType, { limit: 200 });
+          const result = await client.listSystemChecks(projectId, checkType, { limit: 200 });
           checks = result.checks;
           scope = `project ${projectId}`;
         }
@@ -23840,10 +23902,10 @@ function registerCheckTools(server, ctx, client) {
   );
   server.tool(
     "run_check",
-    "Run a check on a Beat or Beat Version. beat_quality: 6-dimension Beat quality (1-5), target a beatId. plan_quality: 6-dimension plan quality (1-5), target a Beat Version (bv-*). build_quality: 8-dimension engineering assessment (1-5), target a Beat Version (bv-*) \u2014 build_quality moved from the Revision to the Beat Version, so it grades the planned capability against the codebase and runs even when the Beat Version has no Revisions yet.",
+    "Run a check on a Beat or Beat Version. beat_coda_quality: 7-dimension Beat definition quality (1-5) \u2014 grades the Coda and directing context, target a beatId (beat_quality is its DEPRECATED alias and persists under the new name). beat_version_quality: 7-dimension plan quality (1-5) including completeness, target a Beat Version (bv-*) \u2014 plan_quality is its DEPRECATED alias. build_quality: 9-dimension engineering assessment (1-5), target a Beat Version (bv-*) \u2014 build_quality moved from the Revision to the Beat Version, so it grades the planned capability against the codebase and runs even when the Beat Version has no Revisions yet.",
     {
-      checkType: external_exports.enum(["beat_quality", "plan_quality", "build_quality"]).describe("Type of check to run"),
-      targetId: external_exports.string().describe("The target entity ID \u2014 a beatId for beat_quality, or a Beat Version ID (bv-*) for plan_quality and build_quality"),
+      checkType: external_exports.enum(["beat_coda_quality", "beat_quality", "beat_version_quality", "plan_quality", "build_quality"]).describe("Type of check to run. beat_quality is the deprecated alias of beat_coda_quality. plan_quality is the deprecated alias of beat_version_quality."),
+      targetId: external_exports.string().describe("The target entity ID \u2014 a beatId for beat_coda_quality, or a Beat Version ID (bv-*) for beat_version_quality and build_quality"),
       projectId: external_exports.string().describe("The project ID"),
       branch: external_exports.string().optional().describe("Override the git branch for code checks (default: project default branch)"),
       localPath: external_exports.string().optional().describe("Absolute path to an already-cloned local copy of the repo \u2014 skips git clone entirely (useful for large repos or offline use)")
@@ -23851,11 +23913,9 @@ function registerCheckTools(server, ctx, client) {
     async ({ checkType, targetId, projectId, branch, localPath }) => {
       try {
         await assertProjectInOrg(client, projectId, ctx.orgId);
-        if (checkType === "build_quality") {
-          const targetError = buildQualityTargetError(targetId);
-          if (targetError) {
-            return { content: [{ type: "text", text: targetError }], isError: true };
-          }
+        const targetError = checkType === "build_quality" ? buildQualityTargetError(targetId) : checkType === "beat_version_quality" || checkType === "plan_quality" ? beatVersionQualityTargetError(targetId) : null;
+        if (targetError) {
+          return { content: [{ type: "text", text: targetError }], isError: true };
         }
         const opts = branch || localPath ? { branch, localPath } : void 0;
         const task = await client.runCheck(projectId, checkType, targetId, opts);
@@ -23876,10 +23936,13 @@ function registerCheckTools(server, ctx, client) {
   );
 }
 var CHECK_TYPE_DISPLAY = {
-  beat_quality: "Quality",
-  plan_quality: "Plan Quality",
+  beat_coda_quality: "Coda Quality",
+  beat_quality: "Coda Quality",
+  beat_version_quality: "Beat Version Quality",
+  plan_quality: "Beat Version Quality",
   build_quality: "Build Quality",
-  pii_scan: "PII Scan",
+  // Retired (B-308 v3) — label retained so historical records never render unlabeled.
+  pii_scan: "PII Scan (retired)",
   portfolio_coherence: "Portfolio Coherence"
 };
 function formatCheck(a) {
@@ -24047,6 +24110,11 @@ function registerDeliverableGroupTools(server, ctx, client) {
           content: [{ type: "text", text: `DeliverableGroup not found: ${deliverableGroupId}` }]
         };
       }
+      if (g.orgId !== ctx.orgId) {
+        throw new Error(
+          `DeliverableGroup "${deliverableGroupId}" does not belong to the configured organization. Access denied.`
+        );
+      }
       const lines = [
         `ID: ${g.deliverableGroupId}`,
         `Code: ${g.groupCode}`,
@@ -24055,6 +24123,10 @@ function registerDeliverableGroupTools(server, ctx, client) {
         `Status: ${g.status}`,
         `VU Rate: ${g.vuRate}`,
         g.description ? `Description: ${g.description}` : null,
+        g.deliverables ? `Deliverables:
+${g.deliverables}` : null,
+        g.acceptanceCriteria ? `Acceptance Criteria:
+${g.acceptanceCriteria}` : null,
         g.parentGroupId ? `Parent Group: ${g.parentGroupId}` : null,
         g.proposedAt ? `Proposed: ${g.proposedAt}` : null,
         g.approvedAt ? `Approved: ${g.approvedAt}` : null,
@@ -24220,51 +24292,6 @@ function registerDeliverableGroupTools(server, ctx, client) {
       return { content: [{ type: "text", text }] };
     }
   );
-  server.tool(
-    "assign_beat_version_to_deliverable_group",
-    'Assign a Beat Version to a DeliverableGroup (the Work Plan / WBS link). A Beat Version belongs to at most one group; assigning moves it if it was in another group. Use to answer "put this feature increment under this SOW/phase".',
-    {
-      deliverableGroupId: external_exports.string().describe("The DeliverableGroup ID"),
-      beatVersionId: external_exports.string().describe("The Beat Version ID to place in the group")
-    },
-    async ({ deliverableGroupId, beatVersionId }) => {
-      await assertDeliverableGroupInOrg(client, deliverableGroupId, ctx.orgId);
-      const bv = await client.getBeatVersion(beatVersionId);
-      if (!bv) {
-        return { content: [{ type: "text", text: `Beat Version not found: ${beatVersionId}` }] };
-      }
-      await assertProjectInOrg(client, bv.projectId, ctx.orgId);
-      const ok = await client.setBeatVersionDeliverableGroup(deliverableGroupId, beatVersionId);
-      if (!ok) {
-        return { content: [{ type: "text", text: `Beat Version not found: ${beatVersionId}` }] };
-      }
-      return {
-        content: [{ type: "text", text: `Assigned Beat Version ${beatVersionId} to DeliverableGroup ${deliverableGroupId}.` }]
-      };
-    }
-  );
-  server.tool(
-    "clear_beat_version_deliverable_group",
-    'Remove a Beat Version from a DeliverableGroup (clears its Work Plan link). The Beat Version must currently belong to the named group. Use to answer "take this increment out of this SOW/phase".',
-    {
-      deliverableGroupId: external_exports.string().describe("The DeliverableGroup ID the Beat Version currently belongs to"),
-      beatVersionId: external_exports.string().describe("The Beat Version ID to remove from the group")
-    },
-    async ({ deliverableGroupId, beatVersionId }) => {
-      await assertDeliverableGroupInOrg(client, deliverableGroupId, ctx.orgId);
-      const bv = await client.getBeatVersion(beatVersionId);
-      if (!bv) {
-        return { content: [{ type: "text", text: `Beat Version not found: ${beatVersionId}` }] };
-      }
-      if (bv.deliverableGroupId !== deliverableGroupId) {
-        return { content: [{ type: "text", text: `Beat Version ${beatVersionId} is not a member of DeliverableGroup ${deliverableGroupId}.` }] };
-      }
-      await client.clearBeatVersionDeliverableGroup(deliverableGroupId, beatVersionId);
-      return {
-        content: [{ type: "text", text: `Cleared Beat Version ${beatVersionId} from DeliverableGroup ${deliverableGroupId}.` }]
-      };
-    }
-  );
   server.tool(
     "assign_drop_to_deliverable_group",
     `Link a Drop to a DeliverableGroup so it appears on the parent Movement's timed-release axis (the Drops shown on the Movement overview). A Drop belongs to at most one group; linking moves it if it was in another group. Use to answer "put this release under this SOW/phase" or "add a Drop to this Movement".`,
@@ -24290,17 +24317,20 @@ function registerDeliverableGroupTools(server, ctx, client) {
   );
   server.tool(
     "list_deliverable_group_beat_versions",
-    'List the Beat Versions assigned to a DeliverableGroup (its Work Plan). Use to answer "what feature increments are scoped under this SOW/phase?"',
+    'List the Beat Versions linked to a DeliverableGroup via its work items (Work Plan). Use to answer "what feature increments are scoped under this SOW/phase?"',
     {
       deliverableGroupId: external_exports.string().describe("The DeliverableGroup ID")
     },
     async ({ deliverableGroupId }) => {
       await assertDeliverableGroupInOrg(client, deliverableGroupId, ctx.orgId);
-      const items = await client.listDeliverableGroupBeatVersions(deliverableGroupId);
-      if (items.length === 0) {
-        return { content: [{ type: "text", text: "No beat versions in this group." }] };
-      }
-      const hydrated = await Promise.all(items.map((b) => client.getBeatVersion(b.beatVersionId)));
+      const workItems = await client.listTrackWorkItems(deliverableGroupId);
+      const bvIds = [...new Set(
+        workItems.map((wi) => wi.beatVersionId).filter((id) => id !== void 0)
+      )];
+      if (bvIds.length === 0) {
+        return { content: [{ type: "text", text: "No beat versions linked via work items in this group." }] };
+      }
+      const hydrated = await Promise.all(bvIds.map((id) => client.getBeatVersion(id)));
       const text = hydrated.filter((bv) => bv !== void 0).map((bv) => `[${bv.beatVersionId}] v${bv.versionNumber} \u2014 ${bv.title} (${bv.status})`).join("\n");
       return { content: [{ type: "text", text }] };
     }
@@ -24421,7 +24451,7 @@ function formatDownbeatHarmonyReport(r) {
 function registerDownbeatHarmonyReportTools(server, _ctx, client) {
   server.tool(
     "get_downbeat_harmony_report",
-    "Get the Downbeat Harmony Report: a read-only qualification advisor that extends the Pulse report's per-Beat signals (increments since Downbeat, edited-goal drift, relational drift) with a Measure/convergence mismatch check, and returns which open Beats under an Account qualify for a Downbeat this cycle \u2014 citing exactly which signal(s) triggered each one. Never anchors a Downbeat; the caller decides whether to accept and calls set_downbeat per qualifying Beat themselves.",
+    "Get the Downbeat Harmony Report: a read-only qualification advisor that extends the Pulse report's per-Beat signals (increments since Downbeat, edited-goal drift, relational drift) with a work-item/convergence mismatch check, and returns which open Beats under an Account qualify for a Downbeat this cycle \u2014 citing exactly which signal(s) triggered each one. Never anchors a Downbeat; the caller decides whether to accept and calls set_downbeat per qualifying Beat themselves.",
     {
       accountId: external_exports.string().describe("The Account ID"),
       asOf: external_exports.string().datetime().optional().describe("ISO 8601 timestamp used only to stamp the report header. The underlying signals always reflect current state. Defaults to the current time.")
@@ -24615,7 +24645,15 @@ function registerDropQualityTools(server, ctx, client) {
 
 // ../../libs/harmonica-services/src/mcp/tools/drop-tools.ts
 var DROP_STATES = ["draft", "open", "released", "rolled_back", "cancelled"];
-var FEATURE_FLAG_STAGES = ["local", "staging", "prod"];
+var FEATURE_FLAG_STAGES = [
+  "local",
+  "staging",
+  "staging-alpha",
+  "staging-beta",
+  "alpha",
+  "beta",
+  "prod"
+];
 var featureFlagBindingSchema = external_exports.object({
   scope: external_exports.string().min(1).max(100).describe('Feature-flag scope, e.g. "harmonica"'),
   name: external_exports.string().min(1).max(200).describe("Feature-flag name within the scope"),
@@ -25329,166 +25367,6 @@ ${formatLayerDetail(layer)}` }] };
   );
 }
 
-// ../../libs/harmonica-services/src/mcp/tools/measure-tools.ts
-var VU_ENUM = ["XS", "S", "M", "L", "XL"];
-function vu(valueUnit) {
-  return valueUnit ?? "(hidden)";
-}
-function registerMeasureTools(server, _ctx, client) {
-  server.tool(
-    "list_track_measures",
-    'List all Measures under a Track (DeliverableGroup). A Measure is the atomic unit of planned work carrying a Value Unit estimate. Recognition cues: "what work is planned on this track", "list the measures" \u2192 list_track_measures.',
-    {
-      trackId: external_exports.string().describe("The Track (DeliverableGroup) ID")
-    },
-    async ({ trackId }) => {
-      const measures = await client.listTrackMeasures(trackId);
-      const text = measures.length === 0 ? "No measures found." : measures.map((m) => `[${m.measureId}] ${m.measureCode} \u2014 ${m.title} (VU: ${vu(m.valueUnit)})`).join("\n");
-      return { content: [{ type: "text", text }] };
-    }
-  );
-  server.tool(
-    "list_beat_version_measures",
-    'List the Measures linked to a Beat Version \u2014 answers "which planned work advances this Beat Version".',
-    {
-      beatVersionId: external_exports.string().describe("The Beat Version ID (e.g., bv-abc123)")
-    },
-    async ({ beatVersionId }) => {
-      const measures = await client.listBeatVersionMeasures(beatVersionId);
-      const text = measures.length === 0 ? "No measures found." : measures.map((m) => `[${m.measureId}] ${m.measureCode} \u2014 ${m.title} (VU: ${vu(m.valueUnit)})`).join("\n");
-      return { content: [{ type: "text", text }] };
-    }
-  );
-  server.tool(
-    "get_measure",
-    "Get a Measure by ID. Returns title, Value Unit estimate (if visible), Track, and any linked Beat Version.",
-    {
-      measureId: external_exports.string().describe("The measure ID (e.g., me-abc123)")
-    },
-    async ({ measureId }) => {
-      const m = await client.getMeasure(measureId);
-      if (!m) {
-        return { content: [{ type: "text", text: `Measure not found: ${measureId}` }] };
-      }
-      const lines = [
-        `ID: ${m.measureId}`,
-        `Code: ${m.measureCode}`,
-        `Title: ${m.title}`,
-        `Track: ${m.trackId}`,
-        `Value Unit: ${vu(m.valueUnit)}`,
-        m.beatVersionId ? `Beat Version: ${m.beatVersionId}` : null,
-        m.createdBy ? `Created By: ${m.createdBy}` : null,
-        `Created: ${m.createdAt}`,
-        `Updated: ${m.updatedAt}`
-      ].filter(Boolean).join("\n");
-      return { content: [{ type: "text", text: lines }] };
-    }
-  );
-  server.tool(
-    "create_measure",
-    "Create a Measure under a Track (DeliverableGroup). A Measure is the atomic unit of planned work with a Value Unit estimate \u2014 it is NOT a Beat. Optionally link it to a Beat Version at creation.",
-    {
-      trackId: external_exports.string().describe("The Track (DeliverableGroup) ID this Measure belongs to"),
-      title: external_exports.string().min(1).max(300).describe('Measure title (e.g. "Login form validation")'),
-      valueUnit: external_exports.enum(VU_ENUM).describe("Value Unit label estimate (t-shirt size XS\u2013XL)"),
-      beatVersionId: external_exports.string().min(1).max(128).optional().describe("Optional Beat Version to link at creation. Must exist."),
-      createdBy: external_exports.string().optional().describe("Optional creator identity for audit")
-    },
-    async ({ trackId, title, valueUnit, beatVersionId, createdBy }) => {
-      const m = await client.createMeasure({
-        trackId,
-        title,
-        valueUnit,
-        ...beatVersionId !== void 0 && { beatVersionId },
-        ...createdBy !== void 0 && { createdBy }
-      });
-      return {
-        content: [
-          {
-            type: "text",
-            text: `Created Measure: [${m.measureId}] ${m.measureCode} \u2014 ${m.title} (VU: ${vu(m.valueUnit)})`
-          }
-        ]
-      };
-    }
-  );
-  server.tool(
-    "update_measure",
-    "Update mutable content fields on a Measure (title, valueUnit). To change the Beat Version link use link_measure_to_beat_version / unlink_measure_from_beat_version instead.",
-    {
-      measureId: external_exports.string().describe("The measure ID"),
-      title: external_exports.string().min(1).max(300).optional().describe("New title"),
-      valueUnit: external_exports.enum(VU_ENUM).optional().describe("New Value Unit estimate")
-    },
-    async ({ measureId, title, valueUnit }) => {
-      const hasUpdates = title !== void 0 || valueUnit !== void 0;
-      if (!hasUpdates) {
-        return {
-          content: [{ type: "text", text: `No updates provided for Measure: ${measureId}` }],
-          isError: true
-        };
-      }
-      const m = await client.updateMeasure(measureId, {
-        ...title !== void 0 && { title },
-        ...valueUnit !== void 0 && { valueUnit }
-      });
-      if (!m) {
-        return {
-          content: [{ type: "text", text: `Measure not found: ${measureId}` }],
-          isError: true
-        };
-      }
-      return {
-        content: [
-          {
-            type: "text",
-            text: `Updated Measure: [${m.measureId}] ${m.measureCode} \u2014 ${m.title} (VU: ${vu(m.valueUnit)})`
-          }
-        ]
-      };
-    }
-  );
-  server.tool(
-    "link_measure_to_beat_version",
-    "Soft-link a Measure to a single Beat Version (the internal capability it advances). Replaces any existing link.",
-    {
-      measureId: external_exports.string().describe("The measure ID"),
-      beatVersionId: external_exports.string().describe("The Beat Version ID to link (e.g., bv-abc123). Must exist.")
-    },
-    async ({ measureId, beatVersionId }) => {
-      const m = await client.linkMeasureToBeatVersion(measureId, beatVersionId);
-      if (!m) {
-        return {
-          content: [{ type: "text", text: `Measure not found: ${measureId}` }],
-          isError: true
-        };
-      }
-      return {
-        content: [{ type: "text", text: `Linked Measure ${m.measureId} \u2192 Beat Version ${beatVersionId}` }]
-      };
-    }
-  );
-  server.tool(
-    "unlink_measure_from_beat_version",
-    "Remove a Measure's soft link to its Beat Version. No-op-safe: the Measure remains under its Track.",
-    {
-      measureId: external_exports.string().describe("The measure ID")
-    },
-    async ({ measureId }) => {
-      const m = await client.unlinkMeasureFromBeatVersion(measureId);
-      if (!m) {
-        return {
-          content: [{ type: "text", text: `Measure not found: ${measureId}` }],
-          isError: true
-        };
-      }
-      return {
-        content: [{ type: "text", text: `Unlinked Measure ${m.measureId} from its Beat Version` }]
-      };
-    }
-  );
-}
-
 // ../../libs/harmonica-services/src/mcp/tools/membership-tools.ts
 function registerMembershipTools(server, ctx, client) {
   server.tool(
@@ -25913,7 +25791,8 @@ var PLAN_QUALITY_DIMENSIONS = [
   "testable",
   "traceable",
   "assignable",
-  "riskAware"
+  "riskAware",
+  "completeness"
 ];
 var PlanDimensionScoreSchema = external_exports.object({
   dimension: external_exports.enum(PLAN_QUALITY_DIMENSIONS),
@@ -25928,6 +25807,27 @@ var PlanQualityLLMResponseSchema = external_exports.object({
   topSuggestion: external_exports.string()
 });
 
+// ../../libs/harmonica-schemas/src/revision-quality.ts
+var REVISION_QUALITY_DIMENSIONS = [
+  "scoped",
+  "traceable",
+  "testable",
+  "reviewReady",
+  "nonDuplicating"
+];
+var RevisionDimensionScoreSchema = external_exports.object({
+  dimension: external_exports.enum(REVISION_QUALITY_DIMENSIONS),
+  label: external_exports.string(),
+  score: external_exports.number().min(1).max(5),
+  rationale: external_exports.string(),
+  suggestions: external_exports.array(external_exports.string())
+});
+var RevisionQualityLLMResponseSchema = external_exports.object({
+  dimensions: external_exports.array(RevisionDimensionScoreSchema).min(1),
+  summary: external_exports.string(),
+  topSuggestion: external_exports.string()
+});
+
 // ../../libs/harmonica-schemas/src/beat-quality.ts
 var BEAT_QUALITY_DIMENSIONS = [
   "distinctive",
@@ -26741,24 +26641,15 @@ var MovementApiSchema = external_exports.object({
   updatedAt: external_exports.string()
 }).passthrough();
 var MovementsResponseSchema = external_exports.object({ movements: external_exports.array(MovementApiSchema) }).passthrough();
-var ValueUnitEstimateSchema = external_exports.enum(["XS", "S", "M", "L", "XL"]);
-var MeasureApiSchema = external_exports.object({
-  measureId: external_exports.string(),
-  measureCode: external_exports.string(),
-  trackId: external_exports.string(),
-  teamspaceId: external_exports.string(),
-  orgId: external_exports.string(),
-  title: external_exports.string(),
-  valueUnit: ValueUnitEstimateSchema.optional(),
-  beatVersionId: external_exports.string().optional(),
-  createdBy: external_exports.string().optional(),
-  version: external_exports.number().optional(),
-  createdAt: external_exports.string(),
-  updatedAt: external_exports.string()
-}).passthrough();
-var MeasuresResponseSchema = external_exports.object({ measures: external_exports.array(MeasureApiSchema) }).passthrough();
-var MeasureResponseSchema = external_exports.object({ measure: MeasureApiSchema }).passthrough();
 var WorkItemStatusSchema = external_exports.enum(["not_started", "in_progress", "blocked", "done"]);
+var WORK_ITEM_EFFORT_SIZES = [
+  "XS",
+  "S",
+  "M",
+  "L",
+  "XL"
+];
+var WorkItemEffortSizeSchema = external_exports.enum(WORK_ITEM_EFFORT_SIZES);
 var HumanAssigneeApiSchema = external_exports.object({
   name: external_exports.string(),
   email: external_exports.string()
@@ -26769,10 +26660,16 @@ var WorkItemApiSchema = external_exports.object({
   teamspaceId: external_exports.string(),
   orgId: external_exports.string(),
   title: external_exports.string(),
-  owner: HumanAssigneeApiSchema,
+  /** Optional since N-4E09-6672 — a work item may be unowned. */
+  owner: HumanAssigneeApiSchema.optional(),
   status: WorkItemStatusSchema,
   committedEstimateHours: external_exports.number().optional(),
   actualHours: external_exports.number().optional(),
+  /** Delivery lens — rough t-shirt effort sizing (N-4E09-6672). */
+  effortSize: WorkItemEffortSizeSchema.optional(),
+  /** Commercial lens — deliberately unblended with `effortSize` (N-4E09-6672). */
+  valueUnits: external_exports.number().optional(),
+  costPerValueUnit: external_exports.number().optional(),
   /** Optional capability-lineage link to a Beat Version (v2, N-4E09-6574). */
   beatVersionId: external_exports.string().optional(),
   createdBy: external_exports.string().optional(),
@@ -26916,7 +26813,6 @@ var WorkPlanBeatVersionApiSchema = external_exports.object({
   versionNumber: external_exports.number(),
   title: external_exports.string(),
   status: BeatVersionStatusSchema,
-  deliverableGroupId: external_exports.string().nullish(),
   // Derived Value Units (VU = Δf × W), read-only. 0 when the BV has no confirmed
   // value-velocity inputs. Computed server-side from the parent Beat's weight.
   // `.default(0)` tolerates a rolling deploy where an older API omits the field —
@@ -26928,6 +26824,19 @@ var WorkPlanBeatVersionApiSchema = external_exports.object({
 var DeliverableGroupBeatVersionsResponseSchema = external_exports.object({
   beatVersions: external_exports.array(WorkPlanBeatVersionApiSchema)
 }).passthrough();
+var RevisionClaimActorSchema = external_exports.union([
+  external_exports.object({ kind: external_exports.literal("user"), userId: external_exports.string() }),
+  external_exports.object({ kind: external_exports.literal("agent"), agentId: external_exports.string(), projectId: external_exports.string() })
+]);
+var RevisionClaimSchema = external_exports.object({
+  claimId: external_exports.string(),
+  status: external_exports.enum(["active", "archived"]),
+  actor: RevisionClaimActorSchema,
+  scope: external_exports.object({ type: external_exports.literal("revision"), revisionId: external_exports.string() })
+}).passthrough();
+var RevisionClaimsResponseSchema = external_exports.object({
+  claims: external_exports.array(RevisionClaimSchema)
+}).passthrough();
 
 // ../../libs/harmonica-services/src/mcp/tools/note-element-tools.ts
 var parentKindSchema = external_exports.enum(["notebook", "note"]);
@@ -27100,13 +27009,14 @@ var DECISION_SIGNIFICANCE_VALUES2 = ["strategic", "structural", "implementation"
 function registerNoteTools(server, ctx, client) {
   server.tool(
     "list_notes",
-    "List Notes for a project. Without beatId: returns all notes (project-level + beat-level). With beatId: returns only notes scoped to that beat. Filterable by type, status, revisionId, and significance. Use offset/limit to paginate beat-scoped results; use cursor for project-wide results.",
+    "List Notes for a project. Without beatId: returns all notes (project-level + beat-level). With beatId: returns only notes scoped to that beat. Filterable by type, status, revisionId, beatVersionId, and significance. Use offset/limit to paginate beat-scoped results; use cursor for project-wide results.",
     {
       projectId: external_exports.string().describe("The project ID"),
       beatId: external_exports.string().optional().describe("Scope to a specific beat (omit for all project notes)"),
       noteType: external_exports.union([external_exports.enum(NOTE_TYPE_VALUES), external_exports.array(external_exports.enum(NOTE_TYPE_VALUES)).min(1)]).optional().describe('Filter by note type \u2014 single value or array for multi-select (e.g. ["constraint", "assumption"])'),
       status: external_exports.enum(NOTE_STATUS_VALUES).optional().describe("Filter by status"),
       revisionId: external_exports.string().optional().describe("Filter to notes scoped to a specific revision"),
+      beatVersionId: external_exports.string().optional().describe("Filter to notes scoped to a specific Beat Version (planning increment)"),
       sourceDocumentNoteId: external_exports.string().optional().describe("Filter to notes extracted from a specific document (matches sourceSubmissionId)"),
       significance: external_exports.enum(DECISION_SIGNIFICANCE_VALUES2).optional().describe("Filter decision Notes by significance tier (strategic | structural | implementation). Notes without a significance value are treated as implementation."),
       offset: external_exports.coerce.number().int().min(0).default(0).describe("Notes to skip for pagination (applies to beat-scoped and source-document-filtered results only)"),
@@ -27114,7 +27024,7 @@ function registerNoteTools(server, ctx, client) {
       cursor: external_exports.string().optional().describe("Opaque pagination cursor from a previous response \u2014 use for project-wide note pagination (no beatId)"),
       orderBy: external_exports.enum(["newest", "oldest"]).optional().describe("Sort order \u2014 newest or oldest first. Applies to beat-scoped queries (beatId provided); omit to use DynamoDB scan order.")
     },
-    async ({ projectId, beatId, noteType, status, revisionId, sourceDocumentNoteId, significance, offset = 0, limit = 100, cursor, orderBy }) => {
+    async ({ projectId, beatId, noteType, status, revisionId, beatVersionId, sourceDocumentNoteId, significance, offset = 0, limit = 100, cursor, orderBy }) => {
       if (Array.isArray(noteType) && noteType.length === 0) {
         return { content: [{ type: "text", text: "noteType must not be an empty array \u2014 omit it to return all types." }], isError: true };
       }
@@ -27135,6 +27045,7 @@ function registerNoteTools(server, ctx, client) {
         noteType,
         status,
         revisionId,
+        beatVersionId,
         significance
       };
       let page;
@@ -27330,13 +27241,14 @@ function registerNoteTools(server, ctx, client) {
       content: external_exports.string().describe("The note content"),
       beatId: external_exports.string().optional().describe("Beat ID if this note is beat-scoped (requires projectId)"),
       revisionId: external_exports.string().optional().describe("Revision ID if this note is revision-scoped (requires projectId)"),
+      beatVersionId: external_exports.string().optional().describe("Beat Version ID if this note governs a specific planning increment (requires beatId)"),
       rationale: external_exports.string().optional().describe("Why this note exists"),
       confidence: external_exports.coerce.number().min(0).max(1).optional().describe("Confidence level for assumptions (0-1)"),
       affectsBeats: external_exports.array(external_exports.string()).optional().describe("Beat IDs this note impacts"),
       dependsOnNotes: external_exports.array(external_exports.string()).optional().describe("Note IDs this note depends on (child \u2192 parent links for consolidation)"),
       significance: external_exports.enum(DECISION_SIGNIFICANCE_VALUES2).optional().describe("Significance tier for decision Notes (strategic | structural | implementation). Defaults to implementation when unset. Only meaningful on noteType=decision.")
     },
-    async ({ projectId, teamspaceId, movementId, noteType, content, beatId, revisionId, rationale, confidence, affectsBeats, dependsOnNotes, significance }) => {
+    async ({ projectId, teamspaceId, movementId, noteType, content, beatId, revisionId, beatVersionId, rationale, confidence, affectsBeats, dependsOnNotes, significance }) => {
       try {
         if ([projectId, teamspaceId, movementId].filter(Boolean).length > 1) {
           return { content: [{ type: "text", text: "Specify at most one of projectId, teamspaceId, or movementId." }], isError: true };
@@ -27352,6 +27264,7 @@ function registerNoteTools(server, ctx, client) {
             projectId,
             beatId,
             revisionId,
+            beatVersionId,
             noteType,
             content,
             rationale,
@@ -28656,10 +28569,10 @@ async function pollForCheck3(client, taskId) {
       if (!task.result) throw new Error(`Task ${taskId} completed with no result`);
       return task.result;
     }
-    if (task.status === "failed") throw new Error(`Plan quality check failed: ${task.error ?? "unknown error"}`);
+    if (task.status === "failed") throw new Error(`Beat version quality check failed: ${task.error ?? "unknown error"}`);
     await new Promise((r) => setTimeout(r, POLL_INTERVAL_MS3));
   }
-  throw new Error(`Plan quality check timed out after ${POLL_TIMEOUT_MS3 / 1e3}s`);
+  throw new Error(`Beat version quality check timed out after ${POLL_TIMEOUT_MS3 / 1e3}s`);
 }
 function formatScorecard2(check2) {
   const bar = (score, max) => "\u2588".repeat(score) + "\u2591".repeat(max - score);
@@ -28669,8 +28582,8 @@ ${d.rationale}${d.suggestions?.length ? `
 \u2022 ${d.suggestions.join("\n\u2022 ")}` : ""}`
   ).join("\n\n");
   return [
-    `## Plan Quality Check \u2014 ${check2.targetId}`,
-    `**Overall Score:** ${check2.overallScore}/${CHECK_MAX_SCORES.plan_quality}`,
+    `## Beat Version Quality Check \u2014 ${check2.targetId}`,
+    `**Overall Score:** ${check2.overallScore}/${CHECK_MAX_SCORES.beat_version_quality}`,
     `**Summary:** ${check2.summary}`,
     check2.topSuggestion ? `**Top Suggestion:** ${check2.topSuggestion}` : "",
     "",
@@ -28678,48 +28591,63 @@ ${d.rationale}${d.suggestions?.length ? `
   ].filter(Boolean).join("\n");
 }
 function registerPlanQualityTools(server, ctx, client) {
-  server.tool(
-    "check_plan_quality",
-    "Enqueue a plan quality check across 6 dimensions (Scoped, Directional, Testable, Traceable, Assignable, Risk-aware) on a Beat Version. plan_quality is a Beat-Version-only check \u2014 run it on a Beat Version before creating its first Revision (the first Revision is gated on a passing BV plan_quality check). For a Revision, run check_build_quality instead. 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, omit wait and poll get_job_status separately to avoid session exhaustion.",
-    {
-      beatVersionId: external_exports.string().describe("The Beat Version ID (e.g., bv-abc123). plan_quality targets Beat Versions only."),
-      projectId: external_exports.string().describe("The project ID"),
-      wait: external_exports.boolean().optional().describe("If true, block until the check completes and return the scorecard inline. Default: false (returns taskId immediately).")
-    },
-    async ({ beatVersionId, projectId, wait }) => {
-      try {
-        if (!beatVersionId?.startsWith("bv-")) {
-          return {
-            content: [{
-              type: "text",
-              text: `Plan quality check failed: plan_quality runs only on Beat Versions (bv-*); got "${beatVersionId}". For a Revision, run check_build_quality on the Revision, or run check_plan_quality on its parent Beat Version.`
-            }],
-            isError: true
-          };
-        }
-        await assertProjectInOrg(client, projectId, ctx.orgId);
-        const task = await client.runCheck(projectId, "plan_quality", beatVersionId);
-        if (!wait) {
-          return {
-            content: [{
-              type: "text",
-              text: `Plan quality check enqueued for ${beatVersionId}.
+  const schema = {
+    beatVersionId: external_exports.string().describe("The Beat Version ID (e.g., bv-abc123). beat_version_quality targets Beat Versions only."),
+    projectId: external_exports.string().describe("The project ID"),
+    // The completeness dimension probes the codebase, so this tool accepts the
+    // same repo overrides as run_check — without them the probe could only ever
+    // read the default branch from this surface.
+    branch: external_exports.string().optional().describe("Override the git branch the completeness dimension probes (default: the branch of an open child Revision, else the project default branch)"),
+    localPath: external_exports.string().optional().describe("Absolute path to an already-cloned local copy of the repo \u2014 the completeness probe reads it instead of cloning"),
+    wait: external_exports.boolean().optional().describe("If true, block until the check completes and return the scorecard inline. Default: false (returns taskId immediately).")
+  };
+  const handler = async ({ beatVersionId, projectId, branch, localPath, wait }) => {
+    try {
+      const targetError = beatVersionQualityTargetError(beatVersionId ?? "");
+      if (targetError) {
+        return {
+          content: [{ type: "text", text: `Beat version quality check failed: ${targetError}` }],
+          isError: true
+        };
+      }
+      await assertProjectInOrg(client, projectId, ctx.orgId);
+      const opts = branch || localPath ? { branch, localPath } : void 0;
+      const task = await client.runCheck(projectId, "beat_version_quality", beatVersionId, opts);
+      if (!wait) {
+        return {
+          content: [{
+            type: "text",
+            text: `Beat version quality check enqueued for ${beatVersionId}.
 Job ID: ${task.taskId}
 
 Use get_job_status with jobId="${task.taskId}" to poll for results, or list_checks to retrieve the completed scorecard once done.`
-            }]
-          };
-        }
-        const check2 = await pollForCheck3(client, task.taskId);
-        return { content: [{ type: "text", text: formatScorecard2(check2) }] };
-      } catch (err) {
-        const message = err instanceof Error ? err.message : String(err);
-        return { content: [{ type: "text", text: `Plan quality check failed: ${message}` }], isError: true };
+          }]
+        };
       }
+      const check2 = await pollForCheck3(client, task.taskId);
+      return { content: [{ type: "text", text: formatScorecard2(check2) }] };
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      return { content: [{ type: "text", text: `Beat version quality check failed: ${message}` }], isError: true };
     }
+  };
+  server.tool(
+    "check_beat_version_quality",
+    "Enqueue a Beat Version quality check across 7 dimensions (Scoped, Directional, Testable, Traceable, Assignable, Risk-aware, Completeness) on a Beat Version. beat_version_quality is a Beat-Version-only check \u2014 run it on a Beat Version before creating its first Revision (the first Revision is gated on a passing BV beat_version_quality check). For a Revision, run check_build_quality instead. 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, omit wait and poll get_job_status separately to avoid session exhaustion.",
+    schema,
+    handler
   );
-}
-
+  server.tool(
+    "check_plan_quality",
+    "DEPRECATED \u2014 renamed to check_beat_version_quality (the check grades the Beat Version's planning increment: its plan dimensions and completeness against the codebase). This alias runs the same check and persists it as beat_version_quality. Prefer check_beat_version_quality.",
+    schema,
+    async (args) => {
+      console.warn("[deprecated-tool] check_plan_quality invoked \u2014 use check_beat_version_quality");
+      return handler(args);
+    }
+  );
+}
+
 // ../../libs/harmonica-services/src/mcp/tools/portfolio-coherence-tools.ts
 var POLL_INTERVAL_MS4 = 4e3;
 var POLL_TIMEOUT_MS4 = 18e4;
@@ -28882,7 +28810,7 @@ function registerPortfolioCoherenceTools(server, ctx, client) {
             isError: true
           };
         }
-        const allProjectBeats = await client.listProjectBeats(projectId);
+        const allProjectBeats = await client.listSystemBeats(projectId);
         const beatMap = new Map(allProjectBeats.map((b) => [b.beatId, b]));
         const primaryBeat = beatMap.get(resolvedPrimaryId);
         if (!primaryBeat) {
@@ -28967,269 +28895,6 @@ function registerPortfolioCoherenceTools(server, ctx, client) {
   );
 }
 
-// ../../libs/harmonica-services/src/mcp/tools/project-lifecycle-tools.ts
-function registerProjectLifecycleTools(server, ctx, client) {
-  server.tool(
-    "transition_system_lifecycle",
-    "Advance a System's capability-maturity lifecycle state. Allowed transitions follow the state machine (Concept \u2192 Incubating \u2192 Piloting \u2192 Activated \u2192 Commercializing \u2192 Scaled, plus paused/killed/sunset/archived exits). The activated \u2192 commercializing edge requires a `decisionNoteId` pointing to a system-scoped Decision Note (the governance review). Other gates are advisory.",
-    {
-      systemId: external_exports.string().describe("The system ID"),
-      targetState: external_exports.enum([
-        "concept",
-        "incubating",
-        "piloting",
-        "activated",
-        "commercializing",
-        "scaled",
-        "paused",
-        "killed",
-        "sunset",
-        "archived"
-      ]).describe("Target lifecycle state. Active: concept, incubating, piloting, activated, commercializing, scaled. Exits: paused, killed, sunset, archived."),
-      reason: external_exports.string().optional().describe("Why this transition is being made (recorded in audit metadata)"),
-      decisionNoteId: external_exports.string().optional().describe("Note ID of the governance Decision Note. Required for the activated \u2192 commercializing transition; optional otherwise.")
-    },
-    async ({ systemId, targetState, reason, decisionNoteId }) => {
-      try {
-        const system = await client.getSystem(systemId);
-        if (!system) {
-          return { content: [{ type: "text", text: `System not found: "${systemId}"` }], isError: true };
-        }
-        if (system.orgId !== ctx.orgId) {
-          return { content: [{ type: "text", text: `System "${systemId}" is not in this organization` }], isError: true };
-        }
-        const result = await client.transitionProjectLifecycleState(systemId, targetState, {
-          actor: { type: "human", id: ctx.user.userId, name: ctx.user.name },
-          reason,
-          decisionNoteId
-        });
-        if (!result.success) {
-          const failedGates = result.error?.failedGates?.length ? ` (failed gates: ${result.error.failedGates.join(", ")})` : "";
-          return {
-            content: [{ type: "text", text: `Transition failed: ${result.error?.message ?? "Unknown error"}${failedGates}` }],
-            isError: true
-          };
-        }
-        const lines = [
-          `System lifecycle transitioned successfully.`,
-          "",
-          `**System:** ${systemId}`,
-          `**Title:** ${system.title}`,
-          `**Transition:** ${result.previousState} \u2192 ${result.newState}`
-        ];
-        if (reason) lines.push(`**Reason:** ${reason}`);
-        if (decisionNoteId) lines.push(`**Decision Note:** ${decisionNoteId}`);
-        return { content: [{ type: "text", text: lines.join("\n") }] };
-      } catch (err) {
-        const message = err instanceof Error ? err.message : String(err);
-        return { content: [{ type: "text", text: `Failed to transition system lifecycle: ${message}` }], isError: true };
-      }
-    }
-  );
-}
-
-// ../../libs/harmonica-services/src/mcp/tools/project-tools.ts
-var import_crypto5 = require("crypto");
-function accountLine(request, resolved) {
-  const requested = request["accountId"];
-  if (requested === null || requested === "") return "**Account:** (unlinked)";
-  return resolved ? `**Account:** ${resolved}` : "";
-}
-var PROJECT_EMBEDDING_FIELDS = ["title", "description", "strategy"];
-function registerProjectTools(server, ctx, client) {
-  const listSystemsHandler = async ({ teamspaceId }) => {
-    try {
-      const projects = await client.listOrgSystems(ctx.orgId);
-      const trimmed = teamspaceId?.trim();
-      const filtered = trimmed ? projects.filter((p) => p.teamspaceId === trimmed) : projects;
-      const text = formatProjectSummaryTable(filtered);
-      return { content: [{ type: "text", text }] };
-    } catch (err) {
-      const message = err instanceof Error ? err.message : String(err);
-      return { content: [{ type: "text", text: `Failed to list systems: ${message}` }], isError: true };
-    }
-  };
-  server.tool(
-    "list_systems",
-    "List all systems (projects) in the configured organization",
-    {
-      teamspaceId: external_exports.string().optional().describe("Filter to systems belonging to a specific teamspace. Empty or whitespace-only treated as no filter.")
-    },
-    listSystemsHandler
-  );
-  const getSystemContextSchema = {
-    systemId: external_exports.string().describe("The system ID"),
-    noteLimit: external_exports.number().int().min(1).max(MAX_CONTEXT_NOTE_LIMIT).optional().describe(
-      `Max Notes to include, prioritised by note type (default ${DEFAULT_CONTEXT_NOTE_LIMIT}, max ${MAX_CONTEXT_NOTE_LIMIT}). Use list_notes or search for the full set.`
-    )
-  };
-  const getSystemContextHandler = async ({
-    systemId,
-    noteLimit
-  }) => {
-    try {
-      const [project, org] = await Promise.all([
-        fetchProjectInOrg(client, systemId, ctx.orgId),
-        client.getOrg(ctx.orgId)
-      ]);
-      const notes = await client.listProjectNotes(systemId, {
-        limit: noteLimit ?? DEFAULT_CONTEXT_NOTE_LIMIT
-      });
-      const text = formatProjectContext(project, notes, org?.coda);
-      return { content: [{ type: "text", text }] };
-    } catch (err) {
-      const message = err instanceof Error ? err.message : String(err);
-      return { content: [{ type: "text", text: `Failed to get system context: ${message}` }], isError: true };
-    }
-  };
-  server.tool(
-    "get_system_context",
-    "Get system metadata, description, and notes in one view",
-    getSystemContextSchema,
-    getSystemContextHandler
-  );
-  const updateSystemSchema = {
-    systemId: external_exports.string().describe("The system ID"),
-    title: external_exports.string().optional().describe("New system title"),
-    description: external_exports.string().optional().describe("New system description"),
-    strategy: external_exports.string().optional().describe('System strategy markdown \u2014 Org Strategy + System Strategy ("System Coda")'),
-    teamspaceId: external_exports.string().nullable().optional().describe("Teamspace ID to associate this system with; pass null to remove the association"),
-    accountId: external_exports.string().nullable().optional().describe("Account that owns this System \u2014 the client or internal org unit. Pass null (or an empty string) to unlink. Reassigning moves the System so it is listed under exactly one Account."),
-    repoOwner: external_exports.string().optional().describe("GitHub repository owner (org or user)"),
-    repoName: external_exports.string().optional().describe("GitHub repository name"),
-    repoDefaultBranch: external_exports.string().optional().describe('Default branch for code check (defaults to "main")'),
-    rateLimitOverrides: external_exports.record(external_exports.string(), external_exports.object({ maxPerHour: external_exports.number().min(0) })).optional().describe('Per-task-type rate limit overrides, e.g. {"agent_chat":{"maxPerHour":100}}. Overrides env var and compiled defaults.')
-  };
-  const updateSystemHandler = async ({ systemId, ...updates }) => {
-    try {
-      const nonEmpty = Object.fromEntries(
-        Object.entries(updates).filter(([, v]) => v !== void 0)
-      );
-      if (Object.keys(nonEmpty).length === 0) {
-        return { content: [{ type: "text", text: "No updates provided." }], isError: true };
-      }
-      await assertProjectInOrg(client, systemId, ctx.orgId);
-      if (nonEmpty["accountId"] === "") nonEmpty["accountId"] = null;
-      if (typeof updates.teamspaceId === "string") {
-        const teamspace = await client.getTeamspace(updates.teamspaceId);
-        if (!teamspace) {
-          return { content: [{ type: "text", text: "Teamspace not found" }], isError: true };
-        }
-        if (teamspace.orgId !== ctx.orgId) {
-          return { content: [{ type: "text", text: "Teamspace does not belong to this organization" }], isError: true };
-        }
-      }
-      const updated = await client.updateSystem(systemId, nonEmpty);
-      if (!updated) {
-        return { content: [{ type: "text", text: `System not found: "${systemId}"` }], isError: true };
-      }
-      if (PROJECT_EMBEDDING_FIELDS.some((f) => f in nonEmpty)) {
-        void client.triggerProjectEmbedding(systemId);
-      }
-      const lines = [
-        `System updated successfully.`,
-        "",
-        `**ID:** ${updated.projectId}`,
-        `**Title:** ${updated.title}`,
-        accountLine(nonEmpty, updated.accountId),
-        updated.strategy ? `**Strategy:** (updated)` : "",
-        updated.repoOwner ? `**Repo:** ${updated.repoOwner}/${updated.repoName}` : "",
-        updated.repoDefaultBranch ? `**Default Branch:** ${updated.repoDefaultBranch}` : ""
-      ].filter(Boolean);
-      return { content: [{ type: "text", text: lines.join("\n") }] };
-    } catch (err) {
-      const message = err instanceof Error ? err.message : String(err);
-      return { content: [{ type: "text", text: `Failed to update system: ${message}` }], isError: true };
-    }
-  };
-  server.tool("update_system", "Update system settings such as title, description, repository configuration, or the Account that owns it", updateSystemSchema, updateSystemHandler);
-  server.tool(
-    "archive_system",
-    "Archive a system, hiding it from the system dropdown and all active system views. Use this when a system is no longer active and should be removed from navigation.",
-    { systemId: external_exports.string().describe("The system ID to archive") },
-    async ({ systemId }) => {
-      const system = await client.getSystem(systemId);
-      if (!system) {
-        return { content: [{ type: "text", text: `System not found: "${systemId}"` }], isError: true };
-      }
-      if (system.orgId !== ctx.orgId) {
-        return { content: [{ type: "text", text: `System "${systemId}" is not in this organization` }], isError: true };
-      }
-      try {
-        const updated = await client.archiveSystem(systemId);
-        if (!updated) {
-          return { content: [{ type: "text", text: `System not found: "${systemId}"` }], isError: true };
-        }
-        return {
-          content: [{
-            type: "text",
-            text: [
-              "System archived successfully.",
-              "",
-              `**ID:** ${updated.projectId}`,
-              `**Title:** ${updated.title}`,
-              `**Status:** ${updated.status}`
-            ].join("\n")
-          }]
-        };
-      } catch (err) {
-        const message = err instanceof Error ? err.message : String(err);
-        return { content: [{ type: "text", text: `Failed to archive system: ${message}` }], isError: true };
-      }
-    }
-  );
-  const createSystemSchema = {
-    title: external_exports.string().describe("System title"),
-    description: external_exports.string().optional().describe("System description"),
-    strategy: external_exports.string().optional().describe('System strategy markdown \u2014 Org Strategy + System Strategy ("System Coda")'),
-    teamspaceId: external_exports.string().optional().describe("Teamspace ID to associate this system with"),
-    repoOwner: external_exports.string().optional().describe("GitHub repository owner (org or user)"),
-    repoName: external_exports.string().optional().describe("GitHub repository name"),
-    repoDefaultBranch: external_exports.string().optional().describe('Default branch for code check (defaults to "main")')
-  };
-  const createSystemHandler = async ({ title, description, strategy, teamspaceId, repoOwner, repoName, repoDefaultBranch }) => {
-    if (teamspaceId) {
-      const teamspace = await client.getTeamspace(teamspaceId);
-      if (!teamspace) {
-        return { content: [{ type: "text", text: "Teamspace not found" }], isError: true };
-      }
-      if (teamspace.orgId !== ctx.orgId) {
-        return { content: [{ type: "text", text: "Teamspace does not belong to this organization" }], isError: true };
-      }
-    }
-    try {
-      const project = await client.createSystem({
-        projectId: (0, import_crypto5.randomUUID)(),
-        orgId: ctx.orgId,
-        ownerUserId: ctx.user.userId,
-        title,
-        description,
-        strategy,
-        status: "active",
-        teamspaceId,
-        repoOwner,
-        repoName,
-        repoDefaultBranch
-      });
-      const text = [
-        `System created successfully.`,
-        "",
-        `**ID:** ${project.projectId}`,
-        `**Title:** ${project.title}`,
-        `**Status:** ${project.status}`,
-        project.description ? `**Description:** ${project.description}` : "",
-        project.repoOwner ? `**Repo:** ${project.repoOwner}/${project.repoName}` : "",
-        project.repoDefaultBranch ? `**Default Branch:** ${project.repoDefaultBranch}` : ""
-      ].filter(Boolean).join("\n");
-      return { content: [{ type: "text", text }] };
-    } catch (err) {
-      const message = err instanceof Error ? err.message : String(err);
-      return { content: [{ type: "text", text: `Failed to create system: ${message}` }], isError: true };
-    }
-  };
-  server.tool("create_system", "Create a new system in the configured organization", createSystemSchema, createSystemHandler);
-}
-
 // ../../libs/harmonica-services/src/mcp/tools/pulse-report-tools.ts
 function formatBeatRow(r) {
   const downbeatState = r.hasDownbeat ? "" : " \u2014 no Downbeat ever set";
@@ -29748,6 +29413,103 @@ Error code: PR_NOT_DRAFT (the PR is already ready for review or was never a draf
   );
 }
 
+// ../../libs/harmonica-services/src/mcp/tools/revision-quality-tools.ts
+var POLL_INTERVAL_MS5 = 4e3;
+var POLL_TIMEOUT_MS5 = 18e4;
+var POLL_MAX_CONSECUTIVE_ERRORS5 = 3;
+async function pollForCheck5(client, taskId) {
+  const deadline = Date.now() + POLL_TIMEOUT_MS5;
+  let consecutiveErrors = 0;
+  while (Date.now() < deadline) {
+    const [task, err] = await client.getTask(taskId).then(
+      (t) => [t, null],
+      (e) => [null, e]
+    );
+    if (err) {
+      consecutiveErrors++;
+      if (consecutiveErrors >= POLL_MAX_CONSECUTIVE_ERRORS5)
+        throw new Error(`getTask failed ${consecutiveErrors} consecutive times: ${err instanceof Error ? err.message : String(err)}`);
+      await new Promise((r) => setTimeout(r, POLL_INTERVAL_MS5));
+      continue;
+    }
+    if (!task) {
+      consecutiveErrors++;
+      if (consecutiveErrors >= POLL_MAX_CONSECUTIVE_ERRORS5)
+        throw new Error(`Task ${taskId} not found after ${consecutiveErrors} consecutive attempts`);
+      await new Promise((r) => setTimeout(r, POLL_INTERVAL_MS5));
+      continue;
+    }
+    consecutiveErrors = 0;
+    if (task.status === "completed") {
+      if (!task.result) throw new Error(`Task ${taskId} completed with no result`);
+      return task.result;
+    }
+    if (task.status === "failed") throw new Error(`Revision quality check failed: ${task.error ?? "unknown error"}`);
+    await new Promise((r) => setTimeout(r, POLL_INTERVAL_MS5));
+  }
+  throw new Error(`Revision quality check timed out after ${POLL_TIMEOUT_MS5 / 1e3}s`);
+}
+function formatScorecard3(check2) {
+  const bar = (score, max) => "\u2588".repeat(score) + "\u2591".repeat(max - score);
+  const dims = check2.dimensions.map(
+    (d) => `**${d.label}** ${bar(d.score, d.maxScore)} ${d.score}/${d.maxScore}
+${d.rationale}${d.suggestions?.length ? `
+\u2022 ${d.suggestions.join("\n\u2022 ")}` : ""}`
+  ).join("\n\n");
+  return [
+    `## Revision Quality Check \u2014 ${check2.targetId}`,
+    `**Overall Score:** ${check2.overallScore}/${CHECK_MAX_SCORES.revision_quality}`,
+    `*(Advisory \u2014 no lifecycle gate reads this score)*`,
+    `**Summary:** ${check2.summary}`,
+    check2.topSuggestion ? `**Top Suggestion:** ${check2.topSuggestion}` : "",
+    "",
+    dims
+  ].filter(Boolean).join("\n");
+}
+function registerRevisionQualityTools(server, ctx, client) {
+  server.tool(
+    "check_revision_quality",
+    "Run a five-dimension PR-readiness check on a Revision (Scoped, Traceable, Testable, Review-ready, Non-duplicating). Advisory only \u2014 no lifecycle transition or creation path gates on this score. 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 \u2014 for bulk operations, omit wait and poll get_job_status separately.",
+    {
+      revisionId: external_exports.string().describe("The Revision ID (e.g., rev-abc123). revision_quality targets Revisions only."),
+      projectId: external_exports.string().describe("The project ID"),
+      wait: external_exports.boolean().optional().describe("If true, block until the check completes and return the scorecard inline. Default: false (returns taskId immediately).")
+    },
+    async ({ revisionId, projectId, wait }) => {
+      try {
+        const targetError = revisionQualityTargetError(revisionId);
+        if (targetError) {
+          return {
+            content: [{ type: "text", text: `Revision quality check failed: ${targetError}` }],
+            isError: true
+          };
+        }
+        await assertProjectInOrg(client, projectId, ctx.orgId);
+        await assertRevisionInProject(client, revisionId, projectId);
+        const task = await client.runCheck(projectId, "revision_quality", revisionId);
+        if (!wait) {
+          return {
+            content: [{
+              type: "text",
+              text: `Revision quality check enqueued for ${revisionId}.
+Job ID: ${task.taskId}
+
+Use get_job_status with jobId="${task.taskId}" to poll for results, or list_checks to retrieve the completed scorecard once done.
+
+*(Advisory check \u2014 score does not gate any lifecycle transition.)*`
+            }]
+          };
+        }
+        const check2 = await pollForCheck5(client, task.taskId);
+        return { content: [{ type: "text", text: formatScorecard3(check2) }] };
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { content: [{ type: "text", text: `Revision quality check failed: ${message}` }], isError: true };
+      }
+    }
+  );
+}
+
 // ../../libs/harmonica-services/src/mcp/tools/session-tools.ts
 var SESSION_STATUSES = ["active", "idle", "closed"];
 var SESSION_MESSAGE_MAX_LENGTH = 8e3;
@@ -30018,8 +29780,8 @@ var import_promises = require("node:fs/promises");
 var import_node_os = require("node:os");
 var import_node_path = require("node:path");
 
-// ../../libs/harmonica-services/src/project-snapshot.constants.ts
-var SNAPSHOT_VERSION = 2;
+// ../../libs/harmonica-services/src/system-snapshot.constants.ts
+var SNAPSHOT_VERSION = 6;
 
 // ../../libs/harmonica-services/src/mcp/tools/snapshot-tools.ts
 function registerSnapshotTools(server, ctx, client) {
@@ -30029,10 +29791,10 @@ function registerSnapshotTools(server, ctx, client) {
     { systemId: external_exports.string().describe("The system ID to export") },
     async ({ systemId }) => {
       await assertProjectInOrg(client, systemId, ctx.orgId);
-      const result = await client.exportProjectSnapshot(systemId);
+      const result = await client.exportSystemSnapshot(systemId);
       if (typeof result === "string") {
         if (!result.startsWith("https://")) {
-          throw new Error(`exportProjectSnapshot returned an unexpected string value (expected an https:// presigned URL): ${result.slice(0, 80)}`);
+          throw new Error(`exportSystemSnapshot returned an unexpected string value (expected an https:// presigned URL): ${result.slice(0, 80)}`);
         }
         return {
           content: [{
@@ -30051,7 +29813,7 @@ function registerSnapshotTools(server, ctx, client) {
       const filename = `harmonica-snapshot-${systemId}-${Date.now()}.json`;
       const filePath = (0, import_node_path.join)((0, import_node_os.tmpdir)(), filename);
       await (0, import_promises.writeFile)(filePath, JSON.stringify(snapshot), "utf-8");
-      const title = snapshot.project?.title ?? systemId;
+      const title = snapshot.system?.title ?? systemId;
       const versionNote = snapshot.version !== SNAPSHOT_VERSION ? [`Warning: snapshot version ${snapshot.version} (local expects ${SNAPSHOT_VERSION}) \u2014 some counts may be zero.`, ""] : [];
       const summary = [
         `Exported "${title}" to: ${filePath}`,
@@ -30066,6 +29828,14 @@ function registerSnapshotTools(server, ctx, client) {
         `  PromptLogs: ${snapshot.promptLogs.length}`,
         `  Drops: ${snapshot.drops?.length ?? 0}`,
         `  Deliverables: ${snapshot.deliverables?.length ?? 0}`,
+        `  Teamspaces: ${snapshot.teamspaces?.length ?? 0}`,
+        `  Layers: ${snapshot.layers?.length ?? 0}`,
+        `  Tracks: ${snapshot.tracks?.length ?? 0}`,
+        `  Work Items: ${snapshot.workItems?.length ?? 0}`,
+        `  Movements: ${snapshot.movements?.length ?? 0}`,
+        `  Bars: ${snapshot.bars?.length ?? 0}`,
+        `  Notebooks: ${snapshot.notebooks?.length ?? 0}`,
+        `  Accounts: ${(snapshot.account ? 1 : 0) + (snapshot.accounts?.length ?? 0)}`,
         "",
         "Use import_system_snapshot with this file path to import into another environment."
       ];
@@ -30079,9 +29849,12 @@ function registerSnapshotTools(server, ctx, client) {
       snapshot: external_exports.string().describe("S3 presigned URL (https://...), file path, or inline JSON string"),
       targetTeamspaceId: external_exports.string().min(1).optional().describe(
         "Remap all teamspace references (Drops, Deliverables, Project record) to this teamspace ID in the target environment. Required when the source and target environments use different teamspace UUIDs. When omitted and the snapshot contains Drops or Deliverables, a warning is included in the import summary."
+      ),
+      targetOrgId: external_exports.string().min(1).optional().describe(
+        "Import all records under this org ID instead of the caller's org. Required when syncing from production to a local environment where the org UUID differs. When omitted, the caller's org ID is used."
       )
     },
-    async ({ snapshot: snapshotInput, targetTeamspaceId }) => {
+    async ({ snapshot: snapshotInput, targetTeamspaceId, targetOrgId }) => {
       const isProduction = process.env.NODE_ENV === "production";
       const importAllowed = process.env.ALLOW_SYSTEM_IMPORT === "true";
       if (isProduction && !importAllowed) {
@@ -30094,12 +29867,12 @@ function registerSnapshotTools(server, ctx, client) {
         };
       }
       const trimmed = snapshotInput.trim();
-      const importOptions = { targetOrgId: ctx.orgId, targetUserId: ctx.user.userId, targetTeamspaceId };
+      const importOptions = { targetOrgId: targetOrgId ?? ctx.orgId, targetUserId: ctx.user.userId, targetTeamspaceId };
       if (trimmed.startsWith("https://")) {
         if (isPrivateHost(trimmed)) {
           throw new Error("Snapshot URL must point to a public host \u2014 private, link-local, and loopback addresses are not permitted.");
         }
-        const result2 = await client.importProjectSnapshotFromUrl(trimmed, importOptions);
+        const result2 = await client.importSystemSnapshotFromUrl(trimmed, importOptions);
         return { content: [{ type: "text", text: formatImportSummary(result2, targetTeamspaceId) }] };
       }
       if (trimmed.startsWith("http://")) {
@@ -30114,21 +29887,25 @@ function registerSnapshotTools(server, ctx, client) {
       }
       assertSnapshotShape(parsed, "");
       const normalized = normalizeSnapshot(parsed);
-      const result = await client.importProjectSnapshot(normalized, importOptions);
+      const result = await client.importSystemSnapshot(normalized, importOptions);
       return { content: [{ type: "text", text: formatImportSummary(result, targetTeamspaceId) }] };
     }
   );
 }
 function normalizeSnapshot(raw) {
+  const anyRaw = raw;
   return {
     ...raw,
+    // Compat: v3 and earlier snapshots have 'project' instead of 'system'
+    system: raw.system ?? anyRaw["project"],
     beats: raw.beats ?? [],
     beatIndex: raw.beatIndex ?? [],
     proposals: raw.proposals ?? [],
     proposalIndex: raw.proposalIndex ?? [],
     revisions: raw.revisions ?? [],
     revisionIndex: raw.revisionIndex ?? [],
-    projectRevisionIndex: raw.projectRevisionIndex ?? [],
+    // Compat: v3 and earlier snapshots have 'projectRevisionIndex'
+    systemRevisionIndex: raw.systemRevisionIndex ?? anyRaw["projectRevisionIndex"] ?? [],
     activities: raw.activities ?? [],
     activityIndex: raw.activityIndex ?? [],
     notes: raw.notes ?? [],
@@ -30141,13 +29918,27 @@ function normalizeSnapshot(raw) {
     promptLogs: raw.promptLogs ?? [],
     beatVersions: raw.beatVersions ?? [],
     beatBeatVersionIndex: raw.beatBeatVersionIndex ?? [],
-    projectBeatVersionIndex: raw.projectBeatVersionIndex ?? [],
+    // Compat: v3 and earlier snapshots have 'projectBeatVersionIndex'
+    systemBeatVersionIndex: raw.systemBeatVersionIndex ?? anyRaw["projectBeatVersionIndex"] ?? [],
     beatVersionDropAssignments: raw.beatVersionDropAssignments ?? [],
     drops: raw.drops ?? [],
     accountDropIndex: raw.accountDropIndex ?? [],
     deliverables: raw.deliverables ?? [],
     teamspaceDeliverableIndex: raw.teamspaceDeliverableIndex ?? [],
-    projectDeliverableIndex: raw.projectDeliverableIndex ?? []
+    // Compat: v3 and earlier snapshots have 'projectDeliverableIndex'
+    systemDeliverableIndex: raw.systemDeliverableIndex ?? anyRaw["projectDeliverableIndex"] ?? [],
+    teamspaces: raw.teamspaces ?? [],
+    teamspaceAccountIndex: raw.teamspaceAccountIndex ?? [],
+    accountTeamspaceIndex: raw.accountTeamspaceIndex ?? [],
+    layers: raw.layers ?? [],
+    layerIndex: raw.layerIndex ?? [],
+    tracks: raw.tracks ?? [],
+    // Compat: early v4 snapshots (before field rename) have 'trackProjectIndex'
+    trackSystemIndex: raw.trackSystemIndex ?? anyRaw["trackProjectIndex"] ?? [],
+    trackTeamspaceIndex: raw.trackTeamspaceIndex ?? [],
+    workItems: raw.workItems ?? [],
+    workItemIndex: raw.workItemIndex ?? [],
+    accounts: raw.accounts ?? []
   };
 }
 async function resolveSnapshotInput(input) {
@@ -30170,7 +29961,15 @@ function formatImportSummary(result, targetTeamspaceId) {
     `  PromptLogs: ${result.counts.promptLogs}`,
     `  Beat Versions: ${result.counts.beatVersions ?? 0}`,
     `  Drops: ${result.counts.drops ?? 0}`,
-    `  Deliverables: ${result.counts.deliverables ?? 0}`
+    `  Deliverables: ${result.counts.deliverables ?? 0}`,
+    `  Teamspaces: ${result.counts.teamspaces ?? 0}`,
+    `  Layers: ${result.counts.layers ?? 0}`,
+    `  Tracks: ${result.counts.tracks ?? 0}`,
+    `  Work Items: ${result.counts.workItems ?? 0}`,
+    `  Movements: ${result.counts.movements ?? 0}`,
+    `  Bars: ${result.counts.bars ?? 0}`,
+    `  Notebooks: ${result.counts.notebooks ?? 0}`,
+    `  Accounts: ${result.counts.accounts ?? 0}`
   ];
   if (result.errors.length > 0) {
     lines.push("", `Errors (${result.errors.length}):`);
@@ -30217,9 +30016,9 @@ function assertSnapshotShape(val, sourceHint) {
   if (typeof obj["version"] !== "number" || obj["version"] <= 0) {
     throw new Error(`Snapshot${sourceHint} has an invalid or missing 'version' field \u2014 it may not be a valid project snapshot.`);
   }
-  const project = obj["project"];
-  if (typeof project !== "object" || project === null || typeof project["projectId"] !== "string") {
-    throw new Error(`Snapshot${sourceHint} is missing 'project.projectId' \u2014 it may not be a valid project snapshot.`);
+  const systemOrProject = obj["system"] ?? obj["project"];
+  if (typeof systemOrProject !== "object" || systemOrProject === null || typeof systemOrProject["projectId"] !== "string") {
+    throw new Error(`Snapshot${sourceHint} is missing 'system.projectId' \u2014 it may not be a valid project snapshot.`);
   }
 }
 
@@ -30249,54 +30048,317 @@ function registerSubscriptionTools(server, ctx, client) {
         return { content: [{ type: "text", text: `Failed to subscribe: ${message}` }], isError: true };
       }
     }
-  );
+  );
+  server.tool(
+    "unsubscribe_from_entity",
+    "Stop following a Project, Beat, or Revision. Use durable=true to prevent auto-resubscribe if you are later re-assigned.",
+    {
+      entityType: external_exports.enum(ENTITY_TYPES).describe("Type of entity to unfollow"),
+      entityId: external_exports.string().describe("The entity ID"),
+      durable: external_exports.boolean().optional().default(false).describe("If true, prevents auto-resubscribe on reassignment")
+    },
+    async ({ entityType, entityId, durable }) => {
+      try {
+        await client.unsubscribe(ctx.user.userId, entityType, entityId, durable);
+        const durableMsg = durable ? " (durable \u2014 will not auto-resubscribe on reassignment)" : "";
+        return {
+          content: [{
+            type: "text",
+            text: `Unfollowed ${entityType} ${entityId}${durableMsg}.`
+          }]
+        };
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { content: [{ type: "text", text: `Failed to unsubscribe: ${message}` }], isError: true };
+      }
+    }
+  );
+  server.tool(
+    "list_subscriptions",
+    "List entities you are currently following. Optionally filter by entity type (project, beat, revision).",
+    {
+      entityType: external_exports.enum(ENTITY_TYPES).optional().describe("Filter by entity type")
+    },
+    async ({ entityType }) => {
+      try {
+        const subs = await client.listSubscriptions(ctx.user.userId, entityType);
+        if (subs.length === 0) {
+          return { content: [{ type: "text", text: "You are not following any entities." }] };
+        }
+        const lines = [`# Your Subscriptions (${subs.length})`, ""];
+        for (const sub of subs) {
+          lines.push(`- **${sub.entityType}** ${sub.entityId} (${sub.source}, since ${sub.createdAt?.split("T")[0] ?? "unknown"})`);
+        }
+        return { content: [{ type: "text", text: lines.join("\n") }] };
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { content: [{ type: "text", text: `Failed to list subscriptions: ${message}` }], isError: true };
+      }
+    }
+  );
+}
+
+// ../../libs/harmonica-services/src/mcp/tools/system-lifecycle-tools.ts
+function registerProjectLifecycleTools(server, ctx, client) {
+  server.tool(
+    "transition_system_lifecycle",
+    "Advance a System's capability-maturity lifecycle state. Allowed transitions follow the state machine (Concept \u2192 Incubating \u2192 Piloting \u2192 Activated \u2192 Commercializing \u2192 Scaled, plus paused/killed/sunset/archived exits). The activated \u2192 commercializing edge requires a `decisionNoteId` pointing to a system-scoped Decision Note (the governance review). Other gates are advisory.",
+    {
+      systemId: external_exports.string().describe("The system ID"),
+      targetState: external_exports.enum([
+        "concept",
+        "incubating",
+        "piloting",
+        "activated",
+        "commercializing",
+        "scaled",
+        "paused",
+        "killed",
+        "sunset",
+        "archived"
+      ]).describe("Target lifecycle state. Active: concept, incubating, piloting, activated, commercializing, scaled. Exits: paused, killed, sunset, archived."),
+      reason: external_exports.string().optional().describe("Why this transition is being made (recorded in audit metadata)"),
+      decisionNoteId: external_exports.string().optional().describe("Note ID of the governance Decision Note. Required for the activated \u2192 commercializing transition; optional otherwise.")
+    },
+    async ({ systemId, targetState, reason, decisionNoteId }) => {
+      try {
+        const system = await client.getSystem(systemId);
+        if (!system) {
+          return { content: [{ type: "text", text: `System not found: "${systemId}"` }], isError: true };
+        }
+        if (system.orgId !== ctx.orgId) {
+          return { content: [{ type: "text", text: `System "${systemId}" is not in this organization` }], isError: true };
+        }
+        const result = await client.transitionProjectLifecycleState(systemId, targetState, {
+          actor: { type: "human", id: ctx.user.userId, name: ctx.user.name },
+          reason,
+          decisionNoteId
+        });
+        if (!result.success) {
+          const failedGates = result.error?.failedGates?.length ? ` (failed gates: ${result.error.failedGates.join(", ")})` : "";
+          return {
+            content: [{ type: "text", text: `Transition failed: ${result.error?.message ?? "Unknown error"}${failedGates}` }],
+            isError: true
+          };
+        }
+        const lines = [
+          `System lifecycle transitioned successfully.`,
+          "",
+          `**System:** ${systemId}`,
+          `**Title:** ${system.title}`,
+          `**Transition:** ${result.previousState} \u2192 ${result.newState}`
+        ];
+        if (reason) lines.push(`**Reason:** ${reason}`);
+        if (decisionNoteId) lines.push(`**Decision Note:** ${decisionNoteId}`);
+        return { content: [{ type: "text", text: lines.join("\n") }] };
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { content: [{ type: "text", text: `Failed to transition system lifecycle: ${message}` }], isError: true };
+      }
+    }
+  );
+}
+
+// ../../libs/harmonica-services/src/mcp/tools/system-tools.ts
+var import_crypto5 = require("crypto");
+function accountLine(request, resolved) {
+  const requested = request["accountId"];
+  if (requested === null || requested === "") return "**Account:** (unlinked)";
+  return resolved ? `**Account:** ${resolved}` : "";
+}
+var PROJECT_EMBEDDING_FIELDS = ["title", "description", "strategy"];
+function registerProjectTools(server, ctx, client) {
+  const listSystemsHandler = async ({ teamspaceId }) => {
+    try {
+      const projects = await client.listOrgSystems(ctx.orgId);
+      const trimmed = teamspaceId?.trim();
+      const filtered = trimmed ? projects.filter((p) => p.teamspaceId === trimmed) : projects;
+      const text = formatProjectSummaryTable(filtered);
+      return { content: [{ type: "text", text }] };
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      return { content: [{ type: "text", text: `Failed to list systems: ${message}` }], isError: true };
+    }
+  };
+  server.tool(
+    "list_systems",
+    "List all systems (projects) in the configured organization",
+    {
+      teamspaceId: external_exports.string().optional().describe("Filter to systems belonging to a specific teamspace. Empty or whitespace-only treated as no filter.")
+    },
+    listSystemsHandler
+  );
+  const getSystemContextSchema = {
+    systemId: external_exports.string().describe("The system ID"),
+    noteLimit: external_exports.number().int().min(1).max(MAX_CONTEXT_NOTE_LIMIT).optional().describe(
+      `Max Notes to include, prioritised by note type (default ${DEFAULT_CONTEXT_NOTE_LIMIT}, max ${MAX_CONTEXT_NOTE_LIMIT}). Use list_notes or search for the full set.`
+    )
+  };
+  const getSystemContextHandler = async ({
+    systemId,
+    noteLimit
+  }) => {
+    try {
+      const [project, org] = await Promise.all([
+        fetchProjectInOrg(client, systemId, ctx.orgId),
+        client.getOrg(ctx.orgId)
+      ]);
+      const notes = await client.listProjectNotes(systemId, {
+        limit: noteLimit ?? DEFAULT_CONTEXT_NOTE_LIMIT
+      });
+      const text = formatProjectContext(project, notes, org?.coda);
+      return { content: [{ type: "text", text }] };
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      return { content: [{ type: "text", text: `Failed to get system context: ${message}` }], isError: true };
+    }
+  };
+  server.tool(
+    "get_system_context",
+    "Get system metadata, description, and notes in one view",
+    getSystemContextSchema,
+    getSystemContextHandler
+  );
+  const updateSystemSchema = {
+    systemId: external_exports.string().describe("The system ID"),
+    title: external_exports.string().optional().describe("New system title"),
+    description: external_exports.string().optional().describe("New system description"),
+    strategy: external_exports.string().optional().describe('System strategy markdown \u2014 Org Strategy + System Strategy ("System Coda")'),
+    teamspaceId: external_exports.string().nullable().optional().describe("Teamspace ID to associate this system with; pass null to remove the association"),
+    accountId: external_exports.string().nullable().optional().describe("Account that owns this System \u2014 the client or internal org unit. Pass null (or an empty string) to unlink. Reassigning moves the System so it is listed under exactly one Account."),
+    repoOwner: external_exports.string().optional().describe("GitHub repository owner (org or user)"),
+    repoName: external_exports.string().optional().describe("GitHub repository name"),
+    repoDefaultBranch: external_exports.string().optional().describe('Default branch for code check (defaults to "main")'),
+    rateLimitOverrides: external_exports.record(external_exports.string(), external_exports.object({ maxPerHour: external_exports.number().min(0) })).optional().describe('Per-task-type rate limit overrides, e.g. {"agent_chat":{"maxPerHour":100}}. Overrides env var and compiled defaults.')
+  };
+  const updateSystemHandler = async ({ systemId, ...updates }) => {
+    try {
+      const nonEmpty = Object.fromEntries(
+        Object.entries(updates).filter(([, v]) => v !== void 0)
+      );
+      if (Object.keys(nonEmpty).length === 0) {
+        return { content: [{ type: "text", text: "No updates provided." }], isError: true };
+      }
+      await assertProjectInOrg(client, systemId, ctx.orgId);
+      if (nonEmpty["accountId"] === "") nonEmpty["accountId"] = null;
+      if (typeof updates.teamspaceId === "string") {
+        const teamspace = await client.getTeamspace(updates.teamspaceId);
+        if (!teamspace) {
+          return { content: [{ type: "text", text: "Teamspace not found" }], isError: true };
+        }
+        if (teamspace.orgId !== ctx.orgId) {
+          return { content: [{ type: "text", text: "Teamspace does not belong to this organization" }], isError: true };
+        }
+      }
+      const updated = await client.updateSystem(systemId, nonEmpty);
+      if (!updated) {
+        return { content: [{ type: "text", text: `System not found: "${systemId}"` }], isError: true };
+      }
+      if (PROJECT_EMBEDDING_FIELDS.some((f) => f in nonEmpty)) {
+        void client.triggerProjectEmbedding(systemId);
+      }
+      const lines = [
+        `System updated successfully.`,
+        "",
+        `**ID:** ${updated.projectId}`,
+        `**Title:** ${updated.title}`,
+        accountLine(nonEmpty, updated.accountId),
+        updated.strategy ? `**Strategy:** (updated)` : "",
+        updated.repoOwner ? `**Repo:** ${updated.repoOwner}/${updated.repoName}` : "",
+        updated.repoDefaultBranch ? `**Default Branch:** ${updated.repoDefaultBranch}` : ""
+      ].filter(Boolean);
+      return { content: [{ type: "text", text: lines.join("\n") }] };
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      return { content: [{ type: "text", text: `Failed to update system: ${message}` }], isError: true };
+    }
+  };
+  server.tool("update_system", "Update system settings such as title, description, repository configuration, or the Account that owns it", updateSystemSchema, updateSystemHandler);
   server.tool(
-    "unsubscribe_from_entity",
-    "Stop following a Project, Beat, or Revision. Use durable=true to prevent auto-resubscribe if you are later re-assigned.",
-    {
-      entityType: external_exports.enum(ENTITY_TYPES).describe("Type of entity to unfollow"),
-      entityId: external_exports.string().describe("The entity ID"),
-      durable: external_exports.boolean().optional().default(false).describe("If true, prevents auto-resubscribe on reassignment")
-    },
-    async ({ entityType, entityId, durable }) => {
+    "archive_system",
+    "Archive a system, hiding it from the system dropdown and all active system views. Use this when a system is no longer active and should be removed from navigation.",
+    { systemId: external_exports.string().describe("The system ID to archive") },
+    async ({ systemId }) => {
+      const system = await client.getSystem(systemId);
+      if (!system) {
+        return { content: [{ type: "text", text: `System not found: "${systemId}"` }], isError: true };
+      }
+      if (system.orgId !== ctx.orgId) {
+        return { content: [{ type: "text", text: `System "${systemId}" is not in this organization` }], isError: true };
+      }
       try {
-        await client.unsubscribe(ctx.user.userId, entityType, entityId, durable);
-        const durableMsg = durable ? " (durable \u2014 will not auto-resubscribe on reassignment)" : "";
+        const updated = await client.archiveSystem(systemId);
+        if (!updated) {
+          return { content: [{ type: "text", text: `System not found: "${systemId}"` }], isError: true };
+        }
         return {
           content: [{
             type: "text",
-            text: `Unfollowed ${entityType} ${entityId}${durableMsg}.`
+            text: [
+              "System archived successfully.",
+              "",
+              `**ID:** ${updated.projectId}`,
+              `**Title:** ${updated.title}`,
+              `**Status:** ${updated.status}`
+            ].join("\n")
           }]
         };
       } catch (err) {
         const message = err instanceof Error ? err.message : String(err);
-        return { content: [{ type: "text", text: `Failed to unsubscribe: ${message}` }], isError: true };
+        return { content: [{ type: "text", text: `Failed to archive system: ${message}` }], isError: true };
       }
     }
   );
-  server.tool(
-    "list_subscriptions",
-    "List entities you are currently following. Optionally filter by entity type (project, beat, revision).",
-    {
-      entityType: external_exports.enum(ENTITY_TYPES).optional().describe("Filter by entity type")
-    },
-    async ({ entityType }) => {
-      try {
-        const subs = await client.listSubscriptions(ctx.user.userId, entityType);
-        if (subs.length === 0) {
-          return { content: [{ type: "text", text: "You are not following any entities." }] };
-        }
-        const lines = [`# Your Subscriptions (${subs.length})`, ""];
-        for (const sub of subs) {
-          lines.push(`- **${sub.entityType}** ${sub.entityId} (${sub.source}, since ${sub.createdAt?.split("T")[0] ?? "unknown"})`);
-        }
-        return { content: [{ type: "text", text: lines.join("\n") }] };
-      } catch (err) {
-        const message = err instanceof Error ? err.message : String(err);
-        return { content: [{ type: "text", text: `Failed to list subscriptions: ${message}` }], isError: true };
+  const createSystemSchema = {
+    title: external_exports.string().describe("System title"),
+    description: external_exports.string().optional().describe("System description"),
+    strategy: external_exports.string().optional().describe('System strategy markdown \u2014 Org Strategy + System Strategy ("System Coda")'),
+    teamspaceId: external_exports.string().optional().describe("Teamspace ID to associate this system with"),
+    repoOwner: external_exports.string().optional().describe("GitHub repository owner (org or user)"),
+    repoName: external_exports.string().optional().describe("GitHub repository name"),
+    repoDefaultBranch: external_exports.string().optional().describe('Default branch for code check (defaults to "main")')
+  };
+  const createSystemHandler = async ({ title, description, strategy, teamspaceId, repoOwner, repoName, repoDefaultBranch }) => {
+    if (teamspaceId) {
+      const teamspace = await client.getTeamspace(teamspaceId);
+      if (!teamspace) {
+        return { content: [{ type: "text", text: "Teamspace not found" }], isError: true };
+      }
+      if (teamspace.orgId !== ctx.orgId) {
+        return { content: [{ type: "text", text: "Teamspace does not belong to this organization" }], isError: true };
       }
     }
-  );
+    try {
+      const project = await client.createSystem({
+        projectId: (0, import_crypto5.randomUUID)(),
+        orgId: ctx.orgId,
+        ownerUserId: ctx.user.userId,
+        title,
+        description,
+        strategy,
+        status: "active",
+        teamspaceId,
+        repoOwner,
+        repoName,
+        repoDefaultBranch
+      });
+      const text = [
+        `System created successfully.`,
+        "",
+        `**ID:** ${project.projectId}`,
+        `**Title:** ${project.title}`,
+        `**Status:** ${project.status}`,
+        project.description ? `**Description:** ${project.description}` : "",
+        project.repoOwner ? `**Repo:** ${project.repoOwner}/${project.repoName}` : "",
+        project.repoDefaultBranch ? `**Default Branch:** ${project.repoDefaultBranch}` : ""
+      ].filter(Boolean).join("\n");
+      return { content: [{ type: "text", text }] };
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      return { content: [{ type: "text", text: `Failed to create system: ${message}` }], isError: true };
+    }
+  };
+  server.tool("create_system", "Create a new system in the configured organization", createSystemSchema, createSystemHandler);
 }
 
 // ../../libs/harmonica-services/src/mcp/tools/teamspace-tools.ts
@@ -30754,8 +30816,15 @@ function registerValueVelocityTools(server, ctx, client) {
 // ../../libs/harmonica-services/src/mcp/tools/work-item-tools.ts
 var WORK_ITEM_STATUS_ENUM = ["not_started", "in_progress", "blocked", "done"];
 function formatOwner(owner) {
-  return `${owner.name} <${owner.email}>`;
-}
+  return owner ? `${owner.name} <${owner.email}>` : "unassigned";
+}
+var WORK_ITEM_EFFORT_SIZE_ENUM = [
+  "XS",
+  "S",
+  "M",
+  "L",
+  "XL"
+];
 function registerWorkItemTools(server, _ctx, client) {
   server.tool(
     "list_track_work_items",
@@ -30791,6 +30860,9 @@ function registerWorkItemTools(server, _ctx, client) {
         `Status: ${wi.status}`,
         wi.committedEstimateHours !== void 0 ? `Committed Estimate: ${wi.committedEstimateHours}h` : null,
         wi.actualHours !== void 0 ? `Actual Hours: ${wi.actualHours}h` : null,
+        wi.effortSize !== void 0 ? `Effort Size: ${wi.effortSize}` : null,
+        wi.valueUnits !== void 0 ? `Value Units: ${wi.valueUnits}` : null,
+        wi.costPerValueUnit !== void 0 ? `Cost per Value Unit: ${wi.costPerValueUnit}` : null,
         wi.beatVersionId ? `Linked Beat Version: ${wi.beatVersionId}` : null,
         estimateHint ? `Estimate Hint: ${estimateHint.hours}h (source: ${estimateHint.source})` : null,
         wi.createdBy ? `Created By: ${wi.createdBy}` : null,
@@ -30806,18 +30878,30 @@ function registerWorkItemTools(server, _ctx, client) {
     {
       trackId: external_exports.string().describe("The Track (DeliverableGroup) ID this work item belongs to"),
       title: external_exports.string().min(1).max(300).describe("Work item title"),
-      ownerName: external_exports.string().min(1).describe("Owner display name"),
-      ownerEmail: external_exports.string().email().describe("Owner email \u2014 exactly one owner at all times"),
+      ownerName: external_exports.string().min(1).optional().describe("Optional owner display name (requires ownerEmail too)"),
+      ownerEmail: external_exports.string().email().optional().describe("Optional owner email (requires ownerName too). A work item may be left unowned."),
       committedEstimateHours: external_exports.number().nonnegative().optional().describe("Optional committed estimate in hours"),
+      effortSize: external_exports.enum(WORK_ITEM_EFFORT_SIZE_ENUM).optional().describe("Optional rough t-shirt effort size (delivery lens) \u2014 independent of valueUnits"),
+      valueUnits: external_exports.number().nonnegative().optional().describe("Optional Value Units (commercial lens) \u2014 independent of effortSize"),
+      costPerValueUnit: external_exports.number().nonnegative().optional().describe("Optional price per Value Unit"),
       createdBy: external_exports.string().optional().describe("Optional creator identity for audit"),
       beatVersionId: external_exports.string().min(1).optional().describe("Optional Beat Version to link for capability lineage. Must exist.")
     },
-    async ({ trackId, title, ownerName, ownerEmail, committedEstimateHours, createdBy, beatVersionId }) => {
+    async ({ trackId, title, ownerName, ownerEmail, committedEstimateHours, effortSize, valueUnits, costPerValueUnit, createdBy, beatVersionId }) => {
+      if (ownerName === void 0 !== (ownerEmail === void 0)) {
+        return {
+          content: [{ type: "text", text: "Setting the owner requires both ownerName and ownerEmail. Omit both to create an unowned work item." }],
+          isError: true
+        };
+      }
       const wi = await client.createWorkItem({
         trackId,
         title,
-        owner: { name: ownerName, email: ownerEmail },
+        ...ownerName !== void 0 && ownerEmail !== void 0 && { owner: { name: ownerName, email: ownerEmail } },
         ...committedEstimateHours !== void 0 && { committedEstimateHours },
+        ...effortSize !== void 0 && { effortSize },
+        ...valueUnits !== void 0 && { valueUnits },
+        ...costPerValueUnit !== void 0 && { costPerValueUnit },
         ...createdBy !== void 0 && { createdBy },
         ...beatVersionId !== void 0 && { beatVersionId }
       });
@@ -30833,17 +30917,21 @@ function registerWorkItemTools(server, _ctx, client) {
   );
   server.tool(
     "update_work_item",
-    "Update mutable content fields on a work item (title, owner, committedEstimateHours, actualHours, beatVersionId). To move it between Tracks use move_work_item; to change its status use transition_work_item_status.",
+    "Update mutable content fields on a work item (title, owner, committedEstimateHours, actualHours, effortSize, valueUnits, costPerValueUnit, beatVersionId). To move it between Tracks use move_work_item; to change its status use transition_work_item_status.",
     {
       workItemId: external_exports.string().describe("The work item ID"),
       title: external_exports.string().min(1).max(300).optional().describe("New title"),
       ownerName: external_exports.string().min(1).optional().describe("New owner display name (requires ownerEmail too)"),
       ownerEmail: external_exports.string().email().optional().describe("New owner email (requires ownerName too)"),
+      unassignOwner: external_exports.boolean().optional().describe("Pass true to clear the owner, leaving the work item unowned. Cannot be combined with ownerName/ownerEmail."),
       committedEstimateHours: external_exports.number().nonnegative().optional().describe("New committed estimate in hours"),
       actualHours: external_exports.number().nonnegative().optional().describe("New actual hours logged"),
+      effortSize: external_exports.enum(WORK_ITEM_EFFORT_SIZE_ENUM).nullable().optional().describe("Rough t-shirt effort size (delivery lens). Pass null to clear; omit to leave untouched."),
+      valueUnits: external_exports.number().nonnegative().nullable().optional().describe("Value Units (commercial lens). Pass null to clear; omit to leave untouched."),
+      costPerValueUnit: external_exports.number().nonnegative().nullable().optional().describe("Price per Value Unit. Pass null to clear; omit to leave untouched."),
       beatVersionId: external_exports.string().min(1).nullable().optional().describe("Link to a Beat Version for capability lineage. Pass null to unlink; omit to leave the current link untouched.")
     },
-    async ({ workItemId, title, ownerName, ownerEmail, committedEstimateHours, actualHours, beatVersionId }) => {
+    async ({ workItemId, title, ownerName, ownerEmail, unassignOwner, committedEstimateHours, actualHours, effortSize, valueUnits, costPerValueUnit, beatVersionId }) => {
       const hasOwnerUpdate = ownerName !== void 0 || ownerEmail !== void 0;
       if (hasOwnerUpdate && (ownerName === void 0 || ownerEmail === void 0)) {
         return {
@@ -30851,7 +30939,13 @@ function registerWorkItemTools(server, _ctx, client) {
           isError: true
         };
       }
-      const hasUpdates = title !== void 0 || hasOwnerUpdate || committedEstimateHours !== void 0 || actualHours !== void 0 || beatVersionId !== void 0;
+      if (unassignOwner && hasOwnerUpdate) {
+        return {
+          content: [{ type: "text", text: "Cannot set and clear the owner in one update \u2014 pass either unassignOwner or ownerName/ownerEmail." }],
+          isError: true
+        };
+      }
+      const hasUpdates = title !== void 0 || hasOwnerUpdate || unassignOwner === true || committedEstimateHours !== void 0 || actualHours !== void 0 || effortSize !== void 0 || valueUnits !== void 0 || costPerValueUnit !== void 0 || beatVersionId !== void 0;
       if (!hasUpdates) {
         return {
           content: [{ type: "text", text: `No updates provided for work item: ${workItemId}` }],
@@ -30861,8 +30955,12 @@ function registerWorkItemTools(server, _ctx, client) {
       const wi = await client.updateWorkItem(workItemId, {
         ...title !== void 0 && { title },
         ...hasOwnerUpdate && { owner: { name: ownerName, email: ownerEmail } },
+        ...unassignOwner === true && { owner: null },
         ...committedEstimateHours !== void 0 && { committedEstimateHours },
         ...actualHours !== void 0 && { actualHours },
+        ...effortSize !== void 0 && { effortSize },
+        ...valueUnits !== void 0 && { valueUnits },
+        ...costPerValueUnit !== void 0 && { costPerValueUnit },
         ...beatVersionId !== void 0 && { beatVersionId }
       });
       if (!wi) {
@@ -31365,6 +31463,7 @@ function registerAllTools(server, ctx, client, profile) {
   registerSnapshotTools(server, ctx, client);
   registerBeatQualityTools(server, ctx, client);
   registerPlanQualityTools(server, ctx, client);
+  registerRevisionQualityTools(server, ctx, client);
   registerPortfolioCoherenceTools(server, ctx, client);
   registerDropQualityTools(server, ctx, client);
   registerBeatReframeTools(server, ctx, client);
@@ -31392,7 +31491,6 @@ function registerAllTools(server, ctx, client, profile) {
   registerNotebookTools(server, ctx, client);
   registerAccountTools(server, ctx, client);
   registerMovementTools(server, ctx, client);
-  registerMeasureTools(server, ctx, client);
   registerWorkItemTools(server, ctx, client);
   registerBarTools(server, ctx, client);
   registerCadenceScheduleTools(server, ctx, client);
@@ -31408,7 +31506,7 @@ function registerBeatResources(server, ctx, client) {
     async (uri, { projectId }) => {
       const pid = String(projectId);
       await assertProjectInOrg(client, pid, ctx.orgId);
-      const beats = await client.listProjectBeats(pid);
+      const beats = await client.listSystemBeats(pid);
       const text = formatBeatSummaryTable(beats);
       return { contents: [{ uri: uri.href, text }] };
     }
@@ -31442,7 +31540,7 @@ function registerGuidelinesResources(server, client) {
   );
 }
 
-// ../../libs/harmonica-services/src/mcp/resources/project-resources.ts
+// ../../libs/harmonica-services/src/mcp/resources/system-resources.ts
 function registerProjectResources(server, ctx, client) {
   server.resource(
     "project-context",
@@ -31450,7 +31548,7 @@ function registerProjectResources(server, ctx, client) {
     async (uri, { projectId }) => {
       const pid = String(projectId);
       const project = await fetchProjectInOrg(client, pid, ctx.orgId);
-      const notes = await client.listProjectNotes(pid, { limit: DEFAULT_CONTEXT_NOTE_LIMIT });
+      const notes = await client.listSystemNotes(pid, { limit: DEFAULT_CONTEXT_NOTE_LIMIT });
       const text = formatProjectContext(project, notes);
       return { contents: [{ uri: uri.href, text }] };
     }
@@ -31599,7 +31697,7 @@ function createHttpClient(config2) {
     }
     return result.edge;
   }
-  const POLL_INTERVAL_MS5 = 4e3;
+  const POLL_INTERVAL_MS6 = 4e3;
   async function pollTaskResult(taskId) {
     const deadline = Date.now() + LONG_RUNNING_TIMEOUT_MS;
     while (Date.now() < deadline) {
@@ -31609,7 +31707,7 @@ function createHttpClient(config2) {
       );
       if (task?.status === "completed") return task.result;
       if (task?.status === "failed") throw new Error(`Task failed: ${task.error ?? "unknown error"}`);
-      await new Promise((r) => setTimeout(r, POLL_INTERVAL_MS5));
+      await new Promise((r) => setTimeout(r, POLL_INTERVAL_MS6));
     }
     throw new Error(`Task ${taskId} timed out after ${LONG_RUNNING_TIMEOUT_MS}ms`);
   }
@@ -31771,7 +31869,7 @@ function createHttpClient(config2) {
       const result = await request("POST", `/api/systems/${encodeURIComponent(projectId)}/beats/next-id`);
       return result.beatId;
     },
-    listProjectBeats: async (projectId) => {
+    listSystemBeats: async (projectId) => {
       const result = await request("GET", `/api/systems/${encodeURIComponent(projectId)}/beats`);
       return (result?.beats ?? []).map((b) => ({
         ...b,
@@ -31927,6 +32025,22 @@ function createHttpClient(config2) {
       const result = await request("POST", `/api/layers/${encodeURIComponent(layerId)}/status`, { status, reason });
       return result?.layer;
     },
+    listSystemNotes: async (projectId, filters) => {
+      const params = new URLSearchParams();
+      if (filters?.noteType) {
+        const types = Array.isArray(filters.noteType) ? filters.noteType : [filters.noteType];
+        types.forEach((t) => params.append("type", t));
+      }
+      if (filters?.status) params.set("status", filters.status);
+      if (filters?.revisionId) params.set("revisionId", filters.revisionId);
+      if (filters?.beatVersionId) params.set("beatVersionId", filters.beatVersionId);
+      if (filters?.excludeChildren) params.set("excludeChildren", "true");
+      if (filters?.significance) params.set("significance", filters.significance);
+      if (filters?.limit !== void 0) params.set("limit", String(filters.limit));
+      const qs = params.toString() ? `?${params.toString()}` : "";
+      const result = await request("GET", `/api/systems/${encodeURIComponent(projectId)}/notes${qs}`);
+      return result?.notes ?? [];
+    },
     listProjectNotes: async (projectId, filters) => {
       const params = new URLSearchParams();
       if (filters?.noteType) {
@@ -31935,6 +32049,7 @@ function createHttpClient(config2) {
       }
       if (filters?.status) params.set("status", filters.status);
       if (filters?.revisionId) params.set("revisionId", filters.revisionId);
+      if (filters?.beatVersionId) params.set("beatVersionId", filters.beatVersionId);
       if (filters?.excludeChildren) params.set("excludeChildren", "true");
       if (filters?.significance) params.set("significance", filters.significance);
       if (filters?.limit !== void 0) params.set("limit", String(filters.limit));
@@ -31951,6 +32066,7 @@ function createHttpClient(config2) {
       if (filters?.excludeNoteType) params.set("excludeType", filters.excludeNoteType);
       if (filters?.status) params.set("status", filters.status);
       if (filters?.revisionId) params.set("revisionId", filters.revisionId);
+      if (filters?.beatVersionId) params.set("beatVersionId", filters.beatVersionId);
       if (filters?.excludeChildren) params.set("excludeChildren", "true");
       if (filters?.significance) params.set("significance", filters.significance);
       if (limit !== void 0) params.set("limit", String(limit));
@@ -31969,6 +32085,7 @@ function createHttpClient(config2) {
       }
       if (filters?.status) params.set("status", filters.status);
       if (filters?.revisionId) params.set("revisionId", filters.revisionId);
+      if (filters?.beatVersionId) params.set("beatVersionId", filters.beatVersionId);
       if (filters?.excludeChildren) params.set("excludeChildren", "true");
       if (filters?.significance) params.set("significance", filters.significance);
       const qs = params.toString() ? `?${params.toString()}` : "";
@@ -32066,6 +32183,14 @@ function createHttpClient(config2) {
       const result = await request("GET", `/api/systems/${encodeURIComponent(projectId)}/revisions/pending${qs}`);
       return result ?? [];
     },
+    listSystemRevisions: async (projectId, options) => {
+      const params = new URLSearchParams();
+      if (options?.status) params.set("status", options.status);
+      if (options?.includeArchived) params.set("includeArchived", "true");
+      const qs = params.toString() ? `?${params.toString()}` : "";
+      const result = await request("GET", `/api/systems/${encodeURIComponent(projectId)}/revisions${qs}`);
+      return result ?? [];
+    },
     listProjectRevisions: async (projectId, options) => {
       const params = new URLSearchParams();
       if (options?.status) params.set("status", options.status);
@@ -32295,6 +32420,14 @@ function createHttpClient(config2) {
     // partitions, but the REST surface is unified per the project-level
     // "avoid nested/duplicate routes" guidance.
     getSession: (sessionId) => request("GET", `/api/sessions/${encodeURIComponent(sessionId)}`),
+    listSystemSessions: async (projectId, options) => {
+      const params = new URLSearchParams();
+      params.set("projectId", projectId);
+      if (options?.status) params.set("status", options.status);
+      if (options?.includeTerminal) params.set("includeTerminal", "true");
+      const result = await request("GET", `/api/sessions?${params.toString()}`);
+      return result ?? [];
+    },
     listProjectSessions: async (projectId, options) => {
       const params = new URLSearchParams();
       params.set("projectId", projectId);
@@ -32482,6 +32615,14 @@ function createHttpClient(config2) {
     getTask: async (taskId) => {
       return request("GET", `/api/tasks/${encodeURIComponent(taskId)}`);
     },
+    listSystemTasks: async (projectId, options) => {
+      const params = new URLSearchParams();
+      if (options?.status) params.set("status", options.status);
+      if (options?.limit) params.set("limit", String(options.limit));
+      const qs = params.toString() ? `?${params.toString()}` : "";
+      const result = await request("GET", `/api/systems/${encodeURIComponent(projectId)}/tasks${qs}`);
+      return result?.tasks ?? [];
+    },
     listProjectTasks: async (projectId, options) => {
       const params = new URLSearchParams();
       if (options?.status) params.set("status", options.status);
@@ -32513,6 +32654,15 @@ function createHttpClient(config2) {
       }, LONG_RUNNING_TIMEOUT_MS);
     },
     // Activity — forward to API endpoint
+    listSystemActivities: async (projectId, options) => {
+      const params = new URLSearchParams();
+      if (options?.limit) params.set("limit", String(options.limit));
+      if (options?.minImportance) params.set("importance", options.minImportance);
+      const qs = params.toString();
+      const path = `/api/systems/${encodeURIComponent(projectId)}/activities${qs ? `?${qs}` : ""}`;
+      const result = await request("GET", path);
+      return { entries: result.activities ?? [], hasMore: false };
+    },
     listProjectActivities: async (projectId, options) => {
       const params = new URLSearchParams();
       if (options?.limit) params.set("limit", String(options.limit));
@@ -32779,7 +32929,7 @@ function createHttpClient(config2) {
       return request("GET", `/api/subscriptions/entity/${encodeURIComponent(entityId)}`, void 0);
     },
     // Project Snapshot — export runs as a background task to avoid Lambda timeout
-    exportProjectSnapshot: async (projectId) => {
+    exportSystemSnapshot: async (projectId) => {
       const pid = encodeURIComponent(projectId);
       const enqueued = await request("POST", `/api/systems/${pid}/export`, {});
       if (!enqueued?.taskId) throw new Error("Export enqueue failed: no taskId returned");
@@ -32794,8 +32944,8 @@ function createHttpClient(config2) {
       }
       return download;
     },
-    importProjectSnapshot: (snapshot, options) => request("POST", "/api/systems/import", { ...snapshot, importOptions: options }, LONG_RUNNING_TIMEOUT_MS),
-    importProjectSnapshotFromUrl: (url2, options) => request("POST", "/api/systems/import", { snapshotUrl: url2, importOptions: options }, LONG_RUNNING_TIMEOUT_MS),
+    importSystemSnapshot: (snapshot, options) => request("POST", "/api/systems/import", { ...snapshot, importOptions: options }, LONG_RUNNING_TIMEOUT_MS),
+    importSystemSnapshotFromUrl: (url2, options) => request("POST", "/api/systems/import", { snapshotUrl: url2, importOptions: options }, LONG_RUNNING_TIMEOUT_MS),
     // Embedding similarity
     embedProjectEntities: (projectId) => request("POST", `/api/systems/${encodeURIComponent(projectId)}/embeddings/generate`),
     findSimilarNotes: async (noteId, projectId, options) => {
@@ -32861,6 +33011,18 @@ function createHttpClient(config2) {
       const res = await request("GET", `/api/checks/${encodeURIComponent(checkId)}`);
       return res.check;
     },
+    listSystemChecks: async (projectId, checkType, options) => {
+      const params = new URLSearchParams();
+      if (checkType) params.set("type", checkType);
+      if (options?.limit !== void 0) params.set("limit", String(options.limit));
+      if (options?.cursor) params.set("cursor", options.cursor);
+      const qs = params.toString() ? `?${params.toString()}` : "";
+      const res = await request(
+        "GET",
+        `/api/systems/${encodeURIComponent(projectId)}/checks${qs}`
+      );
+      return { checks: res?.checks ?? [], nextCursor: res?.nextCursor };
+    },
     listProjectChecks: async (projectId, checkType, options) => {
       const params = new URLSearchParams();
       if (checkType) params.set("type", checkType);
@@ -32959,6 +33121,11 @@ function createHttpClient(config2) {
       if (res === void 0) throw new Error(`Teamspace ${teamspaceId} not found`);
       return res.deliverableGroups;
     },
+    listSystemDeliverableGroups: async (projectId) => {
+      const res = await request("GET", `/api/systems/${encodeURIComponent(projectId)}/deliverable-groups`);
+      if (res === void 0) throw new Error(`Project ${projectId} not found`);
+      return res.deliverableGroups;
+    },
     listProjectDeliverableGroups: async (projectId) => {
       const res = await request("GET", `/api/systems/${encodeURIComponent(projectId)}/deliverable-groups`);
       if (res === void 0) throw new Error(`Project ${projectId} not found`);
@@ -33008,22 +33175,10 @@ function createHttpClient(config2) {
       const res = await request("GET", `/api/deliverable-groups/${encodeURIComponent(deliverableGroupId)}/drops`);
       return res?.drops ?? [];
     },
-    listDeliverableGroupBeatVersions: async (deliverableGroupId) => {
-      const res = await request("GET", `/api/deliverable-groups/${encodeURIComponent(deliverableGroupId)}/beat-versions`);
-      return res?.beatVersions ?? [];
-    },
-    setBeatVersionDeliverableGroup: async (deliverableGroupId, beatVersionId) => {
-      const res = await request("POST", `/api/deliverable-groups/${encodeURIComponent(deliverableGroupId)}/beat-versions`, { beatVersionId });
-      return res?.success === true;
-    },
     setDropDeliverableGroup: async (deliverableGroupId, dropId) => {
       const res = await request("POST", `/api/deliverable-groups/${encodeURIComponent(deliverableGroupId)}/drops`, { dropId });
       return res?.success === true;
     },
-    clearBeatVersionDeliverableGroup: async (deliverableGroupId, beatVersionId) => {
-      const res = await request("DELETE", `/api/deliverable-groups/${encodeURIComponent(deliverableGroupId)}/beat-versions/${encodeURIComponent(beatVersionId)}`);
-      return res?.success === true;
-    },
     // Movements (B-242 / teamspace-scoped SOW container)
     createMovement: async (input) => {
       const { teamspaceId, title, description, accountId } = input;
@@ -33069,80 +33224,16 @@ function createHttpClient(config2) {
       if (!parsed.success) throw new Error(`Unexpected movements list shape from API: ${parsed.error.message}`);
       return parsed.data.movements;
     },
-    // Measures (Measure exposure layer — atomic Work Plan unit under a Track).
-    // valueUnit is server-stripped for non-admins (N-4E09-6509) — the schema
-    // makes it optional; consumers must treat its absence as "not permitted".
-    createMeasure: async (input) => {
-      const { trackId, title, valueUnit, beatVersionId, createdBy } = input;
-      const body = {
-        title,
-        valueUnit,
-        ...beatVersionId !== void 0 && { beatVersionId },
-        ...createdBy !== void 0 && { createdBy }
-      };
-      const res = await request(
-        "POST",
-        `/api/deliverable-groups/${encodeURIComponent(trackId)}/measures`,
-        body
-      );
-      if (res === void 0) throw new Error(`Track ${trackId} not found`);
-      const parsed = MeasureApiSchema.safeParse(res.measure);
-      if (!parsed.success) throw new Error(`Unexpected Measure shape from API: ${parsed.error.message}`);
-      return parsed.data;
-    },
-    getMeasure: async (measureId) => {
-      const res = await request("GET", `/api/measures/${encodeURIComponent(measureId)}`);
-      if (res === void 0) return void 0;
-      const parsed = MeasureApiSchema.safeParse(res.measure);
-      if (!parsed.success) throw new Error(`Unexpected Measure shape from API: ${parsed.error.message}`);
-      return parsed.data;
-    },
-    updateMeasure: async (measureId, updates) => {
-      const res = await request("PATCH", `/api/measures/${encodeURIComponent(measureId)}`, updates);
-      if (res === void 0) return void 0;
-      const parsed = MeasureApiSchema.safeParse(res.measure);
-      if (!parsed.success) throw new Error(`Unexpected Measure shape from API: ${parsed.error.message}`);
-      return parsed.data;
-    },
-    listTrackMeasures: async (trackId) => {
-      const res = await request("GET", `/api/deliverable-groups/${encodeURIComponent(trackId)}/measures`);
-      if (res === void 0) throw new Error(`Track ${trackId} not found`);
-      const parsed = MeasuresResponseSchema.safeParse(res);
-      if (!parsed.success) throw new Error(`Unexpected measures list shape from API: ${parsed.error.message}`);
-      return parsed.data.measures;
-    },
-    listBeatVersionMeasures: async (beatVersionId) => {
-      const res = await request("GET", `/api/beat-versions/${encodeURIComponent(beatVersionId)}/measures`);
-      if (res === void 0) throw new Error(`Beat Version ${beatVersionId} not found`);
-      const parsed = MeasuresResponseSchema.safeParse(res);
-      if (!parsed.success) throw new Error(`Unexpected measures list shape from API: ${parsed.error.message}`);
-      return parsed.data.measures;
-    },
-    linkMeasureToBeatVersion: async (measureId, beatVersionId) => {
-      const res = await request(
-        "POST",
-        `/api/measures/${encodeURIComponent(measureId)}/beat-version`,
-        { beatVersionId }
-      );
-      if (res === void 0) return void 0;
-      const parsed = MeasureApiSchema.safeParse(res.measure);
-      if (!parsed.success) throw new Error(`Unexpected Measure shape from API: ${parsed.error.message}`);
-      return parsed.data;
-    },
-    unlinkMeasureFromBeatVersion: async (measureId) => {
-      const res = await request("DELETE", `/api/measures/${encodeURIComponent(measureId)}/beat-version`);
-      if (res === void 0) return void 0;
-      const parsed = MeasureApiSchema.safeParse(res.measure);
-      if (!parsed.success) throw new Error(`Unexpected Measure shape from API: ${parsed.error.message}`);
-      return parsed.data;
-    },
     // WorkItems (WorkItem exposure layer — owned, statused unit of operational work under a Track)
     createWorkItem: async (input) => {
-      const { trackId, title, owner, committedEstimateHours, createdBy, beatVersionId } = input;
+      const { trackId, title, owner, committedEstimateHours, effortSize, valueUnits, costPerValueUnit, createdBy, beatVersionId } = input;
       const body = {
         title,
-        owner,
+        ...owner !== void 0 && { owner },
         ...committedEstimateHours !== void 0 && { committedEstimateHours },
+        ...effortSize !== void 0 && { effortSize },
+        ...valueUnits !== void 0 && { valueUnits },
+        ...costPerValueUnit !== void 0 && { costPerValueUnit },
         ...createdBy !== void 0 && { createdBy },
         ...beatVersionId !== void 0 && { beatVersionId }
       };
@@ -33685,7 +33776,7 @@ function loadConfig() {
   };
 }
 async function main() {
-  console.error(`[harmonica-mcp] v${"2.0.0"} starting\u2026`);
+  console.error(`[harmonica-mcp] v${"3.0.0"} starting\u2026`);
   const config2 = loadConfig();
   const client = createHttpClient({
     apiBaseUrl: config2.apiBaseUrl,