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

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 1 addition & 2 deletions .boj/project-memories.a2ml
Original file line number Diff line number Diff line change
Expand Up @@ -33,8 +33,7 @@ schema_version = "1.0.0"
"curl -sf -X POST http://127.0.0.1:7745/tools/coord_claim_task \
-H 'Content-Type: application/json' \
-d '{\"task_id\":\"<your-task-id>\"}'")
(step 3 "Read the plan"
"cat .machine_readable/6a2/STATE.a2ml # look for [expansion-roadmap]"))
)

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Remove the remaining live STATE.a2ml update instruction

Removing the startup read does not fully migrate this live worker briefing: its backend template still requires a STATE.a2ml backend count update at line 65. Because the commit deletes that file and this briefing is retained specifically because an external hook prepends it to worker sessions, backend workers following the completion checklist are still directed to modify a nonexistent retired artifact; replace that wiring item with the new roadmap/deed target or remove it.

Useful? React with 👍 / 👎.


; ===================================================================
; COMPLETION CONTRACT — the most important rule
Expand Down
13 changes: 10 additions & 3 deletions .claude/CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,16 +6,23 @@ Copyright (c) Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>

## Machine-Readable Artefacts

This repo follows the hyperpolymath standard. See `https://github.com/hyperpolymath/standards`. A2ML is retired (D308): do not create or edit `.a2ml` files, and do not treat `.machine_readable/6a2/` as current. Descriptive metadata moves to the repo's chora deed via kyX.
This repo follows the hyperpolymath standard. See `https://github.com/hyperpolymath/standards`. A2ML is retired (D99, D312, D313): never create, restore or extend a `.a2ml` file. You may only delete content from one.

Machine-readable repo facts are deeds, checked with `bun <standards>/1-formats/deed/tools/deed_lint.js FILE`:

- `boj-server_chora.deed` — the one repo deed: identity, clade, forges, lineage, lifecycle `(status)`, `(meta)` with the ADRs, `(agentic)`, `(neurosym)`, `(playbook)` and the `(anchor)` (semantic authority and golden path).
- `0-AI-MANIFEST.deed` — the pointer-only machine front door (A7 ruling Q15). It carries no facts.

`docs/history/A2ML-REMOVED.adoc` is the ledger of the A2ML files retired on 2026-11-14: what each held, where its content went, and the four `.a2ml` files kept because a live reader still needs them. Do not recreate a removed file; the journal that `STATE.a2ml` carried continues in `docs/status/ROADMAP.adoc`.

---

## Language Policy (Hyperpolymath Standard)

The full policy is canonical in `hyperpolymath/standards`. Key points relevant to this repo:

- **No new TypeScript** — convert existing TS to AffineScript (`.affine`) directly; AffineScript is no longer the destination as of 2026-04-30.
- **Deno** for the runtime, not Node. `deno.json` for imports, no `node_modules` in production.
- **No new TypeScript or ReScript** — convert existing TS/ReScript to AffineScript (`.affine`) directly; ReScript is no longer the destination as of 2026-04-30.
- **Bun** for the JS runtime (order Bun > Deno > pnpm > npm; npm only as the last resort), not Node. JS dependencies are declared in `package.json` and pinned by `bun.lock`; both are required. `bun install --production` for production dependencies.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Synchronize the Bun policy across contributor guidance

When contributors or Copilot follow the other repository instructions, this new Bun requirement conflicts with docs/AI-CONVENTIONS.adoc:88-89 and .github/copilot-instructions.md:39-40, which still ban Bun and require Deno, while .github/pull_request_template.md:24 asks authors to certify that no Bun is used. This can cause agents to remove or reject the package.json/bun.lock setup now required here, so update those policy surfaces together with this runtime ruling.

Useful? React with 👍 / 👎.

- **AffineScript** for new application code. Compiles to typed-wasm.

### TypeScript Exemptions (Approved)
Expand Down
1 change: 0 additions & 1 deletion .github/0.1-AI-MANIFEST.a2ml

This file was deleted.

1 change: 0 additions & 1 deletion .github/CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -45,7 +45,6 @@ boj-server/
├── 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.)
│ ├── bot_directives/ # Bot configs
│ └── contractiles/ # Policy contracts (k9, dust, lust, must, trust)
├── .well-known/ # Protocol files (Perimeter 1-3)
Expand Down
10 changes: 5 additions & 5 deletions .github/copilot-instructions.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,8 +9,8 @@ Copyright (c) Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>

## 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: it points to `boj-server_chora.deed` (repo facts) and `.claude/CLAUDE.md` (agent conventions).
- A2ML is retired: never create a `.a2ml` file (see `docs/history/A2ML-REMOVED.adoc`).

## License

Expand Down Expand Up @@ -55,6 +55,6 @@ Copyright (c) Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>

## 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 state and metadata are clauses of `boj-server_chora.deed` (lifecycle `(status)`,
`(meta)`, `(agentic)`, `(neurosym)`, `(playbook)`, `(anchor)`). Never create STATE, META,
ECOSYSTEM, AGENTIC, NEUROSYM or PLAYBOOK `.a2ml` files anywhere.
5 changes: 2 additions & 3 deletions .github/pull_request_template.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,9 +29,8 @@ Copyright (c) Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>

### 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)
- [ ] `boj-server_chora.deed` updated and passing `deed_lint.js` (if lifecycle status, ADRs `(meta)` or the `(anchor)` changed)
- [ ] `docs/status/ROADMAP.adoc` updated (if project state changed)
- [ ] Documentation updated for user-facing changes
- [ ] `TOPOLOGY.md` updated (if architecture changed)
- [ ] `CHANGELOG` or release notes updated
Expand Down
29 changes: 0 additions & 29 deletions .machine_readable/0.1-AI-MANIFEST.a2ml

This file was deleted.

31 changes: 0 additions & 31 deletions .machine_readable/6a2/0-AI-MANIFEST.a2ml

This file was deleted.

44 changes: 0 additions & 44 deletions .machine_readable/6a2/AGENTIC.a2ml

This file was deleted.

46 changes: 0 additions & 46 deletions .machine_readable/6a2/ECOSYSTEM.a2ml
Original file line number Diff line number Diff line change
Expand Up @@ -3,52 +3,6 @@
#
# ECOSYSTEM.a2ml — Bundle of Joy Server ecosystem position

[metadata]
version = "0.2.0"
last-updated = "2026-04-25"

[project]
name = "Bundle of Joy Server"
purpose = "Unified server capability catalogue with formally verified cartridges, distributed community hosting, and the Teranga menu system. Solves the combinatoric explosion of developer server protocols — AI goes to ONE place instead of hunting across dozens of MCP/LSP/etc servers."
role = "service"

[position-in-ecosystem]
tier = "infrastructure"

[related-projects]
projects = [
{ name = "proven-servers", relationship = "dependency", notes = "108 components (94 protocols + 8 core primitives + 6 connectors). BoJ imports proven-mcp types, dbconn, authconn, etc. All zero believe_me." },
{ name = "polystack", relationship = "supersedes", notes = "BoJ replaces polystack's 13 components. poly-cloud/container/db/k8s/git/iac/secret/queue/observability/proof/ssg become cartridges in the BoJ matrix." },
{ name = "PanLL", relationship = "primary-consumer", notes = "PanLL is the primary consumer. Panels need diverse capabilities dynamically — the BoJ catalogue tells them what's available." },
{ name = "echidna", relationship = "dependency", notes = "ECHIDNA 105-prover portfolio exposed via echidna-llm-mcp cartridge (v0.2.0). 8 tools: list_provers, prove, verify, search (REST :8000) + init, authenticate, suggest_tactics, rank_provers (LLM :7721). Consumer repos: typell, panll, nesy-solver, proven-servers, typed-wasm, 007-lang, aspasia." },
{ name = "hypatia", relationship = "integration", notes = "Hypatia scans cartridges for security. SafeReasoning harmonizes Neural (Hypatia) + Symbolic (Echidna) verdicts." },
{ name = "gitbot-fleet", relationship = "integration", notes = "SafeFleet enforces 6-bot gate policy. FleetCertified proof type requires all gates passed." },
{ name = "stapeln", relationship = "dependency", notes = "Container supply chain for node hosting. Chainguard base images, selur-compose, vordr, svalinn, cerro-torre." },
{ name = "language-bridges", relationship = "sibling-standard", notes = "Same Idris2/Zig stack (zig retired 2026-04-10). BoJ follows the ABI-FFI universal standard." },
{ name = "rsr-template-repo", relationship = "origin", notes = "BoJ was bootstrapped from rsr-template-repo. All 17 mandatory workflows present." },
]

[integration-points]
integrations = [
{ system = "PanLL", direction = "outbound", protocol = "a2ml_menu", notes = "PanLL reads menu.a2ml for capability discovery" },
{ system = "gitbot-fleet", direction = "bidirectional", protocol = "mcp", notes = "Fleet cartridge controls gitbot-fleet; fleet validates cartridges" },
{ system = "hypatia", direction = "inbound", protocol = "ci_workflow", notes = "Hypatia scans via hypatia-scan.yml" },
{ system = "Umoja network", direction = "bidirectional", protocol = "gossip_ipv6", notes = "Federated node discovery and attestation" },
{ system = "IndieWeb", direction = "outbound", protocol = "webmention", notes = "IndieWeb community integration for distributed hosting" },
]

[distribution-model]
type = "community-hosted"
description = "Volunteer nodes host BoJ servers, like Tor/IPFS. Hash attestation ensures integrity — tampered nodes are excluded from the community network but can still run locally."
seed-nodes = [
{ region = "Europe-West", operator = "hyperpolymath", fly-app = "boj-seed-eu", host = "boj-seed-eu.fly.dev", canonical-host = "eu.boj.hyperpolymath.dev", notes = "Deployed 2026-04-25 — lhr region" },
{ region = "Europe-Central", operator = "hyperpolymath", fly-app = "boj-seed-de", host = "boj-seed-de.fly.dev", canonical-host = "de.boj.hyperpolymath.dev", notes = "Deployed 2026-04-25 — fra region" },
{ region = "US-East", operator = "hyperpolymath", fly-app = "boj-seed-us", host = "boj-seed-us.fly.dev", canonical-host = "us.boj.hyperpolymath.dev", notes = "Deployed 2026-04-25 — iad region" },
{ region = "Asia-Pacific", operator = "hyperpolymath", fly-app = "boj-seed-ap", host = "boj-seed-ap.fly.dev", canonical-host = "ap.boj.hyperpolymath.dev", notes = "Deployed 2026-04-25 — syd region" },
]
dns-status = "hyperpolymath.dev undelegated — registrar action needed (see container/fly/DNS-SETUP.adoc); *.fly.dev hostnames operative"
federation-protocol = "Umoja gossip (X25519 + ChaCha20-Poly1305, UDP 9999, IPv6)"

# ── Publishing (ADR-004: README single-source derivation) ──────────────────
# README.adoc is canonical; README.md is DERIVED (GENERATED banner) for Glama,
# which renders Markdown only. Regenerated + freshness-checked by the
Expand Down
74 changes: 0 additions & 74 deletions .machine_readable/6a2/META.a2ml

This file was deleted.

24 changes: 0 additions & 24 deletions .machine_readable/6a2/NEUROSYM.a2ml

This file was deleted.

Loading
Loading