spine-framework 0.3.124 → 0.3.126

package/.framework/functions/pipeline-executions.ts

@@ -1,80 +1,43 @@
-/**
- * @module pipeline-executions
- * @audience core-contributor
- * @layer api-handler
- * @stability stable
- *
- * Lifecycle management API for the `pipeline_executions` table. Records
- * track individual pipeline runs: status progression (pending → running →
- * completed/failed/cancelled), timing, trigger data, and result payloads.
- *
- * **Routed by:** `GET/POST/PATCH /.netlify/functions/pipeline-executions`
- *
- * **Actions:**
- * | method | ?action  | handler    |
- * |--------|----------|------------|
- * | GET    | list     | list       |
- * | GET    | running  | getRunning |
- * | GET    | stats    | getStats   |
- * | POST   | cleanup  | cleanup    |
- * | GET    | ?id      | get        |
- * | GET    | (default)| list       |
- * | POST   | —        | create     |
- * | PATCH  | start    | start      |
- * | PATCH  | complete | complete   |
- * | PATCH  | cancel   | cancel     |
- *
- * **Status FSM:** pending → running → completed | failed | cancelled
- *
- * **Authorization:** All operations use `ctx.db` (RLS-scoped to account).
- * Account context required.
- *
- * **Column reference:**
- * `id`, `pipeline_id`, `status`, `trigger_data`, `result`, `error_message`,
- * `started_at`, `completed_at`, `duration_ms`, `created_by`, `account_id`, `created_at`
- *
- * @seeAlso pipelines.ts (pipeline_id FK source)
- * @seeAlso pipeline-runner.ts (runPipeline — calls create/start/complete)
- * @seeAlso audit.ts (emitLog for pipeline_execution.* events)
- */
-
 import { createHandler, json, error, parseBody } from './_shared/middleware'
 import { emitLog } from './_shared/audit'
+import { adminDb } from './_shared/db'
+import { isSystemAdmin } from './_shared/principal'
+
+
+
+
+
+
+
+
+
 
-const SELECT_WITH_JOINS = `
-  *,
-  pipeline:pipelines(id, name, trigger_type),
-  triggered_by_person:people!pipeline_executions_created_by_fkey(id, full_name, email)
-`
-
-// ─── HANDLERS ─────────────────────────────────────────────────────────────────
-
-// ─── CHUNK_START: PIPELINE_EXECUTIONS_LIST ──────────────────────────────────────────────
-/**
- * @chunk-id    PIPELINE_EXECUTIONS_LIST_1_0_0
- * @version     1.0.0
- * @hash        499006790777b78f0eb610474f6869e94869b5b244d1ecedbb0e216cf68bae70
- * @macro       Pipeline Executions List Handler
- * @micro       Lists pipeline executions with filtering and joins
- * @inputs      ctx: CoreContext — Request context with principal and database
- * @inputs      body: any — Request body (unused for GET)
- * @outputs     Array of execution records with pipeline and person joins
- * @depends-on  [createHandler, SELECT_WITH_JOINS]
- * @depended-by [Netlify function routing]
- * @side-effects [DB queries with joins]
- * @tags        pipeline-executions, list, crud, pagination
- */
+// CIL[BEGIN chunk_id="pipeline-executions_module_header_1783932909" type="module_header" identity="module_header" parent="none"]
+// CIL[DOC-MACRO purpose="Lists pipeline executions with filtering and joins"]
+// CIL[DOC-RESPONSIBILITY responsibility="Handle execution listing with filters"]
+// CIL[DOC-CONTEXT module="pipeline-executions" layer="api-handler" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/src/pages/admin/RolesPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/src/components/ui/dialog.tsx\",\".framework/functions/_shared/principal.ts\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="ctx, body" outputs="Array of execution records" errors="Throws on DB errors" side_effects="Database queries"]
+// CIL[DOC-MICRO logic_summary="Filters executions, applies pagination, returns records" 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: custom/apps/portal/pages/ContentPage.tsx, .framework/src/pages/admin/RolesPage.tsx, custom/apps/cortex/pages/operations/OperationsDashboard.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 list = createHandler(async (ctx, body) => {
   const { pipeline_id, status, limit = 100, offset = 0 } = ctx.query || {}
+  const db = isSystemAdmin(ctx.principal) ? adminDb : ctx.db
 
-  if (!ctx.accountId) {
+  if (!isSystemAdmin(ctx.principal) && !ctx.accountId) {
     throw new Error('Account context required')
   }
 
-  let query = ctx.db
+  let query = db
     .from('pipeline_executions')
-    .select(SELECT_WITH_JOINS)
-    .eq('account_id', ctx.accountId)
+    .select('*')
     .order('created_at', { ascending: false })
 
   if (pipeline_id) query = query.eq('pipeline_id', pipeline_id)
@@ -87,25 +50,23 @@ export const list = createHandler(async (ctx, body) => {
 
   if (err) throw err
 
-  return data
+  return data || []
 })
-// ─── CHUNK_END: PIPELINE_EXECUTIONS_LIST ────────────────────────────────────────────────
-
-// ─── CHUNK_START: PIPELINE_EXECUTIONS_GET ──────────────────────────────────────────────
-/**
- * @chunk-id    PIPELINE_EXECUTIONS_GET_1_0_0
- * @version     1.0.0
- * @hash        b148fbec727984f7623d1fa94ae20dd0550056d5c886b0994651f119dbc68521
- * @macro       Pipeline Execution Get Handler
- * @micro       Returns single pipeline execution record with joins
- * @inputs      ctx: CoreContext — Request context with principal and database
- * @inputs      body: any — Request body (unused for GET)
- * @outputs     Execution record with pipeline and person joins
- * @depends-on  [createHandler, SELECT_WITH_JOINS]
- * @depended-by [Netlify function routing]
- * @side-effects [DB single row query with joins]
- * @tags        pipeline-executions, get, crud, single-record
- */
+// CIL[END chunk_id="pipeline-executions_module_header_1783932909"]
+// CIL[BEGIN chunk_id="pipeline-executions_get_1783932909" type="function" identity="get" parent="none"]
+// CIL[DOC-MACRO purpose="Retrieves single pipeline execution by ID with joins"]
+// CIL[DOC-RESPONSIBILITY responsibility="Handle individual execution retrieval"]
+// CIL[DOC-CONTEXT module="pipeline-executions" layer="api-handler" related_files="[\".framework/functions/_shared/schema-utils.ts\",\".framework/src/components/layout/Sidebar.tsx\",\".framework/migrations/025_retype_threads_messages.sql\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="Single execution record" errors="Throws if ID missing or DB error" side_effects="Database query"]
+// CIL[DOC-MICRO logic_summary="Fetches execution by ID with related data" 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/functions/_shared/schema-utils.ts, .framework/src/components/layout/Sidebar.tsx, .framework/migrations/025_retype_threads_messages.sql, .framework/src/pages/admin/TypeDetailPage.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 get = createHandler(async (ctx, body) => {
   const { id } = ctx.query || {}
 
@@ -113,9 +74,11 @@ export const get = createHandler(async (ctx, body) => {
     throw new Error('Execution 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('pipeline_executions')
-    .select(SELECT_WITH_JOINS)
+    .select('*')
     .eq('id', id)
     .single()
 
@@ -123,23 +86,21 @@ export const get = createHandler(async (ctx, body) => {
 
   return data
 })
-// ─── CHUNK_END: PIPELINE_EXECUTIONS_GET ────────────────────────────────────────────────
-
-// ─── CHUNK_START: PIPELINE_EXECUTIONS_CREATE ──────────────────────────────────────────────
-/**
- * @chunk-id    PIPELINE_EXECUTIONS_CREATE_1_0_0
- * @version     1.0.0
- * @hash        fb1d51a8ca0e30e0d151147edde5516c01a51f2cfcad64105ff07937aa430924
- * @macro       Pipeline Execution Create Handler
- * @micro       Creates execution record in pending status with audit logging
- * @inputs      ctx: CoreContext — Request context with principal and database
- * @inputs      body: object — pipeline_id and optional trigger_data
- * @outputs     {execution_id: string} — ID of created execution
- * @depends-on  [createHandler, emitLog]
- * @depended-by [Netlify function routing, pipeline-runner.ts]
- * @side-effects [DB insert, audit logging]
- * @tags        pipeline-executions, create, crud, audit
- */
+// CIL[END chunk_id="pipeline-executions_get_1783932909"]
+// CIL[BEGIN chunk_id="pipeline-executions_create_1783932909" type="function" identity="create" parent="none"]
+// CIL[DOC-MACRO purpose="Creates pipeline execution record in pending status"]
+// CIL[DOC-RESPONSIBILITY responsibility="Handle execution creation with audit logging"]
+// CIL[DOC-CONTEXT module="pipeline-executions" layer="api-handler" related_files="[\".framework/src/pages/admin/RolesPage.tsx\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/src/pages/admin/IntegrationsPage.tsx\",\"custom/apps/cortex/functions/custom_cil-embeddings.ts\",\".framework/functions/_shared/principal.ts\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="{execution_id: string}" errors="Throws on validation or DB errors" side_effects="Database insert, audit logging"]
+// CIL[DOC-MICRO logic_summary="Creates execution record, logs audit event" 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/RolesPage.tsx, .framework/src/pages/admin/TypeDetailPage.tsx, .framework/src/pages/admin/IntegrationsPage.tsx, custom/apps/cortex/functions/custom_cil-embeddings.ts, .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 create = createHandler(async (ctx, body) => {
   const { pipeline_id, trigger_data } = body
 
@@ -172,23 +133,21 @@ export const create = createHandler(async (ctx, body) => {
 
   return { execution_id: data?.id }
 })
-// ─── CHUNK_END: PIPELINE_EXECUTIONS_CREATE ────────────────────────────────────────────────
-
-// ─── CHUNK_START: PIPELINE_EXECUTIONS_START ──────────────────────────────────────────────
-/**
- * @chunk-id    PIPELINE_EXECUTIONS_START_1_0_0
- * @version     1.0.0
- * @hash        25eeada82be4fff26606dc6e784b6e0accaaebaee08514577368cdd146f39aaf
- * @macro       Pipeline Execution Start Handler
- * @micro       Transitions execution from pending to running with timestamp
- * @inputs      ctx: CoreContext — Request context with principal and database
- * @inputs      body: object — execution id to start
- * @outputs     {success: true} — Confirmation of successful start
- * @depends-on  [createHandler, emitLog]
- * @depended-by [Netlify function routing, pipeline-runner.ts]
- * @side-effects [DB update, audit logging]
- * @tags        pipeline-executions, start, state-transition, audit
- */
+// CIL[END chunk_id="pipeline-executions_create_1783932909"]
+// CIL[BEGIN chunk_id="pipeline-executions_start_1783932909" type="function" identity="start" parent="none"]
+// CIL[DOC-MACRO purpose="Transitions execution from pending to running"]
+// CIL[DOC-RESPONSIBILITY responsibility="Handle execution start with timestamp"]
+// CIL[DOC-CONTEXT module="pipeline-executions" layer="api-handler" related_files="[\"custom/apps/cortex/functions/custom_cil-embeddings.ts\",\"custom/apps/portal/pages/ContentPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/src/pages/admin/RolesPage.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="{success: true}" errors="Throws on validation or DB errors" side_effects="Database update, audit logging"]
+// CIL[DOC-MICRO logic_summary="Updates status to running, sets start timestamp" 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: custom/apps/cortex/functions/custom_cil-embeddings.ts, custom/apps/portal/pages/ContentPage.tsx, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .framework/src/pages/admin/RolesPage.tsx, \."]
+// 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 start = createHandler(async (ctx, body) => {
   const { id } = body
 
@@ -212,23 +171,21 @@ export const start = createHandler(async (ctx, body) => {
 
   return { success: true }
 })
-// ─── CHUNK_END: PIPELINE_EXECUTIONS_START ────────────────────────────────────────────────
-
-// ─── CHUNK_START: PIPELINE_EXECUTIONS_COMPLETE ──────────────────────────────────────────────
-/**
- * @chunk-id    PIPELINE_EXECUTIONS_COMPLETE_1_0_0
- * @version     1.0.0
- * @hash        088db36524718ec6d8d85e1051aa5d1c4fc31fb796f284bc1526c195d4686dff
- * @macro       Pipeline Execution Complete Handler
- * @micro       Transitions execution to completed/failed with duration calculation
- * @inputs      ctx: CoreContext — Request context with principal and database
- * @inputs      body: object — id, output_data, and optional error_message
- * @outputs     {success: true} — Confirmation of successful completion
- * @depends-on  [createHandler, emitLog]
- * @depended-by [Netlify function routing, pipeline-runner.ts]
- * @side-effects [DB read for started_at, DB update, audit logging]
- * @tags        pipeline-executions, complete, state-transition, audit
- */
+// CIL[END chunk_id="pipeline-executions_start_1783932909"]
+// CIL[BEGIN chunk_id="pipeline-executions_complete_1783932909" type="function" identity="complete" parent="none"]
+// CIL[DOC-MACRO purpose="Transitions execution to completed/failed with duration"]
+// CIL[DOC-RESPONSIBILITY responsibility="Handle execution completion with metrics"]
+// CIL[DOC-CONTEXT module="pipeline-executions" layer="api-handler" related_files="[\"custom/apps/cortex/functions/custom_cil-embeddings.ts\",\"custom/apps/portal/pages/ContentPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/functions/_shared/schema-utils.ts\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="{success: true}" errors="Throws on validation or DB errors" side_effects="Database update, audit logging"]
+// CIL[DOC-MICRO logic_summary="Calculates duration, updates status, logs completion" 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: custom/apps/cortex/functions/custom_cil-embeddings.ts, custom/apps/portal/pages/ContentPage.tsx, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .framework/functions/_shared/schema-utils.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 complete = createHandler(async (ctx, body) => {
   const { id, output_data, error_message } = body
 
@@ -239,7 +196,6 @@ export const complete = createHandler(async (ctx, body) => {
   const now = new Date().toISOString()
   const finalStatus = error_message ? 'failed' : 'completed'
 
-  // Fetch started_at to compute duration
   const { data: existing } = await ctx.db
     .from('pipeline_executions')
     .select('started_at')
@@ -272,23 +228,21 @@ export const complete = createHandler(async (ctx, body) => {
 
   return { success: true }
 })
-// ─── CHUNK_END: PIPELINE_EXECUTIONS_COMPLETE ────────────────────────────────────────────────
-
-// ─── CHUNK_START: PIPELINE_EXECUTIONS_CANCEL ──────────────────────────────────────────────
-/**
- * @chunk-id    PIPELINE_EXECUTIONS_CANCEL_1_0_0
- * @version     1.0.0
- * @hash        f45e336099afeb28cb3db099fa428d8637e07876dcabf7ec85de844c25b43d97
- * @macro       Pipeline Execution Cancel Handler
- * @micro       Cancels execution by setting status to cancelled with timestamp
- * @inputs      ctx: CoreContext — Request context with principal and database
- * @inputs      body: object — execution id to cancel
- * @outputs     {success: true} — Confirmation of successful cancellation
- * @depends-on  [createHandler, emitLog]
- * @depended-by [Netlify function routing]
- * @side-effects [DB update, audit logging]
- * @tags        pipeline-executions, cancel, state-transition, audit
- */
+// CIL[END chunk_id="pipeline-executions_complete_1783932909"]
+// CIL[BEGIN chunk_id="pipeline-executions_cancel_1783932909" type="function" identity="cancel" parent="none"]
+// CIL[DOC-MACRO purpose="Cancels execution by setting status to cancelled"]
+// CIL[DOC-RESPONSIBILITY responsibility="Handle execution cancellation with audit"]
+// CIL[DOC-CONTEXT module="pipeline-executions" layer="api-handler" related_files="[]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="{success: true}" errors="Throws on validation or DB errors" side_effects="Database update, audit logging"]
+// CIL[DOC-MICRO logic_summary="Sets status to cancelled, logs audit event" 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 cancel = createHandler(async (ctx, body) => {
   const { id } = body
 
@@ -312,34 +266,32 @@ export const cancel = createHandler(async (ctx, body) => {
 
   return { success: true }
 })
-// ─── CHUNK_END: PIPELINE_EXECUTIONS_CANCEL ────────────────────────────────────────────────
-
-// ─── CHUNK_START: PIPELINE_EXECUTIONS_GET_RUNNING ──────────────────────────────────────────────
-/**
- * @chunk-id    PIPELINE_EXECUTIONS_GET_RUNNING_1_0_0
- * @version     1.0.0
- * @hash        d43691d1d9063a7421eae3b32ede4bb603efa7b2faf635861f66178fde5641b6
- * @macro       Running Pipeline Executions Handler
- * @micro       Returns currently running executions with optional pipeline filter
- * @inputs      ctx: CoreContext — Request context with principal and database
- * @inputs      body: any — Request body (unused for GET)
- * @outputs     Array of running execution records with joins
- * @depends-on  [createHandler, SELECT_WITH_JOINS]
- * @depended-by [Netlify function routing]
- * @side-effects [DB query with joins]
- * @tags        pipeline-executions, running, status-filter, monitoring
- */
+// CIL[END chunk_id="pipeline-executions_cancel_1783932909"]
+// CIL[BEGIN chunk_id="pipeline-executions_getrunning_1783932909" type="function" identity="getRunning" parent="none"]
+// CIL[DOC-MACRO purpose="Returns currently running executions with filtering"]
+// CIL[DOC-RESPONSIBILITY responsibility="Handle running execution monitoring"]
+// CIL[DOC-CONTEXT module="pipeline-executions" layer="api-handler" related_files="[\".framework/functions/_shared/schema-utils.ts\",\".framework/src/components/ui/dialog.tsx\",\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/functions/_shared/principal.ts\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="Array of running executions" errors="Throws on DB errors" side_effects="Database query"]
+// CIL[DOC-MICRO logic_summary="Filters for running status, returns with joins" 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/components/ui/dialog.tsx, custom/apps/portal/pages/ContentPage.tsx, .framework/functions/_shared/principal.ts, .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"]
 export const getRunning = createHandler(async (ctx, body) => {
   const { pipeline_id } = ctx.query || {}
+  const db = isSystemAdmin(ctx.principal) ? adminDb : ctx.db
 
-  if (!ctx.accountId) {
+  if (!isSystemAdmin(ctx.principal) && !ctx.accountId) {
     throw new Error('Account context required')
   }
 
-  let query = ctx.db
+  let query = db
     .from('pipeline_executions')
-    .select(SELECT_WITH_JOINS)
-    .eq('account_id', ctx.accountId)
+    .select('*')
     .eq('status', 'running')
     .order('started_at', { ascending: false })
 
@@ -349,36 +301,34 @@ export const getRunning = createHandler(async (ctx, body) => {
 
   if (err) throw err
 
-  return data
+  return data || []
 })
-// ─── CHUNK_END: PIPELINE_EXECUTIONS_GET_RUNNING ────────────────────────────────────────────────
-
-// ─── CHUNK_START: PIPELINE_EXECUTIONS_GET_STATS ──────────────────────────────────────────────
-/**
- * @chunk-id    PIPELINE_EXECUTIONS_GET_STATS_1_0_0
- * @version     1.0.0
- * @hash        f80bc6b6b830d1bafcd7d02ecac50c78cab10ceef7441dc477b3193a7b29143e
- * @macro       Pipeline Executions Statistics Handler
- * @micro       Returns execution counts by status with filtering options
- * @inputs      ctx: CoreContext — Request context with principal and database
- * @inputs      body: any — Request body (unused for GET)
- * @outputs     {total, completed, failed, running} — Status count statistics
- * @depends-on  [createHandler]
- * @depended-by [Netlify function routing]
- * @side-effects [DB count query, aggregation]
- * @tags        pipeline-executions, stats, analytics, monitoring
- */
+// CIL[END chunk_id="pipeline-executions_getrunning_1783932909"]
+// CIL[BEGIN chunk_id="pipeline-executions_getstats_1783932909" type="function" identity="getStats" parent="none"]
+// CIL[DOC-MACRO purpose="Returns execution statistics by status with filtering"]
+// CIL[DOC-RESPONSIBILITY responsibility="Handle execution analytics and monitoring"]
+// CIL[DOC-CONTEXT module="pipeline-executions" layer="api-handler" related_files="[\".framework/src/pages/admin/RolesPage.tsx\",\".framework/functions/_shared/schema-utils.ts\",\".framework/src/pages/admin/IntegrationsPage.tsx\",\"custom/apps/cortex/functions/custom_cil-embeddings.ts\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="Status count statistics" errors="Throws on DB errors" side_effects="Database aggregation"]
+// CIL[DOC-MICRO logic_summary="Counts executions by status with date filtering" 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/functions/_shared/schema-utils.ts, .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 getStats = createHandler(async (ctx, body) => {
   const { pipeline_id, date_from, date_to } = ctx.query || {}
+  const db = isSystemAdmin(ctx.principal) ? adminDb : ctx.db
 
-  if (!ctx.accountId) {
+  if (!isSystemAdmin(ctx.principal) && !ctx.accountId) {
     throw new Error('Account context required')
   }
 
-  let query = ctx.db
+  let query = db
     .from('pipeline_executions')
     .select('id, status')
-    .eq('account_id', ctx.accountId)
 
   if (pipeline_id) query = query.eq('pipeline_id', pipeline_id)
   if (date_from) query = query.gte('created_at', date_from)
@@ -396,23 +346,21 @@ export const getStats = createHandler(async (ctx, body) => {
     running: rows.filter((r: any) => r.status === 'running').length,
   }
 })
-// ─── CHUNK_END: PIPELINE_EXECUTIONS_GET_STATS ────────────────────────────────────────────────
-
-// ─── CHUNK_START: PIPELINE_EXECUTIONS_CLEANUP ──────────────────────────────────────────────
-/**
- * @chunk-id    PIPELINE_EXECUTIONS_CLEANUP_1_0_0
- * @version     1.0.0
- * @hash        713c36d875b9e210b16504c324491c66485681a47265ab8cd228c66be58386d4
- * @macro       Pipeline Executions Cleanup Handler
- * @micro       Deletes old execution records beyond retention period
- * @inputs      ctx: CoreContext — Request context with principal and database
- * @inputs      body: object — days_to_keep (default 30) and optional status_filter
- * @outputs     {deleted_count: number} — Number of deleted execution records
- * @depends-on  [createHandler, emitLog]
- * @depended-by [Netlify function routing]
- * @side-effects [DB delete by date, audit logging]
- * @tags        pipeline-executions, cleanup, retention, maintenance
- */
+// CIL[END chunk_id="pipeline-executions_getstats_1783932909"]
+// CIL[BEGIN chunk_id="pipeline-executions_cleanup_1783932909" type="function" identity="cleanup" parent="none"]
+// CIL[DOC-MACRO purpose="Deletes old execution records beyond retention period"]
+// CIL[DOC-RESPONSIBILITY responsibility="Handle execution data retention management"]
+// CIL[DOC-CONTEXT module="pipeline-executions" layer="api-handler" related_files="[]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="{deleted_count: number}" errors="Throws on DB errors" side_effects="Database delete, audit logging"]
+// CIL[DOC-MICRO logic_summary="Deletes records older than retention period" 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 cleanup = createHandler(async (ctx, body) => {
   const { days_to_keep = 30, status_filter } = body
 
@@ -437,25 +385,21 @@ export const cleanup = createHandler(async (ctx, body) => {
 
   return { deleted_count: (data || []).length }
 })
-// ─── CHUNK_END: PIPELINE_EXECUTIONS_CLEANUP ────────────────────────────────────────────────
-
-// ─── MAIN HANDLER ────────────────────────────────────────────────────────────
-
-// ─── CHUNK_START: PIPELINE_EXECUTIONS_HANDLER ──────────────────────────────────────────────
-/**
- * @chunk-id    PIPELINE_EXECUTIONS_HANDLER_1_0_0
- * @version     1.0.0
- * @hash        d1ff32ebff977774775afb91952838530a5d628211a7ab7ac5c74aca2e7c77d2
- * @macro       Pipeline Executions Router
- * @micro       Routes HTTP methods and actions to appropriate pipeline execution 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 (list/get/create/start/complete/cancel/getRunning/getStats/cleanup)
- * @depends-on  [createHandler, list, get, create, start, complete, cancel, getRunning, getStats, cleanup]
- * @depended-by [Netlify function routing, pipeline-runner.ts]
- * @side-effects [Delegates to appropriate handler]
- * @tags        pipeline-executions, router, crud, netlify-function
- */
+// CIL[END chunk_id="pipeline-executions_cleanup_1783932909"]
+// CIL[BEGIN chunk_id="pipeline-executions_handler_1783932909" type="function" identity="handler" parent="none"]
+// CIL[DOC-MACRO purpose="Routes HTTP methods and actions to execution handlers"]
+// CIL[DOC-RESPONSIBILITY responsibility="Handle request routing for execution operations"]
+// CIL[DOC-CONTEXT module="pipeline-executions" 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'
@@ -491,4 +435,4 @@ export const handler = createHandler(async (ctx, body) => {
 
   throw new Error('Invalid action or method')
 })
-// ─── CHUNK_END: PIPELINE_EXECUTIONS_HANDLER ────────────────────────────────────────────────
+// CIL[END chunk_id="pipeline-executions_handler_1783932909"]