= DocMatrix

License & Philosophy

This project must declare MPL-2.0-or-later for platform/tooling compatibility.

Philosophy: Palimpsest. The MPL-2.0 (PMPL) text is provided in license/MPL-2.0.txt, and the canonical source is the palimpsest-license repository.

Cross-platform document editor with format tabs (TXT/MD/ADOC/DJOT/ORG/RST/TYP). Gossamer GUI + Ada TUI. Graph visualization, OCR, TTS/STT, Nickel pipelines.

Features

• Format Tabs - View and edit the same document in multiple markup formats

• Unified AST - Lossless conversion between formats

• GUI - Gossamer with ReScript frontend

• TUI - Ada with AdaCurses for terminal usage

• Graph Visualization - ArangoDB for document relationships

• Accessibility - OCR, TTS, STT support

• Pipelines - Nickel-based import/export transformations

Supported Formats

Format	Description
TXT	Plain text
MD	Markdown (CommonMark)
ADOC	AsciiDoc
DJOT	Djot markup
ORG	Org-mode
RST	reStructuredText
TYP	Typst

Quick Start

# Check dependencies
just deps
# Build all components
just build
# Run GUI
just run-gui
# Run TUI
just run-tui

Architecture

crates/
├── formatrix-core/ # AST, parsers, renderers
├── formatrix-gui/ # Gossamer commands
├── formatrix-db/ # ArangoDB client
└── formatrix-pipeline/ # Nickel executor
tui/src/ # Ada TUI source
ui/src/ # ReScript components
pipelines/ # Nickel pipeline definitions
container/ # Wolfi container configs

Development

Prerequisites

• Rust (stable)

• Deno

• GNAT + gprbuild (for TUI)

• GTK4 + WebKit2GTK (for GUI)

Build Commands

just build # Build all
just build-core # Build Rust core only
just build-tui # Build Ada TUI only
just build-ui # Build ReScript UI only
just test# Run all tests
just fmt # Format all code
just lint # Lint all code

Containers

just container-build # Build Wolfi image
just compose-up # Start with ArangoDB
just container-run-tui # Run TUI in container

RSR Compliance

This project follows the Rhodium Standard Repositories specification:

• Tier 2 - Full-featured multi-language project

• See RSR_COMPLIANCE.adoc for details

Related Scripts

Automation scripts from hyperpolymath/scripts:

Script	Purpose
asdfman.sh	Manage asdf plugins and versions
init_bashrc_three_ply.sh	Modular bashrc setup (three-layer architecture)
k-check.sh	Kinoite cluster validation
k-intune.sh	Kinoite tuning scripts
langstrap.sh	Mass language install utilities
sysenv.sh	System environment setup
touchscreen_hunter_killer.sh	Touchscreen calibration/management

These scripts follow the same language policy (Bash, Rust, ReScript, Deno, Gleam, Guile Scheme) and multi-forge mirroring strategy.

License

MPL-2.0 with Palimpsest philosophy.

Links

• Project State

• Ecosystem Position

• Architecture Decisions

• Palimpsest Philosophy