spine-framework 0.3.144 → 0.4.0

package/.framework/functions/_shared/webhook-registration.ts

@@ -1,38 +1,30 @@
-
-
-
-
-// CIL[BEGIN chunk_id="webhookregistration_imports_1784020784" type="module_header" identity="imports" parent="none"]
-// CIL[DOC-MACRO purpose="Import database dependency for webhook registration"]
-// CIL[DOC-RESPONSIBILITY responsibility="Import adminDb for database operations"]
-// CIL[DOC-CONTEXT module="webhook-registration" layer="shared" 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="adminDb" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Import database connection for webhook handler management" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[BEGIN stable_id="~/.framework/functions/_shared/webhook-registration.ts:module_header:module_header" type="module_header" identity="module_header" parent="~/.framework/functions/_shared/webhook-registration.ts"]
+// CIL[DOC-MACRO purpose="Module header for webhook-registration; imports shared database access."]
+// CIL[DOC-RESPONSIBILITY responsibility="Declares module-level imports and identifies file scope."]
+// CIL[DOC-CONTEXT module="webhook-registration" layer="functions" related_files=".framework/functions/_shared/db.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Imports adminDb from ./db for use by webhook registration helpers" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" 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/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-AUDIENCE audience="spine-functions maintainers"]
+
+import { adminDb } from './db'
+// CIL[DOC-VECTOR type="context" content="purpose='Module header for webhook-registration; imports shared database access.'; 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"]
-import { adminDb } from './db'
-// CIL[END chunk_id="webhookregistration_imports_1784020784"]
-// CIL[BEGIN chunk_id="webhookregistration_interface_1784020784" type="interface" identity="WebhookHandlerRegistration" parent="none"]
-// CIL[DOC-MACRO purpose="Define webhook handler registration interface"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide structure for webhook handler configuration"]
-// CIL[DOC-CONTEXT module="webhook-registration" layer="shared" related_files="[\".framework/functions/_shared/schema-utils.ts\",\".framework/src/pages/admin/IntegrationsPage.tsx\",\".framework/functions/_shared/principal.ts\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\"custom/apps/cortex/functions/custom_cil-embeddings.ts\",\"\\\"]"]
+// CIL[END stable_id="~/.framework/functions/_shared/webhook-registration.ts:module_header:module_header"]
+
+// CIL[BEGIN stable_id="~/.framework/functions/_shared/webhook-registration.ts:WebhookHandlerRegistration:interface" type="interface" identity="WebhookHandlerRegistration" parent="~/.framework/functions/_shared/webhook-registration.ts"]
+// CIL[DOC-MACRO purpose="Defines the configuration shape for registering a webhook handler"]
+// CIL[DOC-RESPONSIBILITY responsibility="Describe the fields required to register a webhook handler"]
+// CIL[DOC-CONTEXT module="webhook-registration" layer="functions" related_files=".framework/functions/_shared/db.ts,.framework/functions/_shared/webhook-registration.ts"]
 // CIL[DOC-CONTRACT inputs="none" outputs="WebhookHandlerRegistration interface" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Interface with handler metadata, events, and optional database" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[DOC-MICRO logic_summary="Exported interface describing name, functionName, optional description, events, appId, accountId, isSystem, and an optional db override" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" 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/pages/admin/IntegrationsPage.tsx, .framework/functions/_shared/principal.ts, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, custom/apps/cortex/functions/custom_cil-embeddings.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"]
 export interface WebhookHandlerRegistration {
   name: string
   functionName: string
@@ -43,21 +35,22 @@ export interface WebhookHandlerRegistration {
   isSystem?: boolean
   db?: typeof adminDb
 }
-// CIL[END chunk_id="webhookregistration_interface_1784020784"]
-// CIL[BEGIN chunk_id="webhookregistration_registerwebhookhandler_1784020784" type="function" identity="registerWebhookHandler" parent="none"]
-// CIL[DOC-MACRO purpose="Register webhook handler in database"]
-// CIL[DOC-RESPONSIBILITY responsibility="Create or update webhook handler record"]
-// CIL[DOC-CONTEXT module="webhook-registration" layer="shared" related_files="[\".framework/functions/_shared/principal.ts\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/src/pages/admin/IntegrationsPage.tsx\",\".framework/migrations/015_simplify_apps_table.sql\",\"custom/apps/cortex/functions/custom_cil-embeddings.ts\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="void" errors="database errors" side_effects="database update"]
-// CIL[DOC-MICRO logic_summary="Upserts handler record with metadata and activation 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: shared. Direct callers: 0. Direct calls: 0. Related files: .framework/functions/_shared/principal.ts, .framework/src/pages/admin/TypeDetailPage.tsx, .framework/src/pages/admin/IntegrationsPage.tsx, .framework/migrations/015_simplify_apps_table.sql, custom/apps/cortex/functions/custom_cil-embeddings.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='Defines the configuration shape for registering a webhook handler'; 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/webhook-registration.ts:WebhookHandlerRegistration:interface"]
+
+// CIL[BEGIN stable_id="~/.framework/functions/_shared/webhook-registration.ts:registerWebhookHandler:function" type="function" identity="registerWebhookHandler" parent="~/.framework/functions/_shared/webhook-registration.ts"]
+// CIL[DOC-MACRO purpose="Registers or updates a webhook handler record in the database"]
+// CIL[DOC-RESPONSIBILITY responsibility="Upsert an active webhook_handlers row for the given configuration"]
+// CIL[DOC-CONTEXT module="webhook-registration" layer="functions" related_files=".framework/functions/_shared/db.ts,.framework/functions/_shared/webhook-registration.ts"]
+// CIL[DOC-CONTRACT inputs="config: WebhookHandlerRegistration" outputs="void" errors="Supabase upsert error or thrown error" side_effects="Inserts/updates a row in webhook_handlers and logs to console"]
+// CIL[DOC-MICRO logic_summary="Uses provided db or adminDb, upserts a row with name, function_name, description, events, app_id, account_id, is_system, is_active, is_deleted, and timestamps, on conflict on app_id,account_id,name; throws on error" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export async function registerWebhookHandler(
   config: WebhookHandlerRegistration
 ): Promise<void> {
@@ -93,21 +86,22 @@ export async function registerWebhookHandler(
     throw err
   }
 }
-// CIL[END chunk_id="webhookregistration_registerwebhookhandler_1784020784"]
-// CIL[BEGIN chunk_id="webhookregistration_deregisterwebhookhandler_1784020784" type="function" identity="deregisterWebhookHandler" parent="none"]
-// CIL[DOC-MACRO purpose="Deregister webhook handler from database"]
-// CIL[DOC-RESPONSIBILITY responsibility="Soft delete webhook handler record"]
-// CIL[DOC-CONTEXT module="webhook-registration" layer="shared" related_files="[\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="void" errors="database errors" side_effects="database update"]
-// CIL[DOC-MICRO logic_summary="Updates handler to inactive and deleted 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: shared. Direct callers: 0. Direct calls: 0. Related files: \."]
-// 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='Registers or updates a webhook handler record in the database'; 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/webhook-registration.ts:registerWebhookHandler:function"]
+
+// CIL[BEGIN stable_id="~/.framework/functions/_shared/webhook-registration.ts:deregisterWebhookHandler:function" type="function" identity="deregisterWebhookHandler" parent="~/.framework/functions/_shared/webhook-registration.ts"]
+// CIL[DOC-MACRO purpose="Marks a webhook handler as inactive and deleted in the database"]
+// CIL[DOC-RESPONSIBILITY responsibility="Soft-delete a webhook handler by name and optional scope"]
+// CIL[DOC-CONTEXT module="webhook-registration" layer="functions" related_files=".framework/functions/_shared/db.ts,.framework/functions/_shared/webhook-registration.ts"]
+// CIL[DOC-CONTRACT inputs="name: string, appId: string | null, accountId: string | null, db: typeof adminDb" outputs="void" errors="Supabase update error or thrown error" side_effects="Updates webhook_handlers setting is_active=false, is_deleted=true, deleted_at; logs to console"]
+// CIL[DOC-MICRO logic_summary="Builds an update query filtered by name and optional appId/accountId, sets is_active and is_deleted flags with deleted_at, throws on error" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export async function deregisterWebhookHandler(
   name: string,
   appId: string | null = null,
@@ -140,21 +134,22 @@ export async function deregisterWebhookHandler(
     throw err
   }
 }
-// CIL[END chunk_id="webhookregistration_deregisterwebhookhandler_1784020784"]
-// CIL[BEGIN chunk_id="webhookregistration_ishandlerregistered_1784020784" type="function" identity="isHandlerRegistered" parent="none"]
-// CIL[DOC-MACRO purpose="Check if webhook handler is registered and active"]
-// CIL[DOC-RESPONSIBILITY responsibility="Verify handler registration status"]
-// CIL[DOC-CONTEXT module="webhook-registration" layer="shared" related_files="[\".framework/migrations/015_simplify_apps_table.sql\",\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/src/pages/admin/RolesPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="boolean" errors="database errors" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Queries webhook_handlers table for active, non-deleted handler" 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/migrations/015_simplify_apps_table.sql, custom/apps/portal/pages/ContentPage.tsx, .framework/src/pages/admin/RolesPage.tsx, custom/apps/cortex/pages/operations/OperationsDashboard.tsx."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="context" content="purpose='Marks a webhook handler as inactive and deleted in the database'; 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/webhook-registration.ts:deregisterWebhookHandler:function"]
+
+// CIL[BEGIN stable_id="~/.framework/functions/_shared/webhook-registration.ts:isHandlerRegistered:function" type="function" identity="isHandlerRegistered" parent="~/.framework/functions/_shared/webhook-registration.ts"]
+// CIL[DOC-MACRO purpose="Checks whether an active, non-deleted webhook handler exists"]
+// CIL[DOC-RESPONSIBILITY responsibility="Query the database and return a boolean indicating registration status"]
+// CIL[DOC-CONTEXT module="webhook-registration" layer="functions" related_files=".framework/functions/_shared/db.ts,.framework/functions/_shared/webhook-registration.ts"]
+// CIL[DOC-CONTRACT inputs="name: string, db: typeof adminDb" outputs="boolean" errors="Supabase query error" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Selects name from webhook_handlers filtered by name, is_active, is_deleted with maybeSingle; returns true if a row exists, false on error" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export async function isHandlerRegistered(
   name: string,
   db: typeof adminDb = adminDb
@@ -179,4 +174,10 @@ export async function isHandlerRegistered(
     return false
   }
 }
-// CIL[END chunk_id="webhookregistration_ishandlerregistered_1784020784"]
+// CIL[DOC-VECTOR type="context" content="purpose='Checks whether an active, non-deleted webhook handler exists'; 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/webhook-registration.ts:isHandlerRegistered:function"]

package/.framework/functions/_shared/webhook-registry.ts

@@ -1,46 +1,74 @@
+// CIL[BEGIN stable_id="~/.framework/functions/_shared/webhook-registry.ts:module_header:module_header" type="module_header" identity="module_header" parent="~/.framework/functions/_shared/webhook-registry.ts"]
+// CIL[DOC-MACRO purpose="Defines the shared webhook handler registry and its data access for serverless functions"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide imports, types, and core utilities for resolving and loading webhook handler functions"]
+// CIL[DOC-CONTEXT module="webhook-registry" layer="functions" related_files=".framework/functions/_shared/db.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Contains the file header and shared adminDb import used by the registry functions" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-AUDIENCE audience="spine-functions maintainers"]
 
+import { adminDb } from './db'
+// CIL[DOC-VECTOR type="context" content="purpose='Defines the shared webhook handler registry and its data access for serverless functions'; 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/webhook-registry.ts:module_header:module_header"]
 
 
-
-
-// CIL[BEGIN chunk_id="webhookregistry_imports_1784020784" type="module_header" identity="imports" parent="none"]
-// CIL[DOC-MACRO purpose="Import database dependency and initialize handler cache"]
-// CIL[DOC-RESPONSIBILITY responsibility="Import adminDb and create handler caching system"]
-// CIL[DOC-CONTEXT module="webhook-registry" layer="shared" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/src/pages/admin/RolesPage.tsx\",\".framework/src/components/ui/dialog.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="adminDb, handlerCache" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Import database and initialize Map for handler metadata caching" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[BEGIN stable_id="~/.framework/functions/_shared/webhook-registry.ts:HandlerCacheEntry:interface" type="interface" identity="HandlerCacheEntry" parent="~/.framework/functions/_shared/webhook-registry.ts"]
+// CIL[DOC-MACRO purpose="Type definition for a cached webhook handler entry"]
+// CIL[DOC-RESPONSIBILITY responsibility="Describe the shape of an in-memory cached handler record"]
+// CIL[DOC-CONTEXT module="webhook-registry" layer="functions" related_files=".framework/functions/_shared/db.ts,.framework/functions/_shared/webhook-registry.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Declares functionName and loaded boolean fields" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" 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/portal/pages/ContentPage.tsx, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .framework/src/pages/admin/RolesPage.tsx, .framework/src/components/ui/dialog.tsx, \."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
-// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
-// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
-import { adminDb } from './db'
 
 interface HandlerCacheEntry {
   functionName: string
   loaded: boolean
 }
+// CIL[DOC-VECTOR type="context" content="purpose='Type definition for a cached webhook handler entry'; 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/webhook-registry.ts:HandlerCacheEntry:interface"]
 
-const handlerCache = new Map<string, HandlerCacheEntry>()
-// CIL[END chunk_id="webhookregistry_imports_1784020784"]
-// CIL[BEGIN chunk_id="webhookregistry_lookuphandler_1784020784" type="function" identity="lookupHandler" parent="none"]
-// CIL[DOC-MACRO purpose="Lookup webhook handler metadata with caching"]
-// CIL[DOC-RESPONSIBILITY responsibility="Find handler function name in database with cache optimization"]
-// CIL[DOC-CONTEXT module="webhook-registry" layer="shared" related_files="[\".framework/functions/_shared/schema-utils.ts\",\".framework/src/pages/admin/IntegrationsPage.tsx\",\".framework/src/components/ui/dialog.tsx\",\".framework/functions/_shared/principal.ts\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="function name or null" errors="database errors" side_effects="cache update"]
-// CIL[DOC-MICRO logic_summary="Checks cache first, queries webhook_handlers table, caches result" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+
+
+// CIL[BEGIN stable_id="~/.framework/functions/_shared/webhook-registry.ts:handlerCache:constant" type="constant" identity="handlerCache" parent="~/.framework/functions/_shared/webhook-registry.ts"]
+// CIL[DOC-MACRO purpose="In-memory cache of resolved webhook handler metadata"]
+// CIL[DOC-RESPONSIBILITY responsibility="Store loaded handler lookups to avoid repeated DB queries"]
+// CIL[DOC-CONTEXT module="webhook-registry" layer="functions" related_files=".framework/functions/_shared/db.ts,.framework/functions/_shared/webhook-registry.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="Mutates when lookups or cache clears occur"]
+// CIL[DOC-MICRO logic_summary="Map keyed by appId, accountId, and handlerName" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" 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/pages/admin/IntegrationsPage.tsx, .framework/src/components/ui/dialog.tsx, .framework/functions/_shared/principal.ts, .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."]
+
+const handlerCache = new Map<string, HandlerCacheEntry>()
+// CIL[DOC-VECTOR type="context" content="purpose='In-memory cache of resolved webhook handler metadata'; 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/webhook-registry.ts:handlerCache:constant"]
+
+
+// CIL[BEGIN stable_id="~/.framework/functions/_shared/webhook-registry.ts:lookupHandler:function" type="function" identity="lookupHandler" parent="~/.framework/functions/_shared/webhook-registry.ts"]
+// CIL[DOC-MACRO purpose="Look up a webhook handler by name and optional scope, with fallback to global handlers"]
+// CIL[DOC-RESPONSIBILITY responsibility="Resolve the serverless function name for a given webhook handler"]
+// CIL[DOC-CONTEXT module="webhook-registry" layer="functions" related_files=".framework/functions/_shared/db.ts,.framework/functions/_shared/webhook-registry.ts"]
+// CIL[DOC-CONTRACT inputs="handlerName: string, appId: string | null | undefined, accountId: string | null | undefined" outputs="{ functionName: string } | null" errors="Returns null when not found; logs console warnings" side_effects="Writes matching entries to handlerCache"]
+// CIL[DOC-MICRO logic_summary="Builds a cache key, checks the cache, queries webhook_handlers with optional app and account filters, falls back to a null-scoped handler, and caches the result" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+
 export async function lookupHandler(
   handlerName: string,
   appId?: string | null,
@@ -52,6 +80,7 @@ export async function lookupHandler(
     return { functionName: cached.functionName }
   }
 
+
   let query = adminDb
     .from('webhook_handlers')
     .select('name, function_name, is_active, is_deleted')
@@ -100,21 +129,23 @@ export async function lookupHandler(
 
   return { functionName: data.function_name }
 }
-// CIL[END chunk_id="webhookregistry_lookuphandler_1784020784"]
-// CIL[BEGIN chunk_id="webhookregistry_loadhandler_1784020784" type="function" identity="loadHandler" parent="none"]
-// CIL[DOC-MACRO purpose="Dynamically load webhook handler function from module"]
-// CIL[DOC-RESPONSIBILITY responsibility="Import and validate handler function from file system"]
-// CIL[DOC-CONTEXT module="webhook-registry" layer="shared" related_files="[\"custom/apps/cortex/functions/custom_cil-embeddings.ts\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/functions/_shared/principal.ts\",\".framework/migrations/025_retype_threads_messages.sql\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="Function or null" errors="import errors" side_effects="module loading"]
-// CIL[DOC-MICRO logic_summary="Dynamic import with handler/default export validation" 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: custom/apps/cortex/functions/custom_cil-embeddings.ts, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .framework/functions/_shared/principal.ts, .framework/migrations/025_retype_threads_messages.sql, \."]
-// 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='Look up a webhook handler by name and optional scope, with fallback to global handlers'; 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/webhook-registry.ts:lookupHandler:function"]
+
+// CIL[BEGIN stable_id="~/.framework/functions/_shared/webhook-registry.ts:loadHandler:function" type="function" identity="loadHandler" parent="~/.framework/functions/_shared/webhook-registry.ts"]
+// CIL[DOC-MACRO purpose="Dynamically import and extract a handler function by module name"]
+// CIL[DOC-RESPONSIBILITY responsibility="Load the configured serverless function at runtime"]
+// CIL[DOC-CONTEXT module="webhook-registry" layer="functions" related_files=".framework/functions/_shared/db.ts,.framework/functions/_shared/webhook-registry.ts"]
+// CIL[DOC-CONTRACT inputs="functionName: string" outputs="Function | null" errors="Returns null if export missing or dynamic import fails; logs console errors" side_effects="None beyond module import"]
+// CIL[DOC-MICRO logic_summary="Chooses a relative import prefix based on custom/ prefix, awaits the module, and returns the first available adapt, handler, or default export" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+
 export async function loadHandler(functionName: string): Promise<Function | null> {
   try {
     const prefix = functionName.startsWith('custom/') ? '../../../' : '../'
@@ -133,21 +164,23 @@ export async function loadHandler(functionName: string): Promise<Function | null
     return null
   }
 }
-// CIL[END chunk_id="webhookregistry_loadhandler_1784020784"]
-// CIL[BEGIN chunk_id="webhookregistry_resolvehandler_1784020784" type="function" identity="resolveHandler" parent="none"]
-// CIL[DOC-MACRO purpose="Resolve webhook handler function by name"]
-// CIL[DOC-RESPONSIBILITY responsibility="Combine lookup and loading for complete handler resolution"]
-// CIL[DOC-CONTEXT module="webhook-registry" layer="shared" related_files="[\"custom/apps/cortex/functions/custom_cil-embeddings.ts\",\".framework/functions/_shared/principal.ts\",\".framework/migrations/025_retype_threads_messages.sql\",\".framework/functions/_shared/schema-utils.ts\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="Function or null" errors="lookup/load errors" side_effects="cache update"]
-// CIL[DOC-MICRO logic_summary="Looks up metadata then loads and returns handler function" 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: custom/apps/cortex/functions/custom_cil-embeddings.ts, .framework/functions/_shared/principal.ts, .framework/migrations/025_retype_threads_messages.sql, .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='Dynamically import and extract a handler function by module name'; 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/webhook-registry.ts:loadHandler:function"]
+
+// CIL[BEGIN stable_id="~/.framework/functions/_shared/webhook-registry.ts:resolveHandler:function" type="function" identity="resolveHandler" parent="~/.framework/functions/_shared/webhook-registry.ts"]
+// CIL[DOC-MACRO purpose="Resolve and load a handler in one call"]
+// CIL[DOC-RESPONSIBILITY responsibility="Combine lookup and load for a given webhook handler name"]
+// CIL[DOC-CONTEXT module="webhook-registry" layer="functions" related_files=".framework/functions/_shared/db.ts,.framework/functions/_shared/webhook-registry.ts"]
+// CIL[DOC-CONTRACT inputs="handlerName: string, appId?: string | null, accountId?: string | null" outputs="Function | null" errors="Returns null when lookup or load fails" side_effects="May populate handlerCache via lookupHandler"]
+// CIL[DOC-MICRO logic_summary="Calls lookupHandler then loadHandler and returns the loaded function" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+
 export async function resolveHandler(
   handlerName: string,
   appId?: string | null,
@@ -158,39 +191,43 @@ export async function resolveHandler(
 
   return loadHandler(metadata.functionName)
 }
-// CIL[END chunk_id="webhookregistry_resolvehandler_1784020784"]
-// CIL[BEGIN chunk_id="webhookregistry_clearhandlercache_1784020784" type="function" identity="clearHandlerCache" parent="none"]
-// CIL[DOC-MACRO purpose="Clear webhook handler cache"]
-// CIL[DOC-RESPONSIBILITY responsibility="Reset handler metadata cache for fresh lookups"]
-// CIL[DOC-CONTEXT module="webhook-registry" layer="shared" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="void" errors="none" side_effects="cache cleared"]
-// CIL[DOC-MICRO logic_summary="Clears Map cache to force fresh database queries" 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='Resolve and load a handler in one call'; 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/webhook-registry.ts:resolveHandler:function"]
+
+// CIL[BEGIN stable_id="~/.framework/functions/_shared/webhook-registry.ts:clearHandlerCache:function" type="function" identity="clearHandlerCache" parent="~/.framework/functions/_shared/webhook-registry.ts"]
+// CIL[DOC-MACRO purpose="Clear the in-memory handler cache"]
+// CIL[DOC-RESPONSIBILITY responsibility="Allow callers to invalidate cached webhook handler metadata"]
+// CIL[DOC-CONTEXT module="webhook-registry" layer="functions" related_files=".framework/functions/_shared/db.ts,.framework/functions/_shared/webhook-registry.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="void" errors="none" side_effects="Empties the handlerCache map"]
+// CIL[DOC-MICRO logic_summary="Calls Map.clear on the handler cache" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+
 export function clearHandlerCache(): void {
   handlerCache.clear()
 }
-// CIL[END chunk_id="webhookregistry_clearhandlercache_1784020784"]
-// CIL[BEGIN chunk_id="webhookregistry_listregisteredhandlers_1784020784" type="function" identity="listRegisteredHandlers" parent="none"]
-// CIL[DOC-MACRO purpose="List all registered webhook handlers"]
-// CIL[DOC-RESPONSIBILITY responsibility="Retrieve names of all active webhook handlers"]
-// CIL[DOC-CONTEXT module="webhook-registry" layer="shared" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="string array" errors="database errors" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Queries webhook_handlers table and returns active handler names" 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='Clear the in-memory handler cache'; 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/webhook-registry.ts:clearHandlerCache:function"]
+
+// CIL[BEGIN stable_id="~/.framework/functions/_shared/webhook-registry.ts:listRegisteredHandlers:function" type="function" identity="listRegisteredHandlers" parent="~/.framework/functions/_shared/webhook-registry.ts"]
+// CIL[DOC-MACRO purpose="List active webhook handler names from the database"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide a roster of available, active handlers"]
+// CIL[DOC-CONTEXT module="webhook-registry" layer="functions" related_files=".framework/functions/_shared/db.ts,.framework/functions/_shared/webhook-registry.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="string[]" errors="Returns empty array and logs error on DB failure" side_effects="None"]
+// CIL[DOC-MICRO logic_summary="Queries webhook_handlers for active names and returns an array of name values" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+
 export async function listRegisteredHandlers(): Promise<string[]> {
   const { data, error } = await adminDb
     .from('webhook_handlers')
@@ -204,4 +241,10 @@ export async function listRegisteredHandlers(): Promise<string[]> {
 
   return data?.map(h => h.name) || []
 }
-// CIL[END chunk_id="webhookregistry_listregisteredhandlers_1784020784"]
+// CIL[DOC-VECTOR type="context" content="purpose='List active webhook handler names from the database'; 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/webhook-registry.ts:listRegisteredHandlers:function"]

package/.framework/functions/account-nodes.ts

@@ -1,38 +1,32 @@
-
-// CIL[BEGIN chunk_id="account-nodes_module_header_1784019432" type="module_header" identity="imports" parent="none"]
-// CIL[DOC-MACRO purpose="Import dependencies for account hierarchy traversal"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide middleware for request handling"]
-// CIL[DOC-CONTEXT module="account-nodes" 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 required modules for account node operations" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[BEGIN stable_id="~/.framework/functions/account-nodes.ts:module_header:module_header" type="module_header" identity="module_header" parent="~/.framework/functions/account-nodes.ts"]
+// CIL[DOC-MACRO purpose="Netlify function entry point for account node retrieval and traversal"]
+// CIL[DOC-RESPONSIBILITY responsibility="Expose the handler that loads an account node with its ancestors, children, and descendants"]
+// CIL[DOC-CONTEXT module="account-nodes" layer="edge-function" related_files=".framework/functions/_shared/middleware.ts"]
+// CIL[DOC-CONTRACT inputs="ctx: RequestContext, body: unknown" outputs="{ node, ancestors, children, descendants }" errors="Missing node_id, account not found, database errors" side_effects="Queries accounts table and calls get_account_ancestors/get_account_descendants RPCs"]
+// CIL[DOC-MICRO logic_summary="Wraps createHandler to read node_id, validate presence, fetch the active account with its type, then retrieve ancestors, children, and descendants" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" 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"]
+// CIL[DOC-AUDIENCE audience="api consumer"]
+
 import { createHandler } from './_shared/middleware'
-// CIL[END chunk_id="account-nodes_module_header_1784019432"]
-// CIL[BEGIN chunk_id="account-nodes_handler_1784019432" type="function" identity="handler" parent="none"]
-// CIL[DOC-MACRO purpose="Return account node with ancestors, children, and descendants"]
-// CIL[DOC-RESPONSIBILITY responsibility="Fetch complete account hierarchy for a given node"]
-// CIL[DOC-CONTEXT module="account-nodes" layer="api-handler" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\"custom/apps/cortex/functions/custom_cil-embeddings.ts\",\".framework/src/components/ui/dialog.tsx\",\".framework/functions/_shared/principal.ts\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="{node,ancestors,children,descendants}" errors="node_id_required,node_not_found" side_effects="database_queries,rpc_calls"]
-// CIL[DOC-MICRO logic_summary="Queries target node, uses RPC for ancestors/descendants, fetches direct children" 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/portal/pages/ContentPage.tsx, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, custom/apps/cortex/functions/custom_cil-embeddings.ts, .framework/src/components/ui/dialog.tsx, .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='Netlify function entry point for account node retrieval and traversal'; 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/account-nodes.ts:module_header:module_header"]
+// CIL[BEGIN stable_id="~/.framework/functions/account-nodes.ts:handler:constant" type="constant" identity="handler" parent="~/.framework/functions/account-nodes.ts"]
+// CIL[DOC-MACRO purpose="Load a single account node and related tree"]
+// CIL[DOC-RESPONSIBILITY responsibility="Fetch an active account by id plus ancestors, children, and descendants"]
+// CIL[DOC-CONTEXT module="account-nodes" layer="edge-function" related_files=".framework/functions/_shared/middleware.ts,.framework/functions/account-nodes.ts"]
+// CIL[DOC-CONTRACT inputs="node_id: string" outputs="{ node, ancestors: Account[], children: Account[], descendants: Account[] }" errors="Account node not found, database RPC errors" side_effects="Queries accounts table and calls get_account_ancestors and get_account_descendants RPCs"]
+// CIL[DOC-MICRO logic_summary="Validate node_id, fetch account, get ancestors, children, and descendants from database; return all four collections" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export const handler = createHandler(async (ctx, body) => {
   const { node_id } = ctx.query || {}
-  
+
   if (!node_id) {
     throw new Error('node_id is required')
   }
@@ -86,4 +80,10 @@ export const handler = createHandler(async (ctx, body) => {
     descendants: descendants || []
   }
 })
-// CIL[END chunk_id="account-nodes_handler_1784019432"]
+// CIL[DOC-VECTOR type="context" content="purpose='Load a single account node and related tree'; 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/account-nodes.ts:handler:constant"]