@codazen/harmonica-mcp 1.1.0 → 2.0.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}" })`
           }]
@@ -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}
@@ -28593,31 +28593,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 }] };
@@ -28970,10 +28970,10 @@ 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.",
+    "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.",
     {
-      projectId: external_exports.string().describe("The project ID"),
+      systemId: external_exports.string().describe("The system ID"),
       targetState: external_exports.enum([
         "concept",
         "incubating",
@@ -28989,16 +28989,16 @@ function registerProjectLifecycleTools(server, ctx, client) {
       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 }) => {
+    async ({ systemId, targetState, reason, decisionNoteId }) => {
       try {
-        const project = await client.getSystem(projectId);
-        if (!project) {
-          return { content: [{ type: "text", text: `Project not found: "${projectId}"` }], isError: true };
+        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}" is not in this organization` }], 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(projectId, targetState, {
+        const result = await client.transitionProjectLifecycleState(systemId, targetState, {
           actor: { type: "human", id: ctx.user.userId, name: ctx.user.name },
           reason,
           decisionNoteId
@@ -29011,10 +29011,10 @@ function registerProjectLifecycleTools(server, ctx, client) {
           };
         }
         const lines = [
-          `Project lifecycle transitioned successfully.`,
+          `System lifecycle transitioned successfully.`,
           "",
-          `**Project:** ${projectId}`,
-          `**Title:** ${project.title}`,
+          `**System:** ${systemId}`,
+          `**Title:** ${system.title}`,
           `**Transition:** ${result.previousState} \u2192 ${result.newState}`
         ];
         if (reason) lines.push(`**Reason:** ${reason}`);
@@ -29022,7 +29022,7 @@ function registerProjectLifecycleTools(server, ctx, client) {
         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 };
+        return { content: [{ type: "text", text: `Failed to transition system lifecycle: ${message}` }], isError: true };
       }
     }
   );
@@ -29057,30 +29057,22 @@ function registerProjectTools(server, ctx, client) {
     },
     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"),
+    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 ({
-    projectId,
+    systemId,
     noteLimit
   }) => {
     try {
       const [project, org] = await Promise.all([
-        fetchProjectInOrg(client, projectId, ctx.orgId),
+        fetchProjectInOrg(client, systemId, ctx.orgId),
         client.getOrg(ctx.orgId)
       ]);
-      const notes = await client.listProjectNotes(projectId, {
+      const notes = await client.listProjectNotes(systemId, {
         limit: noteLimit ?? DEFAULT_CONTEXT_NOTE_LIMIT
       });
       const text = formatProjectContext(project, notes, org?.coda);
@@ -29096,14 +29088,8 @@ function registerProjectTools(server, ctx, client) {
     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"),
+    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")'),
@@ -29114,7 +29100,7 @@ function registerProjectTools(server, ctx, client) {
     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 }) => {
+  const updateSystemHandler = async ({ systemId, ...updates }) => {
     try {
       const nonEmpty = Object.fromEntries(
         Object.entries(updates).filter(([, v]) => v !== void 0)
@@ -29122,7 +29108,7 @@ function registerProjectTools(server, ctx, client) {
       if (Object.keys(nonEmpty).length === 0) {
         return { content: [{ type: "text", text: "No updates provided." }], isError: true };
       }
-      await assertProjectInOrg(client, projectId, ctx.orgId);
+      await assertProjectInOrg(client, systemId, ctx.orgId);
       if (nonEmpty["accountId"] === "") nonEmpty["accountId"] = null;
       if (typeof updates.teamspaceId === "string") {
         const teamspace = await client.getTeamspace(updates.teamspaceId);
@@ -29133,12 +29119,12 @@ function registerProjectTools(server, ctx, client) {
           return { content: [{ type: "text", text: "Teamspace does not belong to this organization" }], isError: true };
         }
       }
-      const updated = await client.updateSystem(projectId, nonEmpty);
+      const updated = await client.updateSystem(systemId, nonEmpty);
       if (!updated) {
-        return { content: [{ type: "text", text: `System not found: "${projectId}"` }], isError: true };
+        return { content: [{ type: "text", text: `System not found: "${systemId}"` }], isError: true };
       }
       if (PROJECT_EMBEDDING_FIELDS.some((f) => f in nonEmpty)) {
-        void client.triggerProjectEmbedding(projectId);
+        void client.triggerProjectEmbedding(systemId);
       }
       const lines = [
         `System updated successfully.`,
@@ -29158,43 +29144,27 @@ function registerProjectTools(server, ctx, client) {
   };
   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 };
+    "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 (project.orgId !== ctx.orgId) {
-        return { content: [{ type: "text", text: `Project "${projectId}" is not in this organization` }], 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(projectId);
+        const updated = await client.archiveSystem(systemId);
         if (!updated) {
-          return { content: [{ type: "text", text: `Project not found: "${projectId}"` }], isError: true };
+          return { content: [{ type: "text", text: `System not found: "${systemId}"` }], isError: true };
         }
         return {
           content: [{
             type: "text",
             text: [
-              "Project archived successfully.",
+              "System archived successfully.",
               "",
               `**ID:** ${updated.projectId}`,
               `**Title:** ${updated.title}`,
@@ -29204,7 +29174,7 @@ function registerProjectTools(server, ctx, client) {
         };
       } catch (err) {
         const message = err instanceof Error ? err.message : String(err);
-        return { content: [{ type: "text", text: `Failed to archive project: ${message}` }], isError: true };
+        return { content: [{ type: "text", text: `Failed to archive system: ${message}` }], isError: true };
       }
     }
   );
@@ -29258,20 +29228,6 @@ function registerProjectTools(server, ctx, client) {
     }
   };
   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
@@ -29818,21 +29774,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}`) }
         ]
       };
     }
@@ -30068,12 +30024,12 @@ var SNAPSHOT_VERSION = 2;
 // ../../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 +30038,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 +30048,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.project?.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}`,
@@ -30111,14 +30067,14 @@ function registerSnapshotTools(server, ctx, client) {
         `  Drops: ${snapshot.drops?.length ?? 0}`,
         `  Deliverables: ${snapshot.deliverables?.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 +30083,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
         };
@@ -30203,7 +30159,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}`,
@@ -30547,19 +30503,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 +30527,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 ? "|------|-------------|-------|-------------|----------------|" : "|------|-------------|-------|-------------|"
@@ -31371,7 +31327,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"]),
@@ -33729,7 +33685,7 @@ function loadConfig() {
   };
 }
 async function main() {
-  console.error(`[harmonica-mcp] v${"1.1.0"} starting\u2026`);
+  console.error(`[harmonica-mcp] v${"2.0.0"} starting\u2026`);
   const config2 = loadConfig();
   const client = createHttpClient({
     apiBaseUrl: config2.apiBaseUrl,

package/package.json

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