spine-framework 0.3.145 → 0.4.0

package/.framework/src/components/layout/Sidebar.tsx

@@ -1,3 +1,13 @@
+// CIL[BEGIN stable_id="~/.framework/src/components/layout/Sidebar.tsx:module_header:module_header" type="module_header" identity="module_header" parent="none"]
+// CIL[DOC-MACRO purpose="Sidebar layout module entry point"]
+// CIL[DOC-RESPONSIBILITY responsibility="Import dependencies and export Sidebar components and navigation constants"]
+// CIL[DOC-CONTEXT module=".framework/src/components/layout/Sidebar.tsx" layer="ui" related_files=".framework/src/components/ui/popover.tsx,.framework/src/contexts/AuthContext.tsx"]
+// CIL[DOC-CONTRACT inputs="none" outputs="module exports, imports, and navigation constants" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Sets up the sidebar module and declares navigation arrays" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-AUDIENCE audience="engineers"]
+
 
 
 
@@ -5,21 +15,6 @@
 
 
 
-// CIL[BEGIN chunk_id="sidebar_moduleheader_1783929861" type="module_header" identity="imports" parent="none"]
-// CIL[DOC-MACRO purpose="Import React hooks, router, auth, UI components and navigation icons"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide all dependencies for sidebar navigation system"]
-// CIL[DOC-CONTEXT module="src/components/layout/Sidebar" 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/RolesPage.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="React hooks, router, auth, UI components, icons" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Imports useState, Link, useLocation, useAuth, Popover components and 20+ Lucide icons" 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/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 } from 'react'
 import { Link, useLocation } from 'react-router-dom'
 import { useAuth } from '../../contexts/AuthContext'
@@ -51,44 +46,66 @@ import {
   Cpu,
   BookOpen
 } from 'lucide-react'
-// CIL[END chunk_id="sidebar_moduleheader_1783929861"]
-// CIL[BEGIN chunk_id="sidebar_sidebarprops_1783929861" type="interface" identity="SidebarProps" parent="none"]
-// CIL[DOC-MACRO purpose="Define props interface for mobile overlay Sidebar component"]
-// CIL[DOC-RESPONSIBILITY responsibility="Specify Sidebar component contract for mobile overlay"]
-// CIL[DOC-CONTEXT module="src/components/layout/Sidebar" layer="frontend-component" related_files="[\".framework/functions/_shared/schema-utils.ts\",\".framework/src/components/ui/dialog.tsx\",\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/functions/_shared/principal.ts\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="SidebarProps interface" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Interface with open state and close callback for mobile sidebar" 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/schema-utils.ts, .framework/src/components/ui/dialog.tsx, custom/apps/portal/pages/ContentPage.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='Sidebar layout module entry point'; No verified external callers; imports: .framework/src/contexts/AuthContext.tsx,.framework/src/components/ui/popover.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/layout/Sidebar.tsx:module_header:module_header"]
+// CIL[BEGIN stable_id="~/.framework/src/components/layout/Sidebar.tsx:sidebarprops:interface" type="interface" identity="sidebarprops" parent="~/.framework/src/components/layout/Sidebar.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Define Sidebar component props"]
+// CIL[DOC-RESPONSIBILITY responsibility="Type-safe contract for Sidebar open state and close callback"]
+// CIL[DOC-CONTEXT module=".framework/src/components/layout/Sidebar.tsx" layer="ui" related_files=".framework/src/components/layout/Sidebar.tsx,.framework/src/components/ui/popover.tsx,.framework/src/contexts/AuthContext.tsx"]
+// CIL[DOC-CONTRACT inputs="open boolean and onClose callback" outputs="SidebarProps interface" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Declares open and onClose fields for the Sidebar shell" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 interface SidebarProps {
   open: boolean
   onClose: () => void
 }
-// CIL[END chunk_id="sidebar_sidebarprops_1783929861"]
-// CIL[BEGIN chunk_id="sidebar_constants_1783929861" type="constants" identity="navigation" parent="none"]
-// CIL[DOC-MACRO purpose="Define navigation arrays for sidebar menu sections and links"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide navigation structure for admin interface"]
-// CIL[DOC-CONTEXT module="src/components/layout/Sidebar" layer="frontend-component" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/functions/_shared/principal.ts\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/functions/_shared/schema-utils.ts\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="navigation constants arrays" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Main nav, configs, observability, and runtime entity navigation arrays with icons" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: frontend-component. Direct callers: 0. Direct calls: 0. Related files: custom/apps/portal/pages/ContentPage.tsx, .framework/functions/_shared/principal.ts, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .framework/functions/_shared/schema-utils.ts, \."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="context" content="purpose='Define Sidebar component props'; No verified external callers; imports: .framework/src/contexts/AuthContext.tsx,.framework/src/components/ui/popover.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/layout/Sidebar.tsx:sidebarprops:interface"]
+
+
+
+// CIL[BEGIN stable_id="~/.framework/src/components/layout/Sidebar.tsx:navigation:constant" type="constant" identity="navigation" parent="~/.framework/src/components/layout/Sidebar.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Primary navigation links for the sidebar"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide top-level navigation item data"]
+// CIL[DOC-CONTEXT module=".framework/src/components/layout/Sidebar.tsx" layer="ui" related_files=".framework/src/components/layout/Sidebar.tsx,.framework/src/components/ui/popover.tsx,.framework/src/contexts/AuthContext.tsx"]
+// CIL[DOC-CONTRACT inputs="none" outputs="array of navigation entries" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Static constant array of top-level navigation objects with name, href, and icon" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 const navigation = [
   { name: 'Dashboard', href: '/spine-framework/admin/configs/types', icon: Home },
 ]
+// CIL[DOC-VECTOR type="context" content="purpose='Primary navigation links for the sidebar'; No verified external callers; imports: .framework/src/contexts/AuthContext.tsx,.framework/src/components/ui/popover.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/layout/Sidebar.tsx:navigation:constant"]
+
+
+
 
+
+// CIL[BEGIN stable_id="~/.framework/src/components/layout/Sidebar.tsx:configsnavigation:constant" type="constant" identity="configsnavigation" parent="~/.framework/src/components/layout/Sidebar.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Configuration section navigation links"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide navigation data for the admin configuration section"]
+// CIL[DOC-CONTEXT module=".framework/src/components/layout/Sidebar.tsx" layer="ui" related_files=".framework/src/components/layout/Sidebar.tsx,.framework/src/components/ui/popover.tsx,.framework/src/contexts/AuthContext.tsx"]
+// CIL[DOC-CONTRACT inputs="none" outputs="array of config navigation entries" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Static array of config navigation items with dividers and icons" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 const configsNavigation = [
   { name: 'Item Types', href: '/spine-framework/admin/configs/types', icon: Box },
   { divider: true },
@@ -106,58 +123,131 @@ const configsNavigation = [
   { name: 'API Keys', href: '/spine-framework/admin/configs/api-keys', icon: Key },
   { name: 'Deliveries', href: '/spine-framework/admin/configs/deliveries', icon: Truck },
 ] as const
+// CIL[DOC-VECTOR type="context" content="purpose='Configuration section navigation links'; No verified external callers; imports: .framework/src/contexts/AuthContext.tsx,.framework/src/components/ui/popover.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/layout/Sidebar.tsx:configsnavigation:constant"]
+
+
+
+
 
+// CIL[BEGIN stable_id="~/.framework/src/components/layout/Sidebar.tsx:observabilitynavigation:constant" type="constant" identity="observabilitynavigation" parent="~/.framework/src/components/layout/Sidebar.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Observability section navigation links"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide navigation data for the observability section"]
+// CIL[DOC-CONTEXT module=".framework/src/components/layout/Sidebar.tsx" layer="ui" related_files=".framework/src/components/layout/Sidebar.tsx,.framework/src/components/ui/popover.tsx,.framework/src/contexts/AuthContext.tsx"]
+// CIL[DOC-CONTRACT inputs="none" outputs="array of observability navigation entries" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Static array of observability navigation items with icons" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 const observabilityNavigation = [
   { name: 'Dashboard', href: '/spine-framework/admin/observability', icon: BarChart3 },
   { name: 'Alerts', href: '/spine-framework/admin/observability/alerts', icon: Bell },
   { name: 'Executions', href: '/spine-framework/admin/observability/executions', icon: FlaskConical },
   { name: 'Logs', href: '/spine-framework/admin/observability/logs', icon: FileText },
 ]
+// CIL[DOC-VECTOR type="context" content="purpose='Observability section navigation links'; No verified external callers; imports: .framework/src/contexts/AuthContext.tsx,.framework/src/components/ui/popover.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/layout/Sidebar.tsx:observabilitynavigation:constant"]
+
 
+
+
+
+// CIL[BEGIN stable_id="~/.framework/src/components/layout/Sidebar.tsx:runtimeentities:constant" type="constant" identity="runtimeentities" parent="~/.framework/src/components/layout/Sidebar.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Runtime entity navigation links"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide navigation data for runtime entities section"]
+// CIL[DOC-CONTEXT module=".framework/src/components/layout/Sidebar.tsx" layer="ui" related_files=".framework/src/components/layout/Sidebar.tsx,.framework/src/components/ui/popover.tsx,.framework/src/contexts/AuthContext.tsx"]
+// CIL[DOC-CONTRACT inputs="none" outputs="array of runtime entity navigation entries" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Static array of runtime entity navigation items with icons" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 const runtimeEntities = [
   { name: 'Items', href: '/spine-framework/admin/runtime/items', icon: Box },
   { name: 'Accounts', href: '/spine-framework/admin/runtime/accounts', icon: Building2 },
   { name: 'People', href: '/spine-framework/admin/runtime/people', icon: User },
   { name: 'Person Types', href: '/spine-framework/admin/runtime/person-types', icon: Users },
 ]
+// CIL[DOC-VECTOR type="context" content="purpose='Runtime entity navigation links'; No verified external callers; imports: .framework/src/contexts/AuthContext.tsx,.framework/src/components/ui/popover.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/layout/Sidebar.tsx:runtimeentities:constant"]
+
+
 
+
+
+// CIL[BEGIN stable_id="~/.framework/src/components/layout/Sidebar.tsx:kbenginenavigation:constant" type="constant" identity="kbenginenavigation" parent="~/.framework/src/components/layout/Sidebar.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Knowledge base engine navigation links"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide navigation data for the KB engine section"]
+// CIL[DOC-CONTEXT module=".framework/src/components/layout/Sidebar.tsx" layer="ui" related_files=".framework/src/components/layout/Sidebar.tsx,.framework/src/components/ui/popover.tsx,.framework/src/contexts/AuthContext.tsx"]
+// CIL[DOC-CONTRACT inputs="none" outputs="array of KB engine navigation entries" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Static array of KB engine navigation items with icons" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 const kbEngineNavigation = [
   { name: 'Knowledge Base', href: '/spine-framework/admin/kb/kb-spine-public', icon: BookOpen },
   { name: 'Embeddings', href: '/spine-framework/admin/kb/embeddings', icon: Cpu },
 ]
-// CIL[END chunk_id="sidebar_constants_1783929861"]
-// CIL[BEGIN chunk_id="sidebar_classnames_1783929861" type="function" identity="classNames" parent="none"]
-// CIL[DOC-MACRO purpose="Utility function to combine CSS class names, filtering falsy values"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide CSS class name concatenation utility"]
-// CIL[DOC-CONTEXT module="src/components/layout/Sidebar" layer="frontend-component" related_files="[\"custom/apps/cortex/functions/custom_cil-embeddings.ts\",\".framework/migrations/025_retype_threads_messages.sql\",\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/functions/_shared/principal.ts\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="concatenated class string" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Filters Boolean values and joins with spaces for Tailwind CSS" 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/cortex/functions/custom_cil-embeddings.ts, .framework/migrations/025_retype_threads_messages.sql, custom/apps/portal/pages/ContentPage.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="context" content="purpose='Knowledge base engine navigation links'; No verified external callers; imports: .framework/src/contexts/AuthContext.tsx,.framework/src/components/ui/popover.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/layout/Sidebar.tsx:kbenginenavigation:constant"]
+
+
+// CIL[BEGIN stable_id="~/.framework/src/components/layout/Sidebar.tsx:classnames:function" type="function" identity="classnames" parent="~/.framework/src/components/layout/Sidebar.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Conditionally combine CSS class strings"]
+// CIL[DOC-RESPONSIBILITY responsibility="Filter falsy class values and join remaining classes"]
+// CIL[DOC-CONTEXT module=".framework/src/components/layout/Sidebar.tsx" layer="ui" related_files=".framework/src/components/layout/Sidebar.tsx,.framework/src/components/ui/popover.tsx,.framework/src/contexts/AuthContext.tsx"]
+// CIL[DOC-CONTRACT inputs="classes: (string | false | undefined)[]" outputs="space-delimited className string" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Filters truthy values from the input array and joins them with spaces" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-NOTE type="param" content="classes: (string | false | undefined)[] - class values to combine"]
 function classNames(...classes: (string | false | undefined)[]) {
   return classes.filter(Boolean).join(' ')
 }
-// CIL[END chunk_id="sidebar_classnames_1783929861"]
-// CIL[BEGIN chunk_id="sidebar_sidebar_1783929861" type="function" identity="Sidebar" parent="none"]
-// CIL[DOC-MACRO purpose="Render mobile overlay sidebar with backdrop and close functionality"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide mobile sidebar overlay with backdrop and close button"]
-// CIL[DOC-CONTEXT module="src/components/layout/Sidebar" 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="JSX overlay sidebar" errors="none" side_effects="Calls onClose when backdrop or close button clicked"]
-// CIL[DOC-MICRO logic_summary="Conditional overlay with backdrop, close button, and SidebarContent" 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, \."]
-// 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='Conditionally combine CSS class strings'; No verified external callers; imports: .framework/src/contexts/AuthContext.tsx,.framework/src/components/ui/popover.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/layout/Sidebar.tsx:classnames:function"]
+
+
+
+
+
+
+// CIL[BEGIN stable_id="~/.framework/src/components/layout/Sidebar.tsx:sidebar:function" type="function" identity="sidebar" parent="~/.framework/src/components/layout/Sidebar.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Render responsive sidebar shell"]
+// CIL[DOC-RESPONSIBILITY responsibility="Display a mobile-friendly sidebar overlay with close controls"]
+// CIL[DOC-CONTEXT module=".framework/src/components/layout/Sidebar.tsx" layer="ui" related_files=".framework/src/components/layout/Sidebar.tsx,.framework/src/components/ui/popover.tsx,.framework/src/contexts/AuthContext.tsx"]
+// CIL[DOC-CONTRACT inputs="open: boolean, onClose: () => void" outputs="JSX sidebar overlay" errors="none" side_effects="renders DOM elements and attaches click handlers"]
+// CIL[DOC-MICRO logic_summary="Renders a fixed overlay and panel when open is true, delegating content to SidebarContent" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-NOTE type="param" content="open: boolean - whether the sidebar is open"]
+// CIL[DOC-NOTE type="param" content="onClose: () => void - callback to close the sidebar"]
 export function Sidebar({ open, onClose }: SidebarProps) {
   return (
     <>
@@ -180,8 +270,9 @@ export function Sidebar({ open, onClose }: SidebarProps) {
                 </button>
               </div>
               <div className="h-0 flex-1 overflow-y-auto pt-5">
-                <div className="flex flex-shrink-0 items-center px-4">
-                  <span className="text-xl font-bold text-sidebar-foreground">Spine</span>
+                <div className="flex flex-shrink-0 items-center gap-2 px-4">
+                  <img src="/spine-logo.svg" alt="Spine Framework" className="h-8 w-auto" />
+                  <span className="text-xl font-bold text-sidebar-foreground whitespace-nowrap">Spine Framework</span>
                 </div>
                 <SidebarContent onNavClick={onClose} />
               </div>
@@ -192,39 +283,42 @@ export function Sidebar({ open, onClose }: SidebarProps) {
     </>
   )
 }
-// CIL[END chunk_id="sidebar_sidebar_1783929861"]
-// CIL[BEGIN chunk_id="sidebar_sidebarcontentprops_1783929861" type="interface" identity="SidebarContentProps" parent="none"]
-// CIL[DOC-MACRO purpose="Define props interface for SidebarContent navigation component"]
-// CIL[DOC-RESPONSIBILITY responsibility="Specify SidebarContent component contract"]
-// CIL[DOC-CONTEXT module="src/components/layout/Sidebar" layer="frontend-component" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="SidebarContentProps interface" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Interface with optional navigation click callback" 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="context" content="purpose='Render responsive sidebar shell'; No verified external callers; imports: .framework/src/contexts/AuthContext.tsx,.framework/src/components/ui/popover.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/layout/Sidebar.tsx:sidebar:function"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/layout/Sidebar.tsx:sidebarcontentprops:interface" type="interface" identity="sidebarcontentprops" parent="~/.framework/src/components/layout/Sidebar.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Define SidebarContent component props"]
+// CIL[DOC-RESPONSIBILITY responsibility="Type-safe contract for optional navigation click handler"]
+// CIL[DOC-CONTEXT module=".framework/src/components/layout/Sidebar.tsx" layer="ui" related_files=".framework/src/components/layout/Sidebar.tsx,.framework/src/components/ui/popover.tsx,.framework/src/contexts/AuthContext.tsx"]
+// CIL[DOC-CONTRACT inputs="optional onNavClick callback" outputs="SidebarContentProps interface" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Declares an optional onNavClick callback for navigation items" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 interface SidebarContentProps {
   onNavClick?: () => void
 }
-// CIL[END chunk_id="sidebar_sidebarcontentprops_1783929861"]
-// CIL[BEGIN chunk_id="sidebar_sidebarcontent_1783929861" type="function" identity="SidebarContent" parent="none"]
-// CIL[DOC-MACRO purpose="Render main sidebar navigation with collapsible sections and user menu"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide complete sidebar navigation with admin sections and user controls"]
-// CIL[DOC-CONTEXT module="src/components/layout/Sidebar" layer="frontend-component" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="JSX navigation with collapsible sections" errors="none" side_effects="Manages section state, calls logout, triggers navigation"]
-// CIL[DOC-MICRO logic_summary="Collapsible admin sections (configs, data, observability) with role-based access and user popover" 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="context" content="purpose='Define SidebarContent component props'; No verified external callers; imports: .framework/src/contexts/AuthContext.tsx,.framework/src/components/ui/popover.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/layout/Sidebar.tsx:sidebarcontentprops:interface"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/layout/Sidebar.tsx:sidebarcontent:function" type="function" identity="sidebarcontent" parent="~/.framework/src/components/layout/Sidebar.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Render sidebar navigation content"]
+// CIL[DOC-RESPONSIBILITY responsibility="Display navigation sections, user info, and logout action"]
+// CIL[DOC-CONTEXT module=".framework/src/components/layout/Sidebar.tsx" layer="ui" related_files=".framework/src/components/layout/Sidebar.tsx,.framework/src/components/ui/popover.tsx,.framework/src/contexts/AuthContext.tsx"]
+// CIL[DOC-CONTRACT inputs="onNavClick?: () => void" outputs="JSX sidebar navigation content" errors="none" side_effects="renders DOM elements, uses React hooks and auth context"]
+// CIL[DOC-MICRO logic_summary="Builds navigation groups with collapsible sections and a user popover; uses useLocation, useAuth, and useState" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-NOTE type="param" content="onNavClick?: () => void - optional click handler for navigation links"]
 export function SidebarContent({ onNavClick }: SidebarContentProps) {
   const location = useLocation()
   const { user, logout } = useAuth()
@@ -477,4 +571,10 @@ export function SidebarContent({ onNavClick }: SidebarContentProps) {
     </nav>
   )
 }
-// CIL[END chunk_id="sidebar_sidebarcontent_1783929861"]
+// CIL[DOC-VECTOR type="context" content="purpose='Render sidebar navigation content'; No verified external callers; imports: .framework/src/contexts/AuthContext.tsx,.framework/src/components/ui/popover.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/layout/Sidebar.tsx:sidebarcontent:function"]

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

@@ -1,24 +1,32 @@
-
-
-// CIL[BEGIN chunk_id="DataDetailHeader_module_header_1783929048" type="module_header" identity="imports_and_types" parent="none"]
-// CIL[DOC-MACRO purpose="Import dependencies and define detail header component types"]
-// CIL[DOC-RESPONSIBILITY responsibility="Manage imports and interface for detail header"]
-// CIL[DOC-CONTEXT module="runtime" layer="frontend-component" related_files="[\".framework/src/components/ui/table-primitives.tsx\",\"custom/apps/portal/pages/ContentPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/src/components/ui/dialog.tsx\",\".framework/migrations/015_simplify_apps_table.sql\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="types" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Imports React, UI components, defines DataDetailHeaderProps" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[BEGIN stable_id="~/.framework/src/components/runtime/DataDetailHeader.tsx:module_header:module_header" type="module_header" identity="module_header" parent="~/.framework/src/components/runtime/DataDetailHeader.tsx"]
+// CIL[DOC-MACRO purpose="React component module for the data detail header"]
+// CIL[DOC-RESPONSIBILITY responsibility="Defines the DataDetailHeaderProps interface and the DataDetailHeader presentational component"]
+// CIL[DOC-CONTEXT module="runtime" layer="presentation" related_files=".framework/src/components/ui/button.tsx"]
+// CIL[DOC-CONTRACT inputs="N/A" outputs="DataDetailHeaderProps and DataDetailHeader exports" errors="N/A" side_effects="N/A"]
+// CIL[DOC-MICRO logic_summary="Imports dependencies, declares the props interface, and exports the detail header 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: .framework/src/components/ui/table-primitives.tsx, custom/apps/portal/pages/ContentPage.tsx, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .framework/src/components/ui/dialog.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"]
+// CIL[DOC-AUDIENCE audience="runtime-ui"]
+
 import React from 'react'
 import { Button } from '../ui/button'
 import * as Icons from 'lucide-react'
 
+// CIL[DOC-VECTOR type="context" content="purpose='React component module for the data detail header'; No verified external callers; imports: .framework/src/components/ui/button.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/DataDetailHeader.tsx:module_header:module_header"]
+// CIL[BEGIN stable_id="~/.framework/src/components/runtime/DataDetailHeader.tsx:datadetailheaderprops:interface" type="interface" identity="DataDetailHeaderProps" parent="~/.framework/src/components/runtime/DataDetailHeader.tsx"]
+// CIL[DOC-MACRO purpose="Defines the prop contract for the DataDetailHeader component"]
+// CIL[DOC-RESPONSIBILITY responsibility="Specifies all data and callback properties required to render and control the detail header"]
+// CIL[DOC-CONTEXT module="runtime" layer="type" related_files=".framework/src/components/runtime/DataDetailHeader.tsx,.framework/src/components/ui/button.tsx"]
+// CIL[DOC-CONTRACT inputs="N/A" outputs="DataDetailHeaderProps TypeScript interface" errors="N/A" side_effects="N/A"]
+// CIL[DOC-MICRO logic_summary="Interface with entity, icon, title, editing flags, and action handler props" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 interface DataDetailHeaderProps {
   entity: string
   icon: string
@@ -32,21 +40,32 @@ interface DataDetailHeaderProps {
   saving?: boolean
   deleting?: boolean
 }
-// CIL[END chunk_id="DataDetailHeader_module_header_1783929048"]
-// CIL[BEGIN chunk_id="DataDetailHeader_datadetailheader_1783929048" type="function" identity="DataDetailHeader" parent="none"]
-// CIL[DOC-MACRO purpose="Render entity detail header with edit/save/delete buttons"]
-// CIL[DOC-RESPONSIBILITY responsibility="Display header with title, icon, and action buttons"]
-// CIL[DOC-CONTEXT module="runtime" layer="frontend-component" related_files="[\".framework/src/components/ui/table-primitives.tsx\",\".framework/migrations/015_simplify_apps_table.sql\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\"custom/apps/portal/pages/ContentPage.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="JSX header" errors="none" side_effects="calls callbacks"]
-// CIL[DOC-MICRO logic_summary="Renders icon, title, and conditional edit/save/delete buttons" 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/table-primitives.tsx, .framework/migrations/015_simplify_apps_table.sql, .framework/src/pages/admin/TypeDetailPage.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='Defines the prop contract for the DataDetailHeader component'; No verified external callers; imports: .framework/src/components/ui/button.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/DataDetailHeader.tsx:datadetailheaderprops:interface"]
+// CIL[BEGIN stable_id="~/.framework/src/components/runtime/DataDetailHeader.tsx:datadetailheader:function" type="function" identity="DataDetailHeader" parent="~/.framework/src/components/runtime/DataDetailHeader.tsx"]
+// CIL[DOC-MACRO purpose="Render a detail view header with icon, title, entity label, and action buttons"]
+// CIL[DOC-RESPONSIBILITY responsibility="Display the entity header and dispatch user actions to the provided callback props"]
+// CIL[DOC-CONTEXT module="runtime" layer="presentation" related_files=".framework/src/components/runtime/DataDetailHeader.tsx,.framework/src/components/ui/button.tsx"]
+// CIL[DOC-CONTRACT inputs="entity, icon, title, isEditing, isCreating, onEdit, onSave, onCancel, onDelete?, saving?, deleting?" outputs="JSX.Element" errors="N/A" side_effects="Invokes onEdit, onSave, onCancel, and onDelete callbacks when buttons are clicked"]
+// CIL[DOC-MICRO logic_summary="Resolves the lucide icon, renders title and entity, conditionally shows save/cancel or edit/delete controls" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-NOTE type="param" content="entity: string - entity collection or label shown in the header">
+// CIL[DOC-NOTE type="param" content="icon: string - lucide-react icon key to display">
+// CIL[DOC-NOTE type="param" content="title: string - page title rendered in the header">
+// CIL[DOC-NOTE type="param" content="isEditing: boolean - whether the detail form is in editing mode">
+// CIL[DOC-NOTE type="param" content="isCreating: boolean - whether a new record is being created">
+// CIL[DOC-NOTE type="param" content="onEdit: () => void - callback to enter edit mode">
+// CIL[DOC-NOTE type="param" content="onSave: () => void - callback to save the current record">
+// CIL[DOC-NOTE type="param" content="onCancel: () => void - callback to cancel editing">
+// CIL[DOC-NOTE type="param" content="onDelete?: () => void - optional callback to delete the record">
+// CIL[DOC-NOTE type="param" content="saving?: boolean - optional flag indicating a save is in progress">
+// CIL[DOC-NOTE type="param" content="deleting?: boolean - optional flag indicating a delete is in progress">
 export function DataDetailHeader({
   entity,
   icon,
@@ -106,4 +125,10 @@ export function DataDetailHeader({
     </div>
   )
 }
-// CIL[END chunk_id="DataDetailHeader_datadetailheader_1783929048"]
+// CIL[DOC-VECTOR type="context" content="purpose='Render a detail view header with icon, title, entity label, and action buttons'; No verified external callers; imports: .framework/src/components/ui/button.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/DataDetailHeader.tsx:datadetailheader:function"]