spine-framework 0.3.124 → 0.3.126

package/.framework/cli/commands/items.ts

@@ -1,51 +1,39 @@
-/// <reference types="node" />
-/**
- * @module cli/commands/items
- * @audience installer
- * @layer cli
- * @stability stable
- *
- * `spine items` command group. Direct CRUD access to the `items` table via
- * `adminDb` (service-role, bypasses RLS). Use only in controlled environments;
- * does NOT enforce field-level permissions or RLS for the principal.
- *
- * **Commands:**
- * | Subcommand                                     | Description                    |
- * |------------------------------------------------|--------------------------------|
- * | `items list [--type <slug>] [--account <id>]`  | List items, filtered by type   |
- * | `items get <id>`                               | Fetch a single item by UUID    |
- * | `items create --type <slug> --data <json>`     | Insert a new item              |
- * | `items update <id> --data <json>`              | Patch item data fields         |
- * | `items delete <id> [--hard]`                   | Soft-delete or hard-delete     |
- *
- * **Authorization note:** All commands use `adminDb` — no RLS enforcement.
- * Account scoping is applied as a filter only; it does not restrict access.
- *
- * **Usage:**
- * ```bash
- * spine items list --type support_ticket --account <id> --limit 50
- * spine items get <uuid>
- * spine items create --type support_ticket --title "Bug report" --data '{"priority":"high"}'
- * spine items update <uuid> --data '{"status":"resolved"}'
- * spine items delete <uuid>
- * spine items delete <uuid> --hard
- * ```
- *
- * @seeAlso cli/context.ts (buildCliContext)
- * @seeAlso functions/admin-data.ts (API equivalent with RLS)
- */
 
+
+
+// CIL[BEGIN chunk_id="items_moduleheader_1784069813" type="module_header" identity="module_header" parent="none"]
+// CIL[DOC-MACRO purpose="Module imports for item management CLI"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide CLI context and database access"]
+// CIL[DOC-CONTEXT module="cli.commands.items" 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/functions/_shared/principal.ts\",\".framework/functions/_shared/schema-utils.ts\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="imports" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Imports Commander types, CLI context utilities, and admin database" 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/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 { adminDb } from '../../functions/_shared/index.ts'
-
-/**
- * Registers the `items` subcommand group on the root Commander program.
- *
- * @param program - The root `spine` Commander instance
- * @sideEffects Adds `items list/get/create/update/delete` subcommands to `program`
- * @calledBy cli/index.ts
- */
+// CIL[END chunk_id="items_moduleheader_1784069813"]
+// CIL[BEGIN chunk_id="items_registeritemcommands_1784069813" type="function" identity="registerItemCommands" parent="none"]
+// CIL[DOC-MACRO purpose="Register item management CLI commands"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide CRUD operations for item records"]
+// CIL[DOC-CONTEXT module="cli.commands.items" layer="cli" related_files="[\".framework/src/pages/admin/TypeDetailPage.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="CLI commands" errors="database errors" side_effects="database operations"]
+// CIL[DOC-MICRO logic_summary="Registers list, get, create, update, delete commands for items table" 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/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 registerItemCommands(program: Command) {
   const items = program
     .command('items')
@@ -251,3 +239,4 @@ export function registerItemCommands(program: Command) {
       }
     })
 }
+// CIL[END chunk_id="items_registeritemcommands_1784069813"]

package/.framework/cli/commands/migrate.ts

@@ -1,24 +1,28 @@
-/// <reference types="node" />
-/**
- * @module cli/commands/migrate
- * @audience installer
- * @layer cli
- * @stability stable
- *
- * `spine-framework migrate` — Apply SQL migrations to a Supabase project
- * via a direct Postgres connection.
- *
- * Requires SUPABASE_DB_PASSWORD in .env (or --db-password flag).
- * Get it from: https://supabase.com/dashboard/project/_/settings/database
- *
- * **Usage:**
- * ```bash
- * npx spine-framework migrate
- * npx spine-framework migrate --dry-run
- * npx spine-framework migrate --db-password <password>
- * ```
- */
 
+
+
+
+
+
+
+
+
+
+// CIL[BEGIN chunk_id="migrate_moduleheader_1784069813" type="module_header" identity="module_header" parent="none"]
+// CIL[DOC-MACRO purpose="Module imports and types for migration CLI"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide filesystem utilities and migration interfaces"]
+// CIL[DOC-CONTEXT module="cli.commands.migrate" layer="cli" related_files="[\".framework/migrations/015_simplify_apps_table.sql\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/functions/_shared/principal.ts\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="imports and types" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Imports Node.js modules and defines MigrateOptions interface" 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: .framework/migrations/015_simplify_apps_table.sql, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, 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, readdirSync, readFileSync } from 'fs'
 import { resolve, dirname, join } from 'path'
@@ -34,12 +38,21 @@ interface MigrateOptions {
   dryRun: boolean
   frameworkOnly: boolean
 }
-
-/**
- * Run all pending migrations programmatically.
- * Returns { applied, skipped, failed } — throws on connection failure.
- * Silent on missing SUPABASE_DB_PASSWORD (returns null to indicate skipped).
- */
+// CIL[END chunk_id="migrate_moduleheader_1784069813"]
+// CIL[BEGIN chunk_id="migrate_runmigrations_1784069813" type="function" identity="runMigrations" parent="none"]
+// CIL[DOC-MACRO purpose="Execute database migrations via direct PostgreSQL connection"]
+// CIL[DOC-RESPONSIBILITY responsibility="Apply pending SQL migrations to database"]
+// CIL[DOC-CONTEXT module="cli.commands.migrate" layer="cli" related_files="[\".framework/migrations/015_simplify_apps_table.sql\",\".framework/src/pages/admin/RolesPage.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="migration results" errors="database errors" side_effects="database writes"]
+// CIL[DOC-MICRO logic_summary="Connects to PostgreSQL, creates migration tracking table, applies SQL 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/migrations/015_simplify_apps_table.sql, .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"]
 export async function runMigrations(opts: { frameworkOnly?: boolean } = {}): Promise<{ applied: number; skipped: number; failed: number } | null> {
   const supabaseUrl = process.env.SUPABASE_URL
   if (!supabaseUrl || supabaseUrl.includes('placeholder') || supabaseUrl.includes('your-project')) {
@@ -107,11 +120,25 @@ export async function runMigrations(opts: { frameworkOnly?: boolean } = {}): Pro
   await client.end()
   return { applied, skipped, failed }
 }
-
+// CIL[END chunk_id="migrate_runmigrations_1784069813"]
+// CIL[BEGIN chunk_id="migrate_migratecommand_1784069813" type="function" identity="migrateCommand" parent="none"]
+// CIL[DOC-MACRO purpose="Handle migration command execution with validation"]
+// CIL[DOC-RESPONSIBILITY responsibility="Validate environment and orchestrate migration process"]
+// CIL[DOC-CONTEXT module="cli.commands.migrate" layer="cli" related_files="[\".framework/functions/_shared/schema-utils.ts\",\".framework/migrations/015_simplify_apps_table.sql\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="migration execution" errors="validation errors" side_effects="process exit"]
+// CIL[DOC-MICRO logic_summary="Validates env vars, loads migrations, handles dry-run and execution" 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/migrations/015_simplify_apps_table.sql, .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"]
 async function migrateCommand(options: MigrateOptions): Promise<void> {
   console.log('\nRunning Spine Framework migrations...\n')
 
-  // Load .env from project root
+  
   loadEnv()
 
   const envPath = join(PROJECT_ROOT, '.env')
@@ -144,7 +171,7 @@ async function migrateCommand(options: MigrateOptions): Promise<void> {
     process.exit(1)
   }
 
-  // Override env with CLI flag if provided
+  
   if (options.dbPassword) process.env.SUPABASE_DB_PASSWORD = options.dbPassword
 
   const migrationFiles = collectMigrations(options.frameworkOnly)
@@ -183,7 +210,21 @@ async function migrateCommand(options: MigrateOptions): Promise<void> {
   console.log('  npx spine-framework install-app spine-framework-portal@latest')
   console.log('  npm install && npm run assemble && netlify dev\n')
 }
-
+// CIL[END chunk_id="migrate_migratecommand_1784069813"]
+// CIL[BEGIN chunk_id="migrate_registermigratecommands_1784069813" type="function" identity="registerMigrateCommands" parent="none"]
+// CIL[DOC-MACRO purpose="Register migrate command with CLI program"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide CLI interface for database migrations"]
+// CIL[DOC-CONTEXT module="cli.commands.migrate" layer="cli" related_files="[\".framework/functions/_shared/schema-utils.ts\",\".framework/src/components/ui/dialog.tsx\",\".framework/functions/_shared/principal.ts\",\".framework/src/components/ui/table-primitives.tsx\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="CLI command registration" errors="command errors" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Registers migrate command with db-password, dry-run, and framework-only 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/functions/_shared/schema-utils.ts, .framework/src/components/ui/dialog.tsx, .framework/functions/_shared/principal.ts, .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 registerMigrateCommands(program: Command) {
   program
     .command('migrate')
@@ -201,9 +242,21 @@ export function registerMigrateCommands(program: Command) {
       }
     })
 }
-
-// ─── HELPERS ────────────────────────────────────────────────────────────────
-
+// CIL[END chunk_id="migrate_registermigratecommands_1784069813"]
+// CIL[BEGIN chunk_id="migrate_loadenv_1784069813" type="function" identity="loadEnv" parent="none"]
+// CIL[DOC-MACRO purpose="Load environment variables from .env file"]
+// CIL[DOC-RESPONSIBILITY responsibility="Parse and set environment variables"]
+// CIL[DOC-CONTEXT module="cli.commands.migrate" layer="cli" related_files="[\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="process.env updates" errors="file read errors" side_effects="process.env mutation"]
+// CIL[DOC-MICRO logic_summary="Reads .env file, parses key=value pairs, sets process.env" 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: \."]
+// 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 loadEnv() {
   const envPath = join(PROJECT_ROOT, '.env')
   if (!existsSync(envPath)) return
@@ -218,11 +271,25 @@ function loadEnv() {
     if (key && !(key in process.env)) process.env[key] = val
   }
 }
-
+// CIL[END chunk_id="migrate_loadenv_1784069813"]
+// CIL[BEGIN chunk_id="migrate_collectmigrations_1784069813" type="function" identity="collectMigrations" parent="none"]
+// CIL[DOC-MACRO purpose="Collect migration files from framework and custom directories"]
+// CIL[DOC-RESPONSIBILITY responsibility="Find and sort SQL migration files"]
+// CIL[DOC-CONTEXT module="cli.commands.migrate" layer="cli" related_files="[]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="migration file list" errors="filesystem errors" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Scans .framework/migrations and custom/migrations for .sql 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: 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"]
 function collectMigrations(frameworkOnly: boolean): { name: string; path: string }[] {
   const files: { name: string; path: string }[] = []
 
-  // Framework migrations (prefer local .framework/ copy, fall back to package)
+  
   const fwMigrationsDir = existsSync(join(PROJECT_ROOT, '.framework/migrations'))
     ? join(PROJECT_ROOT, '.framework/migrations')
     : join(PACKAGE_ROOT, '.framework/migrations')
@@ -234,7 +301,7 @@ function collectMigrations(frameworkOnly: boolean): { name: string; path: string
       .forEach(f => files.push({ name: f, path: join(fwMigrationsDir, f) }))
   }
 
-  // Custom migrations
+  
   if (!frameworkOnly) {
     const customMigrationsDir = join(PROJECT_ROOT, 'custom/migrations')
     if (existsSync(customMigrationsDir)) {
@@ -247,12 +314,26 @@ function collectMigrations(frameworkOnly: boolean): { name: string; path: string
 
   return files
 }
-
+// CIL[END chunk_id="migrate_collectmigrations_1784069813"]
+// CIL[BEGIN chunk_id="migrate_splitsqlstatements_1784069813" type="function" identity="splitSqlStatements" parent="none"]
+// CIL[DOC-MACRO purpose="Split SQL string into individual statements"]
+// CIL[DOC-RESPONSIBILITY responsibility="Parse SQL migration files into executable statements"]
+// CIL[DOC-CONTEXT module="cli.commands.migrate" layer="cli" related_files="[]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="statement array" errors="parsing errors" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Handles dollar-quoted blocks, removes comments, splits on semicolons" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="complex_sql_parsing"]
+// 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"]
 function splitSqlStatements(sql: string): string[] {
   const dollarBlocks: string[] = []
   let blockIndex = 0
 
-  // Protect dollar-quoted blocks (they can contain semicolons)
+  
   const protectedSql = sql.replace(/\$[A-Za-z_]*\$[\s\S]*?\$[A-Za-z_]*\$/g, (match) => {
     const placeholder = `__DOLLAR_BLOCK_${blockIndex}__`
     dollarBlocks[blockIndex] = match
@@ -260,10 +341,10 @@ function splitSqlStatements(sql: string): string[] {
     return placeholder
   })
 
-  // Strip single-line comments
+  
   const noComments = protectedSql.replace(/--[^\n]*/g, '')
 
-  // Split by semicolons and restore dollar blocks
+  
   return noComments
     .split(';')
     .map(s => {
@@ -276,3 +357,4 @@ function splitSqlStatements(sql: string): string[] {
     .filter(s => s.length > 0)
     .map(s => s + ';')
 }
+// CIL[END chunk_id="migrate_splitsqlstatements_1784069813"]

package/.framework/cli/commands/migrations.ts

@@ -1,36 +1,21 @@
-/// <reference types="node" />
-/**
- * @module cli/commands/migrations
- * @audience installer
- * @layer cli
- * @stability stable
- *
- * `spine migrations` command group. Read-only inspection of the migration
- * state. Does NOT apply or roll back migrations — use the Supabase CLI for
- * that. These commands are intended for verifying the state of a deployed
- * instance during setup or debugging.
- *
- * **Commands:**
- * | Subcommand            | Description                                         |
- * |-----------------------|-----------------------------------------------------|
- * | `migrations list`     | Show all applied migrations from `schema_migrations`|
- * | `migrations status`   | Diff local `.sql` files against applied migrations  |
- *
- * **Authorization:** Uses `adminDb` (service-role) with an explicit
- * `.schema('public')` override to reach `schema_migrations`. Requires
- * `SUPABASE_SERVICE_ROLE_KEY` with public schema access.
- *
- * **Usage:**
- * ```bash
- * spine migrations list
- * spine migrations status
- * spine migrations status --json
- * ```
- *
- * @seeAlso v2-core/migrations/ (local .sql migration files)
- * @seeAlso cli/context.ts (buildCliContext)
- */
 
+
+
+// CIL[BEGIN chunk_id="migrations_moduleheader_1784069813" type="module_header" identity="module_header" parent="none"]
+// CIL[DOC-MACRO purpose="Module imports for migration inspection CLI"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide CLI context and database access"]
+// CIL[DOC-CONTEXT module="cli.commands.migrations" layer="cli" related_files="[\".framework/migrations/015_simplify_apps_table.sql\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/src/pages/admin/TypeDetailPage.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 utilities, and admin database" 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: .framework/migrations/015_simplify_apps_table.sql, custom/apps/cortex/pages/operations/OperationsDashboard.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 { readdirSync, existsSync } from 'fs'
 import { resolve, dirname } from 'path'
@@ -40,14 +25,21 @@ import { adminDb } from '../../functions/_shared/index.ts'
 
 const __filename = fileURLToPath(import.meta.url)
 const __dirname = dirname(__filename)
-
-/**
- * Registers the `migrations` subcommand group on the root Commander program.
- *
- * @param program - The root `spine` Commander instance
- * @sideEffects Adds `migrations list` and `migrations status` subcommands to `program`
- * @calledBy cli/index.ts
- */
+// CIL[END chunk_id="migrations_moduleheader_1784069813"]
+// CIL[BEGIN chunk_id="migrations_registermigrationcommands_1784069813" type="function" identity="registerMigrationCommands" parent="none"]
+// CIL[DOC-MACRO purpose="Register migration inspection commands"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide CLI commands for migration status and listing"]
+// CIL[DOC-CONTEXT module="cli.commands.migrations" layer="cli" related_files="[\".framework/migrations/015_simplify_apps_table.sql\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="CLI commands" errors="database errors" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Registers list and status commands for migration inspection" 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/migrations/015_simplify_apps_table.sql, \."]
+// 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 registerMigrationCommands(program: Command) {
   const migrations = program
     .command('migrations')
@@ -139,3 +131,4 @@ export function registerMigrationCommands(program: Command) {
       }
     })
 }
+// CIL[END chunk_id="migrations_registermigrationcommands_1784069813"]

package/.framework/cli/commands/pipelines.ts

@@ -1,46 +1,37 @@
-/// <reference types="node" />
-/**
- * @module cli/commands/pipelines
- * @audience installer
- * @layer cli
- * @stability stable
- *
- * `spine pipelines` command group. Lists, inspects, and triggers pipeline
- * execution directly from the terminal or an agentic IDE. `pipelines run`
- * calls `runPipeline` — the same function used by API handlers and timers —
- * so CLI executions are fully recorded in `pipeline_executions`.
- *
- * **Commands:**
- * | Subcommand                            | Description                              |
- * |---------------------------------------|------------------------------------------|
- * | `pipelines list [--account] [--all]`  | List active (or all) pipelines           |
- * | `pipelines get <id>`                  | Show pipeline details                    |
- * | `pipelines run <id> [--data <json>]`  | Execute a pipeline and show stage output |
- * | `pipelines executions <id>`           | List recent executions for a pipeline    |
- *
- * **Usage:**
- * ```bash
- * spine pipelines list --account <id>
- * spine pipelines run <uuid> --data '{"key":"value"}' --json
- * spine pipelines executions <uuid> --limit 20
- * ```
- *
- * @seeAlso cli/context.ts (buildCliContext)
- * @seeAlso functions/_shared/pipeline-runner.ts (runPipeline)
- * @seeAlso functions/pipeline-executions.ts (API query endpoint)
- */
 
+// CIL[BEGIN chunk_id="pipelines_moduleheader_1784068794" type="module_header" identity="imports" parent="none"]
+// CIL[DOC-MACRO purpose="Import CLI dependencies and pipeline utilities"]
+// CIL[DOC-RESPONSIBILITY responsibility="Load required modules for pipeline commands"]
+// CIL[DOC-CONTEXT module="cli" layer="commands" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/src/components/ui/dialog.tsx\",\".framework/src/pages/admin/RolesPage.tsx\",\".framework/functions/_shared/principal.ts\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="loaded_modules" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Imports Commander, context utilities, and pipeline functions" 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: commands. Direct callers: 0. Direct calls: 0. Related files: custom/apps/portal/pages/ContentPage.tsx, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .framework/src/components/ui/dialog.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, printResult, handleError } from '../context.ts'
 import { runPipeline, adminDb } from '../../functions/_shared/index.ts'
-
-/**
- * Registers the `pipelines` subcommand group on the root Commander program.
- *
- * @param program - The root `spine` Commander instance
- * @sideEffects Adds `pipelines list/get/run/executions` subcommands to `program`
- * @calledBy cli/index.ts
- */
+// CIL[END chunk_id="pipelines_moduleheader_1784068794"]
+// CIL[BEGIN chunk_id="pipelines_registerpipelinecommands_1784068794" type="function" identity="registerPipelineCommands" parent="none"]
+// CIL[DOC-MACRO purpose="Register pipeline management commands"]
+// CIL[DOC-RESPONSIBILITY responsibility="Configure pipeline list, get, run, and executions commands"]
+// CIL[DOC-CONTEXT module="cli" layer="commands" related_files="[\".framework/src/pages/admin/TypeDetailPage.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="pipeline_commands" errors="command_errors" side_effects="database_operations"]
+// CIL[DOC-MICRO logic_summary="Registers subcommands for pipeline CRUD and execution operations" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="complex_dependencies"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-VECTOR type="context" content="Layer: commands. Direct callers: 0. Direct calls: 0. Related files: .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 registerPipelineCommands(program: Command) {
   const pipelines = program
     .command('pipelines')
@@ -164,3 +155,4 @@ export function registerPipelineCommands(program: Command) {
       }
     })
 }
+// CIL[END chunk_id="pipelines_registerpipelinecommands_1784068794"]