spine-framework 0.3.144 → 0.4.0

package/.framework/functions/cil-agent-ingest.ts

@@ -1,47 +1,42 @@
-// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_agent_ingest_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-agent-ingest"]
-// CIL[DOC-RESPONSIBILITY responsibility="Own module-level imports, exports, and configuration for cortex.functions.custom_cil-agent-ingest"]
-// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-agent-ingest" 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-agent-ingest" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[BEGIN stable_id="~/.framework/functions/cil-agent-ingest.ts:module_header:module_header" type="module_header" identity="module_header" parent="~/.framework/functions/cil-agent-ingest.ts"]
+// CIL[DOC-MACRO purpose="Netlify function that ingests and synchronises agent-annotated CIL chunks for a project."]
+// CIL[DOC-RESPONSIBILITY responsibility="Expose actions for selecting files, storing markers, updating documentation, detecting changes, marking dead code, and renaming files."]
+// CIL[DOC-CONTEXT module="cil-agent-ingest" layer="functions" related_files=".framework/functions/_shared/db.ts,.framework/functions/_shared/middleware.ts,.framework/functions/_shared/resolve-ids.ts,.framework/functions/admin-data.ts"]
+// CIL[DOC-CONTRACT inputs="project_id and action query" outputs="action-specific JSON payload" errors="Project not found or invalid action" side_effects="Reads and writes CIL chunk records in the admin database"]
+// CIL[DOC-MICRO logic_summary="Imports shared middleware, db, admin-data, resolveTypeId and Node fs, path and crypto; declares a createHandler export." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.85" flags="none"]
 // CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-AUDIENCE audience="developer"]
-// CIL[DOC-VECTOR type="context" content="Layer: function. Direct callers: 0. Direct calls: 0. Related files: .framework/migrations/015_simplify_apps_table.sql, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, custom/apps/portal/pages/ContentPage.tsx, .framework/src/components/ui/table-primitives.tsx, .framework/src/pages/admin/TypeDetailPage.tsx, \."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
-// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
-// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[DOC-AUDIENCE audience="cil-workers"]
 
 
 import { createHandler } from './_shared/middleware'
 import { adminDb } from './_shared/db'
 import { create as adminCreate, update as adminUpdate } from './admin-data'
 import { resolveTypeId } from './_shared/resolve-ids'
+import { computeContentHash } from './_shared/cil'
 import * as fs from 'fs'
 import * as path from 'path'
 import * as crypto from 'crypto'
+// CIL[DOC-VECTOR type="context" content="purpose='Netlify function that ingests and synchronises agent-annotated CIL chunks for a project.'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/admin-data.ts"]
+// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
+// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
+// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[END stable_id="~/.framework/functions/cil-agent-ingest.ts:module_header:module_header"]
 
 
 
 
 
-// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_agent_ingest_module_header_1784235266"]
-// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_agent_ingest_agentingestrequest_1784235266" type="interface" identity="agentingestrequest" parent="none"]
-// CIL[DOC-MACRO purpose="Defines the agentingestrequest type contract in cortex.functions.custom_cil-agent-ingest"]
-// CIL[DOC-RESPONSIBILITY responsibility="Describe the shape and allowed fields for agentingestrequest"]
-// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-agent-ingest" layer="function" related_files="[\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/functions/_shared/principal.ts\",\".framework/src/pages/admin/IntegrationsPage.tsx\",\".framework/migrations/015_simplify_apps_table.sql\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="type definition for agentingestrequest" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Declares TypeScript type/interface agentingestrequest with member definitions" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[BEGIN stable_id="~/.framework/functions/cil-agent-ingest.ts:AgentIngestRequest:interface" type="interface" identity="AgentIngestRequest" parent="~/.framework/functions/cil-agent-ingest.ts"]
+// CIL[DOC-MACRO purpose="Defines the request payload accepted by the cil-agent-ingest handler."]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide a strongly-typed contract for project_id, file metadata, marker arrays, chunk updates and rename parameters."]
+// CIL[DOC-CONTEXT module="cil-agent-ingest" layer="types" related_files=".framework/functions/_shared/db.ts,.framework/functions/_shared/middleware.ts,.framework/functions/_shared/resolve-ids.ts,.framework/functions/admin-data.ts,.framework/functions/cil-agent-ingest.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Optional string fields plus chunks and file_ids arrays used across handler actions." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.85" flags="none"]
 // CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: function. Direct callers: 0. Direct calls: 0. Related files: .framework/src/pages/admin/TypeDetailPage.tsx, .framework/functions/_shared/principal.ts, .framework/src/pages/admin/IntegrationsPage.tsx, .framework/migrations/015_simplify_apps_table.sql, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, \."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
-// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
-// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 interface AgentIngestRequest {
   project_id: string
   file_id?: string
@@ -56,26 +51,26 @@ interface AgentIngestRequest {
   file_ids?: string[]
   new_file_path?: string
 }
+// CIL[DOC-VECTOR type="context" content="purpose='Defines the request payload accepted by the cil-agent-ingest handler.'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/admin-data.ts"]
+// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
+// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
+// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[END stable_id="~/.framework/functions/cil-agent-ingest.ts:AgentIngestRequest:interface"]
 
 
 
 
 
-// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_agent_ingest_agentingestrequest_1784235266"]
-// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_agent_ingest_agentparsedmarker_1784235266" type="interface" identity="agentparsedmarker" parent="none"]
-// CIL[DOC-MACRO purpose="Defines the agentparsedmarker type contract in cortex.functions.custom_cil-agent-ingest"]
-// CIL[DOC-RESPONSIBILITY responsibility="Describe the shape and allowed fields for agentparsedmarker"]
-// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-agent-ingest" layer="function" related_files="[\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/functions/_shared/principal.ts\",\".framework/src/pages/admin/IntegrationsPage.tsx\",\".framework/migrations/015_simplify_apps_table.sql\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="type definition for agentparsedmarker" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Declares TypeScript type/interface agentparsedmarker with member definitions" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[BEGIN stable_id="~/.framework/functions/cil-agent-ingest.ts:AgentParsedMarker:interface" type="interface" identity="AgentParsedMarker" parent="~/.framework/functions/cil-agent-ingest.ts"]
+// CIL[DOC-MACRO purpose="Represents a single CIL chunk boundary as parsed from source."]
+// CIL[DOC-RESPONSIBILITY responsibility="Capture start_line, end_line, type, identity, parent and extra attributes for a marker."]
+// CIL[DOC-CONTEXT module="cil-agent-ingest" layer="types" related_files=".framework/functions/_shared/db.ts,.framework/functions/_shared/middleware.ts,.framework/functions/_shared/resolve-ids.ts,.framework/functions/admin-data.ts,.framework/functions/cil-agent-ingest.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Includes chunk_id as legacy support plus an attributes record for forward compatibility." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.85" flags="none"]
 // CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: function. Direct callers: 0. Direct calls: 0. Related files: .framework/src/pages/admin/TypeDetailPage.tsx, .framework/functions/_shared/principal.ts, .framework/src/pages/admin/IntegrationsPage.tsx, .framework/migrations/015_simplify_apps_table.sql, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, \."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
-// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
-// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 interface AgentParsedMarker {
   chunk_id: string
   start_line: number
@@ -85,26 +80,26 @@ interface AgentParsedMarker {
   parent: string
   attributes?: Record<string, string>
 }
+// CIL[DOC-VECTOR type="context" content="purpose='Represents a single CIL chunk boundary as parsed from source.'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/admin-data.ts"]
+// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
+// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
+// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[END stable_id="~/.framework/functions/cil-agent-ingest.ts:AgentParsedMarker:interface"]
 
 
 
 
 
-// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_agent_ingest_agentparsedmarker_1784235266"]
-// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_agent_ingest_agentparseddocs_1784235266" type="interface" identity="agentparseddocs" parent="none"]
-// CIL[DOC-MACRO purpose="Defines the agentparseddocs type contract in cortex.functions.custom_cil-agent-ingest"]
-// CIL[DOC-RESPONSIBILITY responsibility="Describe the shape and allowed fields for agentparseddocs"]
-// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-agent-ingest" layer="function" related_files="[\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/functions/_shared/principal.ts\",\".framework/src/pages/admin/IntegrationsPage.tsx\",\".framework/migrations/015_simplify_apps_table.sql\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="type definition for agentparseddocs" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Declares TypeScript type/interface agentparseddocs with member definitions" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[BEGIN stable_id="~/.framework/functions/cil-agent-ingest.ts:AgentParsedDocs:interface" type="interface" identity="AgentParsedDocs" parent="~/.framework/functions/cil-agent-ingest.ts"]
+// CIL[DOC-MACRO purpose="Holds all parsed CIL documentation tags for a chunk."]
+// CIL[DOC-RESPONSIBILITY responsibility="Collect macro, responsibility, context, contract, micro, examples, confidence, stability and audience fields."]
+// CIL[DOC-CONTEXT module="cil-agent-ingest" layer="types" related_files=".framework/functions/_shared/db.ts,.framework/functions/_shared/middleware.ts,.framework/functions/_shared/resolve-ids.ts,.framework/functions/admin-data.ts,.framework/functions/cil-agent-ingest.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Raw map mirrors the source tag contents; confidence flags are stored as an array." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.85" flags="none"]
 // CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: function. Direct callers: 0. Direct calls: 0. Related files: .framework/src/pages/admin/TypeDetailPage.tsx, .framework/functions/_shared/principal.ts, .framework/src/pages/admin/IntegrationsPage.tsx, .framework/migrations/015_simplify_apps_table.sql, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, \."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
-// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
-// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 interface AgentParsedDocs {
   macro?: string
   responsibility?: string
@@ -117,131 +112,72 @@ interface AgentParsedDocs {
   audience?: string
   raw: Record<string, string>
 }
+// CIL[DOC-VECTOR type="context" content="purpose='Holds all parsed CIL documentation tags for a chunk.'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/admin-data.ts"]
+// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
+// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
+// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[END stable_id="~/.framework/functions/cil-agent-ingest.ts:AgentParsedDocs:interface"]
 
 
 
 
 
-// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_agent_ingest_agentparseddocs_1784235266"]
-// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_agent_ingest_computefilehash_1784235266" type="function" identity="computefilehash" parent="none"]
-// CIL[DOC-MACRO purpose="Implements computefilehash logic in cortex.functions.custom_cil-agent-ingest"]
-// CIL[DOC-RESPONSIBILITY responsibility="Execute computefilehash and return its computed result"]
-// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-agent-ingest" layer="function" related_files="[\"custom/apps/cortex/functions/custom_cil-embeddings.ts\",\".framework/functions/_shared/principal.ts\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/src/pages/admin/IntegrationsPage.tsx\",\".framework/migrations/015_simplify_apps_table.sql\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="return value from function execution" errors="throws on invalid input or runtime failure" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Provides computefilehash with computeFileHash(content: 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-agent-ingest.ts:computeFileHash:function" type="function" identity="computeFileHash" parent="~/.framework/functions/cil-agent-ingest.ts"]
+// CIL[DOC-MACRO purpose="Compute a SHA-256 digest of a file or string."]
+// CIL[DOC-RESPONSIBILITY responsibility="Return a stable hex hash for content comparison and integrity checks."]
+// CIL[DOC-CONTEXT module="cil-agent-ingest" layer="functions" related_files=".framework/functions/_shared/db.ts,.framework/functions/_shared/middleware.ts,.framework/functions/_shared/resolve-ids.ts,.framework/functions/admin-data.ts,.framework/functions/cil-agent-ingest.ts"]
+// CIL[DOC-CONTRACT inputs="content: string" outputs="hex hash string" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Creates a sha256 hash from utf-8 content and returns the hex digest." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.85" flags="none"]
 // CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: function. Direct callers: 0. Direct calls: 0. Related files: custom/apps/cortex/functions/custom_cil-embeddings.ts, .framework/functions/_shared/principal.ts, .framework/src/pages/admin/TypeDetailPage.tsx, .framework/src/pages/admin/IntegrationsPage.tsx, .framework/migrations/015_simplify_apps_table.sql."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
-// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
-// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 function computeFileHash(content: string): string {
   return crypto.createHash('sha256').update(content, 'utf8').digest('hex')
 }
-
-
-
-
-
-// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_agent_ingest_computefilehash_1784235266"]
-// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_agent_ingest_estimatetokens_1784235266" type="function" identity="estimatetokens" parent="none"]
-// CIL[DOC-MACRO purpose="Implements estimatetokens logic in cortex.functions.custom_cil-agent-ingest"]
-// CIL[DOC-RESPONSIBILITY responsibility="Execute estimatetokens and return its computed result"]
-// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-agent-ingest" layer="function" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="return value from function execution" errors="throws on invalid input or runtime failure" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Provides estimatetokens with estimateTokens(text: string inputs, handling internal flow and returning a result" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: function. Direct callers: 0. Direct calls: 0. Related files: none."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="context" content="purpose='Compute a SHA-256 digest of a file or string.'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/admin-data.ts"]
+// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
+// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
+// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
 // CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
 // CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
-function estimateTokens(text: string): number {
-  return Math.ceil(text.length / 4)
-}
+// CIL[END stable_id="~/.framework/functions/cil-agent-ingest.ts:computeFileHash:function"]
 
 
 
 
 
-// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_agent_ingest_estimatetokens_1784235266"]
-// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_agent_ingest_normaliseagentchunkcontent_1784235266" type="function" identity="normaliseagentchunkcontent" parent="none"]
-// CIL[DOC-MACRO purpose="Implements normaliseagentchunkcontent logic in cortex.functions.custom_cil-agent-ingest"]
-// CIL[DOC-RESPONSIBILITY responsibility="Execute normaliseagentchunkcontent and return its computed result"]
-// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-agent-ingest" 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 normaliseagentchunkcontent with normaliseAgentChunkContent(raw: string inputs, handling internal flow and returning a result" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[BEGIN stable_id="~/.framework/functions/cil-agent-ingest.ts:estimateTokens:function" type="function" identity="estimateTokens" parent="~/.framework/functions/cil-agent-ingest.ts"]
+// CIL[DOC-MACRO purpose="Approximate token count for a block of text."]
+// CIL[DOC-RESPONSIBILITY responsibility="Convert character length to token count using a simple 1:4 ratio."]
+// CIL[DOC-CONTEXT module="cil-agent-ingest" layer="functions" related_files=".framework/functions/_shared/db.ts,.framework/functions/_shared/middleware.ts,.framework/functions/_shared/resolve-ids.ts,.framework/functions/admin-data.ts,.framework/functions/cil-agent-ingest.ts"]
+// CIL[DOC-CONTRACT inputs="text: string" outputs="number" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Divides string length by four and rounds up to the nearest integer." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.85" flags="none"]
 // CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: function. Direct callers: 0. Direct calls: 0. Related files: none."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
-// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
-// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
-function normaliseAgentChunkContent(raw: string): string {
-  const lines = raw.replace(/\r\n/g, '\n').split('\n')
-  const filtered = lines.filter(line => {
-    const trimmed = line.trim()
-    return !trimmed.match(/^(?:(?:\/\/|--|#)\s*|<!--\s*)CIL\[(BEGIN|END)/) && !trimmed.match(/^(?:(?:\/\/|--|#)\s*|<!--\s*)CIL\[DOC-/)
-  })
-  const collapsed: string[] = []
-  let lastBlank = false
-  for (const line of filtered) {
-    const isBlank = line.trim() === ''
-    if (isBlank && lastBlank) continue
-    collapsed.push(line)
-    lastBlank = isBlank
-  }
-  return collapsed.join('\n').trim()
+function estimateTokens(text: string): number {
+  return Math.ceil(text.length / 4)
 }
-
-
-
-
-
-// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_agent_ingest_normaliseagentchunkcontent_1784235266"]
-// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_agent_ingest_computeagentchunkhash_1784235266" type="function" identity="computeagentchunkhash" parent="none"]
-// CIL[DOC-MACRO purpose="Implements computeagentchunkhash logic in cortex.functions.custom_cil-agent-ingest"]
-// CIL[DOC-RESPONSIBILITY responsibility="Execute computeagentchunkhash and return its computed result"]
-// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-agent-ingest" 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 computeagentchunkhash with computeAgentChunkHash(codeContent: string inputs, handling internal flow and returning a result" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: function. Direct callers: 0. Direct calls: 0. Related files: none."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="context" content="purpose='Approximate token count for a block of text.'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/admin-data.ts"]
+// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
+// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
+// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
 // CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
 // CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
-function computeAgentChunkHash(codeContent: string): string {
-  return crypto.createHash('sha256').update(normaliseAgentChunkContent(codeContent)).digest('hex').slice(0, 16)
-}
+// CIL[END stable_id="~/.framework/functions/cil-agent-ingest.ts:estimateTokens:function"]
 
 
 
 
 
-// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_agent_ingest_computeagentchunkhash_1784235266"]
-// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_agent_ingest_parseagentattributes_1784235266" type="function" identity="parseagentattributes" parent="none"]
-// CIL[DOC-MACRO purpose="Implements parseagentattributes logic in cortex.functions.custom_cil-agent-ingest"]
-// CIL[DOC-RESPONSIBILITY responsibility="Execute parseagentattributes and return its computed result"]
-// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-agent-ingest" 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 parseagentattributes with parseAgentAttributes(attrString: 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-agent-ingest.ts:parseAgentAttributes:function" type="function" identity="parseAgentAttributes" parent="~/.framework/functions/cil-agent-ingest.ts"]
+// CIL[DOC-MACRO purpose="Parse key=value attribute pairs inside CIL marker or doc tag content."]
+// CIL[DOC-RESPONSIBILITY responsibility="Return a record of attribute names to their quoted string values."]
+// CIL[DOC-CONTEXT module="cil-agent-ingest" layer="functions" related_files=".framework/functions/_shared/db.ts,.framework/functions/_shared/middleware.ts,.framework/functions/_shared/resolve-ids.ts,.framework/functions/admin-data.ts,.framework/functions/cil-agent-ingest.ts"]
+// CIL[DOC-CONTRACT inputs="attrString: string" outputs="Record<string, string>" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Uses a regex to capture word keys and double-quoted values, returning an object." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.85" flags="none"]
 // CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: function. Direct callers: 0. Direct calls: 0. Related files: none."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
-// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
-// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 function parseAgentAttributes(attrString: string): Record<string, string> {
   const attrs: Record<string, string> = {}
   const regex = /(\w+)="([^"]*)"/g
@@ -251,26 +187,26 @@ function parseAgentAttributes(attrString: string): Record<string, string> {
   }
   return attrs
 }
+// CIL[DOC-VECTOR type="context" content="purpose='Parse key=value attribute pairs inside CIL marker or doc tag content.'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/admin-data.ts"]
+// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
+// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
+// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[END stable_id="~/.framework/functions/cil-agent-ingest.ts:parseAgentAttributes:function"]
 
 
 
 
 
-// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_agent_ingest_parseagentattributes_1784235266"]
-// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_agent_ingest_parseagentcilmarkers_1784235266" type="function" identity="parseagentcilmarkers" parent="none"]
-// CIL[DOC-MACRO purpose="Implements parseagentcilmarkers logic in cortex.functions.custom_cil-agent-ingest"]
-// CIL[DOC-RESPONSIBILITY responsibility="Execute parseagentcilmarkers and return its computed result"]
-// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-agent-ingest" 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 parseagentcilmarkers with parseAgentCilMarkers(lines: string[] inputs, handling internal flow and returning a result" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[BEGIN stable_id="~/.framework/functions/cil-agent-ingest.ts:parseAgentCilMarkers:function" type="function" identity="parseAgentCilMarkers" parent="~/.framework/functions/cil-agent-ingest.ts"]
+// CIL[DOC-MACRO purpose="Scan source lines and build a list of CIL chunk markers with boundaries."]
+// CIL[DOC-RESPONSIBILITY responsibility="Match BEGIN and END lines, pair them on a stack, and emit marker metadata."]
+// CIL[DOC-CONTEXT module="cil-agent-ingest" layer="functions" related_files=".framework/functions/_shared/db.ts,.framework/functions/_shared/middleware.ts,.framework/functions/_shared/resolve-ids.ts,.framework/functions/admin-data.ts,.framework/functions/cil-agent-ingest.ts"]
+// CIL[DOC-CONTRACT inputs="lines: string[]" outputs="AgentParsedMarker[]" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Supports //, --, # and HTML comment prefixes; legacy END chunk_id is preserved." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.85" flags="none"]
 // CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: function. Direct callers: 0. Direct calls: 0. Related files: none."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
-// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
-// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 function parseAgentCilMarkers(lines: string[]): AgentParsedMarker[] {
   const markers: AgentParsedMarker[] = []
   const stack: { line: number; attrs: Record<string, string> }[] = []
@@ -299,26 +235,26 @@ function parseAgentCilMarkers(lines: string[]): AgentParsedMarker[] {
 
   return markers
 }
+// CIL[DOC-VECTOR type="context" content="purpose='Scan source lines and build a list of CIL chunk markers with boundaries.'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/admin-data.ts"]
+// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
+// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
+// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[END stable_id="~/.framework/functions/cil-agent-ingest.ts:parseAgentCilMarkers:function"]
 
 
 
 
 
-// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_agent_ingest_parseagentcilmarkers_1784235266"]
-// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_agent_ingest_parseagentcildocs_1784235266" type="function" identity="parseagentcildocs" parent="none"]
-// CIL[DOC-MACRO purpose="Implements parseagentcildocs logic in cortex.functions.custom_cil-agent-ingest"]
-// CIL[DOC-RESPONSIBILITY responsibility="Execute parseagentcildocs and return its computed result"]
-// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-agent-ingest" 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 parseagentcildocs with parseAgentCilDocs(lines: string[], startLine: number, endLine: number inputs, handling internal flow and returning a result" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[BEGIN stable_id="~/.framework/functions/cil-agent-ingest.ts:parseAgentCilDocs:function" type="function" identity="parseAgentCilDocs" parent="~/.framework/functions/cil-agent-ingest.ts"]
+// CIL[DOC-MACRO purpose="Extract CIL documentation tags from a chunk line range."]
+// CIL[DOC-RESPONSIBILITY responsibility="Parse each DOC-* tag and map it into the AgentParsedDocs structure."]
+// CIL[DOC-CONTEXT module="cil-agent-ingest" layer="functions" related_files=".framework/functions/_shared/db.ts,.framework/functions/_shared/middleware.ts,.framework/functions/_shared/resolve-ids.ts,.framework/functions/admin-data.ts,.framework/functions/cil-agent-ingest.ts"]
+// CIL[DOC-CONTRACT inputs="lines: string[], startLine: number, endLine: number" outputs="AgentParsedDocs" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Switches on tag key to populate macro, responsibility, context, contract, micro, examples, confidence, stability and audience fields." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.85" flags="none"]
 // CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: function. Direct callers: 0. Direct calls: 0. Related files: none."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
-// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
-// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 function parseAgentCilDocs(lines: string[], startLine: number, endLine: number): AgentParsedDocs {
   const docs: AgentParsedDocs = { raw: {} }
   for (let i = startLine - 1; i < endLine - 1; i++) {
@@ -370,67 +306,82 @@ function parseAgentCilDocs(lines: string[], startLine: number, endLine: number):
   }
   return docs
 }
+// CIL[DOC-VECTOR type="context" content="purpose='Extract CIL documentation tags from a chunk line range.'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/admin-data.ts"]
+// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
+// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
+// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[END stable_id="~/.framework/functions/cil-agent-ingest.ts:parseAgentCilDocs:function"]
 
 
 
 
 
-// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_agent_ingest_parseagentcildocs_1784235266"]
-// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_agent_ingest_mapagentdocstochunkdata_1784235266" type="function" identity="mapagentdocstochunkdata" parent="none"]
-// CIL[DOC-MACRO purpose="Implements mapagentdocstochunkdata logic in cortex.functions.custom_cil-agent-ingest"]
-// CIL[DOC-RESPONSIBILITY responsibility="Execute mapagentdocstochunkdata and return its computed result"]
-// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-agent-ingest" 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 mapagentdocstochunkdata with mapAgentDocsToChunkData(docs: AgentParsedDocs 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-agent-ingest.ts:mapAgentDocsToChunkData:function" type="function" identity="mapAgentDocsToChunkData" parent="~/.framework/functions/cil-agent-ingest.ts"]
+// CIL[DOC-MACRO purpose="Flatten parsed docs into database column fields for a chunk record."]
+// CIL[DOC-RESPONSIBILITY responsibility="Translate doc tags into macro, micro, input/output specs, side effects, module, layer and related files."]
+// CIL[DOC-CONTEXT module="cil-agent-ingest" layer="functions" related_files=".framework/functions/_shared/db.ts,.framework/functions/_shared/middleware.ts,.framework/functions/_shared/resolve-ids.ts,.framework/functions/admin-data.ts,.framework/functions/cil-agent-ingest.ts"]
+// CIL[DOC-CONTRACT inputs="docs: AgentParsedDocs" outputs="Record<string, any>" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Falls back to raw tag content where typed values are missing; uses contract and micro attributes." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.85" flags="none"]
 // CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: function. Direct callers: 0. Direct calls: 0. Related files: none."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
-// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
-// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 function mapAgentDocsToChunkData(docs: AgentParsedDocs): Record<string, any> {
-  return {
-    macro: docs.macro || docs.raw.MACRO || '',
-    micro: docs.micro?.logic_summary || docs.responsibility || '',
-    description: docs.macro || '',
-    input_spec: docs.contract?.inputs || '',
-    output_spec: docs.contract?.outputs || '',
-    side_effects: docs.contract?.side_effects || '',
-    throws: docs.contract?.errors || '',
-    module: docs.context?.module || '',
-    layer: docs.context?.layer || '',
-    doc_confidence: docs.confidence?.pass === 'second' ? 'ai_generated' : 'from_source',
-    confidence_score: docs.confidence?.score || 0,
-    confidence_flags: docs.confidence?.flags || [],
-    see_also: docs.context?.related_files || '',
-    tags: docs.micro?.notable_decisions || '',
-    depends_on: docs.contract?.dependencies || '',
-    stability: docs.stability || '',
-    audience: docs.audience || '',
+  // Only emit fields backed by DOC-* tags actually present in the source.
+  // Emitting empty strings for absent tags would wipe enriched fields on
+  // every store_markers call for chunks that use JSDoc or no doc tags.
+  const out: Record<string, any> = {}
+  if (docs.raw.MACRO || docs.macro) {
+    out.macro = docs.macro || docs.raw.MACRO || ''
+    out.description = docs.macro || ''
+  }
+  if (docs.raw.MICRO) {
+    out.micro = docs.micro?.logic_summary || ''
+    out.tags = docs.micro?.notable_decisions || ''
+  } else if (docs.raw.RESPONSIBILITY) {
+    out.micro = docs.responsibility || ''
+  }
+  if (docs.contract) {
+    out.input_spec = docs.contract.inputs || ''
+    out.output_spec = docs.contract.outputs || ''
+    out.side_effects = docs.contract.side_effects || ''
+    out.throws = docs.contract.errors || ''
+    out.depends_on = docs.contract.dependencies || ''
+  }
+  if (docs.context) {
+    out.module = docs.context.module || ''
+    out.layer = docs.context.layer || ''
+    out.see_also = docs.context.related_files || ''
   }
+  if (docs.confidence) {
+    out.doc_confidence = docs.confidence.pass === 'second' ? 'ai_generated' : 'from_source'
+    out.confidence_score = docs.confidence.score || 0
+    out.confidence_flags = docs.confidence.flags || []
+  }
+  if (docs.raw.STABILITY || docs.stability) out.stability = docs.stability || ''
+  if (docs.raw.AUDIENCE || docs.audience) out.audience = docs.audience || ''
+  return out
 }
+// CIL[DOC-VECTOR type="context" content="purpose='Flatten parsed docs into database column fields for a chunk record.'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/admin-data.ts"]
+// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
+// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
+// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[END stable_id="~/.framework/functions/cil-agent-ingest.ts:mapAgentDocsToChunkData:function"]
 
 
 
 
 
-// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_agent_ingest_mapagentdocstochunkdata_1784235266"]
-// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_agent_ingest_handler_1784235266" type="variable" identity="handler" parent="none"]
-// CIL[DOC-MACRO purpose="Defines handler configuration or state in cortex.functions.custom_cil-agent-ingest"]
-// CIL[DOC-RESPONSIBILITY responsibility="Hold the value and default configuration for handler"]
-// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-agent-ingest" 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-agent-ingest" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[BEGIN stable_id="~/.framework/functions/cil-agent-ingest.ts:handler:constant" type="constant" identity="handler" parent="~/.framework/functions/cil-agent-ingest.ts"]
+// CIL[DOC-MACRO purpose="Main Netlify function handler for CIL agent ingestion actions."]
+// CIL[DOC-RESPONSIBILITY responsibility="Route query actions, validate project, read and write chunk records, and return action results."]
+// CIL[DOC-CONTEXT module="cil-agent-ingest" layer="functions" related_files=".framework/functions/_shared/db.ts,.framework/functions/_shared/middleware.ts,.framework/functions/_shared/resolve-ids.ts,.framework/functions/admin-data.ts,.framework/functions/cil-agent-ingest.ts"]
+// CIL[DOC-CONTRACT inputs="ctx: RequestContext, body: any" outputs="JSON response per action" errors="Project not found, missing fields, hash mismatch, unknown action" side_effects="Creates, updates, deactivates and renames CIL chunk and file records"]
+// CIL[DOC-MICRO logic_summary="Implements six actions via createHandler: get_selected_files, store_markers, update_documentation, detect_changes, mark_dead and update_file_path." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.85" 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 req = body as AgentIngestRequest
@@ -538,7 +489,7 @@ export const handler = createHandler(async (ctx, body) => {
       const codeContent = lines.slice(m.start_line, m.end_line - 1).join('\n')
       const docs = parseAgentCilDocs(lines, m.start_line, m.end_line)
       const docFields = mapAgentDocsToChunkData(docs)
-      const chunkHash = computeAgentChunkHash(codeContent)
+      const chunkHash = computeContentHash(codeContent)
       const tokenCount = estimateTokens(codeContent)
 
       const baseData = {
@@ -553,6 +504,7 @@ export const handler = createHandler(async (ctx, body) => {
         line_start: m.start_line,
         line_end: m.end_line,
         stored_hash: chunkHash,
+        content_hash: chunkHash,
         code_content: codeContent,
         token_count: tokenCount,
         is_dead_code: false,
@@ -767,7 +719,12 @@ export const handler = createHandler(async (ctx, body) => {
 
   throw new Error(`Unknown action: ${action}. Valid actions: get_selected_files, store_markers, update_documentation, detect_changes, mark_dead, update_file_path`)
 })
+// CIL[DOC-VECTOR type="context" content="purpose='Main Netlify function handler for CIL agent ingestion actions.'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/admin-data.ts"]
+// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
+// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
+// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[END stable_id="~/.framework/functions/cil-agent-ingest.ts:handler:constant"]
 
 
-
-// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_agent_ingest_handler_1784235266"]