spine-framework 0.3.145 → 0.4.0

package/.framework/functions/cil-pipeline.ts

@@ -1,45 +1,130 @@
+// CIL[BEGIN stable_id="~/.framework/functions/cil-pipeline.ts:module_header:module_header" type="module_header" identity="module_header" parent="~/.framework/functions/cil-pipeline.ts"]
+// CIL[DOC-MACRO purpose="Module header and imports for the pipeline function"]
+// CIL[DOC-RESPONSIBILITY responsibility="Expose the function imports and mark the module entry point"]
+// CIL[DOC-CONTEXT module="functions" layer="infrastructure" related_files=".framework/functions/_shared/cil.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/middleware.ts"]
+// CIL[DOC-CONTRACT inputs="None" outputs="None" errors="None" side_effects="None"]
+// CIL[DOC-MICRO logic_summary="Import shared middleware, database client, and CIL helpers" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-AUDIENCE audience="engineers"]
+
 import { createHandler } from './_shared/middleware'
 import { adminDb } from './_shared/db'
+import { pipelineRank } from './_shared/cil'
+// CIL[DOC-VECTOR type="context" content="purpose='Module header and imports for the pipeline function'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/cil.ts"]
+// 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/functions/cil-pipeline.ts:module_header:module_header"]
+
 
+// CIL[BEGIN stable_id="~/.framework/functions/cil-pipeline.ts:PIPELINE_STEPS:constant" type="constant" identity="PIPELINE_STEPS" parent="~/.framework/functions/cil-pipeline.ts"]
+// CIL[DOC-MACRO purpose="Define the PIPELINE_STEPS constant"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide the PIPELINE_STEPS constant for the CIL pipeline"]
+// CIL[DOC-CONTEXT module="cil-pipeline" layer="domain" related_files=".framework/functions/_shared/cil.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/middleware.ts,.framework/functions/cil-pipeline.ts"]
+// CIL[DOC-CONTRACT inputs="None" outputs="PIPELINE_STEPS constant definition" errors="None" side_effects="None"]
+// CIL[DOC-MICRO logic_summary="Implements the PIPELINE_STEPS constant" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 const PIPELINE_STEPS = {
-  4: { name: 'chunk', prerequisites: [], target_status: '4-chunked' },
-  5: { name: 'document', prerequisites: [4], target_status: '5-documented' },
-  6: { name: 'embed-1st-pass', prerequisites: [5], target_status: '6-embedded' },
-  7: { name: 'map-1st-pass', prerequisites: [6], target_status: '7-mapped' },
-  8: { name: 'enrich', prerequisites: [7], target_status: '8-enriched' },
-  9: { name: 'embed-2nd-pass', prerequisites: [8], target_status: '9-embedded' },
-  10: { name: 'map-2nd-pass', prerequisites: [9], target_status: '10-mapped' },
+  0: { name: 'discover', prerequisites: [], target_status: '0-discovered' },
+  1: { name: 'select', prerequisites: [0], target_status: '1-selected' },
+  2: { name: 'chunk', prerequisites: [1], target_status: '2-chunked' },
+  3: { name: 'document', prerequisites: [2], target_status: '3-documented' },
+  4: { name: 'validate-chunks', prerequisites: [3], target_status: '4-chunk-validated' },
+  5: { name: 'validate-docs', prerequisites: [4], target_status: '5-doc-validated' },
+  6: { name: 'enrich', prerequisites: [5], target_status: '6-enriched' },
+  7: { name: 'embed-and-map', prerequisites: [6], target_status: '7-embedded-mapped' },
+  8: { name: 'publish', prerequisites: [7], target_status: '8-published' },
 } as const
+// CIL[DOC-VECTOR type="context" content="purpose='Define the PIPELINE_STEPS constant'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/cil.ts"]
+// 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/functions/cil-pipeline.ts:PIPELINE_STEPS:constant"]
+
 
+  // CIL[DOC-STABILITY stability="internal"]
+  // CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+  // CIL[DOC-CONTEXT module="unknown" layer="unknown" related_files=".framework/functions/_shared/cil.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/middleware.ts,.framework/functions/cil-pipeline.ts"]
+// CIL[BEGIN stable_id="~/.framework/functions/cil-pipeline.ts:PipelineStep:type" type="type" identity="PipelineStep" parent="~/.framework/functions/cil-pipeline.ts"]
+// CIL[DOC-MACRO purpose="Define the PipelineStep type"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide the PipelineStep type for the CIL pipeline"]
+// CIL[DOC-CONTEXT module="cil-pipeline" layer="domain" related_files=".framework/functions/_shared/cil.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/middleware.ts,.framework/functions/cil-pipeline.ts"]
+// CIL[DOC-CONTRACT inputs="None" outputs="PipelineStep type definition" errors="None" side_effects="None"]
+// CIL[DOC-MICRO logic_summary="Implements the PipelineStep type" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 type PipelineStep = keyof typeof PIPELINE_STEPS
+// CIL[DOC-VECTOR type="context" content="purpose='Define the PipelineStep type'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/cil.ts"]
+// 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/functions/cil-pipeline.ts:PipelineStep:type"]
 
+
+// CIL[BEGIN stable_id="~/.framework/functions/cil-pipeline.ts:getProject:function" type="function" identity="getProject" parent="~/.framework/functions/cil-pipeline.ts"]
+// CIL[DOC-MACRO purpose="Define the getProject function"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide the getProject function for the CIL pipeline"]
+// CIL[DOC-CONTEXT module="cil-pipeline" layer="domain" related_files=".framework/functions/_shared/cil.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/middleware.ts,.framework/functions/cil-pipeline.ts"]
+// CIL[DOC-CONTRACT inputs="project_id: string" outputs="See implementation" errors="May throw on invalid inputs or missing data" side_effects="May query or update project records"]
+// CIL[DOC-MICRO logic_summary="Implements the getProject function" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 async function getProject(project_id: string) {
   const { data: project } = await adminDb.from('items').select('data')
     .eq('id', project_id).maybeSingle()
   if (!project) throw new Error(`Project not found: ${project_id}`)
   return project
 }
+// CIL[DOC-VECTOR type="context" content="purpose='Define the getProject function'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/cil.ts"]
+// 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/functions/cil-pipeline.ts:getProject:function"]
+
 
+// CIL[BEGIN stable_id="~/.framework/functions/cil-pipeline.ts:getCompletedSteps:function" type="function" identity="getCompletedSteps" parent="~/.framework/functions/cil-pipeline.ts"]
+// CIL[DOC-MACRO purpose="Define the getCompletedSteps function"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide the getCompletedSteps function for the CIL pipeline"]
+// CIL[DOC-CONTEXT module="cil-pipeline" layer="domain" related_files=".framework/functions/_shared/cil.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/middleware.ts,.framework/functions/cil-pipeline.ts"]
+// CIL[DOC-CONTRACT inputs="status: string" outputs="See implementation" errors="May throw on invalid inputs or missing data" side_effects="May query or update project records"]
+// CIL[DOC-MICRO logic_summary="Implements the getCompletedSteps function" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function getCompletedSteps(status: string): PipelineStep[] {
-  const stepMap: Record<string, PipelineStep> = {
-    '4-chunked': 4,
-    '5-documented': 5,
-    '6-embedded': 6,
-    '7-mapped': 7,
-    '7.5-selected': 7,
-    '8-enriched': 8,
-    '9-embedded': 9,
-    '10-mapped': 10,
-  }
+  const rank = pipelineRank(status)
   const completed: PipelineStep[] = []
-  for (const [statusName, stepNum] of Object.entries(stepMap)) {
-    if (status === statusName) {
-      completed.push(stepNum)
-    }
+  for (const step of Object.keys(PIPELINE_STEPS) as PipelineStep[]) {
+    if (Number(step) <= rank) completed.push(step)
   }
   return completed
 }
+// CIL[DOC-VECTOR type="context" content="purpose='Define the getCompletedSteps function'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/cil.ts"]
+// 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/functions/cil-pipeline.ts:getCompletedSteps:function"]
 
+
+// CIL[BEGIN stable_id="~/.framework/functions/cil-pipeline.ts:getReadySteps:function" type="function" identity="getReadySteps" parent="~/.framework/functions/cil-pipeline.ts"]
+// CIL[DOC-MACRO purpose="Define the getReadySteps function"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide the getReadySteps function for the CIL pipeline"]
+// CIL[DOC-CONTEXT module="cil-pipeline" layer="domain" related_files=".framework/functions/_shared/cil.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/middleware.ts,.framework/functions/cil-pipeline.ts"]
+// CIL[DOC-CONTRACT inputs="status: string" outputs="See implementation" errors="May throw on invalid inputs or missing data" side_effects="May query or update project records"]
+// CIL[DOC-MICRO logic_summary="Implements the getReadySteps function" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function getReadySteps(status: string): PipelineStep[] {
   const completed = getCompletedSteps(status)
   const ready: PipelineStep[] = []
@@ -51,7 +136,26 @@ function getReadySteps(status: string): PipelineStep[] {
   }
   return ready
 }
+// CIL[DOC-VECTOR type="context" content="purpose='Define the getReadySteps function'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/cil.ts"]
+// 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/functions/cil-pipeline.ts:getReadySteps:function"]
+
+  // CIL[DOC-STABILITY stability="internal"]
+  // CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+  // CIL[DOC-CONTEXT module="unknown" layer="unknown" related_files=".framework/functions/_shared/cil.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/middleware.ts,.framework/functions/cil-pipeline.ts"]
 
+// CIL[BEGIN stable_id="~/.framework/functions/cil-pipeline.ts:getBlockedSteps:function" type="function" identity="getBlockedSteps" parent="~/.framework/functions/cil-pipeline.ts"]
+// CIL[DOC-MACRO purpose="Define the getBlockedSteps function"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide the getBlockedSteps function for the CIL pipeline"]
+// CIL[DOC-CONTEXT module="cil-pipeline" layer="domain" related_files=".framework/functions/_shared/cil.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/middleware.ts,.framework/functions/cil-pipeline.ts"]
+// CIL[DOC-CONTRACT inputs="status: string" outputs="See implementation" errors="May throw on invalid inputs or missing data" side_effects="May query or update project records"]
+// CIL[DOC-MICRO logic_summary="Implements the getBlockedSteps function" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function getBlockedSteps(status: string): PipelineStep[] {
   const completed = getCompletedSteps(status)
   const blocked: PipelineStep[] = []
@@ -63,13 +167,45 @@ function getBlockedSteps(status: string): PipelineStep[] {
   }
   return blocked
 }
+// CIL[DOC-VECTOR type="context" content="purpose='Define the getBlockedSteps function'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/cil.ts"]
+// 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/functions/cil-pipeline.ts:getBlockedSteps:function"]
 
+
+// CIL[BEGIN stable_id="~/.framework/functions/cil-pipeline.ts:calculateProgress:function" type="function" identity="calculateProgress" parent="~/.framework/functions/cil-pipeline.ts"]
+// CIL[DOC-MACRO purpose="Define the calculateProgress function"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide the calculateProgress function for the CIL pipeline"]
+// CIL[DOC-CONTEXT module="cil-pipeline" layer="domain" related_files=".framework/functions/_shared/cil.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/middleware.ts,.framework/functions/cil-pipeline.ts"]
+// CIL[DOC-CONTRACT inputs="status: string" outputs="See implementation" errors="May throw on invalid inputs or missing data" side_effects="May query or update project records"]
+// CIL[DOC-MICRO logic_summary="Implements the calculateProgress function" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function calculateProgress(status: string): number {
   const completed = getCompletedSteps(status)
   const totalSteps = Object.keys(PIPELINE_STEPS).length
   return (completed.length / totalSteps) * 100
 }
+// CIL[DOC-VECTOR type="context" content="purpose='Define the calculateProgress function'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/cil.ts"]
+// 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/functions/cil-pipeline.ts:calculateProgress:function"]
+
 
+// CIL[BEGIN stable_id="~/.framework/functions/cil-pipeline.ts:getBlockingReasons:function" type="function" identity="getBlockingReasons" parent="~/.framework/functions/cil-pipeline.ts"]
+// CIL[DOC-MACRO purpose="Define the getBlockingReasons function"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide the getBlockingReasons function for the CIL pipeline"]
+// CIL[DOC-CONTEXT module="cil-pipeline" layer="domain" related_files=".framework/functions/_shared/cil.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/middleware.ts,.framework/functions/cil-pipeline.ts"]
+// CIL[DOC-CONTRACT inputs="status: string, step: PipelineStep" outputs="See implementation" errors="May throw on invalid inputs or missing data" side_effects="May query or update project records"]
+// CIL[DOC-MICRO logic_summary="Implements the getBlockingReasons function" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function getBlockingReasons(status: string, step: PipelineStep): string[] {
   const completed = getCompletedSteps(status)
   const reasons: string[] = []
@@ -80,7 +216,23 @@ function getBlockingReasons(status: string, step: PipelineStep): string[] {
   }
   return reasons
 }
+// CIL[DOC-VECTOR type="context" content="purpose='Define the getBlockingReasons function'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/cil.ts"]
+// 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/functions/cil-pipeline.ts:getBlockingReasons:function"]
+
 
+// CIL[BEGIN stable_id="~/.framework/functions/cil-pipeline.ts:getStepBlockingReasons:function" type="function" identity="getStepBlockingReasons" parent="~/.framework/functions/cil-pipeline.ts"]
+// CIL[DOC-MACRO purpose="Define the getStepBlockingReasons function"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide the getStepBlockingReasons function for the CIL pipeline"]
+// CIL[DOC-CONTEXT module="cil-pipeline" layer="domain" related_files=".framework/functions/_shared/cil.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/middleware.ts,.framework/functions/cil-pipeline.ts"]
+// CIL[DOC-CONTRACT inputs="files: Array<[string, string]>, step: PipelineStep" outputs="See implementation" errors="May throw on invalid inputs or missing data" side_effects="May query or update project records"]
+// CIL[DOC-MICRO logic_summary="Implements the getStepBlockingReasons function" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function getStepBlockingReasons(files: Array<[string, string]>, step: PipelineStep): string[] {
   const blockingReasons: string[] = []
   for (const [file_path, status] of files) {
@@ -95,7 +247,23 @@ function getStepBlockingReasons(files: Array<[string, string]>, step: PipelineSt
   }
   return [...new Set(blockingReasons)]
 }
+// CIL[DOC-VECTOR type="context" content="purpose='Define the getStepBlockingReasons function'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/cil.ts"]
+// 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/functions/cil-pipeline.ts:getStepBlockingReasons:function"]
 
+
+// CIL[BEGIN stable_id="~/.framework/functions/cil-pipeline.ts:getOptimalProcessingOrder:function" type="function" identity="getOptimalProcessingOrder" parent="~/.framework/functions/cil-pipeline.ts"]
+// CIL[DOC-MACRO purpose="Define the getOptimalProcessingOrder function"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide the getOptimalProcessingOrder function for the CIL pipeline"]
+// CIL[DOC-CONTEXT module="cil-pipeline" layer="domain" related_files=".framework/functions/_shared/cil.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/middleware.ts,.framework/functions/cil-pipeline.ts"]
+// CIL[DOC-CONTRACT inputs="files: Array<[string, string]>" outputs="See implementation" errors="May throw on invalid inputs or missing data" side_effects="May query or update project records"]
+// CIL[DOC-MICRO logic_summary="Implements the getOptimalProcessingOrder function" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function getOptimalProcessingOrder(files: Array<[string, string]>): Array<{file_path: string, suggested_next_step: PipelineStep | null}> {
   const fileStates = files.map(([file_path, status]) => ({
     file_path,
@@ -115,7 +283,23 @@ function getOptimalProcessingOrder(files: Array<[string, string]>): Array<{file_
       suggested_next_step: ready_for[0] || null
     }))
 }
+// CIL[DOC-VECTOR type="context" content="purpose='Define the getOptimalProcessingOrder function'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/cil.ts"]
+// 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/functions/cil-pipeline.ts:getOptimalProcessingOrder:function"]
+
 
+// CIL[BEGIN stable_id="~/.framework/functions/cil-pipeline.ts:getPipelineStatus:function" type="function" identity="getPipelineStatus" parent="~/.framework/functions/cil-pipeline.ts"]
+// CIL[DOC-MACRO purpose="Define the getPipelineStatus function"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide the getPipelineStatus function for the CIL pipeline"]
+// CIL[DOC-CONTEXT module="cil-pipeline" layer="domain" related_files=".framework/functions/_shared/cil.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/middleware.ts,.framework/functions/cil-pipeline.ts"]
+// CIL[DOC-CONTRACT inputs="project_id: string" outputs="See implementation" errors="May throw on invalid inputs or missing data" side_effects="May query or update project records"]
+// CIL[DOC-MICRO logic_summary="Implements the getPipelineStatus function" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 async function getPipelineStatus(project_id: string) {
   const project = await getProject(project_id)
   const fileStatuses: Record<string, string> = project.data?.file_statuses || {}
@@ -144,7 +328,23 @@ async function getPipelineStatus(project_id: string) {
     overall_progress: Math.round(overallProgress)
   }
 }
+// CIL[DOC-VECTOR type="context" content="purpose='Define the getPipelineStatus function'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/cil.ts"]
+// 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/functions/cil-pipeline.ts:getPipelineStatus:function"]
 
+
+// CIL[BEGIN stable_id="~/.framework/functions/cil-pipeline.ts:getFilesReadyForStep:function" type="function" identity="getFilesReadyForStep" parent="~/.framework/functions/cil-pipeline.ts"]
+// CIL[DOC-MACRO purpose="Define the getFilesReadyForStep function"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide the getFilesReadyForStep function for the CIL pipeline"]
+// CIL[DOC-CONTEXT module="cil-pipeline" layer="domain" related_files=".framework/functions/_shared/cil.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/middleware.ts,.framework/functions/cil-pipeline.ts"]
+// CIL[DOC-CONTRACT inputs="project_id: string, step: number, include_blocking_info: boolean" outputs="See implementation" errors="May throw on invalid inputs or missing data" side_effects="May query or update project records"]
+// CIL[DOC-MICRO logic_summary="Implements the getFilesReadyForStep function" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 async function getFilesReadyForStep(project_id: string, step: number, include_blocking_info: boolean) {
   const stepKey = step as PipelineStep
   if (!PIPELINE_STEPS[stepKey]) {
@@ -194,7 +394,23 @@ async function getFilesReadyForStep(project_id: string, step: number, include_bl
     files
   }
 }
+// CIL[DOC-VECTOR type="context" content="purpose='Define the getFilesReadyForStep function'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/cil.ts"]
+// 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/functions/cil-pipeline.ts:getFilesReadyForStep:function"]
+
 
+// CIL[BEGIN stable_id="~/.framework/functions/cil-pipeline.ts:updateFilePipelineState:function" type="function" identity="updateFilePipelineState" parent="~/.framework/functions/cil-pipeline.ts"]
+// CIL[DOC-MACRO purpose="Define the updateFilePipelineState function"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide the updateFilePipelineState function for the CIL pipeline"]
+// CIL[DOC-CONTEXT module="cil-pipeline" layer="domain" related_files=".framework/functions/_shared/cil.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/middleware.ts,.framework/functions/cil-pipeline.ts"]
+// CIL[DOC-CONTRACT inputs="project_id: string, file_path: string, step_completed: number, new_status: string" outputs="See implementation" errors="May throw on invalid inputs or missing data" side_effects="May query or update project records"]
+// CIL[DOC-MICRO logic_summary="Implements the updateFilePipelineState function" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 async function updateFilePipelineState(
   project_id: string,
   file_path: string,
@@ -226,7 +442,23 @@ async function updateFilePipelineState(
     progress_percentage: calculateProgress(new_status)
   }
 }
+// CIL[DOC-VECTOR type="context" content="purpose='Define the updateFilePipelineState function'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/cil.ts"]
+// 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/functions/cil-pipeline.ts:updateFilePipelineState:function"]
 
+
+// CIL[BEGIN stable_id="~/.framework/functions/cil-pipeline.ts:getPipelineBottlenecks:function" type="function" identity="getPipelineBottlenecks" parent="~/.framework/functions/cil-pipeline.ts"]
+// CIL[DOC-MACRO purpose="Define the getPipelineBottlenecks function"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide the getPipelineBottlenecks function for the CIL pipeline"]
+// CIL[DOC-CONTEXT module="cil-pipeline" layer="domain" related_files=".framework/functions/_shared/cil.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/middleware.ts,.framework/functions/cil-pipeline.ts"]
+// CIL[DOC-CONTRACT inputs="project_id: string" outputs="See implementation" errors="May throw on invalid inputs or missing data" side_effects="May query or update project records"]
+// CIL[DOC-MICRO logic_summary="Implements the getPipelineBottlenecks function" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 async function getPipelineBottlenecks(project_id: string) {
   const project = await getProject(project_id)
   const fileStatuses: Record<string, string> = project.data?.file_statuses || {}
@@ -274,7 +506,23 @@ async function getPipelineBottlenecks(project_id: string) {
     }
   }
 }
+// CIL[DOC-VECTOR type="context" content="purpose='Define the getPipelineBottlenecks function'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/cil.ts"]
+// 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/functions/cil-pipeline.ts:getPipelineBottlenecks:function"]
+
 
+// CIL[BEGIN stable_id="~/.framework/functions/cil-pipeline.ts:handler:constant" type="constant" identity="handler" parent="~/.framework/functions/cil-pipeline.ts"]
+// CIL[DOC-MACRO purpose="Define the handler constant"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide the handler constant for the CIL pipeline"]
+// CIL[DOC-CONTEXT module="cil-pipeline" layer="domain" related_files=".framework/functions/_shared/cil.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/middleware.ts,.framework/functions/cil-pipeline.ts"]
+// CIL[DOC-CONTRACT inputs="None" outputs="handler constant definition" errors="None" side_effects="None"]
+// CIL[DOC-MICRO logic_summary="Implements the handler constant" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export const handler = createHandler(async (ctx, body) => {
   const action = ctx.query?.action
   if (!action) throw new Error('action is required')
@@ -316,3 +564,10 @@ export const handler = createHandler(async (ctx, body) => {
 
   throw new Error(`Unknown action: ${action}`)
 })
+// CIL[DOC-VECTOR type="context" content="purpose='Define the handler constant'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/cil.ts"]
+// 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/functions/cil-pipeline.ts:handler:constant"]