@shipfox/api-workflows 11.0.0 → 12.1.0

package/.turbo/turbo-build.log

@@ -1,12 +1,12 @@
 $ shipfox-swc && shipfox-temporal-bundle dist/temporal/workflows/index.js
-Successfully compiled: 116 files with swc (767.93ms)
-2026-07-28T22:45:34.612Z [INFO] asset workflow-bundle-21a9ae8beb3cb55dabc1.js 3.31 MiB [emitted] [immutable] (name: main)
+Successfully compiled: 119 files with swc (757.97ms)
+2026-08-04T14:51:31.477Z [INFO] asset workflow-bundle-a5487a6112facdf4dd9d.js 3.32 MiB [emitted] [immutable] (name: main)
 orphan modules 33.5 KiB [orphan] 21 modules
 runtime modules 1.13 KiB 5 modules
 modules by path ../../../node_modules/.pnpm/ 970 KiB 196 modules
-modules by path ./dist/ 39.9 KiB
-  modules by path ./dist/temporal/ 34.8 KiB
-    modules by path ./dist/temporal/workflows/*.js 33.5 KiB 5 modules
+modules by path ./dist/ 41.2 KiB
+  modules by path ./dist/temporal/ 36.1 KiB
+    modules by path ./dist/temporal/workflows/*.js 34.8 KiB 5 modules
     + 2 modules
   modules by path ./dist/core/ 5.11 KiB
     ./dist/core/job-execution-outcome.js 1010 bytes [built] [code generated]
@@ -16,6 +16,6 @@ optional modules 30 bytes [optional]
   __temporal_custom_payload_converter (ignored) 15 bytes [optional] [built] [code generated]
   __temporal_custom_failure_converter (ignored) 15 bytes [optional] [built] [code generated]
 ../../shared/node/temporal/dist/workflow-error-interceptor.js 1.21 KiB [built] [code generated]
-webpack 5.107.2 compiled successfully in 7247 ms
-2026-07-28T22:45:34.624Z [INFO] Workflow bundle created { size: '3.31MB' }
-/home/runner/work/shipfox/shipfox/libs/api/workflows/dist/temporal/workflows/index.js: 3470576 bytes
+webpack 5.107.2 compiled successfully in 7052 ms
+2026-08-04T14:51:31.488Z [INFO] Workflow bundle created { size: '3.32MB' }
+/home/runner/work/shipfox/shipfox/libs/api/workflows/dist/temporal/workflows/index.js: 3476109 bytes

package/CHANGELOG.md

@@ -1,5 +1,112 @@
 # @shipfox/api-workflows
 
+## 12.1.0
+
+### Patch Changes
+
+- Updated dependencies [312a137]
+  - @shipfox/api-workflows-dto@12.1.0
+
+## 12.0.0
+
+### Major Changes
+
+- adf07e7: Cut over workflow and job display names to literal-only `name` fields, with runtime interpolation supported through `run_name` and `execution_name`.
+- 032d316: Scope checkout credential minting to the currently running checkout step and return its fetch depth.
+
+### Minor Changes
+
+- ee2ce67: Accept a `${{ }}` interpolation in an agent step's `thinking` field. The schema
+  still offers the per-harness enum for editor completion, and the dispatcher
+  checks the resolved value against the harness levels. An unsupported
+  resolved level fails the step.
+- 5d2c9cf: Carry checkout steps from workflow normalization through step materialization and surface their setup error category.
+- f7939c7: Add resolved checkout details as a dedicated step-report field.
+- 9e1d599: Carry first-checkout intent through workflow normalization and step materialization for the upcoming runner checkout execution, including implicit-checkout suppression, checkout opt-out, and position-based primary checkout placement.
+- dea1ffd: Expose normalized repository references on listening execution events.
+- 285fff2: Persist resolved workflow job execution names and handle dynamic naming failures consistently.
+- e44a279: Persist nullable resolved workflow run-name overrides alongside static workflow-name snapshots.
+- 54c820e: Add the trigger reference and the current attempt's jobs to each workflow run in the run list response.
+
+  `trigger_reference` carries the repository, ref, commit, and actor a source-control trigger resolved, or null for triggers that resolve none. Jobs arrive as `jobs`, a preview bounded by the new `WORKFLOW_RUN_JOB_PREVIEW_LIMIT`, alongside `job_status_counts` covering every job of the attempt including those past the preview.
+
+- 35a42bd: Resolve run and agent step working directories against the runner job workspace.
+- d77baaa: Add per-definition sequential numbers to workflow runs and expose them in the API and expression context.
+- c2a8e54: Normalize checkout target fields for step-dispatch resolution, reject unsupported job-level checkout fields, and keep the workflow model and runtime checkout contracts aligned.
+- cb0abfa: Expose the normalized trigger project, repository, ref, and commit in workflow context.
+- ee2ce67: Split workflow definition facts out of the `run` context into a `workflow` root.
+  `run.workflow_name` becomes `workflow.name` and `run.definition_id` becomes
+  `workflow.id`, so `workflow` and `run` mirror the `job` and `execution` pair.
+  Add `contextRootsForField` to return the readable roots for a predicate or an
+  interpolation field without requiring the caller to choose a mechanism. Add
+  `workflowContextDocs` as the reader-facing description of every root and property.
+
+### Patch Changes
+
+- 7c4116e: Align predicate property types with their runtime shapes, replace `run.run_name` with `run.workflow_name`, and remove `failed` from `executions` entries.
+- 0bb880a: Transition job executions from pending to running when the runner claims them.
+- f78740d: Remove Unicode dash punctuation from package prose and source comments.
+- 4d246d4: Align predicate validation and runtime evaluation with field-specific context contracts.
+- 66f111e: Snapshots referenced workflow variables for predicate evaluation at run creation.
+- 53ce6b2: Materialize primary checkout credential persistence on the setup step.
+- 5d267c3: Re-materialize checkout policy from the workflow model when re-running a job.
+- 9e39069: Defaults same-project checkout steps to the workflow trigger commit while preserving explicit refs and cross-repository defaults.
+- Updated dependencies [ee2ce67]
+- Updated dependencies [7c4116e]
+- Updated dependencies [5d2c9cf]
+- Updated dependencies [e95fdf4]
+- Updated dependencies [3d91d1d]
+- Updated dependencies [f7939c7]
+- Updated dependencies [89f2c18]
+- Updated dependencies [045895c]
+- Updated dependencies [f78740d]
+- Updated dependencies [9e1d599]
+- Updated dependencies [dea1ffd]
+- Updated dependencies [adf07e7]
+- Updated dependencies [94aba88]
+- Updated dependencies [3f781ee]
+- Updated dependencies [9fdd5e4]
+- Updated dependencies [285fff2]
+- Updated dependencies [e44a279]
+- Updated dependencies [4d246d4]
+- Updated dependencies [4eb18b8]
+- Updated dependencies [28daafe]
+- Updated dependencies [f13e8bb]
+- Updated dependencies [9ebc5b4]
+- Updated dependencies [4444079]
+- Updated dependencies [869a792]
+- Updated dependencies [8cc5a36]
+- Updated dependencies [54c820e]
+- Updated dependencies [35a42bd]
+- Updated dependencies [d77baaa]
+- Updated dependencies [41d558c]
+- Updated dependencies [032d316]
+- Updated dependencies [c2a8e54]
+- Updated dependencies [54c820e]
+- Updated dependencies [cb0abfa]
+- Updated dependencies [ee2ce67]
+- Updated dependencies [7f90b0c]
+- Updated dependencies [e1efaee]
+  - @shipfox/workflow-document@3.0.0
+  - @shipfox/api-definitions-dto@12.0.0
+  - @shipfox/api-workflows-dto@12.0.0
+  - @shipfox/api-agent-dto@12.0.0
+  - @shipfox/expression@2.0.0
+  - @shipfox/api-auth-dto@12.0.0
+  - @shipfox/inter-module@0.2.3
+  - @shipfox/node-fastify@0.4.1
+  - @shipfox/node-module@1.0.5
+  - @shipfox/api-workspaces-dto@12.0.0
+  - @shipfox/api-projects-dto@12.0.0
+  - @shipfox/api-integration-core-dto@12.0.0
+  - @shipfox/node-postgres@0.5.0
+  - @shipfox/api-auth-context@12.0.0
+  - @shipfox/annotations-dto@12.0.0
+  - @shipfox/api-runners-dto@12.0.0
+  - @shipfox/api-secrets-dto@12.0.0
+  - @shipfox/node-drizzle@0.3.5
+  - @shipfox/node-outbox@0.2.6
+
 ## 11.0.0
 
 ### Major Changes

package/README.md

@@ -0,0 +1,75 @@
+# Shipfox API Workflows
+
+Shipfox API Workflows creates and runs workflow definitions, jobs, executions, steps, and run history.
+
+## What it does
+
+- **`createWorkflowsModule`**: Registers workflow routes, persistence, events, subscribers, and orchestration.
+- **`runWorkflow`**: Loads a definition and creates a run with its initial graph.
+- **`WorkflowRun`**: Represents a run with UUID identity, status, trigger data, and display fields.
+- **`loadRunningLeasedStep`**: Loads the step state available to a leased runner.
+
+## Installation / Setup
+
+```sh
+pnpm add @shipfox/api-workflows
+```
+
+The module requires the Auth, Definitions, Integrations, Projects, Runners,
+Secrets, Workspaces, Annotations, and Agent inter-module clients.
+
+## Usage
+
+```ts
+import {runWorkflow} from '@shipfox/api-workflows';
+
+const run = await runWorkflow(definitions, {
+  agent,
+  workspaceId,
+  projectId,
+  definitionId,
+  triggerPayload: {
+    source: 'manual',
+    event: 'fire',
+    subscriptionId,
+    userId,
+  },
+});
+```
+
+## Routes / API / Data Model
+
+Workflow routes keep UUIDs in path and query parameters. The run response
+includes both `id` and `number`. The UUID identifies the run. The number is a
+display label and workflow expression value.
+
+## Behavior Notes
+
+Run numbers are sequential within one workflow definition, start at `1`, and
+are unique for `(definition_id, number)`. The Workflows module allocates the
+number with a per-definition counter inside the run-creation transaction. It
+resolves trigger idempotency before allocation, so a duplicate delivery returns
+the original run without consuming another number.
+
+Gaps are acceptable because the number is a label and monotonicity matters more
+than density. Counter rows stay after a definition is removed, and reruns create
+another attempt on the same run without consuming a number.
+
+Run numbers are never addresses. No route resolves a run by its number, and run
+URLs continue to use the run UUID. A run number is useful in workflow
+expressions as `run.number` and should appear beside the workflow name when it is
+shown in a list.
+
+## Development
+
+```sh
+turbo check --filter=@shipfox/api-workflows
+turbo type --filter=@shipfox/api-workflows
+turbo test --filter=@shipfox/api-workflows
+```
+
+DB-backed workflow tests need local Postgres from `docker compose up -d`.
+
+## License
+
+MIT

package/dist/core/agent-defaults.d.ts

@@ -5,7 +5,8 @@ export interface AgentDefaultsInput {
     readonly harness?: Harness | undefined;
     readonly provider?: ModelProviderRef | undefined;
     readonly model?: string | undefined;
-    readonly thinking?: AgentThinking | undefined;
+    /** A resolved template can carry any string. The agent module validates it. */
+    readonly thinking?: string | undefined;
 }
 export interface ResolvedAgentDefaults {
     readonly harness: Harness;

package/dist/core/agent-defaults.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-defaults.d.ts","sourceRoot":"","sources":["../../src/core/agent-defaults.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,gBAAgB,EAAC,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAC,sBAAsB,EAAC,MAAM,qCAAqC,CAAC;AAChF,OAAO,KAAK,EAAC,aAAa,EAAE,OAAO,EAAC,MAAM,4BAA4B,CAAC;AAEvE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,QAAQ,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAC;IACjD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,QAAQ,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;CAC/C;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;CAClC;AAED,MAAM,MAAM,qBAAqB,GAAG,CAClC,KAAK,EAAE,kBAAkB,KACtB,qBAAqB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;AAE5D,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,sBAAsB,EAC7B,WAAW,EAAE,MAAM,GAAG,IAAI,GACzB,qBAAqB,CAWvB"}
+{"version":3,"file":"agent-defaults.d.ts","sourceRoot":"","sources":["../../src/core/agent-defaults.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,gBAAgB,EAAC,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAC,sBAAsB,EAAC,MAAM,qCAAqC,CAAC;AAChF,OAAO,KAAK,EAAC,aAAa,EAAE,OAAO,EAAC,MAAM,4BAA4B,CAAC;AAEvE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,QAAQ,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAC;IACjD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,+EAA+E;IAC/E,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACxC;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;CAClC;AAED,MAAM,MAAM,qBAAqB,GAAG,CAClC,KAAK,EAAE,kBAAkB,KACtB,qBAAqB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;AAE5D,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,sBAAsB,EAC7B,WAAW,EAAE,MAAM,GAAG,IAAI,GACzB,qBAAqB,CAWvB"}

package/dist/core/agent-defaults.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/core/agent-defaults.ts"],"sourcesContent":["import type {ModelProviderRef} from '@shipfox/api-agent-dto';\nimport type {AgentInterModuleClient} from '@shipfox/api-agent-dto/inter-module';\nimport type {AgentThinking, Harness} from '@shipfox/workflow-document';\n\nexport interface AgentDefaultsInput {\n  readonly harness?: Harness | undefined;\n  readonly provider?: ModelProviderRef | undefined;\n  readonly model?: string | undefined;\n  readonly thinking?: AgentThinking | undefined;\n}\n\nexport interface ResolvedAgentDefaults {\n  readonly harness: Harness;\n  readonly provider: ModelProviderRef;\n  readonly model: string;\n  readonly thinking: AgentThinking;\n}\n\nexport type AgentDefaultsResolver = (\n  input: AgentDefaultsInput,\n) => ResolvedAgentDefaults | Promise<ResolvedAgentDefaults>;\n\nexport function createAgentDefaultsResolver(\n  agent: AgentInterModuleClient,\n  workspaceId: string | null,\n): AgentDefaultsResolver {\n  return async (config) =>\n    await agent.resolveAgentConfig({\n      workspaceId,\n      config: {\n        ...(config.harness === undefined ? {} : {harness: config.harness}),\n        ...(config.provider === undefined ? {} : {provider: config.provider}),\n        ...(config.model === undefined ? {} : {model: config.model}),\n        ...(config.thinking === undefined ? {} : {thinking: config.thinking}),\n      },\n    });\n}\n"],"names":["createAgentDefaultsResolver","agent","workspaceId","config","resolveAgentConfig","harness","undefined","provider","model","thinking"],"mappings":"AAsBA,OAAO,SAASA,4BACdC,KAA6B,EAC7BC,WAA0B;IAE1B,OAAO,OAAOC,SACZ,MAAMF,MAAMG,kBAAkB,CAAC;YAC7BF;YACAC,QAAQ;gBACN,GAAIA,OAAOE,OAAO,KAAKC,YAAY,CAAC,IAAI;oBAACD,SAASF,OAAOE,OAAO;gBAAA,CAAC;gBACjE,GAAIF,OAAOI,QAAQ,KAAKD,YAAY,CAAC,IAAI;oBAACC,UAAUJ,OAAOI,QAAQ;gBAAA,CAAC;gBACpE,GAAIJ,OAAOK,KAAK,KAAKF,YAAY,CAAC,IAAI;oBAACE,OAAOL,OAAOK,KAAK;gBAAA,CAAC;gBAC3D,GAAIL,OAAOM,QAAQ,KAAKH,YAAY,CAAC,IAAI;oBAACG,UAAUN,OAAOM,QAAQ;gBAAA,CAAC;YACtE;QACF;AACJ"}
+{"version":3,"sources":["../../src/core/agent-defaults.ts"],"sourcesContent":["import type {ModelProviderRef} from '@shipfox/api-agent-dto';\nimport type {AgentInterModuleClient} from '@shipfox/api-agent-dto/inter-module';\nimport type {AgentThinking, Harness} from '@shipfox/workflow-document';\n\nexport interface AgentDefaultsInput {\n  readonly harness?: Harness | undefined;\n  readonly provider?: ModelProviderRef | undefined;\n  readonly model?: string | undefined;\n  /** A resolved template can carry any string. The agent module validates it. */\n  readonly thinking?: string | undefined;\n}\n\nexport interface ResolvedAgentDefaults {\n  readonly harness: Harness;\n  readonly provider: ModelProviderRef;\n  readonly model: string;\n  readonly thinking: AgentThinking;\n}\n\nexport type AgentDefaultsResolver = (\n  input: AgentDefaultsInput,\n) => ResolvedAgentDefaults | Promise<ResolvedAgentDefaults>;\n\nexport function createAgentDefaultsResolver(\n  agent: AgentInterModuleClient,\n  workspaceId: string | null,\n): AgentDefaultsResolver {\n  return async (config) =>\n    await agent.resolveAgentConfig({\n      workspaceId,\n      config: {\n        ...(config.harness === undefined ? {} : {harness: config.harness}),\n        ...(config.provider === undefined ? {} : {provider: config.provider}),\n        ...(config.model === undefined ? {} : {model: config.model}),\n        ...(config.thinking === undefined ? {} : {thinking: config.thinking}),\n      },\n    });\n}\n"],"names":["createAgentDefaultsResolver","agent","workspaceId","config","resolveAgentConfig","harness","undefined","provider","model","thinking"],"mappings":"AAuBA,OAAO,SAASA,4BACdC,KAA6B,EAC7BC,WAA0B;IAE1B,OAAO,OAAOC,SACZ,MAAMF,MAAMG,kBAAkB,CAAC;YAC7BF;YACAC,QAAQ;gBACN,GAAIA,OAAOE,OAAO,KAAKC,YAAY,CAAC,IAAI;oBAACD,SAASF,OAAOE,OAAO;gBAAA,CAAC;gBACjE,GAAIF,OAAOI,QAAQ,KAAKD,YAAY,CAAC,IAAI;oBAACC,UAAUJ,OAAOI,QAAQ;gBAAA,CAAC;gBACpE,GAAIJ,OAAOK,KAAK,KAAKF,YAAY,CAAC,IAAI;oBAACE,OAAOL,OAAOK,KAAK;gBAAA,CAAC;gBAC3D,GAAIL,OAAOM,QAAQ,KAAKH,YAAY,CAAC,IAAI;oBAACG,UAAUN,OAAOM,QAAQ;gBAAA,CAAC;YACtE;QACF;AACJ"}

package/dist/core/checkout.d.ts

@@ -1,27 +1,12 @@
 import type { IntegrationsModuleClient } from '@shipfox/api-integration-core-dto/inter-module';
 import type { ProjectsModuleClient } from '@shipfox/api-projects-dto/inter-module';
-export interface CheckoutIntent {
+import type { Step } from '#core/entities/step.js';
+import type { WorkflowRunTriggerReference } from '#core/entities/workflow-run.js';
+export declare function createStepCheckoutSpec({ step, workspaceId, projectId, triggerReference, integrations, projects, }: {
+    step: Step;
     workspaceId: string;
-    connectionId: string;
-    externalRepositoryId: string;
-    persistCredentials: boolean;
-    permissions: {
-        contents: 'read' | 'write';
-    };
-}
-/**
- * Resolves what to check out for a job, keyed off the authoritative `jobId`
- * (`workflowRunId`/`workflowRunAttemptId`/`workspaceId` in the lease claim are informational).
- * Chain: job → attempt → run → project source metadata. Credential-free.
- */
-export declare function resolveCheckoutIntent(jobId: string, projects: ProjectsModuleClient): Promise<CheckoutIntent>;
-/**
- * Resolves the job's checkout intent and exchanges it for a short-lived,
- * scoped checkout spec. Omitting `ref` lets the provider use the repository's
- * default branch while preserving the JSON-only inter-module boundary.
- */
-export declare function createJobCheckoutSpec({ jobId, integrations, projects, }: {
-    jobId: string;
+    projectId: string;
+    triggerReference?: WorkflowRunTriggerReference | null | undefined;
     integrations: IntegrationsModuleClient;
     projects: ProjectsModuleClient;
 }): Promise<{
@@ -38,6 +23,7 @@ export declare function createJobCheckoutSpec({ jobId, integrations, projects, }
             email: string;
         };
     };
+    fetchDepth: number;
     persistCredentials: boolean;
 }>;
 //# sourceMappingURL=checkout.d.ts.map

package/dist/core/checkout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"checkout.d.ts","sourceRoot":"","sources":["../../src/core/checkout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,wBAAwB,EAAC,MAAM,gDAAgD,CAAC;AAC7F,OAAO,KAAK,EAAC,oBAAoB,EAAC,MAAM,wCAAwC,CAAC;AAQjF,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,WAAW,EAAE;QAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAA;KAAC,CAAC;CAC3C;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,oBAAoB,GAC7B,OAAO,CAAC,cAAc,CAAC,CAiBzB;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CAAC,EAC1C,KAAK,EACL,YAAY,EACZ,QAAQ,GACT,EAAE;IACD,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,wBAAwB,CAAC;IACvC,QAAQ,EAAE,oBAAoB,CAAC;CAChC,GAAG,OAAO,CAAC;IACV,IAAI,EAAE;QACJ,aAAa,EAAE,MAAM,CAAC;QACtB,GAAG,EAAE,MAAM,CAAC;QACZ,WAAW,CAAC,EAAE;YAAC,QAAQ,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,IAAI,CAAA;SAAC,CAAC;QACjE,SAAS,CAAC,EAAE;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAC,CAAC;KAC3C,CAAC;IACF,kBAAkB,EAAE,OAAO,CAAC;CAC7B,CAAC,CAwBD"}
+{"version":3,"file":"checkout.d.ts","sourceRoot":"","sources":["../../src/core/checkout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,wBAAwB,EAAC,MAAM,gDAAgD,CAAC;AAC7F,OAAO,KAAK,EAAC,oBAAoB,EAAC,MAAM,wCAAwC,CAAC;AAGjF,OAAO,KAAK,EAAC,IAAI,EAAC,MAAM,wBAAwB,CAAC;AACjD,OAAO,KAAK,EAAC,2BAA2B,EAAC,MAAM,gCAAgC,CAAC;AA+BhF,wBAAsB,sBAAsB,CAAC,EAC3C,IAAI,EACJ,WAAW,EACX,SAAS,EACT,gBAAgB,EAChB,YAAY,EACZ,QAAQ,GACT,EAAE;IACD,IAAI,EAAE,IAAI,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,2BAA2B,GAAG,IAAI,GAAG,SAAS,CAAC;IAClE,YAAY,EAAE,wBAAwB,CAAC;IACvC,QAAQ,EAAE,oBAAoB,CAAC;CAChC,GAAG,OAAO,CAAC;IACV,IAAI,EAAE;QACJ,aAAa,EAAE,MAAM,CAAC;QACtB,GAAG,EAAE,MAAM,CAAC;QACZ,WAAW,CAAC,EAAE;YAAC,QAAQ,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,IAAI,CAAA;SAAC,CAAC;QACjE,SAAS,CAAC,EAAE;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAC,CAAC;KAC3C,CAAC;IACF,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,OAAO,CAAC;CAC7B,CAAC,CAoDD"}

package/dist/core/checkout.js

@@ -1,54 +1,135 @@
-import { getJobById, getWorkflowRunByAttemptId } from '#db/workflow-runs.js';
-import { CheckoutIntentUnresolvedError, JobNotFoundError, WorkflowRunNotFoundError } from './errors.js';
-/**
- * Resolves what to check out for a job, keyed off the authoritative `jobId`
- * (`workflowRunId`/`workflowRunAttemptId`/`workspaceId` in the lease claim are informational).
- * Chain: job → attempt → run → project source metadata. Credential-free.
- */ export async function resolveCheckoutIntent(jobId, projects) {
-    const job = await getJobById(jobId);
-    if (!job) throw new JobNotFoundError(jobId);
-    const run = await getWorkflowRunByAttemptId(job.workflowRunAttemptId);
-    if (!run) throw new WorkflowRunNotFoundError(job.workflowRunAttemptId);
-    const { project } = await projects.getProjectById({
-        projectId: run.projectId
+import { checkoutTargetValidationIssues } from '@shipfox/workflow-document';
+import { z } from 'zod';
+import { CheckoutConfigInvalidError, CheckoutIntentUnresolvedError } from './errors.js';
+const checkoutConfigSchema = z.object({
+    project: z.string().uuid().optional(),
+    connection: z.string().min(1).optional(),
+    repository: z.string().min(1).optional(),
+    ref: z.string().min(1).optional(),
+    fetch_depth: z.number().int().nonnegative().optional(),
+    permissions: z.object({
+        contents: z.enum([
+            'read',
+            'write'
+        ])
+    }).optional(),
+    persist_credentials: z.boolean().optional()
+}).superRefine((checkout, context)=>{
+    for (const validationIssue of checkoutTargetValidationIssues(checkout)){
+        const message = validationIssue.kind === 'project-with-connection' ? 'Checkout project cannot be combined with a connection.' : validationIssue.kind === 'project-with-repository' ? 'Checkout project cannot be combined with a repository.' : 'Checkout connection requires a repository.';
+        context.addIssue({
+            code: 'custom',
+            path: [
+                validationIssue.path
+            ],
+            message
+        });
+    }
+});
+export async function createStepCheckoutSpec({ step, workspaceId, projectId, triggerReference, integrations, projects }) {
+    const checkout = parseCheckoutConfig(step);
+    const { project: defaultProject } = await projects.getProjectById({
+        projectId
     });
-    if (project === null) throw new CheckoutIntentUnresolvedError(run.projectId);
-    return {
-        workspaceId: project.workspaceId,
-        connectionId: project.sourceConnectionId,
-        externalRepositoryId: project.sourceExternalRepositoryId,
-        persistCredentials: job.checkout.persistCredentials,
-        permissions: job.checkout.permissions
-    };
-}
-/**
- * Resolves the job's checkout intent and exchanges it for a short-lived,
- * scoped checkout spec. Omitting `ref` lets the provider use the repository's
- * default branch while preserving the JSON-only inter-module boundary.
- */ export async function createJobCheckoutSpec({ jobId, integrations, projects }) {
-    const intent = await resolveCheckoutIntent(jobId, projects);
+    if (defaultProject === null || defaultProject === undefined) {
+        throw new CheckoutIntentUnresolvedError({
+            kind: 'project',
+            value: projectId
+        });
+    }
+    const target = await checkoutTarget({
+        checkout,
+        defaultProjectId: projectId,
+        defaultConnectionId: defaultProject.sourceConnectionId,
+        integrations,
+        workspaceId
+    });
+    const resolvedTarget = await projects.resolveCheckoutTarget({
+        workspaceId,
+        defaults: {
+            connectionId: defaultProject.sourceConnectionId,
+            owner: defaultOwner(defaultProject.sourceRepositoryOwner, checkout.repository)
+        },
+        target
+    });
+    const ref = checkout.ref ?? (triggerReference?.project?.id === resolvedTarget.projectId ? triggerReference.commit ?? undefined : undefined);
     const response = await integrations.createCheckoutSpec({
-        workspaceId: intent.workspaceId,
-        connectionId: intent.connectionId,
-        externalRepositoryId: intent.externalRepositoryId,
-        permissions: intent.permissions
+        workspaceId,
+        connectionId: resolvedTarget.connectionId,
+        externalRepositoryId: resolvedTarget.externalRepositoryId,
+        ...ref === undefined ? {} : {
+            ref
+        },
+        permissions: checkout.permissions ?? {
+            contents: 'read'
+        }
     });
-    const { credentials, gitAuthor, ...checkout } = response;
     return {
         spec: {
-            ...checkout,
-            ...credentials ? {
+            repositoryUrl: response.repositoryUrl,
+            ref: response.ref,
+            ...response.credentials ? {
                 credentials: {
-                    ...credentials,
-                    expiresAt: new Date(credentials.expiresAt)
+                    ...response.credentials,
+                    expiresAt: new Date(response.credentials.expiresAt)
                 }
             } : {},
-            ...gitAuthor ? {
-                gitAuthor
-            } : {}
+            ...response.gitAuthor === undefined ? {} : {
+                gitAuthor: response.gitAuthor
+            }
         },
-        persistCredentials: intent.persistCredentials
+        fetchDepth: checkout.fetch_depth ?? 1,
+        persistCredentials: checkout.persist_credentials ?? true
     };
 }
+function parseCheckoutConfig(step) {
+    const result = checkoutConfigSchema.safeParse(step.config.checkout);
+    if (!result.success) {
+        throw new CheckoutConfigInvalidError(step.id);
+    }
+    return result.data;
+}
+async function checkoutTarget(params) {
+    const { checkout } = params;
+    if (checkout.project !== undefined) return {
+        project: checkout.project
+    };
+    if (checkout.repository !== undefined) {
+        const connection = checkout.connection === undefined ? undefined : await resolveConnectionId({
+            integrations: params.integrations,
+            workspaceId: params.workspaceId,
+            defaultConnectionId: params.defaultConnectionId,
+            slug: checkout.connection
+        });
+        return {
+            ...connection === undefined ? {} : {
+                connection
+            },
+            repository: checkout.repository
+        };
+    }
+    return {
+        project: params.defaultProjectId
+    };
+}
+async function resolveConnectionId(params) {
+    const connection = await params.integrations.resolveConnection({
+        workspaceId: params.workspaceId,
+        slug: params.slug
+    });
+    if (connection === null) {
+        throw new CheckoutIntentUnresolvedError({
+            kind: 'connection',
+            value: params.slug
+        });
+    }
+    return connection.id;
+}
+function defaultOwner(projectOwner, repository) {
+    if (projectOwner) return projectOwner;
+    const separator = repository?.indexOf('/') ?? -1;
+    if (separator > 0 && repository !== undefined) return repository.slice(0, separator);
+    return 'unknown';
+}
 
 //# sourceMappingURL=checkout.js.map

package/dist/core/checkout.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/core/checkout.ts"],"sourcesContent":["import type {IntegrationsModuleClient} from '@shipfox/api-integration-core-dto/inter-module';\nimport type {ProjectsModuleClient} from '@shipfox/api-projects-dto/inter-module';\nimport {getJobById, getWorkflowRunByAttemptId} from '#db/workflow-runs.js';\nimport {\n  CheckoutIntentUnresolvedError,\n  JobNotFoundError,\n  WorkflowRunNotFoundError,\n} from './errors.js';\n\nexport interface CheckoutIntent {\n  workspaceId: string;\n  connectionId: string;\n  externalRepositoryId: string;\n  persistCredentials: boolean;\n  permissions: {contents: 'read' | 'write'};\n}\n\n/**\n * Resolves what to check out for a job, keyed off the authoritative `jobId`\n * (`workflowRunId`/`workflowRunAttemptId`/`workspaceId` in the lease claim are informational).\n * Chain: job → attempt → run → project source metadata. Credential-free.\n */\nexport async function resolveCheckoutIntent(\n  jobId: string,\n  projects: ProjectsModuleClient,\n): Promise<CheckoutIntent> {\n  const job = await getJobById(jobId);\n  if (!job) throw new JobNotFoundError(jobId);\n\n  const run = await getWorkflowRunByAttemptId(job.workflowRunAttemptId);\n  if (!run) throw new WorkflowRunNotFoundError(job.workflowRunAttemptId);\n\n  const {project} = await projects.getProjectById({projectId: run.projectId});\n  if (project === null) throw new CheckoutIntentUnresolvedError(run.projectId);\n\n  return {\n    workspaceId: project.workspaceId,\n    connectionId: project.sourceConnectionId,\n    externalRepositoryId: project.sourceExternalRepositoryId,\n    persistCredentials: job.checkout.persistCredentials,\n    permissions: job.checkout.permissions,\n  };\n}\n\n/**\n * Resolves the job's checkout intent and exchanges it for a short-lived,\n * scoped checkout spec. Omitting `ref` lets the provider use the repository's\n * default branch while preserving the JSON-only inter-module boundary.\n */\nexport async function createJobCheckoutSpec({\n  jobId,\n  integrations,\n  projects,\n}: {\n  jobId: string;\n  integrations: IntegrationsModuleClient;\n  projects: ProjectsModuleClient;\n}): Promise<{\n  spec: {\n    repositoryUrl: string;\n    ref: string;\n    credentials?: {username: string; token: string; expiresAt: Date};\n    gitAuthor?: {name: string; email: string};\n  };\n  persistCredentials: boolean;\n}> {\n  const intent = await resolveCheckoutIntent(jobId, projects);\n  const response = await integrations.createCheckoutSpec({\n    workspaceId: intent.workspaceId,\n    connectionId: intent.connectionId,\n    externalRepositoryId: intent.externalRepositoryId,\n    permissions: intent.permissions,\n  });\n  const {credentials, gitAuthor, ...checkout} = response;\n  return {\n    spec: {\n      ...checkout,\n      ...(credentials\n        ? {\n            credentials: {\n              ...credentials,\n              expiresAt: new Date(credentials.expiresAt),\n            },\n          }\n        : {}),\n      ...(gitAuthor ? {gitAuthor} : {}),\n    },\n    persistCredentials: intent.persistCredentials,\n  };\n}\n"],"names":["getJobById","getWorkflowRunByAttemptId","CheckoutIntentUnresolvedError","JobNotFoundError","WorkflowRunNotFoundError","resolveCheckoutIntent","jobId","projects","job","run","workflowRunAttemptId","project","getProjectById","projectId","workspaceId","connectionId","sourceConnectionId","externalRepositoryId","sourceExternalRepositoryId","persistCredentials","checkout","permissions","createJobCheckoutSpec","integrations","intent","response","createCheckoutSpec","credentials","gitAuthor","spec","expiresAt","Date"],"mappings":"AAEA,SAAQA,UAAU,EAAEC,yBAAyB,QAAO,uBAAuB;AAC3E,SACEC,6BAA6B,EAC7BC,gBAAgB,EAChBC,wBAAwB,QACnB,cAAc;AAUrB;;;;CAIC,GACD,OAAO,eAAeC,sBACpBC,KAAa,EACbC,QAA8B;IAE9B,MAAMC,MAAM,MAAMR,WAAWM;IAC7B,IAAI,CAACE,KAAK,MAAM,IAAIL,iBAAiBG;IAErC,MAAMG,MAAM,MAAMR,0BAA0BO,IAAIE,oBAAoB;IACpE,IAAI,CAACD,KAAK,MAAM,IAAIL,yBAAyBI,IAAIE,oBAAoB;IAErE,MAAM,EAACC,OAAO,EAAC,GAAG,MAAMJ,SAASK,cAAc,CAAC;QAACC,WAAWJ,IAAII,SAAS;IAAA;IACzE,IAAIF,YAAY,MAAM,MAAM,IAAIT,8BAA8BO,IAAII,SAAS;IAE3E,OAAO;QACLC,aAAaH,QAAQG,WAAW;QAChCC,cAAcJ,QAAQK,kBAAkB;QACxCC,sBAAsBN,QAAQO,0BAA0B;QACxDC,oBAAoBX,IAAIY,QAAQ,CAACD,kBAAkB;QACnDE,aAAab,IAAIY,QAAQ,CAACC,WAAW;IACvC;AACF;AAEA;;;;CAIC,GACD,OAAO,eAAeC,sBAAsB,EAC1ChB,KAAK,EACLiB,YAAY,EACZhB,QAAQ,EAKT;IASC,MAAMiB,SAAS,MAAMnB,sBAAsBC,OAAOC;IAClD,MAAMkB,WAAW,MAAMF,aAAaG,kBAAkB,CAAC;QACrDZ,aAAaU,OAAOV,WAAW;QAC/BC,cAAcS,OAAOT,YAAY;QACjCE,sBAAsBO,OAAOP,oBAAoB;QACjDI,aAAaG,OAAOH,WAAW;IACjC;IACA,MAAM,EAACM,WAAW,EAAEC,SAAS,EAAE,GAAGR,UAAS,GAAGK;IAC9C,OAAO;QACLI,MAAM;YACJ,GAAGT,QAAQ;YACX,GAAIO,cACA;gBACEA,aAAa;oBACX,GAAGA,WAAW;oBACdG,WAAW,IAAIC,KAAKJ,YAAYG,SAAS;gBAC3C;YACF,IACA,CAAC,CAAC;YACN,GAAIF,YAAY;gBAACA;YAAS,IAAI,CAAC,CAAC;QAClC;QACAT,oBAAoBK,OAAOL,kBAAkB;IAC/C;AACF"}
+{"version":3,"sources":["../../src/core/checkout.ts"],"sourcesContent":["import type {IntegrationsModuleClient} from '@shipfox/api-integration-core-dto/inter-module';\nimport type {ProjectsModuleClient} from '@shipfox/api-projects-dto/inter-module';\nimport {checkoutTargetValidationIssues} from '@shipfox/workflow-document';\nimport {z} from 'zod';\nimport type {Step} from '#core/entities/step.js';\nimport type {WorkflowRunTriggerReference} from '#core/entities/workflow-run.js';\nimport {CheckoutConfigInvalidError, CheckoutIntentUnresolvedError} from './errors.js';\n\nconst checkoutConfigSchema = z\n  .object({\n    project: z.string().uuid().optional(),\n    connection: z.string().min(1).optional(),\n    repository: z.string().min(1).optional(),\n    ref: z.string().min(1).optional(),\n    fetch_depth: z.number().int().nonnegative().optional(),\n    permissions: z.object({contents: z.enum(['read', 'write'])}).optional(),\n    persist_credentials: z.boolean().optional(),\n  })\n  .superRefine((checkout, context) => {\n    for (const validationIssue of checkoutTargetValidationIssues(checkout)) {\n      const message =\n        validationIssue.kind === 'project-with-connection'\n          ? 'Checkout project cannot be combined with a connection.'\n          : validationIssue.kind === 'project-with-repository'\n            ? 'Checkout project cannot be combined with a repository.'\n            : 'Checkout connection requires a repository.';\n      context.addIssue({\n        code: 'custom',\n        path: [validationIssue.path],\n        message,\n      });\n    }\n  });\n\ntype CheckoutConfig = z.infer<typeof checkoutConfigSchema>;\n\nexport async function createStepCheckoutSpec({\n  step,\n  workspaceId,\n  projectId,\n  triggerReference,\n  integrations,\n  projects,\n}: {\n  step: Step;\n  workspaceId: string;\n  projectId: string;\n  triggerReference?: WorkflowRunTriggerReference | null | undefined;\n  integrations: IntegrationsModuleClient;\n  projects: ProjectsModuleClient;\n}): Promise<{\n  spec: {\n    repositoryUrl: string;\n    ref: string;\n    credentials?: {username: string; token: string; expiresAt: Date};\n    gitAuthor?: {name: string; email: string};\n  };\n  fetchDepth: number;\n  persistCredentials: boolean;\n}> {\n  const checkout = parseCheckoutConfig(step);\n  const {project: defaultProject} = await projects.getProjectById({projectId});\n  if (defaultProject === null || defaultProject === undefined) {\n    throw new CheckoutIntentUnresolvedError({kind: 'project', value: projectId});\n  }\n\n  const target = await checkoutTarget({\n    checkout,\n    defaultProjectId: projectId,\n    defaultConnectionId: defaultProject.sourceConnectionId,\n    integrations,\n    workspaceId,\n  });\n  const resolvedTarget = await projects.resolveCheckoutTarget({\n    workspaceId,\n    defaults: {\n      connectionId: defaultProject.sourceConnectionId,\n      owner: defaultOwner(defaultProject.sourceRepositoryOwner, checkout.repository),\n    },\n    target,\n  });\n  const ref =\n    checkout.ref ??\n    (triggerReference?.project?.id === resolvedTarget.projectId\n      ? (triggerReference.commit ?? undefined)\n      : undefined);\n  const response = await integrations.createCheckoutSpec({\n    workspaceId,\n    connectionId: resolvedTarget.connectionId,\n    externalRepositoryId: resolvedTarget.externalRepositoryId,\n    ...(ref === undefined ? {} : {ref}),\n    permissions: checkout.permissions ?? {contents: 'read'},\n  });\n\n  return {\n    spec: {\n      repositoryUrl: response.repositoryUrl,\n      ref: response.ref,\n      ...(response.credentials\n        ? {\n            credentials: {\n              ...response.credentials,\n              expiresAt: new Date(response.credentials.expiresAt),\n            },\n          }\n        : {}),\n      ...(response.gitAuthor === undefined ? {} : {gitAuthor: response.gitAuthor}),\n    },\n    fetchDepth: checkout.fetch_depth ?? 1,\n    persistCredentials: checkout.persist_credentials ?? true,\n  };\n}\n\nfunction parseCheckoutConfig(step: Step): CheckoutConfig {\n  const result = checkoutConfigSchema.safeParse(step.config.checkout);\n  if (!result.success) {\n    throw new CheckoutConfigInvalidError(step.id);\n  }\n  return result.data;\n}\n\nasync function checkoutTarget(params: {\n  checkout: CheckoutConfig;\n  defaultProjectId: string;\n  defaultConnectionId: string;\n  integrations: IntegrationsModuleClient;\n  workspaceId: string;\n}) {\n  const {checkout} = params;\n  if (checkout.project !== undefined) return {project: checkout.project};\n  if (checkout.repository !== undefined) {\n    const connection =\n      checkout.connection === undefined\n        ? undefined\n        : await resolveConnectionId({\n            integrations: params.integrations,\n            workspaceId: params.workspaceId,\n            defaultConnectionId: params.defaultConnectionId,\n            slug: checkout.connection,\n          });\n    return {\n      ...(connection === undefined ? {} : {connection}),\n      repository: checkout.repository,\n    };\n  }\n  return {project: params.defaultProjectId};\n}\n\nasync function resolveConnectionId(params: {\n  integrations: IntegrationsModuleClient;\n  workspaceId: string;\n  defaultConnectionId: string;\n  slug: string;\n}): Promise<string> {\n  const connection = await params.integrations.resolveConnection({\n    workspaceId: params.workspaceId,\n    slug: params.slug,\n  });\n  if (connection === null) {\n    throw new CheckoutIntentUnresolvedError({kind: 'connection', value: params.slug});\n  }\n  return connection.id;\n}\n\nfunction defaultOwner(\n  projectOwner: string | null | undefined,\n  repository: string | undefined,\n): string {\n  if (projectOwner) return projectOwner;\n  const separator = repository?.indexOf('/') ?? -1;\n  if (separator > 0 && repository !== undefined) return repository.slice(0, separator);\n  return 'unknown';\n}\n"],"names":["checkoutTargetValidationIssues","z","CheckoutConfigInvalidError","CheckoutIntentUnresolvedError","checkoutConfigSchema","object","project","string","uuid","optional","connection","min","repository","ref","fetch_depth","number","int","nonnegative","permissions","contents","enum","persist_credentials","boolean","superRefine","checkout","context","validationIssue","message","kind","addIssue","code","path","createStepCheckoutSpec","step","workspaceId","projectId","triggerReference","integrations","projects","parseCheckoutConfig","defaultProject","getProjectById","undefined","value","target","checkoutTarget","defaultProjectId","defaultConnectionId","sourceConnectionId","resolvedTarget","resolveCheckoutTarget","defaults","connectionId","owner","defaultOwner","sourceRepositoryOwner","id","commit","response","createCheckoutSpec","externalRepositoryId","spec","repositoryUrl","credentials","expiresAt","Date","gitAuthor","fetchDepth","persistCredentials","result","safeParse","config","success","data","params","resolveConnectionId","slug","resolveConnection","projectOwner","separator","indexOf","slice"],"mappings":"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"}

package/dist/core/entities/job-execution.d.ts

@@ -1,17 +1,25 @@
 import type { JobStatus, JobStatusReason } from './job.js';
 import type { PersistedEvaluationTraceEntry } from './step.js';
+import type { WorkflowRunTriggerReference } from './workflow-run.js';
 export type JobExecutionStatus = Exclude<JobStatus, 'skipped'>;
 export interface WorkflowExecutionEvent {
     source: string;
     event: string;
     delivery_id: string;
     received_at: string;
+    project: WorkflowRunTriggerReference['project'];
+    repository: WorkflowRunTriggerReference['repository'];
+    ref: WorkflowRunTriggerReference['ref'];
+    commit: WorkflowRunTriggerReference['commit'];
     data: unknown;
 }
+export declare function normalizeWorkflowExecutionEvent(event: Omit<WorkflowExecutionEvent, 'project' | 'repository' | 'ref' | 'commit'> & Partial<Pick<WorkflowExecutionEvent, 'project' | 'repository' | 'ref' | 'commit'>>): WorkflowExecutionEvent;
 export interface JobExecution {
     id: string;
     jobId: string;
     sequence: number;
+    /** A dynamically resolved name; null means use the parent job's fallback. */
+    nameOverride: string | null;
     name: string;
     runner: string[] | null;
     status: JobExecutionStatus;

package/dist/core/entities/job-execution.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"job-execution.d.ts","sourceRoot":"","sources":["../../../src/core/entities/job-execution.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,SAAS,EAAE,eAAe,EAAC,MAAM,UAAU,CAAC;AACzD,OAAO,KAAK,EAAC,6BAA6B,EAAC,MAAM,WAAW,CAAC;AAE7D,MAAM,MAAM,kBAAkB,GAAG,OAAO,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;AAE/D,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,YAAY,EAAE,eAAe,GAAG,IAAI,CAAC;IACrC,aAAa,EAAE,sBAAsB,EAAE,CAAC;IACxC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACxC,eAAe,CAAC,EAAE,SAAS,6BAA6B,EAAE,GAAG,IAAI,CAAC;IAClE,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;IAChB,QAAQ,EAAE,IAAI,GAAG,IAAI,CAAC;IACtB,SAAS,EAAE,IAAI,GAAG,IAAI,CAAC;IACvB,UAAU,EAAE,IAAI,GAAG,IAAI,CAAC;IACxB,UAAU,EAAE,IAAI,GAAG,IAAI,CAAC;CACzB"}
+{"version":3,"file":"job-execution.d.ts","sourceRoot":"","sources":["../../../src/core/entities/job-execution.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,SAAS,EAAE,eAAe,EAAC,MAAM,UAAU,CAAC;AACzD,OAAO,KAAK,EAAC,6BAA6B,EAAC,MAAM,WAAW,CAAC;AAC7D,OAAO,KAAK,EAAC,2BAA2B,EAAC,MAAM,mBAAmB,CAAC;AAEnE,MAAM,MAAM,kBAAkB,GAAG,OAAO,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;AAE/D,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,2BAA2B,CAAC,SAAS,CAAC,CAAC;IAChD,UAAU,EAAE,2BAA2B,CAAC,YAAY,CAAC,CAAC;IACtD,GAAG,EAAE,2BAA2B,CAAC,KAAK,CAAC,CAAC;IACxC,MAAM,EAAE,2BAA2B,CAAC,QAAQ,CAAC,CAAC;IAC9C,IAAI,EAAE,OAAO,CAAC;CACf;AAED,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,IAAI,CAAC,sBAAsB,EAAE,SAAS,GAAG,YAAY,GAAG,KAAK,GAAG,QAAQ,CAAC,GAC9E,OAAO,CAAC,IAAI,CAAC,sBAAsB,EAAE,SAAS,GAAG,YAAY,GAAG,KAAK,GAAG,QAAQ,CAAC,CAAC,GACnF,sBAAsB,CAYxB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,6EAA6E;IAC7E,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,YAAY,EAAE,eAAe,GAAG,IAAI,CAAC;IACrC,aAAa,EAAE,sBAAsB,EAAE,CAAC;IACxC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACxC,eAAe,CAAC,EAAE,SAAS,6BAA6B,EAAE,GAAG,IAAI,CAAC;IAClE,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;IAChB,QAAQ,EAAE,IAAI,GAAG,IAAI,CAAC;IACtB,SAAS,EAAE,IAAI,GAAG,IAAI,CAAC;IACvB,UAAU,EAAE,IAAI,GAAG,IAAI,CAAC;IACxB,UAAU,EAAE,IAAI,GAAG,IAAI,CAAC;CACzB"}

package/dist/core/entities/job-execution.js

@@ -1,3 +1,15 @@
-export { };
+export function normalizeWorkflowExecutionEvent(event) {
+    return {
+        source: event.source,
+        event: event.event,
+        delivery_id: event.delivery_id,
+        received_at: event.received_at,
+        project: event.project ?? null,
+        repository: event.repository ?? null,
+        ref: event.ref ?? null,
+        commit: event.commit ?? null,
+        data: event.data
+    };
+}
 
 //# sourceMappingURL=job-execution.js.map

package/dist/core/entities/job-execution.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/core/entities/job-execution.ts"],"sourcesContent":["import type {JobStatus, JobStatusReason} from './job.js';\nimport type {PersistedEvaluationTraceEntry} from './step.js';\n\nexport type JobExecutionStatus = Exclude<JobStatus, 'skipped'>;\n\nexport interface WorkflowExecutionEvent {\n  source: string;\n  event: string;\n  delivery_id: string;\n  received_at: string;\n  data: unknown;\n}\n\nexport interface JobExecution {\n  id: string;\n  jobId: string;\n  sequence: number;\n  name: string;\n  runner: string[] | null;\n  status: JobExecutionStatus;\n  statusReason: JobStatusReason | null;\n  triggerEvents: WorkflowExecutionEvent[];\n  outputs: Record<string, unknown> | null;\n  evaluationTrace?: readonly PersistedEvaluationTraceEntry[] | null;\n  version: number;\n  createdAt: Date;\n  updatedAt: Date;\n  queuedAt: Date | null;\n  startedAt: Date | null;\n  finishedAt: Date | null;\n  timedOutAt: Date | null;\n}\n"],"names":[],"mappings":"AAaA,WAkBC"}
+{"version":3,"sources":["../../../src/core/entities/job-execution.ts"],"sourcesContent":["import type {JobStatus, JobStatusReason} from './job.js';\nimport type {PersistedEvaluationTraceEntry} from './step.js';\nimport type {WorkflowRunTriggerReference} from './workflow-run.js';\n\nexport type JobExecutionStatus = Exclude<JobStatus, 'skipped'>;\n\nexport interface WorkflowExecutionEvent {\n  source: string;\n  event: string;\n  delivery_id: string;\n  received_at: string;\n  project: WorkflowRunTriggerReference['project'];\n  repository: WorkflowRunTriggerReference['repository'];\n  ref: WorkflowRunTriggerReference['ref'];\n  commit: WorkflowRunTriggerReference['commit'];\n  data: unknown;\n}\n\nexport function normalizeWorkflowExecutionEvent(\n  event: Omit<WorkflowExecutionEvent, 'project' | 'repository' | 'ref' | 'commit'> &\n    Partial<Pick<WorkflowExecutionEvent, 'project' | 'repository' | 'ref' | 'commit'>>,\n): WorkflowExecutionEvent {\n  return {\n    source: event.source,\n    event: event.event,\n    delivery_id: event.delivery_id,\n    received_at: event.received_at,\n    project: event.project ?? null,\n    repository: event.repository ?? null,\n    ref: event.ref ?? null,\n    commit: event.commit ?? null,\n    data: event.data,\n  };\n}\n\nexport interface JobExecution {\n  id: string;\n  jobId: string;\n  sequence: number;\n  /** A dynamically resolved name; null means use the parent job's fallback. */\n  nameOverride: string | null;\n  name: string;\n  runner: string[] | null;\n  status: JobExecutionStatus;\n  statusReason: JobStatusReason | null;\n  triggerEvents: WorkflowExecutionEvent[];\n  outputs: Record<string, unknown> | null;\n  evaluationTrace?: readonly PersistedEvaluationTraceEntry[] | null;\n  version: number;\n  createdAt: Date;\n  updatedAt: Date;\n  queuedAt: Date | null;\n  startedAt: Date | null;\n  finishedAt: Date | null;\n  timedOutAt: Date | null;\n}\n"],"names":["normalizeWorkflowExecutionEvent","event","source","delivery_id","received_at","project","repository","ref","commit","data"],"mappings":"AAkBA,OAAO,SAASA,gCACdC,KACoF;IAEpF,OAAO;QACLC,QAAQD,MAAMC,MAAM;QACpBD,OAAOA,MAAMA,KAAK;QAClBE,aAAaF,MAAME,WAAW;QAC9BC,aAAaH,MAAMG,WAAW;QAC9BC,SAASJ,MAAMI,OAAO,IAAI;QAC1BC,YAAYL,MAAMK,UAAU,IAAI;QAChCC,KAAKN,MAAMM,GAAG,IAAI;QAClBC,QAAQP,MAAMO,MAAM,IAAI;QACxBC,MAAMR,MAAMQ,IAAI;IAClB;AACF"}

package/dist/core/entities/job-listener-event.d.ts

@@ -1,3 +1,4 @@
+import type { WorkflowRunTriggerReference } from './workflow-run.js';
 export type JobListenerEventDisposition = 'fire' | 'resolve';
 export interface JobListenerEvent {
     id: string;
@@ -7,6 +8,7 @@ export interface JobListenerEvent {
     deliveryId: string;
     source: string;
     event: string;
+    triggerReference: WorkflowRunTriggerReference | null;
     payload: unknown;
     receivedAt: Date;
     consumedByExecutionId: string | null;

package/dist/core/entities/job-listener-event.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"job-listener-event.d.ts","sourceRoot":"","sources":["../../../src/core/entities/job-listener-event.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,2BAA2B,GAAG,MAAM,GAAG,SAAS,CAAC;AAE7D,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,2BAA2B,CAAC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,IAAI,CAAC;IACjB,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,SAAS,EAAE,IAAI,CAAC;CACjB"}
+{"version":3,"file":"job-listener-event.d.ts","sourceRoot":"","sources":["../../../src/core/entities/job-listener-event.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,2BAA2B,EAAC,MAAM,mBAAmB,CAAC;AAEnE,MAAM,MAAM,2BAA2B,GAAG,MAAM,GAAG,SAAS,CAAC;AAE7D,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,2BAA2B,CAAC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB,EAAE,2BAA2B,GAAG,IAAI,CAAC;IACrD,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,IAAI,CAAC;IACjB,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,SAAS,EAAE,IAAI,CAAC;CACjB"}

package/dist/core/entities/job-listener-event.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/core/entities/job-listener-event.ts"],"sourcesContent":["export type JobListenerEventDisposition = 'fire' | 'resolve';\n\nexport interface JobListenerEvent {\n  id: string;\n  jobId: string;\n  disposition: JobListenerEventDisposition;\n  eventRef: string;\n  deliveryId: string;\n  source: string;\n  event: string;\n  payload: unknown;\n  receivedAt: Date;\n  consumedByExecutionId: string | null;\n  createdAt: Date;\n}\n"],"names":[],"mappings":"AAEA,WAYC"}
+{"version":3,"sources":["../../../src/core/entities/job-listener-event.ts"],"sourcesContent":["import type {WorkflowRunTriggerReference} from './workflow-run.js';\n\nexport type JobListenerEventDisposition = 'fire' | 'resolve';\n\nexport interface JobListenerEvent {\n  id: string;\n  jobId: string;\n  disposition: JobListenerEventDisposition;\n  eventRef: string;\n  deliveryId: string;\n  source: string;\n  event: string;\n  triggerReference: WorkflowRunTriggerReference | null;\n  payload: unknown;\n  receivedAt: Date;\n  consumedByExecutionId: string | null;\n  createdAt: Date;\n}\n"],"names":[],"mappings":"AAIA,WAaC"}