spine-framework 0.3.124 → 0.3.126

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

@@ -0,0 +1,1227 @@
+
+const MAP_SOURCE_STATUS: Record<'first' | 'second', { prior: string; target: string }> = {
+  first: { prior: '6-embedded', target: '7-mapped' },
+  second: { prior: '9-embedded', target: '10-mapped' },
+}
+
+function getMapSourceFilePaths(projectItem: any, secondPass: boolean): string[] {
+  const fileStatuses: Record<string, string> = projectItem?.data?.file_statuses || {}
+  const { prior } = secondPass ? MAP_SOURCE_STATUS.second : MAP_SOURCE_STATUS.first
+  return Object.entries(fileStatuses)
+    .filter(([, status]) => status === prior)
+    .map(([filePath]) => filePath)
+}
+
+// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_callmap_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-callmap"]
+// CIL[DOC-RESPONSIBILITY responsibility="Own module-level imports, exports, and configuration for cortex.functions.custom_cil-callmap"]
+// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-callmap" layer="function" related_files="[\".framework/migrations/015_simplify_apps_table.sql\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/src/components/ui/table-primitives.tsx\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\"\\\"]"]
+// 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-callmap" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-AUDIENCE audience="developer"]
+// CIL[DOC-VECTOR type="context" content="Layer: function. Direct callers: 0. Direct calls: 0. Related files: .framework/migrations/015_simplify_apps_table.sql, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, custom/apps/portal/pages/ContentPage.tsx, .framework/src/components/ui/table-primitives.tsx, .framework/src/pages/admin/TypeDetailPage.tsx, \."]
+// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
+// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
+// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+
+
+
+
+
+import { createHandler } from './_shared/middleware'
+import { adminDb } from './_shared/db'
+import { resolveLinkTypeId } from './_shared/resolve-ids'
+import { create as adminCreate, update as adminUpdate } from './admin-data'
+import { FileStatus, FileTreeNode, isSelectedPath, getFileStatus, updateTreeNodeStatus, saveProjectTree } from './_shared/cil'
+import * as fs from 'fs'
+import * as path from 'path'
+
+
+
+
+
+
+
+
+
+// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_callmap_module_header_1784235266"]
+// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_callmap_status_rank_1784235266" type="variable" identity="status_rank" parent="none"]
+// CIL[DOC-MACRO purpose="Defines status_rank configuration or state in cortex.functions.custom_cil-callmap"]
+// CIL[DOC-RESPONSIBILITY responsibility="Hold the value and default configuration for status_rank"]
+// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-callmap" layer="function" related_files="[\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/functions/_shared/principal.ts\",\"custom/apps/cortex/functions/custom_cil-embeddings.ts\",\".framework/src/pages/admin/IntegrationsPage.tsx\",\"custom/apps/portal/pages/ContentPage.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="value of status_rank" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Declares status_rank with initial value or constant binding used by cortex.functions.custom_cil-callmap" 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: .framework/src/pages/admin/TypeDetailPage.tsx, .framework/functions/_shared/principal.ts, custom/apps/cortex/functions/custom_cil-embeddings.ts, .framework/src/pages/admin/IntegrationsPage.tsx, custom/apps/portal/pages/ContentPage.tsx, \."]
+// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
+// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
+// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+const STATUS_RANK: Record<string, number> = {
+  '2-discovered': 2,
+  '3-selected': 3,
+  '4-chunked': 4,
+  '5-documented': 5,
+  '6-embedded': 6,
+  '7-mapped': 7,
+  '8-enriched': 8,
+  '9-embedded': 9,
+  '10-mapped': 10,
+  
+  'pass2_complete': 4,
+  'pass3_complete': 5,
+  'pass4_complete': 6,
+  'pass4b_complete': 7,
+  'pass6_complete': 8,
+  'pass7_complete': 9,
+  'pass8_complete': 10,
+}
+
+// Keep REST URL length under the ~8k character limit for UUID IN clauses.
+const UUID_IN_LIMIT = 100
+
+
+
+
+
+
+// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_callmap_status_rank_1784235266"]
+// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_callmap_rank_1784235266" type="function" identity="rank" parent="none"]
+// CIL[DOC-MACRO purpose="Implements rank logic in cortex.functions.custom_cil-callmap"]
+// CIL[DOC-RESPONSIBILITY responsibility="Execute rank and return its computed result"]
+// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-callmap" layer="function" related_files="[\"custom/apps/cortex/functions/custom_cil-embeddings.ts\",\".framework/functions/_shared/principal.ts\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/src/pages/admin/IntegrationsPage.tsx\",\".framework/migrations/015_simplify_apps_table.sql\",\"\\\"]"]
+// 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 rank with rank(status: string | undefined 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: 2. Direct calls: 0. Related files: custom/apps/cortex/functions/custom_cil-embeddings.ts, .framework/functions/_shared/principal.ts, .framework/src/pages/admin/TypeDetailPage.tsx, .framework/src/pages/admin/IntegrationsPage.tsx, .framework/migrations/015_simplify_apps_table.sql, \."]
+// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 2. Total affected: 2."]
+// 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 rank(status: string | undefined): number {
+  return status ? STATUS_RANK[status] || 0 : 0
+}
+
+
+
+
+
+
+
+
+
+// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_callmap_rank_1784235266"]
+// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_callmap_extractedimport_1784235266" type="interface" identity="extractedimport" parent="none"]
+// CIL[DOC-MACRO purpose="Defines the extractedimport type contract in cortex.functions.custom_cil-callmap"]
+// CIL[DOC-RESPONSIBILITY responsibility="Describe the shape and allowed fields for extractedimport"]
+// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-callmap" layer="function" related_files="[\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/functions/_shared/principal.ts\",\".framework/src/pages/admin/IntegrationsPage.tsx\",\".framework/migrations/015_simplify_apps_table.sql\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="type definition for extractedimport" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Declares TypeScript type/interface extractedimport with member definitions" 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: .framework/src/pages/admin/TypeDetailPage.tsx, .framework/functions/_shared/principal.ts, .framework/src/pages/admin/IntegrationsPage.tsx, .framework/migrations/015_simplify_apps_table.sql, custom/apps/cortex/pages/operations/OperationsDashboard.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"]
+interface ExtractedImport {
+  from_path: string   
+  symbols: string[]   
+  is_default: boolean
+}
+
+
+
+
+
+
+
+// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_callmap_extractedimport_1784235266"]
+// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_callmap_extractedcall_1784235266" type="interface" identity="extractedcall" parent="none"]
+// CIL[DOC-MACRO purpose="Defines the extractedcall type contract in cortex.functions.custom_cil-callmap"]
+// CIL[DOC-RESPONSIBILITY responsibility="Describe the shape and allowed fields for extractedcall"]
+// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-callmap" layer="function" related_files="[\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/functions/_shared/principal.ts\",\".framework/src/pages/admin/IntegrationsPage.tsx\",\".framework/migrations/015_simplify_apps_table.sql\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="type definition for extractedcall" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Declares TypeScript type/interface extractedcall with member definitions" 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: .framework/src/pages/admin/TypeDetailPage.tsx, .framework/functions/_shared/principal.ts, .framework/src/pages/admin/IntegrationsPage.tsx, .framework/migrations/015_simplify_apps_table.sql, custom/apps/cortex/pages/operations/OperationsDashboard.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"]
+interface ExtractedCall {
+  callee_name: string   
+  is_await: boolean
+}
+
+
+
+
+
+
+
+
+
+
+// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_callmap_extractedcall_1784235266"]
+// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_callmap_extractimports_1784235266" type="function" identity="extractimports" parent="none"]
+// CIL[DOC-MACRO purpose="Implements extractimports logic in cortex.functions.custom_cil-callmap"]
+// CIL[DOC-RESPONSIBILITY responsibility="Execute extractimports and return its computed result"]
+// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-callmap" 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 extractimports with extractImports(source: string 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="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+export function extractImports(source: string): ExtractedImport[] {
+  const results: ExtractedImport[] = []
+  
+  const importRe = /^import\s+([\s\S]*?)\s+from\s+['"]([^'"]+)['"]/gm
+  let m: RegExpExecArray | null
+  while ((m = importRe.exec(source)) !== null) {
+    const specifierBlock = m[1].trim()
+    const fromPath = m[2]
+
+    let symbols: string[] = []
+    let isDefault = false
+
+    if (specifierBlock.startsWith('{')) {
+      
+      const inner = specifierBlock.replace(/^\{|\}$/g, '').trim()
+      symbols = inner.split(',').map(s => {
+        const parts = s.trim().split(/\s+as\s+/)
+        return (parts[parts.length - 1] || '').trim()
+      }).filter(Boolean)
+    } else if (specifierBlock.startsWith('*')) {
+      
+      const asMatch = specifierBlock.match(/\*\s+as\s+(\w+)/)
+      if (asMatch) symbols = [asMatch[1]]
+    } else {
+      
+      const defaultMatch = specifierBlock.match(/^(\w+)/)
+      if (defaultMatch) { symbols = [defaultMatch[1]]; isDefault = true }
+      const namedMatch = specifierBlock.match(/\{([^}]+)\}/)
+      if (namedMatch) {
+        const named = namedMatch[1].split(',').map(s => s.trim().split(/\s+as\s+/).pop()!.trim()).filter(Boolean)
+        symbols = [...symbols, ...named]
+      }
+    }
+
+    results.push({ from_path: fromPath, symbols, is_default: isDefault })
+  }
+  return results
+}
+
+
+
+
+
+
+
+
+// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_callmap_extractimports_1784235266"]
+// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_callmap_extractcalls_1784235266" type="function" identity="extractcalls" parent="none"]
+// CIL[DOC-MACRO purpose="Implements extractcalls logic in cortex.functions.custom_cil-callmap"]
+// CIL[DOC-RESPONSIBILITY responsibility="Execute extractcalls and return its computed result"]
+// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-callmap" 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 extractcalls with extractCalls(source: string 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="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+export function extractCalls(source: string): ExtractedCall[] {
+  const seen = new Set<string>()
+  const results: ExtractedCall[] = []
+
+  
+  const callRe = /(await\s+)?(?:[\w$]+\.)*?([\w$]{2,})\s*\(/g
+  let m: RegExpExecArray | null
+  while ((m = callRe.exec(source)) !== null) {
+    const isAwait = !!m[1]
+    const calleeName = m[2]
+    
+    
+    if (['if', 'for', 'while', 'switch', 'catch', 'return', 'new', 'typeof', 'instanceof', 'function'].includes(calleeName)) continue
+    if (calleeName.length < 3) continue
+    
+    
+    if (['ctx', 'req', 'res', 'data', 'props', 'state', 'params', 'config', 'options', 'args'].includes(calleeName)) continue
+    
+    if (seen.has(calleeName)) continue
+    seen.add(calleeName)
+    results.push({ callee_name: calleeName, is_await: isAwait })
+  }
+  return results
+}
+
+
+
+
+
+
+
+
+// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_callmap_extractcalls_1784235266"]
+// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_callmap_extractsymbolreferences_1784235266" type="function" identity="extractsymbolreferences" parent="none"]
+// CIL[DOC-MACRO purpose="Find symbol/name references from one chunk to other chunk identities"]
+// CIL[DOC-RESPONSIBILITY responsibility="Detect non-call references to exported chunk names/types to enrich the call graph"]
+// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-callmap" layer="function" related_files="[]"]
+// CIL[DOC-CONTRACT inputs="source string, candidate symbol list" outputs="matching symbol names" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Builds a single regex from chunk identities and returns the set of names found as whole-word tokens in the source" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="first" score="0.85" flags="possible_false_positives"]
+// CIL[DOC-STABILITY stability="experimental"]
+function escapeRegex(s: string): string {
+  return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')
+}
+
+function extractSymbolReferences(source: string, candidateNames: string[], ownName?: string): string[] {
+  const reserved = new Set(['if','for','while','switch','catch','return','new','typeof','instanceof','function','const','let','var','class','interface','type','enum','export','import','from','await','async','true','false','null','undefined','this','super','extends','implements','as','in','of','with','yield'])
+  const candidates = candidateNames
+    .filter(n => n && n !== ownName && n.length >= 2 && !reserved.has(n))
+    .sort((a, b) => b.length - a.length)
+  if (candidates.length === 0) return []
+
+  const pattern = new RegExp(`(?:^|[^A-Za-z0-9_$])(${candidates.map(escapeRegex).join('|')})(?=[^A-Za-z0-9_$]|$)`, 'g')
+  const seen = new Set<string>()
+  let m: RegExpExecArray | null
+  while ((m = pattern.exec(source)) !== null) {
+    seen.add(m[1])
+  }
+  return [...seen]
+}
+
+
+
+
+// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_callmap_extractsymbolreferences_1784235266"]
+// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_callmap_extractexports_1784235266" type="function" identity="extractexports" parent="none"]
+// CIL[DOC-MACRO purpose="Implements extractexports logic in cortex.functions.custom_cil-callmap"]
+// CIL[DOC-RESPONSIBILITY responsibility="Execute extractexports and return its computed result"]
+// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-callmap" 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 extractexports with extractExports(source: string 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="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+export function extractExports(source: string): string[] {
+  const exports: string[] = []
+  
+  const exportRe = /^export\s+(?:default\s+)?(?:async\s+)?(?:function|class|const|let|var|type|interface|enum)\s+(\w+)/gm
+  let m: RegExpExecArray | null
+  while ((m = exportRe.exec(source)) !== null) {
+    exports.push(m[1])
+  }
+  
+  const namedRe = /^export\s+\{([^}]+)\}/gm
+  while ((m = namedRe.exec(source)) !== null) {
+    const named = m[1].split(',').map(s => s.trim().split(/\s+as\s+/).pop()!.trim()).filter(Boolean)
+    exports.push(...named)
+  }
+  return [...new Set(exports)]
+}
+
+
+
+
+
+
+
+
+
+// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_callmap_extractexports_1784235266"]
+// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_callmap_resolveimportpath_1784235266" type="function" identity="resolveimportpath" parent="none"]
+// CIL[DOC-MACRO purpose="Implements resolveimportpath logic in cortex.functions.custom_cil-callmap"]
+// CIL[DOC-RESPONSIBILITY responsibility="Execute resolveimportpath and return its computed result"]
+// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-callmap" 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 resolveimportpath with resolveImportPath(fromFilePath: string, importSpecifier: string 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="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+function resolveImportPath(fromFilePath: string, importSpecifier: string): string | null {
+  
+  if (!importSpecifier.startsWith('.')) return null
+
+  const fromDir = fromFilePath.split('/').slice(0, -1).join('/')
+  const segments = `${fromDir}/${importSpecifier}`.split('/')
+  const resolved: string[] = []
+
+  for (const seg of segments) {
+    if (seg === '..') resolved.pop()
+    else if (seg !== '.') resolved.push(seg)
+  }
+
+  const base = resolved.join('/')
+  
+  return base 
+}
+
+
+
+
+
+// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_callmap_resolveimportpath_1784235266"]
+// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_callmap_upsertlink_1784235266" type="function" identity="upsertlink" parent="none"]
+// CIL[DOC-MACRO purpose="Implements upsertlink logic in cortex.functions.custom_cil-callmap"]
+// CIL[DOC-RESPONSIBILITY responsibility="Execute upsertlink and return its computed result"]
+// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-callmap" 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 upsertlink with upsertLink( 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="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+export async function upsertLink(
+  ctx: any,
+  sourceItem: any,
+  targetItem: any,
+  linkTypeId: string,
+  metadata: Record<string, any> = {}
+): Promise<boolean> {
+  
+  const { data: existing } = await adminDb
+    .from('links')
+    .select('id')
+    .eq('source_id', sourceItem.id)
+    .eq('target_id', targetItem.id)
+    .eq('link_type_id', linkTypeId)
+    .maybeSingle()
+
+  if (existing) return false 
+
+  const sourceType = sourceItem.data?.kb_type
+  const targetType = targetItem.data?.kb_type
+  if (!sourceType || !targetType) return false
+
+  try {
+    await adminCreate(ctx, {
+      entity: 'links',
+      type_slug: 'link',
+      source_id: sourceItem.id,
+      source_type: sourceType,
+      target_id: targetItem.id,
+      target_type: targetType,
+      link_type_id: linkTypeId,
+      metadata,
+    })
+    return true
+  } catch (err: any) {
+    console.error('upsertLink failed:', err?.message || err)
+    return false
+  }
+}
+
+
+
+
+
+// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_callmap_upsertlink_1784235266"]
+// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_callmap_clearprojectlinks_1784235266" type="function" identity="clearprojectlinks" parent="none"]
+async function clearProjectLinks(projectId: string, linkTypeIds: string[]): Promise<number> {
+  const [{ data: fileItems }, { data: chunkItems }] = await Promise.all([
+    adminDb
+      .from('items')
+      .select('id')
+      .filter('data->>project_id', 'eq', projectId)
+      .filter('data->>kb_type', 'eq', 'cil_file')
+      .eq('is_active', true),
+    adminDb
+      .from('items')
+      .select('id')
+      .filter('data->>project_id', 'eq', projectId)
+      .filter('data->>kb_type', 'eq', 'cil_chunk')
+      .eq('is_active', true),
+  ])
+
+  const ids = [
+    ...(fileItems || []).map((f: any) => f.id),
+    ...(chunkItems || []).map((c: any) => c.id),
+  ]
+  if (!ids.length) return 0
+
+  let deleted = 0
+  for (const ltId of linkTypeIds.filter(Boolean)) {
+    for (let i = 0; i < ids.length; i += UUID_IN_LIMIT) {
+      const { data: deletedRows } = await adminDb
+        .from('links')
+        .delete()
+        .eq('link_type_id', ltId)
+        .in('source_id', ids.slice(i, i + UUID_IN_LIMIT))
+        .select('id')
+      deleted += (deletedRows || []).length
+    }
+  }
+  return deleted
+}
+// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_callmap_clearprojectlinks_1784235266"]
+// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_callmap_mapfile_1784235266" type="function" identity="mapfile" parent="none"]
+// CIL[DOC-MACRO purpose="Implements mapfile logic in cortex.functions.custom_cil-callmap"]
+// CIL[DOC-RESPONSIBILITY responsibility="Execute mapfile and return its computed result"]
+// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-callmap" 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 mapfile with mapFile( 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="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+export async function mapFile(
+  ctx: any,
+  fileItem: any,
+  projectId: string,
+  allChunksByFile: Map<string, any[]>,
+  chunksByName: Map<string, any>,
+  fileItemsByPath: Map<string, any>,
+  importsLinkTypeId: string,
+  callsLinkTypeId: string,
+  exportsLinkTypeId: string
+): Promise<{ imports_created: number; calls_created: number; exports_created: number }> {
+  let importsCreated = 0, callsCreated = 0, exportsCreated = 0
+
+  const filePath: string = fileItem.data?.file_path || fileItem.title
+  const chunksInFile = allChunksByFile.get(fileItem.id) || []
+
+  
+  const allChunkNames = Array.from(chunksByName.keys())
+
+  for (const chunk of chunksInFile) {
+    const codeContent: string = chunk.data?.code_content || ''
+    if (!codeContent) continue
+
+    
+    const calls = extractCalls(codeContent)
+    for (const call of calls) {
+      const targetChunk = chunksByName.get(call.callee_name)
+      if (!targetChunk || targetChunk.id === chunk.id) continue
+      const created = await upsertLink(ctx, chunk, targetChunk, callsLinkTypeId, {
+        callee_name: call.callee_name,
+        is_await: call.is_await,
+      })
+      if (created) callsCreated++
+    }
+
+    
+    const symbolRefs = extractSymbolReferences(codeContent, allChunkNames, chunk.data?.chunk_name || '')
+    for (const refName of symbolRefs) {
+      const targetChunk = chunksByName.get(refName)
+      if (!targetChunk || targetChunk.id === chunk.id) continue
+      const created = await upsertLink(ctx, chunk, targetChunk, callsLinkTypeId, {
+        callee_name: refName,
+        is_symbol_reference: true,
+      })
+      if (created) callsCreated++
+    }
+  }
+
+  
+  
+  const fullFileContent = chunksInFile.map((c: any) => c.data?.code_content || '').join('\n')
+  const imports = extractImports(fullFileContent)
+
+  for (const imp of imports) {
+    const resolvedBase = resolveImportPath(filePath, imp.from_path)
+    if (!resolvedBase) continue
+
+    
+    const targetFile =
+      fileItemsByPath.get(resolvedBase) ||
+      fileItemsByPath.get(resolvedBase + '.ts') ||
+      fileItemsByPath.get(resolvedBase + '.tsx') ||
+      fileItemsByPath.get(resolvedBase + '/index.ts') ||
+      fileItemsByPath.get(resolvedBase + '/index.tsx')
+
+    if (!targetFile || targetFile.id === fileItem.id) continue
+
+    const created = await upsertLink(ctx, fileItem, targetFile, importsLinkTypeId, {
+      symbols: imp.symbols,
+      is_default: imp.is_default,
+      specifier: imp.from_path,
+    })
+    if (created) importsCreated++
+  }
+
+  
+  const exportedNames = extractExports(fullFileContent)
+  for (const exportedName of exportedNames) {
+    const chunk = chunksByName.get(exportedName)
+    if (!chunk) continue
+    const created = await upsertLink(ctx, chunk, fileItem, exportsLinkTypeId, {
+      exported_name: exportedName,
+    })
+    if (created) exportsCreated++
+  }
+
+  return { imports_created: importsCreated, calls_created: callsCreated, exports_created: exportsCreated }
+}
+
+
+
+
+
+
+// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_callmap_mapfile_1784235266"]
+// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_callmap_markfilepass4bcomplete_1784235266" type="function" identity="markfilepass4bcomplete" parent="none"]
+// CIL[DOC-MACRO purpose="Implements markfilepass4bcomplete logic in cortex.functions.custom_cil-callmap"]
+// CIL[DOC-RESPONSIBILITY responsibility="Execute markfilepass4bcomplete and return its computed result"]
+// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-callmap" 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 markfilepass4bcomplete with markFilePass4bComplete( 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="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+async function markFilePass4bComplete(
+  ctx: any,
+  fileItem: any,
+  tree: FileTreeNode | null,
+  secondPass = false,
+  projectItem?: any
+): Promise<void> {
+  const cil_file_status = secondPass ? 'pass8_complete' : 'pass4b_complete'
+  const pipeline_status = secondPass ? '10-mapped' : '7-mapped'
+  const currentFileStatus = getFileStatus(fileItem)
+  const filePath: string = fileItem.data?.file_path
+
+  
+  if (rank(currentFileStatus) < rank(cil_file_status)) {
+    const updateCtx = { ...ctx, query: { ...(ctx.query || {}), entity: 'items', id: fileItem.id } }
+    await adminUpdate(updateCtx, {
+      data: {
+        ...fileItem.data,
+        status: cil_file_status,
+        last_status_at: new Date().toISOString(),
+      },
+    }).catch((e: any) => console.error(`mark ${cil_file_status} failed:`, e.message))
+  }
+  if (tree) updateTreeNodeStatus(tree, fileItem.id, cil_file_status)
+
+  
+  const projectId: string = fileItem.data?.project_id
+  if (!filePath || !projectId) return
+
+  let projItem = projectItem
+  if (!projItem) {
+    const { data } = await adminDb.from('items').select('id, data').eq('id', projectId).maybeSingle()
+    projItem = data
+  }
+  if (!projItem) return
+
+  const currentPipelineStatus = projItem.data?.file_statuses?.[filePath]
+  if (rank(currentPipelineStatus) >= rank(pipeline_status)) return
+
+  const fileStatuses = { ...(projItem.data?.file_statuses || {}) }
+  fileStatuses[filePath] = pipeline_status
+  fileStatuses[`${filePath}_updated`] = new Date().toISOString()
+  const { data: updateResult, error: updateErr } = await adminDb.from('items')
+    .update({ data: { ...projItem.data, file_statuses: fileStatuses } })
+    .eq('id', projectId)
+    .select('id')
+  if (updateErr) {
+    console.error(`pipeline status advance to ${pipeline_status} failed:`, updateErr.message)
+    return
+  }
+  console.log(`pipeline status advance to ${pipeline_status} result:`, JSON.stringify(updateResult))
+
+  
+  if (projectItem) {
+    if (!projectItem.data) projectItem.data = {}
+    projectItem.data.file_statuses = fileStatuses
+  }
+}
+
+
+
+
+
+
+// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_callmap_markfilepass4bcomplete_1784235266"]
+// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_callmap_istestfile_1784235266" type="function" identity="istestfile" parent="none"]
+// CIL[DOC-MACRO purpose="Implements istestfile logic in cortex.functions.custom_cil-callmap"]
+// CIL[DOC-RESPONSIBILITY responsibility="Execute istestfile and return its computed result"]
+// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-callmap" 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 istestfile with isTestFile(filePath: string 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="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+function isTestFile(filePath: string): boolean {
+  return /\.(test|spec)\.(ts|tsx|js|jsx)$/.test(filePath) ||
+    /\/__tests__\//.test(filePath) ||
+    /\/tests?\//.test(filePath)
+}
+
+
+
+
+// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_callmap_istestfile_1784235266"]
+// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_callmap_maptests_1784235266" type="function" identity="maptests" parent="none"]
+// CIL[DOC-MACRO purpose="Implements maptests logic in cortex.functions.custom_cil-callmap"]
+// CIL[DOC-RESPONSIBILITY responsibility="Execute maptests and return its computed result"]
+// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-callmap" 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 maptests with mapTests( 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="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+async function mapTests(
+  ctx: any,
+  projectId: string,
+  repoPath: string,
+  testedByLinkTypeId: string,
+  chunksByName: Map<string, any>
+): Promise<{ test_files_scanned: number; tested_by_links_created: number; chunks_updated: number; errors: string[] }> {
+  const errors: string[] = []
+  let testFilesScanned = 0, linksCreated = 0, chunksUpdated = 0
+
+  const { data: allFiles } = await adminDb
+    .from('items').select('id, title, data')
+    .filter('data->>project_id', 'eq', projectId)
+    .filter('data->>kb_type', 'eq', 'cil_file')
+    .eq('is_active', true)
+
+  const testFiles = (allFiles || []).filter((f: any) => isTestFile(f.data?.file_path || f.title))
+
+  const matchesByFile = new Map<string, Set<string>>()
+  const allMatchedNames = new Set<string>()
+
+  for (const testFileItem of testFiles) {
+    const relPath: string = testFileItem.data?.file_path || testFileItem.title
+    const absPath = path.join(repoPath, relPath)
+
+    try {
+      if (!fs.existsSync(absPath)) continue
+      const source = fs.readFileSync(absPath, 'utf-8')
+      testFilesScanned++
+
+      const matchedChunkNames = new Set<string>()
+
+      const importRe = /import\s+\{([^}]+)\}/g
+      let m: RegExpExecArray | null
+      while ((m = importRe.exec(source)) !== null) {
+        const names = m[1].split(',').map(s => s.trim().split(/\s+as\s+/).shift()!.trim()).filter(Boolean)
+        for (const n of names) {
+          if (chunksByName.has(n)) matchedChunkNames.add(n)
+        }
+      }
+
+      const stringRe = /(?:describe|it|test|beforeEach|afterEach)\s*\(\s*['"`]([^'"`]+)['"`]/g
+      while ((m = stringRe.exec(source)) !== null) {
+        const words = m[1].split(/\W+/)
+        for (const word of words) {
+          if (chunksByName.has(word)) matchedChunkNames.add(word)
+        }
+      }
+
+      const callRe = /\b(\w{3,})\s*\(/g
+      while ((m = callRe.exec(source)) !== null) {
+        const name = m[1]
+        if (chunksByName.has(name)) matchedChunkNames.add(name)
+      }
+
+      matchesByFile.set(relPath, matchedChunkNames)
+      for (const name of matchedChunkNames) allMatchedNames.add(name)
+    } catch (err) {
+      errors.push(`${relPath}: ${err instanceof Error ? err.message : String(err)}`)
+    }
+  }
+
+  const matchedIds = [...allMatchedNames]
+    .map(name => chunksByName.get(name)?.id)
+    .filter(Boolean)
+  const fullChunksByName = new Map<string, any>()
+  for (let i = 0; i < matchedIds.length; i += UUID_IN_LIMIT) {
+    const { data } = await adminDb
+      .from('items')
+      .select('id, title, data')
+      .in('id', matchedIds.slice(i, i + UUID_IN_LIMIT))
+    for (const c of data || []) {
+      const name = c.data?.chunk_name
+      if (name) fullChunksByName.set(name, c)
+    }
+  }
+
+  for (const testFileItem of testFiles) {
+    const relPath: string = testFileItem.data?.file_path || testFileItem.title
+    const absPath = path.join(repoPath, relPath)
+    const isE2E = /e2e|cypress|playwright|integration/.test(relPath)
+    const matchedChunkNames = matchesByFile.get(relPath)
+    if (!matchedChunkNames) continue
+
+    for (const chunkName of matchedChunkNames) {
+      const chunk = fullChunksByName.get(chunkName)
+      if (!chunk) continue
+      const cd = chunk.data || {}
+
+      const created = await upsertLink(ctx, chunk, testFileItem, testedByLinkTypeId, {
+        test_path: relPath,
+        is_e2e: isE2E,
+      })
+      if (created) linksCreated++
+
+      const pathField = isE2E ? 'test_e2e_path' : 'test_unit_path'
+      const existingPath = cd[pathField]
+      if (!existingPath || existingPath === relPath) {
+        await adminUpdate({ ...ctx, query: { ...(ctx.query || {}), entity: 'items', id: chunk.id } } as any, {
+          data: { ...cd, [pathField]: relPath },
+        })
+        chunksUpdated++
+      }
+    }
+  }
+
+  return { test_files_scanned: testFilesScanned, tested_by_links_created: linksCreated, chunks_updated: chunksUpdated, errors }
+}
+
+
+
+
+
+// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_callmap_maptests_1784235266"]
+// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_callmap_handler_1784235266" type="variable" identity="handler" parent="none"]
+// CIL[DOC-MACRO purpose="Defines handler configuration or state in cortex.functions.custom_cil-callmap"]
+// CIL[DOC-RESPONSIBILITY responsibility="Hold the value and default configuration for handler"]
+// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-callmap" 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-callmap" 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="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
+
+  
+  if (action === 'status') {
+    const projectId = ctx.query?.project_id || body?.project_id
+    if (!projectId) throw new Error('project_id is required')
+
+    const [importsTypeId, callsTypeId, exportsTypeId, testedByTypeId] = await Promise.all([
+      resolveLinkTypeId('cil_imports').catch(() => null),
+      resolveLinkTypeId('cil_calls').catch(() => null),
+      resolveLinkTypeId('cil_exports').catch(() => null),
+      resolveLinkTypeId('cil_tested_by').catch(() => null),
+    ])
+
+    const { data: fileItems } = await adminDb
+      .from('items')
+      .select('id')
+      .filter('data->>project_id', 'eq', projectId)
+      .filter('data->>kb_type', 'eq', 'cil_file')
+
+    const { data: chunkItems } = await adminDb
+      .from('items')
+      .select('id')
+      .filter('data->>project_id', 'eq', projectId)
+      .filter('data->>kb_type', 'eq', 'cil_chunk')
+
+    const fileIds  = (fileItems  || []).map((f: any) => f.id)
+    const chunkIds = (chunkItems || []).map((c: any) => c.id)
+
+    async function countLinksForIds(typeId: string, ids: string[]): Promise<number> {
+      if (!typeId || !ids.length) return 0
+      let total = 0
+      for (let i = 0; i < ids.length; i += UUID_IN_LIMIT) {
+        const { count } = await adminDb.from('links').select('id', { count: 'exact' })
+          .eq('link_type_id', typeId).in('source_id', ids.slice(i, i + UUID_IN_LIMIT))
+        total += count || 0
+      }
+      return total
+    }
+
+    const importCount = await countLinksForIds(importsTypeId, fileIds)
+    const callCount = await countLinksForIds(callsTypeId, chunkIds)
+    const exportCount = await countLinksForIds(exportsTypeId, chunkIds)
+    const testedByCount = await countLinksForIds(testedByTypeId, chunkIds)
+
+    return {
+      project_id: projectId,
+      total_files: (fileItems || []).length,
+      total_chunks: (chunkItems || []).length,
+      import_links: importCount,
+      call_links: callCount,
+      export_links: exportCount,
+      tested_by_links: testedByCount,
+      total_links: importCount + callCount + exportCount + testedByCount,
+    }
+  }
+
+  
+  if (action === 'clear') {
+    const projectId = body?.project_id
+    if (!projectId) throw new Error('project_id is required')
+
+    const [importsTypeId, callsTypeId, exportsTypeId] = await Promise.all([
+      resolveLinkTypeId('cil_imports').catch(() => null),
+      resolveLinkTypeId('cil_calls').catch(() => null),
+      resolveLinkTypeId('cil_exports').catch(() => null),
+    ])
+
+    const { data: chunkItems } = await adminDb
+      .from('items').select('id')
+      .filter('data->>project_id', 'eq', projectId)
+      .filter('data->>kb_type', 'in', '(cil_chunk,cil_file)')
+
+    const ids = (chunkItems || []).map((c: any) => c.id)
+    let deleted = 0
+
+    for (const ltId of [importsTypeId, callsTypeId, exportsTypeId].filter(Boolean)) {
+      if (!ids.length) continue
+      for (let i = 0; i < ids.length; i += UUID_IN_LIMIT) {
+        const { data: deletedRows } = await adminDb.from('links')
+          .delete().eq('link_type_id', ltId!).in('source_id', ids.slice(i, i + UUID_IN_LIMIT)).select('id')
+        deleted += (deletedRows || []).length
+      }
+    }
+
+    
+    const { data: projectItem } = await adminDb.from('items').select('id, data').eq('id', projectId).maybeSingle()
+    const fileTree = (projectItem?.data?.file_tree as FileTreeNode) || null
+    const { data: fileItems } = await adminDb
+      .from('items')
+      .select('id, data')
+      .filter('data->>project_id', 'eq', projectId)
+      .filter('data->>kb_type', 'eq', 'cil_file')
+      .eq('is_active', true)
+
+    let resetCount = 0
+    for (const fileItem of fileItems || []) {
+      if (getFileStatus(fileItem) === 'pass4b_complete') {
+        const updateCtx = { ...ctx, query: { ...(ctx.query || {}), entity: 'items', id: fileItem.id } }
+        await adminUpdate(updateCtx, {
+          data: {
+            ...fileItem.data,
+            status: 'pass3_complete',
+            last_status_at: new Date().toISOString(),
+          },
+        }).catch((e: any) => console.error(`reset status ${fileItem.id}: ${e.message}`))
+        if (fileTree) updateTreeNodeStatus(fileTree, fileItem.id, 'pass3_complete')
+        resetCount++
+      }
+    }
+    if (fileTree && projectItem) {
+      await saveProjectTree(ctx, projectId, fileTree, { last_ingested_at: new Date().toISOString() })
+    }
+
+    return { project_id: projectId, deleted_links: deleted, reset_files: resetCount }
+  }
+
+  
+  if (action === 'map_file') {
+    const fileId = body?.file_id
+    if (!fileId) throw new Error('file_id is required')
+
+    const { data: fileItem } = await adminDb
+      .from('items').select('id, title, data').eq('id', fileId).maybeSingle()
+    if (!fileItem) throw new Error(`File not found: ${fileId}`)
+
+    const projectId = fileItem.data?.project_id
+    if (!projectId) throw new Error('File has no project_id')
+
+    const [importsTypeId, callsTypeId, exportsTypeId] = await Promise.all([
+      resolveLinkTypeId('cil_imports'),
+      resolveLinkTypeId('cil_calls'),
+      resolveLinkTypeId('cil_exports'),
+    ])
+
+    
+    const { data: allFiles } = await adminDb
+      .from('items').select('id, title, data')
+      .filter('data->>project_id', 'eq', projectId)
+      .filter('data->>kb_type', 'eq', 'cil_file').eq('is_active', true)
+
+    const { data: allChunks } = await adminDb
+      .from('items').select('id, title, data')
+      .filter('data->>project_id', 'eq', projectId)
+      .filter('data->>kb_type', 'eq', 'cil_chunk').eq('is_active', true)
+
+    const fileItemsByPath = new Map((allFiles || []).map((f: any) => [f.data?.file_path || f.title, f]))
+    const chunksByName = new Map((allChunks || []).map((c: any) => [c.data?.chunk_name || '', c]))
+    const allChunksByFile = new Map<string, any[]>()
+    for (const c of allChunks || []) {
+      const fid = c.data?.file_id
+      if (!fid) continue
+      if (!allChunksByFile.has(fid)) allChunksByFile.set(fid, [])
+      allChunksByFile.get(fid)!.push(c)
+    }
+
+    const result = await mapFile(
+      fileItem, projectId,
+      allChunksByFile, chunksByName, fileItemsByPath,
+      importsTypeId, callsTypeId, exportsTypeId
+    )
+
+    return { file_id: fileId, ...result }
+  }
+
+  
+  if (action === 'map_tests') {
+    const projectId = body?.project_id
+    if (!projectId) throw new Error('project_id is required')
+
+    
+    const { data: projectItem } = await adminDb
+      .from('items').select('data').eq('id', projectId).maybeSingle()
+    const repoPath: string = projectItem?.data?.repo_path || body?.repo_path || ''
+    if (!repoPath) throw new Error('Project has no repo_path — pass repo_path in body')
+
+    const testedByTypeId = await resolveLinkTypeId('cil_tested_by')
+    const { data: allChunks } = await adminDb
+      .from('items')
+      .select('id, data->>chunk_name, data->>kb_type')
+      .filter('data->>project_id', 'eq', projectId)
+      .filter('data->>kb_type', 'eq', 'cil_chunk')
+      .eq('is_active', true)
+    const chunksByName = new Map<string, any>()
+    for (const c of allChunks || []) {
+      const name = c.chunk_name
+      if (name) chunksByName.set(name, { id: c.id, data: { chunk_name: c.chunk_name, kb_type: c.kb_type || 'cil_chunk' } })
+    }
+    const result = await mapTests(ctx, projectId, repoPath, testedByTypeId, chunksByName)
+    return { project_id: projectId, repo_path: repoPath, ...result }
+  }
+
+  
+  
+  
+  
+  
+  
+  if (action === 'map_project') {
+    const projectId = body?.project_id
+    if (!projectId) throw new Error('project_id is required')
+
+    const pageLimit  = Math.min(parseInt(body?.limit  || '5', 10), 15)
+    const pageOffset = parseInt(body?.offset || '0', 10)
+    const filePath   = body?.file_path || undefined
+    const force      = body?.force_regenerate ?? body?.force ?? false
+    const secondPass = body?.second_pass ?? false
+
+    const targetPipelineStatus = secondPass ? '10-mapped' : '7-mapped'
+
+    const [importsTypeId, callsTypeId, exportsTypeId, testedByTypeId] = await Promise.all([
+      resolveLinkTypeId('cil_imports'),
+      resolveLinkTypeId('cil_calls'),
+      resolveLinkTypeId('cil_exports'),
+      resolveLinkTypeId('cil_tested_by').catch(() => null),
+    ])
+
+    if (force && pageOffset === 0) {
+      await clearProjectLinks(projectId, [importsTypeId, callsTypeId, exportsTypeId, testedByTypeId])
+    }
+
+    
+    const { data: projectItem } = await adminDb.from('items').select('id, data').eq('id', projectId).maybeSingle()
+    const selectedExtensions = body?.selected_extensions || (projectItem?.data?.selected_extensions as string[] | undefined)
+    const selectedPaths: string[] = body?.selected_paths || projectItem?.data?.selected_paths || []
+    const fileTree = (projectItem?.data?.file_tree as FileTreeNode) || null
+
+    
+    const sourceFilePaths = filePath
+      ? [filePath]
+      : force
+        ? selectedPaths
+        : getMapSourceFilePaths(projectItem, secondPass)
+
+    let filesQ = adminDb.from('items').select('id, title, data')
+      .filter('data->>project_id', 'eq', projectId)
+      .filter('data->>kb_type', 'eq', 'cil_file').eq('is_active', true)
+      .order('id')
+    if (filePath) filesQ = filesQ.filter('data->>file_path', 'eq', filePath)
+
+    const [filesResult, allChunksMinimalResult] = await Promise.all([
+      filesQ,
+      adminDb.from('items').select('id, data->>chunk_name, data->>kb_type')
+        .filter('data->>project_id', 'eq', projectId)
+        .filter('data->>kb_type', 'eq', 'cil_chunk')
+        .eq('is_active', true),
+    ])
+
+    const allFiles = filesResult.data || []
+    const allChunksMinimal = allChunksMinimalResult.data || []
+
+    const fileItemsByPath = new Map(allFiles.map((f: any) => [f.data?.file_path || f.title, f]))
+
+    const chunksByName = new Map<string, any>()
+    for (const c of allChunksMinimal) {
+      const name = c.chunk_name
+      if (name) chunksByName.set(name, { id: c.id, data: { chunk_name: c.chunk_name, kb_type: c.kb_type || 'cil_chunk' } })
+    }
+
+    const mappedFileStatus = secondPass ? 'pass8_complete' : 'pass4b_complete'
+    const syncFiles = allFiles.filter((f: any) => {
+      const fp = f.data?.file_path || f.title
+      const status = getFileStatus(f)
+      const ext = f.data?.extension as string || ''
+      const extMatch = (selectedExtensions || []).length === 0 || (selectedExtensions || []).includes(ext)
+      return status === mappedFileStatus
+        && rank(projectItem?.data?.file_statuses?.[fp]) < rank(targetPipelineStatus)
+        && isSelectedPath(fp, selectedPaths)
+        && extMatch
+    })
+    for (const fileItem of syncFiles) {
+      await markFilePass4bComplete(ctx, fileItem, fileTree, secondPass, projectItem)
+    }
+
+    const eligibleFiles = allFiles.filter((f: any) => {
+      const fp = f.data?.file_path || f.title
+      const ext = f.data?.extension as string || ''
+      const extMatch = (selectedExtensions || []).length === 0 || (selectedExtensions || []).includes(ext)
+      if (filePath && fp !== filePath) return false
+      return sourceFilePaths.includes(fp) && isSelectedPath(fp, selectedPaths) && extMatch
+    })
+
+    const totalFiles = eligibleFiles.length
+    const pageFiles = eligibleFiles.slice(pageOffset, pageOffset + pageLimit)
+
+    const pageFilePaths = pageFiles.map(f => f.data?.file_path || f.title)
+    let pageChunks: any[] = []
+    if (pageFilePaths.length > 0) {
+      const { data } = await adminDb.from('items').select('id, title, data')
+        .filter('data->>project_id', 'eq', projectId)
+        .filter('data->>kb_type', 'eq', 'cil_chunk')
+        .eq('is_active', true)
+        .in('data->>file_path' as any, pageFilePaths)
+      pageChunks = data || []
+    }
+
+    const allChunksByFile = new Map<string, any[]>()
+    for (const c of pageChunks) {
+      const name = c.data?.chunk_name || ''
+      if (name) chunksByName.set(name, c)
+      const fid = c.data?.file_id
+      if (!fid) continue
+      if (!allChunksByFile.has(fid)) allChunksByFile.set(fid, [])
+      allChunksByFile.get(fid)!.push(c)
+    }
+
+    if (!chunksByName.size) {
+      return { project_id: projectId, file_path: filePath || null, message: 'No chunks found — run Pass 1 + Pass 2 first', imports_created: 0, calls_created: 0, exports_created: 0, has_more: false }
+    }
+
+    let totalImports = 0, totalCalls = 0, totalExports = 0
+    const errors: string[] = []
+
+    for (const fileItem of pageFiles) {
+      try {
+        const result = await mapFile(
+          ctx, fileItem, projectId,
+          allChunksByFile, chunksByName, fileItemsByPath,
+          importsTypeId, callsTypeId, exportsTypeId
+        )
+        totalImports += result.imports_created
+        totalCalls   += result.calls_created
+        totalExports += result.exports_created
+
+        
+        await markFilePass4bComplete(ctx, fileItem, fileTree, secondPass, projectItem)
+      } catch (err) {
+        errors.push(`${fileItem.data?.file_path || fileItem.id}: ${err instanceof Error ? err.message : String(err)}`)
+      }
+    }
+
+    const nextOffset = pageOffset + pageFiles.length
+    const isLastPage = pageFiles.length === 0 || pageFiles.length < pageLimit || nextOffset >= totalFiles
+
+    
+    let testResult: { test_files_scanned: number; tested_by_links_created: number; chunks_updated: number; errors: string[] } | null = null
+    if (isLastPage) {
+      const repoPath: string = projectItem?.data?.repo_path || ''
+      if (repoPath) {
+        try {
+          const testedByTypeId = await resolveLinkTypeId('cil_tested_by').catch(() => null)
+          if (testedByTypeId) {
+            testResult = await mapTests(ctx, projectId, repoPath, testedByTypeId, chunksByName)
+            errors.push(...(testResult.errors || []))
+          }
+        } catch {
+        }
+      }
+    }
+
+    
+    if (fileTree) {
+      await saveProjectTree(ctx, projectId, fileTree, { last_ingested_at: new Date().toISOString() }, projectItem)
+    }
+
+    return {
+      project_id: projectId,
+      file_path: filePath || null,
+      total_files: totalFiles,
+      files_processed: pageFiles.length,
+      imports_created: totalImports,
+      calls_created: totalCalls,
+      exports_created: totalExports,
+      tested_by_links_created: testResult?.tested_by_links_created ?? 0,
+      test_files_scanned: testResult?.test_files_scanned ?? 0,
+      chunks_updated_with_test_paths: testResult?.chunks_updated ?? 0,
+      total_links_created: totalImports + totalCalls + totalExports + (testResult?.tested_by_links_created ?? 0),
+      errors,
+      has_more: !isLastPage,
+      next_offset: !isLastPage ? nextOffset : null,
+      done_total: pageOffset + pageFiles.length,
+    }
+  }
+
+  throw new Error(`Unknown action: ${action}. Valid: map_project, map_file, map_tests, status, clear`)
+})
+
+
+
+
+// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_callmap_handler_1784235266"]