spine-framework 0.3.145 → 0.4.0

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

@@ -1,18 +1,12 @@
-// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_doc_module_header_1784235266" type="module_header" identity="module_header" parent="none"]
-// CIL[DOC-MACRO purpose="Module header and top-level exports for cortex.functions.custom_cil-doc"]
-// CIL[DOC-RESPONSIBILITY responsibility="Own module-level imports, exports, and configuration for cortex.functions.custom_cil-doc"]
-// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-doc" layer="function" related_files="[\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/functions/_shared/principal.ts\",\".framework/functions/_shared/schema-utils.ts\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="module exports and side effects" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Declares module scope, imports dependencies, and exports public surface of cortex.functions.custom_cil-doc" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[BEGIN stable_id="~/.framework/functions/cil-doc.ts:module_header:module_header" type="module_header" identity="module_header" parent="~/.framework/functions/cil-doc.ts"]
+// CIL[DOC-MACRO purpose="Module header for the CIL documentation service, defining imports and module constants."]
+// CIL[DOC-RESPONSIBILITY responsibility="Orients readers to the module, its entry points, and key dependencies."]
+// CIL[DOC-CONTEXT module="cil-doc" layer="shared-core" related_files=".framework/functions/_shared/cil.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/llm.ts,.framework/functions/_shared/middleware.ts,.framework/functions/admin-data.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Declares imports and constants used throughout the CIL documentation pipeline." notable_decisions="none"]
+// 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: function. Direct callers: 0. Direct calls: 0. Related files: custom/apps/cortex/pages/operations/OperationsDashboard.tsx, custom/apps/portal/pages/ContentPage.tsx, .framework/src/pages/admin/TypeDetailPage.tsx, .framework/functions/_shared/principal.ts, .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="implementation_pattern" content="" status="pending_human_input"]
-// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[DOC-AUDIENCE audience="both"]
 
 
 
@@ -22,9 +16,16 @@ import { createHandler } from './_shared/middleware'
 import { adminDb } from './_shared/db'
 import { update as adminUpdate } from './admin-data'
 import { callOpenAIChat } from './_shared/llm'
-import { FileStatus, FileTreeNode, isSelectedPath, getFileStatus, updateTreeNodeStatus, saveProjectTree } from './_shared/cil'
+import { FileStatus, FileTreeNode, isSelectedPath, getFileStatus, updateTreeNodeStatus, saveProjectTree, parseStableId } from './_shared/cil'
 import * as fs from 'fs'
 import * as path from 'path'
+// CIL[DOC-VECTOR type="context" content="purpose='Module header for the CIL documentation service, defining imports and module constants.'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/admin-data.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-doc.ts:module_header:module_header"]
 
 
 
@@ -34,22 +35,22 @@ import * as path from 'path'
 
 
 
-// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_doc_module_header_1784235266"]
-// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_doc_default_model_1784235266" type="variable" identity="default_model" parent="none"]
-// CIL[DOC-MACRO purpose="Defines default_model configuration or state in cortex.functions.custom_cil-doc"]
-// CIL[DOC-RESPONSIBILITY responsibility="Hold the value and default configuration for default_model"]
-// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-doc" layer="function" related_files="[\"custom/apps/cortex/functions/custom_cil-embeddings.ts\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/functions/_shared/principal.ts\",\".framework/src/pages/admin/IntegrationsPage.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="value of default_model" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Declares default_model with initial value or constant binding used by cortex.functions.custom_cil-doc" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[BEGIN stable_id="~/.framework/functions/cil-doc.ts:DEFAULT_MODEL:constant" type="constant" identity="DEFAULT_MODEL" parent="~/.framework/functions/cil-doc.ts"]
+// CIL[DOC-MACRO purpose="Declares the d e f a u l t_ m o d e l constant used by the documentation pipeline."]
+// CIL[DOC-RESPONSIBILITY responsibility="Provides the d e f a u l t_ m o d e l value used across documentation operations."]
+// CIL[DOC-CONTEXT module="cil-doc" layer="app-specific" related_files=".framework/functions/_shared/cil.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/llm.ts,.framework/functions/_shared/middleware.ts,.framework/functions/admin-data.ts,.framework/functions/cil-doc.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="none" notable_decisions="none"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
 // CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: function. Direct callers: 0. Direct calls: 0. Related files: custom/apps/cortex/functions/custom_cil-embeddings.ts, .framework/src/pages/admin/TypeDetailPage.tsx, .framework/functions/_shared/principal.ts, .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."]
+const DEFAULT_MODEL = 'gpt-4o-mini'
+// CIL[DOC-VECTOR type="context" content="purpose='Declares the d e f a u l t_ m o d e l constant used by the documentation pipeline.'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/admin-data.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"]
-const DEFAULT_MODEL = 'gpt-4o-mini'
+// CIL[END stable_id="~/.framework/functions/cil-doc.ts:DEFAULT_MODEL:constant"]
 
 
 
@@ -59,27 +60,27 @@ const DEFAULT_MODEL = 'gpt-4o-mini'
 
 
 
-// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_doc_default_model_1784235266"]
-// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_doc_model_prices_1784235266" type="variable" identity="model_prices" parent="none"]
-// CIL[DOC-MACRO purpose="Defines model_prices configuration or state in cortex.functions.custom_cil-doc"]
-// CIL[DOC-RESPONSIBILITY responsibility="Hold the value and default configuration for model_prices"]
-// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-doc" layer="function" related_files="[\"custom/apps/cortex/functions/custom_cil-embeddings.ts\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/functions/_shared/principal.ts\",\".framework/src/pages/admin/IntegrationsPage.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="value of model_prices" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Declares model_prices with initial value or constant binding used by cortex.functions.custom_cil-doc" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[BEGIN stable_id="~/.framework/functions/cil-doc.ts:MODEL_PRICES:constant" type="constant" identity="MODEL_PRICES" parent="~/.framework/functions/cil-doc.ts"]
+// CIL[DOC-MACRO purpose="Declares the m o d e l_ p r i c e s constant used by the documentation pipeline."]
+// CIL[DOC-RESPONSIBILITY responsibility="Provides the m o d e l_ p r i c e s value used across documentation operations."]
+// CIL[DOC-CONTEXT module="cil-doc" layer="app-specific" related_files=".framework/functions/_shared/cil.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/llm.ts,.framework/functions/_shared/middleware.ts,.framework/functions/admin-data.ts,.framework/functions/cil-doc.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="none" notable_decisions="none"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
 // CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: function. Direct callers: 0. Direct calls: 0. Related files: custom/apps/cortex/functions/custom_cil-embeddings.ts, .framework/src/pages/admin/TypeDetailPage.tsx, .framework/functions/_shared/principal.ts, .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 MODEL_PRICES: Record<string, { input_per_1m: number; output_per_1m: number }> = {
   'gpt-4o-mini':   { input_per_1m: 0.15,  output_per_1m: 0.60  },
   'gpt-4o':        { input_per_1m: 2.50,  output_per_1m: 10.00 },
   'gpt-4-turbo':   { input_per_1m: 10.00, output_per_1m: 30.00 },
   'gpt-3.5-turbo': { input_per_1m: 0.50,  output_per_1m: 1.50  },
 }
+// CIL[DOC-VECTOR type="context" content="purpose='Declares the m o d e l_ p r i c e s constant used by the documentation pipeline.'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/admin-data.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-doc.ts:MODEL_PRICES:constant"]
 
 
 
@@ -88,22 +89,22 @@ const MODEL_PRICES: Record<string, { input_per_1m: number; output_per_1m: number
 
 
 
-// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_doc_model_prices_1784235266"]
-// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_doc_estimated_output_tokens_per_chunk_1784235266" type="variable" identity="estimated_output_tokens_per_chunk" parent="none"]
-// CIL[DOC-MACRO purpose="Defines estimated_output_tokens_per_chunk configuration or state in cortex.functions.custom_cil-doc"]
-// CIL[DOC-RESPONSIBILITY responsibility="Hold the value and default configuration for estimated_output_tokens_per_chunk"]
-// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-doc" layer="function" related_files="[\"custom/apps/cortex/functions/custom_cil-embeddings.ts\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/functions/_shared/principal.ts\",\".framework/src/pages/admin/IntegrationsPage.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="value of estimated_output_tokens_per_chunk" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Declares estimated_output_tokens_per_chunk with initial value or constant binding used by cortex.functions.custom_cil-doc" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[BEGIN stable_id="~/.framework/functions/cil-doc.ts:ESTIMATED_OUTPUT_TOKENS_PER_CHUNK:constant" type="constant" identity="ESTIMATED_OUTPUT_TOKENS_PER_CHUNK" parent="~/.framework/functions/cil-doc.ts"]
+// CIL[DOC-MACRO purpose="Declares the e s t i m a t e d_ o u t p u t_ t o k e n s_ p e r_ c h u n k constant used by the documentation pipeline."]
+// CIL[DOC-RESPONSIBILITY responsibility="Provides the e s t i m a t e d_ o u t p u t_ t o k e n s_ p e r_ c h u n k value used across documentation operations."]
+// CIL[DOC-CONTEXT module="cil-doc" layer="app-specific" related_files=".framework/functions/_shared/cil.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/llm.ts,.framework/functions/_shared/middleware.ts,.framework/functions/admin-data.ts,.framework/functions/cil-doc.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="none" notable_decisions="none"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
 // CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: function. Direct callers: 0. Direct calls: 0. Related files: custom/apps/cortex/functions/custom_cil-embeddings.ts, .framework/src/pages/admin/TypeDetailPage.tsx, .framework/functions/_shared/principal.ts, .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."]
+const ESTIMATED_OUTPUT_TOKENS_PER_CHUNK = 200
+// CIL[DOC-VECTOR type="context" content="purpose='Declares the e s t i m a t e d_ o u t p u t_ t o k e n s_ p e r_ c h u n k constant used by the documentation pipeline.'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/admin-data.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"]
-const ESTIMATED_OUTPUT_TOKENS_PER_CHUNK = 200
+// CIL[END stable_id="~/.framework/functions/cil-doc.ts:ESTIMATED_OUTPUT_TOKENS_PER_CHUNK:constant"]
 
 
 
@@ -111,22 +112,22 @@ const ESTIMATED_OUTPUT_TOKENS_PER_CHUNK = 200
 
 
 
-// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_doc_estimated_output_tokens_per_chunk_1784235266"]
-// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_doc_system_prompt_overhead_tokens_1784235266" type="variable" identity="system_prompt_overhead_tokens" parent="none"]
-// CIL[DOC-MACRO purpose="Defines system_prompt_overhead_tokens configuration or state in cortex.functions.custom_cil-doc"]
-// CIL[DOC-RESPONSIBILITY responsibility="Hold the value and default configuration for system_prompt_overhead_tokens"]
-// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-doc" layer="function" related_files="[\"custom/apps/cortex/functions/custom_cil-embeddings.ts\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/functions/_shared/principal.ts\",\".framework/src/pages/admin/IntegrationsPage.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="value of system_prompt_overhead_tokens" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Declares system_prompt_overhead_tokens with initial value or constant binding used by cortex.functions.custom_cil-doc" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[BEGIN stable_id="~/.framework/functions/cil-doc.ts:SYSTEM_PROMPT_OVERHEAD_TOKENS:constant" type="constant" identity="SYSTEM_PROMPT_OVERHEAD_TOKENS" parent="~/.framework/functions/cil-doc.ts"]
+// CIL[DOC-MACRO purpose="Declares the s y s t e m_ p r o m p t_ o v e r h e a d_ t o k e n s constant used by the documentation pipeline."]
+// CIL[DOC-RESPONSIBILITY responsibility="Provides the s y s t e m_ p r o m p t_ o v e r h e a d_ t o k e n s value used across documentation operations."]
+// CIL[DOC-CONTEXT module="cil-doc" layer="app-specific" related_files=".framework/functions/_shared/cil.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/llm.ts,.framework/functions/_shared/middleware.ts,.framework/functions/admin-data.ts,.framework/functions/cil-doc.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="none" notable_decisions="none"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
 // CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: function. Direct callers: 0. Direct calls: 0. Related files: custom/apps/cortex/functions/custom_cil-embeddings.ts, .framework/src/pages/admin/TypeDetailPage.tsx, .framework/functions/_shared/principal.ts, .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."]
+const SYSTEM_PROMPT_OVERHEAD_TOKENS = 350
+// CIL[DOC-VECTOR type="context" content="purpose='Declares the s y s t e m_ p r o m p t_ o v e r h e a d_ t o k e n s constant used by the documentation pipeline.'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/admin-data.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"]
-const SYSTEM_PROMPT_OVERHEAD_TOKENS = 350
+// CIL[END stable_id="~/.framework/functions/cil-doc.ts:SYSTEM_PROMPT_OVERHEAD_TOKENS:constant"]
 
 
 
@@ -136,24 +137,24 @@ const SYSTEM_PROMPT_OVERHEAD_TOKENS = 350
 
 
 
-// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_doc_system_prompt_overhead_tokens_1784235266"]
-// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_doc_estimatetokens_1784235266" type="function" identity="estimatetokens" parent="none"]
-// CIL[DOC-MACRO purpose="Implements estimatetokens logic in cortex.functions.custom_cil-doc"]
-// CIL[DOC-RESPONSIBILITY responsibility="Execute estimatetokens and return its computed result"]
-// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-doc" layer="function" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="return value from function execution" errors="throws on invalid input or runtime failure" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Provides estimatetokens with estimateTokens(text: string inputs, handling internal flow and returning a result" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[BEGIN stable_id="~/.framework/functions/cil-doc.ts:estimateTokens:function" type="function" identity="estimateTokens" parent="~/.framework/functions/cil-doc.ts"]
+// CIL[DOC-MACRO purpose="Implements the estimate tokens behavior for CIL documentation processing."]
+// CIL[DOC-RESPONSIBILITY responsibility="Carries out the estimate tokens responsibility within the documentation workflow."]
+// CIL[DOC-CONTEXT module="cil-doc" layer="app-specific" related_files=".framework/functions/_shared/cil.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/llm.ts,.framework/functions/_shared/middleware.ts,.framework/functions/admin-data.ts,.framework/functions/cil-doc.ts"]
+// CIL[DOC-CONTRACT inputs="text: string" outputs="number" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Computes the estimate tokens result from the provided input parameters." notable_decisions="none"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
 // CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: function. 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"]
 function estimateTokens(text: string): number {
   return Math.ceil(text.length / 4)
 }
+// CIL[DOC-VECTOR type="context" content="purpose='Implements the estimate tokens behavior for CIL documentation processing.'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/admin-data.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-doc.ts:estimateTokens:function"]
 
 
 
@@ -161,21 +162,14 @@ function estimateTokens(text: string): number {
 
 
 
-// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_doc_estimatetokens_1784235266"]
-// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_doc_needsdocumentation_1784235266" type="function" identity="needsdocumentation" parent="none"]
-// CIL[DOC-MACRO purpose="Implements needsdocumentation logic in cortex.functions.custom_cil-doc"]
-// CIL[DOC-RESPONSIBILITY responsibility="Execute needsdocumentation and return its computed result"]
-// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-doc" layer="function" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="return value from function execution" errors="throws on invalid input or runtime failure" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Provides needsdocumentation with needsDocumentation(chunk: any inputs, handling internal flow and returning a result" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[BEGIN stable_id="~/.framework/functions/cil-doc.ts:needsDocumentation:function" type="function" identity="needsDocumentation" parent="~/.framework/functions/cil-doc.ts"]
+// CIL[DOC-MACRO purpose="Implements the needs documentation behavior for CIL documentation processing."]
+// CIL[DOC-RESPONSIBILITY responsibility="Carries out the needs documentation responsibility within the documentation workflow."]
+// CIL[DOC-CONTEXT module="cil-doc" layer="app-specific" related_files=".framework/functions/_shared/cil.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/llm.ts,.framework/functions/_shared/middleware.ts,.framework/functions/admin-data.ts,.framework/functions/cil-doc.ts"]
+// CIL[DOC-CONTRACT inputs="chunk: any" outputs="boolean" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Computes the needs documentation result from the provided input parameters." notable_decisions="none"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
 // CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: function. 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"]
 function needsDocumentation(chunk: any): boolean {
   const d = chunk.data || {}
   
@@ -188,6 +182,13 @@ function needsDocumentation(chunk: any): boolean {
     : REQUIRED_CHUNK_FIELDS
   return required.some(f => !d[f] || String(d[f]).trim() === '')
 }
+// CIL[DOC-VECTOR type="context" content="purpose='Implements the needs documentation behavior for CIL documentation processing.'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/admin-data.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-doc.ts:needsDocumentation:function"]
 
 
 
@@ -196,21 +197,14 @@ function needsDocumentation(chunk: any): boolean {
 
 
 
-// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_doc_needsdocumentation_1784235266"]
-// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_doc_loadallchunks_1784235266" type="function" identity="loadallchunks" parent="none"]
-// CIL[DOC-MACRO purpose="Implements loadallchunks logic in cortex.functions.custom_cil-doc"]
-// CIL[DOC-RESPONSIBILITY responsibility="Execute loadallchunks and return its computed result"]
-// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-doc" layer="function" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="return value from function execution" errors="throws on invalid input or runtime failure" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Provides loadallchunks with loadAllChunks(projectId: string, filePath?: string inputs, handling internal flow and returning a result" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[BEGIN stable_id="~/.framework/functions/cil-doc.ts:loadAllChunks:function" type="function" identity="loadAllChunks" parent="~/.framework/functions/cil-doc.ts"]
+// CIL[DOC-MACRO purpose="Implements the load all chunks behavior for CIL documentation processing."]
+// CIL[DOC-RESPONSIBILITY responsibility="Carries out the load all chunks responsibility within the documentation workflow."]
+// CIL[DOC-CONTEXT module="cil-doc" layer="app-specific" related_files=".framework/functions/_shared/cil.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/llm.ts,.framework/functions/_shared/middleware.ts,.framework/functions/admin-data.ts,.framework/functions/cil-doc.ts"]
+// CIL[DOC-CONTRACT inputs="projectId: string, filePath?: string" outputs="Promise<any[]>" errors="Throws Error on invalid input or missing resources" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Computes the load all chunks result from the provided input parameters." notable_decisions="none"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
 // CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: function. 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"]
 async function loadAllChunks(projectId: string, filePath?: string): Promise<any[]> {
   const PAGE = 1000
   const all: any[] = []
@@ -232,25 +226,114 @@ async function loadAllChunks(projectId: string, filePath?: string): Promise<any[
   }
   return all
 }
+// CIL[DOC-VECTOR type="context" content="purpose='Implements the load all chunks behavior for CIL documentation processing.'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/admin-data.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-doc.ts:loadAllChunks:function"]
+
 
 
 
 
-// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_doc_loadallchunks_1784235266"]
-// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_doc_loadpendingchunks_1784235266" type="function" identity="loadpendingchunks" parent="none"]
-// CIL[DOC-MACRO purpose="Implements loadpendingchunks logic in cortex.functions.custom_cil-doc"]
-// CIL[DOC-RESPONSIBILITY responsibility="Execute loadpendingchunks and return its computed result"]
-// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-doc" layer="function" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="return value from function execution" errors="throws on invalid input or runtime failure" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Provides loadpendingchunks with loadPendingChunks(projectId: string, selectedPaths: string[], requiredStatus: FileStatus inputs, handling internal flow and returning a result" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[BEGIN stable_id="~/.framework/functions/cil-doc.ts:resolveChunk:function" type="function" identity="resolveChunk" parent="~/.framework/functions/cil-doc.ts"]
+// CIL[DOC-MACRO purpose="Implements the resolve chunk behavior for CIL documentation processing."]
+// CIL[DOC-RESPONSIBILITY responsibility="Carries out the resolve chunk responsibility within the documentation workflow."]
+// CIL[DOC-CONTEXT module="cil-doc" layer="app-specific" related_files=".framework/functions/_shared/cil.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/llm.ts,.framework/functions/_shared/middleware.ts,.framework/functions/admin-data.ts,.framework/functions/cil-doc.ts"]
+// CIL[DOC-CONTRACT inputs="ctx: any,   body: any" outputs="Promise<any>" errors="Throws Error on invalid input or missing resources" side_effects="Supabase database queries and updates"]
+// CIL[DOC-MICRO logic_summary="Computes the resolve chunk result from the provided input parameters." notable_decisions="none"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
 // CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: function. 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."]
+async function resolveChunk(
+  ctx: any,
+  body: any
+): Promise<any> {
+  const stableId = body?.stable_id || ctx.query?.stable_id
+  const versionId = body?.version_id || ctx.query?.version_id
+  const chunkId = body?.chunk_id || ctx.query?.chunk_id
+  const chunkName = body?.chunk_name || ctx.query?.chunk_name
+  const projectId = body?.project_id || ctx.query?.project_id
+
+  if (stableId) {
+    if (parseStableId(stableId) === null) {
+      throw new Error(`Invalid stable_id: ${stableId}`)
+    }
+
+    if (versionId) {
+      const { data: chunk, error } = await adminDb
+        .from('items')
+        .select('id, title, data')
+        .filter('data->>kb_type', 'eq', 'cil_chunk')
+        .filter('data->>stable_id', 'eq', stableId)
+        .filter('data->>version_id', 'eq', versionId)
+        .eq('is_active', true)
+        .maybeSingle()
+      if (error || !chunk) throw new Error(`Chunk not found for stable_id: ${stableId}, version_id: ${versionId}`)
+      return chunk
+    }
+
+    let activeVersion: string | undefined
+    if (projectId) {
+      const { data: proj } = await adminDb.from('items').select('data').eq('id', projectId).maybeSingle()
+      activeVersion = proj?.data?.active_version_id
+    }
+
+    let q = adminDb
+      .from('items')
+      .select('id, title, data')
+      .filter('data->>kb_type', 'eq', 'cil_chunk')
+      .filter('data->>stable_id', 'eq', stableId)
+      .eq('is_active', true)
+    if (activeVersion) q = q.filter('data->>version_id', 'eq', activeVersion)
+    const { data: chunk, error } = await q.maybeSingle()
+    if (error || !chunk) {
+      throw new Error(`Chunk not found for stable_id: ${stableId}${activeVersion ? ` (active version ${activeVersion})` : ''}`)
+    }
+    return chunk
+  }
+
+  if (chunkId) {
+    const { data: chunk, error } = await adminDb
+      .from('items')
+      .select('id, title, data')
+      .eq('id', chunkId)
+      .maybeSingle()
+    if (error || !chunk) throw new Error(`Chunk not found: ${chunkId}`)
+    return chunk
+  }
+
+  if (chunkName) {
+    const { data: chunk, error } = await adminDb
+      .from('items')
+      .select('id, title, data')
+      .filter('data->>kb_type', 'eq', 'cil_chunk')
+      .filter('data->>chunk_name', 'eq', chunkName)
+      .eq('is_active', true)
+      .maybeSingle()
+    if (error || !chunk) throw new Error(`Chunk not found: ${chunkName}`)
+    return chunk
+  }
+
+  throw new Error('chunk_id, stable_id, or chunk_name is required')
+}
+// CIL[DOC-VECTOR type="context" content="purpose='Implements the resolve chunk behavior for CIL documentation processing.'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/admin-data.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-doc.ts:resolveChunk:function"]
+
+// CIL[BEGIN stable_id="~/.framework/functions/cil-doc.ts:loadPendingChunks:function" type="function" identity="loadPendingChunks" parent="~/.framework/functions/cil-doc.ts"]
+// CIL[DOC-MACRO purpose="Implements the load pending chunks behavior for CIL documentation processing."]
+// CIL[DOC-RESPONSIBILITY responsibility="Carries out the load pending chunks responsibility within the documentation workflow."]
+// CIL[DOC-CONTEXT module="cil-doc" layer="app-specific" related_files=".framework/functions/_shared/cil.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/llm.ts,.framework/functions/_shared/middleware.ts,.framework/functions/admin-data.ts,.framework/functions/cil-doc.ts"]
+// CIL[DOC-CONTRACT inputs="projectId: string, selectedPaths: string[], requiredStatus: FileStatus" outputs="Promise<any[]>" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Computes the load pending chunks result from the provided input parameters." notable_decisions="none"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 async function loadPendingChunks(projectId: string, selectedPaths: string[], requiredStatus: FileStatus): Promise<any[]> {
   const { data: fileItems } = await adminDb
     .from('items')
@@ -274,25 +357,25 @@ async function loadPendingChunks(projectId: string, selectedPaths: string[], req
 
   return (allChunks || []).filter((c: any) => selectedFileIds.includes(c.data?.file_id))
 }
+// CIL[DOC-VECTOR type="context" content="purpose='Implements the load pending chunks behavior for CIL documentation processing.'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/admin-data.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-doc.ts:loadPendingChunks:function"]
 
 
 
 
-// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_doc_loadpendingchunks_1784235266"]
-// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_doc_maybeadvancefiletopass3_1784235266" type="function" identity="maybeadvancefiletopass3" parent="none"]
-// CIL[DOC-MACRO purpose="Implements maybeadvancefiletopass3 logic in cortex.functions.custom_cil-doc"]
-// CIL[DOC-RESPONSIBILITY responsibility="Execute maybeadvancefiletopass3 and return its computed result"]
-// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-doc" layer="function" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="return value from function execution" errors="throws on invalid input or runtime failure" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Provides maybeadvancefiletopass3 with maybeAdvanceFileToPass3(ctx: any, fileId: string, tree: FileTreeNode | null inputs, handling internal flow and returning a result" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[BEGIN stable_id="~/.framework/functions/cil-doc.ts:maybeAdvanceFileToPass3:function" type="function" identity="maybeAdvanceFileToPass3" parent="~/.framework/functions/cil-doc.ts"]
+// CIL[DOC-MACRO purpose="Implements the maybe advance file to pass3 behavior for CIL documentation processing."]
+// CIL[DOC-RESPONSIBILITY responsibility="Carries out the maybe advance file to pass3 responsibility within the documentation workflow."]
+// CIL[DOC-CONTEXT module="cil-doc" layer="app-specific" related_files=".framework/functions/_shared/cil.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/llm.ts,.framework/functions/_shared/middleware.ts,.framework/functions/admin-data.ts,.framework/functions/cil-doc.ts"]
+// CIL[DOC-CONTRACT inputs="ctx: any, fileId: string, tree: FileTreeNode | null" outputs="Promise<void>" errors="none" side_effects="Supabase database queries and updates"]
+// CIL[DOC-MICRO logic_summary="Computes the maybe advance file to pass3 result from the provided input parameters." notable_decisions="none"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
 // CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: function. 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"]
 async function maybeAdvanceFileToPass3(ctx: any, fileId: string, tree: FileTreeNode | null): Promise<void> {
   const { data: fileChunks } = await adminDb
     .from('items')
@@ -316,13 +399,20 @@ async function maybeAdvanceFileToPass3(ctx: any, fileId: string, tree: FileTreeN
   await adminUpdate(updateCtx, {
     data: {
       ...fileItem.data,
-      status: 'pass3_complete',
+      status: '3-documented',
       last_status_at: new Date().toISOString(),
     },
   }).catch((e: any) => console.error('advance to pass3 failed:', e.message))
 
-  if (tree) updateTreeNodeStatus(tree, fileId, 'pass3_complete')
+  if (tree) updateTreeNodeStatus(tree, fileId, '3-documented')
 }
+// CIL[DOC-VECTOR type="context" content="purpose='Implements the maybe advance file to pass3 behavior for CIL documentation processing.'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/admin-data.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-doc.ts:maybeAdvanceFileToPass3:function"]
 
 
 
@@ -377,83 +467,76 @@ async function maybeAdvanceFileToPass3(ctx: any, fileId: string, tree: FileTreeN
 
 
 
-// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_doc_maybeadvancefiletopass3_1784235266"]
-// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_doc_required_module_fields_1784235266" type="variable" identity="required_module_fields" parent="none"]
-// CIL[DOC-MACRO purpose="Defines required_module_fields configuration or state in cortex.functions.custom_cil-doc"]
-// CIL[DOC-RESPONSIBILITY responsibility="Hold the value and default configuration for required_module_fields"]
-// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-doc" layer="function" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="value of required_module_fields" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Declares required_module_fields with initial value or constant binding used by cortex.functions.custom_cil-doc" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[BEGIN stable_id="~/.framework/functions/cil-doc.ts:REQUIRED_MODULE_FIELDS:constant" type="constant" identity="REQUIRED_MODULE_FIELDS" parent="~/.framework/functions/cil-doc.ts"]
+// CIL[DOC-MACRO purpose="Declares the r e q u i r e d_ m o d u l e_ f i e l d s constant used by the documentation pipeline."]
+// CIL[DOC-RESPONSIBILITY responsibility="Provides the r e q u i r e d_ m o d u l e_ f i e l d s value used across documentation operations."]
+// CIL[DOC-CONTEXT module="cil-doc" layer="app-specific" related_files=".framework/functions/_shared/cil.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/llm.ts,.framework/functions/_shared/middleware.ts,.framework/functions/admin-data.ts,.framework/functions/cil-doc.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="none" notable_decisions="none"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
 // CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: function. Direct callers: 0. Direct calls: 0. Related files: none."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+const REQUIRED_MODULE_FIELDS = ['module', 'audience', 'layer', 'stability', 'description']
+// CIL[DOC-VECTOR type="context" content="purpose='Declares the r e q u i r e d_ m o d u l e_ f i e l d s constant used by the documentation pipeline.'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/admin-data.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"]
-const REQUIRED_MODULE_FIELDS = ['module', 'audience', 'layer', 'stability', 'description']
+// CIL[END stable_id="~/.framework/functions/cil-doc.ts:REQUIRED_MODULE_FIELDS:constant"]
 
 
-// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_doc_required_module_fields_1784235266"]
-// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_doc_required_chunk_fields_1784235266" type="variable" identity="required_chunk_fields" parent="none"]
-// CIL[DOC-MACRO purpose="Defines required_chunk_fields configuration or state in cortex.functions.custom_cil-doc"]
-// CIL[DOC-RESPONSIBILITY responsibility="Hold the value and default configuration for required_chunk_fields"]
-// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-doc" layer="function" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="value of required_chunk_fields" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Declares required_chunk_fields with initial value or constant binding used by cortex.functions.custom_cil-doc" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[BEGIN stable_id="~/.framework/functions/cil-doc.ts:REQUIRED_CHUNK_FIELDS:constant" type="constant" identity="REQUIRED_CHUNK_FIELDS" parent="~/.framework/functions/cil-doc.ts"]
+// CIL[DOC-MACRO purpose="Declares the r e q u i r e d_ c h u n k_ f i e l d s constant used by the documentation pipeline."]
+// CIL[DOC-RESPONSIBILITY responsibility="Provides the r e q u i r e d_ c h u n k_ f i e l d s value used across documentation operations."]
+// CIL[DOC-CONTEXT module="cil-doc" layer="app-specific" related_files=".framework/functions/_shared/cil.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/llm.ts,.framework/functions/_shared/middleware.ts,.framework/functions/admin-data.ts,.framework/functions/cil-doc.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="none" notable_decisions="none"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
 // CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: function. Direct callers: 0. Direct calls: 0. Related files: none."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+const REQUIRED_CHUNK_FIELDS = ['description', 'input_spec', 'output_spec', 'side_effects', 'stability']
+// CIL[DOC-VECTOR type="context" content="purpose='Declares the r e q u i r e d_ c h u n k_ f i e l d s constant used by the documentation pipeline.'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/admin-data.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"]
-const REQUIRED_CHUNK_FIELDS = ['description', 'input_spec', 'output_spec', 'side_effects', 'stability']
+// CIL[END stable_id="~/.framework/functions/cil-doc.ts:REQUIRED_CHUNK_FIELDS:constant"]
 
 
 
 
-// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_doc_required_chunk_fields_1784235266"]
-// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_doc_modulenamefrompath_1784235266" type="function" identity="modulenamefrompath" parent="none"]
-// CIL[DOC-MACRO purpose="Implements modulenamefrompath logic in cortex.functions.custom_cil-doc"]
-// CIL[DOC-RESPONSIBILITY responsibility="Execute modulenamefrompath and return its computed result"]
-// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-doc" layer="function" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="return value from function execution" errors="throws on invalid input or runtime failure" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Provides modulenamefrompath with moduleNameFromPath(relPath: string inputs, handling internal flow and returning a result" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[BEGIN stable_id="~/.framework/functions/cil-doc.ts:moduleNameFromPath:function" type="function" identity="moduleNameFromPath" parent="~/.framework/functions/cil-doc.ts"]
+// CIL[DOC-MACRO purpose="Implements the module name from path behavior for CIL documentation processing."]
+// CIL[DOC-RESPONSIBILITY responsibility="Carries out the module name from path responsibility within the documentation workflow."]
+// CIL[DOC-CONTEXT module="cil-doc" layer="app-specific" related_files=".framework/functions/_shared/cil.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/llm.ts,.framework/functions/_shared/middleware.ts,.framework/functions/admin-data.ts,.framework/functions/cil-doc.ts"]
+// CIL[DOC-CONTRACT inputs="relPath: string" outputs="string" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Computes the module name from path result from the provided input parameters." notable_decisions="none"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
 // CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: function. 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"]
 function moduleNameFromPath(relPath: string): string {
   return path.basename(relPath, path.extname(relPath))
 }
+// CIL[DOC-VECTOR type="context" content="purpose='Implements the module name from path behavior for CIL documentation processing.'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/admin-data.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-doc.ts:moduleNameFromPath:function"]
 
 
 
 
 
 
-// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_doc_modulenamefrompath_1784235266"]
-// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_doc_buildjsdoc_1784235266" type="function" identity="buildjsdoc" parent="none"]
-// CIL[DOC-MACRO purpose="Implements buildjsdoc logic in cortex.functions.custom_cil-doc"]
-// CIL[DOC-RESPONSIBILITY responsibility="Execute buildjsdoc and return its computed result"]
-// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-doc" layer="function" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="return value from function execution" errors="throws on invalid input or runtime failure" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Provides buildjsdoc with buildJsDoc(chunk: any inputs, handling internal flow and returning a result" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[BEGIN stable_id="~/.framework/functions/cil-doc.ts:buildJsDoc:function" type="function" identity="buildJsDoc" parent="~/.framework/functions/cil-doc.ts"]
+// CIL[DOC-MACRO purpose="Implements the build js doc behavior for CIL documentation processing."]
+// CIL[DOC-RESPONSIBILITY responsibility="Carries out the build js doc responsibility within the documentation workflow."]
+// CIL[DOC-CONTEXT module="cil-doc" layer="app-specific" related_files=".framework/functions/_shared/cil.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/llm.ts,.framework/functions/_shared/middleware.ts,.framework/functions/admin-data.ts,.framework/functions/cil-doc.ts"]
+// CIL[DOC-CONTRACT inputs="chunk: any" outputs="string" errors="none" side_effects="local file system access"]
+// CIL[DOC-MICRO logic_summary="Computes the build js doc result from the provided input parameters." notable_decisions="Skips redundant macro/micro lines and filters trivial calls from the @calls tag."]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
 // CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: function. 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"]
 function buildJsDoc(chunk: any): string {
   const d = chunk.data || {}
   const isModuleHeader = d.chunk_type === 'module_header'
@@ -565,26 +648,83 @@ function buildJsDoc(chunk: any): string {
   ]
   return docLines.join('\n')
 }
+// CIL[DOC-VECTOR type="context" content="purpose='Implements the build js doc behavior for CIL documentation processing.'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/admin-data.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-doc.ts:buildJsDoc:function"]
 
 
 
 
 
-// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_doc_buildjsdoc_1784235266"]
-// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_doc_validatechunkdocs_1784235266" type="function" identity="validatechunkdocs" parent="none"]
-// CIL[DOC-MACRO purpose="Implements validatechunkdocs logic in cortex.functions.custom_cil-doc"]
-// CIL[DOC-RESPONSIBILITY responsibility="Execute validatechunkdocs and return its computed result"]
-// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-doc" layer="function" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="return value from function execution" errors="throws on invalid input or runtime failure" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Provides validatechunkdocs with validateChunkDocs(chunk: any inputs, handling internal flow and returning a result" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[BEGIN stable_id="~/.framework/functions/cil-doc.ts:validateChunkDocs:function" type="function" identity="validateChunkDocs" parent="~/.framework/functions/cil-doc.ts"]
+// CIL[DOC-MACRO purpose="Implements the validate chunk docs behavior for CIL documentation processing."]
+// CIL[DOC-RESPONSIBILITY responsibility="Carries out the validate chunk docs responsibility within the documentation workflow."]
+// CIL[DOC-CONTEXT module="cil-doc" layer="app-specific" related_files=".framework/functions/_shared/cil.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/llm.ts,.framework/functions/_shared/middleware.ts,.framework/functions/admin-data.ts,.framework/functions/cil-doc.ts"]
+// CIL[DOC-CONTRACT inputs="chunk: any, text: string" outputs="string[]" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Computes the validate chunk docs result from the provided input parameters." notable_decisions="none"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
 // CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: function. 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"]
+function splitParameterList(text: string): string[] {
+  const parts: string[] = []
+  let depth = 0
+  let inString = false
+  let quote = ''
+  let current = ''
+  for (const ch of text) {
+    if (inString) {
+      if (ch === quote) inString = false
+      current += ch
+      continue
+    }
+    if (ch === '"' || ch === "'" || ch === '`') {
+      inString = true
+      quote = ch
+      current += ch
+      continue
+    }
+    if (ch === '(' || ch === '[' || ch === '<' || ch === '{') depth++
+    else if (ch === ')' || ch === ']' || ch === '>' || ch === '}') depth = Math.max(0, depth - 1)
+    else if ((ch === ',' || ch === '\n') && depth === 0) {
+      parts.push(current)
+      current = ''
+      continue
+    }
+    current += ch
+  }
+  parts.push(current)
+  return parts.map(s => s.trim()).filter(Boolean)
+}
+
+function expandParamEntries(rawParams: string): Array<{ name: string; type: string; optional: boolean }> {
+  const out: Array<{ name: string; type: string; optional: boolean }> = []
+  const push = (part: string, depth: number): void => {
+    if (depth > 4) return
+    const t = part.trim()
+    if (!t) return
+    const open = t[0]
+    if (open === '{' || open === '[') {
+      const close = open === '{' ? '}' : ']'
+      let d = 0
+      let end = -1
+      for (let i = 0; i < t.length; i++) {
+        if (t[i] === open) d++
+        else if (t[i] === close) { d--; if (d === 0) { end = i; break } }
+      }
+      const inner = end > 0 ? t.slice(1, end) : t.slice(1, -1)
+      for (const p of splitParameterList(inner)) push(p, depth + 1)
+      return
+    }
+    const m = t.replace(/^\.\.\./, '').match(/^([A-Za-z_$][A-Za-z0-9_$]*)(\?)?\s*(?::\s*([^=]+?))?(?:\s*=.*)?$/)
+    if (m) out.push({ name: m[1], type: (m[3] || 'any').trim(), optional: !!m[2] || t.includes('=') })
+  }
+  for (const part of splitParameterList(rawParams)) push(part, 0)
+  return out
+}
+
 function validateChunkDocs(chunk: any): string[] {
   const d = chunk.data || {}
   const errors: string[] = []
@@ -598,8 +738,7 @@ function validateChunkDocs(chunk: any): string[] {
   }
 
   if (!isModuleHeader && d.input_spec && d.input_spec !== 'none') {
-    const params = d.input_spec.split(/\n/).map((s: string) => s.trim()).filter(Boolean)
-    const paramNames = params.map(p => {
+    const paramNames = splitParameterList(d.input_spec).map(p => {
       const m = p.match(/^[-\s]*([a-zA-Z0-9_]+)/)
       return m ? m[1] : ''
     }).filter(Boolean)
@@ -608,12 +747,7 @@ function validateChunkDocs(chunk: any): string[] {
     const signatureMatch = code.match(/(?:function|const|let|var)\s+\w+\s*\(([^)]*)\)/)
     if (signatureMatch) {
       const rawParams = signatureMatch[1]
-      const declaredNames = rawParams
-        .split(',')
-        .map(s => s.trim())
-        .filter(s => s)
-        .map(s => s.split(/[:=]/)[0].trim().replace(/\?/, ''))
-        .filter(Boolean)
+      const declaredNames = expandParamEntries(rawParams).map(p => p.name)
       for (const declared of declaredNames) {
         if (!paramNames.includes(declared)) {
           errors.push(`undocumented parameter: ${declared}`)
@@ -624,26 +758,22 @@ function validateChunkDocs(chunk: any): string[] {
 
   return errors
 }
-
-
-
-
-
-// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_doc_validatechunkdocs_1784235266"]
-// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_doc_findexistingciljsdoc_1784235266" type="function" identity="findexistingciljsdoc" parent="none"]
-// CIL[DOC-MACRO purpose="Implements findexistingciljsdoc logic in cortex.functions.custom_cil-doc"]
-// CIL[DOC-RESPONSIBILITY responsibility="Execute findexistingciljsdoc and return its computed result"]
-// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-doc" layer="function" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="return value from function execution" errors="throws on invalid input or runtime failure" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Provides findexistingciljsdoc with findExistingCilJsDoc(lines: string[], markerIdx: number inputs, handling internal flow and returning a result" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: function. 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='Implements the validate chunk docs behavior for CIL documentation processing.'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/admin-data.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-doc.ts:validateChunkDocs:function"]
+
+// CIL[BEGIN stable_id="~/.framework/functions/cil-doc.ts:findExistingCilJsDoc:function" type="function" identity="findExistingCilJsDoc" parent="~/.framework/functions/cil-doc.ts"]
+// CIL[DOC-MACRO purpose="Implements the find existing cil js doc behavior for CIL documentation processing."]
+// CIL[DOC-RESPONSIBILITY responsibility="Carries out the find existing cil js doc responsibility within the documentation workflow."]
+// CIL[DOC-CONTEXT module="cil-doc" layer="app-specific" related_files=".framework/functions/_shared/cil.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/llm.ts,.framework/functions/_shared/middleware.ts,.framework/functions/admin-data.ts,.framework/functions/cil-doc.ts"]
+// CIL[DOC-CONTRACT inputs="lines: string[], markerIdx: number" outputs="void" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Computes the find existing cil js doc result from the provided input parameters." notable_decisions="none"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function findExistingCilJsDoc(lines: string[], markerIdx: number): { start: number; end: number } | null {
   let startIdx = -1
   for (let i = markerIdx + 1; i < lines.length; i++) {
@@ -664,26 +794,26 @@ function findExistingCilJsDoc(lines: string[], markerIdx: number): { start: numb
   if (endIdx === -1 || !hasCilTag) return null
   return { start: startIdx, end: endIdx }
 }
+// CIL[DOC-VECTOR type="context" content="purpose='Implements the find existing cil js doc behavior for CIL documentation processing.'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/admin-data.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-doc.ts:findExistingCilJsDoc:function"]
 
 
 
 
 
-// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_doc_findexistingciljsdoc_1784235266"]
-// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_doc_findlegacyciljsdocabove_1784235266" type="function" identity="findlegacyciljsdocabove" parent="none"]
-// CIL[DOC-MACRO purpose="Implements findlegacyciljsdocabove logic in cortex.functions.custom_cil-doc"]
-// CIL[DOC-RESPONSIBILITY responsibility="Execute findlegacyciljsdocabove and return its computed result"]
-// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-doc" layer="function" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="return value from function execution" errors="throws on invalid input or runtime failure" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Provides findlegacyciljsdocabove with findLegacyCilJsDocAbove(lines: string[], markerIdx: number inputs, handling internal flow and returning a result" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[BEGIN stable_id="~/.framework/functions/cil-doc.ts:findLegacyCilJsDocAbove:function" type="function" identity="findLegacyCilJsDocAbove" parent="~/.framework/functions/cil-doc.ts"]
+// CIL[DOC-MACRO purpose="Implements the find legacy cil js doc above behavior for CIL documentation processing."]
+// CIL[DOC-RESPONSIBILITY responsibility="Carries out the find legacy cil js doc above responsibility within the documentation workflow."]
+// CIL[DOC-CONTEXT module="cil-doc" layer="app-specific" related_files=".framework/functions/_shared/cil.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/llm.ts,.framework/functions/_shared/middleware.ts,.framework/functions/admin-data.ts,.framework/functions/cil-doc.ts"]
+// CIL[DOC-CONTRACT inputs="lines: string[], markerIdx: number" outputs="void" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Computes the find legacy cil js doc above result from the provided input parameters." notable_decisions="none"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
 // CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: function. 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"]
 function findLegacyCilJsDocAbove(lines: string[], markerIdx: number): { start: number; end: number } | null {
   let endIdx = -1
   for (let i = markerIdx - 1; i >= 0; i--) {
@@ -705,26 +835,26 @@ function findLegacyCilJsDocAbove(lines: string[], markerIdx: number): { start: n
 
   return { start: startIdx, end: endIdx }
 }
+// CIL[DOC-VECTOR type="context" content="purpose='Implements the find legacy cil js doc above behavior for CIL documentation processing.'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/admin-data.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-doc.ts:findLegacyCilJsDocAbove:function"]
 
 
 
 
 
-// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_doc_findlegacyciljsdocabove_1784235266"]
-// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_doc_writejsdoctosource_1784235266" type="function" identity="writejsdoctosource" parent="none"]
-// CIL[DOC-MACRO purpose="Implements writejsdoctosource logic in cortex.functions.custom_cil-doc"]
-// CIL[DOC-RESPONSIBILITY responsibility="Execute writejsdoctosource and return its computed result"]
-// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-doc" layer="function" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="return value from function execution" errors="throws on invalid input or runtime failure" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Provides writejsdoctosource with writeJsDocToSource(chunk: any, repoPath: string inputs, handling internal flow and returning a result" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[BEGIN stable_id="~/.framework/functions/cil-doc.ts:writeJsDocToSource:function" type="function" identity="writeJsDocToSource" parent="~/.framework/functions/cil-doc.ts"]
+// CIL[DOC-MACRO purpose="Implements the write js doc to source behavior for CIL documentation processing."]
+// CIL[DOC-RESPONSIBILITY responsibility="Carries out the write js doc to source responsibility within the documentation workflow."]
+// CIL[DOC-CONTEXT module="cil-doc" layer="app-specific" related_files=".framework/functions/_shared/cil.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/llm.ts,.framework/functions/_shared/middleware.ts,.framework/functions/admin-data.ts,.framework/functions/cil-doc.ts"]
+// CIL[DOC-CONTRACT inputs="chunk: any, repoPath: string" outputs="void" errors="none" side_effects="local file system access"]
+// CIL[DOC-MICRO logic_summary="Computes the write js doc to source result from the provided input parameters." notable_decisions="none"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
 // CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: function. 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"]
 function writeJsDocToSource(chunk: any, repoPath: string): void {
   const d = chunk.data || {}
   const relPath = d.file_path
@@ -765,27 +895,34 @@ function writeJsDocToSource(chunk: any, repoPath: string): void {
 
   fs.writeFileSync(absPath, newLines.join('\n'), 'utf-8')
 }
+// CIL[DOC-VECTOR type="context" content="purpose='Implements the write js doc to source behavior for CIL documentation processing.'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/admin-data.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-doc.ts:writeJsDocToSource:function"]
 
 
 
-// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_doc_writejsdoctosource_1784235266"]
-// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_doc_escaperegexp_1784235266" type="function" identity="escaperegexp" parent="none"]
-// CIL[DOC-MACRO purpose="Implements escaperegexp logic in cortex.functions.custom_cil-doc"]
-// CIL[DOC-RESPONSIBILITY responsibility="Execute escaperegexp and return its computed result"]
-// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-doc" layer="function" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="return value from function execution" errors="throws on invalid input or runtime failure" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Provides escaperegexp with escapeRegExp(s: string inputs, handling internal flow and returning a result" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[BEGIN stable_id="~/.framework/functions/cil-doc.ts:escapeRegExp:function" type="function" identity="escapeRegExp" parent="~/.framework/functions/cil-doc.ts"]
+// CIL[DOC-MACRO purpose="Implements the escape reg exp behavior for CIL documentation processing."]
+// CIL[DOC-RESPONSIBILITY responsibility="Carries out the escape reg exp responsibility within the documentation workflow."]
+// CIL[DOC-CONTEXT module="cil-doc" layer="app-specific" related_files=".framework/functions/_shared/cil.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/llm.ts,.framework/functions/_shared/middleware.ts,.framework/functions/admin-data.ts,.framework/functions/cil-doc.ts"]
+// CIL[DOC-CONTRACT inputs="s: string" outputs="string" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Computes the escape reg exp result from the provided input parameters." notable_decisions="none"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
 // CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: function. 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"]
 function escapeRegExp(s: string): string {
   return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')
 }
+// CIL[DOC-VECTOR type="context" content="purpose='Implements the escape reg exp behavior for CIL documentation processing.'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/admin-data.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-doc.ts:escapeRegExp:function"]
 
 
 
@@ -796,22 +933,22 @@ function escapeRegExp(s: string): string {
 
 
 
-// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_doc_escaperegexp_1784235266"]
-// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_doc_chunk_start_marker_re_1784235266" type="variable" identity="chunk_start_marker_re" parent="none"]
-// CIL[DOC-MACRO purpose="Defines chunk_start_marker_re configuration or state in cortex.functions.custom_cil-doc"]
-// CIL[DOC-RESPONSIBILITY responsibility="Hold the value and default configuration for chunk_start_marker_re"]
-// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-doc" layer="function" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="value of chunk_start_marker_re" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Declares chunk_start_marker_re with initial value or constant binding used by cortex.functions.custom_cil-doc" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[BEGIN stable_id="~/.framework/functions/cil-doc.ts:CHUNK_START_MARKER_RE:constant" type="constant" identity="CHUNK_START_MARKER_RE" parent="~/.framework/functions/cil-doc.ts"]
+// CIL[DOC-MACRO purpose="Declares the c h u n k_ s t a r t_ m a r k e r_ r e constant used by the documentation pipeline."]
+// CIL[DOC-RESPONSIBILITY responsibility="Provides the c h u n k_ s t a r t_ m a r k e r_ r e value used across documentation operations."]
+// CIL[DOC-CONTEXT module="cil-doc" layer="app-specific" related_files=".framework/functions/_shared/cil.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/llm.ts,.framework/functions/_shared/middleware.ts,.framework/functions/admin-data.ts,.framework/functions/cil-doc.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="none" notable_decisions="none"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
 // CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: function. Direct callers: 0. Direct calls: 0. Related files: none."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+const CHUNK_START_MARKER_RE = /^\s*\/\/\s*CIL\[BEGIN\s+[^\]]*identity="([^"]+)"[^\]]*\]\s*$/
+// CIL[DOC-VECTOR type="context" content="purpose='Declares the c h u n k_ s t a r t_ m a r k e r_ r e constant used by the documentation pipeline.'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/admin-data.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"]
-const CHUNK_START_MARKER_RE = /^\s*\/\*\*\s*[─\-]+\s*CHUNK_START:\s*(?:PROPOSAL\s+|REJECTED\s+)?(.+?)\s*[─\-]*\s*\*\/\s*$/
+// CIL[END stable_id="~/.framework/functions/cil-doc.ts:CHUNK_START_MARKER_RE:constant"]
 
 
 
@@ -822,21 +959,14 @@ const CHUNK_START_MARKER_RE = /^\s*\/\*\*\s*[─\-]+\s*CHUNK_START:\s*(?:PROPOSA
 
 
 
-// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_doc_chunk_start_marker_re_1784235266"]
-// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_doc_findchunkstartmarkers_1784235266" type="function" identity="findchunkstartmarkers" parent="none"]
-// CIL[DOC-MACRO purpose="Implements findchunkstartmarkers logic in cortex.functions.custom_cil-doc"]
-// CIL[DOC-RESPONSIBILITY responsibility="Execute findchunkstartmarkers and return its computed result"]
-// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-doc" layer="function" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="return value from function execution" errors="throws on invalid input or runtime failure" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Provides findchunkstartmarkers with findChunkStartMarkers(lines: string[] inputs, handling internal flow and returning a result" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[BEGIN stable_id="~/.framework/functions/cil-doc.ts:findChunkStartMarkers:function" type="function" identity="findChunkStartMarkers" parent="~/.framework/functions/cil-doc.ts"]
+// CIL[DOC-MACRO purpose="Implements the find chunk start markers behavior for CIL documentation processing."]
+// CIL[DOC-RESPONSIBILITY responsibility="Carries out the find chunk start markers responsibility within the documentation workflow."]
+// CIL[DOC-CONTEXT module="cil-doc" layer="app-specific" related_files=".framework/functions/_shared/cil.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/llm.ts,.framework/functions/_shared/middleware.ts,.framework/functions/admin-data.ts,.framework/functions/cil-doc.ts"]
+// CIL[DOC-CONTRACT inputs="lines: string[]" outputs="Map<string," errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Computes the find chunk start markers result from the provided input parameters." notable_decisions="none"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
 // CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: function. 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"]
 function findChunkStartMarkers(lines: string[]): Map<string, number> {
   const map = new Map<string, number>()
   for (let i = 0; i < lines.length; i++) {
@@ -848,6 +978,13 @@ function findChunkStartMarkers(lines: string[]): Map<string, number> {
   }
   return map
 }
+// CIL[DOC-VECTOR type="context" content="purpose='Implements the find chunk start markers behavior for CIL documentation processing.'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/admin-data.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-doc.ts:findChunkStartMarkers:function"]
 
 
 
@@ -855,27 +992,27 @@ function findChunkStartMarkers(lines: string[]): Map<string, number> {
 
 
 
-// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_doc_findchunkstartmarkers_1784235266"]
-// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_doc_builddocprompt_1784235266" type="function" identity="builddocprompt" parent="none"]
-// CIL[DOC-MACRO purpose="Implements builddocprompt logic in cortex.functions.custom_cil-doc"]
-// CIL[DOC-RESPONSIBILITY responsibility="Execute builddocprompt and return its computed result"]
-// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-doc" layer="function" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="return value from function execution" errors="throws on invalid input or runtime failure" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Provides builddocprompt with buildDocPrompt(chunk: any inputs, handling internal flow and returning a result" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[BEGIN stable_id="~/.framework/functions/cil-doc.ts:buildDocPrompt:function" type="function" identity="buildDocPrompt" parent="~/.framework/functions/cil-doc.ts"]
+// CIL[DOC-MACRO purpose="Implements the build doc prompt behavior for CIL documentation processing."]
+// CIL[DOC-RESPONSIBILITY responsibility="Carries out the build doc prompt responsibility within the documentation workflow."]
+// CIL[DOC-CONTEXT module="cil-doc" layer="app-specific" related_files=".framework/functions/_shared/cil.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/llm.ts,.framework/functions/_shared/middleware.ts,.framework/functions/admin-data.ts,.framework/functions/cil-doc.ts"]
+// CIL[DOC-CONTRACT inputs="chunk: any" outputs="string" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Computes the build doc prompt result from the provided input parameters." notable_decisions="none"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
 // CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: function. 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"]
 function buildDocPrompt(chunk: any): string {
   const d = chunk.data || {}
   const code = (d.code_content || '').slice(0, 3000)
   const isModuleHeader = d.chunk_type === 'module_header'
   return isModuleHeader ? buildModuleHeaderPrompt(d, code) : buildChunkPrompt(d, code)
 }
+// CIL[DOC-VECTOR type="context" content="purpose='Implements the build doc prompt behavior for CIL documentation processing.'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/admin-data.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-doc.ts:buildDocPrompt:function"]
 
 
 
@@ -886,21 +1023,14 @@ function buildDocPrompt(chunk: any): string {
 
 
 
-// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_doc_builddocprompt_1784235266"]
-// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_doc_buildmoduleheaderprompt_1784235266" type="function" identity="buildmoduleheaderprompt" parent="none"]
-// CIL[DOC-MACRO purpose="Implements buildmoduleheaderprompt logic in cortex.functions.custom_cil-doc"]
-// CIL[DOC-RESPONSIBILITY responsibility="Execute buildmoduleheaderprompt and return its computed result"]
-// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-doc" layer="function" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="return value from function execution" errors="throws on invalid input or runtime failure" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Provides buildmoduleheaderprompt with buildModuleHeaderPrompt(d: any, code: string inputs, handling internal flow and returning a result" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[BEGIN stable_id="~/.framework/functions/cil-doc.ts:buildModuleHeaderPrompt:function" type="function" identity="buildModuleHeaderPrompt" parent="~/.framework/functions/cil-doc.ts"]
+// CIL[DOC-MACRO purpose="Implements the build module header prompt behavior for CIL documentation processing."]
+// CIL[DOC-RESPONSIBILITY responsibility="Carries out the build module header prompt responsibility within the documentation workflow."]
+// CIL[DOC-CONTEXT module="cil-doc" layer="app-specific" related_files=".framework/functions/_shared/cil.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/llm.ts,.framework/functions/_shared/middleware.ts,.framework/functions/admin-data.ts,.framework/functions/cil-doc.ts"]
+// CIL[DOC-CONTRACT inputs="d: any, code: string" outputs="string" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Computes the build module header prompt result from the provided input parameters." notable_decisions="none"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
 // CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: function. 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"]
 function buildModuleHeaderPrompt(d: any, code: string): string {
   const filePath = d.file_path || 'unknown'
   return `You are documenting the MODULE HEADER for file: ${filePath}
@@ -935,6 +1065,13 @@ Respond ONLY with a JSON object (no markdown, no commentary):
   "tags": "<comma-separated relevant tags>"
 }`
 }
+// CIL[DOC-VECTOR type="context" content="purpose='Implements the build module header prompt behavior for CIL documentation processing.'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/admin-data.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-doc.ts:buildModuleHeaderPrompt:function"]
 
 
 
@@ -945,21 +1082,14 @@ Respond ONLY with a JSON object (no markdown, no commentary):
 
 
 
-// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_doc_buildmoduleheaderprompt_1784235266"]
-// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_doc_buildchunkprompt_1784235266" type="function" identity="buildchunkprompt" parent="none"]
-// CIL[DOC-MACRO purpose="Implements buildchunkprompt logic in cortex.functions.custom_cil-doc"]
-// CIL[DOC-RESPONSIBILITY responsibility="Execute buildchunkprompt and return its computed result"]
-// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-doc" layer="function" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="return value from function execution" errors="throws on invalid input or runtime failure" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Provides buildchunkprompt with buildChunkPrompt(d: any, code: string inputs, handling internal flow and returning a result" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[BEGIN stable_id="~/.framework/functions/cil-doc.ts:buildChunkPrompt:function" type="function" identity="buildChunkPrompt" parent="~/.framework/functions/cil-doc.ts"]
+// CIL[DOC-MACRO purpose="Implements the build chunk prompt behavior for CIL documentation processing."]
+// CIL[DOC-RESPONSIBILITY responsibility="Carries out the build chunk prompt responsibility within the documentation workflow."]
+// CIL[DOC-CONTEXT module="cil-doc" layer="app-specific" related_files=".framework/functions/_shared/cil.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/llm.ts,.framework/functions/_shared/middleware.ts,.framework/functions/admin-data.ts,.framework/functions/cil-doc.ts"]
+// CIL[DOC-CONTRACT inputs="d: any, code: string" outputs="string" errors="none" side_effects="Supabase database queries and updates"]
+// CIL[DOC-MICRO logic_summary="Computes the build chunk prompt result from the provided input parameters." notable_decisions="none"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
 // CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: function. 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"]
 function buildChunkPrompt(d: any, code: string): string {
   const chunkType = d.chunk_type || 'function'
   const chunkName = d.chunk_name || 'unknown'
@@ -1026,6 +1156,13 @@ Respond ONLY with a JSON object (no markdown, no commentary):
   "tags": "<comma-separated tags>"
 }`
 }
+// CIL[DOC-VECTOR type="context" content="purpose='Implements the build chunk prompt behavior for CIL documentation processing.'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/admin-data.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-doc.ts:buildChunkPrompt:function"]
 
 
 
@@ -1035,21 +1172,14 @@ Respond ONLY with a JSON object (no markdown, no commentary):
 
 
 
-// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_doc_buildchunkprompt_1784235266"]
-// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_doc_callllm_1784235266" type="function" identity="callllm" parent="none"]
-// CIL[DOC-MACRO purpose="Implements callllm logic in cortex.functions.custom_cil-doc"]
-// CIL[DOC-RESPONSIBILITY responsibility="Execute callllm and return its computed result"]
-// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-doc" layer="function" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="return value from function execution" errors="throws on invalid input or runtime failure" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Provides callllm with callLLM(prompt: string, model: string inputs, handling internal flow and returning a result" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[BEGIN stable_id="~/.framework/functions/cil-doc.ts:callLLM:function" type="function" identity="callLLM" parent="~/.framework/functions/cil-doc.ts"]
+// CIL[DOC-MACRO purpose="Implements the call l l m behavior for CIL documentation processing."]
+// CIL[DOC-RESPONSIBILITY responsibility="Carries out the call l l m responsibility within the documentation workflow."]
+// CIL[DOC-CONTEXT module="cil-doc" layer="app-specific" related_files=".framework/functions/_shared/cil.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/llm.ts,.framework/functions/_shared/middleware.ts,.framework/functions/admin-data.ts,.framework/functions/cil-doc.ts"]
+// CIL[DOC-CONTRACT inputs="prompt: string, model: string" outputs="Promise<string>" errors="none" side_effects="OpenAI chat API call"]
+// CIL[DOC-MICRO logic_summary="Computes the call l l m result from the provided input parameters." notable_decisions="none"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
 // CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: function. 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"]
 async function callLLM(prompt: string, model: string): Promise<string> {
   const j = await callOpenAIChat(undefined, [
     {
@@ -1064,26 +1194,26 @@ async function callLLM(prompt: string, model: string): Promise<string> {
   })
   return j.choices?.[0]?.message?.content?.trim() || '{}'
 }
+// CIL[DOC-VECTOR type="context" content="purpose='Implements the call l l m behavior for CIL documentation processing.'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/admin-data.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-doc.ts:callLLM:function"]
 
 
 
 
 
-// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_doc_callllm_1784235266"]
-// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_doc_parsedocresponse_1784235266" type="function" identity="parsedocresponse" parent="none"]
-// CIL[DOC-MACRO purpose="Implements parsedocresponse logic in cortex.functions.custom_cil-doc"]
-// CIL[DOC-RESPONSIBILITY responsibility="Execute parsedocresponse and return its computed result"]
-// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-doc" layer="function" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="return value from function execution" errors="throws on invalid input or runtime failure" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Provides parsedocresponse with parseDocResponse(raw: string inputs, handling internal flow and returning a result" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[BEGIN stable_id="~/.framework/functions/cil-doc.ts:parseDocResponse:function" type="function" identity="parseDocResponse" parent="~/.framework/functions/cil-doc.ts"]
+// CIL[DOC-MACRO purpose="Implements the parse doc response behavior for CIL documentation processing."]
+// CIL[DOC-RESPONSIBILITY responsibility="Carries out the parse doc response responsibility within the documentation workflow."]
+// CIL[DOC-CONTEXT module="cil-doc" layer="app-specific" related_files=".framework/functions/_shared/cil.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/llm.ts,.framework/functions/_shared/middleware.ts,.framework/functions/admin-data.ts,.framework/functions/cil-doc.ts"]
+// CIL[DOC-CONTRACT inputs="raw: string" outputs="Record<string," errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Computes the parse doc response result from the provided input parameters." notable_decisions="none"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
 // CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: function. 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"]
 function parseDocResponse(raw: string): Record<string, string> {
   try {
     
@@ -1119,6 +1249,13 @@ function parseDocResponse(raw: string): Record<string, string> {
     return {}
   }
 }
+// CIL[DOC-VECTOR type="context" content="purpose='Implements the parse doc response behavior for CIL documentation processing.'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/admin-data.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-doc.ts:parseDocResponse:function"]
 
 
 
@@ -1128,25 +1265,25 @@ function parseDocResponse(raw: string): Record<string, string> {
 
 
 
-// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_doc_parsedocresponse_1784235266"]
-// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_doc_hasmeaningfulllmfields_1784235266" type="function" identity="hasmeaningfulllmfields" parent="none"]
-// CIL[DOC-MACRO purpose="Implements hasmeaningfulllmfields logic in cortex.functions.custom_cil-doc"]
-// CIL[DOC-RESPONSIBILITY responsibility="Execute hasmeaningfulllmfields and return its computed result"]
-// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-doc" layer="function" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="return value from function execution" errors="throws on invalid input or runtime failure" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Provides hasmeaningfulllmfields with hasMeaningfulLlmFields(fields: Record<string, string> inputs, handling internal flow and returning a result" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[BEGIN stable_id="~/.framework/functions/cil-doc.ts:hasMeaningfulLlmFields:function" type="function" identity="hasMeaningfulLlmFields" parent="~/.framework/functions/cil-doc.ts"]
+// CIL[DOC-MACRO purpose="Implements the has meaningful llm fields behavior for CIL documentation processing."]
+// CIL[DOC-RESPONSIBILITY responsibility="Carries out the has meaningful llm fields responsibility within the documentation workflow."]
+// CIL[DOC-CONTEXT module="cil-doc" layer="app-specific" related_files=".framework/functions/_shared/cil.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/llm.ts,.framework/functions/_shared/middleware.ts,.framework/functions/admin-data.ts,.framework/functions/cil-doc.ts"]
+// CIL[DOC-CONTRACT inputs="fields: Record<string, string>" outputs="boolean" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Computes the has meaningful llm fields result from the provided input parameters." notable_decisions="none"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
 // CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: function. 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"]
 function hasMeaningfulLlmFields(fields: Record<string, string>): boolean {
   const meaningfulKeys = ['description', 'macro', 'micro', 'input_spec', 'output_spec']
   return meaningfulKeys.some(k => (fields[k] || '').trim() !== '')
 }
+// CIL[DOC-VECTOR type="context" content="purpose='Implements the has meaningful llm fields behavior for CIL documentation processing.'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/admin-data.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-doc.ts:hasMeaningfulLlmFields:function"]
 
 
 
@@ -1154,21 +1291,14 @@ function hasMeaningfulLlmFields(fields: Record<string, string>): boolean {
 
 
 
-// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_doc_hasmeaningfulllmfields_1784235266"]
-// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_doc_normalizedocfields_1784235266" type="function" identity="normalizedocfields" parent="none"]
-// CIL[DOC-MACRO purpose="Implements normalizedocfields logic in cortex.functions.custom_cil-doc"]
-// CIL[DOC-RESPONSIBILITY responsibility="Execute normalizedocfields and return its computed result"]
-// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-doc" layer="function" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="return value from function execution" errors="throws on invalid input or runtime failure" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Provides normalizedocfields with normalizeDocFields(fields: Record<string, string>, chunk: any inputs, handling internal flow and returning a result" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[BEGIN stable_id="~/.framework/functions/cil-doc.ts:normalizeDocFields:function" type="function" identity="normalizeDocFields" parent="~/.framework/functions/cil-doc.ts"]
+// CIL[DOC-MACRO purpose="Implements the normalize doc fields behavior for CIL documentation processing."]
+// CIL[DOC-RESPONSIBILITY responsibility="Carries out the normalize doc fields responsibility within the documentation workflow."]
+// CIL[DOC-CONTEXT module="cil-doc" layer="app-specific" related_files=".framework/functions/_shared/cil.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/llm.ts,.framework/functions/_shared/middleware.ts,.framework/functions/admin-data.ts,.framework/functions/cil-doc.ts"]
+// CIL[DOC-CONTRACT inputs="fields: Record<string, string>, chunk: any" outputs="Record<string," errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Computes the normalize doc fields result from the provided input parameters." notable_decisions="none"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
 // CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: function. 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"]
 function normalizeDocFields(fields: Record<string, string>, chunk: any): Record<string, string> {
   const d = chunk.data || {}
   const isModuleHeader = d.chunk_type === 'module_header'
@@ -1194,13 +1324,14 @@ function normalizeDocFields(fields: Record<string, string>, chunk: any): Record<
     
     
     
-    const macroFromLlm = fields.macro  
-    const microFromLlm = fields.micro
-    if (macroFromLlm === undefined || macroFromLlm === null) {
+    const macroFromLlm = (fields.macro || '').trim()
+    const microFromLlm = (fields.micro || '').trim()
+    if (!macroFromLlm) {
       normalized.macro = normalized.description.split(/(?<=[.!?])\s+/)[0] || normalized.description
     }
-    if (microFromLlm === undefined || microFromLlm === null) {
-      normalized.micro = ''  
+    if (!microFromLlm) {
+      const rest = normalized.description.split(/(?<=[.!?])\s+/).slice(1).join(' ').trim()
+      normalized.micro = rest || normalized.description
     }
 
     
@@ -1209,11 +1340,7 @@ function normalizeDocFields(fields: Record<string, string>, chunk: any): Record<
       if (isCallable) {
         const sigMatch = code.match(/(?:function|const|let|var)\s+\w+\s*\(([^)]*)\)|(?:async\s+)?function\s*\(([^)]*)\)/)
         const paramStr = sigMatch?.[1] || sigMatch?.[2] || ''
-        const params = paramStr.split(',').map(s => s.trim()).filter(Boolean).map(p => {
-          const [name, type] = p.split(/[:=]/).map(s => s.trim())
-          const optional = p.includes('?')
-          return `- ${name.replace(/\?$/, '')}: ${type || 'any'} (${optional ? 'optional' : 'required'})`
-        })
+        const params = expandParamEntries(paramStr).map(p => `- ${p.name}: ${p.type} (${p.optional ? 'optional' : 'required'})`)
         normalized.input_spec = params.length ? params.join('\n') : 'none'
       } else {
         normalized.input_spec = 'none'
@@ -1242,26 +1369,26 @@ function normalizeDocFields(fields: Record<string, string>, chunk: any): Record<
 
   return normalized
 }
+// CIL[DOC-VECTOR type="context" content="purpose='Implements the normalize doc fields behavior for CIL documentation processing.'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/admin-data.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-doc.ts:normalizeDocFields:function"]
 
 
 
 
 
-// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_doc_normalizedocfields_1784235266"]
-// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_doc_documentchunk_1784235266" type="function" identity="documentchunk" parent="none"]
-// CIL[DOC-MACRO purpose="Implements documentchunk logic in cortex.functions.custom_cil-doc"]
-// CIL[DOC-RESPONSIBILITY responsibility="Execute documentchunk and return its computed result"]
-// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-doc" layer="function" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="return value from function execution" errors="throws on invalid input or runtime failure" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Provides documentchunk with documentChunk( inputs, handling internal flow and returning a result" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[BEGIN stable_id="~/.framework/functions/cil-doc.ts:documentChunk:function" type="function" identity="documentChunk" parent="~/.framework/functions/cil-doc.ts"]
+// CIL[DOC-MACRO purpose="Implements the document chunk behavior for CIL documentation processing."]
+// CIL[DOC-RESPONSIBILITY responsibility="Carries out the document chunk responsibility within the documentation workflow."]
+// CIL[DOC-CONTEXT module="cil-doc" layer="app-specific" related_files=".framework/functions/_shared/cil.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/llm.ts,.framework/functions/_shared/middleware.ts,.framework/functions/admin-data.ts,.framework/functions/cil-doc.ts"]
+// CIL[DOC-CONTRACT inputs="ctx: any,   chunk: any,   model: string,   force: boolean,   repoPath?: string" outputs="Promise<" errors="none" side_effects="Supabase database queries and updates"]
+// CIL[DOC-MICRO logic_summary="Computes the document chunk result from the provided input parameters." notable_decisions="Writes generated fields to the database and optionally persists JSDoc back to the source file."]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
 // CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: function. 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"]
 async function documentChunk(
   ctx: any,
   chunk: any,
@@ -1275,7 +1402,8 @@ async function documentChunk(
 
   const d = chunk.data || {}
   if (!d.code_content && !d.chunk_name) {
-    return { success: false, fields_set: [], error: 'No code content to document' }
+    const ref = d.stable_id || d.chunk_name || chunk.id
+    return { success: false, fields_set: [], error: `No code content to document: ${ref}` }
   }
 
   const prompt = buildDocPrompt(chunk)
@@ -1328,26 +1456,26 @@ async function documentChunk(
 
   return { success: true, fields_set: Object.keys(toWrite), updatedChunk }
 }
+// CIL[DOC-VECTOR type="context" content="purpose='Implements the document chunk behavior for CIL documentation processing.'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/admin-data.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-doc.ts:documentChunk:function"]
 
 
 
 
 
-// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_doc_documentchunk_1784235266"]
-// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_doc_handler_1784235266" type="variable" identity="handler" parent="none"]
-// CIL[DOC-MACRO purpose="Defines handler configuration or state in cortex.functions.custom_cil-doc"]
-// CIL[DOC-RESPONSIBILITY responsibility="Hold the value and default configuration for handler"]
-// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-doc" layer="function" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="value of handler" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Declares handler with initial value or constant binding used by cortex.functions.custom_cil-doc" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[BEGIN stable_id="~/.framework/functions/cil-doc.ts:handler:constant" type="constant" identity="handler" parent="~/.framework/functions/cil-doc.ts"]
+// CIL[DOC-MACRO purpose="Netlify handler that dispatches documentation-related HTTP actions."]
+// CIL[DOC-RESPONSIBILITY responsibility="Routes documentation actions to the appropriate sub-handler and returns JSON responses."]
+// CIL[DOC-CONTEXT module="cil-doc" layer="app-specific" related_files=".framework/functions/_shared/cil.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/llm.ts,.framework/functions/_shared/middleware.ts,.framework/functions/admin-data.ts,.framework/functions/cil-doc.ts"]
+// CIL[DOC-CONTRACT inputs="ctx: any, body: any" outputs="Promise<any>" errors="Throws Error on invalid input or missing resources" side_effects="Supabase database queries and updates; local file system access"]
+// CIL[DOC-MICRO logic_summary="Uses query.action to route to estimate, gap_report, document, doc_chunk, or validate logic." notable_decisions="Supports estimate, gap_report, document, doc_chunk, and validate actions."]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
 // CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: function. 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"]
 export const handler = createHandler(async (ctx, body) => {
   const action = ctx.query?.action
 
@@ -1374,6 +1502,7 @@ export const handler = createHandler(async (ctx, body) => {
         ? Math.round((documented.length / chunks.length) * 100) : 0,
       undocumented: undocumented.slice(0, 100).map(c => ({
         id: c.id,
+        stable_id: c.data?.stable_id || null,
         chunk_name: c.data?.chunk_name || c.title,
         file_path: c.data?.file_path || '',
         chunk_type: c.data?.chunk_type || '',
@@ -1403,6 +1532,7 @@ export const handler = createHandler(async (ctx, body) => {
       const inputTokens = estimateTokens(prompt) + SYSTEM_PROMPT_OVERHEAD_TOKENS
       totalInputTokens += inputTokens
       breakdown.push({
+        stable_id: chunk.data?.stable_id || null,
         chunk_name: chunk.data?.chunk_name || chunk.title,
         file_path: chunk.data?.file_path || '',
         input_tokens: inputTokens,
@@ -1441,18 +1571,10 @@ export const handler = createHandler(async (ctx, body) => {
 
   
   if (action === 'doc_chunk') {
-    const chunkId = body?.chunk_id || ctx.query?.chunk_id
     const model = body?.model || ctx.query?.model || DEFAULT_MODEL
     const force = body?.force ?? false
-    if (!chunkId) throw new Error('chunk_id is required')
-
-    const { data: chunk, error } = await adminDb
-      .from('items')
-      .select('id, title, data')
-      .eq('id', chunkId)
-      .maybeSingle()
-
-    if (error || !chunk) throw new Error(`Chunk not found: ${chunkId}`)
+    const chunk = await resolveChunk(ctx, body)
+    const chunkId = chunk.id
 
     const projectId = chunk.data?.project_id
     let repoPath = ''
@@ -1462,7 +1584,7 @@ export const handler = createHandler(async (ctx, body) => {
     }
 
     const result = await documentChunk(ctx, chunk, model, force, repoPath)
-    return { chunk_id: chunkId, chunk_name: chunk.data?.chunk_name || chunk.title, ...result }
+    return { chunk_id: chunkId, chunk_name: chunk.data?.chunk_name || chunk.title, stable_id: chunk.data?.stable_id || null, ...result }
   }
 
   
@@ -1480,6 +1602,7 @@ export const handler = createHandler(async (ctx, body) => {
       if (errors.length > 0) {
         invalid.push({
           chunk_id: chunk.id,
+          stable_id: chunk.data?.stable_id || null,
           chunk_name: chunk.data?.chunk_name || chunk.title,
           file_path: chunk.data?.file_path || '',
           chunk_type: chunk.data?.chunk_type || '',
@@ -1546,7 +1669,7 @@ export const handler = createHandler(async (ctx, body) => {
       stableList = data || []
     } else if (selectedPaths.length > 0 && !filePath) {
       
-      stableList = await loadPendingChunks(projectId, selectedPaths, 'pass2_complete')
+      stableList = await loadPendingChunks(projectId, selectedPaths, '2-chunked')
     } else {
       stableList = await loadAllChunks(projectId, filePath)
     }
@@ -1583,7 +1706,8 @@ export const handler = createHandler(async (ctx, body) => {
       const subResults = await Promise.all(subBatch.map(async chunk => {
         const d = chunk.data || {}
         if (!d.code_content && !d.chunk_name) {
-          return { chunk, fields: null, error: 'No code content' }
+          const ref = d.stable_id || d.chunk_name || chunk.id
+          return { chunk, fields: null, error: `No code content: ${ref}` }
         }
         const prompt = buildDocPrompt(chunk)
         try {
@@ -1610,7 +1734,7 @@ export const handler = createHandler(async (ctx, body) => {
 
     await Promise.all(results.map(async ({ chunk, fields, is_fallback, error: llmError }) => {
       if (!fields) {
-        if (llmError) { failed++; errors.push(`${chunk.data?.chunk_name || chunk.id}: ${llmError}`) }
+        if (llmError) { failed++; errors.push(`${chunk.data?.stable_id || chunk.data?.chunk_name || chunk.id}: ${llmError}`) }
         else skipped++
         return
       }
@@ -1629,7 +1753,7 @@ export const handler = createHandler(async (ctx, body) => {
       const chunkUpdateCtx = { ...ctx, query: { ...ctx.query, entity: 'items', id: chunk.id } }
       if (validationErrors.length > 0) {
         failed++
-        errors.push(`${chunk.data?.chunk_name || chunk.id}: ${validationErrors.join(', ')}`)
+        errors.push(`${chunk.data?.stable_id || chunk.data?.chunk_name || chunk.id}: ${validationErrors.join(', ')}`)
         await adminUpdate(chunkUpdateCtx, { data: { ...updatedData, doc_validation_errors: validationErrors } })
           .catch(() => { /* non-fatal — don't mask original validation error */ })
         return
@@ -1638,7 +1762,7 @@ export const handler = createHandler(async (ctx, body) => {
       try {
         await adminUpdate(chunkUpdateCtx, { data: updatedData })
       } catch (updateError: any) {
-        failed++; errors.push(`${chunk.data?.chunk_name || chunk.id}: ${updateError.message}`)
+        failed++; errors.push(`${chunk.data?.stable_id || chunk.data?.chunk_name || chunk.id}: ${updateError.message}`)
         return
       }
       {
@@ -1677,14 +1801,14 @@ export const handler = createHandler(async (ctx, body) => {
             .sort((a, b) => b.markerIdx - a.markerIdx)
           const missed = chunks
             .filter(c => markerMap.get((c.data?.chunk_name || c.title).trim().toLowerCase()) === undefined)
-            .map(c => c.data?.chunk_name || c.title)
+            .map(c => c.data?.stable_id || c.data?.chunk_name || c.title)
           if (missed.length > 0) {
             errors.push(`Write-back: could not find markers for ${missed.join(', ')} in ${relPath}`)
           }
           for (const { chunk, markerIdx } of sorted) {
             const jsDoc = buildJsDoc(chunk)
             if (!jsDoc) {
-              errors.push(`Write-back: no JSDoc built for ${chunk.data?.chunk_name || chunk.title}`)
+              errors.push(`Write-back: no JSDoc built for ${chunk.data?.stable_id || chunk.data?.chunk_name || chunk.title}`)
               continue
             }
             const existing = findExistingCilJsDoc(newLines, markerIdx)
@@ -1745,8 +1869,13 @@ export const handler = createHandler(async (ctx, body) => {
 
   throw new Error(`Unknown action: ${action}. Valid: estimate, gap_report, document, doc_chunk, validate`)
 })
+// CIL[DOC-VECTOR type="context" content="purpose='Netlify handler that dispatches documentation-related HTTP actions.'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/admin-data.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-doc.ts:handler:constant"]
 
 
 
-
-// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_doc_handler_1784235266"]