autoproject-mcp 1.0.0

package/dist/tools/launchPlanTools.js

@@ -0,0 +1,319 @@
+"use strict";
+/**
+ * MCP Tools: Launch Plan (Cutover Plan) Management
+ *
+ * Provides 9 tools for creating and maintaining launch plans and their activities
+ * through the AutoProject Agent API.
+ *
+ * Plan statuses:    DRAFT → PENDING_REVIEW → APPROVED → IN_PROGRESS → COMPLETED | CANCELLED
+ * Activity statuses: DRAFT → PENDING_REVIEW → APPROVED → READY → IN_PROGRESS → COMPLETED | BLOCKED | ROLLBACK | CANCELLED
+ * Environment types: WEB, MOBILE, CLOUD_INFRA, CUSTOM
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.launchPlanToolDefinitions = void 0;
+exports.handleLaunchPlanTool = handleLaunchPlanTool;
+const client_js_1 = require("../client.js");
+const DEFAULT_PRODUCT_ID = process.env.AUTOPROJECT_PRODUCT_ID ?? '';
+// ── Tool definitions ──────────────────────────────────────────────────────────
+exports.launchPlanToolDefinitions = [
+    {
+        name: 'list_launch_plans',
+        description: 'List all launch (cutover) plans for a product. Returns plan id, name, status, environmentType, and planned dates.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                productId: { type: 'string', description: 'Product UUID. Defaults to AUTOPROJECT_PRODUCT_ID env.' },
+            },
+            required: [],
+        },
+    },
+    {
+        name: 'get_launch_plan',
+        description: 'Get full details of a launch plan including all its activities.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                productId: { type: 'string', description: 'Product UUID. Defaults to AUTOPROJECT_PRODUCT_ID env.' },
+                planId: { type: 'string', description: 'Launch plan UUID.' },
+            },
+            required: ['planId'],
+        },
+    },
+    {
+        name: 'create_launch_plan',
+        description: 'Create a new launch plan in DRAFT status. Use this to plan a deployment or cutover event. ' +
+            'environmentType must be one of: WEB, MOBILE, CLOUD_INFRA, CUSTOM.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                productId: { type: 'string', description: 'Product UUID. Defaults to AUTOPROJECT_PRODUCT_ID env.' },
+                name: { type: 'string', description: 'Short descriptive name for the launch plan.' },
+                description: { type: 'string', description: 'Optional longer description.' },
+                environmentType: {
+                    type: 'string',
+                    enum: ['WEB', 'MOBILE', 'CLOUD_INFRA', 'CUSTOM'],
+                    description: 'Type of environment being launched. Default: WEB.',
+                },
+                plannedStart: { type: 'string', description: 'ISO 8601 planned start date/time.' },
+                plannedEnd: { type: 'string', description: 'ISO 8601 planned end date/time.' },
+            },
+            required: ['name'],
+        },
+    },
+    {
+        name: 'update_launch_plan',
+        description: 'Update metadata fields of an existing launch plan. Only provided fields are changed.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                productId: { type: 'string', description: 'Product UUID. Defaults to AUTOPROJECT_PRODUCT_ID env.' },
+                planId: { type: 'string', description: 'Launch plan UUID.' },
+                name: { type: 'string', description: 'New name.' },
+                description: { type: 'string', description: 'New description.' },
+                environmentType: {
+                    type: 'string',
+                    enum: ['WEB', 'MOBILE', 'CLOUD_INFRA', 'CUSTOM'],
+                    description: 'New environment type.',
+                },
+                plannedStart: { type: 'string', description: 'New planned start (ISO 8601).' },
+                plannedEnd: { type: 'string', description: 'New planned end (ISO 8601).' },
+            },
+            required: ['planId'],
+        },
+    },
+    {
+        name: 'change_launch_plan_status',
+        description: 'Transition a launch plan to a new status. Allowed flow: DRAFT → PENDING_REVIEW → APPROVED → IN_PROGRESS → COMPLETED. ' +
+            'CANCELLED is reachable from most statuses. Transitions are validated by the server.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                productId: { type: 'string', description: 'Product UUID. Defaults to AUTOPROJECT_PRODUCT_ID env.' },
+                planId: { type: 'string', description: 'Launch plan UUID.' },
+                status: {
+                    type: 'string',
+                    enum: ['DRAFT', 'PENDING_REVIEW', 'APPROVED', 'IN_PROGRESS', 'COMPLETED', 'CANCELLED'],
+                    description: 'Target status.',
+                },
+                notes: { type: 'string', description: 'Optional reason or notes for the transition.' },
+            },
+            required: ['planId', 'status'],
+        },
+    },
+    {
+        name: 'list_launch_activities',
+        description: 'List all activities belonging to a launch plan.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                productId: { type: 'string', description: 'Product UUID. Defaults to AUTOPROJECT_PRODUCT_ID env.' },
+                planId: { type: 'string', description: 'Launch plan UUID.' },
+            },
+            required: ['planId'],
+        },
+    },
+    {
+        name: 'create_launch_activity',
+        description: 'Add an activity (task step) to a launch plan. Activities are created in DRAFT status.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                productId: { type: 'string', description: 'Product UUID. Defaults to AUTOPROJECT_PRODUCT_ID env.' },
+                planId: { type: 'string', description: 'Launch plan UUID to add activity to.' },
+                title: { type: 'string', description: 'Short title for the activity.' },
+                description: { type: 'string', description: 'Detailed description.' },
+                ownerId: { type: 'string', description: 'User UUID of the person responsible.' },
+                estimatedDurationMins: { type: 'number', description: 'Estimated duration in minutes.' },
+                verificationCommand: { type: 'string', description: 'CLI command or URL to verify success.' },
+                rollbackStrategy: { type: 'string', description: 'Steps or command to roll back this activity.' },
+                sortOrder: { type: 'number', description: 'Display order among activities (lower = first).' },
+            },
+            required: ['planId', 'title'],
+        },
+    },
+    {
+        name: 'update_launch_activity',
+        description: 'Update fields of an existing launch activity. Only provided fields are changed.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                productId: { type: 'string', description: 'Product UUID. Defaults to AUTOPROJECT_PRODUCT_ID env.' },
+                planId: { type: 'string', description: 'Launch plan UUID.' },
+                activityId: { type: 'string', description: 'Activity UUID.' },
+                title: { type: 'string', description: 'New title.' },
+                description: { type: 'string', description: 'New description.' },
+                ownerId: { type: 'string', description: 'New owner user UUID.' },
+                estimatedDurationMins: { type: 'number', description: 'New estimated duration in minutes.' },
+                verificationCommand: { type: 'string', description: 'New verification command.' },
+                rollbackStrategy: { type: 'string', description: 'New rollback strategy.' },
+            },
+            required: ['planId', 'activityId'],
+        },
+    },
+    {
+        name: 'change_activity_status',
+        description: 'Transition a launch activity to a new status. ' +
+            'Allowed flow: DRAFT → PENDING_REVIEW → APPROVED → READY → IN_PROGRESS → COMPLETED. ' +
+            'BLOCKED and ROLLBACK are reachable from IN_PROGRESS. CANCELLED is reachable from most statuses. ' +
+            'READY requires all prerequisite activities to be COMPLETED. Transitions are validated by the server.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                productId: { type: 'string', description: 'Product UUID. Defaults to AUTOPROJECT_PRODUCT_ID env.' },
+                planId: { type: 'string', description: 'Launch plan UUID.' },
+                activityId: { type: 'string', description: 'Activity UUID.' },
+                status: {
+                    type: 'string',
+                    enum: ['DRAFT', 'PENDING_REVIEW', 'APPROVED', 'READY', 'IN_PROGRESS', 'BLOCKED', 'COMPLETED', 'ROLLBACK', 'CANCELLED'],
+                    description: 'Target status.',
+                },
+                notes: { type: 'string', description: 'Optional notes for the transition.' },
+            },
+            required: ['planId', 'activityId', 'status'],
+        },
+    },
+];
+// ── Handlers ──────────────────────────────────────────────────────────────────
+async function handleLaunchPlanTool(toolName, args) {
+    const productId = args.productId || DEFAULT_PRODUCT_ID;
+    if (!productId) {
+        return { content: [{ type: 'text', text: 'Error: productId is required (or set AUTOPROJECT_PRODUCT_ID env).' }] };
+    }
+    const planId = args.planId;
+    const activityId = args.activityId;
+    switch (toolName) {
+        case 'list_launch_plans': {
+            const data = await (0, client_js_1.apiGet)(`/products/${productId}/launch-plans`, {});
+            const plans = data?.items ?? [];
+            if (plans.length === 0) {
+                return { content: [{ type: 'text', text: 'No launch plans found.' }] };
+            }
+            const lines = plans.map((p) => `[${p.id}] ${p.name} | Status: ${p.status} | Env: ${p.environmentType ?? 'N/A'} | Planned: ${p.plannedStart ?? '?'} → ${p.plannedEnd ?? '?'}`);
+            return { content: [{ type: 'text', text: `Launch Plans (${plans.length}):\n${lines.join('\n')}` }] };
+        }
+        case 'get_launch_plan': {
+            if (!planId)
+                return { content: [{ type: 'text', text: 'Error: planId is required.' }] };
+            const data = await (0, client_js_1.apiGet)(`/products/${productId}/launch-plans/${planId}`, {});
+            const plan = data;
+            const activities = plan?.activities ?? [];
+            const header = `Plan: ${plan.name}\nID: ${plan.id}\nStatus: ${plan.status} | Env: ${plan.environmentType}\nPlanned: ${plan.plannedStart ?? '?'} → ${plan.plannedEnd ?? '?'}\nDescription: ${plan.description ?? 'N/A'}`;
+            const actLines = activities.length
+                ? activities
+                    .map((a) => `  [${a.id}] #${a.sortOrder} ${a.title} — ${a.status} (est: ${a.estimatedDurationMins ?? '?'} min)`)
+                    .join('\n')
+                : '  (no activities)';
+            return { content: [{ type: 'text', text: `${header}\n\nActivities:\n${actLines}` }] };
+        }
+        case 'create_launch_plan': {
+            const body = { name: args.name };
+            if (args.description !== undefined)
+                body.description = args.description;
+            if (args.environmentType !== undefined)
+                body.environmentType = args.environmentType;
+            if (args.plannedStart !== undefined)
+                body.plannedStart = args.plannedStart;
+            if (args.plannedEnd !== undefined)
+                body.plannedEnd = args.plannedEnd;
+            const data = await (0, client_js_1.apiPost)(`/products/${productId}/launch-plans`, body);
+            const plan = data;
+            return { content: [{ type: 'text', text: `Launch plan created.\nID: ${plan.id}\nName: ${plan.name}\nStatus: ${plan.status}` }] };
+        }
+        case 'update_launch_plan': {
+            if (!planId)
+                return { content: [{ type: 'text', text: 'Error: planId is required.' }] };
+            const body = {};
+            if (args.name !== undefined)
+                body.name = args.name;
+            if (args.description !== undefined)
+                body.description = args.description;
+            if (args.environmentType !== undefined)
+                body.environmentType = args.environmentType;
+            if (args.plannedStart !== undefined)
+                body.plannedStart = args.plannedStart;
+            if (args.plannedEnd !== undefined)
+                body.plannedEnd = args.plannedEnd;
+            const data = await (0, client_js_1.apiPatch)(`/products/${productId}/launch-plans/${planId}`, body);
+            const plan = data;
+            return { content: [{ type: 'text', text: `Launch plan updated.\nID: ${plan.id}\nName: ${plan.name}\nStatus: ${plan.status}` }] };
+        }
+        case 'change_launch_plan_status': {
+            if (!planId)
+                return { content: [{ type: 'text', text: 'Error: planId is required.' }] };
+            const body = { status: args.status };
+            if (args.notes !== undefined)
+                body.notes = args.notes;
+            const data = await (0, client_js_1.apiPatch)(`/products/${productId}/launch-plans/${planId}/status`, body);
+            const plan = data;
+            return { content: [{ type: 'text', text: `Launch plan status changed.\nID: ${plan.id}\nNew status: ${plan.status}` }] };
+        }
+        case 'list_launch_activities': {
+            if (!planId)
+                return { content: [{ type: 'text', text: 'Error: planId is required.' }] };
+            const data = await (0, client_js_1.apiGet)(`/products/${productId}/launch-plans/${planId}/activities`, {});
+            const activities = data?.items ?? [];
+            if (activities.length === 0) {
+                return { content: [{ type: 'text', text: 'No activities found for this plan.' }] };
+            }
+            const lines = activities.map((a) => `[${a.id}] #${a.sortOrder} ${a.title} — ${a.status} (est: ${a.estimatedDurationMins ?? '?'} min)`);
+            return { content: [{ type: 'text', text: `Activities (${activities.length}):\n${lines.join('\n')}` }] };
+        }
+        case 'create_launch_activity': {
+            if (!planId)
+                return { content: [{ type: 'text', text: 'Error: planId is required.' }] };
+            const body = { title: args.title };
+            if (args.description !== undefined)
+                body.description = args.description;
+            if (args.ownerId !== undefined)
+                body.ownerId = args.ownerId;
+            if (args.estimatedDurationMins !== undefined)
+                body.estimatedDurationMins = args.estimatedDurationMins;
+            if (args.verificationCommand !== undefined)
+                body.verificationCommand = args.verificationCommand;
+            if (args.rollbackStrategy !== undefined)
+                body.rollbackStrategy = args.rollbackStrategy;
+            if (args.sortOrder !== undefined)
+                body.sortOrder = args.sortOrder;
+            const data = await (0, client_js_1.apiPost)(`/products/${productId}/launch-plans/${planId}/activities`, body);
+            const activity = data;
+            return { content: [{ type: 'text', text: `Activity created.\nID: ${activity.id}\nTitle: ${activity.title}\nStatus: ${activity.status}` }] };
+        }
+        case 'update_launch_activity': {
+            if (!planId)
+                return { content: [{ type: 'text', text: 'Error: planId is required.' }] };
+            if (!activityId)
+                return { content: [{ type: 'text', text: 'Error: activityId is required.' }] };
+            const body = {};
+            if (args.title !== undefined)
+                body.title = args.title;
+            if (args.description !== undefined)
+                body.description = args.description;
+            if (args.ownerId !== undefined)
+                body.ownerId = args.ownerId;
+            if (args.estimatedDurationMins !== undefined)
+                body.estimatedDurationMins = args.estimatedDurationMins;
+            if (args.verificationCommand !== undefined)
+                body.verificationCommand = args.verificationCommand;
+            if (args.rollbackStrategy !== undefined)
+                body.rollbackStrategy = args.rollbackStrategy;
+            const data = await (0, client_js_1.apiPatch)(`/products/${productId}/launch-plans/${planId}/activities/${activityId}`, body);
+            const activity = data;
+            return { content: [{ type: 'text', text: `Activity updated.\nID: ${activity.id}\nTitle: ${activity.title}\nStatus: ${activity.status}` }] };
+        }
+        case 'change_activity_status': {
+            if (!planId)
+                return { content: [{ type: 'text', text: 'Error: planId is required.' }] };
+            if (!activityId)
+                return { content: [{ type: 'text', text: 'Error: activityId is required.' }] };
+            const body = { status: args.status };
+            if (args.notes !== undefined)
+                body.notes = args.notes;
+            const data = await (0, client_js_1.apiPatch)(`/products/${productId}/launch-plans/${planId}/activities/${activityId}/status`, body);
+            const activity = data;
+            return { content: [{ type: 'text', text: `Activity status changed.\nID: ${activity.id}\nTitle: ${activity.title}\nNew status: ${activity.status}` }] };
+        }
+        default:
+            return { content: [{ type: 'text', text: `Unknown launch plan tool: ${toolName}` }] };
+    }
+}
+//# sourceMappingURL=launchPlanTools.js.map

package/dist/tools/launchPlanTools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"launchPlanTools.js","sourceRoot":"","sources":["../../src/tools/launchPlanTools.ts"],"names":[],"mappings":"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"}

package/dist/tools/productTools.d.ts

@@ -0,0 +1,8 @@
+/**
+ * MCP Tools: Product discovery and context bundle
+ * Tools: ping, get_capabilities, list_products, get_product_context, search_product
+ */
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+export declare const productToolDefinitions: Tool[];
+export declare function handleProductTool(name: string, args: Record<string, unknown>): Promise<unknown>;
+//# sourceMappingURL=productTools.d.ts.map

package/dist/tools/productTools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"productTools.d.ts","sourceRoot":"","sources":["../../src/tools/productTools.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAG1D,eAAO,MAAM,sBAAsB,EAAE,IAAI,EAiDxC,CAAC;AAEF,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,oBAoBlF"}

package/dist/tools/productTools.js

@@ -0,0 +1,80 @@
+"use strict";
+/**
+ * MCP Tools: Product discovery and context bundle
+ * Tools: ping, get_capabilities, list_products, get_product_context, search_product
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.productToolDefinitions = void 0;
+exports.handleProductTool = handleProductTool;
+const client_js_1 = require("../client.js");
+exports.productToolDefinitions = [
+    {
+        name: 'ping',
+        description: 'Check if the AutoProject agent API is reachable and return server health.',
+        inputSchema: { type: 'object', properties: {} },
+    },
+    {
+        name: 'get_capabilities',
+        description: 'Discover what this API key can do: granted scopes, autonomy level, available tools, and org policy. '
+            + 'Call this first when a tool returns a permission error (403) — if a tool you need is missing from the '
+            + "scopes list (e.g. read:defects for list_defects), the key is not authorized for it and the workspace "
+            + 'owner must grant that scope in AutoProject. Also serves as a usage guide for which tools are available.',
+        inputSchema: { type: 'object', properties: {} },
+    },
+    {
+        name: 'list_products',
+        description: 'List all products in the organisation that this API key can access.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                limit: { type: 'number', description: 'Max results (default 50, max 200)' },
+            },
+        },
+    },
+    {
+        name: 'get_product_context',
+        description: 'Get a concise LLM-optimised context bundle for a product, including open features, defects, and status summary. Call this at the start of a session.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                productId: { type: 'string', description: 'Product ID' },
+            },
+            required: ['productId'],
+        },
+    },
+    {
+        name: 'search_product',
+        description: 'Full-text search across features and defects within a product.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                productId: { type: 'string', description: 'Product ID' },
+                query: { type: 'string', description: 'Search query' },
+                limit: { type: 'number', description: 'Max results' },
+            },
+            required: ['productId', 'query'],
+        },
+    },
+];
+async function handleProductTool(name, args) {
+    switch (name) {
+        case 'ping': {
+            return await (0, client_js_1.apiGet)('/health');
+        }
+        case 'get_capabilities': {
+            return await (0, client_js_1.apiGet)('/capabilities');
+        }
+        case 'list_products': {
+            return await (0, client_js_1.apiGet)('/products', { limit: args.limit });
+        }
+        case 'get_product_context': {
+            return await (0, client_js_1.apiGet)(`/products/${args.productId}/context-bundle`);
+        }
+        case 'search_product': {
+            return await (0, client_js_1.apiGet)(`/products/${args.productId}/search`, { q: args.query, limit: args.limit });
+        }
+        default:
+            throw new Error(`Unknown product tool: ${name}`);
+    }
+}
+//# sourceMappingURL=productTools.js.map

package/dist/tools/productTools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"productTools.js","sourceRoot":"","sources":["../../src/tools/productTools.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAwDH,8CAoBC;AAzED,4CAA+C;AAElC,QAAA,sBAAsB,GAAW;IAC5C;QACE,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,2EAA2E;QACxF,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE;KAChD;IACD;QACE,IAAI,EAAE,kBAAkB;QACxB,WAAW,EACT,sGAAsG;cACpG,wGAAwG;cACxG,uGAAuG;cACvG,yGAAyG;QAC7G,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE;KAChD;IACD;QACE,IAAI,EAAE,eAAe;QACrB,WAAW,EAAE,qEAAqE;QAClF,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mCAAmC,EAAE;aAC5E;SACF;KACF;IACD;QACE,IAAI,EAAE,qBAAqB;QAC3B,WAAW,EAAE,sJAAsJ;QACnK,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE;aACzD;YACD,QAAQ,EAAE,CAAC,WAAW,CAAC;SACxB;KACF;IACD;QACE,IAAI,EAAE,gBAAgB;QACtB,WAAW,EAAE,gEAAgE;QAC7E,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE;gBACxD,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,cAAc,EAAE;gBACtD,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,aAAa,EAAE;aACtD;YACD,QAAQ,EAAE,CAAC,WAAW,EAAE,OAAO,CAAC;SACjC;KACF;CACF,CAAC;AAEK,KAAK,UAAU,iBAAiB,CAAC,IAAY,EAAE,IAA6B;IACjF,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,OAAO,MAAM,IAAA,kBAAM,EAAC,SAAS,CAAC,CAAC;QACjC,CAAC;QACD,KAAK,kBAAkB,CAAC,CAAC,CAAC;YACxB,OAAO,MAAM,IAAA,kBAAM,EAAC,eAAe,CAAC,CAAC;QACvC,CAAC;QACD,KAAK,eAAe,CAAC,CAAC,CAAC;YACrB,OAAO,MAAM,IAAA,kBAAM,EAAC,WAAW,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;QAC1D,CAAC;QACD,KAAK,qBAAqB,CAAC,CAAC,CAAC;YAC3B,OAAO,MAAM,IAAA,kBAAM,EAAC,aAAa,IAAI,CAAC,SAAS,iBAAiB,CAAC,CAAC;QACpE,CAAC;QACD,KAAK,gBAAgB,CAAC,CAAC,CAAC;YACtB,OAAO,MAAM,IAAA,kBAAM,EAAC,aAAa,IAAI,CAAC,SAAS,SAAS,EAAE,EAAE,CAAC,EAAE,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;QAClG,CAAC;QACD;YACE,MAAM,IAAI,KAAK,CAAC,yBAAyB,IAAI,EAAE,CAAC,CAAC;IACrD,CAAC;AACH,CAAC"}

package/dist/tools/releaseCycleLinkTools.d.ts

@@ -0,0 +1,24 @@
+/**
+ * MCP Tools: Release cycle linking for feature groups and sub-features.
+ *
+ * Workflow for IDE agents:
+ *   1. Call list_release_cycles (existing tool) to discover available cycles and their IDs.
+ *   2. Call get_feature_group_release_cycle / get_feature_release_cycle to check if already linked.
+ *   3. If missing or wrong, call set_feature_group_release_cycle / set_feature_release_cycle.
+ *
+ * Terminology (aligned with AGENTS.md):
+ *   "feature group"  = DB FeatureGroup / API "features"     (Feature Group in UI)
+ *   "feature"        = DB SubFeature   / API "sub-features" (Feature in UI)
+ *
+ * Cascade note: setting a release cycle on a feature group automatically cascades
+ * to child features that previously inherited the old parent cycle.
+ */
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+export declare const releaseCycleLinkToolDefinitions: Tool[];
+export declare function handleReleaseCycleLinkTool(toolName: string, args: Record<string, unknown>): Promise<{
+    content: {
+        type: string;
+        text: string;
+    }[];
+}>;
+//# sourceMappingURL=releaseCycleLinkTools.d.ts.map

package/dist/tools/releaseCycleLinkTools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"releaseCycleLinkTools.d.ts","sourceRoot":"","sources":["../../src/tools/releaseCycleLinkTools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAK1D,eAAO,MAAM,+BAA+B,EAAE,IAAI,EAgEjD,CAAC;AAEF,wBAAsB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;GAqG/F"}

package/dist/tools/releaseCycleLinkTools.js

@@ -0,0 +1,174 @@
+"use strict";
+/**
+ * MCP Tools: Release cycle linking for feature groups and sub-features.
+ *
+ * Workflow for IDE agents:
+ *   1. Call list_release_cycles (existing tool) to discover available cycles and their IDs.
+ *   2. Call get_feature_group_release_cycle / get_feature_release_cycle to check if already linked.
+ *   3. If missing or wrong, call set_feature_group_release_cycle / set_feature_release_cycle.
+ *
+ * Terminology (aligned with AGENTS.md):
+ *   "feature group"  = DB FeatureGroup / API "features"     (Feature Group in UI)
+ *   "feature"        = DB SubFeature   / API "sub-features" (Feature in UI)
+ *
+ * Cascade note: setting a release cycle on a feature group automatically cascades
+ * to child features that previously inherited the old parent cycle.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.releaseCycleLinkToolDefinitions = void 0;
+exports.handleReleaseCycleLinkTool = handleReleaseCycleLinkTool;
+const client_js_1 = require("../client.js");
+const DEFAULT_PRODUCT_ID = process.env.AUTOPROJECT_PRODUCT_ID ?? '';
+exports.releaseCycleLinkToolDefinitions = [
+    {
+        name: 'get_feature_group_release_cycle',
+        description: 'Get the effective release cycle assigned to a feature group (Feature Group in UI). ' +
+            'Returns the cycle details plus an "inherited" flag — true means the cycle comes from a parent (module), ' +
+            'false means it is directly assigned. Returns null if no cycle is assigned at any level. ' +
+            'Use this to detect missing release cycle links before calling set_feature_group_release_cycle.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                productId: { type: 'string', description: 'Product UUID. Defaults to AUTOPROJECT_PRODUCT_ID env.' },
+                featureId: { type: 'string', description: 'Feature group UUID (the "Feature Group" in the UI).' },
+            },
+            required: ['featureId'],
+        },
+    },
+    {
+        name: 'set_feature_group_release_cycle',
+        description: 'Assign or update the release cycle for a feature group (Feature Group in UI). ' +
+            'Replaces any existing assignment. Also cascades to child features that previously ' +
+            'inherited the old parent cycle. Use list_release_cycles to get valid releaseCycleIds.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                productId: { type: 'string', description: 'Product UUID. Defaults to AUTOPROJECT_PRODUCT_ID env.' },
+                featureId: { type: 'string', description: 'Feature group UUID.' },
+                releaseCycleId: { type: 'string', description: 'Release cycle UUID to assign.' },
+            },
+            required: ['featureId', 'releaseCycleId'],
+        },
+    },
+    {
+        name: 'get_feature_release_cycle',
+        description: 'Get the effective release cycle for a feature (Feature in UI, called sub-feature in the API). ' +
+            'Returns cycle details plus "inherited" flag — if inherited=true, the cycle comes from the parent feature group. ' +
+            'Returns null if no cycle is assigned at any level.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                productId: { type: 'string', description: 'Product UUID. Defaults to AUTOPROJECT_PRODUCT_ID env.' },
+                subFeatureId: { type: 'string', description: 'Feature UUID (the "Feature" in the UI, sub-feature in the API).' },
+            },
+            required: ['subFeatureId'],
+        },
+    },
+    {
+        name: 'set_feature_release_cycle',
+        description: 'Assign or update the release cycle for a specific feature (Feature in UI, sub-feature in API). ' +
+            'This overrides any inherited cycle from the parent feature group with an explicit direct assignment. ' +
+            'Use list_release_cycles to get valid releaseCycleIds.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                productId: { type: 'string', description: 'Product UUID. Defaults to AUTOPROJECT_PRODUCT_ID env.' },
+                subFeatureId: { type: 'string', description: 'Feature UUID (sub-feature in the API).' },
+                releaseCycleId: { type: 'string', description: 'Release cycle UUID to assign.' },
+            },
+            required: ['subFeatureId', 'releaseCycleId'],
+        },
+    },
+];
+async function handleReleaseCycleLinkTool(toolName, args) {
+    const productId = args.productId || DEFAULT_PRODUCT_ID;
+    if (!productId) {
+        return { content: [{ type: 'text', text: 'Error: productId is required (or set AUTOPROJECT_PRODUCT_ID env).' }] };
+    }
+    switch (toolName) {
+        case 'get_feature_group_release_cycle': {
+            const featureId = args.featureId;
+            if (!featureId)
+                return { content: [{ type: 'text', text: 'Error: featureId is required.' }] };
+            const data = await (0, client_js_1.apiGet)(`/products/${productId}/features/${featureId}/release-cycle`);
+            if (data === null || data === undefined) {
+                return { content: [{ type: 'text', text: 'No release cycle is assigned to this feature group.' }] };
+            }
+            const cycle = data;
+            const inheritedNote = cycle.inherited ? ' (inherited from parent module)' : ' (directly assigned)';
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Release cycle for feature group ${featureId}:\n` +
+                            `[${cycle.id}] ${cycle.name}${inheritedNote}\n` +
+                            `Status: ${cycle.status ?? 'N/A'} | ${cycle.startDate ?? '?'} → ${cycle.endDate ?? '?'}`,
+                    },
+                ],
+            };
+        }
+        case 'set_feature_group_release_cycle': {
+            const featureId = args.featureId;
+            if (!featureId)
+                return { content: [{ type: 'text', text: 'Error: featureId is required.' }] };
+            const releaseCycleId = args.releaseCycleId;
+            if (!releaseCycleId)
+                return { content: [{ type: 'text', text: 'Error: releaseCycleId is required.' }] };
+            const data = await (0, client_js_1.apiPut)(`/products/${productId}/features/${featureId}/release-cycle`, { releaseCycleId });
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Release cycle assigned to feature group.\n` +
+                            `Feature group: ${featureId}\n` +
+                            `Cycle: [${data.releaseCycleId}] ${data.releaseCycleName}\n` +
+                            `(Child features that shared the previous cycle have been updated too.)`,
+                    },
+                ],
+            };
+        }
+        case 'get_feature_release_cycle': {
+            const subFeatureId = args.subFeatureId;
+            if (!subFeatureId)
+                return { content: [{ type: 'text', text: 'Error: subFeatureId is required.' }] };
+            const data = await (0, client_js_1.apiGet)(`/products/${productId}/sub-features/${subFeatureId}/release-cycle`);
+            if (data === null || data === undefined) {
+                return { content: [{ type: 'text', text: 'No release cycle is assigned to this feature (not even inherited).' }] };
+            }
+            const cycle = data;
+            const inheritedNote = cycle.inherited ? ' (inherited from parent feature group)' : ' (directly assigned)';
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Release cycle for feature ${subFeatureId}:\n` +
+                            `[${cycle.id}] ${cycle.name}${inheritedNote}\n` +
+                            `Status: ${cycle.status ?? 'N/A'} | ${cycle.startDate ?? '?'} → ${cycle.endDate ?? '?'}`,
+                    },
+                ],
+            };
+        }
+        case 'set_feature_release_cycle': {
+            const subFeatureId = args.subFeatureId;
+            if (!subFeatureId)
+                return { content: [{ type: 'text', text: 'Error: subFeatureId is required.' }] };
+            const releaseCycleId = args.releaseCycleId;
+            if (!releaseCycleId)
+                return { content: [{ type: 'text', text: 'Error: releaseCycleId is required.' }] };
+            const data = await (0, client_js_1.apiPut)(`/products/${productId}/sub-features/${subFeatureId}/release-cycle`, { releaseCycleId });
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Release cycle assigned to feature.\n` +
+                            `Feature: ${subFeatureId}\n` +
+                            `Cycle: [${data.releaseCycleId}] ${data.releaseCycleName}`,
+                    },
+                ],
+            };
+        }
+        default:
+            return { content: [{ type: 'text', text: `Unknown release cycle link tool: ${toolName}` }] };
+    }
+}
+//# sourceMappingURL=releaseCycleLinkTools.js.map