Eve library

Veritas and Metis · chapter 1 · evidence · 7 October 2026

Evidence

Revision 3

On this page

Pinned excerpts and command output behind the chapter's slides (guide veritas) and its brief (Eve document 2f4215a8-eb57-4bde-8ab0-64b52e6e637e). Every excerpt is the repository at commit b6f1ccf1c111a1b364faa114524aad0181975ed5, copied by the command shown above it. The test runs are of the working tree on 7 October 2026. No claim was published or corrected against a live service.

Counts and constants read from the code#

Produced by check-data.py in docs/audits/presentation-center-eve-redesign-veritas/2026-10-07/, which reads each value from the pinned source and compares it with the words on the slides. All twenty-one comparisons were equal. The values it read:

json
{
 "sourceKinds": 15,
 "claimClasses": 9,
 "stances": [
  "supports",
  "refutes",
  "contextualizes",
  "contested",
  "neutral"
 ],
 "qualityBands": [
  "high",
  "mixed",
  "low",
  "contested"
 ],
 "confidenceBands": 6,
 "invariants": [
  "Well-supported claims require at least two supporting sources.",
  "Unsupported claims cannot carry supporting sources.",
  "Contested claims require at least one counter-source.",
  "Retracted sources require retractedAt.",
  "Retracted sources require a retraction reason.",
  "Evidence item claimId must be declared in claimIds.",
  "Evidence item sourceId must be declared in sourceIds."
 ],
 "qualityFactors": [
  "peerReviewStatus",
  "primacy",
  "editorialStandards",
  "retractionHistory",
  "expertiseMatch",
  "recency",
  "rightsClarity",
  "independence",
  "crossCorroboration"
 ],
 "overrides": [
  "unattributed-capped-low",
  "recent-retraction-drops-one-band",
  "retracted-forces-contested"
 ],
 "recentRetractionMonths": 12,
 "attestorStandings": [
  "active",
  "probation",
  "suspended",
  "revoked"
 ],
 "credentialKinds": 6,
 "credentialStatuses": [
  "pending",
  "verified",
  "rejected",
  "expired"
 ],
 "attestationScopes": [
  "source",
  "claim",
  "counterclaim"
 ],
 "attestationStatuses": [
  "pending-review",
  "admitted",
  "soft-degraded",
  "withdrawn",
  "revoked",
  "contested"
 ],
 "surfacingOutcomes": [
  "co-equal",
  "mandatory-surface",
  "minority-view-expand",
  "suppress"
 ],
 "defaultFloor": "mixed",
 "consensusThreshold": 0.85,
 "recencyWindowDays": 365,
 "mandatoryReasons": [
  "mandatory-retraction-class-disagreement",
  "mandatory-pluralism-editorial-stance",
  "mandatory-public-safety-topic"
 ],
 "floorFailureSuppressesBeforeBrake": true,
 "brakeNeedsLowCounter": true,
 "hubSections": [
  "latest",
  "key-facts",
  "under-dispute",
  "corrections",
  "background",
  "timeline"
 ],
 "hubSignals": [
  "freshness",
  "engagement",
  "attestation"
 ],
 "gatingNeedsRationale": true,
 "readCapabilities": 10,
 "adapterRoles": [
  "shell",
  "admin",
  "assistant"
 ],
 "editorialStates": [
  "approved",
  "archived",
  "awaiting-attestation",
  "contradicts-existing",
  "corrected",
  "counterclaim-pending",
  "draft",
  "in-review",
  "published",
  "retracted",
  "scheduled",
  "verifying-sources"
 ],
 "editorialTransitions": 17,
 "directAwaitingToPublished": false,
 "publishedFrom": [
  "approved",
  "scheduled"
 ],
 "retractNeedsCascadeScope": true,
 "drawnTransitionsNotInMachine": [],
 "jobIdFromCascadeAndTarget": true,
 "jobActions": [
  "metis-revalidate",
  "re-ground"
 ],
 "packagesInJobTargets": false,
 "savedBeforePublished": true,
 "bffRetractRoute": "/api/oshun/domains/veritas/sources/:id/retract",
 "bffNewCascadeIdPerRequest": true,
 "deferredRooms": [
  "veritas",
  "metis"
 ],
 "deferredReason": "domain_deferred_to_v1_2",
 "gateAnswers404": true,
 "governanceSegmentsStayReachable": [
  "admin",
  "operator",
  "studio",
  "tenant",
  "internal"
 ],
 "callersOutsideTheLibrary": {
  "quality composite": [],
  "counterclaim evaluator": [],
  "topic hub composer": [],
  "attestor expiry and revocation": [],
  "editorial state machine import": [],
  "retraction cascade executor": [
   "apps/oshun/bff/src/veritas/retraction-cascade-runtime.ts:91:    const result = await executeVeritasSourceRetractionCascade("
  ]
 }
}

Test runs on the working tree#

npx vitest run in libs/oshun/domain-veritas:

text
 RUN  v4.1.7 /root/workspace/oshun-strong-verify-codex/libs/oshun/domain-veritas
 Test Files  36 passed (36)
      Tests  331 passed (331)
exit 0

npx vitest run in libs/oshun/veritas-cascade-worker (its integration specs are outside the default run):

text
 RUN  v4.1.7 /root/workspace/oshun-strong-verify-codex/libs/oshun/veritas-cascade-worker
 Test Files  2 passed (2)
      Tests  4 passed (4)
exit 0

npx vitest run src/veritas in libs/contracts:

text
 RUN  v4.1.7 /root/workspace/oshun-strong-verify-codex/libs/contracts
 Test Files  1 passed (1)
      Tests  7 passed (7)
exit 0

Which of the library's rules an application calls#

One search for calls to the quality scorer, the counterclaim evaluator, the topic-hub composer, the attestor expiry and revocation functions and the cascade executor, outside the domain library and outside tests. The only call is the BFF's, to the cascade executor.

git grep -n -E '\b(computeSourceQualityComposite|bandFromComposite|evaluateCounterclaimSurfacing|composeTopicHub|evaluateExpiry|softDegradeBandOnExpiry|buildRevocationCascade|executeVeritasSourceRetractionCascade)\(' b6f1ccf1c111 -- apps/oshun libs/oshun ':!libs/oshun/domain-veritas' ':!*.test.ts' ':!*.spec.ts' ':!*.test.tsx' ':!*.spec.tsx':

text
apps/oshun/bff/src/veritas/retraction-cascade-runtime.ts:91:    const result = await executeVeritasSourceRetractionCascade(

The editorial state machine's functions have generic names; the same search for them, kept to lines that mention Veritas, finds none:

git grep -n -E '\b(attemptTransition|replayHistory)\(' b6f1ccf1c111 -- apps/oshun libs/oshun ':!libs/oshun/domain-veritas' ':!*.test.ts' ':!*.spec.ts' | grep -i veritas:

text
(no output)

Counterclaims: the default policy and the order of the decision#

git show b6f1ccf1c111:libs/oshun/domain-veritas/src/counterclaim/surface.ts, lines 50 to 54:

text
   50  export const DEFAULT_SURFACING_POLICY: SurfacingPolicy = {
   51    tenantBandFloor: 'mixed',
   52    consensusThreshold: 0.85,
   53    recencyWindowDays: 365,
   54    publicSafetyTopics: [

git show b6f1ccf1c111:libs/oshun/domain-veritas/src/counterclaim/surface.ts, lines 74 to 123:

text
   74  export function evaluateCounterclaimSurfacing(
   75    input: SurfacingInput
   76  ): CounterclaimSurfacingDecision {
   77    const policy = input.policy ?? DEFAULT_SURFACING_POLICY;
   78    const reasons: string[] = [];
   79  
   80    const conditionResults = {
   81      bandFloor: isBandAtOrAbove(input.counter.bandFloor, policy.tenantBandFloor),
   82      independent: isIndependent(input.sources),
   83      substantive: input.counter.isSubstantive,
   84      contemporary: withinRecencyWindow(
   85        input.counter.publishedAt,
   86        input.primary.publishedAt,
   87        input.evaluatedAt,
   88        policy.recencyWindowDays
   89      ),
   90    };
   91  
   92    if (!conditionResults.bandFloor) reasons.push('counter-below-band-floor');
   93    if (!conditionResults.independent) reasons.push('counter-not-independent-of-primary');
   94    if (!conditionResults.substantive) reasons.push('counter-not-substantive');
   95    if (!conditionResults.contemporary) reasons.push('counter-not-contemporary');
   96  
   97    const mandatoryReasons = mandatorySurfacingReasons(input, policy);
   98    if (mandatoryReasons.length > 0) {
   99      return { surface: 'mandatory-surface', reasons: [...mandatoryReasons, ...reasons] };
  100    }
  101  
  102    if (
  103      !conditionResults.bandFloor ||
  104      !conditionResults.independent ||
  105      !conditionResults.substantive
  106    ) {
  107      return { surface: 'suppress', reasons };
  108    }
  109  
  110    if (!conditionResults.contemporary) {
  111      return { surface: 'suppress', reasons };
  112    }
  113  
  114    const falseBalanceBrake = shouldApplyFalseBalanceBrake(input, policy);
  115    if (falseBalanceBrake.applied) {
  116      return {
  117        surface: 'minority-view-expand',
  118        reasons: [...falseBalanceBrake.reasons, ...reasons],
  119      };
  120    }
  121  
  122    return { surface: 'co-equal', reasons: ['all-conditions-met'] };
  123  }

git show b6f1ccf1c111:libs/oshun/domain-veritas/src/counterclaim/surface.ts, lines 177 to 191:

text
  177  function shouldApplyFalseBalanceBrake(
  178    input: SurfacingInput,
  179    policy: SurfacingPolicy
  180  ): { applied: boolean; reasons: string[] } {
  181    const reasons: string[] = [];
  182    const primaryHigh = bandRank(input.primary.band) >= bandRank('high');
  183    const counterLow = bandRank(input.counter.bandFloor) <= bandRank('low');
  184    const consensusOverThreshold = input.consensusStrength >= policy.consensusThreshold;
  185  
  186    if (primaryHigh && counterLow && consensusOverThreshold) {
  187      reasons.push('false-balance-brake-engaged');
  188      return { applied: true, reasons };
  189    }
  190    return { applied: false, reasons };
  191  }

Quality: the three overrides#

git show b6f1ccf1c111:libs/oshun/domain-veritas/src/source-quality/composite.ts, lines 124 to 138:

text
  124  function differenceInMonths(later: string, earlier: string): number {
  125    const a = Date.parse(later);
  126    const b = Date.parse(earlier);
  127    if (!Number.isFinite(a) || !Number.isFinite(b)) {
  128      return Number.POSITIVE_INFINITY;
  129    }
  130    return Math.max(0, (a - b) / (1000 * 60 * 60 * 24 * 30.4375));
  131  }
  132  
  133  function recentRetraction(input: CompositeScorerInput): boolean {
  134    if (!input.retraction.retracted || !input.retraction.retractedAt) {
  135      return false;
  136    }
  137    return differenceInMonths(input.assessedAt, input.retraction.retractedAt) <= 12;
  138  }

git show b6f1ccf1c111:libs/oshun/domain-veritas/src/source-quality/composite.ts, lines 268 to 287:

text
  268    })();
  269  
  270    let band: SourceQualityBand = baseBand;
  271  
  272    if (overrides.peerReviewStatus === 'unattributed' && (band === 'high' || band === 'mixed')) {
  273      band = 'low';
  274      overrides.onOverride?.('unattributed-capped-low');
  275    }
  276  
  277    if (overrides.recentRetraction) {
  278      band = dropOneBand(band);
  279      overrides.onOverride?.('recent-retraction-drops-one-band');
  280    }
  281  
  282    if (overrides.retracted) {
  283      band = 'contested';
  284      overrides.onOverride?.('retracted-forces-contested');
  285    }
  286  
  287    return band;

The editorial transition rules#

git show b6f1ccf1c111:libs/oshun/domain-veritas/src/editorial/state-machine.ts, lines 58 to 141:

text
   58  export const TRANSITION_RULES: readonly TransitionRule[] = [
   59    {
   60      from: 'draft',
   61      on: 'submit-for-review',
   62      to: 'in-review',
   63      gates: [requireRationale],
   64    },
   65    {
   66      from: 'in-review',
   67      on: 'sources-ingested',
   68      to: 'verifying-sources',
   69      gates: [requireSources],
   70    },
   71    {
   72      from: 'verifying-sources',
   73      on: 'sources-verified',
   74      to: 'awaiting-attestation',
   75      gates: [requireSources, requireSourcesVerified],
   76    },
   77    {
   78      from: 'awaiting-attestation',
   79      on: 'attestation-collected',
   80      to: 'approved',
   81      gates: [requireAttestations],
   82    },
   83    {
   84      from: 'awaiting-attestation',
   85      on: 'contradiction-flagged',
   86      to: 'contradicts-existing',
   87      gates: [requireContradictions],
   88    },
   89    {
   90      from: 'verifying-sources',
   91      on: 'contradiction-flagged',
   92      to: 'contradicts-existing',
   93      gates: [requireContradictions],
   94    },
   95    {
   96      from: 'contradicts-existing',
   97      on: 'contradiction-resolved',
   98      to: 'awaiting-attestation',
   99      gates: [requireContradictions, requireOpenContradictionsResolved],
  100    },
  101    {
  102      from: 'awaiting-attestation',
  103      on: 'counterclaim-required',
  104      to: 'counterclaim-pending',
  105      gates: [requireRationale],
  106    },
  107    {
  108      from: 'approved',
  109      on: 'counterclaim-required',
  110      to: 'counterclaim-pending',
  111      gates: [requireRationale],
  112    },
  113    {
  114      from: 'counterclaim-pending',
  115      on: 'counterclaim-resolved',
  116      to: 'approved',
  117      gates: [requireCounterclaims],
  118    },
  119    { from: 'approved', on: 'schedule', to: 'scheduled', gates: [requireRationale] },
  120    { from: 'scheduled', on: 'publish', to: 'published', gates: [requireRationale] },
  121    { from: 'approved', on: 'publish', to: 'published', gates: [requireRationale] },
  122    { from: 'published', on: 'archive', to: 'archived', gates: [requireRationale] },
  123    {
  124      from: 'published',
  125      on: 'issue-correction',
  126      to: 'corrected',
  127      gates: [requireRationale, requireCascadeScope],
  128    },
  129    {
  130      from: 'published',
  131      on: 'retract',
  132      to: 'retracted',
  133      gates: [requireRationale, requireCascadeScope],
  134    },
  135    {
  136      from: 'corrected',
  137      on: 'retract',
  138      to: 'retracted',
  139      gates: [requireRationale, requireCascadeScope],
  140    },
  141  ];

The cascade: jobs, order and the BFF route#

git show b6f1ccf1c111:libs/oshun/domain-veritas/src/retraction-cascade.ts, lines 98 to 113:

text
   98      downstreamMetisPackageIds,
   99      downstreamMetisLessonIds,
  100      reGroundingJobs: buildCascadeJobTargets({
  101        affectedStoryIds,
  102        affectedClaimIds,
  103        affectedExplainerIds,
  104        affectedEvidencePackIds,
  105        downstreamMetisLessonIds,
  106      }).map((target) => ({
  107        jobId: deterministicUuid(`${input.id}:${target.targetKind}:${target.targetId}`),
  108        targetKind: target.targetKind,
  109        targetId: target.targetId,
  110        action: target.action,
  111        status: jobStatus,
  112        startedAt: input.startedAt,
  113        completedAt,

git show b6f1ccf1c111:libs/oshun/domain-veritas/src/retraction-cascade-execution.ts, lines 111 to 145:

text
  111  export async function executeVeritasSourceRetractionCascade(
  112    input: VeritasSourceRetractionCascadeInput,
  113    deps: ExecuteVeritasRetractionCascadeDeps
  114  ): Promise<VeritasRetractionCascadeExecutionResult> {
  115    const cascade = planVeritasSourceRetractionCascade(input);
  116    const summary = summarizeVeritasRetractionCascade(cascade);
  117  
  118    // Durable first — never dispatch a cascade that isn't persisted.
  119    await deps.persistence.saveCascade(cascade, {
  120      tenantId: deps.tenantId,
  121      contractVersion: deps.contractVersion ?? '1.0.0',
  122    });
  123  
  124    const dispatchedAt = (deps.now?.() ?? new Date()).toISOString();
  125    const event: VeritasRetractionCascadeDispatchEvent = {
  126      cascadeId: cascade.id,
  127      triggerKind: cascade.triggerKind,
  128      triggerSourceId: cascade.triggerSourceId,
  129      status: cascade.status,
  130      jobs: cascade.reGroundingJobs.map((job) => ({
  131        jobId: job.jobId,
  132        targetKind: job.targetKind,
  133        targetId: job.targetId,
  134        action: job.action,
  135      })),
  136      userNotice: cascade.userNotice,
  137      dispatchedAt,
  138    };
  139  
  140    const publishedEventId = await deps.events.publish(
  141      VERITAS_RETRACTION_CASCADE_DISPATCHED_EVENT,
  142      event
  143    );
  144  
  145    return { cascade, summary, publishedEventId };

git show b6f1ccf1c111:apps/oshun/bff/src/veritas/retraction-cascade-runtime.ts, lines 85 to 101:

text
   85    input.app.post('/api/oshun/domains/veritas/sources/:id/retract', async (request, reply) => {
   86      const { id } = request.params as { id: string };
   87      const body = (request.body ?? {}) as RetractBody;
   88      const tenantId = body.tenantId ?? request.authContext?.tenantId ?? 'public';
   89      const operatorId = request.authContext?.userId ?? 'veritas-cascade-runtime';
   90  
   91      const result = await executeVeritasSourceRetractionCascade(
   92        {
   93          id: randomUUID(),
   94          triggerSourceId: id,
   95          affectedStoryIds: body.affectedStoryIds ?? [],
   96          affectedClaimIds: body.affectedClaimIds ?? [],
   97          affectedExplainerIds: body.affectedExplainerIds ?? [],
   98          affectedEvidencePackIds: body.affectedEvidencePackIds ?? [],
   99          downstreamMetisPackageIds: body.downstreamMetisPackageIds ?? [],
  100          downstreamMetisLessonIds: body.downstreamMetisLessonIds ?? [],
  101          noticeText: body.noticeText ?? 'Source retracted.',

What was not kept#

The worker's re-grounding and the reader notices were not run, so there is no log of them. The draft render's measurements and the axe results are in the record directory named above, not in this document.