Prefactor: evie daemon subcommand #56

New issue

Closed

opened 2026-07-08 02:11:18 +08:00 by weiwen · 0 comments

weiwen commented

2026-07-08 02:11:18 +08:00

Owner

Parent

#55

What to build

Prefactor only — no new user-facing behavior. Introduce a top-level clap subcommand layer so the binary can be either the long-running Daemon (evie daemon) or, later, a short-lived CLI issuing a single Verb. Today's entire startup path (config load, Telegram dispatcher, HTTP API, Session manager, signal handling) moves under the daemon subcommand and must behave exactly as it does now.

Update the NixOS/systemd module so the service's ExecStart invokes evie daemon (it currently runs bare evie) — otherwise the split breaks the running service. Decide and document the behavior of a bare evie invocation (either alias to daemon or print help); no other subcommands exist yet.

This is the "make the change easy" step: it creates the seam the Control Plane hangs off, and nothing else.

Acceptance criteria

evie daemon starts the process with identical behavior to the pre-split binary (Telegram + HTTP + sessions + idle cleanup, honoring --config).
evie --help lists the daemon subcommand.
The NixOS module runs evie daemon and the service starts cleanly.
Existing tests pass unchanged; no scheduling or delivery behavior is altered.
Respects ADR 0006 (Daemon vs CLI vocabulary from CONTEXT.md).

Blocked by

None - can start immediately

## Parent #55 ## What to build Prefactor only — no new user-facing behavior. Introduce a top-level `clap` subcommand layer so the binary can be either the long-running **Daemon** (`evie daemon`) or, later, a short-lived **CLI** issuing a single **Verb**. Today's entire startup path (config load, Telegram dispatcher, HTTP API, Session manager, signal handling) moves under the `daemon` subcommand and must behave exactly as it does now. Update the NixOS/systemd module so the service's `ExecStart` invokes `evie daemon` (it currently runs bare `evie`) — otherwise the split breaks the running service. Decide and document the behavior of a bare `evie` invocation (either alias to `daemon` or print help); no other subcommands exist yet. This is the "make the change easy" step: it creates the seam the Control Plane hangs off, and nothing else. ## Acceptance criteria - [ ] `evie daemon` starts the process with identical behavior to the pre-split binary (Telegram + HTTP + sessions + idle cleanup, honoring `--config`). - [ ] `evie --help` lists the `daemon` subcommand. - [ ] The NixOS module runs `evie daemon` and the service starts cleanly. - [ ] Existing tests pass unchanged; no scheduling or delivery behavior is altered. - [ ] Respects ADR 0006 (Daemon vs CLI vocabulary from CONTEXT.md). ## Blocked by - None - can start immediately

weiwen added the

ready-for-agent

label

2026-07-08 02:11:18 +08:00

weiwen referenced this issue

2026-07-08 02:11:43 +08:00

Control Plane socket + send verb (spine) #57

weiwen referenced this issue from a commit

2026-07-08 02:30:25 +08:00

feat: introduce evie daemon subcommand (#56)

weiwen referenced this issue from a pull request that will close it,

2026-07-08 02:30:40 +08:00