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

package/src/cli/installer.ts

@@ -1,261 +0,0 @@
-/**
- * Installer — handles install, list, update, and remove commands.
- *
- * Modes:
- *   type-only (default): writes .d.ts to node_modules/@mm/<slug>/
- *   full: uses project decompiler to generate full source in packages/<slug>/
- */
-
-import { mkdirSync, writeFileSync, existsSync, rmSync } from 'fs';
-import { join, dirname } from 'path';
-import { fetchDefinition, searchDefinitions } from './registry-client';
-import type { RegistryConfig, WorkflowDefinitionResponse } from './registry-client';
-import { generateTypeDeclaration, generateFullSource } from './type-generator';
-import { readLockFile, upsertLockEntry, removeLockEntry } from './lock-file';
-import type { LockData } from './lock-file';
-
-export interface InstallOptions {
-  slug: string;
-  mode: 'type-only' | 'full';
-  config: RegistryConfig;
-  cwd?: string;
-}
-
-export interface InstallResult {
-  slug: string;
-  version: string;
-  mode: 'type-only' | 'full';
-  filesWritten: string[];
-}
-
-export interface ListResult {
-  entries: LockData;
-}
-
-/**
- * Install a workflow definition package.
- */
-export async function install(options: InstallOptions): Promise<InstallResult> {
-  const { slug, mode, config } = options;
-  const cwd = options.cwd ?? process.cwd();
-
-  console.log(`[mmrc] Installing ${slug}...`);
-
-  // 1. Fetch definition from registry
-  const def = await fetchDefinition(slug, config);
-  const version = def.version || '1.0.0';
-
-  console.log(`  Found: ${def.name || def.slug} v${version} (${def.category || 'workflow'})`);
-  console.log(`  Fields: ${def.fields?.length ?? 0}, States: ${def.states?.length ?? 0}, Transitions: ${def.transitions?.length ?? 0}`);
-
-  const filesWritten: string[] = [];
-
-  if (mode === 'full') {
-    filesWritten.push(...installFull(def, cwd));
-  } else {
-    filesWritten.push(...installTypeOnly(def, cwd));
-  }
-
-  // 4. Update lock file
-  const content = mode === 'full' ? generateFullSource(def) : generateTypeDeclaration(def);
-  upsertLockEntry(cwd, slug, version, mode, content);
-
-  console.log(`\n[mmrc] Installed ${slug}@${version} (${mode})`);
-  for (const f of filesWritten) {
-    console.log(`  + ${f}`);
-  }
-
-  return { slug, version, mode, filesWritten };
-}
-
-/**
- * Install type-only: write .d.ts to node_modules/@mm/<slug>/
- */
-function installTypeOnly(
-  def: WorkflowDefinitionResponse,
-  cwd: string,
-): string[] {
-  const packageDir = join(cwd, 'node_modules', '@mm', def.slug);
-  mkdirSync(packageDir, { recursive: true });
-
-  // Generate type declaration
-  const dts = generateTypeDeclaration(def);
-  const dtsPath = join(packageDir, 'index.d.ts');
-  writeFileSync(dtsPath, dts, 'utf-8');
-
-  // Generate a minimal package.json for resolution
-  const pkgJson = {
-    name: `@mm/${def.slug}`,
-    version: def.version || '1.0.0',
-    types: './index.d.ts',
-    main: './index.js',
-  };
-  writeFileSync(join(packageDir, 'package.json'), JSON.stringify(pkgJson, null, 2) + '\n', 'utf-8');
-
-  // Generate a minimal index.js stub (for runtime resolution)
-  const jsStub = [
-    `// Auto-generated stub for @mm/${def.slug}`,
-    `// This package provides type information only.`,
-    `// The actual runtime comes from the workflow engine.`,
-    `module.exports = { slug: '${def.slug}', version: '${def.version || '1.0.0'}' };`,
-    '',
-  ].join('\n');
-  writeFileSync(join(packageDir, 'index.js'), jsStub, 'utf-8');
-
-  return [
-    `node_modules/@mm/${def.slug}/index.d.ts`,
-    `node_modules/@mm/${def.slug}/package.json`,
-    `node_modules/@mm/${def.slug}/index.js`,
-  ];
-}
-
-/**
- * Install full: use decompiler to generate project files.
- */
-function installFull(
-  def: WorkflowDefinitionResponse,
-  cwd: string,
-): string[] {
-  const outDir = join(cwd, 'packages', def.slug);
-  mkdirSync(outDir, { recursive: true });
-
-  const filesWritten: string[] = [];
-
-  // Try to use the project decompiler for full source
-  try {
-    // Dynamic import to avoid circular dependency at module level
-    // eslint-disable-next-line @typescript-eslint/no-require-imports
-    const { decompileProjectEnhanced } = require('../decompiler/project-decompiler');
-    const result = decompileProjectEnhanced(def);
-
-    for (const file of result.files) {
-      const filePath = join(outDir, file.path);
-      mkdirSync(dirname(filePath), { recursive: true });
-      writeFileSync(filePath, file.content, 'utf-8');
-      filesWritten.push(`packages/${def.slug}/${file.path}`);
-    }
-  } catch {
-    // Fallback: generate a basic source file
-    console.log('  (decompiler unavailable, generating basic source)');
-    const source = generateFullSource(def);
-    const indexPath = join(outDir, 'index.ts');
-    writeFileSync(indexPath, source, 'utf-8');
-    filesWritten.push(`packages/${def.slug}/index.ts`);
-
-    // Generate package.json
-    const pkgJson = {
-      name: `@mm/${def.slug}`,
-      version: def.version || '1.0.0',
-      main: './index.ts',
-      types: './index.ts',
-    };
-    writeFileSync(join(outDir, 'package.json'), JSON.stringify(pkgJson, null, 2) + '\n', 'utf-8');
-    filesWritten.push(`packages/${def.slug}/package.json`);
-  }
-
-  return filesWritten;
-}
-
-/**
- * List all installed workflow packages.
- */
-export function list(cwd?: string): ListResult {
-  const dir = cwd ?? process.cwd();
-  const entries = readLockFile(dir);
-  return { entries };
-}
-
-/**
- * Update all installed packages (re-fetch and regenerate).
- */
-export async function update(config: RegistryConfig, cwd?: string): Promise<InstallResult[]> {
-  const dir = cwd ?? process.cwd();
-  const entries = readLockFile(dir);
-  const slugs = Object.keys(entries);
-
-  if (slugs.length === 0) {
-    console.log('[mmrc] No packages installed. Use `mmrc install <slug>` first.');
-    return [];
-  }
-
-  console.log(`[mmrc] Updating ${slugs.length} package(s)...`);
-  const results: InstallResult[] = [];
-
-  for (const slug of slugs) {
-    const entry = entries[slug];
-    try {
-      const result = await install({
-        slug,
-        mode: entry.mode,
-        config,
-        cwd: dir,
-      });
-      results.push(result);
-    } catch (err) {
-      console.error(`  x Failed to update ${slug}: ${err instanceof Error ? err.message : String(err)}`);
-    }
-  }
-
-  console.log(`\n[mmrc] Updated ${results.length}/${slugs.length} package(s).`);
-  return results;
-}
-
-/**
- * Remove an installed package.
- */
-export function remove(slug: string, cwd?: string): boolean {
-  const dir = cwd ?? process.cwd();
-  const entries = readLockFile(dir);
-
-  if (!(slug in entries)) {
-    console.error(`[mmrc] Package "${slug}" is not installed.`);
-    return false;
-  }
-
-  const entry = entries[slug];
-
-  // Remove files based on mode
-  if (entry.mode === 'type-only') {
-    const packageDir = join(dir, 'node_modules', '@mm', slug);
-    if (existsSync(packageDir)) {
-      rmSync(packageDir, { recursive: true, force: true });
-    }
-  } else {
-    const packageDir = join(dir, 'packages', slug);
-    if (existsSync(packageDir)) {
-      rmSync(packageDir, { recursive: true, force: true });
-    }
-  }
-
-  // Remove lock entry
-  removeLockEntry(dir, slug);
-  console.log(`[mmrc] Removed ${slug}.`);
-
-  return true;
-}
-
-/**
- * Search for available workflow definitions.
- */
-export async function search(query: string, config: RegistryConfig): Promise<void> {
-  console.log(`[mmrc] Searching for "${query}"...`);
-
-  const results = await searchDefinitions(query, config);
-
-  if (results.length === 0) {
-    console.log('  No definitions found.');
-    return;
-  }
-
-  console.log(`  Found ${results.length} definition(s):\n`);
-  for (const def of results) {
-    const fieldCount = def.fields?.length ?? 0;
-    const stateCount = def.states?.length ?? 0;
-    console.log(`  ${def.slug} v${def.version || '1.0.0'} — ${def.name || '(unnamed)'}`);
-    console.log(`    ${def.category || 'workflow'} | ${fieldCount} fields, ${stateCount} states`);
-    if (def.description) {
-      console.log(`    ${def.description}`);
-    }
-    console.log('');
-  }
-}

package/src/cli/lock-file.ts

@@ -1,94 +0,0 @@
-/**
- * mm.lock — Lock file management for installed workflow packages.
- *
- * Simple JSON lock file that tracks installed packages, versions, and modes.
- */
-
-import { readFileSync, writeFileSync, existsSync } from 'fs';
-import { join } from 'path';
-import { createHash } from 'crypto';
-
-export interface LockEntry {
-  slug: string;
-  version: string;
-  installedAt: string;
-  mode: 'type-only' | 'full';
-  hash: string;
-}
-
-export type LockData = Record<string, LockEntry>;
-
-const LOCK_FILENAME = 'mm.lock';
-
-/**
- * Read the lock file from the given directory.
- * Returns an empty object if the lock file doesn't exist.
- */
-export function readLockFile(dir: string): LockData {
-  const lockPath = join(dir, LOCK_FILENAME);
-  if (!existsSync(lockPath)) {
-    return {};
-  }
-
-  try {
-    const content = readFileSync(lockPath, 'utf-8');
-    return JSON.parse(content) as LockData;
-  } catch {
-    // Corrupted lock file — start fresh
-    return {};
-  }
-}
-
-/**
- * Write the lock file to the given directory.
- */
-export function writeLockFile(dir: string, entries: LockData): void {
-  const lockPath = join(dir, LOCK_FILENAME);
-
-  // Sort keys for deterministic output
-  const sorted: LockData = {};
-  for (const key of Object.keys(entries).sort()) {
-    sorted[key] = entries[key];
-  }
-
-  writeFileSync(lockPath, JSON.stringify(sorted, null, 2) + '\n', 'utf-8');
-}
-
-/**
- * Add or update a lock entry.
- */
-export function upsertLockEntry(
-  dir: string,
-  slug: string,
-  version: string,
-  mode: 'type-only' | 'full',
-  content: string,
-): void {
-  const entries = readLockFile(dir);
-  entries[slug] = {
-    slug,
-    version,
-    installedAt: new Date().toISOString(),
-    mode,
-    hash: computeHash(content),
-  };
-  writeLockFile(dir, entries);
-}
-
-/**
- * Remove a lock entry.
- */
-export function removeLockEntry(dir: string, slug: string): boolean {
-  const entries = readLockFile(dir);
-  if (!(slug in entries)) return false;
-  delete entries[slug];
-  writeLockFile(dir, entries);
-  return true;
-}
-
-/**
- * Compute a content hash for change detection.
- */
-export function computeHash(content: string): string {
-  return createHash('sha256').update(content).digest('hex').slice(0, 16);
-}

package/src/cli/mmrc.ts

@@ -1,22 +0,0 @@
-#!/usr/bin/env node
-/**
- * mmrc — MindMatrix React Compiler CLI
- *
- * This is an alias entry point. The actual CLI logic lives in ./index.ts.
- *
- * Commands:
- *   mmrc dev      Start dev server with hot reload
- *   mmrc build    Compile workflow files to Pure Form IR
- *   mmrc test     Run workflow test files
- *   mmrc deploy   Compile + upload workflows to backend DB
- *   mmrc pull     Fetch a definition from DB and scaffold local project
- *   mmrc install  <slug>         Install a workflow definition (type-only by default)
- *   mmrc install  <slug> --full  Install with full source code
- *   mmrc list                    List installed workflow packages
- *   mmrc update                  Update all installed packages
- *   mmrc remove   <slug>         Remove an installed package
- *   mmrc search   <query>        Search available definitions
- */
-
-// Re-export from main CLI entry point
-import './index';

package/src/cli/pull.ts

@@ -1,172 +0,0 @@
-/**
- * CLI Pull Command — fetches a workflow definition from DB and scaffolds
- * a local React framework project.
- *
- * Usage:
- *   mmrc pull <slug> --api-url http://... --token TOKEN --out ./my-project
- *
- * Pipeline:
- *   GET /api/v1/workflow/definitions?slug=<slug>
- *     → IRWorkflowDefinition
- *     → project-decompiler
- *     → local files (mm.config.ts, main.workflow.tsx, pages/, models/)
- */
-
-import { mkdirSync, writeFileSync } from 'fs';
-import { join, dirname } from 'path';
-import { decompileProjectEnhanced as decompileProject } from '../decompiler/project-decompiler';
-import type { IRWorkflowDefinition } from '@mindmatrix/player-core';
-
-export interface PullOptions {
-  slug: string;
-  apiUrl: string;
-  token: string;
-  outDir?: string;
-}
-
-export interface PullResult {
-  slug: string;
-  filesWritten: string[];
-  outDir: string;
-}
-
-export async function pull(options: PullOptions): Promise<PullResult> {
-  const { slug, apiUrl, token } = options;
-  const outDir = options.outDir ?? slug;
-
-  console.log(`[mmrc pull] Fetching "${slug}" from ${apiUrl}...`);
-
-  // 1. Fetch the definition from the API
-  const ir = await fetchDefinition(apiUrl, token, slug);
-  if (!ir) {
-    throw new Error(`Definition "${slug}" not found`);
-  }
-
-  console.log(`  Found: ${ir.name || ir.slug} (${ir.category || 'workflow'}, v${ir.version || '1.0.0'})`);
-  console.log(`  Fields: ${ir.fields?.length ?? 0}, States: ${ir.states?.length ?? 0}, Transitions: ${ir.transitions?.length ?? 0}`);
-
-  // 2. Decompile to project files
-  const result = decompileProject(ir);
-
-  // 3. Write files to disk
-  mkdirSync(outDir, { recursive: true });
-  const filesWritten: string[] = [];
-
-  for (const file of result.files) {
-    const filePath = join(outDir, file.path);
-    mkdirSync(dirname(filePath), { recursive: true });
-    writeFileSync(filePath, file.content, 'utf-8');
-    filesWritten.push(file.path);
-    console.log(`  + ${file.path}`);
-  }
-
-  console.log(`\n[mmrc pull] Scaffolded ${filesWritten.length} files in ${outDir}/`);
-  console.log(`  Entry: ${result.entryFile}`);
-  console.log(`\n  Next steps:`);
-  console.log(`    cd ${outDir}`);
-  console.log(`    mmrc dev --src .`);
-  console.log(`    # Edit files, then deploy back:`);
-  console.log(`    mmrc deploy --src . --api-url ${apiUrl} --token <token>`);
-
-  return { slug, filesWritten, outDir };
-}
-
-// =============================================================================
-// API fetch
-// =============================================================================
-
-async function fetchDefinition(
-  apiUrl: string,
-  token: string,
-  slug: string,
-): Promise<IRWorkflowDefinition | null> {
-  // Try by slug first
-  const bySlug = await tryFetch(`${apiUrl}/workflow/definitions?slug=${encodeURIComponent(slug)}`, token);
-  if (bySlug) return bySlug;
-
-  // Try the definitions endpoint with search
-  const bySearch = await tryFetch(`${apiUrl}/workflow/catalog/search?q=${encodeURIComponent(slug)}`, token);
-  if (bySearch) return bySearch;
-
-  // Try modules endpoint (for category=module definitions)
-  const modulesRes = await fetch(`${apiUrl}/modules`, {
-    headers: { Authorization: `Bearer ${token}` },
-  });
-  if (modulesRes.ok) {
-    const modules = await modulesRes.json() as any[];
-    const mod = modules.find((m: any) => m.module_id === slug || m.name?.toLowerCase() === slug.toLowerCase());
-    if (mod) {
-      // Re-fetch the full definition by ID
-      const fullRes = await fetch(`${apiUrl}/workflow/definitions/${mod.module_id}`, {
-        headers: { Authorization: `Bearer ${token}` },
-      });
-      if (fullRes.ok) {
-        return normalizeApiResponse(await fullRes.json());
-      }
-    }
-  }
-
-  return null;
-}
-
-async function tryFetch(url: string, token: string): Promise<IRWorkflowDefinition | null> {
-  try {
-    const res = await fetch(url, {
-      headers: { Authorization: `Bearer ${token}` },
-    });
-    if (!res.ok) return null;
-
-    const data = await res.json() as any;
-
-    // Handle array responses (search/list endpoints)
-    if (Array.isArray(data)) {
-      if (data.length === 0) return null;
-      return normalizeApiResponse(data[0]);
-    }
-
-    // Handle paginated responses (items or data key)
-    const items = data.items ?? data.data;
-    if (items && Array.isArray(items)) {
-      if (items.length === 0) return null;
-      return normalizeApiResponse(items[0]);
-    }
-
-    // Direct object
-    return normalizeApiResponse(data);
-  } catch {
-    return null;
-  }
-}
-
-/**
- * Normalize API response to IRWorkflowDefinition shape.
- * Backend uses `view` for experience tree, IR uses `metadata.experience`.
- */
-function normalizeApiResponse(def: any): IRWorkflowDefinition {
-  const ir: any = {
-    slug: def.slug,
-    name: def.name,
-    version: def.version || '1.0.0',
-    description: def.description || '',
-    category: def.category || 'workflow',
-    fields: def.fields || [],
-    states: def.states || [],
-    transitions: def.transitions || [],
-    roles: def.roles || [],
-    on_event: def.on_event || [],
-    metadata: {
-      ...(def.metadata || {}),
-    },
-  };
-
-  // The experience tree may be in `view`, `experience`, or `metadata.experience`
-  // Must set ir.experience at top level — the decompiler checks definition.experience
-  const experience = def.view || def.experience || def.metadata?.experience;
-  if (experience) {
-    ir.experience = experience;
-    ir.metadata.experience = experience;
-    ir.view = experience;
-  }
-
-  return ir as IRWorkflowDefinition;
-}