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>
45 lines
1.7 KiB
Markdown
45 lines
1.7 KiB
Markdown
# 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/pty` covers what we need; Rust's
|
|
crates are marginally nicer but not decisive.
|
|
- **Muscle memory.** Build pipeline, `project.yaml` conventions,
|
|
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-stamped `Version`, `Commit`, `Date`),
|
|
`internal/diag` (exit codes + stderr-JSON diagnostics).
|
|
- Same Makefile shape: version read from `project.yaml` via awk,
|
|
stamped via `-ldflags -X`.
|