live-files

Table of Contents

• Overview
• Features
• Quick Start
• Project Structure
• Standards
• Licence

Overview

live-files is the RSR 2026 Control Plane for the Hyperpolymath Epistemic Fleet. It contains the orchestration logic for all satellite and core repos, managing the tier-based organisational structure of 275+ repositories across the ecosystem.

Features

• Filing logic (just file) — Moves root-level repos into their correct tiers (Core, Governance, Infrastructure, SSG, MCP, Research)

• Restoration (must restore) — Fixes symlinks and directory structures

• Visibility (just v) — Two-ply colour-coded map of the Epistemic Fleet

• Tier mapping — Hierarchical organisation of the entire repo ecosystem

Quick Start

# View the Epistemic Fleet map
just v

# File repos into their correct tiers
just file

# Restore broken symlinks
./must restore

Project Structure

live-files/
+-- 0-AI-MANIFEST.a2ml         # AI agent entry point
+-- justfile                    # Task runner (no Makefiles)
+-- must                        # Restoration utility
+-- scripts/
|   +-- map_ecosystem.sh        # Colour-coded fleet map
+-- .machine_readable/          # SCM metadata files
|   +-- .machine_readable/6a2/STATE.a2ml
|   +-- .machine_readable/6a2/META.a2ml
|   +-- .machine_readable/6a2/ECOSYSTEM.a2ml
|   +-- .machine_readable/6a2/AGENTIC.a2ml
|   +-- .machine_readable/6a2/NEUROSYM.a2ml
|   +-- .machine_readable/6a2/PLAYBOOK.a2ml
+-- .well-known/                # Protocol files
|   +-- security.txt
|   +-- humans.txt
|   +-- ai.txt
+-- .github/
    +-- workflows/              # CI/CD workflows
    +-- CODEOWNERS

Standards

• No Makefiles — uses Just/Nickel only

• Oxford British English throughout

• nerdctl for all container tasks

• PMPL-1.0-or-later licence

Licence

This project is licensed under the Palimpsest Licence (PMPL-1.0-or-later).

Copyright (c) 2025-2026 Jonathan D.A. Jewell (hyperpolymath) <j.d.a.jewell@open.ac.uk>