@defai.digital/mcp-server 13.0.3

package/dist/tools/scaffold.js

@@ -0,0 +1,495 @@
+/**
+ * Scaffold MCP Tools
+ *
+ * MCP tools for scaffolding contract-first project components.
+ * Uses file_write tool for file creation.
+ *
+ * @module mcp-server/tools/scaffold
+ */
+// ============================================================================
+// Tool Definitions
+// ============================================================================
+/**
+ * Scaffold contract tool
+ */
+export const scaffoldContractTool = {
+    name: 'scaffold_contract',
+    description: 'Generate Zod schema and invariants for a domain. SIDE EFFECTS: Creates files on disk.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            name: {
+                type: 'string',
+                description: 'Domain name (kebab-case)',
+            },
+            description: {
+                type: 'string',
+                description: 'Domain description',
+            },
+            output: {
+                type: 'string',
+                description: 'Output directory (default: packages/contracts/src/<name>/v1)',
+            },
+            dryRun: {
+                type: 'boolean',
+                description: 'Preview without writing files',
+                default: false,
+            },
+        },
+        required: ['name'],
+    },
+    idempotent: false,
+};
+/**
+ * Scaffold domain tool
+ */
+export const scaffoldDomainTool = {
+    name: 'scaffold_domain',
+    description: 'Generate complete domain package with service, types, and tests. SIDE EFFECTS: Creates files on disk.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            name: {
+                type: 'string',
+                description: 'Domain name (kebab-case)',
+            },
+            output: {
+                type: 'string',
+                description: 'Output directory (default: packages/core/<name>-domain)',
+            },
+            scope: {
+                type: 'string',
+                description: 'Package scope (default: @defai.digital)',
+                default: '@defai.digital',
+            },
+            includeTests: {
+                type: 'boolean',
+                description: 'Include test scaffolds',
+                default: true,
+            },
+            includeGuard: {
+                type: 'boolean',
+                description: 'Include guard policy',
+                default: true,
+            },
+            dryRun: {
+                type: 'boolean',
+                description: 'Preview without writing files',
+                default: false,
+            },
+        },
+        required: ['name'],
+    },
+    idempotent: false,
+};
+/**
+ * Scaffold guard tool
+ */
+export const scaffoldGuardTool = {
+    name: 'scaffold_guard',
+    description: 'Generate guard policy for a domain. SIDE EFFECTS: Creates file on disk.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            policyId: {
+                type: 'string',
+                description: 'Policy ID (e.g., "payment-development")',
+            },
+            domain: {
+                type: 'string',
+                description: 'Domain name (default: derived from policyId)',
+            },
+            radius: {
+                type: 'number',
+                description: 'Change radius limit',
+                default: 3,
+            },
+            gates: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Gates to include',
+                default: ['path_violation', 'dependency', 'change_radius', 'contract_tests'],
+            },
+            dryRun: {
+                type: 'boolean',
+                description: 'Preview without writing files',
+                default: false,
+            },
+        },
+        required: ['policyId'],
+    },
+    idempotent: false,
+};
+// ============================================================================
+// Template Functions
+// ============================================================================
+function toPascalCase(str) {
+    return str
+        .split(/[-_]/)
+        .map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
+        .join('');
+}
+function generateSchemaTemplate(name, description) {
+    const pascalName = toPascalCase(name);
+    const domainCode = name.substring(0, 3).toUpperCase();
+    return `/**
+ * ${pascalName} Domain Contracts v1
+ *
+ * ${description}
+ *
+ * @module @defai.digital/contracts/${name}/v1
+ */
+
+import { z } from 'zod';
+
+// ============================================================================
+// Value Objects
+// ============================================================================
+
+export const ${pascalName}IdSchema = z.string().uuid();
+export type ${pascalName}Id = z.infer<typeof ${pascalName}IdSchema>;
+
+// ============================================================================
+// Enums
+// ============================================================================
+
+export const ${pascalName}StatusSchema = z.enum([
+  'draft',
+  'active',
+  'completed',
+  'cancelled',
+]);
+export type ${pascalName}Status = z.infer<typeof ${pascalName}StatusSchema>;
+
+// ============================================================================
+// Entities
+// ============================================================================
+
+/**
+ * ${pascalName} entity - Aggregate Root
+ *
+ * Invariants:
+ * - INV-${domainCode}-001: ID must be valid UUID
+ * - INV-${domainCode}-002: Status must be valid enum value
+ */
+export const ${pascalName}Schema = z.object({
+  id: ${pascalName}IdSchema,
+  status: ${pascalName}StatusSchema,
+  createdAt: z.string().datetime(),
+  updatedAt: z.string().datetime(),
+});
+export type ${pascalName} = z.infer<typeof ${pascalName}Schema>;
+
+// ============================================================================
+// Domain Events
+// ============================================================================
+
+export const ${pascalName}EventSchema = z.discriminatedUnion('type', [
+  z.object({
+    type: z.literal('${name}.created'),
+    ${name}Id: ${pascalName}IdSchema,
+    occurredAt: z.string().datetime(),
+  }),
+  z.object({
+    type: z.literal('${name}.updated'),
+    ${name}Id: ${pascalName}IdSchema,
+    changes: z.record(z.unknown()),
+    occurredAt: z.string().datetime(),
+  }),
+]);
+export type ${pascalName}Event = z.infer<typeof ${pascalName}EventSchema>;
+
+// ============================================================================
+// Validation
+// ============================================================================
+
+export function validate${pascalName}(data: unknown): ${pascalName} {
+  return ${pascalName}Schema.parse(data);
+}
+
+// ============================================================================
+// Error Codes
+// ============================================================================
+
+export const ${pascalName}ErrorCode = {
+  NOT_FOUND: '${domainCode}_NOT_FOUND',
+  INVALID_STATUS: '${domainCode}_INVALID_STATUS',
+} as const;
+`;
+}
+function generateInvariantsTemplate(name, description) {
+    const pascalName = toPascalCase(name);
+    const domainCode = name.substring(0, 3).toUpperCase();
+    return `# ${pascalName} Domain Invariants
+
+## Overview
+
+${description}
+
+## Schema Invariants
+
+### INV-${domainCode}-001: Valid ID Format
+${pascalName} ID MUST be a valid UUID v4.
+- **Enforcement**: schema
+- **Test**: \`z.string().uuid()\` rejects invalid UUIDs
+
+### INV-${domainCode}-002: Valid Status
+Status MUST be one of the defined enum values.
+- **Enforcement**: schema
+- **Test**: \`z.enum([...])\` rejects invalid values
+
+## Runtime Invariants
+
+### INV-${domainCode}-101: Status Transitions
+Status transitions MUST follow the defined state machine.
+- **Enforcement**: runtime
+- **Valid Transitions**:
+  \`\`\`
+  draft     → active, cancelled
+  active    → completed, cancelled
+  \`\`\`
+
+## Business Invariants
+
+### INV-${domainCode}-201: [Add business rules]
+[Description of business invariant]
+- **Enforcement**: [schema|runtime|test]
+- **Test**: [How to verify]
+`;
+}
+function generateIndexTemplate(_name) {
+    return `export * from './schema.js';
+`;
+}
+function generateGuardPolicyTemplate(policyId, domain, radius, gates) {
+    return `# ${toPascalCase(domain)} Domain Guard Policy
+
+policy_id: ${policyId}
+
+description: |
+  Guard policy for ${domain} domain development.
+
+allowed_paths:
+  - packages/contracts/src/${domain}/**
+  - packages/core/${domain}-domain/**
+  - tests/contract/${domain}.test.ts
+  - tests/core/${domain}-domain.test.ts
+
+forbidden_paths:
+  - packages/contracts/src/*/v1/schema.ts
+  - "!packages/contracts/src/${domain}/v1/schema.ts"
+  - packages/cli/**
+  - packages/mcp-server/**
+  - packages/adapters/**
+
+required_contracts:
+  - ${domain}
+
+gates:
+${gates.map((g) => `  - ${g}`).join('\n')}
+
+change_radius_limit: ${radius}
+
+variables:
+  domain: ${domain}
+
+metadata:
+  owner: ${domain}-team
+  created_at: "${new Date().toISOString().split('T')[0]}"
+  severity: medium
+  auto_apply: false
+`;
+}
+// ============================================================================
+// Tool Handlers
+// ============================================================================
+export const handleScaffoldContract = async (args) => {
+    const name = args.name;
+    const description = args.description || `${toPascalCase(name)} domain.`;
+    const output = args.output || `packages/contracts/src/${name}/v1`;
+    const dryRun = args.dryRun || false;
+    const files = [
+        { path: `${output}/schema.ts`, content: generateSchemaTemplate(name, description) },
+        { path: `${output}/invariants.md`, content: generateInvariantsTemplate(name, description) },
+        { path: `${output}/index.ts`, content: generateIndexTemplate(name) },
+    ];
+    if (dryRun) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        success: true,
+                        dryRun: true,
+                        name,
+                        files: files.map((f) => ({ path: f.path, size: f.content.length })),
+                        message: `Would create ${files.length} files for contract "${name}"`,
+                    }),
+                },
+            ],
+        };
+    }
+    // In a real implementation, this would use file_write tool
+    // For now, return the generated content
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify({
+                    success: true,
+                    dryRun: false,
+                    name,
+                    files: files.map((f) => ({ path: f.path, size: f.content.length })),
+                    generatedContent: files,
+                    message: `Generated contract scaffold for "${name}". Use file_write tool to persist files.`,
+                }),
+            },
+        ],
+    };
+};
+export const handleScaffoldDomain = async (args) => {
+    const name = args.name;
+    const output = args.output || `packages/core/${name}-domain`;
+    const scope = args.scope || '@defai.digital';
+    const includeGuard = args.includeGuard !== false;
+    const dryRun = args.dryRun || false;
+    const pascalName = toPascalCase(name);
+    const files = [
+        {
+            path: `${output}/package.json`,
+            content: JSON.stringify({
+                name: `${scope}/${name}-domain`,
+                version: '1.0.0',
+                type: 'module',
+                main: 'dist/index.js',
+                types: 'dist/index.d.ts',
+            }, null, 2),
+        },
+        {
+            path: `${output}/src/index.ts`,
+            content: `export * from './types.js';\nexport * from './service.js';\n`,
+        },
+        {
+            path: `${output}/src/types.ts`,
+            content: `import type { ${pascalName} } from '@defai.digital/contracts';
+
+export interface ${pascalName}Repository {
+  findById(id: string): Promise<${pascalName} | undefined>;
+  save(entity: ${pascalName}): Promise<void>;
+}
+`,
+        },
+        {
+            path: `${output}/src/service.ts`,
+            content: `import type { ${pascalName} } from '@defai.digital/contracts';
+import type { ${pascalName}Repository } from './types.js';
+
+export class ${pascalName}Service {
+  constructor(private readonly repository: ${pascalName}Repository) {}
+
+  async findById(id: string): Promise<${pascalName} | undefined> {
+    return this.repository.findById(id);
+  }
+}
+`,
+        },
+    ];
+    if (includeGuard) {
+        files.push({
+            path: `packages/guard/policies/${name}-development.yaml`,
+            content: generateGuardPolicyTemplate(`${name}-development`, name, 3, ['path_violation', 'dependency', 'change_radius', 'contract_tests']),
+        });
+    }
+    if (dryRun) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        success: true,
+                        dryRun: true,
+                        name,
+                        files: files.map((f) => ({ path: f.path, size: f.content.length })),
+                        message: `Would create ${files.length} files for domain "${name}"`,
+                    }),
+                },
+            ],
+        };
+    }
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify({
+                    success: true,
+                    dryRun: false,
+                    name,
+                    files: files.map((f) => ({ path: f.path, size: f.content.length })),
+                    generatedContent: files,
+                    message: `Generated domain scaffold for "${name}". Use file_write tool to persist files.`,
+                }),
+            },
+        ],
+    };
+};
+export const handleScaffoldGuard = async (args) => {
+    const policyId = args.policyId;
+    const domain = args.domain || policyId.replace(/-development$/, '');
+    const radius = args.radius || 3;
+    const gates = args.gates || [
+        'path_violation',
+        'dependency',
+        'change_radius',
+        'contract_tests',
+    ];
+    const dryRun = args.dryRun || false;
+    const content = generateGuardPolicyTemplate(policyId, domain, radius, gates);
+    const filePath = `packages/guard/policies/${policyId}.yaml`;
+    if (dryRun) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        success: true,
+                        dryRun: true,
+                        policyId,
+                        domain,
+                        file: { path: filePath, size: content.length },
+                        message: `Would create guard policy "${policyId}"`,
+                    }),
+                },
+            ],
+        };
+    }
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify({
+                    success: true,
+                    dryRun: false,
+                    policyId,
+                    domain,
+                    file: { path: filePath, size: content.length },
+                    generatedContent: { path: filePath, content },
+                    message: `Generated guard policy "${policyId}". Use file_write tool to persist.`,
+                }),
+            },
+        ],
+    };
+};
+// ============================================================================
+// Exports
+// ============================================================================
+export const SCAFFOLD_TOOLS = [
+    scaffoldContractTool,
+    scaffoldDomainTool,
+    scaffoldGuardTool,
+];
+export const SCAFFOLD_HANDLERS = {
+    scaffold_contract: handleScaffoldContract,
+    scaffold_domain: handleScaffoldDomain,
+    scaffold_guard: handleScaffoldGuard,
+};
+//# sourceMappingURL=scaffold.js.map

package/dist/tools/scaffold.js.map

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

package/dist/tools/session.d.ts

@@ -0,0 +1,75 @@
+import type { MCPTool, ToolHandler } from '../types.js';
+/**
+ * Session create tool definition
+ * INV-MCP-004: Non-idempotent - creates new session each call
+ * INV-MCP-002: Side effects - creates session in store
+ */
+export declare const sessionCreateTool: MCPTool;
+/**
+ * Session status tool definition
+ * INV-MCP-004: Idempotent - read-only operation
+ */
+export declare const sessionStatusTool: MCPTool;
+/**
+ * Session complete tool definition
+ * INV-MCP-004: Idempotent - completing already completed session is safe
+ * INV-MCP-002: Side effects - updates session status to completed
+ */
+export declare const sessionCompleteTool: MCPTool;
+/**
+ * Session list tool definition
+ * INV-MCP-004: Idempotent - read-only operation
+ */
+export declare const sessionListTool: MCPTool;
+/**
+ * Session join tool definition
+ * INV-MCP-004: Idempotent - joining twice returns existing participation
+ * INV-MCP-002: Side effects - adds participant to session
+ */
+export declare const sessionJoinTool: MCPTool;
+/**
+ * Session leave tool definition
+ * INV-MCP-004: Non-idempotent - fails if not a participant
+ * INV-MCP-002: Side effects - removes participant from session
+ */
+export declare const sessionLeaveTool: MCPTool;
+/**
+ * Session fail tool definition
+ * INV-MCP-004: Non-idempotent - only active sessions can be failed
+ * INV-MCP-002: Side effects - updates session status to failed
+ */
+export declare const sessionFailTool: MCPTool;
+/**
+ * Handler for session_create tool
+ */
+export declare const handleSessionCreate: ToolHandler;
+/**
+ * Handler for session_status tool
+ */
+export declare const handleSessionStatus: ToolHandler;
+/**
+ * Handler for session_complete tool
+ */
+export declare const handleSessionComplete: ToolHandler;
+/**
+ * Handler for session_list tool
+ */
+export declare const handleSessionList: ToolHandler;
+/**
+ * Handler for session_join tool
+ * INV-MCP-SES-001: Cannot join completed/failed session
+ * INV-MCP-SES-002: Joining twice returns existing participation (idempotent)
+ * INV-MCP-SES-003: Max participants enforced (default: 10)
+ */
+export declare const handleSessionJoin: ToolHandler;
+/**
+ * Handler for session_leave tool
+ * INV-MCP-SES-004: Cannot leave if not a participant
+ * INV-MCP-SES-005: Initiator cannot leave active session
+ */
+export declare const handleSessionLeave: ToolHandler;
+/**
+ * Handler for session_fail tool
+ */
+export declare const handleSessionFail: ToolHandler;
+//# sourceMappingURL=session.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/tools/session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAcxD;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,OAsC/B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,OAuC/B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,EAAE,OA4BjC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,OA4C7B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,eAAe,EAAE,OAmC7B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,EAAE,OA4B9B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,eAAe,EAAE,OAkC7B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,WAgDjC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,WAiEjC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,WAwCnC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,WA0D/B,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,EAAE,WAmG/B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,EAAE,WA2FhC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,WAiF/B,CAAC"}