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.
- package/README.md +137 -58
- package/agent-skill/semiotic-charts/SKILL.md +27 -17
- package/ai/artifact-contract-reference.md +408 -0
- package/ai/artifact-surface-inventory.json +5586 -0
- package/ai/behaviorContracts.cjs +24 -2
- package/ai/cli.js +480 -56
- package/ai/componentMetadata.cjs +13 -3
- package/ai/dist/mcp-server.js +140 -36407
- package/ai/examples.md +110 -7
- package/ai/reference.md +82 -28
- package/ai/schema.json +7675 -1471
- package/ai/surface-manifest.json +60 -9
- package/ai/system-prompt.md +18 -3
- package/ai/task-packets/compare-category-totals.json +301 -0
- package/ai/task-packets/compare-category-totals.md +188 -0
- package/ai/task-packets/correct-published-chart.json +271 -0
- package/ai/task-packets/correct-published-chart.md +597 -0
- package/ai/task-packets/index.json +40 -0
- package/ai/task-packets/update-live-chart.json +289 -0
- package/ai/task-packets/update-live-chart.md +424 -0
- package/dist/c-2N7IU2NY.min.js +1 -0
- package/dist/c-2WK7YJLL.min.js +1 -0
- package/dist/c-33QOXEUG.min.js +1 -0
- package/dist/c-42PLDTX7.min.js +1 -0
- package/dist/c-447VIMRO.min.js +1 -0
- package/dist/c-4FN7Q6VQ.min.js +1 -0
- package/dist/c-553QUDKA.min.js +1 -0
- package/dist/c-55BAJ333.min.js +1 -0
- package/dist/c-7242NXSG.min.js +1 -0
- package/dist/c-7EGHJU2F.min.js +1 -0
- package/dist/c-7HP7MB2I.min.js +1 -0
- package/dist/c-7NBU5ZKS.min.js +1 -0
- package/dist/c-AFBSWT77.min.js +1 -0
- package/dist/c-AJ7EC32V.min.js +1 -0
- package/dist/c-AQADQNY7.min.js +1 -0
- package/dist/c-ATM475SA.min.js +1 -0
- package/dist/c-AVO3Q7T7.min.js +1 -0
- package/dist/c-AZKPVBOC.min.js +1 -0
- package/dist/c-BNFJMDHN.min.js +1 -0
- package/dist/c-BNG5ECK5.min.js +1 -0
- package/dist/c-BOHCQILI.min.js +1 -0
- package/dist/c-CCTGN5CK.min.js +1 -0
- package/dist/c-CPSPZH6A.min.js +1 -0
- package/dist/c-CPV4N35K.min.js +1 -0
- package/dist/c-D6HAAPTX.min.js +1 -0
- package/dist/c-DE5Q3U2X.min.js +1 -0
- package/dist/c-DK662R77.min.js +1 -0
- package/dist/c-DY2676CR.min.js +1 -0
- package/dist/c-E32M6XW5.min.js +1 -0
- package/dist/c-E4JDJH4I.min.js +1 -0
- package/dist/c-E7I2L7CU.min.js +1 -0
- package/dist/c-EBOQ7ER7.min.js +1 -0
- package/dist/c-ELDWAO2V.min.js +1 -0
- package/dist/c-EUBTECGM.min.js +1 -0
- package/dist/c-GNTXRXRN.min.js +1 -0
- package/dist/c-GSZRZRD6.min.js +1 -0
- package/dist/c-GWX7JGMF.min.js +1 -0
- package/dist/c-GXV3C3MO.min.js +1 -0
- package/dist/c-HHTK2R75.min.js +1 -0
- package/dist/c-HLLFJYTY.min.js +1 -0
- package/dist/c-HPOYKCCG.min.js +1 -0
- package/dist/c-HXDKPIKR.min.js +1 -0
- package/dist/c-I4QJ6YLM.min.js +1 -0
- package/dist/c-IDJV3CZK.min.js +1 -0
- package/dist/c-ITKX3RC5.min.js +1 -0
- package/dist/c-JG2JCQLP.min.js +1 -0
- package/dist/c-JLGRHXGZ.min.js +1 -0
- package/dist/c-JO2UGTCP.min.js +1 -0
- package/dist/c-JUKIWTBJ.min.js +1 -0
- package/dist/c-KCRJGUHP.min.js +1 -0
- package/dist/c-LMGSSD2E.min.js +1 -0
- package/dist/c-LYQMZMZQ.min.js +1 -0
- package/dist/c-LYVKDBQJ.min.js +1 -0
- package/dist/c-MVR3RWF3.min.js +1 -0
- package/dist/c-MXCP7GNZ.min.js +1 -0
- package/dist/c-NG7BLZTR.min.js +1 -0
- package/dist/c-NYZ2QNAM.min.js +1 -0
- package/dist/c-OO5QLMJC.min.js +1 -0
- package/dist/c-OOVX2JPQ.min.js +1 -0
- package/dist/c-ORLEBW72.min.js +1 -0
- package/dist/c-P65V6HLO.min.js +1 -0
- package/dist/c-PP6VY3QU.min.js +1 -0
- package/dist/c-PRIKOLTE.min.js +1 -0
- package/dist/c-PSNI6KAZ.min.js +1 -0
- package/dist/c-PYNW54D2.min.js +1 -0
- package/dist/c-QA3HMQJP.min.js +1 -0
- package/dist/c-QAVFOEUY.min.js +1 -0
- package/dist/c-ROEHCIGV.min.js +1 -0
- package/dist/c-S3AZX5PP.min.js +1 -0
- package/dist/c-T2V7O2LO.min.js +1 -0
- package/dist/c-TIXX5CAU.min.js +1 -0
- package/dist/c-TKG2NP7G.min.js +1 -0
- package/dist/c-VJTDST2R.min.js +1 -0
- package/dist/c-VXLOLYTO.min.js +1 -0
- package/dist/c-W4ZUKSEQ.min.js +1 -0
- package/dist/c-WH2O53VI.min.js +1 -0
- package/dist/c-WNGH47HF.min.js +1 -0
- package/dist/c-WUWXGQYA.min.js +1 -0
- package/dist/c-XDQKXPX4.min.js +1 -0
- package/dist/c-XSB27XPS.min.js +1 -0
- package/dist/c-YDECTEUW.min.js +1 -0
- package/dist/c-YF3YKVQI.min.js +1 -0
- package/dist/c-YLZIV3VS.min.js +1 -0
- package/dist/c-ZYPXQF7B.min.js +1 -0
- package/dist/components/Annotation.d.ts +3 -2
- package/dist/components/access/chartAccessCapabilities.generated.d.ts +14 -0
- package/dist/components/access/chartAccessContract.d.ts +90 -0
- package/dist/components/access/chartAccessContractFixtures.d.ts +11 -0
- package/dist/components/ai/aestheticProfileTypes.d.ts +35 -0
- package/dist/components/ai/annotationProvenance.d.ts +2 -7
- package/dist/components/ai/auditVisualHierarchy.d.ts +49 -0
- package/dist/components/ai/builtInChartRecipeLayouts.d.ts +2 -0
- package/dist/components/ai/builtInChartRecipePublic.d.ts +4 -0
- package/dist/components/ai/builtInChartRecipes.d.ts +26 -0
- package/dist/components/ai/chartCapabilities.d.ts +3 -1
- package/dist/components/ai/chartRecipeRegistry.d.ts +7 -1
- package/dist/components/ai/chartRecipes.d.ts +10 -0
- package/dist/components/ai/colorEvidence.d.ts +12 -0
- package/dist/components/ai/describePhysicsProjection.d.ts +18 -0
- package/dist/components/ai/describePhysicsSource.d.ts +13 -0
- package/dist/components/ai/evaluateAesthetics.d.ts +47 -0
- package/dist/components/ai/geoNavigation.d.ts +4 -0
- package/dist/components/ai/hierarchyNavigation.d.ts +4 -0
- package/dist/components/ai/navigationTree.d.ts +7 -1
- package/dist/components/ai/qualityFixtures.d.ts +8 -0
- package/dist/components/ai/suggestionPropContracts.d.ts +1 -1
- package/dist/components/ai/useNavigationSync.d.ts +3 -3
- package/dist/components/artifact/ArtifactInspector.d.ts +26 -0
- package/dist/components/artifact/ArtifactInspectorContextSections.d.ts +18 -0
- package/dist/components/artifact/artifactContractDiff.d.ts +8 -0
- package/dist/components/artifact/artifactInspectorSummary.d.ts +53 -0
- package/dist/components/artifact/artifactRevision.d.ts +54 -0
- package/dist/components/artifact/artifactTestFixtures.d.ts +17 -0
- package/dist/components/artifact/attachmentAudit.d.ts +13 -0
- package/dist/components/artifact/claimCorrections.d.ts +3 -0
- package/dist/components/artifact/claimGraph.d.ts +5 -0
- package/dist/components/artifact/claimLifecycle.d.ts +32 -0
- package/dist/components/artifact/claims.d.ts +24 -0
- package/dist/components/artifact/collection.d.ts +10 -0
- package/dist/components/artifact/collectionCorrectionScope.d.ts +4 -0
- package/dist/components/artifact/collectionImpact.d.ts +11 -0
- package/dist/components/artifact/collectionLineage.d.ts +3 -0
- package/dist/components/artifact/collectionOperations.d.ts +8 -0
- package/dist/components/artifact/collectionPolicy.d.ts +22 -0
- package/dist/components/artifact/collectionTypes.d.ts +117 -0
- package/dist/components/artifact/configurationRepair.d.ts +8 -0
- package/dist/components/artifact/contract.d.ts +30 -0
- package/dist/components/artifact/evaluateArtifact.d.ts +12 -0
- package/dist/components/artifact/evaluateArtifactTypes.d.ts +78 -0
- package/dist/components/artifact/evaluationPresentation.d.ts +9 -0
- package/dist/components/artifact/evidenceSample.d.ts +8 -0
- package/dist/components/artifact/exportPaths.d.ts +8 -0
- package/dist/components/artifact/fieldPolicies.d.ts +12 -0
- package/dist/components/artifact/fingerprint.d.ts +36 -0
- package/dist/components/artifact/grounding.d.ts +51 -0
- package/dist/components/artifact/groundingBudget.d.ts +38 -0
- package/dist/components/artifact/hostTransfer.d.ts +13 -0
- package/dist/components/artifact/identity.d.ts +19 -0
- package/dist/components/artifact/inheritance.d.ts +48 -0
- package/dist/components/artifact/inheritanceIntegrity.d.ts +3 -0
- package/dist/components/artifact/jsonCompatibility.d.ts +2 -0
- package/dist/components/artifact/obligations.d.ts +3 -0
- package/dist/components/artifact/policies.d.ts +45 -0
- package/dist/components/artifact/policyRelations.d.ts +3 -0
- package/dist/components/artifact/recordProjection.d.ts +7 -0
- package/dist/components/artifact/representation.d.ts +50 -0
- package/dist/components/artifact/serialization.d.ts +40 -0
- package/dist/components/artifact/temporal.d.ts +32 -0
- package/dist/components/artifact/temporalAdapters.d.ts +75 -0
- package/dist/components/artifact/temporalAuditHelpers.d.ts +12 -0
- package/dist/components/artifact/temporalPresentation.d.ts +8 -0
- package/dist/components/artifact/types.d.ts +341 -0
- package/dist/components/artifact/validation.d.ts +13 -0
- package/dist/components/artifact/validationFieldStatus.d.ts +7 -0
- package/dist/components/artifact/validationPrimitives.d.ts +24 -0
- package/dist/components/artifact/validationSurfaces.d.ts +7 -0
- package/dist/components/artifact/validationTemporal.d.ts +3 -0
- package/dist/components/charts/geo/FlowMap.d.ts +7 -0
- package/dist/components/charts/geo/flowMapLineStyle.d.ts +18 -0
- package/dist/components/charts/index.d.ts +4 -0
- package/dist/components/charts/network/ChordDiagram.d.ts +5 -1
- package/dist/components/charts/network/CirclePack.d.ts +8 -1
- package/dist/components/charts/network/OrbitDiagram.d.ts +9 -0
- package/dist/components/charts/network/TreeDiagram.d.ts +8 -1
- package/dist/components/charts/network/Treemap.d.ts +8 -1
- package/dist/components/charts/ordinal/BarChart.d.ts +6 -0
- package/dist/components/charts/ordinal/BoxPlot.d.ts +3 -0
- package/dist/components/charts/ordinal/DonutChart.d.ts +5 -0
- package/dist/components/charts/ordinal/DotPlot.d.ts +3 -0
- package/dist/components/charts/ordinal/FunnelChart.d.ts +5 -0
- package/dist/components/charts/ordinal/GaugeChart.d.ts +3 -0
- package/dist/components/charts/ordinal/GroupedBarChart.d.ts +6 -0
- package/dist/components/charts/ordinal/Histogram.d.ts +3 -0
- package/dist/components/charts/ordinal/LikertChart.d.ts +3 -0
- package/dist/components/charts/ordinal/PieChart.d.ts +5 -0
- package/dist/components/charts/ordinal/RadarChart.capability.d.ts +2 -0
- package/dist/components/charts/ordinal/RadarChart.d.ts +77 -0
- package/dist/components/charts/ordinal/RidgelinePlot.d.ts +3 -0
- package/dist/components/charts/ordinal/StackedBarChart.d.ts +6 -0
- package/dist/components/charts/ordinal/SwarmPlot.d.ts +3 -0
- package/dist/components/charts/ordinal/SwimlaneChart.d.ts +3 -0
- package/dist/components/charts/ordinal/ViolinPlot.d.ts +3 -0
- package/dist/components/charts/physics/CollisionSwarmChart.d.ts +1 -1
- package/dist/components/charts/physics/EventDropChart.d.ts +3 -1
- package/dist/components/charts/physics/GaltonBoardChart.d.ts +4 -2
- package/dist/components/charts/physics/GauntletChart.d.ts +1 -5
- package/dist/components/charts/physics/ProcessFlowChart.d.ts +6 -0
- package/dist/components/charts/physics/UnitPileChart.d.ts +2 -1
- package/dist/components/charts/physics/chainReactionTypes.d.ts +3 -0
- package/dist/components/charts/physics/collisionSwarmPacking.d.ts +14 -0
- package/dist/components/charts/physics/collisionSwarmPhysics.d.ts +1 -0
- package/dist/components/charts/physics/eventDropAdmission.d.ts +32 -0
- package/dist/components/charts/physics/eventDropPhysics.d.ts +22 -1
- package/dist/components/charts/physics/galtonBoardPhysics.d.ts +2 -9
- package/dist/components/charts/physics/gauntletPhysics.d.ts +1 -0
- package/dist/components/charts/physics/physicsChartReconcile.d.ts +4 -0
- package/dist/components/charts/physics/physicsChartUtils.d.ts +1 -1
- package/dist/components/charts/physics/physicsGaltonData.d.ts +10 -0
- package/dist/components/charts/physics/physicsHocHandle.d.ts +2 -0
- package/dist/components/charts/physics/physicsHocUtils.d.ts +7 -1
- package/dist/components/charts/physics/physicsPileData.d.ts +11 -0
- package/dist/components/charts/physics/physicsPilePhysics.d.ts +5 -12
- package/dist/components/charts/physics/physicsProjectionOverlays.d.ts +1 -1
- package/dist/components/charts/physics/physicsSourceRows.d.ts +8 -0
- package/dist/components/charts/physics/usePhysicsChartData.d.ts +19 -0
- package/dist/components/charts/realtime/RealtimeHeatmap.d.ts +14 -1
- package/dist/components/charts/realtime/RealtimeHistogram.d.ts +25 -7
- package/dist/components/charts/realtime/RealtimeLineChart.d.ts +18 -5
- package/dist/components/charts/realtime/RealtimeSwarmChart.d.ts +11 -1
- package/dist/components/charts/realtime/RealtimeWaterfallChart.d.ts +11 -1
- package/dist/components/charts/realtime/aggregate.d.ts +12 -1
- package/dist/components/charts/realtime/realtimeAccessors.d.ts +4 -0
- package/dist/components/charts/realtime/realtimeChartRuntime.d.ts +8 -5
- package/dist/components/charts/realtime/realtimeChartTypes.d.ts +7 -0
- package/dist/components/charts/realtime/realtimeStyleRules.d.ts +4 -0
- package/dist/components/charts/realtime/temporalHistogramConfig.d.ts +17 -11
- package/dist/components/charts/shared/GaugeReadout.d.ts +9 -0
- package/dist/components/charts/shared/ThresholdAnnotation.d.ts +18 -0
- package/dist/components/charts/shared/ThresholdEndCap.d.ts +7 -0
- package/dist/components/charts/shared/annotationStatusFilter.d.ts +18 -0
- package/dist/components/charts/shared/auditAccessibilityText.d.ts +4 -2
- package/dist/components/charts/shared/chartDefinitionPilot.d.ts +5 -4
- package/dist/components/charts/shared/chartSpecCore.d.ts +2 -2
- package/dist/components/charts/shared/heatmapStyleRules.d.ts +13 -0
- package/dist/components/charts/shared/knownChartComponents.d.ts +1 -1
- package/dist/components/charts/shared/networkUtils.d.ts +14 -0
- package/dist/components/charts/shared/numericTickFormatter.d.ts +2 -0
- package/dist/components/charts/shared/radialCenterContent.d.ts +10 -0
- package/dist/components/charts/shared/selectionUtils.d.ts +3 -1
- package/dist/components/charts/shared/tooltipUtils.d.ts +1 -1
- package/dist/components/charts/shared/types.d.ts +4 -2
- package/dist/components/charts/shared/useChartLegend.d.ts +6 -1
- package/dist/components/charts/shared/useLikertAggregation.d.ts +8 -2
- package/dist/components/charts/shared/useNetworkChartSetup.d.ts +9 -5
- package/dist/components/charts/shared/useOrdinalPieceStyle.d.ts +1 -1
- package/dist/components/charts/shared/useXYBrush.d.ts +24 -0
- package/dist/components/charts/shared/useXYPointStyle.d.ts +2 -0
- package/dist/components/charts/xy/BubbleChart.d.ts +7 -0
- package/dist/components/charts/xy/CandlestickChart.d.ts +7 -0
- package/dist/components/charts/xy/DifferenceChart.d.ts +7 -0
- package/dist/components/charts/xy/Heatmap.d.ts +16 -0
- package/dist/components/charts/xy/LineChart.d.ts +9 -0
- package/dist/components/charts/xy/MinimapChart.d.ts +7 -0
- package/dist/components/charts/xy/MultiAxisLineChart.d.ts +7 -0
- package/dist/components/charts/xy/Scatterplot.d.ts +7 -0
- package/dist/components/charts/xy/ScatterplotMatrix.d.ts +6 -0
- package/dist/components/charts/xy/WaterfallChart.capability.d.ts +2 -0
- package/dist/components/charts/xy/WaterfallChart.d.ts +76 -0
- package/dist/components/charts/xy/differenceMarkStyle.d.ts +28 -0
- package/dist/components/charts/xy/multiAxisFields.d.ts +23 -0
- package/dist/components/charts/xy/scatterplotMatrixCells.d.ts +50 -0
- package/dist/components/evidence/chartEvidenceEnvelope.d.ts +154 -0
- package/dist/components/evidence/evidenceEnvelopeInput.d.ts +8 -0
- package/dist/components/evidence/evidenceEnvelopeValidation.d.ts +11 -0
- package/dist/components/evidence/evidenceGate.d.ts +30 -0
- package/dist/components/evidence/renderedSceneHash.d.ts +23 -0
- package/dist/components/evidence/stableJsonHash.d.ts +4 -0
- package/dist/components/export/chartConfig.d.ts +40 -5
- package/dist/components/export/chartConfigArtifact.d.ts +6 -0
- package/dist/components/legendLayout.d.ts +18 -0
- package/dist/components/legendStyles.d.ts +4 -0
- package/dist/components/realtime/BinAccumulator.d.ts +5 -1
- package/dist/components/realtime/types.d.ts +16 -7
- package/dist/components/recipes/adjacencyFlow.d.ts +12 -0
- package/dist/components/recipes/adjacencyFlowAggregation.d.ts +72 -0
- package/dist/components/recipes/adjacencyFlowGeometry.d.ts +79 -0
- package/dist/components/recipes/firstAvailableTrack.d.ts +17 -0
- package/dist/components/recipes/intervals.d.ts +1 -1
- package/dist/components/recipes/lineageDag.d.ts +17 -0
- package/dist/components/recipes/lineageDagHulls.d.ts +22 -0
- package/dist/components/recipes/transitDiagram.d.ts +75 -0
- package/dist/components/recipes/transitDiagramGeometry.d.ts +47 -0
- package/dist/components/semiotic-access.d.ts +9 -0
- package/dist/components/semiotic-ai-audits.d.ts +17 -0
- package/dist/components/semiotic-ai-core.d.ts +38 -18
- package/dist/components/semiotic-ai.d.ts +20 -20
- package/dist/components/semiotic-artifact-react.d.ts +10 -0
- package/dist/components/semiotic-artifact.d.ts +23 -0
- package/dist/components/semiotic-evidence.d.ts +10 -0
- package/dist/components/semiotic-experimental.d.ts +1 -1
- package/dist/components/semiotic-line.d.ts +9 -0
- package/dist/components/semiotic-network.d.ts +3 -0
- package/dist/components/semiotic-ordinal.d.ts +2 -0
- package/dist/components/semiotic-physics.d.ts +4 -4
- package/dist/components/semiotic-realtime-core.d.ts +3 -2
- package/dist/components/semiotic-recipes-core.d.ts +6 -0
- package/dist/components/semiotic-text.d.ts +2 -0
- package/dist/components/semiotic-themes-core.d.ts +3 -0
- package/dist/components/semiotic-utils-core.d.ts +19 -14
- package/dist/components/semiotic-xy.d.ts +3 -0
- package/dist/components/semiotic.d.ts +11 -5
- package/dist/components/server/renderDashboard.d.ts +37 -0
- package/dist/components/server/renderEvidence.d.ts +39 -0
- package/dist/components/server/renderToStaticSVG.d.ts +5 -30
- package/dist/components/server/serverChartConfigShared.d.ts +13 -0
- package/dist/components/server/serverChartConfigs.d.ts +9 -0
- package/dist/components/server/serverChartConfigsComposite.d.ts +4 -0
- package/dist/components/server/serverChartConfigsCustom.d.ts +2 -0
- package/dist/components/server/serverChartConfigsGeo.d.ts +1 -0
- package/dist/components/server/serverChartConfigsOrdinal.d.ts +3 -2
- package/dist/components/server/serverChartConfigsXY.d.ts +1 -0
- package/dist/components/server/serverChartConfigsXYExtra.d.ts +3 -0
- package/dist/components/server/serverCompositeChainReaction.d.ts +3 -0
- package/dist/components/server/serverOrdinalGauge.d.ts +3 -0
- package/dist/components/server/serverOrdinalLikert.d.ts +2 -0
- package/dist/components/server/staticSVGChrome.d.ts +1 -4
- package/dist/components/server/staticXYAxisTicks.d.ts +2 -38
- package/dist/components/server/staticXYGrid.d.ts +1 -1
- package/dist/components/server/svgSizing.d.ts +6 -0
- package/dist/components/shared/svgRoot.d.ts +17 -0
- package/dist/components/store/selectionProvenance.d.ts +14 -0
- package/dist/components/store/themeCore.d.ts +5 -1
- package/dist/components/stream/GeoPipelineStore.d.ts +1 -1
- package/dist/components/stream/GeoSVGOverlay.d.ts +4 -0
- package/dist/components/stream/MarginalGraphics.d.ts +3 -3
- package/dist/components/stream/MarginalGraphicsLazy.d.ts +22 -0
- package/dist/components/stream/NetworkPipelineStore.d.ts +2 -0
- package/dist/components/stream/NetworkSVGOverlay.d.ts +4 -0
- package/dist/components/stream/OrdinalPipelineStore.d.ts +1 -1
- package/dist/components/stream/OrdinalSVGOverlay.d.ts +4 -0
- package/dist/components/stream/PipelineStore.d.ts +1 -1
- package/dist/components/stream/SVGOverlay.d.ts +4 -0
- package/dist/components/stream/SceneToSVG.d.ts +4 -19
- package/dist/components/stream/SceneToSVGXY.d.ts +13 -0
- package/dist/components/stream/StreamGeoFrame.d.ts +1 -2
- package/dist/components/stream/StreamOrdinalFrame.d.ts +1 -2
- package/dist/components/stream/XYGrid.d.ts +11 -0
- package/dist/components/stream/axisTickUtils.d.ts +0 -1
- package/dist/components/stream/canvasSetup.d.ts +8 -2
- package/dist/components/stream/customLayoutAttempt.d.ts +21 -0
- package/dist/components/stream/geoTypes.d.ts +1 -1
- package/dist/components/stream/hitTestUtils.d.ts +2 -0
- package/dist/components/stream/isServerEnvironment.d.ts +6 -0
- package/dist/components/stream/layouts/forceLayoutNodeSize.d.ts +12 -0
- package/dist/components/stream/layouts/forceLayoutPlugin.d.ts +2 -9
- package/dist/components/stream/layouts/forceLayoutWorkerClient.d.ts +2 -21
- package/dist/components/stream/layouts/forceLayoutWorkerPolicy.d.ts +21 -0
- package/dist/components/stream/layouts/index.d.ts +6 -12
- package/dist/components/stream/layouts/missingPlugin.d.ts +7 -0
- package/dist/components/stream/layouts/registerBuiltIn.d.ts +1 -0
- package/dist/components/stream/layouts/registry.d.ts +12 -0
- package/dist/components/stream/marginalConfig.d.ts +3 -0
- package/dist/components/stream/networkCustomLayout.d.ts +7 -0
- package/dist/components/stream/networkCustomLayoutOutput.d.ts +13 -0
- package/dist/components/stream/networkCustomLayoutRunner.d.ts +1 -1
- package/dist/components/stream/networkTypes.d.ts +5 -1
- package/dist/components/stream/ordinalTypes.d.ts +1 -1
- package/dist/components/stream/overlayAccessibleText.d.ts +18 -0
- package/dist/components/stream/physics/PhysicsControllers.d.ts +1 -1
- package/dist/components/stream/physics/PhysicsKernel.d.ts +9 -0
- package/dist/components/stream/physics/PhysicsPipelineStore.d.ts +5 -4
- package/dist/components/stream/physics/PhysicsPipelineTypes.d.ts +9 -0
- package/dist/components/stream/physics/StreamPhysicsTypes.d.ts +4 -1
- package/dist/components/stream/physics/physicsCanvasCoordinates.d.ts +5 -0
- package/dist/components/stream/physics/physicsFixedPosition.d.ts +16 -0
- package/dist/components/stream/physics/physicsKernelCloning.d.ts +6 -0
- package/dist/components/stream/physics/physicsPipelineObservations.d.ts +2 -0
- package/dist/components/stream/physics/physicsPipelineSettle.d.ts +15 -9
- package/dist/components/stream/physics/physicsRegionRuntime.d.ts +8 -17
- package/dist/components/stream/physics/physicsSemanticUI.d.ts +9 -0
- package/dist/components/stream/pipelineConfig.d.ts +4 -0
- package/dist/components/stream/pipelineDomainResolution.d.ts +6 -0
- package/dist/components/stream/pipelineStoreUpdateResults.d.ts +1 -1
- package/dist/components/stream/renderers/pointCanvasRenderer.d.ts +4 -0
- package/dist/components/stream/renderers/resolveCSSColor.d.ts +4 -4
- package/dist/components/stream/resolveXYAxes.d.ts +13 -0
- package/dist/components/stream/sceneToSVGShared.d.ts +2 -1
- package/dist/components/stream/seriesGeometry.d.ts +13 -0
- package/dist/components/stream/streamEncodingTypes.d.ts +53 -0
- package/dist/components/stream/types.d.ts +12 -54
- package/dist/components/stream/useEnsureCustomXYRenderers.d.ts +18 -0
- package/dist/components/stream/useGeoFrameHandle.d.ts +16 -0
- package/dist/components/stream/useMarginalValues.d.ts +13 -0
- package/dist/components/stream/useOrdinalFrameHandle.d.ts +15 -0
- package/dist/components/stream/useXYFrameHandle.d.ts +15 -0
- package/dist/components/stream/xyAxisTicks.d.ts +25 -0
- package/dist/components/stream/xyCanvasRenderers.d.ts +4 -4
- package/dist/components/stream/xyDateTicks.d.ts +3 -2
- package/dist/components/stream/xyFrameAxisTypes.d.ts +2 -0
- package/dist/components/stream/xyPlugins/areaPlugin.d.ts +2 -0
- package/dist/components/stream/xyPlugins/barPlugin.d.ts +2 -0
- package/dist/components/stream/xyPlugins/candlestickPlugin.d.ts +2 -0
- package/dist/components/stream/xyPlugins/customPlugin.d.ts +6 -0
- package/dist/components/stream/xyPlugins/heatmapPlugin.d.ts +2 -0
- package/dist/components/stream/xyPlugins/lineFamily.d.ts +5 -0
- package/dist/components/stream/xyPlugins/linePlugin.d.ts +2 -0
- package/dist/components/stream/xyPlugins/missingPlugin.d.ts +7 -0
- package/dist/components/stream/xyPlugins/mixedPlugin.d.ts +2 -0
- package/dist/components/stream/xyPlugins/pointPlugin.d.ts +3 -0
- package/dist/components/stream/xyPlugins/registerBuiltIn.d.ts +1 -0
- package/dist/components/stream/xyPlugins/registry.d.ts +31 -0
- package/dist/components/stream/xyPlugins/stackedAreaPlugin.d.ts +2 -0
- package/dist/components/stream/xyPlugins/swarmPlugin.d.ts +2 -0
- package/dist/components/stream/xyPlugins/waterfallPlugin.d.ts +2 -0
- package/dist/components/stream/xySceneBuilders/ribbonScene.d.ts +1 -1
- package/dist/components/stream/xySceneBuilders/types.d.ts +1 -0
- package/dist/components/text/annotationTextLayout.d.ts +28 -0
- package/dist/components/text/pretextAnnotationLayout.d.ts +29 -0
- package/dist/components/text/usePretextAnnotations.d.ts +12 -0
- package/dist/controls.module.min.js +1 -1
- package/dist/forceLayoutWorker.js +1 -1
- package/dist/geo.min.js +1 -1
- package/dist/geo.module.min.js +1 -1
- package/dist/network.module.min.js +1 -1
- package/dist/ordinal.module.min.js +1 -1
- package/dist/physics-matter.min.js +1 -1
- package/dist/physics-matter.module.min.js +1 -1
- package/dist/physics-rapier.min.js +1 -1
- package/dist/physics-rapier.module.min.js +1 -1
- package/dist/physics.module.min.js +1 -1
- package/dist/physicsWorker.js +1 -1
- package/dist/processSankeyLayoutWorker.js +1 -1
- package/dist/rough.min.js +1 -1
- package/dist/rough.module.min.js +1 -1
- package/dist/semiotic-access.d.ts +9 -0
- package/dist/semiotic-access.min.js +2 -0
- package/dist/semiotic-access.module.min.js +2 -0
- package/dist/semiotic-ai-artifact-policy-constants.module.min.js +2 -0
- package/dist/semiotic-ai-core.d.ts +38 -18
- package/dist/semiotic-ai-core.min.js +1 -1
- package/dist/semiotic-ai-core.module.min.js +1 -1
- package/dist/semiotic-ai-hash-primitives.module.min.js +2 -0
- package/dist/semiotic-ai.d.ts +20 -20
- package/dist/semiotic-ai.module.min.js +1 -1
- package/dist/semiotic-artifact-react.d.ts +10 -0
- package/dist/semiotic-artifact-react.min.js +2 -0
- package/dist/semiotic-artifact-react.module.min.js +2 -0
- package/dist/semiotic-artifact.d.ts +23 -0
- package/dist/semiotic-artifact.min.js +1 -0
- package/dist/semiotic-artifact.module.min.js +1 -0
- package/dist/semiotic-client-cjs-shared.min.js +1 -1
- package/dist/semiotic-client-glyph.module.min.js +1 -1
- package/dist/semiotic-client-responsive.module.min.js +1 -1
- package/dist/semiotic-client-shared.module.min.js +1 -1
- package/dist/semiotic-custom-layout-selection-cjs-shared.min.js +1 -1
- package/dist/semiotic-data.min.js +1 -1
- package/dist/semiotic-data.module.min.js +1 -1
- package/dist/semiotic-evidence.d.ts +10 -0
- package/dist/semiotic-evidence.min.js +1 -0
- package/dist/semiotic-evidence.module.min.js +1 -0
- package/dist/semiotic-experimental-auxiliary.module.min.js +1 -1
- package/dist/semiotic-experimental-node-auxiliary.module.min.js +1 -1
- package/dist/semiotic-experimental-react-shared.module.min.js +1 -1
- package/dist/semiotic-experimental-vacp.min.js +1 -1
- package/dist/semiotic-experimental-vacp.module.min.js +1 -1
- package/dist/semiotic-experimental.d.ts +1 -1
- package/dist/semiotic-line.d.ts +9 -0
- package/dist/semiotic-line.min.js +2 -0
- package/dist/semiotic-line.module.min.js +2 -0
- package/dist/semiotic-network.d.ts +3 -0
- package/dist/semiotic-ordinal.d.ts +2 -0
- package/dist/semiotic-physics.d.ts +4 -4
- package/dist/semiotic-realtime-core.d.ts +3 -2
- package/dist/semiotic-realtime-core.module.min.js +1 -1
- package/dist/semiotic-realtime-react.module.min.js +1 -1
- package/dist/semiotic-recipes-core-cjs-base.min.js +1 -1
- package/dist/semiotic-recipes-core.d.ts +6 -0
- package/dist/semiotic-recipes-core.module.min.js +1 -1
- package/dist/semiotic-recipes-geo-cjs.min.js +1 -1
- package/dist/semiotic-recipes-react.min.js +1 -1
- package/dist/semiotic-server-edge-node.module.min.js +1 -1
- package/dist/semiotic-server-edge.min.js +1 -1
- package/dist/semiotic-server-edge.module.min.js +1 -1
- package/dist/semiotic-server-node.min.js +1 -1
- package/dist/semiotic-server-node.module.min.js +1 -1
- package/dist/semiotic-text.d.ts +2 -0
- package/dist/semiotic-text.min.js +2 -0
- package/dist/semiotic-text.module.min.js +2 -0
- package/dist/semiotic-themes-core.d.ts +3 -0
- package/dist/semiotic-themes-core.min.js +1 -1
- package/dist/semiotic-themes-core.module.min.js +1 -1
- package/dist/semiotic-themes.min.js +1 -1
- package/dist/semiotic-themes.module.min.js +1 -1
- package/dist/semiotic-utils-core.d.ts +19 -14
- package/dist/semiotic-utils-core.min.js +1 -1
- package/dist/semiotic-utils-core.module.min.js +1 -1
- package/dist/semiotic-value.module.min.js +1 -1
- package/dist/semiotic-xy.d.ts +3 -0
- package/dist/semiotic.d.ts +11 -5
- package/dist/semiotic.module.min.js +1 -1
- package/dist/server.min.js +1 -1
- package/dist/server.module.min.js +1 -1
- package/dist/xy.module.min.js +1 -1
- package/package.json +91 -71
- package/spec/README.md +8 -3
- package/spec/v0.1/artifact-contract.schema.json +2299 -0
- package/spec/v0.1/examples/artifact-contract-full.json +369 -0
- package/spec/v0.1/examples/artifact-contract-unknown-state.json +46 -0
- package/dist/c-3BLJEQNG.min.js +0 -1
- package/dist/c-3KZD6AXJ.min.js +0 -1
- package/dist/c-4TWEX5HG.min.js +0 -1
- package/dist/c-52TEGIUJ.min.js +0 -1
- package/dist/c-5YCIX3VZ.min.js +0 -1
- package/dist/c-6FEKTA3U.min.js +0 -1
- package/dist/c-6O5EVOPH.min.js +0 -1
- package/dist/c-74HEEZGK.min.js +0 -1
- package/dist/c-AKAF6JAD.min.js +0 -1
- package/dist/c-BBKITSXB.min.js +0 -1
- package/dist/c-BWNB6USU.min.js +0 -1
- package/dist/c-C25ENHIK.min.js +0 -1
- package/dist/c-CDR5AO3R.min.js +0 -1
- package/dist/c-COHXCW3Q.min.js +0 -1
- package/dist/c-DADXPJXV.min.js +0 -1
- package/dist/c-E3JFRRMI.min.js +0 -1
- package/dist/c-EBFPQHHO.min.js +0 -1
- package/dist/c-G36WS6LN.min.js +0 -1
- package/dist/c-GGISSW5E.min.js +0 -1
- package/dist/c-GIKRQI4X.min.js +0 -1
- package/dist/c-GPYOFETM.min.js +0 -1
- package/dist/c-IDUHYYSI.min.js +0 -1
- package/dist/c-IUHFPMHD.min.js +0 -1
- package/dist/c-J5G56TUH.min.js +0 -1
- package/dist/c-JAZ73J32.min.js +0 -1
- package/dist/c-KG3NXHAL.min.js +0 -1
- package/dist/c-KII3PLZE.min.js +0 -1
- package/dist/c-LIXGXMNS.min.js +0 -1
- package/dist/c-LVEY6D6B.min.js +0 -1
- package/dist/c-M4Y3BHFR.min.js +0 -1
- package/dist/c-MAIICR2Z.min.js +0 -1
- package/dist/c-MG5DM6VE.min.js +0 -1
- package/dist/c-MNF2S4AA.min.js +0 -1
- package/dist/c-MT3WBK7M.min.js +0 -1
- package/dist/c-NY3JWV2K.min.js +0 -1
- package/dist/c-O6U6K4CW.min.js +0 -1
- package/dist/c-OQ7M4AGV.min.js +0 -1
- package/dist/c-OXYMVK7Q.min.js +0 -1
- package/dist/c-PPWDL5ZI.min.js +0 -1
- package/dist/c-QHF5YON3.min.js +0 -1
- package/dist/c-RR3GO5SW.min.js +0 -1
- package/dist/c-RSVIHIQ4.min.js +0 -1
- package/dist/c-S2BXNNJN.min.js +0 -1
- package/dist/c-S6U5CGT5.min.js +0 -1
- package/dist/c-SLGMUBUL.min.js +0 -1
- package/dist/c-SUILCHWU.min.js +0 -1
- package/dist/c-TZW3JGJ5.min.js +0 -1
- package/dist/c-US5ZFT6E.min.js +0 -1
- package/dist/c-USFMFKIH.min.js +0 -1
- package/dist/c-UUKVD4WB.min.js +0 -1
- package/dist/c-VGW3VG3I.min.js +0 -1
- package/dist/c-W3CE4A4S.min.js +0 -1
- package/dist/c-WJCD5EUY.min.js +0 -1
- package/dist/c-X5UBGU2V.min.js +0 -1
- package/dist/c-YDAY2WFR.min.js +0 -1
- package/dist/c-ZOWWU34K.min.js +0 -1
- /package/dist/{c-N4G2L7ID.min.js → c-HYW2XA4Q.min.js} +0 -0
- /package/dist/{c-OCI56QF2.min.js → c-V4XMSLC3.min.js} +0 -0
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
import type { DescribeChartResult, DescribeLevel } from "../ai/describeChart";
|
|
2
|
+
import type { Datum } from "../charts/shared/datumTypes";
|
|
3
|
+
import type { ActorRef, ArtifactContract, Claim, ClaimChallenge, ClaimKind, CorrectionRecord, EvidenceRef } from "./types";
|
|
4
|
+
export interface DescriptionClaimOptions {
|
|
5
|
+
prefix?: string;
|
|
6
|
+
evidenceIds?: Partial<Record<DescribeLevel, ReadonlyArray<string>>>;
|
|
7
|
+
asOf?: string;
|
|
8
|
+
authoredBy?: ActorRef;
|
|
9
|
+
}
|
|
10
|
+
export interface AnnotationClaimProjection {
|
|
11
|
+
claims: Claim[];
|
|
12
|
+
evidence: EvidenceRef[];
|
|
13
|
+
unknownAnnotationIndexes: number[];
|
|
14
|
+
}
|
|
15
|
+
export interface AnnotationClaimOptions {
|
|
16
|
+
prefix?: string;
|
|
17
|
+
defaultKind?: ClaimKind;
|
|
18
|
+
}
|
|
19
|
+
/**
|
|
20
|
+
* Lift existing annotation origin and lifecycle blocks into artifact-wide
|
|
21
|
+
* claim and evidence records. Missing source facts remain unknown, and model
|
|
22
|
+
* output is recorded without allowing it to support the claim it generated.
|
|
23
|
+
*/
|
|
24
|
+
export declare function claimsFromAnnotations(annotations: ReadonlyArray<Datum>, options?: AnnotationClaimOptions): AnnotationClaimProjection;
|
|
25
|
+
/** Turn layered generated descriptions into traceable claim records. */
|
|
26
|
+
export declare function claimsFromDescription(description: DescribeChartResult, options?: DescriptionClaimOptions): Claim[];
|
|
27
|
+
/** Preserve the old claim and append a replacement linked by stable id. */
|
|
28
|
+
export declare function supersedeClaim(contract: ArtifactContract, previousClaimId: string, replacement: Claim, correction?: Omit<CorrectionRecord, "affectedClaimIds" | "replacementClaimIds">): ArtifactContract;
|
|
29
|
+
/** Retract a claim without deleting its text, evidence, or revision history. */
|
|
30
|
+
export declare function retractClaim(contract: ArtifactContract, claimId: string, correction: Omit<CorrectionRecord, "affectedClaimIds">): ArtifactContract;
|
|
31
|
+
/** Attach an attributable challenge and expose the claim as disputed. */
|
|
32
|
+
export declare function challengeClaim(contract: ArtifactContract, challenge: ClaimChallenge): ArtifactContract;
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
import type { Datum } from "../charts/shared/datumTypes";
|
|
2
|
+
import { type ArtifactContract, type ObligationResult, type ObligationSummary } from "./types";
|
|
3
|
+
export { challengeClaim, claimsFromAnnotations, claimsFromDescription, retractClaim, supersedeClaim, type AnnotationClaimOptions, type AnnotationClaimProjection, type DescriptionClaimOptions } from "./claimLifecycle";
|
|
4
|
+
export interface ClaimAuditOptions {
|
|
5
|
+
/** Require source/version/fingerprint answerability for every used evidence ref. */
|
|
6
|
+
requireEvidenceIdentity?: boolean;
|
|
7
|
+
/** Escalate unreviewed model-authored supported claims from warning to failure. */
|
|
8
|
+
requireReviewForModelClaims?: boolean;
|
|
9
|
+
/** Optional rows for scoped checks such as category overlap. */
|
|
10
|
+
data?: ReadonlyArray<Datum>;
|
|
11
|
+
/** Explicit reference clock used to reject impossible future reviews. */
|
|
12
|
+
now?: string;
|
|
13
|
+
/** Allowed clock skew for review timestamps. Defaults to five minutes. */
|
|
14
|
+
maxFutureReviewSkewMs?: number;
|
|
15
|
+
}
|
|
16
|
+
export interface ClaimAudit {
|
|
17
|
+
ok: boolean;
|
|
18
|
+
claims: number;
|
|
19
|
+
evidence: number;
|
|
20
|
+
summary: ObligationSummary;
|
|
21
|
+
findings: ObligationResult[];
|
|
22
|
+
}
|
|
23
|
+
/** Audit referential integrity and the boundary between evidence and prose. */
|
|
24
|
+
export declare function auditClaims(contract: Pick<ArtifactContract, "claims" | "evidence" | "contestability" | "accountability"> & Partial<Pick<ArtifactContract, "artifact">>, options?: ClaimAuditOptions): ClaimAudit;
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
import { type ArtifactCollectionAuditOptions } from "./collectionPolicy";
|
|
2
|
+
import type { ArtifactCollectionContract, ArtifactCollectionAudit } from "./collectionTypes";
|
|
3
|
+
export type * from "./collectionTypes";
|
|
4
|
+
/** Audit failures that only become visible when individually valid views meet. */
|
|
5
|
+
export declare function auditArtifactCollection(collection: ArtifactCollectionContract, options?: ArtifactCollectionAuditOptions): ArtifactCollectionAudit;
|
|
6
|
+
export declare const auditDashboard: typeof auditArtifactCollection;
|
|
7
|
+
/** Stable identity for collection state and portable export comparisons. */
|
|
8
|
+
export declare function fingerprintArtifactCollection(collection: ArtifactCollectionContract): string;
|
|
9
|
+
export { applyCollectionCorrection, buildArtifactCollectionLineage, serializeArtifactCollection, validateArtifactCollection } from "./collectionOperations";
|
|
10
|
+
export { affectedCollectionClaims } from "./collectionImpact";
|
|
@@ -0,0 +1,4 @@
|
|
|
1
|
+
import type { ArtifactCollectionContract, CollectionClaimReference, CollectionCorrectionRecord } from "./collection";
|
|
2
|
+
export declare function claimReferenceKey(reference: CollectionClaimReference): string;
|
|
3
|
+
export declare function scopedCorrectionReferences(collection: ArtifactCollectionContract, correction: CollectionCorrectionRecord, kind: "affected" | "replacement"): CollectionClaimReference[];
|
|
4
|
+
export declare function correctionScopeIsValid(collection: ArtifactCollectionContract, correction: CollectionCorrectionRecord): boolean;
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
import type { ArtifactCollectionContract, CollectionEvidenceReference } from "./collection";
|
|
2
|
+
/**
|
|
3
|
+
* Identify dependent claims using artifact-qualified evidence references.
|
|
4
|
+
* Legacy string IDs are accepted when unique across the collection; ambiguous
|
|
5
|
+
* IDs throw instead of invalidating unrelated panels. Unknown legacy IDs are
|
|
6
|
+
* ignored, while explicit references must identify existing evidence.
|
|
7
|
+
*/
|
|
8
|
+
export declare function affectedCollectionClaims(collection: ArtifactCollectionContract, changedEvidenceIds: ReadonlyArray<string | CollectionEvidenceReference>): Array<{
|
|
9
|
+
artifactId: string;
|
|
10
|
+
claimId: string;
|
|
11
|
+
}>;
|
|
@@ -0,0 +1,3 @@
|
|
|
1
|
+
import type { ArtifactCollectionContract, ArtifactCollectionLineage } from "./collection";
|
|
2
|
+
/** Build a portable dependency graph from the collection's declared records. */
|
|
3
|
+
export declare function buildArtifactCollectionLineage(collection: ArtifactCollectionContract): ArtifactCollectionLineage;
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
import type { ArtifactCollectionContract, ArtifactCollectionValidation, CollectionCorrectionRecord, SerializedArtifactCollection } from "./collection";
|
|
2
|
+
/** Dependency-free validation for untrusted collection payloads. */
|
|
3
|
+
export declare function validateArtifactCollection(value: unknown): ArtifactCollectionValidation;
|
|
4
|
+
/** Preserve a collection as deterministic JSON and report validation loss. */
|
|
5
|
+
export declare function serializeArtifactCollection(value: unknown): SerializedArtifactCollection;
|
|
6
|
+
/** Apply a collection correction without deleting the previous claim state. */
|
|
7
|
+
export declare function applyCollectionCorrection(collection: ArtifactCollectionContract, correction: CollectionCorrectionRecord): ArtifactCollectionContract;
|
|
8
|
+
export { buildArtifactCollectionLineage } from "./collectionLineage";
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
import { type ArtifactPolicy } from "./policies";
|
|
2
|
+
import type { ArtifactCollectionContract } from "./collection";
|
|
3
|
+
import type { RenderEvidence } from "../server/renderEvidence";
|
|
4
|
+
import type { ObligationResult } from "./types";
|
|
5
|
+
/** The bounded renderer fields a collection policy consumes for each artifact. */
|
|
6
|
+
export type ArtifactCollectionRenderEvidence = Pick<RenderEvidence, "component" | "status" | "empty" | "markCount" | "semanticStatus">;
|
|
7
|
+
export interface ArtifactCollectionAuditOptions {
|
|
8
|
+
/** Explicit reference clock for review, freshness, and expiry checks. */
|
|
9
|
+
now?: string;
|
|
10
|
+
/**
|
|
11
|
+
* Renderer results keyed by artifact ID. The audit reads at most one own
|
|
12
|
+
* entry for each artifact in the collection and never adds this input to the
|
|
13
|
+
* portable collection contract.
|
|
14
|
+
*/
|
|
15
|
+
renderEvidenceByArtifactId?: Readonly<Record<string, ArtifactCollectionRenderEvidence>>;
|
|
16
|
+
}
|
|
17
|
+
export interface ArtifactCollectionPolicyAudit {
|
|
18
|
+
policy?: Pick<ArtifactPolicy, "id" | "version">;
|
|
19
|
+
findings: ObligationResult[];
|
|
20
|
+
}
|
|
21
|
+
/** Apply collection policy rules without changing structural validation. */
|
|
22
|
+
export declare function auditArtifactCollectionPolicy(collection: ArtifactCollectionContract, options?: ArtifactCollectionAuditOptions): ArtifactCollectionPolicyAudit;
|
|
@@ -0,0 +1,117 @@
|
|
|
1
|
+
import type { ActionRecord, ArtifactContract, CorrectionRecord, JsonObject, JsonValue, ObligationResult, ObligationSummary } from "./types";
|
|
2
|
+
export interface MetricDefinition {
|
|
3
|
+
id: string;
|
|
4
|
+
label: string;
|
|
5
|
+
definition: string;
|
|
6
|
+
unit?: string;
|
|
7
|
+
denominator?: string;
|
|
8
|
+
version?: string;
|
|
9
|
+
}
|
|
10
|
+
export interface CollectionFilterState {
|
|
11
|
+
id: string;
|
|
12
|
+
label?: string;
|
|
13
|
+
value?: JsonValue;
|
|
14
|
+
appliesToArtifactIds: string[];
|
|
15
|
+
}
|
|
16
|
+
export interface ArtifactViewState {
|
|
17
|
+
artifactId: string;
|
|
18
|
+
metricIds?: string[];
|
|
19
|
+
filterIds?: string[];
|
|
20
|
+
selectionFingerprint?: string;
|
|
21
|
+
summarySelectionFingerprint?: string;
|
|
22
|
+
status?: "ready" | "stale" | "failed" | "unknown";
|
|
23
|
+
}
|
|
24
|
+
export interface ClaimDependency {
|
|
25
|
+
claimId: string;
|
|
26
|
+
artifactId: string;
|
|
27
|
+
evidenceIds: string[];
|
|
28
|
+
sourceIds?: string[];
|
|
29
|
+
}
|
|
30
|
+
/** An artifact-qualified claim reference for collection-wide records. */
|
|
31
|
+
export interface CollectionClaimReference {
|
|
32
|
+
artifactId: string;
|
|
33
|
+
claimId: string;
|
|
34
|
+
}
|
|
35
|
+
/** Evidence IDs are artifact-local, even when panels share a collection. */
|
|
36
|
+
export interface CollectionEvidenceReference {
|
|
37
|
+
artifactId: string;
|
|
38
|
+
evidenceId: string;
|
|
39
|
+
}
|
|
40
|
+
/**
|
|
41
|
+
* Optional exact targets for a correction whose claim identifiers are not
|
|
42
|
+
* unique across a collection. The unqualified CorrectionRecord fields remain
|
|
43
|
+
* available for compatibility with existing artifact-local records.
|
|
44
|
+
*/
|
|
45
|
+
export interface CollectionCorrectionScope {
|
|
46
|
+
affectedClaims?: CollectionClaimReference[];
|
|
47
|
+
replacementClaims?: CollectionClaimReference[];
|
|
48
|
+
}
|
|
49
|
+
export interface CollectionCorrectionRecord extends CorrectionRecord {
|
|
50
|
+
scope?: CollectionCorrectionScope;
|
|
51
|
+
}
|
|
52
|
+
export interface ArtifactCollectionContract {
|
|
53
|
+
collectionVersion: "0.1";
|
|
54
|
+
id: string;
|
|
55
|
+
title?: string;
|
|
56
|
+
artifacts: ArtifactContract[];
|
|
57
|
+
metrics?: MetricDefinition[];
|
|
58
|
+
policyId?: string;
|
|
59
|
+
filters?: CollectionFilterState[];
|
|
60
|
+
views?: ArtifactViewState[];
|
|
61
|
+
sourceRegistry?: Array<{
|
|
62
|
+
id: string;
|
|
63
|
+
label?: string;
|
|
64
|
+
version?: string;
|
|
65
|
+
fingerprint?: string;
|
|
66
|
+
}>;
|
|
67
|
+
claimDependencies?: ClaimDependency[];
|
|
68
|
+
actions?: ActionRecord[];
|
|
69
|
+
corrections?: CollectionCorrectionRecord[];
|
|
70
|
+
extensions?: JsonObject;
|
|
71
|
+
}
|
|
72
|
+
export interface ArtifactCollectionAudit {
|
|
73
|
+
ok: boolean;
|
|
74
|
+
policy?: {
|
|
75
|
+
id: string;
|
|
76
|
+
version: string;
|
|
77
|
+
};
|
|
78
|
+
summary: ObligationSummary;
|
|
79
|
+
findings: ObligationResult[];
|
|
80
|
+
}
|
|
81
|
+
export type { ArtifactCollectionAuditOptions } from "./collectionPolicy";
|
|
82
|
+
export interface ArtifactCollectionTransfer {
|
|
83
|
+
status: "preserved" | "unsupported-version" | "invalid";
|
|
84
|
+
omittedPaths: string[];
|
|
85
|
+
warnings: string[];
|
|
86
|
+
}
|
|
87
|
+
export interface SerializedArtifactCollection {
|
|
88
|
+
collection?: ArtifactCollectionContract | JsonObject;
|
|
89
|
+
transfer: ArtifactCollectionTransfer;
|
|
90
|
+
}
|
|
91
|
+
export interface ArtifactCollectionValidation {
|
|
92
|
+
valid: boolean;
|
|
93
|
+
errors: Array<{
|
|
94
|
+
path: string;
|
|
95
|
+
message: string;
|
|
96
|
+
}>;
|
|
97
|
+
warnings: Array<{
|
|
98
|
+
path: string;
|
|
99
|
+
message: string;
|
|
100
|
+
}>;
|
|
101
|
+
}
|
|
102
|
+
export type ArtifactLineageNodeKind = "source" | "schema" | "processing-job" | "quality-check" | "snapshot" | "artifact" | "evidence" | "claim" | "action";
|
|
103
|
+
export interface ArtifactLineageNode {
|
|
104
|
+
id: string;
|
|
105
|
+
kind: ArtifactLineageNodeKind;
|
|
106
|
+
label?: string;
|
|
107
|
+
artifactId?: string;
|
|
108
|
+
}
|
|
109
|
+
export interface ArtifactLineageEdge {
|
|
110
|
+
source: string;
|
|
111
|
+
target: string;
|
|
112
|
+
relation: "produces" | "supports" | "contains" | "acts-on" | "supersedes";
|
|
113
|
+
}
|
|
114
|
+
export interface ArtifactCollectionLineage {
|
|
115
|
+
nodes: ArtifactLineageNode[];
|
|
116
|
+
edges: ArtifactLineageEdge[];
|
|
117
|
+
}
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
import type { Datum } from "../charts/shared/datumTypes";
|
|
2
|
+
import type { ArtifactRepairLedgerEntry } from "./evaluateArtifactTypes";
|
|
3
|
+
/**
|
|
4
|
+
* Project deterministic chart-fit advice into the artifact repair ledger.
|
|
5
|
+
* Alternative components remain proposals: changing form can change emphasis,
|
|
6
|
+
* so the fit engine alone cannot establish semantic equivalence.
|
|
7
|
+
*/
|
|
8
|
+
export declare function configurationRepairLedgerEntries(component: string, props: Datum, data: ReadonlyArray<Datum> | null | undefined, intents: ReadonlyArray<string>): ArtifactRepairLedgerEntry[];
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
import type { Datum } from "../charts/shared/datumTypes";
|
|
2
|
+
import type { IntentManifest } from "../ai/intentManifest";
|
|
3
|
+
import { type ArtifactContract, type ArtifactContractInput } from "./types";
|
|
4
|
+
export { ARTIFACT_FIELD_POLICIES, type ArtifactFieldPolicy } from "./fieldPolicies";
|
|
5
|
+
export { validateArtifactContract, type ArtifactContractValidation } from "./validation";
|
|
6
|
+
/**
|
|
7
|
+
* Build the optional interpretation sidecar for a chart. Only configuration
|
|
8
|
+
* and data identities are inferred automatically; purpose, stakes, evidence,
|
|
9
|
+
* time, review, and approval remain unknown unless a caller supplies them.
|
|
10
|
+
*/
|
|
11
|
+
export declare function buildArtifactContract(component: string, props?: Datum, input?: ArtifactContractInput): ArtifactContract;
|
|
12
|
+
export interface IntentManifestProjection {
|
|
13
|
+
manifest: IntentManifest;
|
|
14
|
+
omittedPaths: string[];
|
|
15
|
+
}
|
|
16
|
+
/** Adapt the earlier intent manifest into the broader artifact contract. */
|
|
17
|
+
export declare function fromIntentManifest(manifest: IntentManifest): ArtifactContract;
|
|
18
|
+
/**
|
|
19
|
+
* Project a contract back to the earlier manifest format and report the richer
|
|
20
|
+
* paths that format cannot carry.
|
|
21
|
+
*/
|
|
22
|
+
export declare function toIntentManifest(contract: ArtifactContract): IntentManifestProjection;
|
|
23
|
+
export interface FormatArtifactContractOptions {
|
|
24
|
+
/** Include explicit unknown, manual, and not-applicable field states. */
|
|
25
|
+
includeFieldStatus?: boolean;
|
|
26
|
+
/** Override the separator used between output lines. */
|
|
27
|
+
lineSeparator?: string;
|
|
28
|
+
}
|
|
29
|
+
/** Compact text for logs, CLI output, and progressive disclosure headers. */
|
|
30
|
+
export declare function formatArtifactContract(contract: ArtifactContract, options?: FormatArtifactContractOptions): string;
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
import type { Datum } from "../charts/shared/datumTypes";
|
|
2
|
+
import type { ArtifactContract } from "./types";
|
|
3
|
+
import type { ArtifactEvaluation, ArtifactRepairResult, EvaluateArtifactOptions, RepairArtifactOptions } from "./evaluateArtifactTypes";
|
|
4
|
+
export type { ArtifactEvaluation, ArtifactRepairLedgerEntry, ArtifactRepairResult, EvaluateArtifactOptions, RepairArtifactOptions, RepairProposal } from "./evaluateArtifactTypes";
|
|
5
|
+
export { explainArtifactRefusal } from "./evaluationPresentation";
|
|
6
|
+
/**
|
|
7
|
+
* Compose chart, claim, time, accessibility, and policy evidence without
|
|
8
|
+
* flattening them into a single aggregate score.
|
|
9
|
+
*/
|
|
10
|
+
export declare function evaluateArtifact(component: string, props: Datum, contract: ArtifactContract, options?: EvaluateArtifactOptions): ArtifactEvaluation;
|
|
11
|
+
/** Apply deterministic repairs without inventing evidence, review, or claims. */
|
|
12
|
+
export declare function repairArtifact(component: string, props: Datum, contract: ArtifactContract, options?: RepairArtifactOptions): ArtifactRepairResult;
|
|
@@ -0,0 +1,78 @@
|
|
|
1
|
+
import type { Datum } from "../charts/shared/datumTypes";
|
|
2
|
+
import type { EvaluateChartOptions, EvaluateChartResult } from "../ai/evaluateChart";
|
|
3
|
+
import type { ArtifactPolicyException, ArtifactPolicyInput } from "./policies";
|
|
4
|
+
import type { RepresentationCandidate, RepresentationRecommendation } from "./representation";
|
|
5
|
+
import type { ClaimAudit } from "./claims";
|
|
6
|
+
import type { TemporalAudit } from "./temporal";
|
|
7
|
+
import type { ArtifactContractValidation } from "./contract";
|
|
8
|
+
import type { ArtifactContract, ObligationResult } from "./types";
|
|
9
|
+
export interface RepairProposal {
|
|
10
|
+
id: string;
|
|
11
|
+
category?: "identity" | "configuration" | "contract";
|
|
12
|
+
path?: string;
|
|
13
|
+
action: string;
|
|
14
|
+
reason: string;
|
|
15
|
+
changesClaim: boolean;
|
|
16
|
+
}
|
|
17
|
+
export interface EvaluateArtifactOptions extends EvaluateChartOptions {
|
|
18
|
+
data?: ReadonlyArray<Datum>;
|
|
19
|
+
policy?: ArtifactPolicyInput;
|
|
20
|
+
exceptions?: ReadonlyArray<ArtifactPolicyException>;
|
|
21
|
+
now?: string;
|
|
22
|
+
recommendRepresentation?: boolean;
|
|
23
|
+
}
|
|
24
|
+
export interface ArtifactEvaluation {
|
|
25
|
+
/** Conditional results retain open work and are not publication approval. */
|
|
26
|
+
status: "acceptable" | "conditional" | "refuse";
|
|
27
|
+
policy: {
|
|
28
|
+
id: string;
|
|
29
|
+
version: string;
|
|
30
|
+
appliedExceptions: ArtifactPolicyException[];
|
|
31
|
+
rejectedExceptions: ArtifactPolicyException[];
|
|
32
|
+
};
|
|
33
|
+
validation: {
|
|
34
|
+
artifact: ArtifactContractValidation;
|
|
35
|
+
chart: EvaluateChartResult["validation"];
|
|
36
|
+
};
|
|
37
|
+
data: EvaluateChartResult["data"];
|
|
38
|
+
claims: ClaimAudit;
|
|
39
|
+
temporal: TemporalAudit;
|
|
40
|
+
accessibility: EvaluateChartResult["accessibility"];
|
|
41
|
+
design: EvaluateChartResult["deception"];
|
|
42
|
+
render?: EvaluateChartResult["evidence"];
|
|
43
|
+
obligations: ObligationResult[];
|
|
44
|
+
recommendation?: RepresentationRecommendation;
|
|
45
|
+
alternatives: RepresentationCandidate[];
|
|
46
|
+
repairs: RepairProposal[];
|
|
47
|
+
manualChecks: string[];
|
|
48
|
+
}
|
|
49
|
+
export interface ArtifactRepairLedgerEntry {
|
|
50
|
+
id: string;
|
|
51
|
+
/** Distinguishes render/configuration work from contract and identity work. */
|
|
52
|
+
category?: "identity" | "configuration" | "contract";
|
|
53
|
+
path: string;
|
|
54
|
+
action: string;
|
|
55
|
+
reason: string;
|
|
56
|
+
applied: boolean;
|
|
57
|
+
changesClaim: boolean;
|
|
58
|
+
/** Ranked replacement from the deterministic chart-fit repair engine. */
|
|
59
|
+
suggestedComponent?: string;
|
|
60
|
+
suggestedVariant?: string;
|
|
61
|
+
}
|
|
62
|
+
export interface RepairArtifactOptions extends EvaluateArtifactOptions {
|
|
63
|
+
/**
|
|
64
|
+
* Fill absent identity fields only; never overwrite an existing binding.
|
|
65
|
+
* Mismatches require an explicit revision and claim reassessment.
|
|
66
|
+
* Defaults to proposal-only.
|
|
67
|
+
*/
|
|
68
|
+
applySafeIdentityRepairs?: boolean;
|
|
69
|
+
}
|
|
70
|
+
export interface ArtifactRepairResult {
|
|
71
|
+
status: "unchanged" | "repaired" | "requires-input";
|
|
72
|
+
component: string;
|
|
73
|
+
props: Datum;
|
|
74
|
+
contract: ArtifactContract;
|
|
75
|
+
before: ArtifactEvaluation;
|
|
76
|
+
after: ArtifactEvaluation;
|
|
77
|
+
ledger: ArtifactRepairLedgerEntry[];
|
|
78
|
+
}
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
import type { EvaluateChartResult } from "../ai/evaluateChart";
|
|
2
|
+
import type { ArtifactEvaluation, RepairProposal } from "./evaluateArtifactTypes";
|
|
3
|
+
import type { ObligationResult } from "./types";
|
|
4
|
+
export declare function chartObligations(chart: EvaluateChartResult): ObligationResult[];
|
|
5
|
+
export declare function renderEvidenceObligations(chart: EvaluateChartResult, required: boolean): ObligationResult[];
|
|
6
|
+
export declare function repairProposals(obligations: ReadonlyArray<ObligationResult>): RepairProposal[];
|
|
7
|
+
export declare function hasCriticalAccessibilityFailure(chart: EvaluateChartResult): boolean;
|
|
8
|
+
/** Explain a policy refusal in stable, user-facing language. */
|
|
9
|
+
export declare function explainArtifactRefusal(evaluation: ArtifactEvaluation): string;
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
import type { EvidenceRef } from "./types";
|
|
2
|
+
/** Bound rows, fields, names, and total payload size as one consistent unit. */
|
|
3
|
+
export declare function boundEvidenceSample(sample: NonNullable<EvidenceRef["sample"]>, options?: {
|
|
4
|
+
maxRows?: number;
|
|
5
|
+
maxFields?: number;
|
|
6
|
+
maxFieldLength?: number;
|
|
7
|
+
maxCharacters?: number;
|
|
8
|
+
}): NonNullable<EvidenceRef["sample"]>;
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
export interface ArtifactPathSegment {
|
|
2
|
+
key: string;
|
|
3
|
+
each: boolean;
|
|
4
|
+
}
|
|
5
|
+
export declare function artifactPathContains(parent: string, child: string): boolean;
|
|
6
|
+
export declare function artifactPathsOverlap(left: string, right: string): boolean;
|
|
7
|
+
export declare function parseArtifactExportPath(path: string): ArtifactPathSegment[] | undefined;
|
|
8
|
+
export declare function deleteArtifactExportPath(value: unknown, segments: ReadonlyArray<ArtifactPathSegment>, index?: number): boolean;
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
export interface ArtifactFieldPolicy {
|
|
2
|
+
suppliedBy: ReadonlyArray<"author" | "system" | "model-proposal" | "import">;
|
|
3
|
+
derivable: boolean;
|
|
4
|
+
modelMayPropose: boolean;
|
|
5
|
+
humanReview: "never" | "policy-dependent" | "required";
|
|
6
|
+
}
|
|
7
|
+
/**
|
|
8
|
+
* Field authorship rules for the contract's externally meaningful values.
|
|
9
|
+
* A model may suggest prose and decisions, but cannot manufacture source,
|
|
10
|
+
* version, clock, review, or approval facts.
|
|
11
|
+
*/
|
|
12
|
+
export declare const ARTIFACT_FIELD_POLICIES: Readonly<Record<string, ArtifactFieldPolicy>>;
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
import type { JsonValue } from "./types";
|
|
2
|
+
export interface CanonicalJsonResult {
|
|
3
|
+
value: JsonValue;
|
|
4
|
+
text: string;
|
|
5
|
+
excludedPaths: string[];
|
|
6
|
+
}
|
|
7
|
+
export interface ValueFingerprint extends CanonicalJsonResult {
|
|
8
|
+
algorithm: "sha256";
|
|
9
|
+
digest: string;
|
|
10
|
+
fingerprint: string;
|
|
11
|
+
}
|
|
12
|
+
/**
|
|
13
|
+
* Convert a value to deterministic JSON by sorting object keys and recording
|
|
14
|
+
* values that cannot be represented. Array positions are retained as null so
|
|
15
|
+
* removal cannot silently shift later evidence.
|
|
16
|
+
*/
|
|
17
|
+
export declare function canonicalJson(input: unknown): CanonicalJsonResult;
|
|
18
|
+
/**
|
|
19
|
+
* Produce a stable SHA-256 content identity. The digest is suitable for cache
|
|
20
|
+
* keys, revision comparisons, and evidence binding; without a trusted signing
|
|
21
|
+
* process it does not prove authorship or tamper resistance.
|
|
22
|
+
*/
|
|
23
|
+
export declare function fingerprintValue(input: unknown): ValueFingerprint;
|
|
24
|
+
/** Build a bounded, privacy-conscious evidence sample from row data. */
|
|
25
|
+
export declare function boundedEvidenceSample(rows: ReadonlyArray<unknown>, options?: {
|
|
26
|
+
maxRows?: number;
|
|
27
|
+
maxFields?: number;
|
|
28
|
+
maxFieldLength?: number;
|
|
29
|
+
maxCharacters?: number;
|
|
30
|
+
fields?: ReadonlyArray<string>;
|
|
31
|
+
}): {
|
|
32
|
+
rowCount: number;
|
|
33
|
+
fields: string[];
|
|
34
|
+
values: JsonValue[];
|
|
35
|
+
truncated: boolean;
|
|
36
|
+
};
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
import type { Datum } from "../charts/shared/datumTypes";
|
|
2
|
+
import { type ChartReaderGrounding } from "../ai/readerGrounding";
|
|
3
|
+
import type { ArtifactContract, Claim, CorrectionRecord, EvidenceRef, ReceptionChannel, TemporalContext } from "./types";
|
|
4
|
+
export interface BuildArtifactGroundingOptions {
|
|
5
|
+
channel: ReceptionChannel;
|
|
6
|
+
tokenBudget?: number;
|
|
7
|
+
disclosureLevel?: "summary" | "standard" | "detailed";
|
|
8
|
+
includeRawData?: boolean;
|
|
9
|
+
maxNavigationLeaves?: number;
|
|
10
|
+
}
|
|
11
|
+
export type GroundedClaim = Claim;
|
|
12
|
+
export type GroundedEvidence = EvidenceRef;
|
|
13
|
+
export type { ArtifactGroundingBudget } from "./groundingBudget";
|
|
14
|
+
export interface ArtifactGrounding {
|
|
15
|
+
groundingVersion: "0.1";
|
|
16
|
+
artifact: {
|
|
17
|
+
id: string;
|
|
18
|
+
kind: ArtifactContract["artifact"]["kind"];
|
|
19
|
+
component?: string;
|
|
20
|
+
title?: string;
|
|
21
|
+
revision?: string;
|
|
22
|
+
};
|
|
23
|
+
channel: ReceptionChannel;
|
|
24
|
+
disclosureLevel: "summary" | "standard" | "detailed";
|
|
25
|
+
purpose: ArtifactContract["purpose"];
|
|
26
|
+
claims: GroundedClaim[];
|
|
27
|
+
evidence: GroundedEvidence[];
|
|
28
|
+
time?: TemporalContext;
|
|
29
|
+
form?: ArtifactContract["form"];
|
|
30
|
+
contestability?: ArtifactContract["contestability"];
|
|
31
|
+
accountability?: ArtifactContract["accountability"];
|
|
32
|
+
uncertainty: string[];
|
|
33
|
+
corrections: CorrectionRecord[];
|
|
34
|
+
chart?: ChartReaderGrounding;
|
|
35
|
+
security: {
|
|
36
|
+
contentClassification: "untrusted-data";
|
|
37
|
+
instructionBoundary: string;
|
|
38
|
+
rawDataIncluded: boolean;
|
|
39
|
+
evidenceSamplesIncluded: boolean;
|
|
40
|
+
};
|
|
41
|
+
budget: import("./groundingBudget").ArtifactGroundingBudget;
|
|
42
|
+
omittedPaths: string[];
|
|
43
|
+
truncated: boolean;
|
|
44
|
+
text: string;
|
|
45
|
+
}
|
|
46
|
+
/**
|
|
47
|
+
* Project common contract evidence into a channel-specific reading. Source
|
|
48
|
+
* labels, annotations, and claim prose are always marked as untrusted data,
|
|
49
|
+
* never executable instructions.
|
|
50
|
+
*/
|
|
51
|
+
export declare function buildArtifactGrounding(component: string, props: Datum, contract: ArtifactContract, options: BuildArtifactGroundingOptions): ArtifactGrounding;
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
import type { ArtifactContract, TemporalContext } from "./types";
|
|
2
|
+
import type { ArtifactGrounding, GroundedClaim, GroundedEvidence } from "./grounding";
|
|
3
|
+
export interface ArtifactGroundingBudget {
|
|
4
|
+
/** Budget requested by the caller or reception channel. */
|
|
5
|
+
requestedTokens: number;
|
|
6
|
+
/**
|
|
7
|
+
* Applied upper bound using the documented four-serialized-characters per
|
|
8
|
+
* token approximation. A 256-token minimum retains identity, safety, and
|
|
9
|
+
* omission metadata even when the requested budget is smaller.
|
|
10
|
+
*/
|
|
11
|
+
effectiveTokens: number;
|
|
12
|
+
/** Exact JSON.stringify length of this grounding payload. */
|
|
13
|
+
serializedCharacters: number;
|
|
14
|
+
minimumEnvelopeApplied: boolean;
|
|
15
|
+
}
|
|
16
|
+
export declare const MINIMUM_GROUNDING_TOKENS = 256;
|
|
17
|
+
export declare function buildGroundingText(input: {
|
|
18
|
+
artifact: ArtifactGrounding["artifact"];
|
|
19
|
+
purpose: ArtifactContract["purpose"];
|
|
20
|
+
claims: GroundedClaim[];
|
|
21
|
+
evidence: GroundedEvidence[];
|
|
22
|
+
time?: TemporalContext;
|
|
23
|
+
form?: ArtifactContract["form"];
|
|
24
|
+
uncertainty: string[];
|
|
25
|
+
contestability?: ArtifactContract["contestability"];
|
|
26
|
+
accountability?: ArtifactContract["accountability"];
|
|
27
|
+
}): string;
|
|
28
|
+
/**
|
|
29
|
+
* Bound the complete serialized payload, not only its readable text. The
|
|
30
|
+
* requested budget uses a deterministic four-character token approximation.
|
|
31
|
+
* Very small requests retain a fixed 256-token identity, safety, and omission
|
|
32
|
+
* envelope; `budget` reports both the requested and effective limits.
|
|
33
|
+
*
|
|
34
|
+
* Reductions remove whole semantic sections or optional record details. Claim
|
|
35
|
+
* and evidence graphs are removed together, so a bounded result never leaves
|
|
36
|
+
* dangling support references. Values are never shortened into new facts.
|
|
37
|
+
*/
|
|
38
|
+
export declare function applyGroundingBudget(grounding: ArtifactGrounding, tokenBudget: number): ArtifactGrounding;
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
import { type ArtifactPacket } from "./inheritance";
|
|
2
|
+
export type ArtifactSidecarFormat = "png-sidecar" | "notebook" | "static-package";
|
|
3
|
+
export interface AdjacentArtifactSidecar {
|
|
4
|
+
format: ArtifactSidecarFormat;
|
|
5
|
+
hostPath: string;
|
|
6
|
+
sidecarPath: string;
|
|
7
|
+
mediaType: "application/json";
|
|
8
|
+
content: string;
|
|
9
|
+
}
|
|
10
|
+
/** Embed a complete SVG-format packet as machine-readable XML metadata. */
|
|
11
|
+
export declare function embedArtifactPacketInSvg(svg: string, packet: ArtifactPacket): string;
|
|
12
|
+
/** Prepare an inspectable JSON file to be written beside a static host. */
|
|
13
|
+
export declare function createAdjacentArtifactSidecar(packet: ArtifactPacket, hostPath: string): AdjacentArtifactSidecar;
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
import type { Datum } from "../charts/shared/datumTypes";
|
|
2
|
+
import type { ArtifactContract, EvidenceRef } from "./types";
|
|
3
|
+
/** Select the data-bearing props used by artifact identity checks. */
|
|
4
|
+
export declare function artifactDataValue(props: Datum): unknown;
|
|
5
|
+
/**
|
|
6
|
+
* Bind data identity to declared transformations as well as input values.
|
|
7
|
+
* Evidence order does not affect the result, but changing a transformation's
|
|
8
|
+
* inputs, parameters, assumptions, or implementation does.
|
|
9
|
+
*/
|
|
10
|
+
export declare function artifactDataFingerprint(data: unknown, evidence?: ReadonlyArray<EvidenceRef>): string | undefined;
|
|
11
|
+
/** Select serializable configuration props without embedding chart rows. */
|
|
12
|
+
export declare function artifactConfigurationValue(props: Datum): Datum;
|
|
13
|
+
export interface ArtifactIdentityBinding {
|
|
14
|
+
status: "match" | "mismatch" | "unknown";
|
|
15
|
+
mismatchPaths: string[];
|
|
16
|
+
unknownPaths: string[];
|
|
17
|
+
}
|
|
18
|
+
/** Compare declared artifact identity with one concrete component/config/data input. */
|
|
19
|
+
export declare function compareArtifactIdentity(contract: ArtifactContract, props: Datum, component?: string, suppliedData?: unknown): ArtifactIdentityBinding;
|
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
import type { ArtifactContract, Claim, CorrectionRecord, EvidenceRef, PreservationClass, TemporalContext } from "./types";
|
|
2
|
+
export type ArtifactTransferFormat = "semiotic-config" | "portable-recipe" | "vega-lite" | "html" | "svg" | "png-sidecar" | "notebook" | "static-package" | "mcp";
|
|
3
|
+
export interface ArtifactTransferReport {
|
|
4
|
+
format: ArtifactTransferFormat;
|
|
5
|
+
preservation: PreservationClass;
|
|
6
|
+
preservedPaths: string[];
|
|
7
|
+
omittedPaths: string[];
|
|
8
|
+
warnings: string[];
|
|
9
|
+
}
|
|
10
|
+
export interface ArtifactPacket {
|
|
11
|
+
packetVersion: "0.1";
|
|
12
|
+
artifactId: string;
|
|
13
|
+
contractFingerprint: string;
|
|
14
|
+
transferFingerprint: string;
|
|
15
|
+
contract: ArtifactContract;
|
|
16
|
+
transfer: ArtifactTransferReport;
|
|
17
|
+
}
|
|
18
|
+
export interface ArtifactPacketValidation {
|
|
19
|
+
valid: boolean;
|
|
20
|
+
errors: string[];
|
|
21
|
+
packet?: ArtifactPacket;
|
|
22
|
+
}
|
|
23
|
+
export interface CreateArtifactPacketOptions {
|
|
24
|
+
format?: ArtifactTransferFormat;
|
|
25
|
+
includeEvidenceSamples?: boolean;
|
|
26
|
+
maxEvidenceRecords?: number;
|
|
27
|
+
maxClaims?: number;
|
|
28
|
+
}
|
|
29
|
+
export declare function createArtifactPacket(contract: ArtifactContract, options?: CreateArtifactPacketOptions): ArtifactPacket;
|
|
30
|
+
export declare function validateArtifactPacket(value: unknown): ArtifactPacketValidation;
|
|
31
|
+
export { diffArtifactContracts, type ArtifactContractChange } from "./artifactContractDiff";
|
|
32
|
+
export interface CompactInheritancePacket {
|
|
33
|
+
artifact: ArtifactContract["artifact"];
|
|
34
|
+
purpose: ArtifactContract["purpose"];
|
|
35
|
+
claims: Claim[];
|
|
36
|
+
evidence: EvidenceRef[];
|
|
37
|
+
time?: TemporalContext;
|
|
38
|
+
corrections?: CorrectionRecord[];
|
|
39
|
+
accountability?: ArtifactContract["accountability"];
|
|
40
|
+
inheritance?: ArtifactContract["inheritance"];
|
|
41
|
+
fieldStatus?: ArtifactContract["fieldStatus"];
|
|
42
|
+
omittedPaths: string[];
|
|
43
|
+
}
|
|
44
|
+
export declare function compactInheritancePacket(contract: ArtifactContract, options?: {
|
|
45
|
+
maxClaims?: number;
|
|
46
|
+
maxEvidence?: number;
|
|
47
|
+
}): CompactInheritancePacket;
|
|
48
|
+
export declare function artifactContractScriptTag(packet: ArtifactPacket): string;
|