@disclosureos/schema 1.0.0 → 2.0.0-beta.0

package/CHANGELOG.md

@@ -1,14 +1,101 @@
 # Changelog
 
+## 2.0.0-beta.0
+
+### Major Changes
+
+- Prepare the coordinated v2 beta package set. This prerelease packages the merged
+  experimental observation and claim contracts, acquisition and dataset exchange,
+  versioned evaluation, and bounded migration tooling for external consumer testing.
+  Existing root APIs and schema identities remain available; the new contracts keep
+  explicit `/experimental/v2` imports. Observables and origins retain their existing
+  catalogs within the pinned beta dependency graph. This is not a stable v2 release,
+  scientific certification, or publication of partner data. See
+  `docs/releases/2.0.0-beta.0.md` for package-specific scope and validation boundaries.
+
+### Patch Changes
+
+- Updated dependencies
+  - @disclosureos/records@2.0.0-beta.0
+  - @disclosureos/observables@2.0.0-beta.0
+  - @disclosureos/origins@2.0.0-beta.0
+  - @disclosureos/instruments@2.0.0-beta.0
+
 All notable changes to `@disclosureos/schema` are documented here. The format is
 based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and this project
 adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## Unreleased experimental work
+
+- Add a bounded compatibility inventory and explicit, artifact-pinned sensor revision review without automatic measurement conversion.
+
+- Add explicit standalone legacy score preservation plans and adapters, retaining historical versions and values separately from v2 evaluations.
+
+- Add exact-ledger-pinned revision resolution plans with explicit select/defer decisions, preserved competing revisions and complete non-destructive planning reports.
+
+- Add pinned migration review plans for explicit time/position mappings, preserved reviewer declarations and shared v2 validation. Reviewed candidates remain separate from imports and legacy evaluations.
+
+- Add explicit profile-preparation plans and private bundle assembly from exact existing inputs, retaining profile failures and missingness without inventing source metadata.
+
+- Add fixed provenance-profile evaluation receipts over exact history, selection, asset and dependency pins, with bounded local replay and independent payload-integrity checks. Failed and unchecked profile outcomes remain distinct from replay success.
+
+- Add experimental collected-specimen provenance checks, explicit custody gaps, versioned selection schema and synthetic record fixture. Record hashes do not authenticate specimens, custody, composition or origin.
+
+- Add experimental historical-testimony provenance checks, versioned selection schema, speaker/extractor traceability and non-blocking citation recommendations. Speaker identity, account accuracy and witness independence remain unchecked.
+
+- Add selected released-document provenance with explicit release gaps, required byte/extraction checks and non-blocking citation recommendations. Assessment support and scientific eligibility remain unchecked.
+
+- Add a fixed research-evaluation workflow with versioned input schema, exact-byte dependency pins and digest-bound computed-result receipts; failures remain failures and supplied implementation/environment execution remains unattested.
+
+- Add opt-in research-completion guidance with required phase statuses, preserved early exits, and distinct missing versus rejected reviews and corrupt report bytes.
+
+- Add opt-in documentation-completion checklists with explicit applicability, blocked prerequisites and actionable diagnostics, delegating to the unchanged documentary profile.
+
+- Add experimental source intake with exact-byte local receipts, explicit unknown context and actionable gaps; CLI create, inspect and validate require no fabricated measurements or reviews.
+
+- Add experimental dataset/session composition for pinned reproduction packets, with explicit membership, context conflict checks, and local dataset inspection/validation.
+
+- Add exact-byte reproduction packets and independent TypeScript/Python synthetic control runners. Packet verification does not execute bundled code or certify scientific eligibility.
+
+- Add the opt-in instrument research prerequisites profile, with purpose-specific calibration-use reviews, explicitly interpreted timing intervals, local report verification, and composed documentary and acquisition checks. Scientific eligibility remains unchecked.
+
+- Add the opt-in v2 measurement bindings contract and single-channel capture profile, with local acquisition artifact verification. Existing contracts and package versions remain unchanged; scientific eligibility is not established by this profile.
+
+## 1.1.0
+
+### Minor Changes
+
+- e6ff99c: Add the instruments layer: the UAP Sensor Manifest standard
+  (`@disclosureos/instruments@1.0.0`, first published alongside this release —
+  see its own changelog).
+
+  - **`@disclosureos/records`** — `SensorReading` gains optional `sensorRef`
+    (`"<org-slug>:<sensor-id>"`, with `sensorRef`/`isSensorRef`/`parseSensorRef`
+    helpers in `records/shared`); `SensorType` gains 18 instrument classes
+    (infrasonic/ultrasonic sensors, ADS-B receiver, RF spectrum analyzer, passive
+    radar, particle detector, atomic clock, GNSS receiver, fluxgate magnetometer,
+    air-quality sensor, barometer, lightning detector, IMU, EEG, GSR, pulse
+    oximeter, pupillometer, hardware RNG); `DetectionMethod` gains 7 methods
+    (particle, gnss, time_reference, chemical, inertial, physiological, pressure).
+    Records schema artifact bumped to `1.1.0`.
+  - **`@disclosureos/schema`** — composed enriched-observation artifact re-emitted
+    at `1.1.0` to carry the records changes.
+  - **`@disclosureos/cli`** — new `disclosureos manifest validate <path...>`
+    command (`--recursive`, `--json`) delegating to `validateSensorManifest`.
+
+### Patch Changes
+
+- Updated dependencies [e6ff99c]
+  - @disclosureos/records@1.1.0
+  - @disclosureos/observables@1.0.1
+  - @disclosureos/origins@1.0.1
+
 ## 1.0.0
 
 Initial public release — the portable contract.
 
 ### Added
+
 - `composeObservationSchema()` — merges the records core and every registered slot
   schema into one enriched `Observation` JSON Schema, tightening the root to
   `additionalProperties: false` while preserving the `extensions` bag.

package/README.md

@@ -9,7 +9,7 @@ The **portable contract** for DisclosureOS. It composes the slot-bearing package
 (the `origin` slot) — into one **enriched `Observation`** that means the same thing
 in TypeScript, JSON Schema, and any other language.
 
-DisclosureOS is a **five-part standard** (records → observables → origins → claims → scoring).
+DisclosureOS is a **six-part standard** (records → observables → origins → claims → scoring → instruments).
 `schema` is the contract that *binds* records and the package-owned slots into one
 portable artifact. It is a supporting package, not another part of the standard. (Scoring
 consumes the enriched record, so it is not part of the composed schema.)
@@ -95,3 +95,95 @@ DisclosureOS-specific adapter.
 ## License
 
 MIT © [Disclosure Foundation](https://disclosure.org)
+
+## Experimental v2 documentary support
+
+`@disclosureos/schema/experimental/v2` exports `evaluateAssessmentDocumentation` for records-owned claim histories. See the [profile contract and runnable synthetic example](../../docs/experimental/assessment-documentation.md). It checks declared support and supplied byte hashes, not scientific adequacy; existing v1 APIs and artifacts remain unchanged.
+
+`evaluateAcquisitionBindings` additionally checks explicit raw-product/source mappings to instrument acquisition context and verifies supplied artifact hashes and lengths. See the [binding contract and local example](../../docs/experimental/acquisition-bindings.md). This is independent of assessment-documentation eligibility and does not authenticate physical instruments.
+
+The experimental v2 entry point also exports `evaluateMeasurementBindings` and
+`MeasurementBindingsSchema`. The single-channel profile links measurements to
+acquisition-bound raw products, captured channels, and explicit nominal capture
+times, then runs local acquisition artifact checks. It does not verify clock
+uncertainty, artifact contents, or scientific eligibility. See the
+[measurement bindings guide](../../docs/experimental/measurement-bindings.md).
+
+`evaluateInstrumentResearchPrerequisites` composes the experimental documentary
+and measurement profiles with declared calibration-use and timing reviews. Passing
+means reviewed input documentation is present and consistent, not scientific
+eligibility. See the [research prerequisites guide](../../docs/experimental/research-prerequisites.md).
+
+`evaluateReproductionPacket` verifies exact-byte input inventories before composing
+research prerequisites. It never executes bundled methods. See the
+[reproduction packet guide](../../docs/experimental/reproduction-packet.md) for the
+fixed TypeScript/Python synthetic control and the independent consumer's limits.
+
+`evaluateDatasetRelease` groups pinned reproduction packets into explicit sessions,
+checking membership, context identity, and nominal temporal containment. This first
+profile requires member packet prerequisites and does not authorize publication.
+See the [dataset release guide](../../docs/experimental/dataset-release.md).
+
+`evaluateSourceIntake` and `SourceIntakeSchema` accept unassessed source-file
+receipts with explicit unknown context. Identity validation does not establish
+research eligibility. See the [source intake guide](../../docs/experimental/source-intake.md).
+
+`evaluateDocumentationCompletion` explains the existing documentary profile with
+per-assessment applicability, requirement status, blocked prerequisites and next
+actions. It preserves validator diagnostics and computes no aggregate score.
+See the [documentation completion guide](../../docs/experimental/documentation-completion.md).
+
+The opt-in `evaluateInstrumentResearchCompletion` adds six required phase statuses and source-based next actions while preserving the research validator result. See the [research completion guide](../../docs/experimental/research-completion.md).
+
+The experimental `evaluateResearchEvaluation` pins local packet/dependency bytes and hashes its computed research results. See [evaluation provenance](../../docs/experimental/evaluation-provenance.md) for unsigned receipt semantics and execution limits.
+
+The experimental [released-document provenance profile](../../docs/experimental/released-documents.md) checks selected documentary sources and direct extractions with required and recommended groups, without imposing sensor requirements.
+
+Experimental [historical-testimony provenance](../../docs/experimental/historical-testimony.md) checks selected account bytes, recording citations and direct extraction attribution without assigning credibility or requiring sensor data.
+
+Experimental [physical-sample provenance](../../docs/experimental/physical-samples.md) checks collected-specimen declarations, custody continuity and cited record bytes without certifying material identity, composition or origin.
+
+Experimental [provenance-profile receipts and replay](../../docs/experimental/profile-evaluation.md) pin inputs and reproduce the full released-document, testimony or collected-specimen result, including failed and unchecked outcomes.
+
+Experimental [profile preparation](../../docs/experimental/profile-preparation.md) assembles exact existing inputs into a new private evaluation bundle, calculates byte pins and preserves failing or unchecked profile outcomes.
+
+### Experimental migration review plans
+
+`MigrationReviewSchema`, `MigrationReview` and `migrationReviewJsonSchema` are available
+from `/experimental/v2`. The schema validates the review plan structure, source pin
+and attribution; the CLI additionally validates target values and references through
+the v2 claim-history parser. See the
+[review checkpoint](../../docs/experimental/migration-review.md).
+
+### Experimental migration resolution plans
+
+`MigrationResolutionSchema`, `MigrationResolution` and `migrationResolutionJsonSchema`
+are available from `/experimental/v2`. The schema validates plan structure; the CLI
+checks exact ledger pins and identity/revision membership before reporting selections.
+See the [resolution contract](../../docs/experimental/migration-resolution.md).
+
+### Historical score preservation plans (experimental)
+
+`MigrationLegacyScoresSchema`, `MigrationLegacyScores` and
+`migrationLegacyScoresJsonSchema` describe pinned standalone score inputs and declared
+legacy observation associations. JSON Schema is available at
+`@disclosureos/schema/experimental/v2/migration-legacy-scores/schema` and its `/0.1.0`
+alias. Plan validation does not verify historical calculations or observation links.
+See the [historical score adapter](../../docs/experimental/migration-legacy-scores.md).
+
+### Migration field dispositions and sensor revision review
+
+`migrate compatibility legacy.json [sensor-review.json] --id namespace --json`
+inventories mapped, retained-without-conversion and unresolved fields. Optional explicit
+review pins an acquisition's manifest and supplied provenance without inferring
+calibration or converting measurements. The review plan is exposed as
+`MigrationCompatibilitySchema`, `MigrationCompatibility` and
+`migrationCompatibilityJsonSchema` from `@disclosureos/schema/experimental/v2`.
+See the [compatibility inventory contract](../../docs/experimental/migration-compatibility.md).
+
+## Experimental v2 migration and compatibility
+
+Start with the [developer compatibility guide](../../docs/experimental/migration-guide.md)
+for breaking changes, parser/version boundaries, supported migration workflows,
+exit handling, profile differences and non-destructive local rollback. This is an
+experimental checkout workflow; merging package changes does not deploy the Index.