@auto-engineer/component-implementer 0.10.5 → 0.11.10

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @auto-engineer/frontend-implementer
 
+## 0.11.10
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @auto-engineer/ai-gateway@0.11.10
+  - @auto-engineer/message-bus@0.11.10
+
 ## 0.10.5
 
 ### Patch Changes

package/dist/src/agent-cli.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env tsx
-import { runAIAgent } from './agent';
+import { runAIAgent } from './agent.js';
 const [, , projectDir, iaSchemeDir, designSystemPath] = process.argv;
 if (!projectDir) {
     console.error('Usage: agent-cli <project-directory> <ia-scheme-directory>');

package/dist/src/agent.d.ts

@@ -1,7 +1,7 @@
 export declare function callAI(prompt: string, options?: {
     temperature?: number;
     maxTokens?: number;
-}): Promise<any>;
+}): Promise<string>;
 interface Scheme {
     generatedComponents?: {
         type: string;

package/dist/src/agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/agent.ts"],"names":[],"mappings":"AAqHA,wBAAsB,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,gBAOlG;AAGD,UAAU,MAAM;IACd,mBAAmB,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,EAAE,CAAC;IAC1E,KAAK,CAAC,EAAE;QACN,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACjC,CAAC;IACF,SAAS,CAAC,EAAE;QACV,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACjC,CAAC;IACF,SAAS,CAAC,EAAE;QACV,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACjC,CAAC;IACF,KAAK,CAAC,EAAE;QACN,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,KAAK,CAAC,EAAE,MAAM,CACZ,MAAM,EACN;YACE,KAAK,EAAE,MAAM,CAAC;YACd,WAAW,EAAE,MAAM,CAAC;YACpB,MAAM,CAAC,EAAE,OAAO,CAAC;YACjB,UAAU,CAAC,EAAE,OAAO,CAAC;YACrB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;SACxB,CACF,CAAC;KACH,CAAC;CACH;AAED,UAAU,cAAc;IACtB,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,EAAE,CAAA;KAAE,EAAE,CAAC;IACnE,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAGD,wBAAsB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAuBjF;AA0ED,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,eAAe,EAAE,MAAM,EACvB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,EAAE,GACjB,OAAO,CAAC,cAAc,CAAC,CAiCzB;AA+gBD,wBAAsB,UAAU,CAC9B,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,gBAAgB,EAAE,MAAM,EACxB,QAAQ,EAAE,MAAM,EAAE,iBA2CnB"}
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/agent.ts"],"names":[],"mappings":"AAqHA,wBAAsB,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,mBAOlG;AAGD,UAAU,MAAM;IACd,mBAAmB,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,EAAE,CAAC;IAC1E,KAAK,CAAC,EAAE;QACN,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACjC,CAAC;IACF,SAAS,CAAC,EAAE;QACV,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACjC,CAAC;IACF,SAAS,CAAC,EAAE;QACV,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACjC,CAAC;IACF,KAAK,CAAC,EAAE;QACN,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,KAAK,CAAC,EAAE,MAAM,CACZ,MAAM,EACN;YACE,KAAK,EAAE,MAAM,CAAC;YACd,WAAW,EAAE,MAAM,CAAC;YACpB,MAAM,CAAC,EAAE,OAAO,CAAC;YACjB,UAAU,CAAC,EAAE,OAAO,CAAC;YACrB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;SACxB,CACF,CAAC;KACH,CAAC;CACH;AAED,UAAU,cAAc;IACtB,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,EAAE,CAAA;KAAE,EAAE,CAAC;IACnE,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAGD,wBAAsB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAuBjF;AA0ED,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,eAAe,EAAE,MAAM,EACvB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,EAAE,GACjB,OAAO,CAAC,cAAc,CAAC,CAiCzB;AA+gBD,wBAAsB,UAAU,CAC9B,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,gBAAgB,EAAE,MAAM,EACxB,QAAQ,EAAE,MAAM,EAAE,iBA2CnB"}

package/dist/src/commands/implement-component.d.ts

@@ -4,6 +4,7 @@ export type ImplementComponentCommand = Command<'ImplementComponent', {
     iaSchemeDir: string;
     designSystemPath: string;
     componentType: 'atom' | 'molecule' | 'organism' | 'page';
+    filePath: string;
     componentName: string;
     failures?: string[];
 }>;
@@ -18,7 +19,21 @@ export type ComponentImplementationFailedEvent = Event<'ComponentImplementationF
     error: string;
     componentType: string;
     componentName: string;
+    filePath: string;
 }>;
-export declare const commandHandler: any;
-export default commandHandler;
+export declare const commandHandler: import("@auto-engineer/message-bus").UnifiedCommandHandler<Readonly<{
+    type: "ImplementComponent";
+    data: Readonly<{
+        projectDir: string;
+        iaSchemeDir: string;
+        designSystemPath: string;
+        componentType: "atom" | "molecule" | "organism" | "page";
+        filePath: string;
+        componentName: string;
+        failures?: string[];
+    }>;
+    timestamp?: Date;
+    requestId?: string;
+    correlationId?: string;
+}>>;
 //# sourceMappingURL=implement-component.d.ts.map

package/dist/src/commands/implement-component.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"implement-component.d.ts","sourceRoot":"","sources":["../../../src/commands/implement-component.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAwB,KAAK,KAAK,EAAE,MAAM,4BAA4B,CAAC;AAQ5F,MAAM,MAAM,yBAAyB,GAAG,OAAO,CAC7C,oBAAoB,EACpB;IACE,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,MAAM,GAAG,UAAU,GAAG,UAAU,GAAG,MAAM,CAAC;IACzD,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB,CACF,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG,KAAK,CAC3C,sBAAsB,EACtB;IACE,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB,CACF,CAAC;AAEF,MAAM,MAAM,kCAAkC,GAAG,KAAK,CACpD,+BAA+B,EAC/B;IACE,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;CACvB,CACF,CAAC;AAEF,eAAO,MAAM,cAAc,KA2CzB,CAAC;AAoIH,eAAe,cAAc,CAAC"}
+{"version":3,"file":"implement-component.d.ts","sourceRoot":"","sources":["../../../src/commands/implement-component.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,OAAO,EAAwB,KAAK,KAAK,EAAE,MAAM,4BAA4B,CAAC;AAa5F,MAAM,MAAM,yBAAyB,GAAG,OAAO,CAC7C,oBAAoB,EACpB;IACE,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,MAAM,GAAG,UAAU,GAAG,UAAU,GAAG,MAAM,CAAC;IACzD,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB,CACF,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG,KAAK,CAC3C,sBAAsB,EACtB;IACE,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB,CACF,CAAC;AAEF,MAAM,MAAM,kCAAkC,GAAG,KAAK,CACpD,+BAA+B,EAC/B;IACE,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;CAClB,CACF,CAAC;AAEF,eAAO,MAAM,cAAc;;;oBA/BX,MAAM;qBACL,MAAM;0BACD,MAAM;uBACT,MAAM,GAAG,UAAU,GAAG,UAAU,GAAG,MAAM;kBAC9C,MAAM;uBACD,MAAM;mBACV,MAAM,EAAE;;;;;GA6DrB,CAAC"}

package/dist/src/commands/implement-component.js

@@ -1,9 +1,15 @@
+// noinspection ExceptionCaughtLocallyJS
 import { defineCommandHandler } from '@auto-engineer/message-bus';
 import * as fs from 'fs/promises';
 import * as path from 'path';
 import createDebug from 'debug';
-import { callAI, getProjectContext, loadScheme } from '../agent';
-const debug = createDebug('frontend-implementer:implement-component');
+import { callAI, loadScheme } from '../agent.js';
+import { execa } from 'execa';
+import { performance } from 'perf_hooks';
+const debug = createDebug('auto:client-implementer:component');
+const debugTypeCheck = createDebug('auto:client-implementer:component:typecheck');
+const debugProcess = createDebug('auto:client-implementer:component:process');
+const debugResult = createDebug('auto:client-implementer:component:result');
 export const commandHandler = defineCommandHandler({
     name: 'ImplementComponent',
     alias: 'implement:component',
@@ -18,11 +24,9 @@ export const commandHandler = defineCommandHandler({
             description: 'Type of component: atom|molecule|organism|page',
             required: true,
         },
+        filePath: { description: 'Component file path', required: true },
         componentName: { description: 'Name of component to implement', required: true },
-        failures: {
-            description: 'Any failures from previous implementations',
-            required: false,
-        },
+        failures: { description: 'Any failures from previous implementations', required: false },
     },
     examples: [
         '$ auto implement:component --project-dir=./client --ia-scheme-dir=./.context --design-system-path=./design-system.md --component-type=molecule --component-name=SurveyCard',
@@ -31,63 +35,107 @@ export const commandHandler = defineCommandHandler({
     handle: async (command) => {
         const result = await handleImplementComponentCommandInternal(command);
         if (result.type === 'ComponentImplemented') {
-            debug('Component implemented: %s/%s at %s', result.data.componentType, result.data.componentName, result.data.filePath);
+            debug('Component implemented successfully: %s/%s', result.data.componentType, result.data.componentName);
         }
         else {
-            debug('Failed: %s', result.data.error);
+            debug('Component implementation failed: %s', result.data.error);
         }
         return result;
     },
 });
+// eslint-disable-next-line complexity
 async function handleImplementComponentCommandInternal(command) {
-    const { projectDir, iaSchemeDir, designSystemPath, componentType, componentName, failures = [] } = command.data;
+    const { projectDir, iaSchemeDir, designSystemPath, componentType, componentName, filePath } = command.data;
     try {
-        const userPreferencesFile = path.resolve(projectDir, 'design-system-principles.md');
-        const [userPreferences, designSystem] = await Promise.all([
-            fs.readFile(userPreferencesFile, 'utf-8'),
-            fs.readFile(designSystemPath, 'utf-8'),
-        ]);
+        const start = performance.now();
+        debugProcess(`Starting ${componentType}:${componentName}`);
+        const t1 = performance.now();
         const scheme = await loadScheme(iaSchemeDir);
-        if (!scheme) {
+        debugProcess(`[1] Loaded IA scheme in ${(performance.now() - t1).toFixed(2)} ms`);
+        if (!scheme)
             throw new Error('IA scheme not found');
-        }
         const pluralKey = `${componentType}s`;
         const collection = scheme[pluralKey];
-        if (!isValidCollection(collection)) {
+        if (!isValidCollection(collection))
             throw new Error(`Invalid IA schema structure for ${pluralKey}`);
-        }
         const items = collection.items;
         const componentDef = items[componentName];
-        if (!componentDef) {
+        if (!componentDef)
             throw new Error(`Component ${componentType}:${componentName} not found in IA schema`);
+        const outPath = path.join(projectDir, '..', filePath);
+        const t2 = performance.now();
+        let existingScaffold = '';
+        try {
+            existingScaffold = await fs.readFile(outPath, 'utf-8');
+            debugProcess(`[2] Found existing scaffold in ${(performance.now() - t2).toFixed(2)} ms`);
         }
-        const ctx = await getProjectContext(projectDir, iaSchemeDir, userPreferences, designSystem, failures);
-        const prompt = makeComponentPrompt(ctx, componentType, componentName, componentDef);
-        const code = await callAI(prompt);
-        const outPath = path.join(projectDir, 'src/components', `${componentType}s`, `${componentName}.tsx`);
+        catch {
+            debugProcess(`[2] No existing scaffold found (${(performance.now() - t2).toFixed(2)} ms)`);
+        }
+        const t3 = performance.now();
+        const projectConfig = await readAllTopLevelFiles(projectDir);
+        debugProcess(`[3] Loaded project + gql/graphql files in ${(performance.now() - t3).toFixed(2)} ms`);
+        const t4 = performance.now();
+        const designSystemReference = await readDesignSystem(designSystemPath, { projectDir, iaSchemeDir });
+        debugProcess(`[4] Loaded design system reference in ${(performance.now() - t4).toFixed(2)} ms`);
+        const dependencyList = await resolveDependenciesRecursively(scheme, componentType, componentName);
+        debugProcess(`[5] Resolved ${dependencyList.length} dependencies for ${componentName}`);
+        const dependencySources = {};
+        for (const dep of dependencyList) {
+            const depSource = await readComponentSource(projectDir, dep.type, dep.name);
+            if (depSource != null)
+                dependencySources[`${dep.type}/${dep.name}`] = depSource;
+        }
+        const basePrompt = makeBasePrompt(componentType, componentName, componentDef, existingScaffold, projectConfig, designSystemReference, dependencySources);
         await fs.mkdir(path.dirname(outPath), { recursive: true });
-        await fs.writeFile(outPath, code, 'utf-8');
-        return {
-            type: 'ComponentImplemented',
-            data: {
-                filePath: outPath,
-                componentType,
-                componentName,
-                composition: extractComposition(componentDef),
-                specs: extractSpecs(componentDef),
-            },
-            timestamp: new Date(),
-            requestId: command.requestId,
-            correlationId: command.correlationId,
-        };
+        let attempt = 1;
+        let code = '';
+        let lastErrors = '';
+        const maxAttempts = 3;
+        while (attempt <= maxAttempts) {
+            const genStart = performance.now();
+            const prompt = attempt === 1
+                ? makeImplementPrompt(basePrompt)
+                : makeRetryPrompt(basePrompt, componentType, componentName, code, lastErrors);
+            const aiRaw = await callAI(prompt);
+            code = extractCodeBlock(aiRaw);
+            await fs.writeFile(outPath, code, 'utf-8');
+            debugProcess(`[6.${attempt}] AI output written (${code.length} chars) in ${(performance.now() - genStart).toFixed(2)} ms`);
+            const checkStart = performance.now();
+            const { success, errors } = await runTypeCheckForFile(projectDir, outPath);
+            debugTypeCheck(`[7.${attempt}] Type check in ${(performance.now() - checkStart).toFixed(2)} ms (success: ${success})`);
+            if (success) {
+                debugResult(`[✓] Implementation succeeded in ${(performance.now() - start).toFixed(2)} ms total`);
+                return {
+                    type: 'ComponentImplemented',
+                    data: {
+                        filePath: outPath,
+                        componentType,
+                        componentName,
+                        composition: extractComposition(componentDef),
+                        specs: extractSpecs(componentDef),
+                    },
+                    timestamp: new Date(),
+                    requestId: command.requestId,
+                    correlationId: command.correlationId,
+                };
+            }
+            lastErrors = errors;
+            if (attempt === maxAttempts)
+                throw new Error(`Type errors persist after ${attempt} attempts:\n${errors}`);
+            attempt += 1;
+        }
+        throw new Error('Unreachable state');
     }
     catch (error) {
+        debug('[Error] Component implementation failed: %O', error);
         return {
             type: 'ComponentImplementationFailed',
             data: {
                 error: error instanceof Error ? error.message : String(error),
                 componentType,
                 componentName,
+                filePath,
             },
             timestamp: new Date(),
             requestId: command.requestId,
@@ -95,46 +143,319 @@ async function handleImplementComponentCommandInternal(command) {
         };
     }
 }
-function extractComposition(componentDef) {
-    if ('composition' in componentDef && Boolean(componentDef.composition)) {
-        const comp = componentDef.composition;
-        if ('atoms' in comp && Array.isArray(comp.atoms)) {
-            return comp.atoms;
+// eslint-disable-next-line complexity
+async function resolveDependenciesRecursively(scheme, type, name, visited = new Set()) {
+    const key = `${type}:${name}`;
+    if (visited.has(key))
+        return [];
+    visited.add(key);
+    const collection = scheme[`${type}s`];
+    //
+    // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions
+    if (!collection || !isValidCollection(collection))
+        return [];
+    const def = collection.items[name];
+    // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions
+    if (!def || typeof def !== 'object' || !('composition' in def))
+        return [];
+    const result = [];
+    const composition = def.composition;
+    for (const [subType, subNames] of Object.entries(composition)) {
+        if (!Array.isArray(subNames))
+            continue;
+        for (const subName of subNames) {
+            result.push({ type: subType, name: subName });
+            const nested = await resolveDependenciesRecursively(scheme, subType, subName, visited);
+            result.push(...nested);
         }
-        if ('molecules' in comp && Array.isArray(comp.molecules)) {
-            return comp.molecules;
+    }
+    return result;
+}
+async function readComponentSource(projectDir, type, name) {
+    const file = path.join(projectDir, 'src', 'components', type, `${name}.tsx`);
+    try {
+        return await fs.readFile(file, 'utf-8');
+    }
+    catch {
+        return null;
+    }
+}
+function extractCodeBlock(text) {
+    return text
+        .replace(/```(?:tsx|ts|typescript)?/g, '')
+        .replace(/```/g, '')
+        .trim();
+}
+async function readAllTopLevelFiles(projectDir) {
+    debugProcess('[readAllTopLevelFiles] Reading project files from %s', projectDir);
+    const start = performance.now();
+    const config = {};
+    async function readRecursive(currentDir) {
+        const entries = await fs.readdir(currentDir, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = path.join(currentDir, entry.name);
+            const relativePath = path.relative(projectDir, fullPath);
+            if (entry.isDirectory()) {
+                if (['node_modules', 'dist', 'build', '.next', '.turbo'].includes(entry.name))
+                    continue;
+                await readRecursive(fullPath);
+            }
+            else if (entry.isFile() && (entry.name.endsWith('.ts') || entry.name.endsWith('.tsx'))) {
+                try {
+                    config[relativePath] = await fs.readFile(fullPath, 'utf-8');
+                }
+                catch (err) {
+                    debugProcess(`Failed to read ${relativePath}: ${err.message}`);
+                }
+            }
         }
     }
-    return [];
+    await readRecursive(projectDir);
+    debugProcess(`[readAllTopLevelFiles] Completed in ${(performance.now() - start).toFixed(2)} ms`);
+    return config;
 }
-function extractSpecs(componentDef) {
-    if ('specs' in componentDef && Array.isArray(componentDef.specs)) {
-        return componentDef.specs;
+async function runTypeCheckForFile(projectDir, filePath) {
+    const start = performance.now();
+    try {
+        const tsconfigRoot = await findProjectRoot(projectDir);
+        const relativeFilePath = path.relative(tsconfigRoot, filePath).replace(/\\/g, '/');
+        const normalizedRelative = relativeFilePath.replace(/^client\//, '');
+        const result = await execa('npx', ['tsc', '--noEmit', '--skipLibCheck', '--pretty', 'false'], {
+            cwd: tsconfigRoot,
+            stdio: 'pipe',
+            reject: false,
+        });
+        const output = (result.stdout ?? '') + (result.stderr ?? '');
+        debugTypeCheck(`[runTypeCheckForFile] Finished tsc in ${(performance.now() - start).toFixed(2)} ms`);
+        if (result.exitCode === 0 && !output.includes('error TS'))
+            return { success: true, errors: '' };
+        const filteredErrors = output
+            .split('\n')
+            .filter((line) => {
+            const hasError = line.includes('error TS');
+            const notNodeModules = !line.includes('node_modules');
+            const matchesTarget = line.includes(relativeFilePath) ||
+                line.includes(normalizedRelative) ||
+                line.includes(path.basename(filePath));
+            return hasError && notNodeModules && matchesTarget;
+        })
+            .join('\n');
+        if (filteredErrors.trim().length === 0)
+            return { success: true, errors: '' };
+        return { success: false, errors: filteredErrors };
     }
-    return [];
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { success: false, errors: message };
+    }
+}
+async function findProjectRoot(startDir) {
+    let dir = startDir;
+    while (dir !== path.dirname(dir)) {
+        try {
+            await fs.access(path.join(dir, 'package.json'));
+            await fs.access(path.join(dir, 'tsconfig.json'));
+            return dir;
+        }
+        catch {
+            dir = path.dirname(dir);
+        }
+    }
+    throw new Error('Could not find project root (no package.json or tsconfig.json found)');
 }
-function makeComponentPrompt(ctx, componentType, componentName, componentDef) {
+// eslint-disable-next-line complexity
+function makeBasePrompt(componentType, componentName, componentDef, existingScaffold, projectConfig, designSystemReference, dependencySources) {
+    const hasScaffold = Boolean(existingScaffold?.trim());
+    const gqlFiles = {};
+    const graphqlFiles = {};
+    const otherFiles = {};
+    for (const [filePath, content] of Object.entries(projectConfig)) {
+        const lower = filePath.toLowerCase();
+        if (lower.includes('src/gql/'))
+            gqlFiles[filePath] = content;
+        else if (lower.includes('src/graphql/'))
+            graphqlFiles[filePath] = content;
+        else
+            otherFiles[filePath] = content;
+    }
+    const queriesFile = Object.entries(graphqlFiles).find(([n]) => n.endsWith('queries.ts'))?.[1] ?? '';
+    const mutationsFile = Object.entries(graphqlFiles).find(([n]) => n.endsWith('mutations.ts'))?.[1] ?? '';
+    const gqlSection = Object.entries(gqlFiles)
+        .map(([p, c]) => `### ${p}\n${c}`)
+        .join('\n\n') || '(No gql folder found)';
+    const graphqlSection = Object.entries(graphqlFiles)
+        .map(([p, c]) => `### ${p}\n${c}`)
+        .join('\n\n') || '(No graphql folder found)';
+    const configSection = Object.entries(otherFiles)
+        .map(([p, c]) => `### ${p}\n${c}`)
+        .join('\n\n') || '(No additional config files)';
+    const designSystemBlock = designSystemReference.trim()
+        ? designSystemReference
+        : '(No design system content provided)';
+    const dependencySection = Object.entries(dependencySources)
+        .map(([name, src]) => `### ${name}\n${src}`)
+        .join('\n\n') || '(No dependencies found)';
     return `
-You are Auto, a masterful frontend engineer.
-Implement the following ${componentType}: **${componentName}** from the IA schema.
+# Implementation Brief: ${componentName} (${componentType})
+
+You are a senior frontend engineer specializing in **React + TypeScript + Apollo Client**.  
+Your task is to build a visually excellent, type-safe, and production-ready ${componentType} component.  
+The goal is to deliver elegant, minimal, and robust code that integrates perfectly with the existing system.
+
+---
 
-Component Definition:
+## Objective
+Implement **${componentName}** as defined in the IA schema and design system.  
+Your component must:
+- Compile cleanly with no TypeScript errors.
+- Follow established design tokens, colors, and spacing.
+- Be visually polished, responsive, and accessible.
+- Reuse existing atoms/molecules/organisms wherever possible.
+- Use valid imports only — no new dependencies or mock data.
+
+---
+
+## Project Context
+
+**File Path:** src/components/${componentType}/${componentName}.tsx  
+**Purpose:** A reusable UI element connected to the GraphQL layer and design system.  
+
+### IA Schema
 ${JSON.stringify(componentDef, null, 2)}
 
-Project Snapshot:
-${JSON.stringify(ctx.fileTreeSummary, null, 2)}
+### Existing Scaffold
+${hasScaffold ? existingScaffold : '(No existing scaffold found)'}
+
+### Design System Reference
+${designSystemBlock}
 
-Available Atoms:
-${JSON.stringify(ctx.atoms, null, 2)}
+### Related Components (Dependencies)
+${dependencySection}
 
-GraphQL Operations:
-${Object.keys(ctx.graphqlOperations).join(', ')}
+### GraphQL Context (src/graphql)
+${graphqlSection}
 
-Theme:
-${ctx.theme}
+#### queries.ts
+${queriesFile || '(queries.ts not found)'}
 
-Output: ONLY the full TypeScript React component code (no markdown, no explanations).
-  `;
+#### mutations.ts
+${mutationsFile || '(mutations.ts not found)'}
+
+### GraphQL Codegen (src/gql)
+${gqlSection}
+
+### Other Relevant Files
+${configSection}
+
+---
+
+## Engineering Guidelines
+
+**Type Safety**
+- Explicitly type all props, state, and GraphQL responses.
+- Avoid \`any\` — prefer discriminated unions, interfaces, and generics.
+
+**React Practices**
+- Never call setState during render.
+- Always use dependency arrays in effects.
+- Memoize computed values and callbacks.
+- Keep rendering pure and predictable.
+
+**Error Handling**
+- Wrap async operations in try/catch with graceful fallback UI.
+- Check for null/undefined using optional chaining (?.) and defaults (??).
+
+**Visual & UX Quality**
+- Perfect spacing and alignment using Tailwind or the design system tokens.
+- Add subtle hover, focus, and loading states.
+- Use accessible HTML semantics and ARIA attributes.
+- Animate with Framer Motion when appropriate.
+
+**Performance**
+- Prevent unnecessary re-renders with React.memo and stable references.
+- Avoid redundant state and computations.
+
+**Consistency**
+- Follow established color, typography, and spacing scales.
+- Match button, card, and badge styles with existing components.
+
+**Prohibited**
+- No placeholder data, TODOs, or pseudo-logic.
+- No new external packages.
+- No commented-out or partial implementations.
+
+---
+
+## Visual Quality Checklist
+- Consistent vertical rhythm and alignment.  
+- Smooth hover and transition states.  
+- Responsive design that looks intentional at all breakpoints.  
+- Uses design tokens and existing components wherever possible.  
+- Clear visual hierarchy and accessible structure.
+
+---
+
+## Validation Checklist
+- Compiles cleanly with \`tsc --noEmit\`.  
+- Imports exist and resolve correctly.  
+- Component matches the design system and IA schema.  
+- No unused props, variables, or imports.  
+- Visually and functionally complete.
+
+---
+
+**Final Output Requirement:**  
+Return only the complete \`.tsx\` source code for this component — no markdown fences, commentary, or extra text.
+`.trim();
+}
+function makeImplementPrompt(basePrompt) {
+    return `${basePrompt}
+
+---
+
+Generate the **complete final implementation** for \`${basePrompt}\`.  
+Begin directly with import statements and end with the export statement.  
+Do not include markdown fences, comments, or explanations — only the valid .tsx file content.
+`.trim();
+}
+function makeRetryPrompt(basePrompt, componentType, componentName, previousCode, previousErrors) {
+    return `
+${basePrompt}
+
+---
+
+### Correction Task
+The previously generated ${componentType} component **${componentName}** failed TypeScript validation.  
+Fix only the issues listed below without altering logic or layout.
+
+**Errors**
+${previousErrors}
+
+**Previous Code**
+${previousCode}
+
+---
+
+### Correction Rules
+- Fix only TypeScript or import errors.  
+- Do not change working logic or structure.  
+- Keep eslint directives and formatting intact.  
+- Return the corrected \`.tsx\` file only, with no markdown fences or commentary.
+`.trim();
+}
+/* -------------------------------------------------------------------------- */
+function extractComposition(componentDef) {
+    if ('composition' in componentDef && Boolean(componentDef.composition)) {
+        const comp = componentDef.composition;
+        if ('atoms' in comp && Array.isArray(comp.atoms))
+            return comp.atoms;
+        if ('molecules' in comp && Array.isArray(comp.molecules))
+            return comp.molecules;
+    }
+    return [];
+}
+function extractSpecs(componentDef) {
+    return Array.isArray(componentDef.specs) ? componentDef.specs : [];
 }
 function isValidCollection(collection) {
     if (collection === null || collection === undefined)
@@ -146,5 +467,27 @@ function isValidCollection(collection) {
     const items = collection.items;
     return typeof items === 'object' && items !== null;
 }
-export default commandHandler;
+async function readDesignSystem(providedPath, refs) {
+    const start = performance.now();
+    const candidates = [];
+    if (providedPath) {
+        candidates.push(providedPath);
+        if (!path.isAbsolute(providedPath)) {
+            candidates.push(path.resolve(refs.projectDir, providedPath));
+            candidates.push(path.resolve(refs.iaSchemeDir, providedPath));
+        }
+    }
+    for (const candidate of candidates) {
+        try {
+            const content = await fs.readFile(candidate, 'utf-8');
+            debugProcess(`[readDesignSystem] Loaded from ${candidate} in ${(performance.now() - start).toFixed(2)} ms`);
+            return content;
+        }
+        catch {
+            debugProcess(`[readDesignSystem] Could not read design system from %s`, candidate);
+        }
+    }
+    debugProcess(`[readDesignSystem] Design system not found, elapsed ${(performance.now() - start).toFixed(2)} ms`);
+    return '';
+}
 //# sourceMappingURL=implement-component.js.map