@openplanr/protocol 0.2.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 (334) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +82 -0
  3. package/lib/dashboard/closed-json-contract.mjs +141 -0
  4. package/lib/dashboard/generated/operate-experience-surface-schema-data.mjs +67 -0
  5. package/lib/dashboard/generated/operate-review-schema-data.mjs +35 -0
  6. package/lib/dashboard/generated/operate-schema-token-codec.mjs +127 -0
  7. package/lib/dashboard/operate-experience-audit-display-contract.d.mts +196 -0
  8. package/lib/dashboard/operate-experience-audit-display-contract.mjs +700 -0
  9. package/lib/dashboard/operate-experience-display-contract.d.mts +572 -0
  10. package/lib/dashboard/operate-experience-display-contract.mjs +1007 -0
  11. package/lib/dashboard/operate-experience-surface-contract.d.mts +157 -0
  12. package/lib/dashboard/operate-experience-surface-contract.mjs +91 -0
  13. package/lib/dashboard/operate-review-contract.d.mts +34 -0
  14. package/lib/dashboard/operate-review-contract.mjs +175 -0
  15. package/lib/dashboard/operate-review-display-workspace-contract.d.mts +54 -0
  16. package/lib/dashboard/operate-review-display-workspace-contract.mjs +258 -0
  17. package/lib/dashboard/operate-review-payload-safety.d.mts +7 -0
  18. package/lib/dashboard/operate-review-payload-safety.mjs +42 -0
  19. package/lib/dashboard/operate-review-workspace-projection-v2.d.mts +218 -0
  20. package/lib/protocol/index.d.ts +2638 -0
  21. package/package.json +115 -0
  22. package/registries/commands.json +1952 -0
  23. package/registries/diagram-grammars.json +2407 -0
  24. package/registries/diagram-semantic-patterns.json +111 -0
  25. package/registries/output-paths.json +40 -0
  26. package/registries/outputs.json +864 -0
  27. package/registries/roles.json +661 -0
  28. package/registries/rules.json +261 -0
  29. package/registries/skill-host-profiles.json +247 -0
  30. package/registries/skill-modules.json +1112 -0
  31. package/registries/skill-routing.json +389 -0
  32. package/registries/skills.json +1545 -0
  33. package/registries/task-kinds.json +220 -0
  34. package/registry/adapters.json +110 -0
  35. package/registry/artifact-theme.json +60 -0
  36. package/registry/evaluation-graders.json +303 -0
  37. package/registry/evaluation-host-profiles.json +131 -0
  38. package/registry/frozen-commands.json +15 -0
  39. package/registry/landing-operations.json +20 -0
  40. package/registry/landing-workflows.json +70 -0
  41. package/registry/live-evidence-providers.json +1 -0
  42. package/registry/operate-v2-contracts.json +5965 -0
  43. package/registry/professional-skills.json +115 -0
  44. package/registry/roles.json +14 -0
  45. package/registry/ship-review-specialists.json +42 -0
  46. package/schemas/v1.0.0/design-approved.schema.json +35 -0
  47. package/schemas/v1.0.0/design-feedback.schema.json +169 -0
  48. package/schemas/v1.0.0/design-manifest.schema.json +90 -0
  49. package/schemas/v1.0.0/design-session.schema.json +73 -0
  50. package/schemas/v1.0.0/graph.schema.json +100 -0
  51. package/schemas/v1.0.0/pipeline-shipped.schema.json +154 -0
  52. package/schemas/v1.0.0/run-manifest.schema.json +81 -0
  53. package/schemas/v1.0.0/spec.schema.json +120 -0
  54. package/schemas/v1.0.0/stack.schema.json +184 -0
  55. package/schemas/v1.0.0/story.schema.json +95 -0
  56. package/schemas/v1.0.0/task.schema.json +171 -0
  57. package/schemas/v1.0.0/taste-profile.schema.json +96 -0
  58. package/schemas/v1.1.0/adapter-registry.schema.json +72 -0
  59. package/schemas/v1.1.0/artifact-envelope.schema.json +142 -0
  60. package/schemas/v1.1.0/artifact-paste.schema.json +49 -0
  61. package/schemas/v1.1.0/artifact-review.schema.json +97 -0
  62. package/schemas/v1.1.0/artifact-room-descriptor.schema.json +39 -0
  63. package/schemas/v1.1.0/artifact-room-event.schema.json +184 -0
  64. package/schemas/v1.1.0/artifact-room-signed-event.schema.json +58 -0
  65. package/schemas/v1.1.0/artifact-theme.schema.json +139 -0
  66. package/schemas/v1.1.0/browser-qa-gate.schema.json +21 -0
  67. package/schemas/v1.1.0/browser-qa-result.schema.json +24 -0
  68. package/schemas/v1.1.0/browser-qa-session.schema.json +12 -0
  69. package/schemas/v1.1.0/ecosystem-manifest.schema.json +46 -0
  70. package/schemas/v1.1.0/investigation-diagnosis.schema.json +12 -0
  71. package/schemas/v1.1.0/investigation-event.schema.json +15 -0
  72. package/schemas/v1.1.0/investigation-experiment.schema.json +17 -0
  73. package/schemas/v1.1.0/investigation-fix.schema.json +11 -0
  74. package/schemas/v1.1.0/investigation-hypothesis.schema.json +6 -0
  75. package/schemas/v1.1.0/investigation-observation.schema.json +10 -0
  76. package/schemas/v1.1.0/investigation-receipt.schema.json +7 -0
  77. package/schemas/v1.1.0/investigation-record.schema.json +7 -0
  78. package/schemas/v1.1.0/investigation-request.schema.json +34 -0
  79. package/schemas/v1.1.0/planning-review-event.schema.json +64 -0
  80. package/schemas/v1.1.0/planning-review-receipt.schema.json +19 -0
  81. package/schemas/v1.1.0/planning-review-record.schema.json +176 -0
  82. package/schemas/v1.1.0/planning-review-state.schema.json +19 -0
  83. package/schemas/v1.1.0/professional-skills.schema.json +105 -0
  84. package/schemas/v1.1.0/professional-specification.schema.json +111 -0
  85. package/schemas/v1.1.0/provenance-event.schema.json +82 -0
  86. package/schemas/v1.1.0/role-registry.schema.json +28 -0
  87. package/schemas/v1.1.0/runtime-lock.schema.json +39 -0
  88. package/schemas/v1.1.0/ship-closure.schema.json +353 -0
  89. package/schemas/v1.1.0/ship-review-specialist-registry.schema.json +29 -0
  90. package/schemas/v1.1.0/ship-risk-classification.schema.json +48 -0
  91. package/schemas/v1.1.0/specialist-review-result.schema.json +19 -0
  92. package/schemas/v1.10.0/design-review-bundle.schema.json +584 -0
  93. package/schemas/v1.10.0/design-review-context.schema.json +191 -0
  94. package/schemas/v1.10.0/design-review-handoff.schema.json +407 -0
  95. package/schemas/v1.10.0/design-review-metadata-payload.schema.json +106 -0
  96. package/schemas/v1.11.0/design-review-metadata-payload.schema.json +107 -0
  97. package/schemas/v1.12.0/enterprise-access-context.schema.json +217 -0
  98. package/schemas/v1.12.0/enterprise-agent-handoff.schema.json +508 -0
  99. package/schemas/v1.12.0/enterprise-artifact-revision.schema.json +87 -0
  100. package/schemas/v1.12.0/enterprise-change-proposal.schema.json +359 -0
  101. package/schemas/v1.12.0/enterprise-evidence-reference.schema.json +147 -0
  102. package/schemas/v1.12.0/enterprise-review-thread.schema.json +278 -0
  103. package/schemas/v1.12.0/enterprise-sync-state.schema.json +169 -0
  104. package/schemas/v1.2.0/adapter-registry.schema.json +83 -0
  105. package/schemas/v1.2.0/dashboard-bootstrap.schema.json +219 -0
  106. package/schemas/v1.2.0/ecosystem-release-operation.schema.json +90 -0
  107. package/schemas/v1.2.0/ecosystem-saga.schema.json +54 -0
  108. package/schemas/v1.2.0/evidence-diagnostic.schema.json +77 -0
  109. package/schemas/v1.2.0/guided-answer-envelope.schema.json +73 -0
  110. package/schemas/v1.2.0/guided-confirmation.schema.json +128 -0
  111. package/schemas/v1.2.0/guided-question.schema.json +242 -0
  112. package/schemas/v1.2.0/guided-questionnaire.schema.json +278 -0
  113. package/schemas/v1.2.0/guided-session.schema.json +141 -0
  114. package/schemas/v1.2.0/landing-confirmation.schema.json +17 -0
  115. package/schemas/v1.2.0/landing-event.schema.json +12 -0
  116. package/schemas/v1.2.0/landing-operation-registry.schema.json +16 -0
  117. package/schemas/v1.2.0/landing-phase-receipt.schema.json +19 -0
  118. package/schemas/v1.2.0/landing-plan.schema.json +36 -0
  119. package/schemas/v1.2.0/landing-receipt.schema.json +12 -0
  120. package/schemas/v1.2.0/landing-workflow-catalog.schema.json +143 -0
  121. package/schemas/v1.2.0/operate-action-display-workspace.schema.json +119 -0
  122. package/schemas/v1.2.0/operate-cycle-display-workspace.schema.json +109 -0
  123. package/schemas/v1.2.0/operate-executive-board-display-surface.schema.json +72 -0
  124. package/schemas/v1.2.0/operate-experience-audit-display-surface.schema.json +328 -0
  125. package/schemas/v1.2.0/operate-experience-display-surface.schema.json +46 -0
  126. package/schemas/v1.2.0/operate-experience-surface.schema.json +590 -0
  127. package/schemas/v1.2.0/operate-recovery-display-surface.schema.json +85 -0
  128. package/schemas/v1.2.0/structured-action.schema.json +91 -0
  129. package/schemas/v1.3.0/adapter-registry.schema.json +84 -0
  130. package/schemas/v1.3.0/ecosystem-manifest.schema.json +120 -0
  131. package/schemas/v1.3.0/release-compatibility-claim.schema.json +46 -0
  132. package/schemas/v1.3.0/release-ledger-receipt.schema.json +45 -0
  133. package/schemas/v1.3.0/release-ledger.schema.json +60 -0
  134. package/schemas/v1.4.0/adapter-registry.schema.json +62 -0
  135. package/schemas/v1.4.0/evaluation-aggregate-report.schema.json +166 -0
  136. package/schemas/v1.4.0/evaluation-budget.schema.json +49 -0
  137. package/schemas/v1.4.0/evaluation-corpus.schema.json +93 -0
  138. package/schemas/v1.4.0/evaluation-fixture.schema.json +64 -0
  139. package/schemas/v1.4.0/evaluation-gate-policy.schema.json +33 -0
  140. package/schemas/v1.4.0/evaluation-grader-registration.schema.json +141 -0
  141. package/schemas/v1.4.0/evaluation-grader-registry.schema.json +20 -0
  142. package/schemas/v1.4.0/evaluation-host-profile-registry.schema.json +20 -0
  143. package/schemas/v1.4.0/evaluation-host-profile.schema.json +73 -0
  144. package/schemas/v1.4.0/evaluation-observation.schema.json +76 -0
  145. package/schemas/v1.4.0/evaluation-run-result.schema.json +84 -0
  146. package/schemas/v1.4.0/evaluation-scenario.schema.json +231 -0
  147. package/schemas/v1.4.0/evaluation-waiver.schema.json +65 -0
  148. package/schemas/v1.4.0/skill-certification-receipt.schema.json +103 -0
  149. package/schemas/v1.5.0/command-catalog.schema.json +296 -0
  150. package/schemas/v1.5.0/common.schema.json +261 -0
  151. package/schemas/v1.5.0/generated-asset-manifest.schema.json +313 -0
  152. package/schemas/v1.5.0/implementation-result.schema.json +152 -0
  153. package/schemas/v1.5.0/migration-preservation-manifest.schema.json +749 -0
  154. package/schemas/v1.5.0/output-catalog.schema.json +210 -0
  155. package/schemas/v1.5.0/output-path-catalog.schema.json +81 -0
  156. package/schemas/v1.5.0/role-registry.schema.json +261 -0
  157. package/schemas/v1.5.0/rule-catalog.schema.json +130 -0
  158. package/schemas/v1.5.0/skill-catalog.schema.json +303 -0
  159. package/schemas/v1.5.0/task-kind-registry.schema.json +167 -0
  160. package/schemas/v1.5.0/task-manifest.schema.json +373 -0
  161. package/schemas/v1.5.0/task-output-manifest.schema.json +462 -0
  162. package/schemas/v1.6.0/common.schema.json +462 -0
  163. package/schemas/v1.6.0/diagram-consumer-reference.schema.json +167 -0
  164. package/schemas/v1.6.0/diagram-document.schema.json +699 -0
  165. package/schemas/v1.6.0/diagram-fidelity-report.schema.json +137 -0
  166. package/schemas/v1.6.0/diagram-manifest.schema.json +162 -0
  167. package/schemas/v1.6.0/diagram-quality-report.schema.json +148 -0
  168. package/schemas/v1.6.0/diagram-review-binding.schema.json +132 -0
  169. package/schemas/v1.6.0/diagram-semantic-pattern-registry.schema.json +90 -0
  170. package/schemas/v1.6.0/diagram-type-registry.schema.json +373 -0
  171. package/schemas/v1.6.0/generated-asset-manifest.schema.json +103 -0
  172. package/schemas/v1.6.0/skill-catalog.schema.json +84 -0
  173. package/schemas/v1.6.0/skill-completion-receipt.schema.json +72 -0
  174. package/schemas/v1.6.0/skill-consent-record.schema.json +74 -0
  175. package/schemas/v1.6.0/skill-host-profile-registry.schema.json +526 -0
  176. package/schemas/v1.6.0/skill-learning-record.schema.json +116 -0
  177. package/schemas/v1.6.0/skill-module-registry.schema.json +108 -0
  178. package/schemas/v1.6.0/skill-routing-registry.schema.json +93 -0
  179. package/schemas/v1.6.0/skill-session.schema.json +73 -0
  180. package/schemas/v1.6.0/skill-source.schema.json +169 -0
  181. package/schemas/v1.7.0/common.schema.json +464 -0
  182. package/schemas/v1.7.0/generated-asset-manifest.schema.json +103 -0
  183. package/schemas/v1.7.0/planning-id-sequence.schema.json +50 -0
  184. package/schemas/v1.7.0/request-authority.schema.json +71 -0
  185. package/schemas/v1.7.0/skill-catalog.schema.json +84 -0
  186. package/schemas/v1.7.0/skill-completion-receipt.schema.json +72 -0
  187. package/schemas/v1.7.0/skill-consent-record.schema.json +74 -0
  188. package/schemas/v1.7.0/skill-host-profile-registry.schema.json +526 -0
  189. package/schemas/v1.7.0/skill-learning-record.schema.json +116 -0
  190. package/schemas/v1.7.0/skill-module-registry.schema.json +108 -0
  191. package/schemas/v1.7.0/skill-routing-registry.schema.json +93 -0
  192. package/schemas/v1.7.0/skill-session.schema.json +73 -0
  193. package/schemas/v1.7.0/skill-source.schema.json +169 -0
  194. package/schemas/v1.7.0/spec.schema.json +117 -0
  195. package/schemas/v1.7.0/story.schema.json +107 -0
  196. package/schemas/v1.7.0/task.schema.json +217 -0
  197. package/schemas/v1.8.0/common.schema.json +96 -0
  198. package/schemas/v1.8.0/skill-package.schema.json +63 -0
  199. package/schemas/v1.8.0/utility-command-catalog.schema.json +82 -0
  200. package/schemas/v1.9.0/design-document.schema.json +306 -0
  201. package/schemas/v1.9.0/design-review-bundle.schema.json +346 -0
  202. package/schemas/v1.9.0/design-review-workspace.schema.json +108 -0
  203. package/schemas/v1.9.0/design-workspace-create.schema.json +170 -0
  204. package/schemas/v1.9.0/design-workspace-event.schema.json +97 -0
  205. package/schemas/v1.9.0/design-workspace-revision.schema.json +56 -0
  206. package/schemas/v2.0.0/agent-runtime-manifest.schema.json +59 -0
  207. package/schemas/v2.0.0/business-operating-snapshot-projection.schema.json +14 -0
  208. package/schemas/v2.0.0/operate-allowed-action.schema.json +181 -0
  209. package/schemas/v2.0.0/operate-api-envelope.schema.json +225 -0
  210. package/schemas/v2.0.0/operate-capability-provider-registration.schema.json +30 -0
  211. package/schemas/v2.0.0/operate-domain-registration.schema.json +284 -0
  212. package/schemas/v2.0.0/operate-evidence-provider-registration.schema.json +55 -0
  213. package/schemas/v2.0.0/operate-evidence-resolver-registration.schema.json +46 -0
  214. package/schemas/v2.0.0/operate-executor-registration.schema.json +27 -0
  215. package/schemas/v2.0.0/operate-experience-live-patch.schema.json +47 -0
  216. package/schemas/v2.0.0/operate-experience-preview.schema.json +51 -0
  217. package/schemas/v2.0.0/operate-experience-view.schema.json +281 -0
  218. package/schemas/v2.0.0/operate-live-evidence-provider-registration.schema.json +48 -0
  219. package/schemas/v2.0.0/operate-live-evidence-provider-registry.schema.json +17 -0
  220. package/schemas/v2.0.0/operate-metric-provider-registration.schema.json +12 -0
  221. package/schemas/v2.0.0/operate-policy-provider-registration.schema.json +33 -0
  222. package/schemas/v2.0.0/operate-review-bound-submission.schema.json +29 -0
  223. package/schemas/v2.0.0/operate-review-display-workspace.schema.json +390 -0
  224. package/schemas/v2.0.0/operate-snapshot-provider-registration.schema.json +16 -0
  225. package/schemas/v2.0.0/operate-tool-call.schema.json +172 -0
  226. package/schemas/v2.0.0/operate-verification-provider-registration.schema.json +12 -0
  227. package/schemas/v2.0.0/operating-action-policy.schema.json +31 -0
  228. package/schemas/v2.0.0/operating-action-verification-plan.schema.json +13 -0
  229. package/schemas/v2.0.0/operating-action.schema.json +86 -0
  230. package/schemas/v2.0.0/operating-advisor-result.schema.json +394 -0
  231. package/schemas/v2.0.0/operating-approval-record.schema.json +23 -0
  232. package/schemas/v2.0.0/operating-approval-requirement.schema.json +31 -0
  233. package/schemas/v2.0.0/operating-artifact.schema.json +52 -0
  234. package/schemas/v2.0.0/operating-assignment.schema.json +437 -0
  235. package/schemas/v2.0.0/operating-assumption.schema.json +16 -0
  236. package/schemas/v2.0.0/operating-capability-availability.schema.json +15 -0
  237. package/schemas/v2.0.0/operating-capability-grant.schema.json +14 -0
  238. package/schemas/v2.0.0/operating-challenger-review.schema.json +204 -0
  239. package/schemas/v2.0.0/operating-checkpoint.schema.json +43 -0
  240. package/schemas/v2.0.0/operating-claim.schema.json +17 -0
  241. package/schemas/v2.0.0/operating-connector-checkpoint.schema.json +28 -0
  242. package/schemas/v2.0.0/operating-context-capture.schema.json +74 -0
  243. package/schemas/v2.0.0/operating-cycle-input-binding.schema.json +30 -0
  244. package/schemas/v2.0.0/operating-cycle.schema.json +42 -0
  245. package/schemas/v2.0.0/operating-decision-ledger.schema.json +237 -0
  246. package/schemas/v2.0.0/operating-decision.schema.json +137 -0
  247. package/schemas/v2.0.0/operating-delivery-evidence.schema.json +46 -0
  248. package/schemas/v2.0.0/operating-delivery-route.schema.json +43 -0
  249. package/schemas/v2.0.0/operating-delta.schema.json +13 -0
  250. package/schemas/v2.0.0/operating-domain-projection.schema.json +15 -0
  251. package/schemas/v2.0.0/operating-event-trigger.schema.json +11 -0
  252. package/schemas/v2.0.0/operating-event.schema.json +505 -0
  253. package/schemas/v2.0.0/operating-evidence-candidate.schema.json +88 -0
  254. package/schemas/v2.0.0/operating-evidence-edge.schema.json +39 -0
  255. package/schemas/v2.0.0/operating-evidence-graph.schema.json +25 -0
  256. package/schemas/v2.0.0/operating-evidence-observation.schema.json +48 -0
  257. package/schemas/v2.0.0/operating-evidence-ref.schema.json +51 -0
  258. package/schemas/v2.0.0/operating-evidence-resolution.schema.json +54 -0
  259. package/schemas/v2.0.0/operating-execution-result.schema.json +23 -0
  260. package/schemas/v2.0.0/operating-executive-board.schema.json +78 -0
  261. package/schemas/v2.0.0/operating-finding.schema.json +116 -0
  262. package/schemas/v2.0.0/operating-governed-operation.schema.json +54 -0
  263. package/schemas/v2.0.0/operating-intelligence-input-bundle.schema.json +128 -0
  264. package/schemas/v2.0.0/operating-intelligence-plan.schema.json +302 -0
  265. package/schemas/v2.0.0/operating-learning-receipt.schema.json +31 -0
  266. package/schemas/v2.0.0/operating-learning.schema.json +13 -0
  267. package/schemas/v2.0.0/operating-live-evidence-consent-record.schema.json +42 -0
  268. package/schemas/v2.0.0/operating-live-evidence-ingestion.schema.json +31 -0
  269. package/schemas/v2.0.0/operating-measurement-plan.schema.json +18 -0
  270. package/schemas/v2.0.0/operating-measurement-schedule-receipt.schema.json +7 -0
  271. package/schemas/v2.0.0/operating-measurement-schedule.schema.json +16 -0
  272. package/schemas/v2.0.0/operating-metric-observation.schema.json +15 -0
  273. package/schemas/v2.0.0/operating-metric.schema.json +18 -0
  274. package/schemas/v2.0.0/operating-model-state.schema.json +36 -0
  275. package/schemas/v2.0.0/operating-objective.schema.json +21 -0
  276. package/schemas/v2.0.0/operating-origin.schema.json +31 -0
  277. package/schemas/v2.0.0/operating-outcome-evaluation.schema.json +46 -0
  278. package/schemas/v2.0.0/operating-outcome.schema.json +13 -0
  279. package/schemas/v2.0.0/operating-planning-proposal.schema.json +45 -0
  280. package/schemas/v2.0.0/operating-policy-evaluation.schema.json +28 -0
  281. package/schemas/v2.0.0/operating-review-read.schema.json +217 -0
  282. package/schemas/v2.0.0/operating-review-receipt.schema.json +64 -0
  283. package/schemas/v2.0.0/operating-review.schema.json +47 -0
  284. package/schemas/v2.0.0/operating-risk.schema.json +96 -0
  285. package/schemas/v2.0.0/operating-rollback-plan.schema.json +10 -0
  286. package/schemas/v2.0.0/operating-rollback-result.schema.json +20 -0
  287. package/schemas/v2.0.0/operating-runtime-state.schema.json +289 -0
  288. package/schemas/v2.0.0/operating-scenario.schema.json +13 -0
  289. package/schemas/v2.0.0/operating-snapshot.schema.json +38 -0
  290. package/schemas/v2.0.0/operating-submission.schema.json +34 -0
  291. package/schemas/v2.0.0/operating-trace-matrix.schema.json +176 -0
  292. package/schemas/v2.0.0/operating-work-change-set.schema.json +89 -0
  293. package/schemas/v2.0.0/operating-work-ledger.schema.json +40 -0
  294. package/schemas/v2.0.0/software-operating-snapshot-projection.schema.json +14 -0
  295. package/src/browser-contracts.d.mts +5 -0
  296. package/src/browser-contracts.mjs +40 -0
  297. package/src/canonical-json.d.mts +5 -0
  298. package/src/canonical-json.mjs +142 -0
  299. package/src/compat/live-evidence-v2.mjs +1019 -0
  300. package/src/compat/operate-experience-live-patch.mjs +66 -0
  301. package/src/compat/operating-planning-contracts.mjs +114 -0
  302. package/src/contracts.d.mts +42 -0
  303. package/src/contracts.mjs +990 -0
  304. package/src/design-contracts.d.mts +62 -0
  305. package/src/design-contracts.mjs +186 -0
  306. package/src/design-publication-contracts.d.mts +4 -0
  307. package/src/design-publication-contracts.mjs +85 -0
  308. package/src/diagram-contracts.d.mts +19 -0
  309. package/src/diagram-contracts.mjs +28 -0
  310. package/src/enterprise-contracts.d.mts +107 -0
  311. package/src/enterprise-contracts.mjs +463 -0
  312. package/src/errors.d.mts +11 -0
  313. package/src/errors.mjs +109 -0
  314. package/src/generated/canonical-registries.mjs +5554 -0
  315. package/src/generated/contract-catalog-v2.mjs +7076 -0
  316. package/src/generated/diagram-registries.mjs +2529 -0
  317. package/src/index.d.mts +10 -0
  318. package/src/index.mjs +40 -0
  319. package/src/json-schema.d.mts +7 -0
  320. package/src/json-schema.mjs +283 -0
  321. package/src/planning-contracts.d.mts +10 -0
  322. package/src/planning-contracts.mjs +53 -0
  323. package/src/registries.d.mts +40 -0
  324. package/src/registries.mjs +261 -0
  325. package/src/review-experience-contracts.d.mts +11 -0
  326. package/src/review-experience-contracts.mjs +103 -0
  327. package/src/semver.d.mts +2 -0
  328. package/src/semver.mjs +7 -0
  329. package/src/skill-source-contracts.d.mts +25 -0
  330. package/src/skill-source-contracts.mjs +105 -0
  331. package/src/task-contracts.d.mts +7 -0
  332. package/src/task-contracts.mjs +130 -0
  333. package/src/workspace-contracts.d.mts +26 -0
  334. package/src/workspace-contracts.mjs +83 -0
@@ -0,0 +1,281 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://openplanr.dev/schemas/v2.0.0/operate-experience-view.schema.json",
4
+ "x-openplanr-contract": { "id": "operate-experience-view", "version": "1.0.0" },
5
+ "title": "OpenPlanr Operate access-safe product experience",
6
+ "type": "object",
7
+ "additionalProperties": false,
8
+ "required": ["kind", "schemaVersion", "protocolVersion", "viewId", "scopeId", "domainId", "domainVersion", "actorId", "accessLevel", "generatedAt", "eventHead", "sourceStateHash", "status", "attention", "domainMetrics", "cycles", "inbox", "actions", "evidence", "claims", "rationale", "outcomes", "learnings", "history", "replay", "allowedActions", "omissions", "export", "viewHash"],
9
+ "properties": {
10
+ "kind": { "const": "operate-experience-view" }, "schemaVersion": { "const": "1.0.0" }, "protocolVersion": { "const": "2.0.0" },
11
+ "viewId": { "type": "string", "pattern": "^xview_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
12
+ "scopeId": { "$ref": "#/$defs/id" }, "domainId": { "$ref": "#/$defs/id" }, "domainVersion": { "$ref": "#/$defs/version" },
13
+ "actorId": { "$ref": "#/$defs/id" }, "accessLevel": { "enum": ["public", "internal", "confidential", "restricted"] },
14
+ "generatedAt": { "type": "string", "format": "date-time" }, "eventHead": { "$ref": "#/$defs/eventHead" }, "sourceStateHash": { "$ref": "#/$defs/hash" },
15
+ "status": { "enum": ["ready", "read-only", "stale", "partial", "blocked", "offline", "incompatible", "corrupt"] },
16
+ "attention": { "type": "array", "items": { "$ref": "#/$defs/attention" } },
17
+ "domainMetrics": { "type": "array", "items": { "$ref": "#/$defs/domainMetric" } },
18
+ "cycles": { "type": "array", "items": { "$ref": "#/$defs/cycle" } },
19
+ "inbox": { "type": "array", "items": { "$ref": "#/$defs/inbox" } },
20
+ "actions": { "type": "array", "items": { "$ref": "#/$defs/action" } },
21
+ "evidence": { "type": "array", "items": { "$ref": "#/$defs/evidence" } },
22
+ "claims": { "type": "array", "items": { "$ref": "#/$defs/claim" } },
23
+ "rationale": { "type": "array", "items": { "$ref": "#/$defs/rationale" } },
24
+ "outcomes": { "type": "array", "items": { "$ref": "#/$defs/outcome" } },
25
+ "learnings": { "type": "array", "items": { "$ref": "#/$defs/learning" } },
26
+ "history": { "type": "array", "items": { "$ref": "#/$defs/history" } },
27
+ "replay": { "$ref": "#/$defs/replay" },
28
+ "allowedActions": { "type": "array", "items": { "$ref": "#/$defs/boundAllowedAction" } },
29
+ "omissions": { "type": "array", "items": { "$ref": "#/$defs/omission" } },
30
+ "export": { "type": "object", "additionalProperties": false, "required": ["formats", "accessSafe", "redactionCount"], "properties": { "formats": { "type": "array", "uniqueItems": true, "items": { "enum": ["json", "html"] } }, "accessSafe": { "const": true }, "redactionCount": { "type": "integer", "minimum": 0 } } },
31
+ "viewHash": { "$ref": "#/$defs/hash" }
32
+ },
33
+ "$defs": {
34
+ "id": { "type": "string", "minLength": 1, "maxLength": 128 }, "version": { "type": "string", "minLength": 1, "maxLength": 64 }, "hash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "text": { "type": "string", "minLength": 1, "maxLength": 4096, "pattern": "^[\\s\\S]*\\S[\\s\\S]*$" }, "shortText": { "type": "string", "minLength": 1, "maxLength": 512, "pattern": "^[\\s\\S]*\\S[\\s\\S]*$" },
35
+ "nullableText": { "type": ["string", "null"], "minLength": 1, "maxLength": 4096, "pattern": "^[\\s\\S]*\\S[\\s\\S]*$" }, "nullableShortText": { "type": ["string", "null"], "minLength": 1, "maxLength": 512, "pattern": "^[\\s\\S]*\\S[\\s\\S]*$" },
36
+ "accessLevel": { "enum": ["public", "internal", "confidential", "restricted"] }, "accessReason": { "type": ["string", "null"], "enum": ["access-denied", null] },
37
+ "deepLink": { "type": "string", "pattern": "^#/operate/(?:cycles|inbox|actions|evidence|outcomes|history)/" }, "nullableDeepLink": { "type": ["string", "null"], "pattern": "^#/operate/(?:cycles|inbox|actions|evidence|outcomes|history)/" },
38
+ "scope": { "type": "object", "additionalProperties": false, "required": ["scopeId", "domainId", "domainVersion"], "properties": { "scopeId": { "$ref": "#/$defs/id" }, "domainId": { "$ref": "#/$defs/id" }, "domainVersion": { "$ref": "#/$defs/version" } } },
39
+ "producer": { "type": "object", "additionalProperties": false, "required": ["actorId", "roleId", "runtime"], "properties": { "actorId": { "$ref": "#/$defs/id" }, "roleId": { "$ref": "#/$defs/id" }, "runtime": { "$ref": "#/$defs/id" } } },
40
+ "implementationRef": { "type": "object", "additionalProperties": false, "required": ["id", "version"], "properties": { "id": { "$ref": "#/$defs/id" }, "version": { "$ref": "#/$defs/version" } } },
41
+ "snapshotRef": { "type": "object", "additionalProperties": false, "required": ["snapshotId", "createdAt"], "properties": { "snapshotId": { "$ref": "#/$defs/id" }, "createdAt": { "type": "string", "format": "date-time" } } },
42
+ "deltaRef": { "type": "object", "additionalProperties": false, "required": ["deltaId", "priorSnapshotId", "currentSnapshotId", "derivedAt"], "properties": { "deltaId": { "$ref": "#/$defs/id" }, "priorSnapshotId": { "type": ["string", "null"], "maxLength": 128 }, "currentSnapshotId": { "$ref": "#/$defs/id" }, "derivedAt": { "type": "string", "format": "date-time" } } },
43
+ "nextAction": { "type": "object", "additionalProperties": false, "required": ["label", "tool"], "properties": { "label": { "$ref": "#/$defs/shortText" }, "tool": { "$ref": "#/$defs/id" } } },
44
+ "eventHead": { "oneOf": [
45
+ { "type": "object", "additionalProperties": false, "required": ["sequence", "hash"], "properties": { "sequence": { "const": 0 }, "hash": { "type": "null" } } },
46
+ { "type": "object", "additionalProperties": false, "required": ["sequence", "hash"], "properties": { "sequence": { "type": "integer", "minimum": 1 }, "hash": { "$ref": "#/$defs/hash" } } }
47
+ ] },
48
+ "attention": { "type": "object", "additionalProperties": false, "required": ["attentionId", "kind", "subjectId", "priority", "title", "whyNow", "consequence", "state", "dueAt", "evidenceRefIds"], "properties": { "attentionId": { "$ref": "#/$defs/id" }, "kind": { "enum": ["decision", "approval", "action", "verification", "outcome", "uncertainty"] }, "subjectId": { "$ref": "#/$defs/id" }, "priority": { "type": "integer", "minimum": 0, "maximum": 1000 }, "title": { "$ref": "#/$defs/shortText" }, "whyNow": { "$ref": "#/$defs/shortText" }, "consequence": { "$ref": "#/$defs/text" }, "state": { "$ref": "#/$defs/id" }, "dueAt": { "type": ["string", "null"], "format": "date-time" }, "evidenceRefIds": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/id" } } } },
49
+ "domainMetric": { "type": "object", "additionalProperties": false, "required": ["metricId", "title", "value", "unit", "change", "window", "freshness", "state", "target", "threshold", "evidenceRefIds", "snapshot", "delta", "dueVerification", "accessReason"], "properties": {
50
+ "metricId": { "$ref": "#/$defs/id" }, "title": { "$ref": "#/$defs/nullableShortText" }, "value": { "type": ["number", "null"] }, "unit": { "type": ["string", "null"], "maxLength": 128 },
51
+ "change": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/metricChange" }] }, "window": { "type": ["string", "null"], "maxLength": 512 },
52
+ "freshness": { "enum": ["current", "historical", "stale", "unknown"] }, "state": { "enum": ["current", "historical", "stale", "unknown", "unavailable", "restricted"] },
53
+ "target": { "type": ["number", "null"] }, "threshold": { "type": ["number", "null"] }, "evidenceRefIds": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/id" } },
54
+ "snapshot": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/snapshotRef" }] }, "delta": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/deltaRef" }] },
55
+ "dueVerification": { "type": "array", "items": { "$ref": "#/$defs/dueVerification" } }, "accessReason": { "$ref": "#/$defs/accessReason" }
56
+ } },
57
+ "metricChange": { "type": "object", "additionalProperties": false, "required": ["kind", "priorValue", "currentValue", "deltaValue", "deltaId"], "properties": { "kind": { "enum": ["added", "removed", "changed", "stale", "conflict"] }, "priorValue": { "type": ["number", "null"] }, "currentValue": { "type": ["number", "null"] }, "deltaValue": { "type": ["number", "null"] }, "deltaId": { "type": ["string", "null"], "maxLength": 128 } } },
58
+ "dueVerification": { "type": "object", "additionalProperties": false, "required": ["verificationPlanId", "actionId", "state", "dueAt", "window", "deepLink"], "properties": { "verificationPlanId": { "$ref": "#/$defs/id" }, "actionId": { "$ref": "#/$defs/id" }, "state": { "type": ["string", "null"], "maxLength": 128 }, "dueAt": { "type": ["string", "null"], "format": "date-time" }, "window": { "type": ["string", "null"], "maxLength": 512 }, "deepLink": { "$ref": "#/$defs/nullableDeepLink" } } },
59
+ "cycle": { "type": "object", "additionalProperties": false, "required": ["cycleId", "state", "health", "focus", "createdAt", "updatedAt", "stages", "assignments", "lensAbsences", "dependencies", "blockers", "persistentActionIds", "replayCheckpoint", "deepLink"], "properties": {
60
+ "cycleId": { "$ref": "#/$defs/id" }, "state": { "$ref": "#/$defs/id" }, "health": { "$ref": "#/$defs/id" }, "focus": { "type": "array", "items": { "$ref": "#/$defs/shortText" } },
61
+ "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" }, "stages": { "type": "array", "minItems": 7, "maxItems": 7, "items": { "$ref": "#/$defs/stage" } },
62
+ "assignments": { "type": "array", "items": { "$ref": "#/$defs/assignment" } }, "lensAbsences": { "type": "array", "items": { "$ref": "#/$defs/lensAbsence" } },
63
+ "executiveBoard": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/executiveBoard" }] },
64
+ "dependencies": { "type": "array", "items": { "$ref": "#/$defs/dependency" } },
65
+ "blockers": { "type": "array", "items": { "$ref": "#/$defs/blocker" } }, "persistentActionIds": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/id" } },
66
+ "replayCheckpoint": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/replayCheckpoint" }] }, "deepLink": { "$ref": "#/$defs/deepLink" }
67
+ } },
68
+ "stage": { "type": "object", "additionalProperties": false, "required": ["id", "state", "reason", "inputArtifactIds", "outputArtifactIds", "gates", "evidenceGapIds", "uncertaintyIds", "persistentActionIds"], "properties": {
69
+ "id": { "enum": ["observe", "understand", "decide", "govern", "act", "verify", "learn"] }, "state": { "enum": ["complete", "current", "available", "blocked", "skipped", "failed", "uncertain", "revisited", "waiting"] }, "reason": { "type": ["string", "null"], "maxLength": 512 },
70
+ "inputArtifactIds": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/id" } }, "outputArtifactIds": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/id" } },
71
+ "gates": { "type": "array", "items": { "$ref": "#/$defs/gate" } }, "evidenceGapIds": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/id" } },
72
+ "uncertaintyIds": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/id" } }, "persistentActionIds": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/id" } }
73
+ } },
74
+ "assignment": { "type": "object", "additionalProperties": false, "required": ["assignmentId", "title", "role", "ownerLabel", "state", "absence", "dueAt", "next", "deepLink", "dependencies", "blockers", "inputArtifactIds", "outputArtifactIds"], "properties": {
75
+ "assignmentId": { "$ref": "#/$defs/id" }, "title": { "$ref": "#/$defs/nullableShortText" }, "role": { "type": ["string", "null"], "maxLength": 128 }, "ownerLabel": { "type": ["string", "null"], "maxLength": 128 }, "state": { "$ref": "#/$defs/id" },
76
+ "absence": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/terminalAbsence" }] },
77
+ "dueAt": { "type": ["string", "null"], "format": "date-time" }, "next": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/nextAction" }] }, "deepLink": { "$ref": "#/$defs/deepLink" },
78
+ "dependencies": { "type": "array", "items": { "$ref": "#/$defs/assignmentDependency" } }, "blockers": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/id" } },
79
+ "inputArtifactIds": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/id" } }, "outputArtifactIds": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/id" } }
80
+ } },
81
+ "assignmentDependency": { "type": "object", "additionalProperties": false, "required": ["assignmentId", "state", "resolved"], "properties": { "assignmentId": { "$ref": "#/$defs/id" }, "state": { "type": ["string", "null"], "maxLength": 128 }, "resolved": { "type": "boolean" } } },
82
+ "terminalAbsence": { "type": "object", "additionalProperties": false, "required": ["outcome", "code", "reason", "recoveryDisposition"], "properties": { "outcome": { "enum": ["abandoned", "failed"] }, "code": { "type": "string", "maxLength": 128 }, "reason": { "$ref": "#/$defs/shortText" }, "recoveryDisposition": { "type": "string", "maxLength": 128 } } },
83
+ "lensAbsence": { "type": "object", "additionalProperties": false, "required": ["roleId", "roleKind", "absenceCode", "reason"], "properties": { "roleId": { "$ref": "#/$defs/id" }, "roleKind": { "type": "string", "maxLength": 128 }, "absenceCode": { "type": "string", "maxLength": 128 }, "reason": { "$ref": "#/$defs/text" } } },
84
+ "executiveBoardArtifact": { "type": "object", "additionalProperties": false, "required": ["artifactId", "rawHash", "canonicalHash"], "properties": { "artifactId": { "$ref": "#/$defs/id" }, "rawHash": { "$ref": "#/$defs/hash" }, "canonicalHash": { "$ref": "#/$defs/hash" } } },
85
+ "executiveBoardSeatAbsence": { "oneOf": [
86
+ { "type": "object", "additionalProperties": false, "required": ["kind", "outcome", "code", "reason", "recoveryDisposition"], "properties": { "kind": { "const": "terminal" }, "outcome": { "enum": ["abandoned", "failed"] }, "code": { "type": "string", "maxLength": 128 }, "reason": { "$ref": "#/$defs/shortText" }, "recoveryDisposition": { "type": "string", "maxLength": 128 } } },
87
+ { "type": "object", "additionalProperties": false, "required": ["kind", "roleId", "roleKind", "absenceCode", "reason"], "properties": { "kind": { "const": "lens" }, "roleId": { "$ref": "#/$defs/id" }, "roleKind": { "type": "string", "maxLength": 128 }, "absenceCode": { "type": "string", "maxLength": 128 }, "reason": { "$ref": "#/$defs/text" } } },
88
+ { "type": "object", "additionalProperties": false, "required": ["kind", "reason"], "properties": { "kind": { "const": "omitted" }, "reason": { "$ref": "#/$defs/text" } } }
89
+ ] },
90
+ "executiveBoardSeat": { "type": "object", "additionalProperties": false, "required": ["roleId", "label", "roleKind", "roleVersion", "assignmentId", "assignmentState", "artifact", "absence"], "properties": {
91
+ "roleId": { "$ref": "#/$defs/id" }, "label": { "$ref": "#/$defs/shortText" }, "roleKind": { "type": "string", "maxLength": 128 }, "roleVersion": { "$ref": "#/$defs/version" },
92
+ "assignmentId": { "type": ["string", "null"], "maxLength": 128 }, "assignmentState": { "type": ["string", "null"], "maxLength": 128 },
93
+ "artifact": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/executiveBoardArtifact" }] },
94
+ "absence": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/executiveBoardSeatAbsence" }] }
95
+ } },
96
+ "executiveBoard": { "type": "object", "additionalProperties": false, "required": ["cycleId", "planId", "seats", "challengerFindings", "chairSynthesis"], "properties": {
97
+ "cycleId": { "$ref": "#/$defs/id" }, "planId": { "$ref": "#/$defs/id" },
98
+ "boardId": { "type": "string", "pattern": "^xbr_[a-f0-9]{32}$" },
99
+ "reviewId": { "$ref": "#/$defs/id" },
100
+ "projectionMode": { "enum": ["materialized", "compatibility"] },
101
+ "authoritativeForMutation": { "type": "boolean" },
102
+ "materializedEventId": { "type": ["string", "null"], "maxLength": 128 },
103
+ "sourceEventHead": { "$ref": "#/$defs/eventHead" },
104
+ "sourceBoardHash": { "$ref": "#/$defs/hash" },
105
+ "semanticHash": { "$ref": "#/$defs/hash" },
106
+ "traceMatrix": { "$ref": "operating-trace-matrix.schema.json" },
107
+ "seats": { "type": "array", "maxItems": 16, "items": { "$ref": "#/$defs/executiveBoardSeat" } },
108
+ "challengerFindings": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/executiveBoardChallengerFindings" }] },
109
+ "chairSynthesis": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/executiveBoardChairSynthesis" }] }
110
+ }, "dependentRequired": {
111
+ "boardId": ["reviewId", "projectionMode", "authoritativeForMutation", "materializedEventId", "sourceEventHead", "sourceBoardHash", "semanticHash", "traceMatrix"]
112
+ } },
113
+ "executiveBoardChallengerFindings": { "type": "object", "additionalProperties": false, "required": ["artifact", "findings", "dissent"], "properties": {
114
+ "artifact": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/executiveBoardArtifact" }] },
115
+ "findings": { "type": "array", "maxItems": 256, "items": { "$ref": "#/$defs/executiveBoardChallengerFinding" } },
116
+ "dissent": { "type": "array", "maxItems": 256, "items": { "$ref": "#/$defs/executiveBoardDissent" } }
117
+ } },
118
+ "executiveBoardChallengerFinding": { "type": "object", "additionalProperties": false, "required": ["findingId", "sourceArtifactId", "sourceAssignmentId", "sourceLocalFindingId", "findingType", "severity", "confidence", "targets", "supportingEvidenceRefIds", "contradictingEvidenceRefIds", "title", "statement", "rationale", "correctionCondition", "state", "ownerActorId", "revisitAt"], "properties": {
119
+ "findingId": { "$ref": "#/$defs/id" }, "sourceArtifactId": { "$ref": "#/$defs/id" }, "sourceAssignmentId": { "$ref": "#/$defs/id" }, "sourceLocalFindingId": { "$ref": "#/$defs/id" },
120
+ "findingType": { "enum": ["unsupported", "contradicted", "correlated-reasoning", "missing-alternative", "unpriced-downside", "irreversibility-mismatch", "overconfidence", "scope-violation"] },
121
+ "severity": { "enum": ["low", "medium", "high", "critical"] }, "confidence": { "type": "number", "minimum": 0, "maximum": 1 },
122
+ "targets": { "type": "array", "minItems": 1, "maxItems": 64, "items": { "$ref": "operating-finding.schema.json#/$defs/target" } },
123
+ "supportingEvidenceRefIds": { "type": "array", "maxItems": 128, "uniqueItems": true, "items": { "$ref": "#/$defs/id" } },
124
+ "contradictingEvidenceRefIds": { "type": "array", "maxItems": 128, "uniqueItems": true, "items": { "$ref": "#/$defs/id" } },
125
+ "title": { "$ref": "#/$defs/shortText" }, "statement": { "$ref": "#/$defs/text" }, "rationale": { "$ref": "#/$defs/text" }, "correctionCondition": { "$ref": "#/$defs/text" },
126
+ "state": { "enum": ["open", "accepted", "resolved", "rejected", "deferred", "superseded"] }, "ownerActorId": { "type": ["string", "null"], "maxLength": 128 }, "revisitAt": { "type": ["string", "null"], "format": "date-time" }
127
+ } },
128
+ "executiveBoardDissent": { "type": "object", "additionalProperties": false, "required": ["sourceArtifactId", "localDissentId", "statement", "resolutionCondition"], "properties": {
129
+ "sourceArtifactId": { "$ref": "#/$defs/id" }, "localDissentId": { "$ref": "#/$defs/id" }, "statement": { "$ref": "#/$defs/text" }, "resolutionCondition": { "$ref": "#/$defs/text" }
130
+ } },
131
+ "executiveBoardChairSynthesis": { "type": "object", "additionalProperties": false, "required": ["artifact", "decisions", "dissent", "unresolvedGaps"], "properties": {
132
+ "artifact": { "$ref": "#/$defs/executiveBoardChairArtifact" },
133
+ "decisions": { "type": "array", "maxItems": 256, "items": { "$ref": "#/$defs/executiveBoardChairDecision" } },
134
+ "dissent": { "type": "array", "maxItems": 256, "items": { "$ref": "#/$defs/executiveBoardDissent" } },
135
+ "unresolvedGaps": { "type": "array", "maxItems": 2048, "items": { "$ref": "#/$defs/executiveBoardGap" } }
136
+ } },
137
+ "executiveBoardChairArtifact": { "type": "object", "additionalProperties": false, "required": ["artifactId", "intelligencePlanId", "advisorArtifactIds", "challengerArtifactId"], "properties": {
138
+ "artifactId": { "$ref": "#/$defs/id" }, "intelligencePlanId": { "$ref": "#/$defs/id" },
139
+ "advisorArtifactIds": { "type": "array", "maxItems": 16, "uniqueItems": true, "items": { "$ref": "#/$defs/id" } },
140
+ "challengerArtifactId": { "type": ["string", "null"], "maxLength": 128 }
141
+ } },
142
+ "executiveBoardClaimRef": { "type": "object", "additionalProperties": false, "required": ["advisorArtifactId", "localClaimId"], "properties": {
143
+ "advisorArtifactId": { "$ref": "#/$defs/id" }, "localClaimId": { "$ref": "#/$defs/id" }
144
+ } },
145
+ "executiveBoardRecommendationRef": { "type": "object", "additionalProperties": false, "required": ["advisorArtifactId", "localRecommendationId"], "properties": {
146
+ "advisorArtifactId": { "$ref": "#/$defs/id" }, "localRecommendationId": { "$ref": "#/$defs/id" }
147
+ } },
148
+ "executiveBoardAlternativeDisposition": { "type": "object", "additionalProperties": false, "required": ["sourceArtifactId", "localAlternativeId", "title", "disposition", "rationale"], "properties": {
149
+ "sourceArtifactId": { "$ref": "#/$defs/id" }, "localAlternativeId": { "$ref": "#/$defs/id" }, "title": { "$ref": "#/$defs/nullableShortText" }, "disposition": { "enum": ["accepted", "rejected", "deferred"] }, "rationale": { "$ref": "#/$defs/nullableText" }
150
+ } },
151
+ "executiveBoardChairDecision": { "type": "object", "additionalProperties": false, "required": ["localDecisionId", "title", "question", "outcome", "rationale", "sourceClaimRefs", "sourceRecommendationRefs", "challengerFindingIds", "evidenceRefIds", "confidence", "assumptionIds", "expectedUpside", "expectedDownside", "uncertainty", "reversibility", "ownerActorId", "revisitConditions", "dissentIds", "alternativeDispositions", "actionHypotheses"], "properties": {
152
+ "localDecisionId": { "$ref": "#/$defs/id" },
153
+ "title": { "$ref": "#/$defs/nullableShortText" }, "question": { "$ref": "#/$defs/nullableText" }, "outcome": { "$ref": "#/$defs/nullableText" }, "rationale": { "$ref": "#/$defs/nullableText" },
154
+ "sourceClaimRefs": { "type": "array", "minItems": 1, "maxItems": 128, "items": { "$ref": "#/$defs/executiveBoardClaimRef" } },
155
+ "sourceRecommendationRefs": { "type": "array", "maxItems": 16, "items": { "$ref": "#/$defs/executiveBoardRecommendationRef" } },
156
+ "challengerFindingIds": { "type": "array", "maxItems": 256, "uniqueItems": true, "items": { "$ref": "#/$defs/id" } },
157
+ "evidenceRefIds": { "type": "array", "minItems": 1, "maxItems": 128, "uniqueItems": true, "items": { "$ref": "#/$defs/id" } },
158
+ "confidence": { "type": ["number", "null"], "minimum": 0, "maximum": 1 }, "assumptionIds": { "type": "array", "maxItems": 128, "uniqueItems": true, "items": { "$ref": "#/$defs/id" } },
159
+ "expectedUpside": { "$ref": "#/$defs/nullableText" }, "expectedDownside": { "$ref": "#/$defs/nullableText" }, "uncertainty": { "$ref": "#/$defs/nullableText" }, "reversibility": { "$ref": "#/$defs/nullableText" },
160
+ "ownerActorId": { "type": ["string", "null"], "maxLength": 128 }, "revisitConditions": { "type": "array", "minItems": 1, "maxItems": 64, "items": { "$ref": "#/$defs/text" } },
161
+ "dissentIds": { "type": "array", "maxItems": 128, "uniqueItems": true, "items": { "$ref": "#/$defs/id" } },
162
+ "alternativeDispositions": { "type": "array", "maxItems": 64, "items": { "$ref": "#/$defs/executiveBoardAlternativeDisposition" } },
163
+ "actionHypotheses": { "type": "array", "maxItems": 256, "items": { "$ref": "#/$defs/executiveBoardActionHypothesis" } }
164
+ } },
165
+ "executiveBoardActionHypothesis": { "type": "object", "additionalProperties": false, "required": ["localActionHypothesisId", "title", "objectiveId", "ownerActorId", "accountabilityDisposition", "expectedResult", "metricId", "baseline", "target", "verificationWindow", "verificationMethod", "sourceClaimRefs", "sourceFindingIds", "dependsOnActionHypothesisIds"], "properties": {
166
+ "localActionHypothesisId": { "$ref": "#/$defs/id" }, "title": { "$ref": "#/$defs/nullableShortText" }, "objectiveId": { "type": ["string", "null"], "maxLength": 128 }, "ownerActorId": { "type": ["string", "null"], "maxLength": 128 },
167
+ "accountabilityDisposition": { "type": ["string", "null"], "enum": [null, "unowned", "blocked"] }, "expectedResult": { "$ref": "#/$defs/nullableText" }, "metricId": { "type": ["string", "null"], "maxLength": 128 },
168
+ "baseline": { "type": ["number", "null"] }, "target": { "type": ["number", "null"] }, "verificationWindow": { "$ref": "#/$defs/nullableText" }, "verificationMethod": { "$ref": "#/$defs/nullableText" },
169
+ "sourceClaimRefs": { "type": "array", "maxItems": 128, "items": { "$ref": "#/$defs/executiveBoardClaimRef" } }, "sourceFindingIds": { "type": "array", "maxItems": 256, "uniqueItems": true, "items": { "$ref": "#/$defs/id" } },
170
+ "dependsOnActionHypothesisIds": { "type": "array", "maxItems": 256, "uniqueItems": true, "items": { "$ref": "#/$defs/id" } }
171
+ } },
172
+ "executiveBoardGap": { "oneOf": [{ "$ref": "#/$defs/executiveBoardRoleGap" }, { "$ref": "#/$defs/executiveBoardEvidenceGap" }] },
173
+ "executiveBoardRoleGap": { "type": "object", "additionalProperties": false, "required": ["absenceId", "kind", "roleId", "roleKind", "roleVersion", "absenceCode", "reason", "recoveryDisposition", "sourceAssignmentId", "sourceEventId"], "properties": {
174
+ "absenceId": { "type": ["string", "null"], "maxLength": 128 }, "kind": { "const": "role" }, "roleId": { "$ref": "#/$defs/id" }, "roleKind": { "enum": ["advisor", "challenger", "chair"] },
175
+ "roleVersion": { "type": ["string", "null"], "maxLength": 64 }, "absenceCode": { "$ref": "#/$defs/id" }, "reason": { "$ref": "#/$defs/text" }, "recoveryDisposition": { "type": ["string", "null"], "maxLength": 128 },
176
+ "sourceAssignmentId": { "type": ["string", "null"], "maxLength": 128 }, "sourceEventId": { "type": ["string", "null"], "maxLength": 128 }
177
+ } },
178
+ "executiveBoardEvidenceGap": { "type": "object", "additionalProperties": false, "required": ["absenceId", "kind", "requirementId", "evidenceKinds", "sourceContracts", "absenceCode", "reason", "recoveryDisposition", "sourceEvidenceRefIds", "sourceEventIds"], "properties": {
179
+ "absenceId": { "$ref": "#/$defs/id" }, "kind": { "const": "evidence" }, "requirementId": { "$ref": "#/$defs/id" }, "evidenceKinds": { "type": "array", "minItems": 1, "maxItems": 4, "uniqueItems": true, "items": { "enum": ["git", "filesystem", "planr", "operate-artifact"] } },
180
+ "sourceContracts": { "type": "array", "minItems": 1, "maxItems": 16, "uniqueItems": true, "items": { "type": "object", "additionalProperties": false, "required": ["id", "version"], "properties": { "id": { "$ref": "#/$defs/id" }, "version": { "$ref": "#/$defs/id" } } } },
181
+ "absenceCode": { "enum": ["not-available", "not-authorized", "resolution-failed", "stale"] }, "reason": { "$ref": "#/$defs/text" }, "recoveryDisposition": { "$ref": "#/$defs/id" },
182
+ "sourceEvidenceRefIds": { "type": "array", "maxItems": 128, "uniqueItems": true, "items": { "$ref": "#/$defs/id" } }, "sourceEventIds": { "type": "array", "maxItems": 2048, "uniqueItems": true, "items": { "$ref": "#/$defs/id" } }
183
+ } },
184
+ "actionDependency": { "type": "object", "additionalProperties": false, "required": ["actionId", "state", "resolved"], "properties": { "actionId": { "$ref": "#/$defs/id" }, "state": { "type": ["string", "null"], "maxLength": 128 }, "resolved": { "type": "boolean" } } },
185
+ "dependency": { "oneOf": [
186
+ { "type": "object", "additionalProperties": false, "required": ["subjectKind", "subjectId", "dependsOn"], "properties": { "subjectKind": { "const": "assignment" }, "subjectId": { "$ref": "#/$defs/id" }, "dependsOn": { "type": "array", "items": { "$ref": "#/$defs/assignmentDependency" } } } },
187
+ { "type": "object", "additionalProperties": false, "required": ["subjectKind", "subjectId", "dependsOn"], "properties": { "subjectKind": { "const": "action" }, "subjectId": { "$ref": "#/$defs/id" }, "dependsOn": { "type": "array", "items": { "$ref": "#/$defs/actionDependency" } } } }
188
+ ] },
189
+ "blocker": { "type": "object", "additionalProperties": false, "required": ["subjectKind", "subjectId", "blockingSubjectIds"], "properties": { "subjectKind": { "enum": ["assignment", "action"] }, "subjectId": { "$ref": "#/$defs/id" }, "blockingSubjectIds": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "$ref": "#/$defs/id" } } } },
190
+ "gate": { "type": "object", "additionalProperties": false, "required": ["kind", "subjectId", "state"], "properties": { "kind": { "enum": ["review", "approval", "execution", "verification", "learning"] }, "subjectId": { "$ref": "#/$defs/id" }, "state": { "$ref": "#/$defs/id" } } },
191
+ "inbox": {
192
+ "type": "object",
193
+ "additionalProperties": false,
194
+ "required": ["itemId", "kind", "subjectId", "ownerActorId", "state", "title", "consequence", "expiresAt", "blocking", "evidence", "requiredParties", "redactions", "actionLocator", "navigationLocator", "unavailableReason"],
195
+ "properties": {
196
+ "itemId": { "$ref": "#/$defs/id" },
197
+ "kind": { "enum": ["decision", "approval", "verification"] },
198
+ "subjectId": { "$ref": "#/$defs/id" },
199
+ "ownerActorId": { "$ref": "#/$defs/id" },
200
+ "state": { "$ref": "#/$defs/id" },
201
+ "title": { "$ref": "#/$defs/shortText" },
202
+ "consequence": { "$ref": "#/$defs/shortText" },
203
+ "expiresAt": { "type": ["string", "null"], "format": "date-time" },
204
+ "blocking": { "type": "boolean" },
205
+ "evidence": { "type": "array", "items": { "$ref": "#/$defs/inboxEvidence" } },
206
+ "requiredParties": { "type": "array", "items": { "$ref": "#/$defs/inboxParty" } },
207
+ "redactions": { "type": "array", "items": { "$ref": "#/$defs/omission" } },
208
+ "actionLocator": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/inboxActionLocator" }] },
209
+ "navigationLocator": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/inboxNavigationLocator" }] },
210
+ "unavailableReason": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/inboxUnavailableReason" }] }
211
+ },
212
+ "oneOf": [
213
+ { "properties": { "actionLocator": { "$ref": "#/$defs/inboxActionLocator" }, "unavailableReason": { "type": "null" } } },
214
+ { "properties": { "actionLocator": { "type": "null" }, "navigationLocator": { "$ref": "#/$defs/inboxNavigationLocator" }, "unavailableReason": { "type": "null" } } },
215
+ { "properties": { "actionLocator": { "type": "null" }, "navigationLocator": { "type": "null" }, "unavailableReason": { "$ref": "#/$defs/inboxUnavailableReason" } } }
216
+ ]
217
+ },
218
+ "inboxEvidence": { "type": "object", "additionalProperties": false, "required": ["evidenceRefId", "classification", "accessState", "relation"], "properties": { "evidenceRefId": { "$ref": "#/$defs/id" }, "classification": { "$ref": "#/$defs/accessLevel" }, "accessState": { "enum": ["available", "restricted"] }, "relation": { "enum": ["support", "contradiction", "informs", "evaluates"] } } },
219
+ "inboxParty": { "type": "object", "additionalProperties": false, "required": ["partyId", "actorKind", "actorId", "requiredCapability", "state", "redacted"], "properties": { "partyId": { "$ref": "#/$defs/id" }, "actorKind": { "enum": ["human", "engine"] }, "actorId": { "type": ["string", "null"], "minLength": 1, "maxLength": 128 }, "requiredCapability": { "$ref": "operating-governed-operation.schema.json#/$defs/versionedId" }, "state": { "enum": ["required", "recorded", "redacted"] }, "redacted": { "type": "boolean" } } },
220
+ "inboxActionLocator": { "type": "object", "additionalProperties": false, "required": ["subjectId", "actionDigest"], "properties": { "subjectId": { "$ref": "#/$defs/id" }, "actionDigest": { "$ref": "#/$defs/hash" } } },
221
+ "inboxNavigationLocator": { "type": "object", "additionalProperties": false, "required": ["kind", "cycleId", "reviewId", "deepLink", "readActionDigest"], "properties": { "kind": { "const": "review" }, "cycleId": { "type": "string", "pattern": "^cyc_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "reviewId": { "type": "string", "pattern": "^rev_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "deepLink": { "$ref": "#/$defs/deepLink" }, "readActionDigest": { "$ref": "#/$defs/hash" } } },
222
+ "inboxUnavailableReason": { "type": "object", "additionalProperties": false, "required": ["code", "message"], "properties": { "code": { "type": "string", "pattern": "^[A-Z][A-Z0-9_]{0,127}$" }, "message": { "$ref": "#/$defs/shortText" } } },
223
+ "action": { "type": "object", "additionalProperties": false, "required": ["actionId", "revision", "actionHash", "title", "state", "ownerActorId", "expectedResult", "verificationPlanId", "deliveryRoute", "dependencyActionIds", "executions", "rollbacks", "deepLink"], "properties": { "actionId": { "$ref": "#/$defs/id" }, "revision": { "type": "integer", "minimum": 1 }, "actionHash": { "$ref": "#/$defs/hash" }, "title": { "$ref": "#/$defs/shortText" }, "state": { "$ref": "#/$defs/id" }, "ownerActorId": { "type": ["string", "null"], "maxLength": 128 }, "expectedResult": { "$ref": "#/$defs/text" }, "verificationPlanId": { "$ref": "#/$defs/id" }, "deliveryRoute": { "$ref": "operating-delivery-route.schema.json" }, "dependencyActionIds": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/id" } }, "executions": { "type": "array", "items": { "$ref": "#/$defs/result" } }, "rollbacks": { "type": "array", "items": { "$ref": "#/$defs/result" } }, "deepLink": { "$ref": "#/$defs/deepLink" } } },
224
+ "evidence": { "type": "object", "additionalProperties": false, "required": ["evidenceRefId", "classification", "accessState", "freshness", "evidenceKind", "resolvedAt", "claimStatus", "supportClaimIds", "contradictClaimIds", "source", "producer", "observedAt", "scope", "sensitivity", "provenance", "confidence", "gaps", "errors", "accessReason", "causalLinks", "deepLink"], "properties": {
225
+ "evidenceRefId": { "$ref": "#/$defs/id" }, "classification": { "$ref": "#/$defs/accessLevel" }, "accessState": { "enum": ["available", "restricted"] }, "freshness": { "enum": ["current", "historical", "stale"] }, "evidenceKind": { "type": ["string", "null"], "enum": ["git", "filesystem", "planr", "operate-artifact", null] }, "resolvedAt": { "type": ["string", "null"], "format": "date-time" },
226
+ "claimStatus": { "enum": ["supported", "contradicted", "uncertain", "unknown", "restricted"] }, "supportClaimIds": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/id" } }, "contradictClaimIds": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/id" } },
227
+ "source": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/evidenceSource" }] }, "producer": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/producer" }] }, "observedAt": { "type": ["string", "null"], "format": "date-time" }, "scope": { "$ref": "#/$defs/scope" }, "sensitivity": { "$ref": "#/$defs/accessLevel" },
228
+ "provenance": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/evidenceProvenance" }] }, "confidence": { "type": ["number", "null"], "minimum": 0, "maximum": 1 }, "gaps": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/id" } },
229
+ "errors": { "type": "array", "items": { "$ref": "#/$defs/resolutionError" } }, "accessReason": { "$ref": "#/$defs/accessReason" }, "causalLinks": { "type": "array", "items": { "$ref": "#/$defs/causalLink" } }, "deepLink": { "$ref": "#/$defs/deepLink" }
230
+ } },
231
+ "claim": { "type": "object", "additionalProperties": false, "required": ["claimId", "status", "epistemicStatus", "statement", "supportEvidenceRefIds", "contradictEvidenceRefIds", "source", "producer", "observedAt", "scope", "sensitivity", "provenance", "confidence", "gaps", "errors", "accessReason", "causalLinks", "deepLink"], "properties": {
232
+ "claimId": { "$ref": "#/$defs/id" }, "status": { "enum": ["supported", "contradicted", "uncertain", "unknown", "restricted"] }, "epistemicStatus": { "enum": ["known", "strongly-supported", "probable", "speculative", "unknown"] }, "statement": { "$ref": "#/$defs/nullableText" },
233
+ "supportEvidenceRefIds": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/id" } }, "contradictEvidenceRefIds": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/id" } }, "source": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/artifactMetadata" }] }, "producer": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/producer" }] },
234
+ "observedAt": { "type": "string", "format": "date-time" }, "scope": { "$ref": "#/$defs/scope" }, "sensitivity": { "$ref": "#/$defs/accessLevel" }, "provenance": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/artifactProvenance" }] }, "confidence": { "type": ["number", "null"], "minimum": 0, "maximum": 1 },
235
+ "gaps": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/id" } }, "errors": { "type": "array", "items": { "$ref": "#/$defs/resolutionError" } }, "accessReason": { "$ref": "#/$defs/accessReason" }, "causalLinks": { "type": "array", "items": { "$ref": "#/$defs/causalLink" } }, "deepLink": { "$ref": "#/$defs/deepLink" }
236
+ } },
237
+ "rationale": { "type": "object", "additionalProperties": false, "required": ["nodeId", "kind", "subjectId", "summary", "artifactId", "evidenceRefIds"], "properties": { "nodeId": { "$ref": "#/$defs/id" }, "kind": { "enum": ["claim", "recommendation", "challenge", "synthesis", "decision", "action", "result", "outcome", "learning", "revisit"] }, "subjectId": { "$ref": "#/$defs/id" }, "summary": { "$ref": "#/$defs/text" }, "artifactId": { "type": ["string", "null"], "maxLength": 128 }, "evidenceRefIds": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/id" } } } },
238
+ "outcome": { "type": "object", "additionalProperties": false, "required": ["outcomeId", "actionId", "verificationPlanId", "status", "metric", "observationIds", "evidenceRefIds", "observedAt", "decision", "execution", "rollback", "verification", "nextObservation", "revisit", "snapshot", "delta", "accessReason", "deepLink"], "properties": {
239
+ "outcomeId": { "$ref": "#/$defs/id" }, "actionId": { "$ref": "#/$defs/id" }, "verificationPlanId": { "$ref": "#/$defs/id" }, "status": { "$ref": "#/$defs/id" }, "metric": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/outcomeMetric" }] },
240
+ "observationIds": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/id" } }, "evidenceRefIds": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/id" } }, "observedAt": { "type": "string", "format": "date-time" },
241
+ "decision": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/decisionRef" }] }, "execution": { "type": "array", "items": { "$ref": "#/$defs/result" } }, "rollback": { "type": "array", "items": { "$ref": "#/$defs/result" } },
242
+ "verification": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/verification" }] }, "nextObservation": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/nextObservation" }] }, "revisit": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/revisit" }] },
243
+ "snapshot": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/snapshotRef" }] }, "delta": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/deltaRef" }] }, "accessReason": { "$ref": "#/$defs/accessReason" }, "deepLink": { "$ref": "#/$defs/deepLink" }
244
+ } },
245
+ "learning": { "type": "object", "additionalProperties": false, "required": ["learningId", "outcomeId", "statement", "decisionIds", "evidenceRefIds", "createdAt"], "properties": { "learningId": { "$ref": "#/$defs/id" }, "outcomeId": { "$ref": "#/$defs/id" }, "statement": { "$ref": "#/$defs/text" }, "decisionIds": { "type": "array", "items": { "$ref": "#/$defs/id" } }, "evidenceRefIds": { "type": "array", "items": { "$ref": "#/$defs/id" } }, "createdAt": { "type": "string", "format": "date-time" } } },
246
+ "history": { "type": "object", "additionalProperties": false, "required": ["eventId", "sequence", "type", "entityId", "actorKind", "actorId", "timestamp", "correlationId", "eventHash", "change", "why", "authority", "evidenceRefIds", "prior", "result", "next", "deepLinks", "beforeAfter"], "properties": {
247
+ "eventId": { "$ref": "#/$defs/id" }, "sequence": { "type": "integer", "minimum": 1 }, "type": { "$ref": "#/$defs/id" }, "entityId": { "$ref": "#/$defs/id" }, "actorKind": { "$ref": "#/$defs/id" }, "actorId": { "type": ["string", "null"], "minLength": 1, "maxLength": 128 }, "timestamp": { "type": "string", "format": "date-time" }, "correlationId": { "$ref": "#/$defs/id" }, "eventHash": { "$ref": "#/$defs/hash" },
248
+ "change": { "$ref": "#/$defs/historyChange" }, "why": { "$ref": "#/$defs/nullableText" }, "authority": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/historyAuthority" }] }, "evidenceRefIds": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/id" } },
249
+ "prior": { "$ref": "#/$defs/historyPrior" }, "result": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/historyResult" }] }, "next": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/nextAction" }] }, "deepLinks": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/deepLink" } },
250
+ "beforeAfter": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/beforeAfter" }] }
251
+ } },
252
+ "replay": { "type": "object", "additionalProperties": false, "required": ["checkpoint", "tail", "finalHead", "liveAccessUsed", "parityProof", "filterDimensions", "redactions"], "properties": {
253
+ "checkpoint": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/replayCheckpoint" }] }, "tail": { "$ref": "#/$defs/replayTail" }, "finalHead": { "$ref": "#/$defs/eventHead" }, "liveAccessUsed": { "const": false }, "parityProof": { "$ref": "#/$defs/parityProof" },
254
+ "filterDimensions": { "type": "array", "uniqueItems": true, "items": { "enum": ["cycle", "action", "decision", "actor", "operation", "result", "event-type", "date"] } }, "redactions": { "type": "array", "items": { "$ref": "#/$defs/omission" } }
255
+ } },
256
+ "evidenceSource": { "type": "object", "additionalProperties": false, "required": ["evidenceKind", "provider", "resolver"], "properties": { "evidenceKind": { "enum": ["git", "filesystem", "planr", "operate-artifact"] }, "provider": { "$ref": "#/$defs/implementationRef" }, "resolver": { "$ref": "#/$defs/implementationRef" } } },
257
+ "evidenceProvenance": { "type": "object", "additionalProperties": false, "required": ["sourceArtifactId", "evidenceArtifactId", "rawHash", "canonicalHash", "sizeBytes", "mediaType", "accessLevel"], "properties": { "sourceArtifactId": { "$ref": "#/$defs/id" }, "evidenceArtifactId": { "$ref": "#/$defs/id" }, "rawHash": { "$ref": "#/$defs/hash" }, "canonicalHash": { "type": ["string", "null"], "pattern": "^sha256:[a-f0-9]{64}$" }, "sizeBytes": { "type": "integer", "minimum": 0 }, "mediaType": { "$ref": "#/$defs/id" }, "accessLevel": { "$ref": "#/$defs/accessLevel" } } },
258
+ "artifactMetadata": { "type": "object", "additionalProperties": false, "required": ["artifactId", "artifactType", "producer", "observedAt", "rawHash", "canonicalHash"], "properties": { "artifactId": { "$ref": "#/$defs/id" }, "artifactType": { "$ref": "#/$defs/id" }, "producer": { "$ref": "#/$defs/producer" }, "observedAt": { "type": "string", "format": "date-time" }, "rawHash": { "$ref": "#/$defs/hash" }, "canonicalHash": { "type": ["string", "null"], "pattern": "^sha256:[a-f0-9]{64}$" } } },
259
+ "artifactProvenance": { "type": "object", "additionalProperties": false, "required": ["artifactId", "rawHash", "canonicalHash"], "properties": { "artifactId": { "$ref": "#/$defs/id" }, "rawHash": { "$ref": "#/$defs/hash" }, "canonicalHash": { "type": ["string", "null"], "pattern": "^sha256:[a-f0-9]{64}$" } } },
260
+ "resolutionError": { "type": "object", "additionalProperties": false, "required": ["resolutionId", "error", "resolvedAt"], "properties": { "resolutionId": { "$ref": "#/$defs/id" }, "error": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/safeError" }] }, "resolvedAt": { "type": "string", "format": "date-time" } } },
261
+ "safeError": { "type": "object", "additionalProperties": false, "required": ["code", "retryable", "context"], "properties": { "code": { "$ref": "#/$defs/id" }, "retryable": { "type": "boolean" }, "context": { "$ref": "operating-evidence-resolution.schema.json#/$defs/safeErrorContext" } } },
262
+ "causalLink": { "type": "object", "additionalProperties": false, "required": ["kind", "subjectId", "relation", "deepLink"], "properties": { "kind": { "enum": ["claim", "local-claim", "decision", "action", "outcome"] }, "subjectId": { "$ref": "#/$defs/id" }, "relation": { "enum": ["support", "contradiction", "informs", "evaluates"] }, "deepLink": { "$ref": "#/$defs/deepLink" } } },
263
+ "result": { "type": "object", "additionalProperties": false, "required": ["resultId", "operationId", "status", "completedAt", "effectSummary", "targetBeforeHash", "targetAfterHash", "accessReason", "deepLink"], "properties": { "resultId": { "$ref": "#/$defs/id" }, "operationId": { "$ref": "#/$defs/id" }, "status": { "$ref": "#/$defs/id" }, "completedAt": { "type": "string", "format": "date-time" }, "effectSummary": { "oneOf": [{ "type": "null" }, { "$ref": "operating-execution-result.schema.json#/$defs/effectSummary" }] }, "targetBeforeHash": { "type": ["string", "null"], "pattern": "^sha256:[a-f0-9]{64}$" }, "targetAfterHash": { "type": ["string", "null"], "pattern": "^sha256:[a-f0-9]{64}$" }, "accessReason": { "$ref": "#/$defs/accessReason" }, "deepLink": { "$ref": "#/$defs/deepLink" } } },
264
+ "outcomeMetric": { "type": "object", "additionalProperties": false, "required": ["metricId", "metricHash", "baseline", "target", "observed", "unit", "window", "dueAt", "freshness", "confidence"], "properties": { "metricId": { "$ref": "#/$defs/id" }, "metricHash": { "$ref": "#/$defs/hash" }, "baseline": { "type": ["number", "null"] }, "target": { "type": ["number", "null"] }, "observed": { "type": ["number", "null"] }, "unit": { "type": ["string", "null"], "maxLength": 128 }, "window": { "type": ["string", "null"], "maxLength": 512 }, "dueAt": { "type": ["string", "null"], "format": "date-time" }, "freshness": { "enum": ["current", "historical", "stale", "unknown"] }, "confidence": { "type": ["number", "null"], "minimum": 0, "maximum": 1 } } },
265
+ "decisionRef": { "type": "object", "additionalProperties": false, "required": ["decisionId", "revision", "state", "deepLink"], "properties": { "decisionId": { "$ref": "#/$defs/id" }, "revision": { "type": "integer", "minimum": 1 }, "state": { "$ref": "#/$defs/id" }, "deepLink": { "$ref": "#/$defs/deepLink" } } },
266
+ "verification": { "type": "object", "additionalProperties": false, "required": ["verificationPlanId", "verificationPlanHash", "metricId", "metricHash", "method", "evaluationRules", "observationRequest", "accessReason"], "properties": { "verificationPlanId": { "$ref": "#/$defs/id" }, "verificationPlanHash": { "$ref": "#/$defs/hash" }, "metricId": { "$ref": "#/$defs/id" }, "metricHash": { "$ref": "#/$defs/hash" }, "method": { "$ref": "#/$defs/nullableText" }, "evaluationRules": { "type": "array", "items": { "$ref": "#/$defs/text" } }, "observationRequest": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/observationRequest" }] }, "accessReason": { "$ref": "#/$defs/accessReason" } } },
267
+ "observationRequest": { "type": "object", "additionalProperties": false, "required": ["kind", "reason"], "properties": { "kind": { "enum": ["future-observation", "future-analysis"] }, "reason": { "$ref": "#/$defs/text" } } },
268
+ "nextObservation": { "type": "object", "additionalProperties": false, "required": ["kind", "reason", "dueAt"], "properties": { "kind": { "enum": ["future-observation", "future-analysis"] }, "reason": { "$ref": "#/$defs/text" }, "dueAt": { "type": ["string", "null"], "format": "date-time" } } },
269
+ "revisit": { "type": "object", "additionalProperties": false, "required": ["decisionIds", "conditions"], "properties": { "decisionIds": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/id" } }, "conditions": { "type": "array", "items": { "$ref": "#/$defs/text" } } } },
270
+ "historyChange": { "type": "object", "additionalProperties": false, "required": ["subjectKind", "summary"], "properties": { "subjectKind": { "type": ["string", "null"], "maxLength": 128 }, "summary": { "$ref": "#/$defs/nullableText" } } },
271
+ "historyAuthority": { "type": "object", "additionalProperties": false, "required": ["evaluationId", "approvalIds", "grantId", "capability"], "properties": { "evaluationId": { "$ref": "#/$defs/id" }, "approvalIds": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/id" } }, "grantId": { "$ref": "#/$defs/id" }, "capability": { "$ref": "operating-governed-operation.schema.json#/$defs/versionedId" } } },
272
+ "historyPrior": { "type": "object", "additionalProperties": false, "required": ["previousEventHash", "causationId"], "properties": { "previousEventHash": { "type": ["string", "null"], "pattern": "^sha256:[a-f0-9]{64}$" }, "causationId": { "type": ["string", "null"], "maxLength": 128 } } },
273
+ "historyResult": { "type": "object", "additionalProperties": false, "required": ["status", "completedAt"], "properties": { "status": { "$ref": "#/$defs/id" }, "completedAt": { "type": ["string", "null"], "format": "date-time" } } },
274
+ "beforeAfter": { "type": "object", "additionalProperties": false, "required": ["deltaId", "kind", "priorSnapshotId", "currentSnapshotId"], "properties": { "deltaId": { "$ref": "#/$defs/id" }, "kind": { "enum": ["added", "removed", "changed", "stale", "conflict"] }, "priorSnapshotId": { "type": ["string", "null"], "maxLength": 128 }, "currentSnapshotId": { "$ref": "#/$defs/id" } } },
275
+ "replayCheckpoint": { "type": "object", "additionalProperties": false, "required": ["createdAt", "eventHead", "runtimeStateHash", "eventReplayIndexHash", "recoveryVersion"], "properties": { "createdAt": { "type": "string", "format": "date-time" }, "eventHead": { "$ref": "#/$defs/eventHead" }, "runtimeStateHash": { "$ref": "#/$defs/hash" }, "eventReplayIndexHash": { "$ref": "#/$defs/hash" }, "recoveryVersion": { "$ref": "#/$defs/version" } } },
276
+ "replayTail": { "type": "object", "additionalProperties": false, "required": ["startSequence", "endSequence", "eventCount", "eventReplayIndexHash"], "properties": { "startSequence": { "type": ["integer", "null"], "minimum": 1 }, "endSequence": { "type": ["integer", "null"], "minimum": 1 }, "eventCount": { "type": "integer", "minimum": 0 }, "eventReplayIndexHash": { "$ref": "#/$defs/hash" } } },
277
+ "parityProof": { "type": "object", "additionalProperties": false, "required": ["sourceStateHash", "eventReplayIndexHash", "checkpointVerified", "finalEventHashMatches", "stateParityVerified"], "properties": { "sourceStateHash": { "$ref": "#/$defs/hash" }, "eventReplayIndexHash": { "$ref": "#/$defs/hash" }, "checkpointVerified": { "type": "boolean" }, "finalEventHashMatches": { "type": "boolean" }, "stateParityVerified": { "type": "boolean" } } },
278
+ "boundAllowedAction": { "type": "object", "additionalProperties": false, "required": ["subjectId", "action"], "properties": { "subjectId": { "$ref": "#/$defs/id" }, "action": { "$ref": "operate-allowed-action.schema.json" } } },
279
+ "omission": { "type": "object", "additionalProperties": false, "required": ["classification", "count", "reason"], "properties": { "classification": { "enum": ["public", "internal", "confidential", "restricted"] }, "count": { "type": "integer", "minimum": 1 }, "reason": { "enum": ["access-denied", "body-never-projected", "identity-redacted"] } } }
280
+ }
281
+ }
@@ -0,0 +1,48 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://openplanr.dev/schemas/v2.0.0/operate-live-evidence-provider-registration.schema.json",
4
+ "x-openplanr-contract": { "id": "operate-live-evidence-provider-registration", "version": "2.0.0" },
5
+ "title": "Operate Live Evidence Provider Registration",
6
+ "type": "object",
7
+ "additionalProperties": false,
8
+ "required": ["kind", "schemaVersion", "protocolVersion", "providerId", "providerVersion", "adapterVersion", "baseEvidenceProvider", "baseResolver", "supportedKinds", "supportedDomains", "effects", "bounds", "consent", "sensitivity", "health", "retry", "idempotency", "inputContract", "outputContract", "errorContract", "errorCodes", "provenance", "conformanceDigest", "implementation", "fallback", "registrationHash"],
9
+ "properties": {
10
+ "kind": { "const": "operate-live-evidence-provider-registration" },
11
+ "schemaVersion": { "const": "1.0.0" },
12
+ "protocolVersion": { "const": "2.0.0" },
13
+ "providerId": { "$ref": "#/$defs/id" },
14
+ "providerVersion": { "$ref": "#/$defs/version" },
15
+ "adapterVersion": { "$ref": "#/$defs/version" },
16
+ "baseEvidenceProvider": { "$ref": "#/$defs/evidenceProviderRef" },
17
+ "baseResolver": { "$ref": "#/$defs/resolverRef" },
18
+ "supportedKinds": { "type": "array", "minItems": 1, "maxItems": 16, "uniqueItems": true, "items": { "$ref": "#/$defs/id" } },
19
+ "supportedDomains": { "type": "array", "minItems": 1, "maxItems": 8, "uniqueItems": true, "items": { "$ref": "#/$defs/id" } },
20
+ "effects": { "type": "array", "minItems": 1, "maxItems": 1, "uniqueItems": true, "items": { "const": "provider-call" } },
21
+ "bounds": { "$ref": "#/$defs/bounds" },
22
+ "consent": { "type": "object", "additionalProperties": false, "required": ["required", "mode", "docketRequired", "noDefaultChoice", "previewEffect", "runtimeCapability", "credentialRefKinds"], "properties": { "required": { "const": true }, "mode": { "const": "named-owner-current" }, "docketRequired": { "const": true }, "noDefaultChoice": { "const": true }, "previewEffect": { "const": "none" }, "runtimeCapability": { "const": "opaque-local-preissued" }, "credentialRefKinds": { "type": "array", "minItems": 1, "maxItems": 2, "uniqueItems": true, "items": { "enum": ["environment-name", "os-custody-key"] } } } },
23
+ "sensitivity": { "type": "object", "additionalProperties": false, "required": ["maximumInput", "maximumOutput", "rawRestrictedPortable"], "properties": { "maximumInput": { "$ref": "#/$defs/classification" }, "maximumOutput": { "$ref": "#/$defs/classification" }, "rawRestrictedPortable": { "const": false } } },
24
+ "health": { "type": "object", "additionalProperties": false, "required": ["statuses", "maxAgeSeconds", "unavailableBehavior"], "properties": { "statuses": { "type": "array", "minItems": 3, "maxItems": 3, "uniqueItems": true, "items": { "enum": ["available", "degraded", "unavailable"] } }, "maxAgeSeconds": { "type": "integer", "minimum": 1, "maximum": 86400 }, "unavailableBehavior": { "const": "typed-absence" } } },
25
+ "retry": { "type": "object", "additionalProperties": false, "required": ["maxAttempts", "backoff", "retryableErrors"], "properties": { "maxAttempts": { "type": "integer", "minimum": 1, "maximum": 3 }, "backoff": { "enum": ["none", "bounded-exponential"] }, "retryableErrors": { "type": "array", "maxItems": 8, "uniqueItems": true, "items": { "$ref": "#/$defs/error" } } } },
26
+ "idempotency": { "type": "object", "additionalProperties": false, "required": ["identitySource", "exactReplay", "divergentReplay"], "properties": { "identitySource": { "const": "runtime-derived-request-hash" }, "exactReplay": { "const": "return-recorded-result" }, "divergentReplay": { "const": "conflict" } } },
27
+ "inputContract": { "allOf": [{ "$ref": "#/$defs/contract" }, { "properties": { "schemaId": { "const": "operating-assignment" } } }] },
28
+ "outputContract": { "allOf": [{ "$ref": "#/$defs/contract" }, { "properties": { "schemaId": { "const": "operating-live-evidence-ingestion" } } }] },
29
+ "errorContract": { "allOf": [{ "$ref": "#/$defs/contract" }, { "properties": { "schemaId": { "const": "operate-api-envelope" } } }] },
30
+ "errorCodes": { "type": "array", "minItems": 1, "maxItems": 16, "uniqueItems": true, "items": { "$ref": "#/$defs/error" } },
31
+ "provenance": { "type": "object", "additionalProperties": false, "required": ["packageName", "packageVersion", "integrity"], "properties": { "packageName": { "$ref": "#/$defs/id" }, "packageVersion": { "$ref": "#/$defs/version" }, "integrity": { "$ref": "#/$defs/hash" } } },
32
+ "conformanceDigest": { "$ref": "#/$defs/hash" },
33
+ "implementation": { "type": "object", "additionalProperties": false, "required": ["kind", "id"], "properties": { "kind": { "const": "runtime-adapter" }, "id": { "$ref": "#/$defs/id" } } },
34
+ "fallback": { "type": "object", "additionalProperties": false, "required": ["kind", "errorCode"], "properties": { "kind": { "const": "unavailable" }, "errorCode": { "const": "LIVE_EVIDENCE_PROVIDER_UNAVAILABLE" } } },
35
+ "registrationHash": { "$ref": "#/$defs/hash" }
36
+ },
37
+ "$defs": {
38
+ "id": { "type": "string", "pattern": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$" },
39
+ "version": { "type": "string", "pattern": "^(?:0|[1-9][0-9]*)\\.(?:0|[1-9][0-9]*)\\.(?:0|[1-9][0-9]*)$" },
40
+ "hash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
41
+ "error": { "type": "string", "pattern": "^[A-Z][A-Z0-9_]*$" },
42
+ "classification": { "enum": ["public", "internal", "confidential", "restricted"] },
43
+ "contract": { "type": "object", "additionalProperties": false, "required": ["schemaId", "schemaVersion"], "properties": { "schemaId": { "$ref": "#/$defs/id" }, "schemaVersion": { "const": "2.0.0" } } },
44
+ "bounds": { "type": "object", "additionalProperties": false, "required": ["maxCalls", "maxPages", "maxRecords", "maxBytes", "timeoutMs"], "properties": { "maxCalls": { "type": "integer", "minimum": 1, "maximum": 100 }, "maxPages": { "type": "integer", "minimum": 1, "maximum": 100 }, "maxRecords": { "type": "integer", "minimum": 1, "maximum": 10000 }, "maxBytes": { "type": "integer", "minimum": 1, "maximum": 10485760 }, "timeoutMs": { "type": "integer", "minimum": 1, "maximum": 300000 } } },
45
+ "evidenceProviderRef": { "type": "object", "additionalProperties": false, "required": ["contractId", "schemaVersion", "protocolVersion", "providerId", "providerVersion", "recordDigest"], "properties": { "contractId": { "const": "operate-evidence-provider-registration" }, "schemaVersion": { "const": "1.0.0" }, "protocolVersion": { "const": "2.0.0" }, "providerId": { "$ref": "#/$defs/id" }, "providerVersion": { "$ref": "#/$defs/version" }, "recordDigest": { "$ref": "#/$defs/hash" } } },
46
+ "resolverRef": { "type": "object", "additionalProperties": false, "required": ["contractId", "schemaVersion", "protocolVersion", "resolverId", "resolverVersion", "recordDigest"], "properties": { "contractId": { "const": "operate-evidence-resolver-registration" }, "schemaVersion": { "const": "1.0.0" }, "protocolVersion": { "const": "2.0.0" }, "resolverId": { "$ref": "#/$defs/id" }, "resolverVersion": { "$ref": "#/$defs/version" }, "recordDigest": { "$ref": "#/$defs/hash" } } }
47
+ }
48
+ }
@@ -0,0 +1,17 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://openplanr.dev/schemas/v2.0.0/operate-live-evidence-provider-registry.schema.json",
4
+ "x-openplanr-contract": { "id": "operate-live-evidence-provider-registry", "version": "2.0.0" },
5
+ "title": "Operate Live Evidence Provider Registry",
6
+ "type": "object",
7
+ "additionalProperties": false,
8
+ "required": ["kind", "schemaVersion", "protocolVersion", "registryVersion", "providers", "registryHash"],
9
+ "properties": {
10
+ "kind": { "const": "operate-live-evidence-provider-registry" },
11
+ "schemaVersion": { "const": "1.0.0" },
12
+ "protocolVersion": { "const": "2.0.0" },
13
+ "registryVersion": { "const": "1.0.0" },
14
+ "providers": { "type": "array", "maxItems": 32, "items": { "$ref": "./operate-live-evidence-provider-registration.schema.json" } },
15
+ "registryHash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }
16
+ }
17
+ }
@@ -0,0 +1,12 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://openplanr.dev/schemas/v2.0.0/operate-metric-provider-registration.schema.json",
4
+ "x-openplanr-contract": { "id": "operate-metric-provider-registration", "version": "2.0.0" },
5
+ "title": "OpenPlanr Operate 2.0 metric provider declaration",
6
+ "description": "A data-only, non-authorizing descriptor for a public built-in that returns an accepted-input metric-observation candidate.",
7
+ "type": "object",
8
+ "additionalProperties": false,
9
+ "required": ["kind", "schemaVersion", "protocolVersion", "providerId", "providerVersion", "supportedDomains", "inputContract", "outputContract", "accessMode", "returnSemantics", "errorCodes", "provenance", "conformanceDigest", "implementation", "fallback"],
10
+ "properties": { "kind": { "const": "operate-metric-provider-registration" }, "schemaVersion": { "const": "1.0.0" }, "protocolVersion": { "const": "2.0.0" }, "providerId": { "$ref": "#/$defs/id" }, "providerVersion": { "$ref": "#/$defs/version" }, "supportedDomains": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "$ref": "#/$defs/domain" } }, "inputContract": { "$ref": "#/$defs/inputContract" }, "outputContract": { "$ref": "#/$defs/outputContract" }, "accessMode": { "enum": ["accepted-input-only", "declared-read-only"] }, "returnSemantics": { "const": "candidate" }, "errorCodes": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "enum": ["OPERATING_PROVIDER_INPUT_INVALID", "OPERATING_PROVIDER_UNAVAILABLE"] } }, "provenance": { "$ref": "#/$defs/provenance" }, "conformanceDigest": { "$ref": "#/$defs/hash" }, "implementation": { "$ref": "#/$defs/builtIn" }, "fallback": { "$ref": "#/$defs/fallback" } },
11
+ "$defs": { "builtIn": { "type": "object", "additionalProperties": false, "required": ["kind", "id"], "properties": { "kind": { "const": "built-in" }, "id": { "$ref": "#/$defs/id" } } }, "domain": { "type": "object", "additionalProperties": false, "required": ["apiDomainId", "domainContractId", "domainContractVersion"], "properties": { "apiDomainId": { "$ref": "#/$defs/id" }, "domainContractId": { "$ref": "#/$defs/id" }, "domainContractVersion": { "$ref": "#/$defs/version" } } }, "fallback": { "type": "object", "additionalProperties": false, "required": ["kind", "errorCode"], "properties": { "kind": { "const": "unavailable" }, "errorCode": { "const": "OPERATING_PROVIDER_UNAVAILABLE" } } }, "hash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "id": { "type": "string", "minLength": 1, "maxLength": 128, "pattern": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$" }, "inputContract": { "type": "object", "additionalProperties": false, "required": ["schemaId", "schemaVersion"], "properties": { "schemaId": { "enum": ["operating-artifact", "operating-snapshot", "operating-metric"] }, "schemaVersion": { "const": "2.0.0" } } }, "outputContract": { "type": "object", "additionalProperties": false, "required": ["schemaId", "schemaVersion"], "properties": { "schemaId": { "const": "operating-metric-observation" }, "schemaVersion": { "const": "2.0.0" } } }, "provenance": { "type": "object", "additionalProperties": false, "required": ["packageName", "packageVersion", "integrity"], "properties": { "packageName": { "$ref": "#/$defs/id" }, "packageVersion": { "$ref": "#/$defs/version" }, "integrity": { "$ref": "#/$defs/hash" } } }, "version": { "type": "string", "pattern": "^(?:0|[1-9][0-9]*)\\.(?:0|[1-9][0-9]*)\\.(?:0|[1-9][0-9]*)$" } }
12
+ }
@@ -0,0 +1,33 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "https://openplanr.dev/schemas/v2.0.0/operate-policy-provider-registration.schema.json",
3
+ "x-openplanr-contract": { "id": "operate-policy-provider-registration", "version": "2.0.0" }, "title": "OpenPlanr Operate 2.0 policy provider registration",
4
+ "type": "object", "additionalProperties": false,
5
+ "required": ["kind", "schemaVersion", "protocolVersion", "providerId", "providerVersion", "policyRefs", "supportedActionKinds", "supportedDomains", "effectCeiling", "tier", "precedence", "narrowingOnly", "inputContract", "outputContract", "errorContract", "errorCodes", "timeoutPolicy", "retryPolicy", "idempotency", "reconciliation", "health", "versionCompatibility", "provenance", "conformanceDigest", "implementation", "fallback"],
6
+ "properties": {
7
+ "kind": { "const": "operate-policy-provider-registration" }, "schemaVersion": { "const": "1.0.0" }, "protocolVersion": { "const": "2.0.0" }, "providerId": { "$ref": "#/$defs/id" }, "providerVersion": { "$ref": "#/$defs/version" },
8
+ "policyRefs": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "$ref": "#/$defs/versionedId" } }, "supportedActionKinds": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "$ref": "#/$defs/versionedId" } }, "supportedDomains": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "$ref": "#/$defs/id" } }, "effectCeiling": { "$ref": "#/$defs/effect" },
9
+ "tier": { "enum": ["core", "project", "domain"] }, "precedence": { "enum": [100, 200, 300] }, "narrowingOnly": { "type": "boolean" },
10
+ "inputContract": { "allOf": [{ "$ref": "#/$defs/contract" }, { "properties": { "schemaId": { "const": "operating-action" } } }] }, "outputContract": { "allOf": [{ "$ref": "#/$defs/contract" }, { "properties": { "schemaId": { "const": "operating-policy-evaluation" } } }] }, "errorContract": { "allOf": [{ "$ref": "#/$defs/contract" }, { "properties": { "schemaId": { "const": "operate-api-envelope" } } }] },
11
+ "errorCodes": { "$ref": "#/$defs/errorCodes" }, "timeoutPolicy": { "$ref": "#/$defs/timeoutPolicy" }, "retryPolicy": { "$ref": "#/$defs/retryPolicy" }, "idempotency": { "$ref": "#/$defs/idempotency" }, "reconciliation": { "$ref": "#/$defs/reconciliation" }, "health": { "$ref": "#/$defs/health" }, "versionCompatibility": { "$ref": "#/$defs/versionCompatibility" },
12
+ "provenance": { "$ref": "#/$defs/provenance" }, "conformanceDigest": { "$ref": "#/$defs/hash" }, "implementation": { "$ref": "#/$defs/implementation" }, "fallback": { "$ref": "#/$defs/fallback" }
13
+ }, "$defs": {
14
+ "id": { "type": "string", "pattern": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$" }, "version": { "type": "string", "pattern": "^(?:0|[1-9][0-9]*)\\.(?:0|[1-9][0-9]*)\\.(?:0|[1-9][0-9]*)$" }, "hash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "effect": { "enum": ["read-only", "machine-local-write", "project-write", "provider-call", "external-effect"] }, "versionedId": { "type": "object", "additionalProperties": false, "required": ["id", "version"], "properties": { "id": { "$ref": "#/$defs/id" }, "version": { "$ref": "#/$defs/version" } } }, "contract": { "type": "object", "additionalProperties": false, "required": ["schemaId", "schemaVersion"], "properties": { "schemaId": { "$ref": "#/$defs/id" }, "schemaVersion": { "const": "2.0.0" } } },
15
+ "errorCodes": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "pattern": "^[A-Z][A-Z0-9_]*$" } }, "timeoutPolicy": { "type": "object", "additionalProperties": false, "required": ["timeoutMs", "onTimeout"], "properties": { "timeoutMs": { "type": "integer", "minimum": 1, "maximum": 300000 }, "onTimeout": { "const": "fail-closed" } } }, "retryPolicy": { "type": "object", "additionalProperties": false, "required": ["maxAttempts", "backoff", "retryableErrorCodes"], "properties": { "maxAttempts": { "type": "integer", "minimum": 1, "maximum": 3 }, "backoff": { "enum": ["none", "fixed"] }, "retryableErrorCodes": { "$ref": "#/$defs/errorCodes" } } },
16
+ "idempotency": { "type": "object", "additionalProperties": false, "required": ["keySource", "replay", "intrinsicallyIdempotent"], "properties": { "keySource": { "const": "runtime-derived-request-fingerprint" }, "replay": { "const": "return-recorded-result" }, "intrinsicallyIdempotent": { "type": "boolean" } } },
17
+ "reconciliation": {
18
+ "type": "object", "additionalProperties": false, "required": ["supported", "mode"],
19
+ "properties": { "supported": { "type": "boolean" }, "mode": { "enum": ["none", "deterministic"] } },
20
+ "oneOf": [
21
+ { "properties": { "supported": { "const": false }, "mode": { "const": "none" } } },
22
+ { "properties": { "supported": { "const": true }, "mode": { "const": "deterministic" } } }
23
+ ]
24
+ },
25
+ "health": { "type": "object", "additionalProperties": false, "required": ["status", "checkedAt", "expiresAt", "healthHash"], "properties": { "status": { "enum": ["available", "degraded", "unavailable"] }, "checkedAt": { "type": "string", "format": "date-time" }, "expiresAt": { "type": "string", "format": "date-time" }, "healthHash": { "$ref": "#/$defs/hash" } } }, "versionCompatibility": { "type": "object", "additionalProperties": false, "required": ["protocolVersion", "minimumRuntimeVersion", "maximumRuntimeVersion"], "properties": { "protocolVersion": { "const": "2.0.0" }, "minimumRuntimeVersion": { "$ref": "#/$defs/version" }, "maximumRuntimeVersion": { "type": ["string", "null"], "pattern": "^(?:0|[1-9][0-9]*)\\.(?:0|[1-9][0-9]*)\\.(?:0|[1-9][0-9]*)$" } } },
26
+ "provenance": { "type": "object", "additionalProperties": false, "required": ["packageName", "packageVersion", "integrity"], "properties": { "packageName": { "$ref": "#/$defs/id" }, "packageVersion": { "$ref": "#/$defs/version" }, "integrity": { "$ref": "#/$defs/hash" } } }, "implementation": { "type": "object", "additionalProperties": false, "required": ["source", "id"], "properties": { "source": { "enum": ["built-in", "public-optional", "external"] }, "id": { "$ref": "#/$defs/id" } } }, "fallback": { "type": "object", "additionalProperties": false, "required": ["kind", "errorCode"], "properties": { "kind": { "const": "unavailable" }, "errorCode": { "const": "POLICY_PROVIDER_UNAVAILABLE" } } }
27
+ },
28
+ "allOf": [
29
+ { "if": { "properties": { "tier": { "const": "core" } } }, "then": { "properties": { "precedence": { "const": 300 }, "narrowingOnly": { "const": false } } } },
30
+ { "if": { "properties": { "tier": { "const": "project" } } }, "then": { "properties": { "precedence": { "const": 200 }, "narrowingOnly": { "const": true } } } },
31
+ { "if": { "properties": { "tier": { "const": "domain" } } }, "then": { "properties": { "precedence": { "const": 100 }, "narrowingOnly": { "const": true } } } }
32
+ ]
33
+ }