spine-framework 0.3.145 → 0.4.0

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

@@ -1,18 +1,13 @@
-// CIL[BEGIN chunk_id="cildashboardpage_module_header_1784193942" type="module_header" identity="module_header" parent="none"]
-// CIL[DOC-MACRO purpose="Import dependencies and icons for the CIL dashboard page"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provides module imports and icon references used by the page"]
-// CIL[DOC-CONTEXT module="cortex:cil-dashboard" layer="presentation" related_files="[\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\"custom/apps/cortex/functions/custom_cil-embeddings.ts\",\".framework/functions/_shared/principal.ts\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="module imports" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Imports 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[BEGIN stable_id="~/.framework/src/pages/admin/cil/CILDashboardPage.tsx:module_header:module_header" type="module_header" identity="module_header" parent="none"]
+// CIL[DOC-MACRO purpose="Admin CIL project dashboard page root module: imports dependencies and composes the CILDashboardPage component."]
+// CIL[DOC-RESPONSIBILITY responsibility="Bootstraps the admin CIL dashboard page and wires UI primitives, icons, and the local PageInstructions component."]
+// CIL[DOC-CONTEXT module="admin/cil" layer="page" 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/progress.tsx,.framework/src/components/ui/skeleton.tsx,.framework/src/lib/api.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="default export CILDashboardPage" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Imports React hooks, router, API, UI components, icons, and PageInstructions." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" 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, custom/apps/cortex/functions/custom_cil-embeddings.ts, .framework/functions/_shared/principal.ts, \."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
-// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
-// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[DOC-AUDIENCE audience="developers maintaining the CIL admin UI"]
+
 import { useEffect, useState, useCallback } from 'react'
 import { useParams } from 'react-router-dom'
 import { apiFetch } from '@core/lib/api'
@@ -41,24 +36,23 @@ import {
   Settings2,
 } from 'lucide-react'
 
-
-
 import { PageInstructions } from '../../../components/admin/PageInstructions'
-// CIL[END chunk_id="cildashboardpage_module_header_1784193942"]
-// CIL[BEGIN chunk_id="cildashboardpage_projectstats_1784193942" type="interface" identity="ProjectStats" parent="none"]
-// CIL[DOC-MACRO purpose="Define the ProjectStats data shape"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide a TypeScript type contract for project-level ingestion statistics"]
-// CIL[DOC-CONTEXT module="cortex:cil-dashboard" layer="presentation" related_files="[\".framework/src/pages/admin/IntegrationsPage.tsx\",\".framework/functions/_shared/principal.ts\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/functions/_shared/schema-utils.ts\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="ProjectStats type definition" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Declares file count, chunk count, proposal counts, ingestion cost, and last ingestion timestamp" 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/pages/admin/IntegrationsPage.tsx, .framework/functions/_shared/principal.ts, custom/apps/cortex/pages/operations/OperationsDashboard.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="context" content="purpose='Admin CIL project dashboard page root module: imports dependencies and composes the CILDashboardPage component.'; 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/CILDashboardPage.tsx:module_header:module_header"]
+
+// CIL[BEGIN stable_id="~/.framework/src/pages/admin/cil/CILDashboardPage.tsx:projectstats:interface" type="interface" identity="ProjectStats" parent="none"]
+// CIL[DOC-MACRO purpose="Defines the shape of CIL project ingestion statistics."]
+// CIL[DOC-RESPONSIBILITY responsibility="Provides a typed contract for project-level stats returned from the ingestion pipeline."]
+// 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/progress.tsx,.framework/src/components/ui/skeleton.tsx,.framework/src/lib/api.ts,.framework/src/pages/admin/cil/CILDashboardPage.tsx"]
+// CIL[DOC-CONTRACT inputs="none" outputs="interface ProjectStats" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Fields: file_count, chunk_count, proposal_count, approved_count, pending_review_count, total_ingestion_cost_usd, last_ingested_at." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 interface ProjectStats {
   file_count: number
   chunk_count: number
@@ -68,44 +62,44 @@ interface ProjectStats {
   total_ingestion_cost_usd: number
   last_ingested_at: string | null
 }
-
-// CIL[END chunk_id="cildashboardpage_projectstats_1784193942"]
-// CIL[BEGIN chunk_id="cildashboardpage_embedstatus_1784193942" type="interface" identity="EmbedStatus" parent="none"]
-// CIL[DOC-MACRO purpose="Define the EmbedStatus data shape"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide a TypeScript type contract for chunk embedding coverage"]
-// CIL[DOC-CONTEXT module="cortex:cil-dashboard" layer="presentation" related_files="[\".framework/src/pages/admin/IntegrationsPage.tsx\",\".framework/functions/_shared/principal.ts\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/functions/_shared/schema-utils.ts\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="EmbedStatus type definition" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Declares total, embedded, unembedded counts and coverage percentage" 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/pages/admin/IntegrationsPage.tsx, .framework/functions/_shared/principal.ts, custom/apps/cortex/pages/operations/OperationsDashboard.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="context" content="purpose='Defines the shape of CIL project ingestion statistics.'; 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/CILDashboardPage.tsx:projectstats:interface"]
+
+// CIL[BEGIN stable_id="~/.framework/src/pages/admin/cil/CILDashboardPage.tsx:embedstatus:interface" type="interface" identity="EmbedStatus" parent="none"]
+// CIL[DOC-MACRO purpose="Defines the shape of CIL embedding coverage status."]
+// CIL[DOC-RESPONSIBILITY responsibility="Types the embedding completeness counts for a project."]
+// 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/progress.tsx,.framework/src/components/ui/skeleton.tsx,.framework/src/lib/api.ts,.framework/src/pages/admin/cil/CILDashboardPage.tsx"]
+// CIL[DOC-CONTRACT inputs="none" outputs="interface EmbedStatus" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Fields: total_chunks, embedded_chunks, coverage_pct, unembedded_chunks." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 interface EmbedStatus {
   total_chunks: number
   embedded_chunks: number
   coverage_pct: number
   unembedded_chunks: number
 }
-
-// CIL[END chunk_id="cildashboardpage_embedstatus_1784193942"]
-// CIL[BEGIN chunk_id="cildashboardpage_docstatus_1784193942" type="interface" identity="DocStatus" parent="none"]
-// CIL[DOC-MACRO purpose="Define the DocStatus data shape"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide a TypeScript type contract for documentation coverage"]
-// CIL[DOC-CONTEXT module="cortex:cil-dashboard" layer="presentation" related_files="[\".framework/src/pages/admin/IntegrationsPage.tsx\",\".framework/functions/_shared/principal.ts\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/functions/_shared/schema-utils.ts\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="DocStatus type definition" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Declares total, documented, undocumented, AI-generated, human-verified counts and coverage percentage" 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/pages/admin/IntegrationsPage.tsx, .framework/functions/_shared/principal.ts, custom/apps/cortex/pages/operations/OperationsDashboard.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="context" content="purpose='Defines the shape of CIL embedding coverage status.'; 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/CILDashboardPage.tsx:embedstatus:interface"]
+
+// CIL[BEGIN stable_id="~/.framework/src/pages/admin/cil/CILDashboardPage.tsx:docstatus:interface" type="interface" identity="DocStatus" parent="none"]
+// CIL[DOC-MACRO purpose="Defines the shape of CIL documentation coverage status."]
+// CIL[DOC-RESPONSIBILITY responsibility="Types the documentation coverage counts for a project."]
+// 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/progress.tsx,.framework/src/components/ui/skeleton.tsx,.framework/src/lib/api.ts,.framework/src/pages/admin/cil/CILDashboardPage.tsx"]
+// CIL[DOC-CONTRACT inputs="none" outputs="interface DocStatus" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Fields: total_chunks, documented_count, undocumented_count, ai_generated_count, human_verified_count, coverage_pct." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 interface DocStatus {
   total_chunks: number
   documented_count: number
@@ -114,22 +108,22 @@ interface DocStatus {
   human_verified_count: number
   coverage_pct: number
 }
-
-// CIL[END chunk_id="cildashboardpage_docstatus_1784193942"]
-// CIL[BEGIN chunk_id="cildashboardpage_callmapstatus_1784193942" type="interface" identity="CallmapStatus" parent="none"]
-// CIL[DOC-MACRO purpose="Define the CallmapStatus data shape"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide a TypeScript type contract for call graph link counts"]
-// CIL[DOC-CONTEXT module="cortex:cil-dashboard" layer="presentation" related_files="[\".framework/src/pages/admin/IntegrationsPage.tsx\",\".framework/functions/_shared/principal.ts\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/functions/_shared/schema-utils.ts\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="CallmapStatus type definition" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Declares import, call, export, and tested-by link 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: presentation. Direct callers: 0. Direct calls: 0. Related files: .framework/src/pages/admin/IntegrationsPage.tsx, .framework/functions/_shared/principal.ts, custom/apps/cortex/pages/operations/OperationsDashboard.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="context" content="purpose='Defines the shape of CIL documentation coverage status.'; 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/CILDashboardPage.tsx:docstatus:interface"]
+
+// CIL[BEGIN stable_id="~/.framework/src/pages/admin/cil/CILDashboardPage.tsx:callmapstatus:interface" type="interface" identity="CallmapStatus" parent="none"]
+// CIL[DOC-MACRO purpose="Defines the shape of CIL call-map link counts."]
+// CIL[DOC-RESPONSIBILITY responsibility="Types the call-map and import link counts for a project."]
+// 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/progress.tsx,.framework/src/components/ui/skeleton.tsx,.framework/src/lib/api.ts,.framework/src/pages/admin/cil/CILDashboardPage.tsx"]
+// CIL[DOC-CONTRACT inputs="none" outputs="interface CallmapStatus" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Fields: import_links, call_links, export_links, total_links, tested_by_links." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 interface CallmapStatus {
   import_links: number
   call_links: number
@@ -137,42 +131,64 @@ interface CallmapStatus {
   total_links: number
   tested_by_links?: number
 }
-
-// CIL[END chunk_id="cildashboardpage_callmapstatus_1784193942"]
-// CIL[BEGIN chunk_id="cildashboardpage_configstatus_1784193942" type="interface" identity="ConfigStatus" parent="none"]
-// CIL[DOC-MACRO purpose="Define the ConfigStatus data shape"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide a TypeScript type contract for config extraction status"]
-// CIL[DOC-CONTEXT module="cortex:cil-dashboard" layer="presentation" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="ConfigStatus type definition" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Declares config item count and configures link count" 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="context" content="purpose='Defines the shape of CIL call-map link counts.'; 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/CILDashboardPage.tsx:callmapstatus:interface"]
+
+// CIL[BEGIN stable_id="~/.framework/src/pages/admin/cil/CILDashboardPage.tsx:configstatus:interface" type="interface" identity="ConfigStatus" parent="none"]
+// CIL[DOC-MACRO purpose="Defines the shape of CIL configuration graph status."]
+// CIL[DOC-RESPONSIBILITY responsibility="Types the configuration graph item counts for a project."]
+// 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/progress.tsx,.framework/src/components/ui/skeleton.tsx,.framework/src/lib/api.ts,.framework/src/pages/admin/cil/CILDashboardPage.tsx"]
+// CIL[DOC-CONTRACT inputs="none" outputs="interface ConfigStatus" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Fields: config_items, configures_links." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 interface ConfigStatus {
   config_items: number
   configures_links: number
 }
-
-// CIL[END chunk_id="cildashboardpage_configstatus_1784193942"]
-// CIL[BEGIN chunk_id="cildashboardpage_dashboarddata_1784193942" type="interface" identity="DashboardData" parent="none"]
-// CIL[DOC-MACRO purpose="Aggregate dashboard data types into a single view model"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide a TypeScript type contract for the dashboard's combined data state"]
-// CIL[DOC-CONTEXT module="cortex:cil-dashboard" layer="presentation" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="DashboardData type definition" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Groups project, embed, doc, callmap, and config status objects" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[DOC-VECTOR type="context" content="purpose='Defines the shape of CIL configuration graph status.'; 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/CILDashboardPage.tsx:configstatus:interface"]
+
+// CIL[BEGIN stable_id="~/.framework/src/pages/admin/cil/CILDashboardPage.tsx:pipelineprogress:interface" type="interface" identity="PipelineProgress" parent="none"]
+// CIL[DOC-MACRO purpose="Defines the shape of CIL pipeline progress aggregation."]
+// CIL[DOC-RESPONSIBILITY responsibility="Types the pipeline progress counts and per-file status for a project."]
+// 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/progress.tsx,.framework/src/components/ui/skeleton.tsx,.framework/src/lib/api.ts,.framework/src/pages/admin/cil/CILDashboardPage.tsx"]
+// CIL[DOC-CONTRACT inputs="none" outputs="interface PipelineProgress" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Fields: total_selected, total_chunks, by_status, file_statuses." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" 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."]
+interface PipelineProgress {
+  total_selected: number
+  total_chunks: number
+  by_status: Record<string, number>
+  file_statuses: Record<string, string>
+}
+// CIL[DOC-VECTOR type="context" content="purpose='Defines the shape of CIL pipeline progress aggregation.'; 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/CILDashboardPage.tsx:pipelineprogress:interface"]
+
+// CIL[BEGIN stable_id="~/.framework/src/pages/admin/cil/CILDashboardPage.tsx:dashboarddata:interface" type="interface" identity="DashboardData" parent="none"]
+// CIL[DOC-MACRO purpose="Defines the aggregate dashboard data type used by CILDashboardPage."]
+// CIL[DOC-RESPONSIBILITY responsibility="Types the unified dashboard data object fetched from multiple endpoints."]
+// 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/progress.tsx,.framework/src/components/ui/skeleton.tsx,.framework/src/lib/api.ts,.framework/src/pages/admin/cil/CILDashboardPage.tsx"]
+// CIL[DOC-CONTRACT inputs="none" outputs="interface DashboardData" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Fields: project, embed, doc, callmap, config." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 interface DashboardData {
   project: { id: string; title: string; data: ProjectStats } | null
   embed: EmbedStatus | null
@@ -180,24 +196,22 @@ interface DashboardData {
   callmap: CallmapStatus | null
   config: ConfigStatus | null
 }
-
-
-
-// CIL[END chunk_id="cildashboardpage_dashboarddata_1784193942"]
-// CIL[BEGIN chunk_id="cildashboardpage_passcard_1784193942" type="function" identity="PassCard" parent="none"]
-// CIL[DOC-MACRO purpose="Render a pipeline pass card with status, label, description, and metric"]
-// CIL[DOC-RESPONSIBILITY responsibility="Display a single pipeline step's completion status and metric as a clickable card"]
-// CIL[DOC-CONTEXT module="cortex:cil-dashboard" layer="presentation" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="JSX.Element" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Selects a status color and icon config and renders a compact status card with an optional link" 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="context" content="purpose='Defines the aggregate dashboard data type used by CILDashboardPage.'; 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/CILDashboardPage.tsx:dashboarddata:interface"]
+
+// CIL[BEGIN stable_id="~/.framework/src/pages/admin/cil/CILDashboardPage.tsx:passcard:function" type="function" identity="PassCard" parent="none"]
+// CIL[DOC-MACRO purpose="Renders a single pipeline pass card with status, icon, metric, and optional link."]
+// CIL[DOC-RESPONSIBILITY responsibility="Visualizes the state of one CIL pipeline stage."]
+// CIL[DOC-CONTEXT module="admin/cil" layer="component" 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/progress.tsx,.framework/src/components/ui/skeleton.tsx,.framework/src/lib/api.ts,.framework/src/pages/admin/cil/CILDashboardPage.tsx"]
+// CIL[DOC-CONTRACT inputs="PassCard props: number, label, icon, description, status, metric, href?, skill?" outputs="JSX card element" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Selects status color, background, and icon from statusConfig and renders a compact linked card." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function PassCard({
   number,
   label,
@@ -206,6 +220,7 @@ function PassCard({
   status,
   metric,
   href,
+  skill,
 }: {
   number: string
   label: string
@@ -214,6 +229,7 @@ function PassCard({
   status: 'complete' | 'partial' | 'empty' | 'unknown'
   metric: string
   href?: string
+  skill?: string
 }) {
   const statusConfig = {
     complete: { color: 'text-green-600', bg: 'bg-green-50 border-green-200', dot: 'bg-green-500', icon: CheckCircle2 },
@@ -233,6 +249,7 @@ function PassCard({
         <div className="flex items-center gap-1.5">
           <span className="text-xs font-bold text-muted-foreground">Pass {number}</span>
           <StatusIcon className={`h-3 w-3 ${statusConfig.color}`} />
+          {skill && <span className="text-[10px] font-mono text-muted-foreground/80 bg-slate-100 dark:bg-slate-800 px-1.5 py-0.5 rounded">{skill}</span>}
         </div>
         <div className="text-sm font-medium truncate">{label}</div>
         <div className="text-xs text-muted-foreground">{description}</div>
@@ -246,24 +263,22 @@ function PassCard({
     </div>
   )
 }
-
-
-
-// CIL[END chunk_id="cildashboardpage_passcard_1784193942"]
-// CIL[BEGIN chunk_id="cildashboardpage_stattile_1784193942" type="function" identity="StatTile" parent="none"]
-// CIL[DOC-MACRO purpose="Render a numeric statistic tile with label and optional subtext"]
-// CIL[DOC-RESPONSIBILITY responsibility="Display a single dashboard metric inside a styled Card"]
-// CIL[DOC-CONTEXT module="cortex:cil-dashboard" layer="presentation" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="JSX.Element" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Renders a Card with a large value, label, optional sub, and icon" 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="context" content="purpose='Renders a single pipeline pass card with status, icon, metric, and optional link.'; 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/CILDashboardPage.tsx:passcard:function"]
+
+// CIL[BEGIN stable_id="~/.framework/src/pages/admin/cil/CILDashboardPage.tsx:stattile:function" type="function" identity="StatTile" parent="none"]
+// CIL[DOC-MACRO purpose="Renders a numeric stat tile with optional sub-label and accent styling."]
+// CIL[DOC-RESPONSIBILITY responsibility="Displays a single dashboard metric."]
+// CIL[DOC-CONTEXT module="admin/cil" layer="component" 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/progress.tsx,.framework/src/components/ui/skeleton.tsx,.framework/src/lib/api.ts,.framework/src/pages/admin/cil/CILDashboardPage.tsx"]
+// CIL[DOC-CONTRACT inputs="StatTile props: label, value, sub?, icon, accent?" outputs="JSX card" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Renders a Card with value, label, optional sub, and an icon." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function StatTile({
   label,
   value,
@@ -292,24 +307,22 @@ function StatTile({
     </Card>
   )
 }
-
-
-
-// CIL[END chunk_id="cildashboardpage_stattile_1784193942"]
-// CIL[BEGIN chunk_id="cildashboardpage_coveragebar_1784193942" type="function" identity="CoverageBar" parent="none"]
-// CIL[DOC-MACRO purpose="Render a labeled progress bar for coverage metrics"]
-// CIL[DOC-RESPONSIBILITY responsibility="Display a percentage coverage value with a Progress bar"]
-// CIL[DOC-CONTEXT module="cortex:cil-dashboard" layer="presentation" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="JSX.Element" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Renders a label, percentage, and shadcn Progress 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: 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="context" content="purpose='Renders a numeric stat tile with optional sub-label and accent styling.'; 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/CILDashboardPage.tsx:stattile:function"]
+
+// CIL[BEGIN stable_id="~/.framework/src/pages/admin/cil/CILDashboardPage.tsx:coveragebar:function" type="function" identity="CoverageBar" parent="none"]
+// CIL[DOC-MACRO purpose="Renders a labeled progress bar showing a percentage."]
+// CIL[DOC-RESPONSIBILITY responsibility="Visualizes embedding or documentation coverage as a progress bar."]
+// CIL[DOC-CONTEXT module="admin/cil" layer="component" 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/progress.tsx,.framework/src/components/ui/skeleton.tsx,.framework/src/lib/api.ts,.framework/src/pages/admin/cil/CILDashboardPage.tsx"]
+// CIL[DOC-CONTRACT inputs="label, pct, color?" outputs="JSX progress bar" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Shows a label, percentage, and Progress component." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function CoverageBar({ label, pct, color = 'bg-indigo-500' }: { label: string; pct: number; color?: string }) {
   return (
     <div className="space-y-1">
@@ -321,24 +334,49 @@ function CoverageBar({ label, pct, color = 'bg-indigo-500' }: { label: string; p
     </div>
   )
 }
-
-
-
-// CIL[END chunk_id="cildashboardpage_coveragebar_1784193942"]
-// CIL[BEGIN chunk_id="cildashboardpage_driftalertcard_1784193942" type="function" identity="DriftAlertCard" parent="none"]
-// CIL[DOC-MACRO purpose="Check stored chunk hashes and list drifted chunks for a project"]
-// CIL[DOC-RESPONSIBILITY responsibility="Fetch chunk records, validate stored hashes, and render drift alerts with links"]
-// CIL[DOC-CONTEXT module="cortex:cil-dashboard" layer="presentation" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="JSX.Element" errors="API or validation errors are swallowed" side_effects="Calls /api/admin-data and /api/cil-validate; sets local state"]
-// CIL[DOC-MICRO logic_summary="Lists cil_chunk items for the project, calls the validate endpoint, and displays any drifted chunks or an all-current status" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[DOC-VECTOR type="context" content="purpose='Renders a labeled progress bar showing a 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/CILDashboardPage.tsx:coveragebar:function"]
+
+// CIL[BEGIN stable_id="~/.framework/src/pages/admin/cil/CILDashboardPage.tsx:step_details:constant" type="constant" identity="STEP_DETAILS" parent="none"]
+// CIL[DOC-MACRO purpose="Maps CIL pipeline step slugs to labels, icons, descriptions, and skill tags."]
+// CIL[DOC-RESPONSIBILITY responsibility="Provides the metadata that drives the PassCard rendering for each pipeline stage."]
+// CIL[DOC-CONTEXT module="admin/cil" layer="data" 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/progress.tsx,.framework/src/components/ui/skeleton.tsx,.framework/src/lib/api.ts,.framework/src/pages/admin/cil/CILDashboardPage.tsx"]
+// CIL[DOC-CONTRACT inputs="none" outputs="const STEP_DETAILS" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Record of step slugs to display metadata for the nine CIL pipeline stages." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" 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."]
+const STEP_DETAILS: Record<string, { label: string; icon: React.ElementType; description: string; skill?: string }> = {
+  '0-discovered': { label: 'Discover Files', icon: FileCode2, description: 'Walk repo and register source files' },
+  '1-selected': { label: 'Select Files', icon: Search, description: 'Files matched by selected paths/globs' },
+  '2-chunked': { label: 'Chunk', icon: Layers, description: 'Parse files and write stable-ID markers', skill: 'cil-3' },
+  '3-documented': { label: 'Document', icon: Sparkles, description: 'Generate macro / micro / contract fields', skill: 'cil-4' },
+  '4-chunk-validated': { label: 'Validate Chunks', icon: CheckCircle2, description: 'Check coverage, overlap, stable IDs, and JSX leakage', skill: 'cil-5' },
+  '5-doc-validated': { label: 'Validate Docs', icon: CheckCircle2, description: 'Confirm required CIL[DOC-*] fields are present', skill: 'cil-6' },
+  '6-enriched': { label: 'Enrich', icon: Settings2, description: 'Add RAG context, blast radius, and learning notes', skill: 'cil-7' },
+  '7-embedded-mapped': { label: 'Embed & Map', icon: Zap, description: 'Generate embeddings and import/call/test edges', skill: 'cil-8' },
+  '8-published': { label: 'Publish', icon: CheckCircle2, description: 'Final validation and currentness check' },
+}
+// CIL[DOC-VECTOR type="context" content="purpose='Maps CIL pipeline step slugs to labels, icons, descriptions, and skill tags.'; 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/CILDashboardPage.tsx:step_details:constant"]
+
+// CIL[BEGIN stable_id="~/.framework/src/pages/admin/cil/CILDashboardPage.tsx:driftalertcard:function" type="function" identity="DriftAlertCard" parent="none"]
+// CIL[DOC-MACRO purpose="Renders a card that detects and displays CIL chunk hash drift for a project."]
+// CIL[DOC-RESPONSIBILITY responsibility="Fetches stored chunks, validates hashes, and surfaces drifted chunks with navigation links."]
+// CIL[DOC-CONTEXT module="admin/cil" layer="component" 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/progress.tsx,.framework/src/components/ui/skeleton.tsx,.framework/src/lib/api.ts,.framework/src/pages/admin/cil/CILDashboardPage.tsx"]
+// CIL[DOC-CONTRACT inputs="projectId, appPath" outputs="JSX card" errors="API or network errors swallowed" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Calls admin-data and cil-validate APIs, compares hash status, and lists up to 5 drifted chunks with a count." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function DriftAlertCard({ projectId, appPath }: { projectId: string; appPath: (p: string) => string }) {
   const [driftChunks, setDriftChunks] = useState<any[] | null>(null)
   const [checking, setChecking] = useState(false)
@@ -355,7 +393,6 @@ function DriftAlertCard({ projectId, appPath }: { projectId: string; appPath: (p
 
       if (!chunks.length) { setDriftChunks([]); return }
 
-      
       const validateRes = await apiFetch('/api/cil-validate?action=validate', {
         method: 'POST',
         headers: { 'Content-Type': 'application/json' },
@@ -422,36 +459,37 @@ function DriftAlertCard({ projectId, appPath }: { projectId: string; appPath: (p
     </Card>
   )
 }
-
-
-
-// CIL[END chunk_id="cildashboardpage_driftalertcard_1784193942"]
-// CIL[BEGIN chunk_id="cildashboardpage_cildashboardpage_1784193942" type="component" identity="CILDashboardPage" parent="none"]
-// CIL[DOC-MACRO purpose="Render the CIL project dashboard page"]
-// CIL[DOC-RESPONSIBILITY responsibility="Fetch project status and display pipeline passes, coverage, stats, graph links, drift alerts, and quick actions"]
-// CIL[DOC-CONTEXT module="cortex:cil-dashboard" layer="presentation" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="JSX.Element" errors="Failed requests are ignored; empty states shown" side_effects="Calls /api/cil-project, /api/cil-embeddings, /api/cil-doc, /api/cil-callmap, and /api/cil-config; updates local state"]
-// CIL[DOC-MICRO logic_summary="Loads project, embedding, documentation, callmap, and config statuses in parallel, then renders stat tiles, coverage bars, pass cards, graph links, drift alerts, and quick action buttons" 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="context" content="purpose='Renders a card that detects and displays CIL chunk hash drift for a project.'; 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/CILDashboardPage.tsx:driftalertcard:function"]
+
+// CIL[BEGIN stable_id="~/.framework/src/pages/admin/cil/CILDashboardPage.tsx:cildashboardpage:function" type="function" identity="CILDashboardPage" parent="none"]
+// CIL[DOC-MACRO purpose="Main admin page for reviewing CIL project health, coverage, pipeline status, graph links, and drift."]
+// CIL[DOC-RESPONSIBILITY responsibility="Fetches and aggregates project stats, coverage, pipeline progress, callmap, and config; renders the dashboard layout."]
+// CIL[DOC-CONTEXT module="admin/cil" layer="page" 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/progress.tsx,.framework/src/components/ui/skeleton.tsx,.framework/src/lib/api.ts,.framework/src/pages/admin/cil/CILDashboardPage.tsx"]
+// CIL[DOC-CONTRACT inputs="route param id" outputs="JSX dashboard" errors="API errors fall back to null or empty values" side_effects="loads data on mount and on projectId change"]
+// CIL[DOC-MICRO logic_summary="Fetches six endpoints in parallel, computes stats, renders PassCards for each pipeline step, and embeds DriftAlertCard." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export default function CILDashboardPage() {
   const { id: projectId } = useParams<{ id: string }>()
   const appPath = (path: string) => '/spine-framework/admin' + (path.startsWith('/') ? path : '/' + path)
   const [data, setData] = useState<DashboardData>({ project: null, embed: null, doc: null, callmap: null, config: null })
+  const [pipelineProgress, setPipelineProgress] = useState<PipelineProgress | null>(null)
   const [loading, setLoading] = useState(true)
+  const [discovering, setDiscovering] = useState(false)
 
   const load = useCallback(async () => {
     if (!projectId) return
     setLoading(true)
     try {
-      const [projectRes, embedRes, docRes, callmapRes, configRes] = await Promise.allSettled([
+      const [projectRes, progressRes, embedRes, docRes, callmapRes, configRes] = await Promise.allSettled([
         apiFetch(`/api/cil-project?action=get&id=${projectId}`).then(r => r.json()),
+        apiFetch(`/api/cil-project?action=pipeline_progress&id=${projectId}`).then(r => r.json()),
         apiFetch(`/api/cil-embeddings?action=status&project_id=${projectId}`).then(r => r.json()),
         apiFetch(`/api/cil-doc?action=gap_report&project_id=${projectId}`).then(r => r.json()),
         apiFetch(`/api/cil-callmap?action=status&project_id=${projectId}`).then(r => r.json()),
@@ -465,6 +503,8 @@ export default function CILDashboardPage() {
         callmap: callmapRes.status === 'fulfilled' ? (callmapRes.value?.data || callmapRes.value) : null,
         config:  configRes.status === 'fulfilled'  ? (configRes.value?.data  || configRes.value)  : null,
       })
+      const progressData = progressRes.status === 'fulfilled' ? (progressRes.value?.data || progressRes.value) : null
+      setPipelineProgress(progressData?.progress || null)
     } finally {
       setLoading(false)
     }
@@ -472,6 +512,25 @@ export default function CILDashboardPage() {
 
   useEffect(() => { load() }, [load])
 
+  const project = data.project
+
+  const handleDiscover = useCallback(async () => {
+    if (!projectId) return
+    setDiscovering(true)
+    try {
+      await apiFetch('/api/cil-ingest?action=discover', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ project_id: projectId }),
+      })
+    } finally {
+      setDiscovering(false)
+      load()
+    }
+  }, [projectId, load])
+
+
+
   if (loading) {
     return (
       <div className="p-6 space-y-4">
@@ -482,25 +541,29 @@ export default function CILDashboardPage() {
     )
   }
 
-  const project = data.project
   const stats: ProjectStats = project?.data || { file_count: 0, chunk_count: 0, proposal_count: 0, approved_count: 0, pending_review_count: 0, total_ingestion_cost_usd: 0, last_ingested_at: null }
   const embed   = data.embed   || { total_chunks: 0, embedded_chunks: 0, coverage_pct: 0, unembedded_chunks: 0 }
   const doc     = data.doc     || { total_chunks: 0, documented_count: 0, undocumented_count: 0, ai_generated_count: 0, human_verified_count: 0, coverage_pct: 0 }
   const callmap = data.callmap || { import_links: 0, call_links: 0, export_links: 0, total_links: 0, tested_by_links: 0 }
   const config  = data.config  || { config_items: 0, configures_links: 0 }
 
+  const pp = pipelineProgress || { total_selected: 0, total_chunks: 0, by_status: {}, file_statuses: {} }
+  const selectedFiles = pp.total_selected
+  const selectedChunks = pp.total_chunks
+  const totalTracked = Object.values(pp.by_status).reduce((a, b) => a + (b || 0), 0)
+
+  const PIPELINE_ORDER = [
+    '0-discovered', '1-selected', '2-chunked', '3-documented', '4-chunk-validated',
+    '5-doc-validated', '6-enriched', '7-embedded-mapped', '8-published',
+  ]
+
+  const embedPct = selectedChunks > 0 ? Math.round((embed.embedded_chunks / selectedChunks) * 100) : 0
+  const docPct = selectedChunks > 0 ? Math.round((doc.documented_count / selectedChunks) * 100) : 0
+
   const lastIngested = stats.last_ingested_at
     ? new Date(stats.last_ingested_at).toLocaleDateString('en-US', { month: 'short', day: 'numeric', hour: '2-digit', minute: '2-digit' })
     : 'Never'
 
-  
-  const pass1Status = stats.file_count > 0 ? 'complete' : 'empty'
-  const pass2Status = stats.chunk_count > 0 ? 'complete' : (stats.file_count > 0 ? 'partial' : 'empty')
-  const pass3Status = embed.coverage_pct === 100 ? 'complete' : (embed.embedded_chunks > 0 ? 'partial' : 'empty') as any
-  const pass4Status = doc.coverage_pct === 100 ? 'complete' : (doc.documented_count > 0 ? 'partial' : 'empty') as any
-  const pass4bStatus = callmap.total_links > 0 ? 'complete' : 'empty' as any
-  const pass5Status = config.config_items > 0 ? (config.configures_links > 0 ? 'complete' : 'partial') : 'empty' as any
-
   return (
     <div className="p-6 space-y-6 max-w-5xl">
       {}
@@ -522,6 +585,16 @@ export default function CILDashboardPage() {
           <Button size="sm" variant="outline" onClick={load} className="h-8 text-xs">
             <RefreshCw className="h-3 w-3 mr-1" /> Refresh
           </Button>
+          <Button size="sm" variant="outline" onClick={handleDiscover} disabled={discovering} className="h-8 text-xs">
+            {discovering ? <RefreshCw className="h-3 w-3 mr-1 animate-spin" /> : <FileCode2 className="h-3 w-3 mr-1" />}
+            Discover
+          </Button>
+          <Button size="sm" variant="outline" asChild className="h-8 text-xs">
+            <a href={appPath(`/cil/${projectId}/select`)}>
+              <Search className="h-3 w-3 mr-1" />
+              Select Files
+            </a>
+          </Button>
           <Button size="sm" asChild className="h-8 text-xs">
             <a href={appPath(`/cil/${projectId}/ingest`)}>
               <Play className="h-3 w-3 mr-1" /> Run Pipeline
@@ -535,15 +608,15 @@ export default function CILDashboardPage() {
         sections={[
           { title: 'What this page is for', content: 'This page is the project-level overview for a CIL project. It displays stats, coverage, pipeline status, graph links, and drift alerts.' },
           { title: 'How to read the cards', content: 'The top tiles show Files, Chunks, Pending Review, and cumulative LLM Cost. The Coverage card shows embedding and documentation coverage plus AI-generated, human-verified, and undocumented counts.' },
-          { title: 'How to read the pipeline', content: 'Pass cards summarize Discover Files, AST Chunk, Embed Chunks, AI Document, Call Map, and Config Extract. Each card shows status, counts, and a link to the relevant step.' },
+          { title: 'How to read the pipeline', content: 'Pass cards summarize Discover Files, Select Files, Chunk, Document, Validate Chunks, Validate Docs, Enrich, Embed & Map, and Publish. Each card shows status, counts, and a link to the relevant step.' },
           { title: 'Important notes', content: 'Use Refresh to reload the dashboard and Run Pipeline to start or continue ingestion. A drift alert appears when stored hashes differ from current code.' },
         ]}
       />
 
       {}
       <div className="grid grid-cols-2 sm:grid-cols-4 gap-4">
-        <StatTile label="Files" value={stats.file_count.toLocaleString()} icon={FileCode2} />
-        <StatTile label="Chunks" value={stats.chunk_count.toLocaleString()} icon={Layers} accent />
+        <StatTile label="Files" value={selectedFiles.toLocaleString()} sub={`${stats.file_count.toLocaleString()} discovered`} icon={FileCode2} />
+        <StatTile label="Chunks" value={selectedChunks.toLocaleString()} sub={`${stats.chunk_count.toLocaleString()} discovered`} icon={Layers} accent />
         <StatTile
           label="Pending Review"
           value={stats.pending_review_count}
@@ -586,48 +659,43 @@ export default function CILDashboardPage() {
       <div>
         <h2 className="text-sm font-medium text-muted-foreground uppercase tracking-wide mb-3">Pipeline Status</h2>
         <div className="grid grid-cols-1 sm:grid-cols-2 gap-3">
-          <PassCard
-            number="1" label="Discover Files" icon={FileCode2}
-            description="Walk repo, register cil_file items, compute hashes"
-            status={pass1Status}
-            metric={`${stats.file_count.toLocaleString()} files registered`}
-            href={appPath(`/cil/${projectId}/ingest`)}
-          />
-          <PassCard
-            number="2" label="AST Chunk" icon={Layers}
-            description="Parse files, propose chunk boundaries, write markers"
-            status={pass2Status}
-            metric={`${stats.chunk_count.toLocaleString()} chunks · ${stats.pending_review_count} pending`}
-            href={appPath(`/cil/${projectId}/ingest`)}
-          />
-          <PassCard
-            number="3" label="Embed Chunks" icon={Zap}
-            description="Semantic + structural + contract vector embeddings"
-            status={pass3Status}
-            metric={`${embed.coverage_pct}% coverage · ${embed.embedded_chunks} / ${embed.total_chunks}`}
-            href={appPath(`/cil/${projectId}/ingest`)}
-          />
-          <PassCard
-            number="4" label="AI Document" icon={Sparkles}
-            description="LLM-generated macro / micro / contract fields"
-            status={pass4Status}
-            metric={`${doc.coverage_pct}% coverage · $${(stats.total_ingestion_cost_usd ?? 0).toFixed(4)} spent`}
-            href={appPath(`/cil/${projectId}/ingest`)}
-          />
-          <PassCard
-            number="4b" label="Call Map" icon={GitGraph}
-            description="Import + call edges between files and chunks"
-            status={pass4bStatus}
-            metric={`${callmap.call_links.toLocaleString()} calls · ${callmap.import_links.toLocaleString()} imports`}
-            href={appPath(`/cil/${projectId}/graph`)}
-          />
-          <PassCard
-            number="5" label="Config Extract" icon={Settings2}
-            description="Config field contracts + cil_configures links"
-            status={pass5Status}
-            metric={`${config.config_items.toLocaleString()} config items · ${config.configures_links.toLocaleString()} links`}
-            href={appPath(`/cil/${projectId}/ingest`)}
-          />
+          {(() => {
+            const outByIdx = PIPELINE_ORDER.map((_, i) =>
+              PIPELINE_ORDER.slice(i === 0 ? 1 : i).reduce((sum, s) => sum + (pp.by_status[s] || 0), 0)
+            )
+
+            return PIPELINE_ORDER.map((status, idx) => {
+
+              const detail = STEP_DETAILS[status]
+
+              const inCount = idx === 0 ? totalTracked : outByIdx[idx - 1]
+              const outCount = outByIdx[idx]
+
+              const stageStatus = inCount === 0
+                ? 'empty'
+                : inCount > 0 && outCount === inCount
+                  ? 'complete'
+                  : 'partial'
+
+              const metric = selectedFiles > 0
+                ? `${inCount.toLocaleString()} / ${outCount.toLocaleString()} files`
+                : 'No files selected'
+
+              return (
+                <PassCard
+                  key={status}
+                  number={`${idx + 1}`}
+                  label={detail?.label || status}
+                  icon={detail?.icon || Clock}
+                  description={detail?.description || ''}
+                  status={stageStatus as 'complete' | 'partial' | 'empty' | 'unknown'}
+                  metric={metric}
+                  href={appPath(`/cil/${projectId}/ingest`)}
+                  skill={detail?.skill}
+                />
+              )
+            })
+          })()}
         </div>
       </div>
 
@@ -695,5 +763,10 @@ export default function CILDashboardPage() {
     </div>
   )
 }
-
-// CIL[END chunk_id="cildashboardpage_cildashboardpage_1784193942"]
+// CIL[DOC-VECTOR type="context" content="purpose='Main admin page for reviewing CIL project health, coverage, pipeline status, graph links, and drift.'; 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/CILDashboardPage.tsx:cildashboardpage:function"]