spine-framework 0.1.50 → 0.1.51

package/.framework/cli/commands/dev.ts

@@ -5,42 +5,27 @@
  * @layer cli
  * @stability stable
  *
- * `spine dev` command — unified development server for Spine.
- * Handles assembly, integrity verification, and Vite dev server startup.
- *
- * **Commands:**
- * | Subcommand        | Description                                           |
- * |-------------------|-------------------------------------------------------|
- * | `dev`             | Start dev server with assembly and integrity check    |
- * | `dev --no-verify` | Skip integrity verification (faster)                  |
- * | `dev --port 3002` | Use custom port (default: 3001)                       |
- * | `dev --watch`     | Watch v2-custom for changes and auto-reassemble         |
- * | `dev --no-watch`  | Disable file watching (manual rebuild only)           |
+ * `spine-framework dev` command — assemble and start the Netlify dev server.
  *
  * **What happens:**
- * 1. Runs `assemble:v2` to merge v2-core + v2-custom
- * 2. Runs `verify` to check core integrity (unless --no-verify)
- * 3. Starts Vite dev server on port 3001 (or --port)
- * 4. Watches v2-custom/ for changes (--watch by default)
- * 5. Fast incremental reassembly on custom code changes
+ * 1. Runs `npm run assemble` to merge framework + custom apps
+ * 2. Starts `netlify dev` (which runs Vite + Netlify Functions)
  *
  * **Usage:**
  * ```bash
- * spine dev
- * spine dev --port 3002
- * spine dev --no-verify
+ * spine-framework dev
+ * spine-framework dev --no-assemble   # skip assembly step
  * ```
  *
- * @seeAlso scripts/assemble-v2.sh (assembly script)
- * @seeAlso scripts/verify-integrity.sh (verification script)
- * @seeAlso vite.config.ts (Vite configuration)
+ * @seeAlso scripts/assemble.sh (assembly script)
+ * @seeAlso netlify.toml (Netlify dev configuration)
  */
 
 import type { Command } from 'commander'
-import { spawn, execSync } from 'child_process'
+import { spawn } from 'child_process'
 import { resolve, dirname } from 'path'
 import { fileURLToPath } from 'url'
-import { watch, existsSync, statSync, readdirSync } from 'fs'
+import { existsSync } from 'fs'
 
 const __filename = fileURLToPath(import.meta.url)
 const __dirname = dirname(__filename)
@@ -51,131 +36,50 @@ const PROJECT_ROOT = process.cwd()
 export function registerDevCommands(program: Command) {
   program
     .command('dev')
-    .description('Start Spine development server')
-    .option('--no-verify', 'Skip integrity verification')
-    .option('--port <port>', 'Dev server port', '3001')
-    .option('--host', 'Expose to network', false)
-    .option('--no-watch', 'Disable file watching')
-    .option('--watch-delay <ms>', 'Debounce delay for reassembly', '500')
+    .description('Assemble and start the Netlify dev server')
+    .option('--no-assemble', 'Skip the assembly step')
     .action(async (opts) => {
       console.log('\n🚀 Starting Spine dev server...\n')
 
       try {
         // Step 1: Assembly
-        console.log('📦 Step 1: Assembling v2-core + v2-custom...')
-        const assemblyExitCode = await runCommand(
-          'bash',
-          [resolve(PROJECT_ROOT, 'scripts/assemble-v2.sh')],
-          PROJECT_ROOT
-        )
-
-        if (assemblyExitCode !== 0) {
-          console.error('\n❌ Assembly failed. Please check the errors above.')
-          process.exit(1)
-        }
-        console.log('✓ Assembly complete\n')
+        if (opts.assemble !== false) {
+          console.log('📦 Step 1: Assembling...')
+          const assemblyExitCode = await runCommand('npm', ['run', 'assemble'], PROJECT_ROOT)
 
-        // Step 2: Integrity verification (unless skipped)
-        if (opts.verify !== false) {
-          console.log('🔒 Step 2: Verifying core integrity...')
-          const verifyExitCode = await runCommand(
-            'bash',
-            [resolve(PROJECT_ROOT, 'scripts/verify-integrity.sh')],
-            PROJECT_ROOT
-          )
-
-          if (verifyExitCode !== 0) {
-            console.warn('\n⚠️  Integrity check failed. Continuing anyway (--no-verify to skip)\n')
-          } else {
-            console.log('✓ Integrity verified\n')
+          if (assemblyExitCode !== 0) {
+            console.error('\n❌ Assembly failed. Please check the errors above.')
+            process.exit(1)
           }
+          console.log('✓ Assembly complete\n')
         } else {
-          console.log('⏭️  Step 2: Skipping integrity verification (--no-verify)\n')
+          console.log('⏭️  Step 1: Skipping assembly (--no-assemble)\n')
         }
 
-        // Step 3: Start Vite
-        console.log(`🌐 Step 3: Starting Vite dev server on port ${opts.port}...`)
+        // Step 2: Start netlify dev
+        console.log('🌐 Step 2: Starting netlify dev...')
         console.log('   (Press Ctrl+C to stop)\n')
 
-        const vite = spawn(
-          resolve(PROJECT_ROOT, 'node_modules/.bin/vite'),
-          [
-            '--config', resolve(PROJECT_ROOT, 'vite.config.ts'),
-            '--port', opts.port,
-            ...(opts.host ? ['--host'] : [])
-          ],
-          {
-            cwd: PROJECT_ROOT,
-            stdio: 'inherit',
-            env: { ...process.env, SPINE_DEV: 'true' }
-          }
-        )
-
-        // Step 4: Watch v2-custom for changes (unless disabled)
-        let watcher: ReturnType<typeof watch> | null = null
-        if (opts.watch !== false) {
-          const watchDelay = parseInt(opts.watchDelay) || 500
-          const customDir = resolve(PROJECT_ROOT, 'v2-custom')
-
-          if (existsSync(customDir)) {
-            console.log(`👁️  Step 4: Watching v2-custom/ for changes...`)
-            console.log(`   (Changes trigger fast reassembly after ${watchDelay}ms debounce)\n`)
-
-            let reassemblyTimeout: NodeJS.Timeout | null = null
-
-            watcher = watch(customDir, { recursive: true }, (eventType, filename) => {
-              // Ignore node_modules, .git, and temp files
-              if (!filename || filename.includes('node_modules') || filename.startsWith('.')) {
-                return
-              }
-
-              console.log(`\n📝 Change detected in v2-custom/${filename}`)
+        const netlifyBin = resolve(PROJECT_ROOT, 'node_modules/.bin/netlify')
+        const cmd = existsSync(netlifyBin) ? netlifyBin : 'netlify'
 
-              // Debounce reassembly
-              if (reassemblyTimeout) {
-                clearTimeout(reassemblyTimeout)
-              }
-
-              reassemblyTimeout = setTimeout(async () => {
-                console.log('🔧 Running fast reassembly...')
-                try {
-                  const start = Date.now()
-                  await fastReassemble(PROJECT_ROOT)
-                  const duration = Date.now() - start
-                  console.log(`✓ Reassembly complete (${duration}ms)\n`)
-                } catch (err: any) {
-                  console.error(`✗ Reassembly failed: ${err.message}\n`)
-                }
-              }, watchDelay)
-            })
-          } else {
-            console.log('⏭️  Step 4: v2-custom/ not found, skipping watch mode\n')
-          }
-        } else {
-          console.log('⏭️  Step 4: File watching disabled (--no-watch)\n')
-        }
+        const netlify = spawn(cmd, ['dev'], {
+          cwd: PROJECT_ROOT,
+          stdio: 'inherit',
+          env: { ...process.env }
+        })
 
-        vite.on('exit', (code) => {
-          if (watcher) {
-            watcher.close()
-          }
+        netlify.on('exit', (code) => {
           process.exit(code || 0)
         })
 
-        // Handle Ctrl+C gracefully
         process.on('SIGINT', () => {
-          console.log('\n\n🛑 Shutting down dev server...')
-          if (watcher) {
-            watcher.close()
-          }
-          vite.kill('SIGTERM')
+          console.log('\n\n🛑 Shutting down...')
+          netlify.kill('SIGTERM')
         })
 
         process.on('SIGTERM', () => {
-          if (watcher) {
-            watcher.close()
-          }
-          vite.kill('SIGTERM')
+          netlify.kill('SIGTERM')
         })
 
       } catch (err: any) {
@@ -207,89 +111,3 @@ function runCommand(command: string, args: string[], cwd: string): Promise<numbe
     })
   })
 }
-
-/**
- * Fast incremental reassembly of v2-custom files only.
- * Uses rsync if available, falls back to selective copy.
- */
-async function fastReassemble(projectRoot: string): Promise<void> {
-  const customDir = resolve(projectRoot, 'v2-custom')
-  const srcDest = resolve(projectRoot, 'src/v2-assembled')
-  const funcsDest = resolve(projectRoot, 'functions')
-
-  // Check if rsync is available
-  let hasRsync = false
-  try {
-    execSync('which rsync', { stdio: 'pipe' })
-    hasRsync = true
-  } catch {
-    hasRsync = false
-  }
-
-  // Reassemble custom frontend files
-  const customSrcDir = resolve(customDir, 'src')
-  if (existsSync(customSrcDir)) {
-    const destDir = srcDest
-
-    if (hasRsync) {
-      // Use rsync for efficient incremental sync
-      execSync(
-        `rsync -av --delete "${customSrcDir}/" "${destDir}/"`,
-        { stdio: 'pipe', cwd: projectRoot }
-      )
-    } else {
-      // Fallback: copy files that have changed
-      copyChangedFiles(customSrcDir, destDir)
-    }
-  }
-
-  // Reassemble custom function files
-  const customFuncsDir = resolve(customDir, 'functions')
-  if (existsSync(customFuncsDir)) {
-    if (hasRsync) {
-      execSync(
-        `rsync -av --delete "${customFuncsDir}/" "${funcsDest}/"`,
-        { stdio: 'pipe', cwd: projectRoot }
-      )
-    } else {
-      copyChangedFiles(customFuncsDir, funcsDest)
-    }
-  }
-}
-
-/**
- * Copy only files that have changed (mtime comparison).
- * Fallback when rsync is not available.
- */
-function copyChangedFiles(src: string, dest: string): void {
-  const files = readdirSync(src, { withFileTypes: true })
-
-  for (const entry of files) {
-    const srcPath = resolve(src, entry.name)
-    const destPath = resolve(dest, entry.name)
-
-    if (entry.isDirectory()) {
-      if (!existsSync(destPath)) {
-        // Create directory
-        const { mkdirSync } = require('fs')
-        mkdirSync(destPath, { recursive: true })
-      }
-      // Recurse
-      copyChangedFiles(srcPath, destPath)
-    } else {
-      // Check if file needs copying
-      const srcStat = statSync(srcPath)
-      let needsCopy = true
-
-      if (existsSync(destPath)) {
-        const destStat = statSync(destPath)
-        needsCopy = srcStat.mtime > destStat.mtime
-      }
-
-      if (needsCopy) {
-        const { copyFileSync } = require('fs')
-        copyFileSync(srcPath, destPath)
-      }
-    }
-  }
-}

package/dist/cli/commands/dev.d.ts

@@ -4,35 +4,20 @@
  * @layer cli
  * @stability stable
  *
- * `spine dev` command — unified development server for Spine.
- * Handles assembly, integrity verification, and Vite dev server startup.
- *
- * **Commands:**
- * | Subcommand        | Description                                           |
- * |-------------------|-------------------------------------------------------|
- * | `dev`             | Start dev server with assembly and integrity check    |
- * | `dev --no-verify` | Skip integrity verification (faster)                  |
- * | `dev --port 3002` | Use custom port (default: 3001)                       |
- * | `dev --watch`     | Watch v2-custom for changes and auto-reassemble         |
- * | `dev --no-watch`  | Disable file watching (manual rebuild only)           |
+ * `spine-framework dev` command — assemble and start the Netlify dev server.
  *
  * **What happens:**
- * 1. Runs `assemble:v2` to merge v2-core + v2-custom
- * 2. Runs `verify` to check core integrity (unless --no-verify)
- * 3. Starts Vite dev server on port 3001 (or --port)
- * 4. Watches v2-custom/ for changes (--watch by default)
- * 5. Fast incremental reassembly on custom code changes
+ * 1. Runs `npm run assemble` to merge framework + custom apps
+ * 2. Starts `netlify dev` (which runs Vite + Netlify Functions)
  *
  * **Usage:**
  * ```bash
- * spine dev
- * spine dev --port 3002
- * spine dev --no-verify
+ * spine-framework dev
+ * spine-framework dev --no-assemble   # skip assembly step
  * ```
  *
- * @seeAlso scripts/assemble-v2.sh (assembly script)
- * @seeAlso scripts/verify-integrity.sh (verification script)
- * @seeAlso vite.config.ts (Vite configuration)
+ * @seeAlso scripts/assemble.sh (assembly script)
+ * @seeAlso netlify.toml (Netlify dev configuration)
  */
 import type { Command } from 'commander';
 export declare function registerDevCommands(program: Command): void;

package/dist/cli/commands/dev.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../../.framework/cli/commands/dev.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAYxC,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,QA0InD"}
+{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../../.framework/cli/commands/dev.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAYxC,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,QAyDnD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spine-framework",
-  "version": "0.1.50",
+  "version": "0.1.51",
   "private": false,
   "description": "Spine — enterprise application framework built on Supabase + Netlify + React",
   "type": "module",