spine-framework 0.3.145 → 0.4.0

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

@@ -1,19 +1,13 @@
-
-// CIL[BEGIN chunk_id="flexiblepipelinepage_module_header_1784191730" type="module_header" identity="module_header" parent="none"]
-// CIL[DOC-MACRO purpose="Import dependencies for FlexiblePipelinePage.tsx"]
-// CIL[DOC-RESPONSIBILITY responsibility="Set up module imports and external references"]
-// CIL[DOC-CONTEXT module="cortex.pages.cil" layer="presentation" related_files="[\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/functions/_shared/principal.ts\",\".framework/functions/_shared/schema-utils.ts\",\"custom/apps/portal/pages/ContentPage.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="module imports" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Imports React hooks, router, apiFetch, UI components, and icons" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[BEGIN stable_id="~/.framework/src/pages/admin/cil/FlexiblePipelinePage.tsx:module_header:module_header" type="module_header" identity="module_header" parent="none"]
+// CIL[DOC-MACRO purpose="React admin page for visualizing and controlling the CIL flexible pipeline for a project."]
+// CIL[DOC-RESPONSIBILITY responsibility="Import dependencies, set up the admin page module, and render the root page instructions."]
+// CIL[DOC-CONTEXT module="pages.admin.cil" layer="presentation" related_files=".framework/src/components/admin/PageInstructions.tsx,.framework/src/components/ui/alert.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/components/ui/tabs.tsx,.framework/src/lib/api.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="default page export and side-effecting imports" errors="none" side_effects="imports modules for page assembly"]
+// CIL[DOC-MICRO logic_summary="Imports React hooks, router, API client, UI primitives, icons, and the PageInstructions component used in this page." 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, .framework/src/pages/admin/TypeDetailPage.tsx, .framework/functions/_shared/principal.ts, .framework/functions/_shared/schema-utils.ts, custom/apps/portal/pages/ContentPage.tsx, \."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
-// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
-// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[DOC-AUDIENCE audience="maintainers"]
+
 import { useEffect, useState, useCallback } from 'react'
 import { useParams } from 'react-router-dom'
 import { apiFetch } from '@core/lib/api'
@@ -42,23 +36,23 @@ import {
   FileCode2,
 } from 'lucide-react'
 
-
 import { PageInstructions } from '../../../components/admin/PageInstructions'
-// CIL[END chunk_id="flexiblepipelinepage_module_header_1784191730"]
-// CIL[BEGIN chunk_id="flexiblepipelinepage_filepipelinestate_1784191730" type="interface" identity="FilePipelineState" parent="none"]
-// CIL[DOC-MACRO purpose="Define the FilePipelineState data shape"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide a TypeScript type contract for file pipeline state"]
-// CIL[DOC-CONTEXT module="cortex.pages.cil" 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="FilePipelineState type definition" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Declares file path, status, completed/ready/blocked steps, and progress 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='React admin page for visualizing and controlling the CIL flexible pipeline 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/FlexiblePipelinePage.tsx:module_header:module_header"]
+
+// CIL[BEGIN stable_id="~/.framework/src/pages/admin/cil/FlexiblePipelinePage.tsx:filepipelinestate:interface" type="interface" identity="FilePipelineState" parent="none"]
+// CIL[DOC-MACRO purpose="TypeScript interface describing the shape of FilePipelineState."]
+// CIL[DOC-RESPONSIBILITY responsibility="Define the data contract for FilePipelineState."]
+// CIL[DOC-CONTEXT module="pages.admin.cil" layer="presentation" related_files=".framework/src/components/admin/PageInstructions.tsx,.framework/src/components/ui/alert.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/components/ui/tabs.tsx,.framework/src/lib/api.ts,.framework/src/pages/admin/cil/FlexiblePipelinePage.tsx"]
+// CIL[DOC-CONTRACT inputs="none (type definition)" outputs="typed contract for consumers" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Describes the per-file state including path, current status, completed/ready/blocked steps, and progress percentage." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 interface FilePipelineState {
   file_path: string
   current_status: string
@@ -67,44 +61,44 @@ interface FilePipelineState {
   blocked_by: number[]
   progress_percentage: number
 }
-
-// CIL[END chunk_id="flexiblepipelinepage_filepipelinestate_1784191730"]
-// CIL[BEGIN chunk_id="flexiblepipelinepage_pipelinestatus_1784191730" type="interface" identity="PipelineStatus" parent="none"]
-// CIL[DOC-MACRO purpose="Define the PipelineStatus data shape"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide a TypeScript type contract for overall pipeline status"]
-// CIL[DOC-CONTEXT module="cortex.pages.cil" 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="PipelineStatus type definition" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Declares project id, files array, step summary, and overall progress" 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='TypeScript interface describing the shape of FilePipelineState.'; 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/FlexiblePipelinePage.tsx:filepipelinestate:interface"]
+
+// CIL[BEGIN stable_id="~/.framework/src/pages/admin/cil/FlexiblePipelinePage.tsx:pipelinestatus:interface" type="interface" identity="PipelineStatus" parent="none"]
+// CIL[DOC-MACRO purpose="TypeScript interface describing the shape of PipelineStatus."]
+// CIL[DOC-RESPONSIBILITY responsibility="Define the data contract for PipelineStatus."]
+// CIL[DOC-CONTEXT module="pages.admin.cil" layer="presentation" related_files=".framework/src/components/admin/PageInstructions.tsx,.framework/src/components/ui/alert.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/components/ui/tabs.tsx,.framework/src/lib/api.ts,.framework/src/pages/admin/cil/FlexiblePipelinePage.tsx"]
+// CIL[DOC-CONTRACT inputs="none (type definition)" outputs="typed contract for consumers" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Describes the overall pipeline status for a project, including all files and a step summary." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 interface PipelineStatus {
   project_id: string
   files: FilePipelineState[]
   step_summary: Record<number, { completed: number; pending: number; in_progress: number }>
   overall_progress: number
 }
-
-// CIL[END chunk_id="flexiblepipelinepage_pipelinestatus_1784191730"]
-// CIL[BEGIN chunk_id="flexiblepipelinepage_filesreadyforstep_1784191730" type="interface" identity="FilesReadyForStep" parent="none"]
-// CIL[DOC-MACRO purpose="Define the FilesReadyForStep data shape"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide a TypeScript type contract for step-ready files"]
-// CIL[DOC-CONTEXT module="cortex.pages.cil" 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="FilesReadyForStep type definition" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Declares step metadata and an array of file readiness records" 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='TypeScript interface describing the shape of PipelineStatus.'; 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/FlexiblePipelinePage.tsx:pipelinestatus:interface"]
+
+// CIL[BEGIN stable_id="~/.framework/src/pages/admin/cil/FlexiblePipelinePage.tsx:filesreadyforstep:interface" type="interface" identity="FilesReadyForStep" parent="none"]
+// CIL[DOC-MACRO purpose="TypeScript interface describing the shape of FilesReadyForStep."]
+// CIL[DOC-RESPONSIBILITY responsibility="Define the data contract for FilesReadyForStep."]
+// CIL[DOC-CONTEXT module="pages.admin.cil" layer="presentation" related_files=".framework/src/components/admin/PageInstructions.tsx,.framework/src/components/ui/alert.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/components/ui/tabs.tsx,.framework/src/lib/api.ts,.framework/src/pages/admin/cil/FlexiblePipelinePage.tsx"]
+// CIL[DOC-CONTRACT inputs="none (type definition)" outputs="typed contract for consumers" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Describes the response for files that are ready to be processed for a specific step, including blocking info." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 interface FilesReadyForStep {
   ok: boolean
   project_id: string
@@ -124,22 +118,22 @@ interface FilesReadyForStep {
     blocking_reasons: string[]
   }>
 }
-
-// CIL[END chunk_id="flexiblepipelinepage_filesreadyforstep_1784191730"]
-// CIL[BEGIN chunk_id="flexiblepipelinepage_bottleneckanalysis_1784191730" type="interface" identity="BottleneckAnalysis" parent="none"]
-// CIL[DOC-MACRO purpose="Define the BottleneckAnalysis data shape"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide a TypeScript type contract for bottleneck analysis"]
-// CIL[DOC-CONTEXT module="cortex.pages.cil" 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="BottleneckAnalysis type definition" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Declares bottlenecks, recommendations, optimal processing order, and summary" 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='TypeScript interface describing the shape of FilesReadyForStep.'; 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/FlexiblePipelinePage.tsx:filesreadyforstep:interface"]
+
+// CIL[BEGIN stable_id="~/.framework/src/pages/admin/cil/FlexiblePipelinePage.tsx:bottleneckanalysis:interface" type="interface" identity="BottleneckAnalysis" parent="none"]
+// CIL[DOC-MACRO purpose="TypeScript interface describing the shape of BottleneckAnalysis."]
+// CIL[DOC-RESPONSIBILITY responsibility="Define the data contract for BottleneckAnalysis."]
+// CIL[DOC-CONTEXT module="pages.admin.cil" layer="presentation" related_files=".framework/src/components/admin/PageInstructions.tsx,.framework/src/components/ui/alert.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/components/ui/tabs.tsx,.framework/src/lib/api.ts,.framework/src/pages/admin/cil/FlexiblePipelinePage.tsx"]
+// CIL[DOC-CONTRACT inputs="none (type definition)" outputs="typed contract for consumers" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Describes the bottleneck analysis result with bottlenecks, recommendations, and optimal processing order." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 interface BottleneckAnalysis {
   project_id: string
   bottlenecks: Array<{
@@ -164,89 +158,97 @@ interface BottleneckAnalysis {
     ready_for_processing: number
   }
 }
-
-
-// CIL[END chunk_id="flexiblepipelinepage_bottleneckanalysis_1784191730"]
-// CIL[BEGIN chunk_id="flexiblepipelinepage_step_labels_1784191730" type="constant" identity="STEP_LABELS" parent="none"]
-// CIL[DOC-MACRO purpose="Map pipeline step numbers to labels"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide human-readable labels for pipeline steps"]
-// CIL[DOC-CONTEXT module="cortex.pages.cil" layer="presentation" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="Record<number,string> step labels" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Defines a constant mapping step numbers to display labels" 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='TypeScript interface describing the shape of BottleneckAnalysis.'; 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/FlexiblePipelinePage.tsx:bottleneckanalysis:interface"]
+
+// CIL[BEGIN stable_id="~/.framework/src/pages/admin/cil/FlexiblePipelinePage.tsx:step_labels:constant" type="constant" identity="STEP_LABELS" parent="none"]
+// CIL[DOC-MACRO purpose="Named constant mapping used across the pipeline UI."]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide a lookup table for STEP_LABELS."]
+// CIL[DOC-CONTEXT module="pages.admin.cil" layer="presentation" related_files=".framework/src/components/admin/PageInstructions.tsx,.framework/src/components/ui/alert.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/components/ui/tabs.tsx,.framework/src/lib/api.ts,.framework/src/pages/admin/cil/FlexiblePipelinePage.tsx"]
+// CIL[DOC-CONTRACT inputs="none (static map)" outputs="named lookup record" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Maps each pipeline step index to a human-readable label." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 const STEP_LABELS: Record<number, string> = {
-  4: 'Chunk',
-  5: 'First-Pass Docs',
-  6: 'Embed (1st Pass)',
-  8: 'Second-Pass Docs',
+  0: 'Discover Files',
+  1: 'Select Files',
+  2: 'Chunk',
+  3: 'First-Pass Docs',
+  4: 'Validate Chunks',
+  5: 'Validate Docs',
+  6: 'Enrich',
+  7: 'Embed & Map',
+  8: 'Publish',
 }
-
-// CIL[END chunk_id="flexiblepipelinepage_step_labels_1784191730"]
-// CIL[BEGIN chunk_id="flexiblepipelinepage_step_colors_1784191730" type="constant" identity="STEP_COLORS" parent="none"]
-// CIL[DOC-MACRO purpose="Map pipeline step numbers to color classes"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide Tailwind color classes for pipeline steps"]
-// CIL[DOC-CONTEXT module="cortex.pages.cil" layer="presentation" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="Record<number,string> Tailwind classes" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Defines a constant mapping step numbers to Tailwind color classes" 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='Named constant mapping used across the pipeline UI.'; 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/FlexiblePipelinePage.tsx:step_labels:constant"]
+
+// CIL[BEGIN stable_id="~/.framework/src/pages/admin/cil/FlexiblePipelinePage.tsx:step_colors:constant" type="constant" identity="STEP_COLORS" parent="none"]
+// CIL[DOC-MACRO purpose="Named constant mapping used across the pipeline UI."]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide a lookup table for STEP_COLORS."]
+// CIL[DOC-CONTEXT module="pages.admin.cil" layer="presentation" related_files=".framework/src/components/admin/PageInstructions.tsx,.framework/src/components/ui/alert.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/components/ui/tabs.tsx,.framework/src/lib/api.ts,.framework/src/pages/admin/cil/FlexiblePipelinePage.tsx"]
+// CIL[DOC-CONTRACT inputs="none (static map)" outputs="named lookup record" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Maps each pipeline step index to a Tailwind color class string for badges and progress." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 const STEP_COLORS: Record<number, string> = {
-  4: 'bg-blue-100 text-blue-700',
-  5: 'bg-purple-100 text-purple-700',
-  6: 'bg-green-100 text-green-700',
+  0: 'bg-slate-100 text-slate-700',
+  1: 'bg-gray-100 text-gray-700',
+  2: 'bg-blue-100 text-blue-700',
+  3: 'bg-purple-100 text-purple-700',
+  4: 'bg-green-100 text-green-700',
+  5: 'bg-amber-100 text-amber-700',
+  6: 'bg-pink-100 text-pink-700',
+  7: 'bg-indigo-100 text-indigo-700',
   8: 'bg-violet-100 text-violet-700',
 }
-
-// CIL[END chunk_id="flexiblepipelinepage_step_colors_1784191730"]
-// CIL[BEGIN chunk_id="flexiblepipelinepage_priority_colors_1784191730" type="constant" identity="PRIORITY_COLORS" parent="none"]
-// CIL[DOC-MACRO purpose="Map priority levels to color classes"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide Tailwind color classes for priority levels"]
-// CIL[DOC-CONTEXT module="cortex.pages.cil" layer="presentation" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="Record<string,string> Tailwind classes" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Defines a constant mapping priority levels to Tailwind color classes" 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='Named constant mapping used across the pipeline UI.'; 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/FlexiblePipelinePage.tsx:step_colors:constant"]
+
+// CIL[BEGIN stable_id="~/.framework/src/pages/admin/cil/FlexiblePipelinePage.tsx:priority_colors:constant" type="constant" identity="PRIORITY_COLORS" parent="none"]
+// CIL[DOC-MACRO purpose="Named constant mapping used across the pipeline UI."]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide a lookup table for PRIORITY_COLORS."]
+// CIL[DOC-CONTEXT module="pages.admin.cil" layer="presentation" related_files=".framework/src/components/admin/PageInstructions.tsx,.framework/src/components/ui/alert.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/components/ui/tabs.tsx,.framework/src/lib/api.ts,.framework/src/pages/admin/cil/FlexiblePipelinePage.tsx"]
+// CIL[DOC-CONTRACT inputs="none (static map)" outputs="named lookup record" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Maps priority levels to Tailwind color class strings." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 const PRIORITY_COLORS: Record<string, string> = {
   high: 'bg-red-100 text-red-700',
   medium: 'bg-yellow-100 text-yellow-700',
   low: 'bg-gray-100 text-gray-700',
 }
-
-
-// CIL[END chunk_id="flexiblepipelinepage_priority_colors_1784191730"]
-// CIL[BEGIN chunk_id="flexiblepipelinepage_fileprogresscard_1784191730" type="function" identity="FileProgressCard" parent="none"]
-// CIL[DOC-MACRO purpose="Render a file progress card"]
-// CIL[DOC-RESPONSIBILITY responsibility="Display file status, progress, and the next actionable step"]
-// CIL[DOC-CONTEXT module="cortex.pages.cil" layer="presentation" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="JSX element" errors="none" side_effects="calls onProcess callback when user clicks process"]
-// CIL[DOC-MICRO logic_summary="Renders file badges, a progress bar, and a process button for the next step" 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='Named constant mapping used across the pipeline UI.'; 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/FlexiblePipelinePage.tsx:priority_colors:constant"]
+
+// CIL[BEGIN stable_id="~/.framework/src/pages/admin/cil/FlexiblePipelinePage.tsx:fileprogresscard:function" type="function" identity="FileProgressCard" parent="none"]
+// CIL[DOC-MACRO purpose="React/TypeScript function for rendering FileProgressCard."]
+// CIL[DOC-RESPONSIBILITY responsibility="Render the FileProgressCard UI and handle user interactions."]
+// CIL[DOC-CONTEXT module="pages.admin.cil" layer="presentation" related_files=".framework/src/components/admin/PageInstructions.tsx,.framework/src/components/ui/alert.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/components/ui/tabs.tsx,.framework/src/lib/api.ts,.framework/src/pages/admin/cil/FlexiblePipelinePage.tsx"]
+// CIL[DOC-CONTRACT inputs="file, onProcess" outputs="JSX element or fragment" errors="none" side_effects="emits callback to parent on user action"]
+// CIL[DOC-MICRO logic_summary="Shows a single file's progress, completed/ready/blocked steps, and a button to process the next available step." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function FileProgressCard({ file, onProcess }: { 
   file: FilePipelineState
   onProcess: (filePath: string, step: number) => void 
@@ -300,22 +302,22 @@ function FileProgressCard({ file, onProcess }: {
     </Card>
   )
 }
-
-// CIL[END chunk_id="flexiblepipelinepage_fileprogresscard_1784191730"]
-// CIL[BEGIN chunk_id="flexiblepipelinepage_stepsummarycard_1784191730" type="function" identity="StepSummaryCard" parent="none"]
-// CIL[DOC-MACRO purpose="Render a step summary card"]
-// CIL[DOC-RESPONSIBILITY responsibility="Display step completion metrics and a batch process button"]
-// CIL[DOC-CONTEXT module="cortex.pages.cil" layer="presentation" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="JSX element" errors="none" side_effects="calls onProcess callback when user clicks process"]
-// CIL[DOC-MICRO logic_summary="Renders step icon, label, progress bar, and a button to process pending files" 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='React/TypeScript function for rendering FileProgressCard.'; 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/FlexiblePipelinePage.tsx:fileprogresscard:function"]
+
+// CIL[BEGIN stable_id="~/.framework/src/pages/admin/cil/FlexiblePipelinePage.tsx:stepsummarycard:function" type="function" identity="StepSummaryCard" parent="none"]
+// CIL[DOC-MACRO purpose="React/TypeScript function for rendering StepSummaryCard."]
+// CIL[DOC-RESPONSIBILITY responsibility="Render the StepSummaryCard UI and handle user interactions."]
+// CIL[DOC-CONTEXT module="pages.admin.cil" layer="presentation" related_files=".framework/src/components/admin/PageInstructions.tsx,.framework/src/components/ui/alert.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/components/ui/tabs.tsx,.framework/src/lib/api.ts,.framework/src/pages/admin/cil/FlexiblePipelinePage.tsx"]
+// CIL[DOC-CONTRACT inputs="step, summary, onProcess" outputs="JSX element or fragment" errors="none" side_effects="emits callback to parent on user action"]
+// CIL[DOC-MICRO logic_summary="Renders a step summary with completion stats, a progress bar, and a button to process all ready files in that step." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function StepSummaryCard({ step, summary, onProcess }: {
   step: number
   summary: { completed: number; pending: number; in_progress: number }
@@ -361,22 +363,22 @@ function StepSummaryCard({ step, summary, onProcess }: {
     </Card>
   )
 }
-
-// CIL[END chunk_id="flexiblepipelinepage_stepsummarycard_1784191730"]
-// CIL[BEGIN chunk_id="flexiblepipelinepage_bottleneckalert_1784191730" type="function" identity="BottleneckAlert" parent="none"]
-// CIL[DOC-MACRO purpose="Render a bottleneck alert"]
-// CIL[DOC-RESPONSIBILITY responsibility="Display a bottleneck with blocking reasons and priority"]
-// CIL[DOC-CONTEXT module="cortex.pages.cil" layer="presentation" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="JSX element" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Renders an alert with step name, ready/blocked counts, blocking reasons, and a high-priority badge" 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='React/TypeScript function for rendering StepSummaryCard.'; 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/FlexiblePipelinePage.tsx:stepsummarycard:function"]
+
+// CIL[BEGIN stable_id="~/.framework/src/pages/admin/cil/FlexiblePipelinePage.tsx:bottleneckalert:function" type="function" identity="BottleneckAlert" parent="none"]
+// CIL[DOC-MACRO purpose="React/TypeScript function for rendering BottleneckAlert."]
+// CIL[DOC-RESPONSIBILITY responsibility="Render the BottleneckAlert UI and handle user interactions."]
+// CIL[DOC-CONTEXT module="pages.admin.cil" layer="presentation" related_files=".framework/src/components/admin/PageInstructions.tsx,.framework/src/components/ui/alert.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/components/ui/tabs.tsx,.framework/src/lib/api.ts,.framework/src/pages/admin/cil/FlexiblePipelinePage.tsx"]
+// CIL[DOC-CONTRACT inputs="bottleneck" outputs="JSX element or fragment" errors="none" side_effects="emits callback to parent on user action"]
+// CIL[DOC-MICRO logic_summary="Displays a bottleneck step with ready/blocked counts and a list of blocking reasons." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function BottleneckAlert({ bottleneck }: { bottleneck: BottleneckAnalysis['bottlenecks'][0] }) {
   return (
     <Alert className="mb-3">
@@ -407,22 +409,22 @@ function BottleneckAlert({ bottleneck }: { bottleneck: BottleneckAnalysis['bottl
     </Alert>
   )
 }
-
-// CIL[END chunk_id="flexiblepipelinepage_bottleneckalert_1784191730"]
-// CIL[BEGIN chunk_id="flexiblepipelinepage_recommendationcard_1784191730" type="function" identity="RecommendationCard" parent="none"]
-// CIL[DOC-MACRO purpose="Render a recommendation card"]
-// CIL[DOC-RESPONSIBILITY responsibility="Display a pipeline recommendation with its priority"]
-// CIL[DOC-CONTEXT module="cortex.pages.cil" layer="presentation" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="JSX element" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Renders a recommendation with step, action text, and a priority badge" 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='React/TypeScript function for rendering BottleneckAlert.'; 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/FlexiblePipelinePage.tsx:bottleneckalert:function"]
+
+// CIL[BEGIN stable_id="~/.framework/src/pages/admin/cil/FlexiblePipelinePage.tsx:recommendationcard:function" type="function" identity="RecommendationCard" parent="none"]
+// CIL[DOC-MACRO purpose="React/TypeScript function for rendering RecommendationCard."]
+// CIL[DOC-RESPONSIBILITY responsibility="Render the RecommendationCard UI and handle user interactions."]
+// CIL[DOC-CONTEXT module="pages.admin.cil" layer="presentation" related_files=".framework/src/components/admin/PageInstructions.tsx,.framework/src/components/ui/alert.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/components/ui/tabs.tsx,.framework/src/lib/api.ts,.framework/src/pages/admin/cil/FlexiblePipelinePage.tsx"]
+// CIL[DOC-CONTRACT inputs="recommendation" outputs="JSX element or fragment" errors="none" side_effects="emits callback to parent on user action"]
+// CIL[DOC-MICRO logic_summary="Renders a single recommendation with a priority badge." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function RecommendationCard({ recommendation }: { recommendation: BottleneckAnalysis['recommendations'][0] }) {
   return (
     <Card className="mb-2">
@@ -441,23 +443,22 @@ function RecommendationCard({ recommendation }: { recommendation: BottleneckAnal
     </Card>
   )
 }
-
-
-// CIL[END chunk_id="flexiblepipelinepage_recommendationcard_1784191730"]
-// CIL[BEGIN chunk_id="flexiblepipelinepage_flexiblepipelinepage_1784191730" type="function" identity="FlexiblePipelinePage" parent="none"]
-// CIL[DOC-MACRO purpose="Render the flexible pipeline dashboard"]
-// CIL[DOC-RESPONSIBILITY responsibility="Load pipeline status, ready files, and bottlenecks; render tabbed UI"]
-// CIL[DOC-CONTEXT module="cortex.pages.cil" layer="presentation" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="JSX element" errors="none" side_effects="fetches data via apiFetch, registers React effects, logs API errors"]
-// CIL[DOC-MICRO logic_summary="Loads pipeline status, per-step ready files, and bottlenecks; renders overview, files, steps, and bottlenecks tabs" 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='React/TypeScript function for rendering RecommendationCard.'; 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/FlexiblePipelinePage.tsx:recommendationcard:function"]
+
+// CIL[BEGIN stable_id="~/.framework/src/pages/admin/cil/FlexiblePipelinePage.tsx:flexiblepipelinepage:function" type="function" identity="FlexiblePipelinePage" parent="none"]
+// CIL[DOC-MACRO purpose="React/TypeScript function for rendering FlexiblePipelinePage."]
+// CIL[DOC-RESPONSIBILITY responsibility="Render the FlexiblePipelinePage UI and handle user interactions."]
+// CIL[DOC-CONTEXT module="pages.admin.cil" layer="presentation" related_files=".framework/src/components/admin/PageInstructions.tsx,.framework/src/components/ui/alert.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/components/ui/tabs.tsx,.framework/src/lib/api.ts,.framework/src/pages/admin/cil/FlexiblePipelinePage.tsx"]
+// CIL[DOC-CONTRACT inputs="none" outputs="JSX element or fragment" errors="none" side_effects="calls apiFetch and sets React state"]
+// CIL[DOC-MICRO logic_summary="Fetches pipeline status, files ready per step, and bottleneck analysis; renders tabbed dashboard with overview, files, steps, and bottlenecks." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export default function FlexiblePipelinePage() {
   const { id: projectId } = useParams<{ id: string }>()
   
@@ -475,8 +476,8 @@ export default function FlexiblePipelinePage() {
         method: 'POST',
         body: JSON.stringify({ project_id: projectId })
       })
-      const data = await response.json()
-      setPipelineStatus(data)
+      const result = await response.json()
+      setPipelineStatus(result.data ?? result)
     } catch (error) {
       console.error('Failed to load pipeline status:', error)
     }
@@ -485,7 +486,7 @@ export default function FlexiblePipelinePage() {
   const loadReadyFiles = useCallback(async () => {
     if (!projectId) return
     
-    const steps = [4, 5, 6, 8]
+    const steps = [0, 1, 2, 3, 4, 5, 6, 7, 8]
     const results: Record<number, FilesReadyForStep> = {}
     
     for (const step of steps) {
@@ -494,8 +495,8 @@ export default function FlexiblePipelinePage() {
           method: 'POST',
           body: JSON.stringify({ project_id: projectId, step, include_blocking_info: true })
         })
-        const data = await response.json()
-        results[step] = data
+        const result = await response.json()
+        results[step] = result.data ?? result
       } catch (error) {
         console.error(`Failed to load ready files for step ${step}:`, error)
       }
@@ -512,8 +513,8 @@ export default function FlexiblePipelinePage() {
         method: 'POST',
         body: JSON.stringify({ project_id: projectId })
       })
-      const data = await response.json()
-      setBottlenecks(data)
+      const result = await response.json()
+      setBottlenecks(result.data ?? result)
     } catch (error) {
       console.error('Failed to load bottlenecks:', error)
     }
@@ -536,7 +537,6 @@ export default function FlexiblePipelinePage() {
   const handleProcessFile = useCallback(async (filePath: string, step: number) => {
     console.log(`Processing ${filePath} for step ${step}`)
 
-
   }, [])
 
   const handleProcessStep = useCallback(async (step: number) => {
@@ -567,6 +567,10 @@ export default function FlexiblePipelinePage() {
     )
   }
 
+  const files = pipelineStatus.files || []
+  const stepSummary = pipelineStatus.step_summary || {}
+  const overallProgress = pipelineStatus.overall_progress ?? 0
+
   return (
     <div className="space-y-6">
       <div className="flex items-center justify-between">
@@ -592,7 +596,6 @@ export default function FlexiblePipelinePage() {
         ]}
       />
 
-      
       <Card>
         <CardHeader>
           <CardTitle className="flex items-center gap-2">
@@ -605,16 +608,16 @@ export default function FlexiblePipelinePage() {
             <div className="flex items-center justify-between">
               <span className="text-sm font-medium">Pipeline Completion</span>
               <Badge className="bg-green-100 text-green-700">
-                {Math.round(pipelineStatus.overall_progress)}%
+                {Math.round(overallProgress)}%
               </Badge>
             </div>
-            <Progress value={pipelineStatus.overall_progress} className="h-3" />
+            <Progress value={overallProgress} className="h-3" />
             <div className="flex items-center gap-4 text-sm text-muted-foreground">
-              <span>{pipelineStatus.files.length} files total</span>
+              <span>{files.length} files total</span>
               <span>•</span>
-              <span>{pipelineStatus.files.filter(f => f.progress_percentage === 100).length} complete</span>
+              <span>{files.filter(f => f.progress_percentage === 100).length} complete</span>
               <span>•</span>
-              <span>{pipelineStatus.files.filter(f => f.progress_percentage < 100).length} in progress</span>
+              <span>{files.filter(f => f.progress_percentage < 100).length} in progress</span>
             </div>
           </div>
         </CardContent>
@@ -628,10 +631,9 @@ export default function FlexiblePipelinePage() {
           <TabsTrigger value="bottlenecks">Bottlenecks</TabsTrigger>
         </TabsList>
 
-        
         <TabsContent value="overview" className="space-y-4">
           <div className="grid grid-cols-1 md:grid-cols-2 gap-4">
-            {Object.entries(pipelineStatus.step_summary).map(([step, summary]) => (
+            {Object.entries(stepSummary).map(([step, summary]) => (
               <StepSummaryCard
                 key={step}
                 step={parseInt(step)}
@@ -642,10 +644,9 @@ export default function FlexiblePipelinePage() {
           </div>
         </TabsContent>
 
-        
         <TabsContent value="files" className="space-y-4">
           <div className="space-y-2">
-            {pipelineStatus.files.map((file) => (
+            {files.map((file) => (
               <FileProgressCard
                 key={file.file_path}
                 file={file}
@@ -655,7 +656,6 @@ export default function FlexiblePipelinePage() {
           </div>
         </TabsContent>
 
-        
         <TabsContent value="steps" className="space-y-4">
           {Object.entries(readyFiles).map(([step, data]) => (
             <Card key={step}>
@@ -700,7 +700,6 @@ export default function FlexiblePipelinePage() {
           ))}
         </TabsContent>
 
-        
         <TabsContent value="bottlenecks" className="space-y-4">
           {bottlenecks?.bottlenecks.map((bottleneck) => (
             <BottleneckAlert key={bottleneck.step} bottleneck={bottleneck} />
@@ -728,4 +727,10 @@ export default function FlexiblePipelinePage() {
     </div>
   )
 }
-// CIL[END chunk_id="flexiblepipelinepage_flexiblepipelinepage_1784191730"]
+// CIL[DOC-VECTOR type="context" content="purpose='React/TypeScript function for rendering FlexiblePipelinePage.'; 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/FlexiblePipelinePage.tsx:flexiblepipelinepage:function"]