@parallel-cli/parallel 0.4.4 → 0.4.6

package/CHANGELOG.md

@@ -2,6 +2,56 @@
 
 All notable changes to Parallel are documented here.
 
+## 0.4.6 - 2026-06-24
+
+### 0.4.6 Added
+
+- Added an interactive npm update prompt on startup with daily cache, CI/headless/attach skips, `PARALLEL_SKIP_UPDATE_CHECK=1`, and `--no-update`.
+- Added a Codex-like empty hub with a quieter framed header, cream-toned accents, and a full-width prompt block with distinct background.
+- Added a complete paginated slash palette driven by one deterministic rendered order.
+- Added selectable `/help` command navigation with visible highlight and Enter-to-run behavior.
+- Added localized prompt placeholder copy and an i18n audit to keep all used UI keys translated.
+
+### 0.4.6 Changed
+
+- Reduced default Hub noise by removing persistent startup toasts, duplicate task hints, and always-on command footer lines.
+- Replaced blue/cyan UI accents with a softer cream theme across hub, palettes, wizard/settings lists, markdown summaries, and attached agent terminals.
+- Made the prompt block start at three rows, grow when input wraps, and show the blinking cursor on the first placeholder character while empty.
+- Reused the same minimal prompt treatment in dedicated agent terminals and toned down their footer.
+- Simplified agent rows so secondary telemetry only appears when there is a useful latest signal or result.
+- Moved command palette priority to shared command helpers so autocomplete, help, and rendering stay aligned.
+
+### 0.4.6 Fixed
+
+- Fixed slash palette Up/Down navigation jumping to visually unrelated commands.
+- Fixed `/help` being scrollable but not actually selectable.
+- Fixed Wizard and Settings selection lists wrapping around unexpectedly by clamping navigation at list boundaries.
+
+## 0.4.5 - 2026-06-23
+
+### 0.4.5 Added
+
+- Added explicit hub, focus, and attach input contexts with context-specific hints and filtered command suggestions.
+- Added agent argument autocomplete for `/focus`, `/send`, `/attach`, `/pause`, `/resume`, `/stop`, `/restore`, and `/commit`.
+- Added attach-terminal routing for `@all`, `@agent`, and `/send`, so dedicated terminals can broadcast or steer another agent through the main session.
+- Added richer hub rows using latest useful agent signals, specialist badges, context percentage, and responsive timeline widths.
+- Added durable session memory for claims, recent diff excerpts, file activity, work-map warnings, agent aliases, provider/model metadata, specialist, and context usage.
+- Added shell mutation tracking: files changed by `run_command` now appear in live diffs, file activity, and agent commit ownership.
+- Added a non-blocking work map that surfaces overlapping claims and repeated co-edit conflicts in `/board` and agent context.
+
+### 0.4.5 Changed
+
+- Clarified agent naming around `Name: task` syntax in README examples.
+- Made `/raw` visible only when it affects the active focus view.
+- Reset focus scroll follow-tail behavior when switching focused agents.
+- Improved session restore so `/restore` can target saved agents by name, alias, or id when their conversation is available.
+
+### 0.4.5 Fixed
+
+- Fixed attach-terminal `@all` being treated as plain text to the attached agent.
+- Fixed restored note ids drifting by resynchronizing blackboard note and change sequences after loading session data.
+- Fixed shell-created edits being invisible to `/diff`, `/board`, and `/commit`.
+
 ## 0.4.4 - 2026-06-23
 
 ### 0.4.4 Added

package/README.md

@@ -16,13 +16,17 @@ Parallel lets you run several AI coding agents on the same repository at the sam
 - Run multiple agents in parallel on one project.
 - Choose explicit modes: `/ask`, `/task`, and `/plan`.
 - Type plain text to launch a task agent immediately.
+- Use context-aware input in the hub, focus view, and attached agent terminals.
 - Steer one agent with `@a1 ...` or broadcast with `@all ...`.
 - Open dedicated agent terminals with native scrollback.
+- Use a cleaner Codex-like hub with a framed header, focused prompt bar, and quieter empty state.
 - Review agents, notes, file activity, diffs, cost, skills, specialists, and saved sessions from the TUI.
+- Track shell-created file mutations in the same live diff feed as agent edits.
 - Configure OpenAI-compatible providers through a guided wizard and settings panel.
 - Use 29 provider presets across Western, Chinese, Gateway, Inference, and Local categories.
 - Support local no-key endpoints such as Ollama and vLLM/SGLang.
 - Keep shell execution controlled with `ask`, `auto-safe`, or `yolo` approvals.
+- Get prompted for npm updates at startup, with an explicit skip path.
 - Save and restore project sessions.
 - Run headless multi-agent jobs for CI or scripts.
 
@@ -79,9 +83,9 @@ Plain text launches a `/task` agent. You can launch another agent while the firs
 Use explicit modes when intent matters:
 
 ```text
-/ask reviewer should we split the CLI parser?
-/plan migration propose the safest rollout for the config change
-/task builder implement the approved plan
+/ask Reviewer: should we split the CLI parser?
+/plan Migration: propose the safest rollout for the config change
+/task Builder: implement the approved plan
 ```
 
 Steer a running agent:
@@ -114,7 +118,9 @@ Plain text is equivalent to `/task`.
 
 ## Control Room
 
-The main TUI is the Parallel hub. It is designed to answer:
+The main TUI is the Parallel hub. The default view stays intentionally quiet: a Codex-like framed header, cream-toned accents, a focused prompt block, and detailed status moved into explicit views.
+
+It is designed to answer:
 
 - what needs your input
 - which agents are working
@@ -122,6 +128,19 @@ The main TUI is the Parallel hub. It is designed to answer:
 - what changed in the project
 - what model, provider, shell mode, and cost are active
 
+Input has three explicit contexts:
+
+- Hub: plain text launches a new `/task` agent. Slash suggestions show hub commands and agent arguments autocomplete for `/focus`, `/send`, `/attach`, `/pause`, `/resume`, `/stop`, `/restore`, and `/commit`.
+- Focus: after `/focus a1`, plain text talks to the focused agent instead of spawning a new one. `/raw` affects this view only.
+- Attach: in `parallel attach a1`, the same minimal prompt UI steers the attached agent. `/task`, `/ask`, and `/plan` spawn new agents from that terminal, while `@all ...`, `@a2 ...`, and `/send ...` route instructions through the main session.
+
+Use `Name: task` when naming an agent:
+
+```text
+/task Tests: add regression coverage for the auth middleware
+/plan Migration: outline the safest database rollout
+```
+
 Common hub commands:
 
 - `/agents`: agent overview.
@@ -141,9 +160,11 @@ Commands are typed in the control room input. When a long view is open, use Esca
 Keyboard behavior:
 
 - `/` opens slash command suggestions.
-- Up/Down selects suggestions when a suggestion menu is open.
+- Up/Down selects suggestions in the same order they appear.
 - Enter accepts the selected suggestion.
 - Tab or Right accepts the best completion.
+- `/help` is keyboard navigable: Up/Down moves the visible selection, PgUp/PgDn pages, and Enter runs the selected command.
+- Wizard, settings, slash suggestions, and help views use clamped keyboard selection so the highlight does not jump, disappear, or wrap unexpectedly.
 - PgUp/PgDn scrolls the hub or focus view even while the input is active. Up/Down scrolls long views and navigates suggestions/history.
 - Escape returns to the agents view or clears the input.
 
@@ -170,9 +191,12 @@ From an attached terminal:
 
 ```text
 plain text sends a message to this agent
-/task write parser regression tests
-/ask is this result safe to merge?
-/plan prepare a migration plan
+@all pause public interface changes until tests finish
+@a2 re-read the API client before editing it
+/send a2 check the new parser contract
+/task Tests: write parser regression tests
+/ask Reviewer: is this result safe to merge?
+/plan Migration: prepare a migration plan
 /raw
 /quit
 ```
@@ -220,6 +244,19 @@ Environment variables:
 - `PARALLEL_BASE_URL`: override the default provider base URL.
 - `PARALLEL_MODEL`: override the session model.
 - `PARALLEL_NO_ALT_SCREEN=1`: disable the alternate terminal screen.
+- `PARALLEL_SKIP_UPDATE_CHECK=1`: disable npm update checks.
+
+## Updates
+
+On interactive startup, Parallel checks npm at most once per day for a newer `@parallel-cli/parallel` version. The check is skipped in `attach`, `--headless`, `--first-run`, CI, non-TTY sessions, or when `PARALLEL_SKIP_UPDATE_CHECK=1` is set.
+
+When an update is available, Parallel asks before running:
+
+```bash
+npm install -g @parallel-cli/parallel
+```
+
+If the update succeeds, restart Parallel to run the new version. Use `parallel --no-update` for a one-off launch without checking.
 
 ## Commands
 
@@ -266,7 +303,14 @@ Environment variables:
 - `/save [name]`: save the current session.
 - `/sessions`: list saved sessions.
 - `/session <n|latest>`: load a saved session snapshot. If active agents are running, use `/session <n|latest> --force` after saving/stopping what you need.
-- `/restore <agent>`: relaunch a restored agent with its conversation history.
+- `/restore <agent>`: relaunch a restored agent by name, alias, or saved id when its conversation history is still available.
+
+Session memory has two layers:
+
+- Live memory: active agents see statuses, notes, claims, work-map warnings, file activity, and recent diffs before every model action.
+- Durable memory: `/save` and autosave persist notes, claims, recent diff excerpts, file activity, work-map warnings, agent aliases, model/provider metadata, context usage, and conversation paths for restore.
+
+Restore is best effort and explicit. `/session` reloads coordination memory into the blackboard; `/restore <agent>` relaunches an agent only when the saved conversation file still exists. Restored agents keep their prior task, mode, model, specialist, and conversation when available.
 
 ### Settings And Exit
 
@@ -336,6 +380,10 @@ When an agent writes a file:
 
 This keeps agents moving without allowing silent overwrites.
 
+Commands run through `run_command` are also snapshotted before and after execution. If a shell command edits, creates, or deletes tracked project files, Parallel records those mutations in `/diff`, `/board`, and `/commit` ownership just like tool-based edits.
+
+The work map is advisory, not a lock. Agents can declare claims with `claim_files`; Parallel detects overlapping claims and repeated conflicts, then shows non-blocking warnings in `/board` and injects them into agent context so agents can coordinate before collisions become expensive.
+
 ## Headless Mode
 
 For CI and scripts, run without the TUI:

package/dist/agents/tools.js

@@ -2,7 +2,7 @@ import fs from 'node:fs';
 import path from 'node:path';
 import { exec } from 'node:child_process';
 import * as Diff from 'diff';
-const IGNORED = new Set(['node_modules', '.git', '.parallel', 'dist', '__pycache__', '.venv', 'venv']);
+const IGNORED = new Set(['node_modules', '.git', '.parallel', '.cursor', 'dist', '__pycache__', '.venv', 'venv']);
 const MAX_OUTPUT = 12_000;
 const MUTATING_TOOLS = new Set(['write_file', 'edit_file', 'claim_files', 'remember']);
 function isMutatingShell(command) {
@@ -269,6 +269,60 @@ export class ToolExecutor {
     relOf(p) {
         return path.relative(this.projectRoot, this.resolve(p)) || '.';
     }
+    snapshotProject() {
+        const snapshot = new Map();
+        const walk = (dir, depth) => {
+            if (depth > 8)
+                return;
+            let entries;
+            try {
+                entries = fs.readdirSync(dir, { withFileTypes: true });
+            }
+            catch {
+                return;
+            }
+            for (const e of entries) {
+                if (IGNORED.has(e.name) || e.name.startsWith('.git'))
+                    continue;
+                const full = path.join(dir, e.name);
+                const relPath = path.relative(this.projectRoot, full);
+                if (e.isDirectory()) {
+                    walk(full, depth + 1);
+                    continue;
+                }
+                if (!e.isFile())
+                    continue;
+                try {
+                    const stat = fs.statSync(full);
+                    if (stat.size > 750_000)
+                        continue;
+                    snapshot.set(relPath, fs.readFileSync(full, 'utf8'));
+                }
+                catch {
+                    /* binary/unreadable files are ignored for diff tracking */
+                }
+            }
+        };
+        walk(this.projectRoot, 0);
+        return snapshot;
+    }
+    recordShellMutations(before) {
+        const after = this.snapshotProject();
+        const paths = new Set([...before.keys(), ...after.keys()]);
+        let count = 0;
+        for (const relPath of [...paths].sort()) {
+            const oldContent = before.get(relPath);
+            const newContent = after.get(relPath);
+            if (oldContent === newContent)
+                continue;
+            this.board.addChange(this.agentId, relPath, oldContent ?? '', newContent ?? '');
+            this.board.recordActivity(relPath, this.agentId, 'shell');
+            count++;
+        }
+        if (count > 0)
+            this.board.log(this.agentId, 'tool', `✏ shell changed ${count} file${count === 1 ? '' : 's'}`);
+        return count;
+    }
     async execute(name, args) {
         try {
             const guard = this.guardTool(name, args);
@@ -592,6 +646,7 @@ export class ToolExecutor {
         }
         this.board.setAgentState(this.agentId, 'working', `$ ${command.slice(0, 60)}`);
         this.board.log(this.agentId, 'tool', `$ ${command}`);
+        const before = this.snapshotProject();
         return new Promise((resolve) => {
             exec(command, { cwd: this.projectRoot, timeout: 120_000, maxBuffer: 4 * 1024 * 1024 }, (err, stdout, stderr) => {
                 let out = '';
@@ -606,8 +661,9 @@ export class ToolExecutor {
                 if (out.length > MAX_OUTPUT)
                     out = out.slice(0, MAX_OUTPUT) + '\n... (output truncated)';
                 const result = out || '(no output, success)';
+                const changed = this.recordShellMutations(before);
                 this.board.log(this.agentId, 'tool_result', result);
-                resolve(result);
+                resolve(changed > 0 ? `${result}\n\nTracked shell mutations: ${changed} file${changed === 1 ? '' : 's'}.` : result);
             });
         });
     }

package/dist/commands.js

@@ -60,12 +60,43 @@ export const COMMANDS = [
 export function visibleCommands() {
     return COMMANDS.filter((c) => !c.hidden);
 }
+const COMMAND_GROUP_ORDER = ['modes', 'control', 'views', 'settings', 'git', 'other'];
+const COMMAND_PALETTE_PRIORITY = [
+    '/ask',
+    '/task',
+    '/plan',
+    '/send',
+    '/focus',
+    '/attach',
+    '/agents',
+    '/board',
+    '/diff',
+    '/settings',
+    '/help',
+    '/quit',
+];
+function commandRank(c) {
+    const priority = COMMAND_PALETTE_PRIORITY.indexOf(c.name);
+    if (priority !== -1)
+        return priority;
+    const group = COMMAND_GROUP_ORDER.indexOf(c.group ?? 'other');
+    return COMMAND_PALETTE_PRIORITY.length + group * 100 + COMMANDS.indexOf(c);
+}
+export function sortCommandsForPalette(commands) {
+    return [...commands].sort((a, b) => commandRank(a) - commandRank(b) || a.name.localeCompare(b.name));
+}
 export function matchCommands(input, opts = {}) {
     if (!input.startsWith('/'))
         return [];
     const word = input.split(/\s+/)[0].toLowerCase();
     return COMMANDS.filter((c) => opts.includeHidden || !c.hidden).filter((c) => c.name.startsWith(word) || c.aliases?.some((a) => a.startsWith(word)));
 }
+export function commandPalette(input, opts = {}) {
+    const allowed = opts.allowedNames
+        ? (c) => opts.allowedNames.includes(c.name) || c.aliases?.some((a) => opts.allowedNames.includes(a))
+        : () => true;
+    return sortCommandsForPalette(matchCommands(input, opts).filter(allowed));
+}
 function agentList(ctl) {
     return [...ctl.board.agents.values()].map((a) => a.name).join(', ') || t('m.none');
 }

package/dist/controller.js

@@ -9,7 +9,7 @@ import { saveConfig, getProvider, upsertProvider } from './config.js';
 import { priceFor, fmtCost } from './pricing.js';
 import { loadSkills, loadSpecialists } from './skills.js';
 import { t } from './i18n.js';
-const AGENT_COLORS = ['cyan', 'magenta', 'yellow', 'green', 'blue', 'redBright', 'cyanBright', 'magentaBright'];
+const AGENT_COLORS = ['#f3e7c7', 'magenta', 'yellow', 'green', 'whiteBright', 'redBright', '#c8bfa6', 'magentaBright'];
 export function normalizeShellApprovalMode(mode) {
     if (mode === 'ask' || mode === 'auto-safe' || mode === 'yolo')
         return mode;
@@ -388,7 +388,8 @@ export class Controller extends EventEmitter {
      * memory intact instead of starting from scratch.
      */
     respawnAgent(name) {
-        const sa = this.loadedSession?.agents.find((a) => a.name.toLowerCase() === name.toLowerCase());
+        const ref = name.toLowerCase();
+        const sa = this.loadedSession?.agents.find((a) => a.name.toLowerCase() === ref || a.alias?.toLowerCase() === ref || a.id?.toLowerCase() === ref);
         if (!sa)
             return 'no-agent';
         if (!sa.conversation || !fs.existsSync(sa.conversation))
@@ -406,7 +407,8 @@ export class Controller extends EventEmitter {
         }
         if (history.length === 0)
             return 'no-conversation';
-        return this.spawnAgent(sa.task, sa.name, sa.model, undefined, undefined, history, sa.mode ?? 'task');
+        const modelSpec = sa.model ? (sa.providerName ? `${sa.providerName}:${sa.model}` : sa.model) : undefined;
+        return this.spawnAgent(sa.task, sa.name, modelSpec, undefined, sa.specialist, history, sa.mode ?? 'task');
     }
     pauseAgent(name) {
         const a = this.findAgent(name);
@@ -445,7 +447,12 @@ export class Controller extends EventEmitter {
         return true;
     }
     broadcast(content) {
-        this.board.addNote('user', 'all', content);
+        const stamp = content.trim();
+        const recent = [...this.board.notes]
+            .reverse()
+            .find((n) => n.from === 'user' && n.to === 'all' && Date.now() - n.ts < 1500);
+        if (stamp && recent?.content !== stamp)
+            this.board.addNote('user', 'all', stamp);
         let n = 0;
         for (const [id, agent] of this.agents.entries()) {
             const info = this.board.agents.get(id);
@@ -608,12 +615,20 @@ export class Controller extends EventEmitter {
         try {
             const dir = this.sessionsDir();
             fs.mkdirSync(dir, { recursive: true });
+            const providerName = this.sessionProvider()?.name ?? this.session.providerName;
+            const trimChange = (c) => ({
+                ...c,
+                before: c.before.length > 40_000 ? `${c.before.slice(0, 40_000)}\n/* truncated */` : c.before,
+                after: c.after.length > 40_000 ? `${c.after.slice(0, 40_000)}\n/* truncated */` : c.after,
+            });
             const data = {
                 savedAt: new Date().toISOString(),
                 name: this.sessionName,
                 projectRoot: this.projectRoot,
                 agents: [...this.board.agents.values()].map((a) => ({
+                    id: a.id,
                     name: a.name,
+                    alias: a.alias,
                     task: a.task,
                     mode: a.mode,
                     state: a.state,
@@ -622,10 +637,17 @@ export class Controller extends EventEmitter {
                     tokensIn: a.tokensIn,
                     tokensOut: a.tokensOut,
                     cost: a.cost,
+                    providerName,
                     model: a.model,
+                    specialist: a.specialist,
+                    claims: a.claims,
+                    ctxPct: a.ctxPct,
                     conversation: this.conversationFiles.get(a.id),
                 })),
                 notes: this.board.notes.slice(-200),
+                changes: this.board.changes.slice(-80).map(trimChange),
+                fileActivity: [...this.board.fileActivity.values()].slice(-100),
+                workMapWarnings: this.board.workMapWarnings.slice(-80),
                 changedFiles: [...new Set(this.board.changes.map((c) => c.path))],
             };
             const file = path.join(dir, `session-${this.sessionStamp}.json`);
@@ -661,10 +683,13 @@ export class Controller extends EventEmitter {
         if (data.name)
             this.sessionName = data.name;
         const tasks = data.agents.map((a) => `${a.name} [${a.state}] : ${a.task}${a.lastResult ? ` → ${a.lastResult}` : ''}`);
-        this.board.addNote('system', 'all', `Previous session restored (${data.savedAt}). Past work:\n${tasks.join('\n')}\nFiles changed then: ${data.changedFiles.join(', ') || '(none)'}`);
-        for (const n of data.notes.slice(-50)) {
-            this.board.notes.push({ ...n, id: this.board.notes.length + 1 });
-        }
+        this.board.hydrate({
+            notes: data.notes ?? [],
+            changes: data.changes ?? [],
+            fileActivity: data.fileActivity ?? [],
+            workMapWarnings: data.workMapWarnings ?? [],
+        });
+        this.board.addNote('system', 'all', `Previous session restored (${data.savedAt}). Past work:\n${tasks.join('\n')}\nFiles changed then: ${(data.changedFiles ?? []).join(', ') || '(none)'}`);
         this.board.log('', 'system', t('m.sessionRestored', { date: new Date(data.savedAt).toLocaleString() }));
         // Financial history: per-agent cost/steps/tokens of the restored session.
         const withCost = data.agents.filter((a) => a.cost !== undefined || a.tokensIn !== undefined);

package/dist/coordination/blackboard.js

@@ -17,6 +17,7 @@ export class Blackboard extends EventEmitter {
     notes = [];
     changes = [];
     logs = [];
+    workMapWarnings = [];
     noteSeq = 0;
     changeSeq = 0;
     logSeq = 0;
@@ -42,6 +43,8 @@ export class Blackboard extends EventEmitter {
         if (!a)
             return;
         Object.assign(a, patch);
+        if ('claims' in patch)
+            this.recomputeWorkMap();
         this.touch();
     }
     setAgentState(id, state, action) {
@@ -142,11 +145,65 @@ export class Blackboard extends EventEmitter {
         this.conflictCounts.set(relPath, n);
         if (n === 3)
             this.emit('agent-event', { type: 'conflict', path: relPath });
+        this.upsertWorkWarning({
+            id: `conflict:${relPath}`,
+            level: n >= 3 ? 'conflict' : 'warn',
+            title: 'Repeated edit conflict',
+            detail: `${relPath} has ${n} recorded co-edit collision${n === 1 ? '' : 's'}. Coordinate before touching it again.`,
+            paths: [relPath],
+            agentNames: [],
+            ts: Date.now(),
+            count: n,
+        });
         return n;
     }
     lastChangeId() {
         return this.changes.length > 0 ? this.changes[this.changes.length - 1].id : 0;
     }
+    static normClaim(p) {
+        return p.trim().replace(/\\/g, '/').replace(/^\.\/+/, '').replace(/\/+$/, '');
+    }
+    static overlaps(a, b) {
+        const x = Blackboard.normClaim(a);
+        const y = Blackboard.normClaim(b);
+        if (!x || !y)
+            return false;
+        return x === y || x.startsWith(`${y}/`) || y.startsWith(`${x}/`);
+    }
+    upsertWorkWarning(warning) {
+        const idx = this.workMapWarnings.findIndex((w) => w.id === warning.id);
+        if (idx >= 0)
+            this.workMapWarnings[idx] = warning;
+        else
+            this.workMapWarnings.push(warning);
+        if (this.workMapWarnings.length > 100)
+            this.workMapWarnings.splice(0, this.workMapWarnings.length - 100);
+    }
+    recomputeWorkMap() {
+        const agents = [...this.agents.values()].filter((a) => a.claims && a.claims.length > 0);
+        const warnings = [];
+        for (let i = 0; i < agents.length; i++) {
+            for (let j = i + 1; j < agents.length; j++) {
+                const a = agents[i];
+                const b = agents[j];
+                const paths = (a.claims ?? []).filter((left) => (b.claims ?? []).some((right) => Blackboard.overlaps(left, right)));
+                if (paths.length === 0)
+                    continue;
+                warnings.push({
+                    id: `overlap:${[a.id, b.id].sort().join(':')}`,
+                    level: 'warn',
+                    title: 'Overlapping work areas',
+                    detail: `${a.name} and ${b.name} both declared ${paths.join(', ')}.`,
+                    paths,
+                    agentNames: [a.name, b.name],
+                    ts: Date.now(),
+                });
+            }
+        }
+        const conflictWarnings = this.workMapWarnings.filter((w) => w.id.startsWith('conflict:')).slice(-20);
+        this.workMapWarnings = [...conflictWarnings, ...warnings].slice(-100);
+        return this.workMapWarnings;
+    }
     // ---------- logs ----------
     log(agentId, kind, text) {
         this.logs.push({ agentId, kind, text, ts: Date.now(), seq: ++this.logSeq });
@@ -189,6 +246,13 @@ export class Blackboard extends EventEmitter {
                 lines.push(`  • ${act.path} — ${mine ? 'you' : act.agentName} (${act.op}, ${age}s ago)`);
             }
         }
+        const warnings = this.workMapWarnings.filter((w) => w.level !== 'info').slice(-5);
+        if (warnings.length > 0) {
+            lines.push('Work map warnings (advisory, do not block):');
+            for (const w of warnings) {
+                lines.push(`  • ${w.title}: ${w.detail}`);
+            }
+        }
         if (me)
             lines.push(`Reminder — your task: ${me.task}`);
         lines.push('=== END OF REAL-TIME STATE ===');
@@ -214,6 +278,8 @@ export class Blackboard extends EventEmitter {
                     })),
                     fileActivity: [...this.fileActivity.values()],
                     notes: this.notes.slice(-100),
+                    changes: this.changes.slice(-50),
+                    workMapWarnings: this.workMapWarnings.slice(-50),
                 };
                 fs.writeFileSync(path.join(dir, 'state.json'), JSON.stringify(state, null, 2));
             }
@@ -222,4 +288,13 @@ export class Blackboard extends EventEmitter {
             }
         }, 500);
     }
+    hydrate(data) {
+        this.notes = [...(data.notes ?? [])].sort((a, b) => a.id - b.id);
+        this.changes = [...(data.changes ?? [])].sort((a, b) => a.id - b.id);
+        this.fileActivity = new Map((data.fileActivity ?? []).map((a) => [a.path, a]));
+        this.workMapWarnings = [...(data.workMapWarnings ?? [])].sort((a, b) => a.ts - b.ts);
+        this.noteSeq = this.notes.reduce((max, n) => Math.max(max, n.id), 0);
+        this.changeSeq = this.changes.reduce((max, c) => Math.max(max, c.id), 0);
+        this.touch();
+    }
 }

package/dist/i18n.js

@@ -76,6 +76,10 @@ const en = {
     'main.ready1': '⚡ Ready — folder: {folder}',
     'main.ready2': 'Type a task + Enter to launch your first agent. /help for help.',
     'main.empty': 'No agents yet. Type a task + Enter to launch your first agent — then launch more at any time, even while they work.',
+    'main.prompt': 'Example: Redesign the UI',
+    'main.emptyCard.tagline': 'Multi-agent coding from one terminal.',
+    'main.emptyCard.cta': 'Describe work below to launch the first agent.',
+    'main.emptyCard.hints': '/ for commands · @agent to steer · /help for shortcuts',
     'main.status': 'Enter = new agent N+1 (even while others work) · @Name = real-time instruction · /help · views: /agents /board /diff /notes',
     'main.placeholder': 'Type a task (= new agent N+1) · @Agent message · /command',
     'agent.summary': 'Summary',
@@ -99,6 +103,7 @@ const en = {
     'board.agents': 'Agents:',
     'board.none': '(no agents)',
     'board.activity': 'Who works where (file activity, no locks):',
+    'board.workMap': 'Work map warnings:',
     'board.noActivity': '(no edits yet)',
     'board.notes': 'Latest notes:',
     'notes.title': '✉ INTER-AGENT NOTES (last 30)',
@@ -239,7 +244,7 @@ const en = {
     'attach.placeholder': 'Message to {agent} (Enter to send, /quit to detach)…',
     'attach.waiting': 'Waiting for agent {agent}… (is the main Parallel session running?)',
     'attach.gone': 'Session ended — this terminal is detached.',
-    'attach.hint': 'plain text steers this agent · /task creates a new agent · /ask asks · /plan plans · /quit detaches',
+    'attach.hint': 'plain text steers this agent · @all broadcasts · /send routes · /task creates · /quit detaches',
     'grid.above': '▲ {n} agent(s) above — PgUp',
     'grid.below': '▼ {n} agent(s) below — PgDn',
     'm.nothing': 'Nothing to save yet.',
@@ -453,6 +458,10 @@ const fr = {
     'main.ready1': '⚡ Prêt — dossier : {folder}',
     'main.ready2': "Tape une tâche + Entrée pour lancer ton premier agent. /help pour l'aide.",
     'main.empty': "Aucun agent pour le moment. Tape une tâche + Entrée pour lancer ton premier agent — puis relances-en d'autres à tout moment, même pendant qu'ils travaillent.",
+    'main.prompt': 'Exemple : Fais moi une refonte UI',
+    'main.emptyCard.tagline': 'Code multi-agent depuis un terminal.',
+    'main.emptyCard.cta': 'Décris le travail ci-dessous pour lancer le premier agent.',
+    'main.emptyCard.hints': '/ pour les commandes · @agent pour piloter · /help pour les raccourcis',
     'main.status': 'Entrée = nouvel agent N+1 (même pendant que les autres travaillent) · @Nom = instruction temps réel · /help · vues : /agents /board /diff /notes',
     'main.placeholder': 'Tape une tâche (= nouvel agent N+1) · @Agent message · /commande',
     'agent.summary': 'Récapitulatif',
@@ -473,6 +482,7 @@ const fr = {
     'board.agents': 'Agents :',
     'board.none': '(aucun agent)',
     'board.activity': 'Qui travaille où (activité fichiers, sans verrou) :',
+    'board.workMap': 'Alertes work map :',
     'board.noActivity': '(aucune modification pour le moment)',
     'board.notes': 'Dernières notes :',
     'notes.title': '✉ NOTES INTER-AGENTS (30 dernières)',
@@ -611,7 +621,7 @@ const fr = {
     'attach.placeholder': 'Message à {agent} (Entrée pour envoyer, /quit pour détacher)…',
     'attach.waiting': 'En attente de l’agent {agent}… (la session Parallel principale tourne-t-elle ?)',
     'attach.gone': 'Session terminée — ce terminal est détaché.',
-    'attach.hint': 'texte libre pilote cet agent · /task crée un nouvel agent · /ask questionne · /plan planifie · /quit détache',
+    'attach.hint': 'texte libre pilote cet agent · @all diffuse · /send route · /task crée · /quit détache',
     'grid.above': '▲ {n} agent(s) au-dessus — PgUp',
     'grid.below': '▼ {n} agent(s) en dessous — PgDn',
     'm.nothing': 'Rien à sauvegarder pour le moment.',
@@ -818,6 +828,10 @@ const es = {
     'main.ready1': '⚡ Listo — carpeta: {folder}',
     'main.ready2': 'Escribe una tarea + Enter para lanzar tu primer agente. /help para ayuda.',
     'main.empty': 'Aún no hay agentes. Escribe una tarea + Enter para lanzar tu primer agente — luego lanza más en cualquier momento, incluso mientras trabajan.',
+    'main.prompt': 'Ejemplo: hazme un rediseño de UI',
+    'main.emptyCard.tagline': 'Código multiagente desde un terminal.',
+    'main.emptyCard.cta': 'Describe el trabajo abajo para lanzar el primer agente.',
+    'main.emptyCard.hints': '/ para comandos · @agente para dirigir · /help para atajos',
     'main.status': 'Enter = nuevo agente N+1 (incluso mientras otros trabajan) · @Nombre = instrucción en tiempo real · /help · vistas: /agents /board /diff /notes',
     'main.placeholder': 'Escribe una tarea (= nuevo agente N+1) · @Agente mensaje · /comando',
     'agent.summary': 'Resumen',
@@ -838,6 +852,7 @@ const es = {
     'board.agents': 'Agentes:',
     'board.none': '(sin agentes)',
     'board.activity': 'Quién trabaja dónde (actividad de archivos, sin bloqueos):',
+    'board.workMap': 'Avisos del mapa de trabajo:',
     'board.noActivity': '(sin modificaciones por ahora)',
     'board.notes': 'Últimas notas:',
     'notes.title': '✉ NOTAS ENTRE AGENTES (últimas 30)',
@@ -976,7 +991,7 @@ const es = {
     'attach.placeholder': 'Mensaje a {agent} (Enter para enviar, /quit para desconectar)…',
     'attach.waiting': 'Esperando al agente {agent}… (¿está corriendo la sesión principal de Parallel?)',
     'attach.gone': 'Sesión terminada — esta terminal está desconectada.',
-    'attach.hint': 'texto libre dirige a este agente · /task crea un agente nuevo · /ask pregunta · /plan planifica · /quit desconecta',
+    'attach.hint': 'texto libre dirige a este agente · @all difunde · /send enruta · /task crea · /quit desconecta',
     'grid.above': '▲ {n} agente(s) arriba — PgUp',
     'grid.below': '▼ {n} agente(s) abajo — PgDn',
     'm.nothing': 'Nada que guardar por ahora.',
@@ -1183,6 +1198,10 @@ const zh = {
     'main.ready1': '⚡ 就绪 — 文件夹：{folder}',
     'main.ready2': '输入任务 + 回车即可启动第一个智能体。/help 查看帮助。',
     'main.empty': '尚无智能体。输入任务 + 回车启动第一个 — 之后可随时启动更多，即使它们正在工作。',
+    'main.prompt': '示例：帮我重做 UI',
+    'main.emptyCard.tagline': '在一个终端中进行多智能体编码。',
+    'main.emptyCard.cta': '在下方描述工作以启动第一个智能体。',
+    'main.emptyCard.hints': '/ 查看命令 · @智能体 可指挥 · /help 查看快捷键',
     'main.status': '回车 = 新智能体 N+1（即使其他智能体正在工作）· @名称 = 实时指令 · /help · 视图：/agents /board /diff /notes',
     'main.placeholder': '输入任务（= 新智能体 N+1）· @智能体 消息 · /命令',
     'agent.summary': '摘要',
@@ -1203,6 +1222,7 @@ const zh = {
     'board.agents': '智能体：',
     'board.none': '（无智能体）',
     'board.activity': '谁在哪里工作（文件活动，无锁定）：',
+    'board.workMap': '工作地图提醒：',
     'board.noActivity': '（暂无修改）',
     'board.notes': '最新便签：',
     'notes.title': '✉ 智能体间便签（最近 30 条）',
@@ -1341,7 +1361,7 @@ const zh = {
     'attach.placeholder': '发给 {agent} 的消息（回车发送，/quit 断开）…',
     'attach.waiting': '等待代理 {agent}…（Parallel 主会话在运行吗？）',
     'attach.gone': '会话已结束 — 此终端已断开。',
-    'attach.hint': '直接输入文字可指挥此代理 · /task 创建新代理 · /ask 提问 · /plan 规划 · /quit 断开',
+    'attach.hint': '直接输入文字可指挥此代理 · @all 广播 · /send 路由 · /task 创建 · /quit 断开',
     'grid.above': '▲ 上方还有 {n} 个代理 — PgUp',
     'grid.below': '▼ 下方还有 {n} 个代理 — PgDn',
     'm.nothing': '暂无可保存的内容。',