spine-framework 0.3.124 → 0.3.126

package/.framework/src/components/runtime/DataListPage.tsx

@@ -1,3 +1,20 @@
+
+
+// CIL[BEGIN chunk_id="DataListPage_module_header_1783929048" type="module_header" identity="imports" parent="none"]
+// CIL[DOC-MACRO purpose="Import dependencies for entity list page component"]
+// CIL[DOC-RESPONSIBILITY responsibility="Manage imports for hooks and components"]
+// CIL[DOC-CONTEXT module="runtime" layer="frontend-component" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/src/components/ui/dialog.tsx\",\".framework/src/pages/admin/RolesPage.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="imports" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Imports routing, hooks, and runtime components" 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: frontend-component. 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/TypeDetailPage.tsx, .framework/src/components/ui/dialog.tsx, .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"]
 import { useParams } from 'react-router-dom'
 import { useListSchema } from '../../hooks/useListSchema'
 import { useEntityList } from '../../hooks/useEntityList'
@@ -5,17 +22,76 @@ import { DataHeader } from './DataHeader'
 import { DataStats } from './DataStats'
 import { DataFilters } from './DataFilters'
 import { DataTable } from './DataTable'
+import { PageInstructions } from '../admin/PageInstructions'
 import { Card, CardContent } from '../ui/card'
 import { Skeleton } from '../ui/skeleton'
-
+// CIL[END chunk_id="DataListPage_module_header_1783929048"]
+// CIL[BEGIN chunk_id="DataListPage_datalistpage_1783929048" type="function" identity="DataListPage" parent="none"]
+// CIL[DOC-MACRO purpose="Render main list page with all components"]
+// CIL[DOC-RESPONSIBILITY responsibility="Display complete entity management interface"]
+// CIL[DOC-CONTEXT module="runtime" layer="frontend-component" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/migrations/015_simplify_apps_table.sql\",\".framework/src/components/ui/table-primitives.tsx\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="JSX list page" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Render header, stats, filters, and table with config data" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-VECTOR type="context" content="Layer: frontend-component. Direct callers: 0. Direct calls: 0. Related files: custom/apps/portal/pages/ContentPage.tsx, .framework/src/pages/admin/TypeDetailPage.tsx, .framework/migrations/015_simplify_apps_table.sql, .framework/src/components/ui/table-primitives.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 function DataListPage() {
+  // CIL[BEGIN chunk_id="DataListPage_params_1783929048" type="variable_declaration" identity="params" parent="DataListPage_datalistpage_1783929048"]
+// CIL[DOC-MACRO purpose="Extract URL parameters for entity and type"]
+// CIL[DOC-RESPONSIBILITY responsibility="Handle params"]
+// CIL[DOC-CONTEXT module="runtime" layer="frontend-component" related_files="[\".framework/src/pages/admin/TypeDetailPage.tsx\",\"custom/apps/portal/pages/ContentPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/migrations/025_retype_threads_messages.sql\",\".framework/functions/_shared/schema-utils.ts\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="entity:string,typeSlug?:string" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Extract entity and optional typeSlug from React Router params" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-VECTOR type="context" content="Layer: frontend-component. Direct callers: 0. Direct calls: 0. Related files: .framework/src/pages/admin/TypeDetailPage.tsx, custom/apps/portal/pages/ContentPage.tsx, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .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="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
   const { entity, typeSlug } = useParams<{ entity: string; typeSlug?: string }>()
+  // CIL[END chunk_id="DataListPage_params_1783929048"]
   
+  // CIL[BEGIN chunk_id="DataListPage_schema_1783929048" type="variable_declaration" identity="schema" parent="DataListPage_datalistpage_1783929048"]
+// CIL[DOC-MACRO purpose="Fetch entity schema and view configuration"]
+// CIL[DOC-RESPONSIBILITY responsibility="Handle schema"]
+// CIL[DOC-CONTEXT module="runtime" layer="frontend-component" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/functions/_shared/schema-utils.ts\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="schema,view,loading,error" errors="none" side_effects="API call"]
+// CIL[DOC-MICRO logic_summary="Call useListSchema hook to get entity schema and view config" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-VECTOR type="context" content="Layer: frontend-component. Direct callers: 2. Direct calls: 0. Related files: custom/apps/portal/pages/ContentPage.tsx, .framework/functions/_shared/schema-utils.ts, .framework/src/pages/admin/TypeDetailPage.tsx, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, \."]
+// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 2. Total affected: 3."]
+// 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"]
   const { schema, view, loading: schemaLoading, error: schemaError } = useListSchema({
     entity: entity || '',
     viewSlug: 'default_list'
   })
+  // CIL[END chunk_id="DataListPage_schema_1783929048"]
   
+  // CIL[BEGIN chunk_id="DataListPage_config_1783929048" type="variable_declaration" identity="config" parent="DataListPage_datalistpage_1783929048"]
+// CIL[DOC-MACRO purpose="Build configuration object from schema and view"]
+// CIL[DOC-RESPONSIBILITY responsibility="Handle config"]
+// CIL[DOC-CONTEXT module="runtime" layer="frontend-component" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/functions/_shared/schema-utils.ts\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="config:object|null" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Merge schema and view data into config for list components" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-VECTOR type="context" content="Layer: frontend-component. Direct callers: 0. Direct calls: 0. Related files: custom/apps/portal/pages/ContentPage.tsx, .framework/functions/_shared/schema-utils.ts, .framework/src/pages/admin/TypeDetailPage.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="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
   const config = view && schema ? {
     entity: entity || '',
     typeSlug: typeSlug || undefined,
@@ -36,7 +112,22 @@ export function DataListPage() {
       }))
     }
   } : null
+  // CIL[END chunk_id="DataListPage_config_1783929048"]
   
+  // CIL[BEGIN chunk_id="DataListPage_entitylist_1783929048" type="variable_declaration" identity="entityList" parent="DataListPage_datalistpage_1783929048"]
+// CIL[DOC-MACRO purpose="Fetch entity data and list management functions"]
+// CIL[DOC-RESPONSIBILITY responsibility="Handle entityList"]
+// CIL[DOC-CONTEXT module="entityList" layer="unknown" related_files="[]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Implements entityList" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-VECTOR type="context" content="Layer: unknown. Direct callers: 0. Direct calls: 0. Related files: none."]
+// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
+// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
+// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
   const { 
     data, 
     loading, 
@@ -47,7 +138,22 @@ export function DataListPage() {
     sort, 
     setSort
   } = useEntityList(entity!, config)
+  // CIL[END chunk_id="DataListPage_entitylist_1783929048"]
   
+  // CIL[BEGIN chunk_id="DataListPage_loadingstate_1783929048" type="render_block" identity="loadingState" parent="DataListPage_datalistpage_1783929048"]
+// CIL[DOC-MACRO purpose="Render loading skeleton for schema fetching"]
+// CIL[DOC-RESPONSIBILITY responsibility="Handle loadingState"]
+// CIL[DOC-CONTEXT module="runtime" layer="frontend-component" related_files="[]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="JSX loading skeleton" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Show skeleton placeholders for header, stats, and table" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-VECTOR type="context" content="Layer: frontend-component. Direct callers: 0. Direct calls: 0. Related files: none."]
+// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
+// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
+// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
   if (schemaLoading) {
     return (
       <div className="space-y-6">
@@ -73,7 +179,22 @@ export function DataListPage() {
       </div>
     )
   }
+  // CIL[END chunk_id="DataListPage_loadingstate_1783929048"]
   
+  // CIL[BEGIN chunk_id="DataListPage_errorstate_1783929048" type="render_block" identity="errorState" parent="DataListPage_datalistpage_1783929048"]
+// CIL[DOC-MACRO purpose="Render error state for schema loading failures"]
+// CIL[DOC-RESPONSIBILITY responsibility="Handle errorState"]
+// CIL[DOC-CONTEXT module="errorState" layer="unknown" related_files="[\".framework/functions/_shared/schema-utils.ts\",\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/functions/_shared/principal.ts\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Implements errorState" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-VECTOR type="context" content="Layer: unknown. Direct callers: 0. Direct calls: 0. Related files: .framework/functions/_shared/schema-utils.ts, custom/apps/portal/pages/ContentPage.tsx, .framework/src/pages/admin/TypeDetailPage.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"]
   if (schemaError || !config) {
     return (
       <Card>
@@ -84,7 +205,22 @@ export function DataListPage() {
       </Card>
     )
   }
+  // CIL[END chunk_id="DataListPage_errorstate_1783929048"]
   
+  // CIL[BEGIN chunk_id="DataListPage_mainrender_1783929048" type="render_block" identity="mainRender" parent="DataListPage_datalistpage_1783929048"]
+// CIL[DOC-MACRO purpose="Render main list page with all components"]
+// CIL[DOC-RESPONSIBILITY responsibility="Handle mainRender"]
+// CIL[DOC-CONTEXT module="mainRender" layer="unknown" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/migrations/015_simplify_apps_table.sql\",\".framework/src/components/ui/table-primitives.tsx\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Implements mainRender" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-VECTOR type="context" content="Layer: unknown. Direct callers: 0. Direct calls: 0. Related files: custom/apps/portal/pages/ContentPage.tsx, .framework/src/pages/admin/TypeDetailPage.tsx, .framework/migrations/015_simplify_apps_table.sql, .framework/src/components/ui/table-primitives.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"]
   return (
     <div className="space-y-6">
       <DataHeader 
@@ -93,7 +229,28 @@ export function DataListPage() {
         description={`Manage ${config.entity}`}
         newButtonHref={`/spine-framework/admin/runtime/${entity}/new`}
       />
-      
+
+      <PageInstructions
+        sections={[
+          {
+            title: 'What this page is for',
+            content: `This page is a schema-driven list for ${config.entity} records. It displays the records stored in the system, their field values, and current status based on the type definition.`,
+          },
+          {
+            title: 'How to find records',
+            content: `Use the filters above the table to narrow results. Click any column header to sort ascending or descending. The available columns and filters are defined by the type schema.`,
+          },
+          {
+            title: 'How to create, view, and edit records',
+            content: `Click the New button in the top-right to create a new ${config.entity}. Click any row to open its detail view. From the detail view you can edit field values or delete the record. Some records may have restricted permissions based on your role.`,
+          },
+          {
+            title: 'Understanding the stats',
+            content: `The cards above the table show summary counts and key metrics for this record type. Use them to quickly assess volume and status before drilling into the list.`,
+          },
+        ]}
+      />
+
       <DataStats 
         stats={config.list.stats} 
         data={data}
@@ -121,4 +278,6 @@ export function DataListPage() {
       />
     </div>
   )
+  // CIL[END chunk_id="DataListPage_mainrender_1783929048"]
 }
+// CIL[END chunk_id="DataListPage_datalistpage_1783929048"]

package/.framework/src/components/runtime/DataStats.tsx

@@ -1,3 +1,20 @@
+
+
+// CIL[BEGIN chunk_id="DataStats_module_header_1783929048" type="module_header" identity="imports_and_types" parent="none"]
+// CIL[DOC-MACRO purpose="Import dependencies and define types for stats component"]
+// CIL[DOC-RESPONSIBILITY responsibility="Manage imports, interfaces, and color constants"]
+// CIL[DOC-CONTEXT module="runtime" layer="frontend-component" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/src/components/ui/dialog.tsx\",\".framework/functions/_shared/principal.ts\",\".framework/functions/_shared/schema-utils.ts\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="types_and_constants" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Imports EntityStat type, UI components, and defines color mapping" 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: frontend-component. 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/functions/_shared/principal.ts, .framework/functions/_shared/schema-utils.ts, \."]
+// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
+// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
+// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 import { EntityStat } from '../../types/types'
 import { Card, CardContent } from '../ui/card'
 import * as Icons from 'lucide-react'
@@ -16,8 +33,36 @@ const colorMap: Record<string, string> = {
   purple: 'bg-purple-500/10 text-purple-500',
   gray: 'bg-muted text-muted-foreground'
 }
-
+// CIL[END chunk_id="DataStats_module_header_1783929048"]
+// CIL[BEGIN chunk_id="DataStats_datastats_1783929048" type="function" identity="DataStats" parent="none"]
+// CIL[DOC-MACRO purpose="Calculate statistic value based on type and data"]
+// CIL[DOC-RESPONSIBILITY responsibility="Compute count or filter-based statistics"]
+// CIL[DOC-CONTEXT module="runtime" layer="frontend-component" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/migrations/025_retype_threads_messages.sql\",\".framework/src/pages/admin/IntegrationsPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/functions/_shared/schema-utils.ts\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="number" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Switch on stat type, handle count vs filter_count with nested object access" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-VECTOR type="context" content="Layer: frontend-component. Direct callers: 0. Direct calls: 0. Related files: custom/apps/portal/pages/ContentPage.tsx, .framework/migrations/025_retype_threads_messages.sql, .framework/src/pages/admin/IntegrationsPage.tsx, custom/apps/cortex/pages/operations/OperationsDashboard.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"]
 export function DataStats({ stats, data, loading }: DataStatsProps) {
+  // CIL[BEGIN chunk_id="DataStats_calculatestat_1783929048" type="function" identity="calculateStat" parent="DataStats_datastats_1783929048"]
+// CIL[DOC-MACRO purpose="Calculate statistic value based on type and data"]
+// CIL[DOC-RESPONSIBILITY responsibility="Handle calculateStat"]
+// CIL[DOC-CONTEXT module="runtime" layer="frontend-component" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/migrations/025_retype_threads_messages.sql\",\".framework/src/pages/admin/IntegrationsPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/functions/_shared/schema-utils.ts\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="number" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Switch on stat type, handle count vs filter_count with nested object access" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-VECTOR type="context" content="Layer: frontend-component. Direct callers: 1. Direct calls: 0. Related files: custom/apps/portal/pages/ContentPage.tsx, .framework/migrations/025_retype_threads_messages.sql, .framework/src/pages/admin/IntegrationsPage.tsx, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .framework/functions/_shared/schema-utils.ts, \."]
+// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 1. Total affected: 1."]
+// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
+// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
   const calculateStat = (stat: EntityStat): number => {
     if (!data) return 0
     
@@ -38,6 +83,7 @@ export function DataStats({ stats, data, loading }: DataStatsProps) {
         return 0
     }
   }
+  // CIL[END chunk_id="DataStats_calculatestat_1783929048"]
   
   return (
     <div className="grid grid-cols-1 gap-5 sm:grid-cols-2 lg:grid-cols-4">
@@ -68,3 +114,4 @@ export function DataStats({ stats, data, loading }: DataStatsProps) {
     </div>
   )
 }
+// CIL[END chunk_id="DataStats_datastats_1783929048"]

package/.framework/src/components/runtime/DataTable.tsx

@@ -1,3 +1,20 @@
+
+
+// CIL[BEGIN chunk_id="DataTable_module_header_1783929048" type="module_header" identity="imports_and_types" parent="none"]
+// CIL[DOC-MACRO purpose="Import dependencies and define table component types"]
+// CIL[DOC-RESPONSIBILITY responsibility="Manage imports, interfaces for data table"]
+// CIL[DOC-CONTEXT module="runtime" layer="frontend-component" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/src/components/ui/dialog.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/src/pages/admin/IntegrationsPage.tsx\",\".framework/src/pages/admin/RolesPage.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="types_and_constants" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Imports React, routing, types, UI components for table" 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: frontend-component. Direct callers: 0. Direct calls: 0. Related files: custom/apps/portal/pages/ContentPage.tsx, .framework/src/components/ui/dialog.tsx, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .framework/src/pages/admin/IntegrationsPage.tsx, .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"]
 import React from 'react'
 import { useNavigate } from 'react-router-dom'
 import { EntityColumn } from '../../types/types'
@@ -28,7 +45,21 @@ interface DataTableProps {
   emptyMessage: string
   emptyIcon: string
 }
-
+// CIL[END chunk_id="DataTable_module_header_1783929048"]
+// CIL[BEGIN chunk_id="DataTable_datatable_1783929048" type="function" identity="DataTable" parent="none"]
+// CIL[DOC-MACRO purpose="Render main table with sortable headers and clickable rows"]
+// CIL[DOC-RESPONSIBILITY responsibility="Display data table with full functionality"]
+// CIL[DOC-CONTEXT module="runtime" layer="frontend-component" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/src/pages/admin/RolesPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/src/components/ui/dialog.tsx\",\".framework/functions/_shared/principal.ts\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="JSX table component" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Render table header with sort icons, data rows with click handlers" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-VECTOR type="context" content="Layer: frontend-component. Direct callers: 0. Direct calls: 0. Related files: custom/apps/portal/pages/ContentPage.tsx, .framework/src/pages/admin/RolesPage.tsx, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .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="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 export function DataTable({ 
   columns, 
   data, 
@@ -44,6 +75,20 @@ export function DataTable({
   const navigate = useNavigate()
   const EmptyIconComponent = (Icons as Record<string, React.ComponentType<{ className?: string }>>)[emptyIcon] || Icons.Box
   
+  // CIL[BEGIN chunk_id="DataTable_handlesort_1783929048" type="function" identity="handleSort" parent="DataTable_datatable_1783929048"]
+// CIL[DOC-MACRO purpose="Handle column sorting with toggle direction"]
+// CIL[DOC-RESPONSIBILITY responsibility="Handle handleSort"]
+// CIL[DOC-CONTEXT module="runtime" layer="frontend-component" related_files="[\".framework/src/pages/admin/RolesPage.tsx\",\".framework/functions/_shared/schema-utils.ts\",\".framework/src/components/ui/dialog.tsx\",\".framework/functions/_shared/principal.ts\",\".framework/src/pages/admin/IntegrationsPage.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="calls onSort"]
+// CIL[DOC-MICRO logic_summary="Toggle sort direction or set new field with asc default" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-VECTOR type="context" content="Layer: frontend-component. Direct callers: 0. Direct calls: 0. Related files: .framework/src/pages/admin/RolesPage.tsx, .framework/functions/_shared/schema-utils.ts, .framework/src/components/ui/dialog.tsx, .framework/functions/_shared/principal.ts, .framework/src/pages/admin/IntegrationsPage.tsx, \."]
+// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
+// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
+// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
   const handleSort = (key: string) => {
     if (sort.field === key) {
       onSort({ 
@@ -54,7 +99,22 @@ export function DataTable({
       onSort({ field: key, direction: 'asc' })
     }
   }
+  // CIL[END chunk_id="DataTable_handlesort_1783929048"]
   
+  // CIL[BEGIN chunk_id="DataTable_getsorticon_1783929048" type="function" identity="getSortIcon" parent="DataTable_datatable_1783929048"]
+// CIL[DOC-MACRO purpose="Return appropriate sort icon for column state"]
+// CIL[DOC-RESPONSIBILITY responsibility="Handle getSortIcon"]
+// CIL[DOC-CONTEXT module="runtime" layer="frontend-component" related_files="[\".framework/src/pages/admin/RolesPage.tsx\",\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/functions/_shared/principal.ts\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="JSX icon" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Return up/down arrow or neutral based on current sort" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-VECTOR type="context" content="Layer: frontend-component. Direct callers: 2. Direct calls: 0. Related files: .framework/src/pages/admin/RolesPage.tsx, custom/apps/portal/pages/ContentPage.tsx, .framework/src/pages/admin/TypeDetailPage.tsx, .framework/functions/_shared/principal.ts, \."]
+// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 2. Total affected: 2."]
+// 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"]
   const getSortIcon = (key: string) => {
     if (sort.field !== key) {
       return <Icons.ArrowUpDown className="h-4 w-4 text-muted-foreground" />
@@ -63,7 +123,22 @@ export function DataTable({
       ? <Icons.ArrowUp className="h-4 w-4 text-primary" />
       : <Icons.ArrowDown className="h-4 w-4 text-primary" />
   }
+  // CIL[END chunk_id="DataTable_getsorticon_1783929048"]
   
+  // CIL[BEGIN chunk_id="DataTable_rendercell_1783929048" type="function" identity="renderCell" parent="DataTable_datatable_1783929048"]
+// CIL[DOC-MACRO purpose="Format and render table cell based on column type"]
+// CIL[DOC-RESPONSIBILITY responsibility="Handle renderCell"]
+// CIL[DOC-CONTEXT module="renderCell" layer="unknown" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/migrations/025_retype_threads_messages.sql\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/functions/_shared/schema-utils.ts\",\".framework/src/components/ui/dialog.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Implements renderCell" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-VECTOR type="context" content="Layer: unknown. Direct callers: 2. Direct calls: 0. Related files: custom/apps/portal/pages/ContentPage.tsx, .framework/migrations/025_retype_threads_messages.sql, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .framework/functions/_shared/schema-utils.ts, .framework/src/components/ui/dialog.tsx, \."]
+// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 2. Total affected: 2."]
+// 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"]
   const renderCell = (column: EntityColumn, row: any) => {
     const value = column.key.includes('.')
       ? column.key.split('.').reduce((obj, k) => obj?.[k], row)
@@ -88,11 +163,41 @@ export function DataTable({
     
     return value?.toString() || '-'
   }
+  // CIL[END chunk_id="DataTable_rendercell_1783929048"]
   
+  // CIL[BEGIN chunk_id="DataTable_handlerowclick_1783929048" type="function" identity="handleRowClick" parent="DataTable_datatable_1783929048"]
+// CIL[DOC-MACRO purpose="Navigate to detail page when row is clicked"]
+// CIL[DOC-RESPONSIBILITY responsibility="Handle handleRowClick"]
+// CIL[DOC-CONTEXT module="handleRowClick" layer="unknown" related_files="[]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Implements handleRowClick" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-VECTOR type="context" content="Layer: unknown. Direct callers: 0. Direct calls: 0. Related files: none."]
+// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
+// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
+// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
   const handleRowClick = (row: any) => {
     navigate(`/spine-framework/admin/runtime/${entity}/${row.id}`)
   }
+  // CIL[END chunk_id="DataTable_handlerowclick_1783929048"]
   
+  // CIL[BEGIN chunk_id="DataTable_loadingstate_1783929048" type="render_block" identity="loadingState" parent="DataTable_datatable_1783929048"]
+// CIL[DOC-MACRO purpose="Render loading skeleton state for table"]
+// CIL[DOC-RESPONSIBILITY responsibility="Handle loadingState"]
+// CIL[DOC-CONTEXT module="loadingState" layer="unknown" related_files="[]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Implements loadingState" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-VECTOR type="context" content="Layer: unknown. Direct callers: 0. Direct calls: 0. Related files: none."]
+// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
+// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
+// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
   if (loading) {
     return (
       <Card>
@@ -104,7 +209,22 @@ export function DataTable({
       </Card>
     )
   }
+  // CIL[END chunk_id="DataTable_loadingstate_1783929048"]
   
+  // CIL[BEGIN chunk_id="DataTable_errorstate_1783929048" type="render_block" identity="errorState" parent="DataTable_datatable_1783929048"]
+// CIL[DOC-MACRO purpose="Render error state with retry option"]
+// CIL[DOC-RESPONSIBILITY responsibility="Handle errorState"]
+// CIL[DOC-CONTEXT module="runtime" layer="frontend-component" related_files="[]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="JSX error display" errors="none" side_effects="calls onRetry"]
+// CIL[DOC-MICRO logic_summary="Show error message centered in card with optional retry" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-VECTOR type="context" content="Layer: frontend-component. Direct callers: 0. Direct calls: 0. Related files: none."]
+// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
+// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
+// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
   if (error) {
     return (
       <Card>
@@ -119,7 +239,22 @@ export function DataTable({
       </Card>
     )
   }
+  // CIL[END chunk_id="DataTable_errorstate_1783929048"]
   
+  // CIL[BEGIN chunk_id="DataTable_emptystate_1783929048" type="render_block" identity="emptyState" parent="DataTable_datatable_1783929048"]
+// CIL[DOC-MACRO purpose="Render empty state with icon and message"]
+// CIL[DOC-RESPONSIBILITY responsibility="Handle emptyState"]
+// CIL[DOC-CONTEXT module="emptyState" layer="unknown" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/src/pages/admin/RolesPage.tsx\",\".framework/migrations/025_retype_threads_messages.sql\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\"custom/apps/cortex/functions/custom_cil-embeddings.ts\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Implements emptyState" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-VECTOR type="context" content="Layer: unknown. Direct callers: 0. Direct calls: 0. Related files: custom/apps/portal/pages/ContentPage.tsx, .framework/src/pages/admin/RolesPage.tsx, .framework/migrations/025_retype_threads_messages.sql, 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"]
   if (!data || data.length === 0) {
     return (
       <Card>
@@ -133,7 +268,22 @@ export function DataTable({
       </Card>
     )
   }
+  // CIL[END chunk_id="DataTable_emptystate_1783929048"]
   
+  // CIL[BEGIN chunk_id="DataTable_maintable_1783929048" type="render_block" identity="mainTable" parent="DataTable_datatable_1783929048"]
+// CIL[DOC-MACRO purpose="Render main table with sortable headers and clickable rows"]
+// CIL[DOC-RESPONSIBILITY responsibility="Handle mainTable"]
+// CIL[DOC-CONTEXT module="mainTable" layer="unknown" related_files="[]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Implements mainTable" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-VECTOR type="context" content="Layer: unknown. Direct callers: 0. Direct calls: 0. Related files: none."]
+// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
+// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
+// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
   return (
     <Card>
       <Table>
@@ -171,4 +321,6 @@ export function DataTable({
       </Table>
     </Card>
   )
+  // CIL[END chunk_id="DataTable_maintable_1783929048"]
 }
+// CIL[END chunk_id="DataTable_datatable_1783929048"]