https://github.com/ekwator/truth-training
Cross-platform project: Rust Core, Actix-web, SQLite, P2P sync (UDP+HTTP), WebSockets, OpenAPI, TypeScript/React, Tauri, Kotlin/Android, Swift/iOS
https://github.com/ekwator/truth-training
actix-web android cli cross-platform cursor cursor-ai cursor-ide http ios kotlin p2p react rust spec-kit sqlite swift tauri typescript udp websockets
Last synced: 9 days ago
JSON representation
Cross-platform project: Rust Core, Actix-web, SQLite, P2P sync (UDP+HTTP), WebSockets, OpenAPI, TypeScript/React, Tauri, Kotlin/Android, Swift/iOS
- Host: GitHub
- URL: https://github.com/ekwator/truth-training
- Owner: ekwator
- License: other
- Created: 2025-09-01T04:21:17.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2026-01-17T22:11:02.000Z (14 days ago)
- Last Synced: 2026-01-18T00:23:41.786Z (14 days ago)
- Topics: actix-web, android, cli, cross-platform, cursor, cursor-ai, cursor-ide, http, ios, kotlin, p2p, react, rust, spec-kit, sqlite, swift, tauri, typescript, udp, websockets
- Language: Kotlin
- Homepage: https://github.com/ekwator/truth-training
- Size: 4 MB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.txt
- Security: SECURITY.md
Awesome Lists containing this project
README
# π Truth Training β The Network of Anonymous Trust
*(Created in Cursor AI IDE)*
## π Privacy and Confidentiality
**Truth Training is built on the fundamental principle of confidentiality**: **No user actions are logged or persistently stored**. The application does not track, record, or save any user interactions, navigation patterns, clicks, or behavioral data. This ensures complete privacy and anonymity β users can interact with the system without leaving any trace of their actions.
**Key Privacy Guarantees:**
- β
**No User Action Logging**: No clicks, navigation, or interaction history is stored
- β
**No Persistent User Tracking**: No identifiers, session data, or behavioral analytics
- β
**No Telemetry Collection**: No user activity is transmitted or stored
- β
**Ephemeral Logs Only**: Only system-level logs (errors, sync operations) are temporarily stored for debugging purposes
This confidentiality principle is enforced across all platforms (Desktop UI, Android, Server, CLI) and is a core architectural requirement.
---
Truth Training is a decentralized communication ecosystem where **truth travels without identity**.
Events move freely through the network β encrypted, verified, and echoed by others β creating a distributed field of awareness instead of a chain of messages.
Each reflection of an event confirms its existence; each independent echo increases its credibility.
Like confession without a priest, users anonymously release truths into the network β and the collective conscience responds.
It can serve as an **alternative to voting systems**, measuring the authenticity of social signals and public sentiment not through ballots, but through shared evaluation of facts.
Unlike LoRa-based mesh systems such as **Meshtastic**, Truth Training builds a **mesh of minds, not hardware** β using Wi-Fi and the Internet as carriers of encrypted meaning, forming an autonomous infrastructure of human understanding.
Originally conceived to combat fraud, Truth Training evolves into a **self-learning immunity against falsehood** β distinguishing truth from deception through context, correlation, and collective resonance.
And beyond communication, Truth Training enables **teamwork without a team lead** β a coordination model where decisions arise from **collective consensus**, not hierarchy, creating a self-organizing environment for groups and projects.
Ultimately, without network connectivity, the application can serve as a **personal electronic diary** β a private space for individual reflection and truth-tracking.
---
## 1. Core Idea and Purpose of the System
π§ **Truth Training β Operating Logic and Computational Model**
For more details see : [docs/model_core.md](docs/model_core.md)
**Truth Training** is a system for collective evaluation of events and statements, based on the principle of the *wisdom of the crowd*.
It does not assume the presence of a central arbiter of truth and does not require expert knowledge from individual participants.
In the system, truth:
- is not declared
- is not voted on directly
- is not determined by authority
Instead, it emerges statistically β as a stable result of independent evaluations accumulated over time.
---
## 2. Core Entity: Event (Truth Event)
An **Event** is a statement or fact that has been recorded in the system.
An event:
- appears as unverified
- circulates within the system
- receives independent evaluations
- over time is either reinforced or rejected
### Key Logic
- No event is immediately considered true or false
- Truthfulness is a **process**, not a state
---
## 3. Event Code (Field Code)
Each event has an **8-bit code** used not for semantic meaning, but for protocol-level propagation logic.
In the described model, the code controls:
- event transmission
- retransmission
- termination of propagation
The code:
- does not directly participate in truth calculation
- can be algorithmically modified during propagation
This allows the system to:
- prevent infinite propagation
- implement P2P logic without changing data structures
- separate transport logic from evaluation logic
---
## 4. Event Evaluation (Impact)
### What Is Impact
**Impact** is a subjective assessment of the *consequences* of an event, not an evaluation of the fact itself.
Impact answers the question:
> βWhat effect did (or will) this event have?β
Each Impact:
- is linked to a specific event
- has a type (reputation, finance, emotions, etc.)
- has a sign:
- positive
- negative
- is time-stamped
### Key Principle
The system does not ask *βIs this true?β*
It asks:
> βWhat happened as a result of this being accepted as true?β
## 5. Judgment Assessment (Truth Determination)
### What Is Judgment
**Judgment** is an individual user's assessment of an event's truthfulness, forming the basis for collective truth determination.
Judgment answers the question:
> "Is this event true or false based on my understanding?"
Each Judgment:
- is linked to a specific event
- represents individual truth assessment
- contributes to collective truth score
- preserves user anonymity
- is time-stamped
### Truth Calculation Based on Judgments
The truthfulness of an event emerges from the aggregation of individual judgments:
Event truthfulness β
(Ξ£ positive judgments β Ξ£ negative judgments)
Γ· total number of judgments
**Key Principle:**
Truth is determined through collective independent assessments rather than direct declaration or voting.
---
## 6. Impact vs Judgment
While Impact evaluates consequences, Judgment determines truthfulness:
- **Impact**: "What effect did this have?" (consequence-focused)
- **Judgment**: "Is this true or false?" (truth-focused)
---
## 7. Truth Calculation (Implicit Truth Score)
The truthfulness of an event is not stored as a field and is not explicitly defined.
It is derived from:
- the number of Impact evaluations
- their direction (positive / negative)
- accumulation over time
- stability of the result
### Simplified Calculation Model
Event truthfulness β
(Ξ£ positive impacts β Ξ£ negative impacts)
Γ· number of events
**Important:**
- early evaluations carry less weight
- stable evaluations gain significance over time
- sharp changes indicate conflicting interpretations
---
## 8. The "Wisdom of the Crowd" Principle
The system embeds key conditions for valid collective evaluation:
- **Independence of participants**
- participants do not see othersβ evaluations
- **Diversity of sources**
- different contexts, motivations, experiences
- **Sufficient number of evaluations**
- the law of large numbers applies
- **Absence of a central truth authority**
Truth emerges as statistical equilibrium, not as a decision.
---
## 9. Evaluation Context
Each event is linked to a **context**, which defines:
- domain (social, financial, political, etc.)
- form (truth, deception, omission)
- cause
- development path
- effect
Context:
- does not define truth
- provides a frame for interpreting consequences
---
## 10. Aggregated Metrics (Progress Metrics)
The system periodically computes aggregates:
- total number of events
- ratio of positive to negative impacts
- trend (slope of trust change)
These metrics:
- are not used for decision-making
- serve as system state indicators
- allow observation of dynamics
---
## 11. Database Schema (Semantic Overview)
### Core Tables
#### `truth_events`
Stores events:
- description
- context
- timestamps
- discovery status
- protocol propagation code
#### `impact`
Stores impacts:
- link to event
- impact type
- sign (positive / negative)
- timestamp
#### `context`
Multifactor interpretation model:
- category
- form
- cause
- development
- effect
#### `judgment`
Stores judgment:
- link to event
- truth assessment (true/false)
- timestamp
- user anonymity identifier
#### `progress_metrics`
Aggregated system state indicators
---
## 12. The Main Consequence
**Truth Training:**
- does not fight lies directly
- does not require acknowledging falsehood
- does not force truth
Instead, the system:
- allows events to βlive through timeβ
- records consequences
- shows which statements remain stable over time
Truth here is:
> that which continues to function without destroying the system
---
## 13. Why This Logic Is Resilient
- lies may be profitable in the short term
- but their consequences accumulate
- collective evaluation does not require trust in participants
- only trust in statistics
Thus, the system naturally identifies and suppresses fraud β
not through control, but through observation of consequences.
---
## Release Surfaces
- **Core Library** β integration guide: [docs/quickstart_core.md](docs/quickstart_core.md)
- **CLI** β quickstart: [docs/quickstart_cli.md](docs/quickstart_cli.md), reference: [docs/CLI_Usage.md](docs/CLI_Usage.md)
- **Server** β quickstart: [docs/quickstart_server.md](docs/quickstart_server.md), deployment: [docs/Deployment.md](docs/Deployment.md)
- **Desktop UI** β quickstart: [docs/quickstart_desktop.md](docs/quickstart_desktop.md), reference: [docs/UI_Desktop.md](docs/UI_Desktop.md)
- **Android Mobile** β quickstart: [docs/quickstart_android.md](docs/quickstart_android.md), architecture: [docs/android_discovery_architecture.md](docs/android_discovery_architecture.md)
- **iOS Mobile** β quickstart: [docs/quickstart_ios.md](docs/quickstart_ios.md)
## π¦ Downloads & Pre-built Binaries
Ready-to-use binaries and installers for all platforms are available in the [GitHub Releases section](https://github.com/ekwator/truth-training/releases). Download pre-compiled executables, installers, and packages for:
- **Desktop Applications**: Linux (AppImage, DEB, RPM), Windows (MSI, EXE), macOS (DMG, PKG)
- **Android**: APK and AAB packages for direct installation
- **iOS**: IPA packages and App Store builds
- **Server**: RPM and DEB packages for Linux distributions, PKG for macOS
- **CLI Tools**: Pre-compiled `truthctl` binaries for all supported platforms
- **Core Libraries**: Static and dynamic libraries (`.a`, `.so`, `.dylib`) for integration
All releases include checksums (SHA256) for verification and are signed for security. Visit the [releases page](https://github.com/ekwator/truth-training/releases) to download the latest stable version or development builds.
## Documentation Entry Points
- [docs/README.md](docs/README.md) β Human-readable, narrative depth
- [spec/README.md](spec/README.md) β AI-focused directives and constraints
- [docs/Documentation_Refactor_Overview.md](docs/Documentation_Refactor_Overview.md) β Pipeline summary
- [docs/Documentation_Refactor_Inventory.md](docs/Documentation_Refactor_Inventory.md) β Inventory instructions
- [docs/Documentation_Refactor_Links.md](docs/Documentation_Refactor_Links.md) β Link validation workflow