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

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).

CI product = single standalone Bare executables + pear stage/seed OTA.
Electron is not the default shell; Node is build-time tooling only where unavoidable.

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).

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.

Empty repo flying-jib initialized as documentation-first project.
Primary references: Prismarine flying-squid, full Holepunch ecosystem, local peardock/holesail experience.