@codazen/harmonica-mcp 3.8.6 → 3.9.1

package/dist/index.js

@@ -21542,25 +21542,25 @@ async function validateAuth(client, orgIdentifier, isOrgSlug, userId) {
 }
 
 // ../../libs/harmonica-services/src/mcp/org-guard.ts
-async function assertProjectInOrg(client, systemId, orgId) {
-  const project = await client.getSystem(systemId);
-  if (!project) {
-    throw new Error(`Project not found: "${systemId}"`);
+async function assertSystemInOrg(client, systemId, orgId) {
+  const system = await client.getSystem(systemId);
+  if (!system) {
+    throw new Error(`System not found: "${systemId}"`);
   }
-  if (project.orgId !== orgId) {
+  if (system.orgId !== orgId) {
     throw new Error(
-      `Project "${systemId}" does not belong to the configured organization. Access denied.`
+      `System "${systemId}" does not belong to the configured organization. Access denied.`
     );
   }
 }
-async function assertRevisionInProject(client, revisionId, systemId) {
+async function assertRevisionInSystem(client, revisionId, systemId) {
   const revision = await client.getRevision(revisionId);
   if (!revision) {
     throw new Error(`Revision not found: "${revisionId}"`);
   }
   if (revision.systemId !== systemId) {
     throw new Error(
-      `Revision "${revisionId}" does not belong to project "${systemId}". Access denied.`
+      `Revision "${revisionId}" does not belong to system "${systemId}". Access denied.`
     );
   }
 }
@@ -21575,18 +21575,6 @@ async function assertBeatInOrg(client, beatId, orgId) {
     );
   }
 }
-async function fetchProjectInOrg(client, systemId, orgId) {
-  const project = await client.getSystem(systemId);
-  if (!project) {
-    throw new Error(`Project not found: "${systemId}"`);
-  }
-  if (project.orgId !== orgId) {
-    throw new Error(
-      `Project "${systemId}" does not belong to the configured organization. Access denied.`
-    );
-  }
-  return project;
-}
 async function fetchSystemInOrg(client, systemId, orgId) {
   const system = await client.getSystem(systemId);
   if (!system) {
@@ -21979,7 +21967,7 @@ function registerActivityTools(server, ctx, client) {
       importance: external_exports.enum(IMPORTANCE_VALUES).optional().describe("Filter by minimum importance level")
     },
     async ({ systemId, limit, importance }) => {
-      await assertProjectInOrg(client, systemId, ctx.orgId);
+      await assertSystemInOrg(client, systemId, ctx.orgId);
       const { entries, hasMore } = await client.listSystemActivities(systemId, {
         limit: limit ?? 30,
         minImportance: importance
@@ -22011,7 +21999,7 @@ function registerAnalysisTools(server, ctx, client) {
       minClusterSize: external_exports.coerce.number().int().min(2).optional().default(3).describe("Minimum cluster size. Default 3")
     },
     async ({ systemId, entityType, threshold, minClusterSize }) => {
-      await assertProjectInOrg(client, systemId, ctx.orgId);
+      await assertSystemInOrg(client, systemId, ctx.orgId);
       const result = await client.clusterEntities(systemId, entityType, { threshold, minClusterSize });
       if (result.clusters.length === 0) {
         return {
@@ -22043,7 +22031,7 @@ Analyzed: ${result.totalAnalyzed} | Clusters: ${result.clusters.length} | Noise:
       minClusterSize: external_exports.coerce.number().int().min(2).optional().default(2).describe("Minimum cluster size. Default 2")
     },
     async ({ systemId, analysisType, entityType, threshold, minClusterSize }) => {
-      await assertProjectInOrg(client, systemId, ctx.orgId);
+      await assertSystemInOrg(client, systemId, ctx.orgId);
       const result = await client.runClusteredAnalysis(systemId, analysisType, {
         entityType,
         threshold,
@@ -22078,7 +22066,7 @@ function registerAuditIntegrityTools(server, ctx, client) {
     },
     async ({ systemId, limit }) => {
       try {
-        await assertProjectInOrg(client, systemId, ctx.orgId);
+        await assertSystemInOrg(client, systemId, ctx.orgId);
         const report = await client.verifyAuditIntegrity(systemId, { limit });
         const lines = [
           `## Audit Integrity Report`,
@@ -22207,7 +22195,7 @@ function registerBaselineTools(server, ctx, client) {
     },
     async ({ systemId, beatIds, runChecks, localPath }) => {
       try {
-        await assertProjectInOrg(client, systemId, ctx.orgId);
+        await assertSystemInOrg(client, systemId, ctx.orgId);
         const task = await client.baselineSystem(systemId, { beatIds, runChecks, localPath });
         return {
           content: [{
@@ -22296,7 +22284,7 @@ Rationale: ${rationale}`;
     },
     async ({ systemId, items, reason }) => {
       try {
-        await assertProjectInOrg(client, systemId, ctx.orgId);
+        await assertSystemInOrg(client, systemId, ctx.orgId);
         const result = await client.bulkReassignRevisions(items, reason, ctx.user.userId);
         const lines = [
           `# Bulk reassignment complete: ${result.reassigned.length} succeeded, ${result.failed.length} failed`,
@@ -22335,7 +22323,7 @@ Rationale: ${rationale}`;
     },
     async ({ systemId, revisionId, toBeatId, reason }) => {
       try {
-        await assertProjectInOrg(client, systemId, ctx.orgId);
+        await assertSystemInOrg(client, systemId, ctx.orgId);
         const result = await client.reassignRevision(revisionId, toBeatId, reason, ctx.user.userId);
         const text = [
           `Revision reassigned successfully.`,
@@ -22853,7 +22841,7 @@ function formatNoteList(notes) {
   return parts.join("\n");
 }
 function formatDocumentList(docs, allNotes) {
-  if (docs.length === 0) return "No documents uploaded for this project.";
+  if (docs.length === 0) return "No documents uploaded for this system.";
   const lines = docs.map((doc) => {
     const meta = doc.documentMeta;
     const status = meta?.documentStatus ?? "unknown";
@@ -23103,7 +23091,7 @@ function registerBeatTools(server, ctx, client) {
       includeArchived: external_exports.boolean().optional().default(false).describe("Include archived and deprecated beats (excluded by default)")
     },
     async ({ systemId, offset = 0, limit = 100, includeArchived }) => {
-      await assertProjectInOrg(client, systemId, ctx.orgId);
+      await assertSystemInOrg(client, systemId, ctx.orgId);
       let beats = await client.listSystemBeats(systemId);
       if (!includeArchived) {
         beats = beats.filter((b) => b.beatStatus !== "archived");
@@ -23169,7 +23157,7 @@ function registerBeatTools(server, ctx, client) {
     },
     async ({ systemId, title, description, tags, priority, estimatedEffort, beatId, humanAssignee, agentAssignee, branch }) => {
       try {
-        await fetchProjectInOrg(client, systemId, ctx.orgId);
+        await fetchSystemInOrg(client, systemId, ctx.orgId);
         const resolvedBeatId = beatId ?? await client.getNextBeatId(systemId);
         const beat = await client.createBeat({
           beatId: resolvedBeatId,
@@ -23286,7 +23274,7 @@ ${formatBeatDetail(beat)}${similarityWarning}` }] };
     },
     async ({ systemId, beatId, status, includeArchived }) => {
       try {
-        await assertProjectInOrg(client, systemId, ctx.orgId);
+        await assertSystemInOrg(client, systemId, ctx.orgId);
         const revisions = beatId ? await client.listBeatRevisions(systemId, beatId, { status, includeArchived }) : await client.listSystemRevisions(systemId, { status, includeArchived });
         return { content: [{ type: "text", text: formatRevisionSummaryTable(revisions) }] };
       } catch (err) {
@@ -23927,7 +23915,7 @@ function registerCheckTools(server, ctx, client) {
         } else {
           const result = await client.listSystemChecks(systemId, checkType, { limit: 200 });
           checks = result.checks;
-          scope = `project ${systemId}`;
+          scope = `system ${systemId}`;
         }
         if (checks.length === 0) {
           return { content: [{ type: "text", text: `No checks found for ${scope}.` }] };
@@ -23950,9 +23938,9 @@ function registerCheckTools(server, ctx, client) {
       try {
         const checks = await client.listLatestSystemChecks(systemId);
         if (checks.length === 0) {
-          return { content: [{ type: "text", text: `No checks found for project ${systemId}.` }] };
+          return { content: [{ type: "text", text: `No checks found for system ${systemId}.` }] };
         }
-        const text = formatCheckList(checks, `latest per target \xB7 project ${systemId}`);
+        const text = formatCheckList(checks, `latest per target \xB7 system ${systemId}`);
         return { content: [{ type: "text", text }] };
       } catch (err) {
         const message = err instanceof Error ? err.message : String(err);
@@ -23972,7 +23960,7 @@ function registerCheckTools(server, ctx, client) {
     },
     async ({ checkType, targetId, systemId, branch, localPath }) => {
       try {
-        await assertProjectInOrg(client, systemId, ctx.orgId);
+        await assertSystemInOrg(client, systemId, ctx.orgId);
         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 };
@@ -24560,7 +24548,7 @@ function registerDropQualityTools(server, ctx, client) {
     },
     async ({ dropId, systemId, wait }) => {
       try {
-        await assertProjectInOrg(client, systemId, ctx.orgId);
+        await assertSystemInOrg(client, systemId, ctx.orgId);
         const drop = await client.getDrop(dropId);
         if (!drop) {
           return { content: [{ type: "text", text: `Drop "${dropId}" not found.` }], isError: true };
@@ -24690,7 +24678,7 @@ function registerDropTools(server, ctx, client) {
   );
   server.tool(
     "create_drop",
-    "Create a Drop (release container) in an Account. Drops group Beat Revisions for coordinated release. The dropCode is auto-generated as D-NNN per Account. Drops are cross-project: a single Drop can include Revisions from any Project in the Account.",
+    "Create a Drop (release container) in an Account. Drops group Beat Revisions for coordinated release. The dropCode is auto-generated as D-NNN per Account. Drops are cross-system: a single Drop can include Revisions from any System in the Account.",
     {
       accountId: external_exports.string().describe("The account ID"),
       name: external_exports.string().min(1).max(200).describe('Drop name (e.g. "MVP", "Phase 2", "Hotfix 2026-Q2")'),
@@ -24954,8 +24942,8 @@ function registerEmbeddingTools(server, ctx, client) {
       systemId: external_exports.string().describe("The system ID to embed entities for")
     },
     async ({ systemId }) => {
-      await assertProjectInOrg(client, systemId, ctx.orgId);
-      const result = await client.embedProjectEntities(systemId);
+      await assertSystemInOrg(client, systemId, ctx.orgId);
+      const result = await client.embedSystemEntities(systemId);
       const text = `## Embedding Results
 
 - Embedded: ${result.embedded}
@@ -24986,7 +24974,7 @@ function registerEmbeddingTools(server, ctx, client) {
       }
       let scope;
       if (systemId) {
-        await assertProjectInOrg(client, systemId, ctx.orgId);
+        await assertSystemInOrg(client, systemId, ctx.orgId);
         scope = { systemId };
       } else if (teamspaceId) {
         await assertTeamspaceInOrg(client, teamspaceId, ctx.orgId);
@@ -25012,7 +25000,7 @@ function registerEmbeddingTools(server, ctx, client) {
       beatId: external_exports.string().optional().describe("Restrict results to notes belonging to a specific beat (DynamoDB post-filter)")
     },
     async ({ noteId, systemId, threshold, limit, includeArchived = false, noteStatus, beatId }) => {
-      await assertProjectInOrg(client, systemId, ctx.orgId);
+      await assertSystemInOrg(client, systemId, ctx.orgId);
       const ids = Array.isArray(noteId) ? noteId : [noteId];
       if (ids.length === 1) {
         const results = await client.findSimilarNotes(ids[0], systemId, { threshold, limit, includeArchived, noteStatus, beatId });
@@ -25053,7 +25041,7 @@ function registerEmbeddingTools(server, ctx, client) {
       limit: external_exports.coerce.number().int().min(1).max(50).optional().default(10).describe("Max results to return. Default 10")
     },
     async ({ noteId, systemId, threshold, limit }) => {
-      await assertProjectInOrg(client, systemId, ctx.orgId);
+      await assertSystemInOrg(client, systemId, ctx.orgId);
       const results = await client.findRelatedBeats(noteId, systemId, { threshold, limit });
       const text = formatSimilarityResults(results, noteId, "Related Beats");
       return { content: [{ type: "text", text }] };
@@ -25069,7 +25057,7 @@ function registerEmbeddingTools(server, ctx, client) {
       includeLinked: external_exports.coerce.boolean().optional().default(false).describe("Include notes that already have dependsOnNotes links. Default false (excludes them). Set true for thematic grouping pass.")
     },
     async ({ systemId, threshold, minClusterSize, includeLinked }) => {
-      await assertProjectInOrg(client, systemId, ctx.orgId);
+      await assertSystemInOrg(client, systemId, ctx.orgId);
       const result = await client.clusterNotes(systemId, { threshold, minClusterSize, excludeAlreadyLinked: !includeLinked });
       if (result.clusters.length === 0) {
         return { content: [{ type: "text", text: `No clusters found among ${result.totalAnalyzed} analyzed notes. Try lowering the threshold.` }] };
@@ -25100,7 +25088,7 @@ ${members}`;
       includeLinked: external_exports.coerce.boolean().optional().default(false).describe("Include notes that already have dependsOnNotes links. Default false.")
     },
     async ({ systemId, threshold, minClusterSize, includeLinked }) => {
-      await assertProjectInOrg(client, systemId, ctx.orgId);
+      await assertSystemInOrg(client, systemId, ctx.orgId);
       const result = await client.consolidateNotes(systemId, { threshold, minClusterSize, includeLinked });
       if (result.proposals.length === 0) {
         return { content: [{ type: "text", text: `No consolidation candidates found among ${result.totalAnalyzed} analyzed notes.` }] };
@@ -25341,7 +25329,7 @@ function registerLayerTools(server, ctx, client) {
     },
     async ({ systemId }) => {
       try {
-        await assertProjectInOrg(client, systemId, ctx.orgId);
+        await assertSystemInOrg(client, systemId, ctx.orgId);
       } catch (err) {
         const message = err instanceof Error ? err.message : String(err);
         return { content: [{ type: "text", text: `Access denied: ${message}` }], isError: true };
@@ -25366,7 +25354,7 @@ function registerLayerTools(server, ctx, client) {
     },
     async ({ systemId, layerId }) => {
       try {
-        await assertProjectInOrg(client, systemId, ctx.orgId);
+        await assertSystemInOrg(client, systemId, ctx.orgId);
       } catch (err) {
         const message = err instanceof Error ? err.message : String(err);
         return { content: [{ type: "text", text: `Access denied: ${message}` }], isError: true };
@@ -25401,7 +25389,7 @@ function registerLayerTools(server, ctx, client) {
     },
     async ({ systemId, layerKey, name, description, parentLayerId, repoPatterns }) => {
       try {
-        await assertProjectInOrg(client, systemId, ctx.orgId);
+        await assertSystemInOrg(client, systemId, ctx.orgId);
       } catch (err) {
         const message = err instanceof Error ? err.message : String(err);
         return { content: [{ type: "text", text: `Access denied: ${message}` }], isError: true };
@@ -25440,7 +25428,7 @@ ${formatLayerDetail(layer)}` }] };
     },
     async ({ systemId, layerId, name, description, repoPatterns }) => {
       try {
-        await assertProjectInOrg(client, systemId, ctx.orgId);
+        await assertSystemInOrg(client, systemId, ctx.orgId);
       } catch (err) {
         const message = err instanceof Error ? err.message : String(err);
         return { content: [{ type: "text", text: `Access denied: ${message}` }], isError: true };
@@ -25484,7 +25472,7 @@ ${formatLayerDetail(layer)}` }] };
     },
     async ({ systemId, layerId, status, reason }) => {
       try {
-        await assertProjectInOrg(client, systemId, ctx.orgId);
+        await assertSystemInOrg(client, systemId, ctx.orgId);
       } catch (err) {
         const message = err instanceof Error ? err.message : String(err);
         return { content: [{ type: "text", text: `Access denied: ${message}` }], isError: true };
@@ -25828,7 +25816,7 @@ function registerNextActionsTools(server, ctx, client) {
     },
     async ({ systemId, limit }) => {
       try {
-        await assertProjectInOrg(client, systemId, ctx.orgId);
+        await assertSystemInOrg(client, systemId, ctx.orgId);
         const actions = await client.getNextActions(systemId, { limit });
         return { content: [{ type: "text", text: formatNextActions(actions) }] };
       } catch (err) {
@@ -25845,7 +25833,7 @@ function registerNextActionsTools(server, ctx, client) {
     },
     async ({ systemId }) => {
       try {
-        await assertProjectInOrg(client, systemId, ctx.orgId);
+        await assertSystemInOrg(client, systemId, ctx.orgId);
         const actions = await client.listTriageActions(systemId);
         return { content: [{ type: "text", text: formatTriageActions(actions) }] };
       } catch (err) {
@@ -25863,7 +25851,7 @@ function registerNextActionsTools(server, ctx, client) {
     },
     async ({ systemId, actionKey }) => {
       try {
-        await assertProjectInOrg(client, systemId, ctx.orgId);
+        await assertSystemInOrg(client, systemId, ctx.orgId);
         await client.dismissTriageAction(systemId, actionKey, ctx.user?.userId ?? "mcp");
         return { content: [{ type: "text", text: `Action ${actionKey} dismissed.` }] };
       } catch (err) {
@@ -26336,18 +26324,24 @@ var NoteStatusSchema = external_exports.enum([
 ]);
 var SystemStatusSchema = external_exports.enum(["active", "archived", "draft"]);
 var ChangeImportanceSchema = external_exports.enum(["minor", "moderate", "major"]);
+var normalizeSystemId = (raw) => {
+  if (typeof raw !== "object" || raw === null || Array.isArray(raw)) return raw;
+  const b = raw;
+  const id = b["systemId"] || b["projectId"];
+  if (!id) return raw;
+  return { ...b, systemId: id };
+};
 var BeatApiSchema = external_exports.preprocess(
   (raw) => {
     if (typeof raw !== "object" || raw === null) return raw;
     const b = raw;
-    const id = b["systemId"] ?? b["projectId"];
+    const id = b["systemId"] || b["projectId"];
     if (!id) return raw;
-    return { ...b, systemId: id, projectId: id };
+    return { ...b, systemId: id };
   },
   external_exports.object({
     beatId: external_exports.string(),
     systemId: external_exports.string(),
-    projectId: external_exports.string(),
     /** Source project's title; attached by the flat /api/beats endpoint for
      *  multi-project (teamspace/org) responses. */
     projectName: external_exports.string().nullish(),
@@ -26373,35 +26367,38 @@ var RevisionScmSchema = external_exports.object({
   state: external_exports.enum(["draft", "open", "merged", "closed"]),
   mergeSha: external_exports.string().optional()
 });
-var RevisionApiSchema = external_exports.object({
-  revisionId: external_exports.string(),
-  beatId: external_exports.string(),
-  projectId: external_exports.string(),
-  status: RevisionStatusSchema,
-  title: external_exports.string().default(""),
-  versionNumber: external_exports.number(),
-  changeSummary: external_exports.string().nullish(),
-  changeImportance: ChangeImportanceSchema.nullish(),
-  primaryUser: external_exports.string(),
-  description: external_exports.string().nullish(),
-  tags: external_exports.array(external_exports.string()).nullish(),
-  priority: external_exports.number().nullish(),
-  estimatedEffort: external_exports.string().nullish(),
-  humanAssignee: HumanAssigneeSchema.nullish(),
-  agentAssignee: AgentAssigneeSchema.nullish(),
-  scm: RevisionScmSchema.optional(),
-  // The Layer this Revision was created under (immutable). Absent on Revisions
-  // predating Layers — never backfilled — so consumers group those as "Unassigned".
-  layerId: external_exports.string().nullish(),
-  createdAt: external_exports.string(),
-  updatedAt: external_exports.string()
-}).passthrough();
-var NoteApiSchema = external_exports.object({
+var RevisionApiSchema = external_exports.preprocess(
+  normalizeSystemId,
+  external_exports.object({
+    revisionId: external_exports.string(),
+    beatId: external_exports.string(),
+    systemId: external_exports.string(),
+    status: RevisionStatusSchema,
+    title: external_exports.string().default(""),
+    versionNumber: external_exports.number(),
+    changeSummary: external_exports.string().nullish(),
+    changeImportance: ChangeImportanceSchema.nullish(),
+    primaryUser: external_exports.string(),
+    description: external_exports.string().nullish(),
+    tags: external_exports.array(external_exports.string()).nullish(),
+    priority: external_exports.number().nullish(),
+    estimatedEffort: external_exports.string().nullish(),
+    humanAssignee: HumanAssigneeSchema.nullish(),
+    agentAssignee: AgentAssigneeSchema.nullish(),
+    scm: RevisionScmSchema.optional(),
+    // The Layer this Revision was created under (immutable). Absent on Revisions
+    // predating Layers — never backfilled — so consumers group those as "Unassigned".
+    layerId: external_exports.string().nullish(),
+    createdAt: external_exports.string(),
+    updatedAt: external_exports.string()
+  }).passthrough()
+);
+var NoteApiSchema = external_exports.preprocess(normalizeSystemId, external_exports.object({
   noteId: external_exports.string(),
   noteType: NoteTypeSchema,
   status: NoteStatusSchema,
   content: external_exports.string(),
-  projectId: external_exports.string().nullish(),
+  systemId: external_exports.string().nullish(),
   beatId: external_exports.string().nullish(),
   revisionId: external_exports.string().nullish(),
   rationale: external_exports.string().nullish(),
@@ -26412,18 +26409,21 @@ var NoteApiSchema = external_exports.object({
   agentAssignee: AgentAssigneeSchema.nullish(),
   createdAt: external_exports.string(),
   updatedAt: external_exports.string()
-}).passthrough();
-var SystemApiSchema = external_exports.object({
-  projectId: external_exports.string(),
-  title: external_exports.string(),
-  status: SystemStatusSchema,
-  description: external_exports.string().optional(),
-  strategy: external_exports.string().optional(),
-  orgId: external_exports.string().optional(),
-  ownerUserId: external_exports.string().optional(),
-  createdAt: external_exports.string(),
-  updatedAt: external_exports.string()
-}).passthrough();
+}).passthrough());
+var SystemApiSchema = external_exports.preprocess(
+  normalizeSystemId,
+  external_exports.object({
+    systemId: external_exports.string(),
+    title: external_exports.string(),
+    status: SystemStatusSchema,
+    description: external_exports.string().optional(),
+    strategy: external_exports.string().optional(),
+    orgId: external_exports.string().optional(),
+    ownerUserId: external_exports.string().optional(),
+    createdAt: external_exports.string(),
+    updatedAt: external_exports.string()
+  }).passthrough()
+);
 var BeatsResponseSchema = external_exports.object({
   beats: external_exports.array(BeatApiSchema),
   total: external_exports.number().optional(),
@@ -26608,37 +26608,43 @@ var CHECK_TARGET_TYPES = [
   "organization"
 ];
 var CheckTargetTypeSchema = external_exports.enum(CHECK_TARGET_TYPES);
-var CheckApiSchema = external_exports.object({
-  checkId: external_exports.string(),
-  checkType: CheckTypeSchema,
-  targetType: CheckTargetTypeSchema,
-  targetId: external_exports.string(),
-  projectId: external_exports.string(),
-  overallScore: external_exports.number(),
-  dimensions: external_exports.array(CheckDimensionScoreSchema),
-  summary: external_exports.string(),
-  topSuggestion: external_exports.string().optional(),
-  gaps: external_exports.array(CheckGapSchema).optional(),
-  taskId: external_exports.string().optional(),
-  triggeredBy: external_exports.string().optional(),
-  createdAt: external_exports.string(),
-  updatedAt: external_exports.string()
-}).passthrough();
-var SystemCheckApiSchema = external_exports.object({
-  checkId: external_exports.string(),
-  checkType: CheckTypeSchema,
-  targetType: CheckTargetTypeSchema,
-  targetId: external_exports.string(),
-  projectId: external_exports.string(),
-  overallScore: external_exports.number(),
-  summary: external_exports.string(),
-  triggeredBy: external_exports.string().optional(),
-  createdAt: external_exports.string(),
-  updatedAt: external_exports.string(),
-  /** Populated only when the API was called with ?includeDimensions=true.
-   *  Read-time enrichment from the underlying Check entity. */
-  dimensions: external_exports.array(CheckDimensionScoreSchema).optional()
-}).passthrough();
+var CheckApiSchema = external_exports.preprocess(
+  normalizeSystemId,
+  external_exports.object({
+    checkId: external_exports.string(),
+    checkType: CheckTypeSchema,
+    targetType: CheckTargetTypeSchema,
+    targetId: external_exports.string(),
+    systemId: external_exports.string(),
+    overallScore: external_exports.number(),
+    dimensions: external_exports.array(CheckDimensionScoreSchema),
+    summary: external_exports.string(),
+    topSuggestion: external_exports.string().optional(),
+    gaps: external_exports.array(CheckGapSchema).optional(),
+    taskId: external_exports.string().optional(),
+    triggeredBy: external_exports.string().optional(),
+    createdAt: external_exports.string(),
+    updatedAt: external_exports.string()
+  }).passthrough()
+);
+var SystemCheckApiSchema = external_exports.preprocess(
+  normalizeSystemId,
+  external_exports.object({
+    checkId: external_exports.string(),
+    checkType: CheckTypeSchema,
+    targetType: CheckTargetTypeSchema,
+    targetId: external_exports.string(),
+    systemId: external_exports.string(),
+    overallScore: external_exports.number(),
+    summary: external_exports.string(),
+    triggeredBy: external_exports.string().optional(),
+    createdAt: external_exports.string(),
+    updatedAt: external_exports.string(),
+    /** Populated only when the API was called with ?includeDimensions=true.
+     *  Read-time enrichment from the underlying Check entity. */
+    dimensions: external_exports.array(CheckDimensionScoreSchema).optional()
+  }).passthrough()
+);
 var CheckResponseSchema = external_exports.object({ check: CheckApiSchema }).passthrough();
 var ChecksResponseSchema = external_exports.object({ checks: external_exports.array(SystemCheckApiSchema), nextCursor: external_exports.string().optional() }).passthrough();
 var TaskStatusSchema2 = external_exports.enum(["pending", "running", "completed", "failed"]);
@@ -26683,21 +26689,24 @@ var OrgMemberSchema = external_exports.object({
 var OrganizationsResponseSchema = external_exports.array(OrganizationSummarySchema);
 var OrgMembersResponseSchema = external_exports.array(OrgMemberSchema);
 var WrappedOrgMembersResponseSchema = external_exports.object({ members: OrgMembersResponseSchema });
-var ActivitySchema = external_exports.object({
-  activityId: external_exports.string(),
-  projectId: external_exports.string(),
-  action: external_exports.string(),
-  importance: external_exports.enum(["minor", "moderate", "major"]),
-  reason: external_exports.string(),
-  // actorType is typed as string (not a strict enum) because the API accepts values
-  // beyond 'user'/'system' (e.g. 'human', 'agent') depending on the call site.
-  actorType: external_exports.string().optional(),
-  actorId: external_exports.string().optional(),
-  affectedBeatIds: external_exports.array(external_exports.string()).optional(),
-  affectedBeatTitles: external_exports.array(external_exports.string()).optional(),
-  metadata: external_exports.record(external_exports.unknown()).optional(),
-  createdAt: external_exports.string()
-}).passthrough();
+var ActivitySchema = external_exports.preprocess(
+  normalizeSystemId,
+  external_exports.object({
+    activityId: external_exports.string(),
+    systemId: external_exports.string(),
+    action: external_exports.string(),
+    importance: external_exports.enum(["minor", "moderate", "major"]),
+    reason: external_exports.string(),
+    // actorType is typed as string (not a strict enum) because the API accepts values
+    // beyond 'user'/'system' (e.g. 'human', 'agent') depending on the call site.
+    actorType: external_exports.string().optional(),
+    actorId: external_exports.string().optional(),
+    affectedBeatIds: external_exports.array(external_exports.string()).optional(),
+    affectedBeatTitles: external_exports.array(external_exports.string()).optional(),
+    metadata: external_exports.record(external_exports.unknown()).optional(),
+    createdAt: external_exports.string()
+  }).passthrough()
+);
 var ActivitiesResponseSchema = external_exports.object({
   activities: external_exports.array(ActivitySchema),
   hasMore: external_exports.boolean(),
@@ -26725,26 +26734,29 @@ var NotificationsResponseSchema = external_exports.object({
   nextCursor: external_exports.string().optional()
 }).passthrough();
 var UnreadCountResponseSchema = external_exports.object({ count: external_exports.number() }).passthrough();
-var TriageActionSchema = external_exports.object({
-  actionKey: external_exports.string(),
-  projectId: external_exports.string(),
-  entityId: external_exports.string().optional(),
-  entityType: external_exports.enum(["beat", "revision", "note"]).optional(),
-  beatId: external_exports.string().optional(),
-  category: external_exports.string(),
-  priority: external_exports.string(),
-  beatStatus: external_exports.string().optional(),
-  title: external_exports.string(),
-  description: external_exports.string(),
-  status: external_exports.enum(["open", "acted", "dismissed", "resolved"]),
-  decision: external_exports.enum(["auto-execute", "escalate", "skip"]).optional(),
-  taskId: external_exports.string().optional(),
-  taskStatus: external_exports.string().optional(),
-  firstSeenAt: external_exports.string(),
-  lastSeenAt: external_exports.string(),
-  dismissedBy: external_exports.string().optional(),
-  dismissedAt: external_exports.string().optional()
-}).passthrough();
+var TriageActionSchema = external_exports.preprocess(
+  normalizeSystemId,
+  external_exports.object({
+    actionKey: external_exports.string(),
+    systemId: external_exports.string(),
+    entityId: external_exports.string().optional(),
+    entityType: external_exports.enum(["beat", "revision", "note"]).optional(),
+    beatId: external_exports.string().optional(),
+    category: external_exports.string(),
+    priority: external_exports.string(),
+    beatStatus: external_exports.string().optional(),
+    title: external_exports.string(),
+    description: external_exports.string(),
+    status: external_exports.enum(["open", "acted", "dismissed", "resolved"]),
+    decision: external_exports.enum(["auto-execute", "escalate", "skip"]).optional(),
+    taskId: external_exports.string().optional(),
+    taskStatus: external_exports.string().optional(),
+    firstSeenAt: external_exports.string(),
+    lastSeenAt: external_exports.string(),
+    dismissedBy: external_exports.string().optional(),
+    dismissedAt: external_exports.string().optional()
+  }).passthrough()
+);
 var TriageActionsResponseSchema = external_exports.object({
   actions: external_exports.array(TriageActionSchema)
 }).passthrough();
@@ -26761,15 +26773,15 @@ var NextActionSchema = external_exports.object({
 var NextActionsResponseSchema = external_exports.object({
   actions: external_exports.array(NextActionSchema)
 }).passthrough();
-var SearchResultSchema = external_exports.object({
+var SearchResultSchema = external_exports.preprocess(normalizeSystemId, external_exports.object({
   entityId: external_exports.string(),
-  entityType: external_exports.enum(["beat", "note", "revision", "beatVersion", "drop", "project"]),
+  entityType: external_exports.enum(["beat", "note", "revision", "beatVersion", "drop", "project", "system"]),
   score: external_exports.number(),
   snippet: external_exports.string(),
-  projectId: external_exports.string().optional(),
+  systemId: external_exports.string().optional(),
   projectName: external_exports.string().optional(),
   teamspaceId: external_exports.string().optional()
-}).passthrough();
+}).passthrough());
 var SearchScopeSchema = external_exports.object({
   kind: external_exports.enum(["project", "teamspace", "org"]),
   id: external_exports.string()
@@ -26809,31 +26821,40 @@ var LandscapeResponseSchema = external_exports.object({
   points: external_exports.array(LandscapePointSchema),
   links: external_exports.array(external_exports.object({ from: external_exports.string(), to: external_exports.string() }).passthrough()),
   clusters: external_exports.array(LandscapeClusterSchema),
-  scopeBoundary: external_exports.object({
-    projectId: external_exports.string(),
-    cx: external_exports.number(),
-    cy: external_exports.number(),
-    radius: external_exports.number(),
-    label: external_exports.string()
-  }).passthrough().optional(),
+  scopeBoundary: external_exports.preprocess(
+    (raw) => {
+      if (typeof raw !== "object" || raw === null) return raw;
+      const o = raw;
+      const id = o["systemId"] ?? o["projectId"];
+      if (!id) return raw;
+      return { ...o, systemId: id };
+    },
+    external_exports.object({
+      systemId: external_exports.string(),
+      cx: external_exports.number(),
+      cy: external_exports.number(),
+      radius: external_exports.number(),
+      label: external_exports.string()
+    }).passthrough()
+  ).optional(),
   meta: LandscapeMetaSchema
 }).passthrough();
 var ClusterDescriptionSchema = external_exports.object({
   title: external_exports.string(),
   description: external_exports.string()
 }).passthrough();
-var BeatVersionItemSchema = external_exports.object({
+var BeatVersionItemSchema = external_exports.preprocess(normalizeSystemId, external_exports.object({
   beatVersionId: external_exports.string(),
   beatId: external_exports.string(),
-  projectId: external_exports.string().optional(),
+  systemId: external_exports.string().optional(),
   status: external_exports.string()
-}).passthrough();
+}).passthrough());
 var BeatVersionsResponseSchema = external_exports.object({
   beatVersions: external_exports.array(BeatVersionItemSchema)
 }).passthrough();
 var ConversationSummaryBaseSchema = external_exports.object({
   conversationId: external_exports.string(),
-  projectId: external_exports.string().optional(),
+  systemId: external_exports.string().optional(),
   teamspaceId: external_exports.string().optional(),
   userId: external_exports.string(),
   conversationType: external_exports.string(),
@@ -26846,7 +26867,7 @@ var ConversationSummaryBaseSchema = external_exports.object({
   createdAt: external_exports.string(),
   updatedAt: external_exports.string()
 });
-var ConversationSummarySchema = ConversationSummaryBaseSchema.passthrough();
+var ConversationSummarySchema = external_exports.preprocess(normalizeSystemId, ConversationSummaryBaseSchema.passthrough());
 var StoredMessageSchema = external_exports.object({
   messageId: external_exports.string(),
   conversationId: external_exports.string(),
@@ -26952,6 +26973,13 @@ var WorkItemApiSchema = external_exports.object({
   costPerValueUnit: external_exports.number().optional(),
   /** Optional capability-lineage link to a Beat Version (v2, N-4E09-6574). */
   beatVersionId: external_exports.string().optional(),
+  /**
+   * Optional link to the Work Order this item delivers part of (B-331,
+   * N-4E09-7160). Absent means unattached, which is a supported state — a
+   * reader grouping a Track's work by Order must render those as their own
+   * named group, not hide them.
+   */
+  workOrderId: external_exports.string().min(1).optional(),
   createdBy: external_exports.string().optional(),
   version: external_exports.number().optional(),
   createdAt: external_exports.string(),
@@ -26963,6 +26991,93 @@ var WorkItemEstimateHintApiSchema = external_exports.object({
 });
 var WorkItemsResponseSchema = external_exports.object({ workItems: external_exports.array(WorkItemApiSchema) }).passthrough();
 var WorkItemResponseSchema = external_exports.object({ workItem: WorkItemApiSchema, estimateHint: WorkItemEstimateHintApiSchema.optional() }).passthrough();
+var WORK_INTAKE_STATUSES = [
+  "requested",
+  "needs_decision",
+  "accepted",
+  "done"
+];
+var WorkIntakeStatusApiSchema = external_exports.enum(WORK_INTAKE_STATUSES);
+var NEEDS_DECISION_REASONS = [
+  "out_of_scope",
+  "exceeds_capacity",
+  "incoherent_with_decision"
+];
+var NeedsDecisionReasonApiSchema = external_exports.enum(NEEDS_DECISION_REASONS);
+var WORK_ORDER_SIZES = [
+  "XS",
+  "S",
+  "M",
+  "L",
+  "XL"
+];
+var WorkOrderSizeApiSchema = external_exports.enum(WORK_ORDER_SIZES);
+var WORK_REQUEST_ORIGINS = [
+  "client",
+  "internal"
+];
+var WorkRequestOriginApiSchema = external_exports.enum(WORK_REQUEST_ORIGINS);
+var WorkRequestApiSchema = external_exports.object({
+  workRequestId: external_exports.string(),
+  movementId: external_exports.string(),
+  teamspaceId: external_exports.string(),
+  orgId: external_exports.string(),
+  title: external_exports.string(),
+  /** The ask as written, in the requester's own language. */
+  body: external_exports.string().optional(),
+  requester: HumanAssigneeApiSchema,
+  /** Where the ask entered — one entity covers both, only the entry point differs. */
+  origin: WorkRequestOriginApiSchema,
+  createdBy: external_exports.string().optional(),
+  version: external_exports.number().optional(),
+  createdAt: external_exports.string(),
+  updatedAt: external_exports.string()
+}).passthrough();
+var WorkOrderApiSchema = external_exports.object({
+  workOrderId: external_exports.string(),
+  /** Immutable lineage back to the ask this Order was split from. */
+  workRequestId: external_exports.string(),
+  /** Mutable — an Order moves Tracks when an early split guess turns out wrong. */
+  trackId: external_exports.string(),
+  teamspaceId: external_exports.string(),
+  orgId: external_exports.string(),
+  title: external_exports.string(),
+  description: external_exports.string().optional(),
+  status: WorkIntakeStatusApiSchema,
+  /** Present if and only if status is `needs_decision` — the reason IS the routing. */
+  needsDecisionReason: NeedsDecisionReasonApiSchema.optional(),
+  /** Absent when the Order arrived before it was sized, which the composition counts. */
+  size: WorkOrderSizeApiSchema.optional(),
+  createdBy: external_exports.string().optional(),
+  version: external_exports.number().optional(),
+  createdAt: external_exports.string(),
+  updatedAt: external_exports.string()
+}).passthrough();
+var WorkRequestSizeEntryApiSchema = external_exports.object({
+  size: WorkOrderSizeApiSchema,
+  count: external_exports.number()
+});
+var WorkRequestSizeCompositionApiSchema = external_exports.object({
+  /** Largest first, so a display reads "a large and a medium". */
+  entries: external_exports.array(WorkRequestSizeEntryApiSchema),
+  /** Orders carrying no usable size — counted, never silently dropped. */
+  unsized: external_exports.number(),
+  /** Sized orders only. */
+  totalValueUnits: external_exports.number()
+});
+var WorkRequestOrderApiSchema = WorkOrderApiSchema.extend({
+  /** Absent — not null — when the Track no longer resolves. */
+  trackTitle: external_exports.string().optional()
+}).passthrough();
+var WorkRequestsResponseSchema = external_exports.object({ workRequests: external_exports.array(WorkRequestApiSchema) }).passthrough();
+var WorkOrdersResponseSchema = external_exports.object({ workOrders: external_exports.array(WorkOrderApiSchema) }).passthrough();
+var WorkRequestResponseSchema = external_exports.object({ workRequest: WorkRequestApiSchema }).passthrough();
+var WorkOrderResponseSchema = external_exports.object({ workOrder: WorkOrderApiSchema }).passthrough();
+var WorkRequestDetailResponseSchema = external_exports.object({
+  workRequest: WorkRequestApiSchema,
+  orders: external_exports.array(WorkRequestOrderApiSchema),
+  size: WorkRequestSizeCompositionApiSchema
+}).passthrough();
 var AccountStatusSchema = external_exports.enum(["active", "inactive", "archived"]);
 var AccountApiSchema = external_exports.object({
   accountId: external_exports.string(),
@@ -26999,14 +27114,13 @@ var LayerApiSchema = external_exports.preprocess(
   (raw) => {
     if (typeof raw !== "object" || raw === null) return raw;
     const l = raw;
-    const id = l["systemId"] ?? l["projectId"];
+    const id = l["systemId"] || l["projectId"];
     if (!id) return raw;
-    return { ...l, systemId: id, projectId: id };
+    return { ...l, systemId: id };
   },
   external_exports.object({
     layerId: external_exports.string(),
     systemId: external_exports.string(),
-    projectId: external_exports.string(),
     layerKey: external_exports.string(),
     name: external_exports.string(),
     description: external_exports.string().nullish(),
@@ -27058,11 +27172,11 @@ var DELIVERABLE_GROUP_STATUSES = [
   "cancelled"
 ];
 var DeliverableGroupStatusSchema = external_exports.enum(DELIVERABLE_GROUP_STATUSES);
-var DeliverableGroupApiSchema = external_exports.object({
+var DeliverableGroupApiSchema = external_exports.preprocess(normalizeSystemId, external_exports.object({
   deliverableGroupId: external_exports.string(),
   groupCode: external_exports.string(),
   teamspaceId: external_exports.string(),
-  projectId: external_exports.string().nullish(),
+  systemId: external_exports.string().nullish(),
   movementId: external_exports.string().nullish(),
   orgId: external_exports.string(),
   title: external_exports.string(),
@@ -27079,7 +27193,7 @@ var DeliverableGroupApiSchema = external_exports.object({
   version: external_exports.number().nullish(),
   createdAt: external_exports.string(),
   updatedAt: external_exports.string()
-}).passthrough();
+}).passthrough());
 var DeliverableGroupsResponseSchema = external_exports.object({
   deliverableGroups: external_exports.array(DeliverableGroupApiSchema)
 }).passthrough();
@@ -27096,27 +27210,33 @@ var MovementDropSummaryApiSchema = external_exports.object({
 var MovementDropsResponseSchema = external_exports.object({
   drops: external_exports.array(MovementDropSummaryApiSchema)
 }).passthrough();
-var WorkPlanBeatVersionApiSchema = external_exports.object({
-  beatVersionId: external_exports.string(),
-  beatId: external_exports.string(),
-  projectId: external_exports.string(),
-  versionNumber: external_exports.number(),
-  title: external_exports.string(),
-  status: BeatVersionStatusSchema,
-  // 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 —
-  // validatedApiFetch would otherwise throw and drop the whole hook into error.
-  valueUnits: external_exports.number().default(0),
-  createdAt: external_exports.string(),
-  updatedAt: external_exports.string()
-}).passthrough();
+var WorkPlanBeatVersionApiSchema = external_exports.preprocess(
+  normalizeSystemId,
+  external_exports.object({
+    beatVersionId: external_exports.string(),
+    beatId: external_exports.string(),
+    systemId: external_exports.string(),
+    versionNumber: external_exports.number(),
+    title: external_exports.string(),
+    status: BeatVersionStatusSchema,
+    // 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 —
+    // validatedApiFetch would otherwise throw and drop the whole hook into error.
+    valueUnits: external_exports.number().default(0),
+    createdAt: external_exports.string(),
+    updatedAt: external_exports.string()
+  }).passthrough()
+);
 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() })
+  external_exports.preprocess(
+    normalizeSystemId,
+    external_exports.object({ kind: external_exports.literal("agent"), agentId: external_exports.string(), systemId: external_exports.string() })
+  )
 ]);
 var RevisionClaimSchema = external_exports.object({
   claimId: external_exports.string(),
@@ -27127,33 +27247,39 @@ var RevisionClaimSchema = external_exports.object({
 var RevisionClaimsResponseSchema = external_exports.object({
   claims: external_exports.array(RevisionClaimSchema)
 }).passthrough();
-var ProposedRevisionSchema = external_exports.object({
-  revisionId: external_exports.string(),
-  title: external_exports.string(),
-  state: external_exports.string(),
-  beatId: external_exports.string(),
-  beatTitle: external_exports.string().optional(),
-  projectId: external_exports.string(),
-  projectTitle: external_exports.string().optional()
-}).passthrough();
+var ProposedRevisionSchema = external_exports.preprocess(
+  normalizeSystemId,
+  external_exports.object({
+    revisionId: external_exports.string(),
+    title: external_exports.string(),
+    state: external_exports.string(),
+    beatId: external_exports.string(),
+    beatTitle: external_exports.string().optional(),
+    systemId: external_exports.string(),
+    projectTitle: external_exports.string().optional()
+  }).passthrough()
+);
 var ReleaseIntervalSchema = external_exports.object({
   averageIntervalDays: external_exports.number(),
   sampleSize: external_exports.number(),
   isFallback: external_exports.boolean()
 }).passthrough();
-var EligibleBeatVersionForDropSchema = external_exports.object({
-  beatVersionId: external_exports.string(),
-  title: external_exports.string(),
-  state: external_exports.string(),
-  beatId: external_exports.string(),
-  beatTitle: external_exports.string().optional(),
-  projectId: external_exports.string(),
-  projectTitle: external_exports.string().optional(),
-  createdAt: external_exports.string(),
-  updatedAt: external_exports.string(),
-  humanAssignee: external_exports.object({ email: external_exports.string(), name: external_exports.string() }).optional(),
-  currentDropAssignment: external_exports.object({ dropId: external_exports.string(), dropCode: external_exports.string().optional(), state: external_exports.string() }).optional()
-}).passthrough();
+var EligibleBeatVersionForDropSchema = external_exports.preprocess(
+  normalizeSystemId,
+  external_exports.object({
+    beatVersionId: external_exports.string(),
+    title: external_exports.string(),
+    state: external_exports.string(),
+    beatId: external_exports.string(),
+    beatTitle: external_exports.string().optional(),
+    systemId: external_exports.string(),
+    projectTitle: external_exports.string().optional(),
+    createdAt: external_exports.string(),
+    updatedAt: external_exports.string(),
+    humanAssignee: external_exports.object({ email: external_exports.string(), name: external_exports.string() }).optional(),
+    currentDropAssignment: external_exports.object({ dropId: external_exports.string(), dropCode: external_exports.string().optional(), state: external_exports.string() }).optional()
+  }).passthrough()
+);
 var ScoredDropCandidateSchema = external_exports.object({
   bv: EligibleBeatVersionForDropSchema,
   // Score fields are nullable — the ranking engine returns null when there is
@@ -27393,7 +27519,7 @@ ${formatDeliveryPolicy(
 function registerNoteTools(server, ctx, client) {
   server.tool(
     "list_notes",
-    "List Notes for a system. Without beatId: returns all notes (system-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.",
+    "List Notes for a system. Without beatId: returns all notes (system-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 system-wide results.",
     {
       systemId: external_exports.string().describe("The system ID"),
       beatId: external_exports.string().optional().describe("Scope to a specific beat (omit for all system notes)"),
@@ -27405,7 +27531,7 @@ function registerNoteTools(server, ctx, client) {
       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)"),
       limit: external_exports.coerce.number().int().min(1).max(500).default(100).describe("Max notes to return (default 100, max 500)"),
-      cursor: external_exports.string().optional().describe("Opaque pagination cursor from a previous response \u2014 use for project-wide note pagination (no beatId)"),
+      cursor: external_exports.string().optional().describe("Opaque pagination cursor from a previous response \u2014 use for system-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 ({ systemId, beatId, noteType, status, revisionId, beatVersionId, sourceDocumentNoteId, significance, offset = 0, limit = 100, cursor, orderBy }) => {
@@ -27420,7 +27546,7 @@ function registerNoteTools(server, ctx, client) {
         return { content: [{ type: "text", text: "orderBy requires beatId \u2014 it is only supported for beat-scoped queries." }], isError: true };
       }
       try {
-        await assertProjectInOrg(client, systemId, ctx.orgId);
+        await assertSystemInOrg(client, systemId, ctx.orgId);
       } catch (err) {
         const message = err instanceof Error ? err.message : String(err);
         return { content: [{ type: "text", text: `Access denied: ${message}` }], isError: true };
@@ -27463,7 +27589,7 @@ function registerNoteTools(server, ctx, client) {
           allNotesResult = await client.listAllSystemNotes(systemId, filters, SOURCE_DOC_FETCH_LIMIT);
         } catch (err) {
           const message = err instanceof Error ? err.message : String(err);
-          return { content: [{ type: "text", text: `Failed to list project notes: ${message}` }], isError: true };
+          return { content: [{ type: "text", text: `Failed to list system notes: ${message}` }], isError: true };
         }
         const { notes: allNotes, hasMore: corpusTruncated } = allNotesResult;
         const filtered = allNotes.filter((n) => n.sourceSubmissionId === sourceDocumentNoteId);
@@ -27471,7 +27597,7 @@ function registerNoteTools(server, ctx, client) {
         page = filtered.slice(offset, offset + limit);
         hasMore = offset + limit < total;
         const truncationWarning = corpusTruncated ? `
-> \u26A0\uFE0F Project has >5000 notes; sourceDocumentNoteId filter may be incomplete.
+> \u26A0\uFE0F System has >5000 notes; sourceDocumentNoteId filter may be incomplete.
 ` : "";
         header = (hasMore ? `Showing ${offset + 1}\u2013${offset + page.length} of ${total} notes. Use offset=${offset + limit} to continue.
 
@@ -27484,7 +27610,7 @@ function registerNoteTools(server, ctx, client) {
           projectNotesResult = await client.listAllSystemNotes(systemId, filters, limit, cursor);
         } catch (err) {
           const message = err instanceof Error ? err.message : String(err);
-          return { content: [{ type: "text", text: `Failed to list project notes: ${message}` }], isError: true };
+          return { content: [{ type: "text", text: `Failed to list system notes: ${message}` }], isError: true };
         }
         const { notes: rawNotes, cursor: nextCursor, hasMore: serviceHasMore } = projectNotesResult;
         hasMore = serviceHasMore;
@@ -27566,11 +27692,11 @@ function registerNoteTools(server, ctx, client) {
       systemId: external_exports.string().describe("The system ID")
     },
     async ({ systemId }) => {
-      await assertProjectInOrg(client, systemId, ctx.orgId);
+      await assertSystemInOrg(client, systemId, ctx.orgId);
       const DOCUMENT_FETCH_LIMIT = 5e3;
       const { notes: docs, hasMore: truncated } = await client.listAllSystemNotes(systemId, { noteType: "document" }, DOCUMENT_FETCH_LIMIT);
       const visibleDocs = docs.filter((d) => d.status !== DISMISSED_NOTE_STATUS);
-      const truncationNotice = truncated && visibleDocs.length > 0 ? "\n\n> \u26A0\uFE0F This project has more than 5000 documents. Some documents may not be shown.\n" : "";
+      const truncationNotice = truncated && visibleDocs.length > 0 ? "\n\n> \u26A0\uFE0F This system has more than 5000 documents. Some documents may not be shown.\n" : "";
       const text = formatDocumentList(visibleDocs) + truncationNotice;
       return { content: [{ type: "text", text }] };
     }
@@ -27601,7 +27727,7 @@ function registerNoteTools(server, ctx, client) {
           }
           return { content: [{ type: "text", text: formatNoteDetail(note2) }] };
         }
-        await assertProjectInOrg(client, systemId, ctx.orgId);
+        await assertSystemInOrg(client, systemId, ctx.orgId);
         const note = await client.getNote(noteId);
         if (!note) {
           return { content: [{ type: "text", text: `Note not found: "${noteId}"` }], isError: true };
@@ -27619,8 +27745,8 @@ function registerNoteTools(server, ctx, client) {
     "Create a new Note. Provide exactly one of systemId, teamspaceId, movementId, or none (org-level): systemId scopes the note to a system (optionally with beatId), teamspaceId scopes it to a teamspace (no cascade to child systems), movementId scopes it to a Movement (commercial SOW container \u2014 engagement-level knowledge), and omitting all creates an org-level note that applies across all systems.",
     {
       systemId: external_exports.string().optional().describe("The system ID (omit for teamspace-, movement-, or org-level note)"),
-      teamspaceId: external_exports.string().optional().describe("The teamspace ID (omit for project-, movement-, or org-level note)"),
-      movementId: external_exports.string().min(1).optional().describe("The Movement ID (omit for project-, teamspace-, or org-level note)"),
+      teamspaceId: external_exports.string().optional().describe("The teamspace ID (omit for system-, movement-, or org-level note)"),
+      movementId: external_exports.string().min(1).optional().describe("The Movement ID (omit for system-, teamspace-, or org-level note)"),
       noteType: external_exports.enum(NOTE_TYPE_VALUES).describe("The type of note"),
       content: external_exports.string().describe("The note content"),
       beatId: external_exports.string().optional().describe("Beat ID if this note is beat-scoped (requires systemId)"),
@@ -27640,7 +27766,7 @@ function registerNoteTools(server, ctx, client) {
         const assumptionMeta = noteType === "assumption" && confidence !== void 0 ? { confidence } : void 0;
         let note;
         if (systemId) {
-          await assertProjectInOrg(client, systemId, ctx.orgId);
+          await assertSystemInOrg(client, systemId, ctx.orgId);
           const projectCode = systemId.substring(0, 4).toUpperCase();
           const noteId = await client.getNextNoteId(projectCode, systemId);
           note = await client.createNote({
@@ -27725,7 +27851,7 @@ ${text}` }] };
       content: external_exports.string().optional().describe("Updated content"),
       rationale: external_exports.string().optional().describe("Why this note exists or why this decision was made"),
       response: external_exports.string().optional().describe("User response (for resolving assumptions)"),
-      beatId: external_exports.string().nullable().optional().describe("Move this note to a different beat, or null to unscope it back to project level (updates all index items transactionally)"),
+      beatId: external_exports.string().nullable().optional().describe("Move this note to a different beat, or null to unscope it back to system level (updates all index items transactionally)"),
       revisionId: external_exports.string().optional().describe("Revision ID to associate this note with (revision-scoped assumptions, decisions, or guidance)"),
       dependsOnNotes: external_exports.array(external_exports.string()).optional().describe("Note IDs this note depends on (child \u2192 parent links for consolidation)"),
       humanAssignee: humanAssigneeSchema.nullable().optional().describe("Assign or reassign this note to a person (null to clear)"),
@@ -27768,7 +27894,7 @@ ${text}` }] };
 
 ${formatNoteDetail(updated2)}` }] };
         }
-        await assertProjectInOrg(client, systemId, ctx.orgId);
+        await assertSystemInOrg(client, systemId, ctx.orgId);
         const updated = await client.updateNote(noteId, {
           ...noteType !== void 0 && { noteType },
           status,
@@ -27810,7 +27936,7 @@ ${text}` }] };
     },
     async ({ systemId, noteIds, noteType, status, content, response, humanAssignee, agentAssignee }) => {
       try {
-        await assertProjectInOrg(client, systemId, ctx.orgId);
+        await assertSystemInOrg(client, systemId, ctx.orgId);
         const result = await client.bulkUpdateNotes(noteIds, {
           ...noteType !== void 0 && { noteType },
           status,
@@ -27849,7 +27975,7 @@ ${text}` }] };
     },
     async ({ systemId, noteId, targetBeatId, targetRevisionId, reason }) => {
       try {
-        await assertProjectInOrg(client, systemId, ctx.orgId);
+        await assertSystemInOrg(client, systemId, ctx.orgId);
         const updated = await client.reassignNote(noteId, targetBeatId, reason, ctx.user.userId, targetRevisionId);
         if (!updated) {
           return { content: [{ type: "text", text: `Note not found: "${noteId}"` }], isError: true };
@@ -27871,7 +27997,7 @@ ${text}` }] };
     },
     async ({ systemId, noteId, reason }) => {
       try {
-        await assertProjectInOrg(client, systemId, ctx.orgId);
+        await assertSystemInOrg(client, systemId, ctx.orgId);
         const note = await client.getNote(noteId);
         if (!note || (note.systemId ?? note.projectId) !== systemId) {
           return { content: [{ type: "text", text: `Note not found: "${noteId}"` }], isError: true };
@@ -27898,7 +28024,7 @@ ${text}` }] };
     },
     async ({ systemId, noteId, reason }) => {
       try {
-        await assertProjectInOrg(client, systemId, ctx.orgId);
+        await assertSystemInOrg(client, systemId, ctx.orgId);
         const note = await client.getNote(noteId);
         if (!note || (note.systemId ?? note.projectId) !== systemId) {
           return { content: [{ type: "text", text: `Document not found: "${noteId}"` }], isError: true };
@@ -27928,7 +28054,7 @@ ${text}` }] };
       systemId: external_exports.string().describe("The system ID")
     },
     async ({ systemId }) => {
-      await assertProjectInOrg(client, systemId, ctx.orgId);
+      await assertSystemInOrg(client, systemId, ctx.orgId);
       const assumptions = await client.getKeyAssumptions(systemId);
       if (assumptions.length === 0) {
         return { content: [{ type: "text", text: "No unvalidated assumptions found." }] };
@@ -28631,7 +28757,7 @@ function registerOnboardingTools(server, ctx, client) {
       analysisJson: external_exports.string().optional().describe("JSON-serialized DiscoveryAnalysis from initiate_teamspace_onboarding. Pass this to produce Beats grounded in the actual discovery data.")
     },
     async ({ systemId, systemTitle, projectDescription, analysisJson }) => {
-      await assertProjectInOrg(client, systemId, ctx.orgId);
+      await assertSystemInOrg(client, systemId, ctx.orgId);
       const result = await client.draftOnboardingBeats(systemId, { systemTitle, projectDescription, analysisJson });
       if (!result.suggestions || result.suggestions.length === 0) {
         return {
@@ -28660,7 +28786,7 @@ function registerOnboardingTools(server, ctx, client) {
   server.tool(
     "create_teamspace_onboarding_batch",
     [
-      "Create a Teamspace, Projects, and Notes",
+      "Create a Teamspace, Systems, and Notes",
       "from a PM-approved onboarding payload in a single batch operation.",
       "Call this after the PM approves the pre-flight review card from initiate_teamspace_onboarding.",
       "Returns a creation receipt with IDs and counts for all created entities.",
@@ -28668,8 +28794,8 @@ function registerOnboardingTools(server, ctx, client) {
     ].join(" "),
     {
       teamspaceName: external_exports.string().min(1).max(200).describe("Teamspace display name"),
-      projects: external_exports.array(OnboardingProjectInputSchema).min(1).describe("Phase 1 projects to create, each linked to the Teamspace"),
-      teamspaceNotes: external_exports.array(OnboardingNoteInputSchema).describe("Constraints, assumptions, and context notes at the Teamspace/project level")
+      projects: external_exports.array(OnboardingProjectInputSchema).min(1).describe("Phase 1 systems to create, each linked to the Teamspace"),
+      teamspaceNotes: external_exports.array(OnboardingNoteInputSchema).describe("Constraints, assumptions, and context notes at the Teamspace/system level")
     },
     async ({
       teamspaceName,
@@ -28710,7 +28836,7 @@ Error: ${msg}`);
           const msg = err instanceof Error ? err.message : String(err);
           lines.push(`
 Projects created: ${createdProjects.length}`);
-          lines.unshift(`\u26A0\uFE0F  Onboarding batch partially created \u2014 stopped at: project "${p.title}"
+          lines.unshift(`\u26A0\uFE0F  Onboarding batch partially created \u2014 stopped at: system "${p.title}"
 Error: ${msg}`);
           return { content: [{ type: "text", text: lines.join("\n") }] };
         }
@@ -28932,7 +29058,7 @@ function registerOrganizationTools(server, ctx, client) {
       if (system.orgId !== ctx.orgId) {
         return { content: [{ type: "text", text: `System "${systemId}" does not belong to the configured organization.` }], isError: true };
       }
-      const result = await client.transferProject(ctx.orgId, systemId, targetOrgId);
+      const result = await client.transferSystem(ctx.orgId, systemId, targetOrgId);
       if (result.error) {
         return { content: [{ type: "text", text: result.error }], isError: true };
       }
@@ -29083,7 +29209,7 @@ function registerPlanQualityTools(server, ctx, client) {
           isError: true
         };
       }
-      await assertProjectInOrg(client, systemId, ctx.orgId);
+      await assertSystemInOrg(client, systemId, ctx.orgId);
       const opts = branch || localPath ? { branch, localPath } : void 0;
       const task = await client.runCheck(systemId, "beat_version_quality", beatVersionId, opts);
       if (!wait) {
@@ -29230,7 +29356,7 @@ function registerPortfolioCoherenceTools(server, ctx, client) {
     },
     async ({ systemId, wait }) => {
       try {
-        await assertProjectInOrg(client, systemId, ctx.orgId);
+        await assertSystemInOrg(client, systemId, ctx.orgId);
         const { taskId } = await client.runCheck(systemId, "portfolio_coherence", systemId);
         if (!wait) {
           return {
@@ -29267,7 +29393,7 @@ function registerPortfolioCoherenceTools(server, ctx, client) {
       const archivedBeatIds = [];
       let totalNotesReassigned = 0;
       try {
-        await assertProjectInOrg(client, systemId, ctx.orgId);
+        await assertSystemInOrg(client, systemId, ctx.orgId);
         const uniqueBeatIds = [...new Set(beatIds)];
         const resolvedPrimaryId = primaryBeatId ?? uniqueBeatIds[0];
         if (!uniqueBeatIds.includes(resolvedPrimaryId)) {
@@ -30020,8 +30146,8 @@ function registerRevisionQualityTools(server, ctx, client) {
             isError: true
           };
         }
-        await assertProjectInOrg(client, systemId, ctx.orgId);
-        await assertRevisionInProject(client, revisionId, systemId);
+        await assertSystemInOrg(client, systemId, ctx.orgId);
+        await assertRevisionInSystem(client, revisionId, systemId);
         const task = await client.runCheck(systemId, "revision_quality", revisionId);
         if (!wait) {
           return {
@@ -30326,7 +30452,7 @@ function registerSnapshotTools(server, ctx, client) {
     "Export a complete system snapshot for environment sync. On a remote server (production/staging) returns an S3 presigned URL; on a local server writes to a temp file and returns the path.",
     { systemId: external_exports.string().describe("The system ID to export") },
     async ({ systemId }) => {
-      await assertProjectInOrg(client, systemId, ctx.orgId);
+      await assertSystemInOrg(client, systemId, ctx.orgId);
       const result = await client.exportSystemSnapshot(systemId);
       if (typeof result === "string") {
         if (!result.startsWith("https://")) {
@@ -30574,7 +30700,7 @@ function registerSubscriptionTools(server, ctx, client) {
     },
     async ({ entityType, entityId, systemId }) => {
       try {
-        await assertProjectInOrg(client, systemId, ctx.orgId);
+        await assertSystemInOrg(client, systemId, ctx.orgId);
         await client.subscribe(ctx.user.userId, entityType, entityId, systemId, "manual");
         return {
           content: [{
@@ -30638,7 +30764,7 @@ function registerSubscriptionTools(server, ctx, client) {
 }
 
 // ../../libs/harmonica-services/src/mcp/tools/system-lifecycle-tools.ts
-function registerProjectLifecycleTools(server, ctx, client) {
+function registerSystemLifecycleTools(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.",
@@ -30744,7 +30870,7 @@ function registerSystemTools(server, ctx, client) {
   }) => {
     try {
       const [project, org] = await Promise.all([
-        fetchProjectInOrg(client, systemId, ctx.orgId),
+        fetchSystemInOrg(client, systemId, ctx.orgId),
         client.getOrg(ctx.orgId)
       ]);
       const notes = await client.listSystemNotes(systemId, {
@@ -30788,7 +30914,7 @@ function registerSystemTools(server, ctx, client) {
       if (Object.keys(nonEmpty).length === 0) {
         return { content: [{ type: "text", text: "No updates provided." }], isError: true };
       }
-      await assertProjectInOrg(client, systemId, ctx.orgId);
+      await assertSystemInOrg(client, systemId, ctx.orgId);
       if (nonEmpty["accountId"] === "") delete nonEmpty["accountId"];
       if (typeof updates.teamspaceId === "string") {
         const teamspace = await client.getTeamspace(updates.teamspaceId);
@@ -31127,7 +31253,7 @@ function registerValueVelocityTools(server, ctx, client) {
     },
     async ({ systemId, lens, withLeverage }) => {
       try {
-        await assertProjectInOrg(client, systemId, ctx.orgId);
+        await assertSystemInOrg(client, systemId, ctx.orgId);
         const [rankedResult, staleWResult] = await Promise.allSettled([
           withLeverage ? client.rankSystemBeatVersionsWithLeverage(systemId, lens) : client.rankSystemBeatVersions(systemId, lens),
           client.getStaleWBeatIds(systemId)
@@ -31234,7 +31360,7 @@ function registerValueVelocityTools(server, ctx, client) {
     },
     async ({ systemId, beatId }) => {
       try {
-        await assertProjectInOrg(client, systemId, ctx.orgId);
+        await assertSystemInOrg(client, systemId, ctx.orgId);
         const actorId = resolveActorId(ctx);
         if (!actorId) {
           return { content: [{ type: "text", text: "Actor identity unavailable: user has no email or userId." }], isError: true };
@@ -31417,6 +31543,7 @@ function registerWorkItemTools(server, _ctx, client) {
         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,
+        wi.workOrderId ? `Work Order: ${wi.workOrderId}` : "Work Order: none (unattached)",
         estimateHint ? `Estimate Hint: ${estimateHint.hours}h (source: ${estimateHint.source})` : null,
         wi.createdBy ? `Created By: ${wi.createdBy}` : null,
         `Created: ${wi.createdAt}`,
@@ -31427,7 +31554,7 @@ function registerWorkItemTools(server, _ctx, client) {
   );
   server.tool(
     "create_work_item",
-    'Create a work item under a Track (DeliverableGroup). A work item is an owned, statused unit of operational work \u2014 it is NOT a Beat. Starts in "not_started" status. Optionally link it to a Beat Version for capability lineage (v2, N-4E09-6574) \u2014 the link is one-directional and never required.',
+    'Create a work item under a Track (DeliverableGroup). A work item is an owned, statused unit of operational work \u2014 it is NOT a Beat. Starts in "not_started" status. Optionally link it to a Beat Version for capability lineage (v2, N-4E09-6574) \u2014 the link is one-directional and never required. Optionally link it to a Work Order it delivers part of; leaving it unattached is a supported state, not a gap to fill (N-4E09-7160).',
     {
       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"),
@@ -31438,9 +31565,10 @@ function registerWorkItemTools(server, _ctx, client) {
       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.")
+      beatVersionId: external_exports.string().min(1).optional().describe("Optional Beat Version to link for capability lineage. Must exist."),
+      workOrderId: external_exports.string().min(1).max(128).optional().describe("Optional Work Order this item delivers part of. Must exist. Omit when there is no Order \u2014 unattached work is legitimate, so do not invent one.")
     },
-    async ({ trackId, title, ownerName, ownerEmail, committedEstimateHours, effortSize, valueUnits, costPerValueUnit, createdBy, beatVersionId }) => {
+    async ({ trackId, title, ownerName, ownerEmail, committedEstimateHours, effortSize, valueUnits, costPerValueUnit, createdBy, beatVersionId, workOrderId }) => {
       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." }],
@@ -31456,7 +31584,8 @@ function registerWorkItemTools(server, _ctx, client) {
         ...valueUnits !== void 0 && { valueUnits },
         ...costPerValueUnit !== void 0 && { costPerValueUnit },
         ...createdBy !== void 0 && { createdBy },
-        ...beatVersionId !== void 0 && { beatVersionId }
+        ...beatVersionId !== void 0 && { beatVersionId },
+        ...workOrderId !== void 0 && { workOrderId }
       });
       return {
         content: [
@@ -31470,7 +31599,7 @@ function registerWorkItemTools(server, _ctx, client) {
   );
   server.tool(
     "update_work_item",
-    "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.",
+    "Update mutable content fields on a work item (title, owner, committedEstimateHours, actualHours, effortSize, valueUnits, costPerValueUnit, beatVersionId, workOrderId). 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"),
@@ -31482,9 +31611,10 @@ function registerWorkItemTools(server, _ctx, client) {
       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.")
+      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."),
+      workOrderId: external_exports.string().min(1).max(128).nullable().optional().describe("Link to the Work Order this item delivers part of. Pass null to unlink, leaving the item unattached; omit to leave the current link untouched.")
     },
-    async ({ workItemId, title, ownerName, ownerEmail, unassignOwner, committedEstimateHours, actualHours, effortSize, valueUnits, costPerValueUnit, beatVersionId }) => {
+    async ({ workItemId, title, ownerName, ownerEmail, unassignOwner, committedEstimateHours, actualHours, effortSize, valueUnits, costPerValueUnit, beatVersionId, workOrderId }) => {
       const hasOwnerUpdate = ownerName !== void 0 || ownerEmail !== void 0;
       if (hasOwnerUpdate && (ownerName === void 0 || ownerEmail === void 0)) {
         return {
@@ -31498,7 +31628,9 @@ function registerWorkItemTools(server, _ctx, client) {
           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;
+      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 || // `!== undefined`, never truthiness: an unlink arrives as `null`, and
+      // a truthy check here would report "no updates provided" and drop it.
+      workOrderId !== void 0;
       if (!hasUpdates) {
         return {
           content: [{ type: "text", text: `No updates provided for work item: ${workItemId}` }],
@@ -31514,7 +31646,8 @@ function registerWorkItemTools(server, _ctx, client) {
         ...effortSize !== void 0 && { effortSize },
         ...valueUnits !== void 0 && { valueUnits },
         ...costPerValueUnit !== void 0 && { costPerValueUnit },
-        ...beatVersionId !== void 0 && { beatVersionId }
+        ...beatVersionId !== void 0 && { beatVersionId },
+        ...workOrderId !== void 0 && { workOrderId }
       });
       if (!wi) {
         return {
@@ -31579,6 +31712,337 @@ function registerWorkItemTools(server, _ctx, client) {
   );
 }
 
+// ../../libs/harmonica-services/src/mcp/tools/work-order-tools.ts
+var WORK_INTAKE_STATUS_ENUM = [
+  "requested",
+  "needs_decision",
+  "accepted",
+  "done"
+];
+var NEEDS_DECISION_REASON_ENUM = [
+  "out_of_scope",
+  "exceeds_capacity",
+  "incoherent_with_decision"
+];
+var WORK_ORDER_SIZE_ENUM = [
+  "XS",
+  "S",
+  "M",
+  "L",
+  "XL"
+];
+function oneLine(value) {
+  return value.replace(/[\r\n]+/g, " ");
+}
+function formatOrderLine(o) {
+  const reason = o.needsDecisionReason ? ` [${o.needsDecisionReason}]` : "";
+  return `[${o.workOrderId}] ${oneLine(o.title)} \u2014 ${o.status}${reason}, ${o.size ?? "unsized"}, on ${o.trackId}`;
+}
+function registerWorkOrderTools(server, _ctx, client) {
+  server.tool(
+    "list_track_work_orders",
+    'List the Work Orders placed on a Track (DeliverableGroup). A Work Order is the internal unit of agreed work. Recognition cues: "what is committed on this track", "list the orders" \u2192 list_track_work_orders.',
+    {
+      trackId: external_exports.string().describe("The Track (DeliverableGroup) ID")
+    },
+    async ({ trackId }) => {
+      const orders = await client.listTrackWorkOrders(trackId);
+      const text = orders.length === 0 ? "No work orders found." : orders.map(formatOrderLine).join("\n");
+      return { content: [{ type: "text", text }] };
+    }
+  );
+  server.tool(
+    "list_work_request_work_orders",
+    "List the Work Orders one Work Request split into \u2014 the lineage view. A four-way split shows four orders here, each possibly on a different Track and in a different state.",
+    {
+      workRequestId: external_exports.string().describe("The Work Request ID")
+    },
+    async ({ workRequestId }) => {
+      const orders = await client.listWorkRequestWorkOrders(workRequestId);
+      const text = orders.length === 0 ? "No work orders found \u2014 this request has not been split yet." : orders.map(formatOrderLine).join("\n");
+      return { content: [{ type: "text", text }] };
+    }
+  );
+  server.tool(
+    "get_work_order",
+    "Get a Work Order by ID. Returns its title, status (with the routing reason when it is awaiting a decision), t-shirt size, the Track it sits on, and the Work Request it was split from.",
+    {
+      workOrderId: external_exports.string().describe("The Work Order ID (e.g., wo-abc123)")
+    },
+    async ({ workOrderId }) => {
+      const wo = await client.getWorkOrder(workOrderId);
+      if (!wo) {
+        return { content: [{ type: "text", text: `Work order not found: ${workOrderId}` }] };
+      }
+      const lines = [
+        `ID: ${wo.workOrderId}`,
+        `Title: ${oneLine(wo.title)}`,
+        `From Work Request: ${wo.workRequestId}`,
+        `Track: ${wo.trackId}`,
+        `Status: ${wo.status}`,
+        wo.needsDecisionReason ? `Routing Reason: ${wo.needsDecisionReason}` : null,
+        wo.size !== void 0 ? `Size: ${wo.size}` : "Size: unsized",
+        wo.description ? `Description: ${oneLine(wo.description)}` : null,
+        wo.createdBy ? `Created By: ${wo.createdBy}` : null,
+        `Created: ${wo.createdAt}`,
+        `Updated: ${wo.updatedAt}`
+      ].filter(Boolean).join("\n");
+      return { content: [{ type: "text", text: lines }] };
+    }
+  );
+  server.tool(
+    "create_work_order",
+    'Split a Work Request into an agreed Work Order on a Track. Called once per piece: a request covering two separate lines of work becomes two orders. Starts in "requested" status \u2014 moving it past the coherence gate is transition_work_order_status. The Track must belong to the same teamspace and Account as the Request; the service refuses a placement that crosses either boundary.',
+    {
+      trackId: external_exports.string().describe("The Track (DeliverableGroup) this order is placed on"),
+      workRequestId: external_exports.string().min(1).describe("The Work Request this order was split from \u2014 immutable lineage"),
+      title: external_exports.string().min(1).max(300).describe("Work order title"),
+      description: external_exports.string().max(1e4).optional().describe("Optional detail beyond the title"),
+      size: external_exports.enum(WORK_ORDER_SIZE_ENUM).optional().describe("Optional t-shirt size. An order can arrive before it is sized; a request's composition counts unsized orders rather than hiding them."),
+      createdBy: external_exports.string().optional().describe("Optional creator identity for audit")
+    },
+    async ({ trackId, workRequestId, title, description, size, createdBy }) => {
+      const wo = await client.createWorkOrder({
+        trackId,
+        workRequestId,
+        title,
+        ...description !== void 0 && { description },
+        ...size !== void 0 && { size },
+        ...createdBy !== void 0 && { createdBy }
+      });
+      return {
+        content: [{ type: "text", text: `Created work order: ${formatOrderLine(wo)}` }]
+      };
+    }
+  );
+  server.tool(
+    "update_work_order",
+    "Update content fields on a Work Order (title, description, size). To move it between Tracks use move_work_order; to change its status use transition_work_order_status. The Work Request it came from cannot be changed \u2014 that lineage is immutable.",
+    {
+      workOrderId: external_exports.string().describe("The Work Order ID"),
+      title: external_exports.string().min(1).max(300).optional().describe("New title"),
+      description: external_exports.string().max(1e4).nullable().optional().describe("New description. Pass null to clear; omit to leave untouched."),
+      size: external_exports.enum(WORK_ORDER_SIZE_ENUM).nullable().optional().describe("New t-shirt size. Pass null to return it to unsized; omit to leave untouched.")
+    },
+    async ({ workOrderId, title, description, size }) => {
+      if (title === void 0 && description === void 0 && size === void 0) {
+        return {
+          content: [
+            { type: "text", text: "Nothing to update: pass at least one of title, description, or size." }
+          ],
+          isError: true
+        };
+      }
+      const wo = await client.updateWorkOrder(workOrderId, {
+        ...title !== void 0 && { title },
+        ...description !== void 0 && { description },
+        ...size !== void 0 && { size }
+      });
+      if (!wo) {
+        return { content: [{ type: "text", text: `Work order not found: ${workOrderId}` }] };
+      }
+      return { content: [{ type: "text", text: `Updated work order: ${formatOrderLine(wo)}` }] };
+    }
+  );
+  server.tool(
+    "move_work_order",
+    "Move a Work Order to a different Track \u2014 the reversal path for a bad early split guess. The destination must belong to the same teamspace and Account as the order's Work Request; the service refuses a placement that crosses either boundary.",
+    {
+      workOrderId: external_exports.string().describe("The Work Order ID"),
+      newTrackId: external_exports.string().describe("The destination Track (DeliverableGroup) ID")
+    },
+    async ({ workOrderId, newTrackId }) => {
+      const wo = await client.moveWorkOrder(workOrderId, newTrackId);
+      if (!wo) {
+        return { content: [{ type: "text", text: `Work order not found: ${workOrderId}` }] };
+      }
+      return {
+        content: [{ type: "text", text: `Moved work order to Track ${wo.trackId}: ${formatOrderLine(wo)}` }]
+      };
+    }
+  );
+  server.tool(
+    "transition_work_order_status",
+    "Move a Work Order through the intake gate: requested \u2192 accepted is the coherence gate itself, and there is no shortcut past it. Routing an order to needs_decision REQUIRES a reason, because the reason is the routing: out_of_scope goes back to the customer, exceeds_capacity goes to the Orchestrator, incoherent_with_decision goes back for reframing. A routed order returns to requested once resolved.",
+    {
+      workOrderId: external_exports.string().describe("The Work Order ID"),
+      status: external_exports.enum(WORK_INTAKE_STATUS_ENUM).describe("Target status"),
+      reason: external_exports.enum(NEEDS_DECISION_REASON_ENUM).optional().describe("Required when \u2014 and only when \u2014 status is needs_decision. The reason IS the routing.")
+    },
+    async ({ workOrderId, status, reason }) => {
+      if (status === "needs_decision" && reason === void 0) {
+        return {
+          content: [
+            {
+              type: "text",
+              text: "Routing an order to needs_decision requires a reason \u2014 the reason is the routing. Pass one of: out_of_scope, exceeds_capacity, incoherent_with_decision."
+            }
+          ],
+          isError: true
+        };
+      }
+      if (status !== "needs_decision" && reason !== void 0) {
+        return {
+          content: [
+            {
+              type: "text",
+              text: `A routing reason is only meaningful on a transition to needs_decision, not to ${status}.`
+            }
+          ],
+          isError: true
+        };
+      }
+      const wo = await client.transitionWorkOrderStatus(workOrderId, status, reason);
+      if (!wo) {
+        return { content: [{ type: "text", text: `Work order not found: ${workOrderId}` }] };
+      }
+      return {
+        content: [{ type: "text", text: `Transitioned work order: ${formatOrderLine(wo)}` }]
+      };
+    }
+  );
+}
+
+// ../../libs/harmonica-services/src/mcp/tools/work-request-tools.ts
+var WORK_REQUEST_ORIGIN_ENUM = [
+  "client",
+  "internal"
+];
+function oneLine2(value) {
+  return value.replace(/[\r\n]+/g, " ");
+}
+function formatSizeComposition(size) {
+  const parts = size.entries.map((e) => `${e.count}${e.size}`);
+  if (size.unsized > 0) parts.push(`${size.unsized} unsized`);
+  if (parts.length === 0) return "no orders yet";
+  return `${parts.join(" + ")} (${size.totalValueUnits} value units)`;
+}
+function registerWorkRequestTools(server, _ctx, client) {
+  server.tool(
+    "list_movement_work_requests",
+    `List the Work Requests filed against a Movement. A Work Request is the customer's ask in their own language, before it is sized or agreed. Recognition cues: "what has the client asked for", "list the requests on this engagement" \u2192 list_movement_work_requests.`,
+    {
+      movementId: external_exports.string().describe("The Movement (engagement) ID")
+    },
+    async ({ movementId }) => {
+      const requests = await client.listMovementWorkRequests(movementId);
+      const text = requests.length === 0 ? "No work requests found." : requests.map((wr) => `[${wr.workRequestId}] ${oneLine2(wr.title)} \u2014 from ${oneLine2(wr.requester.name)} (${wr.origin})`).join("\n");
+      return { content: [{ type: "text", text }] };
+    }
+  );
+  server.tool(
+    "get_work_request",
+    "Get a Work Request with the Work Orders it split into and their combined size composition. Note there is no request-level status: each Order carries its own, because a split whose halves sit in different states cannot be reduced to one word.",
+    {
+      workRequestId: external_exports.string().describe("The Work Request ID (e.g., wr-abc123)")
+    },
+    async ({ workRequestId }) => {
+      const detail = await client.getWorkRequestDetail(workRequestId);
+      if (!detail) {
+        return { content: [{ type: "text", text: `Work request not found: ${workRequestId}` }] };
+      }
+      const { workRequest: wr, orders, size } = detail;
+      const orderLines = orders.length === 0 ? ["Orders: none yet \u2014 this request has not been split"] : [
+        "Orders:",
+        ...orders.map((o) => {
+          const track = o.trackTitle ? `${oneLine2(o.trackTitle)} (${o.trackId})` : o.trackId;
+          const reason = o.needsDecisionReason ? ` [${o.needsDecisionReason}]` : "";
+          const sized = o.size ?? "unsized";
+          return `  [${o.workOrderId}] ${oneLine2(o.title)} \u2014 ${o.status}${reason}, ${sized}, on ${track}`;
+        })
+      ];
+      const lines = [
+        `ID: ${wr.workRequestId}`,
+        `Title: ${oneLine2(wr.title)}`,
+        `Movement: ${wr.movementId}`,
+        `Requester: ${oneLine2(wr.requester.name)} <${wr.requester.email}>`,
+        `Origin: ${wr.origin}`,
+        wr.body ? `Ask: ${oneLine2(wr.body)}` : null,
+        `Size: ${formatSizeComposition(size)}`,
+        ...orderLines,
+        wr.createdBy ? `Created By: ${wr.createdBy}` : null,
+        `Created: ${wr.createdAt}`,
+        `Updated: ${wr.updatedAt}`
+      ].filter(Boolean).join("\n");
+      return { content: [{ type: "text", text: lines }] };
+    }
+  );
+  server.tool(
+    "create_work_request",
+    "File a Work Request against a Movement \u2014 how work arrives, in the requester's own language, before it is sized or agreed. Splitting it into Work Orders is a separate step (create_work_order).",
+    {
+      movementId: external_exports.string().describe("The Movement (engagement) this request is filed against"),
+      title: external_exports.string().min(1).max(300).describe("Short title for the ask"),
+      body: external_exports.string().max(1e4).optional().describe("The ask as written, in the requester's own words"),
+      requesterName: external_exports.string().min(1).describe("Who is asking \u2014 display name"),
+      requesterEmail: external_exports.string().email().describe("Who is asking \u2014 email"),
+      origin: external_exports.enum(WORK_REQUEST_ORIGIN_ENUM).describe('Where the ask came from: "client" or "internal". One entity covers both \u2014 only the entry point differs.'),
+      createdBy: external_exports.string().optional().describe("Optional creator identity for audit")
+    },
+    async ({ movementId, title, body, requesterName, requesterEmail, origin, createdBy }) => {
+      const wr = await client.createWorkRequest({
+        movementId,
+        title,
+        ...body !== void 0 && { body },
+        requester: { name: requesterName, email: requesterEmail },
+        origin,
+        ...createdBy !== void 0 && { createdBy }
+      });
+      return {
+        content: [
+          {
+            type: "text",
+            text: `Filed work request: [${wr.workRequestId}] ${wr.title} \u2014 from ${wr.requester.name} (${wr.origin})`
+          }
+        ]
+      };
+    }
+  );
+  server.tool(
+    "update_work_request",
+    "Reword a Work Request (title, body, requester). A Request cannot be moved to another Movement, and has no status to set \u2014 its Orders carry the state.",
+    {
+      workRequestId: external_exports.string().describe("The Work Request ID"),
+      title: external_exports.string().min(1).max(300).optional().describe("New title"),
+      body: external_exports.string().max(1e4).nullable().optional().describe("The ask as written. Pass null to clear; omit to leave untouched."),
+      requesterName: external_exports.string().min(1).optional().describe("New requester display name (requires requesterEmail too)"),
+      requesterEmail: external_exports.string().email().optional().describe("New requester email (requires requesterName too)")
+    },
+    async ({ workRequestId, title, body, requesterName, requesterEmail }) => {
+      if (requesterName === void 0 !== (requesterEmail === void 0)) {
+        return {
+          content: [
+            {
+              type: "text",
+              text: "Changing the requester requires both requesterName and requesterEmail."
+            }
+          ],
+          isError: true
+        };
+      }
+      if (title === void 0 && body === void 0 && requesterName === void 0) {
+        return {
+          content: [
+            { type: "text", text: "Nothing to update: pass at least one of title, body, or requester." }
+          ],
+          isError: true
+        };
+      }
+      const wr = await client.updateWorkRequest(workRequestId, {
+        ...title !== void 0 && { title },
+        ...body !== void 0 && { body },
+        ...requesterName !== void 0 && requesterEmail !== void 0 && { requester: { name: requesterName, email: requesterEmail } }
+      });
+      if (!wr) {
+        return { content: [{ type: "text", text: `Work request not found: ${workRequestId}` }] };
+      }
+      return {
+        content: [{ type: "text", text: `Updated work request: [${wr.workRequestId}] ${wr.title}` }]
+      };
+    }
+  );
+}
+
 // ../../libs/harmonica-services/src/mcp/tools/workflow-tools.ts
 var TASK_STATUSES = ["pending", "running", "completed", "failed"];
 function registerWorkflowTools(server, ctx, client) {
@@ -31622,7 +32086,7 @@ ${JSON.stringify(task.result, null, 2)}
       limit: external_exports.coerce.number().optional().default(20).describe("Max number of jobs to return")
     },
     async ({ systemId, status, limit }) => {
-      await assertProjectInOrg(client, systemId, ctx.orgId);
+      await assertSystemInOrg(client, systemId, ctx.orgId);
       const tasks = await client.listSystemTasks(systemId, {
         status,
         limit
@@ -31680,7 +32144,7 @@ ${JSON.stringify(task.result, null, 2)}
       limit: external_exports.coerce.number().optional().default(20).describe("Max number of jobs to return")
     },
     async ({ systemId, status, limit }) => {
-      await assertProjectInOrg(client, systemId, ctx.orgId);
+      await assertSystemInOrg(client, systemId, ctx.orgId);
       const tasks = await client.listSystemTasks(systemId, {
         status,
         limit
@@ -31704,7 +32168,7 @@ ${JSON.stringify(task.result, null, 2)}
     },
     async ({ systemId, beatId }) => {
       try {
-        await assertProjectInOrg(client, systemId, ctx.orgId);
+        await assertSystemInOrg(client, systemId, ctx.orgId);
         const task = await client.draftCoda(systemId, beatId);
         return {
           content: [{
@@ -31737,7 +32201,7 @@ ${JSON.stringify(task.result, null, 2)}
     },
     async ({ systemId, noteIds }) => {
       try {
-        await assertProjectInOrg(client, systemId, ctx.orgId);
+        await assertSystemInOrg(client, systemId, ctx.orgId);
         const task = await client.validateAssumptions(systemId, noteIds);
         return {
           content: [{
@@ -31772,7 +32236,7 @@ ${JSON.stringify(task.result, null, 2)}
     },
     async ({ systemId, message, revisionId }) => {
       try {
-        await assertProjectInOrg(client, systemId, ctx.orgId);
+        await assertSystemInOrg(client, systemId, ctx.orgId);
         const task = await client.startSession(
           systemId,
           message,
@@ -31809,7 +32273,7 @@ ${JSON.stringify(task.result, null, 2)}
     },
     async ({ systemId, revisionIds }) => {
       try {
-        await assertProjectInOrg(client, systemId, ctx.orgId);
+        await assertSystemInOrg(client, systemId, ctx.orgId);
         const task = await client.planRevisionBatch(systemId, revisionIds);
         return {
           content: [{
@@ -31841,7 +32305,7 @@ ${JSON.stringify(task.result, null, 2)}
     },
     async ({ systemId }) => {
       try {
-        await assertProjectInOrg(client, systemId, ctx.orgId);
+        await assertSystemInOrg(client, systemId, ctx.orgId);
         const task = await client.runTriage(systemId);
         return {
           content: [{
@@ -31887,7 +32351,7 @@ ${JSON.stringify(task.result, null, 2)}
     },
     async ({ systemId, content, filename, encoding }) => {
       try {
-        await assertProjectInOrg(client, systemId, ctx.orgId);
+        await assertSystemInOrg(client, systemId, ctx.orgId);
         const result = encoding === "base64" ? await client.analyzeBinaryDocument(systemId, content, filename) : await client.analyzeDocument(systemId, content, filename);
         return {
           content: [{
@@ -31964,7 +32428,7 @@ var TOOL_PROFILES = Object.freeze({
     registerTeamspaceTools,
     registerMembershipTools,
     registerSystemTools,
-    registerProjectLifecycleTools,
+    registerSystemLifecycleTools,
     allow(registerBeatVersionTools, ["relocate_beat_version"])
   ]),
   "onboarding": Object.freeze([
@@ -32002,7 +32466,7 @@ function registerAllTools(server, ctx, client, profile) {
     return;
   }
   registerSystemTools(server, ctx, client);
-  registerProjectLifecycleTools(server, ctx, client);
+  registerSystemLifecycleTools(server, ctx, client);
   registerMembershipTools(server, ctx, client);
   registerBeatTools(server, ctx, client);
   registerBeatConvergenceTools(server, ctx, client);
@@ -32043,6 +32507,8 @@ function registerAllTools(server, ctx, client, profile) {
   registerAccountTools(server, ctx, client);
   registerMovementTools(server, ctx, client);
   registerWorkItemTools(server, ctx, client);
+  registerWorkRequestTools(server, ctx, client);
+  registerWorkOrderTools(server, ctx, client);
   registerBarTools(server, ctx, client);
   registerCadenceScheduleTools(server, ctx, client);
   registerPulseReportTools(server, ctx, client);
@@ -32323,7 +32789,7 @@ function createHttpClient(config2) {
         return { error: String(err) };
       }
     },
-    transferProject: async (sourceOrgId, projectId, targetOrgId) => {
+    transferSystem: async (sourceOrgId, projectId, targetOrgId) => {
       try {
         const result = await request(
           "POST",
@@ -33451,7 +33917,7 @@ function createHttpClient(config2) {
       return importResult;
     },
     // Embedding similarity
-    embedProjectEntities: (projectId) => request("POST", `/api/systems/${encodeURIComponent(projectId)}/embeddings/generate`),
+    embedSystemEntities: (projectId) => request("POST", `/api/systems/${encodeURIComponent(projectId)}/embeddings/generate`),
     findSimilarNotes: async (noteId, projectId, options) => {
       const qs = buildSimilarityQS(options);
       const res = await request("GET", `/api/systems/${encodeURIComponent(projectId)}/notes/${encodeURIComponent(noteId)}/similar${qs}`);
@@ -33695,7 +34161,7 @@ function createHttpClient(config2) {
     },
     // WorkItems (WorkItem exposure layer — owned, statused unit of operational work under a Track)
     createWorkItem: async (input) => {
-      const { trackId, title, owner, committedEstimateHours, effortSize, valueUnits, costPerValueUnit, createdBy, beatVersionId } = input;
+      const { trackId, title, owner, committedEstimateHours, effortSize, valueUnits, costPerValueUnit, createdBy, beatVersionId, workOrderId } = input;
       const body = {
         title,
         ...owner !== void 0 && { owner },
@@ -33704,7 +34170,8 @@ function createHttpClient(config2) {
         ...valueUnits !== void 0 && { valueUnits },
         ...costPerValueUnit !== void 0 && { costPerValueUnit },
         ...createdBy !== void 0 && { createdBy },
-        ...beatVersionId !== void 0 && { beatVersionId }
+        ...beatVersionId !== void 0 && { beatVersionId },
+        ...workOrderId !== void 0 && { workOrderId }
       };
       const res = await request(
         "POST",
@@ -33766,6 +34233,134 @@ function createHttpClient(config2) {
       if (!parsed.success) throw new Error(`Unexpected WorkItem shape from API: ${parsed.error.message}`);
       return parsed.data;
     },
+    // Work intake (B-331) — against the endpoints the API layer shipped in v3.
+    createWorkRequest: async (input) => {
+      const { movementId, title, body: askBody, requester, origin, createdBy } = input;
+      const body = {
+        title,
+        ...askBody !== void 0 && { body: askBody },
+        requester,
+        origin,
+        ...createdBy !== void 0 && { createdBy }
+      };
+      const res = await request(
+        "POST",
+        `/api/movements/${encodeURIComponent(movementId)}/work-requests`,
+        body
+      );
+      if (res === void 0) throw new Error(`Movement ${movementId} not found`);
+      const parsed = WorkRequestApiSchema.safeParse(res.workRequest);
+      if (!parsed.success) throw new Error(`Unexpected WorkRequest shape from API: ${parsed.error.message}`);
+      return parsed.data;
+    },
+    getWorkRequest: async (workRequestId) => {
+      const res = await request(
+        "GET",
+        `/api/work-requests/${encodeURIComponent(workRequestId)}`
+      );
+      if (res === void 0) return void 0;
+      const parsed = WorkRequestApiSchema.safeParse(res.workRequest);
+      if (!parsed.success) throw new Error(`Unexpected WorkRequest shape from API: ${parsed.error.message}`);
+      return parsed.data;
+    },
+    getWorkRequestDetail: async (workRequestId) => {
+      const res = await request("GET", `/api/work-requests/${encodeURIComponent(workRequestId)}`);
+      if (res === void 0) return void 0;
+      const parsed = WorkRequestDetailResponseSchema.safeParse(res);
+      if (!parsed.success) throw new Error(`Unexpected WorkRequest detail shape from API: ${parsed.error.message}`);
+      return parsed.data;
+    },
+    updateWorkRequest: async (workRequestId, updates) => {
+      const res = await request(
+        "PATCH",
+        `/api/work-requests/${encodeURIComponent(workRequestId)}`,
+        updates
+      );
+      if (res === void 0) return void 0;
+      const parsed = WorkRequestApiSchema.safeParse(res.workRequest);
+      if (!parsed.success) throw new Error(`Unexpected WorkRequest shape from API: ${parsed.error.message}`);
+      return parsed.data;
+    },
+    listMovementWorkRequests: async (movementId) => {
+      const res = await request("GET", `/api/movements/${encodeURIComponent(movementId)}/work-requests`);
+      if (res === void 0) throw new Error(`Movement ${movementId} not found`);
+      const parsed = WorkRequestsResponseSchema.safeParse(res);
+      if (!parsed.success) throw new Error(`Unexpected work requests list shape from API: ${parsed.error.message}`);
+      return parsed.data.workRequests;
+    },
+    createWorkOrder: async (input) => {
+      const { trackId, workRequestId, title, description, size, createdBy } = input;
+      const body = {
+        workRequestId,
+        title,
+        ...description !== void 0 && { description },
+        ...size !== void 0 && { size },
+        ...createdBy !== void 0 && { createdBy }
+      };
+      const res = await request(
+        "POST",
+        `/api/deliverable-groups/${encodeURIComponent(trackId)}/work-orders`,
+        body
+      );
+      if (res === void 0) throw new Error(`Track ${trackId} not found`);
+      const parsed = WorkOrderApiSchema.safeParse(res.workOrder);
+      if (!parsed.success) throw new Error(`Unexpected WorkOrder shape from API: ${parsed.error.message}`);
+      return parsed.data;
+    },
+    getWorkOrder: async (workOrderId) => {
+      const res = await request("GET", `/api/work-orders/${encodeURIComponent(workOrderId)}`);
+      if (res === void 0) return void 0;
+      const parsed = WorkOrderApiSchema.safeParse(res.workOrder);
+      if (!parsed.success) throw new Error(`Unexpected WorkOrder shape from API: ${parsed.error.message}`);
+      return parsed.data;
+    },
+    updateWorkOrder: async (workOrderId, updates) => {
+      const res = await request(
+        "PATCH",
+        `/api/work-orders/${encodeURIComponent(workOrderId)}`,
+        updates
+      );
+      if (res === void 0) return void 0;
+      const parsed = WorkOrderApiSchema.safeParse(res.workOrder);
+      if (!parsed.success) throw new Error(`Unexpected WorkOrder shape from API: ${parsed.error.message}`);
+      return parsed.data;
+    },
+    listTrackWorkOrders: async (trackId) => {
+      const res = await request("GET", `/api/deliverable-groups/${encodeURIComponent(trackId)}/work-orders`);
+      if (res === void 0) throw new Error(`Track ${trackId} not found`);
+      const parsed = WorkOrdersResponseSchema.safeParse(res);
+      if (!parsed.success) throw new Error(`Unexpected work orders list shape from API: ${parsed.error.message}`);
+      return parsed.data.workOrders;
+    },
+    listWorkRequestWorkOrders: async (workRequestId) => {
+      const res = await request("GET", `/api/work-requests/${encodeURIComponent(workRequestId)}/work-orders`);
+      if (res === void 0) throw new Error(`Work request ${workRequestId} not found`);
+      const parsed = WorkOrdersResponseSchema.safeParse(res);
+      if (!parsed.success) throw new Error(`Unexpected work orders list shape from API: ${parsed.error.message}`);
+      return parsed.data.workOrders;
+    },
+    moveWorkOrder: async (workOrderId, newTrackId) => {
+      const res = await request(
+        "POST",
+        `/api/work-orders/${encodeURIComponent(workOrderId)}/move`,
+        { newTrackId }
+      );
+      if (res === void 0) return void 0;
+      const parsed = WorkOrderApiSchema.safeParse(res.workOrder);
+      if (!parsed.success) throw new Error(`Unexpected WorkOrder shape from API: ${parsed.error.message}`);
+      return parsed.data;
+    },
+    transitionWorkOrderStatus: async (workOrderId, toStatus, reason) => {
+      const res = await request(
+        "POST",
+        `/api/work-orders/${encodeURIComponent(workOrderId)}/status`,
+        { status: toStatus, ...reason !== void 0 && { reason } }
+      );
+      if (res === void 0) return void 0;
+      const parsed = WorkOrderApiSchema.safeParse(res.workOrder);
+      if (!parsed.success) throw new Error(`Unexpected WorkOrder shape from API: ${parsed.error.message}`);
+      return parsed.data;
+    },
     // Accounts (B-242 / org-scoped paying client entity that owns Movements)
     createAccount: async (input) => {
       const { orgId, name, description, createdBy, parentAccountId, accountType, accountCode } = input;
@@ -34317,7 +34912,7 @@ function loadConfig() {
   };
 }
 async function main() {
-  console.error(`[harmonica-mcp] v${"3.8.6"} starting\u2026`);
+  console.error(`[harmonica-mcp] v${"3.9.1"} starting\u2026`);
   const config2 = loadConfig();
   const client = createHttpClient({
     apiBaseUrl: config2.apiBaseUrl,