@codazen/harmonica-mcp 3.9.3 → 4.0.0

package/dist/index.js

@@ -22459,8 +22459,9 @@ function registerBeatPlanningTools(server, ctx, client) {
 
 // ../../libs/harmonica-services/src/mcp/check.constants.ts
 var CHECK_MAX_SCORES = {
+  coda_quality: 5,
+  // Legacy names for coda_quality — kept until every caller passes the new name (N-4E09-6779).
   beat_coda_quality: 5,
-  // Legacy name for beat_coda_quality — kept until every caller passes the new name (N-4E09-6779).
   beat_quality: 5,
   beat_version_quality: 5,
   // Legacy name for beat_version_quality — kept until every caller passes the new name.
@@ -22514,7 +22515,7 @@ ${d.rationale}${d.suggestions?.length ? `
   ).join("\n\n");
   return [
     `## Beat Coda Quality Check \u2014 ${check2.targetId}`,
-    `**Overall Score:** ${check2.overallScore}/${CHECK_MAX_SCORES.beat_coda_quality}`,
+    `**Overall Score:** ${check2.overallScore}/${CHECK_MAX_SCORES.coda_quality}`,
     `**Summary:** ${check2.summary}`,
     check2.topSuggestion ? `**Top Suggestion:** ${check2.topSuggestion}` : "",
     "",
@@ -22550,20 +22551,22 @@ Use get_job_status with jobId="${taskId}" to poll for results, or list_checks to
     }
   };
   server.tool(
-    "check_beat_coda_quality",
-    "Enqueue a Beat definition quality check across 7 dimensions (Distinctive, Harmonious, Substantial, Durable, Clear, Strategically Aligned, Outcome-Oriented) \u2014 grades the Beat's Coda and directing context, persisted as beat_coda_quality. By default returns a jobId immediately (fire-and-forget) \u2014 use get_job_status or list_checks to retrieve results. Set wait=true to block until the check completes and receive the scorecard inline. WARNING: wait=true holds the MCP session open for 30\u201360s per check \u2014 for bulk operations (more than one Beat), omit wait and poll get_job_status separately to avoid session exhaustion.",
+    "check_coda_quality",
+    "Enqueue a Coda quality check across 7 dimensions (Distinctive, Harmonious, Substantial, Durable, Clear, Strategically Aligned, Outcome-Oriented) \u2014 grades the Beat's Coda and directing context, persisted as coda_quality. By default returns a jobId immediately (fire-and-forget) \u2014 use get_job_status or list_checks to retrieve results. Set wait=true to block until the check completes and receive the scorecard inline. WARNING: wait=true holds the MCP session open for 30\u201360s per check \u2014 for bulk operations (more than one Beat), omit wait and poll get_job_status separately to avoid session exhaustion.",
     schema,
     handler
   );
-  server.tool(
-    "check_beat_quality",
-    "DEPRECATED \u2014 renamed to check_beat_coda_quality (the check grades the Beat's definition: its Coda and directing context). This alias runs the same check and persists it as beat_coda_quality. Prefer check_beat_coda_quality.",
-    schema,
-    async (args) => {
-      console.warn("[deprecated-tool] check_beat_quality invoked \u2014 use check_beat_coda_quality (N-4E09-6779)");
-      return handler(args);
-    }
-  );
+  for (const legacyName of ["check_beat_coda_quality", "check_beat_quality"]) {
+    server.tool(
+      legacyName,
+      `DEPRECATED \u2014 renamed to check_coda_quality (one instrument scores any Coda that has a parent, so the name no longer states an altitude). This alias runs the same check and persists it as coda_quality. Prefer check_coda_quality.`,
+      schema,
+      async (args) => {
+        console.warn(`[deprecated-tool] ${legacyName} invoked \u2014 use check_coda_quality (N-4E09-6779)`);
+        return handler(args);
+      }
+    );
+  }
 }
 
 // ../../libs/harmonica-services/src/mcp/tools/beat-reframe-tools.ts
@@ -23562,9 +23565,9 @@ function registerBeatVersionTools(server, ctx, client) {
   );
   server.tool(
     "plan_beat_versions",
-    "Agent-decompose a composed Beat into 2-5 planning-state Beat Versions on the path to the Coda. Uses the Beat's Coda, project strategy, sibling Beats, Notes, and codebase grep as context. Requires a recent passing beat_coda_quality check (run check_beat_coda_quality first if needed). Idempotent: refuses when planned BVs already exist on the Beat unless force=true is set.",
+    "Agent-decompose a composed Beat into 2-5 planning-state Beat Versions on the path to the Coda. Uses the Beat's Coda, project strategy, sibling Beats, Notes, and codebase grep as context. Requires a recent passing coda_quality check (run check_coda_quality first if needed). Idempotent: refuses when planned BVs already exist on the Beat unless force=true is set.",
     {
-      beatId: external_exports.string().describe("The Beat ID to decompose (must have a Coda and a passing beat_coda_quality check)"),
+      beatId: external_exports.string().describe("The Beat ID to decompose (must have a Coda and a passing coda_quality check)"),
       force: external_exports.boolean().optional().describe("Bypass the idempotency guard and plan additional Beat Versions even when prior planned BVs are still active")
     },
     async ({ beatId, force }) => {
@@ -23823,7 +23826,7 @@ function registerCheckTools(server, ctx, client) {
       beatId: external_exports.string().optional().describe("List checks for this specific beat"),
       beatVersionId: external_exports.string().optional().describe("List checks for this specific beat version"),
       revisionId: external_exports.string().optional().describe("List checks for this specific revision"),
-      checkType: external_exports.enum(["beat_coda_quality", "beat_quality", "beat_version_quality", "plan_quality", "build_quality", "pii_scan", "portfolio_coherence"]).optional().describe("Filter by check type. beat_quality is the DEPRECATED alias of beat_coda_quality. plan_quality is the DEPRECATED alias of beat_version_quality. pii_scan is RETIRED from the taxonomy (PII detection moved to the Scan family, N-4E09-6809) \u2014 it is still accepted here so historical records stay readable, but no new pii_scan checks are written.")
+      checkType: external_exports.enum(["coda_quality", "beat_coda_quality", "beat_quality", "beat_version_quality", "plan_quality", "build_quality", "pii_scan", "portfolio_coherence"]).optional().describe("Filter by check type. beat_coda_quality and beat_quality are DEPRECATED aliases of coda_quality. plan_quality is the DEPRECATED alias of beat_version_quality. pii_scan is RETIRED from the taxonomy (PII detection moved to the Scan family, N-4E09-6809) \u2014 it is still accepted here so historical records stay readable, but no new pii_scan checks are written.")
     },
     async ({ systemId, beatId, beatVersionId, revisionId, checkType }) => {
       try {
@@ -23950,10 +23953,10 @@ function registerCheckTools(server, ctx, client) {
   );
   server.tool(
     "run_check",
-    "Run a check on a Beat or Beat Version. beat_coda_quality: 7-dimension Beat definition quality (1-5) \u2014 grades the Coda and directing context, target a beatId (beat_quality is its DEPRECATED alias and persists under the new name). beat_version_quality: 7-dimension plan quality (1-5) including completeness, target a Beat Version (bv-*) \u2014 plan_quality is its DEPRECATED alias. build_quality: 9-dimension engineering assessment (1-5), target a Beat Version (bv-*) \u2014 build_quality moved from the Revision to the Beat Version, so it grades the planned capability against the codebase and runs even when the Beat Version has no Revisions yet.",
+    "Run a check on a Beat or Beat Version. coda_quality: 7-dimension Coda quality (1-5) \u2014 grades the Coda and directing context, target a beatId (beat_coda_quality and beat_quality are DEPRECATED aliases and persist under the new name). beat_version_quality: 7-dimension plan quality (1-5) including completeness, target a Beat Version (bv-*) \u2014 plan_quality is its DEPRECATED alias. build_quality: 9-dimension engineering assessment (1-5), target a Beat Version (bv-*) \u2014 build_quality moved from the Revision to the Beat Version, so it grades the planned capability against the codebase and runs even when the Beat Version has no Revisions yet.",
     {
-      checkType: external_exports.enum(["beat_coda_quality", "beat_quality", "beat_version_quality", "plan_quality", "build_quality"]).describe("Type of check to run. beat_quality is the deprecated alias of beat_coda_quality. plan_quality is the deprecated alias of beat_version_quality."),
-      targetId: external_exports.string().describe("The target entity ID \u2014 a beatId for beat_coda_quality, or a Beat Version ID (bv-*) for beat_version_quality and build_quality"),
+      checkType: external_exports.enum(["coda_quality", "beat_coda_quality", "beat_quality", "beat_version_quality", "plan_quality", "build_quality"]).describe("Type of check to run. beat_coda_quality and beat_quality are deprecated aliases of coda_quality. plan_quality is the deprecated alias of beat_version_quality."),
+      targetId: external_exports.string().describe("The target entity ID \u2014 a beatId for coda_quality, or a Beat Version ID (bv-*) for beat_version_quality and build_quality"),
       systemId: external_exports.string().describe("The system ID"),
       branch: external_exports.string().optional().describe("Override the git branch for code checks (default: system default branch)"),
       localPath: external_exports.string().optional().describe("Absolute path to an already-cloned local copy of the repo \u2014 skips git clone entirely (useful for large repos or offline use)")
@@ -23984,6 +23987,7 @@ function registerCheckTools(server, ctx, client) {
   );
 }
 var CHECK_TYPE_DISPLAY = {
+  coda_quality: "Coda Quality",
   beat_coda_quality: "Coda Quality",
   beat_quality: "Coda Quality",
   beat_version_quality: "Beat Version Quality",
@@ -26722,7 +26726,7 @@ var ActivitiesResponseSchema = external_exports.object({
   hasMore: external_exports.boolean(),
   nextCursor: external_exports.string().optional()
 }).passthrough();
-var NotificationSchema2 = external_exports.object({
+var NotificationSchema2 = external_exports.preprocess(normalizeSystemId, external_exports.object({
   notificationId: external_exports.string(),
   action: external_exports.string(),
   title: external_exports.string(),
@@ -26737,13 +26741,50 @@ var NotificationSchema2 = external_exports.object({
   actorType: external_exports.enum(["user", "system"]),
   actorId: external_exports.string().optional(),
   actorName: external_exports.string().optional()
-}).passthrough();
+}).passthrough());
 var NotificationsResponseSchema = external_exports.object({
   notifications: external_exports.array(NotificationSchema2),
   hasMore: external_exports.boolean().optional(),
   nextCursor: external_exports.string().optional()
 }).passthrough();
 var UnreadCountResponseSchema = external_exports.object({ count: external_exports.number() }).passthrough();
+var InboxItemStatusSchema = external_exports.enum([
+  "new",
+  "acknowledged",
+  "needs_agent",
+  "delegated",
+  "answered",
+  "resolved",
+  "expired"
+]);
+var InboxItemPrioritySchema = external_exports.enum(["low", "normal", "high", "urgent"]);
+var InboxSourceChannelSchema = external_exports.enum(["harmonica", "slack", "teams", "email", "api"]);
+var InboxRequestedBySchema = external_exports.object({
+  actorType: external_exports.enum(["agent", "user", "system"]),
+  actorId: external_exports.string(),
+  actorName: external_exports.string().optional()
+}).passthrough();
+var InboxItemSchema = external_exports.object({
+  inboxItemId: external_exports.string(),
+  systemId: external_exports.string(),
+  assigneeId: external_exports.string(),
+  threadId: external_exports.string(),
+  body: external_exports.string(),
+  status: InboxItemStatusSchema,
+  priority: InboxItemPrioritySchema,
+  sourceChannel: InboxSourceChannelSchema,
+  dueAt: external_exports.string().optional(),
+  delegatedSessionId: external_exports.string().optional(),
+  requestedBy: InboxRequestedBySchema,
+  answer: external_exports.string().optional(),
+  createdAt: external_exports.string(),
+  updatedAt: external_exports.string()
+}).passthrough();
+var InboxItemsResponseSchema = external_exports.object({
+  items: external_exports.array(InboxItemSchema),
+  hasMore: external_exports.boolean(),
+  nextCursor: external_exports.string().optional()
+}).passthrough();
 var TriageActionSchema = external_exports.preprocess(
   normalizeSystemId,
   external_exports.object({
@@ -28694,7 +28735,7 @@ var OnboardingNoteInputSchema = external_exports.object({
   rationale: external_exports.string().optional(),
   confidence: external_exports.number().min(0).max(1).optional()
 });
-var OnboardingProjectInputSchema = external_exports.object({
+var OnboardingSystemInputSchema = external_exports.object({
   title: external_exports.string().min(1).max(300),
   description: external_exports.string().max(2e3).optional(),
   notes: external_exports.array(OnboardingNoteInputSchema).optional()
@@ -28804,7 +28845,7 @@ function registerOnboardingTools(server, ctx, client) {
     ].join(" "),
     {
       teamspaceName: external_exports.string().min(1).max(200).describe("Teamspace display name"),
-      projects: external_exports.array(OnboardingProjectInputSchema).min(1).describe("Phase 1 systems to create, each linked to the Teamspace"),
+      projects: external_exports.array(OnboardingSystemInputSchema).min(1).describe("Phase 1 systems to create, each linked to the Teamspace"),
       teamspaceNotes: external_exports.array(OnboardingNoteInputSchema).describe("Constraints, assumptions, and context notes at the Teamspace/system level")
     },
     async ({
@@ -32801,12 +32842,12 @@ function createHttpClient(config2) {
         return { error: String(err) };
       }
     },
-    transferSystem: async (sourceOrgId, projectId, targetOrgId) => {
+    transferSystem: async (sourceOrgId, systemId, targetOrgId) => {
       try {
         const result = await request(
           "POST",
           `/api/organizations/${encodeURIComponent(sourceOrgId)}/transfer-project`,
-          { systemId: projectId, targetOrgId }
+          { systemId, targetOrgId }
         );
         const system = result?.system ? {
           ...result.system,
@@ -32825,8 +32866,8 @@ function createHttpClient(config2) {
       const raw = await request("GET", `/api/organizations/${encodeURIComponent(orgId)}/systems/summaries`);
       return (raw ?? []).map((p) => ({ ...p, systemId: p.id, projectId: p.id, title: p.name, orgId: p.organizationId }));
     },
-    getSystem: async (projectId) => {
-      const raw = await request("GET", `/api/systems/${encodeURIComponent(projectId)}`);
+    getSystem: async (systemId) => {
+      const raw = await request("GET", `/api/systems/${encodeURIComponent(systemId)}`);
       if (!raw) return void 0;
       return {
         ...raw,
@@ -32848,35 +32889,35 @@ function createHttpClient(config2) {
       });
       return { ...raw, systemId: raw?.id ?? raw?.systemId ?? raw?.projectId, title: raw?.name ?? raw?.title, orgId: raw?.organizationId ?? raw?.orgId };
     },
-    updateSystem: async (projectId, updates) => {
-      const raw = await request("PATCH", `/api/systems/${encodeURIComponent(projectId)}`, updates);
+    updateSystem: async (systemId, updates) => {
+      const raw = await request("PATCH", `/api/systems/${encodeURIComponent(systemId)}`, updates);
       if (!raw) return void 0;
       return { ...raw, systemId: raw.id ?? raw.systemId ?? raw.projectId, title: raw.name ?? raw.title, orgId: raw.organizationId ?? raw.orgId };
     },
-    archiveSystem: async (projectId) => {
-      const raw = await request("PATCH", `/api/systems/${encodeURIComponent(projectId)}/archive`);
+    archiveSystem: async (systemId) => {
+      const raw = await request("PATCH", `/api/systems/${encodeURIComponent(systemId)}/archive`);
       if (!raw) return void 0;
       return { ...raw, systemId: raw.id ?? raw.systemId ?? raw.projectId, title: raw.name ?? raw.title, orgId: raw.organizationId ?? raw.orgId };
     },
-    getSystemFact: async (projectId) => {
-      const result = await request("GET", `/api/systems/${encodeURIComponent(projectId)}/facts`);
+    getSystemFact: async (systemId) => {
+      const result = await request("GET", `/api/systems/${encodeURIComponent(systemId)}/facts`);
       return result?.data;
     },
     saveSystemFact: (input) => request("PUT", `/api/systems/${encodeURIComponent(String(input.projectId))}/facts`, input),
-    transitionSystemLifecycleState: async (projectId, targetState, options) => {
-      return request("POST", `/api/systems/${encodeURIComponent(projectId)}/lifecycle/transitions`, {
+    transitionSystemLifecycleState: async (systemId, targetState, options) => {
+      return request("POST", `/api/systems/${encodeURIComponent(systemId)}/lifecycle/transitions`, {
         targetState,
         reason: options.reason,
         decisionNoteId: options.decisionNoteId
       });
     },
     // Beats
-    getNextBeatId: async (projectId) => {
-      const result = await request("POST", `/api/systems/${encodeURIComponent(projectId)}/beats/next-id`);
+    getNextBeatId: async (systemId) => {
+      const result = await request("POST", `/api/systems/${encodeURIComponent(systemId)}/beats/next-id`);
       return result.beatId;
     },
-    listSystemBeats: async (projectId) => {
-      const result = await request("GET", `/api/systems/${encodeURIComponent(projectId)}/beats`);
+    listSystemBeats: async (systemId) => {
+      const result = await request("GET", `/api/systems/${encodeURIComponent(systemId)}/beats`);
       return (result?.beats ?? []).map((b) => ({
         ...b,
         beatId: b.beatId ?? b.id,
@@ -32889,38 +32930,38 @@ function createHttpClient(config2) {
       if (!raw) return void 0;
       return { ...raw, beatId: raw.beatId ?? raw.id, projectId: raw.projectId ?? raw.systemId, status: raw.status ?? "open", beatStatus: coerceBeatStatusLocal(raw.beatStatus) };
     },
-    getBeatConvergence: async (projectId, beatId) => {
+    getBeatConvergence: async (systemId, beatId) => {
       const raw = await request(
         "GET",
-        `/api/systems/${encodeURIComponent(projectId)}/beats/${encodeURIComponent(beatId)}/convergence`
+        `/api/systems/${encodeURIComponent(systemId)}/beats/${encodeURIComponent(beatId)}/convergence`
       );
       return raw?.report;
     },
-    setDownbeat: async (projectId, beatId) => {
+    setDownbeat: async (systemId, beatId) => {
       const raw = await request(
         "POST",
-        `/api/systems/${encodeURIComponent(projectId)}/beats/${encodeURIComponent(beatId)}/downbeat`
+        `/api/systems/${encodeURIComponent(systemId)}/beats/${encodeURIComponent(beatId)}/downbeat`
       );
       return raw?.downbeat;
     },
-    listIncrementsSinceDownbeat: async (projectId, beatId) => {
+    listIncrementsSinceDownbeat: async (systemId, beatId) => {
       const raw = await request(
         "GET",
-        `/api/systems/${encodeURIComponent(projectId)}/beats/${encodeURIComponent(beatId)}/downbeat/increments`
+        `/api/systems/${encodeURIComponent(systemId)}/beats/${encodeURIComponent(beatId)}/downbeat/increments`
       );
       return raw?.result;
     },
-    getCodaDrift: async (projectId, beatId) => {
+    getCodaDrift: async (systemId, beatId) => {
       const raw = await request(
         "GET",
-        `/api/systems/${encodeURIComponent(projectId)}/beats/${encodeURIComponent(beatId)}/downbeat/drift`
+        `/api/systems/${encodeURIComponent(systemId)}/beats/${encodeURIComponent(beatId)}/downbeat/drift`
       );
       return raw?.report;
     },
-    getRelationalDrift: async (projectId, beatId) => {
+    getRelationalDrift: async (systemId, beatId) => {
       const raw = await request(
         "GET",
-        `/api/systems/${encodeURIComponent(projectId)}/beats/${encodeURIComponent(beatId)}/downbeat/relational-drift`
+        `/api/systems/${encodeURIComponent(systemId)}/beats/${encodeURIComponent(beatId)}/downbeat/relational-drift`
       );
       return raw?.report;
     },
@@ -33000,8 +33041,8 @@ function createHttpClient(config2) {
       const result = await request("POST", `/api/movements/${encodeURIComponent(movementId)}/notes`, input);
       return result?.note ?? result;
     },
-    listSystemLayers: async (projectId) => {
-      const result = await request("GET", `/api/systems/${encodeURIComponent(projectId)}/layers`);
+    listSystemLayers: async (systemId) => {
+      const result = await request("GET", `/api/systems/${encodeURIComponent(systemId)}/layers`);
       return result?.layers ?? [];
     },
     getLayer: async (layerId) => {
@@ -33033,7 +33074,7 @@ function createHttpClient(config2) {
       const result = await request("POST", `/api/layers/${encodeURIComponent(layerId)}/status`, { status, reason });
       return result?.layer;
     },
-    listSystemNotes: async (projectId, filters) => {
+    listSystemNotes: async (systemId, filters) => {
       const params = new URLSearchParams();
       if (filters?.noteType) {
         const types = Array.isArray(filters.noteType) ? filters.noteType : [filters.noteType];
@@ -33046,10 +33087,10 @@ function createHttpClient(config2) {
       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}`);
+      const result = await request("GET", `/api/systems/${encodeURIComponent(systemId)}/notes${qs}`);
       return result?.notes ?? [];
     },
-    listAllSystemNotes: async (projectId, filters, limit, cursor) => {
+    listAllSystemNotes: async (systemId, filters, limit, cursor) => {
       const params = new URLSearchParams();
       if (filters?.noteType) {
         const types = Array.isArray(filters.noteType) ? filters.noteType : [filters.noteType];
@@ -33064,7 +33105,7 @@ function createHttpClient(config2) {
       if (limit !== void 0) params.set("limit", String(limit));
       if (cursor !== void 0) params.set("cursor", cursor);
       const qs = params.toString() ? `?${params.toString()}` : "";
-      const result = await request("GET", `/api/systems/${encodeURIComponent(projectId)}/notes/all${qs}`);
+      const result = await request("GET", `/api/systems/${encodeURIComponent(systemId)}/notes/all${qs}`);
       return { notes: result?.notes ?? [], cursor: result?.cursor, hasMore: result?.hasMore ?? false };
     },
     listBeatNotes: async (beatId, filters) => {
@@ -33100,9 +33141,9 @@ function createHttpClient(config2) {
     },
     updateNote: async (noteId, input) => {
       const existing = await request("GET", `/api/notes/${encodeURIComponent(noteId)}`);
-      const projectId = existing?.projectId ?? existing?.note?.projectId;
-      if (projectId) {
-        const result2 = await request("PATCH", `/api/systems/${encodeURIComponent(projectId)}/notes/${encodeURIComponent(noteId)}`, input);
+      const systemId = existing?.projectId ?? existing?.note?.projectId;
+      if (systemId) {
+        const result2 = await request("PATCH", `/api/systems/${encodeURIComponent(systemId)}/notes/${encodeURIComponent(noteId)}`, input);
         return result2?.note ?? result2;
       }
       const orgId = existing?.organizationId ?? existing?.note?.organizationId;
@@ -33132,8 +33173,8 @@ function createHttpClient(config2) {
       );
       return result;
     },
-    getKeyAssumptions: async (projectId) => {
-      const result = await request("GET", `/api/systems/${encodeURIComponent(projectId)}/notes/key-assumptions`);
+    getKeyAssumptions: async (systemId) => {
+      const result = await request("GET", `/api/systems/${encodeURIComponent(systemId)}/notes/key-assumptions`);
       return result?.assumptions ?? [];
     },
     getNextNoteId: async (projectCode) => {
@@ -33163,35 +33204,35 @@ function createHttpClient(config2) {
     getSystemGaps: async () => [],
     updateInformationGap: async () => false,
     // Revisions
-    createRevision: async (projectId, beatId, input) => {
+    createRevision: async (systemId, beatId, input) => {
       const result = await request(
         "POST",
-        `/api/systems/${encodeURIComponent(projectId)}/revisions`,
+        `/api/systems/${encodeURIComponent(systemId)}/revisions`,
         { beatId, ...input }
       );
       return { revision: result.revision, warnings: result.warnings ?? [] };
     },
     getRevision: (revisionId) => request("GET", `/api/revisions/${encodeURIComponent(revisionId)}`),
-    listConceptRevisions: async (projectId, options) => {
+    listConceptRevisions: async (systemId, options) => {
       const qs = options?.includeArchived ? "?includeArchived=true" : "";
-      const result = await request("GET", `/api/systems/${encodeURIComponent(projectId)}/revisions/pending${qs}`);
+      const result = await request("GET", `/api/systems/${encodeURIComponent(systemId)}/revisions/pending${qs}`);
       return result ?? [];
     },
-    listSystemRevisions: async (projectId, options) => {
+    listSystemRevisions: async (systemId, 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}`);
+      const result = await request("GET", `/api/systems/${encodeURIComponent(systemId)}/revisions${qs}`);
       return result ?? [];
     },
-    listBeatRevisions: async (projectId, beatId, options) => {
+    listBeatRevisions: async (systemId, beatId, options) => {
       const params = new URLSearchParams();
       params.set("beatId", beatId);
       if (options?.status) params.set("status", options.status);
       if (options?.includeArchived) params.set("includeArchived", "true");
       const qs = `?${params.toString()}`;
-      const result = await request("GET", `/api/systems/${encodeURIComponent(projectId)}/revisions${qs}`);
+      const result = await request("GET", `/api/systems/${encodeURIComponent(systemId)}/revisions${qs}`);
       return result ?? [];
     },
     updateRevision: async (revisionId, updates) => {
@@ -33357,11 +33398,11 @@ function createHttpClient(config2) {
         return { success: false, error: { code: "REQUEST_CODE_REVIEW_FAILED", message: err instanceof Error ? err.message : String(err) } };
       }
     },
-    claimRevision: async (projectId, revisionId) => {
+    claimRevision: async (systemId, revisionId) => {
       try {
         const result = await request(
           "POST",
-          `/api/systems/${encodeURIComponent(projectId)}/revisions/${encodeURIComponent(revisionId)}/claims`
+          `/api/systems/${encodeURIComponent(systemId)}/revisions/${encodeURIComponent(revisionId)}/claims`
         );
         if (result === void 0) {
           return { success: false, error: { code: "REVISION_NOT_FOUND", message: "Revision not found" } };
@@ -33375,11 +33416,11 @@ function createHttpClient(config2) {
         return { success: false, error: { code: "CLAIM_FAILED", message: err instanceof Error ? err.message : String(err) } };
       }
     },
-    releaseRevisionClaim: async (projectId, revisionId, reason) => {
+    releaseRevisionClaim: async (systemId, revisionId, reason) => {
       try {
         const result = await request(
           "POST",
-          `/api/systems/${encodeURIComponent(projectId)}/revisions/${encodeURIComponent(revisionId)}/claims/release`,
+          `/api/systems/${encodeURIComponent(systemId)}/revisions/${encodeURIComponent(revisionId)}/claims/release`,
           // Default to 'manual' to match direct-client and mcp.service (both `reason ?? 'manual'`).
           // 'manual' is a valid value of the API's `reason` enum, so this stays schema-valid.
           { reason: reason ?? "manual" }
@@ -33593,12 +33634,12 @@ function createHttpClient(config2) {
     getTask: async (taskId) => {
       return request("GET", `/api/tasks/${encodeURIComponent(taskId)}`);
     },
-    listSystemTasks: async (projectId, options) => {
+    listSystemTasks: async (systemId, 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}`);
+      const result = await request("GET", `/api/systems/${encodeURIComponent(systemId)}/tasks${qs}`);
       return result?.tasks ?? [];
     },
     listTaskEvents: async (taskId, options) => {
@@ -33609,27 +33650,27 @@ function createHttpClient(config2) {
       return request("GET", `/api/tasks/${encodeURIComponent(taskId)}/events${qs}`);
     },
     // Document analysis
-    analyzeDocument: async (projectId, content, filename) => {
-      return request("POST", `/api/systems/${encodeURIComponent(projectId)}/documents/analyze-text`, {
+    analyzeDocument: async (systemId, content, filename) => {
+      return request("POST", `/api/systems/${encodeURIComponent(systemId)}/documents/analyze-text`, {
         content,
         filename,
         sourceType: "document"
       }, LONG_RUNNING_TIMEOUT_MS);
     },
-    analyzeBinaryDocument: async (projectId, base64Content, filename) => {
-      return request("POST", `/api/systems/${encodeURIComponent(projectId)}/documents/analyze-binary`, {
+    analyzeBinaryDocument: async (systemId, base64Content, filename) => {
+      return request("POST", `/api/systems/${encodeURIComponent(systemId)}/documents/analyze-binary`, {
         content: base64Content,
         filename,
         encoding: "base64"
       }, LONG_RUNNING_TIMEOUT_MS);
     },
     // Activity — forward to API endpoint
-    listSystemActivities: async (projectId, options) => {
+    listSystemActivities: async (systemId, 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 path = `/api/systems/${encodeURIComponent(systemId)}/activities${qs ? `?${qs}` : ""}`;
       const result = await request("GET", path);
       return { entries: result.activities ?? [], hasMore: false };
     },
@@ -33647,8 +33688,8 @@ function createHttpClient(config2) {
       return result;
     },
     // Timeline
-    getUnifiedBeatTimeline: async (projectId, beatId) => {
-      const result = await request("GET", `/api/systems/${encodeURIComponent(projectId)}/beats/${encodeURIComponent(beatId)}/history`);
+    getUnifiedBeatTimeline: async (systemId, beatId) => {
+      const result = await request("GET", `/api/systems/${encodeURIComponent(systemId)}/beats/${encodeURIComponent(beatId)}/history`);
       return result?.timeline ?? [];
     },
     // Plan Beat Versions (agent decomposition of a Beat into waypoint BVs)
@@ -33693,17 +33734,17 @@ function createHttpClient(config2) {
       );
       return result.score;
     },
-    rankSystemBeatVersions: async (projectId, lens) => {
+    rankSystemBeatVersions: async (systemId, lens) => {
       const result = await request(
         "GET",
-        `/api/systems/${encodeURIComponent(projectId)}/beat-versions/ranked?lens=${encodeURIComponent(lens)}`
+        `/api/systems/${encodeURIComponent(systemId)}/beat-versions/ranked?lens=${encodeURIComponent(lens)}`
       );
       return result.ranked ?? [];
     },
-    rankSystemBeatVersionsWithLeverage: async (projectId, lens) => {
+    rankSystemBeatVersionsWithLeverage: async (systemId, lens) => {
       const result = await request(
         "GET",
-        `/api/systems/${encodeURIComponent(projectId)}/beat-versions/ranked?lens=${encodeURIComponent(lens)}&withLeverage=true`
+        `/api/systems/${encodeURIComponent(systemId)}/beat-versions/ranked?lens=${encodeURIComponent(lens)}&withLeverage=true`
       );
       return result.ranked ?? [];
     },
@@ -33713,10 +33754,10 @@ function createHttpClient(config2) {
     // "Cannot read properties of undefined (reading 'edge')" and discarded the
     // message the API had already produced. requestOrThrow parses `{ error }`
     // and throws ApiError with that text. See N-4E09-6343.
-    proposeEnablementEdges: async (projectId, actorId, beatId) => {
+    proposeEnablementEdges: async (systemId, actorId, beatId) => {
       const result = await requestOrThrow(
         "POST",
-        `/api/systems/${encodeURIComponent(projectId)}/enablement-edges/propose`,
+        `/api/systems/${encodeURIComponent(systemId)}/enablement-edges/propose`,
         { actorId, ...beatId !== void 0 && { beatId } }
       );
       return result?.proposed ?? [];
@@ -33755,8 +33796,8 @@ function createHttpClient(config2) {
       if (!result.beat) throw new Error(`confirmBeatW: no beat in response for ${beatId}`);
       return result.beat;
     },
-    getStaleWBeatIds: async (projectId) => {
-      const result = await request("GET", `/api/systems/${encodeURIComponent(projectId)}/stale-w-beats`);
+    getStaleWBeatIds: async (systemId) => {
+      const result = await request("GET", `/api/systems/${encodeURIComponent(systemId)}/stale-w-beats`);
       return result.staleWBeatIds ?? [];
     },
     // Beat Composer
@@ -33783,61 +33824,61 @@ function createHttpClient(config2) {
       return result;
     },
     // Beat Quality Check (fire-and-forget — returns taskId immediately, no polling)
-    checkBeatQuality: async (projectId, beatId) => {
+    checkBeatQuality: async (systemId, beatId) => {
       const enqueued = await request(
         "POST",
-        `/api/systems/${encodeURIComponent(projectId)}/beats/${encodeURIComponent(beatId)}/quality-check`
+        `/api/systems/${encodeURIComponent(systemId)}/beats/${encodeURIComponent(beatId)}/quality-check`
       );
       if (!enqueued?.taskId) throw new Error("Quality check enqueue failed: no taskId returned");
       return { taskId: enqueued.taskId, status: "pending" };
     },
     // Beat Reframe (async — enqueue + poll)
-    reframeBeat: async (projectId, beatId) => {
+    reframeBeat: async (systemId, beatId) => {
       const enqueued = await request(
         "POST",
-        `/api/systems/${encodeURIComponent(projectId)}/beats/${encodeURIComponent(beatId)}/reframe`
+        `/api/systems/${encodeURIComponent(systemId)}/beats/${encodeURIComponent(beatId)}/reframe`
       );
       if (!enqueued?.taskId) throw new Error("Reframe enqueue failed: no taskId returned");
       return pollTaskResult(enqueued.taskId);
     },
     // Beat Planning
-    planRevision: async (revisionId, projectId, messages) => {
+    planRevision: async (revisionId, systemId, messages) => {
       const enqueued = await request(
         "POST",
         `/api/revisions/${encodeURIComponent(revisionId)}/plan`,
-        { projectId, messages }
+        { systemId, messages }
       );
       if (!enqueued?.taskId) throw new Error("Planning enqueue failed: no taskId returned");
       return pollTaskResult(enqueued.taskId);
     },
     // Agent sessions
-    startSession: async (projectId, message, triggeredBy, options) => {
+    startSession: async (systemId, message, triggeredBy, options) => {
       const trimmedRevisionId = options?.revisionId?.trim();
       const result = await request(
         "POST",
         `/api/sessions`,
-        { systemId: projectId, message, ...triggeredBy && { triggeredBy }, ...trimmedRevisionId && { revisionId: trimmedRevisionId } }
+        { systemId, message, ...triggeredBy && { triggeredBy }, ...trimmedRevisionId && { revisionId: trimmedRevisionId } }
       );
       if (!result?.taskId) throw new Error("Start session enqueue failed: no taskId returned");
-      return { taskId: result.taskId, taskType: "generic_session", status: result.status ?? "pending", systemId: projectId, createdAt: (/* @__PURE__ */ new Date()).toISOString() };
+      return { taskId: result.taskId, taskType: "generic_session", status: result.status ?? "pending", systemId, createdAt: (/* @__PURE__ */ new Date()).toISOString() };
     },
-    planRevisionBatch: async (projectId, revisionIds) => {
+    planRevisionBatch: async (systemId, revisionIds) => {
       const result = await request(
         "POST",
-        `/api/systems/${encodeURIComponent(projectId)}/revisions/plan-batch`,
+        `/api/systems/${encodeURIComponent(systemId)}/revisions/plan-batch`,
         revisionIds ? { revisionIds } : {}
       );
       if (!result?.taskId) throw new Error("Plan revision batch enqueue failed: no taskId returned");
-      return { taskId: result.taskId, taskType: "plan_revision_batch", status: result.status ?? "pending", systemId: projectId, createdAt: (/* @__PURE__ */ new Date()).toISOString() };
+      return { taskId: result.taskId, taskType: "plan_revision_batch", status: result.status ?? "pending", systemId, createdAt: (/* @__PURE__ */ new Date()).toISOString() };
     },
-    draftCoda: async (projectId, beatId) => {
+    draftCoda: async (systemId, beatId) => {
       const result = await request(
         "POST",
-        `/api/systems/${encodeURIComponent(projectId)}/beats/${encodeURIComponent(beatId)}/draft-coda`,
+        `/api/systems/${encodeURIComponent(systemId)}/beats/${encodeURIComponent(beatId)}/draft-coda`,
         {}
       );
       if (!result?.taskId) throw new Error("Draft coda enqueue failed: no taskId returned");
-      return { taskId: result.taskId, taskType: "draft_coda", status: result.status ?? "pending", systemId: projectId, createdAt: (/* @__PURE__ */ new Date()).toISOString() };
+      return { taskId: result.taskId, taskType: "draft_coda", status: result.status ?? "pending", systemId, createdAt: (/* @__PURE__ */ new Date()).toISOString() };
     },
     composeRootCoda: async (orgId) => {
       const result = await request(
@@ -33848,45 +33889,45 @@ function createHttpClient(config2) {
       if (!result?.taskId) throw new Error("Compose root Coda enqueue failed: no taskId returned");
       return { taskId: result.taskId, taskType: "compose_root_coda", status: result.status ?? "pending", systemId: orgId, createdAt: (/* @__PURE__ */ new Date()).toISOString() };
     },
-    validateAssumptions: async (projectId, noteIds) => {
+    validateAssumptions: async (systemId, noteIds) => {
       const result = await request(
         "POST",
-        `/api/systems/${encodeURIComponent(projectId)}/assumptions/validate`,
+        `/api/systems/${encodeURIComponent(systemId)}/assumptions/validate`,
         noteIds ? { noteIds } : {}
       );
       if (!result?.taskId) throw new Error("Assumption validation enqueue failed: no taskId returned");
-      return { taskId: result.taskId, taskType: "validate_assumptions", status: result.status ?? "pending", systemId: projectId, createdAt: (/* @__PURE__ */ new Date()).toISOString() };
+      return { taskId: result.taskId, taskType: "validate_assumptions", status: result.status ?? "pending", systemId, createdAt: (/* @__PURE__ */ new Date()).toISOString() };
     },
-    runTriage: async (projectId) => {
+    runTriage: async (systemId) => {
       const result = await request(
         "POST",
-        `/api/systems/${encodeURIComponent(projectId)}/triage`,
+        `/api/systems/${encodeURIComponent(systemId)}/triage`,
         {}
       );
       if (!result?.taskId) throw new Error("Triage enqueue failed: no taskId returned");
-      return { taskId: result.taskId, taskType: "triage_loop", status: result.status ?? "pending", systemId: projectId, createdAt: (/* @__PURE__ */ new Date()).toISOString() };
+      return { taskId: result.taskId, taskType: "triage_loop", status: result.status ?? "pending", systemId, createdAt: (/* @__PURE__ */ new Date()).toISOString() };
     },
-    baselineSystem: async (projectId, options) => {
+    baselineSystem: async (systemId, options) => {
       const result = await request(
         "POST",
-        `/api/systems/${encodeURIComponent(projectId)}/baseline`,
+        `/api/systems/${encodeURIComponent(systemId)}/baseline`,
         { beatIds: options?.beatIds, runChecks: options?.runChecks ?? true, localPath: options?.localPath }
       );
       if (!result?.taskId) throw new Error("Baseline enqueue failed: no taskId returned");
-      return { taskId: result.taskId, taskType: "baseline_system", status: result.status ?? "pending", systemId: projectId, createdAt: (/* @__PURE__ */ new Date()).toISOString() };
+      return { taskId: result.taskId, taskType: "baseline_system", status: result.status ?? "pending", systemId, createdAt: (/* @__PURE__ */ new Date()).toISOString() };
     },
-    runCheck: async (projectId, checkType, targetId, options) => {
+    runCheck: async (systemId, checkType, targetId, options) => {
       const result = await request(
         "POST",
-        `/api/systems/${encodeURIComponent(projectId)}/checks/run`,
+        `/api/systems/${encodeURIComponent(systemId)}/checks/run`,
         { checkType, targetId, branch: options?.branch, localPath: options?.localPath }
       );
       if (!result?.taskId) throw new Error("Check enqueue failed: no taskId returned");
-      return { taskId: result.taskId, taskType: "run_check", status: result.status ?? "pending", systemId: projectId, createdAt: (/* @__PURE__ */ new Date()).toISOString() };
+      return { taskId: result.taskId, taskType: "run_check", status: result.status ?? "pending", systemId, createdAt: (/* @__PURE__ */ new Date()).toISOString() };
     },
     // Subscriptions
-    subscribe: async (userId, entityType, entityId, projectId, source) => {
-      return request("POST", `/api/systems/${encodeURIComponent(projectId)}/subscriptions`, { userId, entityType, entityId, source });
+    subscribe: async (userId, entityType, entityId, systemId, source) => {
+      return request("POST", `/api/systems/${encodeURIComponent(systemId)}/subscriptions`, { userId, entityType, entityId, source });
     },
     unsubscribe: async (userId, entityType, entityId, durable) => {
       await request("DELETE", `/api/subscriptions/${encodeURIComponent(entityType)}/${encodeURIComponent(entityId)}`, { userId, durable });
@@ -33899,8 +33940,8 @@ function createHttpClient(config2) {
       return request("GET", `/api/subscriptions/entity/${encodeURIComponent(entityId)}`, void 0);
     },
     // Project Snapshot — export runs as a background task to avoid Lambda timeout
-    exportSystemSnapshot: async (projectId) => {
-      const pid = encodeURIComponent(projectId);
+    exportSystemSnapshot: async (systemId) => {
+      const pid = encodeURIComponent(systemId);
       const enqueued = await request("POST", `/api/systems/${pid}/export`, {});
       if (!enqueued?.taskId) throw new Error("Export enqueue failed: no taskId returned");
       await pollTaskResult(enqueued.taskId);
@@ -33929,32 +33970,32 @@ function createHttpClient(config2) {
       return importResult;
     },
     // Embedding similarity
-    embedSystemEntities: (projectId) => request("POST", `/api/systems/${encodeURIComponent(projectId)}/embeddings/generate`),
-    findSimilarNotes: async (noteId, projectId, options) => {
+    embedSystemEntities: (systemId) => request("POST", `/api/systems/${encodeURIComponent(systemId)}/embeddings/generate`),
+    findSimilarNotes: async (noteId, systemId, options) => {
       const qs = buildSimilarityQS(options);
-      const res = await request("GET", `/api/systems/${encodeURIComponent(projectId)}/notes/${encodeURIComponent(noteId)}/similar${qs}`);
+      const res = await request("GET", `/api/systems/${encodeURIComponent(systemId)}/notes/${encodeURIComponent(noteId)}/similar${qs}`);
       return res?.results ?? [];
     },
-    findSimilarNotesMulti: async (noteIds, projectId, options) => {
+    findSimilarNotesMulti: async (noteIds, systemId, options) => {
       const qs = buildSimilarityQS(options);
       return Promise.all(
         noteIds.map(async (noteId) => {
           const res = await request(
             "GET",
-            `/api/systems/${encodeURIComponent(projectId)}/notes/${encodeURIComponent(noteId)}/similar${qs}`
+            `/api/systems/${encodeURIComponent(systemId)}/notes/${encodeURIComponent(noteId)}/similar${qs}`
           );
           return { sourceNoteId: noteId, results: res?.results ?? [] };
         })
       );
     },
-    findRelatedBeats: async (noteId, projectId, options) => {
+    findRelatedBeats: async (noteId, systemId, options) => {
       const qs = buildSimilarityQS(options);
-      const res = await request("GET", `/api/systems/${encodeURIComponent(projectId)}/notes/${encodeURIComponent(noteId)}/related-beats${qs}`);
+      const res = await request("GET", `/api/systems/${encodeURIComponent(systemId)}/notes/${encodeURIComponent(noteId)}/related-beats${qs}`);
       return res?.results ?? [];
     },
-    findSimilarBeats: async (beatId, projectId, options) => {
+    findSimilarBeats: async (beatId, systemId, options) => {
       const qs = buildSimilarityQS(options);
-      const res = await request("GET", `/api/systems/${encodeURIComponent(projectId)}/beats/${encodeURIComponent(beatId)}/similar${qs}`);
+      const res = await request("GET", `/api/systems/${encodeURIComponent(systemId)}/beats/${encodeURIComponent(beatId)}/similar${qs}`);
       return res?.results ?? [];
     },
     searchByText: async (scope, query, options) => {
@@ -33971,21 +34012,21 @@ function createHttpClient(config2) {
       const res = await request("GET", `/api/search?${params.toString()}`);
       return res?.results ?? [];
     },
-    discoverRelationships: (projectId) => request("GET", `/api/systems/${encodeURIComponent(projectId)}/relationships/discover`),
-    clusterNotes: async (projectId, options) => {
-      const res = await request("POST", `/api/systems/${encodeURIComponent(projectId)}/notes/cluster`, options ?? {});
+    discoverRelationships: (systemId) => request("GET", `/api/systems/${encodeURIComponent(systemId)}/relationships/discover`),
+    clusterNotes: async (systemId, options) => {
+      const res = await request("POST", `/api/systems/${encodeURIComponent(systemId)}/notes/cluster`, options ?? {});
       return res;
     },
-    consolidateNotes: async (projectId, options) => {
-      const res = await request("POST", `/api/systems/${encodeURIComponent(projectId)}/notes/consolidate`, options ?? {});
+    consolidateNotes: async (systemId, options) => {
+      const res = await request("POST", `/api/systems/${encodeURIComponent(systemId)}/notes/consolidate`, options ?? {});
       return res;
     },
-    clusterEntities: async (projectId, entityType, options) => {
-      const res = await request("POST", `/api/systems/${encodeURIComponent(projectId)}/entities/cluster`, { entityType, ...options });
+    clusterEntities: async (systemId, entityType, options) => {
+      const res = await request("POST", `/api/systems/${encodeURIComponent(systemId)}/entities/cluster`, { entityType, ...options });
       return res;
     },
-    runClusteredAnalysis: async (projectId, analysisType, options) => {
-      const res = await request("POST", `/api/systems/${encodeURIComponent(projectId)}/entities/clustered-analysis`, { analysisType, ...options });
+    runClusteredAnalysis: async (systemId, analysisType, options) => {
+      const res = await request("POST", `/api/systems/${encodeURIComponent(systemId)}/entities/clustered-analysis`, { analysisType, ...options });
       return res;
     },
     // Check queries
@@ -33993,7 +34034,7 @@ function createHttpClient(config2) {
       const res = await request("GET", `/api/checks/${encodeURIComponent(checkId)}`);
       return res.check;
     },
-    listSystemChecks: async (projectId, checkType, options) => {
+    listSystemChecks: async (systemId, checkType, options) => {
       const params = new URLSearchParams();
       if (checkType) params.set("type", checkType);
       if (options?.limit !== void 0) params.set("limit", String(options.limit));
@@ -34001,38 +34042,38 @@ function createHttpClient(config2) {
       const qs = params.toString() ? `?${params.toString()}` : "";
       const res = await request(
         "GET",
-        `/api/systems/${encodeURIComponent(projectId)}/checks${qs}`
+        `/api/systems/${encodeURIComponent(systemId)}/checks${qs}`
       );
       return { checks: res?.checks ?? [], nextCursor: res?.nextCursor };
     },
-    listLatestSystemChecks: async (projectId) => {
+    listLatestSystemChecks: async (systemId) => {
       const res = await request(
         "GET",
-        `/api/checks/latest?projectId=${encodeURIComponent(projectId)}`
+        `/api/checks/latest?systemId=${encodeURIComponent(systemId)}`
       );
       return res?.checks ?? [];
     },
-    listBeatChecks: async (beatId, projectId, checkType) => {
+    listBeatChecks: async (beatId, systemId, checkType) => {
       const qs = checkType ? `?type=${encodeURIComponent(checkType)}` : "";
       const res = await request(
         "GET",
-        `/api/systems/${encodeURIComponent(projectId)}/beats/${encodeURIComponent(beatId)}/checks${qs}`
+        `/api/systems/${encodeURIComponent(systemId)}/beats/${encodeURIComponent(beatId)}/checks${qs}`
       );
       return res.checks;
     },
-    listRevisionChecks: async (revisionId, projectId, checkType) => {
+    listRevisionChecks: async (revisionId, systemId, checkType) => {
       const qs = checkType ? `?type=${encodeURIComponent(checkType)}` : "";
       const res = await request(
         "GET",
-        `/api/systems/${encodeURIComponent(projectId)}/revisions/${encodeURIComponent(revisionId)}/checks${qs}`
+        `/api/systems/${encodeURIComponent(systemId)}/revisions/${encodeURIComponent(revisionId)}/checks${qs}`
       );
       return res.checks;
     },
-    listBeatVersionChecks: async (beatVersionId, projectId, checkType) => {
+    listBeatVersionChecks: async (beatVersionId, systemId, checkType) => {
       const qs = checkType ? `?type=${encodeURIComponent(checkType)}` : "";
       const res = await request(
         "GET",
-        `/api/systems/${encodeURIComponent(projectId)}/beat-versions/${encodeURIComponent(beatVersionId)}/checks${qs}`
+        `/api/systems/${encodeURIComponent(systemId)}/beat-versions/${encodeURIComponent(beatVersionId)}/checks${qs}`
       );
       return res.checks;
     },
@@ -34053,9 +34094,9 @@ function createHttpClient(config2) {
       return res.check;
     },
     // Audit integrity
-    verifyAuditIntegrity: async (projectId, options) => {
+    verifyAuditIntegrity: async (systemId, options) => {
       const qs = options?.limit ? `?limit=${options.limit}` : "";
-      return request("POST", `/api/systems/${encodeURIComponent(projectId)}/audit/verify${qs}`);
+      return request("POST", `/api/systems/${encodeURIComponent(systemId)}/audit/verify${qs}`);
     },
     // Teamspaces
     listOrgTeamspaces: async (orgId) => {
@@ -34077,9 +34118,9 @@ 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`);
+    listSystemDeliverableGroups: async (systemId) => {
+      const res = await request("GET", `/api/systems/${encodeURIComponent(systemId)}/deliverable-groups`);
+      if (res === void 0) throw new Error(`Project ${systemId} not found`);
       return res.deliverableGroups;
     },
     listMovementDeliverableGroups: async (movementId) => {
@@ -34563,20 +34604,20 @@ function createHttpClient(config2) {
       return request("POST", `/api/accounts/${encodeURIComponent(accountId)}/drops/proposal`, options?.lens ? { lens: options.lens } : {});
     },
     // Beat Versions (three-tier hierarchy: Beat → Beat Version → Revision)
-    listBeatVersions: async (projectId, options) => {
+    listBeatVersions: async (systemId, options) => {
       const params = new URLSearchParams();
       if (options?.beatId) params.set("beatId", options.beatId);
       if (options?.status) params.set("status", options.status);
       if (options?.includeTerminal) params.set("includeTerminal", "true");
       const qs = params.toString() ? `?${params.toString()}` : "";
-      const res = await request("GET", `/api/systems/${encodeURIComponent(projectId)}/beat-versions${qs}`);
+      const res = await request("GET", `/api/systems/${encodeURIComponent(systemId)}/beat-versions${qs}`);
       return res ?? [];
     },
     getBeatVersion: async (beatVersionId) => {
       return request("GET", `/api/beat-versions/${encodeURIComponent(beatVersionId)}`);
     },
-    createBeatVersion: async (projectId, beatId, input) => {
-      return request("POST", `/api/systems/${encodeURIComponent(projectId)}/beats/${encodeURIComponent(beatId)}/beat-versions`, input);
+    createBeatVersion: async (systemId, beatId, input) => {
+      return request("POST", `/api/systems/${encodeURIComponent(systemId)}/beats/${encodeURIComponent(beatId)}/beat-versions`, input);
     },
     updateBeatVersion: async (beatVersionId, updates) => {
       return request("PATCH", `/api/beat-versions/${encodeURIComponent(beatVersionId)}`, updates);
@@ -34630,17 +34671,17 @@ function createHttpClient(config2) {
       return res.guidelines;
     },
     // Next Actions & Triage
-    getNextActions: async (projectId, options) => {
+    getNextActions: async (systemId, options) => {
       const qs = options?.limit ? `?limit=${options.limit}` : "";
-      const result = await request("GET", `/api/systems/${encodeURIComponent(projectId)}/next-actions${qs}`);
+      const result = await request("GET", `/api/systems/${encodeURIComponent(systemId)}/next-actions${qs}`);
       return result?.actions ?? [];
     },
-    listTriageActions: async (projectId) => {
-      const result = await request("GET", `/api/systems/${encodeURIComponent(projectId)}/triage-actions`);
+    listTriageActions: async (systemId) => {
+      const result = await request("GET", `/api/systems/${encodeURIComponent(systemId)}/triage-actions`);
       return result?.actions ?? [];
     },
-    dismissTriageAction: async (projectId, actionKey, _userId) => {
-      await request("POST", `/api/systems/${encodeURIComponent(projectId)}/triage-actions/${encodeURIComponent(actionKey)}/dismiss`);
+    dismissTriageAction: async (systemId, actionKey, _userId) => {
+      await request("POST", `/api/systems/${encodeURIComponent(systemId)}/triage-actions/${encodeURIComponent(actionKey)}/dismiss`);
     },
     // Onboarding (LLM-heavy — delegate to API)
     initiateOnboarding: async (orgId, input) => {
@@ -34652,17 +34693,17 @@ function createHttpClient(config2) {
       if (!result) throw new Error(`Onboarding initiate failed: org ${orgId} not found`);
       return result;
     },
-    draftOnboardingBeats: async (projectId, input) => {
+    draftOnboardingBeats: async (systemId, input) => {
       const result = await request(
         "POST",
-        `/api/systems/${encodeURIComponent(projectId)}/beats/draft`,
+        `/api/systems/${encodeURIComponent(systemId)}/beats/draft`,
         input
       );
-      if (!result) throw new Error(`Beat draft failed: project ${projectId} not found`);
+      if (!result) throw new Error(`Beat draft failed: project ${systemId} not found`);
       return result;
     },
-    triggerSystemEmbedding: async (projectId) => {
-      await request("POST", `/api/systems/${encodeURIComponent(projectId)}/embedding`);
+    triggerSystemEmbedding: async (systemId) => {
+      await request("POST", `/api/systems/${encodeURIComponent(systemId)}/embedding`);
     },
     // Notebooks (B-271)
     createNotebook: async (input) => {
@@ -34924,7 +34965,7 @@ function loadConfig() {
   };
 }
 async function main() {
-  console.error(`[harmonica-mcp] v${"3.9.3"} starting\u2026`);
+  console.error(`[harmonica-mcp] v${"4.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": "3.9.3",
+  "version": "4.0.0",
   "description": "MCP server for Harmonica — connect any MCP-compatible AI assistant to Harmonica",
   "license": "MIT",
   "bin": {