@shipfox/api-definitions 11.0.0 → 12.0.0

package/.turbo/turbo-build.log

@@ -1,19 +1,20 @@
 $ shipfox-swc && shipfox-temporal-bundle dist/temporal/workflows/index.js
-Successfully compiled: 72 files with swc (398.18ms)
-2026-07-28T22:45:36.209Z [INFO] asset workflow-bundle-2e2f2f4d6c035dc8e198.js 3.18 MiB [emitted] [immutable] (name: main)
-orphan modules 33.5 KiB [orphan] 21 modules
+Successfully compiled: 74 files with swc (337.6ms)
+2026-08-04T08:17:09.285Z [INFO] asset workflow-bundle-db3e4e474e0c4d6a3553.js 4.01 MiB [emitted] [immutable] (name: main)
+orphan modules 322 KiB [orphan] 82 modules
 runtime modules 1.13 KiB 5 modules
-modules by path ../../../node_modules/.pnpm/ 970 KiB 196 modules
-modules by path ./dist/ 4.72 KiB
-  modules by path ./dist/temporal/workflows/*.js 3.28 KiB
-    ./dist/temporal/workflows/index.js 64 bytes [built] [code generated]
-    ./dist/temporal/workflows/definition-sync.js 3.22 KiB [built] [code generated]
+modules by path ../../../node_modules/.pnpm/ 1.21 MiB 214 modules
+modules by path ../definitions-dto/dist/ 7.85 KiB
+  modules by path ../definitions-dto/dist/*.js 3.48 KiB 3 modules
+  modules by path ../definitions-dto/dist/schemas/*.js 4.37 KiB 3 modules
+modules by path ./dist/ 5.46 KiB
+  modules by path ./dist/temporal/workflows/*.js 3.34 KiB 2 modules
   ./dist/temporal/workflows/index-autogenerated-entrypoint.cjs 936 bytes [built] [code generated]
-  ./dist/core/entities/sync-state.js 543 bytes [built] [code generated]
+  ./dist/core/entities/sync-state.js 1.2 KiB [built] [code generated]
 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 7774 ms
-2026-07-28T22:45:36.223Z [INFO] Workflow bundle created { size: '3.18MB' }
-/home/runner/work/shipfox/shipfox/libs/api/definitions/dist/temporal/workflows/index.js: 3332889 bytes
+webpack 5.107.2 compiled successfully in 5689 ms
+2026-08-04T08:17:09.294Z [INFO] Workflow bundle created { size: '4.01MB' }
+/home/runner/work/shipfox/shipfox/libs/api/definitions/dist/temporal/workflows/index.js: 4207937 bytes

package/CHANGELOG.md

@@ -1,5 +1,86 @@
 # @shipfox/api-definitions
 
+## 12.0.0
+
+### Major Changes
+
+- 7c4116e: Align predicate property types with their runtime shapes, replace `run.run_name` with `run.workflow_name`, and remove `failed` from `executions` entries.
+- adf07e7: Cut over workflow and job display names to literal-only `name` fields, with runtime interpolation supported through `run_name` and `execution_name`.
+
+### 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.
+- 3d91d1d: Allow workflow context roots in interpolatable fields while preserving host and availability validation. Keep model and provider selection restricted to workflow-authored context so external payloads and step outputs cannot steer agent execution.
+- 89f2c18: Expose non-fatal definition validation warnings from the `/validate` response without
+  preventing workflow synchronization. Persistence and surfacing for repo-synced definitions
+  remain a follow-up.
+- 045895c: Remove the unused workflow context trust metadata and related public exports. Allow
+  external context in agent model and provider interpolations now that interpolation
+  fields no longer enforce source tiers.
+- 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.
+- 3f781ee: Add workflow run and job execution naming fields to the authoring, expression, and normalized definition contracts.
+- 9fdd5e4: Persist definition validation warnings from repository syncs and surface them on the workflow page without changing sync success or run creation behavior.
+- 35a42bd: Resolve run and agent step working directories against the runner job workspace.
+- 032d316: Scope checkout credential minting to the currently running checkout step and return its fetch depth.
+- 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.
+
+### Patch Changes
+
+- 01c3dbc: Allow workflow variables in job, step, gate, and listener predicates while preserving the standard availability error for trigger filters.
+- e95fdf4: Report an explicit model validation issue for checkout opt-out and checkout steps until their normalization and runtime support lands.
+- 285fff2: Persist resolved workflow job execution names and handle dynamic naming failures consistently.
+- 4d246d4: Align predicate validation and runtime evaluation with field-specific context contracts.
+- 28daafe: Validate literal agent model and provider values during workflow authoring.
+- 4444079: Warn when shell positions re-execute workflow-controlled values as code.
+- Updated dependencies [ee2ce67]
+- Updated dependencies [7c4116e]
+- Updated dependencies [5d2c9cf]
+- Updated dependencies [e95fdf4]
+- Updated dependencies [3d91d1d]
+- Updated dependencies [89f2c18]
+- Updated dependencies [045895c]
+- Updated dependencies [f78740d]
+- Updated dependencies [9e1d599]
+- Updated dependencies [dea1ffd]
+- Updated dependencies [adf07e7]
+- Updated dependencies [3f781ee]
+- Updated dependencies [9fdd5e4]
+- Updated dependencies [285fff2]
+- Updated dependencies [4d246d4]
+- Updated dependencies [4eb18b8]
+- Updated dependencies [28daafe]
+- Updated dependencies [f13e8bb]
+- Updated dependencies [4444079]
+- Updated dependencies [869a792]
+- Updated dependencies [8cc5a36]
+- 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]
+  - @shipfox/workflow-document@3.0.0
+  - @shipfox/api-definitions-dto@12.0.0
+  - @shipfox/api-agent-dto@12.0.0
+  - @shipfox/expression@2.0.0
+  - @shipfox/inter-module@0.2.3
+  - @shipfox/node-fastify@0.4.1
+  - @shipfox/node-module@1.0.5
+  - @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/api-secrets-dto@12.0.0
+  - @shipfox/node-drizzle@0.3.5
+  - @shipfox/node-outbox@0.2.6
+
 ## 11.0.0
 
 ### Patch Changes

package/dist/core/entities/index.d.ts

@@ -1,5 +1,6 @@
 export * from './integration-context.js';
 export * from './sync-state.js';
+export * from './validation-warning.js';
 export * from './workflow-definition.js';
 export * from './workflow-model.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/core/entities/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/entities/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,iBAAiB,CAAC;AAChC,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/entities/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,iBAAiB,CAAC;AAChC,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC"}

package/dist/core/entities/index.js

@@ -1,5 +1,6 @@
 export * from './integration-context.js';
 export * from './sync-state.js';
+export * from './validation-warning.js';
 export * from './workflow-definition.js';
 export * from './workflow-model.js';
 

package/dist/core/entities/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/core/entities/index.ts"],"sourcesContent":["export * from './integration-context.js';\nexport * from './sync-state.js';\nexport * from './workflow-definition.js';\nexport * from './workflow-model.js';\n"],"names":[],"mappings":"AAAA,cAAc,2BAA2B;AACzC,cAAc,kBAAkB;AAChC,cAAc,2BAA2B;AACzC,cAAc,sBAAsB"}
+{"version":3,"sources":["../../../src/core/entities/index.ts"],"sourcesContent":["export * from './integration-context.js';\nexport * from './sync-state.js';\nexport * from './validation-warning.js';\nexport * from './workflow-definition.js';\nexport * from './workflow-model.js';\n"],"names":[],"mappings":"AAAA,cAAc,2BAA2B;AACzC,cAAc,kBAAkB;AAChC,cAAc,0BAA0B;AACxC,cAAc,2BAA2B;AACzC,cAAc,sBAAsB"}

package/dist/core/entities/sync-state.d.ts

@@ -1,4 +1,7 @@
+import type { ValidationWarning } from './validation-warning.js';
 export type DefinitionSyncStatus = 'pending' | 'syncing' | 'succeeded' | 'failed';
+export type DefinitionSyncWarning = ValidationWarning;
+export declare function limitDefinitionSyncWarnings(warnings: readonly DefinitionSyncWarning[]): DefinitionSyncWarning[];
 export declare const DEFINITION_SYNC_ERROR_CODES: readonly ["no-workflow-files", "invalid-definition", "provider-repository-not-found", "provider-file-not-found", "provider-access-denied", "provider-rate-limited", "provider-timeout", "provider-unavailable", "provider-malformed-response", "content-too-large", "too-many-files", "connection-unavailable", "unknown"];
 export type DefinitionSyncErrorCode = (typeof DEFINITION_SYNC_ERROR_CODES)[number];
 export declare function isDefinitionSyncErrorCode(value: unknown): value is DefinitionSyncErrorCode;
@@ -11,6 +14,7 @@ export interface DefinitionSyncState {
     status: DefinitionSyncStatus;
     lastErrorCode: DefinitionSyncErrorCode | null;
     lastErrorMessage: string | null;
+    warnings: DefinitionSyncWarning[];
     startedAt: Date | null;
     finishedAt: Date | null;
     createdAt: Date;

package/dist/core/entities/sync-state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sync-state.d.ts","sourceRoot":"","sources":["../../../src/core/entities/sync-state.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,oBAAoB,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;AAElF,eAAO,MAAM,2BAA2B,4TAc9B,CAAC;AAEX,MAAM,MAAM,uBAAuB,GAAG,CAAC,OAAO,2BAA2B,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnF,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,uBAAuB,CAI1F;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,0BAA0B,EAAE,MAAM,CAAC;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,oBAAoB,CAAC;IAC7B,aAAa,EAAE,uBAAuB,GAAG,IAAI,CAAC;IAC9C,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,SAAS,EAAE,IAAI,GAAG,IAAI,CAAC;IACvB,UAAU,EAAE,IAAI,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;CACjB"}
+{"version":3,"file":"sync-state.d.ts","sourceRoot":"","sources":["../../../src/core/entities/sync-state.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,yBAAyB,CAAC;AAE/D,MAAM,MAAM,oBAAoB,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;AAElF,MAAM,MAAM,qBAAqB,GAAG,iBAAiB,CAAC;AAEtD,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,SAAS,qBAAqB,EAAE,GACzC,qBAAqB,EAAE,CAQzB;AAED,eAAO,MAAM,2BAA2B,4TAc9B,CAAC;AAEX,MAAM,MAAM,uBAAuB,GAAG,CAAC,OAAO,2BAA2B,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnF,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,uBAAuB,CAI1F;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,0BAA0B,EAAE,MAAM,CAAC;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,oBAAoB,CAAC;IAC7B,aAAa,EAAE,uBAAuB,GAAG,IAAI,CAAC;IAC9C,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,EAAE,qBAAqB,EAAE,CAAC;IAClC,SAAS,EAAE,IAAI,GAAG,IAAI,CAAC;IACvB,UAAU,EAAE,IAAI,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;CACjB"}

package/dist/core/entities/sync-state.js

@@ -1,3 +1,13 @@
+import { DEFINITION_SYNC_WARNING_CODE_MAX_LENGTH, DEFINITION_SYNC_WARNING_MESSAGE_MAX_LENGTH, DEFINITION_SYNC_WARNING_PATH_MAX_LENGTH, DEFINITION_SYNC_WARNINGS_MAX_COUNT } from '@shipfox/api-definitions-dto';
+export function limitDefinitionSyncWarnings(warnings) {
+    return warnings.slice(0, DEFINITION_SYNC_WARNINGS_MAX_COUNT).map((warning)=>({
+            code: warning.code.slice(0, DEFINITION_SYNC_WARNING_CODE_MAX_LENGTH),
+            message: warning.message.slice(0, DEFINITION_SYNC_WARNING_MESSAGE_MAX_LENGTH),
+            ...warning.path === undefined ? {} : {
+                path: warning.path.slice(0, DEFINITION_SYNC_WARNING_PATH_MAX_LENGTH)
+            }
+        }));
+}
 export const DEFINITION_SYNC_ERROR_CODES = [
     'no-workflow-files',
     'invalid-definition',

package/dist/core/entities/sync-state.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/core/entities/sync-state.ts"],"sourcesContent":["export type DefinitionSyncStatus = 'pending' | 'syncing' | 'succeeded' | 'failed';\n\nexport const DEFINITION_SYNC_ERROR_CODES = [\n  'no-workflow-files',\n  'invalid-definition',\n  'provider-repository-not-found',\n  'provider-file-not-found',\n  'provider-access-denied',\n  'provider-rate-limited',\n  'provider-timeout',\n  'provider-unavailable',\n  'provider-malformed-response',\n  'content-too-large',\n  'too-many-files',\n  'connection-unavailable',\n  'unknown',\n] as const;\n\nexport type DefinitionSyncErrorCode = (typeof DEFINITION_SYNC_ERROR_CODES)[number];\n\nexport function isDefinitionSyncErrorCode(value: unknown): value is DefinitionSyncErrorCode {\n  return (\n    typeof value === 'string' && (DEFINITION_SYNC_ERROR_CODES as readonly string[]).includes(value)\n  );\n}\n\nexport interface DefinitionSyncState {\n  id: string;\n  projectId: string;\n  sourceConnectionId: string;\n  sourceExternalRepositoryId: string;\n  ref: string;\n  status: DefinitionSyncStatus;\n  lastErrorCode: DefinitionSyncErrorCode | null;\n  lastErrorMessage: string | null;\n  startedAt: Date | null;\n  finishedAt: Date | null;\n  createdAt: Date;\n  updatedAt: Date;\n}\n"],"names":["DEFINITION_SYNC_ERROR_CODES","isDefinitionSyncErrorCode","value","includes"],"mappings":"AAEA,OAAO,MAAMA,8BAA8B;IACzC;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;CACD,CAAU;AAIX,OAAO,SAASC,0BAA0BC,KAAc;IACtD,OACE,OAAOA,UAAU,YAAY,AAACF,4BAAkDG,QAAQ,CAACD;AAE7F"}
+{"version":3,"sources":["../../../src/core/entities/sync-state.ts"],"sourcesContent":["import {\n  DEFINITION_SYNC_WARNING_CODE_MAX_LENGTH,\n  DEFINITION_SYNC_WARNING_MESSAGE_MAX_LENGTH,\n  DEFINITION_SYNC_WARNING_PATH_MAX_LENGTH,\n  DEFINITION_SYNC_WARNINGS_MAX_COUNT,\n} from '@shipfox/api-definitions-dto';\nimport type {ValidationWarning} from './validation-warning.js';\n\nexport type DefinitionSyncStatus = 'pending' | 'syncing' | 'succeeded' | 'failed';\n\nexport type DefinitionSyncWarning = ValidationWarning;\n\nexport function limitDefinitionSyncWarnings(\n  warnings: readonly DefinitionSyncWarning[],\n): DefinitionSyncWarning[] {\n  return warnings.slice(0, DEFINITION_SYNC_WARNINGS_MAX_COUNT).map((warning) => ({\n    code: warning.code.slice(0, DEFINITION_SYNC_WARNING_CODE_MAX_LENGTH),\n    message: warning.message.slice(0, DEFINITION_SYNC_WARNING_MESSAGE_MAX_LENGTH),\n    ...(warning.path === undefined\n      ? {}\n      : {path: warning.path.slice(0, DEFINITION_SYNC_WARNING_PATH_MAX_LENGTH)}),\n  }));\n}\n\nexport const DEFINITION_SYNC_ERROR_CODES = [\n  'no-workflow-files',\n  'invalid-definition',\n  'provider-repository-not-found',\n  'provider-file-not-found',\n  'provider-access-denied',\n  'provider-rate-limited',\n  'provider-timeout',\n  'provider-unavailable',\n  'provider-malformed-response',\n  'content-too-large',\n  'too-many-files',\n  'connection-unavailable',\n  'unknown',\n] as const;\n\nexport type DefinitionSyncErrorCode = (typeof DEFINITION_SYNC_ERROR_CODES)[number];\n\nexport function isDefinitionSyncErrorCode(value: unknown): value is DefinitionSyncErrorCode {\n  return (\n    typeof value === 'string' && (DEFINITION_SYNC_ERROR_CODES as readonly string[]).includes(value)\n  );\n}\n\nexport interface DefinitionSyncState {\n  id: string;\n  projectId: string;\n  sourceConnectionId: string;\n  sourceExternalRepositoryId: string;\n  ref: string;\n  status: DefinitionSyncStatus;\n  lastErrorCode: DefinitionSyncErrorCode | null;\n  lastErrorMessage: string | null;\n  warnings: DefinitionSyncWarning[];\n  startedAt: Date | null;\n  finishedAt: Date | null;\n  createdAt: Date;\n  updatedAt: Date;\n}\n"],"names":["DEFINITION_SYNC_WARNING_CODE_MAX_LENGTH","DEFINITION_SYNC_WARNING_MESSAGE_MAX_LENGTH","DEFINITION_SYNC_WARNING_PATH_MAX_LENGTH","DEFINITION_SYNC_WARNINGS_MAX_COUNT","limitDefinitionSyncWarnings","warnings","slice","map","warning","code","message","path","undefined","DEFINITION_SYNC_ERROR_CODES","isDefinitionSyncErrorCode","value","includes"],"mappings":"AAAA,SACEA,uCAAuC,EACvCC,0CAA0C,EAC1CC,uCAAuC,EACvCC,kCAAkC,QAC7B,+BAA+B;AAOtC,OAAO,SAASC,4BACdC,QAA0C;IAE1C,OAAOA,SAASC,KAAK,CAAC,GAAGH,oCAAoCI,GAAG,CAAC,CAACC,UAAa,CAAA;YAC7EC,MAAMD,QAAQC,IAAI,CAACH,KAAK,CAAC,GAAGN;YAC5BU,SAASF,QAAQE,OAAO,CAACJ,KAAK,CAAC,GAAGL;YAClC,GAAIO,QAAQG,IAAI,KAAKC,YACjB,CAAC,IACD;gBAACD,MAAMH,QAAQG,IAAI,CAACL,KAAK,CAAC,GAAGJ;YAAwC,CAAC;QAC5E,CAAA;AACF;AAEA,OAAO,MAAMW,8BAA8B;IACzC;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;CACD,CAAU;AAIX,OAAO,SAASC,0BAA0BC,KAAc;IACtD,OACE,OAAOA,UAAU,YAAY,AAACF,4BAAkDG,QAAQ,CAACD;AAE7F"}

package/dist/core/entities/validation-warning.d.ts

@@ -0,0 +1,6 @@
+export interface ValidationWarning {
+    code: string;
+    message: string;
+    path?: string | undefined;
+}
+//# sourceMappingURL=validation-warning.d.ts.map

package/dist/core/entities/validation-warning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-warning.d.ts","sourceRoot":"","sources":["../../../src/core/entities/validation-warning.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B"}

package/dist/core/entities/validation-warning.js

@@ -0,0 +1,3 @@
+export { };
+
+//# sourceMappingURL=validation-warning.js.map

package/dist/core/entities/validation-warning.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/core/entities/validation-warning.ts"],"sourcesContent":["export interface ValidationWarning {\n  code: string;\n  message: string;\n  path?: string | undefined;\n}\n"],"names":[],"mappings":"AAAA,WAIC"}

package/dist/core/parse-definition.d.ts

@@ -1,9 +1,11 @@
-import type { AgentValidationCatalog } from '@shipfox/api-agent-dto/inter-module';
-import type { IntegrationValidationContext } from './entities/integration-context.js';
+import type { ValidationWarning } from './entities/validation-warning.js';
 import type { WorkflowDefinitionPayload } from './entities/workflow-definition.js';
-export declare function parseDefinition(yamlString: string, options: {
-    defaultRunnerLabels?: readonly string[];
-    agentValidationCatalog: AgentValidationCatalog;
-    integrationValidationContext?: IntegrationValidationContext;
-}): WorkflowDefinitionPayload;
+import { type DefinitionValidationOptions } from './validate-definition.js';
+export interface ParsedDefinition extends WorkflowDefinitionPayload {
+    warnings: ValidationWarning[];
+}
+export type ParseDefinitionOptions = DefinitionValidationOptions;
+export declare function parseDefinitionWithWarnings(yamlString: string, options: ParseDefinitionOptions): ParsedDefinition;
+export declare function parseDefinition(yamlString: string, options: ParseDefinitionOptions): WorkflowDefinitionPayload;
+export declare function stripDefinitionWarnings(parsed: ParsedDefinition): WorkflowDefinitionPayload;
 //# sourceMappingURL=parse-definition.d.ts.map

package/dist/core/parse-definition.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parse-definition.d.ts","sourceRoot":"","sources":["../../src/core/parse-definition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,sBAAsB,EAAC,MAAM,qCAAqC,CAAC;AAChF,OAAO,KAAK,EAAC,4BAA4B,EAAC,MAAM,mCAAmC,CAAC;AACpF,OAAO,KAAK,EAAC,yBAAyB,EAAC,MAAM,mCAAmC,CAAC;AAIjF,wBAAgB,eAAe,CAC7B,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE;IACP,mBAAmB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,sBAAsB,EAAE,sBAAsB,CAAC;IAC/C,4BAA4B,CAAC,EAAE,4BAA4B,CAAC;CAC7D,GACA,yBAAyB,CAc3B"}
+{"version":3,"file":"parse-definition.d.ts","sourceRoot":"","sources":["../../src/core/parse-definition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,kCAAkC,CAAC;AACxE,OAAO,KAAK,EAAC,yBAAyB,EAAC,MAAM,mCAAmC,CAAC;AAEjF,OAAO,EAAC,KAAK,2BAA2B,EAAqB,MAAM,0BAA0B,CAAC;AAE9F,MAAM,WAAW,gBAAiB,SAAQ,yBAAyB;IACjE,QAAQ,EAAE,iBAAiB,EAAE,CAAC;CAC/B;AAED,MAAM,MAAM,sBAAsB,GAAG,2BAA2B,CAAC;AAEjE,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,sBAAsB,GAC9B,gBAAgB,CAelB;AAED,wBAAgB,eAAe,CAC7B,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,sBAAsB,GAC9B,yBAAyB,CAG3B;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,gBAAgB,GAAG,yBAAyB,CAM3F"}

package/dist/core/parse-definition.js

@@ -1,6 +1,6 @@
 import { DefinitionParseError } from './errors.js';
 import { validateDefinition } from './validate-definition.js';
-export function parseDefinition(yamlString, options) {
+export function parseDefinitionWithWarnings(yamlString, options) {
     const result = validateDefinition(yamlString, options);
     if (!result.valid) {
         throw new DefinitionParseError(result.errors[0]?.message ?? 'Invalid definition', result.errors);
@@ -10,7 +10,19 @@ export function parseDefinition(yamlString, options) {
         sourceSnapshot: {
             content: yamlString,
             format: 'yaml'
-        }
+        },
+        warnings: result.warnings
+    };
+}
+export function parseDefinition(yamlString, options) {
+    const parsed = parseDefinitionWithWarnings(yamlString, options);
+    return stripDefinitionWarnings(parsed);
+}
+export function stripDefinitionWarnings(parsed) {
+    return {
+        document: parsed.document,
+        model: parsed.model,
+        sourceSnapshot: parsed.sourceSnapshot ?? null
     };
 }
 

package/dist/core/parse-definition.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/core/parse-definition.ts"],"sourcesContent":["import type {AgentValidationCatalog} from '@shipfox/api-agent-dto/inter-module';\nimport type {IntegrationValidationContext} from './entities/integration-context.js';\nimport type {WorkflowDefinitionPayload} from './entities/workflow-definition.js';\nimport {DefinitionParseError} from './errors.js';\nimport {validateDefinition} from './validate-definition.js';\n\nexport function parseDefinition(\n  yamlString: string,\n  options: {\n    defaultRunnerLabels?: readonly string[];\n    agentValidationCatalog: AgentValidationCatalog;\n    integrationValidationContext?: IntegrationValidationContext;\n  },\n): WorkflowDefinitionPayload {\n  const result = validateDefinition(yamlString, options);\n\n  if (!result.valid) {\n    throw new DefinitionParseError(\n      result.errors[0]?.message ?? 'Invalid definition',\n      result.errors,\n    );\n  }\n\n  return {\n    ...result.definition,\n    sourceSnapshot: {content: yamlString, format: 'yaml'},\n  };\n}\n"],"names":["DefinitionParseError","validateDefinition","parseDefinition","yamlString","options","result","valid","errors","message","definition","sourceSnapshot","content","format"],"mappings":"AAGA,SAAQA,oBAAoB,QAAO,cAAc;AACjD,SAAQC,kBAAkB,QAAO,2BAA2B;AAE5D,OAAO,SAASC,gBACdC,UAAkB,EAClBC,OAIC;IAED,MAAMC,SAASJ,mBAAmBE,YAAYC;IAE9C,IAAI,CAACC,OAAOC,KAAK,EAAE;QACjB,MAAM,IAAIN,qBACRK,OAAOE,MAAM,CAAC,EAAE,EAAEC,WAAW,sBAC7BH,OAAOE,MAAM;IAEjB;IAEA,OAAO;QACL,GAAGF,OAAOI,UAAU;QACpBC,gBAAgB;YAACC,SAASR;YAAYS,QAAQ;QAAM;IACtD;AACF"}
+{"version":3,"sources":["../../src/core/parse-definition.ts"],"sourcesContent":["import type {ValidationWarning} from './entities/validation-warning.js';\nimport type {WorkflowDefinitionPayload} from './entities/workflow-definition.js';\nimport {DefinitionParseError} from './errors.js';\nimport {type DefinitionValidationOptions, validateDefinition} from './validate-definition.js';\n\nexport interface ParsedDefinition extends WorkflowDefinitionPayload {\n  warnings: ValidationWarning[];\n}\n\nexport type ParseDefinitionOptions = DefinitionValidationOptions;\n\nexport function parseDefinitionWithWarnings(\n  yamlString: string,\n  options: ParseDefinitionOptions,\n): ParsedDefinition {\n  const result = validateDefinition(yamlString, options);\n\n  if (!result.valid) {\n    throw new DefinitionParseError(\n      result.errors[0]?.message ?? 'Invalid definition',\n      result.errors,\n    );\n  }\n\n  return {\n    ...result.definition,\n    sourceSnapshot: {content: yamlString, format: 'yaml'},\n    warnings: result.warnings,\n  };\n}\n\nexport function parseDefinition(\n  yamlString: string,\n  options: ParseDefinitionOptions,\n): WorkflowDefinitionPayload {\n  const parsed = parseDefinitionWithWarnings(yamlString, options);\n  return stripDefinitionWarnings(parsed);\n}\n\nexport function stripDefinitionWarnings(parsed: ParsedDefinition): WorkflowDefinitionPayload {\n  return {\n    document: parsed.document,\n    model: parsed.model,\n    sourceSnapshot: parsed.sourceSnapshot ?? null,\n  };\n}\n"],"names":["DefinitionParseError","validateDefinition","parseDefinitionWithWarnings","yamlString","options","result","valid","errors","message","definition","sourceSnapshot","content","format","warnings","parseDefinition","parsed","stripDefinitionWarnings","document","model"],"mappings":"AAEA,SAAQA,oBAAoB,QAAO,cAAc;AACjD,SAA0CC,kBAAkB,QAAO,2BAA2B;AAQ9F,OAAO,SAASC,4BACdC,UAAkB,EAClBC,OAA+B;IAE/B,MAAMC,SAASJ,mBAAmBE,YAAYC;IAE9C,IAAI,CAACC,OAAOC,KAAK,EAAE;QACjB,MAAM,IAAIN,qBACRK,OAAOE,MAAM,CAAC,EAAE,EAAEC,WAAW,sBAC7BH,OAAOE,MAAM;IAEjB;IAEA,OAAO;QACL,GAAGF,OAAOI,UAAU;QACpBC,gBAAgB;YAACC,SAASR;YAAYS,QAAQ;QAAM;QACpDC,UAAUR,OAAOQ,QAAQ;IAC3B;AACF;AAEA,OAAO,SAASC,gBACdX,UAAkB,EAClBC,OAA+B;IAE/B,MAAMW,SAASb,4BAA4BC,YAAYC;IACvD,OAAOY,wBAAwBD;AACjC;AAEA,OAAO,SAASC,wBAAwBD,MAAwB;IAC9D,OAAO;QACLE,UAAUF,OAAOE,QAAQ;QACzBC,OAAOH,OAAOG,KAAK;QACnBR,gBAAgBK,OAAOL,cAAc,IAAI;IAC3C;AACF"}

package/dist/core/sync-definitions.d.ts

@@ -1,6 +1,7 @@
 import type { AgentValidationCatalog } from '@shipfox/api-agent-dto/inter-module';
 import type { IntegrationValidationContext } from './entities/integration-context.js';
 import type { DefinitionSyncErrorCode } from './entities/sync-state.js';
+import type { ValidationWarning } from './entities/validation-warning.js';
 import type { WorkflowDefinitionPayload } from './entities/workflow-definition.js';
 import type { DefinitionsSourceControl } from './integrations.js';
 export declare const DEFAULT_WORKFLOW_PATH = ".shipfox/workflows/";
@@ -30,6 +31,7 @@ export interface ParsedWorkflow {
     name: string;
     definition: WorkflowDefinitionPayload;
     contentHash: string;
+    warnings: ValidationWarning[];
 }
 export interface FetchAndParseWorkflowsParams extends SyncSourceContext {
     ref: string;

package/dist/core/sync-definitions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sync-definitions.d.ts","sourceRoot":"","sources":["../../src/core/sync-definitions.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,sBAAsB,EAAC,MAAM,qCAAqC,CAAC;AAIhF,OAAO,KAAK,EAAC,4BAA4B,EAAC,MAAM,mCAAmC,CAAC;AACpF,OAAO,KAAK,EAAC,uBAAuB,EAAC,MAAM,0BAA0B,CAAC;AACtE,OAAO,KAAK,EAAC,yBAAyB,EAAC,MAAM,mCAAmC,CAAC;AAGjF,OAAO,KAAK,EAAC,wBAAwB,EAAC,MAAM,mBAAmB,CAAC;AAGhE,eAAO,MAAM,qBAAqB,wBAAwB,CAAC;AAC3D,eAAO,MAAM,kBAAkB,MAAM,CAAC;AACtC,eAAO,MAAM,uBAAuB,UAAY,CAAC;AACjD,eAAO,MAAM,sBAAsB,IAAI,CAAC;AACxC,eAAO,MAAM,mBAAmB,mBAAmB,CAAC;AAEpD,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,0BAA0B,EAAE,MAAM,CAAC;IACnC,aAAa,EAAE,wBAAwB,CAAC;CACzC;AAED,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;CACb;AAED,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAO9F;AAED,MAAM,WAAW,2BAA4B,SAAQ,iBAAiB;IACpE,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC;AAED,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,2BAA2B,GAClC,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAC,CAAC,CA4B5B;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,yBAAyB,CAAC;IACtC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,4BAA6B,SAAQ,iBAAiB;IACrE,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IAClD,sBAAsB,EAAE,sBAAsB,CAAC;IAC/C,gCAAgC,CAAC,EAAE,CAAC,MAAM,OAAO,CAAC,4BAA4B,CAAC,CAAC,GAAG,SAAS,CAAC;CAC9F;AAED,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,4BAA4B,GACnC,OAAO,CAAC,cAAc,EAAE,CAAC,CAkD3B;AA6BD,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,uBAAuB,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,yBAAyB,CA+B7E"}
+{"version":3,"file":"sync-definitions.d.ts","sourceRoot":"","sources":["../../src/core/sync-definitions.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,sBAAsB,EAAC,MAAM,qCAAqC,CAAC;AAIhF,OAAO,KAAK,EAAC,4BAA4B,EAAC,MAAM,mCAAmC,CAAC;AACpF,OAAO,KAAK,EAAC,uBAAuB,EAAC,MAAM,0BAA0B,CAAC;AACtE,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,kCAAkC,CAAC;AACxE,OAAO,KAAK,EAAC,yBAAyB,EAAC,MAAM,mCAAmC,CAAC;AAGjF,OAAO,KAAK,EAAC,wBAAwB,EAAC,MAAM,mBAAmB,CAAC;AAGhE,eAAO,MAAM,qBAAqB,wBAAwB,CAAC;AAC3D,eAAO,MAAM,kBAAkB,MAAM,CAAC;AACtC,eAAO,MAAM,uBAAuB,UAAY,CAAC;AACjD,eAAO,MAAM,sBAAsB,IAAI,CAAC;AACxC,eAAO,MAAM,mBAAmB,mBAAmB,CAAC;AAEpD,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,0BAA0B,EAAE,MAAM,CAAC;IACnC,aAAa,EAAE,wBAAwB,CAAC;CACzC;AAED,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;CACb;AAED,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAO9F;AAED,MAAM,WAAW,2BAA4B,SAAQ,iBAAiB;IACpE,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC;AAED,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,2BAA2B,GAClC,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAC,CAAC,CA4B5B;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,yBAAyB,CAAC;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,iBAAiB,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,4BAA6B,SAAQ,iBAAiB;IACrE,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IAClD,sBAAsB,EAAE,sBAAsB,CAAC;IAC/C,gCAAgC,CAAC,EAAE,CAAC,MAAM,OAAO,CAAC,4BAA4B,CAAC,CAAC,GAAG,SAAS,CAAC;CAC9F;AAED,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,4BAA4B,GACnC,OAAO,CAAC,cAAc,EAAE,CAAC,CAkD3B;AAqCD,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,uBAAuB,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,yBAAyB,CA+B7E"}

package/dist/core/sync-definitions.js

@@ -4,7 +4,7 @@ import { isInterModuleKnownError } from '@shipfox/inter-module';
 import { boundedMap } from '@shipfox/node-module';
 import { DefinitionParseError, DefinitionSyncPermanentError } from './errors.js';
 import { hasAgentStepIntegrations } from './has-agent-step-integrations.js';
-import { parseDefinition } from './parse-definition.js';
+import { parseDefinitionWithWarnings, stripDefinitionWarnings } from './parse-definition.js';
 export const DEFAULT_WORKFLOW_PATH = '.shipfox/workflows/';
 export const MAX_WORKFLOW_FILES = 100;
 export const MAX_WORKFLOW_FILE_BYTES = 1_000_000;
@@ -78,9 +78,9 @@ export async function fetchAndParseWorkflows(params) {
 }
 function parseWorkflowSnapshot(params) {
     try {
-        const definition = params.integrationValidationContext === undefined ? parseDefinition(params.content, {
+        const definition = params.integrationValidationContext === undefined ? parseDefinitionWithWarnings(params.content, {
             agentValidationCatalog: params.agentValidationCatalog
-        }) : parseDefinition(params.content, {
+        }) : parseDefinitionWithWarnings(params.content, {
             agentValidationCatalog: params.agentValidationCatalog,
             integrationValidationContext: params.integrationValidationContext
         });
@@ -88,8 +88,9 @@ function parseWorkflowSnapshot(params) {
         return {
             path: params.path,
             name: definition.document.name,
-            definition,
-            contentHash
+            definition: stripDefinitionWarnings(definition),
+            contentHash,
+            warnings: definition.warnings
         };
     } catch (error) {
         if (error instanceof DefinitionParseError) {

package/dist/core/sync-definitions.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/core/sync-definitions.ts"],"sourcesContent":["import {createHash} from 'node:crypto';\nimport type {AgentValidationCatalog} from '@shipfox/api-agent-dto/inter-module';\nimport {integrationsInterModuleContract} from '@shipfox/api-integration-core-dto/inter-module';\nimport {isInterModuleKnownError} from '@shipfox/inter-module';\nimport {boundedMap} from '@shipfox/node-module';\nimport type {IntegrationValidationContext} from './entities/integration-context.js';\nimport type {DefinitionSyncErrorCode} from './entities/sync-state.js';\nimport type {WorkflowDefinitionPayload} from './entities/workflow-definition.js';\nimport {DefinitionParseError, DefinitionSyncPermanentError} from './errors.js';\nimport {hasAgentStepIntegrations} from './has-agent-step-integrations.js';\nimport type {DefinitionsSourceControl} from './integrations.js';\nimport {parseDefinition} from './parse-definition.js';\n\nexport const DEFAULT_WORKFLOW_PATH = '.shipfox/workflows/';\nexport const MAX_WORKFLOW_FILES = 100;\nexport const MAX_WORKFLOW_FILE_BYTES = 1_000_000;\nexport const FILE_FETCH_CONCURRENCY = 4;\nexport const UNRESOLVED_SYNC_REF = '__unresolved__';\n\nexport interface SyncSourceContext {\n  workspaceId: string;\n  sourceConnectionId: string;\n  sourceExternalRepositoryId: string;\n  sourceControl: DefinitionsSourceControl;\n}\n\nexport interface ResolvedSyncSource {\n  ref: string;\n}\n\nexport async function resolveSyncSource(params: SyncSourceContext): Promise<ResolvedSyncSource> {\n  const source = await params.sourceControl.resolveRepository({\n    workspaceId: params.workspaceId,\n    connectionId: params.sourceConnectionId,\n    externalRepositoryId: params.sourceExternalRepositoryId,\n  });\n  return {ref: source.repository.defaultBranch};\n}\n\nexport interface DiscoverWorkflowFilesParams extends SyncSourceContext {\n  ref: string;\n  workflowPath?: string | undefined;\n}\n\nexport async function discoverWorkflowFiles(\n  params: DiscoverWorkflowFilesParams,\n): Promise<{paths: string[]}> {\n  const workflowPath = params.workflowPath ?? DEFAULT_WORKFLOW_PATH;\n  const page = await params.sourceControl.listFiles({\n    workspaceId: params.workspaceId,\n    connectionId: params.sourceConnectionId,\n    externalRepositoryId: params.sourceExternalRepositoryId,\n    ref: params.ref,\n    prefix: workflowPath,\n    limit: MAX_WORKFLOW_FILES,\n  });\n  if (page.nextCursor) {\n    throw new DefinitionSyncPermanentError(\n      'too-many-files',\n      `More than ${MAX_WORKFLOW_FILES} workflow files were found`,\n    );\n  }\n\n  const paths = page.files\n    .filter((file) => file.path.endsWith('.yml') || file.path.endsWith('.yaml'))\n    .map((file) => file.path);\n  if (paths.length === 0) {\n    throw new DefinitionSyncPermanentError(\n      'no-workflow-files',\n      `No workflow files were found under ${workflowPath}`,\n    );\n  }\n\n  return {paths};\n}\n\nexport interface ParsedWorkflow {\n  path: string;\n  name: string;\n  definition: WorkflowDefinitionPayload;\n  contentHash: string;\n}\n\nexport interface FetchAndParseWorkflowsParams extends SyncSourceContext {\n  ref: string;\n  paths: string[];\n  onProgress?: ((path: string) => void) | undefined;\n  agentValidationCatalog: AgentValidationCatalog;\n  loadIntegrationValidationContext?: (() => Promise<IntegrationValidationContext>) | undefined;\n}\n\nexport async function fetchAndParseWorkflows(\n  params: FetchAndParseWorkflowsParams,\n): Promise<ParsedWorkflow[]> {\n  const parsed = await boundedMap(\n    params.paths,\n    FILE_FETCH_CONCURRENCY,\n    async (path) => {\n      params.onProgress?.(path);\n\n      const snapshot = await params.sourceControl.fetchFile({\n        workspaceId: params.workspaceId,\n        connectionId: params.sourceConnectionId,\n        externalRepositoryId: params.sourceExternalRepositoryId,\n        ref: params.ref,\n        path,\n      });\n\n      if (Buffer.byteLength(snapshot.content, 'utf8') > MAX_WORKFLOW_FILE_BYTES) {\n        throw new DefinitionSyncPermanentError(\n          'content-too-large',\n          `Workflow file is larger than ${MAX_WORKFLOW_FILE_BYTES} bytes: ${snapshot.path}`,\n        );\n      }\n\n      return {\n        ...parseWorkflowSnapshot({\n          path: snapshot.path,\n          content: snapshot.content,\n          agentValidationCatalog: params.agentValidationCatalog,\n        }),\n        rawContent: snapshot.content,\n      };\n    },\n    {stopOnError: true},\n  );\n\n  if (\n    !params.loadIntegrationValidationContext ||\n    !parsed.some((entry) => hasAgentStepIntegrations(entry.definition.document))\n  ) {\n    return parsed.map(({rawContent: _rawContent, ...entry}) => entry);\n  }\n\n  const integrationValidationContext = await params.loadIntegrationValidationContext();\n  return parsed.map((entry) =>\n    parseWorkflowSnapshot({\n      path: entry.path,\n      content: entry.rawContent,\n      agentValidationCatalog: params.agentValidationCatalog,\n      integrationValidationContext,\n    }),\n  );\n}\n\nfunction parseWorkflowSnapshot(params: {\n  path: string;\n  content: string;\n  integrationValidationContext?: IntegrationValidationContext | undefined;\n  agentValidationCatalog: AgentValidationCatalog;\n}): ParsedWorkflow {\n  try {\n    const definition =\n      params.integrationValidationContext === undefined\n        ? parseDefinition(params.content, {agentValidationCatalog: params.agentValidationCatalog})\n        : parseDefinition(params.content, {\n            agentValidationCatalog: params.agentValidationCatalog,\n            integrationValidationContext: params.integrationValidationContext,\n          });\n    const contentHash = sha256Hex(params.content);\n    return {path: params.path, name: definition.document.name, definition, contentHash};\n  } catch (error) {\n    if (error instanceof DefinitionParseError) {\n      throw new DefinitionSyncPermanentError(\n        'invalid-definition',\n        `Invalid workflow definition at ${params.path}: ${error.message}`,\n      );\n    }\n    throw error;\n  }\n}\n\nexport interface SyncFailureClassification {\n  code: DefinitionSyncErrorCode;\n  message: string;\n  retryable: boolean;\n}\n\nexport function classifySyncFailure(error: unknown): SyncFailureClassification {\n  if (error instanceof DefinitionSyncPermanentError) {\n    return {code: error.code, message: error.message, retryable: false};\n  }\n  const methods = [\n    integrationsInterModuleContract.methods.resolveSourceRepository,\n    integrationsInterModuleContract.methods.listSourceFiles,\n    integrationsInterModuleContract.methods.fetchSourceFile,\n  ] as const;\n  for (const method of methods) {\n    if (!isInterModuleKnownError(method, error)) continue;\n    if (\n      error.code === 'connection-not-found' ||\n      error.code === 'connection-inactive' ||\n      error.code === 'connection-workspace-mismatch'\n    ) {\n      return {code: 'connection-unavailable', message: error.message, retryable: false};\n    }\n    if (error.code === 'provider-failure') {\n      return {\n        code: providerErrorCode(error.details.reason),\n        message: error.message,\n        retryable: isProviderReasonRetryable(error.details.reason),\n      };\n    }\n  }\n  return {\n    code: 'unknown',\n    message: error instanceof Error ? error.message : String(error),\n    retryable: true,\n  };\n}\n\nfunction isProviderReasonRetryable(reason: string): boolean {\n  return reason === 'rate-limited' || reason === 'timeout' || reason === 'provider-unavailable';\n}\n\nfunction providerErrorCode(reason: string): DefinitionSyncErrorCode {\n  if (reason === 'repository-not-found') return 'provider-repository-not-found';\n  if (reason === 'file-not-found') return 'provider-file-not-found';\n  if (reason === 'access-denied') return 'provider-access-denied';\n  if (reason === 'rate-limited') return 'provider-rate-limited';\n  if (reason === 'timeout') return 'provider-timeout';\n  if (reason === 'provider-unavailable') return 'provider-unavailable';\n  if (reason === 'malformed-provider-response') return 'provider-malformed-response';\n  if (reason === 'content-too-large') return 'content-too-large';\n  if (reason === 'too-many-files') return 'too-many-files';\n  return 'unknown';\n}\n\nfunction sha256Hex(content: string): string {\n  return createHash('sha256').update(content, 'utf8').digest('hex');\n}\n"],"names":["createHash","integrationsInterModuleContract","isInterModuleKnownError","boundedMap","DefinitionParseError","DefinitionSyncPermanentError","hasAgentStepIntegrations","parseDefinition","DEFAULT_WORKFLOW_PATH","MAX_WORKFLOW_FILES","MAX_WORKFLOW_FILE_BYTES","FILE_FETCH_CONCURRENCY","UNRESOLVED_SYNC_REF","resolveSyncSource","params","source","sourceControl","resolveRepository","workspaceId","connectionId","sourceConnectionId","externalRepositoryId","sourceExternalRepositoryId","ref","repository","defaultBranch","discoverWorkflowFiles","workflowPath","page","listFiles","prefix","limit","nextCursor","paths","files","filter","file","path","endsWith","map","length","fetchAndParseWorkflows","parsed","onProgress","snapshot","fetchFile","Buffer","byteLength","content","parseWorkflowSnapshot","agentValidationCatalog","rawContent","stopOnError","loadIntegrationValidationContext","some","entry","definition","document","_rawContent","integrationValidationContext","undefined","contentHash","sha256Hex","name","error","message","classifySyncFailure","code","retryable","methods","resolveSourceRepository","listSourceFiles","fetchSourceFile","method","providerErrorCode","details","reason","isProviderReasonRetryable","Error","String","update","digest"],"mappings":"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"}
+{"version":3,"sources":["../../src/core/sync-definitions.ts"],"sourcesContent":["import {createHash} from 'node:crypto';\nimport type {AgentValidationCatalog} from '@shipfox/api-agent-dto/inter-module';\nimport {integrationsInterModuleContract} from '@shipfox/api-integration-core-dto/inter-module';\nimport {isInterModuleKnownError} from '@shipfox/inter-module';\nimport {boundedMap} from '@shipfox/node-module';\nimport type {IntegrationValidationContext} from './entities/integration-context.js';\nimport type {DefinitionSyncErrorCode} from './entities/sync-state.js';\nimport type {ValidationWarning} from './entities/validation-warning.js';\nimport type {WorkflowDefinitionPayload} from './entities/workflow-definition.js';\nimport {DefinitionParseError, DefinitionSyncPermanentError} from './errors.js';\nimport {hasAgentStepIntegrations} from './has-agent-step-integrations.js';\nimport type {DefinitionsSourceControl} from './integrations.js';\nimport {parseDefinitionWithWarnings, stripDefinitionWarnings} from './parse-definition.js';\n\nexport const DEFAULT_WORKFLOW_PATH = '.shipfox/workflows/';\nexport const MAX_WORKFLOW_FILES = 100;\nexport const MAX_WORKFLOW_FILE_BYTES = 1_000_000;\nexport const FILE_FETCH_CONCURRENCY = 4;\nexport const UNRESOLVED_SYNC_REF = '__unresolved__';\n\nexport interface SyncSourceContext {\n  workspaceId: string;\n  sourceConnectionId: string;\n  sourceExternalRepositoryId: string;\n  sourceControl: DefinitionsSourceControl;\n}\n\nexport interface ResolvedSyncSource {\n  ref: string;\n}\n\nexport async function resolveSyncSource(params: SyncSourceContext): Promise<ResolvedSyncSource> {\n  const source = await params.sourceControl.resolveRepository({\n    workspaceId: params.workspaceId,\n    connectionId: params.sourceConnectionId,\n    externalRepositoryId: params.sourceExternalRepositoryId,\n  });\n  return {ref: source.repository.defaultBranch};\n}\n\nexport interface DiscoverWorkflowFilesParams extends SyncSourceContext {\n  ref: string;\n  workflowPath?: string | undefined;\n}\n\nexport async function discoverWorkflowFiles(\n  params: DiscoverWorkflowFilesParams,\n): Promise<{paths: string[]}> {\n  const workflowPath = params.workflowPath ?? DEFAULT_WORKFLOW_PATH;\n  const page = await params.sourceControl.listFiles({\n    workspaceId: params.workspaceId,\n    connectionId: params.sourceConnectionId,\n    externalRepositoryId: params.sourceExternalRepositoryId,\n    ref: params.ref,\n    prefix: workflowPath,\n    limit: MAX_WORKFLOW_FILES,\n  });\n  if (page.nextCursor) {\n    throw new DefinitionSyncPermanentError(\n      'too-many-files',\n      `More than ${MAX_WORKFLOW_FILES} workflow files were found`,\n    );\n  }\n\n  const paths = page.files\n    .filter((file) => file.path.endsWith('.yml') || file.path.endsWith('.yaml'))\n    .map((file) => file.path);\n  if (paths.length === 0) {\n    throw new DefinitionSyncPermanentError(\n      'no-workflow-files',\n      `No workflow files were found under ${workflowPath}`,\n    );\n  }\n\n  return {paths};\n}\n\nexport interface ParsedWorkflow {\n  path: string;\n  name: string;\n  definition: WorkflowDefinitionPayload;\n  contentHash: string;\n  warnings: ValidationWarning[];\n}\n\nexport interface FetchAndParseWorkflowsParams extends SyncSourceContext {\n  ref: string;\n  paths: string[];\n  onProgress?: ((path: string) => void) | undefined;\n  agentValidationCatalog: AgentValidationCatalog;\n  loadIntegrationValidationContext?: (() => Promise<IntegrationValidationContext>) | undefined;\n}\n\nexport async function fetchAndParseWorkflows(\n  params: FetchAndParseWorkflowsParams,\n): Promise<ParsedWorkflow[]> {\n  const parsed = await boundedMap(\n    params.paths,\n    FILE_FETCH_CONCURRENCY,\n    async (path) => {\n      params.onProgress?.(path);\n\n      const snapshot = await params.sourceControl.fetchFile({\n        workspaceId: params.workspaceId,\n        connectionId: params.sourceConnectionId,\n        externalRepositoryId: params.sourceExternalRepositoryId,\n        ref: params.ref,\n        path,\n      });\n\n      if (Buffer.byteLength(snapshot.content, 'utf8') > MAX_WORKFLOW_FILE_BYTES) {\n        throw new DefinitionSyncPermanentError(\n          'content-too-large',\n          `Workflow file is larger than ${MAX_WORKFLOW_FILE_BYTES} bytes: ${snapshot.path}`,\n        );\n      }\n\n      return {\n        ...parseWorkflowSnapshot({\n          path: snapshot.path,\n          content: snapshot.content,\n          agentValidationCatalog: params.agentValidationCatalog,\n        }),\n        rawContent: snapshot.content,\n      };\n    },\n    {stopOnError: true},\n  );\n\n  if (\n    !params.loadIntegrationValidationContext ||\n    !parsed.some((entry) => hasAgentStepIntegrations(entry.definition.document))\n  ) {\n    return parsed.map(({rawContent: _rawContent, ...entry}) => entry);\n  }\n\n  const integrationValidationContext = await params.loadIntegrationValidationContext();\n  return parsed.map((entry) =>\n    parseWorkflowSnapshot({\n      path: entry.path,\n      content: entry.rawContent,\n      agentValidationCatalog: params.agentValidationCatalog,\n      integrationValidationContext,\n    }),\n  );\n}\n\nfunction parseWorkflowSnapshot(params: {\n  path: string;\n  content: string;\n  integrationValidationContext?: IntegrationValidationContext | undefined;\n  agentValidationCatalog: AgentValidationCatalog;\n}): ParsedWorkflow {\n  try {\n    const definition =\n      params.integrationValidationContext === undefined\n        ? parseDefinitionWithWarnings(params.content, {\n            agentValidationCatalog: params.agentValidationCatalog,\n          })\n        : parseDefinitionWithWarnings(params.content, {\n            agentValidationCatalog: params.agentValidationCatalog,\n            integrationValidationContext: params.integrationValidationContext,\n          });\n    const contentHash = sha256Hex(params.content);\n    return {\n      path: params.path,\n      name: definition.document.name,\n      definition: stripDefinitionWarnings(definition),\n      contentHash,\n      warnings: definition.warnings,\n    };\n  } catch (error) {\n    if (error instanceof DefinitionParseError) {\n      throw new DefinitionSyncPermanentError(\n        'invalid-definition',\n        `Invalid workflow definition at ${params.path}: ${error.message}`,\n      );\n    }\n    throw error;\n  }\n}\n\nexport interface SyncFailureClassification {\n  code: DefinitionSyncErrorCode;\n  message: string;\n  retryable: boolean;\n}\n\nexport function classifySyncFailure(error: unknown): SyncFailureClassification {\n  if (error instanceof DefinitionSyncPermanentError) {\n    return {code: error.code, message: error.message, retryable: false};\n  }\n  const methods = [\n    integrationsInterModuleContract.methods.resolveSourceRepository,\n    integrationsInterModuleContract.methods.listSourceFiles,\n    integrationsInterModuleContract.methods.fetchSourceFile,\n  ] as const;\n  for (const method of methods) {\n    if (!isInterModuleKnownError(method, error)) continue;\n    if (\n      error.code === 'connection-not-found' ||\n      error.code === 'connection-inactive' ||\n      error.code === 'connection-workspace-mismatch'\n    ) {\n      return {code: 'connection-unavailable', message: error.message, retryable: false};\n    }\n    if (error.code === 'provider-failure') {\n      return {\n        code: providerErrorCode(error.details.reason),\n        message: error.message,\n        retryable: isProviderReasonRetryable(error.details.reason),\n      };\n    }\n  }\n  return {\n    code: 'unknown',\n    message: error instanceof Error ? error.message : String(error),\n    retryable: true,\n  };\n}\n\nfunction isProviderReasonRetryable(reason: string): boolean {\n  return reason === 'rate-limited' || reason === 'timeout' || reason === 'provider-unavailable';\n}\n\nfunction providerErrorCode(reason: string): DefinitionSyncErrorCode {\n  if (reason === 'repository-not-found') return 'provider-repository-not-found';\n  if (reason === 'file-not-found') return 'provider-file-not-found';\n  if (reason === 'access-denied') return 'provider-access-denied';\n  if (reason === 'rate-limited') return 'provider-rate-limited';\n  if (reason === 'timeout') return 'provider-timeout';\n  if (reason === 'provider-unavailable') return 'provider-unavailable';\n  if (reason === 'malformed-provider-response') return 'provider-malformed-response';\n  if (reason === 'content-too-large') return 'content-too-large';\n  if (reason === 'too-many-files') return 'too-many-files';\n  return 'unknown';\n}\n\nfunction sha256Hex(content: string): string {\n  return createHash('sha256').update(content, 'utf8').digest('hex');\n}\n"],"names":["createHash","integrationsInterModuleContract","isInterModuleKnownError","boundedMap","DefinitionParseError","DefinitionSyncPermanentError","hasAgentStepIntegrations","parseDefinitionWithWarnings","stripDefinitionWarnings","DEFAULT_WORKFLOW_PATH","MAX_WORKFLOW_FILES","MAX_WORKFLOW_FILE_BYTES","FILE_FETCH_CONCURRENCY","UNRESOLVED_SYNC_REF","resolveSyncSource","params","source","sourceControl","resolveRepository","workspaceId","connectionId","sourceConnectionId","externalRepositoryId","sourceExternalRepositoryId","ref","repository","defaultBranch","discoverWorkflowFiles","workflowPath","page","listFiles","prefix","limit","nextCursor","paths","files","filter","file","path","endsWith","map","length","fetchAndParseWorkflows","parsed","onProgress","snapshot","fetchFile","Buffer","byteLength","content","parseWorkflowSnapshot","agentValidationCatalog","rawContent","stopOnError","loadIntegrationValidationContext","some","entry","definition","document","_rawContent","integrationValidationContext","undefined","contentHash","sha256Hex","name","warnings","error","message","classifySyncFailure","code","retryable","methods","resolveSourceRepository","listSourceFiles","fetchSourceFile","method","providerErrorCode","details","reason","isProviderReasonRetryable","Error","String","update","digest"],"mappings":"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"}

package/dist/core/validate-definition.d.ts

@@ -1,20 +1,24 @@
 import type { AgentValidationCatalog } from '@shipfox/api-agent-dto/inter-module';
 import type { IntegrationValidationContext } from './entities/integration-context.js';
+import type { ValidationWarning } from './entities/validation-warning.js';
 import type { WorkflowDefinitionPayload } from './entities/workflow-definition.js';
 export type ValidationError = {
     message: string;
     path?: string | undefined;
 };
+export type { ValidationWarning } from './entities/validation-warning.js';
+export interface DefinitionValidationOptions {
+    defaultRunnerLabels?: readonly string[];
+    agentValidationCatalog: AgentValidationCatalog;
+    integrationValidationContext?: IntegrationValidationContext;
+}
 export type ValidationResult = {
     valid: true;
     definition: WorkflowDefinitionPayload;
+    warnings: ValidationWarning[];
 } | {
     valid: false;
     errors: ValidationError[];
 };
-export declare function validateDefinition(yamlContent: string, options: {
-    defaultRunnerLabels?: readonly string[];
-    agentValidationCatalog: AgentValidationCatalog;
-    integrationValidationContext?: IntegrationValidationContext;
-}): ValidationResult;
+export declare function validateDefinition(yamlContent: string, options: DefinitionValidationOptions): ValidationResult;
 //# sourceMappingURL=validate-definition.d.ts.map

package/dist/core/validate-definition.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validate-definition.d.ts","sourceRoot":"","sources":["../../src/core/validate-definition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,sBAAsB,EAAC,MAAM,qCAAqC,CAAC;AAGhF,OAAO,KAAK,EAAC,4BAA4B,EAAC,MAAM,mCAAmC,CAAC;AACpF,OAAO,KAAK,EAAC,yBAAyB,EAAC,MAAM,mCAAmC,CAAC;AAIjF,MAAM,MAAM,eAAe,GAAG;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAC,CAAC;AAE3E,MAAM,MAAM,gBAAgB,GACxB;IAAC,KAAK,EAAE,IAAI,CAAC;IAAC,UAAU,EAAE,yBAAyB,CAAA;CAAC,GACpD;IAAC,KAAK,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,eAAe,EAAE,CAAA;CAAC,CAAC;AAE9C,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE;IACP,mBAAmB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,sBAAsB,EAAE,sBAAsB,CAAC;IAC/C,4BAA4B,CAAC,EAAE,4BAA4B,CAAC;CAC7D,GACA,gBAAgB,CAalB"}
+{"version":3,"file":"validate-definition.d.ts","sourceRoot":"","sources":["../../src/core/validate-definition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,sBAAsB,EAAC,MAAM,qCAAqC,CAAC;AAGhF,OAAO,KAAK,EAAC,4BAA4B,EAAC,MAAM,mCAAmC,CAAC;AACpF,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,kCAAkC,CAAC;AACxE,OAAO,KAAK,EAAC,yBAAyB,EAAC,MAAM,mCAAmC,CAAC;AAQjF,MAAM,MAAM,eAAe,GAAG;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAC,CAAC;AAC3E,YAAY,EAAC,iBAAiB,EAAC,MAAM,kCAAkC,CAAC;AAExE,MAAM,WAAW,2BAA2B;IAC1C,mBAAmB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,sBAAsB,EAAE,sBAAsB,CAAC;IAC/C,4BAA4B,CAAC,EAAE,4BAA4B,CAAC;CAC7D;AAED,MAAM,MAAM,gBAAgB,GACxB;IAAC,KAAK,EAAE,IAAI,CAAC;IAAC,UAAU,EAAE,yBAAyB,CAAC;IAAC,QAAQ,EAAE,iBAAiB,EAAE,CAAA;CAAC,GACnF;IAAC,KAAK,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,eAAe,EAAE,CAAA;CAAC,CAAC;AAE9C,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,2BAA2B,GACnC,gBAAgB,CAelB"}

package/dist/core/validate-definition.js

@@ -5,18 +5,21 @@ import { InvalidWorkflowYamlError, parseWorkflowYamlWithLocations } from './work
 export function validateDefinition(yamlContent, options) {
     try {
         const { document, stepSourceLocations } = parseWorkflowYamlWithLocations(yamlContent);
+        const warnings = [];
         const model = normalizeWorkflowDocument(document, {
             defaultRunnerLabels: options.defaultRunnerLabels ?? definitionDefaultRunnerLabels,
             agentValidationCatalog: options.agentValidationCatalog,
             integrationValidationContext: options.integrationValidationContext,
-            stepSourceLocations
+            stepSourceLocations,
+            warnings
         });
         return {
             valid: true,
             definition: {
                 document,
                 model
-            }
+            },
+            warnings: validationWarningsFor(warnings)
         };
     } catch (error) {
         return {
@@ -25,6 +28,13 @@ export function validateDefinition(yamlContent, options) {
         };
     }
 }
+function validationWarningsFor(issues) {
+    return issues.map((issue)=>validationWarning({
+            code: issue.code,
+            message: issue.message,
+            path: issue.path.join('.') || undefined
+        }));
+}
 function validationErrorsFor(error) {
     if (error instanceof InvalidWorkflowYamlError) {
         return [
@@ -57,5 +67,16 @@ function validationError(params) {
         path: params.path
     };
 }
+function validationWarning(params) {
+    if (params.path === undefined) return {
+        code: params.code,
+        message: params.message
+    };
+    return {
+        code: params.code,
+        message: params.message,
+        path: params.path
+    };
+}
 
 //# sourceMappingURL=validate-definition.js.map

package/dist/core/validate-definition.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/core/validate-definition.ts"],"sourcesContent":["import type {AgentValidationCatalog} from '@shipfox/api-agent-dto/inter-module';\nimport {InvalidWorkflowDocumentError} from '@shipfox/workflow-document';\nimport {definitionDefaultRunnerLabels} from '../config.js';\nimport type {IntegrationValidationContext} from './entities/integration-context.js';\nimport type {WorkflowDefinitionPayload} from './entities/workflow-definition.js';\nimport {InvalidWorkflowModelError, normalizeWorkflowDocument} from './workflow-model/index.js';\nimport {InvalidWorkflowYamlError, parseWorkflowYamlWithLocations} from './workflow-yaml/index.js';\n\nexport type ValidationError = {message: string; path?: string | undefined};\n\nexport type ValidationResult =\n  | {valid: true; definition: WorkflowDefinitionPayload}\n  | {valid: false; errors: ValidationError[]};\n\nexport function validateDefinition(\n  yamlContent: string,\n  options: {\n    defaultRunnerLabels?: readonly string[];\n    agentValidationCatalog: AgentValidationCatalog;\n    integrationValidationContext?: IntegrationValidationContext;\n  },\n): ValidationResult {\n  try {\n    const {document, stepSourceLocations} = parseWorkflowYamlWithLocations(yamlContent);\n    const model = normalizeWorkflowDocument(document, {\n      defaultRunnerLabels: options.defaultRunnerLabels ?? definitionDefaultRunnerLabels,\n      agentValidationCatalog: options.agentValidationCatalog,\n      integrationValidationContext: options.integrationValidationContext,\n      stepSourceLocations,\n    });\n    return {valid: true, definition: {document, model}};\n  } catch (error) {\n    return {valid: false, errors: validationErrorsFor(error)};\n  }\n}\n\nfunction validationErrorsFor(error: unknown): ValidationError[] {\n  if (error instanceof InvalidWorkflowYamlError) {\n    return [\n      validationError({\n        message: error.message,\n        path:\n          error.location === undefined\n            ? undefined\n            : `${error.location.line}:${error.location.column}`,\n      }),\n    ];\n  }\n\n  if (error instanceof InvalidWorkflowDocumentError) {\n    return error.validationError.issues.map((issue) =>\n      validationError({\n        message: issue.message,\n        path: issue.path.join('.') || undefined,\n      }),\n    );\n  }\n\n  if (error instanceof InvalidWorkflowModelError) {\n    return error.issues.map((issue) =>\n      validationError({message: issue.message, path: issue.path.join('.')}),\n    );\n  }\n\n  throw error;\n}\n\nfunction validationError(params: {message: string; path?: string | undefined}): ValidationError {\n  if (params.path === undefined) return {message: params.message};\n  return {message: params.message, path: params.path};\n}\n"],"names":["InvalidWorkflowDocumentError","definitionDefaultRunnerLabels","InvalidWorkflowModelError","normalizeWorkflowDocument","InvalidWorkflowYamlError","parseWorkflowYamlWithLocations","validateDefinition","yamlContent","options","document","stepSourceLocations","model","defaultRunnerLabels","agentValidationCatalog","integrationValidationContext","valid","definition","error","errors","validationErrorsFor","validationError","message","path","location","undefined","line","column","issues","map","issue","join","params"],"mappings":"AACA,SAAQA,4BAA4B,QAAO,6BAA6B;AACxE,SAAQC,6BAA6B,QAAO,eAAe;AAG3D,SAAQC,yBAAyB,EAAEC,yBAAyB,QAAO,4BAA4B;AAC/F,SAAQC,wBAAwB,EAAEC,8BAA8B,QAAO,2BAA2B;AAQlG,OAAO,SAASC,mBACdC,WAAmB,EACnBC,OAIC;IAED,IAAI;QACF,MAAM,EAACC,QAAQ,EAAEC,mBAAmB,EAAC,GAAGL,+BAA+BE;QACvE,MAAMI,QAAQR,0BAA0BM,UAAU;YAChDG,qBAAqBJ,QAAQI,mBAAmB,IAAIX;YACpDY,wBAAwBL,QAAQK,sBAAsB;YACtDC,8BAA8BN,QAAQM,4BAA4B;YAClEJ;QACF;QACA,OAAO;YAACK,OAAO;YAAMC,YAAY;gBAACP;gBAAUE;YAAK;QAAC;IACpD,EAAE,OAAOM,OAAO;QACd,OAAO;YAACF,OAAO;YAAOG,QAAQC,oBAAoBF;QAAM;IAC1D;AACF;AAEA,SAASE,oBAAoBF,KAAc;IACzC,IAAIA,iBAAiBb,0BAA0B;QAC7C,OAAO;YACLgB,gBAAgB;gBACdC,SAASJ,MAAMI,OAAO;gBACtBC,MACEL,MAAMM,QAAQ,KAAKC,YACfA,YACA,GAAGP,MAAMM,QAAQ,CAACE,IAAI,CAAC,CAAC,EAAER,MAAMM,QAAQ,CAACG,MAAM,EAAE;YACzD;SACD;IACH;IAEA,IAAIT,iBAAiBjB,8BAA8B;QACjD,OAAOiB,MAAMG,eAAe,CAACO,MAAM,CAACC,GAAG,CAAC,CAACC,QACvCT,gBAAgB;gBACdC,SAASQ,MAAMR,OAAO;gBACtBC,MAAMO,MAAMP,IAAI,CAACQ,IAAI,CAAC,QAAQN;YAChC;IAEJ;IAEA,IAAIP,iBAAiBf,2BAA2B;QAC9C,OAAOe,MAAMU,MAAM,CAACC,GAAG,CAAC,CAACC,QACvBT,gBAAgB;gBAACC,SAASQ,MAAMR,OAAO;gBAAEC,MAAMO,MAAMP,IAAI,CAACQ,IAAI,CAAC;YAAI;IAEvE;IAEA,MAAMb;AACR;AAEA,SAASG,gBAAgBW,MAAoD;IAC3E,IAAIA,OAAOT,IAAI,KAAKE,WAAW,OAAO;QAACH,SAASU,OAAOV,OAAO;IAAA;IAC9D,OAAO;QAACA,SAASU,OAAOV,OAAO;QAAEC,MAAMS,OAAOT,IAAI;IAAA;AACpD"}
+{"version":3,"sources":["../../src/core/validate-definition.ts"],"sourcesContent":["import type {AgentValidationCatalog} from '@shipfox/api-agent-dto/inter-module';\nimport {InvalidWorkflowDocumentError} from '@shipfox/workflow-document';\nimport {definitionDefaultRunnerLabels} from '../config.js';\nimport type {IntegrationValidationContext} from './entities/integration-context.js';\nimport type {ValidationWarning} from './entities/validation-warning.js';\nimport type {WorkflowDefinitionPayload} from './entities/workflow-definition.js';\nimport {\n  InvalidWorkflowModelError,\n  normalizeWorkflowDocument,\n  type WorkflowModelValidationIssue,\n} from './workflow-model/index.js';\nimport {InvalidWorkflowYamlError, parseWorkflowYamlWithLocations} from './workflow-yaml/index.js';\n\nexport type ValidationError = {message: string; path?: string | undefined};\nexport type {ValidationWarning} from './entities/validation-warning.js';\n\nexport interface DefinitionValidationOptions {\n  defaultRunnerLabels?: readonly string[];\n  agentValidationCatalog: AgentValidationCatalog;\n  integrationValidationContext?: IntegrationValidationContext;\n}\n\nexport type ValidationResult =\n  | {valid: true; definition: WorkflowDefinitionPayload; warnings: ValidationWarning[]}\n  | {valid: false; errors: ValidationError[]};\n\nexport function validateDefinition(\n  yamlContent: string,\n  options: DefinitionValidationOptions,\n): ValidationResult {\n  try {\n    const {document, stepSourceLocations} = parseWorkflowYamlWithLocations(yamlContent);\n    const warnings: WorkflowModelValidationIssue[] = [];\n    const model = normalizeWorkflowDocument(document, {\n      defaultRunnerLabels: options.defaultRunnerLabels ?? definitionDefaultRunnerLabels,\n      agentValidationCatalog: options.agentValidationCatalog,\n      integrationValidationContext: options.integrationValidationContext,\n      stepSourceLocations,\n      warnings,\n    });\n    return {valid: true, definition: {document, model}, warnings: validationWarningsFor(warnings)};\n  } catch (error) {\n    return {valid: false, errors: validationErrorsFor(error)};\n  }\n}\n\nfunction validationWarningsFor(\n  issues: readonly WorkflowModelValidationIssue[],\n): ValidationWarning[] {\n  return issues.map((issue) =>\n    validationWarning({\n      code: issue.code,\n      message: issue.message,\n      path: issue.path.join('.') || undefined,\n    }),\n  );\n}\n\nfunction validationErrorsFor(error: unknown): ValidationError[] {\n  if (error instanceof InvalidWorkflowYamlError) {\n    return [\n      validationError({\n        message: error.message,\n        path:\n          error.location === undefined\n            ? undefined\n            : `${error.location.line}:${error.location.column}`,\n      }),\n    ];\n  }\n\n  if (error instanceof InvalidWorkflowDocumentError) {\n    return error.validationError.issues.map((issue) =>\n      validationError({\n        message: issue.message,\n        path: issue.path.join('.') || undefined,\n      }),\n    );\n  }\n\n  if (error instanceof InvalidWorkflowModelError) {\n    return error.issues.map((issue) =>\n      validationError({message: issue.message, path: issue.path.join('.')}),\n    );\n  }\n\n  throw error;\n}\n\nfunction validationError(params: {message: string; path?: string | undefined}): ValidationError {\n  if (params.path === undefined) return {message: params.message};\n  return {message: params.message, path: params.path};\n}\n\nfunction validationWarning(params: {\n  code: string;\n  message: string;\n  path?: string | undefined;\n}): ValidationWarning {\n  if (params.path === undefined) return {code: params.code, message: params.message};\n  return {code: params.code, message: params.message, path: params.path};\n}\n"],"names":["InvalidWorkflowDocumentError","definitionDefaultRunnerLabels","InvalidWorkflowModelError","normalizeWorkflowDocument","InvalidWorkflowYamlError","parseWorkflowYamlWithLocations","validateDefinition","yamlContent","options","document","stepSourceLocations","warnings","model","defaultRunnerLabels","agentValidationCatalog","integrationValidationContext","valid","definition","validationWarningsFor","error","errors","validationErrorsFor","issues","map","issue","validationWarning","code","message","path","join","undefined","validationError","location","line","column","params"],"mappings":"AACA,SAAQA,4BAA4B,QAAO,6BAA6B;AACxE,SAAQC,6BAA6B,QAAO,eAAe;AAI3D,SACEC,yBAAyB,EACzBC,yBAAyB,QAEpB,4BAA4B;AACnC,SAAQC,wBAAwB,EAAEC,8BAA8B,QAAO,2BAA2B;AAelG,OAAO,SAASC,mBACdC,WAAmB,EACnBC,OAAoC;IAEpC,IAAI;QACF,MAAM,EAACC,QAAQ,EAAEC,mBAAmB,EAAC,GAAGL,+BAA+BE;QACvE,MAAMI,WAA2C,EAAE;QACnD,MAAMC,QAAQT,0BAA0BM,UAAU;YAChDI,qBAAqBL,QAAQK,mBAAmB,IAAIZ;YACpDa,wBAAwBN,QAAQM,sBAAsB;YACtDC,8BAA8BP,QAAQO,4BAA4B;YAClEL;YACAC;QACF;QACA,OAAO;YAACK,OAAO;YAAMC,YAAY;gBAACR;gBAAUG;YAAK;YAAGD,UAAUO,sBAAsBP;QAAS;IAC/F,EAAE,OAAOQ,OAAO;QACd,OAAO;YAACH,OAAO;YAAOI,QAAQC,oBAAoBF;QAAM;IAC1D;AACF;AAEA,SAASD,sBACPI,MAA+C;IAE/C,OAAOA,OAAOC,GAAG,CAAC,CAACC,QACjBC,kBAAkB;YAChBC,MAAMF,MAAME,IAAI;YAChBC,SAASH,MAAMG,OAAO;YACtBC,MAAMJ,MAAMI,IAAI,CAACC,IAAI,CAAC,QAAQC;QAChC;AAEJ;AAEA,SAAST,oBAAoBF,KAAc;IACzC,IAAIA,iBAAiBf,0BAA0B;QAC7C,OAAO;YACL2B,gBAAgB;gBACdJ,SAASR,MAAMQ,OAAO;gBACtBC,MACET,MAAMa,QAAQ,KAAKF,YACfA,YACA,GAAGX,MAAMa,QAAQ,CAACC,IAAI,CAAC,CAAC,EAAEd,MAAMa,QAAQ,CAACE,MAAM,EAAE;YACzD;SACD;IACH;IAEA,IAAIf,iBAAiBnB,8BAA8B;QACjD,OAAOmB,MAAMY,eAAe,CAACT,MAAM,CAACC,GAAG,CAAC,CAACC,QACvCO,gBAAgB;gBACdJ,SAASH,MAAMG,OAAO;gBACtBC,MAAMJ,MAAMI,IAAI,CAACC,IAAI,CAAC,QAAQC;YAChC;IAEJ;IAEA,IAAIX,iBAAiBjB,2BAA2B;QAC9C,OAAOiB,MAAMG,MAAM,CAACC,GAAG,CAAC,CAACC,QACvBO,gBAAgB;gBAACJ,SAASH,MAAMG,OAAO;gBAAEC,MAAMJ,MAAMI,IAAI,CAACC,IAAI,CAAC;YAAI;IAEvE;IAEA,MAAMV;AACR;AAEA,SAASY,gBAAgBI,MAAoD;IAC3E,IAAIA,OAAOP,IAAI,KAAKE,WAAW,OAAO;QAACH,SAASQ,OAAOR,OAAO;IAAA;IAC9D,OAAO;QAACA,SAASQ,OAAOR,OAAO;QAAEC,MAAMO,OAAOP,IAAI;IAAA;AACpD;AAEA,SAASH,kBAAkBU,MAI1B;IACC,IAAIA,OAAOP,IAAI,KAAKE,WAAW,OAAO;QAACJ,MAAMS,OAAOT,IAAI;QAAEC,SAASQ,OAAOR,OAAO;IAAA;IACjF,OAAO;QAACD,MAAMS,OAAOT,IAAI;QAAEC,SAASQ,OAAOR,OAAO;QAAEC,MAAMO,OAAOP,IAAI;IAAA;AACvE"}

package/dist/core/workflow-model/index.d.ts

@@ -1,4 +1,4 @@
 export { DEFAULT_RUN_TIMEOUT_MS } from './constants.js';
-export { InvalidWorkflowModelError, invalidWorkflowModelErrorCode, type WorkflowModelValidationIssue, type WorkflowModelValidationIssueCode, type WorkflowModelValidationIssuePathSegment, } from './invalid-workflow-model-error.js';
+export { InvalidWorkflowModelError, invalidWorkflowModelErrorCode, type WorkflowModelValidationIssue, type WorkflowModelValidationIssueCode, type WorkflowModelValidationIssuePathSegment, type WorkflowModelValidationIssueSeverity, } from './invalid-workflow-model-error.js';
 export { normalizeWorkflowDocument } from './normalize-workflow-document.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/core/workflow-model/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/workflow-model/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,sBAAsB,EAAC,MAAM,gBAAgB,CAAC;AACtD,OAAO,EACL,yBAAyB,EACzB,6BAA6B,EAC7B,KAAK,4BAA4B,EACjC,KAAK,gCAAgC,EACrC,KAAK,uCAAuC,GAC7C,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAC,yBAAyB,EAAC,MAAM,kCAAkC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/workflow-model/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,sBAAsB,EAAC,MAAM,gBAAgB,CAAC;AACtD,OAAO,EACL,yBAAyB,EACzB,6BAA6B,EAC7B,KAAK,4BAA4B,EACjC,KAAK,gCAAgC,EACrC,KAAK,uCAAuC,EAC5C,KAAK,oCAAoC,GAC1C,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAC,yBAAyB,EAAC,MAAM,kCAAkC,CAAC"}

package/dist/core/workflow-model/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/core/workflow-model/index.ts"],"sourcesContent":["export {DEFAULT_RUN_TIMEOUT_MS} from './constants.js';\nexport {\n  InvalidWorkflowModelError,\n  invalidWorkflowModelErrorCode,\n  type WorkflowModelValidationIssue,\n  type WorkflowModelValidationIssueCode,\n  type WorkflowModelValidationIssuePathSegment,\n} from './invalid-workflow-model-error.js';\nexport {normalizeWorkflowDocument} from './normalize-workflow-document.js';\n"],"names":["DEFAULT_RUN_TIMEOUT_MS","InvalidWorkflowModelError","invalidWorkflowModelErrorCode","normalizeWorkflowDocument"],"mappings":"AAAA,SAAQA,sBAAsB,QAAO,iBAAiB;AACtD,SACEC,yBAAyB,EACzBC,6BAA6B,QAIxB,oCAAoC;AAC3C,SAAQC,yBAAyB,QAAO,mCAAmC"}
+{"version":3,"sources":["../../../src/core/workflow-model/index.ts"],"sourcesContent":["export {DEFAULT_RUN_TIMEOUT_MS} from './constants.js';\nexport {\n  InvalidWorkflowModelError,\n  invalidWorkflowModelErrorCode,\n  type WorkflowModelValidationIssue,\n  type WorkflowModelValidationIssueCode,\n  type WorkflowModelValidationIssuePathSegment,\n  type WorkflowModelValidationIssueSeverity,\n} from './invalid-workflow-model-error.js';\nexport {normalizeWorkflowDocument} from './normalize-workflow-document.js';\n"],"names":["DEFAULT_RUN_TIMEOUT_MS","InvalidWorkflowModelError","invalidWorkflowModelErrorCode","normalizeWorkflowDocument"],"mappings":"AAAA,SAAQA,sBAAsB,QAAO,iBAAiB;AACtD,SACEC,yBAAyB,EACzBC,6BAA6B,QAKxB,oCAAoC;AAC3C,SAAQC,yBAAyB,QAAO,mCAAmC"}

package/dist/core/workflow-model/invalid-workflow-model-error.d.ts

@@ -1,11 +1,13 @@
 export declare const invalidWorkflowModelErrorCode = "invalid-workflow-model";
-export type WorkflowModelValidationIssueCode = 'context-unavailable-at-fill-site' | 'context-unavailable-at-predicate-site' | 'computed-context-key' | 'duplicate-job-id' | 'duplicate-step-id' | 'duplicate-trigger-id' | 'harness-provider-incompatible' | 'harness-thinking-incompatible' | 'harness-tool-incompatible' | 'integration-connection-not-capable' | 'integration-connection-not-found' | 'integration-write-not-allowed' | 'invalid-cron-event' | 'invalid-cron-schedule' | 'invalid-cron-timezone' | 'invalid-provider' | 'invalid-trigger-filter' | 'invalid-interpolation-expression' | 'invalid-interpolation-template' | 'invalid-duration' | 'invalid-listener-filter' | 'invalid-job-if' | 'invalid-job-output' | 'invalid-job-success' | 'invalid-output-schema' | 'invalid-runner-label' | 'invalid-step-gate-restart-from' | 'invalid-step-gate-success' | 'invalid-step-if' | 'job-dependency-cycle' | 'listening-job-missing-resolution-source' | 'listening-timeout-exceeds-run-timeout' | 'missing-harness-for-tools' | 'missing-connection-for-integration' | 'missing-job-needs-edge' | 'missing-cron-schedule' | 'missing-runner-label' | 'multiple-manual-triggers' | 'runner-context-not-bare' | 'runner-context-in-field' | 'runner-context-in-server-predicate' | 'self-job-dependency' | 'too-many-runner-labels' | 'unknown-secret-store' | 'unknown-interpolation-context' | 'unknown-integration-method' | 'unknown-integration-tool' | 'unknown-job-dependency' | 'untrusted-context-in-field' | 'vars-context-in-server-predicate';
+export type WorkflowModelValidationIssueCode = 'context-unavailable-at-fill-site' | 'dynamic-name-self-reference' | 'context-unavailable-at-predicate-site' | 'computed-context-key' | 'checkout-target-invalid' | 'duplicate-job-id' | 'duplicate-step-id' | 'duplicate-trigger-id' | 'harness-provider-incompatible' | 'harness-thinking-incompatible' | 'harness-tool-incompatible' | 'integration-connection-not-capable' | 'integration-connection-not-found' | 'integration-write-not-allowed' | 'invalid-cron-event' | 'invalid-cron-schedule' | 'invalid-cron-timezone' | 'invalid-provider' | 'invalid-trigger-filter' | 'invalid-interpolation-expression' | 'invalid-interpolation-template' | 'invalid-duration' | 'invalid-listener-filter' | 'invalid-model' | 'invalid-job-if' | 'invalid-job-output' | 'invalid-job-success' | 'invalid-output-schema' | 'invalid-runner-label' | 'invalid-step-gate-restart-from' | 'invalid-step-gate-success' | 'invalid-step-if' | 'job-dependency-cycle' | 'listening-job-missing-resolution-source' | 'listening-timeout-exceeds-run-timeout' | 'missing-harness-for-tools' | 'missing-connection-for-integration' | 'missing-job-needs-edge' | 'missing-cron-schedule' | 'missing-runner-label' | 'multiple-manual-triggers' | 'runner-context-not-bare' | 'runner-context-in-field' | 'runner-context-in-server-predicate' | 're-evaluating-command' | 'self-job-dependency' | 'too-many-runner-labels' | 'unknown-secret-store' | 'unknown-interpolation-context' | 'unknown-integration-method' | 'unknown-integration-tool' | 'unknown-job-dependency' | 'untrusted-agent-selection-context';
 export type WorkflowModelValidationIssuePathSegment = string | number;
+export type WorkflowModelValidationIssueSeverity = 'error' | 'warning';
 export interface WorkflowModelValidationIssue {
     readonly code: WorkflowModelValidationIssueCode;
     readonly message: string;
     readonly path: readonly WorkflowModelValidationIssuePathSegment[];
     readonly details?: Readonly<Record<string, unknown>>;
+    readonly severity?: WorkflowModelValidationIssueSeverity;
 }
 export declare class InvalidWorkflowModelError extends Error {
     readonly issues: readonly WorkflowModelValidationIssue[];