pixelcrew 0.2.3 → 0.2.6

package/src/orchestrator/planner.js

@@ -1,12 +1,18 @@
 /**
- * PIXEL CREW — Dynamic Project Planner & Task Graph Engine
+ * PIXEL CREW — Dynamic Prompt-Driven Project Planner & Task Graph Engine
  * 
- * Analyzes user prompts from first principles and creates:
- * 1. Deep Project Specification (Domain, Components, Features, Data Models)
- * 2. Dynamic Task Graph (DAG) with explicit dependency resolution
+ * Decomposes arbitrary user prompts from first principles into:
+ * 1. Semantic AST (Domain, Actors, Entities, Views, Operations, Interactive Workflows)
+ * 2. Requirement Contract (REQ-001..N with verifiable acceptance criteria)
+ * 3. Bespoke Design Specification (DesignEngine)
+ * 4. Dynamic Task Graph (DAG) with specialized agent role allocation
  */
 
 import { SkillRegistry } from './skills-registry.js';
+import { SemanticEngine } from './semantic-engine.js';
+import { RequirementContract } from './requirement-contract.js';
+import { DesignEngine } from './design-engine.js';
+import { TaskPlanner } from './task-planner.js';
 
 export class DynamicPlanner {
   constructor() {
@@ -14,316 +20,283 @@ export class DynamicPlanner {
   }
 
   /**
-   * Step 1: Analyze Requirements from User Prompt
+   * Step 1: Semantic Requirement Analysis from User Prompt
    */
   analyzeRequirements(prompt, options = {}) {
-    const p = (prompt || '').toLowerCase();
+    const rawPrompt = (prompt || '').trim();
+    const p = rawPrompt.toLowerCase();
 
-    // 1. Target Framework & Stack
+    // 1. Target Framework & Runtime Stack
     let framework = options.targetFramework || 'nextjs';
     if (p.includes('react') && !p.includes('next')) framework = 'react';
     else if (p.includes('vue')) framework = 'vue';
     else if (p.includes('vanilla')) framework = 'vanilla';
 
-    // 2. Domain Classification
-    let domain = 'custom';
-    if (p.includes('portfolio') || p.includes('resume') || p.includes('showcase my project') || p.includes('developer portfolio') || p.includes('personal site')) {
-      domain = 'portfolio';
-    } else if (p.includes('restaurant') || p.includes('culinary') || p.includes('dining') || p.includes('cafe') || p.includes('bistro') || p.includes('menu')) {
-      domain = 'restaurant';
-    } else if (p.includes('ecommerce') || p.includes('shop') || p.includes('store') || p.includes('product store') || p.includes('clothing')) {
-      domain = 'ecommerce';
-    } else if (p.includes('saas') || p.includes('platform') || p.includes('subscription') || p.includes('analytics') || p.includes('pricing calculator')) {
-      domain = 'saas';
-    } else if (p.includes('agency') || p.includes('studio') || p.includes('creative lab') || p.includes('design agency')) {
-      domain = 'agency';
-    } else if (p.includes('database') || p.includes('infra') || p.includes('developer tool') || p.includes('query') || p.includes('api engine')) {
-      domain = 'devtool';
-    }
+    // 2. Parse into full Semantic Project AST
+    const ast = SemanticEngine.parsePromptToAST(rawPrompt);
 
-    // 3. Motion & Animation Intent
-    const hasAnimations = p.includes('animation') || p.includes('motion') || p.includes('interactive') || p.includes('kinetic') || true;
-    
-    // 4. Extract Entity / Project Name
-    let projectName = "Bespoke System";
-    let companyName = "Studio Artisan";
-    let roleOrSubtitle = "Modern Digital Platform";
-    let summary = "Engineered with intentional restraint and zero generic AI slop.";
+    // 3. Create verifiable Requirement Contract
+    const contract = new RequirementContract(ast);
 
-    if (domain === 'portfolio') {
-      projectName = "Modern Developer Portfolio";
-      companyName = "Alex Rivera";
-      roleOrSubtitle = "Staff Systems Architect & Creative Technologist";
-      summary = "Designing high-order distributed architectures, sub-millisecond query engines, and kinetic human-grade web interfaces.";
-    } else if (domain === 'restaurant') {
-      projectName = "Artisan Culinary Studio";
-      companyName = "AURELIA";
-      roleOrSubtitle = "Modern Botanical Gastronomy & Tasting Lab";
-      summary = "Hyper-seasonal tasting menus driven by foraging, fermentation, and architectural plating.";
-    } else if (domain === 'ecommerce') {
-      projectName = "Minimalist Object Store";
-      companyName = "MONOLITH GOODS";
-      roleOrSubtitle = "Precision-Crafted Hardware & Studio Tools";
-      summary = "Industrial-grade design artifacts engineered for creators, architects, and minimalists.";
-    } else if (domain === 'saas' || domain === 'devtool') {
-      projectName = "High-Performance Data Infrastructure";
-      companyName = "VectorScale";
-      roleOrSubtitle = "Real-Time Telemetry & Vector Query Engine";
-      summary = "Sub-millisecond latency query routing and deterministic state coordination for autonomous AI swarms.";
-    } else if (domain === 'agency') {
-      projectName = "Kinetic Creative Studio";
-      companyName = "KITE CREATIVE";
-      roleOrSubtitle = "Design Engineering & Spatial Digital Systems";
-      summary = "We partner with visionary founders to build category-defining digital flagships and interactive products.";
-    }
+    // 4. Synthesize bespoke DesignSpec
+    const designSpec = DesignEngine.synthesizeDesignSpec(ast, rawPrompt);
+
+    // 5. Motion & Animation Intent
+    const hasAnimations = true;
+
+    // 6. Requested Interactive Features
+    const requestedFeatures = this.extractRequestedFeatures(p, ast);
 
     return {
-      prompt,
-      domain,
+      prompt: rawPrompt,
+      domain: ast.domain,
       framework,
       hasAnimations,
-      projectName,
-      companyName,
-      roleOrSubtitle,
-      summary,
-      requestedFeatures: this.extractRequestedFeatures(p, domain)
+      projectName: ast.appName,
+      companyName: ast.appName,
+      roleOrSubtitle: ast.headline,
+      summary: ast.summary,
+      ast,
+      contract,
+      designSpec,
+      entities: ast.entities,
+      views: ast.views,
+      operations: ast.operations,
+      requirements: ast.requirements,
+      metrics: this.synthesizeDynamicMetrics(ast.appName, p),
+      actions: this.synthesizeDynamicActions(p),
+      aestheticMood: 'bespoke',
+      palette: designSpec.color || ast.palette,
+      fonts: designSpec.typography || ast.fonts,
+      requestedFeatures
     };
   }
 
   /**
-   * Helper: Extracts requested interactive feature modules
+   * Helper: Extracts requested interactive features
    */
-  extractRequestedFeatures(promptLower, domain) {
+  extractRequestedFeatures(p, ast) {
     const features = [];
-
-    if (domain === 'portfolio') {
-      features.push('project-filter-matrix', 'interactive-terminal-shell', 'career-timeline', 'contact-modal');
-    } else if (domain === 'restaurant') {
-      features.push('interactive-tasting-menu', 'table-reservation-modal', 'chef-curation-slider', 'hours-location-card');
-    } else if (domain === 'ecommerce') {
-      features.push('product-bento-grid', 'interactive-cart-drawer', 'currency-toggle', 'live-spec-sheet');
-    } else if (domain === 'saas' || domain === 'devtool') {
-      features.push('interactive-latency-calculator', 'code-sandbox-tabs', 'benchmark-comparison-matrix', 'pricing-tier-switcher');
-    } else {
-      features.push('asymmetric-showcase', 'interactive-feature-tabs', 'dynamic-contact-drawer');
+    if (p.includes('saas') || p.includes('dashboard')) {
+      features.push('saas-kpi-dashboard');
     }
-
-    if (promptLower.includes('dark') || promptLower.includes('theme') || promptLower.includes('toggle')) {
-      features.push('theme-toggle');
+    if (p.includes('portfolio') || p.includes('developer') || p.includes('showcase')) {
+      features.push('project-filter-matrix', 'interactive-terminal-shell');
+    }
+    if (p.includes('restaurant') || p.includes('tasting') || p.includes('dining') || p.includes('reservation')) {
+      features.push('interactive-tasting-menu', 'table-reservation-modal');
+    }
+    if (p.includes('login') || p.includes('auth') || p.includes('sign in') || p.includes('account')) {
+      features.push('auth-login-modal', 'jwt-session-management');
+    }
+    if (p.includes('pricing') || p.includes('tier') || p.includes('plan')) {
+      features.push('pricing-tier-switcher');
+    }
+    if (p.includes('search') || p.includes('filter') || p.includes('sort')) {
+      features.push('realtime-filter-search');
+    }
+    if (features.length === 0) {
+      features.push('domain-workspace', 'realtime-filter-search');
     }
-
     return features;
   }
 
   /**
-   * Step 2: Create Unique Project Specification
+   * Helper: Synthesizes dynamic metrics
    */
-  createProjectSpecification(analysis) {
-    const { domain, framework, companyName, roleOrSubtitle, summary, requestedFeatures, hasAnimations } = analysis;
-
-    // 1. Design Tokens & Palette (High-contrast, zero generic AI purple blobs)
-    let palette = {
-      bg: "#090a0f",
-      surface: "#10121a",
-      surfaceRaised: "#181b26",
-      border: "rgba(255, 255, 255, 0.08)",
-      borderHover: "rgba(255, 255, 255, 0.25)",
-      textPrimary: "#f8fafc",
-      textSecondary: "#94a3b8",
-      accent: "#38bdf8",
-      accentGlow: "rgba(56, 189, 248, 0.15)"
-    };
-
-    let fonts = {
-      display: "'Space Grotesk', -apple-system, sans-serif",
-      body: "'Plus Jakarta Sans', -apple-system, sans-serif",
-      mono: "'JetBrains Mono', monospace",
-      googleFontsUrl: "https://fonts.googleapis.com/css2?family=JetBrains+Mono:wght@400;500;700&family=Plus+Jakarta+Sans:wght@300;400;500;600;700&family=Space+Grotesk:wght@500;600;700&display=swap"
-    };
-
-    if (domain === 'restaurant') {
-      palette = {
-        bg: "#0c0b0a",
-        surface: "#141311",
-        surfaceRaised: "#1c1b18",
-        border: "rgba(217, 196, 163, 0.12)",
-        borderHover: "rgba(217, 196, 163, 0.35)",
-        textPrimary: "#f5f2eb",
-        textSecondary: "#a8a29e",
-        accent: "#d4af37",
-        accentGlow: "rgba(212, 175, 55, 0.15)"
-      };
-      fonts = {
-        display: "'Cormorant Garamond', Georgia, serif",
-        body: "'Plus Jakarta Sans', sans-serif",
-        mono: "'JetBrains Mono', monospace",
-        googleFontsUrl: "https://fonts.googleapis.com/css2?family=Cormorant+Garamond:ital,wght@0,400;0,600;1,400&family=Plus+Jakarta+Sans:wght@300;400;500;600&display=swap"
-      };
-    } else if (domain === 'agency' || domain === 'portfolio') {
-      palette = {
-        bg: "#08090c",
-        surface: "#0f1117",
-        surfaceRaised: "#161922",
-        border: "rgba(255, 255, 255, 0.08)",
-        borderHover: "rgba(255, 255, 255, 0.3)",
-        textPrimary: "#ffffff",
-        textSecondary: "#9ca3af",
-        accent: "#10b981",
-        accentGlow: "rgba(16, 185, 129, 0.15)"
-      };
-      fonts = {
-        display: "'Instrument Serif', Georgia, serif",
-        body: "'Inter', -apple-system, sans-serif",
-        mono: "'JetBrains Mono', monospace",
-        googleFontsUrl: "https://fonts.googleapis.com/css2?family=Instrument+Serif:ital@0;1&family=Inter:wght@300;400;500;600;700&family=JetBrains+Mono:wght@400;500;600&display=swap"
-      };
+  synthesizeDynamicMetrics(subject, p) {
+    if (p.includes('orbit') || p.includes('rocket') || p.includes('space') || p.includes('mission')) {
+      return [
+        { label: "Delta-V Budget", value: "3,840 m/s", change: "Optimal Margin", status: "optimal" },
+        { label: "Altitude & Apogee", value: "542.8 km", change: "LEO Synchronous", status: "optimal" },
+        { label: "Inclination Vector", value: "51.64°", change: "Nominal", status: "nominal" },
+        { label: "Telemetry Link", value: "99.98%", change: "Ground Lock", status: "nominal" }
+      ];
+    }
+    if (p.includes('legal') || p.includes('contract') || p.includes('clause') || p.includes('compliance')) {
+      return [
+        { label: "Risk Index", value: "94.2 / 100", change: "Sub-10ms Inference", status: "optimal" },
+        { label: "Compliance Score", value: "99.94%", change: "Strict Benchmark", status: "optimal" },
+        { label: "Clauses Extracted", value: "1,480 / sec", change: "Zero Hallucination", status: "optimal" },
+        { label: "Active Agreements", value: "482 Files", change: "Multi-Jurisdiction", status: "nominal" }
+      ];
+    }
+    if (p.includes('audio') || p.includes('synth') || p.includes('midi') || p.includes('sound')) {
+      return [
+        { label: "DSP Latency", value: "0.18 ms", change: "Zero Buffer Drop", status: "optimal" },
+        { label: "Sample Processing", value: "192 kHz", change: "32-bit Float", status: "optimal" },
+        { label: "Polyphony Voices", value: "64 Active", change: "Real-Time Parallel", status: "optimal" },
+        { label: "Filter Headroom", value: "+18.4 dB", change: "Analog Modeled", status: "nominal" }
+      ];
     }
+    if (p.includes('real estate') || p.includes('property') || p.includes('mortgage') || p.includes('valuation')) {
+      return [
+        { label: "Valuation Comps", value: "12,400 Comps", change: "Real-Time Index", status: "optimal" },
+        { label: "Portfolio AUM", value: "$42.8M", change: "+12.4% Annualized", status: "optimal" },
+        { label: "Average Cap Rate", value: "6.85%", change: "+45 bps vs Index", status: "optimal" },
+        { label: "Confidence Score", value: "99.2%", change: "Hedonic Model", status: "optimal" }
+      ];
+    }
+    return [
+      { label: `${subject} Throughput`, value: "4.2M ops/s", change: "+18.4% p99", status: "optimal" },
+      { label: "Query Latency", value: "0.48 ms", change: "Sub-millisecond", status: "optimal" },
+      { label: "Active Nodes", value: "1,248 Nodes", change: "Multi-Region", status: "nominal" },
+      { label: "Availability SLA", value: "99.999%", change: "Zero Downtime", status: "nominal" }
+    ];
+  }
 
-    // 2. Dynamic Section Topology
-    const sections = this.buildSectionTopology(domain, companyName, roleOrSubtitle, summary, requestedFeatures);
+  /**
+   * Helper: Extracts dynamic user operations / actions
+   */
+  synthesizeDynamicActions(p) {
+    return ['search-and-filter', 'execute-runtime-command', 'inspect-telemetry'];
+  }
 
-    return {
-      projectName: analysis.projectName,
+  /**
+   * Step 2: Create Dynamic Project Specification
+   */
+  createProjectSpecification(analysis) {
+    const {
+      prompt,
       domain,
       framework,
+      projectName,
       companyName,
-      headline: roleOrSubtitle,
+      roleOrSubtitle,
       summary,
-      hasAnimations,
+      ast,
+      contract,
+      designSpec,
+      entities,
+      views,
+      operations,
+      requirements,
+      metrics,
+      actions,
+      aestheticMood,
       palette,
       fonts,
-      requestedFeatures,
+      requestedFeatures
+    } = analysis;
+
+    const sections = this.buildDynamicSectionTopology(ast, requestedFeatures, companyName, projectName, roleOrSubtitle, summary, domain);
+
+    return {
+      appName: companyName || projectName || 'Application',
+      companyName: companyName || projectName || 'Application',
+      projectName: projectName || 'Application',
+      domain: domain || 'software-system',
+      headline: roleOrSubtitle || `Unified Platform for ${projectName}`,
+      summary: summary || 'Engineered with open-world synthesis.',
+      targetFramework: framework,
       sections,
+      palette,
+      fonts,
+      ast,
+      contract,
+      designSpec,
+      entities,
+      views,
+      operations,
+      requirements,
+      metrics,
+      actions,
+      aestheticMood,
+      requestedFeatures,
       apiRoutes: [
-        { path: 'src/app/api/contact/route.ts', purpose: 'Handles inquiries with RFC 7807 validation' },
-        { path: 'src/app/api/data/route.ts', purpose: 'Serves dynamic domain entities & filtering' }
-      ]
+        { path: 'src/app/api/auth/login/route.ts' },
+        { path: 'src/app/api/dashboard/stats/route.ts' },
+        { path: 'src/app/api/contact/route.ts' },
+        { path: 'src/app/api/data/route.ts' }
+      ],
+      rawPrompt: prompt
     };
   }
 
-  /**
-   * Helper: Builds domain-specific section hierarchy
-   */
-  buildSectionTopology(domain, name, headline, summary, features) {
+  buildDynamicSectionTopology(ast, requestedFeatures, companyName, projectName, roleOrSubtitle, summary, domain) {
+    const sections = [
+      {
+        id: "header",
+        componentName: "PortalHeader",
+        role: "Persistent Navigation & Workspace Header",
+        stateful: false
+      }
+    ];
+
     if (domain === 'portfolio') {
-      return [
-        { id: 'navbar', component: 'Navbar', title: name, navLinks: ['Projects', 'Console', 'Timeline', 'Contact'] },
-        { id: 'hero', component: 'Hero', headline: "Architecting high-order distributed systems & kinetic web platforms.", subheadline: summary, primaryCta: "Explore Selected Works", secondaryCta: "Launch Interactive Shell" },
-        { id: 'projects', component: 'ProjectsGrid', title: "Selected Works & Architectures", categories: ["All", "Distributed Systems", "AI & RAG", "Frontend Islands", "Open Source"] },
-        { id: 'terminal', component: 'TerminalBio', title: "Interactive Developer Shell", subtitle: "Type `skills`, `architecture`, `experience`, or `contact`" },
-        { id: 'experience', component: 'ExperienceTimeline', title: "Career & Technical Milestones" },
-        { id: 'contact', component: 'ContactSection', title: "Let's build something exceptional together.", email: "alex@example.com" }
-      ];
+      sections.push(
+        { id: "hero", component: "Hero", componentName: "Hero", role: "Masthead", stateful: false },
+        { id: "projects", component: "ProjectsGrid", componentName: "ProjectsGrid", role: "Projects Showcase", stateful: true }
+      );
     } else if (domain === 'restaurant') {
-      return [
-        { id: 'navbar', component: 'Navbar', title: name, navLinks: ['Tasting Menu', 'Philosophy', 'Private Dining', 'Reservations'] },
-        { id: 'hero', component: 'Hero', headline: "Hyper-seasonal gastronomy rooted in botanical exploration.", subheadline: summary, primaryCta: "Reserve a Table", secondaryCta: "View Seasonal Menu" },
-        { id: 'tasting-menu', component: 'TastingMenu', title: "Autumn Tasting Course", categories: ["All", "First Course", "Main Course", "Dessert", "Wine Pairings"] },
-        { id: 'philosophy', component: 'ChefPhilosophy', title: "From Soil to Plate", quote: "We cook not to impress, but to connect guests with the untamed landscape." },
-        { id: 'reservation', component: 'ReservationSection', title: "Join Us at the Table", cta: "Book Reservation" }
-      ];
+      sections.push(
+        { id: "tasting", component: "TastingMenu", componentName: "TastingMenu", role: "Tasting Menu", stateful: true },
+        { id: "reservation", component: "ReservationSection", componentName: "ReservationSection", role: "Reservation", stateful: true }
+      );
+    } else if (domain === 'saas' || requestedFeatures.includes('saas-kpi-dashboard')) {
+      sections.push(
+        { id: "metrics", component: "DashboardMetrics", componentName: "DashboardMetrics", role: "Metrics & KPIs", stateful: true },
+        { id: "auth", component: "AuthLoginModal", componentName: "AuthLoginModal", role: "Authentication Modal", stateful: true },
+        { id: "pricing", component: "PricingMatrix", componentName: "PricingMatrix", role: "Pricing Matrix", stateful: true }
+      );
+    } else if (ast && Array.isArray(ast.views) && ast.views.length > 0) {
+      ast.views.forEach(v => {
+        sections.push({
+          id: v.id || v.componentName.toLowerCase(),
+          component: v.componentName,
+          componentName: v.componentName,
+          role: v.purpose || v.title,
+          stateful: true
+        });
+      });
     } else {
-      return [
-        { id: 'navbar', component: 'Navbar', title: name, navLinks: ['Capabilities', 'Architecture', 'Throughput', 'Contact'] },
-        { id: 'hero', component: 'Hero', headline: headline, subheadline: summary, primaryCta: "Launch Interactive Sandbox", secondaryCta: "Explore Specs" },
-        { id: 'showcase', component: 'BentoShowcase', title: "Engineered from First Principles", cards: 4 },
-        { id: 'interactive', component: 'InteractiveCalculator', title: "Performance ROI Calculator" },
-        { id: 'contact', component: 'ContactSection', title: "Deploy Modern Architecture", email: "team@example.com" }
-      ];
+      sections.push({
+        id: "workspace",
+        component: "DynamicWorkspace",
+        componentName: "DynamicWorkspace",
+        role: "Primary Domain Workspace",
+        stateful: true
+      });
     }
+
+    return sections;
   }
 
   /**
-   * Step 3: Create Dynamic Task Graph (DAG)
+   * Step 3: Dynamic Task Graph (DAG) Compilation
    */
   createTaskGraph(spec) {
     const tasks = [
-      {
-        id: 'task-plan',
-        agentId: 'orchestrator',
-        name: 'Project Requirement Analysis & DAG Compilation',
-        task: `Deconstruct brief for ${spec.domain.toUpperCase()} project into modular task DAG`,
-        skills: ['frontend/nextjs'],
-        dependsOn: [],
-        status: 'queued'
-      },
-      {
-        id: 'task-design-director',
-        agentId: 'creativeDirector',
-        name: 'Visual Direction & Anti-AI Guardian Strategy',
-        task: `Formulate authentic visual personality, fluid clamp typography, and ban purple gradients & repetitive cards`,
-        skills: ['design/ui-design', 'design/typography', 'anti-ai/slop-guardian'],
-        dependsOn: ['task-plan'],
-        status: 'queued'
-      },
-      {
-        id: 'task-content-strategist',
-        agentId: 'contentStrategist',
-        name: 'Grounded Technical Copywriting & Domain Data',
-        task: `Author bespoke domain fixtures and technical value props with zero placeholder cliché copy`,
-        skills: ['content/copywriting', 'backend/data-models'],
-        dependsOn: ['task-plan'],
-        status: 'queued'
-      },
-      {
-        id: 'task-frontend-scaffold',
-        agentId: 'frontend',
-        name: 'Next.js 14/15 App Router Scaffolding & Root Layout',
-        task: `Synthesize package.json, tsconfig.json, tailwind.config.ts, src/app/layout.tsx, and globals.css`,
-        skills: ['frontend/nextjs', 'frontend/react', 'frontend/tailwind'],
-        dependsOn: ['task-design-director'],
-        status: 'queued'
-      },
-      {
-        id: 'task-frontend-components',
-        agentId: 'frontend',
-        name: 'Bespoke Asymmetric Section Components & Pages',
-        task: `Build src/app/page.tsx and all section components (${spec.sections.map(s => s.component).join(', ')})`,
-        skills: ['frontend/nextjs', 'frontend/react', 'design/ui-design'],
-        dependsOn: ['task-frontend-scaffold', 'task-content-strategist'],
-        status: 'queued'
-      },
-      {
-        id: 'task-backend-routes',
-        agentId: 'backend',
-        name: 'TypeScript API Route Handlers & Data Contract',
-        task: `Synthesize src/app/api/contact/route.ts and src/app/api/data/route.ts with RFC 7807 validation`,
-        skills: ['backend/route-handlers', 'backend/data-models'],
-        dependsOn: ['task-frontend-scaffold'],
-        status: 'queued'
-      },
-      {
-        id: 'task-animation-motion',
-        agentId: 'animationSpecialist',
-        name: 'Framer Motion Transitions & Interactive Micro-Interactions',
-        task: `Add smooth reveal choreography, interactive category filtering, and terminal emulator logic`,
-        skills: ['motion/framer-motion', 'motion/micro-interactions'],
-        dependsOn: ['task-frontend-components'],
-        status: 'queued'
-      },
-      {
-        id: 'task-responsive-specialist',
-        agentId: 'responsiveSpecialist',
-        name: 'Responsive Viewport Optimization & Layout Integrity',
-        task: `Ensure zero horizontal scroll, fluid clamp() font scaling, and touch target sizing`,
-        skills: ['quality/responsive-design', 'frontend/accessibility'],
-        dependsOn: ['task-frontend-components'],
-        status: 'queued'
-      },
-      {
-        id: 'task-qa-visual-critic',
-        agentId: 'visualCritic',
-        name: 'Anti-AI Rubric Review & Build Verification',
-        task: `Audit generated codebase against 6-dimension Anti-AI rubric and verify final threshold >= 8.5/10`,
-        skills: ['quality/visual-review', 'quality/browser-testing'],
-        dependsOn: ['task-animation-motion', 'task-responsive-specialist', 'task-backend-routes'],
-        status: 'queued'
-      }
+      { id: 'task-plan', name: 'Synthesize AST & Requirements', agentId: 'orchestrator', dependsOn: [], skills: ['open-world-synthesis'], status: 'queued' },
+      { id: 'task-design-director', name: 'Artistic Direction & Negative Constraints', agentId: 'creativeDirector', dependsOn: ['task-plan'], skills: ['design-director'], status: 'queued' },
+      { id: 'task-content-strategist', name: 'Copywriting & Content Topology', agentId: 'uxPlanner', dependsOn: ['task-plan'], skills: ['ux-architecture'], status: 'queued' },
+      { id: 'task-frontend-scaffold', name: 'Design Tokens & Global CSS Layout', agentId: 'designSystem', dependsOn: ['task-design-director'], skills: ['design-tokens'], status: 'queued' },
+      { id: 'task-backend-routes', name: 'API Routes & RFC 7807 Handlers', agentId: 'backend', dependsOn: ['task-frontend-scaffold'], skills: ['typescript-routes'], status: 'queued' },
+      { id: 'task-frontend-components', name: 'Dynamic View Components Synthesis', agentId: 'frontend', dependsOn: ['task-content-strategist', 'task-frontend-scaffold'], skills: ['react-19'], status: 'queued' },
+      { id: 'task-animation-motion', name: 'Fluid Motion & Micro-Interactions', agentId: 'frontend', dependsOn: ['task-frontend-components'], skills: ['framer-motion'], status: 'queued' },
+      { id: 'task-responsive-specialist', name: 'Responsive Viewport Calibration', agentId: 'frontend', dependsOn: ['task-frontend-components'], skills: ['tailwind'], status: 'queued' },
+      { id: 'task-qa-visual-critic', name: 'Impeccable Visual Quality Gate', agentId: 'qa', dependsOn: ['task-animation-motion', 'task-backend-routes', 'task-responsive-specialist'], skills: ['visual-critic'], status: 'queued' }
     ];
 
+    const agents = {
+      creativeDirector: { role: 'Creative Director', skills: ['design-director', 'anti-ai-patterns'] },
+      uxPlanner: { role: 'UX Planner', skills: ['ux-architecture', 'bento-layout'] },
+      designSystem: { role: 'Design System Architect', skills: ['design-tokens', 'fluid-typography'] },
+      frontend: { role: 'Frontend Engineer', skills: ['react-19', 'nextjs-app-router', 'tailwind'] },
+      backend: { role: 'Backend & API Engineer', skills: ['typescript-routes', 'rfc7807-errors'] },
+      database: { role: 'Database & Data Modeler', skills: ['data-fixtures', 'typescript-interfaces'] },
+      qa: { role: 'QA & Compliance Auditor', skills: ['requirement-validation', 'visual-critic'] }
+    };
+
     return {
       spec,
+      totalTasks: tasks.length,
+      agents,
       tasks
     };
   }
+
+  compileTaskGraph(spec) {
+    return this.createTaskGraph(spec);
+  }
 }

package/src/orchestrator/repair-planner.js

@@ -0,0 +1,67 @@
+/**
+ * PIXEL CREW — Targeted Repair Planner
+ * 
+ * Compiles precision repair tasks for failed requirements or visual critic defects
+ * without regenerating the entire repository. Enforces maximum repair limits.
+ */
+
+export const MAX_REPAIR_ITERATIONS = 3;
+
+export class RepairPlanner {
+  /**
+   * Plan targeted repair tasks from validation and visual critic reports.
+   */
+  static planRepairs({ validationResult, visualCriticResult, iteration = 1, files = {}, artifactGraph = null }) {
+    if (iteration > MAX_REPAIR_ITERATIONS) {
+      return {
+        canRepair: false,
+        status: 'needs-review',
+        iteration,
+        message: `Maximum repair iterations (${MAX_REPAIR_ITERATIONS}) reached. Manual review required.`,
+        repairTasks: []
+      };
+    }
+
+    const repairTasks = [];
+
+    // 1. Requirement Failure Repairs
+    if (validationResult && Array.isArray(validationResult.auditReport)) {
+      const failedReqs = validationResult.auditReport.filter(r => r.status === 'FAIL' || r.status === 'PARTIAL');
+      failedReqs.forEach(req => {
+        repairTasks.push({
+          taskId: `REPAIR-${req.id}-iter${iteration}`,
+          role: req.category === 'api_endpoint' ? 'backend' : (req.category === 'data_model' ? 'database' : 'frontend'),
+          goal: `Repair and satisfy requirement ${req.id} (${req.target})`,
+          target: req.target,
+          reason: req.reason,
+          iteration
+        });
+      });
+    }
+
+    // 2. Visual Critic Defect Repairs
+    if (visualCriticResult && Array.isArray(visualCriticResult.findings)) {
+      const slopFindings = visualCriticResult.findings.filter(f => f.severity === 'high');
+      slopFindings.forEach((finding, idx) => {
+        repairTasks.push({
+          taskId: `REPAIR-SLOP-${idx + 1}-iter${iteration}`,
+          role: 'frontend',
+          goal: `Eliminate ${finding.rule} in ${finding.file}`,
+          target: finding.file,
+          reason: finding.evidence,
+          iteration
+        });
+      });
+    }
+
+    const canRepair = repairTasks.length > 0;
+
+    return {
+      canRepair,
+      status: canRepair ? 'in-progress' : 'complete',
+      iteration,
+      totalTasks: repairTasks.length,
+      repairTasks
+    };
+  }
+}