spine-framework 0.3.125 → 0.3.127

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

@@ -1,12 +1,18 @@
-
-
-// CIL[BEGIN chunk_id="generate_module_header_1783475972" type="module_header" identity="module_header" parent="none"]
-// CIL[DOC-MACRO purpose="Setup imports and path constants for generate command"]
-// CIL[DOC-RESPONSIBILITY responsibility="Configure module dependencies and file paths"]
-// CIL[DOC-CONTEXT module="cli/commands/generate" layer="cli" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="imports, paths" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Import CLI framework, database, and file system utilities" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="first" score="0.95" flags="none"]
+// 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'
@@ -17,17 +23,21 @@ import { fileURLToPath } from 'url'
 const __filename = fileURLToPath(import.meta.url)
 const __dirname = dirname(__filename)
 const PROJECT_ROOT = resolve(__dirname, '../../../')
-// CIL[END chunk_id="generate_module_header_1783475972"]
-
-
-
-// CIL[BEGIN chunk_id="generate_generatetype_1783475972" type="function" identity="generateType" parent="none"]
-// CIL[DOC-MACRO purpose="Generate complete type with database record and code stubs"]
-// CIL[DOC-RESPONSIBILITY responsibility="Create type in DB and generate handler/UI files"]
-// CIL[DOC-CONTEXT module="cli/commands/generate" layer="cli" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="ctx, slug, options" outputs="none" errors="database errors, file errors" side_effects="file creation, DB writes"]
-// CIL[DOC-MICRO logic_summary="Create DB type record, generate handler stub, generate UI page stub" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="first" score="0.85" flags="none"]
+// 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'
@@ -35,8 +45,6 @@ async function generateType(ctx: any, slug: string, options: any): Promise<void>
 
   console.log(`\n🔧 Generating type '${slug}'...`)
 
-  
-
   const { data: existing, error: checkErr } = await adminDb
     .from('types')
     .select('id')
@@ -92,7 +100,6 @@ async function generateType(ctx: any, slug: string, options: any): Promise<void>
     console.log('  ✓ Type record created')
   }
 
-  
   const handlerPath = resolve(PROJECT_ROOT, `v2-custom/functions/${slug}.ts`)
 
   if (existsSync(handlerPath) && !options.force) {
@@ -103,7 +110,6 @@ async function generateType(ctx: any, slug: string, options: any): Promise<void>
     console.log(`  ✓ Handler stub created: v2-custom/functions/${slug}.ts`)
   }
 
-  
   const pageDir = resolve(PROJECT_ROOT, `v2-custom/src/pages/${slug}`)
   const pagePath = resolve(pageDir, 'index.tsx')
 
@@ -122,15 +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_1783475972"]
-
-// CIL[BEGIN chunk_id="generate_generatehandlerstub_1783475972" type="function" identity="generateHandlerStub" parent="none"]
-// CIL[DOC-MACRO purpose="Generate TypeScript handler stub with CRUD methods"]
-// CIL[DOC-RESPONSIBILITY responsibility="Create template handler code for new types"]
-// CIL[DOC-CONTEXT module="cli/commands/generate" layer="cli" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="slug, kind, name" outputs="string handler code" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Return template string with handler structure and HTTP methods" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="first" score="0.90" flags="none"]
+// 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}
@@ -151,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:
@@ -172,15 +180,21 @@ export const handler = createHandler(async (ctx) => {
 })
 `
 }
-// CIL[END chunk_id="generate_generatehandlerstub_1783475972"]
-
-// CIL[BEGIN chunk_id="generate_generatepagestub_1783475972" type="function" identity="generatePageStub" parent="none"]
-// CIL[DOC-MACRO purpose="Generate React UI page stub for type management"]
-// CIL[DOC-RESPONSIBILITY responsibility="Create template React component with API integration"]
-// CIL[DOC-CONTEXT module="cli/commands/generate" layer="cli" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="slug, name, kind" outputs="string React component code" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Return template string with React component and API hooks" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="first" score="0.90" flags="none"]
+// 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
@@ -222,108 +236,28 @@ export default function ${name.replace(/\s+/g, '')}Page() {
 }
 `
 }
-// CIL[END chunk_id="generate_generatepagestub_1783475972"]
-
-
-
-// CIL[BEGIN chunk_id="generate_generatefunction_1783475972" type="function" identity="generateFunction" parent="none"]
-// CIL[DOC-MACRO purpose="Generate standalone Netlify function stub"]
-// CIL[DOC-RESPONSIBILITY responsibility="Create custom function file with basic structure"]
-// CIL[DOC-CONTEXT module="cli/commands/generate" layer="cli" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="name, options" outputs="none" errors="file errors" side_effects="file creation"]
-// CIL[DOC-MICRO logic_summary="Check existing file, generate function stub, write to disk" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="first" score="0.90" flags="none"]
-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`)
-}
-// CIL[END chunk_id="generate_generatefunction_1783555400"]
-
-// CIL[BEGIN chunk_id="generate_generatefunctionstub_1783555400" type="function" identity="generateFunctionStub" parent="none"]
-// CIL[DOC-MACRO purpose="Generate standalone Netlify function template"]
-// CIL[DOC-RESPONSIBILITY responsibility="Create template function with action routing"]
-// CIL[DOC-CONTEXT module="cli/commands/generate" layer="cli" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="name, description" outputs="string function code" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Return template string with handler structure and action switch" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="first" score="0.90" flags="none"]
-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']
-      }
-  }
-})
-`
-}
-// CIL[END chunk_id="generate_generatefunctionstub_1783555400"]
-
-// CIL[BEGIN chunk_id="generate_registergeneratecommands_1783555400" type="function" identity="registerGenerateCommands" parent="none"]
-// CIL[DOC-MACRO purpose="Register generate CLI commands for type and function scaffolding"]
-// CIL[DOC-RESPONSIBILITY responsibility="Setup CLI interface for code generation tools"]
-// CIL[DOC-CONTEXT module="cli/commands/generate" layer="cli" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="Command program" outputs="registered CLI commands" errors="CLI errors" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Register 'generate type' and 'generate function' subcommands with options" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="first" score="0.90" flags="none"]
+// 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
-    .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')
+  program
+    .command('generate <slug>')
+    .description('Generate type, handler, and UI stubs')
+    .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 {
@@ -333,18 +267,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_1783555400"]
+// 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"]