spine-framework 0.3.145 → 0.4.0

package/.framework/functions/_shared/resolve-ids.ts

@@ -1,48 +1,83 @@
+// CIL[BEGIN stable_id="~/.framework/functions/_shared/resolve-ids.ts:module_header:module_header" type="module_header" identity="module_header" parent="~/.framework/functions/_shared/resolve-ids.ts"]
+// CIL[DOC-MACRO purpose="Shared id resolution helpers for types, link types, accounts, agents and prompt configs."]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide reusable functions that map slugs and (kind, slug) pairs to primary keys for Spine entities."]
+// CIL[DOC-CONTEXT module="functions/_shared" layer="shared" related_files=".framework/functions/_shared/db.ts"]
+// CIL[DOC-CONTRACT inputs="N/A" outputs="N/A" errors="N/A" side_effects="N/A"]
+// CIL[DOC-MICRO logic_summary="Module header for resolve-ids.ts; contains the import and no runtime logic." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-AUDIENCE audience="developers"]
 
+import { adminDb } from './db'
 
+// Design-time resolution caches. `types`/`accounts` rows change only on app
+// install or schema edits — a 60s TTL bounds staleness the same way the
+// principal and app-config caches do. Entries are keyed before any DB call so
+// concurrent resolvers share one query (promise memoization).
+const RESOLVE_CACHE_TTL_MS = 60_000
+const RESOLVE_CACHE_MAX = 500
 
+type CacheSlot<T> = { value: Promise<T>; expiresAt: number }
 
+function makeResolveCache<T>() {
+  const map = new Map<string, CacheSlot<T>>()
+  return {
+    get(key: string): Promise<T> | undefined {
+      const slot = map.get(key)
+      if (!slot) return undefined
+      if (slot.expiresAt < Date.now()) { map.delete(key); return undefined }
+      return slot.value
+    },
+    set(key: string, value: Promise<T>) {
+      if (map.size >= RESOLVE_CACHE_MAX) {
+        const oldest = map.keys().next().value
+        if (oldest !== undefined) map.delete(oldest)
+      }
+      map.set(key, { value, expiresAt: Date.now() + RESOLVE_CACHE_TTL_MS })
+      // Failed lookups must not be cached — a type installed mid-TTL would
+      // otherwise stay invisible. Evict rejections immediately.
+      value.catch(() => map.delete(key))
+    },
+  }
+}
 
-
-
-
-
-// CIL[BEGIN chunk_id="resolveids_imports_1784020784" type="module_header" identity="imports" parent="none"]
-// CIL[DOC-MACRO purpose="Import database dependency for ID resolution"]
-// CIL[DOC-RESPONSIBILITY responsibility="Import adminDb for database queries"]
-// CIL[DOC-CONTEXT module="resolve-ids" layer="shared" related_files="[\".framework/functions/_shared/schema-utils.ts\",\".framework/src/components/layout/Sidebar.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/migrations/025_retype_threads_messages.sql\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="adminDb" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Import database connection for ID resolution utilities" 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: .framework/functions/_shared/schema-utils.ts, .framework/src/components/layout/Sidebar.tsx, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .framework/migrations/025_retype_threads_messages.sql, .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 typeIdCache = makeResolveCache<Record<string, string>>()
+const typeRecordCache = makeResolveCache<TypeRecord>()
+const accountIdCache = makeResolveCache<string>()
+// CIL[DOC-VECTOR type="context" content="purpose='Shared id resolution helpers for types, link types, accounts, agents and prompt configs.'; 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="resolveids_imports_1784020784"]
-// CIL[BEGIN chunk_id="resolveids_resolvetypeids_1784020784" type="function" identity="resolveTypeIds" parent="none"]
-// CIL[DOC-MACRO purpose="Resolve multiple type IDs by kind and slug"]
-// CIL[DOC-RESPONSIBILITY responsibility="Batch resolve type identifiers from database"]
-// CIL[DOC-CONTEXT module="resolve-ids" layer="shared" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/migrations/025_retype_threads_messages.sql\",\".framework/src/pages/admin/RolesPage.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="Record<string, string>" errors="type not found" side_effects="database query"]
-// CIL[DOC-MICRO logic_summary="Batch queries types table, validates all requested types exist" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[END stable_id="~/.framework/functions/_shared/resolve-ids.ts:module_header:module_header"]
+
+// CIL[BEGIN stable_id="~/.framework/functions/_shared/resolve-ids.ts:resolveTypeIds:function" type="function" identity="resolveTypeIds" parent="~/.framework/functions/_shared/resolve-ids.ts"]
+// CIL[DOC-MACRO purpose="Resolve many (kind, slug) pairs to their type primary keys."]
+// CIL[DOC-RESPONSIBILITY responsibility="Query the types table in batches and validate that every requested pair has a matching row."]
+// CIL[DOC-CONTEXT module="functions/_shared" layer="shared" related_files=".framework/functions/_shared/db.ts,.framework/functions/_shared/resolve-ids.ts"]
+// CIL[DOC-CONTRACT inputs="pairs: Array<{ kind: string; slug: string }>" outputs="Record<string, string> mapping kind/slug to id" errors="Throws if any type is not found" side_effects="None"]
+// CIL[DOC-MICRO logic_summary="Builds slug and kind lists, queries types via adminDb, returns a record keyed by kind/slug, then verifies all requested pairs exist." 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: custom/apps/portal/pages/ContentPage.tsx, .framework/src/pages/admin/TypeDetailPage.tsx, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .framework/migrations/025_retype_threads_messages.sql, .framework/src/pages/admin/RolesPage.tsx, \."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
-// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
-// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 export async function resolveTypeIds(
   pairs: Array<{ kind: string; slug: string }>
 ): Promise<Record<string, string>> {
   if (pairs.length === 0) return {}
 
+  // Batch-level memoization: an episode resolving the same pair set (e.g.
+  // every save_message → createRecord → type lookup) shares one query.
+  const cacheKey = pairs.map(p => `${p.kind}/${p.slug}`).sort().join('|')
+  const hit = typeIdCache.get(cacheKey)
+  if (hit) return hit
+  const pending = resolveTypeIdsUncached(pairs)
+  typeIdCache.set(cacheKey, pending)
+  return pending
+}
+
+async function resolveTypeIdsUncached(
+  pairs: Array<{ kind: string; slug: string }>
+): Promise<Record<string, string>> {
   const { data, error } = await adminDb
     .from('types')
     .select('id, kind, slug')
@@ -64,40 +99,42 @@ export async function resolveTypeIds(
 
   return result
 }
-// CIL[END chunk_id="resolveids_resolvetypeids_1784020784"]
-// CIL[BEGIN chunk_id="resolveids_resolvetypeid_1784020784" type="function" identity="resolveTypeId" parent="none"]
-// CIL[DOC-MACRO purpose="Resolve single type ID by kind and slug"]
-// CIL[DOC-RESPONSIBILITY responsibility="Get type identifier from kind and slug"]
-// CIL[DOC-CONTEXT module="resolve-ids" layer="shared" related_files="[\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/migrations/025_retype_threads_messages.sql\",\".framework/functions/_shared/schema-utils.ts\",\"custom/apps/portal/pages/ContentPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="type ID" errors="type not found" side_effects="database query"]
-// CIL[DOC-MICRO logic_summary="Convenience wrapper around resolveTypeIds for single type" 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: 15. Direct calls: 0. Related files: .framework/src/pages/admin/TypeDetailPage.tsx, .framework/migrations/025_retype_threads_messages.sql, .framework/functions/_shared/schema-utils.ts, custom/apps/portal/pages/ContentPage.tsx, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, \."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 15. Total affected: 15."]
-// 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 many (kind, slug) pairs to their type primary keys.'; 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/resolve-ids.ts:resolveTypeIds:function"]
+
+// CIL[BEGIN stable_id="~/.framework/functions/_shared/resolve-ids.ts:resolveTypeId:function" type="function" identity="resolveTypeId" parent="~/.framework/functions/_shared/resolve-ids.ts"]
+// CIL[DOC-MACRO purpose="Resolve a single (kind, slug) pair to its type primary key."]
+// CIL[DOC-RESPONSIBILITY responsibility="Call resolveTypeIds for one pair and return the matching id."]
+// CIL[DOC-CONTEXT module="functions/_shared" layer="shared" related_files=".framework/functions/_shared/db.ts,.framework/functions/_shared/resolve-ids.ts"]
+// CIL[DOC-CONTRACT inputs="kind: string, slug: string" outputs="string id" errors="Throws if type not found" side_effects="None"]
+// CIL[DOC-MICRO logic_summary="Delegates to resolveTypeIds([{ kind, slug }]) and returns the single key." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export async function resolveTypeId(kind: string, slug: string): Promise<string> {
   const ids = await resolveTypeIds([{ kind, slug }])
   return ids[`${kind}/${slug}`]
 }
-// CIL[END chunk_id="resolveids_resolvetypeid_1784020784"]
-// CIL[BEGIN chunk_id="resolveids_typerecord_1784020784" type="interface" identity="TypeRecord" parent="none"]
-// CIL[DOC-MACRO purpose="Define type record interface with schemas"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide structure for type with design and validation schemas"]
-// CIL[DOC-CONTEXT module="resolve-ids" layer="shared" related_files="[\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/functions/_shared/schema-utils.ts\",\".framework/src/components/layout/Sidebar.tsx\",\".framework/migrations/025_retype_threads_messages.sql\",\".framework/src/pages/admin/IntegrationsPage.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="TypeRecord interface" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Interface containing type metadata and schemas" 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/src/pages/admin/TypeDetailPage.tsx, .framework/functions/_shared/schema-utils.ts, .framework/src/components/layout/Sidebar.tsx, .framework/migrations/025_retype_threads_messages.sql, .framework/src/pages/admin/IntegrationsPage.tsx, \."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="context" content="purpose='Resolve a single (kind, slug) pair to its type primary key.'; 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/resolve-ids.ts:resolveTypeId:function"]
+
+// CIL[BEGIN stable_id="~/.framework/functions/_shared/resolve-ids.ts:TypeRecord:interface" type="interface" identity="TypeRecord" parent="~/.framework/functions/_shared/resolve-ids.ts"]
+// CIL[DOC-MACRO purpose="Describe the shape of a type record from the types table."]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide a TypeScript type for type rows including schemas and active status."]
+// CIL[DOC-CONTEXT module="functions/_shared" layer="shared" related_files=".framework/functions/_shared/db.ts,.framework/functions/_shared/resolve-ids.ts"]
+// CIL[DOC-CONTRACT inputs="N/A" outputs="N/A" errors="N/A" side_effects="N/A"]
+// CIL[DOC-MICRO logic_summary="Defines id, slug, kind, design_schema, validation_schema and is_active fields." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export interface TypeRecord {
   id: string
   slug: string
@@ -106,24 +143,32 @@ export interface TypeRecord {
   validation_schema: Record<string, any>
   is_active: boolean
 }
-// CIL[END chunk_id="resolveids_typerecord_1784020784"]
-// CIL[BEGIN chunk_id="resolveids_resolvetyperecord_1784020784" type="function" identity="resolveTypeRecord" parent="none"]
-// CIL[DOC-LEARNING topic="runtime-type:generic/type_resolution" content="resolveTypeRecord fetches a type row by kind and slug or by id, returning the full design_schema and validation_schema. It is used by admin-data create and pipeline.ts to stamp new records."]
-// CIL[DOC-NOTE type="design_schema_caveat" content="If the type slug is not found or is inactive, record creation fails with a 400 error. Always seed types before creating records."]
-// CIL[DOC-MACRO purpose="Resolve complete type record with schemas"]
-// CIL[DOC-RESPONSIBILITY responsibility="Get type metadata and validation schemas"]
-// CIL[DOC-CONTEXT module="resolve-ids" layer="shared" related_files="[\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/migrations/025_retype_threads_messages.sql\",\".framework/functions/_shared/schema-utils.ts\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/src/pages/admin/IntegrationsPage.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="TypeRecord" errors="type not found/inactive" side_effects="database query"]
-// CIL[DOC-MICRO logic_summary="Queries types table, validates active status, returns full record" 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/src/pages/admin/TypeDetailPage.tsx, .framework/migrations/025_retype_threads_messages.sql, .framework/functions/_shared/schema-utils.ts, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .framework/src/pages/admin/IntegrationsPage.tsx, \."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="context" content="purpose='Describe the shape of a type record from the types table.'; 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/resolve-ids.ts:TypeRecord:interface"]
+
+// CIL[BEGIN stable_id="~/.framework/functions/_shared/resolve-ids.ts:resolveTypeRecord:function" type="function" identity="resolveTypeRecord" parent="~/.framework/functions/_shared/resolve-ids.ts"]
+// CIL[DOC-MACRO purpose="Fetch a full type record by kind and slug."]
+// CIL[DOC-RESPONSIBILITY responsibility="Return a single TypeRecord after verifying it is active."]
+// CIL[DOC-CONTEXT module="functions/_shared" layer="shared" related_files=".framework/functions/_shared/db.ts,.framework/functions/_shared/resolve-ids.ts"]
+// CIL[DOC-CONTRACT inputs="kind: string, slug: string" outputs="TypeRecord" errors="Throws if type not found or inactive" side_effects="None"]
+// CIL[DOC-MICRO logic_summary="Queries types with .single() and returns an object with schema fallbacks." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export async function resolveTypeRecord(kind: string, slug: string): Promise<TypeRecord> {
+  const cacheKey = `${kind}/${slug}`
+  const hit = typeRecordCache.get(cacheKey)
+  if (hit) return hit
+  const pending = resolveTypeRecordUncached(kind, slug)
+  typeRecordCache.set(cacheKey, pending)
+  return pending
+}
+
+async function resolveTypeRecordUncached(kind: string, slug: string): Promise<TypeRecord> {
   const { data, error } = await adminDb
     .from('types')
     .select('id, slug, kind, design_schema, validation_schema, is_active')
@@ -143,21 +188,22 @@ export async function resolveTypeRecord(kind: string, slug: string): Promise<Typ
     is_active: data.is_active,
   }
 }
-// CIL[END chunk_id="resolveids_resolvetyperecord_1784020784"]
-// CIL[BEGIN chunk_id="resolveids_resolvelinktypeids_1784020784" type="function" identity="resolveLinkTypeIds" parent="none"]
-// CIL[DOC-MACRO purpose="Resolve multiple link type IDs by slug"]
-// CIL[DOC-RESPONSIBILITY responsibility="Batch resolve link type identifiers from database"]
-// CIL[DOC-CONTEXT module="resolve-ids" layer="shared" related_files="[\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/migrations/025_retype_threads_messages.sql\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/functions/_shared/schema-utils.ts\",\"custom/apps/cortex/functions/custom_cil-embeddings.ts\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="Record<string, string>" errors="link type not found" side_effects="database query"]
-// CIL[DOC-MICRO logic_summary="Batch queries link_types table, validates all requested types exist" 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/src/pages/admin/TypeDetailPage.tsx, .framework/migrations/025_retype_threads_messages.sql, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .framework/functions/_shared/schema-utils.ts, 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='Fetch a full type record by kind and slug.'; 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/resolve-ids.ts:resolveTypeRecord:function"]
+
+// CIL[BEGIN stable_id="~/.framework/functions/_shared/resolve-ids.ts:resolveLinkTypeIds:function" type="function" identity="resolveLinkTypeIds" parent="~/.framework/functions/_shared/resolve-ids.ts"]
+// CIL[DOC-MACRO purpose="Resolve many link type slugs to their primary keys."]
+// CIL[DOC-RESPONSIBILITY responsibility="Query the link_types table in a batch and confirm all slugs are resolved."]
+// CIL[DOC-CONTEXT module="functions/_shared" layer="shared" related_files=".framework/functions/_shared/db.ts,.framework/functions/_shared/resolve-ids.ts"]
+// CIL[DOC-CONTRACT inputs="slugs: string[]" outputs="Record<string, string> mapping slug to id" errors="Throws if any link type is not found" side_effects="None"]
+// CIL[DOC-MICRO logic_summary="Queries link_types by slug list, builds a record, and validates every input slug is present." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export async function resolveLinkTypeIds(slugs: string[]): Promise<Record<string, string>> {
   if (slugs.length === 0) return {}
 
@@ -179,41 +225,51 @@ export async function resolveLinkTypeIds(slugs: string[]): Promise<Record<string
 
   return result
 }
-// CIL[END chunk_id="resolveids_resolvelinktypeids_1784020784"]
-// CIL[BEGIN chunk_id="resolveids_resolvelinktypeid_1784020784" type="function" identity="resolveLinkTypeId" parent="none"]
-// CIL[DOC-MACRO purpose="Resolve single link type ID by slug"]
-// CIL[DOC-RESPONSIBILITY responsibility="Get link type identifier from slug"]
-// CIL[DOC-CONTEXT module="resolve-ids" layer="shared" related_files="[\".framework/migrations/025_retype_threads_messages.sql\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/functions/_shared/schema-utils.ts\",\".framework/src/components/layout/Sidebar.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="link type ID" errors="link type not found" side_effects="database query"]
-// CIL[DOC-MICRO logic_summary="Convenience wrapper around resolveLinkTypeIds for single type" 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/025_retype_threads_messages.sql, .framework/src/pages/admin/TypeDetailPage.tsx, .framework/functions/_shared/schema-utils.ts, .framework/src/components/layout/Sidebar.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='Resolve many link type slugs to their primary keys.'; 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/resolve-ids.ts:resolveLinkTypeIds:function"]
+
+// CIL[BEGIN stable_id="~/.framework/functions/_shared/resolve-ids.ts:resolveLinkTypeId:function" type="function" identity="resolveLinkTypeId" parent="~/.framework/functions/_shared/resolve-ids.ts"]
+// CIL[DOC-MACRO purpose="Resolve a single link type slug to its primary key."]
+// CIL[DOC-RESPONSIBILITY responsibility="Call resolveLinkTypeIds for one slug and return the id."]
+// CIL[DOC-CONTEXT module="functions/_shared" layer="shared" related_files=".framework/functions/_shared/db.ts,.framework/functions/_shared/resolve-ids.ts"]
+// CIL[DOC-CONTRACT inputs="slug: string" outputs="string id" errors="Throws if link type not found" side_effects="None"]
+// CIL[DOC-MICRO logic_summary="Delegates to resolveLinkTypeIds([slug]) and returns ids[slug]." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export async function resolveLinkTypeId(slug: string): Promise<string> {
   const ids = await resolveLinkTypeIds([slug])
   return ids[slug]
 }
-// CIL[END chunk_id="resolveids_resolvelinktypeid_1784020784"]
-// CIL[BEGIN chunk_id="resolveids_resolveaccountid_1784020784" type="function" identity="resolveAccountId" parent="none"]
-// CIL[DOC-MACRO purpose="Resolve account ID by slug"]
-// CIL[DOC-RESPONSIBILITY responsibility="Get account identifier from slug"]
-// CIL[DOC-CONTEXT module="resolve-ids" layer="shared" related_files="[\".framework/functions/_shared/schema-utils.ts\",\".framework/src/components/layout/Sidebar.tsx\",\".framework/migrations/025_retype_threads_messages.sql\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="account ID" errors="account not found" side_effects="database query"]
-// CIL[DOC-MICRO logic_summary="Queries accounts table by slug to get 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/src/components/layout/Sidebar.tsx, .framework/migrations/025_retype_threads_messages.sql, .framework/src/pages/admin/TypeDetailPage.tsx, \."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="context" content="purpose='Resolve a single link type slug to its primary key.'; 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/resolve-ids.ts:resolveLinkTypeId:function"]
+
+// CIL[BEGIN stable_id="~/.framework/functions/_shared/resolve-ids.ts:resolveAccountId:function" type="function" identity="resolveAccountId" parent="~/.framework/functions/_shared/resolve-ids.ts"]
+// CIL[DOC-MACRO purpose="Resolve an account slug to its primary key."]
+// CIL[DOC-RESPONSIBILITY responsibility="Query accounts table by slug and return the id."]
+// CIL[DOC-CONTEXT module="functions/_shared" layer="shared" related_files=".framework/functions/_shared/db.ts,.framework/functions/_shared/resolve-ids.ts"]
+// CIL[DOC-CONTRACT inputs="slug: string" outputs="string id" errors="Throws if account not found" side_effects="None"]
+// CIL[DOC-MICRO logic_summary="Queries accounts selecting id, applies .single(), and throws on missing data." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export async function resolveAccountId(slug: string): Promise<string> {
+  const hit = accountIdCache.get(slug)
+  if (hit) return hit
+  const pending = resolveAccountIdUncached(slug)
+  accountIdCache.set(slug, pending)
+  return pending
+}
+
+async function resolveAccountIdUncached(slug: string): Promise<string> {
   const { data, error } = await adminDb
     .from('accounts')
     .select('id')
@@ -223,21 +279,22 @@ export async function resolveAccountId(slug: string): Promise<string> {
   if (error || !data) throw new Error(`Account not found: ${slug}`)
   return data.id
 }
-// CIL[END chunk_id="resolveids_resolveaccountid_1784020784"]
-// CIL[BEGIN chunk_id="resolveids_resolveagentid_1784020784" type="function" identity="resolveAgentId" parent="none"]
-// CIL[DOC-MACRO purpose="Resolve AI agent ID by name"]
-// CIL[DOC-RESPONSIBILITY responsibility="Get active AI agent identifier from name"]
-// CIL[DOC-CONTEXT module="resolve-ids" layer="shared" related_files="[\".framework/functions/_shared/schema-utils.ts\",\".framework/src/components/layout/Sidebar.tsx\",\".framework/migrations/025_retype_threads_messages.sql\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="agent ID" errors="agent not found" side_effects="database query"]
-// CIL[DOC-MICRO logic_summary="Queries ai_agents table by name and active 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/schema-utils.ts, .framework/src/components/layout/Sidebar.tsx, .framework/migrations/025_retype_threads_messages.sql, .framework/src/pages/admin/TypeDetailPage.tsx, \."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="context" content="purpose='Resolve an account slug to its primary key.'; 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/resolve-ids.ts:resolveAccountId:function"]
+
+// CIL[BEGIN stable_id="~/.framework/functions/_shared/resolve-ids.ts:resolveAgentId:function" type="function" identity="resolveAgentId" parent="~/.framework/functions/_shared/resolve-ids.ts"]
+// CIL[DOC-MACRO purpose="Resolve an active AI agent name to its primary key."]
+// CIL[DOC-RESPONSIBILITY responsibility="Query ai_agents table by name and active status and return the id."]
+// CIL[DOC-CONTEXT module="functions/_shared" layer="shared" related_files=".framework/functions/_shared/db.ts,.framework/functions/_shared/resolve-ids.ts"]
+// CIL[DOC-CONTRACT inputs="name: string" outputs="string id" errors="Throws if active AI agent not found" side_effects="None"]
+// CIL[DOC-MICRO logic_summary="Queries ai_agents selecting id, filters is_active true, and throws on missing data." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export async function resolveAgentId(name: string): Promise<string> {
   const { data, error } = await adminDb
     .from('ai_agents')
@@ -249,21 +306,22 @@ export async function resolveAgentId(name: string): Promise<string> {
   if (error || !data) throw new Error(`AI agent not found: ${name}`)
   return data.id
 }
-// CIL[END chunk_id="resolveids_resolveagentid_1784020784"]
-// CIL[BEGIN chunk_id="resolveids_resolvepromptconfigid_1784020784" type="function" identity="resolvePromptConfigId" parent="none"]
-// CIL[DOC-MACRO purpose="Resolve prompt config ID by slug"]
-// CIL[DOC-RESPONSIBILITY responsibility="Get active prompt config identifier from slug"]
-// CIL[DOC-CONTEXT module="resolve-ids" layer="shared" related_files="[\".framework/functions/_shared/schema-utils.ts\",\".framework/src/components/layout/Sidebar.tsx\",\".framework/migrations/025_retype_threads_messages.sql\",\"custom/apps/cortex/functions/custom_cil-embeddings.ts\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="prompt config ID" errors="prompt config not found" side_effects="database query"]
-// CIL[DOC-MICRO logic_summary="Queries prompt_configs table by slug and active 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: 4. Direct calls: 0. Related files: .framework/functions/_shared/schema-utils.ts, .framework/src/components/layout/Sidebar.tsx, .framework/migrations/025_retype_threads_messages.sql, custom/apps/cortex/functions/custom_cil-embeddings.ts, \."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 4. Total affected: 4."]
-// 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 an active AI agent name to its primary key.'; 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/resolve-ids.ts:resolveAgentId:function"]
+
+// CIL[BEGIN stable_id="~/.framework/functions/_shared/resolve-ids.ts:resolvePromptConfigId:function" type="function" identity="resolvePromptConfigId" parent="~/.framework/functions/_shared/resolve-ids.ts"]
+// CIL[DOC-MACRO purpose="Resolve an active prompt config slug to its primary key."]
+// CIL[DOC-RESPONSIBILITY responsibility="Query prompt_configs table by slug and active status and return the id."]
+// CIL[DOC-CONTEXT module="functions/_shared" layer="shared" related_files=".framework/functions/_shared/db.ts,.framework/functions/_shared/resolve-ids.ts"]
+// CIL[DOC-CONTRACT inputs="slug: string" outputs="string id" errors="Throws if active prompt config not found" side_effects="None"]
+// CIL[DOC-MICRO logic_summary="Queries prompt_configs selecting id with active filter and single, throws on missing." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export async function resolvePromptConfigId(slug: string): Promise<string> {
   const { data, error } = await adminDb
     .from('prompt_configs')
@@ -275,4 +333,10 @@ export async function resolvePromptConfigId(slug: string): Promise<string> {
   if (error || !data) throw new Error(`Prompt config not found: ${slug}`)
   return data.id
 }
-// CIL[END chunk_id="resolveids_resolvepromptconfigid_1784020784"]
+// CIL[DOC-VECTOR type="context" content="purpose='Resolve an active prompt config slug to its primary key.'; 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/resolve-ids.ts:resolvePromptConfigId:function"]

package/.framework/functions/_shared/retry-deliveries.ts

@@ -1,22 +1,34 @@
-// CIL[BEGIN chunk_id="retry_deliveries_module_header_1784200007" type="module_header" identity="imports" parent="none"]
-// CIL[DOC-MACRO purpose="Retry pending webhook deliveries from the shared ledger"]
-// CIL[DOC-RESPONSIBILITY responsibility="Poll webhook_deliveries and re-execute due outbound (and eventually inbound) records"]
-// CIL[DOC-CONTEXT module="retry-deliveries" layer="shared" related_files="[".framework/functions/integration-outbound.ts",".framework/functions/_shared/principal.ts",".framework/migrations/051_integration_broker.sql"]"]
-// CIL[DOC-CONTRACT inputs="ctx" outputs="{ outbound_retried, outbound_succeeded, outbound_failed, errors }" errors="none" side_effects="HTTP calls, webhook_deliveries updates"]
-// CIL[DOC-MICRO logic_summary="Queries pending, due deliveries and calls the corresponding broker action for each." notable_decisions="["Inbound retry is left as a TODO until integration-routes supports delivery_id reuse.","Outbout retries reuse the existing delivery row by passing delivery_id to integration-outbound.execute."]"]
-// 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: shared. Direct callers: 0. Direct calls: 0. Related files: .framework/functions/integration-outbound.ts, .framework/functions/_shared/principal.ts, .framework/migrations/051_integration_broker.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="Only processes outbound deliveries in this pass."]
-// CIL[DOC-VECTOR type="implementation_pattern" content="Called by system-cron on each tick."]
-// CIL[DOC-VECTOR type="user_journey" content="System automatically retries failed or pending outbound webhook calls."]
+// CIL[BEGIN stable_id="~/.framework/functions/_shared/retry-deliveries.ts:module_header:module_header" type="module_header" identity="module_header" parent="~/.framework/functions/_shared/retry-deliveries.ts"]
+// CIL[DOC-MACRO purpose="Provides shared retry logic for pending webhook deliveries"]
+// CIL[DOC-RESPONSIBILITY responsibility="Coordinate delivery retry scheduling and summarize results"]
+// CIL[DOC-CONTEXT module="functions/_shared" layer="function" related_files=".framework/functions/_shared/db.ts,.framework/functions/_shared/principal.ts,.framework/functions/integration-outbound.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Imports dependencies for webhook delivery retry handling" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-AUDIENCE audience="developers"]
+
 
 import { adminDb } from './db'
 import { SYSTEM_PRINCIPAL } from './principal'
 import { execute as executeOutbound } from '../integration-outbound'
+// CIL[DOC-VECTOR type="context" content="purpose='Provides shared retry logic for pending webhook deliveries'; No verified external callers; imports: .framework/functions/_shared/db.ts,.framework/functions/_shared/principal.ts,.framework/functions/integration-outbound.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/retry-deliveries.ts:module_header:module_header"]
+
+
+// CIL[BEGIN stable_id="~/.framework/functions/_shared/retry-deliveries.ts:RetrySummary:interface" type="interface" identity="RetrySummary" parent="~/.framework/functions/_shared/retry-deliveries.ts"]
+// CIL[DOC-MACRO purpose="Defines the shape of retry operation summary statistics"]
+// CIL[DOC-RESPONSIBILITY responsibility="Declare counts and errors returned after retrying deliveries"]
+// CIL[DOC-CONTEXT module="functions/_shared" layer="function" related_files=".framework/functions/_shared/db.ts,.framework/functions/_shared/principal.ts,.framework/functions/_shared/retry-deliveries.ts,.framework/functions/integration-outbound.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Aggregates counts of retried, succeeded, and failed deliveries with a list of errors" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 
 interface RetrySummary {
   outbound_retried: number
@@ -27,6 +39,23 @@ interface RetrySummary {
   inbound_failed: number
   errors: string[]
 }
+// CIL[DOC-VECTOR type="context" content="purpose='Defines the shape of retry operation summary statistics'; No verified external callers; imports: .framework/functions/_shared/db.ts,.framework/functions/_shared/principal.ts,.framework/functions/integration-outbound.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/retry-deliveries.ts:RetrySummary:interface"]
+
+
+// CIL[BEGIN stable_id="~/.framework/functions/_shared/retry-deliveries.ts:retryPendingDeliveries:function" type="function" identity="retryPendingDeliveries" parent="~/.framework/functions/_shared/retry-deliveries.ts"]
+// CIL[DOC-MACRO purpose="Retries pending webhook deliveries due for a new attempt and returns a summary"]
+// CIL[DOC-RESPONSIBILITY responsibility="Fetch due deliveries, call outbound retry handler, tally results, log failures"]
+// CIL[DOC-CONTEXT module="functions/_shared" layer="function" related_files=".framework/functions/_shared/db.ts,.framework/functions/_shared/principal.ts,.framework/functions/_shared/retry-deliveries.ts,.framework/functions/integration-outbound.ts"]
+// CIL[DOC-CONTRACT inputs="ctx: any" outputs="Promise<RetrySummary>" errors="db query errors, delivery execution errors" side_effects="Calls executeOutbound, updates console logs"]
+// CIL[DOC-MICRO logic_summary="Queries webhook_deliveries table for pending due rows, invokes executeOutbound for outbound deliveries, counts successes/failures, and returns a RetrySummary" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 
 export async function retryPendingDeliveries(ctx: any): Promise<RetrySummary> {
   const summary: RetrySummary = {
@@ -100,5 +129,11 @@ export async function retryPendingDeliveries(ctx: any): Promise<RetrySummary> {
 
   return summary
 }
+// CIL[DOC-VECTOR type="context" content="purpose='Retries pending webhook deliveries due for a new attempt and returns a summary'; No verified external callers; imports: .framework/functions/_shared/db.ts,.framework/functions/_shared/principal.ts,.framework/functions/integration-outbound.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/retry-deliveries.ts:retryPendingDeliveries:function"]
 
-// CIL[END chunk_id="retry_deliveries_module_header_1784200007"]