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

package/src/cli/deploy.ts

@@ -1,206 +0,0 @@
-/**
- * CLI Deploy Command — uploads compiled workflow definitions to the backend.
- *
- * Deployment rules:
- * 1. If definition is new → create it
- * 2. If definition exists and has no instances → update in place
- * 3. If definition exists and has instances → create NEW version (immutability)
- *
- * The deploy command checks existing definitions via the API and
- * applies the correct strategy automatically.
- */
-
-import { glob } from 'glob';
-import { readFileSync, writeFileSync } from 'fs';
-import { basename } from 'path';
-
-export interface DeployOptions {
-  apiUrl: string;
-  token: string;
-  dir?: string;
-  /** Force update even if instances exist (bypasses immutability). */
-  force?: boolean;
-  /** Dry run — show what would happen without making changes. */
-  dryRun?: boolean;
-  /** Write deploy report to this file. */
-  reportFile?: string;
-}
-
-export interface DeployResult {
-  created: string[];
-  updated: string[];
-  versioned: string[];
-  skipped: string[];
-  failed: { slug: string; error: string }[];
-}
-
-interface ExistingDefinition {
-  id: string;
-  slug: string;
-  version: string;
-  instanceCount: number;
-}
-
-export async function deploy(options: DeployOptions): Promise<DeployResult> {
-  const dir = options.dir ?? 'dist/workflows';
-
-  console.log(`[mindmatrix-react] Deploying workflows from ${dir} to ${options.apiUrl}...`);
-
-  // Find all compiled workflow files
-  const files = await glob(`${dir}/**/*.workflow.json`);
-
-  if (files.length === 0) {
-    console.log(`[mindmatrix-react] No workflow files found in ${dir}`);
-    return { created: [], updated: [], versioned: [], skipped: [], failed: [] };
-  }
-
-  const result: DeployResult = {
-    created: [],
-    updated: [],
-    versioned: [],
-    skipped: [],
-    failed: [],
-  };
-
-  for (const file of files) {
-    try {
-      const ir = JSON.parse(readFileSync(file, 'utf-8'));
-      const slug = ir.slug;
-
-      if (options.dryRun) {
-        console.log(`  [dry-run] Would deploy ${slug} (${basename(file)})`);
-        continue;
-      }
-
-      // Check if definition already exists
-      const existing = await fetchExistingDefinition(options.apiUrl, options.token, slug);
-
-      if (!existing) {
-        // New definition — create it
-        await createDefinition(options.apiUrl, options.token, ir);
-        console.log(`  ✓ ${slug} (created)`);
-        result.created.push(slug);
-      } else if (existing.instanceCount === 0 || options.force) {
-        // No instances or force mode — update in place
-        await updateDefinition(options.apiUrl, options.token, existing.id, ir);
-        console.log(`  ✓ ${slug} (updated)`);
-        result.updated.push(slug);
-      } else {
-        // Has instances — create new version (immutability)
-        const newVersion = bumpVersion(existing.version);
-        ir.version = newVersion;
-        await createDefinition(options.apiUrl, options.token, ir);
-        console.log(`  ✓ ${slug} v${newVersion} (new version, ${existing.instanceCount} instances on v${existing.version})`);
-        result.versioned.push(slug);
-      }
-    } catch (error) {
-      const slug = basename(file).replace('.workflow.json', '');
-      const msg = (error as Error).message;
-      console.error(`  ✗ ${slug}: ${msg}`);
-      result.failed.push({ slug, error: msg });
-    }
-  }
-
-  // Write deploy report
-  if (options.reportFile) {
-    writeFileSync(options.reportFile, JSON.stringify(result, null, 2), 'utf-8');
-    console.log(`\n  Report written to ${options.reportFile}`);
-  }
-
-  const total = result.created.length + result.updated.length + result.versioned.length;
-  console.log(
-    `\n[mindmatrix-react] Deployed ${total} workflows ` +
-    `(${result.created.length} created, ${result.updated.length} updated, ` +
-    `${result.versioned.length} versioned, ${result.failed.length} failed)`
-  );
-
-  return result;
-}
-
-// =============================================================================
-// API Helpers
-// =============================================================================
-
-async function fetchExistingDefinition(
-  apiUrl: string,
-  token: string,
-  slug: string
-): Promise<ExistingDefinition | null> {
-  try {
-    const res = await fetch(`${apiUrl}/workflow/definitions?slug=${encodeURIComponent(slug)}`, {
-      headers: { Authorization: `Bearer ${token}` },
-    });
-
-    if (!res.ok) return null;
-
-    const data = await res.json() as any;
-    const definitions = Array.isArray(data) ? data : (data.items ?? data.data);
-
-    if (!definitions || definitions.length === 0) return null;
-
-    const def = definitions[0];
-    return {
-      id: def.id,
-      slug: def.slug,
-      version: def.version || '0.1.0',
-      instanceCount: def.instanceCount ?? def.instance_count ?? 0,
-    };
-  } catch {
-    return null;
-  }
-}
-
-async function createDefinition(
-  apiUrl: string,
-  token: string,
-  ir: Record<string, unknown>
-): Promise<void> {
-  const res = await fetch(`${apiUrl}/workflow/definitions`, {
-    method: 'POST',
-    headers: {
-      'Content-Type': 'application/json',
-      Authorization: `Bearer ${token}`,
-    },
-    body: JSON.stringify(ir),
-  });
-
-  if (!res.ok) {
-    const errorText = await res.text();
-    throw new Error(`Create failed: ${res.status} ${errorText}`);
-  }
-}
-
-async function updateDefinition(
-  apiUrl: string,
-  token: string,
-  id: string,
-  ir: Record<string, unknown>
-): Promise<void> {
-  // Remove slug from update payload — Rust API rejects slug changes after creation
-  const { slug: _slug, ...updatePayload } = ir;
-  const res = await fetch(`${apiUrl}/workflow/definitions/${id}`, {
-    method: 'PATCH',
-    headers: {
-      'Content-Type': 'application/json',
-      Authorization: `Bearer ${token}`,
-    },
-    body: JSON.stringify(updatePayload),
-  });
-
-  if (!res.ok) {
-    const errorText = await res.text();
-    throw new Error(`Update failed: ${res.status} ${errorText}`);
-  }
-}
-
-/**
- * Bumps a semver version string.
- * "1.0.0" → "1.0.1", "2.3.0" → "2.3.1"
- */
-function bumpVersion(version: string): string {
-  const parts = version.split('.');
-  if (parts.length !== 3) return `${version}.1`;
-
-  const patch = parseInt(parts[2], 10) || 0;
-  return `${parts[0]}.${parts[1]}.${patch + 1}`;
-}

package/src/cli/index.ts

@@ -1,328 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * CLI Entry Point — mmrc (MindMatrix React Compiler)
- *
- * Usage:
- *   mmrc init   <name> [--description "..."] [--icon "..."] [--author "..."]
- *   mmrc login  --api-url http://... [--email EMAIL --password PASS]
- *   mmrc logout [--api-url http://...]
- *   mmrc whoami [--api-url http://...]
- *   mmrc dev    --port 5199 --src src/workflows --seed
- *   mmrc build  --src src/workflows --out dist/workflows
- *   mmrc test   --src ./src
- *   mmrc deploy --api-url http://... [--token TOKEN] [--build]
- *   mmrc pull   <slug> --api-url http://... [--token TOKEN] --out ./my-project
- */
-
-import { build } from './build';
-import { test as roundTripTest } from './test';
-import { deploy } from './deploy';
-import { login, logout, whoami, resolveToken } from './auth';
-
-const args = process.argv.slice(2);
-const command = args[0];
-
-/** Extract a flag value from args: --flag value */
-function getFlag(flag: string): string | undefined {
-  const idx = args.indexOf(flag);
-  return idx !== -1 && idx + 1 < args.length ? args[idx + 1] : undefined;
-}
-
-/** Check if a boolean flag is present */
-function hasFlag(flag: string): boolean {
-  return args.includes(flag);
-}
-
-/** Get a positional arg (first arg that doesn't start with --) after the command */
-function getPositional(): string | undefined {
-  for (let i = 1; i < args.length; i++) {
-    if (!args[i].startsWith('--')) return args[i];
-  }
-  return undefined;
-}
-
-async function main() {
-  if (command === 'dev') {
-    const port = getFlag('--port') ? parseInt(getFlag('--port')!, 10) : undefined;
-    const src = getFlag('--src');
-    const mode = getFlag('--mode') as 'strict' | 'infer' | undefined;
-    const seed = hasFlag('--seed');
-    const apiUrl = getFlag('--api-url');
-    const authToken = getFlag('--token');
-    const open = hasFlag('--open');
-
-    // Dynamic import to avoid loading Vite at module-parse time
-    const { createDevServer } = await import('../dev-server');
-    const server = await createDevServer({
-      port,
-      src,
-      mode,
-      seed,
-      apiUrl,
-      authToken,
-      open,
-    });
-
-    // Graceful shutdown
-    const shutdown = async () => {
-      await server.close();
-      process.exit(0);
-    };
-    process.on('SIGINT', shutdown);
-    process.on('SIGTERM', shutdown);
-
-  } else if (command === 'build') {
-    const src = getFlag('--src');
-    const outDir = getFlag('--out');
-    const mode = (getFlag('--mode') as 'strict' | 'infer') ?? 'infer';
-    const envelope = hasFlag('--envelope');
-    const slug = getFlag('--slug');
-    const version = getFlag('--version');
-    const skipTypeCheck = hasFlag('--skip-type-check');
-
-    const result = await build({ src, outDir, mode, envelope, slug, version, skipTypeCheck });
-    if (result.errors > 0) process.exit(1);
-
-  } else if (command === 'test') {
-    const src = getFlag('--src');
-
-    const result = await roundTripTest({ src });
-    if (!result.success) process.exit(1);
-
-  } else if (command === 'deploy') {
-    const apiUrl = getFlag('--api-url') ?? 'http://localhost:4200/api/v1';
-    const token = resolveToken(apiUrl, getFlag('--token'));
-    const dir = getFlag('--dir');
-    const src = getFlag('--src');
-    const force = hasFlag('--force');
-    const dryRun = hasFlag('--dry-run');
-    const shouldBuild = hasFlag('--build');
-
-    if (!token) {
-      console.error('[mmrc] Error: No auth token found. Either:');
-      console.error('  1. Run `mmrc login` to save credentials');
-      console.error('  2. Pass --token TOKEN');
-      console.error('  3. Set MMRC_TOKEN environment variable');
-      process.exit(1);
-    }
-
-    // --build flag: compile first, then deploy
-    if (shouldBuild) {
-      const mode = (getFlag('--mode') as 'strict' | 'infer') ?? 'infer';
-      const srcDir = src ?? '.';
-      const outDir = dir ?? 'dist/workflows';
-      console.log('[mmrc] Building before deploy...\n');
-
-      // Check if this is a project (has mm.config.ts) → use project compiler
-      const { existsSync, readFileSync, writeFileSync, mkdirSync } = await import('fs');
-      const { resolve, join } = await import('path');
-      const { glob } = await import('glob');
-
-      const configPath = resolve(srcDir, 'mm.config.ts');
-      if (existsSync(configPath)) {
-        // Project-level compilation: read all files, use project compiler
-        const { compileProject } = await import('../project-compiler');
-        const allFiles = await glob(`${srcDir}/**/*.{ts,tsx}`, {
-          ignore: ['**/node_modules/**', '**/dist/**', '**/__tests__/**', '**/*.test.*'],
-        });
-
-        const fileMap: Record<string, string> = {};
-        for (const f of allFiles) {
-          const rel = f.startsWith(srcDir + '/') ? f.slice(srcDir.length + 1) : f;
-          fileMap[rel] = readFileSync(f, 'utf-8');
-        }
-
-        console.log(`  Compiling project (${Object.keys(fileMap).length} files)...`);
-        const result = compileProject(fileMap);
-        const errors = result.errors.filter(e => e.severity === 'error');
-        if (errors.length > 0) {
-          for (const err of errors) {
-            console.error(`  x ${err.file} (line ${err.line}): ${err.message}`);
-          }
-          console.error(`\n[mmrc] Build failed with ${errors.length} errors — aborting deploy.`);
-          process.exit(1);
-        }
-
-        // Write compiled IR to outDir
-        mkdirSync(outDir, { recursive: true });
-        const irPath = join(outDir, `${result.ir.slug}.workflow.json`);
-        writeFileSync(irPath, JSON.stringify(result.ir, null, 2), 'utf-8');
-        console.log(`  + ${result.ir.slug}.workflow.json`);
-
-        // Also write child definitions (skip duplicates of parent slug)
-        const seenSlugs = new Set<string>([result.ir.slug]);
-        for (const child of result.childDefinitions) {
-          if (seenSlugs.has(child.slug)) continue;
-          seenSlugs.add(child.slug);
-          const childPath = join(outDir, `${child.slug}.workflow.json`);
-          writeFileSync(childPath, JSON.stringify(child, null, 2), 'utf-8');
-          console.log(`  + ${child.slug}.workflow.json`);
-        }
-
-        console.log(`  Compiled ${1 + result.childDefinitions.length} definitions.\n`);
-      } else {
-        // Single-file compilation: use standard build
-        const buildResult = await build({ src: srcDir, outDir, mode });
-        if (buildResult.errors > 0) {
-          console.error('\n[mmrc] Build failed — aborting deploy.');
-          process.exit(1);
-        }
-        console.log('');
-      }
-
-      await deploy({ apiUrl, token, dir: outDir, force, dryRun });
-    } else {
-      await deploy({ apiUrl, token, dir, force, dryRun });
-    }
-
-  } else if (command === 'login') {
-    const apiUrl = getFlag('--api-url') ?? 'http://localhost:4200/api/v1';
-    const email = getFlag('--email');
-    const password = getFlag('--password');
-
-    await login(apiUrl, email, password);
-
-  } else if (command === 'logout') {
-    const apiUrl = getFlag('--api-url');
-    logout(apiUrl);
-
-  } else if (command === 'whoami') {
-    const apiUrl = getFlag('--api-url') ?? 'http://localhost:4200/api/v1';
-    await whoami(apiUrl);
-
-  } else if (command === 'init') {
-    const name = getPositional();
-    if (!name) {
-      console.error('[mmrc] Error: name is required\n  Usage: mmrc init <name> [--description "..."] [--icon "..."] [--author "..."]');
-      process.exit(1);
-    }
-
-    const { init } = await import('./init');
-    await init({
-      name,
-      description: getFlag('--description'),
-      icon: getFlag('--icon'),
-      author: getFlag('--author'),
-    });
-
-  } else if (command === 'pull') {
-    const slug = getPositional();
-    const apiUrl = getFlag('--api-url') ?? 'http://localhost:4200/api/v1';
-    const token = resolveToken(apiUrl, getFlag('--token'));
-    const outDir = getFlag('--out');
-
-    if (!slug) {
-      console.error('[mmrc] Error: slug is required\n  Usage: mmrc pull <slug> [--token TOKEN]');
-      process.exit(1);
-    }
-
-    if (!token) {
-      console.error('[mmrc] Error: No auth token found. Either:');
-      console.error('  1. Run `mmrc login` to save credentials');
-      console.error('  2. Pass --token TOKEN');
-      console.error('  3. Set MMRC_TOKEN environment variable');
-      process.exit(1);
-    }
-
-    const { pull } = await import('./pull');
-    await pull({ slug, apiUrl, token, outDir });
-
-  } else {
-    console.log(`
-MindMatrix React Compiler (mmrc)
-
-Commands:
-  init    Scaffold a new blueprint package
-  login   Authenticate and save credentials
-  logout  Remove saved credentials
-  whoami  Show current authenticated user
-  dev     Start dev server with hot reload
-  build   Compile workflow files to Pure Form IR
-  test    Round-trip fidelity test (compile → decompile → recompile → compare)
-  deploy  Compile + upload workflows to backend DB
-  pull    Fetch a definition from DB and scaffold local project
-
-Usage:
-  mmrc init <name> [options]
-    --description  Blueprint description
-    --icon         Icon name (default: box)
-    --author       Author name (default: MindMatrix)
-
-  mmrc login [options]
-    --api-url   API base URL (default: http://localhost:4200/api/v1)
-    --email     Email (prompted if not provided)
-    --password  Password (prompted if not provided)
-
-  mmrc logout [options]
-    --api-url   Remove credentials for this URL only (default: all)
-
-  mmrc whoami [options]
-    --api-url   API base URL (default: http://localhost:4200/api/v1)
-
-  mmrc dev [options]
-    --port      Dev server port (default: 5199)
-    --src       Source directory (default: src/workflows)
-    --mode      Compilation mode: strict|infer (default: infer)
-    --seed      Seed definitions to dev API on compile
-    --api-url   API base URL (default: http://localhost:4200/api/v1)
-    --token     Auth token for API seeding
-    --open      Open browser on start
-
-  mmrc build [options]
-    --src              Source directory (default: src/workflows)
-    --out              Output directory (default: dist/workflows)
-    --mode             Compilation mode: strict|infer (default: infer)
-    --envelope         Generate source envelope
-    --slug             Blueprint slug for envelope
-    --version          Blueprint version for envelope
-    --skip-type-check  Skip tsc --noEmit type checking (not recommended)
-
-  mmrc test [options]
-    --src       Source directory (default: current directory)
-
-  mmrc deploy [options]
-    --api-url   API base URL (default: http://localhost:4200/api/v1)
-    --token     Auth token (or use mmrc login / MMRC_TOKEN env var)
-    --dir       Compiled workflows directory (default: dist/workflows)
-    --src       Source directory (used with --build)
-    --build     Compile first, then deploy (no separate build step needed)
-    --force     Force update even if instances exist
-    --dry-run   Show what would happen without changes
-
-  mmrc pull <slug> [options]
-    --api-url   API base URL (default: http://localhost:4200/api/v1)
-    --token     Auth token (or use mmrc login / MMRC_TOKEN env var)
-    --out       Output directory (default: <slug>/)
-
-Token resolution (for deploy/pull):
-  1. --token flag (highest priority)
-  2. MMRC_TOKEN environment variable
-  3. Saved credentials from mmrc login (~/.mmrc/credentials.json)
-
-Workflows:
-  First-time setup:
-    mmrc login --api-url https://dev.mindmatrix.club/api/v1
-
-  Author locally, deploy to DB:
-    mmrc deploy --build --src ./src --api-url https://dev.mindmatrix.club/api/v1
-
-  Fetch from DB, edit locally:
-    mmrc pull mod-authentication --api-url https://dev.mindmatrix.club/api/v1
-    cd mod-authentication && mmrc deploy --build --src .
-
-Examples:
-  mmrc login --api-url https://dev.mindmatrix.club/api/v1
-  mmrc whoami
-  mmrc dev --port 5199 --seed
-  mmrc build --src src/workflows
-  mmrc deploy --build --src . --api-url http://localhost:4200/api/v1
-  mmrc pull my-blueprint --out ./my-project
-    `);
-  }
-}
-
-main().catch((error) => {
-  console.error('[mmrc] Fatal error:', error);
-  process.exit(1);
-});