spine-framework 0.3.124 → 0.3.126

package/.framework/functions/admin-funnel.ts

@@ -1,21 +1,37 @@
-/**
- * @module admin-funnel
- * @audience system-admin
- * @layer api-handler
- * @stability stable
- *
- * Admin API for funnel metrics and analytics
- */
 
+// CIL[BEGIN chunk_id="admin-funnel_module_header_1784019432" type="module_header" identity="imports" parent="none"]
+// CIL[DOC-MACRO purpose="Import dependencies for funnel metrics"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide middleware and admin database access"]
+// CIL[DOC-CONTEXT module="admin-funnel" 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 funnel analytics" 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: 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"]
 import { createHandler } from './_shared/middleware'
 import { adminDb } from './_shared/db'
-
-// ============================================
-// FUNNEL METRICS
-// ============================================
-
+// CIL[END chunk_id="admin-funnel_module_header_1784019432"]
+// CIL[BEGIN chunk_id="admin-funnel_metrics_1784019432" type="function" identity="metrics" parent="none"]
+// CIL[DOC-MACRO purpose="Calculate funnel metrics and conversion rates"]
+// CIL[DOC-RESPONSIBILITY responsibility="Aggregate funnel data across visitor journey stages"]
+// CIL[DOC-CONTEXT module="admin-funnel" layer="api-handler" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/src/components/ui/dialog.tsx\",\".framework/src/pages/admin/RolesPage.tsx\",\".framework/functions/_shared/principal.ts\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="funnel_metrics_object" errors="types_not_found" side_effects="database_queries,aggregation_calculations"]
+// CIL[DOC-MICRO logic_summary="Queries signals, sessions, instances; calculates conversion rates and stage distribution" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="external_symbols_unknown"]
+// 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, .framework/src/components/ui/dialog.tsx, .framework/src/pages/admin/RolesPage.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="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 export const metrics = createHandler(async (ctx, body) => {
-  // Get type IDs
   const { data: signalType } = await adminDb
     .from('item_type_registry')
     .select('id')
@@ -38,7 +54,6 @@ export const metrics = createHandler(async (ctx, body) => {
     throw new Error('Required types not found')
   }
 
-  // Count by stage
   const { data: stageData } = await adminDb
     .from('items')
     .select('data->>stage, account_id')
@@ -55,7 +70,6 @@ export const metrics = createHandler(async (ctx, body) => {
 
   const totalStageSignals = Object.values(stageCounts).reduce((sum, count) => sum + count, 0)
 
-  // Anonymous visitors (sessions without account)
   const { count: anonymousSessions } = await adminDb
     .from('items')
     .select('*', { count: 'exact', head: true })
@@ -63,7 +77,6 @@ export const metrics = createHandler(async (ctx, body) => {
     .is('data->lifecycle->>stitched_to_account_id', null)
     .gte('created_at', new Date(Date.now() - 30 * 24 * 60 * 60 * 1000).toISOString())
 
-  // Identified users (unique accounts with signals)
   const { data: accountData } = await adminDb
     .from('items')
     .select('account_id')
@@ -73,21 +86,18 @@ export const metrics = createHandler(async (ctx, body) => {
 
   const uniqueAccounts = new Set(accountData?.map(item => item.account_id)).size
 
-  // Installed instances
   const { count: installedInstances } = await adminDb
     .from('items')
     .select('*', { count: 'exact', head: true })
     .eq('type_id', instanceType.id)
     .not('data->>claimed_by_person_id', 'is', null)
 
-  // Stage distribution with percentages
   const stageDistribution = Object.entries(stageCounts).map(([stage, count]) => ({
     stage,
     count,
     percentage: totalStageSignals > 0 ? (count / totalStageSignals) * 100 : 0
   }))
 
-  // Conversion rates (simplified)
   const anonymousToIdentified = anonymousSessions > 0 ? (uniqueAccounts / anonymousSessions) * 100 : 0
   const identifiedToInstalled = uniqueAccounts > 0 ? (installedInstances / uniqueAccounts) * 100 : 0
 
@@ -102,3 +112,4 @@ export const metrics = createHandler(async (ctx, body) => {
     stage_distribution: stageDistribution
   }
 })
+// CIL[END chunk_id="admin-funnel_metrics_1784019432"]

package/.framework/functions/admin-install-funnel.ts

@@ -1,21 +1,38 @@
-/**
- * @module admin-install-funnel
- * @audience system-admin
- * @layer api-handler
- * @stability stable
- *
- * Admin API for install funnel metrics and analytics
- */
 
+
+// CIL[BEGIN chunk_id="admin-install-funnel_module_header_1784019432" type="module_header" identity="imports" parent="none"]
+// CIL[DOC-MACRO purpose="Import dependencies for install funnel analytics"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide middleware and admin database access"]
+// CIL[DOC-CONTEXT module="admin-install-funnel" layer="api-handler" related_files="[\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/functions/_shared/principal.ts\",\".framework/src/components/layout/Sidebar.tsx\",\".framework/functions/_shared/schema-utils.ts\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="imported_modules" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Imports required modules for install funnel processing" 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: 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/src/components/layout/Sidebar.tsx, .framework/functions/_shared/schema-utils.ts, \."]
+// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
+// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
+// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 import { createHandler } from './_shared/middleware'
 import { adminDb } from './_shared/db'
-
-// ============================================
-// INSTALL FUNNEL METRICS
-// ============================================
-
+// CIL[END chunk_id="admin-install-funnel_module_header_1784019432"]
+// CIL[BEGIN chunk_id="admin-install-funnel_metrics_1784019432" type="function" identity="metrics" parent="none"]
+// CIL[DOC-MACRO purpose="Calculate install funnel metrics and trends"]
+// CIL[DOC-RESPONSIBILITY responsibility="Aggregate install data with conversion rates and version analytics"]
+// CIL[DOC-CONTEXT module="admin-install-funnel" layer="api-handler" 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="install_metrics_object" errors="funnel_signal_type_not_found" side_effects="database_queries,aggregation_calculations,trend_analysis"]
+// CIL[DOC-MICRO logic_summary="Counts downloads/installs, calculates conversion rates, analyzes versions, tracks trends" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="external_symbols_unknown"]
+// 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, .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"]
 export const metrics = createHandler(async (ctx, body) => {
-  // Get type IDs
   const { data: signalType } = await adminDb
     .from('item_type_registry')
     .select('id')
@@ -26,7 +43,6 @@ export const metrics = createHandler(async (ctx, body) => {
     throw new Error('funnel_signal type not found')
   }
 
-  // Total downloads (signals with source='inst' and action_type='download')
   const { count: totalDownloads } = await adminDb
     .from('items')
     .select('*', { count: 'exact', head: true })
@@ -34,7 +50,6 @@ export const metrics = createHandler(async (ctx, body) => {
     .eq('data->>source', 'inst')
     .eq('data->>action_type', 'download')
 
-  // Unique installers (unique serial numbers from install signals)
   const { data: installerData } = await adminDb
     .from('items')
     .select('data->>serial')
@@ -44,7 +59,6 @@ export const metrics = createHandler(async (ctx, body) => {
 
   const uniqueInstallers = new Set(installerData?.map(item => item.data?.serial)).size
 
-  // Active instances (install signals with serial in last 7 days)
   const sevenDaysAgo = new Date(Date.now() - 7 * 24 * 60 * 60 * 1000).toISOString()
   const { count: activeInstances } = await adminDb
     .from('items')
@@ -54,7 +68,6 @@ export const metrics = createHandler(async (ctx, body) => {
     .not('data->>serial', 'is', null)
     .gte('created_at', sevenDaysAgo)
 
-  // Conversion funnel counts
   const { count: installations } = await adminDb
     .from('items')
     .select('*', { count: 'exact', head: true })
@@ -76,7 +89,6 @@ export const metrics = createHandler(async (ctx, body) => {
     .eq('data->>source', 'inst')
     .not('data->>claimed_by_person_id', 'is', null)
 
-  // Recent installs with account info
   const { data: recentInstalls } = await adminDb
     .from('items')
     .select(`
@@ -111,7 +123,6 @@ export const metrics = createHandler(async (ctx, body) => {
     person_email: instance.people?.email
   }))
 
-  // Version distribution
   const { data: versionData } = await adminDb
     .from('items')
     .select('data->>version')
@@ -133,7 +144,6 @@ export const metrics = createHandler(async (ctx, body) => {
       percentage: totalVersions > 0 ? (count / totalVersions) * 100 : 0
     }))
 
-  // Install trends (last 30 days)
   const thirtyDaysAgo = new Date(Date.now() - 30 * 24 * 60 * 60 * 1000)
   const installTrends = []
   
@@ -183,13 +193,22 @@ export const metrics = createHandler(async (ctx, body) => {
     top_versions: topVersions
   }
 })
-
-// ============================================
-// INSTALL FUNNEL EXPORT
-// ============================================
-
+// CIL[END chunk_id="admin-install-funnel_metrics_1784019432"]
+// CIL[BEGIN chunk_id="admin-install-funnel_exportdata_1784019432" type="function" identity="exportData" parent="none"]
+// CIL[DOC-MACRO purpose="Export all install instances with full details"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide complete install data for analysis and reporting"]
+// CIL[DOC-CONTEXT module="admin-install-funnel" layer="api-handler" related_files="[\".framework/functions/_shared/schema-utils.ts\",\".framework/src/components/layout/Sidebar.tsx\",\".framework/src/components/ui/dialog.tsx\",\".framework/functions/_shared/principal.ts\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="export_data_object" errors="funnel_signal_type_not_found" side_effects="database_query,data_export"]
+// CIL[DOC-MICRO logic_summary="Queries all install instances with full details and metadata" 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: .framework/functions/_shared/schema-utils.ts, .framework/src/components/layout/Sidebar.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."]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 export const exportData = createHandler(async (ctx, body) => {
-  // Get type IDs
   const { data: signalType } = await adminDb
     .from('item_type_registry')
     .select('id')
@@ -200,7 +219,6 @@ export const exportData = createHandler(async (ctx, body) => {
     throw new Error('funnel_signal type not found')
   }
 
-  // Export all instances with full details
   const { data: instances } = await adminDb
     .from('items')
     .select(`
@@ -223,3 +241,4 @@ export const exportData = createHandler(async (ctx, body) => {
     total_count: instances?.length || 0
   }
 })
+// CIL[END chunk_id="admin-install-funnel_exportdata_1784019432"]

package/.framework/functions/admin-signals.ts

@@ -1,25 +1,42 @@
-/**
- * @module admin-signals
- * @audience system-admin
- * @layer api-handler
- * @stability stable
- *
- * Admin API for signal analytics and audit functionality
- */
 
+
+// CIL[BEGIN chunk_id="admin-signals_module_header_1784019432" type="module_header" identity="imports" parent="none"]
+// CIL[DOC-MACRO purpose="Import dependencies for signal analytics"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide middleware and admin database access"]
+// CIL[DOC-CONTEXT module="admin-signals" 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 signal processing" 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: 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"]
 import { createHandler } from './_shared/middleware'
 import { adminDb } from './_shared/db'
-
-// ============================================
-// SIGNAL METRICS
-// ============================================
-
+// CIL[END chunk_id="admin-signals_module_header_1784019432"]
+// CIL[BEGIN chunk_id="admin-signals_metrics_1784019432" type="function" identity="metrics" parent="none"]
+// CIL[DOC-MACRO purpose="Calculate signal metrics and analytics"]
+// CIL[DOC-RESPONSIBILITY responsibility="Aggregate signal data with conversion rates and trends"]
+// CIL[DOC-CONTEXT module="admin-signals" layer="api-handler" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/src/components/ui/dialog.tsx\",\".framework/src/pages/admin/RolesPage.tsx\",\".framework/functions/_shared/principal.ts\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="signal_metrics_object" errors="funnel_signal_type_not_found" side_effects="database_queries,aggregation_calculations"]
+// CIL[DOC-MICRO logic_summary="Counts signals by time periods, calculates sources, formats recent signals, computes conversion rates" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="external_symbols_unknown"]
+// 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, .framework/src/components/ui/dialog.tsx, .framework/src/pages/admin/RolesPage.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="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 export const metrics = createHandler(async (ctx, body) => {
   const now = new Date()
   const today = now.toISOString().split('T')[0]
   const weekAgo = new Date(now.getTime() - 7 * 24 * 60 * 60 * 1000).toISOString()
   
-  // Get funnel_signal type ID
   const { data: signalType } = await adminDb
     .from('item_type_registry')
     .select('id')
@@ -30,27 +47,23 @@ export const metrics = createHandler(async (ctx, body) => {
     throw new Error('funnel_signal type not found')
   }
 
-  // Total signals
   const { count: totalSignals } = await adminDb
     .from('items')
     .select('*', { count: 'exact', head: true })
     .eq('type_id', signalType.id)
 
-  // Signals today
   const { count: signalsToday } = await adminDb
     .from('items')
     .select('*', { count: 'exact', head: true })
     .eq('type_id', signalType.id)
     .gte('created_at', today)
 
-  // Signals this week
   const { count: signalsThisWeek } = await adminDb
     .from('items')
     .select('*', { count: 'exact', head: true })
     .eq('type_id', signalType.id)
     .gte('created_at', weekAgo)
 
-  // Top sources
   const { data: sourceData } = await adminDb
     .from('items')
     .select('data->>source')
@@ -68,7 +81,6 @@ export const metrics = createHandler(async (ctx, body) => {
     .slice(0, 10)
     .map(([source, count]) => ({ source, count }))
 
-  // Recent signals with account info
   const { data: recentSignals } = await adminDb
     .from('items')
     .select(`
@@ -95,7 +107,6 @@ export const metrics = createHandler(async (ctx, body) => {
     rating: parseInt(signal.data?.rating || '1')
   }))
 
-  // Calculate conversion rate (simplified - signals with rating >= 4)
   const { count: highValueSignals } = await adminDb
     .from('items')
     .select('*', { count: 'exact', head: true })
@@ -114,11 +125,21 @@ export const metrics = createHandler(async (ctx, body) => {
     recent_signals: formattedSignals || []
   }
 })
-
-// ============================================
-// SIGNAL AUDIT
-// ============================================
-
+// CIL[END chunk_id="admin-signals_metrics_1784019432"]
+// CIL[BEGIN chunk_id="admin-signals_audit_1784019432" type="function" identity="audit" parent="none"]
+// CIL[DOC-MACRO purpose="Audit and export signal data with filtering"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide searchable, filterable signal audit trail"]
+// CIL[DOC-CONTEXT module="admin-signals" layer="api-handler" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/functions/_shared/db.ts\",\".framework/src/pages/admin/IntegrationsPage.tsx\",\".framework/functions/_shared/schema-utils.ts\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="paginated_signals_or_export_data" errors="funnel_signal_type_not_found" side_effects="database_queries,data_formatting"]
+// CIL[DOC-MICRO logic_summary="Builds filtered query, applies pagination, formats signal data for audit/export" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="external_symbols_unknown"]
+// 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, .framework/functions/_shared/db.ts, .framework/src/pages/admin/IntegrationsPage.tsx, .framework/functions/_shared/schema-utils.ts, 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="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 export const audit = createHandler(async (ctx, body) => {
   const {
     page = '1',
@@ -134,7 +155,6 @@ export const audit = createHandler(async (ctx, body) => {
     export: exportData
   } = ctx.query || {}
 
-  // Get funnel_signal type ID
   const { data: signalType } = await adminDb
     .from('item_type_registry')
     .select('id')
@@ -145,7 +165,6 @@ export const audit = createHandler(async (ctx, body) => {
     throw new Error('funnel_signal type not found')
   }
 
-  // Build query
   let query = adminDb
     .from('items')
     .select(`
@@ -169,7 +188,6 @@ export const audit = createHandler(async (ctx, body) => {
     `, { count: 'exact' })
     .eq('type_id', signalType.id)
 
-  // Apply filters
   if (date_from) {
     query = query.gte('created_at', date_from)
   }
@@ -195,7 +213,6 @@ export const audit = createHandler(async (ctx, body) => {
     query = query.or(`accounts.name.ilike.%${search}%,people.email.ilike.%${search}%,data->attribution->>first_touch_referrer_domain.ilike.%${search}%`)
   }
 
-  // Order and paginate
   const offset = (parseInt(page) - 1) * parseInt(limit)
   query = query.order('created_at', { ascending: false })
 
@@ -239,3 +256,4 @@ export const audit = createHandler(async (ctx, body) => {
     limit: parseInt(limit)
   }
 })
+// CIL[END chunk_id="admin-signals_audit_1784019432"]