@gemini-designer/mcp-server 0.1.0

package/dist/tools/sync-design-tokens.d.ts

@@ -0,0 +1,14 @@
+/**
+ * sync_design_tokens Tool
+ *
+ * Converts design tokens between formats and optionally writes them to files.
+ *
+ * Primary use cases:
+ * - Take existing CSS vars and generate Tailwind theme extension
+ * - Export Tokens Studio JSON for Figma/Tokens Studio workflows
+ * - Normalize token files for team consistency
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { Config } from '../config/index.js';
+export declare function registerSyncDesignTokens(server: McpServer, config: Config): void;
+//# sourceMappingURL=sync-design-tokens.d.ts.map

package/dist/tools/sync-design-tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-design-tokens.d.ts","sourceRoot":"","sources":["../../src/tools/sync-design-tokens.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGpE,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AA6D5C,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAoLhF"}

package/dist/tools/sync-design-tokens.js

@@ -0,0 +1,233 @@
+/**
+ * sync_design_tokens Tool
+ *
+ * Converts design tokens between formats and optionally writes them to files.
+ *
+ * Primary use cases:
+ * - Take existing CSS vars and generate Tailwind theme extension
+ * - Export Tokens Studio JSON for Figma/Tokens Studio workflows
+ * - Normalize token files for team consistency
+ */
+import { z } from 'zod';
+import * as fs from 'node:fs';
+import { assertReadablePath, assertWritablePath } from '../context/guards.js';
+import { sanitizeContent } from '../context/filter.js';
+import { writeFile } from '../output/file-writer.js';
+import { parseCssVars, tokensToCssVars, tokensToTailwindTheme, tokensToTokensStudio, tokensToStyleDictionary, } from '../tokens/sync.js';
+import { generateWithGemini } from '../generation/gemini-client.js';
+const inputSchema = {
+    sourcePath: z.string().optional().describe('Path to a token source file (CSS vars or JSON).'),
+    sourceContent: z.string().optional().describe('Inline token content (if not using sourcePath).'),
+    sourceType: z
+        .enum(['css-vars', 'tokens-json', 'style-dictionary'])
+        .default('css-vars')
+        .describe('How to interpret the source.'),
+    targets: z
+        .array(z.enum(['css-vars', 'tailwind', 'tokens-studio', 'style-dictionary']))
+        .default(['css-vars', 'tailwind', 'tokens-studio'])
+        .describe('Target formats to generate.'),
+    aiNormalize: z
+        .boolean()
+        .default(false)
+        .describe('If true, use the model to improve token naming & grouping (uses tokens).'),
+    writeToFile: z.boolean().default(false).describe('If true, write generated outputs to files.'),
+    outputPaths: z
+        .object({
+        cssVars: z.string().optional(),
+        tailwind: z.string().optional(),
+        tokensStudio: z.string().optional(),
+        styleDictionary: z.string().optional(),
+    })
+        .optional()
+        .describe('Where to write outputs if writeToFile=true.'),
+    backup: z.boolean().default(true).describe('Create .bak backups for overwritten files.'),
+};
+const NORMALIZE_SYSTEM_PROMPT = `You are a design systems engineer. You will normalize and improve a design token set.
+
+Goal:
+- Improve token naming and grouping using semantic names (primary, surface, text, border, danger, success)
+- Preserve ALL token values exactly (do not change hex codes, sizes, etc.)
+- Remove duplicates when values are identical AND names are redundant
+
+Output rules:
+- Output ONE valid JSON array of tokens only. No markdown. No prose.
+- Each token: {"name": string, "value": string, "type": string, "description"?: string}
+`;
+function cleanJsonArray(response) {
+    let out = response.trim();
+    const fenced = out.match(/```(?:json)?\n([\s\S]*?)```/);
+    if (fenced)
+        out = fenced[1].trim();
+    return out;
+}
+export function registerSyncDesignTokens(server, config) {
+    server.registerTool('sync_design_tokens', {
+        title: 'Sync Design Tokens',
+        description: 'Convert tokens between CSS vars, Tailwind theme, Tokens Studio JSON, and Style Dictionary. Optionally writes outputs to files.',
+        inputSchema,
+    }, async (args) => {
+        const sourcePath = args.sourcePath;
+        const sourceContent = args.sourceContent;
+        const sourceType = args.sourceType || 'css-vars';
+        const targets = args.targets || [
+            'css-vars',
+            'tailwind',
+            'tokens-studio',
+        ];
+        const aiNormalize = args.aiNormalize === true;
+        const writeToFile = args.writeToFile === true;
+        const outputPaths = args.outputPaths;
+        const backup = args.backup !== false;
+        if (!sourcePath && !sourceContent) {
+            return {
+                content: [{ type: 'text', text: 'Error: Provide either sourcePath or sourceContent.' }],
+                isError: true,
+            };
+        }
+        let raw;
+        let safeSourcePath;
+        try {
+            if (sourcePath) {
+                safeSourcePath = assertReadablePath(sourcePath, config);
+                raw = fs.readFileSync(safeSourcePath, 'utf-8');
+            }
+            else {
+                raw = sourceContent;
+            }
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : 'Could not read source';
+            return {
+                content: [{ type: 'text', text: `Error: ${message}` }],
+                isError: true,
+            };
+        }
+        raw = sanitizeContent(raw);
+        let tokens = [];
+        const warnings = [];
+        try {
+            if (sourceType === 'css-vars') {
+                const parsed = parseCssVars(raw, safeSourcePath);
+                tokens = parsed.tokens;
+                warnings.push(...parsed.warnings);
+            }
+            else {
+                // Very lightweight: accept either Tokens Studio or Style Dictionary style
+                const json = JSON.parse(raw);
+                const collected = [];
+                const walk = (obj, prefix) => {
+                    if (!obj || typeof obj !== 'object')
+                        return;
+                    if (typeof obj.value === 'string' && typeof obj.type === 'string') {
+                        collected.push({
+                            name: [...prefix].join('.'),
+                            value: obj.value,
+                            type: obj.type,
+                            description: typeof obj.description === 'string' ? obj.description : undefined,
+                            source: { file: safeSourcePath ? safeSourcePath.split('/').pop() : undefined },
+                        });
+                        return;
+                    }
+                    for (const [k, v] of Object.entries(obj)) {
+                        walk(v, [...prefix, k]);
+                    }
+                };
+                walk(json, []);
+                tokens = collected;
+                if (tokens.length === 0)
+                    warnings.push('No tokens found in JSON (expected nested {value,type} nodes).');
+            }
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : 'Failed to parse tokens';
+            return {
+                content: [{ type: 'text', text: `Error: ${message}` }],
+                isError: true,
+            };
+        }
+        // Optional AI normalization
+        if (aiNormalize && tokens.length > 0) {
+            const userPrompt = `Normalize these tokens. Remember: never change values.
+
+TOKENS (JSON array):
+${JSON.stringify(tokens, null, 2)}`;
+            try {
+                const resp = await generateWithGemini(config, NORMALIZE_SYSTEM_PROMPT, userPrompt, {
+                    toolName: 'sync_design_tokens',
+                });
+                const cleaned = cleanJsonArray(resp);
+                const normalized = JSON.parse(cleaned);
+                if (Array.isArray(normalized)) {
+                    tokens = normalized;
+                }
+                else {
+                    warnings.push('AI normalization returned non-array output; keeping original tokens.');
+                }
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : 'AI normalization failed';
+                warnings.push(`AI normalization failed: ${message}`);
+            }
+        }
+        const outputs = {};
+        for (const t of targets) {
+            if (t === 'css-vars')
+                outputs.cssVars = tokensToCssVars(tokens);
+            if (t === 'tailwind')
+                outputs.tailwind = tokensToTailwindTheme(tokens);
+            if (t === 'tokens-studio')
+                outputs.tokensStudio = tokensToTokensStudio(tokens);
+            if (t === 'style-dictionary')
+                outputs.styleDictionary = tokensToStyleDictionary(tokens);
+        }
+        // Optional writing
+        const written = [];
+        if (writeToFile) {
+            const mapping = [
+                { outKey: 'cssVars', pathKey: 'cssVars' },
+                { outKey: 'tailwind', pathKey: 'tailwind' },
+                { outKey: 'tokensStudio', pathKey: 'tokensStudio' },
+                { outKey: 'styleDictionary', pathKey: 'styleDictionary' },
+            ];
+            for (const m of mapping) {
+                const content = outputs[m.outKey];
+                const outPath = outputPaths?.[m.pathKey];
+                if (!content || !outPath)
+                    continue;
+                try {
+                    const safeOut = assertWritablePath(outPath, config);
+                    const result = await writeFile(safeOut, content, { format: false, backup });
+                    if (!result.success) {
+                        return {
+                            content: [
+                                {
+                                    type: 'text',
+                                    text: `Error: Failed writing ${outPath}: ${result.error || 'Unknown error'}`,
+                                },
+                            ],
+                            isError: true,
+                        };
+                    }
+                    written.push({ path: result.filePath, backupPath: result.backupPath || undefined });
+                }
+                catch (error) {
+                    const message = error instanceof Error ? error.message : 'Write failed';
+                    return {
+                        content: [{ type: 'text', text: `Error: ${message}` }],
+                        isError: true,
+                    };
+                }
+            }
+        }
+        const response = {
+            tokens,
+            outputs,
+            warnings,
+            written,
+        };
+        return {
+            content: [{ type: 'text', text: JSON.stringify(response, null, 2) }],
+        };
+    });
+}
+//# sourceMappingURL=sync-design-tokens.js.map

package/dist/tools/sync-design-tokens.js.map

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

package/dist/utils/walk.d.ts

@@ -0,0 +1,15 @@
+/**
+ * walk.ts
+ *
+ * Lightweight recursive file walker with sane defaults.
+ * - No extra deps (no glob)
+ * - Skips common large / sensitive directories
+ */
+export interface WalkOptions {
+    includeExtensions?: string[];
+    excludeDirNames?: string[];
+    maxFiles?: number;
+}
+export declare function walkFiles(rootDir: string, options?: WalkOptions): string[];
+export declare function toPosixPath(p: string): string;
+//# sourceMappingURL=walk.d.ts.map

package/dist/utils/walk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"walk.d.ts","sourceRoot":"","sources":["../../src/utils/walk.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,MAAM,WAAW,WAAW;IACxB,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAcD,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,MAAM,EAAE,CAyC9E;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE7C"}

package/dist/utils/walk.js

@@ -0,0 +1,63 @@
+/**
+ * walk.ts
+ *
+ * Lightweight recursive file walker with sane defaults.
+ * - No extra deps (no glob)
+ * - Skips common large / sensitive directories
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+const DEFAULT_EXCLUDE_DIRS = [
+    'node_modules',
+    '.git',
+    '.next',
+    '.nuxt',
+    'dist',
+    'build',
+    '.turbo',
+    '.cache',
+    'coverage',
+];
+export function walkFiles(rootDir, options = {}) {
+    const includeExtensions = (options.includeExtensions || []).map((e) => e.toLowerCase());
+    const exclude = new Set((options.excludeDirNames || DEFAULT_EXCLUDE_DIRS).map((d) => d.toLowerCase()));
+    const maxFiles = typeof options.maxFiles === 'number' ? options.maxFiles : 10_000;
+    const results = [];
+    const queue = [rootDir];
+    while (queue.length > 0) {
+        const current = queue.pop();
+        let entries;
+        try {
+            entries = fs.readdirSync(current, { withFileTypes: true });
+        }
+        catch {
+            continue;
+        }
+        for (const ent of entries) {
+            if (results.length >= maxFiles)
+                return results;
+            const abs = path.join(current, ent.name);
+            if (ent.isDirectory()) {
+                if (exclude.has(ent.name.toLowerCase()))
+                    continue;
+                queue.push(abs);
+                continue;
+            }
+            if (!ent.isFile())
+                continue;
+            if (includeExtensions.length === 0) {
+                results.push(abs);
+                continue;
+            }
+            const ext = path.extname(ent.name).toLowerCase();
+            if (includeExtensions.includes(ext)) {
+                results.push(abs);
+            }
+        }
+    }
+    return results;
+}
+export function toPosixPath(p) {
+    return p.replace(/\\/g, '/');
+}
+//# sourceMappingURL=walk.js.map

package/dist/utils/walk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"walk.js","sourceRoot":"","sources":["../../src/utils/walk.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAQlC,MAAM,oBAAoB,GAAG;IACzB,cAAc;IACd,MAAM;IACN,OAAO;IACP,OAAO;IACP,MAAM;IACN,OAAO;IACP,QAAQ;IACR,QAAQ;IACR,UAAU;CACb,CAAC;AAEF,MAAM,UAAU,SAAS,CAAC,OAAe,EAAE,UAAuB,EAAE;IAChE,MAAM,iBAAiB,GAAG,CAAC,OAAO,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;IACxF,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,CAAC,eAAe,IAAI,oBAAoB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;IACvG,MAAM,QAAQ,GAAG,OAAO,OAAO,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC;IAElF,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,KAAK,GAAa,CAAC,OAAO,CAAC,CAAC;IAElC,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,EAAG,CAAC;QAC7B,IAAI,OAAoB,CAAC;QACzB,IAAI,CAAC;YACD,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/D,CAAC;QAAC,MAAM,CAAC;YACL,SAAS;QACb,CAAC;QAED,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;YACxB,IAAI,OAAO,CAAC,MAAM,IAAI,QAAQ;gBAAE,OAAO,OAAO,CAAC;YAC/C,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;YAEzC,IAAI,GAAG,CAAC,WAAW,EAAE,EAAE,CAAC;gBACpB,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;oBAAE,SAAS;gBAClD,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBAChB,SAAS;YACb,CAAC;YAED,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE;gBAAE,SAAS;YAC5B,IAAI,iBAAiB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACjC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBAClB,SAAS;YACb,CAAC;YAED,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;YACjD,IAAI,iBAAiB,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBAClC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACtB,CAAC;QACL,CAAC;IACL,CAAC;IAED,OAAO,OAAO,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,CAAS;IACjC,OAAO,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AACjC,CAAC"}

package/eslint.config.js

@@ -0,0 +1,37 @@
+import eslint from '@eslint/js';
+import tseslint from '@typescript-eslint/eslint-plugin';
+import tsparser from '@typescript-eslint/parser';
+
+export default [
+    eslint.configs.recommended,
+    {
+        files: ['src/**/*.ts'],
+        languageOptions: {
+            parser: tsparser,
+            parserOptions: {
+                ecmaVersion: 2022,
+                sourceType: 'module',
+            },
+            globals: {
+                console: 'readonly',
+                process: 'readonly',
+                Buffer: 'readonly',
+                __dirname: 'readonly',
+                __filename: 'readonly',
+            },
+        },
+        plugins: {
+            '@typescript-eslint': tseslint,
+        },
+        rules: {
+            ...tseslint.configs.recommended.rules,
+            '@typescript-eslint/no-unused-vars': ['error', { argsIgnorePattern: '^_' }],
+            '@typescript-eslint/explicit-function-return-type': 'off',
+            '@typescript-eslint/no-explicit-any': 'warn',
+            'no-console': 'off',
+        },
+    },
+    {
+        ignores: ['dist/', 'node_modules/', '*.config.js'],
+    },
+];

package/package.json

@@ -0,0 +1,56 @@
+{
+    "name": "@gemini-designer/mcp-server",
+    "version": "0.1.0",
+    "description": "MCP server for AI-powered UI design and code generation with Gemini",
+    "type": "module",
+    "main": "dist/index.js",
+    "bin": {
+        "gemini-designer-mcp": "dist/index.js"
+    },
+    "scripts": {
+        "dev": "tsx watch src/index.ts",
+        "build": "tsc",
+        "start": "node dist/index.js",
+        "test": "vitest",
+        "test:coverage": "vitest --coverage",
+        "lint": "eslint src/",
+        "lint:fix": "eslint src/ --fix",
+        "format": "prettier --write src/",
+        "typecheck": "tsc --noEmit"
+    },
+    "keywords": [
+        "mcp",
+        "model-context-protocol",
+        "gemini",
+        "design-to-code",
+        "ai",
+        "frontend",
+        "ui-generation"
+    ],
+    "author": "",
+    "license": "MIT",
+    "engines": {
+        "node": ">=20.0.0"
+    },
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/yourusername/gemini-designer-mcp"
+    },
+    "homepage": "https://gemini-designer.dev",
+    "dependencies": {
+        "@google/generative-ai": "^0.21.0",
+        "@modelcontextprotocol/sdk": "^1.12.0",
+        "prettier": "^3.4.0",
+        "typescript": "^5.7.0",
+        "zod": "^3.24.0"
+    },
+    "devDependencies": {
+        "@types/node": "^22.10.0",
+        "@typescript-eslint/eslint-plugin": "^8.18.0",
+        "@typescript-eslint/parser": "^8.18.0",
+        "@vitest/coverage-v8": "^2.1.0",
+        "eslint": "^9.16.0",
+        "tsx": "^4.19.0",
+        "vitest": "^2.1.0"
+    }
+}

package/src/__tests__/builder.test.ts

@@ -0,0 +1,31 @@
+/**
+ * Tests for context/builder.ts
+ */
+
+import { describe, it, expect } from 'vitest';
+import { estimateTokens } from '../context/builder.js';
+
+describe('estimateTokens', () => {
+    it('should estimate tokens based on character count', () => {
+        // ~4 chars per token
+        expect(estimateTokens('hello')).toBe(2); // 5 chars → ~2 tokens
+        expect(estimateTokens('')).toBe(0);
+    });
+
+    it('should handle longer text', () => {
+        const text = 'a'.repeat(100);
+        expect(estimateTokens(text)).toBe(25); // 100 chars → 25 tokens
+    });
+
+    it('should round up for partial tokens', () => {
+        const text = 'ab'; // 2 chars → 0.5 → rounds to 1
+        expect(estimateTokens(text)).toBe(1);
+    });
+
+    it('should handle code snippets', () => {
+        const code = 'const Button = () => <button>Click</button>;';
+        const tokens = estimateTokens(code);
+        expect(tokens).toBeGreaterThan(0);
+        expect(tokens).toBe(Math.ceil(code.length / 4));
+    });
+});

package/src/__tests__/config.test.ts

@@ -0,0 +1,52 @@
+/**
+ * Tests for config/index.ts
+ */
+
+import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
+
+describe('Config', () => {
+    const originalEnv = process.env;
+
+    beforeEach(() => {
+        vi.resetModules();
+        process.env = { ...originalEnv };
+    });
+
+    afterEach(() => {
+        process.env = originalEnv;
+    });
+
+    describe('loadConfigFromEnv', () => {
+        it('should load API key from environment', async () => {
+            process.env.GEMINI_API_KEY = 'test-key';
+
+            // Dynamic import to get fresh module
+            const { loadConfig } = await import('../config/index.js');
+
+            // This would throw without the key, so we test it exists
+            expect(process.env.GEMINI_API_KEY).toBe('test-key');
+        });
+
+        it('should respect mode environment variable', () => {
+            process.env.GEMINI_DESIGNER_MODE = 'remote';
+            expect(process.env.GEMINI_DESIGNER_MODE).toBe('remote');
+        });
+
+        it('should respect debug environment variable', () => {
+            process.env.GEMINI_DESIGNER_DEBUG = 'true';
+            expect(process.env.GEMINI_DESIGNER_DEBUG).toBe('true');
+        });
+    });
+
+    describe('Config schema', () => {
+        it('should have correct default framework', () => {
+            // The default is 'react' in the schema
+            expect(true).toBe(true); // Placeholder for schema validation
+        });
+
+        it('should have correct default accessibility', () => {
+            // The default is 'wcag-aa' in the schema
+            expect(true).toBe(true); // Placeholder for schema validation
+        });
+    });
+});

package/src/__tests__/filter.test.ts

@@ -0,0 +1,109 @@
+/**
+ * Tests for context/filter.ts
+ */
+
+import { describe, it, expect } from 'vitest';
+import { isSensitiveFile, isPathAllowed, isUIRelevant, sanitizeContent } from '../context/filter.js';
+
+describe('isSensitiveFile', () => {
+    it('should flag .env files as sensitive', () => {
+        expect(isSensitiveFile('.env')).toBe(true);
+        expect(isSensitiveFile('.env.local')).toBe(true);
+        expect(isSensitiveFile('/path/to/.env.production')).toBe(true);
+    });
+
+    it('should flag secret files as sensitive', () => {
+        expect(isSensitiveFile('secrets.json')).toBe(true);
+        expect(isSensitiveFile('/config/secrets.yaml')).toBe(true);
+    });
+
+    it('should flag private keys as sensitive', () => {
+        expect(isSensitiveFile('server.key')).toBe(true);
+        expect(isSensitiveFile('certificate.pem')).toBe(true);
+        expect(isSensitiveFile('id_rsa')).toBe(true);
+    });
+
+    it('should flag backend directories as sensitive', () => {
+        expect(isSensitiveFile('/src/api/routes.ts')).toBe(true);
+        expect(isSensitiveFile('/server/index.ts')).toBe(true);
+        expect(isSensitiveFile('/backend/handlers.ts')).toBe(true);
+    });
+
+    it('should not flag UI files as sensitive', () => {
+        expect(isSensitiveFile('Button.tsx')).toBe(false);
+        expect(isSensitiveFile('/components/Card.tsx')).toBe(false);
+        expect(isSensitiveFile('styles.css')).toBe(false);
+    });
+});
+
+describe('isPathAllowed', () => {
+    it('should allow paths within allowed directories', () => {
+        expect(isPathAllowed('/project/src/file.ts', ['/project'])).toBe(true);
+        expect(isPathAllowed('/project/components/Button.tsx', ['/project'])).toBe(true);
+    });
+
+    it('should reject paths outside allowed directories', () => {
+        expect(isPathAllowed('/etc/passwd', ['/project'])).toBe(false);
+        expect(isPathAllowed('/home/user/secrets', ['/project'])).toBe(false);
+    });
+
+    it('should support multiple allowed paths', () => {
+        const allowed = ['/project', '/shared'];
+        expect(isPathAllowed('/project/file.ts', allowed)).toBe(true);
+        expect(isPathAllowed('/shared/utils.ts', allowed)).toBe(true);
+        expect(isPathAllowed('/other/file.ts', allowed)).toBe(false);
+    });
+});
+
+describe('isUIRelevant', () => {
+    it('should identify CSS files as UI relevant', () => {
+        expect(isUIRelevant('styles.css')).toBe(true);
+        expect(isUIRelevant('theme.scss')).toBe(true);
+        expect(isUIRelevant('variables.less')).toBe(true);
+    });
+
+    it('should identify component files as UI relevant', () => {
+        expect(isUIRelevant('Button.tsx')).toBe(true);
+        expect(isUIRelevant('Card.jsx')).toBe(true);
+        expect(isUIRelevant('Header.vue')).toBe(true);
+        expect(isUIRelevant('Nav.svelte')).toBe(true);
+    });
+
+    it('should identify design token files as UI relevant', () => {
+        expect(isUIRelevant('tokens.json')).toBe(true);
+        expect(isUIRelevant('design-tokens.ts')).toBe(true);
+        expect(isUIRelevant('theme.ts')).toBe(true);
+    });
+
+    it('should not identify backend files as UI relevant', () => {
+        expect(isUIRelevant('database.ts')).toBe(false);
+        expect(isUIRelevant('server.ts')).toBe(false);
+    });
+});
+
+describe('sanitizeContent', () => {
+    it('should redact API key patterns', () => {
+        const content = 'const apiKey = "sk-abc123xyz";';
+        expect(sanitizeContent(content)).toContain('[REDACTED]');
+    });
+
+    it('should redact Bearer tokens', () => {
+        const content = 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ';
+        expect(sanitizeContent(content)).toContain('[REDACTED]');
+    });
+
+    it('should redact AWS keys', () => {
+        const content = 'aws_access_key = "AKIAIOSFODNN7EXAMPLE"';
+        expect(sanitizeContent(content)).toContain('[REDACTED]');
+    });
+
+    it('should redact database connection strings', () => {
+        const content = 'DATABASE_URL=postgresql://user:password@localhost:5432/db';
+        expect(sanitizeContent(content)).toContain('[REDACTED]');
+    });
+
+    it('should preserve non-sensitive content', () => {
+        const content = 'const Button = () => <button>Click me</button>;';
+        expect(sanitizeContent(content)).toBe(content);
+    });
+});