@codazen/harmonica-mcp 3.9.0 → 3.9.2

package/dist/index.js

@@ -21542,18 +21542,18 @@ 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) {
+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(
       `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}"`);
@@ -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(`System not found: "${systemId}"`);
-  }
-  if (project.orgId !== orgId) {
-    throw new Error(
-      `System "${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.`,
@@ -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) {
@@ -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 };
@@ -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) {
@@ -26341,7 +26329,17 @@ var normalizeSystemId = (raw) => {
   const b = raw;
   const id = b["systemId"] || b["projectId"];
   if (!id) return raw;
-  return { ...b, systemId: id, projectId: id };
+  return { ...b, systemId: id };
+};
+var normalizeSystemIdAndTitle = (raw) => {
+  if (typeof raw !== "object" || raw === null || Array.isArray(raw)) return raw;
+  const b = raw;
+  const id = b["systemId"] || b["projectId"];
+  const title = b["systemTitle"] || b["projectTitle"];
+  const result = { ...b };
+  if (id) result["systemId"] = id;
+  if (title) result["systemTitle"] = title;
+  return result;
 };
 var BeatApiSchema = external_exports.preprocess(
   (raw) => {
@@ -26349,12 +26347,11 @@ var BeatApiSchema = external_exports.preprocess(
     const b = raw;
     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(),
@@ -26386,7 +26383,6 @@ var RevisionApiSchema = external_exports.preprocess(
     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(),
@@ -26413,7 +26409,6 @@ var NoteApiSchema = external_exports.preprocess(normalizeSystemId, external_expo
   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(),
   rationale: external_exports.string().nullish(),
@@ -26429,7 +26424,6 @@ 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(),
@@ -26631,8 +26625,7 @@ var CheckApiSchema = external_exports.preprocess(
     checkType: CheckTypeSchema,
     targetType: CheckTargetTypeSchema,
     targetId: external_exports.string(),
-    systemId: external_exports.string().optional(),
-    projectId: external_exports.string().optional(),
+    systemId: external_exports.string(),
     overallScore: external_exports.number(),
     dimensions: external_exports.array(CheckDimensionScoreSchema),
     summary: external_exports.string(),
@@ -26651,8 +26644,7 @@ var SystemCheckApiSchema = external_exports.preprocess(
     checkType: CheckTypeSchema,
     targetType: CheckTargetTypeSchema,
     targetId: external_exports.string(),
-    systemId: external_exports.string().optional(),
-    projectId: external_exports.string().optional(),
+    systemId: external_exports.string(),
     overallScore: external_exports.number(),
     summary: external_exports.string(),
     triggeredBy: external_exports.string().optional(),
@@ -26712,7 +26704,6 @@ var ActivitySchema = external_exports.preprocess(
   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(),
@@ -26758,7 +26749,6 @@ var TriageActionSchema = external_exports.preprocess(
   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(),
@@ -26799,7 +26789,6 @@ var SearchResultSchema = external_exports.preprocess(normalizeSystemId, external
   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());
@@ -26838,33 +26827,28 @@ var LandscapeMetaSchema = external_exports.object({
   cacheHit: external_exports.boolean(),
   projectionHash: external_exports.string()
 }).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(),
+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.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()
-);
+    }).passthrough()
+  ).optional(),
+  meta: LandscapeMetaSchema
+}).passthrough();
 var ClusterDescriptionSchema = external_exports.object({
   title: external_exports.string(),
   description: external_exports.string()
@@ -26873,7 +26857,6 @@ var BeatVersionItemSchema = external_exports.preprocess(normalizeSystemId, exter
   beatVersionId: external_exports.string(),
   beatId: external_exports.string(),
   systemId: external_exports.string().optional(),
-  projectId: external_exports.string().optional(),
   status: external_exports.string()
 }).passthrough());
 var BeatVersionsResponseSchema = external_exports.object({
@@ -26882,7 +26865,6 @@ var BeatVersionsResponseSchema = external_exports.object({
 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(),
   conversationType: external_exports.string(),
@@ -27001,6 +26983,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(),
@@ -27137,12 +27126,11 @@ var LayerApiSchema = external_exports.preprocess(
     const l = raw;
     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(),
@@ -27199,7 +27187,6 @@ var DeliverableGroupApiSchema = external_exports.preprocess(normalizeSystemId, e
   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(),
   title: external_exports.string(),
@@ -27238,8 +27225,7 @@ var WorkPlanBeatVersionApiSchema = external_exports.preprocess(
   external_exports.object({
     beatVersionId: external_exports.string(),
     beatId: external_exports.string(),
-    systemId: external_exports.string().optional(),
-    projectId: external_exports.string().optional(),
+    systemId: external_exports.string(),
     versionNumber: external_exports.number(),
     title: external_exports.string(),
     status: BeatVersionStatusSchema,
@@ -27259,7 +27245,7 @@ var RevisionClaimActorSchema = external_exports.union([
   external_exports.object({ kind: external_exports.literal("user"), userId: 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() })
+    external_exports.object({ kind: external_exports.literal("agent"), agentId: external_exports.string(), systemId: external_exports.string() })
   )
 ]);
 var RevisionClaimSchema = external_exports.object({
@@ -27272,16 +27258,15 @@ var RevisionClaimsResponseSchema = external_exports.object({
   claims: external_exports.array(RevisionClaimSchema)
 }).passthrough();
 var ProposedRevisionSchema = external_exports.preprocess(
-  normalizeSystemId,
+  normalizeSystemIdAndTitle,
   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()
+    systemId: external_exports.string(),
+    systemTitle: external_exports.string().optional()
   }).passthrough()
 );
 var ReleaseIntervalSchema = external_exports.object({
@@ -27290,16 +27275,15 @@ var ReleaseIntervalSchema = external_exports.object({
   isFallback: external_exports.boolean()
 }).passthrough();
 var EligibleBeatVersionForDropSchema = external_exports.preprocess(
-  normalizeSystemId,
+  normalizeSystemIdAndTitle,
   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(),
+    systemId: external_exports.string(),
+    systemTitle: 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(),
@@ -27572,7 +27556,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 };
@@ -27653,7 +27637,7 @@ function registerNoteTools(server, ctx, client) {
   );
   server.tool(
     "list_org_notes",
-    "List Notes at the organization level (cross-cutting constraints, org-wide decisions, and context that applies to all projects). Filterable by type and status. Use offset/limit to paginate.",
+    "List Notes at the organization level (cross-cutting constraints, org-wide decisions, and context that applies to all systems). Filterable by type and status. Use offset/limit to paginate.",
     {
       noteType: external_exports.enum(NOTE_TYPE_VALUES).optional().describe("Filter by note type"),
       status: external_exports.enum(NOTE_STATUS_VALUES).optional().describe("Filter by status"),
@@ -27679,7 +27663,7 @@ function registerNoteTools(server, ctx, client) {
   );
   server.tool(
     "list_movement_notes",
-    "List Notes scoped directly to a Movement (commercial SOW container) \u2014 engagement-level knowledge such as SOW constraints, scope boundaries, and commercial decisions. Not aggregated from projects. Filterable by type and status.",
+    "List Notes scoped directly to a Movement (commercial SOW container) \u2014 engagement-level knowledge such as SOW constraints, scope boundaries, and commercial decisions. Not aggregated from systems. Filterable by type and status.",
     {
       movementId: external_exports.string().min(1).describe("The Movement ID"),
       noteType: external_exports.enum(NOTE_TYPE_VALUES).optional().describe("Filter by note type"),
@@ -27718,7 +27702,7 @@ 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);
@@ -27753,7 +27737,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 };
@@ -27792,7 +27776,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({
@@ -27920,7 +27904,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,
@@ -27962,7 +27946,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,
@@ -28001,7 +27985,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 };
@@ -28023,7 +28007,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 };
@@ -28050,7 +28034,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 };
@@ -28080,7 +28064,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." }] };
@@ -28783,7 +28767,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 {
@@ -28861,7 +28845,7 @@ Error: ${msg}`);
         } catch (err) {
           const msg = err instanceof Error ? err.message : String(err);
           lines.push(`
-Projects created: ${createdProjects.length}`);
+Systems created: ${createdProjects.length}`);
           lines.unshift(`\u26A0\uFE0F  Onboarding batch partially created \u2014 stopped at: system "${p.title}"
 Error: ${msg}`);
           return { content: [{ type: "text", text: lines.join("\n") }] };
@@ -28869,7 +28853,7 @@ Error: ${msg}`);
       }
       if (createdProjects.length > 0) {
         lines.push(`
-Projects (${createdProjects.length}):`);
+Systems (${createdProjects.length}):`);
         for (const p of createdProjects) lines.push(`  [${p.systemId}] ${p.title}`);
       }
       const createdNotes = [];
@@ -29084,7 +29068,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 };
       }
@@ -29235,7 +29219,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) {
@@ -29382,7 +29366,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 {
@@ -29419,7 +29403,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)) {
@@ -30172,8 +30156,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 {
@@ -30478,7 +30462,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://")) {
@@ -30726,7 +30710,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: [{
@@ -30790,7 +30774,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.",
@@ -30896,7 +30880,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, {
@@ -30940,7 +30924,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);
@@ -31118,10 +31102,10 @@ function registerTeamspaceTools(server, ctx, client) {
           `Created: ${ts.createdAt}`
         ];
         if (tsProjects.length > 0) {
-          lines.push("", `Projects (${tsProjects.length}):`);
+          lines.push("", `Systems (${tsProjects.length}):`);
           for (const p of tsProjects) lines.push(`  [${p.systemId}] ${p.title} \u2014 ${p.status ?? "unknown"}`);
         } else {
-          lines.push("Projects: (none)");
+          lines.push("Systems: (none)");
         }
         if (ts.ensemble && ts.ensemble.length > 0) {
           lines.push("", "Ensemble:");
@@ -31279,7 +31263,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)
@@ -31386,7 +31370,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 };
@@ -31569,6 +31553,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}`,
@@ -31579,7 +31564,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"),
@@ -31590,9 +31575,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." }],
@@ -31608,7 +31594,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: [
@@ -31622,7 +31609,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"),
@@ -31634,9 +31621,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 {
@@ -31650,7 +31638,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}` }],
@@ -31666,7 +31656,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 {
@@ -32105,7 +32096,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
@@ -32163,7 +32154,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
@@ -32187,7 +32178,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: [{
@@ -32220,7 +32211,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: [{
@@ -32255,7 +32246,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,
@@ -32292,7 +32283,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: [{
@@ -32324,7 +32315,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: [{
@@ -32370,7 +32361,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: [{
@@ -32447,7 +32438,7 @@ var TOOL_PROFILES = Object.freeze({
     registerTeamspaceTools,
     registerMembershipTools,
     registerSystemTools,
-    registerProjectLifecycleTools,
+    registerSystemLifecycleTools,
     allow(registerBeatVersionTools, ["relocate_beat_version"])
   ]),
   "onboarding": Object.freeze([
@@ -32485,7 +32476,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);
@@ -32808,7 +32799,7 @@ function createHttpClient(config2) {
         return { error: String(err) };
       }
     },
-    transferProject: async (sourceOrgId, projectId, targetOrgId) => {
+    transferSystem: async (sourceOrgId, projectId, targetOrgId) => {
       try {
         const result = await request(
           "POST",
@@ -33936,7 +33927,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}`);
@@ -34180,7 +34171,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 },
@@ -34189,7 +34180,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",
@@ -34930,7 +34922,7 @@ function loadConfig() {
   };
 }
 async function main() {
-  console.error(`[harmonica-mcp] v${"3.9.0"} starting\u2026`);
+  console.error(`[harmonica-mcp] v${"3.9.2"} starting\u2026`);
   const config2 = loadConfig();
   const client = createHttpClient({
     apiBaseUrl: config2.apiBaseUrl,

package/package.json

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