@codazen/harmonica-mcp 3.6.0 → 3.6.1

package/dist/index.js

@@ -22374,7 +22374,7 @@ function registerBeatConvergenceTools(server, ctx, client) {
     { beatId: external_exports.string().describe("The beat ID (e.g., TF-B-001)") },
     async ({ beatId }) => {
       const beat = await fetchBeatInOrg(client, beatId, ctx.orgId);
-      const report = await client.getBeatConvergence(beat.projectId, beatId);
+      const report = await client.getBeatConvergence(beat.systemId ?? beat.projectId, beatId);
       if (!report) {
         return { content: [{ type: "text", text: `No convergence data for beat "${beatId}".` }], isError: true };
       }
@@ -22989,7 +22989,7 @@ function formatSessionDetail(session) {
     "",
     `**Type:** ${type}`,
     `**Status:** ${status}`,
-    `**Project:** ${session.projectId}`,
+    `**Project:** ${session.systemId ?? session.projectId}`,
     `**Actor:** ${session.actor.agentPersona}${session.actor.agentRole ? ` (${session.actor.agentRole})` : ""}`
   ];
   if (session.actor.initiator) {
@@ -23143,7 +23143,7 @@ function registerBeatTools(server, ctx, client) {
     },
     async ({ beatId, projectId }) => {
       const beat = await fetchBeatInOrg(client, beatId, ctx.orgId);
-      const resolvedProjectId = projectId ?? beat.projectId;
+      const resolvedProjectId = projectId ?? beat.systemId ?? beat.projectId;
       const timeline = await client.getUnifiedBeatTimeline(resolvedProjectId, beatId);
       if (timeline.length === 0) {
         return { content: [{ type: "text", text: `No history for beat "${beatId}".` }] };
@@ -23257,7 +23257,7 @@ ${formatBeatDetail(beat)}${similarityWarning}` }] };
           return { content: [{ type: "text", text: `Beat not found: "${beatId}"` }], isError: true };
         }
         await logBeatActivity(client, {
-          projectId: beat.projectId,
+          projectId: beat.systemId ?? beat.projectId,
           action: "beat_updated",
           beatIds: [beatId],
           beatTitles: [updated.title],
@@ -23476,7 +23476,7 @@ function registerBeatVersionTools(server, ctx, client) {
           return { content: [{ type: "text", text: `Beat not found: "${beatId}"` }], isError: true };
         }
         await assertBeatInOrg(client, beatId, ctx.orgId);
-        const beatVersion = await client.createBeatVersion(beat.projectId, beatId, {
+        const beatVersion = await client.createBeatVersion(beat.systemId ?? beat.projectId, beatId, {
           title,
           description,
           scope,
@@ -24447,7 +24447,7 @@ function registerDownbeatTools(server, ctx, client) {
     { beatId: external_exports.string().describe("The beat ID (e.g., TF-B-001)") },
     async ({ beatId }) => {
       const beat = await fetchBeatInOrg(client, beatId, ctx.orgId);
-      const downbeat = await client.setDownbeat(beat.projectId, beatId);
+      const downbeat = await client.setDownbeat(beat.systemId ?? beat.projectId, beatId);
       if (!downbeat) {
         return { content: [{ type: "text", text: `Could not set a Downbeat for beat "${beatId}".` }], isError: true };
       }
@@ -24460,7 +24460,7 @@ function registerDownbeatTools(server, ctx, client) {
     { beatId: external_exports.string().describe("The beat ID (e.g., TF-B-001)") },
     async ({ beatId }) => {
       const beat = await fetchBeatInOrg(client, beatId, ctx.orgId);
-      const result = await client.listIncrementsSinceDownbeat(beat.projectId, beatId);
+      const result = await client.listIncrementsSinceDownbeat(beat.systemId ?? beat.projectId, beatId);
       if (!result) {
         return { content: [{ type: "text", text: `No such beat "${beatId}".` }], isError: true };
       }
@@ -24473,7 +24473,7 @@ function registerDownbeatTools(server, ctx, client) {
     { beatId: external_exports.string().describe("The beat ID (e.g., TF-B-001)") },
     async ({ beatId }) => {
       const beat = await fetchBeatInOrg(client, beatId, ctx.orgId);
-      const report = await client.getCodaDrift(beat.projectId, beatId);
+      const report = await client.getCodaDrift(beat.systemId ?? beat.projectId, beatId);
       if (!report) {
         return { content: [{ type: "text", text: `No such beat "${beatId}".` }], isError: true };
       }
@@ -24486,7 +24486,7 @@ function registerDownbeatTools(server, ctx, client) {
     { beatId: external_exports.string().describe("The beat ID (e.g., TF-B-001)") },
     async ({ beatId }) => {
       const beat = await fetchBeatInOrg(client, beatId, ctx.orgId);
-      const report = await client.getRelationalDrift(beat.projectId, beatId);
+      const report = await client.getRelationalDrift(beat.systemId ?? beat.projectId, beatId);
       if (!report) {
         return { content: [{ type: "text", text: `No such beat "${beatId}".` }], isError: true };
       }
@@ -29328,11 +29328,11 @@ function registerRevisionLifecycleTools(server, ctx, client) {
           if (!parentBv) {
             return { content: [{ type: "text", text: `Beat Version not found: "${beatVersionId}"` }], isError: true };
           }
-          if (parentBv.beatId !== beatId || parentBv.projectId !== beat.projectId) {
+          if (parentBv.beatId !== beatId || (parentBv.systemId ?? parentBv.projectId) !== (beat.systemId ?? beat.projectId)) {
             return { content: [{ type: "text", text: `Beat Version "${beatVersionId}" belongs to a different Beat.` }], isError: true };
           }
         }
-        const { revision, warnings } = await client.createRevision(beat.projectId, beatId, {
+        const { revision, warnings } = await client.createRevision(beat.systemId ?? beat.projectId, beatId, {
           title,
           description,
           changeSummary,
@@ -29420,7 +29420,7 @@ function registerRevisionLifecycleTools(server, ctx, client) {
           if (!bv) {
             return { content: [{ type: "text", text: `Beat Version not found: "${beatVersionId}"` }], isError: true };
           }
-          if (bv.beatId !== revision.beatId || bv.projectId !== revision.projectId) {
+          if (bv.beatId !== revision.beatId || (bv.systemId ?? bv.projectId) !== (revision.systemId ?? revision.projectId)) {
             return { content: [{ type: "text", text: `Beat Version "${beatVersionId}" belongs to a different Beat.` }], isError: true };
           }
         }
@@ -32253,7 +32253,7 @@ function createHttpClient(config2) {
     getBeat: async (beatId) => {
       const raw = await request("GET", `/api/beats/${encodeURIComponent(beatId)}`);
       if (!raw) return void 0;
-      return { ...raw, beatId: raw.beatId ?? raw.id, status: raw.status ?? "open", beatStatus: coerceBeatStatusLocal(raw.beatStatus) };
+      return { ...raw, beatId: raw.beatId ?? raw.id, projectId: raw.projectId ?? raw.systemId, status: raw.status ?? "open", beatStatus: coerceBeatStatusLocal(raw.beatStatus) };
     },
     getBeatConvergence: async (projectId, beatId) => {
       const raw = await request(
@@ -32300,7 +32300,9 @@ function createHttpClient(config2) {
       }
       const beat = await request("GET", `/api/beats/${encodeURIComponent(beatId)}`);
       if (!beat) return void 0;
-      const result = await request("PUT", `/api/systems/${encodeURIComponent(beat.projectId)}/beats/${encodeURIComponent(beatId)}`, updates);
+      const systemId = beat.systemId ?? beat.projectId;
+      if (!systemId) return void 0;
+      const result = await request("PUT", `/api/systems/${encodeURIComponent(systemId)}/beats/${encodeURIComponent(beatId)}`, updates);
       const raw = result?.beat ?? result;
       return { ...raw, beatStatus: coerceBeatStatusLocal(raw.beatStatus) };
     },
@@ -32434,6 +32436,8 @@ function createHttpClient(config2) {
     listBeatNotes: async (beatId, filters) => {
       const beat = await request("GET", `/api/beats/${encodeURIComponent(beatId)}`);
       if (!beat) return [];
+      const systemId = beat.systemId ?? beat.projectId;
+      if (!systemId) return [];
       const params = new URLSearchParams();
       if (filters?.noteType) {
         const types = Array.isArray(filters.noteType) ? filters.noteType : [filters.noteType];
@@ -32445,7 +32449,7 @@ function createHttpClient(config2) {
       if (filters?.excludeChildren) params.set("excludeChildren", "true");
       if (filters?.significance) params.set("significance", filters.significance);
       const qs = params.toString() ? `?${params.toString()}` : "";
-      const result = await request("GET", `/api/systems/${encodeURIComponent(beat.projectId)}/beats/${encodeURIComponent(beatId)}/notes${qs}`);
+      const result = await request("GET", `/api/systems/${encodeURIComponent(systemId)}/beats/${encodeURIComponent(beatId)}/notes${qs}`);
       return result?.notes ?? [];
     },
     getNote: async (noteId) => {
@@ -32768,9 +32772,9 @@ 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) => {
+    listSystemSessions: async (systemId, options) => {
       const params = new URLSearchParams();
-      params.set("projectId", projectId);
+      params.set("systemId", systemId);
       if (options?.status) params.set("status", options.status);
       if (options?.includeTerminal) params.set("includeTerminal", "true");
       const result = await request("GET", `/api/sessions?${params.toString()}`);
@@ -33321,7 +33325,7 @@ function createHttpClient(config2) {
     },
     searchByText: async (scope, query, options) => {
       const params = new URLSearchParams({ q: query });
-      if ("projectId" in scope) params.set("projectId", scope.projectId);
+      if ("projectId" in scope) params.set("systemId", scope.projectId);
       else if ("teamspaceId" in scope) params.set("teamspaceId", scope.teamspaceId);
       else params.set("orgId", scope.orgId);
       if (options?.limit) params.set("limit", String(options.limit));
@@ -34157,7 +34161,7 @@ function loadConfig() {
   };
 }
 async function main() {
-  console.error(`[harmonica-mcp] v${"3.6.0"} starting\u2026`);
+  console.error(`[harmonica-mcp] v${"3.6.1"} starting\u2026`);
   const config2 = loadConfig();
   const client = createHttpClient({
     apiBaseUrl: config2.apiBaseUrl,

package/package.json

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