Specification

This section defines the technical architecture, data models, and functional requirements of FactHarbor.

Core Concepts

FactHarbor structures reasoning about claims into transparent, inspectable steps:

• Claims and Claim Clusters – people submit real-world statements; similar phrasings are grouped.
• Scenarios – each claim is evaluated under clearly defined contexts (assumptions, definitions, boundaries).
• Evidence – sources and data are collected and linked to specific scenarios.
• Verdicts – There is no single verdict for a claim. Instead, there is a distinct verdict for each scenario against which the claim is evaluated.
• Truth Landscape – the aggregation of these multiple scenario-dependent verdicts shows where (under which assumptions) a claim is plausible and where it is not.
• Time Evolution – all important entities (claims, scenarios, evidence links, verdicts) are versioned.

Functional Lifecycle

The system follows a six-step lifecycle:

1. Claim submission: Automatic extraction and normalisation; Cluster detection.
   2. Scenario building: Clarifying definitions and assumptions; AI proposals with human approval.
   3. Evidence handling: AI-assisted retrieval; Human assessment of reliability; Explicit scenario linking.
   4. Verdict creation: AI-generated draft verdicts per scenario; Human refinement; Reasoning explanations.
   5. Public presentation: Concise summaries; Truth Landscape comparison; Deep dives.
   6. Time evolution: Versioning of all entities; Re-evaluation triggers when evidence changes.

Chapters