spine-framework 0.3.124 → 0.3.126

package/.framework/src/pages/admin/RolesPage.tsx

@@ -1,18 +1,22 @@
-/**
- * @module src/pages/admin/RolesPage
- * @audience installer
- * @layer frontend-page
- * @stability stable
- *
- * Admin list page for roles. Fetches all roles via `/api/roles?action=list`,
- * applies client-side search and sort, and renders inside `AdminListPage`
- * with stat cards and a sortable table. Row clicks navigate to
- * `/spine-framework/admin/configs/roles/:id`.
- *
- * @seeAlso src/components/admin/AdminListPage.tsx
- * @seeAlso src/pages/admin/RoleDetailPage.tsx
- */
 
+
+
+
+// CIL[BEGIN chunk_id="rolespage_module_header_1783665503" type="module_header" identity="module_header" parent="none"]
+// CIL[DOC-MACRO purpose="Import dependencies and define Role interface for admin roles management"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide React imports, UI components, and Role type definition"]
+// CIL[DOC-CONTEXT module="RolesPage" layer="frontend-page" related_files="[\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="React components and Role interface" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Imports React hooks, UI components, and defines Role data structure" 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-page. Direct callers: 0. Direct calls: 0. Related files: custom/apps/cortex/pages/operations/OperationsDashboard.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 { Plus, ShieldCheck, CheckCircle, XCircle, Settings, FileText, Cog } from 'lucide-react';
 import { LoadingSpinner } from '../../components/ui/LoadingSpinner'
@@ -36,7 +40,21 @@ interface Role {
   created_at: string
   updated_at: string
 }
-
+// CIL[END chunk_id="rolespage_module_header_1783665503"]
+// CIL[BEGIN chunk_id="rolespage_rolespage_1783665503" type="function" identity="RolesPage" parent="none"]
+// CIL[DOC-MACRO purpose="Render the complete roles management page UI"]
+// CIL[DOC-RESPONSIBILITY responsibility="Display roles list with search, filters, stats, and table"]
+// CIL[DOC-CONTEXT module="RolesPage" layer="frontend-page" related_files="[\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\"custom/apps/portal/pages/ContentPage.tsx\",\"custom/apps/portal/pages/CoursesPage.tsx\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="AdminListPage JSX" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Renders AdminListPage with roles data, empty states, and table" 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-page. Direct callers: 0. Direct calls: 0. Related files: custom/apps/cortex/pages/operations/OperationsDashboard.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"]
 export function RolesPage() {
   const [searchTerm, setSearchTerm] = useState('')
   const [selectedStatus, setSelectedStatus] = useState('all')
@@ -44,7 +62,7 @@ export function RolesPage() {
   const [sortKey, setSortKey] = useState('name')
   const [sortDirection, setSortDirection] = useState<'asc' | 'desc'>('asc')
 
-  // Fetch roles from API
+  
   const { data: roles, loading, error, refetch } = useApi<Role[]>(
     async () => {
       const response = await apiFetch('/api/roles?action=list')
@@ -68,7 +86,21 @@ export function RolesPage() {
     return matchesSearch && matchesStatus && matchesType
   })
 
-  // Helper functions
+  
+  // CIL[BEGIN chunk_id="rolespage_getstatusbadge_1783665503" type="function" identity="getStatusBadge" parent="rolespage_rolespage_1783665503"]
+// CIL[DOC-MACRO purpose="Generate status badge component based on role properties"]
+// CIL[DOC-RESPONSIBILITY responsibility="Handle getStatusBadge"]
+// CIL[DOC-CONTEXT module="RolesPage" layer="frontend-page" related_files="[\".framework/src/components/ui/dialog.tsx\",\".framework/src/components/layout/Sidebar.tsx\",\"custom/apps/portal/pages/ContentPage.tsx\",\"custom/apps/portal/pages/CoursesPage.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="JSX badge element" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Checks is_active and is_system flags to determine badge styling" 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-page. Direct callers: 4. Direct calls: 0. Related files: .framework/src/components/ui/dialog.tsx, .framework/src/components/layout/Sidebar.tsx, custom/apps/portal/pages/ContentPage.tsx, custom/apps/portal/pages/CoursesPage.tsx, \."]
+// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 4. Total affected: 4."]
+// 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 getStatusBadge = (role: Role) => {
     if (!role.is_active) {
       return <span className="inline-flex px-2 py-0.5 text-xs font-medium rounded-md bg-slate-100 text-slate-600">Inactive</span>
@@ -78,7 +110,22 @@ export function RolesPage() {
     }
     return <span className="inline-flex px-2 py-0.5 text-xs font-medium rounded-md bg-blue-100 text-blue-700">Custom</span>
   }
+// CIL[END chunk_id="rolespage_getstatusbadge_1783665503"]
 
+// CIL[BEGIN chunk_id="rolespage_handlesort_1783665503" type="function" identity="handleSort" parent="rolespage_rolespage_1783665503"]
+// CIL[DOC-MACRO purpose="Handle table column sorting with direction toggle"]
+// CIL[DOC-RESPONSIBILITY responsibility="Handle handleSort"]
+// CIL[DOC-CONTEXT module="RolesPage" layer="frontend-page" related_files="[\".framework/functions/_shared/schema-utils.ts\",\".framework/src/components/ui/dialog.tsx\",\".framework/functions/_shared/principal.ts\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="state updates" errors="none" side_effects="Updates component state"]
+// CIL[DOC-MICRO logic_summary="Toggles direction if same key, sets new key and asc direction otherwise" 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-page. Direct callers: 0. Direct calls: 0. Related files: .framework/functions/_shared/schema-utils.ts, .framework/src/components/ui/dialog.tsx, .framework/functions/_shared/principal.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"]
   const handleSort = (key: string) => {
     if (sortKey === key) {
       setSortDirection(sortDirection === 'asc' ? 'desc' : 'asc')
@@ -87,12 +134,41 @@ export function RolesPage() {
       setSortDirection('asc')
     }
   }
+// CIL[END chunk_id="rolespage_handlesort_1783665503"]
 
+// CIL[BEGIN chunk_id="rolespage_handlerowclick_1783665503" type="function" identity="handleRowClick" parent="rolespage_rolespage_1783665503"]
+// CIL[DOC-MACRO purpose="Navigate to role detail page when table row is clicked"]
+// CIL[DOC-RESPONSIBILITY responsibility="Handle handleRowClick"]
+// CIL[DOC-CONTEXT module="handleRowClick" layer="unknown" related_files="[]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Implements handleRowClick" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-VECTOR type="context" content="Layer: unknown. 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"]
   const handleRowClick = (role: Role) => {
     window.location.href = `/spine-framework/admin/configs/roles/${role.id}`
   }
+// CIL[END chunk_id="rolespage_handlerowclick_1783665503"]
 
-  // Sort roles
+// CIL[BEGIN chunk_id="rolespage_sortedroles_1783665503" type="variable" identity="sortedRoles" parent="rolespage_rolespage_1783665503"]
+// CIL[DOC-MACRO purpose="Sort filtered roles based on current sort key and direction"]
+// CIL[DOC-RESPONSIBILITY responsibility="Handle sortedRoles"]
+// CIL[DOC-CONTEXT module="RolesPage" layer="frontend-page" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\"custom/apps/portal/pages/CoursesPage.tsx\",\".framework/src/components/ui/dialog.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="sorted array" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Handles string and boolean sorting with localeCompare" 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-page. 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, \."]
+// 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 sortedRoles = [...(filteredRoles || [])].sort((a, b) => {
     let aValue: any = a[sortKey as keyof Role]
     let bValue: any = b[sortKey as keyof Role]
@@ -109,7 +185,22 @@ export function RolesPage() {
     
     return 0
   })
+// CIL[END chunk_id="rolespage_sortedroles_1783665503"]
 
+  // CIL[BEGIN chunk_id="rolespage_statcards_1783665503" type="variable" identity="statsCards" parent="rolespage_rolespage_1783665503"]
+// CIL[DOC-MACRO purpose="Generate statistics cards for roles dashboard"]
+// CIL[DOC-RESPONSIBILITY responsibility="Handle statsCards"]
+// CIL[DOC-CONTEXT module="RolesPage" layer="frontend-page" related_files="[\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="stats cards array" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Calculates total, active, system, and custom role counts" 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-page. Direct callers: 0. Direct calls: 0. Related files: custom/apps/cortex/pages/operations/OperationsDashboard.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"]
   const statsCards = [
     {
       title: 'Total Roles',
@@ -136,19 +227,64 @@ export function RolesPage() {
       iconColor: 'text-orange-500'
     }
   ]
+// CIL[END chunk_id="rolespage_statcards_1783665503"]
 
+// CIL[BEGIN chunk_id="rolespage_statusoptions_1783665503" type="variable" identity="statusOptions" parent="rolespage_rolespage_1783665503"]
+// CIL[DOC-MACRO purpose="Define filter options for role status dropdown"]
+// CIL[DOC-RESPONSIBILITY responsibility="Handle statusOptions"]
+// CIL[DOC-CONTEXT module="RolesPage" layer="frontend-page" related_files="[\".framework/functions/_shared/principal.ts\",\".framework/src/pages/admin/IntegrationsPage.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="status options array" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Static array of status filter options" 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-page. Direct callers: 0. Direct calls: 0. Related files: .framework/functions/_shared/principal.ts, .framework/src/pages/admin/IntegrationsPage.tsx, \."]
+// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
+// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
+// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
   const statusOptions = [
     { value: 'all', label: 'All Status' },
     { value: 'active', label: 'Active' },
     { value: 'inactive', label: 'Inactive' }
   ]
+// CIL[END chunk_id="rolespage_statusoptions_1783665503"]
 
+// CIL[BEGIN chunk_id="rolespage_typeoptions_1783665503" type="variable" identity="typeOptions" parent="rolespage_rolespage_1783665503"]
+// CIL[DOC-MACRO purpose="Define filter options for role type dropdown"]
+// CIL[DOC-RESPONSIBILITY responsibility="Handle typeOptions"]
+// CIL[DOC-CONTEXT module="RolesPage" layer="frontend-page" related_files="[\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/functions/_shared/schema-utils.ts\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="type options array" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Static array of role type filter options" 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-page. Direct callers: 0. Direct calls: 0. Related files: .framework/src/pages/admin/TypeDetailPage.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 typeOptions = [
     { value: 'all', label: 'All Types' },
     { value: 'system', label: 'System' },
     { value: 'custom', label: 'Custom' }
   ]
+// CIL[END chunk_id="rolespage_typeoptions_1783665503"]
 
+// CIL[BEGIN chunk_id="rolespage_filters_1783665503" type="variable" identity="filters" parent="rolespage_rolespage_1783665503"]
+// CIL[DOC-MACRO purpose="Combine status and type filters for AdminListPage component"]
+// CIL[DOC-RESPONSIBILITY responsibility="Handle filters"]
+// CIL[DOC-CONTEXT module="RolesPage" layer="frontend-page" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/src/components/layout/Sidebar.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="filters array" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Maps filter options to AdminListPage filter format" 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-page. 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/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"]
   const filters = [
     {
       label: 'Status',
@@ -163,7 +299,22 @@ export function RolesPage() {
       onChange: setSelectedType
     }
   ]
+// CIL[END chunk_id="rolespage_filters_1783665503"]
 
+  // CIL[BEGIN chunk_id="rolespage_return_1783665503" type="jsx" identity="return" parent="rolespage_rolespage_1783665503"]
+// CIL[DOC-MACRO purpose="Render the complete roles management page UI"]
+// CIL[DOC-RESPONSIBILITY responsibility="Handle return"]
+// CIL[DOC-CONTEXT module="return" layer="unknown" related_files="[]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Implements return" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-VECTOR type="context" content="Layer: unknown. 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"]
   return (
     <AdminListPage
       title="Roles"
@@ -289,4 +440,6 @@ export function RolesPage() {
       )}
     </AdminListPage>
   )
+// CIL[END chunk_id="rolespage_return_1783665503"]
 }
+// CIL[END chunk_id="rolespage_rolespage_1783665503"]

package/.framework/src/pages/admin/SelectTestPage.tsx

@@ -1,12 +1,22 @@
-/**
- * @module src/pages/admin/SelectTestPage
- * @audience installer
- * @layer frontend-page
- * @stability testing
- *
- * Test page to isolate Select component issues.
- */
 
+
+
+
+// CIL[BEGIN chunk_id="selecttestpage_module_header_1783665503" type="module_header" identity="module_header" parent="none"]
+// CIL[DOC-MACRO purpose="Import React hooks and UI components for Select test page"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide React state and shadcn UI components"]
+// CIL[DOC-CONTEXT module="SelectTestPage" layer="frontend-page" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/src/components/ui/dialog.tsx\",\".framework/src/pages/admin/RolesPage.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="React hooks and UI components" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Imports useState and shadcn Select 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: frontend-page. Direct callers: 0. Direct calls: 0. Related files: custom/apps/portal/pages/ContentPage.tsx, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .framework/src/pages/admin/TypeDetailPage.tsx, .framework/src/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 { Card, CardContent, CardDescription, CardHeader, CardTitle } from '../../components/ui/card'
 import { 
@@ -17,7 +27,21 @@ import {
   SelectValue,
 } from '../../components/ui/select'
 import { Label } from '../../components/ui/label'
-
+// CIL[END chunk_id="selecttestpage_module_header_1783665503"]
+// CIL[BEGIN chunk_id="selecttestpage_selecttestpage_1783665503" type="function" identity="SelectTestPage" parent="none"]
+// CIL[DOC-MACRO purpose="Test page for shadcn Select component functionality"]
+// CIL[DOC-RESPONSIBILITY responsibility="Demonstrate Select component with state management"]
+// CIL[DOC-CONTEXT module="SelectTestPage" layer="frontend-page" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/src/pages/admin/TypeDetailPage.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="Select component demo UI" errors="none" side_effects="Updates component state"]
+// CIL[DOC-MICRO logic_summary="Manages selected value state and renders Select component" 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-page. 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/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"]
 export function SelectTestPage() {
   const [selected, setSelected] = useState('')
 
@@ -59,3 +83,4 @@ export function SelectTestPage() {
     </div>
   )
 }
+// CIL[END chunk_id="selecttestpage_selecttestpage_1783665503"]

package/.framework/src/pages/admin/ShadcnTestPage.tsx

@@ -1,13 +1,22 @@
-/**
- * @module src/pages/admin/ShadcnTestPage
- * @audience installer
- * @layer frontend-page
- * @stability testing
- *
- * Test page showcasing all shadcn/ui components with b1a0RuGWG preset.
- * Used to verify shadcn installation and theming is working correctly.
- */
 
+
+
+
+// CIL[BEGIN chunk_id="shadcntestpage_module_header_1783665503" type="module_header" identity="module_header" parent="none"]
+// CIL[DOC-MACRO purpose="Import React hooks and comprehensive shadcn UI components"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide all necessary UI components for testing shadcn library"]
+// CIL[DOC-CONTEXT module="ShadcnTestPage" layer="frontend-page" 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 and 54+ UI components" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Imports useState and extensive shadcn component library" 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-page. 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 { 
   Card, 
@@ -110,18 +119,45 @@ import {
   Info
 } from 'lucide-react'
 import { cn } from '../../lib/utils'
-
+// CIL[END chunk_id="shadcntestpage_module_header_1783665503"]
+// CIL[BEGIN chunk_id="shadcntestpage_shadcntestpage_1783665503" type="function" identity="ShadcnTestPage" parent="none"]
+// CIL[DOC-MACRO purpose="Render comprehensive shadcn component showcase with all UI elements"]
+// CIL[DOC-RESPONSIBILITY responsibility="Display 54+ components in organized sections with interactions"]
+// CIL[DOC-CONTEXT module="ShadcnTestPage" layer="frontend-page" related_files="[\".framework/src/components/ui/dialog.tsx\",\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/src/pages/admin/RolesPage.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="Complete component showcase UI" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Renders cards, forms, interactive elements, and layout components" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-VECTOR type="context" content="Layer: frontend-page. Direct callers: 0. Direct calls: 0. Related files: .framework/src/components/ui/dialog.tsx, custom/apps/portal/pages/ContentPage.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"]
 export function ShadcnTestPage() {
   const [date, setDate] = useState<Date>()
   const [progress, setProgress] = useState(68)
   const [sliderValue, setSliderValue] = useState([50])
   
-  // Simple date formatter since date-fns is not available
   const formatDate = (date: Date | undefined) => {
     if (!date) return 'Pick a date'
     return date.toLocaleDateString('en-US', { month: 'short', day: 'numeric', year: 'numeric' })
   }
 
+  // CIL[BEGIN chunk_id="shadcntestpage_return_1783665503" type="jsx" identity="return" parent="shadcntestpage_shadcntestpage_1783665503"]
+// CIL[DOC-MACRO purpose="Render comprehensive shadcn component showcase with all UI elements"]
+// CIL[DOC-RESPONSIBILITY responsibility="Handle return"]
+// CIL[DOC-CONTEXT module="ShadcnTestPage" layer="frontend-page" related_files="[\".framework/src/components/ui/dialog.tsx\",\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/src/pages/admin/RolesPage.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="Complete component showcase UI" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Renders cards, forms, interactive elements, and layout components" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-VECTOR type="context" content="Layer: frontend-page. Direct callers: 0. Direct calls: 0. Related files: .framework/src/components/ui/dialog.tsx, custom/apps/portal/pages/ContentPage.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"]
   return (
     <TooltipProvider>
       <div className="flex-1 space-y-6 p-8 pt-6">
@@ -585,4 +621,6 @@ export function ShadcnTestPage() {
       </div>
     </TooltipProvider>
   )
+// CIL[END chunk_id="shadcntestpage_return_1783665503"]
 }
+// CIL[END chunk_id="shadcntestpage_shadcntestpage_1783665503"]

package/.framework/src/pages/admin/SimpleDashboard.tsx

@@ -1,13 +1,22 @@
-/**
- * @module src/pages/admin/SimpleDashboard
- * @audience installer
- * @layer frontend-page
- * @stability testing
- *
- * A simple dashboard that works within the existing admin layout.
- * No layout conflicts - just content.
- */
 
+
+
+
+// CIL[BEGIN chunk_id="simpledashboard_module_header_1783665503" type="module_header" identity="module_header" parent="none"]
+// CIL[DOC-MACRO purpose="Import React hooks and UI components for simple dashboard"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide React state and dashboard UI components"]
+// CIL[DOC-CONTEXT module="SimpleDashboard" layer="frontend-page" 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/functions/_shared/principal.ts\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="React hooks and UI components" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Imports useState and dashboard 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: frontend-page. 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/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"]
 import { useState } from 'react'
 import { Card, CardContent, CardDescription, CardHeader, CardTitle } from '../../components/ui/card'
 import { Button } from '../../components/ui/button'
@@ -46,12 +55,40 @@ import {
   Activity,
   Settings
 } from 'lucide-react'
-
+// CIL[END chunk_id="simpledashboard_module_header_1783665503"]
+// CIL[BEGIN chunk_id="simpledashboard_simpledashboard_1783665503" type="function" identity="SimpleDashboard" parent="none"]
+// CIL[DOC-MACRO purpose="Render simple dashboard with stats cards, search, and tabbed content"]
+// CIL[DOC-RESPONSIBILITY responsibility="Display metrics, search bar, and tabbed dashboard sections"]
+// CIL[DOC-CONTEXT module="SimpleDashboard" layer="frontend-page" 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="Complete dashboard UI" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Renders stats cards, search bar, and tabbed content sections" 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-page. 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 SimpleDashboard() {
   const [selectedTab, setSelectedTab] = useState('overview')
   const [searchQuery, setSearchQuery] = useState('')
   const [notifications, setNotifications] = useState(true)
 
+  // CIL[BEGIN chunk_id="simpledashboard_return_1783665503" type="jsx" identity="return" parent="simpledashboard_simpledashboard_1783665503"]
+// CIL[DOC-MACRO purpose="Render simple dashboard with stats cards, search, and tabbed content"]
+// CIL[DOC-RESPONSIBILITY responsibility="Handle return"]
+// CIL[DOC-CONTEXT module="SimpleDashboard" layer="frontend-page" 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="Complete dashboard UI" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Renders stats cards, search bar, and tabbed content sections" 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-page. 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"]
   return (
     <div className="space-y-6">
       {/* Page Header */}
@@ -384,4 +421,6 @@ export function SimpleDashboard() {
       </Tabs>
     </div>
   )
+// CIL[END chunk_id="simpledashboard_return_1783665503"]
 }
+// CIL[END chunk_id="simpledashboard_simpledashboard_1783665503"]

package/.framework/src/pages/admin/TestRunDetailPage.tsx

@@ -1,6 +1,21 @@
-/**
- * @module src/pages/admin/TestRunDetailPage
- */
+
+
+
+// CIL[BEGIN chunk_id="testrundetailpage_module_header_1783665503" type="module_header" identity="module_header" parent="none"]
+// CIL[DOC-MACRO purpose="Import React hooks, router, UI components and define TestRun interface"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide React hooks, UI components, and test run data types"]
+// CIL[DOC-CONTEXT module="TestRunDetailPage" layer="frontend-page" related_files="[\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/src/components/ui/dialog.tsx\",\".framework/functions/_shared/schema-utils.ts\",\".framework/src/pages/admin/IntegrationsPage.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="React hooks, UI components, and TestRun interface" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Imports React hooks, UI components, and defines TestRun interface with constants" 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-page. 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/functions/_shared/schema-utils.ts, .framework/src/pages/admin/IntegrationsPage.tsx, \."]
+// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
+// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
+// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 import { useState, useEffect } from 'react'
 import { useParams, useNavigate } from 'react-router-dom'
 import { apiFetch } from '../../lib/api'
@@ -47,7 +62,21 @@ const STATUSES = [
   { value: 'failed', label: 'Failed' },
   { value: 'skipped', label: 'Skipped' }
 ]
-
+// CIL[END chunk_id="testrundetailpage_module_header_1783665503"]
+// CIL[BEGIN chunk_id="testrundetailpage_testrundetailpage_1783665503" type="function" identity="TestRunDetailPage" parent="none"]
+// CIL[DOC-MACRO purpose="Render test run detail page with form and results table"]
+// CIL[DOC-RESPONSIBILITY responsibility="Display test configuration form and results with edit capabilities"]
+// CIL[DOC-CONTEXT module="TestRunDetailPage" layer="frontend-page" 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\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="Complete detail page UI" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Renders header, configuration form, execution info, and results table" 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-page. 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, \."]
+// 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 TestRunDetailPage() {
   const { id } = useParams<{ id: string }>()
   const navigate = useNavigate()
@@ -121,6 +150,20 @@ export function TestRunDetailPage() {
     { key: 'message' as keyof any, title: 'Message' }
   ]
 
+// CIL[BEGIN chunk_id="testrundetailpage_return_1783665503" type="jsx" identity="return" parent="testrundetailpage_testrundetailpage_1783665503"]
+// CIL[DOC-MACRO purpose="Render test run detail page with form and results table"]
+// CIL[DOC-RESPONSIBILITY responsibility="Handle return"]
+// CIL[DOC-CONTEXT module="TestRunDetailPage" layer="frontend-page" 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\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="Complete detail page UI" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Renders header, configuration form, execution info, and results table" 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-page. 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, \."]
+// 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"]
   return (
     <div className="space-y-6">
       <div className="flex items-center justify-between">
@@ -169,4 +212,6 @@ export function TestRunDetailPage() {
       )}
     </div>
   )
+// CIL[END chunk_id="testrundetailpage_return_1783665503"]
 }
+// CIL[END chunk_id="testrundetailpage_testrundetailpage_1783665503"]