@openplanr/protocol 0.6.1 → 0.7.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.
Files changed (58) hide show
  1. package/README.md +10 -0
  2. package/lib/dashboard/closed-json-contract.mjs +99 -109
  3. package/lib/dashboard/operate-experience-audit-display-contract.d.mts +128 -153
  4. package/lib/dashboard/operate-experience-audit-display-contract.mjs +530 -585
  5. package/lib/dashboard/operate-experience-display-contract.d.mts +415 -437
  6. package/lib/dashboard/operate-experience-display-contract.mjs +777 -831
  7. package/lib/dashboard/operate-experience-surface-contract.d.mts +143 -148
  8. package/lib/dashboard/operate-experience-surface-contract.mjs +72 -73
  9. package/lib/dashboard/operate-review-contract.d.mts +7 -14
  10. package/lib/dashboard/operate-review-contract.mjs +46 -42
  11. package/lib/dashboard/operate-review-display-workspace-contract.d.mts +2 -5
  12. package/lib/dashboard/operate-review-display-workspace-contract.mjs +158 -104
  13. package/lib/dashboard/operate-review-payload-safety.mjs +4 -2
  14. package/lib/dashboard/operate-review-workspace-projection-v2.d.mts +47 -33
  15. package/lib/protocol/index.d.ts +2647 -543
  16. package/package.json +1 -1
  17. package/registries/artifact-theme.json +64 -0
  18. package/registries/commands.json +40 -40
  19. package/registries/skills.json +5 -5
  20. package/schemas/v1.14.0/artifact-theme.schema.json +316 -0
  21. package/src/browser-contracts.d.mts +4 -1
  22. package/src/browser-contracts.mjs +16 -5
  23. package/src/canonical-json.d.mts +6 -1
  24. package/src/canonical-json.mjs +100 -22
  25. package/src/compat/live-evidence-v2.mjs +1611 -485
  26. package/src/compat/operate-experience-live-patch.mjs +67 -15
  27. package/src/compat/operating-planning-contracts.mjs +183 -51
  28. package/src/contracts.d.mts +54 -13
  29. package/src/contracts.mjs +635 -343
  30. package/src/design-contracts.mjs +58 -21
  31. package/src/design-handoff-contracts.d.mts +67 -11
  32. package/src/design-handoff-contracts.mjs +236 -119
  33. package/src/design-publication-contracts.mjs +98 -33
  34. package/src/diagram-authoring-contracts.d.mts +422 -78
  35. package/src/diagram-authoring-contracts.mjs +1715 -335
  36. package/src/diagram-contracts.d.mts +4 -1
  37. package/src/diagram-contracts.mjs +16 -4
  38. package/src/enterprise-contracts.d.mts +211 -46
  39. package/src/enterprise-contracts.mjs +738 -184
  40. package/src/errors.mjs +4 -0
  41. package/src/generated/canonical-registries.mjs +45 -45
  42. package/src/index.d.mts +8 -8
  43. package/src/index.mjs +36 -20
  44. package/src/json-schema.d.mts +21 -6
  45. package/src/json-schema.mjs +66 -18
  46. package/src/planning-contracts.d.mts +8 -2
  47. package/src/planning-contracts.mjs +33 -7
  48. package/src/registries.d.mts +11 -3
  49. package/src/registries.mjs +369 -87
  50. package/src/review-experience-contracts.d.mts +7 -2
  51. package/src/review-experience-contracts.mjs +198 -49
  52. package/src/semver.mjs +5 -1
  53. package/src/skill-source-contracts.d.mts +36 -16
  54. package/src/skill-source-contracts.mjs +25 -6
  55. package/src/task-contracts.d.mts +13 -3
  56. package/src/task-contracts.mjs +181 -40
  57. package/src/workspace-contracts.d.mts +38 -10
  58. package/src/workspace-contracts.mjs +147 -33
@@ -96,7 +96,11 @@ export type OperatingReviewStateV2 =
96
96
  | 'rejected'
97
97
  | 'cancelled';
98
98
  export type OperatePhase1AssignmentKindV2 = 'advisor' | 'challenger' | 'chair';
99
- export type OperatingAssignmentKindV2 = OperatePhase1AssignmentKindV2 | 'context-capture' | 'execution' | 'verification';
99
+ export type OperatingAssignmentKindV2 =
100
+ | OperatePhase1AssignmentKindV2
101
+ | 'context-capture'
102
+ | 'execution'
103
+ | 'verification';
100
104
  export type OperatePhase1TriggerV2 = { kind: 'manual' };
101
105
  export type OperateToolNameV2 =
102
106
  | 'operate.cycle.start'
@@ -159,8 +163,19 @@ export interface OperatingCycleInputBindingV2 {
159
163
  export interface OperatingAssignmentMandateV2 {
160
164
  scope: string;
161
165
  allowedEvidence: string[];
162
- allowedCapabilities: Array<'repository.read' | 'planr.read' | 'git.read' | 'artifact.read' | 'artifact.submit'>;
163
- forbiddenEffects: Array<'repository.write' | 'production.deploy' | 'payment.change' | 'customer-contact' | 'publish' | 'spend' | 'ship' | 'governed-execution'>;
166
+ allowedCapabilities: Array<
167
+ 'repository.read' | 'planr.read' | 'git.read' | 'artifact.read' | 'artifact.submit'
168
+ >;
169
+ forbiddenEffects: Array<
170
+ | 'repository.write'
171
+ | 'production.deploy'
172
+ | 'payment.change'
173
+ | 'customer-contact'
174
+ | 'publish'
175
+ | 'spend'
176
+ | 'ship'
177
+ | 'governed-execution'
178
+ >;
164
179
  capabilityCeiling: 'read-only';
165
180
  skillId: string;
166
181
  }
@@ -214,7 +229,19 @@ export interface OperatingEvidenceRequirementV2 {
214
229
  export interface OperatingResultRequirementV2 {
215
230
  requirementId: string;
216
231
  description: string;
217
- target: 'analysis' | 'claims' | 'measurements' | 'risks' | 'alternatives' | 'gaps' | 'recommendation' | 'findings' | 'dissent' | 'decisions' | 'source-dispositions' | 'question-coverage';
232
+ target:
233
+ | 'analysis'
234
+ | 'claims'
235
+ | 'measurements'
236
+ | 'risks'
237
+ | 'alternatives'
238
+ | 'gaps'
239
+ | 'recommendation'
240
+ | 'findings'
241
+ | 'dissent'
242
+ | 'decisions'
243
+ | 'source-dispositions'
244
+ | 'question-coverage';
218
245
  appliesToOutcomes: Array<'always' | 'recommendation' | 'partial' | 'quiet'>;
219
246
  minimumItems: number;
220
247
  maximumItems: number;
@@ -265,7 +292,11 @@ interface OperatingAssignmentBaseV2 {
265
292
  dependencyPolicy:
266
293
  | { kind: 'none' }
267
294
  | { kind: 'all-required' }
268
- | { kind: 'threshold'; minimumSatisfied: number; allowedTerminalOutcomes: Array<'abandoned' | 'failed'> };
295
+ | {
296
+ kind: 'threshold';
297
+ minimumSatisfied: number;
298
+ allowedTerminalOutcomes: Array<'abandoned' | 'failed'>;
299
+ };
269
300
  inputArtifactIds: string[];
270
301
  inputAbsences: OperatingAssignmentInputAbsenceV2[];
271
302
  outputContract: ContractRefV2;
@@ -300,8 +331,10 @@ interface OperatingIntelligenceAssignmentBaseV2 extends OperatingAssignmentBaseV
300
331
  export interface OperatingAdvisorAssignmentV2 extends OperatingIntelligenceAssignmentBaseV2 {
301
332
  assignmentKind: 'advisor';
302
333
  outputContract: ContractRefV2 & {
303
- schemaId: 'operating-advisor-result'; schemaVersion: '2.0.0';
304
- mediaType: 'application/json'; encoding: 'utf-8';
334
+ schemaId: 'operating-advisor-result';
335
+ schemaVersion: '2.0.0';
336
+ mediaType: 'application/json';
337
+ encoding: 'utf-8';
305
338
  };
306
339
  }
307
340
 
@@ -309,8 +342,10 @@ export interface OperatingAdvisorAssignmentV2 extends OperatingIntelligenceAssig
309
342
  export interface OperatingChallengerAssignmentV2 extends OperatingIntelligenceAssignmentBaseV2 {
310
343
  assignmentKind: 'challenger';
311
344
  outputContract: ContractRefV2 & {
312
- schemaId: 'operating-challenger-review'; schemaVersion: '2.0.0';
313
- mediaType: 'application/json'; encoding: 'utf-8';
345
+ schemaId: 'operating-challenger-review';
346
+ schemaVersion: '2.0.0';
347
+ mediaType: 'application/json';
348
+ encoding: 'utf-8';
314
349
  };
315
350
  }
316
351
 
@@ -318,8 +353,10 @@ export interface OperatingChallengerAssignmentV2 extends OperatingIntelligenceAs
318
353
  export interface OperatingChairAssignmentV2 extends OperatingIntelligenceAssignmentBaseV2 {
319
354
  assignmentKind: 'chair';
320
355
  outputContract: ContractRefV2 & {
321
- schemaId: 'operating-decision-ledger'; schemaVersion: '2.0.0';
322
- mediaType: 'application/json'; encoding: 'utf-8';
356
+ schemaId: 'operating-decision-ledger';
357
+ schemaVersion: '2.0.0';
358
+ mediaType: 'application/json';
359
+ encoding: 'utf-8';
323
360
  };
324
361
  }
325
362
 
@@ -351,10 +388,21 @@ export interface OperatingContextCaptureAssignmentV2 extends OperatingAssignment
351
388
  resultRequirements?: never;
352
389
  mandate?: null;
353
390
  intelligenceContext?: null;
354
- outputContract: ContractRefV2 & (
355
- | { schemaId: 'operating-context-capture'; schemaVersion: '2.0.0'; mediaType: 'application/json'; encoding: 'utf-8' }
356
- | { schemaId: 'operating-intelligence-input-bundle'; schemaVersion: '2.0.0'; mediaType: 'application/json'; encoding: 'utf-8' }
357
- );
391
+ outputContract: ContractRefV2 &
392
+ (
393
+ | {
394
+ schemaId: 'operating-context-capture';
395
+ schemaVersion: '2.0.0';
396
+ mediaType: 'application/json';
397
+ encoding: 'utf-8';
398
+ }
399
+ | {
400
+ schemaId: 'operating-intelligence-input-bundle';
401
+ schemaVersion: '2.0.0';
402
+ mediaType: 'application/json';
403
+ encoding: 'utf-8';
404
+ }
405
+ );
358
406
  governedOperationId?: null;
359
407
  }
360
408
 
@@ -371,9 +419,7 @@ export interface OperatingReviewV2 {
371
419
  reviewId: string;
372
420
  cycleId: string;
373
421
  ownerActorId: string;
374
- subject?:
375
- | { type: 'cycle'; cycleId: string }
376
- | ({ type: 'action' } & OperateActionIdentityV2);
422
+ subject?: { type: 'cycle'; cycleId: string } | ({ type: 'action' } & OperateActionIdentityV2);
377
423
  state: OperatingReviewStateV2;
378
424
  disposition: Exclude<OperatingReviewStateV2, 'pending'> | null;
379
425
  workDispositions: OperatingWorkDispositionV2[];
@@ -385,7 +431,14 @@ export interface OperatingReviewV2 {
385
431
  export interface OperatingWorkDispositionV2 {
386
432
  entityType: 'operating-finding' | 'operating-decision' | 'operating-action';
387
433
  entityId: string;
388
- disposition: 'accepted' | 'approved' | 'rejected' | 'resolved' | 'deferred' | 'superseded' | 'cancelled';
434
+ disposition:
435
+ | 'accepted'
436
+ | 'approved'
437
+ | 'rejected'
438
+ | 'resolved'
439
+ | 'deferred'
440
+ | 'superseded'
441
+ | 'cancelled';
389
442
  }
390
443
 
391
444
  export interface OperatingSubmissionV2 {
@@ -444,72 +497,163 @@ export type OperateEvidenceReadCapabilityV2 =
444
497
  | 'evidence.planr.read'
445
498
  | 'evidence.operate-artifact.read';
446
499
  export type OperateEvidenceResolverErrorCodeV2 =
447
- | 'SOURCE_NOT_FOUND' | 'REVISION_NOT_FOUND' | 'OBJECT_TYPE_MISMATCH' | 'PATH_NOT_FOUND'
448
- | 'LINE_RANGE_INVALID' | 'ANCESTRY_MISMATCH' | 'ARTIFACT_NOT_FOUND' | 'ARTIFACT_HASH_MISMATCH'
449
- | 'SOURCE_UNTRACKED' | 'SOURCE_STALE' | 'CAPABILITY_DENIED' | 'CONSENT_REQUIRED'
450
- | 'SENSITIVITY_BLOCKED' | 'SECRET_DETECTED' | 'UNSUPPORTED_EVIDENCE_KIND'
451
- | 'EVIDENCE_PROVIDER_UNAVAILABLE' | 'EVIDENCE_RESOLVER_UNREGISTERED'
452
- | 'EVIDENCE_RESOLVER_UNAVAILABLE' | 'EVIDENCE_RESOLVER_VERSION_UNSUPPORTED'
453
- | 'EVIDENCE_SOURCE_SCOPE_MISMATCH' | 'EVIDENCE_LOCATOR_INVALID';
454
- export interface OperateEvidenceImplementationRefV2 { id: string; version: string; }
500
+ | 'SOURCE_NOT_FOUND'
501
+ | 'REVISION_NOT_FOUND'
502
+ | 'OBJECT_TYPE_MISMATCH'
503
+ | 'PATH_NOT_FOUND'
504
+ | 'LINE_RANGE_INVALID'
505
+ | 'ANCESTRY_MISMATCH'
506
+ | 'ARTIFACT_NOT_FOUND'
507
+ | 'ARTIFACT_HASH_MISMATCH'
508
+ | 'SOURCE_UNTRACKED'
509
+ | 'SOURCE_STALE'
510
+ | 'CAPABILITY_DENIED'
511
+ | 'CONSENT_REQUIRED'
512
+ | 'SENSITIVITY_BLOCKED'
513
+ | 'SECRET_DETECTED'
514
+ | 'UNSUPPORTED_EVIDENCE_KIND'
515
+ | 'EVIDENCE_PROVIDER_UNAVAILABLE'
516
+ | 'EVIDENCE_RESOLVER_UNREGISTERED'
517
+ | 'EVIDENCE_RESOLVER_UNAVAILABLE'
518
+ | 'EVIDENCE_RESOLVER_VERSION_UNSUPPORTED'
519
+ | 'EVIDENCE_SOURCE_SCOPE_MISMATCH'
520
+ | 'EVIDENCE_LOCATOR_INVALID';
521
+ export interface OperateEvidenceImplementationRefV2 {
522
+ id: string;
523
+ version: string;
524
+ }
455
525
  export type OperateEvidenceLocatorV2 =
456
- | { repositoryId: string; revision: string; objectType?: 'commit' | 'tree' | 'blob' | 'tag'; path?: string; lines?: { start: number; end: number }; ancestry?: { ancestorRevision: string } }
526
+ | {
527
+ repositoryId: string;
528
+ revision: string;
529
+ objectType?: 'commit' | 'tree' | 'blob' | 'tag';
530
+ path?: string;
531
+ lines?: { start: number; end: number };
532
+ ancestry?: { ancestorRevision: string };
533
+ }
457
534
  | { sourceRootId: string; path: string }
458
- | { projectId: string; artifactId: string; artifactType: string; path?: string; contentHash?: string }
459
- | { artifactId: string; expectedArtifactType: string; expectedSchemaId: string; expectedSchemaVersion: string; expectedRawHash?: string; expectedCanonicalHash?: string };
535
+ | {
536
+ projectId: string;
537
+ artifactId: string;
538
+ artifactType: string;
539
+ path?: string;
540
+ contentHash?: string;
541
+ }
542
+ | {
543
+ artifactId: string;
544
+ expectedArtifactType: string;
545
+ expectedSchemaId: string;
546
+ expectedSchemaVersion: string;
547
+ expectedRawHash?: string;
548
+ expectedCanonicalHash?: string;
549
+ };
460
550
  export interface OperatingEvidenceCandidateV2 {
461
- kind: 'operating-evidence-candidate'; schemaVersion: '1.0.0'; protocolVersion: '2.0.0';
462
- candidateId: string; scopeId: string; domainId: string; domainVersion: string; sourceArtifactId: string;
463
- evidenceKind: OperateEvidenceKindV2; locator: OperateEvidenceLocatorV2;
464
- provider: OperateEvidenceImplementationRefV2; resolver: OperateEvidenceImplementationRefV2;
551
+ kind: 'operating-evidence-candidate';
552
+ schemaVersion: '1.0.0';
553
+ protocolVersion: '2.0.0';
554
+ candidateId: string;
555
+ scopeId: string;
556
+ domainId: string;
557
+ domainVersion: string;
558
+ sourceArtifactId: string;
559
+ evidenceKind: OperateEvidenceKindV2;
560
+ locator: OperateEvidenceLocatorV2;
561
+ provider: OperateEvidenceImplementationRefV2;
562
+ resolver: OperateEvidenceImplementationRefV2;
465
563
  }
466
564
  export type OperatingEvidenceRefV2 = Omit<OperatingEvidenceCandidateV2, 'kind'> & {
467
- kind: 'operating-evidence-ref'; evidenceRefId: string;
468
- classification: OperateEvidenceClassificationV2; freshness: OperateEvidenceFreshnessV2;
469
- evidenceArtifactId: string; evidenceArtifactRawHash: string; evidenceArtifactCanonicalHash: string | null;
565
+ kind: 'operating-evidence-ref';
566
+ evidenceRefId: string;
567
+ classification: OperateEvidenceClassificationV2;
568
+ freshness: OperateEvidenceFreshnessV2;
569
+ evidenceArtifactId: string;
570
+ evidenceArtifactRawHash: string;
571
+ evidenceArtifactCanonicalHash: string | null;
470
572
  resolvedAt: string;
471
573
  };
472
574
  export interface OperatingEvidenceResolutionV2 {
473
- kind: 'operating-evidence-resolution'; schemaVersion: '1.0.0'; protocolVersion: '2.0.0';
474
- resolutionId: string; candidateId: string; scopeId: string; domainId: string; domainVersion: string;
475
- sourceArtifactId: string; evidenceKind: OperateEvidenceKindV2;
476
- provider: OperateEvidenceImplementationRefV2; resolver: OperateEvidenceImplementationRefV2;
477
- outcome: 'resolved' | 'rejected'; evidenceRefId: string | null; evidenceArtifactId: string | null;
478
- error: { code: OperateEvidenceResolverErrorCodeV2; retryable: boolean; context: Record<string, string> } | null;
575
+ kind: 'operating-evidence-resolution';
576
+ schemaVersion: '1.0.0';
577
+ protocolVersion: '2.0.0';
578
+ resolutionId: string;
579
+ candidateId: string;
580
+ scopeId: string;
581
+ domainId: string;
582
+ domainVersion: string;
583
+ sourceArtifactId: string;
584
+ evidenceKind: OperateEvidenceKindV2;
585
+ provider: OperateEvidenceImplementationRefV2;
586
+ resolver: OperateEvidenceImplementationRefV2;
587
+ outcome: 'resolved' | 'rejected';
588
+ evidenceRefId: string | null;
589
+ evidenceArtifactId: string | null;
590
+ error: {
591
+ code: OperateEvidenceResolverErrorCodeV2;
592
+ retryable: boolean;
593
+ context: Record<string, string>;
594
+ } | null;
479
595
  resolvedAt: string;
480
596
  }
481
597
  export interface OperatingEvidenceEdgeV2 {
482
- kind: 'operating-evidence-edge'; schemaVersion: '1.0.0'; protocolVersion: '2.0.0';
483
- edgeId: string; scopeId: string; domainId: string; domainVersion: string; sourceArtifactId: string;
484
- localClaimId: string; relation: OperateEvidenceEdgeRelationV2; evidenceRefId: string;
485
- createdBy: { kind: 'runtime'; id: string }; createdAt: string; confidence: number;
598
+ kind: 'operating-evidence-edge';
599
+ schemaVersion: '1.0.0';
600
+ protocolVersion: '2.0.0';
601
+ edgeId: string;
602
+ scopeId: string;
603
+ domainId: string;
604
+ domainVersion: string;
605
+ sourceArtifactId: string;
606
+ localClaimId: string;
607
+ relation: OperateEvidenceEdgeRelationV2;
608
+ evidenceRefId: string;
609
+ createdBy: { kind: 'runtime'; id: string };
610
+ createdAt: string;
611
+ confidence: number;
486
612
  classification: OperateEvidenceClassificationV2;
487
613
  }
488
614
  export interface OperatingEvidenceGraphV2 {
489
- kind: 'operating-evidence-graph'; schemaVersion: '1.0.0'; protocolVersion: '2.0.0';
490
- scopeId: string; domainId: string; domainVersion: string; generatedAt: string;
491
- evidenceRefs: OperatingEvidenceRefV2[]; edges: OperatingEvidenceEdgeV2[];
615
+ kind: 'operating-evidence-graph';
616
+ schemaVersion: '1.0.0';
617
+ protocolVersion: '2.0.0';
618
+ scopeId: string;
619
+ domainId: string;
620
+ domainVersion: string;
621
+ generatedAt: string;
622
+ evidenceRefs: OperatingEvidenceRefV2[];
623
+ edges: OperatingEvidenceEdgeV2[];
492
624
  }
493
625
  export interface OperateEvidenceProviderRegistrationV2 {
494
- kind: 'operate-evidence-provider-registration'; schemaVersion: '1.0.0'; protocolVersion: '2.0.0';
495
- providerId: string; providerVersion: string; supportedEvidenceKinds: OperateEvidenceKindV2[];
626
+ kind: 'operate-evidence-provider-registration';
627
+ schemaVersion: '1.0.0';
628
+ protocolVersion: '2.0.0';
629
+ providerId: string;
630
+ providerVersion: string;
631
+ supportedEvidenceKinds: OperateEvidenceKindV2[];
496
632
  inputContract: { schemaId: 'operating-evidence-candidate'; schemaVersion: '2.0.0' };
497
633
  outputContract: { schemaId: 'operating-evidence-resolution'; schemaVersion: '2.0.0' };
498
- effectClass: 'local-read-only'; requiredCapabilities: OperateEvidenceReadCapabilityV2[];
499
- classificationCeiling: OperateEvidenceClassificationV2; retentionClass: 'ephemeral' | 'project' | 'restricted-machine-local';
634
+ effectClass: 'local-read-only';
635
+ requiredCapabilities: OperateEvidenceReadCapabilityV2[];
636
+ classificationCeiling: OperateEvidenceClassificationV2;
637
+ retentionClass: 'ephemeral' | 'project' | 'restricted-machine-local';
500
638
  provenance: { packageName: string; packageVersion: string; integrity: string };
501
639
  conformanceDigest: string;
502
640
  implementation: { kind: 'built-in'; id: string };
503
641
  fallback: { kind: 'unavailable'; errorCode: 'EVIDENCE_PROVIDER_UNAVAILABLE' };
504
642
  }
505
643
  export interface OperateEvidenceResolverRegistrationV2 {
506
- kind: 'operate-evidence-resolver-registration'; schemaVersion: '1.0.0'; protocolVersion: '2.0.0';
507
- resolverId: string; resolverVersion: string; supportedEvidenceKinds: OperateEvidenceKindV2[];
644
+ kind: 'operate-evidence-resolver-registration';
645
+ schemaVersion: '1.0.0';
646
+ protocolVersion: '2.0.0';
647
+ resolverId: string;
648
+ resolverVersion: string;
649
+ supportedEvidenceKinds: OperateEvidenceKindV2[];
508
650
  inputContract: { schemaId: 'operating-evidence-candidate'; schemaVersion: '2.0.0' };
509
651
  outputContract: { schemaId: 'operating-evidence-resolution'; schemaVersion: '2.0.0' };
510
652
  evidenceRefContract: { schemaId: 'operating-evidence-ref'; schemaVersion: '2.0.0' };
511
- effectClass: 'local-read-only'; requiredCapabilities: OperateEvidenceReadCapabilityV2[];
512
- classificationCeiling: OperateEvidenceClassificationV2; retentionClass: 'ephemeral' | 'project' | 'restricted-machine-local';
653
+ effectClass: 'local-read-only';
654
+ requiredCapabilities: OperateEvidenceReadCapabilityV2[];
655
+ classificationCeiling: OperateEvidenceClassificationV2;
656
+ retentionClass: 'ephemeral' | 'project' | 'restricted-machine-local';
513
657
  errorCodes: OperateEvidenceResolverErrorCodeV2[];
514
658
  provenance: { packageName: string; packageVersion: string; integrity: string };
515
659
  conformanceDigest: string;
@@ -529,98 +673,265 @@ export interface PublicOperateDomainContractBindingV2 extends OperateDomainContr
529
673
  version: '1.0.0';
530
674
  }
531
675
  export interface OperatingObjectiveV2 {
532
- kind: 'operating-objective'; schemaVersion: '1.0.0'; protocolVersion: '2.0.0';
533
- objectiveId: string; scopeId: string; domainId: string; domainVersion: string; title: string;
534
- status: 'open' | 'at-risk' | 'achieved' | 'deferred' | 'superseded'; ownerActorId: string | null;
535
- horizon: string; successCriteria: string[]; metricIds: string[]; evidenceRefIds: string[];
536
- sourceArtifactId: string; createdAt: string; updatedAt: string;
676
+ kind: 'operating-objective';
677
+ schemaVersion: '1.0.0';
678
+ protocolVersion: '2.0.0';
679
+ objectiveId: string;
680
+ scopeId: string;
681
+ domainId: string;
682
+ domainVersion: string;
683
+ title: string;
684
+ status: 'open' | 'at-risk' | 'achieved' | 'deferred' | 'superseded';
685
+ ownerActorId: string | null;
686
+ horizon: string;
687
+ successCriteria: string[];
688
+ metricIds: string[];
689
+ evidenceRefIds: string[];
690
+ sourceArtifactId: string;
691
+ createdAt: string;
692
+ updatedAt: string;
537
693
  }
538
694
  export interface OperatingMetricV2 {
539
- kind: 'operating-metric'; schemaVersion: '1.0.0'; protocolVersion: '2.0.0';
540
- metricId: string; scopeId: string; domainId: string; domainVersion: string; title: string;
541
- unit: string; aggregation: 'latest' | 'sum' | 'average' | 'minimum' | 'maximum' | 'ratio';
542
- window: string; target: number | null; threshold: number | null; observationIds: string[];
543
- freshness: 'current' | 'historical' | 'stale' | 'unknown'; evidenceRefIds: string[];
544
- sourceArtifactId: string; createdAt: string; updatedAt: string;
695
+ kind: 'operating-metric';
696
+ schemaVersion: '1.0.0';
697
+ protocolVersion: '2.0.0';
698
+ metricId: string;
699
+ scopeId: string;
700
+ domainId: string;
701
+ domainVersion: string;
702
+ title: string;
703
+ unit: string;
704
+ aggregation: 'latest' | 'sum' | 'average' | 'minimum' | 'maximum' | 'ratio';
705
+ window: string;
706
+ target: number | null;
707
+ threshold: number | null;
708
+ observationIds: string[];
709
+ freshness: 'current' | 'historical' | 'stale' | 'unknown';
710
+ evidenceRefIds: string[];
711
+ sourceArtifactId: string;
712
+ createdAt: string;
713
+ updatedAt: string;
545
714
  }
546
715
  export interface OperatingMetricObservationV2 {
547
- kind: 'operating-metric-observation'; schemaVersion: '1.0.0'; protocolVersion: '2.0.0';
548
- observationId: string; metricId: string; scopeId: string; domainId: string; domainVersion: string;
549
- value: number; unit: string; observedAt: string; snapshotId: string; evidenceRefIds: string[]; sourceArtifactId: string;
716
+ kind: 'operating-metric-observation';
717
+ schemaVersion: '1.0.0';
718
+ protocolVersion: '2.0.0';
719
+ observationId: string;
720
+ metricId: string;
721
+ scopeId: string;
722
+ domainId: string;
723
+ domainVersion: string;
724
+ value: number;
725
+ unit: string;
726
+ observedAt: string;
727
+ snapshotId: string;
728
+ evidenceRefIds: string[];
729
+ sourceArtifactId: string;
550
730
  }
551
731
  export interface OperatingRiskBaseV2 {
552
- kind: 'operating-risk'; schemaVersion: '1.0.0'; protocolVersion: '2.0.0';
553
- riskId: string; scopeId: string; domainId: string; domainVersion: string;
554
- title: string; statement: string;
555
- state: 'open' | 'monitoring' | 'mitigated' | 'closed' | 'superseded'; likelihood: number; impact: number; exposure: number;
556
- ownerActorId: string | null; mitigations: string[]; triggerIds: string[]; evidenceRefIds: string[];
557
- sourceArtifactId: string; closedAt: string | null; createdAt: string; updatedAt: string;
558
- revisionId: string; revision: number; predecessorRevisionId: string | null;
732
+ kind: 'operating-risk';
733
+ schemaVersion: '1.0.0';
734
+ protocolVersion: '2.0.0';
735
+ riskId: string;
736
+ scopeId: string;
737
+ domainId: string;
738
+ domainVersion: string;
739
+ title: string;
740
+ statement: string;
741
+ state: 'open' | 'monitoring' | 'mitigated' | 'closed' | 'superseded';
742
+ likelihood: number;
743
+ impact: number;
744
+ exposure: number;
745
+ ownerActorId: string | null;
746
+ mitigations: string[];
747
+ triggerIds: string[];
748
+ evidenceRefIds: string[];
749
+ sourceArtifactId: string;
750
+ closedAt: string | null;
751
+ createdAt: string;
752
+ updatedAt: string;
753
+ revisionId: string;
754
+ revision: number;
755
+ predecessorRevisionId: string | null;
559
756
  }
560
757
  export interface OperatingGenericRiskV2 extends OperatingRiskBaseV2 {
561
758
  origin: 'generic';
562
759
  }
563
760
  export interface OperatingIntelligenceRiskV2 extends OperatingRiskBaseV2 {
564
761
  origin: 'operating-intelligence';
565
- sourceCycleId: string; sourceAssignmentId: string; sourceLocalRiskId: string; sourceClaimIds: string[];
566
- sourceImpact: OperatingFindingSeverityV2; exposureStatement: string; exposedSurfaces: string[];
567
- mitigation: string; reversibility: string;
762
+ sourceCycleId: string;
763
+ sourceAssignmentId: string;
764
+ sourceLocalRiskId: string;
765
+ sourceClaimIds: string[];
766
+ sourceImpact: OperatingFindingSeverityV2;
767
+ exposureStatement: string;
768
+ exposedSurfaces: string[];
769
+ mitigation: string;
770
+ reversibility: string;
568
771
  }
569
772
  export type OperatingRiskV2 = OperatingGenericRiskV2 | OperatingIntelligenceRiskV2;
570
773
  export interface OperatingAssumptionV2 {
571
- kind: 'operating-assumption'; schemaVersion: '1.0.0'; protocolVersion: '2.0.0';
572
- assumptionId: string; scopeId: string; domainId: string; domainVersion: string; statement: string; confidence: number;
573
- status: 'active' | 'validated' | 'invalidated' | 'closed' | 'superseded'; invalidationConditions: string[];
574
- affectedDecisionIds: string[]; affectedActionIds: string[]; evidenceRefIds: string[]; sourceArtifactId: string;
575
- closedAt: string | null; createdAt: string; updatedAt: string;
576
- revisionId: string; revision: number; predecessorRevisionId: string | null;
774
+ kind: 'operating-assumption';
775
+ schemaVersion: '1.0.0';
776
+ protocolVersion: '2.0.0';
777
+ assumptionId: string;
778
+ scopeId: string;
779
+ domainId: string;
780
+ domainVersion: string;
781
+ statement: string;
782
+ confidence: number;
783
+ status: 'active' | 'validated' | 'invalidated' | 'closed' | 'superseded';
784
+ invalidationConditions: string[];
785
+ affectedDecisionIds: string[];
786
+ affectedActionIds: string[];
787
+ evidenceRefIds: string[];
788
+ sourceArtifactId: string;
789
+ closedAt: string | null;
790
+ createdAt: string;
791
+ updatedAt: string;
792
+ revisionId: string;
793
+ revision: number;
794
+ predecessorRevisionId: string | null;
577
795
  }
578
796
  export interface OperatingClaimV2 {
579
- kind: 'operating-claim'; schemaVersion: '1.0.0'; protocolVersion: '2.0.0';
580
- claimId: string; scopeId: string; domainId: string; domainVersion: string; statement: string;
581
- epistemicStatus: 'known' | 'strongly-supported' | 'probable' | 'speculative' | 'unknown'; confidence: number;
582
- supportingEvidenceRefIds: string[]; contradictingEvidenceRefIds: string[]; assumptionIds: string[];
583
- changeCondition: string; sourceArtifactId: string; createdAt: string;
797
+ kind: 'operating-claim';
798
+ schemaVersion: '1.0.0';
799
+ protocolVersion: '2.0.0';
800
+ claimId: string;
801
+ scopeId: string;
802
+ domainId: string;
803
+ domainVersion: string;
804
+ statement: string;
805
+ epistemicStatus: 'known' | 'strongly-supported' | 'probable' | 'speculative' | 'unknown';
806
+ confidence: number;
807
+ supportingEvidenceRefIds: string[];
808
+ contradictingEvidenceRefIds: string[];
809
+ assumptionIds: string[];
810
+ changeCondition: string;
811
+ sourceArtifactId: string;
812
+ createdAt: string;
584
813
  }
585
814
  export interface OperatingModelStateV2 {
586
- kind: 'operating-model-state'; schemaVersion: '1.0.0'; protocolVersion: '2.0.0';
587
- stateId: string; scopeId: string; domainId: string; domainVersion: string; snapshotId: string; runtimeHash: string;
588
- objectives: OperatingObjectiveV2[]; metrics: OperatingMetricV2[]; findings: OperatingFindingV2[];
589
- decisions: OperatingDecisionV2[]; actions: OperatingActionV2[]; risks: OperatingRiskV2[]; assumptions: OperatingAssumptionV2[];
815
+ kind: 'operating-model-state';
816
+ schemaVersion: '1.0.0';
817
+ protocolVersion: '2.0.0';
818
+ stateId: string;
819
+ scopeId: string;
820
+ domainId: string;
821
+ domainVersion: string;
822
+ snapshotId: string;
823
+ runtimeHash: string;
824
+ objectives: OperatingObjectiveV2[];
825
+ metrics: OperatingMetricV2[];
826
+ findings: OperatingFindingV2[];
827
+ decisions: OperatingDecisionV2[];
828
+ actions: OperatingActionV2[];
829
+ risks: OperatingRiskV2[];
830
+ assumptions: OperatingAssumptionV2[];
590
831
  generatedAt: string;
591
832
  }
592
833
  export interface OperatingSnapshotV2 {
593
- kind: 'operating-snapshot'; schemaVersion: '1.0.0'; protocolVersion: '2.0.0';
594
- snapshotId: string; scopeId: string; domainId: string; domainVersion: string; domainContract: OperateDomainContractBindingV2;
595
- stateId: string; runtimeHash: string; previousSnapshotId: string | null; sourceArtifactIds: string[]; evidenceRefIds: string[];
596
- sourceRevisions: Array<{ sourceArtifactId: string; revision: string; evidenceRefIds?: string[] }>; createdAt: string;
834
+ kind: 'operating-snapshot';
835
+ schemaVersion: '1.0.0';
836
+ protocolVersion: '2.0.0';
837
+ snapshotId: string;
838
+ scopeId: string;
839
+ domainId: string;
840
+ domainVersion: string;
841
+ domainContract: OperateDomainContractBindingV2;
842
+ stateId: string;
843
+ runtimeHash: string;
844
+ previousSnapshotId: string | null;
845
+ sourceArtifactIds: string[];
846
+ evidenceRefIds: string[];
847
+ sourceRevisions: Array<{ sourceArtifactId: string; revision: string; evidenceRefIds?: string[] }>;
848
+ createdAt: string;
597
849
  }
598
850
  export interface OperatingDomainProjectionV2 {
599
- kind: 'operating-domain-projection'; schemaVersion: '1.0.0'; protocolVersion: '2.0.0';
600
- projectionId: string; scopeId: string; domainId: string; domainVersion: string; domainContract: OperateDomainContractBindingV2;
601
- snapshotId: string; stateId: string; sourceArtifactIds: string[]; projectionContract: { schemaId: string; schemaVersion: string }; derivedAt: string;
851
+ kind: 'operating-domain-projection';
852
+ schemaVersion: '1.0.0';
853
+ protocolVersion: '2.0.0';
854
+ projectionId: string;
855
+ scopeId: string;
856
+ domainId: string;
857
+ domainVersion: string;
858
+ domainContract: OperateDomainContractBindingV2;
859
+ snapshotId: string;
860
+ stateId: string;
861
+ sourceArtifactIds: string[];
862
+ projectionContract: { schemaId: string; schemaVersion: string };
863
+ derivedAt: string;
602
864
  }
603
- export interface BusinessOperatingSnapshotProjectionV2 extends Omit<OperatingDomainProjectionV2, 'kind' | 'domainId' | 'domainContract'> {
604
- kind: 'business-operating-snapshot-projection'; domainId: 'business';
865
+ export interface BusinessOperatingSnapshotProjectionV2
866
+ extends Omit<OperatingDomainProjectionV2, 'kind' | 'domainId' | 'domainContract'> {
867
+ kind: 'business-operating-snapshot-projection';
868
+ domainId: 'business';
605
869
  domainContract: { apiDomainId: 'business'; id: 'business-domain'; version: '1.0.0' };
606
870
  }
607
- export interface SoftwareOperatingSnapshotProjectionV2 extends Omit<OperatingDomainProjectionV2, 'kind' | 'domainId' | 'domainContract'> {
608
- kind: 'software-operating-snapshot-projection'; domainId: 'software';
871
+ export interface SoftwareOperatingSnapshotProjectionV2
872
+ extends Omit<OperatingDomainProjectionV2, 'kind' | 'domainId' | 'domainContract'> {
873
+ kind: 'software-operating-snapshot-projection';
874
+ domainId: 'software';
609
875
  domainContract: { apiDomainId: 'software'; id: 'software-domain'; version: '1.0.0' };
610
876
  }
611
877
  export interface OperatingDeltaV2 {
612
- kind: 'operating-delta'; schemaVersion: '1.0.0'; protocolVersion: '2.0.0';
613
- deltaId: string; scopeId: string; domainId: string; domainVersion: string; priorSnapshotId: string | null; currentSnapshotId: string;
614
- sourceRevisionChanges: Array<{ subjectId: string; kind: 'added' | 'removed' | 'changed' | 'stale' | 'conflict'; evidenceRefIds?: string[] }>;
615
- metricChanges: Array<{ subjectId: string; kind: 'added' | 'removed' | 'changed' | 'stale' | 'conflict'; evidenceRefIds?: string[] }>;
616
- staleEvidenceRefIds: string[]; conflictingEvidenceRefIds: string[]; invalidatedAssumptionIds: string[]; exposedRiskIds: string[]; decisionRevisitIds: string[]; sourceArtifactId: string; derivedAt: string;
878
+ kind: 'operating-delta';
879
+ schemaVersion: '1.0.0';
880
+ protocolVersion: '2.0.0';
881
+ deltaId: string;
882
+ scopeId: string;
883
+ domainId: string;
884
+ domainVersion: string;
885
+ priorSnapshotId: string | null;
886
+ currentSnapshotId: string;
887
+ sourceRevisionChanges: Array<{
888
+ subjectId: string;
889
+ kind: 'added' | 'removed' | 'changed' | 'stale' | 'conflict';
890
+ evidenceRefIds?: string[];
891
+ }>;
892
+ metricChanges: Array<{
893
+ subjectId: string;
894
+ kind: 'added' | 'removed' | 'changed' | 'stale' | 'conflict';
895
+ evidenceRefIds?: string[];
896
+ }>;
897
+ staleEvidenceRefIds: string[];
898
+ conflictingEvidenceRefIds: string[];
899
+ invalidatedAssumptionIds: string[];
900
+ exposedRiskIds: string[];
901
+ decisionRevisitIds: string[];
902
+ sourceArtifactId: string;
903
+ derivedAt: string;
617
904
  }
618
905
  export interface OperatingIntelligencePlanV2 {
619
- kind: 'operating-intelligence-plan'; schemaVersion: '1.0.0'; protocolVersion: '2.0.0';
620
- planId: string; scopeId: string; domainId: string; domainVersion: string; snapshotId: string; deltaId: string;
621
- selectedRoles: Array<{ roleId: string; roleKind: 'advisor' | 'challenger' | 'chair'; roleVersion: string; inputArtifactIds: string[]; outputContract: { schemaId: string; schemaVersion: string }; dependsOnRoleIds: string[]; reason: string }>;
622
- omittedRoles: Array<{ roleId: string; roleKind: 'advisor' | 'challenger' | 'chair'; roleVersion: string; reason: string }>;
623
- challengerRequired: boolean; scenarioRequest: { requested: boolean; reason: string }; sourceArtifactId: string; decisionOwnerActorId: string; createdAt: string;
906
+ kind: 'operating-intelligence-plan';
907
+ schemaVersion: '1.0.0';
908
+ protocolVersion: '2.0.0';
909
+ planId: string;
910
+ scopeId: string;
911
+ domainId: string;
912
+ domainVersion: string;
913
+ snapshotId: string;
914
+ deltaId: string;
915
+ selectedRoles: Array<{
916
+ roleId: string;
917
+ roleKind: 'advisor' | 'challenger' | 'chair';
918
+ roleVersion: string;
919
+ inputArtifactIds: string[];
920
+ outputContract: { schemaId: string; schemaVersion: string };
921
+ dependsOnRoleIds: string[];
922
+ reason: string;
923
+ }>;
924
+ omittedRoles: Array<{
925
+ roleId: string;
926
+ roleKind: 'advisor' | 'challenger' | 'chair';
927
+ roleVersion: string;
928
+ reason: string;
929
+ }>;
930
+ challengerRequired: boolean;
931
+ scenarioRequest: { requested: boolean; reason: string };
932
+ sourceArtifactId: string;
933
+ decisionOwnerActorId: string;
934
+ createdAt: string;
624
935
  }
625
936
 
626
937
  export interface OperatingStateProjectionRecordV2 {
@@ -632,83 +943,212 @@ export interface OperatingStateProjectionRecordV2 {
632
943
  }
633
944
 
634
945
  export interface OperatingIntelligenceInputBundleV2 {
635
- kind: 'operating-intelligence-input-bundle'; schemaVersion: '1.0.0'; protocolVersion: '2.0.0';
636
- bundleId: string; cycleId: string; snapshotId: string; deltaId: string; scopeId: string; domainId: string; domainVersion: string;
637
- snapshot: OperatingSnapshotV2; delta: OperatingDeltaV2;
946
+ kind: 'operating-intelligence-input-bundle';
947
+ schemaVersion: '1.0.0';
948
+ protocolVersion: '2.0.0';
949
+ bundleId: string;
950
+ cycleId: string;
951
+ snapshotId: string;
952
+ deltaId: string;
953
+ scopeId: string;
954
+ domainId: string;
955
+ domainVersion: string;
956
+ snapshot: OperatingSnapshotV2;
957
+ delta: OperatingDeltaV2;
638
958
  operatingState: {
639
- kind: 'operating-state-projection'; schemaVersion: '1.0.0'; protocolVersion: '2.0.0';
640
- sourceStateId: string; sourceRuntimeHash: string; scopeId: string; domainId: string; domainVersion: string; snapshotId: string;
959
+ kind: 'operating-state-projection';
960
+ schemaVersion: '1.0.0';
961
+ protocolVersion: '2.0.0';
962
+ sourceStateId: string;
963
+ sourceRuntimeHash: string;
964
+ scopeId: string;
965
+ domainId: string;
966
+ domainVersion: string;
967
+ snapshotId: string;
641
968
  selectionPolicy: 'deterministic-priority-v1';
642
- objectives: OperatingStateProjectionRecordV2[]; metrics: OperatingStateProjectionRecordV2[]; findings: OperatingStateProjectionRecordV2[];
643
- decisions: OperatingStateProjectionRecordV2[]; actions: OperatingStateProjectionRecordV2[]; risks: OperatingStateProjectionRecordV2[];
969
+ objectives: OperatingStateProjectionRecordV2[];
970
+ metrics: OperatingStateProjectionRecordV2[];
971
+ findings: OperatingStateProjectionRecordV2[];
972
+ decisions: OperatingStateProjectionRecordV2[];
973
+ actions: OperatingStateProjectionRecordV2[];
974
+ risks: OperatingStateProjectionRecordV2[];
644
975
  assumptions: OperatingStateProjectionRecordV2[];
645
- coverage: Record<'objectives' | 'metrics' | 'findings' | 'decisions' | 'actions' | 'risks' | 'assumptions', { included: number; total: number; omitted: number }>;
976
+ coverage: Record<
977
+ 'objectives' | 'metrics' | 'findings' | 'decisions' | 'actions' | 'risks' | 'assumptions',
978
+ { included: number; total: number; omitted: number }
979
+ >;
646
980
  projectedAt: string;
647
981
  };
648
982
  sourceArtifactIds: string[];
649
983
  assignmentBinding: {
650
- assignmentId: string; roleId: string; roleKind: 'advisor' | 'challenger' | 'chair'; roleVersion: string;
651
- analysisProfile: OperatingAnalysisProfileV2; evidenceRequirements: OperatingEvidenceRequirementV2[];
652
- resultRequirements: OperatingResultRequirementV2[]; issuedEvidence: OperatingIssuedEvidenceV2[];
984
+ assignmentId: string;
985
+ roleId: string;
986
+ roleKind: 'advisor' | 'challenger' | 'chair';
987
+ roleVersion: string;
988
+ analysisProfile: OperatingAnalysisProfileV2;
989
+ evidenceRequirements: OperatingEvidenceRequirementV2[];
990
+ resultRequirements: OperatingResultRequirementV2[];
991
+ issuedEvidence: OperatingIssuedEvidenceV2[];
653
992
  evidenceAbsences: OperatingEvidenceInputAbsenceV2[];
654
993
  };
655
994
  createdAt: string;
656
995
  }
657
996
 
658
997
  export interface OperatingAdvisorQuestionAnswerV2 {
659
- questionId: string; answer: string; claimIds: string[]; measurementIds: string[]; riskIds: string[]; evidenceRefIds: string[]; absenceIds: string[];
998
+ questionId: string;
999
+ answer: string;
1000
+ claimIds: string[];
1001
+ measurementIds: string[];
1002
+ riskIds: string[];
1003
+ evidenceRefIds: string[];
1004
+ absenceIds: string[];
660
1005
  }
661
1006
  export interface OperatingAdvisorProfileInsightV2 {
662
- localAnalysisId: string; title: string; statement: string; claimIds: string[]; measurementIds: string[];
663
- riskIds: string[]; alternativeIds: string[]; evidenceRefIds: string[]; absenceIds: string[];
1007
+ localAnalysisId: string;
1008
+ title: string;
1009
+ statement: string;
1010
+ claimIds: string[];
1011
+ measurementIds: string[];
1012
+ riskIds: string[];
1013
+ alternativeIds: string[];
1014
+ evidenceRefIds: string[];
1015
+ absenceIds: string[];
664
1016
  }
665
1017
  type OperatingAdvisorProfileAnalysisV2 = {
666
- profileId: 'strategy-finance' | 'technology-risk' | 'product-activation' | 'growth-market' | 'operations-customer' | 'software-delivery';
1018
+ profileId:
1019
+ | 'strategy-finance'
1020
+ | 'technology-risk'
1021
+ | 'product-activation'
1022
+ | 'growth-market'
1023
+ | 'operations-customer'
1024
+ | 'software-delivery';
667
1025
  executiveQuestionAnswers: OperatingAdvisorQuestionAnswerV2[];
668
- } & Record<string, OperatingAdvisorProfileInsightV2[] | OperatingAdvisorProfileInsightV2 | null | string | OperatingAdvisorQuestionAnswerV2[]>;
1026
+ } & Record<
1027
+ string,
1028
+ | OperatingAdvisorProfileInsightV2[]
1029
+ | OperatingAdvisorProfileInsightV2
1030
+ | null
1031
+ | string
1032
+ | OperatingAdvisorQuestionAnswerV2[]
1033
+ >;
669
1034
  export interface OperatingAdvisorClaimV2 {
670
- localClaimId: string; statement: string; epistemicStatus: 'known' | 'strongly-supported' | 'probable' | 'speculative' | 'unknown';
671
- confidence: number; supportingEvidenceRefIds: string[]; contradictingEvidenceRefIds: string[]; assumptionIds: string[]; changeCondition: string;
672
- }
673
- export type OperatingAdvisorMeasureKindV2 = 'runway' | 'margin' | 'funnel' | 'channel-economics' | 'capacity' | 'throughput' | 'exposure' | 'scenario' | 'metric-trend';
1035
+ localClaimId: string;
1036
+ statement: string;
1037
+ epistemicStatus: 'known' | 'strongly-supported' | 'probable' | 'speculative' | 'unknown';
1038
+ confidence: number;
1039
+ supportingEvidenceRefIds: string[];
1040
+ contradictingEvidenceRefIds: string[];
1041
+ assumptionIds: string[];
1042
+ changeCondition: string;
1043
+ }
1044
+ export type OperatingAdvisorMeasureKindV2 =
1045
+ | 'runway'
1046
+ | 'margin'
1047
+ | 'funnel'
1048
+ | 'channel-economics'
1049
+ | 'capacity'
1050
+ | 'throughput'
1051
+ | 'exposure'
1052
+ | 'scenario'
1053
+ | 'metric-trend';
674
1054
  export type OperatingAdvisorMeasurementV2 = {
675
- localMeasurementId: string; kind: OperatingAdvisorMeasureKindV2; name: string; period: string;
676
- evidenceRefIds: string[]; interpretation: string; confidence: number;
1055
+ localMeasurementId: string;
1056
+ kind: OperatingAdvisorMeasureKindV2;
1057
+ name: string;
1058
+ period: string;
1059
+ evidenceRefIds: string[];
1060
+ interpretation: string;
1061
+ confidence: number;
677
1062
  } & Record<string, JsonValue>;
678
1063
  export interface OperatingAdvisorRiskV2 {
679
- localRiskId: string; title: string; statement: string; likelihood: number; impact: 'low' | 'medium' | 'high' | 'critical';
680
- exposure: string; exposedSurfaces: string[]; claimIds: string[]; evidenceRefIds: string[]; mitigation: string; reversibility: string;
1064
+ localRiskId: string;
1065
+ title: string;
1066
+ statement: string;
1067
+ likelihood: number;
1068
+ impact: 'low' | 'medium' | 'high' | 'critical';
1069
+ exposure: string;
1070
+ exposedSurfaces: string[];
1071
+ claimIds: string[];
1072
+ evidenceRefIds: string[];
1073
+ mitigation: string;
1074
+ reversibility: string;
681
1075
  }
682
1076
  export interface OperatingAdvisorAlternativeV2 {
683
- localAlternativeId: string; title: string; description: string; supportingClaimIds: string[]; evidenceRefIds: string[];
684
- tradeoffs: string[]; costOfDelay: string; reversibility: string;
1077
+ localAlternativeId: string;
1078
+ title: string;
1079
+ description: string;
1080
+ supportingClaimIds: string[];
1081
+ evidenceRefIds: string[];
1082
+ tradeoffs: string[];
1083
+ costOfDelay: string;
1084
+ reversibility: string;
685
1085
  }
686
1086
  export interface OperatingIntelligenceGapV2 {
687
- localGapId: string; inputAbsenceId: string; requirementId: string; impact: string; recoveryPath: string;
1087
+ localGapId: string;
1088
+ inputAbsenceId: string;
1089
+ requirementId: string;
1090
+ impact: string;
1091
+ recoveryPath: string;
688
1092
  }
689
1093
  export type OperatingChallengerGapV2 =
690
1094
  | {
691
- localGapId: string; inputAbsenceId: string; kind: 'evidence'; requirementId: string;
692
- impact: string; recoveryPath: string;
1095
+ localGapId: string;
1096
+ inputAbsenceId: string;
1097
+ kind: 'evidence';
1098
+ requirementId: string;
1099
+ impact: string;
1100
+ recoveryPath: string;
693
1101
  }
694
1102
  | {
695
- localGapId: string; inputAbsenceId: string; kind: 'role'; roleId: string;
696
- roleKind: 'advisor' | 'challenger' | 'chair'; roleVersion: string; sourceAssignmentId: string | null;
697
- impact: string; recoveryPath: string;
1103
+ localGapId: string;
1104
+ inputAbsenceId: string;
1105
+ kind: 'role';
1106
+ roleId: string;
1107
+ roleKind: 'advisor' | 'challenger' | 'chair';
1108
+ roleVersion: string;
1109
+ sourceAssignmentId: string | null;
1110
+ impact: string;
1111
+ recoveryPath: string;
698
1112
  };
699
1113
  export interface OperatingAdvisorRecommendationV2 {
700
- localRecommendationId: string; title: string; proposal: string; rationaleClaimIds: string[]; alternativeIds: string[];
701
- riskIds: string[]; confidence: number; expectedUpside: string; expectedDownside: string; uncertainty: string;
702
- reversibility: string; successMeasurementIds: string[]; revisitConditions: string[];
1114
+ localRecommendationId: string;
1115
+ title: string;
1116
+ proposal: string;
1117
+ rationaleClaimIds: string[];
1118
+ alternativeIds: string[];
1119
+ riskIds: string[];
1120
+ confidence: number;
1121
+ expectedUpside: string;
1122
+ expectedDownside: string;
1123
+ uncertainty: string;
1124
+ reversibility: string;
1125
+ successMeasurementIds: string[];
1126
+ revisitConditions: string[];
703
1127
  }
704
1128
 
705
1129
  export interface OperatingAdvisorResultV2 {
706
- kind: 'operating-advisor-result'; schemaVersion: '1.0.0'; protocolVersion: '2.0.0';
707
- assignmentId: string; roleId: string; roleVersion: string; analysisProfile: OperatingAnalysisProfileV2;
708
- intelligencePlanId: string; snapshotId: string; scopeId: string; domainId: string; domainVersion: string;
709
- outcome: 'recommendation' | 'partial' | 'quiet'; summary: string; analysisMarkdown: string; inputAbsenceIds: string[];
710
- analysis: OperatingAdvisorProfileAnalysisV2; claims: OperatingAdvisorClaimV2[]; measurements: OperatingAdvisorMeasurementV2[];
711
- risks: OperatingAdvisorRiskV2[]; alternatives: OperatingAdvisorAlternativeV2[]; gaps: OperatingIntelligenceGapV2[];
1130
+ kind: 'operating-advisor-result';
1131
+ schemaVersion: '1.0.0';
1132
+ protocolVersion: '2.0.0';
1133
+ assignmentId: string;
1134
+ roleId: string;
1135
+ roleVersion: string;
1136
+ analysisProfile: OperatingAnalysisProfileV2;
1137
+ intelligencePlanId: string;
1138
+ snapshotId: string;
1139
+ scopeId: string;
1140
+ domainId: string;
1141
+ domainVersion: string;
1142
+ outcome: 'recommendation' | 'partial' | 'quiet';
1143
+ summary: string;
1144
+ analysisMarkdown: string;
1145
+ inputAbsenceIds: string[];
1146
+ analysis: OperatingAdvisorProfileAnalysisV2;
1147
+ claims: OperatingAdvisorClaimV2[];
1148
+ measurements: OperatingAdvisorMeasurementV2[];
1149
+ risks: OperatingAdvisorRiskV2[];
1150
+ alternatives: OperatingAdvisorAlternativeV2[];
1151
+ gaps: OperatingIntelligenceGapV2[];
712
1152
  recommendation: OperatingAdvisorRecommendationV2 | null;
713
1153
  }
714
1154
 
@@ -732,24 +1172,83 @@ export type OperatingContextCaptureV2 = {
732
1172
  );
733
1173
 
734
1174
  export interface OperatingChallengerReviewV2 {
735
- kind: 'operating-challenger-review'; schemaVersion: '1.0.0'; protocolVersion: '2.0.0';
736
- assignmentId: string; roleId: string; roleVersion: string; analysisProfile: OperatingAnalysisProfileV2;
737
- intelligencePlanId: string; snapshotId: string; scopeId: string; domainId: string; domainVersion: string;
738
- summary: string; analysisMarkdown: string; inputAbsenceIds: string[]; advisorArtifactIds: string[];
1175
+ kind: 'operating-challenger-review';
1176
+ schemaVersion: '1.0.0';
1177
+ protocolVersion: '2.0.0';
1178
+ assignmentId: string;
1179
+ roleId: string;
1180
+ roleVersion: string;
1181
+ analysisProfile: OperatingAnalysisProfileV2;
1182
+ intelligencePlanId: string;
1183
+ snapshotId: string;
1184
+ scopeId: string;
1185
+ domainId: string;
1186
+ domainVersion: string;
1187
+ summary: string;
1188
+ analysisMarkdown: string;
1189
+ inputAbsenceIds: string[];
1190
+ advisorArtifactIds: string[];
739
1191
  reviewedClaims: Array<{ advisorArtifactId: string; localClaimId: string }>;
740
1192
  questionCoverage: Array<{
741
- questionId: string; disposition: 'answered' | 'gap' | 'not-applicable'; answer: string;
742
- findingIds: string[]; alternativeIds: string[]; dissentIds: string[]; gapIds: string[]; justification: string | null;
1193
+ questionId: string;
1194
+ disposition: 'answered' | 'gap' | 'not-applicable';
1195
+ answer: string;
1196
+ findingIds: string[];
1197
+ alternativeIds: string[];
1198
+ dissentIds: string[];
1199
+ gapIds: string[];
1200
+ justification: string | null;
743
1201
  }>;
744
1202
  findings: Array<{
745
- localFindingId: string; title: string; statement: string;
746
- type: 'unsupported' | 'contradicted' | 'correlated-reasoning' | 'missing-alternative' | 'unpriced-downside' | 'irreversibility-mismatch' | 'overconfidence' | 'scope-violation';
747
- severity: 'low' | 'medium' | 'high' | 'critical'; confidence: number;
748
- targets: Array<{ advisorArtifactId: string; analysisIds: string[]; claimIds: string[]; measurementIds: string[]; riskIds: string[]; recommendationIds: string[] }>;
749
- supportingEvidenceRefIds: string[]; contradictingEvidenceRefIds: string[]; rationale: string; correctionCondition: string;
1203
+ localFindingId: string;
1204
+ title: string;
1205
+ statement: string;
1206
+ type:
1207
+ | 'unsupported'
1208
+ | 'contradicted'
1209
+ | 'correlated-reasoning'
1210
+ | 'missing-alternative'
1211
+ | 'unpriced-downside'
1212
+ | 'irreversibility-mismatch'
1213
+ | 'overconfidence'
1214
+ | 'scope-violation';
1215
+ severity: 'low' | 'medium' | 'high' | 'critical';
1216
+ confidence: number;
1217
+ targets: Array<{
1218
+ advisorArtifactId: string;
1219
+ analysisIds: string[];
1220
+ claimIds: string[];
1221
+ measurementIds: string[];
1222
+ riskIds: string[];
1223
+ recommendationIds: string[];
1224
+ }>;
1225
+ supportingEvidenceRefIds: string[];
1226
+ contradictingEvidenceRefIds: string[];
1227
+ rationale: string;
1228
+ correctionCondition: string;
1229
+ }>;
1230
+ missingAlternatives: Array<{
1231
+ localAlternativeId: string;
1232
+ title: string;
1233
+ description: string;
1234
+ targets: Array<{
1235
+ advisorArtifactId: string;
1236
+ analysisIds: string[];
1237
+ claimIds: string[];
1238
+ measurementIds: string[];
1239
+ riskIds: string[];
1240
+ recommendationIds: string[];
1241
+ }>;
1242
+ evidenceRefIds: string[];
1243
+ tradeoffs: string[];
1244
+ }>;
1245
+ dissent: Array<{
1246
+ localDissentId: string;
1247
+ findingIds: string[];
1248
+ statement: string;
1249
+ evidenceRefIds: string[];
1250
+ resolutionCondition: string;
750
1251
  }>;
751
- missingAlternatives: Array<{ localAlternativeId: string; title: string; description: string; targets: Array<{ advisorArtifactId: string; analysisIds: string[]; claimIds: string[]; measurementIds: string[]; riskIds: string[]; recommendationIds: string[] }>; evidenceRefIds: string[]; tradeoffs: string[] }>;
752
- dissent: Array<{ localDissentId: string; findingIds: string[]; statement: string; evidenceRefIds: string[]; resolutionCondition: string }>;
753
1252
  gaps: OperatingChallengerGapV2[];
754
1253
  }
755
1254
 
@@ -757,86 +1256,261 @@ export function assertOperateIntelligencePlanContractV2(
757
1256
  value: OperatingIntelligencePlanV2,
758
1257
  ): OperatingIntelligencePlanV2;
759
1258
  export interface OperatingDecisionLedgerV2 {
760
- kind: 'operating-decision-ledger'; schemaVersion: '1.0.0'; protocolVersion: '2.0.0';
761
- assignmentId: string; roleId: string; roleVersion: string; analysisProfile: OperatingAnalysisProfileV2;
762
- ledgerId: string; scopeId: string; domainId: string; domainVersion: string; snapshotId: string; intelligencePlanId: string; summary: string;
763
- advisorArtifactIds: string[]; challengerArtifactId: string | null;
764
- advisorAbsenceGaps: OperatingRoleInputAbsenceV2[]; evidenceGaps: OperatingEvidenceInputAbsenceV2[];
1259
+ kind: 'operating-decision-ledger';
1260
+ schemaVersion: '1.0.0';
1261
+ protocolVersion: '2.0.0';
1262
+ assignmentId: string;
1263
+ roleId: string;
1264
+ roleVersion: string;
1265
+ analysisProfile: OperatingAnalysisProfileV2;
1266
+ ledgerId: string;
1267
+ scopeId: string;
1268
+ domainId: string;
1269
+ domainVersion: string;
1270
+ snapshotId: string;
1271
+ intelligencePlanId: string;
1272
+ summary: string;
1273
+ advisorArtifactIds: string[];
1274
+ challengerArtifactId: string | null;
1275
+ advisorAbsenceGaps: OperatingRoleInputAbsenceV2[];
1276
+ evidenceGaps: OperatingEvidenceInputAbsenceV2[];
765
1277
  questionCoverage: Array<{
766
- questionId: string; disposition: 'answered' | 'gap' | 'not-applicable'; answer: string;
767
- decisionIds: string[]; findingIds: string[]; dissentIds: string[]; absenceIds: string[]; justification: string | null;
1278
+ questionId: string;
1279
+ disposition: 'answered' | 'gap' | 'not-applicable';
1280
+ answer: string;
1281
+ decisionIds: string[];
1282
+ findingIds: string[];
1283
+ dissentIds: string[];
1284
+ absenceIds: string[];
1285
+ justification: string | null;
768
1286
  }>;
769
1287
  decisions: Array<{
770
- localDecisionId: string; title: string; question: string; outcome: string; rationale: string;
1288
+ localDecisionId: string;
1289
+ title: string;
1290
+ question: string;
1291
+ outcome: string;
1292
+ rationale: string;
771
1293
  sourceClaimRefs: Array<{ advisorArtifactId: string; localClaimId: string }>;
772
1294
  sourceRecommendationRefs: Array<{ advisorArtifactId: string; localRecommendationId: string }>;
773
- challengerFindingIds: string[]; evidenceRefIds: string[];
774
- alternativeDispositions: Array<{ sourceArtifactId: string; localAlternativeId: string; title: string; disposition: 'accepted' | 'rejected' | 'deferred'; rationale: string }>;
775
- confidence: number; assumptionIds: string[]; upside: string; downside: string; uncertainty: string; reversibility: string;
776
- ownerActorId: string; revisitConditions: string[]; dissentIds: string[]; actionHypotheses: OperatingActionHypothesisV2[];
1295
+ challengerFindingIds: string[];
1296
+ evidenceRefIds: string[];
1297
+ alternativeDispositions: Array<{
1298
+ sourceArtifactId: string;
1299
+ localAlternativeId: string;
1300
+ title: string;
1301
+ disposition: 'accepted' | 'rejected' | 'deferred';
1302
+ rationale: string;
1303
+ }>;
1304
+ confidence: number;
1305
+ assumptionIds: string[];
1306
+ upside: string;
1307
+ downside: string;
1308
+ uncertainty: string;
1309
+ reversibility: string;
1310
+ ownerActorId: string;
1311
+ revisitConditions: string[];
1312
+ dissentIds: string[];
1313
+ actionHypotheses: OperatingActionHypothesisV2[];
1314
+ }>;
1315
+ sourceDispositions: Array<{
1316
+ sourceArtifactId: string;
1317
+ sourceKind:
1318
+ | 'advisor-outcome'
1319
+ | 'advisor-recommendation'
1320
+ | 'challenger-finding'
1321
+ | 'challenger-dissent';
1322
+ localSourceId: string;
1323
+ sourceOutcome: 'partial' | 'quiet' | null;
1324
+ disposition: 'accepted' | 'rejected' | 'deferred' | 'noted';
1325
+ localDecisionId: string | null;
1326
+ rationale: string;
1327
+ }>;
1328
+ dissent: Array<{
1329
+ sourceArtifactId: string;
1330
+ localDissentId: string;
1331
+ findingIds: string[];
1332
+ statement: string;
1333
+ evidenceRefIds: string[];
1334
+ resolutionCondition: string;
777
1335
  }>;
778
- sourceDispositions: Array<{ sourceArtifactId: string; sourceKind: 'advisor-outcome' | 'advisor-recommendation' | 'challenger-finding' | 'challenger-dissent'; localSourceId: string; sourceOutcome: 'partial' | 'quiet' | null; disposition: 'accepted' | 'rejected' | 'deferred' | 'noted'; localDecisionId: string | null; rationale: string }>;
779
- dissent: Array<{ sourceArtifactId: string; localDissentId: string; findingIds: string[]; statement: string; evidenceRefIds: string[]; resolutionCondition: string }>;
780
1336
  sourceArtifactId: string;
781
1337
  }
782
1338
  export interface OperatingActionHypothesisV2 {
783
- localActionHypothesisId: string; title: string; objectiveId: string; ownerActorId: string | null; accountabilityDisposition: 'unowned' | 'blocked' | null;
784
- expectedResult: string; metricId: string; baseline: number; target: number; verificationWindow: string;
785
- verificationMethod: string; sourceClaimRefs: Array<{ advisorArtifactId: string; localClaimId: string }>;
786
- sourceFindingIds: string[]; dependsOnActionHypothesisIds: string[];
1339
+ localActionHypothesisId: string;
1340
+ title: string;
1341
+ objectiveId: string;
1342
+ ownerActorId: string | null;
1343
+ accountabilityDisposition: 'unowned' | 'blocked' | null;
1344
+ expectedResult: string;
1345
+ metricId: string;
1346
+ baseline: number;
1347
+ target: number;
1348
+ verificationWindow: string;
1349
+ verificationMethod: string;
1350
+ sourceClaimRefs: Array<{ advisorArtifactId: string; localClaimId: string }>;
1351
+ sourceFindingIds: string[];
1352
+ dependsOnActionHypothesisIds: string[];
787
1353
  }
788
1354
  export interface OperatingActionVerificationPlanV2 {
789
- kind: 'operating-action-verification-plan'; schemaVersion: '1.0.0'; protocolVersion: '2.0.0';
790
- verificationPlanId: string; actionId: string; scopeId: string; domainId: string; domainVersion: string; metricId: string;
791
- baseline: number; target: number; window: string; method: string;
792
- observationRequest: { kind: 'future-observation' | 'future-analysis'; reason: string }; evaluationRules: string[]; revisitDecisionIds: string[]; sourceArtifactId: string; createdAt: string;
1355
+ kind: 'operating-action-verification-plan';
1356
+ schemaVersion: '1.0.0';
1357
+ protocolVersion: '2.0.0';
1358
+ verificationPlanId: string;
1359
+ actionId: string;
1360
+ scopeId: string;
1361
+ domainId: string;
1362
+ domainVersion: string;
1363
+ metricId: string;
1364
+ baseline: number;
1365
+ target: number;
1366
+ window: string;
1367
+ method: string;
1368
+ observationRequest: { kind: 'future-observation' | 'future-analysis'; reason: string };
1369
+ evaluationRules: string[];
1370
+ revisitDecisionIds: string[];
1371
+ sourceArtifactId: string;
1372
+ createdAt: string;
793
1373
  }
794
1374
  export interface OperatingOutcomeV2 {
795
- kind: 'operating-outcome'; schemaVersion: '1.0.0'; protocolVersion: '2.0.0';
796
- outcomeId: string; actionId: string; scopeId: string; domainId: string; domainVersion: string; verificationPlanId: string;
797
- status: 'succeeded' | 'failed' | 'blocked' | 'cancelled' | 'insufficient-evidence'; observationIds: string[]; evidenceRefIds: string[]; sourceArtifactId: string; observedAt: string;
1375
+ kind: 'operating-outcome';
1376
+ schemaVersion: '1.0.0';
1377
+ protocolVersion: '2.0.0';
1378
+ outcomeId: string;
1379
+ actionId: string;
1380
+ scopeId: string;
1381
+ domainId: string;
1382
+ domainVersion: string;
1383
+ verificationPlanId: string;
1384
+ status: 'succeeded' | 'failed' | 'blocked' | 'cancelled' | 'insufficient-evidence';
1385
+ observationIds: string[];
1386
+ evidenceRefIds: string[];
1387
+ sourceArtifactId: string;
1388
+ observedAt: string;
798
1389
  }
799
1390
  export interface OperatingLearningV2 {
800
- kind: 'operating-learning'; schemaVersion: '1.0.0'; protocolVersion: '2.0.0';
801
- learningId: string; scopeId: string; domainId: string; domainVersion: string; statement: string; outcomeId: string;
802
- assumptionIds: string[]; decisionIds: string[]; evidenceRefIds: string[]; sourceArtifactId: string; createdAt: string;
1391
+ kind: 'operating-learning';
1392
+ schemaVersion: '1.0.0';
1393
+ protocolVersion: '2.0.0';
1394
+ learningId: string;
1395
+ scopeId: string;
1396
+ domainId: string;
1397
+ domainVersion: string;
1398
+ statement: string;
1399
+ outcomeId: string;
1400
+ assumptionIds: string[];
1401
+ decisionIds: string[];
1402
+ evidenceRefIds: string[];
1403
+ sourceArtifactId: string;
1404
+ createdAt: string;
803
1405
  }
804
1406
  export type OperatingExecutionVerificationStatusV2 =
805
- | 'success' | 'failure' | 'blocked' | 'uncertain' | 'partial' | 'cancelled' | 'rolled-back';
1407
+ | 'success'
1408
+ | 'failure'
1409
+ | 'blocked'
1410
+ | 'uncertain'
1411
+ | 'partial'
1412
+ | 'cancelled'
1413
+ | 'rolled-back';
806
1414
  export type OperatingHypothesisVerificationStatusV2 =
807
- | 'pending' | 'confirmed' | 'failed' | 'blocked' | 'cancelled' | 'revisit';
1415
+ | 'pending'
1416
+ | 'confirmed'
1417
+ | 'failed'
1418
+ | 'blocked'
1419
+ | 'cancelled'
1420
+ | 'revisit';
808
1421
  export interface OperatingVerificationFeedbackV2 {
809
- actionId: string; verificationPlanId: string;
1422
+ actionId: string;
1423
+ verificationPlanId: string;
810
1424
  executionStatus: OperatingExecutionVerificationStatusV2;
811
1425
  hypothesisStatus: OperatingHypothesisVerificationStatusV2;
812
- executionCompleted: boolean; hypothesisConfirmed: boolean; revisit: boolean; cycleClosed: boolean;
1426
+ executionCompleted: boolean;
1427
+ hypothesisConfirmed: boolean;
1428
+ revisit: boolean;
1429
+ cycleClosed: boolean;
813
1430
  provenance: {
814
- outcomeId: string | null; learningId: string | null; deltaId: string | null; snapshotId: string | null;
815
- sourceArtifactId: string; observationIds: string[]; evidenceRefIds: string[];
1431
+ outcomeId: string | null;
1432
+ learningId: string | null;
1433
+ deltaId: string | null;
1434
+ snapshotId: string | null;
1435
+ sourceArtifactId: string;
1436
+ observationIds: string[];
1437
+ evidenceRefIds: string[];
816
1438
  };
817
1439
  }
818
1440
  export interface OperatingScenarioV2 {
819
- kind: 'operating-scenario'; schemaVersion: '1.0.0'; protocolVersion: '2.0.0';
820
- scenarioId: string; scopeId: string; domainId: string; domainVersion: string; snapshotId: string;
821
- base: OperatingScenarioCaseV2; upside: OperatingScenarioCaseV2; downside: OperatingScenarioCaseV2;
822
- breakEven: string; assumptionIds: string[]; evidenceRefIds: string[]; uncertainty: string; sourceArtifactId: string; createdAt: string;
1441
+ kind: 'operating-scenario';
1442
+ schemaVersion: '1.0.0';
1443
+ protocolVersion: '2.0.0';
1444
+ scenarioId: string;
1445
+ scopeId: string;
1446
+ domainId: string;
1447
+ domainVersion: string;
1448
+ snapshotId: string;
1449
+ base: OperatingScenarioCaseV2;
1450
+ upside: OperatingScenarioCaseV2;
1451
+ downside: OperatingScenarioCaseV2;
1452
+ breakEven: string;
1453
+ assumptionIds: string[];
1454
+ evidenceRefIds: string[];
1455
+ uncertainty: string;
1456
+ sourceArtifactId: string;
1457
+ createdAt: string;
1458
+ }
1459
+ export interface OperatingScenarioCaseV2 {
1460
+ statement: string;
1461
+ assumptionIds: string[];
1462
+ evidenceRefIds: string[];
1463
+ sourceArtifactId: string;
823
1464
  }
824
- export interface OperatingScenarioCaseV2 { statement: string; assumptionIds: string[]; evidenceRefIds: string[]; sourceArtifactId: string; }
825
1465
  export interface OperatingEventTriggerV2 {
826
- kind: 'operating-event-trigger'; schemaVersion: '1.0.0'; protocolVersion: '2.0.0';
827
- triggerId: string; scopeId: string; domainId: string; domainVersion: string; snapshotId: string;
828
- condition: string; evidenceRefIds: string[]; requestedWork: 'observation' | 'cycle'; sourceArtifactId: string; createdAt: string;
1466
+ kind: 'operating-event-trigger';
1467
+ schemaVersion: '1.0.0';
1468
+ protocolVersion: '2.0.0';
1469
+ triggerId: string;
1470
+ scopeId: string;
1471
+ domainId: string;
1472
+ domainVersion: string;
1473
+ snapshotId: string;
1474
+ condition: string;
1475
+ evidenceRefIds: string[];
1476
+ requestedWork: 'observation' | 'cycle';
1477
+ sourceArtifactId: string;
1478
+ createdAt: string;
829
1479
  }
830
1480
  export interface OperateSignalProviderRegistrationV2 {
831
- providerId: string; providerVersion: string;
832
- supportedDomains: Array<{ apiDomainId: string; domainContractId: string; domainContractVersion: string }>;
833
- inputContract: { schemaId: string; schemaVersion: '2.0.0' }; outputContract: { schemaId: string; schemaVersion: '2.0.0' };
834
- accessMode: 'accepted-input-only' | 'declared-read-only'; returnSemantics: 'candidate'; errorCodes: Array<'OPERATING_PROVIDER_INPUT_INVALID' | 'OPERATING_PROVIDER_UNAVAILABLE'>;
835
- provenance: { packageName: string; packageVersion: string; integrity: string }; conformanceDigest: string; implementation: { kind: 'built-in'; id: string }; fallback: { kind: 'unavailable'; errorCode: 'OPERATING_PROVIDER_UNAVAILABLE' };
1481
+ providerId: string;
1482
+ providerVersion: string;
1483
+ supportedDomains: Array<{
1484
+ apiDomainId: string;
1485
+ domainContractId: string;
1486
+ domainContractVersion: string;
1487
+ }>;
1488
+ inputContract: { schemaId: string; schemaVersion: '2.0.0' };
1489
+ outputContract: { schemaId: string; schemaVersion: '2.0.0' };
1490
+ accessMode: 'accepted-input-only' | 'declared-read-only';
1491
+ returnSemantics: 'candidate';
1492
+ errorCodes: Array<'OPERATING_PROVIDER_INPUT_INVALID' | 'OPERATING_PROVIDER_UNAVAILABLE'>;
1493
+ provenance: { packageName: string; packageVersion: string; integrity: string };
1494
+ conformanceDigest: string;
1495
+ implementation: { kind: 'built-in'; id: string };
1496
+ fallback: { kind: 'unavailable'; errorCode: 'OPERATING_PROVIDER_UNAVAILABLE' };
1497
+ }
1498
+ export interface OperateSnapshotProviderRegistrationV2 extends OperateSignalProviderRegistrationV2 {
1499
+ kind: 'operate-snapshot-provider-registration';
1500
+ schemaVersion: '1.0.0';
1501
+ protocolVersion: '2.0.0';
1502
+ }
1503
+ export interface OperateMetricProviderRegistrationV2 extends OperateSignalProviderRegistrationV2 {
1504
+ kind: 'operate-metric-provider-registration';
1505
+ schemaVersion: '1.0.0';
1506
+ protocolVersion: '2.0.0';
1507
+ }
1508
+ export interface OperateVerificationProviderRegistrationV2
1509
+ extends OperateSignalProviderRegistrationV2 {
1510
+ kind: 'operate-verification-provider-registration';
1511
+ schemaVersion: '1.0.0';
1512
+ protocolVersion: '2.0.0';
836
1513
  }
837
- export interface OperateSnapshotProviderRegistrationV2 extends OperateSignalProviderRegistrationV2 { kind: 'operate-snapshot-provider-registration'; schemaVersion: '1.0.0'; protocolVersion: '2.0.0'; }
838
- export interface OperateMetricProviderRegistrationV2 extends OperateSignalProviderRegistrationV2 { kind: 'operate-metric-provider-registration'; schemaVersion: '1.0.0'; protocolVersion: '2.0.0'; }
839
- export interface OperateVerificationProviderRegistrationV2 extends OperateSignalProviderRegistrationV2 { kind: 'operate-verification-provider-registration'; schemaVersion: '1.0.0'; protocolVersion: '2.0.0'; }
840
1514
 
841
1515
  export type OperateErrorCodeV2 =
842
1516
  | 'ARTIFACT_NOT_FOUND'
@@ -1022,30 +1696,54 @@ export interface OperatingSubmissionAcceptanceV2 {
1022
1696
  }
1023
1697
 
1024
1698
  export interface OperatingReviewDecisionSummaryBaseV2 {
1025
- decisionId: string; title: string; question: string; outcome: string | null; rationale: string;
1026
- confidence: number; ownerActorId: string; expectedUpside: string; expectedDownside: string;
1027
- revisitConditions: string[]; dissent: string[]; evidenceRefIds: string[];
1699
+ decisionId: string;
1700
+ title: string;
1701
+ question: string;
1702
+ outcome: string | null;
1703
+ rationale: string;
1704
+ confidence: number;
1705
+ ownerActorId: string;
1706
+ expectedUpside: string;
1707
+ expectedDownside: string;
1708
+ revisitConditions: string[];
1709
+ dissent: string[];
1710
+ evidenceRefIds: string[];
1028
1711
  }
1029
- export interface OperatingReviewPersistentWorkDecisionSummaryV2 extends OperatingReviewDecisionSummaryBaseV2 {
1712
+ export interface OperatingReviewPersistentWorkDecisionSummaryV2
1713
+ extends OperatingReviewDecisionSummaryBaseV2 {
1030
1714
  origin: 'persistent-work';
1031
1715
  }
1032
- export interface OperatingReviewIntelligenceDecisionSummaryV2 extends OperatingReviewDecisionSummaryBaseV2 {
1033
- origin: 'operating-intelligence'; uncertainty: string; reversibility: string; dissentIds: string[];
1716
+ export interface OperatingReviewIntelligenceDecisionSummaryV2
1717
+ extends OperatingReviewDecisionSummaryBaseV2 {
1718
+ origin: 'operating-intelligence';
1719
+ uncertainty: string;
1720
+ reversibility: string;
1721
+ dissentIds: string[];
1034
1722
  }
1035
1723
  export type OperatingReviewDecisionSummaryV2 =
1036
1724
  | OperatingReviewPersistentWorkDecisionSummaryV2
1037
1725
  | OperatingReviewIntelligenceDecisionSummaryV2;
1038
1726
 
1039
1727
  export interface OperatingReviewFindingSummaryBaseV2 {
1040
- findingId: string; title: string; statement: string; state: OperatingFindingStateV2;
1041
- ownerActorId: string | null; revisitAt: string | null;
1728
+ findingId: string;
1729
+ title: string;
1730
+ statement: string;
1731
+ state: OperatingFindingStateV2;
1732
+ ownerActorId: string | null;
1733
+ revisitAt: string | null;
1042
1734
  }
1043
- export interface OperatingReviewPersistentWorkFindingSummaryV2 extends OperatingReviewFindingSummaryBaseV2 {
1735
+ export interface OperatingReviewPersistentWorkFindingSummaryV2
1736
+ extends OperatingReviewFindingSummaryBaseV2 {
1044
1737
  origin: 'persistent-work';
1045
1738
  }
1046
- export interface OperatingReviewIntelligenceFindingSummaryV2 extends OperatingReviewFindingSummaryBaseV2 {
1047
- origin: 'operating-intelligence'; findingType: OperatingFindingTypeV2; severity: OperatingFindingSeverityV2;
1048
- confidence: number; supportingEvidenceRefIds: string[]; contradictingEvidenceRefIds: string[];
1739
+ export interface OperatingReviewIntelligenceFindingSummaryV2
1740
+ extends OperatingReviewFindingSummaryBaseV2 {
1741
+ origin: 'operating-intelligence';
1742
+ findingType: OperatingFindingTypeV2;
1743
+ severity: OperatingFindingSeverityV2;
1744
+ confidence: number;
1745
+ supportingEvidenceRefIds: string[];
1746
+ contradictingEvidenceRefIds: string[];
1049
1747
  }
1050
1748
  export type OperatingReviewFindingSummaryV2 =
1051
1749
  | OperatingReviewPersistentWorkFindingSummaryV2
@@ -1076,36 +1774,71 @@ export type OperatingReviewGapSummaryV2 =
1076
1774
  | OperatingReviewEvidenceGapSummaryV2;
1077
1775
 
1078
1776
  export interface OperatingReviewReadV2 {
1079
- kind: 'operating-review-read'; schemaVersion: '1.0.0'; protocolVersion: '2.0.0';
1080
- cycleId: string; eventHead: { sequence: number; hash: string | null };
1777
+ kind: 'operating-review-read';
1778
+ schemaVersion: '1.0.0';
1779
+ protocolVersion: '2.0.0';
1780
+ cycleId: string;
1781
+ eventHead: { sequence: number; hash: string | null };
1081
1782
  scope: { scopeId: string; domainId: string; domainVersion: string };
1082
1783
  reader: OperatePublicActorV2 & { kind: 'human' };
1083
1784
  review: OperatingReviewV2;
1084
- seatStatus: Array<{ roleId: string; roleKind: 'advisor' | 'challenger' | 'chair'; roleVersion: string; state: 'pending' | 'available' | 'running' | 'validated' | 'rejected' | 'abandoned' | 'failed'; artifactId: string | null; absenceIds: string[] }>;
1785
+ seatStatus: Array<{
1786
+ roleId: string;
1787
+ roleKind: 'advisor' | 'challenger' | 'chair';
1788
+ roleVersion: string;
1789
+ state: 'pending' | 'available' | 'running' | 'validated' | 'rejected' | 'abandoned' | 'failed';
1790
+ artifactId: string | null;
1791
+ absenceIds: string[];
1792
+ }>;
1085
1793
  decisions: OperatingReviewDecisionSummaryV2[];
1086
- actions: Array<{ actionId: string; title: string; state: OperatingActionStateV2; ownerActorId: string | null; sourceDecisionId: string | null; expectedResult: string; metricId: string | null; baseline: number | null; target: number | null; verificationWindow: string; verificationMethod: string }>;
1794
+ actions: Array<{
1795
+ actionId: string;
1796
+ title: string;
1797
+ state: OperatingActionStateV2;
1798
+ ownerActorId: string | null;
1799
+ sourceDecisionId: string | null;
1800
+ expectedResult: string;
1801
+ metricId: string | null;
1802
+ baseline: number | null;
1803
+ target: number | null;
1804
+ verificationWindow: string;
1805
+ verificationMethod: string;
1806
+ }>;
1087
1807
  findings: OperatingReviewFindingSummaryV2[];
1088
- dissent: Array<{ sourceArtifactId: string; localDissentId: string; statement: string; resolutionCondition: string }>;
1808
+ dissent: Array<{
1809
+ sourceArtifactId: string;
1810
+ localDissentId: string;
1811
+ statement: string;
1812
+ resolutionCondition: string;
1813
+ }>;
1089
1814
  gaps: OperatingReviewGapSummaryV2[];
1090
1815
  dispositionChoices: Array<{
1091
- choiceId: string; choiceHash: string; label: string;
1816
+ choiceId: string;
1817
+ choiceHash: string;
1818
+ label: string;
1092
1819
  submitArguments: OperateToolRequestMapV2['operate.review.submit'];
1093
1820
  }>;
1094
1821
  readAt: string;
1095
1822
  }
1096
1823
 
1097
1824
  export interface OperateReviewBoundSubmissionV1 {
1098
- kind: 'operate-review-bound-submission'; schemaVersion: '1.0.0'; protocolVersion: '2.0.0';
1825
+ kind: 'operate-review-bound-submission';
1826
+ schemaVersion: '1.0.0';
1827
+ protocolVersion: '2.0.0';
1099
1828
  expectedReadEventHead: { sequence: number; hash: string | null };
1100
- choiceId: string; choiceHash: string;
1829
+ choiceId: string;
1830
+ choiceHash: string;
1101
1831
  submitArguments: OperateToolRequestMapV2['operate.review.submit'];
1102
1832
  note: string | null;
1103
1833
  boundSubmissionHash: string;
1104
1834
  }
1105
1835
 
1106
1836
  export interface OperatingReviewReceiptV2 {
1107
- kind: 'operating-review-receipt'; schemaVersion: '1.0.0'; protocolVersion: '2.0.0';
1108
- receiptId: string; cycleId: string;
1837
+ kind: 'operating-review-receipt';
1838
+ schemaVersion: '1.0.0';
1839
+ protocolVersion: '2.0.0';
1840
+ receiptId: string;
1841
+ cycleId: string;
1109
1842
  readEventHead: { sequence: number; hash: string | null };
1110
1843
  eventHead: { sequence: number; hash: string | null };
1111
1844
  scope: { scopeId: string; domainId: string; domainVersion: string };
@@ -1119,10 +1852,18 @@ export interface OperatingReviewReceiptV2 {
1119
1852
  dissent: OperatingReviewReadV2['dissent'];
1120
1853
  gaps: OperatingReviewReadV2['gaps'];
1121
1854
  dispositionChoices: OperatingReviewReadV2['dispositionChoices'];
1122
- appliedChoiceId: string; appliedChoiceHash: string;
1855
+ appliedChoiceId: string;
1856
+ appliedChoiceHash: string;
1123
1857
  appliedWorkDispositions: OperatingWorkDispositionV2[];
1124
1858
  boundSubmission?: OperateReviewBoundSubmissionV1;
1125
- summary: { decisionCount: number; actionCount: number; findingCount: number; dissentCount: number; gapCount: number; message: string };
1859
+ summary: {
1860
+ decisionCount: number;
1861
+ actionCount: number;
1862
+ findingCount: number;
1863
+ dissentCount: number;
1864
+ gapCount: number;
1865
+ message: string;
1866
+ };
1126
1867
  committedAt: string;
1127
1868
  }
1128
1869
 
@@ -1277,7 +2018,12 @@ export interface OperatingEventPayloadMapV2 {
1277
2018
  releaseId: string;
1278
2019
  dependencyProofs: Array<
1279
2020
  | { assignmentId: string; outcome: 'validated'; eventId: string; artifactId: string }
1280
- | { assignmentId: string; outcome: 'abandoned' | 'failed'; eventId: string; absence: { code: string; reason: string; recoveryDisposition: string } }
2021
+ | {
2022
+ assignmentId: string;
2023
+ outcome: 'abandoned' | 'failed';
2024
+ eventId: string;
2025
+ absence: { code: string; reason: string; recoveryDisposition: string };
2026
+ }
1281
2027
  >;
1282
2028
  dependencyEventIds: string[];
1283
2029
  };
@@ -1362,7 +2108,12 @@ export interface OperatingEventPayloadMapV2 {
1362
2108
  action: OperatingActionV2;
1363
2109
  };
1364
2110
  'evidence.resolved': {
1365
- resolution: OperatingEvidenceResolutionV2 & { outcome: 'resolved'; evidenceRefId: string; evidenceArtifactId: string; error: null };
2111
+ resolution: OperatingEvidenceResolutionV2 & {
2112
+ outcome: 'resolved';
2113
+ evidenceRefId: string;
2114
+ evidenceArtifactId: string;
2115
+ error: null;
2116
+ };
1366
2117
  evidenceRef: OperatingEvidenceRefV2;
1367
2118
  evidenceArtifact: OperatingArtifactV2;
1368
2119
  edges: OperatingEvidenceEdgeV2[];
@@ -1370,7 +2121,12 @@ export interface OperatingEventPayloadMapV2 {
1370
2121
  outcomeHash: string;
1371
2122
  };
1372
2123
  'evidence.rejected': {
1373
- resolution: OperatingEvidenceResolutionV2 & { outcome: 'rejected'; evidenceRefId: null; evidenceArtifactId: null; error: NonNullable<OperatingEvidenceResolutionV2['error']> };
2124
+ resolution: OperatingEvidenceResolutionV2 & {
2125
+ outcome: 'rejected';
2126
+ evidenceRefId: null;
2127
+ evidenceArtifactId: null;
2128
+ error: NonNullable<OperatingEvidenceResolutionV2['error']>;
2129
+ };
1374
2130
  requestHash: string;
1375
2131
  outcomeHash: string;
1376
2132
  };
@@ -1406,14 +2162,24 @@ export interface OperatingEventPayloadMapV2 {
1406
2162
  resultId: string;
1407
2163
  resultArtifactId: string;
1408
2164
  submissionId: string;
1409
- eventIds: { submitted: string; artifactCreated: string; validated: string; resultRecorded: string };
2165
+ eventIds: {
2166
+ submitted: string;
2167
+ artifactCreated: string;
2168
+ validated: string;
2169
+ resultRecorded: string;
2170
+ };
1410
2171
  completedAt: string;
1411
2172
  correlationId: string;
1412
2173
  uncertainty: {
1413
2174
  resultId: string;
1414
2175
  resultArtifactId: string;
1415
2176
  submissionId: string;
1416
- eventIds: { submitted: string; artifactCreated: string; validated: string; resultRecorded: string };
2177
+ eventIds: {
2178
+ submitted: string;
2179
+ artifactCreated: string;
2180
+ validated: string;
2181
+ resultRecorded: string;
2182
+ };
1417
2183
  };
1418
2184
  };
1419
2185
  };
@@ -1438,44 +2204,126 @@ export interface OperatingEventPayloadMapV2 {
1438
2204
  'cycle.closed': OperatingCycleClosedPayloadV2;
1439
2205
  }
1440
2206
 
1441
- export interface OperatingActionTransitionPayloadV2<TFrom extends OperatingActionStateV2, TTo extends OperatingActionStateV2> {
1442
- action: OperateActionIdentityV2; from: TFrom; to: TTo; operationId: string | null; resultId: string | null; reasonCode: string | null;
1443
- }
1444
- export interface OperatingCycleTransitionPayloadV2<TFrom extends OperatingCycleV2['state'], TTo extends OperatingCycleV2['state']> {
1445
- cycleId: string; from: TFrom; to: TTo; actionId: string | null; operationId: string | null; resultId: string | null; reasonCode: string | null;
1446
- }
1447
- export type OperatingActionApprovedPayloadV2 =
1448
- OperatingActionTransitionPayloadV2<'proposed', 'approved'> & { operationId: null; resultId: null; reasonCode: null };
2207
+ export interface OperatingActionTransitionPayloadV2<
2208
+ TFrom extends OperatingActionStateV2,
2209
+ TTo extends OperatingActionStateV2,
2210
+ > {
2211
+ action: OperateActionIdentityV2;
2212
+ from: TFrom;
2213
+ to: TTo;
2214
+ operationId: string | null;
2215
+ resultId: string | null;
2216
+ reasonCode: string | null;
2217
+ }
2218
+ export interface OperatingCycleTransitionPayloadV2<
2219
+ TFrom extends OperatingCycleV2['state'],
2220
+ TTo extends OperatingCycleV2['state'],
2221
+ > {
2222
+ cycleId: string;
2223
+ from: TFrom;
2224
+ to: TTo;
2225
+ actionId: string | null;
2226
+ operationId: string | null;
2227
+ resultId: string | null;
2228
+ reasonCode: string | null;
2229
+ }
2230
+ export type OperatingActionApprovedPayloadV2 = OperatingActionTransitionPayloadV2<
2231
+ 'proposed',
2232
+ 'approved'
2233
+ > & { operationId: null; resultId: null; reasonCode: null };
1449
2234
  export type OperatingActionCancelledPayloadV2 =
1450
- | (OperatingActionTransitionPayloadV2<'approved', 'cancelled'> & { operationId: null; resultId: null; reasonCode: string })
1451
- | (OperatingActionTransitionPayloadV2<'queued' | 'in_progress', 'cancelled'> & { operationId: string; resultId: null; reasonCode: string });
1452
- export type OperatingActionRejectedPayloadV2 =
1453
- OperatingActionTransitionPayloadV2<'proposed', 'rejected'> & { operationId: null; resultId: null; reasonCode: string };
1454
- export type OperatingActionDeferredPayloadV2 =
1455
- OperatingActionTransitionPayloadV2<'proposed', 'deferred'> & { operationId: null; resultId: null; reasonCode: string };
1456
- export type OperatingActionReopenedPayloadV2 =
1457
- OperatingActionTransitionPayloadV2<'deferred', 'proposed'> & { operationId: null; resultId: null; reasonCode: null };
2235
+ | (OperatingActionTransitionPayloadV2<'approved', 'cancelled'> & {
2236
+ operationId: null;
2237
+ resultId: null;
2238
+ reasonCode: string;
2239
+ })
2240
+ | (OperatingActionTransitionPayloadV2<'queued' | 'in_progress', 'cancelled'> & {
2241
+ operationId: string;
2242
+ resultId: null;
2243
+ reasonCode: string;
2244
+ });
2245
+ export type OperatingActionRejectedPayloadV2 = OperatingActionTransitionPayloadV2<
2246
+ 'proposed',
2247
+ 'rejected'
2248
+ > & { operationId: null; resultId: null; reasonCode: string };
2249
+ export type OperatingActionDeferredPayloadV2 = OperatingActionTransitionPayloadV2<
2250
+ 'proposed',
2251
+ 'deferred'
2252
+ > & { operationId: null; resultId: null; reasonCode: string };
2253
+ export type OperatingActionReopenedPayloadV2 = OperatingActionTransitionPayloadV2<
2254
+ 'deferred',
2255
+ 'proposed'
2256
+ > & { operationId: null; resultId: null; reasonCode: null };
1458
2257
  export type OperatingActionQueuedPayloadV2 =
1459
- | (OperatingActionTransitionPayloadV2<'approved', 'queued'> & { operationId: string; resultId: null; reasonCode: null })
1460
- | (OperatingActionTransitionPayloadV2<'blocked', 'queued'> & { operationId: string; resultId: string; reasonCode: string });
2258
+ | (OperatingActionTransitionPayloadV2<'approved', 'queued'> & {
2259
+ operationId: string;
2260
+ resultId: null;
2261
+ reasonCode: null;
2262
+ })
2263
+ | (OperatingActionTransitionPayloadV2<'blocked', 'queued'> & {
2264
+ operationId: string;
2265
+ resultId: string;
2266
+ reasonCode: string;
2267
+ });
1461
2268
  export type OperatingActionStartedPayloadV2 =
1462
- | (OperatingActionTransitionPayloadV2<'queued', 'in_progress'> & { operationId: string; resultId: null; reasonCode: null })
1463
- | (OperatingActionTransitionPayloadV2<'blocked', 'in_progress'> & { operationId: string; resultId: string; reasonCode: string });
1464
- export type OperatingActionCompletedPayloadV2 =
1465
- OperatingActionTransitionPayloadV2<'in_progress', 'completed'> & { operationId: string; resultId: string; reasonCode: null };
1466
- export type OperatingActionBlockedPayloadV2 =
1467
- OperatingActionTransitionPayloadV2<'queued' | 'in_progress', 'blocked'> & { operationId: string; resultId: string; reasonCode: string };
1468
- export type OperatingCycleApprovedPayloadV2 =
1469
- OperatingCycleTransitionPayloadV2<'awaiting_review', 'approved'> & { actionId: null; operationId: null; resultId: null; reasonCode: null };
1470
- export type OperatingCycleExecutingPayloadV2 =
1471
- OperatingCycleTransitionPayloadV2<'approved', 'executing'> & { actionId: string; operationId: string; resultId: null; reasonCode: null };
2269
+ | (OperatingActionTransitionPayloadV2<'queued', 'in_progress'> & {
2270
+ operationId: string;
2271
+ resultId: null;
2272
+ reasonCode: null;
2273
+ })
2274
+ | (OperatingActionTransitionPayloadV2<'blocked', 'in_progress'> & {
2275
+ operationId: string;
2276
+ resultId: string;
2277
+ reasonCode: string;
2278
+ });
2279
+ export type OperatingActionCompletedPayloadV2 = OperatingActionTransitionPayloadV2<
2280
+ 'in_progress',
2281
+ 'completed'
2282
+ > & { operationId: string; resultId: string; reasonCode: null };
2283
+ export type OperatingActionBlockedPayloadV2 = OperatingActionTransitionPayloadV2<
2284
+ 'queued' | 'in_progress',
2285
+ 'blocked'
2286
+ > & { operationId: string; resultId: string; reasonCode: string };
2287
+ export type OperatingCycleApprovedPayloadV2 = OperatingCycleTransitionPayloadV2<
2288
+ 'awaiting_review',
2289
+ 'approved'
2290
+ > & { actionId: null; operationId: null; resultId: null; reasonCode: null };
2291
+ export type OperatingCycleExecutingPayloadV2 = OperatingCycleTransitionPayloadV2<
2292
+ 'approved',
2293
+ 'executing'
2294
+ > & { actionId: string; operationId: string; resultId: null; reasonCode: null };
1472
2295
  export type OperatingCycleVerifyingPayloadV2 =
1473
- | (OperatingCycleTransitionPayloadV2<'executing', 'verifying'> & { actionId: string; operationId: string; resultId: string; reasonCode: null })
1474
- | (OperatingCycleTransitionPayloadV2<'approved', 'verifying'> & { actionId: string; operationId: null; resultId: null; reasonCode: string });
2296
+ | (OperatingCycleTransitionPayloadV2<'executing', 'verifying'> & {
2297
+ actionId: string;
2298
+ operationId: string;
2299
+ resultId: string;
2300
+ reasonCode: null;
2301
+ })
2302
+ | (OperatingCycleTransitionPayloadV2<'approved', 'verifying'> & {
2303
+ actionId: string;
2304
+ operationId: null;
2305
+ resultId: null;
2306
+ reasonCode: string;
2307
+ });
1475
2308
  export type OperatingCycleClosedPayloadV2 =
1476
- | (OperatingCycleTransitionPayloadV2<'verifying', 'closed'> & { actionId: string; operationId: string; resultId: string; reasonCode: string | null })
1477
- | (OperatingCycleTransitionPayloadV2<'verifying', 'closed'> & { actionId: string; operationId: null; resultId: null; reasonCode: string })
1478
- | (OperatingCycleTransitionPayloadV2<'approved', 'closed'> & { actionId: null; operationId: null; resultId: null; reasonCode: string });
2309
+ | (OperatingCycleTransitionPayloadV2<'verifying', 'closed'> & {
2310
+ actionId: string;
2311
+ operationId: string;
2312
+ resultId: string;
2313
+ reasonCode: string | null;
2314
+ })
2315
+ | (OperatingCycleTransitionPayloadV2<'verifying', 'closed'> & {
2316
+ actionId: string;
2317
+ operationId: null;
2318
+ resultId: null;
2319
+ reasonCode: string;
2320
+ })
2321
+ | (OperatingCycleTransitionPayloadV2<'approved', 'closed'> & {
2322
+ actionId: null;
2323
+ operationId: null;
2324
+ resultId: null;
2325
+ reasonCode: string;
2326
+ });
1479
2327
 
1480
2328
  export interface OperatingEventBaseV2 {
1481
2329
  kind: 'operating-event';
@@ -1534,10 +2382,11 @@ interface OperatingEventReplayEntryBaseV2 {
1534
2382
  requestHash?: string;
1535
2383
  }
1536
2384
 
1537
- export type OperatingEventReplayEntryV2 = OperatingEventReplayEntryBaseV2 & (
1538
- | { type: 'review.submitted'; receiptProjection: OperatingReviewReceiptReplayProjectionV2 }
1539
- | { type: Exclude<OperatingEventTypeV2, 'review.submitted'>; receiptProjection?: never }
1540
- );
2385
+ export type OperatingEventReplayEntryV2 = OperatingEventReplayEntryBaseV2 &
2386
+ (
2387
+ | { type: 'review.submitted'; receiptProjection: OperatingReviewReceiptReplayProjectionV2 }
2388
+ | { type: Exclude<OperatingEventTypeV2, 'review.submitted'>; receiptProjection?: never }
2389
+ );
1541
2390
 
1542
2391
  export interface OperatingExecutionReceiptProofV2 {
1543
2392
  operationId: string;
@@ -1560,9 +2409,15 @@ export interface OperatingWorkChangeSetReplayEntryV2 {
1560
2409
  }
1561
2410
 
1562
2411
  export interface OperatingEvidenceResolutionReplayEntryV2 {
1563
- resolutionId: string; candidateId: string; sourceArtifactId: string; outcome: 'resolved' | 'rejected';
1564
- evidenceRefId: string | null; evidenceArtifactId: string | null; eventId: string;
1565
- requestHash: string; outcomeHash: string;
2412
+ resolutionId: string;
2413
+ candidateId: string;
2414
+ sourceArtifactId: string;
2415
+ outcome: 'resolved' | 'rejected';
2416
+ evidenceRefId: string | null;
2417
+ evidenceArtifactId: string | null;
2418
+ eventId: string;
2419
+ requestHash: string;
2420
+ outcomeHash: string;
1566
2421
  }
1567
2422
 
1568
2423
  export interface OperatingOperationReplayEntryV2 {
@@ -1582,11 +2437,21 @@ export interface OperatingOperationReplayEntryV2 {
1582
2437
  reservedResultId: string;
1583
2438
  reservedResultArtifactId: string;
1584
2439
  reservedSubmissionId: string;
1585
- reservedTerminalEventIds: { submitted: string; artifactCreated: string; validated: string; resultRecorded: string };
2440
+ reservedTerminalEventIds: {
2441
+ submitted: string;
2442
+ artifactCreated: string;
2443
+ validated: string;
2444
+ resultRecorded: string;
2445
+ };
1586
2446
  reservedUncertaintyResultId: string;
1587
2447
  reservedUncertaintyResultArtifactId: string;
1588
2448
  reservedUncertaintySubmissionId: string;
1589
- reservedUncertaintyTerminalEventIds: { submitted: string; artifactCreated: string; validated: string; resultRecorded: string };
2449
+ reservedUncertaintyTerminalEventIds: {
2450
+ submitted: string;
2451
+ artifactCreated: string;
2452
+ validated: string;
2453
+ resultRecorded: string;
2454
+ };
1590
2455
  reservedCompletedAt: string;
1591
2456
  reservedCorrelationId: string;
1592
2457
  terminalResultId: string | null;
@@ -1637,10 +2502,17 @@ export interface OperatingRuntimeStateV2Base {
1637
2502
 
1638
2503
  export type OperatingAuthorityHistoryV2 =
1639
2504
  | {
1640
- actionPolicies?: never; policyEvaluations?: never; approvalRequirements?: never;
1641
- approvalRecords?: never; capabilityAvailability?: never; capabilityGrants?: never;
1642
- governedOperations?: never; executionResults?: never; rollbackPlans?: never;
1643
- rollbackResults?: never; operationReplayIndex?: never;
2505
+ actionPolicies?: never;
2506
+ policyEvaluations?: never;
2507
+ approvalRequirements?: never;
2508
+ approvalRecords?: never;
2509
+ capabilityAvailability?: never;
2510
+ capabilityGrants?: never;
2511
+ governedOperations?: never;
2512
+ executionResults?: never;
2513
+ rollbackPlans?: never;
2514
+ rollbackResults?: never;
2515
+ operationReplayIndex?: never;
1644
2516
  }
1645
2517
  | {
1646
2518
  actionPolicies: OperatingActionPolicyV2[];
@@ -1672,10 +2544,11 @@ export interface OperatingCheckpointV2Base {
1672
2544
  export type OperatingCheckpointAuthorityHashesV2 =
1673
2545
  | { operationReplayIndexHash?: never; authorityHistoryHash?: never }
1674
2546
  | { operationReplayIndexHash: string; authorityHistoryHash: string };
1675
- export type OperatingCheckpointV2 = OperatingCheckpointV2Base & OperatingCheckpointAuthorityHashesV2;
2547
+ export type OperatingCheckpointV2 = OperatingCheckpointV2Base &
2548
+ OperatingCheckpointAuthorityHashesV2;
1676
2549
 
1677
2550
  export interface OperateRoleOutputContractV2 {
1678
- schemaId: typeof OPERATE_RUNTIME_CONTRACT_KINDS[number];
2551
+ schemaId: (typeof OPERATE_RUNTIME_CONTRACT_KINDS)[number];
1679
2552
  schemaVersion: '2.0.0';
1680
2553
  mediaType: string;
1681
2554
  maxBytes: number;
@@ -1707,7 +2580,16 @@ export interface OperateDomainRegistrationV2 {
1707
2580
  domainVersion: string;
1708
2581
  domainContract?: OperateDomainContractBindingV2;
1709
2582
  provenance: { packageName: string; packageVersion: string; integrity: string };
1710
- roles: Array<{ roleId: string; roleKind: OperatePhase1AssignmentKindV2; label: string; roleVersion: '2.0.0'; output: OperateRoleOutputContractV2; analysisRubric: OperateAnalysisRubricV2; dependencyPolicy: { id: 'none' | 'all-required' | 'threshold'; version: '1.0.0' }; requirements: string[] }>;
2583
+ roles: Array<{
2584
+ roleId: string;
2585
+ roleKind: OperatePhase1AssignmentKindV2;
2586
+ label: string;
2587
+ roleVersion: '2.0.0';
2588
+ output: OperateRoleOutputContractV2;
2589
+ analysisRubric: OperateAnalysisRubricV2;
2590
+ dependencyPolicy: { id: 'none' | 'all-required' | 'threshold'; version: '1.0.0' };
2591
+ requirements: string[];
2592
+ }>;
1711
2593
  vocabulary: Array<{ term: string; definition: string }>;
1712
2594
  projectionContracts: Array<{ schemaId: string; schemaVersion: string }>;
1713
2595
  actionKinds: Array<{ id: string; version: string }>;
@@ -1728,74 +2610,190 @@ export interface AgentRuntimeManifestV2 {
1728
2610
  runtimeVersion: string;
1729
2611
  }
1730
2612
 
1731
- export type OperatingFindingStateV2 = 'open' | 'accepted' | 'resolved' | 'rejected' | 'deferred' | 'superseded';
1732
- export type OperatingDecisionStateV2 = 'proposed' | 'approved' | 'rejected' | 'deferred' | 'superseded';
1733
- export type OperatingActionStateV2 = 'proposed' | 'approved' | 'queued' | 'in_progress' | 'completed' | 'blocked' | 'rejected' | 'deferred' | 'cancelled';
1734
- export type OperatingFindingTypeV2 = 'unsupported' | 'contradicted' | 'correlated-reasoning' | 'missing-alternative' | 'unpriced-downside' | 'irreversibility-mismatch' | 'overconfidence' | 'scope-violation';
2613
+ export type OperatingFindingStateV2 =
2614
+ | 'open'
2615
+ | 'accepted'
2616
+ | 'resolved'
2617
+ | 'rejected'
2618
+ | 'deferred'
2619
+ | 'superseded';
2620
+ export type OperatingDecisionStateV2 =
2621
+ | 'proposed'
2622
+ | 'approved'
2623
+ | 'rejected'
2624
+ | 'deferred'
2625
+ | 'superseded';
2626
+ export type OperatingActionStateV2 =
2627
+ | 'proposed'
2628
+ | 'approved'
2629
+ | 'queued'
2630
+ | 'in_progress'
2631
+ | 'completed'
2632
+ | 'blocked'
2633
+ | 'rejected'
2634
+ | 'deferred'
2635
+ | 'cancelled';
2636
+ export type OperatingFindingTypeV2 =
2637
+ | 'unsupported'
2638
+ | 'contradicted'
2639
+ | 'correlated-reasoning'
2640
+ | 'missing-alternative'
2641
+ | 'unpriced-downside'
2642
+ | 'irreversibility-mismatch'
2643
+ | 'overconfidence'
2644
+ | 'scope-violation';
1735
2645
  export type OperatingFindingSeverityV2 = 'low' | 'medium' | 'high' | 'critical';
1736
2646
 
1737
2647
  export interface OperatingFindingBaseV2 {
1738
- kind: 'operating-finding'; schemaVersion: '1.0.0'; protocolVersion: '2.0.0';
1739
- findingId: string; scopeId: string; domainId: string; domainVersion: string;
1740
- sourceCycleId: string; sourceArtifactId: string; title: string; statement: string;
1741
- state: OperatingFindingStateV2; ownerActorId: string | null; revisitAt: string | null;
1742
- createdAt: string; updatedAt: string;
2648
+ kind: 'operating-finding';
2649
+ schemaVersion: '1.0.0';
2650
+ protocolVersion: '2.0.0';
2651
+ findingId: string;
2652
+ scopeId: string;
2653
+ domainId: string;
2654
+ domainVersion: string;
2655
+ sourceCycleId: string;
2656
+ sourceArtifactId: string;
2657
+ title: string;
2658
+ statement: string;
2659
+ state: OperatingFindingStateV2;
2660
+ ownerActorId: string | null;
2661
+ revisitAt: string | null;
2662
+ createdAt: string;
2663
+ updatedAt: string;
1743
2664
  }
1744
2665
  export interface OperatingPersistentWorkFindingV2 extends OperatingFindingBaseV2 {
1745
2666
  origin: 'persistent-work';
1746
2667
  }
1747
2668
  export interface OperatingIntelligenceFindingV2 extends OperatingFindingBaseV2 {
1748
- origin: 'operating-intelligence'; sourceAssignmentId: string; sourceLocalFindingId: string;
1749
- findingType: OperatingFindingTypeV2; severity: OperatingFindingSeverityV2; confidence: number;
1750
- targets: Array<{ advisorArtifactId: string; analysisIds: string[]; claimIds: string[]; measurementIds: string[]; riskIds: string[]; recommendationIds: string[] }>;
1751
- supportingEvidenceRefIds: string[]; contradictingEvidenceRefIds: string[];
1752
- rationale: string; correctionCondition: string;
2669
+ origin: 'operating-intelligence';
2670
+ sourceAssignmentId: string;
2671
+ sourceLocalFindingId: string;
2672
+ findingType: OperatingFindingTypeV2;
2673
+ severity: OperatingFindingSeverityV2;
2674
+ confidence: number;
2675
+ targets: Array<{
2676
+ advisorArtifactId: string;
2677
+ analysisIds: string[];
2678
+ claimIds: string[];
2679
+ measurementIds: string[];
2680
+ riskIds: string[];
2681
+ recommendationIds: string[];
2682
+ }>;
2683
+ supportingEvidenceRefIds: string[];
2684
+ contradictingEvidenceRefIds: string[];
2685
+ rationale: string;
2686
+ correctionCondition: string;
1753
2687
  }
1754
2688
  export type OperatingFindingV2 = OperatingPersistentWorkFindingV2 | OperatingIntelligenceFindingV2;
1755
2689
 
1756
2690
  export interface OperatingDecisionBaseV2 {
1757
- kind: 'operating-decision'; schemaVersion: '1.0.0'; protocolVersion: '2.0.0';
1758
- decisionId: string; scopeId: string; domainId: string; domainVersion: string;
1759
- sourceCycleId: string; sourceArtifactId: string; title: string; question: string;
1760
- outcome: string | null; rationale: string; state: OperatingDecisionStateV2;
1761
- ownerActorId: string; revisitAt: string | null; revision: number;
1762
- predecessorDecisionId: string | null; historyDecisionIds: string[]; createdAt: string; updatedAt: string;
1763
- evidenceRefIds: string[]; alternatives: string[]; confidence: number; assumptionIds: string[];
1764
- expectedUpside: string; expectedDownside: string;
1765
- dissent: string[]; reopenConditions: string[]; revisitConditions: string[];
2691
+ kind: 'operating-decision';
2692
+ schemaVersion: '1.0.0';
2693
+ protocolVersion: '2.0.0';
2694
+ decisionId: string;
2695
+ scopeId: string;
2696
+ domainId: string;
2697
+ domainVersion: string;
2698
+ sourceCycleId: string;
2699
+ sourceArtifactId: string;
2700
+ title: string;
2701
+ question: string;
2702
+ outcome: string | null;
2703
+ rationale: string;
2704
+ state: OperatingDecisionStateV2;
2705
+ ownerActorId: string;
2706
+ revisitAt: string | null;
2707
+ revision: number;
2708
+ predecessorDecisionId: string | null;
2709
+ historyDecisionIds: string[];
2710
+ createdAt: string;
2711
+ updatedAt: string;
2712
+ evidenceRefIds: string[];
2713
+ alternatives: string[];
2714
+ confidence: number;
2715
+ assumptionIds: string[];
2716
+ expectedUpside: string;
2717
+ expectedDownside: string;
2718
+ dissent: string[];
2719
+ reopenConditions: string[];
2720
+ revisitConditions: string[];
1766
2721
  }
1767
2722
  export interface OperatingPersistentWorkDecisionV2 extends OperatingDecisionBaseV2 {
1768
2723
  origin: 'persistent-work';
1769
2724
  }
1770
2725
  export interface OperatingIntelligenceDecisionV2 extends OperatingDecisionBaseV2 {
1771
- origin: 'operating-intelligence'; sourceAssignmentId: string; sourceLocalDecisionId: string;
1772
- sourceClaimRefs: Array<{ advisorArtifactId: string; localClaimId: string }>; claimIds: string[];
2726
+ origin: 'operating-intelligence';
2727
+ sourceAssignmentId: string;
2728
+ sourceLocalDecisionId: string;
2729
+ sourceClaimRefs: Array<{ advisorArtifactId: string; localClaimId: string }>;
2730
+ claimIds: string[];
1773
2731
  sourceRecommendationRefs: Array<{ advisorArtifactId: string; localRecommendationId: string }>;
1774
- challengerFindingIds: string[]; findingIds: string[];
1775
- alternativeDispositions: Array<{ sourceArtifactId: string; localAlternativeId: string; title: string; disposition: 'accepted' | 'rejected' | 'deferred'; rationale: string }>;
1776
- uncertainty: string; reversibility: string; dissentIds: string[];
2732
+ challengerFindingIds: string[];
2733
+ findingIds: string[];
2734
+ alternativeDispositions: Array<{
2735
+ sourceArtifactId: string;
2736
+ localAlternativeId: string;
2737
+ title: string;
2738
+ disposition: 'accepted' | 'rejected' | 'deferred';
2739
+ rationale: string;
2740
+ }>;
2741
+ uncertainty: string;
2742
+ reversibility: string;
2743
+ dissentIds: string[];
1777
2744
  }
1778
- export type OperatingDecisionV2 = OperatingPersistentWorkDecisionV2 | OperatingIntelligenceDecisionV2;
2745
+ export type OperatingDecisionV2 =
2746
+ | OperatingPersistentWorkDecisionV2
2747
+ | OperatingIntelligenceDecisionV2;
1779
2748
  export interface OperatingActionV2Base {
1780
- kind: 'operating-action'; schemaVersion: '1.0.0'; protocolVersion: '2.0.0';
1781
- actionId: string; scopeId: string; domainId: string; domainVersion: string;
1782
- sourceCycleId: string; sourceArtifactId: string; title: string; state: OperatingActionStateV2;
1783
- ownerActorId: string | null; accountabilityDisposition: 'unowned' | 'blocked' | null;
1784
- sourceDecisionId: string | null; sourceFindingIds: string[]; dependsOnActionIds: string[];
1785
- objectiveId: string; expectedResult: string; metricId: string;
1786
- baseline: number; target: number; verificationWindow: string; verificationPlanId: string;
1787
- createdAt: string; updatedAt: string;
2749
+ kind: 'operating-action';
2750
+ schemaVersion: '1.0.0';
2751
+ protocolVersion: '2.0.0';
2752
+ actionId: string;
2753
+ scopeId: string;
2754
+ domainId: string;
2755
+ domainVersion: string;
2756
+ sourceCycleId: string;
2757
+ sourceArtifactId: string;
2758
+ title: string;
2759
+ state: OperatingActionStateV2;
2760
+ ownerActorId: string | null;
2761
+ accountabilityDisposition: 'unowned' | 'blocked' | null;
2762
+ sourceDecisionId: string | null;
2763
+ sourceFindingIds: string[];
2764
+ dependsOnActionIds: string[];
2765
+ objectiveId: string;
2766
+ expectedResult: string;
2767
+ metricId: string;
2768
+ baseline: number;
2769
+ target: number;
2770
+ verificationWindow: string;
2771
+ verificationPlanId: string;
2772
+ createdAt: string;
2773
+ updatedAt: string;
1788
2774
  }
1789
2775
  export type OperatingActionAuthorityTupleV2 =
1790
2776
  | {
1791
- revisionId?: never; revision?: never; predecessorRevisionId?: never; actionHash?: never;
1792
- actionKind?: never; requestedCapability?: never; targetBinding?: never; effectClass?: never;
1793
- preconditionArtifactIds?: never; executionBinding?: never;
2777
+ revisionId?: never;
2778
+ revision?: never;
2779
+ predecessorRevisionId?: never;
2780
+ actionHash?: never;
2781
+ actionKind?: never;
2782
+ requestedCapability?: never;
2783
+ targetBinding?: never;
2784
+ effectClass?: never;
2785
+ preconditionArtifactIds?: never;
2786
+ executionBinding?: never;
1794
2787
  }
1795
2788
  | {
1796
- revisionId: string; revision: number; predecessorRevisionId: string | null; actionHash: string;
1797
- actionKind: OperateVersionedIdentityV2; requestedCapability: OperateVersionedIdentityV2;
1798
- targetBinding: OperateTargetBindingV2; effectClass: OperateGovernedEffectClassV2;
2789
+ revisionId: string;
2790
+ revision: number;
2791
+ predecessorRevisionId: string | null;
2792
+ actionHash: string;
2793
+ actionKind: OperateVersionedIdentityV2;
2794
+ requestedCapability: OperateVersionedIdentityV2;
2795
+ targetBinding: OperateTargetBindingV2;
2796
+ effectClass: OperateGovernedEffectClassV2;
1799
2797
  preconditionArtifactIds: string[];
1800
2798
  executionBinding: {
1801
2799
  policyId: string;
@@ -1806,28 +2804,65 @@ export type OperatingActionAuthorityTupleV2 =
1806
2804
  };
1807
2805
  export type OperatingActionV2 = OperatingActionV2Base & OperatingActionAuthorityTupleV2;
1808
2806
  export interface OperatingFindingDraftV2 {
1809
- draftRef: string; title: string; statement: string; state: Extract<OperatingFindingStateV2, 'open' | 'deferred'>;
1810
- ownerActorId: string | null; revisitAt: string | null;
2807
+ draftRef: string;
2808
+ title: string;
2809
+ statement: string;
2810
+ state: Extract<OperatingFindingStateV2, 'open' | 'deferred'>;
2811
+ ownerActorId: string | null;
2812
+ revisitAt: string | null;
1811
2813
  }
1812
2814
  export interface OperatingDecisionDraftV2 {
1813
- draftRef: string; title: string; question: string; rationale: string; ownerActorId: string; revisitAt: string | null;
1814
- evidenceRefIds: string[]; alternatives: string[]; confidence: number; assumptionIds: string[];
1815
- expectedUpside: string; expectedDownside: string; dissent: string[]; reopenConditions: string[]; revisitConditions: string[];
2815
+ draftRef: string;
2816
+ title: string;
2817
+ question: string;
2818
+ rationale: string;
2819
+ ownerActorId: string;
2820
+ revisitAt: string | null;
2821
+ evidenceRefIds: string[];
2822
+ alternatives: string[];
2823
+ confidence: number;
2824
+ assumptionIds: string[];
2825
+ expectedUpside: string;
2826
+ expectedDownside: string;
2827
+ dissent: string[];
2828
+ reopenConditions: string[];
2829
+ revisitConditions: string[];
1816
2830
  }
1817
2831
  export interface OperatingActionDraftV2 {
1818
- draftRef: string; title: string; ownerActorId: string | null; accountabilityDisposition: 'unowned' | 'blocked' | null;
1819
- sourceDecisionDraftRef: string | null; sourceFindingDraftRefs: string[]; dependsOnActionDraftRefs: string[];
1820
- objectiveId: string; expectedResult: string; metricId: string;
1821
- baseline: number; target: number; verificationWindow: string; verificationPlanId: string;
2832
+ draftRef: string;
2833
+ title: string;
2834
+ ownerActorId: string | null;
2835
+ accountabilityDisposition: 'unowned' | 'blocked' | null;
2836
+ sourceDecisionDraftRef: string | null;
2837
+ sourceFindingDraftRefs: string[];
2838
+ dependsOnActionDraftRefs: string[];
2839
+ objectiveId: string;
2840
+ expectedResult: string;
2841
+ metricId: string;
2842
+ baseline: number;
2843
+ target: number;
2844
+ verificationWindow: string;
2845
+ verificationPlanId: string;
1822
2846
  }
1823
2847
  export interface OperatingWorkChangeSetV2 {
1824
- kind: 'operating-work-change-set'; schemaVersion: '1.0.0'; protocolVersion: '2.0.0';
1825
- cycleId: string; scopeId: string; domainId: string; domainVersion: string;
1826
- findings: OperatingFindingDraftV2[]; decisions: OperatingDecisionDraftV2[]; actions: OperatingActionDraftV2[];
2848
+ kind: 'operating-work-change-set';
2849
+ schemaVersion: '1.0.0';
2850
+ protocolVersion: '2.0.0';
2851
+ cycleId: string;
2852
+ scopeId: string;
2853
+ domainId: string;
2854
+ domainVersion: string;
2855
+ findings: OperatingFindingDraftV2[];
2856
+ decisions: OperatingDecisionDraftV2[];
2857
+ actions: OperatingActionDraftV2[];
1827
2858
  }
1828
2859
  export interface OperatingWorkChangeSetMaterializationV2 {
1829
- artifactId: string; canonicalHash: string; changeSet: OperatingWorkChangeSetV2;
1830
- findings: OperatingFindingV2[]; decisions: OperatingDecisionV2[]; actions: OperatingActionV2[];
2860
+ artifactId: string;
2861
+ canonicalHash: string;
2862
+ changeSet: OperatingWorkChangeSetV2;
2863
+ findings: OperatingFindingV2[];
2864
+ decisions: OperatingDecisionV2[];
2865
+ actions: OperatingActionV2[];
1831
2866
  }
1832
2867
  export interface OperatingWorkCycleLinkV2 {
1833
2868
  entityKind: 'finding' | 'decision' | 'action';
@@ -1836,97 +2871,416 @@ export interface OperatingWorkCycleLinkV2 {
1836
2871
  relation: 'source' | 'touched' | 'carried-forward';
1837
2872
  }
1838
2873
  export interface OperatingWorkLedgerV2 {
1839
- kind: 'operating-work-ledger'; schemaVersion: '1.0.0'; protocolVersion: '2.0.0';
1840
- scopeId: string; domainId: string; domainVersion: string; generatedAt: string;
1841
- findings: OperatingFindingV2[]; decisions: OperatingDecisionV2[]; actions: OperatingActionV2[];
2874
+ kind: 'operating-work-ledger';
2875
+ schemaVersion: '1.0.0';
2876
+ protocolVersion: '2.0.0';
2877
+ scopeId: string;
2878
+ domainId: string;
2879
+ domainVersion: string;
2880
+ generatedAt: string;
2881
+ findings: OperatingFindingV2[];
2882
+ decisions: OperatingDecisionV2[];
2883
+ actions: OperatingActionV2[];
1842
2884
  cycleLinks: OperatingWorkCycleLinkV2[];
1843
2885
  }
1844
2886
 
1845
- export type OperateGovernedEffectClassV2 = 'read-only' | 'machine-local-write' | 'project-write' | 'provider-call' | 'external-effect' | 'destructive';
1846
- export type OperateGovernedPolicyOutcomeV2 = 'automatic' | 'named-single-party' | 'named-multi-party' | 'threshold' | 'deferred' | 'rejected' | 'prohibited';
1847
- export type OperateGovernedOperationStateV2 = 'authorized' | 'intent-recorded' | 'dispatching' | 'succeeded' | 'failed' | 'partial' | 'uncertain' | 'blocked' | 'cancelled' | 'rolled-back';
1848
- export interface OperateVersionedIdentityV2 { id: string; version: string; }
1849
- export interface OperateActionIdentityV2 { actionId: string; revision: number; actionHash: string; }
1850
- export interface OperateTargetBindingV2 { kind: string; id: string; revision: string; }
1851
- export interface OperateGovernedContractRefV2 { schemaId: string; schemaVersion: '2.0.0'; }
1852
- export interface OperateGovernedProviderProvenanceV2 { packageName: string; packageVersion: string; integrity: string; }
1853
- export interface OperateGovernedImplementationV2 { source: 'built-in' | 'public-optional' | 'external'; id: string; }
2887
+ export type OperateGovernedEffectClassV2 =
2888
+ | 'read-only'
2889
+ | 'machine-local-write'
2890
+ | 'project-write'
2891
+ | 'provider-call'
2892
+ | 'external-effect'
2893
+ | 'destructive';
2894
+ export type OperateGovernedPolicyOutcomeV2 =
2895
+ | 'automatic'
2896
+ | 'named-single-party'
2897
+ | 'named-multi-party'
2898
+ | 'threshold'
2899
+ | 'deferred'
2900
+ | 'rejected'
2901
+ | 'prohibited';
2902
+ export type OperateGovernedOperationStateV2 =
2903
+ | 'authorized'
2904
+ | 'intent-recorded'
2905
+ | 'dispatching'
2906
+ | 'succeeded'
2907
+ | 'failed'
2908
+ | 'partial'
2909
+ | 'uncertain'
2910
+ | 'blocked'
2911
+ | 'cancelled'
2912
+ | 'rolled-back';
2913
+ export interface OperateVersionedIdentityV2 {
2914
+ id: string;
2915
+ version: string;
2916
+ }
2917
+ export interface OperateActionIdentityV2 {
2918
+ actionId: string;
2919
+ revision: number;
2920
+ actionHash: string;
2921
+ }
2922
+ export interface OperateTargetBindingV2 {
2923
+ kind: string;
2924
+ id: string;
2925
+ revision: string;
2926
+ }
2927
+ export interface OperateGovernedContractRefV2 {
2928
+ schemaId: string;
2929
+ schemaVersion: '2.0.0';
2930
+ }
2931
+ export interface OperateGovernedProviderProvenanceV2 {
2932
+ packageName: string;
2933
+ packageVersion: string;
2934
+ integrity: string;
2935
+ }
2936
+ export interface OperateGovernedImplementationV2 {
2937
+ source: 'built-in' | 'public-optional' | 'external';
2938
+ id: string;
2939
+ }
1854
2940
  export type OperatePolicyTierV2 = 'core' | 'project' | 'domain';
1855
2941
  export interface OperateGovernedRegistrationProfileV2 {
1856
2942
  supportedActionKinds: OperateVersionedIdentityV2[];
1857
2943
  errorContract: OperateGovernedContractRefV2;
1858
2944
  errorCodes: OperateErrorCodeV2[];
1859
2945
  timeoutPolicy: { timeoutMs: number; onTimeout: 'fail-closed' };
1860
- retryPolicy: { maxAttempts: number; backoff: 'none' | 'fixed'; retryableErrorCodes: OperateErrorCodeV2[] };
1861
- idempotency: { keySource: 'runtime-derived-request-fingerprint'; replay: 'return-recorded-result'; intrinsicallyIdempotent: boolean };
2946
+ retryPolicy: {
2947
+ maxAttempts: number;
2948
+ backoff: 'none' | 'fixed';
2949
+ retryableErrorCodes: OperateErrorCodeV2[];
2950
+ };
2951
+ idempotency: {
2952
+ keySource: 'runtime-derived-request-fingerprint';
2953
+ replay: 'return-recorded-result';
2954
+ intrinsicallyIdempotent: boolean;
2955
+ };
1862
2956
  reconciliation: OperateGovernedReconciliationV2;
1863
- health: { status: 'available' | 'degraded' | 'unavailable'; checkedAt: string; expiresAt: string; healthHash: string };
1864
- versionCompatibility: { protocolVersion: '2.0.0'; minimumRuntimeVersion: string; maximumRuntimeVersion: string | null };
2957
+ health: {
2958
+ status: 'available' | 'degraded' | 'unavailable';
2959
+ checkedAt: string;
2960
+ expiresAt: string;
2961
+ healthHash: string;
2962
+ };
2963
+ versionCompatibility: {
2964
+ protocolVersion: '2.0.0';
2965
+ minimumRuntimeVersion: string;
2966
+ maximumRuntimeVersion: string | null;
2967
+ };
1865
2968
  }
1866
2969
  export type OperateGovernedReconciliationV2 =
1867
2970
  | { supported: false; mode: 'none' }
1868
2971
  | { supported: true; mode: 'deterministic' };
1869
2972
  export interface OperatingActionPolicyV2 {
1870
- kind: 'operating-action-policy'; schemaVersion: '1.0.0'; protocolVersion: '2.0.0';
1871
- policyId: string; policyVersion: string; domainId: string; actionKind: OperateVersionedIdentityV2; capability: OperateVersionedIdentityV2;
1872
- effectClasses: OperateGovernedEffectClassV2[]; targetKinds: string[]; decisionMode: OperateGovernedPolicyOutcomeV2; approvalRequirementIds: string[];
1873
- rollbackRequired: boolean; verificationRequired: boolean; tier: OperatePolicyTierV2; precedence: 100 | 200 | 300; narrowingOnly: boolean; provenance: { providerId: string; providerVersion: string; sourceHash: string }; policyHash: string;
2973
+ kind: 'operating-action-policy';
2974
+ schemaVersion: '1.0.0';
2975
+ protocolVersion: '2.0.0';
2976
+ policyId: string;
2977
+ policyVersion: string;
2978
+ domainId: string;
2979
+ actionKind: OperateVersionedIdentityV2;
2980
+ capability: OperateVersionedIdentityV2;
2981
+ effectClasses: OperateGovernedEffectClassV2[];
2982
+ targetKinds: string[];
2983
+ decisionMode: OperateGovernedPolicyOutcomeV2;
2984
+ approvalRequirementIds: string[];
2985
+ rollbackRequired: boolean;
2986
+ verificationRequired: boolean;
2987
+ tier: OperatePolicyTierV2;
2988
+ precedence: 100 | 200 | 300;
2989
+ narrowingOnly: boolean;
2990
+ provenance: { providerId: string; providerVersion: string; sourceHash: string };
2991
+ policyHash: string;
1874
2992
  }
1875
2993
  export interface OperatingPolicyEvaluationV2 {
1876
- kind: 'operating-policy-evaluation'; schemaVersion: '1.0.0'; protocolVersion: '2.0.0'; evaluationId: string;
1877
- policy: { policyId: string; policyVersion: string; policyHash: string }; policyTier: OperatePolicyTierV2; precedence: 100 | 200 | 300; appliedPolicyRefs: Array<{ policyId: string; policyVersion: string; policyHash: string }>; action: OperateActionIdentityV2; capability: OperateVersionedIdentityV2;
1878
- target: OperateTargetBindingV2; effectClass: OperateGovernedEffectClassV2; outcome: OperateGovernedPolicyOutcomeV2; approvalRequirementIds: string[];
1879
- reasonCodes: string[]; evaluatedBy: { providerId: string; providerVersion: string }; evaluatedAt: string; inputHash: string; evaluationHash: string;
2994
+ kind: 'operating-policy-evaluation';
2995
+ schemaVersion: '1.0.0';
2996
+ protocolVersion: '2.0.0';
2997
+ evaluationId: string;
2998
+ policy: { policyId: string; policyVersion: string; policyHash: string };
2999
+ policyTier: OperatePolicyTierV2;
3000
+ precedence: 100 | 200 | 300;
3001
+ appliedPolicyRefs: Array<{ policyId: string; policyVersion: string; policyHash: string }>;
3002
+ action: OperateActionIdentityV2;
3003
+ capability: OperateVersionedIdentityV2;
3004
+ target: OperateTargetBindingV2;
3005
+ effectClass: OperateGovernedEffectClassV2;
3006
+ outcome: OperateGovernedPolicyOutcomeV2;
3007
+ approvalRequirementIds: string[];
3008
+ reasonCodes: string[];
3009
+ evaluatedBy: { providerId: string; providerVersion: string };
3010
+ evaluatedAt: string;
3011
+ inputHash: string;
3012
+ evaluationHash: string;
1880
3013
  }
1881
3014
  export interface OperatingApprovalRequirementV2 {
1882
- kind: 'operating-approval-requirement'; schemaVersion: '1.0.0'; protocolVersion: '2.0.0'; requirementId: string; evaluationId: string;
1883
- policy: { policyId: string; policyVersion: string; policyHash: string }; action: OperateActionIdentityV2; scopeId: string; domainId: string; domainVersion: string; capability: OperateVersionedIdentityV2; target: OperateTargetBindingV2; effectClass: Exclude<OperateGovernedEffectClassV2, 'destructive'>; parties: Array<{ partyId: string; actorKind: 'human' | 'engine'; actorId: string | null; requiredCapability: OperateVersionedIdentityV2 }>; mode: Extract<OperateGovernedPolicyOutcomeV2, 'automatic' | 'named-single-party' | 'named-multi-party' | 'threshold'>;
1884
- namedActorIds: string[]; requiredActorKinds: Array<'human' | 'engine'>; threshold: number; expiresAt: string | null; consumable: boolean; scopeHash: string;
3015
+ kind: 'operating-approval-requirement';
3016
+ schemaVersion: '1.0.0';
3017
+ protocolVersion: '2.0.0';
3018
+ requirementId: string;
3019
+ evaluationId: string;
3020
+ policy: { policyId: string; policyVersion: string; policyHash: string };
3021
+ action: OperateActionIdentityV2;
3022
+ scopeId: string;
3023
+ domainId: string;
3024
+ domainVersion: string;
3025
+ capability: OperateVersionedIdentityV2;
3026
+ target: OperateTargetBindingV2;
3027
+ effectClass: Exclude<OperateGovernedEffectClassV2, 'destructive'>;
3028
+ parties: Array<{
3029
+ partyId: string;
3030
+ actorKind: 'human' | 'engine';
3031
+ actorId: string | null;
3032
+ requiredCapability: OperateVersionedIdentityV2;
3033
+ }>;
3034
+ mode: Extract<
3035
+ OperateGovernedPolicyOutcomeV2,
3036
+ 'automatic' | 'named-single-party' | 'named-multi-party' | 'threshold'
3037
+ >;
3038
+ namedActorIds: string[];
3039
+ requiredActorKinds: Array<'human' | 'engine'>;
3040
+ threshold: number;
3041
+ expiresAt: string | null;
3042
+ consumable: boolean;
3043
+ scopeHash: string;
1885
3044
  }
1886
3045
  export interface OperatingApprovalRecordV2 {
1887
- kind: 'operating-approval-record'; schemaVersion: '1.0.0'; protocolVersion: '2.0.0'; approvalId: string; requirementId: string; evaluationId: string;
1888
- policy: { policyId: string; policyVersion: string; policyHash: string }; action: OperateActionIdentityV2; scopeId: string; domainId: string; domainVersion: string; capability: OperateVersionedIdentityV2; target: OperateTargetBindingV2; effectClass: Exclude<OperateGovernedEffectClassV2, 'destructive'>; partyId: string; actor: { kind: 'human' | 'engine'; actorId: string; capability: OperateVersionedIdentityV2 };
1889
- decision: 'approved' | 'rejected' | 'deferred'; scopeHash: string; issuedAt: string; expiresAt: string | null; consumedByOperationId: string | null; recordHash: string;
3046
+ kind: 'operating-approval-record';
3047
+ schemaVersion: '1.0.0';
3048
+ protocolVersion: '2.0.0';
3049
+ approvalId: string;
3050
+ requirementId: string;
3051
+ evaluationId: string;
3052
+ policy: { policyId: string; policyVersion: string; policyHash: string };
3053
+ action: OperateActionIdentityV2;
3054
+ scopeId: string;
3055
+ domainId: string;
3056
+ domainVersion: string;
3057
+ capability: OperateVersionedIdentityV2;
3058
+ target: OperateTargetBindingV2;
3059
+ effectClass: Exclude<OperateGovernedEffectClassV2, 'destructive'>;
3060
+ partyId: string;
3061
+ actor: { kind: 'human' | 'engine'; actorId: string; capability: OperateVersionedIdentityV2 };
3062
+ decision: 'approved' | 'rejected' | 'deferred';
3063
+ scopeHash: string;
3064
+ issuedAt: string;
3065
+ expiresAt: string | null;
3066
+ consumedByOperationId: string | null;
3067
+ recordHash: string;
1890
3068
  }
1891
3069
  export interface OperatingCapabilityAvailabilityV2 {
1892
- kind: 'operating-capability-availability'; schemaVersion: '1.0.0'; protocolVersion: '2.0.0'; availabilityId: string;
1893
- provider: { providerId: string; providerVersion: string }; capability: OperateVersionedIdentityV2; target: OperateTargetBindingV2;
1894
- effectCeiling: Exclude<OperateGovernedEffectClassV2, 'destructive'>; status: 'available' | 'unavailable' | 'degraded'; reasonCode: string; checkedAt: string; expiresAt: string; availabilityHash: string;
3070
+ kind: 'operating-capability-availability';
3071
+ schemaVersion: '1.0.0';
3072
+ protocolVersion: '2.0.0';
3073
+ availabilityId: string;
3074
+ provider: { providerId: string; providerVersion: string };
3075
+ capability: OperateVersionedIdentityV2;
3076
+ target: OperateTargetBindingV2;
3077
+ effectCeiling: Exclude<OperateGovernedEffectClassV2, 'destructive'>;
3078
+ status: 'available' | 'unavailable' | 'degraded';
3079
+ reasonCode: string;
3080
+ checkedAt: string;
3081
+ expiresAt: string;
3082
+ availabilityHash: string;
1895
3083
  }
1896
3084
  export interface OperatingCapabilityGrantV2 {
1897
- kind: 'operating-capability-grant'; schemaVersion: '1.0.0'; protocolVersion: '2.0.0'; grantId: string; issuer: { kind: 'runtime'; id: string };
1898
- assignmentId: string; action: OperateActionIdentityV2; evaluationId: string; approvalIds: string[]; operationId: string; capability: OperateVersionedIdentityV2;
1899
- target: OperateTargetBindingV2; effectClass: Exclude<OperateGovernedEffectClassV2, 'destructive'>; useLimit: 1; issuedAt: string; expiresAt: string; consumedAt: string | null; revokedAt: string | null; scopeHash: string; grantHash: string;
3085
+ kind: 'operating-capability-grant';
3086
+ schemaVersion: '1.0.0';
3087
+ protocolVersion: '2.0.0';
3088
+ grantId: string;
3089
+ issuer: { kind: 'runtime'; id: string };
3090
+ assignmentId: string;
3091
+ action: OperateActionIdentityV2;
3092
+ evaluationId: string;
3093
+ approvalIds: string[];
3094
+ operationId: string;
3095
+ capability: OperateVersionedIdentityV2;
3096
+ target: OperateTargetBindingV2;
3097
+ effectClass: Exclude<OperateGovernedEffectClassV2, 'destructive'>;
3098
+ useLimit: 1;
3099
+ issuedAt: string;
3100
+ expiresAt: string;
3101
+ consumedAt: string | null;
3102
+ revokedAt: string | null;
3103
+ scopeHash: string;
3104
+ grantHash: string;
1900
3105
  }
1901
3106
  export interface OperatingGovernedOperationV2 {
1902
- kind: 'operating-governed-operation'; schemaVersion: '1.0.0'; protocolVersion: '2.0.0'; operationId: string; operationKind: 'execute' | 'rollback'; action: OperateActionIdentityV2;
1903
- assignmentId: string; requestFingerprint: string; evaluationId: string; approvalIds: string[]; grantId: string; capability: OperateVersionedIdentityV2; target: OperateTargetBindingV2;
1904
- effectClass: Exclude<OperateGovernedEffectClassV2, 'destructive'>; executor: { executorId: string; executorVersion: string }; connector: OperateVersionedIdentityV2 | null; preconditionArtifactIds: string[]; inputArtifactIds: string[]; verificationPlanId: string; rollbackClass: 'not-applicable' | 'reversible' | 'compensating' | 'manual'; state: OperateGovernedOperationStateV2;
1905
- intentEventId: string; resultId: string | null; rollbackPlanId: string | null; parentOperationId: string | null; createdAt: string; updatedAt: string; operationHash: string;
1906
- }
1907
- export interface OperatingExecutionResultV2 { kind: 'operating-execution-result'; schemaVersion: '1.0.0'; protocolVersion: '2.0.0'; resultId: string; operationId: string; operationKind: 'execute'; requestFingerprint: string; action: OperateActionIdentityV2; assignmentId: string; evaluationId: string; approvalIds: string[]; grantId: string; capability: OperateVersionedIdentityV2; target: OperateTargetBindingV2; effectClass: Exclude<OperateGovernedEffectClassV2, 'destructive'>; executor: { executorId: string; executorVersion: string }; connector: OperateVersionedIdentityV2 | null; status: 'succeeded' | 'failed' | 'partial' | 'uncertain' | 'blocked'; targetBeforeHash: string; targetAfterHash: string | null; baselineArtifactId: string | null; baselineHash: string | null; inputArtifactIds: string[]; outputArtifactIds: string[]; effectSummary: { changed: boolean; summary: string; affectedTargetIds: string[] }; resultArtifactId: string; verificationPlanId: string; rollbackPlanId: string | null; eventIds: string[]; completedAt: string; resultHash: string; }
1908
- export interface OperatingRollbackPlanV2 { kind: 'operating-rollback-plan'; schemaVersion: '1.0.0'; protocolVersion: '2.0.0'; rollbackPlanId: string; operationId: string; executionResultId: string; action: OperateActionIdentityV2; eligibility: 'eligible' | 'required' | 'unsupported' | 'prohibited' | 'expired' | 'stale' | 'uncertain'; capability: OperateVersionedIdentityV2; effectClass: Exclude<OperateGovernedEffectClassV2, 'destructive'>; executor: { executorId: string; executorVersion: string }; baselineArtifactId: string; baselineHash: string; steps: Array<{ stepId: string; description: string; expectedTargetHash: string }>; verificationPlanId: string; expiresAt: string; planHash: string; }
1909
- export interface OperatingRollbackResultV2 { kind: 'operating-rollback-result'; schemaVersion: '1.0.0'; protocolVersion: '2.0.0'; rollbackResultId: string; rollbackOperationId: string; operationKind: 'rollback'; requestFingerprint: string; originalOperationId: string; executionResultId: string; rollbackPlanId: string; action: OperateActionIdentityV2; assignmentId: string; evaluationId: string; approvalIds: string[]; grantId: string; capability: OperateVersionedIdentityV2; target: OperateTargetBindingV2; effectClass: Exclude<OperateGovernedEffectClassV2, 'destructive'>; executor: { executorId: string; executorVersion: string }; connector: OperateVersionedIdentityV2 | null; status: 'succeeded' | 'failed' | 'partial' | 'uncertain' | 'blocked'; targetBeforeHash: string; targetAfterHash: string | null; baselineArtifactId: string | null; baselineHash: string | null; inputArtifactIds: string[]; outputArtifactIds: string[]; effectSummary: { changed: boolean; summary: string; affectedTargetIds: string[] }; resultArtifactId: string; verificationPlanId: string; eventIds: string[]; completedAt: string; resultHash: string; }
1910
- export interface OperateCapabilityProviderRegistrationV2 extends OperateGovernedRegistrationProfileV2 {
1911
- kind: 'operate-capability-provider-registration'; schemaVersion: '1.0.0'; protocolVersion: '2.0.0';
1912
- providerId: string; providerVersion: string; capabilities: OperateVersionedIdentityV2[]; supportedDomains: string[]; supportedTargetKinds: string[];
1913
- effectCeiling: Exclude<OperateGovernedEffectClassV2, 'destructive'>; inputContract: OperateGovernedContractRefV2; outputContract: OperateGovernedContractRefV2;
1914
- provenance: OperateGovernedProviderProvenanceV2; conformanceDigest: string; implementation: OperateGovernedImplementationV2;
3107
+ kind: 'operating-governed-operation';
3108
+ schemaVersion: '1.0.0';
3109
+ protocolVersion: '2.0.0';
3110
+ operationId: string;
3111
+ operationKind: 'execute' | 'rollback';
3112
+ action: OperateActionIdentityV2;
3113
+ assignmentId: string;
3114
+ requestFingerprint: string;
3115
+ evaluationId: string;
3116
+ approvalIds: string[];
3117
+ grantId: string;
3118
+ capability: OperateVersionedIdentityV2;
3119
+ target: OperateTargetBindingV2;
3120
+ effectClass: Exclude<OperateGovernedEffectClassV2, 'destructive'>;
3121
+ executor: { executorId: string; executorVersion: string };
3122
+ connector: OperateVersionedIdentityV2 | null;
3123
+ preconditionArtifactIds: string[];
3124
+ inputArtifactIds: string[];
3125
+ verificationPlanId: string;
3126
+ rollbackClass: 'not-applicable' | 'reversible' | 'compensating' | 'manual';
3127
+ state: OperateGovernedOperationStateV2;
3128
+ intentEventId: string;
3129
+ resultId: string | null;
3130
+ rollbackPlanId: string | null;
3131
+ parentOperationId: string | null;
3132
+ createdAt: string;
3133
+ updatedAt: string;
3134
+ operationHash: string;
3135
+ }
3136
+ export interface OperatingExecutionResultV2 {
3137
+ kind: 'operating-execution-result';
3138
+ schemaVersion: '1.0.0';
3139
+ protocolVersion: '2.0.0';
3140
+ resultId: string;
3141
+ operationId: string;
3142
+ operationKind: 'execute';
3143
+ requestFingerprint: string;
3144
+ action: OperateActionIdentityV2;
3145
+ assignmentId: string;
3146
+ evaluationId: string;
3147
+ approvalIds: string[];
3148
+ grantId: string;
3149
+ capability: OperateVersionedIdentityV2;
3150
+ target: OperateTargetBindingV2;
3151
+ effectClass: Exclude<OperateGovernedEffectClassV2, 'destructive'>;
3152
+ executor: { executorId: string; executorVersion: string };
3153
+ connector: OperateVersionedIdentityV2 | null;
3154
+ status: 'succeeded' | 'failed' | 'partial' | 'uncertain' | 'blocked';
3155
+ targetBeforeHash: string;
3156
+ targetAfterHash: string | null;
3157
+ baselineArtifactId: string | null;
3158
+ baselineHash: string | null;
3159
+ inputArtifactIds: string[];
3160
+ outputArtifactIds: string[];
3161
+ effectSummary: { changed: boolean; summary: string; affectedTargetIds: string[] };
3162
+ resultArtifactId: string;
3163
+ verificationPlanId: string;
3164
+ rollbackPlanId: string | null;
3165
+ eventIds: string[];
3166
+ completedAt: string;
3167
+ resultHash: string;
3168
+ }
3169
+ export interface OperatingRollbackPlanV2 {
3170
+ kind: 'operating-rollback-plan';
3171
+ schemaVersion: '1.0.0';
3172
+ protocolVersion: '2.0.0';
3173
+ rollbackPlanId: string;
3174
+ operationId: string;
3175
+ executionResultId: string;
3176
+ action: OperateActionIdentityV2;
3177
+ eligibility:
3178
+ | 'eligible'
3179
+ | 'required'
3180
+ | 'unsupported'
3181
+ | 'prohibited'
3182
+ | 'expired'
3183
+ | 'stale'
3184
+ | 'uncertain';
3185
+ capability: OperateVersionedIdentityV2;
3186
+ effectClass: Exclude<OperateGovernedEffectClassV2, 'destructive'>;
3187
+ executor: { executorId: string; executorVersion: string };
3188
+ baselineArtifactId: string;
3189
+ baselineHash: string;
3190
+ steps: Array<{ stepId: string; description: string; expectedTargetHash: string }>;
3191
+ verificationPlanId: string;
3192
+ expiresAt: string;
3193
+ planHash: string;
3194
+ }
3195
+ export interface OperatingRollbackResultV2 {
3196
+ kind: 'operating-rollback-result';
3197
+ schemaVersion: '1.0.0';
3198
+ protocolVersion: '2.0.0';
3199
+ rollbackResultId: string;
3200
+ rollbackOperationId: string;
3201
+ operationKind: 'rollback';
3202
+ requestFingerprint: string;
3203
+ originalOperationId: string;
3204
+ executionResultId: string;
3205
+ rollbackPlanId: string;
3206
+ action: OperateActionIdentityV2;
3207
+ assignmentId: string;
3208
+ evaluationId: string;
3209
+ approvalIds: string[];
3210
+ grantId: string;
3211
+ capability: OperateVersionedIdentityV2;
3212
+ target: OperateTargetBindingV2;
3213
+ effectClass: Exclude<OperateGovernedEffectClassV2, 'destructive'>;
3214
+ executor: { executorId: string; executorVersion: string };
3215
+ connector: OperateVersionedIdentityV2 | null;
3216
+ status: 'succeeded' | 'failed' | 'partial' | 'uncertain' | 'blocked';
3217
+ targetBeforeHash: string;
3218
+ targetAfterHash: string | null;
3219
+ baselineArtifactId: string | null;
3220
+ baselineHash: string | null;
3221
+ inputArtifactIds: string[];
3222
+ outputArtifactIds: string[];
3223
+ effectSummary: { changed: boolean; summary: string; affectedTargetIds: string[] };
3224
+ resultArtifactId: string;
3225
+ verificationPlanId: string;
3226
+ eventIds: string[];
3227
+ completedAt: string;
3228
+ resultHash: string;
3229
+ }
3230
+ export interface OperateCapabilityProviderRegistrationV2
3231
+ extends OperateGovernedRegistrationProfileV2 {
3232
+ kind: 'operate-capability-provider-registration';
3233
+ schemaVersion: '1.0.0';
3234
+ protocolVersion: '2.0.0';
3235
+ providerId: string;
3236
+ providerVersion: string;
3237
+ capabilities: OperateVersionedIdentityV2[];
3238
+ supportedDomains: string[];
3239
+ supportedTargetKinds: string[];
3240
+ effectCeiling: Exclude<OperateGovernedEffectClassV2, 'destructive'>;
3241
+ inputContract: OperateGovernedContractRefV2;
3242
+ outputContract: OperateGovernedContractRefV2;
3243
+ provenance: OperateGovernedProviderProvenanceV2;
3244
+ conformanceDigest: string;
3245
+ implementation: OperateGovernedImplementationV2;
1915
3246
  fallback: { kind: 'unavailable'; errorCode: 'CAPABILITY_PROVIDER_UNAVAILABLE' };
1916
3247
  }
1917
3248
  export interface OperatePolicyProviderRegistrationV2 extends OperateGovernedRegistrationProfileV2 {
1918
- kind: 'operate-policy-provider-registration'; schemaVersion: '1.0.0'; protocolVersion: '2.0.0';
1919
- providerId: string; providerVersion: string; policyRefs: OperateVersionedIdentityV2[]; supportedDomains: string[];
1920
- effectCeiling: Exclude<OperateGovernedEffectClassV2, 'destructive'>; tier: OperatePolicyTierV2; precedence: 100 | 200 | 300; narrowingOnly: boolean; inputContract: OperateGovernedContractRefV2; outputContract: OperateGovernedContractRefV2;
1921
- provenance: OperateGovernedProviderProvenanceV2; conformanceDigest: string; implementation: OperateGovernedImplementationV2;
3249
+ kind: 'operate-policy-provider-registration';
3250
+ schemaVersion: '1.0.0';
3251
+ protocolVersion: '2.0.0';
3252
+ providerId: string;
3253
+ providerVersion: string;
3254
+ policyRefs: OperateVersionedIdentityV2[];
3255
+ supportedDomains: string[];
3256
+ effectCeiling: Exclude<OperateGovernedEffectClassV2, 'destructive'>;
3257
+ tier: OperatePolicyTierV2;
3258
+ precedence: 100 | 200 | 300;
3259
+ narrowingOnly: boolean;
3260
+ inputContract: OperateGovernedContractRefV2;
3261
+ outputContract: OperateGovernedContractRefV2;
3262
+ provenance: OperateGovernedProviderProvenanceV2;
3263
+ conformanceDigest: string;
3264
+ implementation: OperateGovernedImplementationV2;
1922
3265
  fallback: { kind: 'unavailable'; errorCode: 'POLICY_PROVIDER_UNAVAILABLE' };
1923
3266
  }
1924
3267
  export interface OperateExecutorRegistrationV2 extends OperateGovernedRegistrationProfileV2 {
1925
- kind: 'operate-executor-registration'; schemaVersion: '1.0.0'; protocolVersion: '2.0.0';
1926
- executorId: string; executorVersion: string; operationKinds: Array<'execute' | 'rollback'>; capabilities: OperateVersionedIdentityV2[];
1927
- supportedDomains: string[]; supportedTargetKinds: string[]; effectCeiling: Exclude<OperateGovernedEffectClassV2, 'destructive'>;
1928
- inputContract: OperateGovernedContractRefV2; outputContract: OperateGovernedContractRefV2; rollbackContract: OperateGovernedContractRefV2;
1929
- provenance: OperateGovernedProviderProvenanceV2; conformanceDigest: string; implementation: OperateGovernedImplementationV2;
3268
+ kind: 'operate-executor-registration';
3269
+ schemaVersion: '1.0.0';
3270
+ protocolVersion: '2.0.0';
3271
+ executorId: string;
3272
+ executorVersion: string;
3273
+ operationKinds: Array<'execute' | 'rollback'>;
3274
+ capabilities: OperateVersionedIdentityV2[];
3275
+ supportedDomains: string[];
3276
+ supportedTargetKinds: string[];
3277
+ effectCeiling: Exclude<OperateGovernedEffectClassV2, 'destructive'>;
3278
+ inputContract: OperateGovernedContractRefV2;
3279
+ outputContract: OperateGovernedContractRefV2;
3280
+ rollbackContract: OperateGovernedContractRefV2;
3281
+ provenance: OperateGovernedProviderProvenanceV2;
3282
+ conformanceDigest: string;
3283
+ implementation: OperateGovernedImplementationV2;
1930
3284
  fallback: { kind: 'unavailable'; errorCode: 'EXECUTOR_UNAVAILABLE' };
1931
3285
  }
1932
3286
  export interface OperateGovernedExtensionRegistryV2 {
@@ -1945,62 +3299,467 @@ export interface OperateTrustedExecutorBindingV2 {
1945
3299
  bindingHash: string;
1946
3300
  }
1947
3301
 
1948
- export type OperatingDeliveryRouteKindV1 = 'contained-execution' | 'planning-work' | 'human-external' | 'observe-only';
3302
+ export type OperatingDeliveryRouteKindV1 =
3303
+ | 'contained-execution'
3304
+ | 'planning-work'
3305
+ | 'human-external'
3306
+ | 'observe-only';
1949
3307
  export type OperateExperienceAccessLevelV1 = 'public' | 'internal' | 'confidential' | 'restricted';
1950
3308
  declare const positiveOperateExperienceEventSequenceV1Brand: unique symbol;
1951
- export type PositiveOperateExperienceEventSequenceV1 = number & { readonly [positiveOperateExperienceEventSequenceV1Brand]: 'positive-operate-experience-event-sequence' };
3309
+ export type PositiveOperateExperienceEventSequenceV1 = number & {
3310
+ readonly [positiveOperateExperienceEventSequenceV1Brand]: 'positive-operate-experience-event-sequence';
3311
+ };
1952
3312
  export type OperateExperienceEventHeadV1 =
1953
3313
  | { sequence: 0; hash: null }
1954
3314
  | { sequence: PositiveOperateExperienceEventSequenceV1; hash: string };
1955
3315
  export interface OperatingDeliveryRouteV1 {
1956
- kind: 'operating-delivery-route'; schemaVersion: '1.0.0'; protocolVersion: '2.0.0'; routeId: string;
1957
- scopeId: string; domainId: string; domainVersion: string;
3316
+ kind: 'operating-delivery-route';
3317
+ schemaVersion: '1.0.0';
3318
+ protocolVersion: '2.0.0';
3319
+ routeId: string;
3320
+ scopeId: string;
3321
+ domainId: string;
3322
+ domainVersion: string;
1958
3323
  action: { actionId: string; revision: number; actionHash: string };
1959
- eventHead: OperateExperienceEventHeadV1; route: OperatingDeliveryRouteKindV1;
1960
- rationale: string; createdAt: string; routeHash: string;
1961
- }
1962
- export interface OperateExperienceAttentionV1 { attentionId: string; kind: 'decision' | 'approval' | 'action' | 'verification' | 'outcome' | 'uncertainty'; subjectId: string; priority: number; title: string; whyNow: string; consequence: string; state: string; dueAt: string | null; evidenceRefIds: string[] }
1963
- export interface OperateExperienceDomainMetricV1 { metricId: string; title: string | null; value: number | null; unit: string | null; change: null | { kind: 'added' | 'removed' | 'changed' | 'stale' | 'conflict'; priorValue: number | null; currentValue: number | null; deltaValue: number | null; deltaId: string | null }; window: string | null; freshness: 'current' | 'historical' | 'stale' | 'unknown'; state: 'current' | 'historical' | 'stale' | 'unknown' | 'unavailable' | 'restricted'; target: number | null; threshold: number | null; evidenceRefIds: string[]; snapshot: null | { snapshotId: string; createdAt: string }; delta: null | { deltaId: string; priorSnapshotId: string | null; currentSnapshotId: string; derivedAt: string }; dueVerification: Array<{ verificationPlanId: string; actionId: string; state: string | null; dueAt: string | null; window: string | null; deepLink: string | null }>; accessReason: 'access-denied' | null }
1964
- export interface OperateExperienceCycleStageV1 { id: 'observe' | 'understand' | 'decide' | 'govern' | 'act' | 'verify' | 'learn'; state: 'complete' | 'current' | 'available' | 'blocked' | 'skipped' | 'failed' | 'uncertain' | 'revisited' | 'waiting'; reason: string | null; inputArtifactIds: string[]; outputArtifactIds: string[]; gates: Array<{ kind: 'review' | 'approval' | 'execution' | 'verification' | 'learning'; subjectId: string; state: string }>; evidenceGapIds: string[]; uncertaintyIds: string[]; persistentActionIds: string[] }
1965
- export interface OperateExperienceAssignmentV1 { assignmentId: string; title: string | null; role: string | null; ownerLabel: string | null; state: string; dueAt: string | null; next: null | { label: string; tool: string }; deepLink: string; dependencies: Array<{ assignmentId: string; state: string | null; resolved: boolean }>; blockers: string[]; inputArtifactIds: string[]; outputArtifactIds: string[] }
1966
- export interface OperateExperienceCycleV1 { cycleId: string; state: string; health: string; focus: string[]; createdAt: string; updatedAt: string; stages: OperateExperienceCycleStageV1[]; assignments: OperateExperienceAssignmentV1[]; dependencies: Array<{ subjectKind: 'assignment' | 'action'; subjectId: string; dependsOn: Array<{ assignmentId?: string; actionId?: string; state: string | null; resolved: boolean }> }>; blockers: Array<{ subjectKind: 'assignment' | 'action'; subjectId: string; blockingSubjectIds: string[] }>; persistentActionIds: string[]; replayCheckpoint: OperateExperienceReplayV1['checkpoint']; deepLink: string }
3324
+ eventHead: OperateExperienceEventHeadV1;
3325
+ route: OperatingDeliveryRouteKindV1;
3326
+ rationale: string;
3327
+ createdAt: string;
3328
+ routeHash: string;
3329
+ }
3330
+ export interface OperateExperienceAttentionV1 {
3331
+ attentionId: string;
3332
+ kind: 'decision' | 'approval' | 'action' | 'verification' | 'outcome' | 'uncertainty';
3333
+ subjectId: string;
3334
+ priority: number;
3335
+ title: string;
3336
+ whyNow: string;
3337
+ consequence: string;
3338
+ state: string;
3339
+ dueAt: string | null;
3340
+ evidenceRefIds: string[];
3341
+ }
3342
+ export interface OperateExperienceDomainMetricV1 {
3343
+ metricId: string;
3344
+ title: string | null;
3345
+ value: number | null;
3346
+ unit: string | null;
3347
+ change: null | {
3348
+ kind: 'added' | 'removed' | 'changed' | 'stale' | 'conflict';
3349
+ priorValue: number | null;
3350
+ currentValue: number | null;
3351
+ deltaValue: number | null;
3352
+ deltaId: string | null;
3353
+ };
3354
+ window: string | null;
3355
+ freshness: 'current' | 'historical' | 'stale' | 'unknown';
3356
+ state: 'current' | 'historical' | 'stale' | 'unknown' | 'unavailable' | 'restricted';
3357
+ target: number | null;
3358
+ threshold: number | null;
3359
+ evidenceRefIds: string[];
3360
+ snapshot: null | { snapshotId: string; createdAt: string };
3361
+ delta: null | {
3362
+ deltaId: string;
3363
+ priorSnapshotId: string | null;
3364
+ currentSnapshotId: string;
3365
+ derivedAt: string;
3366
+ };
3367
+ dueVerification: Array<{
3368
+ verificationPlanId: string;
3369
+ actionId: string;
3370
+ state: string | null;
3371
+ dueAt: string | null;
3372
+ window: string | null;
3373
+ deepLink: string | null;
3374
+ }>;
3375
+ accessReason: 'access-denied' | null;
3376
+ }
3377
+ export interface OperateExperienceCycleStageV1 {
3378
+ id: 'observe' | 'understand' | 'decide' | 'govern' | 'act' | 'verify' | 'learn';
3379
+ state:
3380
+ | 'complete'
3381
+ | 'current'
3382
+ | 'available'
3383
+ | 'blocked'
3384
+ | 'skipped'
3385
+ | 'failed'
3386
+ | 'uncertain'
3387
+ | 'revisited'
3388
+ | 'waiting';
3389
+ reason: string | null;
3390
+ inputArtifactIds: string[];
3391
+ outputArtifactIds: string[];
3392
+ gates: Array<{
3393
+ kind: 'review' | 'approval' | 'execution' | 'verification' | 'learning';
3394
+ subjectId: string;
3395
+ state: string;
3396
+ }>;
3397
+ evidenceGapIds: string[];
3398
+ uncertaintyIds: string[];
3399
+ persistentActionIds: string[];
3400
+ }
3401
+ export interface OperateExperienceAssignmentV1 {
3402
+ assignmentId: string;
3403
+ title: string | null;
3404
+ role: string | null;
3405
+ ownerLabel: string | null;
3406
+ state: string;
3407
+ dueAt: string | null;
3408
+ next: null | { label: string; tool: string };
3409
+ deepLink: string;
3410
+ dependencies: Array<{ assignmentId: string; state: string | null; resolved: boolean }>;
3411
+ blockers: string[];
3412
+ inputArtifactIds: string[];
3413
+ outputArtifactIds: string[];
3414
+ }
3415
+ export interface OperateExperienceCycleV1 {
3416
+ cycleId: string;
3417
+ state: string;
3418
+ health: string;
3419
+ focus: string[];
3420
+ createdAt: string;
3421
+ updatedAt: string;
3422
+ stages: OperateExperienceCycleStageV1[];
3423
+ assignments: OperateExperienceAssignmentV1[];
3424
+ dependencies: Array<{
3425
+ subjectKind: 'assignment' | 'action';
3426
+ subjectId: string;
3427
+ dependsOn: Array<{
3428
+ assignmentId?: string;
3429
+ actionId?: string;
3430
+ state: string | null;
3431
+ resolved: boolean;
3432
+ }>;
3433
+ }>;
3434
+ blockers: Array<{
3435
+ subjectKind: 'assignment' | 'action';
3436
+ subjectId: string;
3437
+ blockingSubjectIds: string[];
3438
+ }>;
3439
+ persistentActionIds: string[];
3440
+ replayCheckpoint: OperateExperienceReplayV1['checkpoint'];
3441
+ deepLink: string;
3442
+ }
1967
3443
  export interface OperateExperienceInboxItemV1 {
1968
- itemId: string; kind: 'decision' | 'approval' | 'verification'; subjectId: string;
1969
- ownerActorId: string; state: string; title: string; consequence: string;
1970
- expiresAt: string | null; blocking: boolean;
1971
- evidence: Array<{ evidenceRefId: string; classification: OperateExperienceAccessLevelV1; accessState: 'available' | 'restricted'; relation: 'support' | 'contradiction' | 'informs' | 'evaluates' }>;
1972
- requiredParties: Array<{ partyId: string; actorKind: 'human' | 'engine'; actorId: string | null; requiredCapability: OperateVersionedIdentityV2; state: 'required' | 'recorded' | 'redacted'; redacted: boolean }>;
3444
+ itemId: string;
3445
+ kind: 'decision' | 'approval' | 'verification';
3446
+ subjectId: string;
3447
+ ownerActorId: string;
3448
+ state: string;
3449
+ title: string;
3450
+ consequence: string;
3451
+ expiresAt: string | null;
3452
+ blocking: boolean;
3453
+ evidence: Array<{
3454
+ evidenceRefId: string;
3455
+ classification: OperateExperienceAccessLevelV1;
3456
+ accessState: 'available' | 'restricted';
3457
+ relation: 'support' | 'contradiction' | 'informs' | 'evaluates';
3458
+ }>;
3459
+ requiredParties: Array<{
3460
+ partyId: string;
3461
+ actorKind: 'human' | 'engine';
3462
+ actorId: string | null;
3463
+ requiredCapability: OperateVersionedIdentityV2;
3464
+ state: 'required' | 'recorded' | 'redacted';
3465
+ redacted: boolean;
3466
+ }>;
1973
3467
  redactions: OperateExperienceOmissionV1[];
1974
3468
  actionLocator: null | { subjectId: string; actionDigest: string };
1975
- navigationLocator: null | { kind: 'review'; cycleId: string; reviewId: string; deepLink: string; readActionDigest: string };
3469
+ navigationLocator: null | {
3470
+ kind: 'review';
3471
+ cycleId: string;
3472
+ reviewId: string;
3473
+ deepLink: string;
3474
+ readActionDigest: string;
3475
+ };
1976
3476
  unavailableReason: null | { code: string; message: string };
1977
3477
  }
1978
- export interface OperateExperienceResultV1 { resultId: string; operationId: string; status: string; completedAt: string; effectSummary: null | { changed: boolean; summary: string; affectedTargetIds: string[] }; targetBeforeHash: string | null; targetAfterHash: string | null; accessReason: 'access-denied' | null; deepLink: string }
1979
- export interface OperateExperienceActionV1 { actionId: string; revision: number; actionHash: string; title: string; state: string; ownerActorId: string | null; expectedResult: string; verificationPlanId: string; deliveryRoute: OperatingDeliveryRouteV1; dependencyActionIds: string[]; executions: OperateExperienceResultV1[]; rollbacks: OperateExperienceResultV1[]; deepLink: string }
1980
- export interface OperateExperienceCausalLinkV1 { kind: 'claim' | 'local-claim' | 'decision' | 'action' | 'outcome'; subjectId: string; relation: 'support' | 'contradiction' | 'informs' | 'evaluates'; deepLink: string }
1981
- export interface OperateExperienceResolutionErrorV1 { resolutionId: string; error: null | { code: string; retryable: boolean; context: Record<string, string> }; resolvedAt: string }
1982
- export interface OperateExperienceEvidenceV1 { evidenceRefId: string; classification: OperateExperienceAccessLevelV1; accessState: 'available' | 'restricted'; freshness: 'current' | 'historical' | 'stale'; evidenceKind: 'git' | 'filesystem' | 'planr' | 'operate-artifact' | null; resolvedAt: string | null; claimStatus: 'supported' | 'contradicted' | 'uncertain' | 'unknown' | 'restricted'; supportClaimIds: string[]; contradictClaimIds: string[]; source: null | { evidenceKind: 'git' | 'filesystem' | 'planr' | 'operate-artifact'; provider: { id: string; version: string }; resolver: { id: string; version: string } }; producer: null | { actorId: string; roleId: string; runtime: string }; observedAt: string | null; scope: { scopeId: string; domainId: string; domainVersion: string }; sensitivity: OperateExperienceAccessLevelV1; provenance: null | { sourceArtifactId: string; evidenceArtifactId: string; rawHash: string; canonicalHash: string | null; sizeBytes: number; mediaType: string; accessLevel: OperateExperienceAccessLevelV1 }; confidence: number | null; gaps: string[]; errors: OperateExperienceResolutionErrorV1[]; accessReason: 'access-denied' | null; causalLinks: OperateExperienceCausalLinkV1[]; deepLink: string }
1983
- export interface OperateExperienceClaimV1 { claimId: string; status: 'supported' | 'contradicted' | 'uncertain' | 'unknown' | 'restricted'; epistemicStatus: 'known' | 'strongly-supported' | 'probable' | 'speculative' | 'unknown'; statement: string | null; supportEvidenceRefIds: string[]; contradictEvidenceRefIds: string[]; source: null | { artifactId: string; artifactType: string; producer: { actorId: string; roleId: string; runtime: string }; observedAt: string; rawHash: string; canonicalHash: string | null }; producer: null | { actorId: string; roleId: string; runtime: string }; observedAt: string; scope: { scopeId: string; domainId: string; domainVersion: string }; sensitivity: OperateExperienceAccessLevelV1; provenance: null | { artifactId: string; rawHash: string; canonicalHash: string | null }; confidence: number | null; gaps: string[]; errors: OperateExperienceResolutionErrorV1[]; accessReason: 'access-denied' | null; causalLinks: OperateExperienceCausalLinkV1[]; deepLink: string }
1984
- export interface OperateExperienceRationaleV1 { nodeId: string; kind: 'claim' | 'recommendation' | 'challenge' | 'synthesis' | 'decision' | 'action' | 'result' | 'outcome' | 'learning' | 'revisit'; subjectId: string; summary: string; artifactId: string | null; evidenceRefIds: string[] }
1985
- export interface OperateExperienceOutcomeV1 { outcomeId: string; actionId: string; verificationPlanId: string; status: string; metric: null | { metricId: string; metricHash: string; baseline: number | null; target: number | null; observed: number | null; unit: string | null; window: string | null; dueAt: string | null; freshness: 'current' | 'historical' | 'stale' | 'unknown'; confidence: number | null }; observationIds: string[]; evidenceRefIds: string[]; observedAt: string; decision: null | { decisionId: string; revision: number; state: string; deepLink: string }; execution: OperateExperienceResultV1[]; rollback: OperateExperienceResultV1[]; verification: null | { verificationPlanId: string; verificationPlanHash: string; metricId: string; metricHash: string; method: string | null; evaluationRules: string[]; observationRequest: null | { kind: 'future-observation' | 'future-analysis'; reason: string }; accessReason: 'access-denied' | null }; nextObservation: null | { kind: 'future-observation' | 'future-analysis'; reason: string; dueAt: string | null }; revisit: null | { decisionIds: string[]; conditions: string[] }; snapshot: null | { snapshotId: string; createdAt: string }; delta: null | { deltaId: string; priorSnapshotId: string | null; currentSnapshotId: string; derivedAt: string }; accessReason: 'access-denied' | null; deepLink: string }
1986
- export interface OperateExperienceLearningV1 { learningId: string; outcomeId: string; statement: string; decisionIds: string[]; evidenceRefIds: string[]; createdAt: string }
1987
- export interface OperateExperienceHistoryV1 { eventId: string; sequence: number; type: string; entityId: string; actorKind: string; actorId: string | null; timestamp: string; correlationId: string; eventHash: string; change: { subjectKind: string | null; summary: string | null }; why: string | null; authority: null | { evaluationId: string; approvalIds: string[]; grantId: string; capability: { id: string; version: string } }; evidenceRefIds: string[]; prior: { previousEventHash: string | null; causationId: string | null }; result: null | { status: string; completedAt: string | null }; next: null | { label: string; tool: string }; deepLinks: string[]; beforeAfter: null | { deltaId: string; kind: 'added' | 'removed' | 'changed' | 'stale' | 'conflict'; priorSnapshotId: string | null; currentSnapshotId: string } }
1988
- export interface OperateExperienceReplayV1 { checkpoint: null | { createdAt: string; eventHead: OperateExperienceEventHeadV1; runtimeStateHash: string; eventReplayIndexHash: string; recoveryVersion: string }; tail: { startSequence: number | null; endSequence: number | null; eventCount: number; eventReplayIndexHash: string }; finalHead: OperateExperienceEventHeadV1; liveAccessUsed: false; parityProof: { sourceStateHash: string; eventReplayIndexHash: string; checkpointVerified: boolean; finalEventHashMatches: boolean; stateParityVerified: boolean }; filterDimensions: Array<'cycle' | 'action' | 'decision' | 'actor' | 'operation' | 'result' | 'event-type' | 'date'>; redactions: OperateExperienceOmissionV1[] }
1989
- export interface OperateExperienceOmissionV1 { classification: OperateExperienceAccessLevelV1; count: number; reason: 'access-denied' | 'body-never-projected' | 'identity-redacted' }
3478
+ export interface OperateExperienceResultV1 {
3479
+ resultId: string;
3480
+ operationId: string;
3481
+ status: string;
3482
+ completedAt: string;
3483
+ effectSummary: null | { changed: boolean; summary: string; affectedTargetIds: string[] };
3484
+ targetBeforeHash: string | null;
3485
+ targetAfterHash: string | null;
3486
+ accessReason: 'access-denied' | null;
3487
+ deepLink: string;
3488
+ }
3489
+ export interface OperateExperienceActionV1 {
3490
+ actionId: string;
3491
+ revision: number;
3492
+ actionHash: string;
3493
+ title: string;
3494
+ state: string;
3495
+ ownerActorId: string | null;
3496
+ expectedResult: string;
3497
+ verificationPlanId: string;
3498
+ deliveryRoute: OperatingDeliveryRouteV1;
3499
+ dependencyActionIds: string[];
3500
+ executions: OperateExperienceResultV1[];
3501
+ rollbacks: OperateExperienceResultV1[];
3502
+ deepLink: string;
3503
+ }
3504
+ export interface OperateExperienceCausalLinkV1 {
3505
+ kind: 'claim' | 'local-claim' | 'decision' | 'action' | 'outcome';
3506
+ subjectId: string;
3507
+ relation: 'support' | 'contradiction' | 'informs' | 'evaluates';
3508
+ deepLink: string;
3509
+ }
3510
+ export interface OperateExperienceResolutionErrorV1 {
3511
+ resolutionId: string;
3512
+ error: null | { code: string; retryable: boolean; context: Record<string, string> };
3513
+ resolvedAt: string;
3514
+ }
3515
+ export interface OperateExperienceEvidenceV1 {
3516
+ evidenceRefId: string;
3517
+ classification: OperateExperienceAccessLevelV1;
3518
+ accessState: 'available' | 'restricted';
3519
+ freshness: 'current' | 'historical' | 'stale';
3520
+ evidenceKind: 'git' | 'filesystem' | 'planr' | 'operate-artifact' | null;
3521
+ resolvedAt: string | null;
3522
+ claimStatus: 'supported' | 'contradicted' | 'uncertain' | 'unknown' | 'restricted';
3523
+ supportClaimIds: string[];
3524
+ contradictClaimIds: string[];
3525
+ source: null | {
3526
+ evidenceKind: 'git' | 'filesystem' | 'planr' | 'operate-artifact';
3527
+ provider: { id: string; version: string };
3528
+ resolver: { id: string; version: string };
3529
+ };
3530
+ producer: null | { actorId: string; roleId: string; runtime: string };
3531
+ observedAt: string | null;
3532
+ scope: { scopeId: string; domainId: string; domainVersion: string };
3533
+ sensitivity: OperateExperienceAccessLevelV1;
3534
+ provenance: null | {
3535
+ sourceArtifactId: string;
3536
+ evidenceArtifactId: string;
3537
+ rawHash: string;
3538
+ canonicalHash: string | null;
3539
+ sizeBytes: number;
3540
+ mediaType: string;
3541
+ accessLevel: OperateExperienceAccessLevelV1;
3542
+ };
3543
+ confidence: number | null;
3544
+ gaps: string[];
3545
+ errors: OperateExperienceResolutionErrorV1[];
3546
+ accessReason: 'access-denied' | null;
3547
+ causalLinks: OperateExperienceCausalLinkV1[];
3548
+ deepLink: string;
3549
+ }
3550
+ export interface OperateExperienceClaimV1 {
3551
+ claimId: string;
3552
+ status: 'supported' | 'contradicted' | 'uncertain' | 'unknown' | 'restricted';
3553
+ epistemicStatus: 'known' | 'strongly-supported' | 'probable' | 'speculative' | 'unknown';
3554
+ statement: string | null;
3555
+ supportEvidenceRefIds: string[];
3556
+ contradictEvidenceRefIds: string[];
3557
+ source: null | {
3558
+ artifactId: string;
3559
+ artifactType: string;
3560
+ producer: { actorId: string; roleId: string; runtime: string };
3561
+ observedAt: string;
3562
+ rawHash: string;
3563
+ canonicalHash: string | null;
3564
+ };
3565
+ producer: null | { actorId: string; roleId: string; runtime: string };
3566
+ observedAt: string;
3567
+ scope: { scopeId: string; domainId: string; domainVersion: string };
3568
+ sensitivity: OperateExperienceAccessLevelV1;
3569
+ provenance: null | { artifactId: string; rawHash: string; canonicalHash: string | null };
3570
+ confidence: number | null;
3571
+ gaps: string[];
3572
+ errors: OperateExperienceResolutionErrorV1[];
3573
+ accessReason: 'access-denied' | null;
3574
+ causalLinks: OperateExperienceCausalLinkV1[];
3575
+ deepLink: string;
3576
+ }
3577
+ export interface OperateExperienceRationaleV1 {
3578
+ nodeId: string;
3579
+ kind:
3580
+ | 'claim'
3581
+ | 'recommendation'
3582
+ | 'challenge'
3583
+ | 'synthesis'
3584
+ | 'decision'
3585
+ | 'action'
3586
+ | 'result'
3587
+ | 'outcome'
3588
+ | 'learning'
3589
+ | 'revisit';
3590
+ subjectId: string;
3591
+ summary: string;
3592
+ artifactId: string | null;
3593
+ evidenceRefIds: string[];
3594
+ }
3595
+ export interface OperateExperienceOutcomeV1 {
3596
+ outcomeId: string;
3597
+ actionId: string;
3598
+ verificationPlanId: string;
3599
+ status: string;
3600
+ metric: null | {
3601
+ metricId: string;
3602
+ metricHash: string;
3603
+ baseline: number | null;
3604
+ target: number | null;
3605
+ observed: number | null;
3606
+ unit: string | null;
3607
+ window: string | null;
3608
+ dueAt: string | null;
3609
+ freshness: 'current' | 'historical' | 'stale' | 'unknown';
3610
+ confidence: number | null;
3611
+ };
3612
+ observationIds: string[];
3613
+ evidenceRefIds: string[];
3614
+ observedAt: string;
3615
+ decision: null | { decisionId: string; revision: number; state: string; deepLink: string };
3616
+ execution: OperateExperienceResultV1[];
3617
+ rollback: OperateExperienceResultV1[];
3618
+ verification: null | {
3619
+ verificationPlanId: string;
3620
+ verificationPlanHash: string;
3621
+ metricId: string;
3622
+ metricHash: string;
3623
+ method: string | null;
3624
+ evaluationRules: string[];
3625
+ observationRequest: null | { kind: 'future-observation' | 'future-analysis'; reason: string };
3626
+ accessReason: 'access-denied' | null;
3627
+ };
3628
+ nextObservation: null | {
3629
+ kind: 'future-observation' | 'future-analysis';
3630
+ reason: string;
3631
+ dueAt: string | null;
3632
+ };
3633
+ revisit: null | { decisionIds: string[]; conditions: string[] };
3634
+ snapshot: null | { snapshotId: string; createdAt: string };
3635
+ delta: null | {
3636
+ deltaId: string;
3637
+ priorSnapshotId: string | null;
3638
+ currentSnapshotId: string;
3639
+ derivedAt: string;
3640
+ };
3641
+ accessReason: 'access-denied' | null;
3642
+ deepLink: string;
3643
+ }
3644
+ export interface OperateExperienceLearningV1 {
3645
+ learningId: string;
3646
+ outcomeId: string;
3647
+ statement: string;
3648
+ decisionIds: string[];
3649
+ evidenceRefIds: string[];
3650
+ createdAt: string;
3651
+ }
3652
+ export interface OperateExperienceHistoryV1 {
3653
+ eventId: string;
3654
+ sequence: number;
3655
+ type: string;
3656
+ entityId: string;
3657
+ actorKind: string;
3658
+ actorId: string | null;
3659
+ timestamp: string;
3660
+ correlationId: string;
3661
+ eventHash: string;
3662
+ change: { subjectKind: string | null; summary: string | null };
3663
+ why: string | null;
3664
+ authority: null | {
3665
+ evaluationId: string;
3666
+ approvalIds: string[];
3667
+ grantId: string;
3668
+ capability: { id: string; version: string };
3669
+ };
3670
+ evidenceRefIds: string[];
3671
+ prior: { previousEventHash: string | null; causationId: string | null };
3672
+ result: null | { status: string; completedAt: string | null };
3673
+ next: null | { label: string; tool: string };
3674
+ deepLinks: string[];
3675
+ beforeAfter: null | {
3676
+ deltaId: string;
3677
+ kind: 'added' | 'removed' | 'changed' | 'stale' | 'conflict';
3678
+ priorSnapshotId: string | null;
3679
+ currentSnapshotId: string;
3680
+ };
3681
+ }
3682
+ export interface OperateExperienceReplayV1 {
3683
+ checkpoint: null | {
3684
+ createdAt: string;
3685
+ eventHead: OperateExperienceEventHeadV1;
3686
+ runtimeStateHash: string;
3687
+ eventReplayIndexHash: string;
3688
+ recoveryVersion: string;
3689
+ };
3690
+ tail: {
3691
+ startSequence: number | null;
3692
+ endSequence: number | null;
3693
+ eventCount: number;
3694
+ eventReplayIndexHash: string;
3695
+ };
3696
+ finalHead: OperateExperienceEventHeadV1;
3697
+ liveAccessUsed: false;
3698
+ parityProof: {
3699
+ sourceStateHash: string;
3700
+ eventReplayIndexHash: string;
3701
+ checkpointVerified: boolean;
3702
+ finalEventHashMatches: boolean;
3703
+ stateParityVerified: boolean;
3704
+ };
3705
+ filterDimensions: Array<
3706
+ 'cycle' | 'action' | 'decision' | 'actor' | 'operation' | 'result' | 'event-type' | 'date'
3707
+ >;
3708
+ redactions: OperateExperienceOmissionV1[];
3709
+ }
3710
+ export interface OperateExperienceOmissionV1 {
3711
+ classification: OperateExperienceAccessLevelV1;
3712
+ count: number;
3713
+ reason: 'access-denied' | 'body-never-projected' | 'identity-redacted';
3714
+ }
1990
3715
  export interface OperateExperienceViewV1 {
1991
- kind: 'operate-experience-view'; schemaVersion: '1.0.0'; protocolVersion: '2.0.0'; viewId: string;
1992
- scopeId: string; domainId: string; domainVersion: string; actorId: string; accessLevel: OperateExperienceAccessLevelV1;
1993
- generatedAt: string; eventHead: OperateExperienceEventHeadV1; sourceStateHash: string;
1994
- status: 'ready' | 'read-only' | 'stale' | 'partial' | 'blocked' | 'offline' | 'incompatible' | 'corrupt';
1995
- attention: OperateExperienceAttentionV1[]; domainMetrics: OperateExperienceDomainMetricV1[]; cycles: OperateExperienceCycleV1[]; inbox: OperateExperienceInboxItemV1[]; actions: OperateExperienceActionV1[]; evidence: OperateExperienceEvidenceV1[];
1996
- claims: OperateExperienceClaimV1[]; rationale: OperateExperienceRationaleV1[]; outcomes: OperateExperienceOutcomeV1[]; learnings: OperateExperienceLearningV1[]; history: OperateExperienceHistoryV1[]; replay: OperateExperienceReplayV1;
3716
+ kind: 'operate-experience-view';
3717
+ schemaVersion: '1.0.0';
3718
+ protocolVersion: '2.0.0';
3719
+ viewId: string;
3720
+ scopeId: string;
3721
+ domainId: string;
3722
+ domainVersion: string;
3723
+ actorId: string;
3724
+ accessLevel: OperateExperienceAccessLevelV1;
3725
+ generatedAt: string;
3726
+ eventHead: OperateExperienceEventHeadV1;
3727
+ sourceStateHash: string;
3728
+ status:
3729
+ | 'ready'
3730
+ | 'read-only'
3731
+ | 'stale'
3732
+ | 'partial'
3733
+ | 'blocked'
3734
+ | 'offline'
3735
+ | 'incompatible'
3736
+ | 'corrupt';
3737
+ attention: OperateExperienceAttentionV1[];
3738
+ domainMetrics: OperateExperienceDomainMetricV1[];
3739
+ cycles: OperateExperienceCycleV1[];
3740
+ inbox: OperateExperienceInboxItemV1[];
3741
+ actions: OperateExperienceActionV1[];
3742
+ evidence: OperateExperienceEvidenceV1[];
3743
+ claims: OperateExperienceClaimV1[];
3744
+ rationale: OperateExperienceRationaleV1[];
3745
+ outcomes: OperateExperienceOutcomeV1[];
3746
+ learnings: OperateExperienceLearningV1[];
3747
+ history: OperateExperienceHistoryV1[];
3748
+ replay: OperateExperienceReplayV1;
1997
3749
  allowedActions: Array<{ subjectId: string; action: OperateAllowedActionV2 }>;
1998
- omissions: OperateExperienceOmissionV1[]; export: { formats: Array<'html' | 'json'>; accessSafe: true; redactionCount: number }; viewHash: string;
3750
+ omissions: OperateExperienceOmissionV1[];
3751
+ export: { formats: Array<'html' | 'json'>; accessSafe: true; redactionCount: number };
3752
+ viewHash: string;
1999
3753
  }
2000
3754
  export type OperateExperiencePatchOperationV1 =
2001
3755
  | { op: 'replace'; path: '/status'; valueHash: string; value: OperateExperienceViewV1['status'] }
2002
3756
  | { op: 'replace'; path: '/attention'; valueHash: string; value: OperateExperienceAttentionV1[] }
2003
- | { op: 'replace'; path: '/domainMetrics'; valueHash: string; value: OperateExperienceDomainMetricV1[] }
3757
+ | {
3758
+ op: 'replace';
3759
+ path: '/domainMetrics';
3760
+ valueHash: string;
3761
+ value: OperateExperienceDomainMetricV1[];
3762
+ }
2004
3763
  | { op: 'replace'; path: '/cycles'; valueHash: string; value: OperateExperienceCycleV1[] }
2005
3764
  | { op: 'replace'; path: '/inbox'; valueHash: string; value: OperateExperienceInboxItemV1[] }
2006
3765
  | { op: 'replace'; path: '/actions'; valueHash: string; value: OperateExperienceActionV1[] }
@@ -2011,72 +3770,305 @@ export type OperateExperiencePatchOperationV1 =
2011
3770
  | { op: 'replace'; path: '/learnings'; valueHash: string; value: OperateExperienceLearningV1[] }
2012
3771
  | { op: 'replace'; path: '/history'; valueHash: string; value: OperateExperienceHistoryV1[] }
2013
3772
  | { op: 'replace'; path: '/replay'; valueHash: string; value: OperateExperienceReplayV1 }
2014
- | { op: 'replace'; path: '/allowedActions'; valueHash: string; value: OperateExperienceViewV1['allowedActions'] }
3773
+ | {
3774
+ op: 'replace';
3775
+ path: '/allowedActions';
3776
+ valueHash: string;
3777
+ value: OperateExperienceViewV1['allowedActions'];
3778
+ }
2015
3779
  | { op: 'replace'; path: '/omissions'; valueHash: string; value: OperateExperienceOmissionV1[] }
2016
3780
  | { op: 'replace'; path: '/export'; valueHash: string; value: OperateExperienceViewV1['export'] };
2017
3781
  export interface OperateExperienceLivePatchV1 {
2018
- kind: 'operate-experience-live-patch'; schemaVersion: '1.0.0'; protocolVersion: '2.0.0'; patchId: string;
2019
- scopeId: string; domainId: string; domainVersion: string; actorId: string;
2020
- fromEventHead: OperateExperienceEventHeadV1; toEventHead: OperateExperienceEventHeadV1;
2021
- fromViewHash: string; toViewHash: string;
3782
+ kind: 'operate-experience-live-patch';
3783
+ schemaVersion: '1.0.0';
3784
+ protocolVersion: '2.0.0';
3785
+ patchId: string;
3786
+ scopeId: string;
3787
+ domainId: string;
3788
+ domainVersion: string;
3789
+ actorId: string;
3790
+ fromEventHead: OperateExperienceEventHeadV1;
3791
+ toEventHead: OperateExperienceEventHeadV1;
3792
+ fromViewHash: string;
3793
+ toViewHash: string;
2022
3794
  operations: OperateExperiencePatchOperationV1[];
2023
- createdAt: string; patchHash: string;
3795
+ createdAt: string;
3796
+ patchHash: string;
2024
3797
  }
2025
3798
  export interface OperateExperiencePreviewV1 {
2026
- kind: 'operate-experience-preview'; schemaVersion: '1.0.0'; protocolVersion: '2.0.0'; previewId: string;
2027
- scopeId: string; domainId: string; domainVersion: string; actorId: string;
3799
+ kind: 'operate-experience-preview';
3800
+ schemaVersion: '1.0.0';
3801
+ protocolVersion: '2.0.0';
3802
+ previewId: string;
3803
+ scopeId: string;
3804
+ domainId: string;
3805
+ domainVersion: string;
3806
+ actorId: string;
2028
3807
  subject: OperateExperiencePreviewSubjectV1;
2029
- eventHead: OperateExperienceEventHeadV1; sourceViewHash: string; actionDigest: string; allowedAction: OperateAllowedActionV2;
2030
- authority: 'allowed' | 'refused' | 'read-only'; consequence: string; reasonCodes: string[];
3808
+ eventHead: OperateExperienceEventHeadV1;
3809
+ sourceViewHash: string;
3810
+ actionDigest: string;
3811
+ allowedAction: OperateAllowedActionV2;
3812
+ authority: 'allowed' | 'refused' | 'read-only';
3813
+ consequence: string;
3814
+ reasonCodes: string[];
2031
3815
  transition: {
2032
3816
  kind: 'review' | 'approval' | 'verification' | 'execution' | 'rollback';
2033
- targets: Array<{ kind: string; id: string; revision: number | string | null; hash: string | null; disposition: string | null }>;
2034
- reversible: boolean; nextState: string;
2035
- threshold: null | { required: number; recorded: number; remaining: number; parties: OperateExperienceInboxItemV1['requiredParties'] };
3817
+ targets: Array<{
3818
+ kind: string;
3819
+ id: string;
3820
+ revision: number | string | null;
3821
+ hash: string | null;
3822
+ disposition: string | null;
3823
+ }>;
3824
+ reversible: boolean;
3825
+ nextState: string;
3826
+ threshold: null | {
3827
+ required: number;
3828
+ recorded: number;
3829
+ remaining: number;
3830
+ parties: OperateExperienceInboxItemV1['requiredParties'];
3831
+ };
2036
3832
  };
2037
- issuedAt: string; expiresAt: string; previewHash: string;
3833
+ issuedAt: string;
3834
+ expiresAt: string;
3835
+ previewHash: string;
2038
3836
  }
2039
3837
  export type OperateExperiencePreviewSubjectV1 =
2040
- | { kind: 'cycle' | 'assignment' | 'artifact' | 'review'; id: string; revision: null; hash: string }
3838
+ | {
3839
+ kind: 'cycle' | 'assignment' | 'artifact' | 'review';
3840
+ id: string;
3841
+ revision: null;
3842
+ hash: string;
3843
+ }
2041
3844
  | { kind: 'decision' | 'action'; id: string; revision: number; hash: string };
2042
3845
  export interface OperatingPlanningProposalV1 {
2043
- kind: 'operating-planning-proposal'; schemaVersion: '1.0.0'; protocolVersion: '2.0.0'; proposalId: string; correlationId: string;
2044
- revision: number; predecessorProposalHash: string | null; state: 'review-required' | 'approved' | 'expired' | 'withdrawn' | 'superseded';
2045
- confirmation: null | { confirmationId: string; reviewProposalHash: string; reviewProposalRevision: 1; eventHead: OperateExperienceEventHeadV1; previewDigest: string; actorId: string; decision: 'approved'; confirmedAt: string; previewExpiresAt: string; confirmationHash: string };
2046
- scopeId: string; domainId: string; domainVersion: string; cycleId: string; eventHead: OperateExperienceEventHeadV1;
2047
- decision: { decisionId: string; revision: number; decisionHash: string; sourceArtifactId: string; title: string; outcome: string; rationale: string; confidence: number; evidenceRefIds: string[] };
2048
- action: { actionId: string; revision: number; actionHash: string; sourceArtifactId: string; title: string; expectedResult: string; metricId: string; verificationPlanId: string };
3846
+ kind: 'operating-planning-proposal';
3847
+ schemaVersion: '1.0.0';
3848
+ protocolVersion: '2.0.0';
3849
+ proposalId: string;
3850
+ correlationId: string;
3851
+ revision: number;
3852
+ predecessorProposalHash: string | null;
3853
+ state: 'review-required' | 'approved' | 'expired' | 'withdrawn' | 'superseded';
3854
+ confirmation: null | {
3855
+ confirmationId: string;
3856
+ reviewProposalHash: string;
3857
+ reviewProposalRevision: 1;
3858
+ eventHead: OperateExperienceEventHeadV1;
3859
+ previewDigest: string;
3860
+ actorId: string;
3861
+ decision: 'approved';
3862
+ confirmedAt: string;
3863
+ previewExpiresAt: string;
3864
+ confirmationHash: string;
3865
+ };
3866
+ scopeId: string;
3867
+ domainId: string;
3868
+ domainVersion: string;
3869
+ cycleId: string;
3870
+ eventHead: OperateExperienceEventHeadV1;
3871
+ decision: {
3872
+ decisionId: string;
3873
+ revision: number;
3874
+ decisionHash: string;
3875
+ sourceArtifactId: string;
3876
+ title: string;
3877
+ outcome: string;
3878
+ rationale: string;
3879
+ confidence: number;
3880
+ evidenceRefIds: string[];
3881
+ };
3882
+ action: {
3883
+ actionId: string;
3884
+ revision: number;
3885
+ actionHash: string;
3886
+ sourceArtifactId: string;
3887
+ title: string;
3888
+ expectedResult: string;
3889
+ metricId: string;
3890
+ verificationPlanId: string;
3891
+ };
2049
3892
  deliveryRoute: OperatingDeliveryRouteV1;
2050
- acceptedPerspectiveSummaries: Array<{ roleId: string; roleVersion: string; roleKind: 'advisor' | 'challenger' | 'chair'; artifactId: string; artifactHash: string; accessClassification: OperateExperienceAccessLevelV1; disposition: 'accepted'; normative: boolean; stance: 'support' | 'object' | 'constraint' | 'unknown' | 'synthesis'; summary: string; constraints: string[]; uncertainties: string[] }>;
2051
- evidence: Array<{ evidenceRefId: string; artifactId: string; artifactHash: string; classification: OperateExperienceAccessLevelV1; accessState: 'available' | 'restricted'; relation: 'support' | 'contradiction' | 'gap'; freshness: 'current' | 'historical' | 'stale' | 'unknown'; confidence: number; summary: string | null; limitations: string[] }>;
2052
- omissions: Array<{ classification: OperateExperienceAccessLevelV1; count: number; reason: 'access-denied' | 'hidden-reasoning-excluded' | 'raw-prompt-excluded' | 'rejected-advice-excluded' | 'restricted-body-excluded' }>;
2053
- framing: { title: string; slug: string; problem: string; objective: string; users: string[]; scope: string[]; nonScope: string[]; risks: string[]; constraints: string[]; requirements: string[]; acceptanceOutcomes: string[] };
3893
+ acceptedPerspectiveSummaries: Array<{
3894
+ roleId: string;
3895
+ roleVersion: string;
3896
+ roleKind: 'advisor' | 'challenger' | 'chair';
3897
+ artifactId: string;
3898
+ artifactHash: string;
3899
+ accessClassification: OperateExperienceAccessLevelV1;
3900
+ disposition: 'accepted';
3901
+ normative: boolean;
3902
+ stance: 'support' | 'object' | 'constraint' | 'unknown' | 'synthesis';
3903
+ summary: string;
3904
+ constraints: string[];
3905
+ uncertainties: string[];
3906
+ }>;
3907
+ evidence: Array<{
3908
+ evidenceRefId: string;
3909
+ artifactId: string;
3910
+ artifactHash: string;
3911
+ classification: OperateExperienceAccessLevelV1;
3912
+ accessState: 'available' | 'restricted';
3913
+ relation: 'support' | 'contradiction' | 'gap';
3914
+ freshness: 'current' | 'historical' | 'stale' | 'unknown';
3915
+ confidence: number;
3916
+ summary: string | null;
3917
+ limitations: string[];
3918
+ }>;
3919
+ omissions: Array<{
3920
+ classification: OperateExperienceAccessLevelV1;
3921
+ count: number;
3922
+ reason:
3923
+ | 'access-denied'
3924
+ | 'hidden-reasoning-excluded'
3925
+ | 'raw-prompt-excluded'
3926
+ | 'rejected-advice-excluded'
3927
+ | 'restricted-body-excluded';
3928
+ }>;
3929
+ framing: {
3930
+ title: string;
3931
+ slug: string;
3932
+ problem: string;
3933
+ objective: string;
3934
+ users: string[];
3935
+ scope: string[];
3936
+ nonScope: string[];
3937
+ risks: string[];
3938
+ constraints: string[];
3939
+ requirements: string[];
3940
+ acceptanceOutcomes: string[];
3941
+ };
2054
3942
  metric: { metricId: string; metricHash: string };
2055
- verification: { verificationPlanId: string; verificationPlanHash: string; metricId: string; metricHash: string; baseline: number; target: number; window: string; method: string; revisitConditions: string[] };
2056
- actor: { actorId: string; kind: 'human' }; preview: { digest: string; issuedAt: string; expiresAt: string };
2057
- planningCommand: 'planr operate planning create-spec'; createdAt: string; proposalHash: string;
3943
+ verification: {
3944
+ verificationPlanId: string;
3945
+ verificationPlanHash: string;
3946
+ metricId: string;
3947
+ metricHash: string;
3948
+ baseline: number;
3949
+ target: number;
3950
+ window: string;
3951
+ method: string;
3952
+ revisitConditions: string[];
3953
+ };
3954
+ actor: { actorId: string; kind: 'human' };
3955
+ preview: { digest: string; issuedAt: string; expiresAt: string };
3956
+ planningCommand: 'planr operate planning create-spec';
3957
+ createdAt: string;
3958
+ proposalHash: string;
2058
3959
  }
2059
3960
  export interface OperatingOriginV1 {
2060
- kind: 'operating-origin'; schemaVersion: '1.0.0'; protocolVersion: '2.0.0'; correlationId: string; proposalId: string; proposalRevision: 2; proposalHash: string;
2061
- scopeId: string; domainId: string; domainVersion: string; cycleId: string; eventHead: OperateExperienceEventHeadV1;
2062
- decision: { id: string; revision: number; hash: string }; action: { id: string; revision: number; hash: string };
2063
- metric: { metricId: string; metricHash: string }; verification: { verificationPlanId: string; verificationPlanHash: string; metricId: string; metricHash: string; window: string };
2064
- evidence: Array<{ evidenceRefId: string; artifactId: string; artifactHash: string; classification: OperateExperienceAccessLevelV1; accessState: 'available' | 'restricted' }>;
3961
+ kind: 'operating-origin';
3962
+ schemaVersion: '1.0.0';
3963
+ protocolVersion: '2.0.0';
3964
+ correlationId: string;
3965
+ proposalId: string;
3966
+ proposalRevision: 2;
3967
+ proposalHash: string;
3968
+ scopeId: string;
3969
+ domainId: string;
3970
+ domainVersion: string;
3971
+ cycleId: string;
3972
+ eventHead: OperateExperienceEventHeadV1;
3973
+ decision: { id: string; revision: number; hash: string };
3974
+ action: { id: string; revision: number; hash: string };
3975
+ metric: { metricId: string; metricHash: string };
3976
+ verification: {
3977
+ verificationPlanId: string;
3978
+ verificationPlanHash: string;
3979
+ metricId: string;
3980
+ metricHash: string;
3981
+ window: string;
3982
+ };
3983
+ evidence: Array<{
3984
+ evidenceRefId: string;
3985
+ artifactId: string;
3986
+ artifactHash: string;
3987
+ classification: OperateExperienceAccessLevelV1;
3988
+ accessState: 'available' | 'restricted';
3989
+ }>;
2065
3990
  spec: { specId: string; slug: string; contentHash: string; status: 'shaping' };
2066
- actor: { actorId: string; kind: 'human' }; transaction: { transactionId: string; receiptHash: string; planningProvenanceEventId: string };
2067
- createdAt: string; originHash: string;
3991
+ actor: { actorId: string; kind: 'human' };
3992
+ transaction: { transactionId: string; receiptHash: string; planningProvenanceEventId: string };
3993
+ createdAt: string;
3994
+ originHash: string;
2068
3995
  }
2069
3996
  export interface OperatingDeliveryEvidenceV1 {
2070
- kind: 'operating-delivery-evidence'; schemaVersion: '1.0.0'; protocolVersion: '2.0.0'; deliveryEvidenceId: string; correlationId: string; proposalId: string; proposalRevision: 2;
2071
- scopeId: string; domainId: string; domainVersion: string; decision: { id: string; revision: number; hash: string }; action: { id: string; revision: number; hash: string };
2072
- metric: { metricId: string; metricHash: string }; verification: { verificationPlanId: string; verificationPlanHash: string; metricId: string; metricHash: string; window: string }; spec: { specId: string; contentHash: string; originHash: string };
2073
- planRun: { runId: string; runtime: string; packageVersion: string; provenanceEventId: string; provenanceEventHash: string; status: 'succeeded' | 'blocked' | 'failed' | 'skipped' };
2074
- shipRun: { runId: string; runtime: string; packageVersion: string; manifestHash: string; provenanceEventId: string; provenanceEventHash: string; status: 'succeeded' | 'blocked' | 'failed' | 'skipped' }; tasks: Array<{ taskId: string; status: 'done' | 'blocked' | 'failed' | 'skipped'; artifactHash: string }>;
2075
- changedSurfaces: string[]; qa: { status: 'passed' | 'failed' | 'skipped'; reportHash: string | null; summary: string };
2076
- limitations: string[]; artifacts: Array<{ artifactId: string; hash: string; classification: OperateExperienceAccessLevelV1 }>;
2077
- classification: OperateExperienceAccessLevelV1; summary: string; deliveryStatus: 'succeeded' | 'blocked' | 'failed' | 'rolled-back';
2078
- rollback: null | { rollbackPlanId: string; rollbackPlanArtifactId: string; rollbackPlanHash: string; rollbackResultId: string; rollbackResultArtifactId: string; rollbackResultHash: string; rollbackReceiptId: string; rollbackReceiptArtifactId: string; rollbackReceiptHash: string; rollbackProvenanceEventId: string; originalShipRunId: string; rollbackRunId: string; targetBeforeHash: string; targetAfterHash: string; status: 'succeeded'; completedAt: string };
2079
- outcomeStatus: 'verification-required'; createdAt: string; deliveryEvidenceHash: string;
3997
+ kind: 'operating-delivery-evidence';
3998
+ schemaVersion: '1.0.0';
3999
+ protocolVersion: '2.0.0';
4000
+ deliveryEvidenceId: string;
4001
+ correlationId: string;
4002
+ proposalId: string;
4003
+ proposalRevision: 2;
4004
+ scopeId: string;
4005
+ domainId: string;
4006
+ domainVersion: string;
4007
+ decision: { id: string; revision: number; hash: string };
4008
+ action: { id: string; revision: number; hash: string };
4009
+ metric: { metricId: string; metricHash: string };
4010
+ verification: {
4011
+ verificationPlanId: string;
4012
+ verificationPlanHash: string;
4013
+ metricId: string;
4014
+ metricHash: string;
4015
+ window: string;
4016
+ };
4017
+ spec: { specId: string; contentHash: string; originHash: string };
4018
+ planRun: {
4019
+ runId: string;
4020
+ runtime: string;
4021
+ packageVersion: string;
4022
+ provenanceEventId: string;
4023
+ provenanceEventHash: string;
4024
+ status: 'succeeded' | 'blocked' | 'failed' | 'skipped';
4025
+ };
4026
+ shipRun: {
4027
+ runId: string;
4028
+ runtime: string;
4029
+ packageVersion: string;
4030
+ manifestHash: string;
4031
+ provenanceEventId: string;
4032
+ provenanceEventHash: string;
4033
+ status: 'succeeded' | 'blocked' | 'failed' | 'skipped';
4034
+ };
4035
+ tasks: Array<{
4036
+ taskId: string;
4037
+ status: 'done' | 'blocked' | 'failed' | 'skipped';
4038
+ artifactHash: string;
4039
+ }>;
4040
+ changedSurfaces: string[];
4041
+ qa: { status: 'passed' | 'failed' | 'skipped'; reportHash: string | null; summary: string };
4042
+ limitations: string[];
4043
+ artifacts: Array<{
4044
+ artifactId: string;
4045
+ hash: string;
4046
+ classification: OperateExperienceAccessLevelV1;
4047
+ }>;
4048
+ classification: OperateExperienceAccessLevelV1;
4049
+ summary: string;
4050
+ deliveryStatus: 'succeeded' | 'blocked' | 'failed' | 'rolled-back';
4051
+ rollback: null | {
4052
+ rollbackPlanId: string;
4053
+ rollbackPlanArtifactId: string;
4054
+ rollbackPlanHash: string;
4055
+ rollbackResultId: string;
4056
+ rollbackResultArtifactId: string;
4057
+ rollbackResultHash: string;
4058
+ rollbackReceiptId: string;
4059
+ rollbackReceiptArtifactId: string;
4060
+ rollbackReceiptHash: string;
4061
+ rollbackProvenanceEventId: string;
4062
+ originalShipRunId: string;
4063
+ rollbackRunId: string;
4064
+ targetBeforeHash: string;
4065
+ targetAfterHash: string;
4066
+ status: 'succeeded';
4067
+ completedAt: string;
4068
+ };
4069
+ outcomeStatus: 'verification-required';
4070
+ createdAt: string;
4071
+ deliveryEvidenceHash: string;
2080
4072
  }
2081
4073
 
2082
4074
  export const OPERATE_RUNTIME_PROTOCOL_VERSION: '2.0.0';
@@ -2265,7 +4257,11 @@ export const OPERATE_GOVERNED_EXECUTION_CONTRACT_KINDS_V2: readonly [
2265
4257
  'operating-rollback-plan',
2266
4258
  'operating-rollback-result',
2267
4259
  ];
2268
- export const OPERATE_GOVERNED_PROVIDER_REGISTRATION_CONTRACT_KINDS_V2: readonly ['operate-capability-provider-registration', 'operate-executor-registration', 'operate-policy-provider-registration'];
4260
+ export const OPERATE_GOVERNED_PROVIDER_REGISTRATION_CONTRACT_KINDS_V2: readonly [
4261
+ 'operate-capability-provider-registration',
4262
+ 'operate-executor-registration',
4263
+ 'operate-policy-provider-registration',
4264
+ ];
2269
4265
  export const OPERATE_GOVERNED_EFFECT_CLASSES_V2: readonly OperateGovernedEffectClassV2[];
2270
4266
  export const OPERATE_GOVERNED_POLICY_OUTCOMES_V2: readonly OperateGovernedPolicyOutcomeV2[];
2271
4267
  export const OPERATE_GOVERNED_POLICY_TIERS_V2: readonly [
@@ -2274,32 +4270,70 @@ export const OPERATE_GOVERNED_POLICY_TIERS_V2: readonly [
2274
4270
  Readonly<{ id: 'domain'; precedence: 100; narrowingOnly: true }>,
2275
4271
  ];
2276
4272
  export const OPERATE_GOVERNED_CORE_PROHIBITIONS_V2: readonly [
2277
- 'credential-change', 'customer-contact', 'destructive', 'funds-transfer', 'payment-transfer',
2278
- 'production-deploy', 'production-merge', 'publication', 'secret-mutation',
4273
+ 'credential-change',
4274
+ 'customer-contact',
4275
+ 'destructive',
4276
+ 'funds-transfer',
4277
+ 'payment-transfer',
4278
+ 'production-deploy',
4279
+ 'production-merge',
4280
+ 'publication',
4281
+ 'secret-mutation',
2279
4282
  ];
2280
4283
  export const OPERATE_GOVERNED_RECOVERY_CLASSIFICATIONS_V2: readonly [
2281
- 'applied', 'not-applied', 'partial', 'unknown',
4284
+ 'applied',
4285
+ 'not-applied',
4286
+ 'partial',
4287
+ 'unknown',
2282
4288
  ];
2283
4289
  export const OPERATE_EXPERIENCE_CONTRACT_KINDS_V2: readonly [
2284
- 'operate-experience-live-patch', 'operate-experience-preview', 'operate-experience-view', 'operate-review-display-workspace',
2285
- 'operating-delivery-evidence', 'operating-delivery-route', 'operating-origin', 'operating-planning-proposal',
4290
+ 'operate-experience-live-patch',
4291
+ 'operate-experience-preview',
4292
+ 'operate-experience-view',
4293
+ 'operate-review-display-workspace',
4294
+ 'operating-delivery-evidence',
4295
+ 'operating-delivery-route',
4296
+ 'operating-origin',
4297
+ 'operating-planning-proposal',
2286
4298
  ];
2287
4299
  export const OPERATING_DELIVERY_ROUTES_V1: readonly [
2288
- 'contained-execution', 'human-external', 'observe-only', 'planning-work',
4300
+ 'contained-execution',
4301
+ 'human-external',
4302
+ 'observe-only',
4303
+ 'planning-work',
2289
4304
  ];
2290
4305
  export function findOperateCoreProhibitionV2(
2291
4306
  values: string | readonly string[],
2292
- ): typeof OPERATE_GOVERNED_CORE_PROHIBITIONS_V2[number] | null;
4307
+ ): (typeof OPERATE_GOVERNED_CORE_PROHIBITIONS_V2)[number] | null;
2293
4308
  export const OPERATE_GOVERNED_OPERATION_STATES_V2: readonly OperateGovernedOperationStateV2[];
2294
4309
  export const OPERATE_GOVERNED_OPERATION_TERMINAL_STATES_V2: readonly [
2295
- 'blocked', 'failed', 'partial', 'succeeded', 'uncertain',
4310
+ 'blocked',
4311
+ 'failed',
4312
+ 'partial',
4313
+ 'succeeded',
4314
+ 'uncertain',
2296
4315
  ];
2297
4316
  export const OPERATE_EXECUTION_VERIFICATION_STATUSES_V2: readonly OperatingExecutionVerificationStatusV2[];
2298
4317
  export const OPERATE_HYPOTHESIS_VERIFICATION_STATUSES_V2: readonly OperatingHypothesisVerificationStatusV2[];
2299
4318
  export const OPERATE_GOVERNED_TOOL_OPERATIONS_V2: readonly [
2300
- Readonly<{ id: 'operate.action.approve'; effect: 'project-write'; argumentProfile: 'action-approve'; docsSection: 'action-approve' }>,
2301
- Readonly<{ id: 'operate.action.execute'; effect: 'project-write'; argumentProfile: 'action-execute'; docsSection: 'action-execute' }>,
2302
- Readonly<{ id: 'operate.action.rollback'; effect: 'project-write'; argumentProfile: 'action-rollback'; docsSection: 'action-rollback' }>,
4319
+ Readonly<{
4320
+ id: 'operate.action.approve';
4321
+ effect: 'project-write';
4322
+ argumentProfile: 'action-approve';
4323
+ docsSection: 'action-approve';
4324
+ }>,
4325
+ Readonly<{
4326
+ id: 'operate.action.execute';
4327
+ effect: 'project-write';
4328
+ argumentProfile: 'action-execute';
4329
+ docsSection: 'action-execute';
4330
+ }>,
4331
+ Readonly<{
4332
+ id: 'operate.action.rollback';
4333
+ effect: 'project-write';
4334
+ argumentProfile: 'action-rollback';
4335
+ docsSection: 'action-rollback';
4336
+ }>,
2303
4337
  ];
2304
4338
  export const OPERATE_AUTHORITY_GUARD_IDS_V2: readonly [
2305
4339
  'action-approval-authorized',
@@ -2307,7 +4341,9 @@ export const OPERATE_AUTHORITY_GUARD_IDS_V2: readonly [
2307
4341
  'action-rollback-authorized',
2308
4342
  'review-submit-authorized',
2309
4343
  ];
2310
- export const OPERATE_PUBLIC_DOMAIN_CONTRACT_BINDINGS_V2: Readonly<Record<'business' | 'software', PublicOperateDomainContractBindingV2>>;
4344
+ export const OPERATE_PUBLIC_DOMAIN_CONTRACT_BINDINGS_V2: Readonly<
4345
+ Record<'business' | 'software', PublicOperateDomainContractBindingV2>
4346
+ >;
2311
4347
  export const PROTOCOL_SCHEMA_REGISTRY: Readonly<Record<string, Readonly<Record<string, string>>>>;
2312
4348
 
2313
4349
  export function loadProtocolContract(
@@ -2315,35 +4351,35 @@ export function loadProtocolContract(
2315
4351
  options: { protocolVersion: string },
2316
4352
  ): ProtocolSchemaContract;
2317
4353
  export function loadOperateRuntimeContract(
2318
- kind: typeof OPERATE_RUNTIME_CONTRACT_KINDS[number],
4354
+ kind: (typeof OPERATE_RUNTIME_CONTRACT_KINDS)[number],
2319
4355
  options: { protocolVersion: '2.0.0' },
2320
4356
  ): ProtocolSchemaContract;
2321
4357
  export function loadOperateLiveEvidenceContract(
2322
- kind: typeof OPERATE_LIVE_EVIDENCE_CONTRACT_KINDS_V2[number],
4358
+ kind: (typeof OPERATE_LIVE_EVIDENCE_CONTRACT_KINDS_V2)[number],
2323
4359
  options: { protocolVersion: '2.0.0' },
2324
4360
  ): ProtocolSchemaContract;
2325
4361
  export function loadLandingContract(
2326
- kind: typeof LANDING_CONTRACT_KINDS_V1[number],
4362
+ kind: (typeof LANDING_CONTRACT_KINDS_V1)[number],
2327
4363
  options: { protocolVersion: '1.2.0' },
2328
4364
  ): ProtocolSchemaContract;
2329
4365
  export function loadReleaseLedgerContract(
2330
- kind: typeof RELEASE_LEDGER_CONTRACT_KINDS_V1[number],
4366
+ kind: (typeof RELEASE_LEDGER_CONTRACT_KINDS_V1)[number],
2331
4367
  options: { protocolVersion: '1.3.0' },
2332
4368
  ): ProtocolSchemaContract;
2333
4369
  export function loadOperateExtensionContract(
2334
- kind: typeof OPERATE_EXTENSION_CONTRACT_KINDS_V2[number],
4370
+ kind: (typeof OPERATE_EXTENSION_CONTRACT_KINDS_V2)[number],
2335
4371
  options: { protocolVersion: '2.0.0' },
2336
4372
  ): ProtocolSchemaContract;
2337
4373
  export function loadOperateEvidenceContract(
2338
- kind: typeof OPERATE_EVIDENCE_CONTRACT_KINDS_V2[number],
4374
+ kind: (typeof OPERATE_EVIDENCE_CONTRACT_KINDS_V2)[number],
2339
4375
  options: { protocolVersion: '2.0.0' },
2340
4376
  ): ProtocolSchemaContract;
2341
4377
  export function loadOperateOperatingIntelligenceContract(
2342
- kind: typeof OPERATE_OPERATING_INTELLIGENCE_CONTRACT_KINDS_V2[number],
4378
+ kind: (typeof OPERATE_OPERATING_INTELLIGENCE_CONTRACT_KINDS_V2)[number],
2343
4379
  options: { protocolVersion: '2.0.0' },
2344
4380
  ): ProtocolSchemaContract;
2345
4381
  export function loadOperateGovernedExecutionContract(
2346
- kind: typeof OPERATE_GOVERNED_EXECUTION_CONTRACT_KINDS_V2[number],
4382
+ kind: (typeof OPERATE_GOVERNED_EXECUTION_CONTRACT_KINDS_V2)[number],
2347
4383
  options: { protocolVersion: '2.0.0' },
2348
4384
  ): ProtocolSchemaContract;
2349
4385
  export function readOperatingGovernedOperationV2(
@@ -2363,17 +4399,29 @@ export function readOperatingRollbackResultV2(
2363
4399
  options: { protocolVersion: '2.0.0' },
2364
4400
  ): OperatingRollbackResultV2;
2365
4401
  export function loadOperateGovernedExtensionContract(
2366
- kind: typeof OPERATE_GOVERNED_PROVIDER_REGISTRATION_CONTRACT_KINDS_V2[number],
4402
+ kind: (typeof OPERATE_GOVERNED_PROVIDER_REGISTRATION_CONTRACT_KINDS_V2)[number],
2367
4403
  options: { protocolVersion: '2.0.0' },
2368
4404
  ): ProtocolSchemaContract;
2369
4405
  export function loadOperateExperienceContract(
2370
- kind: typeof OPERATE_EXPERIENCE_CONTRACT_KINDS_V2[number],
4406
+ kind: (typeof OPERATE_EXPERIENCE_CONTRACT_KINDS_V2)[number],
2371
4407
  options: { protocolVersion: '2.0.0' },
2372
4408
  ): ProtocolSchemaContract;
2373
- export function readOperateExperienceViewV1(value: unknown, options: { protocolVersion: '2.0.0' }): OperateExperienceViewV1;
2374
- export function readOperatingPlanningProposalV1(value: unknown, options: { protocolVersion: '2.0.0' }): OperatingPlanningProposalV1;
2375
- export function readOperatingOriginV1(value: unknown, options: { protocolVersion: '2.0.0' }): OperatingOriginV1;
2376
- export function readOperatingDeliveryEvidenceV1(value: unknown, options: { protocolVersion: '2.0.0' }): OperatingDeliveryEvidenceV1;
4409
+ export function readOperateExperienceViewV1(
4410
+ value: unknown,
4411
+ options: { protocolVersion: '2.0.0' },
4412
+ ): OperateExperienceViewV1;
4413
+ export function readOperatingPlanningProposalV1(
4414
+ value: unknown,
4415
+ options: { protocolVersion: '2.0.0' },
4416
+ ): OperatingPlanningProposalV1;
4417
+ export function readOperatingOriginV1(
4418
+ value: unknown,
4419
+ options: { protocolVersion: '2.0.0' },
4420
+ ): OperatingOriginV1;
4421
+ export function readOperatingDeliveryEvidenceV1(
4422
+ value: unknown,
4423
+ options: { protocolVersion: '2.0.0' },
4424
+ ): OperatingDeliveryEvidenceV1;
2377
4425
  export function loadOperateRoleMandate(
2378
4426
  roleId: OperatePhase1AssignmentKindV2,
2379
4427
  options: { roleVersion: '2.0.0' },
@@ -2406,18 +4454,26 @@ export function assertOperateRuntimeBindingsV2(input: {
2406
4454
  checkpoint: OperatingCheckpointV2;
2407
4455
  };
2408
4456
 
2409
- export function listProtocolSchemas(): Array<{ kind: string; protocolVersion: string; path: string }>;
4457
+ export function listProtocolSchemas(): Array<{
4458
+ kind: string;
4459
+ protocolVersion: string;
4460
+ path: string;
4461
+ }>;
2410
4462
  export function resolveProtocolSchema(
2411
4463
  kind: string,
2412
4464
  options: { protocolVersion: string },
2413
4465
  ): ProtocolSchemaContract;
2414
4466
  export function resolveOperateExperienceSchemaV2(
2415
- kind: typeof OPERATE_EXPERIENCE_CONTRACT_KINDS_V2[number],
4467
+ kind: (typeof OPERATE_EXPERIENCE_CONTRACT_KINDS_V2)[number],
2416
4468
  options: { protocolVersion: '2.0.0' },
2417
4469
  ): ProtocolSchemaContract;
2418
- export function assertOperateExperienceArtifactV2<T>(kind: typeof OPERATE_EXPERIENCE_CONTRACT_KINDS_V2[number], value: T): T;
4470
+ export function assertOperateExperienceArtifactV2<T>(
4471
+ kind: (typeof OPERATE_EXPERIENCE_CONTRACT_KINDS_V2)[number],
4472
+ value: T,
4473
+ ): T;
2419
4474
  export function validateOperateExperienceArtifactV2(
2420
- kind: typeof OPERATE_EXPERIENCE_CONTRACT_KINDS_V2[number], value: unknown,
4475
+ kind: (typeof OPERATE_EXPERIENCE_CONTRACT_KINDS_V2)[number],
4476
+ value: unknown,
2421
4477
  ): ProtocolValidationError[];
2422
4478
  export function validateProtocolArtifact(
2423
4479
  kind: string,
@@ -2432,7 +4488,7 @@ export function assertProtocolArtifact<T>(
2432
4488
  options?: { protocolVersion?: string },
2433
4489
  ): T;
2434
4490
  export function assertOperateGovernedExtensionRegistrationV2<T>(
2435
- kind: typeof OPERATE_GOVERNED_PROVIDER_REGISTRATION_CONTRACT_KINDS_V2[number],
4491
+ kind: (typeof OPERATE_GOVERNED_PROVIDER_REGISTRATION_CONTRACT_KINDS_V2)[number],
2436
4492
  value: T,
2437
4493
  ): T;
2438
4494
  export function canonicalizeJson(value: JsonValue): string;
@@ -2447,22 +4503,62 @@ export function sha256Jcs(value: JsonValue): string;
2447
4503
  */
2448
4504
 
2449
4505
  export type OperatingTraceNodeKindV2 =
2450
- | 'requirement' | 'absence' | 'seat' | 'assignment' | 'artifact' | 'claim'
2451
- | 'evidence-ref' | 'finding' | 'decision' | 'action' | 'disposition'
2452
- | 'verification' | 'outcome';
4506
+ | 'requirement'
4507
+ | 'absence'
4508
+ | 'seat'
4509
+ | 'assignment'
4510
+ | 'artifact'
4511
+ | 'claim'
4512
+ | 'evidence-ref'
4513
+ | 'finding'
4514
+ | 'decision'
4515
+ | 'action'
4516
+ | 'disposition'
4517
+ | 'verification'
4518
+ | 'outcome';
2453
4519
 
2454
4520
  export type OperatingTraceProofStateV2 =
2455
- | 'not-applicable' | 'pending' | 'terminal' | 'accepted' | 'rejected' | 'failed'
2456
- | 'abandoned' | 'verified' | 'stale' | 'supported' | 'contradicted' | 'contested'
2457
- | 'unverified' | 'absent' | 'restricted' | 'proposed' | 'governed' | 'completed'
4521
+ | 'not-applicable'
4522
+ | 'pending'
4523
+ | 'terminal'
4524
+ | 'accepted'
4525
+ | 'rejected'
4526
+ | 'failed'
4527
+ | 'abandoned'
4528
+ | 'verified'
4529
+ | 'stale'
4530
+ | 'supported'
4531
+ | 'contradicted'
4532
+ | 'contested'
4533
+ | 'unverified'
4534
+ | 'absent'
4535
+ | 'restricted'
4536
+ | 'proposed'
4537
+ | 'governed'
4538
+ | 'completed'
2458
4539
  | 'insufficient';
2459
4540
 
2460
4541
  export type OperatingTraceRelationV2 =
2461
- | 'declares' | 'assigned-to' | 'issued-as' | 'records' | 'produces' | 'contains'
2462
- | 'supported-by' | 'contradicted-by' | 'informs' | 'challenges' | 'decides'
2463
- | 'proposes' | 'disposes' | 'governed-by' | 'verified-by' | 'observed-as';
4542
+ | 'declares'
4543
+ | 'assigned-to'
4544
+ | 'issued-as'
4545
+ | 'records'
4546
+ | 'produces'
4547
+ | 'contains'
4548
+ | 'supported-by'
4549
+ | 'contradicted-by'
4550
+ | 'informs'
4551
+ | 'challenges'
4552
+ | 'decides'
4553
+ | 'proposes'
4554
+ | 'disposes'
4555
+ | 'governed-by'
4556
+ | 'verified-by'
4557
+ | 'observed-as';
2464
4558
 
2465
- export interface OperatingTraceLocatorV2<TKind extends OperatingTraceNodeKindV2 = OperatingTraceNodeKindV2> {
4559
+ export interface OperatingTraceLocatorV2<
4560
+ TKind extends OperatingTraceNodeKindV2 = OperatingTraceNodeKindV2,
4561
+ > {
2466
4562
  readonly kind: TKind;
2467
4563
  readonly id: string;
2468
4564
  readonly contract: Readonly<{ id: string; version: '2.0.0' }>;
@@ -2487,9 +4583,15 @@ export type OperatingTraceNodeV2 =
2487
4583
  | OperatingTraceNodeBaseV2<'requirement', 'pending'>
2488
4584
  | OperatingTraceNodeBaseV2<'absence', 'absent'>
2489
4585
  | OperatingTraceNodeBaseV2<'seat', 'not-applicable' | 'absent'>
2490
- | OperatingTraceNodeBaseV2<'assignment', 'pending' | 'terminal' | 'rejected' | 'failed' | 'abandoned'>
4586
+ | OperatingTraceNodeBaseV2<
4587
+ 'assignment',
4588
+ 'pending' | 'terminal' | 'rejected' | 'failed' | 'abandoned'
4589
+ >
2491
4590
  | OperatingTraceNodeBaseV2<'artifact', 'accepted' | 'restricted'>
2492
- | OperatingTraceNodeBaseV2<'claim', 'supported' | 'contradicted' | 'contested' | 'unverified' | 'restricted'>
4591
+ | OperatingTraceNodeBaseV2<
4592
+ 'claim',
4593
+ 'supported' | 'contradicted' | 'contested' | 'unverified' | 'restricted'
4594
+ >
2493
4595
  | OperatingTraceNodeBaseV2<'evidence-ref', 'verified' | 'stale' | 'unverified' | 'restricted'>
2494
4596
  | OperatingTraceNodeBaseV2<'finding', 'proposed' | 'restricted'>
2495
4597
  | OperatingTraceNodeBaseV2<'decision', 'proposed' | 'governed' | 'restricted'>
@@ -2498,7 +4600,9 @@ export type OperatingTraceNodeV2 =
2498
4600
  | OperatingTraceNodeBaseV2<'verification', 'governed'>
2499
4601
  | OperatingTraceNodeBaseV2<'outcome', 'verified' | 'insufficient'>;
2500
4602
 
2501
- export interface OperatingTraceEndpointV2<TKind extends OperatingTraceNodeKindV2 = OperatingTraceNodeKindV2> {
4603
+ export interface OperatingTraceEndpointV2<
4604
+ TKind extends OperatingTraceNodeKindV2 = OperatingTraceNodeKindV2,
4605
+ > {
2502
4606
  readonly kind: TKind;
2503
4607
  readonly id: string;
2504
4608
  }