@bongos/core 1.17.0

package/scripts/gds/status.js

@@ -0,0 +1,365 @@
+#!/usr/bin/env node
+// /status — one-call project status rollup (#435, ADR 0025).
+//
+// Answers "what's left for criterion C8?" in a single call, replacing the
+// ~10-step prose archaeology (grep seed file → eyeball "Gates R55–R63" →
+// re-query each task) that motivated the task. Reads the structured
+// criterion↔task link (task_criteria, migration 055) via the public endpoint
+// GET /api/gds/versions/:id/progress.
+//
+// Usage:
+//   node scripts/gds/status.js                  # all criteria, default version
+//   node scripts/gds/status.js C8               # drill into one criterion
+//   node scripts/gds/status.js --version V1     # another version
+//   node scripts/gds/status.js --version GDS-V3 C8
+//   node scripts/gds/status.js --json           # machine-readable
+//
+// Read-only and UNAUTHENTICATED (the endpoint is public, same posture as
+// /versions/:id/done-when), so it works before /builder-setup too.
+//
+// Exit codes: 0 ok · 1 network/api error · 2 bad invocation · 3 not found.
+
+const { API_BASE, cliClient } = require('./cli-lib');
+
+// The active internal version; override with GDS_STATUS_DEFAULT_VERSION (or pass
+// --version). Bumped GDS-V4 → BONGOS-V1 (task 1709, ADR 0103): GDS-V4 was
+// consolidated into BONGOS-V1 (the Cloud Bongos platform version) and frozen, so
+// the bare `/status` card should default to the live version, not a sealed one.
+const DEFAULT_VERSION = process.env.GDS_STATUS_DEFAULT_VERSION || 'BONGOS-V1';
+
+// Compact, status-first ordering for the "remaining: …" summaries.
+const STATUS_ORDER = ['shipped', 'confirmed', 'completed', 'claimed', 'ready', 'blocked', 'backlog'];
+
+function parseArgs(argv) {
+  const args = argv.slice(2);
+  let version = null;
+  let criterion = null;
+  let json = false;
+  let widget = false;
+  let hook = false;
+  for (let i = 0; i < args.length; i++) {
+    const a = args[i];
+    if (a === '--version' || a === '-v') {
+      version = args[++i];
+      if (version == null) return { error: '--version requires a value' };
+    } else if (a === '--json') json = true;
+    else if (a === '--widget') widget = true;
+    else if (a === '--hook') hook = true;
+    else if (a === '--help' || a === '-h') return { help: true };
+    else if (/^[Cc]\d+$/.test(a)) criterion = a.toUpperCase();
+    else if (a.startsWith('-')) return { error: `unknown flag: ${a}` };
+    else if (!version) version = a; // bare token → version id
+    else if (!criterion) criterion = a.toUpperCase();
+    else return { error: `unexpected argument: ${a}` };
+  }
+  return { version: version || DEFAULT_VERSION, criterion, json, widget, hook };
+}
+
+async function fetchProgress(version) {
+  let res;
+  try {
+    res = await fetch(`${API_BASE}/api/gds/versions/${encodeURIComponent(version)}/progress`, {
+      headers: { 'User-Agent': 'amazonprimea-status-cli/1.0' },
+    });
+  } catch (err) {
+    console.error(`status: could not reach ${API_BASE} (${err.message})`);
+    process.exit(1);
+  }
+  if (!res.ok) {
+    console.error(`status: GET /versions/${version}/progress → ${res.status}`);
+    process.exit(1);
+  }
+  return res.json();
+}
+
+// "R54" if the title is a "V3.R54 — …" rank-prefixed title, else "".
+function rankTag(title) {
+  const m = /\bR\d+\b/.exec(title || '');
+  return m ? m[0] : '';
+}
+
+function shortTitle(title, max = 52) {
+  const t = (title || '').replace(/^V\d+\.R\d+\s*[—-]\s*/, ''); // drop the "V3.R54 — " prefix
+  return t.length > max ? t.slice(0, max - 1) + '…' : t;
+}
+
+// "1 confirmed, 2 backlog" — non-shipped tasks grouped by status, ordered.
+function remainingSummary(remaining) {
+  if (remaining.length === 0) return 'none — all shipped ✓';
+  const byStatus = {};
+  for (const t of remaining) byStatus[t.status] = (byStatus[t.status] || 0) + 1;
+  // Unknown statuses sort last (rank 999), known ones by STATUS_ORDER position.
+  const rank = (s) => {
+    const i = STATUS_ORDER.indexOf(s);
+    return i < 0 ? 999 : i;
+  };
+  const parts = Object.keys(byStatus)
+    .sort((a, b) => rank(a) - rank(b))
+    .map((s) => `${byStatus[s]} ${s}`);
+  return parts.join(', ');
+}
+
+function bar(shipped, total, width = 10) {
+  if (total === 0) return '─'.repeat(width);
+  const filled = Math.round((shipped / total) * width);
+  return '█'.repeat(filled) + '░'.repeat(width - filled);
+}
+
+function clabel(c) {
+  return `C${c.cnum}`.padEnd(3);
+}
+
+// ---------- card renderers (task 1288: deterministic /status card) ----------
+// Status had no card — it printed freeform text the skill was told to
+// "interpret + relay", the exact per-session non-determinism the card
+// methodology removes. These render the SAME rollup as a self-contained widget
+// (--widget, and the --hook HTML form) and as a markdown card (the --hook
+// markdown form / widgets-off / no-renderer fallback). Design mirrors the
+// builder-start card (flat, 0.5px borders, CSS theme vars, Tabler icons, no
+// emoji); classes are `.st-*` so they can't collide with builder-start's `.bs-*`
+// or the ship card's `.cc-*`.
+const sesc = (s) => String(s == null ? '' : s).replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;');
+
+const STATUS_WIDGET_STYLE = `<style>
+.st-sr{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border:0;}
+.st-card{background:var(--color-background-primary);border:0.5px solid var(--color-border-tertiary);border-radius:var(--border-radius-lg);padding:1rem 1.25rem;font-family:var(--font-sans);}
+.st-head{display:flex;align-items:center;justify-content:space-between;gap:12px;flex-wrap:wrap;}
+.st-title{font-size:16px;font-weight:500;}
+.st-title i{font-size:16px;vertical-align:-2px;margin-right:6px;color:#378ADD;}
+.st-meta{font-size:13px;color:var(--color-text-secondary);}
+.st-crit{font-size:13px;color:var(--color-text-secondary);margin-top:8px;}
+.st-bar{display:inline-block;width:48px;height:5px;border-radius:3px;background:var(--color-border-tertiary);overflow:hidden;vertical-align:middle;margin-right:6px;}
+.st-barfill{display:block;height:100%;background:#1D9E75;}
+.st-table{width:100%;border-collapse:collapse;table-layout:fixed;font-size:13px;margin-top:10px;}
+.st-thead{text-align:left;color:var(--color-text-tertiary);font-size:12px;}
+.st-th{padding:0 6px 4px;font-weight:400;}
+.st-tr{cursor:pointer;}
+.st-td{padding:7px 6px;border-top:0.5px solid var(--color-border-tertiary);vertical-align:top;}
+.st-id{color:var(--color-text-secondary);font-family:var(--font-mono);font-size:12px;}
+.st-ok{color:var(--color-text-success);}
+.st-ellip{white-space:nowrap;overflow:hidden;text-overflow:ellipsis;}
+.st-sub{color:var(--color-text-secondary);}
+.st-nowrap{white-space:nowrap;}
+.st-foot{font-size:13px;color:var(--color-text-tertiary);margin-top:12px;}
+</style>`;
+
+function widgetBar(shipped, total) {
+  const pct = total > 0 ? Math.round((shipped / total) * 100) : 0;
+  return `<span class="st-bar"><span class="st-barfill" style="width:${pct}%;"></span></span>`;
+}
+
+// Self-contained HTML for the app's widget renderer (show_widget). `criterion`
+// null → version overview (rows drill into a criterion); set → one criterion's
+// gating tasks (ready rows claim).
+function renderStatusWidget(data, criterion) {
+  if (criterion) {
+    const c = criterion;
+    const rows = c.tasks.map((t) => {
+      const tag = rankTag(t.title);
+      const claimable = t.status === 'ready';
+      const click = claimable
+        ? ` role="button" tabindex="0" onclick="sendPrompt('Claim task ${t.id}')" onkeydown="if(event.key==='Enter'||event.key===' '){event.preventDefault();sendPrompt('Claim task ${t.id}')}"`
+        : '';
+      return `<tr class="st-tr"${click}><td class="st-td st-sub st-nowrap">${sesc(t.status)}</td><td class="st-td st-id">#${t.id}${tag ? ' ' + sesc(tag) : ''}</td><td class="st-td st-ellip" title="${sesc(t.title)}">${sesc(shortTitle(t.title, 80))}</td></tr>`;
+    }).join('');
+    const body = c.tasks.length
+      ? `<table class="st-table"><colgroup><col style="width:84px;"><col style="width:92px;"><col></colgroup><thead><tr class="st-thead"><th class="st-th">Status</th><th class="st-th">#</th><th class="st-th">Task</th></tr></thead><tbody>${rows}</tbody></table>`
+      : `<div class="st-crit">No tasks linked to this criterion yet.</div>`;
+    const claimHint = c.tasks.some((t) => t.status === 'ready') ? ' · click a ready task to claim it' : '';
+    return `${STATUS_WIDGET_STYLE}
+<h2 class="st-sr">${sesc(data.version_id)} criterion C${c.cnum} ${c.satisfied ? 'is satisfied' : 'is not yet satisfied'}: ${c.counts.shipped} of ${c.counts.total} gating tasks shipped.</h2>
+<div class="st-card">
+  <div class="st-head"><span class="st-title"><i class="ti ti-checklist" aria-hidden="true"></i>${sesc(data.version_id)} · C${c.cnum}</span><span class="st-meta">${c.satisfied ? '<span class="st-ok">satisfied</span>' : 'not satisfied'} · ${c.counts.shipped}/${c.counts.total} shipped</span></div>
+  <div class="st-crit">${sesc(c.criterion_md.replace(/\*\*/g, '').slice(0, 160))}</div>
+  ${body}
+  <div class="st-foot">remaining: ${sesc(remainingSummary(c.remaining))}${claimHint}</div>
+</div>`;
+  }
+  const satisfied = data.criteria.filter((x) => x.satisfied).length;
+  // Version → Goals → Criteria (ADR 0086 §2 / BV1.R58). Render each criterion
+  // row under its goal's header. Fall back to a flat list if the rollup carries
+  // no goals (older payload).
+  const critRow = (c) =>
+    `<tr class="st-tr" role="button" tabindex="0" title="Drill into C${c.cnum}: ${sesc(c.criterion_id)}" onclick="sendPrompt('/status C${c.cnum}')" onkeydown="if(event.key==='Enter'||event.key===' '){event.preventDefault();sendPrompt('/status C${c.cnum}')}"><td class="st-td st-ok st-nowrap">${c.satisfied ? '✓' : ''}</td><td class="st-td st-id">C${c.cnum}</td><td class="st-td st-ellip" title="${sesc(c.criterion_id)}">${sesc(c.criterion_id)}</td><td class="st-td st-nowrap">${widgetBar(c.counts.shipped, c.counts.total)}${c.counts.shipped}/${c.counts.total}</td><td class="st-td st-ellip st-sub">${c.remaining.length ? sesc(remainingSummary(c.remaining)) : '—'}</td></tr>`;
+  const goals = (data.goals && data.goals.length) ? data.goals : null;
+  const rows = goals
+    ? goals.map((g) => {
+        const ach = g.status === 'achieved';
+        const head = `<tr><td class="st-td" colspan="5" style="background:var(--color-background-secondary);font-weight:500;"><i class="ti ti-target" aria-hidden="true"></i> ${sesc(g.title)} <span class="st-sub">· ${ach ? '<span class="st-ok">achieved</span>' : sesc(g.status)}${g.criteria.length ? '' : ' · no criteria yet'}</span></td></tr>`;
+        return head + g.criteria.map(critRow).join('');
+      }).join('')
+    : data.criteria.map(critRow).join('');
+  const goalMeta = goals ? ` · ${data.goals_achieved}/${data.goals_total} goals${data.version_done ? ' ✓' : ''}` : '';
+  const foot = data.unattributed_tasks > 0
+    ? `<div class="st-foot">${data.unattributed_tasks} task(s) not linked to any criterion · click a row to drill in</div>`
+    : `<div class="st-foot">Click a criterion to see its gating tasks</div>`;
+  return `${STATUS_WIDGET_STYLE}
+<h2 class="st-sr">${sesc(data.version_id)} status: ${satisfied} of ${data.criteria.length} done-when criteria satisfied across ${goals ? data.goals_total : 0} goal(s). Click a criterion to drill in.</h2>
+<div class="st-card">
+  <div class="st-head"><span class="st-title"><i class="ti ti-checklist" aria-hidden="true"></i>${sesc(data.version_id)} status</span><span class="st-meta">${satisfied}/${data.criteria.length} criteria${goalMeta}</span></div>
+  <table class="st-table"><colgroup><col style="width:24px;"><col style="width:44px;"><col><col style="width:96px;"><col style="width:120px;"></colgroup><thead><tr class="st-thead"><th class="st-th"></th><th class="st-th">#</th><th class="st-th">Criterion</th><th class="st-th">Shipped</th><th class="st-th">Remaining</th></tr></thead><tbody>${rows}</tbody></table>
+  ${foot}
+</div>`;
+}
+
+// The markdown form — the --hook fallback / widgets-off / no-renderer surface.
+// Same rollup, rendered verbatim everywhere.
+function renderStatusMarkdown(data, criterion) {
+  const lines = [];
+  if (criterion) {
+    const c = criterion;
+    lines.push(`**/status · ${data.version_id} · C${c.cnum}** — ${c.satisfied ? 'satisfied ✓' : 'not satisfied'}`);
+    lines.push(`_${c.criterion_md.replace(/\*\*/g, '').slice(0, 160)}_`);
+    lines.push('');
+    if (c.tasks.length) {
+      lines.push('| Status | # | Task |');
+      lines.push('|---|---|---|');
+      for (const t of c.tasks) {
+        const tag = rankTag(t.title);
+        lines.push(`| ${t.status} | #${t.id}${tag ? ' ' + tag : ''} | ${shortTitle(t.title, 60)} |`);
+      }
+    } else {
+      lines.push('_No tasks linked to this criterion yet._');
+    }
+    lines.push('');
+    lines.push(`${c.counts.shipped}/${c.counts.total} shipped · remaining: ${remainingSummary(c.remaining)}`);
+    return lines.join('\n');
+  }
+  const satisfied = data.criteria.filter((x) => x.satisfied).length;
+  const goals = (data.goals && data.goals.length) ? data.goals : null;
+  const goalMeta = goals ? ` · ${data.goals_achieved}/${data.goals_total} goals achieved${data.version_done ? ' ✓ (version done)' : ''}` : '';
+  lines.push(`**/status · ${data.version_id}** — ${satisfied}/${data.criteria.length} criteria satisfied${goalMeta}`);
+  lines.push('');
+  // Version → Goals → Criteria (ADR 0086 §2): a subheading per goal, its criteria
+  // beneath. Falls back to a single flat table if the payload carries no goals.
+  const critRow = (c) => `| ${c.satisfied ? '✓' : ''} | C${c.cnum} | ${c.criterion_id} | ${bar(c.counts.shipped, c.counts.total)} ${c.counts.shipped}/${c.counts.total} | ${c.remaining.length ? remainingSummary(c.remaining) : '—'} |`;
+  const tableHeader = () => { lines.push('| | # | Criterion | Shipped | Remaining |'); lines.push('|---|---|---|---|---|'); };
+  if (goals) {
+    for (const g of goals) {
+      lines.push(`**🎯 ${g.title}** — ${g.status === 'achieved' ? 'achieved ✓' : g.status}${g.criteria.length ? '' : ' · no criteria yet'}`);
+      if (g.criteria.length) { tableHeader(); for (const c of g.criteria) lines.push(critRow(c)); }
+      lines.push('');
+    }
+  } else {
+    tableHeader();
+    for (const c of data.criteria) lines.push(critRow(c));
+  }
+  if (data.unattributed_tasks > 0) {
+    lines.push('');
+    lines.push(`_${data.unattributed_tasks} task(s) not linked to any criterion._`);
+  }
+  lines.push('');
+  lines.push('→ Drill into one: `/status C8`');
+  return lines.join('\n');
+}
+
+// Best-effort widgets pref (task 1279). Status is public/pre-setup, so this is
+// non-fatal: apiCall adds auth only when a session exists and never exits, so an
+// unauthenticated /me just 401s → default ON (emit the widget).
+async function resolveWidgetsPref() {
+  try {
+    const api = await cliClient();
+    const me = await api.me.getMe();
+    if (me && me.ok && me.data && me.data.render) return me.data.render.widgets_enabled !== false;
+  } catch (_) { /* unauth / offline → default ON */ }
+  return true;
+}
+
+function printAll(data) {
+  const satisfied = data.criteria.filter((c) => c.satisfied).length;
+  const goals = (data.goals && data.goals.length) ? data.goals : null;
+  const goalMeta = goals ? `, ${data.goals_achieved}/${data.goals_total} goals achieved${data.version_done ? ' ✓' : ''}` : '';
+  console.log(`\n${data.version_id} — done-when progress  (${satisfied}/${data.criteria.length} criteria satisfied${goalMeta})\n`);
+  // Version → Goals → Criteria (ADR 0086 §2): a heading per goal, criteria beneath.
+  const printCrit = (c) => {
+    const flag = c.satisfied ? '✓' : ' ';
+    const line = `${flag} ${clabel(c)} ${c.criterion_id.padEnd(34)} ${bar(c.counts.shipped, c.counts.total)} `
+      + `${c.counts.shipped}/${c.counts.total} shipped`;
+    const rem = c.remaining.length ? `   remaining: ${remainingSummary(c.remaining)}` : '';
+    console.log(line + rem);
+  };
+  if (goals) {
+    for (const g of goals) {
+      console.log(`  🎯 ${g.title}  [${g.status === 'achieved' ? 'achieved ✓' : g.status}]${g.criteria.length ? '' : '  (no criteria yet)'}`);
+      for (const c of g.criteria) printCrit(c);
+      if (g.criteria.length) console.log('');
+    }
+  } else {
+    for (const c of data.criteria) printCrit(c);
+  }
+  if (data.unattributed_tasks > 0) {
+    console.log(`\n${data.unattributed_tasks} task(s) in ${data.version_id} not linked to any criterion (run /status <Cn> to drill in).`);
+  }
+  console.log('');
+}
+
+function printOne(data, c) {
+  console.log(`\n${data.version_id} · C${c.cnum}  ${c.criterion_id}   [${c.satisfied ? 'satisfied ✓' : 'not satisfied'}]`);
+  console.log(`"${c.criterion_md.replace(/\*\*/g, '').slice(0, 120)}"\n`);
+  if (c.tasks.length === 0) {
+    console.log('  (no tasks linked — this criterion has no structured gating tasks yet)\n');
+    return;
+  }
+  for (const t of c.tasks) {
+    const tag = rankTag(t.title);
+    const left = `${t.status}`.padEnd(10);
+    console.log(`  ${left} #${t.id}${tag ? ' ' + tag : ''}  ${shortTitle(t.title)}`);
+  }
+  console.log(`\n  ${c.counts.shipped}/${c.counts.total} shipped · remaining: ${remainingSummary(c.remaining)}\n`);
+}
+
+async function main() {
+  const opts = parseArgs(process.argv);
+  if (opts.error) {
+    console.error(`status: ${opts.error}`);
+    console.error('Usage: node scripts/gds/status.js [--version ID] [Cn] [--json]');
+    process.exit(2);
+  }
+  if (opts.help) {
+    console.log('Usage: node scripts/gds/status.js [--version ID] [Cn] [--json]');
+    process.exit(0);
+  }
+  const data = await fetchProgress(opts.version);
+
+  // Resolve the requested criterion (if any) once — every output mode needs it.
+  let c = null;
+  if (opts.criterion) {
+    const n = Number(opts.criterion.slice(1));
+    c = data.criteria.find((x) => x.cnum === n);
+    if (!c) {
+      console.error(`status: ${opts.version} has no criterion ${opts.criterion} (it has C1–C${data.criteria.length}).`);
+      process.exit(3);
+    }
+  }
+
+  // --hook (task 1288): the machine envelope the card-delivery hook consumes —
+  // both card forms from this single fetch. stdout carries the JSON only.
+  if (opts.hook) {
+    const widgets = await resolveWidgetsPref();
+    process.stdout.write(JSON.stringify({
+      widgets_enabled: widgets,
+      html: renderStatusWidget(data, c),
+      markdown: renderStatusMarkdown(data, c),
+      warnings: [],
+    }) + '\n');
+    return;
+  }
+  // --widget: pure HTML for a direct show_widget render (the skill's fallback).
+  if (opts.widget) { process.stdout.write(renderStatusWidget(data, c) + '\n'); return; }
+  // --json: unchanged machine interface (the criterion object when drilling in,
+  // else the whole version rollup).
+  if (opts.json) { console.log(JSON.stringify(c || data, null, 2)); return; }
+
+  // Default human output — the existing plain-text rollup, unchanged.
+  if (c) { printOne(data, c); return; }
+  printAll(data);
+}
+
+if (require.main === module) {
+  main().catch((err) => {
+    console.error('status: unexpected error:', err.message);
+    process.exit(1);
+  });
+}
+
+module.exports = { parseArgs, renderStatusWidget, renderStatusMarkdown };