spine-framework 0.3.145 → 0.4.1

package/.framework/functions/_shared/testing.ts

@@ -1,3 +1,13 @@
+// CIL[BEGIN stable_id="~/.framework/functions/_shared/testing.ts:module_header:module_header" type="module_header" identity="module_header" parent="~/.framework/functions/_shared/testing.ts"]
+// CIL[DOC-AUDIENCE audience="internal, test-authors"]
+// CIL[DOC-MACRO purpose="Provide shared test helpers and mock objects for Netlify function tests"]
+// CIL[DOC-RESPONSIBILITY responsibility="Import adminDb and expose types and factory functions for test contexts, principals, loggers, events, and assertions"]
+// CIL[DOC-CONTEXT module=".framework/functions/_shared/testing" layer="shared" related_files=".framework/functions/_shared/db.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="module-level imports and type definitions" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Imports the adminDb client and re-exports test utility types and factories" notable_decisions="Kept as a shared module for Netlify function unit tests"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stable]
+
 
 
 
@@ -10,58 +20,47 @@
 
 
 
-// CIL[BEGIN chunk_id="testing_imports_1784020784" type="module_header" identity="imports" parent="none"]
-// CIL[DOC-MACRO purpose="Import database dependency for testing utilities"]
-// CIL[DOC-RESPONSIBILITY responsibility="Import adminDb from shared database module"]
-// CIL[DOC-CONTEXT module="testing" layer="shared" related_files="[\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/functions/_shared/db.ts\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/functions/_shared/principal.ts\",\".framework/functions/_shared/schema-utils.ts\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="adminDb" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Import statement for database connection" 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: shared. Direct callers: 0. Direct calls: 0. Related files: custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .framework/functions/_shared/db.ts, .framework/src/pages/admin/TypeDetailPage.tsx, .framework/functions/_shared/principal.ts, .framework/functions/_shared/schema-utils.ts, \."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
-// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
-// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 import { adminDb } from './db'
-// CIL[END chunk_id="testing_imports_1784020784"]
-// CIL[BEGIN chunk_id="testing_testcontext_1784020784" type="interface" identity="TestContext" parent="none"]
-// CIL[DOC-MACRO purpose="Define test context interface for unit tests"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide test environment with database, principal, logger"]
-// CIL[DOC-CONTEXT module="testing" layer="shared" related_files="[\".framework/functions/_shared/schema-utils.ts\",\".framework/functions/_shared/principal.ts\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/src/pages/admin/IntegrationsPage.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="TestContext interface" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Interface containing database, principal, logger, and account ID" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: shared. Direct callers: 0. Direct calls: 0. Related files: .framework/functions/_shared/schema-utils.ts, .framework/functions/_shared/principal.ts, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .framework/src/pages/admin/TypeDetailPage.tsx, .framework/src/pages/admin/IntegrationsPage.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='Provide shared test helpers and mock objects for Netlify function tests'; No verified external callers; imports: .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/_shared/testing.ts:module_header:module_header"]
+
+// CIL[BEGIN stable_id="~/.framework/functions/_shared/testing.ts:TestContext:interface" type="interface" identity="TestContext" parent="~/.framework/functions/_shared/testing.ts"]
+// CIL[DOC-AUDIENCE audience="internal"]
+// CIL[DOC-MACRO purpose="Describe the shape of a test execution context"]
+// CIL[DOC-RESPONSIBILITY responsibility="Type the dependencies available during a test"]
+// CIL[DOC-CONTEXT module=".framework/functions/_shared/testing" layer="shared" related_files=".framework/functions/_shared/db.ts,.framework/functions/_shared/testing.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="TestContext interface" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Defines db, principal, logger, and accountId fields" notable_decisions="Uses typeof adminDb for the database property"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stable]
 export interface TestContext {
   db: typeof adminDb
   principal: TestPrincipal
   logger: TestLogger
   accountId: string
 }
-// CIL[END chunk_id="testing_testcontext_1784020784"]
-// CIL[BEGIN chunk_id="testing_testprincipal_1784020784" type="interface" identity="TestPrincipal" parent="none"]
-// CIL[DOC-MACRO purpose="Define test principal interface for authentication testing"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide mock user identity and permissions structure"]
-// CIL[DOC-CONTEXT module="testing" layer="shared" related_files="[\".framework/functions/_shared/principal.ts\",\".framework/functions/_shared/schema-utils.ts\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/src/pages/admin/IntegrationsPage.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="TestPrincipal interface" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Interface with user ID, account, roles, permissions, email" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: shared. Direct callers: 0. Direct calls: 0. Related files: .framework/functions/_shared/principal.ts, .framework/functions/_shared/schema-utils.ts, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .framework/src/pages/admin/TypeDetailPage.tsx, .framework/src/pages/admin/IntegrationsPage.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='Describe the shape of a test execution context'; No verified external callers; imports: .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/_shared/testing.ts:TestContext:interface"]
+
+// CIL[BEGIN stable_id="~/.framework/functions/_shared/testing.ts:TestPrincipal:interface" type="interface" identity="TestPrincipal" parent="~/.framework/functions/_shared/testing.ts"]
+// CIL[DOC-AUDIENCE audience="internal"]
+// CIL[DOC-MACRO purpose="Describe a mocked principal for tests"]
+// CIL[DOC-RESPONSIBILITY responsibility="Type a fake user with roles and permissions"]
+// CIL[DOC-CONTEXT module=".framework/functions/_shared/testing" layer="shared" related_files=".framework/functions/_shared/db.ts,.framework/functions/_shared/testing.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="TestPrincipal interface" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Defines id, account_id, roles, permissions, and optional email" notable_decisions="Defaults to member role and test email"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stable]
 export interface TestPrincipal {
   id: string
   account_id: string
@@ -69,42 +68,46 @@ export interface TestPrincipal {
   permissions: Record<string, any>
   email?: string
 }
-// CIL[END chunk_id="testing_testprincipal_1784020784"]
-// CIL[BEGIN chunk_id="testing_testlogger_1784020784" type="interface" identity="TestLogger" parent="none"]
-// CIL[DOC-MACRO purpose="Define test logger interface for capturing log output"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide logging methods for test verification"]
-// CIL[DOC-CONTEXT module="testing" layer="shared" related_files="[\".framework/functions/_shared/schema-utils.ts\",\".framework/src/components/ui/dialog.tsx\",\".framework/functions/_shared/principal.ts\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="TestLogger interface" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Interface with info, warn, error, debug logging methods" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: shared. Direct callers: 0. Direct calls: 0. Related files: .framework/functions/_shared/schema-utils.ts, .framework/src/components/ui/dialog.tsx, .framework/functions/_shared/principal.ts, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .framework/src/pages/admin/TypeDetailPage.tsx, \."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="context" content="purpose='Describe a mocked principal for tests'; No verified external callers; imports: .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/_shared/testing.ts:TestPrincipal:interface"]
+
+// CIL[BEGIN stable_id="~/.framework/functions/_shared/testing.ts:TestLogger:interface" type="interface" identity="TestLogger" parent="~/.framework/functions/_shared/testing.ts"]
+// CIL[DOC-AUDIENCE audience="internal"]
+// CIL[DOC-MACRO purpose="Describe a test logger interface"]
+// CIL[DOC-RESPONSIBILITY responsibility="Define the logging methods used by test doubles"]
+// CIL[DOC-CONTEXT module=".framework/functions/_shared/testing" layer="shared" related_files=".framework/functions/_shared/db.ts,.framework/functions/_shared/testing.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="TestLogger interface" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Declares info, warn, error, and debug methods with optional metadata" notable_decisions=""]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stable]
 export interface TestLogger {
   info: (msg: string, meta?: any) => void
   warn: (msg: string, meta?: any) => void
   error: (msg: string, meta?: any) => void
   debug: (msg: string, meta?: any) => void
 }
-// CIL[END chunk_id="testing_testlogger_1784020784"]
-// CIL[BEGIN chunk_id="testing_mockprincipal_1784020784" type="function" identity="mockPrincipal" parent="none"]
-// CIL[DOC-MACRO purpose="Create mock principal for testing authentication"]
-// CIL[DOC-RESPONSIBILITY responsibility="Generate default test user with optional overrides"]
-// CIL[DOC-CONTEXT module="testing" layer="shared" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="TestPrincipal" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Returns default test principal with spread overrides" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: shared. 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="context" content="purpose='Describe a test logger interface'; No verified external callers; imports: .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/_shared/testing.ts:TestLogger:interface"]
+
+// CIL[BEGIN stable_id="~/.framework/functions/_shared/testing.ts:mockPrincipal:function" type="function" identity="mockPrincipal" parent="~/.framework/functions/_shared/testing.ts"]
+// CIL[DOC-AUDIENCE audience="internal"]
+// CIL[DOC-MACRO purpose="Build a mock principal object"]
+// CIL[DOC-RESPONSIBILITY responsibility="Return a TestPrincipal with safe defaults and optional overrides"]
+// CIL[DOC-CONTEXT module=".framework/functions/_shared/testing" layer="shared" related_files=".framework/functions/_shared/db.ts,.framework/functions/_shared/testing.ts"]
+// CIL[DOC-CONTRACT inputs="overrides: Partial<TestPrincipal>" outputs="TestPrincipal" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Merges default values with any provided overrides" notable_decisions="Defaults to member role and test IDs"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stable]
 export function mockPrincipal(overrides: Partial<TestPrincipal> = {}): TestPrincipal {
   return {
     id: 'test-user-id',
@@ -115,21 +118,23 @@ export function mockPrincipal(overrides: Partial<TestPrincipal> = {}): TestPrinc
     ...overrides
   }
 }
-// CIL[END chunk_id="testing_mockprincipal_1784020784"]
-// CIL[BEGIN chunk_id="testing_mocklogger_1784020784" type="function" identity="mockLogger" parent="none"]
-// CIL[DOC-MACRO purpose="Create mock logger that captures logs for test verification"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide in-memory logging with retrieval capability"]
-// CIL[DOC-CONTEXT module="testing" layer="shared" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="TestLogger & { getLogs: () => string[] }" errors="none" side_effects="console output"]
-// CIL[DOC-MICRO logic_summary="Returns logger that stores messages and provides getLogs method" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: shared. 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="context" content="purpose='Build a mock principal object'; No verified external callers; imports: .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/_shared/testing.ts:mockPrincipal:function"]
+
+// CIL[BEGIN stable_id="~/.framework/functions/_shared/testing.ts:mockLogger:function" type="function" identity="mockLogger" parent="~/.framework/functions/_shared/testing.ts"]
+// CIL[DOC-AUDIENCE audience="internal"]
+// CIL[DOC-MACRO purpose="Create a test logger that captures log messages"]
+// CIL[DOC-RESPONSIBILITY responsibility="Return a TestLogger implementation with in-memory log capture"]
+// CIL[DOC-CONTEXT module=".framework/functions/_shared/testing" layer="shared" related_files=".framework/functions/_shared/db.ts,.framework/functions/_shared/testing.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="TestLogger & { getLogs: () => string[] }" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Implements info/warn/error/debug methods that record strings" notable_decisions="Mirrors messages to console when meta is provided"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stable]
 export function mockLogger(): TestLogger & { getLogs: () => string[] } {
   const logs: string[] = []
 
@@ -153,21 +158,23 @@ export function mockLogger(): TestLogger & { getLogs: () => string[] } {
     getLogs: () => [...logs]
   }
 }
-// CIL[END chunk_id="testing_mocklogger_1784020784"]
-// CIL[BEGIN chunk_id="testing_maketestcontext_1784020784" type="function" identity="makeTestContext" parent="none"]
-// CIL[DOC-MACRO purpose="Create complete test context with defaults and overrides"]
-// CIL[DOC-RESPONSIBILITY responsibility="Assemble test environment with database, principal, logger, account"]
-// CIL[DOC-CONTEXT module="testing" layer="shared" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="TestContext" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Builds context with defaults or provided options" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: shared. 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="context" content="purpose='Create a test logger that captures log messages'; No verified external callers; imports: .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/_shared/testing.ts:mockLogger:function"]
+
+// CIL[BEGIN stable_id="~/.framework/functions/_shared/testing.ts:makeTestContext:function" type="function" identity="makeTestContext" parent="~/.framework/functions/_shared/testing.ts"]
+// CIL[DOC-AUDIENCE audience="internal"]
+// CIL[DOC-MACRO purpose="Assemble a TestContext from optional components"]
+// CIL[DOC-RESPONSIBILITY responsibility="Return a test context with db, principal, logger, and accountId"]
+// CIL[DOC-CONTEXT module=".framework/functions/_shared/testing" layer="shared" related_files=".framework/functions/_shared/db.ts,.framework/functions/_shared/testing.ts"]
+// CIL[DOC-CONTRACT inputs="options" outputs="TestContext" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Falls back to mock principal, logger, and account values" notable_decisions="Resolves accountId from options or principal.account_id with test default"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stable]
 export function makeTestContext(options: {
   principal?: TestPrincipal
   accountId?: string
@@ -180,21 +187,23 @@ export function makeTestContext(options: {
     accountId: options.accountId || options.principal?.account_id || 'test-account'
   }
 }
-// CIL[END chunk_id="testing_maketestcontext_1784020784"]
-// CIL[BEGIN chunk_id="testing_mockevent_1784020784" type="function" identity="mockEvent" parent="none"]
-// CIL[DOC-MACRO purpose="Create mock HTTP event for API testing"]
-// CIL[DOC-RESPONSIBILITY responsibility="Generate default API gateway event structure"]
-// CIL[DOC-CONTEXT module="testing" layer="shared" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="mock event object" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Returns default HTTP event with spread overrides" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: shared. 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="context" content="purpose='Assemble a TestContext from optional components'; No verified external callers; imports: .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/_shared/testing.ts:makeTestContext:function"]
+
+// CIL[BEGIN stable_id="~/.framework/functions/_shared/testing.ts:mockEvent:function" type="function" identity="mockEvent" parent="~/.framework/functions/_shared/testing.ts"]
+// CIL[DOC-AUDIENCE audience="internal"]
+// CIL[DOC-MACRO purpose="Build a fake Netlify function event"]
+// CIL[DOC-RESPONSIBILITY responsibility="Return a base Netlify event object for testing"]
+// CIL[DOC-CONTEXT module=".framework/functions/_shared/testing" layer="shared" related_files=".framework/functions/_shared/db.ts,.framework/functions/_shared/testing.ts"]
+// CIL[DOC-CONTRACT inputs="overrides" outputs="any" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Starts with common HTTP event fields and applies overrides" notable_decisions="Defaults to GET /api/test"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stable]
 export function mockEvent(overrides: any = {}): any {
   return {
     httpMethod: 'GET',
@@ -205,21 +214,23 @@ export function mockEvent(overrides: any = {}): any {
     ...overrides
   }
 }
-// CIL[END chunk_id="testing_mockevent_1784020784"]
-// CIL[BEGIN chunk_id="testing_mocknetlifycontext_1784020784" type="function" identity="mockNetlifyContext" parent="none"]
-// CIL[DOC-MACRO purpose="Create mock Netlify function context for testing"]
-// CIL[DOC-RESPONSIBILITY responsibility="Generate Netlify runtime context mock object"]
-// CIL[DOC-CONTEXT module="testing" layer="shared" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="mock Netlify context" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Returns mock context with AWS Lambda properties" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: shared. 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="context" content="purpose='Build a fake Netlify function event'; No verified external callers; imports: .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/_shared/testing.ts:mockEvent:function"]
+
+// CIL[BEGIN stable_id="~/.framework/functions/_shared/testing.ts:mockNetlifyContext:function" type="function" identity="mockNetlifyContext" parent="~/.framework/functions/_shared/testing.ts"]
+// CIL[DOC-AUDIENCE audience="internal"]
+// CIL[DOC-MACRO purpose="Create a fake Netlify function context"]
+// CIL[DOC-RESPONSIBILITY responsibility="Return a mock AWS Lambda context"]
+// CIL[DOC-CONTEXT module=".framework/functions/_shared/testing" layer="shared" related_files=".framework/functions/_shared/db.ts,.framework/functions/_shared/testing.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="any" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Provides request ID, function name, memory limit, and timeout getter" notable_decisions="Uses fixed test identifiers"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stable]
 export function mockNetlifyContext(): any {
   return {
     awsRequestId: 'test-request-id',
@@ -230,39 +241,43 @@ export function mockNetlifyContext(): any {
     getRemainingTimeInMillis: () => 30000
   }
 }
-// CIL[END chunk_id="testing_mocknetlifycontext_1784020784"]
-// CIL[BEGIN chunk_id="testing_cleanup_1784020784" type="function" identity="cleanup" parent="none"]
-// CIL[DOC-MACRO purpose="Clean up test environment after test execution"]
-// CIL[DOC-RESPONSIBILITY responsibility="Perform post-test cleanup operations"]
-// CIL[DOC-CONTEXT module="testing" layer="shared" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="void" errors="none" side_effects="console output"]
-// CIL[DOC-MICRO logic_summary="Logs cleanup completion message" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: shared. 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="context" content="purpose='Create a fake Netlify function context'; No verified external callers; imports: .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/_shared/testing.ts:mockNetlifyContext:function"]
+
+// CIL[BEGIN stable_id="~/.framework/functions/_shared/testing.ts:cleanup:function" type="function" identity="cleanup" parent="~/.framework/functions/_shared/testing.ts"]
+// CIL[DOC-AUDIENCE audience="internal"]
+// CIL[DOC-MACRO purpose="Log completion of test cleanup"]
+// CIL[DOC-RESPONSIBILITY responsibility="Output a cleanup confirmation message"]
+// CIL[DOC-CONTEXT module=".framework/functions/_shared/testing" layer="shared" related_files=".framework/functions/_shared/db.ts,.framework/functions/_shared/testing.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="void" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Logs a static message to the console" notable_decisions="Minimal shared cleanup hook"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stable]
 export function cleanup(): void {
   console.log('Test cleanup completed')
 }
-// CIL[END chunk_id="testing_cleanup_1784020784"]
-// CIL[BEGIN chunk_id="testing_setuptests_1784020784" type="function" identity="setupTests" parent="none"]
-// CIL[DOC-MACRO purpose="Export all testing utilities in single object"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide comprehensive testing toolkit"]
-// CIL[DOC-CONTEXT module="testing" layer="shared" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="testing utilities object" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Returns object containing all testing helper 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: shared. 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="context" content="purpose='Log completion of test cleanup'; No verified external callers; imports: .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/_shared/testing.ts:cleanup:function"]
+
+// CIL[BEGIN stable_id="~/.framework/functions/_shared/testing.ts:setupTests:function" type="function" identity="setupTests" parent="~/.framework/functions/_shared/testing.ts"]
+// CIL[DOC-AUDIENCE audience="internal"]
+// CIL[DOC-MACRO purpose="Bundle all test helpers for convenience"]
+// CIL[DOC-RESPONSIBILITY responsibility="Return an object with all factory functions"]
+// CIL[DOC-CONTEXT module=".framework/functions/_shared/testing" layer="shared" related_files=".framework/functions/_shared/db.ts,.framework/functions/_shared/testing.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="object containing test factories" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Exposes makeTestContext, mockPrincipal, mockLogger, mockEvent, mockNetlifyContext, and cleanup" notable_decisions="Simplifies importing helpers in tests"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stable]
 export function setupTests() {
   return {
     makeTestContext,
@@ -273,21 +288,23 @@ export function setupTests() {
     cleanup
   }
 }
-// CIL[END chunk_id="testing_setuptests_1784020784"]
-// CIL[BEGIN chunk_id="testing_expectsuccessresponse_1784020784" type="function" identity="expectSuccessResponse" parent="none"]
-// CIL[DOC-MACRO purpose="Assert HTTP response indicates success"]
-// CIL[DOC-RESPONSIBILITY responsibility="Validate successful API response format"]
-// CIL[DOC-CONTEXT module="testing" layer="shared" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="void" errors="assertion failures" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Checks status code and ensures no error in body" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: shared. 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="context" content="purpose='Bundle all test helpers for convenience'; No verified external callers; imports: .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/_shared/testing.ts:setupTests:function"]
+
+// CIL[BEGIN stable_id="~/.framework/functions/_shared/testing.ts:expectSuccessResponse:function" type="function" identity="expectSuccessResponse" parent="~/.framework/functions/_shared/testing.ts"]
+// CIL[DOC-AUDIENCE audience="internal"]
+// CIL[DOC-MACRO purpose="Assert a response indicates success"]
+// CIL[DOC-RESPONSIBILITY responsibility="Validate status code and that the body has no error field"]
+// CIL[DOC-CONTEXT module=".framework/functions/_shared/testing" layer="shared" related_files=".framework/functions/_shared/db.ts,.framework/functions/_shared/testing.ts"]
+// CIL[DOC-CONTRACT inputs="response, expectedStatus" outputs="void" errors="Throws on assertion failure" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Checks status and parses JSON body for the absence of error" notable_decisions="Skips body checks when body is absent"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stable]
 export function expectSuccessResponse(
   response: { statusCode?: number; body?: string },
   expectedStatus: number = 200
@@ -299,21 +316,23 @@ export function expectSuccessResponse(
     expect(body.error).toBeUndefined()
   }
 }
-// CIL[END chunk_id="testing_expectsuccessresponse_1784020784"]
-// CIL[BEGIN chunk_id="testing_expecterrorresponse_1784020784" type="function" identity="expectErrorResponse" parent="none"]
-// CIL[DOC-MACRO purpose="Assert HTTP response indicates error"]
-// CIL[DOC-RESPONSIBILITY responsibility="Validate error API response format"]
-// CIL[DOC-CONTEXT module="testing" layer="shared" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="void" errors="assertion failures" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Checks status code and ensures error in body" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: shared. 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="context" content="purpose='Assert a response indicates success'; No verified external callers; imports: .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/_shared/testing.ts:expectSuccessResponse:function"]
+
+// CIL[BEGIN stable_id="~/.framework/functions/_shared/testing.ts:expectErrorResponse:function" type="function" identity="expectErrorResponse" parent="~/.framework/functions/_shared/testing.ts"]
+// CIL[DOC-AUDIENCE audience="internal"]
+// CIL[DOC-MACRO purpose="Assert a response indicates an error"]
+// CIL[DOC-RESPONSIBILITY responsibility="Validate status code and that the body has an error or message"]
+// CIL[DOC-CONTEXT module=".framework/functions/_shared/testing" layer="shared" related_files=".framework/functions/_shared/db.ts,.framework/functions/_shared/testing.ts"]
+// CIL[DOC-CONTRACT inputs="response, expectedStatus" outputs="void" errors="Throws on assertion failure" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Checks status and parses JSON body for the presence of error or message" notable_decisions="Accepts either error or message field as the error indicator"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stable]
 export function expectErrorResponse(
   response: { statusCode?: number; body?: string },
   expectedStatus: number = 400
@@ -325,4 +344,10 @@ export function expectErrorResponse(
     expect(body.error || body.message).toBeDefined()
   }
 }
-// CIL[END chunk_id="testing_expecterrorresponse_1784020784"]
+// CIL[DOC-VECTOR type="context" content="purpose='Assert a response indicates an error'; No verified external callers; imports: .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/_shared/testing.ts:expectErrorResponse:function"]