spine-framework 0.3.145 → 0.4.0

package/.framework/functions/pipelines.ts

@@ -1,8 +1,24 @@
+// CIL[BEGIN stable_id="~/.framework/functions/pipelines.ts:module_header:module_header" type="module_header" identity="module_header" parent="~/.framework/functions/pipelines.ts"]
+// CIL[DOC-MACRO purpose="Pipeline handler module imports shared dependencies and exports CRUD and dispatch handlers."]
+// CIL[DOC-RESPONSIBILITY responsibility="Import createHandler, adminDb, emitLog, sanitizeRecordData, and isSystemAdmin for pipeline operation handlers."]
+// CIL[DOC-CONTEXT module="pipelines" layer="functions" related_files=".framework/functions/_shared/audit.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/middleware.ts,.framework/functions/_shared/permissions.ts,.framework/functions/_shared/principal.ts"]
+// CIL[DOC-CONTRACT inputs="shared module imports" outputs="bound handler functions" errors="import failures" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Module header imports shared middleware and helpers" notable_decisions="Uses shared helpers instead of inline logic"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-AUDIENCE audience="internal"]
 import { createHandler } from './_shared/middleware'
 import { adminDb } from './_shared/db'
 import { emitLog } from './_shared/audit'
 import { sanitizeRecordData } from './_shared/permissions'
 import { isSystemAdmin } from './_shared/principal'
+// CIL[DOC-VECTOR type="context" content="purpose='Pipeline handler module imports shared dependencies and exports CRUD and dispatch handlers.'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/audit.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/pipelines.ts:module_header:module_header"]
 
 
 
@@ -13,21 +29,14 @@ import { isSystemAdmin } from './_shared/principal'
 
 
 
-// CIL[BEGIN chunk_id="pipelines_module_header_1783932909" type="module_header" identity="module_header" parent="none"]
-// CIL[DOC-MACRO purpose="Lists pipelines filtered by trigger type with sanitization"]
-// CIL[DOC-RESPONSIBILITY responsibility="Handle trigger-based pipeline listing"]
-// CIL[DOC-CONTEXT module="pipelines" layer="api-handler" related_files="[\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/src/pages/admin/RolesPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/functions/_shared/schema-utils.ts\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="ctx, _body" outputs="Array of pipeline records" errors="Throws on validation or DB errors" side_effects="Database queries, permission sanitization"]
-// CIL[DOC-MICRO logic_summary="Filters by trigger_type, applies permission sanitization" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[BEGIN stable_id="~/.framework/functions/pipelines.ts:listByTrigger:constant" type="constant" identity="listByTrigger" parent="~/.framework/functions/pipelines.ts"]
+// CIL[DOC-MACRO purpose="List pipelines filtered by trigger type, optional app and active state."]
+// CIL[DOC-RESPONSIBILITY responsibility="Return a filtered, sanitized list of pipelines for the account."]
+// CIL[DOC-CONTEXT module="pipelines" layer="functions" related_files=".framework/functions/_shared/audit.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/middleware.ts,.framework/functions/_shared/permissions.ts,.framework/functions/_shared/principal.ts,.framework/functions/pipelines.ts"]
+// CIL[DOC-CONTRACT inputs="ctx.query: trigger_type, app_id, include_inactive" outputs="sanitized pipeline array" errors="Missing trigger_type or account; DB errors" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Validate trigger_type and account, query pipelines with filters, sanitize each result" notable_decisions="System admins use adminDb; non-admins use ctx.db"]
+// 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: api-handler. Direct callers: 0. Direct calls: 0. Related files: .framework/src/pages/admin/TypeDetailPage.tsx, .framework/src/pages/admin/RolesPage.tsx, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .framework/functions/_shared/schema-utils.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="implementation_pattern" content="" status="pending_human_input"]
-// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 export const listByTrigger = createHandler(async (ctx, _body) => {
   const { trigger_type, app_id, include_inactive } = ctx.query || {}
 
@@ -64,21 +73,21 @@ export const listByTrigger = createHandler(async (ctx, _body) => {
 
   return sanitized
 })
-// CIL[END chunk_id="pipelines_module_header_1783932909"]
-// CIL[BEGIN chunk_id="pipelines_list_1783932909" type="function" identity="list" parent="none"]
-// CIL[DOC-MACRO purpose="Lists all pipelines with optional app filtering"]
-// CIL[DOC-RESPONSIBILITY responsibility="Handle general pipeline listing"]
-// CIL[DOC-CONTEXT module="pipelines" layer="api-handler" related_files="[\".framework/migrations/015_simplify_apps_table.sql\",\"custom/apps/cortex/functions/custom_cil-embeddings.ts\",\"custom/apps/portal/pages/ContentPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="Array of pipeline records" errors="Throws on validation or DB errors" side_effects="Database queries, permission sanitization"]
-// CIL[DOC-MICRO logic_summary="Lists pipelines with optional app filter, applies sanitization" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: api-handler. Direct callers: 3. Direct calls: 0. Related files: .framework/migrations/015_simplify_apps_table.sql, custom/apps/cortex/functions/custom_cil-embeddings.ts, custom/apps/portal/pages/ContentPage.tsx, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, \."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 3. Total affected: 4."]
-// 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='List pipelines filtered by trigger type, optional app and active state.'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/audit.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/pipelines.ts:listByTrigger:constant"]
+// CIL[BEGIN stable_id="~/.framework/functions/pipelines.ts:list:constant" type="constant" identity="list" parent="~/.framework/functions/pipelines.ts"]
+// CIL[DOC-MACRO purpose="List all pipelines for the account, optionally filtered by app and active state."]
+// CIL[DOC-RESPONSIBILITY responsibility="Return a sanitized list of all pipelines for the account."]
+// CIL[DOC-CONTEXT module="pipelines" layer="functions" related_files=".framework/functions/_shared/audit.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/middleware.ts,.framework/functions/_shared/permissions.ts,.framework/functions/_shared/principal.ts,.framework/functions/pipelines.ts"]
+// CIL[DOC-CONTRACT inputs="ctx.query: app_id, include_inactive" outputs="sanitized pipeline array" errors="Missing account; DB errors" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Validate account, query all pipelines with optional app/active filters, sanitize results" notable_decisions="System admins use adminDb"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export const list = createHandler(async (ctx, body) => {
   const { app_id, include_inactive } = ctx.query || {}
 
@@ -107,21 +116,21 @@ export const list = createHandler(async (ctx, body) => {
 
   return sanitized
 })
-// CIL[END chunk_id="pipelines_list_1783932909"]
-// CIL[BEGIN chunk_id="pipelines_get_1783932909" type="function" identity="get" parent="none"]
-// CIL[DOC-MACRO purpose="Retrieves single pipeline by ID with sanitization"]
-// CIL[DOC-RESPONSIBILITY responsibility="Handle individual pipeline retrieval"]
-// CIL[DOC-CONTEXT module="pipelines" layer="api-handler" related_files="[\".framework/functions/_shared/schema-utils.ts\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\"custom/apps/cortex/functions/custom_cil-embeddings.ts\",\".framework/src/components/ui/dialog.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="Single pipeline record" errors="Throws if ID missing or DB error" side_effects="Database query, permission sanitization"]
-// CIL[DOC-MICRO logic_summary="Fetches pipeline by ID, applies permission sanitization" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: api-handler. Direct callers: 0. Direct calls: 0. Related files: .framework/functions/_shared/schema-utils.ts, .framework/src/pages/admin/TypeDetailPage.tsx, custom/apps/cortex/functions/custom_cil-embeddings.ts, .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='List all pipelines for the account, optionally filtered by app and active state.'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/audit.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/pipelines.ts:list:constant"]
+// CIL[BEGIN stable_id="~/.framework/functions/pipelines.ts:get:constant" type="constant" identity="get" parent="~/.framework/functions/pipelines.ts"]
+// CIL[DOC-MACRO purpose="Get a single pipeline by ID with sanitized output."]
+// CIL[DOC-RESPONSIBILITY responsibility="Return one sanitized pipeline record matching the requested ID."]
+// CIL[DOC-CONTEXT module="pipelines" layer="functions" related_files=".framework/functions/_shared/audit.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/middleware.ts,.framework/functions/_shared/permissions.ts,.framework/functions/_shared/principal.ts,.framework/functions/pipelines.ts"]
+// CIL[DOC-CONTRACT inputs="ctx.query.id" outputs="sanitized pipeline object" errors="Missing ID or account; not found; DB errors" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Validate ID and account, fetch single pipeline, sanitize result" notable_decisions="Uses .single() and adminDb for system admins"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export const get = createHandler(async (ctx, body) => {
   const { id } = ctx.query || {}
 
@@ -141,21 +150,21 @@ export const get = createHandler(async (ctx, body) => {
 
   return await sanitizeRecordData(ctx, data, 'pipeline')
 })
-// CIL[END chunk_id="pipelines_get_1783932909"]
-// CIL[BEGIN chunk_id="pipelines_create_1783932909" type="function" identity="create" parent="none"]
-// CIL[DOC-MACRO purpose="Creates new pipeline with validation and audit logging"]
-// CIL[DOC-RESPONSIBILITY responsibility="Handle pipeline creation with security checks"]
-// CIL[DOC-CONTEXT module="pipelines" layer="api-handler" related_files="[\".framework/functions/_shared/schema-utils.ts\",\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/src/pages/admin/RolesPage.tsx\",\".framework/src/components/ui/dialog.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="Created pipeline record" errors="Throws on validation or DB errors" side_effects="Database insert, audit logging"]
-// CIL[DOC-MICRO logic_summary="Validates required fields, creates pipeline with audit trail" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: api-handler. Direct callers: 0. Direct calls: 0. Related files: .framework/functions/_shared/schema-utils.ts, custom/apps/portal/pages/ContentPage.tsx, .framework/src/pages/admin/RolesPage.tsx, .framework/src/components/ui/dialog.tsx, 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="context" content="purpose='Get a single pipeline by ID with sanitized output.'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/audit.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/pipelines.ts:get:constant"]
+// CIL[BEGIN stable_id="~/.framework/functions/pipelines.ts:create:constant" type="constant" identity="create" parent="~/.framework/functions/pipelines.ts"]
+// CIL[DOC-MACRO purpose="Create a new pipeline record and emit an audit log."]
+// CIL[DOC-RESPONSIBILITY responsibility="Insert a new pipeline and return the created record."]
+// CIL[DOC-CONTEXT module="pipelines" layer="functions" related_files=".framework/functions/_shared/audit.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/middleware.ts,.framework/functions/_shared/permissions.ts,.framework/functions/_shared/principal.ts,.framework/functions/pipelines.ts"]
+// CIL[DOC-CONTRACT inputs="body: name, trigger_type, stages; optional app_id, description, config, metadata" outputs="created pipeline record" errors="Missing required fields; unauthenticated; DB errors" side_effects="Inserts row and emits pipeline.created audit log"]
+// CIL[DOC-MICRO logic_summary="Validate required fields and principal, insert pipeline with created_by, emit audit log" notable_decisions="Defaults empty optional fields to null or empty objects"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export const create = createHandler(async (ctx, body) => {
   const { app_id, name, description, trigger_type, config, stages, metadata } = body
 
@@ -192,21 +201,21 @@ export const create = createHandler(async (ctx, body) => {
 
   return data
 })
-// CIL[END chunk_id="pipelines_create_1783932909"]
-// CIL[BEGIN chunk_id="pipelines_update_1783932909" type="function" identity="update" parent="none"]
-// CIL[DOC-MACRO purpose="Updates pipeline with selective field validation"]
-// CIL[DOC-RESPONSIBILITY responsibility="Handle pipeline updates with audit trail"]
-// CIL[DOC-CONTEXT module="pipelines" layer="api-handler" related_files="[\".framework/functions/_shared/schema-utils.ts\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/src/components/ui/dialog.tsx\",\".framework/functions/_shared/principal.ts\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="Updated pipeline record" errors="Throws on validation or DB errors" side_effects="Database update, audit logging"]
-// CIL[DOC-MICRO logic_summary="Updates specified fields, maintains audit trail" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: api-handler. Direct callers: 0. Direct calls: 0. Related files: .framework/functions/_shared/schema-utils.ts, .framework/src/pages/admin/TypeDetailPage.tsx, .framework/src/components/ui/dialog.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='Create a new pipeline record and emit an audit log.'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/audit.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/pipelines.ts:create:constant"]
+// CIL[BEGIN stable_id="~/.framework/functions/pipelines.ts:update:constant" type="constant" identity="update" parent="~/.framework/functions/pipelines.ts"]
+// CIL[DOC-MACRO purpose="Update an existing pipeline by ID and emit an audit log."]
+// CIL[DOC-RESPONSIBILITY responsibility="Partially update a pipeline record and return the updated row."]
+// CIL[DOC-CONTEXT module="pipelines" layer="functions" related_files=".framework/functions/_shared/audit.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/middleware.ts,.framework/functions/_shared/permissions.ts,.framework/functions/_shared/principal.ts,.framework/functions/pipelines.ts"]
+// CIL[DOC-CONTRACT inputs="body or query: id; optional name, description, config, stages, metadata, trigger_type, is_active, app_id" outputs="updated pipeline record" errors="Missing ID or principal; not found; DB errors" side_effects="Updates row and emits pipeline.updated audit log"]
+// CIL[DOC-MICRO logic_summary="Fetch current record, build sparse update set, apply update, emit audit log" notable_decisions="Uses undefined check to allow null values; updates updated_at"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export const update = createHandler(async (ctx, body) => {
   const id = body?.id || ctx.query?.id
   const { id: _bodyId, name, description, config, stages, metadata, trigger_type, is_active, app_id } = body || {}
@@ -255,21 +264,21 @@ export const update = createHandler(async (ctx, body) => {
 
   return data
 })
-// CIL[END chunk_id="pipelines_update_1783932909"]
-// CIL[BEGIN chunk_id="pipelines_toggle_1783932909" type="function" identity="toggle" parent="none"]
-// CIL[DOC-MACRO purpose="Toggles pipeline active/inactive status"]
-// CIL[DOC-RESPONSIBILITY responsibility="Handle pipeline activation state changes"]
-// CIL[DOC-CONTEXT module="pipelines" layer="api-handler" related_files="[\".framework/src/pages/admin/RolesPage.tsx\",\".framework/src/pages/admin/IntegrationsPage.tsx\",\"custom/apps/cortex/functions/custom_cil-embeddings.ts\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="Updated pipeline record" errors="Throws on validation or DB errors" side_effects="Database update, audit logging"]
-// CIL[DOC-MICRO logic_summary="Updates is_active flag, tracks state changes" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: api-handler. Direct callers: 1. Direct calls: 0. Related files: .framework/src/pages/admin/RolesPage.tsx, .framework/src/pages/admin/IntegrationsPage.tsx, custom/apps/cortex/functions/custom_cil-embeddings.ts."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 1. Total affected: 1."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="context" content="purpose='Update an existing pipeline by ID and emit an audit log.'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/audit.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/pipelines.ts:update:constant"]
+// CIL[BEGIN stable_id="~/.framework/functions/pipelines.ts:toggle:constant" type="constant" identity="toggle" parent="~/.framework/functions/pipelines.ts"]
+// CIL[DOC-MACRO purpose="Toggle the active state of a pipeline."]
+// CIL[DOC-RESPONSIBILITY responsibility="Set is_active on a pipeline and return the updated record."]
+// CIL[DOC-CONTEXT module="pipelines" layer="functions" related_files=".framework/functions/_shared/audit.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/middleware.ts,.framework/functions/_shared/permissions.ts,.framework/functions/_shared/principal.ts,.framework/functions/pipelines.ts"]
+// CIL[DOC-CONTRACT inputs="body: id, is_active" outputs="updated pipeline record" errors="Missing fields or principal; not found; DB errors" side_effects="Updates is_active and emits pipeline.toggled audit log"]
+// CIL[DOC-MICRO logic_summary="Validate id and is_active, verify pipeline exists, update active flag, emit audit log" notable_decisions="Switches active state independently from full update"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export const toggle = createHandler(async (ctx, body) => {
   const { id, is_active } = body
 
@@ -307,21 +316,21 @@ export const toggle = createHandler(async (ctx, body) => {
 
   return data
 })
-// CIL[END chunk_id="pipelines_toggle_1783932909"]
-// CIL[BEGIN chunk_id="pipelines_getexecutions_1783932909" type="function" identity="getExecutions" parent="none"]
-// CIL[DOC-MACRO purpose="Retrieves execution history for specific pipeline"]
-// CIL[DOC-RESPONSIBILITY responsibility="Handle pipeline execution history queries"]
-// CIL[DOC-CONTEXT module="pipelines" layer="api-handler" related_files="[\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/functions/_shared/principal.ts\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/functions/_shared/schema-utils.ts\",\"custom/apps/portal/pages/ContentPage.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="Array of execution records" errors="Throws if pipeline_id missing or DB error" side_effects="Database query"]
-// CIL[DOC-MICRO logic_summary="Queries execution history with pagination" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: api-handler. Direct callers: 0. Direct calls: 0. Related files: .framework/src/pages/admin/TypeDetailPage.tsx, .framework/functions/_shared/principal.ts, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .framework/functions/_shared/schema-utils.ts, 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="context" content="purpose='Toggle the active state of a pipeline.'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/audit.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/pipelines.ts:toggle:constant"]
+// CIL[BEGIN stable_id="~/.framework/functions/pipelines.ts:getExecutions:constant" type="constant" identity="getExecutions" parent="~/.framework/functions/pipelines.ts"]
+// CIL[DOC-MACRO purpose="List execution records for a pipeline with pagination."]
+// CIL[DOC-RESPONSIBILITY responsibility="Return paginated pipeline execution history."]
+// CIL[DOC-CONTEXT module="pipelines" layer="functions" related_files=".framework/functions/_shared/audit.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/middleware.ts,.framework/functions/_shared/permissions.ts,.framework/functions/_shared/principal.ts,.framework/functions/pipelines.ts"]
+// CIL[DOC-CONTRACT inputs="ctx.query: pipeline_id, limit, offset" outputs="array of pipeline execution records" errors="Missing pipeline_id; DB errors" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Validate pipeline_id, query executions with range, return data" notable_decisions="Default limit 50 and offset 0; uses ctx.db"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export const getExecutions = createHandler(async (ctx, _body) => {
   const { pipeline_id, limit = 50, offset = 0 } = ctx.query || {}
 
@@ -343,21 +352,21 @@ export const getExecutions = createHandler(async (ctx, _body) => {
 
   return data
 })
-// CIL[END chunk_id="pipelines_getexecutions_1783932909"]
-// CIL[BEGIN chunk_id="pipelines_remove_1783932909" type="function" identity="remove" parent="none"]
-// CIL[DOC-MACRO purpose="Hard deletes pipeline with audit logging"]
-// CIL[DOC-RESPONSIBILITY responsibility="Handle pipeline deletion with audit trail"]
-// CIL[DOC-CONTEXT module="pipelines" layer="api-handler" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="{success: true}" errors="Throws if ID missing or DB error" side_effects="Database delete, audit logging"]
-// CIL[DOC-MICRO logic_summary="Hard deletes pipeline, maintains audit trail" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: api-handler. 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='List execution records for a pipeline with pagination.'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/audit.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/pipelines.ts:getExecutions:constant"]
+// CIL[BEGIN stable_id="~/.framework/functions/pipelines.ts:remove:constant" type="constant" identity="remove" parent="~/.framework/functions/pipelines.ts"]
+// CIL[DOC-MACRO purpose="Delete a pipeline by ID and emit an audit log."]
+// CIL[DOC-RESPONSIBILITY responsibility="Remove a pipeline record and return success."]
+// CIL[DOC-CONTEXT module="pipelines" layer="functions" related_files=".framework/functions/_shared/audit.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/middleware.ts,.framework/functions/_shared/permissions.ts,.framework/functions/_shared/principal.ts,.framework/functions/pipelines.ts"]
+// CIL[DOC-CONTRACT inputs="ctx.query.id" outputs="{ success: true }" errors="Missing ID; not found; DB errors" side_effects="Deletes row and emits pipeline.deleted audit log"]
+// CIL[DOC-MICRO logic_summary="Validate ID, fetch existing pipeline, delete, emit audit log" notable_decisions="Fetches minimal id and name before delete for audit"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export const remove = createHandler(async (ctx, _body) => {
   const id = ctx.query?.id
 
@@ -387,21 +396,21 @@ export const remove = createHandler(async (ctx, _body) => {
 
   return { success: true }
 })
-// CIL[END chunk_id="pipelines_remove_1783932909"]
-// CIL[BEGIN chunk_id="pipelines_handler_1783932909" type="function" identity="handler" parent="none"]
-// CIL[DOC-MACRO purpose="Routes HTTP methods and actions to pipeline handlers"]
-// CIL[DOC-RESPONSIBILITY responsibility="Handle request routing for pipeline operations"]
-// CIL[DOC-CONTEXT module="pipelines" layer="api-handler" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="Varies by handler" errors="Throws on unsupported methods" side_effects="Delegates to appropriate handler"]
-// CIL[DOC-MICRO logic_summary="Routes based on action and method, delegates to 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: api-handler. 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='Delete a pipeline by ID and emit an audit log.'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/audit.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/pipelines.ts:remove:constant"]
+// CIL[BEGIN stable_id="~/.framework/functions/pipelines.ts:handler:constant" type="constant" identity="handler" parent="~/.framework/functions/pipelines.ts"]
+// CIL[DOC-MACRO purpose="Dispatch pipeline requests to the correct handler based on action and method."]
+// CIL[DOC-RESPONSIBILITY responsibility="Route incoming pipeline API calls to the appropriate handler."]
+// CIL[DOC-CONTEXT module="pipelines" layer="functions" related_files=".framework/functions/_shared/audit.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/middleware.ts,.framework/functions/_shared/permissions.ts,.framework/functions/_shared/principal.ts,.framework/functions/pipelines.ts"]
+// CIL[DOC-CONTRACT inputs="ctx.query.action, ctx.query.method, body" outputs="handler result" errors="Invalid action or method" side_effects="Calls delegated handlers"]
+// CIL[DOC-MICRO logic_summary="Switch on action and method to route to listByTrigger, getExecutions, toggle, get, list, create, update, or remove" notable_decisions="Default GET routes to list or get by presence of id"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export const handler = createHandler(async (ctx, body) => {
   const { action } = ctx.query || {}
   const method = ctx.query?.method || 'GET'
@@ -440,4 +449,10 @@ export const handler = createHandler(async (ctx, body) => {
 
   throw new Error('Invalid action or method')
 })
-// CIL[END chunk_id="pipelines_handler_1783932909"]
+// CIL[DOC-VECTOR type="context" content="purpose='Dispatch pipeline requests to the correct handler based on action and method.'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/audit.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/pipelines.ts:handler:constant"]