From c40f206d4b58599ef33f062aef1d97542785882e Mon Sep 17 00:00:00 2001 From: hyperpolymath <6759885+hyperpolymath@users.noreply.github.com> Date: Thu, 25 Jun 2026 20:43:52 +0100 Subject: [PATCH] docs(readme): convert README.adoc -> Markdown README.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit README must be real Markdown to render in GitHub community-health, the GitHub profile, and external MCP directories (Glama) — AsciiDoc shows as raw markup there. pandoc asciidoc->GFM, badges fixed to clickable, SPDX header kept as an HTML comment, duplicate README.adoc removed. Co-Authored-By: Claude Opus 4.8 --- README.adoc | 130 --------------------------------------------- README.md | 149 ++++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 149 insertions(+), 130 deletions(-) delete mode 100644 README.adoc create mode 100644 README.md diff --git a/README.adoc b/README.adoc deleted file mode 100644 index 5048832..0000000 --- a/README.adoc +++ /dev/null @@ -1,130 +0,0 @@ -// SPDX-License-Identifier: CC-BY-SA-4.0 -// Copyright (c) Jonathan D.A. Jewell -= MAA Framework -image:https://img.shields.io/badge/OpenSSF-Best_Practices-green?logo=openssourcesecurity[OpenSSF Best Practices,link="https://www.bestpractices.dev/en/projects/new?repo_url=https://github.com/hyperpolymath/maa-framework"] - - -image:https://img.shields.io/badge/License-MPL--2.0-brightgreen.svg[License: MPL-2.0,link="https://www.mozilla.org/en-US/MPL/2.0/"] -:toc: macro -:toclevels: 3 -:icons: font - -A full-stack, open-source paradigm for building verifiably-compliant, secure, and sustainable systems. - -toc::[] - -== Status - -[IMPORTANT] -==== -*Early implementation* — Specification uploads still pending (ROADMAP Phase 1). - -This repository serves as the official hub and governance center for the MAA Framework project. Implementation work lives in-tree under `aletheia/` (the microkernel, Rust); the Certified Null Operation is the standalone `hyperpolymath/absolute-zero` repository, coordinated here (referenced, not vendored as a submodule). A CRG Tier-C test suite (unit, E2E, property, aspect, benchmarks) landed 2026-04-04. Detailed specification documents will be uploaded as development progresses. -==== - -== Overview - -The MAA Framework is an integrated ecosystem comprising: - -[cols="1,3"] -|=== -|Component |Description - -|*MAA Framework* -|Full-stack paradigm for verifiably-compliant, secure, sustainable systems - -|*Oblíbený* -|Reference language designed for the framework - -|*Aletheia* -|Microkernel implementation -|=== - -== Project Scope - -The framework addresses the following domains: - -* *Security & Formal Verification* — Provable correctness guarantees -* *AI Ethics & Axiology* — Value-aligned system design -* *Dependability* — Fault-tolerant, reliable computing -* *Language Design & Compilers* — Purpose-built toolchains -* *Microkernel Architecture* — Minimal trusted computing base -* *RISC-V* — Open hardware architecture support -* *Sustainability* — Resource-efficient computing -* *Economics-as-Code* — Programmable economic primitives -* *Distributed Computing* — BOINC-compatible workloads -* *Reversibility* — Turing-complete/incomplete computation models -* *Web Protocols* — Modern network standards - -== Repository Contents - -=== Currently Available - -[source] ----- -. -├── .claude/CLAUDE.md # Language policy (Hyperpolymath Standard) -├── .github/ -│ ├── CODEOWNERS # Maintainer assignments -│ └── workflows/ # CI wrappers + multi-forge synchronization -├── .machine_readable/ # 6a2 metadata, contractiles, bot directives -├── aletheia/ # Microkernel implementation (Rust) -├── tests/ # E2E, property, aspect tests -├── GOVERNANCE.adoc # Project governance -├── README.adoc # This file -├── EXPLAINME.adoc # Receipts backing README claims -├── ROADMAP.adoc # Development phases -└── SECURITY.md # Vulnerability reporting policy ----- - -=== Infrastructure - -* *Hub-and-spoke mirroring* to GitLab, Codeberg, Bitbucket -* *SHA-pinned GitHub Actions* for supply chain security -* *SSH host key verification* for MITM protection -* *Minimal permission model* (`contents: read`) - -== Language Policy - -This project follows the *Hyperpolymath Standard* for technology choices. - -.Allowed -[%autowidth] -|=== -|Technology |Use Case - -|AffineScript |Primary application code -|Deno |Runtime & package management -|Rust |Performance-critical, systems, WASM -|Tauri 2.0+ / Dioxus |Mobile applications -|Gleam |Backend services (BEAM/JS) -|Guile Scheme |State/meta files -|=== - -See link:.claude/CLAUDE.md[CLAUDE.md] for complete policy. - -== Mirrors - -[horizontal] -GitHub:: https://github.com/hyperpolymath/maa-framework[hyperpolymath/maa-framework] *(canonical)* -GitLab:: Synchronized automatically -Codeberg:: Synchronized automatically -Bitbucket:: Synchronized automatically - -== Security - -See link:SECURITY.md[SECURITY.md] for: - -* Vulnerability reporting procedures -* Security measures implemented -* Secret management practices - -== License - -This project is licensed under the Mozilla Public License, v. 2.0. See the `LICENSE` file for details. - -SPDX-License-Identifier: CC-BY-SA-4.0 - -== Contributing - -Contribution guidelines will be established as the project develops. Currently maintained by https://github.com/hyperpolymath[@hyperpolymath]. diff --git a/README.md b/README.md new file mode 100644 index 0000000..a13f0cb --- /dev/null +++ b/README.md @@ -0,0 +1,149 @@ + + +[![License: MPL-2.0](https://img.shields.io/badge/License-MPL--2.0-brightgreen.svg)](https://www.mozilla.org/en-US/MPL/2.0/) :toc: macro :toclevels: 3 :icons: font + +A full-stack, open-source paradigm for building verifiably-compliant, +secure, and sustainable systems. + +
+ +
+ +# Status + +> [!IMPORTANT] +> **Early implementation** — Specification uploads still pending +> (ROADMAP Phase 1). +> +> This repository serves as the official hub and governance center for +> the MAA Framework project. Implementation work lives in-tree under +> `aletheia/` (the microkernel, Rust); the Certified Null Operation is +> the standalone `hyperpolymath/absolute-zero` repository, coordinated +> here (referenced, not vendored as a submodule). A CRG Tier-C test +> suite (unit, E2E, property, aspect, benchmarks) landed 2026-04-04. +> Detailed specification documents will be uploaded as development +> progresses. + +# Overview + +The MAA Framework is an integrated ecosystem comprising: + +| Component | Description | +|----|----| +| **MAA Framework** | Full-stack paradigm for verifiably-compliant, secure, sustainable systems | +| **Oblíbený** | Reference language designed for the framework | +| **Aletheia** | Microkernel implementation | + +# Project Scope + +The framework addresses the following domains: + +- **Security & Formal Verification** — Provable correctness guarantees + +- **AI Ethics & Axiology** — Value-aligned system design + +- **Dependability** — Fault-tolerant, reliable computing + +- **Language Design & Compilers** — Purpose-built toolchains + +- **Microkernel Architecture** — Minimal trusted computing base + +- **RISC-V** — Open hardware architecture support + +- **Sustainability** — Resource-efficient computing + +- **Economics-as-Code** — Programmable economic primitives + +- **Distributed Computing** — BOINC-compatible workloads + +- **Reversibility** — Turing-complete/incomplete computation models + +- **Web Protocols** — Modern network standards + +# Repository Contents + +## Currently Available + + . + ├── .claude/CLAUDE.md # Language policy (Hyperpolymath Standard) + ├── .github/ + │ ├── CODEOWNERS # Maintainer assignments + │ └── workflows/ # CI wrappers + multi-forge synchronization + ├── .machine_readable/ # 6a2 metadata, contractiles, bot directives + ├── aletheia/ # Microkernel implementation (Rust) + ├── tests/ # E2E, property, aspect tests + ├── GOVERNANCE.adoc # Project governance + ├── README.adoc # This file + ├── EXPLAINME.adoc # Receipts backing README claims + ├── ROADMAP.adoc # Development phases + └── SECURITY.md # Vulnerability reporting policy + +## Infrastructure + +- **Hub-and-spoke mirroring** to GitLab, Codeberg, Bitbucket + +- **SHA-pinned GitHub Actions** for supply chain security + +- **SSH host key verification** for MITM protection + +- **Minimal permission model** (`contents:` `read`) + +# Language Policy + +This project follows the **Hyperpolymath Standard** for technology +choices. + +| Technology | Use Case | +|---------------------|-------------------------------------| +| AffineScript | Primary application code | +| Deno | Runtime & package management | +| Rust | Performance-critical, systems, WASM | +| Tauri 2.0+ / Dioxus | Mobile applications | +| Gleam | Backend services (BEAM/JS) | +| Guile Scheme | State/meta files | + +Allowed + +See CLAUDE for complete +policy. + +# Mirrors + +GitHub +[hyperpolymath/maa-framework](https://github.com/hyperpolymath/maa-framework) +**(canonical)** + +GitLab +Synchronized automatically + +Codeberg +Synchronized automatically + +Bitbucket +Synchronized automatically + +# Security + +See SECURITY for: + +- Vulnerability reporting procedures + +- Security measures implemented + +- Secret management practices + +# License + +This project is licensed under the Mozilla Public License, v. 2.0. See +the `LICENSE` file for details. + +SPDX-License-Identifier: CC-BY-SA-4.0 + +# Contributing + +Contribution guidelines will be established as the project develops. +Currently maintained by +[@hyperpolymath](https://github.com/hyperpolymath).