@zgeoff/atc 0.1.6 → 0.1.7

package/README.md

@@ -43,7 +43,7 @@ fine nested inside zellij/tmux (give the pane locked mode so Ctrl-Space reaches
 | `R`             | home           | restore last fleet after a daemon death — respawns every session via `claude --resume <id>`    |
 | `j`/`k`/`↑`/`↓` | overlay/picker | move                                                                                           |
 | `Enter`         | overlay        | attach (auto-acks)                                                                             |
-| `Tab`           | overlay        | attach the most urgent needs-you session                                                       |
+| `Tab`           | overlay        | attach the most urgent needs-you session, else the latest turn-done one                        |
 | `/`             | overlay        | fuzzy filter by name/dir (chars in order), `⏎` attach top match, `esc` clear                   |
 | `a`             | overlay        | ack notification without attaching                                                             |
 | `H`             | overlay        | eject to headless: the terminal dies, a headless Agent SDK run resumes the same session        |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zgeoff/atc",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "description": "Terminal control tower for Claude Code sessions",
   "homepage": "https://github.com/zgeoff/atc#readme",
   "bugs": "https://github.com/zgeoff/atc/issues",

package/src/index.ts

@@ -2,6 +2,7 @@ import { basename } from 'node:path';
 import { bootDaemonClient } from './boot-daemon';
 import { loadConfig } from './config';
 import { collectDirs, findFuzzyScore, formatDir, pickMatches } from './dirs';
+import { pickTabTarget } from './pick-tab-target';
 import type { EventMsg } from './protocol';
 import { isRecord } from './report';
 import { countSessionStates, sortGroupedSessionViews, sortSessionViews } from './sessions';
@@ -39,6 +40,12 @@ let confirmKill = false;
 
 // The client's mirror of the daemon's fleet, kept fresh by events.
 let fleet: MirrorSession[] = [];
+
+// When each session last flipped to done, so the Tab jump can prefer the
+// most recently finished turn. Sessions already done before this client
+// connected have no entry and rank last.
+const doneAt = new Map<string, number>();
+
 let focusedID: string | null = null;
 let fleetCount = 0;
 
@@ -471,6 +478,10 @@ function applyDaemonEvent(e: EventMsg) {
       if (s !== undefined) {
         const next = SESSION_STATES.find((x) => x === e['state']);
 
+        if (next === 'done' && s.state !== 'done') {
+          doneAt.set(s.id, Date.now());
+        }
+
         if (next !== undefined) {
           s.state = next;
         }
@@ -524,6 +535,10 @@ function applyDaemonEvent(e: EventMsg) {
     case 'session.removed': {
       fleet = fleet.filter((x) => x.id !== e['s']);
 
+      if (typeof e['s'] === 'string') {
+        doneAt.delete(e['s']);
+      }
+
       if (focusedID === e['s']) {
         focusedID = null;
       }
@@ -695,10 +710,10 @@ function applyOverlayKey(buf: Buffer) {
   const ch = buf.toString();
 
   if (buf[0] === KEY.tab) {
-    const needy = sortSessionViews(fleet).find((s) => s.state === 'needs_you' && s.alive);
+    const target = pickTabTarget(fleet, (id) => doneAt.get(id));
 
-    if (needy !== undefined) {
-      void attach(needy.id);
+    if (target !== undefined) {
+      void attach(target.id);
     }
 
     return;

package/src/pick-tab-target.ts

@@ -0,0 +1,31 @@
+import type { SessionState } from './sessions';
+import { sortSessionViews } from './sessions';
+
+interface TabCandidate {
+  readonly id: string;
+  readonly state: SessionState;
+  readonly createdAt: number;
+  readonly alive: boolean;
+  readonly kind: 'pty' | 'jsonl';
+}
+
+/**
+ * The Tab jump target: the most urgent alive needs-you session, else the
+ * alive terminal session whose turn finished most recently. Headless
+ * sessions never qualify for the fallback — they have no terminal to
+ * attach — and sessions with no recorded finish time rank last.
+ */
+export function pickTabTarget<T extends TabCandidate>(
+  list: readonly T[],
+  findDoneAt: (id: string) => number | undefined,
+): T | undefined {
+  const needy = sortSessionViews(list).find((s) => s.state === 'needs_you' && s.alive);
+
+  if (needy !== undefined) {
+    return needy;
+  }
+
+  return sortSessionViews(list)
+    .filter((s) => s.state === 'done' && s.alive && s.kind === 'pty')
+    .toSorted((a, b) => (findDoneAt(b.id) ?? 0) - (findDoneAt(a.id) ?? 0))[0];
+}

package/src/ui.ts

@@ -274,7 +274,7 @@ export function drawHelp() {
 
   const lines = [
     '⏎  attach the selected session',
-    '⇥  attach the most urgent needs-you session',
+    '⇥  attach the most urgent needs-you, else latest done',
     'a  ack its notification without attaching',
     'H  eject to a headless run',
     'P  revive a dead or headless session',