feat(cli): crowclaw -z one-shot mode + update --check preflight + opt-in data-dir backup (Hermes v0.12 parity)

[subinium]

Background

Hermes v0.12 (#15702, #15704, #15841, #16539, #16566) — hermes -z <prompt> non-interactive one-shot run; hermes update --check
preflight; opt-in pre-update HERMES_HOME backup.

Current state in CrowClaw

• packages/cli/src/index.ts boots the server / dashboard; no -z one-shot flag.
• No update --check; no pre-update data-dir backup.

Scope

• Modified: packages/cli/src/index.ts
• New: packages/cli/src/commands/oneshot.ts, packages/cli/src/commands/update.ts
• Tests: tests/cli-oneshot.test.ts, tests/cli-update-preflight.test.ts

Implementation sketch

1. crowclaw -z "<prompt>" [--model <m>] [--provider <p>] — runs agent loop once with stdin-or-flag prompt, prints final output, exits
2. crowclaw update --check — fetches latest release metadata, compares to current version, prints diff summary, exits without updating
3. crowclaw update --backup — tar.gz the data dir to ~/.crowclaw/backups/<timestamp>.tgz before applying update

Acceptance criteria

• crowclaw -z "echo hi" returns text and exit 0
• crowclaw -z honors stdin: echo "summarize" | crowclaw -z
• crowclaw update --check prints version diff without modifying anything
• --backup produces a restorable archive

Effort

S — three CLI surfaces; oneshot composes the existing agent loop.

Effect

Scriptability — CrowClaw becomes useful in shell pipelines without spinning up the server. Update safety — operators upgrade with confidence.

Source

Hermes #15702, #15704, #15841, #16539, #16566 · CrowClaw current: packages/cli/src/index.ts