first commit

2026-07-30 23:02:00 -04:00
commit fd537ed47e
48 changed files with 3059 additions and 0 deletions
@@ -0,0 +1,62 @@
+# Flying Jib — Progress Log
+
+> Append-only chronological log of decisions, blockers, and wins.
+> Newest entries at the top.
+
+---
+
+## 2026-07-30 — ADR-0013: Bare/Pear-only runtime and single-executable distribution
+
+### Wins
+
+- Accepted **ADR-0013**: production runtime is **Bare only**; no system Node.js; no Node child for Squid.
+- Superseded ADR-0004 (Electron + Node Squid child) and primary Electron Forge path in ADR-0011.
+- Amended ADR-0002: Flying Squid loads via **`bare-node-runtime`** inside Bare.
+- Updated living, developer, user, and agent docs for `hello-pear-bare` + `bare-build --standalone` + Pear OTA.
+- Added open question **Q15** (Squid/Bare compatibility spike).
+
+### Decisions
+
+- CI product = single standalone Bare executables + pear stage/seed OTA.
+- Electron is not the default shell; Node is build-time tooling only where unavoidable.
+
+### Next
+
+- Phase 1: scaffold hello-pear-bare; Bare Squid spike.
+
+---
+
+## 2026-07-30 — Phase 0 complete: research + architecture + docs scaffold
+
+### Wins
+
+- Inventoried Holepunch mirror at `holepunchto_repos` (~680 packages); selected stack versions for hyperswarm, hyperdht, corestore, autobase, protomux, pear-runtime, etc.
+- Assessed Flying Squid (`createMCServer`, plugins, Anvil, versions through 1.21.4) as embeddable local authority — not global multi-peer sim.
+- Studied peardock (control plane + invites) and holesail (TCP tunnel pattern); decided **Apache-2.0 HyperDHT tunnel** instead of AGPL Holesail dependency.
+- Locked architecture: **Local Authority + Capability Tunnel + Federated Regions**.
+- Product name: **Flying Jib**.
+- Scaffolded full `living_docs/`, `developer_docs/`, `user_docs/`, `agent/` including ADRs 0000–0012 (later extended by 0013).
+
+### Decisions
+
+- No master/central servers ever; discovery only via Hyperswarm/HyperDHT.
+- Squid always binds `127.0.0.1` (explicit; minecraft-protocol default is all interfaces).
+- Process model initially hybrid; **revised same day to Bare/Pear-only (ADR-0013)**.
+- Private worlds: HyperDHT byte pipe; invites `fj1.`.
+- Mesh: Autobase region registry; border = session migration, not global block CRDT.
+- License: Apache-2.0.
+
+### Blockers
+
+- None for Phase 0 docs.
+
+### Next
+
+- Phase 1: Bare app shell + Squid on bare-node-runtime.
+
+---
+
+## 2026-07-30 — Investigation kickoff
+
+- Empty repo `flying-jib` initialized as documentation-first project.
+- Primary references: Prismarine flying-squid, full Holepunch ecosystem, local peardock/holesail experience.