spine-framework 0.3.17 → 0.3.19

package/.framework/cli/commands/migrate.ts

@@ -1,178 +0,0 @@
-/// <reference types="node" />
-/**
- * @module cli/commands/migrate
- * @audience installer
- * @layer cli
- * @stability stable
- *
- * `spine-framework migrate` — Apply SQL migrations to a Supabase project
- * via a direct Postgres connection.
- *
- * Requires --db-password (the Supabase database password).
- * Get it from: https://supabase.com/dashboard/project/_/settings/database
- *
- * **Usage:**
- * ```bash
- * spine-framework migrate --db-password <password>
- * spine-framework migrate --db-password <password> --dry-run
- * ```
- */
-
-import type { Command } from 'commander'
-import { existsSync, readdirSync, readFileSync } from 'fs'
-import { resolve, dirname } from 'path'
-import { fileURLToPath } from 'url'
-
-const __filename = fileURLToPath(import.meta.url)
-const __dirname = dirname(__filename)
-const MIGRATIONS_DIR = resolve(__dirname, '../../migrations')
-
-interface MigrateOptions {
-  dbPassword?: string
-  dryRun: boolean
-}
-
-async function migrateCommand(options: MigrateOptions): Promise<void> {
-  console.log('\n🗄️  Spine Framework — Migrate\n')
-
-  const supabaseUrl = process.env.SUPABASE_URL
-  if (!supabaseUrl || supabaseUrl === 'https://your-project.supabase.co') {
-    console.error('❌ SUPABASE_URL not set. Fill in your .env file first.')
-    process.exit(1)
-  }
-
-  const dbPassword = options.dbPassword || process.env.SUPABASE_DB_PASSWORD
-  if (!dbPassword || dbPassword === 'your-db-password') {
-    console.error('❌ SUPABASE_DB_PASSWORD not set.')
-    console.error('   Add it to .env or pass --db-password <password>')
-    console.error('   Get it from: https://supabase.com/dashboard/project/_/settings/database')
-    process.exit(1)
-  }
-
-  const projectRef = supabaseUrl.replace('https://', '').split('.')[0]
-  const connectionString = `postgresql://postgres:${dbPassword}@db.${projectRef}.supabase.co:5432/postgres`
-
-  if (!existsSync(MIGRATIONS_DIR)) {
-    console.error(`❌ Migrations directory not found: ${MIGRATIONS_DIR}`)
-    process.exit(1)
-  }
-
-  const files = readdirSync(MIGRATIONS_DIR)
-    .filter(f => f.endsWith('.sql'))
-    .sort()
-
-  if (files.length === 0) {
-    console.log('  No migration files found.')
-    return
-  }
-
-  console.log(`  Found ${files.length} migration file(s)\n`)
-
-  if (options.dryRun) {
-    for (const file of files) {
-      console.log(`  [dry-run] Would apply: ${file}`)
-    }
-    return
-  }
-
-  // Dynamically import pg to avoid loading it at module init time
-  const { default: pg } = await import('pg')
-  const client = new pg.Client({ connectionString })
-
-  try {
-    await client.connect()
-    console.log('  ✓ Connected to database\n')
-  } catch (err: any) {
-    console.error(`❌ Could not connect to database: ${err.message}`)
-    console.error('   Check your --db-password and that the project is active.')
-    process.exit(1)
-  }
-
-  let applied = 0
-  let failed = 0
-
-  for (const file of files) {
-    const sql = readFileSync(resolve(MIGRATIONS_DIR, file), 'utf8')
-    process.stdout.write(`  Applying ${file}... `)
-
-    // Split SQL into statements, being careful to preserve dollar-quoted blocks.
-    // Dollar-quoted strings ($$ ... $$ or $tag$ ... $tag$) can contain semicolons
-    // that are NOT statement terminators.
-    function splitSqlStatements(sql: string): string[] {
-      const dollarBlocks: string[] = []
-      let blockIndex = 0
-
-      // Step 1: Protect dollar-quoted blocks with placeholders (preserves internal semicolons)
-      const protectedSql = sql.replace(/\$[A-Za-z_]*\$[\s\S]*?\$[A-Za-z_]*\$/g, (match) => {
-        const placeholder = `__DOLLAR_BLOCK_${blockIndex}__`
-        dollarBlocks[blockIndex] = match
-        blockIndex++
-        return placeholder
-      })
-
-      // Step 2: Strip single-line comments (prevents semicolons inside -- comments
-      //         from being treated as statement terminators)
-      const noComments = protectedSql.replace(/--[^\n]*/g, '')
-
-      // Step 3: Split by semicolons, restore dollar blocks, and filter empty statements
-      return noComments
-        .split(';')
-        .map(s => {
-          let restored = s.trim()
-          // Use function form of replace — prevents JS from interpreting $$ as $
-          dollarBlocks.forEach((block, idx) => {
-            restored = restored.replace(`__DOLLAR_BLOCK_${idx}__`, () => block)
-          })
-          return restored
-        })
-        .filter(s => s.length > 0)
-        .map(s => s + ';')
-    }
-
-    const statements = splitSqlStatements(sql)
-
-    try {
-      for (const stmt of statements) {
-        await client.query(stmt)
-      }
-      console.log('✓')
-      applied++
-    } catch (err: any) {
-      console.log('❌')
-      console.error(`     ${err.message}`)
-      failed++
-      // Continue applying remaining migrations
-    }
-  }
-
-  await client.end()
-
-  console.log(`\n  ${applied} applied, ${failed} failed`)
-
-  if (failed > 0) {
-    console.error('\n❌ Some migrations failed. Check errors above.')
-    process.exit(1)
-  }
-
-  console.log('\n✅ All migrations applied successfully!')
-  console.log('\n   Next steps:')
-  console.log('   1. spine-framework install-app <app-slug>')
-  console.log('   2. npm run assemble && netlify dev')
-}
-
-export function registerMigrateCommands(program: Command) {
-  program
-    .command('migrate')
-    .description('Apply SQL migrations via direct Postgres connection')
-    .option('--db-password <password>', 'DB password override (default: reads SUPABASE_DB_PASSWORD from .env)')
-    .option('--dry-run', 'Show what would happen without making changes', false)
-    .action(async (opts) => {
-      try {
-        await migrateCommand(opts)
-      } 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/publish.ts

@@ -1,191 +0,0 @@
-/// <reference types="node" />
-/**
- * @module cli/commands/publish
- * @audience developer
- * @layer cli
- * @stability stable
- *
- * `spine-framework publish` — Bump version, write changelog, publish to npm, commit.
- *
- * Run from the spine-ia coding repo. Handles both the framework package and
- * individual app packages (cortex, portal, etc.).
- *
- * **Usage:**
- * ```bash
- * spine-framework publish                          # publish framework (patch bump)
- * spine-framework publish --app cortex             # publish cortex app (patch bump)
- * spine-framework publish --app cortex --bump minor
- * spine-framework publish --app cortex --bump patch --notes "Fix sidebar nav"
- * spine-framework publish --app cortex --ci --notes "Fix sidebar nav" --bump patch
- * ```
- */
-
-import type { Command } from 'commander'
-import { existsSync, readFileSync, writeFileSync } from 'fs'
-import { resolve, dirname } from 'path'
-import { fileURLToPath } from 'url'
-import { execSync } from 'child_process'
-import * as readline from 'readline'
-
-const __filename = fileURLToPath(import.meta.url)
-const __dirname = dirname(__filename)
-const PROJECT_ROOT = process.cwd()
-
-interface PublishOptions {
-  app?: string
-  bump: 'patch' | 'minor' | 'major'
-  notes?: string
-  ci: boolean
-  dryRun: boolean
-}
-
-// ─── SEMVER BUMP ──────────────────────────────────────────────────────────────
-
-function bumpVersion(current: string, bump: 'patch' | 'minor' | 'major'): string {
-  const [major, minor, patch] = current.replace(/^v/, '').split('.').map(Number)
-  if (bump === 'major') return `${major + 1}.0.0`
-  if (bump === 'minor') return `${major}.${minor + 1}.0`
-  return `${major}.${minor}.${patch + 1}`
-}
-
-// ─── INTERACTIVE PROMPT ───────────────────────────────────────────────────────
-
-function promptNotes(): Promise<string> {
-  return new Promise(resolve => {
-    const rl = readline.createInterface({ input: process.stdin, output: process.stdout })
-    rl.question('  Changelog notes (comma-separated): ', answer => {
-      rl.close()
-      resolve(answer.trim())
-    })
-  })
-}
-
-// ─── PUBLISH LOGIC ────────────────────────────────────────────────────────────
-
-async function publishTarget(options: PublishOptions): Promise<void> {
-  const isApp = !!options.app
-  const slug = options.app
-
-  let pkgJsonPath: string
-  let manifestPath: string | null
-  let publishDir: string
-  let displayName: string
-
-  if (isApp && slug) {
-    pkgJsonPath = resolve(PROJECT_ROOT, `custom/apps/${slug}/package.json`)
-    manifestPath = resolve(PROJECT_ROOT, `custom/apps/${slug}/manifest.json`)
-    publishDir = resolve(PROJECT_ROOT, `custom/apps/${slug}`)
-    displayName = `spine-framework-${slug}`
-  } else {
-    pkgJsonPath = resolve(PROJECT_ROOT, 'package.json')
-    manifestPath = null
-    publishDir = PROJECT_ROOT
-    displayName = 'spine-framework'
-  }
-
-  if (!existsSync(pkgJsonPath)) {
-    console.error(`  ❌ package.json not found: ${pkgJsonPath}`)
-    process.exit(1)
-  }
-
-  // 1. Read current version
-  const pkgJson = JSON.parse(readFileSync(pkgJsonPath, 'utf8'))
-  const currentVersion = pkgJson.version as string
-  const newVersion = bumpVersion(currentVersion, options.bump)
-
-  console.log(`\n📦 Publishing ${displayName}`)
-  console.log(`   ${currentVersion} → ${newVersion} (${options.bump} bump)\n`)
-
-  // 2. Collect changelog notes
-  let notesInput = options.notes || ''
-  if (!notesInput) {
-    if (options.ci) {
-      console.error(`  ❌ --ci mode requires --notes "..."`)
-      process.exit(1)
-    }
-    notesInput = await promptNotes()
-  }
-  const notes = notesInput
-    .split(',')
-    .map(s => s.trim())
-    .filter(Boolean)
-
-  if (notes.length === 0) {
-    console.error(`  ❌ At least one changelog note is required.`)
-    process.exit(1)
-  }
-
-  if (options.dryRun) {
-    console.log(`  [dry-run] Would bump ${displayName} ${currentVersion} → ${newVersion}`)
-    console.log(`  [dry-run] Changelog entry:`)
-    console.log(`    { "version": "${newVersion}", "notes": ${JSON.stringify(notes)} }`)
-    console.log(`  [dry-run] Would run: npm publish (from ${publishDir})`)
-    console.log(`  [dry-run] Would commit: chore: publish ${displayName}@${newVersion}`)
-    return
-  }
-
-  // 3. Bump version in package.json
-  pkgJson.version = newVersion
-  writeFileSync(pkgJsonPath, JSON.stringify(pkgJson, null, 2) + '\n', 'utf8')
-  console.log(`  ✓ package.json version → ${newVersion}`)
-
-  // 4. Prepend changelog entry to manifest.json (apps only)
-  if (manifestPath && existsSync(manifestPath)) {
-    const manifest = JSON.parse(readFileSync(manifestPath, 'utf8'))
-    const changelog: Array<{ version: string; notes: string[] }> = manifest.changelog || []
-    changelog.unshift({ version: newVersion, notes })
-    manifest.version = newVersion
-    manifest.changelog = changelog
-    writeFileSync(manifestPath, JSON.stringify(manifest, null, 2) + '\n', 'utf8')
-    console.log(`  ✓ manifest.json changelog prepended, version → ${newVersion}`)
-  }
-
-  // 5. npm publish
-  console.log(`\n🚀 Running npm publish...`)
-  try {
-    execSync('npm publish --access public', { cwd: publishDir, stdio: 'inherit' })
-    console.log(`  ✓ Published ${displayName}@${newVersion}`)
-  } catch (err: any) {
-    console.error(`  ❌ npm publish failed: ${err.message}`)
-    console.error(`     Version files have already been updated — commit them manually.`)
-    process.exit(1)
-  }
-
-  // 6. Git commit
-  console.log(`\n📝 Committing version bump...`)
-  try {
-    const filesToStage = [pkgJsonPath]
-    if (manifestPath && existsSync(manifestPath)) filesToStage.push(manifestPath)
-    execSync(`git add ${filesToStage.map(f => `"${f}"`).join(' ')}`, { cwd: PROJECT_ROOT })
-    execSync(
-      `git commit -m "chore: publish ${displayName}@${newVersion}"`,
-      { cwd: PROJECT_ROOT, stdio: 'inherit' },
-    )
-    console.log(`  ✓ Committed`)
-  } catch (err: any) {
-    console.error(`  ⚠️  Git commit failed: ${err.message}`)
-    console.error(`     Published successfully — commit the version files manually.`)
-  }
-
-  console.log(`\n✅ ${displayName}@${newVersion} published successfully!\n`)
-}
-
-export function registerPublishCommands(program: Command) {
-  program
-    .command('publish')
-    .description('Bump version, write changelog, publish to npm, commit (run from spine-ia)')
-    .option('--app <slug>', 'App slug to publish (e.g. cortex). Omit to publish the framework itself.')
-    .option('--bump <level>', 'Version bump level: patch | minor | major', 'patch')
-    .option('--notes <text>', 'Comma-separated changelog notes (required in --ci mode)')
-    .option('--ci', 'Non-interactive mode: skip prompts, requires --notes', false)
-    .option('--dry-run', 'Show what would happen without making changes', false)
-    .action(async (opts) => {
-      try {
-        await publishTarget(opts as PublishOptions)
-      } 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/status.ts

@@ -1,268 +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'
-import { readEngagementData, ensureSerialData, shouldOfferClaim } from './claim.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 }
-  installation: {
-    frameworkInstallSerial: string | null
-    engagementScore: number
-    claimStatus: 'anonymous' | 'claimed' | 'pending' | null
-    claimPrompt: { timing: string; message: string } | null
-  }
-  apps: Array<{
-    slug: string
-    name: string
-    hasManifest: boolean
-    hasSeed: boolean
-    installed: boolean
-    installedVersion: string | null
-    packageName: string | null
-    appInstallSerial: string | null
-    installTimestamp: string | null
-  }>
-  webhookHandlers: Array<{ name: string; functionName: string; isActive: boolean }>
-  typeCounts: { total: number; byApp: Record<string, number> }
-}
-
-async function gatherStatus(): Promise<StatusReport> {
-  // Get installation/engagement data
-  let frameworkSerial: string | null = null
-  let engagementScore = 0
-  let claimStatus: 'anonymous' | 'claimed' | 'pending' | null = null
-  let claimPrompt: { timing: string; message: string } | null = null
-
-  try {
-    const serialData = ensureSerialData()
-    frameworkSerial = serialData.serial_number
-    const engagement = readEngagementData()
-    if (engagement) {
-      engagementScore = engagement.engagement_score
-      claimStatus = engagement.claim_status
-      const prompt = shouldOfferClaim()
-      if (prompt) {
-        claimPrompt = { timing: prompt.timing, message: prompt.message }
-      }
-    }
-  } catch {
-    // Silent fail - engagement tracking is optional
-  }
-
-  const report: StatusReport = {
-    database: { connected: false },
-    installation: {
-      frameworkInstallSerial: frameworkSerial,
-      engagementScore,
-      claimStatus,
-      claimPrompt,
-    },
-    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, installed_version, package_name')
-
-  const installedSlugs = new Set(
-    (installations || []).filter(i => i.is_enabled).map(i => i.app_slug)
-  )
-
-  const installationMap = new Map(
-    (installations || []).map(i => [i.app_slug, i])
-  )
-
-  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`)
-
-    const installation = installationMap.get(slug)
-    report.apps.push({
-      slug,
-      name: dbApp?.name || slug,
-      hasManifest: !!manifest,
-      hasSeed: existsSync(seedDir) && readdirSync(seedDir).some(f => f.endsWith('.json')),
-      installed: installedSlugs.has(slug),
-      installedVersion: installation?.installed_version || null,
-      packageName: installation?.package_name || null,
-      appInstallSerial: null, // Populated via signal system
-      installTimestamp: null, // Populated via signal system
-    })
-  }
-
-  // 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')
-
-  // Installation / Claim Status
-  if (report.installation.frameworkInstallSerial) {
-    console.log(`  🔐 Installation: ${report.installation.frameworkInstallSerial}`)
-    if (report.installation.claimStatus === 'claimed') {
-      console.log('  ✅ Claimed: Yes')
-    } else {
-      console.log(`  ⏳ Claim Status: ${report.installation.claimStatus || 'anonymous'}`)
-      console.log(`   📊 Engagement Score: ${report.installation.engagementScore}`)
-      if (report.installation.claimPrompt) {
-        console.log(`   💡 ${report.installation.claimPrompt.message}`)
-        console.log(`      Run: spine-framework claim`)
-      }
-    }
-    console.log('')
-  }
-
-  // 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 versionStr = app.installedVersion ? `v${app.installedVersion}` : ''
-      const status = [
-        app.hasManifest ? '📋 manifest' : '',
-        app.hasSeed ? '🌱 seed' : '',
-        app.installed ? `✅ installed${versionStr ? ' ' + versionStr : ''}` : '⬜ 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)
-      }
-    })
-}