@codazen/harmonica-mcp 3.4.0 → 3.5.0

package/dist/index.js

@@ -25241,7 +25241,7 @@ var STAGE_ENUM = external_exports.enum([
   "beta",
   "prod"
 ]);
-function registerFeatureFlagTools(server, _ctx, client) {
+function registerFeatureFlagTools(server, ctx, client) {
   server.tool(
     "list_flags",
     "List feature flags and their enabled stages. Use check_flag to test a single flag against a specific stage, or get_flag for full detail on one flag.",
@@ -25307,6 +25307,89 @@ function registerFeatureFlagTools(server, _ctx, client) {
       }
     }
   );
+  server.tool(
+    "create_flag",
+    "Create or update a feature flag with the specified enabled stages. Idempotent \u2014 calling with an existing flag name replaces its enabledIn list.",
+    {
+      name: external_exports.string().min(1).describe('Flag name (e.g. "rbac:enforcement")'),
+      enabledIn: external_exports.array(STAGE_ENUM).describe("Stages to enable the flag in"),
+      description: external_exports.string().optional().describe("Human-readable description of what this flag gates"),
+      note: external_exports.string().optional().describe("Reason for this change (recorded in change history)")
+    },
+    async ({ name, enabledIn, description, note }) => {
+      if (!ctx.user.email) {
+        return { content: [{ type: "text", text: "Write operations require an authenticated user with a valid email." }], isError: true };
+      }
+      try {
+        const flag = await client.createFlag(name, enabledIn, { description, note, updatedBy: ctx.user.email });
+        return { content: [{ type: "text", text: formatFlag(flag) }] };
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { content: [{ type: "text", text: `Failed to create flag: ${message}` }], isError: true };
+      }
+    }
+  );
+  server.tool(
+    "set_flag",
+    "Update which stages a feature flag is enabled in. Replaces the current enabledIn list entirely.",
+    {
+      name: external_exports.string().min(1).describe("Flag name"),
+      enabledIn: external_exports.array(STAGE_ENUM).describe("New set of stages to enable the flag in. Pass [] to disable everywhere without archiving."),
+      note: external_exports.string().optional().describe("Reason for this change (recorded in change history)")
+    },
+    async ({ name, enabledIn, note }) => {
+      if (!ctx.user.email) {
+        return { content: [{ type: "text", text: "Write operations require an authenticated user with a valid email." }], isError: true };
+      }
+      try {
+        const flag = await client.setFlag(name, enabledIn, { note, updatedBy: ctx.user.email });
+        return { content: [{ type: "text", text: formatFlag(flag) }] };
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { content: [{ type: "text", text: `Failed to set flag: ${message}` }], isError: true };
+      }
+    }
+  );
+  server.tool(
+    "archive_flag",
+    "Archive a feature flag. Clears its enabledIn list and marks it archived so it cannot be re-enabled via set_flag. Use unarchive_flag to restore it.",
+    {
+      name: external_exports.string().min(1).describe("Flag name"),
+      note: external_exports.string().optional().describe("Reason for archiving (recorded in change history)")
+    },
+    async ({ name, note }) => {
+      if (!ctx.user.email) {
+        return { content: [{ type: "text", text: "Write operations require an authenticated user with a valid email." }], isError: true };
+      }
+      try {
+        const flag = await client.archiveFlag(name, { note, updatedBy: ctx.user.email });
+        return { content: [{ type: "text", text: formatFlag(flag) }] };
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { content: [{ type: "text", text: `Failed to archive flag: ${message}` }], isError: true };
+      }
+    }
+  );
+  server.tool(
+    "unarchive_flag",
+    "Restore an archived feature flag to operable state. The flag is re-enabled with an empty enabledIn list \u2014 use set_flag afterward to enable it in specific stages.",
+    {
+      name: external_exports.string().min(1).describe("Flag name"),
+      note: external_exports.string().optional().describe("Reason for restoring (recorded in change history)")
+    },
+    async ({ name, note }) => {
+      if (!ctx.user.email) {
+        return { content: [{ type: "text", text: "Write operations require an authenticated user with a valid email." }], isError: true };
+      }
+      try {
+        const flag = await client.unarchiveFlag(name, { note, updatedBy: ctx.user.email });
+        return { content: [{ type: "text", text: formatFlag(flag) }] };
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { content: [{ type: "text", text: `Failed to unarchive flag: ${message}` }], isError: true };
+      }
+    }
+  );
 }
 function formatFlag(flag, history) {
   const archived = flag.archivedAt ? " **(archived)**" : "";
@@ -25316,7 +25399,8 @@ function formatFlag(flag, history) {
     `**Scope:** ${flag.scope}`,
     `**Enabled in:** ${enabled}`,
     flag.description ? `**Description:** ${flag.description}` : null,
-    `**Last updated:** ${flag.updatedAt.slice(0, 10)} by ${flag.updatedBy}`
+    `**Last updated:** ${flag.updatedAt.slice(0, 10)} by ${flag.updatedBy}`,
+    flag.archivedAt ? `**Archived:** ${flag.archivedAt.slice(0, 10)} by ${flag.archivedBy}` : null
   ].filter(Boolean).join("\n");
   if (!history?.length) return parts;
   const historyLines = history.map((h) => {
@@ -34270,7 +34354,7 @@ function createHttpClient(config2) {
       );
       return result?.usedBy;
     },
-    // Feature flags (B-135 v9) — not available in HTTP transport; the published
+    // Feature flags (B-135 v9/v10) — not available in HTTP transport; the published
     // npm package has no DynamoDB credentials.
     listFlags: async () => {
       throw new Error("Feature flag queries are not available in HTTP transport mode");
@@ -34280,6 +34364,18 @@ function createHttpClient(config2) {
     },
     checkFlag: async () => {
       throw new Error("Feature flag queries are not available in HTTP transport mode");
+    },
+    createFlag: async () => {
+      throw new Error("Feature flag writes are not available in HTTP transport mode");
+    },
+    setFlag: async () => {
+      throw new Error("Feature flag writes are not available in HTTP transport mode");
+    },
+    archiveFlag: async () => {
+      throw new Error("Feature flag writes are not available in HTTP transport mode");
+    },
+    unarchiveFlag: async () => {
+      throw new Error("Feature flag writes are not available in HTTP transport mode");
     }
   };
   return client;
@@ -34330,7 +34426,7 @@ function loadConfig() {
   };
 }
 async function main() {
-  console.error(`[harmonica-mcp] v${"3.4.0"} starting\u2026`);
+  console.error(`[harmonica-mcp] v${"3.5.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.4.0",
+  "version": "3.5.0",
   "description": "MCP server for Harmonica — connect any MCP-compatible AI assistant to Harmonica",
   "license": "MIT",
   "bin": {