spine-framework 0.3.124 → 0.3.126

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

@@ -1,38 +1,18 @@
-/// <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)
- */
-
+// CIL[BEGIN chunk_id="generate_moduleheader_1784069813" type="module_header" identity="module_header" parent="none"]
+// CIL[DOC-MACRO purpose="Module imports for generate CLI commands"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide CLI context, database access, and filesystem utilities"]
+// CIL[DOC-CONTEXT module="cli.commands.generate" layer="cli" related_files="[\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/migrations/015_simplify_apps_table.sql\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/src/pages/admin/RolesPage.tsx\",\".framework/functions/_shared/principal.ts\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="imports" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Imports Commander, CLI context, admin DB, and Node.js filesystem modules" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-AUDIENCE audience="developer"]
+// CIL[DOC-VECTOR type="context" content="Layer: cli. Direct callers: 0. Direct calls: 0. Related files: custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .framework/migrations/015_simplify_apps_table.sql, .framework/src/pages/admin/TypeDetailPage.tsx, .framework/src/pages/admin/RolesPage.tsx, .framework/functions/_shared/principal.ts, \."]
+// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
+// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
+// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 import type { Command } from 'commander'
 import { buildCliContext, handleError } from '../context.ts'
 import { adminDb } from '../../functions/_shared/index.ts'
@@ -43,9 +23,21 @@ import { fileURLToPath } from 'url'
 const __filename = fileURLToPath(import.meta.url)
 const __dirname = dirname(__filename)
 const PROJECT_ROOT = resolve(__dirname, '../../../')
-
-// ─── TYPE GENERATION ─────────────────────────────────────────────────────────
-
+// CIL[END chunk_id="generate_moduleheader_1784069813"]
+// CIL[BEGIN chunk_id="generate_generatetype_1784069813" type="function" identity="generateType" parent="none"]
+// CIL[DOC-MACRO purpose="Generate type, handler, and UI page stubs"]
+// CIL[DOC-RESPONSIBILITY responsibility="Create complete type scaffolding in database and filesystem"]
+// CIL[DOC-CONTEXT module="cli.commands.generate" layer="cli" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/src/pages/admin/RolesPage.tsx\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/src/components/ui/dialog.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="database records and files" errors="database errors" side_effects="database writes, file writes"]
+// CIL[DOC-MICRO logic_summary="Creates type record, generates handler stub, creates UI page with React component" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-VECTOR type="context" content="Layer: cli. Direct callers: 0. Direct calls: 0. Related files: custom/apps/portal/pages/ContentPage.tsx, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .framework/src/pages/admin/RolesPage.tsx, .framework/src/pages/admin/TypeDetailPage.tsx, .framework/src/components/ui/dialog.tsx, \."]
+// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
+// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
+// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 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'
@@ -53,9 +45,6 @@ async function generateType(ctx: any, slug: string, options: any): Promise<void>
 
   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')
@@ -63,7 +52,7 @@ async function generateType(ctx: any, slug: string, options: any): Promise<void>
     .eq('kind', kind)
     .single()
 
-  if (checkErr && checkErr.code !== 'PGRST116') { // PGRST116 = not found
+  if (checkErr && checkErr.code !== 'PGRST116') {
     throw new Error(`Failed to check existing type: ${checkErr.message}`)
   }
 
@@ -111,8 +100,6 @@ async function generateType(ctx: any, slug: string, options: any): Promise<void>
     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) {
@@ -123,8 +110,6 @@ async function generateType(ctx: any, slug: string, options: any): Promise<void>
     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')
 
@@ -143,7 +128,21 @@ async function generateType(ctx: any, slug: string, options: any): Promise<void>
   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`)
 }
-
+// CIL[END chunk_id="generate_generatetype_1784069813"]
+// CIL[BEGIN chunk_id="generate_generatehandlerstub_1784069813" type="function" identity="generateHandlerStub" parent="none"]
+// CIL[DOC-MACRO purpose="Generate TypeScript handler stub code"]
+// CIL[DOC-RESPONSIBILITY responsibility="Create API handler template with method routing"]
+// CIL[DOC-CONTEXT module="cli.commands.generate" layer="cli" related_files="[\".framework/src/pages/admin/RolesPage.tsx\",\".framework/functions/_shared/schema-utils.ts\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="handler code string" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Returns template code for API handler with GET, POST, PATCH, DELETE methods" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-VECTOR type="context" content="Layer: cli. Direct callers: 0. Direct calls: 0. Related files: .framework/src/pages/admin/RolesPage.tsx, .framework/functions/_shared/schema-utils.ts, \."]
+// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
+// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
+// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 function generateHandlerStub(slug: string, kind: string, name: string): string {
   return `/**
  * @module ${slug}
@@ -164,19 +163,15 @@ export const handler = createHandler(async (ctx) => {
 
   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:
@@ -185,7 +180,21 @@ export const handler = createHandler(async (ctx) => {
 })
 `
 }
-
+// CIL[END chunk_id="generate_generatehandlerstub_1784069813"]
+// CIL[BEGIN chunk_id="generate_generatepagestub_1784069813" type="function" identity="generatePageStub" parent="none"]
+// CIL[DOC-MACRO purpose="Generate React page stub code"]
+// CIL[DOC-RESPONSIBILITY responsibility="Create UI page template with API integration"]
+// CIL[DOC-CONTEXT module="cli.commands.generate" layer="cli" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/src/pages/admin/RolesPage.tsx\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/src/pages/admin/IntegrationsPage.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="page code string" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Returns React component template with API hooks and data display" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-VECTOR type="context" content="Layer: cli. Direct callers: 0. Direct calls: 0. Related files: custom/apps/portal/pages/ContentPage.tsx, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .framework/src/pages/admin/RolesPage.tsx, .framework/src/pages/admin/TypeDetailPage.tsx, .framework/src/pages/admin/IntegrationsPage.tsx, \."]
+// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
+// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
+// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 function generatePageStub(slug: string, name: string, kind: string): string {
   return `/**
  * @page ${slug}/index
@@ -227,86 +236,29 @@ export default function ${name.replace(/\s+/g, '')}Page() {
 }
 `
 }
-
-// ─── 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 ────────────────────────────────────────────────────
-
+// CIL[END chunk_id="generate_generatepagestub_1784069813"]
+// CIL[BEGIN chunk_id="generate_registergeneratecommands_1784069813" type="function" identity="registerGenerateCommands" parent="none"]
+// CIL[DOC-MACRO purpose="Register generate command with CLI program"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide CLI interface for type generation"]
+// CIL[DOC-CONTEXT module="cli.commands.generate" layer="cli" related_files="[\".framework/src/pages/admin/RolesPage.tsx\",\".framework/functions/_shared/schema-utils.ts\",\".framework/src/components/ui/dialog.tsx\",\".framework/functions/_shared/principal.ts\",\".framework/functions/_shared/db.ts\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="CLI command registration" errors="command errors" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Registers generate command with slug argument and various options" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-VECTOR type="context" content="Layer: cli. Direct callers: 0. Direct calls: 0. Related files: .framework/src/pages/admin/RolesPage.tsx, .framework/functions/_shared/schema-utils.ts, .framework/src/components/ui/dialog.tsx, .framework/functions/_shared/principal.ts, .framework/functions/_shared/db.ts."]
+// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
+// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
+// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 export function registerGenerateCommands(program: Command) {
-  const generate = program
+  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')
+    .description('Generate type, handler, and UI stubs')
+    .argument('<slug>', 'Type slug (e.g., support-ticket)')
+    .option('--name <name>', 'Human-readable name')
+    .option('--kind <kind>', 'Type kind', 'item')
+    .option('--description <description>', 'Type description')
     .option('--force', 'Overwrite existing files', false)
     .action(async (slug, opts) => {
       try {
@@ -316,17 +268,5 @@ export function registerGenerateCommands(program: Command) {
         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)
-      }
-    })
 }
+// CIL[END chunk_id="generate_registergeneratecommands_1784069813"]

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

@@ -1,20 +1,21 @@
-/// <reference types="node" />
-/**
- * @module cli/commands/init
- * @audience installer
- * @layer cli
- * @stability stable
- *
- * `spine-framework init` — scaffolds a new Spine Framework project in the
- * current directory. Copies framework files, creates the custom/ workspace,
- * writes package.json and .env template.
- *
- * **Usage:**
- * ```bash
- * npx spine-framework init
- * ```
- */
 
+
+
+// CIL[BEGIN chunk_id="init_moduleheader_1784069813" type="module_header" identity="module_header" parent="none"]
+// CIL[DOC-MACRO purpose="Module imports and constants for init command"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide filesystem utilities and path constants"]
+// CIL[DOC-CONTEXT module="cli.commands.init" layer="cli" related_files="[\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/migrations/015_simplify_apps_table.sql\",\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/functions/_shared/principal.ts\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="constants" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Imports Node.js fs, path modules and defines package/project root paths" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-AUDIENCE audience="installer"]
+// CIL[DOC-VECTOR type="context" content="Layer: cli. Direct callers: 0. Direct calls: 0. Related files: custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .framework/migrations/015_simplify_apps_table.sql, custom/apps/portal/pages/ContentPage.tsx, .framework/src/pages/admin/TypeDetailPage.tsx, .framework/functions/_shared/principal.ts, \."]
+// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
+// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
+// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 import type { Command } from 'commander'
 import { existsSync, mkdirSync, writeFileSync, copyFileSync, readdirSync, statSync, cpSync, readFileSync } from 'fs'
 import { resolve, dirname, join } from 'path'
@@ -24,11 +25,23 @@ import { execSync } from 'child_process'
 const __filename = fileURLToPath(import.meta.url)
 const __dirname = dirname(__filename)
 
-// Root of the spine-framework package (node_modules/spine-framework/)
 const PACKAGE_ROOT = resolve(__dirname, '../../../')
-// Root of the user's project (cwd)
 const PROJECT_ROOT = process.cwd()
-
+// CIL[END chunk_id="init_moduleheader_1784069813"]
+// CIL[BEGIN chunk_id="init_registerinitcommands_1784069813" type="function" identity="registerInitCommands" parent="none"]
+// CIL[DOC-MACRO purpose="Register init command with CLI program"]
+// CIL[DOC-RESPONSIBILITY responsibility="Scaffold new Spine Framework projects"]
+// CIL[DOC-CONTEXT module="cli.commands.init" layer="cli" related_files="[\".framework/functions/_shared/schema-utils.ts\",\".framework/src/components/ui/dialog.tsx\",\".framework/functions/_shared/principal.ts\",\".framework/migrations/015_simplify_apps_table.sql\",\".framework/src/components/ui/table-primitives.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="CLI command registration" errors="init failures" side_effects="filesystem writes"]
+// CIL[DOC-MICRO logic_summary="Copies framework files, creates directories, writes package.json and config files" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-VECTOR type="context" content="Layer: cli. Direct callers: 0. Direct calls: 0. Related files: .framework/functions/_shared/schema-utils.ts, .framework/src/components/ui/dialog.tsx, .framework/functions/_shared/principal.ts, .framework/migrations/015_simplify_apps_table.sql, .framework/src/components/ui/table-primitives.tsx, \."]
+// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
+// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
+// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 export function registerInitCommands(program: Command) {
   program
     .command('init')
@@ -37,7 +50,7 @@ export function registerInitCommands(program: Command) {
     .action(async (opts) => {
       console.log('\nInitializing Spine Framework project...\n')
 
-      // Warn if this looks like an existing non-Spine project
+      
       const existingPkg = join(PROJECT_ROOT, 'package.json')
       if (existsSync(existingPkg) && !opts.force) {
         try {
@@ -52,7 +65,7 @@ export function registerInitCommands(program: Command) {
       }
 
       try {
-        // 1. Copy .framework/ into the project
+        
         console.log('  Copying .framework/...')
         const fwSrc = join(PACKAGE_ROOT, '.framework')
         const fwDest = join(PROJECT_ROOT, '.framework')
@@ -63,7 +76,7 @@ export function registerInitCommands(program: Command) {
           console.log('  ○ .framework/ already exists, skipping')
         }
 
-        // 2. Create custom/ workspace directories
+        
         console.log('  Creating custom/ workspace...')
         const customDirs = [
           'custom/apps',
@@ -78,7 +91,7 @@ export function registerInitCommands(program: Command) {
             mkdirSync(full, { recursive: true })
           }
         }
-        // Copy custom/.devin if present in package
+        
         const devinSrc = join(PACKAGE_ROOT, 'custom/.devin')
         const devinDest = join(PROJECT_ROOT, 'custom/.devin')
         if (existsSync(devinSrc) && !existsSync(devinDest)) {
@@ -86,7 +99,7 @@ export function registerInitCommands(program: Command) {
         }
         console.log('  ✓ custom/ workspace created')
 
-        // 3. Copy config files (vite, tailwind, tsconfig, postcss)
+        
         console.log('  Copying config files...')
         const configSrc = join(PACKAGE_ROOT, 'config')
         const configDest = join(PROJECT_ROOT, 'config')
@@ -95,7 +108,7 @@ export function registerInitCommands(program: Command) {
           console.log('  ✓ config/ copied')
         }
 
-        // 4. Copy scripts/
+        
         console.log('  Copying scripts/...')
         const scriptsSrc = join(PACKAGE_ROOT, 'scripts')
         const scriptsDest = join(PROJECT_ROOT, 'scripts')
@@ -104,14 +117,24 @@ export function registerInitCommands(program: Command) {
           console.log('  ✓ scripts/ copied')
         }
 
-        // 5. Copy netlify.toml
+        
         const netlifyTomlSrc = join(PACKAGE_ROOT, 'netlify.toml')
         if (existsSync(netlifyTomlSrc) && !existsSync(join(PROJECT_ROOT, 'netlify.toml'))) {
           copyFileSync(netlifyTomlSrc, join(PROJECT_ROOT, 'netlify.toml'))
           console.log('  ✓ netlify.toml copied')
         }
 
-        // 6. Write package.json
+        
+        const spineConfigSrc = join(PACKAGE_ROOT, 'spine.config.json')
+        const spineConfigDest = join(PROJECT_ROOT, 'spine.config.json')
+        if (existsSync(spineConfigSrc) && !existsSync(spineConfigDest)) {
+          copyFileSync(spineConfigSrc, spineConfigDest)
+          console.log('  ✓ spine.config.json copied')
+        } else if (existsSync(spineConfigDest) && !JSON.parse(readFileSync(spineConfigDest, 'utf8'))?.registration?.default_app_by_role) {
+          console.log('  ⚠ Existing spine.config.json does not have default_app_by_role; consider updating it')
+        }
+
+        
         console.log('  Writing package.json...')
         const projectName = PROJECT_ROOT.split('/').pop() || 'my-spine-project'
         const pkgJson = {
@@ -148,7 +171,7 @@ export function registerInitCommands(program: Command) {
             'vitest': '^2.1.9',
           },
         }
-        // Merge with existing package.json if present (preserve name, version, existing deps)
+        
         let finalPkg = pkgJson
         if (existsSync(join(PROJECT_ROOT, 'package.json'))) {
           try {
@@ -157,9 +180,9 @@ export function registerInitCommands(program: Command) {
               ...pkgJson,
               name: existing.name || pkgJson.name,
               version: existing.version || pkgJson.version,
-              // spine template deps win over existing — ensures required tooling is present
+              
               dependencies: { ...existing.dependencies, ...pkgJson.dependencies },
-              // merge: template provides required devDeps, existing additions are preserved
+              
               devDependencies: { ...pkgJson.devDependencies, ...existing.devDependencies },
             }
           } catch {}
@@ -170,7 +193,7 @@ export function registerInitCommands(program: Command) {
         )
         console.log('  ✓ package.json written')
 
-        // 7. Write .env template
+        
         console.log('  Writing .env template...')
         if (!existsSync(join(PROJECT_ROOT, '.env'))) {
           const envTemplate = [
@@ -195,7 +218,7 @@ export function registerInitCommands(program: Command) {
           console.log('  ○ .env already exists, skipping')
         }
 
-        // 8. Write .gitignore
+        
         if (!existsSync(join(PROJECT_ROOT, '.gitignore'))) {
           const gitignore = [
             'node_modules',
@@ -214,7 +237,7 @@ export function registerInitCommands(program: Command) {
           console.log('  ✓ .gitignore written')
         }
 
-        // Read installed package version from the package's own package.json
+        
         let pkgVersion = 'unknown'
         try {
           const pkgJson = JSON.parse(readFileSync(join(PACKAGE_ROOT, 'package.json'), 'utf8'))
@@ -236,7 +259,21 @@ export function registerInitCommands(program: Command) {
       }
     })
 }
-
+// CIL[END chunk_id="init_registerinitcommands_1784069813"]
+// CIL[BEGIN chunk_id="init_getpackageversion_1784069813" type="function" identity="getPackageVersion" parent="none"]
+// CIL[DOC-MACRO purpose="Get package version from package.json"]
+// CIL[DOC-RESPONSIBILITY responsibility="Read and return framework version"]
+// CIL[DOC-CONTEXT module="cli.commands.init" layer="cli" related_files="[\".framework/src/pages/admin/RolesPage.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="version string" errors="file read errors" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Reads package.json and returns version with fallback to 0.3.0" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-VECTOR type="context" content="Layer: cli. Direct callers: 0. Direct calls: 0. Related files: .framework/src/pages/admin/RolesPage.tsx, \."]
+// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
+// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
+// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 function getPackageVersion(): string {
   try {
     const pkg = JSON.parse(
@@ -247,3 +284,4 @@ function getPackageVersion(): string {
     return '0.3.0'
   }
 }
+// CIL[END chunk_id="init_getpackageversion_1784069813"]