spine-framework 0.3.124 → 0.3.126

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

@@ -1,19 +1,21 @@
-/**
- * @module src/pages/admin/TypesPage
- * @audience installer
- * @layer frontend-page
- * @stability stable
- *
- * Admin list page for item/account/person types. Fetches all types via
- * `/api/types?action=list`, then applies client-side search, category
- * filter (`all` | `system` | `custom` | `active`), and sort. Renders
- * inside `AdminListPage` with four stat cards and a sortable table.
- * Row clicks navigate to `/spine-framework/admin/configs/types/:id`.
- *
- * @seeAlso src/components/admin/AdminListPage.tsx
- * @seeAlso src/pages/admin/TypeDetailPage.tsx
- */
 
+
+
+// CIL[BEGIN chunk_id="typespage_moduleheader_1783664706" type="module_header" identity="module_header" parent="none"]
+// CIL[DOC-MACRO purpose="Import dependencies for TypesPage component"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide all external dependencies and UI components"]
+// CIL[DOC-CONTEXT module="TypesPage" layer="frontend-page" related_files="[\".framework/src/components/layout/Sidebar.tsx\",\".framework/src/components/ui/dialog.tsx\",\"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="React components and utilities" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Imports React hooks, API utilities, icons, 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: frontend-page. Direct callers: 0. Direct calls: 0. Related files: .framework/src/components/layout/Sidebar.tsx, .framework/src/components/ui/dialog.tsx, 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"]
 import React, { useState } from 'react'
 import { useApi } from '../../hooks/useApi'
 import { apiFetch } from '../../lib/api'
@@ -30,7 +32,21 @@ import { Button } from '../../components/ui/button'
 import { AdminListPage } from '../../components/admin/AdminListPage'
 import { SortableTableHeader } from '../../components/admin/SortableTableHeader'
 import { formatDateTime } from '../../lib/utils'
-
+// CIL[END chunk_id="typespage_moduleheader_1783664706"]
+// CIL[BEGIN chunk_id="typespage_type_1783664706" type="interface" identity="Type" parent="none"]
+// CIL[DOC-MACRO purpose="Define the Type data structure for type management"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide type definition for item/account/person types"]
+// CIL[DOC-CONTEXT module="TypesPage" layer="frontend-page" related_files="[\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/migrations/025_retype_threads_messages.sql\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/src/pages/admin/IntegrationsPage.tsx\",\".framework/functions/_shared/schema-utils.ts\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="Type interface" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Defines comprehensive type structure with metadata and schema" 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/migrations/025_retype_threads_messages.sql, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .framework/src/pages/admin/IntegrationsPage.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"]
 interface Type {
   id: string
   name: string
@@ -54,14 +70,27 @@ interface Type {
   app_id?: string | null
   app?: any
 }
-
+// CIL[END chunk_id="typespage_type_1783664706"]
+// CIL[BEGIN chunk_id="typespage_typespage_1783664706" type="function" identity="TypesPage" parent="none"]
+// CIL[DOC-MACRO purpose="Admin list page for managing item/account/person types"]
+// CIL[DOC-RESPONSIBILITY responsibility="Fetch, filter, sort, and display types with navigation"]
+// CIL[DOC-CONTEXT module="TypesPage" layer="frontend-page" related_files="[\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/src/pages/admin/RolesPage.tsx\",\"custom/apps/portal/pages/ContentPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\"custom/apps/portal/pages/CoursesPage.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="React component with type list" errors="API failures" side_effects="API calls, navigation"]
+// CIL[DOC-MICRO logic_summary="Client-side filtering, sorting, and stats calculation for types" 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/src/pages/admin/RolesPage.tsx, custom/apps/portal/pages/ContentPage.tsx, custom/apps/cortex/pages/operations/OperationsDashboard.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 TypesPage() {
   const [searchTerm, setSearchTerm] = useState('')
   const [selectedCategory, setSelectedCategory] = useState('all')
   const [sortKey, setSortKey] = useState('name')
   const [sortDirection, setSortDirection] = useState<'asc' | 'desc'>('asc')
 
-  // Fetch types from API
   const { data: types, loading, error, refetch } = useApi<Type[]>(
     async ({ signal }: { signal?: AbortSignal }) => {
       const response = await apiFetch('/api/types?action=list', { signal })
@@ -95,7 +124,6 @@ export function TypesPage() {
     return matchesSearch && matchesCategory
   })
 
-  // Helper functions
   const getCategoryBadgeColor = (type: Type) => {
     if (type.ownership === 'system') {
       return 'bg-purple-50 text-purple-700'
@@ -122,7 +150,6 @@ export function TypesPage() {
     window.location.href = `/spine-framework/admin/configs/types/${type.id}`
   }
 
-  // Sort types
   const sortedTypes = [...(filteredTypes || [])].sort((a, b) => {
     let aValue: any = a[sortKey as keyof Type]
     let bValue: any = b[sortKey as keyof Type]
@@ -293,3 +320,4 @@ export function TypesPage() {
     </AdminListPage>
   )
 }
+// CIL[END chunk_id="typespage_typespage_1783664706"]

package/.framework/src/pages/admin/cil/CILAgentPage.tsx

@@ -0,0 +1,465 @@
+// CIL[BEGIN chunk_id="cilagentpage_module_header_1784193942" type="module_header" identity="module_header" parent="none"]
+// CIL[DOC-MACRO purpose="Import dependencies and icons for the CIL agent page"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provides module imports and icon references used by the page"]
+// CIL[DOC-CONTEXT module="cortex:cil-agent" layer="presentation" related_files="[\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/src/pages/admin/RolesPage.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Sets up React hooks, router, apiFetch, app path hook, UI components, and lucide icons" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-AUDIENCE audience="developer"]
+// CIL[DOC-VECTOR type="context" content="Layer: presentation. 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, .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, useRef, useEffect, useCallback } from 'react'
+import { useParams } from 'react-router-dom'
+import { apiFetch } from '@core/lib/api'
+import { Button } from '@core/components/ui/button'
+import { Textarea } from '@core/components/ui/textarea'
+import { Badge } from '@core/components/ui/badge'
+import { Skeleton } from '@core/components/ui/skeleton'
+import {
+  Bot,
+  User,
+  ChevronRight,
+  Send,
+  RefreshCw,
+  Zap,
+  Wrench,
+  Code2,
+  AlertTriangle,
+  Plus,
+  FileCode2,
+} from 'lucide-react'
+
+
+
+import { PageInstructions } from '../../../components/admin/PageInstructions'
+// CIL[END chunk_id="cilagentpage_module_header_1784193942"]
+// CIL[BEGIN chunk_id="cilagentpage_message_1784193942" type="interface" identity="Message" parent="none"]
+// CIL[DOC-MACRO purpose="Define the shape of a chat message"]
+// CIL[DOC-RESPONSIBILITY responsibility="Declares the TypeScript interface for messages exchanged in the agent chat"]
+// CIL[DOC-CONTEXT module="cortex:cil-agent" layer="presentation" related_files="[\".framework/functions/_shared/principal.ts\",\".framework/migrations/025_retype_threads_messages.sql\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/src/pages/admin/IntegrationsPage.tsx\",\".framework/functions/_shared/schema-utils.ts\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="Message type contract" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Describes id, role, content, optional sources, tool_calls_made, and loading flag" 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/functions/_shared/principal.ts, .framework/migrations/025_retype_threads_messages.sql, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .framework/src/pages/admin/IntegrationsPage.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"]
+interface Message {
+  id: string
+  role: 'user' | 'assistant' | 'system'
+  content: string
+  sources?: string[]
+  tool_calls_made?: string[]
+  loading?: boolean
+}
+
+
+
+
+// CIL[END chunk_id="cilagentpage_message_1784193942"]
+// CIL[BEGIN chunk_id="cilagentpage_rendermarkdown_1784193942" type="function" identity="renderMarkdown" parent="none"]
+// CIL[DOC-MACRO purpose="Render assistant message text with code blocks and inline formatting"]
+// CIL[DOC-RESPONSIBILITY responsibility="Convert plain text containing markdown-style formatting into React nodes"]
+// CIL[DOC-CONTEXT module="cortex:cil-agent" layer="presentation" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/functions/_shared/schema-utils.ts\",\".framework/migrations/025_retype_threads_messages.sql\",\".framework/src/pages/admin/RolesPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="React.ReactNode[]" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Splits on triple-backtick blocks, renders pre/code, then applies inline code, bold, and newline processing" 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: custom/apps/portal/pages/ContentPage.tsx, .framework/functions/_shared/schema-utils.ts, .framework/migrations/025_retype_threads_messages.sql, .framework/src/pages/admin/RolesPage.tsx, custom/apps/cortex/pages/operations/OperationsDashboard.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 renderMarkdown(text: string): React.ReactNode[] {
+  const parts: React.ReactNode[] = []
+  let key = 0
+
+  
+  const segments = text.split(/(```[\s\S]*?```)/g)
+  for (const seg of segments) {
+    if (seg.startsWith('```')) {
+      const lines = seg.slice(3, -3).split('\n')
+      const lang = lines[0].trim()
+      const code = lines.slice(lang ? 1 : 0).join('\n')
+      parts.push(
+        <pre key={key++} className="bg-slate-900 text-slate-100 rounded-md p-3 my-2 overflow-auto text-xs font-mono whitespace-pre">
+          {lang && <div className="text-slate-400 text-xs mb-1">{lang}</div>}
+          {code}
+        </pre>
+      )
+    } else {
+      
+      const inline = seg.split(/(`[^`]+`|\*\*[^*]+\*\*|\n)/g).map((chunk, i) => {
+        if (chunk.startsWith('`') && chunk.endsWith('`')) {
+          return <code key={i} className="bg-muted px-1 py-0.5 rounded text-xs font-mono">{chunk.slice(1, -1)}</code>
+        }
+        if (chunk.startsWith('**') && chunk.endsWith('**')) {
+          return <strong key={i}>{chunk.slice(2, -2)}</strong>
+        }
+        if (chunk === '\n') return <br key={i} />
+        return chunk
+      })
+      parts.push(<span key={key++}>{inline}</span>)
+    }
+  }
+  return parts
+}
+
+
+
+// CIL[END chunk_id="cilagentpage_rendermarkdown_1784193942"]
+// CIL[BEGIN chunk_id="cilagentpage_messagebubble_1784193942" type="function" identity="MessageBubble" parent="none"]
+// CIL[DOC-MACRO purpose="Render a single chat message bubble with metadata chips"]
+// CIL[DOC-RESPONSIBILITY responsibility="Display a user or assistant message, loading skeleton, and source or tool chips"]
+// CIL[DOC-CONTEXT module="cortex:cil-agent" layer="presentation" related_files="[\".framework/migrations/025_retype_threads_messages.sql\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/src/pages/admin/IntegrationsPage.tsx\",\".framework/functions/_shared/schema-utils.ts\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="JSX.Element" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Determines user vs assistant layout, calls renderMarkdown for assistant content, and links to source chunks" 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/migrations/025_retype_threads_messages.sql, .framework/src/pages/admin/TypeDetailPage.tsx, custom/apps/portal/pages/ContentPage.tsx, .framework/src/pages/admin/IntegrationsPage.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"]
+function MessageBubble({ message, projectId, appPath }: {
+  message: Message
+  projectId: string
+  appPath: (p: string) => string
+}) {
+  const isUser = message.role === 'user'
+
+  if (message.loading) {
+    return (
+      <div className="flex items-start gap-2.5">
+        <div className="h-6 w-6 rounded-full bg-indigo-100 flex items-center justify-center shrink-0 mt-0.5">
+          <Bot className="h-3.5 w-3.5 text-indigo-600" />
+        </div>
+        <div className="flex-1 space-y-1.5 pt-0.5">
+          <Skeleton className="h-3 w-48" />
+          <Skeleton className="h-3 w-64" />
+          <Skeleton className="h-3 w-40" />
+        </div>
+      </div>
+    )
+  }
+
+  return (
+    <div className={`flex items-start gap-2.5 ${isUser ? 'flex-row-reverse' : ''}`}>
+      <div className={`h-6 w-6 rounded-full flex items-center justify-center shrink-0 mt-0.5 ${isUser ? 'bg-slate-200' : 'bg-indigo-100'}`}>
+        {isUser
+          ? <User className="h-3.5 w-3.5 text-slate-600" />
+          : <Bot className="h-3.5 w-3.5 text-indigo-600" />
+        }
+      </div>
+
+      <div className={`flex-1 min-w-0 ${isUser ? 'items-end' : 'items-start'} flex flex-col`}>
+        <div className={`rounded-xl px-3.5 py-2.5 max-w-[85%] text-sm leading-relaxed ${
+          isUser
+            ? 'bg-slate-900 text-white rounded-tr-sm'
+            : 'bg-muted rounded-tl-sm'
+        }`}>
+          {isUser
+            ? <span className="whitespace-pre-wrap">{message.content}</span>
+            : <div className="prose-sm">{renderMarkdown(message.content)}</div>
+          }
+        </div>
+
+        {}
+        {!isUser && (message.tool_calls_made?.length || message.sources?.length) ? (
+          <div className="flex flex-wrap gap-1.5 mt-1.5 ml-0.5">
+            {(message.tool_calls_made || []).map((tc, i) => (
+              <span key={`tc-${tc}-${i}`} className="inline-flex items-center gap-1 text-xs bg-amber-50 border border-amber-200 text-amber-700 rounded-full px-2 py-0.5">
+                <Wrench className="h-2.5 w-2.5" /> {tc}
+              </span>
+            ))}
+            {(message.sources || []).map((src, i) => (
+              <a
+                key={`src-${src}-${i}`}
+                href={appPath(projectId ? `/cil/${projectId}/chunks/${src}` : `/cil/chunks/${src}`)}
+                className="inline-flex items-center gap-1 text-xs bg-indigo-50 border border-indigo-200 text-indigo-700 rounded-full px-2 py-0.5 hover:bg-indigo-100 transition-colors"
+                title={`Open chunk: ${src}`}
+              >
+                <Code2 className="h-2.5 w-2.5" /> {src}
+              </a>
+            ))}
+          </div>
+        ) : null}
+      </div>
+    </div>
+  )
+}
+
+
+
+// CIL[END chunk_id="cilagentpage_messagebubble_1784193942"]
+// CIL[BEGIN chunk_id="cilagentpage_suggestions_1784193942" type="constant" identity="SUGGESTIONS" parent="none"]
+// CIL[DOC-MACRO purpose="Provide default example questions for the CIL agent chat"]
+// CIL[DOC-RESPONSIBILITY responsibility="Supplies a constant list of sample user queries for the empty state"]
+// CIL[DOC-CONTEXT module="cortex:cil-agent" layer="presentation" related_files="[\"custom/apps/cortex/functions/custom_cil-embeddings.ts\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/functions/_shared/principal.ts\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="readonly string[]" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Array of natural-language questions covering auth, embeddings, refactoring, and undocumented chunks" 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: custom/apps/cortex/functions/custom_cil-embeddings.ts, custom/apps/cortex/pages/operations/OperationsDashboard.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 SUGGESTIONS = [
+  'What does the authentication middleware do?',
+  'Which functions write to the embeddings table?',
+  'Is it safe to refactor the createHandler function?',
+  'What are the side effects of the runAgent function?',
+  'Which chunks have no callers (potential dead code)?',
+  'Show me undocumented chunks in this project',
+]
+
+
+
+// CIL[END chunk_id="cilagentpage_suggestions_1784193942"]
+// CIL[BEGIN chunk_id="cilagentpage_cilagentpage_1784193942" type="component" identity="CILAgentPage" parent="none"]
+// CIL[DOC-MACRO purpose="Render the interactive CIL agent chat page"]
+// CIL[DOC-RESPONSIBILITY responsibility="Manage chat state, send questions to the CIL agent API, and render the conversation UI"]
+// CIL[DOC-CONTEXT module="cortex:cil-agent" layer="presentation" related_files="[]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="JSX.Element" errors="Displays API errors as assistant messages" side_effects="Calls /api/cil-agent and /api/cil-project; updates messages and input state"]
+// CIL[DOC-MICRO logic_summary="Loads project title, maintains messages/input/sending refs, sends messages via apiFetch, scrolls to bottom, and renders messages and input area" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-VECTOR type="context" content="Layer: presentation. 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 default function CILAgentPage() {
+  const { id: projectId } = useParams<{ id: string }>()
+  const appPath = (path: string) => '/spine-framework/admin' + (path.startsWith('/') ? path : '/' + path)
+  const [messages, setMessages] = useState<Message[]>([])
+  const [input, setInput] = useState('')
+  const [sending, setSending] = useState(false)
+  const [projectTitle, setProjectTitle] = useState('')
+  const bottomRef = useRef<HTMLDivElement>(null)
+  const textareaRef = useRef<HTMLTextAreaElement>(null)
+
+  
+  useEffect(() => {
+    if (!projectId) return
+    apiFetch(`/api/cil-project?action=get&id=${projectId}`)
+      .then(r => r.json())
+      .then(data => {
+        const p = data?.project || data?.data?.project
+        if (p?.title) setProjectTitle(p.title)
+      })
+      .catch(() => {})
+  }, [projectId])
+
+  
+  useEffect(() => {
+    bottomRef.current?.scrollIntoView({ behavior: 'smooth' })
+  }, [messages])
+
+  const sendMessage = useCallback(async (text: string) => {
+    if (!text.trim() || sending) return
+
+    const userMsg: Message = {
+      id: crypto.randomUUID(),
+      role: 'user',
+      content: text.trim(),
+    }
+    const loadingMsg: Message = {
+      id: crypto.randomUUID(),
+      role: 'assistant',
+      content: '',
+      loading: true,
+    }
+
+    setMessages(prev => [...prev, userMsg, loadingMsg])
+    setInput('')
+    setSending(true)
+
+    try {
+      const res = await apiFetch('/api/cil-agent?action=ask', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({
+          question: text.trim(),
+          project_id: projectId,
+        }),
+      })
+      const data = await res.json()
+      const r = data?.data || data
+      const answer = r?.answer || 'Sorry, I could not generate a response.'
+
+      setMessages(prev => [
+        ...prev.slice(0, -1), 
+        {
+          id: crypto.randomUUID(),
+          role: 'assistant',
+          content: answer,
+          sources: r?.sources || [],
+          tool_calls_made: r?.tool_calls_made || [],
+        },
+      ])
+    } catch (err) {
+      setMessages(prev => [
+        ...prev.slice(0, -1),
+        {
+          id: crypto.randomUUID(),
+          role: 'assistant',
+          content: `Error: ${err instanceof Error ? err.message : String(err)}`,
+        },
+      ])
+    } finally {
+      setSending(false)
+      setTimeout(() => textareaRef.current?.focus(), 50)
+    }
+  }, [projectId, sending])
+
+  const handleKeyDown = (e: React.KeyboardEvent<HTMLTextAreaElement>) => {
+    if (e.key === 'Enter' && !e.shiftKey) {
+      e.preventDefault()
+      sendMessage(input)
+    }
+  }
+
+  const clearConversation = () => {
+    setMessages([])
+    setInput('')
+    textareaRef.current?.focus()
+  }
+
+  const isEmpty = messages.length === 0
+
+  return (
+    <div className="flex flex-col h-[calc(100vh-64px)]">
+      {}
+      <div className="flex items-center justify-between px-4 py-2.5 border-b bg-background shrink-0">
+        <div className="flex items-center gap-2 text-sm text-muted-foreground">
+          <a href={appPath('/cil')} className="hover:underline">Code Intelligence</a>
+          <ChevronRight className="h-3 w-3" />
+          {projectId && (
+            <>
+              <a href={appPath(`/cil/${projectId}/dashboard`)} className="hover:underline">{projectTitle || 'Project'}</a>
+              <ChevronRight className="h-3 w-3" />
+            </>
+          )}
+          <span className="flex items-center gap-1 text-foreground font-medium">
+            <Bot className="h-3.5 w-3.5 text-indigo-500" /> CIL Agent
+          </span>
+        </div>
+
+        <div className="flex items-center gap-2">
+          {projectId && (
+            <Badge variant="outline" className="text-xs font-mono">
+              <FileCode2 className="h-3 w-3 mr-1" />
+              {projectTitle || projectId.slice(0, 8)}
+            </Badge>
+          )}
+          {!isEmpty && (
+            <Button size="sm" variant="ghost" onClick={clearConversation} className="h-7 text-xs text-muted-foreground">
+              <Plus className="h-3 w-3 mr-1" /> New Chat
+            </Button>
+          )}
+        </div>
+      </div>
+
+      <PageInstructions
+        description="Ask the CIL agent questions about the indexed codebase."
+        sections={[
+          { title: 'What this page is for', content: 'Use this chat to ask natural-language questions about the indexed codebase. The agent searches chunk contracts and the call graph to answer accurately.' },
+          { title: 'How to use this page', content: 'Type a question in the input and press Enter or click send. Select a suggested prompt to start quickly. The agent returns citations from chunks and may call tools.' },
+          { title: 'How to interpret results', content: 'Assistant messages include source chunk references. Click a reference to open the chunk detail. No project ID means the search spans all indexed chunks.' },
+          { title: 'Important notes', content: 'The agent only knows what has been ingested and embedded. Run the CIL ingestion pipeline first for fresh or missing code.' },
+        ]}
+      />
+
+      {}
+      <div className="flex-1 overflow-y-auto px-4 py-4 space-y-4">
+        {isEmpty && (
+          <div className="flex flex-col items-center justify-center h-full space-y-6 text-center">
+            <div className="h-16 w-16 rounded-full bg-indigo-100 flex items-center justify-center">
+              <Bot className="h-8 w-8 text-indigo-600" />
+            </div>
+            <div className="space-y-1">
+              <h2 className="text-lg font-semibold">CIL Codebase Assistant</h2>
+              <p className="text-sm text-muted-foreground max-w-sm">
+                Ask me anything about this codebase. I'll search the indexed chunk contracts and call graph to answer accurately.
+              </p>
+            </div>
+            <div className="flex flex-wrap gap-2 justify-center max-w-lg">
+              {SUGGESTIONS.map(s => (
+                <button
+                  key={s}
+                  className="text-xs px-3 py-1.5 rounded-full border hover:bg-muted transition-colors text-muted-foreground hover:text-foreground text-left"
+                  onClick={() => sendMessage(s)}
+                >
+                  {s}
+                </button>
+              ))}
+            </div>
+            {!projectId && (
+              <div className="flex items-center gap-1.5 text-xs text-amber-600 bg-amber-50 border border-amber-200 rounded-lg px-3 py-2">
+                <AlertTriangle className="h-3.5 w-3.5 shrink-0" />
+                No project scope — searching across all indexed chunks
+              </div>
+            )}
+          </div>
+        )}
+
+        {messages.map(msg => (
+          <MessageBubble
+            key={msg.id}
+            message={msg}
+            projectId={projectId || ''}
+            appPath={appPath}
+          />
+        ))}
+
+        <div ref={bottomRef} />
+      </div>
+
+      {}
+      <div className="border-t bg-background px-4 py-3 shrink-0">
+        <div className="flex items-end gap-2 max-w-4xl mx-auto">
+          <Textarea
+            ref={textareaRef}
+            value={input}
+            onChange={e => setInput(e.target.value)}
+            onKeyDown={handleKeyDown}
+            placeholder="Ask about a function, safe refactoring, callers, or blast radius…"
+            className="min-h-[44px] max-h-[200px] resize-none text-sm"
+            rows={1}
+            disabled={sending}
+          />
+          <Button
+            onClick={() => sendMessage(input)}
+            disabled={!input.trim() || sending}
+            className="h-11 w-11 p-0 shrink-0"
+          >
+            {sending
+              ? <RefreshCw className="h-4 w-4 animate-spin" />
+              : <Send className="h-4 w-4" />
+            }
+          </Button>
+        </div>
+        <p className="text-xs text-center text-muted-foreground mt-1.5">
+          <Zap className="h-3 w-3 inline mr-1" />
+          Grounded in CIL chunk contracts · Press Shift+Enter for a new line
+        </p>
+      </div>
+    </div>
+  )
+}
+
+// CIL[END chunk_id="cilagentpage_cilagentpage_1784193942"]