DisclosureOS is an open standard for documenting, classifying, and evaluating UAP observations from the public record. It provides a shared vocabulary, portable schemas, and reference tooling for researchers, journalists, archivists, and civic technology teams working with anomalous observation records.
This repository is the package-only monorepo for the standard. The public documentation and schema host live at os.disclosure.org.
| Package | Role |
|---|---|
@disclosureos/records |
The shared observation vocabulary: what was observed, when, where, and with what supporting record. |
@disclosureos/observables |
Technology and biologics observable assessments: what anomalous characteristics were reported or confirmed. |
@disclosureos/origins |
Origin Classification System taxonomy and reference mappings. |
@disclosureos/schema |
The portable enriched Observation contract for TypeScript and JSON Schema. |
@disclosureos/scoring |
Reference completeness and compellingness scoring. |
@disclosureos/cli |
Developer tools for scaffolding, validating, scoring, and inspecting observations. |
Supporting workspaces:
@disclosureos/examplesprovides runnable examples for the full records to scoring path.@repo/typescript-configis private workspace support for package builds.
This repo contains only the open standard packages, examples, release
infrastructure, and package CI. It does not include the os.disclosure.org website
or any Disclosure Foundation dashboard applications.
pnpm install
pnpm --filter "@disclosureos/*" build
pnpm --filter "@disclosureos/*" test run
pnpm --filter "@disclosureos/*" run lint:publish
pnpm --filter @disclosureos/examples golden-pathThe canonical end-to-end example is examples/golden-path.ts.
Install only the surfaces you need:
pnpm add @disclosureos/records @disclosureos/schemaRun the CLI without installing it globally:
pnpm dlx @disclosureos/cli --helpDisclosureOS packages emit JSON Schema with stable $id URLs under
https://os.disclosure.org/schema/.... See
docs/release-process.md for the schema hosting and
release checklist.
Package releases are managed with Changesets from the workspace root:
pnpm changeset
pnpm version-packages
pnpm releaseEvery published package is gated by build, type-check, unit/schema drift tests,
publint, attw, and npm pack --dry-run through the package quality workflow.
DisclosureOS packages version independently under Semantic Versioning. Routine
patches can ship as package-level releases and tags (for example,
@disclosureos/cli@1.0.1) without a new aggregate GitHub Release. Repository
releases such as v1.0.0, v1.1.0, or v2.0.0 mark standard-level milestones
across the framework.
MIT © Disclosure Foundation