spine-framework 0.1.0

package/dist/functions/logs.d.ts

@@ -0,0 +1,162 @@
+/**
+ * @module logs
+ * @audience core-contributor
+ * @layer api-handler
+ * @stability stable
+ *
+ * Read API for the `v2.logs` table plus a write endpoint for external log
+ * ingestion. The `logs` table schema uses internal column names
+ * (`level`, `source`, `source_type`, `source_id`, `context`) that differ from
+ * the stable frontend contract. All reads are mapped through `mapLogRow`.
+ *
+ * **Routed by:** `GET/POST /.netlify/functions/logs`
+ *
+ * **Actions:**
+ * | method | ?action | handler      |
+ * |--------|---------|------------------|
+ * | GET    | account | listAccount  |
+ * | GET    | target  | listTarget   |
+ * | GET    | person  | listPerson   |
+ * | GET    | stats   | getStats     |
+ * | GET    | search  | search       |
+ * | POST   | cleanup | cleanup      |
+ * | POST   | (default)| log         |
+ *
+ * **Authorization:** All operations use `ctx.db` (RLS-scoped, always filtered
+ * to `account_id`). No inserts are made by this module — `emitLog` from
+ * `_shared/audit.ts` is the canonical write path.
+ *
+ * **Column mapping (DB → API):**
+ * | DB column    | API field   |
+ * |--------------|-------------|
+ * | level        | event_type  |
+ * | person_id    | actor_id    |
+ * | source_type  | target_type |
+ * | source_id    | target_id   |
+ * | source       | action      |
+ * | context      | details     |
+ *
+ * @seeAlso audit.ts (emitLog — canonical write path for all system events)
+ * @seeAlso observability.ts (aggregated metrics over logs)
+ */
+/**
+ * @chunk-id    LOGS_LIST_ACCOUNT_1_0_0
+ * @version     1.0.0
+ * @hash        d512e35890e479c88f4e6130567b16b1143a164705fca4e887aee643cc76a1e5
+ * @macro       Account Logs List Handler
+ * @micro       Lists all account log entries with filtering and mapping
+ * @inputs      ctx: CoreContext — Request context with principal and database
+ * @inputs      body: any — Request body (unused for GET)
+ * @outputs     Array of mapped log rows with API field names
+ * @depends-on  [createHandler, mapLogRow]
+ * @depended-by [Netlify function routing]
+ * @side-effects [DB queries, row mapping]
+ * @tags        logs, list, account, pagination
+ */
+export declare const listAccount: (event: any, context: any) => Promise<any>;
+/**
+ * @chunk-id    LOGS_LIST_TARGET_1_0_0
+ * @version     1.0.0
+ * @hash        7ea27876f183b59057284ca9007aed6e0e65050b196f00756b8ad5715073e745
+ * @macro       Target Logs List Handler
+ * @micro       Lists log entries for specific target entity with filtering
+ * @inputs      ctx: CoreContext — Request context with principal and database
+ * @inputs      body: any — Request body (unused for GET)
+ * @outputs     Array of mapped log rows for target entity
+ * @depends-on  [createHandler, mapLogRow]
+ * @depended-by [Netlify function routing]
+ * @side-effects [DB queries, row mapping]
+ * @tags        logs, list, target, entity-specific
+ */
+export declare const listTarget: (event: any, context: any) => Promise<any>;
+/**
+ * @chunk-id    LOGS_LIST_PERSON_1_0_0
+ * @version     1.0.0
+ * @hash        1c502ddeac8766153f1cc9ff6ffc8a7804dd83519d3c2e8b11dcf610fc6d6dfe
+ * @macro       Person Activity Feed Handler
+ * @micro       Returns activity feed for person with system event filtering
+ * @inputs      ctx: CoreContext — Request context with principal and database
+ * @inputs      body: any — Request body (unused for GET)
+ * @outputs     Array of mapped log rows for person activity
+ * @depends-on  [createHandler, mapLogRow]
+ * @depended-by [Netlify function routing]
+ * @side-effects [DB queries, row mapping]
+ * @tags        logs, list, person, activity-feed
+ */
+export declare const listPerson: (event: any, context: any) => Promise<any>;
+/**
+ * @chunk-id    LOGS_GET_STATS_1_0_0
+ * @version     1.0.0
+ * @hash        a25e065d770b9658aa1a7d1db325e044febbac498c06cad735e18167442a2674
+ * @macro       Logs Statistics Handler
+ * @micro       Returns log counts by event type with date range filtering
+ * @inputs      ctx: CoreContext — Request context with principal and database
+ * @inputs      body: any — Request body (unused for GET)
+ * @outputs     {total: number, by_type: Record<string, number>} — Log statistics
+ * @depends-on  [createHandler]
+ * @depended-by [Netlify function routing]
+ * @side-effects [DB count query, aggregation]
+ * @tags        logs, stats, analytics, monitoring
+ */
+export declare const getStats: (event: any, context: any) => Promise<any>;
+/**
+ * @chunk-id    LOGS_SEARCH_1_0_0
+ * @version     1.0.0
+ * @hash        25f4552cc8b604e280e77c9180dea6435c99f864f8d1578af44ea68793c4c67d
+ * @macro       Logs Text Search Handler
+ * @micro       Performs full-text search on log messages with filtering
+ * @inputs      ctx: CoreContext — Request context with principal and database
+ * @inputs      body: any — Request body (unused for GET)
+ * @outputs     Array of mapped log rows matching search query
+ * @depends-on  [createHandler, mapLogRow]
+ * @depended-by [Netlify function routing]
+ * @side-effects [DB ILIKE search, row mapping]
+ * @tags        logs, search, text-search, ilike
+ */
+export declare const search: (event: any, context: any) => Promise<any>;
+/**
+ * @chunk-id    LOGS_LOG_1_0_0
+ * @version     1.0.0
+ * @hash        521255a8c1a7e4110e2873050c8b58c8819fa6540bb039d30117946ef741633f
+ * @macro       Log Entry Writer
+ * @micro       Writes external log entry with field mapping and validation
+ * @inputs      ctx: CoreContext — Request context with principal and database
+ * @inputs      body: object — Log data including event_type and optional fields
+ * @outputs     {log_id: string} — ID of created log entry
+ * @depends-on  [createHandler]
+ * @depended-by [Netlify function routing]
+ * @side-effects [DB insert with field mapping]
+ * @tags        logs, create, external, instrumentation
+ */
+export declare const log: (event: any, context: any) => Promise<any>;
+/**
+ * @chunk-id    LOGS_CLEANUP_1_0_0
+ * @version     1.0.0
+ * @hash        3790847ac4c98e79285483511dcc23c303dc339b4988ac5715c1f165a1bb29c9
+ * @macro       Logs Cleanup Handler
+ * @micro       Deletes old log entries beyond retention period
+ * @inputs      ctx: CoreContext — Request context with principal and database
+ * @inputs      body: object — days_to_keep (default 90)
+ * @outputs     {deleted_count: number} — Number of deleted log entries
+ * @depends-on  [createHandler]
+ * @depended-by [Netlify function routing, system-cron.ts]
+ * @side-effects [DB delete by date]
+ * @tags        logs, cleanup, retention, maintenance
+ */
+export declare const cleanup: (event: any, context: any) => Promise<any>;
+/**
+ * @chunk-id    LOGS_HANDLER_1_0_0
+ * @version     1.0.0
+ * @hash        62e729c4e43a30a85394c5ed66a1c2a12898135b133b8b712f481670d2351b22
+ * @macro       Logs Router
+ * @micro       Routes HTTP methods and actions to appropriate log handlers
+ * @inputs      ctx: CoreContext — Request context with principal and database
+ * @inputs      body: any — Request body for POST operations
+ * @outputs     Varies — Depends on routed handler (listAccount/listTarget/listPerson/getStats/search/cleanup/log)
+ * @depends-on  [createHandler, listAccount, listTarget, listPerson, getStats, search, cleanup, log]
+ * @depended-by [Netlify function routing]
+ * @side-effects [Delegates to appropriate handler]
+ * @tags        logs, router, crud, netlify-function
+ */
+export declare const handler: (event: any, context: any) => Promise<any>;
+//# sourceMappingURL=logs.d.ts.map

package/dist/functions/logs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.d.ts","sourceRoot":"","sources":["../../.framework/functions/logs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAuCH;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,WAAW,4CA0BtB,CAAA;AAIF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,UAAU,4CA6BrB,CAAA;AAIF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,UAAU,4CAgCrB,CAAA;AAIF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,QAAQ,4CA0BnB,CAAA;AAIF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,MAAM,4CA6BjB,CAAA;AAIF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,GAAG,4CA8Bd,CAAA;AAIF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,OAAO,4CAelB,CAAA;AAMF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,OAAO,4CA4BlB,CAAA"}

package/dist/functions/observability.d.ts

@@ -0,0 +1,123 @@
+/**
+ * @module observability
+ * @audience core-contributor
+ * @layer api-handler
+ * @stability stable
+ *
+ * Aggregated observability metrics API. All handlers delegate to Postgres
+ * analytics RPCs that operate over the `v2.logs` table. Results are
+ * read-only; no writes occur in this module.
+ *
+ * **Routed by:** `GET/POST /.netlify/functions/observability`
+ *
+ * **Actions (all GET unless noted):**
+ * | ?action               | handler                |
+ * |-----------------------|------------------------|
+ * | event_volume          | getEventVolume         |
+ * | error_rate            | getErrorRate           |
+ * | latency_percentiles   | getLatencyPercentiles  |
+ * | pipeline_stats        | getPipelineStats       |
+ * | top_actors            | getTopActors           |
+ * | cleanup               | cleanupOldLogs (POST)  |
+ *
+ * **Authorization:** All read endpoints require account context (RLS-scoped
+ * via `ctx.db`). `cleanup` additionally requires the `system_admin` role.
+ *
+ * INVARIANT: Every handler requires both `from` and `to` date params
+ *   (except `cleanup`). Requests without them throw immediately.
+ *
+ * @seeAlso logs.ts (raw log access with filter/search)
+ * @seeAlso system-cron.ts (evaluateThresholds calls observability RPCs)
+ * @seeAlso pipeline-executions.ts (pipeline_stats RPC aggregates these)
+ */
+/**
+ * Returns time-bucketed event volume counts via the `get_event_volume` RPC.
+ *
+ * Query params: `from` (required, ISO), `to` (required, ISO),
+ * `bucket` ('minute'|'hour'|'day', default 'hour')
+ *
+ * @returns Array of `{ bucket_time, event_type, count }` rows
+ * @throws Error('Account context required')
+ * @throws Error('from and to dates are required')
+ * @sideEffects DB read: get_event_volume RPC
+ * @calledBy handler (?action=event_volume)
+ */
+export declare const getEventVolume: (event: any, context: any) => Promise<any>;
+/**
+ * Returns aggregate error rate for the account time window via the
+ * `get_error_rate` RPC.
+ *
+ * Query params: `from` (required, ISO), `to` (required, ISO)
+ *
+ * @returns `{ total: number, errors: number, rate: number }` (0.0–1.0)
+ * @throws Error('Account context required')
+ * @throws Error('from and to dates are required')
+ * @sideEffects DB read: get_error_rate RPC
+ * @calledBy handler (?action=error_rate)
+ * @calledBy system-cron.ts evaluateThresholds (metric='error_rate')
+ */
+export declare const getErrorRate: (event: any, context: any) => Promise<any>;
+/**
+ * Returns request latency percentiles (p50/p90/p99) via the
+ * `get_latency_percentiles` RPC.
+ *
+ * Query params: `from` (required, ISO), `to` (required, ISO),
+ * `source` (log source filter, default 'request')
+ *
+ * @returns `{ p50: number, p90: number, p99: number }` (milliseconds)
+ * @throws Error('Account context required')
+ * @throws Error('from and to dates are required')
+ * @sideEffects DB read: get_latency_percentiles RPC
+ * @calledBy handler (?action=latency_percentiles)
+ * @calledBy system-cron.ts evaluateThresholds (metric='latency_p95')
+ */
+export declare const getLatencyPercentiles: (event: any, context: any) => Promise<any>;
+/**
+ * Returns per-pipeline execution statistics (success/failure counts,
+ * average duration) via the `get_pipeline_stats` RPC.
+ *
+ * Query params: `from` (required, ISO), `to` (required, ISO)
+ *
+ * @returns Array of `{ pipeline_id, name, success_count, failure_count, avg_duration_ms }`
+ * @throws Error('Account context required')
+ * @throws Error('from and to dates are required')
+ * @sideEffects DB read: get_pipeline_stats RPC
+ * @calledBy handler (?action=pipeline_stats)
+ * @calledBy system-cron.ts evaluateThresholds (metric='pipeline_failure_rate')
+ */
+export declare const getPipelineStats: (event: any, context: any) => Promise<any>;
+/**
+ * Returns the most active principals (persons) by event count via the
+ * `get_top_actors` RPC.
+ *
+ * Query params: `from` (required, ISO), `to` (required, ISO),
+ * `limit` (default 5)
+ *
+ * @returns Array of `{ person_id, full_name, event_count }` ordered by count desc
+ * @throws Error('Account context required')
+ * @throws Error('from and to dates are required')
+ * @sideEffects DB read: get_top_actors RPC
+ * @calledBy handler (?action=top_actors)
+ */
+export declare const getTopActors: (event: any, context: any) => Promise<any>;
+/**
+ * Manually triggers cross-account log cleanup via the `cleanup_old_logs`
+ * RPC. Requires `system_admin` role — not available to regular users.
+ *
+ * Query params: `days` (optional, default 90)
+ *
+ * @returns `{ deleted_count: number }`
+ * @throws Error('System admin required') if principal lacks system_admin role
+ * @sideEffects DB write: cleanup_old_logs RPC (cross-account DELETE)
+ * @calledBy handler (?action=cleanup)
+ * @calledBy system-cron.ts cleanupOldLogs (automated daily rotation)
+ */
+export declare const cleanupOldLogs: (event: any, context: any) => Promise<any>;
+/**
+ * Netlify function entry point. Dispatches to analytics handler by ?action.
+ * All valid ?action values are listed in the module dispatch table.
+ * @throws Error('Unknown action: <action>. Valid actions: ...') on mismatch
+ * @calledBy Netlify function routing
+ */
+export declare const handler: (event: any, context: any) => Promise<any>;
+//# sourceMappingURL=observability.d.ts.map

package/dist/functions/observability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observability.d.ts","sourceRoot":"","sources":["../../.framework/functions/observability.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAMH;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,cAAc,4CAsBzB,CAAA;AAGF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,YAAY,4CAoBvB,CAAA;AAEF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,qBAAqB,4CAqBhC,CAAA;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,gBAAgB,4CAoB3B,CAAA;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,YAAY,4CAqBvB,CAAA;AAGF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,cAAc,4CAezB,CAAA;AAIF;;;;;GAKG;AACH,eAAO,MAAM,OAAO,4CAmBlB,CAAA"}

package/dist/functions/pipeline-executions.d.ts

@@ -0,0 +1,190 @@
+/**
+ * @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)
+ */
+/**
+ * @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
+ */
+export declare const list: (event: any, context: any) => Promise<any>;
+/**
+ * @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
+ */
+export declare const get: (event: any, context: any) => Promise<any>;
+/**
+ * @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
+ */
+export declare const create: (event: any, context: any) => Promise<any>;
+/**
+ * @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
+ */
+export declare const start: (event: any, context: any) => Promise<any>;
+/**
+ * @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
+ */
+export declare const complete: (event: any, context: any) => Promise<any>;
+/**
+ * @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
+ */
+export declare const cancel: (event: any, context: any) => Promise<any>;
+/**
+ * @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
+ */
+export declare const getRunning: (event: any, context: any) => Promise<any>;
+/**
+ * @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
+ */
+export declare const getStats: (event: any, context: any) => Promise<any>;
+/**
+ * @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
+ */
+export declare const cleanup: (event: any, context: any) => Promise<any>;
+/**
+ * @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
+ */
+export declare const handler: (event: any, context: any) => Promise<any>;
+//# sourceMappingURL=pipeline-executions.d.ts.map

package/dist/functions/pipeline-executions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline-executions.d.ts","sourceRoot":"","sources":["../../.framework/functions/pipeline-executions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAcH;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,IAAI,4CAwBf,CAAA;AAIF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,GAAG,4CAgBd,CAAA;AAIF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,MAAM,4CA+BjB,CAAA;AAIF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,KAAK,4CAsBhB,CAAA;AAIF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,QAAQ,4CA0CnB,CAAA;AAIF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,MAAM,4CAsBjB,CAAA;AAIF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,UAAU,4CAqBrB,CAAA;AAIF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,QAAQ,4CA2BnB,CAAA;AAIF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,OAAO,4CAuBlB,CAAA;AAMF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,OAAO,4CAkClB,CAAA"}

package/dist/functions/pipelines.d.ts

@@ -0,0 +1,171 @@
+/**
+ * @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)
+ */
+/**
+ * @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
+ */
+export declare const listByTrigger: (event: any, context: any) => Promise<any>;
+/**
+ * @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
+ */
+export declare const list: (event: any, context: any) => Promise<any>;
+/**
+ * @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
+ */
+export declare const get: (event: any, context: any) => Promise<any>;
+/**
+ * @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
+ */
+export declare const create: (event: any, context: any) => Promise<any>;
+/**
+ * @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
+ */
+export declare const update: (event: any, context: any) => Promise<any>;
+/**
+ * @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
+ */
+export declare const toggle: (event: any, context: any) => Promise<any>;
+/**
+ * @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
+ */
+export declare const getExecutions: (event: any, context: any) => Promise<any>;
+/**
+ * @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
+ */
+export declare const remove: (event: any, context: any) => Promise<any>;
+/**
+ * @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
+ */
+export declare const handler: (event: any, context: any) => Promise<any>;
+//# sourceMappingURL=pipelines.d.ts.map

package/dist/functions/pipelines.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipelines.d.ts","sourceRoot":"","sources":["../../.framework/functions/pipelines.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAUH;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,aAAa,4CAiCxB,CAAA;AAIF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,IAAI,4CA2Bf,CAAA;AAIF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,GAAG,4CAiBd,CAAA;AAIF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,MAAM,4CAmCjB,CAAA;AAIF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,MAAM,4CA6CjB,CAAA;AAIF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,MAAM,4CAqCjB,CAAA;AAIF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,aAAa,4CAoBxB,CAAA;AAIF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,MAAM,4CA4BjB,CAAA;AAMF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,OAAO,4CAqClB,CAAA"}