spine-framework 0.3.145 → 0.4.1

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

@@ -1,20 +1,15 @@
-
-
-// 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[BEGIN stable_id="~/.framework/src/components/runtime/DataTable.tsx:module_header:module_header" type="module_header" identity="module_header" parent="~/.framework/src/components/runtime/DataTable.tsx"]
+// CIL[DOC-MACRO purpose="Module imports and entry point for the DataTable runtime component"]
+// CIL[DOC-RESPONSIBILITY responsibility="Imports dependencies and shared UI primitives used by the DataTable."]
+// CIL[DOC-CONTEXT module="components/runtime" layer="component" related_files=".framework/src/components/ui/badge.tsx,.framework/src/components/ui/button.tsx,.framework/src/components/ui/card.tsx,.framework/src/components/ui/skeleton.tsx,.framework/src/components/ui/table.tsx,.framework/src/lib/utils.ts,.framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Imports React, router, types, utilities, and shared UI components required by the runtime data table." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
 // CIL[DOC-STABILITY stability="stable"]
 // CIL[DOC-AUDIENCE audience="developer"]
-// CIL[DOC-VECTOR type="context" content="Layer: 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'
@@ -33,6 +28,23 @@ import { Skeleton } from '../ui/skeleton'
 import { Badge } from '../ui/badge'
 import * as Icons from 'lucide-react'
 
+// CIL[DOC-VECTOR type="context" content="purpose='Module imports and entry point for the DataTable runtime component'; No verified external callers; imports: .framework/src/types/types.ts,.framework/src/lib/utils.ts,.framework/src/components/ui/table.tsx"]
+// 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/src/components/runtime/DataTable.tsx:module_header:module_header"]
+
+
+// CIL[BEGIN stable_id="~/.framework/src/components/runtime/DataTable.tsx:DataTableProps:interface" type="interface" identity="DataTableProps" parent="~/.framework/src/components/runtime/DataTable.tsx"]
+// CIL[DOC-MACRO purpose="TypeScript props contract for the DataTable component"]
+// CIL[DOC-RESPONSIBILITY responsibility="Defines the expected properties passed to DataTable, including columns, data, sort handlers, and state flags."]
+// CIL[DOC-CONTEXT module="components/runtime" layer="component" related_files=".framework/src/components/runtime/DataTable.tsx,.framework/src/components/ui/badge.tsx,.framework/src/components/ui/button.tsx,.framework/src/components/ui/card.tsx,.framework/src/components/ui/skeleton.tsx,.framework/src/components/ui/table.tsx,.framework/src/lib/utils.ts,.framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="columns: EntityColumn[], data: any[], loading?: boolean, error?: string|null, onRetry?: () => void, sort, onSort, entity, emptyMessage, emptyIcon" outputs="none (type definition)" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Declares the DataTableProps interface consumed by the DataTable React component." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 interface DataTableProps {
   columns: EntityColumn[]
   data: any[]
@@ -45,21 +57,23 @@ 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="context" content="purpose='TypeScript props contract for the DataTable component'; No verified external callers; imports: .framework/src/types/types.ts,.framework/src/lib/utils.ts,.framework/src/components/ui/table.tsx"]
+// 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/src/components/runtime/DataTable.tsx:DataTableProps:interface"]
+
+
+// CIL[BEGIN stable_id="~/.framework/src/components/runtime/DataTable.tsx:DataTable:component" type="component" identity="DataTable" parent="~/.framework/src/components/runtime/DataTable.tsx"]
+// CIL[DOC-MACRO purpose="Renders a sortable, clickable data table for runtime records with loading, error, and empty states"]
+// CIL[DOC-RESPONSIBILITY responsibility="Displays tabular data, handles sorting, row navigation, and loading/error/empty UI states."]
+// CIL[DOC-CONTEXT module="components/runtime" layer="component" related_files=".framework/src/components/runtime/DataTable.tsx,.framework/src/components/ui/badge.tsx,.framework/src/components/ui/button.tsx,.framework/src/components/ui/card.tsx,.framework/src/components/ui/skeleton.tsx,.framework/src/components/ui/table.tsx,.framework/src/lib/utils.ts,.framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="columns, data, loading, error, onRetry, sort, onSort, entity, emptyMessage, emptyIcon (destructured from DataTableProps)" outputs="JSX rendering of a Card containing a Table or state-specific fallback" errors="Throws no errors; displays an error state when the error prop is provided" side_effects="Calls useNavigate to route to detail views on row click"]
+// CIL[DOC-MICRO logic_summary="Renders skeleton, error, empty, or table views; uses renderCell to format timestamp, badge, and truncated text; handles ascending/descending sort and row navigation." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export function DataTable({ 
   columns, 
   data, 
@@ -75,20 +89,6 @@ 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({ 
@@ -99,22 +99,7 @@ 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" />
@@ -123,22 +108,7 @@ 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)
@@ -163,41 +133,11 @@ 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>
@@ -209,22 +149,7 @@ 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>
@@ -239,22 +164,7 @@ 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>
@@ -268,22 +178,7 @@ 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>
@@ -321,6 +216,11 @@ export function DataTable({
       </Table>
     </Card>
   )
-  // CIL[END chunk_id="DataTable_maintable_1783929048"]
 }
-// CIL[END chunk_id="DataTable_datatable_1783929048"]
+// CIL[DOC-VECTOR type="context" content="purpose='Renders a sortable, clickable data table for runtime records with loading, error, and empty states'; No verified external callers; imports: .framework/src/types/types.ts,.framework/src/lib/utils.ts,.framework/src/components/ui/table.tsx"]
+// 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/src/components/runtime/DataTable.tsx:DataTable:component"]

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

@@ -1,23 +1,30 @@
-
-
-// CIL[BEGIN chunk_id="SchemaDetailForm_module_header_1783929048" type="module_header" identity="imports_and_types" parent="none"]
-// CIL[DOC-MACRO purpose="Import dependencies and define schema form component types"]
-// CIL[DOC-RESPONSIBILITY responsibility="Manage imports and interface for schema form"]
-// CIL[DOC-CONTEXT module="runtime" layer="frontend-component" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/functions/_shared/schema-utils.ts\",\".framework/src/components/ui/dialog.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/src/components/ui/table-primitives.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="types" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Imports schema types and SchemaFields component" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[BEGIN stable_id="~/.framework/src/components/runtime/SchemaDetailForm.tsx:module_header:module_header" type="module_header" identity="module_header" parent="none"]
+// CIL[DOC-MACRO purpose="React component for rendering schema-driven detail forms"]
+// CIL[DOC-RESPONSIBILITY responsibility="Defines module imports for SchemaDetailForm and related types/components"]
+// CIL[DOC-CONTEXT module="runtime" layer="frontend" related_files=".framework/src/components/shared/SchemaFields.tsx,.framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Imports DesignSchema, detail view types, and the shared SchemaFields component." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
 // CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-AUDIENCE audience="developer"]
-// CIL[DOC-VECTOR type="context" content="Layer: frontend-component. Direct callers: 0. Direct calls: 0. Related files: custom/apps/portal/pages/ContentPage.tsx, .framework/functions/_shared/schema-utils.ts, .framework/src/components/ui/dialog.tsx, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .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"]
+// CIL[DOC-AUDIENCE audience="internal"]
 import { DesignSchema, DetailView, DetailViewSection, FieldDefinition } from '../../types/types'
 import { SchemaFields } from '../shared/SchemaFields'
 
+// CIL[DOC-VECTOR type="context" content="purpose='React component for rendering schema-driven detail forms'; No verified external callers; imports: .framework/src/types/types.ts,.framework/src/components/shared/SchemaFields.tsx"]
+// 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/src/components/runtime/SchemaDetailForm.tsx:module_header:module_header"]
+// CIL[BEGIN stable_id="~/.framework/src/components/runtime/SchemaDetailForm.tsx:schemadetailformprops:interface" type="interface" identity="schemadetailformprops" parent="~/.framework/src/components/runtime/SchemaDetailForm.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Props interface for SchemaDetailForm"]
+// CIL[DOC-RESPONSIBILITY responsibility="Declares the input contract for SchemaDetailForm"]
+// CIL[DOC-CONTEXT module="runtime" layer="frontend" related_files=".framework/src/components/runtime/SchemaDetailForm.tsx,.framework/src/components/shared/SchemaFields.tsx,.framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="SchemaDetailFormProps interface" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Defines props including schema, view, record, editing flags, permissions, form data, and onFieldChange callback." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 interface SchemaDetailFormProps {
   schema: DesignSchema
   view: DetailView
@@ -28,21 +35,23 @@ interface SchemaDetailFormProps {
   formData: Record<string, any>
   onFieldChange: (key: string, value: any) => void
 }
-// CIL[END chunk_id="SchemaDetailForm_module_header_1783929048"]
-// CIL[BEGIN chunk_id="SchemaDetailForm_schemadetailform_1783929048" type="function" identity="SchemaDetailForm" parent="none"]
-// CIL[DOC-MACRO purpose="Render all form sections in vertical layout"]
-// CIL[DOC-RESPONSIBILITY responsibility="Display complete form with all sections"]
-// CIL[DOC-CONTEXT module="runtime" layer="frontend-component" related_files="[\".framework/migrations/015_simplify_apps_table.sql\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/functions/_shared/principal.ts\",\".framework/src/pages/admin/IntegrationsPage.tsx\",\"custom/apps/cortex/functions/custom_cil-embeddings.ts\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="JSX form sections" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Map view sections to renderSection calls in space-y layout" 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/migrations/015_simplify_apps_table.sql, .framework/src/pages/admin/TypeDetailPage.tsx, .framework/functions/_shared/principal.ts, .framework/src/pages/admin/IntegrationsPage.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="context" content="purpose='Props interface for SchemaDetailForm'; No verified external callers; imports: .framework/src/types/types.ts,.framework/src/components/shared/SchemaFields.tsx"]
+// 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/src/components/runtime/SchemaDetailForm.tsx:schemadetailformprops:interface"]
+
+
+// CIL[BEGIN stable_id="~/.framework/src/components/runtime/SchemaDetailForm.tsx:schemadetailform:function" type="function" identity="schemadetailform" parent="~/.framework/src/components/runtime/SchemaDetailForm.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Renders a detail form from a design schema and view"]
+// CIL[DOC-RESPONSIBILITY responsibility="Renders schema-driven detail sections and field controls"]
+// CIL[DOC-CONTEXT module="runtime" layer="frontend" related_files=".framework/src/components/runtime/SchemaDetailForm.tsx,.framework/src/components/shared/SchemaFields.tsx,.framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="schema, view, record, isEditing, isCreating, permissions, formData, onFieldChange" outputs="JSX.Element" errors="none" side_effects="renders UI"]
+// CIL[DOC-MICRO logic_summary="Maps view sections to FieldDefinition arrays, builds display_type overrides, and delegates rendering to SchemaFields." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export function SchemaDetailForm({
   schema,
   view,
@@ -53,20 +62,6 @@ export function SchemaDetailForm({
   formData,
   onFieldChange
 }: SchemaDetailFormProps) {
-  // CIL[BEGIN chunk_id="SchemaDetailForm_rendersection_1783929048" type="function" identity="renderSection" parent="SchemaDetailForm_schemadetailform_1783929048"]
-// CIL[DOC-MACRO purpose="Render individual form section with fields"]
-// CIL[DOC-RESPONSIBILITY responsibility="Handle renderSection"]
-// CIL[DOC-CONTEXT module="runtime" layer="frontend-component" related_files="[\".framework/src/components/ui/table-primitives.tsx\",\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/functions/_shared/schema-utils.ts\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="JSX section|null" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Map section fields to FieldDefinitions, build display types" 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/components/ui/table-primitives.tsx, custom/apps/portal/pages/ContentPage.tsx, .framework/functions/_shared/schema-utils.ts, .framework/src/pages/admin/TypeDetailPage.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 renderSection = (section: DetailViewSection, sectionIndex: number) => {
     const fieldNames = Array.isArray(section.fields) ? section.fields : Object.keys(section.fields || {})
     const sectionFields = fieldNames.map((fieldName: string) => {
@@ -114,22 +109,7 @@ export function SchemaDetailForm({
       </div>
     )
   }
-  // CIL[END chunk_id="SchemaDetailForm_rendersection_1783929048"]
 
-  // CIL[BEGIN chunk_id="SchemaDetailForm_emptystate_1783929048" type="render_block" identity="emptyState" parent="SchemaDetailForm_schemadetailform_1783929048"]
-// CIL[DOC-MACRO purpose="Render empty state when no sections configured"]
-// CIL[DOC-RESPONSIBILITY responsibility="Handle emptyState"]
-// CIL[DOC-CONTEXT module="runtime" layer="frontend-component" related_files="[\".framework/functions/_shared/principal.ts\",\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/migrations/015_simplify_apps_table.sql\",\".framework/src/components/ui/table-primitives.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="JSX empty state" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Show centered message when no fields are configured" 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/functions/_shared/principal.ts, custom/apps/portal/pages/ContentPage.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"]
   if (!view.sections || view.sections.length === 0) {
     return (
       <div className="bg-white shadow rounded-lg p-6">
@@ -139,27 +119,17 @@ export function SchemaDetailForm({
       </div>
     )
   }
-  // CIL[END chunk_id="SchemaDetailForm_emptystate_1783929048"]
 
-  // CIL[BEGIN chunk_id="SchemaDetailForm_mainrender_1783929048" type="render_block" identity="mainRender" parent="SchemaDetailForm_schemadetailform_1783929048"]
-// CIL[DOC-MACRO purpose="Render all form sections in vertical layout"]
-// CIL[DOC-RESPONSIBILITY responsibility="Handle mainRender"]
-// CIL[DOC-CONTEXT module="runtime" layer="frontend-component" related_files="[\".framework/migrations/015_simplify_apps_table.sql\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/functions/_shared/principal.ts\",\".framework/src/pages/admin/IntegrationsPage.tsx\",\"custom/apps/cortex/functions/custom_cil-embeddings.ts\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="JSX form sections" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Map view sections to renderSection calls in space-y layout" 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/migrations/015_simplify_apps_table.sql, .framework/src/pages/admin/TypeDetailPage.tsx, .framework/functions/_shared/principal.ts, .framework/src/pages/admin/IntegrationsPage.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"]
   return (
     <div className="space-y-6">
       {view.sections.map((section, index) => renderSection(section, index))}
     </div>
   )
-  // CIL[END chunk_id="SchemaDetailForm_mainrender_1783929048"]
 }
-// CIL[END chunk_id="SchemaDetailForm_schemadetailform_1783929048"]
+// CIL[DOC-VECTOR type="context" content="purpose='Renders a detail form from a design schema and view'; No verified external callers; imports: .framework/src/types/types.ts,.framework/src/components/shared/SchemaFields.tsx"]
+// 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/src/components/runtime/SchemaDetailForm.tsx:schemadetailform:function"]