spine-framework 0.3.124 → 0.3.126

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

@@ -1,43 +1,67 @@
-/**
- * @module testing
- * @audience custom-developer
- * @layer shared-util
- * @stability evolving
- *
- * Testing utilities for custom code developers.
- * Use these to test your custom functions without full deployment.
- *
- * **Usage in custom function tests:**
- * ```ts
- * import { makeTestContext, mockPrincipal, cleanup } from '@core/testing'
- *
- * describe('My Custom Handler', () => {
- *   it('should process items', async () => {
- *     const ctx = makeTestContext({
- *       principal: mockPrincipal({ roles: ['member'] }),
- *       accountId: 'test-account'
- *     })
- *
- *     const result = await myHandler(mockEvent, ctx)
- *     expect(result.status).toBe('success')
- *
- *     cleanup()
- *   })
- * })
- * ```
- *
- * @seeAlso .framework/tests/unit/core-isolation.test.ts (examples)
- */
 
-import { adminDb } from './db'
 
+
+
+
+
+
+
+
+
+
+
+// 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="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 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="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 export interface TestPrincipal {
   id: string
   account_id: string
@@ -45,28 +69,42 @@ 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="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 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
 }
-
-/**
- * Creates a mock principal for testing.
- *
- * @param overrides - Override default principal properties
- * @returns Mock principal object
- *
- * @example
- * ```ts
- * const admin = mockPrincipal({
- *   roles: ['system_admin'],
- *   permissions: { all: true }
- * })
- * ```
- */
+// 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="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 export function mockPrincipal(overrides: Partial<TestPrincipal> = {}): TestPrincipal {
   return {
     id: 'test-user-id',
@@ -77,19 +115,21 @@ export function mockPrincipal(overrides: Partial<TestPrincipal> = {}): TestPrinc
     ...overrides
   }
 }
-
-/**
- * Creates a mock logger that captures logs for assertions.
- *
- * @returns TestLogger with log capture
- *
- * @example
- * ```ts
- * const logger = mockLogger()
- * await myFunction(logger)
- * expect(logger.getLogs()).toContain('Processing started')
- * ```
- */
+// 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="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 export function mockLogger(): TestLogger & { getLogs: () => string[] } {
   const logs: string[] = []
 
@@ -113,23 +153,21 @@ export function mockLogger(): TestLogger & { getLogs: () => string[] } {
     getLogs: () => [...logs]
   }
 }
-
-/**
- * Creates a test context for handler testing.
- *
- * @param options - Test context configuration
- * @returns TestContext ready for handler
- *
- * @example
- * ```ts
- * const ctx = makeTestContext({
- *   principal: mockPrincipal({ roles: ['operator'] }),
- *   accountId: 'my-account'
- * })
- *
- * const result = await handler(mockEvent, ctx)
- * ```
- */
+// 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="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 export function makeTestContext(options: {
   principal?: TestPrincipal
   accountId?: string
@@ -142,21 +180,21 @@ export function makeTestContext(options: {
     accountId: options.accountId || options.principal?.account_id || 'test-account'
   }
 }
-
-/**
- * Creates a mock API Gateway event.
- *
- * @param overrides - Override default event properties
- * @returns Mock event object
- *
- * @example
- * ```ts
- * const event = mockEvent({
- *   httpMethod: 'POST',
- *   body: JSON.stringify({ item_id: '123' })
- * })
- * ```
- */
+// 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="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 export function mockEvent(overrides: any = {}): any {
   return {
     httpMethod: 'GET',
@@ -167,12 +205,21 @@ export function mockEvent(overrides: any = {}): any {
     ...overrides
   }
 }
-
-/**
- * Creates a mock Netlify function context.
- *
- * @returns Mock context object
- */
+// 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="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 export function mockNetlifyContext(): any {
   return {
     awsRequestId: 'test-request-id',
@@ -183,33 +230,39 @@ export function mockNetlifyContext(): any {
     getRemainingTimeInMillis: () => 30000
   }
 }
-
-/**
- * Cleanup function for tests.
- * Clears caches and resets state.
- */
+// 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="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 export function cleanup(): void {
-  // Clear any caches or state that might persist between tests
-  // This is a placeholder - actual implementation would clear specific state
   console.log('Test cleanup completed')
 }
-
-/**
- * Setup helper for test files.
- * Returns utilities commonly needed in tests.
- *
- * @example
- * ```ts
- * import { setupTests } from '@core/testing'
- *
- * const { makeTestContext, mockPrincipal, cleanup } = setupTests()
- *
- * describe('My Tests', () => {
- *   afterEach(cleanup)
- *   // ... tests
- * })
- * ```
- */
+// 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="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 export function setupTests() {
   return {
     makeTestContext,
@@ -220,13 +273,21 @@ export function setupTests() {
     cleanup
   }
 }
-
-/**
- * Asserts that a handler response matches expected structure.
- *
- * @param response - Handler response
- * @param expectedStatus - Expected status code
- */
+// 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="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 export function expectSuccessResponse(
   response: { statusCode?: number; body?: string },
   expectedStatus: number = 200
@@ -238,13 +299,21 @@ export function expectSuccessResponse(
     expect(body.error).toBeUndefined()
   }
 }
-
-/**
- * Asserts that a handler returned an error.
- *
- * @param response - Handler response
- * @param expectedStatus - Expected error status code
- */
+// 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="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 export function expectErrorResponse(
   response: { statusCode?: number; body?: string },
   expectedStatus: number = 400
@@ -256,3 +325,4 @@ export function expectErrorResponse(
     expect(body.error || body.message).toBeDefined()
   }
 }
+// CIL[END chunk_id="testing_expecterrorresponse_1784020784"]