spine-framework 0.3.124 → 0.3.126

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

@@ -1,3 +1,20 @@
+
+
+// CIL[BEGIN chunk_id="DataDetailPage_module_header_1783929048" type="module_header" identity="imports" parent="none"]
+// CIL[DOC-MACRO purpose="Import dependencies for entity detail page component"]
+// CIL[DOC-RESPONSIBILITY responsibility="Manage imports for hooks and components"]
+// 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/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 React hooks, routing, entity hooks, and UI 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: .framework/src/pages/admin/TypeDetailPage.tsx, 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, \."]
+// 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 { useState, useEffect } from 'react'
 import { useParams, useSearchParams } from 'react-router-dom'
 import { useEntityRecord } from '../../hooks/useEntityRecord'
@@ -6,17 +23,88 @@ import { SchemaDetailForm } from './SchemaDetailForm'
 import { Button } from '../ui/button'
 import { Card, CardContent } from '../ui/card'
 import { Skeleton } from '../ui/skeleton'
-
+// CIL[END chunk_id="DataDetailPage_module_header_1783929048"]
+// CIL[BEGIN chunk_id="DataDetailPage_datadetailpage_1783929048" type="function" identity="DataDetailPage" parent="none"]
+// CIL[DOC-MACRO purpose="Render main detail page with header and form"]
+// CIL[DOC-RESPONSIBILITY responsibility="Display complete entity detail interface"]
+// 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/table-primitives.tsx\",\".framework/migrations/015_simplify_apps_table.sql\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="JSX detail page" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Render header and form with all edit/create functionality" 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, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .framework/src/pages/admin/TypeDetailPage.tsx, .framework/src/components/ui/table-primitives.tsx, .framework/migrations/015_simplify_apps_table.sql."]
+// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
+// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
+// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 export function DataDetailPage() {
+  // CIL[BEGIN chunk_id="DataDetailPage_params_1783929048" type="variable_declaration" identity="params" parent="DataDetailPage_datadetailpage_1783929048"]
+// CIL[DOC-MACRO purpose="Extract URL parameters for entity, id, and search params"]
+// CIL[DOC-RESPONSIBILITY responsibility="Handle params"]
+// 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/functions/_shared/principal.ts\",\".framework/functions/_shared/schema-utils.ts\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="entity,id,typeSlug,searchParams" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Extract entity, id, typeSlug from params and manage search 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: custom/apps/portal/pages/ContentPage.tsx, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .framework/src/pages/admin/TypeDetailPage.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"]
   const { entity, id, typeSlug } = useParams<{ entity: string; id: string; typeSlug?: string }>()
   const [searchParams, setSearchParams] = useSearchParams()
+  // CIL[END chunk_id="DataDetailPage_params_1783929048"]
   
-  const isCreating = !id
+  // CIL[BEGIN chunk_id="DataDetailPage_stateflags_1783929048" type="variable_declaration" identity="stateFlags" parent="DataDetailPage_datadetailpage_1783929048"]
+// CIL[DOC-MACRO purpose="Determine create/edit mode from URL parameters"]
+// CIL[DOC-RESPONSIBILITY responsibility="Handle stateFlags"]
+// CIL[DOC-CONTEXT module="runtime" layer="frontend-component" related_files="[\".framework/src/pages/admin/RolesPage.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="isCreating,isEditing" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Set create mode from missing id, edit mode from search param" 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, \."]
+// 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 recordId = id === 'new' ? undefined : id
+  const isCreating = !recordId
   const isEditing = searchParams.get('edit') === 'true' || isCreating
+  // CIL[END chunk_id="DataDetailPage_stateflags_1783929048"]
   
+  // CIL[BEGIN chunk_id="DataDetailPage_config_1783929048" type="variable_declaration" identity="config" parent="DataDetailPage_datadetailpage_1783929048"]
+// CIL[DOC-MACRO purpose="Create configuration object for entity record operations"]
+// CIL[DOC-RESPONSIBILITY responsibility="Handle config"]
+// CIL[DOC-CONTEXT module="runtime" layer="frontend-component" related_files="[\".framework/src/pages/admin/TypeDetailPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/functions/_shared/principal.ts\",\".framework/functions/_shared/schema-utils.ts\",\".framework/src/components/ui/dialog.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="config:object" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Configure entity details, API actions, and display settings" 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/cortex/pages/operations/OperationsDashboard.tsx, .framework/functions/_shared/principal.ts, .framework/functions/_shared/schema-utils.ts, .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"]
+  const defaultTypeSlugs: Record<string, string> = {
+    accounts: 'account',
+    people: 'person',
+    items: 'item',
+    threads: 'thread',
+    messages: 'message',
+    links: 'link',
+    attachments: 'attachment',
+    watchers: 'watcher',
+    item_progress: 'item_progress'
+  }
+
   const config = {
     entity: entity || '',
-    typeSlug: typeSlug || undefined,
+    typeSlug: typeSlug || (entity ? defaultTypeSlugs[entity] : undefined),
     icon: 'database',
     displayField: 'display_name',
     api: {
@@ -26,7 +114,22 @@ export function DataDetailPage() {
       updateAction: 'update'
     }
   }
+  // CIL[END chunk_id="DataDetailPage_config_1783929048"]
   
+  // CIL[BEGIN chunk_id="DataDetailPage_entityrecord_1783929048" type="variable_declaration" identity="entityRecord" parent="DataDetailPage_datadetailpage_1783929048"]
+// CIL[DOC-MACRO purpose="Fetch entity record and management functions"]
+// CIL[DOC-RESPONSIBILITY responsibility="Handle entityRecord"]
+// CIL[DOC-CONTEXT module="entityRecord" layer="unknown" related_files="[]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Implements entityRecord" 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 { 
     record, 
     fieldPermissions,
@@ -37,19 +140,79 @@ export function DataDetailPage() {
     delete: deleteRecord,
     saving,
     deleting
-  } = useEntityRecord(entity!, id, config)
+  } = useEntityRecord(entity!, recordId, config)
+  // CIL[END chunk_id="DataDetailPage_entityrecord_1783929048"]
   
+  // CIL[BEGIN chunk_id="DataDetailPage_schema_1783929048" type="variable_declaration" identity="schema" parent="DataDetailPage_datadetailpage_1783929048"]
+// CIL[DOC-MACRO purpose="Extract schema and view from record data"]
+// CIL[DOC-RESPONSIBILITY responsibility="Handle schema"]
+// CIL[DOC-CONTEXT module="schema" layer="unknown" related_files="[]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Implements schema" 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 schema = record?.design_schema || null
   const view = schema?.views?.default_detail || null
+  // CIL[END chunk_id="DataDetailPage_schema_1783929048"]
 
+  // CIL[BEGIN chunk_id="DataDetailPage_title_1783929048" type="variable_declaration" identity="title" parent="DataDetailPage_datadetailpage_1783929048"]
+// CIL[DOC-MACRO purpose="Generate display title for entity record"]
+// CIL[DOC-RESPONSIBILITY responsibility="Handle title"]
+// CIL[DOC-CONTEXT module="title" layer="unknown" related_files="[]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Implements title" 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 displayField = schema?.display_field || config.displayField
   const FALLBACK_FIELDS = ['full_name', 'display_name', 'name', 'title', 'slug', 'email']
   const recordTitle = record?.[displayField]
     ?? FALLBACK_FIELDS.map(f => record?.[f]).find(v => v != null)
     ?? 'Untitled'
+  // CIL[END chunk_id="DataDetailPage_title_1783929048"]
 
+  // CIL[BEGIN chunk_id="DataDetailPage_formdata_1783929048" type="variable_declaration" identity="formData" parent="DataDetailPage_datadetailpage_1783929048"]
+// CIL[DOC-MACRO purpose="Manage form state for entity editing"]
+// CIL[DOC-RESPONSIBILITY responsibility="Handle formData"]
+// CIL[DOC-CONTEXT module="formData" layer="unknown" related_files="[]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Implements formData" 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 [formData, setFormData] = useState<Record<string, any>>({})
+  // CIL[END chunk_id="DataDetailPage_formdata_1783929048"]
 
+  // CIL[BEGIN chunk_id="DataDetailPage_useeffect_1783929048" type="function" identity="useEffect" parent="DataDetailPage_datadetailpage_1783929048"]
+// CIL[DOC-MACRO purpose="Initialize form data when record loads or in create mode"]
+// CIL[DOC-RESPONSIBILITY responsibility="Handle useEffect"]
+// CIL[DOC-CONTEXT module="useEffect" layer="unknown" related_files="[]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Implements useEffect" 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"]
   useEffect(() => {
     if (record && view) {
       const initialData: Record<string, any> = {}
@@ -69,15 +232,60 @@ export function DataDetailPage() {
       setFormData({})
     }
   }, [record, isCreating, view, schema])
+  // CIL[END chunk_id="DataDetailPage_useeffect_1783929048"]
   
+  // CIL[BEGIN chunk_id="DataDetailPage_handlefieldchange_1783929048" type="function" identity="handleFieldChange" parent="DataDetailPage_datadetailpage_1783929048"]
+// CIL[DOC-MACRO purpose="Update form field value when user edits"]
+// CIL[DOC-RESPONSIBILITY responsibility="Handle handleFieldChange"]
+// CIL[DOC-CONTEXT module="handleFieldChange" layer="unknown" related_files="[]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Implements handleFieldChange" 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 handleFieldChange = (key: string, value: any) => {
     setFormData((prev) => ({ ...prev, [key]: value }))
   }
+  // CIL[END chunk_id="DataDetailPage_handlefieldchange_1783929048"]
   
+  // CIL[BEGIN chunk_id="DataDetailPage_handleedit_1783929048" type="function" identity="handleEdit" parent="DataDetailPage_datadetailpage_1783929048"]
+// CIL[DOC-MACRO purpose="Enable edit mode for the entity record"]
+// CIL[DOC-RESPONSIBILITY responsibility="Handle handleEdit"]
+// CIL[DOC-CONTEXT module="handleEdit" layer="unknown" related_files="[]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Implements handleEdit" 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 handleEdit = () => {
     setSearchParams({ edit: 'true' })
   }
+  // CIL[END chunk_id="DataDetailPage_handleedit_1783929048"]
   
+  // CIL[BEGIN chunk_id="DataDetailPage_handlecancel_1783929048" type="function" identity="handleCancel" parent="DataDetailPage_datadetailpage_1783929048"]
+// CIL[DOC-MACRO purpose="Handle cancel action with navigation or reset"]
+// CIL[DOC-RESPONSIBILITY responsibility="Handle handleCancel"]
+// CIL[DOC-CONTEXT module="handleCancel" layer="unknown" related_files="[]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Implements handleCancel" 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 handleCancel = () => {
     if (isCreating) {
       window.location.href = `/spine-framework/admin/runtime/${entity}`
@@ -100,7 +308,22 @@ export function DataDetailPage() {
       }
     }
   }
+  // CIL[END chunk_id="DataDetailPage_handlecancel_1783929048"]
   
+  // CIL[BEGIN chunk_id="DataDetailPage_handlesave_1783929048" type="function" identity="handleSave" parent="DataDetailPage_datadetailpage_1783929048"]
+// CIL[DOC-MACRO purpose="Save entity record and handle navigation after save"]
+// CIL[DOC-RESPONSIBILITY responsibility="Handle handleSave"]
+// CIL[DOC-CONTEXT module="handleSave" layer="unknown" related_files="[]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Implements handleSave" 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 handleSave = async () => {
     await save(formData)
     if (!isCreating) {
@@ -109,14 +332,44 @@ export function DataDetailPage() {
       window.location.href = `/spine-framework/admin/runtime/${entity}`
     }
   }
+  // CIL[END chunk_id="DataDetailPage_handlesave_1783929048"]
   
+  // CIL[BEGIN chunk_id="DataDetailPage_handledelete_1783929048" type="function" identity="handleDelete" parent="DataDetailPage_datadetailpage_1783929048"]
+// CIL[DOC-MACRO purpose="handleDelete"]
+// CIL[DOC-RESPONSIBILITY responsibility="Handle handleDelete"]
+// CIL[DOC-CONTEXT module="handleDelete" layer="unknown" related_files="[]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Implements handleDelete" 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 handleDelete = async () => {
     if (confirm(`Are you sure you want to delete this ${config?.entity?.slice(0, -1) || 'record'}?`)) {
       await deleteRecord()
       window.location.href = `/spine-framework/admin/runtime/${entity}`
     }
   }
+  // CIL[END chunk_id="DataDetailPage_handledelete_1783929048"]
   
+  // CIL[BEGIN chunk_id="DataDetailPage_loadingstate_1783929048" type="render_block" identity="loadingState" parent="DataDetailPage_datadetailpage_1783929048"]
+// CIL[DOC-MACRO purpose="Render loading skeleton for record fetching"]
+// 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>
@@ -128,7 +381,22 @@ export function DataDetailPage() {
       </Card>
     )
   }
+  // CIL[END chunk_id="DataDetailPage_loadingstate_1783929048"]
   
+  // CIL[BEGIN chunk_id="DataDetailPage_errorstate_1783929048" type="render_block" identity="errorState" parent="DataDetailPage_datadetailpage_1783929048"]
+// CIL[DOC-MACRO purpose="Render error state for record loading failures"]
+// CIL[DOC-RESPONSIBILITY responsibility="Handle errorState"]
+// CIL[DOC-CONTEXT module="errorState" layer="unknown" related_files="[]"]
+// 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: 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 || !schema || !view) {
     return (
       <Card>
@@ -139,7 +407,22 @@ export function DataDetailPage() {
       </Card>
     )
   }
+  // CIL[END chunk_id="DataDetailPage_errorstate_1783929048"]
   
+  // CIL[BEGIN chunk_id="DataDetailPage_mainrender_1783929048" type="render_block" identity="mainRender" parent="DataDetailPage_datadetailpage_1783929048"]
+// CIL[DOC-MACRO purpose="Render main detail page with header and form"]
+// CIL[DOC-RESPONSIBILITY responsibility="Handle mainRender"]
+// CIL[DOC-CONTEXT module="mainRender" layer="unknown" related_files="[]"]
+// 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: 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 (
     <div className="space-y-6">
       <DataDetailHeader
@@ -168,4 +451,6 @@ export function DataDetailPage() {
       />
     </div>
   )
+  // CIL[END chunk_id="DataDetailPage_mainrender_1783929048"]
 }
+// CIL[END chunk_id="DataDetailPage_datadetailpage_1783929048"]

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

@@ -1,3 +1,20 @@
+
+
+// CIL[BEGIN chunk_id="DataFilters_module_header_1783929048" type="module_header" identity="imports_and_types" parent="none"]
+// CIL[DOC-MACRO purpose="Import dependencies and define filter component types"]
+// CIL[DOC-RESPONSIBILITY responsibility="Manage imports and interface for data filters"]
+// 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/RolesPage.tsx\",\".framework/src/pages/admin/IntegrationsPage.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="types" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Imports EntityFilter type, UI components for filters" 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/RolesPage.tsx, .framework/src/pages/admin/IntegrationsPage.tsx, \."]
+// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
+// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
+// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 import { EntityFilter } from '../../types/types'
 import { Card, CardContent } from '../ui/card'
 import { Input } from '../ui/input'
@@ -11,14 +28,72 @@ interface DataFiltersProps {
   onChange: (values: Record<string, any>) => void
   onClear: () => void
 }
-
+// CIL[END chunk_id="DataFilters_module_header_1783929048"]
+// CIL[BEGIN chunk_id="DataFilters_datafilters_1783929048" type="function" identity="DataFilters" parent="none"]
+// CIL[DOC-MACRO purpose="Render filter UI with search, enum, and boolean inputs"]
+// CIL[DOC-RESPONSIBILITY responsibility="Display all filter controls and clear button"]
+// CIL[DOC-CONTEXT module="runtime" layer="frontend-component" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/src/pages/admin/RolesPage.tsx\",\".framework/src/components/ui/dialog.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="JSX filter card" errors="none" side_effects="calls handleFilterChange,onClear"]
+// CIL[DOC-MICRO logic_summary="Map filter types to UI components, show clear button when active" 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, .framework/src/components/ui/dialog.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"]
 export function DataFilters({ filters, values, onChange, onClear }: DataFiltersProps) {
+  // CIL[BEGIN chunk_id="DataFilters_handlefilterchange_1783929048" type="function" identity="handleFilterChange" parent="DataFilters_datafilters_1783929048"]
+// CIL[DOC-MACRO purpose="Update filter value and call onChange callback"]
+// CIL[DOC-RESPONSIBILITY responsibility="Handle handleFilterChange"]
+// 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\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="calls onChange"]
+// CIL[DOC-MICRO logic_summary="Merge new filter value with existing values and notify parent" 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/src/pages/admin/RolesPage.tsx, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .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 handleFilterChange = (key: string, value: any) => {
     onChange({ ...values, [key]: value })
   }
+  // CIL[END chunk_id="DataFilters_handlefilterchange_1783929048"]
   
+  // CIL[BEGIN chunk_id="DataFilters_hasactivefilters_1783929048" type="function" identity="hasActiveFilters" parent="DataFilters_datafilters_1783929048"]
+// CIL[DOC-MACRO purpose="Check if any filters have active values"]
+// CIL[DOC-RESPONSIBILITY responsibility="Handle hasActiveFilters"]
+// CIL[DOC-CONTEXT module="runtime" layer="frontend-component" related_files="[\".framework/migrations/015_simplify_apps_table.sql\",\".framework/src/pages/admin/RolesPage.tsx\",\".framework/migrations/025_retype_threads_messages.sql\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="boolean" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Check if any filter values are set (not empty/undefined/all)" 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/RolesPage.tsx, .framework/migrations/025_retype_threads_messages.sql, \."]
+// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
+// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
+// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
   const hasActiveFilters = Object.values(values).some(v => v !== undefined && v !== '' && v !== 'all')
+  // CIL[END chunk_id="DataFilters_hasactivefilters_1783929048"]
   
+  // CIL[BEGIN chunk_id="DataFilters_mainrender_1783929048" type="render_block" identity="mainRender" parent="DataFilters_datafilters_1783929048"]
+// CIL[DOC-MACRO purpose="Render filter UI with search, enum, and boolean inputs"]
+// CIL[DOC-RESPONSIBILITY responsibility="Handle mainRender"]
+// CIL[DOC-CONTEXT module="runtime" layer="frontend-component" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/src/pages/admin/RolesPage.tsx\",\".framework/src/components/ui/dialog.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="JSX filter card" errors="none" side_effects="calls handleFilterChange,onClear"]
+// CIL[DOC-MICRO logic_summary="Map filter types to UI components, show clear button when active" 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, .framework/src/components/ui/dialog.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"]
   return (
     <Card>
       <CardContent className="p-4">
@@ -88,4 +163,6 @@ export function DataFilters({ filters, values, onChange, onClear }: DataFiltersP
       </CardContent>
     </Card>
   )
+  // CIL[END chunk_id="DataFilters_mainrender_1783929048"]
 }
+// CIL[END chunk_id="DataFilters_datafilters_1783929048"]

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

@@ -1,43 +1,45 @@
-/**
- * @module src/components/runtime/DataHeader
- * @audience installer
- * @layer frontend-component
- * @stability stable
- *
- * Title bar for entity list pages. Renders an entity icon, title,
- * description, and a "New" button that navigates to the create route.
- * The icon name is resolved dynamically from `@heroicons/react`; falls
- * back to `CubeIcon` if the name is unrecognised.
- *
- * @seeAlso src/components/runtime/DataListPage.tsx (mounts this component)
- */
 
+
+// CIL[BEGIN chunk_id="DataHeader_module_header_1783929048" type="module_header" identity="imports_and_types" parent="none"]
+// CIL[DOC-MACRO purpose="Import dependencies and define header component types"]
+// CIL[DOC-RESPONSIBILITY responsibility="Manage imports and interface for data header"]
+// 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/src/pages/admin/IntegrationsPage.tsx\",\".framework/src/pages/admin/RolesPage.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="types" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Imports React, UI components, defines DataHeaderProps" 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/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 { Button } from '../ui/button'
 import * as Icons from 'lucide-react'
 
-/**
- * Props for `DataHeader`.
- *
- * @prop title - Entity name (displayed capitalised)
- * @prop icon - Heroicon name string (e.g. `'UserIcon'`)
- * @prop description - Short subtitle text
- * @prop newButtonHref - URL to navigate to when "New" is clicked
- */
 interface DataHeaderProps {
   title: string
   icon: string
   description: string
   newButtonHref: string
 }
-
-/**
- * Entity list page header with title, description, and new-record button.
- *
- * @param props - `DataHeaderProps`
- * @returns Header bar JSX
- * @sideEffects Navigates via `window.location.href` on button click
- */
+// CIL[END chunk_id="DataHeader_module_header_1783929048"]
+// CIL[BEGIN chunk_id="DataHeader_dataheader_1783929048" type="function" identity="DataHeader" parent="none"]
+// CIL[DOC-MACRO purpose="Render entity list header with title and new button"]
+// CIL[DOC-RESPONSIBILITY responsibility="Display header with icon, title, description, and create button"]
+// CIL[DOC-CONTEXT module="runtime" layer="frontend-component" related_files="[\".framework/src/components/ui/dialog.tsx\",\"custom/apps/portal/pages/ContentPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/src/pages/admin/RolesPage.tsx\",\".framework/functions/_shared/principal.ts\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="JSX header" errors="none" side_effects="navigation"]
+// CIL[DOC-MICRO logic_summary="Renders icon, title, description, and new button with navigation" 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/components/ui/dialog.tsx, custom/apps/portal/pages/ContentPage.tsx, custom/apps/cortex/pages/operations/OperationsDashboard.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 function DataHeader({ title, icon, description, newButtonHref }: DataHeaderProps) {
   // Dynamically get the icon component
   const IconComponent = (Icons as Record<string, React.ComponentType<{ className?: string }>>)[icon] || Icons.Box
@@ -66,3 +68,4 @@ export function DataHeader({ title, icon, description, newButtonHref }: DataHead
     </div>
   )
 }
+// CIL[END chunk_id="DataHeader_dataheader_1783929048"]