Mythos Orb

Local visualization dashboard for parsing Mythos Router MEMORY.md files and SWD protocols.

Mythos Orb is a dashboard built to transform the raw engineering logs of Mythos Router into an accessible, searchable, and readable engineering trace.

It provides real-time insights into adaptive thinking buffers, reality-alignment checks, and codebase mutations effectively serving as the recorder for your AI-augmented development sessions.

---

Core Systems

1. SWD Receipts

The heart of the Orb. Every Strict Write Discipline receipt under .mythos/receipts/ is rendered with its full verification trail: per-file operation, before → after state, and the SHA-256 proof that the bytes written to disk match the bytes the engine intended. When the expected hash matches the post-write hash, the file is shown as verified against disk — proof, not vibes.

2. Run Ledger

Browse the apply-run history from .mythos/runs/. Each run shows what was applied vs. what was rejected, with the policy reason for every rejection (sensitive-file blocks, deletes requiring confirmation, and so on), plus a jump-link to the run's receipt.

3. Memory Trace

Navigate MEMORY.md sessions as an interactive timeline. Every action, verification, and drift event is indexed, grouped, and searchable.

4. Diff Visualization

Side-by-side, syntax-highlighted Git diffs (JS/TS, JSX/TSX, JSON, Python, Bash, CSS, Markdown, Go, Rust, YAML) for any session that recorded a commit.

---

Quick Start

1. Clone & Install

git clone https://github.com/thewaltero/mythos-orb.git
cd mythos-orb
npm install

2. Launch the Data Engine

The Orb requires a local Fastify server to parse your MEMORY.md and interface with Git.

npm run server

3. Start the Visualizer

In a separate terminal, launch the Vite dev server:

npm run dev

The dashboard will be active at http://localhost:5173.

---

Configuration

The server environment can be tuned via several variables:

Variable	Default	Description
MEMORY_PATH	../MEMORY.md	Path to the Mythos Router memory file.
REPO_ROOT	dirname(MEMORY_PATH)	Root of the monitored repo. Must contain .mythos/receipts/ and .mythos/runs/ to populate those views.
PORT	3333	Internal API port for the Fastify engine.

---

Architecture

• Frontend: React 19 + TypeScript + Vite
• Styling: Tailwind CSS 4.0 + Lucide React
• Engine: Fastify + Node.js (parses MEMORY.md, .mythos/receipts, .mythos/runs & Git diffs)
• High-Fi Diffs: react-diff-view + refractor

---