@react-spa-scaffold/mcp 1.1.3 → 1.2.1

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

@@ -1 +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;;;;;;kBAqBlB,MAAM,EAAE;;CAE3B,CAAC"}
+{"version":3,"file":"get-features.d.ts","sourceRoot":"","sources":["../../src/tools/get-features.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,qDAAqD;AACrD,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;CACpB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,IAAI,cAAc,EAAE,CAW9C;AAED,4DAA4D;AAC5D,eAAO,MAAM,yBAAyB,EAAE,cAuBvC,CAAC"}

package/dist/tools/get-features.js

@@ -6,6 +6,17 @@
  * and present options to users.
  */
 import { FEATURES, FEATURE_IDS } from '../features/index.js';
+/**
+ * Lists all available features for scaffolding.
+ *
+ * @returns Array of feature summaries with id, name, description, required flag, and includes
+ *
+ * @example
+ * ```typescript
+ * const features = getFeatures();
+ * // [{ id: 'core', name: 'Core', required: true, ... }, ...]
+ * ```
+ */
 export function getFeatures() {
     return FEATURE_IDS.map((id) => {
         const feature = FEATURES[id];
@@ -15,11 +26,10 @@ export function getFeatures() {
             description: feature.description,
             required: feature.required,
             includes: feature.includes,
-            hasOptions: !!feature.options,
-            options: feature.options,
         };
     });
 }
+/** Tool definition for get_features - no input required. */
 export const getFeaturesToolDefinition = {
     name: 'get_features',
     description: `List all available feature modules for react-spa-scaffold project scaffolding.

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

@@ -1 +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;;;;;;;;;;;;;;;uEAewD;IACrE,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE,EAAE;QACd,QAAQ,EAAE,EAAc;KACzB;CACF,CAAC"}
+{"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;;;;;;;;;;GAUG;AACH,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;SAC3B,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,4DAA4D;AAC5D,MAAM,CAAC,MAAM,yBAAyB,GAAmB;IACvD,IAAI,EAAE,cAAc;IACpB,WAAW,EAAE;;;;;;;;;;;;;;;uEAewD;IACrE,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,EAAE;QACd,QAAQ,EAAE,EAAE;KACb;CACF,CAAC"}

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

@@ -0,0 +1,5 @@
+/**
+ * Tests for get_features tool
+ */
+export {};
+//# sourceMappingURL=get-features.test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-features.test.d.ts","sourceRoot":"","sources":["../../src/tools/get-features.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}

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

@@ -0,0 +1,45 @@
+/**
+ * Tests for get_features tool
+ */
+import { describe, it, expect } from 'vitest';
+import { getFeatures } from './get-features.js';
+import { FEATURE_IDS } from '../features/index.js';
+describe('get_features tool', () => {
+    it('returns all feature IDs', () => {
+        const features = getFeatures();
+        expect(features).toHaveLength(FEATURE_IDS.length);
+        expect(features.map((f) => f.id)).toEqual(expect.arrayContaining([...FEATURE_IDS]));
+    });
+    it('returns core as required', () => {
+        const features = getFeatures();
+        const core = features.find((f) => f.id === 'core');
+        expect(core).toBeDefined();
+        expect(core?.required).toBe(true);
+    });
+    it('returns proper structure for each feature', () => {
+        const features = getFeatures();
+        for (const feature of features) {
+            expect(feature).toHaveProperty('id');
+            expect(feature).toHaveProperty('name');
+            expect(feature).toHaveProperty('description');
+            expect(feature).toHaveProperty('required');
+            expect(feature).toHaveProperty('includes');
+            expect(Array.isArray(feature.includes)).toBe(true);
+        }
+    });
+    it('mobile feature exists and is not required', () => {
+        const features = getFeatures();
+        const mobile = features.find((f) => f.id === 'mobile');
+        expect(mobile).toBeDefined();
+        expect(mobile?.required).toBe(false);
+        expect(mobile?.name).toBe('Mobile Support');
+    });
+    it('theming feature exists and is not required', () => {
+        const features = getFeatures();
+        const theming = features.find((f) => f.id === 'theming');
+        expect(theming).toBeDefined();
+        expect(theming?.required).toBe(false);
+        expect(theming?.name).toBe('Theming');
+    });
+});
+//# sourceMappingURL=get-features.test.js.map

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

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

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

@@ -0,0 +1,23 @@
+/**
+ * get_file tool
+ *
+ * Fetches content of config or documentation files.
+ * Used for lazy loading after get_scaffold returns paths.
+ */
+import { z } from 'zod';
+import type { ToolDefinition } from './types.js';
+/** Zod schema for get_file input - single source of truth. */
+export declare const getFileSchema: z.ZodObject<{
+    path: z.ZodString;
+}, z.core.$strip>;
+export type GetFileInput = z.infer<typeof getFileSchema>;
+export declare function getFile(input: GetFileInput): Promise<{
+    path: string;
+    content: string;
+} | {
+    error: string;
+    hint: string;
+}>;
+/** Tool definition derived from Zod schema (Zod v4 native). */
+export declare const getFileToolDefinition: ToolDefinition;
+//# sourceMappingURL=get-file.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-file.d.ts","sourceRoot":"","sources":["../../src/tools/get-file.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAIjD,8DAA8D;AAC9D,eAAO,MAAM,aAAa;;iBAExB,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAEzD,wBAAsB,OAAO,CAAC,KAAK,EAAE,YAAY;UATX,MAAM;aAAW,MAAM;;;;GAgC5D;AAED,+DAA+D;AAC/D,eAAO,MAAM,qBAAqB,EAAE,cAYnC,CAAC"}

package/dist/tools/get-file.js

@@ -0,0 +1,53 @@
+/**
+ * get_file tool
+ *
+ * Fetches content of config or documentation files.
+ * Used for lazy loading after get_scaffold returns paths.
+ */
+import { readFile } from 'fs/promises';
+import { z } from 'zod';
+import { createCache } from '../utils/cache.js';
+import { isPathWithinRoot, resolveTemplatePath } from '../utils/paths.js';
+const fileCache = createCache();
+/** Zod schema for get_file input - single source of truth. */
+export const getFileSchema = z.object({
+    path: z.string().describe('File path from get_scaffold (configFiles or docs array)'),
+});
+export async function getFile(input) {
+    const { path: filePath } = input;
+    // Security: prevent path traversal
+    if (!isPathWithinRoot(filePath)) {
+        return {
+            error: 'Invalid path: must be within template directory',
+            hint: 'Use paths from get_scaffold configFiles or docs arrays',
+        };
+    }
+    try {
+        return await fileCache.getOrSet(filePath, async () => {
+            const fullPath = resolveTemplatePath(filePath);
+            const content = await readFile(fullPath, 'utf-8');
+            return { path: filePath, content };
+        });
+    }
+    catch {
+        return {
+            error: `File not found: ${filePath}`,
+            hint: 'Ensure MCP server runs from react-spa-scaffold directory',
+        };
+    }
+}
+/** Tool definition derived from Zod schema (Zod v4 native). */
+export const getFileToolDefinition = {
+    name: 'get_file',
+    description: `Fetch content of a config or documentation file.
+
+Use paths from \`get_scaffold\` response:
+- \`configFiles\`: config file paths (e.g., "vite.config.ts")
+- \`docs\`: documentation paths (e.g., "docs/ARCHITECTURE.md")
+
+Examples:
+- \`{ path: "vite.config.ts" }\`
+- \`{ path: "docs/TESTING.md" }\``,
+    inputSchema: z.toJSONSchema(getFileSchema),
+};
+//# sourceMappingURL=get-file.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-file.js","sourceRoot":"","sources":["../../src/tools/get-file.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAI1E,MAAM,SAAS,GAAG,WAAW,EAAqC,CAAC;AAEnE,8DAA8D;AAC9D,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yDAAyD,CAAC;CACrF,CAAC,CAAC;AAIH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,KAAmB;IAC/C,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAC;IAEjC,mCAAmC;IACnC,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,EAAE,CAAC;QAChC,OAAO;YACL,KAAK,EAAE,iDAAiD;YACxD,IAAI,EAAE,wDAAwD;SAC/D,CAAC;IACJ,CAAC;IAED,IAAI,CAAC;QACH,OAAO,MAAM,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE;YACnD,MAAM,QAAQ,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;YAC/C,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YAClD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;QACrC,CAAC,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;YACL,KAAK,EAAE,mBAAmB,QAAQ,EAAE;YACpC,IAAI,EAAE,0DAA0D;SACjE,CAAC;IACJ,CAAC;AACH,CAAC;AAED,+DAA+D;AAC/D,MAAM,CAAC,MAAM,qBAAqB,GAAmB;IACnD,IAAI,EAAE,UAAU;IAChB,WAAW,EAAE;;;;;;;;kCAQmB;IAChC,WAAW,EAAE,CAAC,CAAC,YAAY,CAAC,aAAa,CAAkC;CAC5E,CAAC"}

package/dist/tools/get-file.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Tests for get_file tool
+ */
+export {};
+//# sourceMappingURL=get-file.test.d.ts.map

package/dist/tools/get-file.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-file.test.d.ts","sourceRoot":"","sources":["../../src/tools/get-file.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/tools/get-file.test.js

@@ -0,0 +1,63 @@
+/**
+ * Tests for get_file tool
+ */
+import { describe, it, expect } from 'vitest';
+import { getFile, getFileSchema } from './get-file.js';
+describe('get_file tool', () => {
+    describe('schema validation', () => {
+        it('accepts valid path', () => {
+            const result = getFileSchema.safeParse({ path: 'vite.config.ts' });
+            expect(result.success).toBe(true);
+        });
+        it('rejects missing path', () => {
+            const result = getFileSchema.safeParse({});
+            expect(result.success).toBe(false);
+        });
+    });
+    describe('file fetching', () => {
+        it('fetches config file content', async () => {
+            const result = await getFile({ path: 'vite.config.ts' });
+            expect(result).not.toHaveProperty('error');
+            expect(result).toHaveProperty('path', 'vite.config.ts');
+            expect(result).toHaveProperty('content');
+            expect(result.content).toContain('defineConfig');
+        });
+        it('fetches documentation file content', async () => {
+            const result = await getFile({ path: 'docs/ARCHITECTURE.md' });
+            expect(result).not.toHaveProperty('error');
+            expect(result).toHaveProperty('path', 'docs/ARCHITECTURE.md');
+            expect(result).toHaveProperty('content');
+            expect(result.content).toContain('#');
+        });
+        it('fetches .gitignore content', async () => {
+            const result = await getFile({ path: '.gitignore' });
+            expect(result).not.toHaveProperty('error');
+            expect(result).toHaveProperty('content');
+            expect(result.content).toContain('node_modules');
+        });
+    });
+    describe('security', () => {
+        it('rejects path traversal attempts', async () => {
+            const result = await getFile({ path: '../../../etc/passwd' });
+            expect(result).toHaveProperty('error');
+            expect(result.error).toContain('Invalid path');
+        });
+        it('rejects absolute paths outside root', async () => {
+            const result = await getFile({ path: '/etc/passwd' });
+            expect(result).toHaveProperty('error');
+        });
+        it('rejects embedded path traversal', async () => {
+            const result = await getFile({ path: 'docs/../../../etc/passwd' });
+            expect(result).toHaveProperty('error');
+        });
+    });
+    describe('error handling', () => {
+        it('returns error for non-existent file', async () => {
+            const result = await getFile({ path: 'nonexistent-file.xyz' });
+            expect(result).toHaveProperty('error');
+            expect(result.error).toContain('File not found');
+            expect(result).toHaveProperty('hint');
+        });
+    });
+});
+//# sourceMappingURL=get-file.test.js.map

package/dist/tools/get-file.test.js.map

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

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

@@ -7,6 +7,8 @@
  */
 import { z } from 'zod';
 import { type CodeExample } from '../utils/index.js';
+import type { ToolDefinition } from './types.js';
+/** Zod schema for get_scaffold input - single source of truth. */
 export declare const getScaffoldSchema: z.ZodObject<{
     features: z.ZodArray<z.ZodString>;
     projectName: z.ZodOptional<z.ZodString>;
@@ -16,9 +18,9 @@ export type GetScaffoldInput = z.infer<typeof getScaffoldSchema>;
 export declare function getScaffold(input: GetScaffoldInput): Promise<{
     projectName: string;
     selectedFeatures: string[];
-    resolvedFeatures: string[];
+    resolvedFeatures: import("../features/types.js").FeatureId[];
     featureDetails: {
-        id: string;
+        id: import("../features/types.js").FeatureId;
         name: string;
         wasExplicitlySelected: boolean;
         wasAutoIncluded: boolean;
@@ -32,39 +34,16 @@ export declare function getScaffold(input: GetScaffoldInput): Promise<{
         engines: Record<string, string>;
     };
     fileStructure: string[];
-    configFiles: Record<string, string>;
+    configFiles: string[];
     setupCommands: string[];
     claudeMd: string;
     viteEnvDts: string;
     envTs: string;
     routesTs: string | undefined;
-    docs: Record<string, string>;
+    docs: string[];
     examples: Record<string, CodeExample[]> | undefined;
     instructions: string;
 }>;
-export declare const getScaffoldToolDefinition: {
-    name: string;
-    description: string;
-    inputSchema: {
-        type: "object";
-        properties: {
-            features: {
-                type: "array";
-                items: {
-                    type: "string";
-                };
-                description: string;
-            };
-            projectName: {
-                type: "string";
-                description: string;
-            };
-            includeExamples: {
-                type: "boolean";
-                description: string;
-            };
-        };
-        required: string[];
-    };
-};
+/** Tool definition derived from Zod schema - single source of truth (Zod v4 native). */
+export declare const getScaffoldToolDefinition: ToolDefinition;
 //# sourceMappingURL=get-scaffold.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"get-scaffold.d.ts","sourceRoot":"","sources":["../../src/tools/get-scaffold.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAmE,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEtH,eAAO,MAAM,iBAAiB;;;;iBAuB5B,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAEjE,wBAAsB,WAAW,CAAC,KAAK,EAAE,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDxD;AAiBD,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;CA8BrC,CAAC"}
+{"version":3,"file":"get-scaffold.d.ts","sourceRoot":"","sources":["../../src/tools/get-scaffold.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAmE,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACtH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,kEAAkE;AAClE,eAAO,MAAM,iBAAiB;;;;iBAuB5B,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAEjE,wBAAsB,WAAW,CAAC,KAAK,EAAE,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDxD;AAmBD,wFAAwF;AACxF,eAAO,MAAM,yBAAyB,EAAE,cAoBvC,CAAC"}

package/dist/tools/get-scaffold.js

@@ -8,6 +8,7 @@
 import { z } from 'zod';
 import { FEATURE_IDS, FEATURES } from '../features/index.js';
 import { computeScaffold, resolveFeatureDependencies, getFeatureExamples } from '../utils/index.js';
+/** Zod schema for get_scaffold input - single source of truth. */
 export const getScaffoldSchema = z.object({
     features: z
         .array(z.string())
@@ -82,44 +83,37 @@ function generateInstructions(setupCommands, features) {
     const hasRouting = features.includes('routing');
     return `## Setup Instructions
 
-1. Create project directory and initialize with provided \`packageJson\`
-2. Create files from \`fileStructure\` using \`get_example\` patterns
-3. Use provided content directly for: \`viteEnvDts\`, \`envTs\`${hasRouting ? ', `routesTs`' : ''}, \`claudeMd\`, \`docs\`
-4. Run: ${setupCommands.join(' && ')}
+1. Create project with \`packageJson\`
+2. Use generated content: \`claudeMd\`, \`viteEnvDts\`, \`envTs\`${hasRouting ? ', `routesTs`' : ''}
+3. Fetch config files: \`get_file({ path: "..." })\` for each in \`configFiles\`
+4. Fetch docs: \`get_file({ path: "..." })\` for each in \`docs\`
+5. Create source files: \`get_example({ pattern: "..." })\`
+6. Run: ${setupCommands.join(' && ')}
 
 ## IMPORTANT
 
 Templates are written for ALL features. Remove imports, providers, and code for features not in \`resolvedFeatures\`.`;
 }
+/** Tool definition derived from Zod schema - single source of truth (Zod v4 native). */
 export const getScaffoldToolDefinition = {
     name: 'get_scaffold',
     description: `Get complete scaffold information for a new react-spa-scaffold project.
 
-Returns package.json, file structure, config files, generated content (env.ts, routes.ts, CLAUDE.md), and setup commands.
+Returns package.json, file structure paths, setup commands, and generated files.
+
+**Lazy Loading**: \`configFiles\` and \`docs\` contain paths only.
+Use \`get_file({ path: "..." })\` to fetch individual file content.
+
+**Generated Content** (included directly):
+- \`claudeMd\`: CLAUDE.md content
+- \`viteEnvDts\`, \`envTs\`: TypeScript declarations
+- \`routesTs\`: Route constants (if routing feature selected)
 
 IMPORTANT: Templates contain code for ALL features. Strip imports and code for features not in \`resolvedFeatures\`.
 
 Feature dependencies: theming → state (auto-included)
 
 Example: features: ["routing", "ui", "theming"] → resolvedFeatures: ["core", "routing", "ui", "theming", "state"]`,
-    inputSchema: {
-        type: 'object',
-        properties: {
-            features: {
-                type: 'array',
-                items: { type: 'string' },
-                description: 'List of feature IDs to include',
-            },
-            projectName: {
-                type: 'string',
-                description: 'Name for the new project',
-            },
-            includeExamples: {
-                type: 'boolean',
-                description: 'Include code examples for patterns',
-            },
-        },
-        required: ['features'],
-    },
+    inputSchema: z.toJSONSchema(getScaffoldSchema),
 };
 //# sourceMappingURL=get-scaffold.js.map

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

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

package/dist/tools/get-scaffold.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Tests for get_scaffold tool
+ */
+export {};
+//# sourceMappingURL=get-scaffold.test.d.ts.map

package/dist/tools/get-scaffold.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-scaffold.test.d.ts","sourceRoot":"","sources":["../../src/tools/get-scaffold.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/tools/get-scaffold.test.js

@@ -0,0 +1,197 @@
+/**
+ * Tests for get_scaffold tool
+ */
+import { describe, it, expect } from 'vitest';
+import { getScaffold, getScaffoldSchema } from './get-scaffold.js';
+describe('get_scaffold tool', () => {
+    it('always includes core feature', async () => {
+        const result = await getScaffold({ features: ['routing'] });
+        expect(result.resolvedFeatures).toContain('core');
+    });
+    it('rejects invalid features via schema', () => {
+        const result = getScaffoldSchema.safeParse({
+            features: ['invalid-feature'],
+        });
+        expect(result.success).toBe(false);
+        if (!result.success) {
+            expect(result.error.message).toContain('Invalid features');
+        }
+    });
+    it('only includes explicitly selected features (plus core)', async () => {
+        const result = await getScaffold({ features: ['ui'] });
+        expect(result.resolvedFeatures).not.toContain('state');
+        expect(result.resolvedFeatures).not.toContain('mobile');
+        expect(result.resolvedFeatures).toContain('ui');
+        expect(result.resolvedFeatures).toContain('core');
+    });
+    it('theming feature auto-includes state feature', async () => {
+        const result = await getScaffold({ features: ['theming'] });
+        expect(result.resolvedFeatures).toContain('theming');
+        expect(result.resolvedFeatures).toContain('state');
+        expect(result.resolvedFeatures).toContain('core');
+    });
+    it('marks auto-included features correctly', async () => {
+        const result = await getScaffold({ features: ['theming'] });
+        const themingDetail = result.featureDetails.find((f) => f.id === 'theming');
+        const stateDetail = result.featureDetails.find((f) => f.id === 'state');
+        const coreDetail = result.featureDetails.find((f) => f.id === 'core');
+        // Theming was explicitly selected
+        expect(themingDetail?.wasExplicitlySelected).toBe(true);
+        expect(themingDetail?.wasAutoIncluded).toBe(false);
+        // State was auto-included (dependency of theming)
+        expect(stateDetail?.wasExplicitlySelected).toBe(false);
+        expect(stateDetail?.wasAutoIncluded).toBe(true);
+        // Core is always auto-included
+        expect(coreDetail?.wasExplicitlySelected).toBe(false);
+        expect(coreDetail?.wasAutoIncluded).toBe(true);
+    });
+    it('includes theming files when theming feature is selected', async () => {
+        const result = await getScaffold({ features: ['theming'] });
+        expect(result.fileStructure).toContain('src/hooks/useThemeEffect.ts');
+        expect(result.fileStructure).toContain('src/components/shared/ThemeToggle/ThemeToggle.tsx');
+    });
+    it('excludes theming files when only ui is selected', async () => {
+        const result = await getScaffold({ features: ['ui'] });
+        expect(result.fileStructure).not.toContain('src/hooks/useThemeEffect.ts');
+        expect(result.fileStructure).not.toContain('src/components/shared/ThemeToggle/ThemeToggle.tsx');
+    });
+    it('includes mobile files when mobile feature is selected', async () => {
+        const result = await getScaffold({ features: ['mobile'] });
+        expect(result.fileStructure).toContain('src/contexts/mobileContext.tsx');
+        expect(result.fileStructure).toContain('src/hooks/useMediaQuery.ts');
+        expect(result.fileStructure).toContain('src/hooks/useTouchSizes.ts');
+    });
+    it('excludes mobile files when only core is selected', async () => {
+        const result = await getScaffold({ features: [] });
+        expect(result.fileStructure).not.toContain('src/contexts/mobileContext.tsx');
+        expect(result.fileStructure).not.toContain('src/hooks/useMediaQuery.ts');
+    });
+    it('returns valid package.json structure', async () => {
+        const result = await getScaffold({ features: ['routing'], projectName: 'test-app' });
+        expect(result.packageJson).toBeDefined();
+        expect(result.packageJson.name).toBe('test-app');
+        expect(result.packageJson.dependencies).toBeDefined();
+        expect(result.packageJson.devDependencies).toBeDefined();
+        expect(result.packageJson.scripts).toBeDefined();
+    });
+    it('includes react in core dependencies', async () => {
+        const result = await getScaffold({ features: [] });
+        expect(result.packageJson.dependencies).toHaveProperty('react');
+        expect(result.packageJson.dependencies).toHaveProperty('react-dom');
+    });
+    it('includes routing dependencies when routing feature selected', async () => {
+        const result = await getScaffold({ features: ['routing'] });
+        expect(result.packageJson.dependencies).toHaveProperty('react-router');
+    });
+    it('returns file structure', async () => {
+        const result = await getScaffold({ features: ['routing'] });
+        expect(Array.isArray(result.fileStructure)).toBe(true);
+        expect(result.fileStructure.length).toBeGreaterThan(0);
+    });
+    it('returns setup commands', async () => {
+        const result = await getScaffold({ features: ['routing'] });
+        expect(Array.isArray(result.setupCommands)).toBe(true);
+        expect(result.setupCommands).toContain('npm install');
+    });
+    it('uses default project name when not provided', async () => {
+        const result = await getScaffold({ features: [] });
+        expect(result.projectName).toBe('my-app');
+    });
+    it('marks explicitly selected features correctly', async () => {
+        const result = await getScaffold({ features: ['ui', 'state'] });
+        const stateDetail = result.featureDetails.find((f) => f.id === 'state');
+        const uiDetail = result.featureDetails.find((f) => f.id === 'ui');
+        expect(stateDetail?.wasExplicitlySelected).toBe(true);
+        expect(stateDetail?.wasAutoIncluded).toBe(false);
+        expect(uiDetail?.wasExplicitlySelected).toBe(true);
+        expect(uiDetail?.wasAutoIncluded).toBe(false);
+    });
+    it('includes CLAUDE.md in file structure', async () => {
+        const result = await getScaffold({ features: [] });
+        expect(result.fileStructure).toContain('CLAUDE.md');
+    });
+    it('returns claudeMd content', async () => {
+        const result = await getScaffold({ features: [], projectName: 'test-project' });
+        expect(result.claudeMd).toBeDefined();
+        expect(typeof result.claudeMd).toBe('string');
+        expect(result.claudeMd).toContain('# CLAUDE.md');
+        expect(result.claudeMd).toContain('test-project');
+    });
+    it('claudeMd includes testing section when testing feature selected', async () => {
+        const result = await getScaffold({ features: ['testing'] });
+        expect(result.claudeMd).toContain('## Testing');
+        expect(result.claudeMd).toContain('Vitest');
+    });
+    it('claudeMd excludes testing section when testing feature not selected', async () => {
+        const result = await getScaffold({ features: [] });
+        expect(result.claudeMd).not.toContain('## Testing');
+    });
+    it('claudeMd includes UI section only when ui feature selected', async () => {
+        const withUi = await getScaffold({ features: ['ui'] });
+        const withoutUi = await getScaffold({ features: [] });
+        expect(withUi.claudeMd).toContain('## UI Components');
+        expect(withoutUi.claudeMd).not.toContain('## UI Components');
+    });
+    it('claudeMd includes i18n section only when i18n feature selected', async () => {
+        const withI18n = await getScaffold({ features: ['i18n'] });
+        const withoutI18n = await getScaffold({ features: [] });
+        expect(withI18n.claudeMd).toContain('## Translations');
+        expect(withoutI18n.claudeMd).not.toContain('## Translations');
+    });
+    it('claudeMd includes mobile section only when mobile feature selected', async () => {
+        const withMobile = await getScaffold({ features: ['mobile'] });
+        const withoutMobile = await getScaffold({ features: [] });
+        expect(withMobile.claudeMd).toContain('## Mobile & Responsive Design');
+        expect(withMobile.claudeMd).toContain('MobileProvider');
+        expect(withoutMobile.claudeMd).not.toContain('## Mobile & Responsive Design');
+    });
+    it('claudeMd includes theming section only when theming feature selected', async () => {
+        const withTheming = await getScaffold({ features: ['theming'] });
+        const withoutTheming = await getScaffold({ features: [] });
+        expect(withTheming.claudeMd).toContain('## Theming');
+        expect(withTheming.claudeMd).toContain('usePreferencesStore');
+        expect(withoutTheming.claudeMd).not.toContain('## Theming');
+    });
+    it('claudeMd project structure shows contexts when mobile is selected', async () => {
+        const withMobile = await getScaffold({ features: ['mobile'] });
+        const withoutMobile = await getScaffold({ features: [] });
+        expect(withMobile.claudeMd).toContain('contexts/');
+        expect(withoutMobile.claudeMd).not.toContain('contexts/');
+    });
+    it('returns config files as paths array (lazy loading)', async () => {
+        const result = await getScaffold({ features: ['ui'] });
+        expect(Array.isArray(result.configFiles)).toBe(true);
+        expect(result.configFiles).toContain('components.json');
+    });
+    it('always includes .gitignore in fileStructure (core feature)', async () => {
+        const result = await getScaffold({ features: [] });
+        expect(result.fileStructure).toContain('.gitignore');
+    });
+    it('always includes .gitignore in configFiles array', async () => {
+        const result = await getScaffold({ features: [] });
+        expect(result.configFiles).toContain('.gitignore');
+    });
+    it('returns docs as paths array (lazy loading)', async () => {
+        const result = await getScaffold({ features: [] });
+        expect(Array.isArray(result.docs)).toBe(true);
+        expect(result.docs).toContain('docs/ARCHITECTURE.md');
+        expect(result.docs).not.toContain('docs/TESTING.md');
+    });
+    it('includes docs paths in structure', async () => {
+        const result = await getScaffold({ features: [] });
+        expect(result.fileStructure).toContain('docs/ARCHITECTURE.md');
+        expect(result.fileStructure).not.toContain('docs/TESTING.md');
+    });
+    it('adds feature-specific docs when feature selected', async () => {
+        const result = await getScaffold({ features: ['testing'] });
+        expect(result.fileStructure).toContain('docs/TESTING.md');
+        expect(result.docs).toContain('docs/TESTING.md');
+    });
+    it('instructions reference get_file for lazy loading', async () => {
+        const result = await getScaffold({ features: [] });
+        expect(result.instructions).toContain('get_file');
+        expect(result.instructions).toContain('configFiles');
+        expect(result.instructions).toContain('docs');
+    });
+});
+//# sourceMappingURL=get-scaffold.test.js.map