semiotic 3.9.2 → 3.10.1
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 +97 -76
- package/agent-skill/semiotic-charts/SKILL.md +13 -7
- 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 +3 -1
- package/ai/dist/mcp-server.js +68 -68
- package/ai/examples.md +68 -1
- package/ai/reference.md +105 -14
- package/ai/schema.json +6646 -18
- package/ai/surface-manifest.json +34 -6
- package/ai/system-prompt.md +2 -0
- 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-2RL2QPZJ.min.js +1 -0
- package/dist/c-2WK7YJLL.min.js +1 -0
- package/dist/c-42PLDTX7.min.js +1 -0
- package/dist/c-45CQWZZ6.min.js +1 -0
- package/dist/c-4BRHKVKV.min.js +1 -0
- package/dist/c-7242NXSG.min.js +1 -0
- package/dist/c-7DVPSB5C.min.js +1 -0
- package/dist/c-7EGHJU2F.min.js +1 -0
- package/dist/c-A7OGOFSL.min.js +1 -0
- package/dist/c-AFBSWT77.min.js +1 -0
- package/dist/c-AH5HWZWS.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-B7GW7IHJ.min.js +1 -0
- package/dist/c-BNFJMDHN.min.js +1 -0
- package/dist/c-BOHCQILI.min.js +1 -0
- package/dist/c-C3TZLTZK.min.js +1 -0
- package/dist/c-CGQAQWBV.min.js +1 -0
- package/dist/c-CPV4N35K.min.js +1 -0
- package/dist/c-D6HAAPTX.min.js +1 -0
- package/dist/c-DIPEYUOW.min.js +1 -0
- package/dist/c-E4JDJH4I.min.js +1 -0
- package/dist/c-E72OTUZU.min.js +1 -0
- package/dist/c-E7I2L7CU.min.js +1 -0
- package/dist/c-ELDWAO2V.min.js +1 -0
- package/dist/c-EUBTECGM.min.js +1 -0
- package/dist/c-EUMPMDCS.min.js +1 -0
- package/dist/c-EZZT2WAE.min.js +1 -0
- package/dist/c-FHBVFCQB.min.js +1 -0
- package/dist/c-G4HCO2IQ.min.js +1 -0
- package/dist/c-G5VIJEOK.min.js +1 -0
- package/dist/c-GHVOXAYH.min.js +1 -0
- package/dist/c-GNTXRXRN.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-HP4ZFM47.min.js +1 -0
- package/dist/c-HPOYKCCG.min.js +1 -0
- package/dist/c-HYDTS5OP.min.js +1 -0
- package/dist/c-I4QJ6YLM.min.js +1 -0
- package/dist/c-IK33LNZ6.min.js +1 -0
- package/dist/c-IK3PZHRY.min.js +1 -0
- package/dist/c-J6DVC236.min.js +1 -0
- package/dist/c-JIMJF6F6.min.js +1 -0
- package/dist/c-JUKIWTBJ.min.js +1 -0
- package/dist/c-KKPMHAZC.min.js +1 -0
- package/dist/c-L6WNDBHV.min.js +1 -0
- package/dist/c-LDEX5OFW.min.js +1 -0
- package/dist/c-LESEUVC5.min.js +1 -0
- package/dist/c-LYQMZMZQ.min.js +1 -0
- package/dist/c-MB6CV5NC.min.js +1 -0
- package/dist/c-MOKJOIPE.min.js +1 -0
- package/dist/c-MVR3RWF3.min.js +1 -0
- package/dist/c-N3FXLRNT.min.js +1 -0
- package/dist/c-N5NPTJVJ.min.js +1 -0
- package/dist/c-NHBL4J67.min.js +1 -0
- package/dist/c-ODG6TFSY.min.js +1 -0
- package/dist/c-ORLEBW72.min.js +1 -0
- package/dist/c-P65V6HLO.min.js +1 -0
- package/dist/c-PRIKOLTE.min.js +1 -0
- package/dist/c-PSKKFZNP.min.js +1 -0
- package/dist/c-PSNI6KAZ.min.js +1 -0
- package/dist/c-QA3HMQJP.min.js +1 -0
- package/dist/c-R2P4RR7Q.min.js +1 -0
- package/dist/c-RFC7UAG7.min.js +1 -0
- package/dist/c-S3AZX5PP.min.js +1 -0
- package/dist/c-SGAURYHG.min.js +1 -0
- package/dist/c-SJMWU6UX.min.js +1 -0
- package/dist/c-STIIGQOD.min.js +1 -0
- package/dist/c-T2ASIJVZ.min.js +1 -0
- package/dist/c-T2V7O2LO.min.js +1 -0
- package/dist/c-TKG2NP7G.min.js +1 -0
- package/dist/c-TX3THUTO.min.js +1 -0
- package/dist/c-TX7XJM3Z.min.js +1 -0
- package/dist/c-UC7SIU2W.min.js +1 -0
- package/dist/c-UMXSJIOV.min.js +1 -0
- package/dist/c-VJTDST2R.min.js +1 -0
- package/dist/c-VRSXMLYF.min.js +1 -0
- package/dist/c-VSLWSAN2.min.js +1 -0
- package/dist/c-VXLOLYTO.min.js +1 -0
- package/dist/c-W4ZUKSEQ.min.js +1 -0
- package/dist/c-WCBRPILW.min.js +1 -0
- package/dist/c-WGHT7OCY.min.js +1 -0
- package/dist/c-WUWXGQYA.min.js +1 -0
- package/dist/c-WWCW3APR.min.js +1 -0
- package/dist/{c-CKLIFCGN.min.js → c-XSB27XPS.min.js} +1 -1
- package/dist/c-Y6PYUMFU.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-ZIVPFTOC.min.js +1 -0
- package/dist/components/Annotation.d.ts +2 -1
- package/dist/components/ai/chartRecipeRegistry.d.ts +6 -1
- package/dist/components/ai/chartRecipes.d.ts +4 -0
- package/dist/components/ai/describePhysicsProjection.d.ts +18 -0
- package/dist/components/ai/describePhysicsSource.d.ts +13 -0
- 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/ordinal/DonutChart.d.ts +2 -0
- package/dist/components/charts/ordinal/FunnelChart.d.ts +2 -0
- package/dist/components/charts/ordinal/GroupedBarChart.d.ts +6 -0
- package/dist/components/charts/ordinal/PieChart.d.ts +2 -0
- package/dist/components/charts/ordinal/RadarChart.d.ts +2 -0
- package/dist/components/charts/ordinal/StackedBarChart.d.ts +6 -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/ProcessFlowChart.d.ts +6 -0
- package/dist/components/charts/physics/UnitPileChart.d.ts +2 -1
- 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/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/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 +4 -0
- package/dist/components/charts/realtime/RealtimeHistogram.d.ts +14 -6
- package/dist/components/charts/realtime/RealtimeLineChart.d.ts +4 -0
- package/dist/components/charts/realtime/RealtimeSwarmChart.d.ts +4 -0
- package/dist/components/charts/realtime/RealtimeWaterfallChart.d.ts +4 -0
- package/dist/components/charts/realtime/realtimeAccessors.d.ts +4 -0
- package/dist/components/charts/realtime/realtimeChartRuntime.d.ts +8 -7
- package/dist/components/charts/realtime/realtimeChartTypes.d.ts +7 -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/auditAccessibilityText.d.ts +4 -2
- package/dist/components/charts/shared/chartDataProps.d.ts +3 -0
- package/dist/components/charts/shared/chartSpecAtlasSchemas.d.ts +5 -0
- package/dist/components/charts/shared/chartSpecCore.d.ts +4 -0
- package/dist/components/charts/shared/chartSpecsAtlas.d.ts +2 -0
- package/dist/components/charts/shared/hooks.d.ts +3 -1
- package/dist/components/charts/shared/knownChartComponents.d.ts +1 -1
- 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/tooltipUtils.d.ts +1 -1
- package/dist/components/charts/shared/useChartLegend.d.ts +4 -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/MinimapChart.d.ts +7 -0
- package/dist/components/charts/xy/MultiAxisLineChart.d.ts +7 -0
- package/dist/components/charts/xy/ScatterplotMatrix.d.ts +6 -0
- package/dist/components/charts/xy/WaterfallChart.d.ts +8 -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 +16 -8
- 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 +3 -1
- 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/recipes/atlas/DependencyForestChart.d.ts +20 -0
- package/dist/components/recipes/atlas/DependencyMatrix.d.ts +7 -0
- package/dist/components/recipes/atlas/FlowCircuitChart.d.ts +20 -0
- package/dist/components/recipes/atlas/MotifBraidChart.d.ts +17 -0
- package/dist/components/recipes/atlas/atlasChartOptions.d.ts +11 -0
- package/dist/components/recipes/atlas/braid.d.ts +62 -0
- package/dist/components/recipes/atlas/capsules.d.ts +18 -0
- package/dist/components/recipes/atlas/compare.d.ts +4 -0
- package/dist/components/recipes/atlas/completeness.d.ts +2 -0
- package/dist/components/recipes/atlas/dependencyForest.d.ts +32 -0
- package/dist/components/recipes/atlas/dependencyForestChartProps.d.ts +58 -0
- package/dist/components/recipes/atlas/dependencyForestLayout.d.ts +17 -0
- package/dist/components/recipes/atlas/dependencyQueries.d.ts +20 -0
- package/dist/components/recipes/atlas/dependencyTypes.d.ts +21 -0
- package/dist/components/recipes/atlas/directedGraph.d.ts +9 -0
- package/dist/components/recipes/atlas/entityCounts.d.ts +3 -0
- package/dist/components/recipes/atlas/flowCircuit.d.ts +32 -0
- package/dist/components/recipes/atlas/flowCircuitChartProps.d.ts +72 -0
- package/dist/components/recipes/atlas/flowCircuitChrome.d.ts +18 -0
- package/dist/components/recipes/atlas/flowCircuitGeometry.d.ts +11 -0
- package/dist/components/recipes/atlas/flowCircuitLayout.d.ts +20 -0
- package/dist/components/recipes/atlas/flowCircuitSemantics.d.ts +26 -0
- package/dist/components/recipes/atlas/flowCircuitTape.d.ts +22 -0
- package/dist/components/recipes/atlas/flowCircuitTypes.d.ts +144 -0
- package/dist/components/recipes/atlas/forests.d.ts +11 -0
- package/dist/components/recipes/atlas/ids.d.ts +6 -0
- package/dist/components/recipes/atlas/index.d.ts +26 -0
- package/dist/components/recipes/atlas/ledger.d.ts +7 -0
- package/dist/components/recipes/atlas/motifBraidChartProps.d.ts +51 -0
- package/dist/components/recipes/atlas/motifBraidGeometry.d.ts +5 -0
- package/dist/components/recipes/atlas/motifBraidLayout.d.ts +11 -0
- package/dist/components/recipes/atlas/motifs.d.ts +3 -0
- package/dist/components/recipes/atlas/prefixForest.d.ts +9 -0
- package/dist/components/recipes/atlas/prepare.d.ts +14 -0
- package/dist/components/recipes/atlas/prepareAsync.d.ts +7 -0
- package/dist/components/recipes/atlas/profile.d.ts +19 -0
- package/dist/components/recipes/atlas/publish.d.ts +10 -0
- package/dist/components/recipes/atlas/queries.d.ts +34 -0
- package/dist/components/recipes/atlas/requiredPaths.d.ts +9 -0
- package/dist/components/recipes/atlas/rootedForest.d.ts +4 -0
- package/dist/components/recipes/atlas/sections.d.ts +3 -0
- package/dist/components/recipes/atlas/support.d.ts +7 -0
- package/dist/components/recipes/atlas/types.d.ts +278 -0
- package/dist/components/recipes/atlas/validate.d.ts +12 -0
- package/dist/components/recipes/firstAvailableTrack.d.ts +17 -0
- package/dist/components/recipes/intervals.d.ts +1 -1
- package/dist/components/semiotic-ai-core.d.ts +33 -22
- package/dist/components/semiotic-ai.d.ts +15 -3
- package/dist/components/semiotic-artifact-react.d.ts +10 -0
- package/dist/components/semiotic-artifact.d.ts +23 -0
- package/dist/components/semiotic-atlas-core.d.ts +20 -0
- package/dist/components/semiotic-atlas.d.ts +8 -0
- package/dist/components/semiotic-experimental.d.ts +1 -1
- package/dist/components/semiotic-physics.d.ts +4 -4
- package/dist/components/semiotic-recipes-core.d.ts +9 -0
- package/dist/components/semiotic-text.d.ts +2 -0
- package/dist/components/semiotic-utils-core.d.ts +18 -18
- package/dist/components/semiotic.d.ts +3 -3
- package/dist/components/server/renderEvidence.d.ts +12 -0
- package/dist/components/server/renderToStaticSVG.d.ts +3 -0
- package/dist/components/server/serverChartConfigs.d.ts +3 -0
- package/dist/components/server/serverChartConfigsAtlas.d.ts +4 -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 +6 -0
- package/dist/components/stream/GeoSVGOverlay.d.ts +4 -0
- package/dist/components/stream/NetworkPipelineStore.d.ts +1 -0
- package/dist/components/stream/NetworkSVGOverlay.d.ts +4 -0
- package/dist/components/stream/OrdinalSVGOverlay.d.ts +4 -0
- 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 +1 -2
- package/dist/components/stream/fontLoading.d.ts +4 -0
- package/dist/components/stream/hitTestUtils.d.ts +2 -0
- package/dist/components/stream/networkCustomLayout.d.ts +8 -0
- package/dist/components/stream/networkCustomLayoutCache.d.ts +12 -0
- package/dist/components/stream/networkPipelineConfig.d.ts +0 -7
- 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 +3 -0
- 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 +11 -0
- package/dist/components/stream/physics/usePhysicsCanvasPointer.d.ts +3 -1
- package/dist/components/stream/physics/usePhysicsSemanticNavigation.d.ts +2 -0
- package/dist/components/stream/pipelineConfig.d.ts +4 -0
- package/dist/components/stream/pipelineStoreUpdateResults.d.ts +1 -1
- 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/shallowEqual.d.ts +2 -0
- package/dist/components/stream/streamEncodingTypes.d.ts +53 -0
- package/dist/components/stream/types.d.ts +4 -53
- package/dist/components/stream/useEnsureCustomXYRenderers.d.ts +4 -2
- package/dist/components/stream/useGeoFrameHandle.d.ts +16 -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/xyDateTicks.d.ts +3 -2
- package/dist/components/stream/xyFrameAxisTypes.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/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.module.min.js +1 -1
- package/dist/semiotic-ai-artifact-policy-constants.module.min.js +2 -0
- package/dist/semiotic-ai-core.d.ts +33 -22
- 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 +15 -3
- 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-atlas-core.d.ts +20 -0
- package/dist/semiotic-atlas-core.min.js +1 -0
- package/dist/semiotic-atlas-core.module.min.js +1 -0
- package/dist/semiotic-atlas-selection.module.min.js +2 -0
- package/dist/semiotic-atlas.d.ts +8 -0
- package/dist/semiotic-atlas.min.js +2 -0
- package/dist/semiotic-atlas.module.min.js +2 -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.min.js +1 -1
- package/dist/semiotic-evidence.module.min.js +1 -1
- 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.module.min.js +1 -1
- package/dist/semiotic-physics.d.ts +4 -4
- 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 +9 -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.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 +18 -18
- 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.d.ts +3 -3
- 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 +70 -14
- 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-3SCUN5HI.min.js +0 -1
- package/dist/c-3VVKFA4M.min.js +0 -1
- package/dist/c-43TJZS3F.min.js +0 -1
- package/dist/c-4DTZPSUD.min.js +0 -1
- package/dist/c-4ES5367Y.min.js +0 -1
- package/dist/c-52TEGIUJ.min.js +0 -1
- package/dist/c-54IRWOGM.min.js +0 -1
- package/dist/c-5D2S4RMI.min.js +0 -1
- package/dist/c-5JWCTX3G.min.js +0 -1
- package/dist/c-6CMMSN6N.min.js +0 -1
- package/dist/c-6HRB2L7H.min.js +0 -1
- package/dist/c-6O5EVOPH.min.js +0 -1
- package/dist/c-7W4SV36A.min.js +0 -1
- package/dist/c-A4WRGZFX.min.js +0 -1
- package/dist/c-AG7WWVIH.min.js +0 -1
- package/dist/c-AH6J4MTN.min.js +0 -1
- package/dist/c-AKAF6JAD.min.js +0 -1
- package/dist/c-ALYR5LKK.min.js +0 -1
- package/dist/c-BBKITSXB.min.js +0 -1
- package/dist/c-BYDPC44I.min.js +0 -1
- package/dist/c-CFFIU2MW.min.js +0 -1
- package/dist/c-CGNHBHCE.min.js +0 -1
- package/dist/c-CJYSXIFV.min.js +0 -1
- package/dist/c-CZF7MV67.min.js +0 -1
- package/dist/c-D53OKBSY.min.js +0 -1
- package/dist/c-DADXPJXV.min.js +0 -1
- package/dist/c-DBQ2V7CH.min.js +0 -1
- package/dist/c-DPMVAUAW.min.js +0 -1
- package/dist/c-ECJCKLYY.min.js +0 -1
- package/dist/c-EGATGOWJ.min.js +0 -1
- package/dist/c-EGR6VYBW.min.js +0 -1
- package/dist/c-ESNR43AN.min.js +0 -1
- package/dist/c-F3LIKINL.min.js +0 -1
- package/dist/c-F5ZB5GJ6.min.js +0 -1
- package/dist/c-G36WS6LN.min.js +0 -1
- package/dist/c-G3VYMHKE.min.js +0 -1
- package/dist/c-GGISSW5E.min.js +0 -1
- package/dist/c-GR6MOEQC.min.js +0 -1
- package/dist/c-GSVCN34B.min.js +0 -1
- package/dist/c-GYOQCEFP.min.js +0 -1
- package/dist/c-H3DNMTCC.min.js +0 -1
- package/dist/c-I6J3FEZE.min.js +0 -1
- package/dist/c-IGH6MGJ5.min.js +0 -1
- package/dist/c-II2EEAJN.min.js +0 -1
- package/dist/c-IUHFPMHD.min.js +0 -1
- package/dist/c-J6M4JHRS.min.js +0 -1
- package/dist/c-JM3MGLQV.min.js +0 -1
- package/dist/c-KM3N7F7R.min.js +0 -1
- package/dist/c-LF5BZFNC.min.js +0 -1
- package/dist/c-LKBSGFQC.min.js +0 -1
- package/dist/c-MNF2S4AA.min.js +0 -1
- package/dist/c-MT3WBK7M.min.js +0 -1
- package/dist/c-NDJADPIF.min.js +0 -1
- package/dist/c-NVPQCIL5.min.js +0 -1
- package/dist/c-NY3JWV2K.min.js +0 -1
- package/dist/c-OFWJBEE5.min.js +0 -1
- package/dist/c-OYFHP5F5.min.js +0 -1
- package/dist/c-PGKQGGQ2.min.js +0 -1
- package/dist/c-PPWDL5ZI.min.js +0 -1
- package/dist/c-Q2IPZ3MU.min.js +0 -1
- package/dist/c-QKHMBE2E.min.js +0 -1
- package/dist/c-QMVM3AY6.min.js +0 -1
- package/dist/c-QSGWX53A.min.js +0 -1
- package/dist/c-RJKEKZOO.min.js +0 -1
- package/dist/c-RSVIHIQ4.min.js +0 -1
- package/dist/c-S6U5CGT5.min.js +0 -1
- package/dist/c-SFDIIU5G.min.js +0 -1
- package/dist/c-SLGMUBUL.min.js +0 -1
- package/dist/c-SRTBCRVE.min.js +0 -1
- package/dist/c-T6UAIKBH.min.js +0 -1
- package/dist/c-TMCTEVVW.min.js +0 -1
- package/dist/c-TMOSJLT3.min.js +0 -1
- package/dist/c-TZW3JGJ5.min.js +0 -1
- package/dist/c-U6ESPM7V.min.js +0 -1
- package/dist/c-UC5PTTFI.min.js +0 -1
- package/dist/c-USFMFKIH.min.js +0 -1
- package/dist/c-VGKUEZBC.min.js +0 -1
- package/dist/c-VGW3VG3I.min.js +0 -1
- package/dist/c-VN2HG5BS.min.js +0 -1
- package/dist/c-VPZDY5Q4.min.js +0 -1
- package/dist/c-VRXUB2F2.min.js +0 -1
- package/dist/c-VUBQNQJH.min.js +0 -1
- package/dist/c-VUH4PGZY.min.js +0 -1
- package/dist/c-W3CE4A4S.min.js +0 -1
- package/dist/c-X5UBGU2V.min.js +0 -1
- package/dist/c-XDRV7RKW.min.js +0 -1
- package/dist/c-YGZHURXZ.min.js +0 -1
- package/dist/c-YZVRZGX2.min.js +0 -1
- /package/dist/{c-N4G2L7ID.min.js → c-HYW2XA4Q.min.js} +0 -0
- /package/dist/{c-ENF72HU5.min.js → c-QAVFOEUY.min.js} +0 -0
- /package/dist/{c-OCI56QF2.min.js → c-V4XMSLC3.min.js} +0 -0
|
@@ -0,0 +1,271 @@
|
|
|
1
|
+
{
|
|
2
|
+
"schemaVersion": 1,
|
|
3
|
+
"generatedBy": "scripts/generate-ai-task-packets.mjs",
|
|
4
|
+
"id": "correct-published-chart",
|
|
5
|
+
"title": "Correct a chart after its source changes",
|
|
6
|
+
"summary": "Apply a source correction, replace affected claims explicitly, and preserve the context a later reader needs.",
|
|
7
|
+
"route": "/tasks/correct-published-chart",
|
|
8
|
+
"identity": {
|
|
9
|
+
"packageName": "semiotic",
|
|
10
|
+
"packageVersion": "3.10.1",
|
|
11
|
+
"channel": "source",
|
|
12
|
+
"sourceRevision": "sha256:a40ea6ec500d31f2752678bb9e4b2bf4de5e7f113682645e882cdbabdc25d54f",
|
|
13
|
+
"revisionKind": "content-digest",
|
|
14
|
+
"runtime": {
|
|
15
|
+
"digest": "sha256:a63286038ab7c071eadd7634dc7e0b57b05cc029a70fdc2fc3ce66217a1172e3",
|
|
16
|
+
"fileCount": 1135
|
|
17
|
+
},
|
|
18
|
+
"taskSources": {
|
|
19
|
+
"digest": "sha256:0a9aacd44c3750f785b385664bd873a92648e8b0ea581f0b485eb8fe1ca5037f",
|
|
20
|
+
"fileCount": 36
|
|
21
|
+
},
|
|
22
|
+
"availability": "Verified source checkout guidance; npm package, hosted site and MCP deployment identities require separate checks."
|
|
23
|
+
},
|
|
24
|
+
"job": "A source value changed. Update the chart and identify conclusions that still need review.",
|
|
25
|
+
"dataShape": "Synthetic regional totals: North 12, South 30, West 18. Correct West to 36; the new total is 78 and West becomes largest.",
|
|
26
|
+
"fit": [
|
|
27
|
+
"Use when published chart claims and source identity must remain inspectable across revisions.",
|
|
28
|
+
"Artifact sidecars are optional; ordinary chart rendering remains available without project notes."
|
|
29
|
+
],
|
|
30
|
+
"exclusions": [
|
|
31
|
+
"A matching hash does not authenticate the source or prove arbitrary prose true.",
|
|
32
|
+
"A generated revision or transfer report does not grant publication approval or record a human review."
|
|
33
|
+
],
|
|
34
|
+
"api": {
|
|
35
|
+
"name": "BarChart",
|
|
36
|
+
"category": "ordinal",
|
|
37
|
+
"importPath": "semiotic/ordinal",
|
|
38
|
+
"schemaResourceUri": "semiotic://schema/BarChart",
|
|
39
|
+
"renderable": true,
|
|
40
|
+
"requiresLiveData": false,
|
|
41
|
+
"description": "Vertical or horizontal bars for categorical comparisons.",
|
|
42
|
+
"component": "BarChart",
|
|
43
|
+
"usageMode": "static",
|
|
44
|
+
"dataRequired": true,
|
|
45
|
+
"schema": {
|
|
46
|
+
"type": "object",
|
|
47
|
+
"properties": {
|
|
48
|
+
"data": {
|
|
49
|
+
"type": "array",
|
|
50
|
+
"description": "Array of data objects"
|
|
51
|
+
},
|
|
52
|
+
"categoryAccessor": {
|
|
53
|
+
"type": "string",
|
|
54
|
+
"description": "Key for category labels",
|
|
55
|
+
"default": "category",
|
|
56
|
+
"x-semiotic-runtime-types": [
|
|
57
|
+
"string",
|
|
58
|
+
"function"
|
|
59
|
+
]
|
|
60
|
+
},
|
|
61
|
+
"valueAccessor": {
|
|
62
|
+
"type": "string",
|
|
63
|
+
"description": "Key for bar values",
|
|
64
|
+
"default": "value",
|
|
65
|
+
"x-semiotic-runtime-types": [
|
|
66
|
+
"string",
|
|
67
|
+
"function"
|
|
68
|
+
]
|
|
69
|
+
},
|
|
70
|
+
"title": {
|
|
71
|
+
"type": "string",
|
|
72
|
+
"description": "Visible chart title and the chart's accessible name."
|
|
73
|
+
},
|
|
74
|
+
"description": {
|
|
75
|
+
"type": "string",
|
|
76
|
+
"description": "Concise accessible description that overrides the chart's generated aria-label."
|
|
77
|
+
},
|
|
78
|
+
"summary": {
|
|
79
|
+
"type": "string",
|
|
80
|
+
"description": "Screen-reader-only summary of the chart's key takeaway; include keyboard interaction guidance when relevant."
|
|
81
|
+
},
|
|
82
|
+
"accessibleTable": {
|
|
83
|
+
"type": [
|
|
84
|
+
"boolean",
|
|
85
|
+
"object"
|
|
86
|
+
],
|
|
87
|
+
"description": "Expose the chart data through Semiotic's screen-reader data table. Object form `{ portalTarget: string }` relocates its interactive UI to the DOM element with that ID.",
|
|
88
|
+
"default": true,
|
|
89
|
+
"oneOf": [
|
|
90
|
+
{
|
|
91
|
+
"type": "boolean"
|
|
92
|
+
},
|
|
93
|
+
{
|
|
94
|
+
"type": "object",
|
|
95
|
+
"additionalProperties": false,
|
|
96
|
+
"required": [
|
|
97
|
+
"portalTarget"
|
|
98
|
+
],
|
|
99
|
+
"properties": {
|
|
100
|
+
"portalTarget": {
|
|
101
|
+
"type": "string",
|
|
102
|
+
"description": "ID of a DOM element outside any consumer-owned role=img wrapper. React callers may also pass an Element or a callback through the typed API."
|
|
103
|
+
}
|
|
104
|
+
}
|
|
105
|
+
}
|
|
106
|
+
]
|
|
107
|
+
},
|
|
108
|
+
"height": {
|
|
109
|
+
"type": "number",
|
|
110
|
+
"default": 400
|
|
111
|
+
},
|
|
112
|
+
"responsiveWidth": {
|
|
113
|
+
"type": "boolean"
|
|
114
|
+
}
|
|
115
|
+
},
|
|
116
|
+
"requiredForStatic": [
|
|
117
|
+
"data"
|
|
118
|
+
]
|
|
119
|
+
},
|
|
120
|
+
"schemaScope": "Selected properties copied from ai/schema.json; retrieve the component resource for the full schema. React push mode follows the included behavior contracts.",
|
|
121
|
+
"contracts": [
|
|
122
|
+
{
|
|
123
|
+
"id": "accessibility.description-props",
|
|
124
|
+
"title": "Accessible chart text uses direct chart props",
|
|
125
|
+
"summary": "High-level charts expose title for the visible name, description for a concise accessible description, summary for a screen-reader-only takeaway and interaction guidance, and accessibleTable for the data-table fallback.",
|
|
126
|
+
"action": "Put title, description, summary, and accessibleTable directly on the chart component when they appear in its schema. If a consumer-owned role=img wraps the chart, use accessibleTable: { portalTarget: \"element-id\" } and render that target outside the image. For generated L1–L3 description or a navigable chart tree, use ChartContainer with chartConfig plus describe and/or navigable; do not invent frameProps fields."
|
|
127
|
+
},
|
|
128
|
+
{
|
|
129
|
+
"id": "props.data-required-by-usage-mode",
|
|
130
|
+
"title": "Data required by usage mode",
|
|
131
|
+
"summary": "Static usage (`renderChart`, MCP previews, SSR snapshots, and copy/paste examples with immediate data) requires data in props. React push mode selects live ingestion by omitting data and mutating through a ref.",
|
|
132
|
+
"action": "Pass usageMode=\"push\" to `semiotic-ai --doctor` when validating ref-based JSX with no data prop. Keep usageMode=\"static\" or omit it for renderChart/MCP/static configs where data must be present."
|
|
133
|
+
},
|
|
134
|
+
{
|
|
135
|
+
"id": "rendering.renderchart-static-props",
|
|
136
|
+
"title": "renderChart uses static props only",
|
|
137
|
+
"summary": "MCP renderChart and semiotic/server renderChart render a single static SVG/PNG snapshot. Browser-only realtime components and future ref pushes are not renderable through that path.",
|
|
138
|
+
"action": "Use renderChart only with renderable HOC components and complete static data. For live behavior, return React code with a ref and do not promise MCP-rendered output."
|
|
139
|
+
}
|
|
140
|
+
]
|
|
141
|
+
},
|
|
142
|
+
"examples": [
|
|
143
|
+
{
|
|
144
|
+
"title": "Correction and handoff controls",
|
|
145
|
+
"environment": "React browser",
|
|
146
|
+
"path": "docs/src/pages/tasks/examples/SourceCorrectionExample.tsx",
|
|
147
|
+
"source": "import { useMemo, useState } from \"react\"\nimport { BarChart } from \"semiotic/ordinal\"\nimport {\n correctedRows,\n inspectSourceHandoff,\n originalRows,\n originalSourceArtifact,\n reviseSourceArtifact,\n sourceChartProps,\n sourceCorrectionNote,\n sourceCorrectionSidecar,\n} from \"./source-correction\"\nimport \"./source-correction.css\"\n\nfunction downloadText(filename: string, content: string, type = \"application/json\") {\n const url = URL.createObjectURL(new Blob([content], { type }))\n const link = document.createElement(\"a\")\n link.href = url\n link.download = filename\n link.click()\n setTimeout(() => URL.revokeObjectURL(url), 0)\n}\n\nexport default function SourceCorrectionExample() {\n const original = useMemo(originalSourceArtifact, [])\n const [revised, setRevised] = useState<ReturnType<typeof reviseSourceArtifact>>()\n const [message, setMessage] = useState(\"Original revision: total 60; South leads with 30 units.\")\n const [includeSidecar, setIncludeSidecar] = useState(true)\n const [includeNote, setIncludeNote] = useState(false)\n const current = revised ?? original\n const props = current.props as ReturnType<typeof sourceChartProps>\n const sidecar = useMemo(() => sourceCorrectionSidecar(current.contract), [current.contract])\n const handoff = useMemo(\n () => inspectSourceHandoff(props, includeSidecar ? JSON.parse(sidecar.content) : undefined),\n [props, includeSidecar, sidecar.content],\n )\n\n function attemptCorrection(reassess: boolean) {\n try {\n const result = reviseSourceArtifact(reassess)\n setRevised(result)\n setMessage(\n \"Correction prepared: total 78; West leads with 36 units. Two previous claims were superseded. Human editorial review remains pending.\",\n )\n } catch (error) {\n setMessage(`Correction refused: ${error instanceof Error ? error.message : String(error)}`)\n }\n }\n\n return (\n <section className=\"source-correction-example\" aria-label=\"Source correction demonstration\">\n <p>\n The source corrects West from 18 to 36 units. That changes the total and the leading region.\n Updating the bars requires reviewing both conclusions. These are synthetic teaching values.\n </p>\n <table>\n <caption>The source correction, in units</caption>\n <thead>\n <tr>\n <th scope=\"col\">Region</th>\n <th scope=\"col\">Original</th>\n <th scope=\"col\">Corrected</th>\n </tr>\n </thead>\n <tbody>\n {originalRows.map((row, index) => (\n <tr key={row.region}>\n <th scope=\"row\">{row.region}</th>\n <td>{row.total}</td>\n <td>{correctedRows[index].total}</td>\n </tr>\n ))}\n <tr>\n <th scope=\"row\">Total</th>\n <td>60</td>\n <td>78</td>\n </tr>\n </tbody>\n </table>\n <div className=\"source-correction-actions\">\n <button type=\"button\" disabled={Boolean(revised)} onClick={() => attemptCorrection(false)}>\n Try changing data only\n </button>\n <button type=\"button\" disabled={Boolean(revised)} onClick={() => attemptCorrection(true)}>\n Correct data and both claims\n </button>\n <button\n type=\"button\"\n onClick={() => {\n setRevised(undefined)\n setMessage(\"Original revision restored: total 60; South leads with 30 units.\")\n }}\n >\n Reset example\n </button>\n </div>\n <p role=\"status\" data-testid=\"source-correction-status\">\n {message}\n </p>\n <BarChart {...props} />\n <p>\n <strong>Displayed revision {current.contract.artifact.revision}.</strong> {props.summary}\n </p>\n <ul aria-label=\"Claim history\">\n {current.contract.claims.map((claim) => (\n <li key={claim.id}>\n <strong>{claim.status}</strong>: {claim.text}\n {claim.supersedes?.length ? ` Replaces ${claim.supersedes.join(\", \")}.` : \"\"}\n </li>\n ))}\n </ul>\n <p>\n Supported here means an authored claim about this fixture, with arithmetic checked in its\n tests. The contract does not prove prose true. No human editorial approval is recorded.\n {revised\n ? ` The revision evaluation is ${revised.evaluation.status}; publishable is ${String(revised.publishable)}.`\n : \"\"}\n </p>\n {revised && (\n <details>\n <summary>Inspect correction identities and open checks</summary>\n <p>\n Original data identity: <code>{original.contract.artifact.dataFingerprint}</code>\n </p>\n <p>\n Revised data identity: <code>{revised.contract.artifact.dataFingerprint}</code>\n </p>\n <ul>\n {revised.evaluation.manualChecks.map((check) => (\n <li key={check}>{check}</li>\n ))}\n </ul>\n <pre>{JSON.stringify(revised.contract.contestability?.corrections, null, 2)}</pre>\n </details>\n )}\n <details>\n <summary>Optional handoff: see what another reader receives</summary>\n <p>\n The chart configuration includes its values. The separate sidecar carries claims, evidence\n identifiers and correction history. The optional note records project context. You can\n keep the chart without either file.\n </p>\n <label>\n <input\n type=\"checkbox\"\n checked={includeSidecar}\n onChange={(event) => setIncludeSidecar(event.target.checked)}\n />{\" \"}\n Include correction sidecar\n </label>\n <label>\n <input\n type=\"checkbox\"\n checked={includeNote}\n onChange={(event) => setIncludeNote(event.target.checked)}\n />{\" \"}\n Include project maintenance note\n </label>\n <p role=\"status\" data-testid=\"source-handoff-status\">\n {handoff.message}\n </p>\n <p>\n An image alone cannot establish the source values, correction history or review status.\n </p>\n <div className=\"source-correction-actions\">\n <button\n type=\"button\"\n onClick={() =>\n downloadText(\n \"regional-totals.config.json\",\n JSON.stringify({ component: \"BarChart\", props }, null, 2),\n )\n }\n >\n Download chart configuration\n </button>\n {includeSidecar && (\n <button\n type=\"button\"\n onClick={() => downloadText(sidecar.sidecarPath, sidecar.content)}\n >\n Download correction sidecar\n </button>\n )}\n {includeNote && (\n <button\n type=\"button\"\n onClick={() =>\n downloadText(\n \"regional-totals-maintenance.md\",\n sourceCorrectionNote,\n \"text/markdown\",\n )\n }\n >\n Download maintenance note\n </button>\n )}\n </div>\n {includeNote && <pre>{sourceCorrectionNote}</pre>}\n </details>\n </section>\n )\n}\n",
|
|
148
|
+
"digest": "sha256:d24f1f54777cbb533074ce9438f9e6ec3e681c187cc76610d336a6a12d6330c7"
|
|
149
|
+
},
|
|
150
|
+
{
|
|
151
|
+
"title": "Source correction and portable context",
|
|
152
|
+
"environment": "Host authoring and transfer",
|
|
153
|
+
"path": "docs/src/pages/tasks/examples/source-correction.ts",
|
|
154
|
+
"source": "import {\n buildArtifactContract,\n createAdjacentArtifactSidecar,\n createArtifactPacket,\n evaluateArtifact,\n fingerprintValue,\n prepareArtifactRevision,\n validateArtifactPacket,\n type ArtifactContract,\n type Claim,\n type EvidenceRef,\n type PrepareArtifactRevisionOptions,\n} from \"semiotic/artifact\"\nimport type { BarChartProps } from \"semiotic/ordinal\"\n\nexport const originalRows = [\n { region: \"North\", total: 12 },\n { region: \"South\", total: 30 },\n { region: \"West\", total: 18 },\n]\n\nexport const correctedRows = [\n { region: \"North\", total: 12 },\n { region: \"South\", total: 30 },\n { region: \"West\", total: 36 },\n]\n\n// Fixed teaching-fixture times describe the example, not a verification run.\nconst originalAt = \"2026-08-01T12:00:00Z\"\nexport const correctionAt = \"2026-08-02T12:00:00Z\"\nconst reason = \"The source corrected West from 18 to 36 units.\"\n\nexport function sourceChartProps(data = originalRows) {\n const sum = data.reduce((total, row) => total + row.total, 0)\n const largest = data.reduce((winner, row) => (row.total > winner.total ? row : winner))\n return {\n data: data.map((row) => ({ ...row })),\n categoryAccessor: \"region\",\n valueAccessor: \"total\",\n title: \"Regional totals\",\n description: \"Three synthetic regional totals, measured in the same unit.\",\n summary: `${largest.region} has the largest total: ${largest.total} units. All regions total ${sum} units.`,\n accessibleTable: true,\n height: 280,\n responsiveWidth: true,\n } satisfies BarChartProps<(typeof originalRows)[number]>\n}\n\nfunction sourceEvidence(revision: \"1\" | \"2\"): EvidenceRef {\n return {\n id: `regional-source-v${revision}`,\n role: \"source-data\",\n label: `Synthetic regional totals, revision ${revision}`,\n source: { name: \"Authored teaching fixture\", version: revision },\n dataVersion: revision,\n fingerprint: fingerprintValue(revision === \"1\" ? originalRows : correctedRows).fingerprint,\n observedAt: revision === \"1\" ? originalAt : correctionAt,\n }\n}\n\nfunction claims(revision: \"1\" | \"2\"): Claim[] {\n return [\n {\n id: `regional-total-v${revision}`,\n text: revision === \"1\" ? \"The total is 60 units.\" : \"The total is 78 units.\",\n kind: \"aggregation\",\n status: \"supported\",\n evidenceIds: [`regional-source-v${revision}`],\n scope: { unit: \"units\", coverage: \"three synthetic regions\" },\n authoredBy: { kind: \"system\", name: \"Deterministic teaching fixture\" },\n review: { status: \"proposed\" },\n },\n {\n id: `regional-largest-v${revision}`,\n text:\n revision === \"1\"\n ? \"South has the largest total: 30 units.\"\n : \"West has the largest total: 36 units.\",\n kind: \"observation\",\n status: \"supported\",\n evidenceIds: [`regional-source-v${revision}`],\n scope: { unit: \"units\", coverage: \"three synthetic regions\" },\n authoredBy: { kind: \"system\", name: \"Deterministic teaching fixture\" },\n review: { status: \"proposed\" },\n },\n ]\n}\n\nexport function originalSourceArtifact() {\n const props = sourceChartProps()\n const contract = buildArtifactContract(\"BarChart\", props, {\n id: \"regional-totals\",\n revision: \"1\",\n intents: [\"comparison\"],\n purpose: { stakes: \"informational\" },\n claims: claims(\"1\"),\n evidence: [sourceEvidence(\"1\")],\n time: {\n observedAt: originalAt,\n presentation: { state: \"historical\", label: \"Original synthetic source\" },\n revision: { status: \"original\" },\n },\n reception: {\n channels: [{ channel: \"visual\" }, { channel: \"agent\" }],\n description: props.description,\n dataFallback: true,\n },\n form: {\n chartFamily: \"ordinal\",\n whyThisForm: \"Bar lengths compare totals in the same unit.\",\n },\n contestability: { sourceRequestsAllowed: true },\n accountability: {\n authors: [{ kind: \"system\", name: \"Semiotic documentation fixture\" }],\n reviews: [{ id: \"editorial-review\", status: \"pending\" }],\n },\n inheritance: { privacy: \"public\", rawDataDefault: \"exclude\" },\n fieldStatus: {\n \"accountability.reviews\": {\n status: \"manual\",\n reason: \"This teaching example records no human editorial approval.\",\n suppliedBy: \"system\",\n },\n },\n })\n return { props, contract }\n}\n\nexport function sourceCorrectionOptions(current: ArtifactContract): PrepareArtifactRevisionOptions {\n return {\n revision: \"2\",\n data: correctedRows.map((row) => ({ ...row })),\n evidence: [...current.evidence, sourceEvidence(\"2\")],\n presentation: {\n summary: sourceChartProps(correctedRows).summary,\n description: \"Corrected synthetic regional totals; West changed from 18 to 36 units.\",\n },\n time: {\n observedAt: correctionAt,\n presentation: { state: \"historical\", label: \"Corrected synthetic source\" },\n revision: { status: \"corrected\", reason, correctionId: \"regional-total-correction\" },\n },\n claimTransitions: claims(\"2\").map((replacement, index) => ({\n action: \"supersede\",\n previousClaimId: claims(\"1\")[index].id,\n replacement,\n correction: {\n id: index === 0 ? \"regional-total-correction\" : \"regional-largest-correction\",\n reason,\n createdAt: correctionAt,\n createdBy: { kind: \"system\", name: \"Deterministic teaching fixture\" },\n },\n })),\n policy: \"exploratory\",\n now: correctionAt,\n recommendRepresentation: false,\n groundingChannels: [\"agent\"],\n }\n}\n\nexport function reviseSourceArtifact(reassessClaims = true) {\n const original = originalSourceArtifact()\n const options = sourceCorrectionOptions(original.contract)\n return prepareArtifactRevision(\"BarChart\", original.props, original.contract, {\n ...options,\n claimTransitions: reassessClaims ? options.claimTransitions : [],\n })\n}\n\nexport function sourceCorrectionSidecar(contract: ArtifactContract) {\n return createAdjacentArtifactSidecar(\n createArtifactPacket(contract, {\n format: \"static-package\",\n includeEvidenceSamples: false,\n }),\n \"regional-totals\",\n )\n}\n\nexport const sourceCorrectionNote = `Regional totals: maintenance context\n\nPurpose: compare three synthetic totals in the same unit.\nComponent: BarChart from semiotic/ordinal.\nChoice rationale: React charting with exact values and explicit correction history.\nConstraint: preserve the project's dependency policy; changed requirements may justify another library.\nVersion: inspect the installed package and lockfile before editing.\nVerification: this optional note stores no execution result or human approval.\nRecheck: category/value mapping, arithmetic, summary, claim transitions and accessible route.\nLimits: a matching fingerprint does not authenticate the source or prove arbitrary prose.\nFiles: retain chart configuration/data separately from the artifact-contract sidecar.\nDocumentation: /tasks/correct-published-chart (check its build identity against your installation).\n`\n\n/** A missing sidecar carries no evidence of source identity or prior review. */\nexport function inspectSourceHandoff(props: ReturnType<typeof sourceChartProps>, packet?: unknown) {\n if (packet === undefined) {\n return {\n status: \"unavailable\" as const,\n message:\n \"Correction context unavailable. Chart values remain available, but source identity, previous claims and review history were not transferred.\",\n }\n }\n const validation = validateArtifactPacket(packet)\n if (!validation.valid || !validation.packet) {\n return {\n status: \"refused\" as const,\n message: `Sidecar refused: ${validation.errors.join(\"; \")}`,\n }\n }\n const contract = validation.packet.contract\n const evaluation = evaluateArtifact(\"BarChart\", props, contract, {\n policy: \"exploratory\",\n now: correctionAt,\n recommendRepresentation: false,\n })\n if (\n evaluation.obligations.some(({ id, status }) => id.startsWith(\"identity.\") && status !== \"pass\")\n ) {\n return {\n status: \"refused\" as const,\n message:\n \"Sidecar refused: its identity does not establish a match with this chart configuration and data.\",\n }\n }\n return {\n status: \"available\" as const,\n message: `Revision ${contract.artifact.revision} correction context matches this chart. Human editorial approval remains unrecorded.`,\n contract,\n }\n}\n",
|
|
155
|
+
"digest": "sha256:9e752f3abdc425222816dc8ae824f2c11e17da84f0bf67e3a254cc851bee9443"
|
|
156
|
+
},
|
|
157
|
+
{
|
|
158
|
+
"title": "Example styles",
|
|
159
|
+
"environment": "Browser presentation",
|
|
160
|
+
"path": "docs/src/pages/tasks/examples/source-correction.css",
|
|
161
|
+
"source": ".source-correction-example {\n min-width: 0;\n}\n\n.source-correction-example table {\n border-collapse: collapse;\n margin-block: 1rem;\n width: 100%;\n}\n\n.source-correction-example th,\n.source-correction-example td {\n border-bottom: 1px solid var(--border-color, #ccc);\n padding: 0.5rem;\n text-align: left;\n}\n\n.source-correction-actions {\n display: flex;\n flex-wrap: wrap;\n gap: 0.5rem;\n margin-block: 1rem;\n}\n\n.source-correction-actions button {\n font: inherit;\n padding: 0.45rem 0.7rem;\n}\n\n.source-correction-example label {\n display: block;\n margin-block: 0.6rem;\n}\n\n.source-correction-example pre {\n white-space: pre-wrap;\n overflow-wrap: anywhere;\n}\n\n.source-correction-example code {\n overflow-wrap: anywhere;\n}\n",
|
|
162
|
+
"digest": "sha256:d900ca47c8923bb35ae01ac4a22979259203fab8af0fd4d8b831a48beb1eae34"
|
|
163
|
+
}
|
|
164
|
+
],
|
|
165
|
+
"evidence": {
|
|
166
|
+
"claimId": "task.correct-published-chart",
|
|
167
|
+
"statement": "Apply a source correction, replace affected claims explicitly, and preserve the context a later reader needs.",
|
|
168
|
+
"owner": "Semiotic repository maintainers",
|
|
169
|
+
"status": "supported-in-scope",
|
|
170
|
+
"observed": {
|
|
171
|
+
"verifiedAt": "2026-09-15T00:29:02.031Z",
|
|
172
|
+
"environment": {
|
|
173
|
+
"node": "v22.22.1",
|
|
174
|
+
"platform": "darwin",
|
|
175
|
+
"architecture": "arm64",
|
|
176
|
+
"browser": "Playwright Chromium"
|
|
177
|
+
},
|
|
178
|
+
"runs": [
|
|
179
|
+
{
|
|
180
|
+
"kind": "unit",
|
|
181
|
+
"targets": [
|
|
182
|
+
"docs/src/pages/tasks/examples/category-comparison.test.ts",
|
|
183
|
+
"docs/src/pages/tasks/examples/live-chart.test.tsx",
|
|
184
|
+
"docs/src/pages/tasks/examples/source-correction.test.ts"
|
|
185
|
+
],
|
|
186
|
+
"name": "Task source units",
|
|
187
|
+
"command": "node node_modules/vitest/vitest.mjs run ./docs/src/pages/tasks/examples/category-comparison.test.ts ./docs/src/pages/tasks/examples/live-chart.test.tsx ./docs/src/pages/tasks/examples/source-correction.test.ts --reporter=default --reporter=json --outputFile=<temporary-report-directory>/unit.json --allowOnly=false",
|
|
188
|
+
"exitCode": 0,
|
|
189
|
+
"passed": 14,
|
|
190
|
+
"skipped": 0,
|
|
191
|
+
"passedByFile": {
|
|
192
|
+
"docs/src/pages/tasks/examples/category-comparison.test.ts": 4,
|
|
193
|
+
"docs/src/pages/tasks/examples/live-chart.test.tsx": 5,
|
|
194
|
+
"docs/src/pages/tasks/examples/source-correction.test.ts": 5
|
|
195
|
+
}
|
|
196
|
+
},
|
|
197
|
+
{
|
|
198
|
+
"kind": "browser",
|
|
199
|
+
"targets": [
|
|
200
|
+
"integration-tests/docs-examples-task-live.spec.ts",
|
|
201
|
+
"integration-tests/docs-examples-tasks.spec.ts"
|
|
202
|
+
],
|
|
203
|
+
"name": "Task browser behavior",
|
|
204
|
+
"command": "node node_modules/@playwright/test/cli.js test --config playwright.docs-examples.config.ts ./integration-tests/docs-examples-task-live.spec.ts ./integration-tests/docs-examples-tasks.spec.ts --reporter=list,json --forbid-only",
|
|
205
|
+
"exitCode": 0,
|
|
206
|
+
"passed": 6,
|
|
207
|
+
"skipped": 0,
|
|
208
|
+
"passedByFile": {
|
|
209
|
+
"integration-tests/docs-examples-task-live.spec.ts": 2,
|
|
210
|
+
"integration-tests/docs-examples-tasks.spec.ts": 4
|
|
211
|
+
}
|
|
212
|
+
}
|
|
213
|
+
],
|
|
214
|
+
"record": "ai/tasks/verification.json",
|
|
215
|
+
"authorship": "Agent-observed execution of repository tests; independent review is not recorded."
|
|
216
|
+
},
|
|
217
|
+
"validity": "Only the content digests and environment recorded here; not a release range or an adoption result.",
|
|
218
|
+
"invalidation": "Changes to runtime source, schemas, manifests, task examples, tests, verification tooling or this task definition invalidate the recorded result.",
|
|
219
|
+
"commands": [
|
|
220
|
+
"npx vitest run docs/src/pages/tasks/examples/source-correction.test.ts",
|
|
221
|
+
"npx playwright test --config playwright.docs-examples.config.ts integration-tests/docs-examples-tasks.spec.ts"
|
|
222
|
+
],
|
|
223
|
+
"checks": {
|
|
224
|
+
"unit": "docs/src/pages/tasks/examples/source-correction.test.ts",
|
|
225
|
+
"browser": "integration-tests/docs-examples-tasks.spec.ts"
|
|
226
|
+
},
|
|
227
|
+
"expected": [
|
|
228
|
+
"Changing data without revisiting active claims is refused.",
|
|
229
|
+
"The original total 60 and South-largest claims are superseded; replacements describe total 78 and West 36.",
|
|
230
|
+
"The original chart and evidence remain intact while corrected identities change.",
|
|
231
|
+
"Exported context retains the revision history; image-only delivery reports missing context.",
|
|
232
|
+
"Publication and human-review obligations remain visible."
|
|
233
|
+
],
|
|
234
|
+
"unassessed": [
|
|
235
|
+
"Authenticity of upstream data and the truth of arbitrary editorial statements.",
|
|
236
|
+
"Independent human review, publication policy and reader reception.",
|
|
237
|
+
"Benefits to fresh-agent maintenance: the offline study defines cases but measures no adoption outcome."
|
|
238
|
+
]
|
|
239
|
+
},
|
|
240
|
+
"recovery": [
|
|
241
|
+
{
|
|
242
|
+
"symptom": "prepareArtifactRevision refuses a changed source.",
|
|
243
|
+
"action": "Supply explicit transitions for every affected active claim. Retain prior evidence and give the correction a distinct revision and new source identity.",
|
|
244
|
+
"recheck": "Inspect superseded claims, replacement IDs, correction history and remaining manual obligations."
|
|
245
|
+
},
|
|
246
|
+
{
|
|
247
|
+
"symptom": "A recipient has the image but cannot inspect source or review context.",
|
|
248
|
+
"action": "Provide chart config/data and an optional artifact packet or adjacent sidecar. The sidecar contains the contract and transfer report, not a complete dataset.",
|
|
249
|
+
"recheck": "Check the transfer's omissions. Treat unavailable context as unknown; do not manufacture approval."
|
|
250
|
+
}
|
|
251
|
+
],
|
|
252
|
+
"continuation": {
|
|
253
|
+
"rationale": "A published regional comparison needs source and claim continuity through a correction.",
|
|
254
|
+
"recheck": [
|
|
255
|
+
"Affected arithmetic, ranking, source identity, claim transitions and review obligations after a change."
|
|
256
|
+
],
|
|
257
|
+
"loss": "Removing a project note does not break the chart. Image-only transfer loses inspectable source/review context; retain config/data separately from the artifact sidecar."
|
|
258
|
+
},
|
|
259
|
+
"update": {
|
|
260
|
+
"status": "source-only",
|
|
261
|
+
"introducedIn": null,
|
|
262
|
+
"previousAssumption": "Updating source rows or matching an identity automatically refreshes all conclusions and approves publication.",
|
|
263
|
+
"action": "Use explicit claim transitions for the changed source, preserve old evidence and inspect correction history, transfer losses and outstanding human review.",
|
|
264
|
+
"recheck": [
|
|
265
|
+
"Both total and ranking claims must change in this fixture.",
|
|
266
|
+
"A matching version string does not establish deployed parity or source authenticity."
|
|
267
|
+
],
|
|
268
|
+
"remaining": "This is current source guidance with no recorded release introduction or editorial approval."
|
|
269
|
+
},
|
|
270
|
+
"definition": "ai/tasks/correct-published-chart.json"
|
|
271
|
+
}
|