@codazen/harmonica-mcp 1.1.0 → 2.1.0

package/dist/index.js

@@ -22147,22 +22147,22 @@ function registerBarTools(server, _ctx, client) {
 // ../../libs/harmonica-services/src/mcp/tools/baseline-tools.ts
 function registerBaselineTools(server, ctx, client) {
   server.tool(
-    "baseline_project",
-    "Create Rev 1 baseline revisions for all eligible Beats in a project, transition them to live, and run build_quality checks. Returns a taskId to poll for progress. Skips Beats that already have revisions or are archived/deprecated.",
+    "baseline_system",
+    "Create Rev 1 baseline revisions for all eligible Beats in a system, transition them to live, and run build_quality checks. Returns a taskId to poll for progress. Skips Beats that already have revisions or are archived/deprecated.",
     {
-      projectId: external_exports.string().describe("The project ID to baseline"),
+      systemId: external_exports.string().describe("The system ID to baseline"),
       beatIds: external_exports.array(external_exports.string()).optional().describe("Optional: only baseline these specific beat IDs"),
       runChecks: external_exports.boolean().optional().default(true).describe("Whether to run build_quality checks (default: true)"),
       localPath: external_exports.string().optional().describe("Absolute local filesystem path to the repo \u2014 skips git clone and drives revision state from code analysis (requires HARMONICA_ALLOW_LOCAL_REPO=true)")
     },
-    async ({ projectId, beatIds, runChecks, localPath }) => {
+    async ({ systemId, beatIds, runChecks, localPath }) => {
       try {
-        await assertProjectInOrg(client, projectId, ctx.orgId);
-        const task = await client.baselineProject(projectId, { beatIds, runChecks, localPath });
+        await assertProjectInOrg(client, systemId, ctx.orgId);
+        const task = await client.baselineProject(systemId, { beatIds, runChecks, localPath });
         return {
           content: [{
             type: "text",
-            text: `Project baseline started. Job ID: ${task.taskId}
+            text: `System baseline started. Job ID: ${task.taskId}
 
 Poll progress with: get_job_status({ jobId: "${task.taskId}" })`
           }]
@@ -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}`;
         }
@@ -24964,14 +24964,14 @@ ${rows.join("\n\n")}`;
 }
 function registerEmbeddingTools(server, ctx, client) {
   server.tool(
-    "embed_project_entities",
-    "Batch-embed all Notes and Beats in a project. Generates vector embeddings for similarity search. Run this to populate or refresh embeddings.",
+    "embed_system_entities",
+    "Batch-embed all Notes and Beats in a system. Generates vector embeddings for similarity search. Run this to populate or refresh embeddings.",
     {
-      projectId: external_exports.string().describe("The project ID to embed entities for")
+      systemId: external_exports.string().describe("The system ID to embed entities for")
     },
-    async ({ projectId }) => {
-      await assertProjectInOrg(client, projectId, ctx.orgId);
-      const result = await client.embedProjectEntities(projectId);
+    async ({ systemId }) => {
+      await assertProjectInOrg(client, systemId, ctx.orgId);
+      const result = await client.embedProjectEntities(systemId);
       const text = `## Embedding Results
 
 - Embedded: ${result.embedded}
@@ -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(),
@@ -28593,31 +28607,31 @@ function registerOrganizationTools(server, ctx, client) {
     }
   );
   server.tool(
-    "transfer_project",
-    "Transfer a project from its current organization to a different one. The project must belong to the configured organization.",
+    "transfer_system",
+    "Transfer a system from its current organization to a different one. The system must belong to the configured organization.",
     {
-      projectId: external_exports.string().describe("The project ID to transfer"),
+      systemId: external_exports.string().describe("The system ID to transfer"),
       targetOrgId: external_exports.string().describe("The target organization ID")
     },
-    async ({ projectId, targetOrgId }) => {
-      const project = await client.getSystem(projectId);
-      if (!project) {
-        return { content: [{ type: "text", text: `Project not found: ${projectId}` }], isError: true };
+    async ({ systemId, targetOrgId }) => {
+      const system = await client.getSystem(systemId);
+      if (!system) {
+        return { content: [{ type: "text", text: `System not found: ${systemId}` }], isError: true };
       }
-      if (project.orgId !== ctx.orgId) {
-        return { content: [{ type: "text", text: `Project "${projectId}" does not belong to the configured organization.` }], isError: true };
+      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, projectId, targetOrgId);
+      const result = await client.transferProject(ctx.orgId, systemId, targetOrgId);
       if (result.error) {
         return { content: [{ type: "text", text: result.error }], isError: true };
       }
       const transferred = result.project;
       if (!transferred) {
-        return { content: [{ type: "text", text: "Transfer succeeded but project data was not returned." }], isError: true };
+        return { content: [{ type: "text", text: "Transfer succeeded but system data was not returned." }], isError: true };
       }
-      const text = `Project transferred.
+      const text = `System transferred.
 
-**ID:** ${transferred.projectId}
+**System ID:** ${transferred.projectId}
 **Title:** ${transferred.title}
 **New Org:** ${transferred.orgId}`;
       return { content: [{ type: "text", text }] };
@@ -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,313 +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_project_lifecycle",
-    "Advance a Project'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 project-scoped Decision Note (the governance review). Other gates are advisory.",
-    {
-      projectId: external_exports.string().describe("The project 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 ({ projectId, targetState, reason, decisionNoteId }) => {
-      try {
-        const project = await client.getSystem(projectId);
-        if (!project) {
-          return { content: [{ type: "text", text: `Project not found: "${projectId}"` }], isError: true };
-        }
-        if (project.orgId !== ctx.orgId) {
-          return { content: [{ type: "text", text: `Project "${projectId}" is not in this organization` }], isError: true };
-        }
-        const result = await client.transitionProjectLifecycleState(projectId, 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 = [
-          `Project lifecycle transitioned successfully.`,
-          "",
-          `**Project:** ${projectId}`,
-          `**Title:** ${project.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 project 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
-  );
-  server.tool(
-    "list_projects",
-    "[Deprecated \u2014 use list_systems] List all projects in the configured organization",
-    {
-      teamspaceId: external_exports.string().optional().describe("Filter to projects belonging to a specific teamspace. Empty or whitespace-only treated as no filter.")
-    },
-    listSystemsHandler
-  );
-  const getSystemContextSchema = {
-    projectId: 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 ({
-    projectId,
-    noteLimit
-  }) => {
-    try {
-      const [project, org] = await Promise.all([
-        fetchProjectInOrg(client, projectId, ctx.orgId),
-        client.getOrg(ctx.orgId)
-      ]);
-      const notes = await client.listProjectNotes(projectId, {
-        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
-  );
-  server.tool(
-    "get_project_context",
-    "[Deprecated \u2014 use get_system_context] Get project metadata, description, and notes in one view",
-    { projectId: external_exports.string().describe("The project ID") },
-    getSystemContextHandler
-  );
-  const updateSystemSchema = {
-    projectId: 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 ({ projectId, ...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, projectId, 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(projectId, nonEmpty);
-      if (!updated) {
-        return { content: [{ type: "text", text: `System not found: "${projectId}"` }], isError: true };
-      }
-      if (PROJECT_EMBEDDING_FIELDS.some((f) => f in nonEmpty)) {
-        void client.triggerProjectEmbedding(projectId);
-      }
-      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(
-    "update_project",
-    "[Deprecated \u2014 use update_system] Update project settings such as title, description, or repository configuration",
-    {
-      projectId: external_exports.string().describe("The project ID"),
-      title: external_exports.string().optional().describe("New project title"),
-      description: external_exports.string().optional().describe("New project description"),
-      strategy: external_exports.string().optional().describe('Project strategy markdown \u2014 Org Strategy + Project Strategy ("Project Coda")'),
-      teamspaceId: external_exports.string().nullable().optional().describe("Teamspace ID to associate this project with; pass null to remove the association"),
-      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.')
-    },
-    updateSystemHandler
-  );
-  server.tool(
-    "archive_project",
-    "Archive a project, hiding it from the project dropdown and all active project views. Use this when a project is no longer active and should be removed from navigation.",
-    { projectId: external_exports.string().describe("The project ID to archive") },
-    async ({ projectId }) => {
-      const project = await client.getSystem(projectId);
-      if (!project) {
-        return { content: [{ type: "text", text: `Project not found: "${projectId}"` }], isError: true };
-      }
-      if (project.orgId !== ctx.orgId) {
-        return { content: [{ type: "text", text: `Project "${projectId}" is not in this organization` }], isError: true };
-      }
-      try {
-        const updated = await client.archiveSystem(projectId);
-        if (!updated) {
-          return { content: [{ type: "text", text: `Project not found: "${projectId}"` }], isError: true };
-        }
-        return {
-          content: [{
-            type: "text",
-            text: [
-              "Project 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 project: ${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);
-  server.tool(
-    "create_project",
-    "[Deprecated \u2014 use create_system] Create a new project in the configured organization",
-    {
-      title: external_exports.string().describe("Project title"),
-      description: external_exports.string().optional().describe("Project description"),
-      strategy: external_exports.string().optional().describe('Project strategy markdown \u2014 Org Strategy + Project Strategy ("Project Coda")'),
-      teamspaceId: external_exports.string().optional().describe("Teamspace ID to associate this project 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")')
-    },
-    createSystemHandler
-  );
-}
-
 // ../../libs/harmonica-services/src/mcp/tools/pulse-report-tools.ts
 function formatBeatRow(r) {
   const downbeatState = r.hasDownbeat ? "" : " \u2014 no Downbeat ever set";
@@ -29818,21 +29525,21 @@ function registerSessionTools(server, ctx, client) {
     }
   );
   server.tool(
-    "list_project_sessions",
-    'List agent Sessions in a project, optionally filtered by status or whether terminal sessions are included. Use this to answer "show me sessions in this project" or to find recent runs across all beats.',
+    "list_system_sessions",
+    'List agent Sessions in a system, optionally filtered by status or whether terminal sessions are included. Use this to answer "show me sessions in this system" or to find recent runs across all beats.',
     {
-      projectId: external_exports.string().min(1).describe("The project ID"),
+      systemId: external_exports.string().min(1).describe("The system ID"),
       status: external_exports.enum(SESSION_STATUSES).optional().describe("Filter by status: active, idle, or closed"),
       includeTerminal: external_exports.boolean().optional().describe("Include terminal (closed) sessions. Default false.")
     },
-    async ({ projectId, status, includeTerminal }) => {
-      const sessions = await client.listProjectSessions(projectId, {
+    async ({ systemId, status, includeTerminal }) => {
+      const sessions = await client.listProjectSessions(systemId, {
         status,
         includeTerminal
       });
       return {
         content: [
-          { type: "text", text: formatSessionList(sessions, `project ${projectId}`) }
+          { type: "text", text: formatSessionList(sessions, `system ${systemId}`) }
         ]
       };
     }
@@ -30062,18 +29769,18 @@ 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) {
   server.tool(
-    "export_project_snapshot",
-    "Export a complete project 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.",
-    { projectId: external_exports.string().describe("The project ID to export") },
-    async ({ projectId }) => {
-      await assertProjectInOrg(client, projectId, ctx.orgId);
-      const result = await client.exportProjectSnapshot(projectId);
+    "export_system_snapshot",
+    "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);
+      const result = await client.exportProjectSnapshot(systemId);
       if (typeof result === "string") {
         if (!result.startsWith("https://")) {
           throw new Error(`exportProjectSnapshot returned an unexpected string value (expected an https:// presigned URL): ${result.slice(0, 80)}`);
@@ -30082,7 +29789,7 @@ function registerSnapshotTools(server, ctx, client) {
           content: [{
             type: "text",
             text: [
-              "Snapshot exported to S3. Pass this URL to import_project_snapshot on the target environment:",
+              "Snapshot exported to S3. Pass this URL to import_system_snapshot on the target environment:",
               "",
               result,
               "",
@@ -30092,10 +29799,10 @@ function registerSnapshotTools(server, ctx, client) {
         };
       }
       const snapshot = normalizeSnapshot(result);
-      const filename = `harmonica-snapshot-${projectId}-${Date.now()}.json`;
+      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 ?? projectId;
+      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}`,
@@ -30110,15 +29817,19 @@ 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_project_snapshot with this file path to import into another environment."
+        "Use import_system_snapshot with this file path to import into another environment."
       ];
       return { content: [{ type: "text", text: summary.join("\n") }] };
     }
   );
   server.tool(
-    "import_project_snapshot",
-    "Import a project snapshot into the current environment. Accepts an S3 presigned URL (https:// only), a file path, or inline JSON. Blocked in production by default.",
+    "import_system_snapshot",
+    "Import a system snapshot into the current environment. Accepts an S3 presigned URL (https:// only), a file path, or inline JSON. Blocked in production by default.",
     {
       snapshot: external_exports.string().describe("S3 presigned URL (https://...), file path, or inline JSON string"),
       targetTeamspaceId: external_exports.string().min(1).optional().describe(
@@ -30127,12 +29838,12 @@ function registerSnapshotTools(server, ctx, client) {
     },
     async ({ snapshot: snapshotInput, targetTeamspaceId }) => {
       const isProduction = process.env.NODE_ENV === "production";
-      const importAllowed = process.env.ALLOW_PROJECT_IMPORT === "true";
+      const importAllowed = process.env.ALLOW_SYSTEM_IMPORT === "true";
       if (isProduction && !importAllowed) {
         return {
           content: [{
             type: "text",
-            text: "Import is disabled in production. Set ALLOW_PROJECT_IMPORT=true to override."
+            text: "Import is disabled in production. Set ALLOW_SYSTEM_IMPORT=true to override."
           }],
           isError: true
         };
@@ -30143,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://")) {
@@ -30158,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 ?? [],
@@ -30185,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) {
@@ -30203,7 +29931,7 @@ async function resolveSnapshotInput(input) {
 }
 function formatImportSummary(result, targetTeamspaceId) {
   const lines = [
-    `Imported project: ${result.projectId}`,
+    `Imported system: ${result.projectId}`,
     `  Beats: ${result.counts.beats}`,
     `  Proposals: ${result.counts.proposals}`,
     `  Revisions: ${result.counts.revisions}`,
@@ -30214,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}):`);
@@ -30261,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.`);
   }
 }
 
@@ -30343,13 +30075,276 @@ function registerSubscriptionTools(server, ctx, client) {
   );
 }
 
-// ../../libs/harmonica-services/src/mcp/tools/teamspace-tools.ts
-var import_node_crypto3 = require("node:crypto");
-var EnsembleMemberSchema = external_exports.discriminatedUnion("type", [
-  external_exports.object({ type: external_exports.literal("human"), email: external_exports.string().email().max(254), name: external_exports.string().min(1).max(200) }),
-  external_exports.object({ type: external_exports.literal("agent"), agentId: external_exports.string().min(1).max(100), name: external_exports.string().min(1).max(200) })
-]);
-function generateTeamspaceSlug(name) {
+// ../../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(
+    "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/teamspace-tools.ts
+var import_node_crypto3 = require("node:crypto");
+var EnsembleMemberSchema = external_exports.discriminatedUnion("type", [
+  external_exports.object({ type: external_exports.literal("human"), email: external_exports.string().email().max(254), name: external_exports.string().min(1).max(200) }),
+  external_exports.object({ type: external_exports.literal("agent"), agentId: external_exports.string().min(1).max(100), name: external_exports.string().min(1).max(200) })
+]);
+function generateTeamspaceSlug(name) {
   return name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 60);
 }
 function formatEnsembleMember(member) {
@@ -30547,19 +30542,19 @@ function registerValueVelocityTools(server, ctx, client) {
     }
   );
   server.tool(
-    "list_project_beat_versions_ranked",
-    "Rank all Beat Versions in a project by Value Velocity score. Only Beat Versions with confirmed inputs appear. Results are sorted descending by chosen score. Use this to prioritize work or surface the highest-impact items first.",
+    "list_system_beat_versions_ranked",
+    "Rank all Beat Versions in a system by Value Velocity score. Only Beat Versions with confirmed inputs appear. Results are sorted descending by chosen score. Use this to prioritize work or surface the highest-impact items first.",
     {
-      projectId: external_exports.string().describe("The project ID"),
+      systemId: external_exports.string().describe("The system ID"),
       lens: lensSchema.describe("Scoring lens: velocity | roi | valuePrimary (default: velocity)"),
       withLeverage: external_exports.boolean().optional().describe("Include cascade leverage scores (v2). Default: false.")
     },
-    async ({ projectId, lens, withLeverage }) => {
+    async ({ systemId, lens, withLeverage }) => {
       try {
-        await assertProjectInOrg(client, projectId, ctx.orgId);
+        await assertProjectInOrg(client, systemId, ctx.orgId);
         const [rankedResult, staleWResult] = await Promise.allSettled([
-          withLeverage ? client.rankProjectBeatVersionsWithLeverage(projectId, lens) : client.rankProjectBeatVersions(projectId, lens),
-          client.getStaleWBeatIds(projectId)
+          withLeverage ? client.rankProjectBeatVersionsWithLeverage(systemId, lens) : client.rankProjectBeatVersions(systemId, lens),
+          client.getStaleWBeatIds(systemId)
         ]);
         if (rankedResult.status === "rejected") {
           const msg = rankedResult.reason instanceof Error ? rankedResult.reason.message : String(rankedResult.reason);
@@ -30571,7 +30566,7 @@ function registerValueVelocityTools(server, ctx, client) {
           return { content: [{ type: "text", text: "No Beat Versions with confirmed Value Velocity inputs found." }] };
         }
         const lines = [
-          `Ranked Beat Versions for project ${projectId} (lens: ${lens}):`,
+          `Ranked Beat Versions for system ${systemId} (lens: ${lens}):`,
           "",
           withLeverage ? "| Rank | Beat Version | Title | Chosen Score | Leverage Score |" : "| Rank | Beat Version | Title | Chosen Score |",
           withLeverage ? "|------|-------------|-------|-------------|----------------|" : "|------|-------------|-------|-------------|"
@@ -30798,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",
@@ -30835,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,
@@ -30850,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 }
       });
@@ -30877,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 {
@@ -30895,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}` }],
@@ -30905,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) {
@@ -31371,7 +31402,7 @@ var TOOL_PROFILES = Object.freeze({
   // Copilot's orchestrator degrades with large tool sets, so each module is trimmed
   // to its query tools; create_note is the single write action.
   "copilot": Object.freeze([
-    allow(registerProjectTools, ["list_systems", "get_system_context", "list_projects", "get_project_context"]),
+    allow(registerProjectTools, ["list_systems", "get_system_context"]),
     allow(registerBeatTools, ["list_beats", "get_beat", "list_revisions", "get_revision"]),
     allow(registerBeatVersionTools, ["list_beat_versions", "get_beat_version"]),
     allow(registerNoteTools, ["list_notes", "get_note", "create_note", "list_documents"]),
@@ -31452,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 }] };
     }
@@ -31486,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",
@@ -31494,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 }] };
     }
@@ -31815,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,
@@ -31971,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) {
@@ -32110,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);
@@ -32339,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);
@@ -32526,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);
@@ -32557,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));
@@ -32838,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) => {
@@ -32905,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);
@@ -33003,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`);
@@ -33182,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 }
       };
@@ -33729,7 +33828,7 @@ function loadConfig() {
   };
 }
 async function main() {
-  console.error(`[harmonica-mcp] v${"1.1.0"} starting\u2026`);
+  console.error(`[harmonica-mcp] v${"2.1.0"} starting\u2026`);
   const config2 = loadConfig();
   const client = createHttpClient({
     apiBaseUrl: config2.apiBaseUrl,