spine-framework 0.3.145 → 0.4.0

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

@@ -1,58 +1,51 @@
-
-
-
-// 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[BEGIN stable_id="~/.framework/src/components/layout/Header.tsx:module_header:module_header" type="module_header" identity="module_header" parent="~/.framework/src/components/layout/Header.tsx"]
+// CIL[DOC-MACRO purpose="Header UI component module imports and setup"]
+// CIL[DOC-RESPONSIBILITY responsibility="Import menu, search and notification icons and the User type"]
+// CIL[DOC-CONTEXT module="components/layout" layer="ui" related_files=".framework/src/types/auth.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Imports iconography from lucide-react and heroicons plus the auth User type for the 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: 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="context" content="purpose='Header UI component module imports and setup'; No verified external callers; imports: .framework/src/types/auth.ts"]
+// 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/Header.tsx:module_header:module_header"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/layout/Header.tsx:headerprops:interface" type="interface" identity="HeaderProps" parent="~/.framework/src/components/layout/Header.tsx"]
+// CIL[DOC-MACRO purpose="Define the prop contract for the Header component"]
+// CIL[DOC-RESPONSIBILITY responsibility="Describe the onMenuClick callback and the user object expected by Header"]
+// CIL[DOC-CONTEXT module="components/layout" layer="ui" related_files=".framework/src/components/layout/Header.tsx,.framework/src/types/auth.ts"]
+// CIL[DOC-CONTRACT inputs="onMenuClick: callback, user: User | null" outputs="none" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="TypeScript interface that types the Header component props for menu click and user display" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 interface HeaderProps {
   onMenuClick: () => void
   user: User | null
 }
-// 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="context" content="purpose='Define the prop contract for the Header component'; No verified external callers; imports: .framework/src/types/auth.ts"]
+// 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/Header.tsx:headerprops:interface"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/layout/Header.tsx:header:function" type="function" identity="Header" parent="~/.framework/src/components/layout/Header.tsx"]
+// CIL[DOC-MACRO purpose="Render the application header with navigation, search, notifications and user profile"]
+// CIL[DOC-RESPONSIBILITY responsibility="Render a sticky top navigation bar with mobile menu button, search input, notification bell and user avatar"]
+// CIL[DOC-CONTEXT module="components/layout" layer="ui" related_files=".framework/src/components/layout/Header.tsx,.framework/src/types/auth.ts"]
+// CIL[DOC-CONTRACT inputs="onMenuClick: () => void, user: User | null" outputs="JSX header element" errors="none" side_effects="renders interactive UI elements; does not manage state"]
+// CIL[DOC-MICRO logic_summary="Renders a sticky flex header with menu button, search input, notifications and user profile display using optional user name initials" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 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">
@@ -97,4 +90,10 @@ export function Header({ onMenuClick, user }: HeaderProps) {
     </header>
   )
 }
-// CIL[END chunk_id="header_header_1783929861"]
+// CIL[DOC-VECTOR type="context" content="purpose='Render the application header with navigation, search, notifications and user profile'; No verified external callers; imports: .framework/src/types/auth.ts"]
+// 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/Header.tsx:header:function"]

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

@@ -1,58 +1,52 @@
-
-
-
-// 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[BEGIN stable_id="~/.framework/src/components/layout/Layout.tsx:module_header:module_header" type="module_header" identity="module_header" parent="~/.framework/src/components/layout/Layout.tsx"]
+// CIL[DOC-MACRO purpose="Module imports and top-level declarations for the Layout component."]
+// CIL[DOC-RESPONSIBILITY responsibility="Declare dependencies and types used by the Layout component."]
+// CIL[DOC-CONTEXT module="components/layout" layer="ui" related_files=".framework/src/components/layout/Sidebar.tsx,.framework/src/contexts/AuthContext.tsx"]
+// CIL[DOC-CONTRACT inputs="N/A" outputs="N/A" errors="N/A" side_effects="N/A"]
+// CIL[DOC-MICRO logic_summary="Imports React, useState, Sidebar/SidebarContent, useAuth and useLocation." 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/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"]
+// CIL[DOC-AUDIENCE audience="ai, developers"]
+
 import React, { useState } from 'react'
 import { Sidebar, SidebarContent } from './Sidebar'
 import { useAuth } from '../../contexts/AuthContext'
 import { useLocation } from 'react-router-dom'
-// 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="context" content="purpose='Module imports and top-level declarations for the Layout component.'; No verified external callers; imports: .framework/src/components/layout/Sidebar.tsx,.framework/src/contexts/AuthContext.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/Layout.tsx:module_header:module_header"]
+// CIL[BEGIN stable_id="~/.framework/src/components/layout/Layout.tsx:layoutprops:interface" type="interface" identity="LayoutProps" parent="~/.framework/src/components/layout/Layout.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Define the props contract for the Layout component."]
+// CIL[DOC-RESPONSIBILITY responsibility="Type the children prop for the Layout component."]
+// CIL[DOC-CONTEXT module="components/layout" layer="ui" related_files=".framework/src/components/layout/Layout.tsx,.framework/src/components/layout/Sidebar.tsx,.framework/src/contexts/AuthContext.tsx"]
+// CIL[DOC-CONTRACT inputs="N/A" outputs="LayoutProps interface" errors="N/A" side_effects="N/A"]
+// CIL[DOC-MICRO logic_summary="Declares a single children prop of type React.ReactNode." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 interface LayoutProps {
   children: React.ReactNode
 }
-// 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="context" content="purpose='Define the props contract for the Layout component.'; No verified external callers; imports: .framework/src/components/layout/Sidebar.tsx,.framework/src/contexts/AuthContext.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/Layout.tsx:layoutprops:interface"]
+
+
+// CIL[BEGIN stable_id="~/.framework/src/components/layout/Layout.tsx:layout:function" type="function" identity="Layout" parent="~/.framework/src/components/layout/Layout.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Render the responsive application shell with sidebar and main content."]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide the application layout wrapper, manage sidebar visibility, and render responsive navigation and main content."]
+// CIL[DOC-CONTEXT module="components/layout" layer="ui" related_files=".framework/src/components/layout/Layout.tsx,.framework/src/components/layout/Sidebar.tsx,.framework/src/contexts/AuthContext.tsx"]
+// CIL[DOC-CONTRACT inputs="children: React.ReactNode" outputs="JSX layout structure" errors="None" side_effects="Updates local sidebarOpen state; consumes useAuth and useLocation hooks."]
+// CIL[DOC-MICRO logic_summary="Computes active route, conditionally renders mobile overlay and sidebar, and renders a responsive main content area." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export function Layout({ children }: LayoutProps) {
   const [sidebarOpen, setSidebarOpen] = useState(false)
   const { user, logout } = useAuth()
@@ -93,8 +87,8 @@ export function Layout({ children }: LayoutProps) {
           </svg>
         </button>
         <div className="flex items-center gap-3">
-          <img src="/spine-logo.jpg" alt="Spine Framework" className="h-8 w-auto" />
-          <span className="text-lg font-semibold tracking-tight text-slate-900">Spine Framework</span>
+          <img src="/spine-logo.svg" alt="Spine Framework" className="h-8 w-auto" />
+          <span className="text-lg font-semibold tracking-tight text-slate-900 whitespace-nowrap">Spine Framework</span>
         </div>
       </div>
 
@@ -108,4 +102,10 @@ export function Layout({ children }: LayoutProps) {
     </div>
   )
 }
-// CIL[END chunk_id="layout_layout_1783929861"]
+// CIL[DOC-VECTOR type="context" content="purpose='Render the responsive application shell with sidebar and main content.'; No verified external callers; imports: .framework/src/components/layout/Sidebar.tsx,.framework/src/contexts/AuthContext.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/Layout.tsx:layout:function"]