@codazen/harmonica-mcp 3.8.6 → 3.9.0

package/dist/index.js

@@ -21545,11 +21545,11 @@ async function validateAuth(client, orgIdentifier, isOrgSlug, userId) {
 async function assertProjectInOrg(client, systemId, orgId) {
   const project = await client.getSystem(systemId);
   if (!project) {
-    throw new Error(`Project not found: "${systemId}"`);
+    throw new Error(`System not found: "${systemId}"`);
   }
   if (project.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.`
     );
   }
 }
@@ -21560,7 +21560,7 @@ async function assertRevisionInProject(client, revisionId, systemId) {
   }
   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.`
     );
   }
 }
@@ -21578,11 +21578,11 @@ 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}"`);
+    throw new Error(`System not found: "${systemId}"`);
   }
   if (project.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.`
     );
   }
   return project;
@@ -22853,7 +22853,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";
@@ -23927,7 +23927,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 +23950,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);
@@ -24690,7 +24690,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")'),
@@ -26336,11 +26336,18 @@ 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, projectId: 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 };
   },
@@ -26373,34 +26380,39 @@ 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(),
+    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.preprocess(normalizeSystemId, external_exports.object({
   noteId: external_exports.string(),
   noteType: NoteTypeSchema,
   status: NoteStatusSchema,
   content: external_exports.string(),
+  systemId: external_exports.string().nullish(),
   projectId: external_exports.string().nullish(),
   beatId: external_exports.string().nullish(),
   revisionId: external_exports.string().nullish(),
@@ -26412,18 +26424,22 @@ 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(),
+    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()
+);
 var BeatsResponseSchema = external_exports.object({
   beats: external_exports.array(BeatApiSchema),
   total: external_exports.number().optional(),
@@ -26608,37 +26624,45 @@ 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().optional(),
+    projectId: external_exports.string().optional(),
+    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().optional(),
+    projectId: external_exports.string().optional(),
+    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 +26707,25 @@ 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(),
+    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 ActivitiesResponseSchema = external_exports.object({
   activities: external_exports.array(ActivitySchema),
   hasMore: external_exports.boolean(),
@@ -26725,26 +26753,30 @@ 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(),
+    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 TriageActionsResponseSchema = external_exports.object({
   actions: external_exports.array(TriageActionSchema)
 }).passthrough();
@@ -26761,15 +26793,16 @@ 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(),
+  systemId: external_exports.string().optional(),
   projectId: 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()
@@ -26805,34 +26838,50 @@ var LandscapeMetaSchema = external_exports.object({
   cacheHit: external_exports.boolean(),
   projectionHash: external_exports.string()
 }).passthrough();
-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(),
-  meta: LandscapeMetaSchema
-}).passthrough();
+var LandscapeResponseSchema = external_exports.preprocess(
+  (raw) => {
+    if (typeof raw !== "object" || raw === null) return raw;
+    const r = raw;
+    const sb = r["scopeBoundary"];
+    if (typeof sb === "object" && sb !== null) {
+      const s = sb;
+      const id = s["systemId"] || s["projectId"];
+      if (id) return { ...r, scopeBoundary: { ...s, systemId: id, projectId: id } };
+    }
+    return r;
+  },
+  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({
+      systemId: external_exports.string().optional(),
+      projectId: external_exports.string().optional(),
+      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(),
+  systemId: external_exports.string().optional(),
   projectId: 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(),
+  systemId: external_exports.string().optional(),
   projectId: external_exports.string().optional(),
   teamspaceId: external_exports.string().optional(),
   userId: external_exports.string(),
@@ -26846,7 +26895,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(),
@@ -26963,6 +27012,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,7 +27135,7 @@ 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 };
   },
@@ -27058,10 +27194,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(),
+  systemId: external_exports.string().nullish(),
   projectId: external_exports.string().nullish(),
   movementId: external_exports.string().nullish(),
   orgId: external_exports.string(),
@@ -27079,7 +27216,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 +27233,34 @@ 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().optional(),
+    projectId: external_exports.string().optional(),
+    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(), projectId: external_exports.string() })
+  )
 ]);
 var RevisionClaimSchema = external_exports.object({
   claimId: external_exports.string(),
@@ -27127,33 +27271,41 @@ 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().optional(),
+    projectId: external_exports.string().optional(),
+    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().optional(),
+    projectId: external_exports.string().optional(),
+    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 +27545,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 +27557,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 }) => {
@@ -27463,7 +27615,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 +27623,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 +27636,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;
@@ -27570,7 +27722,7 @@ function registerNoteTools(server, ctx, client) {
       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 }] };
     }
@@ -27619,8 +27771,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)"),
@@ -27725,7 +27877,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)"),
@@ -28660,7 +28812,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 +28820,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 +28862,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") }] };
         }
@@ -31579,6 +31731,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) {
@@ -32043,6 +32526,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);
@@ -33766,6 +34251,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 +34930,7 @@ function loadConfig() {
   };
 }
 async function main() {
-  console.error(`[harmonica-mcp] v${"3.8.6"} starting\u2026`);
+  console.error(`[harmonica-mcp] v${"3.9.0"} starting\u2026`);
   const config2 = loadConfig();
   const client = createHttpClient({
     apiBaseUrl: config2.apiBaseUrl,

package/package.json

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