fix: RSR compliance — fix SPDX headers, resolve template placeholders, add .well-known

hyperpolymath · claude · hyperpolymath · commit cf66c6c38cae · 2026-03-02T08:59:26.000Z
- Fix AGPL-3.0-or-later → PMPL-1.0-or-later in .gitattributes, .gitignore
- Fix wrong email in AI manifest
- Resolve 40+ template placeholders in SECURITY.md, CODE_OF_CONDUCT.md, CONTRIBUTING.md
- Rewrite stale .machine_readable/ SCM files (had language-bridges data)
- Add SPDX headers to all source files
- Add .well-known/ (security.txt, humans.txt, ai.txt)
- Add .github/CODEOWNERS
- Add README.adoc

Co-Authored-By: Claude Opus 4.6 &lt;noreply@anthropic.com&gt;
diff --git a/.ai-instructions.md b/.ai-instructions.md
@@ -1,3 +1,4 @@
+<!-- SPDX-License-Identifier: PMPL-1.0-or-later -->
 # Live-Files: RSR 2026 Control Plane
 
 You are an agent operating on the Hyperpolymath Epistemic Fleet. 
diff --git a/.editorconfig b/.editorconfig
@@ -1,4 +1,5 @@
-# RSR-template-repo - Editor Configuration
+# SPDX-License-Identifier: PMPL-1.0-or-later
+# live-files - Editor Configuration
 # https://editorconfig.org
 
 root = true
diff --git a/.gitattributes b/.gitattributes
@@ -1,4 +1,4 @@
-# SPDX-License-Identifier: AGPL-3.0-or-later
+# SPDX-License-Identifier: PMPL-1.0-or-later
 # RSR-compliant .gitattributes
 
 * text=auto eol=lf
diff --git a/.github/CODEOWNERS b/.github/CODEOWNERS
@@ -0,0 +1,16 @@
+# SPDX-License-Identifier: PMPL-1.0-or-later
+# CODEOWNERS — Defines code ownership for pull request reviews
+# https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-code-owners
+
+# Default owner for everything in the repository
+* @hyperpolymath
+
+# Workflows require maintainer review
+.github/ @hyperpolymath
+
+# Machine-readable metadata
+.machine_readable/ @hyperpolymath
+
+# Security-sensitive files
+SECURITY.md @hyperpolymath
+.well-known/ @hyperpolymath
diff --git a/.gitignore b/.gitignore
@@ -1,4 +1,4 @@
-# SPDX-License-Identifier: AGPL-3.0-or-later
+# SPDX-License-Identifier: PMPL-1.0-or-later
 # RSR-compliant .gitignore
 
 # OS & Editor
diff --git a/.machine_readable/ECOSYSTEM.scm b/.machine_readable/ECOSYSTEM.scm
@@ -1,3 +1,11 @@
 ;; SPDX-License-Identifier: PMPL-1.0-or-later
-(ecosystem (metadata (version "0.1.0") (last-updated "2026-02-08"))
-  (project (name "language-bridges") (purpose "FFI bridges between languages via Zig") (role ffi-infrastructure)))
+(ecosystem (metadata (version "0.2.0") (last-updated "2026-03-02"))
+  (project
+    (name "live-files")
+    (purpose "RSR 2026 Control Plane for the Hyperpolymath Epistemic Fleet")
+    (role control-plane))
+  (related-projects
+    (project "formdb" (relationship epistemic-core))
+    (project "casket-ssg" (relationship ssg-satellite))
+    (project "hypatia" (relationship ci-cd-intelligence))
+    (project "gitbot-fleet" (relationship bot-orchestration))))
diff --git a/.machine_readable/META.scm b/.machine_readable/META.scm
@@ -1,3 +1,11 @@
 ;; SPDX-License-Identifier: PMPL-1.0-or-later
-(meta (metadata (version "0.1.0") (last-updated "2026-02-08"))
-  (project-info (type monorepo) (languages (zig ada gleam idris2 julia ocaml rescript rust swift)) (license "PMPL-1.0-or-later")))
+(meta (metadata (version "0.2.0") (last-updated "2026-03-02"))
+  (project-info
+    (type control-plane)
+    (languages (bash nickel))
+    (license "PMPL-1.0-or-later")
+    (author "Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>"))
+  (architecture-decisions
+    (adr "Use Just/Nickel instead of Make" (status accepted))
+    (adr "Tier-based repo organisation" (status accepted))
+    (adr "nerdctl for all container tasks" (status accepted))))
diff --git a/.machine_readable/STATE.scm b/.machine_readable/STATE.scm
@@ -1,4 +1,14 @@
 ;; SPDX-License-Identifier: PMPL-1.0-or-later
-(state (metadata (version "0.1.0") (last-updated "2026-02-08") (status active))
-  (project-context (name "language-bridges") (purpose "FFI bridges between languages via Zig") (completion-percentage 20))
-  (components (component "ada-zig-ffi") (component "gleam-zig-ffi") (component "idris2-zig-ffi") (component "julia-zig-ffi") (component "ocaml-zig-ffi") (component "rescript-zig-ffi") (component "rust-zig-ffi") (component "swift-zig-ffi") (component "zig-c-ffi") (component "zig-container-ffi") (component "zig-fuse-ext") (component "zig-libgit2-ffi") (component "zig-nickel-ffi") (component "zig-systemd-ffi") (component "zig-wireguard")))
+(state (metadata (version "0.2.0") (last-updated "2026-03-02") (status active))
+  (project-context
+    (name "live-files")
+    (purpose "RSR 2026 Control Plane — orchestration logic for all satellite and core repos in the Hyperpolymath Epistemic Fleet")
+    (completion-percentage 90))
+  (components
+    (component "filing-logic" (status complete) (description "Tier-based organisation via just file"))
+    (component "restoration" (status complete) (description "Symlink fixing via must restore"))
+    (component "visibility" (status active) (description "Colour-coded tier map via just v"))
+    (component "tier-mapping" (status complete) (description "Core/Governance/Infra/SSG/MCP/Research hierarchy")))
+  (critical-next-actions
+    (action "Refine Nickel integration for type-safe filing")
+    (action "Expand visibility map to full fleet coverage")))
diff --git a/.well-known/ai.txt b/.well-known/ai.txt
@@ -0,0 +1,20 @@
+# SPDX-License-Identifier: PMPL-1.0-or-later
+# ai.txt — AI agent interaction policy for this repository
+#
+# This file declares how AI systems should interact with this project.
+# See also: 0-AI-MANIFEST.a2ml (detailed AI entry point)
+
+# Policy
+User-agent: *
+Allow: /
+
+# Metadata
+AI-Manifest: /0-AI-MANIFEST.a2ml
+Machine-Readable: /.machine_readable/
+License: PMPL-1.0-or-later
+Author: Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>
+
+# Preferences
+Preferred-Format: structured
+Respect-Emotional-Lineage: yes
+Preserve-Provenance: yes
diff --git a/.well-known/humans.txt b/.well-known/humans.txt
@@ -0,0 +1,15 @@
+# SPDX-License-Identifier: PMPL-1.0-or-later
+# humans.txt — https://humanstxt.org/
+
+/* TEAM */
+Name: Jonathan D.A. Jewell
+Role: Creator and Maintainer
+GitHub: hyperpolymath
+Email: j.d.a.jewell@open.ac.uk
+
+/* SITE */
+Project: live-files
+Description: RSR 2026 Control Plane for the Hyperpolymath Epistemic Fleet
+License: PMPL-1.0-or-later
+Standards: Rhodium Standard Repositories (RSR)
+Language: English (Oxford British)
diff --git a/.well-known/security.txt b/.well-known/security.txt
@@ -0,0 +1,10 @@
+# SPDX-License-Identifier: PMPL-1.0-or-later
+# security.txt — https://securitytxt.org/
+# Canonical location: .well-known/security.txt
+
+Contact: mailto:j.d.a.jewell@open.ac.uk
+Contact: https://github.com/hyperpolymath/live-files/security/advisories/new
+Expires: 2027-03-02T00:00:00.000Z
+Preferred-Languages: en
+Canonical: https://github.com/hyperpolymath/live-files/.well-known/security.txt
+Policy: https://github.com/hyperpolymath/live-files/blob/main/SECURITY.md
diff --git a/0-AI-MANIFEST.a2ml b/0-AI-MANIFEST.a2ml
@@ -1,3 +1,4 @@
+<!-- SPDX-License-Identifier: PMPL-1.0-or-later -->
 # ⚠️ STOP - CRITICAL READING REQUIRED
 
 **THIS FILE MUST BE READ FIRST BY ALL AI AGENTS**
@@ -44,7 +45,7 @@ Bot-specific instructions for:
 2. **Single source of truth** - `.machine_readable/` is authoritative
 3. **No stale metadata** - If root SCMs exist, they are OUT OF DATE
 4. **License consistency** - All code PMPL-1.0-or-later unless platform requires MPL-2.0
-5. **Author attribution** - Always "Jonathan D.A. Jewell <jonathan.jewell@open.ac.uk>"
+5. **Author attribution** - Always "Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>"
 
 ## REPOSITORY STRUCTURE
 
@@ -110,7 +111,7 @@ After reading this file, demonstrate understanding by stating:
 ## META
 
 - **Format Version:** 1.0.0
-- **Created:** [DATE]
-- **Maintained By:** [YOUR-NAME/ORG]
+- **Created:** 2025-01-11
+- **Maintained By:** Jonathan D.A. Jewell (hyperpolymath)
 - **License:** PMPL-1.0-or-later
 - **Protocol:** https://github.com/hyperpolymath/0-ai-gatekeeper-protocol
diff --git a/CODE_OF_CONDUCT.md b/CODE_OF_CONDUCT.md
@@ -1,28 +1,9 @@
+<!-- SPDX-License-Identifier: PMPL-1.0-or-later -->
 # Code of Conduct
 
-<!-- 
-============================================================================
-TEMPLATE INSTRUCTIONS (delete this block before publishing)
-============================================================================
-Replace all {{PLACEHOLDER}} values:
-  {{PROJECT_NAME}}     - Your project name
-  hyperpolymath            - GitHub/GitLab username or org
-  live-files             - Repository name
-  {{CONDUCT_EMAIL}}    - Email for conduct reports
-  {{CONDUCT_TEAM}}     - Name of conduct team/committee
-  {{RESPONSE_TIME}}    - Initial response SLA (e.g., 48 hours)
-  {{CURRENT_YEAR}}     - Current year
-
-Review and customise:
-- Adjust enforcement ladder for your community size
-- Add/remove examples based on your context
-- Ensure contact methods work for your team
-============================================================================
--->
-
 ## Our Pledge
 
-We as members, contributors, and leaders pledge to make participation in {{PROJECT_NAME}} a harassment-free experience for everyone, regardless of age, body size, visible or invisible disability, ethnicity, sex characteristics, gender identity and expression, level of experience, education, socio-economic status, nationality, personal appearance, race, caste, colour, religion, or sexual identity and orientation.
+We as members, contributors, and leaders pledge to make participation in live-files a harassment-free experience for everyone, regardless of age, body size, visible or invisible disability, ethnicity, sex characteristics, gender identity and expression, level of experience, education, socio-economic status, nationality, personal appearance, race, caste, colour, religion, or sexual identity and orientation.
 
 We pledge to act and interact in ways that contribute to an open, welcoming, diverse, inclusive, and healthy community.
 
@@ -136,7 +117,7 @@ If you experience or witness unacceptable behaviour, or have any other concerns,
 
 | Method | Details | Best For |
 |--------|---------|----------|
-| **Email** | {{CONDUCT_EMAIL}} | Detailed reports, sensitive matters |
+| **Email** | j.d.a.jewell@open.ac.uk | Detailed reports, sensitive matters |
 | **Private Message** | Contact any maintainer directly | Quick questions, minor issues |
 | **Anonymous Form** | [Link to form if available] | When you need anonymity |
 
@@ -152,8 +133,8 @@ If you experience or witness unacceptable behaviour, or have any other concerns,
 
 **What Happens Next**
 
-1. You will receive acknowledgment within **{{RESPONSE_TIME}}**
-2. The {{CONDUCT_TEAM}} will review the report
+1. You will receive acknowledgment within **48 hours**
+2. The Conduct Committee will review the report
 3. We may ask for additional information
 4. We will determine appropriate action
 5. We will inform you of the outcome (respecting others' privacy)
@@ -169,7 +150,7 @@ All reports will be handled with discretion:
 
 ### Conflicts of Interest
 
-If a {{CONDUCT_TEAM}} member is involved in an incident:
+If a Conduct Committee member is involved in an incident:
 
 - They will recuse themselves from the process
 - Another maintainer or external party will handle the report
@@ -179,7 +160,7 @@ If a {{CONDUCT_TEAM}} member is involved in an incident:
 
 ## Enforcement Guidelines
 
-The {{CONDUCT_TEAM}} will follow these guidelines in determining consequences:
+The Conduct Committee will follow these guidelines in determining consequences:
 
 ### 1. Correction
 
@@ -231,13 +212,13 @@ For contributors with elevated access (Perimeter 2 or 1):
 If you believe an enforcement decision was made in error:
 
 1. **Wait 7 days** after the decision (cooling-off period)
-2. **Email** {{CONDUCT_EMAIL}} with subject line "Appeal: [Original Report ID]"
+2. **Email** j.d.a.jewell@open.ac.uk with subject line "Appeal: [Original Report ID]"
 3. **Explain** why you believe the decision should be reconsidered
 4. **Provide** any new information not previously available
 
 **Appeals Process**
 
-- Appeals are reviewed by a different {{CONDUCT_TEAM}} member than the original
+- Appeals are reviewed by a different Conduct Committee member than the original
 - You will receive a response within 14 days
 - The appeals decision is final
 - You may only appeal once per incident
@@ -311,7 +292,7 @@ We thank these communities for their leadership in creating welcoming spaces.
 If you have questions about this Code of Conduct:
 
 - Open a [Discussion](https://github.com/hyperpolymath/live-files/discussions) (for general questions)
-- Email {{CONDUCT_EMAIL}} (for private questions)
+- Email j.d.a.jewell@open.ac.uk (for private questions)
 - Contact any maintainer directly
 
 ---
@@ -324,4 +305,4 @@ We're all here because we care about this project. Let's make it a place where e
 
 ---
 
-<sub>Last updated: {{CURRENT_YEAR}} · Based on Contributor Covenant 2.1</sub>
+<sub>Last updated: 2026 · Based on Contributor Covenant 2.1</sub>
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
@@ -1,3 +1,4 @@
+<!-- SPDX-License-Identifier: PMPL-1.0-or-later -->
 # Clone the repository
 git clone https://github.com/hyperpolymath/live-files.git
 cd live-files
@@ -53,7 +54,7 @@ live-files/
 
 **Before reporting**:
 1. Search existing issues
-2. Check if it's already fixed in `{{MAIN_BRANCH}}`
+2. Check if it's already fixed in `main`
 3. Determine which perimeter the bug affects
 
 **When reporting**:
diff --git a/LICENSE b/LICENSE
@@ -1,4 +1,5 @@
 SPDX-License-Identifier: PMPL-1.0-or-later
+SPDX-FileCopyrightText: Copyright (c) 2025-2026 Jonathan D.A. Jewell (hyperpolymath) <j.d.a.jewell@open.ac.uk>
 SPDX-FileCopyrightText: 2024-2025 Palimpsest Stewardship Council
 
 ================================================================================
diff --git a/README.adoc b/README.adoc
@@ -0,0 +1,81 @@
+// SPDX-License-Identifier: PMPL-1.0-or-later
+// README.adoc -- live-files: RSR 2026 Control Plane
+= live-files
+Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>
+:toc: macro
+:toclevels: 2
+:license: PMPL-1.0-or-later
+:url-repo: https://github.com/hyperpolymath/live-files
+
+image:https://img.shields.io/badge/license-PMPL--1.0--or--later-blue[License,link=LICENSE]
+image:https://img.shields.io/badge/RSR-compliant-brightgreen[RSR Compliant]
+image:https://github.com/hyperpolymath/live-files/actions/workflows/hypatia-scan.yml/badge.svg[Hypatia Scan,link=https://github.com/hyperpolymath/live-files/actions/workflows/hypatia-scan.yml]
+
+toc::[]
+
+== 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
+
+[source,bash]
+----
+# View the Epistemic Fleet map
+just v
+
+# File repos into their correct tiers
+just file
+
+# Restore broken symlinks
+./must restore
+----
+
+== Project Structure
+
+[source]
+----
+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
+|   +-- STATE.scm
+|   +-- META.scm
+|   +-- ECOSYSTEM.scm
+|   +-- AGENTIC.scm
+|   +-- NEUROSYM.scm
+|   +-- PLAYBOOK.scm
++-- .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 link:LICENSE[Palimpsest Licence (PMPL-1.0-or-later)].
+
+Copyright (c) 2025-2026 Jonathan D.A. Jewell (hyperpolymath) <j.d.a.jewell@open.ac.uk>
diff --git a/SECURITY.md b/SECURITY.md
diff --git a/TOPOLOGY.md b/TOPOLOGY.md
diff --git a/justfile b/justfile
diff --git a/must b/must
diff --git a/scripts/map_ecosystem.sh b/scripts/map_ecosystem.sh

Original file line number	Diff line number	Diff line change
`@@ -1,3 +1,4 @@`
	`1`	`+<!-- SPDX-License-Identifier: PMPL-1.0-or-later -->`
`1`	`2`	`# Live-Files: RSR 2026 Control Plane`
`2`	`3`
`3`	`4`	`You are an agent operating on the Hyperpolymath Epistemic Fleet.`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-# SPDX-License-Identifier: AGPL-3.0-or-later`
	`1`	`+# SPDX-License-Identifier: PMPL-1.0-or-later`
`2`	`2`	`# RSR-compliant .gitattributes`
`3`	`3`
`4`	`4`	`* text=auto eol=lf`