spine-framework 0.1.61 → 1.0.0

package/.framework/cli/commands/generate.ts

@@ -1,332 +0,0 @@
-/// <reference types="node" />
-/**
- * @module cli/commands/generate
- * @audience installer
- * @layer cli
- * @stability stable
- *
- * `spine generate` command — code scaffolding for extending Spine safely.
- * Generates type definitions, handlers, and UI pages in v2-custom/ only.
- *
- * **Commands:**
- * | Subcommand              | Description                                           |
- * |-------------------------|-------------------------------------------------------|
- * | `generate type <slug>`  | Create new type with handler and UI stubs             |
- * | `generate function <name>` | Create new Netlify function stub                   |
- *
- * **What gets generated for `type`:**
- * 1. Type record in database (item type by default)
- * 2. Handler stub: `v2-custom/functions/{slug}.ts`
- * 3. UI page stub: `v2-custom/src/pages/{slug}/index.tsx`
- *
- * **What gets generated for `function`:**
- * 1. Netlify function stub: `v2-custom/functions/{name}.ts`
- * 2. Basic handler structure with middleware imports
- *
- * **Usage:**
- * ```bash
- * spine generate type ticket-v2
- * spine generate function webhook-handler
- * ```
- *
- * @seeAlso functions/types.ts (type CRUD API)
- * @seeAlso functions/_shared/middleware.ts (handler structure)
- */
-
-import type { Command } from 'commander'
-import { buildCliContext, handleError } from '../context.ts'
-import { adminDb } from '../../functions/_shared/index.ts'
-import { existsSync, mkdirSync, writeFileSync } from 'fs'
-import { resolve, dirname } from 'path'
-import { fileURLToPath } from 'url'
-
-const __filename = fileURLToPath(import.meta.url)
-const __dirname = dirname(__filename)
-const PROJECT_ROOT = resolve(__dirname, '../../../')
-
-// ─── TYPE GENERATION ─────────────────────────────────────────────────────────
-
-async function generateType(ctx: any, slug: string, options: any): Promise<void> {
-  const name = options.name || slug.split('-').map(s => s.charAt(0).toUpperCase() + s.slice(1)).join(' ')
-  const kind = options.kind || 'item'
-  const description = options.description || `${name} type generated by spine CLI`
-
-  console.log(`\n🔧 Generating type '${slug}'...`)
-
-  // Step 1: Create type record in database
-  console.log('  Step 1: Creating type record in database...')
-
-  const { data: existing, error: checkErr } = await adminDb
-    .from('types')
-    .select('id')
-    .eq('slug', slug)
-    .eq('kind', kind)
-    .single()
-
-  if (checkErr && checkErr.code !== 'PGRST116') { // PGRST116 = not found
-    throw new Error(`Failed to check existing type: ${checkErr.message}`)
-  }
-
-  if (existing) {
-    console.log(`  ⚠️  Type '${slug}' already exists (skipping DB creation)`)
-  } else {
-    const designSchema = {
-      fields: {
-        title: {
-          type: 'string',
-          required: true,
-          label: 'Title',
-          description: `Title for this ${name}`
-        },
-        status: {
-          type: 'select',
-          options: ['open', 'in_progress', 'closed'],
-          default: 'open',
-          label: 'Status'
-        }
-      },
-      layout: {
-        detail: ['title', 'status'],
-        list: ['title', 'status']
-      }
-    }
-
-    const { error: insertErr } = await adminDb
-      .from('types')
-      .insert({
-        kind,
-        slug,
-        name,
-        description,
-        design_schema: designSchema,
-        validation_schema: {},
-        ownership: 'system',
-        is_active: true
-      })
-
-    if (insertErr) {
-      throw new Error(`Failed to create type: ${insertErr.message}`)
-    }
-
-    console.log('  ✓ Type record created')
-  }
-
-  // Step 2: Generate handler stub
-  console.log('  Step 2: Generating handler stub...')
-  const handlerPath = resolve(PROJECT_ROOT, `v2-custom/functions/${slug}.ts`)
-
-  if (existsSync(handlerPath) && !options.force) {
-    console.log(`  ⚠️  Handler stub already exists: ${handlerPath}`)
-  } else {
-    const handlerCode = generateHandlerStub(slug, kind, name)
-    writeFileSync(handlerPath, handlerCode)
-    console.log(`  ✓ Handler stub created: v2-custom/functions/${slug}.ts`)
-  }
-
-  // Step 3: Generate UI page stub
-  console.log('  Step 3: Generating UI page stub...')
-  const pageDir = resolve(PROJECT_ROOT, `v2-custom/src/pages/${slug}`)
-  const pagePath = resolve(pageDir, 'index.tsx')
-
-  if (existsSync(pagePath) && !options.force) {
-    console.log(`  ⚠️  UI page stub already exists: ${pagePath}`)
-  } else {
-    mkdirSync(pageDir, { recursive: true })
-    const pageCode = generatePageStub(slug, name, kind)
-    writeFileSync(pagePath, pageCode)
-    console.log(`  ✓ UI page stub created: v2-custom/src/pages/${slug}/index.tsx`)
-  }
-
-  console.log(`\n✅ Type '${slug}' generation complete!`)
-  console.log(`   Next steps:`)
-  console.log(`   1. Edit v2-custom/functions/${slug}.ts to implement custom logic`)
-  console.log(`   2. Edit v2-custom/src/pages/${slug}/index.tsx to customize the UI`)
-  console.log(`   3. Run 'spine dev' to see your changes`)
-}
-
-function generateHandlerStub(slug: string, kind: string, name: string): string {
-  return `/**
- * @module ${slug}
- * @audience custom
- * @layer api-handler
- * @stability experimental
- *
- * Custom handler for ${name} (${kind} type).
- * Generated by spine CLI on ${new Date().toISOString()}.
- *
- * Extend this handler to add custom logic for your type.
- */
-
-import { createHandler } from '../v2-core/functions/_shared/middleware'
-
-export const handler = createHandler(async (ctx) => {
-  const method = ctx.query?.method || 'GET'
-
-  switch (method) {
-    case 'GET':
-      // TODO: Implement GET logic
-      return { message: '${name} handler - GET not implemented' }
-
-    case 'POST':
-      // TODO: Implement POST logic
-      return { message: '${name} handler - POST not implemented' }
-
-    case 'PATCH':
-      // TODO: Implement PATCH logic
-      return { message: '${name} handler - PATCH not implemented' }
-
-    case 'DELETE':
-      // TODO: Implement DELETE logic
-      return { message: '${name} handler - DELETE not implemented' }
-
-    default:
-      throw new Error('Unsupported method: ' + method)
-  }
-})
-`
-}
-
-function generatePageStub(slug: string, name: string, kind: string): string {
-  return `/**
- * @page ${slug}/index
- * @audience custom
- * @layer page
- * @stability experimental
- *
- * UI page for ${name} (${kind} type).
- * Generated by spine CLI on ${new Date().toISOString()}.
- */
-
-import React from 'react'
-import { useParams } from 'react-router-dom'
-import { useApi } from '../../v2-core/src/hooks/useApi'
-import { apiFetch } from '../../v2-core/src/lib/api'
-
-export default function ${name.replace(/\s+/g, '')}Page() {
-  const { id } = useParams()
-
-  const { data, loading, error } = useApi(
-    () => apiFetch('/.netlify/functions/${slug}' + (id ? '?id=' + id : '')),
-    { immediate: true }
-  )
-
-  if (loading) return <div>Loading...</div>
-  if (error) return <div>Error: {error.message}</div>
-
-  return (
-    <div className="p-6">
-      <h1 className="text-2xl font-bold mb-4">${name}</h1>
-      <pre className="bg-gray-100 p-4 rounded">
-        {JSON.stringify(data, null, 2)}
-      </pre>
-      <p className="mt-4 text-gray-600">
-        Edit v2-custom/src/pages/${slug}/index.tsx to customize this page.
-      </p>
-    </div>
-  )
-}
-`
-}
-
-// ─── FUNCTION GENERATION ─────────────────────────────────────────────────────
-
-async function generateFunction(name: string, options: any): Promise<void> {
-  console.log(`\n🔧 Generating function '${name}'...`)
-
-  const handlerPath = resolve(PROJECT_ROOT, `v2-custom/functions/${name}.ts`)
-
-  if (existsSync(handlerPath) && !options.force) {
-    console.log(`  ⚠️  Function already exists: ${handlerPath}`)
-    console.log(`  Use --force to overwrite`)
-    return
-  }
-
-  const handlerCode = generateFunctionStub(name, options.description)
-  writeFileSync(handlerPath, handlerCode)
-
-  console.log(`✅ Function '${name}' created!`)
-  console.log(`   Location: v2-custom/functions/${name}.ts`)
-  console.log(`   Next steps:`)
-  console.log(`   1. Edit the handler to implement your logic`)
-  console.log(`   2. Run 'spine dev' to see your changes`)
-}
-
-function generateFunctionStub(name: string, description?: string): string {
-  return `/**
- * @module ${name}
- * @audience custom
- * @layer api-handler
- * @stability experimental
- *
- * ${description || `Custom Netlify function: ${name}`}
- * Generated by spine CLI on ${new Date().toISOString()}.
- */
-
-import { createHandler } from '../v2-core/functions/_shared/middleware'
-
-export const handler = createHandler(async (ctx) => {
-  // Access principal: ctx.principal (human, machine, or system)
-  // Access database: ctx.db (RLS-scoped) or import { adminDb } for admin access
-  // Access query params: ctx.query
-
-  const q = ctx.query || {}
-  const action = q.action || 'default'
-
-  switch (action) {
-    case 'default':
-      return {
-        message: 'Hello from ${name}',
-        principal: ctx.principal?.id,
-        timestamp: new Date().toISOString()
-      }
-
-    // TODO: Add more actions here
-    // case 'custom':
-    //   return { data: await yourCustomLogic(ctx) }
-
-    default:
-      return {
-        error: 'Unknown action: ' + action,
-        available_actions: ['default']
-      }
-  }
-})
-`
-}
-
-// ─── COMMAND REGISTRATION ────────────────────────────────────────────────────
-
-export function registerGenerateCommands(program: Command) {
-  const generate = program
-    .command('generate')
-    .description('Generate code stubs for extending Spine')
-
-  generate
-    .command('type <slug>')
-    .description('Generate a new type with handler and UI stubs')
-    .option('--name <name>', 'Display name for the type')
-    .option('--kind <kind>', 'Type kind (item, account, person)', 'item')
-    .option('--description <desc>', 'Type description')
-    .option('--force', 'Overwrite existing files', false)
-    .action(async (slug, opts) => {
-      try {
-        const ctx = await buildCliContext()
-        await generateType(ctx, slug, opts)
-      } catch (err: any) {
-        handleError(err)
-      }
-    })
-
-  generate
-    .command('function <name>')
-    .description('Generate a new Netlify function stub')
-    .option('--description <desc>', 'Function description')
-    .option('--force', 'Overwrite existing file', false)
-    .action(async (name, opts) => {
-      try {
-        await generateFunction(name, opts)
-      } catch (err: any) {
-        handleError(err)
-      }
-    })
-}

package/.framework/cli/commands/init.ts

@@ -1,186 +0,0 @@
-/// <reference types="node" />
-/**
- * @module cli/commands/init
- * @audience installer
- * @layer cli
- * @stability stable
- *
- * `spine-framework init` — Write .env and scaffold the custom/ workspace.
- *
- * Intentionally does NOT touch the database — run `spine-framework migrate`
- * after init to apply SQL migrations via a direct Postgres connection.
- *
- * **Usage:**
- * ```bash
- * spine-framework init --url https://xyz.supabase.co --anon-key eyJ... --service-role-key eyJ...
- * spine-framework migrate --db-password <password>
- * ```
- */
-
-import type { Command } from 'commander'
-import { existsSync, mkdirSync, writeFileSync, cpSync } from 'fs'
-import { resolve, dirname } from 'path'
-import { fileURLToPath } from 'url'
-import { execSync } from 'child_process'
-
-const __filename = fileURLToPath(import.meta.url)
-const __dirname = dirname(__filename)
-const PROJECT_ROOT = process.cwd()
-// Package root: node_modules/spine-framework/ — 3 levels up from .framework/cli/commands/
-const PACKAGE_ROOT = resolve(__dirname, '../../..')
-
-interface InitOptions {
-  dryRun: boolean
-}
-
-function scaffoldCustomWorkspace(dryRun: boolean): void {
-  const dirs = [
-    'custom/apps',
-    'custom/functions',
-    'custom/components',
-    'custom/migrations',
-    'custom/tests',
-  ]
-
-  for (const dir of dirs) {
-    const fullPath = resolve(PROJECT_ROOT, dir)
-    if (existsSync(fullPath)) {
-      console.log(`  ⏭️  ${dir}/ already exists`)
-    } else if (dryRun) {
-      console.log(`  [dry-run] Would create: ${dir}/`)
-    } else {
-      mkdirSync(fullPath, { recursive: true })
-      writeFileSync(resolve(fullPath, '.gitkeep'), '')
-      console.log(`  ✓ Created ${dir}/`)
-    }
-  }
-}
-
-function writeEnvFile(dryRun: boolean): void {
-  const envPath = resolve(PROJECT_ROOT, '.env')
-
-  if (existsSync(envPath)) {
-    console.log('  ⏭️  .env already exists, skipping')
-    return
-  }
-
-  const envContent = [
-    '# ─── Supabase ────────────────────────────────────────────────────────────────',
-    '# Get these from: https://supabase.com/dashboard/project/_/settings/api',
-    'SUPABASE_URL=https://your-project.supabase.co',
-    'SUPABASE_ANON_KEY=your-anon-key',
-    'SUPABASE_SERVICE_ROLE_KEY=your-service-role-key',
-    '',
-    '# DB password for running migrations (direct Postgres connection)',
-    '# Get from: https://supabase.com/dashboard/project/_/settings/database',
-    'SUPABASE_DB_PASSWORD=your-db-password',
-    '',
-    '# ─── Vite / Frontend ─────────────────────────────────────────────────────────',
-    'VITE_SUPABASE_URL=https://your-project.supabase.co',
-    'VITE_SUPABASE_ANON_KEY=your-anon-key',
-    'VITE_APP_NAME=Spine',
-    '',
-    '# ─── OpenAI ──────────────────────────────────────────────────────────────────',
-    'OPENAI_API_KEY=your-openai-api-key',
-    '',
-    '# ─── App config ──────────────────────────────────────────────────────────────',
-    'DB_SCHEMA=public',
-  ].join('\n') + '\n'
-
-  if (dryRun) {
-    console.log('  [dry-run] Would write .env with placeholder values')
-    return
-  }
-
-  writeFileSync(envPath, envContent, 'utf8')
-  console.log('  ✓ Created .env')
-}
-
-function copyFrameworkFiles(dryRun: boolean): void {
-  // Directories and files to copy from the package root into the consumer project root
-  const items = [
-    { src: '.framework',     dest: '.framework'     },
-    { src: 'bin',            dest: 'bin'            },
-    { src: 'config',         dest: 'config'         },
-    { src: 'scripts',        dest: 'scripts'        },
-    { src: 'netlify.toml',   dest: 'netlify.toml'   },
-    { src: 'vitest.config.ts', dest: 'vitest.config.ts' },
-    { src: 'index.html',     dest: 'index.html'     },
-    { src: 'package-project.json', dest: 'package.json' },
-    { src: 'STRUCTURE.md',   dest: 'STRUCTURE.md'   },
-  ]
-
-  for (const item of items) {
-    const src  = resolve(PACKAGE_ROOT, item.src)
-    const dest = resolve(PROJECT_ROOT, item.dest)
-
-    if (!existsSync(src)) {
-      console.log(`  ⏭️  ${item.src} not found in package, skipping`)
-      continue
-    }
-
-    // Always overwrite package.json (npm creates a minimal one during install)
-    if (existsSync(dest) && item.dest !== 'package.json') {
-      console.log(`  ⏭️  ${item.dest} already exists, skipping`)
-      continue
-    }
-
-    if (dryRun) {
-      console.log(`  [dry-run] Would copy: ${item.src} → ./${item.dest}`)
-      continue
-    }
-
-    cpSync(src, dest, { recursive: true })
-    console.log(`  ✓ Copied ${item.dest}`)
-  }
-}
-
-async function initCommand(options: InitOptions): Promise<void> {
-  console.log('\n🚀 Spine Framework — Init\n')
-
-  // Step 1: Copy framework files to project root
-  console.log('📦 Step 1: Installing framework files...')
-  copyFrameworkFiles(options.dryRun)
-
-  // Step 2: Install dev dependencies (vite, netlify-cli)
-  if (!options.dryRun) {
-    console.log('\n📦 Step 2: Installing dev dependencies...')
-    try {
-      execSync('npm install', { stdio: 'inherit', cwd: PROJECT_ROOT })
-      console.log('  ✓ Dev dependencies installed')
-    } catch (err) {
-      console.log('  ⚠️  npm install failed — run manually: npm install')
-    }
-  }
-
-  // Step 3: Scaffold custom workspace
-  console.log('\n📁 Step 3: Scaffolding custom workspace...')
-  scaffoldCustomWorkspace(options.dryRun)
-
-  // Step 4: Write .env with placeholders
-  console.log('\n🔑 Step 4: Writing environment configuration...')
-  writeEnvFile(options.dryRun)
-
-  console.log('\n✅ Project initialized!')
-  console.log('\n   Next steps:')
-  console.log('   1. Fill in your Supabase credentials in .env')
-  console.log('      (get them from https://supabase.com/dashboard/project/_/settings/api)')
-  console.log('   2. Run: npx spine-framework migrate')
-  console.log('      (ensure SUPABASE_DB_PASSWORD is set in .env)')
-}
-
-export function registerInitCommands(program: Command) {
-  program
-    .command('init')
-    .description('Install framework files, scaffold custom/ workspace, and write .env template')
-    .option('--dry-run', 'Show what would happen without making changes', false)
-    .action(async (opts) => {
-      try {
-        await initCommand(opts)
-      } catch (err: any) {
-        console.error('Error:', err.message)
-        if (process.env.SPINE_CLI_DEBUG) console.error(err.stack)
-        process.exit(1)
-      }
-    })
-}