spine-framework 0.3.145 → 0.4.0

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

@@ -1,9 +1,32 @@
+// CIL[BEGIN stable_id="~/.framework/functions/cil-embeddings.ts:EMBED_SOURCE_STATUS:constant" type="constant" identity="EMBED_SOURCE_STATUS" parent="~/.framework/functions/cil-embeddings.ts"]
+// CIL[DOC-MACRO purpose="Defines the source and target status labels for embedding pipeline passes."]
+// CIL[DOC-RESPONSIBILITY responsibility="Holds the status mapping used to select files for first and second embedding passes."]
+// CIL[DOC-CONTEXT module="cil-embeddings" 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/cil-embeddings.ts,.framework/functions/embeddings.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Maps 'first' and 'second' pass keys to prior and target file status strings." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 
 const EMBED_SOURCE_STATUS: Record<'first' | 'second', { prior: string; target: string }> = {
-  first: { prior: '5-documented', target: '6-embedded' },
-  second: { prior: '8-enriched', target: '9-embedded' },
+  first: { prior: '6-enriched', target: '7-embedded-mapped' },
+  second: { prior: '6-enriched', target: '7-embedded-mapped' },
 }
-
+// CIL[DOC-VECTOR type="context" content="purpose='Defines the source and target status labels for embedding pipeline passes.'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/embeddings.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-embeddings.ts:EMBED_SOURCE_STATUS:constant"]
+
+// CIL[BEGIN stable_id="~/.framework/functions/cil-embeddings.ts:getEmbedSourceFilePaths:function" type="function" identity="getEmbedSourceFilePaths" parent="~/.framework/functions/cil-embeddings.ts"]
+// CIL[DOC-MACRO purpose="Selects source file paths that are ready for embedding."]
+// CIL[DOC-RESPONSIBILITY responsibility="Filters project file_statuses for entries matching the configured embedding source or target status."]
+// CIL[DOC-CONTEXT module="cil-embeddings" 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/cil-embeddings.ts,.framework/functions/embeddings.ts"]
+// CIL[DOC-CONTRACT inputs="projectItem: any, secondPass: boolean" outputs="string[]" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Extracts the relevant prior and target statuses from EMBED_SOURCE_STATUS and filters file paths accordingly." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function getEmbedSourceFilePaths(projectItem: any, secondPass: boolean): string[] {
   const fileStatuses: Record<string, string> = projectItem?.data?.file_statuses || {}
   const { prior, target } = secondPass ? EMBED_SOURCE_STATUS.second : EMBED_SOURCE_STATUS.first
@@ -11,12 +34,28 @@ function getEmbedSourceFilePaths(projectItem: any, secondPass: boolean): string[
     .filter(([, status]) => status === prior || status === target)
     .map(([filePath]) => filePath)
 }
-
+// CIL[DOC-VECTOR type="context" content="purpose='Selects source file paths that are ready for embedding.'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/embeddings.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-embeddings.ts:getEmbedSourceFilePaths:function"]
+
+// CIL[BEGIN stable_id="~/.framework/functions/cil-embeddings.ts:loadSourceChunks:function" type="function" identity="loadSourceChunks" parent="~/.framework/functions/cil-embeddings.ts"]
+// CIL[DOC-MACRO purpose="Loads CIL chunks from a set of source file paths in batches."]
+// CIL[DOC-RESPONSIBILITY responsibility="Queries the database for active cil_chunk items matching the requested file paths and returns a paginated result."]
+// CIL[DOC-CONTEXT module="cil-embeddings" 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/cil-embeddings.ts,.framework/functions/embeddings.ts"]
+// CIL[DOC-CONTRACT inputs="projectId: string, sourceFilePaths: string[], offset: number, limit: number, projectItem?: any" outputs="{ chunks: any[]; total: number }" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Splits file paths into batches, counts matching chunks, then fetches the requested page by stable id order." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 async function loadSourceChunks(
   projectId: string,
   sourceFilePaths: string[],
   offset: number,
-  limit: number
+  limit: number,
+  projectItem?: any
 ): Promise<{ chunks: any[]; total: number }> {
   if (sourceFilePaths.length === 0) return { chunks: [], total: 0 }
 
@@ -28,23 +67,20 @@ async function loadSourceChunks(
 
   for (let i = 0; i < sourceFilePaths.length; i += FILE_PATH_IN_BATCH) {
     const batch = sourceFilePaths.slice(i, i + FILE_PATH_IN_BATCH)
-    const [{ count }, { data, error }] = await Promise.all([
-      adminDb
-        .from('items')
-        .select('*', { count: 'exact', head: true })
-        .filter('data->>kb_type', 'eq', 'cil_chunk')
-        .filter('data->>project_id', 'eq', projectId)
-        .eq('is_active', true)
-        .in('data->>file_path' as any, batch),
-      adminDb
-        .from('items')
-        .select('id, data->>file_path')
-        .filter('data->>kb_type', 'eq', 'cil_chunk')
-        .filter('data->>project_id', 'eq', projectId)
-        .eq('is_active', true)
-        .in('data->>file_path' as any, batch)
-        .order('id'),
-    ])
+    let countQuery: any = (adminDb.from('items') as any)
+      .select('id', { count: 'exact', head: true })
+      .filter('data->>kb_type', 'eq', 'cil_chunk')
+      .filter('data->>project_id', 'eq', projectId)
+      .eq('is_active', true)
+      .in('data->>file_path' as any, batch)
+    let selectQuery: any = (adminDb.from('items') as any)
+      .select('id, data->>file_path')
+      .filter('data->>kb_type', 'eq', 'cil_chunk')
+      .filter('data->>project_id', 'eq', projectId)
+      .eq('is_active', true)
+      .in('data->>file_path' as any, batch)
+      .order('id')
+    const [{ count }, { data, error }] = await Promise.all([countQuery, selectQuery])
 
     if (error) throw new Error(`Failed to load source chunk ids: ${error.message}`)
     total += count || 0
@@ -66,31 +102,39 @@ async function loadSourceChunks(
   const ordered = pageIds.map(id => chunkMap.get(id)).filter(Boolean) as any[]
   return { chunks: ordered, total }
 }
-
-// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_embeddings_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-embeddings"]
-// CIL[DOC-RESPONSIBILITY responsibility="Own module-level imports, exports, and configuration for cortex.functions.custom_cil-embeddings"]
-// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-embeddings" 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-embeddings" 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="context" content="purpose='Loads CIL chunks from a set of source file paths in batches.'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/embeddings.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-embeddings.ts:loadSourceChunks:function"]
 
 
 
 
+
+// CIL[BEGIN stable_id="~/.framework/functions/cil-embeddings.ts:module_header:module_header" type="module_header" identity="module_header" parent="~/.framework/functions/cil-embeddings.ts"]
+// CIL[DOC-MACRO purpose="Netlify handler for CIL embedding, search, and status operations."]
+// CIL[DOC-RESPONSIBILITY responsibility="Imports dependencies and exposes the module's main embeddings handler and helpers."]
+// CIL[DOC-CONTEXT module="cil-embeddings" 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/embeddings.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Imports shared middleware, database, embedding utilities, CIL helpers, and registers the handler." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-AUDIENCE audience="internal"]
 import { createHandler } from './_shared/middleware'
 import { adminDb } from './_shared/db'
 import { generate } from './embeddings'
 import { callOpenAIEmbeddings, callEmbeddingApi } from './_shared/llm'
-import { FileStatus, FileTreeNode, isSelectedPath, getFileStatus, updateTreeNodeStatus, saveProjectTree } from './_shared/cil'
+import { FileStatus, FileTreeNode, isSelectedPath, getFileStatus, updateTreeNodeStatus, saveProjectTree, pipelineRank, computeContentHash, CIL_BOILERPLATE_PHRASES } from './_shared/cil'
+// CIL[DOC-VECTOR type="context" content="purpose='Netlify handler for CIL embedding, search, and status operations.'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/embeddings.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-embeddings.ts:module_header:module_header"]
 
 
 
@@ -98,62 +142,28 @@ import { FileStatus, FileTreeNode, isSelectedPath, getFileStatus, updateTreeNode
 
 
 
-// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_embeddings_module_header_1784235266"]
-// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_embeddings_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-embeddings"]
-// CIL[DOC-RESPONSIBILITY responsibility="Hold the value and default configuration for status_rank"]
-// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-embeddings" layer="function" related_files="[\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/functions/_shared/principal.ts\",\".framework/src/pages/admin/IntegrationsPage.tsx\",\".framework/src/pages/admin/RolesPage.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-embeddings" 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/src/pages/admin/RolesPage.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,
-}
 
 
 
 
-// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_embeddings_status_rank_1784235266"]
-// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_embeddings_rank_1784235266" type="function" identity="rank" parent="none"]
-// CIL[DOC-MACRO purpose="Implements rank logic in cortex.functions.custom_cil-embeddings"]
-// CIL[DOC-RESPONSIBILITY responsibility="Execute rank and return its computed result"]
-// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-embeddings" layer="function" related_files="[\".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[BEGIN stable_id="~/.framework/functions/cil-embeddings.ts:rank:function" type="function" identity="rank" parent="~/.framework/functions/cil-embeddings.ts"]
+// CIL[DOC-MACRO purpose="Returns the numeric pipeline rank for a status string."]
+// CIL[DOC-RESPONSIBILITY responsibility="Wraps the shared pipelineRank helper to provide a default of 0 for undefined statuses."]
+// CIL[DOC-CONTEXT module="cil-embeddings" 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/cil-embeddings.ts,.framework/functions/embeddings.ts"]
+// CIL[DOC-CONTRACT inputs="status: string | undefined" outputs="number" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Returns pipelineRank(status) when status is defined and 0 otherwise." notable_decisions="[]"]
+// 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: 1. Direct calls: 0. Related files: .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: 1. Total affected: 1."]
-// 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
+  return status ? pipelineRank(status) : 0
 }
+// CIL[DOC-VECTOR type="context" content="purpose='Returns the numeric pipeline rank for a status string.'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/embeddings.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-embeddings.ts:rank:function"]
 
 
 
@@ -161,42 +171,42 @@ function rank(status: string | undefined): number {
 
 
 
-// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_embeddings_rank_1784235266"]
-// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_embeddings_embedding_model_1784235266" type="variable" identity="embedding_model" parent="none"]
-// CIL[DOC-MACRO purpose="Defines embedding_model configuration or state in cortex.functions.custom_cil-embeddings"]
-// CIL[DOC-RESPONSIBILITY responsibility="Hold the value and default configuration for embedding_model"]
-// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-embeddings" layer="function" related_files="[\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/functions/_shared/principal.ts\",\".framework/src/pages/admin/IntegrationsPage.tsx\",\".framework/src/pages/admin/RolesPage.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="value of embedding_model" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Declares embedding_model with initial value or constant binding used by cortex.functions.custom_cil-embeddings" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[BEGIN stable_id="~/.framework/functions/cil-embeddings.ts:EMBEDDING_MODEL:constant" type="constant" identity="EMBEDDING_MODEL" parent="~/.framework/functions/cil-embeddings.ts"]
+// CIL[DOC-MACRO purpose="Defines the default OpenAI embedding model used for vector generation."]
+// CIL[DOC-RESPONSIBILITY responsibility="Holds the model name string passed to embedding API calls."]
+// CIL[DOC-CONTEXT module="cil-embeddings" 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/cil-embeddings.ts,.framework/functions/embeddings.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Stores the 'text-embedding-3-small' model identifier as a constant." notable_decisions="[]"]
+// 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: .framework/src/pages/admin/TypeDetailPage.tsx, .framework/functions/_shared/principal.ts, .framework/src/pages/admin/IntegrationsPage.tsx, .framework/src/pages/admin/RolesPage.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 EMBEDDING_MODEL = 'text-embedding-3-small'
+// CIL[DOC-VECTOR type="context" content="purpose='Defines the default OpenAI embedding model used for vector generation.'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/embeddings.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 EMBEDDING_MODEL = 'text-embedding-3-small'
+// CIL[END stable_id="~/.framework/functions/cil-embeddings.ts:EMBEDDING_MODEL:constant"]
 
 
 
 
-// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_embeddings_embedding_model_1784235266"]
-// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_embeddings_default_batch_size_1784235266" type="variable" identity="default_batch_size" parent="none"]
-// CIL[DOC-MACRO purpose="Defines default_batch_size configuration or state in cortex.functions.custom_cil-embeddings"]
-// CIL[DOC-RESPONSIBILITY responsibility="Hold the value and default configuration for default_batch_size"]
-// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-embeddings" layer="function" related_files="[\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/functions/_shared/principal.ts\",\".framework/src/pages/admin/IntegrationsPage.tsx\",\".framework/src/pages/admin/RolesPage.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="value of default_batch_size" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Declares default_batch_size with initial value or constant binding used by cortex.functions.custom_cil-embeddings" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[BEGIN stable_id="~/.framework/functions/cil-embeddings.ts:DEFAULT_BATCH_SIZE:constant" type="constant" identity="DEFAULT_BATCH_SIZE" parent="~/.framework/functions/cil-embeddings.ts"]
+// CIL[DOC-MACRO purpose="Defines the default number of embedding rows to insert per batch."]
+// CIL[DOC-RESPONSIBILITY responsibility="Provides a fallback batch size for bulk embedding insert operations."]
+// CIL[DOC-CONTEXT module="cil-embeddings" 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/cil-embeddings.ts,.framework/functions/embeddings.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Sets a constant default of 20 items per embedding insert batch." notable_decisions="[]"]
+// 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: .framework/src/pages/admin/TypeDetailPage.tsx, .framework/functions/_shared/principal.ts, .framework/src/pages/admin/IntegrationsPage.tsx, .framework/src/pages/admin/RolesPage.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_BATCH_SIZE = 20
+// CIL[DOC-VECTOR type="context" content="purpose='Defines the default number of embedding rows to insert per batch.'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/embeddings.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_BATCH_SIZE = 20
+// CIL[END stable_id="~/.framework/functions/cil-embeddings.ts:DEFAULT_BATCH_SIZE:constant"]
 
 
 
@@ -205,53 +215,55 @@ const DEFAULT_BATCH_SIZE = 20
 
 
 
-// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_embeddings_default_batch_size_1784235266"]
-// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_embeddings_vector_type_index_1784235266" type="variable" identity="vector_type_index" parent="none"]
-// CIL[DOC-MACRO purpose="Defines vector_type_index configuration or state in cortex.functions.custom_cil-embeddings"]
-// CIL[DOC-RESPONSIBILITY responsibility="Hold the value and default configuration for vector_type_index"]
-// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-embeddings" layer="function" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="value of vector_type_index" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Declares vector_type_index with initial value or constant binding used by cortex.functions.custom_cil-embeddings" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[BEGIN stable_id="~/.framework/functions/cil-embeddings.ts:VECTOR_TYPE_INDEX:constant" type="constant" identity="VECTOR_TYPE_INDEX" parent="~/.framework/functions/cil-embeddings.ts"]
+// CIL[DOC-MACRO purpose="Defines numeric chunk_index values for each embedding vector type."]
+// CIL[DOC-RESPONSIBILITY responsibility="Maps semantic, structure, context, blast_radius, configuration, and constraint vector names to fixed integer indices."]
+// CIL[DOC-CONTEXT module="cil-embeddings" 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/cil-embeddings.ts,.framework/functions/embeddings.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Records a static mapping from vector type names to their chunk_index values." notable_decisions="[]"]
+// 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"]
 const VECTOR_TYPE_INDEX: Record<string, number> = {
-  semantic:   0,
-  structural: 1,
-  contract:   2,
-  code:       3,
+  semantic:      0,
+  structure:     1,
+  context:       2,
+  blast_radius:  3,
+  configuration: 4,
+  constraint:    5,
 }
+// CIL[DOC-VECTOR type="context" content="purpose='Defines numeric chunk_index values for each embedding vector type.'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/embeddings.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-embeddings.ts:VECTOR_TYPE_INDEX:constant"]
 
 
 
 
 
 
-// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_embeddings_vector_type_index_1784235266"]
-// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_embeddings_embedding_prices_1784235266" type="variable" identity="embedding_prices" parent="none"]
-// CIL[DOC-MACRO purpose="Defines embedding_prices configuration or state in cortex.functions.custom_cil-embeddings"]
-// CIL[DOC-RESPONSIBILITY responsibility="Hold the value and default configuration for embedding_prices"]
-// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-embeddings" layer="function" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="value of embedding_prices" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Declares embedding_prices with initial value or constant binding used by cortex.functions.custom_cil-embeddings" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[BEGIN stable_id="~/.framework/functions/cil-embeddings.ts:EMBEDDING_PRICES:constant" type="constant" identity="EMBEDDING_PRICES" parent="~/.framework/functions/cil-embeddings.ts"]
+// CIL[DOC-MACRO purpose="Defines the per-million-token price for each supported embedding model."]
+// CIL[DOC-RESPONSIBILITY responsibility="Provides cost lookup for the embedding cost estimator."]
+// CIL[DOC-CONTEXT module="cil-embeddings" 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/cil-embeddings.ts,.framework/functions/embeddings.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Maps supported model names to their USD price per 1M tokens." notable_decisions="[]"]
+// 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"]
 const EMBEDDING_PRICES: Record<string, number> = {
   'text-embedding-3-small': 0.02,
   'text-embedding-3-large': 0.13,
   'text-embedding-ada-002': 0.10,
 }
+// CIL[DOC-VECTOR type="context" content="purpose='Defines the per-million-token price for each supported embedding model.'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/embeddings.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-embeddings.ts:EMBEDDING_PRICES:constant"]
 
 
 
@@ -262,21 +274,14 @@ const EMBEDDING_PRICES: Record<string, number> = {
 
 
 
-// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_embeddings_embedding_prices_1784235266"]
-// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_embeddings_buildsemantictext_1784235266" type="function" identity="buildsemantictext" parent="none"]
-// CIL[DOC-MACRO purpose="Implements buildsemantictext logic in cortex.functions.custom_cil-embeddings"]
-// CIL[DOC-RESPONSIBILITY responsibility="Execute buildsemantictext and return its computed result"]
-// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-embeddings" 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 buildsemantictext with buildSemanticText(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-embeddings.ts:buildSemanticText:function" type="function" identity="buildSemanticText" parent="~/.framework/functions/cil-embeddings.ts"]
+// CIL[DOC-MACRO purpose="Builds the searchable semantic text payload for a CIL chunk."]
+// CIL[DOC-RESPONSIBILITY responsibility="Combines chunk metadata, vector content, macro, micro, inputs, outputs, notes, and learnings into a single string."]
+// CIL[DOC-CONTEXT module="cil-embeddings" 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/cil-embeddings.ts,.framework/functions/embeddings.ts"]
+// CIL[DOC-CONTRACT inputs="chunk: any" outputs="string" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Assembles available chunk data fields into a dot-separated summary string for embedding." notable_decisions="[]"]
+// 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 function buildSemanticText(chunk: any): string {
   const d = chunk.data || {}
   const parts: string[] = []
@@ -285,10 +290,12 @@ export function buildSemanticText(chunk: any): string {
   if (d.file_path) parts.push(`in ${d.file_path}`)
 
   const vc = d.vector_content || {}
-  if (vc.context?.status === 'ready' && vc.context.content) {
+  const hasBoilerplate = (s: string) =>
+    CIL_BOILERPLATE_PHRASES.some(p => s.toLowerCase().includes(p.toLowerCase()))
+  if (vc.context?.status === 'ready' && vc.context.content && !hasBoilerplate(vc.context.content)) {
     parts.push(`Context: ${vc.context.content}`)
   }
-  if (vc.blast_radius?.status === 'ready' && vc.blast_radius.content) {
+  if (vc.blast_radius?.status === 'ready' && vc.blast_radius.content && !hasBoilerplate(vc.blast_radius.content)) {
     parts.push(`Blast radius: ${vc.blast_radius.content}`)
   }
 
@@ -308,24 +315,24 @@ export function buildSemanticText(chunk: any): string {
   }
   return parts.join('. ')
 }
+// CIL[DOC-VECTOR type="context" content="purpose='Builds the searchable semantic text payload for a CIL chunk.'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/embeddings.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-embeddings.ts:buildSemanticText:function"]
 
 
 
-// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_embeddings_buildsemantictext_1784235266"]
-// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_embeddings_buildstructuraltext_1784235266" type="function" identity="buildstructuraltext" parent="none"]
-// CIL[DOC-MACRO purpose="Implements buildstructuraltext logic in cortex.functions.custom_cil-embeddings"]
-// CIL[DOC-RESPONSIBILITY responsibility="Execute buildstructuraltext and return its computed result"]
-// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-embeddings" 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 buildstructuraltext with buildStructuralText(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-embeddings.ts:buildStructuralText:function" type="function" identity="buildStructuralText" parent="~/.framework/functions/cil-embeddings.ts"]
+// CIL[DOC-MACRO purpose="Builds a structural JSON text payload for a CIL chunk."]
+// CIL[DOC-RESPONSIBILITY responsibility="Serializes key chunk metadata fields into a compact JSON string for structural vector indexing."]
+// CIL[DOC-CONTEXT module="cil-embeddings" 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/cil-embeddings.ts,.framework/functions/embeddings.ts"]
+// CIL[DOC-CONTRACT inputs="chunk: any" outputs="string" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Converts chunk_name, chunk_type, file_path, stability, is_dead_code, and other flags into JSON." notable_decisions="[]"]
+// 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 function buildStructuralText(chunk: any): string {
   const d = chunk.data || {}
   return JSON.stringify({
@@ -339,24 +346,24 @@ export function buildStructuralText(chunk: any): string {
     review_status: d.review_status || '',
   })
 }
+// CIL[DOC-VECTOR type="context" content="purpose='Builds a structural JSON text payload for a CIL chunk.'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/embeddings.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-embeddings.ts:buildStructuralText:function"]
 
 
 
-// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_embeddings_buildstructuraltext_1784235266"]
-// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_embeddings_buildcontracttext_1784235266" type="function" identity="buildcontracttext" parent="none"]
-// CIL[DOC-MACRO purpose="Implements buildcontracttext logic in cortex.functions.custom_cil-embeddings"]
-// CIL[DOC-RESPONSIBILITY responsibility="Execute buildcontracttext and return its computed result"]
-// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-embeddings" 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 buildcontracttext with buildContractText(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-embeddings.ts:buildContractText:function" type="function" identity="buildContractText" parent="~/.framework/functions/cil-embeddings.ts"]
+// CIL[DOC-MACRO purpose="Builds the contract text payload for a CIL chunk."]
+// CIL[DOC-RESPONSIBILITY responsibility="Assembles input, output, side effect, and purpose descriptions into a contract vector string."]
+// CIL[DOC-CONTEXT module="cil-embeddings" 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/cil-embeddings.ts,.framework/functions/embeddings.ts"]
+// CIL[DOC-CONTRACT inputs="chunk: any" outputs="string" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Joins input_spec, output_spec, side_effects, and macro fields into a line-separated contract string." notable_decisions="[]"]
+// 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 function buildContractText(chunk: any): string {
   const d = chunk.data || {}
   const parts: string[] = []
@@ -366,10 +373,25 @@ export function buildContractText(chunk: any): string {
   if (d.macro) parts.push(`PURPOSE: ${d.macro}`)
   return parts.join('\n') || `${d.chunk_name || 'unknown'} — no contract yet`
 }
+// CIL[DOC-VECTOR type="context" content="purpose='Builds the contract text payload for a CIL chunk.'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/embeddings.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-embeddings.ts:buildContractText:function"]
 
 
 
 
+// CIL[BEGIN stable_id="~/.framework/functions/cil-embeddings.ts:buildCodeText:function" type="function" identity="buildCodeText" parent="~/.framework/functions/cil-embeddings.ts"]
+// CIL[DOC-MACRO purpose="Builds the code text payload for a CIL chunk."]
+// CIL[DOC-RESPONSIBILITY responsibility="Produces a human-readable code vector string from chunk metadata and stored code content."]
+// CIL[DOC-CONTEXT module="cil-embeddings" 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/cil-embeddings.ts,.framework/functions/embeddings.ts"]
+// CIL[DOC-CONTRACT inputs="chunk: any" outputs="string" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Joins chunk name, file path, chunk type, macro, micro, and raw code content into a text block." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function buildCodeText(chunk: any): string {
   const d = chunk.data || {}
   const parts: string[] = []
@@ -384,28 +406,61 @@ function buildCodeText(chunk: any): string {
   }
   return parts.join('\n') || `${d.chunk_name || 'unknown'} — no code content`
 }
+// CIL[DOC-VECTOR type="context" content="purpose='Builds the code text payload for a CIL chunk.'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/embeddings.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-embeddings.ts:buildCodeText:function"]
 
 
 
+// CIL[BEGIN stable_id="~/.framework/functions/cil-embeddings.ts:buildConstraintText:function" type="function" identity="buildConstraintText" parent="~/.framework/functions/cil-embeddings.ts"]
+// CIL[DOC-MACRO purpose="Builds the constraint text payload for a CIL chunk."]
+// CIL[DOC-RESPONSIBILITY responsibility="Combines constraint vector content with contract and purpose details for vector indexing."]
+// CIL[DOC-CONTEXT module="cil-embeddings" 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/cil-embeddings.ts,.framework/functions/embeddings.ts"]
+// CIL[DOC-CONTRACT inputs="chunk: any" outputs="string" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Adds constraint vector content when ready and falls back to input/output specs and macro." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+export function buildConstraintText(chunk: any): string {
+  const d = chunk.data || {}
+  const vc = d.vector_content || {}
+  const parts: string[] = []
+  if (vc.constraint?.status === 'ready' && vc.constraint.content) {
+    parts.push(vc.constraint.content)
+  }
+  if (d.input_spec) parts.push(`INPUTS: ${d.input_spec}`)
+  if (d.output_spec) parts.push(`OUTPUTS: ${d.output_spec}`)
+  if (d.side_effects) parts.push(`SIDE_EFFECTS: ${d.side_effects}`)
+  if (d.macro) parts.push(`PURPOSE: ${d.macro}`)
+  return parts.join('\n') || `${d.chunk_name || 'unknown'} — no constraint yet`
+}
+// CIL[DOC-VECTOR type="context" content="purpose='Builds the constraint text payload for a CIL chunk.'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/embeddings.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-embeddings.ts:buildConstraintText:function"]
+
+
 
 
 
-// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_embeddings_buildcontracttext_1784235266"]
-// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_embeddings_loadpendingchunks_1784235266" type="function" identity="loadpendingchunks" parent="none"]
-// CIL[DOC-MACRO purpose="Implements loadpendingchunks logic in cortex.functions.custom_cil-embeddings"]
-// CIL[DOC-RESPONSIBILITY responsibility="Execute loadpendingchunks and return its computed result"]
-// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-embeddings" 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-embeddings.ts:loadPendingChunks:function" type="function" identity="loadPendingChunks" parent="~/.framework/functions/cil-embeddings.ts"]
+// CIL[DOC-MACRO purpose="Loads approved CIL chunks for selected files that need embedding."]
+// CIL[DOC-RESPONSIBILITY responsibility="Queries active cil_file and cil_chunk items to find chunks matching the required status and selection."]
+// CIL[DOC-CONTEXT module="cil-embeddings" 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/cil-embeddings.ts,.framework/functions/embeddings.ts"]
+// CIL[DOC-CONTRACT inputs="projectId: string, selectedPaths: string[], requiredStatus: FileStatus, projectItem?: any" outputs="any[]" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Selects file ids with the required status, then filters active chunks by file_id." notable_decisions="[]"]
+// 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 loadPendingChunks(projectId: string, selectedPaths: string[], requiredStatus: FileStatus): Promise<any[]> {
+async function loadPendingChunks(projectId: string, selectedPaths: string[], requiredStatus: FileStatus, projectItem?: any): Promise<any[]> {
+  // The live project is scoped by project_id and is_active. The active_version_id is a
+  // pointer to the cil_version manifest, not a runtime filter.
   const { data: fileItems } = await adminDb
     .from('items')
     .select('id, data')
@@ -428,26 +483,26 @@ 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='Loads approved CIL chunks for selected files that need embedding.'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/embeddings.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-embeddings.ts:loadPendingChunks:function"]
 
 
 
 
 
-// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_embeddings_loadpendingchunks_1784235266"]
-// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_embeddings_maybeadvancefiletopass4_1784235266" type="function" identity="maybeadvancefiletopass4" parent="none"]
-// CIL[DOC-MACRO purpose="Implements maybeadvancefiletopass4 logic in cortex.functions.custom_cil-embeddings"]
-// CIL[DOC-RESPONSIBILITY responsibility="Execute maybeadvancefiletopass4 and return its computed result"]
-// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-embeddings" 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 maybeadvancefiletopass4 with maybeAdvanceFileToPass4( 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-embeddings.ts:maybeAdvanceFileToPass4:function" type="function" identity="maybeAdvanceFileToPass4" parent="~/.framework/functions/cil-embeddings.ts"]
+// CIL[DOC-MACRO purpose="Advances a file's pipeline status once all its chunks are embedded."]
+// CIL[DOC-RESPONSIBILITY responsibility="Checks embedding coverage for a file's stable ids, then updates file and project statuses if complete."]
+// CIL[DOC-CONTEXT module="cil-embeddings" 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/cil-embeddings.ts,.framework/functions/embeddings.ts"]
+// CIL[DOC-CONTRACT inputs="ctx: any, fileId: string, tree: FileTreeNode | null, secondPass: boolean, projectItem?: any" outputs="void" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Verifies all stable ids have active embeddings, then updates the cil_file status and file_tree when coverage is complete." notable_decisions="[]"]
+// 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 maybeAdvanceFileToPass4(
   ctx: any,
   fileId: string,
@@ -464,15 +519,15 @@ async function maybeAdvanceFileToPass4(
 
   if (!fileChunks || fileChunks.length === 0) return
 
-  const chunkIds = fileChunks.map((c: any) => c.id)
+  const stableIds = fileChunks.map((c: any) => c.data?.stable_id).filter(Boolean)
   const { data: embeddedDocs } = await adminDb
     .from('embeddings')
     .select('document_id')
-    .in('document_id', chunkIds)
+    .in('document_id', stableIds)
     .is('revoked_at', null)
 
   const embeddedChunkIds = new Set((embeddedDocs || []).map((e: any) => e.document_id))
-  const allEmbedded = chunkIds.every(id => embeddedChunkIds.has(id))
+  const allEmbedded = stableIds.every(id => embeddedChunkIds.has(id))
   if (!allEmbedded) return
 
   const { data: fileItem } = await adminDb
@@ -483,8 +538,8 @@ async function maybeAdvanceFileToPass4(
 
   if (!fileItem) return
 
-  const cil_file_status = secondPass ? 'pass7_complete' : 'pass4_complete'
-  const pipeline_status = secondPass ? '9-embedded' : '6-embedded'
+  const cil_file_status = secondPass ? '7-embedded-mapped' : '7-embedded-mapped'
+  const pipeline_status = secondPass ? '7-embedded-mapped' : '7-embedded-mapped'
   const currentFileStatus = getFileStatus(fileItem)
   const filePath: string = fileItem.data?.file_path
 
@@ -535,27 +590,27 @@ async function maybeAdvanceFileToPass4(
     projectItem.data.file_statuses = fileStatuses
   }
 }
+// CIL[DOC-VECTOR type="context" content="purpose='Advances a file's pipeline status once all its chunks are embedded.'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/embeddings.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-embeddings.ts:maybeAdvanceFileToPass4:function"]
 
 
 
 
 
-// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_embeddings_maybeadvancefiletopass4_1784235266"]
 
-// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_embeddings_contenthash_1784235266" type="function" identity="contenthash" parent="none"]
-// CIL[DOC-MACRO purpose="Implements contenthash logic in cortex.functions.custom_cil-embeddings"]
-// CIL[DOC-RESPONSIBILITY responsibility="Execute contenthash and return its computed result"]
-// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-embeddings" 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 contenthash with contentHash(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-embeddings.ts:contentHash:function" type="function" identity="contentHash" parent="~/.framework/functions/cil-embeddings.ts"]
+// CIL[DOC-MACRO purpose="Computes a 32-bit FNV-1a hash for a string."]
+// CIL[DOC-RESPONSIBILITY responsibility="Provides a fast content hash for comparing embedding input texts."]
+// CIL[DOC-CONTEXT module="cil-embeddings" 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/cil-embeddings.ts,.framework/functions/embeddings.ts"]
+// CIL[DOC-CONTRACT inputs="text: string" outputs="string" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Iterates over characters, mixing each into an FNV-style 32-bit integer and returning a zero-padded hex string." notable_decisions="[]"]
+// 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 function contentHash(text: string): string {
   
   let h = 2166136261
@@ -565,50 +620,60 @@ export function contentHash(text: string): string {
   }
   return (h >>> 0).toString(16).padStart(8, '0')
 }
+// CIL[DOC-VECTOR type="context" content="purpose='Computes a 32-bit FNV-1a hash for a string.'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/embeddings.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-embeddings.ts:contentHash:function"]
 
 
 
 
 
-// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_embeddings_contenthash_1784235266"]
-// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_embeddings_embedchunk_1784235266" type="function" identity="embedchunk" parent="none"]
-// CIL[DOC-MACRO purpose="Implements embedchunk logic in cortex.functions.custom_cil-embeddings"]
-// CIL[DOC-RESPONSIBILITY responsibility="Execute embedchunk and return its computed result"]
-// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-embeddings" 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 embedchunk with embedChunk( 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-embeddings.ts:embedChunk:function" type="function" identity="embedChunk" parent="~/.framework/functions/cil-embeddings.ts"]
+// CIL[DOC-MACRO purpose="Generates or updates OpenAI embeddings for a single CIL chunk."]
+// CIL[DOC-RESPONSIBILITY responsibility="Builds vector texts, hashes them, calls the embedding API, and upserts rows in the embeddings table."]
+// CIL[DOC-CONTEXT module="cil-embeddings" 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/cil-embeddings.ts,.framework/functions/embeddings.ts"]
+// CIL[DOC-CONTRACT inputs="chunkItem: any, accountId: string, forceRegenerate: boolean" outputs="{ created: string[]; skipped: string[]; error?: string }" errors="Embedding API failures" side_effects="Inserts or updates rows in the embeddings table"]
+// CIL[DOC-MICRO logic_summary="Skips unchanged vectors, calls the embedding API for new or changed texts, and writes the resulting vector rows." notable_decisions="[]"]
+// 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 async function embedChunk(
   chunkItem: any,
   accountId: string,
   forceRegenerate: boolean
 ): Promise<{ created: string[]; skipped: string[]; error?: string }> {
   const chunkId = chunkItem.id
+  const stableId = chunkItem.data?.stable_id || chunkId
   const created: string[] = []
   const skipped: string[] = []
 
   
+  const d = chunkItem.data || {}
+  const vc = d.vector_content || {}
+  const vectorReadyText = (t: string) => (vc[t]?.status === 'ready' && vc[t]?.content ? vc[t].content : '')
   const vectors: { type: string; text: string }[] = [
-    { type: 'semantic',   text: buildSemanticText(chunkItem) },
-    { type: 'structural', text: buildStructuralText(chunkItem) },
-    { type: 'contract',   text: buildContractText(chunkItem) },
-    { type: 'code',       text: buildCodeText(chunkItem) },
+    { type: 'semantic',      text: buildSemanticText(chunkItem) },
+    { type: 'structure',     text: buildStructuralText(chunkItem) },
+    { type: 'context',       text: vectorReadyText('context') },
+    { type: 'blast_radius',  text: vectorReadyText('blast_radius') },
+    { type: 'configuration', text: vectorReadyText('configuration') },
+    { type: 'constraint',    text: buildConstraintText(chunkItem) },
   ].filter(v => v.text.trim().length > 0)
 
   if (!vectors.length) return { created, skipped: ['all:empty'] }
 
   
+  // Retire legacy chunk-UUID keyed embeddings now that stable_id is the document key
+  await adminDb.from('embeddings').delete().eq('document_id', chunkId)
+
+  
   const { data: existing } = await adminDb
     .from('embeddings')
     .select('id, content_hash, metadata')
-    .eq('document_id', chunkId)
+    .eq('document_id', stableId)
 
   const existingMap = new Map<string, any>()
   for (const row of existing || []) {
@@ -616,15 +681,15 @@ export async function embedChunk(
   }
 
   if (forceRegenerate && (existing || []).length > 0) {
-    await adminDb.from('embeddings').delete().eq('document_id', chunkId)
+    await adminDb.from('embeddings').delete().eq('document_id', stableId)
     existingMap.clear()
   }
 
   
   const toEmbed = vectors.filter(v => {
-    const hash = contentHash(v.text)
+    const inputHash = contentHash(v.text)
     const row = existingMap.get(v.type)
-    if (row && row.content_hash === hash) { skipped.push(v.type); return false }
+    if (row && row.metadata?.input_hash === inputHash) { skipped.push(v.type); return false }
     return true
   })
 
@@ -636,7 +701,8 @@ export async function embedChunk(
 
     for (let i = 0; i < toEmbed.length; i++) {
       const { type, text } = toEmbed[i]
-      const hash = contentHash(text)
+      const hash = computeContentHash(text)
+      const inputHash = contentHash(text)
       const existingRow = existingMap.get(type)
 
       
@@ -645,7 +711,7 @@ export async function embedChunk(
       const row = {
         account_id:   accountId,
         model_id:     EMBEDDING_MODEL,
-        document_id:  chunkId,
+        document_id:  stableId,
         chunk_index:  VECTOR_TYPE_INDEX[type] ?? 0,
         content:      text,
         embedding:    vectorLiteral,
@@ -661,6 +727,8 @@ export async function embedChunk(
           chunk_name:     chunkItem.data?.chunk_name || '',
           file_path:      chunkItem.data?.file_path || '',
           project_id:     chunkItem.data?.project_id || '',
+          version_id:     chunkItem.data?.version_id || '',
+          input_hash:     inputHash,
         },
       }
 
@@ -677,26 +745,26 @@ export async function embedChunk(
 
   return { created, skipped }
 }
+// CIL[DOC-VECTOR type="context" content="purpose='Generates or updates OpenAI embeddings for a single CIL chunk.'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/embeddings.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-embeddings.ts:embedChunk:function"]
 
 
 
 
 
-// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_embeddings_embedchunk_1784235266"]
-// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_embeddings_semanticsearch_1784235266" type="function" identity="semanticsearch" parent="none"]
-// CIL[DOC-MACRO purpose="Implements semanticsearch logic in cortex.functions.custom_cil-embeddings"]
-// CIL[DOC-RESPONSIBILITY responsibility="Execute semanticsearch and return its computed result"]
-// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-embeddings" 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 semanticsearch with semanticSearch( 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-embeddings.ts:semanticSearch:function" type="function" identity="semanticSearch" parent="~/.framework/functions/cil-embeddings.ts"]
+// CIL[DOC-MACRO purpose="Performs a semantic search over embedded CIL chunks."]
+// CIL[DOC-RESPONSIBILITY responsibility="Embeds a query, calls the match_embeddings RPC, and returns matching chunk metadata."]
+// CIL[DOC-CONTEXT module="cil-embeddings" 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/cil-embeddings.ts,.framework/functions/embeddings.ts"]
+// CIL[DOC-CONTRACT inputs="query: string, projectId: string | null, limit: number, accountId: string" outputs="any[]" errors="Embedding or RPC failures" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Generates a query embedding, runs match_embeddings, resolves chunks by stable_id, and applies project filtering." notable_decisions="[]"]
+// 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 semanticSearch(
   query: string,
   projectId: string | null,
@@ -723,15 +791,15 @@ async function semanticSearch(
   if (error) throw new Error(`match_embeddings RPC error: ${error.message}`)
 
   
-  const chunkIds = [...new Set((matches || []).map((m: any) => m.document_id))]
-  if (!chunkIds.length) return []
+  const stableIds = [...new Set((matches || []).map((m: any) => m.document_id))]
+  if (!stableIds.length) return []
 
   const { data: chunks } = await adminDb
     .from('items')
     .select('id, title, data')
-    .in('id', chunkIds)
+    .in('data->>stable_id', stableIds)
 
-  const chunkMap = new Map((chunks || []).map((c: any) => [c.id, c]))
+  const chunkMap = new Map((chunks || []).map((c: any) => [c.data?.stable_id, c]))
 
   return (matches || [])
     .filter((m: any) => {
@@ -743,7 +811,7 @@ async function semanticSearch(
     .map((m: any) => {
       const chunk = chunkMap.get(m.document_id)
       return {
-        chunk_id: m.document_id,
+        chunk_id: chunk?.data?.stable_id || m.document_id,
         chunk_name: chunk?.data?.chunk_name || chunk?.title || '',
         file_path: chunk?.data?.file_path || '',
         macro: chunk?.data?.macro || '',
@@ -757,50 +825,50 @@ async function semanticSearch(
     })
     .slice(0, limit)
 }
+// CIL[DOC-VECTOR type="context" content="purpose='Performs a semantic search over embedded CIL chunks.'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/embeddings.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-embeddings.ts:semanticSearch:function"]
 
 
 
 
 
-// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_embeddings_semanticsearch_1784235266"]
-// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_embeddings_getplatformaccountid_1784235266" type="function" identity="getplatformaccountid" parent="none"]
-// CIL[DOC-MACRO purpose="Implements getplatformaccountid logic in cortex.functions.custom_cil-embeddings"]
-// CIL[DOC-RESPONSIBILITY responsibility="Execute getplatformaccountid and return its computed result"]
-// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-embeddings" 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 getplatformaccountid with getPlatformAccountId( 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-embeddings.ts:getPlatformAccountId:function" type="function" identity="getPlatformAccountId" parent="~/.framework/functions/cil-embeddings.ts"]
+// CIL[DOC-MACRO purpose="Resolves the spine-system account id for platform-wide operations."]
+// CIL[DOC-RESPONSIBILITY responsibility="Looks up the 'spine-system' account record and returns its id."]
+// CIL[DOC-CONTEXT module="cil-embeddings" 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/cil-embeddings.ts,.framework/functions/embeddings.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="string" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Queries the accounts table for the slug 'spine-system' and returns the id or an empty string." notable_decisions="[]"]
+// 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 getPlatformAccountId(): Promise<string> {
   const { data } = await adminDb.from('accounts').select('id').eq('slug', 'spine-system').maybeSingle()
   return data?.id || ''
 }
+// CIL[DOC-VECTOR type="context" content="purpose='Resolves the spine-system account id for platform-wide operations.'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/embeddings.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-embeddings.ts:getPlatformAccountId:function"]
 
 
 
 
 
-// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_embeddings_getplatformaccountid_1784235266"]
-// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_embeddings_handler_1784235266" type="variable" identity="handler" parent="none"]
-// CIL[DOC-MACRO purpose="Defines handler configuration or state in cortex.functions.custom_cil-embeddings"]
-// CIL[DOC-RESPONSIBILITY responsibility="Hold the value and default configuration for handler"]
-// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-embeddings" 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-embeddings" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[BEGIN stable_id="~/.framework/functions/cil-embeddings.ts:handler:constant" type="constant" identity="handler" parent="~/.framework/functions/cil-embeddings.ts"]
+// CIL[DOC-MACRO purpose="Exposes the Netlify function handler for embedding and search actions."]
+// CIL[DOC-RESPONSIBILITY responsibility="Routes action requests to estimate, embed_chunk, embed_project, embed_approved, status, search, and delete logic."]
+// CIL[DOC-CONTEXT module="cil-embeddings" 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/cil-embeddings.ts,.framework/functions/embeddings.ts"]
+// CIL[DOC-CONTRACT inputs="ctx: any, body: any" outputs="unknown" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Uses createHandler to dispatch action types and process embedding jobs through the CIL pipeline." notable_decisions="[]"]
+// 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
   const accountId = ctx.accountId || await getPlatformAccountId()
@@ -835,18 +903,18 @@ export const handler = createHandler(async (ctx, body) => {
     }
 
     
-    const chunkIds = (chunks || []).map((c: any) => c.id)
+    const chunkStableIds = (chunks || []).map((c: any) => c.data?.stable_id).filter(Boolean)
     const existingDocIds = new Set<string>()
     const SUPABASE_IN_LIMIT = 500
-    for (let i = 0; i < chunkIds.length; i += SUPABASE_IN_LIMIT) {
+    for (let i = 0; i < chunkStableIds.length; i += SUPABASE_IN_LIMIT) {
       const { data: emb } = await adminDb
         .from('embeddings')
         .select('document_id')
-        .in('document_id', chunkIds.slice(i, i + SUPABASE_IN_LIMIT))
+        .in('document_id', chunkStableIds.slice(i, i + SUPABASE_IN_LIMIT))
       for (const row of emb || []) existingDocIds.add(row.document_id)
     }
 
-    const toEmbed = (chunks || []).filter((c: any) => !existingDocIds.has(c.id))
+    const toEmbed = (chunks || []).filter((c: any) => !existingDocIds.has(c.data?.stable_id))
     const alreadyEmbedded = (chunks || []).length - toEmbed.length
 
     
@@ -875,20 +943,30 @@ export const handler = createHandler(async (ctx, body) => {
 
   
   if (action === 'embed_chunk') {
-    const chunkId = body?.chunk_id || ctx.query?.chunk_id
-    if (!chunkId) throw new Error('chunk_id is required')
+    const projectId = body?.project_id || ctx.query?.project_id
+    const stableId = body?.stable_id || ctx.query?.stable_id
+    const versionId = body?.version_id || ctx.query?.version_id
+    if (!projectId) throw new Error('project_id is required')
+    if (!stableId) throw new Error('stable_id is required')
 
-    const { data: chunk, error } = await adminDb
+    let q = adminDb
       .from('items')
       .select('id, title, data')
-      .eq('id', chunkId)
-      .maybeSingle()
+      .filter('data->>kb_type', 'eq', 'cil_chunk')
+      .filter('data->>project_id', 'eq', projectId)
+      .filter('data->>stable_id', 'eq', stableId)
+      .eq('is_active', true)
+    if (versionId) q = (q as any).filter('data->>version_id', 'eq', versionId)
 
-    if (error || !chunk) throw new Error(`Chunk not found: ${chunkId}`)
+    const { data: chunk, error } = await (q as any).maybeSingle()
+
+    if (error || !chunk) throw new Error(`Chunk not found: ${stableId}`)
 
     const result = await embedChunk(chunk, accountId, body?.force_regenerate ?? false)
     return {
-      chunk_id: chunkId,
+      project_id: projectId,
+      stable_id: stableId,
+      version_id: versionId || chunk.data?.version_id || null,
       chunk_name: chunk.data?.chunk_name || '',
       ...result,
     }
@@ -927,13 +1005,13 @@ export const handler = createHandler(async (ctx, body) => {
 
     if (action === 'embed_approved' && selectedPaths.length > 0 && !filePath) {
       
-      const pending = await loadPendingChunks(projectId, selectedPaths, 'pass3_complete')
+      const pending = await loadPendingChunks(projectId, selectedPaths, '3-documented', projectItem)
       const sorted = pending.sort((a: any, b: any) => a.id.localeCompare(b.id))
       totalChunks = sorted.length
       pageChunks = sorted.slice(pageOffset, pageOffset + pageLimit)
     } else {
       const sourceFilePaths = filePath ? [filePath] : getEmbedSourceFilePaths(projectItem, secondPass)
-      const sourceChunks = await loadSourceChunks(projectId, sourceFilePaths, pageOffset, pageLimit)
+      const sourceChunks = await loadSourceChunks(projectId, sourceFilePaths, pageOffset, pageLimit, projectItem)
       totalChunks = sourceChunks.total
       pageChunks = sourceChunks.chunks
       error = null
@@ -946,14 +1024,14 @@ export const handler = createHandler(async (ctx, body) => {
     }
 
     
-    const pageChunkIds = pageChunks.map((c: any) => c.id)
+    const pageChunkDocumentIds = pageChunks.map((c: any) => c.data?.stable_id || c.id)
     const SUPABASE_IN_LIMIT = 500
     const existingRows: any[] = []
-    for (let i = 0; i < pageChunkIds.length; i += SUPABASE_IN_LIMIT) {
+    for (let i = 0; i < pageChunkDocumentIds.length; i += SUPABASE_IN_LIMIT) {
       const { data } = await adminDb
         .from('embeddings')
         .select('id, document_id, content_hash, metadata')
-        .in('document_id', pageChunkIds.slice(i, i + SUPABASE_IN_LIMIT))
+        .in('document_id', pageChunkDocumentIds.slice(i, i + SUPABASE_IN_LIMIT))
       existingRows.push(...(data || []))
     }
 
@@ -969,28 +1047,34 @@ export const handler = createHandler(async (ctx, body) => {
     let totalSkipped = 0
 
     for (const chunk of pageChunks) {
+      const d = chunk.data || {}
+      const vc = d.vector_content || {}
+      const vectorReadyText = (t: string) => (vc[t]?.status === 'ready' && vc[t]?.content ? vc[t].content : '')
       const vectors = [
-        { type: 'semantic',   text: buildSemanticText(chunk) },
-        { type: 'structural', text: buildStructuralText(chunk) },
-        { type: 'contract',   text: buildContractText(chunk) },
-        { type: 'code',       text: buildCodeText(chunk) },
+        { type: 'semantic',      text: buildSemanticText(chunk) },
+        { type: 'structure',     text: buildStructuralText(chunk) },
+        { type: 'context',       text: vectorReadyText('context') },
+        { type: 'blast_radius',  text: vectorReadyText('blast_radius') },
+        { type: 'configuration', text: vectorReadyText('configuration') },
+        { type: 'constraint',    text: buildConstraintText(chunk) },
       ].filter(v => v.text.trim().length > 0)
 
+      const chunkStableId = chunk.data?.stable_id || chunk.id
       for (const v of vectors) {
-        const hash = contentHash(v.text)
-        const existing = existingMap.get(chunk.id)?.get(v.type)
-        if (!forceRegenerate && existing && existing.content_hash === hash) {
+        const inputHash = contentHash(v.text)
+        const existing = existingMap.get(chunkStableId)?.get(v.type)
+        if (!forceRegenerate && existing && existing.metadata?.input_hash === inputHash) {
           totalSkipped++
           continue
         }
-        toEmbed.push({ chunkId: chunk.id, type: v.type, text: v.text, existingRowId: existing?.id })
+        toEmbed.push({ chunkId: chunkStableId, type: v.type, text: v.text, existingRowId: existing?.id })
       }
     }
 
     
     
     
-    const targetPipelineStatus = secondPass ? '9-embedded' : '6-embedded'
+    const targetPipelineStatus = secondPass ? '7-embedded-mapped' : '7-embedded-mapped'
 
     const advanceFiles = async () => {
       const affectedFileIds = [...new Set(pageChunks.map(c => c.data?.file_id).filter(Boolean))]
@@ -1018,9 +1102,9 @@ export const handler = createHandler(async (ctx, body) => {
     }
 
     
-    if (forceRegenerate && pageChunkIds.length > 0) {
-      for (let i = 0; i < pageChunkIds.length; i += SUPABASE_IN_LIMIT) {
-        await adminDb.from('embeddings').delete().in('document_id', pageChunkIds.slice(i, i + SUPABASE_IN_LIMIT))
+    if (forceRegenerate && pageChunkDocumentIds.length > 0) {
+      for (let i = 0; i < pageChunkDocumentIds.length; i += SUPABASE_IN_LIMIT) {
+        await adminDb.from('embeddings').delete().in('document_id', pageChunkDocumentIds.slice(i, i + SUPABASE_IN_LIMIT))
       }
       for (const item of toEmbed) { item.existingRowId = undefined }
     }
@@ -1053,7 +1137,7 @@ export const handler = createHandler(async (ctx, body) => {
 
     
     const now = new Date().toISOString()
-    const chunkMap = new Map(pageChunks.map((c: any) => [c.id, c]))
+    const chunkMap = new Map(pageChunks.map((c: any) => [c.data?.stable_id || c.id, c]))
 
     const rowsToInsert: object[] = []
     const rowsToUpdate: { id: string; row: object }[] = []
@@ -1064,6 +1148,8 @@ export const handler = createHandler(async (ctx, body) => {
       if (!vec || vec.length === 0) continue
 
       const chunk = chunkMap.get(chunkId)
+      const hash = computeContentHash(text)
+      const inputHash = contentHash(text)
       const row = {
         account_id:   accountId,
         model_id:     EMBEDDING_MODEL,
@@ -1071,7 +1157,7 @@ export const handler = createHandler(async (ctx, body) => {
         chunk_index:  VECTOR_TYPE_INDEX[type] ?? 0,
         content:      text,
         embedding:    `[${vec.join(',')}]`,
-        content_hash: contentHash(text),
+        content_hash: hash,
         approved_at:  now,
         revoked_at:   null,
         metadata: {
@@ -1083,6 +1169,8 @@ export const handler = createHandler(async (ctx, body) => {
           chunk_name:     chunk?.data?.chunk_name || '',
           file_path:      chunk?.data?.file_path || '',
           project_id:     projectId,
+          version_id:     chunk?.data?.version_id || '',
+          input_hash:     inputHash,
         },
       }
 
@@ -1104,7 +1192,7 @@ export const handler = createHandler(async (ctx, body) => {
       for (const { id, row } of rowsToUpdate.slice(i, i + PARALLEL_UPDATE)) {
         updatePromises.push(
           adminDb.from('embeddings').update(row).eq('id', id)
-            .then(({ error: e }) => { if (e) errors.push(`embedding update ${id}: ${e.message}`) })
+            .then(({ error: e }) => { if (e) errors.push(`embedding update ${id}: ${e.message}`) }) as Promise<void>
         )
       }
     }
@@ -1139,33 +1227,22 @@ export const handler = createHandler(async (ctx, body) => {
       .filter('data->>project_id', 'eq', projectId)
       .eq('is_active', true)
 
-    
-    const { data: chunkItems } = await adminDb
-      .from('items')
-      .select('id')
-      .filter('data->>kb_type', 'eq', 'cil_chunk')
-      .filter('data->>project_id', 'eq', projectId)
-      .eq('is_active', true)
-
-    const chunkIds = (chunkItems || []).map((c: any) => c.id)
-    let embeddedCount = 0
+    const { count: embeddedCount } = await adminDb
+      .from('embeddings')
+      .select('document_id', { count: 'exact', head: true })
+      .filter('metadata->>project_id', 'eq', projectId)
+      .filter('metadata->>vector_type', 'eq', 'semantic')
+      .not('approved_at', 'is', null)
+      .is('revoked_at', null)
 
-    if (chunkIds.length > 0) {
-      const { data: embeddedDocs } = await adminDb
-        .from('embeddings')
-        .select('document_id')
-        .in('document_id', chunkIds)
-        .is('revoked_at', null)
-
-      embeddedCount = new Set((embeddedDocs || []).map((e: any) => e.document_id)).size
-    }
+    const safeEmbeddedCount = embeddedCount || 0
 
     return {
       project_id: projectId,
       total_chunks: totalChunks || 0,
-      embedded_chunks: embeddedCount,
-      unembedded_chunks: (totalChunks || 0) - embeddedCount,
-      coverage_pct: totalChunks ? Math.round((embeddedCount / totalChunks) * 100) : 0,
+      embedded_chunks: safeEmbeddedCount,
+      unembedded_chunks: (totalChunks || 0) - safeEmbeddedCount,
+      coverage_pct: totalChunks ? Math.round((safeEmbeddedCount / totalChunks) * 100) : 0,
     }
   }
 
@@ -1185,18 +1262,30 @@ export const handler = createHandler(async (ctx, body) => {
     const chunkId = body?.chunk_id || ctx.query?.chunk_id
     if (!chunkId) throw new Error('chunk_id is required')
 
+    const { data: chunkItem } = await adminDb
+      .from('items')
+      .select('data')
+      .eq('id', chunkId)
+      .maybeSingle()
+    const stableId = chunkItem?.data?.stable_id || chunkId
+
     const { error } = await adminDb
       .from('embeddings')
       .delete()
-      .eq('document_id', chunkId)
+      .eq('document_id', stableId)
 
     if (error) throw new Error(`Failed to delete embeddings: ${error.message}`)
-    return { chunk_id: chunkId, deleted: true }
+    return { chunk_id: stableId, deleted: true }
   }
 
   throw new Error(`Unknown action: ${action}. Valid: embed_chunk, embed_project, embed_approved, status, search, delete`)
 })
+// CIL[DOC-VECTOR type="context" content="purpose='Exposes the Netlify function handler for embedding and search actions.'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/embeddings.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-embeddings.ts:handler:constant"]
 
 
-
-// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_embeddings_handler_1784235266"]