spine-framework 0.3.144 → 0.4.0

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

@@ -1,45 +1,71 @@
+// CIL[BEGIN stable_id="~/.framework/cli/commands/migrations.ts:module_header:module_header" type="module_header" identity="module_header" parent="~/.framework/cli/commands/migrations.ts"]
+// CIL[DOC-MACRO purpose="CLI migration inspection commands for listing applied migrations and comparing local SQL files"]
+// CIL[DOC-RESPONSIBILITY responsibility="Defines the migration CLI module and wires list/status subcommands"]
+// CIL[DOC-CONTEXT module="cli/commands/migrations" layer="cli" related_files=".framework/cli/context.ts,.framework/functions/_shared/index.ts"]
+// CIL[DOC-CONTRACT inputs="Commander program" outputs="registered subcommands" errors="None at module level" side_effects="Imports and re-exports registerMigrationCommands"]
+// CIL[DOC-MICRO logic_summary="Imports commander helpers, database utilities, and the registerMigrationCommands function" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-AUDIENCE audience="framework developers"]
+
 
 
 
-// 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'
 import { fileURLToPath } from 'url'
 import { buildCliContext, printResult, handleError } from '../context.ts'
 import { adminDb } from '../../functions/_shared/index.ts'
-
+// CIL[DOC-VECTOR type="context" content="purpose='CLI migration inspection commands for listing applied migrations and comparing local SQL files'; No verified external callers; imports: .framework/cli/context.ts,.framework/functions/_shared/index.ts"]
+// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
+// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
+// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[END stable_id="~/.framework/cli/commands/migrations.ts:module_header:module_header"]
+
+// CIL[BEGIN stable_id="~/.framework/cli/commands/migrations.ts:__filename:constant" type="constant" identity="__filename" parent="~/.framework/cli/commands/migrations.ts"]
+// CIL[DOC-MACRO purpose="Resolve the current module filename from import.meta.url"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide a CommonJS-style __filename value in ESM"]
+// CIL[DOC-CONTEXT module="cli/commands/migrations" layer="utility" related_files=".framework/cli/commands/migrations.ts,.framework/cli/context.ts,.framework/functions/_shared/index.ts"]
+// CIL[DOC-CONTRACT inputs="import.meta.url" outputs="absolute __filename" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="call fileURLToPath on import.meta.url" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 const __filename = fileURLToPath(import.meta.url)
-const __dirname = dirname(__filename)
-// 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-VECTOR type="context" content="purpose='Resolve the current module filename from import.meta.url'; No verified external callers; imports: .framework/cli/context.ts,.framework/functions/_shared/index.ts"]
+// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
+// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
+// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[END stable_id="~/.framework/cli/commands/migrations.ts:__filename:constant"]
+// CIL[BEGIN stable_id="~/.framework/cli/commands/migrations.ts:__dirname:constant" type="constant" identity="__dirname" parent="~/.framework/cli/commands/migrations.ts"]
+// CIL[DOC-MACRO purpose="Resolve the current module directory name"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide a CommonJS-style __dirname value in ESM"]
+// CIL[DOC-CONTEXT module="cli/commands/migrations" layer="utility" related_files=".framework/cli/commands/migrations.ts,.framework/cli/context.ts,.framework/functions/_shared/index.ts"]
+// CIL[DOC-CONTRACT inputs="__filename" outputs="absolute __dirname" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="call dirname on the resolved __filename" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" 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."]
+const __dirname = dirname(__filename)
+// CIL[DOC-VECTOR type="context" content="purpose='Resolve the current module directory name'; No verified external callers; imports: .framework/cli/context.ts,.framework/functions/_shared/index.ts"]
+// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
+// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
+// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
 // CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
 // CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[END stable_id="~/.framework/cli/commands/migrations.ts:__dirname:constant"]
+
+// CIL[BEGIN stable_id="~/.framework/cli/commands/migrations.ts:registerMigrationCommands:function" type="function" identity="registerMigrationCommands" parent="~/.framework/cli/commands/migrations.ts"]
+// CIL[DOC-MACRO purpose="Register migration list and status CLI subcommands"]
+// CIL[DOC-RESPONSIBILITY responsibility="Expose commands that query supabase_migrations and compare local SQL files"]
+// CIL[DOC-CONTEXT module="cli/commands/migrations" layer="cli" related_files=".framework/cli/commands/migrations.ts,.framework/cli/context.ts,.framework/functions/_shared/index.ts"]
+// CIL[DOC-CONTRACT inputs="program: Command" outputs="void" errors="Throws on missing migrations directory or failed DB queries" side_effects="Adds commands and options to the Commander program"]
+// CIL[DOC-MICRO logic_summary="Define migrations command, add list and status subcommands with options, perform DB calls and console output" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export function registerMigrationCommands(program: Command) {
   const migrations = program
     .command('migrations')
@@ -131,4 +157,10 @@ export function registerMigrationCommands(program: Command) {
       }
     })
 }
-// CIL[END chunk_id="migrations_registermigrationcommands_1784069813"]
+// CIL[DOC-VECTOR type="context" content="purpose='Register migration list and status CLI subcommands'; No verified external callers; imports: .framework/cli/context.ts,.framework/functions/_shared/index.ts"]
+// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
+// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
+// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[END stable_id="~/.framework/cli/commands/migrations.ts:registerMigrationCommands:function"]

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

@@ -1,37 +1,33 @@
+// CIL[BEGIN stable_id="~/.framework/cli/commands/pipelines.ts:module_header:module_header" type="module_header" identity="module_header" parent="~/.framework/cli/commands/pipelines.ts"]
+// CIL[DOC-AUDIENCE audience="cli developers"]
+// CIL[DOC-MACRO purpose="CLI command module for pipeline management"]
+// CIL[DOC-RESPONSIBILITY responsibility="Registers and exports pipeline subcommands for the Spine CLI"]
+// CIL[DOC-CONTEXT module=".framework/cli/commands/pipelines.ts" layer="cli" related_files=".framework/cli/context.ts,.framework/functions/_shared/index.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Imports dependencies and provides module-level hooks for pipeline CLI commands." notable_decisions="none"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stable]
+
 
-// 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'
-// 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="context" content="purpose='CLI command module for pipeline management'; No verified external callers; imports: .framework/cli/context.ts,.framework/functions/_shared/index.ts"]
+// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
+// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
+// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
 // CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
 // CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[END stable_id="~/.framework/cli/commands/pipelines.ts:module_header:module_header"]
+
+// CIL[BEGIN stable_id="~/.framework/cli/commands/pipelines.ts:registerPipelineCommands:function" type="function" identity="registerPipelineCommands" parent="~/.framework/cli/commands/pipelines.ts"]
+// CIL[DOC-MACRO purpose="Register pipeline subcommands on a commander program"]
+// CIL[DOC-RESPONSIBILITY responsibility="Attach list, get, run, and executions subcommands to the 'pipelines' command"]
+// CIL[DOC-CONTEXT module=".framework/cli/commands/pipelines.ts" layer="cli" related_files=".framework/cli/commands/pipelines.ts,.framework/cli/context.ts,.framework/functions/_shared/index.ts"]
+// CIL[DOC-CONTRACT inputs="program: Command (commander program)" outputs="none; registers subcommands on program" errors="throws via handleError on execution" side_effects="console output; queries adminDb; runs pipeline"]
+// CIL[DOC-MICRO logic_summary="Creates 'pipelines' command and subcommands for listing, getting, running, and listing executions." notable_decisions="list queries active pipelines with optional account filter; get fetches by id; run parses JSON trigger data and invokes runPipeline; executions loads recent executions."]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stable]
 export function registerPipelineCommands(program: Command) {
   const pipelines = program
     .command('pipelines')
@@ -155,4 +151,10 @@ export function registerPipelineCommands(program: Command) {
       }
     })
 }
-// CIL[END chunk_id="pipelines_registerpipelinecommands_1784068794"]
+// CIL[DOC-VECTOR type="context" content="purpose='Register pipeline subcommands on a commander program'; No verified external callers; imports: .framework/cli/context.ts,.framework/functions/_shared/index.ts"]
+// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
+// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
+// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[END stable_id="~/.framework/cli/commands/pipelines.ts:registerPipelineCommands:function"]

package/.framework/cli/commands/status.ts

@@ -1,45 +1,98 @@
-
-
-// CIL[BEGIN chunk_id="status_moduleheader_1784068794" type="module_header" identity="imports" parent="none"]
-// CIL[DOC-MACRO purpose="Import dependencies and set up paths"]
-// CIL[DOC-RESPONSIBILITY responsibility="Load required modules and configure directory paths"]
-// CIL[DOC-CONTEXT module="cli" layer="commands" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/src/pages/admin/RolesPage.tsx\",\".framework/src/components/ui/dialog.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="loaded_modules" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Imports Commander, file system, path utilities, and Supabase client" 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/pages/admin/RolesPage.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"]
+// CIL[BEGIN stable_id="~/.framework/cli/commands/status.ts:module_header:module_header" type="module_header" identity="module_header" parent="~/.framework/cli/commands/status.ts"]
+// CIL[DOC-AUDIENCE audience="CLI engineers and framework maintainers"]
+// CIL[DOC-MACRO purpose="Provide module-level imports for the status CLI command"]
+// CIL[DOC-RESPONSIBILITY responsibility="Load required third-party and Node modules for filesystem, path and Supabase access"]
+// CIL[DOC-CONTEXT module="status" layer="cli" related_files=".framework/cli/commands/status.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Imports type Command, filesystem utilities, path utilities, url helpers and the Supabase client"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stable]
 import type { Command } from 'commander'
 import { existsSync, readFileSync, readdirSync } from 'fs'
 import { resolve, dirname, join, basename } from 'path'
 import { fileURLToPath } from 'url'
 import { createClient } from '@supabase/supabase-js'
+// CIL[DOC-VECTOR type="context" content="purpose='Provide module-level imports for the status CLI command'; No verified external callers; imports: none"]
+// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
+// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
+// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[END stable_id="~/.framework/cli/commands/status.ts:module_header:module_header"]
 
+// CIL[BEGIN stable_id="~/.framework/cli/commands/status.ts:__filename:constant" type="constant" identity="__filename" parent="~/.framework/cli/commands/status.ts"]
+// CIL[DOC-MACRO purpose="Expose the current module filename for path resolution"]
+// CIL[DOC-RESPONSIBILITY responsibility="Derive __filename from import.meta.url"]
+// CIL[DOC-CONTEXT module="status" layer="cli" related_files=".framework/cli/commands/status.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="string" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Use fileURLToPath to convert import.meta.url to an absolute file path"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stable]
 const __filename = fileURLToPath(import.meta.url)
+// CIL[DOC-VECTOR type="context" content="purpose='Expose the current module filename for path resolution'; No verified external callers; imports: none"]
+// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
+// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
+// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[END stable_id="~/.framework/cli/commands/status.ts:__filename:constant"]
+// CIL[BEGIN stable_id="~/.framework/cli/commands/status.ts:__dirname:constant" type="constant" identity="__dirname" parent="~/.framework/cli/commands/status.ts"]
+// CIL[DOC-MACRO purpose="Expose the current module directory for path resolution"]
+// CIL[DOC-RESPONSIBILITY responsibility="Derive __dirname from __filename"]
+// CIL[DOC-CONTEXT module="status" layer="cli" related_files=".framework/cli/commands/status.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="string" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Use dirname to get the directory portion of __filename"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stable]
 const __dirname = dirname(__filename)
+// CIL[DOC-VECTOR type="context" content="purpose='Expose the current module directory for path resolution'; No verified external callers; imports: none"]
+// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
+// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
+// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[END stable_id="~/.framework/cli/commands/status.ts:__dirname:constant"]
+// CIL[BEGIN stable_id="~/.framework/cli/commands/status.ts:PACKAGE_ROOT:constant" type="constant" identity="PACKAGE_ROOT" parent="~/.framework/cli/commands/status.ts"]
+// CIL[DOC-MACRO purpose="Locate the spine-framework package root directory"]
+// CIL[DOC-RESPONSIBILITY responsibility="Resolve the package root relative to the current file"]
+// CIL[DOC-CONTEXT module="status" layer="cli" related_files=".framework/cli/commands/status.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="string" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Resolve three directories up from __dirname to reach the framework package root"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stable]
 const PACKAGE_ROOT = resolve(__dirname, '../../../')
+// CIL[DOC-VECTOR type="context" content="purpose='Locate the spine-framework package root directory'; No verified external callers; imports: none"]
+// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
+// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
+// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[END stable_id="~/.framework/cli/commands/status.ts:PACKAGE_ROOT:constant"]
+// CIL[BEGIN stable_id="~/.framework/cli/commands/status.ts:PROJECT_ROOT:constant" type="constant" identity="PROJECT_ROOT" parent="~/.framework/cli/commands/status.ts"]
+// CIL[DOC-MACRO purpose="Locate the current working directory of the CLI invocation"]
+// CIL[DOC-RESPONSIBILITY responsibility="Capture the process current working directory"]
+// CIL[DOC-CONTEXT module="status" layer="cli" related_files=".framework/cli/commands/status.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="string" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Assign process.cwd() to PROJECT_ROOT"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stable]
 const PROJECT_ROOT = process.cwd()
-// CIL[END chunk_id="status_moduleheader_1784068794"]
-// CIL[BEGIN chunk_id="status_registerstatuscommands_1784068794" type="function" identity="registerStatusCommands" parent="none"]
-// CIL[DOC-MACRO purpose="Register status command with CLI program"]
-// CIL[DOC-RESPONSIBILITY responsibility="Display framework and project status information"]
-// CIL[DOC-CONTEXT module="cli" layer="commands" related_files="[\".framework/src/pages/admin/RolesPage.tsx\",\".framework/functions/_shared/schema-utils.ts\",\".framework/src/pages/admin/IntegrationsPage.tsx\",\"custom/apps/cortex/functions/custom_cil-embeddings.ts\",\".framework/src/components/ui/dialog.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="status_display" errors="file_read_errors" side_effects="console_output"]
-// CIL[DOC-MICRO logic_summary="Shows framework version, installed apps, and migration status" 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/RolesPage.tsx, .framework/functions/_shared/schema-utils.ts, .framework/src/pages/admin/IntegrationsPage.tsx, custom/apps/cortex/functions/custom_cil-embeddings.ts, .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="context" content="purpose='Locate the current working directory of the CLI invocation'; No verified external callers; imports: none"]
+// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
+// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
+// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
 // CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
 // CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[END stable_id="~/.framework/cli/commands/status.ts:PROJECT_ROOT:constant"]
+
+// CIL[BEGIN stable_id="~/.framework/cli/commands/status.ts:registerStatusCommands:function" type="function" identity="registerStatusCommands" parent="~/.framework/cli/commands/status.ts"]
+// CIL[DOC-MACRO purpose="Register the status CLI subcommand and render framework state"]
+// CIL[DOC-RESPONSIBILITY responsibility="Add a status command to a Commander program that reports framework version, installed apps and migration state"]
+// CIL[DOC-CONTEXT module="status" layer="cli" related_files=".framework/cli/commands/status.ts"]
+// CIL[DOC-CONTRACT inputs="program: Command" outputs="none" errors="file read errors, Supabase query errors" side_effects="reads files, queries spine_migrations, logs to stdout"]
+// CIL[DOC-MICRO logic_summary="Define the status command, parse --json, load env, read package.json, scan custom/apps manifests, list framework migrations, query applied migrations via Supabase, then print human-readable or JSON status"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stable]
 export function registerStatusCommands(program: Command) {
   program
     .command('status')
@@ -122,7 +175,7 @@ export function registerStatusCommands(program: Command) {
       console.log('── Installed Apps ─────────────────────────────────────')
       if (installedApps.length === 0) {
         console.log('   No apps installed.')
-        console.log('   Run: npx spine-framework install-app spine-framework-portal@latest')
+        console.log('   Run: npx spine-framework install-app <app-package>')
       } else {
         for (const app of installedApps) {
           const ver = app.version ? `@${app.version}` : ''
@@ -145,21 +198,22 @@ export function registerStatusCommands(program: Command) {
       console.log()
     })
 }
-// CIL[END chunk_id="status_registerstatuscommands_1784068794"]
-// CIL[BEGIN chunk_id="status_loadenv_1784068794" 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" layer="commands" related_files="[\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="process_env" errors="file_read_errors" side_effects="process_env_modification"]
-// CIL[DOC-MICRO logic_summary="Reads .env file and sets non-existent environment variables" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: commands. 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="context" content="purpose='Register the status CLI subcommand and render framework state'; No verified external callers; imports: none"]
+// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
+// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
+// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
 // CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
 // CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[END stable_id="~/.framework/cli/commands/status.ts:registerStatusCommands:function"]
+
+// CIL[BEGIN stable_id="~/.framework/cli/commands/status.ts:loadEnv:function" type="function" identity="loadEnv" parent="~/.framework/cli/commands/status.ts"]
+// CIL[DOC-MACRO purpose="Load environment variables from .env"]
+// CIL[DOC-RESPONSIBILITY responsibility="Read the project .env file and set missing variables in process.env"]
+// CIL[DOC-CONTEXT module="status" layer="cli" related_files=".framework/cli/commands/status.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="mutates process.env"]
+// CIL[DOC-MICRO logic_summary="Parse .env line by line, skipping comments and blank lines, and assign key=value pairs to process.env if not already set"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stable]
 function loadEnv() {
   const envPath = join(PROJECT_ROOT, '.env')
   if (!existsSync(envPath)) return
@@ -174,4 +228,10 @@ function loadEnv() {
     if (key && !(key in process.env)) process.env[key] = val
   }
 }
-// CIL[END chunk_id="status_loadenv_1784068794"]
+// CIL[DOC-VECTOR type="context" content="purpose='Load environment variables from .env'; No verified external callers; imports: none"]
+// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
+// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
+// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[END stable_id="~/.framework/cli/commands/status.ts:loadEnv:function"]

package/.framework/cli/commands/system.ts

@@ -1,37 +1,34 @@
+// CIL[BEGIN stable_id="~/.framework/cli/commands/system.ts:module_header:module_header" type="module_header" identity="module_header" parent="~/.framework/cli/commands/system.ts"]
+// CIL[DOC-MACRO purpose="Provides CLI commands for system discovery and health."]
+// CIL[DOC-RESPONSIBILITY responsibility="Expose system discovery and health commands via the CLI."]
+// CIL[DOC-CONTEXT module="system" layer="cli" related_files=".framework/cli/context.ts"]
+// CIL[DOC-CONTRACT inputs="[]" outputs="[]" errors="[]" side_effects="[]"]
+// CIL[DOC-MICRO logic_summary="Defines the system command module and its intent, related utilities, and default exports." notable_decisions=""]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-AUDIENCE audience="internal"]
+
 
 
-// CIL[BEGIN chunk_id="system_moduleheader_1784068794" type="module_header" identity="imports" parent="none"]
-// CIL[DOC-MACRO purpose="Import CLI dependencies and context utilities"]
-// CIL[DOC-RESPONSIBILITY responsibility="Load required modules for system 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/pages/admin/RolesPage.tsx\",\".framework/src/components/ui/dialog.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="loaded_modules" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Imports Commander type and 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: commands. 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/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"]
 import type { Command } from 'commander'
 import { buildCliContext, printResult, handleError } from '../context.ts'
-// CIL[END chunk_id="system_moduleheader_1784068794"]
-// CIL[BEGIN chunk_id="system_fetchsystemendpoint_1784068794" type="function" identity="fetchSystemEndpoint" parent="none"]
-// CIL[DOC-MACRO purpose="Fetch system endpoint from local dev server"]
-// CIL[DOC-RESPONSIBILITY responsibility="Make HTTP requests to system functions"]
-// CIL[DOC-CONTEXT module="cli" layer="commands" related_files="[\".framework/src/pages/admin/RolesPage.tsx\",\"custom/apps/portal/pages/ContentPage.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="json_response" errors="http_errors" side_effects="network_requests"]
-// CIL[DOC-MICRO logic_summary="Makes GET requests to local dev server with proper error handling" 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: commands. Direct callers: 0. Direct calls: 0. Related files: .framework/src/pages/admin/RolesPage.tsx, 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="context" content="purpose='Provides CLI commands for system discovery and health.'; No verified external callers; imports: .framework/cli/context.ts"]
+// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
+// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
+// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
 // CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
 // CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[END stable_id="~/.framework/cli/commands/system.ts:module_header:module_header"]
+
+// CIL[BEGIN stable_id="~/.framework/cli/commands/system.ts:fetchSystemEndpoint:function" type="function" identity="fetchSystemEndpoint" parent="~/.framework/cli/commands/system.ts"]
+// CIL[DOC-MACRO purpose="Calls the local system endpoint for a given action."]
+// CIL[DOC-RESPONSIBILITY responsibility="Fetch system data from the local dev server."]
+// CIL[DOC-CONTEXT module="system" layer="cli" related_files=".framework/cli/commands/system.ts,.framework/cli/context.ts"]
+// CIL[DOC-CONTRACT inputs="ctx: any, action: string" outputs="Promise<any>" errors="Error when SUPABASE_URL missing, HTTP error, or connection refused" side_effects="Performs an HTTP GET to the local dev server."]
+// CIL[DOC-MICRO logic_summary="Build a local URL with the action query param, fetch JSON, and map connection failures to a helpful error." notable_decisions=""]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+
 async function fetchSystemEndpoint(ctx: any, action: string): Promise<any> {
   const supabaseUrl = process.env.SUPABASE_URL
   if (!supabaseUrl) {
@@ -66,21 +63,23 @@ async function fetchSystemEndpoint(ctx: any, action: string): Promise<any> {
     throw err
   }
 }
-// CIL[END chunk_id="system_fetchsystemendpoint_1784068794"]
-// CIL[BEGIN chunk_id="system_registersystemcommands_1784068794" type="function" identity="registerSystemCommands" parent="none"]
-// CIL[DOC-MACRO purpose="Register system commands with CLI program"]
-// CIL[DOC-RESPONSIBILITY responsibility="Configure system discovery and health commands"]
-// CIL[DOC-CONTEXT module="cli" layer="commands" related_files="[\".framework/functions/_shared/schema-utils.ts\",\".framework/src/components/ui/dialog.tsx\",\".framework/src/pages/admin/RolesPage.tsx\",\".framework/functions/_shared/principal.ts\",\".framework/src/components/ui/table-primitives.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="system_commands" errors="command_errors" side_effects="console_output"]
-// CIL[DOC-MICRO logic_summary="Registers manifest, health, and openapi subcommands" 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/functions/_shared/schema-utils.ts, .framework/src/components/ui/dialog.tsx, .framework/src/pages/admin/RolesPage.tsx, .framework/functions/_shared/principal.ts, .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="context" content="purpose='Calls the local system endpoint for a given action.'; No verified external callers; imports: .framework/cli/context.ts"]
+// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
+// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
+// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
 // CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
 // CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[END stable_id="~/.framework/cli/commands/system.ts:fetchSystemEndpoint:function"]
+
+// CIL[BEGIN stable_id="~/.framework/cli/commands/system.ts:registerSystemCommands:function" type="function" identity="registerSystemCommands" parent="~/.framework/cli/commands/system.ts"]
+// CIL[DOC-MACRO purpose="Registers the 'system' CLI command and its subcommands (manifest, health, openapi)."]
+// CIL[DOC-RESPONSIBILITY responsibility="Expose system discovery and health CLI subcommands."]
+// CIL[DOC-CONTEXT module="system" layer="cli" related_files=".framework/cli/commands/system.ts,.framework/cli/context.ts"]
+// CIL[DOC-CONTRACT inputs="program: Command" outputs="void" errors="[]" side_effects="Writes formatted manifest/health output or JSON to stdout."]
+// CIL[DOC-MICRO logic_summary="Attach a 'system' command to the program, define manifest, health, and openapi subcommands, and render results as JSON or formatted console output." notable_decisions=""]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+
 export function registerSystemCommands(program: Command) {
   const system = program
     .command('system')
@@ -191,4 +190,10 @@ export function registerSystemCommands(program: Command) {
       }
     })
 }
-// CIL[END chunk_id="system_registersystemcommands_1784068794"]
+// CIL[DOC-VECTOR type="context" content="purpose='Registers the 'system' CLI command and its subcommands (manifest, health, openapi).'; No verified external callers; imports: .framework/cli/context.ts"]
+// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
+// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
+// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[END stable_id="~/.framework/cli/commands/system.ts:registerSystemCommands:function"]