spine-framework 0.3.124 → 0.3.126

package/.framework/functions/pipelines.ts

@@ -1,61 +1,33 @@
-/**
- * @module pipelines
- * @audience core-contributor
- * @layer api-handler
- * @stability stable
- *
- * CRUD API for the `pipelines` table, plus execution history access.
- * Pipelines are named lists of stages that execute sequentially via `runPipeline`
- * in `_shared/pipeline-runner.ts`.
- *
- * **Routed by:** `GET/POST/PATCH/DELETE /.netlify/functions/pipelines`
- *
- * **Actions:**
- * | method | ?action      | handler         |
- * |--------|--------------|-----------------|
- * | GET    | by-trigger   | listByTrigger   |
- * | GET    | executions   | getExecutions   |
- * | POST   | toggle       | toggle          |
- * | GET    | ?id          | get             |
- * | GET    | (default)    | list            |
- * | POST   | —            | create          |
- * | PATCH  | —            | update          |
- * | DELETE | —            | remove (hard)   |
- *
- * **Authorization:** All operations use `ctx.db` (RLS-scoped). Authenticated
- * principal required for writes.
- *
- * INVARIANT: `remove` is a hard delete (no soft delete for pipelines).
- * INVARIANT: `toggle` is a dedicated POST action — use instead of PATCH for
- *   is_active changes to ensure proper audit logging.
- *
- * @seeAlso pipeline-runner.ts (runPipeline — actual execution engine)
- * @seeAlso trigger-engine.ts (calls runPipeline when triggers fire)
- * @seeAlso audit.ts (emitLog for pipeline.* events)
- */
-
 import { createHandler } from './_shared/middleware'
-import { joins } from './_shared/db'
+import { adminDb } from './_shared/db'
 import { emitLog } from './_shared/audit'
 import { sanitizeRecordData } from './_shared/permissions'
+import { isSystemAdmin } from './_shared/principal'
+
+
+
+
+
+
+
+
 
-// ─── HANDLERS ─────────────────────────────────────────────────────────────────
-
-// ─── CHUNK_START: PIPELINES_LIST_BY_TRIGGER ──────────────────────────────────────────────
-/**
- * @chunk-id    PIPELINES_LIST_BY_TRIGGER_1_0_0
- * @version     1.0.0
- * @hash        eb5df34b2c5f7b954260202a14cbfbd84967ab03db335bd94894bf66a956a49a
- * @macro       Pipelines by Trigger List Handler
- * @micro       Lists pipelines filtered by trigger type with sanitization
- * @inputs      ctx: CoreContext — Request context with principal and database
- * @inputs      _body: any — Request body (unused for GET)
- * @outputs     Array of sanitized pipeline records with app/createdBy joins
- * @depends-on  [createHandler, joins, sanitizeRecordData]
- * @depended-by [Netlify function routing]
- * @side-effects [DB queries, permission sanitization]
- * @tags        pipelines, list, trigger-type, crud
- */
+
+// 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[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 || {}
 
@@ -67,9 +39,11 @@ export const listByTrigger = createHandler(async (ctx, _body) => {
     throw new Error('Account context required')
   }
 
-  let query = ctx.db
+  const db = isSystemAdmin(ctx.principal) ? adminDb : ctx.db
+
+  let query = db
     .from('pipelines')
-    .select(`*, ${joins.app}, ${joins.createdBy}`)
+    .select('*')
     .eq('trigger_type', trigger_type)
 
   if (app_id) {
@@ -90,23 +64,21 @@ export const listByTrigger = createHandler(async (ctx, _body) => {
 
   return sanitized
 })
-// ─── CHUNK_END: PIPELINES_LIST_BY_TRIGGER ────────────────────────────────────────────────
-
-// ─── CHUNK_START: PIPELINES_LIST ──────────────────────────────────────────────
-/**
- * @chunk-id    PIPELINES_LIST_1_0_0
- * @version     1.0.0
- * @hash        af2b426b38e99a1907d3113a5b0b776204be0e51a897974573fb5ebc63b85892
- * @macro       Pipelines List Handler
- * @micro       Lists all pipelines with optional filtering and sanitization
- * @inputs      ctx: CoreContext — Request context with principal and database
- * @inputs      body: any — Request body (unused for GET)
- * @outputs     Array of sanitized pipeline records with app/createdBy joins
- * @depends-on  [createHandler, joins, sanitizeRecordData]
- * @depended-by [Netlify function routing]
- * @side-effects [DB queries, permission sanitization]
- * @tags        pipelines, list, crud, pagination
- */
+// 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="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 export const list = createHandler(async (ctx, body) => {
   const { app_id, include_inactive } = ctx.query || {}
 
@@ -114,10 +86,11 @@ export const list = createHandler(async (ctx, body) => {
     throw new Error('Account context required')
   }
 
-  // RLS automatically filters to accessible accounts
-  let query = ctx.db
+  const db = isSystemAdmin(ctx.principal) ? adminDb : ctx.db
+
+  let query = db
     .from('pipelines')
-    .select(`*, ${joins.app}, ${joins.createdBy}`)
+    .select('*')
 
   if (app_id) {
     query = query.eq('app_id', app_id)
@@ -127,7 +100,6 @@ export const list = createHandler(async (ctx, body) => {
 
   if (err) throw err
 
-  // Sanitize each record based on role permissions
   const sanitized = []
   for (const pipeline of data || []) {
     sanitized.push(await sanitizeRecordData(ctx, pipeline, 'pipeline'))
@@ -135,23 +107,21 @@ export const list = createHandler(async (ctx, body) => {
 
   return sanitized
 })
-// ─── CHUNK_END: PIPELINES_LIST ────────────────────────────────────────────────
-
-// ─── CHUNK_START: PIPELINES_GET ──────────────────────────────────────────────
-/**
- * @chunk-id    PIPELINES_GET_1_0_0
- * @version     1.0.0
- * @hash        27a956f4dfe17b93c89170d8f3a9f3f792e4b264b48d13017a52d08014008033
- * @macro       Pipeline Get Handler
- * @micro       Returns single pipeline record with joins and sanitization
- * @inputs      ctx: CoreContext — Request context with principal and database
- * @inputs      body: any — Request body (unused for GET)
- * @outputs     Sanitized pipeline record with app/createdBy joins
- * @depends-on  [createHandler, joins, sanitizeRecordData]
- * @depended-by [Netlify function routing]
- * @side-effects [DB single row query, permission sanitization]
- * @tags        pipelines, get, crud, single-record
- */
+// 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="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 export const get = createHandler(async (ctx, body) => {
   const { id } = ctx.query || {}
 
@@ -159,34 +129,33 @@ export const get = createHandler(async (ctx, body) => {
     throw new Error('Pipeline ID is required')
   }
 
-  const { data, error: err } = await ctx.db
+  const db = isSystemAdmin(ctx.principal) ? adminDb : ctx.db
+
+  const { data, error: err } = await db
     .from('pipelines')
-    .select(`*, ${joins.app}, ${joins.createdBy}`)
+    .select('*')
     .eq('id', id)
     .single()
 
   if (err) throw err
 
-  // Sanitize based on role permissions
   return await sanitizeRecordData(ctx, data, 'pipeline')
 })
-// ─── CHUNK_END: PIPELINES_GET ────────────────────────────────────────────────
-
-// ─── CHUNK_START: PIPELINES_CREATE ──────────────────────────────────────────────
-/**
- * @chunk-id    PIPELINES_CREATE_1_0_0
- * @version     1.0.0
- * @hash        b39ec2f696a5d4a9589b7fce769eb0e174d5b0b17b7f4155dc10b5fe70c09252
- * @macro       Pipeline Create Handler
- * @micro       Creates pipeline record with validation and audit logging
- * @inputs      ctx: CoreContext — Request context with principal and database
- * @inputs      body: object — Pipeline data including name, trigger_type, stages
- * @outputs     Inserted pipeline record
- * @depends-on  [createHandler, emitLog]
- * @depended-by [Netlify function routing]
- * @side-effects [DB insert, audit logging]
- * @tags        pipelines, create, crud, audit
- */
+// 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="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 export const create = createHandler(async (ctx, body) => {
   const { app_id, name, description, trigger_type, config, stages, metadata } = body
 
@@ -223,26 +192,24 @@ export const create = createHandler(async (ctx, body) => {
 
   return data
 })
-// ─── CHUNK_END: PIPELINES_CREATE ────────────────────────────────────────────────
-
-// ─── CHUNK_START: PIPELINES_UPDATE ──────────────────────────────────────────────
-/**
- * @chunk-id    PIPELINES_UPDATE_1_0_0
- * @version     1.0.0
- * @hash        309910d5389fffcdc6b97b33dfd76f2217bb89e26469f73e4e792f9c41977a8f
- * @macro       Pipeline Update Handler
- * @micro       Updates pipeline with field allowlist and audit logging
- * @inputs      ctx: CoreContext — Request context with principal and database
- * @inputs      body: object — Pipeline updates including id and updatable fields
- * @outputs     Updated pipeline record
- * @depends-on  [createHandler, emitLog]
- * @depended-by [Netlify function routing]
- * @side-effects [DB update, audit logging]
- * @tags        pipelines, update, crud, audit
- */
+// 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="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 export const update = createHandler(async (ctx, body) => {
   const id = body?.id || ctx.query?.id
-  const { id: _bodyId, name, description, config, stages, metadata } = body || {}
+  const { id: _bodyId, name, description, config, stages, metadata, trigger_type, is_active, app_id } = body || {}
 
   if (!id) {
     throw new Error('Pipeline ID is required')
@@ -252,7 +219,6 @@ export const update = createHandler(async (ctx, body) => {
     throw new Error('User context (person and account) required')
   }
 
-  // Get current state for audit - RLS will filter to accessible pipelines
   const { data: current } = await ctx.db
     .from('pipelines')
     .select('*')
@@ -269,6 +235,9 @@ export const update = createHandler(async (ctx, body) => {
   if (config !== undefined) updateData.config = config
   if (stages !== undefined) updateData.stages = stages
   if (metadata !== undefined) updateData.metadata = metadata
+  if (trigger_type !== undefined) updateData.trigger_type = trigger_type
+  if (is_active !== undefined) updateData.is_active = is_active
+  if (app_id !== undefined) updateData.app_id = app_id
 
   const { data, error: err } = await ctx.db
     .from('pipelines')
@@ -286,23 +255,21 @@ export const update = createHandler(async (ctx, body) => {
 
   return data
 })
-// ─── CHUNK_END: PIPELINES_UPDATE ────────────────────────────────────────────────
-
-// ─── CHUNK_START: PIPELINES_TOGGLE ──────────────────────────────────────────────
-/**
- * @chunk-id    PIPELINES_TOGGLE_1_0_0
- * @version     1.0.0
- * @hash        4167ca4a65e675a0e37d0237000acf0fe5fdb23699495ff9f46b39f1a4e93884
- * @macro       Pipeline Toggle Handler
- * @micro       Activates or deactivates pipeline with audit logging
- * @inputs      ctx: CoreContext — Request context with principal and database
- * @inputs      body: object — Pipeline id and is_active boolean
- * @outputs     Updated pipeline record
- * @depends-on  [createHandler, emitLog]
- * @depended-by [Netlify function routing]
- * @side-effects [DB update, audit logging]
- * @tags        pipelines, toggle, state-transition, audit
- */
+// 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="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 export const toggle = createHandler(async (ctx, body) => {
   const { id, is_active } = body
 
@@ -314,7 +281,6 @@ export const toggle = createHandler(async (ctx, body) => {
     throw new Error('User context (person and account) required')
   }
 
-  // Get current state for audit - RLS will filter to accessible pipelines
   const { data: current } = await ctx.db
     .from('pipelines')
     .select('*')
@@ -341,23 +307,21 @@ export const toggle = createHandler(async (ctx, body) => {
 
   return data
 })
-// ─── CHUNK_END: PIPELINES_TOGGLE ────────────────────────────────────────────────
-
-// ─── CHUNK_START: PIPELINES_GET_EXECUTIONS ──────────────────────────────────────────────
-/**
- * @chunk-id    PIPELINES_GET_EXECUTIONS_1_0_0
- * @version     1.0.0
- * @hash        92b0d0a8f3c7ab12144950a0e1dd614a0d92fb6f5e3451542e396018bd5f783d
- * @macro       Pipeline Executions History Handler
- * @micro       Returns paginated execution history for a pipeline
- * @inputs      ctx: CoreContext — Request context with principal and database
- * @inputs      _body: any — Request body (unused for GET)
- * @outputs     Array of pipeline_executions rows ordered newest-first
- * @depends-on  [createHandler]
- * @depended-by [Netlify function routing]
- * @side-effects [DB query with pagination]
- * @tags        pipelines, executions, history, pagination
- */
+// 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="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 export const getExecutions = createHandler(async (ctx, _body) => {
   const { pipeline_id, limit = 50, offset = 0 } = ctx.query || {}
 
@@ -379,23 +343,21 @@ export const getExecutions = createHandler(async (ctx, _body) => {
 
   return data
 })
-// ─── CHUNK_END: PIPELINES_GET_EXECUTIONS ────────────────────────────────────────────────
-
-// ─── CHUNK_START: PIPELINES_REMOVE ──────────────────────────────────────────────
-/**
- * @chunk-id    PIPELINES_REMOVE_1_0_0
- * @version     1.0.0
- * @hash        8d87b1d6e7613f6fbaa77eb100c72359456f4bc38d8c435ac412d414d71e21be
- * @macro       Pipeline Remove Handler
- * @micro       Hard-deletes pipeline with audit logging
- * @inputs      ctx: CoreContext — Request context with principal and database
- * @inputs      _body: any — Request body (unused for DELETE)
- * @outputs     {success: true} — Confirmation of successful deletion
- * @depends-on  [createHandler, emitLog]
- * @depended-by [Netlify function routing]
- * @side-effects [DB delete, audit logging]
- * @tags        pipelines, remove, delete, audit
- */
+// 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="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 export const remove = createHandler(async (ctx, _body) => {
   const id = ctx.query?.id
 
@@ -425,25 +387,21 @@ export const remove = createHandler(async (ctx, _body) => {
 
   return { success: true }
 })
-// ─── CHUNK_END: PIPELINES_REMOVE ────────────────────────────────────────────────
-
-// ─── MAIN HANDLER ────────────────────────────────────────────────────────────
-
-// ─── CHUNK_START: PIPELINES_HANDLER ──────────────────────────────────────────────
-/**
- * @chunk-id    PIPELINES_HANDLER_1_0_0
- * @version     1.0.0
- * @hash        6a2509eb1d183c23578cea419e1d53b579876dc8f8778a9b5577427365da7a68
- * @macro       Pipelines Router
- * @micro       Routes HTTP methods and actions to appropriate pipeline handlers
- * @inputs      ctx: CoreContext — Request context with principal and database
- * @inputs      body: any — Request body for POST/PATCH operations
- * @outputs     Varies — Depends on routed handler (listByTrigger/getExecutions/toggle/list/get/create/update/remove)
- * @depends-on  [createHandler, listByTrigger, getExecutions, toggle, list, get, create, update, remove]
- * @depended-by [Netlify function routing]
- * @side-effects [Delegates to appropriate handler]
- * @tags        pipelines, router, crud, netlify-function
- */
+// 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="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 || {}
   const method = ctx.query?.method || 'GET'
@@ -482,4 +440,4 @@ export const handler = createHandler(async (ctx, body) => {
 
   throw new Error('Invalid action or method')
 })
-// ─── CHUNK_END: PIPELINES_HANDLER ────────────────────────────────────────────────
+// CIL[END chunk_id="pipelines_handler_1783932909"]