crewforth 3.5.0-rc.1 → 3.5.0-rc.2

package/kit/studio/web/i18n.js

@@ -0,0 +1,79 @@
+// The panel's language. English is the panel's own and the default; Turkish is a choice the viewer makes.
+//
+// The English sentence is the key. t() returns it unchanged unless Turkish is chosen and the dictionary holds it,
+// so a sentence nobody has translated yet still reads, in English, rather than as a key or a blank. Whether every
+// sentence HAS a translation is not left to that fallback: the Studio gate reads each t('…') in web/ and index.html
+// and fails on a missing, extra or mismatched entry.
+//
+// The language is read once, when this module is first evaluated. Every module that renders text imports this one,
+// so it is settled before any of them builds a label, including the word maps they build at load. Switching reloads
+// the page for that reason: a label built in one language is not rebuilt in the other by anything less.
+import { TR } from './i18n-tr.js';
+
+export const LANG_KEY = 'crewforth-studio-lang';
+const known = (v) => (v === 'en' || v === 'tr' ? v : null);
+
+function saved() {
+  // Through window, not globalThis: Node answers a bare localStorage with a warning, and the gate imports this.
+  try { return known(globalThis.window?.localStorage?.getItem(LANG_KEY)); } catch { return null; /* blocked storage: English */ }
+}
+
+let lang = saved() ?? 'en';
+
+export const currentLang = () => lang;
+/** For the gate: the page itself switches by reloading, never by this. */
+export function setLang(l) { lang = known(l) ?? 'en'; }
+
+/** The sentence in the chosen language, with {name} filled from vars. */
+export function t(en, vars) {
+  const s = lang === 'tr' && Object.hasOwn(TR, en) ? TR[en] : en;
+  return vars ? s.replace(/\{(\w+)\}/g, (m, k) => (Object.hasOwn(vars, k) ? String(vars[k]) : m)) : s;
+}
+
+/**
+ * A sentence with elements in it ("Runs in <code>…</code> on branch <code>…</code>."): the translated sentence cut at
+ * its {slots}, each slot replaced by the node given for it, so the words around them can move with the language.
+ */
+export function tParts(en, slots) {
+  return t(en).split(/(\{\w+\})/).filter(Boolean)
+    .map((p) => { const m = /^\{(\w+)\}$/.exec(p); return m && Object.hasOwn(slots, m[1]) ? slots[m[1]] : p; });
+}
+
+/** The locale numbers and clock times are written in. */
+export const numLocale = () => (lang === 'tr' ? 'tr-TR' : 'en-US');
+
+const ATTRS = ['aria-label', 'title', 'placeholder'];
+
+/** index.html is written in English; this puts its words in the chosen language. A no-op in English. */
+export function translateDom(root) {
+  root.ownerDocument?.documentElement?.setAttribute('lang', lang);
+  if (lang === 'en') return;
+  for (const e of root.querySelectorAll('*')) {
+    for (const a of ATTRS) {
+      const v = e.getAttribute(a);
+      if (v && Object.hasOwn(TR, v)) e.setAttribute(a, TR[v]);
+    }
+    for (const n of e.childNodes) {
+      if (n.nodeType !== 3) continue;
+      const s = n.nodeValue.trim();
+      if (s && Object.hasOwn(TR, s)) n.nodeValue = n.nodeValue.replace(s, TR[s]);
+    }
+  }
+}
+
+/**
+ * The language button. It names the language it switches TO, in that language, so a viewer who cannot read the
+ * current one can still find the way back. The choice is remembered per browser; storage that refuses costs the
+ * memory, and the page then reloads into the default.
+ */
+export function initLang(button, ls, reload) {
+  const to = lang === 'tr' ? 'en' : 'tr';
+  button.textContent = to.toUpperCase();
+  const say = to === 'tr' ? 'Türkçe' : 'English';
+  button.setAttribute('aria-label', say);
+  button.title = say;
+  button.addEventListener('click', () => {
+    try { ls.setItem(LANG_KEY, to); } catch { /* blocked storage: nothing to remember it in */ }
+    reload();
+  });
+}

package/kit/studio/web/index.html

@@ -30,6 +30,7 @@
   <button id="theme" class="btn icon ghost" type="button" aria-label="Switch theme">
     <svg class="ic" viewBox="0 0 16 16" aria-hidden="true"><path d="M13 9.5A5.5 5.5 0 0 1 6.5 3a5.5 5.5 0 1 0 6.5 6.5z"/></svg>
   </button>
+  <button id="lang" class="btn icon ghost lang-btn" type="button" aria-label="Switch language"></button>
   <button id="fullscreen" class="btn icon ghost" type="button" title="Full screen (f)" aria-label="Full screen">
     <svg class="ic" viewBox="0 0 16 16" aria-hidden="true"><path d="M3 6V3h3M10 3h3v3M13 10v3h-3M6 13H3v-3"/></svg>
   </button>

package/kit/studio/web/inspect.js

@@ -4,8 +4,9 @@
 // skills it applied, who delegated to it. The rule they share is the panel's own: a value that was not read is
 // written "Not measured", with why — never as 0 and never as an empty list.
 import { roleName, modelName, modelFamily, modelOf } from './names.js';
+import { t } from './i18n.js';
 
-const NOT_MEASURED = 'Not measured';
+const NOT_MEASURED = t('Not measured');
 
 export function fmtTokens(t) {
   if (t == null) return null;
@@ -17,9 +18,9 @@ export function fmtTokens(t) {
 export function fmtDuration(ms) {
   if (ms == null || !Number.isFinite(ms)) return null;
   const s = Math.max(0, Math.round(ms / 1000));
-  if (s < 60) return `${s}s`;
+  if (s < 60) return t('{n}s', { n: s });
   const m = Math.floor(s / 60);
-  return m < 60 ? `${m}m ${s % 60}s` : `${Math.floor(m / 60)}h ${m % 60}m`;
+  return m < 60 ? t('{m}m {s}s', { m, s: s % 60 }) : t('{h}h {m}m', { h: Math.floor(m / 60), m: m % 60 });
 }
 
 /** How long the agent has been at it: the recorded duration when it has ended, the clock since it started while
@@ -37,21 +38,21 @@ export function elapsed(n, nowMs) {
 export function tiles(n, nowMs) {
   const el = elapsed(n, nowMs);
   return [
-    { label: 'Tool calls', value: String(n.toolCount ?? 0), measured: n.toolCount != null },
+    { label: t('Tool calls'), value: String(n.toolCount ?? 0), measured: n.toolCount != null },
     {
-      label: 'Tokens',
+      label: t('Tokens'),
       value: n.tokens == null ? NOT_MEASURED : fmtTokens(n.tokens),
       measured: n.tokens != null,
-      why: n.tokens == null ? 'the transcript carries no usage record for this agent yet' : null,
+      why: n.tokens == null ? t('the transcript carries no usage record for this agent yet') : null,
     },
     {
-      label: 'Elapsed',
+      label: t('Elapsed'),
       value: el == null ? NOT_MEASURED : fmtDuration(el),
       measured: el != null,
-      why: el == null ? 'no start time was recorded' : null,
+      why: el == null ? t('no start time was recorded') : null,
     },
-    { label: 'Errors', value: String(n.errors ?? 0), measured: n.errors != null, bad: (n.errors ?? 0) > 0 },
-  ].map((t) => (t.measured ? t : { ...t, value: NOT_MEASURED, why: t.why ?? 'not in the transcript' }));
+    { label: t('Errors'), value: String(n.errors ?? 0), measured: n.errors != null, bad: (n.errors ?? 0) > 0 },
+  ].map((x) => (x.measured ? x : { ...x, value: NOT_MEASURED, why: x.why ?? t('not in the transcript') }));
 }
 
 /** "8m 20s · started 14:02" */
@@ -61,7 +62,7 @@ export function timeLine(n, nowMs) {
   if (el != null) parts.push(fmtDuration(el));
   if (n.startedAt != null) {
     const d = new Date(n.startedAt);
-    parts.push(`started ${String(d.getHours()).padStart(2, '0')}:${String(d.getMinutes()).padStart(2, '0')}`);
+    parts.push(t('started {time}', { time: `${String(d.getHours()).padStart(2, '0')}:${String(d.getMinutes()).padStart(2, '0')}` }));
   }
   return parts.join(' · ');
 }
@@ -74,8 +75,8 @@ export function rightNow(n, detail) {
   const live = n.status === 'running' || n.status === 'starting';
   const last = detail?.timeline?.length ? detail.timeline[detail.timeline.length - 1] : null;
   const tool = last?.name ?? n.lastTool ?? null;
-  if (!tool) return { heading: live ? 'Right now' : 'Last tool', tool: null, text: live ? 'No tool call yet' : 'No tool was called' };
-  return { heading: live ? 'Right now' : 'Last tool', tool, text: last?.label ?? '' };
+  if (!tool) return { heading: live ? t('Right now') : t('Last tool'), tool: null, text: live ? t('No tool call yet') : t('No tool was called') };
+  return { heading: live ? t('Right now') : t('Last tool'), tool, text: last?.label ?? '' };
 }
 
 /** The skills the agent invoked, in the order it first did, each once. */
@@ -112,23 +113,25 @@ export function modelLines(n, nodes) {
   if (n?.kind !== 'agent') return [];
   const m = modelOf(n);
   const lines = [
-    { label: 'Ran on', text: n.model ? `${m.ran} \u00b7 ${n.model}` : 'not recorded' },
-    { label: 'Asked for', text: n.modelAsked ? `${n.modelAsked}${m.differs ? ' \u2014 differs from what ran' : ''}` : 'no model named (the agent\'s default)' },
+    { label: t('Ran on'), text: n.model ? `${m.ran} \u00b7 ${n.model}` : t('not recorded') },
+    { label: t('Asked for'), text: n.modelAsked ? `${n.modelAsked}${m.differs ? ` \u2014 ${t('differs from what ran')}` : ''}` : t('no model named (the agent\'s default)') },
   ];
   // The family is the word the choice is made in (haiku, sonnet, opus); a model with none keeps its own name.
-  const short = (model) => (model ? (modelFamily(model) ?? modelName(model).toLowerCase()) : 'no model');
+  const short = (model) => (model ? (modelFamily(model) ?? modelName(model).toLowerCase()) : t('no model'));
   if (n.firstTry) {
     lines.push({
-      label: 'Model gate',
-      text: `first asked: ${short(n.firstTry.asked)} \u2192 refused${n.firstTry.floor ? ` (floor: ${n.firstTry.floor})` : ''} \u2192 ${short(n.modelAsked ?? n.model)}`,
+      label: t('Model gate'),
+      text: n.firstTry.floor
+        ? t('first asked: {asked} \u2192 refused (floor: {floor}) \u2192 {ran}', { asked: short(n.firstTry.asked), floor: n.firstTry.floor, ran: short(n.modelAsked ?? n.model) })
+        : t('first asked: {asked} \u2192 refused \u2192 {ran}', { asked: short(n.firstTry.asked), ran: short(n.modelAsked ?? n.model) }),
       note: n.firstTry.text,
     });
   }
   const tagOf = (id) => { const o = (nodes ?? []).find((x) => x.id === id); return o?.order != null ? ` (#${o.order})` : ''; };
   if (n.escalatedFrom) {
-    lines.push({ label: 'Escalated', text: `escalated: ${short(n.escalatedFrom.from)} \u2192 ${short(n.escalatedFrom.to)}, after${tagOf(n.escalatedFrom.id)} closed "confidence: low"`, goto: n.escalatedFrom.id });
+    lines.push({ label: t('Escalated'), text: t('escalated: {from} \u2192 {to}, after{tag} closed "confidence: low"', { from: short(n.escalatedFrom.from), to: short(n.escalatedFrom.to), tag: tagOf(n.escalatedFrom.id) }), goto: n.escalatedFrom.id });
   }
-  if (n.escalatedTo) lines.push({ label: 'Escalated', text: `closed "confidence: low"; repeated one model up${tagOf(n.escalatedTo)}`, goto: n.escalatedTo });
+  if (n.escalatedTo) lines.push({ label: t('Escalated'), text: t('closed "confidence: low"; repeated one model up{tag}', { tag: tagOf(n.escalatedTo) }), goto: n.escalatedTo });
   return lines;
 }
 
@@ -136,8 +139,8 @@ export function modelLines(n, nodes) {
 export function delegatedBy(n, nodes) {
   const p = (nodes ?? []).find((x) => x.id === n.parentId) ?? null;
   if (!p) return null;
-  if (p.kind === 'session') return { id: p.id, text: `Session${p.gitBranch ? ` · ${p.gitBranch}` : ''}` };
-  if (p.kind === 'workflow') return { id: p.id, text: `Workflow run · ${p.workflowId ?? p.id}` };
+  if (p.kind === 'session') return { id: p.id, text: `${t('Session')}${p.gitBranch ? ` · ${p.gitBranch}` : ''}` };
+  if (p.kind === 'workflow') return { id: p.id, text: `${t('Workflow run')} · ${p.workflowId ?? p.id}` };
   return { id: p.id, text: p.agentType ? roleName(p.agentType) : p.id };
 }
 
@@ -147,9 +150,9 @@ export function reportOf(n, detail) {
   const live = n.status === 'running' || n.status === 'starting';
   return {
     present: false,
-    text: live ? 'Not reported yet — the agent is still running.' : 'Not reported — the transcript holds no closing text.',
+    text: live ? t('Not reported yet — the agent is still running.') : t('Not reported — the transcript holds no closing text.'),
   };
 }
 
 export const TABS = ['overview', 'conversation', 'gates', 'stats'];
-export const TAB_WORD = { overview: 'Overview', conversation: 'Conversation', gates: 'Gates', stats: 'Stats' };
+export const TAB_WORD = { overview: t('Overview'), conversation: t('Conversation'), gates: t('Gates'), stats: t('Stats') };

package/kit/studio/web/list-plan.js

@@ -5,15 +5,16 @@
 // gets a section of its own, under its own name, after them.
 import { stateOf } from './graph-plan.js';
 import { typeOf, shownType } from './names.js';
+import { t } from './i18n.js';
 
 /** "8m", "1h 4m", "40s": how long, in as little room as a row has. */
 export function short(ms) {
   if (ms == null || !Number.isFinite(ms) || ms < 0) return null;
   const s = Math.floor(ms / 1000);
-  if (s < 60) return `${s}s`;
+  if (s < 60) return t('{n}s', { n: s });
   const m = Math.floor(s / 60);
-  if (m < 60) return `${m}m`;
-  return `${Math.floor(m / 60)}h ${m % 60}m`;
+  if (m < 60) return t('{n}m', { n: m });
+  return t('{h}h {m}m', { h: Math.floor(m / 60), m: m % 60 });
 }
 
 const when = (n) => n.endedAt ?? n.updatedAt ?? n.startedAt ?? 0;
@@ -23,9 +24,9 @@ function rowOf(n, now) {
   const state = stateOf(n.status);
   if (state === 'failed') {
     const bits = [];
-    if (n.workflow) bits.push(`in ${n.workflow}`);
+    if (n.workflow) bits.push(t('in {name}', { name: n.workflow }));
     // The count the transcript gave. An agent can fail without a tool error; then there is none to report.
-    if (n.errors) bits.push(`${n.errors} ${n.errors === 1 ? 'error' : 'errors'}`);
+    if (n.errors) bits.push(n.errors === 1 ? t('{n} error', { n: 1 }) : t('{n} errors', { n: n.errors }));
     if (n.status !== 'failed') bits.push(n.status);
     return { id: n.id, node: n, type: shownType(n), real: typeOf(n), line: bits.join(' · ') || (n.description ?? ''), aside: null };
   }
@@ -37,7 +38,7 @@ function rowOf(n, now) {
     real: typeOf(n),
     line: n.description ?? '',
     // How long it has been going. With no start recorded there is nothing to count from, and nothing is shown.
-    aside: state === 'waking' ? 'starting' : live && n.startedAt != null ? short(now - n.startedAt) : null,
+    aside: state === 'waking' ? t('starting') : live && n.startedAt != null ? short(now - n.startedAt) : null,
   };
 }
 
@@ -56,16 +57,16 @@ export function sections(nodes, { queue = [], current = null, folded = new Map()
 
   // Needs you: every request waiting, this session's first. Each is a card that carries its own answers.
   const cards = [...queue].sort((a, b) => Number(b.sessionId === current) - Number(a.sessionId === current) || (a.askedAt ?? 0) - (b.askedAt ?? 0));
-  if (cards.length) out.push({ key: 'needs', title: 'Needs you', count: cards.length, tone: 'waiting', cards, rows: [], folded: false, foldable: false });
+  if (cards.length) out.push({ key: 'needs', title: t('Needs you'), count: cards.length, tone: 'waiting', cards, rows: [], folded: false, foldable: false });
 
   const by = (pred, sort) => agents.filter(pred).sort(sort).map((n) => rowOf(n, now));
   const newest = (a, b) => when(b) - when(a);
   const oldest = (a, b) => (a.startedAt ?? Infinity) - (b.startedAt ?? Infinity) || String(a.id).localeCompare(String(b.id));
 
   const fixed = [
-    { key: 'failed', title: 'Failed', tone: 'fail', rows: by((n) => stateOf(n.status) === 'failed', newest), foldedByDefault: false },
-    { key: 'running', title: 'Running', tone: 'busy', rows: by((n) => ['live', 'waking'].includes(stateOf(n.status)), oldest), foldedByDefault: false },
-    { key: 'done', title: 'Done', tone: 'good', rows: by((n) => stateOf(n.status) === 'done', newest), foldedByDefault: true },
+    { key: 'failed', title: t('Failed'), tone: 'fail', rows: by((n) => stateOf(n.status) === 'failed', newest), foldedByDefault: false },
+    { key: 'running', title: t('Running'), tone: 'busy', rows: by((n) => ['live', 'waking'].includes(stateOf(n.status)), oldest), foldedByDefault: false },
+    { key: 'done', title: t('Done'), tone: 'good', rows: by((n) => stateOf(n.status) === 'done', newest), foldedByDefault: true },
   ];
 
   // Everything else, by the status the transcript wrote. `ended` and `stale` have words here; anything the panel
@@ -78,7 +79,7 @@ export function sections(nodes, { queue = [], current = null, folded = new Map()
     if (!rest.has(key)) rest.set(key, []);
     rest.get(key).push(n);
   }
-  const WORD = { ended: 'Ended', stale: 'Stale' };
+  const WORD = { ended: t('Ended'), stale: t('Stale') };
   for (const [status, members] of [...rest].sort((a, b) => a[0].localeCompare(b[0]))) {
     fixed.push({
       key: `status:${status}`, title: WORD[status] ?? status, tone: 'none', known: status in WORD,
@@ -100,9 +101,9 @@ export function sections(nodes, { queue = [], current = null, folded = new Map()
 
 /** What a request card says under the agent's name. */
 export function wants(item) {
-  if (item.ask?.kind === 'questions') return 'asks';
-  if (item.ask?.kind === 'plan') return 'wants its plan approved';
-  return `wants to run ${item.toolName}`;
+  if (item.ask?.kind === 'questions') return t('asks');
+  if (item.ask?.kind === 'plan') return t('wants its plan approved');
+  return t('wants to run {tool}', { tool: item.toolName });
 }
 
 /** Which view a window opens on when the viewer has not chosen one: the List on a phone, the graph elsewhere. */
@@ -113,5 +114,5 @@ export function defaultView(stored, phone) {
 
 /** The graph and the Timeline are drawn for a wide window. On a phone they still open, and say so. */
 export function narrowWarning(view, phone) {
-  return phone && view !== 'list' ? 'Best on a wider screen' : null;
+  return phone && view !== 'list' ? t('Best on a wider screen') : null;
 }

package/kit/studio/web/list.js

@@ -7,6 +7,7 @@ import { Press } from './press.js';
 import { hoverOf, modelOf } from './names.js';
 import { remaining, asker, allowSessionLabel, VERDICTS } from './approvals.js';
 import { AskForms } from './ask.js';
+import { t } from './i18n.js';
 
 function mk(tag, cls, text) {
   const n = document.createElement(tag);
@@ -81,8 +82,8 @@ export class List {
     this.lastSections = list;
     if (!list.length) {
       const empty = mk('div', 'ls-empty');
-      empty.append(mk('strong', null, 'No agents yet'),
-        mk('span', null, 'This session has not delegated to a subagent. When it does, each one is listed here.'));
+      empty.append(mk('strong', null, t('No agents yet')),
+        mk('span', null, t('This session has not delegated to a subagent. When it does, each one is listed here.')));
       this.root.replaceChildren(empty);
       return;
     }
@@ -104,7 +105,7 @@ export class List {
       head.type = 'button';
       head.dataset.key = `sec:${s.key}`;
       head.setAttribute('aria-expanded', String(!s.folded));
-      head.append(mk('span', 'row-fill'), mk('span', 'sub', s.folded ? 'show' : 'hide'));
+      head.append(mk('span', 'row-fill'), mk('span', 'sub', s.folded ? t('show') : t('hide')));
       head.addEventListener('click', () => { this.folded.set(s.key, !s.folded); this.render(); this.hooks.onFold?.(); });
     }
     sec.append(head);
@@ -122,13 +123,13 @@ export class List {
     const r = remaining(item, now);
     const clock = mk('span', 'ls-clock', r.known ? `${r.left}s` : '?');
     clock.setAttribute('role', 'timer');
-    clock.setAttribute('aria-label', r.known ? `Auto-deny in ${r.left} seconds` : 'Time left not measured');
+    clock.setAttribute('aria-label', r.known ? t('Auto-deny in {n} seconds', { n: r.left }) : t('Time left not measured'));
     head.append(who, mk('span', 'row-fill'), clock);
     card.append(head);
     if (item.detail && !item.ask) card.append(mk('pre', 'ls-cmd', item.detail));
     // A request from another session says which, and goes there.
     if (item.sessionId !== this.current) {
-      const where = mk('button', 'ls-where', `in ${item.sessionName}`);
+      const where = mk('button', 'ls-where', t('in {name}', { name: item.sessionName }));
       where.type = 'button';
       where.addEventListener('click', () => this.hooks.onLocate?.(item));
       card.append(where);

package/kit/studio/web/liveness.js

@@ -16,6 +16,8 @@
 //
 // Offline is not a longer silence. It is the last request failing: a refused connection answers at once, so there
 // is nothing to wait for.
+import { t } from './i18n.js';
+
 export const STALE_AFTER_MS = 10000;
 
 /**
@@ -28,16 +30,16 @@ export function liveness(nowMs, lastOkMs, lastFailed) {
   if (lastFailed) {
     return {
       state: 'offline',
-      word: 'Offline',
+      word: t('Offline'),
       tone: 'fail',
-      detail: lastOkMs === null ? 'the server has not answered' : `last update ${clock(lastOkMs)}`,
+      detail: lastOkMs === null ? t('the server has not answered') : t('last update {time}', { time: clock(lastOkMs) }),
     };
   }
-  if (lastOkMs === null) return { state: 'connecting', word: 'Connecting', tone: null, detail: '' };
+  if (lastOkMs === null) return { state: 'connecting', word: t('Connecting'), tone: null, detail: '' };
   const silence = Math.max(0, nowMs - lastOkMs);
-  const said = `${Math.round(silence / 1000)}s ago`;
-  if (silence > STALE_AFTER_MS) return { state: 'stale', word: 'Stale', tone: 'waiting', detail: said };
-  return { state: 'live', word: 'Live', tone: 'good', detail: said };
+  const said = t('{n}s ago', { n: Math.round(silence / 1000) });
+  if (silence > STALE_AFTER_MS) return { state: 'stale', word: t('Stale'), tone: 'waiting', detail: said };
+  return { state: 'live', word: t('Live'), tone: 'good', detail: said };
 }
 
 /**
@@ -53,8 +55,8 @@ export function offlineNote(state, lastOkMs, nextTryMs, nowMs) {
   if (state !== 'offline') return null;
   const left = nextTryMs == null ? null : Math.max(0, Math.ceil((nextTryMs - nowMs) / 1000));
   return {
-    text: lastOkMs === null ? 'The server has not answered yet, so there is nothing to show.' : `Showing the last update from ${clock(lastOkMs)}.`,
-    retry: left == null ? 'Reconnecting' : left === 0 ? 'Reconnecting now' : `Reconnecting in ${left}s`,
+    text: lastOkMs === null ? t('The server has not answered yet, so there is nothing to show.') : t('Showing the last update from {time}.', { time: clock(lastOkMs) }),
+    retry: left == null ? t('Reconnecting') : left === 0 ? t('Reconnecting now') : t('Reconnecting in {n}s', { n: left }),
     stale: lastOkMs !== null,
   };
 }
@@ -72,7 +74,7 @@ function clock(ms) {
  * changed since it started; a server with no `code` at all predates the field, and is older than this page.
  * Returns the sentence to show, or null.
  */
-export const RESTART_NOTE = 'Studio was updated after this server started, so it is running the old code. Restart it: stop it where it runs (Ctrl-C), then /crew-studio.';
+export const RESTART_NOTE = t('Studio was updated after this server started, so it is running the old code. Restart it: stop it where it runs (Ctrl-C), then /crew-studio.');
 export function staleServerNote(health) {
   if (!health || typeof health !== 'object') return null;
   if (!health.code || typeof health.code !== 'object') return RESTART_NOTE;

package/kit/studio/web/map-plan.js

@@ -7,20 +7,22 @@
 
 // The layers /crew-map may write (eval/lib/crew-map/narrative.mjs LAYERS), set between the bands the scan alone
 // gives, so a map with no layer is drawn in the same order as before.
+import { t } from './i18n.js';
+
 export const LAYER_KEYS = ['ui', 'api', 'service', 'data', 'infra', 'tool', 'library'];
 export const BANDS = [
-  ['ui', 'UI'],
-  ['clients', 'Clients'],
-  ['api', 'API'],
-  ['entry', 'Entry points'],
-  ['service', 'Service'],
-  ['core', 'Core'],
-  ['data', 'Data'],
-  ['infra', 'Infrastructure'],
-  ['library', 'Library'],
-  ['tool', 'Tools'],
-  ['external', 'External'],
-  ['unplaced', 'Unplaced'],
+  ['ui', t('UI')],
+  ['clients', t('Clients')],
+  ['api', t('API')],
+  ['entry', t('Entry points')],
+  ['service', t('Service')],
+  ['core', t('Core')],
+  ['data', t('Data')],
+  ['infra', t('Infrastructure')],
+  ['library', t('Library')],
+  ['tool', t('Tools')],
+  ['external', t('External')],
+  ['unplaced', t('Unplaced')],
 ];
 
 const RESOURCE = { db: 'db', cache: 'cache', queue: 'queue', auth: 'auth', 'http-api': 'api' };
@@ -181,7 +183,7 @@ export function findingsOf(doc, { showHidden = false, compare = null } = {}) {
   for (const c of compare?.clients ?? []) {
     for (const m of c.missing) {
       all.push({
-        id: `cmp:${c.id}:${m.method} ${m.path}`, rule: 'compare-missing', title: `${m.method} ${m.path} is called by ${c.name} and not provided here`,
+        id: `cmp:${c.id}:${m.method} ${m.path}`, rule: 'compare-missing', title: t('{endpoint} is called by {client} and not provided here', { endpoint: `${m.method} ${m.path}`, client: c.name }),
         proven: true, hidden: false, hiddenReason: null, where: m.evidence?.[0] ? `${m.evidence[0].file}:${m.evidence[0].line}` : '', modules: [`cmp:${c.id}`],
         evidence: m.evidence ?? [], from: compare.label,
       });
@@ -204,13 +206,15 @@ export function findingCounts(findings) {
   return out;
 }
 
+const endpoints = (n) => (n === 1 ? t('1 endpoint') : t('{n} endpoints', { n }));
+
 /** What a card says under its name. */
 export function cardSub(node, doc) {
-  if (node.kind === 'client') return `${node.from} · ${node.calls.length} ${node.calls.length === 1 ? 'call' : 'calls'} here`;
-  if (node.kind === 'service') return node.image ? `container · ${node.image}` : 'container';
+  if (node.kind === 'client') return `${node.from} · ${node.calls.length === 1 ? t('1 call here') : t('{n} calls here', { n: node.calls.length })}`;
+  if (node.kind === 'service') return node.image ? `${t('container')} · ${node.image}` : t('container');
   const provided = (doc.provides?.endpoints ?? []).filter((e) => e.module === node.id).length;
   const tech = (node.tech ?? []).slice(0, 2).map((t) => t.replace(/@.*$/, '')).join(' · ');
-  return [tech || node.stack, provided ? `${provided} ${provided === 1 ? 'endpoint' : 'endpoints'}` : null].filter(Boolean).join(' · ');
+  return [tech || node.stack, provided ? endpoints(provided) : null].filter(Boolean).join(' · ');
 }
 
 /**
@@ -220,7 +224,7 @@ export function cardSub(node, doc) {
 export const CARD_CHIPS = 3;
 export function cardOf(node, doc) {
   const provided = (doc.provides?.endpoints ?? []).filter((e) => e.module === node.id).length;
-  const kind = [node.narrative?.domain ?? node.stack ?? null, provided ? `${provided} ${provided === 1 ? 'endpoint' : 'endpoints'}` : null].filter(Boolean).join(' · ');
+  const kind = [node.narrative?.domain ?? node.stack ?? null, provided ? endpoints(provided) : null].filter(Boolean).join(' · ');
   const tech = (node.tech ?? []).map((t) => t.replace(/@.*$/, ''));
   return { kind, chips: tech.slice(0, CARD_CHIPS), more: Math.max(0, tech.length - CARD_CHIPS), outside: outsideOf(node, doc) };
 }
@@ -264,10 +268,10 @@ export function summaryOf(doc, findings) {
   const n = (k) => (doc.nodes ?? []).filter((x) => x.kind === k).length;
   const eps = (doc.provides?.endpoints?.length ?? 0) + (doc.consumes?.endpoints?.length ?? 0);
   return [
-    `${n('module')} ${n('module') === 1 ? 'module' : 'modules'}`,
-    `${n('external')} external`,
-    `${eps} ${eps === 1 ? 'endpoint' : 'endpoints'}`,
-    `${findings.shown.length} ${findings.shown.length === 1 ? 'finding' : 'findings'}`,
+    n('module') === 1 ? t('1 module') : t('{n} modules', { n: n('module') }),
+    t('{n} external', { n: n('external') }),
+    endpoints(eps),
+    findings.shown.length === 1 ? t('1 finding') : t('{n} findings', { n: findings.shown.length }),
   ];
 }
 
@@ -277,10 +281,10 @@ export function sourceOf(data) {
   const behind = data.behind?.count;
   return {
     file: data.file,
-    at: commit ? `scanned at ${commit.slice(0, 7)}` : 'scanned outside git',
-    behind: typeof behind === 'number' && behind > 0 ? `${behind} ${behind === 1 ? 'commit' : 'commits'} behind` : null,
+    at: commit ? t('scanned at {commit}', { commit: commit.slice(0, 7) }) : t('scanned outside git'),
+    behind: typeof behind === 'number' && behind > 0 ? (behind === 1 ? t('1 commit behind') : t('{n} commits behind', { n: behind })) : null,
     behindNote: typeof behind === 'number' ? null : (data.behind?.reason ?? null),
-    rule: 'Nothing is run; files are only read.',
+    rule: t('Nothing is run; files are only read.'),
   };
 }
 
@@ -304,7 +308,7 @@ export function inspectOf(node, doc, edges, findings) {
     // /crew-map's description: { text, cites }, each cite a file:line of this node's evidence (eval/lib/crew-map/narrative.mjs).
     narrative: typeof node.narrative?.text === 'string' ? node.narrative.text : null,
     narrativeCites: Array.isArray(node.narrative?.cites) ? node.narrative.cites.filter((c) => typeof c === 'string') : [],
-    narrativeNote: 'Not written yet: this map holds no description of the module, only what its files show.',
+    narrativeNote: t('Not written yet: this map holds no description of the module, only what its files show.'),
     // /crew-map's layer and domain, when it wrote them; the band is the layer's (bandOf).
     layer: LAYER_KEYS.includes(node.narrative?.layer) ? (BANDS.find(([k]) => k === node.narrative.layer)?.[1] ?? null) : null,
     domain: typeof node.narrative?.domain === 'string' ? node.narrative.domain : null,
@@ -320,7 +324,7 @@ export function inspectOf(node, doc, edges, findings) {
     testFiles: Array.isArray(node.tests?.files) ? node.tests.files.filter((f) => typeof f === 'string') : [],
     testTotal: Number.isInteger(node.tests?.total) ? node.tests.total : 0,
     changed: Number.isInteger(node.commits) && Number.isInteger(doc?.source?.commitsRead) && doc.source.commitsRead > 0
-      ? `Changed in ${node.commits} of the last ${doc.source.commitsRead} ${doc.source.commitsRead === 1 ? 'commit' : 'commits'}` : null,
+      ? (doc.source.commitsRead === 1 ? t('Changed in {n} of the last 1 commit', { n: node.commits }) : t('Changed in {n} of the last {of} commits', { n: node.commits, of: doc.source.commitsRead })) : null,
     notes: (node.markers?.evidence ?? []).filter((e) => e && typeof e.file === 'string').map((e) => ({ at: `${e.file}:${e.line}`, text: String(e.text ?? '') })),
     notesTotal: node.markers?.evidenceTotal ?? (node.markers?.evidence ?? []).length,
     connectsTo: out,
@@ -345,8 +349,8 @@ export function taskOf(f) {
 
 /** What the view says when there is no map to draw. */
 export function emptyNote(data) {
-  if (!data) return 'Reading the map…';
-  if (data.measured === false) return data.missing ? `No map yet — ${data.reason}` : `Not read — ${data.reason}`;
+  if (!data) return t('Reading the map…');
+  if (data.measured === false) return data.missing ? t('No map yet — {reason}', { reason: data.reason }) : t('Not read — {reason}', { reason: data.reason });
   return null;
 }
 
@@ -452,5 +456,5 @@ export function chipsOf(node, doc) {
   const p = (doc.provides?.endpoints ?? []).filter((e) => e.module === node.id).map((e) => `${e.method} ${e.path}`);
   const c = (doc.consumes?.endpoints ?? []).filter((e) => e.module === node.id).map((e) => `→ ${e.method} ${e.path}`);
   const all = [...p, ...c];
-  return all.length > CHIPS_MAX ? [...all.slice(0, CHIPS_MAX), `+${all.length - CHIPS_MAX} more`] : all;
+  return all.length > CHIPS_MAX ? [...all.slice(0, CHIPS_MAX), t('+{n} more', { n: all.length - CHIPS_MAX })] : all;
 }