LumenSyntax Ecosystem

Truth Verification Infrastructure for AI Applications

Documentation • TruthGit • Discord

Quick Start

npx create-lumensyntax

This will:

1. Install TruthGit (Python CLI for truth verification)
2. Install LumenSyntax MCP (Claude integration)
3. Create CLAUDE.md (session configuration)
4. Initialize .truth/ repository (verified claims storage)
5. Configure Claude Code MCP servers

What is LumenSyntax?

LumenSyntax is a truth verification ecosystem for AI applications. It provides:

• Multi-validator consensus on claims
• Cryptographic proofs for verified truths
• Persistent memory across sessions
• Safety guardrails for AI actions

The Three Laws

1. LAW_OF_ROOTS - No truth without traceable source
2. LAW_OF_THE_GAP - Explicit uncertainty, never hallucination
3. LAW_OF_DIGNITY - Expose manipulation by fallacies

Components

Core (100% LumenSyntax)

| Component | Install | Purpose | |-----------|---------|---------| | TruthGit | pip install truthgit | Multi-validator truth verification | | LumenSyntax MCP | npm i -g lumensyntax-mcp | Claude/MCP integration | | CLAUDE.md | Generated | Session startup config | | .truth/ | Generated | Verified claims repository |

Optional Integrations

| Integration | Purpose | |-------------|---------| | Obsidian | Persistent knowledge memory | | Ollama | Local LLM validators |

Usage

Verify a Claim

# Add a claim
truthgit claim "Water boils at 100°C at sea level" --domain physics

# Verify with multiple validators
truthgit verify

# Output:
# ✓ Consensus: 94% (3/3 validators)
# Status: PASSED

Generate Proof

truthgit prove "Water boils at 100°C at sea level"
# Returns cryptographic certificate

Search Verified Claims

truthgit search "boiling point"

Verification Status Types

| Status | Meaning | Action | |--------|---------|--------| | PASSED | Validators reached consensus | Proceed with confidence | | FAILED | Did not meet threshold | Review and correct | | MYSTERY | Legitimate philosophical uncertainty | Preserve all positions | | GAP | Needs human judgment | Escalate to human |

How It Works

┌─────────────────────────────────────────────────────────────────┐
│                         YOUR PROJECT                            │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│   CLAUDE.md          .truth/              knowledge-vault/      │
│   (Config)           (Claims DB)          (Optional Obsidian)   │
│       │                  │                       │              │
│       └──────────────────┼───────────────────────┘              │
│                          ▼                                      │
│                   ┌─────────────┐                               │
│                   │  TruthGit   │                               │
│                   │ (Consensus) │                               │
│                   └──────┬──────┘                               │
│                          │                                      │
│            ┌─────────────┼─────────────┐                        │
│            ▼             ▼             ▼                        │
│       ┌────────┐   ┌────────┐   ┌────────┐                     │
│       │Ollama  │   │ Claude │   │  GPT   │                     │
│       │Hermes3 │   │   API  │   │  API   │                     │
│       └────────┘   └────────┘   └────────┘                     │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

Commands

# Initialize ecosystem
npx create-lumensyntax

# Check status
npx create-lumensyntax status

# Initialize in specific directory
npx create-lumensyntax init --path ./my-project

Related Projects

• TruthGit - Core verification engine (Python)
• LumenSyntax MCP - MCP server for Claude
• LumenSyntax Core - Full platform

License

MIT © LumenSyntax