spine-framework 0.2.1 → 1.0.0

package/.framework/cli/commands/status.ts

@@ -1,197 +0,0 @@
-/// <reference types="node" />
-/**
- * @module cli/commands/status
- * @audience installer
- * @layer cli
- * @stability stable
- *
- * `spine-framework status` — Show the current state of the Spine installation.
- *
- * Displays:
- * - Database connection status
- * - Installed apps and their seed state
- * - Migration history
- * - Webhook handler registrations
- *
- * **Usage:**
- * ```bash
- * spine-framework status
- * spine-framework status --json
- * ```
- */
-
-import type { Command } from 'commander'
-import { existsSync, readdirSync } from 'fs'
-import { resolve, dirname } from 'path'
-import { fileURLToPath } from 'url'
-import { adminDb } from '../../functions/_shared/index.ts'
-import { discoverManifests } from '../../functions/_shared/app-manifest.ts'
-
-const __filename = fileURLToPath(import.meta.url)
-const __dirname = dirname(__filename)
-const PROJECT_ROOT = resolve(__dirname, '../../../')
-
-interface StatusOptions {
-  json: boolean
-}
-
-interface StatusReport {
-  database: { connected: boolean; error?: string }
-  apps: Array<{ slug: string; name: string; hasManifest: boolean; hasSeed: boolean; installed: boolean }>
-  webhookHandlers: Array<{ name: string; functionName: string; isActive: boolean }>
-  typeCounts: { total: number; byApp: Record<string, number> }
-}
-
-async function gatherStatus(): Promise<StatusReport> {
-  const report: StatusReport = {
-    database: { connected: false },
-    apps: [],
-    webhookHandlers: [],
-    typeCounts: { total: 0, byApp: {} },
-  }
-
-  // 1. Database connection
-  try {
-    const { data, error } = await adminDb
-      .from('apps')
-      .select('slug')
-      .limit(1)
-
-    if (error) {
-      report.database = { connected: false, error: error.message }
-    } else {
-      report.database = { connected: true }
-    }
-  } catch (err: any) {
-    report.database = { connected: false, error: err.message }
-    return report
-  }
-
-  // 2. Apps — merge filesystem + database
-  const manifests = discoverManifests()
-  const { data: dbApps } = await adminDb
-    .from('apps')
-    .select('slug, name, is_active')
-    .eq('is_active', true)
-    .order('slug')
-
-  const { data: installations } = await adminDb
-    .from('app_installations')
-    .select('app_slug, is_enabled')
-
-  const installedSlugs = new Set(
-    (installations || []).filter(i => i.is_enabled).map(i => i.app_slug)
-  )
-
-  const allSlugs = new Set([
-    ...manifests.map(m => m.slug),
-    ...(dbApps || []).map(a => a.slug).filter(s => s !== 'spine-core'),
-  ])
-
-  for (const slug of allSlugs) {
-    const manifest = manifests.find(m => m.slug === slug)
-    const dbApp = dbApps?.find(a => a.slug === slug)
-    const seedDir = resolve(PROJECT_ROOT, `custom/apps/${slug}/seed`)
-
-    report.apps.push({
-      slug,
-      name: dbApp?.name || slug,
-      hasManifest: !!manifest,
-      hasSeed: existsSync(seedDir) && readdirSync(seedDir).some(f => f.endsWith('.json')),
-      installed: installedSlugs.has(slug),
-    })
-  }
-
-  // 3. Webhook handlers
-  const { data: handlers } = await adminDb
-    .from('webhook_handlers')
-    .select('name, function_name, is_active')
-    .order('name')
-
-  report.webhookHandlers = (handlers || []).map(h => ({
-    name: h.name,
-    functionName: h.function_name,
-    isActive: h.is_active,
-  }))
-
-  // 4. Type counts by app
-  const { data: types } = await adminDb
-    .from('types')
-    .select('slug, app_id, apps!inner(slug)')
-    .eq('is_active', true)
-
-  report.typeCounts.total = types?.length || 0
-  for (const t of types || []) {
-    const appSlug = (t as any).apps?.slug || 'unassigned'
-    report.typeCounts.byApp[appSlug] = (report.typeCounts.byApp[appSlug] || 0) + 1
-  }
-
-  return report
-}
-
-function printStatus(report: StatusReport): void {
-  console.log('\n🔍 Spine Framework Status\n')
-
-  // Database
-  if (report.database.connected) {
-    console.log('  📡 Database: ✅ Connected')
-  } else {
-    console.log(`  📡 Database: ❌ ${report.database.error || 'Not connected'}`)
-    return
-  }
-
-  // Apps
-  console.log(`\n  📱 Apps (${report.apps.length}):`)
-  if (report.apps.length === 0) {
-    console.log('     (none)')
-  } else {
-    for (const app of report.apps) {
-      const status = [
-        app.hasManifest ? '📋 manifest' : '',
-        app.hasSeed ? '🌱 seed' : '',
-        app.installed ? '✅ installed' : '⬜ not installed',
-      ].filter(Boolean).join('  ')
-      console.log(`     ${app.slug.padEnd(24)} ${status}`)
-    }
-  }
-
-  // Webhook handlers
-  console.log(`\n  🔗 Webhook Handlers (${report.webhookHandlers.length}):`)
-  if (report.webhookHandlers.length === 0) {
-    console.log('     (none)')
-  } else {
-    for (const h of report.webhookHandlers) {
-      const status = h.isActive ? '✅' : '❌'
-      console.log(`     ${status} ${h.name.padEnd(24)} → ${h.functionName}`)
-    }
-  }
-
-  // Types
-  console.log(`\n  📊 Types (${report.typeCounts.total} total):`)
-  for (const [app, count] of Object.entries(report.typeCounts.byApp).sort()) {
-    console.log(`     ${app.padEnd(24)} ${count} types`)
-  }
-
-  console.log('')
-}
-
-export function registerStatusCommands(program: Command) {
-  program
-    .command('status')
-    .description('Show the current state of the Spine installation')
-    .option('--json', 'Output as JSON', false)
-    .action(async (opts: StatusOptions) => {
-      try {
-        const report = await gatherStatus()
-        if (opts.json) {
-          console.log(JSON.stringify(report, null, 2))
-        } else {
-          printStatus(report)
-        }
-      } catch (err: any) {
-        console.error('Error:', err.message)
-        if (process.env.SPINE_CLI_DEBUG) console.error(err.stack)
-        process.exit(1)
-      }
-    })
-}

package/.framework/cli/commands/system.ts

@@ -1,184 +0,0 @@
-/// <reference types="node" />
-/**
- * @module cli/commands/system
- * @audience installer
- * @layer cli
- * @stability stable
- *
- * `spine system` command — CLI interface to system discovery endpoints.
- * Queries the running Spine instance for manifest, health, and OpenAPI spec.
- *
- * **Commands:**
- * | Subcommand              | Description                                           |
- * |-------------------------|-------------------------------------------------------|
- * | `system manifest`       | Fetch and display system manifest                     |
- * | `system health`         | Fetch and display health check results                |
- * | `system openapi`        | Fetch OpenAPI spec (outputs JSON)                     |
- * | `system --json`         | Output as JSON for all subcommands                    |
- *
- * **Usage:**
- * ```bash
- * spine system manifest
- * spine system health --json
- * spine system openapi > openapi.json
- * ```
- *
- * @seeAlso functions/system.ts (HTTP endpoints this CLI consumes)
- */
-
-import type { Command } from 'commander'
-import { buildCliContext, printResult, handleError } from '../context.ts'
-
-// ─── API CLIENT ────────────────────────────────────────────────────────────
-
-async function fetchSystemEndpoint(ctx: any, action: string): Promise<any> {
-  const supabaseUrl = process.env.SUPABASE_URL
-  if (!supabaseUrl) {
-    throw new Error('SUPABASE_URL not configured')
-  }
-
-  // Construct the Netlify function URL
-  // When running locally, this is http://localhost:8888/.netlify/functions/system
-  // We'll try localhost:8888 first, then fall back to production URL if configured
-  const localUrl = 'http://localhost:8888/.netlify/functions/system'
-  const url = `${localUrl}?action=${action}`
-
-  try {
-    const response = await fetch(url, {
-      method: 'GET',
-      headers: {
-        'Accept': 'application/json',
-        'x-app-id': 'cli-system'
-      }
-    })
-
-    if (!response.ok) {
-      const text = await response.text()
-      throw new Error(`HTTP ${response.status}: ${text}`)
-    }
-
-    return await response.json()
-  } catch (err: any) {
-    // If local fails, try direct Supabase function invoke (for production)
-    if (err.message.includes('fetch failed') || err.message.includes('ECONNREFUSED')) {
-      throw new Error(
-        'Cannot connect to local dev server. ' +
-        'Ensure `spine dev` or `netlify dev` is running on port 8888.'
-      )
-    }
-    throw err
-  }
-}
-
-// ─── COMMAND REGISTRATION ────────────────────────────────────────────────
-
-export function registerSystemCommands(program: Command) {
-  const system = program
-    .command('system')
-    .description('System discovery and health commands')
-
-  system
-    .command('manifest')
-    .description('Fetch system manifest (version, functions, migrations)')
-    .option('--json', 'Output as JSON')
-    .action(async (opts) => {
-      try {
-        const ctx = await buildCliContext()
-        const result = await fetchSystemEndpoint(ctx, 'manifest')
-
-        if (opts.json) {
-          console.log(JSON.stringify(result, null, 2))
-        } else {
-          console.log('\n📋 Spine System Manifest')
-          console.log('─'.repeat(50))
-
-          if (result.data) {
-            const m = result.data
-            console.log(`Version:     ${m.version}`)
-            console.log(`Schema:      ${m.schema}`)
-            console.log(`Migrations:  ${m.migrations?.applied || 0} applied` +
-              (m.migrations?.pending ? `, ${m.migrations.pending} pending` : ''))
-            console.log(`Functions:   ${m.functions?.length || 0} endpoints`)
-            console.log(`Integrity:   ${m.integrity?.verified ? '✓ verified' : '⚠ not verified'}`)
-
-            if (m.functions?.length > 0) {
-              console.log('\nAvailable Functions:')
-              for (const fn of m.functions.slice(0, 10)) {
-                console.log(`  • ${fn.name} (${fn.methods.join(',')})`)
-              }
-              if (m.functions.length > 10) {
-                console.log(`  ... and ${m.functions.length - 10} more`)
-              }
-            }
-          } else {
-            console.log('No manifest data returned')
-          }
-          console.log()
-        }
-      } catch (err: any) {
-        handleError(err)
-      }
-    })
-
-  system
-    .command('health')
-    .description('Fetch health check status')
-    .option('--json', 'Output as JSON')
-    .action(async (opts) => {
-      try {
-        const ctx = await buildCliContext()
-        const result = await fetchSystemEndpoint(ctx, 'health')
-
-        if (opts.json) {
-          console.log(JSON.stringify(result, null, 2))
-        } else {
-          console.log('\n🏥 Spine Health Check')
-          console.log('─'.repeat(50))
-
-          if (result.data) {
-            const h = result.data
-            const statusIcon = h.status === 'healthy' ? '✓' :
-                              h.status === 'degraded' ? '⚠' : '✗'
-            console.log(`Status: ${statusIcon} ${h.status.toUpperCase()}`)
-            console.log()
-
-            if (h.checks) {
-              for (const [name, check] of Object.entries(h.checks)) {
-                const c = check as any
-                const icon = c.connected || c.current || c.verified ? '✓' :
-                            c.status === 'passed' ? '✓' : '⚠'
-                console.log(`${icon} ${name}:`)
-                if (c.latency_ms !== undefined) {
-                  console.log(`    latency: ${c.latency_ms}ms`)
-                }
-                if (c.applied !== undefined) {
-                  console.log(`    applied: ${c.applied}, pending: ${c.pending}`)
-                }
-                if (c.last_suite) {
-                  console.log(`    last run: ${c.last_suite} (${c.last_status})`)
-                }
-              }
-            }
-          } else {
-            console.log('No health data returned')
-          }
-          console.log()
-        }
-      } catch (err: any) {
-        handleError(err)
-      }
-    })
-
-  system
-    .command('openapi')
-    .description('Fetch OpenAPI specification')
-    .action(async () => {
-      try {
-        const ctx = await buildCliContext()
-        const result = await fetchSystemEndpoint(ctx, 'openapi')
-        console.log(JSON.stringify(result.data || result, null, 2))
-      } catch (err: any) {
-        handleError(err)
-      }
-    })
-}

package/.framework/cli/commands/test.ts

@@ -1,227 +0,0 @@
-/// <reference types="node" />
-/**
- * @module cli/commands/test
- * @audience installer
- * @layer cli
- * @stability stable
- *
- * `spine test` command — unified test runner for all 4 test surfaces.
- * Runs Vitest tests and persists results to Supabase via the custom reporter.
- *
- * **Commands:**
- * | Subcommand              | Description                                           |
- * |-------------------------|-------------------------------------------------------|
- * | `test`                  | Run all test suites                                   |
- * | `test unit`             | Run unit tests only                                   |
- * | `test integration`      | Run integration tests only                            |
- * | `test api`              | Run API tests only                                    |
- * | `test ui`               | Run UI/Playwright tests only                          |
- * | `test --json`           | Output structured JSON summary                        |
- * | `test --watch`          | Run in watch mode (for unit/integration)              |
- *
- * **Test surfaces:**
- * - **unit**: Fast tests, no DB (v2-core/tests/unit/)
- * - **integration**: DB tests with fixtures (v2-core/tests/integration/)
- * - **api**: HTTP fetch tests against localhost:8888 (v2-core/tests/api/)
- * - **ui**: Playwright browser tests (v2-core/tests/ui/)
- *
- * **Results:**
- * All test runs are persisted to `public.test_runs` and `public.test_results`
- * via the custom Vitest reporter (v2-core/tests/reporter.ts).
- *
- * **Usage:**
- * ```bash
- * spine test
- * spine test unit --watch
- * spine test integration --json
- * spine test api
- * spine test ui
- * ```
- *
- * @seeAlso tests/reporter.ts (custom Vitest reporter)
- * @seeAlso functions/tests.ts (API endpoint for querying results)
- * @seeAlso pages/admin/TestingDashboard.tsx (UI for viewing results)
- */
-
-import type { Command } from 'commander'
-import { spawn } from 'child_process'
-import { resolve, dirname } from 'path'
-import { fileURLToPath } from 'url'
-
-const __filename = fileURLToPath(import.meta.url)
-const __dirname = dirname(__filename)
-const PROJECT_ROOT = resolve(__dirname, '../../../')
-
-// ─── TYPES ─────────────────────────────────────────────────────────────────
-
-type TestSuite = 'unit' | 'integration' | 'api' | 'ui' | 'all'
-
-// ─── SUITE CONFIGURATION ───────────────────────────────────────────────────
-
-const SUITES: Record<string, { pattern: string; runner: 'vitest' | 'playwright' | 'node' }> = {
-  unit: { pattern: 'v2-core/tests/unit', runner: 'vitest' },
-  integration: { pattern: 'v2-core/tests/integration', runner: 'vitest' },
-  api: { pattern: 'v2-core/tests/api', runner: 'vitest' },
-  ui: { pattern: 'v2-core/tests/ui', runner: 'playwright' }
-}
-
-// ─── COMMAND REGISTRATION ──────────────────────────────────────────────────
-
-export function registerTestCommands(program: Command) {
-  const testCmd = program
-    .command('test [suite]')
-    .description('Run Spine test suites')
-    .option('--json', 'Output as JSON')
-    .option('--watch', 'Watch mode (unit/integration only)')
-    .option('--reporter <name>', 'Vitest reporter', 'default')
-    .action(async (suiteArg: string | undefined, opts) => {
-      const suite: TestSuite = (suiteArg || 'all') as TestSuite
-
-      // Validate suite
-      if (suite !== 'all' && !SUITES[suite]) {
-        console.error(`\n❌ Unknown test suite: ${suite}`)
-        console.log('Valid suites: unit, integration, api, ui, all')
-        process.exit(1)
-      }
-
-      // Determine which suites to run
-      const suitesToRun = suite === 'all'
-        ? ['unit', 'integration', 'api', 'ui']
-        : [suite]
-
-      console.log(`\n🧪 Running Spine test suites: ${suitesToRun.join(', ')}\n`)
-
-      const results: Array<{ suite: string; exitCode: number; passed: boolean }> = []
-
-      for (const s of suitesToRun) {
-        const config = SUITES[s]
-        console.log(`\n▶️  ${s.toUpperCase()} tests (${config.runner})`)
-        console.log('-'.repeat(40))
-
-        try {
-          let exitCode: number
-
-          if (config.runner === 'vitest') {
-            exitCode = await runVitest(s, opts)
-          } else if (config.runner === 'playwright') {
-            exitCode = await runPlaywright(s, opts)
-          } else {
-            exitCode = await runNode(s, opts)
-          }
-
-          results.push({ suite: s, exitCode, passed: exitCode === 0 })
-
-          if (exitCode === 0) {
-            console.log(`✓ ${s} tests passed\n`)
-          } else {
-            console.error(`✗ ${s} tests failed (exit ${exitCode})\n`)
-          }
-
-        } catch (err: any) {
-          console.error(`\n❌ Error running ${s} tests:`, err.message)
-          results.push({ suite: s, exitCode: 1, passed: false })
-        }
-      }
-
-      // Summary
-      console.log('\n' + '='.repeat(50))
-      console.log('Test Run Summary')
-      console.log('='.repeat(50))
-
-      const totalPassed = results.filter(r => r.passed).length
-      const totalFailed = results.filter(r => !r.passed).length
-
-      for (const r of results) {
-        const icon = r.passed ? '✓' : '✗'
-        const status = r.passed ? 'PASSED' : 'FAILED'
-        console.log(`${icon} ${r.suite.padEnd(12)} ${status}`)
-      }
-
-      console.log()
-      console.log(`Total: ${totalPassed} passed, ${totalFailed} failed`)
-
-      // JSON output
-      if (opts.json) {
-        const jsonOutput = {
-          suites: results.map(r => ({
-            suite: r.suite,
-            status: r.passed ? 'passed' : 'failed',
-            exit_code: r.exitCode
-          })),
-          summary: {
-            total: results.length,
-            passed: totalPassed,
-            failed: totalFailed
-          }
-        }
-        console.log('\n' + JSON.stringify(jsonOutput, null, 2))
-      }
-
-      // Exit code
-      process.exit(totalFailed > 0 ? 1 : 0)
-    })
-}
-
-// ─── RUNNER IMPLEMENTATIONS ────────────────────────────────────────────────
-
-async function runVitest(suite: string, opts: any): Promise<number> {
-  const config = SUITES[suite]
-  const args = [
-    'run',
-    config.pattern,
-    '--config', resolve(PROJECT_ROOT, 'vitest.config.ts')
-  ]
-
-  if (opts.watch) {
-    args[0] = 'watch' // Replace 'run' with 'watch'
-  }
-
-  // Custom reporters - include both default and our custom reporter
-  if (opts.reporter === 'default') {
-    args.push('--reporter=default')
-    args.push('--reporter=' + resolve(PROJECT_ROOT, 'v2-core/tests/reporter.ts'))
-  } else {
-    args.push(`--reporter=${opts.reporter}`)
-  }
-
-  return runCommand('npx', ['vitest', ...args], PROJECT_ROOT)
-}
-
-async function runPlaywright(suite: string, opts: any): Promise<number> {
-  // Playwright tests run against a running dev server
-  // We need to ensure the server is running or start it
-  console.log('   (Playwright tests require dev server on localhost:8888)')
-
-  const args = ['playwright', 'test', SUITES[suite].pattern]
-
-  if (opts.json) {
-    args.push('--reporter=json')
-  }
-
-  return runCommand('npx', args, PROJECT_ROOT)
-}
-
-async function runNode(suite: string, opts: any): Promise<number> {
-  // For custom test scripts that aren't Vitest or Playwright
-  const args = [SUITES[suite].pattern]
-  return runCommand('node', args, PROJECT_ROOT)
-}
-
-function runCommand(command: string, args: string[], cwd: string): Promise<number> {
-  return new Promise((resolve, reject) => {
-    const proc = spawn(command, args, {
-      cwd,
-      stdio: 'inherit',
-      env: process.env,
-      shell: true
-    })
-
-    proc.on('exit', (code) => {
-      resolve(code || 0)
-    })
-
-    proc.on('error', (err) => {
-      reject(err)
-    })
-  })
-}