spine-framework 0.3.145 → 0.4.0

package/.framework/functions/system.ts

@@ -1,3 +1,12 @@
+// CIL[BEGIN stable_id="~/.framework/functions/system.ts:module_header:module_header" type="module_header" identity="module_header" parent="~/.framework/functions/system.ts"]
+// CIL[DOC-MACRO purpose="Import shared middleware, db and node modules for the system function handler"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide module-level imports and top-level dependencies for system.ts"]
+// CIL[DOC-CONTEXT module="system" layer="functions" related_files=".framework/functions/_shared/db.ts,.framework/functions/_shared/middleware.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Imports createHandler, adminDb, fs utils and path resolve" notable_decisions="none"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stable]
+// CIL[DOC-AUDIENCE audience="system maintainers and agentic tooling"]
 
 
 
@@ -5,47 +14,47 @@
 
 
 
-// CIL[BEGIN chunk_id="system_module_header_1783931956" type="module_header" identity="module_header" parent="none"]
-// CIL[DOC-MACRO purpose="Import dependencies for system discovery endpoints"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide middleware, database, and file system utilities"]
-// CIL[DOC-CONTEXT module="system" layer="api-handler" 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\",\".framework/src/pages/admin/RolesPage.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="imported modules" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Imports handler, database, and file system modules for system operations" 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: api-handler. 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, .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"]
 import { createHandler } from './_shared/middleware'
 import { adminDb } from './_shared/db'
 import { readFileSync, existsSync, readdirSync } from 'fs'
 import { resolve } from 'path'
-// CIL[END chunk_id="system_module_header_1783931956"]
-// CIL[BEGIN chunk_id="system_types_1783931956" type="interface" identity="types" parent="none"]
-// CIL[DOC-MACRO purpose="Define type interfaces for system endpoints"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide type definitions for system data structures"]
-// CIL[DOC-CONTEXT module="system" layer="api-handler" related_files="[\".framework/src/pages/admin/TypeDetailPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/functions/_shared/schema-utils.ts\",\".framework/functions/_shared/principal.ts\",\".framework/src/pages/admin/IntegrationsPage.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="interface definitions" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Defines FunctionInfo, SystemManifest, and HealthCheck interfaces" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: api-handler. Direct callers: 9. Direct calls: 0. Related files: .framework/src/pages/admin/TypeDetailPage.tsx, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .framework/functions/_shared/schema-utils.ts, .framework/functions/_shared/principal.ts, .framework/src/pages/admin/IntegrationsPage.tsx, \."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 9. Total affected: 9."]
-// 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='Import shared middleware, db and node modules for the system function handler'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.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/functions/system.ts:module_header:module_header"]
+// CIL[BEGIN stable_id="~/.framework/functions/system.ts:FunctionInfo:interface" type="interface" identity="FunctionInfo" parent="~/.framework/functions/system.ts"]
+// CIL[DOC-MACRO purpose="Define the shape of a registered Netlify function endpoint"]
+// CIL[DOC-RESPONSIBILITY responsibility="Type contract for function metadata records"]
+// CIL[DOC-CONTEXT module="system" layer="types" related_files=".framework/functions/_shared/db.ts,.framework/functions/_shared/middleware.ts,.framework/functions/system.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="FunctionInfo object shape" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Interface with name, methods, path and optional description" notable_decisions="none"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stable]
 interface FunctionInfo {
   name: string
   methods: string[]
   path: string
   description?: string
 }
-
+// CIL[DOC-VECTOR type="context" content="purpose='Define the shape of a registered Netlify function endpoint'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.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/functions/system.ts:FunctionInfo:interface"]
+
+// CIL[BEGIN stable_id="~/.framework/functions/system.ts:SystemManifest:interface" type="interface" identity="SystemManifest" parent="~/.framework/functions/system.ts"]
+// CIL[DOC-MACRO purpose="Describe the system manifest data structure"]
+// CIL[DOC-RESPONSIBILITY responsibility="Type contract for the manifest response"]
+// CIL[DOC-CONTEXT module="system" layer="types" related_files=".framework/functions/_shared/db.ts,.framework/functions/_shared/middleware.ts,.framework/functions/system.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="SystemManifest shape" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Includes version, schema, migrations, functions and integrity" notable_decisions="none"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stable]
 interface SystemManifest {
   version: string
   schema: string
@@ -60,7 +69,22 @@ interface SystemManifest {
     verified: boolean
   }
 }
-
+// CIL[DOC-VECTOR type="context" content="purpose='Describe the system manifest data structure'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.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/functions/system.ts:SystemManifest:interface"]
+
+// CIL[BEGIN stable_id="~/.framework/functions/system.ts:HealthCheck:interface" type="interface" identity="HealthCheck" parent="~/.framework/functions/system.ts"]
+// CIL[DOC-MACRO purpose="Define the health check report structure"]
+// CIL[DOC-RESPONSIBILITY responsibility="Type contract for the health response"]
+// CIL[DOC-CONTEXT module="system" layer="types" related_files=".framework/functions/_shared/db.ts,.framework/functions/_shared/middleware.ts,.framework/functions/system.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="HealthCheck shape" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Status enum and nested checks for database, migrations, integrity and test_runs" notable_decisions="none"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stable]
 interface HealthCheck {
   status: 'healthy' | 'degraded' | 'unhealthy'
   checks: {
@@ -70,23 +94,38 @@ interface HealthCheck {
     test_runs?: { last_suite: string; last_status: string; last_at: string }
   }
 }
-// CIL[END chunk_id="system_types_1783931956"]
-// CIL[BEGIN chunk_id="system_helpers_1783931956" type="helpers" identity="helpers" parent="none"]
-// CIL[DOC-MACRO purpose="Provide helper functions for system operations"]
-// CIL[DOC-RESPONSIBILITY responsibility="Handle manifest loading and function discovery"]
-// CIL[DOC-CONTEXT module="system" layer="api-handler" related_files="[\"custom/apps/cortex/functions/custom_cil-embeddings.ts\",\".framework/functions/_shared/principal.ts\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/functions/_shared/schema-utils.ts\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="helper functions" errors="none" side_effects="file system access"]
-// CIL[DOC-MICRO logic_summary="Loads manifest from disk, discovers available functions in filesystem" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: api-handler. Direct callers: 0. Direct calls: 0. Related files: custom/apps/cortex/functions/custom_cil-embeddings.ts, .framework/functions/_shared/principal.ts, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .framework/functions/_shared/schema-utils.ts, \."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="context" content="purpose='Define the health check report structure'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.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/functions/system.ts:HealthCheck:interface"]
+// CIL[BEGIN stable_id="~/.framework/functions/system.ts:PROJECT_ROOT:constant" type="constant" identity="PROJECT_ROOT" parent="~/.framework/functions/system.ts"]
+// CIL[DOC-MACRO purpose="Resolve the project root directory at runtime"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide a constant path reference for filesystem resolution"]
+// CIL[DOC-CONTEXT module="system" layer="constants" related_files=".framework/functions/_shared/db.ts,.framework/functions/_shared/middleware.ts,.framework/functions/system.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="string absolute path" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="resolve(process.cwd(), .)" notable_decisions="none"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stable]
 const PROJECT_ROOT = resolve(process.cwd(), '.')
-
+// CIL[DOC-VECTOR type="context" content="purpose='Resolve the project root directory at runtime'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.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/functions/system.ts:PROJECT_ROOT:constant"]
+
+// CIL[BEGIN stable_id="~/.framework/functions/system.ts:loadManifest:function" type="function" identity="loadManifest" parent="~/.framework/functions/system.ts"]
+// CIL[DOC-MACRO purpose="Read and parse the spine manifest file or return a default"]
+// CIL[DOC-RESPONSIBILITY responsibility="Load project version and integrity metadata"]
+// CIL[DOC-CONTEXT module="system" layer="functions" related_files=".framework/functions/_shared/db.ts,.framework/functions/_shared/middleware.ts,.framework/functions/system.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="{ version, integrity }" errors="Returns default on missing file or parse failure" side_effects="Reads .spine-manifest.json from disk"]
+// CIL[DOC-MICRO logic_summary="Check existence of .spine-manifest.json, parse JSON, fallback to 2.0.0 with unverified integrity" notable_decisions="Treats any parse error as default"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stable]
 function loadManifest(): { version: string; integrity: { core_hash: string | null; verified: boolean } } {
   try {
     const manifestPath = resolve(PROJECT_ROOT, '.spine-manifest.json')
@@ -106,7 +145,22 @@ function loadManifest(): { version: string; integrity: { core_hash: string | nul
     return { version: '2.0.0', integrity: { core_hash: null, verified: false } }
   }
 }
-
+// CIL[DOC-VECTOR type="context" content="purpose='Read and parse the spine manifest file or return a default'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.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/functions/system.ts:loadManifest:function"]
+
+// CIL[BEGIN stable_id="~/.framework/functions/system.ts:discoverFunctions:function" type="function" identity="discoverFunctions" parent="~/.framework/functions/system.ts"]
+// CIL[DOC-MACRO purpose="Scan the v2-core functions directory and build endpoint metadata"]
+// CIL[DOC-RESPONSIBILITY responsibility="Discover available Netlify function endpoints and allowed HTTP methods"]
+// CIL[DOC-CONTEXT module="system" layer="functions" related_files=".framework/functions/_shared/db.ts,.framework/functions/_shared/middleware.ts,.framework/functions/system.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="FunctionInfo[]" errors="Returns empty array if directory missing" side_effects="Reads directory entries from v2-core/functions"]
+// CIL[DOC-MICRO logic_summary="List .ts files, assign GET, POST, PATCH, DELETE based on blocklists" notable_decisions="Blocklist-based method filtering for log, test, system and auth endpoints"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stable]
 async function discoverFunctions(): Promise<FunctionInfo[]> {
   const functionsDir = resolve(PROJECT_ROOT, 'v2-core/functions')
   if (!existsSync(functionsDir)) {
@@ -138,21 +192,21 @@ async function discoverFunctions(): Promise<FunctionInfo[]> {
     }
   })
 }
-// CIL[END chunk_id="system_helpers_1783931956"]
-// CIL[BEGIN chunk_id="system_getmanifest_1783931956" type="function" identity="getManifest" parent="none"]
-// CIL[DOC-MACRO purpose="Generate system manifest with version and migration status"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide complete system status information"]
-// CIL[DOC-CONTEXT module="system" layer="api-handler" related_files="[\".framework/src/pages/admin/RolesPage.tsx\",\".framework/migrations/015_simplify_apps_table.sql\",\"custom/apps/portal/pages/ContentPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="SystemManifest data" errors="none" side_effects="database and file system queries"]
-// CIL[DOC-MICRO logic_summary="Compares local migrations with applied migrations, discovers functions" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: api-handler. Direct callers: 1. Direct calls: 0. Related files: .framework/src/pages/admin/RolesPage.tsx, .framework/migrations/015_simplify_apps_table.sql, custom/apps/portal/pages/ContentPage.tsx, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, \."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 1. Total affected: 1."]
-// 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='Scan the v2-core functions directory and build endpoint metadata'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.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/functions/system.ts:discoverFunctions:function"]
+// CIL[BEGIN stable_id="~/.framework/functions/system.ts:getManifest:function" type="function" identity="getManifest" parent="~/.framework/functions/system.ts"]
+// CIL[DOC-MACRO purpose="Assemble the system manifest by combining file discovery and migration state"]
+// CIL[DOC-RESPONSIBILITY responsibility="Build the manifest payload for the manifest action"]
+// CIL[DOC-CONTEXT module="system" layer="functions" related_files=".framework/functions/_shared/db.ts,.framework/functions/_shared/middleware.ts,.framework/functions/system.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="{ data: SystemManifest }" errors="Silently ignores migration query failures, leaving applied list empty" side_effects="Queries schema_migrations table and scans migrations_dayzero directory"]
+// CIL[DOC-MICRO logic_summary="Load manifest, scan local SQL migrations, query applied migrations, compute pending count, discover functions" notable_decisions="Swallows adminDb query errors to keep the handler resilient"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stable]
 async function getManifest(): Promise<{ data: SystemManifest }> {
   const manifest = loadManifest()
 
@@ -194,21 +248,21 @@ async function getManifest(): Promise<{ data: SystemManifest }> {
     }
   }
 }
-// CIL[END chunk_id="system_getmanifest_1783931956"]
-// CIL[BEGIN chunk_id="system_gethealth_1783931956" type="function" identity="getHealth" parent="none"]
-// CIL[DOC-MACRO purpose="Perform system health checks across components"]
-// CIL[DOC-RESPONSIBILITY responsibility="Check database, migrations, and integrity status"]
-// CIL[DOC-CONTEXT module="system" layer="api-handler" related_files="[\".framework/src/components/ui/dialog.tsx\",\".framework/src/components/ui/table-primitives.tsx\",\".framework/src/pages/admin/RolesPage.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="HealthCheck data" errors="none" side_effects="database queries"]
-// CIL[DOC-MICRO logic_summary="Tests database connectivity, compares migration status, checks integrity" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: api-handler. Direct callers: 1. Direct calls: 0. Related files: .framework/src/components/ui/dialog.tsx, .framework/src/components/ui/table-primitives.tsx, .framework/src/pages/admin/RolesPage.tsx, \."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 1. Total affected: 1."]
-// 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='Assemble the system manifest by combining file discovery and migration state'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.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/functions/system.ts:getManifest:function"]
+// CIL[BEGIN stable_id="~/.framework/functions/system.ts:getHealth:function" type="function" identity="getHealth" parent="~/.framework/functions/system.ts"]
+// CIL[DOC-MACRO purpose="Run health checks against database, migrations, integrity and test runs"]
+// CIL[DOC-RESPONSIBILITY responsibility="Build the health payload for the health action"]
+// CIL[DOC-CONTEXT module="system" layer="functions" related_files=".framework/functions/_shared/db.ts,.framework/functions/_shared/middleware.ts,.framework/functions/system.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="{ data: HealthCheck }" errors="Database, migration or test query failures set degraded or unhealthy status" side_effects="Queries accounts, schema_migrations and test_runs tables; reads migrations_dayzero directory"]
+// CIL[DOC-MICRO logic_summary="Test DB connectivity and latency, compare local and applied migrations, verify manifest integrity, fetch latest test run" notable_decisions="Missing DB makes unhealthy; pending migrations or unverified integrity makes degraded"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stable]
 async function getHealth(): Promise<{ data: HealthCheck }> {
   const checks: HealthCheck['checks'] = {
     database: { connected: false, latency_ms: 0 },
@@ -277,21 +331,21 @@ async function getHealth(): Promise<{ data: HealthCheck }> {
 
   return { data: { status, checks } }
 }
-// CIL[END chunk_id="system_gethealth_1783931956"]
-// CIL[BEGIN chunk_id="system_getopenapi_1783931956" type="function" identity="getOpenApi" parent="none"]
-// CIL[DOC-MACRO purpose="Generate OpenAPI 3.1 specification for all endpoints"]
-// CIL[DOC-RESPONSIBILITY responsibility="Create machine-readable API documentation"]
-// CIL[DOC-CONTEXT module="system" layer="api-handler" related_files="[\".framework/migrations/015_simplify_apps_table.sql\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/src/pages/admin/RolesPage.tsx\",\".framework/functions/_shared/principal.ts\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="OpenAPI spec object" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Builds OpenAPI paths and operations from discovered function metadata" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: api-handler. Direct callers: 1. Direct calls: 0. Related files: .framework/migrations/015_simplify_apps_table.sql, .framework/src/pages/admin/TypeDetailPage.tsx, .framework/src/pages/admin/RolesPage.tsx, .framework/functions/_shared/principal.ts, \."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 1. Total affected: 1."]
-// 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='Run health checks against database, migrations, integrity and test runs'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.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/functions/system.ts:getHealth:function"]
+// CIL[BEGIN stable_id="~/.framework/functions/system.ts:getOpenApi:function" type="function" identity="getOpenApi" parent="~/.framework/functions/system.ts"]
+// CIL[DOC-MACRO purpose="Generate an OpenAPI 3.1.0 document from discovered function metadata"]
+// CIL[DOC-RESPONSIBILITY responsibility="Build the openapi payload for the openapi action"]
+// CIL[DOC-CONTEXT module="system" layer="functions" related_files=".framework/functions/_shared/db.ts,.framework/functions/_shared/middleware.ts,.framework/functions/system.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="{ data: any }" errors="None thrown; builds paths from discovered functions" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Discover functions, build path map, add operation metadata and action query parameter, wrap with info and servers" notable_decisions="Response content schema is a placeholder object"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stable]
 async function getOpenApi(): Promise<{ data: any }> {
   const functions = await discoverFunctions()
   const manifest = loadManifest()
@@ -344,21 +398,21 @@ async function getOpenApi(): Promise<{ data: any }> {
     }
   }
 }
-// CIL[END chunk_id="system_getopenapi_1783931956"]
-// CIL[BEGIN chunk_id="system_handler_1783931956" type="function" identity="handler" parent="none"]
-// CIL[DOC-MACRO purpose="Route system API requests to appropriate handlers"]
-// CIL[DOC-RESPONSIBILITY responsibility="Dispatch system endpoint actions based on query parameters"]
-// CIL[DOC-CONTEXT module="system" layer="api-handler" related_files="[\"custom/apps/cortex/functions/custom_cil-embeddings.ts\",\"custom/apps/portal/pages/ContentPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/src/pages/admin/RolesPage.tsx\",\".framework/src/components/ui/table-primitives.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="system data responses" errors="400" side_effects="calls helper functions"]
-// CIL[DOC-MICRO logic_summary="Routes to manifest, health, or openapi based on action parameter" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: api-handler. Direct callers: 0. Direct calls: 0. Related files: custom/apps/cortex/functions/custom_cil-embeddings.ts, custom/apps/portal/pages/ContentPage.tsx, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .framework/src/pages/admin/RolesPage.tsx, .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='Generate an OpenAPI 3.1.0 document from discovered function metadata'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.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/functions/system.ts:getOpenApi:function"]
+// CIL[BEGIN stable_id="~/.framework/functions/system.ts:handler:constant" type="constant" identity="handler" parent="~/.framework/functions/system.ts"]
+// CIL[DOC-MACRO purpose="Create the system Netlify function handler and dispatch actions"]
+// CIL[DOC-RESPONSIBILITY responsibility="Route incoming action query to manifest, health, openapi or return an error"]
+// CIL[DOC-CONTEXT module="system" layer="entry" related_files=".framework/functions/_shared/db.ts,.framework/functions/_shared/middleware.ts,.framework/functions/system.ts"]
+// CIL[DOC-CONTRACT inputs="ctx.query.action" outputs="Promise<manifest or health or openapi result or error response>" errors="Returns 400 error for unknown action" side_effects="Invokes getManifest, getHealth or getOpenApi"]
+// CIL[DOC-MICRO logic_summary="Read action from query, switch on manifest/health/openapi, default to error" notable_decisions="Default action is manifest"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stable]
 export const handler = createHandler(async (ctx) => {
   const q = (ctx as any).query || {}
   const action = q.action || 'manifest'
@@ -380,4 +434,10 @@ export const handler = createHandler(async (ctx) => {
       }
   }
 })
-// CIL[END chunk_id="system_handler_1783931956"]
+// CIL[DOC-VECTOR type="context" content="purpose='Create the system Netlify function handler and dispatch actions'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.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/functions/system.ts:handler:constant"]

package/.framework/functions/tests.ts

@@ -1,37 +1,31 @@
+// CIL[BEGIN stable_id="~/.framework/functions/tests.ts:module_header:module_header" type="module_header" identity="module_header" parent="~/.framework/functions/tests.ts"]
+// CIL[DOC-MACRO purpose="Module setup and imports for tests.ts"]
+// CIL[DOC-RESPONSIBILITY responsibility="Establish the public surface and dependencies of tests.ts"]
+// CIL[DOC-CONTEXT module=".framework/functions/tests.ts" layer="functions" related_files=".framework/functions/_shared/db.ts,.framework/functions/_shared/middleware.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Imports required modules for tests.ts" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-AUDIENCE audience="functions"]
+// CIL[DOC-STABILITY stability="stable"]
 
 
-// CIL[BEGIN chunk_id="tests_module_header_1783931956" type="module_header" identity="module_header" parent="none"]
-// CIL[DOC-MACRO purpose="Import dependencies for test API handler"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide middleware and database access"]
-// CIL[DOC-CONTEXT module="tests" layer="api-handler" 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="imported modules" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Imports createHandler middleware and adminDb for database access" 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: api-handler. 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 { createHandler, requireSystemContextWithAudit } from './_shared/middleware'
 import { adminDb } from './_shared/db'
-// CIL[END chunk_id="tests_module_header_1783931956"]
-// CIL[BEGIN chunk_id="tests_handler_1783931956" type="function" identity="handler" parent="none"]
-// CIL[DOC-MACRO purpose="Handle test API requests with multiple actions"]
-// CIL[DOC-RESPONSIBILITY responsibility="Process test list, get, and stats endpoints"]
-// CIL[DOC-CONTEXT module="tests" layer="api-handler" related_files="[\".framework/functions/_shared/schema-utils.ts\",\".framework/src/pages/admin/RolesPage.tsx\",\".framework/src/components/ui/dialog.tsx\",\".framework/functions/_shared/principal.ts\",\".framework/src/components/ui/table-primitives.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="test data or error responses" errors="400/404/500" side_effects="database queries"]
-// CIL[DOC-MICRO logic_summary="Routes requests by action parameter, queries test_runs and test_results tables" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: api-handler. Direct callers: 0. Direct calls: 0. Related files: .framework/functions/_shared/schema-utils.ts, .framework/src/pages/admin/RolesPage.tsx, .framework/src/components/ui/dialog.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='Module setup and imports for tests.ts'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.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/functions/tests.ts:module_header:module_header"]
+// CIL[BEGIN stable_id="~/.framework/functions/tests.ts:handler:constant" type="constant" identity="handler" parent="~/.framework/functions/tests.ts"]
+// CIL[DOC-MACRO purpose="Define the handler constant"]
+// CIL[DOC-RESPONSIBILITY responsibility="Expose the handler value to consumers"]
+// CIL[DOC-CONTEXT module=".framework/functions/tests.ts" layer="functions" related_files=".framework/functions/_shared/db.ts,.framework/functions/_shared/middleware.ts,.framework/functions/tests.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="handler function" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Binds the expression to the handler identifier" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export const handler = createHandler(async (ctx) => {
   const authErr = requireSystemContextWithAudit(ctx)
   if (authErr) return authErr
@@ -120,4 +114,10 @@ export const handler = createHandler(async (ctx) => {
 
   return { data: data ?? [], error: null }
 })
-// CIL[END chunk_id="tests_handler_1783931956"]
+// CIL[DOC-VECTOR type="context" content="purpose='Define the handler constant'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.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/functions/tests.ts:handler:constant"]