@parallel-cli/parallel 0.4.3 → 0.4.5

package/dist/commands.js

@@ -1,6 +1,9 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { execFileSync } from 'node:child_process';
 import { Controller, normalizeShellApprovalMode } from './controller.js';
 import { createSkillTemplate, createSpecialistTemplate } from './skills.js';
-import { providerReady } from './config.js';
+import { isLocalProvider, isPlaceholderModel, providerNeedsApiKey } from './config.js';
 import { t } from './i18n.js';
 // Grouped by intent so /help reads as a story: create agents → steer them →
 // inspect the session → git safety net → session & config → exit.
@@ -66,6 +69,72 @@ export function matchCommands(input, opts = {}) {
 function agentList(ctl) {
     return [...ctl.board.agents.values()].map((a) => a.name).join(', ') || t('m.none');
 }
+function commandExists(name) {
+    try {
+        execFileSync('which', [name], { stdio: 'ignore' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function localEndpointReachable(baseUrl) {
+    let timeout;
+    try {
+        const controller = new AbortController();
+        timeout = setTimeout(() => controller.abort(), 1500);
+        const resp = await fetch(baseUrl.replace(/\/+$/, '') + '/models', { signal: controller.signal });
+        return resp.ok;
+    }
+    catch {
+        return false;
+    }
+    finally {
+        if (timeout)
+            clearTimeout(timeout);
+    }
+}
+async function doctorReport(ctl, ui) {
+    const p = ctl.sessionProvider();
+    const lines = [];
+    let level = 'ok';
+    if (!p) {
+        ui.system(t('m.doctorReport', { lines: t('m.doctorNoProvider') }), 'error');
+        return;
+    }
+    const activeModel = ctl.session.model || p.defaultModel || p.models[0] || '';
+    lines.push(t('m.doctorProvider', { provider: p.name, model: activeModel || '—' }));
+    if (providerNeedsApiKey(p) && !p.apiKey) {
+        level = 'error';
+        lines.push(t('m.doctorKeyMissing'));
+    }
+    else {
+        lines.push(providerNeedsApiKey(p) ? t('m.doctorKeyOk') : t('m.doctorKeySkipped'));
+    }
+    if (isPlaceholderModel(activeModel)) {
+        level = 'error';
+        lines.push(t('m.doctorModelMissing'));
+    }
+    else {
+        lines.push(t('m.doctorModelOk', { model: activeModel }));
+    }
+    if (isLocalProvider(p)) {
+        const reachable = await localEndpointReachable(p.baseUrl);
+        if (reachable) {
+            lines.push(t('m.doctorEndpointOk', { url: p.baseUrl }));
+        }
+        else {
+            if (level !== 'error')
+                level = 'warn';
+            lines.push(t('m.doctorEndpointFail', { url: p.baseUrl }));
+        }
+    }
+    const sock = path.join(ctl.projectRoot, '.parallel', 'session.sock');
+    lines.push(fs.existsSync(sock) ? t('m.doctorAttachOk') : t('m.doctorAttachMissing'));
+    lines.push(commandExists('git') ? t('m.doctorGitOk') : t('m.doctorGitMissing'));
+    lines.push(commandExists('gh') ? t('m.doctorGhOk') : t('m.doctorGhMissing'));
+    ui.system(t('m.doctorReport', { lines: lines.join('\n') }), level);
+}
 /**
  * Single-agent ergonomics: when the session has exactly ONE agent, commands
  * that target an agent (/undo, /focus, /pause…) work without naming it.
@@ -78,10 +147,12 @@ function spawnFrom(arg, ctl, ui, images, specialist, mode = 'task') {
     const p = ctl.sessionProvider();
     if (!p)
         return ui.system(t('m.missingProvider'), 'error');
-    if (!providerReady(p))
+    if (providerNeedsApiKey(p) && !p.apiKey)
         return ui.system(t('m.missingKey', { name: p.name }), 'error');
-    if (!ctl.session.model && !p.defaultModel && !p.models[0])
+    const activeModel = ctl.session.model || p.defaultModel || p.models[0] || '';
+    if (isPlaceholderModel(activeModel)) {
         return ui.system(t('m.missingModel', { name: p.name }), 'error');
+    }
     // optional --model=xxx flag
     let model;
     let task = arg;
@@ -129,8 +200,8 @@ export function executeInput(raw, ctl, ui, images) {
             return ui.system(t('m.usageAt'), 'warn');
         const [, target, content] = m;
         if (target.toLowerCase() === 'all') {
-            ctl.broadcast(content);
-            ui.system(t('m.broadcast'), 'ok');
+            const n = ctl.broadcast(content);
+            ui.system(t('m.broadcast', { n }), n > 0 ? 'ok' : 'warn');
         }
         else if (ctl.sendToAgent(target, content)) {
             ui.system(t('m.sent', { target }), 'ok');
@@ -217,10 +288,18 @@ export function executeInput(raw, ctl, ui, images) {
         case '/commit': {
             // Commit the files touched by one agent (or all) — staged by explicit path.
             const [target0, ...msg] = rest;
-            const target = target0 || soloAgent(ctl);
+            const solo = soloAgent(ctl);
+            const target = target0 && (target0.toLowerCase() === 'all' || ctl.board.getAgentByName(target0))
+                ? target0
+                : target0 && solo
+                    ? solo
+                    : target0 || solo;
+            const message = target0 && target === solo && target0.toLowerCase() !== solo?.toLowerCase() && !ctl.board.getAgentByName(target0)
+                ? rest.join(' ').trim()
+                : msg.join(' ').trim();
             if (!target)
                 return ui.system(t('m.usageCommit'), 'warn');
-            const r = ctl.commitFor(target, msg.join(' ').trim() || undefined);
+            const r = ctl.commitFor(target, message || undefined);
             if (r.ok)
                 return ui.system(t('m.committed', { name: target, files: String(r.files) }), 'ok');
             if (r.reason === 'not-found')
@@ -249,15 +328,19 @@ export function executeInput(raw, ctl, ui, images) {
                 ui.setView('sessions');
                 return;
             }
+            const force = rest.includes('--force');
+            const selector = rest.filter((part) => part !== '--force').join(' ').trim();
             const sessions = Controller.listSessions(ctl.projectRoot);
             if (sessions.length === 0)
                 return ui.system(t('m.usageSession'), 'warn');
-            const idx = arg.toLowerCase() === 'latest' ? 0 : Number.parseInt(arg, 10) - 1;
+            const idx = selector.toLowerCase() === 'latest' ? 0 : Number.parseInt(selector, 10) - 1;
             const session = sessions[idx];
             if (!session)
                 return ui.system(t('m.usageSession'), 'warn');
+            if (ctl.hasRunningAgents() && !force)
+                return ui.system(t('m.sessionActive'), 'warn');
             ctl.loadSession(session.data);
-            ui.system(t('m.sessionLoaded', { date: new Date(session.data.savedAt).toLocaleString() }), 'ok');
+            ui.system(t('m.sessionLoaded', { date: new Date(session.data.savedAt).toLocaleString() }) + '\n' + t('m.sessionRestoreHint'), 'ok');
             return;
         }
         case '/restore': {
@@ -267,6 +350,8 @@ export function executeInput(raw, ctl, ui, images) {
             if (!ctl.loadedSession)
                 return ui.system(t('m.usageSession'), 'warn');
             const res = ctl.respawnAgent(arg);
+            if (res === 'no-agent')
+                return ui.system(t('m.noRestoredAgent', { name: arg }), 'error');
             if (res === 'no-conversation')
                 return ui.system(t('m.noConversation', { name: arg }), 'error');
             if (!res)
@@ -315,14 +400,7 @@ export function executeInput(raw, ctl, ui, images) {
             return;
         }
         case '/doctor': {
-            const p = ctl.sessionProvider();
-            if (!p)
-                return ui.system(t('m.missingProvider'), 'error');
-            if (!providerReady(p))
-                return ui.system(t('m.missingKey', { name: p.name }), 'error');
-            if (!ctl.session.model && !p.defaultModel && !p.models[0])
-                return ui.system(t('m.missingModel', { name: p.name }), 'error');
-            ui.system(t('m.doctorOk', { pm: `${p.name}:${ctl.session.model || p.defaultModel || p.models[0]}` }), 'ok');
+            void doctorReport(ctl, ui);
             return;
         }
         case '/cost':
@@ -476,9 +554,17 @@ export function executeInput(raw, ctl, ui, images) {
             ui.setView('settings-session');
             return;
         case '/project':
-            ui.openProject?.(arg || undefined);
+            {
+                const force = rest.includes('--force');
+                const folderArg = rest.filter((part) => part !== '--force').join(' ').trim();
+                if (ctl.hasRunningAgents() && !force)
+                    return ui.system(t('m.projectActive'), 'warn');
+                ui.openProject?.(folderArg || undefined);
+            }
             return;
         case '/wizard':
+            if (ctl.hasRunningAgents() && arg !== '--force')
+                return ui.system(t('m.wizardActive'), 'warn');
             ui.openWizard?.();
             return;
         // SESSION-only approvals & sound (global defaults editable in /settings).

package/dist/config.js

@@ -280,8 +280,38 @@ export function isLocalProvider(p) {
 export function providerNeedsApiKey(p) {
     return p.requiresApiKey !== false && !isLocalProvider(p);
 }
+export function isPlaceholderModel(model) {
+    return !model.trim() || /^your-model-here$/i.test(model.trim());
+}
+export function providerHasUsableModel(p) {
+    return !isPlaceholderModel(p.defaultModel || p.models[0] || '');
+}
 export function providerReady(p) {
-    return !providerNeedsApiKey(p) || p.apiKey.trim().length > 0;
+    return (!providerNeedsApiKey(p) || p.apiKey.trim().length > 0) && providerHasUsableModel(p);
+}
+export async function detectProviderModels(provider, timeoutMs = 2000) {
+    let timeout;
+    try {
+        const controller = new AbortController();
+        timeout = setTimeout(() => controller.abort(), timeoutMs);
+        const resp = await fetch(provider.baseUrl.replace(/\/+$/, '') + '/models', { signal: controller.signal });
+        if (!resp.ok)
+            return null;
+        const data = (await resp.json());
+        const models = [
+            ...(data.data?.map((m) => m.id || m.name).filter(Boolean) ?? []),
+            ...(data.models?.map((m) => m.name).filter(Boolean) ?? []),
+        ];
+        const unique = [...new Set(models.filter((m) => !isPlaceholderModel(m)))];
+        return unique.length > 0 ? { models: unique, defaultModel: unique[0] } : null;
+    }
+    catch {
+        return null;
+    }
+    finally {
+        if (timeout)
+            clearTimeout(timeout);
+    }
 }
 export function getProvider(cfg, name) {
     const n = (name ?? cfg.defaultProvider).toLowerCase();

package/dist/controller.js

@@ -72,6 +72,7 @@ export class Controller extends EventEmitter {
     conversationFiles = new Map();
     /** The session restored at startup (source of /restore conversations). */
     loadedSession = null;
+    sessionOnlyProvider = null;
     constructor(config, projectRoot) {
         super();
         this.config = config;
@@ -108,6 +109,10 @@ export class Controller extends EventEmitter {
     // ---------- providers / models ----------
     /** Provider used by the current session (falls back to the global default). */
     sessionProvider() {
+        if (this.sessionOnlyProvider &&
+            this.session.providerName.toLowerCase() === this.sessionOnlyProvider.name.toLowerCase()) {
+            return this.sessionOnlyProvider;
+        }
         return getProvider(this.config, this.session.providerName || undefined);
     }
     /** Resolve "model" or "provider:model" against the configured providers. */
@@ -115,7 +120,10 @@ export class Controller extends EventEmitter {
         const trimmed = spec.trim();
         const sep = trimmed.indexOf(':');
         if (sep > 0) {
-            const provider = getProvider(this.config, trimmed.slice(0, sep).trim());
+            const left = trimmed.slice(0, sep).trim();
+            const provider = this.sessionOnlyProvider && this.sessionOnlyProvider.name.toLowerCase() === left.toLowerCase()
+                ? this.sessionOnlyProvider
+                : getProvider(this.config, left);
             if (provider)
                 return { provider, model: trimmed.slice(sep + 1).trim() };
         }
@@ -231,7 +239,7 @@ export class Controller extends EventEmitter {
             return;
         const [q] = this.questions.splice(idx, 1);
         this.board.log('', 'system', auto ? t('m.qAuto', { name: q.agentName, answer }) : t('m.qAnswered', { name: q.agentName, answer }));
-        q.resolve(answer);
+        q.resolve({ answer, auto });
         this.emit('update');
     }
     // ---------- agents ----------
@@ -380,9 +388,10 @@ 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-conversation';
+            return 'no-agent';
         if (!sa.conversation || !fs.existsSync(sa.conversation))
             return 'no-conversation';
         let history;
@@ -398,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);
@@ -427,7 +437,7 @@ export class Controller extends EventEmitter {
         for (const req of this.approvals.splice(0))
             req.resolve(false);
         for (const q of this.questions.splice(0))
-            q.resolve(q.options[q.recommended] ?? '');
+            q.resolve({ answer: q.options[q.recommended] ?? '', auto: true });
     }
     sendToAgent(name, content) {
         const a = this.findAgent(name);
@@ -437,7 +447,21 @@ 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);
+            if (!info || ['done', 'error', 'stopped'].includes(info.state))
+                continue;
+            agent.instruct(content);
+            n++;
+        }
+        return n;
     }
     hasRunningAgents() {
         return [...this.board.agents.values()].some((a) => ['working', 'thinking', 'listening', 'waiting', 'paused', 'idle'].includes(a.state));
@@ -464,8 +488,10 @@ export class Controller extends EventEmitter {
                 continue;
             const conflict = this.board.changes.some((c2) => c2.id > c.id && c2.path === c.path && c2.agentId !== info.id);
             try {
-                const abs = path.resolve(this.projectRoot, c.path);
-                if (!abs.startsWith(path.resolve(this.projectRoot)))
+                const root = path.resolve(this.projectRoot);
+                const abs = path.resolve(root, c.path);
+                const rel = path.relative(root, abs);
+                if (rel.startsWith('..') || path.isAbsolute(rel))
                     return 'none';
                 fs.writeFileSync(abs, c.before);
             }
@@ -589,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,
@@ -603,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`);
@@ -630,7 +671,7 @@ export class Controller extends EventEmitter {
                 return { file, data: JSON.parse(fs.readFileSync(file, 'utf8')) };
             })
                 .sort((a, b) => (a.data.savedAt < b.data.savedAt ? 1 : -1))
-                .slice(0, 8);
+                .slice(0, 20);
         }
         catch {
             return [];
@@ -642,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);
@@ -671,11 +715,19 @@ export class Controller extends EventEmitter {
         const p = getProvider(this.config, name);
         if (!p)
             return false;
+        this.sessionOnlyProvider = null;
         this.session.providerName = p.name;
         this.session.model = p.defaultModel || p.models[0] || '';
         this.emit('update');
         return true;
     }
+    setSessionProviderConfig(p) {
+        this.sessionOnlyProvider = p;
+        this.session.providerName = p.name;
+        this.session.model = p.defaultModel || p.models[0] || '';
+        this.llmCache.clear();
+        this.emit('update');
+    }
     setSessionApprovalMode(mode) {
         this.session.approvalMode = mode;
         this.emit('update');
@@ -687,6 +739,8 @@ export class Controller extends EventEmitter {
     // ---------- GLOBAL settings (/settings) — persisted ----------
     saveProvider(p) {
         upsertProvider(this.config, p);
+        if (this.sessionOnlyProvider?.name.toLowerCase() === p.name.toLowerCase())
+            this.sessionOnlyProvider = null;
         this.llmCache.clear();
         // if the session points at this provider, refresh its view
         if (this.session.providerName.toLowerCase() === p.name.toLowerCase()) {

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();
+    }
 }