@bongos/core 1.19.249 → 1.19.251

package/modules/hall-ui/public/copy-desk.css

@@ -0,0 +1,119 @@
+/* modules/hall-ui/public/copy-desk.css — the Copy desk tab (task 1003113 / R02
+   of goal 1000074).
+
+   Built on the hall's existing tokens (style.css) rather than a new palette: the
+   page whose subject is "does this project speak with one voice" would be a poor
+   place to introduce a second visual one. Only the shapes this page needs are
+   defined here. */
+
+.cd-stats {
+  display: grid;
+  grid-template-columns: repeat(auto-fit, minmax(9rem, 1fr));
+  gap: 0.75rem;
+  margin: 0.5rem 0 1rem;
+}
+.cd-stat {
+  display: flex;
+  flex-direction: column;
+  gap: 0.15rem;
+  padding: 0.75rem 0.9rem;
+  border: 1px solid var(--line, rgba(255, 255, 255, 0.12));
+  border-radius: 0.5rem;
+  background: var(--panel, rgba(255, 255, 255, 0.03));
+}
+.cd-stat__n { font-size: 1.6rem; font-weight: 700; line-height: 1.1; }
+.cd-stat__l { font-size: 0.8rem; opacity: 0.7; }
+
+.cd-note { font-size: 0.85rem; opacity: 0.75; line-height: 1.5; }
+.cd-note code {
+  padding: 0.05rem 0.3rem;
+  border-radius: 0.25rem;
+  background: var(--panel, rgba(255, 255, 255, 0.06));
+  font-size: 0.95em;
+}
+
+.cd-filters { display: flex; flex-wrap: wrap; gap: 0.5rem 0.75rem; align-items: center; margin: 0.5rem 0 1rem; }
+.cd-filters__label { font-size: 0.8rem; opacity: 0.7; }
+.cd-filters__select,
+.cd-browse__input,
+.cd-dialog__select,
+.cd-dialog__input,
+.cd-dialog__text {
+  padding: 0.4rem 0.6rem;
+  border: 1px solid var(--line, rgba(255, 255, 255, 0.15));
+  border-radius: 0.35rem;
+  background: var(--panel, rgba(0, 0, 0, 0.2));
+  color: inherit;
+  font: inherit;
+}
+
+.cd-browse { margin: 0.5rem 0 1rem; }
+.cd-browse__label { display: block; font-size: 0.8rem; opacity: 0.7; margin-bottom: 0.3rem; }
+.cd-browse__input { width: 100%; max-width: 34rem; }
+
+.cd-list { display: flex; flex-direction: column; gap: 0.6rem; }
+.cd-empty { padding: 1rem; opacity: 0.65; font-size: 0.9rem; }
+
+.cd-card {
+  padding: 0.85rem 1rem;
+  border: 1px solid var(--line, rgba(255, 255, 255, 0.12));
+  border-radius: 0.5rem;
+  background: var(--panel, rgba(255, 255, 255, 0.03));
+}
+.cd-card--slim { padding: 0.6rem 0.8rem; }
+.cd-card__head { display: flex; flex-wrap: wrap; gap: 0.4rem; align-items: center; margin-bottom: 0.4rem; }
+.cd-card__target { margin: 0.2rem 0 0.45rem; line-height: 1.5; }
+.cd-card__actions { display: flex; flex-wrap: wrap; gap: 0.5rem; align-items: center; justify-content: flex-end; margin-top: 0.5rem; }
+
+/* The quoted string is the product's own words, shown as evidence — so it is
+   visually set apart from this page's own voice. Wrapping is preserved because
+   leading and trailing space in a string is often exactly what is wrong. */
+.cd-quote {
+  quotes: '"' '"';
+  font-family: ui-monospace, SFMono-Regular, Menlo, monospace;
+  font-size: 0.9em;
+  white-space: pre-wrap;
+  word-break: break-word;
+}
+.cd-where { font-size: 0.8rem; opacity: 0.6; font-family: ui-monospace, SFMono-Regular, Menlo, monospace; }
+.cd-byline { font-size: 0.8rem; opacity: 0.65; margin-left: auto; }
+.cd-reason { margin: 0.3rem 0 0; line-height: 1.55; }
+.cd-snapshot-label { font-size: 0.8rem; opacity: 0.6; }
+.cd-closed { margin: 0.5rem 0 0; font-size: 0.85rem; opacity: 0.8; line-height: 1.5; }
+.cd-places { margin: 0.3rem 0 0; padding-left: 1.1rem; font-size: 0.8rem; opacity: 0.65; font-family: ui-monospace, SFMono-Regular, Menlo, monospace; }
+
+.cd-tag {
+  display: inline-block;
+  padding: 0.1rem 0.45rem;
+  border: 1px solid var(--line, rgba(255, 255, 255, 0.18));
+  border-radius: 999px;
+  font-size: 0.72rem;
+  letter-spacing: 0.02em;
+  opacity: 0.85;
+}
+.cd-tag--kind { font-weight: 600; opacity: 1; }
+/* 'untouched' is the only state that is WORK, so it is the only one that carries
+   colour — a queue where everything is highlighted highlights nothing. */
+.cd-tag--untouched { border-color: currentColor; opacity: 1; }
+.cd-tag--flagged,
+.cd-tag--settled,
+.cd-tag--moved { opacity: 0.6; }
+.cd-tag--gone { opacity: 0.75; font-style: italic; }
+
+.cd-dialog {
+  width: min(34rem, 92vw);
+  padding: 1.25rem;
+  border: 1px solid var(--line, rgba(255, 255, 255, 0.18));
+  border-radius: 0.6rem;
+  background: var(--bg, #12131a);
+  color: inherit;
+}
+.cd-dialog::backdrop { background: rgba(0, 0, 0, 0.55); }
+.cd-dialog__h { margin: 0 0 0.5rem; font-size: 1.1rem; }
+.cd-dialog__target { margin: 0 0 0.9rem; line-height: 1.5; }
+.cd-dialog__label { display: block; margin: 0.75rem 0 0.25rem; font-size: 0.85rem; font-weight: 600; }
+.cd-dialog__hint { display: block; font-weight: 400; font-size: 0.78rem; opacity: 0.65; line-height: 1.45; margin-top: 0.1rem; }
+.cd-dialog__select, .cd-dialog__input, .cd-dialog__text { width: 100%; }
+.cd-dialog__text { resize: vertical; line-height: 1.5; }
+.cd-dialog__err { min-height: 1.2rem; margin: 0.5rem 0 0; font-size: 0.85rem; color: var(--danger, #ff8080); line-height: 1.45; }
+.cd-dialog__actions { display: flex; gap: 0.5rem; justify-content: flex-end; margin-top: 0.9rem; }

package/modules/hall-ui/public/copy-desk.html

@@ -0,0 +1,139 @@
+<!doctype html>
+<html lang="en">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <title>Copy desk — {{worldName}}</title>
+  <meta name="description" content="The artist's queue over the words this project shows people: flagged copy, who flagged it and why, and the duplicated strings nobody has looked at yet.">
+  <link rel="icon" href="data:image/svg+xml;utf8,<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 32 32'><text x='16' y='24' font-size='24' text-anchor='middle' font-family='sans-serif'>⌂</text></svg>">
+  <link rel="preconnect" href="https://fonts.googleapis.com">
+  <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+  <link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&display=swap" rel="stylesheet">
+  <link rel="stylesheet" href="/builders/style.css?v=2026-07-02-shell1">
+  <link rel="stylesheet" href="/builders/copy-desk.css">
+</head>
+<body data-page="copy-desk" data-page-title="Copy desk">
+
+<div class="app">
+  <aside class="app-sidebar" id="app-sidebar" aria-label="Primary"></aside>
+  <div class="app-scrim" id="app-scrim" hidden></div>
+  <div class="app-body">
+    <header class="app-topbar" id="app-topbar"></header>
+    <div class="app-content">
+      <div class="page-head"><p class="page-head__sub" id="cd-sub">Loading the copy desk…</p></div>
+
+      <main>
+        <!-- The counts. Deliberately four numbers and not a dashboard: open work,
+             the fast pile (targets that have since been edited away), untouched
+             duplicates, and how big the inventory is. -->
+        <section class="scroll" id="cd-summary-scroll" aria-labelledby="cd-summary-h">
+          <h2 id="cd-summary-h" class="scroll__h">Where the words stand</h2>
+          <div class="cd-stats" id="cd-stats"></div>
+          <p class="cd-note" id="cd-registry-note"></p>
+        </section>
+
+        <!-- The queue. -->
+        <section class="scroll" id="cd-flags-scroll" aria-labelledby="cd-flags-h">
+          <h2 id="cd-flags-h" class="scroll__h">Flagged</h2>
+          <p class="scroll__lede">Copy someone has judged as needing attention, with their reason. Anyone can file one; closing it needs Metic+, or that it is your own.</p>
+          <div class="cd-filters">
+            <label class="cd-filters__label" for="cd-status">Show</label>
+            <select id="cd-status" class="cd-filters__select">
+              <option value="open" selected>Open</option>
+              <option value="resolved">Resolved</option>
+              <option value="dismissed">Dismissed</option>
+              <option value="all">Everything</option>
+            </select>
+            <label class="cd-filters__label" for="cd-surface">Surface</label>
+            <select id="cd-surface" class="cd-filters__select"><option value="">All surfaces</option></select>
+          </div>
+          <div class="cd-list" id="cd-flags"><div class="cd-empty">Loading…</div></div>
+        </section>
+
+        <!-- The one signal a machine can compute with no judgement layer at all
+             (R01's registry computes it; this only subtracts what has been dealt
+             with). Stale and off-voice need a person or a judge — this does not. -->
+        <section class="scroll" id="cd-dupes-scroll" aria-labelledby="cd-dupes-h">
+          <h2 id="cd-dupes-h" class="scroll__h">Said more than once</h2>
+          <p class="scroll__lede">The same sentence, in several places. Sometimes that is right and the answer is to dismiss it; sometimes it is seven copies of an error message that should have been one. Nobody has looked at the ones marked untouched.</p>
+          <div class="cd-list" id="cd-dupes"><div class="cd-empty">Loading…</div></div>
+        </section>
+
+        <!-- Find any string in the product and flag it. Without this the queue
+             could only ever contain what a machine had already noticed. -->
+        <section class="scroll" id="cd-find-scroll" aria-labelledby="cd-find-h">
+          <h2 id="cd-find-h" class="scroll__h">Find something to flag</h2>
+          <p class="scroll__lede">Search every string the product shows a person, by what it says or the file it lives in.</p>
+          <div class="cd-browse">
+            <label class="cd-browse__label" for="cd-search">Search the copy</label>
+            <input type="search" id="cd-search" class="cd-browse__input" autocomplete="off"
+                   placeholder="a phrase you saw, or a file name…">
+            <p class="cd-note" id="cd-search-count" role="status" aria-live="polite"></p>
+          </div>
+          <div class="cd-list" id="cd-results"></div>
+        </section>
+      </main>
+
+      <footer class="app-foot" id="app-foot"></footer>
+    </div>
+  </div>
+</div>
+
+<!-- The flag composer. A dialog rather than an inline field because the reason is
+     the point: a one-line input invites "typo", and the queue is only worth
+     reading if the reasons are. -->
+<dialog id="cd-dialog" class="cd-dialog">
+  <form method="dialog" id="cd-form">
+    <h3 class="cd-dialog__h" id="cd-dialog-h">Flag this copy</h3>
+    <p class="cd-dialog__target" id="cd-dialog-target"></p>
+    <label class="cd-dialog__label" for="cd-kind">What kind of wrong?</label>
+    <select id="cd-kind" class="cd-dialog__select">
+      <option value="off-voice">Off voice — says it in the wrong register</option>
+      <option value="slop">Slop — reads as machine-written</option>
+      <option value="unclear">Unclear — a person would not know what to do</option>
+      <option value="stale">Stale — describes something that changed</option>
+      <option value="duplicate">Duplicate — should be said once, in one place</option>
+      <option value="typo">Typo or grammar</option>
+      <option value="other" selected>Something else</option>
+    </select>
+    <label class="cd-dialog__label" for="cd-reason">Why? <span class="cd-dialog__hint">The artist reads this instead of guessing. A pointer with no judgement costs them a look and tells them nothing.</span></label>
+    <textarea id="cd-reason" class="cd-dialog__text" rows="4" minlength="10" required
+              placeholder="What is wrong with it, and what would better look like?"></textarea>
+    <p class="cd-dialog__err" id="cd-dialog-err" role="alert"></p>
+    <div class="cd-dialog__actions">
+      <button type="button" class="btn btn--ghost" id="cd-cancel">Cancel</button>
+      <button type="button" class="btn" id="cd-submit">File the flag</button>
+    </div>
+  </form>
+</dialog>
+
+<!-- Closing a flag asks for a note for the same reason opening one does. -->
+<dialog id="cd-close-dialog" class="cd-dialog">
+  <form method="dialog" id="cd-close-form">
+    <h3 class="cd-dialog__h">Close this flag</h3>
+    <p class="cd-dialog__target" id="cd-close-target"></p>
+    <label class="cd-dialog__label" for="cd-close-status">Outcome</label>
+    <select id="cd-close-status" class="cd-dialog__select">
+      <option value="resolved" selected>Resolved — the copy was changed</option>
+      <option value="dismissed">Dismissed — looked at, leaving it as it is</option>
+    </select>
+    <label class="cd-dialog__label" for="cd-close-task">Task that carried the fix <span class="cd-dialog__hint">Optional. This is the ledger link — a copy change ships as a task like every other change.</span></label>
+    <input type="number" id="cd-close-task" class="cd-dialog__input" placeholder="e.g. 1003113" min="1">
+    <label class="cd-dialog__label" for="cd-close-note">Note <span class="cd-dialog__hint">The next person to notice this sentence reads your note instead of re-litigating it.</span></label>
+    <textarea id="cd-close-note" class="cd-dialog__text" rows="3" minlength="10" required></textarea>
+    <p class="cd-dialog__err" id="cd-close-err" role="alert"></p>
+    <div class="cd-dialog__actions">
+      <button type="button" class="btn btn--ghost" id="cd-close-cancel">Cancel</button>
+      <button type="button" class="btn" id="cd-close-submit">Close it</button>
+    </div>
+  </form>
+</dialog>
+
+<div id="toast" class="toast" role="status" aria-live="polite" data-visible="0"></div>
+
+<script src="/builders/shell.js?v=2026-07-02-shell1"></script>
+<script src="/builders/palette.js" defer></script>
+<script src="/builders/dom-utils.js?v=2026-06-23-contrib"></script>
+<script src="/builders/copy-desk.js?v=2026-08-18-r02"></script>
+</body>
+</html>

package/modules/hall-ui/public/copy-desk.js

@@ -0,0 +1,352 @@
+// modules/hall-ui/public/copy-desk.js — the hall "Copy desk" tab
+// (/builders/copy-desk). Task 1003113 / R02 of goal 1000074, the artist's loop.
+//
+// The surface half of the flag: R01 built the inventory of every string the
+// product shows a person; the copy-desk module turned "this one is wrong" into a
+// row; this page is where an artist reads those rows and where everyone else
+// files them.
+//
+// FOUR PANELS, IN THE ORDER AN ARTIST WOULD WORK:
+//   1. the counts — what is outstanding, and the fast pile
+//   2. Flagged — the queue itself, newest first, open by default
+//   3. Said more than once — the deterministic duplicate signal, minus what has
+//      already been flagged or dismissed
+//   4. Find something to flag — search the whole inventory
+//
+// NO LIVE CMS. Nothing on this page edits a string. The composer collects a
+// JUDGEMENT (kind + reason); the fix ships as a claimed, graded task. There is
+// deliberately no "new text" field — see modules/copy-desk/tests/copy_no_cms.mjs.
+
+(() => {
+  'use strict';
+
+  const API = '/api/bongos';
+  const api = window.BongosClient.createClient({ baseUrl: '', credentials: 'same-origin', throwOnError: false });
+  const { escapeHtml, $, toast, fmtInt } = window.OTB;
+
+  let viewer = null;
+  let queue = null;
+  // The composer's current target, set when a "Flag" button is pressed.
+  let target = null;
+  let closing = null;
+
+  // ---------------------------------------------------------------------------
+  // rendering helpers
+  // ---------------------------------------------------------------------------
+
+  // A string shown as evidence is UNTRUSTED text from the product's own source
+  // tree, rendered into this page — so it is escaped like any other user data,
+  // and clipped so one runaway template literal cannot push the queue off screen.
+  function quote(text, max = 240) {
+    const s = String(text == null ? '' : text);
+    const clipped = s.length > max ? `${s.slice(0, max)}…` : s;
+    return `<q class="cd-quote">${escapeHtml(clipped)}</q>`;
+  }
+
+  function where(file, line) {
+    if (!file) return '';
+    return `<span class="cd-where">${escapeHtml(file)}${Number.isInteger(line) ? `:${line}` : ''}</span>`;
+  }
+
+  const KIND_LABEL = {
+    'off-voice': 'off voice', slop: 'slop', unclear: 'unclear',
+    stale: 'stale', duplicate: 'duplicate', typo: 'typo', other: 'flagged',
+  };
+
+  // The three states a flag's target can be in (registry.js annotateFlag).
+  // 'gone' is the interesting one and is spelled out rather than iconified: it
+  // means the sentence was edited or deleted since the flag was filed, which is
+  // a strong hint the flag is resolvable — but a hint for a person to act on,
+  // never something the server closes on its own.
+  function targetState(f) {
+    if (f.target_state === 'gone') {
+      return '<span class="cd-tag cd-tag--gone" title="The string this flag names is no longer in the registry — it was edited or removed. Probably already fixed; confirm and close it.">target gone</span>';
+    }
+    if (f.moved) {
+      return '<span class="cd-tag cd-tag--moved" title="Same text, different place — it moved file or line since the flag was filed.">moved</span>';
+    }
+    return '';
+  }
+
+  function canClose(f) {
+    if (!viewer) return false;
+    if (String(f.flagged_by) === String(viewer.id)) return true;
+    return viewer.rank === 'metic' || viewer.rank === 'archon';
+  }
+
+  function flagRow(f) {
+    const who = escapeHtml(f.flagged_by_name || f.flagged_by_login || 'someone');
+    const when = f.flagged_at ? new Date(f.flagged_at).toLocaleDateString() : '';
+    // Show the live text when the string is still there, and the snapshot when it
+    // is not — labelled, so "what it says now" is never confused with "what it
+    // said when someone objected".
+    const body = f.current
+      ? `${quote(f.current.text)} ${where(f.current.file, f.current.line)}`
+      : `<span class="cd-snapshot-label">said, when flagged:</span> ${quote(f.text_at_flag)} ${where(f.file_at_flag, f.line_at_flag)}`;
+
+    const scopeLine = f.scope === 'surface'
+      ? `<span class="cd-tag">whole surface</span> <span class="cd-where">${escapeHtml(f.surface)}</span>`
+      : body;
+
+    const closed = f.status !== 'open'
+      ? `<p class="cd-closed"><strong>${escapeHtml(f.status)}</strong>${f.resolved_task_id ? ` in task ${escapeHtml(String(f.resolved_task_id))}` : ''} — ${escapeHtml(f.resolution_note || '')}</p>`
+      : '';
+
+    return `<article class="cd-card" data-flag="${escapeHtml(String(f.id))}">
+      <div class="cd-card__head">
+        <span class="cd-tag cd-tag--kind">${escapeHtml(KIND_LABEL[f.kind] || f.kind)}</span>
+        ${targetState(f)}
+        <span class="cd-byline">${who} · ${escapeHtml(when)}</span>
+      </div>
+      <div class="cd-card__target">${scopeLine}</div>
+      <p class="cd-reason">${escapeHtml(f.reason)}</p>
+      ${closed}
+      ${f.status === 'open' && canClose(f)
+        ? `<div class="cd-card__actions"><button class="btn btn--ghost cd-close-btn" data-flag="${escapeHtml(String(f.id))}">Close…</button></div>`
+        : ''}
+    </article>`;
+  }
+
+  function dupeRow(d) {
+    const state = d.flagged
+      ? '<span class="cd-tag cd-tag--flagged">already flagged</span>'
+      : d.settled
+        ? '<span class="cd-tag cd-tag--settled">looked at</span>'
+        : '<span class="cd-tag cd-tag--untouched">untouched</span>';
+    const places = (d.at || []).map((a) => `<li>${escapeHtml(a)}</li>`).join('');
+    return `<article class="cd-card">
+      <div class="cd-card__head">
+        ${state}
+        <span class="cd-byline">${escapeHtml(String(d.occurrences))} places · ${escapeHtml(d.surface)}</span>
+      </div>
+      <div class="cd-card__target">${quote(d.text)}</div>
+      <ul class="cd-places">${places}</ul>
+      ${d.flagged ? '' : `<div class="cd-card__actions"><button class="btn btn--ghost cd-flag-btn"
+        data-id="${escapeHtml(d.id)}" data-surface="${escapeHtml(d.surface)}" data-text="${escapeHtml(d.text)}">Flag this…</button></div>`}
+    </article>`;
+  }
+
+  function resultRow(e) {
+    return `<article class="cd-card cd-card--slim">
+      <div class="cd-card__target">${quote(e.text)} ${where(e.file, e.line)}</div>
+      <div class="cd-card__actions">
+        <span class="cd-byline">${escapeHtml(e.surface)} · ${escapeHtml(e.origin || '')}</span>
+        ${e.flagged
+          ? '<span class="cd-tag cd-tag--flagged">already flagged</span>'
+          : `<button class="btn btn--ghost cd-flag-btn" data-id="${escapeHtml(e.id)}" data-surface="${escapeHtml(e.surface)}" data-text="${escapeHtml(e.text)}">Flag this…</button>`}
+      </div>
+    </article>`;
+  }
+
+  // ---------------------------------------------------------------------------
+  // paint
+  // ---------------------------------------------------------------------------
+
+  function paintStats() {
+    const c = queue.counts;
+    const r = queue.registry || {};
+    const total = (r.counts && r.counts.strings) || 0;
+    $('#cd-stats').innerHTML = [
+      ['Open flags', c.flags_open],
+      ['Target since edited', c.flags_target_gone],
+      ['Duplicates untouched', c.duplicates_untouched],
+      ['Strings inventoried', total],
+    ].map(([label, n]) =>
+      `<div class="cd-stat"><span class="cd-stat__n">${escapeHtml(String(fmtInt ? fmtInt(n) : n))}</span><span class="cd-stat__l">${escapeHtml(label)}</span></div>`
+    ).join('');
+
+    // Say which artifact this page is describing, and how to check it is current.
+    // The registry has no timestamp by design (its generator is deterministic and
+    // carries no clock), so this page must not imply one — it names the file and
+    // the command instead of showing an age that would be the checkout's.
+    const blind = (r.blind_spots || []).length;
+    $('#cd-registry-note').innerHTML =
+      `Read from <code>${escapeHtml(r.at || 'the copy registry')}</code> as committed. `
+      + `It is generated, not live: run <code>${escapeHtml(r.freshness_check || 'node scripts/gds/copy-inventory.js --check')}</code> to see whether it still matches the tree.`
+      + (blind ? ` This inventory has ${blind} documented blind spot${blind === 1 ? '' : 's'} — server-side messages, skill prose and runtime-composed strings are not in it, so it is not every word the project says.` : '');
+  }
+
+  function paintFlags() {
+    const el = $('#cd-flags');
+    if (!queue.flags.length) {
+      el.innerHTML = '<div class="cd-empty">Nothing flagged here. That is either good news or an unread queue — the duplicates below are the cheapest place to find out.</div>';
+      return;
+    }
+    el.innerHTML = queue.flags.map(flagRow).join('');
+  }
+
+  function paintDupes() {
+    const el = $('#cd-dupes');
+    const rows = queue.duplicates || [];
+    if (!rows.length) { el.innerHTML = '<div class="cd-empty">No duplicated strings in the registry.</div>'; return; }
+    // Untouched first — it is the only part of this list that is work.
+    const ordered = [...rows].sort((a, b) =>
+      (Number(a.flagged || a.settled) - Number(b.flagged || b.settled)) || (b.occurrences - a.occurrences));
+    el.innerHTML = ordered.map(dupeRow).join('');
+  }
+
+  function paintSurfaces() {
+    const sel = $('#cd-surface');
+    const surfaces = Object.keys((queue.registry && queue.registry.surfaces) || {});
+    sel.innerHTML = '<option value="">All surfaces</option>'
+      + surfaces.map((s) => `<option value="${escapeHtml(s)}">${escapeHtml(s)}</option>`).join('');
+  }
+
+  // ---------------------------------------------------------------------------
+  // load
+  // ---------------------------------------------------------------------------
+
+  async function loadQueue() {
+    const status = $('#cd-status').value;
+    const surface = $('#cd-surface').value;
+    const qs = new URLSearchParams({ status });
+    if (surface) qs.set('surface', surface);
+
+    const res = await api.request('GET', `${API}/copy-desk/queue?${qs}`);
+    if (!res.ok) {
+      const code = res.data && res.data.error && res.data.error.code;
+      const detail = (res.data && res.data.error && res.data.error.details) || {};
+      $('#cd-sub').textContent = code === 'registry_missing'
+        ? `No copy registry on this instance yet. Run ${detail.run || 'node scripts/gds/copy-inventory.js'} and commit it.`
+        : 'Could not load the copy desk.';
+      $('#cd-flags').innerHTML = '<div class="cd-empty">—</div>';
+      $('#cd-dupes').innerHTML = '<div class="cd-empty">—</div>';
+      return;
+    }
+    queue = res.data;
+    if (!$('#cd-surface').value && $('#cd-surface').options.length <= 1) paintSurfaces();
+    $('#cd-sub').textContent = 'The words this project shows people — what has been flagged, and what nobody has looked at.';
+    paintStats();
+    paintFlags();
+    paintDupes();
+  }
+
+  let searchTimer = null;
+  async function runSearch() {
+    const q = $('#cd-search').value.trim();
+    const surface = $('#cd-surface').value;
+    if (!q) { $('#cd-results').innerHTML = ''; $('#cd-search-count').textContent = ''; return; }
+
+    const qs = new URLSearchParams({ q });
+    if (surface) qs.set('surface', surface);
+    const res = await api.request('GET', `${API}/copy-desk/strings?${qs}`);
+    if (!res.ok) { $('#cd-search-count').textContent = 'Search failed.'; return; }
+
+    const { entries, matched, truncated, limit } = res.data;
+    // Say what is NOT shown. A silently capped list reads as a complete one.
+    $('#cd-search-count').textContent = truncated
+      ? `${matched} matches — showing the first ${limit}. Narrow the search to see the rest.`
+      : `${matched} match${matched === 1 ? '' : 'es'}.`;
+    $('#cd-results').innerHTML = entries.map(resultRow).join('');
+  }
+
+  // ---------------------------------------------------------------------------
+  // the composer
+  // ---------------------------------------------------------------------------
+
+  function openComposer(t) {
+    target = t;
+    $('#cd-dialog-target').innerHTML = t.string_id
+      ? `${quote(t.text)}<br><span class="cd-where">${escapeHtml(t.surface)}</span>`
+      : `<span class="cd-tag">whole surface</span> <span class="cd-where">${escapeHtml(t.surface)}</span>`;
+    $('#cd-reason').value = '';
+    $('#cd-dialog-err').textContent = '';
+    $('#cd-dialog').showModal();
+  }
+
+  async function submitFlag() {
+    const reason = $('#cd-reason').value.trim();
+    // Mirror the server's floor locally so the common case answers instantly —
+    // but the server and the DB constraint are the real gates, not this.
+    if (reason.replace(/\s+/g, ' ').length < 10) {
+      $('#cd-dialog-err').textContent = 'A flag needs a reason an artist can act on. What is wrong with it, and what would better look like?';
+      return;
+    }
+    const body = {
+      scope: target.string_id ? 'string' : 'surface',
+      surface: target.surface,
+      reason,
+      kind: $('#cd-kind').value,
+    };
+    if (target.string_id) body.string_id = target.string_id;
+
+    const res = await api.request('POST', `${API}/copy-desk/flags`, { body });
+    if (!res.ok) {
+      const err = (res.data && res.data.error) || {};
+      const d = err.details || {};
+      $('#cd-dialog-err').textContent = d.what_this_means || d.why || err.message || 'Could not file the flag.';
+      return;
+    }
+    $('#cd-dialog').close();
+    toast('Flagged. It is in the queue.');
+    await loadQueue();
+    if ($('#cd-search').value.trim()) await runSearch();
+  }
+
+  function openCloser(id) {
+    closing = queue.flags.find((f) => String(f.id) === String(id));
+    if (!closing) return;
+    $('#cd-close-target').innerHTML = `${quote(closing.reason, 160)}`;
+    $('#cd-close-note').value = '';
+    $('#cd-close-task').value = '';
+    $('#cd-close-err').textContent = '';
+    $('#cd-close-dialog').showModal();
+  }
+
+  async function submitClose() {
+    const note = $('#cd-close-note').value.trim();
+    if (note.replace(/\s+/g, ' ').length < 10) {
+      $('#cd-close-err').textContent = 'Closing is a judgement too — say what you decided, so the next person does not re-litigate it.';
+      return;
+    }
+    const body = { status: $('#cd-close-status').value, resolution_note: note };
+    const taskId = $('#cd-close-task').value.trim();
+    if (taskId) body.resolved_task_id = Number(taskId);
+
+    const res = await api.request('POST', `${API}/copy-desk/flags/${encodeURIComponent(closing.id)}/close`, { body });
+    if (!res.ok) {
+      const err = (res.data && res.data.error) || {};
+      const d = err.details || {};
+      $('#cd-close-err').textContent = d.what_this_means || d.why || err.message || 'Could not close the flag.';
+      return;
+    }
+    $('#cd-close-dialog').close();
+    toast('Closed.');
+    await loadQueue();
+  }
+
+  // ---------------------------------------------------------------------------
+  // wire
+  // ---------------------------------------------------------------------------
+
+  document.addEventListener('click', (ev) => {
+    const flagBtn = ev.target.closest('.cd-flag-btn');
+    if (flagBtn) {
+      openComposer({
+        string_id: flagBtn.dataset.id,
+        surface: flagBtn.dataset.surface,
+        text: flagBtn.dataset.text,
+      });
+      return;
+    }
+    const closeBtn = ev.target.closest('.cd-close-btn');
+    if (closeBtn) openCloser(closeBtn.dataset.flag);
+  });
+
+  $('#cd-cancel').addEventListener('click', () => $('#cd-dialog').close());
+  $('#cd-submit').addEventListener('click', submitFlag);
+  $('#cd-close-cancel').addEventListener('click', () => $('#cd-close-dialog').close());
+  $('#cd-close-submit').addEventListener('click', submitClose);
+  $('#cd-status').addEventListener('change', loadQueue);
+  $('#cd-surface').addEventListener('change', () => { loadQueue(); if ($('#cd-search').value.trim()) runSearch(); });
+  $('#cd-search').addEventListener('input', () => {
+    clearTimeout(searchTimer);
+    searchTimer = setTimeout(runSearch, 200);
+  });
+
+  (async () => {
+    const me = await api.request('GET', `${API}/me`);
+    if (me.ok) viewer = me.data.builder || me.data;
+    await loadQueue();
+  })();
+})();

package/modules/hall-ui/public/shell.js

@@ -122,6 +122,15 @@
       // active-nav detection (#nav-work), the 'work' gate case, and the server
       // page-gate all keep working — only the visible label and order change.
       { id: 'work', label: 'Tasks', icon: 'work', href: '/work', gate: 'signed' },
+      // task 1003113 (R02 of goal 1000074): the artist's queue over the words the
+      // product shows people. gate 'signed' and NOT a craft gate — filing a flag
+      // is open to every role on purpose (the engineer who wrote the toast and
+      // the newcomer who could not read the button are the two people most
+      // likely to notice bad copy, and neither is the artist), and an artist is a
+      // craft rather than a rank, so hiding this behind one would hide the
+      // artist's own queue from the artist. The module gate drops the tab on an
+      // instance that disables copy-desk.
+      { id: 'copy-desk', label: 'Copy desk', icon: 'docs', href: '/copy-desk', gate: 'signed', module: 'copy-desk' },
     ] },
     // Your own numbers. task 2174 folded Achievements into Standing and this task
     // retires its nav entry; VIEW_ALIASES still routes #achievements here, so old

package/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "@bongos/core",
-  "version": "1.19.249",
+  "version": "1.19.251",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@bongos/core",
-      "version": "1.19.249",
+      "version": "1.19.251",
       "license": "AGPL-3.0-or-later",
       "dependencies": {
         "express": "^4.21.2",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bongos/core",
-  "version": "1.19.249",
+  "version": "1.19.251",
   "description": "Cloud Bongos — the AI-first build platform core (GDS + platform surfaces + module system), installed as a versioned dependency (ADR 0108).",
   "license": "AGPL-3.0-or-later",
   "main": "src/platform-server.js",