@react-spa-scaffold/mcp 1.2.0 → 2.0.0

package/dist/features/definitions/ui.js.map

@@ -1 +1 @@
-{"version":3,"file":"ui.js","sourceRoot":"","sources":["../../../src/features/definitions/ui.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,EAAE,GAAY;IACzB,IAAI,EAAE,eAAe;IACrB,WAAW,EAAE,yCAAyC;IACtD,QAAQ,EAAE,KAAK;IACf,QAAQ,EAAE;QACR,+CAA+C;QAC/C,qBAAqB;QACrB,6CAA6C;QAC7C,oBAAoB;QACpB,+BAA+B;QAC/B,4BAA4B;QAC5B,4DAA4D;QAC5D,wBAAwB;QACxB,uCAAuC;QACvC,6CAA6C;QAC7C,gCAAgC;KACjC;IACD,eAAe,EAAE;QACf,sBAAsB;QACtB,0BAA0B;QAC1B,cAAc;QACd,UAAU;QACV,QAAQ;QACR,gBAAgB;KACjB;IACD,kBAAkB,EAAE,CAAC,QAAQ,CAAC;IAC9B,KAAK,EAAE;QACL,8BAA8B;QAC9B,qCAAqC;QACrC,+BAA+B;QAC/B,gCAAgC;QAChC,+BAA+B;QAC/B,8BAA8B;QAC9B,uCAAuC;QACvC,kCAAkC;QAClC,gCAAgC;QAChC,iBAAiB;KAClB;IACD,SAAS,EAAE,CAAC,oCAAoC,EAAE,uCAAuC,CAAC;IAC1F,QAAQ,EAAE,CAAC,cAAc,EAAE,iBAAiB,EAAE,uBAAuB,CAAC;IACtE,OAAO,EAAE,EAAE;IACX,WAAW,EAAE,CAAC,iBAAiB,CAAC;CACjC,CAAC"}
+{"version":3,"file":"ui.js","sourceRoot":"","sources":["../../../src/features/definitions/ui.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,EAAE,GAAY;IACzB,IAAI,EAAE,eAAe;IACrB,WAAW,EAAE,yCAAyC;IACtD,QAAQ,EAAE,KAAK;IACf,QAAQ,EAAE;QACR,+CAA+C;QAC/C,qBAAqB;QACrB,6CAA6C;QAC7C,oBAAoB;QACpB,+BAA+B;QAC/B,4BAA4B;QAC5B,4DAA4D;QAC5D,wBAAwB;QACxB,uCAAuC;QACvC,6CAA6C;QAC7C,gCAAgC;KACjC;IACD,eAAe,EAAE;QACf,sBAAsB;QACtB,0BAA0B;QAC1B,cAAc;QACd,UAAU;QACV,QAAQ;QACR,gBAAgB;KACjB;IACD,kBAAkB,EAAE,CAAC,QAAQ,CAAC;IAC9B,KAAK,EAAE;QACL,8BAA8B;QAC9B,qCAAqC;QACrC,+BAA+B;QAC/B,gCAAgC;QAChC,+BAA+B;QAC/B,8BAA8B;QAC9B,uCAAuC;QACvC,kCAAkC;QAClC,gCAAgC;QAChC,iBAAiB;KAClB;IACD,SAAS,EAAE,CAAC,oCAAoC,EAAE,uCAAuC,CAAC;IAC1F,OAAO,EAAE,EAAE;IACX,WAAW,EAAE,CAAC,iBAAiB,CAAC;CACjC,CAAC"}

package/dist/features/types.d.ts

@@ -1,34 +1,26 @@
 /**
  * Type definitions for feature modules
  */
-/**
- * All valid feature IDs as a const tuple.
- * Used for compile-time type safety when referencing features.
- */
-export declare const FEATURE_IDS: readonly ["core", "mobile", "routing", "ui", "forms", "state", "api", "i18n", "testing", "performance", "devtools", "ci", "observability", "theming"];
-/** Type-safe feature identifier */
-export type FeatureId = (typeof FEATURE_IDS)[number];
-/** Type guard to check if a string is a valid FeatureId */
+import { FEATURE } from '../constants.js';
+/** All valid feature IDs derived from FEATURE constant (single source of truth). */
+export declare const FEATURE_IDS: readonly FeatureId[];
+/** Type-safe feature identifier. */
+export type FeatureId = (typeof FEATURE)[keyof typeof FEATURE];
+/** Type guard to check if a string is a valid FeatureId. */
 export declare function isFeatureId(value: string): value is FeatureId;
 export interface Feature {
     name: string;
     description: string;
     required: boolean;
     includes: string[];
-    /**
-     * Dependency package names - versions resolved from webapp-base package.json at runtime.
-     * This ensures scaffolded projects always get up-to-date dependency versions.
-     */
+    /** Other features this feature depends on (auto-included when this feature is selected). */
+    requires?: FeatureId[];
+    /** Dependency package names - versions resolved from package.json at runtime. */
     dependencyNames?: string[];
     devDependencyNames?: string[];
     files: string[];
-    /**
-     * Test files associated with this feature.
-     * Only included in scaffold when the 'testing' feature is also selected.
-     * This keeps feature source files separate from test infrastructure concerns.
-     */
+    /** Test files - only included when 'testing' feature is also selected. */
     testFiles?: string[];
-    patterns: string[];
     scripts?: Record<string, string>;
     configFiles?: string[];
 }
@@ -47,12 +39,14 @@ export interface ScaffoldResult {
         engines: Record<string, string>;
     };
     structure: string[];
-    configFiles: Record<string, string>;
+    /** Config file paths (use get_file to fetch content) */
+    configFiles: string[];
     setupCommands: string[];
     claudeMd: string;
     viteEnvDts: string;
     envTs: string;
     routesTs?: string;
-    docs: Record<string, string>;
+    /** Documentation file paths (use get_file to fetch content) */
+    docs: string[];
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/features/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/features/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,eAAO,MAAM,WAAW,uJAed,CAAC;AAEX,mCAAmC;AACnC,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAErD,2DAA2D;AAC3D,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,SAAS,CAE7D;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,8DAA8D;AAC9D,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;AAEzD,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE;QACX,IAAI,EAAE,MAAM,CAAC;QACb,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACrC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACxC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAChC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACjC,CAAC;IACF,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/features/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE1C,oFAAoF;AACpF,eAAO,MAAM,WAAW,EAA6B,SAAS,SAAS,EAAE,CAAC;AAE1E,oCAAoC;AACpC,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,OAAO,CAAC,CAAC,MAAM,OAAO,OAAO,CAAC,CAAC;AAE/D,4DAA4D;AAC5D,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,SAAS,CAE7D;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,4FAA4F;IAC5F,QAAQ,CAAC,EAAE,SAAS,EAAE,CAAC;IACvB,iFAAiF;IACjF,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,0EAA0E;IAC1E,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,8DAA8D;AAC9D,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;AAEzD,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE;QACX,IAAI,EAAE,MAAM,CAAC;QACb,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACrC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACxC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAChC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACjC,CAAC;IACF,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,wDAAwD;IACxD,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+DAA+D;IAC/D,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB"}

package/dist/features/types.js

@@ -1,27 +1,10 @@
 /**
  * Type definitions for feature modules
  */
-/**
- * All valid feature IDs as a const tuple.
- * Used for compile-time type safety when referencing features.
- */
-export const FEATURE_IDS = [
-    'core',
-    'mobile',
-    'routing',
-    'ui',
-    'forms',
-    'state',
-    'api',
-    'i18n',
-    'testing',
-    'performance',
-    'devtools',
-    'ci',
-    'observability',
-    'theming',
-];
-/** Type guard to check if a string is a valid FeatureId */
+import { FEATURE } from '../constants.js';
+/** All valid feature IDs derived from FEATURE constant (single source of truth). */
+export const FEATURE_IDS = Object.values(FEATURE);
+/** Type guard to check if a string is a valid FeatureId. */
 export function isFeatureId(value) {
     return FEATURE_IDS.includes(value);
 }

package/dist/features/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/features/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,MAAM;IACN,QAAQ;IACR,SAAS;IACT,IAAI;IACJ,OAAO;IACP,OAAO;IACP,KAAK;IACL,MAAM;IACN,SAAS;IACT,aAAa;IACb,UAAU;IACV,IAAI;IACJ,eAAe;IACf,SAAS;CACD,CAAC;AAKX,2DAA2D;AAC3D,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,OAAO,WAAW,CAAC,QAAQ,CAAC,KAAkB,CAAC,CAAC;AAClD,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/features/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE1C,oFAAoF;AACpF,MAAM,CAAC,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAyB,CAAC;AAK1E,4DAA4D;AAC5D,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,OAAQ,WAAiC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC5D,CAAC"}

package/dist/features/types.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Tests for feature type definitions.
+ */
+export {};
+//# sourceMappingURL=types.test.d.ts.map

package/dist/features/types.test.d.ts.map

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

package/dist/features/types.test.js

@@ -0,0 +1,32 @@
+/**
+ * Tests for feature type definitions.
+ */
+import { describe, it, expect } from 'vitest';
+import { FEATURE } from '../constants.js';
+import { FEATURE_IDS, isFeatureId } from './types.js';
+describe('FEATURE_IDS', () => {
+    it('is derived from FEATURE constant', () => {
+        expect(FEATURE_IDS).toEqual(Object.values(FEATURE));
+    });
+    it('contains expected features', () => {
+        expect(FEATURE_IDS).toContain('core');
+        expect(FEATURE_IDS).toContain('routing');
+        expect(FEATURE_IDS).toContain('testing');
+    });
+    it('has 14 features', () => {
+        expect(FEATURE_IDS).toHaveLength(14);
+    });
+});
+describe('isFeatureId', () => {
+    it('returns true for valid feature IDs', () => {
+        expect(isFeatureId('core')).toBe(true);
+        expect(isFeatureId('routing')).toBe(true);
+        expect(isFeatureId('theming')).toBe(true);
+    });
+    it('returns false for invalid feature IDs', () => {
+        expect(isFeatureId('invalid')).toBe(false);
+        expect(isFeatureId('')).toBe(false);
+        expect(isFeatureId('CORE')).toBe(false);
+    });
+});
+//# sourceMappingURL=types.test.js.map

package/dist/features/types.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.test.js","sourceRoot":"","sources":["../../src/features/types.test.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEtD,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;QACpC,MAAM,CAAC,WAAW,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACtC,MAAM,CAAC,WAAW,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QACzC,MAAM,CAAC,WAAW,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iBAAiB,EAAE,GAAG,EAAE;QACzB,MAAM,CAAC,WAAW,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvC,MAAM,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1C,MAAM,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC3C,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACpC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/resources/docs.d.ts

@@ -1,9 +1,5 @@
 /**
- * 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.
+ * Documentation resources - reads docs from react-spa-scaffold repository.
  */
 /**
  * Get list of all available documentation resources
@@ -14,9 +10,7 @@ export declare function getDocumentationResources(): {
     description: string;
     mimeType: string;
 }[];
-/**
- * Read documentation content for a resource URI (cached)
- */
+/** Read documentation content for a resource URI (cached, parallel). */
 export declare function readDocumentation(uri: string): Promise<string | null>;
 /**
  * Check if a URI is a valid documentation resource

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

@@ -1 +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"}
+{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../src/resources/docs.ts"],"names":[],"mappings":"AAAA;;GAEG;AAkDH;;GAEG;AACH,wBAAgB,yBAAyB;;;;;IAOxC;AAED,wEAAwE;AACxE,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAiB3E;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

@@ -1,47 +1,39 @@
 /**
- * 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.
+ * Documentation resources - reads docs from react-spa-scaffold repository.
  */
 import { readFile } from 'fs/promises';
+import { DOCS_URI } from '../constants.js';
+import { createCache } from '../utils/cache.js';
 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 docsCache = createCache();
+/** Documentation file mapping - maps URIs to repository files. */
 const DOCS_MAP = {
-    'docs://conventions': {
+    [DOCS_URI.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',
+        description: 'Coding standards, naming conventions, and component patterns',
     },
-    'docs://architecture': {
+    [DOCS_URI.ARCHITECTURE]: {
         files: ['docs/ARCHITECTURE.md'],
         name: 'Architecture Overview',
-        description: 'Technology stack, data flow, and architectural decisions for react-spa-scaffold',
+        description: 'Technology stack, data flow, and architectural decisions',
     },
-    'docs://testing': {
+    [DOCS_URI.TESTING]: {
         files: ['docs/TESTING.md', 'docs/E2E_TESTING.md'],
         name: 'Testing Guide',
         description: 'Unit testing with Vitest and E2E testing with Playwright',
     },
-    'docs://i18n': {
+    [DOCS_URI.I18N]: {
         files: ['docs/INTERNATIONALIZATION.md'],
         name: 'Internationalization',
         description: 'LinguiJS setup, Trans component usage, and translation workflow',
     },
-    'docs://api': {
+    [DOCS_URI.API]: {
         files: ['docs/API_REFERENCE.md'],
         name: 'API Reference',
         description: 'API client utilities, hooks, and data fetching patterns',
     },
-    'docs://claude': {
+    [DOCS_URI.CLAUDE]: {
         files: ['CLAUDE.md'],
         name: 'Claude AI Guidance',
         description: 'AI assistant instructions and project-specific guidance',
@@ -58,37 +50,23 @@ export function getDocumentationResources() {
         mimeType: 'text/markdown',
     }));
 }
-/**
- * Read documentation content for a resource URI (cached)
- */
+/** Read documentation content for a resource URI (cached, parallel). */
 export async function readDocumentation(uri) {
     const doc = DOCS_MAP[uri];
-    if (!doc) {
+    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;
+    return docsCache.getOrSet(uri, async () => {
+        const contents = await Promise.all(doc.files.map(async (file) => {
+            const fullPath = resolveTemplatePath(file);
+            try {
+                return await readFile(fullPath, 'utf-8');
+            }
+            catch {
+                return `<!-- File not found: ${file} -->\n`;
+            }
+        }));
+        return contents.length > 1 ? contents.join('\n\n---\n\n') : (contents[0] ?? '');
+    });
 }
 /**
  * Check if a URI is a valid documentation resource

package/dist/resources/docs.js.map

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

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAyCnE,6CAA6C;AAC7C,wBAAgB,YAAY,IAAI,MAAM,CA0DrC"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AA0CnE,6CAA6C;AAC7C,wBAAgB,YAAY,IAAI,MAAM,CA0DrC"}

package/dist/server.js

@@ -3,8 +3,9 @@
  */
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { CallToolRequestSchema, ListResourcesRequestSchema, ListToolsRequestSchema, ReadResourceRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
-import { TOOL_REGISTRY, getToolDefinitions } from './tools/index.js';
-import { getDocumentationResources, readDocumentation, isValidDocumentationUri } from './resources/index.js';
+// Direct imports - flattened for faster startup
+import { TOOL_REGISTRY, getToolDefinitions } from './tools/registry.js';
+import { getDocumentationResources, readDocumentation, isValidDocumentationUri } from './resources/docs.js';
 import { VERSION } from './version.js';
 function jsonResponse(data) {
     return {
@@ -21,16 +22,16 @@ 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
+1. get_features - list available feature modules
+2. get_scaffold - get project structure (paths only)
+3. get_file - fetch content for EACH file
+
+CRITICAL: Do not generate files. Fetch via get_file, then strip unselected features.
 
 Tips:
 - Core feature is always included automatically
-- Features are mostly independent - select only what you need
 - Theming feature automatically includes state (requires Zustand)
-- Check docs://conventions before generating code
+- Read docs:// resources for conventions and best practices
 `.trim();
 /** Creates and configures the MCP server. */
 export function createServer() {

package/dist/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EACL,qBAAqB,EACrB,0BAA0B,EAC1B,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACrE,OAAO,EAAE,yBAAyB,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC7G,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,SAAS,YAAY,CAAC,IAAa;IACjC,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;KAC1E,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,OAAe;IACpC,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;QACnD,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC;AAED,MAAM,mBAAmB,GAAG;;;;;;;;;;;;;;CAc3B,CAAC,IAAI,EAAE,CAAC;AAET,6CAA6C;AAC7C,MAAM,UAAU,YAAY;IAC1B,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB,EAAE,IAAI,EAAE,wBAAwB,EAAE,OAAO,EAAE,OAAO,EAAE,EACpD,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,EAAE,YAAY,EAAE,mBAAmB,EAAE,CAClF,CAAC;IAEF,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;QAC5D,KAAK,EAAE,kBAAkB,EAAE;KAC5B,CAAC,CAAC,CAAC;IAEJ,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QAChE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;QACjD,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;QAEvC,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO,aAAa,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC;QAChD,CAAC;QAED,IAAI,CAAC;YACH,IAAI,UAAU,CAAC,MAAM,EAAE,CAAC;gBACtB,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;gBACjD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;oBACpB,OAAO,aAAa,CAAC,kBAAkB,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;gBACjE,CAAC;gBACD,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;gBACrD,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC;YAC9B,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,EAAE,CAAC;YAC1C,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC;QAC9B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,OAAO,aAAa,CAAC,mBAAmB,IAAI,KAAK,OAAO,EAAE,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,iBAAiB,CAAC,0BAA0B,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;QAChE,SAAS,EAAE,yBAAyB,EAAE;KACvC,CAAC,CAAC,CAAC;IAEJ,MAAM,CAAC,iBAAiB,CAAC,yBAAyB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QACpE,MAAM,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;QAE/B,IAAI,CAAC,uBAAuB,CAAC,GAAG,CAAC,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CAAC,qBAAqB,GAAG,EAAE,CAAC,CAAC;QAC9C,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,iBAAiB,CAAC,GAAG,CAAC,CAAC;QAC7C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,4BAA4B,GAAG,EAAE,CAAC,CAAC;QACrD,CAAC;QAED,OAAO;YACL,QAAQ,EAAE,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,eAAe,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;SAC9D,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

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

@@ -5,6 +5,8 @@
  * AI agents use this to understand what features are available
  * and present options to users.
  */
+import type { ToolDefinition } from './types.js';
+/** Feature summary returned by get_features tool. */
 export interface FeatureSummary {
     id: string;
     name: string;
@@ -12,14 +14,18 @@ export interface FeatureSummary {
     required: boolean;
     includes: string[];
 }
+/**
+ * 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 declare function getFeatures(): FeatureSummary[];
-export declare const getFeaturesToolDefinition: {
-    name: string;
-    description: string;
-    inputSchema: {
-        type: "object";
-        properties: {};
-        required: string[];
-    };
-};
+/** Tool definition for get_features - no input required. */
+export declare const getFeaturesToolDefinition: ToolDefinition;
 //# sourceMappingURL=get-features.d.ts.map

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;CACpB;AAED,wBAAgB,WAAW,IAAI,cAAc,EAAE,CAW9C;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];
@@ -18,6 +29,7 @@ export function getFeatures() {
         };
     });
 }
+/** 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;AAU7D,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,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-file.d.ts

@@ -0,0 +1,23 @@
+/**
+ * get_file tool
+ *
+ * Fetches content of ANY file from react-spa-scaffold templates.
+ * 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,cAgBnC,CAAC"}

package/dist/tools/get-file.js

@@ -0,0 +1,57 @@
+/**
+ * get_file tool
+ *
+ * Fetches content of ANY file from react-spa-scaffold templates.
+ * 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 (fileStructure, configFiles, or docs)'),
+});
+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 (fileStructure, configFiles, or docs)',
+        };
+    }
+    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 file content from react-spa-scaffold templates.
+
+Use with paths from \`get_scaffold\` response:
+- \`configFiles\`: config file paths
+- \`docs\`: documentation paths
+- \`fileStructure\`: ALL source file paths
+
+IMPORTANT: Fetch content for EVERY file in fileStructure, then strip code for unselected features.
+
+Examples:
+- \`{ path: "vite.config.ts" }\`
+- \`{ path: "docs/TESTING.md" }\`
+- \`{ path: "src/App.tsx" }\``,
+    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,mEAAmE,CAAC;CAC/F,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,mEAAmE;SAC1E,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;;;;;;;;;;;;8BAYe;IAC5B,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