SATELLITES.a2ml

# SPDX-License-Identifier: PMPL-1.0-or-later
# SPDX-FileCopyrightText: 2026 Jonathan D.A. Jewell
# SATELLITES.a2ml -- Hub-Satellite Registry for hyperpolymath/standards
#
# This file registers all satellite repositories that orbit the standards hub.
# Satellites inherit enforcement policies, language rules, and governance from here.

[satellites]
version = "2.0.0"

[satellites.hub]
name = "standards"
url = "https://github.com/hyperpolymath/standards"
architecture = "monorepo"
absorbed-date = "2026-02-08"
description = "Organization-wide standards, policies, and enforcement mechanisms -- satellites absorbed as subdirectories"

[satellites.hub.governs]
language-policy = "CLAUDE.md"
enforcement-workflows = ".github/workflows/"
a2ml-templates = "a2ml-templates/"
pre-commit-hooks = "hooks/"

# ============================================================
# A2ML FORMAT FAMILY - Specification Repositories
# ============================================================
# These repos define the 7 machine-readable metadata formats
# used across all hyperpolymath projects.

# PRIMARY SPECIFICATION
[satellites.repos.meta-a2ml]
url = "https://github.com/hyperpolymath/meta-a2ml"
local-path = "meta-a2ml/"
role = "specification"
tier = "primary"
format-defines = ["META.a2ml", "STATE.a2ml", "ECOSYSTEM.a2ml"]
media-types = ["application/vnd.meta+a2ml", "application/vnd.state+a2ml", "application/vnd.ecosystem+a2ml"]
description = "META format specification - architecture decisions, development practices"

[satellites.repos.meta-a2ml.relationships]
parent = "standards"
children = ["playbook-a2ml", "agentic-a2ml", "neurosym-a2ml", "anchor-a2ml"]

# EXECUTION LAYER SPECIFICATIONS
[satellites.repos.playbook-a2ml]
url = "https://github.com/hyperpolymath/playbook-a2ml"
local-path = "playbook-a2ml/"
role = "specification"
tier = "execution"
format-defines = ["PLAYBOOK.a2ml"]
media-types = ["application/vnd.playbook+a2ml"]
description = "Executable plan specification - derived from META, gated by AGENTIC"

[satellites.repos.playbook-a2ml.relationships]
parent = "meta-a2ml"
siblings = ["agentic-a2ml", "neurosym-a2ml"]
depends-on = ["META.a2ml", "STATE.a2ml", "AGENTIC.a2ml"]

[satellites.repos.agentic-a2ml]
url = "https://github.com/hyperpolymath/agentic-a2ml"
local-path = "agentic-a2ml/"
role = "specification"
tier = "execution"
format-defines = ["AGENTIC.a2ml"]
media-types = ["application/vnd.agentic+a2ml"]
description = "AI agent operational gating - entropy budgets, risk thresholds, safety controls"

[satellites.repos.agentic-a2ml.relationships]
parent = "meta-a2ml"
siblings = ["playbook-a2ml", "neurosym-a2ml"]
depends-on = ["META.a2ml"]
gates = ["PLAYBOOK.a2ml"]

[satellites.repos.neurosym-a2ml]
url = "https://github.com/hyperpolymath/neurosym-a2ml"
local-path = "neurosym-a2ml/"
role = "specification"
tier = "execution"
format-defines = ["NEUROSYM.a2ml"]
media-types = ["application/vnd.neurosym+a2ml"]
description = "Symbolic semantics - composition algebra, proof obligations, verification hooks"

[satellites.repos.neurosym-a2ml.relationships]
parent = "meta-a2ml"
siblings = ["playbook-a2ml", "agentic-a2ml"]
provides-semantics-for = ["PLAYBOOK.a2ml", "AGENTIC.a2ml"]

# INTERVENTION SPECIFICATION
[satellites.repos.anchor-a2ml]
url = "https://github.com/hyperpolymath/anchor-a2ml"
local-path = "anchor-a2ml/"
role = "specification"
tier = "intervention"
format-defines = ["ANCHOR.a2ml"]
media-types = ["application/vnd.anchor+a2ml"]
description = "Project recalibration intervention - scope management, realignment trigger"

[satellites.repos.anchor-a2ml.relationships]
parent = "meta-a2ml"
can-intervene-on = ["META.a2ml", "STATE.a2ml", "ECOSYSTEM.a2ml", "PLAYBOOK.a2ml", "AGENTIC.a2ml", "NEUROSYM.a2ml"]
special-role = "superintendent-drop-document"

# ============================================================
# RSR (RHODIUM STANDARD REPOSITORIES)
# ============================================================
[satellites.repos.rhodium-standard-repositories]
url = "https://github.com/hyperpolymath/rhodium-standard-repositories"
role = "specification"
tier = "infrastructure"
description = "RSR specification - repository compliance standards"

[satellites.repos.rhodium-standard-repositories.relationships]
parent = "standards"
enforces-on = "all-repos"

[satellites.repos.git-rsr-certified]
url = "https://github.com/hyperpolymath/git-rsr-certified"
role = "tooling"
tier = "infrastructure"
description = "Universal RSR compliance engine"

[satellites.repos.git-rsr-certified.relationships]
implements = "rhodium-standard-repositories"

# ============================================================
# RELATED STANDARDS
# ============================================================
[satellites.repos.a2ml]
url = "https://github.com/hyperpolymath/standards/tree/main/a2ml"
role = "specification"
tier = "format"
description = "Attested Markup Language - typed, verified documents"
media-types = ["application/vnd.a2ml"]

[satellites.repos.a2ml.relationships]
parent = "standards"
related = ["meta-a2ml", "neurosym-a2ml"]
adjacent = ["k9-svc"]
example-implementations = ["stateful-artefacts-for-gitforges"]

[satellites.repos.k9-svc]
url = "https://github.com/hyperpolymath/standards/tree/main/k9-svc"
role = "specification"
tier = "format"
description = "Self-validating components with embedded contracts and deployment logic"

[satellites.repos.k9-svc.relationships]
parent = "standards"
related = ["a2ml"]

[satellites.repos.stateful-artefacts-for-gitforges]
url = "https://github.com/hyperpolymath/stateful-artefacts-for-gitforges"
role = "tooling"
tier = "application"
description = "Metadata-driven documentation pipeline for Git forges"

[satellites.repos.stateful-artefacts-for-gitforges.relationships]
parent = "standards"
related = ["a2ml"]

[satellites.repos.palimpsest-license]
url = "https://github.com/hyperpolymath/palimpsest-license"
role = "governance"
tier = "foundation"
description = "Philosophical license overlay for ethical AI development"

[satellites.repos.palimpsest-license.relationships]
applied-to = "all-repos"

# ============================================================
# EXECUTION PIPELINE
# ============================================================
# All implementations MUST respect this ordering

[[satellites.execution-pipeline]]
step = 1
format = "META.a2ml"
action = "validation"
authority = "constitutional"

[[satellites.execution-pipeline]]
step = 2
format = "AGENTIC.a2ml"
action = "gating"
authority = "operational-safety"

[[satellites.execution-pipeline]]
step = 3
format = "NEUROSYM.a2ml"
action = "semantics"
authority = "proof-obligations"

[[satellites.execution-pipeline]]
step = 4
format = "PLAYBOOK.a2ml"
action = "derivation"
authority = "executable-plan"

[[satellites.execution-pipeline]]
step = 5
action = "execution"

[[satellites.execution-pipeline]]
step = 6
format = "ECOSYSTEM.a2ml"
action = "integrity-check"

[[satellites.execution-pipeline]]
step = 7
format = "STATE.a2ml"
action = "update"

[satellites.special-intervention]
format = "ANCHOR.a2ml"
trigger = "superintendent-drop"
effect = "recalibrate-all-a2ml-files"
authority = "external-to-pipeline"

### End of SATELLITES.a2ml