@react-spa-scaffold/mcp 0.3.0

package/dist/features/versions.json

@@ -0,0 +1,5 @@
+{
+  "@react-spa-scaffold/eslint-config": "^1.0.0",
+  "@react-spa-scaffold/prettier-config": "^1.0.0",
+  "@react-spa-scaffold/tsconfig": "^1.0.0"
+}

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+#!/usr/bin/env node
+/**
+ * react-spa-scaffold MCP Server
+ *
+ * A Model Context Protocol server that provides tools and resources
+ * for scaffolding new projects based on the react-spa-scaffold template.
+ *
+ * Usage:
+ *   npx @react-spa-scaffold/mcp  # Run with STDIO transport
+ *   node dist/index.js           # Direct execution
+ *
+ * Tools:
+ *   - get_features: List available feature modules
+ *   - get_scaffold: Get complete scaffold for selected features
+ *   - get_example: Get real code examples for patterns
+ *
+ * Resources:
+ *   - docs://conventions, docs://architecture, docs://testing
+ *   - docs://i18n, docs://api, docs://claude
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;;;GAkBG"}

package/dist/index.js

@@ -0,0 +1,43 @@
+#!/usr/bin/env node
+/**
+ * react-spa-scaffold MCP Server
+ *
+ * A Model Context Protocol server that provides tools and resources
+ * for scaffolding new projects based on the react-spa-scaffold template.
+ *
+ * Usage:
+ *   npx @react-spa-scaffold/mcp  # Run with STDIO transport
+ *   node dist/index.js           # Direct execution
+ *
+ * Tools:
+ *   - get_features: List available feature modules
+ *   - get_scaffold: Get complete scaffold for selected features
+ *   - get_example: Get real code examples for patterns
+ *
+ * Resources:
+ *   - docs://conventions, docs://architecture, docs://testing
+ *   - docs://i18n, docs://api, docs://claude
+ */
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { createServer } from './server.js';
+import { VERSION } from './version.js';
+async function main() {
+    const server = createServer();
+    const transport = new StdioServerTransport();
+    // Graceful shutdown handling
+    const shutdown = async () => {
+        console.error('Shutting down MCP server...');
+        await server.close();
+        process.exit(0);
+    };
+    process.on('SIGINT', shutdown);
+    process.on('SIGTERM', shutdown);
+    await server.connect(transport);
+    // Log to stderr (STDIO transport uses stdout for messages)
+    console.error(`react-spa-scaffold MCP server v${VERSION} running on STDIO`);
+}
+main().catch((error) => {
+    console.error('Failed to start MCP server:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAC9B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAE7C,6BAA6B;IAC7B,MAAM,QAAQ,GAAG,KAAK,IAAI,EAAE;QAC1B,OAAO,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;QAC7C,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QACrB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC;IAEF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC/B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAEhC,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,2DAA2D;IAC3D,OAAO,CAAC,KAAK,CAAC,kCAAkC,OAAO,mBAAmB,CAAC,CAAC;AAC9E,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,6BAA6B,EAAE,KAAK,CAAC,CAAC;IACpD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/resources/docs.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Documentation resources
+ *
+ * Reads actual documentation files from the react-spa-scaffold repository
+ * to ensure MCP resources stay in sync with the real docs.
+ * Uses in-memory caching to avoid repeated disk reads.
+ */
+/**
+ * Get list of all available documentation resources
+ */
+export declare function getDocumentationResources(): {
+    uri: string;
+    name: string;
+    description: string;
+    mimeType: string;
+}[];
+/**
+ * Read documentation content for a resource URI (cached)
+ */
+export declare function readDocumentation(uri: string): Promise<string | null>;
+/**
+ * Check if a URI is a valid documentation resource
+ */
+export declare function isValidDocumentationUri(uri: string): boolean;
+/**
+ * Get all available documentation URIs
+ */
+export declare function getDocumentationUris(): string[];
+//# sourceMappingURL=docs.d.ts.map

package/dist/resources/docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../src/resources/docs.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAuDH;;GAEG;AACH,wBAAgB,yBAAyB;;;;;IAOxC;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAiC3E;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE5D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,EAAE,CAE/C"}

package/dist/resources/docs.js

@@ -0,0 +1,105 @@
+/**
+ * Documentation resources
+ *
+ * Reads actual documentation files from the react-spa-scaffold repository
+ * to ensure MCP resources stay in sync with the real docs.
+ * Uses in-memory caching to avoid repeated disk reads.
+ */
+import { readFile } from 'fs/promises';
+import { resolveTemplatePath } from '../utils/paths.js';
+// Simple in-memory cache for documentation content
+const cache = new Map();
+/**
+ * Documentation file mapping
+ *
+ * Maps resource URIs to actual files in the repository.
+ * Add new entries here to expose additional documentation.
+ */
+const DOCS_MAP = {
+    'docs://conventions': {
+        files: ['docs/CODING_STANDARDS.md', 'docs/COMPONENT_GUIDELINES.md'],
+        name: 'Coding Conventions',
+        description: 'Coding standards, naming conventions, and component patterns for react-spa-scaffold projects',
+    },
+    'docs://architecture': {
+        files: ['docs/ARCHITECTURE.md'],
+        name: 'Architecture Overview',
+        description: 'Technology stack, data flow, and architectural decisions for react-spa-scaffold',
+    },
+    'docs://testing': {
+        files: ['docs/TESTING.md', 'docs/E2E_TESTING.md'],
+        name: 'Testing Guide',
+        description: 'Unit testing with Vitest and E2E testing with Playwright',
+    },
+    'docs://i18n': {
+        files: ['docs/INTERNATIONALIZATION.md'],
+        name: 'Internationalization',
+        description: 'LinguiJS setup, Trans component usage, and translation workflow',
+    },
+    'docs://api': {
+        files: ['docs/API_REFERENCE.md'],
+        name: 'API Reference',
+        description: 'API client utilities, hooks, and data fetching patterns',
+    },
+    'docs://claude': {
+        files: ['CLAUDE.md'],
+        name: 'Claude AI Guidance',
+        description: 'AI assistant instructions and project-specific guidance',
+    },
+};
+/**
+ * Get list of all available documentation resources
+ */
+export function getDocumentationResources() {
+    return Object.entries(DOCS_MAP).map(([uri, doc]) => ({
+        uri,
+        name: doc.name,
+        description: doc.description,
+        mimeType: 'text/markdown',
+    }));
+}
+/**
+ * Read documentation content for a resource URI (cached)
+ */
+export async function readDocumentation(uri) {
+    const doc = DOCS_MAP[uri];
+    if (!doc) {
+        return null;
+    }
+    // Return cached content if available
+    if (cache.has(uri)) {
+        return cache.get(uri);
+    }
+    const contents = [];
+    for (const file of doc.files) {
+        const fullPath = resolveTemplatePath(file);
+        try {
+            const content = await readFile(fullPath, 'utf-8');
+            contents.push(content);
+        }
+        catch {
+            // File might not exist
+            contents.push(`<!-- File not found: ${file} -->\n`);
+        }
+    }
+    // Join multiple files with a separator
+    const result = contents.length > 1 ? contents.join('\n\n---\n\n') : contents[0] || null;
+    // Cache the result
+    if (result) {
+        cache.set(uri, result);
+    }
+    return result;
+}
+/**
+ * Check if a URI is a valid documentation resource
+ */
+export function isValidDocumentationUri(uri) {
+    return uri in DOCS_MAP;
+}
+/**
+ * Get all available documentation URIs
+ */
+export function getDocumentationUris() {
+    return Object.keys(DOCS_MAP);
+}
+//# sourceMappingURL=docs.js.map

package/dist/resources/docs.js.map

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

package/dist/resources/index.d.ts

@@ -0,0 +1,2 @@
+export { getDocumentationResources, readDocumentation, isValidDocumentationUri, getDocumentationUris } from './docs.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/resources/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC"}

package/dist/resources/index.js

@@ -0,0 +1,2 @@
+export { getDocumentationResources, readDocumentation, isValidDocumentationUri, getDocumentationUris } from './docs.js';
+//# sourceMappingURL=index.js.map

package/dist/resources/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,12 @@
+/**
+ * MCP Server for react-spa-scaffold scaffolding
+ *
+ * This server provides tools and resources for AI agents to scaffold
+ * new projects based on the react-spa-scaffold template.
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+/**
+ * Create and configure the MCP server
+ */
+export declare function createServer(): Server;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AA0DnE;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAoFrC"}

package/dist/server.js

@@ -0,0 +1,115 @@
+/**
+ * MCP Server for react-spa-scaffold scaffolding
+ *
+ * This server provides tools and resources for AI agents to scaffold
+ * new projects based on the react-spa-scaffold template.
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { CallToolRequestSchema, ListResourcesRequestSchema, ListToolsRequestSchema, ReadResourceRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { getFeatures, getFeaturesToolDefinition, getScaffold, getScaffoldSchema, getScaffoldToolDefinition, getExample, getExampleSchema, getExampleToolDefinition, } from './tools/index.js';
+import { getDocumentationResources, readDocumentation, isValidDocumentationUri } from './resources/index.js';
+import { VERSION } from './version.js';
+// ═══════════════════════════════════════════════════════════════════════════
+// Response Helpers
+// ═══════════════════════════════════════════════════════════════════════════
+function jsonResponse(data) {
+    return {
+        content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
+    };
+}
+function errorResponse(message) {
+    return {
+        content: [{ type: 'text', text: message }],
+        isError: true,
+    };
+}
+// ═══════════════════════════════════════════════════════════════════════════
+// Server Instructions
+// ═══════════════════════════════════════════════════════════════════════════
+const SERVER_INSTRUCTIONS = `
+react-spa-scaffold MCP Server - Project Scaffolding Assistant
+
+Usage:
+1. Call get_features to see available feature modules
+2. Call get_scaffold with desired features to get project structure
+3. Call get_example to get code patterns for specific file types
+4. Read docs:// resources for conventions and best practices
+
+Tips:
+- Core feature is always included automatically
+- Features are independent - select only what you need
+- Check docs://conventions before generating code
+`.trim();
+/**
+ * Create and configure the MCP server
+ */
+export function createServer() {
+    const server = new Server({
+        name: 'react-spa-scaffold-mcp',
+        version: VERSION,
+    }, {
+        capabilities: {
+            tools: {},
+            resources: {},
+        },
+        instructions: SERVER_INSTRUCTIONS,
+    });
+    // ═══════════════════════════════════════════════════════════════════════
+    // TOOLS
+    // ═══════════════════════════════════════════════════════════════════════
+    server.setRequestHandler(ListToolsRequestSchema, async () => {
+        return {
+            tools: [getFeaturesToolDefinition, getScaffoldToolDefinition, getExampleToolDefinition],
+        };
+    });
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        try {
+            switch (name) {
+                case 'get_features':
+                    return jsonResponse(getFeatures());
+                case 'get_scaffold': {
+                    const parsed = getScaffoldSchema.safeParse(args);
+                    if (!parsed.success) {
+                        return errorResponse(`Invalid input: ${parsed.error.message}`);
+                    }
+                    return jsonResponse(await getScaffold(parsed.data));
+                }
+                case 'get_example': {
+                    const parsed = getExampleSchema.safeParse(args);
+                    if (!parsed.success) {
+                        return errorResponse(`Invalid input: ${parsed.error.message}`);
+                    }
+                    return jsonResponse(await getExample(parsed.data));
+                }
+                default:
+                    return errorResponse(`Unknown tool: ${name}`);
+            }
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return errorResponse(`Error executing ${name}: ${message}`);
+        }
+    });
+    // ═══════════════════════════════════════════════════════════════════════
+    // RESOURCES
+    // ═══════════════════════════════════════════════════════════════════════
+    server.setRequestHandler(ListResourcesRequestSchema, async () => {
+        return { resources: getDocumentationResources() };
+    });
+    server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+        const { uri } = request.params;
+        if (!isValidDocumentationUri(uri)) {
+            throw new Error(`Unknown resource: ${uri}`);
+        }
+        const content = await readDocumentation(uri);
+        if (!content) {
+            throw new Error(`Failed to read resource: ${uri}`);
+        }
+        return {
+            contents: [{ uri, mimeType: 'text/markdown', text: content }],
+        };
+    });
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/tools/get-example.d.ts

@@ -0,0 +1,51 @@
+/**
+ * get_example tool
+ *
+ * Returns real code examples for specific pattern types.
+ * AI agents use this to understand how to generate code
+ * that matches react-spa-scaffold conventions.
+ */
+import { z } from 'zod';
+export declare const getExampleSchema: z.ZodObject<{
+    pattern: z.ZodEnum<[string, ...string[]]>;
+}, "strip", z.ZodTypeAny, {
+    pattern: string;
+}, {
+    pattern: string;
+}>;
+export type GetExampleInput = z.infer<typeof getExampleSchema>;
+export declare function getExample(input: GetExampleInput): Promise<{
+    error: string;
+    hint: string;
+    pattern?: undefined;
+    description?: undefined;
+    filePath?: undefined;
+    keyPoints?: undefined;
+    code?: undefined;
+    usage?: undefined;
+} | {
+    pattern: string;
+    description: string;
+    filePath: string;
+    keyPoints: string[];
+    code: string;
+    usage: string;
+    error?: undefined;
+    hint?: undefined;
+}>;
+export declare const getExampleToolDefinition: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            pattern: {
+                type: "string";
+                description: string;
+                enum: [string, ...string[]];
+            };
+        };
+        required: string[];
+    };
+};
+//# sourceMappingURL=get-example.d.ts.map

package/dist/tools/get-example.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-example.d.ts","sourceRoot":"","sources":["../../src/tools/get-example.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,gBAAgB;;;;;;EAI3B,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE/D,wBAAsB,UAAU,CAAC,KAAK,EAAE,eAAe;;;;;;;;;;;;;;;;;;GAoBtD;AAuBD,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;CAoCpC,CAAC"}

package/dist/tools/get-example.js

@@ -0,0 +1,90 @@
+/**
+ * get_example tool
+ *
+ * Returns real code examples for specific pattern types.
+ * AI agents use this to understand how to generate code
+ * that matches react-spa-scaffold conventions.
+ */
+import { z } from 'zod';
+import { getCodeExample, getAvailablePatterns } from '../utils/index.js';
+const AVAILABLE_PATTERNS = getAvailablePatterns();
+export const getExampleSchema = z.object({
+    pattern: z.enum(AVAILABLE_PATTERNS, {
+        errorMap: () => ({ message: `Invalid pattern. Available: ${AVAILABLE_PATTERNS.join(', ')}` }),
+    }),
+});
+export async function getExample(input) {
+    const { pattern } = input;
+    const example = await getCodeExample(pattern);
+    if (!example) {
+        return {
+            error: `Could not load example for pattern: ${pattern}`,
+            hint: 'Ensure MCP server is running from react-spa-scaffold directory',
+        };
+    }
+    return {
+        pattern: example.pattern,
+        description: example.description,
+        filePath: example.filePath,
+        keyPoints: example.keyPoints,
+        code: example.code,
+        usage: generateUsageHint(pattern),
+    };
+}
+function generateUsageHint(pattern) {
+    const hints = {
+        'component-ui': 'Place in src/components/ui/ with kebab-case filename',
+        'component-shared': 'Create subdirectory in src/components/shared/ with index.ts barrel',
+        'component-layout': 'Place in src/components/layout/',
+        'hook-state': 'Place in src/hooks/ with useXxx.ts naming',
+        'hook-query': 'Place in src/hooks/ - define fetchFn outside hook',
+        'hook-form': 'Place in src/hooks/ - import schema from lib/validations',
+        'hook-effect': 'Place in src/hooks/ - no return value',
+        'zustand-store': 'Place in src/stores/ with xxxStore.ts naming',
+        'page-component': 'Place in src/pages/ with XxxPage named export',
+        'context-provider': 'Place in src/contexts/ - export both Provider and hook',
+        'test-component': 'Place in tests/unit/components/ mirroring src structure',
+        'test-hook': 'Place in tests/unit/hooks/',
+        'msw-handler': 'Place in src/mocks/handlers/',
+        'zod-schema': 'Add to src/lib/validations.ts',
+    };
+    return hints[pattern] || 'Follow the file path shown in the example';
+}
+export const getExampleToolDefinition = {
+    name: 'get_example',
+    description: `Get real code example for a specific pattern type.
+
+Returns actual code from the react-spa-scaffold repository, not templates.
+Use this to understand exact patterns when generating new files.
+
+Available patterns:
+- Components: component-ui, component-shared, component-layout
+- Hooks: hook-state, hook-query, hook-form, hook-effect, use-language-hook
+- Store: zustand-store
+- Pages: page-component, lazy-page
+- Context: context-provider, query-provider
+- API: api-client
+- Tests: test-component, test-hook, test-store, msw-handler
+- Validation: zod-schema, form-error-component
+- i18n: trans-component, t-function, language-switcher
+- Utils: storage-utility, format-utility
+- Theme: theme-toggle
+- SEO: seo-component
+
+Each example includes:
+- Actual working code
+- Key points explaining the pattern
+- File path where it should be placed`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            pattern: {
+                type: 'string',
+                description: 'Pattern type to get example for',
+                enum: AVAILABLE_PATTERNS,
+            },
+        },
+        required: ['pattern'],
+    },
+};
+//# sourceMappingURL=get-example.js.map

package/dist/tools/get-example.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-example.js","sourceRoot":"","sources":["../../src/tools/get-example.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAEzE,MAAM,kBAAkB,GAAG,oBAAoB,EAA2B,CAAC;AAE3E,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,kBAAkB,EAAE;QAClC,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,+BAA+B,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;KAC9F,CAAC;CACH,CAAC,CAAC;AAIH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,KAAsB;IACrD,MAAM,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC;IAE1B,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,OAAO,CAAC,CAAC;IAE9C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO;YACL,KAAK,EAAE,uCAAuC,OAAO,EAAE;YACvD,IAAI,EAAE,gEAAgE;SACvE,CAAC;IACJ,CAAC;IAED,OAAO;QACL,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,KAAK,EAAE,iBAAiB,CAAC,OAAO,CAAC;KAClC,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CAAC,OAAe;IACxC,MAAM,KAAK,GAA2B;QACpC,cAAc,EAAE,sDAAsD;QACtE,kBAAkB,EAAE,oEAAoE;QACxF,kBAAkB,EAAE,iCAAiC;QACrD,YAAY,EAAE,2CAA2C;QACzD,YAAY,EAAE,mDAAmD;QACjE,WAAW,EAAE,0DAA0D;QACvE,aAAa,EAAE,uCAAuC;QACtD,eAAe,EAAE,8CAA8C;QAC/D,gBAAgB,EAAE,+CAA+C;QACjE,kBAAkB,EAAE,wDAAwD;QAC5E,gBAAgB,EAAE,yDAAyD;QAC3E,WAAW,EAAE,4BAA4B;QACzC,aAAa,EAAE,8BAA8B;QAC7C,YAAY,EAAE,+BAA+B;KAC9C,CAAC;IAEF,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,2CAA2C,CAAC;AACvE,CAAC;AAED,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,IAAI,EAAE,aAAa;IACnB,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;sCAsBuB;IACpC,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,OAAO,EAAE;gBACP,IAAI,EAAE,QAAiB;gBACvB,WAAW,EAAE,iCAAiC;gBAC9C,IAAI,EAAE,kBAAkB;aACzB;SACF;QACD,QAAQ,EAAE,CAAC,SAAS,CAAC;KACtB;CACF,CAAC"}

package/dist/tools/get-features.d.ts

@@ -0,0 +1,30 @@
+/**
+ * get_features tool
+ *
+ * Lists all available feature modules for project scaffolding.
+ * AI agents use this to understand what features are available
+ * and present options to users.
+ */
+export interface FeatureSummary {
+    id: string;
+    name: string;
+    description: string;
+    required: boolean;
+    includes: string[];
+    hasOptions: boolean;
+    options?: Record<string, {
+        description: string;
+        default: boolean;
+    }>;
+}
+export declare function getFeatures(): FeatureSummary[];
+export declare const getFeaturesToolDefinition: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {};
+        required: string[];
+    };
+};
+//# sourceMappingURL=get-features.d.ts.map

package/dist/tools/get-features.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-features.d.ts","sourceRoot":"","sources":["../../src/tools/get-features.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CACrE;AAED,wBAAgB,WAAW,IAAI,cAAc,EAAE,CAa9C;AAED,eAAO,MAAM,yBAAyB;;;;;;kBAoBlB,MAAM,EAAE;;CAE3B,CAAC"}

package/dist/tools/get-features.js

@@ -0,0 +1,46 @@
+/**
+ * get_features tool
+ *
+ * Lists all available feature modules for project scaffolding.
+ * AI agents use this to understand what features are available
+ * and present options to users.
+ */
+import { FEATURES, FEATURE_IDS } from '../features/index.js';
+export function getFeatures() {
+    return FEATURE_IDS.map((id) => {
+        const feature = FEATURES[id];
+        return {
+            id: String(id),
+            name: feature.name,
+            description: feature.description,
+            required: feature.required,
+            includes: feature.includes,
+            hasOptions: !!feature.options,
+            options: feature.options,
+        };
+    });
+}
+export const getFeaturesToolDefinition = {
+    name: 'get_features',
+    description: `List all available feature modules for react-spa-scaffold project scaffolding.
+
+Returns a list of features that can be selected when creating a new project:
+- core: Always included (React 19 + TypeScript + Vite + Tailwind)
+- routing: React Router with lazy loading
+- ui: Shadcn/UI + icons + theming
+- forms: React Hook Form + Zod validation
+- state: Zustand state management
+- api: TanStack Query + API client
+- i18n: LinguiJS internationalization
+- testing: Vitest + Playwright + MSW
+- devtools: ESLint + Prettier + Husky
+- ci: GitHub Actions + Lighthouse
+
+Use this to understand available options before scaffolding a project.`,
+    inputSchema: {
+        type: 'object',
+        properties: {},
+        required: [],
+    },
+};
+//# sourceMappingURL=get-features.js.map

package/dist/tools/get-features.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-features.js","sourceRoot":"","sources":["../../src/tools/get-features.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAY7D,MAAM,UAAU,WAAW;IACzB,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC,EAAE,EAAkB,EAAE;QAC5C,MAAM,OAAO,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAC;QAC7B,OAAO;YACL,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC;YACd,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,UAAU,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO;YAC7B,OAAO,EAAE,OAAO,CAAC,OAAO;SACzB,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,IAAI,EAAE,cAAc;IACpB,WAAW,EAAE;;;;;;;;;;;;;;uEAcwD;IACrE,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE,EAAE;QACd,QAAQ,EAAE,EAAc;KACzB;CACF,CAAC"}