Skip to content

Commit b07f02f

Browse files
committed
Install SDD: next slice of per-file specs
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01CSM4FVUbnP4PJJ9sawMfLb
1 parent 6907c53 commit b07f02f

4 files changed

Lines changed: 42 additions & 0 deletions

File tree

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
Feeds the dashboard's quota panel: where the account's quota stands against its limits, and what Auto PM last decided. Both are asked of the daemon every thirty seconds while the panel is open, since the daemon already keeps a cached reading and answering is cheap — unlike the driver read behind it — and since Auto PM runs on the daemon's clock, so the panel only learns of a new decision by asking again.
2+
3+
Neither answer exists until the first reply arrives, and a host that runs no Auto PM has no decision to report. A failed request keeps the last known reading rather than blanking it, because an empty bar would read as "nothing used".
4+
5+
## Before modifying/creating SPEC.md files
6+
7+
You must always read and respect https://raw.githubusercontent.com/brillout/sdd/refs/heads/main/sdd.md
Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
What the tests cover: the quota reading the dashboard shows. There is no reading at all until the first answer arrives — distinct from "nothing used" — after which the daemon's answer is reported as-is. The reading refreshes on its thirty-second interval. A failed refresh keeps the last reading rather than blanking it, since an empty bar would read as nothing used. Closing the panel stops the refreshing.
2+
3+
## Before modifying/creating SPEC.md files
4+
5+
You must always read and respect https://raw.githubusercontent.com/brillout/sdd/refs/heads/main/sdd.md
Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
Remembers which saved device the user has picked to run the next agent on, so the Start form can show the choice and the submit can attach it as the agent's relay target. No device picked means the agent runs on one of the ordinary run targets — this machine or a GitHub Actions runner.
2+
3+
The choice lasts only as long as the page: it is never stored, and in particular never becomes a preference, because a device's token is a per-browser secret and where one agent is sent is a transient decision rather than a saved setting.
4+
5+
## Before modifying/creating SPEC.md files
6+
7+
You must always read and respect https://raw.githubusercontent.com/brillout/sdd/refs/heads/main/sdd.md
Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,23 @@
1+
Builds the shell one-liner that reopens an agent's driver session in a terminal, so a conversation can be continued outside the dashboard.
2+
3+
## Business logic
4+
5+
### Picking a session back up outside the dashboard
6+
7+
#### User story
8+
9+
The user wants to carry on an agent's conversation in their own terminal rather than in the dashboard. The dashboard knows the session id but the conversation was previously unreachable: there was no way to name it.
10+
11+
#### Business logic
12+
13+
The command recreates the directory the agent ran in, changes into it, and resumes the session by its id. With no directory recorded — an older agent, or one that never opened a session — the session id alone is handed over instead, so the caller can say which of the two it gave the user. An agent with no session id at all yields nothing to copy.
14+
15+
#### Rationale
16+
17+
The session id alone is not enough: the coding-agent CLI finds a session by the directory it ran in, and that directory is usually gone by the time the user wants it, because an agent that finishes cleanly has its worktree removed. An empty directory at the original path is enough for the CLI to match the session and read the conversation back.
18+
19+
The command deliberately presets no permission mode. It lands in someone's own terminal, and what the reopened agent is allowed to do is that person's call to make at their prompt.
20+
21+
## Before modifying/creating SPEC.md files
22+
23+
You must always read and respect https://raw.githubusercontent.com/brillout/sdd/refs/heads/main/sdd.md

0 commit comments

Comments
 (0)