Repository navigation
Closed
Labels
harnessresearchDefining or executing a research into an aspect: tech, direction, decisionDefining or executing a research into an aspect: tech, direction, decision
Milestone
Description
What
Document V1 runtime-dependency philosophy: self-contain vs declare, with the locked calls from the #735 / #932 census.
Why now
Oded accepted the #932 spike recommendations (PR comment 2026-09-23). The framework and decisions need a durable home (ADR or equivalent docs) so future deps do not re-litigate V1 calls.
Scope
In
- ADR (or
docs/philosophy page) covering:- Prefer declare + loud failure over bundling when install cost is sane.
- Locked V1 calls:
- Node/npx — declare; graceful fail if missing; README lists as requirement for harnesses that need it. Do not bundle for V1 (spike(ship): Bundle Node runtime + pinned ACP adapters for self-contained Claude/Codex/Pi #928 closed not planned).
- Harness CLIs — declare per preset; graceful fail; README lists PATH + auth requirements for that harness.
- WebView — as recommended: graceful fail if missing; README (Tauri) — Windows handled; Linux declare; macOS nothing.
- GStreamer — optional; README for Linux audio cues; nice-to-have; silent skip OK.
- libfuse — AppImage only; when shipping AppImage, prefer type 2 with bundled runtime.
- X11/Wayland — environment, not a dependency.
- MCP stdio binary (
AI_BUDDY_MCP_BIN) — do not bundle with main binary; challenge whether stdio path is still needed; optional download at best; HTTP+bearer remains primary.
- Point at research note
docs/research/runtime-dependencies.md(spike(ship): Census of runtime deps beyond the binary #932) as the evidence census. - Criteria for future deps: size, licenses, update cadence, user install base, required vs optional.
Out
- Implementing UX (feat(settings): Distinguish first-party ACP harnesses from npx-adapter presets in UI #929, sticky-failure sibling, harness-connect UX) or bundling.
- V2 spikes (npx alternatives / first-party Claude-Codex ACP binaries; antigravity + other named presets beyond goose).
Done when
- ADR or docs page merged with the locked V1 calls above.
- Cross-links to spike(ship): Census of runtime deps beyond the binary — self-contain or present cleanly #735/spike(ship): Census of runtime deps beyond the binary #932 research note and follow-ups (feat(settings): Distinguish first-party ACP harnesses from npx-adapter presets in UI #929, feat(harness): Named preset for Goose (zero-npx, open-source local agent) #930, and related UX issues).
- Explicit "do not reopen Node bundling for V1" pointer (spike(ship): Bundle Node runtime + pinned ACP adapters for self-contained Claude/Codex/Pi #928 not planned).
Related
- spike(ship): Census of runtime deps beyond the binary — self-contain or present cleanly #735 — parent spike
- spike(ship): Census of runtime deps beyond the binary #932 — census PR / research note
- spike(ship): Bundle Node runtime + pinned ACP adapters for self-contained Claude/Codex/Pi #928 — Node bundling spike (closed not planned)
- fix(chat): Surface a missing Harness launcher on the landing #831 — loud missing-launcher failure (makes declare viable)
— Cursor agent (Architect), on @omesser's behalf.
Metadata
Metadata
Assignees
Labels
harnessresearchDefining or executing a research into an aspect: tech, direction, decisionDefining or executing a research into an aspect: tech, direction, decision
Projects
- StatusShow more project fieldsDone
Activity
omesser commentedon Sep 23, 2026
Cross-links: harness-connect UX #949, sticky inline missing-dep #950, Settings first-party vs npx #929, Goose #930. #928 closed not planned (no Node bundle for V1).
— Cursor agent (Architect), on @omesser's behalf.
docs(research): Record Oded's locked decisions for runtime deps
docs(research): Record all Oded's locked decisions for runtime deps