autoproject-mcp 1.0.0

package/dist/tools/useCaseTools.js

@@ -0,0 +1,238 @@
+"use strict";
+/**
+ * MCP Tools: Use case management
+ * Tools: list_use_cases, get_use_case, create_use_case, update_use_case, change_use_case_status
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useCaseToolDefinitions = void 0;
+exports.handleUseCaseTool = handleUseCaseTool;
+const client_js_1 = require("../client.js");
+const PRODUCT_ID = process.env.AUTOPROJECT_PRODUCT_ID ?? '';
+function resolveProductId(args) {
+    return args.productId || PRODUCT_ID;
+}
+exports.useCaseToolDefinitions = [
+    {
+        name: 'list_use_cases',
+        description: 'List use cases in a product. Supports filtering by status, priority, module, feature group, or feature. ' +
+            'Statuses: DRAFT, UNDER_REVIEW, APPROVED, DEPRECATED, ARCHIVED.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                productId: { type: 'string', description: 'Product ID (falls back to AUTOPROJECT_PRODUCT_ID env var)' },
+                status: { type: 'string', description: 'Filter by status (DRAFT | UNDER_REVIEW | APPROVED | DEPRECATED | ARCHIVED)' },
+                priority: { type: 'string', description: 'Filter by priority (CRITICAL | HIGH | MEDIUM | LOW)' },
+                moduleId: { type: 'string', description: 'Filter by module ID' },
+                featureGroupId: { type: 'string', description: 'Filter by feature group ID' },
+                featureId: { type: 'string', description: 'Filter by feature (SubFeature) ID' },
+                search: { type: 'string', description: 'Search by name, description, or actor' },
+                limit: { type: 'number', description: 'Max results (default 50, max 200)' },
+                cursor: { type: 'string', description: 'Pagination cursor from previous response' },
+            },
+            required: [],
+        },
+    },
+    {
+        name: 'get_use_case',
+        description: 'Get full detail of a use case including description, actor, flow preconditions/postconditions, and main flow steps.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                productId: { type: 'string', description: 'Product ID (falls back to AUTOPROJECT_PRODUCT_ID env var)' },
+                useCaseId: { type: 'string', description: 'Use case ID' },
+            },
+            required: ['useCaseId'],
+        },
+    },
+    {
+        name: 'create_use_case',
+        description: 'Create a new use case in DRAFT status. Link it to a module, feature group, or feature to give it context. ' +
+            'Priorities: CRITICAL, HIGH, MEDIUM (default), LOW. Complexities: LOW, MEDIUM (default), HIGH, VERY_HIGH.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                productId: { type: 'string', description: 'Product ID (falls back to AUTOPROJECT_PRODUCT_ID env var)' },
+                name: { type: 'string', description: 'Use case name (required)' },
+                description: { type: 'string', description: 'Detailed description of what the use case covers' },
+                actor: { type: 'string', description: 'The user or system that initiates the use case (e.g. "Registered User", "Admin")' },
+                trigger: { type: 'string', description: 'What triggers this use case (e.g. "User clicks Login button")' },
+                preconditions: { type: 'string', description: 'Conditions that must be true before execution starts' },
+                postconditions: { type: 'string', description: 'Conditions that must be true after successful execution' },
+                priority: {
+                    type: 'string',
+                    enum: ['CRITICAL', 'HIGH', 'MEDIUM', 'LOW'],
+                    description: 'Priority (default: MEDIUM)',
+                },
+                complexity: {
+                    type: 'string',
+                    enum: ['LOW', 'MEDIUM', 'HIGH', 'VERY_HIGH'],
+                    description: 'Complexity (default: MEDIUM)',
+                },
+                moduleId: { type: 'string', description: 'ID of the module this use case belongs to' },
+                featureGroupId: { type: 'string', description: 'ID of the feature group this use case belongs to' },
+                featureId: { type: 'string', description: 'ID of the feature (SubFeature) this use case belongs to' },
+                tags: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Optional tags for categorisation',
+                },
+                estimatedMinutes: { type: 'number', description: 'Estimated execution time in minutes' },
+            },
+            required: ['name'],
+        },
+    },
+    {
+        name: 'update_use_case',
+        description: 'Update an existing use case. Only provide the fields you want to change — all fields are optional. ' +
+            'Does not change status (use change_use_case_status for that).',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                productId: { type: 'string', description: 'Product ID (falls back to AUTOPROJECT_PRODUCT_ID env var)' },
+                useCaseId: { type: 'string', description: 'Use case ID to update (required)' },
+                name: { type: 'string', description: 'New name' },
+                description: { type: 'string', description: 'New description' },
+                actor: { type: 'string', description: 'Updated actor' },
+                trigger: { type: 'string', description: 'Updated trigger' },
+                preconditions: { type: 'string', description: 'Updated preconditions' },
+                postconditions: { type: 'string', description: 'Updated postconditions' },
+                priority: { type: 'string', enum: ['CRITICAL', 'HIGH', 'MEDIUM', 'LOW'], description: 'Updated priority' },
+                complexity: { type: 'string', enum: ['LOW', 'MEDIUM', 'HIGH', 'VERY_HIGH'], description: 'Updated complexity' },
+                moduleId: { type: 'string', description: 'Updated module ID' },
+                featureGroupId: { type: 'string', description: 'Updated feature group ID' },
+                featureId: { type: 'string', description: 'Updated feature ID' },
+                tags: { type: 'array', items: { type: 'string' }, description: 'Replacement tag list' },
+                estimatedMinutes: { type: 'number', description: 'Updated estimated minutes' },
+                changeSummary: { type: 'string', description: 'Brief note describing what was changed (for audit log)' },
+            },
+            required: ['useCaseId'],
+        },
+    },
+    {
+        name: 'change_use_case_status',
+        description: 'Change the status of a use case. Allowed transitions: ' +
+            'DRAFT → UNDER_REVIEW or ARCHIVED, ' +
+            'UNDER_REVIEW → APPROVED, DRAFT, or ARCHIVED, ' +
+            'APPROVED → DEPRECATED or ARCHIVED, ' +
+            'DEPRECATED → ARCHIVED.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                productId: { type: 'string', description: 'Product ID (falls back to AUTOPROJECT_PRODUCT_ID env var)' },
+                useCaseId: { type: 'string', description: 'Use case ID (required)' },
+                status: {
+                    type: 'string',
+                    enum: ['DRAFT', 'UNDER_REVIEW', 'APPROVED', 'DEPRECATED', 'ARCHIVED'],
+                    description: 'Target status (required)',
+                },
+                reason: { type: 'string', description: 'Reason for the status change (optional, logged in audit)' },
+            },
+            required: ['useCaseId', 'status'],
+        },
+    },
+];
+async function handleUseCaseTool(name, args) {
+    const productId = resolveProductId(args);
+    switch (name) {
+        case 'list_use_cases': {
+            const params = {};
+            if (args.status)
+                params.status = args.status;
+            if (args.priority)
+                params.priority = args.priority;
+            if (args.moduleId)
+                params.moduleId = args.moduleId;
+            if (args.featureGroupId)
+                params.featureGroupId = args.featureGroupId;
+            if (args.featureId)
+                params.featureId = args.featureId;
+            if (args.search)
+                params.search = args.search;
+            if (args.limit)
+                params.limit = args.limit;
+            if (args.cursor)
+                params.cursor = args.cursor;
+            const result = await (0, client_js_1.apiGet)(`/products/${productId}/use-cases`, params);
+            const items = result.items ?? [];
+            const lines = items.map((uc) => {
+                const u = uc;
+                return `- [${u.id}] ${u.name} | status: ${u.status} | priority: ${u.priority} | complexity: ${u.complexity}`;
+            });
+            return [
+                `Found ${items.length} use case(s):`,
+                ...lines,
+                result.nextCursor ? `\nNext cursor: ${result.nextCursor}` : '',
+            ]
+                .filter(Boolean)
+                .join('\n');
+        }
+        case 'get_use_case': {
+            const uc = await (0, client_js_1.apiGet)(`/products/${productId}/use-cases/${args.useCaseId}`);
+            const steps = uc.steps ?? [];
+            const stepLines = steps.map((s) => {
+                const step = s;
+                return `  ${step.stepNumber}. ${step.actionDescription}${step.expectedBehavior ? ` → ${step.expectedBehavior}` : ''}`;
+            });
+            return [
+                `**${uc.name}** [${uc.id}]`,
+                `Status: ${uc.status} | Priority: ${uc.priority} | Complexity: ${uc.complexity}`,
+                uc.actor ? `Actor: ${uc.actor}` : null,
+                uc.trigger ? `Trigger: ${uc.trigger}` : null,
+                uc.description ? `\nDescription:\n${uc.description}` : null,
+                uc.preconditions ? `\nPreconditions:\n${uc.preconditions}` : null,
+                uc.postconditions ? `\nPostconditions:\n${uc.postconditions}` : null,
+                stepLines.length ? `\nMain Flow Steps:\n${stepLines.join('\n')}` : null,
+            ]
+                .filter(Boolean)
+                .join('\n');
+        }
+        case 'create_use_case': {
+            const body = { name: args.name };
+            if (args.description !== undefined)
+                body.description = args.description;
+            if (args.actor !== undefined)
+                body.actor = args.actor;
+            if (args.trigger !== undefined)
+                body.trigger = args.trigger;
+            if (args.preconditions !== undefined)
+                body.preconditions = args.preconditions;
+            if (args.postconditions !== undefined)
+                body.postconditions = args.postconditions;
+            if (args.priority !== undefined)
+                body.priority = args.priority;
+            if (args.complexity !== undefined)
+                body.complexity = args.complexity;
+            if (args.moduleId !== undefined)
+                body.moduleId = args.moduleId;
+            if (args.featureGroupId !== undefined)
+                body.featureGroupId = args.featureGroupId;
+            if (args.featureId !== undefined)
+                body.featureId = args.featureId;
+            if (args.tags !== undefined)
+                body.tags = args.tags;
+            if (args.estimatedMinutes !== undefined)
+                body.estimatedMinutes = args.estimatedMinutes;
+            const result = await (0, client_js_1.apiPost)(`/products/${productId}/use-cases`, body);
+            return `Use case created successfully.\nID: ${result.id}\nName: ${result.name}\nStatus: ${result.status} (DRAFT)`;
+        }
+        case 'update_use_case': {
+            const body = {};
+            const fields = ['name', 'description', 'actor', 'trigger', 'preconditions', 'postconditions',
+                'priority', 'complexity', 'moduleId', 'featureGroupId', 'featureId', 'tags',
+                'estimatedMinutes', 'changeSummary'];
+            for (const f of fields) {
+                if (args[f] !== undefined)
+                    body[f] = args[f];
+            }
+            await (0, client_js_1.apiPatch)(`/products/${productId}/use-cases/${args.useCaseId}`, body);
+            return `Use case ${args.useCaseId} updated successfully.`;
+        }
+        case 'change_use_case_status': {
+            const result = await (0, client_js_1.apiPatch)(`/products/${productId}/use-cases/${args.useCaseId}/status`, { status: args.status, reason: args.reason ?? null });
+            return `Use case ${result.id} status changed to ${result.status}.`;
+        }
+        default:
+            throw new Error(`Unknown use case tool: ${name}`);
+    }
+}
+//# sourceMappingURL=useCaseTools.js.map

package/dist/tools/useCaseTools.js.map

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

package/dist/tools/workTools.d.ts

@@ -0,0 +1,8 @@
+/**
+ * MCP Tools: Work lease management
+ * Tools: list_work_items, claim_work, heartbeat_work, complete_work
+ */
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+export declare const workToolDefinitions: Tool[];
+export declare function handleWorkTool(name: string, args: Record<string, unknown>): Promise<unknown>;
+//# sourceMappingURL=workTools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workTools.d.ts","sourceRoot":"","sources":["../../src/tools/workTools.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAG1D,eAAO,MAAM,mBAAmB,EAAE,IAAI,EAyDrC,CAAC;AAEF,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,oBA8B/E"}

package/dist/tools/workTools.js

@@ -0,0 +1,99 @@
+"use strict";
+/**
+ * MCP Tools: Work lease management
+ * Tools: list_work_items, claim_work, heartbeat_work, complete_work
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.workToolDefinitions = void 0;
+exports.handleWorkTool = handleWorkTool;
+const client_js_1 = require("../client.js");
+exports.workToolDefinitions = [
+    {
+        name: 'list_work_items',
+        description: 'List available work items (features) that can be claimed by an agent.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                productId: { type: 'string', description: 'Product ID' },
+                leaseState: { type: 'string', enum: ['available', 'claimed', 'all'], description: 'Filter by lease state (default: available)' },
+                limit: { type: 'number', description: 'Max results' },
+            },
+            required: ['productId'],
+        },
+    },
+    {
+        name: 'claim_work',
+        description: 'Claim exclusive ownership of a work item (feature) for 30 minutes. Returns a lease ID.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                productId: { type: 'string', description: 'Product ID' },
+                workItemId: { type: 'string', description: 'Feature/work item ID to claim' },
+                entityType: { type: 'string', description: 'Entity type (default: feature)' },
+            },
+            required: ['productId', 'workItemId'],
+        },
+    },
+    {
+        name: 'heartbeat_work',
+        description: 'Extend a work lease by 30 minutes to prevent expiry during long operations.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                productId: { type: 'string', description: 'Product ID' },
+                workItemId: { type: 'string', description: 'Work item ID' },
+                leaseId: { type: 'string', description: 'Lease ID from claim_work' },
+            },
+            required: ['productId', 'workItemId', 'leaseId'],
+        },
+    },
+    {
+        name: 'complete_work',
+        description: 'Mark a work item as complete and release the lease. Attach PR URL, commit SHA, or test result ID.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                productId: { type: 'string', description: 'Product ID' },
+                workItemId: { type: 'string', description: 'Work item ID' },
+                leaseId: { type: 'string', description: 'Lease ID from claim_work' },
+                status: { type: 'string', description: 'New status for the work item' },
+                prUrl: { type: 'string', description: 'URL of the pull request (optional)' },
+                commitSha: { type: 'string', description: 'Git commit SHA (optional)' },
+                testResultId: { type: 'string', description: 'Test result ID (optional)' },
+            },
+            required: ['productId', 'workItemId', 'leaseId'],
+        },
+    },
+];
+async function handleWorkTool(name, args) {
+    switch (name) {
+        case 'list_work_items': {
+            return await (0, client_js_1.apiGet)(`/products/${args.productId}/work-items`, {
+                leaseState: args.leaseState ?? 'available',
+                limit: args.limit,
+            });
+        }
+        case 'claim_work': {
+            return await (0, client_js_1.apiPost)(`/products/${args.productId}/work-items/${args.workItemId}/claim`, {
+                entityType: args.entityType ?? 'feature',
+            });
+        }
+        case 'heartbeat_work': {
+            return await (0, client_js_1.apiPost)(`/products/${args.productId}/work-items/${args.workItemId}/heartbeat`, {
+                leaseId: args.leaseId,
+            });
+        }
+        case 'complete_work': {
+            return await (0, client_js_1.apiPost)(`/products/${args.productId}/work-items/${args.workItemId}/complete`, {
+                leaseId: args.leaseId,
+                status: args.status,
+                prUrl: args.prUrl,
+                commitSha: args.commitSha,
+                testResultId: args.testResultId,
+            });
+        }
+        default:
+            throw new Error(`Unknown work tool: ${name}`);
+    }
+}
+//# sourceMappingURL=workTools.js.map

package/dist/tools/workTools.js.map

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

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "autoproject-mcp",
+  "version": "1.0.0",
+  "description": "AutoProject MCP server for IDE agent integration (GitHub Copilot, Cursor, Claude Dev)",
+  "main": "dist/index.js",
+  "bin": {
+    "autoproject-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist/**/*",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "ts-node src/index.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "axios": "^1.7.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.3.0",
+    "ts-node": "^10.9.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "license": "MIT",
+  "keywords": ["mcp", "autoproject", "ide-agent", "copilot", "cursor"],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/autoproject/autoproject-mcp.git"
+  }
+}