semiotic 3.9.1 → 3.10.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 (566) hide show
  1. package/README.md +137 -58
  2. package/agent-skill/semiotic-charts/SKILL.md +27 -17
  3. package/ai/artifact-contract-reference.md +408 -0
  4. package/ai/artifact-surface-inventory.json +5586 -0
  5. package/ai/behaviorContracts.cjs +24 -2
  6. package/ai/cli.js +480 -56
  7. package/ai/componentMetadata.cjs +13 -3
  8. package/ai/dist/mcp-server.js +140 -36407
  9. package/ai/examples.md +110 -7
  10. package/ai/reference.md +82 -28
  11. package/ai/schema.json +7675 -1471
  12. package/ai/surface-manifest.json +60 -9
  13. package/ai/system-prompt.md +18 -3
  14. package/ai/task-packets/compare-category-totals.json +301 -0
  15. package/ai/task-packets/compare-category-totals.md +188 -0
  16. package/ai/task-packets/correct-published-chart.json +271 -0
  17. package/ai/task-packets/correct-published-chart.md +597 -0
  18. package/ai/task-packets/index.json +40 -0
  19. package/ai/task-packets/update-live-chart.json +289 -0
  20. package/ai/task-packets/update-live-chart.md +424 -0
  21. package/dist/c-2N7IU2NY.min.js +1 -0
  22. package/dist/c-2WK7YJLL.min.js +1 -0
  23. package/dist/c-33QOXEUG.min.js +1 -0
  24. package/dist/c-42PLDTX7.min.js +1 -0
  25. package/dist/c-447VIMRO.min.js +1 -0
  26. package/dist/c-4FN7Q6VQ.min.js +1 -0
  27. package/dist/c-553QUDKA.min.js +1 -0
  28. package/dist/c-55BAJ333.min.js +1 -0
  29. package/dist/c-7242NXSG.min.js +1 -0
  30. package/dist/c-7EGHJU2F.min.js +1 -0
  31. package/dist/c-7HP7MB2I.min.js +1 -0
  32. package/dist/c-7NBU5ZKS.min.js +1 -0
  33. package/dist/c-AFBSWT77.min.js +1 -0
  34. package/dist/c-AJ7EC32V.min.js +1 -0
  35. package/dist/c-AQADQNY7.min.js +1 -0
  36. package/dist/c-ATM475SA.min.js +1 -0
  37. package/dist/c-AVO3Q7T7.min.js +1 -0
  38. package/dist/c-AZKPVBOC.min.js +1 -0
  39. package/dist/c-BNFJMDHN.min.js +1 -0
  40. package/dist/c-BNG5ECK5.min.js +1 -0
  41. package/dist/c-BOHCQILI.min.js +1 -0
  42. package/dist/c-CCTGN5CK.min.js +1 -0
  43. package/dist/c-CPSPZH6A.min.js +1 -0
  44. package/dist/c-CPV4N35K.min.js +1 -0
  45. package/dist/c-D6HAAPTX.min.js +1 -0
  46. package/dist/c-DE5Q3U2X.min.js +1 -0
  47. package/dist/c-DK662R77.min.js +1 -0
  48. package/dist/c-DY2676CR.min.js +1 -0
  49. package/dist/c-E32M6XW5.min.js +1 -0
  50. package/dist/c-E4JDJH4I.min.js +1 -0
  51. package/dist/c-E7I2L7CU.min.js +1 -0
  52. package/dist/c-EBOQ7ER7.min.js +1 -0
  53. package/dist/c-ELDWAO2V.min.js +1 -0
  54. package/dist/c-EUBTECGM.min.js +1 -0
  55. package/dist/c-GNTXRXRN.min.js +1 -0
  56. package/dist/c-GSZRZRD6.min.js +1 -0
  57. package/dist/c-GWX7JGMF.min.js +1 -0
  58. package/dist/c-GXV3C3MO.min.js +1 -0
  59. package/dist/c-HHTK2R75.min.js +1 -0
  60. package/dist/c-HLLFJYTY.min.js +1 -0
  61. package/dist/c-HPOYKCCG.min.js +1 -0
  62. package/dist/c-HXDKPIKR.min.js +1 -0
  63. package/dist/c-I4QJ6YLM.min.js +1 -0
  64. package/dist/c-IDJV3CZK.min.js +1 -0
  65. package/dist/c-ITKX3RC5.min.js +1 -0
  66. package/dist/c-JG2JCQLP.min.js +1 -0
  67. package/dist/c-JLGRHXGZ.min.js +1 -0
  68. package/dist/c-JO2UGTCP.min.js +1 -0
  69. package/dist/c-JUKIWTBJ.min.js +1 -0
  70. package/dist/c-KCRJGUHP.min.js +1 -0
  71. package/dist/c-LMGSSD2E.min.js +1 -0
  72. package/dist/c-LYQMZMZQ.min.js +1 -0
  73. package/dist/c-LYVKDBQJ.min.js +1 -0
  74. package/dist/c-MVR3RWF3.min.js +1 -0
  75. package/dist/c-MXCP7GNZ.min.js +1 -0
  76. package/dist/c-NG7BLZTR.min.js +1 -0
  77. package/dist/c-NYZ2QNAM.min.js +1 -0
  78. package/dist/c-OO5QLMJC.min.js +1 -0
  79. package/dist/c-OOVX2JPQ.min.js +1 -0
  80. package/dist/c-ORLEBW72.min.js +1 -0
  81. package/dist/c-P65V6HLO.min.js +1 -0
  82. package/dist/c-PP6VY3QU.min.js +1 -0
  83. package/dist/c-PRIKOLTE.min.js +1 -0
  84. package/dist/c-PSNI6KAZ.min.js +1 -0
  85. package/dist/c-PYNW54D2.min.js +1 -0
  86. package/dist/c-QA3HMQJP.min.js +1 -0
  87. package/dist/c-QAVFOEUY.min.js +1 -0
  88. package/dist/c-ROEHCIGV.min.js +1 -0
  89. package/dist/c-S3AZX5PP.min.js +1 -0
  90. package/dist/c-T2V7O2LO.min.js +1 -0
  91. package/dist/c-TIXX5CAU.min.js +1 -0
  92. package/dist/c-TKG2NP7G.min.js +1 -0
  93. package/dist/c-VJTDST2R.min.js +1 -0
  94. package/dist/c-VXLOLYTO.min.js +1 -0
  95. package/dist/c-W4ZUKSEQ.min.js +1 -0
  96. package/dist/c-WH2O53VI.min.js +1 -0
  97. package/dist/c-WNGH47HF.min.js +1 -0
  98. package/dist/c-WUWXGQYA.min.js +1 -0
  99. package/dist/c-XDQKXPX4.min.js +1 -0
  100. package/dist/c-XSB27XPS.min.js +1 -0
  101. package/dist/c-YDECTEUW.min.js +1 -0
  102. package/dist/c-YF3YKVQI.min.js +1 -0
  103. package/dist/c-YLZIV3VS.min.js +1 -0
  104. package/dist/c-ZYPXQF7B.min.js +1 -0
  105. package/dist/components/Annotation.d.ts +3 -2
  106. package/dist/components/access/chartAccessCapabilities.generated.d.ts +14 -0
  107. package/dist/components/access/chartAccessContract.d.ts +90 -0
  108. package/dist/components/access/chartAccessContractFixtures.d.ts +11 -0
  109. package/dist/components/ai/aestheticProfileTypes.d.ts +35 -0
  110. package/dist/components/ai/annotationProvenance.d.ts +2 -7
  111. package/dist/components/ai/auditVisualHierarchy.d.ts +49 -0
  112. package/dist/components/ai/builtInChartRecipeLayouts.d.ts +2 -0
  113. package/dist/components/ai/builtInChartRecipePublic.d.ts +4 -0
  114. package/dist/components/ai/builtInChartRecipes.d.ts +26 -0
  115. package/dist/components/ai/chartCapabilities.d.ts +3 -1
  116. package/dist/components/ai/chartRecipeRegistry.d.ts +7 -1
  117. package/dist/components/ai/chartRecipes.d.ts +10 -0
  118. package/dist/components/ai/colorEvidence.d.ts +12 -0
  119. package/dist/components/ai/describePhysicsProjection.d.ts +18 -0
  120. package/dist/components/ai/describePhysicsSource.d.ts +13 -0
  121. package/dist/components/ai/evaluateAesthetics.d.ts +47 -0
  122. package/dist/components/ai/geoNavigation.d.ts +4 -0
  123. package/dist/components/ai/hierarchyNavigation.d.ts +4 -0
  124. package/dist/components/ai/navigationTree.d.ts +7 -1
  125. package/dist/components/ai/qualityFixtures.d.ts +8 -0
  126. package/dist/components/ai/suggestionPropContracts.d.ts +1 -1
  127. package/dist/components/ai/useNavigationSync.d.ts +3 -3
  128. package/dist/components/artifact/ArtifactInspector.d.ts +26 -0
  129. package/dist/components/artifact/ArtifactInspectorContextSections.d.ts +18 -0
  130. package/dist/components/artifact/artifactContractDiff.d.ts +8 -0
  131. package/dist/components/artifact/artifactInspectorSummary.d.ts +53 -0
  132. package/dist/components/artifact/artifactRevision.d.ts +54 -0
  133. package/dist/components/artifact/artifactTestFixtures.d.ts +17 -0
  134. package/dist/components/artifact/attachmentAudit.d.ts +13 -0
  135. package/dist/components/artifact/claimCorrections.d.ts +3 -0
  136. package/dist/components/artifact/claimGraph.d.ts +5 -0
  137. package/dist/components/artifact/claimLifecycle.d.ts +32 -0
  138. package/dist/components/artifact/claims.d.ts +24 -0
  139. package/dist/components/artifact/collection.d.ts +10 -0
  140. package/dist/components/artifact/collectionCorrectionScope.d.ts +4 -0
  141. package/dist/components/artifact/collectionImpact.d.ts +11 -0
  142. package/dist/components/artifact/collectionLineage.d.ts +3 -0
  143. package/dist/components/artifact/collectionOperations.d.ts +8 -0
  144. package/dist/components/artifact/collectionPolicy.d.ts +22 -0
  145. package/dist/components/artifact/collectionTypes.d.ts +117 -0
  146. package/dist/components/artifact/configurationRepair.d.ts +8 -0
  147. package/dist/components/artifact/contract.d.ts +30 -0
  148. package/dist/components/artifact/evaluateArtifact.d.ts +12 -0
  149. package/dist/components/artifact/evaluateArtifactTypes.d.ts +78 -0
  150. package/dist/components/artifact/evaluationPresentation.d.ts +9 -0
  151. package/dist/components/artifact/evidenceSample.d.ts +8 -0
  152. package/dist/components/artifact/exportPaths.d.ts +8 -0
  153. package/dist/components/artifact/fieldPolicies.d.ts +12 -0
  154. package/dist/components/artifact/fingerprint.d.ts +36 -0
  155. package/dist/components/artifact/grounding.d.ts +51 -0
  156. package/dist/components/artifact/groundingBudget.d.ts +38 -0
  157. package/dist/components/artifact/hostTransfer.d.ts +13 -0
  158. package/dist/components/artifact/identity.d.ts +19 -0
  159. package/dist/components/artifact/inheritance.d.ts +48 -0
  160. package/dist/components/artifact/inheritanceIntegrity.d.ts +3 -0
  161. package/dist/components/artifact/jsonCompatibility.d.ts +2 -0
  162. package/dist/components/artifact/obligations.d.ts +3 -0
  163. package/dist/components/artifact/policies.d.ts +45 -0
  164. package/dist/components/artifact/policyRelations.d.ts +3 -0
  165. package/dist/components/artifact/recordProjection.d.ts +7 -0
  166. package/dist/components/artifact/representation.d.ts +50 -0
  167. package/dist/components/artifact/serialization.d.ts +40 -0
  168. package/dist/components/artifact/temporal.d.ts +32 -0
  169. package/dist/components/artifact/temporalAdapters.d.ts +75 -0
  170. package/dist/components/artifact/temporalAuditHelpers.d.ts +12 -0
  171. package/dist/components/artifact/temporalPresentation.d.ts +8 -0
  172. package/dist/components/artifact/types.d.ts +341 -0
  173. package/dist/components/artifact/validation.d.ts +13 -0
  174. package/dist/components/artifact/validationFieldStatus.d.ts +7 -0
  175. package/dist/components/artifact/validationPrimitives.d.ts +24 -0
  176. package/dist/components/artifact/validationSurfaces.d.ts +7 -0
  177. package/dist/components/artifact/validationTemporal.d.ts +3 -0
  178. package/dist/components/charts/geo/FlowMap.d.ts +7 -0
  179. package/dist/components/charts/geo/flowMapLineStyle.d.ts +18 -0
  180. package/dist/components/charts/index.d.ts +4 -0
  181. package/dist/components/charts/network/ChordDiagram.d.ts +5 -1
  182. package/dist/components/charts/network/CirclePack.d.ts +8 -1
  183. package/dist/components/charts/network/OrbitDiagram.d.ts +9 -0
  184. package/dist/components/charts/network/TreeDiagram.d.ts +8 -1
  185. package/dist/components/charts/network/Treemap.d.ts +8 -1
  186. package/dist/components/charts/ordinal/BarChart.d.ts +6 -0
  187. package/dist/components/charts/ordinal/BoxPlot.d.ts +3 -0
  188. package/dist/components/charts/ordinal/DonutChart.d.ts +5 -0
  189. package/dist/components/charts/ordinal/DotPlot.d.ts +3 -0
  190. package/dist/components/charts/ordinal/FunnelChart.d.ts +5 -0
  191. package/dist/components/charts/ordinal/GaugeChart.d.ts +3 -0
  192. package/dist/components/charts/ordinal/GroupedBarChart.d.ts +6 -0
  193. package/dist/components/charts/ordinal/Histogram.d.ts +3 -0
  194. package/dist/components/charts/ordinal/LikertChart.d.ts +3 -0
  195. package/dist/components/charts/ordinal/PieChart.d.ts +5 -0
  196. package/dist/components/charts/ordinal/RadarChart.capability.d.ts +2 -0
  197. package/dist/components/charts/ordinal/RadarChart.d.ts +77 -0
  198. package/dist/components/charts/ordinal/RidgelinePlot.d.ts +3 -0
  199. package/dist/components/charts/ordinal/StackedBarChart.d.ts +6 -0
  200. package/dist/components/charts/ordinal/SwarmPlot.d.ts +3 -0
  201. package/dist/components/charts/ordinal/SwimlaneChart.d.ts +3 -0
  202. package/dist/components/charts/ordinal/ViolinPlot.d.ts +3 -0
  203. package/dist/components/charts/physics/CollisionSwarmChart.d.ts +1 -1
  204. package/dist/components/charts/physics/EventDropChart.d.ts +3 -1
  205. package/dist/components/charts/physics/GaltonBoardChart.d.ts +4 -2
  206. package/dist/components/charts/physics/GauntletChart.d.ts +1 -5
  207. package/dist/components/charts/physics/ProcessFlowChart.d.ts +6 -0
  208. package/dist/components/charts/physics/UnitPileChart.d.ts +2 -1
  209. package/dist/components/charts/physics/chainReactionTypes.d.ts +3 -0
  210. package/dist/components/charts/physics/collisionSwarmPacking.d.ts +14 -0
  211. package/dist/components/charts/physics/collisionSwarmPhysics.d.ts +1 -0
  212. package/dist/components/charts/physics/eventDropAdmission.d.ts +32 -0
  213. package/dist/components/charts/physics/eventDropPhysics.d.ts +22 -1
  214. package/dist/components/charts/physics/galtonBoardPhysics.d.ts +2 -9
  215. package/dist/components/charts/physics/gauntletPhysics.d.ts +1 -0
  216. package/dist/components/charts/physics/physicsChartReconcile.d.ts +4 -0
  217. package/dist/components/charts/physics/physicsChartUtils.d.ts +1 -1
  218. package/dist/components/charts/physics/physicsGaltonData.d.ts +10 -0
  219. package/dist/components/charts/physics/physicsHocHandle.d.ts +2 -0
  220. package/dist/components/charts/physics/physicsHocUtils.d.ts +7 -1
  221. package/dist/components/charts/physics/physicsPileData.d.ts +11 -0
  222. package/dist/components/charts/physics/physicsPilePhysics.d.ts +5 -12
  223. package/dist/components/charts/physics/physicsProjectionOverlays.d.ts +1 -1
  224. package/dist/components/charts/physics/physicsSourceRows.d.ts +8 -0
  225. package/dist/components/charts/physics/usePhysicsChartData.d.ts +19 -0
  226. package/dist/components/charts/realtime/RealtimeHeatmap.d.ts +14 -1
  227. package/dist/components/charts/realtime/RealtimeHistogram.d.ts +25 -7
  228. package/dist/components/charts/realtime/RealtimeLineChart.d.ts +18 -5
  229. package/dist/components/charts/realtime/RealtimeSwarmChart.d.ts +11 -1
  230. package/dist/components/charts/realtime/RealtimeWaterfallChart.d.ts +11 -1
  231. package/dist/components/charts/realtime/aggregate.d.ts +12 -1
  232. package/dist/components/charts/realtime/realtimeAccessors.d.ts +4 -0
  233. package/dist/components/charts/realtime/realtimeChartRuntime.d.ts +8 -5
  234. package/dist/components/charts/realtime/realtimeChartTypes.d.ts +7 -0
  235. package/dist/components/charts/realtime/realtimeStyleRules.d.ts +4 -0
  236. package/dist/components/charts/realtime/temporalHistogramConfig.d.ts +17 -11
  237. package/dist/components/charts/shared/GaugeReadout.d.ts +9 -0
  238. package/dist/components/charts/shared/ThresholdAnnotation.d.ts +18 -0
  239. package/dist/components/charts/shared/ThresholdEndCap.d.ts +7 -0
  240. package/dist/components/charts/shared/annotationStatusFilter.d.ts +18 -0
  241. package/dist/components/charts/shared/auditAccessibilityText.d.ts +4 -2
  242. package/dist/components/charts/shared/chartDefinitionPilot.d.ts +5 -4
  243. package/dist/components/charts/shared/chartSpecCore.d.ts +2 -2
  244. package/dist/components/charts/shared/heatmapStyleRules.d.ts +13 -0
  245. package/dist/components/charts/shared/knownChartComponents.d.ts +1 -1
  246. package/dist/components/charts/shared/networkUtils.d.ts +14 -0
  247. package/dist/components/charts/shared/numericTickFormatter.d.ts +2 -0
  248. package/dist/components/charts/shared/radialCenterContent.d.ts +10 -0
  249. package/dist/components/charts/shared/selectionUtils.d.ts +3 -1
  250. package/dist/components/charts/shared/tooltipUtils.d.ts +1 -1
  251. package/dist/components/charts/shared/types.d.ts +4 -2
  252. package/dist/components/charts/shared/useChartLegend.d.ts +6 -1
  253. package/dist/components/charts/shared/useLikertAggregation.d.ts +8 -2
  254. package/dist/components/charts/shared/useNetworkChartSetup.d.ts +9 -5
  255. package/dist/components/charts/shared/useOrdinalPieceStyle.d.ts +1 -1
  256. package/dist/components/charts/shared/useXYBrush.d.ts +24 -0
  257. package/dist/components/charts/shared/useXYPointStyle.d.ts +2 -0
  258. package/dist/components/charts/xy/BubbleChart.d.ts +7 -0
  259. package/dist/components/charts/xy/CandlestickChart.d.ts +7 -0
  260. package/dist/components/charts/xy/DifferenceChart.d.ts +7 -0
  261. package/dist/components/charts/xy/Heatmap.d.ts +16 -0
  262. package/dist/components/charts/xy/LineChart.d.ts +9 -0
  263. package/dist/components/charts/xy/MinimapChart.d.ts +7 -0
  264. package/dist/components/charts/xy/MultiAxisLineChart.d.ts +7 -0
  265. package/dist/components/charts/xy/Scatterplot.d.ts +7 -0
  266. package/dist/components/charts/xy/ScatterplotMatrix.d.ts +6 -0
  267. package/dist/components/charts/xy/WaterfallChart.capability.d.ts +2 -0
  268. package/dist/components/charts/xy/WaterfallChart.d.ts +76 -0
  269. package/dist/components/charts/xy/differenceMarkStyle.d.ts +28 -0
  270. package/dist/components/charts/xy/multiAxisFields.d.ts +23 -0
  271. package/dist/components/charts/xy/scatterplotMatrixCells.d.ts +50 -0
  272. package/dist/components/evidence/chartEvidenceEnvelope.d.ts +154 -0
  273. package/dist/components/evidence/evidenceEnvelopeInput.d.ts +8 -0
  274. package/dist/components/evidence/evidenceEnvelopeValidation.d.ts +11 -0
  275. package/dist/components/evidence/evidenceGate.d.ts +30 -0
  276. package/dist/components/evidence/renderedSceneHash.d.ts +23 -0
  277. package/dist/components/evidence/stableJsonHash.d.ts +4 -0
  278. package/dist/components/export/chartConfig.d.ts +40 -5
  279. package/dist/components/export/chartConfigArtifact.d.ts +6 -0
  280. package/dist/components/legendLayout.d.ts +18 -0
  281. package/dist/components/legendStyles.d.ts +4 -0
  282. package/dist/components/realtime/BinAccumulator.d.ts +5 -1
  283. package/dist/components/realtime/types.d.ts +16 -7
  284. package/dist/components/recipes/adjacencyFlow.d.ts +12 -0
  285. package/dist/components/recipes/adjacencyFlowAggregation.d.ts +72 -0
  286. package/dist/components/recipes/adjacencyFlowGeometry.d.ts +79 -0
  287. package/dist/components/recipes/firstAvailableTrack.d.ts +17 -0
  288. package/dist/components/recipes/intervals.d.ts +1 -1
  289. package/dist/components/recipes/lineageDag.d.ts +17 -0
  290. package/dist/components/recipes/lineageDagHulls.d.ts +22 -0
  291. package/dist/components/recipes/transitDiagram.d.ts +75 -0
  292. package/dist/components/recipes/transitDiagramGeometry.d.ts +47 -0
  293. package/dist/components/semiotic-access.d.ts +9 -0
  294. package/dist/components/semiotic-ai-audits.d.ts +17 -0
  295. package/dist/components/semiotic-ai-core.d.ts +38 -18
  296. package/dist/components/semiotic-ai.d.ts +20 -20
  297. package/dist/components/semiotic-artifact-react.d.ts +10 -0
  298. package/dist/components/semiotic-artifact.d.ts +23 -0
  299. package/dist/components/semiotic-evidence.d.ts +10 -0
  300. package/dist/components/semiotic-experimental.d.ts +1 -1
  301. package/dist/components/semiotic-line.d.ts +9 -0
  302. package/dist/components/semiotic-network.d.ts +3 -0
  303. package/dist/components/semiotic-ordinal.d.ts +2 -0
  304. package/dist/components/semiotic-physics.d.ts +4 -4
  305. package/dist/components/semiotic-realtime-core.d.ts +3 -2
  306. package/dist/components/semiotic-recipes-core.d.ts +6 -0
  307. package/dist/components/semiotic-text.d.ts +2 -0
  308. package/dist/components/semiotic-themes-core.d.ts +3 -0
  309. package/dist/components/semiotic-utils-core.d.ts +19 -14
  310. package/dist/components/semiotic-xy.d.ts +3 -0
  311. package/dist/components/semiotic.d.ts +11 -5
  312. package/dist/components/server/renderDashboard.d.ts +37 -0
  313. package/dist/components/server/renderEvidence.d.ts +39 -0
  314. package/dist/components/server/renderToStaticSVG.d.ts +5 -30
  315. package/dist/components/server/serverChartConfigShared.d.ts +13 -0
  316. package/dist/components/server/serverChartConfigs.d.ts +9 -0
  317. package/dist/components/server/serverChartConfigsComposite.d.ts +4 -0
  318. package/dist/components/server/serverChartConfigsCustom.d.ts +2 -0
  319. package/dist/components/server/serverChartConfigsGeo.d.ts +1 -0
  320. package/dist/components/server/serverChartConfigsOrdinal.d.ts +3 -2
  321. package/dist/components/server/serverChartConfigsXY.d.ts +1 -0
  322. package/dist/components/server/serverChartConfigsXYExtra.d.ts +3 -0
  323. package/dist/components/server/serverCompositeChainReaction.d.ts +3 -0
  324. package/dist/components/server/serverOrdinalGauge.d.ts +3 -0
  325. package/dist/components/server/serverOrdinalLikert.d.ts +2 -0
  326. package/dist/components/server/staticSVGChrome.d.ts +1 -4
  327. package/dist/components/server/staticXYAxisTicks.d.ts +2 -38
  328. package/dist/components/server/staticXYGrid.d.ts +1 -1
  329. package/dist/components/server/svgSizing.d.ts +6 -0
  330. package/dist/components/shared/svgRoot.d.ts +17 -0
  331. package/dist/components/store/selectionProvenance.d.ts +14 -0
  332. package/dist/components/store/themeCore.d.ts +5 -1
  333. package/dist/components/stream/GeoPipelineStore.d.ts +1 -1
  334. package/dist/components/stream/GeoSVGOverlay.d.ts +4 -0
  335. package/dist/components/stream/MarginalGraphics.d.ts +3 -3
  336. package/dist/components/stream/MarginalGraphicsLazy.d.ts +22 -0
  337. package/dist/components/stream/NetworkPipelineStore.d.ts +2 -0
  338. package/dist/components/stream/NetworkSVGOverlay.d.ts +4 -0
  339. package/dist/components/stream/OrdinalPipelineStore.d.ts +1 -1
  340. package/dist/components/stream/OrdinalSVGOverlay.d.ts +4 -0
  341. package/dist/components/stream/PipelineStore.d.ts +1 -1
  342. package/dist/components/stream/SVGOverlay.d.ts +4 -0
  343. package/dist/components/stream/SceneToSVG.d.ts +4 -19
  344. package/dist/components/stream/SceneToSVGXY.d.ts +13 -0
  345. package/dist/components/stream/StreamGeoFrame.d.ts +1 -2
  346. package/dist/components/stream/StreamOrdinalFrame.d.ts +1 -2
  347. package/dist/components/stream/XYGrid.d.ts +11 -0
  348. package/dist/components/stream/axisTickUtils.d.ts +0 -1
  349. package/dist/components/stream/canvasSetup.d.ts +8 -2
  350. package/dist/components/stream/customLayoutAttempt.d.ts +21 -0
  351. package/dist/components/stream/geoTypes.d.ts +1 -1
  352. package/dist/components/stream/hitTestUtils.d.ts +2 -0
  353. package/dist/components/stream/isServerEnvironment.d.ts +6 -0
  354. package/dist/components/stream/layouts/forceLayoutNodeSize.d.ts +12 -0
  355. package/dist/components/stream/layouts/forceLayoutPlugin.d.ts +2 -9
  356. package/dist/components/stream/layouts/forceLayoutWorkerClient.d.ts +2 -21
  357. package/dist/components/stream/layouts/forceLayoutWorkerPolicy.d.ts +21 -0
  358. package/dist/components/stream/layouts/index.d.ts +6 -12
  359. package/dist/components/stream/layouts/missingPlugin.d.ts +7 -0
  360. package/dist/components/stream/layouts/registerBuiltIn.d.ts +1 -0
  361. package/dist/components/stream/layouts/registry.d.ts +12 -0
  362. package/dist/components/stream/marginalConfig.d.ts +3 -0
  363. package/dist/components/stream/networkCustomLayout.d.ts +7 -0
  364. package/dist/components/stream/networkCustomLayoutOutput.d.ts +13 -0
  365. package/dist/components/stream/networkCustomLayoutRunner.d.ts +1 -1
  366. package/dist/components/stream/networkTypes.d.ts +5 -1
  367. package/dist/components/stream/ordinalTypes.d.ts +1 -1
  368. package/dist/components/stream/overlayAccessibleText.d.ts +18 -0
  369. package/dist/components/stream/physics/PhysicsControllers.d.ts +1 -1
  370. package/dist/components/stream/physics/PhysicsKernel.d.ts +9 -0
  371. package/dist/components/stream/physics/PhysicsPipelineStore.d.ts +5 -4
  372. package/dist/components/stream/physics/PhysicsPipelineTypes.d.ts +9 -0
  373. package/dist/components/stream/physics/StreamPhysicsTypes.d.ts +4 -1
  374. package/dist/components/stream/physics/physicsCanvasCoordinates.d.ts +5 -0
  375. package/dist/components/stream/physics/physicsFixedPosition.d.ts +16 -0
  376. package/dist/components/stream/physics/physicsKernelCloning.d.ts +6 -0
  377. package/dist/components/stream/physics/physicsPipelineObservations.d.ts +2 -0
  378. package/dist/components/stream/physics/physicsPipelineSettle.d.ts +15 -9
  379. package/dist/components/stream/physics/physicsRegionRuntime.d.ts +8 -17
  380. package/dist/components/stream/physics/physicsSemanticUI.d.ts +9 -0
  381. package/dist/components/stream/pipelineConfig.d.ts +4 -0
  382. package/dist/components/stream/pipelineDomainResolution.d.ts +6 -0
  383. package/dist/components/stream/pipelineStoreUpdateResults.d.ts +1 -1
  384. package/dist/components/stream/renderers/pointCanvasRenderer.d.ts +4 -0
  385. package/dist/components/stream/renderers/resolveCSSColor.d.ts +4 -4
  386. package/dist/components/stream/resolveXYAxes.d.ts +13 -0
  387. package/dist/components/stream/sceneToSVGShared.d.ts +2 -1
  388. package/dist/components/stream/seriesGeometry.d.ts +13 -0
  389. package/dist/components/stream/streamEncodingTypes.d.ts +53 -0
  390. package/dist/components/stream/types.d.ts +12 -54
  391. package/dist/components/stream/useEnsureCustomXYRenderers.d.ts +18 -0
  392. package/dist/components/stream/useGeoFrameHandle.d.ts +16 -0
  393. package/dist/components/stream/useMarginalValues.d.ts +13 -0
  394. package/dist/components/stream/useOrdinalFrameHandle.d.ts +15 -0
  395. package/dist/components/stream/useXYFrameHandle.d.ts +15 -0
  396. package/dist/components/stream/xyAxisTicks.d.ts +25 -0
  397. package/dist/components/stream/xyCanvasRenderers.d.ts +4 -4
  398. package/dist/components/stream/xyDateTicks.d.ts +3 -2
  399. package/dist/components/stream/xyFrameAxisTypes.d.ts +2 -0
  400. package/dist/components/stream/xyPlugins/areaPlugin.d.ts +2 -0
  401. package/dist/components/stream/xyPlugins/barPlugin.d.ts +2 -0
  402. package/dist/components/stream/xyPlugins/candlestickPlugin.d.ts +2 -0
  403. package/dist/components/stream/xyPlugins/customPlugin.d.ts +6 -0
  404. package/dist/components/stream/xyPlugins/heatmapPlugin.d.ts +2 -0
  405. package/dist/components/stream/xyPlugins/lineFamily.d.ts +5 -0
  406. package/dist/components/stream/xyPlugins/linePlugin.d.ts +2 -0
  407. package/dist/components/stream/xyPlugins/missingPlugin.d.ts +7 -0
  408. package/dist/components/stream/xyPlugins/mixedPlugin.d.ts +2 -0
  409. package/dist/components/stream/xyPlugins/pointPlugin.d.ts +3 -0
  410. package/dist/components/stream/xyPlugins/registerBuiltIn.d.ts +1 -0
  411. package/dist/components/stream/xyPlugins/registry.d.ts +31 -0
  412. package/dist/components/stream/xyPlugins/stackedAreaPlugin.d.ts +2 -0
  413. package/dist/components/stream/xyPlugins/swarmPlugin.d.ts +2 -0
  414. package/dist/components/stream/xyPlugins/waterfallPlugin.d.ts +2 -0
  415. package/dist/components/stream/xySceneBuilders/ribbonScene.d.ts +1 -1
  416. package/dist/components/stream/xySceneBuilders/types.d.ts +1 -0
  417. package/dist/components/text/annotationTextLayout.d.ts +28 -0
  418. package/dist/components/text/pretextAnnotationLayout.d.ts +29 -0
  419. package/dist/components/text/usePretextAnnotations.d.ts +12 -0
  420. package/dist/controls.module.min.js +1 -1
  421. package/dist/forceLayoutWorker.js +1 -1
  422. package/dist/geo.min.js +1 -1
  423. package/dist/geo.module.min.js +1 -1
  424. package/dist/network.module.min.js +1 -1
  425. package/dist/ordinal.module.min.js +1 -1
  426. package/dist/physics-matter.min.js +1 -1
  427. package/dist/physics-matter.module.min.js +1 -1
  428. package/dist/physics-rapier.min.js +1 -1
  429. package/dist/physics-rapier.module.min.js +1 -1
  430. package/dist/physics.module.min.js +1 -1
  431. package/dist/physicsWorker.js +1 -1
  432. package/dist/processSankeyLayoutWorker.js +1 -1
  433. package/dist/rough.min.js +1 -1
  434. package/dist/rough.module.min.js +1 -1
  435. package/dist/semiotic-access.d.ts +9 -0
  436. package/dist/semiotic-access.min.js +2 -0
  437. package/dist/semiotic-access.module.min.js +2 -0
  438. package/dist/semiotic-ai-artifact-policy-constants.module.min.js +2 -0
  439. package/dist/semiotic-ai-core.d.ts +38 -18
  440. package/dist/semiotic-ai-core.min.js +1 -1
  441. package/dist/semiotic-ai-core.module.min.js +1 -1
  442. package/dist/semiotic-ai-hash-primitives.module.min.js +2 -0
  443. package/dist/semiotic-ai.d.ts +20 -20
  444. package/dist/semiotic-ai.module.min.js +1 -1
  445. package/dist/semiotic-artifact-react.d.ts +10 -0
  446. package/dist/semiotic-artifact-react.min.js +2 -0
  447. package/dist/semiotic-artifact-react.module.min.js +2 -0
  448. package/dist/semiotic-artifact.d.ts +23 -0
  449. package/dist/semiotic-artifact.min.js +1 -0
  450. package/dist/semiotic-artifact.module.min.js +1 -0
  451. package/dist/semiotic-client-cjs-shared.min.js +1 -1
  452. package/dist/semiotic-client-glyph.module.min.js +1 -1
  453. package/dist/semiotic-client-responsive.module.min.js +1 -1
  454. package/dist/semiotic-client-shared.module.min.js +1 -1
  455. package/dist/semiotic-custom-layout-selection-cjs-shared.min.js +1 -1
  456. package/dist/semiotic-data.min.js +1 -1
  457. package/dist/semiotic-data.module.min.js +1 -1
  458. package/dist/semiotic-evidence.d.ts +10 -0
  459. package/dist/semiotic-evidence.min.js +1 -0
  460. package/dist/semiotic-evidence.module.min.js +1 -0
  461. package/dist/semiotic-experimental-auxiliary.module.min.js +1 -1
  462. package/dist/semiotic-experimental-node-auxiliary.module.min.js +1 -1
  463. package/dist/semiotic-experimental-react-shared.module.min.js +1 -1
  464. package/dist/semiotic-experimental-vacp.min.js +1 -1
  465. package/dist/semiotic-experimental-vacp.module.min.js +1 -1
  466. package/dist/semiotic-experimental.d.ts +1 -1
  467. package/dist/semiotic-line.d.ts +9 -0
  468. package/dist/semiotic-line.min.js +2 -0
  469. package/dist/semiotic-line.module.min.js +2 -0
  470. package/dist/semiotic-network.d.ts +3 -0
  471. package/dist/semiotic-ordinal.d.ts +2 -0
  472. package/dist/semiotic-physics.d.ts +4 -4
  473. package/dist/semiotic-realtime-core.d.ts +3 -2
  474. package/dist/semiotic-realtime-core.module.min.js +1 -1
  475. package/dist/semiotic-realtime-react.module.min.js +1 -1
  476. package/dist/semiotic-recipes-core-cjs-base.min.js +1 -1
  477. package/dist/semiotic-recipes-core.d.ts +6 -0
  478. package/dist/semiotic-recipes-core.module.min.js +1 -1
  479. package/dist/semiotic-recipes-geo-cjs.min.js +1 -1
  480. package/dist/semiotic-recipes-react.min.js +1 -1
  481. package/dist/semiotic-server-edge-node.module.min.js +1 -1
  482. package/dist/semiotic-server-edge.min.js +1 -1
  483. package/dist/semiotic-server-edge.module.min.js +1 -1
  484. package/dist/semiotic-server-node.min.js +1 -1
  485. package/dist/semiotic-server-node.module.min.js +1 -1
  486. package/dist/semiotic-text.d.ts +2 -0
  487. package/dist/semiotic-text.min.js +2 -0
  488. package/dist/semiotic-text.module.min.js +2 -0
  489. package/dist/semiotic-themes-core.d.ts +3 -0
  490. package/dist/semiotic-themes-core.min.js +1 -1
  491. package/dist/semiotic-themes-core.module.min.js +1 -1
  492. package/dist/semiotic-themes.min.js +1 -1
  493. package/dist/semiotic-themes.module.min.js +1 -1
  494. package/dist/semiotic-utils-core.d.ts +19 -14
  495. package/dist/semiotic-utils-core.min.js +1 -1
  496. package/dist/semiotic-utils-core.module.min.js +1 -1
  497. package/dist/semiotic-value.module.min.js +1 -1
  498. package/dist/semiotic-xy.d.ts +3 -0
  499. package/dist/semiotic.d.ts +11 -5
  500. package/dist/semiotic.module.min.js +1 -1
  501. package/dist/server.min.js +1 -1
  502. package/dist/server.module.min.js +1 -1
  503. package/dist/xy.module.min.js +1 -1
  504. package/package.json +91 -71
  505. package/spec/README.md +8 -3
  506. package/spec/v0.1/artifact-contract.schema.json +2299 -0
  507. package/spec/v0.1/examples/artifact-contract-full.json +369 -0
  508. package/spec/v0.1/examples/artifact-contract-unknown-state.json +46 -0
  509. package/dist/c-3BLJEQNG.min.js +0 -1
  510. package/dist/c-3KZD6AXJ.min.js +0 -1
  511. package/dist/c-4TWEX5HG.min.js +0 -1
  512. package/dist/c-52TEGIUJ.min.js +0 -1
  513. package/dist/c-5YCIX3VZ.min.js +0 -1
  514. package/dist/c-6FEKTA3U.min.js +0 -1
  515. package/dist/c-6O5EVOPH.min.js +0 -1
  516. package/dist/c-74HEEZGK.min.js +0 -1
  517. package/dist/c-AKAF6JAD.min.js +0 -1
  518. package/dist/c-BBKITSXB.min.js +0 -1
  519. package/dist/c-BWNB6USU.min.js +0 -1
  520. package/dist/c-C25ENHIK.min.js +0 -1
  521. package/dist/c-CDR5AO3R.min.js +0 -1
  522. package/dist/c-COHXCW3Q.min.js +0 -1
  523. package/dist/c-DADXPJXV.min.js +0 -1
  524. package/dist/c-E3JFRRMI.min.js +0 -1
  525. package/dist/c-EBFPQHHO.min.js +0 -1
  526. package/dist/c-G36WS6LN.min.js +0 -1
  527. package/dist/c-GGISSW5E.min.js +0 -1
  528. package/dist/c-GIKRQI4X.min.js +0 -1
  529. package/dist/c-GPYOFETM.min.js +0 -1
  530. package/dist/c-IDUHYYSI.min.js +0 -1
  531. package/dist/c-IUHFPMHD.min.js +0 -1
  532. package/dist/c-J5G56TUH.min.js +0 -1
  533. package/dist/c-JAZ73J32.min.js +0 -1
  534. package/dist/c-KG3NXHAL.min.js +0 -1
  535. package/dist/c-KII3PLZE.min.js +0 -1
  536. package/dist/c-LIXGXMNS.min.js +0 -1
  537. package/dist/c-LVEY6D6B.min.js +0 -1
  538. package/dist/c-M4Y3BHFR.min.js +0 -1
  539. package/dist/c-MAIICR2Z.min.js +0 -1
  540. package/dist/c-MG5DM6VE.min.js +0 -1
  541. package/dist/c-MNF2S4AA.min.js +0 -1
  542. package/dist/c-MT3WBK7M.min.js +0 -1
  543. package/dist/c-NY3JWV2K.min.js +0 -1
  544. package/dist/c-O6U6K4CW.min.js +0 -1
  545. package/dist/c-OQ7M4AGV.min.js +0 -1
  546. package/dist/c-OXYMVK7Q.min.js +0 -1
  547. package/dist/c-PPWDL5ZI.min.js +0 -1
  548. package/dist/c-QHF5YON3.min.js +0 -1
  549. package/dist/c-RR3GO5SW.min.js +0 -1
  550. package/dist/c-RSVIHIQ4.min.js +0 -1
  551. package/dist/c-S2BXNNJN.min.js +0 -1
  552. package/dist/c-S6U5CGT5.min.js +0 -1
  553. package/dist/c-SLGMUBUL.min.js +0 -1
  554. package/dist/c-SUILCHWU.min.js +0 -1
  555. package/dist/c-TZW3JGJ5.min.js +0 -1
  556. package/dist/c-US5ZFT6E.min.js +0 -1
  557. package/dist/c-USFMFKIH.min.js +0 -1
  558. package/dist/c-UUKVD4WB.min.js +0 -1
  559. package/dist/c-VGW3VG3I.min.js +0 -1
  560. package/dist/c-W3CE4A4S.min.js +0 -1
  561. package/dist/c-WJCD5EUY.min.js +0 -1
  562. package/dist/c-X5UBGU2V.min.js +0 -1
  563. package/dist/c-YDAY2WFR.min.js +0 -1
  564. package/dist/c-ZOWWU34K.min.js +0 -1
  565. /package/dist/{c-N4G2L7ID.min.js → c-HYW2XA4Q.min.js} +0 -0
  566. /package/dist/{c-OCI56QF2.min.js → c-V4XMSLC3.min.js} +0 -0
@@ -0,0 +1,2299 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://semiotic.dev/spec/v0.1/artifact-contract.schema.json",
4
+ "title": "Semiotic Artifact Contract",
5
+ "description": "A portable interpretation sidecar that keeps an information artifact's purpose, claims, evidence, time, reception, accountability, and preservation requirements inspectable across interfaces.",
6
+ "type": "object",
7
+ "additionalProperties": false,
8
+ "required": ["contractVersion", "artifact", "purpose", "claims", "evidence"],
9
+ "properties": {
10
+ "contractVersion": {
11
+ "const": "0.1",
12
+ "description": "Wire-contract version for this document.",
13
+ "x-semiotic-supplied-by": ["system", "import"],
14
+ "x-semiotic-derivable": true,
15
+ "x-semiotic-model-may-propose": false,
16
+ "x-semiotic-human-review": "never"
17
+ },
18
+ "artifact": {
19
+ "$ref": "#/$defs/artifactIdentity",
20
+ "description": "Stable identity and content fingerprints for the artifact.",
21
+ "x-semiotic-supplied-by": ["author", "system", "import"],
22
+ "x-semiotic-derivable": true,
23
+ "x-semiotic-model-may-propose": false,
24
+ "x-semiotic-human-review": "never"
25
+ },
26
+ "purpose": {
27
+ "$ref": "#/$defs/purposeContract",
28
+ "description": "Declared purpose, intended decisions, stakes, and use boundaries.",
29
+ "x-semiotic-supplied-by": [
30
+ "author",
31
+ "system",
32
+ "model-proposal",
33
+ "import"
34
+ ],
35
+ "x-semiotic-derivable": true,
36
+ "x-semiotic-model-may-propose": true,
37
+ "x-semiotic-human-review": "policy-dependent"
38
+ },
39
+ "claims": {
40
+ "type": "array",
41
+ "items": { "$ref": "#/$defs/claim" },
42
+ "description": "Claims the artifact communicates or relies on.",
43
+ "x-semiotic-supplied-by": [
44
+ "author",
45
+ "system",
46
+ "model-proposal",
47
+ "import"
48
+ ],
49
+ "x-semiotic-derivable": true,
50
+ "x-semiotic-model-may-propose": true,
51
+ "x-semiotic-human-review": "policy-dependent"
52
+ },
53
+ "evidence": {
54
+ "type": "array",
55
+ "items": { "$ref": "#/$defs/evidenceRef" },
56
+ "description": "Evidence records referenced by claims and transformations.",
57
+ "x-semiotic-supplied-by": ["author", "system", "import"],
58
+ "x-semiotic-derivable": true,
59
+ "x-semiotic-model-may-propose": false,
60
+ "x-semiotic-human-review": "policy-dependent"
61
+ },
62
+ "time": {
63
+ "$ref": "#/$defs/temporalContext",
64
+ "description": "Event, processing, publication, freshness, window, and revision clocks.",
65
+ "x-semiotic-supplied-by": ["author", "system", "import"],
66
+ "x-semiotic-derivable": true,
67
+ "x-semiotic-model-may-propose": false,
68
+ "x-semiotic-human-review": "policy-dependent"
69
+ },
70
+ "reception": {
71
+ "$ref": "#/$defs/receptionContract",
72
+ "description": "Audience and channel requirements for receiving the artifact.",
73
+ "x-semiotic-supplied-by": [
74
+ "author",
75
+ "system",
76
+ "model-proposal",
77
+ "import"
78
+ ],
79
+ "x-semiotic-derivable": true,
80
+ "x-semiotic-model-may-propose": true,
81
+ "x-semiotic-human-review": "policy-dependent"
82
+ },
83
+ "form": {
84
+ "$ref": "#/$defs/designContract",
85
+ "description": "Reasoning, risks, and alternatives associated with the chosen form.",
86
+ "x-semiotic-supplied-by": [
87
+ "author",
88
+ "system",
89
+ "model-proposal",
90
+ "import"
91
+ ],
92
+ "x-semiotic-derivable": true,
93
+ "x-semiotic-model-may-propose": true,
94
+ "x-semiotic-human-review": "policy-dependent"
95
+ },
96
+ "contestability": {
97
+ "$ref": "#/$defs/contestabilityContract",
98
+ "description": "Ways to challenge, correct, or inspect alternative views of the artifact.",
99
+ "x-semiotic-supplied-by": ["author", "system", "import"],
100
+ "x-semiotic-derivable": false,
101
+ "x-semiotic-model-may-propose": false,
102
+ "x-semiotic-human-review": "required"
103
+ },
104
+ "accountability": {
105
+ "$ref": "#/$defs/accountabilityContract",
106
+ "description": "Authorship, review, source, and downstream-action records.",
107
+ "x-semiotic-supplied-by": ["author", "system", "import"],
108
+ "x-semiotic-derivable": false,
109
+ "x-semiotic-model-may-propose": false,
110
+ "x-semiotic-human-review": "policy-dependent"
111
+ },
112
+ "inheritance": {
113
+ "$ref": "#/$defs/inheritanceContract",
114
+ "description": "Requirements that must survive copying, export, or handoff.",
115
+ "x-semiotic-supplied-by": ["author", "system", "import"],
116
+ "x-semiotic-derivable": true,
117
+ "x-semiotic-model-may-propose": false,
118
+ "x-semiotic-human-review": "policy-dependent"
119
+ },
120
+ "fieldStatus": {
121
+ "type": "object",
122
+ "additionalProperties": { "$ref": "#/$defs/artifactFieldState" },
123
+ "description": "Path-keyed knowledge states for obligations that are unknown, manual, or not applicable.",
124
+ "x-semiotic-supplied-by": ["author", "system", "import"],
125
+ "x-semiotic-derivable": true,
126
+ "x-semiotic-model-may-propose": false,
127
+ "x-semiotic-human-review": "policy-dependent"
128
+ },
129
+ "extensions": {
130
+ "$ref": "#/$defs/jsonObject",
131
+ "description": "Explicit namespaced extension data preserved without changing core semantics.",
132
+ "x-semiotic-supplied-by": ["author", "system", "import"],
133
+ "x-semiotic-derivable": false,
134
+ "x-semiotic-model-may-propose": false,
135
+ "x-semiotic-human-review": "policy-dependent"
136
+ }
137
+ },
138
+ "$defs": {
139
+ "jsonValue": {
140
+ "description": "A value representable in JSON.",
141
+ "anyOf": [
142
+ { "type": "string" },
143
+ { "type": "number" },
144
+ { "type": "boolean" },
145
+ { "type": "null" },
146
+ { "type": "array", "items": { "$ref": "#/$defs/jsonValue" } },
147
+ { "$ref": "#/$defs/jsonObject" }
148
+ ]
149
+ },
150
+ "jsonObject": {
151
+ "description": "An explicitly open object whose values are JSON-safe.",
152
+ "type": "object",
153
+ "additionalProperties": { "$ref": "#/$defs/jsonValue" }
154
+ },
155
+ "artifactFieldState": {
156
+ "type": "object",
157
+ "additionalProperties": false,
158
+ "required": ["status"],
159
+ "properties": {
160
+ "status": {
161
+ "enum": ["known", "unknown", "manual", "not-applicable"],
162
+ "description": "Whether this field is known, unresolved, manually judged, or outside the artifact's scope.",
163
+ "x-semiotic-supplied-by": ["author", "system", "import"],
164
+ "x-semiotic-derivable": true,
165
+ "x-semiotic-model-may-propose": false,
166
+ "x-semiotic-human-review": "policy-dependent"
167
+ },
168
+ "reason": {
169
+ "type": "string",
170
+ "description": "Explanation for the field's knowledge state.",
171
+ "x-semiotic-supplied-by": [
172
+ "author",
173
+ "system",
174
+ "model-proposal",
175
+ "import"
176
+ ],
177
+ "x-semiotic-derivable": true,
178
+ "x-semiotic-model-may-propose": true,
179
+ "x-semiotic-human-review": "policy-dependent"
180
+ },
181
+ "suppliedBy": {
182
+ "enum": ["author", "system", "model-proposal", "import"],
183
+ "description": "Actor class responsible for the recorded state.",
184
+ "x-semiotic-supplied-by": ["system", "import"],
185
+ "x-semiotic-derivable": true,
186
+ "x-semiotic-model-may-propose": false,
187
+ "x-semiotic-human-review": "never"
188
+ },
189
+ "derived": {
190
+ "type": "boolean",
191
+ "description": "Whether the state came from deterministic derivation.",
192
+ "x-semiotic-supplied-by": ["system", "import"],
193
+ "x-semiotic-derivable": true,
194
+ "x-semiotic-model-may-propose": false,
195
+ "x-semiotic-human-review": "never"
196
+ },
197
+ "reviewedBy": {
198
+ "type": "string",
199
+ "description": "Identifier for the reviewer who resolved or confirmed the state.",
200
+ "x-semiotic-supplied-by": ["author", "system", "import"],
201
+ "x-semiotic-derivable": false,
202
+ "x-semiotic-model-may-propose": false,
203
+ "x-semiotic-human-review": "required"
204
+ }
205
+ }
206
+ },
207
+ "artifactIdentity": {
208
+ "type": "object",
209
+ "additionalProperties": false,
210
+ "required": ["id", "kind"],
211
+ "properties": {
212
+ "id": {
213
+ "type": "string",
214
+ "minLength": 1,
215
+ "description": "Stable artifact identifier.",
216
+ "x-semiotic-supplied-by": ["author", "system", "import"],
217
+ "x-semiotic-derivable": true,
218
+ "x-semiotic-model-may-propose": false,
219
+ "x-semiotic-human-review": "never"
220
+ },
221
+ "kind": {
222
+ "enum": ["chart", "dashboard", "story", "alert", "agent-answer"],
223
+ "description": "Artifact category.",
224
+ "x-semiotic-supplied-by": ["author", "system", "import"],
225
+ "x-semiotic-derivable": true,
226
+ "x-semiotic-model-may-propose": false,
227
+ "x-semiotic-human-review": "never"
228
+ },
229
+ "component": {
230
+ "type": "string",
231
+ "description": "Rendering component when the artifact is a chart.",
232
+ "x-semiotic-supplied-by": ["author", "system", "import"],
233
+ "x-semiotic-derivable": true,
234
+ "x-semiotic-model-may-propose": true,
235
+ "x-semiotic-human-review": "policy-dependent"
236
+ },
237
+ "title": {
238
+ "type": "string",
239
+ "description": "Human-facing artifact title.",
240
+ "x-semiotic-supplied-by": [
241
+ "author",
242
+ "system",
243
+ "model-proposal",
244
+ "import"
245
+ ],
246
+ "x-semiotic-derivable": true,
247
+ "x-semiotic-model-may-propose": true,
248
+ "x-semiotic-human-review": "policy-dependent"
249
+ },
250
+ "createdAt": {
251
+ "type": "string",
252
+ "description": "Creation timestamp supplied by the producing system or author.",
253
+ "x-semiotic-supplied-by": ["author", "system", "import"],
254
+ "x-semiotic-derivable": false,
255
+ "x-semiotic-model-may-propose": false,
256
+ "x-semiotic-human-review": "never"
257
+ },
258
+ "configFingerprint": {
259
+ "type": "string",
260
+ "description": "Deterministic identity of the serializable configuration.",
261
+ "x-semiotic-supplied-by": ["system"],
262
+ "x-semiotic-derivable": true,
263
+ "x-semiotic-model-may-propose": false,
264
+ "x-semiotic-human-review": "never"
265
+ },
266
+ "dataFingerprint": {
267
+ "type": "string",
268
+ "description": "Deterministic identity of the bound data and declared transformations without embedding the data itself.",
269
+ "x-semiotic-supplied-by": ["system"],
270
+ "x-semiotic-derivable": true,
271
+ "x-semiotic-model-may-propose": false,
272
+ "x-semiotic-human-review": "never"
273
+ },
274
+ "revision": {
275
+ "type": "string",
276
+ "description": "Producer-supplied revision identifier.",
277
+ "x-semiotic-supplied-by": ["author", "system", "import"],
278
+ "x-semiotic-derivable": false,
279
+ "x-semiotic-model-may-propose": false,
280
+ "x-semiotic-human-review": "policy-dependent"
281
+ }
282
+ }
283
+ },
284
+ "purposeIntent": {
285
+ "type": "object",
286
+ "additionalProperties": false,
287
+ "required": ["id"],
288
+ "properties": {
289
+ "id": {
290
+ "type": "string",
291
+ "minLength": 1,
292
+ "description": "Intent identifier from an open vocabulary.",
293
+ "x-semiotic-supplied-by": [
294
+ "author",
295
+ "system",
296
+ "model-proposal",
297
+ "import"
298
+ ],
299
+ "x-semiotic-derivable": true,
300
+ "x-semiotic-model-may-propose": true,
301
+ "x-semiotic-human-review": "policy-dependent"
302
+ },
303
+ "strength": {
304
+ "enum": ["primary", "secondary"],
305
+ "description": "Relative priority of the intent.",
306
+ "x-semiotic-supplied-by": [
307
+ "author",
308
+ "system",
309
+ "model-proposal",
310
+ "import"
311
+ ],
312
+ "x-semiotic-derivable": true,
313
+ "x-semiotic-model-may-propose": true,
314
+ "x-semiotic-human-review": "policy-dependent"
315
+ },
316
+ "source": {
317
+ "enum": ["author", "derived", "model-proposal", "import"],
318
+ "description": "How the intent entered the contract.",
319
+ "x-semiotic-supplied-by": ["system", "import"],
320
+ "x-semiotic-derivable": true,
321
+ "x-semiotic-model-may-propose": false,
322
+ "x-semiotic-human-review": "never"
323
+ },
324
+ "rationale": {
325
+ "type": "string",
326
+ "description": "Reason this intent applies.",
327
+ "x-semiotic-supplied-by": [
328
+ "author",
329
+ "system",
330
+ "model-proposal",
331
+ "import"
332
+ ],
333
+ "x-semiotic-derivable": true,
334
+ "x-semiotic-model-may-propose": true,
335
+ "x-semiotic-human-review": "policy-dependent"
336
+ }
337
+ }
338
+ },
339
+ "purposeContract": {
340
+ "type": "object",
341
+ "additionalProperties": false,
342
+ "required": ["intents"],
343
+ "properties": {
344
+ "intents": {
345
+ "type": "array",
346
+ "items": { "$ref": "#/$defs/purposeIntent" },
347
+ "description": "Ordered analytical or communicative intents.",
348
+ "x-semiotic-supplied-by": [
349
+ "author",
350
+ "system",
351
+ "model-proposal",
352
+ "import"
353
+ ],
354
+ "x-semiotic-derivable": true,
355
+ "x-semiotic-model-may-propose": true,
356
+ "x-semiotic-human-review": "policy-dependent"
357
+ },
358
+ "communicativeAct": {
359
+ "type": "string",
360
+ "description": "What the artifact asks its audience to understand or do.",
361
+ "x-semiotic-supplied-by": [
362
+ "author",
363
+ "system",
364
+ "model-proposal",
365
+ "import"
366
+ ],
367
+ "x-semiotic-derivable": true,
368
+ "x-semiotic-model-may-propose": true,
369
+ "x-semiotic-human-review": "policy-dependent"
370
+ },
371
+ "decisionContext": {
372
+ "type": "string",
373
+ "description": "Decision or workflow in which the artifact will be used.",
374
+ "x-semiotic-supplied-by": ["author", "import"],
375
+ "x-semiotic-derivable": false,
376
+ "x-semiotic-model-may-propose": true,
377
+ "x-semiotic-human-review": "required"
378
+ },
379
+ "stakes": {
380
+ "enum": ["exploratory", "informational", "operational", "high"],
381
+ "description": "Consequence level of acting on the artifact.",
382
+ "x-semiotic-supplied-by": ["author", "import"],
383
+ "x-semiotic-derivable": false,
384
+ "x-semiotic-model-may-propose": true,
385
+ "x-semiotic-human-review": "required"
386
+ },
387
+ "allowedUses": {
388
+ "type": "array",
389
+ "items": { "type": "string" },
390
+ "description": "Uses the author or policy explicitly permits.",
391
+ "x-semiotic-supplied-by": ["author", "system", "import"],
392
+ "x-semiotic-derivable": false,
393
+ "x-semiotic-model-may-propose": false,
394
+ "x-semiotic-human-review": "required"
395
+ },
396
+ "prohibitedUses": {
397
+ "type": "array",
398
+ "items": { "type": "string" },
399
+ "description": "Uses the author or policy explicitly prohibits.",
400
+ "x-semiotic-supplied-by": ["author", "system", "import"],
401
+ "x-semiotic-derivable": false,
402
+ "x-semiotic-model-may-propose": false,
403
+ "x-semiotic-human-review": "required"
404
+ }
405
+ }
406
+ },
407
+ "actorRef": {
408
+ "type": "object",
409
+ "additionalProperties": false,
410
+ "required": ["kind"],
411
+ "properties": {
412
+ "id": {
413
+ "type": "string",
414
+ "description": "Stable actor identifier when available.",
415
+ "x-semiotic-supplied-by": ["author", "system", "import"],
416
+ "x-semiotic-derivable": false,
417
+ "x-semiotic-model-may-propose": false,
418
+ "x-semiotic-human-review": "never"
419
+ },
420
+ "name": {
421
+ "type": "string",
422
+ "description": "Human-readable actor name.",
423
+ "x-semiotic-supplied-by": ["author", "system", "import"],
424
+ "x-semiotic-derivable": false,
425
+ "x-semiotic-model-may-propose": false,
426
+ "x-semiotic-human-review": "policy-dependent"
427
+ },
428
+ "kind": {
429
+ "type": "string",
430
+ "minLength": 1,
431
+ "examples": ["human", "agent", "watcher", "system"],
432
+ "x-semiotic-recognized-values": [
433
+ "human",
434
+ "agent",
435
+ "watcher",
436
+ "system"
437
+ ],
438
+ "description": "Actor category from an open vocabulary.",
439
+ "x-semiotic-supplied-by": ["author", "system", "import"],
440
+ "x-semiotic-derivable": true,
441
+ "x-semiotic-model-may-propose": false,
442
+ "x-semiotic-human-review": "never"
443
+ }
444
+ }
445
+ },
446
+ "claimReview": {
447
+ "type": "object",
448
+ "additionalProperties": false,
449
+ "required": ["status"],
450
+ "properties": {
451
+ "status": {
452
+ "enum": ["proposed", "reviewed", "approved", "rejected"],
453
+ "description": "Editorial review state for a claim.",
454
+ "x-semiotic-supplied-by": ["author", "system", "import"],
455
+ "x-semiotic-derivable": false,
456
+ "x-semiotic-model-may-propose": false,
457
+ "x-semiotic-human-review": "required"
458
+ },
459
+ "reviewer": {
460
+ "$ref": "#/$defs/actorRef",
461
+ "description": "Actor responsible for the review decision.",
462
+ "x-semiotic-supplied-by": ["author", "system", "import"],
463
+ "x-semiotic-derivable": false,
464
+ "x-semiotic-model-may-propose": false,
465
+ "x-semiotic-human-review": "required"
466
+ },
467
+ "reviewedAt": {
468
+ "type": "string",
469
+ "description": "Timestamp recorded by the review system.",
470
+ "x-semiotic-supplied-by": ["system", "import"],
471
+ "x-semiotic-derivable": false,
472
+ "x-semiotic-model-may-propose": false,
473
+ "x-semiotic-human-review": "never"
474
+ },
475
+ "rationale": {
476
+ "type": "string",
477
+ "description": "Reviewer-authored explanation for the decision.",
478
+ "x-semiotic-supplied-by": ["author", "import"],
479
+ "x-semiotic-derivable": false,
480
+ "x-semiotic-model-may-propose": false,
481
+ "x-semiotic-human-review": "required"
482
+ }
483
+ }
484
+ },
485
+ "claimUncertainty": {
486
+ "type": "object",
487
+ "additionalProperties": false,
488
+ "required": ["kind"],
489
+ "properties": {
490
+ "kind": {
491
+ "enum": ["interval", "distribution", "qualitative", "unknown"],
492
+ "description": "Form in which uncertainty is represented.",
493
+ "x-semiotic-supplied-by": ["author", "system", "import"],
494
+ "x-semiotic-derivable": true,
495
+ "x-semiotic-model-may-propose": false,
496
+ "x-semiotic-human-review": "policy-dependent"
497
+ },
498
+ "lower": {
499
+ "type": "number",
500
+ "description": "Lower bound for interval uncertainty.",
501
+ "x-semiotic-supplied-by": ["author", "system", "import"],
502
+ "x-semiotic-derivable": true,
503
+ "x-semiotic-model-may-propose": false,
504
+ "x-semiotic-human-review": "policy-dependent"
505
+ },
506
+ "upper": {
507
+ "type": "number",
508
+ "description": "Upper bound for interval uncertainty.",
509
+ "x-semiotic-supplied-by": ["author", "system", "import"],
510
+ "x-semiotic-derivable": true,
511
+ "x-semiotic-model-may-propose": false,
512
+ "x-semiotic-human-review": "policy-dependent"
513
+ },
514
+ "confidence": {
515
+ "type": "number",
516
+ "description": "Confidence measure using the producer's stated scale.",
517
+ "x-semiotic-supplied-by": ["author", "system", "import"],
518
+ "x-semiotic-derivable": true,
519
+ "x-semiotic-model-may-propose": false,
520
+ "x-semiotic-human-review": "policy-dependent"
521
+ },
522
+ "unit": {
523
+ "type": "string",
524
+ "description": "Unit associated with numeric bounds.",
525
+ "x-semiotic-supplied-by": ["author", "system", "import"],
526
+ "x-semiotic-derivable": true,
527
+ "x-semiotic-model-may-propose": false,
528
+ "x-semiotic-human-review": "policy-dependent"
529
+ },
530
+ "description": {
531
+ "type": "string",
532
+ "description": "Qualitative explanation of uncertainty and limitations.",
533
+ "x-semiotic-supplied-by": [
534
+ "author",
535
+ "system",
536
+ "model-proposal",
537
+ "import"
538
+ ],
539
+ "x-semiotic-derivable": true,
540
+ "x-semiotic-model-may-propose": true,
541
+ "x-semiotic-human-review": "policy-dependent"
542
+ }
543
+ }
544
+ },
545
+ "claim": {
546
+ "type": "object",
547
+ "additionalProperties": false,
548
+ "required": ["id", "kind", "status", "evidenceIds"],
549
+ "properties": {
550
+ "id": {
551
+ "type": "string",
552
+ "minLength": 1,
553
+ "description": "Stable identifier referenced by evidence, corrections, and actions.",
554
+ "x-semiotic-supplied-by": ["author", "system", "import"],
555
+ "x-semiotic-derivable": true,
556
+ "x-semiotic-model-may-propose": false,
557
+ "x-semiotic-human-review": "never"
558
+ },
559
+ "text": {
560
+ "type": "string",
561
+ "description": "Human-readable claim text.",
562
+ "x-semiotic-supplied-by": [
563
+ "author",
564
+ "system",
565
+ "model-proposal",
566
+ "import"
567
+ ],
568
+ "x-semiotic-derivable": true,
569
+ "x-semiotic-model-may-propose": true,
570
+ "x-semiotic-human-review": "policy-dependent"
571
+ },
572
+ "kind": {
573
+ "enum": [
574
+ "description",
575
+ "observation",
576
+ "aggregation",
577
+ "inference",
578
+ "forecast",
579
+ "simulation",
580
+ "alert",
581
+ "recommendation",
582
+ "normative"
583
+ ],
584
+ "description": "Evidence and communication category of the claim.",
585
+ "x-semiotic-supplied-by": ["author", "system", "import"],
586
+ "x-semiotic-derivable": true,
587
+ "x-semiotic-model-may-propose": true,
588
+ "x-semiotic-human-review": "policy-dependent"
589
+ },
590
+ "status": {
591
+ "enum": [
592
+ "supported",
593
+ "provisional",
594
+ "disputed",
595
+ "superseded",
596
+ "retracted",
597
+ "unsupported",
598
+ "unknown"
599
+ ],
600
+ "description": "Current support and publication state of the claim.",
601
+ "x-semiotic-supplied-by": ["author", "system", "import"],
602
+ "x-semiotic-derivable": true,
603
+ "x-semiotic-model-may-propose": false,
604
+ "x-semiotic-human-review": "policy-dependent"
605
+ },
606
+ "evidenceIds": {
607
+ "type": "array",
608
+ "items": { "type": "string", "minLength": 1 },
609
+ "description": "Identifiers of evidence records supporting or qualifying the claim.",
610
+ "x-semiotic-supplied-by": ["author", "system", "import"],
611
+ "x-semiotic-derivable": true,
612
+ "x-semiotic-model-may-propose": false,
613
+ "x-semiotic-human-review": "policy-dependent"
614
+ },
615
+ "scope": {
616
+ "$ref": "#/$defs/jsonObject",
617
+ "description": "Structured bounds on population, filters, geography, or other applicability.",
618
+ "x-semiotic-supplied-by": ["author", "system", "import"],
619
+ "x-semiotic-derivable": true,
620
+ "x-semiotic-model-may-propose": true,
621
+ "x-semiotic-human-review": "policy-dependent"
622
+ },
623
+ "uncertainty": {
624
+ "$ref": "#/$defs/claimUncertainty",
625
+ "description": "Uncertainty associated with the claim.",
626
+ "x-semiotic-supplied-by": ["author", "system", "import"],
627
+ "x-semiotic-derivable": true,
628
+ "x-semiotic-model-may-propose": false,
629
+ "x-semiotic-human-review": "policy-dependent"
630
+ },
631
+ "asOf": {
632
+ "type": "string",
633
+ "description": "Time at which the claim should be interpreted.",
634
+ "x-semiotic-supplied-by": ["author", "system", "import"],
635
+ "x-semiotic-derivable": true,
636
+ "x-semiotic-model-may-propose": false,
637
+ "x-semiotic-human-review": "policy-dependent"
638
+ },
639
+ "supersedes": {
640
+ "type": "array",
641
+ "items": { "type": "string", "minLength": 1 },
642
+ "description": "Earlier claim identifiers replaced by this claim.",
643
+ "x-semiotic-supplied-by": ["author", "system", "import"],
644
+ "x-semiotic-derivable": false,
645
+ "x-semiotic-model-may-propose": false,
646
+ "x-semiotic-human-review": "required"
647
+ },
648
+ "authoredBy": {
649
+ "$ref": "#/$defs/actorRef",
650
+ "description": "Actor responsible for authoring the claim.",
651
+ "x-semiotic-supplied-by": ["author", "system", "import"],
652
+ "x-semiotic-derivable": false,
653
+ "x-semiotic-model-may-propose": false,
654
+ "x-semiotic-human-review": "policy-dependent"
655
+ },
656
+ "review": {
657
+ "$ref": "#/$defs/claimReview",
658
+ "description": "Editorial review record for the claim.",
659
+ "x-semiotic-supplied-by": ["author", "system", "import"],
660
+ "x-semiotic-derivable": false,
661
+ "x-semiotic-model-may-propose": false,
662
+ "x-semiotic-human-review": "required"
663
+ },
664
+ "tags": {
665
+ "type": "array",
666
+ "items": { "type": "string" },
667
+ "description": "Open labels used for discovery or policy selection.",
668
+ "x-semiotic-supplied-by": [
669
+ "author",
670
+ "system",
671
+ "model-proposal",
672
+ "import"
673
+ ],
674
+ "x-semiotic-derivable": true,
675
+ "x-semiotic-model-may-propose": true,
676
+ "x-semiotic-human-review": "policy-dependent"
677
+ }
678
+ }
679
+ },
680
+ "evidenceSource": {
681
+ "type": "object",
682
+ "additionalProperties": false,
683
+ "properties": {
684
+ "name": {
685
+ "type": "string",
686
+ "description": "Human-readable source name.",
687
+ "x-semiotic-supplied-by": ["author", "system", "import"],
688
+ "x-semiotic-derivable": false,
689
+ "x-semiotic-model-may-propose": false,
690
+ "x-semiotic-human-review": "policy-dependent"
691
+ },
692
+ "uri": {
693
+ "type": "string",
694
+ "description": "Resolvable or descriptive source location.",
695
+ "x-semiotic-supplied-by": ["author", "system", "import"],
696
+ "x-semiotic-derivable": false,
697
+ "x-semiotic-model-may-propose": false,
698
+ "x-semiotic-human-review": "policy-dependent"
699
+ },
700
+ "version": {
701
+ "type": "string",
702
+ "description": "Source version identifier.",
703
+ "x-semiotic-supplied-by": ["system", "import"],
704
+ "x-semiotic-derivable": false,
705
+ "x-semiotic-model-may-propose": false,
706
+ "x-semiotic-human-review": "never"
707
+ },
708
+ "retrievedAt": {
709
+ "type": "string",
710
+ "description": "Timestamp at which the source was retrieved.",
711
+ "x-semiotic-supplied-by": ["system", "import"],
712
+ "x-semiotic-derivable": false,
713
+ "x-semiotic-model-may-propose": false,
714
+ "x-semiotic-human-review": "never"
715
+ },
716
+ "publisher": {
717
+ "type": "string",
718
+ "description": "Organization or actor publishing the source.",
719
+ "x-semiotic-supplied-by": ["author", "system", "import"],
720
+ "x-semiotic-derivable": true,
721
+ "x-semiotic-model-may-propose": false,
722
+ "x-semiotic-human-review": "policy-dependent"
723
+ }
724
+ }
725
+ },
726
+ "transformationRecord": {
727
+ "type": "object",
728
+ "additionalProperties": false,
729
+ "required": ["id", "kind", "inputEvidenceIds"],
730
+ "properties": {
731
+ "id": {
732
+ "type": "string",
733
+ "minLength": 1,
734
+ "description": "Stable transformation identifier.",
735
+ "x-semiotic-supplied-by": ["author", "system", "import"],
736
+ "x-semiotic-derivable": true,
737
+ "x-semiotic-model-may-propose": false,
738
+ "x-semiotic-human-review": "never"
739
+ },
740
+ "kind": {
741
+ "enum": [
742
+ "aggregation",
743
+ "filter",
744
+ "normalization",
745
+ "binning",
746
+ "join",
747
+ "smoothing",
748
+ "forecasting",
749
+ "simulation",
750
+ "other"
751
+ ],
752
+ "description": "Class of transformation applied to evidence.",
753
+ "x-semiotic-supplied-by": ["author", "system", "import"],
754
+ "x-semiotic-derivable": true,
755
+ "x-semiotic-model-may-propose": false,
756
+ "x-semiotic-human-review": "policy-dependent"
757
+ },
758
+ "description": {
759
+ "type": "string",
760
+ "description": "Human-readable explanation of the transformation.",
761
+ "x-semiotic-supplied-by": [
762
+ "author",
763
+ "system",
764
+ "model-proposal",
765
+ "import"
766
+ ],
767
+ "x-semiotic-derivable": true,
768
+ "x-semiotic-model-may-propose": true,
769
+ "x-semiotic-human-review": "policy-dependent"
770
+ },
771
+ "inputEvidenceIds": {
772
+ "type": "array",
773
+ "items": { "type": "string", "minLength": 1 },
774
+ "description": "Evidence identifiers consumed by the transformation.",
775
+ "x-semiotic-supplied-by": ["author", "system", "import"],
776
+ "x-semiotic-derivable": true,
777
+ "x-semiotic-model-may-propose": false,
778
+ "x-semiotic-human-review": "policy-dependent"
779
+ },
780
+ "parameters": {
781
+ "$ref": "#/$defs/jsonObject",
782
+ "description": "JSON-safe transformation parameters.",
783
+ "x-semiotic-supplied-by": ["author", "system", "import"],
784
+ "x-semiotic-derivable": true,
785
+ "x-semiotic-model-may-propose": false,
786
+ "x-semiotic-human-review": "policy-dependent"
787
+ },
788
+ "assumptions": {
789
+ "type": "array",
790
+ "items": { "type": "string" },
791
+ "description": "Assumptions required by the transformation.",
792
+ "x-semiotic-supplied-by": [
793
+ "author",
794
+ "system",
795
+ "model-proposal",
796
+ "import"
797
+ ],
798
+ "x-semiotic-derivable": true,
799
+ "x-semiotic-model-may-propose": true,
800
+ "x-semiotic-human-review": "policy-dependent"
801
+ },
802
+ "implementation": {
803
+ "type": "string",
804
+ "description": "Code, query, or procedure implementing the transformation.",
805
+ "x-semiotic-supplied-by": ["author", "system", "import"],
806
+ "x-semiotic-derivable": true,
807
+ "x-semiotic-model-may-propose": false,
808
+ "x-semiotic-human-review": "policy-dependent"
809
+ },
810
+ "performedAt": {
811
+ "type": "string",
812
+ "description": "Timestamp at which the transformation was performed.",
813
+ "x-semiotic-supplied-by": ["system", "import"],
814
+ "x-semiotic-derivable": false,
815
+ "x-semiotic-model-may-propose": false,
816
+ "x-semiotic-human-review": "never"
817
+ },
818
+ "performedBy": {
819
+ "$ref": "#/$defs/actorRef",
820
+ "description": "Actor or system that performed the transformation.",
821
+ "x-semiotic-supplied-by": ["author", "system", "import"],
822
+ "x-semiotic-derivable": true,
823
+ "x-semiotic-model-may-propose": false,
824
+ "x-semiotic-human-review": "policy-dependent"
825
+ }
826
+ }
827
+ },
828
+ "boundedEvidenceSample": {
829
+ "type": "object",
830
+ "additionalProperties": false,
831
+ "properties": {
832
+ "rowCount": {
833
+ "type": "number",
834
+ "description": "Total or represented row count.",
835
+ "x-semiotic-supplied-by": ["system", "import"],
836
+ "x-semiotic-derivable": true,
837
+ "x-semiotic-model-may-propose": false,
838
+ "x-semiotic-human-review": "never"
839
+ },
840
+ "fields": {
841
+ "type": "array",
842
+ "items": { "type": "string" },
843
+ "description": "Fields included in the bounded sample.",
844
+ "x-semiotic-supplied-by": ["system", "import"],
845
+ "x-semiotic-derivable": true,
846
+ "x-semiotic-model-may-propose": false,
847
+ "x-semiotic-human-review": "never"
848
+ },
849
+ "values": {
850
+ "type": "array",
851
+ "items": { "$ref": "#/$defs/jsonValue" },
852
+ "description": "Bounded JSON-safe sample values.",
853
+ "x-semiotic-supplied-by": ["system", "import"],
854
+ "x-semiotic-derivable": true,
855
+ "x-semiotic-model-may-propose": false,
856
+ "x-semiotic-human-review": "policy-dependent"
857
+ },
858
+ "truncated": {
859
+ "type": "boolean",
860
+ "description": "Whether values omit part of the available sample.",
861
+ "x-semiotic-supplied-by": ["system", "import"],
862
+ "x-semiotic-derivable": true,
863
+ "x-semiotic-model-may-propose": false,
864
+ "x-semiotic-human-review": "never"
865
+ }
866
+ }
867
+ },
868
+ "evidenceRef": {
869
+ "type": "object",
870
+ "additionalProperties": false,
871
+ "required": ["id", "role"],
872
+ "properties": {
873
+ "id": {
874
+ "type": "string",
875
+ "minLength": 1,
876
+ "description": "Stable evidence identifier referenced by claims and transformations.",
877
+ "x-semiotic-supplied-by": ["author", "system", "import"],
878
+ "x-semiotic-derivable": true,
879
+ "x-semiotic-model-may-propose": false,
880
+ "x-semiotic-human-review": "never"
881
+ },
882
+ "role": {
883
+ "enum": [
884
+ "source-data",
885
+ "external-source",
886
+ "transformation",
887
+ "statistical-test",
888
+ "model-output",
889
+ "human-observation",
890
+ "policy-rule",
891
+ "quality-check"
892
+ ],
893
+ "description": "Role the evidence plays in supporting or qualifying claims.",
894
+ "x-semiotic-supplied-by": ["author", "system", "import"],
895
+ "x-semiotic-derivable": true,
896
+ "x-semiotic-model-may-propose": false,
897
+ "x-semiotic-human-review": "policy-dependent"
898
+ },
899
+ "label": {
900
+ "type": "string",
901
+ "description": "Human-readable evidence label.",
902
+ "x-semiotic-supplied-by": [
903
+ "author",
904
+ "system",
905
+ "model-proposal",
906
+ "import"
907
+ ],
908
+ "x-semiotic-derivable": true,
909
+ "x-semiotic-model-may-propose": true,
910
+ "x-semiotic-human-review": "policy-dependent"
911
+ },
912
+ "source": {
913
+ "$ref": "#/$defs/evidenceSource",
914
+ "description": "Origin and retrieval metadata for the evidence.",
915
+ "x-semiotic-supplied-by": ["author", "system", "import"],
916
+ "x-semiotic-derivable": true,
917
+ "x-semiotic-model-may-propose": false,
918
+ "x-semiotic-human-review": "policy-dependent"
919
+ },
920
+ "fingerprint": {
921
+ "type": "string",
922
+ "description": "Deterministic content identity for the evidence.",
923
+ "x-semiotic-supplied-by": ["system"],
924
+ "x-semiotic-derivable": true,
925
+ "x-semiotic-model-may-propose": false,
926
+ "x-semiotic-human-review": "never"
927
+ },
928
+ "dataVersion": {
929
+ "type": "string",
930
+ "description": "Source data version identifier.",
931
+ "x-semiotic-supplied-by": ["system", "import"],
932
+ "x-semiotic-derivable": false,
933
+ "x-semiotic-model-may-propose": false,
934
+ "x-semiotic-human-review": "never"
935
+ },
936
+ "observedAt": {
937
+ "type": "string",
938
+ "description": "Timestamp represented by the evidence observation.",
939
+ "x-semiotic-supplied-by": ["author", "system", "import"],
940
+ "x-semiotic-derivable": true,
941
+ "x-semiotic-model-may-propose": false,
942
+ "x-semiotic-human-review": "policy-dependent"
943
+ },
944
+ "scope": {
945
+ "$ref": "#/$defs/jsonObject",
946
+ "description": "Structured bounds on the evidence's applicability.",
947
+ "x-semiotic-supplied-by": ["author", "system", "import"],
948
+ "x-semiotic-derivable": true,
949
+ "x-semiotic-model-may-propose": true,
950
+ "x-semiotic-human-review": "policy-dependent"
951
+ },
952
+ "sample": {
953
+ "$ref": "#/$defs/boundedEvidenceSample",
954
+ "description": "Bounded sample retained for inspection without requiring full raw data.",
955
+ "x-semiotic-supplied-by": ["system", "import"],
956
+ "x-semiotic-derivable": true,
957
+ "x-semiotic-model-may-propose": false,
958
+ "x-semiotic-human-review": "policy-dependent"
959
+ },
960
+ "transformation": {
961
+ "$ref": "#/$defs/transformationRecord",
962
+ "description": "Transformation record when this evidence was produced from other evidence.",
963
+ "x-semiotic-supplied-by": ["author", "system", "import"],
964
+ "x-semiotic-derivable": true,
965
+ "x-semiotic-model-may-propose": false,
966
+ "x-semiotic-human-review": "policy-dependent"
967
+ },
968
+ "generatedClaimId": {
969
+ "type": "string",
970
+ "description": "Claim identifier generated from this evidence, when applicable.",
971
+ "x-semiotic-supplied-by": ["author", "system", "import"],
972
+ "x-semiotic-derivable": true,
973
+ "x-semiotic-model-may-propose": false,
974
+ "x-semiotic-human-review": "policy-dependent"
975
+ },
976
+ "relationship": {
977
+ "enum": ["descriptive", "correlational", "causal", "unknown"],
978
+ "description": "Strength and interpretation of the evidence-to-claim relationship.",
979
+ "x-semiotic-supplied-by": ["author", "system", "import"],
980
+ "x-semiotic-derivable": true,
981
+ "x-semiotic-model-may-propose": true,
982
+ "x-semiotic-human-review": "required"
983
+ }
984
+ }
985
+ },
986
+ "timeField": {
987
+ "type": "object",
988
+ "additionalProperties": false,
989
+ "properties": {
990
+ "field": {
991
+ "type": "string",
992
+ "description": "Name of the field carrying event time.",
993
+ "x-semiotic-supplied-by": ["author", "system", "import"],
994
+ "x-semiotic-derivable": true,
995
+ "x-semiotic-model-may-propose": false,
996
+ "x-semiotic-human-review": "policy-dependent"
997
+ },
998
+ "value": {
999
+ "type": "string",
1000
+ "description": "Event-time value represented by the artifact.",
1001
+ "x-semiotic-supplied-by": ["author", "system", "import"],
1002
+ "x-semiotic-derivable": true,
1003
+ "x-semiotic-model-may-propose": false,
1004
+ "x-semiotic-human-review": "policy-dependent"
1005
+ },
1006
+ "timezone": {
1007
+ "type": "string",
1008
+ "description": "Timezone used to interpret the event-time value.",
1009
+ "x-semiotic-supplied-by": ["author", "system", "import"],
1010
+ "x-semiotic-derivable": true,
1011
+ "x-semiotic-model-may-propose": false,
1012
+ "x-semiotic-human-review": "policy-dependent"
1013
+ },
1014
+ "granularity": {
1015
+ "type": "string",
1016
+ "description": "Resolution at which event time is meaningful.",
1017
+ "x-semiotic-supplied-by": ["author", "system", "import"],
1018
+ "x-semiotic-derivable": true,
1019
+ "x-semiotic-model-may-propose": false,
1020
+ "x-semiotic-human-review": "policy-dependent"
1021
+ }
1022
+ }
1023
+ },
1024
+ "temporalSourceState": {
1025
+ "type": "object",
1026
+ "additionalProperties": false,
1027
+ "required": ["id", "kind"],
1028
+ "properties": {
1029
+ "id": {
1030
+ "type": "string",
1031
+ "minLength": 1,
1032
+ "description": "Stable identifier for a temporal source or processing stage.",
1033
+ "x-semiotic-supplied-by": ["author", "system", "import"],
1034
+ "x-semiotic-derivable": true,
1035
+ "x-semiotic-model-may-propose": false,
1036
+ "x-semiotic-human-review": "never"
1037
+ },
1038
+ "kind": {
1039
+ "enum": [
1040
+ "stream",
1041
+ "processing-job",
1042
+ "quality-check",
1043
+ "snapshot",
1044
+ "publication"
1045
+ ],
1046
+ "description": "Kind of source or processing stage.",
1047
+ "x-semiotic-supplied-by": ["author", "system", "import"],
1048
+ "x-semiotic-derivable": true,
1049
+ "x-semiotic-model-may-propose": false,
1050
+ "x-semiotic-human-review": "never"
1051
+ },
1052
+ "label": {
1053
+ "type": "string",
1054
+ "description": "Human-readable source label.",
1055
+ "x-semiotic-supplied-by": [
1056
+ "author",
1057
+ "system",
1058
+ "model-proposal",
1059
+ "import"
1060
+ ],
1061
+ "x-semiotic-derivable": true,
1062
+ "x-semiotic-model-may-propose": true,
1063
+ "x-semiotic-human-review": "policy-dependent"
1064
+ },
1065
+ "observedAt": {
1066
+ "type": "string",
1067
+ "description": "Most recent observation timestamp for this source.",
1068
+ "x-semiotic-supplied-by": ["system", "import"],
1069
+ "x-semiotic-derivable": false,
1070
+ "x-semiotic-model-may-propose": false,
1071
+ "x-semiotic-human-review": "never"
1072
+ },
1073
+ "version": {
1074
+ "type": "string",
1075
+ "description": "Version reported by this source or processing stage.",
1076
+ "x-semiotic-supplied-by": ["system", "import"],
1077
+ "x-semiotic-derivable": false,
1078
+ "x-semiotic-model-may-propose": false,
1079
+ "x-semiotic-human-review": "never"
1080
+ },
1081
+ "timezone": {
1082
+ "type": "string",
1083
+ "description": "Timezone used by this source.",
1084
+ "x-semiotic-supplied-by": ["author", "system", "import"],
1085
+ "x-semiotic-derivable": true,
1086
+ "x-semiotic-model-may-propose": false,
1087
+ "x-semiotic-human-review": "policy-dependent"
1088
+ },
1089
+ "granularity": {
1090
+ "type": "string",
1091
+ "description": "Temporal resolution supplied by this source.",
1092
+ "x-semiotic-supplied-by": ["author", "system", "import"],
1093
+ "x-semiotic-derivable": true,
1094
+ "x-semiotic-model-may-propose": false,
1095
+ "x-semiotic-human-review": "policy-dependent"
1096
+ },
1097
+ "freshness": {
1098
+ "enum": ["fresh", "stale", "unknown"],
1099
+ "description": "Freshness state reported for this source.",
1100
+ "x-semiotic-supplied-by": ["system", "import"],
1101
+ "x-semiotic-derivable": true,
1102
+ "x-semiotic-model-may-propose": false,
1103
+ "x-semiotic-human-review": "policy-dependent"
1104
+ },
1105
+ "completeness": {
1106
+ "enum": ["partial", "provisional", "settled", "unknown"],
1107
+ "description": "Completeness state reported for this source.",
1108
+ "x-semiotic-supplied-by": ["system", "import"],
1109
+ "x-semiotic-derivable": true,
1110
+ "x-semiotic-model-may-propose": false,
1111
+ "x-semiotic-human-review": "policy-dependent"
1112
+ }
1113
+ }
1114
+ },
1115
+ "temporalPresentation": {
1116
+ "type": "object",
1117
+ "additionalProperties": false,
1118
+ "properties": {
1119
+ "state": {
1120
+ "enum": ["live", "historical", "mixed"],
1121
+ "description": "How the interface presents the artifact's temporal state.",
1122
+ "x-semiotic-supplied-by": ["author", "system", "import"],
1123
+ "x-semiotic-derivable": true,
1124
+ "x-semiotic-model-may-propose": false,
1125
+ "x-semiotic-human-review": "policy-dependent"
1126
+ },
1127
+ "label": {
1128
+ "type": "string",
1129
+ "description": "Audience-facing temporal-state label.",
1130
+ "x-semiotic-supplied-by": [
1131
+ "author",
1132
+ "system",
1133
+ "model-proposal",
1134
+ "import"
1135
+ ],
1136
+ "x-semiotic-derivable": true,
1137
+ "x-semiotic-model-may-propose": true,
1138
+ "x-semiotic-human-review": "policy-dependent"
1139
+ }
1140
+ }
1141
+ },
1142
+ "temporalFreshness": {
1143
+ "type": "object",
1144
+ "additionalProperties": false,
1145
+ "required": ["status"],
1146
+ "properties": {
1147
+ "status": {
1148
+ "enum": ["fresh", "stale", "unknown"],
1149
+ "description": "Computed or declared freshness state.",
1150
+ "x-semiotic-supplied-by": ["author", "system", "import"],
1151
+ "x-semiotic-derivable": true,
1152
+ "x-semiotic-model-may-propose": false,
1153
+ "x-semiotic-human-review": "policy-dependent"
1154
+ },
1155
+ "checkedAt": {
1156
+ "type": "string",
1157
+ "description": "Timestamp of the freshness evaluation.",
1158
+ "x-semiotic-supplied-by": ["system", "import"],
1159
+ "x-semiotic-derivable": false,
1160
+ "x-semiotic-model-may-propose": false,
1161
+ "x-semiotic-human-review": "never"
1162
+ },
1163
+ "heartbeatAt": {
1164
+ "type": "string",
1165
+ "description": "Timestamp of the most recent source heartbeat.",
1166
+ "x-semiotic-supplied-by": ["system", "import"],
1167
+ "x-semiotic-derivable": false,
1168
+ "x-semiotic-model-may-propose": false,
1169
+ "x-semiotic-human-review": "never"
1170
+ },
1171
+ "expiresAt": {
1172
+ "type": "string",
1173
+ "description": "Timestamp after which the artifact should be considered stale.",
1174
+ "x-semiotic-supplied-by": ["author", "system", "import"],
1175
+ "x-semiotic-derivable": true,
1176
+ "x-semiotic-model-may-propose": false,
1177
+ "x-semiotic-human-review": "policy-dependent"
1178
+ },
1179
+ "basis": {
1180
+ "type": "string",
1181
+ "description": "Rule or observation used to determine freshness.",
1182
+ "x-semiotic-supplied-by": [
1183
+ "author",
1184
+ "system",
1185
+ "model-proposal",
1186
+ "import"
1187
+ ],
1188
+ "x-semiotic-derivable": true,
1189
+ "x-semiotic-model-may-propose": true,
1190
+ "x-semiotic-human-review": "policy-dependent"
1191
+ }
1192
+ }
1193
+ },
1194
+ "temporalWatermark": {
1195
+ "type": "object",
1196
+ "additionalProperties": false,
1197
+ "required": ["value"],
1198
+ "properties": {
1199
+ "value": {
1200
+ "type": "string",
1201
+ "description": "Latest event time known to be included under the stated policy.",
1202
+ "x-semiotic-supplied-by": ["system", "import"],
1203
+ "x-semiotic-derivable": true,
1204
+ "x-semiotic-model-may-propose": false,
1205
+ "x-semiotic-human-review": "never"
1206
+ },
1207
+ "policy": {
1208
+ "type": "string",
1209
+ "description": "Watermark computation policy.",
1210
+ "x-semiotic-supplied-by": ["author", "system", "import"],
1211
+ "x-semiotic-derivable": true,
1212
+ "x-semiotic-model-may-propose": false,
1213
+ "x-semiotic-human-review": "policy-dependent"
1214
+ },
1215
+ "allowedLateness": {
1216
+ "type": "string",
1217
+ "description": "Accepted lateness interval beyond the watermark.",
1218
+ "x-semiotic-supplied-by": ["author", "system", "import"],
1219
+ "x-semiotic-derivable": true,
1220
+ "x-semiotic-model-may-propose": false,
1221
+ "x-semiotic-human-review": "policy-dependent"
1222
+ }
1223
+ }
1224
+ },
1225
+ "temporalWindow": {
1226
+ "type": "object",
1227
+ "additionalProperties": false,
1228
+ "required": ["start", "end", "status"],
1229
+ "properties": {
1230
+ "start": {
1231
+ "type": "string",
1232
+ "description": "Inclusive start of the represented temporal window.",
1233
+ "x-semiotic-supplied-by": ["author", "system", "import"],
1234
+ "x-semiotic-derivable": true,
1235
+ "x-semiotic-model-may-propose": false,
1236
+ "x-semiotic-human-review": "policy-dependent"
1237
+ },
1238
+ "end": {
1239
+ "type": "string",
1240
+ "description": "End of the represented temporal window.",
1241
+ "x-semiotic-supplied-by": ["author", "system", "import"],
1242
+ "x-semiotic-derivable": true,
1243
+ "x-semiotic-model-may-propose": false,
1244
+ "x-semiotic-human-review": "policy-dependent"
1245
+ },
1246
+ "status": {
1247
+ "enum": ["open", "provisional", "settled", "reopened", "corrected"],
1248
+ "description": "Settlement or revision state of the represented window.",
1249
+ "x-semiotic-supplied-by": ["author", "system", "import"],
1250
+ "x-semiotic-derivable": true,
1251
+ "x-semiotic-model-may-propose": false,
1252
+ "x-semiotic-human-review": "policy-dependent"
1253
+ }
1254
+ }
1255
+ },
1256
+ "temporalCompleteness": {
1257
+ "type": "object",
1258
+ "additionalProperties": false,
1259
+ "required": ["status"],
1260
+ "properties": {
1261
+ "status": {
1262
+ "enum": ["partial", "provisional", "settled", "unknown"],
1263
+ "description": "Completeness state of the represented data.",
1264
+ "x-semiotic-supplied-by": ["author", "system", "import"],
1265
+ "x-semiotic-derivable": true,
1266
+ "x-semiotic-model-may-propose": false,
1267
+ "x-semiotic-human-review": "policy-dependent"
1268
+ },
1269
+ "basis": {
1270
+ "type": "string",
1271
+ "description": "Rule or observation used to determine completeness.",
1272
+ "x-semiotic-supplied-by": [
1273
+ "author",
1274
+ "system",
1275
+ "model-proposal",
1276
+ "import"
1277
+ ],
1278
+ "x-semiotic-derivable": true,
1279
+ "x-semiotic-model-may-propose": true,
1280
+ "x-semiotic-human-review": "policy-dependent"
1281
+ }
1282
+ }
1283
+ },
1284
+ "temporalRevision": {
1285
+ "type": "object",
1286
+ "additionalProperties": false,
1287
+ "required": ["status"],
1288
+ "properties": {
1289
+ "status": {
1290
+ "enum": ["original", "backfilled", "corrected", "superseded"],
1291
+ "description": "Revision relationship to previously published data or artifacts.",
1292
+ "x-semiotic-supplied-by": ["author", "system", "import"],
1293
+ "x-semiotic-derivable": true,
1294
+ "x-semiotic-model-may-propose": false,
1295
+ "x-semiotic-human-review": "policy-dependent"
1296
+ },
1297
+ "previousArtifactId": {
1298
+ "type": "string",
1299
+ "description": "Identifier of the earlier artifact affected by this revision.",
1300
+ "x-semiotic-supplied-by": ["author", "system", "import"],
1301
+ "x-semiotic-derivable": true,
1302
+ "x-semiotic-model-may-propose": false,
1303
+ "x-semiotic-human-review": "policy-dependent"
1304
+ },
1305
+ "correctionId": {
1306
+ "type": "string",
1307
+ "description": "Identifier of the correction record governing this revision.",
1308
+ "x-semiotic-supplied-by": ["author", "system", "import"],
1309
+ "x-semiotic-derivable": true,
1310
+ "x-semiotic-model-may-propose": false,
1311
+ "x-semiotic-human-review": "policy-dependent"
1312
+ },
1313
+ "reason": {
1314
+ "type": "string",
1315
+ "description": "Explanation for the revision.",
1316
+ "x-semiotic-supplied-by": [
1317
+ "author",
1318
+ "system",
1319
+ "model-proposal",
1320
+ "import"
1321
+ ],
1322
+ "x-semiotic-derivable": true,
1323
+ "x-semiotic-model-may-propose": true,
1324
+ "x-semiotic-human-review": "required"
1325
+ }
1326
+ }
1327
+ },
1328
+ "temporalSnapshot": {
1329
+ "type": "object",
1330
+ "additionalProperties": false,
1331
+ "properties": {
1332
+ "id": {
1333
+ "type": "string",
1334
+ "description": "Snapshot identifier.",
1335
+ "x-semiotic-supplied-by": ["system", "import"],
1336
+ "x-semiotic-derivable": true,
1337
+ "x-semiotic-model-may-propose": false,
1338
+ "x-semiotic-human-review": "never"
1339
+ },
1340
+ "format": {
1341
+ "enum": ["iceberg", "delta", "other"],
1342
+ "description": "Snapshot storage format.",
1343
+ "x-semiotic-supplied-by": ["system", "import"],
1344
+ "x-semiotic-derivable": true,
1345
+ "x-semiotic-model-may-propose": false,
1346
+ "x-semiotic-human-review": "never"
1347
+ },
1348
+ "schemaVersion": {
1349
+ "type": "string",
1350
+ "description": "Schema version associated with the snapshot.",
1351
+ "x-semiotic-supplied-by": ["system", "import"],
1352
+ "x-semiotic-derivable": true,
1353
+ "x-semiotic-model-may-propose": false,
1354
+ "x-semiotic-human-review": "never"
1355
+ },
1356
+ "catalogRef": {
1357
+ "type": "string",
1358
+ "description": "Catalog reference used to locate the snapshot.",
1359
+ "x-semiotic-supplied-by": ["system", "import"],
1360
+ "x-semiotic-derivable": true,
1361
+ "x-semiotic-model-may-propose": false,
1362
+ "x-semiotic-human-review": "never"
1363
+ }
1364
+ }
1365
+ },
1366
+ "temporalContext": {
1367
+ "type": "object",
1368
+ "additionalProperties": false,
1369
+ "properties": {
1370
+ "eventTime": {
1371
+ "$ref": "#/$defs/timeField",
1372
+ "description": "Field and value used as event time.",
1373
+ "x-semiotic-supplied-by": ["author", "system", "import"],
1374
+ "x-semiotic-derivable": true,
1375
+ "x-semiotic-model-may-propose": false,
1376
+ "x-semiotic-human-review": "policy-dependent"
1377
+ },
1378
+ "observedAt": {
1379
+ "type": "string",
1380
+ "description": "Timestamp at which the represented event or condition was observed.",
1381
+ "x-semiotic-supplied-by": ["author", "system", "import"],
1382
+ "x-semiotic-derivable": true,
1383
+ "x-semiotic-model-may-propose": false,
1384
+ "x-semiotic-human-review": "policy-dependent"
1385
+ },
1386
+ "ingestedAt": {
1387
+ "type": "string",
1388
+ "description": "Timestamp at which data entered the processing system.",
1389
+ "x-semiotic-supplied-by": ["system", "import"],
1390
+ "x-semiotic-derivable": false,
1391
+ "x-semiotic-model-may-propose": false,
1392
+ "x-semiotic-human-review": "never"
1393
+ },
1394
+ "processedAt": {
1395
+ "type": "string",
1396
+ "description": "Timestamp at which processing completed.",
1397
+ "x-semiotic-supplied-by": ["system", "import"],
1398
+ "x-semiotic-derivable": false,
1399
+ "x-semiotic-model-may-propose": false,
1400
+ "x-semiotic-human-review": "never"
1401
+ },
1402
+ "publishedAt": {
1403
+ "type": "string",
1404
+ "description": "Timestamp at which the artifact was published.",
1405
+ "x-semiotic-supplied-by": ["system", "import"],
1406
+ "x-semiotic-derivable": false,
1407
+ "x-semiotic-model-may-propose": false,
1408
+ "x-semiotic-human-review": "never"
1409
+ },
1410
+ "snapshotAt": {
1411
+ "type": "string",
1412
+ "description": "Timestamp represented by a static snapshot.",
1413
+ "x-semiotic-supplied-by": ["system", "import"],
1414
+ "x-semiotic-derivable": true,
1415
+ "x-semiotic-model-may-propose": false,
1416
+ "x-semiotic-human-review": "never"
1417
+ },
1418
+ "presentation": {
1419
+ "$ref": "#/$defs/temporalPresentation",
1420
+ "description": "How temporal state is communicated to the audience.",
1421
+ "x-semiotic-supplied-by": [
1422
+ "author",
1423
+ "system",
1424
+ "model-proposal",
1425
+ "import"
1426
+ ],
1427
+ "x-semiotic-derivable": true,
1428
+ "x-semiotic-model-may-propose": true,
1429
+ "x-semiotic-human-review": "policy-dependent"
1430
+ },
1431
+ "freshness": {
1432
+ "$ref": "#/$defs/temporalFreshness",
1433
+ "description": "Freshness evaluation for the artifact.",
1434
+ "x-semiotic-supplied-by": ["author", "system", "import"],
1435
+ "x-semiotic-derivable": true,
1436
+ "x-semiotic-model-may-propose": false,
1437
+ "x-semiotic-human-review": "policy-dependent"
1438
+ },
1439
+ "watermark": {
1440
+ "$ref": "#/$defs/temporalWatermark",
1441
+ "description": "Event-time watermark and lateness policy.",
1442
+ "x-semiotic-supplied-by": ["system", "import"],
1443
+ "x-semiotic-derivable": true,
1444
+ "x-semiotic-model-may-propose": false,
1445
+ "x-semiotic-human-review": "policy-dependent"
1446
+ },
1447
+ "window": {
1448
+ "$ref": "#/$defs/temporalWindow",
1449
+ "description": "Time window summarized by the artifact.",
1450
+ "x-semiotic-supplied-by": ["author", "system", "import"],
1451
+ "x-semiotic-derivable": true,
1452
+ "x-semiotic-model-may-propose": false,
1453
+ "x-semiotic-human-review": "policy-dependent"
1454
+ },
1455
+ "completeness": {
1456
+ "$ref": "#/$defs/temporalCompleteness",
1457
+ "description": "Completeness evaluation for the represented data.",
1458
+ "x-semiotic-supplied-by": ["author", "system", "import"],
1459
+ "x-semiotic-derivable": true,
1460
+ "x-semiotic-model-may-propose": false,
1461
+ "x-semiotic-human-review": "policy-dependent"
1462
+ },
1463
+ "revision": {
1464
+ "$ref": "#/$defs/temporalRevision",
1465
+ "description": "Revision state relative to earlier artifacts or data.",
1466
+ "x-semiotic-supplied-by": ["author", "system", "import"],
1467
+ "x-semiotic-derivable": true,
1468
+ "x-semiotic-model-may-propose": false,
1469
+ "x-semiotic-human-review": "required"
1470
+ },
1471
+ "snapshot": {
1472
+ "$ref": "#/$defs/temporalSnapshot",
1473
+ "description": "Storage snapshot that can reproduce the represented state.",
1474
+ "x-semiotic-supplied-by": ["system", "import"],
1475
+ "x-semiotic-derivable": true,
1476
+ "x-semiotic-model-may-propose": false,
1477
+ "x-semiotic-human-review": "policy-dependent"
1478
+ },
1479
+ "sources": {
1480
+ "type": "array",
1481
+ "items": { "$ref": "#/$defs/temporalSourceState" },
1482
+ "description": "Source-specific temporal states.",
1483
+ "x-semiotic-supplied-by": ["author", "system", "import"],
1484
+ "x-semiotic-derivable": true,
1485
+ "x-semiotic-model-may-propose": false,
1486
+ "x-semiotic-human-review": "policy-dependent"
1487
+ }
1488
+ }
1489
+ },
1490
+ "receptionChannelContract": {
1491
+ "type": "object",
1492
+ "additionalProperties": false,
1493
+ "required": ["channel"],
1494
+ "properties": {
1495
+ "channel": {
1496
+ "enum": [
1497
+ "visual",
1498
+ "screen-reader",
1499
+ "sonified",
1500
+ "agent",
1501
+ "print",
1502
+ "low-bandwidth"
1503
+ ],
1504
+ "description": "Interface channel governed by these reception requirements.",
1505
+ "x-semiotic-supplied-by": ["author", "system", "import"],
1506
+ "x-semiotic-derivable": true,
1507
+ "x-semiotic-model-may-propose": true,
1508
+ "x-semiotic-human-review": "policy-dependent"
1509
+ },
1510
+ "disclosure": {
1511
+ "enum": ["summary", "standard", "detailed"],
1512
+ "description": "Level of supporting context the channel should disclose.",
1513
+ "x-semiotic-supplied-by": ["author", "system", "import"],
1514
+ "x-semiotic-derivable": true,
1515
+ "x-semiotic-model-may-propose": true,
1516
+ "x-semiotic-human-review": "policy-dependent"
1517
+ },
1518
+ "navigation": {
1519
+ "type": "boolean",
1520
+ "description": "Whether the channel must provide navigable structure.",
1521
+ "x-semiotic-supplied-by": ["author", "system", "import"],
1522
+ "x-semiotic-derivable": true,
1523
+ "x-semiotic-model-may-propose": true,
1524
+ "x-semiotic-human-review": "policy-dependent"
1525
+ },
1526
+ "interactionInstructions": {
1527
+ "type": "boolean",
1528
+ "description": "Whether the channel must explain available interactions.",
1529
+ "x-semiotic-supplied-by": ["author", "system", "import"],
1530
+ "x-semiotic-derivable": true,
1531
+ "x-semiotic-model-may-propose": true,
1532
+ "x-semiotic-human-review": "policy-dependent"
1533
+ },
1534
+ "rawData": {
1535
+ "enum": ["deny", "bounded", "allow"],
1536
+ "description": "Raw-data access allowed through this channel.",
1537
+ "x-semiotic-supplied-by": ["author", "system", "import"],
1538
+ "x-semiotic-derivable": true,
1539
+ "x-semiotic-model-may-propose": false,
1540
+ "x-semiotic-human-review": "required"
1541
+ },
1542
+ "tokenBudget": {
1543
+ "type": "number",
1544
+ "description": "Approximate total serialized grounding-payload budget for this channel, using four characters per token and a 256-token minimum for identity, safety, and omission metadata.",
1545
+ "x-semiotic-supplied-by": ["author", "system", "import"],
1546
+ "x-semiotic-derivable": true,
1547
+ "x-semiotic-model-may-propose": true,
1548
+ "x-semiotic-human-review": "policy-dependent"
1549
+ },
1550
+ "privacyNotes": {
1551
+ "type": "array",
1552
+ "items": { "type": "string" },
1553
+ "description": "Privacy constraints or disclosures for the channel.",
1554
+ "x-semiotic-supplied-by": ["author", "system", "import"],
1555
+ "x-semiotic-derivable": false,
1556
+ "x-semiotic-model-may-propose": false,
1557
+ "x-semiotic-human-review": "required"
1558
+ }
1559
+ }
1560
+ },
1561
+ "receptionContract": {
1562
+ "type": "object",
1563
+ "additionalProperties": false,
1564
+ "required": ["channels"],
1565
+ "properties": {
1566
+ "channels": {
1567
+ "type": "array",
1568
+ "items": { "$ref": "#/$defs/receptionChannelContract" },
1569
+ "description": "Requirements for each supported reception channel.",
1570
+ "x-semiotic-supplied-by": [
1571
+ "author",
1572
+ "system",
1573
+ "model-proposal",
1574
+ "import"
1575
+ ],
1576
+ "x-semiotic-derivable": true,
1577
+ "x-semiotic-model-may-propose": true,
1578
+ "x-semiotic-human-review": "policy-dependent"
1579
+ },
1580
+ "audience": {
1581
+ "type": "string",
1582
+ "description": "Intended audience and relevant context.",
1583
+ "x-semiotic-supplied-by": ["author", "model-proposal", "import"],
1584
+ "x-semiotic-derivable": false,
1585
+ "x-semiotic-model-may-propose": true,
1586
+ "x-semiotic-human-review": "required"
1587
+ },
1588
+ "strengths": {
1589
+ "type": "array",
1590
+ "items": { "type": "string" },
1591
+ "description": "Ways this artifact supports audience understanding.",
1592
+ "x-semiotic-supplied-by": [
1593
+ "author",
1594
+ "system",
1595
+ "model-proposal",
1596
+ "import"
1597
+ ],
1598
+ "x-semiotic-derivable": true,
1599
+ "x-semiotic-model-may-propose": true,
1600
+ "x-semiotic-human-review": "policy-dependent"
1601
+ },
1602
+ "risks": {
1603
+ "type": "array",
1604
+ "items": { "type": "string" },
1605
+ "description": "Audience-specific risks of misunderstanding or misuse.",
1606
+ "x-semiotic-supplied-by": [
1607
+ "author",
1608
+ "system",
1609
+ "model-proposal",
1610
+ "import"
1611
+ ],
1612
+ "x-semiotic-derivable": true,
1613
+ "x-semiotic-model-may-propose": true,
1614
+ "x-semiotic-human-review": "required"
1615
+ },
1616
+ "scaffolds": {
1617
+ "type": "array",
1618
+ "items": { "type": "string" },
1619
+ "description": "Explanations or aids required for interpretation.",
1620
+ "x-semiotic-supplied-by": [
1621
+ "author",
1622
+ "system",
1623
+ "model-proposal",
1624
+ "import"
1625
+ ],
1626
+ "x-semiotic-derivable": true,
1627
+ "x-semiotic-model-may-propose": true,
1628
+ "x-semiotic-human-review": "policy-dependent"
1629
+ },
1630
+ "description": {
1631
+ "type": "string",
1632
+ "description": "Accessible prose description of the artifact.",
1633
+ "x-semiotic-supplied-by": [
1634
+ "author",
1635
+ "system",
1636
+ "model-proposal",
1637
+ "import"
1638
+ ],
1639
+ "x-semiotic-derivable": true,
1640
+ "x-semiotic-model-may-propose": true,
1641
+ "x-semiotic-human-review": "policy-dependent"
1642
+ },
1643
+ "dataFallback": {
1644
+ "type": "boolean",
1645
+ "description": "Whether a structured data fallback is required.",
1646
+ "x-semiotic-supplied-by": ["author", "system", "import"],
1647
+ "x-semiotic-derivable": true,
1648
+ "x-semiotic-model-may-propose": true,
1649
+ "x-semiotic-human-review": "policy-dependent"
1650
+ },
1651
+ "manualChecks": {
1652
+ "type": "array",
1653
+ "items": { "type": "string" },
1654
+ "description": "Reception checks that require human judgment.",
1655
+ "x-semiotic-supplied-by": ["author", "system", "import"],
1656
+ "x-semiotic-derivable": false,
1657
+ "x-semiotic-model-may-propose": false,
1658
+ "x-semiotic-human-review": "required"
1659
+ }
1660
+ }
1661
+ },
1662
+ "rejectedAlternative": {
1663
+ "type": "object",
1664
+ "additionalProperties": false,
1665
+ "required": ["representation", "reason"],
1666
+ "properties": {
1667
+ "representation": {
1668
+ "type": "string",
1669
+ "description": "Alternative representation that was considered.",
1670
+ "x-semiotic-supplied-by": [
1671
+ "author",
1672
+ "system",
1673
+ "model-proposal",
1674
+ "import"
1675
+ ],
1676
+ "x-semiotic-derivable": true,
1677
+ "x-semiotic-model-may-propose": true,
1678
+ "x-semiotic-human-review": "policy-dependent"
1679
+ },
1680
+ "reason": {
1681
+ "type": "string",
1682
+ "description": "Reason the alternative was not selected.",
1683
+ "x-semiotic-supplied-by": [
1684
+ "author",
1685
+ "system",
1686
+ "model-proposal",
1687
+ "import"
1688
+ ],
1689
+ "x-semiotic-derivable": true,
1690
+ "x-semiotic-model-may-propose": true,
1691
+ "x-semiotic-human-review": "policy-dependent"
1692
+ }
1693
+ }
1694
+ },
1695
+ "designContract": {
1696
+ "type": "object",
1697
+ "additionalProperties": false,
1698
+ "properties": {
1699
+ "chartFamily": {
1700
+ "type": "string",
1701
+ "description": "Chart or presentation family chosen for the artifact.",
1702
+ "x-semiotic-supplied-by": ["author", "system", "import"],
1703
+ "x-semiotic-derivable": true,
1704
+ "x-semiotic-model-may-propose": true,
1705
+ "x-semiotic-human-review": "policy-dependent"
1706
+ },
1707
+ "whyThisForm": {
1708
+ "type": "string",
1709
+ "description": "Reason the selected form fits the purpose and evidence.",
1710
+ "x-semiotic-supplied-by": [
1711
+ "author",
1712
+ "system",
1713
+ "model-proposal",
1714
+ "import"
1715
+ ],
1716
+ "x-semiotic-derivable": true,
1717
+ "x-semiotic-model-may-propose": true,
1718
+ "x-semiotic-human-review": "policy-dependent"
1719
+ },
1720
+ "rejectedAlternatives": {
1721
+ "type": "array",
1722
+ "items": { "$ref": "#/$defs/rejectedAlternative" },
1723
+ "description": "Other representations considered and rejected.",
1724
+ "x-semiotic-supplied-by": [
1725
+ "author",
1726
+ "system",
1727
+ "model-proposal",
1728
+ "import"
1729
+ ],
1730
+ "x-semiotic-derivable": true,
1731
+ "x-semiotic-model-may-propose": true,
1732
+ "x-semiotic-human-review": "policy-dependent"
1733
+ },
1734
+ "risks": {
1735
+ "type": "array",
1736
+ "items": { "type": "string" },
1737
+ "description": "Interpretive risks introduced by the chosen form.",
1738
+ "x-semiotic-supplied-by": [
1739
+ "author",
1740
+ "system",
1741
+ "model-proposal",
1742
+ "import"
1743
+ ],
1744
+ "x-semiotic-derivable": true,
1745
+ "x-semiotic-model-may-propose": true,
1746
+ "x-semiotic-human-review": "required"
1747
+ },
1748
+ "misuse": {
1749
+ "type": "array",
1750
+ "items": { "type": "string" },
1751
+ "description": "Foreseeable misuses of the chosen form.",
1752
+ "x-semiotic-supplied-by": [
1753
+ "author",
1754
+ "system",
1755
+ "model-proposal",
1756
+ "import"
1757
+ ],
1758
+ "x-semiotic-derivable": true,
1759
+ "x-semiotic-model-may-propose": true,
1760
+ "x-semiotic-human-review": "required"
1761
+ }
1762
+ }
1763
+ },
1764
+ "claimChallenge": {
1765
+ "type": "object",
1766
+ "additionalProperties": false,
1767
+ "required": ["id", "claimId", "status", "reason"],
1768
+ "properties": {
1769
+ "id": {
1770
+ "type": "string",
1771
+ "minLength": 1,
1772
+ "description": "Stable challenge identifier.",
1773
+ "x-semiotic-supplied-by": ["author", "system", "import"],
1774
+ "x-semiotic-derivable": false,
1775
+ "x-semiotic-model-may-propose": false,
1776
+ "x-semiotic-human-review": "never"
1777
+ },
1778
+ "claimId": {
1779
+ "type": "string",
1780
+ "minLength": 1,
1781
+ "description": "Identifier of the challenged claim.",
1782
+ "x-semiotic-supplied-by": ["author", "system", "import"],
1783
+ "x-semiotic-derivable": false,
1784
+ "x-semiotic-model-may-propose": false,
1785
+ "x-semiotic-human-review": "required"
1786
+ },
1787
+ "status": {
1788
+ "enum": ["open", "accepted", "declined", "resolved"],
1789
+ "description": "Current handling state of the challenge.",
1790
+ "x-semiotic-supplied-by": ["author", "system", "import"],
1791
+ "x-semiotic-derivable": false,
1792
+ "x-semiotic-model-may-propose": false,
1793
+ "x-semiotic-human-review": "required"
1794
+ },
1795
+ "reason": {
1796
+ "type": "string",
1797
+ "description": "Substantive reason for raising the challenge.",
1798
+ "x-semiotic-supplied-by": ["author", "import"],
1799
+ "x-semiotic-derivable": false,
1800
+ "x-semiotic-model-may-propose": false,
1801
+ "x-semiotic-human-review": "required"
1802
+ },
1803
+ "raisedBy": {
1804
+ "$ref": "#/$defs/actorRef",
1805
+ "description": "Actor that raised the challenge.",
1806
+ "x-semiotic-supplied-by": ["author", "system", "import"],
1807
+ "x-semiotic-derivable": false,
1808
+ "x-semiotic-model-may-propose": false,
1809
+ "x-semiotic-human-review": "required"
1810
+ },
1811
+ "raisedAt": {
1812
+ "type": "string",
1813
+ "description": "Timestamp at which the challenge was raised.",
1814
+ "x-semiotic-supplied-by": ["system", "import"],
1815
+ "x-semiotic-derivable": false,
1816
+ "x-semiotic-model-may-propose": false,
1817
+ "x-semiotic-human-review": "never"
1818
+ },
1819
+ "counterclaimId": {
1820
+ "type": "string",
1821
+ "description": "Claim identifier offering an alternative interpretation.",
1822
+ "x-semiotic-supplied-by": ["author", "system", "import"],
1823
+ "x-semiotic-derivable": false,
1824
+ "x-semiotic-model-may-propose": false,
1825
+ "x-semiotic-human-review": "required"
1826
+ },
1827
+ "resolution": {
1828
+ "type": "string",
1829
+ "description": "Documented resolution of the challenge.",
1830
+ "x-semiotic-supplied-by": ["author", "import"],
1831
+ "x-semiotic-derivable": false,
1832
+ "x-semiotic-model-may-propose": false,
1833
+ "x-semiotic-human-review": "required"
1834
+ }
1835
+ }
1836
+ },
1837
+ "correctionRecord": {
1838
+ "type": "object",
1839
+ "additionalProperties": false,
1840
+ "required": ["id", "affectedClaimIds", "reason"],
1841
+ "properties": {
1842
+ "id": {
1843
+ "type": "string",
1844
+ "minLength": 1,
1845
+ "description": "Stable correction identifier.",
1846
+ "x-semiotic-supplied-by": ["author", "system", "import"],
1847
+ "x-semiotic-derivable": false,
1848
+ "x-semiotic-model-may-propose": false,
1849
+ "x-semiotic-human-review": "never"
1850
+ },
1851
+ "affectedClaimIds": {
1852
+ "type": "array",
1853
+ "items": { "type": "string", "minLength": 1 },
1854
+ "description": "Claim identifiers affected by the correction.",
1855
+ "x-semiotic-supplied-by": ["author", "system", "import"],
1856
+ "x-semiotic-derivable": false,
1857
+ "x-semiotic-model-may-propose": false,
1858
+ "x-semiotic-human-review": "required"
1859
+ },
1860
+ "replacementClaimIds": {
1861
+ "type": "array",
1862
+ "items": { "type": "string", "minLength": 1 },
1863
+ "description": "Claim identifiers replacing corrected claims.",
1864
+ "x-semiotic-supplied-by": ["author", "system", "import"],
1865
+ "x-semiotic-derivable": false,
1866
+ "x-semiotic-model-may-propose": false,
1867
+ "x-semiotic-human-review": "required"
1868
+ },
1869
+ "reason": {
1870
+ "type": "string",
1871
+ "description": "Reason the correction was issued.",
1872
+ "x-semiotic-supplied-by": ["author", "import"],
1873
+ "x-semiotic-derivable": false,
1874
+ "x-semiotic-model-may-propose": false,
1875
+ "x-semiotic-human-review": "required"
1876
+ },
1877
+ "createdAt": {
1878
+ "type": "string",
1879
+ "description": "Timestamp at which the correction was recorded.",
1880
+ "x-semiotic-supplied-by": ["system", "import"],
1881
+ "x-semiotic-derivable": false,
1882
+ "x-semiotic-model-may-propose": false,
1883
+ "x-semiotic-human-review": "never"
1884
+ },
1885
+ "createdBy": {
1886
+ "$ref": "#/$defs/actorRef",
1887
+ "description": "Actor responsible for the correction.",
1888
+ "x-semiotic-supplied-by": ["author", "system", "import"],
1889
+ "x-semiotic-derivable": false,
1890
+ "x-semiotic-model-may-propose": false,
1891
+ "x-semiotic-human-review": "required"
1892
+ }
1893
+ }
1894
+ },
1895
+ "alternativeView": {
1896
+ "type": "object",
1897
+ "additionalProperties": false,
1898
+ "required": ["id", "label"],
1899
+ "properties": {
1900
+ "id": {
1901
+ "type": "string",
1902
+ "minLength": 1,
1903
+ "description": "Stable alternative-view identifier.",
1904
+ "x-semiotic-supplied-by": ["author", "system", "import"],
1905
+ "x-semiotic-derivable": true,
1906
+ "x-semiotic-model-may-propose": false,
1907
+ "x-semiotic-human-review": "never"
1908
+ },
1909
+ "label": {
1910
+ "type": "string",
1911
+ "description": "Human-readable alternative-view label.",
1912
+ "x-semiotic-supplied-by": [
1913
+ "author",
1914
+ "system",
1915
+ "model-proposal",
1916
+ "import"
1917
+ ],
1918
+ "x-semiotic-derivable": true,
1919
+ "x-semiotic-model-may-propose": true,
1920
+ "x-semiotic-human-review": "policy-dependent"
1921
+ },
1922
+ "rationale": {
1923
+ "type": "string",
1924
+ "description": "Reason this alternative view is useful.",
1925
+ "x-semiotic-supplied-by": [
1926
+ "author",
1927
+ "system",
1928
+ "model-proposal",
1929
+ "import"
1930
+ ],
1931
+ "x-semiotic-derivable": true,
1932
+ "x-semiotic-model-may-propose": true,
1933
+ "x-semiotic-human-review": "policy-dependent"
1934
+ }
1935
+ }
1936
+ },
1937
+ "editorialException": {
1938
+ "type": "object",
1939
+ "additionalProperties": false,
1940
+ "required": ["ruleId", "rationale"],
1941
+ "properties": {
1942
+ "ruleId": {
1943
+ "type": "string",
1944
+ "minLength": 1,
1945
+ "description": "Identifier of the rule receiving an exception.",
1946
+ "x-semiotic-supplied-by": ["author", "system", "import"],
1947
+ "x-semiotic-derivable": false,
1948
+ "x-semiotic-model-may-propose": false,
1949
+ "x-semiotic-human-review": "required"
1950
+ },
1951
+ "rationale": {
1952
+ "type": "string",
1953
+ "description": "Human-approved reason for the exception.",
1954
+ "x-semiotic-supplied-by": ["author", "import"],
1955
+ "x-semiotic-derivable": false,
1956
+ "x-semiotic-model-may-propose": false,
1957
+ "x-semiotic-human-review": "required"
1958
+ },
1959
+ "owner": {
1960
+ "type": "string",
1961
+ "description": "Actor or team accountable for the exception.",
1962
+ "x-semiotic-supplied-by": ["author", "system", "import"],
1963
+ "x-semiotic-derivable": false,
1964
+ "x-semiotic-model-may-propose": false,
1965
+ "x-semiotic-human-review": "required"
1966
+ },
1967
+ "reviewAt": {
1968
+ "type": "string",
1969
+ "description": "Timestamp at which the exception should be reviewed.",
1970
+ "x-semiotic-supplied-by": ["author", "system", "import"],
1971
+ "x-semiotic-derivable": false,
1972
+ "x-semiotic-model-may-propose": false,
1973
+ "x-semiotic-human-review": "required"
1974
+ }
1975
+ }
1976
+ },
1977
+ "contestabilityContract": {
1978
+ "type": "object",
1979
+ "additionalProperties": false,
1980
+ "properties": {
1981
+ "sourceRequestsAllowed": {
1982
+ "type": "boolean",
1983
+ "description": "Whether recipients may request underlying sources.",
1984
+ "x-semiotic-supplied-by": ["author", "system", "import"],
1985
+ "x-semiotic-derivable": false,
1986
+ "x-semiotic-model-may-propose": false,
1987
+ "x-semiotic-human-review": "required"
1988
+ },
1989
+ "alternativeViews": {
1990
+ "type": "array",
1991
+ "items": { "$ref": "#/$defs/alternativeView" },
1992
+ "description": "Available alternative representations or interpretations.",
1993
+ "x-semiotic-supplied-by": [
1994
+ "author",
1995
+ "system",
1996
+ "model-proposal",
1997
+ "import"
1998
+ ],
1999
+ "x-semiotic-derivable": true,
2000
+ "x-semiotic-model-may-propose": true,
2001
+ "x-semiotic-human-review": "policy-dependent"
2002
+ },
2003
+ "challenges": {
2004
+ "type": "array",
2005
+ "items": { "$ref": "#/$defs/claimChallenge" },
2006
+ "description": "Recorded challenges to claims.",
2007
+ "x-semiotic-supplied-by": ["author", "system", "import"],
2008
+ "x-semiotic-derivable": false,
2009
+ "x-semiotic-model-may-propose": false,
2010
+ "x-semiotic-human-review": "required"
2011
+ },
2012
+ "corrections": {
2013
+ "type": "array",
2014
+ "items": { "$ref": "#/$defs/correctionRecord" },
2015
+ "description": "Corrections issued for claims in this artifact lineage.",
2016
+ "x-semiotic-supplied-by": ["author", "system", "import"],
2017
+ "x-semiotic-derivable": false,
2018
+ "x-semiotic-model-may-propose": false,
2019
+ "x-semiotic-human-review": "required"
2020
+ },
2021
+ "editorialExceptions": {
2022
+ "type": "array",
2023
+ "items": { "$ref": "#/$defs/editorialException" },
2024
+ "description": "Documented exceptions to editorial or policy rules.",
2025
+ "x-semiotic-supplied-by": ["author", "system", "import"],
2026
+ "x-semiotic-derivable": false,
2027
+ "x-semiotic-model-may-propose": false,
2028
+ "x-semiotic-human-review": "required"
2029
+ }
2030
+ }
2031
+ },
2032
+ "reviewRecord": {
2033
+ "type": "object",
2034
+ "additionalProperties": false,
2035
+ "required": ["id", "status"],
2036
+ "properties": {
2037
+ "id": {
2038
+ "type": "string",
2039
+ "minLength": 1,
2040
+ "description": "Stable review identifier.",
2041
+ "x-semiotic-supplied-by": ["author", "system", "import"],
2042
+ "x-semiotic-derivable": false,
2043
+ "x-semiotic-model-may-propose": false,
2044
+ "x-semiotic-human-review": "never"
2045
+ },
2046
+ "status": {
2047
+ "enum": ["pending", "approved", "changes-requested", "rejected"],
2048
+ "description": "Current outcome of the review.",
2049
+ "x-semiotic-supplied-by": ["author", "system", "import"],
2050
+ "x-semiotic-derivable": false,
2051
+ "x-semiotic-model-may-propose": false,
2052
+ "x-semiotic-human-review": "required"
2053
+ },
2054
+ "reviewer": {
2055
+ "$ref": "#/$defs/actorRef",
2056
+ "description": "Actor responsible for the review decision.",
2057
+ "x-semiotic-supplied-by": ["author", "system", "import"],
2058
+ "x-semiotic-derivable": false,
2059
+ "x-semiotic-model-may-propose": false,
2060
+ "x-semiotic-human-review": "required"
2061
+ },
2062
+ "reviewedAt": {
2063
+ "type": "string",
2064
+ "description": "Timestamp at which the review decision was recorded.",
2065
+ "x-semiotic-supplied-by": ["system", "import"],
2066
+ "x-semiotic-derivable": false,
2067
+ "x-semiotic-model-may-propose": false,
2068
+ "x-semiotic-human-review": "never"
2069
+ },
2070
+ "rationale": {
2071
+ "type": "string",
2072
+ "description": "Reviewer-authored explanation for the outcome.",
2073
+ "x-semiotic-supplied-by": ["author", "import"],
2074
+ "x-semiotic-derivable": false,
2075
+ "x-semiotic-model-may-propose": false,
2076
+ "x-semiotic-human-review": "required"
2077
+ },
2078
+ "policyId": {
2079
+ "type": "string",
2080
+ "description": "Policy identifier under which the review occurred.",
2081
+ "x-semiotic-supplied-by": ["author", "system", "import"],
2082
+ "x-semiotic-derivable": false,
2083
+ "x-semiotic-model-may-propose": false,
2084
+ "x-semiotic-human-review": "required"
2085
+ }
2086
+ }
2087
+ },
2088
+ "actionRecord": {
2089
+ "type": "object",
2090
+ "additionalProperties": false,
2091
+ "required": ["id", "action", "claimIds"],
2092
+ "properties": {
2093
+ "id": {
2094
+ "type": "string",
2095
+ "minLength": 1,
2096
+ "description": "Stable downstream-action identifier.",
2097
+ "x-semiotic-supplied-by": ["author", "system", "import"],
2098
+ "x-semiotic-derivable": false,
2099
+ "x-semiotic-model-may-propose": false,
2100
+ "x-semiotic-human-review": "never"
2101
+ },
2102
+ "action": {
2103
+ "type": "string",
2104
+ "description": "Action proposed or taken in response to the artifact.",
2105
+ "x-semiotic-supplied-by": ["author", "system", "import"],
2106
+ "x-semiotic-derivable": false,
2107
+ "x-semiotic-model-may-propose": false,
2108
+ "x-semiotic-human-review": "required"
2109
+ },
2110
+ "actor": {
2111
+ "$ref": "#/$defs/actorRef",
2112
+ "description": "Actor responsible for the action.",
2113
+ "x-semiotic-supplied-by": ["author", "system", "import"],
2114
+ "x-semiotic-derivable": false,
2115
+ "x-semiotic-model-may-propose": false,
2116
+ "x-semiotic-human-review": "required"
2117
+ },
2118
+ "actedAt": {
2119
+ "type": "string",
2120
+ "description": "Timestamp at which the action was recorded.",
2121
+ "x-semiotic-supplied-by": ["system", "import"],
2122
+ "x-semiotic-derivable": false,
2123
+ "x-semiotic-model-may-propose": false,
2124
+ "x-semiotic-human-review": "never"
2125
+ },
2126
+ "claimIds": {
2127
+ "type": "array",
2128
+ "items": { "type": "string", "minLength": 1 },
2129
+ "description": "Claims on which the action depended.",
2130
+ "x-semiotic-supplied-by": ["author", "system", "import"],
2131
+ "x-semiotic-derivable": false,
2132
+ "x-semiotic-model-may-propose": false,
2133
+ "x-semiotic-human-review": "required"
2134
+ },
2135
+ "artifactId": {
2136
+ "type": "string",
2137
+ "description": "Artifact identifier consulted for the action when the surrounding collection is ambiguous.",
2138
+ "x-semiotic-supplied-by": ["author", "system", "import"],
2139
+ "x-semiotic-derivable": true,
2140
+ "x-semiotic-model-may-propose": false,
2141
+ "x-semiotic-human-review": "policy-dependent"
2142
+ },
2143
+ "artifactRevision": {
2144
+ "type": "string",
2145
+ "description": "Artifact revision consulted for the action.",
2146
+ "x-semiotic-supplied-by": ["author", "system", "import"],
2147
+ "x-semiotic-derivable": true,
2148
+ "x-semiotic-model-may-propose": false,
2149
+ "x-semiotic-human-review": "policy-dependent"
2150
+ },
2151
+ "policyId": {
2152
+ "type": "string",
2153
+ "description": "Policy identifier governing the action.",
2154
+ "x-semiotic-supplied-by": ["author", "system", "import"],
2155
+ "x-semiotic-derivable": false,
2156
+ "x-semiotic-model-may-propose": false,
2157
+ "x-semiotic-human-review": "required"
2158
+ },
2159
+ "status": {
2160
+ "enum": ["proposed", "taken", "reversed", "invalidated"],
2161
+ "description": "Lifecycle state of the action.",
2162
+ "x-semiotic-supplied-by": ["author", "system", "import"],
2163
+ "x-semiotic-derivable": false,
2164
+ "x-semiotic-model-may-propose": false,
2165
+ "x-semiotic-human-review": "required"
2166
+ },
2167
+ "invalidatedByClaimId": {
2168
+ "type": "string",
2169
+ "description": "Claim identifier that invalidated the action.",
2170
+ "x-semiotic-supplied-by": ["author", "system", "import"],
2171
+ "x-semiotic-derivable": true,
2172
+ "x-semiotic-model-may-propose": false,
2173
+ "x-semiotic-human-review": "required"
2174
+ }
2175
+ }
2176
+ },
2177
+ "accountabilityContract": {
2178
+ "type": "object",
2179
+ "additionalProperties": false,
2180
+ "properties": {
2181
+ "authors": {
2182
+ "type": "array",
2183
+ "items": { "$ref": "#/$defs/actorRef" },
2184
+ "description": "Actors responsible for authoring the artifact.",
2185
+ "x-semiotic-supplied-by": ["author", "system", "import"],
2186
+ "x-semiotic-derivable": false,
2187
+ "x-semiotic-model-may-propose": false,
2188
+ "x-semiotic-human-review": "policy-dependent"
2189
+ },
2190
+ "generatedBy": {
2191
+ "type": "string",
2192
+ "description": "Tool or process that generated the artifact.",
2193
+ "x-semiotic-supplied-by": ["system", "import"],
2194
+ "x-semiotic-derivable": true,
2195
+ "x-semiotic-model-may-propose": false,
2196
+ "x-semiotic-human-review": "never"
2197
+ },
2198
+ "dataSources": {
2199
+ "type": "array",
2200
+ "items": { "type": "string" },
2201
+ "description": "Source identifiers used by the artifact.",
2202
+ "x-semiotic-supplied-by": ["author", "system", "import"],
2203
+ "x-semiotic-derivable": true,
2204
+ "x-semiotic-model-may-propose": false,
2205
+ "x-semiotic-human-review": "policy-dependent"
2206
+ },
2207
+ "codeRef": {
2208
+ "type": "string",
2209
+ "description": "Code, build, or deployment reference for reproducing the artifact.",
2210
+ "x-semiotic-supplied-by": ["system", "import"],
2211
+ "x-semiotic-derivable": true,
2212
+ "x-semiotic-model-may-propose": false,
2213
+ "x-semiotic-human-review": "never"
2214
+ },
2215
+ "reviews": {
2216
+ "type": "array",
2217
+ "items": { "$ref": "#/$defs/reviewRecord" },
2218
+ "description": "Recorded review decisions for the artifact.",
2219
+ "x-semiotic-supplied-by": ["author", "system", "import"],
2220
+ "x-semiotic-derivable": false,
2221
+ "x-semiotic-model-may-propose": false,
2222
+ "x-semiotic-human-review": "required"
2223
+ },
2224
+ "actions": {
2225
+ "type": "array",
2226
+ "items": { "$ref": "#/$defs/actionRecord" },
2227
+ "description": "Downstream actions tied to specific claims and revisions.",
2228
+ "x-semiotic-supplied-by": ["author", "system", "import"],
2229
+ "x-semiotic-derivable": false,
2230
+ "x-semiotic-model-may-propose": false,
2231
+ "x-semiotic-human-review": "required"
2232
+ }
2233
+ }
2234
+ },
2235
+ "inheritanceContract": {
2236
+ "type": "object",
2237
+ "additionalProperties": false,
2238
+ "properties": {
2239
+ "requiredPaths": {
2240
+ "type": "array",
2241
+ "items": { "type": "string" },
2242
+ "description": "Contract paths that must be retained in derived artifacts.",
2243
+ "x-semiotic-supplied-by": ["author", "system", "import"],
2244
+ "x-semiotic-derivable": true,
2245
+ "x-semiotic-model-may-propose": false,
2246
+ "x-semiotic-human-review": "policy-dependent"
2247
+ },
2248
+ "prohibitedExports": {
2249
+ "type": "array",
2250
+ "items": { "type": "string" },
2251
+ "description": "Export formats or destinations that are not allowed.",
2252
+ "x-semiotic-supplied-by": ["author", "system", "import"],
2253
+ "x-semiotic-derivable": false,
2254
+ "x-semiotic-model-may-propose": false,
2255
+ "x-semiotic-human-review": "required"
2256
+ },
2257
+ "privacy": {
2258
+ "enum": ["public", "restricted", "confidential", "unknown"],
2259
+ "description": "Privacy classification that must survive handoff.",
2260
+ "x-semiotic-supplied-by": ["author", "system", "import"],
2261
+ "x-semiotic-derivable": true,
2262
+ "x-semiotic-model-may-propose": false,
2263
+ "x-semiotic-human-review": "required"
2264
+ },
2265
+ "rawDataDefault": {
2266
+ "enum": ["exclude", "bounded", "include"],
2267
+ "description": "Default raw-data handling for derived outputs.",
2268
+ "x-semiotic-supplied-by": ["author", "system", "import"],
2269
+ "x-semiotic-derivable": true,
2270
+ "x-semiotic-model-may-propose": false,
2271
+ "x-semiotic-human-review": "required"
2272
+ },
2273
+ "preservation": {
2274
+ "enum": [
2275
+ "full-fidelity",
2276
+ "claim-evidence-preserved",
2277
+ "visual-only",
2278
+ "lossy",
2279
+ "unknown"
2280
+ ],
2281
+ "description": "Semantic preservation class for export or transformation.",
2282
+ "x-semiotic-supplied-by": ["author", "system", "import"],
2283
+ "x-semiotic-derivable": true,
2284
+ "x-semiotic-model-may-propose": false,
2285
+ "x-semiotic-human-review": "policy-dependent"
2286
+ },
2287
+ "sourceArtifactIds": {
2288
+ "type": "array",
2289
+ "items": { "type": "string", "minLength": 1 },
2290
+ "description": "Source artifact identifiers from which this artifact inherits obligations.",
2291
+ "x-semiotic-supplied-by": ["author", "system", "import"],
2292
+ "x-semiotic-derivable": true,
2293
+ "x-semiotic-model-may-propose": false,
2294
+ "x-semiotic-human-review": "policy-dependent"
2295
+ }
2296
+ }
2297
+ }
2298
+ }
2299
+ }