spine-framework 0.3.144 → 0.4.0

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

@@ -1,25 +1,26 @@
-// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_validate_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-validate"]
-// CIL[DOC-RESPONSIBILITY responsibility="Own module-level imports, exports, and configuration for cortex.functions.custom_cil-validate"]
-// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-validate" 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-validate" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[BEGIN stable_id="~/.framework/functions/cil-validate.ts:module_header:module_header" type="module_header" identity="module_header" parent="~/.framework/functions/cil-validate.ts"]
+// CIL[DOC-MACRO purpose="Netlify function endpoint for validating and updating CIL chunk content hashes"]
+// CIL[DOC-RESPONSIBILITY responsibility="Expose HTTP actions to verify chunk drift, compute hashes, update stored hashes, and validate source files"]
+// CIL[DOC-CONTEXT module="cil-validate" layer="functions" related_files=".framework/functions/_shared/cil.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/middleware.ts"]
+// CIL[DOC-CONTRACT inputs="HTTP request with action query and JSON body" outputs="JSON validation summary, hash value, or updated hash record" errors="Missing required fields, unknown action, chunk not found, file not found, missing repo_path" side_effects="Queries and updates the adminDb items table, reads source files from disk"]
+// CIL[DOC-MICRO logic_summary="Dispatches to validate, update_hash, compute_hash, or validate_file actions and returns structured results" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
 // CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-AUDIENCE audience="developer"]
-// CIL[DOC-VECTOR type="context" content="Layer: function. Direct callers: 0. Direct calls: 0. Related files: .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="system-maintainers"]
 
 
 import { createHandler } from './_shared/middleware'
 import { adminDb } from './_shared/db'
-import * as crypto from 'crypto'
+import { computeContentHash } from './_shared/cil'
 import * as fs from 'fs'
 import * as path from 'path'
+// CIL[DOC-VECTOR type="context" content="purpose='Netlify function endpoint for validating and updating CIL chunk content hashes'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/cil.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-validate.ts:module_header:module_header"]
 
 
 
@@ -27,102 +28,107 @@ import * as path from 'path'
 
 
 
-// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_validate_module_header_1784235266"]
-// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_validate_chunktovalidate_1784235266" type="interface" identity="chunktovalidate" parent="none"]
-// CIL[DOC-MACRO purpose="Defines the chunktovalidate type contract in cortex.functions.custom_cil-validate"]
-// CIL[DOC-RESPONSIBILITY responsibility="Describe the shape and allowed fields for chunktovalidate"]
-// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-validate" 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 chunktovalidate" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Declares TypeScript type/interface chunktovalidate with member definitions" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[BEGIN stable_id="~/.framework/functions/cil-validate.ts:ChunkToValidate:interface" type="interface" identity="ChunkToValidate" parent="~/.framework/functions/cil-validate.ts"]
+// CIL[DOC-MACRO purpose="Shape of a chunk reference used in validation requests"]
+// CIL[DOC-RESPONSIBILITY responsibility="Define the type contract for chunks submitted to the validate action"]
+// CIL[DOC-CONTEXT module="cil-validate" layer="functions" related_files=".framework/functions/_shared/cil.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/middleware.ts,.framework/functions/cil-validate.ts"]
+// CIL[DOC-CONTRACT inputs="raw JSON with optional chunk_id, stable_id, version_id, required chunk_name, and content" outputs="typed ChunkToValidate interface" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="TypeScript interface with optional identifiers and required chunk_name and content fields" 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/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 ChunkToValidate {
-  chunk_id: string   
+  chunk_id?: string
   chunk_name: string
-  content: string    
+  content: string
+  stable_id?: string
+  version_id?: string
 }
+// CIL[DOC-VECTOR type="context" content="purpose='Shape of a chunk reference used in validation requests'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/cil.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-validate.ts:ChunkToValidate:interface"]
 
 
 
 
 
-// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_validate_chunktovalidate_1784235266"]
-// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_validate_validationresult_1784235266" type="interface" identity="validationresult" parent="none"]
-// CIL[DOC-MACRO purpose="Defines the validationresult type contract in cortex.functions.custom_cil-validate"]
-// CIL[DOC-RESPONSIBILITY responsibility="Describe the shape and allowed fields for validationresult"]
-// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-validate" 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 validationresult" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Declares TypeScript type/interface validationresult with member definitions" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: function. Direct callers: 0. Direct calls: 0. Related files: .framework/src/pages/admin/TypeDetailPage.tsx, .framework/functions/_shared/principal.ts, .framework/src/pages/admin/IntegrationsPage.tsx, .framework/migrations/015_simplify_apps_table.sql, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, \."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
-// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
-// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[BEGIN stable_id="~/.framework/functions/cil-validate.ts:ValidationResult:interface" type="interface" identity="ValidationResult" parent="~/.framework/functions/cil-validate.ts"]
+// CIL[DOC-MACRO purpose="Shape of the result returned for a validated chunk"]
+// CIL[DOC-RESPONSIBILITY responsibility="Report whether a chunk is current, drifted, or not found"]
+// CIL[DOC-CONTEXT module="cil-validate" layer="functions" related_files=".framework/functions/_shared/cil.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/middleware.ts,.framework/functions/cil-validate.ts"]
+// CIL[DOC-CONTRACT inputs="chunk metadata, stored and computed hashes, and status message" outputs="typed ValidationResult interface" errors="none" side_effects="none"]
+  // CIL[DOC-STABILITY stability="internal"]
+  // CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-MICRO logic_summary="TypeScript interface describing validation outcome fields" notable_decisions="[]"]
 interface ValidationResult {
   chunk_id: string
+  stable_id: string | null
   chunk_name: string
   status: 'current' | 'drift_detected' | 'not_found'
   stored_hash: string | null
   validation_hash: string
   message: string
 }
+// CIL[END stable_id="~/.framework/functions/cil-validate.ts:ValidationResult:interface"]
 
 
+// CIL[DOC-VECTOR type="context" content="purpose='Shape of the result returned for a validated chunk'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/cil.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 chunk_id="custom_apps_cortex_functions_custom_cil_validate_validationresult_1784235266"]
-// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_validate_validaterequest_1784235266" type="interface" identity="validaterequest" parent="none"]
-// CIL[DOC-MACRO purpose="Defines the validaterequest type contract in cortex.functions.custom_cil-validate"]
-// CIL[DOC-RESPONSIBILITY responsibility="Describe the shape and allowed fields for validaterequest"]
-// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-validate" 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 validaterequest" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Declares TypeScript type/interface validaterequest with member definitions" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: function. Direct callers: 0. Direct calls: 0. Related files: .framework/src/pages/admin/TypeDetailPage.tsx, .framework/functions/_shared/principal.ts, .framework/src/pages/admin/IntegrationsPage.tsx, .framework/migrations/015_simplify_apps_table.sql, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, \."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
-// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
-// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[BEGIN stable_id="~/.framework/functions/cil-validate.ts:ValidateRequest:interface" type="interface" identity="ValidateRequest" parent="~/.framework/functions/cil-validate.ts"]
+// CIL[DOC-MACRO purpose="Shape of a batch chunk validation request"]
+// CIL[DOC-RESPONSIBILITY responsibility="Collect optional file path and an array of chunks to validate"]
+// CIL[DOC-CONTEXT module="cil-validate" layer="functions" related_files=".framework/functions/_shared/cil.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/middleware.ts,.framework/functions/cil-validate.ts"]
+// CIL[DOC-CONTRACT inputs="optional file_path and chunks array" outputs="typed ValidateRequest interface" errors="none" side_effects="none"]
+  // CIL[DOC-STABILITY stability="internal"]
+  // CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-MICRO logic_summary="TypeScript interface with optional file_path and required chunks array" notable_decisions="[]"]
 interface ValidateRequest {
   file_path?: string
   chunks: ChunkToValidate[]
 }
+// CIL[END stable_id="~/.framework/functions/cil-validate.ts:ValidateRequest:interface"]
 
+// CIL[DOC-VECTOR type="context" content="purpose='Shape of a batch chunk validation request'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/cil.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 chunk_id="custom_apps_cortex_functions_custom_cil_validate_validaterequest_1784235266"]
-// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_validate_updatehashrequest_1784235266" type="interface" identity="updatehashrequest" parent="none"]
-// CIL[DOC-MACRO purpose="Defines the updatehashrequest type contract in cortex.functions.custom_cil-validate"]
-// CIL[DOC-RESPONSIBILITY responsibility="Describe the shape and allowed fields for updatehashrequest"]
-// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-validate" 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 updatehashrequest" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Declares TypeScript type/interface updatehashrequest with member definitions" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[BEGIN stable_id="~/.framework/functions/cil-validate.ts:UpdateHashRequest:interface" type="interface" identity="UpdateHashRequest" parent="~/.framework/functions/cil-validate.ts"]
+// CIL[DOC-MACRO purpose="Shape of a request to update a stored content hash"]
+// CIL[DOC-RESPONSIBILITY responsibility="Identify a chunk by stable_id or chunk_id and provide new content"]
+// CIL[DOC-CONTEXT module="cil-validate" layer="functions" related_files=".framework/functions/_shared/cil.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/middleware.ts,.framework/functions/cil-validate.ts"]
+// CIL[DOC-CONTRACT inputs="optional chunk_id, stable_id, version_id and required content" outputs="typed UpdateHashRequest interface" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="TypeScript interface with optional identifiers and required content field" 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/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 UpdateHashRequest {
-  chunk_id: string
+  chunk_id?: string
+  stable_id?: string
+  version_id?: string
   content: string
 }
+// CIL[DOC-VECTOR type="context" content="purpose='Shape of a request to update a stored content hash'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/cil.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-validate.ts:UpdateHashRequest:interface"]
 
 
 
@@ -131,85 +137,111 @@ interface UpdateHashRequest {
 
 
 
-// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_validate_updatehashrequest_1784235266"]
-// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_validate_normalisecontent_1784235266" type="function" identity="normalisecontent" parent="none"]
-// CIL[DOC-MACRO purpose="Implements normalisecontent logic in cortex.functions.custom_cil-validate"]
-// CIL[DOC-RESPONSIBILITY responsibility="Execute normalisecontent and return its computed result"]
-// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-validate" 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 normalisecontent with normaliseContent(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-validate.ts:computeHash:function" type="function" identity="computeHash" parent="~/.framework/functions/cil-validate.ts"]
+// CIL[DOC-MACRO purpose="Compute the stored content hash for a given string"]
+// CIL[DOC-RESPONSIBILITY responsibility="Delegate to the shared computeContentHash implementation"]
+// CIL[DOC-CONTEXT module="cil-validate" layer="functions" related_files=".framework/functions/_shared/cil.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/middleware.ts,.framework/functions/cil-validate.ts"]
+// CIL[DOC-CONTRACT inputs="content string" outputs="hash string" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Thin wrapper around computeContentHash from _shared/cil" 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."]
+function computeHash(content: string): string {
+  return computeContentHash(content)
+}
+// CIL[DOC-VECTOR type="context" content="purpose='Compute the stored content hash for a given string'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/cil.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 normaliseContent(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*CHUNK_(START|END):/) &&
-           !trimmed.match(/^\/\*\*?\s*CHUNK_(START|END):.+\*\//)
-  })
-  
-  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()
-}
+// CIL[END stable_id="~/.framework/functions/cil-validate.ts:computeHash:function"]
 
 
 
 
 
-// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_validate_normalisecontent_1784235266"]
-// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_validate_computehash_1784235266" type="function" identity="computehash" parent="none"]
-// CIL[DOC-MACRO purpose="Implements computehash logic in cortex.functions.custom_cil-validate"]
-// CIL[DOC-RESPONSIBILITY responsibility="Execute computehash and return its computed result"]
-// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-validate" 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 computehash with computeHash(content: string inputs, handling internal flow and returning a result" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: function. Direct callers: 0. Direct calls: 0. Related files: none."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
-// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
-// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
-function computeHash(content: string): string {
-  return crypto.createHash('sha256').update(normaliseContent(content)).digest('hex').slice(0, 16)
-}
-
-
 
 
 
+// CIL[BEGIN stable_id="~/.framework/functions/cil-validate.ts:resolveChunk:function" type="function" identity="resolveChunk" parent="~/.framework/functions/cil-validate.ts"]
+// CIL[DOC-MACRO purpose="Resolve a chunk record from the graph by stable_id, version_id, or chunk_id"]
+// CIL[DOC-RESPONSIBILITY responsibility="Look up the active chunk record and fallback through versioned and legacy identifiers"]
+// CIL[DOC-CONTEXT module="cil-validate" layer="functions" related_files=".framework/functions/_shared/cil.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/middleware.ts,.framework/functions/cil-validate.ts"]
+// CIL[DOC-CONTRACT inputs="input: object with optional chunk_id, stable_id, and version_id" outputs="item id and data or null" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Query adminDb by stable_id/version, fallback to active version via project, then chunk_id" notable_decisions="[]"]
+// CIL[DOC-NOTE type="parameter" content="input: object containing optional chunk_id, stable_id, and version_id"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+async function resolveChunk(
+  input: { chunk_id?: string; stable_id?: string; version_id?: string }
+): Promise<{ id: string; data: any } | null> {
+  if (input.stable_id) {
+    if (input.version_id) {
+      const { data: item } = await adminDb
+        .from('items')
+        .select('id, data')
+        .filter('data->>kb_type', 'eq', 'cil_chunk')
+        .filter('data->>stable_id', 'eq', input.stable_id)
+        .filter('data->>version_id', 'eq', input.version_id)
+        .maybeSingle()
+      if (item) return item
+    } else {
+      const { data: candidates } = await adminDb
+        .from('items')
+        .select('id, data')
+        .filter('data->>kb_type', 'eq', 'cil_chunk')
+        .filter('data->>stable_id', 'eq', input.stable_id)
+        .limit(1)
+      const candidate = candidates?.[0]
+      if (candidate?.data?.project_id) {
+        const { data: project } = await adminDb
+          .from('items')
+          .select('id, data')
+          .eq('id', candidate.data.project_id)
+          .maybeSingle()
+        const activeVersionId = project?.data?.active_version_id
+        if (activeVersionId) {
+          const { data: item } = await adminDb
+            .from('items')
+            .select('id, data')
+            .filter('data->>kb_type', 'eq', 'cil_chunk')
+            .filter('data->>stable_id', 'eq', input.stable_id)
+            .filter('data->>version_id', 'eq', activeVersionId)
+            .maybeSingle()
+          if (item) return item
+        }
+      }
+      if (candidate) return candidate
+    }
+  }
 
+  if (input.chunk_id) {
+    const { data: item } = await adminDb
+      .from('items')
+      .select('id, data')
+      .eq('id', input.chunk_id)
+      .maybeSingle()
+    if (item) return item
+  }
 
-// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_validate_computehash_1784235266"]
-// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_validate_handler_1784235266" type="variable" identity="handler" parent="none"]
-// CIL[DOC-MACRO purpose="Defines handler configuration or state in cortex.functions.custom_cil-validate"]
-// CIL[DOC-RESPONSIBILITY responsibility="Hold the value and default configuration for handler"]
-// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-validate" 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-validate" 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."]
+  return null
+}
+// CIL[DOC-VECTOR type="context" content="purpose='Resolve a chunk record from the graph by stable_id, version_id, or chunk_id'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/cil.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-validate.ts:resolveChunk:function"]
+
+// CIL[BEGIN stable_id="~/.framework/functions/cil-validate.ts:handler:constant" type="constant" identity="handler" parent="~/.framework/functions/cil-validate.ts"]
+// CIL[DOC-MACRO purpose="Netlify function handler that dispatches CIL validation actions"]
+// CIL[DOC-RESPONSIBILITY responsibility="Handle validate, update_hash, compute_hash, and validate_file HTTP actions"]
+// CIL[DOC-CONTEXT module="cil-validate" layer="functions" related_files=".framework/functions/_shared/cil.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/middleware.ts,.framework/functions/cil-validate.ts"]
+// CIL[DOC-CONTRACT inputs="HTTP context and parsed request body" outputs="JSON response" errors="Validation or action errors" side_effects="Reads files, queries and updates adminDb"]
+// CIL[DOC-MICRO logic_summary="Switch on action, validate inputs, process chunks or files, and return summary" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export const handler = createHandler(async (ctx, body) => {
   const action = ctx.query?.action
 
@@ -225,16 +257,12 @@ export const handler = createHandler(async (ctx, body) => {
     for (const chunk of req.chunks) {
       const validationHash = computeHash(chunk.content)
 
-      
-      const { data: item, error } = await adminDb
-        .from('items')
-        .select('id, data')
-        .eq('id', chunk.chunk_id)
-        .maybeSingle()
+      const item = await resolveChunk(chunk)
 
-      if (error || !item) {
+      if (!item) {
         results.push({
-          chunk_id: chunk.chunk_id,
+          chunk_id: chunk.chunk_id || chunk.stable_id || '',
+          stable_id: chunk.stable_id || null,
           chunk_name: chunk.chunk_name,
           status: 'not_found',
           stored_hash: null,
@@ -244,11 +272,12 @@ export const handler = createHandler(async (ctx, body) => {
         continue
       }
 
-      const storedHash: string | null = item.data?.stored_hash || null
+      const storedHash: string | null = item.data?.content_hash || item.data?.stored_hash || null
 
       if (!storedHash) {
         results.push({
-          chunk_id: chunk.chunk_id,
+          chunk_id: item.id,
+          stable_id: item.data?.stable_id || null,
           chunk_name: chunk.chunk_name,
           status: 'drift_detected',
           stored_hash: null,
@@ -262,7 +291,8 @@ export const handler = createHandler(async (ctx, body) => {
         storedHash === validationHash ? 'current' : 'drift_detected'
 
       results.push({
-        chunk_id: chunk.chunk_id,
+        chunk_id: item.id,
+        stable_id: item.data?.stable_id || null,
         chunk_name: chunk.chunk_name,
         status,
         stored_hash: storedHash,
@@ -292,31 +322,27 @@ export const handler = createHandler(async (ctx, body) => {
   
   if (action === 'update_hash') {
     const req = body as UpdateHashRequest
-    if (!req?.chunk_id) throw new Error('chunk_id is required')
+    if (!req?.chunk_id && !req?.stable_id) throw new Error('chunk_id or stable_id is required')
     if (!req?.content) throw new Error('content is required')
 
     const newHash = computeHash(req.content)
 
-    const { data: item } = await adminDb
-      .from('items')
-      .select('id, data')
-      .eq('id', req.chunk_id)
-      .maybeSingle()
+    const item = await resolveChunk(req)
 
-    if (!item) throw new Error(`Chunk not found: ${req.chunk_id}`)
+    if (!item) throw new Error(`Chunk not found: ${req.chunk_id || req.stable_id}`)
 
     const { error } = await adminDb
       .from('items')
       .update({
-        data: { ...item.data, stored_hash: newHash, hash_updated_at: new Date().toISOString() },
+        data: { ...item.data, content_hash: newHash, stored_hash: newHash, hash_updated_at: new Date().toISOString() },
         updated_at: new Date().toISOString(),
       })
-      .eq('id', req.chunk_id)
+      .eq('id', item.id)
 
     if (error) throw new Error(`Failed to update hash: ${error.message}`)
 
     return {
-      chunk_id: req.chunk_id,
+      chunk_id: item.id,
       new_hash: newHash,
       updated_at: new Date().toISOString(),
     }
@@ -399,11 +425,12 @@ export const handler = createHandler(async (ctx, body) => {
       const lineStart: number = d.line_start || 0
       const lineEnd: number = d.line_end || 0
       const chunkName: string = d.chunk_name || ''
-      const storedHash: string | null = d.stored_hash || null
+      const storedHash: string | null = d.content_hash || d.stored_hash || null
 
       if (!lineStart || !lineEnd) {
         results.push({
           chunk_id: chunk.id,
+          stable_id: d.stable_id || null,
           chunk_name: chunkName,
           status: 'not_found',
           stored_hash: storedHash,
@@ -421,6 +448,7 @@ export const handler = createHandler(async (ctx, body) => {
       if (!storedHash) {
         results.push({
           chunk_id: chunk.id,
+          stable_id: d.stable_id || null,
           chunk_name: chunkName,
           status: 'drift_detected',
           stored_hash: null,
@@ -433,6 +461,7 @@ export const handler = createHandler(async (ctx, body) => {
       const status: 'current' | 'drift_detected' = storedHash === validationHash ? 'current' : 'drift_detected'
       results.push({
         chunk_id: chunk.id,
+        stable_id: d.stable_id || null,
         chunk_name: chunkName,
         status,
         stored_hash: storedHash,
@@ -463,7 +492,12 @@ export const handler = createHandler(async (ctx, body) => {
 
   throw new Error(`Unknown action: ${action}. Valid: validate, validate_file, update_hash, compute_hash`)
 })
+// CIL[DOC-VECTOR type="context" content="purpose='Netlify function handler that dispatches CIL validation actions'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/cil.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-validate.ts:handler:constant"]
 
 
-
-// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_validate_handler_1784235266"]