spine-framework 0.3.125 → 0.3.127

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

@@ -0,0 +1,445 @@
+// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_context_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-context"]
+// CIL[DOC-RESPONSIBILITY responsibility="Own module-level imports, exports, and configuration for cortex.functions.custom_cil-context"]
+// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-context" 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-context" 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'
+
+
+
+
+
+
+
+// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_context_module_header_1784235266"]
+// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_context_getchunkbyid_1784235266" type="function" identity="getchunkbyid" parent="none"]
+// CIL[DOC-MACRO purpose="Implements getchunkbyid logic in cortex.functions.custom_cil-context"]
+// CIL[DOC-RESPONSIBILITY responsibility="Execute getchunkbyid and return its computed result"]
+// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-context" 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 getchunkbyid with getChunkById(id: 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: 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: 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 getChunkById(id: string): Promise<any | null> {
+  const { data } = await adminDb.from('items').select('id, title, data')
+    .eq('id', id).maybeSingle()
+  return data
+}
+
+
+
+
+
+// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_context_getchunkbyid_1784235266"]
+// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_context_findchunkbyname_1784235266" type="function" identity="findchunkbyname" parent="none"]
+// CIL[DOC-MACRO purpose="Implements findchunkbyname logic in cortex.functions.custom_cil-context"]
+// CIL[DOC-RESPONSIBILITY responsibility="Execute findchunkbyname and return its computed result"]
+// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-context" 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 findchunkbyname with findChunkByName(name: string, projectId?: 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: 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: 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 findChunkByName(name: string, projectId?: string): Promise<any | null> {
+  let q = adminDb.from('items').select('id, title, data')
+    .filter('data->>kb_type', 'eq', 'cil_chunk')
+    .filter('data->>chunk_name', 'eq', name)
+    .eq('is_active', true)
+  if (projectId) q = q.filter('data->>project_id', 'eq', projectId)
+  const { data } = await q.limit(1).maybeSingle()
+  return data
+}
+
+
+
+
+
+
+// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_context_findchunkbyname_1784235266"]
+// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_context_blastradiusbfs_1784235266" type="function" identity="blastradiusbfs" parent="none"]
+// CIL[DOC-MACRO purpose="Implements blastradiusbfs logic in cortex.functions.custom_cil-context"]
+// CIL[DOC-RESPONSIBILITY responsibility="Execute blastradiusbfs and return its computed result"]
+// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-context" 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 blastradiusbfs with blastRadiusBFS( 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: 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: 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 blastRadiusBFS(
+  chunkId: string,
+  maxDepth: number,
+  callsLinkTypeId: string
+): Promise<{ chunk_id: string; chunk_name: string; file_path: string; depth: number }[]> {
+  const visited = new Set<string>([chunkId])
+  const queue: { id: string; depth: number }[] = [{ id: chunkId, depth: 0 }]
+  const result: { chunk_id: string; chunk_name: string; file_path: string; depth: number }[] = []
+
+  while (queue.length > 0) {
+    const { id, depth } = queue.shift()!
+    if (depth >= maxDepth) continue
+
+    
+    const { data: callerLinks } = await adminDb.from('links').select('source_id')
+      .eq('link_type_id', callsLinkTypeId)
+      .eq('target_id', id)
+
+    for (const link of callerLinks || []) {
+      const callerId = link.source_id
+      if (visited.has(callerId)) continue
+      visited.add(callerId)
+
+      const callerChunk = await getChunkById(callerId)
+      if (!callerChunk) continue
+
+      result.push({
+        chunk_id: callerId,
+        chunk_name: callerChunk.data?.chunk_name || '',
+        file_path: callerChunk.data?.file_path || '',
+        depth: depth + 1,
+      })
+      queue.push({ id: callerId, depth: depth + 1 })
+    }
+  }
+
+  return result
+}
+
+
+
+
+
+
+// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_context_blastradiusbfs_1784235266"]
+// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_context_getconfigdeps_1784235266" type="function" identity="getconfigdeps" parent="none"]
+// CIL[DOC-MACRO purpose="Implements getconfigdeps logic in cortex.functions.custom_cil-context"]
+// CIL[DOC-RESPONSIBILITY responsibility="Execute getconfigdeps and return its computed result"]
+// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-context" 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 getconfigdeps with getConfigDeps( 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: 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: 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 getConfigDeps(
+  chunkId: string,
+  configuresLinkTypeId: string | null
+): Promise<{ field_name: string; source_file: string; config_id: string }[]> {
+  if (!configuresLinkTypeId) return []
+
+  const { data: configLinks } = await adminDb.from('links').select('source_id, metadata')
+    .eq('link_type_id', configuresLinkTypeId)
+    .eq('target_id', chunkId)
+
+  if (!configLinks?.length) return []
+
+  const results: { field_name: string; source_file: string; config_id: string }[] = []
+  for (const link of configLinks) {
+    const configItem = await getChunkById(link.source_id)
+    if (!configItem) continue
+    results.push({
+      field_name: configItem.data?.field_name || link.metadata?.field_name || '',
+      source_file: configItem.data?.config_table || '',
+      config_id: link.source_id,
+    })
+  }
+  return results
+}
+
+
+
+
+
+
+// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_context_getconfigdeps_1784235266"]
+// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_context_safetyverdict_1784235266" type="function" identity="safetyverdict" parent="none"]
+// CIL[DOC-MACRO purpose="Implements safetyverdict logic in cortex.functions.custom_cil-context"]
+// CIL[DOC-RESPONSIBILITY responsibility="Execute safetyverdict and return its computed result"]
+// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-context" 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 safetyverdict with safetyVerdict( 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 safetyVerdict(
+  chunk: any,
+  blastRadius: any[],
+  driftStatus: 'current' | 'stale' | 'unknown',
+  configDeps: any[]
+): { level: 'safe' | 'caution' | 'risky'; summary: string; flags: string[] } {
+  const d = chunk.data || {}
+  const flags: string[] = []
+
+  if (d.stability === 'stable') flags.push('stability=stable: downstream consumers may break on signature changes')
+  if (blastRadius.length >= 10) flags.push(`high blast radius: ${blastRadius.length} transitive callers`)
+  else if (blastRadius.length >= 3) flags.push(`moderate blast radius: ${blastRadius.length} callers`)
+  if (driftStatus === 'stale') flags.push('hash is stale — stored_hash does not match current disk content')
+  if (configDeps.length > 0) flags.push(`reads ${configDeps.length} config field(s): ${configDeps.map(c => c.field_name).join(', ')}`)
+  if (d.doc_confidence === 'unverified_legacy' || (!d.macro && !d.micro)) flags.push('no contract documentation — behaviour is undocumented')
+  if (d.is_dead_code) flags.push('flagged as dead code')
+
+  const level: 'safe' | 'caution' | 'risky' =
+    flags.length === 0 ? 'safe' :
+    (d.stability === 'stable' || blastRadius.length >= 10 || driftStatus === 'stale') ? 'risky' :
+    'caution'
+
+  const summary = level === 'safe'
+    ? 'Low risk. Internal chunk, no significant callers, contract is documented.'
+    : level === 'caution'
+    ? `Moderate risk. ${flags.length} concern(s) — review flags before editing.`
+    : `High risk. ${flags.filter(f => f.includes('stable') || f.includes('blast') || f.includes('stale')).join('; ')}`
+
+  return { level, summary, flags }
+}
+
+
+
+
+
+// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_context_safetyverdict_1784235266"]
+// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_context_buildbrief_1784235266" type="function" identity="buildbrief" parent="none"]
+// CIL[DOC-MACRO purpose="Implements buildbrief logic in cortex.functions.custom_cil-context"]
+// CIL[DOC-RESPONSIBILITY responsibility="Execute buildbrief and return its computed result"]
+// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-context" 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 buildbrief with buildBrief(chunk: any, maxBlastDepth = 4 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 buildBrief(chunk: any, maxBlastDepth = 4): Promise<Record<string, any>> {
+  const d = chunk.data || {}
+
+  
+  const [callsLinkTypeId, testedByLinkTypeId, configuresLinkTypeId] = await Promise.all([
+    resolveLinkTypeId('cil_calls').catch(() => null),
+    resolveLinkTypeId('cil_tested_by').catch(() => null),
+    resolveLinkTypeId('cil_configures').catch(() => null),
+  ])
+
+  
+  const blastRadius = callsLinkTypeId
+    ? await blastRadiusBFS(chunk.id, maxBlastDepth, callsLinkTypeId)
+    : []
+
+  
+  let callees: { chunk_id: string; chunk_name: string; file_path: string }[] = []
+  if (callsLinkTypeId) {
+    const { data: calleeLinks } = await adminDb.from('links').select('target_id')
+      .eq('link_type_id', callsLinkTypeId).eq('source_id', chunk.id)
+    for (const l of calleeLinks || []) {
+      const callee = await getChunkById(l.target_id)
+      if (callee) callees.push({ chunk_id: callee.id, chunk_name: callee.data?.chunk_name || '', file_path: callee.data?.file_path || '' })
+    }
+  }
+
+  
+  let testPaths: { path: string; is_e2e: boolean }[] = []
+  if (testedByLinkTypeId) {
+    const { data: testLinks } = await adminDb.from('links').select('target_id, metadata')
+      .eq('link_type_id', testedByLinkTypeId).eq('source_id', chunk.id)
+    for (const l of testLinks || []) {
+      testPaths.push({ path: l.metadata?.test_path || '', is_e2e: l.metadata?.is_e2e || false })
+    }
+  }
+  
+  if (testPaths.length === 0) {
+    if (d.test_unit_path) testPaths.push({ path: d.test_unit_path, is_e2e: false })
+    if (d.test_e2e_path)  testPaths.push({ path: d.test_e2e_path,  is_e2e: true  })
+  }
+
+  
+  const configDeps = await getConfigDeps(chunk.id, configuresLinkTypeId)
+
+  
+  const driftStatus: 'current' | 'stale' | 'unknown' = d.stored_hash
+    ? 'unknown' 
+    : 'unknown'
+
+  
+  const verdict = safetyVerdict(chunk, blastRadius, driftStatus, configDeps)
+
+  return {
+    chunk_id: chunk.id,
+    chunk_name: d.chunk_name || '',
+    file_path: d.file_path || '',
+    line_start: d.line_start || null,
+    line_end: d.line_end || null,
+    chunk_type: d.chunk_type || '',
+
+    
+    contract: {
+      macro:        d.macro        || '',
+      micro:        d.micro        || '',
+      input_spec:   d.input_spec   || '',
+      output_spec:  d.output_spec  || '',
+      side_effects: d.side_effects || '',
+      stability:    d.stability    || 'unknown',
+      doc_confidence: d.doc_confidence || 'unverified_legacy',
+    },
+
+    
+    hash: {
+      stored_hash: d.stored_hash || null,
+      hash_updated_at: d.hash_updated_at || null,
+      drift_status: driftStatus,
+    },
+
+    
+    blast_radius: {
+      direct_caller_count: blastRadius.filter(r => r.depth === 1).length,
+      total_affected: blastRadius.length,
+      max_depth_searched: maxBlastDepth,
+      callers: blastRadius,
+    },
+    calls: callees,
+
+    
+    test_paths: testPaths,
+
+    
+    config_dependencies: configDeps,
+
+    
+    edit_safety: verdict,
+  }
+}
+
+
+
+
+
+// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_context_buildbrief_1784235266"]
+// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_context_handler_1784235266" type="variable" identity="handler" parent="none"]
+// CIL[DOC-MACRO purpose="Defines handler configuration or state in cortex.functions.custom_cil-context"]
+// CIL[DOC-RESPONSIBILITY responsibility="Hold the value and default configuration for handler"]
+// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-context" 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-context" 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 || 'get_context'
+
+  
+  if (action === 'get_context') {
+    const chunkId = ctx.query?.chunk_id || body?.chunk_id
+    if (!chunkId) throw new Error('chunk_id is required')
+
+    const chunk = await getChunkById(chunkId)
+    if (!chunk) throw new Error(`Chunk not found: ${chunkId}`)
+
+    const maxDepth = parseInt(ctx.query?.max_depth || body?.max_depth || '4', 10)
+    const brief = await buildBrief(chunk, maxDepth)
+
+    return { ok: true, brief }
+  }
+
+  
+  if (action === 'find_context') {
+    const chunkName = ctx.query?.chunk_name || body?.chunk_name
+    const projectId = ctx.query?.project_id || body?.project_id
+    if (!chunkName) throw new Error('chunk_name is required')
+
+    const chunk = await findChunkByName(chunkName, projectId)
+    if (!chunk) {
+      return {
+        ok: false,
+        error: `No chunk named "${chunkName}" found${projectId ? ` in project ${projectId}` : ''}`,
+        hint: 'Use custom_cil-graph?action=search to find chunks by description',
+      }
+    }
+
+    const maxDepth = parseInt(ctx.query?.max_depth || body?.max_depth || '4', 10)
+    const brief = await buildBrief(chunk, maxDepth)
+
+    return { ok: true, brief }
+  }
+
+  
+  
+  
+  if (action === 'post_edit') {
+    const chunkId = ctx.query?.chunk_id || body?.chunk_id
+    if (!chunkId) throw new Error('chunk_id is required')
+
+    const chunk = await getChunkById(chunkId)
+    if (!chunk) throw new Error(`Chunk not found: ${chunkId}`)
+
+    const d = chunk.data || {}
+    const hasHash = !!d.stored_hash
+
+    return {
+      ok: true,
+      chunk_id: chunkId,
+      chunk_name: d.chunk_name || '',
+      file_path: d.file_path || '',
+      stored_hash: d.stored_hash || null,
+      hash_updated_at: d.hash_updated_at || null,
+      has_stored_hash: hasHash,
+      action_required: hasHash
+        ? 'Run custom_cil-ingest?action=reindex_chunk to refresh the stored hash and code_content after your edit, then run custom_cil-validate?action=validate_file to confirm drift is resolved.'
+        : 'No stored hash — run Pass 2 (custom_cil-ingest?action=pass2) to generate chunk boundaries and hashes for this file.',
+      next_steps: [
+        `POST /api/custom_cil-ingest?action=reindex_chunk { "project_id": "${d.project_id || '<project_id>'}", "chunk_id": "${chunkId}", "also_embed": true }`,
+        `GET  /api/custom_cil-validate?action=validate_file&file_id=${d.file_id || '<file_id>'}`,
+      ],
+    }
+  }
+
+  throw new Error(`Unknown action: ${action}. Valid: get_context, find_context, post_edit`)
+})
+
+
+
+// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_context_handler_1784235266"]