Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions .machine_readable/agent_instructions/README.adoc
Original file line number Diff line number Diff line change
@@ -1,4 +1,5 @@
// SPDX-License-Identifier: MPL-2.0
// Copyright (c) Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>
// Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) <j.d.a.jewell@open.ac.uk>
= Agent Instructions
:toc: preamble
Expand Down
2 changes: 2 additions & 0 deletions .machine_readable/svc/README.adoc
Original file line number Diff line number Diff line change
@@ -1,3 +1,5 @@
// SPDX-License-Identifier: MPL-2.0
// Copyright (c) Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>
= `.machine_readable/svc/` — Service components for valence-shell
:toc:

Expand Down
1 change: 1 addition & 0 deletions .machine_readable/svc/k9/README.adoc
Original file line number Diff line number Diff line change
@@ -1,4 +1,5 @@
// SPDX-License-Identifier: MPL-2.0
// Copyright (c) Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>
= K9 Contractiles
:toc: left
:icons: font
Expand Down
1 change: 1 addition & 0 deletions CHANGELOG.adoc
Original file line number Diff line number Diff line change
@@ -1,4 +1,5 @@
// SPDX-License-Identifier: MPL-2.0
// Copyright (c) Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>
= Changelog

All notable changes to Valence Shell will be documented in this file.
Expand Down
1 change: 1 addition & 0 deletions EXPLAINME.adoc
Original file line number Diff line number Diff line change
@@ -1,4 +1,5 @@
// SPDX-License-Identifier: MPL-2.0
// Copyright (c) Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>
= Valence Shell (vsh) — Show Me The Receipts
:toc:
:icons: font
Expand Down
2 changes: 2 additions & 0 deletions GOVERNANCE.adoc
Original file line number Diff line number Diff line change
@@ -1,3 +1,5 @@
// SPDX-License-Identifier: MPL-2.0
// Copyright (c) Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>
= Governance Model
:toc:
:toclevels: 2
Expand Down
1 change: 1 addition & 0 deletions MAINTAINERS.adoc
Original file line number Diff line number Diff line change
@@ -1,4 +1,5 @@
// SPDX-License-Identifier: MPL-2.0
// Copyright (c) Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>
= Maintainers
:toc: preamble

Expand Down
1 change: 1 addition & 0 deletions PALIMPSEST.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -27,6 +27,7 @@ ethical-use, provenance, and lineage requirements.
1. Include the PMPL-1.0 license text in `LICENSE`.
2. Add SPDX headers to source files:
`SPDX-License-Identifier: MPL-2.0`
// Copyright (c) Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>
3. Add a Palimpsest badge to your README (see `assets/badges/` and `embed/license-blocks/`).

== Versioning
Expand Down
1 change: 1 addition & 0 deletions QUICKSTART-DEV.adoc
Original file line number Diff line number Diff line change
@@ -1,4 +1,5 @@
// SPDX-License-Identifier: MPL-2.0
// Copyright (c) Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>
= valence-shell — Quick Start for Developers
:toc:
:toclevels: 2
Expand Down
1 change: 1 addition & 0 deletions QUICKSTART-MAINTAINER.adoc
Original file line number Diff line number Diff line change
@@ -1,4 +1,5 @@
// SPDX-License-Identifier: MPL-2.0
// Copyright (c) Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>
= valence-shell — Quick Start for Platform Maintainers
:toc:
:toclevels: 2
Expand Down
1 change: 1 addition & 0 deletions QUICKSTART-USER.adoc
Original file line number Diff line number Diff line change
@@ -1,4 +1,5 @@
// SPDX-License-Identifier: MPL-2.0
// Copyright (c) Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>
// Template: QUICKSTART-USER.adoc — 5-minute path to working software
// Replace valence-shell, Valence Shell — See README.adoc for details., just run, Valence Shell started successfully. with actuals
= valence-shell — Quick Start for Users
Expand Down
1 change: 1 addition & 0 deletions README.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,7 @@

image:https://img.shields.io/badge/License-MPL--2.0-blue[License: MPL-2.0,link="https://www.mozilla.org/MPL/2.0/"]
// SPDX-License-Identifier: MPL-2.0
// Copyright (c) Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>
// SPDX-FileCopyrightText: 2025 Jonathan D.A. Jewell


Expand Down
1 change: 1 addition & 0 deletions ROADMAP.adoc
Original file line number Diff line number Diff line change
@@ -1,4 +1,5 @@
// SPDX-License-Identifier: MPL-2.0
// Copyright (c) Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>
= Valence Shell Roadmap
:toc:

Expand Down
1 change: 1 addition & 0 deletions RSR_OUTLINE.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -210,6 +210,7 @@ This template is part of:
== License

SPDX-License-Identifier: MPL-2.0-or-later
// Copyright (c) Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>

== Links

Expand Down
1 change: 1 addition & 0 deletions alkahest-shell-transmuter/CONTRIBUTING.adoc
Original file line number Diff line number Diff line change
@@ -1,4 +1,5 @@
// SPDX-License-Identifier: MPL-2.0
// Copyright (c) Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>
= Contributing Guide

== Getting Started
Expand Down
1 change: 1 addition & 0 deletions alkahest-shell-transmuter/MAINTAINERS.adoc
Original file line number Diff line number Diff line change
@@ -1,4 +1,5 @@
// SPDX-License-Identifier: MPL-2.0
// Copyright (c) Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>
= Maintainers
:toc: preamble

Expand Down
2 changes: 2 additions & 0 deletions alkahest-shell-transmuter/README.adoc
Original file line number Diff line number Diff line change
@@ -1,3 +1,5 @@
// SPDX-License-Identifier: MPL-2.0
// Copyright (c) Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>
image:https://img.shields.io/badge/License-PMPL--1.0-blue.svg[License: PMPL-1.0,link="https://github.com/hyperpolymath/palimpsest-license"]

= Alkahest: The Universal Shell Transmuter
Expand Down
1 change: 1 addition & 0 deletions alkahest-shell-transmuter/ROADMAP.adoc
Original file line number Diff line number Diff line change
@@ -1,4 +1,5 @@
// SPDX-License-Identifier: MPL-2.0
// Copyright (c) Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>
= Alkahest Shell Transmuter Roadmap

== Current Status
Expand Down
1 change: 1 addition & 0 deletions alkahest-shell-transmuter/RSR_OUTLINE.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -210,6 +210,7 @@ This template is part of:
== License

SPDX-License-Identifier: MPL-2.0-or-later
// Copyright (c) Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>

== Links

Expand Down
2 changes: 2 additions & 0 deletions alkahest-shell-transmuter/contractiles/README.adoc
Original file line number Diff line number Diff line change
@@ -1,3 +1,5 @@
// SPDX-License-Identifier: MPL-2.0
// Copyright (c) Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>
= Contractiles Template Set
:toc:
:sectnums:
Expand Down
2 changes: 2 additions & 0 deletions alkahest-shell-transmuter/docs/CITATIONS.adoc
Original file line number Diff line number Diff line change
@@ -1,3 +1,5 @@
// SPDX-License-Identifier: MPL-2.0
// Copyright (c) Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>
= RSR-template-repo - Citation Guide
:toc:

Expand Down
2 changes: 2 additions & 0 deletions contractiles/README.adoc
Original file line number Diff line number Diff line change
@@ -1,3 +1,5 @@
// SPDX-License-Identifier: MPL-2.0
// Copyright (c) Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>
= Contractiles Template Set
:toc:
:sectnums:
Expand Down
2 changes: 2 additions & 0 deletions docs/CITATIONS.adoc
Original file line number Diff line number Diff line change
@@ -1,3 +1,5 @@
// SPDX-License-Identifier: MPL-2.0
// Copyright (c) Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>
= valence-shell - Citation Guide
:toc:

Expand Down
1 change: 1 addition & 0 deletions docs/README.adoc
Original file line number Diff line number Diff line change
@@ -1,4 +1,5 @@
// SPDX-License-Identifier: MPL-2.0
// Copyright (c) Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>
= docs/ — Project Documentation

Project-level documentation tree. ~49 entries (subdirs + files);
Expand Down
2 changes: 2 additions & 0 deletions docs/VALENCE_VISION_AND_PROGRESS.adoc
Original file line number Diff line number Diff line change
@@ -1,3 +1,5 @@
// SPDX-License-Identifier: MPL-2.0
// Copyright (c) Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>
= Valence Shell — Vision and Progress
:toc:
:toclevels: 2
Expand Down
1 change: 1 addition & 0 deletions docs/governance/CRG-AUDIT-2026-04-18.adoc
Original file line number Diff line number Diff line change
@@ -1,4 +1,5 @@
// SPDX-License-Identifier: MPL-2.0
// Copyright (c) Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>
// Copyright (c) 2026 Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>

= valence-shell — CRG Audit (2026-04-18)
Expand Down
1 change: 1 addition & 0 deletions examples/README.adoc
Original file line number Diff line number Diff line change
@@ -1,4 +1,5 @@
// SPDX-License-Identifier: MPL-2.0
// Copyright (c) Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>
= examples/ — Example Code (sparse)

Example artefacts. Currently only two files; mainly placeholder for a
Expand Down
1 change: 1 addition & 0 deletions ffi/rust/README.adoc
Original file line number Diff line number Diff line change
@@ -1,4 +1,5 @@
// SPDX-License-Identifier: MPL-2.0
// Copyright (c) Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>
= ffi/rust/ — Rust FFI Library (`vsh-ffi`)

Standalone Rust crate (`vsh-ffi`, library `vsh_ffi`) that exposes
Expand Down
1 change: 1 addition & 0 deletions ffi/zig/README.adoc
Original file line number Diff line number Diff line change
@@ -1,4 +1,5 @@
// SPDX-License-Identifier: MPL-2.0
// Copyright (c) Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>
= ffi/zig/ — Zig FFI (ABI/FFI Universal Standard scaffolding)

Zig FFI implementation matching the **CLAUDE.md ABI/FFI Universal
Expand Down
1 change: 1 addition & 0 deletions hooks/README.adoc
Original file line number Diff line number Diff line change
@@ -1,4 +1,5 @@
// SPDX-License-Identifier: MPL-2.0
// Copyright (c) Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>
= hooks/ — Repository Validation Hooks

POSIX-shell validation hooks invoked by Git pre-commit / pre-push
Expand Down
1 change: 1 addition & 0 deletions impl/README.adoc
Original file line number Diff line number Diff line change
@@ -1,4 +1,5 @@
// SPDX-License-Identifier: MPL-2.0
// Copyright (c) Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>
= impl/ — Implementation Layer

Five concrete implementations of the valence-shell semantics, each
Expand Down
1 change: 1 addition & 0 deletions impl/elixir/README.adoc
Original file line number Diff line number Diff line change
@@ -1,4 +1,5 @@
// SPDX-License-Identifier: MPL-2.0
// Copyright (c) Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>
= impl/elixir/ — Elixir Reference Implementation (NIF build broken)

Elixir reference implementation of the valence-shell semantics, intended
Expand Down
1 change: 1 addition & 0 deletions impl/mcp/README.adoc
Original file line number Diff line number Diff line change
@@ -1,4 +1,5 @@
// SPDX-License-Identifier: MPL-2.0
// Copyright (c) Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>
= impl/mcp/ — MCP Server (Deno + ReScript)

MCP (Model Context Protocol) server exposing valence-shell capabilities
Expand Down
1 change: 1 addition & 0 deletions impl/ocaml/README.adoc
Original file line number Diff line number Diff line change
@@ -1,4 +1,5 @@
// SPDX-License-Identifier: MPL-2.0
// Copyright (c) Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>
= impl/ocaml/ — OCaml Extraction Target (design surface)

OCaml is the extraction target for the Coq proofs in `../../proofs/coq/`
Expand Down
1 change: 1 addition & 0 deletions impl/rust-cli/src/README.adoc
Original file line number Diff line number Diff line change
@@ -1,4 +1,5 @@
// SPDX-License-Identifier: MPL-2.0
// Copyright (c) Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>
= impl/rust-cli/src/ — Primary Rust Shell Source

Source tree for the Rust valence-shell binary `vsh` (v0.9.0). Roughly
Expand Down
1 change: 1 addition & 0 deletions impl/rust-cli/tests/README.adoc
Original file line number Diff line number Diff line change
@@ -1,4 +1,5 @@
// SPDX-License-Identifier: MPL-2.0
// Copyright (c) Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>
= impl/rust-cli/tests/ — Test Suite

Cargo integration-test directory for the `vsh` Rust shell. Counts below
Expand Down
1 change: 1 addition & 0 deletions proofs/agda/README.adoc
Original file line number Diff line number Diff line change
@@ -1,4 +1,5 @@
// SPDX-License-Identifier: MPL-2.0
// Copyright (c) Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>
= proofs/agda/ — Agda Filesystem Proofs (Intensional Type Theory)

Agda (intensional dependent type theory) cross-validates the
Expand Down
1 change: 1 addition & 0 deletions proofs/coq/README.adoc
Original file line number Diff line number Diff line change
@@ -1,4 +1,5 @@
// SPDX-License-Identifier: MPL-2.0
// Copyright (c) Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>
= proofs/coq/ — Coq Filesystem Proofs (CIC Foundation)

Coq (Calculus of Inductive Constructions) provides the CIC foundation
Expand Down
1 change: 1 addition & 0 deletions proofs/isabelle/README.adoc
Original file line number Diff line number Diff line change
@@ -1,4 +1,5 @@
// SPDX-License-Identifier: MPL-2.0
// Copyright (c) Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>
= proofs/isabelle/ — Isabelle/HOL Filesystem Proofs

Isabelle/HOL (higher-order logic) cross-validates the filesystem
Expand Down
1 change: 1 addition & 0 deletions proofs/lean4/README.adoc
Original file line number Diff line number Diff line change
@@ -1,4 +1,5 @@
// SPDX-License-Identifier: MPL-2.0
// Copyright (c) Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>
= proofs/lean4/ — Lean 4 Filesystem Proofs (Primary Source of Truth)

Lean 4 (dependent type theory) is the **primary source of truth** for
Expand Down
1 change: 1 addition & 0 deletions proofs/mizar/README.adoc
Original file line number Diff line number Diff line change
@@ -1,4 +1,5 @@
// SPDX-License-Identifier: MPL-2.0
// Copyright (c) Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>
= proofs/mizar/ — Mizar Filesystem Proofs (Tarski-Grothendieck Set Theory)

Mizar grounds the valence-shell filesystem theorems in
Expand Down
1 change: 1 addition & 0 deletions proofs/z3/README.adoc
Original file line number Diff line number Diff line change
@@ -1,4 +1,5 @@
// SPDX-License-Identifier: MPL-2.0
// Copyright (c) Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>
= proofs/z3/ — Z3 SMT Filesystem Proofs (Automated Verification)

Z3 (SMT-LIB v2 scripts) provides automated verification for the
Expand Down
1 change: 1 addition & 0 deletions scripts/README.adoc
Original file line number Diff line number Diff line change
@@ -1,4 +1,5 @@
// SPDX-License-Identifier: MPL-2.0
// Copyright (c) Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>
= scripts/ — Utility Scripts

POSIX-shell helper scripts driven by the project's CI workflows and
Expand Down
1 change: 1 addition & 0 deletions src/abi/README.adoc
Original file line number Diff line number Diff line change
@@ -1,4 +1,5 @@
// SPDX-License-Identifier: MPL-2.0
// Copyright (c) Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>
= src/abi/ — Idris2 ABI Declarations (formal interface contracts)

Idris2 dependent-type-checked ABI declarations for the valence-shell
Expand Down
Loading