SoulField OS

_Truth Harness v3.0 — Archetypal AI Council OS_

Overview

The SoulField System is a modular, AI-powered orchestration environment that blends spiritual technology, knowledge architecture, and automated truth verification.

It provides a foundation for running the Truth Harness v3.0, an integrity and validation engine for archetypal AI entities like Aurea and the Council.

---

Core Features

• Truth Harness v3.0 — ensures all outputs meet structural coherence, language clarity, universality, and role-specific integrity.
• Aiden Bridge — handles cross-process communication, receipts, and claims logging.
• Receipts & Claims System — logs AI interactions with fact/intuition tags, evidence references, and symbolic impressions.
• Service & Automation Hooks — optional systemd services for auto-starting bridges and scheduled cleanups.
• Developer-Friendly Structure — split into clear directories for API/UI, bridges, configs, and documentation.

---

Folder Structure

SoulField-System/
 ├── aiden/           # Aiden bridge code & Truth Harness passthrough
 ├── soulfield-v2-mvp/ # API/UI for Aurea, Council, truthz endpoint, hooks
 ├── agents/           # Archetype agents & logic
 ├── claims/           # Stored claim logs
 ├── receipts/         # Stored receipts from queries
 ├── docs/             # Oversoul primer, session resumes, project kit
 ├── public/           # UI & static assets
 ├── .gitignore        # Ignore rules for secrets & runtime data
 └── README.md         # This file

---

Quick Start

# 1. Clone the repository
git clone https://github.com/mrhpython/SoulField-System.git
cd SoulField-System/soulfield-v2-mvp

# 2. Set up environment
cp .env.example .env   # Fill in your API keys and config

# 3. Install dependencies
npm install

# 4. Start the development server
npm start

---

Roadmap

See ROADMAP.md for planned features and milestones.