@a-t-h-i/bot-lobby 0.6.21 → 0.6.22

package/README.md

@@ -1,8 +1,10 @@
 # Bot-Lobby
 
-A [Pi](https://pi.dev) extension for intentional, multi-agent software development.
-Describe a change, agree on a plan with the oracle, and follow the domain agents in a local browser lobby.
-The engine enforces approvals, domain boundaries and QA before completion.
+A [Pi](https://pi.dev) extension for multi-agent software development. Describe a change, agree a plan
+with the oracle, and follow the agents in a local browser lobby. Approvals, domain boundaries and QA
+are enforced before anything is called done.
+
+![The Lobby: the conversation, the agents' activity and the Thinking orb](.github/screenshots/lobby.png)
 
 ## Install
 
@@ -10,84 +12,44 @@ The engine enforces approvals, domain boundaries and QA before completion.
 pi install npm:@a-t-h-i/bot-lobby
 ```
 
-Try without installing: `pi -e npm:@a-t-h-i/bot-lobby`.
-From a checkout: `pi -e ./src/index.ts` (keep `prompts/` beside `src/`).
-Questionnaire and web tools are included; don't also install extensions registering the same tool names.
-
-## Quick start
+Try it first with `pi -e npm:@a-t-h-i/bot-lobby`, or from a checkout with `pi -e ./src/index.ts`.
+The questionnaire and web tools are built in, so don't also install extensions with the same tool names.
 
-1. Run `/bot-lobby add a login page` in Pi; the lobby opens in your browser.
-2. Answer the oracle's questions and approve its proposal, or use Plan to agree on a task first.
-3. Follow the agents in Lobby; configure models, effort and time limits in Settings.
+## Use
 
-The project switcher (top left, `P`) switches among already-running, authorized project lobbies on one localhost origin.
-Upgrading? Reattach older temporary files; previews and attachments are now isolated per project.
+1. In Pi, run `/bot-lobby add a login page`. The lobby opens in your browser.
+2. Answer the oracle's questions and approve its plan, or agree one with the panel in **Plan** first.
+3. Follow the agents in **Lobby**. Models, effort and time limits are in **Settings**.
 
-Small self-contained changes can route to Quick fix. `--task` forces a task;
-`--fast` / `--full` picks its workflow, and `--branch` / `--worktree` selects git isolation.
-Completed isolated tasks push their branch and attempt a GitHub PR through `gh`.
-Missing isolation, base branch, remote or authentication records a note without blocking completion; nothing auto-merges.
+Small changes go to **Quick fix**. `--task` forces a full task, `--fast` / `--full` picks the workflow,
+and `--branch` / `--worktree` isolates it in git. A finished isolated task pushes its branch and tries
+to open a PR through `gh`; nothing merges on its own.
 
-## Agent split
-
-| Agent | Responsibility |
+| Agent | Does |
 | --- | --- |
-| Master / oracle | Your Pi session: questions, decisions, plan, delegation and approvals |
-| DESIGN | Browser UI, frontend logic, styling and accessibility |
+| Oracle | Your Pi session: questions, plan, delegation and approvals |
+| DESIGN | UI, frontend logic, styling and accessibility |
 | DEV | Backend, APIs, data, security and integrations |
 | QA | Targeted tests and the final quality gate |
-| RESEARCH | External facts and cited evidence |
-
-The planning panel brings these domains together before implementation.
-Own ordinary Plan messages and Task comments can be edited; Plan edits rerun the panel.
+| RESEARCH | External facts, with sources |
 
-## Shortcuts
+## Keys
 
-Browser navigation is ignored while typing, composing with an IME or using an overlay.
+The lobby is keyboard-first, and every action button shows its key (`Archive E`, `Delete Del`).
+`Alt+1`…`Alt+9` switch tabs, `j` / `k` move through lists, `/` focuses search or the message box,
+`p` switches project, `d` flips the theme and `?` lists every key. Alt and Ctrl shortcuts can be
+rebound with `lobby.keys`. In Pi, `Alt+G` toggles auto mode and `Ctrl+Shift+M` hides or restores bot-lobby.
 
-| Key | Action |
-| --- | --- |
-| `Alt+1`…`Alt+9`, bare `1`…`9` | Jump to the corresponding visible tab |
-| `Alt+[` / `Alt+]` | Previous / next tab |
-| `j` / `k` | Next / previous selectable list row |
-| `g` then a letter | Jump to a named tab (mapping below) |
-| `/` | Focus the current tab's search, when available |
-| `p` | Open the project switcher |
-| `d` | Switch between light and dark |
-| `?`, `Alt+H` | Shortcut help |
-| `Esc` | Close the top overlay or cancel a pending navigation prefix |
-| `Alt+S` | Settings |
-| `Alt+O` | Sessions |
-| `Alt+A` / `Alt+T` | Fold / expand Activity / Thinking |
-| `Ctrl+S` | Save the plan on Plan |
-
-Every action button prints its key (`Archive E`, `Delete Del`) and the key works while the list or
-the detail has focus (press `Esc` first to leave the message box). Keys that cannot be undone ask first;
-in that question `Y` confirms and `Esc` keeps.
+## Screenshots
 
-| Page | Keys |
+| Plan | Tasks |
 | --- | --- |
-| Tasks | `e` archive, `r` restore, `a` auto mode, `Delete` delete |
-| Saved plan | `s` start here, `n` new session, `Delete` discard |
-| Plan | `a` answer questions, `r` retry, `Ctrl+S` save, `n` new plan |
-| Quick fix | `r` run anyway, `t` make it a task, `c` cancel |
-| Git | `r` refresh, `v` review, `q` Jev's read, `x` stop the review |
-| Issues | `r` refresh |
-| Knowledge | `e` edit, `a` add, `c` comment, `f` edit the file, `Delete` delete |
-| Excalidraw | `r` reveal, `c` copy, `o` open, `w` let agents draw, `t` check, `Delete` remove |
-| Sessions | `m` move here, `s` stop, `b` back to the Lobby |
-
-`g` mapping: `l` Lobby, `p` Plan, `t` Tasks, `i` Issues, `u` Git,
-`s` Sessions, `n` Knowledge, `q` Quick fix, `m` Metrics, `e` Settings, `x` Excalidraw.
-Configured Alt/Ctrl actions are rebindable through `lobby.keys`; defaults live in
-[`src/lobby/keys.ts`](src/lobby/keys.ts). Bare browser aliases are additional navigation keys.
-In Pi, `Alt+G` toggles auto mode and `Ctrl+Shift+M` minimizes/restores the plugin.
-
-## Configuration and docs
+| ![The Plan start page: the panel as seats](.github/screenshots/plan.png) | ![A task with its action bar](.github/screenshots/tasks.png) |
+| **Thinking** | **Excalidraw** |
+| ![Each agent's latest thought, in steps](.github/screenshots/thinking.png) | ![A shared Excalidraw session](.github/screenshots/excalidraw.png) |
 
-Settings are user-global in `~/.pi/bot-lobby/config.json`;
-`BOT_LOBBY_CONFIG_DIR` overrides the directory. `/bot-lobby config` shows effective settings.
-Tasks and project knowledge stay under `.pi/bot-lobby/` in the project.
+## Configuration
 
-See [Architecture and guide](docs/architecture.md) for commands, workflow, planning,
-classifier, web tools, Excalidraw, configuration, recovery and development details.
+Settings live in `~/.pi/bot-lobby/config.json` (`BOT_LOBBY_CONFIG_DIR` moves them), and
+`/bot-lobby config` shows what is in effect. Tasks and project knowledge stay in `.pi/bot-lobby/`
+inside your project.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@a-t-h-i/bot-lobby",
-  "version": "0.6.21",
+  "version": "0.6.22",
   "description": "Structured multi-agent software engineering orchestrator for Pi",
   "type": "module",
   "license": "Apache-2.0",
@@ -35,7 +35,7 @@
     "extensions": [
       "./src/index.ts"
     ],
-    "image": "https://raw.githubusercontent.com/a-t-h-i/bot-lobby/main/docs/gallery.png"
+    "image": "https://raw.githubusercontent.com/a-t-h-i/bot-lobby/main/.github/screenshots/lobby.png"
   },
   "scripts": {
     "typecheck": "tsc --noEmit && tsc -p webui --noEmit",

package/src/webui/dev/fake-service.ts

@@ -236,7 +236,10 @@ function seedFeed(feed: LobbyFeed, fixture: ScenarioFixture): void {
     if (entry.pending) feed.begin(entry.source, entry.text);
     else feed.log(entry.source, entry.text, entry.kind);
   }
-  for (const entry of fixture.feed.thoughts) feed.thought(entry.source, entry.text);
+  for (const entry of fixture.feed.thoughts) {
+    if (entry.live) feed.thinkDelta(entry.source, entry.text);
+    else feed.thought(entry.source, entry.text);
+  }
   if (fixture.feed.reply) feed.replyDelta(fixture.feed.reply);
 }
 

package/src/webui/dev/fixtures.ts

@@ -47,7 +47,8 @@ export interface ScenarioFixture {
   feed: {
     chat: Array<{ role: ChatRole; text: string }>;
     activity: Array<{ source: string; text: string; kind: "info" | "success" | "warning" | "error"; pending: boolean }>;
-    thoughts: Array<{ source: string; text: string }>;
+    /** `live` thoughts are still streaming, as an agent thinking now. */
+    thoughts: Array<{ source: string; text: string; live?: boolean }>;
     reply: string;
     chatOlder: boolean;
   };