diff --git a/.github/0.1-AI-MANIFEST.a2ml b/.github/0.1-AI-MANIFEST.a2ml deleted file mode 100644 index 85b2f0f..0000000 --- a/.github/0.1-AI-MANIFEST.a2ml +++ /dev/null @@ -1 +0,0 @@ -# AI Manifest - Level 1: .github diff --git a/.github/CODEOWNERS b/.github/CODEOWNERS index 8d339b7..83bd434 100644 --- a/.github/CODEOWNERS +++ b/.github/CODEOWNERS @@ -10,5 +10,5 @@ # Security-sensitive files require explicit review SECURITY.md @hyperpolymath .github/workflows/ @hyperpolymath -Trustfile.a2ml @hyperpolymath +Trustfile.deed @hyperpolymath .machine_readable/ @hyperpolymath diff --git a/.github/CONTRIBUTING.md b/.github/CONTRIBUTING.md index a42d77a..16b185d 100644 --- a/.github/CONTRIBUTING.md +++ b/.github/CONTRIBUTING.md @@ -30,7 +30,7 @@ gv-clade-index/ ├── spec/ # Spec tests (Perimeter 3) ├── tests/ # Test suite (Perimeter 2-3) ├── .machine_readable/ # ALL machine-readable content (Perimeter 1) -│ ├── *.a2ml # State files (STATE, META, ECOSYSTEM, etc.) +│ ├── descriptiles/ # Descriptile deeds (STATE.deed, …) │ ├── bot_directives/ # Bot configs │ └── contractiles/ # Policy contracts (k9, dust, lust, must, trust) ├── .well-known/ # Protocol files (Perimeter 1-3) diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md index 6e2bea9..e4c773b 100644 --- a/.github/copilot-instructions.md +++ b/.github/copilot-instructions.md @@ -6,8 +6,8 @@ ## Before Writing Code -- Read `0-AI-MANIFEST.a2ml` in the repo root for canonical file locations. -- State files (.a2ml) live in `.machine_readable/` ONLY, never the root. +- Read `0-AI-MANIFEST.deed` in the repo root first: it points at the repo deed. +- Repo metadata is deed (`gv-clade-index_chora.deed`, `.machine_readable/descriptiles/STATE.deed`). A2ML is retired: never create a `.a2ml` file. ## License @@ -52,6 +52,6 @@ ## State Files -Never create these in the repo root: -STATE.a2ml, META.a2ml, ECOSYSTEM.a2ml, AGENTIC.a2ml, NEUROSYM.a2ml, PLAYBOOK.a2ml. -They belong in `.machine_readable/` only. +Repo facts live in `gv-clade-index_chora.deed`; descriptiles (`STATE.deed` and +the like) live in `.machine_readable/descriptiles/` only, never the root. Never +create a `.a2ml` file (A2ML is retired; `docs/history/A2ML-REMOVED.adoc`). diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md index 3a8accd..ac1a212 100644 --- a/.github/pull_request_template.md +++ b/.github/pull_request_template.md @@ -26,9 +26,9 @@ ### As Applicable -- [ ] `.machine_readable/STATE.a2ml` updated (if project state changed) -- [ ] `.machine_readable/ECOSYSTEM.a2ml` updated (if integrations changed) -- [ ] `.machine_readable/META.a2ml` updated (if architectural decisions changed) +- [ ] `.machine_readable/descriptiles/STATE.deed` updated (if the lifecycle status or maturity changed) +- [ ] `ROADMAP.adoc` updated (if phase progress changed) +- [ ] An ADR in `docs/decisions/` (if an architectural decision changed) - [ ] Documentation updated for user-facing changes - [ ] `TOPOLOGY.md` updated (if architecture changed) - [ ] `CHANGELOG` or release notes updated diff --git a/.github/workflows/rhodibot.yml b/.github/workflows/rhodibot.yml index 29dc13e..d1067ce 100644 --- a/.github/workflows/rhodibot.yml +++ b/.github/workflows/rhodibot.yml @@ -54,10 +54,11 @@ jobs: for f in *-STATUS-*.md *-COMPLETION-*.md *-COMPLETE.md *-VERIFIED-*.md; do [ -f "$f" ] && warn "stale snapshot present: $f (would be deleted)" done - # would-RENAME: legacy manifest name - if [ -f "AI.a2ml" ] && [ ! -f "0-AI-MANIFEST.a2ml" ]; then - warn "AI.a2ml present without 0-AI-MANIFEST.a2ml (would be renamed)" - fi + # retired: A2ML manifests (the front door is 0-AI-MANIFEST.deed; + # docs/history/A2ML-REMOVED.adoc) + for f in AI.a2ml 0-AI-MANIFEST.a2ml; do + [ -f "$f" ] && warn "retired A2ML manifest present: $f (the front door is 0-AI-MANIFEST.deed)" + done # would-DELETE: duplicate community files [ -f "CONTRIBUTING.md" ] && [ -f "CONTRIBUTING.adoc" ] && warn "duplicate CONTRIBUTING.md + CONTRIBUTING.adoc (one would be removed)" if [ -f "README.md" ] && [ -f "README.adoc" ] && [ "$(wc -l < README.md)" -lt 5 ]; then @@ -74,7 +75,7 @@ jobs: [ -f "CONTRIBUTING.md" ] || [ -f ".github/CONTRIBUTING.md" ] || warn "no CONTRIBUTING.md (would be created)" # --- unfixable compliance gaps (also drift) --- - [ -f "0-AI-MANIFEST.a2ml" ] || [ -f "AI.a2ml" ] || warn "missing AI manifest (0-AI-MANIFEST.a2ml)" + [ -f "0-AI-MANIFEST.deed" ] || warn "missing AI manifest (0-AI-MANIFEST.deed)" [ -f "LICENSE" ] || [ -f "LICENSE.md" ] || [ -f "LICENSE.txt" ] || warn "missing LICENSE file" [ -f "README.adoc" ] || [ -f "README.md" ] || warn "missing README" diff --git a/.machine_readable/0.1-AI-MANIFEST.a2ml b/.machine_readable/0.1-AI-MANIFEST.a2ml deleted file mode 100644 index 9d2bc7a..0000000 --- a/.machine_readable/0.1-AI-MANIFEST.a2ml +++ /dev/null @@ -1,29 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 ---- -### [META] -id: "machine-readable-pillar" -level: 1 -parent: "../0-AI-MANIFEST.a2ml" - ---- -### [AI_MANIFEST] -description: | - Registry for all machine-readable metadata, policies, and internal - automation scripts. - -canonical_locations: - state: "STATE.a2ml" - meta: "META.a2ml" - ecosystem: "ECOSYSTEM.a2ml" - agentic: "AGENTIC.a2ml" - neurosym: "NEUROSYM.a2ml" - playbook: "PLAYBOOK.a2ml" - anchors: "anchors/" - policies: "policies/" - ai_configs: "ai/" - compliance: "compliance/" - scripts: "scripts/" - -invariants: - - "Metadata files MUST follow a2ml format" - - "Internal automation MUST live in scripts/ subfolder" diff --git a/.machine_readable/6a2/AGENTIC.a2ml b/.machine_readable/6a2/AGENTIC.a2ml deleted file mode 100644 index 01f0d2e..0000000 --- a/.machine_readable/6a2/AGENTIC.a2ml +++ /dev/null @@ -1,41 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 -# Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) -# -# AGENTIC.a2ml — AI agent constraints and capabilities -# Defines what AI agents can and cannot do in this repository. - -[metadata] -version = "0.1.0" -last-updated = "2026-04-11" - -[agent-permissions] -can-edit-source = true -can-edit-tests = true -can-edit-docs = true -can-edit-config = true -can-create-files = true - -[agent-constraints] -# What AI agents must NOT do: -# - Never use banned language patterns (believe_me, unsafeCoerce, etc.) -# - Never commit secrets or credentials -# - Never use banned languages (TypeScript, Python, Go, etc.) -# - Never place state files in repository root (must be in .machine_readable/) -# - Never relicense an existing file, and never run an automated licence -# sweep (LICENCE-POLICY.adoc A2). New files get correct SPDX from birth. -# - Never assume a licence. Read standards/LICENCE-POLICY.adoc: Rule 1 -# defaults to MPL-2.0 (code) / CC-BY-SA-4.0 (prose), but Rule 3 -# (co-developed), Rule 4 (network-deployed services) and Rule 5 -# (games) are AGPL-3.0-or-later, and Rule 2 names the PMPL register. - -[maintenance-integrity] -fail-closed = true -require-evidence-per-step = true -allow-silent-skip = false -require-rerun-after-fix = true -release-claim-requires-hard-pass = true - -[automation-hooks] -# on-enter: Read 0-AI-MANIFEST.a2ml, then STATE.a2ml -# on-exit: Update STATE.a2ml with session outcomes -# on-commit: Run just validate-rsr diff --git a/.machine_readable/6a2/ECOSYSTEM.a2ml b/.machine_readable/6a2/ECOSYSTEM.a2ml deleted file mode 100644 index a28802b..0000000 --- a/.machine_readable/6a2/ECOSYSTEM.a2ml +++ /dev/null @@ -1,46 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 -# Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) - -[ecosystem] -version = "1.0.0" -name = "gv-clade-index" -type = "registry" -purpose = "Central taxonomy and registry for 200+ hyperpolymath repositories" -position-in-ecosystem = "Core governance — single source of truth for repo identity, clades, work items, bot findings" - -[related-projects] - -[related-projects.verisimdb] -relationship = "depends-on" -description = "Uses VeriSimDB as the database engine" -repo = "nextgen-databases/verisimdb" - -[related-projects.hyperpolymath-github-io] -relationship = "feeds-into" -description = "Portal frontend queries this registry" -repo = "hyperpolymath.github.io" - -[related-projects.reposystem] -relationship = "sibling" -description = "Reposystem is graph engine; clade-index is identity registry" -repo = "reposystem" - -[related-projects.palimpsest-plasma] -relationship = "sibling" -description = "PMPL governance engine; consumes clade-index for compliance" -repo = "palimpsest-plasma" - -[related-projects.gitbot-fleet] -relationship = "feeds-into" -description = "Bots write observations to VeriSimDB" -repo = "gitbot-fleet" - -[related-projects.hypatia] -relationship = "feeds-into" -description = "Hypatia scan results feed observation octads" -repo = "hypatia" - -[related-projects.seamstress] -relationship = "sibling" -description = "Seam definitions validate cross-clade boundaries" -repo = "seamstress" diff --git a/.machine_readable/6a2/META.a2ml b/.machine_readable/6a2/META.a2ml deleted file mode 100644 index 295c373..0000000 --- a/.machine_readable/6a2/META.a2ml +++ /dev/null @@ -1,55 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 -# Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) - -[project] -name = "gv-clade-index" -description = "VeriSimDB-backed clade taxonomy and central registry for the hyperpolymath ecosystem" -license = "MPL-2.0" -standard = "RSR 2026" - -[author] -name = "Jonathan D.A. Jewell" -email = "j.d.a.jewell@open.ac.uk" -github = "hyperpolymath" - -[architecture-decisions] - -[architecture-decisions.adr-001] -title = "VeriSimDB as central registry" -status = "accepted" -date = "2026-03-16" -context = "200+ repos with scattered state across memory files, STATE.a2ml, bot logs, queue dumps" -decision = "Use VeriSimDB 8-modality octad model as single source of truth for ecosystem metadata" -consequences = "All agents read/write to VeriSimDB instead of scattered files" - -[architecture-decisions.adr-002] -title = "Pointer authority system" -status = "accepted" -date = "2026-03-16" -context = "Need to resolve data ownership between repos and central DB" -decision = "Every datum has an authority pointer (pointer/local/derived) declaring canonical source" -consequences = "Drift detection catches stale caches; no single-winner authority model needed" - -[architecture-decisions.adr-003] -title = "2-character clade prefix for repo names" -status = "accepted" -date = "2026-03-16" -context = "Alphabetical repo listing is unstructured" -decision = "12 two-character codes as name prefix for visual grouping" -consequences = "Repos sort into clades when listed; Julia .jl packages exempt" - -[architecture-decisions.adr-004] -title = "ReScript/WASM public portal" -status = "accepted" -date = "2026-03-16" -context = "Visitors need GitHub literacy to understand ecosystem" -decision = "hyperpolymath.github.io becomes ReScript TEA + WASM app querying VeriSimDB" -consequences = "Public discovery without repo access; LLM API for external agents" - -[architecture-decisions.adr-005] -title = "Map and territory separation" -status = "accepted" -date = "2026-03-16" -context = "Need clean presentation while repos may be messy" -decision = "VeriSimDB is the map (queryable, clean); repos are the territory" -consequences = "Editing the map never damages the territory" diff --git a/.machine_readable/6a2/NEUROSYM.a2ml b/.machine_readable/6a2/NEUROSYM.a2ml deleted file mode 100644 index 1acf7a3..0000000 --- a/.machine_readable/6a2/NEUROSYM.a2ml +++ /dev/null @@ -1,23 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 -# Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) -# -# NEUROSYM.a2ml — Neurosymbolic integration metadata -# Configuration for Hypatia scanning and symbolic reasoning. - -[metadata] -version = "0.1.0" -last-updated = "2026-04-11" - -[hypatia-config] -scan-enabled = true -scan-depth = "standard" # quick | standard | deep -report-format = "logtalk" - -[symbolic-rules] -# Custom symbolic rules for this project -# - { name = "no-unsafe-ffi", pattern = "believe_me|unsafeCoerce", severity = "critical" } - -[neural-config] -# Neural pattern detection settings -# confidence-threshold = 0.85 -# model = "hypatia-v2" diff --git a/.machine_readable/6a2/PLAYBOOK.a2ml b/.machine_readable/6a2/PLAYBOOK.a2ml deleted file mode 100644 index 6408e1c..0000000 --- a/.machine_readable/6a2/PLAYBOOK.a2ml +++ /dev/null @@ -1,35 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 -# Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) -# -# PLAYBOOK.a2ml — Operational playbook -# Runbooks, incident response, deployment procedures. - -[metadata] -version = "0.1.0" -last-updated = "2026-04-11" - -[deployment] -# method = "gitops" # gitops | manual | ci-triggered -# target = "container" # container | binary | library | wasm - -[incident-response] -# 1. Check .machine_readable/STATE.a2ml for current status -# 2. Review recent commits and CI results -# 3. Run `just validate` to check compliance -# 4. Run `just security` to audit for vulnerabilities - -[release-process] -# 1. Update version in STATE.a2ml, META.a2ml, Justfile -# 2. Run `just release-preflight` (validate + quality + security + maint-hard-pass) -# 3. Optional local permission hardening: `just perms-snapshot && just perms-lock` -# 4. Tag and push -# 5. Restore local permissions if needed: `just perms-restore` -# 6. Run `just container-push` if applicable - -[maintenance-operations] -# Baseline audit: -# just maint-audit -# Hard release gate: -# just maint-hard-pass -# Permission audit: -# just perms-audit diff --git a/.machine_readable/6a2/STATE.a2ml b/.machine_readable/6a2/STATE.a2ml deleted file mode 100644 index 79f9225..0000000 --- a/.machine_readable/6a2/STATE.a2ml +++ /dev/null @@ -1,81 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 -# Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) -# -# STATE.a2ml — Project state for gv-clade-index - -[metadata] -project = "gv-clade-index" -version = "0.1.0" -last-updated = "2026-06-21" -status = "active" - -[project-context] -name = "gv-clade-index" -purpose = "VeriSimDB-backed clade taxonomy and central registry for the hyperpolymath ecosystem (200+ repos)" -completion-percentage = 18 - -[position] -phase = "implementation" -maturity = "alpha" - -[route-to-mvp] -milestones = [ - { name = "Phase 0: Clade taxonomy, repo seed, VQL schema, queries", completion = 100 }, - { name = "Phase 2: VeriSimDB instance on VPS, ingest data", completion = 0 }, - { name = "Phase 3: Cloudflare Worker API endpoints", completion = 60 }, - { name = "Phase 4: ReScript/WASM portal on github.io", completion = 0 }, - { name = "Phase 5: LLM query endpoint", completion = 0 }, - { name = "Phase 6: Bot write endpoints + TODO octads", completion = 0 }, - { name = "Phase 7: Contributor OAuth + scoped repo access", completion = 0 }, - { name = "Phase 8: Repo lockdown (visibility management)", completion = 0 }, -] - -[verification] -formal-proofs = "none — no ABI/FFI surface to verify (see PROOF-NEEDS.md, verification/README.adoc)" -correctness-evidence = "worker/test/ — Worker test suite + data-integrity invariants; gated by worker-ci.yml" -idris2-proofs = "deferred until/unless a native ABI surface is introduced" - -[blockers-and-issues] -blockers = [ - "Phase 3 deploy: CLOUDFLARE_API_TOKEN repo secret required to enable automated Worker deploys", - "Phase 3 live data + Phases 5-8: VeriSimDB instance (Phase 2) not yet stood up on a VPS", -] - -[critical-next-actions] -actions = [ - "Add CLOUDFLARE_API_TOKEN secret to enable Worker auto-deploy to staging/production", - "Stand up VeriSimDB instance on Verpex VPS (Phase 2) so the Worker reads live data", - "Write sync/ingest tooling in Rust", -] - -[recent-changes] -notes = [ - "2026-09-21: SonarCloud quality-gate repair — job-level permissions (5 workflows), CSPRNG request-id fallback (S2245), sonar-project.properties encodes estate-policy exclusions (actions.lock scheme, npm-avoidant policy, reviewed curl/http-LAN cases); wiki-sync.sh moved PAT handling out of URLs into a git credential helper.", - "2026-09-21: Docs close-out #2 — OpenAPI 3.1 contract (docs/api/openapi.yaml, #30, ADR 0004 resolved), release runbook (docs/governance/RELEASE-RUNBOOK.adoc, #31), wiki sync automation (wiki-sync.sh + workflow, #32), haec reclassified rm->fv/nl (#58).", - "2026-06-21: CI/docs hardening — standards reusables bumped (#26); Hypatia advisory findings cleared (#27, 11->3, all remaining are scanner false-positives); upstream fixes tracked in #28.", - "2026-06-21: Docs close-out — branch cleanup; added sketch guides + ADRs (see [documentation.sketches]); marked empty RSR scaffold dirs as planned; seeded docs/wikis/.", -] - -# Sketch/planned docs scaffolded 2026-06-21 — honest outlines present, content to be filled. -[documentation.sketches] -developer = [ - "docs/developer/VERISIM-QUERY-GUIDE.adoc", - "docs/developer/REPO-ONBOARDING.adoc", -] -user = ["docs/USER-API-GUIDE.adoc"] -maintainer = ["docs/governance/INCIDENT-RESPONSE.adoc"] -decisions = [ - "docs/decisions/0001-pointer-authority.adoc (accepted; expand)", - "docs/decisions/0002-clade-taxonomy.adoc (accepted; expand)", - "docs/decisions/0003-verisimdb-kv-architecture.adoc (accepted; expand)", - "docs/decisions/0004-api-versioning.adoc (accepted 2026-09-21: URL-path, additive-only within /v1 — see docs/api/openapi.yaml)", - "docs/decisions/0005-governance-exceptions.adoc (open)", -] -wiki = ["docs/wikis/Core-Concepts.adoc", "docs/wikis/Workflows.adoc", "docs/wikis/Glossary.adoc"] -tracked-issues = [] -docs-close-out = [ - "contract: docs/api/openapi.yaml (OpenAPI 3.1, authoritative)", - "runbook: docs/governance/RELEASE-RUNBOOK.adoc (Phase 1-8 rollout)", - "wiki-sync publisher: .machine_readable/scripts/forge/wiki-sync.sh (just wiki-sync / wiki-sync-dry-run)", - "wiki-sync automation: .github/workflows/wiki-sync.yml (one-way push on main; needs WIKI_SYNC_PAT secret)", -] diff --git a/.machine_readable/CLADE.a2ml b/.machine_readable/CLADE.a2ml deleted file mode 100644 index b58a451..0000000 --- a/.machine_readable/CLADE.a2ml +++ /dev/null @@ -1,55 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 -# Clade declaration for gv-clade-index itself - -[identity] -uuid = "c88e9ff3-9aac-5de8-b891-19b5de64aedd" -primary-forge = "github" -primary-owner = "hyperpolymath" -canonical-name = "gv-clade-index" -prefixed-name = "gv-clade-index" - -[clade] -primary = "gv" -secondary = ["db"] -assigned = "2026-03-16" -rationale = "This is a governance registry backed by a database; governance is the primary purpose" - -[forges] -github = "hyperpolymath/gv-clade-index" -gitlab = "hyperpolymath/gv-clade-index" -bitbucket = "hyperpolymath/gv-clade-index" - -[lineage] -type = "standalone" -parent = "" -born = "2026-03-16" - -# Lifecycle status. Identity (uuid) and status are SEPARATE layers: the uuid above -# follows the GitHub path (ADR 0007: a move or rename there remints it; a mirror -# move or a phase change never does); `phase` is a mutable pointer to the current -# life-phase. Transitions are legal in both directions — no phase is terminal -# (extinct -> active is a valid "Gitassic Park" resurrection on the same uuid). A -# prefixed-name (clade code) change with the GitHub path unchanged is NOT a phase -# change: the old prefixed-name goes to `aliases`, the uuid and phase are untouched. -[status] -# One of: reserved incubating active dormant | merged superseded archived extinct -# living -> reserved incubating active dormant -# ended -> merged superseded archived extinct -phase = "active" -since = "2026-03-16" # when the current phase began (status-since) -present = true # derived here/not-here-as-itself: - # here = reserved|incubating|active|dormant|archived - # not-here = merged|superseded|extinct -# Companion fields — fill only the ones the current phase makes meaningful: -aliases = [] # former prefixed-names (GitHub path unchanged; uuid kept) -merged-into = "" # uuid or binomial of target when phase=merged -superseded-by = "" # uuid or binomial of successor when phase=superseded -successors = [] # forward links (splits / spinoffs) -ended = "" # date an ended-family phase was first entered - -# Append-only arc. NEVER rewrite earlier rows — add a new one on every transition. -# This is the audit trail that makes resurrections legible. -[[status.history]] -phase = "active" -since = "2026-03-16" -note = "initial registration" diff --git a/.machine_readable/ENSAID_CONFIG.a2ml b/.machine_readable/ENSAID_CONFIG.a2ml deleted file mode 100644 index 4f134eb..0000000 --- a/.machine_readable/ENSAID_CONFIG.a2ml +++ /dev/null @@ -1,96 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 -# Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) -# -# ENSAID_CONFIG.a2ml — eNSAID Environment Configuration -# Per-repo configuration for PanLL and eNSAID-compatible tools. -# -# Canonical location: .machine_readable/ENSAID_CONFIG.a2ml -# Spec: https://github.com/hyperpolymath/standards/tree/main/ensaid-config -# -# Naming convention: -# - UPPERCASE + underscore = non-executable machine-readable file -# - Lives in .machine_readable/ alongside STATE.a2ml, META.a2ml, etc. - -# ───────────────────────────────────────────────────────────────── -# [ensaid] — Core eNSAID identity and version -# ───────────────────────────────────────────────────────────────── -[ensaid] -version = "1.0.0" -tool = "panll" - -# ───────────────────────────────────────────────────────────────── -# [workspace] — Workspace mode, protection, and execution policy -# ───────────────────────────────────────────────────────────────── -[workspace] -mode = "rhodium" # rhodium | gold | silver | bronze -protection = "open" # open | guarded | locked -execution = "live" # live | dry-run | approval-required - -# ───────────────────────────────────────────────────────────────── -# [preferences] — User/repo-level display and behaviour preferences -# ───────────────────────────────────────────────────────────────── -[preferences] -humidity = "medium" # high | medium | low (drift aura intensity) -default-arrangement = "default-3-panel" # workspace arrangement ID -auto-connect = true # auto-connect panels to backends on load - -# ───────────────────────────────────────────────────────────────── -# [panels] — Panel visibility, enablement, and isolation overrides -# ───────────────────────────────────────────────────────────────── -[panels] -version = "1.0.0" - -# By default, all panels are available. Uncomment to restrict: -# [[panels.enabled]] -# id = "valence-shell" -# isolation = "native" -# auto-connect = true -# -# [[panels.enabled]] -# id = "editor-bridge" -# isolation = "native" -# auto-connect = true - -# Panels to hide for this repo context: -# [panels.disabled] -# ids = [] - -# ───────────────────────────────────────────────────────────────── -# [workflows] — Automation Router event-driven cross-panel rules -# ───────────────────────────────────────────────────────────────── -[workflows] -version = "1.0.0" - -# Example: rebuild on file save -# [[workflows.rule]] -# name = "build-on-save" -# trigger = { event = "file-changed", pattern = "src/**/*.res" } -# condition = { panel = "build-dashboard", field = "watchMode", equals = true } -# action = { panel = "build-dashboard", message = "TriggerBuild", args = { target = "game" } } -# approval = "auto-fire" # auto-fire | require-approval | approve-once | dry-run-first - -# ───────────────────────────────────────────────────────────────── -# [clades] — Panel clade trait and capability overrides -# ───────────────────────────────────────────────────────────────── -[clades] -version = "1.0.0" - -# Example: add a custom capability to a panel clade -# [[clades.override]] -# id = "build-dashboard" -# traits = { has-work-items = true } -# capabilities-add = ["CustomCheck"] - -# ───────────────────────────────────────────────────────────────── -# [portfolios] — Custom panel bundles for this repo's workflow -# ───────────────────────────────────────────────────────────────── -[portfolios] -version = "1.0.0" - -# Example: a custom portfolio for this project -# [[portfolios.custom]] -# id = "{{project}}-dev" -# name = "gv-clade-index Development" -# description = "Panels for gv-clade-index development" -# panels = ["valence-shell", "editor-bridge", "build-dashboard"] -# default-isolation = "native" diff --git a/.machine_readable/MUST.contractile b/.machine_readable/MUST.contractile index 3f532bd..fbc713a 100644 --- a/.machine_readable/MUST.contractile +++ b/.machine_readable/MUST.contractile @@ -63,7 +63,7 @@ ; Structure (must ".machine_readable/ directory preserved") - (must "0-AI-MANIFEST.a2ml preserved") + (must "0-AI-MANIFEST.deed preserved") (must "no SCM files in repo root — only in .machine_readable/") ; CI diff --git a/.machine_readable/agent_instructions/README.adoc b/.machine_readable/agent_instructions/README.adoc deleted file mode 100644 index 1cc7487..0000000 --- a/.machine_readable/agent_instructions/README.adoc +++ /dev/null @@ -1,41 +0,0 @@ -// SPDX-License-Identifier: CC-BY-SA-4.0 -// Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) -= Agent Instructions -:toc: preamble - -Methodology-aware configuration for AI agents. Read by any AI agent -(Claude, Gemini, Copilot, etc.) at session start. - -== Files - -[cols="1,3"] -|=== -| File | Purpose - -| `methodology.a2ml` -| Default mode, invariants, ring ceiling, priority weights, convergent budget - -| `coverage.a2ml` -| Session coverage tracking — what was visited, what was skipped, what has MUSTs - -| `debt.a2ml` -| Meander debt — things found but not fixed, carried between sessions -|=== - -== How Agents Use These - -1. Read `methodology.a2ml` at session start — know mode, invariants, ceiling -2. Read `coverage.a2ml` — know what was visited last time, what was skipped -3. Read `debt.a2ml` — know what's outstanding from previous sessions -4. At session end, update `coverage.a2ml` and `debt.a2ml` - -== Relationship to Other Files - -* `AGENTIC.a2ml` says WHAT agents can do (permissions, gating) -* `agent_instructions/` 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) - -== Reference - -ADR-002 in `standards/agentic-a2ml/docs/ADR-002-methodology-layer.adoc` diff --git a/.machine_readable/agent_instructions/coverage.a2ml b/.machine_readable/agent_instructions/coverage.a2ml deleted file mode 100644 index 6979664..0000000 --- a/.machine_readable/agent_instructions/coverage.a2ml +++ /dev/null @@ -1,61 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 -# Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) -# -# coverage.a2ml — Session coverage tracking -# Updated at the end of each AI agent session. -# Persists what was visited, what was skipped, and what has MUSTs. -# -# Reference: ADR-002 in standards/agentic-a2ml/docs/ - -[metadata] -version = "1.0.0" -last-updated = "2026-03-24" - -# ============================================================================ -# COVERAGE STATE -# ============================================================================ -# Updated by agents at session end. Tracks which components have been -# visited and which have known MUSTs that were skipped. - -[coverage] -total-components = 0 -visited-components = 0 -coverage-percent = 0 - -# ============================================================================ -# VISITED COMPONENTS -# ============================================================================ -# Component → session date + ring reached -# Agents add entries as they work through components. -# -# Example: -# [coverage.visited.emergency-room] -# date = "2026-03-23" -# ring = 2 -# fixes = 3 -# notes = "boot-guardian built, shutdown-marshal built" - -# ============================================================================ -# SKIPPED COMPONENTS WITH MUSTS -# ============================================================================ -# Components with known MUSTs that were not visited in the most recent session. -# These become P1 inputs for the next session's Phase 0. -# -# Example: -# [coverage.skipped-musts.session-sentinel] -# priority = "P0" -# issue = "56 SIGABRTs in 4 days, D-Bus race condition" -# discovered = "2026-03-23" - -# ============================================================================ -# CHERRY-PICKING AUDIT -# ============================================================================ -# At session end, agents report whether they chose easy work over hard work. -# This is the accountability mechanism for the weighted priority system. -# -# [coverage.cherry-picking] -# easy-high-completed = 3 -# hard-high-completed = 1 -# easy-low-completed = 2 -# hard-low-deferred = 4 -# assessment = "Correctly prioritised — all MUST items addressed before COULDs" diff --git a/.machine_readable/agent_instructions/debt.a2ml b/.machine_readable/agent_instructions/debt.a2ml deleted file mode 100644 index c0238c5..0000000 --- a/.machine_readable/agent_instructions/debt.a2ml +++ /dev/null @@ -1,49 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 -# Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) -# -# debt.a2ml — Meander debt list -# Things found but not fixed. Carried between sessions. -# Becomes the next session's Phase 0 input. -# -# Reference: ADR-002 in standards/agentic-a2ml/docs/ - -[metadata] -version = "1.0.0" -last-updated = "2026-03-24" - -# ============================================================================ -# DEBT ITEMS -# ============================================================================ -# Each item has: component, issue, effort (easy|medium|hard), impact (high|medium|low), -# priority (should|could), and discovered date. -# -# Items are consumed (removed) when fixed. New items are added at session end. -# The debt list prevents the "one more wave" loop — found things are persisted, -# not forgotten, and not used as justification for infinite meandering. - -# ============================================================================ -# SHOULD — would fix next wave -# ============================================================================ -# These are inputs for the next session if the user says "keep going". -# -# Example: -# [[debt.should]] -# component = "system-tools/monitoring/observatory" -# issue = "Stale duplicate of root observatory/" -# effort = "easy" -# impact = "medium" -# discovered = "2026-03-23" - -# ============================================================================ -# COULD — would fix eventually -# ============================================================================ -# These are low-priority items that don't justify a session on their own. -# They get picked up when an agent is in the area for other reasons. -# -# Example: -# [[debt.could]] -# component = "cicada" -# issue = "RSR_OUTLINE.adoc references banned AGPL-3.0" -# effort = "easy" -# impact = "low" -# discovered = "2026-03-23" diff --git a/.machine_readable/agent_instructions/methodology.a2ml b/.machine_readable/agent_instructions/methodology.a2ml deleted file mode 100644 index 4d0b79e..0000000 --- a/.machine_readable/agent_instructions/methodology.a2ml +++ /dev/null @@ -1,107 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 -# Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) -# -# methodology.a2ml — AI agent methodology configuration -# Declares how agents should approach work in this repository. -# Read at session start by any AI agent (Claude, Gemini, Copilot, etc.) -# -# Reference: ADR-002 in standards/agentic-a2ml/docs/ - -[metadata] -version = "1.0.0" -last-updated = "2026-03-24" -spec = "https://github.com/hyperpolymath/standards/blob/main/agentic-a2ml/docs/ADR-002-methodology-layer.adoc" - -# ============================================================================ -# MODE SELECTION -# ============================================================================ -# convergent: find gaps, fill them, build infrastructure (default for ops/infra) -# divergent: find what's strongest, push it further (for research/creative) -# hybrid: audit 20% of budget, then focus 80% on top MUSTs (default for most) - -[methodology] -default-mode = "hybrid" -ring-ceiling = 2 # Hard ceiling for ring expansion (0-3) -wave-cap = 2 # Max waves before requiring user "keep going" -spike-required = true # Every session must ship code, not just designs - -# ============================================================================ -# PRIORITY WEIGHTS -# ============================================================================ -# MUST (3x): Blocking the current work → fix immediately -# SHOULD (2x): Degrading quality of current work → fix if in zone -# COULD (1x): Improving quality of adjacent work → add to debt list - -[methodology.priority-weights] -must = 3 -should = 2 -could = 1 - -# ============================================================================ -# CONVERGENT BUDGET (when mode = convergent or hybrid) -# ============================================================================ -# How to allocate effort across work types. -# Prevents over-polishing docs while structural work waits. - -[methodology.convergent-budget] -structural = 70 # % for new modules, compilation fixes, wiring, integration -corrective = 20 # % for bugs found, broken imports, stale references -perfective = 10 # % for SPDX headers, doc updates, formatting, style - -# ============================================================================ -# UNIQUE STRENGTH (when mode = divergent) -# ============================================================================ -# What makes this project special. Agents should DEEPEN this, not broaden it. -# Customise this per project — the template default is generic. - -[methodology.unique-strength] -description = "a single queryable source of truth for the ecosystem" -deepen-not-broaden = true - -# ============================================================================ -# DIVERGENT INVARIANTS -# ============================================================================ -# Constraints that divergent mode must NOT violate. -# These are the riverbanks — diverge within them, not across. -# "Amplify uniqueness" means deepen, not broaden. -# -# Test before any divergent action: -# "Does this deepen the existing strength, or add a parallel strength?" -# If parallel → stop. Note as cross-project insight. - -[methodology.divergent-invariants] -rules = [ - # Customise per project. Examples: - # "Idris2 only for formal verification — no Lean4, Coq, Agda", - # "believe_me count must remain zero", - # "FFI architecture: Idris2 → RefC → Zig → C ABI (no shortcuts)", -] - -# Optional: language invariant for the core strength -# If set, divergent mode will not introduce other languages for this purpose -# language-invariant = "idris2" - -# ============================================================================ -# CONSTRAINT HINTS -# ============================================================================ -# Help Phase 0 find the critical chain faster. -# Updated at session end with newly discovered constraints. - -[methodology.known-constraints] -constraints = [ - # Customise per project. Examples: - # "End-to-end build has never been verified", - # "libproject.so does not exist yet — all bindings call stubs", -] - -# ============================================================================ -# STATE FILE VALIDATION -# ============================================================================ -# Phase 0 reads STATE.a2ml first but it may be broken. -# These rules detect corrupt/template/stale state files. - -[methodology.state-validation] -reject-if-contains = ["{{PLACEHOLDER}}", "{{PROJECT}}", "rsr-template-repo"] -reject-if-project-name-mismatch = true -staleness-threshold-days = 90 -fallback-files = ["TODO.md", "TODO.adoc", "ROADMAP.adoc", "README.adoc"] diff --git a/.machine_readable/ai/.clinerules b/.machine_readable/ai/.clinerules index eb95175..2342329 100644 --- a/.machine_readable/ai/.clinerules +++ b/.machine_readable/ai/.clinerules @@ -2,7 +2,7 @@ # Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) # Authoritative source: docs/AI-CONVENTIONS.md -# STARTUP: Read 0-AI-MANIFEST.a2ml first, then .machine_readable/STATE.a2ml. +# STARTUP: Read 0-AI-MANIFEST.deed first, then gv-clade-index_chora.deed. # LICENSE # All original code: MPL-2.0. @@ -10,9 +10,9 @@ # SPDX header required on every source file. # Copyright: Jonathan D.A. Jewell (hyperpolymath) -# STATE FILES (.machine_readable/ ONLY) -# Never create in repo root: STATE.a2ml, META.a2ml, ECOSYSTEM.a2ml, -# AGENTIC.a2ml, NEUROSYM.a2ml, PLAYBOOK.a2ml. +# STATE FILES (.machine_readable/descriptiles/ ONLY) +# Repo metadata is deed (gv-clade-index_chora.deed, descriptiles/STATE.deed). +# A2ML is retired: never create a .a2ml file. # The .machine_readable/ directory is the single source of truth. # BANNED PATTERNS diff --git a/.machine_readable/ai/.cursorrules b/.machine_readable/ai/.cursorrules index 5255a80..94cfd18 100644 --- a/.machine_readable/ai/.cursorrules +++ b/.machine_readable/ai/.cursorrules @@ -2,7 +2,7 @@ # Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) # Authoritative source: docs/AI-CONVENTIONS.md -# Read 0-AI-MANIFEST.a2ml in the repo root FIRST for canonical file locations. +# Read 0-AI-MANIFEST.deed in the repo root FIRST; it points at the repo deed. # LICENSE # All original code: MPL-2.0 (SPDX header required on every file). @@ -10,9 +10,9 @@ # Copyright: Jonathan D.A. Jewell (hyperpolymath) # STATE FILES -# .a2ml metadata files go in .machine_readable/ ONLY. -# Never create STATE.a2ml, META.a2ml, ECOSYSTEM.a2ml, AGENTIC.a2ml, -# NEUROSYM.a2ml, or PLAYBOOK.a2ml in the repository root. +# Repo metadata is deed: gv-clade-index_chora.deed at the root, descriptiles +# (STATE.deed, …) in .machine_readable/descriptiles/ ONLY. +# A2ML is retired: never create a .a2ml file. # BANNED PATTERNS # Idris2: believe_me, assert_total, assert_smaller, unsafePerformIO diff --git a/.machine_readable/ai/.windsurfrules b/.machine_readable/ai/.windsurfrules index eb95175..2342329 100644 --- a/.machine_readable/ai/.windsurfrules +++ b/.machine_readable/ai/.windsurfrules @@ -2,7 +2,7 @@ # Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) # Authoritative source: docs/AI-CONVENTIONS.md -# STARTUP: Read 0-AI-MANIFEST.a2ml first, then .machine_readable/STATE.a2ml. +# STARTUP: Read 0-AI-MANIFEST.deed first, then gv-clade-index_chora.deed. # LICENSE # All original code: MPL-2.0. @@ -10,9 +10,9 @@ # SPDX header required on every source file. # Copyright: Jonathan D.A. Jewell (hyperpolymath) -# STATE FILES (.machine_readable/ ONLY) -# Never create in repo root: STATE.a2ml, META.a2ml, ECOSYSTEM.a2ml, -# AGENTIC.a2ml, NEUROSYM.a2ml, PLAYBOOK.a2ml. +# STATE FILES (.machine_readable/descriptiles/ ONLY) +# Repo metadata is deed (gv-clade-index_chora.deed, descriptiles/STATE.deed). +# A2ML is retired: never create a .a2ml file. # The .machine_readable/ directory is the single source of truth. # BANNED PATTERNS diff --git a/.machine_readable/ai/0.2-AI-MANIFEST.a2ml b/.machine_readable/ai/0.2-AI-MANIFEST.a2ml deleted file mode 100644 index 869cbee..0000000 --- a/.machine_readable/ai/0.2-AI-MANIFEST.a2ml +++ /dev/null @@ -1,11 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 ---- -### [META] -id: "ai-registry" -level: 2 -parent: "../0.1-AI-MANIFEST.a2ml" - ---- -### [AI_MANIFEST] -description: | - Sub-registry for ai metadata. diff --git a/.machine_readable/ai/AI.a2ml b/.machine_readable/ai/AI.a2ml deleted file mode 100644 index c683d30..0000000 --- a/.machine_readable/ai/AI.a2ml +++ /dev/null @@ -1,16 +0,0 @@ - -# AI Assistant Instructions - -## Repository Focus -- `rsr-template-repo` is treated as a Rhodium Standard Repository; obey the Rhodium policies and keep `.machine_readable/` authoritative. -- All machine-readable content lives under `.machine_readable/` — state files (a2ml), bot directives, and contractiles. -- Prefer to keep generated files out of source control, and regenerate them with the documented commands before committing. - -## Workflow -1. Inspect `.machine_readable/STATE.a2ml` for blockers and next actions. -2. Respect any constraints listed inside `.machine_readable/AGENTIC.a2ml` when tooling changes are requested. -3. After finishing edits, update STATE with your outcomes and commit with a concise, imperative message. - -## Delivery Promises -- Mention in summaries whether STATE, `.machine_readable/contractiles/`, or `.machine_readable/bot_directives/` changed. -- Keep this file in sync with the repository's status; update it if the governance changes. diff --git a/.machine_readable/ai/README.adoc b/.machine_readable/ai/README.adoc index 121bbc8..5d6bd54 100644 --- a/.machine_readable/ai/README.adoc +++ b/.machine_readable/ai/README.adoc @@ -7,16 +7,14 @@ Examples: * `CLAUDE.md` * `COPILOT.md` * `GEMINI.md` -* `AI.a2ml` -* `AI.djot` Avoid scattering agent instruction files around the repo root. Recommended machine read order: -* `.machine_readable/anchors/ANCHOR.a2ml` -* `.machine_readable/policies/MAINTENANCE-AXES.a2ml` -* `.machine_readable/policies/MAINTENANCE-CHECKLIST.a2ml` -* `.machine_readable/policies/SOFTWARE-DEVELOPMENT-APPROACH.a2ml` -* `.machine_readable/STATE.a2ml` -* `.machine_readable/META.a2ml` +* `0-AI-MANIFEST.deed` (pointer-only front door) +* `gv-clade-index_chora.deed` (repo facts, including the `(agentic)` clause) +* `.machine_readable/descriptiles/STATE.deed` (lifecycle status, maturity) + +A2ML is retired; never add a `.a2ml` file here +(`docs/history/A2ML-REMOVED.adoc`). diff --git a/.machine_readable/anchors/0.2-AI-MANIFEST.a2ml b/.machine_readable/anchors/0.2-AI-MANIFEST.a2ml deleted file mode 100644 index 45038e1..0000000 --- a/.machine_readable/anchors/0.2-AI-MANIFEST.a2ml +++ /dev/null @@ -1,11 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 ---- -### [META] -id: "anchors-registry" -level: 2 -parent: "../0.1-AI-MANIFEST.a2ml" - ---- -### [AI_MANIFEST] -description: | - Sub-registry for anchors metadata. diff --git a/.machine_readable/anchors/ANCHOR.a2ml b/.machine_readable/anchors/ANCHOR.a2ml deleted file mode 100644 index 2c76375..0000000 --- a/.machine_readable/anchors/ANCHOR.a2ml +++ /dev/null @@ -1,62 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 -# Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) -# -# ANCHOR.a2ml - authoritative anchor for this repository - -[metadata] -version = "1.0.0" -last-updated = "2026-06-21" - -[anchor] -schema = "hyperpolymath.anchor/1" -repo = "hyperpolymath/gv-clade-index" -authority = "upstream-canonical" - -purpose = [ - "Define canonical semantics and policy boundaries for this repository.", - "Declare what downstream/satellite repos can extend but not redefine.", - "Provide a stable golden path and invariant contract for release readiness.", -] - -[identity] -project = "gv-clade-index" -kind = "registry / governance service" # language | library | service | tool -one-sentence = "VeriSimDB-backed clade taxonomy and central registry for the hyperpolymath ecosystem" -domain = "developer-ecosystem governance" - -[semantic-authority] -policy = "canonical" - -owns = [ - "Project semantics and specification", - "Invariant definitions and contractiles", - "Reference implementation behavior", -] - -[implementation-policy] -allowed = ["Rust", "Idris2", "Zig", "Scheme", "Shell", "Just", "AsciiDoc", "Markdown"] -forbidden = ["Node.js", "npm"] - -[golden-path] -smoke-test-command = [ - "just test", - "just quality", -] - -success-criteria = [ - "Core tests pass", - "Quality gates pass", - "No unresolved critical security findings", -] - -[satellite-policy] -must-pin-upstream = true -must-declare-authority = true -must-have-anchor = true -must-have-golden-path = true - -[semantic-authority-files] -language-spec = "SPECIFICATION.md" -formal-proofs = "docs/proofs/PROOFS.adoc" -type-theory = "docs/theory/THEORY.adoc" -algorithms = "docs/theory/ALGORITHMS.adoc" diff --git a/.machine_readable/configs/0.2-AI-MANIFEST.a2ml b/.machine_readable/configs/0.2-AI-MANIFEST.a2ml deleted file mode 100644 index 6e41e6c..0000000 --- a/.machine_readable/configs/0.2-AI-MANIFEST.a2ml +++ /dev/null @@ -1,11 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 ---- -### [META] -id: "configs-registry" -level: 2 -parent: "../0.1-AI-MANIFEST.a2ml" - ---- -### [AI_MANIFEST] -description: | - Sub-registry for configs metadata. diff --git a/.machine_readable/contractiles/bust/Bustfile.a2ml b/.machine_readable/contractiles/bust/Bustfile.a2ml deleted file mode 100644 index bb6c122..0000000 --- a/.machine_readable/contractiles/bust/Bustfile.a2ml +++ /dev/null @@ -1,28 +0,0 @@ -// Bustfile.a2ml — meta-repo bust contractile (breakage / rollback) -// SPDX-License-Identifier: MPL-2.0 - -Bust { - name: "gv-clade-index" - version: "1.0.0" - description: "Rollback procedures when something breaks in the meta-repo" - - scenarios: { - "bad-pointer-bump": "git revert in meta-repo; child repo itself untouched" - "submodule-pointer-points-at-missing-sha": "git submodule update --init --checkout resets child to parent-recorded SHA; OR revert the stale bump commit" - "submodule-orphan-after-local-only-commit": "roll back locally with git reset to before the stranded commit; fix remote situation before re-attempting" - "accidental-private-repo-content-leaked-to-public-submodule": "hard-rotate the leaked secret immediately; git-filter-repo or BFG on the submodule's own history; public re-publication only after rotation complete" - } - - escalation-ladder: [ - "1. revert the meta-repo commit (reversible, low blast radius)", - "2. reset the local submodule clone (affects only local workspace)", - "3. force-push to main — PROHIBITED without explicit user confirmation (violates branch protection)", - "4. registry-level (delete/archive the GitHub repo) — human-only action, never by AI" - ] - - backup-points: [ - "GitHub serves as the durable backup for every submodule's own history", - "Meta-repo history on origin/main is the durable backup for pointer state", - "Local backup tags (backup/pre--) retained on risky rewrites" - ] -} diff --git a/.machine_readable/contractiles/bust/bust.ncl b/.machine_readable/contractiles/bust/bust.ncl index fc8cb8c..82171e0 100644 --- a/.machine_readable/contractiles/bust/bust.ncl +++ b/.machine_readable/contractiles/bust/bust.ncl @@ -1,7 +1,9 @@ # SPDX-License-Identifier: MPL-2.0 # Bust — error-handling / failure-recovery runner # -# Pairs with: Bustfile.a2ml (same directory) +# Pairs with: Bustfile.deed (same directory; A7 8.1). Not yet written: the +# legacy Bustfile.a2ml was retired 2026-11-14 with no mapping +# spec to translate it (docs/history/A2ML-REMOVED.adoc). # Verb: bust # Semantics: every declared failure mode must have a recovery path that has # been exercised. Runner injects failures (via declared probes) @@ -33,7 +35,7 @@ let base = import "../_base.ncl" in name = "bust-runner", version = "1.0.0", description = "Exercises declared failure modes and verifies recovery paths. Hard-gates on any failure mode without working recovery.", - paired_xfile = "Bustfile.a2ml", + paired_xfile = "Bustfile.deed", author = "Jonathan D.A. Jewell ", }, }, diff --git a/.machine_readable/contractiles/dust/Dustfile.a2ml b/.machine_readable/contractiles/dust/Dustfile.a2ml deleted file mode 100644 index be38a8c..0000000 --- a/.machine_readable/contractiles/dust/Dustfile.a2ml +++ /dev/null @@ -1,44 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 -# Dustfile — Cleanup and hygiene contract -# Author: Jonathan D.A. Jewell - -@abstract: -What should be cleaned up or removed from this repository. -These are housekeeping items, not blockers. -@end - -## Stale Files - -### no-stale-snapshots -- description: No dated status/completion files in root -- run: "! ls *-STATUS-*.md *-COMPLETION-*.md *-COMPLETE.md *-VERIFIED-*.md 2>/dev/null | head -1 | grep -q ." -- severity: info - -### no-ai-djot -- description: AI.djot is superseded by 0-AI-MANIFEST.a2ml -- run: test ! -f AI.djot -- severity: warning - -### no-next-steps -- description: NEXT_STEPS.md superseded by ROADMAP -- run: test ! -f NEXT_STEPS.md -- severity: info - -## Build Artifacts - -### no-tracked-artifacts -- description: No build artifacts tracked in git -- run: "! git ls-files lib/bs/ lib/ocaml/ target/release/ _build/ 2>/dev/null | head -1 | grep -q ." -- severity: warning - -## Format Duplicates - -### no-duplicate-contributing -- description: Only one CONTRIBUTING format (keep .md) -- run: "! (test -f CONTRIBUTING.md && test -f CONTRIBUTING.adoc)" -- severity: warning - -### no-duplicate-readme -- description: Only one README format -- run: "! (test -f README.md && test -f README.adoc && [ $(wc -l < README.md) -gt 5 ])" -- severity: warning diff --git a/.machine_readable/contractiles/must/Mustfile.a2ml b/.machine_readable/contractiles/must/Mustfile.a2ml deleted file mode 100644 index 215c510..0000000 --- a/.machine_readable/contractiles/must/Mustfile.a2ml +++ /dev/null @@ -1,69 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 -# Mustfile — Physical state contract -# Author: Jonathan D.A. Jewell - -@abstract: -What MUST be true about this repository's files and configuration. -These are hard requirements — CI fails if any check fails. -@end - -## File Presence - -### license-present -- description: LICENSE file must exist -- run: test -f LICENSE -- severity: critical - -### readme-present -- description: README.adoc or README.md must exist -- run: test -f README.adoc || test -f README.md -- severity: critical - -### security-policy -- description: SECURITY.md must exist -- run: test -f SECURITY.md -- severity: critical - -### ai-manifest -- description: 0-AI-MANIFEST.a2ml must exist -- run: test -f 0-AI-MANIFEST.a2ml -- severity: critical - -### contributing -- description: CONTRIBUTING.md must exist (GitHub community health) -- run: test -f CONTRIBUTING.md -- severity: warning - -### editorconfig -- description: .editorconfig must exist -- run: test -f .editorconfig -- severity: warning - -## SPDX Compliance - -### spdx-headers -- description: All source files must have SPDX-License-Identifier -- run: "! find src/ -name '*.rs' -o -name '*.res' -o -name '*.idr' -o -name '*.zig' 2>/dev/null | head -20 | xargs grep -L 'SPDX-License-Identifier' 2>/dev/null | head -1 | grep -q ." -- severity: warning - -### no-agpl -- description: No AGPL-3.0 references in dotfiles -- run: "! grep -r 'AGPL-3.0' .gitignore .gitattributes .editorconfig 2>/dev/null | head -1 | grep -q ." -- severity: critical - -## Dangerous Patterns - -### no-believe-me -- description: No believe_me in Idris2 code -- run: "! grep -r 'believe_me' --include='*.idr' . 2>/dev/null | grep -v node_modules | head -1 | grep -q ." -- severity: critical - -### no-sorry -- description: No sorry in Lean code -- run: "! grep -r 'sorry' --include='*.lean' . 2>/dev/null | grep -v node_modules | head -1 | grep -q ." -- severity: critical - -### no-admitted -- description: No Admitted in Coq code -- run: "! grep -r 'Admitted' --include='*.v' . 2>/dev/null | grep -v node_modules | head -1 | grep -q ." -- severity: critical diff --git a/.machine_readable/contractiles/trust/Trustfile.a2ml b/.machine_readable/contractiles/trust/Trustfile.a2ml deleted file mode 100644 index f2a4f95..0000000 --- a/.machine_readable/contractiles/trust/Trustfile.a2ml +++ /dev/null @@ -1,50 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 -# Trustfile — Integrity and provenance verification -# Author: Jonathan D.A. Jewell - -@abstract: -Integrity invariants for this repository. These verify that the repo -has not been tampered with, secrets are not leaked, and provenance -is traceable. -@end - -## Secrets - -### no-secrets-committed -- description: No credential files in repo -- run: test ! -f .env && test ! -f credentials.json && test ! -f .env.local && test ! -f .env.production -- severity: critical - -### no-private-keys -- description: No private key files committed -- run: "! find . -name '*.pem' -o -name '*.key' -o -name 'id_rsa' -o -name 'id_ed25519' 2>/dev/null | grep -v node_modules | head -1 | grep -q ." -- severity: critical - -### no-tokens-in-source -- description: No hardcoded API tokens in source -- run: "! grep -rE '(api[_-]?key|secret|token|password)\s*[:=]\s*[\"'\\''][A-Za-z0-9]{16,}' --include='*.js' --include='*.ts' --include='*.res' --include='*.py' . 2>/dev/null | grep -v node_modules | head -1 | grep -q ." -- severity: critical - -## Provenance - -### author-correct -- description: Git author matches expected identity -- run: "git log -1 --format='%ae' | grep -qE '(hyperpolymath|j\\.d\\.a\\.jewell)'" -- severity: warning - -### license-content -- description: LICENSE contains expected identifier -- run: grep -q 'PMPL\|MPL\|MIT\|Apache\|LGPL' LICENSE -- severity: warning - -## Container Security - -### container-images-pinned -- description: Containerfile uses pinned base images -- run: test ! -f Containerfile || grep -q 'cgr.dev\|@sha256:' Containerfile -- severity: warning - -### no-dockerfile -- description: No Dockerfile (use Containerfile) -- run: test ! -f Dockerfile -- severity: warning diff --git a/.machine_readable/descriptiles/STATE.deed b/.machine_readable/descriptiles/STATE.deed new file mode 100644 index 0000000..04bae4e --- /dev/null +++ b/.machine_readable/descriptiles/STATE.deed @@ -0,0 +1,37 @@ +;; SPDX-License-Identifier: MPL-2.0 +;; SPDX-FileCopyrightText: 2026 Jonathan D.A. Jewell (hyperpolymath) +;; +;; STATE.deed of gv-clade-index (A7 J14, J15; profile deed_lint.js --state). +;; +;; (status) is the [status] block of the retired .machine_readable/CLADE.a2ml, +;; field for field, under standards 1-formats/deed/mappings/clade-to-repo-deed.adoc +;; (its lifecycle rows go here, not to the chora deed). (maturity) is +;; [position] maturity of the retired .machine_readable/6a2/STATE.a2ml under +;; state-v1-decision.adoc option B; the source gave it no date, so there is no +;; :since. STATE.a2ml's [metadata] status and [position] phase double-track the +;; lifecycle claim above and are dropped; its milestones, blockers, next +;; actions and notes are journal, archived by reference in +;; docs/history/A2ML-REMOVED.adoc. The live roadmap is ROADMAP.adoc. +;; +;; :affirmed is the date of the translation, by an agent; it says the values +;; were carried over as the sources held them, not that they were re-audited. +(descriptile-deed + :schema-version "1.0.0" + :canonical-name "gv-clade-index" + :of-chora #uuid"a65b74d8-351a-89d9-a38d-aea470863b03" + :affirmed "2026-11-14" :affirmed-by agent + (status + :phase active + :since "2026-03-16" + :present #t + :aliases () + :merged-into "" + :superseded-by "" + :successors () + :ended "" + (history + (entry :phase active + :since "2026-03-16" + :note "initial registration"))) + (maturity + :level alpha)) diff --git a/.machine_readable/integrations/feedback-o-tron.a2ml b/.machine_readable/integrations/feedback-o-tron.a2ml deleted file mode 100644 index 5381604..0000000 --- a/.machine_readable/integrations/feedback-o-tron.a2ml +++ /dev/null @@ -1,13 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 -# Feedback-o-Tron Integration — Autonomous Bug Reporting - -[integration] -name = "feedback-o-tron" -type = "bug-reporter" -repository = "https://github.com/hyperpolymath/feedback-o-tron" - -[reporting-config] -platforms = ["github", "gitlab", "bugzilla"] -deduplication = true -audit-logging = true -auto-file-upstream = "on-external-dependency-failure" diff --git a/.machine_readable/integrations/proven.a2ml b/.machine_readable/integrations/proven.a2ml deleted file mode 100644 index 9af33ff..0000000 --- a/.machine_readable/integrations/proven.a2ml +++ /dev/null @@ -1,18 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 -# Proven Integration — Formally Verified Safety Library - -[integration] -name = "proven" -type = "safety-library" -repository = "https://github.com/hyperpolymath/proven" -version = "1.2.0" - -[binding-policy] -approach = "thin-ffi-wrapper" -unsafe-patterns = "replace-with-proven-equivalent" -modules-available = ["SafeMath", "SafeString", "SafeJSON", "SafeURL", "SafeRegex", "SafeSQL", "SafeFile", "SafeTemplate", "SafeCrypto"] - -[adoption-guidance] -priority = "high" -scope = "all-string-json-url-crypto-operations" -migration = "incremental — replace unsafe patterns as encountered" diff --git a/.machine_readable/integrations/verisim.a2ml b/.machine_readable/integrations/verisim.a2ml deleted file mode 100644 index 164c522..0000000 --- a/.machine_readable/integrations/verisim.a2ml +++ /dev/null @@ -1,15 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 -# VeriSimDB Feed — Cross-Repo Analytics Data Store - -[integration] -name = "verisimdb" -type = "data-feed" -repository = "https://github.com/hyperpolymath/nextgen-databases" -data-store = "verisimdb-data" - -[feed-config] -emit-scan-results = true -emit-build-metrics = true -emit-dependency-graph = true -format = "hexad" -destination = "verisimdb-data/feeds/" diff --git a/.machine_readable/integrations/vexometer.a2ml b/.machine_readable/integrations/vexometer.a2ml deleted file mode 100644 index 238b3d2..0000000 --- a/.machine_readable/integrations/vexometer.a2ml +++ /dev/null @@ -1,18 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 -# Vexometer Integration — Irritation Surface Analysis - -[integration] -name = "vexometer" -type = "friction-measurement" -repository = "https://github.com/hyperpolymath/vexometer" - -[measurement-config] -dimensions = 10 -emit-isa-reports = true -lazy-eliminator = true -satellite-interventions = true - -[hooks] -cli-tools = "measure-on-error" -ui-panels = "measure-on-interaction" -build-failures = "measure-on-failure" diff --git a/.machine_readable/policies/0.2-AI-MANIFEST.a2ml b/.machine_readable/policies/0.2-AI-MANIFEST.a2ml deleted file mode 100644 index 01a1914..0000000 --- a/.machine_readable/policies/0.2-AI-MANIFEST.a2ml +++ /dev/null @@ -1,11 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 ---- -### [META] -id: "policies-registry" -level: 2 -parent: "../0.1-AI-MANIFEST.a2ml" - ---- -### [AI_MANIFEST] -description: | - Sub-registry for policies metadata. diff --git a/.machine_readable/policies/MAINTENANCE-AXES.a2ml b/.machine_readable/policies/MAINTENANCE-AXES.a2ml deleted file mode 100644 index 0e2a48a..0000000 --- a/.machine_readable/policies/MAINTENANCE-AXES.a2ml +++ /dev/null @@ -1,54 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 -# Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) -# -# Canonical maintenance governance model - -[metadata] -version = "1.0.0" -last-updated = "2026-06-21" -scope = "repo" - -[discovery] -human-entrypoints = [ - "README.adoc", - "docs/maintenance/MAINTENANCE-CHECKLIST.md", - "docs/practice/SOFTWARE-DEVELOPMENT-APPROACH.adoc", -] -machine-entrypoints = [ - ".machine_readable/policies/MAINTENANCE-AXES.a2ml", - ".machine_readable/policies/MAINTENANCE-CHECKLIST.a2ml", - ".machine_readable/policies/SOFTWARE-DEVELOPMENT-APPROACH.a2ml", - ".machine_readable/META.a2ml", - ".machine_readable/ai/README.adoc", - ".machine_readable/bot_directives/README.scm", -] -bots = ["hypatia", "gitbot-fleet", "repo visitors"] - -[axes] -axis-1 = "must > intend > like" -axis-2 = "corrective > adaptive > perfective" -axis-3 = "systems > compliance > effects" -execution-order = "axis-1 > axis-2 > axis-3" - -[axis-1-scoping] -required = true -sources = "README, roadmap, status docs, maintenance checklist, CI/security docs" -markers = "TODO/FIXME/XXX/HACK/STUB/PARTIAL" -idris-unsound-markers = "believe_me/assert_total" -output = "scoped work assembly in must/intend/like buckets" - -[axis-2-maintenance] -corrective-first = true -adaptive-second = true -adaptive-focus = "scope changes, stale references, obsolete work culling" -perfective-third = true -perfective-source = "honest state from axis-1 after corrective/adaptive updates" - -[axis-3-audit] -systems-check = true -compliance-check = true -effects-check = true -compliance-focus = "seams/compromises/exception register and anti-drift" -compliance-tooling = "panic-attack" -effects-tooling = "ecological checking with sustainabot guidance" -effects-evidence = "benchmark evidence and maintainer dialogue/status review" diff --git a/.machine_readable/policies/MAINTENANCE-CHECKLIST.a2ml b/.machine_readable/policies/MAINTENANCE-CHECKLIST.a2ml deleted file mode 100644 index eaee720..0000000 --- a/.machine_readable/policies/MAINTENANCE-CHECKLIST.a2ml +++ /dev/null @@ -1,159 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 -# Cross-repo maintenance baseline (machine-readable canonical) - -[metadata] -version = "1.1.0" -last-updated = "2026-02-24" -scope = "cross-repo" -source-human = "docs/maintenance/MAINTENANCE-CHECKLIST.adoc" -companion-human = "docs/practice/SOFTWARE-DEVELOPMENT-APPROACH.adoc" -companion-machine = ".machine_readable/policies/SOFTWARE-DEVELOPMENT-APPROACH.a2ml" - -[policy] -single-source = true -notes = "Use this file as canonical machine policy and keep markdown synchronized." - -[maintenance-axes] -scoping-first = true -execution-order = ["scoping", "axis-1", "axis-2", "axis-3"] -axis-1 = "must > intend > like" -axis-2 = "corrective > adaptive > perfective" -axis-3 = "systems > compliance > effects" - -[scoping] -inputs_required = [ - "README", - "roadmap", - "status-docs", - "maintenance-checklist", - "ci-and-security-docs", -] - -marker_scan_required = [ - "TODO", - "FIXME", - "XXX", - "HACK", - "STUB", - "PARTIAL", -] - -idris_unsound_scan_required = [ - "believe_me", - "assert_total", -] - -scope_assembly_buckets = ["must", "intend", "like"] - -[axis-2-maintenance-rules] -corrective-first = true -adaptive-second = true -adaptive_examples = [ - "scope-change reconciliation", - "stale-reference removal", - "obsolete-work culling", -] -perfective-third = true -perfective_source = "axis-1 honest state after corrective/adaptive updates" - -[axis-3-audit-rules] -systems-check = true -documentation-honesty-check = true -safety-security-accounted-check = true -effects-review-check = true -benchmark-evidence-required = true -maintainer-dialogue-review-required = true -compliance-seams-check = true -exception-register-required = true -exception-bounded-scope-required = true -policy-drift-contamination-check = true -example-drift-risk = "single TypeScript exception causing broad ReScript->TypeScript migration" -compliance-tooling = "panic-attack" -effects-tooling = "ecological checking with sustainabot guidance" - -[generic-cleanup-finish-off] -root-cleanup-required = true -stale-work-cull-required = true -docs-parity-required = true -machine-human-sync-required = true -compliance-finish-off-required = true -effects-finish-off-required = true -release-prep-summary-required = true -next-actions-required = ["corrective", "adaptive", "perfective"] - -[must] -root_control_files = [ - ".gitignore", - ".gitattributes", - ".editorconfig", - ".tool-versions", - "Containerfile", - "Justfile", -] - -root_hosting_files = [ - "CNAME", - ".nojekyll", -] - -ownership_files = [ - "MAINTAINER", - ".github/CODEOWNERS", -] - -machine_readable_required = [ - ".machine_readable/anchors/ANCHOR.a2ml", - ".machine_readable/contractiles/", - ".machine_readable/ai/", - ".machine_readable/bot_directives/", -] - -contractiles_required = [ - "Mustfile", - "Trustfile", - "Intentfile", -] - -security_required = [ - ".well-known/security.txt", - "ci-security-scan", -] - -quality_gate_required = [ - "format", - "lint", - "unit-tests", - "integration-tests", - "p2p-tests", - "e2e-tests", - "bench-smoke", - "docs-check", - "security-scan", -] - -abi_ffi_policy = [ - "ABI Idris2 in src/interface/abi/*.idr", - "FFI Zig in ffi/**/*.zig", -] - -[should] -docs_primary_format = "adoc" -docs_structure = [ - "docs/theory", - "docs/practice", - "docs/whitepapers/academic", - "docs/whitepapers/industry", - "docs/proofs", - "docs/reports", -] - -root_minimization = true -well_known_metadata = true -roadmap_honesty_with_dates = true -ci_doc_format_policy = true - -[could] -generate_human_from_machine = true -mode_aware_bots = ["corrective", "adaptive", "perfective", "audit"] -topology_dashboard = true -exception_registry = true diff --git a/.machine_readable/policies/SOFTWARE-DEVELOPMENT-APPROACH.a2ml b/.machine_readable/policies/SOFTWARE-DEVELOPMENT-APPROACH.a2ml deleted file mode 100644 index 093573a..0000000 --- a/.machine_readable/policies/SOFTWARE-DEVELOPMENT-APPROACH.a2ml +++ /dev/null @@ -1,53 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 -# General software development approach (machine-readable) - -[metadata] -version = "1.0.0" -last-updated = "2026-02-24" -scope = "cross-repo" -source-human = "docs/practice/SOFTWARE-DEVELOPMENT-APPROACH.adoc" - -[execution] -order = ["axis-1", "axis-2", "axis-3"] - -[axis-1] -name = "scope" -priority = "must > intend > like" -inputs = [ - "README", - "roadmap", - "status-docs", - "ci-and-security-docs", -] -marker-scan = ["TODO", "FIXME", "XXX", "HACK", "STUB", "PARTIAL"] -idris-unsound-scan = ["believe_me", "assert_total"] -output = "scoped-work-assembly" - -[axis-2] -name = "maintenance" -priority = "corrective > adaptive > perfective" -corrective = "defect/regression/safety/security fixes" -adaptive = "scope reconciliation, stale-reference removal, obsolete-work culling" -perfective = "quality improvements derived from axis-1 honest state" - -[axis-3] -name = "audit" -priority = "systems > compliance > effects" -systems = "required systems present and operating" -compliance = "exceptions explicit, bounded, and drift-resistant" -effects = "benchmark/operational impact evidence captured and reviewed" -compliance-tooling = "panic-attack" -effects-tooling = "ecological checking with sustainabot guidance" - -[cleanup-finish-off] -root-cleanup = true -stale-work-cull = true -docs-sync-human-machine = true -compliance-audit = true -effects-audit = true -release-summary = ["must", "should", "could"] -next-actions = ["corrective", "adaptive", "perfective"] - -[collaboration] -maintainer-dialogue-required = true -dialogue-topics = ["what changed", "why", "remaining risks"] diff --git a/.machine_readable/scripts/0.2-AI-MANIFEST.a2ml b/.machine_readable/scripts/0.2-AI-MANIFEST.a2ml deleted file mode 100644 index 615df84..0000000 --- a/.machine_readable/scripts/0.2-AI-MANIFEST.a2ml +++ /dev/null @@ -1,18 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 ---- -### [META] -id: "automation-scripts-unit" -level: 2 -parent: "../0.1-AI-MANIFEST.a2ml" - ---- -### [AI_MANIFEST] -description: | - Internal automation logic for the project lifecycle, forge sync, - verification triggers, and maintenance. - -canonical_locations: - maintenance: "maintenance/" - lifecycle: "lifecycle/" - forge: "forge/" - verification: "verification/" diff --git a/.machine_readable/scripts/forge/0.3-AI-MANIFEST.a2ml b/.machine_readable/scripts/forge/0.3-AI-MANIFEST.a2ml deleted file mode 100644 index 4bbd6cf..0000000 --- a/.machine_readable/scripts/forge/0.3-AI-MANIFEST.a2ml +++ /dev/null @@ -1,11 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 ---- -### [META] -id: "automation-unit-forge" -level: 3 -parent: "../0.2-AI-MANIFEST.a2ml" - ---- -### [AI_MANIFEST] -description: | - Internal automation logic for project forge. diff --git a/.machine_readable/scripts/lifecycle/0.3-AI-MANIFEST.a2ml b/.machine_readable/scripts/lifecycle/0.3-AI-MANIFEST.a2ml deleted file mode 100644 index 3182d17..0000000 --- a/.machine_readable/scripts/lifecycle/0.3-AI-MANIFEST.a2ml +++ /dev/null @@ -1,11 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 ---- -### [META] -id: "automation-unit-lifecycle" -level: 3 -parent: "../0.2-AI-MANIFEST.a2ml" - ---- -### [AI_MANIFEST] -description: | - Internal automation logic for project lifecycle. diff --git a/.machine_readable/scripts/verification/0.3-AI-MANIFEST.a2ml b/.machine_readable/scripts/verification/0.3-AI-MANIFEST.a2ml deleted file mode 100644 index 460e069..0000000 --- a/.machine_readable/scripts/verification/0.3-AI-MANIFEST.a2ml +++ /dev/null @@ -1,11 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 ---- -### [META] -id: "automation-unit-verification" -level: 3 -parent: "../0.2-AI-MANIFEST.a2ml" - ---- -### [AI_MANIFEST] -description: | - Internal automation logic for project verification. diff --git a/0-AI-MANIFEST.a2ml b/0-AI-MANIFEST.a2ml deleted file mode 100644 index 7ddf175..0000000 --- a/0-AI-MANIFEST.a2ml +++ /dev/null @@ -1,76 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 -# 0-AI-MANIFEST.a2ml — Universal entry point for ALL AI agents - -# STOP — CRITICAL READING REQUIRED - -**THIS FILE MUST BE READ FIRST BY ALL AI AGENTS** - -## WHAT IS THIS? - -This is the AI manifest for **gv-clade-index** — the VeriSimDB-backed clade taxonomy -and central registry for the entire hyperpolymath ecosystem (200+ repositories). - -## PURPOSE - -gv-clade-index is the **map** of the hyperpolymath territory. It contains: -- 12 clade definitions (fv, nl, rm, gv, db, ap, ix, dx, pt, ax, gm, sc) -- Registry of all 200+ repos with clade assignments and forge identity (PK/FK) -- VQL schema for repos, TODOs, observations, feedback, lineage -- Pre-built queries for dashboards, drift detection, bot findings -- Pointer authority system (pointer/local/derived) for data ownership - -## CANONICAL LOCATIONS - -### Machine-Readable Metadata: `.machine_readable/` ONLY -1. **STATE.a2ml** — Project state, progress, blockers -2. **META.a2ml** — Architecture decisions, governance -3. **ECOSYSTEM.a2ml** — Position in ecosystem, relationships -4. **AGENTIC.a2ml** — AI agent interaction patterns -5. **NEUROSYM.a2ml** — Neurosymbolic integration config -6. **PLAYBOOK.a2ml** — Operational runbook - -### VeriSimDB: `verisimdb/` ONLY -- `schema/` — VQL schema definitions (repo, clade, todo, observation, feedback, lineage, forge-identity) -- `seed/` — Initial data (clades.a2ml, forges.a2ml) -- `queries/` — Pre-built VQL queries (dashboard, stale, orphans, drift, bot-findings, blocked, cross-clade-deps, feedback-status) -- `config.a2ml` — VeriSimDB instance configuration - -### Sync Tooling: `sync/` ONLY -- Ingest scripts (state, git metadata, bot findings) -- Export scripts (state push, Cloudflare KV sync) - -### Contractiles: `contractiles/` ONLY -- `must/clade-hygiene.a2ml` — Every repo MUST have CLADE.a2ml - -## CORE INVARIANTS - -1. **No state file duplication** — Root must NOT contain STATE.a2ml, META.a2ml, etc. -2. **Single source of truth** — `.machine_readable/` is authoritative for this repo's state -3. **VeriSimDB is the map, not the territory** — Editing VeriSimDB never modifies source repos -4. **Pointer authority** — Every cached value has a pointer declaring its canonical source -5. **License** — All code MPL-2.0 -6. **Author** — "Jonathan D.A. Jewell " - -## CLADE CODES (for reference) - -| Code | Clade | -|------|-------| -| fv | Formal Verification & Proofs | -| nl | Nextgen Languages | -| rm | Repo Management & Tooling | -| gv | Governance & Standards | -| db | Databases | -| ap | Applications | -| ix | Infrastructure & Cloud | -| dx | Developer Ecosystem | -| pt | Protocols & Interop | -| ax | AI & Neurosymbolic | -| gm | Games & Interactive | -| sc | Security | - -## SESSION STARTUP CHECKLIST - -- Read THIS file first -- Understand: this is the central registry, not a code project -- Never modify repo seed data without understanding the pointer authority model -- When adding repos, assign a primary clade from the 12 codes above diff --git a/0-AI-MANIFEST.deed b/0-AI-MANIFEST.deed new file mode 100644 index 0000000..d848c89 --- /dev/null +++ b/0-AI-MANIFEST.deed @@ -0,0 +1,17 @@ +;; SPDX-License-Identifier: MPL-2.0 +;; SPDX-FileCopyrightText: 2026 Jonathan D.A. Jewell (hyperpolymath) +;; +;; The machine front door of gv-clade-index (the chora-registry): pointer-only +;; (A7 ruling Q15). It names where to read and carries no facts of its own. +;; Repository facts are in gv-clade-index_chora.deed and +;; .machine_readable/descriptiles/STATE.deed; the registry itself is +;; verisim/seed/chora-registry_praxis.deed. It replaces 0-AI-MANIFEST.a2ml, +;; retired 2026-11-14 (docs/history/A2ML-REMOVED.adoc). +(repo-deed + :schema-version "1.0.0" + :canonical-name "gv-clade-index" + :repo-uuid #uuid"a65b74d8-351a-89d9-a38d-aea470863b03" + :beholding-chora #uuid"0889b37b-defb-831f-973c-e119500db00e" + (front-doors + :machine "gv-clade-index_chora.deed" + :human "README.adoc")) diff --git a/Justfile b/Justfile index fb775d2..6d39c57 100644 --- a/Justfile +++ b/Justfile @@ -52,7 +52,7 @@ info: @echo "Version: {{version}}" @echo "RSR Tier: {{tier}}" @echo "Recipes: $(just --summary | wc -w)" - @[ -f ".machine_readable/STATE.a2ml" ] && grep -oP 'phase\s*=\s*"\K[^"]+' .machine_readable/STATE.a2ml | head -1 | xargs -I{} echo "Phase: {}" || true + @[ -f ".machine_readable/descriptiles/STATE.deed" ] && grep -oP ':phase\s+\K[a-z]+' .machine_readable/descriptiles/STATE.deed | head -1 | xargs -I{} echo "Phase: {}" || true # ═══════════════════════════════════════════════════════════════════════════════ # INIT — Bootstrap a new project from this template @@ -226,16 +226,12 @@ init: fi done - # Also replace [YOUR-REPO-NAME] and [YOUR-NAME/ORG] in AI manifest - sed -i "s|\[YOUR-REPO-NAME\]|${PROJECT_NAME}|g" 0-AI-MANIFEST.a2ml 2>/dev/null || true - sed -i "s|\[YOUR-NAME/ORG\]|${OWNER}|g" 0-AI-MANIFEST.a2ml 2>/dev/null || true - echo "" echo "── Validation ───────────────────────────────────" # Check for remaining placeholders PATTERN="${LB}[A-Z_]*${RB}" - REMAINING=$(grep -rl "$PATTERN" . --include='*.md' --include='*.adoc' --include='*.yml' --include='*.yaml' --include='*.a2ml' --include='*.toml' --include='*.scm' --include='*.ncl' --include='*.nix' --include='*.json' --include='*.sh' 2>/dev/null | grep -v '.git/' | grep -v '.machine_readable/ai/PLACEHOLDERS.adoc' || true) + REMAINING=$(grep -rl "$PATTERN" . --include='*.md' --include='*.adoc' --include='*.yml' --include='*.yaml' --include='*.deed' --include='*.toml' --include='*.scm' --include='*.ncl' --include='*.nix' --include='*.json' --include='*.sh' 2>/dev/null | grep -v '.git/' | grep -v '.machine_readable/ai/PLACEHOLDERS.adoc' || true) if [ -n "$REMAINING" ]; then echo "WARNING: Remaining placeholders in:" echo "$REMAINING" | sed 's/^/ /' @@ -657,10 +653,11 @@ validate-rsr: #!/usr/bin/env bash echo "=== RSR Compliance Check ===" MISSING="" - for f in .editorconfig .gitignore Justfile README.adoc LICENSE 0-AI-MANIFEST.a2ml; do + for f in .editorconfig .gitignore Justfile README.adoc LICENSE 0-AI-MANIFEST.deed; do [ -f "$f" ] || MISSING="$MISSING $f" done - for f in .machine_readable/STATE.a2ml .machine_readable/META.a2ml .machine_readable/ECOSYSTEM.a2ml .machine_readable/anchors/ANCHOR.a2ml .machine_readable/policies/MAINTENANCE-AXES.a2ml .machine_readable/policies/MAINTENANCE-CHECKLIST.a2ml .machine_readable/policies/SOFTWARE-DEVELOPMENT-APPROACH.a2ml; do + # Repo metadata is deed, not A2ML (docs/history/A2ML-REMOVED.adoc). + for f in {{project}}_chora.deed .machine_readable/descriptiles/STATE.deed; do [ -f "$f" ] || MISSING="$MISSING $f" done for f in licensing/exhibits/EXHIBIT-A-ETHICAL-USE.txt licensing/exhibits/EXHIBIT-B-QUANTUM-SAFE.txt licensing/texts/MPL-2.0.txt; do @@ -672,34 +669,21 @@ validate-rsr: for f in docs/maintenance/MAINTENANCE-CHECKLIST.adoc docs/practice/SOFTWARE-DEVELOPMENT-APPROACH.adoc; do [ -f "$f" ] || MISSING="$MISSING $f" done - if [ -f ".machine_readable/META.a2ml" ]; then - grep -q 'axis-1 = "must > intend > like"' .machine_readable/META.a2ml || MISSING="$MISSING META.a2ml:axis-1" - grep -q 'axis-2 = "corrective > adaptive > perfective"' .machine_readable/META.a2ml || MISSING="$MISSING META.a2ml:axis-2" - grep -q 'axis-3 = "systems > compliance > effects"' .machine_readable/META.a2ml || MISSING="$MISSING META.a2ml:axis-3" - grep -q 'scoping-first = true' .machine_readable/META.a2ml || MISSING="$MISSING META.a2ml:scoping-first" - grep -q 'idris-unsound-scan = "believe_me/assert_total"' .machine_readable/META.a2ml || MISSING="$MISSING META.a2ml:idris-unsound-scan" - grep -q 'audit-focus = "systems in place, documentation explains actual state, safety/security accounted for, observed effects reviewed"' .machine_readable/META.a2ml || MISSING="$MISSING META.a2ml:audit-focus" - grep -q 'compliance-focus = "seams/compromises/exception register, bounded exceptions, anti-drift checks"' .machine_readable/META.a2ml || MISSING="$MISSING META.a2ml:compliance-focus" - grep -q 'effects-evidence = "benchmark execution/results and maintainer status dialogue/review"' .machine_readable/META.a2ml || MISSING="$MISSING META.a2ml:effects-evidence" - grep -q 'compliance-tooling = "panic-attack"' .machine_readable/policies/MAINTENANCE-AXES.a2ml || MISSING="$MISSING MAINTENANCE-AXES.a2ml:compliance-tooling" - grep -q 'effects-tooling = "ecological checking with sustainabot guidance"' .machine_readable/policies/MAINTENANCE-AXES.a2ml || MISSING="$MISSING MAINTENANCE-AXES.a2ml:effects-tooling" - grep -q 'source-human = "docs/maintenance/MAINTENANCE-CHECKLIST.adoc"' .machine_readable/policies/MAINTENANCE-CHECKLIST.a2ml || MISSING="$MISSING MAINTENANCE-CHECKLIST.a2ml:source-human" - grep -q 'source-human = "docs/practice/SOFTWARE-DEVELOPMENT-APPROACH.adoc"' .machine_readable/policies/SOFTWARE-DEVELOPMENT-APPROACH.a2ml || MISSING="$MISSING SOFTWARE-DEVELOPMENT-APPROACH.a2ml:source-human" - fi if [ -n "$MISSING" ]; then echo "MISSING:$MISSING" exit 1 fi echo "RSR compliance: PASS" -# Validate STATE.a2ml syntax +# Validate STATE.deed: a descriptile deed with one (status) clause validate-state: - @if [ -f ".machine_readable/STATE.a2ml" ]; then \ - grep -q '^\[metadata\]' .machine_readable/STATE.a2ml && \ - grep -q 'project\s*=' .machine_readable/STATE.a2ml && \ - echo "STATE.a2ml: valid" || echo "STATE.a2ml: INVALID (missing required sections)"; \ + @if [ -f ".machine_readable/descriptiles/STATE.deed" ]; then \ + grep -q '^(descriptile-deed' .machine_readable/descriptiles/STATE.deed && \ + grep -q '^ (status' .machine_readable/descriptiles/STATE.deed && \ + echo "STATE.deed: has its (status) clause (full check: standards deed_lint.js --state)" || \ + { echo "STATE.deed: INVALID (no descriptile-deed head or (status) clause)"; exit 1; }; \ else \ - echo "No .machine_readable/STATE.a2ml found"; \ + echo "No .machine_readable/descriptiles/STATE.deed found"; exit 1; \ fi # Validate AI installation guide completeness (finishbot pre-release check) @@ -774,16 +758,11 @@ validate: validate-rsr validate-state validate-ai-install # STATE MANAGEMENT # ═══════════════════════════════════════════════════════════════════════════════ -# Update STATE.a2ml timestamp -state-touch: - @if [ -f ".machine_readable/STATE.a2ml" ]; then \ - sed -i 's/last-updated = "[^"]*"/last-updated = "'"$(date +%Y-%m-%d)"'"/' .machine_readable/STATE.a2ml && \ - echo "STATE.a2ml timestamp updated"; \ - fi - -# Show current phase from STATE.a2ml +# Show the current lifecycle phase from STATE.deed. (The old state-touch recipe, +# which bumped a date in STATE.a2ml, is gone: STATE.deed's :affirmed date records +# a review, so it is changed by hand, never by a timestamp bump.) state-phase: - @grep -oP 'phase\s*=\s*"\K[^"]+' .machine_readable/STATE.a2ml 2>/dev/null | head -1 || echo "unknown" + @grep -oP ':phase\s+\K[a-z]+' .machine_readable/descriptiles/STATE.deed 2>/dev/null | head -1 || echo "unknown" # ═══════════════════════════════════════════════════════════════════════════════ # GUIX & NIX @@ -809,7 +788,7 @@ nix-shell: automate task="all": #!/usr/bin/env bash case "{{task}}" in - all) just fmt && just lint && just test && just docs && just state-touch ;; + all) just fmt && just lint && just test && just docs ;; cleanup) just clean && find . -name "*.orig" -delete && find . -name "*~" -delete ;; update) just deps && just validate ;; *) echo "Unknown: {{task}}. Use: all, cleanup, update" && exit 1 ;; diff --git a/QUICKSTART-DEV.adoc b/QUICKSTART-DEV.adoc index fd8066f..4b0e0fa 100644 --- a/QUICKSTART-DEV.adoc +++ b/QUICKSTART-DEV.adoc @@ -7,7 +7,7 @@ == Tech Stack -JavaScript (Cloudflare Worker) + A2ML/VQL data + bash tooling +JavaScript (Cloudflare Worker) + deed/VQL data + bash tooling == Set Up Development Environment @@ -58,11 +58,11 @@ gv-clade-index/ ├── ffi/zig/ # Zig FFI bridge (if applicable) ├── tests/ # Test suite ├── docs/ # Documentation -├── .machine_readable/ # Checkpoint files (STATE, META, ECOSYSTEM) +├── .machine_readable/ # descriptiles/STATE.deed, contractiles ├── Justfile # Task runner recipes ├── guix.scm # Guix environment ├── flake.nix # Nix environment (fallback) -└── 0-AI-MANIFEST.a2ml # AI agent entry point +└── 0-AI-MANIFEST.deed # AI agent entry point (pointer-only) ---- == Key Recipes @@ -102,7 +102,7 @@ If using an AI assistant, load the warmup context first: just llm-context # Outputs role-appropriate context ---- -Or read `0-AI-MANIFEST.a2ml` and `.claude/CLAUDE.md` directly. +Or read `0-AI-MANIFEST.deed` and `gv-clade-index_chora.deed` directly. == Get Help diff --git a/QUICKSTART-USER.adoc b/QUICKSTART-USER.adoc index d999589..392bcb8 100644 --- a/QUICKSTART-USER.adoc +++ b/QUICKSTART-USER.adoc @@ -14,7 +14,7 @@ locally. (For local development, see link:QUICKSTART-DEV.adoc[QUICKSTART-DEV].) ==== *Alpha / in development (~18%).* The public HTTP API is Phase 3 and is *not yet deployed* — it needs a Cloudflare token and a live VeriSimDB instance (see -`.machine_readable/6a2/STATE.a2ml`). Until then, browse the registry data and +`ROADMAP.adoc`). Until then, browse the registry data and docs directly in this repository. ==== @@ -23,7 +23,8 @@ docs directly in this repository. * Browse the taxonomy and architecture: link:README.adoc[README] * Inspect the registry data: `verisim/seed/` (clades, repos, forges) and the pre-built queries in `verisim/queries/` -* See how a repo is classified: its `.machine_readable/CLADE.a2ml` +* See how a repo is classified: its `(clade …)` placement in + `verisim/seed/chora-registry_praxis.deed` (and in the repo's own chora deed) == Use it later (the API) diff --git a/README.adoc b/README.adoc index 8a838f3..14bc635 100644 --- a/README.adoc +++ b/README.adoc @@ -48,8 +48,9 @@ implementations .... gv-clade-index/ -├── 0-AI-MANIFEST.a2ml # AI agent entry point -├── .machine_readable/ # State, meta, ecosystem, clade declaration +├── 0-AI-MANIFEST.deed # AI agent entry point (pointer-only) +├── gv-clade-index_chora.deed # This repo's deed: identity, clade, agentic, ... +├── .machine_readable/ # descriptiles/STATE.deed (status), contractiles ├── verisim/ │ ├── config.a2ml # VeriSimDB instance config │ ├── schema/ # VCL schemas (7 entity types) @@ -74,12 +75,13 @@ gv-clade-index/ │ ├── cross-clade-deps.vcl # Cross-boundary dependencies │ └── feedback-status.vcl # Feedback resolution tracking ├── sync/ # Sync tooling (Phase 2) -├── views/ # Generated outputs (not committed) -└── contractiles/ - └── must/ - └── clade-hygiene.a2ml # Every repo MUST have CLADE.a2ml +└── views/ # Generated outputs (not committed) .... +The three `.a2ml` files left under `verisim/` are registry data that wait for +their own mapping specs. Every other `.a2ml` file was retired on 2026-11-14 +(`docs/history/A2ML-REMOVED.adoc`). + == Portal Architecture .... @@ -117,13 +119,13 @@ drift-detects) * `+local+` — VeriSimDB owns it (TODOs, bot observations) * `+derived+` — computed from other values (clade health scores) -== Contractile System - -This repo includes a `+clade-hygiene.a2ml+` contractile: +== Clade placements -* *CLADE-001*: Every repo must have `+.machine_readable/CLADE.a2ml+` -* *CLADE-002*: CLADE.a2ml must declare a primary clade code -* *CLADE-003*: Primary clade code must be one of the 12 valid codes +A repo's clade placement is an identity fact in its own chora deed +(`_chora.deed`, the `(clade …)` clause), checked against this +registry's scheme `clade-12`, which is authoritative (owner ruling W10). The +old `+clade-hygiene.a2ml+` contractile, which required every repo to carry a +`+CLADE.a2ml+`, was retired with A2ML (`docs/history/A2ML-REMOVED.adoc`). == Implementation Phases @@ -153,8 +155,8 @@ This repo includes a `+clade-hygiene.a2ml+` contractile: Rollout operations — timelines, dependencies, ownership and go/no-go gates for each phase — live in `docs/governance/RELEASE-RUNBOOK.adoc`; this table is the summary, the -runbook is the procedure, `.machine_readable/6a2/STATE.a2ml` -`[route-to-mvp]` is the machine-readable status. +runbook is the procedure, and `ROADMAP.adoc` tracks progress. The +lifecycle status is `.machine_readable/descriptiles/STATE.deed`. == License diff --git a/ROADMAP.adoc b/ROADMAP.adoc index a73e073..6b02a9b 100644 --- a/ROADMAP.adoc +++ b/ROADMAP.adoc @@ -1,7 +1,7 @@ // SPDX-License-Identifier: CC-BY-SA-4.0 = gv-clade-index Roadmap -Mirrors the canonical phase plan in `.machine_readable/6a2/STATE.a2ml`. The registry +The phase plan (it mirrored `STATE.a2ml` until A2ML was retired). The registry is the *map* of the hyperpolymath ecosystem; "production" means a hardened, observable, CI-deployed Cloudflare Worker API backed by a live VeriSimDB. @@ -42,4 +42,4 @@ CI-deployed Cloudflare Worker API backed by a live VeriSimDB. * VeriSimDB instance on a VPS — the declared source of truth (Phase 2). * GitHub OAuth app + JWT signing key — Phases 6–7. -See `.machine_readable/6a2/STATE.a2ml` for live status and blockers. +The lifecycle status is `.machine_readable/descriptiles/STATE.deed`. diff --git a/container/0.1-AI-MANIFEST.a2ml b/container/0.1-AI-MANIFEST.a2ml deleted file mode 100644 index ccb5bc5..0000000 --- a/container/0.1-AI-MANIFEST.a2ml +++ /dev/null @@ -1,143 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 ---- -### [META] -id: "container-templates" -version: "1.0.0" -context: - - "https://a2ml.org/ns/v2" - - "https://stapeln.dev/ns/v1" - ---- -### [AI_MANIFEST] -description: | - Container templates for the stapeln container ecosystem. This directory - provides Podman-Chainguard-stapeln templates that are customised via - `just container-init` or `just init` during project bootstrap. - - All files use {{PLACEHOLDER}} tokens that are substituted with project- - specific values during initialisation. - -purpose: | - Provide a complete, security-first container deployment story for any - RSR-compliant repository. The templates cover the full lifecycle: - build, sign, verify, deploy, monitor, and govern. - -canonical_locations: - compose: "container/compose.toml" - containerfile: "container/Containerfile" - manifest: "container/manifest.toml" - gatekeeper: "container/.gatekeeper.yaml" - build_pipeline: "container/ct-build.sh" - entrypoint: "container/entrypoint.sh" - monitoring: "container/vordr.toml" - deployment: "container/deploy.k9.ncl" - example: "container/compose.example.toml" - ---- -### [FILE_RELATIONSHIPS] -files: - - name: "compose.toml" - role: "Orchestration" - description: | - selur-compose stack definition. Declares services, volumes, networks, - and health checks. References the Containerfile for image builds and - .gatekeeper.yaml for svalinn policy. - depends_on: ["Containerfile", ".gatekeeper.yaml"] - - - name: "Containerfile" - role: "Image Build" - description: | - Multi-stage OCI container build. Stage 1 compiles the application on - wolfi-base; Stage 2 copies the binary into a minimal runtime image. - Copies entrypoint.sh, .gatekeeper.yaml, and manifest.toml into the - final image. - depends_on: ["entrypoint.sh", ".gatekeeper.yaml", "manifest.toml"] - - - name: "manifest.toml" - role: "Bundle Metadata" - description: | - Cerro-torre .ctp bundle manifest. Describes provenance, dependencies, - attestations, and runtime security profile. Used by `ct pack` and - `ct verify`. - depends_on: [] - - - name: ".gatekeeper.yaml" - role: "Gateway Policy" - description: | - Svalinn edge gateway policy. Controls authentication, rate limiting, - container trust, request validation, CORS, and audit logging. - depends_on: [] - - - name: "ct-build.sh" - role: "Build Pipeline" - description: | - Shell script implementing the 5-stage pipeline: build (Podman), - pack (cerro-torre .ctp), sign (Ed25519), verify, push (optional). - Degrades gracefully when cerro-torre tools are not installed. - depends_on: ["Containerfile", "manifest.toml"] - - - name: "entrypoint.sh" - role: "Container Entrypoint" - description: | - Startup script with signal handling (SIGTERM, SIGINT), logging, and - exec into the main application process. - depends_on: [] - - - name: "vordr.toml" - role: "Runtime Monitoring" - description: | - Vordr monitoring configuration. Health endpoint probing, crash - detection, resource thresholds, and structured log output. - depends_on: [] - - - name: "deploy.k9.ncl" - role: "Deployment Component" - description: | - k9-svc deployment specification at Hunt trust level. Full pedigree - (L1-L5), environment configs, container config, and rolling - deployment strategy. - depends_on: ["compose.toml", "ct-build.sh"] - - - name: "compose.example.toml" - role: "Example" - description: | - Fully-commented multi-service example (Rust API + Elixir worker + - svalinn gateway). Copy to compose.toml and customise. - depends_on: [] - ---- -### [STAPELN_ECOSYSTEM] -overview: | - The stapeln container ecosystem comprises six tools: - - selur — Container orchestration with zero-copy IPC. Reads compose.toml. - cerro-torre — Verified container packaging (.ctp bundles), Ed25519 signing. - svalinn — Policy-driven edge gateway (auth, rate limits, CORS, trust). - vordr — Runtime monitoring (health, crashes, resources, logs). - rokur — Secrets management (runtime injection, no baked secrets). - k9-svc — Nickel deployment components (Kennel/Yard/Hunt trust levels). - -invariants: - - "Base images MUST be cgr.dev/chainguard/wolfi-base or cgr.dev/chainguard/static" - - "Container runtime is Podman — never Docker" - - "Containerfile — never Dockerfile" - - "All images run as non-root (appuser or project-specific user)" - - ".ctp bundles are signed with Ed25519 via cerro-torre" - - "Health endpoints (/health, /ready) must always be public (no auth)" - ---- -### [USAGE] -initialisation: | - Run `just container-init` to substitute all {{PLACEHOLDER}} tokens with - project-specific values. This is also run as part of `just init`. - -development: | - 1. `just container-build` — Build the container image - 2. `just container-verify` — Verify compose configuration - 3. `just container-up` — Start the stack locally - 4. `just container-down` — Stop the stack - -production: | - 1. `just container-sign` — Build, sign, verify .ctp bundle - 2. `just container-push` — Push signed bundle to registry - 3. `selur-compose up` — Deploy on target host diff --git a/container/README.adoc b/container/README.adoc index 9f7f7f0..f10b115 100644 --- a/container/README.adoc +++ b/container/README.adoc @@ -64,9 +64,6 @@ All files use `{{PLACEHOLDER}}` tokens that are replaced by `just container-init (L1--L5), environment configs (dev/staging/prod), container configuration, and rolling deployment strategy. -| `0-AI-MANIFEST.a2ml` -| AI-readable manifest describing the container directory, file - interconnections, and the stapeln ecosystem. |=== == The stapeln Ecosystem diff --git a/contractile.just b/contractile.just index 9a5827b..4172a03 100644 --- a/contractile.just +++ b/contractile.just @@ -2,6 +2,11 @@ # Source directory: contractiles # Re-generate with: contractile gen-just --dir contractiles # +# The `# Source:` files named below were legacy .a2ml contractiles, retired +# 2026-11-14 with no mapping spec to translate them (docs/history/A2ML-REMOVED.adoc). +# The recipes stand as generated until the edicts (file.deed, A7 8.1) exist; +# do not regenerate from the retired files. +# # SPDX-License-Identifier: MPL-2.0 # === DUST (Recovery & Rollback) === diff --git a/contractiles/must/clade-hygiene.a2ml b/contractiles/must/clade-hygiene.a2ml deleted file mode 100644 index 1e040ff..0000000 --- a/contractiles/must/clade-hygiene.a2ml +++ /dev/null @@ -1,86 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 -# Mustfile: clade hygiene — every repo MUST have a CLADE.a2ml - -[must] -id = "CLADE-001" -name = "clade-declaration" -description = "Every hyperpolymath repo must have .machine_readable/CLADE.a2ml" -severity = "BLOCK" -scope = "pre-commit" - -[must.check] -command = "test -f .machine_readable/CLADE.a2ml" -message = "Missing .machine_readable/CLADE.a2ml — run 'contractile init-clade' to generate" - -[must] -id = "CLADE-002" -name = "clade-primary-set" -description = "CLADE.a2ml must declare a primary clade code" -severity = "BLOCK" -scope = "pre-commit" - -[must.check] -command = "grep -q 'primary = ' .machine_readable/CLADE.a2ml" -message = "CLADE.a2ml missing primary clade assignment" - -[must] -id = "CLADE-003" -name = "clade-code-valid" -description = "Primary clade code must be one of the 12 defined codes" -severity = "BLOCK" -scope = "pre-commit" - -[must.check] -command = "grep 'primary = ' .machine_readable/CLADE.a2ml | grep -qE '\"(fv|nl|rm|gv|db|ap|ix|dx|pt|ax|gm|sc)\"'" -message = "CLADE.a2ml primary clade code not in valid set: fv nl rm gv db ap ix dx pt ax gm sc" - -[must] -id = "CLADE-006" -name = "clade-name-matches-code" -description = "primary-name must be the taxonomy's name for the declared primary code" -severity = "BLOCK" -scope = "pre-commit" - -# WHY THIS EXISTS. -# -# CLADE-003 checks the code is one of the 12. It cannot check the AUTHOR MEANT -# that clade — every code is valid whatever you thought it stood for. So these -# passed every gate: -# -# paint-type primary = "pt" believing "PainT-type" -# -- pt is Protocols & Interop; paint-type is an image editor -# gossamer primary = "gv" believing "Graphical/Visual" -# -- gv is GoVernance & Standards; there is no graphical clade -# -# The two letters abbreviate the CLADE's name, never the REPO's name. Requiring -# the name alongside the code makes the mistaken belief WRITABLE, and therefore -# CHECKABLE: primary = "pt" + primary-name = "PainT-type" now fails here, -# instead of being filed silently under Protocols & Interop. -# -# The pairs below are the authority in verisim/seed/clades.a2ml. Keep in sync. - -[must.check] -command = '''p=$(sed -n 's/^primary = "\(.*\)".*/\1/p' .machine_readable/CLADE.a2ml | head -1); n=$(sed -n 's/^primary-name = "\(.*\)".*/\1/p' .machine_readable/CLADE.a2ml | head -1); case "$p|$n" in 'fv|Formal Verification & Proofs'|'nl|Nextgen Languages'|'rm|Repo Management & Tooling'|'gv|Governance & Standards'|'db|Databases'|'ap|Applications'|'ix|Infrastructure & Cloud'|'dx|Developer Ecosystem'|'pt|Protocols & Interop'|'ax|AI & Neurosymbolic'|'gm|Games & Interactive'|'sc|Security') exit 0 ;; *) exit 1 ;; esac''' -message = "CLADE.a2ml primary-name does not match primary code. The 2 letters abbreviate the CLADE's name, not the repo's. Valid pairs: fv=Formal Verification & Proofs, nl=Nextgen Languages, rm=Repo Management & Tooling, gv=Governance & Standards, db=Databases, ap=Applications, ix=Infrastructure & Cloud, dx=Developer Ecosystem, pt=Protocols & Interop, ax=AI & Neurosymbolic, gm=Games & Interactive, sc=Security" - -[must] -id = "CLADE-004" -name = "clade-status-phase-set" -description = "CLADE.a2ml must declare a lifecycle status phase" -severity = "BLOCK" -scope = "pre-commit" - -[must.check] -command = "grep -qE '^phase = ' .machine_readable/CLADE.a2ml" -message = "CLADE.a2ml missing [status] phase — run 'contractile backfill-status' (default: active)" - -[must] -id = "CLADE-005" -name = "clade-status-phase-valid" -description = "Status phase must be one of the 8 lifecycle phases" -severity = "BLOCK" -scope = "pre-commit" - -[must.check] -command = "grep -E '^phase = ' .machine_readable/CLADE.a2ml | head -1 | grep -qE '\"(reserved|incubating|active|dormant|merged|superseded|archived|extinct)\"'" -message = "CLADE.a2ml status phase not in valid set: reserved incubating active dormant merged superseded archived extinct" diff --git a/docs/0.1-AI-MANIFEST.a2ml b/docs/0.1-AI-MANIFEST.a2ml deleted file mode 100644 index 7f79301..0000000 --- a/docs/0.1-AI-MANIFEST.a2ml +++ /dev/null @@ -1,33 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 ---- -### [META] -id: "docs-pillar" -level: 1 -parent: "../0-AI-MANIFEST.a2ml" - ---- -### [AI_MANIFEST] -description: | - Technical documentation hub. The root contains high-level orientation - (README, Quickstart, State-Visualizer). Specialized tracks live in - subdirectories. - -canonical_locations: - quickstart: "QUICKSTART.adoc" - state_visualizer: "STATE-VISUALIZER.adoc" - governance: "governance/" - architecture: "architecture/" - decisions: "decisions/" - theory: "theory/" - practice: "practice/" - developer: "developer/" - attribution: "attribution/" - reports: "reports/" - whitepapers: "whitepapers/" - standards: "standards/" - legal: "legal/" - wikis: "wikis/" - -invariants: - - "Primary documentation format MUST be AsciiDoc (.adoc)" - - "Root docs/ MUST only contain pillar entry points" diff --git a/docs/USER-API-GUIDE.adoc b/docs/USER-API-GUIDE.adoc index 031495b..7bb204f 100644 --- a/docs/USER-API-GUIDE.adoc +++ b/docs/USER-API-GUIDE.adoc @@ -7,7 +7,7 @@ ==== *Status: alpha.* The HTTP API is Phase 3 (~60% built) and is *not yet publicly deployed* (blocked on a `CLOUDFLARE_API_TOKEN` secret and a VeriSimDB instance -— see `.machine_readable/6a2/STATE.a2ml`). The endpoints below are +— see `ROADMAP.adoc`). The endpoints below are *implemented and contract-bound*, but the production URL does not answer yet; locally you can run `wrangler dev` in `worker/`. ==== diff --git a/docs/api/openapi.yaml b/docs/api/openapi.yaml index 3497cd4..a5c5a1d 100644 --- a/docs/api/openapi.yaml +++ b/docs/api/openapi.yaml @@ -15,7 +15,7 @@ # marked `x-enforced: false`; endpoints that will consume them say so. # * The API is not yet publicly deployed (Phase 3, blocked on # CLOUDFLARE_API_TOKEN + a VeriSimDB instance — see -# .machine_readable/6a2/STATE.a2ml and docs/governance/RELEASE-RUNBOOK.adoc). +# ROADMAP.adoc and docs/governance/RELEASE-RUNBOOK.adoc). # ---------------------------------------------------------------------------- openapi: 3.1.0 diff --git a/docs/architecture/0.2-AI-MANIFEST.a2ml b/docs/architecture/0.2-AI-MANIFEST.a2ml deleted file mode 100644 index 028b503..0000000 --- a/docs/architecture/0.2-AI-MANIFEST.a2ml +++ /dev/null @@ -1,17 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 ---- -### [META] -id: "architecture-track" -level: 2 -parent: "../0.1-AI-MANIFEST.a2ml" - ---- -### [AI_MANIFEST] -description: | - Documentation track for system architecture and threat models. - -canonical_locations: - threat_model: "THREAT-MODEL.adoc" - -invariants: - - "Visual diagrams MUST include ASCII or Mermaid representations" diff --git a/docs/attribution/0.2-AI-MANIFEST.a2ml b/docs/attribution/0.2-AI-MANIFEST.a2ml deleted file mode 100644 index 52beaea..0000000 --- a/docs/attribution/0.2-AI-MANIFEST.a2ml +++ /dev/null @@ -1,11 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 ---- -### [META] -id: "attribution-unit" -level: 2 -parent: "../0.1-AI-MANIFEST.a2ml" - ---- -### [AI_MANIFEST] -description: | - Sub-unit of the docs pillar focusing on attribution. diff --git a/docs/decisions/0.2-AI-MANIFEST.a2ml b/docs/decisions/0.2-AI-MANIFEST.a2ml deleted file mode 100644 index ac26298..0000000 --- a/docs/decisions/0.2-AI-MANIFEST.a2ml +++ /dev/null @@ -1,11 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 ---- -### [META] -id: "decisions-unit" -level: 2 -parent: "../0.1-AI-MANIFEST.a2ml" - ---- -### [AI_MANIFEST] -description: | - Sub-unit of the docs pillar focusing on decisions. diff --git a/docs/developer/0.2-AI-MANIFEST.a2ml b/docs/developer/0.2-AI-MANIFEST.a2ml deleted file mode 100644 index c16fcc7..0000000 --- a/docs/developer/0.2-AI-MANIFEST.a2ml +++ /dev/null @@ -1,11 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 ---- -### [META] -id: "developer-unit" -level: 2 -parent: "../0.1-AI-MANIFEST.a2ml" - ---- -### [AI_MANIFEST] -description: | - Sub-unit of the docs pillar focusing on developer. diff --git a/docs/developer/VERISIM-QUERY-GUIDE.adoc b/docs/developer/VERISIM-QUERY-GUIDE.adoc index aae89d2..220df8b 100644 --- a/docs/developer/VERISIM-QUERY-GUIDE.adoc +++ b/docs/developer/VERISIM-QUERY-GUIDE.adoc @@ -26,7 +26,7 @@ Developers extending the registry, or building dashboards / drift detection. . *The entity model* — how a repository is represented (`verisim/schema/repo.vcl`) and the seven entity types: repo, clade, todo, observation, feedback, lineage, forge-identity. -. *Reading the seed data* — `verisim/seed/{clades,repos,forges}.a2ml`. +. *Reading the seed data* — `verisim/seed/chora-registry_praxis.deed` (the repos), `clades.a2ml` and `forges.a2ml`. . *Basic queries* — filter repos by clade / language / status; walk through `dashboard.vcl`, `stale.vcl`, `orphans.vcl`. . *Pointer authority in practice* — `pointer` vs `local` vs `derived`, and how diff --git a/docs/governance/0.1-AI-MANIFEST.a2ml b/docs/governance/0.1-AI-MANIFEST.a2ml deleted file mode 100644 index 6e373bd..0000000 --- a/docs/governance/0.1-AI-MANIFEST.a2ml +++ /dev/null @@ -1,21 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 ---- -### [META] -id: "governance-pillar" -level: 1 -parent: "../0-AI-MANIFEST.a2ml" - ---- -### [AI_MANIFEST] -description: | - Primary governance pillar implementing the Triaxial Software Development - Methodology (TSDM). Contains planning, maintenance, and audit tracks. - -canonical_locations: - tsdm_spec: "TSDM.adoc" - planning: "planning/" - maintenance: "maintenance/" - audit: "audit/" - crg: "CRG-CRITERIA.adoc" - checklist: "MAINTENANCE-CHECKLIST.adoc" - approach: "SOFTWARE-DEVELOPMENT-APPROACH.adoc" diff --git a/docs/governance/CRG-CRITERIA.a2ml b/docs/governance/CRG-CRITERIA.a2ml deleted file mode 100644 index 6162585..0000000 --- a/docs/governance/CRG-CRITERIA.a2ml +++ /dev/null @@ -1,108 +0,0 @@ -; SPDX-License-Identifier: MPL-2.0 -; Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) - -; Component Readiness Grades (CRG) — Machine-readable specification -; Format: A2ML (AI-to-Machine Language) -; Standard: CRG v1.0 - -(standard - (name "Component Readiness Grades") - (abbreviation "CRG") - (version "1.0") - (date "2026-02-28") - (author "Jonathan D.A. Jewell ") - (license "MPL-2.0") - (family "RSR")) - -(grades - (grade - (code X) - (name "Untested") - (release-stage #f) - (ordinal 0) - (description "No testing has been performed. Status unknown.") - (evidence-required "none") - (minimum-for #f)) - (grade - (code F) - (name "Harmful / Wasteful") - (release-stage #f) - (ordinal 1) - (description "Actively harmful, wasteful, or better handled externally. Reject, deprecate, or delegate.") - (evidence-required "documented test results showing harm, waste, or redundancy; comparison with alternatives") - (minimum-for #f)) - (grade - (code E) - (name "Minimal / Salvageable") - (release-stage "pre-alpha") - (ordinal 2) - (description "Does something slight. Barely functional. Needs redesign or major work.") - (evidence-required "at least one successful test case; documented failures and limitations") - (minimum-for #f)) - (grade - (code D) - (name "Partial / Inconsistent") - (release-stage "alpha") - (ordinal 3) - (description "Works on some things but not systematically.") - (evidence-required "matrix of tested scenarios; documented scope vs actual capabilities") - (minimum-for "alpha")) - (grade - (code C) - (name "Self-Validated") - (release-stage "beta") - (ordinal 4) - (description "Tested on the tool/project itself (dogfooding). Reliable in home context.") - (evidence-required "active dogfooding; CI integration or equivalent; no known failures in home context") - (minimum-for "beta")) - (grade - (code B) - (name "Broadly Validated") - (release-stage "release-candidate") - (ordinal 5) - (description "Tested on at least 6 disparate, unrelated targets.") - (evidence-required "list of 6+ diverse targets with test results; evidence of feedback incorporation") - (minimum-for "release-candidate")) - (grade - (code A) - (name "Field-Proven") - (release-stage "stable") - (ordinal 6) - (description "Real-world external feedback confirms value. Does no harm in the wild.") - (evidence-required "real-world usage data; feedback incorporation evidence; no unresolved harm reports") - (minimum-for "stable"))) - -(transitions - (promotion - (from X) (to E) (requirement "Run at least one test. Document results.")) - (promotion - (from X) (to F) (requirement "Evaluate and determine harmful or wasteful.")) - (promotion - (from E) (to D) (requirement "Fix critical failures. Document scope.")) - (promotion - (from D) (to C) (requirement "Dogfood on own project. Fix what breaks.")) - (promotion - (from C) (to B) (requirement "Test on 6+ diverse external targets. Fix what breaks.")) - (promotion - (from B) (to A) (requirement "Ship. Collect external feedback. Demonstrate no harm.")) - (demotion - (from A) (to B) (trigger "External feedback dries up or reveals no longer useful.")) - (demotion - (from A) (to F) (trigger "External feedback reveals component causes harm.")) - (demotion - (from B) (to C) (trigger "Broad validation reveals unfixed failures.")) - (demotion - (from C) (to D) (trigger "Home context changes and component no longer reliable.")) - (demotion - (from C) (to F) (trigger "Dogfooding reveals net negative.")) - (demotion - (from D) (to E) (trigger "Scope narrows to barely functional.")) - (demotion - (from any) (to F) (trigger "Better external alternative makes this pure opportunity cost."))) - -(conformance - (rule "Each assessable component MUST have a grade from {X, F, E, D, C, B, A}.") - (rule "Each grade above X MUST be supported by evidence per section 4.") - (rule "Assessments MUST be recorded in a version-controlled location.") - (rule "Assessments MUST be reviewed at least once per release cycle.") - (rule "Release stages MUST respect minimum grade thresholds.")) diff --git a/docs/governance/MAINTENANCE-CHECKLIST.a2ml b/docs/governance/MAINTENANCE-CHECKLIST.a2ml deleted file mode 100644 index f46eece..0000000 --- a/docs/governance/MAINTENANCE-CHECKLIST.a2ml +++ /dev/null @@ -1,160 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 -# Cross-repo maintenance baseline (machine-readable canonical) - -[metadata] -name = "maintenance-checklist" -version = "1.1.0" -last-updated = "2026-02-24" -scope = "cross-repo" -source-human = "docs/maintenance/MAINTENANCE-CHECKLIST.adoc" -companion-human = "docs/practice/SOFTWARE-DEVELOPMENT-APPROACH.adoc" -companion-machine = ".machine_readable/policies/SOFTWARE-DEVELOPMENT-APPROACH.a2ml" - -[policy] -single-source = true -notes = "Use this file as canonical machine policy and keep markdown synchronized." - -[maintenance-axes] -scoping-first = true -execution-order = ["scoping", "axis-1", "axis-2", "axis-3"] -axis-1 = "must > intend > like" -axis-2 = "corrective > adaptive > perfective" -axis-3 = "systems > compliance > effects" - -[scoping] -inputs_required = [ - "README", - "roadmap", - "status-docs", - "maintenance-checklist", - "ci-and-security-docs", -] - -marker_scan_required = [ - "TODO", - "FIXME", - "XXX", - "HACK", - "STUB", - "PARTIAL", -] - -idris_unsound_scan_required = [ - "believe_me", - "assert_total", -] - -scope_assembly_buckets = ["must", "intend", "like"] - -[axis-2-maintenance-rules] -corrective-first = true -adaptive-second = true -adaptive_examples = [ - "scope-change reconciliation", - "stale-reference removal", - "obsolete-work culling", -] -perfective-third = true -perfective_source = "axis-1 honest state after corrective/adaptive updates" - -[axis-3-audit-rules] -systems-check = true -documentation-honesty-check = true -safety-security-accounted-check = true -effects-review-check = true -benchmark-evidence-required = true -maintainer-dialogue-review-required = true -compliance-seams-check = true -exception-register-required = true -exception-bounded-scope-required = true -policy-drift-contamination-check = true -example-drift-risk = "single TypeScript exception causing broad ReScript->TypeScript migration" -compliance-tooling = "panic-attack" -effects-tooling = "ecological checking with sustainabot guidance" - -[generic-cleanup-finish-off] -root-cleanup-required = true -stale-work-cull-required = true -docs-parity-required = true -machine-human-sync-required = true -compliance-finish-off-required = true -effects-finish-off-required = true -release-prep-summary-required = true -next-actions-required = ["corrective", "adaptive", "perfective"] - -[must] -root_control_files = [ - ".gitignore", - ".gitattributes", - ".editorconfig", - ".tool-versions", - "Containerfile", - "Justfile", -] - -root_hosting_files = [ - "CNAME", - ".nojekyll", -] - -ownership_files = [ - "MAINTAINER", - ".github/CODEOWNERS", -] - -machine_readable_required = [ - ".machine_readable/anchors/ANCHOR.a2ml", - ".machine_readable/contractiles/", - ".machine_readable/ai/", - ".machine_readable/bot_directives/", -] - -contractiles_required = [ - "Mustfile", - "Trustfile", - "Intentfile", -] - -security_required = [ - ".well-known/security.txt", - "ci-security-scan", -] - -quality_gate_required = [ - "format", - "lint", - "unit-tests", - "integration-tests", - "p2p-tests", - "e2e-tests", - "bench-smoke", - "docs-check", - "security-scan", -] - -abi_ffi_policy = [ - "ABI Idris2 in src/interface/abi/*.idr", - "FFI Zig in ffi/**/*.zig", -] - -[should] -docs_primary_format = "adoc" -docs_structure = [ - "docs/theory", - "docs/practice", - "docs/whitepapers/academic", - "docs/whitepapers/industry", - "docs/proofs", - "docs/reports", -] - -root_minimization = true -well_known_metadata = true -roadmap_honesty_with_dates = true -ci_doc_format_policy = true - -[could] -generate_human_from_machine = true -mode_aware_bots = ["corrective", "adaptive", "perfective", "audit"] -topology_dashboard = true -exception_registry = true diff --git a/docs/governance/MAINTENANCE-CHECKLIST.adoc b/docs/governance/MAINTENANCE-CHECKLIST.adoc index f4b082b..b4d77ae 100644 --- a/docs/governance/MAINTENANCE-CHECKLIST.adoc +++ b/docs/governance/MAINTENANCE-CHECKLIST.adoc @@ -6,7 +6,6 @@ Use this as a repeatable maintenance runbook for any repo. Companion policy: - `docs/practice/SOFTWARE-DEVELOPMENT-APPROACH.adoc` (human-readable) -- `.machine_readable/policies/SOFTWARE-DEVELOPMENT-APPROACH.a2ml` (machine-readable) ## Canonical Repo Baseline (Final) diff --git a/docs/governance/RELEASE-RUNBOOK.adoc b/docs/governance/RELEASE-RUNBOOK.adoc index fa1fd68..e8ae182 100644 --- a/docs/governance/RELEASE-RUNBOOK.adoc +++ b/docs/governance/RELEASE-RUNBOOK.adoc @@ -7,9 +7,9 @@ ==== *Status: ACTIVE.* This is the operational runbook for the coordinated gv-clade-index rollout. It supersedes the README phase *table* for rollout -operations only — `.machine_readable/6a2/STATE.a2ml` `[route-to-mvp]` remains -the machine-readable status source of truth, and this runbook tells you when -and how to update it. Filed as #31. +operations only. `ROADMAP.adoc` tracks phase status (the A2ML `[route-to-mvp]` +it replaced was retired 2026-11-14), and this runbook tells you when and how +to update it. Filed as #31. ==== == Operating rules (all phases) diff --git a/docs/governance/SOFTWARE-DEVELOPMENT-APPROACH.a2ml b/docs/governance/SOFTWARE-DEVELOPMENT-APPROACH.a2ml deleted file mode 100644 index 093573a..0000000 --- a/docs/governance/SOFTWARE-DEVELOPMENT-APPROACH.a2ml +++ /dev/null @@ -1,53 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 -# General software development approach (machine-readable) - -[metadata] -version = "1.0.0" -last-updated = "2026-02-24" -scope = "cross-repo" -source-human = "docs/practice/SOFTWARE-DEVELOPMENT-APPROACH.adoc" - -[execution] -order = ["axis-1", "axis-2", "axis-3"] - -[axis-1] -name = "scope" -priority = "must > intend > like" -inputs = [ - "README", - "roadmap", - "status-docs", - "ci-and-security-docs", -] -marker-scan = ["TODO", "FIXME", "XXX", "HACK", "STUB", "PARTIAL"] -idris-unsound-scan = ["believe_me", "assert_total"] -output = "scoped-work-assembly" - -[axis-2] -name = "maintenance" -priority = "corrective > adaptive > perfective" -corrective = "defect/regression/safety/security fixes" -adaptive = "scope reconciliation, stale-reference removal, obsolete-work culling" -perfective = "quality improvements derived from axis-1 honest state" - -[axis-3] -name = "audit" -priority = "systems > compliance > effects" -systems = "required systems present and operating" -compliance = "exceptions explicit, bounded, and drift-resistant" -effects = "benchmark/operational impact evidence captured and reviewed" -compliance-tooling = "panic-attack" -effects-tooling = "ecological checking with sustainabot guidance" - -[cleanup-finish-off] -root-cleanup = true -stale-work-cull = true -docs-sync-human-machine = true -compliance-audit = true -effects-audit = true -release-summary = ["must", "should", "could"] -next-actions = ["corrective", "adaptive", "perfective"] - -[collaboration] -maintainer-dialogue-required = true -dialogue-topics = ["what changed", "why", "remaining risks"] diff --git a/docs/governance/TSDM.a2ml b/docs/governance/TSDM.a2ml deleted file mode 100644 index f27036c..0000000 --- a/docs/governance/TSDM.a2ml +++ /dev/null @@ -1,22 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 ---- -### [TSDM_SPEC] -id: "tsdm-standard" -version: "1.0.0" - -axes: - axis_1: - name: "Planning" - levels: ["must", "should", "could"] - axis_2: - name: "Maintenance" - levels: ["corrective", "adaptive", "perfective"] - axis_3: - name: "Audit" - levels: ["systems", "compliance", "effects"] - -invariants: - - "Every task MUST map to at least one TSDM coordinate" - - "Axis 1 priority governs resource allocation" - - "Axis 2 type governs commit categorisation" - - "Axis 3 focus governs audit depth" diff --git a/docs/governance/audit/0.2-AI-MANIFEST.a2ml b/docs/governance/audit/0.2-AI-MANIFEST.a2ml deleted file mode 100644 index 4722486..0000000 --- a/docs/governance/audit/0.2-AI-MANIFEST.a2ml +++ /dev/null @@ -1,11 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 ---- -### [META] -id: "governance-axis-audit" -level: 2 -parent: "../0.1-AI-MANIFEST.a2ml" - ---- -### [AI_MANIFEST] -description: | - TSDM Audit track. diff --git a/docs/governance/audit/README.adoc b/docs/governance/audit/README.adoc index 52a17fb..527d5a3 100644 --- a/docs/governance/audit/README.adoc +++ b/docs/governance/audit/README.adoc @@ -2,5 +2,5 @@ [NOTE] ==== -*Planned - not yet written.* RSR scaffold slot reserved for future content; intentionally empty for now. See `.machine_readable/6a2/STATE.a2ml` for roadmap status. +*Planned - not yet written.* RSR scaffold slot reserved for future content; intentionally empty for now. See `ROADMAP.adoc` for roadmap status. ==== diff --git a/docs/governance/audit/compliance/0.3-AI-MANIFEST.a2ml b/docs/governance/audit/compliance/0.3-AI-MANIFEST.a2ml deleted file mode 100644 index b13ec69..0000000 --- a/docs/governance/audit/compliance/0.3-AI-MANIFEST.a2ml +++ /dev/null @@ -1,11 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 ---- -### [META] -id: "governance-unit-compliance" -level: 3 -parent: "../0.2-AI-MANIFEST.a2ml" - ---- -### [AI_MANIFEST] -description: | - TSDM compliance unit within the Audit axis. diff --git a/docs/governance/audit/compliance/README.adoc b/docs/governance/audit/compliance/README.adoc index 40dee33..1a0bb2f 100644 --- a/docs/governance/audit/compliance/README.adoc +++ b/docs/governance/audit/compliance/README.adoc @@ -2,5 +2,5 @@ [NOTE] ==== -*Planned - not yet written.* RSR scaffold slot reserved for future content; intentionally empty for now. See `.machine_readable/6a2/STATE.a2ml` for roadmap status. +*Planned - not yet written.* RSR scaffold slot reserved for future content; intentionally empty for now. See `ROADMAP.adoc` for roadmap status. ==== diff --git a/docs/governance/audit/effects/0.3-AI-MANIFEST.a2ml b/docs/governance/audit/effects/0.3-AI-MANIFEST.a2ml deleted file mode 100644 index 0bccae0..0000000 --- a/docs/governance/audit/effects/0.3-AI-MANIFEST.a2ml +++ /dev/null @@ -1,11 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 ---- -### [META] -id: "governance-unit-effects" -level: 3 -parent: "../0.2-AI-MANIFEST.a2ml" - ---- -### [AI_MANIFEST] -description: | - TSDM effects unit within the Audit axis. diff --git a/docs/governance/audit/effects/README.adoc b/docs/governance/audit/effects/README.adoc index a687bee..35bfcea 100644 --- a/docs/governance/audit/effects/README.adoc +++ b/docs/governance/audit/effects/README.adoc @@ -2,5 +2,5 @@ [NOTE] ==== -*Planned - not yet written.* RSR scaffold slot reserved for future content; intentionally empty for now. See `.machine_readable/6a2/STATE.a2ml` for roadmap status. +*Planned - not yet written.* RSR scaffold slot reserved for future content; intentionally empty for now. See `ROADMAP.adoc` for roadmap status. ==== diff --git a/docs/governance/audit/systems/0.3-AI-MANIFEST.a2ml b/docs/governance/audit/systems/0.3-AI-MANIFEST.a2ml deleted file mode 100644 index f97bc9c..0000000 --- a/docs/governance/audit/systems/0.3-AI-MANIFEST.a2ml +++ /dev/null @@ -1,11 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 ---- -### [META] -id: "governance-unit-systems" -level: 3 -parent: "../0.2-AI-MANIFEST.a2ml" - ---- -### [AI_MANIFEST] -description: | - TSDM systems unit within the Audit axis. diff --git a/docs/governance/audit/systems/README.adoc b/docs/governance/audit/systems/README.adoc index e87b77a..b38de2b 100644 --- a/docs/governance/audit/systems/README.adoc +++ b/docs/governance/audit/systems/README.adoc @@ -2,5 +2,5 @@ [NOTE] ==== -*Planned - not yet written.* RSR scaffold slot reserved for future content; intentionally empty for now. See `.machine_readable/6a2/STATE.a2ml` for roadmap status. +*Planned - not yet written.* RSR scaffold slot reserved for future content; intentionally empty for now. See `ROADMAP.adoc` for roadmap status. ==== diff --git a/docs/governance/maintenance/0.2-AI-MANIFEST.a2ml b/docs/governance/maintenance/0.2-AI-MANIFEST.a2ml deleted file mode 100644 index 8e0dff5..0000000 --- a/docs/governance/maintenance/0.2-AI-MANIFEST.a2ml +++ /dev/null @@ -1,11 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 ---- -### [META] -id: "governance-axis-maintenance" -level: 2 -parent: "../0.1-AI-MANIFEST.a2ml" - ---- -### [AI_MANIFEST] -description: | - TSDM Maintenance track. diff --git a/docs/governance/maintenance/README.adoc b/docs/governance/maintenance/README.adoc index 49b8380..67ba3a3 100644 --- a/docs/governance/maintenance/README.adoc +++ b/docs/governance/maintenance/README.adoc @@ -2,5 +2,5 @@ [NOTE] ==== -*Planned - not yet written.* RSR scaffold slot reserved for future content; intentionally empty for now. See `.machine_readable/6a2/STATE.a2ml` for roadmap status. +*Planned - not yet written.* RSR scaffold slot reserved for future content; intentionally empty for now. See `ROADMAP.adoc` for roadmap status. ==== diff --git a/docs/governance/maintenance/adaptive/0.3-AI-MANIFEST.a2ml b/docs/governance/maintenance/adaptive/0.3-AI-MANIFEST.a2ml deleted file mode 100644 index 63d1a99..0000000 --- a/docs/governance/maintenance/adaptive/0.3-AI-MANIFEST.a2ml +++ /dev/null @@ -1,11 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 ---- -### [META] -id: "governance-unit-adaptive" -level: 3 -parent: "../0.2-AI-MANIFEST.a2ml" - ---- -### [AI_MANIFEST] -description: | - TSDM adaptive unit within the Maintenance axis. diff --git a/docs/governance/maintenance/adaptive/README.adoc b/docs/governance/maintenance/adaptive/README.adoc index 0b087cc..c3eb7e8 100644 --- a/docs/governance/maintenance/adaptive/README.adoc +++ b/docs/governance/maintenance/adaptive/README.adoc @@ -2,5 +2,5 @@ [NOTE] ==== -*Planned - not yet written.* RSR scaffold slot reserved for future content; intentionally empty for now. See `.machine_readable/6a2/STATE.a2ml` for roadmap status. +*Planned - not yet written.* RSR scaffold slot reserved for future content; intentionally empty for now. See `ROADMAP.adoc` for roadmap status. ==== diff --git a/docs/governance/maintenance/corrective/0.3-AI-MANIFEST.a2ml b/docs/governance/maintenance/corrective/0.3-AI-MANIFEST.a2ml deleted file mode 100644 index 05cb89d..0000000 --- a/docs/governance/maintenance/corrective/0.3-AI-MANIFEST.a2ml +++ /dev/null @@ -1,11 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 ---- -### [META] -id: "governance-unit-corrective" -level: 3 -parent: "../0.2-AI-MANIFEST.a2ml" - ---- -### [AI_MANIFEST] -description: | - TSDM corrective unit within the Maintenance axis. diff --git a/docs/governance/maintenance/corrective/README.adoc b/docs/governance/maintenance/corrective/README.adoc index 4037c35..864bf20 100644 --- a/docs/governance/maintenance/corrective/README.adoc +++ b/docs/governance/maintenance/corrective/README.adoc @@ -2,5 +2,5 @@ [NOTE] ==== -*Planned - not yet written.* RSR scaffold slot reserved for future content; intentionally empty for now. See `.machine_readable/6a2/STATE.a2ml` for roadmap status. +*Planned - not yet written.* RSR scaffold slot reserved for future content; intentionally empty for now. See `ROADMAP.adoc` for roadmap status. ==== diff --git a/docs/governance/maintenance/perfective/0.3-AI-MANIFEST.a2ml b/docs/governance/maintenance/perfective/0.3-AI-MANIFEST.a2ml deleted file mode 100644 index 832762f..0000000 --- a/docs/governance/maintenance/perfective/0.3-AI-MANIFEST.a2ml +++ /dev/null @@ -1,11 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 ---- -### [META] -id: "governance-unit-perfective" -level: 3 -parent: "../0.2-AI-MANIFEST.a2ml" - ---- -### [AI_MANIFEST] -description: | - TSDM perfective unit within the Maintenance axis. diff --git a/docs/governance/maintenance/perfective/README.adoc b/docs/governance/maintenance/perfective/README.adoc index 40dbb79..579f37e 100644 --- a/docs/governance/maintenance/perfective/README.adoc +++ b/docs/governance/maintenance/perfective/README.adoc @@ -2,5 +2,5 @@ [NOTE] ==== -*Planned - not yet written.* RSR scaffold slot reserved for future content; intentionally empty for now. See `.machine_readable/6a2/STATE.a2ml` for roadmap status. +*Planned - not yet written.* RSR scaffold slot reserved for future content; intentionally empty for now. See `ROADMAP.adoc` for roadmap status. ==== diff --git a/docs/governance/planning/0.2-AI-MANIFEST.a2ml b/docs/governance/planning/0.2-AI-MANIFEST.a2ml deleted file mode 100644 index 80339e7..0000000 --- a/docs/governance/planning/0.2-AI-MANIFEST.a2ml +++ /dev/null @@ -1,11 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 ---- -### [META] -id: "governance-axis-planning" -level: 2 -parent: "../0.1-AI-MANIFEST.a2ml" - ---- -### [AI_MANIFEST] -description: | - TSDM Planning track. diff --git a/docs/governance/planning/README.adoc b/docs/governance/planning/README.adoc index 8f5ad94..4366348 100644 --- a/docs/governance/planning/README.adoc +++ b/docs/governance/planning/README.adoc @@ -2,5 +2,5 @@ [NOTE] ==== -*Planned - not yet written.* RSR scaffold slot reserved for future content; intentionally empty for now. See `.machine_readable/6a2/STATE.a2ml` for roadmap status. +*Planned - not yet written.* RSR scaffold slot reserved for future content; intentionally empty for now. See `ROADMAP.adoc` for roadmap status. ==== diff --git a/docs/governance/planning/could/0.3-AI-MANIFEST.a2ml b/docs/governance/planning/could/0.3-AI-MANIFEST.a2ml deleted file mode 100644 index fc17a27..0000000 --- a/docs/governance/planning/could/0.3-AI-MANIFEST.a2ml +++ /dev/null @@ -1,11 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 ---- -### [META] -id: "governance-unit-could" -level: 3 -parent: "../0.2-AI-MANIFEST.a2ml" - ---- -### [AI_MANIFEST] -description: | - TSDM could unit within the Planning axis. diff --git a/docs/governance/planning/could/README.adoc b/docs/governance/planning/could/README.adoc index fc65fcd..5f4ed7d 100644 --- a/docs/governance/planning/could/README.adoc +++ b/docs/governance/planning/could/README.adoc @@ -2,5 +2,5 @@ [NOTE] ==== -*Planned - not yet written.* RSR scaffold slot reserved for future content; intentionally empty for now. See `.machine_readable/6a2/STATE.a2ml` for roadmap status. +*Planned - not yet written.* RSR scaffold slot reserved for future content; intentionally empty for now. See `ROADMAP.adoc` for roadmap status. ==== diff --git a/docs/governance/planning/must/0.3-AI-MANIFEST.a2ml b/docs/governance/planning/must/0.3-AI-MANIFEST.a2ml deleted file mode 100644 index 0987dae..0000000 --- a/docs/governance/planning/must/0.3-AI-MANIFEST.a2ml +++ /dev/null @@ -1,11 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 ---- -### [META] -id: "governance-unit-must" -level: 3 -parent: "../0.2-AI-MANIFEST.a2ml" - ---- -### [AI_MANIFEST] -description: | - TSDM must unit within the Planning axis. diff --git a/docs/governance/planning/must/README.adoc b/docs/governance/planning/must/README.adoc index b0ede12..07c5097 100644 --- a/docs/governance/planning/must/README.adoc +++ b/docs/governance/planning/must/README.adoc @@ -2,5 +2,5 @@ [NOTE] ==== -*Planned - not yet written.* RSR scaffold slot reserved for future content; intentionally empty for now. See `.machine_readable/6a2/STATE.a2ml` for roadmap status. +*Planned - not yet written.* RSR scaffold slot reserved for future content; intentionally empty for now. See `ROADMAP.adoc` for roadmap status. ==== diff --git a/docs/governance/planning/should/0.3-AI-MANIFEST.a2ml b/docs/governance/planning/should/0.3-AI-MANIFEST.a2ml deleted file mode 100644 index f492289..0000000 --- a/docs/governance/planning/should/0.3-AI-MANIFEST.a2ml +++ /dev/null @@ -1,11 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 ---- -### [META] -id: "governance-unit-should" -level: 3 -parent: "../0.2-AI-MANIFEST.a2ml" - ---- -### [AI_MANIFEST] -description: | - TSDM should unit within the Planning axis. diff --git a/docs/governance/planning/should/README.adoc b/docs/governance/planning/should/README.adoc index e089fca..68ed6ec 100644 --- a/docs/governance/planning/should/README.adoc +++ b/docs/governance/planning/should/README.adoc @@ -2,5 +2,5 @@ [NOTE] ==== -*Planned - not yet written.* RSR scaffold slot reserved for future content; intentionally empty for now. See `.machine_readable/6a2/STATE.a2ml` for roadmap status. +*Planned - not yet written.* RSR scaffold slot reserved for future content; intentionally empty for now. See `ROADMAP.adoc` for roadmap status. ==== diff --git a/docs/history/A2ML-REMOVED.adoc b/docs/history/A2ML-REMOVED.adoc new file mode 100644 index 0000000..d6528a2 --- /dev/null +++ b/docs/history/A2ML-REMOVED.adoc @@ -0,0 +1,741 @@ +// SPDX-License-Identifier: CC-BY-SA-4.0 +// SPDX-FileCopyrightText: 2026 Jonathan D.A. Jewell (hyperpolymath) += The A2ML files removed from gv-clade-index on 2026-11-14 + +A2ML is retired (owner rulings D99, D269c, D312, D313): no `.a2ml` file +should exist. Each `.a2ml` file in this repository was translated into deed +form where a mapping spec in standards `1-formats/deed/mappings/` says it +translates, its readers were moved, and it was deleted. A field a spec does +not list does not translate; it was dropped, not re-homed. A file with no +mapping spec was deleted (A7 ruling Q7). This follows the hypatia migration +(hyperpolymath/hypatia#1113). + +This record lists each removed file, what it was, and where its content +went. The contents are not copied here. Git history keeps them. To read one, +use its blob id, or read its path at the last commit that held it: + +[source,bash] +---- +git cat-file -p +git show fb1c397d8fb3e571b66a55e66ed65debe7268bbb: +---- + +Size is in bytes. The sha256 is of the file as it was tracked. + +The new deeds are `gv-clade-index_chora.deed` (identity, clade, forges, +lineage, agentic, neurosym, playbook), `.machine_readable/descriptiles/STATE.deed` +(status, maturity) and the pointer-only `0-AI-MANIFEST.deed`. Each passes +`deed_lint.js`; `STATE.deed` also passes `--state --strict` against the chora +deed. + +== Removed: files with content of their own + +[cols="4,1,3,3,4,5",options="header"] +|=== +| Path | Size | sha256 | Git blob id | What it was | Where it went + +| `.machine_readable/CLADE.a2ml` +| 2395 +| `94bcbc363468a7a6d5bf93e7708eccc8c5635c355f2f8d0c5ce03655ce3cc154` +| `b58a451543c07479c49644078c94f384d47ff21d` +| Clade declaration of this repo: identity (v5 uuid, forge, owner, names), clade (gv, secondary db), forges, lineage, lifecycle status and its history. +| `clade-to-repo-deed.adoc`: `(identity) (clade) (forges) (lineage)` in `gv-clade-index_chora.deed`; `[status]` and its history to `(status)` in `.machine_readable/descriptiles/STATE.deed` (A7 J15). `:repo-uuid` is the registry's v8 id for this repo, not the v5 the file held. `canonical-name` is the deed's `:canonical-name`. Not emitted: the v5 `[identity] uuid` and the guidance comments. + +| `.machine_readable/6a2/AGENTIC.a2ml` +| 1492 +| `75162b754c5007bda2688916a028d18d35d61df4897a164199239bf33b27c1f1` +| `01f0d2e41c714052c9986f5417f5965992112598` +| AGENTIC descriptile: agent permissions, comment-only constraints, the five integrity axioms, comment-only automation hooks. +| `(agentic)` per `agentic-neurosym-playbook-to-repo-deed.adoc`: version, last-updated, permissions, the five integrity axioms (`:allow-silent-skip #f` kept). Dropped: `[agent-constraints]` and `[automation-hooks]`, comment-carried template canon (D4-1). + +| `.machine_readable/6a2/NEUROSYM.a2ml` +| 666 +| `3708cf31fbb06e03ee6e1123ec49859cbcd19666363ddb6c94ebf9a3d00d4307` +| `1acf7a3006cb94523077eb4371c0eb21eeae43fb` +| NEUROSYM descriptile: Hypatia scan config; symbolic-rules and neural-config held only comments. +| `(neurosym)` per the same spec: version, last-updated, scan-enabled, scan-depth `standard`, report-format. Dropped: the two unpopulated sections. + +| `.machine_readable/6a2/PLAYBOOK.a2ml` +| 1144 +| `2131e30c6d8feff92fc70a6f3b878d9050cbb13cc39dafa1272b116b23f19bba` +| `6408e1c72e84c697ca947d29cef2f88a037f7b99` +| PLAYBOOK descriptile: deployment, incident-response, release-process and maintenance-operations sections, each only comments. +| `(playbook)` per the same spec: version, last-updated and the four sections as empty position clauses. The source had no docs-format section, so none is emitted. + +| `.machine_readable/6a2/STATE.a2ml` +| 4154 +| `d07d6dd1d6bedd96853a5a66ed8fd3f95f477ff00237af15164a386477b0f612` +| `79f9225d84d300c3264ef67831a0341225ea5753` +| STATE descriptile v1: status, phase, maturity, completion, milestones (Phases 0 to 8), verification notes, blockers, next actions, recent changes, documentation sketches. +| `state-v1-decision.adoc` option B: maturity to `(maturity :level alpha)` in `STATE.deed`. Dropped: `status` and `phase` (the lifecycle claim is `(status)`, from CLADE), `completion-percentage` (derivable). The rest is journal, archived here by reference; the live roadmap is `ROADMAP.adoc`. + +| `.machine_readable/6a2/META.a2ml` +| 2180 +| `637ef5a26e094318dfa6d4d70f3dda3cb186696c4cddb0d1028a5249448099eb` +| `295c3732b9a9951de88b2a1cb3412b8c4d889388` +| META descriptile: project name, description, licence, standard, author, and ADR-001 to ADR-005 (VeriSimDB as registry, pointer authority, 2-character prefix, ReScript/WASM portal, map and territory). +| Nothing translated. `meta-ecosystem-to-repo-deed.adoc` lists `[metadata]`, `[project-info]`, `[development-practices]`, `[maintenance-axes]` and an `[architecture-decisions]` array whose entries carry `id`; this file has `[project]`, `[author]` and keyed `[architecture-decisions.adr-NNN]` tables with no `id`, shapes the table does not list, so the translator refuses them (P-2a, "corner shapes … never translate ad-hoc"). The repo's ADRs of record are `docs/decisions/`. + +| `.machine_readable/6a2/ECOSYSTEM.a2ml` +| 1449 +| `2e4fb239796d69c27d2a583cd981aa21c460ae249209b09d3c68e9cbf1be2516` +| `a28802bd17f46b70c8e10beb2ad5d0fb43490a7e` +| ECOSYSTEM descriptile: name, type `registry`, purpose, position, and seven related projects (verisimdb depends-on; hyperpolymath.github.io, gitbot-fleet and hypatia feeds-into; reposystem, palimpsest-plasma and seamstress sibling). +| Nothing translated. The table lists `[metadata] project/ecosystem` and `[position] type/purpose`; this file has an `[ecosystem]` section instead, and no `ecosystem` value, which the `(ecosystem)` clause requires and a translator never invents. The related projects are keyed tables, and `depends-on`, `feeds-into` and `sibling` are outside the closed `:relationship` set (`clauses/ecosystem.abnf`), so no `(related)` clause can carry them. Recorded as an owner question. + +| `0-AI-MANIFEST.a2ml` +| 3012 +| `f9a026f3bd5bcfa242fcb39119c9e3fabb06ecf1f6e18b64c9a491102fa010f9` +| `7ddf1758d9b7eee3a98fb7954c30465e217ff5a3` +| AI manifest (Markdown prose): purpose, canonical locations, invariants, the 12 clade codes, a session checklist. +| Replaced by the pointer-only `0-AI-MANIFEST.deed` (A7 ruling Q15). Its sections are not the `[metadata] [project] [ai-allocation] [policy] [work-allocation]` table of `ai-manifest-decision.adoc`, so nothing was translated. The clade codes are scheme `clade-12` in `verisim/seed/chora-registry_praxis.deed`. + +| `.machine_readable/anchors/ANCHOR.a2ml` +| 1696 +| `ac79a6f90fc2660d4227c1c396155e54aed8caa92df9c6fa746cbfb815ae7098` +| `2c76375e0830ec397476eae564c9d9453fb90e8e` +| Anchor v1: authority `upstream-canonical`, purpose, identity, semantic authority, implementation policy, golden path, satellite policy, semantic-authority files (several naming files this repo does not have). +| Deleted: no mapping spec in `1-formats/deed/mappings/`. A7 section 6.4 gives the `(anchor)` clause translation, to move into `mappings/` on ratification; the values here are template defaults (allowed languages, `just test` golden path, files that do not exist), so they are left for the owner rather than carried into the chora deed. + +| `.machine_readable/ENSAID_CONFIG.a2ml` +| 5548 +| `c35b59568f610df59f0abdfa2b1a577af0767714e58cae9d3ac614d046372cc2` +| `4f134eb0ec8149c2467df68a4fec2c11743c7c84` +| eNSAID/PanLL workspace configuration (mode, protection, panels, preferences). +| Deleted: no mapping spec. The file is optional; eNSAID tools apply defaults without it (standards `1-formats/sub-specs/ensaid-config/`). No reader in this repo. + +| `.machine_readable/ai/AI.a2ml` +| 970 +| `605d949275fdae1f8a9a85cac098914943361cca63d2ef51dc1affd6f8132fa4` +| `c683d30f13fdd276b19d524649fc05acc63b54ab` +| Template AI-assistant instructions, written for rsr-template-repo, pointing at STATE.a2ml and AGENTIC.a2ml. +| Deleted: no mapping spec; template residue. Agents start from `0-AI-MANIFEST.deed`. + +| `.machine_readable/agent_instructions/methodology.a2ml` +| 4675 +| `0a5d15346f3dabbabbb13bffd54e0504dc725d0596a15ae3dc53a9fccc7ff783` +| `4d0b79e83a43c23a0609cbd4f3d29c7d6a2965b5` +| Agent methodology template: mode, ring ceiling, priority weights, budgets. +| Deleted: template boilerplate; no mapping spec. Its README, which only described these three files, is removed too. + +| `.machine_readable/agent_instructions/coverage.a2ml` +| 2233 +| `ce9e1e2124e3a7d7dc86e3704d0bb68cf81eae1185fe6e6ddcf98c505ff1975d` +| `69796642033856ce09e8282f9dc2479500e07747` +| Agent methodology template: session coverage (all counts zero). +| Deleted: template boilerplate; no mapping spec. + +| `.machine_readable/agent_instructions/debt.a2ml` +| 1879 +| `ae4680c353b887ddc636d5e0002dd79c94e917c69a33cb24d0a58e53e2178e9f` +| `c0238c5dfa488ecb12ab9e8f45d9fefac2b71f0e` +| Agent methodology template: meander debt (no entries). +| Deleted: template boilerplate; no mapping spec. + +| `.machine_readable/contractiles/bust/Bustfile.a2ml` +| 1582 +| `47714a0fed24d932bedaf5842893b28cedacf9260e8bdba85ce438dadc7e4b68` +| `bb6c1222ec9e833a1627919a0decaf9bc5e2cef3` +| Bust contractile: meta-repo rollback scenarios and escalation ladder (template residue: this repo has no submodules). +| Deleted: no mapping spec. `bust.ncl` now names `Bustfile.deed` (A7 8.1), not yet written. + +| `.machine_readable/contractiles/dust/Dustfile.a2ml` +| 1298 +| `767655c8a49c4f12d63b24ba8ae8487aa439c676727b9c8c1d4c51656dcac6ae` +| `be38a8ca7c565d6a1f5083536109cc86429e729f` +| Dust contractile: stale-file housekeeping checks. +| Deleted: no mapping spec. `contractile.just` keeps its generated recipes. + +| `.machine_readable/contractiles/must/Mustfile.a2ml` +| 2077 +| `c23d432dc282ad405eba73a2e39e24b20a0f9e3b70f4f210b53c3fe364a7d6b8` +| `215c51062810264d76f98b8f2d02697404f9bc4e` +| Must contractile: file-presence and banned-file checks. +| Deleted: no mapping spec. `contractile.just` keeps its generated recipes. + +| `.machine_readable/contractiles/trust/Trustfile.a2ml` +| 1724 +| `32445f549ea53083edcc2660acdd343a42fa1dd3c164c118751f87f982bab81d` +| `f2a4f9592c1c2004da64062db4fa7bb667f83f4d` +| Trust contractile: secret, key and token checks. +| Deleted: no mapping spec. `contractile.just` keeps its generated recipes. + +| `.machine_readable/integrations/feedback-o-tron.a2ml` +| 381 +| `e0befb80a2138f359524d6db4e5fdc598c4a233079990afe6303e382821e1550` +| `5381604eda94e014b309b62ffa43e41fdbed5e63` +| Integration note: feedback-o-tron bug-reporter config. +| Deleted: no mapping spec, no reader. + +| `.machine_readable/integrations/proven.a2ml` +| 612 +| `11fabb802ac4a0285caa64c4000436c3e1b386b7a6190d735e10be0fb910dbd9` +| `9af33ffdc7e9faced46b474f2a07df389c9e1631` +| Integration note: proven safety-library adoption guidance. +| Deleted: no mapping spec, no reader. + +| `.machine_readable/integrations/verisim.a2ml` +| 387 +| `48f716912dbe895d0f4f59a767c22cea517fcb9bc3637b1540558cd3f647cc51` +| `164c5229a7e2a507cb9f123ccd681159a3376005` +| Integration note: VeriSimDB data-feed config. +| Deleted: no mapping spec, no reader. + +| `.machine_readable/integrations/vexometer.a2ml` +| 444 +| `3f85155335da36a216049bc4434f976d19580b6bcd49c020117a5c133e3b9145` +| `238b3d2cdd3a9c59f5e21dcdadba8aaf81d24214` +| Integration note: vexometer measurement config. +| Deleted: no mapping spec, no reader. + +| `.machine_readable/policies/MAINTENANCE-AXES.a2ml` +| 1795 +| `2a2c5719fd120509e1fc72212d62f4e5df154b6346b248bb76951f9026dcadc9` +| `0e2a48aa15dded96347ef14c485140e4d29e8cd2` +| Maintenance-axes policy: the three axes, scoping, maintenance and audit rules. +| Deleted: no mapping spec. The axes are in `docs/governance/TSDM.adoc` and `MAINTENANCE-CHECKLIST.adoc`. `just validate-rsr` no longer greps it. + +| `.machine_readable/policies/MAINTENANCE-CHECKLIST.a2ml` +| 3575 +| `66cff62b709cd470138b37e9c5953d592983a7244aa50ed05b8b498efed6f99c` +| `eaee72059cbfbae9bb5c2ec907281efe8bb9d69f` +| Maintenance checklist policy (machine copy). +| Deleted: no mapping spec; the human source is `docs/governance/MAINTENANCE-CHECKLIST.adoc`. + +| `.machine_readable/policies/SOFTWARE-DEVELOPMENT-APPROACH.a2ml` +| 1582 +| `b8840c589be930c7c6a4384485c84afbf0da19d5eb2790cf98a8a6d2b28c8f8f` +| `093573a07ef2c3cf189dd37cabfb1b40159e0f9b` +| Software-development approach policy (machine copy). +| Deleted: no mapping spec; the human source is `docs/governance/SOFTWARE-DEVELOPMENT-APPROACH.adoc`. + +| `contractiles/must/clade-hygiene.a2ml` +| 3900 +| `6b8adf6b2b8d61ccc5e8a636732c88cffee3509f35c0811f75eabf40b1aa08f3` +| `1e040ff2df5b2b60867af538c5be44c18c143739` +| Must edict CLADE-001 to CLADE-006: every repo must carry `.machine_readable/CLADE.a2ml`, with a primary code from the 12 and a matching name. +| Deleted: no mapping spec, and it demands an A2ML file, which is retired. A repo's placement is now an identity fact in its chora deed, checked against this registry's scheme `clade-12` (W10). `worker/src/validate.js` no longer names it. + +| `docs/governance/CRG-CRITERIA.a2ml` +| 4213 +| `9f13976e7d60bfe80923372126b12de6f13a771a104c52e6bd03cb2619283521` +| `61625859454d7c5339c496a9938670360331d297` +| Component Readiness Grades v1.0, machine copy of `CRG-CRITERIA.adoc`. +| Deleted: no mapping spec; the `.adoc` beside it stays, and the canon is standards `4-readiness/`. + +| `docs/governance/MAINTENANCE-CHECKLIST.a2ml` +| 3606 +| `8127b20eed1901a777fd85e10c68ac5b1dcc0786e2161469df6cf3727839fce6` +| `f46eecee48d70aceb448b6cc71e8d39e1e533db2` +| Maintenance checklist, machine copy of `MAINTENANCE-CHECKLIST.adoc`. +| Deleted: no mapping spec; the `.adoc` stays. + +| `docs/governance/SOFTWARE-DEVELOPMENT-APPROACH.a2ml` +| 1582 +| `b8840c589be930c7c6a4384485c84afbf0da19d5eb2790cf98a8a6d2b28c8f8f` +| `093573a07ef2c3cf189dd37cabfb1b40159e0f9b` +| Software-development approach, machine copy (byte-identical to the policies/ copy). +| Deleted: no mapping spec; the `.adoc` stays. + +| `docs/governance/TSDM.a2ml` +| 542 +| `4c842eae6a7bf4c415728a41a49e54af44d1dd1cccc8274591eb69a623ca87a1` +| `f27036cc73444f211a8e61693db356555895b5eb` +| Triaxial Software Development Methodology axes, machine copy of `TSDM.adoc`. +| Deleted: no mapping spec; the `.adoc` stays. + +| `docs/templates/contractiles/dust/Dustfile.a2ml` +| 353 +| `ab9c7b7f814159986137f923676e991196a2ba697a8d4a44a1d7f77cad9bfa7d` +| `903af2c3f888df3b859b717952aaf35fad34dec5` +| Blank Dustfile template. +| Deleted: an A2ML template; no mapping spec. + +| `docs/templates/contractiles/must/Mustfile.a2ml` +| 353 +| `62e07fedf533d8928ba78d17b8d727bb06457245c77968b921a3cf0666c3ab0e` +| `d08796f92abfccd8f56fdb662aded3ec980708fe` +| Blank Mustfile template. +| Deleted: an A2ML template; no mapping spec. + +| `docs/templates/contractiles/trust/Trustfile.a2ml` +| 357 +| `9e02f59f3435932bf35c9d08833724ecda840511a4ec210c823cb3dd0dbcee3c` +| `842c6b06a0b867c84e0b33971dc987563eb99caa` +| Blank Trustfile template. +| Deleted: an A2ML template; no mapping spec. +|=== + +== Removed as one class: the directory manifests + +Eighty-one `0.N-AI-MANIFEST.a2ml` files (N from 1 to 4, 25878 bytes in all) +sat one per directory of the scaffold: `.github/`, `.machine_readable/`, +`container/`, `docs/`, `examples/`, `features/`, `src/`, `verification/` and +their subdirectories. They are the scaffold's directory-manifest family, +which `ai-manifest-decision.adoc` section 0 names as a different family from +the root AI manifest, with no mapping spec of its own. Each held a `[META]` +id, level and parent and an `[AI_MANIFEST]` description, sometimes with +`canonical_locations` and template `invariants` (for example "ABI MUST be +Idris2"). None carries a fact about this repository: they are the template's +text, the same in every repo minted from it. Two are a single comment line +(`.github/` and `examples/`). `container/0.1-AI-MANIFEST.a2ml` describes the +stapeln container templates. The `features/` manifests (`boj-server`, +`panic-attacker`, `ssg`) describe the template's optional feature bootstrap +guides, whose `README.adoc` files stay; `panic-attacker` is panic-attack's +old name. All 81 were deleted, untranslated. + +[cols="5,1,3,3",options="header"] +|=== +| Path | Size | sha256 | Git blob id + +| `.github/0.1-AI-MANIFEST.a2ml` +| 33 +| `4a01e142d7aa5bd591588351050775e02a3421160d6ea2e9ba1fc97dcc40b748` +| `85b2f0f0a097ea65882ef51128b002576e372198` + +| `.machine_readable/0.1-AI-MANIFEST.a2ml` +| 658 +| `0823ff4f0119047b8c2cfbaa4cabbc19c7166adfd687e62313d5cb2d9d1dd2fa` +| `9d2bc7a077aa84426cacd49d072e14cf7f945301` + +| `.machine_readable/ai/0.2-AI-MANIFEST.a2ml` +| 181 +| `740b966f4ab66d7bbb61450da9dcf912116e108d67efa943e37261a7994ab122` +| `869cbee6163012180c5efbb32d5fcdf68e2c2af1` + +| `.machine_readable/anchors/0.2-AI-MANIFEST.a2ml` +| 191 +| `edc709d516f64168a239dbde5244a6231d57a8795e0e31854c7c4ee75a77daf6` +| `45038e1eb3d1f348a3a080e8a880b21ef2b99ad4` + +| `.machine_readable/configs/0.2-AI-MANIFEST.a2ml` +| 191 +| `43e5323c8c189297afebd91ba719e4652139caa511b4dd4037f20d957e98ec53` +| `6e41e6c25b483cee8c48acf26fb48332fb367dc1` + +| `.machine_readable/policies/0.2-AI-MANIFEST.a2ml` +| 193 +| `9bab97ba3f0d3a130991de23a7333f186d92fd6feb3218e07a7730e506f39985` +| `01a19140acedd9cc4c23a529e2abe48de2aa9e25` + +| `.machine_readable/scripts/0.2-AI-MANIFEST.a2ml` +| 398 +| `df879a53ce1dbc169a160164a1f161e97dba17e83e60808886abff74b871c54b` +| `615df84f01893de2968f783c8017f61be7f592d9` + +| `.machine_readable/scripts/forge/0.3-AI-MANIFEST.a2ml` +| 206 +| `6bd8128d0a4eed6ee42f7355c1fdd687573657cfdd54c8950c8bfb084671f35b` +| `4bbd6cf394f6417ee141b7f4a65e2e5a2b031a22` + +| `.machine_readable/scripts/lifecycle/0.3-AI-MANIFEST.a2ml` +| 214 +| `376064428be7f0f23ef5a2d34591422a3165b36c3bab6fa855356f5df6f3d5c0` +| `3182d1754dfcaf846d6561b73f431d57e7f7d36d` + +| `.machine_readable/scripts/verification/0.3-AI-MANIFEST.a2ml` +| 220 +| `3c9c71c5c55c35e577b7ed53b07220f1ec8e5fc6691b9214a13a5c60f9e78052` +| `460e0694090ab32ff28c1a30e31439aa9a490927` + +| `container/0.1-AI-MANIFEST.a2ml` +| 5227 +| `45b20fa0d1f8db8e250407ef80454e21cff9f1f4aa53d4859dfa346a4e13eef0` +| `ccb5bc51d49dc343c3e96e924ca8b5e198193219` + +| `docs/0.1-AI-MANIFEST.a2ml` +| 832 +| `6a778966ddd95804ea340f836656be5d3b06ef7803fabbb457366b52b2404351` +| `7f79301eee4986d4ab205e1e3892ae6b9bb7636e` + +| `docs/architecture/0.2-AI-MANIFEST.a2ml` +| 360 +| `b6c0f401c2b229afd57074977266cc3bc7f9a80f515ede981d6f017b2b843cd8` +| `028b503d6da67b4d6644fc93f653a29a4ebaa08a` + +| `docs/attribution/0.2-AI-MANIFEST.a2ml` +| 209 +| `294f049bfd4f27c72c941e6ffbe94273b850eac130afe628f422ef86cd8f7168` +| `52beaea4bee93d92aea55bfdf241c5bd23637f8e` + +| `docs/decisions/0.2-AI-MANIFEST.a2ml` +| 205 +| `41e93d56f58f740f55dcfea7351b8f74bb37d1970a875fbf65fab887857d7ea3` +| `ac26298b425e4468c665fa943c1515e4be24e6de` + +| `docs/developer/0.2-AI-MANIFEST.a2ml` +| 205 +| `df741a1885af79ce9e2033b238768433dcab47ce5d36453631243a1889579878` +| `c16fcc747290e1474d473bab9c286e6340c38f49` + +| `docs/governance/0.1-AI-MANIFEST.a2ml` +| 537 +| `0c5f405160ce59b5b485ae5c460cd7bebd37a4b8024968d0bb2be70bb9c65d7b` +| `6e373bd2fd3d29fc3df932927fe089e8ea618e90` + +| `docs/governance/audit/0.2-AI-MANIFEST.a2ml` +| 179 +| `3d53caf64313669fa8e92d0d3fd3d253037b173f47ee58bb9f7bba8b24db4981` +| `47224869992ee80c9d7b2056045c89752fc737f1` + +| `docs/governance/audit/compliance/0.3-AI-MANIFEST.a2ml` +| 210 +| `a9e946712cb85154b101c176d5e23788fc17221337537e70b1f4d1f3fea1ad98` +| `b13ec695f410b02473f9a07a7010b25aef7cbf25` + +| `docs/governance/audit/effects/0.3-AI-MANIFEST.a2ml` +| 204 +| `957bca95a8d5aba602b3fe0e795c266a154f07544981de60f164d5a39dcfad4d` +| `0bccae0d02d57fa270e59c2eae8ae2a8c05e5970` + +| `docs/governance/audit/systems/0.3-AI-MANIFEST.a2ml` +| 204 +| `97eff44cd1c6961a29559a9568e42f9e4ad8485b7e3c7faba0f04ca610420064` +| `f97bc9ccbfbc2bd64a567590dbaf44dc6efb1908` + +| `docs/governance/maintenance/0.2-AI-MANIFEST.a2ml` +| 191 +| `2637c542f877adfe782781d242235538c7bd8bed3ae27b1208348928b11c7780` +| `8e0dff5ec71b474ed6d81dfd9078b7f761bd4ac4` + +| `docs/governance/maintenance/adaptive/0.3-AI-MANIFEST.a2ml` +| 212 +| `7044efa2e80b332279e5d122e64b0a4020df7823576aca1f46825f7875c0c358` +| `63d1a9992f920d73a4869e3d672fc3314bdd1ee2` + +| `docs/governance/maintenance/corrective/0.3-AI-MANIFEST.a2ml` +| 216 +| `9033b551ebec6b63c72291a174b30d0689c0866a5c1f2fd8b94b8fd4c1bb4093` +| `05cb89da1a070424c871b407d2d1262d20507daf` + +| `docs/governance/maintenance/perfective/0.3-AI-MANIFEST.a2ml` +| 216 +| `65e36530572105cfe4a8efbf3689f62cce7709906e06f24769b047c546b9e5ec` +| `832762feba6fd994ac3c7678b5501609d1deef0a` + +| `docs/governance/planning/0.2-AI-MANIFEST.a2ml` +| 185 +| `9a5a216b8ac1eafba1f2ba943c66c129b2447cccecbd26c4036d2c1f82848ac9` +| `80339e77c5e3ea453f85b82409900dc010cb4710` + +| `docs/governance/planning/could/0.3-AI-MANIFEST.a2ml` +| 203 +| `334139889c6524262a5fd5eeb59b573ea1acf31463fc7e5e39b0627d7f311a57` +| `fc17a27d07a0cbc239b94126ee01c6ba6727c1e5` + +| `docs/governance/planning/must/0.3-AI-MANIFEST.a2ml` +| 201 +| `f0f80259f2f1767339a2977b03c017927c5fba57954963be7f2d933622ef905f` +| `0987daeedca51fd6833504cb8d8eeda69dd0047e` + +| `docs/governance/planning/should/0.3-AI-MANIFEST.a2ml` +| 205 +| `d6e33a5936d69c4f311099021279ae93711d4ef70a8631537d2a41eb7b765b1f` +| `f492289a3fdeda6ce03e6aec4b751ad83158a8cc` + +| `docs/legal/0.2-AI-MANIFEST.a2ml` +| 321 +| `49e25170aadb89ea7842fc7734b42ad1a5f68ce82427b4e21684a5c836dc12ec` +| `e547798339695a8b94ae35b111b23a31ef5ca721` + +| `docs/practice/0.2-AI-MANIFEST.a2ml` +| 203 +| `4390033f8571b7f35b3ef77329a133e05078e0d77f969ae7ed4ecfa61b3bbab3` +| `257f3a4f45c2136e41c20eac22988655ed7d7d29` + +| `docs/reports/0.2-AI-MANIFEST.a2ml` +| 395 +| `2fb1fd5c33272dce17c46ada60026ada486b22e6a11d87159921f05a7f0b907e` +| `5eb265dced303300a119a716b8bd3e5f6ad0e9f0` + +| `docs/reports/compliance/0.3-AI-MANIFEST.a2ml` +| 223 +| `ce2f6eba5d2fc818577731df1fc66874861e046d21c17f109fa6cd09d757b5ba` +| `6b3975282272e7cde4ceab8ef6438fa6177ccc40` + +| `docs/reports/maintenance/0.3-AI-MANIFEST.a2ml` +| 184 +| `d64bf6f223d568230e1464c41c9b1a9a7599dc9d761e95211fbe5fcc7d679112` +| `43eefe29a87473bd8fe2227a5bfbcc2f99e79915` + +| `docs/reports/performance/0.3-AI-MANIFEST.a2ml` +| 225 +| `7d30f5e7053206e2c3114ca9bf3dffb04d67a054b3dbd8d3edb411f48a8e488a` +| `40c09540c6729d114e36688912f22494c3ddd941` + +| `docs/reports/quality/0.3-AI-MANIFEST.a2ml` +| 217 +| `a8f31b22b66a20a9f3b65e161071d11b53f5b0c6275728ef6a1b30fe7f2c5669` +| `d460edcfa09a6b79aa5de77f0256d113ddf887e4` + +| `docs/reports/security/0.3-AI-MANIFEST.a2ml` +| 219 +| `2a76a6917fd5e2733cd5df3264ee267209faba0975f03a8459831b8a4eefe466` +| `696ab590cce2fe0cb8f6e3c3c8db414ef786864a` + +| `docs/standards/0.2-AI-MANIFEST.a2ml` +| 198 +| `e1c9676243b0293fdb9ce5754726384c71b3c24e7bd65a18b8aeeed6f21c8f48` +| `c147c6f8b1b1345bee2dd668f54613ad43ffd600` + +| `docs/theory/0.2-AI-MANIFEST.a2ml` +| 542 +| `594ed90af208ee4e07567c9c71745d3394ff17f53473137cc838435880289a8d` +| `93df18706e356c0a30ec71ee9ba3a6a625669fc1` + +| `docs/theory/computing/0.3-AI-MANIFEST.a2ml` +| 199 +| `7fa644a782f8854f81eb50613f3c17ddce28e9e021cf31a49d78f636b22336d1` +| `f387d08e9c17756c09be34d867ed2cecdc69c8e8` + +| `docs/theory/formalisms/0.3-AI-MANIFEST.a2ml` +| 201 +| `a97f055d1517ab0088f0ea051fd479bcfa922c81a85e9f87260aa6c14867dddd` +| `cdc2baa1492b37ea39d6bf7f3eef2d08fa2a229c` + +| `docs/theory/mathematics/0.3-AI-MANIFEST.a2ml` +| 203 +| `842e5e61289a793973e13aac3048c9b2cb04c97c36fec91d99a26186992f4b4b` +| `677a4dacbabcc2d2820e89066a8e560170277918` + +| `docs/theory/ontologies/0.3-AI-MANIFEST.a2ml` +| 201 +| `b87607ebde247388a026a41df7252154a7dec71398c26c9ca6f39dd97a325c75` +| `d888cee5699f2614564606f649646aa2ed98db03` + +| `docs/theory/other/0.3-AI-MANIFEST.a2ml` +| 191 +| `885947311e8fcdbe49d07a8fe22739d4b5a02adf391c05b038179ddae3c876ba` +| `166ed9e8b0cabbbfb72b9d6c2738bae52f6460ab` + +| `docs/theory/socio-technical/0.3-AI-MANIFEST.a2ml` +| 211 +| `1b146d705286965485e6cc8851dff21f58f130701da1bfb9bb5b928522de65fc` +| `891952224e39b2da79bb3fef9a5ebc09f3f9e35a` + +| `docs/whitepapers/0.2-AI-MANIFEST.a2ml` +| 454 +| `2367e88a518ca29a1e414c16e8709413bf5705cac53027dbf8220661c5c89146` +| `c936101d8878013bc05c6db911cfd3998b5210a2` + +| `docs/whitepapers/academic/0.3-AI-MANIFEST.a2ml` +| 180 +| `d24cc852a2e72a94abbe73118b4eefa2c7f60f77b6854dbf8163d734872d87df` +| `ceb8a1e71f6ec0fd860148213c662230db68f8cf` + +| `docs/whitepapers/industry/0.3-AI-MANIFEST.a2ml` +| 180 +| `3701b02dfa536aa37c57424b187678c1070c75716f059e8184f6b783ac6ade24` +| `20156dd51da50143a3138a427feb91cf73f8b3d5` + +| `docs/whitepapers/outreach/0.3-AI-MANIFEST.a2ml` +| 450 +| `af6b5532559a28e2485d59053a585a0985474f5a546243281299cfba089116d2` +| `ed7e1529f6470c0a9e913e9a39d433f8aa27ea42` + +| `docs/wikis/0.2-AI-MANIFEST.a2ml` +| 349 +| `18ff555c2eb0e1c663a9fea24167560194825286085b6a665d0e22a0ea574f91` +| `f071ca8a9f4544c5bf4f6cc607205aa39e9164b6` + +| `examples/0.1-AI-MANIFEST.a2ml` +| 34 +| `79d5e3b60bfb4d36e7030901f18324d400b7850e9e4cde3029cbe605b2191339` +| `0d69c9050d933b29d1e6d4873f11839adf358d48` + +| `features/0.1-AI-MANIFEST.a2ml` +| 392 +| `57cad6411ff86d234fd96d35cf8f60c1c8d3f3435c9215b15f8d12464bb5e79a` +| `dc3e4ee3a0472917a2124b8cc79869eb96fa9549` + +| `features/boj-server/0.2-AI-MANIFEST.a2ml` +| 235 +| `bcd2bc7c43fe050f532bf293896ba134512af4c517aae6e0106bb9bb97e1f67b` +| `c77798cdfad945d57713c7e5f9a1f8a0e338d868` + +| `features/panic-attacker/0.2-AI-MANIFEST.a2ml` +| 243 +| `2d18c00e263d67a0e40a8d6d4d70a03f2477d6103bcef4e47e41faadef4dbaa6` +| `e61ad2440328d8de702f2defe6ac65694b871619` + +| `features/ssg/0.2-AI-MANIFEST.a2ml` +| 221 +| `608c4436f1319e1faa6f950b9d5ebdc89285def65816b8935bbdf2ded6dfa938` +| `121c5ae273daeaa3ac51193956959064535ce583` + +| `src/0.1-AI-MANIFEST.a2ml` +| 611 +| `b873b586f5847251715a07c88e9d050a02c90ed365f4ac6544579a6b1be3b844` +| `c92e124d169105a49c823d018cb90fc797cf84bd` + +| `src/aspects/0.2-AI-MANIFEST.a2ml` +| 356 +| `5b95454aac384aca1190abfc9b94245740b30d8a73913d8c95e9674c7d5b3217` +| `3d5b209e23764858ba1fe36b41b85844d6160956` + +| `src/aspects/integrity/0.3-AI-MANIFEST.a2ml` +| 208 +| `8b9fd56a987f208d1d9b147c4e4b9c6125bb4d320c22dbc83d4fb85de836ecf7` +| `f114cbd2472ca76d93bbb1b7bc3be80dd0e8a85a` + +| `src/aspects/observability/0.3-AI-MANIFEST.a2ml` +| 216 +| `bc1543f319ed77f5887425abd88e9c4d2d8fd8ad432b8e4563069036e0904d2a` +| `e16cbdf9d7401849e66bce138efcaf1425ed0a42` + +| `src/aspects/security/0.3-AI-MANIFEST.a2ml` +| 206 +| `2e481c7379b9f66a19dfbef455df2fa9a3df0a78840fcf732d482caf6d9b88ec` +| `0996536363dea355b985767e6349895c847e5d2a` + +| `src/bridges/0.2-AI-MANIFEST.a2ml` +| 226 +| `3c338c33fc2ca688a334ab237e398389afc70fdfb4645bfe2a0a42f8e1943fcc` +| `3d3e27a077f68a58eda75a65b2c18b1dc84339a1` + +| `src/contracts/0.2-AI-MANIFEST.a2ml` +| 204 +| `926a3f364aa33bcaa4f1a39deb9aaf4463c123403e9974b82b0d0ab0022a5f3a` +| `0bd9198f8363642fc2ab020debaa41a6778bc319` + +| `src/core/0.2-AI-MANIFEST.a2ml` +| 206 +| `a07a4742b1882846de3c0067615440db553b08af7dc69003caa73e715cc057fa` +| `22846c785bfc95fad225c17cb93000a023ccf1d2` + +| `src/definitions/0.2-AI-MANIFEST.a2ml` +| 208 +| `55c1374763728159f14d0e3c53c58953dd77e325dcb172e20a77e76392f72eb7` +| `e54f4dabbae9b83fae8e1ca352f0e165cae98cd4` + +| `src/errors/0.2-AI-MANIFEST.a2ml` +| 198 +| `9ee5b544aaa19f2dece17ee491c3c9dba7eb502154112206e31597ee64e8f2c2` +| `dddcc6c43a957a224d8222405f478a495cc704e0` + +| `src/interface/0.2-AI-MANIFEST.a2ml` +| 604 +| `4520667c5293a8331d251cc7a2830e0db3b74fc2f5575ba05dd404d1e8d6b858` +| `7f0f471b3af7caea55d7f9410144d58c5245563f` + +| `src/interface/abi/0.3-AI-MANIFEST.a2ml` +| 184 +| `076aaf2be6595159072269348407c48990984cbc7ad9fb8d23531a0e7dc3de11` +| `91cafa0148c84d3c48114d80c53ae51432bc49cd` + +| `src/interface/ffi/0.3-AI-MANIFEST.a2ml` +| 184 +| `8dd84ad81ea6518906b7ef5460bf363a873112a3cf03c124d774a91d5fa54b36` +| `bf456ae240b9a4ef8033f223dff8f5d6f1d4ac9c` + +| `src/interface/ffi/src/0.4-AI-MANIFEST.a2ml` +| 170 +| `e95be2e7dbe7fb6bf3ca69fedc6b2f2e6fbac383f0f353ae378eaac80a92b552` +| `5b5f1b1e5542d0b6a09727521b048e2945027ba5` + +| `src/interface/ffi/test/0.4-AI-MANIFEST.a2ml` +| 172 +| `cfb693402a4ff60a50cf6a86811ad97f451a1a83b93706ec76203c0214dd0f8c` +| `e02427f84061ce09549d6d9a90acc88b15b46a67` + +| `src/interface/generated/0.3-AI-MANIFEST.a2ml` +| 196 +| `f54a6b786c324fdb5e4878990451d12c28599a667ac5eb86be1018362d6380d1` +| `0088b80c7d17b56d76d62c15fcfc25a0af529bed` + +| `src/interface/generated/abi/0.4-AI-MANIFEST.a2ml` +| 170 +| `60324440b4bb1b172663ec6bf90dbe76e9d9329da2b36ced1f983da8e7eec00d` +| `4eeb58088e41d848c3161cb8059992da26e7f1e2` + +| `verification/0.1-AI-MANIFEST.a2ml` +| 740 +| `dcfc7a5a3cf7480ce21a0502a3ba0c699bd5f577eb0e059df39470ad31b61f1f` +| `3435bdb41bc22273454fc25416ff43f0fe1687f7` + +| `verification/benchmarks/0.2-AI-MANIFEST.a2ml` +| 170 +| `cce3a2380d24b123bfa544e3fd1804ccc65a09787983a0f6e7136fc2eefc0d55` +| `d922a4c74ecb92d4cf23333a2e3354088ba07324` + +| `verification/coverage/0.2-AI-MANIFEST.a2ml` +| 286 +| `f246a8fc101ffb74858c936b5856043430b7f79b3fb00a8b4d53de451a692485` +| `32b819e4e0b9737e50c7bb0bd5c94415752633b0` + +| `verification/fuzzing/0.2-AI-MANIFEST.a2ml` +| 194 +| `d13f11a5e4b89c462c62316170cd38479df9fc9bcf91a6eb253a5d8c7fb5f7fd` +| `5178d400e913379938d4a170dabbbf4f3f582a1e` + +| `verification/proofs/0.2-AI-MANIFEST.a2ml` +| 193 +| `1ca920ad7ee6fd38761c0c4b9c783e8855d66719997c4e8c363de935556355b7` +| `135e181bdb33ad26c55732e36f4a1731de53f47d` + +| `verification/safety_case/0.2-AI-MANIFEST.a2ml` +| 292 +| `05535208c8fc81dfaa4ac54dd394aafa70d2cbff1f1a9c65a1a661f971e2c53e` +| `d461915b8a1a93db9749878b4833c2908e28364b` + +| `verification/simulations/0.2-AI-MANIFEST.a2ml` +| 202 +| `121289312bd69584a180208a51c6d3d8b9ed1347d6257a06461b52810acfd357` +| `f890ecace2b8d193f19902872e8a8b629b02a339` + +| `verification/tests/0.2-AI-MANIFEST.a2ml` +| 31 +| `0f89582da96de1f765583999e8f8020e7ce2f96ba3a66feba6d55190670f48a6` +| `0008fcfaf28d6f8cf4c65c0f0ca5e2542f166a09` + +| `verification/traceability/0.2-AI-MANIFEST.a2ml` +| 294 +| `9634abe63221a8c456d10749ee2dd8d559e8e813f3b9aeed34076be683700763` +| `966776651b42a3fdea4191028eb00770b9f5caf3` +|=== + +== Retained, with the reason + +Three `.a2ml` files stay. Each is registry data with a live reader, and each +needs its own mapping spec before it can go; standards +`registry-seed-to-deed.adoc` converted only the seed (`repos.a2ml`) and says +the other two seed files wait for their own conversion. + +[cols="3,5",options="header"] +|=== +| Path | Why it stays + +| `verisim/seed/clades.a2ml` +| The served clade definitions. `sync/export-json.sh` builds +`worker/data/clades.json` from it, the Worker serves that file, and +`scripts/check-registry.sh` checks that scheme `clade-12` in the seed names +the same categories. Its conversion needs its own mapping spec. + +| `verisim/seed/forges.a2ml` +| The registry's forge accounts (GitHub primary; GitLab, Bitbucket, Codeberg +and SourceHut mirrors). Registry data, not repo metadata, and named by the +`verisim/seed/*.a2ml` whitespace-lint glob in `worker-ci.yml` and the +Justfile's `fmt` and `fmt-check`. It waits for its own conversion +(`registry-seed-to-deed.adoc`). + +| `verisim/config.a2ml` +| The VeriSimDB instance configuration of record: `worker/wrangler.toml` +times its cron against its sync interval, and +`docs/governance/RELEASE-RUNBOOK.adoc` names it as where the instance's +pointer authority, ports and auth are configured. Registry configuration +with no mapping spec. +|=== + +== Open questions for the owner + +. ECOSYSTEM's seven related-project edges use `depends-on`, `feeds-into` and + `sibling`, outside the closed `:relationship` set, so they are dropped until + the set is extended or each edge is restated in an existing term. +. META's five ADRs are keyed tables with no `id`, a shape the mapping table + does not list. A table row would let them translate. +. The anchor: A7 6.4 translates `ANCHOR.a2ml` once it is ratified into + `mappings/`. The source's values were template defaults, so the authority + and golden path need the owner's word. +. The chora deed's file name: it takes the canonical name `gv-clade-index` + from the retired `CLADE.a2ml`; it moves to `chora-registry_chora.deed` when + GitHub renames the repository, with the same `:repo-uuid`. diff --git a/docs/legal/0.2-AI-MANIFEST.a2ml b/docs/legal/0.2-AI-MANIFEST.a2ml deleted file mode 100644 index e547798..0000000 --- a/docs/legal/0.2-AI-MANIFEST.a2ml +++ /dev/null @@ -1,16 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 ---- -### [META] -id: "legal-track" -level: 2 -parent: "../0.1-AI-MANIFEST.a2ml" - ---- -### [AI_MANIFEST] -description: | - Sub-unit for legal and licensing documentation. Contains framework - exhibits and archival license texts. - -canonical_locations: - exhibits: "exhibits/" - texts: "texts/" diff --git a/docs/practice/0.2-AI-MANIFEST.a2ml b/docs/practice/0.2-AI-MANIFEST.a2ml deleted file mode 100644 index 257f3a4..0000000 --- a/docs/practice/0.2-AI-MANIFEST.a2ml +++ /dev/null @@ -1,11 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 ---- -### [META] -id: "practice-unit" -level: 2 -parent: "../0.1-AI-MANIFEST.a2ml" - ---- -### [AI_MANIFEST] -description: | - Sub-unit of the docs pillar focusing on practice. diff --git a/docs/practice/AI-CONVENTIONS.adoc b/docs/practice/AI-CONVENTIONS.adoc index 5acb8e7..0986722 100644 --- a/docs/practice/AI-CONVENTIONS.adoc +++ b/docs/practice/AI-CONVENTIONS.adoc @@ -9,13 +9,10 @@ Per-tool config files (.cursorrules, .clinerules, etc.) reference this document. ## Session Startup -1. Read `0-AI-MANIFEST.a2ml` FIRST (mandatory gatekeeper). -2. Read `.machine_readable/STATE.a2ml` for current status and blockers. -3. Read `.machine_readable/anchors/ANCHOR.a2ml` for canonical authority boundaries. -4. Read `.machine_readable/policies/MAINTENANCE-AXES.a2ml` for maintenance/audit sequencing. -5. Read `.machine_readable/policies/MAINTENANCE-CHECKLIST.a2ml` for baseline controls. -6. Read `.machine_readable/policies/SOFTWARE-DEVELOPMENT-APPROACH.a2ml` for execution order. -7. Read `.machine_readable/AGENTIC.a2ml` for agent constraints. +1. Read `0-AI-MANIFEST.deed` FIRST (the pointer-only front door). +2. Read `gv-clade-index_chora.deed` for repo facts, including the `(agentic)` permissions and integrity axioms. +3. Read `.machine_readable/descriptiles/STATE.deed` for the lifecycle status and maturity, and `ROADMAP.adoc` for blockers. +4. Read `docs/governance/TSDM.adoc`, `MAINTENANCE-CHECKLIST.adoc` and `SOFTWARE-DEVELOPMENT-APPROACH.adoc` for maintenance and audit sequencing. ## License @@ -33,10 +30,9 @@ Per-tool config files (.cursorrules, .clinerules, etc.) reference this document. ## State Files -State/metadata files, anchors, and policies (.a2ml) belong in `.machine_readable/` ONLY. -NEVER create STATE.a2ml, META.a2ml, ECOSYSTEM.a2ml, AGENTIC.a2ml, -NEUROSYM.a2ml, PLAYBOOK.a2ml, ANCHOR.a2ml, MAINTENANCE-AXES.a2ml, -MAINTENANCE-CHECKLIST.a2ml, or SOFTWARE-DEVELOPMENT-APPROACH.a2ml in the repository root. +Repo metadata is deed: `gv-clade-index_chora.deed` at the root, and descriptile +deeds (`STATE.deed` and the like) in `.machine_readable/descriptiles/` ONLY. +A2ML is retired: NEVER create a `.a2ml` file (`docs/history/A2ML-REMOVED.adoc`). ## Banned Patterns @@ -76,10 +72,7 @@ Use `just` (Justfile) for all build, test, lint, and format tasks. ## References -- `0-AI-MANIFEST.a2ml` -- universal AI entry point -- `.machine_readable/AGENTIC.a2ml` -- agent permissions and constraints -- `.machine_readable/STATE.a2ml` -- current project state -- `.machine_readable/anchors/ANCHOR.a2ml` -- canonical authority and policy boundary -- `.machine_readable/policies/MAINTENANCE-AXES.a2ml` -- canonical axis sequencing and audit requirements -- `.machine_readable/policies/MAINTENANCE-CHECKLIST.a2ml` -- baseline maintenance checklist policy -- `.machine_readable/policies/SOFTWARE-DEVELOPMENT-APPROACH.a2ml` -- axis execution approach policy +- `0-AI-MANIFEST.deed` -- universal AI entry point (pointer-only) +- `gv-clade-index_chora.deed` -- repo facts, agent permissions and integrity axioms +- `.machine_readable/descriptiles/STATE.deed` -- lifecycle status and maturity +- `docs/governance/TSDM.adoc` -- axis sequencing and audit requirements diff --git a/docs/reports/0.2-AI-MANIFEST.a2ml b/docs/reports/0.2-AI-MANIFEST.a2ml deleted file mode 100644 index 5eb265d..0000000 --- a/docs/reports/0.2-AI-MANIFEST.a2ml +++ /dev/null @@ -1,19 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 ---- -### [META] -id: "reports-unit" -level: 2 -parent: "../0.1-AI-MANIFEST.a2ml" - ---- -### [AI_MANIFEST] -description: | - Documentation unit for all automated and manual audit reports. Classified - by domain. - -canonical_locations: - maintenance: "maintenance/" - security: "security/" - performance: "performance/" - compliance: "compliance/" - quality: "quality/" diff --git a/docs/reports/README.adoc b/docs/reports/README.adoc index a2a223f..416f67d 100644 --- a/docs/reports/README.adoc +++ b/docs/reports/README.adoc @@ -2,5 +2,5 @@ [NOTE] ==== -*Planned - not yet written.* RSR scaffold slot reserved for future content; intentionally empty for now. See `.machine_readable/6a2/STATE.a2ml` for roadmap status. +*Planned - not yet written.* RSR scaffold slot reserved for future content; intentionally empty for now. See `ROADMAP.adoc` for roadmap status. ==== diff --git a/docs/reports/compliance/0.3-AI-MANIFEST.a2ml b/docs/reports/compliance/0.3-AI-MANIFEST.a2ml deleted file mode 100644 index 6b39752..0000000 --- a/docs/reports/compliance/0.3-AI-MANIFEST.a2ml +++ /dev/null @@ -1,11 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 ---- -### [META] -id: "report-unit-compliance" -level: 3 -parent: "../0.2-AI-MANIFEST.a2ml" - ---- -### [AI_MANIFEST] -description: | - Specialised repository for compliance findings and evidence. diff --git a/docs/reports/compliance/README.adoc b/docs/reports/compliance/README.adoc index f93713b..294a367 100644 --- a/docs/reports/compliance/README.adoc +++ b/docs/reports/compliance/README.adoc @@ -2,5 +2,5 @@ [NOTE] ==== -*Planned - not yet written.* RSR scaffold slot reserved for future content; intentionally empty for now. See `.machine_readable/6a2/STATE.a2ml` for roadmap status. +*Planned - not yet written.* RSR scaffold slot reserved for future content; intentionally empty for now. See `ROADMAP.adoc` for roadmap status. ==== diff --git a/docs/reports/maintenance/0.3-AI-MANIFEST.a2ml b/docs/reports/maintenance/0.3-AI-MANIFEST.a2ml deleted file mode 100644 index 43eefe2..0000000 --- a/docs/reports/maintenance/0.3-AI-MANIFEST.a2ml +++ /dev/null @@ -1,11 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 ---- -### [META] -id: "report-unit-maintenance" -level: 3 -parent: "../0.2-AI-MANIFEST.a2ml" - ---- -### [AI_MANIFEST] -description: | - Maintenance reports. diff --git a/docs/reports/maintenance/README.adoc b/docs/reports/maintenance/README.adoc index 24d3f3a..4136ee0 100644 --- a/docs/reports/maintenance/README.adoc +++ b/docs/reports/maintenance/README.adoc @@ -2,5 +2,5 @@ [NOTE] ==== -*Planned - not yet written.* RSR scaffold slot reserved for future content; intentionally empty for now. See `.machine_readable/6a2/STATE.a2ml` for roadmap status. +*Planned - not yet written.* RSR scaffold slot reserved for future content; intentionally empty for now. See `ROADMAP.adoc` for roadmap status. ==== diff --git a/docs/reports/performance/0.3-AI-MANIFEST.a2ml b/docs/reports/performance/0.3-AI-MANIFEST.a2ml deleted file mode 100644 index 40c0954..0000000 --- a/docs/reports/performance/0.3-AI-MANIFEST.a2ml +++ /dev/null @@ -1,11 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 ---- -### [META] -id: "report-unit-performance" -level: 3 -parent: "../0.2-AI-MANIFEST.a2ml" - ---- -### [AI_MANIFEST] -description: | - Specialised repository for performance findings and evidence. diff --git a/docs/reports/performance/README.adoc b/docs/reports/performance/README.adoc index 81eb111..78ca901 100644 --- a/docs/reports/performance/README.adoc +++ b/docs/reports/performance/README.adoc @@ -2,5 +2,5 @@ [NOTE] ==== -*Planned - not yet written.* RSR scaffold slot reserved for future content; intentionally empty for now. See `.machine_readable/6a2/STATE.a2ml` for roadmap status. +*Planned - not yet written.* RSR scaffold slot reserved for future content; intentionally empty for now. See `ROADMAP.adoc` for roadmap status. ==== diff --git a/docs/reports/quality/0.3-AI-MANIFEST.a2ml b/docs/reports/quality/0.3-AI-MANIFEST.a2ml deleted file mode 100644 index d460edc..0000000 --- a/docs/reports/quality/0.3-AI-MANIFEST.a2ml +++ /dev/null @@ -1,11 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 ---- -### [META] -id: "report-unit-quality" -level: 3 -parent: "../0.2-AI-MANIFEST.a2ml" - ---- -### [AI_MANIFEST] -description: | - Specialised repository for quality findings and evidence. diff --git a/docs/reports/quality/README.adoc b/docs/reports/quality/README.adoc index d617c1a..568197b 100644 --- a/docs/reports/quality/README.adoc +++ b/docs/reports/quality/README.adoc @@ -2,5 +2,5 @@ [NOTE] ==== -*Planned - not yet written.* RSR scaffold slot reserved for future content; intentionally empty for now. See `.machine_readable/6a2/STATE.a2ml` for roadmap status. +*Planned - not yet written.* RSR scaffold slot reserved for future content; intentionally empty for now. See `ROADMAP.adoc` for roadmap status. ==== diff --git a/docs/reports/security/0.3-AI-MANIFEST.a2ml b/docs/reports/security/0.3-AI-MANIFEST.a2ml deleted file mode 100644 index 696ab59..0000000 --- a/docs/reports/security/0.3-AI-MANIFEST.a2ml +++ /dev/null @@ -1,11 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 ---- -### [META] -id: "report-unit-security" -level: 3 -parent: "../0.2-AI-MANIFEST.a2ml" - ---- -### [AI_MANIFEST] -description: | - Specialised repository for security findings and evidence. diff --git a/docs/reports/security/README.adoc b/docs/reports/security/README.adoc index 14e76dc..d3bc260 100644 --- a/docs/reports/security/README.adoc +++ b/docs/reports/security/README.adoc @@ -2,5 +2,5 @@ [NOTE] ==== -*Planned - not yet written.* RSR scaffold slot reserved for future content; intentionally empty for now. See `.machine_readable/6a2/STATE.a2ml` for roadmap status. +*Planned - not yet written.* RSR scaffold slot reserved for future content; intentionally empty for now. See `ROADMAP.adoc` for roadmap status. ==== diff --git a/docs/standards/0.2-AI-MANIFEST.a2ml b/docs/standards/0.2-AI-MANIFEST.a2ml deleted file mode 100644 index c147c6f..0000000 --- a/docs/standards/0.2-AI-MANIFEST.a2ml +++ /dev/null @@ -1,11 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 ---- -### [META] -id: "standards-unit" -level: 2 -parent: "../0.1-AI-MANIFEST.a2ml" - ---- -### [AI_MANIFEST] -description: | - Standards unit for high-rigor verification. diff --git a/docs/standards/README.adoc b/docs/standards/README.adoc index 714d05e..f545e95 100644 --- a/docs/standards/README.adoc +++ b/docs/standards/README.adoc @@ -2,5 +2,5 @@ [NOTE] ==== -*Planned - not yet written.* RSR scaffold slot reserved for future content; intentionally empty for now. See `.machine_readable/6a2/STATE.a2ml` for roadmap status. +*Planned - not yet written.* RSR scaffold slot reserved for future content; intentionally empty for now. See `ROADMAP.adoc` for roadmap status. ==== diff --git a/docs/templates/contractiles/dust/Dustfile.a2ml b/docs/templates/contractiles/dust/Dustfile.a2ml deleted file mode 100644 index 903af2c..0000000 --- a/docs/templates/contractiles/dust/Dustfile.a2ml +++ /dev/null @@ -1,11 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 -# Dustfile.a2ml — BLANK TEMPLATE -# Replace this with your project's contractile. -# See .machine_readable/contractiles/ for a working example. -# -# Copy this file to .machine_readable/contractiles/dust/Dustfile.a2ml -# and fill in your project-specific checks. - -@abstract: -[Your project's DUST contract goes here] -@end diff --git a/docs/templates/contractiles/must/Mustfile.a2ml b/docs/templates/contractiles/must/Mustfile.a2ml deleted file mode 100644 index d08796f..0000000 --- a/docs/templates/contractiles/must/Mustfile.a2ml +++ /dev/null @@ -1,11 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 -# Mustfile.a2ml — BLANK TEMPLATE -# Replace this with your project's contractile. -# See .machine_readable/contractiles/ for a working example. -# -# Copy this file to .machine_readable/contractiles/must/Mustfile.a2ml -# and fill in your project-specific checks. - -@abstract: -[Your project's MUST contract goes here] -@end diff --git a/docs/templates/contractiles/trust/Trustfile.a2ml b/docs/templates/contractiles/trust/Trustfile.a2ml deleted file mode 100644 index 842c6b0..0000000 --- a/docs/templates/contractiles/trust/Trustfile.a2ml +++ /dev/null @@ -1,11 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 -# Trustfile.a2ml — BLANK TEMPLATE -# Replace this with your project's contractile. -# See .machine_readable/contractiles/ for a working example. -# -# Copy this file to .machine_readable/contractiles/trust/Trustfile.a2ml -# and fill in your project-specific checks. - -@abstract: -[Your project's TRUST contract goes here] -@end diff --git a/docs/theory/0.2-AI-MANIFEST.a2ml b/docs/theory/0.2-AI-MANIFEST.a2ml deleted file mode 100644 index 93df187..0000000 --- a/docs/theory/0.2-AI-MANIFEST.a2ml +++ /dev/null @@ -1,23 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 ---- -### [META] -id: "theory-track" -level: 2 -parent: "../0.1-AI-MANIFEST.a2ml" - ---- -### [AI_MANIFEST] -description: | - Documentation track for domain-specific theory and research foundations. - Categorised by discipline. - -canonical_locations: - ontologies: "ontologies/" - mathematics: "mathematics/" - computing: "computing/" - socio_technical: "socio-technical/" - formalisms: "formalisms/" - other: "other/" - -invariants: - - "Theoretical claims MUST reference established academic or technical formalisms" diff --git a/docs/theory/README.adoc b/docs/theory/README.adoc index ec83a0f..ec6803b 100644 --- a/docs/theory/README.adoc +++ b/docs/theory/README.adoc @@ -2,5 +2,5 @@ [NOTE] ==== -*Planned - not yet written.* RSR scaffold slot reserved for future content; intentionally empty for now. See `.machine_readable/6a2/STATE.a2ml` for roadmap status. +*Planned - not yet written.* RSR scaffold slot reserved for future content; intentionally empty for now. See `ROADMAP.adoc` for roadmap status. ==== diff --git a/docs/theory/computing/0.3-AI-MANIFEST.a2ml b/docs/theory/computing/0.3-AI-MANIFEST.a2ml deleted file mode 100644 index f387d08..0000000 --- a/docs/theory/computing/0.3-AI-MANIFEST.a2ml +++ /dev/null @@ -1,11 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 ---- -### [META] -id: "theory-unit-computing" -level: 3 -parent: "../0.2-AI-MANIFEST.a2ml" - ---- -### [AI_MANIFEST] -description: | - Theoretical foundation for computing. diff --git a/docs/theory/computing/README.adoc b/docs/theory/computing/README.adoc index 8615fb8..e4b98ca 100644 --- a/docs/theory/computing/README.adoc +++ b/docs/theory/computing/README.adoc @@ -2,5 +2,5 @@ [NOTE] ==== -*Planned - not yet written.* RSR scaffold slot reserved for future content; intentionally empty for now. See `.machine_readable/6a2/STATE.a2ml` for roadmap status. +*Planned - not yet written.* RSR scaffold slot reserved for future content; intentionally empty for now. See `ROADMAP.adoc` for roadmap status. ==== diff --git a/docs/theory/formalisms/0.3-AI-MANIFEST.a2ml b/docs/theory/formalisms/0.3-AI-MANIFEST.a2ml deleted file mode 100644 index cdc2baa..0000000 --- a/docs/theory/formalisms/0.3-AI-MANIFEST.a2ml +++ /dev/null @@ -1,11 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 ---- -### [META] -id: "theory-unit-formalisms" -level: 3 -parent: "../0.2-AI-MANIFEST.a2ml" - ---- -### [AI_MANIFEST] -description: | - Theoretical foundation for formalisms. diff --git a/docs/theory/formalisms/README.adoc b/docs/theory/formalisms/README.adoc index 156e011..9d5c2d2 100644 --- a/docs/theory/formalisms/README.adoc +++ b/docs/theory/formalisms/README.adoc @@ -2,5 +2,5 @@ [NOTE] ==== -*Planned - not yet written.* RSR scaffold slot reserved for future content; intentionally empty for now. See `.machine_readable/6a2/STATE.a2ml` for roadmap status. +*Planned - not yet written.* RSR scaffold slot reserved for future content; intentionally empty for now. See `ROADMAP.adoc` for roadmap status. ==== diff --git a/docs/theory/mathematics/0.3-AI-MANIFEST.a2ml b/docs/theory/mathematics/0.3-AI-MANIFEST.a2ml deleted file mode 100644 index 677a4da..0000000 --- a/docs/theory/mathematics/0.3-AI-MANIFEST.a2ml +++ /dev/null @@ -1,11 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 ---- -### [META] -id: "theory-unit-mathematics" -level: 3 -parent: "../0.2-AI-MANIFEST.a2ml" - ---- -### [AI_MANIFEST] -description: | - Theoretical foundation for mathematics. diff --git a/docs/theory/mathematics/README.adoc b/docs/theory/mathematics/README.adoc index 86b5947..4c60410 100644 --- a/docs/theory/mathematics/README.adoc +++ b/docs/theory/mathematics/README.adoc @@ -2,5 +2,5 @@ [NOTE] ==== -*Planned - not yet written.* RSR scaffold slot reserved for future content; intentionally empty for now. See `.machine_readable/6a2/STATE.a2ml` for roadmap status. +*Planned - not yet written.* RSR scaffold slot reserved for future content; intentionally empty for now. See `ROADMAP.adoc` for roadmap status. ==== diff --git a/docs/theory/ontologies/0.3-AI-MANIFEST.a2ml b/docs/theory/ontologies/0.3-AI-MANIFEST.a2ml deleted file mode 100644 index d888cee..0000000 --- a/docs/theory/ontologies/0.3-AI-MANIFEST.a2ml +++ /dev/null @@ -1,11 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 ---- -### [META] -id: "theory-unit-ontologies" -level: 3 -parent: "../0.2-AI-MANIFEST.a2ml" - ---- -### [AI_MANIFEST] -description: | - Theoretical foundation for ontologies. diff --git a/docs/theory/ontologies/README.adoc b/docs/theory/ontologies/README.adoc index 3cae87e..e4f783c 100644 --- a/docs/theory/ontologies/README.adoc +++ b/docs/theory/ontologies/README.adoc @@ -2,5 +2,5 @@ [NOTE] ==== -*Planned - not yet written.* RSR scaffold slot reserved for future content; intentionally empty for now. See `.machine_readable/6a2/STATE.a2ml` for roadmap status. +*Planned - not yet written.* RSR scaffold slot reserved for future content; intentionally empty for now. See `ROADMAP.adoc` for roadmap status. ==== diff --git a/docs/theory/other/0.3-AI-MANIFEST.a2ml b/docs/theory/other/0.3-AI-MANIFEST.a2ml deleted file mode 100644 index 166ed9e..0000000 --- a/docs/theory/other/0.3-AI-MANIFEST.a2ml +++ /dev/null @@ -1,11 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 ---- -### [META] -id: "theory-unit-other" -level: 3 -parent: "../0.2-AI-MANIFEST.a2ml" - ---- -### [AI_MANIFEST] -description: | - Theoretical foundation for other. diff --git a/docs/theory/other/README.adoc b/docs/theory/other/README.adoc index 3068f4c..943ee75 100644 --- a/docs/theory/other/README.adoc +++ b/docs/theory/other/README.adoc @@ -2,5 +2,5 @@ [NOTE] ==== -*Planned - not yet written.* RSR scaffold slot reserved for future content; intentionally empty for now. See `.machine_readable/6a2/STATE.a2ml` for roadmap status. +*Planned - not yet written.* RSR scaffold slot reserved for future content; intentionally empty for now. See `ROADMAP.adoc` for roadmap status. ==== diff --git a/docs/theory/socio-technical/0.3-AI-MANIFEST.a2ml b/docs/theory/socio-technical/0.3-AI-MANIFEST.a2ml deleted file mode 100644 index 8919522..0000000 --- a/docs/theory/socio-technical/0.3-AI-MANIFEST.a2ml +++ /dev/null @@ -1,11 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 ---- -### [META] -id: "theory-unit-socio-technical" -level: 3 -parent: "../0.2-AI-MANIFEST.a2ml" - ---- -### [AI_MANIFEST] -description: | - Theoretical foundation for socio technical. diff --git a/docs/theory/socio-technical/README.adoc b/docs/theory/socio-technical/README.adoc index 4ffb8f2..90d0c03 100644 --- a/docs/theory/socio-technical/README.adoc +++ b/docs/theory/socio-technical/README.adoc @@ -2,5 +2,5 @@ [NOTE] ==== -*Planned - not yet written.* RSR scaffold slot reserved for future content; intentionally empty for now. See `.machine_readable/6a2/STATE.a2ml` for roadmap status. +*Planned - not yet written.* RSR scaffold slot reserved for future content; intentionally empty for now. See `ROADMAP.adoc` for roadmap status. ==== diff --git a/docs/whitepapers/0.2-AI-MANIFEST.a2ml b/docs/whitepapers/0.2-AI-MANIFEST.a2ml deleted file mode 100644 index c936101..0000000 --- a/docs/whitepapers/0.2-AI-MANIFEST.a2ml +++ /dev/null @@ -1,20 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 ---- -### [META] -id: "whitepapers-track" -level: 2 -parent: "../0.1-AI-MANIFEST.a2ml" - ---- -### [AI_MANIFEST] -description: | - Unit for strategic publications and whitepapers. Categorised by target - audience: Academic, Industry, and Outreach. - -canonical_locations: - academic: "academic/" - industry: "industry/" - outreach: "outreach/" - -invariants: - - "Each sub-track MUST have a clear audience definition in its README" diff --git a/docs/whitepapers/README.adoc b/docs/whitepapers/README.adoc index 8f292cc..1a0896c 100644 --- a/docs/whitepapers/README.adoc +++ b/docs/whitepapers/README.adoc @@ -2,5 +2,5 @@ [NOTE] ==== -*Planned - not yet written.* RSR scaffold slot reserved for future content; intentionally empty for now. See `.machine_readable/6a2/STATE.a2ml` for roadmap status. +*Planned - not yet written.* RSR scaffold slot reserved for future content; intentionally empty for now. See `ROADMAP.adoc` for roadmap status. ==== diff --git a/docs/whitepapers/academic/0.3-AI-MANIFEST.a2ml b/docs/whitepapers/academic/0.3-AI-MANIFEST.a2ml deleted file mode 100644 index ceb8a1e..0000000 --- a/docs/whitepapers/academic/0.3-AI-MANIFEST.a2ml +++ /dev/null @@ -1,11 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 ---- -### [META] -id: "academic-unit" -level: 3 -parent: "../0.2-AI-MANIFEST.a2ml" - ---- -### [AI_MANIFEST] -description: | - Academic logic at level 3. diff --git a/docs/whitepapers/academic/README.adoc b/docs/whitepapers/academic/README.adoc index a61dfc7..9303734 100644 --- a/docs/whitepapers/academic/README.adoc +++ b/docs/whitepapers/academic/README.adoc @@ -2,5 +2,5 @@ [NOTE] ==== -*Planned - not yet written.* RSR scaffold slot reserved for future content; intentionally empty for now. See `.machine_readable/6a2/STATE.a2ml` for roadmap status. +*Planned - not yet written.* RSR scaffold slot reserved for future content; intentionally empty for now. See `ROADMAP.adoc` for roadmap status. ==== diff --git a/docs/whitepapers/industry/0.3-AI-MANIFEST.a2ml b/docs/whitepapers/industry/0.3-AI-MANIFEST.a2ml deleted file mode 100644 index 20156dd..0000000 --- a/docs/whitepapers/industry/0.3-AI-MANIFEST.a2ml +++ /dev/null @@ -1,11 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 ---- -### [META] -id: "industry-unit" -level: 3 -parent: "../0.2-AI-MANIFEST.a2ml" - ---- -### [AI_MANIFEST] -description: | - Industry logic at level 3. diff --git a/docs/whitepapers/industry/README.adoc b/docs/whitepapers/industry/README.adoc index 9ff738e..2ddca26 100644 --- a/docs/whitepapers/industry/README.adoc +++ b/docs/whitepapers/industry/README.adoc @@ -2,5 +2,5 @@ [NOTE] ==== -*Planned - not yet written.* RSR scaffold slot reserved for future content; intentionally empty for now. See `.machine_readable/6a2/STATE.a2ml` for roadmap status. +*Planned - not yet written.* RSR scaffold slot reserved for future content; intentionally empty for now. See `ROADMAP.adoc` for roadmap status. ==== diff --git a/docs/whitepapers/outreach/0.3-AI-MANIFEST.a2ml b/docs/whitepapers/outreach/0.3-AI-MANIFEST.a2ml deleted file mode 100644 index ed7e152..0000000 --- a/docs/whitepapers/outreach/0.3-AI-MANIFEST.a2ml +++ /dev/null @@ -1,16 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 ---- -### [META] -id: "whitepapers-track-outreach" -level: 3 -parent: "../0.2-AI-MANIFEST.a2ml" - ---- -### [AI_MANIFEST] -description: | - Documentation track for outreach, education, and general-audience - engagement. Focuses on accessibility and high-level conceptual clarity. - -invariants: - - "Language MUST be accessible to non-technical audiences" - - "Avoid deep technical jargon without providing clear definitions" diff --git a/docs/wikis/0.2-AI-MANIFEST.a2ml b/docs/wikis/0.2-AI-MANIFEST.a2ml deleted file mode 100644 index f071ca8..0000000 --- a/docs/wikis/0.2-AI-MANIFEST.a2ml +++ /dev/null @@ -1,15 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 ---- -### [META] -id: "wikis-track" -level: 2 -parent: "../0.1-AI-MANIFEST.a2ml" - ---- -### [AI_MANIFEST] -description: | - Long-form collaborative documentation and project knowledge base. - This directory mirrors the content structure of the project wiki. - -invariants: - - "Primary wiki format MUST be AsciiDoc (.adoc)" diff --git a/docs/wikis/Glossary.adoc b/docs/wikis/Glossary.adoc index a66a612..cc343f3 100644 --- a/docs/wikis/Glossary.adoc +++ b/docs/wikis/Glossary.adoc @@ -18,7 +18,9 @@ Lineage:: A repo's structural history — standalone, monorepo, monorepo-child, inflated, or deflated. Contractile:: A machine-readable policy contract (e.g. `must`, `trust`, `dust`, `bust`) under `.machine_readable/contractiles/`. -CLADE.a2ml:: The per-repo clade declaration; clade-hygiene rules CLADE-001..003. +CLADE.a2ml:: The retired per-repo clade declaration (A2ML is retired). A repo's + clade placement is now the `(clade …)` clause of its chora deed, checked + against this registry's scheme `clade-12`. VeriSimDB:: The backing database (Rust + Elixir) that holds the registry. VCL:: The VeriSim schema/query language (`verisim/schema/`, `verisim/queries/`). KV snapshot:: The edge cache the Worker serves public reads from. diff --git a/examples/0.1-AI-MANIFEST.a2ml b/examples/0.1-AI-MANIFEST.a2ml deleted file mode 100644 index 0d69c90..0000000 --- a/examples/0.1-AI-MANIFEST.a2ml +++ /dev/null @@ -1 +0,0 @@ -# AI Manifest - Level 1: examples diff --git a/features/0.1-AI-MANIFEST.a2ml b/features/0.1-AI-MANIFEST.a2ml deleted file mode 100644 index dc3e4ee..0000000 --- a/features/0.1-AI-MANIFEST.a2ml +++ /dev/null @@ -1,17 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 ---- -### [META] -id: "features-pillar" -level: 1 -parent: "../0-AI-MANIFEST.a2ml" - ---- -### [AI_MANIFEST] -description: | - Optional project features and ecosystem integrations. Provides bootstrap - guides for high-rigor tools (Panic-Attacker, BoJ-Server, SSGs). - -canonical_locations: - panic_attacker: "panic-attacker/" - boj_server: "boj-server/" - ssg: "ssg/" diff --git a/features/boj-server/0.2-AI-MANIFEST.a2ml b/features/boj-server/0.2-AI-MANIFEST.a2ml deleted file mode 100644 index c77798c..0000000 --- a/features/boj-server/0.2-AI-MANIFEST.a2ml +++ /dev/null @@ -1,11 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 ---- -### [META] -id: "feature-unit-boj-server" -level: 2 -parent: "../0.1-AI-MANIFEST.a2ml" - ---- -### [AI_MANIFEST] -description: | - Bootstrap and integration logic for the boj-server ecosystem component. diff --git a/features/panic-attacker/0.2-AI-MANIFEST.a2ml b/features/panic-attacker/0.2-AI-MANIFEST.a2ml deleted file mode 100644 index e61ad24..0000000 --- a/features/panic-attacker/0.2-AI-MANIFEST.a2ml +++ /dev/null @@ -1,11 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 ---- -### [META] -id: "feature-unit-panic-attacker" -level: 2 -parent: "../0.1-AI-MANIFEST.a2ml" - ---- -### [AI_MANIFEST] -description: | - Bootstrap and integration logic for the panic-attacker ecosystem component. diff --git a/features/ssg/0.2-AI-MANIFEST.a2ml b/features/ssg/0.2-AI-MANIFEST.a2ml deleted file mode 100644 index 121c5ae..0000000 --- a/features/ssg/0.2-AI-MANIFEST.a2ml +++ /dev/null @@ -1,11 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 ---- -### [META] -id: "feature-unit-ssg" -level: 2 -parent: "../0.1-AI-MANIFEST.a2ml" - ---- -### [AI_MANIFEST] -description: | - Bootstrap and integration logic for the ssg ecosystem component. diff --git a/gv-clade-index_chora.deed b/gv-clade-index_chora.deed new file mode 100644 index 0000000..c37b017 --- /dev/null +++ b/gv-clade-index_chora.deed @@ -0,0 +1,87 @@ +;; SPDX-License-Identifier: MPL-2.0 +;; SPDX-FileCopyrightText: 2026 Jonathan D.A. Jewell (hyperpolymath) +;; +;; The repo deed of gv-clade-index, the chora-registry (one deed per repo, +;; D312). The file takes the canonical name the retired CLADE.a2ml held and +;; GitHub still uses; when the repository is renamed to chora-registry the file +;; is renamed with it and its :repo-uuid does not change (U1, U4). +;; +;; Every clause below is translated field for field from a retired A2ML +;; descriptile under the mapping spec that governs its family, in standards +;; 1-formats/deed/mappings/ (the only authority a family translation may cite). +;; A field a table does not list does not translate: it was dropped, not +;; re-homed. docs/history/A2ML-REMOVED.adoc records each removed file, its git +;; blob id and what was dropped from it. +;; +;; CLADE.a2ml -> (identity) (clade) (forges) (lineage) +;; clade-to-repo-deed.adoc. Its [status] rows went to +;; .machine_readable/descriptiles/STATE.deed (A7 J15), as +;; that spec now directs. :repo-uuid is this repo's v8 id +;; as chora-registry holds it (verisim/seed/ +;; chora-registry_praxis.deed, :minted-in gv-clade-index), +;; written as the opaque #uuid (U4); it is not the v5 +;; that CLADE.a2ml held. Nothing was minted or reminted. +;; :beholding-chora is the hyperpolymath estate chora, as +;; the seed records it. +;; AGENTIC.a2ml -> (agentic) agentic-neurosym-playbook-to-repo-deed.adoc +;; NEUROSYM.a2ml -> (neurosym) agentic-neurosym-playbook-to-repo-deed.adoc +;; PLAYBOOK.a2ml -> (playbook) agentic-neurosym-playbook-to-repo-deed.adoc +;; STATE.a2ml -> (maturity) in STATE.deed, state-v1-decision.adoc +;; option B; the journal is archived, not translated. +;; META.a2ml, ECOSYSTEM.a2ml: no clause. Their sections are shapes the +;; meta-ecosystem-to-repo-deed.adoc tables do not list, so +;; nothing translated (P-2a); the ledger names each field. +(repo-deed + :schema-version "1.0.0" + :canonical-name "gv-clade-index" + :repo-uuid #uuid"a65b74d8-351a-89d9-a38d-aea470863b03" + :beholding-chora #uuid"0889b37b-defb-831f-973c-e119500db00e" + (identity :owner "hyperpolymath" :primary-forge github :prefixed-name "gv-clade-index") + (clade + :primary gv + :secondary (db) + :assigned "2026-03-16" + :rationale "This is a governance registry backed by a database; governance is the primary purpose") + (forges + :github "hyperpolymath/gv-clade-index" + :gitlab "hyperpolymath/gv-clade-index" + :bitbucket "hyperpolymath/gv-clade-index") + ; [lineage] had no previous-names or instantiated-from, so neither is emitted. + (lineage + :type standalone + :parent "" + :born "2026-03-16") + ; AGENTIC.a2ml: [metadata] version and last-updated, [agent-permissions] + ; and the five [maintenance-integrity] axioms. The source has no @profile + ; line, so there is no (profile). Not translated: [agent-constraints] and + ; [automation-hooks], which carry their content only as comments: template + ; canon under D4-1 (the on-commit hook is the template's `just validate-rsr`, + ; so the block does not diverge, and every hook named a retired .a2ml file). + (agentic + :version "0.1.0" + :last-updated "2026-04-11" + (permissions :source #t :tests #t :docs #t :config #t :create-files #t) + (integrity + :fail-closed #t + :require-evidence-per-step #t + :allow-silent-skip #f + :require-rerun-after-fix #t + :release-claim-requires-hard-pass #t)) + ; NEUROSYM.a2ml: [metadata] version and last-updated, [hypatia-config] + ; scan-enabled, scan-depth and report-format. [symbolic-rules] and + ; [neural-config] held only comments, so they are dropped as unpopulated. + (neurosym + :version "0.1.0" + :last-updated "2026-04-11" + (hypatia :scan-enabled #t :scan-depth standard :report-format "logtalk")) + ; PLAYBOOK.a2ml: [metadata] version and last-updated, and its four + ; operational sections kept as positions (the family-1 slot doctrine). The + ; source had no [docs-format] section, so none is emitted. The sections held + ; only comments, so no content translated. + (playbook + :version "0.1.0" + :last-updated "2026-04-11" + (deployment) + (incident-response) + (release-process) + (maintenance-operations))) diff --git a/src/0.1-AI-MANIFEST.a2ml b/src/0.1-AI-MANIFEST.a2ml deleted file mode 100644 index c92e124..0000000 --- a/src/0.1-AI-MANIFEST.a2ml +++ /dev/null @@ -1,27 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 ---- -### [META] -id: "source-pillar" -level: 1 -parent: "../0-AI-MANIFEST.a2ml" - ---- -### [AI_MANIFEST] -description: | - Primary source code directory. Organized by role and architectural - aspect. - -canonical_locations: - core: "core/" - interface: "interface/" - bridges: "bridges/" - contracts: "contracts/" - errors: "errors/" - definitions: "definitions/" - aspects: "aspects/" - -invariants: - - "Core logic MUST reside in core/" - - "Verified seams MUST reside in interface/" - - "Safety constraints MUST reside in contracts/" - - "Failure dictionaries MUST reside in errors/" diff --git a/src/aspects/0.2-AI-MANIFEST.a2ml b/src/aspects/0.2-AI-MANIFEST.a2ml deleted file mode 100644 index 3d5b209..0000000 --- a/src/aspects/0.2-AI-MANIFEST.a2ml +++ /dev/null @@ -1,17 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 ---- -### [META] -id: "source-unit-aspects" -level: 2 -parent: "../0.1-AI-MANIFEST.a2ml" - ---- -### [AI_MANIFEST] -description: | - Cross-cutting concerns and domain-specific aspects (Security, - Observability, Integrity). - -canonical_locations: - security: "security/" - observability: "observability/" - integrity: "integrity/" diff --git a/src/aspects/integrity/0.3-AI-MANIFEST.a2ml b/src/aspects/integrity/0.3-AI-MANIFEST.a2ml deleted file mode 100644 index f114cbd..0000000 --- a/src/aspects/integrity/0.3-AI-MANIFEST.a2ml +++ /dev/null @@ -1,11 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 ---- -### [META] -id: "aspect-unit-integrity" -level: 3 -parent: "../0.2-AI-MANIFEST.a2ml" - ---- -### [AI_MANIFEST] -description: | - Implementation logic for the integrity aspect. diff --git a/src/aspects/observability/0.3-AI-MANIFEST.a2ml b/src/aspects/observability/0.3-AI-MANIFEST.a2ml deleted file mode 100644 index e16cbdf..0000000 --- a/src/aspects/observability/0.3-AI-MANIFEST.a2ml +++ /dev/null @@ -1,11 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 ---- -### [META] -id: "aspect-unit-observability" -level: 3 -parent: "../0.2-AI-MANIFEST.a2ml" - ---- -### [AI_MANIFEST] -description: | - Implementation logic for the observability aspect. diff --git a/src/aspects/security/0.3-AI-MANIFEST.a2ml b/src/aspects/security/0.3-AI-MANIFEST.a2ml deleted file mode 100644 index 0996536..0000000 --- a/src/aspects/security/0.3-AI-MANIFEST.a2ml +++ /dev/null @@ -1,11 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 ---- -### [META] -id: "aspect-unit-security" -level: 3 -parent: "../0.2-AI-MANIFEST.a2ml" - ---- -### [AI_MANIFEST] -description: | - Implementation logic for the security aspect. diff --git a/src/bridges/0.2-AI-MANIFEST.a2ml b/src/bridges/0.2-AI-MANIFEST.a2ml deleted file mode 100644 index 3d3e27a..0000000 --- a/src/bridges/0.2-AI-MANIFEST.a2ml +++ /dev/null @@ -1,11 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 ---- -### [META] -id: "source-unit-bridges" -level: 2 -parent: "../0.1-AI-MANIFEST.a2ml" - ---- -### [AI_MANIFEST] -description: | - Integration logic for external systems (API, Database, RPC, etc.). diff --git a/src/contracts/0.2-AI-MANIFEST.a2ml b/src/contracts/0.2-AI-MANIFEST.a2ml deleted file mode 100644 index 0bd9198..0000000 --- a/src/contracts/0.2-AI-MANIFEST.a2ml +++ /dev/null @@ -1,11 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 ---- -### [META] -id: "source-unit-contracts" -level: 2 -parent: "../0.1-AI-MANIFEST.a2ml" - ---- -### [AI_MANIFEST] -description: | - Contracts unit for high-rigor source code. diff --git a/src/core/0.2-AI-MANIFEST.a2ml b/src/core/0.2-AI-MANIFEST.a2ml deleted file mode 100644 index 22846c7..0000000 --- a/src/core/0.2-AI-MANIFEST.a2ml +++ /dev/null @@ -1,11 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 ---- -### [META] -id: "source-unit-core" -level: 2 -parent: "../0.1-AI-MANIFEST.a2ml" - ---- -### [AI_MANIFEST] -description: | - Primary application logic and core domain models. diff --git a/src/definitions/0.2-AI-MANIFEST.a2ml b/src/definitions/0.2-AI-MANIFEST.a2ml deleted file mode 100644 index e54f4da..0000000 --- a/src/definitions/0.2-AI-MANIFEST.a2ml +++ /dev/null @@ -1,11 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 ---- -### [META] -id: "source-unit-definitions" -level: 2 -parent: "../0.1-AI-MANIFEST.a2ml" - ---- -### [AI_MANIFEST] -description: | - Definitions unit for high-rigor source code. diff --git a/src/errors/0.2-AI-MANIFEST.a2ml b/src/errors/0.2-AI-MANIFEST.a2ml deleted file mode 100644 index dddcc6c..0000000 --- a/src/errors/0.2-AI-MANIFEST.a2ml +++ /dev/null @@ -1,11 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 ---- -### [META] -id: "source-unit-errors" -level: 2 -parent: "../0.1-AI-MANIFEST.a2ml" - ---- -### [AI_MANIFEST] -description: | - Errors unit for high-rigor source code. diff --git a/src/interface/0.2-AI-MANIFEST.a2ml b/src/interface/0.2-AI-MANIFEST.a2ml deleted file mode 100644 index 7f0f471..0000000 --- a/src/interface/0.2-AI-MANIFEST.a2ml +++ /dev/null @@ -1,24 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 ---- -### [META] -id: "interface-seams-unit" -level: 2 -parent: "../0.1-AI-MANIFEST.a2ml" - ---- -### [AI_MANIFEST] -description: | - Consolidated "Verified Interface Seams" unit. This directory unifies the - formal specification (ABI), the bridge implementation (FFI), and the - resulting artifacts (Generated). - -canonical_locations: - abi: "abi/" - ffi: "ffi/" - generated: "generated/" - -invariants: - - "ABI MUST be Idris2 (.idr)" - - "FFI MUST be Zig (.zig)" - - "Generated artifacts MUST be C-compatible" - - "The 'Truth' lives in abi/; the 'Implementation' lives in ffi/" diff --git a/src/interface/abi/0.3-AI-MANIFEST.a2ml b/src/interface/abi/0.3-AI-MANIFEST.a2ml deleted file mode 100644 index 91cafa0..0000000 --- a/src/interface/abi/0.3-AI-MANIFEST.a2ml +++ /dev/null @@ -1,11 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 ---- -### [META] -id: "abi-logic" -level: 3 -parent: "../0.2-AI-MANIFEST.a2ml" - ---- -### [AI_MANIFEST] -description: | - Specialised Level 3 logic for abi. diff --git a/src/interface/ffi/0.3-AI-MANIFEST.a2ml b/src/interface/ffi/0.3-AI-MANIFEST.a2ml deleted file mode 100644 index bf456ae..0000000 --- a/src/interface/ffi/0.3-AI-MANIFEST.a2ml +++ /dev/null @@ -1,11 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 ---- -### [META] -id: "ffi-logic" -level: 3 -parent: "../0.2-AI-MANIFEST.a2ml" - ---- -### [AI_MANIFEST] -description: | - Specialised Level 3 logic for ffi. diff --git a/src/interface/ffi/src/0.4-AI-MANIFEST.a2ml b/src/interface/ffi/src/0.4-AI-MANIFEST.a2ml deleted file mode 100644 index 5b5f1b1..0000000 --- a/src/interface/ffi/src/0.4-AI-MANIFEST.a2ml +++ /dev/null @@ -1,11 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 ---- -### [META] -id: "src-unit" -level: 4 -parent: "../0.3-AI-MANIFEST.a2ml" - ---- -### [AI_MANIFEST] -description: | - Src logic at level 4. diff --git a/src/interface/ffi/test/0.4-AI-MANIFEST.a2ml b/src/interface/ffi/test/0.4-AI-MANIFEST.a2ml deleted file mode 100644 index e02427f..0000000 --- a/src/interface/ffi/test/0.4-AI-MANIFEST.a2ml +++ /dev/null @@ -1,11 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 ---- -### [META] -id: "test-unit" -level: 4 -parent: "../0.3-AI-MANIFEST.a2ml" - ---- -### [AI_MANIFEST] -description: | - Test logic at level 4. diff --git a/src/interface/generated/0.3-AI-MANIFEST.a2ml b/src/interface/generated/0.3-AI-MANIFEST.a2ml deleted file mode 100644 index 0088b80..0000000 --- a/src/interface/generated/0.3-AI-MANIFEST.a2ml +++ /dev/null @@ -1,11 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 ---- -### [META] -id: "generated-logic" -level: 3 -parent: "../0.2-AI-MANIFEST.a2ml" - ---- -### [AI_MANIFEST] -description: | - Specialised Level 3 logic for generated. diff --git a/src/interface/generated/abi/0.4-AI-MANIFEST.a2ml b/src/interface/generated/abi/0.4-AI-MANIFEST.a2ml deleted file mode 100644 index 4eeb580..0000000 --- a/src/interface/generated/abi/0.4-AI-MANIFEST.a2ml +++ /dev/null @@ -1,11 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 ---- -### [META] -id: "abi-unit" -level: 4 -parent: "../0.3-AI-MANIFEST.a2ml" - ---- -### [AI_MANIFEST] -description: | - Abi logic at level 4. diff --git a/verification/0.1-AI-MANIFEST.a2ml b/verification/0.1-AI-MANIFEST.a2ml deleted file mode 100644 index 3435bdb..0000000 --- a/verification/0.1-AI-MANIFEST.a2ml +++ /dev/null @@ -1,27 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 ---- -### [META] -id: "verification-pillar" -level: 1 -parent: "../0-AI-MANIFEST.a2ml" - ---- -### [AI_MANIFEST] -description: | - Primary verification pillar. Contains evidence for correctness, - performance, formal proofs, randomized testing, and aerospace-grade - high-assurance metrics (MC/DC coverage, traceability, safety cases). - -canonical_locations: - tests: "tests/" - benchmarks: "benchmarks/" - proofs: "proofs/" - fuzzing: "fuzzing/" - simulations: "simulations/" - coverage: "coverage/" - traceability: "traceability/" - safety_case: "safety_case/" - -invariants: - - "Evidence MUST be reproducible and documented" - - "High-assurance deployments MUST satisfy traceability and safety_case requirements" diff --git a/verification/benchmarks/0.2-AI-MANIFEST.a2ml b/verification/benchmarks/0.2-AI-MANIFEST.a2ml deleted file mode 100644 index d922a4c..0000000 --- a/verification/benchmarks/0.2-AI-MANIFEST.a2ml +++ /dev/null @@ -1,11 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 ---- -### [META] -id: "benches-pillar" -level: 2 -parent: "../0.1-AI-MANIFEST.a2ml" - ---- -### [AI_MANIFEST] -description: | - Benches pillar. diff --git a/verification/coverage/0.2-AI-MANIFEST.a2ml b/verification/coverage/0.2-AI-MANIFEST.a2ml deleted file mode 100644 index 32b819e..0000000 --- a/verification/coverage/0.2-AI-MANIFEST.a2ml +++ /dev/null @@ -1,12 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 ---- -### [META] -id: "verification-unit-coverage" -level: 2 -parent: "../0.1-AI-MANIFEST.a2ml" - ---- -### [AI_MANIFEST] -description: | - High-assurance verification unit for coverage. - Critical for safety-of-life and aerospace-grade deployment standards. diff --git a/verification/fuzzing/0.2-AI-MANIFEST.a2ml b/verification/fuzzing/0.2-AI-MANIFEST.a2ml deleted file mode 100644 index 5178d40..0000000 --- a/verification/fuzzing/0.2-AI-MANIFEST.a2ml +++ /dev/null @@ -1,11 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 ---- -### [META] -id: "fuzzing-unit" -level: 2 -parent: "../0.1-AI-MANIFEST.a2ml" - ---- -### [AI_MANIFEST] -description: | - Fuzzing unit for high-rigor verification. diff --git a/verification/proofs/0.2-AI-MANIFEST.a2ml b/verification/proofs/0.2-AI-MANIFEST.a2ml deleted file mode 100644 index 135e181..0000000 --- a/verification/proofs/0.2-AI-MANIFEST.a2ml +++ /dev/null @@ -1,11 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 ---- -### [META] -id: "verification-unit-proofs" -level: 2 -parent: "../0.1-AI-MANIFEST.a2ml" - ---- -### [AI_MANIFEST] -description: | - Sub-unit focusing on proofs. diff --git a/verification/safety_case/0.2-AI-MANIFEST.a2ml b/verification/safety_case/0.2-AI-MANIFEST.a2ml deleted file mode 100644 index d461915..0000000 --- a/verification/safety_case/0.2-AI-MANIFEST.a2ml +++ /dev/null @@ -1,12 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 ---- -### [META] -id: "verification-unit-safety_case" -level: 2 -parent: "../0.1-AI-MANIFEST.a2ml" - ---- -### [AI_MANIFEST] -description: | - High-assurance verification unit for safety case. - Critical for safety-of-life and aerospace-grade deployment standards. diff --git a/verification/simulations/0.2-AI-MANIFEST.a2ml b/verification/simulations/0.2-AI-MANIFEST.a2ml deleted file mode 100644 index f890eca..0000000 --- a/verification/simulations/0.2-AI-MANIFEST.a2ml +++ /dev/null @@ -1,11 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 ---- -### [META] -id: "simulations-unit" -level: 2 -parent: "../0.1-AI-MANIFEST.a2ml" - ---- -### [AI_MANIFEST] -description: | - Simulations unit for high-rigor verification. diff --git a/verification/tests/0.2-AI-MANIFEST.a2ml b/verification/tests/0.2-AI-MANIFEST.a2ml deleted file mode 100644 index 0008fcf..0000000 --- a/verification/tests/0.2-AI-MANIFEST.a2ml +++ /dev/null @@ -1 +0,0 @@ -# AI Manifest - Level 1: tests diff --git a/verification/traceability/0.2-AI-MANIFEST.a2ml b/verification/traceability/0.2-AI-MANIFEST.a2ml deleted file mode 100644 index 9667766..0000000 --- a/verification/traceability/0.2-AI-MANIFEST.a2ml +++ /dev/null @@ -1,12 +0,0 @@ -# SPDX-License-Identifier: MPL-2.0 ---- -### [META] -id: "verification-unit-traceability" -level: 2 -parent: "../0.1-AI-MANIFEST.a2ml" - ---- -### [AI_MANIFEST] -description: | - High-assurance verification unit for traceability. - Critical for safety-of-life and aerospace-grade deployment standards. diff --git a/verification/traceability/README.adoc b/verification/traceability/README.adoc index f09644f..f6c4a81 100644 --- a/verification/traceability/README.adoc +++ b/verification/traceability/README.adoc @@ -3,5 +3,5 @@ No requirements-to-proof traceability matrix: there are no formal proofs to trace (see `../README.adoc`). Phase/requirement tracking lives in -`.machine_readable/6a2/STATE.a2ml` and `ROADMAP.adoc`; the registry's data invariants +`ROADMAP.adoc`; the registry's data invariants are traced by `worker/test/data.test.js`. diff --git a/worker/src/validate.js b/worker/src/validate.js index 42a9f6b..48fbae9 100644 --- a/worker/src/validate.js +++ b/worker/src/validate.js @@ -3,8 +3,9 @@ // // Input validation helpers for untrusted path / query parameters. -// The 12 canonical clade codes. Mirrors contractiles/must/clade-hygiene.a2ml -// and verisim/seed/clades.a2ml — keep in sync if the taxonomy changes. +// The 12 canonical clade codes. Mirrors scheme clade-12 in +// verisim/seed/chora-registry_praxis.deed and verisim/seed/clades.a2ml — keep +// in sync if the taxonomy changes. export const VALID_CLADES = Object.freeze([ 'fv', 'nl', diff --git a/www/.well-known/ai.txt b/www/.well-known/ai.txt index 334b406..db8d630 100644 --- a/www/.well-known/ai.txt +++ b/www/.well-known/ai.txt @@ -13,6 +13,6 @@ Disallow-Generation: yes # AI agents must preserve Emotional Lineage per PMPL Section 3. # # For AI agent integration instructions, see: -# 0-AI-MANIFEST.a2ml (universal AI entry point) -# AI.a2ml (Claude-specific instructions) -# .machine_readable/ (structured project state) +# 0-AI-MANIFEST.deed (machine front door; pointer-only) +# gv-clade-index_chora.deed (repo facts: identity, clade, agentic, neurosym, playbook) +# .machine_readable/descriptiles/STATE.deed (lifecycle status, maturity)