GlassBox OS

A source-first orchestration and knowledge-indexing toolkit that makes architectural capabilities inspectable through one Python API and MCP surface.

Status: Early-stage research implementation. The repository includes the orchestrator, context/indexing utilities, compatibility MCP adapters, Eco Index experiments, Declarum prototype, tests, and architecture reports. Some component-map entries remain placeholders.

Quick source verification

The non-invasive checks below require only Python 3.11 or newer and do not install packages or modify system configuration:

python -m compileall -q orchestrator mcp-servers mcp_servers scripts tests
python -c "from orchestrator.atomic_ingest import atomic_ingest_session, recover; from orchestrator.discovery_resolver import resolve; print('portable imports: ok')"
python -m orchestrator.cli inspect README.md

For the full dependency installation and six-part foundation smoke suite, see docs/INSTALLING.md. Review the platform-specific commands before running them: the Termux path includes package-manager and optional ADB steps.

Related MCP server: code-auditor-mcp

Architectural commitment

Declare structure first, validate at boundaries, multi-modal access (human / AI / voice / code) through the same declared layer. Engelbart-style intelligence augmentation in 2026 form.

Invariants:

• No neural embedder at any cycle — named-attribute methodology, Claude IS the scorer

• All persistence text-format-dumped at commit time (via gitsqlite + npz2json) — fresh clone = full AI memory, no binary bloat

• Single FastMCP-mux process exposes 7 namespaces — survives Claude Code's 60s startup wall + Android's Phantom Process Killer ceiling

• Atomic multi-store ingest via POSIX rename — no silent stale fusion

Component map (11 layers)

License

Apache-2.0. See LICENSE.