@disclosureos/records 1.0.0

package/dist/observation/index.js

@@ -0,0 +1,865 @@
+import { z } from 'zod';
+
+// src/observation/types.ts
+var TemporalCertaintySchema = z.enum(["exact", "approximate", "estimated", "unknown"]).describe("Confidence in a date or time value \u2014 the single certainty scale for all temporal values.");
+var TimeOfDaySchema = z.enum([
+  "astronomical_dawn",
+  "nautical_dawn",
+  "civil_dawn",
+  "sunrise",
+  "morning",
+  "noon",
+  "afternoon",
+  "sunset",
+  "civil_dusk",
+  "nautical_dusk",
+  "astronomical_dusk",
+  "night",
+  "unknown"
+]).describe("Twilight-aware time-of-day bucket for an observation.");
+var DateGranularitySchema = z.enum(["exact", "month", "quarter", "year", "decade", "century", "unknown"]).describe("Precision of a date value, from calendar-day (`exact`) to `century`.");
+var DateRangeTypeSchema = z.enum(["span", "uncertainty", "active_period", "investigation_period", "observation_window"]).describe("What a DateRange represents (a true span vs. an uncertainty window, etc.).");
+var FuzzyDateSchema = z.object({
+  value: z.string().describe("Machine-comparable anchor (ISO-like, as precise as known, e.g. `1947`, `1947-07`)."),
+  granularity: DateGranularitySchema,
+  certainty: TemporalCertaintySchema,
+  quarter: z.union([z.literal(1), z.literal(2), z.literal(3), z.literal(4)]).optional().describe("Calendar quarter (1\u20134) when granularity is `quarter`."),
+  display: z.string().optional().describe('Human display override, e.g. "Summer 1947".'),
+  notes: z.string().optional().describe("Free-text caveats about how this date was determined.")
+}).meta({ id: "FuzzyDate" }).describe('A date whose precision is coarser than a calendar day (e.g. "summer 1947").');
+var DateRangeSchema = z.object({
+  start: FuzzyDateSchema,
+  end: FuzzyDateSchema,
+  type: DateRangeTypeSchema,
+  display: z.string().optional().describe('Human display override, e.g. "July\u2013August 1952".'),
+  inclusive: z.boolean().optional().describe("Whether the end date is included in the range. Defaults to true.")
+}).meta({ id: "DateRange" }).describe("A period or uncertainty window bounded by two FuzzyDates.");
+var RelativeDateSchema = z.object({
+  referenceEvent: z.string().describe('The event this date is anchored to (e.g. "the crash").'),
+  referenceDate: FuzzyDateSchema.optional(),
+  relation: z.enum(["before", "after", "during", "around"]).describe("How this date relates to the reference event."),
+  offset: z.object({
+    value: z.number(),
+    unit: z.enum(["minutes", "hours", "days", "weeks", "months", "years"]),
+    approximate: z.boolean().optional()
+  }).optional().describe('Distance from the reference event (e.g. value 3, unit "days").'),
+  display: z.string().optional().describe('Human display override, e.g. "three days after the crash".')
+}).meta({ id: "RelativeDate" }).describe('A date known only relative to another event (e.g. "3 days after the crash").');
+
+// src/temporal/temporal-data.ts
+var TemporalDataSchema = z.object({
+  date: z.string().regex(/^\d{4}-\d{2}-\d{2}$/, "must be a valid ISO date (YYYY-MM-DD)").describe(
+    "Canonical, machine-sortable date anchor in ISO YYYY-MM-DD form. ALWAYS present, even when the true date is fuzzy or a range \u2014 set it to the best single representative. Express nuance via dateGranularity, dateRange, or relativeDate."
+  ),
+  dateCertainty: TemporalCertaintySchema,
+  dateGranularity: DateGranularitySchema.optional().describe(
+    'Precision of `date`. Defaults to day-level when omitted (e.g. "July 1947" \u2192 date "1947-07-01", dateGranularity "month").'
+  ),
+  time: z.string().optional().describe("Local clock time of the observation (HH:MM or HH:MM:SS, 24-hour)."),
+  timezone: z.string().optional().describe('IANA timezone of the local time (e.g. "America/Los_Angeles").'),
+  utcTime: z.string().optional().describe("Observation time converted to UTC, when known."),
+  timeCertainty: TemporalCertaintySchema.optional(),
+  durationSeconds: z.number().optional().describe("How long the observation lasted, in seconds."),
+  durationDescription: z.string().optional().describe('Duration as reported when not precisely known (e.g. "several minutes").'),
+  timeOfDay: TimeOfDaySchema.optional(),
+  isDaylightSaving: z.boolean().optional().describe("Whether daylight saving time was in effect at the local time."),
+  moonPhase: z.number().optional().describe("Moon phase at the time of observation (0 = new moon, 0.5 = full, 1 = new)."),
+  moonIllumination: z.number().optional().describe("Fraction of the moon illuminated at the time of observation (0\u20131)."),
+  dateRange: DateRangeSchema.optional().describe(
+    "For events spanning a period or with a genuine uncertainty window. `date` should still anchor within/at the range."
+  ),
+  relativeDate: RelativeDateSchema.optional().describe(
+    'For dates known only relative to another event (e.g. "3 days after the crash").'
+  )
+}).meta({ id: "TemporalData" }).describe("When an observation occurred \u2014 a sortable anchor date plus optional fuzzy/range/relative nuance.");
+var CoordinatePrecisionSchema = z.enum(["exact", "address", "locality", "region", "approximate", "unknown"]).describe("How precisely a coordinate is known.");
+var SiteTypeSchema = z.enum([
+  "military_air_base",
+  "military_naval_base",
+  "military_army_base",
+  "military_missile_site",
+  "military_radar_station",
+  "military_research_facility",
+  "military_training_area",
+  "military_other",
+  "nuclear_power_plant",
+  "nuclear_weapons_storage",
+  "nuclear_research_facility",
+  "nuclear_waste_storage",
+  "nuclear_other",
+  "civilian_airport",
+  "private_airfield",
+  "heliport",
+  "seaport",
+  "offshore_platform",
+  "naval_vessel",
+  "government_facility",
+  "embassy",
+  "intelligence_facility",
+  "power_plant",
+  "dam",
+  "telecommunications",
+  "water_treatment",
+  "research_facility",
+  "test_range",
+  "space_station",
+  "archaeological_site",
+  "volcano",
+  "command_center",
+  "residential",
+  "commercial",
+  "industrial",
+  "agricultural",
+  "wilderness",
+  "ocean",
+  "lake",
+  "mountain",
+  "desert",
+  "forest",
+  "urban",
+  "suburban",
+  "rural",
+  "other",
+  "unknown"
+]).describe("Category of site at or near the observation location (military, nuclear, civilian, natural, etc.).");
+var TerrainTypeSchema = z.enum([
+  "ocean",
+  "coastal",
+  "lake",
+  "river",
+  "wetland",
+  "plains",
+  "hills",
+  "mountains",
+  "desert",
+  "forest",
+  "jungle",
+  "tundra",
+  "arctic",
+  "urban",
+  "suburban",
+  "rural",
+  "underground",
+  "underwater",
+  "airborne",
+  "space",
+  "unknown"
+]).describe("Physical terrain at the observation location.");
+var AirspaceClassSchema = z.enum([
+  "A",
+  "B",
+  "C",
+  "D",
+  "E",
+  "G",
+  "restricted",
+  "prohibited",
+  "warning",
+  "moa",
+  "alert",
+  "cfa",
+  "national_security",
+  "tfr",
+  "international",
+  "unknown"
+]).describe("Airspace classification over the location (ICAO classes plus special-use airspace).");
+var LocationSensitivitySchema = z.enum(["critical", "high", "moderate", "standard", "none"]).describe("How sensitive the location is (e.g. proximity to critical infrastructure).");
+var ProximitySiteSchema = z.object({
+  siteType: SiteTypeSchema,
+  siteName: z.string().optional().describe('Name of the nearby site (e.g. "Naval Air Station Oceana").'),
+  distanceKm: z.number().describe("Distance from the observation location, in kilometers."),
+  bearing: z.number().optional().describe("Compass bearing from the observation location to the site, in degrees (0\u2013360).")
+}).meta({ id: "ProximitySite" }).describe("A site of interest near the observation and its distance/bearing.");
+var LocationDataSchema = z.object({
+  id: z.string().min(1).describe("Stable unique identifier for this location."),
+  name: z.string().min(1).describe('Human-readable place name (e.g. "Off the coast of San Diego").'),
+  country: z.string().min(1).describe("Country where the observation occurred."),
+  countryCode: z.string().optional().describe('ISO 3166-1 alpha-2 country code (e.g. "US").'),
+  region: z.string().optional().describe("State, province, or administrative region."),
+  city: z.string().optional().describe("Nearest city or town."),
+  address: z.string().optional().describe("Street address, when the location is that precise."),
+  longitude: z.number().min(-180).max(180).describe("Longitude in decimal degrees (WGS 84)."),
+  latitude: z.number().min(-90).max(90).describe("Latitude in decimal degrees (WGS 84)."),
+  coordinatePrecision: CoordinatePrecisionSchema.optional(),
+  coordinatePrecisionMeters: z.number().optional().describe("Numeric uncertainty radius of the coordinates, in meters."),
+  coordinatesApproximate: z.boolean().optional().describe("Whether the coordinates are an approximation rather than a measured fix."),
+  elevationMeters: z.number().optional().describe("Ground elevation at the location, in meters above sea level."),
+  elevationSource: z.enum(["gps", "map", "estimated", "unknown"]).optional().describe("How the elevation value was obtained."),
+  siteType: SiteTypeSchema,
+  secondarySiteTypes: z.array(SiteTypeSchema).optional().describe("Additional site categories that also apply to the location."),
+  terrain: TerrainTypeSchema.optional(),
+  airspaceClass: AirspaceClassSchema.optional(),
+  locationSensitivity: LocationSensitivitySchema.optional(),
+  proximitySites: z.array(ProximitySiteSchema).optional().describe("Named sites of interest near the observation, with distance and bearing."),
+  nearestMilitaryKm: z.number().optional().describe("Distance to the nearest military installation, in kilometers."),
+  nearestNuclearKm: z.number().optional().describe("Distance to the nearest nuclear facility, in kilometers."),
+  nearestAirportKm: z.number().optional().describe("Distance to the nearest airport, in kilometers."),
+  waterDepthMeters: z.number().optional().describe("Water depth at the location for maritime observations, in meters."),
+  vesselName: z.string().optional().describe("Name of the vessel the observer was aboard, if any."),
+  vesselType: z.string().optional().describe('Type of vessel (e.g. "aircraft carrier", "fishing trawler").'),
+  aircraftType: z.string().optional().describe("Type of aircraft the observer was aboard, if any."),
+  aircraftCallsign: z.string().optional().describe("Callsign of the observer\u2019s aircraft."),
+  flightNumber: z.string().optional().describe("Commercial flight number, for airline observations."),
+  observerAltitudeMeters: z.number().optional().describe("Altitude of an airborne observer at the time of observation, in meters.")
+}).meta({ id: "LocationData" }).describe("Where an observation occurred \u2014 identity, coordinates, site classification, and proximity context.");
+var MediaTypeSchema = z.enum(["image", "video", "document", "audio"]).describe("Kind of media attachment.");
+
+// src/media/attachment.ts
+var MediaAttachmentSchema = z.object({
+  id: z.string().min(1).describe('Stable id, addressable by a claim `evidenceRef` ("media:<id>").'),
+  type: MediaTypeSchema,
+  url: z.string().describe("Where the media file is hosted."),
+  thumbnailUrl: z.string().optional().describe("Preview/thumbnail image for the media."),
+  caption: z.string().optional().describe("Human-readable caption describing what the media shows."),
+  credit: z.string().optional().describe("Attribution for who captured or owns the media."),
+  mimeType: z.string().optional().describe('MIME type of the file (e.g. "video/mp4").'),
+  fileSize: z.number().optional().describe("File size, in bytes."),
+  duration: z.number().optional().describe("Playback duration for video/audio, in seconds."),
+  width: z.number().optional().describe("Pixel width for images and video."),
+  height: z.number().optional().describe("Pixel height for images and video.")
+}).meta({ id: "MediaAttachment" }).describe("A media file associated with an observation (image, video, document, or audio).");
+var DetectionMethodSchema = z.enum([
+  "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",
+  "other",
+  "unknown"
+]).describe("How a sensor detected the object.");
+var SensorTypeSchema = z.enum([
+  "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",
+  "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,
+  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)."),
+  duration: z.number().optional().describe("How long the sensor held contact, in seconds."),
+  rawDataAvailable: z.boolean().optional().describe("Whether the raw sensor data still exists and is obtainable."),
+  calibrated: z.boolean().optional().describe("Whether the sensor was calibrated at the time of the reading."),
+  readings: z.record(z.string(), z.unknown()).optional().describe("Sensor-specific measured values, keyed by measurement name."),
+  notes: z.string().optional().describe("Free-text context about the reading.")
+}).meta({ id: "SensorReading" }).describe("A single sensor reading and its provenance.");
+var SensorEvidenceDataSchema = z.object({
+  sensors: z.array(SensorReadingSchema),
+  multiSensorCorrelation: z.boolean().optional().describe("Whether independent sensors corroborated the same object."),
+  dataRetentionStatus: z.enum(["available", "archived", "destroyed", "classified", "unknown"]).optional().describe("Current status of the underlying sensor data."),
+  anomalies: z.array(z.string()).optional().describe('Anomalies in the sensor data itself (e.g. "jamming indications", "signal dropout").')
+}).meta({ id: "SensorEvidenceData" }).describe("Instrument-recorded evidence for an observation (radar, FLIR, EO, etc.).");
+var ChainOfCustodySchema = z.enum([
+  "verified",
+  "partial",
+  "unverified",
+  "government_held",
+  "private_held",
+  "lost",
+  "destroyed",
+  "classified",
+  "unknown"
+]).describe("Custody status of an evidence item.");
+var CustodyActionSchema = z.enum([
+  "creation",
+  "collection",
+  "transfer",
+  "storage",
+  "analysis",
+  "release",
+  "classification",
+  "destruction",
+  "loss",
+  "recovery",
+  "other"
+]).describe("An action recorded in a chain-of-custody entry.");
+var CustodyEntrySchema = z.object({
+  entryId: z.string().describe("Stable unique identifier for this custody entry."),
+  date: z.string().describe("When the custody event occurred (ISO date)."),
+  action: CustodyActionSchema,
+  from: z.string().optional().describe("Party that held the evidence before this event."),
+  to: z.string().optional().describe("Party that held the evidence after this event."),
+  location: z.string().optional().describe("Where the custody event took place."),
+  reference: z.string().optional().describe("Document or record substantiating the event (e.g. transfer receipt, log entry)."),
+  notes: z.string().optional().describe("Free-text context about the event.")
+}).meta({ id: "CustodyEntry" }).describe("A single custody event for an evidence item.");
+var ChainOfCustodyRecordSchema = z.object({
+  evidenceId: z.string().describe("Identifier of the evidence item this custody history belongs to."),
+  status: ChainOfCustodySchema,
+  entries: z.array(CustodyEntrySchema)
+}).meta({ id: "ChainOfCustodyRecord" }).describe("The full custody history for a piece of evidence.");
+var HashAlgorithmSchema = z.enum(["sha256", "sha512", "sha1", "md5"]).describe("Cryptographic hash algorithm used to fingerprint a file.");
+var FileHashSchema = z.object({
+  algorithm: HashAlgorithmSchema,
+  value: z.string().describe("Hex-encoded hash digest of the file contents.")
+}).meta({ id: "FileHash" }).describe("A content hash of a file.");
+var VerificationMethodSchema = z.enum([
+  "metadata_analysis",
+  "forensic_analysis",
+  "hash_verification",
+  "chain_of_custody",
+  "source_confirmation",
+  "expert_review",
+  "ai_analysis",
+  "other"
+]).describe("Method used to verify media authenticity.");
+var VerificationResultSchema = z.enum([
+  "authentic",
+  "likely_authentic",
+  "inconclusive",
+  "likely_manipulated",
+  "manipulated",
+  "ai_generated",
+  "deepfake",
+  "composite",
+  "unknown"
+]).describe("Outcome of an authenticity verification.");
+var ThirdPartyVerificationSchema = z.object({
+  verifier: z.string().describe("Name of the person who performed the verification."),
+  organization: z.string().optional().describe("Organization the verifier represents."),
+  credentials: z.string().optional().describe('Verifier\u2019s relevant qualifications (e.g. "certified forensic video analyst").'),
+  date: z.string().describe("When the verification was performed (ISO date)."),
+  method: VerificationMethodSchema,
+  methodDescription: z.string().optional().describe("Fuller description of how the verification was performed."),
+  result: VerificationResultSchema,
+  confidence: z.enum(["high", "medium", "low"]).optional().describe("Verifier\u2019s confidence in their own result."),
+  findings: z.string().optional().describe("Summary of what the verification found."),
+  reportUrl: z.string().optional().describe("Link to the full verification report.")
+}).meta({ id: "ThirdPartyVerification" }).describe("An independent authenticity assessment of media or a document.");
+var CaptureMetadataSchema = z.object({
+  device: z.string().optional().describe('Capture device as recorded in metadata (e.g. "iPhone 14 Pro").'),
+  manufacturer: z.string().optional().describe("Device manufacturer from metadata."),
+  model: z.string().optional().describe("Device model from metadata."),
+  software: z.string().optional().describe("Software that produced or processed the file."),
+  originalFilename: z.string().optional().describe("Filename as originally captured, before any renaming."),
+  originalCreationDate: z.string().optional().describe("Creation timestamp embedded in the file metadata."),
+  gpsCoordinates: z.object({
+    latitude: z.number(),
+    longitude: z.number(),
+    altitude: z.number().optional()
+  }).optional().describe("GPS position embedded in the file metadata."),
+  metadataPreserved: z.boolean().optional().describe("Whether the original metadata survives intact."),
+  metadataStripped: z.boolean().optional().describe("Whether metadata was removed at some point."),
+  strippedReason: z.string().optional().describe('Why metadata was stripped (e.g. "platform re-encoding", "privacy redaction").')
+}).meta({ id: "CaptureMetadata" }).describe("Capture/EXIF-style metadata extracted from a media file.");
+var DigitalProvenanceSchema = z.object({
+  hash: FileHashSchema.optional(),
+  additionalHashes: z.array(FileHashSchema).optional(),
+  captureMetadata: CaptureMetadataSchema.optional(),
+  verifications: z.array(ThirdPartyVerificationSchema).optional(),
+  provenanceChain: z.array(z.string()).optional().describe('Ordered hops the file took from capture to here (e.g. "witness phone \u2192 NYT \u2192 public release").'),
+  manipulationDetected: z.boolean().optional().describe("Whether any analysis found evidence of manipulation."),
+  manipulationDescription: z.string().optional().describe("What manipulation was found, if any."),
+  authenticityAssessment: VerificationResultSchema.optional(),
+  authenticityConfidence: z.enum(["high", "medium", "low", "unassessed"]).optional().describe("Overall confidence in the authenticity assessment."),
+  lastUpdated: z.string().optional().describe("When this provenance record was last updated (ISO timestamp)."),
+  notes: z.string().optional().describe("Free-text context about the provenance trail.")
+}).meta({ id: "DigitalProvenance" }).describe("Digital authenticity trail for media: hashes, capture metadata, and verifications.");
+
+// src/extensions/provenance/index.ts
+var ProvenanceSchema = z.object({
+  custodyStatus: ChainOfCustodySchema.optional(),
+  custody: ChainOfCustodyRecordSchema.optional(),
+  digital: DigitalProvenanceSchema.optional()
+}).meta({ id: "Provenance" }).describe("Forensic provenance for an observation: custody status/chain and digital authenticity.");
+var IdentifierSystemSchema = z.enum([
+  "nuforc",
+  "mufon",
+  "geipan",
+  "cufos",
+  "nicap",
+  "bluebook",
+  "nara",
+  "foia",
+  "aaro",
+  "congress",
+  "doi",
+  "arxiv",
+  "orcid",
+  "pubmed",
+  "isbn",
+  "issn",
+  "youtube",
+  "vimeo",
+  "internet_archive",
+  "wayback",
+  "url",
+  "uri",
+  "custom"
+]).describe("External identifier namespace (reporting centers, archives, academic registries, media hosts).");
+var ExternalIdentifierSchema = z.object({
+  system: IdentifierSystemSchema,
+  systemName: z.string().optional().describe('Display name of the system, required when `system` is "custom".'),
+  value: z.string().describe("The identifier value within the external system (e.g. a case number)."),
+  url: z.string().optional().describe("Direct link to the record in the external system."),
+  verified: z.boolean().optional().describe("Whether the identifier has been confirmed to point at this observation."),
+  verifiedDate: z.string().optional().describe("When the identifier was last verified (ISO date)."),
+  accessible: z.boolean().optional().describe("Whether the external record is currently reachable."),
+  accessCheckedDate: z.string().optional().describe("When accessibility was last checked (ISO date)."),
+  notes: z.string().optional().describe("Free-text context about the cross-reference.")
+}).meta({ id: "ExternalIdentifier" }).describe("A reference to this observation in an external system or archive.");
+var CrossReferencesSchema = z.object({
+  primary: ExternalIdentifierSchema.optional(),
+  identifiers: z.array(ExternalIdentifierSchema)
+}).meta({ id: "CrossReferences" }).describe("External identifiers cross-referencing this observation, with an optional primary.");
+var WitnessCategorySchema = z.enum([
+  "military_pilot",
+  "military_aircrew",
+  "military_ground",
+  "military_naval",
+  "military_radar_operator",
+  "military_other",
+  "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",
+  "unknown"
+]).describe("Professional/role category of a witness.");
+var ConfidenceLevelSchema = z.enum(["very_high", "high", "moderate", "low", "very_low", "unassessed"]).describe("Qualitative confidence magnitude.");
+ConfidenceLevelSchema.options;
+
+// src/extensions/testimony/credibility.ts
+var CredibilityFactorSchema = z.enum([
+  "professional_training",
+  "official_capacity",
+  "sworn_statement",
+  "contemporaneous_record",
+  "corroborating_witnesses",
+  "corroborating_evidence",
+  "consistent_account",
+  "no_apparent_motive",
+  "reputation_risk",
+  "security_clearance"
+]).describe("A factor strengthening witness credibility.");
+var CredibilityDetractorSchema = z.enum([
+  "anonymous",
+  "inconsistent_account",
+  "delayed_report",
+  "known_fabricator",
+  "financial_motive",
+  "single_witness",
+  "impaired_state",
+  "recovered_memory"
+]).describe("A factor weakening witness credibility.");
+var WitnessCredibilitySchema = z.object({
+  // The former `CredibilityRating` was byte-identical to the qualitative
+  // `ConfidenceLevel`; it is now the single shared scale (DRY #1).
+  rating: ConfidenceLevelSchema.optional(),
+  factors: z.array(CredibilityFactorSchema).optional(),
+  detractors: z.array(CredibilityDetractorSchema).optional(),
+  isProfessionalObserver: z.boolean().optional().describe("Whether the witness is a trained observer (pilot, astronomer, military)."),
+  hasAviationExperience: z.boolean().optional().describe("Whether the witness has aviation experience."),
+  hasMilitaryExperience: z.boolean().optional().describe("Whether the witness has military experience."),
+  hasScientificBackground: z.boolean().optional().describe("Whether the witness has a scientific background."),
+  hasPriorUAPKnowledge: z.boolean().optional().describe("Whether the witness had prior knowledge of or interest in UAP before the observation."),
+  wasSkepticPrior: z.boolean().optional().describe("Whether the witness was a skeptic before the observation."),
+  underOathTestimony: z.boolean().optional().describe("Whether the testimony was given under oath."),
+  polygraphAdministered: z.boolean().optional().describe("Whether a polygraph was administered."),
+  polygraphPassed: z.boolean().optional().describe("Whether the witness passed the polygraph."),
+  consistentTestimony: z.boolean().optional().describe("Whether the account has remained consistent across retellings."),
+  willingToBeIdentified: z.boolean().optional().describe("Whether the witness is willing to be publicly identified."),
+  notes: z.string().optional().describe("Free-text context about the credibility assessment.")
+}).meta({ id: "WitnessCredibility" }).describe("Structured assessment of a witness's credibility (rating, factors, detractors).");
+var SecurityClearanceSchema = z.enum(["none", "confidential", "secret", "top_secret", "sci", "unknown"]).describe("Security clearance level held by a witness.");
+var WitnessSchema = z.object({
+  witnessId: z.string().describe("Stable unique identifier for this witness."),
+  category: WitnessCategorySchema,
+  anonymous: z.boolean().describe("Whether the witness\u2019s identity is withheld."),
+  publicName: z.string().optional().describe("Witness\u2019s name as publicly known, when not anonymous."),
+  pseudonym: z.string().optional().describe("Pseudonym used when the witness is anonymous."),
+  role: z.string().optional().describe('Witness\u2019s role at the time (e.g. "F/A-18F pilot", "radar operator").'),
+  organization: z.string().optional().describe("Organization the witness belonged to at the time."),
+  experienceYears: z.number().optional().describe("Years of relevant professional experience."),
+  securityClearance: SecurityClearanceSchema.optional(),
+  credibility: WitnessCredibilitySchema.optional(),
+  statementSummary: z.string().optional().describe("Brief summary of what the witness reported."),
+  interviewAvailable: z.boolean().optional().describe("Whether a recorded interview with the witness exists."),
+  writtenReportAvailable: z.boolean().optional().describe("Whether a written report from the witness exists.")
+}).meta({ id: "Witness" }).describe("A person who reported or corroborated an observation.");
+var SourceTypeSchema = z.enum([
+  "foia",
+  "official_report",
+  "official_statement",
+  "congressional_testimony",
+  "congressional_report",
+  "military_document",
+  "intelligence_document",
+  "whistleblower",
+  "firsthand_witness",
+  "secondhand_account",
+  "news_article",
+  "documentary",
+  "interview",
+  "book",
+  "academic_paper",
+  "investigation_report",
+  "database_entry",
+  "social_media",
+  "website",
+  "other"
+]).describe("Kind of source backing an observation (document, testimony, media, etc.).");
+var SourceCredibilitySchema = z.enum(["official", "verified", "credible", "unverified", "questionable", "disputed", "unknown"]).describe("Trust tier of a source \u2014 an orthogonal axis to confidence and temporal certainty.");
+
+// src/source/reference.ts
+var SourceReferenceSchema = z.object({
+  sourceId: z.string().describe("Stable unique identifier for this source."),
+  type: SourceTypeSchema,
+  title: z.string().describe("Title of the source document, article, or material."),
+  author: z.string().optional().describe("Author of the source material."),
+  organization: z.string().optional().describe("Organization that produced or published the source."),
+  date: z.string().optional().describe("Publication or creation date of the source (ISO date)."),
+  url: z.string().optional().describe("Link to the source material."),
+  archiveUrl: z.string().optional().describe("Archived copy of the source (e.g. Wayback Machine), in case the original disappears."),
+  reference: z.string().optional().describe("Citation locator within the source (e.g. page number, document section)."),
+  credibility: SourceCredibilitySchema,
+  isPrimarySource: z.boolean().optional().describe("Whether this is a primary source (original document/recording) rather than secondary reporting."),
+  classificationLevel: z.string().optional().describe("Government classification of the source, if it was ever classified."),
+  notes: z.string().optional().describe("Free-text context about the source.")
+}).meta({ id: "SourceReference" }).describe("A citation/source backing an observation, with its credibility tier.");
+
+// src/extensions/testimony/statement.ts
+var TestimonyContextSchema = z.enum([
+  "sworn_affidavit",
+  "congressional_testimony",
+  "deposition",
+  "official_interview",
+  "written_statement",
+  "recorded_interview",
+  "informal_account",
+  "anonymous_tip",
+  "whistleblower_disclosure"
+]).describe("The setting in which testimony was given.");
+var TestimonyDateSchema = z.object({
+  date: z.string().describe("When the testimony was given (ISO date)."),
+  certainty: TemporalCertaintySchema
+}).meta({ id: "TestimonyDate" }).describe("When testimony was given, with its certainty.");
+var TestimonyStatementSchema = z.object({
+  statementId: z.string().describe('Stable id, addressable by a claim `evidenceRef` ("testimony:<statementId>").'),
+  witness: WitnessSchema,
+  context: TestimonyContextSchema,
+  date: TestimonyDateSchema,
+  content: z.string().optional().describe("Full text of the statement, when available."),
+  summary: z.string().optional().describe("Brief summary of what the statement asserts."),
+  sourceDocument: SourceReferenceSchema.optional(),
+  chainOfCustody: ChainOfCustodySchema.optional(),
+  additionalEvidenceIds: z.array(z.string()).optional().describe("Ids of other evidence items the statement references or supports.")
+}).meta({ id: "TestimonyStatement" }).describe("A single witness statement, its context, and supporting documentation.");
+var EvidenceTypeSchema = z.enum([
+  "material_sample",
+  "ground_trace",
+  "radiation_reading",
+  "electromagnetic_recording",
+  "photographic",
+  "video",
+  "audio_recording",
+  "biological_sample",
+  "implant",
+  "debris",
+  "soil_sample",
+  "water_sample",
+  "vegetation_sample",
+  "impression",
+  "burn_mark",
+  "other"
+]).describe("Kind of physical evidence collected.");
+var EvidenceQualitySchema = z.enum(["laboratory_grade", "field_collected", "uncontrolled", "degraded", "contaminated", "unknown"]).describe("Collection/handling quality of a physical evidence item.");
+var PhysicalEvidenceItemSchema = z.object({
+  id: z.string().describe('Stable id, addressable by a claim `evidenceRef` ("physical:<id>").'),
+  type: EvidenceTypeSchema,
+  quality: EvidenceQualitySchema,
+  description: z.string().optional().describe("What the evidence item is and what makes it notable."),
+  collectionDate: z.string().optional().describe("When the evidence was collected (ISO date)."),
+  collectionMethod: z.string().optional().describe('How the evidence was collected (e.g. "sterile swab", "soil core sample").'),
+  collectorName: z.string().optional().describe("Person who collected the evidence."),
+  collectorOrganization: z.string().optional().describe("Organization the collector represents."),
+  storageLocation: z.string().optional().describe("Where the evidence is currently stored."),
+  chainOfCustody: ChainOfCustodySchema.optional(),
+  analysisPerformed: z.array(z.string()).optional().describe('Analyses run on the evidence (e.g. "isotopic analysis", "spectroscopy").'),
+  analysisResults: z.string().optional().describe("Summary of what the analyses found."),
+  photographed: z.boolean().optional().describe("Whether the evidence was photographed in situ or in the lab."),
+  labReport: z.boolean().optional().describe("Whether a formal laboratory report exists."),
+  notes: z.string().optional().describe("Free-text context about the evidence item.")
+}).meta({ id: "PhysicalEvidenceItem" }).describe("A physical artifact associated with an observation and its handling record.");
+var DocumentTypeSchema = z.enum([
+  "foia_release",
+  "official_report",
+  "congressional_record",
+  "military_memo",
+  "intelligence_assessment",
+  "inspector_general",
+  "presidential_directive",
+  "executive_order",
+  "declassified_cable",
+  "investigation_file",
+  "other"
+]).describe("Kind of government/official document.");
+var DocumentMetadataSchema = z.object({
+  documentType: DocumentTypeSchema,
+  classificationLevel: z.string().optional().describe('Current classification of the document (e.g. "UNCLASSIFIED", "SECRET//NOFORN").'),
+  originatingAgency: z.string().optional().describe("Agency that produced the document."),
+  controlNumbers: z.array(z.string()).optional().describe("Agency control or tracking numbers stamped on the document."),
+  foiaRequestNumber: z.string().optional().describe("FOIA request number that produced the document."),
+  declassificationDate: z.string().optional().describe("When the document was declassified (ISO date)."),
+  originalClassification: z.string().optional().describe("Classification the document carried when created."),
+  pageCount: z.number().optional().describe("Number of pages in the document."),
+  redactionLevel: z.enum(["none", "partial", "heavy", "unknown"]).optional().describe("How much of the document is redacted.")
+}).meta({ id: "DocumentMetadata" }).describe("Provenance metadata for a source document (classification, agency, redaction).");
+var ObjectShapeSchema = z.enum([
+  "sphere",
+  "orb",
+  "disc",
+  "saucer",
+  "oval",
+  "egg",
+  "cylinder",
+  "cigar",
+  "tic_tac",
+  "triangle",
+  "delta",
+  "boomerang",
+  "chevron",
+  "diamond",
+  "rectangle",
+  "square",
+  "cube",
+  "cross",
+  "star",
+  "amorphous",
+  "changing",
+  "light_only",
+  "other",
+  "unknown"
+]).describe("Reported shape of the observed object.");
+var ObjectCharacteristicsSchema = z.object({
+  shape: ObjectShapeSchema.optional(),
+  size: z.string().optional().describe('Apparent size as reported (e.g. "size of a commercial airliner").'),
+  sizeMeters: z.number().optional().describe("Estimated size of the object, in meters."),
+  color: z.string().optional().describe("Primary color of the object as reported."),
+  secondaryColors: z.array(z.string()).optional().describe("Additional colors observed on the object."),
+  luminosity: z.string().optional().describe('Light emission as reported (e.g. "glowing white", "self-luminous", "no lights").'),
+  sound: z.string().optional().describe('Whether and what sound the object produced (e.g. "silent", "humming").'),
+  soundDescription: z.string().optional().describe("Fuller free-text description of any sound."),
+  surfaceDetails: z.string().optional().describe('Visible surface features (e.g. "metallic, seamless, no rivets or seams").'),
+  numberObserved: z.number().optional().describe("How many objects were observed."),
+  formation: z.string().optional().describe('Geometric arrangement when multiple objects were observed (e.g. "triangular formation").'),
+  structuralFeatures: z.array(z.string()).optional().describe('Distinct structural elements reported (e.g. "dome", "portholes", "appendages").')
+}).meta({ id: "ObjectCharacteristics" }).describe("Physical description of the observed object(s).");
+var ManeuverTypeSchema = z.enum([
+  "hover",
+  "instant_acceleration",
+  "instant_stop",
+  "right_angle_turn",
+  "zigzag",
+  "pendulum",
+  "split",
+  "merge",
+  "disappear",
+  "appear",
+  "transmedium_entry",
+  "transmedium_exit",
+  "vertical_ascent",
+  "vertical_descent",
+  "rotation",
+  "wobble",
+  "other"
+]).describe("A distinctive movement/maneuver exhibited by the object.");
+var MovementSchema = z.object({
+  speed: z.string().optional().describe('Speed as reported (e.g. "faster than any known aircraft").'),
+  speedKmh: z.number().optional().describe("Estimated speed, in kilometers per hour."),
+  altitude: z.string().optional().describe('Altitude as reported (e.g. "treetop level", "very high").'),
+  altitudeMeters: z.number().optional().describe("Estimated altitude of the object, in meters."),
+  heading: z.number().optional().describe("Direction of travel, in compass degrees (0\u2013360)."),
+  flightPath: z.string().optional().describe('Narrative of the object\u2019s path through the encounter (e.g. "descended from 80,000 ft to sea level").'),
+  maneuvers: z.array(ManeuverTypeSchema).optional().describe("Distinctive maneuvers exhibited, from the typed vocabulary."),
+  maneuverDescriptions: z.array(z.string()).optional().describe("Free-text descriptions elaborating on the typed maneuvers."),
+  radarData: z.boolean().optional().describe("Whether the movement was tracked on radar."),
+  infraredSignature: z.boolean().optional().describe("Whether the object showed an infrared signature."),
+  trajectory: z.string().optional().describe('Overall trajectory summary (e.g. "erratic", "straight and level").')
+}).meta({ id: "Movement" }).describe("How the object moved \u2014 kinematics and notable maneuvers.");
+var InvestigationSchema = z.object({
+  investigatingBody: z.string().optional().describe('Primary organization that investigated (e.g. "AARO", "Project Blue Book").'),
+  investigatingBodies: z.array(z.string()).optional().describe("All organizations that investigated, when more than one."),
+  caseNumber: z.string().optional().describe("Case or file number assigned by the investigating body."),
+  investigationDate: z.string().optional().describe("When the investigation was conducted (ISO date)."),
+  conclusion: z.string().optional().describe('Official conclusion reached (e.g. "unidentified", "weather balloon").'),
+  confidence: ConfidenceLevelSchema.optional(),
+  methodologies: z.array(z.string()).optional().describe('Methods used (e.g. "witness interviews", "radar data analysis").'),
+  findings: z.string().optional().describe("Summary of what the investigation found."),
+  recommendations: z.string().optional().describe("Recommendations issued by the investigation.")
+}).meta({ id: "Investigation" }).describe("Official/independent investigation of the observation.");
+var WitnessesSchema = z.object({
+  count: z.number().optional().describe("Total number of witnesses."),
+  categories: z.array(z.string()).optional().describe('Kinds of witnesses present (e.g. "military pilots", "radar operators", "civilians").'),
+  militaryWitnesses: z.boolean().optional().describe("Whether any witnesses were military personnel."),
+  aviationWitnesses: z.boolean().optional().describe("Whether any witnesses were pilots or aviation professionals."),
+  multipleIndependent: z.boolean().optional().describe("Whether independent witnesses observed from separate vantage points."),
+  professionalObservers: z.boolean().optional().describe("Whether any witnesses were trained observers (pilots, astronomers, military)."),
+  descriptions: z.array(z.string()).optional().describe("Brief summaries of individual witness accounts.")
+}).meta({ id: "Witnesses" }).describe("Aggregate summary of who witnessed the observation.");
+var ResponseImpactSchema = z.object({
+  officialResponse: z.string().optional().describe("How officials responded (statements, denials, acknowledgments)."),
+  mediaAttention: z.boolean().optional().describe("Whether the observation received media coverage."),
+  publicImpact: z.string().optional().describe("Effect on public awareness or discourse."),
+  policyImpact: z.string().optional().describe("Policy consequences (e.g. hearings, legislation, reporting-process changes)."),
+  militaryResponse: z.string().optional().describe("Military actions taken (e.g. intercept scrambled, alert status changed)."),
+  coverUpAlleged: z.boolean().optional().describe("Whether suppression or concealment of the event has been alleged.")
+}).meta({ id: "ResponseImpact" }).describe("Official, media, and public response to the observation.");
+var EnvironmentSchema = z.object({
+  weather: z.string().optional().describe('General weather conditions (e.g. "clear", "overcast").'),
+  visibility: z.string().optional().describe('Visibility conditions (e.g. "unlimited", "10 miles", "hazy").'),
+  cloudCover: z.string().optional().describe('Cloud cover description (e.g. "scattered at 5,000 ft").'),
+  windSpeed: z.string().optional().describe("Wind conditions as reported."),
+  temperature: z.number().optional().describe("Air temperature, in degrees Celsius."),
+  humidity: z.number().optional().describe("Relative humidity, as a percentage (0\u2013100)."),
+  celestialConditions: z.string().optional().describe("Sky conditions relevant to identification (e.g. visible planets, meteor showers, satellites)."),
+  moonPhase: z.string().optional().describe("Moon phase description at the time of observation."),
+  precipitation: z.string().optional().describe("Precipitation at the time of observation, if any.")
+}).meta({ id: "Environment" }).describe("Environmental and weather conditions at the time of observation.");
+var RelationKindSchema = z.enum([
+  "corroborates",
+  "contradicts",
+  "duplicate_of",
+  "same_object",
+  "supersedes",
+  "superseded_by",
+  "re_analysis_of",
+  "part_of"
+]).describe("How one observation relates to another (typed edge vocabulary).");
+var RelationEdgeSchema = z.object({
+  kind: RelationKindSchema,
+  targetId: z.string().min(1).describe("The `Observation.id` this edge points at."),
+  note: z.string().optional().describe("Free-text context for why the link exists.")
+}).meta({ id: "RelationEdge" }).describe("A typed link from this observation to another.");
+var RelationsSchema = z.object({
+  /** Typed edges to other observations — the standardized way to link records. */
+  edges: z.array(RelationEdgeSchema).optional().describe("Typed edges to other observations \u2014 the standardized way to link records."),
+  /** Named grouping into a flap (a localized cluster of sightings). */
+  flap: z.string().optional().describe("Named grouping into a flap (a localized cluster of sightings)."),
+  /** Named grouping into a wave (a broad temporal surge of sightings). */
+  wave: z.string().optional().describe("Named grouping into a wave (a broad temporal surge of sightings)."),
+  /** Named grouping into an ad-hoc cluster. */
+  cluster: z.string().optional().describe("Named grouping into an ad-hoc cluster."),
+  /** @deprecated Use typed `edges` with `kind: 'corroborates' | 'same_object' | …`. */
+  relatedObservationIds: z.array(z.string()).optional().describe('Deprecated \u2014 use typed `edges` with `kind: "corroborates" | "same_object" | \u2026`.'),
+  /** @deprecated Use typed `edges` with `kind: 'supersedes' | 're_analysis_of' | …`. */
+  precedingEvents: z.array(z.string()).optional().describe('Deprecated \u2014 use typed `edges` with `kind: "supersedes" | "re_analysis_of" | \u2026`.'),
+  /** @deprecated Use typed `edges`. */
+  followingEvents: z.array(z.string()).optional().describe("Deprecated \u2014 use typed `edges`.")
+}).meta({ id: "Relations" }).describe("Typed links to related observations, plus flap/wave/cluster groupings.");
+var AviationSchema = z.object({
+  aircraftType: z.string().optional().describe('Type of aircraft involved (e.g. "F/A-18F Super Hornet").'),
+  aircraftDesignation: z.string().optional().describe("Military designation or tail number of the aircraft."),
+  squadron: z.string().optional().describe("Squadron or unit the aircraft belonged to."),
+  flightMission: z.string().optional().describe('Mission being flown at the time (e.g. "training exercise", "combat air patrol").'),
+  altitude: z.number().optional().describe("Aircraft altitude during the encounter, in meters."),
+  speed: z.number().optional().describe("Aircraft speed during the encounter, in kilometers per hour."),
+  heading: z.number().optional().describe("Aircraft heading during the encounter, in compass degrees (0\u2013360)."),
+  radarContact: z.boolean().optional().describe("Whether the aircraft\u2019s radar held contact with the object."),
+  weaponsSystemEngaged: z.boolean().optional().describe("Whether a weapons system locked onto or tracked the object."),
+  interceptAttempted: z.boolean().optional().describe("Whether an intercept of the object was attempted.")
+}).meta({ id: "Aviation" }).describe("Aviation context when the observation involved aircraft.");
+var SourceDataSchema = z.object({
+  primarySource: SourceReferenceSchema.optional(),
+  sources: z.array(SourceReferenceSchema).optional(),
+  originalClassification: z.string().optional().describe('Original government classification of the source material (e.g. "SECRET").'),
+  declassificationDate: z.string().optional().describe("When the source material was declassified (ISO date)."),
+  foiaRequestId: z.string().optional().describe("FOIA request number that produced the source material."),
+  archiveLocation: z.string().optional().describe("Physical or digital archive where the source material resides.")
+}).meta({ id: "SourceData" }).describe(
+  "Where the observation data came from. Forensic custody/authenticity now lives in the optional `Observation.provenance` slot (@disclosureos/records/extensions/provenance)."
+);
+
+// src/observation/types.ts
+var PublicationStatusSchema = z.enum(["draft", "review", "published", "archived", "retracted"]).describe("Lifecycle/publication state of an observation record.");
+var ObservationSchema = z.object({
+  // === REQUIRED ===
+  id: z.string().min(1).describe("Stable unique identifier for this observation."),
+  temporal: TemporalDataSchema,
+  location: LocationDataSchema,
+  status: PublicationStatusSchema,
+  createdAt: z.string().describe("ISO timestamp when the record was created."),
+  updatedAt: z.string().describe("ISO timestamp when the record was last updated."),
+  // === DESCRIPTIVE ===
+  summary: z.string().optional().describe("One-or-two sentence summary of the observation."),
+  description: z.string().optional().describe("Full narrative account of the observation."),
+  objectCharacteristics: ObjectCharacteristicsSchema.optional(),
+  eventType: z.string().optional().describe(
+    'Local event-type tag (e.g. "multi-sensor military encounter"). The word "classification" is reserved for the origin taxonomy in @disclosureos/origins; this is just a free-text descriptor.'
+  ),
+  sourceData: SourceDataSchema.optional(),
+  investigation: InvestigationSchema.optional(),
+  // === DETAILED ===
+  movement: MovementSchema.optional(),
+  witnesses: WitnessesSchema.optional(),
+  sensorEvidence: SensorEvidenceDataSchema.optional(),
+  responseImpact: ResponseImpactSchema.optional(),
+  environment: EnvironmentSchema.optional(),
+  relations: RelationsSchema.optional(),
+  aviation: AviationSchema.optional(),
+  // === MEDIA ===
+  media: z.array(MediaAttachmentSchema).optional(),
+  featuredMedia: MediaAttachmentSchema.optional(),
+  // === RECORDS-OWNED EXTENSION SLOTS ===
+  // Optional, off-the-hot-path forensic/clerical surfaces. Their schemas live
+  // under @disclosureos/records/extensions/* (subpath-only) and attach here as
+  // plain optional fields (cross-package slots use module augmentation instead).
+  provenance: ProvenanceSchema.optional(),
+  identifiers: CrossReferencesSchema.optional(),
+  testimony: z.array(TestimonyStatementSchema).optional(),
+  physicalEvidence: z.array(PhysicalEvidenceItemSchema).optional(),
+  documents: z.array(DocumentMetadataSchema).optional(),
+  // === METADATA ===
+  dataSourceId: z.string().optional().describe("Identifier of the dataset or pipeline this record came from."),
+  schemaVersion: z.string().optional().describe("Version of the records schema this record was authored against."),
+  extensions: z.record(z.string(), z.unknown()).optional().describe("Third-party extension bag for slots not owned by a first-party package."),
+  internalNotes: z.string().optional().describe("Private working notes for maintainers \u2014 not part of the public record.")
+}).meta({ id: "Observation" }).describe("A single UAP observation record \u2014 the core unit of the DisclosureOS lexicon.");
+
+export { AviationSchema, DetectionMethodSchema, EnvironmentSchema, InvestigationSchema, ManeuverTypeSchema, MovementSchema, ObjectCharacteristicsSchema, ObjectShapeSchema, ObservationSchema, PublicationStatusSchema, RelationEdgeSchema, RelationKindSchema, RelationsSchema, ResponseImpactSchema, SensorEvidenceDataSchema, SensorReadingSchema, SensorTypeSchema, SourceDataSchema, WitnessesSchema };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map