docs: record Claude Code chat backend deployment
This commit is contained in:
@@ -0,0 +1,45 @@
|
||||
# Claude Code chat backend — 2026-10-22
|
||||
|
||||
Claude Code is now a third chat harness beside OpenCode and Codex. The adapter
|
||||
(`internal/claude`) owns one CLI process per active session and speaks the CLI's
|
||||
SDK stdio protocol: stream-json input/output, partial messages, and
|
||||
`--permission-prompt-tool=stdio` with the initialize handshake. The operator's
|
||||
existing Claude login and configuration are used unchanged.
|
||||
|
||||
Session identity is a generated UUID pinned with `--session-id`; after an idle
|
||||
release or server restart the next prompt resumes with `--resume`. Text and
|
||||
reasoning stream without duplicating the completed message. Tool calls, Bash
|
||||
command rows, approvals (once/always/reject with the CLI's own permission
|
||||
suggestions), AskUserQuestion forms, interrupts, live model switching, compaction
|
||||
and reported session usage/context all use the existing chat surfaces. History is
|
||||
read from Claude Code's own JSONL transcript, merged by message id with tool
|
||||
results attached, sidechains and local-command noise excluded, and paged with a
|
||||
64 MiB bound.
|
||||
|
||||
The workflow skill now installs into both OpenCode and Claude Code skill roots.
|
||||
`pipelines skill install` refreshes detected roots; an existing user-modified
|
||||
skill is refused rather than overwritten. Claude Code's initialize response lists
|
||||
the installed skill as `Pipelines`.
|
||||
|
||||
## Verification
|
||||
|
||||
- `go test ./...`, `go vet ./...`, formatting and diff checks passed; 742 web unit
|
||||
tests passed.
|
||||
- Deterministic fake-CLI tests cover streaming/dedupe, approvals allow/reject,
|
||||
question forms, interrupt, model selection and resume, transcript merging and
|
||||
paging, image/text attachments, usage, and a signed-out actionable error.
|
||||
- A real scratch-server run used the signed-in CLI and Haiku: advertised backend,
|
||||
model switch, streamed turn, a real Write approval that created the file, a
|
||||
follow-up turn on the same process, transcript readback and reported usage.
|
||||
- A real browser on a scratch server selected Claude in the create pane and saw
|
||||
the Claude harness mark on the created chat.
|
||||
- Deployed clean build `0acd7346bbd870597f6b6346a15b194068fc967e` after checking
|
||||
no pipeline run, Codex chat or other OpenCode chat was active; only the
|
||||
Pipelines server restarted, with a database/binary/plist backup at
|
||||
`~/.local/share/pipelines/backups/pre-0acd7346-20261022-182320`. The
|
||||
authenticated live check then listed `claude` and showed the Claude choice
|
||||
without creating a live chat or model turn.
|
||||
- The same restart activates the earlier transactional notification web-link fix.
|
||||
- Not tested: Flutter tooling is not installed here (the one-line capability
|
||||
change was not run through `flutter test`); native OS-specific Claude behavior
|
||||
outside this adapter is outside this note.
|
||||
Reference in New Issue
Block a user