cc-libs/docs/adrs

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.

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.