spine-framework 0.3.124 → 0.3.126

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

@@ -1,45 +1,61 @@
-/**
- * @module src/components/layout/Header
- * @audience installer
- * @layer frontend-component
- * @stability stable
- *
- * Sticky top bar rendered inside the main content area. Contains:
- * - **Mobile hamburger** (`Bars3Icon`) — visible below `lg` breakpoint;
- *   calls `onMenuClick` to open the slide-over sidebar
- * - **Search input** — hidden on small screens (placeholder only; not wired)
- * - **Notification bell** — placeholder; not yet wired to a backend
- * - **User avatar + name** — derived from `user.full_name` / `user.email`
- *
- * @seeAlso src/components/layout/Layout.tsx (mounts this component)
- * @seeAlso src/types/auth.ts (User)
- */
 
-import { Menu, Bell, Search, User } from 'lucide-react';
-import { User } from '../../types/auth'
 
-/**
- * Props for `Header`.
- *
- * @prop onMenuClick - Callback to open the mobile sidebar
- * @prop user - Currently logged-in user (null while loading)
- */
+
+// CIL[BEGIN chunk_id="header_moduleheader_1783929861" type="module_header" identity="imports" parent="none"]
+// CIL[DOC-MACRO purpose="Import UI icons and User type for Header component"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide external dependencies for Header"]
+// CIL[DOC-CONTEXT module="src/components/layout/Header" layer="frontend-component" related_files="[\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/src/components/ui/dialog.tsx\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/src/components/layout/Sidebar.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="Menu, Bell, MagnifyingGlassIcon, User" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Imports Lucide icons, Heroicons, and auth User type" 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/cortex/pages/operations/OperationsDashboard.tsx, custom/apps/portal/pages/ContentPage.tsx, .framework/src/components/ui/dialog.tsx, .framework/src/pages/admin/TypeDetailPage.tsx, .framework/src/components/layout/Sidebar.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 { Menu, Bell } from 'lucide-react';
+import { MagnifyingGlassIcon } from '@heroicons/react/24/outline';
+import { User } from '../../types/auth'
+// CIL[END chunk_id="header_moduleheader_1783929861"]
+// CIL[BEGIN chunk_id="header_headerprops_1783929861" type="interface" identity="HeaderProps" parent="none"]
+// CIL[DOC-MACRO purpose="Define props interface for Header component"]
+// CIL[DOC-RESPONSIBILITY responsibility="Specify Header component contract"]
+// CIL[DOC-CONTEXT module="src/components/layout/Header" layer="frontend-component" related_files="[\".framework/src/components/layout/Sidebar.tsx\",\".framework/functions/_shared/schema-utils.ts\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/src/components/ui/dialog.tsx\",\"custom/apps/portal/pages/ContentPage.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="HeaderProps interface" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Interface with menu callback and optional user data" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-VECTOR type="context" content="Layer: frontend-component. Direct callers: 0. Direct calls: 0. Related files: .framework/src/components/layout/Sidebar.tsx, .framework/functions/_shared/schema-utils.ts, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .framework/src/components/ui/dialog.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"]
 interface HeaderProps {
   onMenuClick: () => void
   user: User | null
 }
-
-/**
- * Sticky top bar.
- *
- * @param props - `HeaderProps`
- * @returns Header element with menu toggle, search, notifications, and avatar
- * @sideEffects none (delegates menu open to `onMenuClick`)
- */
+// CIL[END chunk_id="header_headerprops_1783929861"]
+// CIL[BEGIN chunk_id="header_header_1783929861" type="function" identity="Header" parent="none"]
+// CIL[DOC-MACRO purpose="Render sticky header with menu, search, notifications, and user avatar"]
+// CIL[DOC-RESPONSIBILITY responsibility="Display top navigation bar with user controls"]
+// CIL[DOC-CONTEXT module="src/components/layout/Header" layer="frontend-component" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/src/pages/admin/RolesPage.tsx\",\".framework/src/components/ui/dialog.tsx\",\".framework/functions/_shared/principal.ts\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="JSX header element" errors="none" side_effects="Calls onMenuClick when menu button clicked"]
+// CIL[DOC-MICRO logic_summary="Responsive layout with mobile menu button, search input, notification bell, and user avatar" 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/RolesPage.tsx, .framework/src/components/ui/dialog.tsx, .framework/functions/_shared/principal.ts, \."]
+// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
+// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
+// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 export function Header({ onMenuClick, user }: HeaderProps) {
   return (
     <header className="sticky top-0 z-20 flex h-14 shrink-0 items-center gap-4 border-b border-slate-200 bg-white/80 backdrop-blur-md px-4 sm:px-6 lg:pl-72 lg:pr-8">
-      {/* Logo + Mobile hamburger — only visible below lg */}
       <div className="flex items-center gap-3">
         <button
           onClick={onMenuClick}
@@ -50,12 +66,9 @@ export function Header({ onMenuClick, user }: HeaderProps) {
         </button>
               </div>
 
-      {/* Spacer */}
       <div className="flex-1" />
 
-      {/* Right actions */}
       <div className="flex items-center gap-3">
-        {/* Search */}
         <div className="relative hidden sm:block">
           <MagnifyingGlassIcon className="pointer-events-none absolute left-3 top-1/2 h-4 w-4 -translate-y-1/2 text-slate-400" />
           <input
@@ -65,7 +78,6 @@ export function Header({ onMenuClick, user }: HeaderProps) {
           />
         </div>
 
-        {/* Notifications */}
         <button
           className="relative rounded-lg p-2 text-slate-400 hover:bg-slate-100 hover:text-slate-600 transition-colors"
           aria-label="Notifications"
@@ -73,7 +85,6 @@ export function Header({ onMenuClick, user }: HeaderProps) {
           <Bell className="h-5 w-5" />
         </button>
 
-        {/* User avatar */}
         <div className="flex items-center gap-2 pl-2 border-l border-slate-200">
           <div className="flex h-7 w-7 items-center justify-center rounded-full bg-navy text-xs font-medium text-white">
             {user?.full_name?.charAt(0) || user?.email?.charAt(0) || '?'}
@@ -86,3 +97,4 @@ export function Header({ onMenuClick, user }: HeaderProps) {
     </header>
   )
 }
+// CIL[END chunk_id="header_header_1783929861"]

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

@@ -1,39 +1,58 @@
-/**
- * @module src/components/layout/Layout
- * @audience installer
- * @layer frontend-component
- * @stability stable
- *
- * Root app shell providing the two-pane admin layout:
- * - **Desktop (`lg+`):** fixed 60-wide `<Sidebar>` on the left, scrollable
- *   main content area padded with `lg:pl-60`.
- * - **Mobile (`< lg`):** top bar with hamburger button that opens a
- *   slide-over `<Sidebar>` with a backdrop overlay.
- *
- * `isActive` is computed from the current `location.pathname` and passed
- * to `SidebarContent` for active-link highlighting.
- *
- * @seeAlso src/components/layout/Sidebar.tsx
- * @seeAlso src/contexts/AuthContext.tsx (provides `user` and `logout`)
- */
 
+
+
+// CIL[BEGIN chunk_id="layout_moduleheader_1783929861" type="module_header" identity="imports" parent="none"]
+// CIL[DOC-MACRO purpose="Import React hooks and layout components for main app shell"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide dependencies for Layout component"]
+// CIL[DOC-CONTEXT module="src/components/layout/Layout" layer="frontend-component" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/src/components/layout/Sidebar.tsx\",\".framework/src/components/ui/dialog.tsx\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="React, useState, Sidebar, SidebarContent, useAuth, useLocation" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Imports React, local Sidebar components, auth context, and router" 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/layout/Sidebar.tsx, .framework/src/components/ui/dialog.tsx, .framework/src/pages/admin/TypeDetailPage.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, { useState } from 'react'
 import { Sidebar, SidebarContent } from './Sidebar'
 import { useAuth } from '../../contexts/AuthContext'
 import { useLocation } from 'react-router-dom'
-
-/** Props for `Layout`. */
+// CIL[END chunk_id="layout_moduleheader_1783929861"]
+// CIL[BEGIN chunk_id="layout_layoutprops_1783929861" type="interface" identity="LayoutProps" parent="none"]
+// CIL[DOC-MACRO purpose="Define props interface for Layout component"]
+// CIL[DOC-RESPONSIBILITY responsibility="Specify Layout component contract"]
+// CIL[DOC-CONTEXT module="src/components/layout/Layout" layer="frontend-component" related_files="[\".framework/src/components/layout/Sidebar.tsx\",\".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="LayoutProps interface" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Interface accepting React children for main content area" 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/layout/Sidebar.tsx, .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="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 interface LayoutProps {
   children: React.ReactNode
 }
-
-/**
- * Root two-pane admin shell.
- *
- * @param props - `LayoutProps`
- * @returns Full-page layout with sidebar + main content area
- * @sideEffects none (sidebar open state is local)
- */
+// CIL[END chunk_id="layout_layoutprops_1783929861"]
+// CIL[BEGIN chunk_id="layout_layout_1783929861" type="function" identity="Layout" parent="none"]
+// CIL[DOC-MACRO purpose="Render responsive two-pane admin layout with sidebar and main content"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide root app shell with mobile/desktop sidebar behavior"]
+// CIL[DOC-CONTEXT module="src/components/layout/Layout" layer="frontend-component" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/src/components/layout/Sidebar.tsx\",\".framework/src/pages/admin/RolesPage.tsx\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/src/pages/admin/IntegrationsPage.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="JSX layout with sidebar" errors="none" side_effects="Manages sidebar open state and navigation highlighting"]
+// CIL[DOC-MICRO logic_summary="Responsive layout with mobile overlay sidebar and fixed desktop 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: custom/apps/portal/pages/ContentPage.tsx, .framework/src/components/layout/Sidebar.tsx, .framework/src/pages/admin/RolesPage.tsx, .framework/src/pages/admin/TypeDetailPage.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"]
 export function Layout({ children }: LayoutProps) {
   const [sidebarOpen, setSidebarOpen] = useState(false)
   const { user, logout } = useAuth()
@@ -44,7 +63,6 @@ export function Layout({ children }: LayoutProps) {
 
   return (
     <div className="min-h-screen bg-[#F2F3F8] flex lg:top-0">
-      {/* Mobile overlay */}
       {sidebarOpen && (
         <>
           <div
@@ -55,7 +73,6 @@ export function Layout({ children }: LayoutProps) {
         </>
       )}
 
-      {/* Desktop sidebar — visible at lg+ */}
       <aside className="hidden lg:flex lg:fixed lg:inset-y-0 lg:left-0 lg:z-30 lg:w-60 lg:flex-col lg:shrink-0 bg-white border-r border-slate-200 lg:top-0">
         <SidebarContent
           isActive={isActive}
@@ -65,7 +82,6 @@ export function Layout({ children }: LayoutProps) {
         />
       </aside>
 
-      {/* Mobile sidebar with menu button */}
       <div className="lg:hidden flex items-center justify-between p-4 bg-white border-b border-slate-200">
         <button
           onClick={() => setSidebarOpen(true)}
@@ -82,7 +98,6 @@ export function Layout({ children }: LayoutProps) {
         </div>
       </div>
 
-      {/* Main content area */}
       <div className="flex-1 flex flex-col min-w-0 lg:pl-60">
         <main className="flex-1 py-6 px-4 sm:px-6 lg:px-8 xl:px-12">
           <div className="max-w-6xl mx-auto">
@@ -93,3 +108,4 @@ export function Layout({ children }: LayoutProps) {
     </div>
   )
 }
+// CIL[END chunk_id="layout_layout_1783929861"]

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

@@ -1,3 +1,25 @@
+
+
+
+
+
+
+
+// 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'
@@ -21,17 +43,48 @@ import {
   User, 
   MoreVertical, 
   ShieldCheck, 
-  Key, 
+  Key,
+  Truck,
   FlaskConical, 
   BarChart3, 
-  Bell
+  Bell,
+  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="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 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="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 const navigation = [
   { name: 'Dashboard', href: '/spine-framework/admin/configs/types', icon: Home },
 ]
@@ -44,7 +97,6 @@ const configsNavigation = [
   { divider: true },
   { name: 'AI Agents', href: '/spine-framework/admin/configs/ai-agents', icon: Sparkles },
   { name: 'Prompt Configs', href: '/spine-framework/admin/configs/prompts', icon: FileText },
-  { name: 'Embeddings', href: '/spine-framework/admin/configs/embeddings', icon: FileText },
   { divider: true },
   { name: 'Pipelines', href: '/spine-framework/admin/configs/pipelines', icon: RefreshCw },
   { name: 'Triggers', href: '/spine-framework/admin/configs/triggers', icon: Zap },
@@ -52,6 +104,7 @@ const configsNavigation = [
   { divider: true },
   { name: 'Integrations', href: '/spine-framework/admin/configs/integrations', icon: LinkIcon },
   { name: 'API Keys', href: '/spine-framework/admin/configs/api-keys', icon: Key },
+  { name: 'Deliveries', href: '/spine-framework/admin/configs/deliveries', icon: Truck },
 ] as const
 
 const observabilityNavigation = [
@@ -61,7 +114,6 @@ const observabilityNavigation = [
   { name: 'Logs', href: '/spine-framework/admin/observability/logs', icon: FileText },
 ]
 
-// Database entities that should be shown in runtime navigation
 const runtimeEntities = [
   { name: 'Items', href: '/spine-framework/admin/runtime/items', icon: Box },
   { name: 'Accounts', href: '/spine-framework/admin/runtime/accounts', icon: Building2 },
@@ -69,14 +121,46 @@ const runtimeEntities = [
   { name: 'Person Types', href: '/spine-framework/admin/runtime/person-types', icon: Users },
 ]
 
+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="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 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="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 export function Sidebar({ open, onClose }: SidebarProps) {
   return (
     <>
-      {/* Mobile sidebar */}
       <div className={classNames(open && 'fixed inset-0 z-40 flex')}> 
         {open && (
           <div className="fixed inset-0 z-40 flex">
@@ -108,23 +192,53 @@ 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="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 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="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 export function SidebarContent({ onNavClick }: SidebarContentProps) {
   const location = useLocation()
   const { user, logout } = useAuth()
   const isSystemAdmin = user?.roles?.includes('system_admin')
 
-  // Collapsible sections state
   const [configsOpen, setConfigsOpen] = useState(() => 
     location.pathname.includes('/admin/configs')
   )
   const [runtimeOpen, setRuntimeOpen] = useState(() => 
     location.pathname.includes('/admin/runtime')
   )
+  const [kbEngineOpen, setKbEngineOpen] = useState(() =>
+    location.pathname.includes('/admin/kb')
+  )
   const [observabilityOpen, setObservabilityOpen] = useState(() =>
     location.pathname.includes('/admin/observability')
   )
@@ -135,7 +249,6 @@ export function SidebarContent({ onNavClick }: SidebarContentProps) {
 
   return (
     <nav className="mt-5 flex flex-1 flex-col px-2">
-      {/* Main nav */}
       <div className="space-y-1">
         {navigation.map((item) => (
           <Link
@@ -161,7 +274,6 @@ export function SidebarContent({ onNavClick }: SidebarContentProps) {
         ))}
       </div>
 
-      {/* Configs Section */}
       {isSystemAdmin && (
         <>
           <div className="mt-6">
@@ -209,7 +321,6 @@ export function SidebarContent({ onNavClick }: SidebarContentProps) {
             )}
           </div>
 
-          {/* Runtime Section */}
           <div className="mt-4">
             <button
               onClick={() => setRuntimeOpen(!runtimeOpen)}
@@ -251,7 +362,47 @@ export function SidebarContent({ onNavClick }: SidebarContentProps) {
             )}
           </div>
 
-          {/* Observability Section */}
+          <div className="mt-4">
+            <button
+              onClick={() => setKbEngineOpen(!kbEngineOpen)}
+              className="flex w-full items-center justify-between px-2 py-2 text-sm font-medium text-sidebar-foreground hover:bg-sidebar-accent hover:text-sidebar-accent-foreground rounded-md"
+            >
+              <span>KB Engine</span>
+              {kbEngineOpen ? (
+                <ChevronDown className="h-4 w-4" />
+              ) : (
+                <ChevronRight className="h-4 w-4" />
+              )}
+            </button>
+
+            {kbEngineOpen && (
+              <div className="mt-1 space-y-1">
+                {kbEngineNavigation.map((item) => (
+                  <Link
+                    key={item.name}
+                    to={item.href}
+                    onClick={onNavClick}
+                    className={classNames(
+                      isActive(item.href)
+                        ? 'bg-sidebar-accent text-sidebar-accent-foreground'
+                        : 'text-sidebar-foreground hover:bg-sidebar-accent hover:text-sidebar-accent-foreground',
+                      'group flex items-center rounded-md px-2 py-2 text-sm font-medium pl-4'
+                    )}
+                  >
+                    <item.icon
+                      className={classNames(
+                        isActive(item.href) ? 'text-sidebar-accent-foreground' : 'text-sidebar-foreground',
+                        'mr-3 h-4 w-4 flex-shrink-0'
+                      )}
+                      aria-hidden="true"
+                    />
+                    {item.name}
+                  </Link>
+                ))}
+              </div>
+            )}
+          </div>
+
           <div className="mt-4">
             <button
               onClick={() => setObservabilityOpen(!observabilityOpen)}
@@ -295,7 +446,6 @@ export function SidebarContent({ onNavClick }: SidebarContentProps) {
         </>
       )}
 
-      {/* User section */}
       <div className="mt-auto border-t border-sidebar-border pt-4">
         <Popover>
           <PopoverTrigger asChild>
@@ -327,3 +477,4 @@ export function SidebarContent({ onNavClick }: SidebarContentProps) {
     </nav>
   )
 }
+// CIL[END chunk_id="sidebar_sidebarcontent_1783929861"]

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

@@ -1,3 +1,20 @@
+
+
+// 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[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"]
 import React from 'react'
 import { Button } from '../ui/button'
 import * as Icons from 'lucide-react'
@@ -15,7 +32,21 @@ 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="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 export function DataDetailHeader({
   entity,
   icon,
@@ -75,3 +106,4 @@ export function DataDetailHeader({
     </div>
   )
 }
+// CIL[END chunk_id="DataDetailHeader_datadetailheader_1783929048"]