Skip to content

Commit e4cbf4f

Browse files
hyperpolymathclaude
andcommitted
Flesh out ECOSYSTEM.a2ml and META.a2ml from stubs
ECOSYSTEM: adds related-projects (7 integrations), component inventory (11 modules), and role/purpose metadata. META: adds architecture decisions (4 ADRs), development practices, and design rationale following the hospital-triage model. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1 parent d6a0d2c commit e4cbf4f

2 files changed

Lines changed: 51 additions & 5 deletions

File tree

Lines changed: 29 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,36 @@
11
# SPDX-License-Identifier: PMPL-1.0-or-later
2-
# ECOSYSTEM.a2ml — Ecosystem position
3-
# Converted from ECOSYSTEM.scm on 2026-03-15
2+
# ECOSYSTEM.a2ml — Ecosystem position for ambientops
43

54
[metadata]
65
project = "ambientops"
76
ecosystem = "hyperpolymath"
7+
version = "0.1.0"
8+
purpose = "Personal systems administration, monitoring, and automated recovery"
89

910
[position]
10-
type = "component"
11+
type = "monorepo"
12+
role = "infrastructure-layer"
13+
14+
[related-projects]
15+
gossamer = { relation = "consumer", note = "Desktop shell for admin panels" }
16+
panll = { relation = "consumer", note = "Panel layout for monitoring dashboards" }
17+
proven = { relation = "dependency", note = "Formally verified operations" }
18+
hypatia = { relation = "integration", note = "Security scanning for system configs" }
19+
verisimdb = { relation = "storage", note = "Audit trail and state persistence" }
20+
stapeln = { relation = "sibling", note = "Container management overlaps" }
21+
session-sentinel = { relation = "component", note = "Session lifecycle management (Ephapax WIP)" }
22+
volumod = { relation = "component", note = "Volume and audio management" }
23+
displace = { relation = "component", note = "Disk and partition management" }
24+
25+
[components]
26+
ambulances = "Emergency system repair (disk, network, performance, security)"
27+
clinician = "System health diagnostics"
28+
composer = "Service orchestration"
29+
emergency-button = "One-click emergency actions"
30+
monitoring = "System observatory and alerting"
31+
recovery = "Emergency room, freeze ejector, operating theatre"
32+
volumod = "PipeWire/PulseAudio volume management"
33+
displace = "Disk/partition tooling"
34+
personal-sysadmin = "Daily sysadmin automation"
35+
total-recall = "Full system state snapshots"
36+
total-update = "Coordinated system updates"

.machine_readable/6a2/META.a2ml

Lines changed: 22 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,29 @@
11
# SPDX-License-Identifier: PMPL-1.0-or-later
2-
# META.a2ml — Project meta-information
3-
# Converted from META.scm on 2026-03-15
2+
# META.a2ml — Project meta-information for ambientops
43

54
[metadata]
65
project = "ambientops"
76
author = "Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>"
87
license = "PMPL-1.0-or-later"
98
standard = "RSR 2026"
9+
10+
[architecture]
11+
type = "monorepo"
12+
languages = ["bash", "rust", "elixir", "zig", "idris2"]
13+
containers = "chainguard-base"
14+
container-tool = "podman"
15+
16+
[architecture-decisions]
17+
adr-001 = { status = "accepted", title = "Monorepo for all sysadmin tools", reason = "Shared contracts and unified testing" }
18+
adr-002 = { status = "accepted", title = "Ambulance pattern for emergency repair", reason = "Categorised by failure domain (disk/network/perf/security)" }
19+
adr-003 = { status = "accepted", title = "Groove protocol for inter-service comms", reason = "Standard service discovery and health mesh" }
20+
adr-004 = { status = "accepted", title = "VeriSimDB for audit trails", reason = "All system actions must be auditable and queryable" }
21+
22+
[development-practices]
23+
testing = "Integration tests against real system state where safe"
24+
builds = "just doctor for self-diagnostics, just heal for auto-repair"
25+
ci = "GitHub Actions with hypatia-scan and quality checks"
26+
27+
[design-rationale]
28+
philosophy = "Personal sysadmin should be automated, auditable, and recoverable"
29+
inspiration = "Hospital triage model — clinician diagnoses, ambulance responds, recovery heals"

0 commit comments

Comments
 (0)