History

Guillaume ARM 9bc1ce711d refactor: rename accountId in networkId + cleanup		2026-06-18 20:23:06 +02:00
..
adr-0001-target-computercraft.md	docs: add architecture decision records	2026-06-07 21:44:01 +02:00
adr-0002-eventloop-and-service-bus.md	refactor: rename accountId in networkId + cleanup	2026-06-18 20:23:06 +02:00
adr-0005-craftos-pc-harness-and-probes.md	refactor: rename trapos-sandbox to trapos-server	2026-06-17 01:25:16 +02:00
adr-0007-test-framework.md	chore(env): rename test env sample	2026-06-17 01:58:13 +02:00
adr-0010-ccpm-package-manager.md	chore(release): update TrapOS endpoint and versions	2026-06-15 21:00:15 +02:00
adr-0011-repo-conventions.md	docs(adr): consolidate repository conventions	2026-06-09 22:05:22 +02:00
adr-0016-js-tool-verification.md	refactor: rename trapos-sandbox to trapos-server	2026-06-17 01:25:16 +02:00
adr-0017-mcp-remote-lua-execution.md	refactor: rename trapos-sandbox to trapos-server	2026-06-17 01:25:16 +02:00
adr-0018-justfile-organization.md	chore(just): split recipes by concern	2026-06-11 06:07:30 +02:00
adr-0019-mcp-over-cloud-gateway.md	refactor: rename accountId in networkId + cleanup	2026-06-18 20:23:06 +02:00
adr-0020-boot-lifecycle.md	fix(boot): clarify lifecycle orchestration	2026-06-15 20:06:45 +02:00
README.md	refactor: rename trapos-sandbox to trapos-server	2026-06-17 01:25:16 +02:00

README.md

Architecture Decision Records

This directory contains lightweight Architecture Decision Records for this repository.

The goal is simple: keep a short memory of why we made repo-level choices while building ComputerCraft / CC:Tweaked code for Minecraft. This is not meant to be a heavy process.

Future ADRs can reuse the shape of the existing files when it is useful.

Records

adr-0001-target-computercraft.md — Target ComputerCraft.
adr-0002-eventloop-and-service-bus.md — Eventloop substrate, service-name bus on a single channel, and os.sleep discipline.
adr-0005-craftos-pc-harness-and-probes.md — CraftOS-PC as the local harness, minimal periphemu bootstrap, and headless probes as the canonical hypothesis-test pattern.
adr-0007-test-framework.md — libtest per-case helper, runtest suite orchestration, and the two-layer timeout (libtest + shell watchdog).
adr-0010-ccpm-package-manager.md — ccpm package manager (packages, registries, package-aware bootstrap).
adr-0011-repo-conventions.md — Git hooks own commit/push verification; markdown link syntax for cross-references.
adr-0016-js-tool-verification.md — JavaScript/TypeScript tool build, check, test, CI, and future integration-test split.
adr-0017-mcp-remote-lua-execution.md — MCP exec-lua remote execution for linked ComputerCraft computers.
adr-0018-justfile-organization.md — Root Justfile split with imports while preserving flat recipe names.
adr-0019-mcp-over-cloud-gateway.md — MCP tools migrated onto the trapos-server gateway; reactive libcloud.serve; traposId addressing.
adr-0020-boot-lifecycle.md — TrapOS boot orchestrator, session-end policy, installer reboot path, and stale startup-file self-healing.

Gaps in numbering (0003, 0004, 0006, 0008, 0009, 0012, 0013, 0014, 0015) are records that were either superseded by later decisions or consolidated into the surviving ADRs above.