spine-framework 0.3.124 → 0.3.126

package/.framework/cli/commands/agents.ts

@@ -1,45 +1,41 @@
-/// <reference types="node" />
-/**
- * @module cli/commands/agents
- * @audience installer
- * @layer cli
- * @stability stable
- *
- * `spine agents` command group. Sends messages to AI agent threads and
- * inspects thread state from the terminal or an agentic IDE. `agents run`
- * calls `runAgent` — the same function used by API handlers — so responses
- * are recorded in the `messages` table like any other agent turn.
- *
- * **Commands:**
- * | Subcommand                                       | Description                           |
- * |--------------------------------------------------|---------------------------------------|
- * | `agents run <threadId> --message <text>`         | Send a message and print the response |
- * | `agents threads list [--account <id>]`           | List agent threads                    |
- * | `agents threads get <id> [--limit <n>]`          | Show thread + recent messages         |
- *
- * **Usage:**
- * ```bash
- * spine agents run <uuid> --message "Summarize the last 10 tickets" --json
- * spine agents threads list --account <id> --limit 10
- * spine agents threads get <uuid>
- * ```
- *
- * @seeAlso cli/context.ts (buildCliContext)
- * @seeAlso functions/_shared/agent-runner.ts (runAgent)
- * @seeAlso functions/ai-agents.ts (agent configuration CRUD)
- */
+// CIL[BEGIN chunk_id="agents_module_header_1784183721" type="module_header" identity="module_header" parent="none"]
+// CIL[DOC-MACRO purpose="Preamble and imports for agents"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provides imports and top-level types/constants used by the rest of the module"]
+// CIL[DOC-CONTEXT module=".framework/cli/commands/agents" layer="cli" related_files="[\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/functions/_shared/principal.ts\",\".framework/functions/_shared/schema-utils.ts\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="imports, types, constants" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Imports external dependencies and declares shared types or constants" 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, custom/apps/portal/pages/ContentPage.tsx, .framework/src/pages/admin/TypeDetailPage.tsx, .framework/functions/_shared/principal.ts, .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"]
+
+
 
 import type { Command } from 'commander'
 import { buildCliContext, printResult, handleError } from '../context.ts'
 import { runAgent, adminDb } from '../../functions/_shared/index.ts'
 
-/**
- * Registers the `agents` subcommand group on the root Commander program.
- *
- * @param program - The root `spine` Commander instance
- * @sideEffects Adds `agents run`, `agents threads list/get` subcommands to `program`
- * @calledBy cli/index.ts
- */
+
+// CIL[END chunk_id="agents_module_header_1784183721"]
+// CIL[BEGIN chunk_id="agents_registeragentcommands_1784183721" type="function" identity="registerAgentCommands" parent="none"]
+// CIL[DOC-MACRO purpose="Implement the registerAgentCommands helper function"]
+// CIL[DOC-RESPONSIBILITY responsibility="Owns the registerAgentCommands computation and return value"]
+// CIL[DOC-CONTEXT module=".framework/cli/commands/agents" layer="cli" related_files="[\"custom/apps/cortex/functions/custom_cil-embeddings.ts\",\".framework/functions/_shared/principal.ts\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/functions/_shared/schema-utils.ts\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="void" errors="Error" side_effects="logs to console, queries database, builds CLI context"]
+// CIL[DOC-MICRO logic_summary="Computes and returns void" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="external_symbols_unknown"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-VECTOR type="context" content="Layer: cli. Direct callers: 0. Direct calls: 0. Related files: custom/apps/cortex/functions/custom_cil-embeddings.ts, .framework/functions/_shared/principal.ts, custom/apps/cortex/pages/operations/OperationsDashboard.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"]
 export function registerAgentCommands(program: Command) {
   const agents = program
     .command('agents')
@@ -151,3 +147,5 @@ export function registerAgentCommands(program: Command) {
       }
     })
 }
+
+// CIL[END chunk_id="agents_registeragentcommands_1784183721"]

package/.framework/cli/commands/auth.ts

@@ -1,40 +1,40 @@
-/**
- * @module cli/commands/auth
- * @audience installer
- * @layer cli
- * @stability stable
- *
- * `spine auth` command group. Exposes two subcommands for verifying and
- * inspecting the currently configured CLI credentials without performing
- * any data operations.
- *
- * **Commands:**
- * | Subcommand        | Description                                           |
- * |-------------------|-------------------------------------------------------|
- * | `auth whoami`     | Print the resolved principal for the current env      |
- * | `auth check`      | Validate credentials; exit 0 on success, 1 on failure |
- *
- * **Usage:**
- * ```bash
- * spine auth whoami
- * spine auth whoami --json
- * spine auth check
- * ```
- *
- * @seeAlso cli/context.ts (buildCliContext — principal resolution)
- * @seeAlso functions/auth.ts (API equivalent)
- */
 
+
+
+
+
+// CIL[BEGIN chunk_id="auth_module_header_1784071456" type="module_header" identity="module_header" parent="none"]
+// CIL[DOC-MACRO purpose="Import dependencies for auth CLI commands"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide imports for auth command registration"]
+// CIL[DOC-CONTEXT module="auth-cli" layer="cli" related_files="[\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/functions/_shared/principal.ts\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/functions/_shared/schema-utils.ts\",\"custom/apps/portal/pages/ContentPage.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="imports" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Imports Command type and CLI context utilities" 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/functions/_shared/principal.ts, .framework/src/pages/admin/TypeDetailPage.tsx, .framework/functions/_shared/schema-utils.ts, custom/apps/portal/pages/ContentPage.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"]
 import type { Command } from 'commander'
 import { buildCliContext, handleError } from '../context.js'
-
-/**
- * Registers the `auth` subcommand group on the root Commander program.
- *
- * @param program - The root `spine` Commander instance
- * @sideEffects Adds `auth whoami` and `auth check` subcommands to `program`
- * @calledBy cli/index.ts
- */
+// CIL[END chunk_id="auth_module_header_1784071456"]
+// CIL[BEGIN chunk_id="auth_registerauthcommands_1784071456" type="function" identity="registerAuthCommands" parent="none"]
+// CIL[DOC-MACRO purpose="Register auth commands with CLI framework"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide whoami and check subcommands for auth"]
+// CIL[DOC-CONTEXT module="auth-cli" layer="cli" related_files="[\".framework/functions/_shared/principal.ts\",\".framework/functions/_shared/schema-utils.ts\",\".framework/src/components/ui/dialog.tsx\",\".framework/src/components/ui/table-primitives.tsx\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="auth command registration" errors="CLI context errors" side_effects="outputs identity info"]
+// CIL[DOC-MICRO logic_summary="Registers whoami and check commands for identity validation" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="external_symbols_unknown"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-VECTOR type="context" content="Layer: cli. Direct callers: 0. Direct calls: 0. Related files: .framework/functions/_shared/principal.ts, .framework/functions/_shared/schema-utils.ts, .framework/src/components/ui/dialog.tsx, .framework/src/components/ui/table-primitives.tsx, .framework/src/pages/admin/TypeDetailPage.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 registerAuthCommands(program: Command) {
   const auth = program
     .command('auth')
@@ -92,3 +92,4 @@ export function registerAuthCommands(program: Command) {
       }
     })
 }
+// CIL[END chunk_id="auth_registerauthcommands_1784071456"]

package/.framework/cli/commands/create-app.ts

@@ -1,25 +1,26 @@
-/// <reference types="node" />
-/**
- * @module cli/commands/create-app
- * @audience installer
- * @layer cli
- * @stability stable
- *
- * `spine-framework create-app <slug>` — scaffold a new custom app.
- *
- * Creates the full directory structure under `custom/apps/{slug}/`:
- *   - manifest.json     (app metadata, roles, routes, nav_items)
- *   - index.tsx         (React entry point)
- *   - components/       (empty dir with .gitkeep)
- *
- * **Usage:**
- * ```bash
- * npm run spine-framework create-app my-app
- * npm run spine-framework create-app my-app --name "My App" --role member
- * npm run spine-framework create-app my-app --force
- * ```
- */
 
+
+
+
+
+
+
+
+// CIL[BEGIN chunk_id="create-app_module_header_1784071456" type="module_header" identity="module_header" parent="none"]
+// CIL[DOC-MACRO purpose="Import dependencies for create-app CLI command"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide imports and utilities for app scaffolding"]
+// CIL[DOC-CONTEXT module="create-app-cli" layer="cli" related_files="[\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/functions/_shared/principal.ts\",\".framework/functions/_shared/schema-utils.ts\",\"custom/apps/portal/pages/ContentPage.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="imports" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Imports Command type, file system, path, and database 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/src/pages/admin/TypeDetailPage.tsx, .framework/functions/_shared/principal.ts, .framework/functions/_shared/schema-utils.ts, custom/apps/portal/pages/ContentPage.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"]
 import type { Command } from 'commander'
 import { existsSync, mkdirSync, writeFileSync } from 'fs'
 import { resolve, dirname } from 'path'
@@ -29,11 +30,39 @@ import { adminDb } from '../../functions/_shared/index.ts'
 const __filename = fileURLToPath(import.meta.url)
 const __dirname = dirname(__filename)
 const PROJECT_ROOT = resolve(__dirname, '../../../')
-
+// CIL[END chunk_id="create-app_module_header_1784071456"]
+// CIL[BEGIN chunk_id="create-app_totitlecase_1784071456" type="function" identity="toTitleCase" parent="none"]
+// CIL[DOC-MACRO purpose="Convert slug to title case format"]
+// CIL[DOC-RESPONSIBILITY responsibility="Format slugs as readable display names"]
+// CIL[DOC-CONTEXT module="create-app-cli" layer="cli" related_files="[\".framework/src/components/ui/dialog.tsx\",\"custom/apps/cortex/functions/custom_cil-embeddings.ts\",\"custom/apps/portal/pages/ContentPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/src/pages/admin/RolesPage.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="string" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Converts kebab-case to Title Case for display names" 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/components/ui/dialog.tsx, custom/apps/cortex/functions/custom_cil-embeddings.ts, custom/apps/portal/pages/ContentPage.tsx, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .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 toTitleCase(slug: string): string {
   return slug.split('-').map(s => s.charAt(0).toUpperCase() + s.slice(1)).join(' ')
 }
-
+// CIL[END chunk_id="create-app_totitlecase_1784071456"]
+// CIL[BEGIN chunk_id="create-app_generatemanifest_1784071456" type="function" identity="generateManifest" parent="none"]
+// CIL[DOC-MACRO purpose="Generate app manifest JSON content"]
+// CIL[DOC-RESPONSIBILITY responsibility="Create default manifest configuration for new apps"]
+// CIL[DOC-CONTEXT module="create-app-cli" layer="cli" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/migrations/015_simplify_apps_table.sql\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\"custom/apps/cortex/functions/custom_cil-embeddings.ts\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="string" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Creates JSON manifest with routes, nav items, and metadata" 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, .framework/migrations/015_simplify_apps_table.sql, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, custom/apps/cortex/functions/custom_cil-embeddings.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 generateManifest(slug: string, name: string, role: string): string {
   return JSON.stringify({
     name,
@@ -58,18 +87,24 @@ function generateManifest(slug: string, name: string, role: string): string {
     entry_point: "./index.tsx"
   }, null, 2) + '\n'
 }
-
+// CIL[END chunk_id="create-app_generatemanifest_1784071456"]
+// CIL[BEGIN chunk_id="create-app_generateindextsx_1784071456" type="function" identity="generateIndexTsx" parent="none"]
+// CIL[DOC-MACRO purpose="Generate React component index file"]
+// CIL[DOC-RESPONSIBILITY responsibility="Create default React app component with routing"]
+// CIL[DOC-CONTEXT module="create-app-cli" layer="cli" related_files="[\".framework/src/components/ui/dialog.tsx\",\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/src/components/ui/table-primitives.tsx\",\".framework/src/pages/admin/RolesPage.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="string" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Generates TSX file with React Router and dashboard 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: .framework/src/components/ui/dialog.tsx, custom/apps/portal/pages/ContentPage.tsx, .framework/src/components/ui/table-primitives.tsx, .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 generateIndexTsx(slug: string, name: string): string {
   const componentName = slug.split('-').map(s => s.charAt(0).toUpperCase() + s.slice(1)).join('')
-  return `/**
- * @module custom/apps/${slug}
- * @audience custom
- * @layer frontend-app
- * @stability experimental
- *
- * Entry point for the ${name} app.
- * Generated by spine-framework CLI on ${new Date().toISOString().split('T')[0]}.
- */
+  return `
 
 import * as React from 'react'
 import { Routes, Route, Navigate } from 'react-router-dom'
@@ -93,7 +128,21 @@ export default function ${componentName}App() {
 }
 `
 }
-
+// CIL[END chunk_id="create-app_generateindextsx_1784071456"]
+// CIL[BEGIN chunk_id="create-app_createapp_1784071456" type="function" identity="createApp" parent="none"]
+// CIL[DOC-MACRO purpose="Create new app directory and database entry"]
+// CIL[DOC-RESPONSIBILITY responsibility="Scaffold app files and register in database"]
+// CIL[DOC-CONTEXT module="create-app-cli" layer="cli" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/migrations/015_simplify_apps_table.sql\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/functions/_shared/db.ts\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="void" errors="file system and database errors" side_effects="creates files, inserts database records"]
+// CIL[DOC-MICRO logic_summary="Creates app structure, generates files, and registers app in database" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="external_symbols_unknown"]
+// 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, .framework/migrations/015_simplify_apps_table.sql, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .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"]
 async function createApp(slug: string, options: { name?: string; role: string; force: boolean }): Promise<void> {
   const name = options.name || toTitleCase(slug)
   const appDir = resolve(PROJECT_ROOT, `custom/apps/${slug}`)
@@ -106,29 +155,29 @@ async function createApp(slug: string, options: { name?: string; role: string; f
     process.exit(1)
   }
 
-  // 1. Create directories
+  
   mkdirSync(resolve(appDir, 'components'), { recursive: true })
   console.log(`  ✓ Created custom/apps/${slug}/`)
   console.log(`  ✓ Created custom/apps/${slug}/components/`)
 
-  // 2. manifest.json
+  
   writeFileSync(
     resolve(appDir, 'manifest.json'),
     generateManifest(slug, name, options.role)
   )
   console.log(`  ✓ Created custom/apps/${slug}/manifest.json`)
 
-  // 3. index.tsx
+  
   writeFileSync(
     resolve(appDir, 'index.tsx'),
     generateIndexTsx(slug, name)
   )
   console.log(`  ✓ Created custom/apps/${slug}/index.tsx`)
 
-  // 4. components/.gitkeep
+  
   writeFileSync(resolve(appDir, 'components', '.gitkeep'), '')
 
-  // 5. Insert app record into database
+  
   console.log(`  Registering app in database...`)
   const { data: existing } = await adminDb
     .from('apps')
@@ -166,7 +215,21 @@ async function createApp(slug: string, options: { name?: string; role: string; f
   console.log(`   2. Edit custom/apps/${slug}/index.tsx to build your app`)
   console.log(`   3. npm run assemble && netlify dev`)
 }
-
+// CIL[END chunk_id="create-app_createapp_1784071456"]
+// CIL[BEGIN chunk_id="create-app_registercreateappcommands_1784071456" type="function" identity="registerCreateAppCommands" parent="none"]
+// CIL[DOC-MACRO purpose="Register create-app command with CLI framework"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide app scaffolding command interface"]
+// CIL[DOC-CONTEXT module="create-app-cli" layer="cli" related_files="[]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="create-app command registration" errors="app creation errors" side_effects="creates app files and database entries"]
+// CIL[DOC-MICRO logic_summary="Registers create-app command with options for name, role, and force" 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: none."]
+// 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 registerCreateAppCommands(program: Command) {
   program
     .command('create-app <slug>')
@@ -183,3 +246,4 @@ export function registerCreateAppCommands(program: Command) {
       }
     })
 }
+// CIL[END chunk_id="create-app_registercreateappcommands_1784071456"]