@disclosureos/schema 2.0.0-beta.3 → 2.0.0-beta.4

package/CHANGELOG.md

@@ -1,5 +1,92 @@
 # Changelog
 
+## 2.0.0-beta.4
+
+### Major Changes
+
+- Revise the V2 observable definitions and support vocabulary directly, and add shared catalog, immutable revision and term references with supplied-byte validation. Keep the chosen term separate from the subject under review and its supporting sources. Export full observable and attributed OCS origin catalogs with retained methodological context. Update enriched-observation and scoring consumers to the revised definitions. This breaks earlier beta definition and support assumptions; it does not establish an anomalous origin or turn a reported characteristic into a confirmed assessment.
+
+### Minor Changes
+
+- ebec21d: Add a versioned archival-case presentation and approved public projection preserving edition-specific pages, release/declassification declarations, selected custody links and gaps, legacy hash scope, and attributed edition review. Reuse internal snapshot capture without changing the testimony contract. No source authenticity or publication authorization is inferred from hashes.
+- 0b00be3: Add an unreleased case-claim-history contract with exact case/entity/field and
+  directed relationship subjects, scoped assertion and observation inputs, and
+  attributable revision history. Resolve supplied case and observation snapshots
+  without inferring scientific truth, a preferred reviewer or lifecycle changes.
+  Hold npm publication and version bumps for coordinated V2 completion.
+- 9580e62: Add an unreleased case-links contract for attributable context, research-entity
+  and source-intake associations. Resolve exact case/observation/document snapshots
+  and optional entity/field or inventory targets without inferring full supplement
+  conformance, raw-artifact authenticity or publication authorization.
+  Hold npm publication and version bumps for coordinated V2 completion.
+- 0b30518: Add the experimental product source selection contract, JSON Schema, byte-verified
+  evaluator and dependency-free reference reader for contiguous numerical arrays,
+  CSV row partitions and declared constant-rate video frame intervals. Preserve
+  separate calibration, scientific and media-decoding status. Publication remains
+  deferred to the coordinated V2 release.
+- 559eac9: Add an unreleased case-record contract for pinned observation scope, sourced
+  chronology and grouping, investigation reports and response declarations.
+  Check local graph cycles and supplied observation references without inferring
+  object identity, scientific corroboration, source authenticity or publication
+  permission. Hold npm publication and version bumps for coordinated V2 completion.
+- 0370447: Add a versioned context-case presentation envelope and approved public projection linking selected context fields, ambient measurements, separate products and contextual assessments. Preserve the existing case-presentation contract. The new public payload is version 0.2.0. Publication and real-data activation remain application responsibilities.
+- 5a686c1: Add unreleased laboratory analysis and result entities with explicit specimen,
+  measurement and report references, and attributable material-review claims.
+  Validate supplied entity and specimen-selection snapshots without inferring
+  scientific validity, source-report authenticity or physical custody completeness.
+  Hold npm publication and version bumps for the coordinated V2 completion release.
+- 3b75904: Add an optional static lidar point-cloud profile with reusable source reader, strict acquisition bindings, complete pulse availability and return groups, declared local coordinates, normalized intensity and attributed classifications. Include a deterministic fictional source packet, portable JSON Schema, conformance tests and documentation. No LAS decoder or physical-accuracy certification is implied.
+- c894a08: Add an explicitly approved public material and laboratory case presentation with specimen-scoped results, declared lineage and custody, attributed review inputs, and consistent public outputs. Capture referenced specimen-selection snapshots before asynchronous validation.
+- 11bf318: Add an optional single-hydrophone pressure and reproducible spectral-density profile. Public schemas, source readers and evaluation bind pressure and retention masks to exact acquisition products and derived Hann-windowed spectra, preserving unavailable samples separately from zero. The synthetic source packet demonstrates source-window selection, spectral units, complete processing lineage and numerical reproduction without claiming physical calibration or localization.
+- 0319e40: Add an unreleased case presentation contract and an explicitly approved public
+  projection for narrative, citations, selected case assessments and attachments.
+  Generate renderer data, JSON, Markdown, search and metadata from the same allowlist.
+  Application authorization, asset delivery and revocation remain integration requirements.
+  Hold package version bumps and npm publication for coordinated V2 completion.
+- 4ace4ea: Add an optional V2 rotating-radar profile over existing observation, acquisition
+  and source-selection contracts. Validate source bytes, scan/dwell semantics,
+  threshold detections, declared localization, track associations, position
+  covariance and separation from synthetic truth. Include a dependency-free reader,
+  portable JSON Schema and deterministic fixed, airborne and shipborne scanning examples.
+  Moving platforms retain one pose per dwell, declare beam reference and optional
+  slant-to-plane projection, and validate motion compensation and conditional uncertainty. Passing validation does
+  not establish physical calibration or tracking performance. Publication remains
+  deferred to the coordinated V2 release.
+
+  Add separate optional steered-radar and cooperative secondary-radar profiles,
+  public dependency-free readers, package-exported portable schemas and complete
+  reproducible examples. Steered arrays retain arbitrary beam schedules and
+  per-dwell processing availability. Secondary reports preserve Mode A codes,
+  nullable Mode C pressure altitude, invalid receptions and exact reply lineage
+  without inventing reflected power, geometric height or verified identity.
+
+  Allow retained header-only CSV layouts for legitimate empty outcomes while
+  rejecting row selection, partition and sample mappings into empty tables.
+
+  Add optional fixed-site preprocessing with independently retained reference power,
+  reproducible background means and residual arrays, and explicit detector-policy
+  exclusions that preserve the raw capture. Add source-backed local site geometry
+  and complete ground and civilian airport surface examples. Validate acquisition
+  identity, time, axes, arithmetic, detector inputs and synthetic-truth separation.
+  These declarations do not imply physical coverage or identify detected objects.
+
+- e19a897: Add an optional multispectral satellite raster profile with explicit projected pixel geometry, per-band scaling and missing values, attributed pixel quality, exact retained source selections and quality-gated NDVI. Include a dependency-free reader, strict acquisition and byte-integrity evaluation, portable schema, deterministic fictional packet and conformance tests. This does not certify physical calibration or decode GeoTIFF/COG products.
+- 6f74e57: Add an optional monostatic active-sonar envelope profile with a portable schema, dependency-free source reader, exact cell selection and a validator over existing observation, acquisition and source-layout contracts. The profile declares assumed sound speed and two-way distance conversion, preserves receive availability separately from zero amplitude, and includes a reproducible synthetic example. Validation does not certify propagation accuracy, physical calibration, bathymetry or object identity.
+- e7c3d0f: Add an explicitly approved testimony-case public projection for selected pseudonym, event quarter, recorded accounts and attributed qualification review. Keep recording dates, missing wording and unknown independence distinct. No raw research entities, private identities, source URIs or review notes enter public outputs. Existing presentation contracts remain unchanged.
+
+### Patch Changes
+
+- Updated dependencies [0b00be3]
+- Updated dependencies [9580e62]
+- Updated dependencies [559eac9]
+- Updated dependencies [5a686c1]
+- Updated dependencies [813ee2c]
+- Updated dependencies
+  - @disclosureos/records@2.0.0-beta.4
+  - @disclosureos/observables@2.0.0-beta.4
+  - @disclosureos/origins@2.0.0-beta.4
+  - @disclosureos/instruments@2.0.0-beta.4
+
 ## 2.0.0-beta.3
 
 ### Minor Changes

package/README.md

@@ -1,5 +1,42 @@
 # @disclosureos/schema
 
+Connect supplied documents, inspect exact source selections and validate specialized instrument products. Use portable JSON Schemas and evaluators with explicit limits.
+
+This README describes the **2.0.0-beta.4** API. Use one exact package version
+throughout an application. Check [availability](https://os.disclosure.org/v2/docs/installation)
+before installing; a source branch or packed candidate is not proof of npm
+publication. For a candidate that is not yet published, use the verified local
+tarballs. See the [release notes](https://github.com/disclosurefoundation/disclosureos/blob/codex/beta4-release-closure/docs/releases/2.0.0-beta.4.md)
+for scope and verification. Avoid unversioned installs, which can select a different
+API generation through `latest`.
+
+## V2 entry point
+
+Start with `@disclosureos/schema/experimental/v2`. It includes acquisition and measurement bindings, research evaluation, case projections, product-source selection, vocabulary bindings and radar, sonar, lidar and satellite profiles. JSON Schema exports identify their own document versions. The root `parseEnrichedObservation` API is the earlier composition format.
+
+[Implementation guide](https://os.disclosure.org/v2/docs/worked-example) · [Availability](https://os.disclosure.org/v2/docs/installation) · [Example viewer](https://os.disclosure.org/showcase)
+
+## Choose a package version
+
+Once this version is available in the registry, install it explicitly:
+
+```sh
+npm install --save-exact @disclosureos/schema@2.0.0-beta.4
+```
+
+Use the same exact release for all DisclosureOS packages. Before publication,
+review a verified source checkout or its locally packed artifacts. Packages are
+ESM; Node.js 22 is the documented getting-started runtime.
+
+## Additional API reference
+
+<details>
+<summary>Earlier composition APIs and detailed source-workflow reference</summary>
+
+The following reference retains earlier APIs and source checkpoints. It is not the
+V2 first-record tutorial. Installation commands here describe the candidate API
+set; use the availability guidance above until that version is published.
+
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
 
 The **portable contract** for DisclosureOS. It composes the slot-bearing packages —
@@ -9,10 +46,6 @@ 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 **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.)
 
 > ESM-only. CommonJS consumers can load it with a dynamic `import()`.
 
@@ -41,12 +74,12 @@ that gap with three things:
 > with `pnpm --filter @disclosureos/examples golden-path`.
 >
 > **Migrating an existing dataset?** See [`examples/migration-path.ts`](../../examples/migration-path.ts)
-> and the [onboarding workspace](https://os.disclosure.org/onboard).
+> and the [onboarding workspace](https://os.disclosure.org/v2/inspect).
 
 ## Install
 
 ```bash
-pnpm add @disclosureos/schema @disclosureos/records @disclosureos/observables @disclosureos/origins zod
+pnpm add @disclosureos/schema@2.0.0-beta.4 @disclosureos/records@2.0.0-beta.4 @disclosureos/observables@2.0.0-beta.4 @disclosureos/origins@2.0.0-beta.4 zod
 ```
 
 ## Quickstart
@@ -61,7 +94,7 @@ const observation: EnrichedObservation = {
   status: 'published',
   createdAt: '2020-01-01T00:00:00Z',
   updatedAt: '2020-01-01T00:00:00Z',
-  observableAssessments: { technology: { antigravity_lift: [{ level: 'confirmed', confidence: 1 }] } },
+  observableAssessments: { technology: { apparent_hover: [{ level: 'confirmed', confidence: 1 }] } },
   origin: [{ primaryHypothesis: '1.1.3', confidence: 0.9 }],
 };
 
@@ -98,6 +131,18 @@ MIT © [Disclosure Foundation](https://disclosure.org)
 
 ## Experimental v2 documentary support
 
+### Rotating radar products
+
+The optional [rotating radar profile](docs/radar-profile.md) gives retained scans,
+detections and estimated tracks shared semantics over the existing observation,
+acquisition-context and product-source-selection contracts. It verifies source
+bytes, dwell timing, detection localization, associations, covariance and declared
+processing lineage. The [scanning example](../../examples/radar-scanning) supplies
+reproducible synthetic data with a separate truth oracle. Passing the profile does
+not certify scientific performance or physical calibration.
+
+### Documentary and acquisition profiles
+
 `@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.
@@ -210,3 +255,29 @@ entries. A successful supplied-document check does not authenticate source
 artifacts, complete custody or certify a scientific profile.
 See the [contract guide](../../docs/c2/archival.md) and
 [worked example](../../examples/v2/archival-editions-demo/README.md).
+# Product source selections (source candidate)
+
+The experimental V2 entry point exports `ProductSourceSelectionSchema`,
+`evaluateProductSourceSelection` and the dependency-free
+`readProductSourceSelection` reader. This additive contract binds array elements,
+CSV rows and declared video frame intervals to exact observation-product bytes.
+See [the contract and limitations](../../docs/experimental/product-source-selection.md).
+This addition has not been published to npm.
+
+### Active sonar echo envelopes
+
+The optional [sonar profile](docs/sonar-profile.md) binds retained monostatic normalized envelopes and receive masks to an acquisition, the source delay/time axes, and a declared constant assumed sound speed. Public readers preserve unavailable samples separately from measured zero; the evaluator checks source integrity and declared meaning. A passed check does not certify physical calibration, propagation accuracy, depth or object identity. The [active sonar example](../../examples/sonar-active) includes a reproducible source packet. These additions are on the V2 development branch; package publication is separate.
+
+### Passive sonar pressure and spectra
+
+The optional [passive sonar profile](docs/passive-sonar-profile.md) binds a single pressure channel and its retention mask to a reproducible, one-sided spectral-density product. Public readers expose the exact input window and selected output cell; the evaluator checks acquisition lineage, hashes, missing-window behavior and numerical reproduction. The [passive sonar example](../../examples/sonar-passive) includes its waveform, spectra, masks and executable methods. It supplies no bearing, range or identity and does not certify physical calibration. These additions are source candidates; publication is separate.
+
+### Static lidar returns and pulse availability
+
+The optional [lidar point-cloud profile](docs/lidar-profile.md) binds a local discrete-return cloud to a complete raster pulse ledger, with exact row selection, complete return groups, normalized amplitude and declared class annotations. The [lidar example](../../examples/lidar-point-cloud) retains authored terrain, roof and vegetation returns alongside no-return and unavailable cells. The evaluator verifies source integrity and declared local geometry; it does not certify calibration, classification accuracy, geographic registration or empty space. This is a source candidate, with publication held separately.
+
+### Multispectral satellite raster
+
+The optional [satellite raster profile](docs/satellite-raster-profile.md) binds a projected grid, retained optical band values and attributed pixel quality to exact source and acquisition artifacts. The reusable reader exposes scaled reflectance, pixel footprints, source byte offsets and quality-gated NDVI. The [fictional raster example](../../examples/satellite-raster) retains six bands, cloud and shadow annotations, missing pixels and numerical edge cases. Passing checks do not certify calibration, atmospheric correction, quality accuracy or geographic registration. No satellite-format decoder is implied; publication remains held separately.
+
+</details>