spine-framework 0.3.144 → 0.4.0

package/.framework/functions/_shared/schema-utils.ts

@@ -1,3 +1,14 @@
+// CIL[BEGIN stable_id="~/.framework/functions/_shared/schema-utils.ts:module_header:module_header" type="module_header" identity="module_header" parent="~/.framework/functions/_shared/schema-utils.ts"]
+// CIL[DOC-MACRO purpose="schema-utils shared module header and imports"]
+// CIL[DOC-RESPONSIBILITY responsibility="declare module scope and dependency on the FieldDefinition type"]
+// CIL[DOC-CONTEXT module="schema-utils" layer="shared" related_files=".framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="imports FieldDefinition from the shared types module and serves as the file header" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-AUDIENCE audience="developers"]
+
+
 
 
 
@@ -35,37 +46,24 @@
 
 
 
-// CIL[BEGIN chunk_id="schemautils_imports_1784020784" type="module_header" identity="imports" parent="none"]
-// CIL[DOC-MACRO purpose="Import field definition type for schema utilities"]
-// CIL[DOC-RESPONSIBILITY responsibility="Import FieldDefinition interface from types"]
-// CIL[DOC-CONTEXT module="schema-utils" layer="shared" related_files="[\".framework/src/pages/admin/TypeDetailPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/migrations/025_retype_threads_messages.sql\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="FieldDefinition type" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Import type definition for field structure" 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: shared. Direct callers: 0. Direct calls: 0. Related files: .framework/src/pages/admin/TypeDetailPage.tsx, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .framework/migrations/025_retype_threads_messages.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"]
 import { FieldDefinition } from '../../src/types/types'
-// CIL[END chunk_id="schemautils_imports_1784020784"]
-// CIL[BEGIN chunk_id="schemautils_validationinterface_1784020784" type="interface" identity="ValidationSchema" parent="none"]
-// CIL[DOC-MACRO purpose="Define validation schema interface for field validation"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide structure for validation rules per field"]
-// CIL[DOC-CONTEXT module="schema-utils" layer="shared" related_files="[\".framework/src/components/layout/Sidebar.tsx\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/functions/_shared/principal.ts\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="ValidationSchema interface" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Interface with fields containing data_type and validation rules" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: shared. Direct callers: 0. Direct calls: 0. Related files: .framework/src/components/layout/Sidebar.tsx, .framework/src/pages/admin/TypeDetailPage.tsx, .framework/functions/_shared/principal.ts, \."]
-// 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='schema-utils shared module header and imports'; No verified external callers; imports: .framework/src/types/types.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/_shared/schema-utils.ts:module_header:module_header"]
+
+
+// CIL[BEGIN stable_id="~/.framework/functions/_shared/schema-utils.ts:ValidationSchema:interface" type="interface" identity="ValidationSchema" parent="~/.framework/functions/_shared/schema-utils.ts"]
+// CIL[DOC-MACRO purpose="validation schema type definition"]
+// CIL[DOC-RESPONSIBILITY responsibility="declare the typed contract for generated validation schemas"]
+// CIL[DOC-CONTEXT module="schema-utils" layer="shared" related_files=".framework/functions/_shared/schema-utils.ts,.framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="ValidationSchema type definition" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="defines a fields record keyed by string with data_type, optional required, and extensible validation properties" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export interface ValidationSchema {
   fields: Record<string, {
     data_type: string
@@ -73,23 +71,23 @@ export interface ValidationSchema {
     [key: string]: any
   }>
 }
-// CIL[END chunk_id="schemautils_validationinterface_1784020784"]
-// CIL[BEGIN chunk_id="schemautils_generatevalidationschema_1784020784" type="function" identity="generateValidationSchema" parent="none"]
-// CIL[DOC-LEARNING topic="runtime-type:generic/validation_generation" content="generateValidationSchema builds a Zod-compatible validation schema from design_schema.fields. It uses data_type, required, validation, options, and reference fields to produce row-level and data-level validators."]
-// CIL[DOC-NOTE type="design_schema_caveat" content="Unsupported data_types or validation keys are ignored. Reference fields need reference_kind and reference_type or validation will not enforce foreign keys."]
-// CIL[DOC-MACRO purpose="Generate validation schema from design schema"]
-// CIL[DOC-RESPONSIBILITY responsibility="Convert design schema to validation rules"]
-// CIL[DOC-CONTEXT module="schema-utils" layer="shared" related_files="[\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/src/pages/admin/RolesPage.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="ValidationSchema" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Extracts field definitions and builds validation schema" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: shared. Direct callers: 0. Direct calls: 0. Related files: .framework/src/pages/admin/TypeDetailPage.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="context" content="purpose='validation schema type definition'; No verified external callers; imports: .framework/src/types/types.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/_shared/schema-utils.ts:ValidationSchema:interface"]
+
+
+// CIL[BEGIN stable_id="~/.framework/functions/_shared/schema-utils.ts:generateValidationSchema:function" type="function" identity="generateValidationSchema" parent="~/.framework/functions/_shared/schema-utils.ts"]
+// CIL[DOC-MACRO purpose="generate a ValidationSchema from a design schema"]
+// CIL[DOC-RESPONSIBILITY responsibility="build a validation schema capturing data types and constraints from a design schema"]
+// CIL[DOC-CONTEXT module="schema-utils" layer="shared" related_files=".framework/functions/_shared/schema-utils.ts,.framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="designSchema: any" outputs="ValidationSchema" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="iterates design schema fields, copies data_type and required, merges validation and options, and returns the validation schema" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export function generateValidationSchema(designSchema: any): ValidationSchema {
   const validationSchema: ValidationSchema = {
     fields: {}
@@ -125,21 +123,23 @@ export function generateValidationSchema(designSchema: any): ValidationSchema {
 
   return validationSchema
 }
-// CIL[END chunk_id="schemautils_generatevalidationschema_1784020784"]
-// CIL[BEGIN chunk_id="schemautils_sanitizefielddata_1784020784" type="function" identity="sanitizeFieldData" parent="none"]
-// CIL[DOC-MACRO purpose="Dispatch sanitization based on field data type"]
-// CIL[DOC-RESPONSIBILITY responsibility="Route data to appropriate sanitizer function"]
-// CIL[DOC-CONTEXT module="schema-utils" layer="shared" related_files="[\".framework/migrations/025_retype_threads_messages.sql\",\".framework/src/pages/admin/IntegrationsPage.tsx\",\".framework/src/components/ui/dialog.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="sanitized data" errors="validation errors" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Switch statement routes to type-specific sanitizers" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: shared. Direct callers: 0. Direct calls: 0. Related files: .framework/migrations/025_retype_threads_messages.sql, .framework/src/pages/admin/IntegrationsPage.tsx, .framework/src/components/ui/dialog.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='generate a ValidationSchema from a design schema'; No verified external callers; imports: .framework/src/types/types.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/_shared/schema-utils.ts:generateValidationSchema:function"]
+
+
+// CIL[BEGIN stable_id="~/.framework/functions/_shared/schema-utils.ts:sanitizeFieldData:function" type="function" identity="sanitizeFieldData" parent="~/.framework/functions/_shared/schema-utils.ts"]
+// CIL[DOC-MACRO purpose="dispatch a field value to the correct sanitizer"]
+// CIL[DOC-RESPONSIBILITY responsibility="route a single field value to the type-specific sanitizer based on data_type"]
+// CIL[DOC-CONTEXT module="schema-utils" layer="shared" related_files=".framework/functions/_shared/schema-utils.ts,.framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="data: any, data_type: string, validation?: any" outputs="any" errors="throws Error when the field data fails type-specific validation or constraints" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="uses a switch over data_type to call the appropriate sanitize function with the field value and validation rules" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export function sanitizeFieldData(
   data: any, 
   data_type: string, 
@@ -198,21 +198,23 @@ export function sanitizeFieldData(
       return data
   }
 }
-// CIL[END chunk_id="schemautils_sanitizefielddata_1784020784"]
-// CIL[BEGIN chunk_id="schemautils_formatfielddata_1784020784" type="function" identity="formatFieldData" parent="none"]
-// CIL[DOC-MACRO purpose="Dispatch formatting based on field data type"]
-// CIL[DOC-RESPONSIBILITY responsibility="Route data to appropriate formatter function"]
-// CIL[DOC-CONTEXT module="schema-utils" layer="shared" related_files="[\".framework/migrations/025_retype_threads_messages.sql\",\".framework/src/pages/admin/IntegrationsPage.tsx\",\".framework/src/components/ui/dialog.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="formatted data" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Switch statement routes to type-specific formatters" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: shared. Direct callers: 0. Direct calls: 0. Related files: .framework/migrations/025_retype_threads_messages.sql, .framework/src/pages/admin/IntegrationsPage.tsx, .framework/src/components/ui/dialog.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='dispatch a field value to the correct sanitizer'; No verified external callers; imports: .framework/src/types/types.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/_shared/schema-utils.ts:sanitizeFieldData:function"]
+
+
+// CIL[BEGIN stable_id="~/.framework/functions/_shared/schema-utils.ts:formatFieldData:function" type="function" identity="formatFieldData" parent="~/.framework/functions/_shared/schema-utils.ts"]
+// CIL[DOC-MACRO purpose="dispatch a field value to the correct formatter"]
+// CIL[DOC-RESPONSIBILITY responsibility="route a single field value to the type-specific formatter based on data_type"]
+// CIL[DOC-CONTEXT module="schema-utils" layer="shared" related_files=".framework/functions/_shared/schema-utils.ts,.framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="data: any, data_type: string, context?: any" outputs="any" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="uses a switch over data_type to call the appropriate format function with the field value and optional context" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export function formatFieldData(
   data: any, 
   data_type: string, 
@@ -247,21 +249,23 @@ export function formatFieldData(
       return data
   }
 }
-// CIL[END chunk_id="schemautils_formatfielddata_1784020784"]
-// CIL[BEGIN chunk_id="schemautils_transformrecorddata_1784020784" type="function" identity="transformRecordData" parent="none"]
-// CIL[DOC-MACRO purpose="Transform record data using validation schema"]
-// CIL[DOC-RESPONSIBILITY responsibility="Apply sanitization or formatting to all record fields"]
-// CIL[DOC-CONTEXT module="schema-utils" layer="shared" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="transformed data" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Iterates through fields and applies appropriate transformation" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: shared. 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='dispatch a field value to the correct formatter'; No verified external callers; imports: .framework/src/types/types.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/_shared/schema-utils.ts:formatFieldData:function"]
+
+
+// CIL[BEGIN stable_id="~/.framework/functions/_shared/schema-utils.ts:transformRecordData:function" type="function" identity="transformRecordData" parent="~/.framework/functions/_shared/schema-utils.ts"]
+// CIL[DOC-MACRO purpose="apply sanitize or format to every field of a record"]
+// CIL[DOC-RESPONSIBILITY responsibility="transform a full record by dispatching each field through sanitizeFieldData or formatFieldData"]
+// CIL[DOC-CONTEXT module="schema-utils" layer="shared" related_files=".framework/functions/_shared/schema-utils.ts,.framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="data: Record<string, any>, validationSchema: ValidationSchema, operation: 'sanitize' | 'format', context?: any" outputs="Record<string, any>" errors="throws Error when any individual field fails validation during sanitize" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="iterates record entries, looks up each field in the validation schema, and applies the requested operation" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export function transformRecordData(
   data: Record<string, any>,
   validationSchema: ValidationSchema,
@@ -295,33 +299,28 @@ export function transformRecordData(
 
   return transformed
 }
-// CIL[END chunk_id="schemautils_transformrecorddata_1784020784"]
-// CIL[BEGIN chunk_id="schemautils_sanitizetext_1784020784" type="function" identity="sanitizeText" parent="none"]
-// CIL[DOC-MACRO purpose="Sanitize text field data with HTML encoding"]
-// CIL[DOC-RESPONSIBILITY responsibility="Clean text and apply validation rules"]
-// CIL[DOC-CONTEXT module="schema-utils" layer="shared" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="sanitized string" errors="validation errors" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Removes control chars, HTML encodes, validates length/pattern" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: shared. 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='apply sanitize or format to every field of a record'; No verified external callers; imports: .framework/src/types/types.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/_shared/schema-utils.ts:transformRecordData:function"]
+
+
+// CIL[BEGIN stable_id="~/.framework/functions/_shared/schema-utils.ts:sanitizeText:function" type="function" identity="sanitizeText" parent="~/.framework/functions/_shared/schema-utils.ts"]
+// CIL[DOC-MACRO purpose="sanitize and validate a text input"]
+// CIL[DOC-RESPONSIBILITY responsibility="clean and validate text field data so downstream code can trust the value"]
+// CIL[DOC-CONTEXT module="schema-utils" layer="shared" related_files=".framework/functions/_shared/schema-utils.ts,.framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="data: any, validation?: any" outputs="string" errors="throws Error when the input fails validation or constraint checks" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="trims the input, strips control characters, and enforces min, max, and pattern constraints; output encoding is left to renderers (React escapes text nodes, DOMPurify guards innerHTML paths)" notable_decisions="HTML entity escaping was removed — it stored &#x27;-style entities in the database, corrupting text for JSON consumers, embeddings, and plain-text renders while providing no real XSS defense since every render path already escapes/sanitizes on output"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function sanitizeText(data: any, validation?: any): string {
   let text = String(data).trim()
   
   text = text.replace(/[\x00-\x08\x0B\x0C\x0E-\x1F\x7F]/g, '')
   
-  text = text
-    .replace(/&/g, '&amp;')
-    .replace(/</g, '&lt;')
-    .replace(/>/g, '&gt;')
-    .replace(/"/g, '&quot;')
-    .replace(/'/g, '&#x27;')
-  
   if (validation?.minLength && text.length < validation.minLength) {
     throw new Error(`Text must be at least ${validation.minLength} characters`)
   }
@@ -338,33 +337,28 @@ function sanitizeText(data: any, validation?: any): string {
   
   return text
 }
-// CIL[END chunk_id="schemautils_sanitizetext_1784020784"]
-// CIL[BEGIN chunk_id="schemautils_sanitizetextarea_1784020784" type="function" identity="sanitizeTextarea" parent="none"]
-// CIL[DOC-MACRO purpose="Sanitize textarea field data"]
-// CIL[DOC-RESPONSIBILITY responsibility="Clean textarea content and validate length"]
-// CIL[DOC-CONTEXT module="schema-utils" layer="shared" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="sanitized string" errors="length validation errors" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Removes control chars, HTML encodes, checks length limits" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: shared. 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='sanitize and validate a text input'; No verified external callers; imports: .framework/src/types/types.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/_shared/schema-utils.ts:sanitizeText:function"]
+
+
+// CIL[BEGIN stable_id="~/.framework/functions/_shared/schema-utils.ts:sanitizeTextarea:function" type="function" identity="sanitizeTextarea" parent="~/.framework/functions/_shared/schema-utils.ts"]
+// CIL[DOC-MACRO purpose="sanitize and validate a textarea input"]
+// CIL[DOC-RESPONSIBILITY responsibility="clean and validate textarea field data so downstream code can trust the value"]
+// CIL[DOC-CONTEXT module="schema-utils" layer="shared" related_files=".framework/functions/_shared/schema-utils.ts,.framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="data: any, validation?: any" outputs="string" errors="throws Error when the input fails validation or constraint checks" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="trims the input, strips control characters, and enforces min and max length constraints; output encoding is left to renderers (React escapes text nodes, DOMPurify guards innerHTML paths)" notable_decisions="HTML entity escaping was removed — it stored &#x27;-style entities in the database, corrupting text for JSON consumers, embeddings, and plain-text renders while providing no real XSS defense since every render path already escapes/sanitizes on output"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function sanitizeTextarea(data: any, validation?: any): string {
   let text = String(data).trim()
   
   text = text.replace(/[\x00-\x08\x0B\x0C\x0E-\x1F\x7F]/g, '')
   
-  text = text
-    .replace(/&/g, '&amp;')
-    .replace(/</g, '&lt;')
-    .replace(/>/g, '&gt;')
-    .replace(/"/g, '&quot;')
-    .replace(/'/g, '&#x27;')
-  
   if (validation?.minLength && text.length < validation.minLength) {
     throw new Error(`Text must be at least ${validation.minLength} characters`)
   }
@@ -374,21 +368,23 @@ function sanitizeTextarea(data: any, validation?: any): string {
   
   return text
 }
-// CIL[END chunk_id="schemautils_sanitizetextarea_1784020784"]
-// CIL[BEGIN chunk_id="schemautils_sanitizerichtext_1784020784" type="function" identity="sanitizeRichText" parent="none"]
-// CIL[DOC-MACRO purpose="Sanitize rich text HTML content"]
-// CIL[DOC-RESPONSIBILITY responsibility="Filter HTML tags and remove dangerous content"]
-// CIL[DOC-CONTEXT module="schema-utils" layer="shared" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="sanitized HTML" errors="length validation errors" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Allows safe tags, removes scripts, strips event handlers" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: shared. 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='sanitize and validate a textarea input'; No verified external callers; imports: .framework/src/types/types.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/_shared/schema-utils.ts:sanitizeTextarea:function"]
+
+
+// CIL[BEGIN stable_id="~/.framework/functions/_shared/schema-utils.ts:sanitizeRichText:function" type="function" identity="sanitizeRichText" parent="~/.framework/functions/_shared/schema-utils.ts"]
+// CIL[DOC-MACRO purpose="sanitize and validate a rich text input"]
+// CIL[DOC-RESPONSIBILITY responsibility="clean and validate rich text field data so downstream code can trust the value"]
+// CIL[DOC-CONTEXT module="schema-utils" layer="shared" related_files=".framework/functions/_shared/schema-utils.ts,.framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="data: any, validation?: any" outputs="string" errors="throws Error when the input fails validation or constraint checks" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="trims HTML, filters against an allowed tag whitelist, removes script and event handlers, and validates length constraints" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function sanitizeRichText(data: any, validation?: any): string {
   let html = String(data).trim()
   
@@ -414,21 +410,23 @@ function sanitizeRichText(data: any, validation?: any): string {
   
   return html
 }
-// CIL[END chunk_id="schemautils_sanitizerichtext_1784020784"]
-// CIL[BEGIN chunk_id="schemautils_sanitizeemail_1784020784" type="function" identity="sanitizeEmail" parent="none"]
-// CIL[DOC-MACRO purpose="Validate and sanitize email addresses"]
-// CIL[DOC-RESPONSIBILITY responsibility="Ensure email format is valid"]
-// CIL[DOC-CONTEXT module="schema-utils" layer="shared" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="normalized email" errors="invalid format error" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Lowercases, trims, validates with regex pattern" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: shared. 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='sanitize and validate a rich text input'; No verified external callers; imports: .framework/src/types/types.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/_shared/schema-utils.ts:sanitizeRichText:function"]
+
+
+// CIL[BEGIN stable_id="~/.framework/functions/_shared/schema-utils.ts:sanitizeEmail:function" type="function" identity="sanitizeEmail" parent="~/.framework/functions/_shared/schema-utils.ts"]
+// CIL[DOC-MACRO purpose="sanitize and validate a email input"]
+// CIL[DOC-RESPONSIBILITY responsibility="clean and validate email field data so downstream code can trust the value"]
+// CIL[DOC-CONTEXT module="schema-utils" layer="shared" related_files=".framework/functions/_shared/schema-utils.ts,.framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="data: any, validation?: any" outputs="string" errors="throws Error when the input fails validation or constraint checks" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="coerces the input to lowercase, trims it, and validates the email pattern" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function sanitizeEmail(data: any, validation?: any): string {
   let email = String(data).toLowerCase().trim()
   
@@ -439,21 +437,23 @@ function sanitizeEmail(data: any, validation?: any): string {
   
   return email
 }
-// CIL[END chunk_id="schemautils_sanitizeemail_1784020784"]
-// CIL[BEGIN chunk_id="schemautils_sanitizephone_1784020784" type="function" identity="sanitizePhone" parent="none"]
-// CIL[DOC-MACRO purpose="Sanitize phone number format"]
-// CIL[DOC-RESPONSIBILITY responsibility="Clean and validate phone numbers"]
-// CIL[DOC-CONTEXT module="schema-utils" layer="shared" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="cleaned phone" errors="format validation errors" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Removes non-digits, validates against pattern if provided" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: shared. 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='sanitize and validate a email input'; No verified external callers; imports: .framework/src/types/types.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/_shared/schema-utils.ts:sanitizeEmail:function"]
+
+
+// CIL[BEGIN stable_id="~/.framework/functions/_shared/schema-utils.ts:sanitizePhone:function" type="function" identity="sanitizePhone" parent="~/.framework/functions/_shared/schema-utils.ts"]
+// CIL[DOC-MACRO purpose="sanitize and validate a phone input"]
+// CIL[DOC-RESPONSIBILITY responsibility="clean and validate phone field data so downstream code can trust the value"]
+// CIL[DOC-CONTEXT module="schema-utils" layer="shared" related_files=".framework/functions/_shared/schema-utils.ts,.framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="data: any, validation?: any" outputs="string" errors="throws Error when the input fails validation or constraint checks" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="strips non-digits and validates the result against a pattern if provided" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function sanitizePhone(data: any, validation?: any): string {
   let phone = String(data).trim()
   
@@ -468,21 +468,23 @@ function sanitizePhone(data: any, validation?: any): string {
   
   return phone
 }
-// CIL[END chunk_id="schemautils_sanitizephone_1784020784"]
-// CIL[BEGIN chunk_id="schemautils_sanitizeurl_1784020784" type="function" identity="sanitizeUrl" parent="none"]
-// CIL[DOC-MACRO purpose="Validate and sanitize URLs"]
-// CIL[DOC-RESPONSIBILITY responsibility="Ensure URL format and protocol are valid"]
-// CIL[DOC-CONTEXT module="schema-utils" layer="shared" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="normalized URL" errors="invalid URL error" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Validates URL format, restricts to HTTP/HTTPS protocols" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: shared. 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='sanitize and validate a phone input'; No verified external callers; imports: .framework/src/types/types.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/_shared/schema-utils.ts:sanitizePhone:function"]
+
+
+// CIL[BEGIN stable_id="~/.framework/functions/_shared/schema-utils.ts:sanitizeUrl:function" type="function" identity="sanitizeUrl" parent="~/.framework/functions/_shared/schema-utils.ts"]
+// CIL[DOC-MACRO purpose="sanitize and validate a url input"]
+// CIL[DOC-RESPONSIBILITY responsibility="clean and validate url field data so downstream code can trust the value"]
+// CIL[DOC-CONTEXT module="schema-utils" layer="shared" related_files=".framework/functions/_shared/schema-utils.ts,.framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="data: any, validation?: any" outputs="string" errors="throws Error when the input fails validation or constraint checks" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="parses the input as a URL and restricts it to HTTP or HTTPS protocols" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function sanitizeUrl(data: any, validation?: any): string {
   let url = String(data).trim()
   
@@ -496,21 +498,23 @@ function sanitizeUrl(data: any, validation?: any): string {
     throw new Error('Invalid URL format')
   }
 }
-// CIL[END chunk_id="schemautils_sanitizeurl_1784020784"]
-// CIL[BEGIN chunk_id="schemautils_sanitizenumber_1784020784" type="function" identity="sanitizeNumber" parent="none"]
-// CIL[DOC-MACRO purpose="Validate and sanitize numeric values"]
-// CIL[DOC-RESPONSIBILITY responsibility="Ensure number validity and range constraints"]
-// CIL[DOC-CONTEXT module="schema-utils" layer="shared" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="validated number" errors="range/validation errors" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Validates NaN, checks min/max, applies step rounding" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: shared. 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='sanitize and validate a url input'; No verified external callers; imports: .framework/src/types/types.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/_shared/schema-utils.ts:sanitizeUrl:function"]
+
+
+// CIL[BEGIN stable_id="~/.framework/functions/_shared/schema-utils.ts:sanitizeNumber:function" type="function" identity="sanitizeNumber" parent="~/.framework/functions/_shared/schema-utils.ts"]
+// CIL[DOC-MACRO purpose="sanitize and validate a number input"]
+// CIL[DOC-RESPONSIBILITY responsibility="clean and validate number field data so downstream code can trust the value"]
+// CIL[DOC-CONTEXT module="schema-utils" layer="shared" related_files=".framework/functions/_shared/schema-utils.ts,.framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="data: any, validation?: any" outputs="number" errors="throws Error when the input fails validation or constraint checks" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="coerces the input to a number and enforces min, max, and step constraints" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function sanitizeNumber(data: any, validation?: any): number {
   let num = Number(data)
   
@@ -534,21 +538,23 @@ function sanitizeNumber(data: any, validation?: any): number {
   
   return num
 }
-// CIL[END chunk_id="schemautils_sanitizenumber_1784020784"]
-// CIL[BEGIN chunk_id="schemautils_sanitizeurrency_1784020784" type="function" identity="sanitizeCurrency" parent="none"]
-// CIL[DOC-MACRO purpose="Sanitize currency amounts with rounding"]
-// CIL[DOC-RESPONSIBILITY responsibility="Validate and round currency values"]
-// CIL[DOC-CONTEXT module="schema-utils" layer="shared" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="rounded currency" errors="range/validation errors" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Rounds to 2 decimal places, validates range constraints" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: shared. 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='sanitize and validate a number input'; No verified external callers; imports: .framework/src/types/types.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/_shared/schema-utils.ts:sanitizeNumber:function"]
+
+
+// CIL[BEGIN stable_id="~/.framework/functions/_shared/schema-utils.ts:sanitizeCurrency:function" type="function" identity="sanitizeCurrency" parent="~/.framework/functions/_shared/schema-utils.ts"]
+// CIL[DOC-MACRO purpose="sanitize and validate a currency input"]
+// CIL[DOC-RESPONSIBILITY responsibility="clean and validate currency field data so downstream code can trust the value"]
+// CIL[DOC-CONTEXT module="schema-utils" layer="shared" related_files=".framework/functions/_shared/schema-utils.ts,.framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="data: any, validation?: any" outputs="number" errors="throws Error when the input fails validation or constraint checks" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="coerces the input to a number, rounds to two decimals, and enforces min and max" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function sanitizeCurrency(data: any, validation?: any): number {
   let num = Number(data)
   
@@ -567,39 +573,43 @@ function sanitizeCurrency(data: any, validation?: any): number {
   
   return num
 }
-// CIL[END chunk_id="schemautils_sanitizeurrency_1784020784"]
-// CIL[BEGIN chunk_id="schemautils_sanitizerange_1784020784" type="function" identity="sanitizeRange" parent="none"]
-// CIL[DOC-MACRO purpose="Sanitize range values"]
-// CIL[DOC-RESPONSIBILITY responsibility="Delegate range sanitization to number sanitizer"]
-// CIL[DOC-CONTEXT module="schema-utils" layer="shared" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="sanitized number" errors="number validation errors" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Simple wrapper around sanitizeNumber function" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: shared. 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='sanitize and validate a currency input'; No verified external callers; imports: .framework/src/types/types.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/_shared/schema-utils.ts:sanitizeCurrency:function"]
+
+
+// CIL[BEGIN stable_id="~/.framework/functions/_shared/schema-utils.ts:sanitizeRange:function" type="function" identity="sanitizeRange" parent="~/.framework/functions/_shared/schema-utils.ts"]
+// CIL[DOC-MACRO purpose="sanitize and validate a range input"]
+// CIL[DOC-RESPONSIBILITY responsibility="clean and validate range field data so downstream code can trust the value"]
+// CIL[DOC-CONTEXT module="schema-utils" layer="shared" related_files=".framework/functions/_shared/schema-utils.ts,.framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="data: any, validation?: any" outputs="number" errors="throws Error when the input fails validation or constraint checks" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="coerces the input through the number sanitizer to enforce range and step constraints" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function sanitizeRange(data: any, validation?: any): number {
   return sanitizeNumber(data, validation)
 }
-// CIL[END chunk_id="schemautils_sanitizerange_1784020784"]
-// CIL[BEGIN chunk_id="schemautils_sanitizedate_1784020784" type="function" identity="sanitizeDate" parent="none"]
-// CIL[DOC-MACRO purpose="Validate and format date strings"]
-// CIL[DOC-RESPONSIBILITY responsibility="Ensure valid date format and constraints"]
-// CIL[DOC-CONTEXT module="schema-utils" layer="shared" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="ISO date string" errors="date validation errors" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Parses date, validates range, returns ISO format" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: shared. 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='sanitize and validate a range input'; No verified external callers; imports: .framework/src/types/types.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/_shared/schema-utils.ts:sanitizeRange:function"]
+
+
+// CIL[BEGIN stable_id="~/.framework/functions/_shared/schema-utils.ts:sanitizeDate:function" type="function" identity="sanitizeDate" parent="~/.framework/functions/_shared/schema-utils.ts"]
+// CIL[DOC-MACRO purpose="sanitize and validate a date input"]
+// CIL[DOC-RESPONSIBILITY responsibility="clean and validate date field data so downstream code can trust the value"]
+// CIL[DOC-CONTEXT module="schema-utils" layer="shared" related_files=".framework/functions/_shared/schema-utils.ts,.framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="data: any, validation?: any" outputs="string" errors="throws Error when the input fails validation or constraint checks" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="parses the input as a date and enforces optional min and max dates" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function sanitizeDate(data: any, validation?: any): string {
   let dateStr = String(data).trim()
   
@@ -625,21 +635,23 @@ function sanitizeDate(data: any, validation?: any): string {
   
   return isoDate
 }
-// CIL[END chunk_id="schemautils_sanitizedate_1784020784"]
-// CIL[BEGIN chunk_id="schemautils_sanitizedatetime_1784020784" type="function" identity="sanitizeDatetime" parent="none"]
-// CIL[DOC-MACRO purpose="Validate and format datetime strings"]
-// CIL[DOC-RESPONSIBILITY responsibility="Ensure valid datetime format and constraints"]
-// CIL[DOC-CONTEXT module="schema-utils" layer="shared" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="ISO datetime string" errors="datetime validation errors" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Parses datetime, validates range, returns ISO format" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: shared. 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='sanitize and validate a date input'; No verified external callers; imports: .framework/src/types/types.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/_shared/schema-utils.ts:sanitizeDate:function"]
+
+
+// CIL[BEGIN stable_id="~/.framework/functions/_shared/schema-utils.ts:sanitizeDatetime:function" type="function" identity="sanitizeDatetime" parent="~/.framework/functions/_shared/schema-utils.ts"]
+// CIL[DOC-MACRO purpose="sanitize and validate a datetime input"]
+// CIL[DOC-RESPONSIBILITY responsibility="clean and validate datetime field data so downstream code can trust the value"]
+// CIL[DOC-CONTEXT module="schema-utils" layer="shared" related_files=".framework/functions/_shared/schema-utils.ts,.framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="data: any, validation?: any" outputs="string" errors="throws Error when the input fails validation or constraint checks" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="parses the input as a datetime and enforces optional min and max datetimes" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function sanitizeDatetime(data: any, validation?: any): string {
   let dateStr = String(data).trim()
   
@@ -665,21 +677,23 @@ function sanitizeDatetime(data: any, validation?: any): string {
   
   return isoDatetime
 }
-// CIL[END chunk_id="schemautils_sanitizedatetime_1784020784"]
-// CIL[BEGIN chunk_id="schemautils_sanitizeboolean_1784020784" type="function" identity="sanitizeBoolean" parent="none"]
-// CIL[DOC-MACRO purpose="Convert and sanitize boolean values"]
-// CIL[DOC-RESPONSIBILITY responsibility="Normalize various boolean representations"]
-// CIL[DOC-CONTEXT module="schema-utils" layer="shared" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="boolean value" errors="invalid boolean error" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Handles boolean, string, number representations" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: shared. 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='sanitize and validate a datetime input'; No verified external callers; imports: .framework/src/types/types.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/_shared/schema-utils.ts:sanitizeDatetime:function"]
+
+
+// CIL[BEGIN stable_id="~/.framework/functions/_shared/schema-utils.ts:sanitizeBoolean:function" type="function" identity="sanitizeBoolean" parent="~/.framework/functions/_shared/schema-utils.ts"]
+// CIL[DOC-MACRO purpose="sanitize and validate a boolean input"]
+// CIL[DOC-RESPONSIBILITY responsibility="clean and validate boolean field data so downstream code can trust the value"]
+// CIL[DOC-CONTEXT module="schema-utils" layer="shared" related_files=".framework/functions/_shared/schema-utils.ts,.framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="data: any, validation?: any" outputs="boolean" errors="throws Error when the input fails validation or constraint checks" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="coerces common string and boolean inputs to true or false" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function sanitizeBoolean(data: any, validation?: any): boolean {
   if (typeof data === 'boolean') {
     return data
@@ -694,66 +708,73 @@ function sanitizeBoolean(data: any, validation?: any): boolean {
   
   throw new Error('Invalid boolean value')
 }
-// CIL[END chunk_id="schemautils_sanitizeboolean_1784020784"]
-// CIL[BEGIN chunk_id="schemautils_sanitizecheckbox_1784020784" type="function" identity="sanitizeCheckbox" parent="none"]
-// CIL[DOC-MACRO purpose="Sanitize checkbox boolean values"]
-// CIL[DOC-RESPONSIBILITY responsibility="Delegate checkbox sanitization to boolean sanitizer"]
-// CIL[DOC-CONTEXT module="schema-utils" layer="shared" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="boolean value" errors="boolean validation errors" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Simple wrapper around sanitizeBoolean function" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: shared. 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='sanitize and validate a boolean input'; No verified external callers; imports: .framework/src/types/types.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/_shared/schema-utils.ts:sanitizeBoolean:function"]
+
+
+// CIL[BEGIN stable_id="~/.framework/functions/_shared/schema-utils.ts:sanitizeCheckbox:function" type="function" identity="sanitizeCheckbox" parent="~/.framework/functions/_shared/schema-utils.ts"]
+// CIL[DOC-MACRO purpose="sanitize and validate a checkbox input"]
+// CIL[DOC-RESPONSIBILITY responsibility="clean and validate checkbox field data so downstream code can trust the value"]
+// CIL[DOC-CONTEXT module="schema-utils" layer="shared" related_files=".framework/functions/_shared/schema-utils.ts,.framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="data: any, validation?: any" outputs="boolean" errors="throws Error when the input fails validation or constraint checks" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="coerces the input to a boolean using the boolean sanitizer" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function sanitizeCheckbox(data: any, validation?: any): boolean {
   return sanitizeBoolean(data, validation)
 }
-// CIL[END chunk_id="schemautils_sanitizecheckbox_1784020784"]
-// CIL[BEGIN chunk_id="schemautils_sanitizeselect_1784020784" type="function" identity="sanitizeSelect" parent="none"]
-// CIL[DOC-MACRO purpose="Validate select field options"]
-// CIL[DOC-RESPONSIBILITY responsibility="Ensure selected value is in allowed options"]
-// CIL[DOC-CONTEXT module="schema-utils" layer="shared" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="validated option" errors="invalid option error" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Trims value, checks against allowed options array" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: shared. 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='sanitize and validate a checkbox input'; No verified external callers; imports: .framework/src/types/types.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/_shared/schema-utils.ts:sanitizeCheckbox:function"]
+
+
+// CIL[BEGIN stable_id="~/.framework/functions/_shared/schema-utils.ts:sanitizeSelect:function" type="function" identity="sanitizeSelect" parent="~/.framework/functions/_shared/schema-utils.ts"]
+// CIL[DOC-MACRO purpose="sanitize and validate a select input"]
+// CIL[DOC-RESPONSIBILITY responsibility="clean and validate select field data so downstream code can trust the value"]
+// CIL[DOC-CONTEXT module="schema-utils" layer="shared" related_files=".framework/functions/_shared/schema-utils.ts,.framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="data: any, validation?: any" outputs="string" errors="throws Error when the input fails validation or constraint checks" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="trims the input and validates it against the configured allowed options" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function sanitizeSelect(data: any, validation?: any): string {
   let value = String(data).trim()
-  
+
   if (validation?.options) {
-    const allowedValues = Array.isArray(validation.options) ? validation.options : []
+    const allowedValues = (Array.isArray(validation.options) ? validation.options : [])
+      .map((o: any) => (o && typeof o === 'object' ? o.value : o))
     if (!allowedValues.includes(value)) {
       throw new Error('Invalid option selected')
     }
   }
-  
+
   return value
 }
-// CIL[END chunk_id="schemautils_sanitizeselect_1784020784"]
-// CIL[BEGIN chunk_id="schemautils_sanitizemultiselect_1784020784" type="function" identity="sanitizeMultiselect" parent="none"]
-// CIL[DOC-MACRO purpose="Validate multiselect array values"]
-// CIL[DOC-RESPONSIBILITY responsibility="Handle array or comma-separated multiselect data"]
-// CIL[DOC-CONTEXT module="schema-utils" layer="shared" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="validated array" errors="invalid option errors" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Converts to array, removes duplicates, validates options" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: shared. 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='sanitize and validate a select input'; No verified external callers; imports: .framework/src/types/types.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/_shared/schema-utils.ts:sanitizeSelect:function"]
+
+
+// CIL[BEGIN stable_id="~/.framework/functions/_shared/schema-utils.ts:sanitizeMultiselect:function" type="function" identity="sanitizeMultiselect" parent="~/.framework/functions/_shared/schema-utils.ts"]
+// CIL[DOC-MACRO purpose="sanitize and validate a multiselect input"]
+// CIL[DOC-RESPONSIBILITY responsibility="clean and validate multiselect field data so downstream code can trust the value"]
+// CIL[DOC-CONTEXT module="schema-utils" layer="shared" related_files=".framework/functions/_shared/schema-utils.ts,.framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="data: any, validation?: any" outputs="string[]" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="normalizes input to an array, deduplicates, validates against allowed options, and enforces max selection count" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function sanitizeMultiselect(data: any, validation?: any): string[] {
   let values: string[]
   
@@ -768,7 +789,8 @@ function sanitizeMultiselect(data: any, validation?: any): string[] {
   values = [...new Set(values)]
   
   if (validation?.options) {
-    const allowedValues = Array.isArray(validation.options) ? validation.options : []
+    const allowedValues = (Array.isArray(validation.options) ? validation.options : [])
+      .map((o: any) => (o && typeof o === 'object' ? o.value : o))
     for (const value of values) {
       if (!allowedValues.includes(value)) {
         throw new Error(`Invalid option: ${value}`)
@@ -782,39 +804,43 @@ function sanitizeMultiselect(data: any, validation?: any): string[] {
   
   return values
 }
-// CIL[END chunk_id="schemautils_sanitizemultiselect_1784020784"]
-// CIL[BEGIN chunk_id="schemautils_sanitizeradio_1784020784" type="function" identity="sanitizeRadio" parent="none"]
-// CIL[DOC-MACRO purpose="Validate radio button selections"]
-// CIL[DOC-RESPONSIBILITY responsibility="Delegate radio sanitization to select sanitizer"]
-// CIL[DOC-CONTEXT module="schema-utils" layer="shared" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="validated option" errors="invalid option error" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Simple wrapper around sanitizeSelect function" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: shared. 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='sanitize and validate a multiselect input'; No verified external callers; imports: .framework/src/types/types.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/_shared/schema-utils.ts:sanitizeMultiselect:function"]
+
+
+// CIL[BEGIN stable_id="~/.framework/functions/_shared/schema-utils.ts:sanitizeRadio:function" type="function" identity="sanitizeRadio" parent="~/.framework/functions/_shared/schema-utils.ts"]
+// CIL[DOC-MACRO purpose="sanitize and validate a radio input"]
+// CIL[DOC-RESPONSIBILITY responsibility="clean and validate radio field data so downstream code can trust the value"]
+// CIL[DOC-CONTEXT module="schema-utils" layer="shared" related_files=".framework/functions/_shared/schema-utils.ts,.framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="data: any, validation?: any" outputs="string" errors="throws Error when the input fails validation or constraint checks" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="trims the input and validates it against the configured allowed options using the select sanitizer" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function sanitizeRadio(data: any, validation?: any): string {
   return sanitizeSelect(data, validation)
 }
-// CIL[END chunk_id="schemautils_sanitizeradio_1784020784"]
-// CIL[BEGIN chunk_id="schemautils_sanitizeolor_1784020784" type="function" identity="sanitizeColor" parent="none"]
-// CIL[DOC-MACRO purpose="Validate and format hex color codes"]
-// CIL[DOC-RESPONSIBILITY responsibility="Ensure proper hex color format"]
-// CIL[DOC-CONTEXT module="schema-utils" layer="shared" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="normalized hex color" errors="invalid color format error" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Validates hex format, converts 3-digit to 6-digit, uppercases" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: shared. 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='sanitize and validate a radio input'; No verified external callers; imports: .framework/src/types/types.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/_shared/schema-utils.ts:sanitizeRadio:function"]
+
+
+// CIL[BEGIN stable_id="~/.framework/functions/_shared/schema-utils.ts:sanitizeColor:function" type="function" identity="sanitizeColor" parent="~/.framework/functions/_shared/schema-utils.ts"]
+// CIL[DOC-MACRO purpose="sanitize and validate a color input"]
+// CIL[DOC-RESPONSIBILITY responsibility="clean and validate color field data so downstream code can trust the value"]
+// CIL[DOC-CONTEXT module="schema-utils" layer="shared" related_files=".framework/functions/_shared/schema-utils.ts,.framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="data: any, validation?: any" outputs="string" errors="throws Error when the input fails validation or constraint checks" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="validates and normalizes a hex color to a six-digit uppercase string" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function sanitizeColor(data: any, validation?: any): string {
   let color = String(data).trim()
   
@@ -829,21 +855,23 @@ function sanitizeColor(data: any, validation?: any): string {
   
   return color.toUpperCase()
 }
-// CIL[END chunk_id="schemautils_sanitizeolor_1784020784"]
-// CIL[BEGIN chunk_id="schemautils_sanitizeile_1784020784" type="function" identity="sanitizeFile" parent="none"]
-// CIL[DOC-MACRO purpose="Validate file objects and metadata"]
-// CIL[DOC-RESPONSIBILITY responsibility="Ensure file data validity and constraints"]
-// CIL[DOC-CONTEXT module="schema-utils" layer="shared" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="validated file object" errors="file validation errors" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Checks object structure, size, type, sanitizes filename" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: shared. 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='sanitize and validate a color input'; No verified external callers; imports: .framework/src/types/types.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/_shared/schema-utils.ts:sanitizeColor:function"]
+
+
+// CIL[BEGIN stable_id="~/.framework/functions/_shared/schema-utils.ts:sanitizeFile:function" type="function" identity="sanitizeFile" parent="~/.framework/functions/_shared/schema-utils.ts"]
+// CIL[DOC-MACRO purpose="sanitize and validate a file input"]
+// CIL[DOC-RESPONSIBILITY responsibility="clean and validate file field data so downstream code can trust the value"]
+// CIL[DOC-CONTEXT module="schema-utils" layer="shared" related_files=".framework/functions/_shared/schema-utils.ts,.framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="data: any, validation?: any" outputs="any" errors="throws Error when the input fails validation or constraint checks" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="validates file metadata, enforces size and type constraints, and sanitizes the file name" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function sanitizeFile(data: any, validation?: any): any {
   if (typeof data !== 'object' || !data.name) {
     throw new Error('Invalid file data')
@@ -861,21 +889,23 @@ function sanitizeFile(data: any, validation?: any): any {
   
   return data
 }
-// CIL[END chunk_id="schemautils_sanitizeile_1784020784"]
-// CIL[BEGIN chunk_id="schemautils_sanitizeimage_1784020784" type="function" identity="sanitizeImage" parent="none"]
-// CIL[DOC-MACRO purpose="Validate image files with dimensions"]
-// CIL[DOC-RESPONSIBILITY responsibility="Extend file sanitization for image-specific validation"]
-// CIL[DOC-CONTEXT module="schema-utils" layer="shared" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="validated image object" errors="image validation errors" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Uses file sanitizer, placeholder for dimension validation" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: shared. 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='sanitize and validate a file input'; No verified external callers; imports: .framework/src/types/types.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/_shared/schema-utils.ts:sanitizeFile:function"]
+
+
+// CIL[BEGIN stable_id="~/.framework/functions/_shared/schema-utils.ts:sanitizeImage:function" type="function" identity="sanitizeImage" parent="~/.framework/functions/_shared/schema-utils.ts"]
+// CIL[DOC-MACRO purpose="sanitize and validate a image input"]
+// CIL[DOC-RESPONSIBILITY responsibility="clean and validate image field data so downstream code can trust the value"]
+// CIL[DOC-CONTEXT module="schema-utils" layer="shared" related_files=".framework/functions/_shared/schema-utils.ts,.framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="data: any, validation?: any" outputs="any" errors="throws Error when the input fails validation or constraint checks" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="validates file data and applies optional dimension constraints (placeholder)" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function sanitizeImage(data: any, validation?: any): any {
   const file = sanitizeFile(data, validation)
   
@@ -884,21 +914,23 @@ function sanitizeImage(data: any, validation?: any): any {
   
   return file
 }
-// CIL[END chunk_id="schemautils_sanitizeimage_1784020784"]
-// CIL[BEGIN chunk_id="schemautils_sanitizejson_1784020784" type="function" identity="sanitizeJson" parent="none"]
-// CIL[DOC-MACRO purpose="Parse and sanitize JSON data"]
-// CIL[DOC-RESPONSIBILITY responsibility="Ensure JSON validity and remove dangerous content"]
-// CIL[DOC-CONTEXT module="schema-utils" layer="shared" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="parsed JSON object" errors="JSON parsing/security errors" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Parses string JSON, checks for dangerous keywords" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: shared. 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='sanitize and validate a image input'; No verified external callers; imports: .framework/src/types/types.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/_shared/schema-utils.ts:sanitizeImage:function"]
+
+
+// CIL[BEGIN stable_id="~/.framework/functions/_shared/schema-utils.ts:sanitizeJson:function" type="function" identity="sanitizeJson" parent="~/.framework/functions/_shared/schema-utils.ts"]
+// CIL[DOC-MACRO purpose="sanitize and validate a json input"]
+// CIL[DOC-RESPONSIBILITY responsibility="clean and validate json field data so downstream code can trust the value"]
+// CIL[DOC-CONTEXT module="schema-utils" layer="shared" related_files=".framework/functions/_shared/schema-utils.ts,.framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="data: any, validation?: any" outputs="any" errors="throws Error when the input fails validation or constraint checks" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="parses string input to JSON, stringifies for safety checks, and rejects values containing forbidden tokens" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function sanitizeJson(data: any, validation?: any): any {
   if (typeof data === 'string') {
     try {
@@ -907,29 +939,50 @@ function sanitizeJson(data: any, validation?: any): any {
       throw new Error('Invalid JSON format')
     }
   }
-  
-  const jsonStr = JSON.stringify(data)
-  if (jsonStr.includes('function') || jsonStr.includes('eval') || jsonStr.includes('script')) {
+
+  if (jsonContainsDangerousContent(data)) {
     throw new Error('JSON contains potentially dangerous content')
   }
-  
+
   return data
 }
-// CIL[END chunk_id="schemautils_sanitizejson_1784020784"]
-// CIL[BEGIN chunk_id="schemautils_sanitizereference_1784020784" type="function" identity="sanitizeReference" parent="none"]
-// CIL[DOC-MACRO purpose="Validate UUID reference format"]
-// CIL[DOC-RESPONSIBILITY responsibility="Ensure reference follows UUID pattern"]
-// CIL[DOC-CONTEXT module="schema-utils" layer="shared" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="validated UUID string" errors="invalid UUID error" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Validates against UUID regex pattern, trims whitespace" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: shared. 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."]
+
+// JSON field values are inert data — the real hazards are executable
+// payloads smuggled inside string values (script tags, javascript: URLs,
+// eval/Function calls, inline event handlers) and __proto__ keys, which
+// prototype-pollute objects the payload is later merged into. Substring
+// matching on the serialized JSON is NOT safe here: it rejects ordinary
+// words like "functionality", "description", "evaluate", and "transcript".
+const DANGEROUS_JSON_VALUE_PATTERN =
+  /<\s*\/?\s*script|javascript\s*:|\beval\s*\(|\bfunction\s*\(|new\s+Function\s*\(|\bon\w+\s*=/i
+
+function jsonContainsDangerousContent(value: any): boolean {
+  if (typeof value === 'string') return DANGEROUS_JSON_VALUE_PATTERN.test(value)
+  if (Array.isArray(value)) return value.some(jsonContainsDangerousContent)
+  if (value && typeof value === 'object') {
+    return Object.entries(value).some(
+      ([key, v]) => key === '__proto__' || jsonContainsDangerousContent(v)
+    )
+  }
+  return false
+}
+// CIL[DOC-VECTOR type="context" content="purpose='sanitize and validate a json input'; No verified external callers; imports: .framework/src/types/types.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/_shared/schema-utils.ts:sanitizeJson:function"]
+
+
+// CIL[BEGIN stable_id="~/.framework/functions/_shared/schema-utils.ts:sanitizeReference:function" type="function" identity="sanitizeReference" parent="~/.framework/functions/_shared/schema-utils.ts"]
+// CIL[DOC-MACRO purpose="sanitize and validate a reference input"]
+// CIL[DOC-RESPONSIBILITY responsibility="clean and validate reference field data so downstream code can trust the value"]
+// CIL[DOC-CONTEXT module="schema-utils" layer="shared" related_files=".framework/functions/_shared/schema-utils.ts,.framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="data: any, validation?: any" outputs="string" errors="throws Error when the input fails validation or constraint checks" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="validates that the input is a standard UUID string" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function sanitizeReference(data: any, validation?: any): string {
   let ref = String(data).trim()
   
@@ -940,21 +993,23 @@ function sanitizeReference(data: any, validation?: any): string {
   
   return ref
 }
-// CIL[END chunk_id="schemautils_sanitizereference_1784020784"]
-// CIL[BEGIN chunk_id="schemautils_sanitizeaddress_1784020784" type="function" identity="sanitizeAddress" parent="none"]
-// CIL[DOC-MACRO purpose="Sanitize address object data"]
-// CIL[DOC-RESPONSIBILITY responsibility="Clean address fields and validate structure"]
-// CIL[DOC-CONTEXT module="schema-utils" layer="shared" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="sanitized address object" errors="invalid address error" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Validates object type, sanitizes string fields with text sanitizer" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: shared. 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='sanitize and validate a reference input'; No verified external callers; imports: .framework/src/types/types.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/_shared/schema-utils.ts:sanitizeReference:function"]
+
+
+// CIL[BEGIN stable_id="~/.framework/functions/_shared/schema-utils.ts:sanitizeAddress:function" type="function" identity="sanitizeAddress" parent="~/.framework/functions/_shared/schema-utils.ts"]
+// CIL[DOC-MACRO purpose="sanitize and validate a address input"]
+// CIL[DOC-RESPONSIBILITY responsibility="clean and validate address field data so downstream code can trust the value"]
+// CIL[DOC-CONTEXT module="schema-utils" layer="shared" related_files=".framework/functions/_shared/schema-utils.ts,.framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="data: any, validation?: any" outputs="any" errors="throws Error when the input fails validation or constraint checks" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="sanitizes string fields of an address object and returns the cleaned object" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function sanitizeAddress(data: any, validation?: any): any {
   if (typeof data !== 'object' || data === null) {
     throw new Error('Address must be an object')
@@ -971,39 +1026,43 @@ function sanitizeAddress(data: any, validation?: any): any {
   
   return sanitized
 }
-// CIL[END chunk_id="schemautils_sanitizeaddress_1784020784"]
-// CIL[BEGIN chunk_id="schemautils_formatjson_1784020784" type="function" identity="formatJson" parent="none"]
-// CIL[DOC-MACRO purpose="Format JSON with pretty printing"]
-// CIL[DOC-RESPONSIBILITY responsibility="Convert JSON to readable string format"]
-// CIL[DOC-CONTEXT module="schema-utils" layer="shared" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="formatted JSON string" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Uses JSON.stringify with 2-space indentation" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: shared. 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='sanitize and validate a address input'; No verified external callers; imports: .framework/src/types/types.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/_shared/schema-utils.ts:sanitizeAddress:function"]
+
+
+// CIL[BEGIN stable_id="~/.framework/functions/_shared/schema-utils.ts:formatJson:function" type="function" identity="formatJson" parent="~/.framework/functions/_shared/schema-utils.ts"]
+// CIL[DOC-MACRO purpose="format a json value for display"]
+// CIL[DOC-RESPONSIBILITY responsibility="convert json data into a human-readable string for UI rendering"]
+// CIL[DOC-CONTEXT module="schema-utils" layer="shared" related_files=".framework/functions/_shared/schema-utils.ts,.framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="data: any" outputs="string" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="pretty-prints a JSON value with two-space indentation" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function formatJson(data: any): string {
   return JSON.stringify(data, null, 2)
 }
-// CIL[END chunk_id="schemautils_formatjson_1784020784"]
-// CIL[BEGIN chunk_id="schemautils_formatdate_1784020784" type="function" identity="formatDate" parent="none"]
-// CIL[DOC-MACRO purpose="Format dates for display"]
-// CIL[DOC-RESPONSIBILITY responsibility="Convert date to human-readable format"]
-// CIL[DOC-CONTEXT module="schema-utils" layer="shared" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="formatted date string" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Uses toLocaleDateString with long month format" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: shared. 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='format a json value for display'; No verified external callers; imports: .framework/src/types/types.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/_shared/schema-utils.ts:formatJson:function"]
+
+
+// CIL[BEGIN stable_id="~/.framework/functions/_shared/schema-utils.ts:formatDate:function" type="function" identity="formatDate" parent="~/.framework/functions/_shared/schema-utils.ts"]
+// CIL[DOC-MACRO purpose="format a date value for display"]
+// CIL[DOC-RESPONSIBILITY responsibility="convert date data into a human-readable string for UI rendering"]
+// CIL[DOC-CONTEXT module="schema-utils" layer="shared" related_files=".framework/functions/_shared/schema-utils.ts,.framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="data: string" outputs="string" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="converts an ISO date string to a human-readable localized date" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function formatDate(data: string): string {
   const date = new Date(data)
   if (isNaN(date.getTime())) {
@@ -1016,21 +1075,23 @@ function formatDate(data: string): string {
     day: 'numeric'
   })
 }
-// CIL[END chunk_id="schemautils_formatdate_1784020784"]
-// CIL[BEGIN chunk_id="schemautils_formatdatetime_1784020784" type="function" identity="formatDatetime" parent="none"]
-// CIL[DOC-MACRO purpose="Format datetime for display"]
-// CIL[DOC-RESPONSIBILITY responsibility="Convert datetime to human-readable format"]
-// CIL[DOC-CONTEXT module="schema-utils" layer="shared" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="formatted datetime string" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Uses toLocaleString with date and time components" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: shared. 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='format a date value for display'; No verified external callers; imports: .framework/src/types/types.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/_shared/schema-utils.ts:formatDate:function"]
+
+
+// CIL[BEGIN stable_id="~/.framework/functions/_shared/schema-utils.ts:formatDatetime:function" type="function" identity="formatDatetime" parent="~/.framework/functions/_shared/schema-utils.ts"]
+// CIL[DOC-MACRO purpose="format a datetime value for display"]
+// CIL[DOC-RESPONSIBILITY responsibility="convert datetime data into a human-readable string for UI rendering"]
+// CIL[DOC-CONTEXT module="schema-utils" layer="shared" related_files=".framework/functions/_shared/schema-utils.ts,.framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="data: string" outputs="string" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="converts an ISO datetime string to a human-readable localized datetime" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function formatDatetime(data: string): string {
   const date = new Date(data)
   if (isNaN(date.getTime())) {
@@ -1045,21 +1106,23 @@ function formatDatetime(data: string): string {
     minute: '2-digit'
   })
 }
-// CIL[END chunk_id="schemautils_formatdatetime_1784020784"]
-// CIL[BEGIN chunk_id="schemautils_formatcurrency_1784020784" type="function" identity="formatCurrency" parent="none"]
-// CIL[DOC-MACRO purpose="Format currency with locale"]
-// CIL[DOC-RESPONSIBILITY responsibility="Format numbers as currency strings"]
-// CIL[DOC-CONTEXT module="schema-utils" layer="shared" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="formatted currency string" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Uses Intl.NumberFormat with currency style" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: shared. 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='format a datetime value for display'; No verified external callers; imports: .framework/src/types/types.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/_shared/schema-utils.ts:formatDatetime:function"]
+
+
+// CIL[BEGIN stable_id="~/.framework/functions/_shared/schema-utils.ts:formatCurrency:function" type="function" identity="formatCurrency" parent="~/.framework/functions/_shared/schema-utils.ts"]
+// CIL[DOC-MACRO purpose="format a currency value for display"]
+// CIL[DOC-RESPONSIBILITY responsibility="convert currency data into a human-readable string for UI rendering"]
+// CIL[DOC-CONTEXT module="schema-utils" layer="shared" related_files=".framework/functions/_shared/schema-utils.ts,.framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="data: number, context?: any" outputs="string" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="formats a number as an ICU currency string using the provided context currency or USD" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function formatCurrency(data: number, context?: any): string {
   const currency = context?.currency_code || 'USD'
   return new Intl.NumberFormat('en-US', {
@@ -1067,21 +1130,23 @@ function formatCurrency(data: number, context?: any): string {
     currency: currency
   }).format(data)
 }
-// CIL[END chunk_id="schemautils_formatcurrency_1784020784"]
-// CIL[BEGIN chunk_id="schemautils_formatphone_1784020784" type="function" identity="formatPhone" parent="none"]
-// CIL[DOC-MACRO purpose="Format phone numbers for display"]
-// CIL[DOC-RESPONSIBILITY responsibility="Format phone numbers in standard US format"]
-// CIL[DOC-CONTEXT module="schema-utils" layer="shared" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="formatted phone string" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Formats 10-digit and 11-digit US phone numbers" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: shared. 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='format a currency value for display'; No verified external callers; imports: .framework/src/types/types.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/_shared/schema-utils.ts:formatCurrency:function"]
+
+
+// CIL[BEGIN stable_id="~/.framework/functions/_shared/schema-utils.ts:formatPhone:function" type="function" identity="formatPhone" parent="~/.framework/functions/_shared/schema-utils.ts"]
+// CIL[DOC-MACRO purpose="format a phone value for display"]
+// CIL[DOC-RESPONSIBILITY responsibility="convert phone data into a human-readable string for UI rendering"]
+// CIL[DOC-CONTEXT module="schema-utils" layer="shared" related_files=".framework/functions/_shared/schema-utils.ts,.framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="data: string" outputs="string" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="strips non-digits and formats 10 or 11-digit US numbers" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function formatPhone(data: string): string {
   const phone = data.replace(/\D/g, '')
   if (phone.length === 10) {
@@ -1092,57 +1157,63 @@ function formatPhone(data: string): string {
   
   return data
 }
-// CIL[END chunk_id="schemautils_formatphone_1784020784"]
-// CIL[BEGIN chunk_id="schemautils_formaturl_1784020784" type="function" identity="formatUrl" parent="none"]
-// CIL[DOC-MACRO purpose="Format URLs for display"]
-// CIL[DOC-RESPONSIBILITY responsibility="Return URL data unchanged"]
-// CIL[DOC-CONTEXT module="schema-utils" layer="shared" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="URL string" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Pass-through function, no formatting applied" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: shared. 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='format a phone value for display'; No verified external callers; imports: .framework/src/types/types.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/_shared/schema-utils.ts:formatPhone:function"]
+
+
+// CIL[BEGIN stable_id="~/.framework/functions/_shared/schema-utils.ts:formatUrl:function" type="function" identity="formatUrl" parent="~/.framework/functions/_shared/schema-utils.ts"]
+// CIL[DOC-MACRO purpose="format a url value for display"]
+// CIL[DOC-RESPONSIBILITY responsibility="convert url data into a human-readable string for UI rendering"]
+// CIL[DOC-CONTEXT module="schema-utils" layer="shared" related_files=".framework/functions/_shared/schema-utils.ts,.framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="data: string" outputs="string" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="returns the URL string unchanged" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function formatUrl(data: string): string {
   return data
 }
-// CIL[END chunk_id="schemautils_formaturl_1784020784"]
-// CIL[BEGIN chunk_id="schemautils_formatreference_1784020784" type="function" identity="formatReference" parent="none"]
-// CIL[DOC-MACRO purpose="Format references for display"]
-// CIL[DOC-RESPONSIBILITY responsibility="Return reference data unchanged"]
-// CIL[DOC-CONTEXT module="schema-utils" layer="shared" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="reference string" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Pass-through function, no formatting applied" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: shared. 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='format a url value for display'; No verified external callers; imports: .framework/src/types/types.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/_shared/schema-utils.ts:formatUrl:function"]
+
+
+// CIL[BEGIN stable_id="~/.framework/functions/_shared/schema-utils.ts:formatReference:function" type="function" identity="formatReference" parent="~/.framework/functions/_shared/schema-utils.ts"]
+// CIL[DOC-MACRO purpose="format a reference value for display"]
+// CIL[DOC-RESPONSIBILITY responsibility="convert reference data into a human-readable string for UI rendering"]
+// CIL[DOC-CONTEXT module="schema-utils" layer="shared" related_files=".framework/functions/_shared/schema-utils.ts,.framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="data: string, context?: any" outputs="string" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="returns the reference string unchanged" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function formatReference(data: string, context?: any): string {
   return data
 }
-// CIL[END chunk_id="schemautils_formatreference_1784020784"]
-// CIL[BEGIN chunk_id="schemautils_formataddress_1784020784" type="function" identity="formatAddress" parent="none"]
-// CIL[DOC-MACRO purpose="Format address objects as strings"]
-// CIL[DOC-RESPONSIBILITY responsibility="Convert address object to comma-separated string"]
-// CIL[DOC-CONTEXT module="schema-utils" layer="shared" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="formatted address string" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Joins address components with commas, filters empty values" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: shared. 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='format a reference value for display'; No verified external callers; imports: .framework/src/types/types.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/_shared/schema-utils.ts:formatReference:function"]
+
+
+// CIL[BEGIN stable_id="~/.framework/functions/_shared/schema-utils.ts:formatAddress:function" type="function" identity="formatAddress" parent="~/.framework/functions/_shared/schema-utils.ts"]
+// CIL[DOC-MACRO purpose="format a address value for display"]
+// CIL[DOC-RESPONSIBILITY responsibility="convert address data into a human-readable string for UI rendering"]
+// CIL[DOC-CONTEXT module="schema-utils" layer="shared" related_files=".framework/functions/_shared/schema-utils.ts,.framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="data: any" outputs="string" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="joins present address parts into a comma-separated display string" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function formatAddress(data: any): string {
   if (typeof data !== 'object' || data === null) {
     return String(data)
@@ -1158,21 +1229,23 @@ function formatAddress(data: any): string {
   
   return parts.join(', ')
 }
-// CIL[END chunk_id="schemautils_formataddress_1784020784"]
-// CIL[BEGIN chunk_id="schemautils_formatmultiselect_1784020784" type="function" identity="formatMultiselect" parent="none"]
-// CIL[DOC-MACRO purpose="Format multiselect arrays as strings"]
-// CIL[DOC-RESPONSIBILITY responsibility="Convert array to comma-separated string"]
-// CIL[DOC-CONTEXT module="schema-utils" layer="shared" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="comma-separated string" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Joins array elements with commas, handles non-arrays" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: shared. 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='format a address value for display'; No verified external callers; imports: .framework/src/types/types.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/_shared/schema-utils.ts:formatAddress:function"]
+
+
+// CIL[BEGIN stable_id="~/.framework/functions/_shared/schema-utils.ts:formatMultiselect:function" type="function" identity="formatMultiselect" parent="~/.framework/functions/_shared/schema-utils.ts"]
+// CIL[DOC-MACRO purpose="format a multiselect value for display"]
+// CIL[DOC-RESPONSIBILITY responsibility="convert multiselect data into a human-readable string for UI rendering"]
+// CIL[DOC-CONTEXT module="schema-utils" layer="shared" related_files=".framework/functions/_shared/schema-utils.ts,.framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="data: string[]" outputs="string" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="joins an array into a comma-separated display string" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function formatMultiselect(data: string[]): string {
   if (!Array.isArray(data)) {
     return String(data)
@@ -1180,21 +1253,23 @@ function formatMultiselect(data: string[]): string {
   
   return data.join(', ')
 }
-// CIL[END chunk_id="schemautils_formatmultiselect_1784020784"]
-// CIL[BEGIN chunk_id="schemautils_formatboolean_1784020784" type="function" identity="formatBoolean" parent="none"]
-// CIL[DOC-MACRO purpose="Format booleans with contextual labels"]
-// CIL[DOC-RESPONSIBILITY responsibility="Convert boolean to human-readable labels"]
-// CIL[DOC-CONTEXT module="schema-utils" layer="shared" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="formatted boolean string" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Uses contextual labels for is_active, defaults to Yes/No" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: shared. 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='format a multiselect value for display'; No verified external callers; imports: .framework/src/types/types.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/_shared/schema-utils.ts:formatMultiselect:function"]
+
+
+// CIL[BEGIN stable_id="~/.framework/functions/_shared/schema-utils.ts:formatBoolean:function" type="function" identity="formatBoolean" parent="~/.framework/functions/_shared/schema-utils.ts"]
+// CIL[DOC-MACRO purpose="format a boolean value for display"]
+// CIL[DOC-RESPONSIBILITY responsibility="convert boolean data into a human-readable string for UI rendering"]
+// CIL[DOC-CONTEXT module="schema-utils" layer="shared" related_files=".framework/functions/_shared/schema-utils.ts,.framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="data: boolean, context?: any" outputs="string" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="returns Active/Inactive for the is_active field and Yes/No for other booleans" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function formatBoolean(data: boolean, context?: any): string {
   if (context?.field === 'is_active') {
     return data ? 'Active' : 'Inactive'
@@ -1202,4 +1277,10 @@ function formatBoolean(data: boolean, context?: any): string {
   
   return data ? 'Yes' : 'No'
 }
-// CIL[END chunk_id="schemautils_formatboolean_1784020784"]
+// CIL[DOC-VECTOR type="context" content="purpose='format a boolean value for display'; No verified external callers; imports: .framework/src/types/types.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/_shared/schema-utils.ts:formatBoolean:function"]