trantor 0.17.15 → 0.17.17

package/.claude-plugin/marketplace.json

@@ -6,14 +6,14 @@
   },
   "metadata": {
     "description": "Trantor — the hub-world for AI agent crews: live message bus, presence, project Kanban/flow board + context-handoff for independent AI coding agents (Claude, Codex, Gemini, …)",
-    "version": "0.17.15"
+    "version": "0.17.17"
   },
   "plugins": [
     {
       "name": "trantor",
       "source": "./",
       "description": "The hub-world for AI agent crews. Say \"fire up the crew\" and Claude becomes the architect: a plan-aware Advisor routes the work (solo / cheap inline calls / live crew of Codex, Gemini, Kimi & DeepSeek in their own terminal windows), a Kanban/flow command center with a testing gate tracks it, and an economics brain (Scrooge) keeps the receipts. Includes the relay MCP, a SessionStart auto-discovery hook, and a PreCompact context-handoff so a fresh session can take over a full window instead of compacting.",
-      "version": "0.17.15",
+      "version": "0.17.17",
       "author": {
         "name": "Sasha Bogojevic"
       },

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "trantor",
-  "version": "0.17.15",
+  "version": "0.17.17",
   "description": "Trantor — the hub-world for AI agent crews: live message bus, presence, project Kanban/flow board + crew orchestration for independent AI coding agents (Claude, Codex, Gemini, Kimi, DeepSeek)",
   "mcpServers": {
     "relay": {

package/bin/cli.mjs

@@ -26,6 +26,7 @@ switch (cmd) {
   case "hub":     run("hub.mjs"); break;
   case "watch":   run("bin/relay-watch.mjs"); break;
   case "catchup": run("bin/catchup.mjs"); break;
+  case "backfill": run("bin/git-backfill.mjs"); break;
   case "ui": {
     let url = "http://127.0.0.1:4477";
     try { url = JSON.parse(readFileSync(join(process.env.HOME || "", ".agent-bus", "config.json"), "utf8")).url || url; } catch {}
@@ -46,6 +47,7 @@ switch (cmd) {
   trantor down        tear the crew down (kills processes, closes windows, no dialogs)
   trantor ui          open the live dashboard (board + flow views)
   trantor catchup     "where are we?" — the continuous board + git, with a synthesized brief
+  trantor backfill    card past GIT work onto the board (solo commits that were never carded) — [--since "14 days ago"] [--dry-run]
   trantor advise      ask the Advisor directly (JSON on stdin; --demo to see it)
   trantor hub         run the hub in the foreground (setup installs it as a service instead)
   trantor watch       live bus feed in the terminal

package/bin/git-backfill.mjs

@@ -0,0 +1,70 @@
+#!/usr/bin/env node
+// trantor backfill — bridge GIT history → the board. Solo work that was committed but never carded
+// (no crew, no TodoWrite) is invisible on the board; this turns it into done-cards so the project's
+// living record reflects what actually happened. Commits are grouped by feature THEME (conventional-
+// commit scope `feat(x):` → "x", or a "Prefix:" → the prefix), one done-card per theme placed at its
+// latest commit time (so it slots into the FLOW timeline correctly). Idempotent: skips titles already
+// on the board. Usage: trantor backfill [--since "14 days ago"] [--project <p>] [--dry-run]
+import { execSync } from "node:child_process";
+import { readFileSync, existsSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+import { resolveProject, hostId } from "../lib/project.mjs";
+
+function relayUrl() {
+  if (process.env.RELAY_URL) return process.env.RELAY_URL;
+  try { const c = join(homedir(), ".agent-bus", "config.json"); if (existsSync(c)) { const u = JSON.parse(readFileSync(c, "utf8")).url; if (u) return u; } } catch {}
+  return "http://127.0.0.1:4477";
+}
+const args = process.argv.slice(2);
+const arg = (name, def) => { const i = args.indexOf("--" + name); return i >= 0 ? args[i + 1] : def; };
+const dir = process.cwd();
+const project = arg("project", resolveProject(dir));
+const since = arg("since", "14 days ago");
+const dry = args.includes("--dry-run");
+const url = relayUrl();
+const me = `${hostId()}:${project}`;
+
+const themeOf = (s) => {
+  let m;
+  if ((m = s.match(/^[a-z]+\(([^)]+)\)\s*:/i))) return m[1].trim();           // feat(engine): → engine
+  if ((m = s.match(/^([A-Za-z][\w &+/.]*?)\s*:/))) return m[1].trim();        // "Landing: …" → Landing
+  if ((m = s.match(/^([A-Za-z][\w.+-]*)/))) return m[1];                      // first word
+  return "misc";
+};
+
+let rows = [];
+try {
+  rows = execSync(`git -C ${JSON.stringify(dir)} log --since=${JSON.stringify(since)} --format=%H%x09%ct%x09%s`,
+    { encoding: "utf8", maxBuffer: 16 * 1024 * 1024 }).trim().split("\n").filter(Boolean);
+} catch (e) { console.error(`git log failed: ${e.message}`); process.exit(1); }
+if (!rows.length) { console.log(`no commits since "${since}" in ${dir}`); process.exit(0); }
+
+const groups = new Map();
+for (const r of rows) {
+  const [hash, ct, ...rest] = r.split("\t");
+  const subject = rest.join("\t");
+  const key = themeOf(subject).slice(0, 32);
+  if (!groups.has(key)) groups.set(key, { commits: [], latest: 0 });
+  const g = groups.get(key); const ms = Number(ct) * 1000;
+  g.commits.push({ hash, ts: ms, subject }); if (ms > g.latest) g.latest = ms;
+}
+
+let existing = new Set();
+try { const t = (await (await fetch(`${url}/tasks?project=${encodeURIComponent(project)}`)).json()).tasks || []; existing = new Set(t.map(x => x.title)); } catch {}
+
+const ents = [...groups.entries()].sort((a, b) => a[1].latest - b[1].latest);
+let posted = 0, skipped = 0;
+for (const [theme, g] of ents) {
+  const latest = g.commits.sort((a, b) => b.ts - a.ts)[0];
+  const subj = latest.subject.replace(/^[a-z]+\([^)]*\)\s*:\s*/i, "").replace(/^[A-Za-z][\w &+/.]*?:\s*/, "").slice(0, 70);
+  const title = `${theme}: ${subj}${g.commits.length > 1 ? ` (+${g.commits.length - 1} more)` : ""}`.slice(0, 190);
+  if (existing.has(title)) { skipped++; continue; }
+  if (dry) { console.log(`+ [${new Date(g.latest).toISOString().slice(0, 10)}] ${theme.padEnd(20)} ${g.commits.length}c  ${title.slice(0, 64)}`); posted++; continue; }
+  try {
+    await fetch(`${url}/task`, { method: "POST", headers: { "content-type": "application/json" },
+      body: JSON.stringify({ project, title, status: "done", phase: theme, source: "git", ts: g.latest, assignee: me, by: me }) });
+    posted++;
+  } catch (e) { console.error(`post failed for "${title}": ${e.message}`); }
+}
+console.log(`${dry ? "[dry-run] " : ""}backfill: ${posted} theme-card(s) from ${rows.length} commits / ${groups.size} themes (${skipped} already on board) → ${project}`);

package/hub.mjs

@@ -257,14 +257,17 @@ const server = http.createServer(async (req, res) => {
     if (req.method === "POST" && P === "/task") {           // create a card
       const b = await body(req); touch(b.by, undefined, b.project);
       const st0 = ["todo","doing","testing","failed","done","blocked"].includes(b.status) ? b.status : "todo";
+      // optional historical ts (backfill from git/import) — accept a past epoch-ms; else now().
+      const ts0 = (Number.isFinite(b.ts) && b.ts > 0 && b.ts <= now() + 864e5) ? Math.floor(b.ts) : now();
       const t = { id: ++state.taskSeq, project: canon(String(b.project || "").slice(0,80)), title: String(b.title||"").slice(0,200),
         assignee: b.assignee || "", status: st0,
         phase: String(b.phase || "").slice(0, 40),   // explicit phase tag (FLOW v2) — wins over title-prefix inference
+        source: String(b.source || "").slice(0, 20), // e.g. "git" (backfill), "todo" — provenance
         difficulty: ["easy","medium","hard"].includes(b.difficulty) ? b.difficulty : "",
         model: String(b.model || "").slice(0, 60),
         deps: Array.isArray(b.deps) ? [...new Set(b.deps.map(Number).filter(n => Number.isInteger(n) && n > 0))].slice(0, 20) : [],
-        by: b.by || "", ts: now(), updated: now(),
-        history: [{ to: st0, by: b.by || "", ts: now() }] };
+        by: b.by || "", ts: ts0, updated: ts0,
+        history: [{ to: st0, by: b.by || "", ts: ts0 }] };
       state.tasks.push(t); if (state.tasks.length > 2000) state.tasks.splice(0, 500);
       appendCardEvent("created", t, b.by, null, st0);
       dirty = true; return json(res, 200, { ok: true, task: t });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "trantor",
-  "version": "0.17.15",
+  "version": "0.17.17",
   "type": "module",
   "bin": {
     "trantor": "bin/cli.mjs"

package/ui.html

@@ -198,6 +198,12 @@ main:not(.learn-open) .learn-body{display:none}
 .pfcount{fill:var(--mut);font-size:10.5px;font-family:ui-sans-serif,system-ui}
 .pfsub{fill:#9fb0c4;font-size:10.5px;font-family:ui-sans-serif,system-ui}
 .pflowwrap .fhint{position:absolute;right:12px;bottom:5px}
+/* mini-map scrubber: whole project compressed to a bar; click/drag to jump, .gmapview shows position */
+.gmap{position:relative;height:18px;margin:10px 16px 4px;border-radius:6px;background:#0c1320;border:1px solid var(--line);overflow:hidden;cursor:pointer;touch-action:none}
+.gmapseg{position:absolute;top:2px;bottom:2px;border-radius:2px;opacity:.5}
+.gmapseg.done{background:var(--grn2)}.gmapseg.active{background:#f0b24b}.gmapseg.failed,.gmapseg.blocked{background:var(--red)}.gmapseg.planned{background:#46566f}
+.gmap:hover .gmapseg{opacity:.7}
+.gmapview{position:absolute;top:-1px;bottom:-1px;min-width:8px;background:rgba(255,255,255,.14);border:1.5px solid rgba(255,255,255,.6);border-radius:5px;pointer-events:none;transition:left .04s linear}
 /* card detail modal — the full story of one card: status journey + the agent's own bus reports */
 .cmodal{position:fixed;inset:0;z-index:60;display:flex;align-items:center;justify-content:center;background:rgba(4,7,12,.62)}
 .cmpanel{background:var(--panel);border:1px solid var(--line);border-radius:14px;width:min(760px,93vw);max-height:84vh;display:flex;flex-direction:column;box-shadow:0 20px 64px rgba(0,0,0,.55)}
@@ -400,7 +406,7 @@ function flowHTML(pt, proj){
   };
   const gedge = (x1,y1,x2,y2,done) => { const mx=(x1+x2)/2;
     return `<path class="gedge${done?' done':''}" d="M${x1},${y1} C${mx},${y1} ${mx},${y2} ${x2},${y2}"/>`; };
-  let x = 26, svg = '', bands = '', prevIntRight = null, pi = 0;
+  let x = 26, svg = '', bands = '', segs = [], prevIntRight = null, pi = 0;
   for (const L of layouts){
     const { ph, cards, byId, parentsOf, hasChild, maxDepth, cols } = L;
     const planX = x, planY = Y0 - NH/2;
@@ -411,6 +417,7 @@ function flowHTML(pt, proj){
     const bx = planX - 16, bw = (intX + NW + 16) - bx;
     bands += `<rect class="pfband ${pi%2?'alt':''}" x="${bx}" y="2" width="${bw}" height="${totalH-4}" rx="10"/>`
           +  `<rect class="pfbandtop ${ph.status}" x="${bx}" y="2" width="${bw}" height="${MT-12}" rx="10"/>`;
+    segs.push({ label: ph.label, status: ph.status, total: ph.total, x0: bx, cx: planX, x1: bx + bw });
     // header: phase label + the GOAL (explicit) or derived THEME — "what this phase is about"
     const desc = (ph.goal || ph.theme || '').slice(0, Math.max(28, Math.floor(bw/7)));
     svg += `<text class="pflabel ${ph.status}" x="${planX}" y="${MT-38}">${esc(ph.label)}</text>`
@@ -439,17 +446,50 @@ function flowHTML(pt, proj){
   const totalW = x + 10;
   const defs = `<defs><marker id="garr" viewBox="0 0 8 8" refX="7" refY="4" markerWidth="6" markerHeight="6" orient="auto"><path d="M0,0 L8,4 L0,8 z" fill="#46566f"/></marker></defs>`;
   const notice = data.sparse ? `<div class="finfo">⚠ inferred phases — few cards carry explicit tags (P1/P5…), so they're grouped by time + title. Prefix cards (e.g. "P6 …") for sharper phases.</div>` : '';
-  return `<div class="pflowwrap gflow" data-proj="${esc(proj)}">${notice}`
+  // mini-map / scrubber: each phase a status-colored segment (% of total width). Click or drag to
+  // jump anywhere; the .gmapview overlay tracks where you are. data-total lets the JS map px↔ratio.
+  const pct = v => (100 * v / totalW).toFixed(3);
+  const mapsegs = segs.map(s =>
+    `<div class="gmapseg ${s.status}" style="left:${pct(s.x0)}%;width:${pct(s.x1 - s.x0)}%" data-cx="${s.cx}" title="${esc(s.label)} · ${s.status} · ${s.total} card${s.total>1?'s':''}"></div>`).join('');
+  const map = `<div class="gmap" data-proj="${esc(proj)}" data-total="${totalW}">${mapsegs}<div class="gmapview"></div></div>`;
+  return `<div class="pflowwrap gflow" data-proj="${esc(proj)}">${notice}${map}`
     + `<div class="gscroll" data-proj="${esc(proj)}"><svg width="${totalW}" height="${totalH}">${defs}${bands}${svg}</svg></div>`
-    + `<div class="fhint">orchestrator → crew → integrate · phase by phase  ·  scroll left/right →</div></div>`;
+    + `<div class="fhint">orchestrator → crew → integrate · phase by phase  ·  click/drag the bar above to scrub →</div></div>`;
 }
 const GSCROLL = {};
 function wireTimeline(el){
-  // FLOW v2 graph: click a card node to open its full /card detail; preserve horizontal scroll per project.
-  el.querySelectorAll('.gscroll').forEach(s => {
-    const proj = s.dataset.proj;
+  // FLOW v2 graph: scroll-position scrubber (mini-map) + click a card node for its /card detail.
+  el.querySelectorAll('.gflow').forEach(wrap => {
+    const proj = wrap.dataset.proj;
+    const s = wrap.querySelector('.gscroll'), map = wrap.querySelector('.gmap'), view = map && map.querySelector('.gmapview');
+    if (!s) return;
     if (GSCROLL[proj] != null) s.scrollLeft = GSCROLL[proj];
-    s.onscroll = () => { GSCROLL[proj] = s.scrollLeft; };
+    const syncView = () => {                                   // reflect where we are onto the mini-map
+      if (!view) return;
+      const w = s.scrollWidth || 1;
+      view.style.left = (100 * s.scrollLeft / w) + '%';
+      view.style.width = Math.min(100, 100 * s.clientWidth / w) + '%';
+    };
+    s.onscroll = () => { GSCROLL[proj] = s.scrollLeft; syncView(); };
+    requestAnimationFrame(syncView);
+    if (map) {
+      const scrubTo = (clientX) => {                           // map a pointer x onto a scroll position (centered)
+        const r = map.getBoundingClientRect();
+        const ratio = Math.max(0, Math.min(1, (clientX - r.left) / r.width));
+        s.scrollLeft = ratio * s.scrollWidth - s.clientWidth / 2;
+      };
+      let dragging = false;
+      map.addEventListener('pointerdown', e => {
+        dragging = true;
+        try { map.setPointerCapture?.(e.pointerId); } catch {}
+        const seg = e.target.closest && e.target.closest('.gmapseg');   // click a phase segment → jump to that phase
+        if (seg && seg.dataset.cx != null) s.scrollLeft = +seg.dataset.cx - 40; else scrubTo(e.clientX);
+        e.preventDefault();
+      });
+      map.addEventListener('pointermove', e => { if (dragging) scrubTo(e.clientX); });
+      const end = () => { dragging = false; };
+      map.addEventListener('pointerup', end); map.addEventListener('pointercancel', end);
+    }
   });
   el.querySelectorAll('.gnode[data-id]').forEach(n => n.onclick = () => openCard(+n.dataset.id));
 }