@adrrr/tarmac 0.4.1 → 0.6.0

package/dist/map.js

@@ -3,6 +3,12 @@
 // A view over the fleet `buildFleet` already produced. It opens no second source: every
 // field below is derived from a row that is already on the page as a table line.
 import { isWaiting } from './sessions.js';
+/**
+ * What a berth is labelled when the source published no working directory for it. In the
+ * vocabulary the dials already use for a reading they do not have (`not chained`, `no turn
+ * yet`): a kind of nothing, named, rather than an empty frame that reads as a bug.
+ */
+const NO_DIRECTORY = 'no directory';
 /**
  * How recently a snapshot must have landed for its node to pulse. Two of the page's poll
  * intervals (5s): a session whose terminal keeps drawing frames keeps its heartbeat across
@@ -13,18 +19,20 @@ import { isWaiting } from './sessions.js';
  */
 export const PULSE_WITHIN_MS = 10_000;
 /**
- * Where an agent is placed, and why it is a placement rather than a link.
+ * Where a node goes, and why that is a grouping rather than a link.
  *
  * `claude agents --json` prints interactive and background sessions in one array, and
  * publishes nothing that ties an agent to whoever dispatched it. The working directory is
- * the only field both carry, so it is what an agent is placed BY — it lands next to the
- * session sharing its directory, and nothing is ever nested inside anything. Nesting would
- * assert a parentage the source does not contain, and it would let this page show a smaller
- * fleet than the table beside it.
+ * the only field both carry, so it is the only thing nodes are grouped BY — they share a
+ * berth, and nothing is ever nested inside anything. Nesting would assert a parentage the
+ * source does not contain, and it would let this page show a smaller fleet than the table
+ * beside it.
  *
- * The agents are gathered separately because the fleet sorts busy sessions first, so one can
- * arrive before the session it belongs beside. An agent whose directory matches no session
- * keeps a node of its own, at the end.
+ * One pass, in the fleet's own order, and each berth takes its place at its FIRST node: the
+ * rank that lifts a session halted on a human above everything else lifts the frame around it
+ * too, whether the node that earned it is a session or an agent. An agent whose directory
+ * matches no session is a berth of its own, ordered like any other — being last was the flat
+ * grid's arrangement of it, never the data's.
  */
 export function buildMap({ rows }, { pulseWithinMs = PULSE_WITHIN_MS } = {}) {
     // Whether this fleet still speaks the kind we know. If NOTHING calls itself `interactive`,
@@ -53,31 +61,30 @@ export function buildMap({ rows }, { pulseWithinMs = PULSE_WITHIN_MS } = {}) {
                 row.snapshotAgeMs <= pulseWithinMs,
         };
     };
-    const agents = rows.filter((r) => roleOf(r) === 'agent');
-    const placed = new Set();
-    const seen = new Set();
-    const nodes = [];
+    const berths = [];
+    const byCwd = new Map();
     for (const r of rows) {
-        if (roleOf(r) !== 'session')
-            continue;
-        nodes.push(node(r));
-        // Only the first session of a directory collects them, or two sessions in one checkout
-        // would each grow a copy of the same agents.
-        if (r.cwd === null || seen.has(r.cwd))
-            continue;
-        seen.add(r.cwd);
-        for (const a of agents) {
-            // Two directories nobody could read are not the same directory.
-            if (a.cwd === null || a.cwd !== r.cwd)
-                continue;
-            nodes.push(node(a));
-            placed.add(a);
+        const n = node(r);
+        // Two directories nobody could read are not the same directory, so an absent cwd joins no
+        // key: it opens a berth of its own every time, which is the one honest frame around it.
+        // Absent in both its shapes — `readSessions` carries a `cwd` of `''` through verbatim, and
+        // one module down that empty string is already read as no directory at all (`project` comes
+        // out null). Keyed on it, every such node shared a frame captioned "no directory": the one
+        // claim this shape refuses, made by the nodes that can least support it.
+        let berth = !r.cwd ? undefined : byCwd.get(r.cwd);
+        if (berth === undefined) {
+            // The project, the directory itself, then the words — and the middle one is not a page
+            // that prints paths. `path.basename` answers the empty string for exactly one directory,
+            // the root, so a fleet with a session in `/` had a project of `''`: not the absent cwd
+            // above, and no name either. The fallback names it `/`, which is what was read.
+            berth = { label: r.project || r.cwd || NO_DIRECTORY, sessions: [], agents: [] };
+            berths.push(berth);
+            if (r.cwd)
+                byCwd.set(r.cwd, berth);
         }
+        (n.role === 'session' ? berth.sessions : berth.agents).push(n);
     }
-    for (const a of agents)
-        if (!placed.has(a))
-            nodes.push(node(a));
-    return { nodes };
+    return { berths };
 }
 /**
  * The kind a terminal calls itself, and the anchor this module reasons from. A background