@wrongstack/cli 0.1.10 → 0.3.1

package/README.md

@@ -31,7 +31,7 @@ wstack mcp add <preset>       # add an MCP server (see @wrongstack/mcp)
 wstack mcp list               # show configured MCP servers
 ```
 
-`--no-tui` forces REPL mode even when `--tui` is configured globally. `--alt-screen` opts into Ink's alt-screen rendering (off by default so the user keeps native scrollback).
+`--no-tui` forces REPL mode even when `--tui` is configured globally. The TUI uses Ink's alt-screen buffer by default so it can capture every keystroke (Ctrl+S/Q/Z/\\ included) and avoid live-region leaks into scrollback; pass `--no-alt-screen` if you specifically want completed chat to survive after exit.
 
 ## Slash commands inside the REPL/TUI
 
@@ -47,6 +47,10 @@ wstack mcp list               # show configured MCP servers
 /context             # show token usage breakdown
 /sessions            # list past sessions
 /resume <id>         # resume a session
+/todos [show|add|done|clear]    # tactical task board (auto-checkpointed)
+/plan  [show|add|start|done|remove|clear]   # strategic roadmap (persistent across resume)
+/director            # promote the current session into multi-agent director mode
+/fleet status|usage|kill|manifest|retry [taskId|all]|log [<id> [raw]]  # inspect/control + retry + view subagent transcripts
 /exit                # quit
 ```
 
@@ -59,12 +63,24 @@ wstack mcp list               # show configured MCP servers
 ~/.wrongstack/skills/                user-global skills
 ~/.wrongstack/projects/<hash>/       per-project state
   memory.md                          project memory (auto-gitignored)
-  sessions/                          JSONL session logs
+  sessions/                          per-session artifacts
+    <id>.jsonl                       append-only event log (messages, tool calls, task_* events)
+    <id>.summary.json                fast-path manifest read by /sessions
+    <id>.todos.json                  ctx.todos checkpoint (atomic-written on every mutation)
+    <id>.plan.json                   /plan strategic roadmap (atomic-written on every mutation)
+    <id>/                            multi-agent (director mode) fleet workspace
+      fleet.json                     director manifest (debounced ~2s; final on shutdown)
+      director-state.json            live task graph: pending/running/completed + spawn roster
+      shared/                        cross-subagent scratchpad (markdown findings)
+      subagents/<runId>/<subagentId>.jsonl   per-subagent transcripts
+      attachments/                   spooled images/files for the session
   trust.json                         per-project tool/permission trust
 .wrongstack/AGENTS.md                committable project memory
 .wrongstack/skills/                  committable project skills
 ```
 
+**Resume semantics.** `wstack --resume <id>` replays the messages JSONL into the agent context, reloads `<id>.todos.json` if present, and surfaces a banner summarizing any prior plan items and unfinished fleet tasks. Per-subagent transcripts under `subagents/` survive crashes — combine with the `director-state.json` checkpoint to inspect what each worker was doing when the run was interrupted.
+
 API keys are encrypted at rest with AES-256-GCM and the key file at `~/.wrongstack/.key`. The vault auto-bootstraps on first run; the key never leaves the machine.
 
 ## Flags
@@ -76,7 +92,7 @@ API keys are encrypted at rest with AES-256-GCM and the key file at `~/.wrongsta
 | `--provider <id>` | Override the configured provider |
 | `--model <id>` | Override the configured model |
 | `--resume <id>` | Resume a saved session by id |
-| `--alt-screen` | Opt into alt-screen TUI rendering |
+| `--no-alt-screen` | Render TUI inline in scrollback (default is alt-screen so all shortcuts are captured). |
 | `--config <path>` | Use a non-default config file |
 | `--debug` | Verbose logging to `~/.wrongstack/logs/wrongstack.log` |
 | `--version` | Print version |