@scrylog/cli 0.3.0 → 0.3.1

package/src/shared/session-view.ts

@@ -1,302 +0,0 @@
-import type { ScrylogConfig } from "./config";
-import type { ProjectInfo, SessionModel, SessionState, SessionTool } from "./types";
-
-export interface SessionListProjectInfo {
-  displayName: string;
-  compactLabel: string;
-  branch?: string;
-  isGitRepository?: boolean;
-  sourcePath?: string;
-  gitRootPath?: string;
-  repositoryIdentityPath?: string;
-}
-
-export interface SessionListTmuxInfo {
-  session: string;
-  window: string;
-  pane: string;
-  windowName?: string;
-}
-
-export interface SessionListHerdrInfo {
-  paneId: string;
-  terminalId?: string;
-  workspaceId?: string;
-  workspace?: string;
-  tabId?: string;
-  tab?: string;
-  name?: string;
-  agent?: string;
-}
-
-export interface SessionListItem {
-  id: string;
-  source: SessionModel["source"];
-  tool: SessionTool;
-  state: SessionState;
-  summary: string;
-  lastActivity: number;
-  stableForMs?: number;
-  hasAttention?: boolean;
-  detectionSource?: SessionModel["detectionSource"];
-  parentSessionId?: string;
-  /** Human label for the session row: pane title > window/tab name > tmux session name */
-  displayName?: string;
-  project?: SessionListProjectInfo;
-  tmux?: SessionListTmuxInfo;
-  herdr?: SessionListHerdrInfo;
-  currentPath?: string;
-  activeTool?: string;
-  childCount?: number;
-  activeChildCount?: number;
-}
-
-export interface SessionTreeItem extends SessionListItem {
-  children: SessionListItem[];
-}
-
-export interface SessionViewCounts {
-  total: number;
-  visible: number;
-  rootsVisible: number;
-  childrenVisible: number;
-  byState: Record<SessionState, number>;
-  byTool: Record<SessionTool, number>;
-}
-
-export interface SessionView {
-  counts: SessionViewCounts;
-  sessions: SessionTreeItem[];
-}
-
-export interface SessionViewOptions {
-  includeUnknown?: boolean;
-}
-
-function makeStateCounts(): Record<SessionState, number> {
-  return {
-    working: 0,
-    idle: 0,
-    "waiting-input": 0,
-    error: 0,
-    shell: 0,
-    unknown: 0,
-  };
-}
-
-function makeToolCounts(): Record<SessionTool, number> {
-  return {
-    opencode: 0,
-    claude: 0,
-    codex: 0,
-    copilotcli: 0,
-    shell: 0,
-    unknown: 0,
-  };
-}
-
-const CODEX_ROOT_EPHEMERAL_GRACE_MS = 30_000;
-
-function isEphemeralCodexRootSession(session: SessionModel, now: number): boolean {
-  return session.tool === "codex"
-    && session.source === "standalone"
-    && session.detectionSource === "codex-hook"
-    && session.state === "idle"
-    && session.currentPath === "/"
-    && !session.codex?.transcriptPath
-    && !session.parentSessionId
-    && (session.childSessionIds?.length ?? 0) === 0
-    && now - session.lastActivity > CODEX_ROOT_EPHEMERAL_GRACE_MS;
-}
-
-function isCanonicallyVisible(
-  session: SessionModel,
-  config: ScrylogConfig,
-  now: number,
-  options: SessionViewOptions,
-): boolean {
-  if (session.tool === "unknown" && !options.includeUnknown) {
-    return false;
-  }
-
-  if (session.parentSessionId) {
-    return session.state === "working" || session.state === "waiting-input";
-  }
-
-  if (isEphemeralCodexRootSession(session, now)) {
-    return false;
-  }
-
-  const cutoff = config.tui.standaloneMaxAgeHours > 0
-    ? now - config.tui.standaloneMaxAgeHours * 3_600_000
-    : 0;
-
-  if (cutoff > 0 && session.source === "standalone" && session.lastActivity < cutoff) {
-    return false;
-  }
-
-  return true;
-}
-
-function toProject(project?: ProjectInfo): SessionListProjectInfo | undefined {
-  if (!project) return undefined;
-  return {
-    displayName: project.displayName,
-    compactLabel: project.compactLabel,
-    branch: project.branch,
-    isGitRepository: project.isGitRepository,
-    sourcePath: project.sourcePath,
-    gitRootPath: project.gitRootPath,
-    repositoryIdentityPath: project.repositoryIdentityPath,
-  };
-}
-
-const GRACE_PERIOD_MS = 1500;
-
-function resolveDisplayName(session: SessionModel): string | undefined {
-  if (session.tmux) {
-    return session.paneTitle?.trim()
-      || session.tmux.windowName?.trim()
-      || session.tmux.session?.trim()
-      || undefined;
-  }
-  if (session.herdr) {
-    return session.herdr.name?.trim()
-      || session.herdr.tab?.trim()
-      || session.herdr.agent?.trim()
-      || session.herdr.paneId
-      || undefined;
-  }
-  return undefined;
-}
-
-function effectiveState(session: SessionModel, activeChildCount: number, now: number): SessionState {
-  if (session.state === "idle" && !session.parentSessionId) {
-    if (activeChildCount > 0) {
-      return "working";
-    }
-    if (session.lastChildActiveAt && (now - session.lastChildActiveAt) < GRACE_PERIOD_MS) {
-      return "working";
-    }
-  }
-  return session.state;
-}
-
-function stableDuration(session: SessionModel, effective: SessionState, now: number): number {
-  if (effective === "working" && session.lastWorkingChangedAt) {
-    return Math.max(0, now - session.lastWorkingChangedAt);
-  }
-  if (session.stateChangedAt) {
-    return Math.max(0, now - session.stateChangedAt);
-  }
-  return session.stableForMs ?? Math.max(0, now - session.lastActivity);
-}
-
-function toListItem(session: SessionModel, childCount: number, activeChildCount: number, now: number): SessionListItem {
-  const effective = effectiveState(session, activeChildCount, now);
-  return {
-    id: session.id,
-    source: session.source,
-    tool: session.tool,
-    state: effective,
-    summary: session.summary,
-    lastActivity: session.lastActivity,
-    stableForMs: stableDuration(session, effective, now),
-    hasAttention: session.hasAttention,
-    detectionSource: session.detectionSource,
-    parentSessionId: session.parentSessionId,
-    displayName: resolveDisplayName(session),
-    project: toProject(session.project),
-    tmux: session.tmux ? { ...session.tmux } : undefined,
-    herdr: session.herdr ? {
-      paneId: session.herdr.paneId,
-      terminalId: session.herdr.terminalId,
-      workspaceId: session.herdr.workspaceId,
-      workspace: session.herdr.workspace,
-      tabId: session.herdr.tabId,
-      tab: session.herdr.tab,
-      name: session.herdr.name,
-      agent: session.herdr.agent,
-    } : undefined,
-    currentPath: session.currentPath,
-    activeTool: session.activeTool,
-    childCount,
-    activeChildCount,
-  };
-}
-
-export function flattenSessionTree(sessions: SessionTreeItem[]): SessionListItem[] {
-  const flat: SessionListItem[] = [];
-  for (const session of sessions) {
-    const { children: _children, ...root } = session;
-    flat.push(root);
-    flat.push(...session.children);
-  }
-  return flat;
-}
-
-export function buildSessionView(
-  sessions: SessionModel[],
-  config: ScrylogConfig,
-  now = Date.now(),
-  options: SessionViewOptions = {},
-): SessionView {
-  const byId = new Map(sessions.map((session) => [session.id, session]));
-  const allChildren = new Map<string, SessionModel[]>();
-  const visibleChildren = new Map<string, SessionModel[]>();
-  const visibleRoots = new Map<string, SessionModel>();
-
-  for (const session of sessions) {
-    if (session.parentSessionId) {
-      const arr = allChildren.get(session.parentSessionId) ?? [];
-      arr.push(session);
-      allChildren.set(session.parentSessionId, arr);
-
-      if (isCanonicallyVisible(session, config, now, options)) {
-        const visibleArr = visibleChildren.get(session.parentSessionId) ?? [];
-        visibleArr.push(session);
-        visibleChildren.set(session.parentSessionId, visibleArr);
-
-        const parent = byId.get(session.parentSessionId);
-        if (parent && isCanonicallyVisible(parent, config, now, options)) {
-          visibleRoots.set(parent.id, parent);
-        }
-      }
-      continue;
-    }
-
-    if (isCanonicallyVisible(session, config, now, options)) {
-      visibleRoots.set(session.id, session);
-    }
-  }
-
-  const sortedRoots = [...visibleRoots.values()].sort((a, b) => b.lastActivity - a.lastActivity);
-  const tree: SessionTreeItem[] = sortedRoots.map((root) => {
-    const activeChildren = (visibleChildren.get(root.id) ?? []).sort((a, b) => b.lastActivity - a.lastActivity);
-    const allDirectChildren = allChildren.get(root.id) ?? [];
-    return {
-      ...toListItem(root, allDirectChildren.length, activeChildren.length, now),
-      children: activeChildren.map((child) => toListItem(child, 0, 0, now)),
-    };
-  });
-
-  const flatVisible = flattenSessionTree(tree);
-  const byState = makeStateCounts();
-  const byTool = makeToolCounts();
-  for (const session of flatVisible) {
-    byState[session.state] += 1;
-    byTool[session.tool] += 1;
-  }
-
-  return {
-    counts: {
-      total: sessions.length,
-      visible: flatVisible.length,
-      rootsVisible: tree.length,
-      childrenVisible: flatVisible.filter((session) => Boolean(session.parentSessionId)).length,
-      byState,
-      byTool,
-    },
-    sessions: tree,
-  };
-}

package/src/shared/terminal-capabilities.ts

@@ -1,130 +0,0 @@
-import { stdin as input, stdout as output } from "node:process";
-
-/**
- * Non-invasive terminal capability probes used by `scrylog doctor` to explain
- * how provider icons negotiate graphics. Mirrors the response formats OpenTUI's
- * detector expects, but never enters the alternate screen and always restores
- * the terminal to its original state (`finally`).
- */
-
-export interface TerminalGraphicsCapabilities {
-  /** Terminal identification from XTVERSION (e.g. "ghostty(1.2.3)"), if answered. */
-  terminalName: string | null;
-  /** Outer multiplexer detected from the environment ("tmux" | "zellij" | "none"). */
-  multiplexer: "tmux" | "zellij" | "none";
-  /** Terminal answered a kitty graphics protocol query. */
-  kittyGraphics: boolean;
-  /** DA1 primary response advertises sixel (attribute 4). */
-  sixel: boolean;
-  /** Window pixel resolution from `CSI 14t`. */
-  pixelResolution: { width: number; height: number } | null;
-  /** stdin was not a TTY (SSH without tty, pipes) or raw mode was unavailable. */
-  probeFailed: boolean;
-  /** Why the probe did not run or answer. */
-  probeFailedReason: "not-a-tty" | "raw-unavailable" | "no-answer" | null;
-  /** TERM value, useful for manual triage. */
-  term: string | null;
-}
-
-const PROBE_TIMEOUT_MS = 300;
-
-const XTVERSION_PROBE = "\x1bP>0q\x1b\\";
-const DA1_PROBE = "\x1b[c";
-const KITTY_PROBE = "\x1b_Gi=31,s=1,v=1,a=q,t=d,f=24;AAAA\x1b\\";
-const PIXEL_RES_PROBE = "\x1b[14t";
-
-/** Visible attributes in a DA1 primary response (e.g. `ESC[?6;22;4c`). Sixel is attribute 4. */
-const DA1_RESPONSE = /\x1b\[\?(\d+(?:;\d+)*)c/g;
-const XTVERSION_RESPONSE = /\x1bP>[|]([^\x1b]+)\x1b\\/;
-const KITTY_RESPONSE = /\x1b_Gi=31;([^\x1b]*)\x1b\\/;
-const PIXEL_RES_RESPONSE = /\x1b\[4;(\d+);(\d+)t/;
-
-export function detectMultiplexer(): "tmux" | "zellij" | "none" {
-  if (process.env["TMUX"]) return "tmux";
-  if (process.env["ZELLIJ"]) return "zellij";
-  return "none";
-}
-
-export function parseResponses(sequence: string): Partial<TerminalGraphicsCapabilities> {
-  const result: Partial<TerminalGraphicsCapabilities> = {};
-  const version = sequence.match(XTVERSION_RESPONSE)?.[1];
-  if (version) result.terminalName = version.trim();
-  for (const da1 of sequence.matchAll(DA1_RESPONSE)) {
-    if (da1[1]!.split(";").includes("4")) result.sixel = true;
-  }
-  const kitty = sequence.match(KITTY_RESPONSE);
-  if (kitty) result.kittyGraphics = !(kitty[1] ?? "").startsWith("E:");
-  const res = sequence.match(PIXEL_RES_RESPONSE);
-  if (res) result.pixelResolution = { width: Number(res[2]), height: Number(res[1]) };
-  return result;
-}
-
-export function probeTerminalGraphics(): Promise<TerminalGraphicsCapabilities> {
-  const probe: TerminalGraphicsCapabilities = {
-    terminalName: null,
-    multiplexer: detectMultiplexer(),
-    kittyGraphics: false,
-    sixel: false,
-    pixelResolution: null,
-    probeFailed: true,
-    probeFailedReason: null,
-    term: process.env["TERM"] ?? null,
-  };
-
-  if (!input.isTTY || typeof input.setRawMode !== "function") {
-    return Promise.resolve({ ...probe, probeFailedReason: "not-a-tty" });
-  }
-
-  return new Promise((resolve) => {
-    const rawActive = input.isRaw === true;
-    const restore = () => {
-      try { input.setRawMode(rawActive); } catch { /* restore best effort */ }
-    };
-    let buffer = "";
-    let settleTimeout: ReturnType<typeof setTimeout> | null = null;
-    let done = false;
-    const stop = () => {
-      if (done) return;
-      done = true;
-      clearTimeout(settleTimeout!);
-      input.removeListener("data", onData);
-      restore();
-    };
-    const settle = () => {
-      stop();
-      const parsed = parseResponses(buffer);
-      const failed = Object.keys(parsed).length === 0;
-      resolve({
-        ...probe,
-        ...parsed,
-        probeFailed: failed,
-        probeFailedReason: failed ? "no-answer" : null,
-      });
-    };
-    const onData = (chunk: Buffer | string) => {
-      buffer += typeof chunk === "string" ? chunk : chunk.toString("latin1");
-      clearTimeout(settleTimeout!);
-      settleTimeout = setTimeout(settle, 80);
-    };
-    try {
-      input.setRawMode(true);
-    } catch {
-      resolve({ ...probe, probeFailedReason: "raw-unavailable" });
-      return;
-    }
-    input.on("data", onData);
-    settleTimeout = setTimeout(settle, PROBE_TIMEOUT_MS);
-    output.write(XTVERSION_PROBE + DA1_PROBE + KITTY_PROBE + PIXEL_RES_PROBE);
-  });
-}
-
-export type ProviderIconAdvice = "graphics" | "kitty" | "sixel" | "blocks";
-
-/** Maps probed capabilities to the recommended `tui.providerIcons` value. */
-export function adviseProviderIcons(capabilities: TerminalGraphicsCapabilities): ProviderIconAdvice {
-  if (capabilities.multiplexer === "tmux" || capabilities.multiplexer === "zellij") return "blocks";
-  if (capabilities.kittyGraphics) return "graphics";
-  if (capabilities.sixel && capabilities.pixelResolution) return "graphics";
-  if (capabilities.sixel) return "sixel";
-  return "blocks";
-}