@disclosureos/scoring 2.0.0-beta.2 → 2.0.0-beta.4

package/CHANGELOG.md

@@ -1,5 +1,38 @@
 # Changelog
 
+## 2.0.0-beta.4
+
+### Major Changes
+
+- Revise the V2 observable definitions and support vocabulary directly, and add shared catalog, immutable revision and term references with supplied-byte validation. Keep the chosen term separate from the subject under review and its supporting sources. Export full observable and attributed OCS origin catalogs with retained methodological context. Update enriched-observation and scoring consumers to the revised definitions. This breaks earlier beta definition and support assumptions; it does not establish an anomalous origin or turn a reported characteristic into a confirmed assessment.
+
+### Minor Changes
+
+- Add optional V2 provider score policies and results with exact policy, method, input and derivation pins; distinct unavailable outcomes; provider-defined numeric grade bands and ordinal levels; and supplied-byte validation. A bounded comparison helper checks common policy, subject and input basis without executing methods, authenticating providers, assigning a universal grade or combining competing results.
+
+### Patch Changes
+
+- Updated dependencies [0b00be3]
+- Updated dependencies [9580e62]
+- Updated dependencies [559eac9]
+- Updated dependencies [5a686c1]
+- Updated dependencies [813ee2c]
+- Updated dependencies
+  - @disclosureos/records@2.0.0-beta.4
+  - @disclosureos/observables@2.0.0-beta.4
+  - @disclosureos/origins@2.0.0-beta.4
+  - @disclosureos/instruments@2.0.0-beta.4
+
+## 2.0.0-beta.3
+
+### Patch Changes
+
+- Updated dependencies [4f80b20]
+  - @disclosureos/records@2.0.0-beta.3
+  - @disclosureos/instruments@2.0.0-beta.3
+  - @disclosureos/observables@2.0.0-beta.3
+  - @disclosureos/origins@2.0.0-beta.3
+
 ## 2.0.0-beta.2
 
 ### Patch Changes

package/README.md

@@ -1,5 +1,42 @@
 # @disclosureos/scoring
 
+Retain provider-defined scoring policies and results, then compare only what the declared scales, criteria and inputs permit. Competing provider results remain independent.
+
+This README describes the **2.0.0-beta.4** API. Use one exact package version
+throughout an application. Check [availability](https://os.disclosure.org/v2/docs/installation)
+before installing; a source branch or packed candidate is not proof of npm
+publication. For a candidate that is not yet published, use the verified local
+tarballs. See the [release notes](https://github.com/disclosurefoundation/disclosureos/blob/codex/beta4-release-closure/docs/releases/2.0.0-beta.4.md)
+for scope and verification. Avoid unversioned installs, which can select a different
+API generation through `latest`.
+
+## V2 entry point
+
+Start with `@disclosureos/scoring/experimental/v2` for provider scoring and assessment summaries. Numeric grades, ordinal levels, exact inputs and policy revisions are explicit. Structural checks and bounded comparison do not execute an arbitrary provider policy, authenticate the provider or establish scientific validity. There is no universal anomaly or truth score.
+
+[Implementation guide](https://os.disclosure.org/v2/docs/assessment) · [Availability](https://os.disclosure.org/v2/docs/installation) · [Example viewer](https://os.disclosure.org/showcase)
+
+## Choose a package version
+
+Once this version is available in the registry, install it explicitly:
+
+```sh
+npm install --save-exact @disclosureos/scoring@2.0.0-beta.4
+```
+
+Use the same exact release for all DisclosureOS packages. Before publication,
+review a verified source checkout or its locally packed artifacts. Packages are
+ESM; Node.js 22 is the documented getting-started runtime.
+
+## Additional API reference
+
+<details>
+<summary>Earlier composition APIs and detailed source-workflow reference</summary>
+
+The following reference retains earlier APIs and source checkpoints. It is not the
+V2 first-record tutorial. Installation commands here describe the candidate API
+set; use the availability guidance above until that version is published.
+
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
 
 Reference scoring for the [DisclosureOS](https://github.com/disclosurefoundation)
@@ -7,27 +44,12 @@ ecosystem — the **Scoring** layer. Its legacy `Observation` APIs provide:
 
 - **Population coverage** — the fraction of legacy schema field paths carrying a value.
   Presence does not establish documentation quality or analytical readiness.
-- **Compellingness** — *is it anomalous / non-mundane?* Derived from the observable
-  assessments and origin classification.
+- **Origin-only reference scoring** — a declared weighting of origin hypotheses. It is separate from V2 research summaries and does not establish scientific validity.
 
-## The DisclosureOS model
-
-DisclosureOS is a **six-part standard**. Each part answers one question about an
-observation; `@disclosureos/schema` binds the package-owned pieces into one portable
-contract (a single TS type + JSON Schema + non-stripping parse).
+**Descriptive observable support does not measure anomaly strength.** `score()` and `rankByCompellingness()` reject an observation containing any nonempty observable claim list, including `not_indicated`. They do not substitute zero, infer absence, or allow a weighting override to bypass this boundary. Use V2 attributed assessments and profile evaluation for research results.
 
-| Part | Package surface | Question it answers |
-|---|---|---|
-| **Records** | `@disclosureos/records` | *What was observed?* |
-| **Observables** | `@disclosureos/observables` | *What anomalous characteristics did it show?* |
-| **Origins** | `@disclosureos/origins` | *What might explain it?* |
-| **Claims** | `@disclosureos/records/shared` | *Who assessed it, why, and on what evidence?* |
-| **Scoring** | `@disclosureos/scoring` | *How complete / compelling is the case?* |
-| **Instruments** | `@disclosureos/instruments` | *What hardware produced the data?* |
+## The DisclosureOS model
 
-Supporting packages: **`@disclosureos/schema`** (the portable contract that composes the
-package-owned pieces), **`@disclosureos/cli`** (tooling), and **`@disclosureos/examples`**
-(the runnable golden path). *(You are here: **Scoring**.)*
 
 ## Consumes the foundation (does not augment it)
 
@@ -43,34 +65,30 @@ you those slots typed automatically.
 > with `pnpm --filter @disclosureos/examples golden-path`.
 >
 > **Migrating an existing dataset?** See [`examples/migration-path.ts`](../../examples/migration-path.ts)
-> and the [onboarding workspace](https://os.disclosure.org/onboard).
+> and the [onboarding workspace](https://os.disclosure.org/v2/inspect).
 
 ## Install
 
 ```bash
-pnpm add @disclosureos/scoring @disclosureos/records @disclosureos/observables @disclosureos/origins zod
+pnpm add @disclosureos/scoring@2.0.0-beta.4 @disclosureos/records@2.0.0-beta.4 @disclosureos/observables@2.0.0-beta.4 @disclosureos/origins@2.0.0-beta.4 zod
 ```
 
-## Quick start
-
-The `getPopulationCoverage` name below requires this unreleased checkout or a future
-authorized release containing it. Published consumers can continue using `getCompleteness`.
+## Population coverage
 
 ```typescript
-import { score, getPopulationCoverage, rankByCompellingness } from '@disclosureos/scoring';
-
-const result = score(observation);
-// { score, range: { low, high }, contested, ... }
+import { getPopulationCoverage } from '@disclosureos/scoring';
 
 const coverage = getPopulationCoverage(observation);
 // { percentage, requiredPercentage, missing, ... }
-
-const ranked = rankByCompellingness([obsA, obsB, obsC]); // most-compelling first
 ```
 
-Because evaluative slots hold **arrays of competing claims**, `score()` reports a
-`range` (the spread across claims) and a `contested` flag when evaluators disagree —
-not just a single point estimate.
+Coverage counts populated fields. It does not certify documentation quality, anomalous behavior or readiness for an analysis. The `getPopulationCoverage` name requires this checkout or a release containing it; `getCompleteness` is the older name for the same counter.
+
+## Origin-only reference scorer
+
+`score()` remains available for observations without descriptive observable claims. It evaluates declared origin hypotheses under explicit weights and reports the spread across competing classifications. `rankByCompellingness()` applies the same restriction to every input and fails the batch if a descriptive claim would be interpreted as anomaly strength.
+
+Do not remove descriptive claims merely to obtain a score. A characteristic such as apparent hover can describe an ordinary observation; its support tier cannot answer whether the event is anomalous. This implementation retires that automatic inference. It does not introduce a replacement anomaly-scoring methodology.
 
 ## Instrument trust (calibration provenance)
 
@@ -84,8 +102,9 @@ real calibration provenance (`in_practice` / `documented` earn the most; see
 ```typescript
 import { score, calibrationTrust } from '@disclosureos/scoring';
 
-const result = score(observation, {
-  evaluatorWeight: calibrationTrust(observation, [navyManifest]),
+// This observation must contain no descriptive observable claim lists.
+const result = score(originOnlyObservation, {
+  evaluatorWeight: calibrationTrust(originOnlyObservation, [sensorManifest]),
 });
 ```
 
@@ -123,6 +142,21 @@ shared inputs and differing outcome labels. It computes no aggregate score or
 confidence interval and does not certify scientific eligibility. See the
 [assessment summary guide](../../docs/experimental/assessment-summary.md).
 
-The additive population-coverage names are unreleased. See the [coverage guide](../../docs/experimental/population-coverage.md) for retained counting rules, denominator limits and compatibility. The existing compellingness methodology is separate from experimental v2 assessment summaries and profile completion.
+The additive population-coverage names are unreleased. See the [coverage guide](../../docs/experimental/population-coverage.md) for retained counting rules, denominator limits and compatibility. Origin-only reference scoring is separate from experimental V2 assessment summaries and profile completion. Descriptive observable claims are never converted into anomaly strength.
 
 [Assessment-summary provenance and replay](../../docs/experimental/summary-provenance.md) now pin the declared history and computed summary without verifying referenced source artifacts.
+
+## Experimental v2 provider-authored scores (unreleased)
+
+`ProviderScorePolicySchema` and `ProviderScoreResultSchema` retain a provider's
+question, exact method revision, scale, source basis and separate derivation.
+`evaluateProviderScore` validates declarations and supplied bytes without running
+the method. `compareProviderScores` conservatively identifies results with the
+same exact policy and source basis; it does not compute consensus or endorse a
+provider. Numeric grades and ordinal levels are declared by each policy, not
+universal DisclosureOS case grades.
+
+See the [provider scoring guide](../../docs/experimental/provider-scoring.md)
+and [reproducible fictional example](../../examples/provider-scoring/README.md).
+
+</details>

package/dist/compellingness/index.d.ts

@@ -55,10 +55,9 @@ declare function calibrationTrust(observation: Observation, manifests: readonly
 /** Methodology version stamped on every {@link ScoreResult}. Bump on weight/formula changes. */
 declare const SCORING_VERSION: "2.0.0";
 /**
- * Ordinal anomaly strength per evidentiary tier. A `confirmed` signal counts
- * fully; `not_indicated` contributes nothing. Multiplied by the assessment's
- * confidence (default 1 when unstated). Exported so consumers can render the
- * methodology; override semantics may come in a future minor release.
+ * Ordinal support-tier values retained as transparent methodology data.
+ * These values do not establish anomaly strength. The scorer rejects descriptive
+ * observable assessments rather than applying this table to the V2 vocabulary.
  */
 declare const ASSESSMENT_LEVEL_WEIGHTS: Record<AssessmentLevel, number>;
 /**
@@ -126,14 +125,10 @@ interface ScoreOptions {
     evaluatorWeight?: (claim: EvaluatorWeightInput) => number;
 }
 /**
- * Reference compellingness scorer. Combines the strongest technology- and
- * biologics-anomaly signals (from `observableAssessments`) with the confidence in
- * a *non-prosaic* origin classification (from `origin`), under transparent,
- * overridable weights. Each slot is a *list* of competing claims, so the scorer
- * reports a consensus `score`, the `range` of readings across claims, and whether
- * the case is `contested` (evaluators disagree on direction). This answers "how
- * strongly does this case bear on the two public questions — anomalous
- * tech/biologics, and a non-mundane origin?" — distinct from completeness.
+ * Reference scorer for origin-only inputs. Descriptive observable support tiers
+ * cannot supply anomaly strength, so any nonempty observable claim list is rejected.
+ * Use attributed V2 assessments and profile evaluation for research results.
+ * Rejection is not a zero score or a finding that a characteristic is absent.
  */
 declare function score(observation: Observation, options?: ScoreOptions): ScoreResult;
 interface RankedObservation<T extends Observation = Observation> {

package/dist/compellingness/index.js

@@ -104,29 +104,6 @@ function reduceClaims(weighted) {
     contested: anyAnomaly && anyNone
   };
 }
-function observableMagnitude(claim) {
-  return ASSESSMENT_LEVEL_WEIGHTS[claim.level] * (claim.confidence ?? 1);
-}
-function domainStats(group, evaluatorWeight) {
-  if (!group) return EMPTY_STATS;
-  let point = 0;
-  let low = 0;
-  let high = 0;
-  let contested = false;
-  for (const claims of Object.values(group)) {
-    if (!claims || claims.length === 0) continue;
-    const weighted = claims.map((c) => ({
-      magnitude: observableMagnitude(c),
-      weight: (c.confidence ?? 1) * evaluatorWeight(c)
-    }));
-    const stats = reduceClaims(weighted);
-    if (stats.point > point) point = stats.point;
-    if (stats.low > low) low = stats.low;
-    if (stats.high > high) high = stats.high;
-    if (stats.contested) contested = true;
-  }
-  return { point, low, high, contested };
-}
 function originStats(origin, prefixes, evaluatorWeight) {
   if (!origin || origin.length === 0) return EMPTY_STATS;
   const weighted = origin.map((c) => ({
@@ -136,12 +113,16 @@ function originStats(origin, prefixes, evaluatorWeight) {
   return reduceClaims(weighted);
 }
 function score(observation, options) {
+  const assessments = observation.observableAssessments;
+  const hasDescriptiveClaims = [assessments?.technology, assessments?.biologics].some((group) => Object.values(group ?? {}).some((claims) => claims && claims.length > 0));
+  if (hasDescriptiveClaims) {
+    throw new Error("Descriptive observable assessments cannot produce anomaly strength. Use V2 attributed assessments and profile evaluation; this is not a zero or absent result.");
+  }
   const weights = options?.weights ?? DEFAULT_WEIGHTS;
   const prosaicPrefixes = options?.prosaicPrefixes ?? DEFAULT_PROSAIC_OCS_PREFIXES;
   const evaluatorWeight = options?.evaluatorWeight ?? UNIFORM_TRUST;
-  const assessments = observation.observableAssessments;
-  const technology = domainStats(assessments?.technology, evaluatorWeight);
-  const biologics = domainStats(assessments?.biologics, evaluatorWeight);
+  const technology = EMPTY_STATS;
+  const biologics = EMPTY_STATS;
   const origin = originStats(observation.origin, prosaicPrefixes, evaluatorWeight);
   const totalWeight = weights.technology + weights.biologics + weights.origin;
   const combine = (t, b, o) => totalWeight > 0 ? (t * weights.technology + b * weights.biologics + o * weights.origin) / totalWeight : 0;

package/dist/compellingness/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/compellingness/calibration.ts","../../src/compellingness/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import type { Observation } from '@disclosureos/records';\nimport { parseEvidenceRef, parseSensorRef } from '@disclosureos/records/shared';\nimport type { CalibrationStatus, SensorManifest } from '@disclosureos/instruments';\nimport type { EvaluatorWeightInput } from './index';\n\n/**\n * Trust multiplier per calibration maturity level, plus the `unresolved`\n * baseline for claims whose sensor evidence does not resolve to a manifest\n * entry (no `sensorRef`, unknown org, unknown sensor, or no calibration block).\n */\nexport type CalibrationTrustWeights = Record<CalibrationStatus | 'unresolved', number>;\n\n/**\n * Conservative default gradient: instruments with real calibration provenance\n * earn *credit* over unresolved sensors — nothing is ever penalized below the\n * baseline, so adopting the hook can only reward organizations that publish\n * manifests, never punish records that predate them.\n *\n * @experimental The shape is stable; these specific values are a reference\n * policy that may be re-tuned in a minor release. Pin your own `weights` via\n * {@link CalibrationTrustOptions} if you need stable numbers.\n */\nexport const CALIBRATION_TRUST_WEIGHTS: CalibrationTrustWeights = {\n  unresolved: 1,\n  none: 1,\n  candidate_identified: 1.05,\n  in_practice: 1.15,\n  documented: 1.25,\n};\n\nexport interface CalibrationTrustOptions {\n  /** Override the trust gradient (defaults to {@link CALIBRATION_TRUST_WEIGHTS}). */\n  weights?: CalibrationTrustWeights;\n  /**\n   * A base trust policy composed (multiplied) with the calibration credit —\n   * e.g. an evaluator-identity policy. Defaults to uniform 1.0.\n   */\n  evaluatorWeight?: (claim: EvaluatorWeightInput) => number;\n}\n\n/**\n * Build an `evaluatorWeight` hook (see `ScoreOptions.evaluatorWeight`) that\n * credits claims backed by instruments with published calibration provenance.\n *\n * Resolution chain, per claim: `evidenceRefs` (`\"sensor:<id>\"`) → the\n * observation's `sensorEvidence.sensors[]` reading → its `sensorRef`\n * (`\"<org-slug>:<sensor-id>\"`) → the matching manifest entry's\n * `calibration.status`. When a claim cites several sensor readings, the\n * strongest instrument backing wins. Claims with no resolvable sensor\n * evidence get the `unresolved` baseline.\n *\n * Like every `evaluatorWeight` policy, this shifts only the consensus point\n * estimate — `range` and `contested` still report the honest spread of what\n * evaluators actually asserted.\n *\n * ```ts\n * const result = score(observation, {\n *   evaluatorWeight: calibrationTrust(observation, [navyManifest]),\n * });\n * ```\n */\nexport function calibrationTrust(\n  observation: Observation,\n  manifests: readonly SensorManifest[],\n  options?: CalibrationTrustOptions,\n): (claim: EvaluatorWeightInput) => number {\n  const weights = options?.weights ?? CALIBRATION_TRUST_WEIGHTS;\n  const base = options?.evaluatorWeight ?? ((): number => 1);\n\n  // Pre-resolve each in-record sensor reading to its manifest calibration status.\n  const statusBySensorId = new Map<string, CalibrationStatus>();\n  for (const reading of observation.sensorEvidence?.sensors ?? []) {\n    if (!reading.sensorRef) continue;\n    const ref = parseSensorRef(reading.sensorRef);\n    if (!ref) continue;\n    const entry = manifests\n      .find((manifest) => manifest.orgSlug === ref.orgSlug)\n      ?.sensors.find((sensor) => sensor.id === ref.sensorId);\n    const status = entry?.calibration?.status;\n    if (status) statusBySensorId.set(reading.id, status);\n  }\n\n  return (claim) => {\n    let credit = weights.unresolved;\n    for (const evidence of claim.evidenceRefs ?? []) {\n      const parsed = parseEvidenceRef(evidence);\n      if (!parsed || parsed.kind !== 'sensor') continue;\n      const status = statusBySensorId.get(parsed.id);\n      const weight = status === undefined ? weights.unresolved : weights[status];\n      if (weight > credit) credit = weight;\n    }\n    return base(claim) * credit;\n  };\n}\n","import { z } from 'zod';\nimport type { Observation } from '@disclosureos/records';\nimport type { AssessmentLevel, ObservableClaim } from '@disclosureos/observables';\nimport type { OriginClaim } from '@disclosureos/origins';\n// Side-effect imports register the `observableAssessments` and `origin` slots on\n// `Observation` via module augmentation, so they are typed below.\nimport '@disclosureos/observables';\nimport '@disclosureos/origins';\n\nexport { calibrationTrust, CALIBRATION_TRUST_WEIGHTS } from './calibration';\nexport type { CalibrationTrustWeights, CalibrationTrustOptions } from './calibration';\n\n/** Methodology version stamped on every {@link ScoreResult}. Bump on weight/formula changes. */\nexport const SCORING_VERSION = '2.0.0' as const;\n\n/**\n * Ordinal anomaly strength per evidentiary tier. A `confirmed` signal counts\n * fully; `not_indicated` contributes nothing. Multiplied by the assessment's\n * confidence (default 1 when unstated). Exported so consumers can render the\n * methodology; override semantics may come in a future minor release.\n */\nexport const ASSESSMENT_LEVEL_WEIGHTS: Record<AssessmentLevel, number> = {\n  not_indicated: 0,\n  reported: 0.25,\n  documented: 0.5,\n  measured: 0.75,\n  confirmed: 1,\n};\n\n/**\n * OCS id prefixes treated as prosaic (well-explained). A confident *prosaic*\n * classification means the case is explained, so it contributes no anomaly\n * signal. Overridable per {@link score} call. Default is the OCS \"Prosaic\"\n * branch (`1.1.1`).\n */\nexport const DEFAULT_PROSAIC_OCS_PREFIXES: readonly string[] = ['1.1.1'];\n\nexport const CompellingnessWeightsSchema = z\n  .object({\n    technology: z.number().min(0).describe('Weight of the technology-anomaly signal.'),\n    biologics: z.number().min(0).describe('Weight of the biologics-anomaly signal.'),\n    origin: z.number().min(0).describe('Weight of the (non-prosaic) origin-confidence signal.'),\n  })\n  .meta({ id: 'CompellingnessWeights' })\n  .describe('Relative weights for the compellingness components. Need not sum to 1 — normalized internally.');\n\nexport type CompellingnessWeights = z.infer<typeof CompellingnessWeightsSchema>;\n\n/**\n * Fixed default weights, exposed as a transparent, overridable data object (not a\n * config system). Partners can propose alternate weight sets without an API change.\n *\n * @experimental The *shape* (`CompellingnessWeights`) is stable, but these specific\n * default values are a reference methodology that may be re-tuned in a minor release.\n * Pin your own `weights` via {@link ScoreOptions} if you need stable numbers.\n */\nexport const DEFAULT_WEIGHTS: CompellingnessWeights = {\n  technology: 0.45,\n  biologics: 0.35,\n  origin: 0.2,\n};\n\nexport const ScoreResultSchema = z\n  .object({\n    score: z.number().min(0).max(1).describe('Overall compellingness (consensus point estimate), 0–1.'),\n    range: z\n      .object({\n        low: z.number().min(0).max(1).describe('Most-skeptical reading of the strongest-anomaly signal across competing claims.'),\n        high: z.number().min(0).max(1).describe('Most-anomalous reading of the strongest-anomaly signal across competing claims.'),\n      })\n      .describe(\n        'Spread of the score across competing claims — wide range signals disagreement. Bounds are '\n        + 'computed per-signal under the same strongest-anomaly (max) reduction as the point estimate, '\n        + 'not a global min/max over every claim.',\n      ),\n    contested: z\n      .boolean()\n      .describe('True when claims disagree on *direction* (some assert anomaly, some assert none).'),\n    components: z\n      .object({\n        technology: z.number().min(0).max(1),\n        biologics: z.number().min(0).max(1),\n        origin: z.number().min(0).max(1),\n      })\n      .describe('Per-signal consensus contributions before weighting.'),\n    weights: CompellingnessWeightsSchema,\n    scoringVersion: z.string().describe('Methodology version that produced this score.'),\n  })\n  .meta({ id: 'ScoreResult' })\n  .describe('A reference compellingness score for an observation, with a contestedness range.');\n\nexport type ScoreResult = z.infer<typeof ScoreResultSchema>;\n\n/** The minimal claim shape the trust hook sees (it never needs the full body). */\nexport type EvaluatorWeightInput = {\n  evaluatedBy?: string | undefined;\n  evidenceRefs?: string[] | undefined;\n};\n\nexport interface ScoreOptions {\n  weights?: CompellingnessWeights;\n  /** Override the prosaic OCS prefixes (defaults to {@link DEFAULT_PROSAIC_OCS_PREFIXES}). */\n  prosaicPrefixes?: readonly string[];\n  /**\n   * Trust applied to each claim's vote in the consensus point estimate (default\n   * 1.0 — uniform). This is where a future trust policy (e.g.\n   * weighting verified/official evaluators higher) plugs in here without changing\n   * the formula. Range/contestedness are NOT affected — they report the honest\n   * spread of what evaluators actually asserted.\n   *\n   * @experimental The hook signature is stable, but the default trust *policy*\n   * (uniform 1.0) is deliberately unopinionated and is a separate, ongoing design\n   * task; a future built-in policy may change the default.\n   */\n  evaluatorWeight?: (claim: EvaluatorWeightInput) => number;\n}\n\nconst UNIFORM_TRUST = (): number => 1;\n\nfunction isProsaic(id: string, prefixes: readonly string[]): boolean {\n  return prefixes.some((p) => id === p || id.startsWith(`${p}.`));\n}\n\nfunction round(n: number): number {\n  return Math.round(n * 1e4) / 1e4;\n}\n\ntype Weighted = { magnitude: number; weight: number };\n\ninterface ClaimStats {\n  /** Trust-weighted mean magnitude (the consensus point). */\n  point: number;\n  /** Min asserted magnitude (most skeptical). */\n  low: number;\n  /** Max asserted magnitude (most anomalous). */\n  high: number;\n  /** Claims disagree on direction (some > 0, some === 0). */\n  contested: boolean;\n}\n\nconst EMPTY_STATS: ClaimStats = { point: 0, low: 0, high: 0, contested: false };\n\nfunction reduceClaims(weighted: Weighted[]): ClaimStats {\n  if (weighted.length === 0) return EMPTY_STATS;\n  let wsum = 0;\n  let msum = 0;\n  let low = Infinity;\n  let high = -Infinity;\n  let anyAnomaly = false;\n  let anyNone = false;\n  for (const { magnitude, weight } of weighted) {\n    wsum += weight;\n    msum += magnitude * weight;\n    if (magnitude < low) low = magnitude;\n    if (magnitude > high) high = magnitude;\n    if (magnitude > 0) anyAnomaly = true;\n    else anyNone = true;\n  }\n  return {\n    point: wsum > 0 ? msum / wsum : 0,\n    low,\n    high,\n    contested: anyAnomaly && anyNone,\n  };\n}\n\n/** Asserted anomaly magnitude of one observable claim, in [0,1]. */\nfunction observableMagnitude(claim: ObservableClaim): number {\n  return ASSESSMENT_LEVEL_WEIGHTS[claim.level] * (claim.confidence ?? 1);\n}\n\n/**\n * Strongest established anomaly within a domain — the \"is there *any* anomaly?\" reduction.\n * `point`/`low`/`high` are each a **max across observables** of that observable's claim-list\n * stat. So `low` is \"the most-skeptical reading of the strongest-anomaly observable,\" not a\n * global floor across all observables — consistent with the point estimate's max reduction.\n */\nfunction domainStats(\n  group: Partial<Record<string, ObservableClaim[]>> | undefined,\n  evaluatorWeight: (claim: EvaluatorWeightInput) => number,\n): ClaimStats {\n  if (!group) return EMPTY_STATS;\n  let point = 0;\n  let low = 0;\n  let high = 0;\n  let contested = false;\n  for (const claims of Object.values(group)) {\n    if (!claims || claims.length === 0) continue;\n    const weighted = claims.map<Weighted>((c) => ({\n      magnitude: observableMagnitude(c),\n      weight: (c.confidence ?? 1) * evaluatorWeight(c),\n    }));\n    const stats = reduceClaims(weighted);\n    if (stats.point > point) point = stats.point;\n    if (stats.low > low) low = stats.low;\n    if (stats.high > high) high = stats.high;\n    if (stats.contested) contested = true;\n  }\n  return { point, low, high, contested };\n}\n\n/** Confidence in a *non-prosaic* origin, reduced across competing classifications. */\nfunction originStats(\n  origin: OriginClaim[] | undefined,\n  prefixes: readonly string[],\n  evaluatorWeight: (claim: EvaluatorWeightInput) => number,\n): ClaimStats {\n  if (!origin || origin.length === 0) return EMPTY_STATS;\n  const weighted = origin.map<Weighted>((c) => ({\n    magnitude: isProsaic(c.primaryHypothesis, prefixes) ? 0 : c.confidence,\n    weight: c.confidence * evaluatorWeight(c),\n  }));\n  return reduceClaims(weighted);\n}\n\n/**\n * Reference compellingness scorer. Combines the strongest technology- and\n * biologics-anomaly signals (from `observableAssessments`) with the confidence in\n * a *non-prosaic* origin classification (from `origin`), under transparent,\n * overridable weights. Each slot is a *list* of competing claims, so the scorer\n * reports a consensus `score`, the `range` of readings across claims, and whether\n * the case is `contested` (evaluators disagree on direction). This answers \"how\n * strongly does this case bear on the two public questions — anomalous\n * tech/biologics, and a non-mundane origin?\" — distinct from completeness.\n */\nexport function score(observation: Observation, options?: ScoreOptions): ScoreResult {\n  const weights = options?.weights ?? DEFAULT_WEIGHTS;\n  const prosaicPrefixes = options?.prosaicPrefixes ?? DEFAULT_PROSAIC_OCS_PREFIXES;\n  const evaluatorWeight = options?.evaluatorWeight ?? UNIFORM_TRUST;\n\n  const assessments = observation.observableAssessments;\n  const technology = domainStats(assessments?.technology, evaluatorWeight);\n  const biologics = domainStats(assessments?.biologics, evaluatorWeight);\n  const origin = originStats(observation.origin, prosaicPrefixes, evaluatorWeight);\n\n  const totalWeight = weights.technology + weights.biologics + weights.origin;\n  const combine = (t: number, b: number, o: number): number =>\n    totalWeight > 0\n      ? (t * weights.technology + b * weights.biologics + o * weights.origin) / totalWeight\n      : 0;\n\n  return {\n    score: round(combine(technology.point, biologics.point, origin.point)),\n    range: {\n      low: round(combine(technology.low, biologics.low, origin.low)),\n      high: round(combine(technology.high, biologics.high, origin.high)),\n    },\n    contested: technology.contested || biologics.contested || origin.contested,\n    components: {\n      technology: round(technology.point),\n      biologics: round(biologics.point),\n      origin: round(origin.point),\n    },\n    weights,\n    scoringVersion: SCORING_VERSION,\n  };\n}\n\nexport interface RankedObservation<T extends Observation = Observation> {\n  observation: T;\n  result: ScoreResult;\n}\n\n/**\n * Score a set of observations and return them sorted most-compelling first — the\n * \"float the strongest cases to the top\" use case.\n */\nexport function rankByCompellingness<T extends Observation>(\n  observations: readonly T[],\n  options?: ScoreOptions,\n): RankedObservation<T>[] {\n  return observations\n    .map((observation) => ({ observation, result: score(observation, options) }))\n    .sort((a, b) => b.result.score - a.result.score);\n}\n"]}
+{"version":3,"sources":["../../src/compellingness/calibration.ts","../../src/compellingness/index.ts"],"names":[],"mappings":";;;;;;AAsBO,IAAM,yBAAA,GAAqD;AAAA,EAChE,UAAA,EAAY,CAAA;AAAA,EACZ,IAAA,EAAM,CAAA;AAAA,EACN,oBAAA,EAAsB,IAAA;AAAA,EACtB,WAAA,EAAa,IAAA;AAAA,EACb,UAAA,EAAY;AACd;AAiCO,SAAS,gBAAA,CACd,WAAA,EACA,SAAA,EACA,OAAA,EACyC;AACzC,EAAA,MAAM,OAAA,GAAU,SAAS,OAAA,IAAW,yBAAA;AACpC,EAAA,MAAM,IAAA,GAAO,OAAA,EAAS,eAAA,KAAoB,MAAc,CAAA,CAAA;AAGxD,EAAA,MAAM,gBAAA,uBAAuB,GAAA,EAA+B;AAC5D,EAAA,KAAA,MAAW,OAAA,IAAW,WAAA,CAAY,cAAA,EAAgB,OAAA,IAAW,EAAC,EAAG;AAC/D,IAAA,IAAI,CAAC,QAAQ,SAAA,EAAW;AACxB,IAAA,MAAM,GAAA,GAAM,cAAA,CAAe,OAAA,CAAQ,SAAS,CAAA;AAC5C,IAAA,IAAI,CAAC,GAAA,EAAK;AACV,IAAA,MAAM,QAAQ,SAAA,CACX,IAAA,CAAK,CAAC,QAAA,KAAa,SAAS,OAAA,KAAY,GAAA,CAAI,OAAO,CAAA,EAClD,QAAQ,IAAA,CAAK,CAAC,WAAW,MAAA,CAAO,EAAA,KAAO,IAAI,QAAQ,CAAA;AACvD,IAAA,MAAM,MAAA,GAAS,OAAO,WAAA,EAAa,MAAA;AACnC,IAAA,IAAI,MAAA,EAAQ,gBAAA,CAAiB,GAAA,CAAI,OAAA,CAAQ,IAAI,MAAM,CAAA;AAAA,EACrD;AAEA,EAAA,OAAO,CAAC,KAAA,KAAU;AAChB,IAAA,IAAI,SAAS,OAAA,CAAQ,UAAA;AACrB,IAAA,KAAA,MAAW,QAAA,IAAY,KAAA,CAAM,YAAA,IAAgB,EAAC,EAAG;AAC/C,MAAA,MAAM,MAAA,GAAS,iBAAiB,QAAQ,CAAA;AACxC,MAAA,IAAI,CAAC,MAAA,IAAU,MAAA,CAAO,IAAA,KAAS,QAAA,EAAU;AACzC,MAAA,MAAM,MAAA,GAAS,gBAAA,CAAiB,GAAA,CAAI,MAAA,CAAO,EAAE,CAAA;AAC7C,MAAA,MAAM,SAAS,MAAA,KAAW,MAAA,GAAY,OAAA,CAAQ,UAAA,GAAa,QAAQ,MAAM,CAAA;AACzE,MAAA,IAAI,MAAA,GAAS,QAAQ,MAAA,GAAS,MAAA;AAAA,IAChC;AACA,IAAA,OAAO,IAAA,CAAK,KAAK,CAAA,GAAI,MAAA;AAAA,EACvB,CAAA;AACF;;;AChFO,IAAM,eAAA,GAAkB;AAOxB,IAAM,wBAAA,GAA4D;AAAA,EACvE,aAAA,EAAe,CAAA;AAAA,EACf,QAAA,EAAU,IAAA;AAAA,EACV,UAAA,EAAY,GAAA;AAAA,EACZ,QAAA,EAAU,IAAA;AAAA,EACV,SAAA,EAAW;AACb;AAQO,IAAM,4BAAA,GAAkD,CAAC,OAAO;AAEhE,IAAM,2BAAA,GAA8B,EACxC,MAAA,CAAO;AAAA,EACN,UAAA,EAAY,EAAE,MAAA,EAAO,CAAE,IAAI,CAAC,CAAA,CAAE,SAAS,0CAA0C,CAAA;AAAA,EACjF,SAAA,EAAW,EAAE,MAAA,EAAO,CAAE,IAAI,CAAC,CAAA,CAAE,SAAS,yCAAyC,CAAA;AAAA,EAC/E,MAAA,EAAQ,EAAE,MAAA,EAAO,CAAE,IAAI,CAAC,CAAA,CAAE,SAAS,uDAAuD;AAC5F,CAAC,CAAA,CACA,KAAK,EAAE,EAAA,EAAI,yBAAyB,CAAA,CACpC,SAAS,qGAAgG;AAYrG,IAAM,eAAA,GAAyC;AAAA,EACpD,UAAA,EAAY,IAAA;AAAA,EACZ,SAAA,EAAW,IAAA;AAAA,EACX,MAAA,EAAQ;AACV;AAEO,IAAM,iBAAA,GAAoB,EAC9B,MAAA,CAAO;AAAA,EACN,KAAA,EAAO,CAAA,CAAE,MAAA,EAAO,CAAE,GAAA,CAAI,CAAC,CAAA,CAAE,GAAA,CAAI,CAAC,CAAA,CAAE,QAAA,CAAS,8DAAyD,CAAA;AAAA,EAClG,KAAA,EAAO,EACJ,MAAA,CAAO;AAAA,IACN,GAAA,EAAK,CAAA,CAAE,MAAA,EAAO,CAAE,GAAA,CAAI,CAAC,CAAA,CAAE,GAAA,CAAI,CAAC,CAAA,CAAE,QAAA,CAAS,iFAAiF,CAAA;AAAA,IACxH,IAAA,EAAM,CAAA,CAAE,MAAA,EAAO,CAAE,GAAA,CAAI,CAAC,CAAA,CAAE,GAAA,CAAI,CAAC,CAAA,CAAE,QAAA,CAAS,iFAAiF;AAAA,GAC1H,CAAA,CACA,QAAA;AAAA,IACC;AAAA,GAGF;AAAA,EACF,SAAA,EAAW,CAAA,CACR,OAAA,EAAQ,CACR,SAAS,mFAAmF,CAAA;AAAA,EAC/F,UAAA,EAAY,EACT,MAAA,CAAO;AAAA,IACN,UAAA,EAAY,EAAE,MAAA,EAAO,CAAE,IAAI,CAAC,CAAA,CAAE,IAAI,CAAC,CAAA;AAAA,IACnC,SAAA,EAAW,EAAE,MAAA,EAAO,CAAE,IAAI,CAAC,CAAA,CAAE,IAAI,CAAC,CAAA;AAAA,IAClC,MAAA,EAAQ,EAAE,MAAA,EAAO,CAAE,IAAI,CAAC,CAAA,CAAE,IAAI,CAAC;AAAA,GAChC,CAAA,CACA,QAAA,CAAS,sDAAsD,CAAA;AAAA,EAClE,OAAA,EAAS,2BAAA;AAAA,EACT,cAAA,EAAgB,CAAA,CAAE,MAAA,EAAO,CAAE,SAAS,+CAA+C;AACrF,CAAC,CAAA,CACA,KAAK,EAAE,EAAA,EAAI,eAAe,CAAA,CAC1B,SAAS,kFAAkF;AA4B9F,IAAM,gBAAgB,MAAc,CAAA;AAEpC,SAAS,SAAA,CAAU,IAAY,QAAA,EAAsC;AACnE,EAAA,OAAO,QAAA,CAAS,IAAA,CAAK,CAAC,CAAA,KAAM,EAAA,KAAO,CAAA,IAAK,EAAA,CAAG,UAAA,CAAW,CAAA,EAAG,CAAC,CAAA,CAAA,CAAG,CAAC,CAAA;AAChE;AAEA,SAAS,MAAM,CAAA,EAAmB;AAChC,EAAA,OAAO,IAAA,CAAK,KAAA,CAAM,CAAA,GAAI,GAAG,CAAA,GAAI,GAAA;AAC/B;AAeA,IAAM,WAAA,GAA0B,EAAE,KAAA,EAAO,CAAA,EAAG,KAAK,CAAA,EAAG,IAAA,EAAM,CAAA,EAAG,SAAA,EAAW,KAAA,EAAM;AAE9E,SAAS,aAAa,QAAA,EAAkC;AACtD,EAAA,IAAI,QAAA,CAAS,MAAA,KAAW,CAAA,EAAG,OAAO,WAAA;AAClC,EAAA,IAAI,IAAA,GAAO,CAAA;AACX,EAAA,IAAI,IAAA,GAAO,CAAA;AACX,EAAA,IAAI,GAAA,GAAM,QAAA;AACV,EAAA,IAAI,IAAA,GAAO,CAAA,QAAA;AACX,EAAA,IAAI,UAAA,GAAa,KAAA;AACjB,EAAA,IAAI,OAAA,GAAU,KAAA;AACd,EAAA,KAAA,MAAW,EAAE,SAAA,EAAW,MAAA,EAAO,IAAK,QAAA,EAAU;AAC5C,IAAA,IAAA,IAAQ,MAAA;AACR,IAAA,IAAA,IAAQ,SAAA,GAAY,MAAA;AACpB,IAAA,IAAI,SAAA,GAAY,KAAK,GAAA,GAAM,SAAA;AAC3B,IAAA,IAAI,SAAA,GAAY,MAAM,IAAA,GAAO,SAAA;AAC7B,IAAA,IAAI,SAAA,GAAY,GAAG,UAAA,GAAa,IAAA;AAAA,SAC3B,OAAA,GAAU,IAAA;AAAA,EACjB;AACA,EAAA,OAAO;AAAA,IACL,KAAA,EAAO,IAAA,GAAO,CAAA,GAAI,IAAA,GAAO,IAAA,GAAO,CAAA;AAAA,IAChC,GAAA;AAAA,IACA,IAAA;AAAA,IACA,WAAW,UAAA,IAAc;AAAA,GAC3B;AACF;AAGA,SAAS,WAAA,CACP,MAAA,EACA,QAAA,EACA,eAAA,EACY;AACZ,EAAA,IAAI,CAAC,MAAA,IAAU,MAAA,CAAO,MAAA,KAAW,GAAG,OAAO,WAAA;AAC3C,EAAA,MAAM,QAAA,GAAW,MAAA,CAAO,GAAA,CAAc,CAAC,CAAA,MAAO;AAAA,IAC5C,WAAW,SAAA,CAAU,CAAA,CAAE,mBAAmB,QAAQ,CAAA,GAAI,IAAI,CAAA,CAAE,UAAA;AAAA,IAC5D,MAAA,EAAQ,CAAA,CAAE,UAAA,GAAa,eAAA,CAAgB,CAAC;AAAA,GAC1C,CAAE,CAAA;AACF,EAAA,OAAO,aAAa,QAAQ,CAAA;AAC9B;AAQO,SAAS,KAAA,CAAM,aAA0B,OAAA,EAAqC;AACnF,EAAA,MAAM,cAAc,WAAA,CAAY,qBAAA;AAChC,EAAA,MAAM,oBAAA,GAAuB,CAAC,WAAA,EAAa,UAAA,EAAY,aAAa,SAAS,CAAA,CAC1E,IAAA,CAAK,CAAC,KAAA,KAAU,MAAA,CAAO,OAAO,KAAA,IAAS,EAAE,CAAA,CAAE,IAAA,CAAK,CAAC,WAAW,MAAA,IAAU,MAAA,CAAO,MAAA,GAAS,CAAC,CAAC,CAAA;AAC3F,EAAA,IAAI,oBAAA,EAAsB;AACxB,IAAA,MAAM,IAAI,MAAM,gKAAgK,CAAA;AAAA,EAClL;AACA,EAAA,MAAM,OAAA,GAAU,SAAS,OAAA,IAAW,eAAA;AACpC,EAAA,MAAM,eAAA,GAAkB,SAAS,eAAA,IAAmB,4BAAA;AACpD,EAAA,MAAM,eAAA,GAAkB,SAAS,eAAA,IAAmB,aAAA;AAEpD,EAAA,MAAM,UAAA,GAAa,WAAA;AACnB,EAAA,MAAM,SAAA,GAAY,WAAA;AAClB,EAAA,MAAM,MAAA,GAAS,WAAA,CAAY,WAAA,CAAY,MAAA,EAAQ,iBAAiB,eAAe,CAAA;AAE/E,EAAA,MAAM,WAAA,GAAc,OAAA,CAAQ,UAAA,GAAa,OAAA,CAAQ,YAAY,OAAA,CAAQ,MAAA;AACrE,EAAA,MAAM,UAAU,CAAC,CAAA,EAAW,CAAA,EAAW,CAAA,KACrC,cAAc,CAAA,GAAA,CACT,CAAA,GAAI,OAAA,CAAQ,UAAA,GAAa,IAAI,OAAA,CAAQ,SAAA,GAAY,CAAA,GAAI,OAAA,CAAQ,UAAU,WAAA,GACxE,CAAA;AAEN,EAAA,OAAO;AAAA,IACL,KAAA,EAAO,MAAM,OAAA,CAAQ,UAAA,CAAW,OAAO,SAAA,CAAU,KAAA,EAAO,MAAA,CAAO,KAAK,CAAC,CAAA;AAAA,IACrE,KAAA,EAAO;AAAA,MACL,GAAA,EAAK,MAAM,OAAA,CAAQ,UAAA,CAAW,KAAK,SAAA,CAAU,GAAA,EAAK,MAAA,CAAO,GAAG,CAAC,CAAA;AAAA,MAC7D,IAAA,EAAM,MAAM,OAAA,CAAQ,UAAA,CAAW,MAAM,SAAA,CAAU,IAAA,EAAM,MAAA,CAAO,IAAI,CAAC;AAAA,KACnE;AAAA,IACA,SAAA,EAAW,UAAA,CAAW,SAAA,IAAa,SAAA,CAAU,aAAa,MAAA,CAAO,SAAA;AAAA,IACjE,UAAA,EAAY;AAAA,MACV,UAAA,EAAY,KAAA,CAAM,UAAA,CAAW,KAAK,CAAA;AAAA,MAClC,SAAA,EAAW,KAAA,CAAM,SAAA,CAAU,KAAK,CAAA;AAAA,MAChC,MAAA,EAAQ,KAAA,CAAM,MAAA,CAAO,KAAK;AAAA,KAC5B;AAAA,IACA,OAAA;AAAA,IACA,cAAA,EAAgB;AAAA,GAClB;AACF;AAWO,SAAS,oBAAA,CACd,cACA,OAAA,EACwB;AACxB,EAAA,OAAO,YAAA,CACJ,IAAI,CAAC,WAAA,MAAiB,EAAE,WAAA,EAAa,MAAA,EAAQ,KAAA,CAAM,WAAA,EAAa,OAAO,CAAA,GAAI,CAAA,CAC3E,IAAA,CAAK,CAAC,CAAA,EAAG,CAAA,KAAM,EAAE,MAAA,CAAO,KAAA,GAAQ,CAAA,CAAE,MAAA,CAAO,KAAK,CAAA;AACnD","file":"index.js","sourcesContent":["import type { Observation } from '@disclosureos/records';\nimport { parseEvidenceRef, parseSensorRef } from '@disclosureos/records/shared';\nimport type { CalibrationStatus, SensorManifest } from '@disclosureos/instruments';\nimport type { EvaluatorWeightInput } from './index';\n\n/**\n * Trust multiplier per calibration maturity level, plus the `unresolved`\n * baseline for claims whose sensor evidence does not resolve to a manifest\n * entry (no `sensorRef`, unknown org, unknown sensor, or no calibration block).\n */\nexport type CalibrationTrustWeights = Record<CalibrationStatus | 'unresolved', number>;\n\n/**\n * Conservative default gradient: instruments with real calibration provenance\n * earn *credit* over unresolved sensors — nothing is ever penalized below the\n * baseline, so adopting the hook can only reward organizations that publish\n * manifests, never punish records that predate them.\n *\n * @experimental The shape is stable; these specific values are a reference\n * policy that may be re-tuned in a minor release. Pin your own `weights` via\n * {@link CalibrationTrustOptions} if you need stable numbers.\n */\nexport const CALIBRATION_TRUST_WEIGHTS: CalibrationTrustWeights = {\n  unresolved: 1,\n  none: 1,\n  candidate_identified: 1.05,\n  in_practice: 1.15,\n  documented: 1.25,\n};\n\nexport interface CalibrationTrustOptions {\n  /** Override the trust gradient (defaults to {@link CALIBRATION_TRUST_WEIGHTS}). */\n  weights?: CalibrationTrustWeights;\n  /**\n   * A base trust policy composed (multiplied) with the calibration credit —\n   * e.g. an evaluator-identity policy. Defaults to uniform 1.0.\n   */\n  evaluatorWeight?: (claim: EvaluatorWeightInput) => number;\n}\n\n/**\n * Build an `evaluatorWeight` hook (see `ScoreOptions.evaluatorWeight`) that\n * credits claims backed by instruments with published calibration provenance.\n *\n * Resolution chain, per claim: `evidenceRefs` (`\"sensor:<id>\"`) → the\n * observation's `sensorEvidence.sensors[]` reading → its `sensorRef`\n * (`\"<org-slug>:<sensor-id>\"`) → the matching manifest entry's\n * `calibration.status`. When a claim cites several sensor readings, the\n * strongest instrument backing wins. Claims with no resolvable sensor\n * evidence get the `unresolved` baseline.\n *\n * Like every `evaluatorWeight` policy, this shifts only the consensus point\n * estimate — `range` and `contested` still report the honest spread of what\n * evaluators actually asserted.\n *\n * ```ts\n * const result = score(observation, {\n *   evaluatorWeight: calibrationTrust(observation, [navyManifest]),\n * });\n * ```\n */\nexport function calibrationTrust(\n  observation: Observation,\n  manifests: readonly SensorManifest[],\n  options?: CalibrationTrustOptions,\n): (claim: EvaluatorWeightInput) => number {\n  const weights = options?.weights ?? CALIBRATION_TRUST_WEIGHTS;\n  const base = options?.evaluatorWeight ?? ((): number => 1);\n\n  // Pre-resolve each in-record sensor reading to its manifest calibration status.\n  const statusBySensorId = new Map<string, CalibrationStatus>();\n  for (const reading of observation.sensorEvidence?.sensors ?? []) {\n    if (!reading.sensorRef) continue;\n    const ref = parseSensorRef(reading.sensorRef);\n    if (!ref) continue;\n    const entry = manifests\n      .find((manifest) => manifest.orgSlug === ref.orgSlug)\n      ?.sensors.find((sensor) => sensor.id === ref.sensorId);\n    const status = entry?.calibration?.status;\n    if (status) statusBySensorId.set(reading.id, status);\n  }\n\n  return (claim) => {\n    let credit = weights.unresolved;\n    for (const evidence of claim.evidenceRefs ?? []) {\n      const parsed = parseEvidenceRef(evidence);\n      if (!parsed || parsed.kind !== 'sensor') continue;\n      const status = statusBySensorId.get(parsed.id);\n      const weight = status === undefined ? weights.unresolved : weights[status];\n      if (weight > credit) credit = weight;\n    }\n    return base(claim) * credit;\n  };\n}\n","import { z } from 'zod';\nimport type { Observation } from '@disclosureos/records';\nimport type { AssessmentLevel } from '@disclosureos/observables';\nimport type { OriginClaim } from '@disclosureos/origins';\n// Side-effect imports register the `observableAssessments` and `origin` slots on\n// `Observation` via module augmentation, so they are typed below.\nimport '@disclosureos/observables';\nimport '@disclosureos/origins';\n\nexport { calibrationTrust, CALIBRATION_TRUST_WEIGHTS } from './calibration';\nexport type { CalibrationTrustWeights, CalibrationTrustOptions } from './calibration';\n\n/** Methodology version stamped on every {@link ScoreResult}. Bump on weight/formula changes. */\nexport const SCORING_VERSION = '2.0.0' as const;\n\n/**\n * Ordinal support-tier values retained as transparent methodology data.\n * These values do not establish anomaly strength. The scorer rejects descriptive\n * observable assessments rather than applying this table to the V2 vocabulary.\n */\nexport const ASSESSMENT_LEVEL_WEIGHTS: Record<AssessmentLevel, number> = {\n  not_indicated: 0,\n  reported: 0.25,\n  documented: 0.5,\n  measured: 0.75,\n  confirmed: 1,\n};\n\n/**\n * OCS id prefixes treated as prosaic (well-explained). A confident *prosaic*\n * classification means the case is explained, so it contributes no anomaly\n * signal. Overridable per {@link score} call. Default is the OCS \"Prosaic\"\n * branch (`1.1.1`).\n */\nexport const DEFAULT_PROSAIC_OCS_PREFIXES: readonly string[] = ['1.1.1'];\n\nexport const CompellingnessWeightsSchema = z\n  .object({\n    technology: z.number().min(0).describe('Weight of the technology-anomaly signal.'),\n    biologics: z.number().min(0).describe('Weight of the biologics-anomaly signal.'),\n    origin: z.number().min(0).describe('Weight of the (non-prosaic) origin-confidence signal.'),\n  })\n  .meta({ id: 'CompellingnessWeights' })\n  .describe('Relative weights for the compellingness components. Need not sum to 1 — normalized internally.');\n\nexport type CompellingnessWeights = z.infer<typeof CompellingnessWeightsSchema>;\n\n/**\n * Fixed default weights, exposed as a transparent, overridable data object (not a\n * config system). Partners can propose alternate weight sets without an API change.\n *\n * @experimental The *shape* (`CompellingnessWeights`) is stable, but these specific\n * default values are a reference methodology that may be re-tuned in a minor release.\n * Pin your own `weights` via {@link ScoreOptions} if you need stable numbers.\n */\nexport const DEFAULT_WEIGHTS: CompellingnessWeights = {\n  technology: 0.45,\n  biologics: 0.35,\n  origin: 0.2,\n};\n\nexport const ScoreResultSchema = z\n  .object({\n    score: z.number().min(0).max(1).describe('Overall compellingness (consensus point estimate), 0–1.'),\n    range: z\n      .object({\n        low: z.number().min(0).max(1).describe('Most-skeptical reading of the strongest-anomaly signal across competing claims.'),\n        high: z.number().min(0).max(1).describe('Most-anomalous reading of the strongest-anomaly signal across competing claims.'),\n      })\n      .describe(\n        'Spread of the score across competing claims — wide range signals disagreement. Bounds are '\n        + 'computed per-signal under the same strongest-anomaly (max) reduction as the point estimate, '\n        + 'not a global min/max over every claim.',\n      ),\n    contested: z\n      .boolean()\n      .describe('True when claims disagree on *direction* (some assert anomaly, some assert none).'),\n    components: z\n      .object({\n        technology: z.number().min(0).max(1),\n        biologics: z.number().min(0).max(1),\n        origin: z.number().min(0).max(1),\n      })\n      .describe('Per-signal consensus contributions before weighting.'),\n    weights: CompellingnessWeightsSchema,\n    scoringVersion: z.string().describe('Methodology version that produced this score.'),\n  })\n  .meta({ id: 'ScoreResult' })\n  .describe('A reference compellingness score for an observation, with a contestedness range.');\n\nexport type ScoreResult = z.infer<typeof ScoreResultSchema>;\n\n/** The minimal claim shape the trust hook sees (it never needs the full body). */\nexport type EvaluatorWeightInput = {\n  evaluatedBy?: string | undefined;\n  evidenceRefs?: string[] | undefined;\n};\n\nexport interface ScoreOptions {\n  weights?: CompellingnessWeights;\n  /** Override the prosaic OCS prefixes (defaults to {@link DEFAULT_PROSAIC_OCS_PREFIXES}). */\n  prosaicPrefixes?: readonly string[];\n  /**\n   * Trust applied to each claim's vote in the consensus point estimate (default\n   * 1.0 — uniform). This is where a future trust policy (e.g.\n   * weighting verified/official evaluators higher) plugs in here without changing\n   * the formula. Range/contestedness are NOT affected — they report the honest\n   * spread of what evaluators actually asserted.\n   *\n   * @experimental The hook signature is stable, but the default trust *policy*\n   * (uniform 1.0) is deliberately unopinionated and is a separate, ongoing design\n   * task; a future built-in policy may change the default.\n   */\n  evaluatorWeight?: (claim: EvaluatorWeightInput) => number;\n}\n\nconst UNIFORM_TRUST = (): number => 1;\n\nfunction isProsaic(id: string, prefixes: readonly string[]): boolean {\n  return prefixes.some((p) => id === p || id.startsWith(`${p}.`));\n}\n\nfunction round(n: number): number {\n  return Math.round(n * 1e4) / 1e4;\n}\n\ntype Weighted = { magnitude: number; weight: number };\n\ninterface ClaimStats {\n  /** Trust-weighted mean magnitude (the consensus point). */\n  point: number;\n  /** Min asserted magnitude (most skeptical). */\n  low: number;\n  /** Max asserted magnitude (most anomalous). */\n  high: number;\n  /** Claims disagree on direction (some > 0, some === 0). */\n  contested: boolean;\n}\n\nconst EMPTY_STATS: ClaimStats = { point: 0, low: 0, high: 0, contested: false };\n\nfunction reduceClaims(weighted: Weighted[]): ClaimStats {\n  if (weighted.length === 0) return EMPTY_STATS;\n  let wsum = 0;\n  let msum = 0;\n  let low = Infinity;\n  let high = -Infinity;\n  let anyAnomaly = false;\n  let anyNone = false;\n  for (const { magnitude, weight } of weighted) {\n    wsum += weight;\n    msum += magnitude * weight;\n    if (magnitude < low) low = magnitude;\n    if (magnitude > high) high = magnitude;\n    if (magnitude > 0) anyAnomaly = true;\n    else anyNone = true;\n  }\n  return {\n    point: wsum > 0 ? msum / wsum : 0,\n    low,\n    high,\n    contested: anyAnomaly && anyNone,\n  };\n}\n\n/** Confidence in a *non-prosaic* origin, reduced across competing classifications. */\nfunction originStats(\n  origin: OriginClaim[] | undefined,\n  prefixes: readonly string[],\n  evaluatorWeight: (claim: EvaluatorWeightInput) => number,\n): ClaimStats {\n  if (!origin || origin.length === 0) return EMPTY_STATS;\n  const weighted = origin.map<Weighted>((c) => ({\n    magnitude: isProsaic(c.primaryHypothesis, prefixes) ? 0 : c.confidence,\n    weight: c.confidence * evaluatorWeight(c),\n  }));\n  return reduceClaims(weighted);\n}\n\n/**\n * Reference scorer for origin-only inputs. Descriptive observable support tiers\n * cannot supply anomaly strength, so any nonempty observable claim list is rejected.\n * Use attributed V2 assessments and profile evaluation for research results.\n * Rejection is not a zero score or a finding that a characteristic is absent.\n */\nexport function score(observation: Observation, options?: ScoreOptions): ScoreResult {\n  const assessments = observation.observableAssessments;\n  const hasDescriptiveClaims = [assessments?.technology, assessments?.biologics]\n    .some((group) => Object.values(group ?? {}).some((claims) => claims && claims.length > 0));\n  if (hasDescriptiveClaims) {\n    throw new Error('Descriptive observable assessments cannot produce anomaly strength. Use V2 attributed assessments and profile evaluation; this is not a zero or absent result.');\n  }\n  const weights = options?.weights ?? DEFAULT_WEIGHTS;\n  const prosaicPrefixes = options?.prosaicPrefixes ?? DEFAULT_PROSAIC_OCS_PREFIXES;\n  const evaluatorWeight = options?.evaluatorWeight ?? UNIFORM_TRUST;\n\n  const technology = EMPTY_STATS;\n  const biologics = EMPTY_STATS;\n  const origin = originStats(observation.origin, prosaicPrefixes, evaluatorWeight);\n\n  const totalWeight = weights.technology + weights.biologics + weights.origin;\n  const combine = (t: number, b: number, o: number): number =>\n    totalWeight > 0\n      ? (t * weights.technology + b * weights.biologics + o * weights.origin) / totalWeight\n      : 0;\n\n  return {\n    score: round(combine(technology.point, biologics.point, origin.point)),\n    range: {\n      low: round(combine(technology.low, biologics.low, origin.low)),\n      high: round(combine(technology.high, biologics.high, origin.high)),\n    },\n    contested: technology.contested || biologics.contested || origin.contested,\n    components: {\n      technology: round(technology.point),\n      biologics: round(biologics.point),\n      origin: round(origin.point),\n    },\n    weights,\n    scoringVersion: SCORING_VERSION,\n  };\n}\n\nexport interface RankedObservation<T extends Observation = Observation> {\n  observation: T;\n  result: ScoreResult;\n}\n\n/**\n * Score a set of observations and return them sorted most-compelling first — the\n * \"float the strongest cases to the top\" use case.\n */\nexport function rankByCompellingness<T extends Observation>(\n  observations: readonly T[],\n  options?: ScoreOptions,\n): RankedObservation<T>[] {\n  return observations\n    .map((observation) => ({ observation, result: score(observation, options) }))\n    .sort((a, b) => b.result.score - a.result.score);\n}\n"]}

package/dist/experimental/v2/index.d.ts

@@ -54,6 +54,231 @@ interface AssessmentSummaryResult {
 /** Summarize attributed declarations. No outcome is upgraded by a parser pass. */
 declare function summarizeClaimHistory(input: unknown): AssessmentSummaryResult;
 
+declare const PROVIDER_SCORE_POLICY_SCHEMA_ID = "urn:disclosureos:experimental:provider-score-policy:0.1.0";
+declare const PROVIDER_SCORE_RESULT_SCHEMA_ID = "urn:disclosureos:experimental:provider-score-result:0.1.0";
+/** A provider-defined method, not a DisclosureOS universal case grade. */
+declare const ProviderScorePolicySchema: z.ZodObject<{
+    kind: z.ZodLiteral<"provider_score_policy">;
+    schemaVersion: z.ZodLiteral<"0.1.0">;
+    id: z.ZodString;
+    version: z.ZodString;
+    title: z.ZodString;
+    metric: z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+        question: z.ZodString;
+    }, z.core.$strict>;
+    subjectKinds: z.ZodArray<z.ZodEnum<{
+        measurement: "measurement";
+        case: "case";
+        record: "record";
+        claim: "claim";
+        product: "product";
+        source: "source";
+        collection: "collection";
+    }>>;
+    method: z.ZodObject<{
+        description: z.ZodString;
+        artifacts: z.ZodArray<z.ZodObject<{
+            sha256: z.ZodString;
+            byteLength: z.ZodNumber;
+            ref: z.ZodString;
+            id: z.ZodString;
+            version: z.ZodString;
+            mediaType: z.ZodString;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+    applicability: z.ZodString;
+    missingData: z.ZodObject<{
+        handling: z.ZodEnum<{
+            withhold: "withhold";
+            allow_partial: "allow_partial";
+        }>;
+        description: z.ZodString;
+    }, z.core.$strict>;
+    limitations: z.ZodArray<z.ZodString>;
+    scale: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"numeric">;
+        min: z.ZodNumber;
+        max: z.ZodNumber;
+        direction: z.ZodEnum<{
+            higher: "higher";
+            lower: "lower";
+            none: "none";
+        }>;
+        unit: z.ZodString;
+        grades: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+            min: z.ZodNumber;
+            max: z.ZodNumber;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"ordinal">;
+        direction: z.ZodEnum<{
+            higher: "higher";
+            lower: "lower";
+            none: "none";
+        }>;
+        levels: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+            description: z.ZodString;
+        }, z.core.$strict>>;
+    }, z.core.$strict>], "kind">;
+}, z.core.$strict>;
+type ProviderScorePolicy = z.infer<typeof ProviderScorePolicySchema>;
+/** Common evidence inputs and the provider's derivation are deliberately separate. */
+declare const ProviderScoreResultSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"provider_score_result">;
+    schemaVersion: z.ZodLiteral<"0.1.0">;
+    id: z.ZodString;
+    provider: z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        url: z.ZodOptional<z.ZodURL>;
+    }, z.core.$strict>;
+    producedAt: z.ZodISODateTime;
+    policy: z.ZodObject<{
+        sha256: z.ZodString;
+        byteLength: z.ZodNumber;
+        id: z.ZodString;
+        version: z.ZodString;
+    }, z.core.$strict>;
+    subject: z.ZodObject<{
+        kind: z.ZodEnum<{
+            measurement: "measurement";
+            case: "case";
+            record: "record";
+            claim: "claim";
+            product: "product";
+            source: "source";
+            collection: "collection";
+        }>;
+        id: z.ZodString;
+    }, z.core.$strict>;
+    inputScope: z.ZodObject<{
+        id: z.ZodString;
+        description: z.ZodString;
+    }, z.core.$strict>;
+    inputs: z.ZodArray<z.ZodObject<{
+        sha256: z.ZodString;
+        byteLength: z.ZodNumber;
+        ref: z.ZodString;
+        title: z.ZodString;
+        mediaType: z.ZodString;
+    }, z.core.$strict>>;
+    derivation: z.ZodArray<z.ZodObject<{
+        sha256: z.ZodString;
+        byteLength: z.ZodNumber;
+        ref: z.ZodString;
+        title: z.ZodString;
+        mediaType: z.ZodString;
+    }, z.core.$strict>>;
+    applicability: z.ZodObject<{
+        status: z.ZodEnum<{
+            applicable: "applicable";
+            not_applicable: "not_applicable";
+            undetermined: "undetermined";
+        }>;
+        reason: z.ZodString;
+    }, z.core.$strict>;
+    missingInputs: z.ZodArray<z.ZodObject<{
+        ref: z.ZodString;
+        description: z.ZodString;
+    }, z.core.$strict>>;
+    limitations: z.ZodArray<z.ZodString>;
+    outcome: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        status: z.ZodLiteral<"scored">;
+        value: z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>;
+        gradeId: z.ZodOptional<z.ZodString>;
+        explanation: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        status: z.ZodLiteral<"unavailable">;
+        reasonCode: z.ZodEnum<{
+            not_applicable: "not_applicable";
+            undetermined: "undetermined";
+            missing_inputs: "missing_inputs";
+            not_calculated: "not_calculated";
+        }>;
+        explanation: z.ZodString;
+    }, z.core.$strict>], "status">;
+}, z.core.$strict>;
+type ProviderScoreResult = z.infer<typeof ProviderScoreResultSchema>;
+declare function providerScorePolicyJsonSchema(): Record<string, unknown>;
+declare function providerScoreResultJsonSchema(): Record<string, unknown>;
+type Status$1 = "passed" | "failed" | "not_checked";
+interface ProviderScoringIssue {
+    code: string;
+    pointer: string;
+    message: string;
+}
+interface ProviderScorePolicyValidation {
+    success: boolean;
+    checks: {
+        structural: Status$1;
+        semantic: Status$1;
+    };
+    issues: ProviderScoringIssue[];
+    policy: ProviderScorePolicy | null;
+}
+/** JSON Schema covers structure; this checks bounds, identifiers and complete non-overlapping grade bands. */
+declare function validateProviderScorePolicy(input: unknown): ProviderScorePolicyValidation;
+/** Assign a provider's declared band, without recomputing or endorsing its score. */
+declare function providerScoreGrade(policy: ProviderScorePolicy, value: number | string): {
+    id: string;
+    label: string;
+} | null;
+interface ProviderScoreEvaluationOptions {
+    policyBytes?: Uint8Array;
+    inputFiles?: ReadonlyMap<string, Uint8Array>;
+    derivationFiles?: ReadonlyMap<string, Uint8Array>;
+    methodFiles?: ReadonlyMap<string, Uint8Array>;
+}
+interface ProviderScoreEvaluation {
+    success: boolean;
+    checks: {
+        structural: Status$1;
+        semantic: Status$1;
+        external: Status$1;
+    };
+    issues: ProviderScoringIssue[];
+    files: {
+        ref: string;
+        status: Status$1;
+        expectedSha256: string;
+        expectedByteLength: number;
+        actualSha256?: string;
+        actualByteLength?: number;
+    }[];
+    policy: ProviderScorePolicy | null;
+    result: ProviderScoreResult | null;
+    grade: {
+        id: string;
+        label: string;
+    } | null;
+    policyExecution: "not_checked";
+    providerAuthentication: "not_checked";
+    scientificValidity: "not_checked";
+    subjectResolution: "not_checked";
+}
+/** Checks declarations and supplied bytes only. Does not fetch, execute a policy, resolve a subject or authenticate a provider. */
+declare function evaluateProviderScore(input: unknown, options?: ProviderScoreEvaluationOptions): Promise<ProviderScoreEvaluation>;
+interface ProviderScoreComparison {
+    eligibleForComparison: boolean;
+    status: "eligible_for_comparison" | "not_eligible";
+    reasons: string[];
+    left: ProviderScoreEvaluation;
+    right: ProviderScoreEvaluation;
+    sharedInputDigests: string[];
+    statisticalIndependence: "not_checked";
+}
+/** Conservative eligibility for inspecting declared results side by side; never computes a winner, average or scientific equivalence. */
+declare function compareProviderScores(leftInput: unknown, rightInput: unknown, options?: {
+    left?: ProviderScoreEvaluationOptions;
+    right?: ProviderScoreEvaluationOptions;
+}): Promise<ProviderScoreComparison>;
+
 declare const ASSESSMENT_SUMMARY_EVALUATION_SCHEMA_ID = "urn:disclosureos:experimental:assessment-summary-evaluation:0.1.0";
 declare const ASSESSMENT_SUMMARY_EVALUATION_POLICY: Readonly<{
     readonly id: "urn:disclosureos:experimental:policy:assessment-summary-evaluation";
@@ -149,4 +374,4 @@ interface AssessmentSummaryEvaluationResult {
 /** Pins the summary's declared history input. Referenced source/product bytes are not verified or fetched. */
 declare function evaluateAssessmentSummaryEvaluation(input: unknown, options?: AssessmentSummaryEvaluationOptions): Promise<AssessmentSummaryEvaluationResult>;
 
-export { ASSESSMENT_SUMMARY_EVALUATION_POLICY, ASSESSMENT_SUMMARY_EVALUATION_SCHEMA_ID, ASSESSMENT_SUMMARY_POLICY, type AssessmentSummaryEvaluation, type AssessmentSummaryEvaluationOptions, type AssessmentSummaryEvaluationResult, AssessmentSummaryEvaluationSchema, type AssessmentSummaryGroup, type AssessmentSummaryReceipt, type AssessmentSummaryResult, type DeclarationGroup, assessmentSummaryEvaluationJsonSchema, evaluateAssessmentSummaryEvaluation, summarizeClaimHistory };
+export { ASSESSMENT_SUMMARY_EVALUATION_POLICY, ASSESSMENT_SUMMARY_EVALUATION_SCHEMA_ID, ASSESSMENT_SUMMARY_POLICY, type AssessmentSummaryEvaluation, type AssessmentSummaryEvaluationOptions, type AssessmentSummaryEvaluationResult, AssessmentSummaryEvaluationSchema, type AssessmentSummaryGroup, type AssessmentSummaryReceipt, type AssessmentSummaryResult, type DeclarationGroup, PROVIDER_SCORE_POLICY_SCHEMA_ID, PROVIDER_SCORE_RESULT_SCHEMA_ID, type ProviderScoreComparison, type ProviderScoreEvaluation, type ProviderScoreEvaluationOptions, type ProviderScorePolicy, ProviderScorePolicySchema, type ProviderScorePolicyValidation, type ProviderScoreResult, ProviderScoreResultSchema, type ProviderScoringIssue, assessmentSummaryEvaluationJsonSchema, compareProviderScores, evaluateAssessmentSummaryEvaluation, evaluateProviderScore, providerScoreGrade, providerScorePolicyJsonSchema, providerScoreResultJsonSchema, summarizeClaimHistory, validateProviderScorePolicy };