spine-framework 0.3.125 → 0.3.127

package/.framework/cli/commands/doctor.ts

@@ -1,12 +1,38 @@
 
 
-// CIL[BEGIN chunk_id="doctor_module_header_1783405679" type="module_header" identity="module_header" parent="none"]
-// CIL[DOC-MACRO purpose="Setup imports and path constants for doctor command"]
-// CIL[DOC-RESPONSIBILITY responsibility="Configure module dependencies and file paths"]
-// CIL[DOC-CONTEXT module="cli/commands/doctor" layer="cli" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="imports, paths" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Import CLI framework, database, and file system utilities" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="first" score="0.95" flags="none"]
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+// CIL[BEGIN chunk_id="doctor_module_header_1784071456" type="module_header" identity="module_header" parent="none"]
+// CIL[DOC-MACRO purpose="Import dependencies for doctor CLI commands"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide imports and utilities for health checks"]
+// CIL[DOC-CONTEXT module="doctor-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, context, database, and file system 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 { buildCliContext, handleError } from '../context.ts'
 import { adminDb } from '../../functions/_shared/index.ts'
@@ -16,17 +42,21 @@ import { fileURLToPath } from 'url'
 
 const __filename = fileURLToPath(import.meta.url)
 const __dirname = dirname(__filename)
-// CIL[END chunk_id="doctor_module_header_1783405679"]
-
-
-
-// CIL[BEGIN chunk_id="doctor_CheckResult_1783405679" type="interface" identity="CheckResult" parent="none"]
-// CIL[DOC-MACRO purpose="Define structure for individual health check results"]
-// CIL[DOC-RESPONSIBILITY responsibility="Standardize check result data format"]
-// CIL[DOC-CONTEXT module="cli/commands/doctor" layer="cli" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="CheckResult interface" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Type definition for check status and metadata" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="first" score="0.95" flags="none"]
+// CIL[END chunk_id="doctor_module_header_1784071456"]
+// CIL[BEGIN chunk_id="doctor_checkresult_1784071456" type="interface" identity="CheckResult" parent="none"]
+// CIL[DOC-MACRO purpose="Define structure for health check results"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide standardized check result format"]
+// CIL[DOC-CONTEXT module="doctor-cli" layer="cli" related_files="[\".framework/src/pages/admin/IntegrationsPage.tsx\",\".framework/functions/_shared/principal.ts\",\".framework/functions/_shared/schema-utils.ts\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="interface definition" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Defines check result with status, message, and optional details" 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/IntegrationsPage.tsx, .framework/functions/_shared/principal.ts, .framework/functions/_shared/schema-utils.ts, .framework/src/pages/admin/TypeDetailPage.tsx, custom/apps/cortex/pages/operations/OperationsDashboard.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"]
 interface CheckResult {
   name: string
   status: 'pass' | 'fail' | 'warn'
@@ -34,15 +64,21 @@ interface CheckResult {
   details?: Record<string, any>
   fixable?: boolean
 }
-// CIL[END chunk_id="doctor_CheckResult_1783405679"]
-
-// CIL[BEGIN chunk_id="doctor_DoctorReport_1783405679" type="interface" identity="DoctorReport" parent="none"]
-// CIL[DOC-MACRO purpose="Define structure for complete doctor health report"]
-// CIL[DOC-RESPONSIBILITY responsibility="Aggregate all check results into summary report"]
-// CIL[DOC-CONTEXT module="cli/commands/doctor" layer="cli" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="DoctorReport interface" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Type definition for overall health status and summary" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="first" score="0.95" flags="none"]
+// CIL[END chunk_id="doctor_checkresult_1784071456"]
+// CIL[BEGIN chunk_id="doctor_doctorreport_1784071456" type="interface" identity="DoctorReport" parent="none"]
+// CIL[DOC-MACRO purpose="Define structure for comprehensive doctor report"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide complete health check summary format"]
+// CIL[DOC-CONTEXT module="doctor-cli" layer="cli" related_files="[\".framework/src/pages/admin/IntegrationsPage.tsx\",\".framework/functions/_shared/principal.ts\",\".framework/functions/_shared/schema-utils.ts\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="interface definition" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Defines report with overall status and check summaries" 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/IntegrationsPage.tsx, .framework/functions/_shared/principal.ts, .framework/functions/_shared/schema-utils.ts, .framework/src/pages/admin/TypeDetailPage.tsx, custom/apps/cortex/pages/operations/OperationsDashboard.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"]
 interface DoctorReport {
   overall: 'healthy' | 'degraded' | 'unhealthy'
   checks: CheckResult[]
@@ -53,17 +89,21 @@ interface DoctorReport {
     fixable: number
   }
 }
-// CIL[END chunk_id="doctor_DoctorReport_1783405679"]
-
-
-
-// CIL[BEGIN chunk_id="doctor_checkEnvironment_1783405679" type="function" identity="checkEnvironment" parent="none"]
-// CIL[DOC-MACRO purpose="Validate required environment variables are set"]
-// CIL[DOC-RESPONSIBILITY responsibility="Check SUPABASE_URL and SERVICE_ROLE_KEY presence"]
-// CIL[DOC-CONTEXT module="cli/commands/doctor" layer="cli" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="CheckResult" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Check process.env for required vars and .xenv file existence" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="first" score="0.90" flags="none"]
+// CIL[END chunk_id="doctor_doctorreport_1784071456"]
+// CIL[BEGIN chunk_id="doctor_checkenvironment_1784071456" type="function" identity="checkEnvironment" parent="none"]
+// CIL[DOC-MACRO purpose="Check required environment variables"]
+// CIL[DOC-RESPONSIBILITY responsibility="Validate Supabase environment configuration"]
+// CIL[DOC-CONTEXT module="doctor-cli" layer="cli" related_files="[\".framework/src/pages/admin/RolesPage.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="CheckResult" errors="none" side_effects="reads environment variables"]
+// CIL[DOC-MICRO logic_summary="Validates required env vars and checks for .xenv file" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-VECTOR type="context" content="Layer: cli. Direct callers: 0. Direct calls: 0. Related files: .framework/src/pages/admin/RolesPage.tsx, \."]
+// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
+// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
+// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 async function checkEnvironment(): Promise<CheckResult> {
   const required = ['SUPABASE_URL', 'SUPABASE_SERVICE_ROLE_KEY']
   const missing = required.filter(v => !process.env[v])
@@ -89,15 +129,21 @@ async function checkEnvironment(): Promise<CheckResult> {
     details: { has_xenv: hasXenv, vars_present: required.length }
   }
 }
-// CIL[END chunk_id="doctor_checkEnvironment_1783405679"]
-
-// CIL[BEGIN chunk_id="doctor_checkDatabase_1783405679" type="function" identity="checkDatabase" parent="none"]
-// CIL[DOC-MACRO purpose="Test database connectivity and measure latency"]
-// CIL[DOC-RESPONSIBILITY responsibility="Verify database connection and performance"]
-// CIL[DOC-CONTEXT module="cli/commands/doctor" layer="cli" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="CheckResult" errors="database connection errors" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Query accounts table to test connection and measure response time" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="first" score="0.90" flags="none"]
+// CIL[END chunk_id="doctor_checkenvironment_1784071456"]
+// CIL[BEGIN chunk_id="doctor_checkdatabase_1784071456" type="function" identity="checkDatabase" parent="none"]
+// CIL[DOC-MACRO purpose="Check database connectivity and performance"]
+// CIL[DOC-RESPONSIBILITY responsibility="Validate database connection and measure latency"]
+// CIL[DOC-CONTEXT module="doctor-cli" layer="cli" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/src/pages/admin/RolesPage.tsx\",\".framework/src/components/ui/dialog.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="CheckResult" errors="database connection errors" side_effects="queries database"]
+// CIL[DOC-MICRO logic_summary="Tests database connection with simple query and measures latency" 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, 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"]
 async function checkDatabase(): Promise<CheckResult> {
   const start = Date.now()
   try {
@@ -129,15 +175,21 @@ async function checkDatabase(): Promise<CheckResult> {
     }
   }
 }
-// CIL[END chunk_id="doctor_checkDatabase_1783405679"]
-
-// CIL[BEGIN chunk_id="doctor_checkMigrations_1783405679" type="function" identity="checkMigrations" parent="none"]
-// CIL[DOC-MACRO purpose="Compare local migration files with applied database migrations"]
-// CIL[DOC-RESPONSIBILITY responsibility="Detect pending migrations and migration status"]
-// CIL[DOC-CONTEXT module="cli/commands/doctor" layer="cli" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="CheckResult" errors="database query errors" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="List local SQL files and compare with schema_migrations table" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="first" score="0.85" flags="none"]
+// CIL[END chunk_id="doctor_checkdatabase_1784071456"]
+// CIL[BEGIN chunk_id="doctor_checkmigrations_1784071456" type="function" identity="checkMigrations" parent="none"]
+// CIL[DOC-MACRO purpose="Check migration status and pending migrations"]
+// CIL[DOC-RESPONSIBILITY responsibility="Compare local migration files with applied migrations"]
+// CIL[DOC-CONTEXT module="doctor-cli" layer="cli" related_files="[]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="CheckResult" errors="database query errors" side_effects="queries database, reads filesystem"]
+// CIL[DOC-MICRO logic_summary="Compares local SQL files with database migration records" 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: 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"]
 async function checkMigrations(): Promise<CheckResult> {
   const migrationsDir = resolve(__dirname, '../../migrations_dayzero')
 
@@ -199,15 +251,21 @@ async function checkMigrations(): Promise<CheckResult> {
     }
   }
 }
-// CIL[END chunk_id="doctor_checkMigrations_1783405679"]
-
-// CIL[BEGIN chunk_id="doctor_checkIntegrity_1783405679" type="function" identity="checkIntegrity" parent="none"]
-// CIL[DOC-MACRO purpose="Validate core manifest file and integrity hash presence"]
-// CIL[DOC-RESPONSIBILITY responsibility="Check manifest file exists and has integrity data"]
-// CIL[DOC-CONTEXT module="cli/commands/doctor" layer="cli" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="CheckResult" errors="file read/parse errors" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Read manifest.json and verify integrity hash exists" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="first" score="0.85" flags="none"]
+// CIL[END chunk_id="doctor_checkmigrations_1784071456"]
+// CIL[BEGIN chunk_id="doctor_checkintegrity_1784071456" type="function" identity="checkIntegrity" parent="none"]
+// CIL[DOC-MACRO purpose="Check core integrity manifest"]
+// CIL[DOC-RESPONSIBILITY responsibility="Validate spine manifest and integrity hash"]
+// CIL[DOC-CONTEXT module="doctor-cli" layer="cli" related_files="[]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="CheckResult" errors="file system errors" side_effects="reads manifest file"]
+// CIL[DOC-MICRO logic_summary="Checks for manifest file and validates integrity hash presence" 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"]
 async function checkIntegrity(): Promise<CheckResult> {
   const manifestPath = resolve(__dirname, '../../.spine-manifest.json')
 
@@ -250,15 +308,21 @@ async function checkIntegrity(): Promise<CheckResult> {
     }
   }
 }
-// CIL[END chunk_id="doctor_checkIntegrity_1783405679"]
-
-// CIL[BEGIN chunk_id="doctor_checkTestRuns_1783405679" type="function" identity="checkTestRuns" parent="none"]
-// CIL[DOC-MACRO purpose="Check latest test run status and results"]
-// CIL[DOC-RESPONSIBILITY responsibility="Verify test suite execution and report status"]
-// CIL[DOC-CONTEXT module="cli/commands/doctor" layer="cli" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="CheckResult" errors="database query errors" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Query test_runs table for most recent test execution" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="first" score="0.85" flags="none"]
+// CIL[END chunk_id="doctor_checkintegrity_1784071456"]
+// CIL[BEGIN chunk_id="doctor_checktestruns_1784071456" type="function" identity="checkTestRuns" parent="none"]
+// CIL[DOC-MACRO purpose="Check recent test run status"]
+// CIL[DOC-RESPONSIBILITY responsibility="Query latest test run and report status"]
+// CIL[DOC-CONTEXT module="doctor-cli" layer="cli" related_files="[]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="CheckResult" errors="database query errors" side_effects="queries test_runs table"]
+// CIL[DOC-MICRO logic_summary="Retrieves most recent test run and reports its status" 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: 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"]
 async function checkTestRuns(): Promise<CheckResult> {
   try {
     const { data, error } = await adminDb
@@ -303,17 +367,21 @@ async function checkTestRuns(): Promise<CheckResult> {
     }
   }
 }
-// CIL[END chunk_id="doctor_checkTestRuns_1783405679"]
-
-
-
-// CIL[BEGIN chunk_id="doctor_tryFix_1783405679" type="function" identity="tryFix" parent="none"]
-// CIL[DOC-MACRO purpose="Provide fix suggestions for failed health checks"]
-// CIL[DOC-RESPONSIBILITY responsibility="Generate remediation instructions for each check type"]
-// CIL[DOC-CONTEXT module="cli/commands/doctor" layer="cli" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="CheckResult" outputs="string fix instructions" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Switch statement mapping check names to fix commands" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="first" score="0.90" flags="none"]
+// CIL[END chunk_id="doctor_checktestruns_1784071456"]
+// CIL[BEGIN chunk_id="doctor_tryfix_1784071456" type="function" identity="tryFix" parent="none"]
+// CIL[DOC-MACRO purpose="Provide fix suggestions for failed checks"]
+// CIL[DOC-RESPONSIBILITY responsibility="Generate remediation instructions for common issues"]
+// CIL[DOC-CONTEXT module="doctor-cli" layer="cli" related_files="[]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="string" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Maps check names to specific fix commands and instructions" 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"]
 async function tryFix(check: CheckResult): Promise<string> {
   switch (check.name) {
     case 'environment':
@@ -332,17 +400,21 @@ async function tryFix(check: CheckResult): Promise<string> {
       return 'No automatic fix available'
   }
 }
-// CIL[END chunk_id="doctor_tryFix_1783405679"]
-
-
-
-// CIL[BEGIN chunk_id="doctor_registerDoctorCommands_1783405679" type="function" identity="registerDoctorCommands" parent="none"]
-// CIL[DOC-MACRO purpose="Register doctor CLI command and orchestrate health checks"]
-// CIL[DOC-RESPONSIBILITY responsibility="Execute all health checks and format results"]
-// CIL[DOC-CONTEXT module="cli/commands/doctor" layer="cli" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="Command program" outputs="registered CLI command" errors="CLI errors" side_effects="process exit"]
-// CIL[DOC-MICRO logic_summary="Run checks sequentially, aggregate results, output formatted report" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="first" score="0.85" flags="none"]
+// CIL[END chunk_id="doctor_tryfix_1784071456"]
+// CIL[BEGIN chunk_id="doctor_registerdoctorcommands_1784071456" type="function" identity="registerDoctorCommands" parent="none"]
+// CIL[DOC-MACRO purpose="Register doctor command with CLI framework"]
+// CIL[DOC-RESPONSIBILITY responsibility="Orchestrate all health checks and generate report"]
+// CIL[DOC-CONTEXT module="doctor-cli" layer="cli" related_files="[]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="doctor command registration" errors="CLI context errors" side_effects="outputs health report"]
+// CIL[DOC-MICRO logic_summary="Runs all checks in dependency order and formats results" 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: 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 registerDoctorCommands(program: Command) {
   program
     .command('doctor')
@@ -477,4 +549,4 @@ export function registerDoctorCommands(program: Command) {
       }
     })
 }
-// CIL[END chunk_id="doctor_registerDoctorCommands_1783405679"]
+// CIL[END chunk_id="doctor_registerdoctorcommands_1784071456"]