Releases: BrainSurfing-tech/swarph-cli
swarph-cli v0.7.0 — Phase 7 sprint complete
Phase 7 sprint complete — substrate-doc R7 §11.1.7 operator-tooling layer
Five increments shipped overnight per AI² lane (mother + beta + alpha + lab + commander):
What ships
| Increment | What |
|---|---|
PR-A --new-instance |
Sibling-spawn flag — mints fresh UUID; sidecar untouched |
| PR-B auto-suffix | Sibling slots <role>-2..99; swarph spawn <role>-N resumes |
| PR-C SessionStart hook | swarph install-hook + swarph hook-output — closes bare-claude operator-paste gap |
| watchdog | Stranded-session detection + recovery (cron-callable; A1 tmux send-keys → A2 swarph spawn respawn) |
| PR-D cell.yaml relocation | Cell schema graduates to swarph-shared 0.3.0 kernel-tier |
Migration note (v0.6 → v0.7)
Cell.starter_prompt_text()method removed — replaced with free functionread_starter_prompt(cell)inswarph_cli.cell. swarph-shared Cell is pure-stdlib + no I/O; file read lives at swarph-cli operator-tooling layer.- All other
swarph_cli.cellimports unchanged (re-exports cover everything). - v0.6 cell.yaml files keep working unchanged — schema FROZEN at v1.
Install
pip install --upgrade swarph-cli # pulls swarph-shared>=0.3.0 transitively
# or
pipx upgrade swarph-cliWatchdog cron usage
*/5 * * * * swarph watchdog --check --cell lab --no-respawn \
>> ~/.local/log/swarph-watchdog.log 2>&1Drop --no-respawn flag after observing logs for a few days to flip from dry-run to active recovery.
Substrate-doc R7 §11.1.5 (O5) RESOLVED
cell.yaml-format-home is now swarph-shared kernel-tier per commander #872 + drop-mother #870/#874 + science-claude #864 originator + lab + mother convergence.
Co-authored
Pierre Samson + Claude Opus + drop-on-meta-edge sibling daughters (alpha + beta) + drop-mother on droplet — 6-round three-way+sibling-pair authorship pattern (project_three_way_authorship_pattern.md).
swarph-cli 0.6.0 — Phase 7 swarph spawn
Phase 7 — swarph spawn <role> (operator-tooling layer)
First implementation of substrate-doc R7 §11.1.7's 4-layer R2 mechanism stack — wraps claude with R5/R7 disambiguation flags so sibling cell-instances on shared peer-id are distinguishable at the session-resume layer.
╭───╮
│ ◉ │
╭──┴───┴──╮
│ swarph │ v0.6.0
╰──┬───┬──╯ spawn │ chat │ daemon
│ ◉ │
╰───╯
What ships
swarph spawn <role-or-path>— exec-replaces withclaude --name <role> --session-id <uuid> --append-system-prompt <starter>cell.yamlv1 schema (FROZEN — v0.7 swarph-shared migration is symbol-relocation only)- Atomic sidecar UUID persistence at
$XDG_STATE_HOME/swarph/sessions/<role>.session-id ./cell.yamlauto-discovery +--onboardingURL/path discriminator- Mitosis-glyph startup banner
Install
pip install swarph-cli==0.6.0
# or
pipx install swarph-cliTests
200 pass + 3 skipped (live-API gates). 43 new tests in test_cell_loader.py + test_spawn_command.py.
Spec
Full Phase 7 spec: hedge-fund-mcp PLAN.md §18 (commit d80ee90).
🤖 Co-authored by Pierre Samson + Claude Opus