spine-framework 0.3.145 → 0.4.0

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

@@ -1,7 +1,23 @@
+// CIL[BEGIN stable_id="~/.framework/functions/pipeline-executions.ts:module_header:module_header" type="module_header" identity="module_header" parent="~/.framework/functions/pipeline-executions.ts"]
+// CIL[DOC-MACRO purpose="Import shared helpers and expose the pipeline-executions handler"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide the module imports and top-level exported handler for pipeline execution operations"]
+// CIL[DOC-CONTEXT module="pipeline-executions" layer="functions" related_files=".framework/functions/_shared/audit.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/middleware.ts,.framework/functions/_shared/principal.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Imports middleware, audit, database, and principal helpers used by the pipeline execution handlers" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-AUDIENCE audience="framework developers"]
 import { createHandler, json, error, parseBody } from './_shared/middleware'
 import { emitLog } from './_shared/audit'
 import { adminDb } from './_shared/db'
 import { isSystemAdmin } from './_shared/principal'
+// CIL[DOC-VECTOR type="context" content="purpose='Import shared helpers and expose the pipeline-executions handler'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/audit.ts,.framework/functions/_shared/db.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/pipeline-executions.ts:module_header:module_header"]
 
 
 
@@ -12,21 +28,14 @@ import { isSystemAdmin } from './_shared/principal'
 
 
 
-// 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[BEGIN stable_id="~/.framework/functions/pipeline-executions.ts:list:constant" type="constant" identity="list" parent="~/.framework/functions/pipeline-executions.ts"]
+// CIL[DOC-MACRO purpose="List pipeline executions with optional filters and pagination"]
+// CIL[DOC-RESPONSIBILITY responsibility="Return a paginated list of pipeline executions, optionally filtered by pipeline_id and status"]
+// CIL[DOC-CONTEXT module="pipeline-executions" layer="functions" related_files=".framework/functions/_shared/audit.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/middleware.ts,.framework/functions/_shared/principal.ts,.framework/functions/pipeline-executions.ts"]
+// CIL[DOC-CONTRACT inputs="ctx.query with optional pipeline_id, status, limit, offset" outputs="Array of pipeline execution records" errors="Account context required for non-admins; database query errors" side_effects="None"]
+// CIL[DOC-MICRO logic_summary="Choose admin or account DB, build a base query, apply optional equality filters, set a range for pagination, and return data or an empty array" notable_decisions="[]"]
+// 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: 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
@@ -52,21 +61,21 @@ export const list = createHandler(async (ctx, body) => {
 
   return data || []
 })
-// 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="context" content="purpose='List pipeline executions with optional filters and pagination'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/audit.ts,.framework/functions/_shared/db.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/pipeline-executions.ts:list:constant"]
+// CIL[BEGIN stable_id="~/.framework/functions/pipeline-executions.ts:get:constant" type="constant" identity="get" parent="~/.framework/functions/pipeline-executions.ts"]
+// CIL[DOC-MACRO purpose="Retrieve a single pipeline execution by ID"]
+// CIL[DOC-RESPONSIBILITY responsibility="Return the pipeline execution record matching the provided id"]
+// CIL[DOC-CONTEXT module="pipeline-executions" layer="functions" related_files=".framework/functions/_shared/audit.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/middleware.ts,.framework/functions/_shared/principal.ts,.framework/functions/pipeline-executions.ts"]
+// CIL[DOC-CONTRACT inputs="ctx.query.id" outputs="Single pipeline execution record" errors="Missing execution ID; database query errors" side_effects="None"]
+// CIL[DOC-MICRO logic_summary="Validate the id, query the database for a single row, throw on error, and return the record" notable_decisions="[]"]
+// 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 || {}
 
@@ -86,21 +95,21 @@ export const get = createHandler(async (ctx, body) => {
 
   return data
 })
-// 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="context" content="purpose='Retrieve a single pipeline execution by ID'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/audit.ts,.framework/functions/_shared/db.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/pipeline-executions.ts:get:constant"]
+// CIL[BEGIN stable_id="~/.framework/functions/pipeline-executions.ts:create:constant" type="constant" identity="create" parent="~/.framework/functions/pipeline-executions.ts"]
+// CIL[DOC-MACRO purpose="Create a new pending pipeline execution"]
+// CIL[DOC-RESPONSIBILITY responsibility="Insert a pipeline execution record and emit an audit log"]
+// CIL[DOC-CONTEXT module="pipeline-executions" layer="functions" related_files=".framework/functions/_shared/audit.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/middleware.ts,.framework/functions/_shared/principal.ts,.framework/functions/pipeline-executions.ts"]
+// CIL[DOC-CONTRACT inputs="body with pipeline_id and optional trigger_data" outputs="{ execution_id }" errors="Missing pipeline ID; account context required; database insert errors" side_effects="Inserts a row into pipeline_executions; emits a pipeline_execution.created audit log"]
+// CIL[DOC-MICRO logic_summary="Validate inputs and account context, insert a pending record with creator and account, select the id, emit an audit log, and return the execution_id" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export const create = createHandler(async (ctx, body) => {
   const { pipeline_id, trigger_data } = body
 
@@ -133,21 +142,21 @@ export const create = createHandler(async (ctx, body) => {
 
   return { execution_id: data?.id }
 })
-// 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="context" content="purpose='Create a new pending pipeline execution'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/audit.ts,.framework/functions/_shared/db.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/pipeline-executions.ts:create:constant"]
+// CIL[BEGIN stable_id="~/.framework/functions/pipeline-executions.ts:start:constant" type="constant" identity="start" parent="~/.framework/functions/pipeline-executions.ts"]
+// CIL[DOC-MACRO purpose="Mark a pipeline execution as running"]
+// CIL[DOC-RESPONSIBILITY responsibility="Update the execution status to running and record its start time"]
+// CIL[DOC-CONTEXT module="pipeline-executions" layer="functions" related_files=".framework/functions/_shared/audit.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/middleware.ts,.framework/functions/_shared/principal.ts,.framework/functions/pipeline-executions.ts"]
+// CIL[DOC-CONTRACT inputs="body.id" outputs="{ success: true }" errors="Missing execution ID; database update errors" side_effects="Updates status and started_at; emits a pipeline_execution.started audit log"]
+// CIL[DOC-MICRO logic_summary="Validate the id, update the row to running status with the current ISO timestamp, emit an audit log, and return success" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export const start = createHandler(async (ctx, body) => {
   const { id } = body
 
@@ -171,21 +180,21 @@ export const start = createHandler(async (ctx, body) => {
 
   return { success: true }
 })
-// 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="context" content="purpose='Mark a pipeline execution as running'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/audit.ts,.framework/functions/_shared/db.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/pipeline-executions.ts:start:constant"]
+// CIL[BEGIN stable_id="~/.framework/functions/pipeline-executions.ts:complete:constant" type="constant" identity="complete" parent="~/.framework/functions/pipeline-executions.ts"]
+// CIL[DOC-MACRO purpose="Complete or fail a pipeline execution"]
+// CIL[DOC-RESPONSIBILITY responsibility="Finalize the execution status, store the result or error, and record the duration"]
+// CIL[DOC-CONTEXT module="pipeline-executions" layer="functions" related_files=".framework/functions/_shared/audit.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/middleware.ts,.framework/functions/_shared/principal.ts,.framework/functions/pipeline-executions.ts"]
+// CIL[DOC-CONTRACT inputs="body with id, optional output_data, optional error_message" outputs="{ success: true }" errors="Missing execution ID; database update errors" side_effects="Updates status, result, error_message, completed_at, and duration_ms; emits a pipeline_execution.completed audit log"]
+// CIL[DOC-MICRO logic_summary="Validate the id, determine final status from error_message, compute duration from started_at, update the row, emit an audit log, and return success" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export const complete = createHandler(async (ctx, body) => {
   const { id, output_data, error_message } = body
 
@@ -228,21 +237,21 @@ export const complete = createHandler(async (ctx, body) => {
 
   return { success: true }
 })
-// 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="context" content="purpose='Complete or fail a pipeline execution'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/audit.ts,.framework/functions/_shared/db.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/pipeline-executions.ts:complete:constant"]
+// CIL[BEGIN stable_id="~/.framework/functions/pipeline-executions.ts:cancel:constant" type="constant" identity="cancel" parent="~/.framework/functions/pipeline-executions.ts"]
+// CIL[DOC-MACRO purpose="Cancel a pipeline execution"]
+// CIL[DOC-RESPONSIBILITY responsibility="Mark an execution as cancelled and record the completion time"]
+// CIL[DOC-CONTEXT module="pipeline-executions" layer="functions" related_files=".framework/functions/_shared/audit.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/middleware.ts,.framework/functions/_shared/principal.ts,.framework/functions/pipeline-executions.ts"]
+// CIL[DOC-CONTRACT inputs="body.id" outputs="{ success: true }" errors="Missing execution ID; database update errors" side_effects="Updates status to cancelled and completed_at; emits a pipeline_execution.cancelled audit log"]
+// CIL[DOC-MICRO logic_summary="Validate the id, update the row with cancelled status and current timestamp, emit an audit log, and return success" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export const cancel = createHandler(async (ctx, body) => {
   const { id } = body
 
@@ -266,21 +275,21 @@ export const cancel = createHandler(async (ctx, body) => {
 
   return { success: true }
 })
-// 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="context" content="purpose='Cancel a pipeline execution'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/audit.ts,.framework/functions/_shared/db.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/pipeline-executions.ts:cancel:constant"]
+// CIL[BEGIN stable_id="~/.framework/functions/pipeline-executions.ts:getRunning:constant" type="constant" identity="getRunning" parent="~/.framework/functions/pipeline-executions.ts"]
+// CIL[DOC-MACRO purpose="List currently running pipeline executions"]
+// CIL[DOC-RESPONSIBILITY responsibility="Return running executions, optionally filtered by pipeline_id"]
+// CIL[DOC-CONTEXT module="pipeline-executions" layer="functions" related_files=".framework/functions/_shared/audit.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/middleware.ts,.framework/functions/_shared/principal.ts,.framework/functions/pipeline-executions.ts"]
+// CIL[DOC-CONTRACT inputs="ctx.query with optional pipeline_id" outputs="Array of running execution records" errors="Account context required for non-admins; database query errors" side_effects="None"]
+// CIL[DOC-MICRO logic_summary="Choose admin or account DB, query executions with running status, apply an optional pipeline_id filter, order by started_at, and return data or an empty array" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export const getRunning = createHandler(async (ctx, body) => {
   const { pipeline_id } = ctx.query || {}
   const db = isSystemAdmin(ctx.principal) ? adminDb : ctx.db
@@ -303,21 +312,21 @@ export const getRunning = createHandler(async (ctx, body) => {
 
   return data || []
 })
-// 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="context" content="purpose='List currently running pipeline executions'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/audit.ts,.framework/functions/_shared/db.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/pipeline-executions.ts:getRunning:constant"]
+// CIL[BEGIN stable_id="~/.framework/functions/pipeline-executions.ts:getStats:constant" type="constant" identity="getStats" parent="~/.framework/functions/pipeline-executions.ts"]
+// CIL[DOC-MACRO purpose="Aggregate pipeline execution status counts"]
+// CIL[DOC-RESPONSIBILITY responsibility="Return total, completed, failed, and running execution counts"]
+// CIL[DOC-CONTEXT module="pipeline-executions" layer="functions" related_files=".framework/functions/_shared/audit.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/middleware.ts,.framework/functions/_shared/principal.ts,.framework/functions/pipeline-executions.ts"]
+// CIL[DOC-CONTRACT inputs="ctx.query with optional pipeline_id, date_from, date_to" outputs="{ total, completed, failed, running }" errors="Account context required for non-admins; database query errors" side_effects="None"]
+// CIL[DOC-MICRO logic_summary="Select id and status, apply optional filters, count statuses client-side, and return the totals" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export const getStats = createHandler(async (ctx, body) => {
   const { pipeline_id, date_from, date_to } = ctx.query || {}
   const db = isSystemAdmin(ctx.principal) ? adminDb : ctx.db
@@ -346,21 +355,21 @@ export const getStats = createHandler(async (ctx, body) => {
     running: rows.filter((r: any) => r.status === 'running').length,
   }
 })
-// 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="context" content="purpose='Aggregate pipeline execution status counts'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/audit.ts,.framework/functions/_shared/db.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/pipeline-executions.ts:getStats:constant"]
+// CIL[BEGIN stable_id="~/.framework/functions/pipeline-executions.ts:cleanup:constant" type="constant" identity="cleanup" parent="~/.framework/functions/pipeline-executions.ts"]
+// CIL[DOC-MACRO purpose="Delete old pipeline execution records"]
+// CIL[DOC-RESPONSIBILITY responsibility="Remove executions older than a retention window, optionally filtered by status"]
+// CIL[DOC-CONTEXT module="pipeline-executions" layer="functions" related_files=".framework/functions/_shared/audit.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/middleware.ts,.framework/functions/_shared/principal.ts,.framework/functions/pipeline-executions.ts"]
+// CIL[DOC-CONTRACT inputs="body with days_to_keep and optional status_filter" outputs="{ deleted_count }" errors="Database delete errors" side_effects="Deletes rows from pipeline_executions; emits a pipeline_executions.cleaned audit log"]
+// CIL[DOC-MICRO logic_summary="Compute a cutoff date, delete records older than the cutoff, optionally filter by status, and return the number of deleted records" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export const cleanup = createHandler(async (ctx, body) => {
   const { days_to_keep = 30, status_filter } = body
 
@@ -385,21 +394,21 @@ export const cleanup = createHandler(async (ctx, body) => {
 
   return { deleted_count: (data || []).length }
 })
-// 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="context" content="purpose='Delete old pipeline execution records'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/audit.ts,.framework/functions/_shared/db.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/pipeline-executions.ts:cleanup:constant"]
+// CIL[BEGIN stable_id="~/.framework/functions/pipeline-executions.ts:handler:constant" type="constant" identity="handler" parent="~/.framework/functions/pipeline-executions.ts"]
+// CIL[DOC-MACRO purpose="Route pipeline execution actions based on HTTP method and query"]
+// CIL[DOC-RESPONSIBILITY responsibility="Dispatch list, get, create, start, complete, cancel, running, stats, and cleanup actions"]
+// CIL[DOC-CONTEXT module="pipeline-executions" layer="functions" related_files=".framework/functions/_shared/audit.ts,.framework/functions/_shared/db.ts,.framework/functions/_shared/middleware.ts,.framework/functions/_shared/principal.ts,.framework/functions/pipeline-executions.ts"]
+// CIL[DOC-CONTRACT inputs="ctx.query.action, HTTP method, query id, and request body" outputs="Result of the dispatched action" errors="Invalid action or method" side_effects="May invoke other pipeline execution handlers and their audit logs"]
+// CIL[DOC-MICRO logic_summary="Switch on action and HTTP method, delegate to the appropriate named handler, and throw for unsupported combinations" notable_decisions="[]"]
+// 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'
@@ -435,4 +444,10 @@ export const handler = createHandler(async (ctx, body) => {
 
   throw new Error('Invalid action or method')
 })
-// CIL[END chunk_id="pipeline-executions_handler_1783932909"]
+// CIL[DOC-VECTOR type="context" content="purpose='Route pipeline execution actions based on HTTP method and query'; No verified external callers; imports: .framework/functions/_shared/middleware.ts,.framework/functions/_shared/audit.ts,.framework/functions/_shared/db.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/pipeline-executions.ts:handler:constant"]