Skip to content
Open
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
11 changes: 4 additions & 7 deletions .claude/CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,12 +18,9 @@ The same discipline applies to `hyperpolymath/januskey` and its `reversible-core
The following files in `.machine_readable/` contain structured project metadata:

- `.machine_readable/ECHO_TYPES_OCHRANCE_BRIDGE.a2ml` - Bridge to echo-types + ochrance (READ FIRST)
- `.machine_readable/6a2/STATE.a2ml` - Current project state and progress
- `.machine_readable/6a2/META.a2ml` - Architecture decisions and development practices
- `.machine_readable/6a2/ECOSYSTEM.a2ml` - Position in the ecosystem and related projects
- `.machine_readable/6a2/AGENTIC.a2ml` - AI agent interaction patterns
- `.machine_readable/6a2/NEUROSYM.a2ml` - Neurosymbolic integration config
- `.machine_readable/6a2/PLAYBOOK.a2ml` - Operational runbook
- `valence-shell_chora.deed` (repo root) - The repo deed: identity, canon pin, and the descriptile clauses `(ecosystem …)`, `(agentic …)`, `(neurosym …)` and `(playbook …)`. A2ML is retired (D99, D269c, D312, D313)
- `archive/a2ml-v1/MIGRATION-LEDGER.adoc` - Where each field of the retired descriptiles went, and the items awaiting owner input
- `archive/a2ml-v1/6a2-*.txt` - The retired STATE, META, ECOSYSTEM, AGENTIC, NEUROSYM, PLAYBOOK and ANCHOR files, archived verbatim

---

Expand All @@ -45,7 +42,7 @@ The following files in `.machine_readable/` contain structured project metadata:
| **JavaScript** | Only where AffineScript cannot | MCP protocol glue, Bun APIs |
| **Python** | SaltStack only | No other Python permitted |
| **Nickel** | Configuration language | For complex configs |
| **Guile Scheme** | State/meta files | .machine_readable/6a2/STATE.a2ml, .machine_readable/6a2/META.a2ml, .machine_readable/6a2/ECOSYSTEM.a2ml |
| **Guile Scheme** | Scripting where needed | (metadata is `valence-shell_chora.deed`; see Machine-Readable Artefacts) |
| **Julia** | Batch scripts, data processing | Per RSR |
| **OCaml** | AffineScript compiler | Language-specific |
| **Ada** | Safety-critical systems | Where required |
Expand Down
30 changes: 23 additions & 7 deletions .github/workflows/hypatia-scan.yml
Original file line number Diff line number Diff line change
Expand Up @@ -47,15 +47,31 @@ jobs:
timeout-minutes: 30

steps:
# Hypatia RE001: the scan job holds GITHUB_TOKEN and the fleet PAT next
# to fetched code (the Hypatia and gitbot-fleet clones, the mix build).
# Audit mode records every outbound connection without blocking; the
# job's endpoints (hex.pm, GitHub, the Elixir builds) are too many to
# enumerate safely as a block list here.
- name: Monitor outbound requests (audit)
# Hypatia RE001/RE002: the scan job holds GITHUB_TOKEN and the fleet PAT
# next to fetched code (the Hypatia and gitbot-fleet clones, the mix
# build), so outbound traffic is blocked except for the hosts it needs:
# GitHub (checkout, clones, API, SARIF upload, PR comment), the BEAM and
# Hex builds setup-beam and mix fetch, Actions artifact storage, and the
# Green Web Foundation API one Hypatia rule queries. If a run reports a
# blocked endpoint, add it here deliberately.
- name: Restrict outbound requests to the scan's known hosts
uses: step-security/harden-runner@1d88384fd173af6ecb012dfd0264a306b711241a # v2.22.4
with:
egress-policy: audit
egress-policy: block
allowed-endpoints: >-
github.com:443
api.github.com:443
codeload.github.com:443
objects.githubusercontent.com:443
release-assets.githubusercontent.com:443
raw.githubusercontent.com:443
uploads.github.com:443
builds.hex.pm:443
repo.hex.pm:443
hex.pm:443
results-receiver.actions.githubusercontent.com:443
*.blob.core.windows.net:443
api.thegreenwebfoundation.org:443

- name: Checkout repository
uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v6.0.2
Expand Down
11 changes: 9 additions & 2 deletions .github/workflows/workflow-linter.yml
Original file line number Diff line number Diff line change
Expand Up @@ -20,12 +20,19 @@ jobs:
- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v4

- name: Check SPDX headers
# The identifier must be in the file's LEADING comment block, not on
# line 1 exactly: this is the predicate of the estate governance check
# (metadatastician/standards governance-reusable.yml, tested by
# scripts/tests/spdx-header-block-test.sh). `gh actions-lock` inserts
# a "managed by" comment at line 1, so a line-1 test fails headers
# that are present.
run: |
errors=0
for f in .github/workflows/*.yml .github/workflows/*.yaml; do
[ -f "$f" ] || continue
if ! head -1 "$f" | grep -q "SPDX-License-Identifier"; then
echo "ERROR: $f missing SPDX header"
if ! awk '/^---[[:space:]]*$/ { next } /^#/ { print; next } { exit }' "$f" \
| grep -q "^# SPDX-License-Identifier:"; then
echo "ERROR: $f has no SPDX-License-Identifier in its leading comment block" >&2
errors=$((errors + 1))
fi
done
Expand Down
3 changes: 2 additions & 1 deletion .machine_readable/bot_directives/README.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -32,7 +32,8 @@ Methodology-aware configuration for AI agents. Read by any AI agent

== Relationship to Other Files

* `AGENTIC.a2ml` says WHAT agents can do (permissions, gating)
* The `(agentic …)` clause of `valence-shell_chora.deed` (formerly
`AGENTIC.a2ml`) says WHAT agents can do (permissions, gating)
* `bot_directives/` says HOW agents should work (methodology)
* `bot_directives/` says what the gitbot-fleet does (fleet-specific)
* `CLAUDE.md` says how Claude specifically should work (Claude-specific)
Expand Down
11 changes: 3 additions & 8 deletions .machine_readable/contractiles/Mustfile.a2ml
Original file line number Diff line number Diff line change
Expand Up @@ -61,16 +61,11 @@ hooks fail if any check fails.
- run: test -f .machine_readable/contractiles/bust/Bustfile.a2ml && test -f .machine_readable/contractiles/dust/Dustfile.a2ml
- severity: critical

### six-directory-present
- description: 6a2 directory exists with required files
- run: test -d .machine_readable/6a2 && test -f .machine_readable/6a2/META.a2ml && test -f .machine_readable/6a2/ECOSYSTEM.a2ml && test -f .machine_readable/6a2/STATE.a2ml && test -f .machine_readable/6a2/PLAYBOOK.a2ml && test -f .machine_readable/6a2/AGENTIC.a2ml && test -f .machine_readable/6a2/NEUROSYM.a2ml
### repo-deed-present
- description: The repo deed holds the descriptiles; the retired 6a2 A2ML files are archived (D312, D313)
- run: test -f valence-shell_chora.deed && test -f archive/a2ml-v1/MIGRATION-LEDGER.adoc && test ! -e .machine_readable/6a2 && for f in STATE.a2ml META.a2ml ECOSYSTEM.a2ml AGENTIC.a2ml NEUROSYM.a2ml PLAYBOOK.a2ml 0-AI-MANIFEST.a2ml anchor-ANCHOR.a2ml README.adoc; do test -f "archive/a2ml-v1/6a2-$f.txt" || exit 1; done
- severity: critical

### anchors-directory
- description: anchors directory exists in 6a2
- run: test -d .machine_readable/6a2/anchors
- severity: warning

### self-validating-structure
- description: self-validating directory has k9-svc and examples
- run: test -d .machine_readable/self-validating && test -d .machine_readable/self-validating/k9-svc && test -d .machine_readable/self-validating/examples
Expand Down
12 changes: 12 additions & 0 deletions CHANGELOG.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0

== [Unreleased]

=== Changed — 2026-11-17 (A2ML descriptiles moved into the repo deed)

- The retired `.machine_readable/6a2/` A2ML files (STATE, META, ECOSYSTEM,
AGENTIC, NEUROSYM, PLAYBOOK, the directory manifest, the anchor and the
directory README) are archived verbatim under `archive/a2ml-v1/` with their
history. Their content now lives in `valence-shell_chora.deed`, a
`repo-deed` that passes the standards `deed_lint`. Fields with no mapping row
are kept as comments, and every field's disposition, including the items
that need owner input, is in `archive/a2ml-v1/MIGRATION-LEDGER.adoc`.
Addresses Hypatia SD004; SD007 stays open on one owner-policy line of
`.claude/CLAUDE.md` (ledger row U-2).

=== Changed — 2026-11-01 (assurance-boundary re-audit)

- Corrected prose that had drifted across the assurance boundary. The audit
Expand Down
17 changes: 11 additions & 6 deletions ROADMAP.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -5,8 +5,8 @@

== Current Status

v0.9.0 (advanced research prototype, ~74% complete per
`.machine_readable/6a2/STATE.a2ml`).
v0.9.0 (advanced research prototype, ~74% complete per the retired
`STATE.a2ml`, archived at `archive/a2ml-v1/6a2-STATE.a2ml.txt`).
Comment thread
hyperpolymath marked this conversation as resolved.
Resolved

The Rust CLI in `impl/rust-cli/` is a functional interactive shell with
reversible filesystem operations, transaction grouping, and
Expand Down Expand Up @@ -39,11 +39,16 @@ CI on `rust-cli.yml`, dogfood evidence, structural compliance.
in the same PR.
* [ ] Per-directory README coverage 23% → ~90% (17 subtrees missing,
enumerated in the audit).
* [ ] Add `[dogfooding-status]` to STATE.a2ml with concrete daily-use
entries.
* [ ] Add 3+ ADRs to META.a2ml (proof stack: Agda source, Lean/Rocq rechecks, Rust as primary
* [ ] Record dogfooding status with concrete daily-use entries.
_Target pending:_ this item named `STATE.a2ml`, which is retired and
archived (2026-11-17). Do not edit the archive; the new home is an
owner decision (`archive/a2ml-v1/MIGRATION-LEDGER.adoc`, row U-6).
* [ ] Write 3+ ADRs (proof stack: Agda source, Lean/Rocq rechecks, Rust as primary
implementation, property-testing as correspondence-gap mitigation) and
populate `[development-practices]`.
record the development practices.
_Target pending:_ this item named `META.a2ml`, which is retired and
archived. The canon's successor is `(adr …)` entries in the deed
(ledger rows U-6 and T-1); do not edit the archive.
* [x] Resolved 2026-04-19: `impl/rust-ffi/` deleted; `ffi/rust/` is
canonical (superset, includes `verification.rs`, matches CLAUDE.md
ABI/FFI standard `ffi/<lang>/`). 7 sibling files were byte-identical;
Expand Down
4 changes: 2 additions & 2 deletions alkahest-shell-transmuter/.github/workflows/codeql.yml
Original file line number Diff line number Diff line change
Expand Up @@ -38,7 +38,7 @@ jobs:
- name: Checkout repository
uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
- name: Initialize CodeQL
uses: github/codeql-action/init@ea9e4e37992a54ee68a9571571f9a567d8f90f78 # v3.28.0
uses: github/codeql-action/init@48ab28a6f5dbc2a99bf1e0131198dd8f1df78169 # v3.28.0
with:
languages: ${{ matrix.language }}
build-mode: ${{ matrix.build-mode }}
Expand All @@ -53,6 +53,6 @@ jobs:
# Java: ./gradlew build || mvn compile
echo "Configure your build command above for manual build mode languages"
- name: Perform CodeQL Analysis
uses: github/codeql-action/analyze@ea9e4e37992a54ee68a9571571f9a567d8f90f78 # v3.28.0
uses: github/codeql-action/analyze@48ab28a6f5dbc2a99bf1e0131198dd8f1df78169 # v3.28.0
with:
category: "/language:${{ matrix.language }}"
126 changes: 18 additions & 108 deletions alkahest-shell-transmuter/.github/workflows/mirror.yml
Original file line number Diff line number Diff line change
@@ -1,115 +1,25 @@
# SPDX-License-Identifier: MPL-2.0
# SPDX-FileCopyrightText: 2025 Jonathan D.A. Jewell
name: Mirror to Git Forges

on:
push:
branches: [main]
workflow_dispatch:
permissions: read-all

permissions:
actions: read
contents: read

jobs:
mirror-gitlab:
runs-on: ubuntu-latest
if: vars.GITLAB_MIRROR_ENABLED == 'true'
steps:
- uses: actions/checkout@b4ffde65f46336ab88eb53be808477a3936bae11 # v4
with:
fetch-depth: 0
- uses: webfactory/ssh-agent@dc588b651fe13675774614f8e6a936a468676387 # v0.9.0
with:
ssh-private-key: ${{ secrets.GITLAB_SSH_KEY }}
- name: Mirror to GitLab
run: |
ssh-keyscan -t ed25519 gitlab.com >> ~/.ssh/known_hosts
git remote add gitlab git@gitlab.com:hyperpolymath/${{ github.event.repository.name }}.git || true
git push --force gitlab main
mirror-bitbucket:
runs-on: ubuntu-latest
if: vars.BITBUCKET_MIRROR_ENABLED == 'true'
steps:
- uses: actions/checkout@b4ffde65f46336ab88eb53be808477a3936bae11 # v4
with:
fetch-depth: 0
- uses: webfactory/ssh-agent@dc588b651fe13675774614f8e6a936a468676387 # v0.9.0
with:
ssh-private-key: ${{ secrets.BITBUCKET_SSH_KEY }}
- name: Mirror to Bitbucket
run: |
ssh-keyscan -t ed25519 bitbucket.org >> ~/.ssh/known_hosts
git remote add bitbucket git@bitbucket.org:hyperpolymath/${{ github.event.repository.name }}.git || true
git push --force bitbucket main
mirror-codeberg:
runs-on: ubuntu-latest
if: vars.CODEBERG_MIRROR_ENABLED == 'true'
steps:
- uses: actions/checkout@b4ffde65f46336ab88eb53be808477a3936bae11 # v4
with:
fetch-depth: 0
- uses: webfactory/ssh-agent@dc588b651fe13675774614f8e6a936a468676387 # v0.9.0
with:
ssh-private-key: ${{ secrets.CODEBERG_SSH_KEY }}
- name: Mirror to Codeberg
run: |
ssh-keyscan -t ed25519 codeberg.org >> ~/.ssh/known_hosts
git remote add codeberg git@codeberg.org:hyperpolymath/${{ github.event.repository.name }}.git || true
git push --force codeberg main
mirror-sourcehut:
runs-on: ubuntu-latest
if: vars.SOURCEHUT_MIRROR_ENABLED == 'true'
steps:
- uses: actions/checkout@b4ffde65f46336ab88eb53be808477a3936bae11 # v4
with:
fetch-depth: 0
- uses: webfactory/ssh-agent@dc588b651fe13675774614f8e6a936a468676387 # v0.9.0
with:
ssh-private-key: ${{ secrets.SOURCEHUT_SSH_KEY }}
- name: Mirror to SourceHut
run: |
ssh-keyscan -t ed25519 git.sr.ht >> ~/.ssh/known_hosts
git remote add sourcehut git@git.sr.ht:~hyperpolymath/${{ github.event.repository.name }} || true
git push --force sourcehut main
mirror-disroot:
runs-on: ubuntu-latest
if: vars.DISROOT_MIRROR_ENABLED == 'true'
steps:
- uses: actions/checkout@b4ffde65f46336ab88eb53be808477a3936bae11 # v4
with:
fetch-depth: 0
- uses: webfactory/ssh-agent@dc588b651fe13675774614f8e6a936a468676387 # v0.9.0
with:
ssh-private-key: ${{ secrets.DISROOT_SSH_KEY }}
- name: Mirror to Disroot
run: |
ssh-keyscan -t ed25519 git.disroot.org >> ~/.ssh/known_hosts
git remote add disroot git@git.disroot.org:hyperpolymath/${{ github.event.repository.name }}.git || true
git push --force disroot main
mirror-gitea:
runs-on: ubuntu-latest
if: vars.GITEA_MIRROR_ENABLED == 'true'
steps:
- uses: actions/checkout@b4ffde65f46336ab88eb53be808477a3936bae11 # v4
with:
fetch-depth: 0
- uses: webfactory/ssh-agent@dc588b651fe13675774614f8e6a936a468676387 # v0.9.0
with:
ssh-private-key: ${{ secrets.GITEA_SSH_KEY }}
- name: Mirror to Gitea
run: |
ssh-keyscan -t ed25519 ${{ vars.GITEA_HOST }} >> ~/.ssh/known_hosts
git remote add gitea git@${{ vars.GITEA_HOST }}:hyperpolymath/${{ github.event.repository.name }}.git || true
git push --force gitea main
mirror-radicle:
runs-on: ubuntu-latest
if: vars.RADICLE_MIRROR_ENABLED == 'true'
steps:
- uses: actions/checkout@b4ffde65f46336ab88eb53be808477a3936bae11 # v4
with:
fetch-depth: 0
- name: Install Radicle
run: |
curl -sSf https://radicle.xyz/install | sh
echo "$HOME/.radicle/bin" >> $GITHUB_PATH
- name: Mirror to Radicle
run: |
echo "${{ secrets.RADICLE_KEY }}" > ~/.radicle/keys/radicle
chmod 600 ~/.radicle/keys/radicle
rad sync --announce || echo "Radicle sync attempted"
mirror:
uses: metadatastician/standards/.github/workflows/mirror-reusable.yml@75bd5994470661a099df562d6d5ad2fe744dbd66
# Explicit secrets map, not `secrets: inherit` (Hypatia WH008): the callee
# (standards@75bd5994) declares exactly these seven, all optional.
secrets:
GITLAB_SSH_KEY: ${{ secrets.GITLAB_SSH_KEY }}
BITBUCKET_SSH_KEY: ${{ secrets.BITBUCKET_SSH_KEY }}
CODEBERG_SSH_KEY: ${{ secrets.CODEBERG_SSH_KEY }}
SOURCEHUT_SSH_KEY: ${{ secrets.SOURCEHUT_SSH_KEY }}
DISROOT_SSH_KEY: ${{ secrets.DISROOT_SSH_KEY }}
GITEA_SSH_KEY: ${{ secrets.GITEA_SSH_KEY }}
RADICLE_KEY: ${{ secrets.RADICLE_KEY }}
53 changes: 12 additions & 41 deletions alkahest-shell-transmuter/.github/workflows/secret-scanner.yml
Original file line number Diff line number Diff line change
@@ -1,49 +1,20 @@
# SPDX-License-Identifier: MPL-2.0
# Prevention workflow - scans for hardcoded secrets before they reach main
name: Secret Scanner

on:
pull_request:
push:
branches: [main]
permissions: read-all
jobs:
trufflehog:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@b4ffde65f46336ab88eb53be808477a3936bae11 # v4
with:
fetch-depth: 0 # Full history for scanning
- name: TruffleHog Secret Scan
uses: trufflesecurity/trufflehog@8a8ef8526528d8a4ff3e2c90be08e25ef8efbd9b # v3
with:
extra_args: --only-verified --fail
# Rust-specific: Check for hardcoded crypto values
rust-secrets:
runs-on: ubuntu-latest
if: hashFiles('**/Cargo.toml') != ''
steps:
- uses: actions/checkout@b4ffde65f46336ab88eb53be808477a3936bae11 # v4
- name: Check for hardcoded secrets in Rust
run: |
# Patterns that suggest hardcoded secrets
PATTERNS=(
'const.*SECRET.*=.*"'
'const.*KEY.*=.*"[a-zA-Z0-9]{16,}"'
'const.*TOKEN.*=.*"'
'let.*api_key.*=.*"'
'HMAC.*"[a-fA-F0-9]{32,}"'
'password.*=.*"[^"]+"'
)

found=0
for pattern in "${PATTERNS[@]}"; do
if grep -rn --include="*.rs" -E "$pattern" src/; then
echo "WARNING: Potential hardcoded secret found matching: $pattern"
found=1
fi
done
concurrency:
group: ${{ github.workflow }}-${{ github.ref }}
cancel-in-progress: true
Comment thread
hyperpolymath marked this conversation as resolved.
Resolved
Comment thread
hyperpolymath marked this conversation as resolved.
Resolved

if [ $found -eq 1 ]; then
echo "::error::Potential hardcoded secrets detected. Use environment variables instead."
exit 1
fi
permissions:
contents: read

jobs:
scan:
permissions:
contents: read
uses: metadatastician/standards/.github/workflows/secret-scanner-reusable.yml@75bd5994470661a099df562d6d5ad2fe744dbd66
File renamed without changes.
File renamed without changes.
File renamed without changes.
Loading
Loading