@disclosureos/origins 1.0.0

package/dist/index.js

@@ -0,0 +1,1231 @@
+import { z } from 'zod';
+import { ConfidenceSchema, ClaimSchema, createEnumGuard, schemaId, jsonSchemaEnvelope, validateWith } from '@disclosureos/records/shared';
+export { isConfidence } from '@disclosureos/records/shared';
+
+// src/taxonomy/types.ts
+var OriginDomainSchema = z.enum(["physical", "psychosocial", "metaphysical"]).describe("Top-level OCS origin domain.");
+var PhysicalSubdomainSchema = z.enum(["intradimensional", "extradimensional", "interdimensional"]).describe("Subdomain of the physical origin domain.");
+var PsychosocialSubdomainSchema = z.enum(["sociological", "psychological", "neurological"]).describe("Subdomain of the psychosocial origin domain.");
+var MetaphysicalSubdomainSchema = z.enum(["paranormal", "occult", "transcendental"]).describe("Subdomain of the metaphysical origin domain.");
+var OriginSubdomainSchema = z.union([PhysicalSubdomainSchema, PsychosocialSubdomainSchema, MetaphysicalSubdomainSchema]).describe("Any OCS subdomain across the three origin domains.");
+var OCSNodeSchema = z.object({
+  id: z.string().min(1).describe('Numeric dot-path identifier (e.g., "1.1.2.1").'),
+  label: z.string().min(1).describe("Human-readable name for this OCS hypothesis node."),
+  description: z.string().describe("Plain-language explanation of what this hypothesis node covers."),
+  domain: OriginDomainSchema.describe("Top-level domain this node belongs to."),
+  depth: z.number().int().min(0).describe("Tree depth: 0=domain, 1=subdomain, 2=category, 3=subcategory, 4=leaf."),
+  parentId: z.string().nullable().describe("Parent node id, or null for a domain root."),
+  children: z.array(z.string()).describe("Child node ids, referenced by id rather than nested inline."),
+  scientificallyTestable: z.boolean().describe("Whether this hypothesis can be empirically falsified."),
+  aliases: z.array(z.string()).optional().describe('Alternative names (e.g., "ETH", "CTH").')
+}).meta({ id: "OCSNode" }).describe("A node in the OCS origin-hypothesis taxonomy.");
+
+// src/taxonomy/tree.ts
+var OCS_TAXONOMY = [
+  // ============================================================
+  // DOMAIN 1.0 — PHYSICAL
+  // ============================================================
+  {
+    id: "1",
+    label: "Physical",
+    description: "Theories attributing UAP to tangible, material objects or phenomena.",
+    domain: "physical",
+    depth: 0,
+    parentId: null,
+    children: ["1.1", "1.2", "1.3"],
+    scientificallyTestable: true
+  },
+  // --- 1.1 Intradimensional ---
+  {
+    id: "1.1",
+    label: "Intradimensional",
+    description: "Manifestations from dimensions/realms within our own physical reality.",
+    domain: "physical",
+    depth: 1,
+    parentId: "1",
+    children: ["1.1.1", "1.1.2", "1.1.3"],
+    scientificallyTestable: true
+  },
+  // 1.1.1 Prosaic
+  {
+    id: "1.1.1",
+    label: "Prosaic",
+    description: "Ordinary or conventional explanations for observed phenomena.",
+    domain: "physical",
+    depth: 2,
+    parentId: "1.1",
+    children: ["1.1.1.1", "1.1.1.2"],
+    scientificallyTestable: true
+  },
+  {
+    id: "1.1.1.1",
+    label: "Natural",
+    description: "Atmospheric, celestial, or geological phenomena misidentified as anomalous.",
+    domain: "physical",
+    depth: 3,
+    parentId: "1.1.1",
+    children: ["1.1.1.1.1", "1.1.1.1.2", "1.1.1.1.3", "1.1.1.1.4"],
+    scientificallyTestable: true
+  },
+  {
+    id: "1.1.1.1.1",
+    label: "Optical Artifact / Illusion",
+    description: "Lens flares, reflections, mirages, temperature inversions, or other optical effects.",
+    domain: "physical",
+    depth: 4,
+    parentId: "1.1.1.1",
+    children: [],
+    scientificallyTestable: true
+  },
+  {
+    id: "1.1.1.1.2",
+    label: "Celestial",
+    description: "Stars, planets, meteors, satellites, or space debris misidentified.",
+    domain: "physical",
+    depth: 4,
+    parentId: "1.1.1.1",
+    children: [],
+    scientificallyTestable: true
+  },
+  {
+    id: "1.1.1.1.3",
+    label: "Meteorological",
+    description: "Ball lightning, lenticular clouds, sprites, or other atmospheric phenomena.",
+    domain: "physical",
+    depth: 4,
+    parentId: "1.1.1.1",
+    children: [],
+    scientificallyTestable: true
+  },
+  {
+    id: "1.1.1.1.4",
+    label: "Geophysical",
+    description: "Earthquake lights, piezoelectric effects, or volcanic phenomena.",
+    domain: "physical",
+    depth: 4,
+    parentId: "1.1.1.1",
+    children: [],
+    scientificallyTestable: true
+  },
+  {
+    id: "1.1.1.2",
+    label: "Human",
+    description: "Human activities or technologies misidentified as anomalous.",
+    domain: "physical",
+    depth: 3,
+    parentId: "1.1.1",
+    children: ["1.1.1.2.1", "1.1.1.2.2", "1.1.1.2.3", "1.1.1.2.4"],
+    scientificallyTestable: true
+  },
+  {
+    id: "1.1.1.2.1",
+    label: "Governmental",
+    description: "Military aircraft, drones, or test vehicles from known government programs.",
+    domain: "physical",
+    depth: 4,
+    parentId: "1.1.1.2",
+    children: [],
+    scientificallyTestable: true
+  },
+  {
+    id: "1.1.1.2.2",
+    label: "Extra-Governmental",
+    description: "Black budget programs, Special Access Programs (SAPs), or unacknowledged projects.",
+    domain: "physical",
+    depth: 4,
+    parentId: "1.1.1.2",
+    children: [],
+    scientificallyTestable: true
+  },
+  {
+    id: "1.1.1.2.3",
+    label: "Inter-governmental",
+    description: "Foreign adversary technology or multinational classified programs.",
+    domain: "physical",
+    depth: 4,
+    parentId: "1.1.1.2",
+    children: [],
+    scientificallyTestable: true
+  },
+  {
+    id: "1.1.1.2.4",
+    label: "Private / Commercial",
+    description: "Commercial drones, private aerospace ventures, or civilian technology.",
+    domain: "physical",
+    depth: 4,
+    parentId: "1.1.1.2",
+    children: [],
+    scientificallyTestable: true
+  },
+  // 1.1.2 Cryptoterrestrial
+  {
+    id: "1.1.2",
+    label: "Cryptoterrestrial",
+    description: "Hidden Earth-based civilizations or entities operating outside known history.",
+    domain: "physical",
+    depth: 2,
+    parentId: "1.1",
+    children: ["1.1.2.1", "1.1.2.2", "1.1.2.3", "1.1.2.4"],
+    scientificallyTestable: true,
+    aliases: ["CTH"]
+  },
+  {
+    id: "1.1.2.1",
+    label: "Ancient / Proto-Human Survival",
+    description: "Remnant populations of earlier hominid species or ancient civilizations that survived in isolation.",
+    domain: "physical",
+    depth: 3,
+    parentId: "1.1.2",
+    children: [],
+    scientificallyTestable: true
+  },
+  {
+    id: "1.1.2.2",
+    label: "Breakaway Civilization",
+    description: "Human splinter groups that developed advanced technology in secret.",
+    domain: "physical",
+    depth: 3,
+    parentId: "1.1.2",
+    children: [],
+    scientificallyTestable: true
+  },
+  {
+    id: "1.1.2.3",
+    label: "Cryptids / Humanoids",
+    description: "Non-human intelligent entities indigenous to Earth but outside the known tree of life.",
+    domain: "physical",
+    depth: 3,
+    parentId: "1.1.2",
+    children: [],
+    scientificallyTestable: true
+  },
+  {
+    id: "1.1.2.4",
+    label: 'Stranded "Gods"',
+    description: "Entities from ancient mythological accounts interpreted as literal stranded visitors.",
+    domain: "physical",
+    depth: 3,
+    parentId: "1.1.2",
+    children: [],
+    scientificallyTestable: true
+  },
+  // 1.1.3 Extraterrestrial
+  {
+    id: "1.1.3",
+    label: "Extraterrestrial",
+    description: "Intelligence visiting from other locations in spacetime.",
+    domain: "physical",
+    depth: 2,
+    parentId: "1.1",
+    children: ["1.1.3.1", "1.1.3.2", "1.1.3.3", "1.1.3.4"],
+    scientificallyTestable: true,
+    aliases: ["ETH"]
+  },
+  {
+    id: "1.1.3.1",
+    label: "Solar System",
+    description: "Intelligence originating from elsewhere in our solar system.",
+    domain: "physical",
+    depth: 3,
+    parentId: "1.1.3",
+    children: [],
+    scientificallyTestable: true
+  },
+  {
+    id: "1.1.3.2",
+    label: "Interstellar",
+    description: "Intelligence from other star systems within our galaxy.",
+    domain: "physical",
+    depth: 3,
+    parentId: "1.1.3",
+    children: [],
+    scientificallyTestable: true
+  },
+  {
+    id: "1.1.3.3",
+    label: "Intergalactic",
+    description: "Intelligence from other galaxies.",
+    domain: "physical",
+    depth: 3,
+    parentId: "1.1.3",
+    children: [],
+    scientificallyTestable: true
+  },
+  {
+    id: "1.1.3.4",
+    label: "Unknown Region of Space-Time",
+    description: "Intelligence from an uncharacterized region of our physical universe.",
+    domain: "physical",
+    depth: 3,
+    parentId: "1.1.3",
+    children: [],
+    scientificallyTestable: true
+  },
+  // --- 1.2 Extradimensional ---
+  {
+    id: "1.2",
+    label: "Extradimensional",
+    description: "UAPs from other dimensions, parallel universes, or realms beyond our physical reality.",
+    domain: "physical",
+    depth: 1,
+    parentId: "1",
+    children: ["1.2.1", "1.2.2"],
+    scientificallyTestable: true
+  },
+  {
+    id: "1.2.1",
+    label: "3-D Entity From Hyperspace",
+    description: "Entities projecting into our 3+1 dimensional spacetime from higher dimensions.",
+    domain: "physical",
+    depth: 2,
+    parentId: "1.2",
+    children: ["1.2.1.1", "1.2.1.2", "1.2.1.3"],
+    scientificallyTestable: true
+  },
+  {
+    id: "1.2.1.1",
+    label: "Compactified Dimensions",
+    description: "Entities from string theory / Kaluza-Klein compactified extra dimensions.",
+    domain: "physical",
+    depth: 3,
+    parentId: "1.2.1",
+    children: [],
+    scientificallyTestable: true
+  },
+  {
+    id: "1.2.1.2",
+    label: 'Hyperspace "Bulk"',
+    description: "Entities from the bulk space of Randall-Sundrum brane models.",
+    domain: "physical",
+    depth: 3,
+    parentId: "1.2.1",
+    children: [],
+    scientificallyTestable: true
+  },
+  {
+    id: "1.2.1.3",
+    label: "Disconnected Hyperspace",
+    description: "Entities from higher-dimensional spaces not connected to our brane.",
+    domain: "physical",
+    depth: 3,
+    parentId: "1.2.1",
+    children: [],
+    scientificallyTestable: true
+  },
+  {
+    id: "1.2.2",
+    label: 'Hyper-D "Brane"',
+    description: "Brane interactions from string/M-theory producing observable effects.",
+    domain: "physical",
+    depth: 2,
+    parentId: "1.2",
+    children: ["1.2.2.1", "1.2.2.2"],
+    scientificallyTestable: true
+  },
+  {
+    id: "1.2.2.1",
+    label: 'Projection / "Shadow"',
+    description: "Lower-dimensional projections of higher-dimensional objects.",
+    domain: "physical",
+    depth: 3,
+    parentId: "1.2.2",
+    children: ["1.2.2.1.1", "1.2.2.1.2", "1.2.2.1.3"],
+    scientificallyTestable: true
+  },
+  {
+    id: "1.2.2.1.1",
+    label: "0-to-2 Dimensional",
+    description: "Point or plane-like projections from higher dimensions.",
+    domain: "physical",
+    depth: 4,
+    parentId: "1.2.2.1",
+    children: [],
+    scientificallyTestable: true
+  },
+  {
+    id: "1.2.2.1.2",
+    label: "3-Dimensional",
+    description: "Full volumetric projections appearing as solid objects.",
+    domain: "physical",
+    depth: 4,
+    parentId: "1.2.2.1",
+    children: [],
+    scientificallyTestable: true
+  },
+  {
+    id: "1.2.2.1.3",
+    label: "Fractal Dimensional",
+    description: "Non-integer dimensional projections with fractal geometry.",
+    domain: "physical",
+    depth: 4,
+    parentId: "1.2.2.1",
+    children: [],
+    scientificallyTestable: true
+  },
+  {
+    id: "1.2.2.2",
+    label: '\u2264 3-D "Avatar"',
+    description: "Controlled projections or constructs operating as proxies.",
+    domain: "physical",
+    depth: 3,
+    parentId: "1.2.2",
+    children: ["1.2.2.2.1", "1.2.2.2.2", "1.2.2.2.3"],
+    scientificallyTestable: true
+  },
+  {
+    id: "1.2.2.2.1",
+    label: 'Hologram / "Telepresence"',
+    description: "Remote presence via holographic or light-based projection.",
+    domain: "physical",
+    depth: 4,
+    parentId: "1.2.2.2",
+    children: [],
+    scientificallyTestable: true
+  },
+  {
+    id: "1.2.2.2.2",
+    label: "Automaton",
+    description: "Self-operating mechanical or energetic construct.",
+    domain: "physical",
+    depth: 4,
+    parentId: "1.2.2.2",
+    children: [],
+    scientificallyTestable: true
+  },
+  {
+    id: "1.2.2.2.3",
+    label: "Artificial Lifeform",
+    description: "Engineered biological or hybrid entity operating as a proxy.",
+    domain: "physical",
+    depth: 4,
+    parentId: "1.2.2.2",
+    children: [],
+    scientificallyTestable: true
+  },
+  // --- 1.3 Interdimensional ---
+  {
+    id: "1.3",
+    label: "Interdimensional",
+    description: "UAPs traversing between different dimensions or realities.",
+    domain: "physical",
+    depth: 1,
+    parentId: "1",
+    children: ["1.3.1", "1.3.2", "1.3.3"],
+    scientificallyTestable: true
+  },
+  {
+    id: "1.3.1",
+    label: "Multiverse",
+    description: "Entities or phenomena crossing between parallel universes.",
+    domain: "physical",
+    depth: 2,
+    parentId: "1.3",
+    children: ["1.3.1.1", "1.3.1.2", "1.3.1.3", "1.3.1.4"],
+    scientificallyTestable: true
+  },
+  {
+    id: "1.3.1.1",
+    label: "Portal / Wormhole",
+    description: "Traversal via Einstein-Rosen bridges or manufactured gateways.",
+    domain: "physical",
+    depth: 3,
+    parentId: "1.3.1",
+    children: [],
+    scientificallyTestable: true
+  },
+  {
+    id: "1.3.1.2",
+    label: "Colliding Universe(s)",
+    description: "Phenomena from brane collision events (ekpyrotic cosmology).",
+    domain: "physical",
+    depth: 3,
+    parentId: "1.3.1",
+    children: [],
+    scientificallyTestable: true
+  },
+  {
+    id: "1.3.1.3",
+    label: "Parallel Universe(s)",
+    description: "Entities from parallel but non-interacting universe branches.",
+    domain: "physical",
+    depth: 3,
+    parentId: "1.3.1",
+    children: [],
+    scientificallyTestable: true
+  },
+  {
+    id: "1.3.1.4",
+    label: 'QFT "Many Worlds"',
+    description: "Quantum-mechanical many-worlds interpretation producing observable crossover.",
+    domain: "physical",
+    depth: 3,
+    parentId: "1.3.1",
+    children: [],
+    scientificallyTestable: true
+  },
+  {
+    id: "1.3.2",
+    label: "Time Travel",
+    description: "Entities or vehicles traversing temporal dimensions.",
+    domain: "physical",
+    depth: 2,
+    parentId: "1.3",
+    children: ["1.3.2.1", "1.3.2.2", "1.3.2.3", "1.3.2.4", "1.3.2.5"],
+    scientificallyTestable: true
+  },
+  {
+    id: "1.3.2.1",
+    label: "Humans From Future",
+    description: "Time-traveling humans from our future timeline.",
+    domain: "physical",
+    depth: 3,
+    parentId: "1.3.2",
+    children: [],
+    scientificallyTestable: true
+  },
+  {
+    id: "1.3.2.2",
+    label: "Humans From Past",
+    description: "Time-traveling humans from our past (advanced pre-history).",
+    domain: "physical",
+    depth: 3,
+    parentId: "1.3.2",
+    children: [],
+    scientificallyTestable: true
+  },
+  {
+    id: "1.3.2.3",
+    label: "Humans From Alternate Timeline",
+    description: "Humans from divergent timeline branches.",
+    domain: "physical",
+    depth: 3,
+    parentId: "1.3.2",
+    children: [],
+    scientificallyTestable: true
+  },
+  {
+    id: "1.3.2.4",
+    label: "Non-Human Entity",
+    description: "Non-human intelligence traversing time dimensions.",
+    domain: "physical",
+    depth: 3,
+    parentId: "1.3.2",
+    children: [],
+    scientificallyTestable: true
+  },
+  {
+    id: "1.3.2.5",
+    label: "Additional Time Dimension(s)",
+    description: "Traversal via hypothetical extra temporal dimensions beyond our single time axis.",
+    domain: "physical",
+    depth: 3,
+    parentId: "1.3.2",
+    children: [],
+    scientificallyTestable: true
+  },
+  {
+    id: "1.3.3",
+    label: "Scale Invariance",
+    description: "Phenomena emerging from scale-dependent physics or quantum-cosmological effects.",
+    domain: "physical",
+    depth: 2,
+    parentId: "1.3",
+    children: ["1.3.3.1", "1.3.3.2", "1.3.3.3", "1.3.3.4", "1.3.3.5"],
+    scientificallyTestable: true
+  },
+  {
+    id: "1.3.3.1",
+    label: "Macro Quantum Fluctuation",
+    description: "Macroscopic manifestation of quantum vacuum fluctuations.",
+    domain: "physical",
+    depth: 3,
+    parentId: "1.3.3",
+    children: [],
+    scientificallyTestable: true
+  },
+  {
+    id: "1.3.3.2",
+    label: "Distance Recursion",
+    description: "Self-similar structure at different scales producing observable anomalies.",
+    domain: "physical",
+    depth: 3,
+    parentId: "1.3.3",
+    children: [],
+    scientificallyTestable: true
+  },
+  {
+    id: "1.3.3.3",
+    label: "Pan-Galactic Entanglement",
+    description: "Non-local quantum entanglement effects at galactic scales.",
+    domain: "physical",
+    depth: 3,
+    parentId: "1.3.3",
+    children: [],
+    scientificallyTestable: true
+  },
+  {
+    id: "1.3.3.4",
+    label: 'Unobserved "Vibratory Modes"',
+    description: "Hidden vibrational modes of spacetime not yet detected by instruments.",
+    domain: "physical",
+    depth: 3,
+    parentId: "1.3.3",
+    children: [],
+    scientificallyTestable: true
+  },
+  {
+    id: "1.3.3.5",
+    label: "Conformal Cyclic Cosmology",
+    description: "Signals or entities from previous cosmic aeons (Penrose CCC).",
+    domain: "physical",
+    depth: 3,
+    parentId: "1.3.3",
+    children: [],
+    scientificallyTestable: true
+  },
+  // ============================================================
+  // DOMAIN 2.0 — PSYCHOSOCIAL
+  // ============================================================
+  {
+    id: "2",
+    label: "Psychosocial",
+    description: "Theories attributing UAP to psychological, perceptual, and sociological factors.",
+    domain: "psychosocial",
+    depth: 0,
+    parentId: null,
+    children: ["2.1", "2.2", "2.3"],
+    scientificallyTestable: true,
+    aliases: ["PSH"]
+  },
+  // --- 2.1 Sociological ---
+  {
+    id: "2.1",
+    label: "Sociological",
+    description: "Social dynamics, group phenomena, and cultural factors producing UAP reports.",
+    domain: "psychosocial",
+    depth: 1,
+    parentId: "2",
+    children: ["2.1.1", "2.1.2", "2.1.3", "2.1.4", "2.1.5"],
+    scientificallyTestable: true
+  },
+  {
+    id: "2.1.1",
+    label: "Hypnosis",
+    description: "Hypnotic suggestion producing false UAP memories or experiences.",
+    domain: "psychosocial",
+    depth: 2,
+    parentId: "2.1",
+    children: [],
+    scientificallyTestable: true
+  },
+  {
+    id: "2.1.2",
+    label: "Mass Hysteria",
+    description: "Collective delusion or social contagion producing shared UAP reports.",
+    domain: "psychosocial",
+    depth: 2,
+    parentId: "2.1",
+    children: [],
+    scientificallyTestable: true
+  },
+  {
+    id: "2.1.3",
+    label: "Memetic Virus",
+    description: "Self-propagating cultural narratives that generate UAP reports.",
+    domain: "psychosocial",
+    depth: 2,
+    parentId: "2.1",
+    children: [],
+    scientificallyTestable: true
+  },
+  {
+    id: "2.1.4",
+    label: "Conditioning / Disinformation",
+    description: "Deliberate manipulation, propaganda, or psyops creating UAP narratives.",
+    domain: "psychosocial",
+    depth: 2,
+    parentId: "2.1",
+    children: [],
+    scientificallyTestable: true
+  },
+  {
+    id: "2.1.5",
+    label: "Hoax",
+    description: "Deliberate fabrication for attention, profit, or amusement.",
+    domain: "psychosocial",
+    depth: 2,
+    parentId: "2.1",
+    children: [],
+    scientificallyTestable: true
+  },
+  // --- 2.2 Psychological ---
+  {
+    id: "2.2",
+    label: "Psychological",
+    description: "Individual psychological processes producing UAP perceptions.",
+    domain: "psychosocial",
+    depth: 1,
+    parentId: "2",
+    children: ["2.2.1", "2.2.2", "2.2.3", "2.2.4", "2.2.5"],
+    scientificallyTestable: true
+  },
+  {
+    id: "2.2.1",
+    label: "False Belief / Misinterpretation",
+    description: "Cognitive bias or perceptual error leading to misidentification.",
+    domain: "psychosocial",
+    depth: 2,
+    parentId: "2.2",
+    children: [],
+    scientificallyTestable: true
+  },
+  {
+    id: "2.2.2",
+    label: "Fallible / Screen Memory",
+    description: "False or constructed memories obscuring actual events.",
+    domain: "psychosocial",
+    depth: 2,
+    parentId: "2.2",
+    children: [],
+    scientificallyTestable: true
+  },
+  {
+    id: "2.2.3",
+    label: "Psychosomatic Disorder",
+    description: "Physical symptoms produced by psychological distress attributed to UAP.",
+    domain: "psychosocial",
+    depth: 2,
+    parentId: "2.2",
+    children: [],
+    scientificallyTestable: true
+  },
+  {
+    id: "2.2.4",
+    label: "Psychosis / Hallucination",
+    description: "Clinical psychiatric conditions producing UAP perceptions.",
+    domain: "psychosocial",
+    depth: 2,
+    parentId: "2.2",
+    children: [],
+    scientificallyTestable: true
+  },
+  {
+    id: "2.2.5",
+    label: "Collective Unconscious",
+    description: "Jungian archetypes manifesting as UAP experiences across cultures.",
+    domain: "psychosocial",
+    depth: 2,
+    parentId: "2.2",
+    children: [],
+    scientificallyTestable: true
+  },
+  // --- 2.3 Neurological ---
+  {
+    id: "2.3",
+    label: "Neurological",
+    description: "Neurobiological factors producing anomalous perceptions.",
+    domain: "psychosocial",
+    depth: 1,
+    parentId: "2",
+    children: ["2.3.1", "2.3.2", "2.3.3", "2.3.4", "2.3.5"],
+    scientificallyTestable: true
+  },
+  {
+    id: "2.3.1",
+    label: "Psychedelics / Pharmacology",
+    description: "Drug-induced altered states producing UAP-like perceptions.",
+    domain: "psychosocial",
+    depth: 2,
+    parentId: "2.3",
+    children: [],
+    scientificallyTestable: true
+  },
+  {
+    id: "2.3.2",
+    label: "Pathology / Trauma",
+    description: "Brain injury, disease, or trauma producing anomalous perceptions.",
+    domain: "psychosocial",
+    depth: 2,
+    parentId: "2.3",
+    children: [],
+    scientificallyTestable: true
+  },
+  {
+    id: "2.3.3",
+    label: "Neurodivergence",
+    description: "Atypical neural architecture producing enhanced or anomalous perception.",
+    domain: "psychosocial",
+    depth: 2,
+    parentId: "2.3",
+    children: [],
+    scientificallyTestable: true
+  },
+  {
+    id: "2.3.4",
+    label: "High Intuition / Functioning",
+    description: "Heightened perceptual sensitivity or cognitive function.",
+    domain: "psychosocial",
+    depth: 2,
+    parentId: "2.3",
+    children: [],
+    scientificallyTestable: true
+  },
+  {
+    id: "2.3.5",
+    label: '"Alien" Implants',
+    description: "Neurological effects attributed to foreign objects or stimulation.",
+    domain: "psychosocial",
+    depth: 2,
+    parentId: "2.3",
+    children: [],
+    scientificallyTestable: true
+  },
+  // ============================================================
+  // DOMAIN 3.0 — METAPHYSICAL
+  // ============================================================
+  {
+    id: "3",
+    label: "Metaphysical",
+    description: "Theories with origins beyond conventional scientific understanding.",
+    domain: "metaphysical",
+    depth: 0,
+    parentId: null,
+    children: ["3.1", "3.2", "3.3"],
+    scientificallyTestable: false,
+    aliases: ["MPH"]
+  },
+  // --- 3.1 Paranormal ---
+  {
+    id: "3.1",
+    label: "Paranormal",
+    description: "Phenomena involving extraordinary human potential or non-material entities.",
+    domain: "metaphysical",
+    depth: 1,
+    parentId: "3",
+    children: ["3.1.1", "3.1.2", "3.1.3", "3.1.4", "3.1.5", "3.1.6"],
+    scientificallyTestable: true
+  },
+  {
+    id: "3.1.1",
+    label: "Psychotronics / Extraordinary Potential",
+    description: "Latent human psychic abilities (telekinesis, remote viewing) producing observable effects.",
+    domain: "metaphysical",
+    depth: 2,
+    parentId: "3.1",
+    children: [],
+    scientificallyTestable: true
+  },
+  {
+    id: "3.1.2",
+    label: "NDE / OBE",
+    description: "Near-death or out-of-body experiences suggesting non-physical consciousness.",
+    domain: "metaphysical",
+    depth: 2,
+    parentId: "3.1",
+    children: [],
+    scientificallyTestable: true
+  },
+  {
+    id: "3.1.3",
+    label: "Disembodied Spirits / Consciousness",
+    description: "Non-physical conscious entities interacting with physical reality.",
+    domain: "metaphysical",
+    depth: 2,
+    parentId: "3.1",
+    children: [],
+    scientificallyTestable: true
+  },
+  {
+    id: "3.1.4",
+    label: "Incorporeal / Bosonic Lifeforms",
+    description: "Entities composed of force-carrier particles or non-baryonic matter.",
+    domain: "metaphysical",
+    depth: 2,
+    parentId: "3.1",
+    children: [],
+    scientificallyTestable: true
+  },
+  {
+    id: "3.1.5",
+    label: "Mediumship / Possession",
+    description: "External entities communicating through or controlling human hosts.",
+    domain: "metaphysical",
+    depth: 2,
+    parentId: "3.1",
+    children: [],
+    scientificallyTestable: true
+  },
+  {
+    id: "3.1.6",
+    label: "New Physics",
+    description: "Undiscovered physical laws that explain anomalous phenomena.",
+    domain: "metaphysical",
+    depth: 2,
+    parentId: "3.1",
+    children: [],
+    scientificallyTestable: true
+  },
+  // --- 3.2 Occult ---
+  {
+    id: "3.2",
+    label: "Occult",
+    description: "Hidden knowledge traditions and reality models outside mainstream science.",
+    domain: "metaphysical",
+    depth: 1,
+    parentId: "3",
+    children: ["3.2.1", "3.2.2", "3.2.3", "3.2.4", "3.2.5", "3.2.6"],
+    scientificallyTestable: false
+  },
+  {
+    id: "3.2.1",
+    label: "Hidden Powers of Nature",
+    description: "Esoteric natural forces not yet recognized by science.",
+    domain: "metaphysical",
+    depth: 2,
+    parentId: "3.2",
+    children: [],
+    scientificallyTestable: false
+  },
+  {
+    id: "3.2.2",
+    label: 'Ascended "Masters"',
+    description: "Spiritually evolved beings guiding humanity from higher planes.",
+    domain: "metaphysical",
+    depth: 2,
+    parentId: "3.2",
+    children: [],
+    scientificallyTestable: false
+  },
+  {
+    id: "3.2.3",
+    label: '"Maya" / Sensory Delusion',
+    description: "Physical reality as fundamental illusion (Vedantic/Buddhist ontology).",
+    domain: "metaphysical",
+    depth: 2,
+    parentId: "3.2",
+    children: [],
+    scientificallyTestable: false
+  },
+  {
+    id: "3.2.4",
+    label: "Artificial Reality / Matrix Simulation",
+    description: "Reality as a computational simulation with UAP as glitches or features.",
+    domain: "metaphysical",
+    depth: 2,
+    parentId: "3.2",
+    children: [],
+    scientificallyTestable: true
+  },
+  {
+    id: "3.2.5",
+    label: "Altered / Alternate Reality",
+    description: "Consensus reality as one of many equally valid experiential frames.",
+    domain: "metaphysical",
+    depth: 2,
+    parentId: "3.2",
+    children: [],
+    scientificallyTestable: false
+  },
+  {
+    id: "3.2.6",
+    label: "Absolute World of Archetypes",
+    description: "Platonic realm of forms manifesting in physical experience.",
+    domain: "metaphysical",
+    depth: 2,
+    parentId: "3.2",
+    children: [],
+    scientificallyTestable: false
+  },
+  // --- 3.3 Transcendental ---
+  {
+    id: "3.3",
+    label: "Transcendental",
+    description: "Religious, spiritual, and theological explanations for UAP.",
+    domain: "metaphysical",
+    depth: 1,
+    parentId: "3",
+    children: ["3.3.1", "3.3.2", "3.3.3", "3.3.4", "3.3.5", "3.3.6"],
+    scientificallyTestable: false
+  },
+  {
+    id: "3.3.1",
+    label: '"Gaia" / Nature Spirits',
+    description: "Animistic intelligence of the Earth or natural world.",
+    domain: "metaphysical",
+    depth: 2,
+    parentId: "3.3",
+    children: [],
+    scientificallyTestable: false
+  },
+  {
+    id: "3.3.2",
+    label: "Angelic Beings",
+    description: "Benevolent spiritual entities from monotheistic traditions.",
+    domain: "metaphysical",
+    depth: 2,
+    parentId: "3.3",
+    children: [],
+    scientificallyTestable: false
+  },
+  {
+    id: "3.3.3",
+    label: '"Djinn" / Neutral Powers',
+    description: "Morally neutral spiritual entities (Islamic jinn, fae folk, trickster spirits).",
+    domain: "metaphysical",
+    depth: 2,
+    parentId: "3.3",
+    children: [],
+    scientificallyTestable: false
+  },
+  {
+    id: "3.3.4",
+    label: "Demonic Forces",
+    description: "Malevolent spiritual entities from various religious traditions.",
+    domain: "metaphysical",
+    depth: 2,
+    parentId: "3.3",
+    children: [],
+    scientificallyTestable: false
+  },
+  {
+    id: "3.3.5",
+    label: "Hierarchy of Being",
+    description: "Neo-Platonic great chain of being with UAP as higher-order entities.",
+    domain: "metaphysical",
+    depth: 2,
+    parentId: "3.3",
+    children: [],
+    scientificallyTestable: false
+  },
+  {
+    id: "3.3.6",
+    label: "Emanations of Godhead",
+    description: "Direct manifestations of divine creative force or cosmic consciousness.",
+    domain: "metaphysical",
+    depth: 2,
+    parentId: "3.3",
+    children: [],
+    scientificallyTestable: false
+  }
+];
+
+// src/taxonomy/traversal.ts
+var nodeMap = new Map(OCS_TAXONOMY.map((n) => [n.id, n]));
+function getNode(id) {
+  return nodeMap.get(id);
+}
+function getChildren(id) {
+  const node = nodeMap.get(id);
+  if (!node) return [];
+  return node.children.map((cid) => nodeMap.get(cid)).filter((n) => n !== void 0);
+}
+function getAncestors(id) {
+  const ancestors = [];
+  let current = nodeMap.get(id);
+  while (current?.parentId) {
+    const parent = nodeMap.get(current.parentId);
+    if (!parent) break;
+    ancestors.unshift(parent);
+    current = parent;
+  }
+  return ancestors;
+}
+function getSiblings(id) {
+  const node = nodeMap.get(id);
+  if (!node?.parentId) return [];
+  const parent = nodeMap.get(node.parentId);
+  if (!parent) return [];
+  return parent.children.filter((cid) => cid !== id).map((cid) => nodeMap.get(cid)).filter((n) => n !== void 0);
+}
+function getDomain(domain) {
+  return OCS_TAXONOMY.filter((n) => n.domain === domain);
+}
+function getTestableNodes() {
+  return OCS_TAXONOMY.filter((n) => n.scientificallyTestable);
+}
+function getLeafNodes() {
+  return OCS_TAXONOMY.filter((n) => n.children.length === 0);
+}
+function searchNodes(query) {
+  const lower = query.toLowerCase();
+  return OCS_TAXONOMY.filter(
+    (n) => n.label.toLowerCase().includes(lower) || n.description.toLowerCase().includes(lower) || n.aliases?.some((a) => a.toLowerCase().includes(lower))
+  );
+}
+function getPath(id) {
+  const ancestors = getAncestors(id);
+  const node = nodeMap.get(id);
+  if (!node) return "";
+  return [...ancestors, node].map((n) => n.label).join(" > ");
+}
+
+// src/taxonomy/physical/index.ts
+var PHYSICAL_NODES = OCS_TAXONOMY.filter((n) => n.domain === "physical");
+
+// src/taxonomy/psychosocial/index.ts
+var PSYCHOSOCIAL_NODES = OCS_TAXONOMY.filter((n) => n.domain === "psychosocial");
+
+// src/taxonomy/metaphysical/index.ts
+var METAPHYSICAL_NODES = OCS_TAXONOMY.filter((n) => n.domain === "metaphysical");
+var HypothesisWeightSchema = z.object({
+  nodeId: z.string().min(1).describe('OCS node id (e.g., "1.1.3").'),
+  confidence: ConfidenceSchema,
+  label: z.string().optional()
+}).meta({ id: "HypothesisWeight" }).describe("A weighted origin hypothesis (OCS node + confidence).");
+var OriginClaimSchema = ClaimSchema.extend({
+  primaryHypothesis: z.string().min(1).describe("OCS node id of the primary hypothesis."),
+  confidence: ConfidenceSchema.describe("Confidence in the primary hypothesis, in [0,1]."),
+  alternativeHypotheses: z.array(HypothesisWeightSchema).optional().describe(
+    "Other OCS hypotheses this same evaluator weighs as possible, each with its own confidence \u2014 the intra-claim uncertainty axis."
+  )
+}).meta({ id: "OriginClaim" }).describe("An attributed origin-hypothesis classification for an observation.");
+var ConfidenceDistributionSchema = z.object({
+  hypotheses: z.array(HypothesisWeightSchema),
+  unresolved: ConfidenceSchema.describe("Remaining confidence not assigned to any hypothesis."),
+  evaluatedAt: z.iso.datetime()
+}).meta({ id: "ConfidenceDistribution" }).describe("Confidence distribution across origin hypotheses.");
+var CategoryConfidenceSchema = z.object({
+  conventional: ConfidenceSchema,
+  cryptoterrestrial: ConfidenceSchema,
+  extraterrestrial: ConfidenceSchema,
+  extradimensional: ConfidenceSchema,
+  interdimensional: ConfidenceSchema,
+  psychosocial: ConfidenceSchema,
+  metaphysical: ConfidenceSchema,
+  insufficientData: ConfidenceSchema
+}).meta({ id: "CategoryConfidence" }).describe("Quick category-level confidence distribution across broad OCS categories.");
+
+// src/labels/index.ts
+var OCS_LABELS = Object.fromEntries(
+  OCS_TAXONOMY.map((n) => [n.id, n.label])
+);
+var ORIGIN_DOMAIN_LABELS = {
+  physical: "Physical",
+  psychosocial: "Psychosocial",
+  metaphysical: "Metaphysical"
+};
+
+// src/constants/index.ts
+var ORIGIN_DOMAINS = OriginDomainSchema.options;
+var OCS_PROVENANCE = {
+  author: "Col. Karl Nell (U.S. Army, ret.)",
+  work: "Proposed Taxonomy of UAP Origin Hypotheses",
+  venue: "Sol Foundation Symposium, Stanford University",
+  date: "November 2023"
+};
+var ALL_OCS_IDS = OCS_TAXONOMY.map((n) => n.id);
+var TESTABLE_IDS = OCS_TAXONOMY.filter((n) => n.scientificallyTestable).map((n) => n.id);
+var LEAF_IDS = OCS_TAXONOMY.filter((n) => n.children.length === 0).map((n) => n.id);
+var PHYSICAL_IDS = OCS_TAXONOMY.filter((n) => n.domain === "physical").map((n) => n.id);
+var PSYCHOSOCIAL_IDS = OCS_TAXONOMY.filter((n) => n.domain === "psychosocial").map((n) => n.id);
+var METAPHYSICAL_IDS = OCS_TAXONOMY.filter((n) => n.domain === "metaphysical").map((n) => n.id);
+
+// src/brands.ts
+function asOCSNodeId(value) {
+  return value;
+}
+var isOriginDomain = createEnumGuard(OriginDomainSchema.options);
+var isOCSNodeId = createEnumGuard(ALL_OCS_IDS);
+function isOriginClaim(value) {
+  return OriginClaimSchema.safeParse(value).success;
+}
+function isConfidenceDistribution(value) {
+  return ConfidenceDistributionSchema.safeParse(value).success;
+}
+
+// src/factories/index.ts
+function assertKnownNode(nodeId, label) {
+  if (!getNode(nodeId)) {
+    throw new Error(`Unknown OCS node ID in ${label}: "${nodeId}"`);
+  }
+}
+function createOriginClaim(primaryHypothesis, confidence, options) {
+  assertKnownNode(primaryHypothesis, "primaryHypothesis");
+  const { alternativeHypotheses, rationale, evaluatedBy, evaluatedAt, evidenceRefs } = options ?? {};
+  for (const alt of alternativeHypotheses ?? []) {
+    assertKnownNode(alt.nodeId, "alternativeHypothesis");
+  }
+  return OriginClaimSchema.parse({
+    primaryHypothesis,
+    confidence,
+    evaluatedAt: evaluatedAt ?? (/* @__PURE__ */ new Date()).toISOString(),
+    ...alternativeHypotheses !== void 0 && { alternativeHypotheses },
+    ...rationale !== void 0 && { rationale },
+    ...evaluatedBy !== void 0 && { evaluatedBy },
+    ...evidenceRefs !== void 0 && { evidenceRefs }
+  });
+}
+function createConfidenceDistribution(hypotheses, options) {
+  for (const h of hypotheses) {
+    assertKnownNode(h.nodeId, "hypothesis");
+  }
+  const total = hypotheses.reduce((sum, h) => sum + h.confidence, 0);
+  if (total > 1 + 1e-9) {
+    throw new RangeError(`hypothesis confidences sum to ${total}, exceeding 1.0`);
+  }
+  return ConfidenceDistributionSchema.parse({
+    hypotheses,
+    unresolved: Math.max(0, 1 - total),
+    evaluatedAt: options?.evaluatedAt ?? (/* @__PURE__ */ new Date()).toISOString()
+  });
+}
+
+// src/formatters/index.ts
+function formatOCSCode(id) {
+  return getPath(id) || id;
+}
+function formatDomainLabel(domain) {
+  return ORIGIN_DOMAIN_LABELS[domain];
+}
+function formatNodeLabel(id) {
+  return OCS_LABELS[id] ?? id;
+}
+function formatTestability(node) {
+  return node.scientificallyTestable ? "Scientifically testable" : "Not empirically falsifiable";
+}
+var ORIGINS_SCHEMA_VERSION = "2.0.0";
+var ORIGINS_SCHEMA_ID = schemaId(
+  "origins",
+  "origin-classification",
+  ORIGINS_SCHEMA_VERSION
+);
+var OriginSlotSchema = z.array(OriginClaimSchema).describe("Competing origin claims for an observation (one per evaluator/verdict).");
+function originsJsonSchema() {
+  const schema = z.toJSONSchema(OriginSlotSchema, {
+    target: "draft-2020-12"
+  });
+  return jsonSchemaEnvelope(schema, { id: ORIGINS_SCHEMA_ID, version: ORIGINS_SCHEMA_VERSION });
+}
+function checkClaimNodes(claim, prefix, issues) {
+  const c = claim;
+  if (typeof c.primaryHypothesis === "string" && !getNode(c.primaryHypothesis)) {
+    issues.push({
+      path: `${prefix}primaryHypothesis`,
+      message: `unknown OCS node id: ${c.primaryHypothesis}`
+    });
+  }
+  if (Array.isArray(c.alternativeHypotheses)) {
+    c.alternativeHypotheses.forEach((alt, i) => {
+      const nodeId = alt?.nodeId;
+      if (typeof nodeId === "string" && !getNode(nodeId)) {
+        issues.push({
+          path: `${prefix}alternativeHypotheses.${i}.nodeId`,
+          message: `unknown OCS node id: ${nodeId}`
+        });
+      }
+    });
+  }
+}
+function validateOriginClassification(value) {
+  const structural = validateWith(OriginSlotSchema, value);
+  if (structural.length > 0) return structural;
+  const issues = [];
+  value.forEach((claim, i) => {
+    checkClaimNodes(claim, `${i}.`, issues);
+  });
+  return issues;
+}
+
+export { ALL_OCS_IDS, CategoryConfidenceSchema, ConfidenceDistributionSchema, HypothesisWeightSchema, LEAF_IDS, METAPHYSICAL_IDS, METAPHYSICAL_NODES, MetaphysicalSubdomainSchema, OCSNodeSchema, OCS_LABELS, OCS_PROVENANCE, OCS_TAXONOMY, ORIGINS_SCHEMA_ID, ORIGINS_SCHEMA_VERSION, ORIGIN_DOMAINS, ORIGIN_DOMAIN_LABELS, OriginClaimSchema, OriginDomainSchema, OriginSubdomainSchema, PHYSICAL_IDS, PHYSICAL_NODES, PSYCHOSOCIAL_IDS, PSYCHOSOCIAL_NODES, PhysicalSubdomainSchema, PsychosocialSubdomainSchema, TESTABLE_IDS, asOCSNodeId, createConfidenceDistribution, createOriginClaim, formatDomainLabel, formatNodeLabel, formatOCSCode, formatTestability, getAncestors, getChildren, getDomain, getLeafNodes, getNode, getPath, getSiblings, getTestableNodes, isConfidenceDistribution, isOCSNodeId, isOriginClaim, isOriginDomain, originsJsonSchema, searchNodes, validateOriginClassification };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map