@disclosureos/records 1.0.0 → 2.0.0-beta.0

package/CHANGELOG.md

@@ -1,14 +1,50 @@
 # 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.
+
 All notable changes to `@disclosureos/records` 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).
 
+## 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`.
+
 ## 1.0.0
 
 Initial public release — the core of the DisclosureOS standard.
 
 ### Added
+
 - `Observation` — the primary record type — with `ObservationSchema` (Zod 4) and the
   non-stripping `validateObservation` validator.
 - `@disclosureos/records/shared`: the cross-package substrate (`Confidence`,

package/README.md

@@ -6,7 +6,7 @@ Structured vocabulary for describing UAP observations — the **data dictionary*
 the [DisclosureOS](https://github.com/disclosurefoundation) ecosystem. Its primary
 type, `Observation`, is the core unit every other package builds on.
 
-DisclosureOS is a **five-part standard**. Each part answers one question about an
+DisclosureOS is a **six-part standard**. Each part answers one question about an
 observation; `@disclosureos/schema` binds the package-owned pieces into one portable
 contract (a single TS type + JSON Schema + non-stripping parse).
 
@@ -17,6 +17,7 @@ contract (a single TS type + JSON Schema + non-stripping parse).
 | **Origins** | `@disclosureos/origins` | *What might explain it?* |
 | **Claims** | `@disclosureos/records/shared` | *Who assessed it, why, and on what evidence?* |
 | **Scoring** | `@disclosureos/scoring` | *How complete / compelling is the case?* |
+| **Instruments** | `@disclosureos/instruments` | *What hardware produced the data?* |
 
 Supporting packages: **`@disclosureos/schema`** (the portable contract that composes the
 package-owned pieces), **`@disclosureos/cli`** (tooling), and
@@ -119,3 +120,12 @@ adapter.
 ## License
 
 MIT © [Disclosure Foundation](https://disclosure.org)
+
+## Experimental v2 value primitives
+
+The source tree includes an isolated `@disclosureos/records/experimental/v2` entry point for explicit missingness, typed time/position values, and source-value provenance. It is under development for v2 and is not available in the published package yet. Existing v1 entry points and schemas remain unchanged. See the [scope, examples, and limitations](https://github.com/disclosurefoundation/disclosureos/blob/main/docs/experimental/records-v2-primitives.md).
+
+
+The same experimental entry point now exposes `ExperimentalObservationSchema` and `parseExperimentalObservation` for the integrated factual record, including uncertainty, frames, source selections, and processing lineage. See the [Observation contract and synthetic example](https://github.com/disclosurefoundation/disclosureos/blob/main/docs/experimental/observation-contract.md). External verification and research profiles remain explicitly unchecked.
+
+Experimental source statements, attributed assessments, and revision history are documented in [Claim history](../../docs/experimental/claim-history.md). This additive contract remains separate from v1 and does not certify scientific support.

package/dist/constants/index.d.ts

@@ -15,8 +15,8 @@ declare const MANEUVER_TYPES: ("other" | "hover" | "instant_acceleration" | "ins
 declare const RELATION_KINDS: ("corroborates" | "contradicts" | "duplicate_of" | "same_object" | "supersedes" | "superseded_by" | "re_analysis_of" | "part_of")[];
 declare const CONFIDENCE_LEVELS: ("high" | "moderate" | "low" | "unassessed" | "very_high" | "very_low")[];
 declare const WITNESS_CATEGORIES: ("unknown" | "military_other" | "military_pilot" | "military_aircrew" | "military_ground" | "military_naval" | "military_radar_operator" | "commercial_pilot" | "commercial_aircrew" | "private_pilot" | "air_traffic_controller" | "aviation_other" | "government_official" | "elected_official" | "intelligence_officer" | "law_enforcement" | "scientist" | "astronomer" | "meteorologist" | "engineer" | "medical_professional" | "maritime" | "civilian" | "civilian_group" | "anonymous")[];
-declare const DETECTION_METHODS: ("unknown" | "other" | "radar_primary" | "radar_secondary" | "radar_doppler" | "radar_phased_array" | "infrared_flir" | "infrared_other" | "electro_optical" | "visual_camera" | "satellite_imagery" | "sonar_active" | "sonar_passive" | "electromagnetic" | "radiation_detector" | "magnetometer" | "gravimeter" | "acoustic" | "seismic" | "lidar" | "spectroscopic" | "radio_frequency" | "multiple")[];
-declare const SENSOR_TYPES: ("other" | "military_radar" | "civilian_radar" | "airborne_radar" | "shipborne_radar" | "ground_radar" | "flir" | "eo_sensor" | "satellite" | "sonar" | "electromagnetic_sensor" | "radiation_sensor" | "civilian_camera" | "security_camera" | "dashcam" | "phone_camera")[];
+declare const DETECTION_METHODS: ("unknown" | "other" | "radar_primary" | "radar_secondary" | "radar_doppler" | "radar_phased_array" | "infrared_flir" | "infrared_other" | "electro_optical" | "visual_camera" | "satellite_imagery" | "sonar_active" | "sonar_passive" | "electromagnetic" | "radiation_detector" | "magnetometer" | "gravimeter" | "acoustic" | "seismic" | "lidar" | "spectroscopic" | "radio_frequency" | "particle" | "gnss" | "time_reference" | "chemical" | "inertial" | "physiological" | "pressure" | "multiple")[];
+declare const SENSOR_TYPES: ("other" | "military_radar" | "civilian_radar" | "airborne_radar" | "shipborne_radar" | "ground_radar" | "flir" | "eo_sensor" | "satellite" | "sonar" | "electromagnetic_sensor" | "radiation_sensor" | "civilian_camera" | "security_camera" | "dashcam" | "phone_camera" | "infrasonic_sensor" | "ultrasonic_sensor" | "adsb_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")[];
 declare const EVIDENCE_TYPES: ("other" | "video" | "material_sample" | "ground_trace" | "radiation_reading" | "electromagnetic_recording" | "photographic" | "audio_recording" | "biological_sample" | "implant" | "debris" | "soil_sample" | "water_sample" | "vegetation_sample" | "impression" | "burn_mark")[];
 declare const EVIDENCE_QUALITIES: ("unknown" | "laboratory_grade" | "field_collected" | "uncontrolled" | "degraded" | "contaminated")[];
 declare const CHAIN_OF_CUSTODY_STATUSES: ("unknown" | "destroyed" | "classified" | "verified" | "partial" | "unverified" | "government_held" | "private_held" | "lost")[];

package/dist/constants/index.js

@@ -430,6 +430,13 @@ var DetectionMethodSchema = z.enum([
   "lidar",
   "spectroscopic",
   "radio_frequency",
+  "particle",
+  "gnss",
+  "time_reference",
+  "chemical",
+  "inertial",
+  "physiological",
+  "pressure",
   "multiple",
   "other",
   "unknown"
@@ -450,12 +457,33 @@ var SensorTypeSchema = z.enum([
   "security_camera",
   "dashcam",
   "phone_camera",
+  "infrasonic_sensor",
+  "ultrasonic_sensor",
+  "adsb_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",
   "other"
 ]).describe("Class of sensor that produced a reading.");
 var SensorReadingSchema = z.object({
   id: z.string().min(1).describe('Stable id, addressable by a claim `evidenceRef` ("sensor:<id>").'),
   sensorType: SensorTypeSchema,
   detectionMethod: DetectionMethodSchema,
+  sensorRef: z.string().optional().describe(
+    'Reference to a published sensor-manifest entry ("<org-slug>:<sensor-id>", e.g. "eldaeon:dionysus-passive-radar") carrying the instrument\u2019s full spec, timing, and calibration provenance.'
+  ),
   platform: z.string().optional().describe('Platform carrying the sensor (e.g. "USS Princeton", "F/A-18F").'),
   operator: z.string().optional().describe("Person or unit operating the sensor."),
   timestamp: z.string().optional().describe("When the reading was recorded (ISO timestamp)."),