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.

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)

Layer	Component	Status
L1 substrate	declarum	placeholder (Stage 1.1)
L2 cognition	nlke-metacog + nlke-ml + tool_design_assistant	placeholder (Stage 1.1)
L3 voice modality	voice-graph-rag	Cycle 3
L4a inline annotations	claude-context-kit CLAUDE-CTX	Cycle 2
L4b folder maps	aria-personal/ctx-skill + ctx-to-kg.py	placeholder (Stage 1.1)
L4c source AST	indexer (tree-sitter + 5-dim ctx embed)	placeholder (Stage 1.1)
L5 persona-template	4D-persona	Cycle 2
L6 code-analysis	claude-arch-inventory	Cycle 2
L7 RAG	kg-rag-toolkit + sdk-agent	Cycle 3
L8 orchestrator	cascade-ai/mcps/eco-system	placeholder (Stage 1.1)
L9 multi-project	hive-mind	DEFERRED

License

Apache-2.0. See LICENSE.