@cleocode/contracts 2026.5.29 → 2026.5.34

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.
Files changed (5) hide show
  1. package/dist/operations/playbook.d.ts +35 -2
  2. package/dist/operations/playbook.d.ts.map +1 -1
  3. package/dist/operations/playbook.js +2 -2
  4. package/package.json +2 -2
  5. package/src/operations/playbook.ts +42 -2
package/dist/operations/playbook.d.ts CHANGED
@@ -1,8 +1,8 @@
1
1
  /**
2
2
  * Playbook Domain Operations — wire-format Params/Result types.
3
3
  *
4
- * This file provides the canonical wire-format types for the four playbook
5
- * operations exposed by the dispatch layer (`cleo playbook run|list|status|resume|validate`).
4
+ * This file provides the canonical wire-format types for the five playbook
5
+ * operations exposed by the dispatch layer (`cleo playbook run|list|status|resume|validate|catalog`).
6
6
  *
7
7
  * ## Architecture note (ADR-057 D1 exception — T1456)
8
8
  *
@@ -109,6 +109,39 @@ export interface PlaybookRunResult {
109
109
  /** Resolved on-disk source path. */
110
110
  playbookSource: string;
111
111
  }
112
+ /**
113
+ * Wire params for `cleo playbook catalog` — list available `.cantbook`
114
+ * definitions across all tiers with provenance.
115
+ *
116
+ * Added in T1937 (ADR-068 Decision 4 — symmetric playbook tier resolver).
117
+ */
118
+ export interface PlaybookCatalogParams {
119
+ /**
120
+ * Filter by tier. Defaults to `'all'` which returns definitions from every
121
+ * tier (deduplicated — project shadows global, global shadows packaged).
122
+ */
123
+ tier?: 'project' | 'global' | 'packaged' | 'all';
124
+ /** Absolute path to the project root (required for project-tier lookup). */
125
+ projectRoot?: string;
126
+ }
127
+ /** A single playbook definition entry in the catalog result. */
128
+ export interface PlaybookCatalogEntry {
129
+ /** Bare playbook name without extension. */
130
+ name: string;
131
+ /** Tier at which this playbook was resolved. */
132
+ tier: 'project' | 'global' | 'packaged';
133
+ /** Absolute path to the `.cantbook` file. */
134
+ path: string;
135
+ }
136
+ /** Wire result for `cleo playbook catalog`. */
137
+ export interface PlaybookCatalogResult {
138
+ /** Playbook definitions, ordered by tier precedence then name. */
139
+ playbooks: PlaybookCatalogEntry[];
140
+ /** Total count. */
141
+ count: number;
142
+ /** Effective tier filter applied. */
143
+ tierFilter: 'project' | 'global' | 'packaged' | 'all';
144
+ }
112
145
  /** Wire params for `cleo playbook resume <runId>`. */
113
146
  export interface PlaybookResumeParams {
114
147
  /** ID of the paused playbook run to resume. */
package/dist/operations/playbook.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"playbook.d.ts","sourceRoot":"","sources":["../../src/operations/playbook.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"playbook.d.ts","sourceRoot":"","sources":["../../src/operations/playbook.ts"],"names":[],"mappings":"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"}
package/dist/operations/playbook.js CHANGED
@@ -1,8 +1,8 @@
1
1
  /**
2
2
  * Playbook Domain Operations — wire-format Params/Result types.
3
3
  *
4
- * This file provides the canonical wire-format types for the four playbook
5
- * operations exposed by the dispatch layer (`cleo playbook run|list|status|resume|validate`).
4
+ * This file provides the canonical wire-format types for the five playbook
5
+ * operations exposed by the dispatch layer (`cleo playbook run|list|status|resume|validate|catalog`).
6
6
  *
7
7
  * ## Architecture note (ADR-057 D1 exception — T1456)
8
8
  *
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@cleocode/contracts",
3
- "version": "2026.5.29",
3
+ "version": "2026.5.34",
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.29"
85
+ "@cleocode/lafs": "2026.5.34"
86
86
  },
87
87
  "scripts": {
88
88
  "build": "tsc -b --force && node scripts/emit-schemas.mjs",
package/src/operations/playbook.ts CHANGED
@@ -1,8 +1,8 @@
1
1
  /**
2
2
  * Playbook Domain Operations — wire-format Params/Result types.
3
3
  *
4
- * This file provides the canonical wire-format types for the four playbook
5
- * operations exposed by the dispatch layer (`cleo playbook run|list|status|resume|validate`).
4
+ * This file provides the canonical wire-format types for the five playbook
5
+ * operations exposed by the dispatch layer (`cleo playbook run|list|status|resume|validate|catalog`).
6
6
  *
7
7
  * ## Architecture note (ADR-057 D1 exception — T1456)
8
8
  *
@@ -135,6 +135,46 @@ export interface PlaybookRunResult {
135
135
  playbookSource: string;
136
136
  }
137
137
 
138
+ // ---------------------------------------------------------------------------
139
+ // playbook.catalog
140
+ // ---------------------------------------------------------------------------
141
+
142
+ /**
143
+ * Wire params for `cleo playbook catalog` — list available `.cantbook`
144
+ * definitions across all tiers with provenance.
145
+ *
146
+ * Added in T1937 (ADR-068 Decision 4 — symmetric playbook tier resolver).
147
+ */
148
+ export interface PlaybookCatalogParams {
149
+ /**
150
+ * Filter by tier. Defaults to `'all'` which returns definitions from every
151
+ * tier (deduplicated — project shadows global, global shadows packaged).
152
+ */
153
+ tier?: 'project' | 'global' | 'packaged' | 'all';
154
+ /** Absolute path to the project root (required for project-tier lookup). */
155
+ projectRoot?: string;
156
+ }
157
+
158
+ /** A single playbook definition entry in the catalog result. */
159
+ export interface PlaybookCatalogEntry {
160
+ /** Bare playbook name without extension. */
161
+ name: string;
162
+ /** Tier at which this playbook was resolved. */
163
+ tier: 'project' | 'global' | 'packaged';
164
+ /** Absolute path to the `.cantbook` file. */
165
+ path: string;
166
+ }
167
+
168
+ /** Wire result for `cleo playbook catalog`. */
169
+ export interface PlaybookCatalogResult {
170
+ /** Playbook definitions, ordered by tier precedence then name. */
171
+ playbooks: PlaybookCatalogEntry[];
172
+ /** Total count. */
173
+ count: number;
174
+ /** Effective tier filter applied. */
175
+ tierFilter: 'project' | 'global' | 'packaged' | 'all';
176
+ }
177
+
138
178
  // ---------------------------------------------------------------------------
139
179
  // playbook.resume
140
180
  // ---------------------------------------------------------------------------