@fourier-labs/harbour-contracts 0.13.0 → 0.14.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,12 +1,12 @@
1
1
  {
2
2
  "schema": "harbour.contract-release/1.0",
3
- "repositoryVersion": "0.13.0.0",
4
- "publishVersion": "0.13.0",
5
- "publishTag": "v0.13.0",
6
- "schemasDigest": "sha256:9288dbdb8df22a65200cacbf050cbde4ac9f083bcc818d7c64c64bbe2998e211",
3
+ "repositoryVersion": "0.14.0.0",
4
+ "publishVersion": "0.14.0",
5
+ "publishTag": "v0.14.0",
6
+ "schemasDigest": "sha256:c6988f78bbd8f391a9e60809f53f6eabda8dd86dfa1a3a8b0cc0a76af718dc3f",
7
7
  "aiFixturesDigest": "sha256:07413b9323004b8afa222b9da0e01fdabd32a8130bc0d5367526f0c8ba169e3e",
8
- "generatedGoDigest": "sha256:02e76bb507d4cc32fef1328599eafbcef3326d3226afb9447cd437b411aadc07",
9
- "generatedTypeScriptDigest": "sha256:27bdba477af325c99aec264838cf1da277680c4f13c9943a5763308d7b782982",
8
+ "generatedGoDigest": "sha256:88aa8a5fdc00f593db66606bac3905256c056d9d4bda6dbed2e7053a3a082f14",
9
+ "generatedTypeScriptDigest": "sha256:317e20175e1c367740fc895e15333d95752185d2a34fb67fec0f76849e70b865",
10
10
  "generatedExclusions": {
11
11
  "gen-go/contract_release.go": "contains the generated aggregate digests (self-reference)",
12
12
  "gen-ts/contract-release.ts": "contains the generated aggregate digests (self-reference)"
@@ -42,7 +42,7 @@
42
42
  "schema/deployment-source.schema.json": "sha256:256988b1efbfc90bd0e1ae31a2c5d69b20ef1e4471dc24c9f9aa759278270fbe",
43
43
  "schema/deployment-status-failure.schema.json": "sha256:1a182e603d22467a4be507a37fd10698f6f3178d314d33eaf5de2c7f687c9412",
44
44
  "schema/deployment-status-request.schema.json": "sha256:1f9f87adc947a252b53b61f71ae17f8c1b8fbc1166f31301a043d11ac257dc66",
45
- "schema/deployment-status-response.schema.json": "sha256:9583c36df8100cadbae74c909b59344cbc43585b09b66010c591d721054ece1a",
45
+ "schema/deployment-status-response.schema.json": "sha256:075a9ae537f5e0822828069417d6222c61f04ea6ed5e28f71b29523a4fcaa67b",
46
46
  "schema/env-bindings.schema.json": "sha256:ae09bc4ca5508afa698ef854a59153c4c6f99b07017b48cb9b07ce05abad12f2",
47
47
  "schema/error-category.enum.json": "sha256:e215fe3dc254cf7fca6785f3a12aaeee9d28811b6625916630adda1ed5fc1a14",
48
48
  "schema/error-envelope.schema.json": "sha256:75dccda7dd16fdf8435deda53fc7dbcdc109b65114617a17f11763010c656f90",
@@ -87,11 +87,11 @@
87
87
  "gen-go/ai_contracts_test.go": "sha256:5b5aaa331155958ce21d540e9c77a9ef4ca7d072c4ef6f7d9061add1449a7541",
88
88
  "gen-go/ai_gateway_key_token.go": "sha256:859c34383955f21c22589158214df074b74de6907a54bee7c781acfa9dad8679",
89
89
  "gen-go/binding_digest_helpers.go": "sha256:50462ba2beb16c7931dfc7e10302c12c90bf8111788991f74f08a718125dfbfb",
90
- "gen-go/contracts_test.go": "sha256:f15c34da8758ab4f81c4ea3f03382010a1a5a83159dd0dc18abc9c543d77951e",
90
+ "gen-go/contracts_test.go": "sha256:105f72ed711a34778d875b5a957bae3d8afbe67ed006e4809b8031b4cc303ec0",
91
91
  "gen-go/doc.go": "sha256:c17bc2d39ed175ce7105c68305f8ae7152f659eb7cd187ecceee7698eb3a65dd",
92
92
  "gen-go/error_category.go": "sha256:e36745796e32f753cf153a76c5f77c4bdf37a6a228e6607abcf95cac6f4a934b",
93
93
  "gen-go/schema_documents.go": "sha256:c0399930c719b93d850847b257186f08d69a527f3ac1286ed0c49b66327b315a",
94
- "gen-go/types.go": "sha256:3aa9d181e5b7a76bc83bfae1f54056ccdbae02e144755a098182c6d108fe97b3",
94
+ "gen-go/types.go": "sha256:6fa162e8e36eb1a6d131a00729d414df623bcbd9859a9137f063d0d43546a3a6",
95
95
  "gen-go/version_state.go": "sha256:827f8768359998409b86ea02d9ba1a149981928bae7161e4dc95fe0520ce7410"
96
96
  },
97
97
  "generatedTypeScript": {
@@ -128,7 +128,7 @@
128
128
  "gen-ts/deployment-source.ts": "sha256:8ccb55aaa7260eb6d19a00987d6a20a4b514e343564da13f27cd7fee8013500a",
129
129
  "gen-ts/deployment-status-failure.ts": "sha256:3ffe268e32240f9da3172b161b8e99e06aa2d21d8c37b30f340506a337c64047",
130
130
  "gen-ts/deployment-status-request.ts": "sha256:7ddccd07ab9f6d0821903a291ab35f903bb055727e03a058b99165ec048f6483",
131
- "gen-ts/deployment-status-response.ts": "sha256:b6916c226a6965368642d821d4b9c029649d00d27d7e09996fc1927fcc698401",
131
+ "gen-ts/deployment-status-response.ts": "sha256:b35822ccfcedec8f83306e636eb27e0fdde6390aea40b6da97881ac5e6bda26e",
132
132
  "gen-ts/env-bindings.ts": "sha256:a167cfe9842352c9fec6412ff0d82bda9c5f5c3a1af541bd5c27a57f54fd0941",
133
133
  "gen-ts/error-category-registry.ts": "sha256:327a75153684b161f07ed3f5321048ff928147acdde6b52db9cafd59c48b17c4",
134
134
  "gen-ts/error-category.ts": "sha256:9bda89180c3b740c9aa8be466216592e8ca9d0d368c274333edf6ea5c45afd8e",
@@ -1,7 +1,7 @@
1
- export declare const ContractRepositoryVersion: "0.13.0.0";
2
- export declare const ContractPublishVersion: "0.13.0";
3
- export declare const ContractPublishTag: "v0.13.0";
4
- export declare const ContractSchemasDigest: "sha256:9288dbdb8df22a65200cacbf050cbde4ac9f083bcc818d7c64c64bbe2998e211";
1
+ export declare const ContractRepositoryVersion: "0.14.0.0";
2
+ export declare const ContractPublishVersion: "0.14.0";
3
+ export declare const ContractPublishTag: "v0.14.0";
4
+ export declare const ContractSchemasDigest: "sha256:c6988f78bbd8f391a9e60809f53f6eabda8dd86dfa1a3a8b0cc0a76af718dc3f";
5
5
  export declare const ContractAiFixturesDigest: "sha256:07413b9323004b8afa222b9da0e01fdabd32a8130bc0d5367526f0c8ba169e3e";
6
- export declare const ContractGeneratedGoDigest: "sha256:02e76bb507d4cc32fef1328599eafbcef3326d3226afb9447cd437b411aadc07";
7
- export declare const ContractGeneratedTypeScriptDigest: "sha256:27bdba477af325c99aec264838cf1da277680c4f13c9943a5763308d7b782982";
6
+ export declare const ContractGeneratedGoDigest: "sha256:88aa8a5fdc00f593db66606bac3905256c056d9d4bda6dbed2e7053a3a082f14";
7
+ export declare const ContractGeneratedTypeScriptDigest: "sha256:317e20175e1c367740fc895e15333d95752185d2a34fb67fec0f76849e70b865";
@@ -1,9 +1,9 @@
1
1
  /* eslint-disable */
2
2
  // Code generated by tools/gen/gen.mjs from schema/*.json. DO NOT EDIT.
3
- export const ContractRepositoryVersion = "0.13.0.0";
4
- export const ContractPublishVersion = "0.13.0";
5
- export const ContractPublishTag = "v0.13.0";
6
- export const ContractSchemasDigest = "sha256:9288dbdb8df22a65200cacbf050cbde4ac9f083bcc818d7c64c64bbe2998e211";
3
+ export const ContractRepositoryVersion = "0.14.0.0";
4
+ export const ContractPublishVersion = "0.14.0";
5
+ export const ContractPublishTag = "v0.14.0";
6
+ export const ContractSchemasDigest = "sha256:c6988f78bbd8f391a9e60809f53f6eabda8dd86dfa1a3a8b0cc0a76af718dc3f";
7
7
  export const ContractAiFixturesDigest = "sha256:07413b9323004b8afa222b9da0e01fdabd32a8130bc0d5367526f0c8ba169e3e";
8
- export const ContractGeneratedGoDigest = "sha256:02e76bb507d4cc32fef1328599eafbcef3326d3226afb9447cd437b411aadc07";
9
- export const ContractGeneratedTypeScriptDigest = "sha256:27bdba477af325c99aec264838cf1da277680c4f13c9943a5763308d7b782982";
8
+ export const ContractGeneratedGoDigest = "sha256:88aa8a5fdc00f593db66606bac3905256c056d9d4bda6dbed2e7053a3a082f14";
9
+ export const ContractGeneratedTypeScriptDigest = "sha256:317e20175e1c367740fc895e15333d95752185d2a34fb67fec0f76849e70b865";
@@ -15,6 +15,12 @@ export interface DeploymentStatusResponse {
15
15
  updatedAt: string;
16
16
  url?: string;
17
17
  failure?: StatusFailureProjection;
18
+ /**
19
+ * Bounded chronological trail (oldest first) of human-renderable progress moments observed while this version deployed. Ephemeral and best-effort: a deploy that recorded none — including every deploy that predates this field — simply omits it, so absence means 'no progress view available', never failure.
20
+ *
21
+ * @maxItems 50
22
+ */
23
+ progress?: StatusProgressEvent[];
18
24
  }
19
25
  export interface StatusFailureProjection {
20
26
  category: string;
@@ -22,3 +28,25 @@ export interface StatusFailureProjection {
22
28
  message: string;
23
29
  remediationHint: string;
24
30
  }
31
+ export interface StatusProgressEvent {
32
+ /**
33
+ * ISO-8601 UTC instant the moment was observed.
34
+ */
35
+ at: string;
36
+ /**
37
+ * Deliberately a bounded string, not a closed enum: this vocabulary is produced and grown in the data plane, and closing it here would turn every new narration moment into a lockstep contracts release — the drift failure this project has already paid for twice. A consumer must render an unrecognised token generically and must never reject the response for it. Known values today: job.started, transform.attempt-started, transform.attempt-finished, transform.contract-rejected, build.started, build.finished, workspace.published, report.published, agent.heartbeat, job.finished.
38
+ */
39
+ event: string;
40
+ /**
41
+ * Coarse pipeline stage the moment belongs to, e.g. build.
42
+ */
43
+ stage?: string;
44
+ /**
45
+ * 1-based attempt number when the moment belongs to a retried step.
46
+ */
47
+ attempt?: number;
48
+ /**
49
+ * Short frontend-safe detail. Like the failure projection, it carries no internal identifiers, raw provider errors or secrets.
50
+ */
51
+ detail?: string;
52
+ }
@@ -1,10 +1,10 @@
1
1
  /* eslint-disable */
2
2
  // Code generated by tools/gen/gen.mjs from schema/*.json. DO NOT EDIT.
3
3
 
4
- export const ContractRepositoryVersion = "0.13.0.0" as const;
5
- export const ContractPublishVersion = "0.13.0" as const;
6
- export const ContractPublishTag = "v0.13.0" as const;
7
- export const ContractSchemasDigest = "sha256:9288dbdb8df22a65200cacbf050cbde4ac9f083bcc818d7c64c64bbe2998e211" as const;
4
+ export const ContractRepositoryVersion = "0.14.0.0" as const;
5
+ export const ContractPublishVersion = "0.14.0" as const;
6
+ export const ContractPublishTag = "v0.14.0" as const;
7
+ export const ContractSchemasDigest = "sha256:c6988f78bbd8f391a9e60809f53f6eabda8dd86dfa1a3a8b0cc0a76af718dc3f" as const;
8
8
  export const ContractAiFixturesDigest = "sha256:07413b9323004b8afa222b9da0e01fdabd32a8130bc0d5367526f0c8ba169e3e" as const;
9
- export const ContractGeneratedGoDigest = "sha256:02e76bb507d4cc32fef1328599eafbcef3326d3226afb9447cd437b411aadc07" as const;
10
- export const ContractGeneratedTypeScriptDigest = "sha256:27bdba477af325c99aec264838cf1da277680c4f13c9943a5763308d7b782982" as const;
9
+ export const ContractGeneratedGoDigest = "sha256:88aa8a5fdc00f593db66606bac3905256c056d9d4bda6dbed2e7053a3a082f14" as const;
10
+ export const ContractGeneratedTypeScriptDigest = "sha256:317e20175e1c367740fc895e15333d95752185d2a34fb67fec0f76849e70b865" as const;
@@ -30,6 +30,12 @@ export interface DeploymentStatusResponse {
30
30
  updatedAt: string;
31
31
  url?: string;
32
32
  failure?: StatusFailureProjection;
33
+ /**
34
+ * Bounded chronological trail (oldest first) of human-renderable progress moments observed while this version deployed. Ephemeral and best-effort: a deploy that recorded none — including every deploy that predates this field — simply omits it, so absence means 'no progress view available', never failure.
35
+ *
36
+ * @maxItems 50
37
+ */
38
+ progress?: StatusProgressEvent[];
33
39
  }
34
40
  export interface StatusFailureProjection {
35
41
  category: string;
@@ -37,3 +43,25 @@ export interface StatusFailureProjection {
37
43
  message: string;
38
44
  remediationHint: string;
39
45
  }
46
+ export interface StatusProgressEvent {
47
+ /**
48
+ * ISO-8601 UTC instant the moment was observed.
49
+ */
50
+ at: string;
51
+ /**
52
+ * Deliberately a bounded string, not a closed enum: this vocabulary is produced and grown in the data plane, and closing it here would turn every new narration moment into a lockstep contracts release — the drift failure this project has already paid for twice. A consumer must render an unrecognised token generically and must never reject the response for it. Known values today: job.started, transform.attempt-started, transform.attempt-finished, transform.contract-rejected, build.started, build.finished, workspace.published, report.published, agent.heartbeat, job.finished.
53
+ */
54
+ event: string;
55
+ /**
56
+ * Coarse pipeline stage the moment belongs to, e.g. build.
57
+ */
58
+ stage?: string;
59
+ /**
60
+ * 1-based attempt number when the moment belongs to a retried step.
61
+ */
62
+ attempt?: number;
63
+ /**
64
+ * Short frontend-safe detail. Like the failure projection, it carries no internal identifiers, raw provider errors or secrets.
65
+ */
66
+ detail?: string;
67
+ }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@fourier-labs/harbour-contracts",
3
- "version": "0.13.0",
3
+ "version": "0.14.0",
4
4
  "description": "Single source of truth for every data shape that crosses a boundary between Harbour components.",
5
5
  "license": "UNLICENSED",
6
6
  "private": false,
@@ -52,6 +52,12 @@
52
52
  },
53
53
  "failure": {
54
54
  "$ref": "#/definitions/StatusFailureProjection"
55
+ },
56
+ "progress": {
57
+ "type": "array",
58
+ "maxItems": 50,
59
+ "description": "Bounded chronological trail (oldest first) of human-renderable progress moments observed while this version deployed. Ephemeral and best-effort: a deploy that recorded none — including every deploy that predates this field — simply omits it, so absence means 'no progress view available', never failure.",
60
+ "items": { "$ref": "#/definitions/StatusProgressEvent" }
55
61
  }
56
62
  },
57
63
  "definitions": {
@@ -74,6 +80,41 @@
74
80
  "type": "string"
75
81
  }
76
82
  }
83
+ },
84
+ "StatusProgressEvent": {
85
+ "type": "object",
86
+ "additionalProperties": false,
87
+ "required": ["at", "event"],
88
+ "properties": {
89
+ "at": {
90
+ "type": "string",
91
+ "format": "date-time",
92
+ "description": "ISO-8601 UTC instant the moment was observed."
93
+ },
94
+ "event": {
95
+ "type": "string",
96
+ "minLength": 1,
97
+ "maxLength": 64,
98
+ "pattern": "^[a-z][a-z0-9]*(\\.[a-z0-9-]+)+$",
99
+ "description": "Deliberately a bounded string, not a closed enum: this vocabulary is produced and grown in the data plane, and closing it here would turn every new narration moment into a lockstep contracts release — the drift failure this project has already paid for twice. A consumer must render an unrecognised token generically and must never reject the response for it. Known values today: job.started, transform.attempt-started, transform.attempt-finished, transform.contract-rejected, build.started, build.finished, workspace.published, report.published, agent.heartbeat, job.finished."
100
+ },
101
+ "stage": {
102
+ "type": "string",
103
+ "minLength": 1,
104
+ "maxLength": 32,
105
+ "description": "Coarse pipeline stage the moment belongs to, e.g. build."
106
+ },
107
+ "attempt": {
108
+ "type": "integer",
109
+ "minimum": 1,
110
+ "description": "1-based attempt number when the moment belongs to a retried step."
111
+ },
112
+ "detail": {
113
+ "type": "string",
114
+ "maxLength": 256,
115
+ "description": "Short frontend-safe detail. Like the failure projection, it carries no internal identifiers, raw provider errors or secrets."
116
+ }
117
+ }
77
118
  }
78
119
  }
79
120
  }