@shipfox/api-definitions 12.3.0 → 14.0.0

package/.turbo/turbo-build.log

@@ -1,20 +1,20 @@
 $ shipfox-swc && shipfox-temporal-bundle dist/temporal/workflows/index.js
-Successfully compiled: 75 files with swc (565.09ms)
-2026-08-07T08:46:28.995Z [INFO] asset workflow-bundle-db3e4e474e0c4d6a3553.js 4.01 MiB [emitted] [immutable] (name: main)
+Successfully compiled: 79 files with swc (483.81ms)
+2026-08-23T20:27:02.315Z [INFO] asset workflow-bundle-3f8e06c1c05b04ce000f.js 4.02 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/ 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
+modules by path ../definitions-dto/dist/ 8.2 KiB
+  modules by path ../definitions-dto/dist/*.js 3.54 KiB 3 modules
+  modules by path ../definitions-dto/dist/schemas/*.js 4.66 KiB 3 modules
+modules by path ./dist/ 6.25 KiB
+  modules by path ./dist/temporal/workflows/*.js 3.35 KiB 2 modules
   ./dist/temporal/workflows/index-autogenerated-entrypoint.cjs 936 bytes [built] [code generated]
-  ./dist/core/entities/sync-state.js 1.2 KiB [built] [code generated]
+  ./dist/core/entities/sync-state.js 1.99 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 8382 ms
-2026-08-07T08:46:29.013Z [INFO] Workflow bundle created { size: '4.01MB' }
-/home/runner/work/shipfox/shipfox/libs/api/definitions/dist/temporal/workflows/index.js: 4207937 bytes
+webpack 5.107.2 compiled successfully in 10012 ms
+2026-08-23T20:27:02.327Z [INFO] Workflow bundle created { size: '4.02MB' }
+/home/runner/work/shipfox/shipfox/libs/api/definitions/dist/temporal/workflows/index.js: 4212204 bytes

package/CHANGELOG.md

@@ -1,5 +1,50 @@
 # @shipfox/api-definitions
 
+## 14.0.0
+
+### Major Changes
+
+- f7b3db8: Replaces published definition warning exports and the sync `warnings` field with severity-aware diagnostics, including workflow file paths for the workflows UI.
+
+  Consumers must migrate from `warnings` to `diagnostics`; this release does not provide a legacy-field fallback.
+
+### Minor Changes
+
+- c0fc35b: Adds `resolveDefinitionAtRef` and `listDefinitionsAtRef` inter-module methods that resolve and validate workflow definitions at a git ref without persisting them.
+- 4f30864: Trigger `event` is now optional end to end. An omitted event subscribes to every event from its source. Explicit events continue to work unchanged. Built-in manual and scheduled triggers use `fire` and `tick`, respectively.
+- aeaa0de: Adds stable workflow lineage identifiers to definition records and the definitions inter-module contract. Existing definitions are reconciled when read or synchronized, so the schema migration does not backfill historical rows.
+- 1b71a66: Exposes each provider's event catalog and the fixed-event providers on the integration validation context. Every provider now refuses the reserved `manual` and `cron` connection slugs.
+
+### Patch Changes
+
+- a97890f: Makes trigger-scoped validation errors inert. Reports broken triggers as error diagnostics with their paths while the definition and its other triggers keep syncing.
+- a4df8d9: Resolves a workflow lineage id on GET /definitions/:id by selecting the project's default-branch row, or 404 when the file is not on that branch.
+- Updated dependencies [c0fc35b]
+- Updated dependencies [f7b3db8]
+- Updated dependencies [09924ca]
+- Updated dependencies [4f30864]
+- Updated dependencies [18e9bad]
+- Updated dependencies [a4df8d9]
+- Updated dependencies [aeaa0de]
+- Updated dependencies [c44641f]
+- Updated dependencies [1b71a66]
+  - @shipfox/api-definitions-dto@14.0.0
+  - @shipfox/api-agent-dto@14.0.0
+  - @shipfox/workflow-document@3.1.0
+  - @shipfox/api-integration-core-dto@14.0.0
+  - @shipfox/api-projects-dto@14.0.0
+  - @shipfox/expression@2.2.1
+
+## 13.1.0
+
+### Patch Changes
+
+- Updated dependencies [0d3c2e3]
+- Updated dependencies [5c100d6]
+- Updated dependencies [ca91dc3]
+- Updated dependencies [67aab38]
+  - @shipfox/api-agent-dto@13.1.0
+
 ## 12.3.0
 
 ### Patch Changes

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

@@ -1,6 +1,6 @@
 export * from './integration-context.js';
 export * from './sync-state.js';
-export * from './validation-warning.js';
+export * from './validation-diagnostic.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,yBAAyB,CAAC;AACxC,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,4BAA4B,CAAC;AAC3C,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC"}

package/dist/core/entities/index.js

@@ -1,6 +1,6 @@
 export * from './integration-context.js';
 export * from './sync-state.js';
-export * from './validation-warning.js';
+export * from './validation-diagnostic.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 './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"}
+{"version":3,"sources":["../../../src/core/entities/index.ts"],"sourcesContent":["export * from './integration-context.js';\nexport * from './sync-state.js';\nexport * from './validation-diagnostic.js';\nexport * from './workflow-definition.js';\nexport * from './workflow-model.js';\n"],"names":[],"mappings":"AAAA,cAAc,2BAA2B;AACzC,cAAc,kBAAkB;AAChC,cAAc,6BAA6B;AAC3C,cAAc,2BAA2B;AACzC,cAAc,sBAAsB"}

package/dist/core/entities/integration-context.d.ts

@@ -16,6 +16,10 @@ export interface IntegrationValidationContext {
         readonly provider: IntegrationProviderKind;
         readonly capabilities: readonly IntegrationCapability[];
     }>;
+    /** Documented event names per provider; provider-minted names are never a closed set. */
+    readonly eventCatalogs: ReadonlyMap<IntegrationProviderKind, ReadonlySet<string>>;
+    /** Providers whose single event name is Shipfox-minted (`webhook` today). */
+    readonly fixedEventProviders: ReadonlySet<IntegrationProviderKind>;
     readonly defaultConnectionSlug?: string | undefined;
 }
 export {};

package/dist/core/entities/integration-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"integration-context.d.ts","sourceRoot":"","sources":["../../../src/core/entities/integration-context.ts"],"names":[],"mappings":"AAAA,KAAK,uBAAuB,GAAG,MAAM,CAAC;AACtC,KAAK,qBAAqB,GAAG,gBAAgB,GAAG,aAAa,CAAC;AAE9D,UAAU,yBAAyB;IACjC,QAAQ,CAAC,SAAS,EAAE,SAAS,iBAAiB,EAAE,CAAC;CAClD;AAED,UAAU,iBAAiB;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,iBAAiB,GAAG,QAAQ,GAAG,YAAY,CAAC;IACtE,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;IACvC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,0BAA0B,EAAE,WAAW,CAC9C,uBAAuB,EACvB,yBAAyB,CAC1B,CAAC;IACF,QAAQ,CAAC,2BAA2B,EAAE,WAAW,CAC/C,MAAM,EACN;QACE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,QAAQ,EAAE,uBAAuB,CAAC;QAC3C,QAAQ,CAAC,YAAY,EAAE,SAAS,qBAAqB,EAAE,CAAC;KACzD,CACF,CAAC;IACF,QAAQ,CAAC,qBAAqB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACrD"}
+{"version":3,"file":"integration-context.d.ts","sourceRoot":"","sources":["../../../src/core/entities/integration-context.ts"],"names":[],"mappings":"AAAA,KAAK,uBAAuB,GAAG,MAAM,CAAC;AACtC,KAAK,qBAAqB,GAAG,gBAAgB,GAAG,aAAa,CAAC;AAE9D,UAAU,yBAAyB;IACjC,QAAQ,CAAC,SAAS,EAAE,SAAS,iBAAiB,EAAE,CAAC;CAClD;AAED,UAAU,iBAAiB;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,iBAAiB,GAAG,QAAQ,GAAG,YAAY,CAAC;IACtE,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;IACvC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,0BAA0B,EAAE,WAAW,CAC9C,uBAAuB,EACvB,yBAAyB,CAC1B,CAAC;IACF,QAAQ,CAAC,2BAA2B,EAAE,WAAW,CAC/C,MAAM,EACN;QACE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,QAAQ,EAAE,uBAAuB,CAAC;QAC3C,QAAQ,CAAC,YAAY,EAAE,SAAS,qBAAqB,EAAE,CAAC;KACzD,CACF,CAAC;IACF,yFAAyF;IACzF,QAAQ,CAAC,aAAa,EAAE,WAAW,CAAC,uBAAuB,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;IAClF,6EAA6E;IAC7E,QAAQ,CAAC,mBAAmB,EAAE,WAAW,CAAC,uBAAuB,CAAC,CAAC;IACnE,QAAQ,CAAC,qBAAqB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACrD"}

package/dist/core/entities/integration-context.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/core/entities/integration-context.ts"],"sourcesContent":["type IntegrationProviderKind = string;\ntype IntegrationCapability = 'source_control' | 'agent_tools';\n\ninterface AgentToolSelectionCatalog {\n  readonly selectors: readonly AgentToolSelector[];\n}\n\ninterface AgentToolSelector {\n  readonly token: string;\n  readonly kind: 'family' | 'family_wildcard' | 'method' | 'standalone';\n  readonly sensitivity: 'read' | 'write';\n  readonly sensitive: boolean;\n}\n\nexport interface IntegrationValidationContext {\n  readonly agentToolSelectionCatalogs: ReadonlyMap<\n    IntegrationProviderKind,\n    AgentToolSelectionCatalog\n  >;\n  readonly workspaceConnectionSnapshot: ReadonlyMap<\n    string,\n    {\n      readonly id: string;\n      readonly provider: IntegrationProviderKind;\n      readonly capabilities: readonly IntegrationCapability[];\n    }\n  >;\n  readonly defaultConnectionSlug?: string | undefined;\n}\n"],"names":[],"mappings":"AAcA,WAcC"}
+{"version":3,"sources":["../../../src/core/entities/integration-context.ts"],"sourcesContent":["type IntegrationProviderKind = string;\ntype IntegrationCapability = 'source_control' | 'agent_tools';\n\ninterface AgentToolSelectionCatalog {\n  readonly selectors: readonly AgentToolSelector[];\n}\n\ninterface AgentToolSelector {\n  readonly token: string;\n  readonly kind: 'family' | 'family_wildcard' | 'method' | 'standalone';\n  readonly sensitivity: 'read' | 'write';\n  readonly sensitive: boolean;\n}\n\nexport interface IntegrationValidationContext {\n  readonly agentToolSelectionCatalogs: ReadonlyMap<\n    IntegrationProviderKind,\n    AgentToolSelectionCatalog\n  >;\n  readonly workspaceConnectionSnapshot: ReadonlyMap<\n    string,\n    {\n      readonly id: string;\n      readonly provider: IntegrationProviderKind;\n      readonly capabilities: readonly IntegrationCapability[];\n    }\n  >;\n  /** Documented event names per provider; provider-minted names are never a closed set. */\n  readonly eventCatalogs: ReadonlyMap<IntegrationProviderKind, ReadonlySet<string>>;\n  /** Providers whose single event name is Shipfox-minted (`webhook` today). */\n  readonly fixedEventProviders: ReadonlySet<IntegrationProviderKind>;\n  readonly defaultConnectionSlug?: string | undefined;\n}\n"],"names":[],"mappings":"AAcA,WAkBC"}

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

@@ -1,7 +1,13 @@
-import type { ValidationWarning } from './validation-warning.js';
+import type { ValidationDiagnostic } from './validation-diagnostic.js';
 export type DefinitionSyncStatus = 'pending' | 'syncing' | 'succeeded' | 'failed';
-export type DefinitionSyncWarning = ValidationWarning;
-export declare function limitDefinitionSyncWarnings(warnings: readonly DefinitionSyncWarning[]): DefinitionSyncWarning[];
+export interface DefinitionSyncDiagnostic extends ValidationDiagnostic {
+    filePath?: string | undefined;
+}
+/**
+ * Orders errors before warnings and bounds the list so truncation at
+ * `DEFINITION_SYNC_DIAGNOSTICS_MAX_COUNT` drops warnings first.
+ */
+export declare function limitDefinitionSyncDiagnostics(diagnostics: readonly DefinitionSyncDiagnostic[]): DefinitionSyncDiagnostic[];
 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;
@@ -14,7 +20,7 @@ export interface DefinitionSyncState {
     status: DefinitionSyncStatus;
     lastErrorCode: DefinitionSyncErrorCode | null;
     lastErrorMessage: string | null;
-    warnings: DefinitionSyncWarning[];
+    diagnostics: DefinitionSyncDiagnostic[];
     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":"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,YACtC,mBAAmB,EACnB,oBAAoB,EACpB,+BAA+B,EAC/B,yBAAyB,EACzB,wBAAwB,EACxB,uBAAuB,EACvB,kBAAkB,EAClB,sBAAsB,EACtB,6BAA6B,EAC7B,mBAAmB,EACnB,gBAAgB,EAChB,wBAAwB,EACxB,SAAS,CACD,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"}
+{"version":3,"file":"sync-state.d.ts","sourceRoot":"","sources":["../../../src/core/entities/sync-state.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAC,oBAAoB,EAAC,MAAM,4BAA4B,CAAC;AAErE,MAAM,MAAM,oBAAoB,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;AAElF,MAAM,WAAW,wBAAyB,SAAQ,oBAAoB;IACpE,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/B;AAED;;;GAGG;AACH,wBAAgB,8BAA8B,CAC5C,WAAW,EAAE,SAAS,wBAAwB,EAAE,GAC/C,wBAAwB,EAAE,CAwB5B;AAED,eAAO,MAAM,2BAA2B,YACtC,mBAAmB,EACnB,oBAAoB,EACpB,+BAA+B,EAC/B,yBAAyB,EACzB,wBAAwB,EACxB,uBAAuB,EACvB,kBAAkB,EAClB,sBAAsB,EACtB,6BAA6B,EAC7B,mBAAmB,EACnB,gBAAgB,EAChB,wBAAwB,EACxB,SAAS,CACD,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,WAAW,EAAE,wBAAwB,EAAE,CAAC;IACxC,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,10 +1,29 @@
-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)
+import { DEFINITION_SYNC_DIAGNOSTIC_FILE_PATH_MAX_LENGTH, DEFINITION_SYNC_DIAGNOSTICS_MAX_COUNT, DEFINITION_SYNC_WARNING_CODE_MAX_LENGTH, DEFINITION_SYNC_WARNING_MESSAGE_MAX_LENGTH, DEFINITION_SYNC_WARNING_PATH_MAX_LENGTH } from '@shipfox/api-definitions-dto';
+/**
+ * Orders errors before warnings and bounds the list so truncation at
+ * `DEFINITION_SYNC_DIAGNOSTICS_MAX_COUNT` drops warnings first.
+ */ export function limitDefinitionSyncDiagnostics(diagnostics) {
+    const ordered = [];
+    for (const severity of [
+        'error',
+        'warning'
+    ]){
+        for (const diagnostic of diagnostics){
+            if (diagnostic.severity !== severity) continue;
+            ordered.push(diagnostic);
+            if (ordered.length === DEFINITION_SYNC_DIAGNOSTICS_MAX_COUNT) break;
+        }
+        if (ordered.length === DEFINITION_SYNC_DIAGNOSTICS_MAX_COUNT) break;
+    }
+    return ordered.map((diagnostic)=>({
+            code: diagnostic.code.slice(0, DEFINITION_SYNC_WARNING_CODE_MAX_LENGTH),
+            message: diagnostic.message.slice(0, DEFINITION_SYNC_WARNING_MESSAGE_MAX_LENGTH),
+            severity: diagnostic.severity,
+            ...diagnostic.path === undefined ? {} : {
+                path: diagnostic.path.slice(0, DEFINITION_SYNC_WARNING_PATH_MAX_LENGTH)
+            },
+            ...diagnostic.filePath === undefined ? {} : {
+                filePath: diagnostic.filePath.slice(0, DEFINITION_SYNC_DIAGNOSTIC_FILE_PATH_MAX_LENGTH)
             }
         }));
 }

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

@@ -1 +1 @@
-{"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"}
+{"version":3,"sources":["../../../src/core/entities/sync-state.ts"],"sourcesContent":["import {\n  DEFINITION_SYNC_DIAGNOSTIC_FILE_PATH_MAX_LENGTH,\n  DEFINITION_SYNC_DIAGNOSTICS_MAX_COUNT,\n  DEFINITION_SYNC_WARNING_CODE_MAX_LENGTH,\n  DEFINITION_SYNC_WARNING_MESSAGE_MAX_LENGTH,\n  DEFINITION_SYNC_WARNING_PATH_MAX_LENGTH,\n} from '@shipfox/api-definitions-dto';\nimport type {ValidationDiagnostic} from './validation-diagnostic.js';\n\nexport type DefinitionSyncStatus = 'pending' | 'syncing' | 'succeeded' | 'failed';\n\nexport interface DefinitionSyncDiagnostic extends ValidationDiagnostic {\n  filePath?: string | undefined;\n}\n\n/**\n * Orders errors before warnings and bounds the list so truncation at\n * `DEFINITION_SYNC_DIAGNOSTICS_MAX_COUNT` drops warnings first.\n */\nexport function limitDefinitionSyncDiagnostics(\n  diagnostics: readonly DefinitionSyncDiagnostic[],\n): DefinitionSyncDiagnostic[] {\n  const ordered: DefinitionSyncDiagnostic[] = [];\n  for (const severity of ['error', 'warning'] as const) {\n    for (const diagnostic of diagnostics) {\n      if (diagnostic.severity !== severity) continue;\n      ordered.push(diagnostic);\n      if (ordered.length === DEFINITION_SYNC_DIAGNOSTICS_MAX_COUNT) break;\n    }\n    if (ordered.length === DEFINITION_SYNC_DIAGNOSTICS_MAX_COUNT) break;\n  }\n\n  return ordered.map((diagnostic) => ({\n    code: diagnostic.code.slice(0, DEFINITION_SYNC_WARNING_CODE_MAX_LENGTH),\n    message: diagnostic.message.slice(0, DEFINITION_SYNC_WARNING_MESSAGE_MAX_LENGTH),\n    severity: diagnostic.severity,\n    ...(diagnostic.path === undefined\n      ? {}\n      : {path: diagnostic.path.slice(0, DEFINITION_SYNC_WARNING_PATH_MAX_LENGTH)}),\n    ...(diagnostic.filePath === undefined\n      ? {}\n      : {\n          filePath: diagnostic.filePath.slice(0, DEFINITION_SYNC_DIAGNOSTIC_FILE_PATH_MAX_LENGTH),\n        }),\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  diagnostics: DefinitionSyncDiagnostic[];\n  startedAt: Date | null;\n  finishedAt: Date | null;\n  createdAt: Date;\n  updatedAt: Date;\n}\n"],"names":["DEFINITION_SYNC_DIAGNOSTIC_FILE_PATH_MAX_LENGTH","DEFINITION_SYNC_DIAGNOSTICS_MAX_COUNT","DEFINITION_SYNC_WARNING_CODE_MAX_LENGTH","DEFINITION_SYNC_WARNING_MESSAGE_MAX_LENGTH","DEFINITION_SYNC_WARNING_PATH_MAX_LENGTH","limitDefinitionSyncDiagnostics","diagnostics","ordered","severity","diagnostic","push","length","map","code","slice","message","path","undefined","filePath","DEFINITION_SYNC_ERROR_CODES","isDefinitionSyncErrorCode","value","includes"],"mappings":"AAAA,SACEA,+CAA+C,EAC/CC,qCAAqC,EACrCC,uCAAuC,EACvCC,0CAA0C,EAC1CC,uCAAuC,QAClC,+BAA+B;AAStC;;;CAGC,GACD,OAAO,SAASC,+BACdC,WAAgD;IAEhD,MAAMC,UAAsC,EAAE;IAC9C,KAAK,MAAMC,YAAY;QAAC;QAAS;KAAU,CAAW;QACpD,KAAK,MAAMC,cAAcH,YAAa;YACpC,IAAIG,WAAWD,QAAQ,KAAKA,UAAU;YACtCD,QAAQG,IAAI,CAACD;YACb,IAAIF,QAAQI,MAAM,KAAKV,uCAAuC;QAChE;QACA,IAAIM,QAAQI,MAAM,KAAKV,uCAAuC;IAChE;IAEA,OAAOM,QAAQK,GAAG,CAAC,CAACH,aAAgB,CAAA;YAClCI,MAAMJ,WAAWI,IAAI,CAACC,KAAK,CAAC,GAAGZ;YAC/Ba,SAASN,WAAWM,OAAO,CAACD,KAAK,CAAC,GAAGX;YACrCK,UAAUC,WAAWD,QAAQ;YAC7B,GAAIC,WAAWO,IAAI,KAAKC,YACpB,CAAC,IACD;gBAACD,MAAMP,WAAWO,IAAI,CAACF,KAAK,CAAC,GAAGV;YAAwC,CAAC;YAC7E,GAAIK,WAAWS,QAAQ,KAAKD,YACxB,CAAC,IACD;gBACEC,UAAUT,WAAWS,QAAQ,CAACJ,KAAK,CAAC,GAAGd;YACzC,CAAC;QACP,CAAA;AACF;AAEA,OAAO,MAAMmB,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-diagnostic.d.ts

@@ -0,0 +1,8 @@
+export type ValidationDiagnosticSeverity = 'error' | 'warning';
+export interface ValidationDiagnostic {
+    code: string;
+    message: string;
+    path?: string | undefined;
+    severity: ValidationDiagnosticSeverity;
+}
+//# sourceMappingURL=validation-diagnostic.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validation-diagnostic.d.ts","sourceRoot":"","sources":["../../../src/core/entities/validation-diagnostic.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,4BAA4B,GAAG,OAAO,GAAG,SAAS,CAAC;AAE/D,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,QAAQ,EAAE,4BAA4B,CAAC;CACxC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/core/entities/validation-diagnostic.ts"],"sourcesContent":["export type ValidationDiagnosticSeverity = 'error' | 'warning';\n\nexport interface ValidationDiagnostic {\n  code: string;\n  message: string;\n  path?: string | undefined;\n  severity: ValidationDiagnosticSeverity;\n}\n"],"names":[],"mappings":"AAEA,WAKC"}

package/dist/core/entities/workflow-definition.d.ts

@@ -9,6 +9,8 @@ export interface WorkflowDefinitionPayload {
 }
 export interface WorkflowDefinition {
     id: string;
+    /** Stable identity per project and config path; pathless manual rows share a project lineage. */
+    workflowId: string;
     projectId: string;
     configPath: string | null;
     source: 'manual' | 'vcs';

package/dist/core/entities/workflow-definition.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workflow-definition.d.ts","sourceRoot":"","sources":["../../../src/core/entities/workflow-definition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,aAAa,EAAE,sBAAsB,EAAC,MAAM,8BAA8B,CAAC;AACxF,OAAO,KAAK,EAAC,gBAAgB,EAAC,MAAM,4BAA4B,CAAC;AAEjE,YAAY,EAAC,sBAAsB,EAAC,CAAC;AAErC,MAAM,MAAM,YAAY,GAAG,gBAAgB,CAAC;AAE5C,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,KAAK,EAAE,aAAa,CAAC;IACrB,cAAc,CAAC,EAAE,sBAAsB,GAAG,IAAI,CAAC;CAChD;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,EAAE,QAAQ,GAAG,KAAK,CAAC;IACzB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,UAAU,EAAE,YAAY,CAAC;IACzB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,KAAK,EAAE,aAAa,CAAC;IACrB,cAAc,EAAE,sBAAsB,GAAG,IAAI,CAAC;IAC9C,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,GAAG,IAAI,CAAC;CACxB"}
+{"version":3,"file":"workflow-definition.d.ts","sourceRoot":"","sources":["../../../src/core/entities/workflow-definition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,aAAa,EAAE,sBAAsB,EAAC,MAAM,8BAA8B,CAAC;AACxF,OAAO,KAAK,EAAC,gBAAgB,EAAC,MAAM,4BAA4B,CAAC;AAEjE,YAAY,EAAC,sBAAsB,EAAC,CAAC;AAErC,MAAM,MAAM,YAAY,GAAG,gBAAgB,CAAC;AAE5C,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,KAAK,EAAE,aAAa,CAAC;IACrB,cAAc,CAAC,EAAE,sBAAsB,GAAG,IAAI,CAAC;CAChD;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,iGAAiG;IACjG,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,EAAE,QAAQ,GAAG,KAAK,CAAC;IACzB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,UAAU,EAAE,YAAY,CAAC;IACzB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,KAAK,EAAE,aAAa,CAAC;IACrB,cAAc,EAAE,sBAAsB,GAAG,IAAI,CAAC;IAC9C,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,GAAG,IAAI,CAAC;CACxB"}

package/dist/core/entities/workflow-definition.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/core/entities/workflow-definition.ts"],"sourcesContent":["import type {WorkflowModel, WorkflowSourceSnapshot} from '@shipfox/api-definitions-dto';\nimport type {WorkflowDocument} from '@shipfox/workflow-document';\n\nexport type {WorkflowSourceSnapshot};\n\nexport type WorkflowSpec = WorkflowDocument;\n\nexport interface WorkflowDefinitionPayload {\n  document: WorkflowDocument;\n  model: WorkflowModel;\n  sourceSnapshot?: WorkflowSourceSnapshot | null;\n}\n\nexport interface WorkflowDefinition {\n  id: string;\n  projectId: string;\n  configPath: string | null;\n  source: 'manual' | 'vcs';\n  sha: string | null;\n  ref: string | null;\n  name: string;\n  /**\n   * Compatibility alias for packages that still consume the authoring document\n   * before they migrate to `document`/`model`.\n   */\n  definition: WorkflowSpec;\n  document: WorkflowDocument;\n  model: WorkflowModel;\n  sourceSnapshot: WorkflowSourceSnapshot | null;\n  contentHash: string | null;\n  fetchedAt: Date;\n  createdAt: Date;\n  updatedAt: Date;\n  deletedAt: Date | null;\n}\n"],"names":[],"mappings":"AAaA,WAqBC"}
+{"version":3,"sources":["../../../src/core/entities/workflow-definition.ts"],"sourcesContent":["import type {WorkflowModel, WorkflowSourceSnapshot} from '@shipfox/api-definitions-dto';\nimport type {WorkflowDocument} from '@shipfox/workflow-document';\n\nexport type {WorkflowSourceSnapshot};\n\nexport type WorkflowSpec = WorkflowDocument;\n\nexport interface WorkflowDefinitionPayload {\n  document: WorkflowDocument;\n  model: WorkflowModel;\n  sourceSnapshot?: WorkflowSourceSnapshot | null;\n}\n\nexport interface WorkflowDefinition {\n  id: string;\n  /** Stable identity per project and config path; pathless manual rows share a project lineage. */\n  workflowId: string;\n  projectId: string;\n  configPath: string | null;\n  source: 'manual' | 'vcs';\n  sha: string | null;\n  ref: string | null;\n  name: string;\n  /**\n   * Compatibility alias for packages that still consume the authoring document\n   * before they migrate to `document`/`model`.\n   */\n  definition: WorkflowSpec;\n  document: WorkflowDocument;\n  model: WorkflowModel;\n  sourceSnapshot: WorkflowSourceSnapshot | null;\n  contentHash: string | null;\n  fetchedAt: Date;\n  createdAt: Date;\n  updatedAt: Date;\n  deletedAt: Date | null;\n}\n"],"names":[],"mappings":"AAaA,WAuBC"}

package/dist/core/errors.d.ts

@@ -7,4 +7,14 @@ export declare class DefinitionSyncPermanentError extends Error {
     readonly code: DefinitionSyncErrorCode;
     constructor(code: DefinitionSyncErrorCode, message: string);
 }
+export type DefinitionAtRefErrorCode = 'project-not-found' | 'ref-not-found' | 'ref-invalid' | 'ref-moved' | 'file-not-found' | 'content-too-large' | 'invalid-definition' | 'too-many-files' | 'source-unavailable';
+/**
+ * Rejects a definition resolution or listing at a git ref. `details` carries
+ * the bounded context the presentation translates into known-error details.
+ */
+export declare class DefinitionAtRefError extends Error {
+    readonly code: DefinitionAtRefErrorCode;
+    readonly details: Record<string, unknown>;
+    constructor(code: DefinitionAtRefErrorCode, message: string, details?: Record<string, unknown>);
+}
 //# sourceMappingURL=errors.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,uBAAuB,EAAC,MAAM,0BAA0B,CAAC;AAEtE,qBAAa,oBAAqB,SAAQ,KAAK;IAGpC,OAAO,CAAC,EAAE,OAAO;IAF1B,YACE,OAAO,EAAE,MAAM,EACR,OAAO,CAAC,EAAE,OAAO,EAIzB;CACF;AAED,qBAAa,4BAA6B,SAAQ,KAAK;aAEnC,IAAI,EAAE,uBAAuB;IAD/C,YACkB,IAAI,EAAE,uBAAuB,EAC7C,OAAO,EAAE,MAAM,EAIhB;CACF"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,uBAAuB,EAAC,MAAM,0BAA0B,CAAC;AAEtE,qBAAa,oBAAqB,SAAQ,KAAK;IAGpC,OAAO,CAAC,EAAE,OAAO;IAF1B,YACE,OAAO,EAAE,MAAM,EACR,OAAO,CAAC,EAAE,OAAO,EAIzB;CACF;AAED,qBAAa,4BAA6B,SAAQ,KAAK;aAEnC,IAAI,EAAE,uBAAuB;IAD/C,YACkB,IAAI,EAAE,uBAAuB,EAC7C,OAAO,EAAE,MAAM,EAIhB;CACF;AAED,MAAM,MAAM,wBAAwB,GAChC,mBAAmB,GACnB,eAAe,GACf,aAAa,GACb,WAAW,GACX,gBAAgB,GAChB,mBAAmB,GACnB,oBAAoB,GACpB,gBAAgB,GAChB,oBAAoB,CAAC;AAEzB;;;GAGG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;aAE3B,IAAI,EAAE,wBAAwB;aAE9B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAHlD,YACkB,IAAI,EAAE,wBAAwB,EAC9C,OAAO,EAAE,MAAM,EACC,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EAItD;CACF"}

package/dist/core/errors.js

@@ -10,5 +10,14 @@ export class DefinitionSyncPermanentError extends Error {
         this.name = 'DefinitionSyncPermanentError';
     }
 }
+/**
+ * Rejects a definition resolution or listing at a git ref. `details` carries
+ * the bounded context the presentation translates into known-error details.
+ */ export class DefinitionAtRefError extends Error {
+    constructor(code, message, details = {}){
+        super(message), this.code = code, this.details = details;
+        this.name = 'DefinitionAtRefError';
+    }
+}
 
 //# sourceMappingURL=errors.js.map

package/dist/core/errors.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/core/errors.ts"],"sourcesContent":["import type {DefinitionSyncErrorCode} from './entities/sync-state.js';\n\nexport class DefinitionParseError extends Error {\n  constructor(\n    message: string,\n    public details?: unknown,\n  ) {\n    super(message);\n    this.name = 'DefinitionParseError';\n  }\n}\n\nexport class DefinitionSyncPermanentError extends Error {\n  constructor(\n    public readonly code: DefinitionSyncErrorCode,\n    message: string,\n  ) {\n    super(message);\n    this.name = 'DefinitionSyncPermanentError';\n  }\n}\n"],"names":["DefinitionParseError","Error","message","details","name","DefinitionSyncPermanentError","code"],"mappings":"AAEA,OAAO,MAAMA,6BAA6BC;IACxC,YACEC,OAAe,EACf,AAAOC,OAAiB,CACxB;QACA,KAAK,CAACD,eAFCC,UAAAA;QAGP,IAAI,CAACC,IAAI,GAAG;IACd;AACF;AAEA,OAAO,MAAMC,qCAAqCJ;IAChD,YACE,AAAgBK,IAA6B,EAC7CJ,OAAe,CACf;QACA,KAAK,CAACA,eAHUI,OAAAA;QAIhB,IAAI,CAACF,IAAI,GAAG;IACd;AACF"}
+{"version":3,"sources":["../../src/core/errors.ts"],"sourcesContent":["import type {DefinitionSyncErrorCode} from './entities/sync-state.js';\n\nexport class DefinitionParseError extends Error {\n  constructor(\n    message: string,\n    public details?: unknown,\n  ) {\n    super(message);\n    this.name = 'DefinitionParseError';\n  }\n}\n\nexport class DefinitionSyncPermanentError extends Error {\n  constructor(\n    public readonly code: DefinitionSyncErrorCode,\n    message: string,\n  ) {\n    super(message);\n    this.name = 'DefinitionSyncPermanentError';\n  }\n}\n\nexport type DefinitionAtRefErrorCode =\n  | 'project-not-found'\n  | 'ref-not-found'\n  | 'ref-invalid'\n  | 'ref-moved'\n  | 'file-not-found'\n  | 'content-too-large'\n  | 'invalid-definition'\n  | 'too-many-files'\n  | 'source-unavailable';\n\n/**\n * Rejects a definition resolution or listing at a git ref. `details` carries\n * the bounded context the presentation translates into known-error details.\n */\nexport class DefinitionAtRefError extends Error {\n  constructor(\n    public readonly code: DefinitionAtRefErrorCode,\n    message: string,\n    public readonly details: Record<string, unknown> = {},\n  ) {\n    super(message);\n    this.name = 'DefinitionAtRefError';\n  }\n}\n"],"names":["DefinitionParseError","Error","message","details","name","DefinitionSyncPermanentError","code","DefinitionAtRefError"],"mappings":"AAEA,OAAO,MAAMA,6BAA6BC;IACxC,YACEC,OAAe,EACf,AAAOC,OAAiB,CACxB;QACA,KAAK,CAACD,eAFCC,UAAAA;QAGP,IAAI,CAACC,IAAI,GAAG;IACd;AACF;AAEA,OAAO,MAAMC,qCAAqCJ;IAChD,YACE,AAAgBK,IAA6B,EAC7CJ,OAAe,CACf;QACA,KAAK,CAACA,eAHUI,OAAAA;QAIhB,IAAI,CAACF,IAAI,GAAG;IACd;AACF;AAaA;;;CAGC,GACD,OAAO,MAAMG,6BAA6BN;IACxC,YACE,AAAgBK,IAA8B,EAC9CJ,OAAe,EACf,AAAgBC,UAAmC,CAAC,CAAC,CACrD;QACA,KAAK,CAACD,eAJUI,OAAAA,WAEAH,UAAAA;QAGhB,IAAI,CAACC,IAAI,GAAG;IACd;AACF"}

package/dist/core/index.d.ts

@@ -1,6 +1,7 @@
 export type * from './entities/index.js';
-export { DefinitionParseError, DefinitionSyncPermanentError, } from './errors.js';
+export { DefinitionAtRefError, type DefinitionAtRefErrorCode, DefinitionParseError, DefinitionSyncPermanentError, } from './errors.js';
 export { parseDefinition } from './parse-definition.js';
+export { type DefinitionAtRefFile, type DefinitionsAtRefListing, type ListDefinitionsAtRefParams, listDefinitionsAtRef, type ResolveDefinitionAtRefParams, type ResolvedDefinitionAtRef, resolveDefinitionAtRef, type ValidationWarning, } from './resolve-definition-at-ref.js';
 export { classifySyncFailure, DEFAULT_WORKFLOW_PATH, type DiscoverWorkflowFilesParams, discoverWorkflowFiles, type FetchAndParseWorkflowsParams, FILE_FETCH_CONCURRENCY, fetchAndParseWorkflows, MAX_WORKFLOW_FILES, type ParsedWorkflow, type ResolvedSyncSource, resolveSyncSource, type SyncFailureClassification, type SyncSourceContext, UNRESOLVED_SYNC_REF, } from './sync-definitions.js';
 export { DEFAULT_RUN_TIMEOUT_MS } from './workflow-model/constants.js';
 export { normalizeWorkflowDocument } from './workflow-model/index.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,mBAAmB,qBAAqB,CAAC;AACzC,OAAO,EACL,oBAAoB,EACpB,4BAA4B,GAC7B,MAAM,aAAa,CAAC;AACrB,OAAO,EAAC,eAAe,EAAC,MAAM,uBAAuB,CAAC;AACtD,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,KAAK,2BAA2B,EAChC,qBAAqB,EACrB,KAAK,4BAA4B,EACjC,sBAAsB,EACtB,sBAAsB,EACtB,kBAAkB,EAClB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,iBAAiB,EACjB,KAAK,yBAAyB,EAC9B,KAAK,iBAAiB,EACtB,mBAAmB,GACpB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAC,sBAAsB,EAAC,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAC,yBAAyB,EAAC,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAC,oBAAoB,EAAC,MAAM,4CAA4C,CAAC;AAChF,OAAO,EAAC,mBAAmB,EAAC,MAAM,2CAA2C,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,mBAAmB,qBAAqB,CAAC;AACzC,OAAO,EACL,oBAAoB,EACpB,KAAK,wBAAwB,EAC7B,oBAAoB,EACpB,4BAA4B,GAC7B,MAAM,aAAa,CAAC;AACrB,OAAO,EAAC,eAAe,EAAC,MAAM,uBAAuB,CAAC;AACtD,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,EAC5B,KAAK,0BAA0B,EAC/B,oBAAoB,EACpB,KAAK,4BAA4B,EACjC,KAAK,uBAAuB,EAC5B,sBAAsB,EACtB,KAAK,iBAAiB,GACvB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,KAAK,2BAA2B,EAChC,qBAAqB,EACrB,KAAK,4BAA4B,EACjC,sBAAsB,EACtB,sBAAsB,EACtB,kBAAkB,EAClB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,iBAAiB,EACjB,KAAK,yBAAyB,EAC9B,KAAK,iBAAiB,EACtB,mBAAmB,GACpB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAC,sBAAsB,EAAC,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAC,yBAAyB,EAAC,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAC,oBAAoB,EAAC,MAAM,4CAA4C,CAAC;AAChF,OAAO,EAAC,mBAAmB,EAAC,MAAM,2CAA2C,CAAC"}

package/dist/core/index.js

@@ -1,5 +1,6 @@
-export { DefinitionParseError, DefinitionSyncPermanentError } from './errors.js';
+export { DefinitionAtRefError, DefinitionParseError, DefinitionSyncPermanentError } from './errors.js';
 export { parseDefinition } from './parse-definition.js';
+export { listDefinitionsAtRef, resolveDefinitionAtRef } from './resolve-definition-at-ref.js';
 export { classifySyncFailure, DEFAULT_WORKFLOW_PATH, discoverWorkflowFiles, FILE_FETCH_CONCURRENCY, fetchAndParseWorkflows, MAX_WORKFLOW_FILES, resolveSyncSource, UNRESOLVED_SYNC_REF } from './sync-definitions.js';
 export { DEFAULT_RUN_TIMEOUT_MS } from './workflow-model/constants.js';
 export { normalizeWorkflowDocument } from './workflow-model/index.js';

package/dist/core/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/core/index.ts"],"sourcesContent":["export type * from './entities/index.js';\nexport {\n  DefinitionParseError,\n  DefinitionSyncPermanentError,\n} from './errors.js';\nexport {parseDefinition} from './parse-definition.js';\nexport {\n  classifySyncFailure,\n  DEFAULT_WORKFLOW_PATH,\n  type DiscoverWorkflowFilesParams,\n  discoverWorkflowFiles,\n  type FetchAndParseWorkflowsParams,\n  FILE_FETCH_CONCURRENCY,\n  fetchAndParseWorkflows,\n  MAX_WORKFLOW_FILES,\n  type ParsedWorkflow,\n  type ResolvedSyncSource,\n  resolveSyncSource,\n  type SyncFailureClassification,\n  type SyncSourceContext,\n  UNRESOLVED_SYNC_REF,\n} from './sync-definitions.js';\nexport {DEFAULT_RUN_TIMEOUT_MS} from './workflow-model/constants.js';\nexport {normalizeWorkflowDocument} from './workflow-model/index.js';\nexport {DEFAULT_JOB_CHECKOUT} from './workflow-model/normalize-job-checkout.js';\nexport {DEFAULT_JOB_SUCCESS} from './workflow-model/normalize-job-success.js';\n"],"names":["DefinitionParseError","DefinitionSyncPermanentError","parseDefinition","classifySyncFailure","DEFAULT_WORKFLOW_PATH","discoverWorkflowFiles","FILE_FETCH_CONCURRENCY","fetchAndParseWorkflows","MAX_WORKFLOW_FILES","resolveSyncSource","UNRESOLVED_SYNC_REF","DEFAULT_RUN_TIMEOUT_MS","normalizeWorkflowDocument","DEFAULT_JOB_CHECKOUT","DEFAULT_JOB_SUCCESS"],"mappings":"AACA,SACEA,oBAAoB,EACpBC,4BAA4B,QACvB,cAAc;AACrB,SAAQC,eAAe,QAAO,wBAAwB;AACtD,SACEC,mBAAmB,EACnBC,qBAAqB,EAErBC,qBAAqB,EAErBC,sBAAsB,EACtBC,sBAAsB,EACtBC,kBAAkB,EAGlBC,iBAAiB,EAGjBC,mBAAmB,QACd,wBAAwB;AAC/B,SAAQC,sBAAsB,QAAO,gCAAgC;AACrE,SAAQC,yBAAyB,QAAO,4BAA4B;AACpE,SAAQC,oBAAoB,QAAO,6CAA6C;AAChF,SAAQC,mBAAmB,QAAO,4CAA4C"}
+{"version":3,"sources":["../../src/core/index.ts"],"sourcesContent":["export type * from './entities/index.js';\nexport {\n  DefinitionAtRefError,\n  type DefinitionAtRefErrorCode,\n  DefinitionParseError,\n  DefinitionSyncPermanentError,\n} from './errors.js';\nexport {parseDefinition} from './parse-definition.js';\nexport {\n  type DefinitionAtRefFile,\n  type DefinitionsAtRefListing,\n  type ListDefinitionsAtRefParams,\n  listDefinitionsAtRef,\n  type ResolveDefinitionAtRefParams,\n  type ResolvedDefinitionAtRef,\n  resolveDefinitionAtRef,\n  type ValidationWarning,\n} from './resolve-definition-at-ref.js';\nexport {\n  classifySyncFailure,\n  DEFAULT_WORKFLOW_PATH,\n  type DiscoverWorkflowFilesParams,\n  discoverWorkflowFiles,\n  type FetchAndParseWorkflowsParams,\n  FILE_FETCH_CONCURRENCY,\n  fetchAndParseWorkflows,\n  MAX_WORKFLOW_FILES,\n  type ParsedWorkflow,\n  type ResolvedSyncSource,\n  resolveSyncSource,\n  type SyncFailureClassification,\n  type SyncSourceContext,\n  UNRESOLVED_SYNC_REF,\n} from './sync-definitions.js';\nexport {DEFAULT_RUN_TIMEOUT_MS} from './workflow-model/constants.js';\nexport {normalizeWorkflowDocument} from './workflow-model/index.js';\nexport {DEFAULT_JOB_CHECKOUT} from './workflow-model/normalize-job-checkout.js';\nexport {DEFAULT_JOB_SUCCESS} from './workflow-model/normalize-job-success.js';\n"],"names":["DefinitionAtRefError","DefinitionParseError","DefinitionSyncPermanentError","parseDefinition","listDefinitionsAtRef","resolveDefinitionAtRef","classifySyncFailure","DEFAULT_WORKFLOW_PATH","discoverWorkflowFiles","FILE_FETCH_CONCURRENCY","fetchAndParseWorkflows","MAX_WORKFLOW_FILES","resolveSyncSource","UNRESOLVED_SYNC_REF","DEFAULT_RUN_TIMEOUT_MS","normalizeWorkflowDocument","DEFAULT_JOB_CHECKOUT","DEFAULT_JOB_SUCCESS"],"mappings":"AACA,SACEA,oBAAoB,EAEpBC,oBAAoB,EACpBC,4BAA4B,QACvB,cAAc;AACrB,SAAQC,eAAe,QAAO,wBAAwB;AACtD,SAIEC,oBAAoB,EAGpBC,sBAAsB,QAEjB,iCAAiC;AACxC,SACEC,mBAAmB,EACnBC,qBAAqB,EAErBC,qBAAqB,EAErBC,sBAAsB,EACtBC,sBAAsB,EACtBC,kBAAkB,EAGlBC,iBAAiB,EAGjBC,mBAAmB,QACd,wBAAwB;AAC/B,SAAQC,sBAAsB,QAAO,gCAAgC;AACrE,SAAQC,yBAAyB,QAAO,4BAA4B;AACpE,SAAQC,oBAAoB,QAAO,6CAA6C;AAChF,SAAQC,mBAAmB,QAAO,4CAA4C"}

package/dist/core/integrations.d.ts

@@ -5,7 +5,7 @@ export type DefinitionsSourceControl = {
     fetchFile: IntegrationsModuleClient['fetchSourceFile'];
 };
 export declare function createDefinitionsSourceControl(integrations: IntegrationsModuleClient): DefinitionsSourceControl;
-export declare function loadIntegrationValidationContext(integrations: IntegrationsModuleClient, workspaceId: string, defaultConnectionId: string): Promise<{
+export declare function loadIntegrationValidationContext(integrations: IntegrationsModuleClient, workspaceId: string, defaultConnectionId: string, signal?: AbortSignal): Promise<{
     agentToolSelectionCatalogs: Map<string, {
         selectors: {
             token: string;
@@ -19,6 +19,8 @@ export declare function loadIntegrationValidationContext(integrations: Integrati
         provider: string;
         capabilities: ("agent_tools" | "source_control")[];
     }>;
+    eventCatalogs: Map<string, Set<string>>;
+    fixedEventProviders: Set<string>;
     defaultConnectionSlug: string | undefined;
 }>;
 export { integrationsInterModuleContract };

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

@@ -1 +1 @@
-{"version":3,"file":"integrations.d.ts","sourceRoot":"","sources":["../../src/core/integrations.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,wBAAwB,EAC7B,+BAA+B,EAChC,MAAM,gDAAgD,CAAC;AAExD,MAAM,MAAM,wBAAwB,GAAG;IACrC,iBAAiB,EAAE,wBAAwB,CAAC,yBAAyB,CAAC,CAAC;IACvE,SAAS,EAAE,wBAAwB,CAAC,iBAAiB,CAAC,CAAC;IACvD,SAAS,EAAE,wBAAwB,CAAC,iBAAiB,CAAC,CAAC;CACxD,CAAC;AAEF,wBAAgB,8BAA8B,CAC5C,YAAY,EAAE,wBAAwB,GACrC,wBAAwB,CAM1B;AAED,wBAAsB,gCAAgC,CACpD,YAAY,EAAE,wBAAwB,EACtC,WAAW,EAAE,MAAM,EACnB,mBAAmB,EAAE,MAAM;;;;;;;;;;;;;;;GAY5B;AAED,OAAO,EAAC,+BAA+B,EAAC,CAAC"}
+{"version":3,"file":"integrations.d.ts","sourceRoot":"","sources":["../../src/core/integrations.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,wBAAwB,EAC7B,+BAA+B,EAChC,MAAM,gDAAgD,CAAC;AAExD,MAAM,MAAM,wBAAwB,GAAG;IACrC,iBAAiB,EAAE,wBAAwB,CAAC,yBAAyB,CAAC,CAAC;IACvE,SAAS,EAAE,wBAAwB,CAAC,iBAAiB,CAAC,CAAC;IACvD,SAAS,EAAE,wBAAwB,CAAC,iBAAiB,CAAC,CAAC;CACxD,CAAC;AAEF,wBAAgB,8BAA8B,CAC5C,YAAY,EAAE,wBAAwB,GACrC,wBAAwB,CAM1B;AAED,wBAAsB,gCAAgC,CACpD,YAAY,EAAE,wBAAwB,EACtC,WAAW,EAAE,MAAM,EACnB,mBAAmB,EAAE,MAAM,EAC3B,MAAM,CAAC,EAAE,WAAW;;;;;;;;;;;;;;;;;GAoBrB;AAED,OAAO,EAAC,+BAA+B,EAAC,CAAC"}

package/dist/core/integrations.js

@@ -6,10 +6,13 @@ export function createDefinitionsSourceControl(integrations) {
         fetchFile: integrations.fetchSourceFile
     };
 }
-export async function loadIntegrationValidationContext(integrations, workspaceId, defaultConnectionId) {
-    const context = await integrations.getAgentToolsContext({
+export async function loadIntegrationValidationContext(integrations, workspaceId, defaultConnectionId, signal) {
+    const input = {
         workspaceId,
         defaultConnectionId
+    };
+    const context = signal === undefined ? await integrations.getAgentToolsContext(input) : await integrations.getAgentToolsContext(input, {
+        signal
     });
     return {
         agentToolSelectionCatalogs: new Map(context.selectionCatalogs.map(({ provider, selectors })=>[
@@ -22,6 +25,11 @@ export async function loadIntegrationValidationContext(integrations, workspaceId
                 slug,
                 connection
             ])),
+        eventCatalogs: new Map(context.eventCatalogs.map(({ provider, events })=>[
+                provider,
+                new Set(events)
+            ])),
+        fixedEventProviders: new Set(context.fixedEventProviders),
         defaultConnectionSlug: context.defaultConnection?.slug
     };
 }

package/dist/core/integrations.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/core/integrations.ts"],"sourcesContent":["import {\n  type IntegrationsModuleClient,\n  integrationsInterModuleContract,\n} from '@shipfox/api-integration-core-dto/inter-module';\n\nexport type DefinitionsSourceControl = {\n  resolveRepository: IntegrationsModuleClient['resolveSourceRepository'];\n  listFiles: IntegrationsModuleClient['listSourceFiles'];\n  fetchFile: IntegrationsModuleClient['fetchSourceFile'];\n};\n\nexport function createDefinitionsSourceControl(\n  integrations: IntegrationsModuleClient,\n): DefinitionsSourceControl {\n  return {\n    resolveRepository: integrations.resolveSourceRepository,\n    listFiles: integrations.listSourceFiles,\n    fetchFile: integrations.fetchSourceFile,\n  };\n}\n\nexport async function loadIntegrationValidationContext(\n  integrations: IntegrationsModuleClient,\n  workspaceId: string,\n  defaultConnectionId: string,\n) {\n  const context = await integrations.getAgentToolsContext({workspaceId, defaultConnectionId});\n  return {\n    agentToolSelectionCatalogs: new Map(\n      context.selectionCatalogs.map(({provider, selectors}) => [provider, {selectors}]),\n    ),\n    workspaceConnectionSnapshot: new Map(\n      context.workspaceConnections.map(({slug, ...connection}) => [slug, connection]),\n    ),\n    defaultConnectionSlug: context.defaultConnection?.slug,\n  };\n}\n\nexport {integrationsInterModuleContract};\n"],"names":["integrationsInterModuleContract","createDefinitionsSourceControl","integrations","resolveRepository","resolveSourceRepository","listFiles","listSourceFiles","fetchFile","fetchSourceFile","loadIntegrationValidationContext","workspaceId","defaultConnectionId","context","getAgentToolsContext","agentToolSelectionCatalogs","Map","selectionCatalogs","map","provider","selectors","workspaceConnectionSnapshot","workspaceConnections","slug","connection","defaultConnectionSlug","defaultConnection"],"mappings":"AAAA,SAEEA,+BAA+B,QAC1B,iDAAiD;AAQxD,OAAO,SAASC,+BACdC,YAAsC;IAEtC,OAAO;QACLC,mBAAmBD,aAAaE,uBAAuB;QACvDC,WAAWH,aAAaI,eAAe;QACvCC,WAAWL,aAAaM,eAAe;IACzC;AACF;AAEA,OAAO,eAAeC,iCACpBP,YAAsC,EACtCQ,WAAmB,EACnBC,mBAA2B;IAE3B,MAAMC,UAAU,MAAMV,aAAaW,oBAAoB,CAAC;QAACH;QAAaC;IAAmB;IACzF,OAAO;QACLG,4BAA4B,IAAIC,IAC9BH,QAAQI,iBAAiB,CAACC,GAAG,CAAC,CAAC,EAACC,QAAQ,EAAEC,SAAS,EAAC,GAAK;gBAACD;gBAAU;oBAACC;gBAAS;aAAE;QAElFC,6BAA6B,IAAIL,IAC/BH,QAAQS,oBAAoB,CAACJ,GAAG,CAAC,CAAC,EAACK,IAAI,EAAE,GAAGC,YAAW,GAAK;gBAACD;gBAAMC;aAAW;QAEhFC,uBAAuBZ,QAAQa,iBAAiB,EAAEH;IACpD;AACF;AAEA,SAAQtB,+BAA+B,GAAE"}
+{"version":3,"sources":["../../src/core/integrations.ts"],"sourcesContent":["import {\n  type IntegrationsModuleClient,\n  integrationsInterModuleContract,\n} from '@shipfox/api-integration-core-dto/inter-module';\n\nexport type DefinitionsSourceControl = {\n  resolveRepository: IntegrationsModuleClient['resolveSourceRepository'];\n  listFiles: IntegrationsModuleClient['listSourceFiles'];\n  fetchFile: IntegrationsModuleClient['fetchSourceFile'];\n};\n\nexport function createDefinitionsSourceControl(\n  integrations: IntegrationsModuleClient,\n): DefinitionsSourceControl {\n  return {\n    resolveRepository: integrations.resolveSourceRepository,\n    listFiles: integrations.listSourceFiles,\n    fetchFile: integrations.fetchSourceFile,\n  };\n}\n\nexport async function loadIntegrationValidationContext(\n  integrations: IntegrationsModuleClient,\n  workspaceId: string,\n  defaultConnectionId: string,\n  signal?: AbortSignal,\n) {\n  const input = {workspaceId, defaultConnectionId};\n  const context =\n    signal === undefined\n      ? await integrations.getAgentToolsContext(input)\n      : await integrations.getAgentToolsContext(input, {signal});\n  return {\n    agentToolSelectionCatalogs: new Map(\n      context.selectionCatalogs.map(({provider, selectors}) => [provider, {selectors}]),\n    ),\n    workspaceConnectionSnapshot: new Map(\n      context.workspaceConnections.map(({slug, ...connection}) => [slug, connection]),\n    ),\n    eventCatalogs: new Map(\n      context.eventCatalogs.map(({provider, events}) => [provider, new Set(events)]),\n    ),\n    fixedEventProviders: new Set(context.fixedEventProviders),\n    defaultConnectionSlug: context.defaultConnection?.slug,\n  };\n}\n\nexport {integrationsInterModuleContract};\n"],"names":["integrationsInterModuleContract","createDefinitionsSourceControl","integrations","resolveRepository","resolveSourceRepository","listFiles","listSourceFiles","fetchFile","fetchSourceFile","loadIntegrationValidationContext","workspaceId","defaultConnectionId","signal","input","context","undefined","getAgentToolsContext","agentToolSelectionCatalogs","Map","selectionCatalogs","map","provider","selectors","workspaceConnectionSnapshot","workspaceConnections","slug","connection","eventCatalogs","events","Set","fixedEventProviders","defaultConnectionSlug","defaultConnection"],"mappings":"AAAA,SAEEA,+BAA+B,QAC1B,iDAAiD;AAQxD,OAAO,SAASC,+BACdC,YAAsC;IAEtC,OAAO;QACLC,mBAAmBD,aAAaE,uBAAuB;QACvDC,WAAWH,aAAaI,eAAe;QACvCC,WAAWL,aAAaM,eAAe;IACzC;AACF;AAEA,OAAO,eAAeC,iCACpBP,YAAsC,EACtCQ,WAAmB,EACnBC,mBAA2B,EAC3BC,MAAoB;IAEpB,MAAMC,QAAQ;QAACH;QAAaC;IAAmB;IAC/C,MAAMG,UACJF,WAAWG,YACP,MAAMb,aAAac,oBAAoB,CAACH,SACxC,MAAMX,aAAac,oBAAoB,CAACH,OAAO;QAACD;IAAM;IAC5D,OAAO;QACLK,4BAA4B,IAAIC,IAC9BJ,QAAQK,iBAAiB,CAACC,GAAG,CAAC,CAAC,EAACC,QAAQ,EAAEC,SAAS,EAAC,GAAK;gBAACD;gBAAU;oBAACC;gBAAS;aAAE;QAElFC,6BAA6B,IAAIL,IAC/BJ,QAAQU,oBAAoB,CAACJ,GAAG,CAAC,CAAC,EAACK,IAAI,EAAE,GAAGC,YAAW,GAAK;gBAACD;gBAAMC;aAAW;QAEhFC,eAAe,IAAIT,IACjBJ,QAAQa,aAAa,CAACP,GAAG,CAAC,CAAC,EAACC,QAAQ,EAAEO,MAAM,EAAC,GAAK;gBAACP;gBAAU,IAAIQ,IAAID;aAAQ;QAE/EE,qBAAqB,IAAID,IAAIf,QAAQgB,mBAAmB;QACxDC,uBAAuBjB,QAAQkB,iBAAiB,EAAEP;IACpD;AACF;AAEA,SAAQzB,+BAA+B,GAAE"}

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

@@ -1,11 +1,11 @@
-import type { ValidationWarning } from './entities/validation-warning.js';
+import type { ValidationDiagnostic } from './entities/validation-diagnostic.js';
 import type { WorkflowDefinitionPayload } from './entities/workflow-definition.js';
 import { type DefinitionValidationOptions } from './validate-definition.js';
 export interface ParsedDefinition extends WorkflowDefinitionPayload {
-    warnings: ValidationWarning[];
+    diagnostics: ValidationDiagnostic[];
 }
 export type ParseDefinitionOptions = DefinitionValidationOptions;
-export declare function parseDefinitionWithWarnings(yamlString: string, options: ParseDefinitionOptions): ParsedDefinition;
+export declare function parseDefinitionWithDiagnostics(yamlString: string, options: ParseDefinitionOptions): ParsedDefinition;
 export declare function parseDefinition(yamlString: string, options: ParseDefinitionOptions): WorkflowDefinitionPayload;
-export declare function stripDefinitionWarnings(parsed: ParsedDefinition): WorkflowDefinitionPayload;
+export declare function stripDefinitionDiagnostics(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,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"}
+{"version":3,"file":"parse-definition.d.ts","sourceRoot":"","sources":["../../src/core/parse-definition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,oBAAoB,EAAC,MAAM,qCAAqC,CAAC;AAC9E,OAAO,KAAK,EAAC,yBAAyB,EAAC,MAAM,mCAAmC,CAAC;AAEjF,OAAO,EAAC,KAAK,2BAA2B,EAAqB,MAAM,0BAA0B,CAAC;AAE9F,MAAM,WAAW,gBAAiB,SAAQ,yBAAyB;IACjE,WAAW,EAAE,oBAAoB,EAAE,CAAC;CACrC;AAED,MAAM,MAAM,sBAAsB,GAAG,2BAA2B,CAAC;AAEjE,wBAAgB,8BAA8B,CAC5C,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,0BAA0B,CAAC,MAAM,EAAE,gBAAgB,GAAG,yBAAyB,CAM9F"}

package/dist/core/parse-definition.js

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

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

@@ -1 +1 @@
-{"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"}
+{"version":3,"sources":["../../src/core/parse-definition.ts"],"sourcesContent":["import type {ValidationDiagnostic} from './entities/validation-diagnostic.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  diagnostics: ValidationDiagnostic[];\n}\n\nexport type ParseDefinitionOptions = DefinitionValidationOptions;\n\nexport function parseDefinitionWithDiagnostics(\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    diagnostics: result.diagnostics,\n  };\n}\n\nexport function parseDefinition(\n  yamlString: string,\n  options: ParseDefinitionOptions,\n): WorkflowDefinitionPayload {\n  const parsed = parseDefinitionWithDiagnostics(yamlString, options);\n  return stripDefinitionDiagnostics(parsed);\n}\n\nexport function stripDefinitionDiagnostics(parsed: ParsedDefinition): WorkflowDefinitionPayload {\n  return {\n    document: parsed.document,\n    model: parsed.model,\n    sourceSnapshot: parsed.sourceSnapshot ?? null,\n  };\n}\n"],"names":["DefinitionParseError","validateDefinition","parseDefinitionWithDiagnostics","yamlString","options","result","valid","errors","message","definition","sourceSnapshot","content","format","diagnostics","parseDefinition","parsed","stripDefinitionDiagnostics","document","model"],"mappings":"AAEA,SAAQA,oBAAoB,QAAO,cAAc;AACjD,SAA0CC,kBAAkB,QAAO,2BAA2B;AAQ9F,OAAO,SAASC,+BACdC,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,aAAaR,OAAOQ,WAAW;IACjC;AACF;AAEA,OAAO,SAASC,gBACdX,UAAkB,EAClBC,OAA+B;IAE/B,MAAMW,SAASb,+BAA+BC,YAAYC;IAC1D,OAAOY,2BAA2BD;AACpC;AAEA,OAAO,SAASC,2BAA2BD,MAAwB;IACjE,OAAO;QACLE,UAAUF,OAAOE,QAAQ;QACzBC,OAAOH,OAAOG,KAAK;QACnBR,gBAAgBK,OAAOL,cAAc,IAAI;IAC3C;AACF"}

package/dist/core/resolve-definition-at-ref.d.ts

@@ -0,0 +1,66 @@
+import type { AgentInterModuleClient } from '@shipfox/api-agent-dto/inter-module';
+import type { TriggerDto, WorkflowModelSnapshot, WorkflowSourceSnapshot } from '@shipfox/api-definitions-dto';
+import { type IntegrationsModuleClient } from '@shipfox/api-integration-core-dto/inter-module';
+import type { ProjectsModuleClient } from '@shipfox/api-projects-dto/inter-module';
+import type { ValidationError } from './validate-definition.js';
+export interface ResolveDefinitionAtRefParams {
+    projectId: string;
+    ref: string;
+    configPath: string;
+    expectedCommit?: string | undefined;
+    projects: ProjectsModuleClient;
+    agent: AgentInterModuleClient;
+    integrations: IntegrationsModuleClient;
+    signal?: AbortSignal;
+}
+export interface ValidationWarning {
+    code: string;
+    message: string;
+    path?: string | undefined;
+}
+export interface ResolvedDefinitionAtRef {
+    workflow: {
+        id: string;
+        configPath: string;
+    };
+    commit: string;
+    model: WorkflowModelSnapshot;
+    sourceSnapshot: WorkflowSourceSnapshot;
+    triggers: Record<string, TriggerDto>;
+    warnings: ValidationWarning[];
+}
+export interface ListDefinitionsAtRefParams {
+    projectId: string;
+    ref: string;
+    projects: ProjectsModuleClient;
+    agent: AgentInterModuleClient;
+    integrations: IntegrationsModuleClient;
+    signal?: AbortSignal;
+}
+export interface DefinitionAtRefFile {
+    configPath: string;
+    name: string | null;
+    valid: boolean;
+    errors: ValidationError[];
+    warnings: ValidationWarning[];
+    triggers: Record<string, TriggerDto>;
+}
+export interface DefinitionsAtRefListing {
+    commit: string;
+    files: DefinitionAtRefFile[];
+}
+/**
+ * Resolves a workflow definition file at a git ref without persisting it.
+ * The ref is pinned to a commit, the file is fetched at that commit, and the
+ * result is validated with the sync pipeline. Only the workflow lineage row is
+ * created so the dev run can be numbered; no definition row and no outbox
+ * event are written.
+ */
+export declare function resolveDefinitionAtRef(params: ResolveDefinitionAtRefParams): Promise<ResolvedDefinitionAtRef>;
+/**
+ * Lists the workflow files at a git ref with their validation state. Applies
+ * the sync limits (100 files, 1 MB per file). One invalid file does not fail
+ * the listing; it is reported as invalid.
+ */
+export declare function listDefinitionsAtRef(params: ListDefinitionsAtRefParams): Promise<DefinitionsAtRefListing>;
+//# sourceMappingURL=resolve-definition-at-ref.d.ts.map

package/dist/core/resolve-definition-at-ref.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-definition-at-ref.d.ts","sourceRoot":"","sources":["../../src/core/resolve-definition-at-ref.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,sBAAsB,EAAC,MAAM,qCAAqC,CAAC;AAChF,OAAO,KAAK,EACV,UAAU,EACV,qBAAqB,EACrB,sBAAsB,EACvB,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EACL,KAAK,wBAAwB,EAE9B,MAAM,gDAAgD,CAAC;AACxD,OAAO,KAAK,EAAC,oBAAoB,EAAC,MAAM,wCAAwC,CAAC;AAsBjF,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,0BAA0B,CAAC;AAE9D,MAAM,WAAW,4BAA4B;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,KAAK,EAAE,sBAAsB,CAAC;IAC9B,YAAY,EAAE,wBAAwB,CAAC;IACvC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAC,CAAC;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,qBAAqB,CAAC;IAC7B,cAAc,EAAE,sBAAsB,CAAC;IACvC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACrC,QAAQ,EAAE,iBAAiB,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,0BAA0B;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,KAAK,EAAE,sBAAsB,CAAC;IAC9B,YAAY,EAAE,wBAAwB,CAAC;IACvC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,mBAAmB,EAAE,CAAC;CAC9B;AAQD;;;;;;GAMG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,4BAA4B,GACnC,OAAO,CAAC,uBAAuB,CAAC,CASlC;AAwDD;;;;GAIG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,0BAA0B,GACjC,OAAO,CAAC,uBAAuB,CAAC,CASlC"}