@alfacapital-tech/c4builder 0.9.0-rc.2 → 0.9.0-rc.4

package/README.MD

@@ -5,7 +5,7 @@
 **Architecture as code that an agent writes, checks and reads.**
 
 C4-Builder is a CLI that builds a folder of markdown files and [PlantUML](https://plantuml.com/),
-[D2](https://d2lang.com/) or [BPMN](https://www.bpmn.org/) diagrams into documentation: a [docsify](https://docsify.js.org/)
+[D2](https://d2lang.com/), [BPMN](https://www.bpmn.org/) or [Mermaid](https://mermaid.js.org/) diagrams into documentation: a [docsify](https://docsify.js.org/)
 site, a markdown file per folder, or a single file. Folders follow the
 [C4 model](https://c4model.com/) (system → container → component), and git keeps the history of
 architecture decisions next to the code.
@@ -19,7 +19,7 @@ than a hundred diagrams, so we continue it as a maintained fork, adapted to work
 - **Deterministic offline rendering.** The PlantUML jar, the diagram font and the engines ship
   with the package; layout is computed by PlantUML's built-in Smetana engine, no Graphviz. The
   same sources produce the same SVG on a laptop, in CI and in Docker, with no network access.
-- **`c4builder check`** validates individual `.puml`/`.iuml`/`.d2`/`.bpmn` files with the build's own
+- **`c4builder check`** validates individual `.puml`/`.iuml`/`.d2`/`.bpmn`/`.mmd` files with the build's own
   engine and returns an exit code and the error line — fast feedback for agents, pre-commit
   hooks and CI.
 - **Plugins.** `openspec` publishes an [OpenSpec](https://github.com/Fission-AI/OpenSpec) store
@@ -29,6 +29,8 @@ than a hundred diagrams, so we continue it as a maintained fork, adapted to work
   without a system Java, c4builder downloads a private JRE.
 - **BPMN** processes written as BPMN 2.0 XML without coordinates: the build validates the model
   and lays it out with horizontal pools and lanes.
+- **Mermaid** `.mmd` files and ```` ```mermaid ```` blocks are rendered at build time by real mermaid,
+  without a browser: images in every output instead of client-side rendering.
 - **Maintained.** TypeScript, golden rendering snapshots, CI on every pull request, releases to
   npm and GHCR. The PDF output of the original was removed.
 

package/dist/cli/commands/check.js

@@ -7,8 +7,9 @@ import { resolveJava } from "../../core/render/jre.js";
 import { renderDiagram } from "../../core/render/diagrams.js";
 import { renderD2, teardownD2 } from "../../core/render/d2renderer.js";
 import { BpmnError, renderBpmn, teardownBpmn } from "../../core/render/bpmnrenderer.js";
+import { MermaidError, renderMermaid, teardownMermaid } from "../../core/render/mermaidrenderer.js";
 // `c4builder check <file...>` — валидация отдельных диаграмм ТЕМ ЖЕ движком, что и
-// сборка (вендорный PlantUML jar + системная/managed java, бандл D2, конвейер BPMN), без проекта и
+// сборка (вендорный PlantUML jar + системная/managed java, бандл D2, конвейер BPMN, mermaid), без проекта и
 // `.c4builder`. Рендер идёт в память и выбрасывается: проверяем ровно то, что упало бы
 // в сборке (системный `plantuml` может отличаться версией). Код выхода 0 — все файлы ок,
 // 1 — есть ошибка (движка, неизвестного расширения или чтения файла).
@@ -64,11 +65,12 @@ const CHECKERS = {
     '.puml': checkPlantUml,
     '.iuml': checkPlantUml,
     '.d2': (abs) => renderD2(abs),
-    '.bpmn': async (abs) => renderBpmn(await readFile(abs, 'utf8'), path.relative(process.cwd(), abs))
+    '.bpmn': async (abs) => renderBpmn(await readFile(abs, 'utf8'), path.relative(process.cwd(), abs)),
+    '.mmd': async (abs) => renderMermaid(await readFile(abs, 'utf8'), path.relative(process.cwd(), abs))
 };
 export default async (files) => {
     if (files.length === 0) {
-        console.log(chalk.red('usage: c4builder check <file...>  (.puml | .iuml | .d2 | .bpmn)'));
+        console.log(chalk.red('usage: c4builder check <file...>  (.puml | .iuml | .d2 | .bpmn | .mmd)'));
         process.exit(1);
     }
     let failed = 0;
@@ -78,20 +80,21 @@ export default async (files) => {
         const check = CHECKERS[path.extname(abs).toLowerCase()];
         try {
             if (!check)
-                throw new Error('unsupported extension (expected .puml, .iuml, .d2 or .bpmn)');
+                throw new Error('unsupported extension (expected .puml, .iuml, .d2, .bpmn or .mmd)');
             await check(abs);
             console.log(chalk.green(`✓ ${file}`));
         }
         catch (e) {
             failed++;
-            // BPMN: по строке на нарушение — агент правит их по id элемента.
-            const problems = e instanceof BpmnError ? e.problems : [e.message];
+            // BPMN: по строке на нарушение — агент правит их по id элемента; mermaid — `line N: …`.
+            const problems = e instanceof BpmnError || e instanceof MermaidError ? e.problems : [e.message];
             for (const p of problems)
                 console.error(chalk.red(`✗ ${file}: ${p}`));
         }
     }
     await teardownD2();
     await teardownBpmn();
+    await teardownMermaid();
     if (failed)
         process.exit(1);
 };

package/dist/cli/commands/feedback.js

@@ -1,11 +1,20 @@
 import chalk from 'chalk';
 import fs from 'node:fs';
 import { parseConfig } from "../../config/options.js";
+import { LISTENER_NAME } from "../../core/feedback.js";
 import { FEEDBACK_HEADER, FEEDBACK_PATH } from "./site.comments.js";
 // `c4builder feedback` (change site-agent-feedback, design D9): забирает пачку замечаний у `site -w`.
 // Конфиг читается как JSON без Configstore — тот создал бы `.c4builder` в любом каталоге. Ошибки —
 // через exitCode, а не process.exit: напечатанная в pipe пачка должна успеть уйти целиком.
 export default async (configPath, opts) => {
+    // Имя обязательно и без умолчания (change feedback-mailboxes, D2): с ним два агента со старой
+    // инструкцией молча делили бы один ящик. Код 2, а не 1: код 1 инструкции агентов читают как
+    // «нет сервера, перезапусти сайт».
+    if (!opts.as || !LISTENER_NAME.test(opts.as)) {
+        console.error(chalk.red('--as <name> is required: name this listener after your change or task (1-64 letters, digits, ".", "_" or "-"), e.g. "c4builder feedback --wait --as add-dark-mode"; use the same name after each batch'));
+        process.exitCode = 2;
+        return;
+    }
     let raw;
     try {
         raw = JSON.parse(fs.readFileSync(configPath, 'utf8'));
@@ -20,7 +29,7 @@ export default async (configPath, opts) => {
     };
     // 127.0.0.1, а не localhost: сервер слушает только IPv4, а `localhost` → `::1` на части машин
     // подвешивает соединение.
-    const url = `http://127.0.0.1:${port}${FEEDBACK_PATH}/next${opts.wait ? '' : '?wait=0'}`;
+    const url = `http://127.0.0.1:${port}${FEEDBACK_PATH}/next?as=${opts.as}${opts.wait ? '' : '&wait=0'}`;
     for (;;) {
         let res;
         try {
@@ -40,6 +49,7 @@ export default async (configPath, opts) => {
         }
         if (res.status === 404)
             return fail(`agent feedback is disabled on ${shown} — the server runs without -w or with --no-agent`);
-        return fail(`unexpected response ${res.status} from ${shown}`);
+        const error = await res.json().then((body) => body?.error, () => undefined);
+        return fail(`unexpected response ${res.status} from ${shown}${typeof error === 'string' ? `: ${error}` : ''}`);
     }
 };

package/dist/cli/commands/site.comments.js

@@ -1,3 +1,4 @@
+import { UI_STRINGS } from "./site.i18n.js";
 export const COMMENTS_PATH = '/__c4builder/comments';
 export const FEEDBACK_PATH = '/__c4builder/feedback';
 export const FEEDBACK_HEADER = 'X-C4builder-Feedback';
@@ -10,6 +11,9 @@ const CSS = [
     '.c4b-cpop textarea,.c4b-review textarea{width:100%;box-sizing:border-box;min-height:70px;padding:6px;border:1px solid #ccc;border-radius:4px;font:13px/1.4 sans-serif;resize:vertical}',
     '.c4b-cpop .c4b-row{display:flex;justify-content:space-between;align-items:center;gap:8px;margin-top:8px}',
     '.c4b-cpop small{color:#888;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}',
+    // Кнопки поповера не сжимаются: длинную подсказку обрезает многоточие, а не кнопки уходят
+    // на вторую строку (русские подписи и длинные названия разделов).
+    '.c4b-cpop .c4b-row>span{flex:none}',
     '.c4b-cpop button,.c4b-review button{padding:4px 12px;border:1px solid #ccc;border-radius:4px;background:#fff;color:#2c3e50;cursor:pointer;font:13px sans-serif}',
     '.c4b-cpop button.c4b-primary,.c4b-review button.c4b-primary{border-color:#42b983;background:#42b983;color:#fff}',
     '.c4b-cpop button:disabled,.c4b-review button:disabled{opacity:.6;cursor:default}',
@@ -18,6 +22,13 @@ const CSS = [
     '.c4b-review{position:fixed;left:50%;bottom:16px;transform:translateX(-50%);z-index:1000;width:520px;max-width:calc(100vw - 32px);box-sizing:border-box;padding:8px 12px;border:1px solid #3b82f6;border-radius:6px;background:#fff;color:#2c3e50;font:13px/1.4 sans-serif;box-shadow:0 2px 8px rgba(0,0,0,.2)}',
     '.c4b-review .c4b-row{display:flex;flex-wrap:wrap;align-items:center;gap:6px}',
     '.c4b-review .c4b-row small{flex:1;color:#888;white-space:nowrap}',
+    // Выбор адресата сжимается вместе с select: длинные имена не выталкивают кнопки из строки.
+    '.c4b-review .c4b-to{flex:1;min-width:0;display:flex;align-items:center;gap:4px;color:#888;white-space:nowrap}',
+    '.c4b-review .c4b-to[hidden]{display:none}',
+    '.c4b-review select{min-width:0;max-width:100%;padding:2px;border:1px solid #ccc;border-radius:4px;background:#fff;color:#2c3e50;font:13px sans-serif}',
+    // Кнопки панели переносятся одной группой: иначе при нехватке места часть уезжает на
+    // вторую строку, а Discard остаётся один в первой.
+    '.c4b-review .c4b-acts{display:flex;gap:6px;margin-left:auto}',
     '.c4b-review button.c4b-link{padding:0;border:0;background:none;color:#2c3e50;font-weight:700;text-decoration:underline dotted}',
     '.c4b-review ul{margin:6px 0;padding:0;list-style:none;max-height:40vh;overflow:auto}',
     '.c4b-review li{padding:3px 0;border-top:1px solid #eee;overflow-wrap:anywhere}',
@@ -36,27 +47,48 @@ const CSS = [
     '.c4b-del:hover{color:#fff;background:#c0392b;border-color:#c0392b}',
     '.c4b-del:disabled{opacity:.5;cursor:default}'
 ].join('');
-const jsString = (s) => JSON.stringify(s)
+const jsValue = (v) => JSON.stringify(v)
     .replace(/</g, '\\u003c')
     .replace(/[\u0080-￿]/g, (c) => `\\u${c.charCodeAt(0).toString(16).padStart(4, '0')}`);
 // Начальное состояние агентского режима и ключ проекта вставляет сервер, дальше его обновляют
 // события `c4builder:agent` от сниппета livereload (change site-agent-feedback, design D4, D8).
-export const commentsSnippet = (heading, { agent = false, listening = false, project = '' } = {}) => `
+// Язык выбирает сам скрипт: при `auto` — по navigator.languages (change site-ui-language, D1).
+export const commentsSnippet = (heading, { agent = false, mailboxes = [], project = '', language = 'auto' } = {}) => `
 <script>
 (function () {
     if (window.__c4builderComments) return;
     window.__c4builderComments = true;
     var ENDPOINT = '${COMMENTS_PATH}';
     var FEEDBACK = '${FEEDBACK_PATH}';
-    var HEADING = ${jsString(heading)};
+    var HEADING = ${jsValue(heading)};
     var TOAST_KEY = '__c4builderCommentToast';
-    var DRAFT_KEY = '__c4builderReview:' + ${jsString(project)};
-    var AGENT = { on: ${agent}, listening: ${listening} };
+    var DRAFT_KEY = '__c4builderReview:' + ${jsValue(project)};
+    var TARGET_KEY = '__c4builderTarget:' + ${jsValue(project)};
+    var AGENT = { on: ${agent}, mailboxes: ${jsValue(mailboxes)} };
     var BLOCKS = 'p,li,td,th,h1,h2,h3,h4,h5,h6,pre,blockquote,dd,dt,div,section,details,summary';
     var style = document.createElement('style');
-    style.textContent = ${jsString(CSS)};
+    style.textContent = ${jsValue(CSS)};
     document.head.appendChild(style);
 
+    var STRINGS = ${jsValue(UI_STRINGS)};
+    var has = function (lang) { return Object.prototype.hasOwnProperty.call(STRINGS, lang); };
+    var LANG = (function (pref) {
+        if (has(pref)) return pref;
+        var prefs = [].concat(navigator.languages || [], navigator.language || []);
+        for (var i = 0; i < prefs.length; i++) {
+            var tag = String(prefs[i]).toLowerCase().split('-')[0];
+            if (has(tag)) return tag;
+        }
+        return 'en';
+    })(${jsValue(language)});
+    var plural = new Intl.PluralRules(LANG);
+    var t = function (key, vars) {
+        vars = vars || {};
+        var s = STRINGS[LANG][key];
+        if (typeof s === 'object') s = s[plural.select(vars.n)];
+        return s.replace(/\\{(\\w+)\\}/g, function (m, k) { return k in vars ? String(vars[k]) : m; });
+    };
+
     var collapse = function (s) { return String(s).replace(/\\s+/g, ' ').trim(); };
     var same = function (a, b) { return collapse(a).toLowerCase() === collapse(b).toLowerCase(); };
 
@@ -203,18 +235,18 @@ export const commentsSnippet = (heading, { agent = false, listening = false, pro
             del.type = 'button';
             del.className = 'c4b-del';
             del.textContent = '\\u00d7';
-            del.title = 'Remove this question';
+            del.title = t('removeQuestion');
             del.addEventListener('click', function (e) {
                 e.preventDefault();
                 e.stopPropagation();
                 del.disabled = true;
                 send({ page: pageFile(), number: Number(item.number) || null, text: collapse(item.text) }, 'DELETE').then(function (r) {
-                    var msg = 'Removed from ' + r.file;
+                    var msg = t('removed', { file: r.file });
                     try { sessionStorage.setItem(TOAST_KEY, msg); } catch (e) {}
                     toast(msg);
                 }, function (err) {
                     del.disabled = false;
-                    toast('Remove failed: ' + (err && err.message ? err.message : err), true);
+                    failure('removeFailed')(err);
                 });
             });
             item.cell.appendChild(del);
@@ -272,10 +304,10 @@ export const commentsSnippet = (heading, { agent = false, listening = false, pro
     var btns = document.createElement('div');
     btns.className = 'c4b-cbtns';
     btns.hidden = true;
-    var fbBtn = button('Feedback', null, 'c4b-fb');
-    fbBtn.title = 'Tell the agent what to change';
-    var qBtn = button('Question');
-    qBtn.title = 'Add a question to the ' + HEADING + ' section of the source file';
+    var fbBtn = button(t('feedback'), null, 'c4b-fb');
+    fbBtn.title = t('feedbackTitle');
+    var qBtn = button(t('question'));
+    qBtn.title = t('questionTitle', { heading: HEADING });
     btns.appendChild(fbBtn);
     btns.appendChild(qBtn);
     document.body.appendChild(btns);
@@ -347,44 +379,69 @@ export const commentsSnippet = (heading, { agent = false, listening = false, pro
             });
         });
     };
-    var failure = function (what) {
-        return function (err) { toast(what + ' failed: ' + (err && err.message ? err.message : err), true); };
+    var failure = function (key) {
+        return function (err) { toast(t(key, { error: err && err.message ? err.message : err }), true); };
     };
 
+    // The tab's recipient lives in sessionStorage: it survives livereload, is per tab and is
+    // copied with a duplicated tab. Recipients are the server's mailboxes plus the tab's own.
+    var target = '';
+    try { target = sessionStorage.getItem(TARGET_KEY) || ''; } catch (e) {}
+    var recipients = function () {
+        var all = AGENT.mailboxes.slice();
+        var known = all.some(function (m) { return m.name === target; });
+        if (target && !known) all.push({ name: target, state: 'reconnecting', queued: 0 });
+        return all;
+    };
+    // Without mailboxes a batch goes to whoever connects first; with several, only to a chosen one.
+    var canSend = function () { return !!target || !AGENT.mailboxes.length; };
+    var named = function (key, name) { return name ? t(key + 'To', { name: name }) : t(key); };
+
     // Feedback to the agent: "Delivered" only after the server handed the batch to
     // "c4builder feedback"; the event may outrun the POST response, hence both maps.
     var delivered = {}, pending = {};
     var sendBatch = function (decision, comments, general) {
-        return send({ decision: decision, comments: comments, general: general }, 'POST', FEEDBACK).then(function (r) {
-            if (delivered[r.id]) return toast('Delivered to the agent');
+        var body = { decision: decision, comments: comments, general: general, to: target || undefined };
+        return send(body, 'POST', FEEDBACK).then(function (r) {
+            if (r.id in delivered) return toast(named('delivered', delivered[r.id]));
             pending[r.id] = true;
-            toast(r.queued ? 'Queued \\u2014 agent is not listening' : 'Sent to the agent');
+            toast(named(r.queued ? 'queued' : 'sent', r.to));
         });
     };
     window.addEventListener('c4builder:delivered', function (e) {
-        var id = e.detail && e.detail.id;
-        delivered[id] = true;
-        if (pending[id]) { delete pending[id]; toast('Delivered to the agent'); }
+        var d = e.detail || {};
+        delivered[d.id] = d.to || '';
+        if (pending[d.id]) { delete pending[d.id]; toast(named('delivered', d.to)); }
     });
 
-    // Review draft lives in localStorage per project: it survives livereload and a closed tab;
-    // without storage it lives until the page reloads.
-    var memDraft = [];
+    // Review draft lives in localStorage per project and recipient: it survives livereload and a
+    // closed tab, and a tab never sends comments typed for another agent. Without storage it lives
+    // until the page reloads. Without a recipient the rc key is used, so earlier drafts survive.
+    var memDraft = {};
+    var draftKey = function () { return DRAFT_KEY + (target ? ':' + target : ''); };
     var draft = function () {
         try {
-            var v = JSON.parse(localStorage.getItem(DRAFT_KEY) || '[]');
+            var v = JSON.parse(localStorage.getItem(draftKey()) || '[]');
             return Array.isArray(v) ? v : [];
-        } catch (e) { return memDraft; }
+        } catch (e) { return memDraft[draftKey()] || []; }
     };
     var saveDraft = function (items) {
-        memDraft = items;
+        memDraft[draftKey()] = items;
         try {
-            if (items.length) localStorage.setItem(DRAFT_KEY, JSON.stringify(items));
-            else localStorage.removeItem(DRAFT_KEY);
+            if (items.length) localStorage.setItem(draftKey(), JSON.stringify(items));
+            else localStorage.removeItem(draftKey());
         } catch (e) {}
         renderPanel();
         highlightDraft();
     };
+    // A draft started before the tab had a recipient goes to its first recipient.
+    var setTarget = function (name) {
+        var orphan = target ? [] : draft();
+        if (orphan.length) saveDraft([]);
+        target = name;
+        try { sessionStorage.setItem(TARGET_KEY, name); } catch (e) {}
+        saveDraft(draft().concat(orphan));
+    };
     var highlightDraft = function () {
         var root = content();
         if (!root) return;
@@ -409,9 +466,15 @@ export const commentsSnippet = (heading, { agent = false, listening = false, pro
     var count = button('', function () { expanded = !expanded; renderPanel(); }, 'c4b-link');
     var listen = document.createElement('small');
     listen.className = 'c4b-listen';
+    var sendTo = document.createElement('label');
+    sendTo.className = 'c4b-to';
+    sendTo.textContent = t('sendTo');
+    var select = document.createElement('select');
+    select.addEventListener('change', function () { setTarget(select.value); renderAgent(); });
+    sendTo.appendChild(select);
     var list = document.createElement('ul');
     var general = document.createElement('textarea');
-    general.placeholder = 'Overall comment (optional, Ctrl+Enter to submit, Esc to hide)';
+    general.placeholder = t('generalPlaceholder');
     general.hidden = true;
     var finish = function (decision) {
         var items = draft(), ids = items.map(function (it) { return it.id; });
@@ -422,18 +485,18 @@ export const commentsSnippet = (heading, { agent = false, listening = false, pro
             general.hidden = true;
             expanded = false;
             saveDraft(draft().filter(function (it) { return ids.indexOf(it.id) < 0; }));
-        }, failure('Review')).then(function () { busy = false; renderPanel(); });
+        }, failure('reviewFailed')).then(function () { busy = false; renderPanel(); });
     };
-    var discard = button('Discard', function () {
+    var discard = button(t('discard'), function () {
         var n = draft().length;
-        if (n && !window.confirm('Discard ' + n + ' pending comment' + (n === 1 ? '' : 's') + '?')) return;
+        if (n && !window.confirm(t('discardConfirm', { n: n }))) return;
         general.value = '';
         general.hidden = true;
         saveDraft([]);
     });
-    var approve = button('Approve', function () { finish('approved'); });
-    approve.title = 'Tell the agent there is nothing more to change (pending comments go along)';
-    var submit = button('Submit review', function () {
+    // One finishing action, two labels: on an empty draft "Approve" does not read as "finish".
+    var approve = button('', function () { finish('approved'); });
+    var submit = button(t('submitReview'), function () {
         if (!general.hidden) return finish('submitted');
         general.hidden = false;
         general.focus();
@@ -444,20 +507,23 @@ export const commentsSnippet = (heading, { agent = false, listening = false, pro
     });
     var head = document.createElement('div');
     head.className = 'c4b-row';
-    [count, listen, discard, approve, submit].forEach(function (el) { head.appendChild(el); });
+    var acts = document.createElement('span');
+    acts.className = 'c4b-acts';
+    [discard, approve, submit].forEach(function (el) { acts.appendChild(el); });
+    [count, listen, sendTo, acts].forEach(function (el) { head.appendChild(el); });
     panel.appendChild(head);
     panel.appendChild(list);
     panel.appendChild(general);
     document.body.appendChild(panel);
     var renderPanel = function () {
         panel.hidden = !AGENT.on;
-        var items = draft(), pages = {};
+        var items = draft(), pages = {}, empty = !items.length;
         items.forEach(function (it) { pages[it.page] = true; });
         var n = Object.keys(pages).length;
-        count.textContent = items.length
-            ? 'Review: ' + items.length + ' pending (' + n + (n === 1 ? ' page)' : ' pages)')
-            : 'Review: nothing pending';
-        count.disabled = !items.length;
+        count.textContent = empty
+            ? t('reviewEmpty')
+            : t('reviewCount', { comments: t('comments', { n: items.length }), pages: t('pages', { n: n }) });
+        count.disabled = empty;
         list.textContent = '';
         items.forEach(function (it) {
             var li = document.createElement('li');
@@ -466,34 +532,61 @@ export const commentsSnippet = (heading, { agent = false, listening = false, pro
             var del = button('\\u00d7', function () {
                 saveDraft(draft().filter(function (x) { return x.id !== it.id; }));
             }, 'c4b-del');
-            del.title = 'Remove from the review';
+            del.title = t('removeFromReview');
             li.appendChild(del);
             list.appendChild(li);
         });
-        list.hidden = !expanded || !items.length;
+        list.hidden = !expanded || empty;
+        approve.textContent = t(empty ? 'done' : 'approve');
+        approve.title = t(empty ? 'doneTitle' : 'approveTitle');
+        approve.className = empty ? 'c4b-primary' : '';
+        discard.hidden = submit.hidden = empty;
         discard.disabled = busy;
-        approve.disabled = busy;
-        submit.disabled = busy || !items.length;
+        approve.disabled = busy || !canSend();
+        submit.disabled = busy || empty || !canSend();
+    };
+    var label = function (m) {
+        return t(m.state === 'listening' ? 'stateListening' : 'stateReconnecting', { name: m.name }) +
+            (m.queued ? ', ' + t('inQueue', { n: m.queued }) : '');
     };
+    // The popover's send button follows the recipient too; set while the popover is open.
+    var syncPop = null;
     var renderAgent = function () {
+        // A lone mailbox is chosen and remembered: the tab stays with it when a second agent comes.
+        if (!target && AGENT.mailboxes.length === 1) setTarget(AGENT.mailboxes[0].name);
         fbBtn.hidden = !AGENT.on;
-        renderPanel();
-        var text = 'agent: ' + (AGENT.listening ? 'listening \\u25cf' : 'not listening \\u25cb');
+        var all = recipients(), current = null;
+        all.forEach(function (m) { if (m.name === target) current = m; });
+        var text = current ? label(current) : t(all.length ? 'chooseAgent' : 'notListening');
         var els = document.querySelectorAll('.c4b-listen');
         for (var i = 0; i < els.length; i++) { els[i].textContent = text; els[i].title = text; }
+        listen.hidden = all.length > 1;
+        sendTo.hidden = !listen.hidden;
+        select.textContent = '';
+        if (!target) all.unshift({ name: '', label: t('chooseAgent') });
+        all.forEach(function (m) {
+            var o = document.createElement('option');
+            o.value = m.name;
+            o.textContent = m.label || label(m);
+            select.appendChild(o);
+        });
+        select.value = target;
+        renderPanel();
+        if (syncPop) syncPop();
     };
     window.addEventListener('c4builder:agent', function (e) {
         var d = e.detail || {};
         AGENT.on = !!d.on;
-        AGENT.listening = !!d.listening;
+        AGENT.mailboxes = Array.isArray(d.mailboxes) ? d.mailboxes : [];
         renderAgent();
     });
     window.addEventListener('storage', function (e) {
-        if (e.key === DRAFT_KEY) { renderPanel(); highlightDraft(); }
+        if (e.key === draftKey()) { renderPanel(); highlightDraft(); }
     });
 
     var close = function () {
         if (pop) { pop.remove(); pop = null; }
+        syncPop = null;
         btns.hidden = true;
     };
     var open = function (data, rect, feedback) {
@@ -503,22 +596,28 @@ export const commentsSnippet = (heading, { agent = false, listening = false, pro
         var quote = document.createElement('blockquote');
         quote.textContent = data.quote;
         var ta = document.createElement('textarea');
-        ta.placeholder = (feedback ? 'What should the agent change?' : 'Your question') + ' (Ctrl+Enter to send, Esc to cancel)';
+        ta.placeholder = t(feedback ? 'feedbackPlaceholder' : 'questionPlaceholder');
         var row = document.createElement('div');
         row.className = 'c4b-row';
         var hint = document.createElement('small');
         if (feedback) hint.className = 'c4b-listen';
-        else hint.textContent = hint.title = 'To: ' + HEADING + (data.section ? ' / ' + data.section : '');
+        else hint.textContent = hint.title = t('questionTo', { target: HEADING + (data.section ? ' / ' + data.section : '') });
         var actions = document.createElement('span');
-        var buttons = [button('Cancel', close)];
+        var buttons = [button(t('cancel'), close)];
+        var sending = false, now = null;
+        var sync = function () {
+            buttons.forEach(function (b) { b.disabled = sending || (b === now && !canSend()); });
+        };
         var run = function (action) {
             return function () {
                 var comment = ta.value.trim();
                 if (!comment) { ta.focus(); return; }
-                buttons.forEach(function (b) { b.disabled = true; });
+                sending = true;
+                sync();
                 action(comment).then(close, function (err) {
-                    buttons.forEach(function (b) { b.disabled = false; });
-                    failure(feedback ? 'Feedback' : 'Question')(err);
+                    sending = false;
+                    sync();
+                    failure(feedback ? 'feedbackFailed' : 'questionFailed')(err);
                 });
             };
         };
@@ -527,20 +626,20 @@ export const commentsSnippet = (heading, { agent = false, listening = false, pro
         };
         var primary;
         if (feedback) {
-            var add = button('Add to review', run(function (c) {
+            var add = button(t('addToReview'), run(function (c) {
                 var it = item(c);
                 it.id = Date.now().toString(36) + Math.random().toString(36).slice(2, 6);
                 saveDraft(draft().concat([it]));
                 return Promise.resolve();
             }));
-            var now = button('Send now', run(function (c) { return sendBatch('submitted', [item(c)], ''); }));
+            now = button(t('sendNow'), run(function (c) { return sendBatch('submitted', [item(c)], ''); }));
             buttons.push(add, now);
             // As in a GitLab merge request: once a review is started, comments go into it.
             primary = draft().length ? add : now;
         } else {
-            primary = button('Add question', run(function (c) {
+            primary = button(t('addQuestion'), run(function (c) {
                 return send(item(c)).then(function (r) {
-                    var msg = 'Added to ' + r.file + (r.number ? ' as #' + r.number : '');
+                    var msg = t(r.number ? 'addedNumber' : 'added', { file: r.file, number: r.number });
                     try { sessionStorage.setItem(TOAST_KEY, msg); } catch (e) {}
                     toast(msg);
                 });
@@ -558,6 +657,7 @@ export const commentsSnippet = (heading, { agent = false, listening = false, pro
         pop.appendChild(ta);
         pop.appendChild(row);
         document.body.appendChild(pop);
+        syncPop = sync;
         renderAgent();
         place(pop, rect);
         ta.focus();

package/dist/cli/commands/site.i18n.js

@@ -0,0 +1,102 @@
+// Словарь интерфейса страницы `site -w` (change site-ui-language). Единственный файл `src/`, где
+// тест cli-language разрешает кириллицу: это текст страницы в браузере, а не вывод CLI. Наборы
+// ключей en и ru совпадают (проверяет тот же тест). `{name}` подставляет скрипт страницы; строка
+// с числом — объект форм для Intl.PluralRules, число в ней — `{n}`.
+export const UI_STRINGS = {
+    en: {
+        feedback: 'Feedback',
+        feedbackTitle: 'Tell the agent what to change',
+        question: 'Question',
+        questionTitle: 'Add a question to the {heading} section of the source file',
+        removeQuestion: 'Remove this question',
+        removed: 'Removed from {file}',
+        added: 'Added to {file}',
+        addedNumber: 'Added to {file} as #{number}',
+        sent: 'Sent to the agent',
+        delivered: 'Delivered to the agent',
+        queued: 'Queued — agent is not listening',
+        sentTo: 'Sent to {name}',
+        deliveredTo: 'Delivered to {name}',
+        queuedTo: 'Queued for {name} — not listening',
+        reviewFailed: 'Review failed: {error}',
+        feedbackFailed: 'Feedback failed: {error}',
+        questionFailed: 'Question failed: {error}',
+        removeFailed: 'Remove failed: {error}',
+        generalPlaceholder: 'Overall comment (optional, Ctrl+Enter to submit, Esc to hide)',
+        discard: 'Discard',
+        discardConfirm: { one: 'Discard {n} pending comment?', other: 'Discard {n} pending comments?' },
+        approve: 'Approve',
+        approveTitle: 'Tell the agent there is nothing more to change (pending comments go along)',
+        done: 'Done — no changes',
+        doneTitle: 'Tell the agent there is nothing to change',
+        submitReview: 'Submit review',
+        reviewEmpty: 'Review: nothing pending',
+        reviewCount: 'Review: {comments} ({pages})',
+        comments: { one: '{n} pending', other: '{n} pending' },
+        pages: { one: '{n} page', other: '{n} pages' },
+        removeFromReview: 'Remove from the review',
+        notListening: 'agent: not listening ○',
+        stateListening: '{name}: listening ●',
+        stateReconnecting: '{name}: reconnecting ○',
+        inQueue: '{n} queued',
+        sendTo: 'Send to',
+        chooseAgent: 'choose an agent',
+        feedbackPlaceholder: 'What should the agent change? (Ctrl+Enter to send, Esc to cancel)',
+        questionPlaceholder: 'Your question (Ctrl+Enter to send, Esc to cancel)',
+        questionTo: 'To: {target}',
+        cancel: 'Cancel',
+        addToReview: 'Add to review',
+        sendNow: 'Send now',
+        addQuestion: 'Add question'
+    },
+    ru: {
+        feedback: 'Замечание',
+        feedbackTitle: 'Сказать агенту, что изменить',
+        question: 'Вопрос',
+        questionTitle: 'Добавить вопрос в раздел «{heading}» исходного файла',
+        removeQuestion: 'Удалить вопрос',
+        removed: 'Удалено из {file}',
+        added: 'Добавлено в {file}',
+        addedNumber: 'Добавлено в {file} под номером {number}',
+        sent: 'Отправлено агенту',
+        delivered: 'Доставлено агенту',
+        queued: 'В очереди: агент не слушает',
+        sentTo: 'Отправлено агенту {name}',
+        deliveredTo: 'Доставлено агенту {name}',
+        queuedTo: 'В очереди у {name}: агент не слушает',
+        reviewFailed: 'Не удалось отправить ревью: {error}',
+        feedbackFailed: 'Не удалось отправить замечание: {error}',
+        questionFailed: 'Не удалось добавить вопрос: {error}',
+        removeFailed: 'Не удалось удалить вопрос: {error}',
+        generalPlaceholder: 'Общий комментарий (необязательно; Ctrl+Enter — отправить, Esc — скрыть)',
+        discard: 'Очистить',
+        discardConfirm: {
+            one: 'Удалить из ревью {n} замечание?',
+            few: 'Удалить из ревью {n} замечания?',
+            many: 'Удалить из ревью {n} замечаний?'
+        },
+        approve: 'Одобрить',
+        approveTitle: 'Сообщить агенту, что правок больше нет (замечания из ревью уйдут вместе с этим)',
+        done: 'Готово, правок нет',
+        doneTitle: 'Сообщить агенту, что правок нет',
+        submitReview: 'Отправить ревью',
+        reviewEmpty: 'Ревью: замечаний нет',
+        reviewCount: 'Ревью: {comments} {pages}',
+        comments: { one: '{n} замечание', few: '{n} замечания', many: '{n} замечаний' },
+        pages: { one: 'на {n} странице', few: 'на {n} страницах', many: 'на {n} страницах' },
+        removeFromReview: 'Убрать из ревью',
+        notListening: 'агент: не слушает ○',
+        stateListening: '{name}: слушает ●',
+        stateReconnecting: '{name}: переподключается ○',
+        inQueue: 'в очереди: {n}',
+        sendTo: 'Кому',
+        chooseAgent: 'выберите агента',
+        feedbackPlaceholder: 'Что должен изменить агент? (Ctrl+Enter — отправить, Esc — отмена)',
+        questionPlaceholder: 'Ваш вопрос (Ctrl+Enter — отправить, Esc — отмена)',
+        questionTo: 'Куда: {target}',
+        cancel: 'Отмена',
+        addToReview: 'В ревью',
+        sendNow: 'Отправить',
+        addQuestion: 'Добавить вопрос'
+    }
+};