Skip to content

Releases: BrainSurfing-tech/swarph-cli

swarph-cli v0.7.0 — Phase 7 sprint complete

10 May 19:32
4bffb2d

Choose a tag to compare

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 function read_starter_prompt(cell) in swarph_cli.cell. swarph-shared Cell is pure-stdlib + no I/O; file read lives at swarph-cli operator-tooling layer.
  • All other swarph_cli.cell imports 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-cli

Watchdog cron usage

*/5 * * * * swarph watchdog --check --cell lab --no-respawn \
            >> ~/.local/log/swarph-watchdog.log 2>&1

Drop --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

10 May 05:48
4ab7218

Choose a tag to compare

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 with claude --name <role> --session-id <uuid> --append-system-prompt <starter>
  • cell.yaml v1 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.yaml auto-discovery + --onboarding URL/path discriminator
  • Mitosis-glyph startup banner

Install

pip install swarph-cli==0.6.0
# or
pipx install swarph-cli

Tests

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