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

package/src/decompiler/project.ts

@@ -1,862 +0,0 @@
-/**
- * project.ts — Multi-file project decompiler.
- *
- * Takes a full IRWorkflowDefinition and produces a project file tree:
- *   - main.workflow.tsx   (root layout + routing + state machine hooks)
- *   - pages/*.tsx         (separate page components per route/view)
- *   - models/*.ts         (TypeScript interfaces from field definitions)
- *   - actions/*.server.ts (server action stubs from transition actions)
- *   - mm.config.ts        (blueprint configuration: defineBlueprint)
- *
- * This is the multi-file counterpart to the single-file decompile() function.
- * It splits complex definitions into cohesive, focused files matching the
- * envelope fs-tree file role conventions (view-entry, page, model, server-action, config).
- */
-
-import type {
-  IRWorkflowDefinition,
-  IRExperienceNode,
-  IRFieldDefinition,
-  IRStateDefinition,
-  IRTransitionDefinition,
-  IRActionDefinition,
-} from '@mindmatrix/player-core';
-import { decompile } from './index';
-import type { DecompilerInput, DecompileOptions } from './index';
-import type { FileRole } from '../envelope/fs-tree';
-
-// =============================================================================
-// Public Types
-// =============================================================================
-
-/** A single file in the decompiled project. */
-export interface ProjectFile {
-  /** Relative path from project root (e.g. "main.workflow.tsx"). */
-  path: string;
-  /** File role matching the envelope fs-tree convention. */
-  role: FileRole;
-  /** Generated source code. */
-  content: string;
-}
-
-/** Result of decompiling a definition into a multi-file project. */
-export interface DecompileProjectResult {
-  /** All generated files. */
-  files: ProjectFile[];
-  /** The main entry file path. */
-  entryFile: string;
-  /** The slug used for naming. */
-  slug: string;
-}
-
-/** Options for project decompilation. */
-export interface DecompileProjectOptions extends DecompileOptions {
-  /** Skip generating mm.config.ts. Default: false. */
-  skipConfig?: boolean;
-  /** Skip generating model files. Default: false. */
-  skipModels?: boolean;
-  /** Skip generating server action stubs. Default: false. */
-  skipActions?: boolean;
-  /** Skip splitting pages into separate files. Default: false. */
-  skipPages?: boolean;
-  /** Skip decompiling child definitions into separate files. Default: false. */
-  skipChildren?: boolean;
-}
-
-// =============================================================================
-// Name Helpers
-// =============================================================================
-
-function pascalCase(slug: string): string {
-  return slug
-    .split(/[-_]/)
-    .map(part => part.charAt(0).toUpperCase() + part.slice(1).toLowerCase())
-    .join('');
-}
-
-function camelCase(str: string): string {
-  return str.replace(/[-_]([a-z])/g, (_, c: string) => c.toUpperCase());
-}
-
-/** Map IR field type to TypeScript type string, with union type support. */
-function fieldTypeToTS(fieldType: string, field?: IRFieldDefinition): string {
-  // Check for options → emit union type
-  const options = getFieldOptions(field);
-  if (options && options.length > 0 && (fieldType === 'select' || fieldType === 'text')) {
-    return options.map(o => `'${o.replace(/'/g, "\\'")}'`).join(' | ');
-  }
-
-  switch (fieldType) {
-    case 'text':
-    case 'rich_text':
-    case 'email':
-    case 'url':
-    case 'phone':
-    case 'color':
-    case 'select':
-      return 'string';
-    case 'number':
-    case 'currency':
-    case 'percentage':
-    case 'rating':
-    case 'duration':
-    case 'auto_number':
-      return 'number';
-    case 'boolean':
-      return 'boolean';
-    case 'date':
-    case 'datetime':
-    case 'created_at':
-    case 'updated_at':
-      return 'Date';
-    case 'multi_select':
-      return 'string[]';
-    case 'json':
-      return 'Record<string, unknown>';
-    case 'file':
-    case 'image':
-      return 'string'; // URL
-    case 'relation':
-    case 'lookup':
-      return 'string'; // ID reference
-    default:
-      return 'unknown';
-  }
-}
-
-/** Extracts options from field validation, metadata, or legacy field.options. */
-function getFieldOptions(field?: IRFieldDefinition): string[] | null {
-  if (!field) return null;
-  const f = field as unknown as Record<string, unknown>;
-  const validation = f.validation as Record<string, unknown> | undefined;
-  if (validation?.options && Array.isArray(validation.options)) return validation.options as string[];
-  const meta = f.metadata as Record<string, unknown> | undefined;
-  if (meta?.options && Array.isArray(meta.options)) return meta.options as string[];
-  if (f.options && Array.isArray(f.options)) return f.options as string[];
-  return null;
-}
-
-// =============================================================================
-// Model Generation
-// =============================================================================
-
-/**
- * Generates a TypeScript interface file from field definitions.
- *
- * Output example:
- *   export interface Invoice {
- *     amount: number;
- *     vendor: string;
- *     date: Date;
- *     status: string;
- *   }
- */
-function generateModelFile(
-  slug: string,
-  fields: IRFieldDefinition[],
-): string {
-  const typeName = pascalCase(slug);
-  const lines: string[] = [
-    `/**`,
-    ` * ${typeName} — data model interface.`,
-    ` *`,
-    ` * Auto-generated from workflow definition "${slug}".`,
-    ` * Fields: ${fields.length}`,
-    ` */`,
-    ``,
-    `export interface ${typeName} {`,
-  ];
-
-  for (const field of fields) {
-    const tsType = fieldTypeToTS(field.type, field);
-    const optional = field.required ? '' : '?';
-    const comment = field.label ? ` /** ${field.label} */` : '';
-    if (comment) lines.push(`  ${comment}`);
-    lines.push(`  ${camelCase(field.name)}${optional}: ${tsType};`);
-  }
-
-  lines.push(`}`);
-  lines.push(``);
-
-  // Export state enum if states exist (added by caller)
-  return lines.join('\n');
-}
-
-/**
- * Generates a state enum from state definitions.
- *
- * Output:
- *   export enum InvoiceState {
- *     Draft = 'draft',
- *     Submitted = 'submitted',
- *   }
- */
-function generateStateEnum(
-  slug: string,
-  states: IRStateDefinition[],
-): string {
-  if (states.length === 0) return '';
-
-  const enumName = `${pascalCase(slug)}State`;
-  const lines: string[] = [
-    ``,
-    `export enum ${enumName} {`,
-  ];
-
-  for (const state of states) {
-    const enumKey = pascalCase(state.name);
-    lines.push(`  ${enumKey} = '${state.name}',`);
-  }
-
-  lines.push(`}`);
-  lines.push(``);
-  return lines.join('\n');
-}
-
-// =============================================================================
-// Server Action Generation
-// =============================================================================
-
-/** Extracts unique server-side action types from states and transitions. */
-function extractServerActions(
-  states: IRStateDefinition[],
-  transitions: IRTransitionDefinition[],
-): Array<{ name: string; type: string; config: Record<string, unknown> }> {
-  const seen = new Set<string>();
-  const actions: Array<{ name: string; type: string; config: Record<string, unknown> }> = [];
-
-  const SERVER_ACTION_TYPES = new Set([
-    'http_request', 'webhook', 'call_webhook',
-    'notify', 'send_notification',
-    'call_workflow', 'spawn_instance', 'spawn_subworkflow',
-    'emit_event',
-  ]);
-
-  function collectFromActions(defs: IRActionDefinition[]) {
-    for (const action of defs) {
-      if (SERVER_ACTION_TYPES.has(action.type) && !seen.has(action.id)) {
-        seen.add(action.id);
-        const name = actionToFunctionName(action);
-        actions.push({ name, type: action.type, config: action.config });
-      }
-    }
-  }
-
-  for (const state of states) {
-    collectFromActions(state.on_enter);
-    collectFromActions(state.on_exit);
-    for (const during of state.during) {
-      collectFromActions(during.actions);
-    }
-  }
-  for (const trans of transitions) {
-    collectFromActions(trans.actions);
-  }
-
-  return actions;
-}
-
-function actionToFunctionName(action: IRActionDefinition): string {
-  // Use a descriptive name from config or fall back to type + id
-  const slug = (action.config.name ?? action.config.event ?? action.config.slug ?? action.type) as string;
-  return camelCase(String(slug).replace(/[^a-zA-Z0-9_-]/g, '-'));
-}
-
-/**
- * Generates a *.server.ts file with server action stubs.
- *
- * Output example:
- *   import type { TransitionContext } from '@mindmatrix/react';
- *
- *   export async function sendNotification(ctx: TransitionContext) {
- *     // TODO: Implement notification logic
- *   }
- */
-function generateServerActionFile(
-  actions: Array<{ name: string; type: string; config: Record<string, unknown> }>,
-): string {
-  const lines: string[] = [
-    `/**`,
-    ` * Server actions — backend handlers for workflow transitions.`,
-    ` *`,
-    ` * These functions run server-side during state transitions.`,
-    ` * Each receives a TransitionContext with instance data and utilities.`,
-    ` */`,
-    ``,
-    `import type { TransitionContext } from '@mindmatrix/react';`,
-    ``,
-  ];
-
-  for (const action of actions) {
-    const comment = actionComment(action.type, action.config);
-    lines.push(`/** ${comment} */`);
-    lines.push(`export async function ${action.name}(ctx: TransitionContext): Promise<void> {`);
-    lines.push(`  const { instance, env } = ctx;`);
-
-    // Emit a type-specific stub body
-    switch (action.type) {
-      case 'http_request':
-      case 'webhook':
-      case 'call_webhook': {
-        const url = String(action.config.url ?? 'https://api.example.com/webhook');
-        const method = String(action.config.method ?? 'POST');
-        lines.push(`  await fetch('${url}', {`);
-        lines.push(`    method: '${method}',`);
-        lines.push(`    headers: { 'Content-Type': 'application/json' },`);
-        lines.push(`    body: JSON.stringify({ instanceId: instance.id }),`);
-        lines.push(`  });`);
-        break;
-      }
-      case 'notify':
-      case 'send_notification': {
-        const msg = String(action.config.message ?? action.config.body ?? 'Notification');
-        lines.push(`  // Send notification: "${msg}"`);
-        lines.push(`  await env.notify({ message: '${msg}', instanceId: instance.id });`);
-        break;
-      }
-      case 'call_workflow':
-      case 'spawn_instance':
-      case 'spawn_subworkflow': {
-        const slug = String(action.config.slug ?? action.config.workflow ?? 'child-workflow');
-        lines.push(`  await env.spawn('${slug}', { parentId: instance.id });`);
-        break;
-      }
-      case 'emit_event': {
-        const event = String(action.config.event ?? action.config.name ?? 'custom-event');
-        lines.push(`  await env.emit('${event}', { instanceId: instance.id });`);
-        break;
-      }
-      default:
-        lines.push(`  // TODO: Implement ${action.type} logic`);
-    }
-
-    lines.push(`}`);
-    lines.push(``);
-  }
-
-  return lines.join('\n');
-}
-
-function actionComment(type: string, config: Record<string, unknown>): string {
-  switch (type) {
-    case 'http_request':
-    case 'webhook':
-    case 'call_webhook':
-      return `HTTP ${config.method ?? 'POST'} to ${config.url ?? 'webhook endpoint'}`;
-    case 'notify':
-    case 'send_notification':
-      return `Send notification: ${config.message ?? config.body ?? ''}`;
-    case 'call_workflow':
-    case 'spawn_instance':
-    case 'spawn_subworkflow':
-      return `Spawn child workflow: ${config.slug ?? config.workflow ?? ''}`;
-    case 'emit_event':
-      return `Emit event: ${config.event ?? config.name ?? ''}`;
-    default:
-      return `Server action: ${type}`;
-  }
-}
-
-// =============================================================================
-// Config Generation
-// =============================================================================
-
-/**
- * Generates mm.config.ts with defineBlueprint configuration.
- */
-function generateConfigFile(def: IRWorkflowDefinition): string {
-  const lines: string[] = [
-    `/**`,
-    ` * Blueprint configuration for "${def.name || pascalCase(def.slug)}".`,
-    ` */`,
-    ``,
-    `import { defineBlueprint } from '@mindmatrix/react';`,
-    ``,
-    `export default defineBlueprint({`,
-    `  slug: '${def.slug}',`,
-    `  name: '${(def.name || pascalCase(def.slug)).replace(/'/g, "\\'")}',`,
-    `  version: '${def.version}',`,
-    `  category: '${def.category}',`,
-  ];
-
-  if (def.description) {
-    lines.push(`  description: '${def.description.replace(/'/g, "\\'")}',`);
-  }
-
-  // Roles
-  if (def.roles && def.roles.length > 0) {
-    lines.push(`  roles: [`);
-    for (const role of def.roles) {
-      const perms = role.permissions.map(p => `'${p}'`).join(', ');
-      lines.push(`    { name: '${role.name}', permissions: [${perms}] },`);
-    }
-    lines.push(`  ],`);
-  }
-
-  lines.push(`});`);
-  lines.push(``);
-  return lines.join('\n');
-}
-
-// =============================================================================
-// Page Extraction
-// =============================================================================
-
-interface ExtractedPage {
-  /** Route path or state name this page represents. */
-  route: string;
-  /** PascalCase component name for the page. */
-  componentName: string;
-  /** The experience subtree for this page. */
-  tree: IRExperienceNode;
-  /** File path relative to project root. */
-  filePath: string;
-}
-
-/**
- * Extracts page components from an experience tree.
- *
- * Heuristics for page detection:
- * 1. Top-level children with visible_when conditions referencing route/state
- * 2. Children with id containing "page", "route", "view"
- * 3. Children wrapped in Show components with route conditions
- */
-function extractPages(
-  experience: IRExperienceNode | undefined,
-  slug: string,
-): ExtractedPage[] {
-  if (!experience || !experience.children) return [];
-
-  const pages: ExtractedPage[] = [];
-  const rootChildren = experience.children;
-
-  for (const child of rootChildren) {
-    // Check for route-conditional sections (visible_when with route/activeRoute)
-    const isRoutePage = child.visible_when && (
-      /activeRoute|route|isOn/i.test(child.visible_when)
-    );
-
-    // Check for page-like IDs
-    const isPageId = child.id && (
-      /page|route|view/i.test(child.id)
-    );
-
-    // Check for Show wrappers with route conditions
-    const isShowRoute = child.component === 'Show' && child.config?.when &&
-      /activeRoute|route/i.test(String(child.config.when));
-
-    if (isRoutePage || isPageId || isShowRoute) {
-      // Extract route name from visible_when or id
-      const routeName = extractRouteName(child) || child.id || `page-${pages.length}`;
-      const componentName = pascalCase(routeName.replace(/^\//, '').replace(/\//g, '-') || `${slug}-page`);
-
-      pages.push({
-        route: routeName,
-        componentName,
-        tree: child,
-        filePath: `pages/${componentName}.tsx`,
-      });
-    }
-  }
-
-  return pages;
-}
-
-function extractRouteName(node: IRExperienceNode): string {
-  // Try to extract route from visible_when: "activeRoute === '/dashboard'"
-  if (node.visible_when) {
-    const match = node.visible_when.match(/['"]\/([^'"]+)['"]/);
-    if (match) return match[1];
-    // Try: "isOnDashboard" → "dashboard"
-    const boolMatch = node.visible_when.match(/isOn([A-Z]\w+)/);
-    if (boolMatch) return boolMatch[1].toLowerCase();
-  }
-  // Try from Show when config
-  if (node.config?.when) {
-    const match = String(node.config.when).match(/['"]\/([^'"]+)['"]/);
-    if (match) return match[1];
-  }
-  return '';
-}
-
-// =============================================================================
-// Page File Generation
-// =============================================================================
-
-/**
- * Generates a page component TSX file from an extracted page.
- * Uses the single-file decompiler for the experience subtree.
- */
-function generatePageFile(page: ExtractedPage, _slug: string): string {
-  // Create a minimal definition with just the experience subtree
-  const pageInput: DecompilerInput = {
-    slug: page.route || 'page',
-    name: page.componentName,
-    version: '1.0.0',
-    category: 'page',
-    states: [],
-    transitions: [],
-    fields: [],
-    roles: [],
-    experience: page.tree,
-  };
-
-  const result = decompile(pageInput, {
-    componentName: page.componentName,
-    includeAnnotation: false,
-  });
-
-  return result.code;
-}
-
-// =============================================================================
-// Main Entry File Generation
-// =============================================================================
-
-/**
- * Generates the main.workflow.tsx file.
- *
- * When pages are extracted, this file contains:
- * - Field declarations (useState)
- * - State effects (useOnEnter/useOnExit)
- * - Transition declarations (useTransition)
- * - Page imports
- * - Root layout with page rendering
- */
-function generateMainFile(
-  def: DecompilerInput,
-  pages: ExtractedPage[],
-  hasModel: boolean,
-  serverActionNames: string[],
-  options?: DecompileOptions,
-): string {
-  // If no pages to split, use the single-file decompiler directly
-  if (pages.length === 0) {
-    const result = decompile(def, options);
-    return result.code;
-  }
-
-  // Build main file with page imports and layout
-  const slug = def.slug;
-  const componentName = options?.componentName ?? pascalCase(slug);
-
-  const importLines: string[] = [];
-
-  // Collect @mindmatrix/react imports based on what's used
-  const reactImports = new Set<string>();
-
-  // Fields need useState
-  const nonComputed = def.fields.filter(f => !f.computed);
-  if (nonComputed.length > 0) reactImports.add('useState');
-
-  // State effects
-  for (const state of def.states) {
-    if (state.on_enter.length > 0) reactImports.add('useOnEnter');
-    if (state.on_exit.length > 0) reactImports.add('useOnExit');
-    if (state.during.length > 0) reactImports.add('useWhileIn');
-  }
-
-  // Transitions
-  if (def.transitions.length > 0) reactImports.add('useTransition');
-
-  // Layout atoms for the root wrapper
-  reactImports.add('Stack');
-
-  if (reactImports.size > 0) {
-    const sorted = [...reactImports].sort();
-    importLines.push(`import { ${sorted.join(', ')} } from '@mindmatrix/react';`);
-  }
-
-  // Model import
-  if (hasModel) {
-    const typeName = pascalCase(slug);
-    importLines.push(`import type { ${typeName} } from './models/${slug}';`);
-  }
-
-  // Server action imports
-  if (serverActionNames.length > 0) {
-    const names = serverActionNames.join(', ');
-    importLines.push(`import { ${names} } from './actions/${slug}.server';`);
-  }
-
-  // Page imports
-  for (const page of pages) {
-    importLines.push(`import { ${page.componentName} } from './${page.filePath.replace(/\.tsx$/, '')}';`);
-  }
-
-  // Build component body lines
-  const bodyLines: string[] = [];
-
-  // Field declarations
-  for (const field of nonComputed) {
-    const name = camelCase(field.name);
-    const setter = `set${pascalCase(field.name)}`;
-    const defaultVal = fieldDefaultLiteral(field);
-    bodyLines.push(`  const [${name}, ${setter}] = useState(${defaultVal});`);
-  }
-
-  if (nonComputed.length > 0) bodyLines.push(``);
-
-  // State effects
-  for (const state of def.states) {
-    if (state.on_enter.length > 0) {
-      const actions = state.on_enter.map(a => actionToInlineCode(a)).filter(Boolean);
-      bodyLines.push(`  useOnEnter('${state.name}', () => {`);
-      for (const a of actions) bodyLines.push(`    ${a}`);
-      bodyLines.push(`  });`);
-    }
-    if (state.on_exit.length > 0) {
-      const actions = state.on_exit.map(a => actionToInlineCode(a)).filter(Boolean);
-      bodyLines.push(`  useOnExit('${state.name}', () => {`);
-      for (const a of actions) bodyLines.push(`    ${a}`);
-      bodyLines.push(`  });`);
-    }
-  }
-
-  // Transitions
-  for (const trans of def.transitions) {
-    const varName = camelCase(trans.name);
-    const from = trans.from.length === 1
-      ? `'${trans.from[0]}'`
-      : `[${trans.from.map(f => `'${f}'`).join(', ')}]`;
-    bodyLines.push(`  const ${varName} = useTransition('${trans.name}', { from: ${from}, to: '${trans.to}' });`);
-  }
-
-  if (def.transitions.length > 0) bodyLines.push(``);
-
-  // Build root layout JSX with page rendering
-  bodyLines.push(`  return (`);
-  bodyLines.push(`    <Stack sx={{ minHeight: '100vh' }}>`);
-  for (const page of pages) {
-    bodyLines.push(`      <${page.componentName} />`);
-  }
-  bodyLines.push(`    </Stack>`);
-  bodyLines.push(`  );`);
-
-  // Assemble file
-  const lines: string[] = [
-    ...importLines,
-    ``,
-    `/**`,
-    ` * @workflow slug="${slug}" version="${def.version}" category="${def.category}"`,
-    ...(def.description ? [` * @description ${def.description}`] : []),
-    ` */`,
-    `export default function ${componentName}() {`,
-    ...bodyLines,
-    `}`,
-    ``,
-  ];
-
-  return lines.join('\n');
-}
-
-function fieldDefaultLiteral(field: IRFieldDefinition): string {
-  if (field.default_value !== undefined) {
-    if (typeof field.default_value === 'string') return `'${field.default_value}'`;
-    return JSON.stringify(field.default_value);
-  }
-  switch (field.type) {
-    case 'text': case 'rich_text': case 'email': case 'url': case 'phone':
-    case 'color': case 'select':
-      return "''";
-    case 'number': case 'currency': case 'percentage': case 'rating':
-    case 'duration': case 'auto_number':
-      return '0';
-    case 'boolean':
-      return 'false';
-    case 'date': case 'datetime':
-      return 'null';
-    case 'multi_select': case 'json':
-      return '[]';
-    default:
-      return 'null';
-  }
-}
-
-function actionToInlineCode(action: IRActionDefinition): string {
-  switch (action.type) {
-    case 'set_field': {
-      const field = String(action.config.field ?? '');
-      const setter = `set${pascalCase(field)}`;
-      const val = action.config.expression
-        ? String(action.config.expression)
-        : JSON.stringify(action.config.value ?? null);
-      return `${setter}(${val});`;
-    }
-    case 'log_event':
-    case 'log':
-      return `console.log('${action.config.message ?? action.config.event ?? action.type}');`;
-    case 'noop':
-      return '';
-    default:
-      return `// ${action.type}: ${JSON.stringify(action.config)}`;
-  }
-}
-
-// =============================================================================
-// Main: decompileProject
-// =============================================================================
-
-/**
- * Decompiles an IR definition into a multi-file project structure.
- *
- * Produces files matching the envelope fs-tree file role conventions:
- *   - main.workflow.tsx   → view-entry (root layout + state machine)
- *   - pages/*.tsx         → page (per-route components)
- *   - models/<slug>.ts    → model (TypeScript interfaces)
- *   - actions/<slug>.server.ts → server-action (backend handlers)
- *   - mm.config.ts        → config (defineBlueprint)
- *
- * For simple definitions (no states/transitions/models), falls back
- * to single-file output in main.workflow.tsx.
- */
-export function decompileProject(
-  definition: DecompilerInput,
-  options?: DecompileProjectOptions,
-): DecompileProjectResult {
-  const files: ProjectFile[] = [];
-  const slug = definition.slug;
-
-  // 1. Extract pages from experience tree
-  const pages = options?.skipPages
-    ? []
-    : extractPages(definition.experience, slug);
-
-  // 2. Extract server actions from states + transitions
-  const serverActions = options?.skipActions
-    ? []
-    : extractServerActions(definition.states, definition.transitions);
-
-  // 3. Generate model file
-  const hasFields = definition.fields.length > 0;
-  if (hasFields && !options?.skipModels) {
-    let modelContent = generateModelFile(slug, definition.fields);
-    if (definition.states.length > 0) {
-      modelContent += generateStateEnum(slug, definition.states);
-    }
-    files.push({
-      path: `models/${slug}.ts`,
-      role: 'model',
-      content: modelContent,
-    });
-  }
-
-  // 4. Generate server action file
-  if (serverActions.length > 0) {
-    files.push({
-      path: `actions/${slug}.server.ts`,
-      role: 'server-action',
-      content: generateServerActionFile(serverActions),
-    });
-  }
-
-  // 5. Generate page files
-  for (const page of pages) {
-    files.push({
-      path: page.filePath,
-      role: 'page',
-      content: generatePageFile(page, slug),
-    });
-  }
-
-  // 6. Generate config file
-  if (!options?.skipConfig) {
-    files.push({
-      path: 'mm.config.ts',
-      role: 'config',
-      content: generateConfigFile(definition),
-    });
-  }
-
-  // 7. Decompile child definitions into separate .workflow.tsx files
-  //    Each child becomes its own file in the project (UBER-SCALE support)
-  if (definition.childDefinitions && definition.childDefinitions.length > 0) {
-    for (const child of definition.childDefinitions) {
-      const childSlug = child.slug;
-      const childFileName = `${childSlug}.workflow.tsx`;
-
-      // Build a DecompilerInput from the child definition
-      const childInput: DecompilerInput = {
-        ...child,
-        experience: (child as any).views?.default as IRExperienceNode | undefined,
-      };
-
-      // Generate model files for child data definitions
-      if (child.category === 'data' && child.fields.length > 0 && !options?.skipModels) {
-        let childModelContent = generateModelFile(childSlug, child.fields);
-        if (child.states.length > 0) {
-          childModelContent += generateStateEnum(childSlug, child.states);
-        }
-        files.push({
-          path: `models/${childSlug}.ts`,
-          role: 'model',
-          content: childModelContent,
-        });
-      }
-
-      // Generate server action files for child workflows with server actions
-      if (!options?.skipActions) {
-        const childServerActions = extractServerActions(child.states, child.transitions);
-        if (childServerActions.length > 0) {
-          files.push({
-            path: `actions/${childSlug}.server.ts`,
-            role: 'server-action',
-            content: generateServerActionFile(childServerActions),
-          });
-        }
-      }
-
-      // Generate the child workflow file itself
-      const childResult = decompile(childInput, {
-        componentName: pascalCase(childSlug),
-        includeAnnotation: true,
-      });
-
-      files.push({
-        path: childFileName,
-        role: 'view-entry',
-        content: childResult.code,
-      });
-    }
-  }
-
-  // 8. Generate main entry file
-  const mainContent = generateMainFile(
-    definition,
-    pages,
-    hasFields && !options?.skipModels,
-    serverActions.map(a => a.name),
-    options,
-  );
-
-  files.push({
-    path: 'main.workflow.tsx',
-    role: 'view-entry',
-    content: mainContent,
-  });
-
-  return {
-    files,
-    entryFile: 'main.workflow.tsx',
-    slug,
-  };
-}
-
-/**
- * Returns true if a definition is complex enough to warrant multi-file output.
- *
- * Criteria: has states + transitions + either fields or experience tree.
- */
-export function shouldDecompileAsProject(def: IRWorkflowDefinition): boolean {
-  // Check for child definitions in metadata (UBER-SCALE projects)
-  const meta = def.metadata as Record<string, unknown> | undefined;
-  const childSlugs = meta?.childSlugs;
-  const hasChildren = Array.isArray(childSlugs) && childSlugs.length > 0;
-
-  return (
-    hasChildren ||
-    (def.states.length > 1 &&
-      def.transitions.length > 0 &&
-      (def.fields.length > 0 || def.category === 'blueprint'))
-  );
-}