|
| 1 | +<!-- |
| 2 | +SPDX-License-Identifier: CC-BY-SA-4.0 |
| 3 | +SPDX-FileCopyrightText: 2025-2026 Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk> |
| 4 | +--> |
| 5 | + |
| 6 | +Jonathan D.A. Jewell \<[j.d.a.jewell@open.ac](j.d.a.jewell@open.ac).uk\> |
| 7 | +:toc: macro :toclevels: 2 :license: MPL-2.0 :url-repo: |
| 8 | +<https://github.com/hyperpolymath/live-files> |
| 9 | + |
| 10 | +[](LICENSE)  [](https://github.com/hyperpolymath/live-files/actions/workflows/hypatia-scan.yml) |
| 12 | + |
| 13 | +<div id="toc"> |
| 14 | + |
| 15 | +</div> |
| 16 | + |
| 17 | +# Overview |
| 18 | + |
| 19 | +**live-files** is the RSR 2026 Control Plane for the Hyperpolymath |
| 20 | +Epistemic Fleet. It contains the orchestration logic for all satellite |
| 21 | +and core repos, managing the tier-based organisational structure of 275+ |
| 22 | +repositories across the ecosystem. |
| 23 | + |
| 24 | +# Features |
| 25 | + |
| 26 | +- **Filing logic** (`just` `file`) — Moves root-level repos into their |
| 27 | + correct tiers (Core, Governance, Infrastructure, SSG, MCP, Research) |
| 28 | + |
| 29 | +- **Restoration** (`must` `restore`) — Fixes symlinks and directory |
| 30 | + structures |
| 31 | + |
| 32 | +- **Visibility** (`just` `v`) — Two-ply colour-coded map of the |
| 33 | + Epistemic Fleet |
| 34 | + |
| 35 | +- **Tier mapping** — Hierarchical organisation of the entire repo |
| 36 | + ecosystem |
| 37 | + |
| 38 | +# Quick Start |
| 39 | + |
| 40 | +```bash |
| 41 | +# View the Epistemic Fleet map |
| 42 | +just v |
| 43 | + |
| 44 | +# File repos into their correct tiers |
| 45 | +just file |
| 46 | + |
| 47 | +# Restore broken symlinks |
| 48 | +./must restore |
| 49 | +``` |
| 50 | + |
| 51 | +# Project Structure |
| 52 | + |
| 53 | + live-files/ |
| 54 | + +-- 0-AI-MANIFEST.a2ml # AI agent entry point |
| 55 | + +-- Justfile # Task runner (no Makefiles) |
| 56 | + +-- must # Restoration utility |
| 57 | + +-- scripts/ |
| 58 | + | +-- map_ecosystem.sh # Colour-coded fleet map |
| 59 | + +-- .machine_readable/ # SCM metadata files |
| 60 | + | +-- .machine_readable/6a2/STATE.a2ml |
| 61 | + | +-- .machine_readable/6a2/META.a2ml |
| 62 | + | +-- .machine_readable/6a2/ECOSYSTEM.a2ml |
| 63 | + | +-- .machine_readable/6a2/AGENTIC.a2ml |
| 64 | + | +-- .machine_readable/6a2/NEUROSYM.a2ml |
| 65 | + | +-- .machine_readable/6a2/PLAYBOOK.a2ml |
| 66 | + +-- .well-known/ # Protocol files |
| 67 | + | +-- security.txt |
| 68 | + | +-- humans.txt |
| 69 | + | +-- ai.txt |
| 70 | + +-- .github/ |
| 71 | + +-- workflows/ # CI/CD workflows |
| 72 | + +-- CODEOWNERS |
| 73 | + |
| 74 | +# Standards |
| 75 | + |
| 76 | +- No Makefiles — uses Just/Nickel only |
| 77 | + |
| 78 | +- Oxford British English throughout |
| 79 | + |
| 80 | +- nerdctl for all container tasks |
| 81 | + |
| 82 | +- MPL-2.0 licence |
| 83 | + |
| 84 | +# Licence |
| 85 | + |
| 86 | +This project is licensed under the [Palimpsest Licence |
| 87 | +(MPL-2.0)](LICENSE). |
| 88 | + |
| 89 | +Copyright (c) 2025-2026 Jonathan D.A. Jewell (hyperpolymath) |
| 90 | +\<[j.d.a.jewell@open.ac](j.d.a.jewell@open.ac).uk\> |
0 commit comments