@disclosureos/records 1.0.0

package/dist/extensions/testimony/index.d.ts

@@ -0,0 +1,400 @@
+import { z } from 'zod';
+
+declare const WitnessCategorySchema: z.ZodEnum<{
+    unknown: "unknown";
+    military_other: "military_other";
+    military_pilot: "military_pilot";
+    military_aircrew: "military_aircrew";
+    military_ground: "military_ground";
+    military_naval: "military_naval";
+    military_radar_operator: "military_radar_operator";
+    commercial_pilot: "commercial_pilot";
+    commercial_aircrew: "commercial_aircrew";
+    private_pilot: "private_pilot";
+    air_traffic_controller: "air_traffic_controller";
+    aviation_other: "aviation_other";
+    government_official: "government_official";
+    elected_official: "elected_official";
+    intelligence_officer: "intelligence_officer";
+    law_enforcement: "law_enforcement";
+    scientist: "scientist";
+    astronomer: "astronomer";
+    meteorologist: "meteorologist";
+    engineer: "engineer";
+    medical_professional: "medical_professional";
+    maritime: "maritime";
+    civilian: "civilian";
+    civilian_group: "civilian_group";
+    anonymous: "anonymous";
+}>;
+type WitnessCategory = z.infer<typeof WitnessCategorySchema>;
+
+declare const CredibilityFactorSchema: z.ZodEnum<{
+    professional_training: "professional_training";
+    official_capacity: "official_capacity";
+    sworn_statement: "sworn_statement";
+    contemporaneous_record: "contemporaneous_record";
+    corroborating_witnesses: "corroborating_witnesses";
+    corroborating_evidence: "corroborating_evidence";
+    consistent_account: "consistent_account";
+    no_apparent_motive: "no_apparent_motive";
+    reputation_risk: "reputation_risk";
+    security_clearance: "security_clearance";
+}>;
+type CredibilityFactor = z.infer<typeof CredibilityFactorSchema>;
+declare const CredibilityDetractorSchema: z.ZodEnum<{
+    anonymous: "anonymous";
+    inconsistent_account: "inconsistent_account";
+    delayed_report: "delayed_report";
+    known_fabricator: "known_fabricator";
+    financial_motive: "financial_motive";
+    single_witness: "single_witness";
+    impaired_state: "impaired_state";
+    recovered_memory: "recovered_memory";
+}>;
+type CredibilityDetractor = z.infer<typeof CredibilityDetractorSchema>;
+declare const WitnessCredibilitySchema: z.ZodObject<{
+    rating: z.ZodOptional<z.ZodEnum<{
+        high: "high";
+        moderate: "moderate";
+        low: "low";
+        unassessed: "unassessed";
+        very_high: "very_high";
+        very_low: "very_low";
+    }>>;
+    factors: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        professional_training: "professional_training";
+        official_capacity: "official_capacity";
+        sworn_statement: "sworn_statement";
+        contemporaneous_record: "contemporaneous_record";
+        corroborating_witnesses: "corroborating_witnesses";
+        corroborating_evidence: "corroborating_evidence";
+        consistent_account: "consistent_account";
+        no_apparent_motive: "no_apparent_motive";
+        reputation_risk: "reputation_risk";
+        security_clearance: "security_clearance";
+    }>>>;
+    detractors: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        anonymous: "anonymous";
+        inconsistent_account: "inconsistent_account";
+        delayed_report: "delayed_report";
+        known_fabricator: "known_fabricator";
+        financial_motive: "financial_motive";
+        single_witness: "single_witness";
+        impaired_state: "impaired_state";
+        recovered_memory: "recovered_memory";
+    }>>>;
+    isProfessionalObserver: z.ZodOptional<z.ZodBoolean>;
+    hasAviationExperience: z.ZodOptional<z.ZodBoolean>;
+    hasMilitaryExperience: z.ZodOptional<z.ZodBoolean>;
+    hasScientificBackground: z.ZodOptional<z.ZodBoolean>;
+    hasPriorUAPKnowledge: z.ZodOptional<z.ZodBoolean>;
+    wasSkepticPrior: z.ZodOptional<z.ZodBoolean>;
+    underOathTestimony: z.ZodOptional<z.ZodBoolean>;
+    polygraphAdministered: z.ZodOptional<z.ZodBoolean>;
+    polygraphPassed: z.ZodOptional<z.ZodBoolean>;
+    consistentTestimony: z.ZodOptional<z.ZodBoolean>;
+    willingToBeIdentified: z.ZodOptional<z.ZodBoolean>;
+    notes: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type WitnessCredibility = z.infer<typeof WitnessCredibilitySchema>;
+
+declare const SecurityClearanceSchema: z.ZodEnum<{
+    unknown: "unknown";
+    none: "none";
+    confidential: "confidential";
+    secret: "secret";
+    top_secret: "top_secret";
+    sci: "sci";
+}>;
+type SecurityClearance = z.infer<typeof SecurityClearanceSchema>;
+declare const WitnessSchema: z.ZodObject<{
+    witnessId: z.ZodString;
+    category: z.ZodEnum<{
+        unknown: "unknown";
+        military_other: "military_other";
+        military_pilot: "military_pilot";
+        military_aircrew: "military_aircrew";
+        military_ground: "military_ground";
+        military_naval: "military_naval";
+        military_radar_operator: "military_radar_operator";
+        commercial_pilot: "commercial_pilot";
+        commercial_aircrew: "commercial_aircrew";
+        private_pilot: "private_pilot";
+        air_traffic_controller: "air_traffic_controller";
+        aviation_other: "aviation_other";
+        government_official: "government_official";
+        elected_official: "elected_official";
+        intelligence_officer: "intelligence_officer";
+        law_enforcement: "law_enforcement";
+        scientist: "scientist";
+        astronomer: "astronomer";
+        meteorologist: "meteorologist";
+        engineer: "engineer";
+        medical_professional: "medical_professional";
+        maritime: "maritime";
+        civilian: "civilian";
+        civilian_group: "civilian_group";
+        anonymous: "anonymous";
+    }>;
+    anonymous: z.ZodBoolean;
+    publicName: z.ZodOptional<z.ZodString>;
+    pseudonym: z.ZodOptional<z.ZodString>;
+    role: z.ZodOptional<z.ZodString>;
+    organization: z.ZodOptional<z.ZodString>;
+    experienceYears: z.ZodOptional<z.ZodNumber>;
+    securityClearance: z.ZodOptional<z.ZodEnum<{
+        unknown: "unknown";
+        none: "none";
+        confidential: "confidential";
+        secret: "secret";
+        top_secret: "top_secret";
+        sci: "sci";
+    }>>;
+    credibility: z.ZodOptional<z.ZodObject<{
+        rating: z.ZodOptional<z.ZodEnum<{
+            high: "high";
+            moderate: "moderate";
+            low: "low";
+            unassessed: "unassessed";
+            very_high: "very_high";
+            very_low: "very_low";
+        }>>;
+        factors: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            professional_training: "professional_training";
+            official_capacity: "official_capacity";
+            sworn_statement: "sworn_statement";
+            contemporaneous_record: "contemporaneous_record";
+            corroborating_witnesses: "corroborating_witnesses";
+            corroborating_evidence: "corroborating_evidence";
+            consistent_account: "consistent_account";
+            no_apparent_motive: "no_apparent_motive";
+            reputation_risk: "reputation_risk";
+            security_clearance: "security_clearance";
+        }>>>;
+        detractors: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            anonymous: "anonymous";
+            inconsistent_account: "inconsistent_account";
+            delayed_report: "delayed_report";
+            known_fabricator: "known_fabricator";
+            financial_motive: "financial_motive";
+            single_witness: "single_witness";
+            impaired_state: "impaired_state";
+            recovered_memory: "recovered_memory";
+        }>>>;
+        isProfessionalObserver: z.ZodOptional<z.ZodBoolean>;
+        hasAviationExperience: z.ZodOptional<z.ZodBoolean>;
+        hasMilitaryExperience: z.ZodOptional<z.ZodBoolean>;
+        hasScientificBackground: z.ZodOptional<z.ZodBoolean>;
+        hasPriorUAPKnowledge: z.ZodOptional<z.ZodBoolean>;
+        wasSkepticPrior: z.ZodOptional<z.ZodBoolean>;
+        underOathTestimony: z.ZodOptional<z.ZodBoolean>;
+        polygraphAdministered: z.ZodOptional<z.ZodBoolean>;
+        polygraphPassed: z.ZodOptional<z.ZodBoolean>;
+        consistentTestimony: z.ZodOptional<z.ZodBoolean>;
+        willingToBeIdentified: z.ZodOptional<z.ZodBoolean>;
+        notes: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    statementSummary: z.ZodOptional<z.ZodString>;
+    interviewAvailable: z.ZodOptional<z.ZodBoolean>;
+    writtenReportAvailable: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+type Witness = z.infer<typeof WitnessSchema>;
+
+declare const TestimonyContextSchema: z.ZodEnum<{
+    congressional_testimony: "congressional_testimony";
+    sworn_affidavit: "sworn_affidavit";
+    deposition: "deposition";
+    official_interview: "official_interview";
+    written_statement: "written_statement";
+    recorded_interview: "recorded_interview";
+    informal_account: "informal_account";
+    anonymous_tip: "anonymous_tip";
+    whistleblower_disclosure: "whistleblower_disclosure";
+}>;
+type TestimonyContext = z.infer<typeof TestimonyContextSchema>;
+declare const TestimonyDateSchema: z.ZodObject<{
+    date: z.ZodString;
+    certainty: z.ZodEnum<{
+        exact: "exact";
+        approximate: "approximate";
+        estimated: "estimated";
+        unknown: "unknown";
+    }>;
+}, z.core.$strip>;
+type TestimonyDate = z.infer<typeof TestimonyDateSchema>;
+declare const TestimonyStatementSchema: z.ZodObject<{
+    statementId: z.ZodString;
+    witness: z.ZodObject<{
+        witnessId: z.ZodString;
+        category: z.ZodEnum<{
+            unknown: "unknown";
+            military_other: "military_other";
+            military_pilot: "military_pilot";
+            military_aircrew: "military_aircrew";
+            military_ground: "military_ground";
+            military_naval: "military_naval";
+            military_radar_operator: "military_radar_operator";
+            commercial_pilot: "commercial_pilot";
+            commercial_aircrew: "commercial_aircrew";
+            private_pilot: "private_pilot";
+            air_traffic_controller: "air_traffic_controller";
+            aviation_other: "aviation_other";
+            government_official: "government_official";
+            elected_official: "elected_official";
+            intelligence_officer: "intelligence_officer";
+            law_enforcement: "law_enforcement";
+            scientist: "scientist";
+            astronomer: "astronomer";
+            meteorologist: "meteorologist";
+            engineer: "engineer";
+            medical_professional: "medical_professional";
+            maritime: "maritime";
+            civilian: "civilian";
+            civilian_group: "civilian_group";
+            anonymous: "anonymous";
+        }>;
+        anonymous: z.ZodBoolean;
+        publicName: z.ZodOptional<z.ZodString>;
+        pseudonym: z.ZodOptional<z.ZodString>;
+        role: z.ZodOptional<z.ZodString>;
+        organization: z.ZodOptional<z.ZodString>;
+        experienceYears: z.ZodOptional<z.ZodNumber>;
+        securityClearance: z.ZodOptional<z.ZodEnum<{
+            unknown: "unknown";
+            none: "none";
+            confidential: "confidential";
+            secret: "secret";
+            top_secret: "top_secret";
+            sci: "sci";
+        }>>;
+        credibility: z.ZodOptional<z.ZodObject<{
+            rating: z.ZodOptional<z.ZodEnum<{
+                high: "high";
+                moderate: "moderate";
+                low: "low";
+                unassessed: "unassessed";
+                very_high: "very_high";
+                very_low: "very_low";
+            }>>;
+            factors: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                professional_training: "professional_training";
+                official_capacity: "official_capacity";
+                sworn_statement: "sworn_statement";
+                contemporaneous_record: "contemporaneous_record";
+                corroborating_witnesses: "corroborating_witnesses";
+                corroborating_evidence: "corroborating_evidence";
+                consistent_account: "consistent_account";
+                no_apparent_motive: "no_apparent_motive";
+                reputation_risk: "reputation_risk";
+                security_clearance: "security_clearance";
+            }>>>;
+            detractors: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                anonymous: "anonymous";
+                inconsistent_account: "inconsistent_account";
+                delayed_report: "delayed_report";
+                known_fabricator: "known_fabricator";
+                financial_motive: "financial_motive";
+                single_witness: "single_witness";
+                impaired_state: "impaired_state";
+                recovered_memory: "recovered_memory";
+            }>>>;
+            isProfessionalObserver: z.ZodOptional<z.ZodBoolean>;
+            hasAviationExperience: z.ZodOptional<z.ZodBoolean>;
+            hasMilitaryExperience: z.ZodOptional<z.ZodBoolean>;
+            hasScientificBackground: z.ZodOptional<z.ZodBoolean>;
+            hasPriorUAPKnowledge: z.ZodOptional<z.ZodBoolean>;
+            wasSkepticPrior: z.ZodOptional<z.ZodBoolean>;
+            underOathTestimony: z.ZodOptional<z.ZodBoolean>;
+            polygraphAdministered: z.ZodOptional<z.ZodBoolean>;
+            polygraphPassed: z.ZodOptional<z.ZodBoolean>;
+            consistentTestimony: z.ZodOptional<z.ZodBoolean>;
+            willingToBeIdentified: z.ZodOptional<z.ZodBoolean>;
+            notes: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        statementSummary: z.ZodOptional<z.ZodString>;
+        interviewAvailable: z.ZodOptional<z.ZodBoolean>;
+        writtenReportAvailable: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>;
+    context: z.ZodEnum<{
+        congressional_testimony: "congressional_testimony";
+        sworn_affidavit: "sworn_affidavit";
+        deposition: "deposition";
+        official_interview: "official_interview";
+        written_statement: "written_statement";
+        recorded_interview: "recorded_interview";
+        informal_account: "informal_account";
+        anonymous_tip: "anonymous_tip";
+        whistleblower_disclosure: "whistleblower_disclosure";
+    }>;
+    date: z.ZodObject<{
+        date: z.ZodString;
+        certainty: z.ZodEnum<{
+            exact: "exact";
+            approximate: "approximate";
+            estimated: "estimated";
+            unknown: "unknown";
+        }>;
+    }, z.core.$strip>;
+    content: z.ZodOptional<z.ZodString>;
+    summary: z.ZodOptional<z.ZodString>;
+    sourceDocument: z.ZodOptional<z.ZodObject<{
+        sourceId: z.ZodString;
+        type: z.ZodEnum<{
+            other: "other";
+            foia: "foia";
+            official_report: "official_report";
+            official_statement: "official_statement";
+            congressional_testimony: "congressional_testimony";
+            congressional_report: "congressional_report";
+            military_document: "military_document";
+            intelligence_document: "intelligence_document";
+            whistleblower: "whistleblower";
+            firsthand_witness: "firsthand_witness";
+            secondhand_account: "secondhand_account";
+            news_article: "news_article";
+            documentary: "documentary";
+            interview: "interview";
+            book: "book";
+            academic_paper: "academic_paper";
+            investigation_report: "investigation_report";
+            database_entry: "database_entry";
+            social_media: "social_media";
+            website: "website";
+        }>;
+        title: z.ZodString;
+        author: z.ZodOptional<z.ZodString>;
+        organization: z.ZodOptional<z.ZodString>;
+        date: z.ZodOptional<z.ZodString>;
+        url: z.ZodOptional<z.ZodString>;
+        archiveUrl: z.ZodOptional<z.ZodString>;
+        reference: z.ZodOptional<z.ZodString>;
+        credibility: z.ZodEnum<{
+            unknown: "unknown";
+            verified: "verified";
+            unverified: "unverified";
+            official: "official";
+            credible: "credible";
+            questionable: "questionable";
+            disputed: "disputed";
+        }>;
+        isPrimarySource: z.ZodOptional<z.ZodBoolean>;
+        classificationLevel: z.ZodOptional<z.ZodString>;
+        notes: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    chainOfCustody: z.ZodOptional<z.ZodEnum<{
+        unknown: "unknown";
+        destroyed: "destroyed";
+        classified: "classified";
+        verified: "verified";
+        partial: "partial";
+        unverified: "unverified";
+        government_held: "government_held";
+        private_held: "private_held";
+        lost: "lost";
+    }>>;
+    additionalEvidenceIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+type TestimonyStatement = z.infer<typeof TestimonyStatementSchema>;
+
+export { type CredibilityDetractor, CredibilityDetractorSchema, type CredibilityFactor, CredibilityFactorSchema, type SecurityClearance, SecurityClearanceSchema, type TestimonyContext, TestimonyContextSchema, type TestimonyDate, TestimonyDateSchema, type TestimonyStatement, TestimonyStatementSchema, type Witness, type WitnessCategory, WitnessCategorySchema, type WitnessCredibility, WitnessCredibilitySchema, WitnessSchema };

package/dist/extensions/testimony/index.js

@@ -0,0 +1,203 @@
+import { z } from 'zod';
+
+// src/extensions/testimony/category.ts
+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 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 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.");
+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 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.");
+
+export { CredibilityDetractorSchema, CredibilityFactorSchema, SecurityClearanceSchema, TestimonyContextSchema, TestimonyDateSchema, TestimonyStatementSchema, WitnessCategorySchema, WitnessCredibilitySchema, WitnessSchema };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/extensions/testimony/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/extensions/testimony/category.ts","../../../src/shared/confidence-level.ts","../../../src/extensions/testimony/credibility.ts","../../../src/extensions/testimony/witness.ts","../../../src/temporal/certainty.ts","../../../src/extensions/provenance/custody.ts","../../../src/source/types.ts","../../../src/source/credibility.ts","../../../src/source/reference.ts","../../../src/extensions/testimony/statement.ts"],"names":["z"],"mappings":"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","file":"index.js","sourcesContent":["import { z } from 'zod';\n\nexport const WitnessCategorySchema = z\n  .enum([\n    'military_pilot',\n    'military_aircrew',\n    'military_ground',\n    'military_naval',\n    'military_radar_operator',\n    'military_other',\n    'commercial_pilot',\n    'commercial_aircrew',\n    'private_pilot',\n    'air_traffic_controller',\n    'aviation_other',\n    'government_official',\n    'elected_official',\n    'intelligence_officer',\n    'law_enforcement',\n    'scientist',\n    'astronomer',\n    'meteorologist',\n    'engineer',\n    'medical_professional',\n    'maritime',\n    'civilian',\n    'civilian_group',\n    'anonymous',\n    'unknown',\n  ])\n  .describe('Professional/role category of a witness.');\n\nexport type WitnessCategory = z.infer<typeof WitnessCategorySchema>;\n","import { z } from 'zod';\n\n/**\n * The single qualitative confidence magnitude for the ecosystem.\n * Merges the former `ConfidenceLevel` (investigation) and `CredibilityRating`\n * (testimony) — which were byte-identical — plus the inline high/medium/low\n * scales in `provenance/digital`.\n *\n * Distinct from `SourceCredibility` (trust tier), `TemporalCertainty` (time\n * precision), and `AssessmentLevel` (evidentiary tier) — those are the other\n * three orthogonal axes and are intentionally NOT merged here.\n */\nexport const ConfidenceLevelSchema = z\n  .enum(['very_high', 'high', 'moderate', 'low', 'very_low', 'unassessed'])\n  .describe('Qualitative confidence magnitude.');\n\nexport type ConfidenceLevel = z.infer<typeof ConfidenceLevelSchema>;\n\nexport const CONFIDENCE_LEVELS = ConfidenceLevelSchema.options;\n\nexport function isConfidenceLevel(value: unknown): value is ConfidenceLevel {\n  return ConfidenceLevelSchema.safeParse(value).success;\n}\n","import { z } from 'zod';\nimport { ConfidenceLevelSchema } from '../../shared';\n\nexport const CredibilityFactorSchema = z\n  .enum([\n    'professional_training',\n    'official_capacity',\n    'sworn_statement',\n    'contemporaneous_record',\n    'corroborating_witnesses',\n    'corroborating_evidence',\n    'consistent_account',\n    'no_apparent_motive',\n    'reputation_risk',\n    'security_clearance',\n  ])\n  .describe('A factor strengthening witness credibility.');\n\nexport type CredibilityFactor = z.infer<typeof CredibilityFactorSchema>;\n\nexport const CredibilityDetractorSchema = z\n  .enum([\n    'anonymous',\n    'inconsistent_account',\n    'delayed_report',\n    'known_fabricator',\n    'financial_motive',\n    'single_witness',\n    'impaired_state',\n    'recovered_memory',\n  ])\n  .describe('A factor weakening witness credibility.');\n\nexport type CredibilityDetractor = z.infer<typeof CredibilityDetractorSchema>;\n\nexport const WitnessCredibilitySchema = z\n  .object({\n    // The former `CredibilityRating` was byte-identical to the qualitative\n    // `ConfidenceLevel`; it is now the single shared scale (DRY #1).\n    rating: ConfidenceLevelSchema.optional(),\n    factors: z.array(CredibilityFactorSchema).optional(),\n    detractors: z.array(CredibilityDetractorSchema).optional(),\n    isProfessionalObserver: z\n      .boolean()\n      .optional()\n      .describe('Whether the witness is a trained observer (pilot, astronomer, military).'),\n    hasAviationExperience: z.boolean().optional().describe('Whether the witness has aviation experience.'),\n    hasMilitaryExperience: z.boolean().optional().describe('Whether the witness has military experience.'),\n    hasScientificBackground: z.boolean().optional().describe('Whether the witness has a scientific background.'),\n    hasPriorUAPKnowledge: z\n      .boolean()\n      .optional()\n      .describe('Whether the witness had prior knowledge of or interest in UAP before the observation.'),\n    wasSkepticPrior: z\n      .boolean()\n      .optional()\n      .describe('Whether the witness was a skeptic before the observation.'),\n    underOathTestimony: z.boolean().optional().describe('Whether the testimony was given under oath.'),\n    polygraphAdministered: z.boolean().optional().describe('Whether a polygraph was administered.'),\n    polygraphPassed: z.boolean().optional().describe('Whether the witness passed the polygraph.'),\n    consistentTestimony: z\n      .boolean()\n      .optional()\n      .describe('Whether the account has remained consistent across retellings.'),\n    willingToBeIdentified: z\n      .boolean()\n      .optional()\n      .describe('Whether the witness is willing to be publicly identified.'),\n    notes: z.string().optional().describe('Free-text context about the credibility assessment.'),\n  })\n  .meta({ id: 'WitnessCredibility' })\n  .describe('Structured assessment of a witness\\'s credibility (rating, factors, detractors).');\n\nexport type WitnessCredibility = z.infer<typeof WitnessCredibilitySchema>;\n","import { z } from 'zod';\nimport { WitnessCategorySchema } from './category';\nimport { WitnessCredibilitySchema } from './credibility';\n\nexport const SecurityClearanceSchema = z\n  .enum(['none', 'confidential', 'secret', 'top_secret', 'sci', 'unknown'])\n  .describe('Security clearance level held by a witness.');\n\nexport type SecurityClearance = z.infer<typeof SecurityClearanceSchema>;\n\nexport const WitnessSchema = z\n  .object({\n    witnessId: z.string().describe('Stable unique identifier for this witness.'),\n    category: WitnessCategorySchema,\n    anonymous: z.boolean().describe('Whether the witness\\u2019s identity is withheld.'),\n    publicName: z.string().optional().describe('Witness\\u2019s name as publicly known, when not anonymous.'),\n    pseudonym: z.string().optional().describe('Pseudonym used when the witness is anonymous.'),\n    role: z.string().optional().describe('Witness\\u2019s role at the time (e.g. \"F/A-18F pilot\", \"radar operator\").'),\n    organization: z.string().optional().describe('Organization the witness belonged to at the time.'),\n    experienceYears: z.number().optional().describe('Years of relevant professional experience.'),\n    securityClearance: SecurityClearanceSchema.optional(),\n    credibility: WitnessCredibilitySchema.optional(),\n    statementSummary: z.string().optional().describe('Brief summary of what the witness reported.'),\n    interviewAvailable: z.boolean().optional().describe('Whether a recorded interview with the witness exists.'),\n    writtenReportAvailable: z.boolean().optional().describe('Whether a written report from the witness exists.'),\n  })\n  .meta({ id: 'Witness' })\n  .describe('A person who reported or corroborated an observation.');\n\nexport type Witness = z.infer<typeof WitnessSchema>;\n","import { z } from 'zod';\n\n/**\n * How confident we are in a date or time value.\n *\n * The single certainty scale for all temporal values in the model —\n * `TemporalData.date`/`time`, `FuzzyDate`, `DateRange` bounds, and testimony\n * dates all use it.\n */\nexport const TemporalCertaintySchema = z\n  .enum(['exact', 'approximate', 'estimated', 'unknown'])\n  .describe('Confidence in a date or time value — the single certainty scale for all temporal values.');\n\nexport type TemporalCertainty = z.infer<typeof TemporalCertaintySchema>;\n","import { z } from 'zod';\n\nexport const ChainOfCustodySchema = z\n  .enum([\n    'verified',\n    'partial',\n    'unverified',\n    'government_held',\n    'private_held',\n    'lost',\n    'destroyed',\n    'classified',\n    'unknown',\n  ])\n  .describe('Custody status of an evidence item.');\n\nexport type ChainOfCustody = z.infer<typeof ChainOfCustodySchema>;\n\nexport const CustodyActionSchema = z\n  .enum([\n    'creation',\n    'collection',\n    'transfer',\n    'storage',\n    'analysis',\n    'release',\n    'classification',\n    'destruction',\n    'loss',\n    'recovery',\n    'other',\n  ])\n  .describe('An action recorded in a chain-of-custody entry.');\n\nexport type CustodyAction = z.infer<typeof CustodyActionSchema>;\n\nexport const CustodyEntrySchema = z\n  .object({\n    entryId: z.string().describe('Stable unique identifier for this custody entry.'),\n    date: z.string().describe('When the custody event occurred (ISO date).'),\n    action: CustodyActionSchema,\n    from: z.string().optional().describe('Party that held the evidence before this event.'),\n    to: z.string().optional().describe('Party that held the evidence after this event.'),\n    location: z.string().optional().describe('Where the custody event took place.'),\n    reference: z\n      .string()\n      .optional()\n      .describe('Document or record substantiating the event (e.g. transfer receipt, log entry).'),\n    notes: z.string().optional().describe('Free-text context about the event.'),\n  })\n  .meta({ id: 'CustodyEntry' })\n  .describe('A single custody event for an evidence item.');\n\nexport type CustodyEntry = z.infer<typeof CustodyEntrySchema>;\n\nexport const ChainOfCustodyRecordSchema = z\n  .object({\n    evidenceId: z.string().describe('Identifier of the evidence item this custody history belongs to.'),\n    status: ChainOfCustodySchema,\n    entries: z.array(CustodyEntrySchema),\n  })\n  .meta({ id: 'ChainOfCustodyRecord' })\n  .describe('The full custody history for a piece of evidence.');\n\nexport type ChainOfCustodyRecord = z.infer<typeof ChainOfCustodyRecordSchema>;\n","import { z } from 'zod';\n\nexport const SourceTypeSchema = z\n  .enum([\n    'foia',\n    'official_report',\n    'official_statement',\n    'congressional_testimony',\n    'congressional_report',\n    'military_document',\n    'intelligence_document',\n    'whistleblower',\n    'firsthand_witness',\n    'secondhand_account',\n    'news_article',\n    'documentary',\n    'interview',\n    'book',\n    'academic_paper',\n    'investigation_report',\n    'database_entry',\n    'social_media',\n    'website',\n    'other',\n  ])\n  .describe('Kind of source backing an observation (document, testimony, media, etc.).');\n\nexport type SourceType = z.infer<typeof SourceTypeSchema>;\n","import { z } from 'zod';\n\nexport const SourceCredibilitySchema = z\n  .enum(['official', 'verified', 'credible', 'unverified', 'questionable', 'disputed', 'unknown'])\n  .describe('Trust tier of a source — an orthogonal axis to confidence and temporal certainty.');\n\nexport type SourceCredibility = z.infer<typeof SourceCredibilitySchema>;\n","import { z } from 'zod';\nimport { SourceTypeSchema } from './types';\nimport { SourceCredibilitySchema } from './credibility';\n\nexport const SourceReferenceSchema = z\n  .object({\n    sourceId: z.string().describe('Stable unique identifier for this source.'),\n    type: SourceTypeSchema,\n    title: z.string().describe('Title of the source document, article, or material.'),\n    author: z.string().optional().describe('Author of the source material.'),\n    organization: z.string().optional().describe('Organization that produced or published the source.'),\n    date: z.string().optional().describe('Publication or creation date of the source (ISO date).'),\n    url: z.string().optional().describe('Link to the source material.'),\n    archiveUrl: z.string().optional().describe('Archived copy of the source (e.g. Wayback Machine), in case the original disappears.'),\n    reference: z\n      .string()\n      .optional()\n      .describe('Citation locator within the source (e.g. page number, document section).'),\n    credibility: SourceCredibilitySchema,\n    isPrimarySource: z\n      .boolean()\n      .optional()\n      .describe('Whether this is a primary source (original document/recording) rather than secondary reporting.'),\n    classificationLevel: z\n      .string()\n      .optional()\n      .describe('Government classification of the source, if it was ever classified.'),\n    notes: z.string().optional().describe('Free-text context about the source.'),\n  })\n  .meta({ id: 'SourceReference' })\n  .describe('A citation/source backing an observation, with its credibility tier.');\n\nexport type SourceReference = z.infer<typeof SourceReferenceSchema>;\n","import { z } from 'zod';\nimport { TemporalCertaintySchema } from '../../temporal/certainty';\nimport { ChainOfCustodySchema } from '../provenance/custody';\nimport { SourceReferenceSchema } from '../../source/reference';\nimport { WitnessSchema } from './witness';\n\nexport const TestimonyContextSchema = z\n  .enum([\n    'sworn_affidavit',\n    'congressional_testimony',\n    'deposition',\n    'official_interview',\n    'written_statement',\n    'recorded_interview',\n    'informal_account',\n    'anonymous_tip',\n    'whistleblower_disclosure',\n  ])\n  .describe('The setting in which testimony was given.');\n\nexport type TestimonyContext = z.infer<typeof TestimonyContextSchema>;\n\nexport const TestimonyDateSchema = z\n  .object({\n    date: z.string().describe('When the testimony was given (ISO date).'),\n    certainty: TemporalCertaintySchema,\n  })\n  .meta({ id: 'TestimonyDate' })\n  .describe('When testimony was given, with its certainty.');\n\nexport type TestimonyDate = z.infer<typeof TestimonyDateSchema>;\n\nexport const TestimonyStatementSchema = z\n  .object({\n    statementId: z\n      .string()\n      .describe('Stable id, addressable by a claim `evidenceRef` (\"testimony:<statementId>\").'),\n    witness: WitnessSchema,\n    context: TestimonyContextSchema,\n    date: TestimonyDateSchema,\n    content: z.string().optional().describe('Full text of the statement, when available.'),\n    summary: z.string().optional().describe('Brief summary of what the statement asserts.'),\n    sourceDocument: SourceReferenceSchema.optional(),\n    chainOfCustody: ChainOfCustodySchema.optional(),\n    additionalEvidenceIds: z\n      .array(z.string())\n      .optional()\n      .describe('Ids of other evidence items the statement references or supports.'),\n  })\n  .meta({ id: 'TestimonyStatement' })\n  .describe('A single witness statement, its context, and supporting documentation.');\n\nexport type TestimonyStatement = z.infer<typeof TestimonyStatementSchema>;\n"]}