Skip to Content

Wiki source code of Specification

Version 7.1 by Robert Schaub on 2025/12/11 20:58
Hide last authors
Robert Schaub 7.1 1 {{warning title="Version 0.8r (Draft)"}}
Robert Schaub 2.1 2 This document describes the **Specification** of FactHarbor. It is a working draft.
Robert Schaub 1.1 3 {{/warning}}
4
5 = Specification =
6
7 This section defines the technical architecture, data models, and functional requirements of FactHarbor.
8
Robert Schaub 7.1 9 == Core Concepts ==
10
11 FactHarbor structures reasoning about claims into transparent, inspectable steps:
12
13 * **Claims and Claim Clusters** – people submit real-world statements; similar phrasings are grouped.
14 * **Scenarios** – each claim is evaluated under clearly defined contexts (assumptions, definitions, boundaries).
15 * **Evidence** – sources and data are collected and linked to specific scenarios.
16 * **Verdicts** – each scenario receives a likelihood-based assessment, not an absolute label.
17 * **Truth Landscape** – the set of scenario-dependent verdicts shows where and why a claim seems more or less plausible.
18 * **Time Evolution** – all important entities (claims, scenarios, evidence links, verdicts) are versioned, so it is possible to see *what we believed at time X* and how this changed.
19
20 == Functional Lifecycle ==
21
22 The system follows a six-step lifecycle:
23
24 1. **Claim submission**: Automatic extraction and normalisation; Cluster detection.
25 2. **Scenario building**: Clarifying definitions and assumptions; AI proposals with human approval.
26 3. **Evidence handling**: AI-assisted retrieval; Human assessment of reliability; Explicit scenario linking.
27 4. **Verdict creation**: AI-generated draft verdicts; Human refinement; Reasoning explanations.
28 5. **Public presentation**: Concise summaries; Truth Landscape comparison; Deep dives.
29 6. **Time evolution**: Versioning of all entities; Re-evaluation triggers when evidence changes.
30
Robert Schaub 1.1 31 == Chapters ==
32
33 {{children sort="title"/}}