@openplanr/protocol 0.6.1 → 0.6.2

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 (55) hide show
  1. package/lib/dashboard/closed-json-contract.mjs +99 -109
  2. package/lib/dashboard/operate-experience-audit-display-contract.d.mts +128 -153
  3. package/lib/dashboard/operate-experience-audit-display-contract.mjs +530 -585
  4. package/lib/dashboard/operate-experience-display-contract.d.mts +415 -437
  5. package/lib/dashboard/operate-experience-display-contract.mjs +768 -831
  6. package/lib/dashboard/operate-experience-surface-contract.d.mts +143 -148
  7. package/lib/dashboard/operate-experience-surface-contract.mjs +72 -73
  8. package/lib/dashboard/operate-review-contract.d.mts +7 -14
  9. package/lib/dashboard/operate-review-contract.mjs +46 -42
  10. package/lib/dashboard/operate-review-display-workspace-contract.d.mts +2 -5
  11. package/lib/dashboard/operate-review-display-workspace-contract.mjs +158 -104
  12. package/lib/dashboard/operate-review-payload-safety.mjs +4 -2
  13. package/lib/dashboard/operate-review-workspace-projection-v2.d.mts +47 -33
  14. package/lib/protocol/index.d.ts +2647 -543
  15. package/package.json +1 -1
  16. package/registries/commands.json +3 -3
  17. package/registries/skills.json +5 -5
  18. package/src/browser-contracts.d.mts +4 -1
  19. package/src/browser-contracts.mjs +16 -5
  20. package/src/canonical-json.d.mts +3 -1
  21. package/src/canonical-json.mjs +57 -20
  22. package/src/compat/live-evidence-v2.mjs +1604 -485
  23. package/src/compat/operate-experience-live-patch.mjs +67 -15
  24. package/src/compat/operating-planning-contracts.mjs +183 -51
  25. package/src/contracts.d.mts +54 -13
  26. package/src/contracts.mjs +625 -335
  27. package/src/design-contracts.mjs +58 -21
  28. package/src/design-handoff-contracts.d.mts +67 -11
  29. package/src/design-handoff-contracts.mjs +243 -98
  30. package/src/design-publication-contracts.mjs +98 -33
  31. package/src/diagram-authoring-contracts.d.mts +422 -78
  32. package/src/diagram-authoring-contracts.mjs +1697 -326
  33. package/src/diagram-contracts.d.mts +4 -1
  34. package/src/diagram-contracts.mjs +16 -4
  35. package/src/enterprise-contracts.d.mts +211 -46
  36. package/src/enterprise-contracts.mjs +727 -175
  37. package/src/errors.mjs +4 -0
  38. package/src/generated/canonical-registries.mjs +8 -8
  39. package/src/index.d.mts +8 -8
  40. package/src/index.mjs +36 -20
  41. package/src/json-schema.d.mts +21 -6
  42. package/src/json-schema.mjs +66 -18
  43. package/src/planning-contracts.d.mts +8 -2
  44. package/src/planning-contracts.mjs +33 -7
  45. package/src/registries.d.mts +11 -3
  46. package/src/registries.mjs +369 -87
  47. package/src/review-experience-contracts.d.mts +7 -2
  48. package/src/review-experience-contracts.mjs +198 -49
  49. package/src/semver.mjs +5 -1
  50. package/src/skill-source-contracts.d.mts +36 -16
  51. package/src/skill-source-contracts.mjs +25 -6
  52. package/src/task-contracts.d.mts +13 -3
  53. package/src/task-contracts.mjs +181 -40
  54. package/src/workspace-contracts.d.mts +38 -10
  55. package/src/workspace-contracts.mjs +147 -33
@@ -1,572 +1,550 @@
1
1
  import type {
2
- OperateAllowedActionV2,
3
- OperateExperienceAccessLevelV1,
4
- OperateExperienceActionV1,
5
- OperateExperienceCycleV1,
6
- OperateExperienceEventHeadV1,
7
- OperateExperienceHistoryV1,
8
- OperateExperienceInboxItemV1,
9
- OperateExperienceLearningV1,
10
- OperateExperienceOutcomeV1,
11
- OperateExperiencePreviewV1,
12
- OperateExperienceReplayV1,
13
- OperatingFindingSeverityV2,
14
- OperatingFindingStateV2,
15
- OperatingFindingTypeV2,
16
- OperatingWorkCycleLinkV2,
17
- ProtocolValidationError,
18
- } from "../protocol/index.js";
2
+ OperateAllowedActionV2,
3
+ OperateExperienceAccessLevelV1,
4
+ OperateExperienceActionV1,
5
+ OperateExperienceCycleV1,
6
+ OperateExperienceEventHeadV1,
7
+ OperateExperienceHistoryV1,
8
+ OperateExperienceInboxItemV1,
9
+ OperateExperienceLearningV1,
10
+ OperateExperienceOutcomeV1,
11
+ OperateExperiencePreviewV1,
12
+ OperateExperienceReplayV1,
13
+ OperatingFindingSeverityV2,
14
+ OperatingFindingStateV2,
15
+ OperatingFindingTypeV2,
16
+ OperatingWorkCycleLinkV2,
17
+ ProtocolValidationError,
18
+ } from '../protocol/index.js';
19
19
  import type {
20
- OperateExperienceSurfaceStatusV1,
21
- OperateExperienceSurfaceV1,
22
- } from "./operate-experience-surface-contract.mjs";
23
- import type { OperateSharedTruthSummaryV1 } from "./operate-review-workspace-projection-v2.mjs";
20
+ OperateExperienceSurfaceStatusV1,
21
+ OperateExperienceSurfaceV1,
22
+ } from './operate-experience-surface-contract.mjs';
23
+ import type { OperateSharedTruthSummaryV1 } from './operate-review-workspace-projection-v2.mjs';
24
24
 
25
25
  export type OperateDisplayIntegrityV1 = Readonly<{
26
- algorithm: "sha-256-jcs";
27
- domain:
28
- | "openplanr:operate-experience-display-surface:1.0.0"
29
- | "openplanr:operate-cycle-display-workspace:1.0.0"
30
- | "openplanr:operate-executive-board-display-surface:1.0.0"
31
- | "openplanr:operate-action-display-workspace:1.0.0"
32
- | "openplanr:operate-recovery-display-surface:1.0.0";
33
- sourceViewHash: string;
34
- contentHash: string;
26
+ algorithm: 'sha-256-jcs';
27
+ domain:
28
+ | 'openplanr:operate-experience-display-surface:1.0.0'
29
+ | 'openplanr:operate-cycle-display-workspace:1.0.0'
30
+ | 'openplanr:operate-executive-board-display-surface:1.0.0'
31
+ | 'openplanr:operate-action-display-workspace:1.0.0'
32
+ | 'openplanr:operate-recovery-display-surface:1.0.0';
33
+ sourceViewHash: string;
34
+ contentHash: string;
35
35
  }>;
36
36
 
37
37
  export type OperateDisplayBindingV1 = Readonly<{
38
- actorId: string;
39
- scopeId: string;
40
- domainId: string;
41
- domainVersion: string;
42
- generatedAt: string;
43
- eventHead: OperateExperienceEventHeadV1;
44
- viewHash: string;
45
- projectId?: string;
46
- generation?: number;
47
- surface?: "today" | "inbox" | "cycles" | "cycle" | "actions" | "action";
48
- subjectId?: string | null;
49
- cycleId?: string | null;
38
+ actorId: string;
39
+ scopeId: string;
40
+ domainId: string;
41
+ domainVersion: string;
42
+ generatedAt: string;
43
+ eventHead: OperateExperienceEventHeadV1;
44
+ viewHash: string;
45
+ projectId?: string;
46
+ generation?: number;
47
+ surface?: 'today' | 'inbox' | 'cycles' | 'cycle' | 'actions' | 'action';
48
+ subjectId?: string | null;
49
+ cycleId?: string | null;
50
50
  }>;
51
51
 
52
52
  export type OperatePreviewBindingV1 = Readonly<{
53
- actorId: string;
54
- scopeId: string;
55
- domainId: string;
56
- domainVersion: string;
57
- eventHead: Readonly<{ sequence: number; hash: string | null }>;
58
- sourceViewHash: string;
59
- subjectId: string;
60
- actionDigest: string;
53
+ actorId: string;
54
+ scopeId: string;
55
+ domainId: string;
56
+ domainVersion: string;
57
+ eventHead: Readonly<{ sequence: number; hash: string | null }>;
58
+ sourceViewHash: string;
59
+ subjectId: string;
60
+ actionDigest: string;
61
61
  }>;
62
62
 
63
63
  export type OperateExperienceDisplaySurfacePayloadV1 = Extract<
64
- OperateExperienceSurfaceV1,
65
- { surface: "today" | "inbox" | "cycles" | "cycle" | "actions" }
64
+ OperateExperienceSurfaceV1,
65
+ { surface: 'today' | 'inbox' | 'cycles' | 'cycle' | 'actions' }
66
66
  >;
67
67
 
68
68
  export type OperateExperienceDisplaySurfaceV1 = Readonly<{
69
- kind: "operate-experience-display-surface";
70
- schemaVersion: "1.0.0";
71
- protocolVersion: "2.0.0";
72
- payload: OperateExperienceDisplaySurfacePayloadV1;
73
- integrity: OperateDisplayIntegrityV1 &
74
- Readonly<{
75
- domain: "openplanr:operate-experience-display-surface:1.0.0";
76
- }>;
69
+ kind: 'operate-experience-display-surface';
70
+ schemaVersion: '1.0.0';
71
+ protocolVersion: '2.0.0';
72
+ payload: OperateExperienceDisplaySurfacePayloadV1;
73
+ integrity: OperateDisplayIntegrityV1 &
74
+ Readonly<{
75
+ domain: 'openplanr:operate-experience-display-surface:1.0.0';
76
+ }>;
77
77
  }>;
78
78
 
79
79
  export type OperateCycleDisplayAssignmentV1 = Readonly<
80
- Omit<OperateExperienceCycleV1["assignments"][number], "deepLink"> & {
81
- deepLink: string | null;
82
- }
80
+ Omit<OperateExperienceCycleV1['assignments'][number], 'deepLink'> & {
81
+ deepLink: string | null;
82
+ }
83
83
  >;
84
84
  export type OperateCycleDisplayOutcomeV1 = Readonly<
85
- Omit<OperateExperienceOutcomeV1, "deepLink"> & { deepLink: string | null }
85
+ Omit<OperateExperienceOutcomeV1, 'deepLink'> & { deepLink: string | null }
86
86
  >;
87
87
  export type OperateCycleDisplayCycleV1 = Readonly<
88
- Omit<OperateExperienceCycleV1, "assignments"> & {
89
- assignments: readonly OperateCycleDisplayAssignmentV1[];
90
- }
88
+ Omit<OperateExperienceCycleV1, 'assignments'> & {
89
+ assignments: readonly OperateCycleDisplayAssignmentV1[];
90
+ }
91
91
  >;
92
92
  export type OperateCycleDisplayPersistentItemV1 = Readonly<{
93
- kind: "finding" | "decision" | "action";
94
- subjectId: string;
95
- state: string;
96
- relations: readonly OperatingWorkCycleLinkV2["relation"][];
93
+ kind: 'finding' | 'decision' | 'action';
94
+ subjectId: string;
95
+ state: string;
96
+ relations: readonly OperatingWorkCycleLinkV2['relation'][];
97
97
  }>;
98
98
 
99
99
  export type OperateCycleDisplayWorkspacePayloadV1 = Readonly<{
100
- ok: true;
101
- kind: "operate-cycle-workspace";
102
- schemaVersion: "1.0.0";
103
- protocolVersion: "2.0.0";
104
- readOnly: boolean;
105
- mutationEnabled: boolean;
106
- scopeId: string;
107
- domainId: string;
108
- domainVersion: string;
109
- actorId: string;
110
- accessLevel: OperateExperienceAccessLevelV1;
111
- generatedAt: string;
112
- eventHead: OperateExperienceEventHeadV1;
113
- viewHash: string;
114
- truthSummary: OperateSharedTruthSummaryV1;
115
- status: Exclude<
116
- OperateExperienceSurfaceStatusV1,
117
- "incompatible" | "corrupt"
118
- >;
119
- reasonCodes: readonly string[];
120
- data: Readonly<{
121
- ownerCycle: Readonly<{
122
- cycleId: string;
123
- scopeId: string;
124
- domainId: string;
125
- domainVersion: string;
126
- state: string;
127
- health: string;
128
- focus: readonly string[];
129
- createdAt: string;
130
- updatedAt: string;
131
- }>;
132
- cycle: OperateCycleDisplayCycleV1;
133
- progress: Readonly<{
134
- total: number;
135
- pending: number;
136
- available: number;
137
- active: number;
138
- submitted: number;
139
- validated: number;
140
- rejected: number;
141
- terminal: number;
142
- }>;
143
- replay: OperateExperienceReplayV1;
144
- verification: Readonly<{
145
- status: "not-required" | "verified" | "unverified";
146
- reasonCodes: readonly string[];
147
- }>;
148
- persistentWork: Readonly<{
149
- findings: readonly OperateCycleDisplayPersistentItemV1[];
150
- decisions: readonly OperateCycleDisplayPersistentItemV1[];
151
- actions: readonly OperateCycleDisplayPersistentItemV1[];
152
- outcomes: readonly OperateCycleDisplayOutcomeV1[];
153
- learnings: readonly OperateExperienceLearningV1[];
154
- cycleLinks: readonly OperatingWorkCycleLinkV2[];
155
- }>;
156
- allowedActions: readonly OperateAllowedActionV2<"operate.cycle.get">[];
157
- }>;
100
+ ok: true;
101
+ kind: 'operate-cycle-workspace';
102
+ schemaVersion: '1.0.0';
103
+ protocolVersion: '2.0.0';
104
+ readOnly: boolean;
105
+ mutationEnabled: boolean;
106
+ scopeId: string;
107
+ domainId: string;
108
+ domainVersion: string;
109
+ actorId: string;
110
+ accessLevel: OperateExperienceAccessLevelV1;
111
+ generatedAt: string;
112
+ eventHead: OperateExperienceEventHeadV1;
113
+ viewHash: string;
114
+ truthSummary: OperateSharedTruthSummaryV1;
115
+ status: Exclude<OperateExperienceSurfaceStatusV1, 'incompatible' | 'corrupt'>;
116
+ reasonCodes: readonly string[];
117
+ data: Readonly<{
118
+ ownerCycle: Readonly<{
119
+ cycleId: string;
120
+ scopeId: string;
121
+ domainId: string;
122
+ domainVersion: string;
123
+ state: string;
124
+ health: string;
125
+ focus: readonly string[];
126
+ createdAt: string;
127
+ updatedAt: string;
128
+ }>;
129
+ cycle: OperateCycleDisplayCycleV1;
130
+ progress: Readonly<{
131
+ total: number;
132
+ pending: number;
133
+ available: number;
134
+ active: number;
135
+ submitted: number;
136
+ validated: number;
137
+ rejected: number;
138
+ terminal: number;
139
+ }>;
140
+ replay: OperateExperienceReplayV1;
141
+ verification: Readonly<{
142
+ status: 'not-required' | 'verified' | 'unverified';
143
+ reasonCodes: readonly string[];
144
+ }>;
145
+ persistentWork: Readonly<{
146
+ findings: readonly OperateCycleDisplayPersistentItemV1[];
147
+ decisions: readonly OperateCycleDisplayPersistentItemV1[];
148
+ actions: readonly OperateCycleDisplayPersistentItemV1[];
149
+ outcomes: readonly OperateCycleDisplayOutcomeV1[];
150
+ learnings: readonly OperateExperienceLearningV1[];
151
+ cycleLinks: readonly OperatingWorkCycleLinkV2[];
152
+ }>;
153
+ allowedActions: readonly OperateAllowedActionV2<'operate.cycle.get'>[];
154
+ }>;
158
155
  }>;
159
156
 
160
157
  export type OperateCycleDisplayWorkspaceV1 = Readonly<{
161
- kind: "operate-cycle-display-workspace";
162
- schemaVersion: "1.0.0";
163
- protocolVersion: "2.0.0";
164
- payload: OperateCycleDisplayWorkspacePayloadV1;
165
- integrity: OperateDisplayIntegrityV1 &
166
- Readonly<{
167
- domain: "openplanr:operate-cycle-display-workspace:1.0.0";
168
- }>;
158
+ kind: 'operate-cycle-display-workspace';
159
+ schemaVersion: '1.0.0';
160
+ protocolVersion: '2.0.0';
161
+ payload: OperateCycleDisplayWorkspacePayloadV1;
162
+ integrity: OperateDisplayIntegrityV1 &
163
+ Readonly<{
164
+ domain: 'openplanr:operate-cycle-display-workspace:1.0.0';
165
+ }>;
169
166
  }>;
170
167
 
171
168
  export type OperateExecutiveBoardSeatAbsenceV1 =
172
- | Readonly<{
173
- kind: "terminal";
174
- outcome: "abandoned" | "failed";
175
- code: string;
176
- reason: string;
177
- recoveryDisposition: string;
178
- }>
179
- | Readonly<{
180
- kind: "lens";
181
- roleId: string;
182
- roleKind: string;
183
- absenceCode: string;
184
- reason: string;
185
- }>
186
- | Readonly<{ kind: "omitted"; reason: string }>;
169
+ | Readonly<{
170
+ kind: 'terminal';
171
+ outcome: 'abandoned' | 'failed';
172
+ code: string;
173
+ reason: string;
174
+ recoveryDisposition: string;
175
+ }>
176
+ | Readonly<{
177
+ kind: 'lens';
178
+ roleId: string;
179
+ roleKind: string;
180
+ absenceCode: string;
181
+ reason: string;
182
+ }>
183
+ | Readonly<{ kind: 'omitted'; reason: string }>;
187
184
 
188
185
  export type OperateExecutiveBoardArtifactV1 = Readonly<{
189
- artifactId: string;
190
- rawHash: string;
191
- canonicalHash: string;
186
+ artifactId: string;
187
+ rawHash: string;
188
+ canonicalHash: string;
192
189
  }>;
193
190
 
194
191
  export type OperateExecutiveBoardDissentV1 = Readonly<{
195
- sourceArtifactId: string;
196
- localDissentId: string;
197
- statement: string;
198
- resolutionCondition: string;
192
+ sourceArtifactId: string;
193
+ localDissentId: string;
194
+ statement: string;
195
+ resolutionCondition: string;
199
196
  }>;
200
197
 
201
198
  export type OperateExecutiveBoardFindingTargetV1 = Readonly<{
202
- advisorArtifactId: string;
203
- analysisIds: readonly string[];
204
- claimIds: readonly string[];
205
- measurementIds: readonly string[];
206
- riskIds: readonly string[];
207
- recommendationIds: readonly string[];
199
+ advisorArtifactId: string;
200
+ analysisIds: readonly string[];
201
+ claimIds: readonly string[];
202
+ measurementIds: readonly string[];
203
+ riskIds: readonly string[];
204
+ recommendationIds: readonly string[];
208
205
  }>;
209
206
 
210
207
  export type OperateExecutiveBoardChallengerFindingV1 = Readonly<{
211
- findingId: string;
212
- sourceArtifactId: string;
213
- sourceAssignmentId: string;
214
- sourceLocalFindingId: string;
215
- findingType: OperatingFindingTypeV2;
216
- severity: OperatingFindingSeverityV2;
217
- confidence: number;
218
- targets: readonly OperateExecutiveBoardFindingTargetV1[];
219
- supportingEvidenceRefIds: readonly string[];
220
- contradictingEvidenceRefIds: readonly string[];
221
- title: string;
222
- statement: string;
223
- rationale: string;
224
- correctionCondition: string;
225
- state: OperatingFindingStateV2;
226
- ownerActorId: string | null;
227
- revisitAt: string | null;
208
+ findingId: string;
209
+ sourceArtifactId: string;
210
+ sourceAssignmentId: string;
211
+ sourceLocalFindingId: string;
212
+ findingType: OperatingFindingTypeV2;
213
+ severity: OperatingFindingSeverityV2;
214
+ confidence: number;
215
+ targets: readonly OperateExecutiveBoardFindingTargetV1[];
216
+ supportingEvidenceRefIds: readonly string[];
217
+ contradictingEvidenceRefIds: readonly string[];
218
+ title: string;
219
+ statement: string;
220
+ rationale: string;
221
+ correctionCondition: string;
222
+ state: OperatingFindingStateV2;
223
+ ownerActorId: string | null;
224
+ revisitAt: string | null;
228
225
  }>;
229
226
 
230
227
  export type OperateExecutiveBoardChallengerFindingsV1 = Readonly<{
231
- artifact: OperateExecutiveBoardArtifactV1 | null;
232
- findings: readonly OperateExecutiveBoardChallengerFindingV1[];
233
- dissent: readonly OperateExecutiveBoardDissentV1[];
228
+ artifact: OperateExecutiveBoardArtifactV1 | null;
229
+ findings: readonly OperateExecutiveBoardChallengerFindingV1[];
230
+ dissent: readonly OperateExecutiveBoardDissentV1[];
234
231
  }>;
235
232
 
236
233
  export type OperateExecutiveBoardClaimRefV1 = Readonly<{
237
- advisorArtifactId: string;
238
- localClaimId: string;
234
+ advisorArtifactId: string;
235
+ localClaimId: string;
239
236
  }>;
240
237
 
241
238
  export type OperateExecutiveBoardRecommendationRefV1 = Readonly<{
242
- advisorArtifactId: string;
243
- localRecommendationId: string;
239
+ advisorArtifactId: string;
240
+ localRecommendationId: string;
244
241
  }>;
245
242
 
246
243
  export type OperateExecutiveBoardAlternativeDispositionV1 = Readonly<{
247
- sourceArtifactId: string;
248
- localAlternativeId: string;
249
- title: string | null;
250
- disposition: "accepted" | "rejected" | "deferred";
251
- rationale: string | null;
244
+ sourceArtifactId: string;
245
+ localAlternativeId: string;
246
+ title: string | null;
247
+ disposition: 'accepted' | 'rejected' | 'deferred';
248
+ rationale: string | null;
252
249
  }>;
253
250
 
254
251
  export type OperateExecutiveBoardActionHypothesisV1 = Readonly<{
255
- localActionHypothesisId: string;
256
- title: string | null;
257
- objectiveId: string | null;
258
- ownerActorId: string | null;
259
- accountabilityDisposition: "unowned" | "blocked" | null;
260
- expectedResult: string | null;
261
- metricId: string | null;
262
- baseline: number | null;
263
- target: number | null;
264
- verificationWindow: string | null;
265
- verificationMethod: string | null;
266
- sourceClaimRefs: readonly OperateExecutiveBoardClaimRefV1[];
267
- sourceFindingIds: readonly string[];
268
- dependsOnActionHypothesisIds: readonly string[];
252
+ localActionHypothesisId: string;
253
+ title: string | null;
254
+ objectiveId: string | null;
255
+ ownerActorId: string | null;
256
+ accountabilityDisposition: 'unowned' | 'blocked' | null;
257
+ expectedResult: string | null;
258
+ metricId: string | null;
259
+ baseline: number | null;
260
+ target: number | null;
261
+ verificationWindow: string | null;
262
+ verificationMethod: string | null;
263
+ sourceClaimRefs: readonly OperateExecutiveBoardClaimRefV1[];
264
+ sourceFindingIds: readonly string[];
265
+ dependsOnActionHypothesisIds: readonly string[];
269
266
  }>;
270
267
 
271
268
  export type OperateExecutiveBoardChairDecisionV1 = Readonly<{
272
- localDecisionId: string;
273
- title: string | null;
274
- question: string | null;
275
- outcome: string | null;
276
- rationale: string | null;
277
- sourceClaimRefs: readonly OperateExecutiveBoardClaimRefV1[];
278
- sourceRecommendationRefs: readonly OperateExecutiveBoardRecommendationRefV1[];
279
- challengerFindingIds: readonly string[];
280
- evidenceRefIds: readonly string[];
281
- confidence: number | null;
282
- assumptionIds: readonly string[];
283
- expectedUpside: string | null;
284
- expectedDownside: string | null;
285
- uncertainty: string | null;
286
- reversibility: string | null;
287
- ownerActorId: string | null;
288
- revisitConditions: readonly string[];
289
- dissentIds: readonly string[];
290
- alternativeDispositions: readonly OperateExecutiveBoardAlternativeDispositionV1[];
291
- actionHypotheses: readonly OperateExecutiveBoardActionHypothesisV1[];
269
+ localDecisionId: string;
270
+ title: string | null;
271
+ question: string | null;
272
+ outcome: string | null;
273
+ rationale: string | null;
274
+ sourceClaimRefs: readonly OperateExecutiveBoardClaimRefV1[];
275
+ sourceRecommendationRefs: readonly OperateExecutiveBoardRecommendationRefV1[];
276
+ challengerFindingIds: readonly string[];
277
+ evidenceRefIds: readonly string[];
278
+ confidence: number | null;
279
+ assumptionIds: readonly string[];
280
+ expectedUpside: string | null;
281
+ expectedDownside: string | null;
282
+ uncertainty: string | null;
283
+ reversibility: string | null;
284
+ ownerActorId: string | null;
285
+ revisitConditions: readonly string[];
286
+ dissentIds: readonly string[];
287
+ alternativeDispositions: readonly OperateExecutiveBoardAlternativeDispositionV1[];
288
+ actionHypotheses: readonly OperateExecutiveBoardActionHypothesisV1[];
292
289
  }>;
293
290
 
294
291
  export type OperateExecutiveBoardRoleGapV1 = Readonly<{
295
- absenceId: string | null;
296
- kind: "role";
297
- roleId: string;
298
- roleKind: "advisor" | "challenger" | "chair";
299
- roleVersion: string | null;
300
- absenceCode: string;
301
- reason: string;
302
- recoveryDisposition: string | null;
303
- sourceAssignmentId: string | null;
304
- sourceEventId: string | null;
292
+ absenceId: string | null;
293
+ kind: 'role';
294
+ roleId: string;
295
+ roleKind: 'advisor' | 'challenger' | 'chair';
296
+ roleVersion: string | null;
297
+ absenceCode: string;
298
+ reason: string;
299
+ recoveryDisposition: string | null;
300
+ sourceAssignmentId: string | null;
301
+ sourceEventId: string | null;
305
302
  }>;
306
303
 
307
304
  export type OperateExecutiveBoardEvidenceGapV1 = Readonly<{
308
- absenceId: string;
309
- kind: "evidence";
310
- requirementId: string;
311
- evidenceKinds: readonly ("git" | "filesystem" | "planr" | "operate-artifact")[];
312
- sourceContracts: readonly Readonly<{ id: string; version: string }>[];
313
- absenceCode: "not-available" | "not-authorized" | "resolution-failed" | "stale";
314
- reason: string;
315
- recoveryDisposition: string;
316
- sourceEvidenceRefIds: readonly string[];
317
- sourceEventIds: readonly string[];
305
+ absenceId: string;
306
+ kind: 'evidence';
307
+ requirementId: string;
308
+ evidenceKinds: readonly ('git' | 'filesystem' | 'planr' | 'operate-artifact')[];
309
+ sourceContracts: readonly Readonly<{ id: string; version: string }>[];
310
+ absenceCode: 'not-available' | 'not-authorized' | 'resolution-failed' | 'stale';
311
+ reason: string;
312
+ recoveryDisposition: string;
313
+ sourceEvidenceRefIds: readonly string[];
314
+ sourceEventIds: readonly string[];
318
315
  }>;
319
316
 
320
317
  export type OperateExecutiveBoardGapV1 =
321
- | OperateExecutiveBoardRoleGapV1
322
- | OperateExecutiveBoardEvidenceGapV1;
318
+ | OperateExecutiveBoardRoleGapV1
319
+ | OperateExecutiveBoardEvidenceGapV1;
323
320
 
324
321
  export type OperateExecutiveBoardChairSynthesisV1 = Readonly<{
325
- artifact: Readonly<{
326
- artifactId: string;
327
- intelligencePlanId: string;
328
- advisorArtifactIds: readonly string[];
329
- challengerArtifactId: string | null;
330
- }>;
331
- decisions: readonly OperateExecutiveBoardChairDecisionV1[];
332
- dissent: readonly OperateExecutiveBoardDissentV1[];
333
- unresolvedGaps: readonly OperateExecutiveBoardGapV1[];
322
+ artifact: Readonly<{
323
+ artifactId: string;
324
+ intelligencePlanId: string;
325
+ advisorArtifactIds: readonly string[];
326
+ challengerArtifactId: string | null;
327
+ }>;
328
+ decisions: readonly OperateExecutiveBoardChairDecisionV1[];
329
+ dissent: readonly OperateExecutiveBoardDissentV1[];
330
+ unresolvedGaps: readonly OperateExecutiveBoardGapV1[];
334
331
  }>;
335
332
 
336
333
  export type OperateExecutiveBoardSeatV1 = Readonly<{
337
- roleId: string;
338
- label: string;
339
- roleKind: string;
340
- roleVersion: string;
341
- assignmentId: string | null;
342
- assignmentState: string | null;
343
- artifact: OperateExecutiveBoardArtifactV1 | null;
344
- absence: OperateExecutiveBoardSeatAbsenceV1 | null;
334
+ roleId: string;
335
+ label: string;
336
+ roleKind: string;
337
+ roleVersion: string;
338
+ assignmentId: string | null;
339
+ assignmentState: string | null;
340
+ artifact: OperateExecutiveBoardArtifactV1 | null;
341
+ absence: OperateExecutiveBoardSeatAbsenceV1 | null;
345
342
  }>;
346
343
 
347
344
  export type OperateExecutiveBoardV1 = Readonly<{
348
- cycleId: string;
349
- planId: string;
350
- seats: readonly OperateExecutiveBoardSeatV1[];
351
- challengerFindings: OperateExecutiveBoardChallengerFindingsV1 | null;
352
- chairSynthesis: OperateExecutiveBoardChairSynthesisV1 | null;
345
+ cycleId: string;
346
+ planId: string;
347
+ seats: readonly OperateExecutiveBoardSeatV1[];
348
+ challengerFindings: OperateExecutiveBoardChallengerFindingsV1 | null;
349
+ chairSynthesis: OperateExecutiveBoardChairSynthesisV1 | null;
353
350
  }>;
354
351
 
355
352
  export type OperateExecutiveBoardDisplayPayloadV1 = Readonly<{
356
- ok: true;
357
- kind: "operate-executive-board";
358
- schemaVersion: "1.0.0";
359
- protocolVersion: "2.0.0";
360
- readOnly: true;
361
- mutationEnabled: false;
362
- scopeId: string;
363
- domainId: string;
364
- domainVersion: string;
365
- actorId: string;
366
- accessLevel: OperateExperienceAccessLevelV1;
367
- generatedAt: string;
368
- eventHead: OperateExperienceEventHeadV1;
369
- viewHash: string;
370
- status: Exclude<
371
- OperateExperienceSurfaceStatusV1,
372
- "incompatible" | "corrupt"
373
- >;
374
- reasonCodes: readonly string[];
375
- data: Readonly<{
376
- cycleId: string;
377
- executiveBoard: OperateExecutiveBoardV1;
378
- }>;
353
+ ok: true;
354
+ kind: 'operate-executive-board';
355
+ schemaVersion: '1.0.0';
356
+ protocolVersion: '2.0.0';
357
+ readOnly: true;
358
+ mutationEnabled: false;
359
+ scopeId: string;
360
+ domainId: string;
361
+ domainVersion: string;
362
+ actorId: string;
363
+ accessLevel: OperateExperienceAccessLevelV1;
364
+ generatedAt: string;
365
+ eventHead: OperateExperienceEventHeadV1;
366
+ viewHash: string;
367
+ status: Exclude<OperateExperienceSurfaceStatusV1, 'incompatible' | 'corrupt'>;
368
+ reasonCodes: readonly string[];
369
+ data: Readonly<{
370
+ cycleId: string;
371
+ executiveBoard: OperateExecutiveBoardV1;
372
+ }>;
379
373
  }>;
380
374
 
381
375
  export type OperateExecutiveBoardDisplaySurfaceV1 = Readonly<{
382
- kind: "operate-executive-board-display-surface";
383
- schemaVersion: "1.0.0";
384
- protocolVersion: "2.0.0";
385
- payload: OperateExecutiveBoardDisplayPayloadV1;
386
- integrity: OperateDisplayIntegrityV1 &
387
- Readonly<{
388
- domain: "openplanr:operate-executive-board-display-surface:1.0.0";
389
- }>;
376
+ kind: 'operate-executive-board-display-surface';
377
+ schemaVersion: '1.0.0';
378
+ protocolVersion: '2.0.0';
379
+ payload: OperateExecutiveBoardDisplayPayloadV1;
380
+ integrity: OperateDisplayIntegrityV1 &
381
+ Readonly<{
382
+ domain: 'openplanr:operate-executive-board-display-surface:1.0.0';
383
+ }>;
390
384
  }>;
391
385
 
392
386
  export type OperateActionDisplayWorkspacePayloadV1 = Readonly<{
393
- ok: true;
394
- kind: "operate-action-workspace";
395
- schemaVersion: "1.0.0";
396
- protocolVersion: "2.0.0";
397
- readOnly: true;
398
- mutationEnabled: false;
399
- scopeId: string;
400
- domainId: string;
401
- domainVersion: string;
402
- actorId: string;
403
- accessLevel: OperateExperienceAccessLevelV1;
404
- generatedAt: string;
405
- eventHead: OperateExperienceEventHeadV1;
406
- viewHash: string;
407
- status: Exclude<
408
- OperateExperienceSurfaceStatusV1,
409
- "incompatible" | "corrupt"
410
- >;
411
- reasonCodes: readonly string[];
412
- data: Readonly<{
413
- action: OperateExperienceActionV1;
414
- outcome: OperateExperienceOutcomeV1 | null;
415
- learnings: readonly OperateExperienceLearningV1[];
416
- inbox: readonly OperateExperienceInboxItemV1[];
417
- history: readonly OperateExperienceHistoryV1[];
418
- replay: OperateExperienceReplayV1;
419
- verification: Readonly<{
420
- status: "not-required" | "verified" | "unverified";
421
- reasonCodes: readonly string[];
422
- }>;
423
- boundaries: Readonly<{
424
- approvalExecution: string;
425
- verification: string;
426
- retry: string;
427
- }>;
428
- allowedActions: readonly Readonly<{
429
- subjectId: string;
430
- action: OperateAllowedActionV2;
431
- }>[];
432
- }>;
387
+ ok: true;
388
+ kind: 'operate-action-workspace';
389
+ schemaVersion: '1.0.0';
390
+ protocolVersion: '2.0.0';
391
+ readOnly: true;
392
+ mutationEnabled: false;
393
+ scopeId: string;
394
+ domainId: string;
395
+ domainVersion: string;
396
+ actorId: string;
397
+ accessLevel: OperateExperienceAccessLevelV1;
398
+ generatedAt: string;
399
+ eventHead: OperateExperienceEventHeadV1;
400
+ viewHash: string;
401
+ status: Exclude<OperateExperienceSurfaceStatusV1, 'incompatible' | 'corrupt'>;
402
+ reasonCodes: readonly string[];
403
+ data: Readonly<{
404
+ action: OperateExperienceActionV1;
405
+ outcome: OperateExperienceOutcomeV1 | null;
406
+ learnings: readonly OperateExperienceLearningV1[];
407
+ inbox: readonly OperateExperienceInboxItemV1[];
408
+ history: readonly OperateExperienceHistoryV1[];
409
+ replay: OperateExperienceReplayV1;
410
+ verification: Readonly<{
411
+ status: 'not-required' | 'verified' | 'unverified';
412
+ reasonCodes: readonly string[];
413
+ }>;
414
+ boundaries: Readonly<{
415
+ approvalExecution: string;
416
+ verification: string;
417
+ retry: string;
418
+ }>;
419
+ allowedActions: readonly Readonly<{
420
+ subjectId: string;
421
+ action: OperateAllowedActionV2;
422
+ }>[];
423
+ }>;
433
424
  }>;
434
425
 
435
426
  export type OperateActionDisplayWorkspaceV1 = Readonly<{
436
- kind: "operate-action-display-workspace";
437
- schemaVersion: "1.0.0";
438
- protocolVersion: "2.0.0";
439
- payload: OperateActionDisplayWorkspacePayloadV1;
440
- integrity: OperateDisplayIntegrityV1 &
441
- Readonly<{
442
- domain: "openplanr:operate-action-display-workspace:1.0.0";
443
- }>;
427
+ kind: 'operate-action-display-workspace';
428
+ schemaVersion: '1.0.0';
429
+ protocolVersion: '2.0.0';
430
+ payload: OperateActionDisplayWorkspacePayloadV1;
431
+ integrity: OperateDisplayIntegrityV1 &
432
+ Readonly<{
433
+ domain: 'openplanr:operate-action-display-workspace:1.0.0';
434
+ }>;
444
435
  }>;
445
436
 
446
437
  export type OperateRecoveryDisplayPayloadV1 = Readonly<{
447
- ok: true;
448
- kind: "operate-recovery";
449
- schemaVersion: "1.0.0";
450
- protocolVersion: "2.0.0";
451
- readOnly: true;
452
- mutationEnabled: false;
453
- scopeId: string;
454
- domainId: string;
455
- domainVersion: string;
456
- actorId: string;
457
- accessLevel: OperateExperienceAccessLevelV1;
458
- generatedAt: string;
459
- eventHead: OperateExperienceEventHeadV1;
460
- viewHash: string;
461
- status: Exclude<
462
- OperateExperienceSurfaceStatusV1,
463
- "incompatible" | "corrupt"
464
- >;
465
- reasonCodes: readonly string[];
466
- data: Readonly<{
467
- inspection: Readonly<Record<string, unknown>>;
468
- history: readonly OperateExperienceHistoryV1[];
469
- allowedActions: readonly OperateAllowedActionV2[];
470
- recoveryState:
471
- | "blocked"
472
- | "uncertain"
473
- | "custody"
474
- | "divergent"
475
- | "corrupt"
476
- | "incompatible"
477
- | "restored";
478
- }>;
438
+ ok: true;
439
+ kind: 'operate-recovery';
440
+ schemaVersion: '1.0.0';
441
+ protocolVersion: '2.0.0';
442
+ readOnly: true;
443
+ mutationEnabled: false;
444
+ scopeId: string;
445
+ domainId: string;
446
+ domainVersion: string;
447
+ actorId: string;
448
+ accessLevel: OperateExperienceAccessLevelV1;
449
+ generatedAt: string;
450
+ eventHead: OperateExperienceEventHeadV1;
451
+ viewHash: string;
452
+ status: Exclude<OperateExperienceSurfaceStatusV1, 'incompatible' | 'corrupt'>;
453
+ reasonCodes: readonly string[];
454
+ data: Readonly<{
455
+ inspection: Readonly<Record<string, unknown>>;
456
+ history: readonly OperateExperienceHistoryV1[];
457
+ allowedActions: readonly OperateAllowedActionV2[];
458
+ recoveryState:
459
+ | 'blocked'
460
+ | 'uncertain'
461
+ | 'custody'
462
+ | 'divergent'
463
+ | 'corrupt'
464
+ | 'incompatible'
465
+ | 'restored';
466
+ }>;
479
467
  }>;
480
468
 
481
469
  export type OperateRecoveryDisplaySurfaceV1 = Readonly<{
482
- kind: "operate-recovery-display-surface";
483
- schemaVersion: "1.0.0";
484
- protocolVersion: "2.0.0";
485
- payload: OperateRecoveryDisplayPayloadV1;
486
- integrity: OperateDisplayIntegrityV1 &
487
- Readonly<{
488
- domain: "openplanr:operate-recovery-display-surface:1.0.0";
489
- }>;
470
+ kind: 'operate-recovery-display-surface';
471
+ schemaVersion: '1.0.0';
472
+ protocolVersion: '2.0.0';
473
+ payload: OperateRecoveryDisplayPayloadV1;
474
+ integrity: OperateDisplayIntegrityV1 &
475
+ Readonly<{
476
+ domain: 'openplanr:operate-recovery-display-surface:1.0.0';
477
+ }>;
490
478
  }>;
491
479
 
492
480
  export function validateOperateExperienceDisplaySurfaceV1(
493
- value: unknown,
494
- expected?: OperateDisplayBindingV1,
481
+ value: unknown,
482
+ expected?: OperateDisplayBindingV1,
495
483
  ): ProtocolValidationError[];
496
484
  export function assertOperateExperienceDisplaySurfaceV1(
497
- value: unknown,
498
- expected?: OperateDisplayBindingV1,
485
+ value: unknown,
486
+ expected?: OperateDisplayBindingV1,
499
487
  ): OperateExperienceDisplaySurfaceV1;
500
488
  export function validateOperateCycleDisplayWorkspaceV1(
501
- value: unknown,
502
- expected?: OperateDisplayBindingV1,
489
+ value: unknown,
490
+ expected?: OperateDisplayBindingV1,
503
491
  ): ProtocolValidationError[];
504
492
  export function assertOperateCycleDisplayWorkspaceV1(
505
- value: unknown,
506
- expected?: OperateDisplayBindingV1,
493
+ value: unknown,
494
+ expected?: OperateDisplayBindingV1,
507
495
  ): OperateCycleDisplayWorkspaceV1;
508
496
  export function issueOperateExperienceDisplaySurfaceV1(
509
- payload: OperateExperienceDisplaySurfacePayloadV1,
497
+ payload: OperateExperienceDisplaySurfacePayloadV1,
510
498
  ): OperateExperienceDisplaySurfaceV1;
511
499
  export function issueOperateCycleDisplayWorkspaceV1(
512
- payload: OperateCycleDisplayWorkspacePayloadV1,
500
+ payload: OperateCycleDisplayWorkspacePayloadV1,
513
501
  ): OperateCycleDisplayWorkspaceV1;
514
502
  export function validateOperateExecutiveBoardDisplaySurfaceV1(
515
- value: unknown,
516
- expected?: OperateDisplayBindingV1,
503
+ value: unknown,
504
+ expected?: OperateDisplayBindingV1,
517
505
  ): ProtocolValidationError[];
518
506
  export function assertOperateExecutiveBoardDisplaySurfaceV1(
519
- value: unknown,
520
- expected?: OperateDisplayBindingV1,
507
+ value: unknown,
508
+ expected?: OperateDisplayBindingV1,
521
509
  ): OperateExecutiveBoardDisplaySurfaceV1;
522
510
  export function issueOperateExecutiveBoardDisplaySurfaceV1(
523
- payload: OperateExecutiveBoardDisplayPayloadV1,
511
+ payload: OperateExecutiveBoardDisplayPayloadV1,
524
512
  ): OperateExecutiveBoardDisplaySurfaceV1;
525
513
  export function validateOperateActionDisplayWorkspaceV1(
526
- value: unknown,
527
- expected?: OperateDisplayBindingV1,
514
+ value: unknown,
515
+ expected?: OperateDisplayBindingV1,
528
516
  ): ProtocolValidationError[];
529
517
  export function assertOperateActionDisplayWorkspaceV1(
530
- value: unknown,
531
- expected?: OperateDisplayBindingV1,
518
+ value: unknown,
519
+ expected?: OperateDisplayBindingV1,
532
520
  ): OperateActionDisplayWorkspaceV1;
533
521
  export function issueOperateActionDisplayWorkspaceV1(
534
- payload: OperateActionDisplayWorkspacePayloadV1,
522
+ payload: OperateActionDisplayWorkspacePayloadV1,
535
523
  ): OperateActionDisplayWorkspaceV1;
536
524
  export function validateOperateRecoveryDisplaySurfaceV1(
537
- value: unknown,
538
- expected?: OperateDisplayBindingV1,
525
+ value: unknown,
526
+ expected?: OperateDisplayBindingV1,
539
527
  ): ProtocolValidationError[];
540
528
  export function assertOperateRecoveryDisplaySurfaceV1(
541
- value: unknown,
542
- expected?: OperateDisplayBindingV1,
529
+ value: unknown,
530
+ expected?: OperateDisplayBindingV1,
543
531
  ): OperateRecoveryDisplaySurfaceV1;
544
532
  export function issueOperateRecoveryDisplaySurfaceV1(
545
- payload: OperateRecoveryDisplayPayloadV1,
533
+ payload: OperateRecoveryDisplayPayloadV1,
546
534
  ): OperateRecoveryDisplaySurfaceV1;
547
535
  export function validateOperateExperiencePreviewV1(
548
- value: unknown,
549
- expected?: OperatePreviewBindingV1,
536
+ value: unknown,
537
+ expected?: OperatePreviewBindingV1,
550
538
  ): ProtocolValidationError[];
551
539
  export function assertOperateExperiencePreviewV1(
552
- value: unknown,
553
- expected?: OperatePreviewBindingV1,
540
+ value: unknown,
541
+ expected?: OperatePreviewBindingV1,
554
542
  ): OperateExperiencePreviewV1;
555
543
 
556
- export const OPERATE_EXPERIENCE_DISPLAY_SURFACE_SCHEMA_V1: Readonly<
557
- Record<string, unknown>
558
- >;
559
- export const OPERATE_CYCLE_DISPLAY_WORKSPACE_SCHEMA_V1: Readonly<
560
- Record<string, unknown>
561
- >;
562
- export const OPERATE_EXECUTIVE_BOARD_DISPLAY_SURFACE_SCHEMA_V1: Readonly<
563
- Record<string, unknown>
564
- >;
565
- export const OPERATE_ACTION_DISPLAY_WORKSPACE_SCHEMA_V1: Readonly<
566
- Record<string, unknown>
567
- >;
568
- export const OPERATE_RECOVERY_DISPLAY_SURFACE_SCHEMA_V1: Readonly<
569
- Record<string, unknown>
570
- >;
571
- export const ACTION_WORKSPACE_DOMAIN: "openplanr:operate-action-display-workspace:1.0.0";
572
- export const RECOVERY_DISPLAY_DOMAIN: "openplanr:operate-recovery-display-surface:1.0.0";
544
+ export const OPERATE_EXPERIENCE_DISPLAY_SURFACE_SCHEMA_V1: Readonly<Record<string, unknown>>;
545
+ export const OPERATE_CYCLE_DISPLAY_WORKSPACE_SCHEMA_V1: Readonly<Record<string, unknown>>;
546
+ export const OPERATE_EXECUTIVE_BOARD_DISPLAY_SURFACE_SCHEMA_V1: Readonly<Record<string, unknown>>;
547
+ export const OPERATE_ACTION_DISPLAY_WORKSPACE_SCHEMA_V1: Readonly<Record<string, unknown>>;
548
+ export const OPERATE_RECOVERY_DISPLAY_SURFACE_SCHEMA_V1: Readonly<Record<string, unknown>>;
549
+ export const ACTION_WORKSPACE_DOMAIN: 'openplanr:operate-action-display-workspace:1.0.0';
550
+ export const RECOVERY_DISPLAY_DOMAIN: 'openplanr:operate-recovery-display-surface:1.0.0';