cyberlegion 0.1.0 → 0.3.0

package/package.json

@@ -1,14 +1,13 @@
 {
   "name": "cyberlegion",
-  "version": "0.1.0",
-  "description": "Harness-agnostic agent session spawning, messaging, and dispatch over the filesystem",
+  "version": "0.3.0",
+  "description": "Harness-agnostic agent session spawning and messaging over the filesystem",
   "keywords": [
     "agent",
     "claude-code",
     "cursor",
     "codex",
     "inter-agent",
-    "dispatch",
     "tmux"
   ],
   "repository": {
@@ -34,7 +33,8 @@
     "dist"
   ],
   "dependencies": {
-    "commander": "^14.0.3"
+    "commander": "^14.0.3",
+    "cyber-mux": "0.3.0"
   },
   "devDependencies": {
     "@types/node": "^24.10.1",
@@ -52,8 +52,10 @@
   },
   "scripts": {
     "build": "tsdown",
+    "check:metaphor-free": "tsx src/check-metaphor-free.ts",
+    "check:spec": "sdd-check-specs",
     "dev": "tsx src/cli.ts",
-    "test": "pnpm build && vitest run src",
+    "test": "vitest run src",
     "test:watch": "vitest",
     "typecheck": "tsc --noEmit"
   }

package/readme.md

@@ -3,9 +3,9 @@
 [![npm version](https://img.shields.io/npm/v/cyberlegion.svg)](https://www.npmjs.com/package/cyberlegion)
 [![license: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
 
-Harness-agnostic, MCP-free agent session spawning, messaging, and dispatch over the filesystem (Claude Code, Cursor, Codex).
+Harness-agnostic, MCP-free agent session spawning and messaging over the filesystem (Claude Code, Cursor, Codex).
 
-The CLI is pure mechanism — dumb hands a routing layer composes. It never decides *how* to reach a peer (warm-peer session vs cold subagent vs run-inline); it just spawns, messages, and dispatches. State lives under a shared hub root (`$CYBERLEGION_ROOT`, else the global hub).
+The CLI is pure mechanism — dumb hands a routing layer composes. It never decides *how* to reach a peer (warm-peer session vs cold subagent vs run-inline); it just spawns and messages, and the routing brain composes those primitives (spawn a peer + await its mail, or run a cold subagent and take its Task result). State lives under a shared hub root (`$CYBERLEGION_ROOT`, else the global hub).
 
 ## Usage
 
@@ -23,24 +23,19 @@ npx cyberlegion@0.1.0 <command>
 
 ## Commands
 
-### identity — self-identify and discover peers
+### unit — self-identify, discover peers, and manage session lifecycle
 
 ```sh
-npx cyberlegion identity register --handle scout   # register/refresh this session
-npx cyberlegion identity whoami                     # print your own identity
-npx cyberlegion identity who                        # list addressable peers
-npx cyberlegion identity prune                      # mark dead agents exited and sweep
-```
-
-### session — warm peer session lifecycle over a multiplexer
-
-```sh
-npx cyberlegion session spawn --agent reviewer      # launch a peer in its own git worktree (tmux/herdr)
-npx cyberlegion session list                         # list live peer sessions
-npx cyberlegion session focus <ref>                  # move input focus to a peer's session
-npx cyberlegion session nudge <ref>                  # ring a peer's session (doorbell)
-npx cyberlegion session read <ref>                   # scrape a peer's session screen
-npx cyberlegion session close <id>                   # tear down worktree + session, reap state
+npx cyberlegion unit register --handle scout        # register/refresh this session
+npx cyberlegion unit register --standing --handle homa  # mint a standing, session-independent owner inbox
+npx cyberlegion unit whoami                          # print your own identity
+npx cyberlegion unit who                             # list addressable peers / live peer sessions
+npx cyberlegion unit prune                           # mark dead agents exited and sweep
+npx cyberlegion unit spawn --agent reviewer          # launch a peer in its own git worktree (tmux/herdr)
+npx cyberlegion unit focus <ref>                     # move input focus to a peer's session
+npx cyberlegion unit nudge <ref>                     # ring a peer's session (doorbell)
+npx cyberlegion unit read <ref>                      # scrape a peer's session screen
+npx cyberlegion unit close <id>                      # tear down worktree + session, reap state
 ```
 
 ### mail — durable inter-agent messaging
@@ -56,14 +51,6 @@ npx cyberlegion mail watch                           # stream new matching mail
 npx cyberlegion mail hook                            # emit the harness hook injection payload (JSON)
 ```
 
-### dispatch — delegate work and await a result
-
-```sh
-npx cyberlegion dispatch prep                        # allocate id + brief + result slot (spawns nothing)
-npx cyberlegion dispatch channel --agent worker --wait  # prep + spawn + await the reply
-npx cyberlegion dispatch collect <id>                # read + validate a subagent's result file
-```
-
 ### agent — resolve reusable agent definitions
 
 Reads definitions under `.agents/agents/`.
@@ -75,12 +62,30 @@ npx cyberlegion agent resolve <name>                 # emit the full machine pay
 npx cyberlegion agent path <name>                    # print the resolved def file path
 ```
 
-### admin — setup and diagnostics
+### mux — multiplexer diagnostics
+
+```sh
+npx cyberlegion mux doctor                           # probe harness, multiplexer, hub root, self-id
+npx cyberlegion mux mode                              # report the detected session-backend mode
+```
+
+### init — onboarding
+
+```sh
+npx cyberlegion init                                 # wire the mail-surfacing hook into a harness config
+```
+
+### attach — the human's read-pane
+
+```sh
+npx cyberlegion attach                               # bind this pane as the hub's main (owner) pane
+npx cyberlegion attach --show                        # print the bound main pane
+npx cyberlegion attach --clear                       # unbind the main pane
+```
+
+### admin — hub-state maintenance
 
 ```sh
-npx cyberlegion admin install                        # wire the mail-surfacing hook into a harness config
-npx cyberlegion admin doctor                         # probe harness, multiplexer, hub root, self-id
-npx cyberlegion admin mode                            # report the detected session-backend mode
 npx cyberlegion admin migrate                        # merge one hub root state into another
 ```