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:
{
"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:
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):
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:
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':
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:
(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:
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:
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:
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:
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:
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:
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:
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:
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:
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.