spine-framework 0.3.145 → 0.4.1

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

@@ -1,22 +1,12 @@
-// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_config_module_header_1784235266" type="module_header" identity="module_header" parent="none"]
-// CIL[DOC-MACRO purpose="Module header and top-level exports for cortex.functions.custom_cil-config"]
-// CIL[DOC-RESPONSIBILITY responsibility="Own module-level imports, exports, and configuration for cortex.functions.custom_cil-config"]
-// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-config" layer="function" related_files="[\".framework/migrations/015_simplify_apps_table.sql\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/src/components/ui/table-primitives.tsx\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="module exports and side effects" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Declares module scope, imports dependencies, and exports public surface of cortex.functions.custom_cil-config" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[BEGIN stable_id="~/.framework/functions/cil-config.ts:module_header:module_header" type="module_header" identity="module_header" parent="~/.framework/functions/cil-config.ts"]
+// CIL[DOC-MACRO purpose="Configuration extraction and link-pass handler for CIL config knowledge items"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provides endpoints to scan repo config files, extract fields, persist cil_config items, and link them to source code chunks"]
+// CIL[DOC-CONTEXT module="framework/functions" layer="functions" related_files=".framework/functions/_shared/cil.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/middleware.ts,.framework/functions/_shared/resolve-ids.ts,.framework/functions/admin-data.ts"]
+// CIL[DOC-CONTRACT inputs="HTTP request with action, project_id, optional repo_path/file_path/selected_paths/selected_extensions/force" outputs="JSON status/extraction/link result" errors="project_id or repo_path missing/invalid, DB or FS errors" side_effects="Reads repo files; creates/updates items and links in adminDb"]
+// CIL[DOC-MICRO logic_summary="Imports shared utilities and defines the Netlify-style handler" notable_decisions="Uses adminDb and admin-data CRUD helpers; keeps file scanning and field extraction in the same module"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
 // CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-AUDIENCE audience="developer"]
-// CIL[DOC-VECTOR type="context" content="Layer: function. Direct callers: 0. Direct calls: 0. Related files: .framework/migrations/015_simplify_apps_table.sql, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, custom/apps/portal/pages/ContentPage.tsx, .framework/src/components/ui/table-primitives.tsx, .framework/src/pages/admin/TypeDetailPage.tsx, \."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
-// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
-// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
-
-
-
-
+// CIL[DOC-AUDIENCE audience="spine-cil,framework-maintainers"]
 
 import { createHandler } from './_shared/middleware'
 import { adminDb } from './_shared/db'
@@ -25,6 +15,13 @@ import { create as adminCreate, update as adminUpdate } from './admin-data'
 import { isSelectedPath } from './_shared/cil'
 import * as fs from 'fs'
 import * as path from 'path'
+// CIL[DOC-VECTOR type="context" content="purpose='Configuration extraction and link-pass handler for CIL config knowledge items'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/resolve-ids.ts"]
+// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
+// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
+// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[END stable_id="~/.framework/functions/cil-config.ts:module_header:module_header"]
 
 
 
@@ -32,23 +29,14 @@ import * as path from 'path'
 
 
 
-
-
-// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_config_module_header_1784235266"]
-// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_config_extractedconfigfield_1784235266" type="interface" identity="extractedconfigfield" parent="none"]
-// CIL[DOC-MACRO purpose="Defines the extractedconfigfield type contract in cortex.functions.custom_cil-config"]
-// CIL[DOC-RESPONSIBILITY responsibility="Describe the shape and allowed fields for extractedconfigfield"]
-// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-config" layer="function" related_files="[\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/functions/_shared/principal.ts\",\".framework/src/pages/admin/IntegrationsPage.tsx\",\".framework/migrations/015_simplify_apps_table.sql\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="type definition for extractedconfigfield" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Declares TypeScript type/interface extractedconfigfield with member definitions" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[BEGIN stable_id="~/.framework/functions/cil-config.ts:ExtractedConfigField:interface" type="interface" identity="ExtractedConfigField" parent="~/.framework/functions/cil-config.ts"]
+// CIL[DOC-MACRO purpose="Data shape for a single configuration field extracted from a repo file"]
+// CIL[DOC-RESPONSIBILITY responsibility="Defines the typed record used by JSON/ENV/SQL extractors"]
+// CIL[DOC-CONTEXT module="framework/functions" layer="domain" related_files=".framework/functions/_shared/cil.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/middleware.ts,.framework/functions/_shared/resolve-ids.ts,.framework/functions/admin-data.ts,.framework/functions/cil-config.ts"]
+// CIL[DOC-CONTRACT inputs="N/A" outputs="TypeScript interface definition" errors="N/A" side_effects="N/A"]
+// CIL[DOC-MICRO logic_summary="Contract for config field metadata including name, type, default, description, source file and source type" notable_decisions="Restricted to known source types and a closed field_type union"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
 // CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: function. Direct callers: 0. Direct calls: 0. Related files: .framework/src/pages/admin/TypeDetailPage.tsx, .framework/functions/_shared/principal.ts, .framework/src/pages/admin/IntegrationsPage.tsx, .framework/migrations/015_simplify_apps_table.sql, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, \."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
-// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
-// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 interface ExtractedConfigField {
   field_name: string
   field_type: 'string' | 'number' | 'boolean' | 'json' | 'env' | 'unknown'
@@ -57,6 +45,13 @@ interface ExtractedConfigField {
   source_file: string
   source_type: 'json' | 'env' | 'sql' | 'ts'
 }
+// CIL[DOC-VECTOR type="context" content="purpose='Data shape for a single configuration field extracted from a repo file'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/resolve-ids.ts"]
+// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
+// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
+// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[END stable_id="~/.framework/functions/cil-config.ts:ExtractedConfigField:interface"]
 
 
 
@@ -67,21 +62,14 @@ interface ExtractedConfigField {
 
 
 
-// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_config_extractedconfigfield_1784235266"]
-// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_config_config_file_patterns_1784235266" type="variable" identity="config_file_patterns" parent="none"]
-// CIL[DOC-MACRO purpose="Defines config_file_patterns configuration or state in cortex.functions.custom_cil-config"]
-// CIL[DOC-RESPONSIBILITY responsibility="Hold the value and default configuration for config_file_patterns"]
-// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-config" layer="function" related_files="[\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/functions/_shared/principal.ts\",\"custom/apps/cortex/functions/custom_cil-embeddings.ts\",\".framework/src/pages/admin/IntegrationsPage.tsx\",\"custom/apps/portal/pages/ContentPage.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="value of config_file_patterns" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Declares config_file_patterns with initial value or constant binding used by cortex.functions.custom_cil-config" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: function. Direct callers: 0. Direct calls: 0. Related files: .framework/src/pages/admin/TypeDetailPage.tsx, .framework/functions/_shared/principal.ts, custom/apps/cortex/functions/custom_cil-embeddings.ts, .framework/src/pages/admin/IntegrationsPage.tsx, custom/apps/portal/pages/ContentPage.tsx, \."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
-// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
-// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[BEGIN stable_id="~/.framework/functions/cil-config.ts:CONFIG_FILE_PATTERNS:constant" type="constant" identity="CONFIG_FILE_PATTERNS" parent="~/.framework/functions/cil-config.ts"]
+// CIL[DOC-MACRO purpose="Regex patterns that identify config files to scan in a repo"]
+// CIL[DOC-RESPONSIBILITY responsibility="Defines the file glob regexes and associated source types used by the file walker"]
+// CIL[DOC-CONTEXT module="framework/functions" layer="config" related_files=".framework/functions/_shared/cil.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/middleware.ts,.framework/functions/_shared/resolve-ids.ts,.framework/functions/admin-data.ts,.framework/functions/cil-config.ts"]
+// CIL[DOC-CONTRACT inputs="N/A" outputs="Array of glob/source_type pairs" errors="N/A" side_effects="N/A"]
+// CIL[DOC-STABILITY stability="internal"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-MICRO logic_summary="Static list of regexes for JSON/ENV/SQL config files and migrations" notable_decisions="Uses RegExp.test against relative repo paths; excludes dotfiles except .env variants"]
 const CONFIG_FILE_PATTERNS: { glob: RegExp; source_type: ExtractedConfigField['source_type'] }[] = [
   { glob: /spine\.config\.json$/,            source_type: 'json' },
   { glob: /\.env(\.example|\.local|\.prod)?$/, source_type: 'env'  },
@@ -91,7 +79,14 @@ const CONFIG_FILE_PATTERNS: { glob: RegExp; source_type: ExtractedConfigField['s
   { glob: /tsconfig[^/]*\.json$/,            source_type: 'json' },
   { glob: /migrations\/\d+_.*\.sql$/,        source_type: 'sql'  },
 ]
+// CIL[END stable_id="~/.framework/functions/cil-config.ts:CONFIG_FILE_PATTERNS:constant"]
 
+// CIL[DOC-VECTOR type="context" content="purpose='Regex patterns that identify config files to scan in a repo'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/resolve-ids.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"]
 
 
 
@@ -100,21 +95,14 @@ const CONFIG_FILE_PATTERNS: { glob: RegExp; source_type: ExtractedConfigField['s
 
 
 
-// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_config_config_file_patterns_1784235266"]
-// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_config_extractfromjson_1784235266" type="function" identity="extractfromjson" parent="none"]
-// CIL[DOC-MACRO purpose="Implements extractfromjson logic in cortex.functions.custom_cil-config"]
-// CIL[DOC-RESPONSIBILITY responsibility="Execute extractfromjson and return its computed result"]
-// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-config" layer="function" related_files="[\"custom/apps/cortex/functions/custom_cil-embeddings.ts\",\".framework/functions/_shared/principal.ts\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/src/pages/admin/IntegrationsPage.tsx\",\".framework/migrations/015_simplify_apps_table.sql\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="return value from function execution" errors="throws on invalid input or runtime failure" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Provides extractfromjson with extractFromJson(content: string, sourceFile: string inputs, handling internal flow and returning a result" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[BEGIN stable_id="~/.framework/functions/cil-config.ts:extractFromJson:function" type="function" identity="extractFromJson" parent="~/.framework/functions/cil-config.ts"]
+// CIL[DOC-MACRO purpose="Walk a JSON object and emit flat configuration fields"]
+// CIL[DOC-RESPONSIBILITY responsibility="Converts a JSON file's top-level object into ExtractedConfigField records, recursing shallow nested objects"]
+// CIL[DOC-CONTEXT module="framework/functions" layer="extraction" related_files=".framework/functions/_shared/cil.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/middleware.ts,.framework/functions/_shared/resolve-ids.ts,.framework/functions/admin-data.ts,.framework/functions/cil-config.ts"]
+// CIL[DOC-CONTRACT inputs="content: string, sourceFile: string" outputs="ExtractedConfigField[]" errors="Swallowed JSON parse failures" side_effects="N/A"]
+// CIL[DOC-MICRO logic_summary="Parses JSON and walks object keys, assigning primitive types and stringified defaults, recursing one level of nested objects" notable_decisions="Cap default JSON object values at 200 chars; type 'unknown' for null; recursion depth capped at prefix.length < 2"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
 // CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: function. Direct callers: 0. Direct calls: 0. Related files: custom/apps/cortex/functions/custom_cil-embeddings.ts, .framework/functions/_shared/principal.ts, .framework/src/pages/admin/TypeDetailPage.tsx, .framework/src/pages/admin/IntegrationsPage.tsx, .framework/migrations/015_simplify_apps_table.sql, \."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
-// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
-// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 function extractFromJson(content: string, sourceFile: string): ExtractedConfigField[] {
   const fields: ExtractedConfigField[] = []
   try {
@@ -148,24 +136,26 @@ function extractFromJson(content: string, sourceFile: string): ExtractedConfigFi
   }
   return fields
 }
+// CIL[DOC-VECTOR type="context" content="purpose='Walk a JSON object and emit flat configuration fields'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/resolve-ids.ts"]
+// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
+// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
+// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[END stable_id="~/.framework/functions/cil-config.ts:extractFromJson:function"]
 
 
 
-// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_config_extractfromjson_1784235266"]
-// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_config_extractfromenv_1784235266" type="function" identity="extractfromenv" parent="none"]
-// CIL[DOC-MACRO purpose="Implements extractfromenv logic in cortex.functions.custom_cil-config"]
-// CIL[DOC-RESPONSIBILITY responsibility="Execute extractfromenv and return its computed result"]
-// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-config" layer="function" related_files="[\"custom/apps/cortex/functions/custom_cil-embeddings.ts\",\".framework/functions/_shared/principal.ts\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/src/pages/admin/IntegrationsPage.tsx\",\".framework/migrations/015_simplify_apps_table.sql\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="return value from function execution" errors="throws on invalid input or runtime failure" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Provides extractfromenv with extractFromEnv(content: string, sourceFile: string inputs, handling internal flow and returning a result" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: function. Direct callers: 0. Direct calls: 0. Related files: custom/apps/cortex/functions/custom_cil-embeddings.ts, .framework/functions/_shared/principal.ts, .framework/src/pages/admin/TypeDetailPage.tsx, .framework/src/pages/admin/IntegrationsPage.tsx, .framework/migrations/015_simplify_apps_table.sql."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
-// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
-// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+
+
+// CIL[BEGIN stable_id="~/.framework/functions/cil-config.ts:extractFromEnv:function" type="function" identity="extractFromEnv" parent="~/.framework/functions/cil-config.ts"]
+// CIL[DOC-MACRO purpose="Parse an env-style file into configuration fields"]
+// CIL[DOC-RESPONSIBILITY responsibility="Reads KEY=VALUE lines, skipping blanks and comments, and returns env-typed fields"]
+// CIL[DOC-CONTEXT module="framework/functions" layer="extraction" related_files=".framework/functions/_shared/cil.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/middleware.ts,.framework/functions/_shared/resolve-ids.ts,.framework/functions/admin-data.ts,.framework/functions/cil-config.ts"]
+          // CIL[DOC-STABILITY stability="internal"]
+          // CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-CONTRACT inputs="content: string, sourceFile: string" outputs="ExtractedConfigField[]" errors="N/A" side_effects="N/A"]
+// CIL[DOC-MICRO logic_summary="Splits content by newline, trims, ignores blanks/comments, splits on first '=' and records key/value pairs" notable_decisions="Env values are stored verbatim; missing value becomes empty string"]
 function extractFromEnv(content: string, sourceFile: string): ExtractedConfigField[] {
   const fields: ExtractedConfigField[] = []
   const lines = content.split('\n')
@@ -188,24 +178,26 @@ function extractFromEnv(content: string, sourceFile: string): ExtractedConfigFie
   }
   return fields
 }
+// CIL[END stable_id="~/.framework/functions/cil-config.ts:extractFromEnv:function"]
+
+// CIL[DOC-VECTOR type="context" content="purpose='Parse an env-style file into configuration fields'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/resolve-ids.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[DOC-CONTEXT module="unknown" layer="unknown" related_files=".framework/functions/_shared/cil.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/middleware.ts,.framework/functions/_shared/resolve-ids.ts,.framework/functions/admin-data.ts,.framework/functions/cil-config.ts"]
 
-// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_config_extractfromenv_1784235266"]
-// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_config_extractfromsql_1784235266" type="function" identity="extractfromsql" parent="none"]
-// CIL[DOC-MACRO purpose="Implements extractfromsql logic in cortex.functions.custom_cil-config"]
-// CIL[DOC-RESPONSIBILITY responsibility="Execute extractfromsql and return its computed result"]
-// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-config" layer="function" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="return value from function execution" errors="throws on invalid input or runtime failure" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Provides extractfromsql with extractFromSql(content: string, sourceFile: string inputs, handling internal flow and returning a result" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[BEGIN stable_id="~/.framework/functions/cil-config.ts:extractFromSql:function" type="function" identity="extractFromSql" parent="~/.framework/functions/cil-config.ts"]
+// CIL[DOC-MACRO purpose="Extract table.column definitions from SQL CREATE TABLE statements"]
+// CIL[DOC-RESPONSIBILITY responsibility="Parses SQL migration files for column names to generate config field slugs"]
+// CIL[DOC-CONTEXT module="framework/functions" layer="extraction" related_files=".framework/functions/_shared/cil.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/middleware.ts,.framework/functions/_shared/resolve-ids.ts,.framework/functions/admin-data.ts,.framework/functions/cil-config.ts"]
+// CIL[DOC-CONTRACT inputs="content: string, sourceFile: string" outputs="ExtractedConfigField[]" errors="N/A" side_effects="N/A"]
+// CIL[DOC-MICRO logic_summary="Regex matches CREATE TABLE blocks and column lines, filters out constraints/indexes, emits table.column fields" notable_decisions="Uses case-insensitive regex; skips columns named like constraint keywords"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
 // CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: function. Direct callers: 0. Direct calls: 0. Related files: none."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
-// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
-// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 function extractFromSql(content: string, sourceFile: string): ExtractedConfigField[] {
   
   const fields: ExtractedConfigField[] = []
@@ -231,26 +223,28 @@ function extractFromSql(content: string, sourceFile: string): ExtractedConfigFie
   }
   return fields
 }
+// CIL[DOC-VECTOR type="context" content="purpose='Extract table.column definitions from SQL CREATE TABLE statements'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/resolve-ids.ts"]
+// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
+// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
+// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[END stable_id="~/.framework/functions/cil-config.ts:extractFromSql:function"]
+
+
 
 
 
 
 
-// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_config_extractfromsql_1784235266"]
-// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_config_walkforconfigfiles_1784235266" type="function" identity="walkforconfigfiles" parent="none"]
-// CIL[DOC-MACRO purpose="Implements walkforconfigfiles logic in cortex.functions.custom_cil-config"]
-// CIL[DOC-RESPONSIBILITY responsibility="Execute walkforconfigfiles and return its computed result"]
-// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-config" layer="function" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="return value from function execution" errors="throws on invalid input or runtime failure" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Provides walkforconfigfiles with walkForConfigFiles(repoPath: string, maxDepth = 3 inputs, handling internal flow and returning a result" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[BEGIN stable_id="~/.framework/functions/cil-config.ts:walkForConfigFiles:function" type="function" identity="walkForConfigFiles" parent="~/.framework/functions/cil-config.ts"]
+// CIL[DOC-MACRO purpose="Recursively discover potential config files within a repository"]
+// CIL[DOC-RESPONSIBILITY responsibility="Walks repo directories up to maxDepth and returns matching relative paths"]
+// CIL[DOC-CONTEXT module="framework/functions" layer="extraction" related_files=".framework/functions/_shared/cil.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/middleware.ts,.framework/functions/_shared/resolve-ids.ts,.framework/functions/admin-data.ts,.framework/functions/cil-config.ts"]
+// CIL[DOC-CONTRACT inputs="repoPath: string, maxDepth: number=3" outputs="string[]" errors="Silently skips unreadable directories" side_effects="Reads directory listings via fs"]
+// CIL[DOC-MICRO logic_summary="Recursive fs.readdirSync traversal that excludes dotfiles, build folders and node_modules, then regex-matches rel paths against CONFIG_FILE_PATTERNS" notable_decisions="Depth limit starts at 0 and compares > maxDepth; .env files allowed despite leading dot"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
 // CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: function. Direct callers: 0. Direct calls: 0. Related files: none."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
-// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
-// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 function walkForConfigFiles(repoPath: string, maxDepth = 3): string[] {
   const results: string[] = []
   const walk = (dir: string, depth: number) => {
@@ -276,26 +270,28 @@ function walkForConfigFiles(repoPath: string, maxDepth = 3): string[] {
   walk(repoPath, 0)
   return results
 }
+// CIL[DOC-VECTOR type="context" content="purpose='Recursively discover potential config files within a repository'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/resolve-ids.ts"]
+// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
+// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
+// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[END stable_id="~/.framework/functions/cil-config.ts:walkForConfigFiles:function"]
+
 
 
 
 
 
-// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_config_walkforconfigfiles_1784235266"]
-// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_config_handler_1784235266" type="variable" identity="handler" parent="none"]
-// CIL[DOC-MACRO purpose="Defines handler configuration or state in cortex.functions.custom_cil-config"]
-// CIL[DOC-RESPONSIBILITY responsibility="Hold the value and default configuration for handler"]
-// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-config" layer="function" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="value of handler" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Declares handler with initial value or constant binding used by cortex.functions.custom_cil-config" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+
+// CIL[BEGIN stable_id="~/.framework/functions/cil-config.ts:handler:constant" type="constant" identity="handler" parent="~/.framework/functions/cil-config.ts"]
+// CIL[DOC-MACRO purpose="Netlify-style function handler for config extraction and CIL config linking"]
+// CIL[DOC-RESPONSIBILITY responsibility="Dispatches status/extract/run/link actions, persists cil_config items and creates configures links"]
+// CIL[DOC-CONTEXT module="framework/functions" layer="functions" related_files=".framework/functions/_shared/cil.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/middleware.ts,.framework/functions/_shared/resolve-ids.ts,.framework/functions/admin-data.ts,.framework/functions/cil-config.ts"]
+// CIL[DOC-CONTRACT inputs="ctx, body: {action, project_id, repo_path?, file_path?, selected_paths?, selected_extensions?, force?}" outputs="JSON result for status/extract/run/link" errors="Throws on missing project_id/repo_path, unknown action, or DB/FS failures" side_effects="Queries and inserts/updates items and links in adminDb"]
+// CIL[DOC-MICRO logic_summary="createHandler wrapper that dispatches actions: status counts items, extract/run scans files and upserts cil_config items, link calls runLinkPass" notable_decisions="Uses resolveTypeId for 'item'; resolves 'cil_configures' link type; supports force to overwrite existing config; batches links in 500 ID chunks"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
 // CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: function. Direct callers: 0. Direct calls: 0. Related files: none."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
-// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
-// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 export const handler = createHandler(async (ctx, body) => {
   const action = ctx.query?.action || body?.action || 'run'
   const projectId = ctx.query?.project_id || body?.project_id
@@ -473,26 +469,28 @@ export const handler = createHandler(async (ctx, body) => {
 
   throw new Error(`Unknown action: ${action}. Valid: extract, link, run, status`)
 })
+// CIL[DOC-VECTOR type="context" content="purpose='Netlify-style function handler for config extraction and CIL config linking'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/resolve-ids.ts"]
+// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
+// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
+// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[END stable_id="~/.framework/functions/cil-config.ts:handler:constant"]
 
 
 
 
 
-// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_config_handler_1784235266"]
-// CIL[BEGIN chunk_id="custom_apps_cortex_functions_custom_cil_config_runlinkpass_1784235266" type="function" identity="runlinkpass" parent="none"]
-// CIL[DOC-MACRO purpose="Implements runlinkpass logic in cortex.functions.custom_cil-config"]
-// CIL[DOC-RESPONSIBILITY responsibility="Execute runlinkpass and return its computed result"]
-// CIL[DOC-CONTEXT module="cortex.functions.custom_cil-config" layer="function" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="return value from function execution" errors="throws on invalid input or runtime failure" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Provides runlinkpass with runLinkPass( inputs, handling internal flow and returning a result" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+
+
+// CIL[BEGIN stable_id="~/.framework/functions/cil-config.ts:runLinkPass:function" type="function" identity="runLinkPass" parent="~/.framework/functions/cil-config.ts"]
+// CIL[DOC-MACRO purpose="Create cil_configures links between config items and code chunks"]
+// CIL[DOC-RESPONSIBILITY responsibility="Matches config field names against chunk code content and inserts missing links"]
+// CIL[DOC-CONTEXT module="framework/functions" layer="functions" related_files=".framework/functions/_shared/cil.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/middleware.ts,.framework/functions/_shared/resolve-ids.ts,.framework/functions/admin-data.ts,.framework/functions/cil-config.ts"]
+// CIL[DOC-CONTRACT inputs="ctx, projectId: string, errors: string[]" outputs="{configures_links_created: number}" errors="N/A" side_effects="Inserts links into adminDb"]
+// CIL[DOC-MICRO logic_summary="Fetches config and chunk items, searches chunk code for field or env patterns, deduplicates against existing links, inserts new links" notable_decisions="Env fields match process.env.<name>; non-env match short name word boundary; 500 ID IN limit for existing link checks"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
 // CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: function. Direct callers: 0. Direct calls: 0. Related files: none."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
-// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
-// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 async function runLinkPass(
   ctx: any,
   projectId: string,
@@ -576,8 +574,14 @@ async function runLinkPass(
 
   return { configures_links_created: linksCreated }
 }
+// CIL[DOC-VECTOR type="context" content="purpose='Create cil_configures links between config items and code chunks'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/resolve-ids.ts"]
+// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
+// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
+// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[END stable_id="~/.framework/functions/cil-config.ts:runLinkPass:function"]
 
 
 
 
-// CIL[END chunk_id="custom_apps_cortex_functions_custom_cil_config_runlinkpass_1784235266"]