spine-framework 0.3.125 → 0.3.126

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

@@ -1,239 +1,54 @@
-/**
- * @module src/pages/admin/EmbeddingsPage
- * @audience installer
- * @layer frontend-page
- * @stability stable
- *
- * Admin list page for embedding model configurations. Fetches all models
- * via `/api/embeddings?action=list`, applies client-side search, provider
- * filter (`openai` | `anthropic` | `local` | `custom`), and sort. Renders
- * inside `AdminListPage`. Row clicks navigate to
- * `/spine-framework/admin/configs/embeddings/:id`.
- *
- * @seeAlso src/pages/admin/EmbeddingDetailPage.tsx
- */
-
 import { useState } from 'react'
 import { useNavigate } from 'react-router-dom'
-import { Box, FileText, CheckCircle, BarChart3 } from 'lucide-react';
-import { formatDateTime, formatFileSize } from '../../lib/utils'
+import { FileText, CheckCircle, XCircle, AlertCircle } from 'lucide-react'
+import { formatDateTime } from '../../lib/utils'
 import { AdminListPage } from '../../components/admin/AdminListPage'
 import { SortableTableHeader } from '../../components/admin/SortableTableHeader'
-import { Badge } from '../../components/ui/badge'
 import { useApi } from '../../hooks/useApi'
 import { apiFetch } from '../../lib/api'
+import { PageInstructions } from '../../components/admin/PageInstructions'
 
-interface EmbeddingModel {
+interface EmbeddingRecord {
   id: string
-  name: string
-  description?: string
-  model_name: string
-  provider: 'openai' | 'anthropic' | 'local' | 'custom'
-  config: {
-    dimension: number
-    chunk_size: number
-    overlap: number
-    batch_size: number
-  }
-  is_active: boolean
-  created_at: string
-  updated_at: string
-  created_by: string
   account_id: string
-  document_count: number
-  embedding_count: number
-  storage_size: number
-}
-
-interface EmbeddingDocument {
-  id: string
   model_id: string
-  title: string
-  content_type: string
-  status: 'pending' | 'processing' | 'completed' | 'failed'
-  chunk_count: number
-  embedding_count: number
+  document_id: string
+  chunk_index: number
+  content: string
+  embedding: number[]
+  metadata: Record<string, any> | null
+  approved_at: string | null
+  revoked_at: string | null
+  content_hash: string
   created_at: string
   updated_at: string
-  created_by: string
-  error?: string
-}
-
-interface EmbeddingSearch {
-  query: string
-  results: Array<{
-    document_id: string
-    document_title: string
-    chunk_content: string
-    similarity_score: number
-    chunk_index: number
-  }>
-  search_time: number
-  total_results: number
 }
 
 export function EmbeddingsPage() {
   const navigate = useNavigate()
   const [searchTerm, setSearchTerm] = useState('')
-  const [selectedProvider, setSelectedProvider] = useState('all')
-  const [selectedStatus, setSelectedStatus] = useState('all')
-  const [sortKey, setSortKey] = useState('name')
-  const [sortDirection, setSortDirection] = useState<'asc' | 'desc'>('asc')
+  const [sortKey, setSortKey] = useState<string>('created_at')
+  const [sortDirection, setSortDirection] = useState<'asc' | 'desc'>('desc')
 
-  // Fetch embeddings from API
-  const { data: embeddings, loading, error, refetch } = useApi<any[]>(
+  const { data: records, loading, error, refetch } = useApi<EmbeddingRecord[]>(
     async () => {
-      try {
-        console.log('Fetching embeddings...')
-        const response = await apiFetch('/api/embeddings?action=list')
-        console.log('Response status:', response.status)
-        
-        if (!response.ok) {
-          console.error('Response not ok:', response.statusText)
-          throw new Error(`Failed to fetch embeddings: ${response.statusText}`)
-        }
-        
-        const result = await response.json()
-        console.log('Raw API result:', result)
-        
-        // Handle both nested and direct responses
-        const embeddings = result.data || result
-        console.log('Embeddings after processing:', embeddings)
-        
-        return embeddings
-      } catch (error) {
-        console.error('Error in EmbeddingsPage:', error)
-        throw error
-      }
+      const response = await apiFetch('/api/embeddings?method=GET&action=list')
+      if (!response.ok) throw new Error('Failed to fetch embeddings')
+      const result = await response.json()
+      return (result.data || result) as EmbeddingRecord[]
     },
     { immediate: true }
   )
 
-  const mockDocuments: EmbeddingDocument[] = [
-    {
-      id: '1',
-      model_id: '1',
-      title: 'User Guide - Getting Started',
-      content_type: 'pdf',
-      status: 'completed',
-      chunk_count: 45,
-      embedding_count: 45,
-      created_at: new Date(Date.now() - 1000 * 60 * 60 * 24 * 5).toISOString(),
-      updated_at: new Date(Date.now() - 1000 * 60 * 60 * 4).toISOString(),
-      created_by: 'Jane Smith'
-    },
-    {
-      id: '2',
-      model_id: '1',
-      title: 'API Documentation',
-      content_type: 'markdown',
-      status: 'processing',
-      chunk_count: 67,
-      embedding_count: 0,
-      created_at: new Date(Date.now() - 1000 * 60 * 60 * 2).toISOString(),
-      updated_at: new Date(Date.now() - 1000 * 60 * 60 * 1).toISOString(),
-      created_by: 'John Doe'
-    },
-    {
-      id: '3',
-      model_id: '2',
-      title: 'React Components Library',
-      content_type: 'code',
-      status: 'completed',
-      chunk_count: 234,
-      embedding_count: 234,
-      created_at: new Date(Date.now() - 1000 * 60 * 60 * 24 * 3).toISOString(),
-      updated_at: new Date(Date.now() - 1000 * 60 * 60 * 2).toISOString(),
-      created_by: 'Mike Johnson'
-    },
-    {
-      id: '4',
-      model_id: '1',
-      title: 'Company Policies',
-      content_type: 'docx',
-      status: 'failed',
-      chunk_count: 0,
-      embedding_count: 0,
-      created_at: new Date(Date.now() - 1000 * 60 * 60 * 24).toISOString(),
-      updated_at: new Date(Date.now() - 1000 * 60 * 60 * 23).toISOString(),
-      created_by: 'Admin',
-      error: 'Document format not supported'
-    }
-  ]
-
-  const mockSearchResults: EmbeddingSearch = {
-    query: 'how to reset password',
-    results: [
-      {
-        document_id: '1',
-        document_title: 'User Guide - Getting Started',
-        chunk_content: 'To reset your password, go to the settings page and click on "Reset Password"...',
-        similarity_score: 0.95,
-        chunk_index: 12
-      },
-      {
-        document_id: '1',
-        document_title: 'User Guide - Getting Started',
-        chunk_content: 'Password reset emails are sent to your registered email address...',
-        similarity_score: 0.87,
-        chunk_index: 13
-      },
-      {
-        document_id: '3',
-        document_title: 'React Components Library',
-        chunk_content: 'The PasswordReset component handles user password reset functionality...',
-        similarity_score: 0.72,
-        chunk_index: 45
-      }
-    ],
-    search_time: 0.234,
-    total_results: 3
-  }
-
-  const providers = [
-    { value: 'all', label: 'All Providers' },
-    { value: 'openai', label: 'OpenAI' },
-    { value: 'anthropic', label: 'Anthropic' },
-    { value: 'local', label: 'Local' },
-    { value: 'custom', label: 'Custom' }
-  ]
-
-  const statusOptions = [
-    { value: 'all', label: 'All Statuses' },
-    { value: 'active', label: 'Active' },
-    { value: 'inactive', label: 'Inactive' }
-  ]
-
-  const filteredModels = (embeddings || []).filter(embedding => {
-    const matchesSearch = embedding.content?.toLowerCase().includes(searchTerm.toLowerCase()) ||
-                         (embedding.metadata?.source && embedding.metadata.source.toLowerCase().includes(searchTerm.toLowerCase()))
-    const matchesProvider = selectedProvider === 'all' || embedding.metadata?.source === selectedProvider
-    const matchesStatus = selectedStatus === 'all' || 
-                         (selectedStatus === 'active' && true) || // All embeddings are considered active
-                         (selectedStatus === 'inactive' && false)
-    return matchesSearch && matchesProvider && matchesStatus
+  const filteredRecords = (records || []).filter((record) => {
+    const term = searchTerm.toLowerCase()
+    return (
+      (record.content?.toLowerCase().includes(term) || false) ||
+      (record.document_id?.toLowerCase().includes(term) || false) ||
+      (record.model_id?.toLowerCase().includes(term) || false)
+    )
   })
 
-  // Helper functions
-  const getProviderBadgeColor = (provider: string) => {
-    switch (provider) {
-      case 'openai':
-        return 'bg-green-100 text-green-800'
-      case 'anthropic':
-        return 'bg-blue-100 text-blue-800'
-      case 'local':
-        return 'bg-purple-100 text-purple-800'
-      case 'custom':
-        return 'bg-orange-100 text-orange-800'
-      default:
-        return 'bg-slate-100 text-slate-800'
-    }
-  }
-
-  const getStatusBadgeColor = (isActive: boolean) => {
-    return isActive ? 'bg-green-100 text-green-800' : 'bg-slate-100 text-slate-800'
-  }
-
   const handleSort = (key: string) => {
     if (sortKey === key) {
       setSortDirection(sortDirection === 'asc' ? 'desc' : 'asc')
@@ -243,121 +58,121 @@ export function EmbeddingsPage() {
     }
   }
 
-  const handleRowClick = (model: EmbeddingModel) => {
-    navigate(`/spine-framework/admin/configs/embeddings/${model.id}`)
-  }
+  const sortedRecords = [...filteredRecords].sort((a, b) => {
+    const aValue: any = a[sortKey as keyof EmbeddingRecord]
+    const bValue: any = b[sortKey as keyof EmbeddingRecord]
 
-  // Sort models
-  const sortedModels = [...filteredModels].sort((a, b) => {
-    let aValue: any = a[sortKey as keyof EmbeddingModel]
-    let bValue: any = b[sortKey as keyof EmbeddingModel]
-    
+    if (aValue == null || bValue == null) return 0
     if (typeof aValue === 'string') {
-      return sortDirection === 'asc' 
+      return sortDirection === 'asc'
         ? aValue.localeCompare(bValue)
         : bValue.localeCompare(aValue)
     }
-    
     if (typeof aValue === 'number') {
-      return sortDirection === 'asc' ? aValue - bValue : bValue - aValue
+      return sortDirection === 'asc'
+        ? aValue - bValue
+        : bValue - aValue
     }
-    
     return 0
   })
 
+  const getStatus = (record: EmbeddingRecord) => {
+    if (record.revoked_at) return { label: 'Revoked', color: 'bg-red-100 text-red-700' }
+    if (record.approved_at) return { label: 'Approved', color: 'bg-green-100 text-green-700' }
+    return { label: 'Pending', color: 'bg-slate-100 text-slate-600' }
+  }
+
   const statsCards = [
     {
-      title: 'Total Embeddings',
-      value: (embeddings || []).length,
+      title: 'Total Records',
+      value: (records || []).length,
       icon: FileText,
-      iconColor: 'text-blue-500'
+      iconColor: 'text-blue-600'
     },
     {
-      title: 'Active',
-      value: (embeddings || []).filter(m => m.is_active).length,
+      title: 'Approved',
+      value: (records || []).filter(r => r.approved_at && !r.revoked_at).length,
       icon: CheckCircle,
-      iconColor: 'text-green-500'
+      iconColor: 'text-green-600'
     },
     {
-      title: 'Documents Processed',
-      value: (embeddings || []).length, // Simplified count since embeddings table structure is different
-      icon: BarChart3,
-      iconColor: 'text-orange-500'
-    },
-    {
-      title: 'Last Updated',
-      value: (embeddings || []).length > 0 ? 'Just now' : 'Never',
-      icon: Box,
-      iconColor: 'text-purple-500'
-    }
-  ]
-
-  const filters = [
-    {
-      label: 'Provider',
-      value: selectedProvider,
-      options: providers,
-      onChange: setSelectedProvider
-    },
-    {
-      label: 'Status',
-      value: selectedStatus,
-      options: statusOptions,
-      onChange: setSelectedStatus
+      title: 'Revoked',
+      value: (records || []).filter(r => r.revoked_at).length,
+      icon: XCircle,
+      iconColor: 'text-red-600'
     }
   ]
 
   return (
     <AdminListPage
       title="Embeddings"
-      description="Manage embedding models and document indexes"
-      newButtonText="New Model"
-      newButtonHref="/spine-framework/admin/configs/embeddings/new"
+      description="Inspect runtime vector records from the public.embeddings table"
+      noPageInstructions
       statsCards={statsCards}
-      searchPlaceholder="Search models..."
+      searchPlaceholder="Search by content, document, or model..."
       searchValue={searchTerm}
       onSearchChange={setSearchTerm}
-      filters={filters}
-      loading={false}
-      emptyMessage="No embedding models found"
-      emptyIcon={FileText}
+      loading={loading}
+      error={error}
+      onRetry={refetch}
+      emptyMessage="No embedding records found"
+      emptyIcon={AlertCircle}
     >
-      {sortedModels.length === 0 ? (
+      <PageInstructions
+        title="About the embeddings table"
+        description="These are runtime vector records stored in public.embeddings. Each record is a chunk of content with its embedding, model, document, and lifecycle metadata. This page is read-only."
+        sections={[
+          {
+            title: 'Columns',
+            content: 'Model ID, Document ID, chunk index, truncated content, approval status, content hash, and creation time.'
+          },
+          {
+            title: 'Searching',
+            content: 'Use the search field to filter by content text, document_id, or model_id.'
+          },
+          {
+            title: 'Drilling down',
+            content: 'Click any row to view the full record, including the full content, metadata JSON, and embedding vector.'
+          }
+        ]}
+      />
+
+      {sortedRecords.length === 0 ? (
         <div className="p-8 text-center">
-          <FileText className="mx-auto h-12 w-12 text-slate-400" />
-          <h3 className="mt-2 text-sm font-medium text-slate-900">No models found</h3>
-          <p className="mt-1 text-sm text-slate-500">
-            Try adjusting your search or filters
-          </p>
+          <AlertCircle className="mx-auto h-12 w-12 text-slate-400" />
+          <h3 className="mt-2 text-sm font-medium text-slate-900">No embedding records found</h3>
+          <p className="mt-1 text-sm text-slate-500">Try adjusting your search</p>
         </div>
       ) : (
         <table className="min-w-full divide-y divide-slate-200">
           <thead className="bg-slate-50">
             <tr>
               <SortableTableHeader
-                title="Content"
-                sortKey="content"
+                title="Model ID"
+                sortKey="model_id"
                 currentSortKey={sortKey}
                 currentSortDirection={sortDirection}
                 onSort={handleSort}
               />
               <SortableTableHeader
-                title="Source/Type"
-                sortKey="metadata.source"
+                title="Document ID"
+                sortKey="document_id"
                 currentSortKey={sortKey}
                 currentSortDirection={sortDirection}
                 onSort={handleSort}
               />
               <SortableTableHeader
-                title="Status"
-                sortKey="status"
+                title="Chunk Index"
+                sortKey="chunk_index"
                 currentSortKey={sortKey}
                 currentSortDirection={sortDirection}
                 onSort={handleSort}
               />
+              <th className="px-6 py-3 text-left text-xs font-medium uppercase tracking-wider text-slate-500">Content</th>
+              <th className="px-6 py-3 text-left text-xs font-medium uppercase tracking-wider text-slate-500">Status</th>
               <SortableTableHeader
-                title="Dimensions"
-                sortKey="embedding"
+                title="Content Hash"
+                sortKey="content_hash"
                 currentSortKey={sortKey}
                 currentSortDirection={sortDirection}
                 onSort={handleSort}
@@ -372,50 +187,32 @@ export function EmbeddingsPage() {
             </tr>
           </thead>
           <tbody className="bg-white divide-y divide-slate-200">
-            {sortedModels.map((model) => (
-              <tr 
-                key={model.id} 
-                className="hover:bg-slate-50 cursor-pointer transition-colors"
-                onClick={() => handleRowClick(model)}
-              >
-                <td className="px-6 py-4 whitespace-nowrap">
-                  <div>
-                    <div className="font-medium text-slate-900">
-                      <span className="text-accent-blue hover:text-navy">
-                        {model.content?.substring(0, 60)}...
-                      </span>
-                    </div>
-                    <div className="text-sm text-slate-500">
-                      Chunk {model.chunk_index} • {model.metadata?.type}
-                    </div>
-                  </div>
-                </td>
-                <td className="px-6 py-4 whitespace-nowrap">
-                  <div className="space-y-1">
-                    <Badge variant={getProviderBadgeColor(model.metadata?.source) as any}>
-                      {model.metadata?.source}
-                    </Badge>
-                    <div className="text-sm text-slate-900 font-mono">{model.metadata?.language}</div>
-                  </div>
-                </td>
-                <td className="px-6 py-4 whitespace-nowrap">
-                  <Badge variant="success">
-                    Active
-                  </Badge>
-                </td>
-                <td className="px-6 py-4 whitespace-nowrap">
-                  <div>
-                    <div className="text-sm text-slate-900">1 chunk</div>
-                    <div className="text-xs text-slate-500">
-                      {model.embedding?.length} dimensions
+            {sortedRecords.map((record) => {
+              const status = getStatus(record)
+              return (
+                <tr
+                  key={record.id}
+                  className="hover:bg-slate-50 cursor-pointer transition-colors"
+                  onClick={() => navigate(`/spine-framework/admin/kb/embeddings/${record.id}`)}
+                >
+                  <td className="px-6 py-4 whitespace-nowrap text-sm text-slate-900">{record.model_id}</td>
+                  <td className="px-6 py-4 whitespace-nowrap text-sm text-slate-500">{record.document_id}</td>
+                  <td className="px-6 py-4 whitespace-nowrap text-sm text-slate-500">{record.chunk_index}</td>
+                  <td className="px-6 py-4 text-sm text-slate-600 max-w-md">
+                    <div className="truncate">
+                      {record.content?.slice(0, 80)}{record.content && record.content.length > 80 ? '...' : ''}
                     </div>
-                  </div>
-                </td>
-                <td className="px-6 py-4 whitespace-nowrap text-sm text-slate-500">
-                  {formatDateTime(model.created_at)}
-                </td>
-              </tr>
-            ))}
+                  </td>
+                  <td className="px-6 py-4 whitespace-nowrap">
+                    <span className={`inline-flex items-center rounded-md px-2 py-0.5 text-xs font-medium ${status.color}`}>
+                      {status.label}
+                    </span>
+                  </td>
+                  <td className="px-6 py-4 whitespace-nowrap text-xs text-slate-500 font-mono">{record.content_hash}</td>
+                  <td className="px-6 py-4 whitespace-nowrap text-sm text-slate-500">{formatDateTime(record.created_at)}</td>
+                </tr>
+              )
+            })}
           </tbody>
         </table>
       )}

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

@@ -1,12 +1,22 @@
-/**
- * @module src/pages/admin/ExtendedShadcnTestPage
- * @audience installer
- * @layer frontend-page
- * @stability testing
- *
- * Extended test page with more shadcn components to identify problematic imports.
- */
 
+
+
+
+// CIL[BEGIN chunk_id="extendedshadcntestpage_module_header_1783668992" type="module_header" identity="module_header" parent="none"]
+// CIL[DOC-MACRO purpose="Import dependencies for ExtendedShadcnTestPage component"]
+// CIL[DOC-RESPONSIBILITY responsibility="Import React hooks and UI components for testing"]
+// CIL[DOC-CONTEXT module="ExtendedShadcnTestPage" layer="presentation" related_files="[\".framework/src/components/ui/dialog.tsx\",\".framework/src/components/ui/table-primitives.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\"custom/apps/portal/pages/ContentPage.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="Imported modules" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Imports React state management and shadcn 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: presentation. Direct callers: 0. Direct calls: 0. Related files: .framework/src/components/ui/dialog.tsx, .framework/src/components/ui/table-primitives.tsx, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, custom/apps/portal/pages/ContentPage.tsx, \."]
+// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
+// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
+// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 import { useState } from 'react'
 import { Card, CardContent, CardDescription, CardHeader, CardTitle } from '../../components/ui/card'
 import { Button } from '../../components/ui/button'
@@ -21,7 +31,21 @@ import {
   SelectValue,
 } from '../../components/ui/select'
 import { Checkbox } from '../../components/ui/checkbox'
-
+// CIL[END chunk_id="extendedshadcntestpage_module_header_1783668992"]
+// CIL[BEGIN chunk_id="extendedshadcntestpage_extendedshadcntestpage_1783668992" type="function" identity="ExtendedShadcnTestPage" parent="none"]
+// CIL[DOC-MACRO purpose="Main ExtendedShadcnTestPage component implementation"]
+// CIL[DOC-RESPONSIBILITY responsibility="Render comprehensive shadcn UI component testing interface"]
+// CIL[DOC-CONTEXT module="ExtendedShadcnTestPage" layer="presentation" related_files="[\".framework/src/components/ui/dialog.tsx\",\".framework/src/components/ui/table-primitives.tsx\",\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/src/pages/admin/RolesPage.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="React component" errors="none" side_effects="State management"]
+// CIL[DOC-MICRO logic_summary="Creates interactive test page for 7 shadcn components with state management" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-VECTOR type="context" content="Layer: presentation. Direct callers: 0. Direct calls: 0. Related files: .framework/src/components/ui/dialog.tsx, .framework/src/components/ui/table-primitives.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 ExtendedShadcnTestPage() {
   const [count, setCount] = useState(0)
   const [text, setText] = useState('')
@@ -174,3 +198,4 @@ export function ExtendedShadcnTestPage() {
     </div>
   )
 }
+// CIL[END chunk_id="extendedshadcntestpage_extendedshadcntestpage_1783668992"]

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

@@ -1,19 +1,43 @@
-/**
- * @module src/pages/admin/IncrementalShadcnTestPage
- * @audience installer
- * @layer frontend-page
- * @stability testing
- *
- * Incremental test page to identify problematic shadcn component imports.
- */
 
+
+
+
+// CIL[BEGIN chunk_id="incrementalshadcntestpage_module_header_1783668992" type="module_header" identity="module_header" parent="none"]
+// CIL[DOC-MACRO purpose="Import dependencies for IncrementalShadcnTestPage component"]
+// CIL[DOC-RESPONSIBILITY responsibility="Import React hooks and basic UI components for testing"]
+// CIL[DOC-CONTEXT module="IncrementalShadcnTestPage" layer="presentation" related_files="[\".framework/src/components/ui/dialog.tsx\",\".framework/src/components/ui/table-primitives.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\"custom/apps/portal/pages/ContentPage.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="Imported modules" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Imports React state management and basic shadcn 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: presentation. Direct callers: 0. Direct calls: 0. Related files: .framework/src/components/ui/dialog.tsx, .framework/src/components/ui/table-primitives.tsx, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, custom/apps/portal/pages/ContentPage.tsx, \."]
+// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
+// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
+// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 import { useState } from 'react'
 import { Card, CardContent, CardDescription, CardHeader, CardTitle } from '../../components/ui/card'
 import { Button } from '../../components/ui/button'
 import { Badge } from '../../components/ui/badge'
 import { Input } from '../../components/ui/input'
 import { Label } from '../../components/ui/label'
-
+// CIL[END chunk_id="incrementalshadcntestpage_module_header_1783668992"]
+// CIL[BEGIN chunk_id="incrementalshadcntestpage_incrementalshadcntestpage_1783668992" type="function" identity="IncrementalShadcnTestPage" parent="none"]
+// CIL[DOC-MACRO purpose="Main IncrementalShadcnTestPage component implementation"]
+// CIL[DOC-RESPONSIBILITY responsibility="Render basic shadcn UI component testing interface"]
+// CIL[DOC-CONTEXT module="IncrementalShadcnTestPage" layer="presentation" related_files="[\".framework/src/components/ui/dialog.tsx\",\".framework/src/components/ui/table-primitives.tsx\",\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/src/pages/admin/RolesPage.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="React component" errors="none" side_effects="State management"]
+// CIL[DOC-MICRO logic_summary="Creates interactive test page for 4 basic shadcn components with state management" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-VECTOR type="context" content="Layer: presentation. Direct callers: 0. Direct calls: 0. Related files: .framework/src/components/ui/dialog.tsx, .framework/src/components/ui/table-primitives.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 IncrementalShadcnTestPage() {
   const [count, setCount] = useState(0)
   const [text, setText] = useState('')
@@ -107,3 +131,4 @@ export function IncrementalShadcnTestPage() {
     </div>
   )
 }
+// CIL[END chunk_id="incrementalshadcntestpage_incrementalshadcntestpage_1783668992"]