@ateam-ai/mcp 0.2.8 → 0.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ateam-ai/mcp",
-  "version": "0.2.8",
+  "version": "0.3.0",
   "mcpName": "io.github.ariekogan/ateam-mcp",
   "description": "A-Team MCP Server — build, validate, and deploy multi-agent solutions from any AI environment",
   "type": "module",

package/src/tools.js

@@ -63,7 +63,7 @@ export const tools = [
     name: "ateam_get_spec",
     core: true,
     description:
-      "Get the A-Team specification — schemas, validation rules, system tools, agent guides, and templates. Start here after bootstrap to understand how to build skills and solutions.",
+      "Get the A-Team specification — schemas, validation rules, system tools, agent guides, and templates. Start here after bootstrap to understand how to build skills and solutions. Use 'section' to get just one part of the skill spec (much smaller than the full spec). Use 'search' to find specific fields or concepts across the spec.",
     inputSchema: {
       type: "object",
       properties: {
@@ -71,7 +71,18 @@ export const tools = [
           type: "string",
           enum: ["overview", "skill", "solution", "enums", "connector-multi-user"],
           description:
-            "What to fetch: 'overview' = API overview + endpoints, 'skill' = full skill spec, 'solution' = full solution spec, 'enums' = all enum values, 'connector-multi-user' = multi-user connector guide (actor isolation, zod gotcha, complete examples)",
+            "What to fetch: 'overview' = API overview + endpoints, 'skill' = full skill spec, 'solution' = full solution spec, 'enums' = all enum values, 'connector-multi-user' = multi-user connector guide",
+        },
+        section: {
+          type: "string",
+          enum: ["engine", "tools", "intents", "policy", "triggers", "connectors", "role", "template", "guide"],
+          description:
+            "Optional: get just one section of the skill spec (only works with topic='skill'). Sections: 'engine' = model/reasoning/planner optimization/bootstrap tools, 'tools' = tool definitions/meta tools, 'intents' = intents/problem/scenarios, 'policy' = access control/grants/workflows, 'triggers' = automation triggers, 'connectors' = connector linking/channels, 'role' = persona/goals, 'template' = minimal quick start, 'guide' = build steps/common mistakes",
+        },
+        search: {
+          type: "string",
+          description:
+            "Optional: filter the spec to only sections containing this search term. Works with any topic. Example: search='bootstrap' returns only fields/sections mentioning 'bootstrap'.",
         },
       },
       required: ["topic"],
@@ -821,7 +832,68 @@ export const tools = [
   },
 
   // ═══════════════════════════════════════════════════════════════════
-  // MASTER KEY TOOLS — cross-tenant bulk operations (master key only)
+  // RELEASE MANAGEMENT — promote, rollback, version listing
+  // ═══════════════════════════════════════════════════════════════════
+
+  {
+    name: "ateam_github_promote",
+    core: true,
+    description:
+      "Promote a dev version to main (production). By default promotes the latest dev tag. Optionally specify a specific dev tag to promote. Creates a prod-YYYY-MM-DD-NNN tag on main.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        solution_id: {
+          type: "string",
+          description: "The solution ID",
+        },
+        tag: {
+          type: "string",
+          description: "Optional: specific dev tag to promote (e.g., 'dev-2026-03-11-005'). If omitted, promotes the latest dev tag.",
+        },
+      },
+      required: ["solution_id"],
+    },
+  },
+  {
+    name: "ateam_github_rollback",
+    core: true,
+    description:
+      "Rollback main (production) to a previous production tag. Resets main branch to the specified prod tag commit. ⚠️ DESTRUCTIVE — use with caution. Use ateam_github_list_versions to find available production tags first.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        solution_id: {
+          type: "string",
+          description: "The solution ID",
+        },
+        tag: {
+          type: "string",
+          description: "Required: production tag to rollback to (e.g., 'prod-2026-03-10-001')",
+        },
+      },
+      required: ["solution_id", "tag"],
+    },
+  },
+  {
+    name: "ateam_github_list_versions",
+    core: true,
+    description:
+      "List all available dev version tags for a solution. Shows tag name, date, counter, and commit SHA. Use before promoting to see what's available.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        solution_id: {
+          type: "string",
+          description: "The solution ID",
+        },
+      },
+      required: ["solution_id"],
+    },
+  },
+
+  // ═══════════════════════════════════════════════════════════════════
+  // INFRASTRUCTURE — redeploy, master key bulk operations
   // ═══════════════════════════════════════════════════════════════════
 
   {
@@ -1110,7 +1182,15 @@ const handlers = {
     }
   },
 
-  ateam_get_spec: async ({ topic }, sid) => get(SPEC_PATHS[topic], sid),
+  ateam_get_spec: async ({ topic, section, search }, sid) => {
+    let path = SPEC_PATHS[topic];
+    const params = new URLSearchParams();
+    if (section) params.set('section', section);
+    if (search) params.set('search', search);
+    const qs = params.toString();
+    if (qs) path += `?${qs}`;
+    return get(path, sid);
+  },
 
   ateam_get_workflows: async (_args, sid) => get("/spec/workflows", sid),
 
@@ -1494,6 +1574,15 @@ const handlers = {
     return get(`/deploy/solutions/${solution_id}/github/log${qs}`, sid);
   },
 
+  ateam_github_promote: async ({ solution_id, tag }, sid) =>
+    post(`/deploy/solutions/${solution_id}/promote`, tag ? { tag } : {}, sid),
+
+  ateam_github_rollback: async ({ solution_id, tag }, sid) =>
+    post(`/deploy/solutions/${solution_id}/rollback`, { tag }, sid),
+
+  ateam_github_list_versions: async ({ solution_id }, sid) =>
+    get(`/deploy/solutions/${solution_id}/versions/dev`, sid),
+
   ateam_delete_solution: async ({ solution_id }, sid) =>
     del(`/deploy/solutions/${solution_id}`, sid),