spine-framework 0.3.145 → 0.4.1

package/.framework/src/components/admin/SortableTableHeader.tsx

@@ -1,39 +1,31 @@
-
-
-
-// CIL[BEGIN chunk_id="SortableTableHeader_module_header_1783931090" type="module_header" identity="imports" parent="none"]
-// CIL[DOC-MACRO purpose="Import React and UI components for sortable table header"]
-// CIL[DOC-RESPONSIBILITY responsibility="Manage all external module imports for sortable header"]
-// CIL[DOC-CONTEXT module="SortableTableHeader" layer="component" related_files="[\".framework/src/components/ui/table-primitives.tsx\",\".framework/migrations/015_simplify_apps_table.sql\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\"custom/apps/portal/pages/ContentPage.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="Imported modules and icons" errors="Import failures" side_effects="Module loading"]
-// CIL[DOC-MICRO logic_summary="Imports React, chevron icons, and table head component" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[BEGIN stable_id="~/.framework/src/components/admin/SortableTableHeader.tsx:module_header:module_header" type="module_header" identity="module_header" parent=""]
+// CIL[DOC-MACRO purpose="Module header for the SortableTableHeader component: imports React, ChevronUp/ChevronDown icons, and the TableHead UI primitive"]
+// CIL[DOC-RESPONSIBILITY responsibility="Declare module-level imports required by the SortableTableHeader component"]
+// CIL[DOC-CONTEXT module="admin" layer="presentation" related_files=".framework/src/components/ui/table.tsx"]
+// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Imports React, ChevronUp/ChevronDown icons from lucide-react, and the TableHead component from shadcn table primitives" 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: component. Direct callers: 0. Direct calls: 0. Related files: .framework/src/components/ui/table-primitives.tsx, .framework/migrations/015_simplify_apps_table.sql, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, custom/apps/portal/pages/ContentPage.tsx, \."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
-// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
-// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[DOC-AUDIENCE audience="admin developers"]
 import React from 'react'
 import { ChevronUp, ChevronDown } from 'lucide-react'
 import { TableHead } from '../ui/table'
-// CIL[END chunk_id="SortableTableHeader_module_header_1783931090"]
-// CIL[BEGIN chunk_id="SortableTableHeader_interface_1783931090" type="interface" identity="SortableTableHeaderProps" parent="none"]
-// CIL[DOC-MACRO purpose="Define props interface for SortableTableHeader component"]
-// CIL[DOC-RESPONSIBILITY responsibility="Type definition for sortable header properties"]
-// CIL[DOC-CONTEXT module="SortableTableHeader" layer="component" related_files="[\".framework/functions/_shared/schema-utils.ts\",\".framework/src/components/ui/dialog.tsx\",\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/src/components/ui/table-primitives.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="Type interface" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Defines title, sort key, current sort state, and sort callback props" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="1.00" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: component. Direct callers: 0. Direct calls: 0. Related files: .framework/functions/_shared/schema-utils.ts, .framework/src/components/ui/dialog.tsx, custom/apps/portal/pages/ContentPage.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="context" content="purpose='Module header for the SortableTableHeader component: imports React, ChevronUp/ChevronDown icons, and the TableHead UI primitive'; No verified external callers; imports: .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/admin/SortableTableHeader.tsx:module_header:module_header"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/admin/SortableTableHeader.tsx:sortabletableheaderprops:interface" type="interface" identity="SortableTableHeaderProps" parent="SortableTableHeader"]
+// CIL[DOC-MACRO purpose="Props interface for the SortableTableHeader clickable table header component"]
+// CIL[DOC-RESPONSIBILITY responsibility="Define the typed contract consumed by SortableTableHeader"]
+// CIL[DOC-CONTEXT module="admin" layer="presentation" related_files=".framework/src/components/admin/SortableTableHeader.tsx,.framework/src/components/ui/table.tsx"]
+// CIL[DOC-CONTRACT inputs="title: string; sortKey: string; currentSortKey?: string; currentSortDirection?: 'asc' | 'desc'; onSort: (key: string) => void" outputs="interface type" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Describes props for a sortable column header including the current sort key, direction, and click handler" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 interface SortableTableHeaderProps {
   title: string
   sortKey: string
@@ -41,21 +33,22 @@ interface SortableTableHeaderProps {
   currentSortDirection?: 'asc' | 'desc'
   onSort: (key: string) => void
 }
-// CIL[END chunk_id="SortableTableHeader_interface_1783931090"]
-// CIL[BEGIN chunk_id="SortableTableHeader_sortabletableheader_1783931090" type="function" identity="SortableTableHeader" parent="none"]
-// CIL[DOC-MACRO purpose="Sortable table header component with click-to-sort functionality"]
-// CIL[DOC-RESPONSIBILITY responsibility="Render header with sorting indicators and click handlers"]
-// CIL[DOC-CONTEXT module="SortableTableHeader" layer="component" related_files="[\".framework/src/components/ui/table-primitives.tsx\",\".framework/migrations/015_simplify_apps_table.sql\",\".framework/src/components/ui/dialog.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="Sortable header JSX" errors="none" side_effects="Sort callback execution"]
-// CIL[DOC-MICRO logic_summary="Handles sort state, displays chevron indicators, manages click events" notable_decisions="['conditional_sort_indicators', 'click_to_sort']"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: component. Direct callers: 0. Direct calls: 0. Related files: .framework/src/components/ui/table-primitives.tsx, .framework/migrations/015_simplify_apps_table.sql, .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="context" content="purpose='Props interface for the SortableTableHeader clickable table header component'; No verified external callers; imports: .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/admin/SortableTableHeader.tsx:sortabletableheaderprops:interface"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/admin/SortableTableHeader.tsx:sortabletableheader:function" type="function" identity="SortableTableHeader" parent=""]
+// CIL[DOC-MACRO purpose="Renders a clickable table header cell that shows an ascending or descending sort indicator when active"]
+// CIL[DOC-RESPONSIBILITY responsibility="Render a sortable table column header with a visual direction indicator"]
+// CIL[DOC-CONTEXT module="admin" layer="presentation" related_files=".framework/src/components/admin/SortableTableHeader.tsx,.framework/src/components/ui/table.tsx"]
+// CIL[DOC-CONTRACT inputs="title: string, sortKey: string, currentSortKey?: string, currentSortDirection?: 'asc' | 'desc', onSort: (key: string) => void" outputs="JSX TableHead component with optional ChevronUp/ChevronDown icon" errors="none" side_effects="invokes onSort callback when the header is clicked"]
+// CIL[DOC-MICRO logic_summary="Computes whether this column is the active sort and the current ascending state, then renders a clickable TableHead with a chevron icon when sorted" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export function SortableTableHeader({
   title,
   sortKey,
@@ -65,7 +58,7 @@ export function SortableTableHeader({
 }: SortableTableHeaderProps) {
   const isSorted = currentSortKey === sortKey
   const isAscending = currentSortDirection === 'asc'
-  
+
   return (
     <TableHead
       className="cursor-pointer"
@@ -86,4 +79,10 @@ export function SortableTableHeader({
     </TableHead>
   )
 }
-// CIL[END chunk_id="SortableTableHeader_sortabletableheader_1783931090"]
+// CIL[DOC-VECTOR type="context" content="purpose='Renders a clickable table header cell that shows an ascending or descending sort indicator when active'; No verified external callers; imports: .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/admin/SortableTableHeader.tsx:sortabletableheader:function"]

package/.framework/src/components/app-shell/GenericAppShell.tsx

@@ -1,43 +1,33 @@
-
-
-
-
-
-// CIL[BEGIN chunk_id="genericappshell_module_header_1783930597" type="module_header" identity="imports" parent="none"]
-// CIL[DOC-MACRO purpose="Import React hooks and routing components for app shell"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide state management and routing dependencies"]
-// CIL[DOC-CONTEXT module="generic-app-shell" layer="frontend-component" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/migrations/015_simplify_apps_table.sql\",\".framework/src/components/ui/dialog.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="Imported modules" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Imports React hooks, routing components, and app-specific pages" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[BEGIN stable_id="~/.framework/src/components/app-shell/GenericAppShell.tsx:module_header:module_header" type="module_header" identity="module_header" parent="none"]
+// CIL[DOC-MACRO purpose="Module imports and re-exports for the GenericAppShell component"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide React hooks, router utilities, app types, and child page components used by the app shell"]
+// CIL[DOC-CONTEXT module="app-shell" layer="ui" related_files=".framework/src/components/app-shell/GenericDetailPage.tsx,.framework/src/components/app-shell/GenericListPage.tsx,.framework/src/hooks/useApps.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="imported types and components" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Collects module-level imports (React hooks, react-router-dom, app record type, list/detail pages) that the GenericAppShell chunk consumes." 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, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .framework/migrations/015_simplify_apps_table.sql, .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"]
+// CIL[DOC-AUDIENCE audience="spine"]
 import { useState } from 'react'
 import { Routes, Route, Navigate, useNavigate, useLocation } from 'react-router-dom'
 import { AppRecord } from '../../hooks/useApps'
 import { GenericListPage } from './GenericListPage'
 import { GenericDetailPage } from './GenericDetailPage'
-// CIL[END chunk_id="genericappshell_module_header_1783930597"]
-// CIL[BEGIN chunk_id="genericappshell_navitem_1783930597" type="interface" identity="NavItem" parent="none"]
-// CIL[DOC-MACRO purpose="Define navigation item structure for app shell"]
-// CIL[DOC-RESPONSIBILITY responsibility="Specify navigation properties and routing metadata"]
-// CIL[DOC-CONTEXT module="generic-app-shell" layer="frontend-component" related_files="[\".framework/migrations/015_simplify_apps_table.sql\",\".framework/src/pages/admin/IntegrationsPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\"custom/apps/portal/pages/ContentPage.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="Type definition" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Interface with id, label, path, and optional type/view metadata" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: frontend-component. Direct callers: 0. Direct calls: 0. Related files: .framework/migrations/015_simplify_apps_table.sql, .framework/src/pages/admin/IntegrationsPage.tsx, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, custom/apps/portal/pages/ContentPage.tsx, \."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="context" content="purpose='Module imports and re-exports for the GenericAppShell component'; No verified external callers; imports: .framework/src/hooks/useApps.ts,.framework/src/components/app-shell/GenericListPage.tsx,.framework/src/components/app-shell/GenericDetailPage.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/app-shell/GenericAppShell.tsx:module_header:module_header"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/app-shell/GenericAppShell.tsx:NavItem:interface" type="interface" identity="NavItem" parent="~/.framework/src/components/app-shell/GenericAppShell.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Describe a single navigation item in the generic app shell"]
+// CIL[DOC-RESPONSIBILITY responsibility="Declare the NavItem contract used by the sidebar and route generation"]
+// CIL[DOC-CONTEXT module="app-shell" layer="ui" related_files=".framework/src/components/app-shell/GenericAppShell.tsx,.framework/src/components/app-shell/GenericDetailPage.tsx,.framework/src/components/app-shell/GenericListPage.tsx,.framework/src/hooks/useApps.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="NavItem interface" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="TypeScript interface with id, label, icon, path, type_slug, view, and min_role fields that define a sidebar entry." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 interface NavItem {
   id: string
   label: string
@@ -47,39 +37,41 @@ interface NavItem {
   view?: string
   min_role?: string
 }
-// CIL[END chunk_id="genericappshell_navitem_1783930597"]
-// CIL[BEGIN chunk_id="genericappshell_genericappshellprops_1783930597" type="interface" identity="GenericAppShellProps" parent="none"]
-// CIL[DOC-MACRO purpose="Define props interface for generic app shell component"]
-// CIL[DOC-RESPONSIBILITY responsibility="Specify app configuration input for shell"]
-// CIL[DOC-CONTEXT module="generic-app-shell" layer="frontend-component" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/migrations/015_simplify_apps_table.sql\",\".framework/functions/_shared/schema-utils.ts\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="Type definition" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Simple interface requiring app record with navigation configuration" 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/015_simplify_apps_table.sql, .framework/functions/_shared/schema-utils.ts, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, \."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="context" content="purpose='Describe a single navigation item in the generic app shell'; No verified external callers; imports: .framework/src/hooks/useApps.ts,.framework/src/components/app-shell/GenericListPage.tsx,.framework/src/components/app-shell/GenericDetailPage.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/app-shell/GenericAppShell.tsx:NavItem:interface"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/app-shell/GenericAppShell.tsx:GenericAppShellProps:interface" type="interface" identity="GenericAppShellProps" parent="~/.framework/src/components/app-shell/GenericAppShell.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Declare props for the GenericAppShell component"]
+// CIL[DOC-RESPONSIBILITY responsibility="Type the app record passed to GenericAppShell"]
+// CIL[DOC-CONTEXT module="app-shell" layer="ui" related_files=".framework/src/components/app-shell/GenericAppShell.tsx,.framework/src/components/app-shell/GenericDetailPage.tsx,.framework/src/components/app-shell/GenericListPage.tsx,.framework/src/hooks/useApps.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="GenericAppShellProps interface" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Contains a single app prop of type AppRecord consumed by GenericAppShell." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 interface GenericAppShellProps {
   app: AppRecord
 }
-// CIL[END chunk_id="genericappshell_genericappshellprops_1783930597"]
-// CIL[BEGIN chunk_id="genericappshell_genericappshell_1783930597" type="function" identity="GenericAppShell" parent="none"]
-// CIL[DOC-MACRO purpose="Data-driven app shell with sidebar navigation and routing"]
-// CIL[DOC-RESPONSIBILITY responsibility="Create complete app layout from app configuration"]
-// CIL[DOC-CONTEXT module="generic-app-shell" layer="frontend-component" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/migrations/015_simplify_apps_table.sql\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\"custom/apps/cortex/functions/custom_cil-embeddings.ts\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="JSX app shell with routes" errors="none" side_effects="Renders navigation, handles routing, manages sidebar state"]
-// CIL[DOC-MICRO logic_summary="Builds sidebar from nav_items, generates routes for list/detail pages, handles mobile responsiveness" 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/015_simplify_apps_table.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="context" content="purpose='Declare props for the GenericAppShell component'; No verified external callers; imports: .framework/src/hooks/useApps.ts,.framework/src/components/app-shell/GenericListPage.tsx,.framework/src/components/app-shell/GenericDetailPage.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/app-shell/GenericAppShell.tsx:GenericAppShellProps:interface"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/app-shell/GenericAppShell.tsx:GenericAppShell:component" type="component" identity="GenericAppShell" parent="~/.framework/src/components/app-shell/GenericAppShell.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Render a responsive generic app shell with sidebar navigation and dynamic routes"]
+// CIL[DOC-RESPONSIBILITY responsibility="Render the app layout, sidebar nav, and list/detail routes for a generic app record"]
+// CIL[DOC-CONTEXT module="app-shell" layer="ui" related_files=".framework/src/components/app-shell/GenericAppShell.tsx,.framework/src/components/app-shell/GenericDetailPage.tsx,.framework/src/components/app-shell/GenericListPage.tsx,.framework/src/hooks/useApps.ts"]
+// CIL[DOC-CONTRACT inputs="app: AppRecord" outputs="JSX layout with sidebar and Routes for list/new/detail" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Builds nav items from app.nav_items, detects active routes, manages mobile sidebar state, and generates Route components for list, new, and detail views." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export function GenericAppShell({ app }: GenericAppShellProps) {
   const navigate = useNavigate()
   const location = useLocation()
@@ -106,12 +98,7 @@ export function GenericAppShell({ app }: GenericAppShellProps) {
         ${sidebarOpen ? 'translate-x-0' : '-translate-x-full'}
       `}>
         <div className="flex items-center gap-3 h-16 px-6 border-b border-slate-200">
-          {app.icon && (
-            <div className={`w-8 h-8 rounded-lg flex items-center justify-center text-white text-sm font-bold`}
-              style={{ backgroundColor: app.color || '#475569' }}>
-              {app.name.charAt(0).toUpperCase()}
-            </div>
-          )}
+          <img src="/spine-logo.svg" alt="Spine Framework" className="h-8 w-auto shrink-0" />
           <div>
             <h2 className="font-semibold text-slate-900 text-sm">{app.name}</h2>
             {app.description && (
@@ -178,10 +165,14 @@ export function GenericAppShell({ app }: GenericAppShellProps) {
             {/* Generate list + detail routes for each nav item with type_slug */}
             {navItems.filter(item => item.type_slug).map(item => {
               
+
+
+
               const relativePath = item.path.startsWith(prefix)
                 ? item.path.slice(prefix.length).replace(/^\//, '')
                 : item.path.replace(/^\//, '')
 
+
               return [
                 <Route
                   key={`${item.id}-list`}
@@ -194,6 +185,8 @@ export function GenericAppShell({ app }: GenericAppShellProps) {
                       detailPath={`${relativePath}`}
                     />
                   }
+
+
                 />,
                 <Route
                   key={`${item.id}-new`}
@@ -236,4 +229,10 @@ export function GenericAppShell({ app }: GenericAppShellProps) {
     </div>
   )
 }
-// CIL[END chunk_id="genericappshell_genericappshell_1783930597"]
+// CIL[DOC-VECTOR type="context" content="purpose='Render a responsive generic app shell with sidebar navigation and dynamic routes'; No verified external callers; imports: .framework/src/hooks/useApps.ts,.framework/src/components/app-shell/GenericListPage.tsx,.framework/src/components/app-shell/GenericDetailPage.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/app-shell/GenericAppShell.tsx:GenericAppShell:component"]

package/.framework/src/components/app-shell/GenericDetailPage.tsx

@@ -1,64 +1,55 @@
-
-
-
-
-// CIL[BEGIN chunk_id="genericdetailpage_module_header_1783930597" type="module_header" identity="imports" parent="none"]
-// CIL[DOC-MACRO purpose="Import React hooks and routing components for detail page"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide state management and navigation dependencies"]
-// CIL[DOC-CONTEXT module="generic-detail-page" 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/pages/admin/RolesPage.tsx\",\".framework/src/components/ui/dialog.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="Imported modules" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Imports React hooks, routing components, and entity record hook" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[BEGIN stable_id="~/.framework/src/components/app-shell/GenericDetailPage.tsx:module_header:module_header" type="module_header" identity="module_header" parent="~/.framework/src/components/app-shell/GenericDetailPage.tsx"]
+// CIL[DOC-MACRO purpose="Imports and module setup for the generic detail page"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide dependencies for GenericDetailPage rendering"]
+// CIL[DOC-CONTEXT module="app-shell" layer="framework" related_files=".framework/src/components/runtime/DataDetailHeader.tsx,.framework/src/components/runtime/SchemaDetailForm.tsx,.framework/src/hooks/useEntityRecord.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Imports hooks and UI subcomponents used by the detail page" 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, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .framework/src/pages/admin/TypeDetailPage.tsx, .framework/src/pages/admin/RolesPage.tsx, .framework/src/components/ui/dialog.tsx, \."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
-// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
-// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[DOC-AUDIENCE audience="framework"]
+
 import { useState, useEffect } from 'react'
 import { useParams, useSearchParams, useNavigate } from 'react-router-dom'
 import { useEntityRecord } from '../../hooks/useEntityRecord'
 import { DataDetailHeader } from '../runtime/DataDetailHeader'
 import { SchemaDetailForm } from '../runtime/SchemaDetailForm'
-// CIL[END chunk_id="genericdetailpage_module_header_1783930597"]
-// CIL[BEGIN chunk_id="genericdetailpage_genericdetailpageprops_1783930597" type="interface" identity="GenericDetailPageProps" parent="none"]
-// CIL[DOC-MACRO purpose="Define props interface for generic detail page component"]
-// CIL[DOC-RESPONSIBILITY responsibility="Specify configuration for schema-driven detail display"]
-// CIL[DOC-CONTEXT module="generic-detail-page" layer="frontend-component" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/functions/_shared/schema-utils.ts\",\".framework/src/pages/admin/IntegrationsPage.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="Type definition" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Interface with type slug, optional view, and creation mode flag" 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, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .framework/functions/_shared/schema-utils.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="context" content="purpose='Imports and module setup for the generic detail page'; No verified external callers; imports: .framework/src/hooks/useEntityRecord.ts,.framework/src/components/runtime/DataDetailHeader.tsx,.framework/src/components/runtime/SchemaDetailForm.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/app-shell/GenericDetailPage.tsx:module_header:module_header"]
+// CIL[BEGIN stable_id="~/.framework/src/components/app-shell/GenericDetailPage.tsx:GenericDetailPageProps:interface" type="interface" identity="GenericDetailPageProps" parent="~/.framework/src/components/app-shell/GenericDetailPage.tsx"]
+// CIL[DOC-MACRO purpose="Props interface for GenericDetailPage"]
+// CIL[DOC-RESPONSIBILITY responsibility="Define the expected props for the detail page"]
+// CIL[DOC-CONTEXT module="app-shell" layer="framework" related_files=".framework/src/components/app-shell/GenericDetailPage.tsx,.framework/src/components/runtime/DataDetailHeader.tsx,.framework/src/components/runtime/SchemaDetailForm.tsx,.framework/src/hooks/useEntityRecord.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="TypeScript interface describing typeSlug, viewSlug, and isCreating" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 interface GenericDetailPageProps {
   typeSlug: string
   viewSlug?: string
   isCreating?: boolean
 }
-// CIL[END chunk_id="genericdetailpage_genericdetailpageprops_1783930597"]
-// CIL[BEGIN chunk_id="genericdetailpage_genericdetailpage_1783930597" type="function" identity="GenericDetailPage" parent="none"]
-// CIL[DOC-LEARNING topic="runtime-type:generic/detail_view" content="GenericDetailPage renders record.design_schema.views.default_detail.sections. Each section has a title and a fields map. field.system=true means the value is read from the record row; otherwise from record.data. FieldRenderer uses field.data_type and the view's display_type to choose the widget."]
-// CIL[DOC-NOTE type="design_schema_caveat" content="Without views.default_detail or fields missing from the schema, the detail page will be blank. The page falls back to useSchemaRecord defaults only for new records."]
-// CIL[DOC-MACRO purpose="Schema-driven detail page with form for create/edit/view"]
-// CIL[DOC-RESPONSIBILITY responsibility="Handle CRUD operations and form state for entity records"]
-// CIL[DOC-CONTEXT module="generic-detail-page" 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/pages/admin/IntegrationsPage.tsx\",\".framework/src/pages/admin/RolesPage.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="JSX detail page with form" errors="Loading/saving errors" side_effects="Data fetching, form state management, navigation"]
-// CIL[DOC-MICRO logic_summary="Manages record CRUD, form state, edit modes, renders runtime 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: .framework/src/pages/admin/TypeDetailPage.tsx, custom/apps/portal/pages/ContentPage.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="context" content="purpose='Props interface for GenericDetailPage'; No verified external callers; imports: .framework/src/hooks/useEntityRecord.ts,.framework/src/components/runtime/DataDetailHeader.tsx,.framework/src/components/runtime/SchemaDetailForm.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/app-shell/GenericDetailPage.tsx:GenericDetailPageProps:interface"]
+
+
+// CIL[BEGIN stable_id="~/.framework/src/components/app-shell/GenericDetailPage.tsx:GenericDetailPage:component" type="component" identity="GenericDetailPage" parent="~/.framework/src/components/app-shell/GenericDetailPage.tsx"]
+// CIL[DOC-MACRO purpose="Render the generic detail page for an app type"]
+// CIL[DOC-RESPONSIBILITY responsibility="Display, edit, create, and delete records driven by a design schema"]
+// CIL[DOC-CONTEXT module="app-shell" layer="framework" related_files=".framework/src/components/app-shell/GenericDetailPage.tsx,.framework/src/components/runtime/DataDetailHeader.tsx,.framework/src/components/runtime/SchemaDetailForm.tsx,.framework/src/hooks/useEntityRecord.ts"]
+// CIL[DOC-CONTRACT inputs="typeSlug: string, viewSlug?: string, isCreating?: boolean" outputs="JSX.Element" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Load record with useEntityRecord, resolve detail view, initialize form data, and render DataDetailHeader and SchemaDetailForm" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export function GenericDetailPage({ typeSlug, viewSlug, isCreating: forceCreate }: GenericDetailPageProps) {
   const { id } = useParams<{ id: string }>()
   const navigate = useNavigate()
@@ -242,4 +233,10 @@ export function GenericDetailPage({ typeSlug, viewSlug, isCreating: forceCreate
     </div>
   )
 }
-// CIL[END chunk_id="genericdetailpage_genericdetailpage_1783930597"]
+// CIL[DOC-VECTOR type="context" content="purpose='Render the generic detail page for an app type'; No verified external callers; imports: .framework/src/hooks/useEntityRecord.ts,.framework/src/components/runtime/DataDetailHeader.tsx,.framework/src/components/runtime/SchemaDetailForm.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/app-shell/GenericDetailPage.tsx:GenericDetailPage:component"]