spine-framework 0.3.124 → 0.3.126

package/.framework/src/apps/admin/index.tsx

@@ -1,3 +1,22 @@
+
+
+
+
+// CIL[BEGIN chunk_id="index_module_header_1783931090" type="module_header" identity="imports" parent="none"]
+// CIL[DOC-MACRO purpose="Import React and routing dependencies for admin app"]
+// CIL[DOC-RESPONSIBILITY responsibility="Manage all external module imports for admin interface"]
+// CIL[DOC-CONTEXT module="admin-index" layer="admin-routing" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/migrations/015_simplify_apps_table.sql\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="Imported modules and components" errors="Import failures" side_effects="Module loading"]
+// CIL[DOC-MICRO logic_summary="Imports React hooks, routing components, UI components, and layout" 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: admin-routing. Direct callers: 0. Direct calls: 0. Related files: custom/apps/portal/pages/ContentPage.tsx, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .framework/migrations/015_simplify_apps_table.sql, .framework/src/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 { lazy, Suspense } from 'react'
 import { Routes, Route, Navigate, useLocation } from 'react-router-dom'
 import { LoadingSpinner } from '../../components/ui/LoadingSpinner'
@@ -6,8 +25,21 @@ import { useAuth } from '../../contexts/AuthContext'
 import { AppShell } from '../../components/layout/AppShell'
 import { AdminSidebar } from '../../components/admin/AdminSidebar'
 import { TooltipProvider } from '../../components/ui/tooltip'
-
-// Config list pages
+// CIL[END chunk_id="index_module_header_1783931090"]
+// CIL[BEGIN chunk_id="index_lazy_imports_1783931090" type="lazy_imports" identity="lazy_imports" parent="none"]
+// CIL[DOC-MACRO purpose="Lazy load all admin pages and components for code splitting"]
+// CIL[DOC-RESPONSIBILITY responsibility="Manage lazy imports for admin interface pages and components"]
+// CIL[DOC-CONTEXT module="admin-index" layer="admin-routing" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/src/pages/admin/RolesPage.tsx\",\".framework/src/pages/admin/IntegrationsPage.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="Lazy-loaded page components" errors="Module loading failures" side_effects="Dynamic imports"]
+// CIL[DOC-MICRO logic_summary="Creates lazy imports for all admin pages, runtime components, and test pages" notable_decisions="['extensive_lazy_loading', 'then_default_extraction']"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-VECTOR type="context" content="Layer: admin-routing. Direct callers: 0. Direct calls: 0. Related files: custom/apps/portal/pages/ContentPage.tsx, .framework/src/pages/admin/TypeDetailPage.tsx, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .framework/src/pages/admin/RolesPage.tsx, .framework/src/pages/admin/IntegrationsPage.tsx, \."]
+// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
+// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
+// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 const TypesPage = lazy(() => import('../../pages/admin/TypesPage').then(m => ({ default: m.TypesPage })))
 const AppsPage = lazy(() => import('../../pages/admin/AppsPage').then(m => ({ default: m.AppsPage })))
 const TypeDetailPage = lazy(() => import('../../pages/admin/TypeDetailPage').then(m => ({ default: m.TypeDetailPage })))
@@ -17,8 +49,6 @@ const AIAgentsPage = lazy(() => import('../../pages/admin/AIAgentsPage').then(m
 const EmbeddingsPage = lazy(() => import('../../pages/admin/EmbeddingsPage').then(m => ({ default: m.EmbeddingsPage })))
 const TimersPage = lazy(() => import('../../pages/admin/TimersPage').then(m => ({ default: m.TimersPage })))
 const IntegrationsPage = lazy(() => import('../../pages/admin/IntegrationsPage').then(m => ({ default: m.IntegrationsPage })))
-
-// Config detail pages
 const AppDetailPage = lazy(() => import('../../pages/admin/AppDetailPage').then(m => ({ default: m.AppDetailPage })))
 const PipelineDetailPage = lazy(() => import('../../pages/admin/PipelineDetailPage').then(m => ({ default: m.PipelineDetailPage })))
 const TriggerDetailPage = lazy(() => import('../../pages/admin/TriggerDetailPage').then(m => ({ default: m.TriggerDetailPage })))
@@ -32,21 +62,14 @@ const PromptConfigsPage = lazy(() => import('../../pages/admin/PromptConfigsPage
 const PromptConfigDetailPage = lazy(() => import('../../pages/admin/PromptConfigDetailPage').then(m => ({ default: m.PromptConfigDetailPage })))
 const APIKeysPage = lazy(() => import('../../pages/admin/APIKeysPage').then(m => ({ default: m.APIKeysPage })))
 const APIKeyDetailPage = lazy(() => import('../../pages/admin/APIKeyDetailPage').then(m => ({ default: m.APIKeyDetailPage })))
-
-// Access pages
+const DeliveriesPage = lazy(() => import('../../pages/admin/DeliveriesPage').then(m => ({ default: m.DeliveriesPage })))
 const InvitesPage = lazy(() => import('../../pages/admin/InvitesPage').then(m => ({ default: m.InvitesPage })))
-
-// Observability pages
 const ObservabilityDashboard = lazy(() => import('../../pages/admin/ObservabilityDashboard').then(m => ({ default: m.ObservabilityDashboard })))
 const PipelineExecutionsPage = lazy(() => import('../../pages/admin/PipelineExecutionsPage').then(m => ({ default: m.PipelineExecutionsPage })))
 const LogsPage = lazy(() => import('../../pages/admin/LogsPage').then(m => ({ default: m.LogsPage })))
 const AlertsConfigPage = lazy(() => import('../../pages/admin/AlertsConfigPage').then(m => ({ default: m.AlertsConfigPage })))
-
-// Runtime data pages (unified)
 const DataListPage = lazy(() => import('../../components/runtime/DataListPage').then(m => ({ default: m.DataListPage })))
 const DataDetailPage = lazy(() => import('../../components/runtime/DataDetailPage').then(m => ({ default: m.DataDetailPage })))
-
-// Testing pages
 const TestingDashboard = lazy(() => import('../../pages/admin/TestingDashboard'))
 const TestRunDetailPage = lazy(() => import('../../pages/admin/TestRunDetailPage').then(m => ({ default: m.TestRunDetailPage })))
 const ShadcnTestPage = lazy(() => import('../../pages/admin/ShadcnTestPage').then(m => ({ default: m.ShadcnTestPage })))
@@ -58,19 +81,40 @@ const DesignedPage = lazy(() => import('../../pages/admin/DesignedPage').then(m
 const ProperlyDesignedPage = lazy(() => import('../../pages/admin/ProperlyDesignedPage').then(m => ({ default: m.ProperlyDesignedPage })))
 const IntegratedDashboard = lazy(() => import('../../pages/admin/IntegratedDashboard').then(m => ({ default: m.IntegratedDashboard })))
 const SimpleDashboard = lazy(() => import('../../pages/admin/SimpleDashboard').then(m => ({ default: m.SimpleDashboard })))
-
+const CILProjectsPage = lazy(() => import('../../pages/admin/cil/CILProjectsPage'))
+const KBAdminPage = lazy(() => import('../../pages/admin/kb/KBAdminPage').then(m => ({ default: m.KBAdminPage })))
+const CILDashboardPage = lazy(() => import('../../pages/admin/cil/CILDashboardPage'))
+const CILSearchPage = lazy(() => import('../../pages/admin/cil/CILSearchPage'))
+const CILAgentPage = lazy(() => import('../../pages/admin/cil/CILAgentPage'))
+const CILFileListPage = lazy(() => import('../../pages/admin/cil/CILFileListPage'))
+const CILGraphPage = lazy(() => import('../../pages/admin/cil/CILGraphPage'))
+const CILIngestionPage = lazy(() => import('../../pages/admin/cil/CILIngestionPage'))
+const CILChunkDetailPage = lazy(() => import('../../pages/admin/cil/CILChunkDetailPage'))
+const FlexiblePipelinePage = lazy(() => import('../../pages/admin/cil/FlexiblePipelinePage'))
+// CIL[END chunk_id="index_lazy_imports_1783931090"]
+// CIL[BEGIN chunk_id="index_adminroutes_1783931090" type="function" identity="AdminRoutes" parent="none"]
+// CIL[DOC-MACRO purpose="Define all admin routes with breadcrumbs and navigation"]
+// CIL[DOC-RESPONSIBILITY responsibility="Manage admin routing, breadcrumbs, and page layout"]
+// CIL[DOC-CONTEXT module="admin-index" layer="admin-routing" related_files="[\".framework/src/pages/admin/IntegrationsPage.tsx\",\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/migrations/015_simplify_apps_table.sql\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/src/pages/admin/RolesPage.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="Admin routes with navigation" errors="Route failures" side_effects="Navigation, page rendering"]
+// CIL[DOC-MICRO logic_summary="Builds breadcrumbs, defines extensive admin routes, handles legacy redirects" notable_decisions="['breadcrumb_generation', 'legacy_route_redirects']"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-VECTOR type="context" content="Layer: admin-routing. Direct callers: 0. Direct calls: 0. Related files: .framework/src/pages/admin/IntegrationsPage.tsx, custom/apps/portal/pages/ContentPage.tsx, .framework/migrations/015_simplify_apps_table.sql, .framework/src/pages/admin/TypeDetailPage.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"]
 function AdminRoutes() {
   const location = useLocation()
 
-  // Build breadcrumbs from current path
   const pathSegments = location.pathname.split('/').filter(Boolean)
   const breadcrumbs: { title: string; url?: string }[] = [{ title: 'Spine', url: '/dashboard' }]
 
-  // Add admin section
   if (pathSegments.includes('admin')) {
     breadcrumbs.push({ title: 'Admin', url: '/spine-framework/admin' })
 
-    // Add subsection
     const section = pathSegments[2]
     if (section) {
       breadcrumbs.push({ title: section.charAt(0).toUpperCase() + section.slice(1) })
@@ -84,11 +128,9 @@ function AdminRoutes() {
     >
       <Suspense fallback={<div className="min-h-[400px] flex items-center justify-center"><LoadingSpinner /></div>}>
         <Routes>
-          {/* Default redirect → configs */}
           <Route index element={<Navigate to="configs/types" replace />} />
           <Route path="dashboard" element={<Navigate to="configs/types" replace />} />
 
-          {/* Configs section */}
           <Route path="configs/types/new" element={<TypeDetailPage />} />
           <Route path="configs/types/:id" element={<TypeDetailPage />} />
           <Route path="configs/types" element={<TypesPage />} />
@@ -104,9 +146,6 @@ function AdminRoutes() {
           <Route path="configs/ai-agents/new" element={<AIAgentDetailPage />} />
           <Route path="configs/ai-agents/:id" element={<AIAgentDetailPage />} />
           <Route path="configs/ai-agents" element={<AIAgentsPage />} />
-          <Route path="configs/embeddings/new" element={<EmbeddingDetailPage />} />
-          <Route path="configs/embeddings/:id" element={<EmbeddingDetailPage />} />
-          <Route path="configs/embeddings" element={<EmbeddingsPage />} />
           <Route path="configs/timers/new" element={<TimerDetailPage />} />
           <Route path="configs/timers/:id" element={<TimerDetailPage />} />
           <Route path="configs/timers" element={<TimersPage />} />
@@ -122,11 +161,10 @@ function AdminRoutes() {
           <Route path="configs/api-keys/new" element={<APIKeyDetailPage />} />
           <Route path="configs/api-keys/:id" element={<APIKeyDetailPage />} />
           <Route path="configs/api-keys" element={<APIKeysPage />} />
+          <Route path="configs/deliveries" element={<DeliveriesPage />} />
 
-          {/* Access section */}
           <Route path="access/invites" element={<InvitesPage />} />
 
-          {/* Observability section */}
           <Route path="observability" element={<ObservabilityDashboard />} />
           <Route path="observability/dashboard" element={<ObservabilityDashboard />} />
           <Route path="observability/alerts" element={<AlertsConfigPage />} />
@@ -134,7 +172,6 @@ function AdminRoutes() {
           <Route path="observability/executions" element={<PipelineExecutionsPage />} />
           <Route path="observability/logs" element={<LogsPage />} />
 
-          {/* Testing section */}
           <Route path="testing/:run_id" element={<TestRunDetailPage />} />
           <Route path="testing" element={<TestingDashboard />} />
           <Route path="test/ui" element={<ShadcnTestPage />} />
@@ -147,12 +184,30 @@ function AdminRoutes() {
           <Route path="test/integrated" element={<IntegratedDashboard />} />
           <Route path="test/simple" element={<SimpleDashboard />} />
 
-          {/* Runtime Data - Unified entity management */}
           <Route path="runtime/:entity" element={<DataListPage />} />
           <Route path="runtime/:entity/new" element={<DataDetailPage />} />
           <Route path="runtime/:entity/:id" element={<DataDetailPage />} />
 
-          {/* Legacy data routes - redirect to runtime routes */}
+          <Route path="cil" element={<CILProjectsPage />} />
+          <Route path="cil/search" element={<CILSearchPage />} />
+          <Route path="cil/agent" element={<CILAgentPage />} />
+          <Route path="cil/:id" element={<CILDashboardPage />} />
+          <Route path="cil/:id/dashboard" element={<CILDashboardPage />} />
+          <Route path="cil/:id/files" element={<CILFileListPage />} />
+          <Route path="cil/:id/graph" element={<CILGraphPage />} />
+          <Route path="cil/:id/agent" element={<CILAgentPage />} />
+          <Route path="cil/:id/ingest" element={<CILIngestionPage />} />
+          <Route path="cil/:id/flexible" element={<FlexiblePipelinePage />} />
+          <Route path="cil/:id/chunks/:chunkId" element={<CILChunkDetailPage />} />
+          <Route path="cil/chunks/:chunkId" element={<CILChunkDetailPage />} />
+
+          <Route path="kb/embeddings/:id" element={<EmbeddingDetailPage />} />
+          <Route path="kb/embeddings" element={<EmbeddingsPage />} />
+          <Route path="kb/:typeSlug" element={<KBAdminPage />} />
+          <Route path="kb/:typeSlug/new" element={<KBAdminPage mode="new" />} />
+          <Route path="kb/:typeSlug/:id" element={<KBAdminPage mode="view" />} />
+          <Route path="kb/:typeSlug/:id/edit" element={<KBAdminPage mode="edit" />} />
+
           <Route path="data/:entity" element={<Navigate to="../runtime/:entity" replace />} />
           <Route path="data/:entity/create" element={<Navigate to="../runtime/:entity/new" replace />} />
           <Route path="data/:entity/:id" element={<Navigate to="../runtime/:entity/:id" replace />} />
@@ -163,7 +218,21 @@ function AdminRoutes() {
     </AppShell>
   )
 }
-
+// CIL[END chunk_id="index_adminroutes_1783931090"]
+// CIL[BEGIN chunk_id="index_adminapp_1783931090" type="function" identity="AdminApp" parent="none"]
+// CIL[DOC-MACRO purpose="Admin app entry point with system admin access control"]
+// CIL[DOC-RESPONSIBILITY responsibility="Gate admin access and provide tooltip context"]
+// CIL[DOC-CONTEXT module="admin-index" layer="admin-routing" related_files="[\".framework/src/pages/admin/RolesPage.tsx\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/src/pages/admin/IntegrationsPage.tsx\",\".framework/migrations/015_simplify_apps_table.sql\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="Protected admin interface" errors="Access denied" side_effects="Navigation, tooltip context"]
+// CIL[DOC-MICRO logic_summary="Checks system admin role, redirects unauthorized users, wraps routes" notable_decisions="['role_based_access', 'tooltip_provider_wrapper']"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-VECTOR type="context" content="Layer: admin-routing. Direct callers: 0. Direct calls: 0. Related files: .framework/src/pages/admin/RolesPage.tsx, .framework/src/pages/admin/TypeDetailPage.tsx, .framework/src/pages/admin/IntegrationsPage.tsx, .framework/migrations/015_simplify_apps_table.sql, \."]
+// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
+// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
+// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 export default function AdminApp() {
   const { user } = useAuth()
 
@@ -177,3 +246,4 @@ export default function AdminApp() {
     </TooltipProvider>
   )
 }
+// CIL[END chunk_id="index_adminapp_1783931090"]

package/.framework/src/components/AppWrapper.tsx

@@ -1,29 +1,68 @@
+
+
+
+// CIL[BEGIN chunk_id="AppWrapper_module_header_1783931090" type="module_header" identity="imports" parent="none"]
+// CIL[DOC-MACRO purpose="Import React and context dependencies for app wrapper"]
+// CIL[DOC-RESPONSIBILITY responsibility="Manage all external module imports for app wrapper component"]
+// CIL[DOC-CONTEXT module="AppWrapper" layer="component" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\"custom/apps/portal/pages/CoursesPage.tsx\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\"custom/apps/cortex/functions/custom_cil-embeddings.ts\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="Imported modules and types" errors="Import failures" side_effects="Module loading"]
+// CIL[DOC-MICRO logic_summary="Imports React, routing, auth context, app context, and app types" 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: component. Direct callers: 0. Direct calls: 0. Related files: custom/apps/portal/pages/ContentPage.tsx, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, custom/apps/portal/pages/CoursesPage.tsx, .framework/src/pages/admin/TypeDetailPage.tsx, custom/apps/cortex/functions/custom_cil-embeddings.ts, \."]
+// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
+// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
+// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 import React from 'react'
 import { Navigate } from 'react-router-dom'
 import { useAuth } from '../contexts/AuthContext'
 import { AppProvider } from '../contexts/AppContext'
 import { AppRecord } from '../hooks/useApps'
-
+// CIL[END chunk_id="AppWrapper_module_header_1783931090"]
+// CIL[BEGIN chunk_id="AppWrapper_interface_1783931090" type="interface" identity="AppWrapperProps" parent="none"]
+// CIL[DOC-MACRO purpose="Define props interface for AppWrapper component"]
+// CIL[DOC-RESPONSIBILITY responsibility="Type definition for app wrapper properties"]
+// CIL[DOC-CONTEXT module="AppWrapper" layer="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\",\"custom/apps/portal/pages/CoursesPage.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="Type interface" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Defines app record and children props for wrapper component" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="1.00" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-VECTOR type="context" content="Layer: component. Direct callers: 0. Direct calls: 0. Related files: .framework/src/components/layout/Sidebar.tsx, .framework/functions/_shared/schema-utils.ts, .framework/src/components/ui/dialog.tsx, custom/apps/portal/pages/ContentPage.tsx, custom/apps/portal/pages/CoursesPage.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 AppWrapperProps {
   app: AppRecord
   children: React.ReactNode
 }
-
-/**
- * Shared wrapper for all apps. Provides:
- * - Auth gate: redirects to /login if unauthenticated
- * - Role gate: shows 403 if user lacks app's min_role
- * - App context: makes app record available via useCurrentApp()
- */
+// CIL[END chunk_id="AppWrapper_interface_1783931090"]
+// CIL[BEGIN chunk_id="AppWrapper_appwrapper_1783931090" type="function" identity="AppWrapper" parent="none"]
+// CIL[DOC-LEARNING topic="AppWrapper:role_gate" content="Access is denied unless user.roles includes system_admin or intersects app.required_roles. Missing roles in public.roles produce an Access Denied page even when the app is otherwise routable."]
+// CIL[DOC-MACRO purpose="Wrapper component providing auth gates and app context"]
+// CIL[DOC-RESPONSIBILITY responsibility="Handle authentication, role checking, and app context provision"]
+// CIL[DOC-CONTEXT module="AppWrapper" layer="component" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\"custom/apps/portal/pages/CoursesPage.tsx\",\".framework/src/components/ui/dialog.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/src/components/layout/Sidebar.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="Protected app content" errors="Access denied" side_effects="Navigation, context provision"]
+// CIL[DOC-MICRO logic_summary="Auth gate, role validation, access denied UI, app context wrapper" notable_decisions="['role_based_access', 'fallback_to_min_role']"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-VECTOR type="context" content="Layer: component. Direct callers: 0. Direct calls: 0. Related files: custom/apps/portal/pages/ContentPage.tsx, custom/apps/portal/pages/CoursesPage.tsx, .framework/src/components/ui/dialog.tsx, custom/apps/cortex/pages/operations/OperationsDashboard.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"]
 export function AppWrapper({ app, children }: AppWrapperProps) {
   const { user } = useAuth()
 
-  // Auth gate
   if (!user) {
     return <Navigate to="/login" replace />
   }
 
-  // Role gate — check required_roles array (preferred) or min_role (fallback)
   const requiredRoles: string[] = app.required_roles?.length
     ? app.required_roles
     : app.min_role ? [app.min_role] : []
@@ -52,10 +91,10 @@ export function AppWrapper({ app, children }: AppWrapperProps) {
     }
   }
 
-  // App context
   return (
     <AppProvider app={app}>
       {children}
     </AppProvider>
   )
 }
+// CIL[END chunk_id="AppWrapper_appwrapper_1783931090"]

package/.framework/src/components/CustomAppLoader.tsx

@@ -1,9 +1,44 @@
+
+
+
+
+
+
+
+
+// CIL[BEGIN chunk_id="CustomAppLoader_module_header_1783931090" type="module_header" identity="imports" parent="none"]
+// CIL[DOC-MACRO purpose="Import React components and utilities for custom app loading"]
+// CIL[DOC-RESPONSIBILITY responsibility="Manage all external module imports for app loader"]
+// CIL[DOC-CONTEXT module="CustomAppLoader" layer="component" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\"custom/apps/cortex/functions/custom_cil-embeddings.ts\",\".framework/src/components/ui/dialog.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="Imported modules and types" errors="Import failures" side_effects="Module loading"]
+// CIL[DOC-MICRO logic_summary="Imports React hooks, lazy loading, error boundary, and UI components" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-AUDIENCE audience="developer"]
+// CIL[DOC-VECTOR type="context" content="Layer: component. Direct callers: 0. Direct calls: 0. Related files: custom/apps/portal/pages/ContentPage.tsx, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, custom/apps/cortex/functions/custom_cil-embeddings.ts, .framework/src/components/ui/dialog.tsx, \."]
+// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
+// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
+// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 import React, { lazy, Suspense, Component } from 'react'
 import type { ReactNode } from 'react'
 import { LoadingSpinner } from './ui/LoadingSpinner'
-
-// ─── ERROR BOUNDARY ───────────────────────────────────────────────────────────
-
+// CIL[END chunk_id="CustomAppLoader_module_header_1783931090"]
+// CIL[BEGIN chunk_id="CustomAppLoader_error_boundary_interfaces_1783931090" type="interfaces" identity="error_boundary_interfaces" parent="none"]
+// CIL[DOC-MACRO purpose="Define interfaces for error boundary component"]
+// CIL[DOC-RESPONSIBILITY responsibility="Type definitions for error boundary props and state"]
+// CIL[DOC-CONTEXT module="CustomAppLoader" layer="component" related_files="[\".framework/src/components/ui/dialog.tsx\",\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/functions/_shared/principal.ts\",\".framework/functions/_shared/schema-utils.ts\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="Type interfaces" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Defines props with slug and children, state with error tracking" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="1.00" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-VECTOR type="context" content="Layer: component. Direct callers: 0. Direct calls: 0. Related files: .framework/src/components/ui/dialog.tsx, custom/apps/portal/pages/ContentPage.tsx, .framework/functions/_shared/principal.ts, .framework/functions/_shared/schema-utils.ts, .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"]
 interface ErrorBoundaryProps {
   slug: string
   children: ReactNode
@@ -12,7 +47,21 @@ interface ErrorBoundaryProps {
 interface ErrorBoundaryState {
   error: Error | null
 }
-
+// CIL[END chunk_id="CustomAppLoader_error_boundary_interfaces_1783931090"]
+// CIL[BEGIN chunk_id="CustomAppLoader_apperrorboundary_1783931090" type="class" identity="AppErrorBoundary" parent="none"]
+// CIL[DOC-MACRO purpose="Error boundary component to catch and display app loading errors"]
+// CIL[DOC-RESPONSIBILITY responsibility="Handle app loading failures with user-friendly error display"]
+// CIL[DOC-CONTEXT module="CustomAppLoader" layer="component" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\"custom/apps/cortex/functions/custom_cil-embeddings.ts\",\".framework/src/components/ui/dialog.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="Error UI or children" errors="App loading failures" side_effects="Error state management"]
+// CIL[DOC-MICRO logic_summary="Catches errors, displays error UI with app slug and error details" notable_decisions="['error_boundary_pattern', 'user_friendly_errors']"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-VECTOR type="context" content="Layer: component. Direct callers: 0. Direct calls: 0. Related files: custom/apps/portal/pages/ContentPage.tsx, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, custom/apps/cortex/functions/custom_cil-embeddings.ts, .framework/src/components/ui/dialog.tsx, \."]
+// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
+// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
+// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 class AppErrorBoundary extends Component<ErrorBoundaryProps, ErrorBoundaryState> {
   constructor(props: ErrorBoundaryProps) {
     super(props)
@@ -51,33 +100,68 @@ class AppErrorBoundary extends Component<ErrorBoundaryProps, ErrorBoundaryState>
     return this.props.children
   }
 }
-
-// ─── LOADER ───────────────────────────────────────────────────────────────────
-
-// Static glob maps — Vite analyzes these at build time and builds a complete
-// module map. Runtime lookup is just a map key lookup, no dynamic string eval.
-// Custom apps take precedence over core apps with the same slug.
+// CIL[END chunk_id="CustomAppLoader_apperrorboundary_1783931090"]
+// CIL[BEGIN chunk_id="CustomAppLoader_loader_setup_1783931090" type="loader_setup" identity="loader_setup" parent="none"]
+// CIL[DOC-MACRO purpose="Set up module glob patterns and cache for app loading"]
+// CIL[DOC-RESPONSIBILITY responsibility="Configure module discovery and caching for apps"]
+// CIL[DOC-CONTEXT module="CustomAppLoader" layer="component" related_files="[\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\"custom/apps/cortex/functions/custom_cil-embeddings.ts\",\".framework/functions/_shared/principal.ts\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="Module globs and cache map" errors="none" side_effects="Module resolution"]
+// CIL[DOC-MICRO logic_summary="Defines custom and core app module patterns, creates component cache" notable_decisions="['glob_patterns', 'module_caching']"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-VECTOR type="context" content="Layer: component. Direct callers: 0. Direct calls: 0. Related files: custom/apps/cortex/pages/operations/OperationsDashboard.tsx, custom/apps/portal/pages/ContentPage.tsx, .framework/src/pages/admin/TypeDetailPage.tsx, custom/apps/cortex/functions/custom_cil-embeddings.ts, .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"]
 const customAppModules = import.meta.glob('../../../custom/apps/*/index.tsx')
 const coreAppModules   = import.meta.glob('../apps/*/index.tsx')
 
-// Module-level cache for lazy components to avoid re-creating on each render
 const appModuleCache = new Map<string, React.LazyExoticComponent<React.ComponentType>>()
-
-// Resolve the glob key for a given slug from the custom or core map.
+// CIL[END chunk_id="CustomAppLoader_loader_setup_1783931090"]
+// CIL[BEGIN chunk_id="CustomAppLoader_resolveapploader_1783931090" type="function" identity="resolveAppLoader" parent="none"]
+// CIL[DOC-LEARNING topic="CustomAppLoader:slug_folder_match" content="CustomAppLoader resolves custom/apps/{slug}/index.tsx from the DB apps.slug. The slug must match the filesystem folder name or the lazy import will reject with 'App not found'."]
+// CIL[DOC-MACRO purpose="Resolve app slug to module loader function"]
+// CIL[DOC-RESPONSIBILITY responsibility="Map app slug to appropriate module loader"]
+// CIL[DOC-CONTEXT module="CustomAppLoader" layer="component" related_files="[]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="loader function or null" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Checks custom apps first, falls back to core apps, returns loader" notable_decisions="['custom_priority', 'fallback_pattern']"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-VECTOR type="context" content="Layer: component. Direct callers: 0. Direct calls: 0. Related files: 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"]
 function resolveAppLoader(slug: string): (() => Promise<{ default: React.ComponentType }>) | null {
-  // Check custom first (custom/apps/{slug}/index.tsx)
   const customKey = `../../../custom/apps/${slug}/index.tsx`
   if (customAppModules[customKey]) {
     return customAppModules[customKey] as () => Promise<{ default: React.ComponentType }>
   }
-  // Fall back to core (../apps/{slug}/index.tsx relative to this file)
   const coreKey = `../apps/${slug}/index.tsx`
   if (coreAppModules[coreKey]) {
     return coreAppModules[coreKey] as () => Promise<{ default: React.ComponentType }>
   }
   return null
 }
-
+// CIL[END chunk_id="CustomAppLoader_resolveapploader_1783931090"]
+// CIL[BEGIN chunk_id="CustomAppLoader_getappcomponent_1783931090" type="function" identity="getAppComponent" parent="none"]
+// CIL[DOC-NOTE type="caution" content="import.meta.glob is resolved at Vite startup; adding or renaming a custom app folder requires running npm run assemble and restarting the dev server before CustomAppLoader can discover it."]
+// CIL[DOC-MACRO purpose="Get or create cached lazy component for app slug"]
+// CIL[DOC-RESPONSIBILITY responsibility="Manage lazy component creation and caching"]
+// CIL[DOC-CONTEXT module="CustomAppLoader" layer="component" related_files="[]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="Lazy component" errors="App not found" side_effects="Cache updates"]
+// CIL[DOC-MICRO logic_summary="Checks cache, creates lazy component, caches result, handles missing apps" notable_decisions="['lazy_component_creation', 'error_rejection']"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-VECTOR type="context" content="Layer: component. Direct callers: 0. Direct calls: 0. Related files: 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"]
 function getAppComponent(slug: string): React.LazyExoticComponent<React.ComponentType> {
   if (!appModuleCache.has(slug)) {
     const loader = resolveAppLoader(slug)
@@ -90,15 +174,39 @@ function getAppComponent(slug: string): React.LazyExoticComponent<React.Componen
   }
   return appModuleCache.get(slug)!
 }
-
+// CIL[END chunk_id="CustomAppLoader_getappcomponent_1783931090"]
+// CIL[BEGIN chunk_id="CustomAppLoader_interface_1783931090" type="interface" identity="CustomAppLoaderProps" parent="none"]
+// CIL[DOC-MACRO purpose="Define props interface for CustomAppLoader component"]
+// CIL[DOC-RESPONSIBILITY responsibility="Type definition for custom app loader properties"]
+// CIL[DOC-CONTEXT module="CustomAppLoader" layer="component" related_files="[]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="Type interface" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Defines slug prop for app identification" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="1.00" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-VECTOR type="context" content="Layer: component. Direct callers: 0. Direct calls: 0. Related files: 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 CustomAppLoaderProps {
   slug: string
 }
-
-/**
- * Lazy-loads a custom app component from apps/{slug}/index.tsx.
- * Wraps in an error boundary so a broken app doesn't crash the entire site.
- */
+// CIL[END chunk_id="CustomAppLoader_interface_1783931090"]
+// CIL[BEGIN chunk_id="CustomAppLoader_customapploader_1783931090" type="function" identity="CustomAppLoader" parent="none"]
+// CIL[DOC-MACRO purpose="Main component for lazy-loading custom apps with error handling"]
+// CIL[DOC-RESPONSIBILITY responsibility="Wrap app component in error boundary and suspense for loading"]
+// CIL[DOC-CONTEXT module="CustomAppLoader" layer="component" related_files="[]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="Loaded app component" errors="App loading failures" side_effects="Lazy loading, error handling"]
+// CIL[DOC-MICRO logic_summary="Gets cached component, wraps in error boundary and suspense" notable_decisions="['error_boundary_wrapping', 'suspense_fallback']"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-VECTOR type="context" content="Layer: component. Direct callers: 0. Direct calls: 0. Related files: 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 CustomAppLoader({ slug }: CustomAppLoaderProps) {
   const AppComponent = getAppComponent(slug)
 
@@ -114,3 +222,4 @@ export function CustomAppLoader({ slug }: CustomAppLoaderProps) {
     </AppErrorBoundary>
   )
 }
+// CIL[END chunk_id="CustomAppLoader_customapploader_1783931090"]