Wiki source code of Specification
Last modified by Robert Schaub on 2025/12/18 12:03
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | {{warning title="Version 0.9.32 (Draft)"}} | ||
| 2 | This document describes the **Specification** of FactHarbor. It is a working draft. | ||
| 3 | {{/warning}} | ||
| 4 | = Specification = | ||
| 5 | This section defines the technical architecture, data models, and functional requirements of FactHarbor. | ||
| 6 | == 1. Mission == | ||
| 7 | **FactHarbor brings clarity and transparency to a world full of unclear, controversial, and misleading information by shedding light on the context, assumptions, and evidence behind claims — empowering people to better understand and judge wisely.** | ||
| 8 | == 2. Purpose == | ||
| 9 | Modern society faces a deep informational crisis: | ||
| 10 | * Misinformation spreads faster than corrections. | ||
| 11 | * High-quality evidence is buried under noise. | ||
| 12 | * Meanings shift depending on context — but this is rarely made explicit. | ||
| 13 | * Users lack tools to understand *why* information conflicts. | ||
| 14 | * Claims are evaluated without clearly defined assumptions. | ||
| 15 | FactHarbor introduces structure, transparency, and comparative reasoning. It provides: | ||
| 16 | * Multiple valid scenarios for ambiguous claims. | ||
| 17 | * Transparent assumptions, definitions, and boundaries. | ||
| 18 | * Full evidence provenance. | ||
| 19 | * Likelihood-based verdicts (one per scenario). | ||
| 20 | * Versioning and temporal change tracking. | ||
| 21 | * Hybrid AI–human collaboration. | ||
| 22 | == 3. Core Concepts == | ||
| 23 | * **Claim**: A statement needing structured interpretation. | ||
| 24 | * **Scenario**: Definitions, assumptions, boundaries, and context. | ||
| 25 | * **Evidence**: Information supporting or contradicting a scenario. | ||
| 26 | * **Verdict**: Likelihood estimate based on weighted evidence **for a specific scenario**. | ||
| 27 | * **Summary View**: User-facing overview. | ||
| 28 | * **AKEL**: AI subsystem for drafting and assistance (human supervised). | ||
| 29 | * **Federation**: Decentralized nodes hosting datasets. | ||
| 30 | * **Truth Landscape**: The aggregation of multiple scenario-dependent verdicts showing where a claim is plausible. | ||
| 31 | * **Time Evolution**: Versioning of all entities allowing historical views. | ||
| 32 | == 4. Functional Lifecycle == | ||
| 33 | The system follows a six-step lifecycle: | ||
| 34 | 1. **Claim submission**: Automatic extraction and normalisation; Cluster detection. | ||
| 35 | 2. **Scenario building**: Clarifying definitions and assumptions; AI proposals with human approval. | ||
| 36 | 3. **Evidence handling**: AI-assisted retrieval; Human assessment of reliability; Explicit scenario linking. | ||
| 37 | 4. **Verdict creation**: AI-generated draft verdicts; Human refinement; Reasoning explanations. | ||
| 38 | 5. **Public presentation**: Concise summaries; Truth Landscape comparison; Deep dives. | ||
| 39 | 6. **Time evolution**: Versioning of all entities; Re-evaluation triggers when evidence changes. | ||
| 40 | == 5. Chapters == | ||
| 41 | This specification is organized into the following sections: | ||
| 42 | === Core Documentation === | ||
| 43 | * [[AI Knowledge Extraction Layer (AKEL)>>FactHarbor.Specification.AI Knowledge Extraction Layer (AKEL).WebHome]] - AI system architecture | ||
| 44 | * [[Architecture>>FactHarbor.Specification.Architecture.WebHome]] - System architecture and design | ||
| 45 | * [[Automation>>FactHarbor.Specification.Automation.WebHome]] - Automated processes and workflows | ||
| 46 | * [[Data Model>>FactHarbor.Specification.Data Model.WebHome]] - Database schema and entities | ||
| 47 | * [[Requirements>>FactHarbor.Specification.Requirements.WebHome]] - Functional and non-functional requirements | ||
| 48 | * [[Workflows>>FactHarbor.Specification.Workflows.WebHome]] - Process workflows | ||
| 49 | === Diagrams === | ||
| 50 | * [[Diagrams>>FactHarbor.Specification.Diagrams.WebHome]] - Visual architecture and workflow diagrams | ||
| 51 | === Additional Resources === | ||
| 52 | * [[Data Examples>>FactHarbor.Specification.Examples.WebHome]] - Sample data structures | ||
| 53 | * [[FAQ>>FactHarbor.Specification.FAQ.WebHome]] - Frequently asked questions | ||
| 54 | * [[Federation & Decentralization>>FactHarbor.Specification.Federation & Decentralization.WebHome]] - Future federation plans | ||
| 55 | * [[Review & Data Use>>FactHarbor.Specification.Review & Data Use.WebHome]] - Data usage policies |