@codazen/harmonica-mcp 2.0.0 → 2.1.0

package/dist/index.js

@@ -22598,7 +22598,7 @@ ${beat.description}`);
   return sections.join("\n");
 }
 
-// ../../libs/harmonica-services/src/mcp/formatters/project-formatter.ts
+// ../../libs/harmonica-services/src/mcp/formatters/system-formatter.ts
 function formatProjectSummaryTable(projects) {
   if (projects.length === 0) return "_No projects found._";
   const header = "| Project ID | Title | Status |\n|------------|-------|--------|";
@@ -23018,7 +23018,7 @@ function registerBeatTools(server, ctx, client) {
     },
     async ({ projectId, offset = 0, limit = 100, includeArchived }) => {
       await assertProjectInOrg(client, projectId, ctx.orgId);
-      let beats = await client.listProjectBeats(projectId);
+      let beats = await client.listSystemBeats(projectId);
       if (!includeArchived) {
         beats = beats.filter((b) => b.beatStatus !== "archived");
       }
@@ -23803,7 +23803,7 @@ function registerCheckTools(server, ctx, client) {
           checks = await client.listBeatChecks(beatId, projectId, checkType);
           scope = `beat ${beatId}`;
         } else {
-          const result = await client.listProjectChecks(projectId, checkType, { limit: 200 });
+          const result = await client.listSystemChecks(projectId, checkType, { limit: 200 });
           checks = result.checks;
           scope = `project ${projectId}`;
         }
@@ -26759,6 +26759,14 @@ var MeasureApiSchema = external_exports.object({
 var MeasuresResponseSchema = external_exports.object({ measures: external_exports.array(MeasureApiSchema) }).passthrough();
 var MeasureResponseSchema = external_exports.object({ measure: MeasureApiSchema }).passthrough();
 var WorkItemStatusSchema = external_exports.enum(["not_started", "in_progress", "blocked", "done"]);
+var WORK_ITEM_EFFORT_SIZES = [
+  "XS",
+  "S",
+  "M",
+  "L",
+  "XL"
+];
+var WorkItemEffortSizeSchema = external_exports.enum(WORK_ITEM_EFFORT_SIZES);
 var HumanAssigneeApiSchema = external_exports.object({
   name: external_exports.string(),
   email: external_exports.string()
@@ -26769,10 +26777,16 @@ var WorkItemApiSchema = external_exports.object({
   teamspaceId: external_exports.string(),
   orgId: external_exports.string(),
   title: external_exports.string(),
-  owner: HumanAssigneeApiSchema,
+  /** Optional since N-4E09-6672 — a work item may be unowned. */
+  owner: HumanAssigneeApiSchema.optional(),
   status: WorkItemStatusSchema,
   committedEstimateHours: external_exports.number().optional(),
   actualHours: external_exports.number().optional(),
+  /** Delivery lens — rough t-shirt effort sizing (N-4E09-6672). */
+  effortSize: WorkItemEffortSizeSchema.optional(),
+  /** Commercial lens — deliberately unblended with `effortSize` (N-4E09-6672). */
+  valueUnits: external_exports.number().optional(),
+  costPerValueUnit: external_exports.number().optional(),
   /** Optional capability-lineage link to a Beat Version (v2, N-4E09-6574). */
   beatVersionId: external_exports.string().optional(),
   createdBy: external_exports.string().optional(),
@@ -28882,7 +28896,7 @@ function registerPortfolioCoherenceTools(server, ctx, client) {
             isError: true
           };
         }
-        const allProjectBeats = await client.listProjectBeats(projectId);
+        const allProjectBeats = await client.listSystemBeats(projectId);
         const beatMap = new Map(allProjectBeats.map((b) => [b.beatId, b]));
         const primaryBeat = beatMap.get(resolvedPrimaryId);
         if (!primaryBeat) {
@@ -28967,269 +28981,6 @@ function registerPortfolioCoherenceTools(server, ctx, client) {
   );
 }
 
-// ../../libs/harmonica-services/src/mcp/tools/project-lifecycle-tools.ts
-function registerProjectLifecycleTools(server, ctx, client) {
-  server.tool(
-    "transition_system_lifecycle",
-    "Advance a System's capability-maturity lifecycle state. Allowed transitions follow the state machine (Concept \u2192 Incubating \u2192 Piloting \u2192 Activated \u2192 Commercializing \u2192 Scaled, plus paused/killed/sunset/archived exits). The activated \u2192 commercializing edge requires a `decisionNoteId` pointing to a system-scoped Decision Note (the governance review). Other gates are advisory.",
-    {
-      systemId: external_exports.string().describe("The system ID"),
-      targetState: external_exports.enum([
-        "concept",
-        "incubating",
-        "piloting",
-        "activated",
-        "commercializing",
-        "scaled",
-        "paused",
-        "killed",
-        "sunset",
-        "archived"
-      ]).describe("Target lifecycle state. Active: concept, incubating, piloting, activated, commercializing, scaled. Exits: paused, killed, sunset, archived."),
-      reason: external_exports.string().optional().describe("Why this transition is being made (recorded in audit metadata)"),
-      decisionNoteId: external_exports.string().optional().describe("Note ID of the governance Decision Note. Required for the activated \u2192 commercializing transition; optional otherwise.")
-    },
-    async ({ systemId, targetState, reason, decisionNoteId }) => {
-      try {
-        const system = await client.getSystem(systemId);
-        if (!system) {
-          return { content: [{ type: "text", text: `System not found: "${systemId}"` }], isError: true };
-        }
-        if (system.orgId !== ctx.orgId) {
-          return { content: [{ type: "text", text: `System "${systemId}" is not in this organization` }], isError: true };
-        }
-        const result = await client.transitionProjectLifecycleState(systemId, targetState, {
-          actor: { type: "human", id: ctx.user.userId, name: ctx.user.name },
-          reason,
-          decisionNoteId
-        });
-        if (!result.success) {
-          const failedGates = result.error?.failedGates?.length ? ` (failed gates: ${result.error.failedGates.join(", ")})` : "";
-          return {
-            content: [{ type: "text", text: `Transition failed: ${result.error?.message ?? "Unknown error"}${failedGates}` }],
-            isError: true
-          };
-        }
-        const lines = [
-          `System lifecycle transitioned successfully.`,
-          "",
-          `**System:** ${systemId}`,
-          `**Title:** ${system.title}`,
-          `**Transition:** ${result.previousState} \u2192 ${result.newState}`
-        ];
-        if (reason) lines.push(`**Reason:** ${reason}`);
-        if (decisionNoteId) lines.push(`**Decision Note:** ${decisionNoteId}`);
-        return { content: [{ type: "text", text: lines.join("\n") }] };
-      } catch (err) {
-        const message = err instanceof Error ? err.message : String(err);
-        return { content: [{ type: "text", text: `Failed to transition system lifecycle: ${message}` }], isError: true };
-      }
-    }
-  );
-}
-
-// ../../libs/harmonica-services/src/mcp/tools/project-tools.ts
-var import_crypto5 = require("crypto");
-function accountLine(request, resolved) {
-  const requested = request["accountId"];
-  if (requested === null || requested === "") return "**Account:** (unlinked)";
-  return resolved ? `**Account:** ${resolved}` : "";
-}
-var PROJECT_EMBEDDING_FIELDS = ["title", "description", "strategy"];
-function registerProjectTools(server, ctx, client) {
-  const listSystemsHandler = async ({ teamspaceId }) => {
-    try {
-      const projects = await client.listOrgSystems(ctx.orgId);
-      const trimmed = teamspaceId?.trim();
-      const filtered = trimmed ? projects.filter((p) => p.teamspaceId === trimmed) : projects;
-      const text = formatProjectSummaryTable(filtered);
-      return { content: [{ type: "text", text }] };
-    } catch (err) {
-      const message = err instanceof Error ? err.message : String(err);
-      return { content: [{ type: "text", text: `Failed to list systems: ${message}` }], isError: true };
-    }
-  };
-  server.tool(
-    "list_systems",
-    "List all systems (projects) in the configured organization",
-    {
-      teamspaceId: external_exports.string().optional().describe("Filter to systems belonging to a specific teamspace. Empty or whitespace-only treated as no filter.")
-    },
-    listSystemsHandler
-  );
-  const getSystemContextSchema = {
-    systemId: external_exports.string().describe("The system ID"),
-    noteLimit: external_exports.number().int().min(1).max(MAX_CONTEXT_NOTE_LIMIT).optional().describe(
-      `Max Notes to include, prioritised by note type (default ${DEFAULT_CONTEXT_NOTE_LIMIT}, max ${MAX_CONTEXT_NOTE_LIMIT}). Use list_notes or search for the full set.`
-    )
-  };
-  const getSystemContextHandler = async ({
-    systemId,
-    noteLimit
-  }) => {
-    try {
-      const [project, org] = await Promise.all([
-        fetchProjectInOrg(client, systemId, ctx.orgId),
-        client.getOrg(ctx.orgId)
-      ]);
-      const notes = await client.listProjectNotes(systemId, {
-        limit: noteLimit ?? DEFAULT_CONTEXT_NOTE_LIMIT
-      });
-      const text = formatProjectContext(project, notes, org?.coda);
-      return { content: [{ type: "text", text }] };
-    } catch (err) {
-      const message = err instanceof Error ? err.message : String(err);
-      return { content: [{ type: "text", text: `Failed to get system context: ${message}` }], isError: true };
-    }
-  };
-  server.tool(
-    "get_system_context",
-    "Get system metadata, description, and notes in one view",
-    getSystemContextSchema,
-    getSystemContextHandler
-  );
-  const updateSystemSchema = {
-    systemId: external_exports.string().describe("The system ID"),
-    title: external_exports.string().optional().describe("New system title"),
-    description: external_exports.string().optional().describe("New system description"),
-    strategy: external_exports.string().optional().describe('System strategy markdown \u2014 Org Strategy + System Strategy ("System Coda")'),
-    teamspaceId: external_exports.string().nullable().optional().describe("Teamspace ID to associate this system with; pass null to remove the association"),
-    accountId: external_exports.string().nullable().optional().describe("Account that owns this System \u2014 the client or internal org unit. Pass null (or an empty string) to unlink. Reassigning moves the System so it is listed under exactly one Account."),
-    repoOwner: external_exports.string().optional().describe("GitHub repository owner (org or user)"),
-    repoName: external_exports.string().optional().describe("GitHub repository name"),
-    repoDefaultBranch: external_exports.string().optional().describe('Default branch for code check (defaults to "main")'),
-    rateLimitOverrides: external_exports.record(external_exports.string(), external_exports.object({ maxPerHour: external_exports.number().min(0) })).optional().describe('Per-task-type rate limit overrides, e.g. {"agent_chat":{"maxPerHour":100}}. Overrides env var and compiled defaults.')
-  };
-  const updateSystemHandler = async ({ systemId, ...updates }) => {
-    try {
-      const nonEmpty = Object.fromEntries(
-        Object.entries(updates).filter(([, v]) => v !== void 0)
-      );
-      if (Object.keys(nonEmpty).length === 0) {
-        return { content: [{ type: "text", text: "No updates provided." }], isError: true };
-      }
-      await assertProjectInOrg(client, systemId, ctx.orgId);
-      if (nonEmpty["accountId"] === "") nonEmpty["accountId"] = null;
-      if (typeof updates.teamspaceId === "string") {
-        const teamspace = await client.getTeamspace(updates.teamspaceId);
-        if (!teamspace) {
-          return { content: [{ type: "text", text: "Teamspace not found" }], isError: true };
-        }
-        if (teamspace.orgId !== ctx.orgId) {
-          return { content: [{ type: "text", text: "Teamspace does not belong to this organization" }], isError: true };
-        }
-      }
-      const updated = await client.updateSystem(systemId, nonEmpty);
-      if (!updated) {
-        return { content: [{ type: "text", text: `System not found: "${systemId}"` }], isError: true };
-      }
-      if (PROJECT_EMBEDDING_FIELDS.some((f) => f in nonEmpty)) {
-        void client.triggerProjectEmbedding(systemId);
-      }
-      const lines = [
-        `System updated successfully.`,
-        "",
-        `**ID:** ${updated.projectId}`,
-        `**Title:** ${updated.title}`,
-        accountLine(nonEmpty, updated.accountId),
-        updated.strategy ? `**Strategy:** (updated)` : "",
-        updated.repoOwner ? `**Repo:** ${updated.repoOwner}/${updated.repoName}` : "",
-        updated.repoDefaultBranch ? `**Default Branch:** ${updated.repoDefaultBranch}` : ""
-      ].filter(Boolean);
-      return { content: [{ type: "text", text: lines.join("\n") }] };
-    } catch (err) {
-      const message = err instanceof Error ? err.message : String(err);
-      return { content: [{ type: "text", text: `Failed to update system: ${message}` }], isError: true };
-    }
-  };
-  server.tool("update_system", "Update system settings such as title, description, repository configuration, or the Account that owns it", updateSystemSchema, updateSystemHandler);
-  server.tool(
-    "archive_system",
-    "Archive a system, hiding it from the system dropdown and all active system views. Use this when a system is no longer active and should be removed from navigation.",
-    { systemId: external_exports.string().describe("The system ID to archive") },
-    async ({ systemId }) => {
-      const system = await client.getSystem(systemId);
-      if (!system) {
-        return { content: [{ type: "text", text: `System not found: "${systemId}"` }], isError: true };
-      }
-      if (system.orgId !== ctx.orgId) {
-        return { content: [{ type: "text", text: `System "${systemId}" is not in this organization` }], isError: true };
-      }
-      try {
-        const updated = await client.archiveSystem(systemId);
-        if (!updated) {
-          return { content: [{ type: "text", text: `System not found: "${systemId}"` }], isError: true };
-        }
-        return {
-          content: [{
-            type: "text",
-            text: [
-              "System archived successfully.",
-              "",
-              `**ID:** ${updated.projectId}`,
-              `**Title:** ${updated.title}`,
-              `**Status:** ${updated.status}`
-            ].join("\n")
-          }]
-        };
-      } catch (err) {
-        const message = err instanceof Error ? err.message : String(err);
-        return { content: [{ type: "text", text: `Failed to archive system: ${message}` }], isError: true };
-      }
-    }
-  );
-  const createSystemSchema = {
-    title: external_exports.string().describe("System title"),
-    description: external_exports.string().optional().describe("System description"),
-    strategy: external_exports.string().optional().describe('System strategy markdown \u2014 Org Strategy + System Strategy ("System Coda")'),
-    teamspaceId: external_exports.string().optional().describe("Teamspace ID to associate this system with"),
-    repoOwner: external_exports.string().optional().describe("GitHub repository owner (org or user)"),
-    repoName: external_exports.string().optional().describe("GitHub repository name"),
-    repoDefaultBranch: external_exports.string().optional().describe('Default branch for code check (defaults to "main")')
-  };
-  const createSystemHandler = async ({ title, description, strategy, teamspaceId, repoOwner, repoName, repoDefaultBranch }) => {
-    if (teamspaceId) {
-      const teamspace = await client.getTeamspace(teamspaceId);
-      if (!teamspace) {
-        return { content: [{ type: "text", text: "Teamspace not found" }], isError: true };
-      }
-      if (teamspace.orgId !== ctx.orgId) {
-        return { content: [{ type: "text", text: "Teamspace does not belong to this organization" }], isError: true };
-      }
-    }
-    try {
-      const project = await client.createSystem({
-        projectId: (0, import_crypto5.randomUUID)(),
-        orgId: ctx.orgId,
-        ownerUserId: ctx.user.userId,
-        title,
-        description,
-        strategy,
-        status: "active",
-        teamspaceId,
-        repoOwner,
-        repoName,
-        repoDefaultBranch
-      });
-      const text = [
-        `System created successfully.`,
-        "",
-        `**ID:** ${project.projectId}`,
-        `**Title:** ${project.title}`,
-        `**Status:** ${project.status}`,
-        project.description ? `**Description:** ${project.description}` : "",
-        project.repoOwner ? `**Repo:** ${project.repoOwner}/${project.repoName}` : "",
-        project.repoDefaultBranch ? `**Default Branch:** ${project.repoDefaultBranch}` : ""
-      ].filter(Boolean).join("\n");
-      return { content: [{ type: "text", text }] };
-    } catch (err) {
-      const message = err instanceof Error ? err.message : String(err);
-      return { content: [{ type: "text", text: `Failed to create system: ${message}` }], isError: true };
-    }
-  };
-  server.tool("create_system", "Create a new system in the configured organization", createSystemSchema, createSystemHandler);
-}
-
 // ../../libs/harmonica-services/src/mcp/tools/pulse-report-tools.ts
 function formatBeatRow(r) {
   const downbeatState = r.hasDownbeat ? "" : " \u2014 no Downbeat ever set";
@@ -30018,8 +29769,8 @@ var import_promises = require("node:fs/promises");
 var import_node_os = require("node:os");
 var import_node_path = require("node:path");
 
-// ../../libs/harmonica-services/src/project-snapshot.constants.ts
-var SNAPSHOT_VERSION = 2;
+// ../../libs/harmonica-services/src/system-snapshot.constants.ts
+var SNAPSHOT_VERSION = 4;
 
 // ../../libs/harmonica-services/src/mcp/tools/snapshot-tools.ts
 function registerSnapshotTools(server, ctx, client) {
@@ -30051,7 +29802,7 @@ function registerSnapshotTools(server, ctx, client) {
       const filename = `harmonica-snapshot-${systemId}-${Date.now()}.json`;
       const filePath = (0, import_node_path.join)((0, import_node_os.tmpdir)(), filename);
       await (0, import_promises.writeFile)(filePath, JSON.stringify(snapshot), "utf-8");
-      const title = snapshot.project?.title ?? systemId;
+      const title = snapshot.system?.title ?? systemId;
       const versionNote = snapshot.version !== SNAPSHOT_VERSION ? [`Warning: snapshot version ${snapshot.version} (local expects ${SNAPSHOT_VERSION}) \u2014 some counts may be zero.`, ""] : [];
       const summary = [
         `Exported "${title}" to: ${filePath}`,
@@ -30066,6 +29817,10 @@ function registerSnapshotTools(server, ctx, client) {
         `  PromptLogs: ${snapshot.promptLogs.length}`,
         `  Drops: ${snapshot.drops?.length ?? 0}`,
         `  Deliverables: ${snapshot.deliverables?.length ?? 0}`,
+        `  Teamspaces: ${snapshot.teamspaces?.length ?? 0}`,
+        `  Layers: ${snapshot.layers?.length ?? 0}`,
+        `  Tracks: ${snapshot.tracks?.length ?? 0}`,
+        `  Work Items: ${snapshot.workItems?.length ?? 0}`,
         "",
         "Use import_system_snapshot with this file path to import into another environment."
       ];
@@ -30099,7 +29854,7 @@ function registerSnapshotTools(server, ctx, client) {
         if (isPrivateHost(trimmed)) {
           throw new Error("Snapshot URL must point to a public host \u2014 private, link-local, and loopback addresses are not permitted.");
         }
-        const result2 = await client.importProjectSnapshotFromUrl(trimmed, importOptions);
+        const result2 = await client.importSystemSnapshotFromUrl(trimmed, importOptions);
         return { content: [{ type: "text", text: formatImportSummary(result2, targetTeamspaceId) }] };
       }
       if (trimmed.startsWith("http://")) {
@@ -30114,21 +29869,25 @@ function registerSnapshotTools(server, ctx, client) {
       }
       assertSnapshotShape(parsed, "");
       const normalized = normalizeSnapshot(parsed);
-      const result = await client.importProjectSnapshot(normalized, importOptions);
+      const result = await client.importSystemSnapshot(normalized, importOptions);
       return { content: [{ type: "text", text: formatImportSummary(result, targetTeamspaceId) }] };
     }
   );
 }
 function normalizeSnapshot(raw) {
+  const anyRaw = raw;
   return {
     ...raw,
+    // Compat: v3 and earlier snapshots have 'project' instead of 'system'
+    system: raw.system ?? anyRaw["project"],
     beats: raw.beats ?? [],
     beatIndex: raw.beatIndex ?? [],
     proposals: raw.proposals ?? [],
     proposalIndex: raw.proposalIndex ?? [],
     revisions: raw.revisions ?? [],
     revisionIndex: raw.revisionIndex ?? [],
-    projectRevisionIndex: raw.projectRevisionIndex ?? [],
+    // Compat: v3 and earlier snapshots have 'projectRevisionIndex'
+    systemRevisionIndex: raw.systemRevisionIndex ?? anyRaw["projectRevisionIndex"] ?? [],
     activities: raw.activities ?? [],
     activityIndex: raw.activityIndex ?? [],
     notes: raw.notes ?? [],
@@ -30141,13 +29900,26 @@ function normalizeSnapshot(raw) {
     promptLogs: raw.promptLogs ?? [],
     beatVersions: raw.beatVersions ?? [],
     beatBeatVersionIndex: raw.beatBeatVersionIndex ?? [],
-    projectBeatVersionIndex: raw.projectBeatVersionIndex ?? [],
+    // Compat: v3 and earlier snapshots have 'projectBeatVersionIndex'
+    systemBeatVersionIndex: raw.systemBeatVersionIndex ?? anyRaw["projectBeatVersionIndex"] ?? [],
     beatVersionDropAssignments: raw.beatVersionDropAssignments ?? [],
     drops: raw.drops ?? [],
     accountDropIndex: raw.accountDropIndex ?? [],
     deliverables: raw.deliverables ?? [],
     teamspaceDeliverableIndex: raw.teamspaceDeliverableIndex ?? [],
-    projectDeliverableIndex: raw.projectDeliverableIndex ?? []
+    // Compat: v3 and earlier snapshots have 'projectDeliverableIndex'
+    systemDeliverableIndex: raw.systemDeliverableIndex ?? anyRaw["projectDeliverableIndex"] ?? [],
+    teamspaces: raw.teamspaces ?? [],
+    teamspaceAccountIndex: raw.teamspaceAccountIndex ?? [],
+    accountTeamspaceIndex: raw.accountTeamspaceIndex ?? [],
+    layers: raw.layers ?? [],
+    layerIndex: raw.layerIndex ?? [],
+    tracks: raw.tracks ?? [],
+    // Compat: early v4 snapshots (before field rename) have 'trackProjectIndex'
+    trackSystemIndex: raw.trackSystemIndex ?? anyRaw["trackProjectIndex"] ?? [],
+    trackTeamspaceIndex: raw.trackTeamspaceIndex ?? [],
+    workItems: raw.workItems ?? [],
+    workItemIndex: raw.workItemIndex ?? []
   };
 }
 async function resolveSnapshotInput(input) {
@@ -30170,7 +29942,11 @@ function formatImportSummary(result, targetTeamspaceId) {
     `  PromptLogs: ${result.counts.promptLogs}`,
     `  Beat Versions: ${result.counts.beatVersions ?? 0}`,
     `  Drops: ${result.counts.drops ?? 0}`,
-    `  Deliverables: ${result.counts.deliverables ?? 0}`
+    `  Deliverables: ${result.counts.deliverables ?? 0}`,
+    `  Teamspaces: ${result.counts.teamspaces ?? 0}`,
+    `  Layers: ${result.counts.layers ?? 0}`,
+    `  Tracks: ${result.counts.tracks ?? 0}`,
+    `  Work Items: ${result.counts.workItems ?? 0}`
   ];
   if (result.errors.length > 0) {
     lines.push("", `Errors (${result.errors.length}):`);
@@ -30217,9 +29993,9 @@ function assertSnapshotShape(val, sourceHint) {
   if (typeof obj["version"] !== "number" || obj["version"] <= 0) {
     throw new Error(`Snapshot${sourceHint} has an invalid or missing 'version' field \u2014 it may not be a valid project snapshot.`);
   }
-  const project = obj["project"];
-  if (typeof project !== "object" || project === null || typeof project["projectId"] !== "string") {
-    throw new Error(`Snapshot${sourceHint} is missing 'project.projectId' \u2014 it may not be a valid project snapshot.`);
+  const systemOrProject = obj["system"] ?? obj["project"];
+  if (typeof systemOrProject !== "object" || systemOrProject === null || typeof systemOrProject["projectId"] !== "string") {
+    throw new Error(`Snapshot${sourceHint} is missing 'system.projectId' \u2014 it may not be a valid project snapshot.`);
   }
 }
 
@@ -30227,76 +30003,339 @@ function assertSnapshotShape(val, sourceHint) {
 var ENTITY_TYPES = ["project", "beat", "revision"];
 function registerSubscriptionTools(server, ctx, client) {
   server.tool(
-    "subscribe_to_entity",
-    "Follow a Project, Beat, or Revision to receive notifications when it changes. You are auto-subscribed to things you own \u2014 use this to follow additional entities.",
-    {
-      entityType: external_exports.enum(ENTITY_TYPES).describe("Type of entity to follow"),
-      entityId: external_exports.string().describe("The entity ID (project ID, beat ID, or revision ID)"),
-      projectId: external_exports.string().describe("The project ID (for access control)")
-    },
-    async ({ entityType, entityId, projectId }) => {
-      try {
-        await assertProjectInOrg(client, projectId, ctx.orgId);
-        await client.subscribe(ctx.user.userId, entityType, entityId, projectId, "manual");
-        return {
-          content: [{
-            type: "text",
-            text: `Now following ${entityType} ${entityId}. You'll receive notifications when it changes.`
-          }]
-        };
-      } catch (err) {
-        const message = err instanceof Error ? err.message : String(err);
-        return { content: [{ type: "text", text: `Failed to subscribe: ${message}` }], isError: true };
+    "subscribe_to_entity",
+    "Follow a Project, Beat, or Revision to receive notifications when it changes. You are auto-subscribed to things you own \u2014 use this to follow additional entities.",
+    {
+      entityType: external_exports.enum(ENTITY_TYPES).describe("Type of entity to follow"),
+      entityId: external_exports.string().describe("The entity ID (project ID, beat ID, or revision ID)"),
+      projectId: external_exports.string().describe("The project ID (for access control)")
+    },
+    async ({ entityType, entityId, projectId }) => {
+      try {
+        await assertProjectInOrg(client, projectId, ctx.orgId);
+        await client.subscribe(ctx.user.userId, entityType, entityId, projectId, "manual");
+        return {
+          content: [{
+            type: "text",
+            text: `Now following ${entityType} ${entityId}. You'll receive notifications when it changes.`
+          }]
+        };
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { content: [{ type: "text", text: `Failed to subscribe: ${message}` }], isError: true };
+      }
+    }
+  );
+  server.tool(
+    "unsubscribe_from_entity",
+    "Stop following a Project, Beat, or Revision. Use durable=true to prevent auto-resubscribe if you are later re-assigned.",
+    {
+      entityType: external_exports.enum(ENTITY_TYPES).describe("Type of entity to unfollow"),
+      entityId: external_exports.string().describe("The entity ID"),
+      durable: external_exports.boolean().optional().default(false).describe("If true, prevents auto-resubscribe on reassignment")
+    },
+    async ({ entityType, entityId, durable }) => {
+      try {
+        await client.unsubscribe(ctx.user.userId, entityType, entityId, durable);
+        const durableMsg = durable ? " (durable \u2014 will not auto-resubscribe on reassignment)" : "";
+        return {
+          content: [{
+            type: "text",
+            text: `Unfollowed ${entityType} ${entityId}${durableMsg}.`
+          }]
+        };
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { content: [{ type: "text", text: `Failed to unsubscribe: ${message}` }], isError: true };
+      }
+    }
+  );
+  server.tool(
+    "list_subscriptions",
+    "List entities you are currently following. Optionally filter by entity type (project, beat, revision).",
+    {
+      entityType: external_exports.enum(ENTITY_TYPES).optional().describe("Filter by entity type")
+    },
+    async ({ entityType }) => {
+      try {
+        const subs = await client.listSubscriptions(ctx.user.userId, entityType);
+        if (subs.length === 0) {
+          return { content: [{ type: "text", text: "You are not following any entities." }] };
+        }
+        const lines = [`# Your Subscriptions (${subs.length})`, ""];
+        for (const sub of subs) {
+          lines.push(`- **${sub.entityType}** ${sub.entityId} (${sub.source}, since ${sub.createdAt?.split("T")[0] ?? "unknown"})`);
+        }
+        return { content: [{ type: "text", text: lines.join("\n") }] };
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { content: [{ type: "text", text: `Failed to list subscriptions: ${message}` }], isError: true };
+      }
+    }
+  );
+}
+
+// ../../libs/harmonica-services/src/mcp/tools/system-lifecycle-tools.ts
+function registerProjectLifecycleTools(server, ctx, client) {
+  server.tool(
+    "transition_system_lifecycle",
+    "Advance a System's capability-maturity lifecycle state. Allowed transitions follow the state machine (Concept \u2192 Incubating \u2192 Piloting \u2192 Activated \u2192 Commercializing \u2192 Scaled, plus paused/killed/sunset/archived exits). The activated \u2192 commercializing edge requires a `decisionNoteId` pointing to a system-scoped Decision Note (the governance review). Other gates are advisory.",
+    {
+      systemId: external_exports.string().describe("The system ID"),
+      targetState: external_exports.enum([
+        "concept",
+        "incubating",
+        "piloting",
+        "activated",
+        "commercializing",
+        "scaled",
+        "paused",
+        "killed",
+        "sunset",
+        "archived"
+      ]).describe("Target lifecycle state. Active: concept, incubating, piloting, activated, commercializing, scaled. Exits: paused, killed, sunset, archived."),
+      reason: external_exports.string().optional().describe("Why this transition is being made (recorded in audit metadata)"),
+      decisionNoteId: external_exports.string().optional().describe("Note ID of the governance Decision Note. Required for the activated \u2192 commercializing transition; optional otherwise.")
+    },
+    async ({ systemId, targetState, reason, decisionNoteId }) => {
+      try {
+        const system = await client.getSystem(systemId);
+        if (!system) {
+          return { content: [{ type: "text", text: `System not found: "${systemId}"` }], isError: true };
+        }
+        if (system.orgId !== ctx.orgId) {
+          return { content: [{ type: "text", text: `System "${systemId}" is not in this organization` }], isError: true };
+        }
+        const result = await client.transitionProjectLifecycleState(systemId, targetState, {
+          actor: { type: "human", id: ctx.user.userId, name: ctx.user.name },
+          reason,
+          decisionNoteId
+        });
+        if (!result.success) {
+          const failedGates = result.error?.failedGates?.length ? ` (failed gates: ${result.error.failedGates.join(", ")})` : "";
+          return {
+            content: [{ type: "text", text: `Transition failed: ${result.error?.message ?? "Unknown error"}${failedGates}` }],
+            isError: true
+          };
+        }
+        const lines = [
+          `System lifecycle transitioned successfully.`,
+          "",
+          `**System:** ${systemId}`,
+          `**Title:** ${system.title}`,
+          `**Transition:** ${result.previousState} \u2192 ${result.newState}`
+        ];
+        if (reason) lines.push(`**Reason:** ${reason}`);
+        if (decisionNoteId) lines.push(`**Decision Note:** ${decisionNoteId}`);
+        return { content: [{ type: "text", text: lines.join("\n") }] };
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { content: [{ type: "text", text: `Failed to transition system lifecycle: ${message}` }], isError: true };
+      }
+    }
+  );
+}
+
+// ../../libs/harmonica-services/src/mcp/tools/system-tools.ts
+var import_crypto5 = require("crypto");
+function accountLine(request, resolved) {
+  const requested = request["accountId"];
+  if (requested === null || requested === "") return "**Account:** (unlinked)";
+  return resolved ? `**Account:** ${resolved}` : "";
+}
+var PROJECT_EMBEDDING_FIELDS = ["title", "description", "strategy"];
+function registerProjectTools(server, ctx, client) {
+  const listSystemsHandler = async ({ teamspaceId }) => {
+    try {
+      const projects = await client.listOrgSystems(ctx.orgId);
+      const trimmed = teamspaceId?.trim();
+      const filtered = trimmed ? projects.filter((p) => p.teamspaceId === trimmed) : projects;
+      const text = formatProjectSummaryTable(filtered);
+      return { content: [{ type: "text", text }] };
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      return { content: [{ type: "text", text: `Failed to list systems: ${message}` }], isError: true };
+    }
+  };
+  server.tool(
+    "list_systems",
+    "List all systems (projects) in the configured organization",
+    {
+      teamspaceId: external_exports.string().optional().describe("Filter to systems belonging to a specific teamspace. Empty or whitespace-only treated as no filter.")
+    },
+    listSystemsHandler
+  );
+  const getSystemContextSchema = {
+    systemId: external_exports.string().describe("The system ID"),
+    noteLimit: external_exports.number().int().min(1).max(MAX_CONTEXT_NOTE_LIMIT).optional().describe(
+      `Max Notes to include, prioritised by note type (default ${DEFAULT_CONTEXT_NOTE_LIMIT}, max ${MAX_CONTEXT_NOTE_LIMIT}). Use list_notes or search for the full set.`
+    )
+  };
+  const getSystemContextHandler = async ({
+    systemId,
+    noteLimit
+  }) => {
+    try {
+      const [project, org] = await Promise.all([
+        fetchProjectInOrg(client, systemId, ctx.orgId),
+        client.getOrg(ctx.orgId)
+      ]);
+      const notes = await client.listProjectNotes(systemId, {
+        limit: noteLimit ?? DEFAULT_CONTEXT_NOTE_LIMIT
+      });
+      const text = formatProjectContext(project, notes, org?.coda);
+      return { content: [{ type: "text", text }] };
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      return { content: [{ type: "text", text: `Failed to get system context: ${message}` }], isError: true };
+    }
+  };
+  server.tool(
+    "get_system_context",
+    "Get system metadata, description, and notes in one view",
+    getSystemContextSchema,
+    getSystemContextHandler
+  );
+  const updateSystemSchema = {
+    systemId: external_exports.string().describe("The system ID"),
+    title: external_exports.string().optional().describe("New system title"),
+    description: external_exports.string().optional().describe("New system description"),
+    strategy: external_exports.string().optional().describe('System strategy markdown \u2014 Org Strategy + System Strategy ("System Coda")'),
+    teamspaceId: external_exports.string().nullable().optional().describe("Teamspace ID to associate this system with; pass null to remove the association"),
+    accountId: external_exports.string().nullable().optional().describe("Account that owns this System \u2014 the client or internal org unit. Pass null (or an empty string) to unlink. Reassigning moves the System so it is listed under exactly one Account."),
+    repoOwner: external_exports.string().optional().describe("GitHub repository owner (org or user)"),
+    repoName: external_exports.string().optional().describe("GitHub repository name"),
+    repoDefaultBranch: external_exports.string().optional().describe('Default branch for code check (defaults to "main")'),
+    rateLimitOverrides: external_exports.record(external_exports.string(), external_exports.object({ maxPerHour: external_exports.number().min(0) })).optional().describe('Per-task-type rate limit overrides, e.g. {"agent_chat":{"maxPerHour":100}}. Overrides env var and compiled defaults.')
+  };
+  const updateSystemHandler = async ({ systemId, ...updates }) => {
+    try {
+      const nonEmpty = Object.fromEntries(
+        Object.entries(updates).filter(([, v]) => v !== void 0)
+      );
+      if (Object.keys(nonEmpty).length === 0) {
+        return { content: [{ type: "text", text: "No updates provided." }], isError: true };
+      }
+      await assertProjectInOrg(client, systemId, ctx.orgId);
+      if (nonEmpty["accountId"] === "") nonEmpty["accountId"] = null;
+      if (typeof updates.teamspaceId === "string") {
+        const teamspace = await client.getTeamspace(updates.teamspaceId);
+        if (!teamspace) {
+          return { content: [{ type: "text", text: "Teamspace not found" }], isError: true };
+        }
+        if (teamspace.orgId !== ctx.orgId) {
+          return { content: [{ type: "text", text: "Teamspace does not belong to this organization" }], isError: true };
+        }
+      }
+      const updated = await client.updateSystem(systemId, nonEmpty);
+      if (!updated) {
+        return { content: [{ type: "text", text: `System not found: "${systemId}"` }], isError: true };
       }
+      if (PROJECT_EMBEDDING_FIELDS.some((f) => f in nonEmpty)) {
+        void client.triggerProjectEmbedding(systemId);
+      }
+      const lines = [
+        `System updated successfully.`,
+        "",
+        `**ID:** ${updated.projectId}`,
+        `**Title:** ${updated.title}`,
+        accountLine(nonEmpty, updated.accountId),
+        updated.strategy ? `**Strategy:** (updated)` : "",
+        updated.repoOwner ? `**Repo:** ${updated.repoOwner}/${updated.repoName}` : "",
+        updated.repoDefaultBranch ? `**Default Branch:** ${updated.repoDefaultBranch}` : ""
+      ].filter(Boolean);
+      return { content: [{ type: "text", text: lines.join("\n") }] };
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      return { content: [{ type: "text", text: `Failed to update system: ${message}` }], isError: true };
     }
-  );
+  };
+  server.tool("update_system", "Update system settings such as title, description, repository configuration, or the Account that owns it", updateSystemSchema, updateSystemHandler);
   server.tool(
-    "unsubscribe_from_entity",
-    "Stop following a Project, Beat, or Revision. Use durable=true to prevent auto-resubscribe if you are later re-assigned.",
-    {
-      entityType: external_exports.enum(ENTITY_TYPES).describe("Type of entity to unfollow"),
-      entityId: external_exports.string().describe("The entity ID"),
-      durable: external_exports.boolean().optional().default(false).describe("If true, prevents auto-resubscribe on reassignment")
-    },
-    async ({ entityType, entityId, durable }) => {
+    "archive_system",
+    "Archive a system, hiding it from the system dropdown and all active system views. Use this when a system is no longer active and should be removed from navigation.",
+    { systemId: external_exports.string().describe("The system ID to archive") },
+    async ({ systemId }) => {
+      const system = await client.getSystem(systemId);
+      if (!system) {
+        return { content: [{ type: "text", text: `System not found: "${systemId}"` }], isError: true };
+      }
+      if (system.orgId !== ctx.orgId) {
+        return { content: [{ type: "text", text: `System "${systemId}" is not in this organization` }], isError: true };
+      }
       try {
-        await client.unsubscribe(ctx.user.userId, entityType, entityId, durable);
-        const durableMsg = durable ? " (durable \u2014 will not auto-resubscribe on reassignment)" : "";
+        const updated = await client.archiveSystem(systemId);
+        if (!updated) {
+          return { content: [{ type: "text", text: `System not found: "${systemId}"` }], isError: true };
+        }
         return {
           content: [{
             type: "text",
-            text: `Unfollowed ${entityType} ${entityId}${durableMsg}.`
+            text: [
+              "System archived successfully.",
+              "",
+              `**ID:** ${updated.projectId}`,
+              `**Title:** ${updated.title}`,
+              `**Status:** ${updated.status}`
+            ].join("\n")
           }]
         };
       } catch (err) {
         const message = err instanceof Error ? err.message : String(err);
-        return { content: [{ type: "text", text: `Failed to unsubscribe: ${message}` }], isError: true };
+        return { content: [{ type: "text", text: `Failed to archive system: ${message}` }], isError: true };
       }
     }
   );
-  server.tool(
-    "list_subscriptions",
-    "List entities you are currently following. Optionally filter by entity type (project, beat, revision).",
-    {
-      entityType: external_exports.enum(ENTITY_TYPES).optional().describe("Filter by entity type")
-    },
-    async ({ entityType }) => {
-      try {
-        const subs = await client.listSubscriptions(ctx.user.userId, entityType);
-        if (subs.length === 0) {
-          return { content: [{ type: "text", text: "You are not following any entities." }] };
-        }
-        const lines = [`# Your Subscriptions (${subs.length})`, ""];
-        for (const sub of subs) {
-          lines.push(`- **${sub.entityType}** ${sub.entityId} (${sub.source}, since ${sub.createdAt?.split("T")[0] ?? "unknown"})`);
-        }
-        return { content: [{ type: "text", text: lines.join("\n") }] };
-      } catch (err) {
-        const message = err instanceof Error ? err.message : String(err);
-        return { content: [{ type: "text", text: `Failed to list subscriptions: ${message}` }], isError: true };
+  const createSystemSchema = {
+    title: external_exports.string().describe("System title"),
+    description: external_exports.string().optional().describe("System description"),
+    strategy: external_exports.string().optional().describe('System strategy markdown \u2014 Org Strategy + System Strategy ("System Coda")'),
+    teamspaceId: external_exports.string().optional().describe("Teamspace ID to associate this system with"),
+    repoOwner: external_exports.string().optional().describe("GitHub repository owner (org or user)"),
+    repoName: external_exports.string().optional().describe("GitHub repository name"),
+    repoDefaultBranch: external_exports.string().optional().describe('Default branch for code check (defaults to "main")')
+  };
+  const createSystemHandler = async ({ title, description, strategy, teamspaceId, repoOwner, repoName, repoDefaultBranch }) => {
+    if (teamspaceId) {
+      const teamspace = await client.getTeamspace(teamspaceId);
+      if (!teamspace) {
+        return { content: [{ type: "text", text: "Teamspace not found" }], isError: true };
+      }
+      if (teamspace.orgId !== ctx.orgId) {
+        return { content: [{ type: "text", text: "Teamspace does not belong to this organization" }], isError: true };
       }
     }
-  );
+    try {
+      const project = await client.createSystem({
+        projectId: (0, import_crypto5.randomUUID)(),
+        orgId: ctx.orgId,
+        ownerUserId: ctx.user.userId,
+        title,
+        description,
+        strategy,
+        status: "active",
+        teamspaceId,
+        repoOwner,
+        repoName,
+        repoDefaultBranch
+      });
+      const text = [
+        `System created successfully.`,
+        "",
+        `**ID:** ${project.projectId}`,
+        `**Title:** ${project.title}`,
+        `**Status:** ${project.status}`,
+        project.description ? `**Description:** ${project.description}` : "",
+        project.repoOwner ? `**Repo:** ${project.repoOwner}/${project.repoName}` : "",
+        project.repoDefaultBranch ? `**Default Branch:** ${project.repoDefaultBranch}` : ""
+      ].filter(Boolean).join("\n");
+      return { content: [{ type: "text", text }] };
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      return { content: [{ type: "text", text: `Failed to create system: ${message}` }], isError: true };
+    }
+  };
+  server.tool("create_system", "Create a new system in the configured organization", createSystemSchema, createSystemHandler);
 }
 
 // ../../libs/harmonica-services/src/mcp/tools/teamspace-tools.ts
@@ -30754,8 +30793,15 @@ function registerValueVelocityTools(server, ctx, client) {
 // ../../libs/harmonica-services/src/mcp/tools/work-item-tools.ts
 var WORK_ITEM_STATUS_ENUM = ["not_started", "in_progress", "blocked", "done"];
 function formatOwner(owner) {
-  return `${owner.name} <${owner.email}>`;
-}
+  return owner ? `${owner.name} <${owner.email}>` : "unassigned";
+}
+var WORK_ITEM_EFFORT_SIZE_ENUM = [
+  "XS",
+  "S",
+  "M",
+  "L",
+  "XL"
+];
 function registerWorkItemTools(server, _ctx, client) {
   server.tool(
     "list_track_work_items",
@@ -30791,6 +30837,9 @@ function registerWorkItemTools(server, _ctx, client) {
         `Status: ${wi.status}`,
         wi.committedEstimateHours !== void 0 ? `Committed Estimate: ${wi.committedEstimateHours}h` : null,
         wi.actualHours !== void 0 ? `Actual Hours: ${wi.actualHours}h` : null,
+        wi.effortSize !== void 0 ? `Effort Size: ${wi.effortSize}` : null,
+        wi.valueUnits !== void 0 ? `Value Units: ${wi.valueUnits}` : null,
+        wi.costPerValueUnit !== void 0 ? `Cost per Value Unit: ${wi.costPerValueUnit}` : null,
         wi.beatVersionId ? `Linked Beat Version: ${wi.beatVersionId}` : null,
         estimateHint ? `Estimate Hint: ${estimateHint.hours}h (source: ${estimateHint.source})` : null,
         wi.createdBy ? `Created By: ${wi.createdBy}` : null,
@@ -30806,18 +30855,30 @@ function registerWorkItemTools(server, _ctx, client) {
     {
       trackId: external_exports.string().describe("The Track (DeliverableGroup) ID this work item belongs to"),
       title: external_exports.string().min(1).max(300).describe("Work item title"),
-      ownerName: external_exports.string().min(1).describe("Owner display name"),
-      ownerEmail: external_exports.string().email().describe("Owner email \u2014 exactly one owner at all times"),
+      ownerName: external_exports.string().min(1).optional().describe("Optional owner display name (requires ownerEmail too)"),
+      ownerEmail: external_exports.string().email().optional().describe("Optional owner email (requires ownerName too). A work item may be left unowned."),
       committedEstimateHours: external_exports.number().nonnegative().optional().describe("Optional committed estimate in hours"),
+      effortSize: external_exports.enum(WORK_ITEM_EFFORT_SIZE_ENUM).optional().describe("Optional rough t-shirt effort size (delivery lens) \u2014 independent of valueUnits"),
+      valueUnits: external_exports.number().nonnegative().optional().describe("Optional Value Units (commercial lens) \u2014 independent of effortSize"),
+      costPerValueUnit: external_exports.number().nonnegative().optional().describe("Optional price per Value Unit"),
       createdBy: external_exports.string().optional().describe("Optional creator identity for audit"),
       beatVersionId: external_exports.string().min(1).optional().describe("Optional Beat Version to link for capability lineage. Must exist.")
     },
-    async ({ trackId, title, ownerName, ownerEmail, committedEstimateHours, createdBy, beatVersionId }) => {
+    async ({ trackId, title, ownerName, ownerEmail, committedEstimateHours, effortSize, valueUnits, costPerValueUnit, createdBy, beatVersionId }) => {
+      if (ownerName === void 0 !== (ownerEmail === void 0)) {
+        return {
+          content: [{ type: "text", text: "Setting the owner requires both ownerName and ownerEmail. Omit both to create an unowned work item." }],
+          isError: true
+        };
+      }
       const wi = await client.createWorkItem({
         trackId,
         title,
-        owner: { name: ownerName, email: ownerEmail },
+        ...ownerName !== void 0 && ownerEmail !== void 0 && { owner: { name: ownerName, email: ownerEmail } },
         ...committedEstimateHours !== void 0 && { committedEstimateHours },
+        ...effortSize !== void 0 && { effortSize },
+        ...valueUnits !== void 0 && { valueUnits },
+        ...costPerValueUnit !== void 0 && { costPerValueUnit },
         ...createdBy !== void 0 && { createdBy },
         ...beatVersionId !== void 0 && { beatVersionId }
       });
@@ -30833,17 +30894,21 @@ function registerWorkItemTools(server, _ctx, client) {
   );
   server.tool(
     "update_work_item",
-    "Update mutable content fields on a work item (title, owner, committedEstimateHours, actualHours, beatVersionId). To move it between Tracks use move_work_item; to change its status use transition_work_item_status.",
+    "Update mutable content fields on a work item (title, owner, committedEstimateHours, actualHours, effortSize, valueUnits, costPerValueUnit, beatVersionId). To move it between Tracks use move_work_item; to change its status use transition_work_item_status.",
     {
       workItemId: external_exports.string().describe("The work item ID"),
       title: external_exports.string().min(1).max(300).optional().describe("New title"),
       ownerName: external_exports.string().min(1).optional().describe("New owner display name (requires ownerEmail too)"),
       ownerEmail: external_exports.string().email().optional().describe("New owner email (requires ownerName too)"),
+      unassignOwner: external_exports.boolean().optional().describe("Pass true to clear the owner, leaving the work item unowned. Cannot be combined with ownerName/ownerEmail."),
       committedEstimateHours: external_exports.number().nonnegative().optional().describe("New committed estimate in hours"),
       actualHours: external_exports.number().nonnegative().optional().describe("New actual hours logged"),
+      effortSize: external_exports.enum(WORK_ITEM_EFFORT_SIZE_ENUM).nullable().optional().describe("Rough t-shirt effort size (delivery lens). Pass null to clear; omit to leave untouched."),
+      valueUnits: external_exports.number().nonnegative().nullable().optional().describe("Value Units (commercial lens). Pass null to clear; omit to leave untouched."),
+      costPerValueUnit: external_exports.number().nonnegative().nullable().optional().describe("Price per Value Unit. Pass null to clear; omit to leave untouched."),
       beatVersionId: external_exports.string().min(1).nullable().optional().describe("Link to a Beat Version for capability lineage. Pass null to unlink; omit to leave the current link untouched.")
     },
-    async ({ workItemId, title, ownerName, ownerEmail, committedEstimateHours, actualHours, beatVersionId }) => {
+    async ({ workItemId, title, ownerName, ownerEmail, unassignOwner, committedEstimateHours, actualHours, effortSize, valueUnits, costPerValueUnit, beatVersionId }) => {
       const hasOwnerUpdate = ownerName !== void 0 || ownerEmail !== void 0;
       if (hasOwnerUpdate && (ownerName === void 0 || ownerEmail === void 0)) {
         return {
@@ -30851,7 +30916,13 @@ function registerWorkItemTools(server, _ctx, client) {
           isError: true
         };
       }
-      const hasUpdates = title !== void 0 || hasOwnerUpdate || committedEstimateHours !== void 0 || actualHours !== void 0 || beatVersionId !== void 0;
+      if (unassignOwner && hasOwnerUpdate) {
+        return {
+          content: [{ type: "text", text: "Cannot set and clear the owner in one update \u2014 pass either unassignOwner or ownerName/ownerEmail." }],
+          isError: true
+        };
+      }
+      const hasUpdates = title !== void 0 || hasOwnerUpdate || unassignOwner === true || committedEstimateHours !== void 0 || actualHours !== void 0 || effortSize !== void 0 || valueUnits !== void 0 || costPerValueUnit !== void 0 || beatVersionId !== void 0;
       if (!hasUpdates) {
         return {
           content: [{ type: "text", text: `No updates provided for work item: ${workItemId}` }],
@@ -30861,8 +30932,12 @@ function registerWorkItemTools(server, _ctx, client) {
       const wi = await client.updateWorkItem(workItemId, {
         ...title !== void 0 && { title },
         ...hasOwnerUpdate && { owner: { name: ownerName, email: ownerEmail } },
+        ...unassignOwner === true && { owner: null },
         ...committedEstimateHours !== void 0 && { committedEstimateHours },
         ...actualHours !== void 0 && { actualHours },
+        ...effortSize !== void 0 && { effortSize },
+        ...valueUnits !== void 0 && { valueUnits },
+        ...costPerValueUnit !== void 0 && { costPerValueUnit },
         ...beatVersionId !== void 0 && { beatVersionId }
       });
       if (!wi) {
@@ -31408,7 +31483,7 @@ function registerBeatResources(server, ctx, client) {
     async (uri, { projectId }) => {
       const pid = String(projectId);
       await assertProjectInOrg(client, pid, ctx.orgId);
-      const beats = await client.listProjectBeats(pid);
+      const beats = await client.listSystemBeats(pid);
       const text = formatBeatSummaryTable(beats);
       return { contents: [{ uri: uri.href, text }] };
     }
@@ -31442,7 +31517,7 @@ function registerGuidelinesResources(server, client) {
   );
 }
 
-// ../../libs/harmonica-services/src/mcp/resources/project-resources.ts
+// ../../libs/harmonica-services/src/mcp/resources/system-resources.ts
 function registerProjectResources(server, ctx, client) {
   server.resource(
     "project-context",
@@ -31450,7 +31525,7 @@ function registerProjectResources(server, ctx, client) {
     async (uri, { projectId }) => {
       const pid = String(projectId);
       const project = await fetchProjectInOrg(client, pid, ctx.orgId);
-      const notes = await client.listProjectNotes(pid, { limit: DEFAULT_CONTEXT_NOTE_LIMIT });
+      const notes = await client.listSystemNotes(pid, { limit: DEFAULT_CONTEXT_NOTE_LIMIT });
       const text = formatProjectContext(project, notes);
       return { contents: [{ uri: uri.href, text }] };
     }
@@ -31771,7 +31846,7 @@ function createHttpClient(config2) {
       const result = await request("POST", `/api/systems/${encodeURIComponent(projectId)}/beats/next-id`);
       return result.beatId;
     },
-    listProjectBeats: async (projectId) => {
+    listSystemBeats: async (projectId) => {
       const result = await request("GET", `/api/systems/${encodeURIComponent(projectId)}/beats`);
       return (result?.beats ?? []).map((b) => ({
         ...b,
@@ -31927,6 +32002,21 @@ function createHttpClient(config2) {
       const result = await request("POST", `/api/layers/${encodeURIComponent(layerId)}/status`, { status, reason });
       return result?.layer;
     },
+    listSystemNotes: async (projectId, filters) => {
+      const params = new URLSearchParams();
+      if (filters?.noteType) {
+        const types = Array.isArray(filters.noteType) ? filters.noteType : [filters.noteType];
+        types.forEach((t) => params.append("type", t));
+      }
+      if (filters?.status) params.set("status", filters.status);
+      if (filters?.revisionId) params.set("revisionId", filters.revisionId);
+      if (filters?.excludeChildren) params.set("excludeChildren", "true");
+      if (filters?.significance) params.set("significance", filters.significance);
+      if (filters?.limit !== void 0) params.set("limit", String(filters.limit));
+      const qs = params.toString() ? `?${params.toString()}` : "";
+      const result = await request("GET", `/api/systems/${encodeURIComponent(projectId)}/notes${qs}`);
+      return result?.notes ?? [];
+    },
     listProjectNotes: async (projectId, filters) => {
       const params = new URLSearchParams();
       if (filters?.noteType) {
@@ -32066,6 +32156,14 @@ function createHttpClient(config2) {
       const result = await request("GET", `/api/systems/${encodeURIComponent(projectId)}/revisions/pending${qs}`);
       return result ?? [];
     },
+    listSystemRevisions: async (projectId, options) => {
+      const params = new URLSearchParams();
+      if (options?.status) params.set("status", options.status);
+      if (options?.includeArchived) params.set("includeArchived", "true");
+      const qs = params.toString() ? `?${params.toString()}` : "";
+      const result = await request("GET", `/api/systems/${encodeURIComponent(projectId)}/revisions${qs}`);
+      return result ?? [];
+    },
     listProjectRevisions: async (projectId, options) => {
       const params = new URLSearchParams();
       if (options?.status) params.set("status", options.status);
@@ -32295,6 +32393,14 @@ function createHttpClient(config2) {
     // partitions, but the REST surface is unified per the project-level
     // "avoid nested/duplicate routes" guidance.
     getSession: (sessionId) => request("GET", `/api/sessions/${encodeURIComponent(sessionId)}`),
+    listSystemSessions: async (projectId, options) => {
+      const params = new URLSearchParams();
+      params.set("projectId", projectId);
+      if (options?.status) params.set("status", options.status);
+      if (options?.includeTerminal) params.set("includeTerminal", "true");
+      const result = await request("GET", `/api/sessions?${params.toString()}`);
+      return result ?? [];
+    },
     listProjectSessions: async (projectId, options) => {
       const params = new URLSearchParams();
       params.set("projectId", projectId);
@@ -32482,6 +32588,14 @@ function createHttpClient(config2) {
     getTask: async (taskId) => {
       return request("GET", `/api/tasks/${encodeURIComponent(taskId)}`);
     },
+    listSystemTasks: async (projectId, options) => {
+      const params = new URLSearchParams();
+      if (options?.status) params.set("status", options.status);
+      if (options?.limit) params.set("limit", String(options.limit));
+      const qs = params.toString() ? `?${params.toString()}` : "";
+      const result = await request("GET", `/api/systems/${encodeURIComponent(projectId)}/tasks${qs}`);
+      return result?.tasks ?? [];
+    },
     listProjectTasks: async (projectId, options) => {
       const params = new URLSearchParams();
       if (options?.status) params.set("status", options.status);
@@ -32513,6 +32627,15 @@ function createHttpClient(config2) {
       }, LONG_RUNNING_TIMEOUT_MS);
     },
     // Activity — forward to API endpoint
+    listSystemActivities: async (projectId, options) => {
+      const params = new URLSearchParams();
+      if (options?.limit) params.set("limit", String(options.limit));
+      if (options?.minImportance) params.set("importance", options.minImportance);
+      const qs = params.toString();
+      const path = `/api/systems/${encodeURIComponent(projectId)}/activities${qs ? `?${qs}` : ""}`;
+      const result = await request("GET", path);
+      return { entries: result.activities ?? [], hasMore: false };
+    },
     listProjectActivities: async (projectId, options) => {
       const params = new URLSearchParams();
       if (options?.limit) params.set("limit", String(options.limit));
@@ -32794,8 +32917,8 @@ function createHttpClient(config2) {
       }
       return download;
     },
-    importProjectSnapshot: (snapshot, options) => request("POST", "/api/systems/import", { ...snapshot, importOptions: options }, LONG_RUNNING_TIMEOUT_MS),
-    importProjectSnapshotFromUrl: (url2, options) => request("POST", "/api/systems/import", { snapshotUrl: url2, importOptions: options }, LONG_RUNNING_TIMEOUT_MS),
+    importSystemSnapshot: (snapshot, options) => request("POST", "/api/systems/import", { ...snapshot, importOptions: options }, LONG_RUNNING_TIMEOUT_MS),
+    importSystemSnapshotFromUrl: (url2, options) => request("POST", "/api/systems/import", { snapshotUrl: url2, importOptions: options }, LONG_RUNNING_TIMEOUT_MS),
     // Embedding similarity
     embedProjectEntities: (projectId) => request("POST", `/api/systems/${encodeURIComponent(projectId)}/embeddings/generate`),
     findSimilarNotes: async (noteId, projectId, options) => {
@@ -32861,6 +32984,18 @@ function createHttpClient(config2) {
       const res = await request("GET", `/api/checks/${encodeURIComponent(checkId)}`);
       return res.check;
     },
+    listSystemChecks: async (projectId, checkType, options) => {
+      const params = new URLSearchParams();
+      if (checkType) params.set("type", checkType);
+      if (options?.limit !== void 0) params.set("limit", String(options.limit));
+      if (options?.cursor) params.set("cursor", options.cursor);
+      const qs = params.toString() ? `?${params.toString()}` : "";
+      const res = await request(
+        "GET",
+        `/api/systems/${encodeURIComponent(projectId)}/checks${qs}`
+      );
+      return { checks: res?.checks ?? [], nextCursor: res?.nextCursor };
+    },
     listProjectChecks: async (projectId, checkType, options) => {
       const params = new URLSearchParams();
       if (checkType) params.set("type", checkType);
@@ -32959,6 +33094,11 @@ function createHttpClient(config2) {
       if (res === void 0) throw new Error(`Teamspace ${teamspaceId} not found`);
       return res.deliverableGroups;
     },
+    listSystemDeliverableGroups: async (projectId) => {
+      const res = await request("GET", `/api/systems/${encodeURIComponent(projectId)}/deliverable-groups`);
+      if (res === void 0) throw new Error(`Project ${projectId} not found`);
+      return res.deliverableGroups;
+    },
     listProjectDeliverableGroups: async (projectId) => {
       const res = await request("GET", `/api/systems/${encodeURIComponent(projectId)}/deliverable-groups`);
       if (res === void 0) throw new Error(`Project ${projectId} not found`);
@@ -33138,11 +33278,14 @@ function createHttpClient(config2) {
     },
     // WorkItems (WorkItem exposure layer — owned, statused unit of operational work under a Track)
     createWorkItem: async (input) => {
-      const { trackId, title, owner, committedEstimateHours, createdBy, beatVersionId } = input;
+      const { trackId, title, owner, committedEstimateHours, effortSize, valueUnits, costPerValueUnit, createdBy, beatVersionId } = input;
       const body = {
         title,
-        owner,
+        ...owner !== void 0 && { owner },
         ...committedEstimateHours !== void 0 && { committedEstimateHours },
+        ...effortSize !== void 0 && { effortSize },
+        ...valueUnits !== void 0 && { valueUnits },
+        ...costPerValueUnit !== void 0 && { costPerValueUnit },
         ...createdBy !== void 0 && { createdBy },
         ...beatVersionId !== void 0 && { beatVersionId }
       };
@@ -33685,7 +33828,7 @@ function loadConfig() {
   };
 }
 async function main() {
-  console.error(`[harmonica-mcp] v${"2.0.0"} starting\u2026`);
+  console.error(`[harmonica-mcp] v${"2.1.0"} starting\u2026`);
   const config2 = loadConfig();
   const client = createHttpClient({
     apiBaseUrl: config2.apiBaseUrl,

package/package.json

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