@mmapp/react-compiler 0.1.0-alpha.1 → 0.1.0-alpha.3

package/src/project-compiler.ts

@@ -1,1629 +0,0 @@
-/**
- * ProjectCompiler — multi-file project compilation for UBER-SCALE apps.
- *
- * Takes a Record<string, string> of filename → source code, compiles each
- * file to IR independently, then composes a blueprint with child definitions.
- *
- * Handles:
- *   - Multiple .workflow.tsx files → each becomes a child IRWorkflowDefinition
- *   - Model files (models/*.ts) → category='data' child definitions
- *   - Server action files (*.server.ts) → registered action metadata
- *   - Page files (pages/ or app/ dir .tsx) → route table + router workflow child
- *   - mm.config.ts → parent blueprint metadata
- *   - Cross-file imports (topological sort for compilation order)
- *   - Incremental compilation (hash-based, only recompile changed files)
- *
- * Phase 2 enhancements:
- *   - Model compilation via model-compiler module
- *   - Route extraction via route-extractor module
- *   - Action compilation via action-compiler module
- *   - Incremental compilation via incremental-compiler module
- *   - Cross-file import resolution with data source linking
- */
-
-import { transformSync } from '@babel/core';
-import type {
-  IRWorkflowDefinition,
-  IRFieldDefinition,
-  IRStateDefinition,
-  IRTransitionDefinition,
-  IROnEventSubscription,
-  IRExperienceNode,
-  IRGrammarIsland,
-} from '@mindmatrix/player-core';
-import babelPlugin from './babel';
-import type { ReactCompilerError } from './types';
-import {
-  extractRouterWorkflow,
-  pathToStateName,
-  pathToUrlPattern,
-  extractParams,
-} from './babel/extractors/router-extractor';
-import type { PageFile } from './babel/extractors/router-extractor';
-import type { ServerAction } from './babel/extractors/server-action-extractor';
-
-// Phase 2 module imports
-import { compileModels } from './model-compiler';
-import type { ModelCompilationResult } from './model-compiler';
-import { extractRoutes } from './route-extractor';
-import type { RouteExtractionResult } from './route-extractor';
-import { compileActions } from './action-compiler';
-import type { ActionCompilationResult } from './action-compiler';
-import {
-  hashContent,
-  resolveImport,
-  buildDependencyGraph,
-  topologicalSort,
-  IncrementalCache,
-} from './incremental-compiler';
-import type { IncrementalStats } from './incremental-compiler';
-
-// =============================================================================
-// Types
-// =============================================================================
-
-/**
- * A resolved module's compilation output, used for route merging.
- * The caller (build tool) compiles each dependency and passes the result here.
- */
-export interface ResolvedModule {
-  /** The module's slug (must match the dependency slug in mm.config.ts). */
-  slug: string;
-  /** The module's compiled route table. */
-  routeTable: RouteTableEntry[];
-  /** The module's declared routes from its mm.config.ts (if any). */
-  manifestRoutes?: Array<{ path: string; label?: string; group?: string; icon?: string; showInNav?: boolean }>;
-}
-
-export interface ProjectCompilerOptions {
-  /** Compilation mode: strict or infer. Default: 'infer'. */
-  mode?: 'strict' | 'infer';
-  /** Enable Phase 2 modules (model-compiler, route-extractor, action-compiler). Default: true. */
-  usePhase2Modules?: boolean;
-  /** Pre-compiled module results for route merging at compile time. */
-  resolvedModules?: ResolvedModule[];
-}
-
-export interface ProjectCompilationResult {
-  /** The parent blueprint IRWorkflowDefinition (merged from all files). */
-  ir: IRWorkflowDefinition;
-  /** Child workflow definitions — one per .workflow.tsx + one per model + router. */
-  childDefinitions: IRWorkflowDefinition[];
-  /** Per-file IRs keyed by filename. */
-  fileIRs: Record<string, IRWorkflowDefinition>;
-  /** Route table extracted from pages*.tsx directory structure. */
-  routeTable: RouteTableEntry[];
-  /** Server actions extracted from *.server.ts files. */
-  serverActions: ServerActionEntry[];
-  /** Errors from individual file compilations. */
-  errors: ProjectCompilationError[];
-  /** Warnings from individual file compilations. */
-  warnings: ProjectCompilationError[];
-  /** Per-page experience trees extracted from app/**\/*.tsx file IRs. */
-  pageExperiences: Record<string, IRExperienceNode>;
-  /** Component definitions captured from components/*.tsx files. */
-  componentDefinitions: Record<string, { experience: IRExperienceNode; props: string[] }>;
-  /** Phase 2: Cross-file import links (importer → imported data sources). */
-  importLinks?: ImportLink[];
-  /** Phase 2: Model compilation results (if usePhase2Modules enabled). */
-  modelResults?: Map<string, ModelCompilationResult>;
-  /** Phase 2: Action compilation result (if usePhase2Modules enabled). */
-  actionResult?: ActionCompilationResult;
-  /** Phase 2: Route extraction result (if usePhase2Modules enabled). */
-  routeResult?: RouteExtractionResult;
-}
-
-export interface ProjectCompilationError {
-  file: string;
-  message: string;
-  line?: number;
-  column?: number;
-  /** End line for marker spans (defaults to start line). */
-  endLine?: number;
-  /** End column for marker spans (defaults to start column + token length). */
-  endColumn?: number;
-  severity: 'error' | 'warning';
-}
-
-export interface RouteTableEntry {
-  /** Route URL path (e.g., '/rider/home'). */
-  path: string;
-  /** State name derived from the route (e.g., 'RIDER_HOME'). */
-  stateName: string;
-  /** Source file path (e.g., 'pages/rider/home.tsx'). */
-  sourceFile: string;
-  /** Dynamic parameters from [param] segments. */
-  params: string[];
-  /** Module slug if this route was merged from a dependency. */
-  moduleSlug?: string;
-}
-
-export interface ServerActionEntry {
-  /** Function name. */
-  name: string;
-  /** Source file path. */
-  sourceFile: string;
-  /** Whether the function is async. */
-  async: boolean;
-  /** Parameter names. */
-  params: string[];
-  /** Description from JSDoc. */
-  description?: string;
-  /** Full function body source text (for round-trip preservation). */
-  body?: string;
-  /** TypeScript return type (e.g., 'Promise<ActionResult>'). */
-  returnType?: string;
-}
-
-/** Phase 2: Cross-file import link metadata. */
-export interface ImportLink {
-  /** The file that imports. */
-  fromFile: string;
-  /** The file being imported. */
-  toFile: string;
-  /** Type of link: 'data-source' for model imports, 'component' for component imports. */
-  linkType: 'data-source' | 'component' | 'action' | 'unknown';
-  /** Imported symbol names. */
-  symbols: string[];
-}
-
-interface ParsedConfig {
-  slug?: string;
-  name?: string;
-  version?: string;
-  description?: string;
-  category?: string | string[];
-  mode?: 'strict' | 'infer';
-}
-
-// =============================================================================
-// Config Parser
-// =============================================================================
-
-/**
- * Parses mm.config.ts source to extract defineBlueprint() configuration.
- * Uses simple regex extraction rather than full evaluation since we
- * can't execute arbitrary TypeScript in a compiler context.
- */
-function parseConfig(source: string): ParsedConfig {
-  const config: ParsedConfig = {};
-
-  // Extract key-value pairs from defineBlueprint({ ... })
-  const slugMatch = source.match(/slug:\s*['"]([^'"]+)['"]/);
-  if (slugMatch) config.slug = slugMatch[1];
-
-  const nameMatch = source.match(/name:\s*['"]([^'"]+)['"]/);
-  if (nameMatch) config.name = nameMatch[1];
-
-  const versionMatch = source.match(/version:\s*['"]([^'"]+)['"]/);
-  if (versionMatch) config.version = versionMatch[1];
-
-  const descMatch = source.match(/description:\s*['"]([^'"]+)['"]/);
-  if (descMatch) config.description = descMatch[1];
-
-  // Handle category as string or array: category: 'workflow' or category: ['workflow', 'blueprint', 'module']
-  const categoryArrayMatch = source.match(/category:\s*\[([^\]]+)\]/);
-  if (categoryArrayMatch) {
-    const items = categoryArrayMatch[1].match(/['"]([^'"]+)['"]/g);
-    if (items) {
-      config.category = items.map(s => s.replace(/['"]/g, ''));
-    }
-  } else {
-    const categoryMatch = source.match(/category:\s*['"]([^'"]+)['"]/);
-    if (categoryMatch) config.category = categoryMatch[1];
-  }
-
-  const modeMatch = source.match(/mode:\s*['"]([^'"]+)['"]/);
-  if (modeMatch && (modeMatch[1] === 'strict' || modeMatch[1] === 'infer')) {
-    config.mode = modeMatch[1];
-  }
-
-  return config;
-}
-
-/**
- * Parses mm.module.ts source to extract defineModule() manifest as a JSON object.
- *
- * Uses regex extraction for scalar fields and array/object block extraction
- * for structured fields (models, routes, actions, slots, etc.).
- * Returns a plain object suitable for storing as metadata.module_manifest.
- */
-function parseModuleManifest(source: string): Record<string, unknown> | null {
-  // Must contain defineBlueprint or defineModule to be a valid manifest
-  if (!source.includes('defineBlueprint') && !source.includes('defineModule')) return null;
-
-  const manifest: Record<string, unknown> = {};
-
-  // Extract scalar string fields
-  const stringFields = ['slug', 'name', 'version', 'description', 'author', 'license', 'icon'];
-  for (const field of stringFields) {
-    const match = source.match(new RegExp(`${field}:\\s*['"]([^'"]+)['"]`));
-    if (match) manifest[field] = match[1];
-  }
-
-  // Handle category as string or array
-  const catArrayMatch = source.match(/category:\s*\[([^\]]+)\]/);
-  if (catArrayMatch) {
-    const items = catArrayMatch[1].match(/['"]([^'"]+)['"]/g);
-    if (items) {
-      manifest.category = items.map((s: string) => s.replace(/['"]/g, ''));
-    }
-  } else {
-    const catMatch = source.match(/category:\s*['"]([^'"]+)['"]/);
-    if (catMatch) manifest.category = catMatch[1];
-  }
-
-  // Extract tags array
-  const tagsMatch = source.match(/tags:\s*\[([^\]]*)\]/);
-  if (tagsMatch) {
-    manifest.tags = tagsMatch[1]
-      .split(',')
-      .map(s => s.trim().replace(/^['"]|['"]$/g, ''))
-      .filter(Boolean);
-  }
-
-  // Extract models array
-  const modelsMatch = source.match(/models:\s*\[([^\]]*)\]/);
-  if (modelsMatch) {
-    manifest.models = modelsMatch[1]
-      .split(',')
-      .map(s => s.trim().replace(/^['"]|['"]$/g, ''))
-      .filter(Boolean);
-  }
-
-  // Extract capabilities array
-  const capsMatch = source.match(/capabilities:\s*\[([^\]]*)\]/);
-  if (capsMatch) {
-    manifest.capabilities = capsMatch[1]
-      .split(',')
-      .map(s => s.trim().replace(/^['"]|['"]$/g, ''))
-      .filter(Boolean);
-  }
-
-  // Extract routes array (array of objects) — count + simplified entries
-  const routesBlock = extractArrayBlock(source, 'routes');
-  if (routesBlock) {
-    const routes: { path: string; label?: string; group?: string; icon?: string; showInNav?: boolean }[] = [];
-    const routeRegex = /\{\s*path:\s*['"]([^'"]+)['"][^}]*\}/g;
-    let rm;
-    while ((rm = routeRegex.exec(routesBlock)) !== null) {
-      const entry: { path: string; label?: string; group?: string; icon?: string } = { path: rm[1] };
-      const labelMatch = rm[0].match(/label:\s*['"]([^'"]+)['"]/);
-      if (labelMatch) entry.label = labelMatch[1];
-      const groupMatch = rm[0].match(/group:\s*['"]([^'"]+)['"]/);
-      if (groupMatch) entry.group = groupMatch[1];
-      const iconMatch = rm[0].match(/icon:\s*['"]([^'"]+)['"]/);
-      if (iconMatch) entry.icon = iconMatch[1];
-      routes.push(entry);
-    }
-    if (routes.length > 0) manifest.routes = routes;
-  }
-
-  // Extract actions array (array of objects)
-  const actionsBlock = extractArrayBlock(source, 'actions');
-  if (actionsBlock) {
-    const actions: { id: string; description?: string }[] = [];
-    const actionRegex = /\{\s*id:\s*['"]([^'"]+)['"][^}]*\}/g;
-    let am;
-    while ((am = actionRegex.exec(actionsBlock)) !== null) {
-      const entry: { id: string; description?: string } = { id: am[1] };
-      const descMatch = am[0].match(/description:\s*['"]([^'"]+)['"]/);
-      if (descMatch) entry.description = descMatch[1];
-      actions.push(entry);
-    }
-    if (actions.length > 0) manifest.actions = actions;
-  }
-
-  // Extract contributions array
-  const contribsBlock = extractArrayBlock(source, 'contributions');
-  if (contribsBlock) {
-    const contributions: { slot: string; view: string; priority?: number }[] = [];
-    const contribRegex = /\{\s*slot:\s*['"]([^'"]+)['"][^}]*\}/g;
-    let cm;
-    while ((cm = contribRegex.exec(contribsBlock)) !== null) {
-      const entry: { slot: string; view: string; priority?: number } = { slot: cm[1], view: '' };
-      const viewMatch = cm[0].match(/view:\s*['"]([^'"]+)['"]/);
-      if (viewMatch) entry.view = viewMatch[1];
-      const prioMatch = cm[0].match(/priority:\s*(\d+)/);
-      if (prioMatch) entry.priority = parseInt(prioMatch[1], 10);
-      contributions.push(entry);
-    }
-    if (contributions.length > 0) manifest.contributions = contributions;
-  }
-
-  // Extract dependencies array
-  const depsBlock = extractArrayBlock(source, 'dependencies');
-  if (depsBlock) {
-    const dependencies: { slug: string; version?: string; required?: boolean; routeConfig?: { prefix?: string }; slotMapping?: Record<string, string> }[] = [];
-    const depRegex = /\{\s*slug:\s*['"]([^'"]+)['"][^}]*\}/g;
-    let dm;
-    while ((dm = depRegex.exec(depsBlock)) !== null) {
-      const entry: typeof dependencies[0] = { slug: dm[1] };
-      const verMatch = dm[0].match(/version:\s*['"]([^'"]+)['"]/);
-      if (verMatch) entry.version = verMatch[1];
-      const reqMatch = dm[0].match(/required:\s*(true|false)/);
-      if (reqMatch) entry.required = reqMatch[1] === 'true';
-      // Extract routeConfig.prefix
-      const prefixMatch = dm[0].match(/prefix:\s*['"]([^'"]+)['"]/);
-      if (prefixMatch) entry.routeConfig = { prefix: prefixMatch[1] };
-      dependencies.push(entry);
-    }
-    if (dependencies.length > 0) manifest.dependencies = dependencies;
-  }
-
-  // Only return a manifest if it has rich fields beyond basic metadata.
-  // Plain blueprints with just slug/name/version don't need a manifest entry.
-  const hasRichFields = manifest.routes || manifest.actions
-    || manifest.contributions
-    || manifest.capabilities || manifest.dependencies;
-  return hasRichFields ? manifest : null;
-}
-
-/**
- * Parses dependency routeConfig entries from mm.config.ts in the file map.
- * Returns a map of dependency slug → { prefix, routes } for route merging.
- */
-function parseDependencyRouteConfigs(
-  files: Record<string, string>,
-): Map<string, { prefix?: string; routes?: Record<string, string | false> }> {
-  const result = new Map<string, { prefix?: string; routes?: Record<string, string | false> }>();
-
-  let configSource: string | undefined;
-  for (const [filename, source] of Object.entries(files)) {
-    if (isConfigFile(filename)) {
-      configSource = source;
-      break;
-    }
-  }
-  if (!configSource) return result;
-
-  const depsBlock = extractArrayBlock(configSource, 'dependencies');
-  if (!depsBlock) return result;
-
-  // Extract each dependency object block (handling nested braces)
-  const depObjects = extractNestedObjects(depsBlock);
-  for (const depSrc of depObjects) {
-    const slugMatch = depSrc.match(/slug:\s*['"]([^'"]+)['"]/);
-    if (!slugMatch) continue;
-    const slug = slugMatch[1];
-
-    // Extract routeConfig block
-    const rcBlock = extractObjectBlock(depSrc, 'routeConfig');
-    if (!rcBlock) continue;
-
-    const entry: { prefix?: string; routes?: Record<string, string | false> } = {};
-
-    const prefixMatch = rcBlock.match(/prefix:\s*['"]([^'"]+)['"]/);
-    if (prefixMatch) entry.prefix = prefixMatch[1];
-
-    // Extract per-route overrides: routes: { '/path': '/remap' | false }
-    const routesBlock = extractObjectBlock(rcBlock, 'routes');
-    if (routesBlock) {
-      const overrides: Record<string, string | false> = {};
-      const overrideRegex = /['"]([^'"]+)['"]\s*:\s*(?:['"]([^'"]+)['"]|(false))/g;
-      let om;
-      while ((om = overrideRegex.exec(routesBlock)) !== null) {
-        overrides[om[1]] = om[3] === 'false' ? false : om[2];
-      }
-      if (Object.keys(overrides).length > 0) entry.routes = overrides;
-    }
-
-    result.set(slug, entry);
-  }
-
-  return result;
-}
-
-/**
- * Extracts top-level object blocks from a source string (e.g., array of objects).
- * Handles nested braces correctly.
- */
-function extractNestedObjects(source: string): string[] {
-  const objects: string[] = [];
-  let depth = 0;
-  let start = -1;
-  for (let i = 0; i < source.length; i++) {
-    if (source[i] === '{') {
-      if (depth === 0) start = i;
-      depth++;
-    } else if (source[i] === '}') {
-      depth--;
-      if (depth === 0 && start >= 0) {
-        objects.push(source.slice(start, i + 1));
-        start = -1;
-      }
-    }
-  }
-  return objects;
-}
-
-/**
- * Extracts a named object block (e.g., routeConfig: { ... }) from source.
- * Handles nested braces.
- */
-function extractObjectBlock(source: string, fieldName: string): string | null {
-  const pattern = new RegExp(`${fieldName}:\\s*\\{`);
-  const match = pattern.exec(source);
-  if (!match) return null;
-
-  let depth = 1;
-  const startIdx = match.index + match[0].length;
-  for (let i = startIdx; i < source.length; i++) {
-    if (source[i] === '{') depth++;
-    else if (source[i] === '}') {
-      depth--;
-      if (depth === 0) return source.slice(startIdx, i);
-    }
-  }
-  return null;
-}
-
-/**
- * Extract a top-level array block from source code by field name.
- * Handles nested brackets. Returns the content between the outermost [].
- */
-function extractArrayBlock(source: string, fieldName: string): string | null {
-  const startPattern = new RegExp(`${fieldName}:\\s*\\[`);
-  const match = startPattern.exec(source);
-  if (!match) return null;
-
-  let depth = 1;
-  const startIdx = match.index + match[0].length;
-  for (let i = startIdx; i < source.length; i++) {
-    if (source[i] === '[') depth++;
-    else if (source[i] === ']') {
-      depth--;
-      if (depth === 0) return source.slice(startIdx, i);
-    }
-  }
-  return null;
-}
-
-// =============================================================================
-// File Classification
-// =============================================================================
-
-function isWorkflowFile(filename: string): boolean {
-  return /\.workflow\.(tsx?|jsx?)$/.test(filename);
-}
-
-function isModelFile(filename: string): boolean {
-  return /models\/.*\.(ts|tsx)$/.test(filename) && !filename.endsWith('.test.ts');
-}
-
-function isServerActionFile(filename: string): boolean {
-  return /\.server\.(ts|tsx)$/.test(filename);
-}
-
-function isComponentFile(filename: string): boolean {
-  return /components\/.*\.(tsx?|jsx?)$/.test(filename)
-    && !filename.endsWith('.test.ts')
-    && !filename.endsWith('.test.tsx');
-}
-
-function isPageFile(filename: string): boolean {
-  return (/pages\/.*\.(tsx?|jsx?)$/.test(filename) || /app\/.*\.(tsx?|jsx?)$/.test(filename))
-    && !filename.endsWith('.test.ts')
-    && !filename.endsWith('.test.tsx')
-    && !filename.includes('layout');
-}
-
-function isAppDirFile(filename: string): boolean {
-  return /^app\//.test(filename);
-}
-
-function isConfigFile(filename: string): boolean {
-  return /mm\.config\.(ts|tsx|js)$/.test(filename);
-}
-
-function isModuleManifestFile(filename: string): boolean {
-  return /mm\.module\.(ts|tsx|js)$/.test(filename);
-}
-
-function isCompilableFile(filename: string): boolean {
-  return isWorkflowFile(filename)
-    || isModelFile(filename)
-    || isServerActionFile(filename)
-    || isPageFile(filename)
-    || isComponentFile(filename);
-}
-
-// =============================================================================
-// Single-File Compilation
-// =============================================================================
-
-function compileFile(
-  filename: string,
-  source: string,
-  mode: 'strict' | 'infer',
-): { ir: IRWorkflowDefinition | null; errors: ProjectCompilationError[] } {
-  const errors: ProjectCompilationError[] = [];
-
-  try {
-    const parserPlugins = filename.endsWith('.tsx') || filename.endsWith('.jsx')
-      ? ['typescript', 'jsx'] as const
-      : ['typescript'] as const;
-
-    const result = transformSync(source, {
-      filename,
-      plugins: [[babelPlugin, { mode }]],
-      parserOpts: { plugins: parserPlugins as any, attachComment: true },
-    });
-
-    const ir: IRWorkflowDefinition | null =
-      (result as any)?.metadata?.mindmatrixIR ?? null;
-
-    // Collect per-file errors/warnings from IR metadata
-    if (ir?.metadata) {
-      const meta = ir.metadata as Record<string, unknown>;
-      const fileErrors = meta.errors as ReactCompilerError[] | undefined;
-      const fileWarnings = meta.warnings as ReactCompilerError[] | undefined;
-      if (fileErrors) {
-        for (const e of fileErrors) {
-          errors.push({
-            file: filename,
-            message: e.message,
-            line: e.line,
-            column: e.column,
-            endLine: e.line,
-            endColumn: e.column !== undefined ? e.column + 10 : undefined,
-            severity: 'error',
-          });
-        }
-      }
-      if (fileWarnings) {
-        for (const w of fileWarnings) {
-          errors.push({
-            file: filename,
-            message: w.message,
-            line: w.line,
-            column: w.column,
-            endLine: w.line,
-            endColumn: w.column !== undefined ? w.column + 10 : undefined,
-            severity: 'warning',
-          });
-        }
-      }
-    }
-
-    return { ir, errors };
-  } catch (err) {
-    // Extract line/column from Babel parse errors
-    const errMsg = (err as Error).message;
-    const locMatch = errMsg.match(/\((\d+):(\d+)\)/);
-    const line = locMatch ? parseInt(locMatch[1], 10) : undefined;
-    const column = locMatch ? parseInt(locMatch[2], 10) : undefined;
-
-    errors.push({
-      file: filename,
-      message: 'Compilation failed: ' + errMsg,
-      line,
-      column,
-      endLine: line,
-      endColumn: column !== undefined ? column + 1 : undefined,
-      severity: 'error',
-    });
-    return { ir: null, errors };
-  }
-}
-
-// =============================================================================
-// IR Merging (for parent blueprint)
-// =============================================================================
-
-/** Deduplicate state actions by JSON content equality. */
-function deduplicateActions<T>(actions: T[]): T[] {
-  const seen = new Set<string>();
-  const result: T[] = [];
-  for (const action of actions) {
-    const key = JSON.stringify(action);
-    if (!seen.has(key)) {
-      seen.add(key);
-      result.push(action);
-    }
-  }
-  return result;
-}
-
-/**
- * Merges multiple IRWorkflowDefinitions into one unified parent blueprint.
- */
-function mergeIRs(
-  irs: IRWorkflowDefinition[],
-  config: ParsedConfig,
-): IRWorkflowDefinition {
-  if (irs.length === 0) {
-    return createEmptyIR(config);
-  }
-
-  if (irs.length === 1) {
-    return applyConfig(irs[0], config);
-  }
-
-  // Merge fields: deduplicate by name, first wins but merge metadata.
-  // Later occurrences can upgrade: required=true wins, and non-empty/non-default
-  // default_value wins (workflow files have user-specified defaults, model files
-  // have type-inferred defaults like "" or 0).
-  const fieldMap = new Map<string, IRFieldDefinition>();
-  for (const ir of irs) {
-    for (const field of ir.fields) {
-      if (!fieldMap.has(field.name)) {
-        fieldMap.set(field.name, field);
-      } else {
-        const existing = fieldMap.get(field.name)!;
-        if (field.required && !existing.required) {
-          existing.required = true;
-        }
-        // Prefer non-trivial default_value (not empty string, 0, false, null, undefined)
-        if (field.default_value != null && field.default_value !== '' &&
-            field.default_value !== 0 && field.default_value !== false) {
-          if (existing.default_value == null || existing.default_value === '' ||
-              existing.default_value === 0 || existing.default_value === false) {
-            existing.default_value = field.default_value;
-          }
-        }
-      }
-    }
-  }
-
-  // Merge states: deduplicate by name, merge actions (deduplicate by action id)
-  const stateMap = new Map<string, IRStateDefinition>();
-  for (const ir of irs) {
-    for (const state of ir.states) {
-      if (stateMap.has(state.name)) {
-        const existing = stateMap.get(state.name)!;
-        existing.on_enter = deduplicateActions([...existing.on_enter, ...state.on_enter]);
-        existing.on_exit = deduplicateActions([...existing.on_exit, ...state.on_exit]);
-        existing.during = deduplicateActions([...existing.during, ...state.during]);
-        if (state.on_event) {
-          existing.on_event = [...(existing.on_event || []), ...state.on_event];
-        }
-        // State type: first wins (consistent with field merging).
-        // Model files define authoritative state types via the explicit states array.
-      } else {
-        stateMap.set(state.name, { ...state });
-      }
-    }
-  }
-
-  // Merge transitions: deduplicate by name, first wins
-  const transitionMap = new Map<string, IRTransitionDefinition>();
-  for (const ir of irs) {
-    for (const transition of ir.transitions) {
-      if (!transitionMap.has(transition.name)) {
-        transitionMap.set(transition.name, transition);
-      }
-    }
-  }
-
-  // Merge events
-  const events: IROnEventSubscription[] = [];
-  for (const ir of irs) {
-    if (ir.on_event) {
-      events.push(...ir.on_event);
-    }
-  }
-
-  // Merge views: collect all view trees
-  const viewTrees: IRExperienceNode[] = [];
-  for (const ir of irs) {
-    const views = (ir as any).views as Record<string, IRExperienceNode> | undefined;
-    if (views?.default) {
-      viewTrees.push(views.default);
-    }
-  }
-
-  // Merge extensions (grammar islands)
-  const extensions: Record<string, IRGrammarIsland[]> = {};
-  for (const ir of irs) {
-    if (ir.extensions) {
-      for (const [key, islands] of Object.entries(ir.extensions)) {
-        if (!extensions[key]) extensions[key] = [];
-        extensions[key].push(...islands);
-      }
-    }
-  }
-
-  // Merge metadata
-  const metadata: Record<string, unknown> = {};
-  for (const ir of irs) {
-    if (ir.metadata) {
-      for (const [key, value] of Object.entries(ir.metadata)) {
-        if (key === 'errors' || key === 'warnings') continue;
-        metadata[key] = value;
-      }
-    }
-  }
-
-  // Merge roles
-  const roleMap = new Map<string, (typeof irs)[0]['roles'][0]>();
-  for (const ir of irs) {
-    for (const role of ir.roles) {
-      if (!roleMap.has(role.name)) {
-        roleMap.set(role.name, role);
-      }
-    }
-  }
-
-  const base = irs[0];
-  const merged: IRWorkflowDefinition = {
-    slug: base.slug,
-    name: base.name,
-    version: base.version,
-    description: base.description,
-    category: base.category,
-    fields: Array.from(fieldMap.values()),
-    states: Array.from(stateMap.values()),
-    transitions: Array.from(transitionMap.values()),
-    roles: Array.from(roleMap.values()),
-    tags: base.tags,
-    metadata,
-  };
-
-  if (events.length > 0) {
-    merged.on_event = events;
-  }
-
-  if (Object.keys(extensions).length > 0) {
-    merged.extensions = extensions;
-  }
-
-  if (viewTrees.length === 1) {
-    (merged as any).views = { default: viewTrees[0] };
-  } else if (viewTrees.length > 1) {
-    const rootView: IRExperienceNode = {
-      id: 'project-root',
-      component: 'Stack',
-      children: viewTrees,
-    };
-    (merged as any).views = { default: rootView };
-  }
-
-  return applyConfig(merged, config);
-}
-
-function applyConfig(ir: IRWorkflowDefinition, config: ParsedConfig): IRWorkflowDefinition {
-  if (config.slug) ir.slug = config.slug;
-  if (config.name) ir.name = config.name;
-  if (config.version) ir.version = config.version;
-  if (config.description !== undefined) ir.description = config.description;
-  if (config.category) ir.category = config.category;
-
-  if (!ir.metadata) ir.metadata = {};
-  ir.metadata.stable_id = 'def-' + ir.slug;
-  ir.metadata.provenance = {
-    frontend: 'react-compiler',
-    source: 'project',
-    compiler_version: '2.0.0',
-  };
-
-  return ir;
-}
-
-function createEmptyIR(config: ParsedConfig): IRWorkflowDefinition {
-  return {
-    slug: config.slug || 'project',
-    name: config.name || 'Project',
-    version: config.version || '0.1.0',
-    description: config.description,
-    category: config.category || 'workflow',
-    fields: [],
-    states: [{
-      name: 'draft',
-      type: 'START',
-      on_enter: [],
-      during: [],
-      on_exit: [],
-    }],
-    transitions: [],
-    roles: [],
-    tags: [],
-    metadata: {
-      stable_id: 'def-' + (config.slug || 'project'),
-      provenance: {
-        frontend: 'react-compiler',
-        source: 'project',
-        compiler_version: '2.0.0',
-      },
-    },
-  };
-}
-
-// =============================================================================
-// Cross-file Import Resolution (Phase 2 enhanced)
-// =============================================================================
-
-/**
- * Resolves cross-file imports and classifies them by link type.
- *
- * Import classification:
- *   - pages/index.tsx importing from models/user.ts → 'data-source' link
- *   - pages/form.tsx importing from components/MapView.tsx → 'component' (opaque pass-through)
- *   - workflows/ride.workflow.tsx importing from actions/pricing.server.ts → 'action' link
- *   - other imports → 'unknown'
- */
-function resolveImportLinks(
-  files: Record<string, string>,
-  compilableFiles: string[],
-): ImportLink[] {
-  const links: ImportLink[] = [];
-
-  for (const filename of compilableFiles) {
-    const source = files[filename];
-    // Match import statements with named imports
-    const importRegex = /import\s+(?:type\s+)?(?:\{([^}]+)\}|(\w+))\s+from\s+['"](\.[^'"]+)['"]/g;
-    let match;
-    while ((match = importRegex.exec(source)) !== null) {
-      const namedImports = match[1];
-      const defaultImport = match[2];
-      const importPath = match[3];
-
-      const resolved = resolveImport(filename, importPath, Object.keys(files));
-      if (!resolved || resolved === filename) continue;
-
-      // Classify the link type
-      let linkType: ImportLink['linkType'] = 'unknown';
-      if (isModelFile(resolved)) {
-        linkType = 'data-source';
-      } else if (isServerActionFile(resolved)) {
-        linkType = 'action';
-      } else if (/components\//.test(resolved)) {
-        linkType = 'component';
-      }
-
-      // Extract imported symbols
-      const symbols: string[] = [];
-      if (namedImports) {
-        symbols.push(...namedImports.split(',').map(s => s.trim().split(' as ')[0].trim()).filter(Boolean));
-      }
-      if (defaultImport) {
-        symbols.push(defaultImport);
-      }
-
-      links.push({
-        fromFile: filename,
-        toFile: resolved,
-        linkType,
-        symbols,
-      });
-    }
-  }
-
-  return links;
-}
-
-/**
- * Resolves compilation order using the incremental-compiler module.
- */
-function resolveCompilationOrder(
-  files: Record<string, string>,
-  compilableFiles: string[],
-): string[] {
-  const { dependencies } = buildDependencyGraph(files);
-  return topologicalSort(compilableFiles, dependencies);
-}
-
-// =============================================================================
-// Component Props Extraction
-// =============================================================================
-
-/**
- * Extracts prop names from a component file's function parameter destructuring.
- *
- * Matches patterns like:
- *   export function MapView({ pickupLocation, dropoffLocation, ...rest }: MapViewProps)
- *   function MapView({ pickupLocation, dropoffLocation }: MapViewProps)
- *
- * Returns an array of prop names (without types, defaults, or rest params).
- */
-function extractComponentProps(source: string): string[] {
-  // Match: (export )?(default )?function ComponentName({ prop1, prop2, ... }
-  const match = source.match(/function\s+\w+\s*\(\s*\{([^}]+)\}/);
-  if (!match) return [];
-  return match[1]
-    .split(',')
-    .map(p => p.trim().split(/[\s=:]/)[0].replace(/^\.{3}/, '').trim())
-    .filter(Boolean);
-}
-
-// =============================================================================
-// Composed Result Builder (multi-workflow composition)
-// =============================================================================
-
-/**
- * Builds a composed project result with child definitions.
- * Phase 2: optionally uses model-compiler, route-extractor, and action-compiler.
- */
-function buildComposedResult(
-  files: Record<string, string>,
-  fileIRs: Record<string, IRWorkflowDefinition>,
-  config: ParsedConfig,
-  errors: ProjectCompilationError[],
-  warnings: ProjectCompilationError[],
-  options: { usePhase2Modules?: boolean; mode?: 'strict' | 'infer'; resolvedModules?: ResolvedModule[] } = {},
-): ProjectCompilationResult {
-  const usePhase2 = options.usePhase2Modules !== false; // default true
-
-  // Separate IRs by file type
-  const workflowIRs: IRWorkflowDefinition[] = [];
-  const modelIRs: IRWorkflowDefinition[] = [];
-  const serverActionEntries: ServerActionEntry[] = [];
-
-  // Phase 2 results
-  let modelResults: Map<string, ModelCompilationResult> | undefined;
-  let actionResult: ActionCompilationResult | undefined;
-  let routeResult: RouteExtractionResult | undefined;
-
-  // Component definitions captured from components/*.tsx files
-  const componentDefinitions: Record<string, { experience: IRExperienceNode; props: string[] }> = {};
-
-  for (const [filename, ir] of Object.entries(fileIRs)) {
-    if (isWorkflowFile(filename)) {
-      workflowIRs.push(ir);
-    } else if (isModelFile(filename)) {
-      if (!ir.category || ir.category === 'workflow') {
-        ir.category = 'data';
-      }
-      modelIRs.push(ir);
-    } else if (isServerActionFile(filename)) {
-      const meta = ir.metadata as Record<string, unknown> | undefined;
-      const actions = meta?.serverActions as ServerAction[] | undefined;
-      if (actions) {
-        for (const action of actions) {
-          serverActionEntries.push({
-            name: action.name,
-            sourceFile: filename,
-            async: action.async,
-            params: action.params,
-            description: action.description,
-          });
-        }
-      }
-    } else if (isComponentFile(filename)) {
-      // Extract experience tree from the compiled component
-      const views = (ir as any).views as Record<string, IRExperienceNode> | undefined;
-      const experience = views?.default ?? (ir as any).experience as IRExperienceNode | undefined;
-      if (experience) {
-        // Derive component name from filename: components/MapView.tsx → MapView
-        const baseName = filename.split('/').pop()?.replace(/\.(tsx?|jsx?)$/, '') || 'Component';
-        // Extract props from the source via function parameter destructuring
-        const source = files[filename];
-        const props = source ? extractComponentProps(source) : [];
-        componentDefinitions[baseName] = { experience, props };
-      }
-    }
-  }
-
-  // Phase 2: Use standalone modules for enhanced compilation
-  if (usePhase2) {
-    // Model compilation — re-compile models with model-compiler for richer metadata
-    const modelFiles: Record<string, string> = {};
-    for (const [filename, source] of Object.entries(files)) {
-      if (isModelFile(filename)) {
-        modelFiles[filename] = source;
-      }
-    }
-    if (Object.keys(modelFiles).length > 0) {
-      modelResults = compileModels(modelFiles, { mode: options.mode || 'infer' });
-      // Replace model IRs with model-compiler results (richer metadata)
-      modelIRs.length = 0;
-      for (const [, result] of modelResults) {
-        modelIRs.push(result.ir);
-      }
-    }
-
-    // Action compilation — use action-compiler for endpoint registration
-    const actionFiles: Record<string, string> = {};
-    for (const [filename, source] of Object.entries(files)) {
-      if (isServerActionFile(filename)) {
-        actionFiles[filename] = source;
-      }
-    }
-    if (Object.keys(actionFiles).length > 0) {
-      actionResult = compileActions(actionFiles, {
-        mode: options.mode || 'infer',
-        blueprintSlug: config.slug || 'app',
-      });
-      // Merge action-compiler results into serverActionEntries
-      serverActionEntries.length = 0;
-      for (const reg of actionResult.actions) {
-        serverActionEntries.push({
-          name: reg.name,
-          sourceFile: reg.sourceFile,
-          async: reg.async,
-          params: reg.params,
-          description: reg.description,
-          body: reg.body,
-          returnType: reg.returnType,
-        });
-      }
-    }
-
-    // Route extraction — use route-extractor for app/ directory
-    const appFiles: Record<string, string> = {};
-    for (const [filename, source] of Object.entries(files)) {
-      if (isAppDirFile(filename) || isPageFile(filename)) {
-        appFiles[filename] = source;
-      }
-    }
-    if (Object.keys(appFiles).length > 0) {
-      routeResult = extractRoutes(appFiles, {
-        slugPrefix: config.slug || 'app',
-      });
-    }
-  }
-
-  // Build child definitions: workflow + model IRs
-  const childDefinitions: IRWorkflowDefinition[] = [...workflowIRs, ...modelIRs];
-
-  // Build route table from page files (Phase 1 path or Phase 2 route-extractor)
-  let routeTable: RouteTableEntry[] = [];
-
-  if (routeResult) {
-    // Phase 2: use route-extractor results
-    routeTable = routeResult.routes.map(r => ({
-      path: r.path,
-      stateName: r.stateName,
-      sourceFile: r.sourceFile,
-      params: r.params,
-    }));
-    childDefinitions.push(routeResult.routerIR);
-  } else {
-    // Phase 1 fallback: derive routes from page files
-    const pageFiles: PageFile[] = [];
-    for (const filename of Object.keys(files)) {
-      if (isPageFile(filename)) {
-        pageFiles.push({
-          relativePath: filename,
-          absolutePath: filename,
-        });
-
-        const routePath = filename
-          .replace(/^pages\//, '')
-          .replace(/^app\//, '')
-          .replace(/\.(tsx?|jsx?)$/, '')
-          .replace(/\/index$/, '')
-          .replace(/\/page$/, '');
-
-        const stateName = pathToStateName(routePath);
-        const urlPattern = pathToUrlPattern(filename, filename.split('/').pop() || 'page.tsx');
-        const params = extractParams(filename);
-
-        routeTable.push({
-          path: urlPattern,
-          stateName,
-          sourceFile: filename,
-          params,
-        });
-      }
-    }
-
-    if (pageFiles.length > 0) {
-      const routerWorkflow = extractRouterWorkflow(pageFiles, {
-        slug: config.slug ? config.slug + '-router' : 'app-router',
-        pageFileName: pageFiles[0]?.relativePath.split('/').pop() || 'page.tsx',
-      });
-      childDefinitions.push(routerWorkflow);
-    }
-  }
-
-  // ── Route merging from resolved module dependencies ──────────────────────
-  if (options.resolvedModules && options.resolvedModules.length > 0) {
-    // Parse dependency routeConfig from mm.config.ts source
-    const depConfigs = parseDependencyRouteConfigs(files);
-
-    for (const mod of options.resolvedModules) {
-      const depConfig = depConfigs.get(mod.slug);
-      const prefix = depConfig?.prefix ?? `/${mod.slug.replace(/^mod-/, '')}`;
-      const routeOverrides = depConfig?.routes;
-
-      for (const modRoute of mod.routeTable) {
-        // Check per-route overrides
-        if (routeOverrides) {
-          const override = routeOverrides[modRoute.path];
-          if (override === false) continue; // disabled route
-          if (typeof override === 'string') {
-            // Remap to a different path
-            const existingPaths = new Set(routeTable.map(r => r.path));
-            if (!existingPaths.has(override)) {
-              routeTable.push({
-                path: override,
-                stateName: `MOD_${mod.slug.replace(/-/g, '_').toUpperCase()}_${modRoute.stateName}`,
-                sourceFile: modRoute.sourceFile,
-                params: modRoute.params,
-                moduleSlug: mod.slug,
-              });
-            }
-            continue;
-          }
-        }
-
-        // Default: prefix the module route
-        const prefixedPath = prefix + (modRoute.path === '/' ? '' : modRoute.path);
-        const existingPaths = new Set(routeTable.map(r => r.path));
-        if (!existingPaths.has(prefixedPath)) {
-          routeTable.push({
-            path: prefixedPath,
-            stateName: `MOD_${mod.slug.replace(/-/g, '_').toUpperCase()}_${modRoute.stateName}`,
-            sourceFile: modRoute.sourceFile,
-            params: modRoute.params,
-            moduleSlug: mod.slug,
-          });
-        }
-      }
-    }
-  }
-
-  // Merge all compilable IRs into parent blueprint
-  const allIRs = Object.values(fileIRs);
-  const parentIR = mergeIRs(allIRs, config);
-
-  // Attach composition metadata to parent
-  if (!parentIR.metadata) parentIR.metadata = {};
-  const parentMeta = parentIR.metadata as Record<string, unknown>;
-  parentMeta.childSlugs = childDefinitions.map(c => c.slug);
-  parentMeta.serverActions = serverActionEntries;
-  if (routeTable.length > 0) {
-    parentMeta.routeTable = routeTable;
-  }
-  parentMeta.composition = {
-    workflowCount: workflowIRs.length,
-    modelCount: modelIRs.length,
-    serverActionCount: serverActionEntries.length,
-    routeCount: routeTable.length,
-    componentCount: Object.keys(componentDefinitions).length,
-    totalFiles: Object.keys(files).length,
-  };
-
-  // Store component definitions in parent metadata for decompiler round-trip
-  if (Object.keys(componentDefinitions).length > 0) {
-    parentMeta.componentDefinitions = componentDefinitions;
-  }
-
-  // Phase 2: add action endpoints to metadata
-  if (actionResult) {
-    parentMeta.actionEndpoints = actionResult.actions.map(a => ({
-      actionId: a.actionId,
-      endpoint: a.endpoint,
-      group: a.group,
-    }));
-  }
-
-  // Extract rich manifest fields from mm.config.ts (routes, actions, slots, etc.)
-  // These are stored in metadata.module_manifest so the editor can display them.
-  // Everything is a workflow — the config file IS the manifest.
-  for (const [filename, source] of Object.entries(files)) {
-    if (isConfigFile(filename) || isModuleManifestFile(filename)) {
-      const manifest = parseModuleManifest(source);
-      if (manifest) {
-        parentMeta.module_manifest = manifest;
-      }
-      break;
-    }
-  }
-
-  // Store module dependencies with composition config (routeConfig, slotMapping)
-  const manifest = parentMeta.module_manifest as Record<string, unknown> | undefined;
-  if (manifest?.dependencies) {
-    parentMeta.module_dependencies = manifest.dependencies;
-  }
-
-  // Store slot contributions from manifest for runtime pre-population
-  if (manifest?.contributions) {
-    parentMeta.slot_contributions = manifest.contributions;
-  }
-
-  // Phase 2: Resolve cross-file import links
-  const compilableFiles = Object.keys(files).filter(isCompilableFile);
-  const importLinks = resolveImportLinks(files, compilableFiles);
-
-  // ── Extract page experiences from file IRs ──────────────────────────────────
-  const pageExperiences: Record<string, IRExperienceNode> = {};
-  for (const [filename, ir] of Object.entries(fileIRs)) {
-    if (isPageFile(filename)) {
-      const views = (ir as any).views as Record<string, IRExperienceNode> | undefined;
-      if (views?.default) {
-        pageExperiences[filename] = views.default;
-      }
-    }
-  }
-
-  // ── Set experience on parent IR (composed navigation with Router/Route atoms) ──
-  // When we have page experiences (app/*.tsx files), ALWAYS use Router/Route
-  // composition instead of the merged views (which flattens all pages into one Stack).
-  const parentViews = (parentIR as any).views as Record<string, IRExperienceNode> | undefined;
-  if (Object.keys(pageExperiences).length > 0) {
-    // Compose a routed experience from page experiences using Router/Route atoms
-    const pageEntries = Object.entries(pageExperiences);
-
-    // Build route paths from filenames
-    const routeNodes: IRExperienceNode[] = pageEntries.map(([pagePath, pageTree], i) => {
-      const routePath = '/' + pagePath
-        .replace(/^app\//, '')
-        .replace(/\.(tsx?|jsx?)$/, '')
-        .replace(/\/index$/, '')
-        .replace(/\/page$/, '');
-      return {
-        id: `route-${i}`,
-        component: 'Route',
-        config: { path: routePath },
-        children: [pageTree],
-      };
-    });
-
-    // Build navigation links
-    const navLinks: IRExperienceNode[] = pageEntries.map(([pagePath], i) => {
-      const routePath = '/' + pagePath
-        .replace(/^app\//, '')
-        .replace(/\.(tsx?|jsx?)$/, '')
-        .replace(/\/index$/, '')
-        .replace(/\/page$/, '');
-      const segments = routePath.split('/').filter(Boolean);
-      const label = segments[segments.length - 1]?.replace(/-/g, ' ').replace(/\b\w/g, c => c.toUpperCase()) || 'Home';
-      return {
-        id: `nav-link-${i}`,
-        component: 'NavLink',
-        config: { to: routePath, label },
-      };
-    });
-
-    // Add index route (renders first page at /)
-    routeNodes.unshift({
-      id: 'route-index',
-      component: 'Route',
-      config: { path: '/', exact: true },
-      children: [pageEntries[0][1]],
-    });
-
-    // ── Add module routes to the Router experience ─────────────────────────
-    const moduleRoutes = routeTable.filter(r => r.moduleSlug);
-    for (let mi = 0; mi < moduleRoutes.length; mi++) {
-      const mr = moduleRoutes[mi];
-      routeNodes.push({
-        id: `mod-route-${mi}`,
-        component: 'Route',
-        config: { path: mr.path },
-        children: [{
-          id: `mod-route-${mi}-placeholder`,
-          component: 'ModuleView',
-          config: { moduleSlug: mr.moduleSlug, sourceFile: mr.sourceFile, path: mr.path },
-        }],
-      });
-      // Add nav links for module routes
-      const segments = mr.path.split('/').filter(Boolean);
-      const label = segments[segments.length - 1]?.replace(/-/g, ' ').replace(/\b\w/g, c => c.toUpperCase()) || mr.moduleSlug;
-      navLinks.push({
-        id: `mod-nav-${mi}`,
-        component: 'NavLink',
-        config: { to: mr.path, label, moduleSlug: mr.moduleSlug },
-      });
-    }
-
-    const composedExperience: IRExperienceNode = {
-      id: 'blueprint-root',
-      component: 'Stack',
-      className: 'h-full flex flex-col',
-      children: [
-        // Nav bar (always visible, not inside Router so it always renders)
-        {
-          id: 'nav-bar',
-          component: 'Row',
-          config: { gap: 1 },
-          className: 'px-4 py-2 border-b border-border bg-background/95 backdrop-blur-sm sticky top-0 z-10 flex-wrap',
-          children: navLinks,
-        },
-        // Router with page routes
-        {
-          id: 'page-router',
-          component: 'Router',
-          className: 'flex-1 min-h-0 overflow-y-auto',
-          children: routeNodes.map(r => ({
-            ...r,
-            children: r.children?.map(child => ({
-              ...child,
-              id: child.id || r.id + '-content',
-              component: child.component || 'Stack',
-              config: { ...child.config, gap: 4, padding: 4 },
-            })),
-          })),
-        },
-      ],
-    };
-    (parentIR as any).experience = composedExperience;
-
-    // Add blueprint_manifest to metadata for BlueprintShell route resolution
-    const slug = config.slug || parentIR.slug || 'blueprint';
-    parentMeta.blueprint_manifest = {
-      routes: [
-        { path: `${slug}/*`, node: slug, label: config.name || parentIR.name || slug },
-      ],
-      config: {
-        full_bleed: true,
-      },
-    };
-  } else if (parentViews?.default) {
-    // Fallback: no page files, use merged views directly
-    (parentIR as any).experience = parentViews.default;
-  }
-
-  // ── Set experience on child definitions from their source file IRs ────────
-  for (const childDef of childDefinitions) {
-    // Find the source file IR that produced this child definition
-    for (const [filename, ir] of Object.entries(fileIRs)) {
-      if (ir.slug === childDef.slug || (isWorkflowFile(filename) && ir.slug === childDef.slug)) {
-        const views = (ir as any).views as Record<string, IRExperienceNode> | undefined;
-        if (views?.default) {
-          (childDef as any).experience = views.default;
-        }
-        break;
-      }
-    }
-  }
-
-  return {
-    ir: parentIR,
-    childDefinitions,
-    fileIRs,
-    routeTable,
-    serverActions: serverActionEntries,
-    errors,
-    warnings,
-    pageExperiences,
-    componentDefinitions,
-    importLinks,
-    modelResults,
-    actionResult,
-    routeResult,
-  };
-}
-
-// =============================================================================
-// Main API
-// =============================================================================
-
-/**
- * Compiles a multi-file project into a composed blueprint with child definitions.
- *
- * @param files - Record of filename → source code
- * @param options - Compilation options
- * @returns Composed result with parent IR, children, routes, actions, errors
- */
-export function compileProject(
-  files: Record<string, string>,
-  options: ProjectCompilerOptions = {},
-): ProjectCompilationResult {
-  const allErrors: ProjectCompilationError[] = [];
-  const allWarnings: ProjectCompilationError[] = [];
-  const fileIRs: Record<string, IRWorkflowDefinition> = {};
-
-  // 1. Parse mm.config.ts if present
-  let config: ParsedConfig = {};
-  for (const [filename, source] of Object.entries(files)) {
-    if (isConfigFile(filename)) {
-      config = parseConfig(source);
-      break;
-    }
-  }
-
-  // Resolve mode: config > options > default
-  const mode = config.mode || options.mode || 'infer';
-
-  // 2. Find compilable files
-  const compilableFiles = Object.keys(files).filter(isCompilableFile);
-
-  // 3. Resolve compilation order (dependencies first)
-  const orderedFiles = resolveCompilationOrder(files, compilableFiles);
-
-  // 4. Compile each file
-  for (const filename of orderedFiles) {
-    const source = files[filename];
-    const { ir, errors } = compileFile(filename, source, mode);
-
-    for (const e of errors) {
-      if (e.severity === 'error') allErrors.push(e);
-      else allWarnings.push(e);
-    }
-
-    if (ir) {
-      fileIRs[filename] = ir;
-    }
-  }
-
-  // 5. Build composed result with child definitions
-  return buildComposedResult(files, fileIRs, config, allErrors, allWarnings, {
-    usePhase2Modules: options.usePhase2Modules,
-    mode,
-    resolvedModules: options.resolvedModules,
-  });
-}
-
-// =============================================================================
-// Incremental Project Compiler (Phase 2 enhanced)
-// =============================================================================
-
-/**
- * Stateful project compiler that caches per-file IR results and only
- * recompiles files whose content has changed (hash-based invalidation).
- *
- * Phase 2 enhancements:
- *   - Uses IncrementalCache from incremental-compiler module
- *   - Dependency-aware invalidation (model change → workflow recompile)
- *   - Compilation statistics tracking
- */
-export class IncrementalProjectCompiler {
-  private cache: IncrementalCache<{ ir: IRWorkflowDefinition; errors: ProjectCompilationError[] }>;
-  private lastConfig: ParsedConfig = {};
-
-  constructor() {
-    this.cache = new IncrementalCache();
-  }
-
-  /**
-   * Compile a project incrementally — only recompiles changed files.
-   */
-  compile(
-    files: Record<string, string>,
-    options: ProjectCompilerOptions = {},
-  ): ProjectCompilationResult {
-    const startTime = Date.now();
-
-    // 1. Build dependency graph for dependency-aware invalidation
-    const { dependents } = buildDependencyGraph(files);
-
-    // 2. Detect dirty files (content changes + transitive dependents)
-    const dirtySet = this.cache.detectDirtyFiles(files, dependents);
-    const allDirty = new Set([
-      ...dirtySet.contentChanged,
-      ...dirtySet.dependencyDirty,
-      ...dirtySet.added,
-    ]);
-
-    // 3. Remove deleted files from cache
-    for (const removed of dirtySet.removed) {
-      this.cache.delete(removed);
-    }
-
-    // 4. If nothing changed and we have cached results, rebuild from cache
-    if (allDirty.size === 0 && this.cache.getCachedFiles().length > 0) {
-      this.cache.updateStats(0, this.cache.getCachedFiles().length, Date.now() - startTime);
-      return this.rebuildFromCache(files, options);
-    }
-
-    // 5. Parse config if changed
-    for (const [filename, source] of Object.entries(files)) {
-      if (isConfigFile(filename)) {
-        if (allDirty.has(filename)) {
-          this.lastConfig = parseConfig(source);
-        }
-        break;
-      }
-    }
-
-    // 6. Resolve mode
-    const mode = this.lastConfig.mode || options.mode || 'infer';
-
-    // 7. Find compilable files and compile dirty ones
-    const compilableFiles = Object.keys(files).filter(isCompilableFile);
-    let recompiled = 0;
-    let cacheHits = 0;
-
-    for (const filename of compilableFiles) {
-      if (allDirty.has(filename) || !this.cache.has(filename)) {
-        const { ir, errors } = compileFile(filename, files[filename], mode);
-        if (ir) {
-          this.cache.set(filename, files[filename], { ir, errors });
-        } else {
-          this.cache.delete(filename);
-        }
-        recompiled++;
-      } else {
-        cacheHits++;
-      }
-    }
-
-    // 8. Remove cached IRs for files no longer compilable
-    for (const cached of this.cache.getCachedFiles()) {
-      if (!compilableFiles.includes(cached)) {
-        this.cache.delete(cached);
-      }
-    }
-
-    // 9. Build composed result from all IRs
-    const fileIRs: Record<string, IRWorkflowDefinition> = {};
-    const allErrors: ProjectCompilationError[] = [];
-    const allWarnings: ProjectCompilationError[] = [];
-
-    for (const cached of this.cache.getCachedFiles()) {
-      const entry = this.cache.get(cached);
-      if (entry) {
-        fileIRs[cached] = entry.ir;
-        for (const e of entry.errors) {
-          if (e.severity === 'error') allErrors.push(e);
-          else allWarnings.push(e);
-        }
-      }
-    }
-
-    this.cache.updateStats(recompiled, cacheHits, Date.now() - startTime);
-
-    return buildComposedResult(files, fileIRs, this.lastConfig, allErrors, allWarnings, {
-      usePhase2Modules: options.usePhase2Modules,
-      mode,
-      resolvedModules: options.resolvedModules,
-    });
-  }
-
-  /**
-   * Rebuild result from cache without recompiling anything.
-   */
-  private rebuildFromCache(
-    files: Record<string, string>,
-    options: ProjectCompilerOptions,
-  ): ProjectCompilationResult {
-    let config = this.lastConfig;
-    if (!config.slug) {
-      for (const [filename, source] of Object.entries(files)) {
-        if (isConfigFile(filename)) {
-          config = parseConfig(source);
-          this.lastConfig = config;
-          break;
-        }
-      }
-    }
-
-    const fileIRs: Record<string, IRWorkflowDefinition> = {};
-    const allErrors: ProjectCompilationError[] = [];
-    const allWarnings: ProjectCompilationError[] = [];
-
-    for (const cached of this.cache.getCachedFiles()) {
-      const entry = this.cache.get(cached);
-      if (entry) {
-        fileIRs[cached] = entry.ir;
-        for (const e of entry.errors) {
-          if (e.severity === 'error') allErrors.push(e);
-          else allWarnings.push(e);
-        }
-      }
-    }
-
-    const mode = this.lastConfig.mode || options.mode || 'infer';
-    return buildComposedResult(files, fileIRs, config, allErrors, allWarnings, {
-      usePhase2Modules: options.usePhase2Modules,
-      mode,
-      resolvedModules: options.resolvedModules,
-    });
-  }
-
-  /** Invalidate a specific file's cache. */
-  invalidate(filename: string): void {
-    this.cache.delete(filename);
-  }
-
-  /** Invalidate all caches. */
-  invalidateAll(): void {
-    this.cache.clear();
-    this.lastConfig = {};
-  }
-
-  /** Check if a file would need recompilation given its current source. */
-  isDirty(filename: string, source: string): boolean {
-    hashContent(source); // Check content is hashable
-    const cached = this.cache.get(filename);
-    return !cached;
-  }
-
-  /** Get list of files currently in cache. */
-  getCachedFiles(): string[] {
-    return this.cache.getCachedFiles();
-  }
-
-  /** Get compilation statistics. */
-  getStats(): { cachedFiles: number; totalHashes: number } & IncrementalStats {
-    const stats = this.cache.getStats();
-    return {
-      cachedFiles: stats.totalCached,
-      totalHashes: stats.totalCached,
-      ...stats,
-    };
-  }
-}