Repository navigation
Commit ddee8be
authored
docs(guide): Command Code chat needs the session herdr reports, and none does yet (#1647)
<!-- See CONTRIBUTING.md for checks, translations, contract tests and
the changelog (a file in changelog.d/, never CHANGELOG.md). -->
## Change
`docs/guide.md` lists Command Code's chat as a native session file
"resolved through herdr". No released herdr resolves it.
`cmdTranscriptPath` reads the session herdr reports for the pane, as pi
does (`server/cmd.ts`, `session.source === "herdr:cmd"`). herdr keeps a
reported session only for the agents in `is_official_agent_source`
(`src/agent_resume.rs`), and Command Code is not among them, so the
report Command Code sends is dropped and `agent_session` stays absent
for
the pane. Measured on herdr 0.9.5 + Command Code 1.87.1:
```
herdr agent get <cmd pane> → "agent":"cmd", "title":"Domain Modeling",
"tokens":{"model":…} (no agent_session)
/api/pane/conversation → {"source":"scrollback","turns":[]}
```
Status, title and model arrive from the same reporter over the same
socket, so the pane looks fully integrated while its conversation stays
out of reach, and the row promised a chat that cannot appear. The bridge
reads the conversation only from the file herdr names — the alternatives
(newest file in the project directory, joining herdr's pane title to
`<id>.meta.json`) pick the wrong conversation when two `cmd` panes share
a folder — so the pane opens in Terminal.
This writes that limit where the row points, in the shape the Devin row
already uses for its own case. It also notes the part that does work:
the
permission prompt cards are read off the screen
(`server/dialogs/cmd.ts`), not from the session file, so they answer
from
the chat either way.
No code change. `server/cmd.ts` is right; the herdr half was never
built.
Upstream ask with the exact contract gap: herdrdev/herdr#3333
(herdrdev/herdr#3333 (comment))
## Validation
Docs only — no `src/`, `server/` or `shared/` change, so per
AGENTS.md this PR asks for no CodeRabbit review.
- `bun test scripts/changelog-fold.test.ts scripts/conventions.test.ts`
— 21 pass, 0 fail.
- No changelog fragment: nothing a user notices changes, and
docs-only commits have none (`302b9eae`, `4555859d`).
- Checked the claim against the rest of the tree: README and the site's
agent chips list Command Code as an agent the app works with, which
stays true (terminal, status, alerts and prompt cards all work); only
the guide asserted the chat resolves.1 parent 4a4bdaa commit ddee8be
1 file changed
Lines changed: 9 additions & 1 deletion
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
160 | 160 | | |
161 | 161 | | |
162 | 162 | | |
163 | | - | |
| 163 | + | |
164 | 164 | | |
165 | 165 | | |
166 | 166 | | |
| |||
197 | 197 | | |
198 | 198 | | |
199 | 199 | | |
| 200 | + | |
| 201 | + | |
| 202 | + | |
| 203 | + | |
| 204 | + | |
| 205 | + | |
| 206 | + | |
| 207 | + | |
200 | 208 | | |
201 | 209 | | |
202 | 210 | | |
| |||
0 commit comments