spine-framework 0.3.124 → 0.3.126

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

@@ -1,6 +1,23 @@
-/**
- * @module src/pages/admin/PipelineDetailPage
- */
+
+
+
+
+
+// CIL[BEGIN chunk_id="pipelinedetailpage_module_header_1783666257" type="module_header" identity="imports" parent="none"]
+// CIL[DOC-MACRO purpose="Import React dependencies and UI components"]
+// CIL[DOC-RESPONSIBILITY responsibility="Import all required modules for PipelineDetailPage component"]
+// CIL[DOC-CONTEXT module="PipelineDetailPage" layer="ui" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/src/components/ui/dialog.tsx\",\".framework/src/components/ui/table-primitives.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="React hooks, UI components, utilities" errors="Import errors" side_effects="Module loading"]
+// CIL[DOC-MICRO logic_summary="Imports React, router, UI components, icons, and utility functions" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-AUDIENCE audience="developer"]
+// CIL[DOC-VECTOR type="context" content="Layer: ui. Direct callers: 0. Direct calls: 0. Related files: custom/apps/portal/pages/ContentPage.tsx, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .framework/src/components/ui/dialog.tsx, .framework/src/components/ui/table-primitives.tsx, \."]
+// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
+// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
+// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 import { useState, useEffect } from 'react'
 import { useParams, useNavigate } from 'react-router-dom'
 import { apiFetch } from '../../lib/api'
@@ -16,23 +33,51 @@ import { Alert, AlertDescription, AlertTitle } from '../../components/ui/alert'
 import { Badge } from '../../components/ui/badge'
 import { ArrowLeft, Play, Pause, AlertCircle } from 'lucide-react'
 import { formatDateTime } from '../../lib/utils'
-
+import { PageInstructions } from '../../components/admin/PageInstructions'
+// CIL[END chunk_id="pipelinedetailpage_module_header_1783666257"]
+// CIL[BEGIN chunk_id="pipelinedetailpage_interface_pipeline_1783666257" type="interface" identity="Pipeline" parent="none"]
+// CIL[DOC-MACRO purpose="Define pipeline data structure"]
+// CIL[DOC-RESPONSIBILITY responsibility="Type definition for pipeline entities"]
+// CIL[DOC-CONTEXT module="PipelineDetailPage" layer="types" related_files="[\".framework/src/pages/admin/IntegrationsPage.tsx\",\".framework/functions/_shared/schema-utils.ts\",\".framework/functions/_shared/principal.ts\",\"custom/apps/cortex/functions/custom_cil-embeddings.ts\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="Pipeline interface" errors="Type errors" side_effects="Type system"]
+// CIL[DOC-MICRO logic_summary="Defines structure for pipeline configuration with steps and execution data" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-VECTOR type="context" content="Layer: types. Direct callers: 0. Direct calls: 0. Related files: .framework/src/pages/admin/IntegrationsPage.tsx, .framework/functions/_shared/schema-utils.ts, .framework/functions/_shared/principal.ts, custom/apps/cortex/functions/custom_cil-embeddings.ts, \."]
+// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
+// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
+// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 interface Pipeline {
   id: string
   name: string
   description?: string
-  status: 'draft' | 'active' | 'paused' | 'archived'
-  steps: Array<{ id: string; name: string; type: string; config: Record<string, any> }>
+  app_id?: string
   trigger_type: 'manual' | 'scheduled' | 'webhook' | 'event'
-  schedule?: string
+  stages?: Array<{ id: string; name: string; type: string; config: Record<string, any> }>
+  config?: Record<string, any>
+  metadata?: Record<string, any>
   is_active: boolean
-  last_run?: string
-  last_run_status?: 'success' | 'failed' | 'running'
-  run_count: number
+  is_system?: boolean
   created_at: string
   updated_at: string
 }
-
+// CIL[END chunk_id="pipelinedetailpage_interface_pipeline_1783666257"]
+// CIL[BEGIN chunk_id="pipelinedetailpage_constants_1783666257" type="constants" identity="STATUSES" parent="none"]
+// CIL[DOC-MACRO purpose="Define status and trigger type constants"]
+// CIL[DOC-RESPONSIBILITY responsibility="Configuration options for pipeline forms"]
+// CIL[DOC-CONTEXT module="PipelineDetailPage" layer="constants" related_files="[\".framework/src/pages/admin/RolesPage.tsx\",\"custom/apps/portal/pages/ContentPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/src/pages/admin/IntegrationsPage.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="status and trigger arrays" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Defines dropdown options for pipeline status and trigger types" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-VECTOR type="context" content="Layer: constants. Direct callers: 0. Direct calls: 0. Related files: .framework/src/pages/admin/RolesPage.tsx, custom/apps/portal/pages/ContentPage.tsx, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .framework/src/pages/admin/TypeDetailPage.tsx, .framework/src/pages/admin/IntegrationsPage.tsx, \."]
+// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
+// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
+// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 const STATUSES = [
   { value: 'draft', label: 'Draft' },
   { value: 'active', label: 'Active' },
@@ -46,7 +91,21 @@ const TRIGGER_TYPES = [
   { value: 'webhook', label: 'Webhook' },
   { value: 'event', label: 'Event' }
 ]
-
+// CIL[END chunk_id="pipelinedetailpage_constants_1783666257"]
+// CIL[BEGIN chunk_id="pipelinedetailpage_function_pipelinedetailpage_1783666257" type="function" identity="PipelineDetailPage" parent="none"]
+// CIL[DOC-MACRO purpose="Render the complete pipeline detail interface"]
+// CIL[DOC-RESPONSIBILITY responsibility="Main render logic for pipeline detail page"]
+// CIL[DOC-CONTEXT module="PipelineDetailPage" layer="ui" related_files="[\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/functions/_shared/schema-utils.ts\",\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/functions/_shared/principal.ts\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="JSX structure" errors="Render errors" side_effects="DOM updates"]
+// CIL[DOC-MICRO logic_summary="Renders loading states, error states, and pipeline form with all fields" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-VECTOR type="context" content="Layer: ui. Direct callers: 0. Direct calls: 0. Related files: custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .framework/src/pages/admin/TypeDetailPage.tsx, .framework/functions/_shared/schema-utils.ts, custom/apps/portal/pages/ContentPage.tsx, .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"]
 export function PipelineDetailPage() {
   const { id } = useParams<{ id: string }>()
   const navigate = useNavigate()
@@ -55,8 +114,31 @@ export function PipelineDetailPage() {
   const [loading, setLoading] = useState(true)
   const [error, setError] = useState<string | null>(null)
   const [isEditing, setIsEditing] = useState(isCreateMode)
-  const [formData, setFormData] = useState({ name: '', description: '', status: 'draft' as const, trigger_type: 'manual' as const, schedule: '', is_active: true, steps: [] as any[] })
+  const [formData, setFormData] = useState({
+    name: '',
+    description: '',
+    app_id: '',
+    trigger_type: 'manual' as const,
+    config: '{}',
+    stages: '[]',
+    metadata: '{}',
+    is_active: true
+  })
 
+  // CIL[BEGIN chunk_id="pipelinedetailpage_hooks_1783666257" type="hooks" identity="useEffect" parent="pipelinedetailpage_function_pipelinedetailpage_1783666257"]
+// CIL[DOC-MACRO purpose="Fetch pipeline data and manage form state"]
+// CIL[DOC-RESPONSIBILITY responsibility="Handle useEffect"]
+// CIL[DOC-CONTEXT module="useEffect" layer="unknown" related_files="[]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Implements useEffect" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-VECTOR type="context" content="Layer: unknown. Direct callers: 0. Direct calls: 0. Related files: none."]
+// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
+// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
+// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
   useEffect(() => {
     if (isCreateMode) {
       setLoading(false)
@@ -71,8 +153,14 @@ export function PipelineDetailPage() {
         const data = result.data
         setPipeline(data)
         setFormData({
-          name: data.name, description: data.description || '', status: data.status, trigger_type: data.trigger_type,
-          schedule: data.schedule || '', is_active: data.is_active, steps: data.steps || []
+          name: data.name,
+          description: data.description || '',
+          app_id: data.app_id || '',
+          trigger_type: data.trigger_type,
+          config: JSON.stringify(data.config || {}, null, 2),
+          stages: JSON.stringify(data.stages || [], null, 2),
+          metadata: JSON.stringify(data.metadata || {}, null, 2),
+          is_active: data.is_active ?? true
         })
       } catch (err) {
         setError(err instanceof Error ? err.message : 'Failed to load pipeline')
@@ -82,12 +170,45 @@ export function PipelineDetailPage() {
     }
     fetchPipeline()
   }, [id, isCreateMode])
+// CIL[END chunk_id="pipelinedetailpage_hooks_1783666257"]
 
+  // CIL[BEGIN chunk_id="pipelinedetailpage_handlers_1783666257" type="event_handlers" identity="handleSave" parent="pipelinedetailpage_function_pipelinedetailpage_1783666257"]
+// CIL[DOC-MACRO purpose="Handle form submission and pipeline status toggle"]
+// CIL[DOC-RESPONSIBILITY responsibility="Handle handleSave"]
+// CIL[DOC-CONTEXT module="handleSave" layer="unknown" related_files="[]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Implements handleSave" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-VECTOR type="context" content="Layer: unknown. Direct callers: 0. Direct calls: 0. Related files: none."]
+// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
+// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
+// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
   const handleSave = async () => {
     try {
+      let parsedConfig = {}
+      let parsedStages: any[] = []
+      let parsedMetadata = {}
+      try { parsedConfig = JSON.parse(formData.config) } catch (error) { console.warn('Invalid JSON in config:', error) }
+      try { parsedStages = JSON.parse(formData.stages) } catch (error) { console.warn('Invalid JSON in stages:', error) }
+      try { parsedMetadata = JSON.parse(formData.metadata) } catch (error) { console.warn('Invalid JSON in metadata:', error) }
+
+      const saveData = {
+        name: formData.name,
+        description: formData.description,
+        app_id: formData.app_id || null,
+        trigger_type: formData.trigger_type,
+        is_active: formData.is_active,
+        config: parsedConfig,
+        stages: parsedStages,
+        metadata: parsedMetadata
+      }
+
       const url = isCreateMode ? '/api/pipelines?action=create' : `/api/pipelines?action=update&id=${id}`
       const method = isCreateMode ? 'POST' : 'PATCH'
-      const response = await apiFetch(url, { method, headers: { 'Content-Type': 'application/json' }, body: JSON.stringify(formData) })
+      const response = await apiFetch(url, { method, headers: { 'Content-Type': 'application/json' }, body: JSON.stringify(saveData) })
       if (!response.ok) throw new Error('Failed to save')
       if (isCreateMode) {
         const result = await response.json()
@@ -100,16 +221,31 @@ export function PipelineDetailPage() {
 
   const toggleStatus = async () => {
     if (!pipeline) return
-    const newStatus = pipeline.status === 'active' ? 'paused' : 'active'
+    const newActive = !pipeline.is_active
     try {
-      const response = await apiFetch(`/api/pipelines?action=update&id=${id}`, { method: 'PATCH', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ status: newStatus }) })
+      const response = await apiFetch(`/api/pipelines?action=update&id=${id}`, { method: 'PATCH', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ is_active: newActive }) })
       if (!response.ok) throw new Error('Failed to update status')
-      setPipeline({ ...pipeline, status: newStatus })
+      setPipeline({ ...pipeline, is_active: newActive })
     } catch (err) {
       setError(err instanceof Error ? err.message : 'Failed to update status')
     }
   }
+// CIL[END chunk_id="pipelinedetailpage_handlers_1783666257"]
 
+  // CIL[BEGIN chunk_id="pipelinedetailpage_render_1783666257" type="render_logic" identity="return" parent="pipelinedetailpage_function_pipelinedetailpage_1783666257"]
+// CIL[DOC-MACRO purpose="Render the complete pipeline detail interface"]
+// CIL[DOC-RESPONSIBILITY responsibility="Handle return"]
+// CIL[DOC-CONTEXT module="return" layer="unknown" related_files="[]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Implements return" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-VECTOR type="context" content="Layer: unknown. Direct callers: 0. Direct calls: 0. Related files: none."]
+// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
+// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
+// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
   if (loading) return (
     <div className="space-y-6">
       <Skeleton className="h-8 w-48" />
@@ -128,12 +264,12 @@ export function PipelineDetailPage() {
           <Button variant="ghost" onClick={() => isCreateMode ? navigate('/spine-framework/admin/configs/pipelines') : navigate(-1)}><ArrowLeft className="h-5 w-5" /></Button>
           <div>
             <h1 className="text-2xl font-bold">{isCreateMode ? 'Create Pipeline' : pipeline?.name}</h1>
-            {pipeline && <Badge variant={pipeline.status === 'active' ? 'default' : pipeline.status === 'paused' ? 'secondary' : 'outline'}>{pipeline.status}</Badge>}
+            {pipeline && <Badge variant={pipeline.is_active ? 'default' : 'secondary'}>{pipeline.is_active ? 'Active' : 'Inactive'}</Badge>}
           </div>
         </div>
         <div className="flex gap-2">
-          {!isCreateMode && pipeline?.status !== 'archived' && (
-            <Button variant="outline" onClick={toggleStatus}>{pipeline?.status === 'active' ? <><Pause className="h-4 w-4 mr-2" />Pause</> : <><Play className="h-4 w-4 mr-2" />Activate</>}</Button>
+          {!isCreateMode && (
+            <Button variant="outline" onClick={toggleStatus}>{pipeline?.is_active ? <><Pause className="h-4 w-4 mr-2" />Pause</> : <><Play className="h-4 w-4 mr-2" />Activate</>}</Button>
           )}
           {isEditing ? (
             <><Button variant="outline" onClick={() => isCreateMode ? navigate(-1) : setIsEditing(false)}>Cancel</Button><Button onClick={handleSave}>{isCreateMode ? 'Create' : 'Save'}</Button></>
@@ -141,38 +277,72 @@ export function PipelineDetailPage() {
         </div>
       </div>
 
-      <Card><CardContent className="p-6">
+      <PageInstructions
+        description="Configure a pipeline with trigger type, JSON stages, config, and metadata."
+        sections={[
+          { title: 'What this pipeline controls', content: 'A pipeline is a multi-step workflow that can be triggered manually, on a schedule, by a webhook, or by an event. This page controls the pipeline metadata, trigger type, and the JSON stages/config that the runner executes.' },
+          { title: 'Fields explained', content: <ul className="list-disc pl-4 space-y-1">
+            <li><strong>Name</strong> — string. The display name. Missing name prevents saving.</li>
+            <li><strong>Trigger Type</strong> — select. manual, scheduled, webhook, or event. Determines what causes a run.</li>
+            <li><strong>Active</strong> — checkbox. Inactive pipelines will not run regardless of trigger.</li>
+            <li><strong>App ID</strong> — string. Optional owning app UUID. Leave blank to make it account-scoped.</li>
+            <li><strong>Description</strong> — string. Optional human-readable notes.</li>
+            <li><strong>Config (JSON)</strong> — JSON. Free-form runtime configuration for the pipeline.</li>
+            <li><strong>Stages (JSON)</strong> — JSON. Required array of step definitions the runner executes.</li>
+            <li><strong>Metadata (JSON)</strong> — JSON. Optional metadata about the pipeline.</li>
+          </ul> },
+          { title: 'Options and values', content: <ul className="list-disc pl-4 space-y-1">
+            <li><strong>Trigger Type</strong>: <em>manual</em> run by button; <em>scheduled</em> is invoked by a timer; <em>webhook</em> waits for an HTTP call; <em>event</em> waits for a Spine trigger event.</li>
+          </ul> },
+          { title: 'Downstream impact', content: <ul className="list-disc pl-4 space-y-1">
+            <li>The runner uses the stages array to execute steps in order.</li>
+            <li>Triggers and timers reference pipelines by ID; changing the trigger type may require re-linking triggers or timers.</li>
+          </ul> },
+          { title: 'How to create, save, and validate', content: <ol className="list-decimal pl-4 space-y-1">
+            <li>In create mode, enter a name and choose a trigger type. Fill in the Stages JSON array.</li>
+            <li>Paste valid JSON into the Config and Metadata textareas. Invalid JSON will be ignored on save.</li>
+            <li>Click Create to save, or Edit then Save for existing pipelines. Use the Activate/Pause button to toggle is_active.</li>
+          </ol> },
+          { title: 'Common mistakes', content: <ul className="list-disc pl-4 space-y-1">
+            <li>Setting trigger type to scheduled but not linking a timer.</li>
+            <li>Pasting a non-array value into Stages (it must be a JSON array).</li>
+            <li>Expecting to edit step order here; the JSON stages field is the source of truth.</li>
+          </ul> },
+        ]}
+      />
+
+      <Card><CardContent className="p-6 space-y-6">
         <div className="grid grid-cols-1 md:grid-cols-2 gap-6">
           <div className="space-y-4">
             <h3 className="text-sm font-medium text-muted-foreground">Configuration</h3>
             <div className="space-y-2"><Label>Name</Label>{isEditing ? <Input value={formData.name} onChange={e => setFormData({...formData, name: e.target.value})} /> : <div className="text-sm">{pipeline?.name}</div>}</div>
-            <div className="space-y-2"><Label>Status</Label>{isEditing ? <Select value={formData.status} onValueChange={v => setFormData({...formData, status: v as any})}><SelectTrigger><SelectValue /></SelectTrigger><SelectContent>{STATUSES.map(s => <SelectItem key={s.value} value={s.value}>{s.label}</SelectItem>)}</SelectContent></Select> : <Badge>{pipeline?.status}</Badge>}</div>
+            <div className="space-y-2"><Label>App ID</Label>{isEditing ? <Input value={formData.app_id} onChange={e => setFormData({...formData, app_id: e.target.value})} placeholder="Optional app UUID" /> : <div className="text-sm font-mono">{pipeline?.app_id || '—'}</div>}</div>
             <div className="space-y-2"><Label>Trigger Type</Label>{isEditing ? <Select value={formData.trigger_type} onValueChange={v => setFormData({...formData, trigger_type: v as any})}><SelectTrigger><SelectValue /></SelectTrigger><SelectContent>{TRIGGER_TYPES.map(t => <SelectItem key={t.value} value={t.value}>{t.label}</SelectItem>)}</SelectContent></Select> : <div className="text-sm">{pipeline?.trigger_type}</div>}</div>
-            {formData.trigger_type === 'scheduled' && <div className="space-y-2"><Label>Schedule (cron)</Label>{isEditing ? <Input value={formData.schedule} onChange={e => setFormData({...formData, schedule: e.target.value})} placeholder="0 0 * * *" /> : <div className="text-sm font-mono">{pipeline?.schedule || '—'}</div>}</div>}
             <div className="space-y-2"><Label>Active</Label>{isEditing ? <div className="flex items-center gap-2"><Checkbox id="active" checked={formData.is_active} onCheckedChange={c => setFormData({...formData, is_active: c === true})} /><Label htmlFor="active">Enabled</Label></div> : <div className="text-sm">{pipeline?.is_active ? 'Yes' : 'No'}</div>}</div>
           </div>
           <div className="space-y-4">
             <h3 className="text-sm font-medium text-muted-foreground">Execution Info</h3>
             {!isCreateMode && (
               <>
-                <div className="flex justify-between"><span className="text-sm text-muted-foreground">Last Run</span><span className="text-sm">{pipeline?.last_run ? formatDateTime(pipeline.last_run) : '—'}</span></div>
-                <div className="flex justify-between"><span className="text-sm text-muted-foreground">Last Status</span><Badge variant={pipeline?.last_run_status === 'success' ? 'default' : pipeline?.last_run_status === 'failed' ? 'destructive' : 'outline'}>{pipeline?.last_run_status || '—'}</Badge></div>
-                <div className="flex justify-between"><span className="text-sm text-muted-foreground">Total Runs</span><span className="text-sm">{pipeline?.run_count || 0}</span></div>
-                <div className="flex justify-between"><span className="text-sm text-muted-foreground">Steps</span><span className="text-sm">{pipeline?.steps?.length || 0}</span></div>
+                <div className="flex justify-between"><span className="text-sm text-muted-foreground">Active</span><Badge variant={pipeline?.is_active ? 'default' : 'secondary'}>{pipeline?.is_active ? 'Active' : 'Inactive'}</Badge></div>
+                <div className="flex justify-between"><span className="text-sm text-muted-foreground">Stages</span><span className="text-sm">{pipeline?.stages?.length || 0}</span></div>
               </>
             )}
           </div>
         </div>
         <div className="mt-6 space-y-2"><Label>Description</Label>{isEditing ? <Textarea value={formData.description} onChange={e => setFormData({...formData, description: e.target.value})} rows={3} /> : <div className="text-sm">{pipeline?.description || '—'}</div>}</div>
+        <div className="space-y-2"><Label>Config (JSON)</Label>{isEditing ? <Textarea value={formData.config} onChange={e => setFormData({...formData, config: e.target.value})} className="font-mono text-sm" rows={4} placeholder="{}" /> : <pre className="text-xs bg-muted p-3 rounded border overflow-auto max-h-48">{JSON.stringify(pipeline?.config || {}, null, 2)}</pre>}</div>
+        <div className="space-y-2"><Label>Stages (JSON)</Label>{isEditing ? <Textarea value={formData.stages} onChange={e => setFormData({...formData, stages: e.target.value})} className="font-mono text-sm" rows={6} placeholder="[]" /> : <pre className="text-xs bg-muted p-3 rounded border overflow-auto max-h-48">{JSON.stringify(pipeline?.stages || [], null, 2)}</pre>}</div>
+        <div className="space-y-2"><Label>Metadata (JSON)</Label>{isEditing ? <Textarea value={formData.metadata} onChange={e => setFormData({...formData, metadata: e.target.value})} className="font-mono text-sm" rows={4} placeholder="{}" /> : <pre className="text-xs bg-muted p-3 rounded border overflow-auto max-h-48">{JSON.stringify(pipeline?.metadata || {}, null, 2)}</pre>}</div>
       </CardContent></Card>
 
-      {!isCreateMode && pipeline?.steps && (
-        <Card><CardHeader><CardTitle>Steps ({pipeline.steps.length})</CardTitle></CardHeader><CardContent>
+      {!isCreateMode && pipeline?.stages && (
+        <Card><CardHeader><CardTitle>Stages ({pipeline.stages.length})</CardTitle></CardHeader><CardContent>
           <div className="space-y-2">
-            {pipeline.steps.map((step, idx) => (
-              <div key={step.id} className="flex items-center gap-4 p-3 bg-muted rounded">
+            {pipeline.stages.map((stage, idx) => (
+              <div key={stage.id || idx} className="flex items-center gap-4 p-3 bg-muted rounded">
                 <div className="flex h-8 w-8 items-center justify-center rounded-full bg-primary text-primary-foreground text-sm font-medium">{idx + 1}</div>
-                <div className="flex-1"><div className="font-medium">{step.name}</div><div className="text-sm text-muted-foreground">{step.type}</div></div>
+                <div className="flex-1"><div className="font-medium">{stage.name}</div><div className="text-sm text-muted-foreground">{stage.type}</div></div>
               </div>
             ))}
           </div>
@@ -181,3 +351,5 @@ export function PipelineDetailPage() {
     </div>
   )
 }
+// CIL[END chunk_id="pipelinedetailpage_render_1783666257"]
+// CIL[END chunk_id="pipelinedetailpage_function_pipelinedetailpage_1783666257"]

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

@@ -1,19 +1,23 @@
-/**
- * @module src/pages/admin/PipelineExecutionsPage
- * @audience installer
- * @layer frontend-page
- * @stability stable
- *
- * Read-only log of pipeline execution history. Fetches execution records
- * via `/api/pipelines?action=executions`, applies client-side search,
- * status filter (`running` | `success` | `failed` | `cancelled`), and
- * sort. Renders inside `AdminListPage` with a sortable table showing
- * pipeline name, status, duration, and timestamps.
- *
- * @seeAlso src/pages/admin/PipelinesPage.tsx
- * @seeAlso src/pages/admin/ObservabilityDashboard.tsx
- */
 
+
+
+
+
+// CIL[BEGIN chunk_id="pipelineexecutionspage_module_header_1783666257" type="module_header" identity="imports" parent="none"]
+// CIL[DOC-MACRO purpose="Import React dependencies and UI components"]
+// CIL[DOC-RESPONSIBILITY responsibility="Import all required modules for PipelineExecutionsPage component"]
+// CIL[DOC-CONTEXT module="PipelineExecutionsPage" layer="ui" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/src/components/ui/dialog.tsx\",\".framework/src/components/ui/table-primitives.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="React hooks, UI components, utilities" errors="Import errors" side_effects="Module loading"]
+// CIL[DOC-MICRO logic_summary="Imports React, icons, UI components, and utility functions" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-AUDIENCE audience="developer"]
+// CIL[DOC-VECTOR type="context" content="Layer: ui. Direct callers: 0. Direct calls: 0. Related files: custom/apps/portal/pages/ContentPage.tsx, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .framework/src/components/ui/dialog.tsx, .framework/src/components/ui/table-primitives.tsx, \."]
+// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
+// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
+// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 import React, { useState } from 'react'
 import { Play, CheckCircle, XCircle, Clock, RefreshCw, Zap } from 'lucide-react';
 import { LoadingSpinner } from '../../components/ui/LoadingSpinner'
@@ -23,7 +27,21 @@ import { SortableTableHeader } from '../../components/admin/SortableTableHeader'
 import { formatDateTime } from '../../lib/utils'
 import { useApi } from '../../hooks/useApi'
 import { apiFetch } from '../../lib/api'
-
+// CIL[END chunk_id="pipelineexecutionspage_module_header_1783666257"]
+// CIL[BEGIN chunk_id="pipelineexecutionspage_interface_pipelineexecution_1783666257" type="interface" identity="PipelineExecution" parent="none"]
+// CIL[DOC-MACRO purpose="Define pipeline execution data structure"]
+// CIL[DOC-RESPONSIBILITY responsibility="Type definition for pipeline execution records"]
+// CIL[DOC-CONTEXT module="PipelineExecutionsPage" layer="types" related_files="[\".framework/src/pages/admin/IntegrationsPage.tsx\",\".framework/functions/_shared/schema-utils.ts\",\".framework/functions/_shared/principal.ts\",\"custom/apps/cortex/functions/custom_cil-embeddings.ts\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="PipelineExecution interface" errors="Type errors" side_effects="Type system"]
+// CIL[DOC-MICRO logic_summary="Defines structure for pipeline execution tracking with status and metadata" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-VECTOR type="context" content="Layer: types. Direct callers: 0. Direct calls: 0. Related files: .framework/src/pages/admin/IntegrationsPage.tsx, .framework/functions/_shared/schema-utils.ts, .framework/functions/_shared/principal.ts, custom/apps/cortex/functions/custom_cil-embeddings.ts, \."]
+// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
+// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
+// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 interface PipelineExecution {
   id: string
   pipeline_id: string
@@ -47,7 +65,21 @@ interface PipelineExecution {
   }
   created_at: string
 }
-
+// CIL[END chunk_id="pipelineexecutionspage_interface_pipelineexecution_1783666257"]
+// CIL[BEGIN chunk_id="pipelineexecutionspage_function_pipelineexecutionspage_1783666257" type="function" identity="PipelineExecutionsPage" parent="none"]
+// CIL[DOC-MACRO purpose="Main PipelineExecutionsPage component function"]
+// CIL[DOC-RESPONSIBILITY responsibility="Render pipeline execution monitoring interface"]
+// CIL[DOC-CONTEXT module="PipelineExecutionsPage" layer="ui" related_files="[\".framework/src/components/ui/dialog.tsx\",\".framework/src/components/ui/table-primitives.tsx\",\"custom/apps/cortex/functions/custom_cil-embeddings.ts\",\"custom/apps/portal/pages/ContentPage.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="JSX element" errors="Render errors" side_effects="API calls, navigation"]
+// CIL[DOC-MICRO logic_summary="Main component that displays pipeline executions with filtering and sorting" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-VECTOR type="context" content="Layer: ui. Direct callers: 0. Direct calls: 0. Related files: .framework/src/components/ui/dialog.tsx, .framework/src/components/ui/table-primitives.tsx, custom/apps/cortex/functions/custom_cil-embeddings.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"]
 export function PipelineExecutionsPage() {
   const [searchTerm, setSearchTerm] = useState('')
   const [selectedStatus, setSelectedStatus] = useState('all')
@@ -277,3 +309,4 @@ export function PipelineExecutionsPage() {
     </AdminListPage>
   )
 }
+// CIL[END chunk_id="pipelineexecutionspage_function_pipelineexecutionspage_1783666257"]