spine-framework 0.3.145 → 0.4.1

package/.framework/functions/debug-auth.ts

@@ -1,3 +1,14 @@
+// CIL[BEGIN stable_id="~/.framework/functions/debug-auth.ts:module_header:module_header" type="module_header" identity="module_header" parent="~/.framework/functions/debug-auth.ts"]
+// CIL[DOC-MACRO purpose="Netlify function for debugging authentication state and JWT token resolution"]
+// CIL[DOC-RESPONSIBILITY responsibility="Exposes debug and testJwt handlers for inspecting principal, environment variables, and token validity"]
+// CIL[DOC-CONTEXT module="framework/functions" layer="functions" related_files=".framework/functions/_shared/middleware.ts"]
+// CIL[DOC-CONTRACT inputs="HTTP event and context" outputs="JSON response with auth debug data" errors="Returns structured errors for missing principal" side_effects="Reads environment variables"]
+// CIL[DOC-MICRO logic_summary="Defines the debug-auth Netlify function entry point and handler constants" notable_decisions="Uses createHandler from shared middleware to wrap endpoint logic"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-AUDIENCE audience="internal"]
+
+
 
 
 
@@ -11,38 +22,23 @@
 
 
 
-// CIL[BEGIN chunk_id="debug-auth_moduleheader_1783969696" type="module_header" identity="imports" parent="none"]
-// CIL[DOC-MACRO purpose="Import middleware for debug auth module"]
-// CIL[DOC-RESPONSIBILITY responsibility="Import request handler creation utility"]
-// CIL[DOC-CONTEXT module="debug-auth" layer="backend_functions" related_files="[\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/migrations/015_simplify_apps_table.sql\",\".framework/functions/_shared/principal.ts\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/functions/_shared/schema-utils.ts\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="imported_modules" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Import createHandler for debug authentication functions" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-AUDIENCE audience="developer"]
-// CIL[DOC-VECTOR type="context" content="Layer: backend_functions. Direct callers: 0. Direct calls: 0. Related files: custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .framework/migrations/015_simplify_apps_table.sql, .framework/functions/_shared/principal.ts, .framework/src/pages/admin/TypeDetailPage.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="implementation_pattern" content="" status="pending_human_input"]
-// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 
 import { createHandler } from './_shared/middleware'
-// CIL[END chunk_id="debug-auth_moduleheader_1783969696"]
-// CIL[BEGIN chunk_id="debug-auth_debug_1783969696" type="function" identity="debug" parent="none"]
-// CIL[DOC-MACRO purpose="Debug authentication endpoint"]
-// CIL[DOC-RESPONSIBILITY responsibility="Return auth context and environment info"]
-// CIL[DOC-CONTEXT module="debug-auth" layer="backend_functions" related_files="[\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="debug_info" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Return principal info, request ID, and environment variables status" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: backend_functions. Direct callers: 1. Direct calls: 0. Related files: \."]
-// 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='Netlify function for debugging authentication state and JWT token resolution'; No verified external callers; imports: .framework/functions/_shared/middleware.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/debug-auth.ts:module_header:module_header"]
+// CIL[BEGIN stable_id="~/.framework/functions/debug-auth.ts:debug:constant" type="constant" identity="debug" parent="~/.framework/functions/debug-auth.ts"]
+// CIL[DOC-MACRO purpose="Return a debug payload showing whether a principal and selected environment variables are present"]
+// CIL[DOC-RESPONSIBILITY responsibility="Builds a safe, read-only debug response from request context and process.env"]
+// CIL[DOC-CONTEXT module="framework/functions" layer="functions" related_files=".framework/functions/_shared/middleware.ts,.framework/functions/debug-auth.ts"]
+// CIL[DOC-CONTRACT inputs="Request context and body" outputs="JSON data with principal presence, type, request id, and env set flags" errors="None" side_effects="Reads process.env"]
+// CIL[DOC-MICRO logic_summary="Checks the request context for a principal and masks environment variable presence" notable_decisions="Only reports SET/NOT_SET for sensitive env values"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 const debug = createHandler(async (ctx, _body) => {
   const envObj = (globalThis as any).process?.env || {}
   return {
@@ -58,21 +54,21 @@ const debug = createHandler(async (ctx, _body) => {
     }
   }
 })
-// CIL[END chunk_id="debug-auth_debug_1783969696"]
-// CIL[BEGIN chunk_id="debug-auth_testjwt_1783969696" type="function" identity="testJwt" parent="none"]
-// CIL[DOC-MACRO purpose="Test JWT token validation"]
-// CIL[DOC-RESPONSIBILITY responsibility="Validate and return JWT principal information"]
-// CIL[DOC-CONTEXT module="debug-auth" layer="backend_functions" related_files="[\".framework/functions/_shared/schema-utils.ts\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="principal_info" errors="auth_errors" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Extract and return principal details from validated JWT token" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: backend_functions. Direct callers: 1. Direct calls: 0. Related files: .framework/functions/_shared/schema-utils.ts, .framework/src/pages/admin/TypeDetailPage.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='Return a debug payload showing whether a principal and selected environment variables are present'; No verified external callers; imports: .framework/functions/_shared/middleware.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/debug-auth.ts:debug:constant"]
+// CIL[BEGIN stable_id="~/.framework/functions/debug-auth.ts:testJwt:constant" type="constant" identity="testJwt" parent="~/.framework/functions/debug-auth.ts"]
+// CIL[DOC-MACRO purpose="Validate and return the resolved JWT principal for a request"]
+// CIL[DOC-RESPONSIBILITY responsibility="Verifies a principal exists and returns its identity and account association"]
+// CIL[DOC-CONTEXT module="framework/functions" layer="functions" related_files=".framework/functions/_shared/middleware.ts,.framework/functions/debug-auth.ts"]
+// CIL[DOC-CONTRACT inputs="Request context and body" outputs="JSON data with tokenValid flag and principal details" errors="Returns error when no principal is resolved" side_effects="None"]
+// CIL[DOC-MICRO logic_summary="Returns principal data or an error if authentication did not resolve" notable_decisions="Includes accountId from the request context"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 const testJwt = createHandler(async (ctx, _body) => {
   const envObj = (globalThis as any).process?.env || {}
   if (!ctx.principal) {
@@ -93,21 +89,21 @@ const testJwt = createHandler(async (ctx, _body) => {
     }
   }
 })
-// CIL[END chunk_id="debug-auth_testjwt_1783969696"]
-// CIL[BEGIN chunk_id="debug-auth_handler_1783969696" type="function" identity="handler" parent="none"]
-// CIL[DOC-MACRO purpose="Route debug auth HTTP methods"]
-// CIL[DOC-RESPONSIBILITY responsibility="Dispatch requests to debug authentication operations"]
-// CIL[DOC-CONTEXT module="debug-auth" layer="backend_functions" related_files="[\".framework/functions/_shared/principal.ts\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="function_responses" errors="method_errors" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Route method parameter to debug or testJwt 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: backend_functions. Direct callers: 0. Direct calls: 0. Related files: .framework/functions/_shared/principal.ts, \."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="context" content="purpose='Validate and return the resolved JWT principal for a request'; No verified external callers; imports: .framework/functions/_shared/middleware.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/debug-auth.ts:testJwt:constant"]
+// CIL[BEGIN stable_id="~/.framework/functions/debug-auth.ts:handler:function" type="function" identity="handler" parent="~/.framework/functions/debug-auth.ts"]
+// CIL[DOC-MACRO purpose="Route incoming requests to the debug or testJwt handler"]
+// CIL[DOC-RESPONSIBILITY responsibility="Dispatches by query method to the appropriate handler and returns the result"]
+// CIL[DOC-CONTEXT module="framework/functions" layer="functions" related_files=".framework/functions/_shared/middleware.ts,.framework/functions/debug-auth.ts"]
+// CIL[DOC-CONTRACT inputs="event (any), context (any)" outputs="JSON response from selected handler" errors="Falls back to debug for unknown methods" side_effects="Invokes createHandler middleware"]
+// CIL[DOC-MICRO logic_summary="Reads the method query parameter, switches to debug or testJwt, and awaits the handler" notable_decisions="Defaults unknown methods to debug"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export async function handler(event: any, context: any) {
   const method = event.queryStringParameters?.method || 'debug'
   
@@ -124,4 +120,10 @@ export async function handler(event: any, context: any) {
   
   return ctx
 }
-// CIL[END chunk_id="debug-auth_handler_1783969696"]
+// CIL[DOC-VECTOR type="context" content="purpose='Route incoming requests to the debug or testJwt handler'; No verified external callers; imports: .framework/functions/_shared/middleware.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/debug-auth.ts:handler:function"]

package/.framework/functions/deliveries.ts

@@ -1,24 +1,33 @@
-// CIL[BEGIN chunk_id="deliveries_module_header_1784200008" type="module_header" identity="imports" parent="none"]
-// CIL[DOC-MACRO purpose="List and manage webhook delivery records"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide admin API for webhook_deliveries ledger"]
-// CIL[DOC-CONTEXT module="deliveries" layer="backend_functions" related_files="[".framework/migrations/051_integration_broker.sql",".framework/functions/_shared/retry-deliveries.ts",".framework/functions/integration-outbound.ts",".framework/src/pages/admin/DeliveriesPage.tsx"]"]
-// CIL[DOC-CONTRACT inputs="ctx, body" outputs="{ data }" errors="account_required, not_found" side_effects="DB reads, optional retry side effects"]
-// CIL[DOC-MICRO logic_summary="Lists webhook deliveries with filters, gets a single delivery, and can trigger a manual retry for outbound records." notable_decisions="["webhook_deliveries is not a runtime type, so it gets its own function instead of using admin-data.","Manual retry reuses the delivery_id path in integration-outbound for outbound records."]"]
-// CIL[DOC-CONFIDENCE pass="first" score="0.85" flags="none"]
-// CIL[DOC-STABILITY stability="experimental"]
-// CIL[DOC-AUDIENCE audience="developer"]
-// CIL[DOC-VECTOR type="context" content="Layer: backend_functions. Direct callers: 0. Direct calls: 0. Related files: .framework/migrations/051_integration_broker.sql, .framework/functions/_shared/retry-deliveries.ts, .framework/functions/integration-outbound.ts, .framework/src/pages/admin/DeliveriesPage.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="Requires account context."]
-// CIL[DOC-VECTOR type="implementation_pattern" content="Called by the admin Deliveries page."]
-// CIL[DOC-VECTOR type="user_journey" content="Admins monitor webhook delivery attempts."]
+// CIL[BEGIN stable_id="~/.framework/functions/deliveries.ts:module_header:module_header" type="module_header" identity="module_header" parent="~/.framework/functions/deliveries.ts"]
+// CIL[DOC-MACRO purpose="Module: webhook delivery handlers"]
+// CIL[DOC-RESPONSIBILITY responsibility="Exports list, get, retry, and handler functions for delivery operations."]
+// CIL[DOC-CONTEXT module="deliveries" layer="function" related_files=".framework/functions/_shared/audit.ts,.framework/functions/_shared/middleware.ts,.framework/functions/_shared/principal.ts,.framework/functions/integration-outbound.ts"]
+// CIL[DOC-CONTRACT inputs="N/A" outputs="N/A" errors="N/A" side_effects="N/A"]
+// CIL[DOC-MICRO logic_summary="Collects delivery-related handlers into a single functions module." notable_decisions="Uses createHandler for request shape; handler dispatches to list/get/retry based on action and method."]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-AUDIENCE audience="internal"]
 
 import { createHandler } from './_shared/middleware'
 import { emitLog } from './_shared/audit'
 import { SYSTEM_PRINCIPAL } from './_shared/principal'
 import { execute as executeOutbound } from './integration-outbound'
-
+// CIL[DOC-VECTOR type="context" content="purpose='Module: webhook delivery handlers'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/audit.ts,.framework/functions/_shared/principal.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/deliveries.ts:module_header:module_header"]
+
+// CIL[BEGIN stable_id="~/.framework/functions/deliveries.ts:list:constant" type="constant" identity="list" parent="~/.framework/functions/deliveries.ts"]
+// CIL[DOC-MACRO purpose="List webhook deliveries for the current account with optional filters."]
+// CIL[DOC-RESPONSIBILITY responsibility="Query and return a paginated list of webhook deliveries."]
+// CIL[DOC-CONTEXT module="deliveries" layer="function" related_files=".framework/functions/_shared/audit.ts,.framework/functions/_shared/middleware.ts,.framework/functions/_shared/principal.ts,.framework/functions/deliveries.ts,.framework/functions/integration-outbound.ts"]
+// CIL[DOC-CONTRACT inputs="ctx.query with optional direction, status, integration_id, api_key_id, limit, offset" outputs="Array of webhook_deliveries rows" errors="Throws on database error or missing account context" side_effects="None"]
+// CIL[DOC-MICRO logic_summary="Builds a Supabase query for webhook_deliveries scoped to the account, applies optional equality filters, and returns a paginated range of results." notable_decisions="Defaults limit to 100 and offset to 0; returns empty array when no data."]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export const list = createHandler(async (ctx, _body) => {
   const { direction, status, integration_id, api_key_id, limit = 100, offset = 0 } = ctx.query || {}
 
@@ -45,7 +54,22 @@ export const list = createHandler(async (ctx, _body) => {
   if (err) throw err
   return data || []
 })
-
+// CIL[DOC-VECTOR type="context" content="purpose='List webhook deliveries for the current account with optional filters.'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/audit.ts,.framework/functions/_shared/principal.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/deliveries.ts:list:constant"]
+
+// CIL[BEGIN stable_id="~/.framework/functions/deliveries.ts:get:constant" type="constant" identity="get" parent="~/.framework/functions/deliveries.ts"]
+// CIL[DOC-MACRO purpose="Retrieve a single webhook delivery by ID."]
+// CIL[DOC-RESPONSIBILITY responsibility="Fetch and return one webhook delivery record."]
+// CIL[DOC-CONTEXT module="deliveries" layer="function" related_files=".framework/functions/_shared/audit.ts,.framework/functions/_shared/middleware.ts,.framework/functions/_shared/principal.ts,.framework/functions/deliveries.ts,.framework/functions/integration-outbound.ts"]
+// CIL[DOC-CONTRACT inputs="ctx.query.id" outputs="Single webhook_deliveries row" errors="Throws if ID missing or database error" side_effects="None"]
+// CIL[DOC-MICRO logic_summary="Selects a single webhook delivery matching the provided id." notable_decisions="Assumes id is present and unique; throws generic database error."]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export const get = createHandler(async (ctx, _body) => {
   const { id } = ctx.query || {}
 
@@ -60,7 +84,22 @@ export const get = createHandler(async (ctx, _body) => {
   if (err) throw err
   return data
 })
-
+// CIL[DOC-VECTOR type="context" content="purpose='Retrieve a single webhook delivery by ID.'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/audit.ts,.framework/functions/_shared/principal.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/deliveries.ts:get:constant"]
+
+// CIL[BEGIN stable_id="~/.framework/functions/deliveries.ts:retry:constant" type="constant" identity="retry" parent="~/.framework/functions/deliveries.ts"]
+// CIL[DOC-MACRO purpose="Manually retry an outbound webhook delivery."]
+// CIL[DOC-RESPONSIBILITY responsibility="Validate the delivery exists and is outbound, then re-run the outbound executor."]
+// CIL[DOC-CONTEXT module="deliveries" layer="function" related_files=".framework/functions/_shared/audit.ts,.framework/functions/_shared/middleware.ts,.framework/functions/_shared/principal.ts,.framework/functions/deliveries.ts,.framework/functions/integration-outbound.ts"]
+// CIL[DOC-CONTRACT inputs="body.id" outputs="Result of the outbound execution" errors="Throws if delivery not found, not outbound, or outbound execution fails" side_effects="Emits audit log and re-executes the outbound integration"]
+// CIL[DOC-MICRO logic_summary="Loads the delivery by id, restricts to outbound direction, builds a retry context using the stored account and system principal, invokes executeOutbound, and logs the retry." notable_decisions="Uses SYSTEM_PRINCIPAL for retries; emits audit log with delivery metadata."]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export const retry = createHandler(async (ctx, body) => {
   const { id } = body
 
@@ -95,7 +134,22 @@ export const retry = createHandler(async (ctx, body) => {
 
   return result
 })
-
+// CIL[DOC-VECTOR type="context" content="purpose='Manually retry an outbound webhook delivery.'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/audit.ts,.framework/functions/_shared/principal.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/deliveries.ts:retry:constant"]
+
+// CIL[BEGIN stable_id="~/.framework/functions/deliveries.ts:handler:constant" type="constant" identity="handler" parent="~/.framework/functions/deliveries.ts"]
+// CIL[DOC-MACRO purpose="Route delivery requests to list, get, or retry handlers."]
+// CIL[DOC-RESPONSIBILITY responsibility="Dispatch incoming requests based on action and HTTP method."]
+// CIL[DOC-CONTEXT module="deliveries" layer="function" related_files=".framework/functions/_shared/audit.ts,.framework/functions/_shared/middleware.ts,.framework/functions/_shared/principal.ts,.framework/functions/deliveries.ts,.framework/functions/integration-outbound.ts"]
+// CIL[DOC-CONTRACT inputs="ctx.query.action, ctx.query.method, ctx.query.id, body" outputs="Result of list, get, or retry" errors="Throws on invalid action or method" side_effects="Delegates to other handlers"]
+// CIL[DOC-MICRO logic_summary="Routes GET requests with id to get, without id to list, and POST action retry to retry; otherwise throws." notable_decisions="Defaults method to GET; validates action and method combination."]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export const handler = createHandler(async (ctx, body) => {
   const { action } = ctx.query || {}
   const method = ctx.query?.method || 'GET'
@@ -113,5 +167,10 @@ export const handler = createHandler(async (ctx, body) => {
 
   throw new Error('Invalid action or method')
 })
-
-// CIL[END chunk_id="deliveries_module_header_1784200008"]
+// CIL[DOC-VECTOR type="context" content="purpose='Route delivery requests to list, get, or retry handlers.'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/audit.ts,.framework/functions/_shared/principal.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/deliveries.ts:handler:constant"]