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

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # 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.
+
+### 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
+
 ## 2.0.0-beta.3
 
 ### Patch Changes

package/README.md

@@ -1,36 +1,55 @@
 # @disclosureos/observables
 
+Name a characteristic that someone reports or investigates. A vocabulary term does not establish that the characteristic occurred, that it is anomalous, or what caused it.
+
+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
+
+Use `createObservableCatalog` and `readObservableTermDefinition` from the package root. Pin the catalog, immutable revision, digest and selected term with the shared vocabulary-reference contract in `@disclosureos/records/experimental/v2`. Keep the subject under review and supporting sources separate. The twelve terms cover technology-related and biological/material characteristics, with methods and limits; they are not a reproduction of the original ATIP framework.
+
+[Implementation guide](https://os.disclosure.org/v2/docs/observables) · [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/observables@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)
 
-Anomaly-detection criteria for the [DisclosureOS](https://github.com/disclosurefoundation)
-ecosystem — the **Observables** layer. It answers *"what anomalous characteristics did
-the observation show?"* across two domains:
+Descriptive characteristics for the [DisclosureOS](https://github.com/disclosurefoundation) ecosystem. An observable names something reported or investigated. The term does not establish that the characteristic occurred, that it is anomalous, or what caused it. Sources and measurements document the observation; attributed claims evaluate it.
 
-- **Technology** — the six AATIP-derived characteristics (`antigravity_lift`,
-  `instantaneous_acceleration`, `hypersonic_no_signatures`, `low_observability`,
-  `transmedium_travel`, `biological_effects`).
-- **Biologics** — six indicators for non-human biology (`molecular_complexity`,
-  `isotopic_provenance`, `non_standard_biochemistry`, `non_phylogenetic_genetics`,
-  `anomalous_morphology`, `anomalous_bio_interaction`).
+The catalog has twelve terms in two editorial groups:
 
-## The DisclosureOS model
+- **Technology-related characteristics:** apparent hover, abrupt motion, hypersonic motion and signature discrepancy, sensor detection discrepancy, apparent medium transition, and biological changes around an event.
+- **Biological and material characteristics:** molecular complexity pattern, isotope ratio departure, molecular composition difference, unresolved sequence relationship, unresolved morphological characteristics, and reported biological interaction.
 
-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).
+The category names do not establish a technological or biological origin. Each definition includes relevant observations, methods, interpretation limits and methodological references. This DisclosureOS vocabulary is not a reproduction of the original ATIP framework.
 
-| Part | Package surface | Question it answers |
-|---|---|---|
-| **Records** | `@disclosureos/records` | *What was observed?* |
-| **Observables** | `@disclosureos/observables` | *What anomalous characteristics did it show?* |
-| **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?* |
+## The DisclosureOS model
 
-Supporting packages: **`@disclosureos/schema`** (the portable contract that composes the
-package-owned pieces), **`@disclosureos/cli`** (tooling), and **`@disclosureos/examples`**
-(the runnable golden path). *(You are here: **Observables**.)*
 
 ## Built on records
 
@@ -48,16 +67,14 @@ import '@disclosureos/observables'; // `observation.observableAssessments` is no
 > validated as a whole by `@disclosureos/schema` — in a single type-checked file. Run it
 > 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).
 
 ## Install
 
 ```bash
-pnpm add @disclosureos/observables @disclosureos/records zod
+pnpm add @disclosureos/observables@2.0.0-beta.4 @disclosureos/records@2.0.0-beta.4 zod
 ```
 
-## Quick start
+## Assessments in an enriched observation
 
 ```typescript
 import { createObservableClaim } from '@disclosureos/observables';
@@ -67,7 +84,7 @@ const observation: Observation = {
   // ...records core fields...
   observableAssessments: {
     technology: {
-      antigravity_lift: [{ level: 'confirmed', confidence: 1, evaluatedBy: 'AATIP' }],
+      apparent_hover: [{ level: 'reported', evaluatedBy: 'Example reviewer', rationale: 'The account describes apparent station keeping; range and support are unresolved.' }],
     },
   },
 };
@@ -80,11 +97,33 @@ same characteristic, and disagreement is first-class rather than overwritten.
 > `validateObservableAssessments()` (this package) or `parseEnrichedObservation()` from
 > [`@disclosureos/schema`](../disclosureos-schema).
 
+## Shared V2 vocabulary references
+
+Export a complete catalog using the shared records-owned envelope:
+
+```typescript
+import { createObservableCatalog, readObservableTermDefinition } from '@disclosureos/observables';
+
+const catalog = createObservableCatalog({
+  id: 'observables-v2-baseline',
+  revision: '2026-10-13.1',
+  publishedBy: 'Disclosure Foundation',
+  publishedAt: '2026-10-13T00:00:00Z',
+});
+const definition = readObservableTermDefinition(catalog.terms[0]!);
+```
+
+Retain the serialized catalog bytes and hash them before creating a shared reference. A reference identifies the catalog, exact revision, retained bytes and term. It is separate from the subject under review and from supporting source references. See [RFC 0007](../../docs/rfcs/0007-vocabulary-references.md) for the shared contract and binding examples.
+
+Core term fields are `id`, `label`, `description`, `code` and `category`. Methodological metadata is retained in the `org.disclosureos.observables` extension. `readObservableTermDefinition()` validates that metadata using the package-owned definition schema and returns `undefined` for unrelated or malformed terms. The shared catalog parser validates generic structure and membership; it does not endorse scientific claims in a third-party extension.
+
+The support tiers in the enriched-observation map describe the available information. They are distinct from V2 claim outcomes such as `confirmed`, `absent` and `inconclusive`; there is no automatic conversion between them. Use the shared V2 reference when a definition must be reproducibly identified.
+
 ## Subpath exports
 
 | Subpath | Contents |
 |---|---|
-| `@disclosureos/observables` | `ObservableAssessmentMap`, `createObservableClaim`, `validateObservableAssessments` |
+| `@disclosureos/observables` | `ObservableAssessmentMap`, `createObservableClaim`, `validateObservableAssessments`, `createObservableCatalog`, `readObservableTermDefinition` |
 | `@disclosureos/observables/technology` · `/biologics` | Per-domain observable definitions |
 | `@disclosureos/observables/assessment` | Assessment levels + claim types |
 | `@disclosureos/observables/{labels,constants,guards,factories,formatters}` | The DX quintet |
@@ -99,3 +138,5 @@ validator or framework can consume them directly, with no DisclosureOS-specific
 ## License
 
 MIT © [Disclosure Foundation](https://disclosure.org)
+
+</details>

package/dist/assessment/index.d.ts

@@ -1,5 +1,5 @@
-export { A as AssessmentLevel, b as AssessmentLevelSchema, c as ObservableAssessment, d as ObservableAssessmentSchema, e as ObservableBase, f as ObservableBaseSchema, a as ObservableCategory, g as ObservableCategorySchema, O as ObservableClaim, h as ObservableClaimSchema, i as ObservableDefinition, j as ObservableDefinitionSchema } from '../types-gDm-dEvQ.js';
+export { A as AssessmentLevel, c as AssessmentLevelSchema, d as ObservableAssessment, e as ObservableAssessmentSchema, f as ObservableBase, g as ObservableBaseSchema, a as ObservableCategory, h as ObservableCategorySchema, O as ObservableClaim, i as ObservableClaimSchema, b as ObservableDefinition, j as ObservableDefinitionSchema } from '../types-Dx0yl1dG.js';
 export { ObservableAssessmentMap, ObservableAssessmentMapSchema } from '../constants/index.js';
 import 'zod';
-import '../types-DsfVlej0.js';
-import '../types-p_0pgxkz.js';
+import '../types-DNk7V-A1.js';
+import '../types-Dh1p5iPn.js';