spine-framework 0.4.4 → 0.5.0-rc.4

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

@@ -1,14 +1,29 @@
 // CIL[BEGIN stable_id="~/.framework/src/pages/admin/cil/CILSearchPage.tsx:module_header:module_header" type="module_header" identity="module_header" parent="~/.framework/src/pages/admin/cil/CILSearchPage.tsx"]
-// CIL[DOC-MACRO purpose="Provides the React page for searching indexed CIL code chunks across projects with hybrid, semantic, or text modes."]
-// CIL[DOC-RESPONSIBILITY responsibility="Import dependencies, define shared types and helper components, and export the default CILSearchPage component."]
-// CIL[DOC-CONTEXT module="admin/cil" layer="ui" related_files=".framework/src/components/admin/PageInstructions.tsx,.framework/src/components/ui/badge.tsx,.framework/src/components/ui/button.tsx,.framework/src/components/ui/card.tsx,.framework/src/components/ui/input.tsx,.framework/src/components/ui/label.tsx,.framework/src/components/ui/select.tsx,.framework/src/lib/api.ts"]
-// CIL[DOC-CONTRACT inputs="none" outputs="default export CILSearchPage React component" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Sets up the CIL search UI layout, search controls, result list and filters." notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-AUDIENCE audience="admin UI developers maintaining the CIL search interface"]
-
-import { useState, useRef, useMemo } from 'react'
+/**
+ * @module   CILSearchPage
+ * @audience both
+ * @layer    shared-core
+ * @stability stable
+ *
+ * CILSearchPage is a React component that facilitates searching within the CIL (Common Intermediate Language) context in the admin panel. It integrates various UI components to provide a user-friendly interface for inputting search criteria and displaying results.
+ * INVARIANT: The component relies on the correct configuration of API endpoints for fetching data.
+ *
+ * @seeAlso apiFetch (used for making API calls).
+ * @seeAlso PageInstructions (provides contextual guidance for users).
+ *
+ * @cil-generated
+ */
+
+
+
+
+
+
+
+
+
+
+import { useState, useRef, useMemo, useEffect } from 'react'
 import { apiFetch } from '@core/lib/api'
 import { Card, CardContent } from '@core/components/ui/card'
 import { Button } from '@core/components/ui/button'
@@ -16,6 +31,7 @@ import { Badge } from '@core/components/ui/badge'
 import { Input } from '@core/components/ui/input'
 import { Label } from '@core/components/ui/label'
 import {
+// CIL[END stable_id="~/.framework/src/pages/admin/cil/CILSearchPage.tsx:module_header:module_header"]
   Select,
   SelectContent,
   SelectItem,
@@ -34,24 +50,32 @@ import {
 
 
 
-import { PageInstructions } from '../../../components/admin/PageInstructions'
 
-// CIL[DOC-VECTOR type="context" content="purpose='Provides the React page for searching indexed CIL code chunks across projects with hybrid, semantic, or text modes.'; No verified external callers; imports: .framework/src/lib/api.ts,.framework/src/components/ui/card.tsx,.framework/src/components/ui/button.tsx"]
-// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
-// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
-// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
-// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
-// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
-// CIL[END stable_id="~/.framework/src/pages/admin/cil/CILSearchPage.tsx:module_header:module_header"]
-// CIL[BEGIN stable_id="~/.framework/src/pages/admin/cil/CILSearchPage.tsx:SearchResult:interface" type="interface" identity="SearchResult" parent="~/.framework/src/pages/admin/cil/CILSearchPage.tsx"]
-// CIL[DOC-MACRO purpose="Defines the shape of a CIL search result returned by the code intelligence search API."]
-// CIL[DOC-RESPONSIBILITY responsibility="Declare the data contract for search result objects including metadata and similarity scores."]
-// CIL[DOC-CONTEXT module="admin/cil" layer="type" related_files=".framework/src/components/admin/PageInstructions.tsx,.framework/src/components/ui/badge.tsx,.framework/src/components/ui/button.tsx,.framework/src/components/ui/card.tsx,.framework/src/components/ui/input.tsx,.framework/src/components/ui/label.tsx,.framework/src/components/ui/select.tsx,.framework/src/lib/api.ts,.framework/src/pages/admin/cil/CILSearchPage.tsx"]
-// CIL[DOC-CONTRACT inputs="none" outputs="SearchResult interface type" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Specifies fields: id, chunk_name, file_path, macro, micro, chunk_type, doc_confidence, similarity, match_type." notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
 
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+// CIL[BEGIN stable_id="~/.framework/src/pages/admin/cil/CILSearchPage.tsx:SearchResult:interface" type="interface" identity="SearchResult" parent="~/.framework/src/pages/admin/cil/CILSearchPage.tsx"]
+/**
+ * The SearchResult interface defines the structure of search results returned from a search operation, encapsulating essential metadata about each result. It exists to standardize the representation of search results across the application.
+ *
+ * @sideEffects none
+ * @stability   internal
+ * @cil-generated
+ */
 interface SearchResult {
   id: string
   chunk_name: string
@@ -63,12 +87,6 @@ interface SearchResult {
   similarity: number | null
   match_type: 'semantic' | 'text'
 }
-// CIL[DOC-VECTOR type="context" content="purpose='Defines the shape of a CIL search result returned by the code intelligence search API.'; No verified external callers; imports: .framework/src/lib/api.ts,.framework/src/components/ui/card.tsx,.framework/src/components/ui/button.tsx"]
-// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
-// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
-// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
-// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
-// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 // CIL[END stable_id="~/.framework/src/pages/admin/cil/CILSearchPage.tsx:SearchResult:interface"]
 
 
@@ -77,15 +95,32 @@ interface SearchResult {
 
 
 
-// CIL[BEGIN stable_id="~/.framework/src/pages/admin/cil/CILSearchPage.tsx:CHUNK_TYPE_COLORS:constant" type="constant" identity="CHUNK_TYPE_COLORS" parent="~/.framework/src/pages/admin/cil/CILSearchPage.tsx"]
-// CIL[DOC-MACRO purpose="Maps chunk type names to Tailwind CSS color class strings used in result badges."]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide visual styling classes for chunk type badges in search results."]
-// CIL[DOC-CONTEXT module="admin/cil" layer="ui" related_files=".framework/src/components/admin/PageInstructions.tsx,.framework/src/components/ui/badge.tsx,.framework/src/components/ui/button.tsx,.framework/src/components/ui/card.tsx,.framework/src/components/ui/input.tsx,.framework/src/components/ui/label.tsx,.framework/src/components/ui/select.tsx,.framework/src/lib/api.ts,.framework/src/pages/admin/cil/CILSearchPage.tsx"]
-// CIL[DOC-CONTRACT inputs="chunk_type: string" outputs="Tailwind class string" errors="unknown type falls back to config style" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Record of style classes keyed by chunk type for consistent badge rendering." notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
 
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+// CIL[BEGIN stable_id="~/.framework/src/pages/admin/cil/CILSearchPage.tsx:CHUNK_TYPE_COLORS:constant" type="constant" identity="CHUNK_TYPE_COLORS" parent="~/.framework/src/pages/admin/cil/CILSearchPage.tsx"]
+/**
+ * CHUNK_TYPE_COLORS is a constant that maps various chunk types to their corresponding CSS class strings for styling purposes. It provides a centralized way to manage the visual representation of different code elements in the admin interface.
+ *
+ * @sideEffects none
+ * @stability   internal
+ * @cil-generated
+ */
 const CHUNK_TYPE_COLORS: Record<string, string> = {
   function:  'bg-indigo-100 text-indigo-700 border-indigo-200',
   class:     'bg-violet-100 text-violet-700 border-violet-200',
@@ -96,12 +131,6 @@ const CHUNK_TYPE_COLORS: Record<string, string> = {
   route:     'bg-red-100 text-red-700 border-red-200',
   config:    'bg-slate-100 text-slate-700 border-slate-200',
 }
-// CIL[DOC-VECTOR type="context" content="purpose='Maps chunk type names to Tailwind CSS color class strings used in result badges.'; No verified external callers; imports: .framework/src/lib/api.ts,.framework/src/components/ui/card.tsx,.framework/src/components/ui/button.tsx"]
-// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
-// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
-// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
-// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
-// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 // CIL[END stable_id="~/.framework/src/pages/admin/cil/CILSearchPage.tsx:CHUNK_TYPE_COLORS:constant"]
 
 
@@ -112,26 +141,37 @@ const CHUNK_TYPE_COLORS: Record<string, string> = {
 
 
 
-// CIL[BEGIN stable_id="~/.framework/src/pages/admin/cil/CILSearchPage.tsx:DOC_CONFIDENCE_LABEL:constant" type="constant" identity="DOC_CONFIDENCE_LABEL" parent="~/.framework/src/pages/admin/cil/CILSearchPage.tsx"]
-// CIL[DOC-MACRO purpose="Maps documentation confidence levels to badge labels and Tailwind CSS classes."]
-// CIL[DOC-RESPONSIBILITY responsibility="Render confidence badges in search result cards."]
-// CIL[DOC-CONTEXT module="admin/cil" layer="ui" related_files=".framework/src/components/admin/PageInstructions.tsx,.framework/src/components/ui/badge.tsx,.framework/src/components/ui/button.tsx,.framework/src/components/ui/card.tsx,.framework/src/components/ui/input.tsx,.framework/src/components/ui/label.tsx,.framework/src/components/ui/select.tsx,.framework/src/lib/api.ts,.framework/src/pages/admin/cil/CILSearchPage.tsx"]
-// CIL[DOC-CONTRACT inputs="doc_confidence: string" outputs="{ label: string; className: string }" errors="unknown key falls back to unverified_legacy style" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Record of display labels and styling classes for each documentation confidence tier." notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
 
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+// CIL[BEGIN stable_id="~/.framework/src/pages/admin/cil/CILSearchPage.tsx:DOC_CONFIDENCE_LABEL:constant" type="constant" identity="DOC_CONFIDENCE_LABEL" parent="~/.framework/src/pages/admin/cil/CILSearchPage.tsx"]
+/**
+ * DOC_CONFIDENCE_LABEL is a constant that maps document confidence statuses to their corresponding labels and CSS class names for styling. It provides a standardized way to display the confidence level of documents in the user interface.
+ *
+ * @sideEffects none
+ * @stability   internal
+ * @cil-generated
+ */
 const DOC_CONFIDENCE_LABEL: Record<string, { label: string; className: string }> = {
   human_verified: { label: 'Verified', className: 'bg-green-100 text-green-700 border-green-200' },
   ai_generated:   { label: 'AI Docs',  className: 'bg-blue-100 text-blue-700 border-blue-200' },
   unverified_legacy: { label: 'No Docs', className: 'bg-slate-100 text-slate-500 border-slate-200' },
 }
-// CIL[DOC-VECTOR type="context" content="purpose='Maps documentation confidence levels to badge labels and Tailwind CSS classes.'; No verified external callers; imports: .framework/src/lib/api.ts,.framework/src/components/ui/card.tsx,.framework/src/components/ui/button.tsx"]
-// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
-// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
-// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
-// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
-// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 // CIL[END stable_id="~/.framework/src/pages/admin/cil/CILSearchPage.tsx:DOC_CONFIDENCE_LABEL:constant"]
 
 
@@ -139,15 +179,37 @@ const DOC_CONFIDENCE_LABEL: Record<string, { label: string; className: string }>
 
 
 
-// CIL[BEGIN stable_id="~/.framework/src/pages/admin/cil/CILSearchPage.tsx:SimilarityBar:component" type="component" identity="SimilarityBar" parent="~/.framework/src/pages/admin/cil/CILSearchPage.tsx"]
-// CIL[DOC-MACRO purpose="Render a small progress bar showing the semantic search similarity score percentage."]
-// CIL[DOC-RESPONSIBILITY responsibility="Display a visual percentage bar for a single result score."]
-// CIL[DOC-CONTEXT module="admin/cil" layer="ui" related_files=".framework/src/components/admin/PageInstructions.tsx,.framework/src/components/ui/badge.tsx,.framework/src/components/ui/button.tsx,.framework/src/components/ui/card.tsx,.framework/src/components/ui/input.tsx,.framework/src/components/ui/label.tsx,.framework/src/components/ui/select.tsx,.framework/src/lib/api.ts,.framework/src/pages/admin/cil/CILSearchPage.tsx"]
-// CIL[DOC-CONTRACT inputs="score: number | null" outputs="JSX progress bar or null" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Converts score to percentage and renders a fixed-width bar with an inline numeric label." notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
 
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+// CIL[BEGIN stable_id="~/.framework/src/pages/admin/cil/CILSearchPage.tsx:SimilarityBar:component" type="component" identity="SimilarityBar" parent="~/.framework/src/pages/admin/cil/CILSearchPage.tsx"]
+/**
+ * The SimilarityBar component visually represents a similarity score as a percentage bar, enhancing user experience in the CIL search page. It provides a quick visual indication of similarity.
+ *
+ * @macro       UI component for displaying similarity scores.
+ * @micro       Calculates the percentage from a score and renders a progress bar accordingly.
+ * @inputSpec
+ *   score: number | null — the similarity score to be displayed, or null to indicate no score.
+ * @outputSpec  JSX.Element | null — returns a visual representation of the score or null if the score is null.
+ * @sideEffects none
+ * @stability   internal
+ * @cil-generated
+ */
 function SimilarityBar({ score }: { score: number | null }) {
   if (score === null) return null
   const pct = Math.round(score * 100)
@@ -157,44 +219,82 @@ function SimilarityBar({ score }: { score: number | null }) {
         <div
           className="h-full bg-indigo-500 rounded-full"
           style={{ width: `${pct}%` }}
+
         />
       </div>
       <span className="text-xs text-muted-foreground tabular-nums">{pct}%</span>
     </div>
   )
 }
-// CIL[DOC-VECTOR type="context" content="purpose='Render a small progress bar showing the semantic search similarity score percentage.'; No verified external callers; imports: .framework/src/lib/api.ts,.framework/src/components/ui/card.tsx,.framework/src/components/ui/button.tsx"]
-// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
-// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
-// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
-// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
-// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 // CIL[END stable_id="~/.framework/src/pages/admin/cil/CILSearchPage.tsx:SimilarityBar:component"]
 
-// CIL[BEGIN stable_id="~/.framework/src/pages/admin/cil/CILSearchPage.tsx:ResultCard:component" type="component" identity="ResultCard" parent="~/.framework/src/pages/admin/cil/CILSearchPage.tsx"]
-// CIL[DOC-MACRO purpose="Display a single CIL search result as a clickable card with metadata and similarity score."]
-// CIL[DOC-RESPONSIBILITY responsibility="Render chunk name, type, confidence, file path, macro preview, and link to chunk detail."]
-// CIL[DOC-CONTEXT module="admin/cil" layer="ui" related_files=".framework/src/components/admin/PageInstructions.tsx,.framework/src/components/ui/badge.tsx,.framework/src/components/ui/button.tsx,.framework/src/components/ui/card.tsx,.framework/src/components/ui/input.tsx,.framework/src/components/ui/label.tsx,.framework/src/components/ui/select.tsx,.framework/src/lib/api.ts,.framework/src/pages/admin/cil/CILSearchPage.tsx"]
-// CIL[DOC-CONTRACT inputs="result: SearchResult, projectId: string" outputs="JSX clickable card" errors="none" side_effects="navigates on click to chunk detail"]
-// CIL[DOC-MICRO logic_summary="Builds an app path, selects style classes, and returns a Card linking to the chunk detail view." notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
 
 function ResultCard({ result, projectId }: { result: SearchResult; projectId: string }) {
 
 
+
+// CIL[BEGIN stable_id="~/.framework/src/pages/admin/cil/CILSearchPage.tsx:appPath:function" type="function" identity="appPath" parent="~/.framework/src/pages/admin/cil/CILSearchPage.tsx:ResultCard:component"]
+/**
+ * The appPath function constructs a complete application path by appending a given path to a base URL. It ensures that the resulting path is correctly formatted with a leading slash if necessary.
+ *
+ * @inputSpec
+ *   path: string (required) — the path to append to the base URL.
+ * @outputSpec  string — the complete application path.
+ * @sideEffects none
+ * @stability   internal
+ * @cil-generated
+ */
   const appPath = (path: string) => '/spine-framework/admin' + (path.startsWith('/') ? path : '/' + path)
+// CIL[END stable_id="~/.framework/src/pages/admin/cil/CILSearchPage.tsx:appPath:function"]
+
 
 
 
 
+
+// CIL[BEGIN stable_id="~/.framework/src/pages/admin/cil/CILSearchPage.tsx:typeClass:constant" type="constant" identity="typeClass" parent="~/.framework/src/pages/admin/cil/CILSearchPage.tsx:ResultCard:component"]
+/**
+ * The constant 'typeClass' determines the color associated with a specific chunk type from the CHUNK_TYPE_COLORS mapping. It provides a default color for configuration chunks when the result's chunk type is not found in the mapping.
+ *
+ * @sideEffects none
+ * @stability   internal
+ * @cil-generated
+ */
   const typeClass = CHUNK_TYPE_COLORS[result.chunk_type] || CHUNK_TYPE_COLORS.config
+// CIL[END stable_id="~/.framework/src/pages/admin/cil/CILSearchPage.tsx:typeClass:constant"]
+
+
 
 
 
 
 
+// CIL[BEGIN stable_id="~/.framework/src/pages/admin/cil/CILSearchPage.tsx:docCfg:constant" type="constant" identity="docCfg" parent="~/.framework/src/pages/admin/cil/CILSearchPage.tsx:ResultCard:component"]
+/**
+ * The constant 'docCfg' retrieves the configuration for document confidence based on the result's confidence level, providing a fallback to an unverified legacy label if the confidence level is not defined.
+ *
+ * @sideEffects none
+ * @stability   internal
+ * @cil-generated
+ */
   const docCfg = DOC_CONFIDENCE_LABEL[result.doc_confidence] || DOC_CONFIDENCE_LABEL.unverified_legacy
+// CIL[END stable_id="~/.framework/src/pages/admin/cil/CILSearchPage.tsx:docCfg:constant"]
+
 
 
   return (
@@ -238,13 +338,6 @@ function ResultCard({ result, projectId }: { result: SearchResult; projectId: st
     </a>
   )
 }
-// CIL[DOC-VECTOR type="context" content="purpose='Display a single CIL search result as a clickable card with metadata and similarity score.'; No verified external callers; imports: .framework/src/lib/api.ts,.framework/src/components/ui/card.tsx,.framework/src/components/ui/button.tsx"]
-// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
-// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
-// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
-// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
-// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
-// CIL[END stable_id="~/.framework/src/pages/admin/cil/CILSearchPage.tsx:ResultCard:component"]
 
 
 
@@ -254,35 +347,49 @@ function ResultCard({ result, projectId }: { result: SearchResult; projectId: st
 
 
 
-// CIL[BEGIN stable_id="~/.framework/src/pages/admin/cil/CILSearchPage.tsx:SortBy:type" type="type" identity="SortBy" parent="~/.framework/src/pages/admin/cil/CILSearchPage.tsx"]
-// CIL[DOC-MACRO purpose="Declare union types for search result sorting, type filtering, and documentation confidence filtering."]
-// CIL[DOC-RESPONSIBILITY responsibility="Constrain filter and sort state values to allowed string literals."]
-// CIL[DOC-CONTEXT module="admin/cil" layer="type" related_files=".framework/src/components/admin/PageInstructions.tsx,.framework/src/components/ui/badge.tsx,.framework/src/components/ui/button.tsx,.framework/src/components/ui/card.tsx,.framework/src/components/ui/input.tsx,.framework/src/components/ui/label.tsx,.framework/src/components/ui/select.tsx,.framework/src/lib/api.ts,.framework/src/pages/admin/cil/CILSearchPage.tsx"]
-// CIL[DOC-CONTRACT inputs="none" outputs="SortBy, ChunkTypeFilter, DocConfidenceFilter type aliases" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Defines union type literals for sort keys, chunk type and documentation confidence filters." notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
 
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+// CIL[BEGIN stable_id="~/.framework/src/pages/admin/cil/CILSearchPage.tsx:SortBy:type" type="type" identity="SortBy" parent="~/.framework/src/pages/admin/cil/CILSearchPage.tsx"]
 type SortBy = 'relevance' | 'name' | 'file' | 'doc_confidence'
+// CIL[END stable_id="~/.framework/src/pages/admin/cil/CILSearchPage.tsx:SortBy:type"]
+// CIL[BEGIN stable_id="~/.framework/src/pages/admin/cil/CILSearchPage.tsx:ChunkTypeFilter:type" type="type" identity="ChunkTypeFilter" parent="~/.framework/src/pages/admin/cil/CILSearchPage.tsx"]
 type ChunkTypeFilter = 'all' | 'function' | 'class' | 'interface' | 'type' | 'component' | 'hook' | 'route' | 'config'
+// CIL[END stable_id="~/.framework/src/pages/admin/cil/CILSearchPage.tsx:ChunkTypeFilter:type"]
+// CIL[BEGIN stable_id="~/.framework/src/pages/admin/cil/CILSearchPage.tsx:DocConfidenceFilter:type" type="type" identity="DocConfidenceFilter" parent="~/.framework/src/pages/admin/cil/CILSearchPage.tsx"]
 type DocConfidenceFilter = 'all' | 'human_verified' | 'ai_generated' | 'unverified_legacy'
-// CIL[DOC-VECTOR type="context" content="purpose='Declare union types for search result sorting, type filtering, and documentation confidence filtering.'; No verified external callers; imports: .framework/src/lib/api.ts,.framework/src/components/ui/card.tsx,.framework/src/components/ui/button.tsx"]
-// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
-// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
-// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
-// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
-// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
-// CIL[END stable_id="~/.framework/src/pages/admin/cil/CILSearchPage.tsx:SortBy:type"]
+// CIL[END stable_id="~/.framework/src/pages/admin/cil/CILSearchPage.tsx:DocConfidenceFilter:type"]
+
+
+
+
+
+
+
+
+
+
+
 
-// CIL[BEGIN stable_id="~/.framework/src/pages/admin/cil/CILSearchPage.tsx:CILSearchPage:component" type="component" identity="CILSearchPage" parent="~/.framework/src/pages/admin/cil/CILSearchPage.tsx"]
-// CIL[DOC-MACRO purpose="Render the full CIL chunk search page with query controls, filters, and result list."]
-// CIL[DOC-RESPONSIBILITY responsibility="Manage search state, fetch results, apply client-side filters and sorting, and render the UI."]
-// CIL[DOC-CONTEXT module="admin/cil" layer="ui" related_files=".framework/src/components/admin/PageInstructions.tsx,.framework/src/components/ui/badge.tsx,.framework/src/components/ui/button.tsx,.framework/src/components/ui/card.tsx,.framework/src/components/ui/input.tsx,.framework/src/components/ui/label.tsx,.framework/src/components/ui/select.tsx,.framework/src/lib/api.ts,.framework/src/pages/admin/cil/CILSearchPage.tsx"]
-// CIL[DOC-CONTRACT inputs="none" outputs="JSX search page" errors="Sets error state on API failure" side_effects="Calls /api/cil-graph search endpoint"]
-// CIL[DOC-MICRO logic_summary="Maintains query, project, mode, filters and sort state; performs apiFetch to /api/cil-graph; filters and sorts results; renders suggestions and result cards." notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
 
+
+
+
+
+// CIL[BEGIN stable_id="~/.framework/src/pages/admin/cil/CILSearchPage.tsx:CILSearchPage:component" type="component" identity="CILSearchPage" parent="~/.framework/src/pages/admin/cil/CILSearchPage.tsx"]
 export default function CILSearchPage() {
   const appPath = (path: string) => '/spine-framework/admin' + (path.startsWith('/') ? path : '/' + path)
   const [query, setQuery] = useState('')
@@ -296,8 +403,16 @@ export default function CILSearchPage() {
   const [loading, setLoading] = useState(false)
   const [searched, setSearched] = useState(false)
   const [error, setError] = useState<string | null>(null)
+  const [projects, setProjects] = useState<{ id: string; title: string }[]>([])
   const inputRef = useRef<HTMLInputElement>(null)
 
+  useEffect(() => {
+    apiFetch('/api/cil-project?action=list')
+      .then(r => r.json())
+      .then(data => setProjects(data?.projects || []))
+      .catch(() => {})
+  }, [])
+
   const handleSearch = async () => {
     if (!query.trim()) return
     setLoading(true)
@@ -361,17 +476,6 @@ export default function CILSearchPage() {
           Semantic + text search across all indexed code chunks
         </p>
       </div>
-
-      <PageInstructions
-        description="Search the Code Intelligence Layer index by meaning or text."
-        sections={[
-          { title: 'What this page is for', content: 'This page lets you find indexed code chunks across projects using hybrid, semantic, or text search.' },
-          { title: 'How to use this page', content: 'Enter a query, choose a mode, and click the search button or press Enter. Use the Project ID, Type, Docs, and Sort filters to narrow results.' },
-          { title: 'How to read the results', content: 'Each result shows the chunk name, file, type, documentation confidence, and a relevance score. Semantic mode ranks by vector similarity; text mode matches literal terms.' },
-          { title: 'Important notes', content: 'Hybrid mode combines vector and text ranking. Filters can exclude results, and the count line indicates how many of the total results are displayed after filtering.' },
-        ]}
-      />
-
       {}
       <div className="space-y-3">
         <div className="flex gap-2">
@@ -410,13 +514,18 @@ export default function CILSearchPage() {
           </div>
 
           <div className="flex items-center gap-2">
-            <Label className="text-xs text-muted-foreground">Project ID</Label>
-            <Input
-              placeholder="(all projects)"
-              value={projectId}
-              onChange={e => setProjectId(e.target.value)}
-              className="h-7 w-48 text-xs font-mono"
-            />
+            <Label className="text-xs text-muted-foreground">Project</Label>
+            <Select value={projectId || 'all'} onValueChange={v => setProjectId(v === 'all' ? '' : v)}>
+              <SelectTrigger className="h-7 w-48 text-xs">
+                <SelectValue placeholder="All projects" />
+              </SelectTrigger>
+              <SelectContent>
+                <SelectItem value="all">All projects</SelectItem>
+                {projects.map(p => (
+                  <SelectItem key={p.id} value={p.id}>{p.title || p.id}</SelectItem>
+                ))}
+              </SelectContent>
+            </Select>
           </div>
 
           <div className="flex items-center gap-2">
@@ -575,10 +684,11 @@ export default function CILSearchPage() {
     </div>
   )
 }
-// CIL[DOC-VECTOR type="context" content="purpose='Render the full CIL chunk search page with query controls, filters, and result list.'; No verified external callers; imports: .framework/src/lib/api.ts,.framework/src/components/ui/card.tsx,.framework/src/components/ui/button.tsx"]
-// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
-// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
-// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
-// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
-// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 // CIL[END stable_id="~/.framework/src/pages/admin/cil/CILSearchPage.tsx:CILSearchPage:component"]
+
+
+
+
+
+
+