@cleocode/contracts 2026.5.11 → 2026.5.14
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.
- package/dist/operations/lifecycle.d.ts +27 -4
- package/dist/operations/lifecycle.d.ts.map +1 -1
- package/dist/operations/orchestrate.d.ts +19 -6
- package/dist/operations/orchestrate.d.ts.map +1 -1
- package/package.json +2 -2
- package/src/operations/lifecycle.ts +27 -4
- package/src/operations/orchestrate.ts +20 -6
|
@@ -82,12 +82,35 @@ export interface LifecycleStatusResult {
|
|
|
82
82
|
export interface LifecycleHistoryParams {
|
|
83
83
|
taskId: string;
|
|
84
84
|
}
|
|
85
|
+
/**
|
|
86
|
+
* A single entry in the lifecycle history for an epic.
|
|
87
|
+
*
|
|
88
|
+
* @remarks
|
|
89
|
+
* Canonical shape matches the implementation in
|
|
90
|
+
* `packages/core/src/lifecycle/index.ts`. The prior contracts shape
|
|
91
|
+
* used `from`/`to` transition fields that were never populated by the
|
|
92
|
+
* SQLite-native implementation. The core stores an `action` string that
|
|
93
|
+
* encodes the event kind:
|
|
94
|
+
*
|
|
95
|
+
* - Stage events: `'completed'` | `'skipped'`
|
|
96
|
+
* - Gate events: `'gate.pass: <gateName>'` | `'gate.fail: <gateName>'`
|
|
97
|
+
*
|
|
98
|
+
* T1719: reconciled from prior `{ stage, from, to, timestamp, agent?, notes? }`
|
|
99
|
+
* to match the core implementation shape `{ stage, action, timestamp, notes? }`.
|
|
100
|
+
*
|
|
101
|
+
* @task T1719 — shape-divergence reconciliation
|
|
102
|
+
*/
|
|
85
103
|
export interface LifecycleHistoryEntry {
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
104
|
+
/** Stage name this event belongs to. */
|
|
105
|
+
stage: string;
|
|
106
|
+
/**
|
|
107
|
+
* Event kind: `'completed'`, `'skipped'`, or a gate event like
|
|
108
|
+
* `'gate.pass: <gateName>'` / `'gate.fail: <gateName>'`.
|
|
109
|
+
*/
|
|
110
|
+
action: string;
|
|
111
|
+
/** ISO 8601 timestamp of the event. */
|
|
89
112
|
timestamp: string;
|
|
90
|
-
|
|
113
|
+
/** Optional free-text notes or reason attached to the event. */
|
|
91
114
|
notes?: string;
|
|
92
115
|
}
|
|
93
116
|
export type LifecycleHistoryResult = LifecycleHistoryEntry[];
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../src/operations/lifecycle.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAErE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC;AAExC;;GAEG;AACH,MAAM,MAAM,cAAc,GACtB,UAAU,GACV,WAAW,GACX,uBAAuB,GACvB,eAAe,GACf,eAAe,GACf,gBAAgB,GAChB,YAAY,GACZ,SAAS,GACT,SAAS,CAAC;AAEd,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,cAAc,CAAC;IACtB,MAAM,EAAE,WAAW,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,IAAI;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,cAAc,CAAC;IACtB,MAAM,EAAE,UAAU,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AAGH;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;OAIG;IACH,MAAM,EAAE,MAAM,CAAC;IACf,uEAAuE;IACvE,WAAW,EAAE,cAAc,CAAC;CAC7B;AACD,MAAM,WAAW,oBAAoB;IACnC;;;;;OAKG;IACH,MAAM,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,WAAW,EAAE,cAAc,CAAC;IAC5B,qFAAqF;IACrF,UAAU,EAAE,OAAO,CAAC;IACpB,kEAAkE;IAClE,oBAAoB,EAAE,cAAc,EAAE,CAAC;IACvC,2DAA2D;IAC3D,UAAU,EAAE,UAAU,CAAC;CACxB;AAGD,MAAM,WAAW,qBAAqB;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AACD,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,cAAc,CAAC;IAC7B,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,eAAe,EAAE,cAAc,EAAE,CAAC;IAClC,aAAa,EAAE,cAAc,EAAE,CAAC;CACjC;AAGD,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAC;CAChB;AACD,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,
|
|
1
|
+
{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../src/operations/lifecycle.ts"],"names":[],"mappings":"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"}
|
|
@@ -14,15 +14,28 @@
|
|
|
14
14
|
/**
|
|
15
15
|
* Common orchestration types
|
|
16
16
|
*/
|
|
17
|
+
/**
|
|
18
|
+
* A single execution wave grouping tasks by dependency depth.
|
|
19
|
+
*
|
|
20
|
+
* @remarks
|
|
21
|
+
* Canonical shape matches the implementation in
|
|
22
|
+
* `packages/core/src/orchestration/waves.ts`. The fields align exactly so
|
|
23
|
+
* that dispatch adapters can forward core results without conversion.
|
|
24
|
+
*
|
|
25
|
+
* T1719: reconciled from prior contracts shape (`wave`/`taskIds`/`canRunParallel`/
|
|
26
|
+
* `dependencies`) to match the core implementation shape
|
|
27
|
+
* (`waveNumber`/`tasks`/`status`).
|
|
28
|
+
*
|
|
29
|
+
* @task T963
|
|
30
|
+
* @task T1719 — shape-divergence reconciliation
|
|
31
|
+
*/
|
|
17
32
|
export interface Wave {
|
|
18
33
|
/** 1-based wave number. @task T963 */
|
|
19
|
-
|
|
34
|
+
waveNumber: number;
|
|
20
35
|
/** Task IDs scheduled in this wave. @task T963 */
|
|
21
|
-
|
|
22
|
-
/**
|
|
23
|
-
|
|
24
|
-
/** Upstream wave/task dependencies. @task T963 */
|
|
25
|
-
dependencies: string[];
|
|
36
|
+
tasks: string[];
|
|
37
|
+
/** Computed lifecycle status of this wave. @task T1719 */
|
|
38
|
+
status: 'pending' | 'in_progress' | 'completed';
|
|
26
39
|
}
|
|
27
40
|
export interface SkillDefinition {
|
|
28
41
|
/** Skill name. @task T963 */
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"orchestrate.d.ts","sourceRoot":"","sources":["../../src/operations/orchestrate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH;;GAEG;AACH,MAAM,WAAW,IAAI;IACnB,sCAAsC;IACtC,
|
|
1
|
+
{"version":3,"file":"orchestrate.d.ts","sourceRoot":"","sources":["../../src/operations/orchestrate.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@cleocode/contracts",
|
|
3
|
-
"version": "2026.5.
|
|
3
|
+
"version": "2026.5.14",
|
|
4
4
|
"description": "Domain types, interfaces, and contracts for the CLEO ecosystem",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "./dist/index.js",
|
|
@@ -82,7 +82,7 @@
|
|
|
82
82
|
"dependencies": {
|
|
83
83
|
"zod": "^4.3.6",
|
|
84
84
|
"zod-to-json-schema": "^3.25.2",
|
|
85
|
-
"@cleocode/lafs": "2026.5.
|
|
85
|
+
"@cleocode/lafs": "2026.5.14"
|
|
86
86
|
},
|
|
87
87
|
"scripts": {
|
|
88
88
|
"build": "tsc -b --force && node scripts/emit-schemas.mjs",
|
|
@@ -103,12 +103,35 @@ export interface LifecycleStatusResult {
|
|
|
103
103
|
export interface LifecycleHistoryParams {
|
|
104
104
|
taskId: string;
|
|
105
105
|
}
|
|
106
|
+
/**
|
|
107
|
+
* A single entry in the lifecycle history for an epic.
|
|
108
|
+
*
|
|
109
|
+
* @remarks
|
|
110
|
+
* Canonical shape matches the implementation in
|
|
111
|
+
* `packages/core/src/lifecycle/index.ts`. The prior contracts shape
|
|
112
|
+
* used `from`/`to` transition fields that were never populated by the
|
|
113
|
+
* SQLite-native implementation. The core stores an `action` string that
|
|
114
|
+
* encodes the event kind:
|
|
115
|
+
*
|
|
116
|
+
* - Stage events: `'completed'` | `'skipped'`
|
|
117
|
+
* - Gate events: `'gate.pass: <gateName>'` | `'gate.fail: <gateName>'`
|
|
118
|
+
*
|
|
119
|
+
* T1719: reconciled from prior `{ stage, from, to, timestamp, agent?, notes? }`
|
|
120
|
+
* to match the core implementation shape `{ stage, action, timestamp, notes? }`.
|
|
121
|
+
*
|
|
122
|
+
* @task T1719 — shape-divergence reconciliation
|
|
123
|
+
*/
|
|
106
124
|
export interface LifecycleHistoryEntry {
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
125
|
+
/** Stage name this event belongs to. */
|
|
126
|
+
stage: string;
|
|
127
|
+
/**
|
|
128
|
+
* Event kind: `'completed'`, `'skipped'`, or a gate event like
|
|
129
|
+
* `'gate.pass: <gateName>'` / `'gate.fail: <gateName>'`.
|
|
130
|
+
*/
|
|
131
|
+
action: string;
|
|
132
|
+
/** ISO 8601 timestamp of the event. */
|
|
110
133
|
timestamp: string;
|
|
111
|
-
|
|
134
|
+
/** Optional free-text notes or reason attached to the event. */
|
|
112
135
|
notes?: string;
|
|
113
136
|
}
|
|
114
137
|
export type LifecycleHistoryResult = LifecycleHistoryEntry[];
|
|
@@ -15,15 +15,29 @@
|
|
|
15
15
|
/**
|
|
16
16
|
* Common orchestration types
|
|
17
17
|
*/
|
|
18
|
+
|
|
19
|
+
/**
|
|
20
|
+
* A single execution wave grouping tasks by dependency depth.
|
|
21
|
+
*
|
|
22
|
+
* @remarks
|
|
23
|
+
* Canonical shape matches the implementation in
|
|
24
|
+
* `packages/core/src/orchestration/waves.ts`. The fields align exactly so
|
|
25
|
+
* that dispatch adapters can forward core results without conversion.
|
|
26
|
+
*
|
|
27
|
+
* T1719: reconciled from prior contracts shape (`wave`/`taskIds`/`canRunParallel`/
|
|
28
|
+
* `dependencies`) to match the core implementation shape
|
|
29
|
+
* (`waveNumber`/`tasks`/`status`).
|
|
30
|
+
*
|
|
31
|
+
* @task T963
|
|
32
|
+
* @task T1719 — shape-divergence reconciliation
|
|
33
|
+
*/
|
|
18
34
|
export interface Wave {
|
|
19
35
|
/** 1-based wave number. @task T963 */
|
|
20
|
-
|
|
36
|
+
waveNumber: number;
|
|
21
37
|
/** Task IDs scheduled in this wave. @task T963 */
|
|
22
|
-
|
|
23
|
-
/**
|
|
24
|
-
|
|
25
|
-
/** Upstream wave/task dependencies. @task T963 */
|
|
26
|
-
dependencies: string[];
|
|
38
|
+
tasks: string[];
|
|
39
|
+
/** Computed lifecycle status of this wave. @task T1719 */
|
|
40
|
+
status: 'pending' | 'in_progress' | 'completed';
|
|
27
41
|
}
|
|
28
42
|
|
|
29
43
|
export interface SkillDefinition {
|