jpmschweitzerandClaude Opus 4.7
a782511470
Ports the patterns that crystallized during the short-lived claudian plugin project (discarded in favour of this Flutter rebuild): - ADRs 0001-0004 capture decisions that survive the host change — CLI-first over MCP, Go for the sidecar, pql as a supporter tool that becomes a clide-managed subsystem when present, and the ignore-file strategy that wires all file-enumerating surfaces through one knob in .pql/config.yaml. - .claude/settings.json and the git-commit and skill-create skills come over with naming updated for clide. The git-commit skill's "no Conventional Commits" convention supersedes the Python-era clide style under legacy/; the Keep-a-Changelog discipline and the project.yaml-version-and-changelog-bumped-together rule apply going forward. - CHANGELOG.md starts fresh at the repo root to track the Flutter rebuild. The Python changelog is preserved under legacy/. .gitignore narrows from `.claude/` to just `.claude/settings.local.json` so project-level config and skills travel with the repo. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1.7 KiB
1.7 KiB
ADR 0002 — Sidecar language: Go
Status: accepted Date: 2026-04-20 (ported from the claudian lineage)
Context
The Clide sidecar owns PTYs, subprocesses, file watchers, git
shelling-out, and the IPC server. It ships as a single static binary
that also serves as the clide CLI in one-shot mode. The Flutter
desktop app talks to it over IPC; Claude talks to it via the CLI.
Language candidates were Go and Rust.
Related hard constraint: no heavy lifting in the UI layer. The Flutter app stays focused on rendering and interaction. Everything heavy (PTYs, subprocesses, file watching, git, pql invocations) lives in the sidecar. Reason: keep the UI layer thin and the security-sensitive surface auditable in one language.
Decision
The sidecar/CLI is written in Go.
Rationale:
- Matches pql. pql is Go; Clide wraps pql and reaches into its idioms constantly. Shared toolchain and shared patterns cut cognitive overhead.
- Static binary. Single artifact, trivial cross-compile, no runtime dependencies on the user's machine.
- PTY story is fine.
creack/ptycovers what we need; Rust's crates are marginally nicer but not decisive. - Muscle memory. Build pipeline,
project.yamlconventions, goreleaser setup, exit-code contract, diagnostic format — all already established in pql and portable one-to-one.
Consequences
- Module path:
git.schweitz.net/jpmschweitzer/clide/sidecar. - Layout mirrors pql:
cmd/clide/main.go,internal/cli,internal/version(ldflag-stampedVersion,Commit,Date),internal/diag(exit codes + stderr-JSON diagnostics). - Same Makefile shape: version read from
project.yamlvia awk, stamped via-ldflags -X.