@gigaflow/gmux 0.15.0

package/dist/core/text.js

@@ -0,0 +1,126 @@
+/** Small pure string/time helpers. No I/O, no internal imports. */
+import { createHash } from "node:crypto";
+/** Collapse whitespace and clip to `max`, appending an ellipsis when clipped. */
+export function truncate(input, max) {
+    const flat = input.replace(/\s+/g, " ").trim();
+    if (flat.length <= max)
+        return flat;
+    return `${flat.slice(0, Math.max(0, max - 1))}…`;
+}
+/** Stable content hash used as a cache key. */
+export function hash(input) {
+    return createHash("sha256").update(input).digest("hex").slice(0, 16);
+}
+/**
+ * Compact relative age, e.g. "2h", "3d". Deliberately terse: it is a column in
+ * a list, not prose.
+ */
+export function relativeAge(iso, now = new Date()) {
+    const then = new Date(iso).getTime();
+    if (Number.isNaN(then))
+        return "?";
+    const seconds = Math.max(0, Math.floor((now.getTime() - then) / 1000));
+    if (seconds < 60)
+        return `${seconds}s`;
+    const minutes = Math.floor(seconds / 60);
+    if (minutes < 60)
+        return `${minutes}m`;
+    const hours = Math.floor(minutes / 60);
+    if (hours < 24)
+        return `${hours}h`;
+    const days = Math.floor(hours / 24);
+    if (days < 30)
+        return `${days}d`;
+    const months = Math.floor(days / 30);
+    if (months < 12)
+        return `${months}mo`;
+    return `${Math.floor(months / 12)}y`;
+}
+/**
+ * Parse a duration like "3d", "2w", "24h" into an ISO cutoff timestamp.
+ * Returns null for unparseable input.
+ */
+export function parseSince(input, now = new Date()) {
+    const match = /^(\d+)\s*([smhdw])$/i.exec(input.trim());
+    if (!match) {
+        const asDate = new Date(input);
+        return Number.isNaN(asDate.getTime()) ? null : asDate.toISOString();
+    }
+    const amount = Number(match[1]);
+    const unitMs = {
+        s: 1000,
+        m: 60_000,
+        h: 3_600_000,
+        d: 86_400_000,
+        w: 604_800_000,
+    };
+    const ms = unitMs[match[2].toLowerCase()];
+    return new Date(now.getTime() - amount * ms).toISOString();
+}
+/**
+ * Greedy word wrap. Returns at least one line, even for empty input, so callers
+ * can always render a row.
+ *
+ * A word longer than the width (a URL, a long path) is hard-split rather than
+ * allowed to overflow — overflowing is the bug this exists to fix.
+ */
+export function wrapText(input, width) {
+    const text = input.replace(/\s+/g, " ").trim();
+    if (text === "")
+        return [""];
+    if (!Number.isFinite(width) || width <= 0)
+        return [text];
+    const lines = [];
+    let line = "";
+    for (const word of text.split(" ")) {
+        if (line === "" && word.length > width) {
+            // Hard-split an oversized word across as many lines as it needs.
+            let rest = word;
+            while (rest.length > width) {
+                lines.push(rest.slice(0, width));
+                rest = rest.slice(width);
+            }
+            line = rest;
+            continue;
+        }
+        const candidate = line === "" ? word : `${line} ${word}`;
+        if (candidate.length <= width) {
+            line = candidate;
+            continue;
+        }
+        lines.push(line);
+        line = word.length > width ? "" : word;
+        if (word.length > width) {
+            let rest = word;
+            while (rest.length > width) {
+                lines.push(rest.slice(0, width));
+                rest = rest.slice(width);
+            }
+            line = rest;
+        }
+    }
+    if (line !== "")
+        lines.push(line);
+    return lines.length > 0 ? lines : [""];
+}
+/**
+ * Single-quote for POSIX shells, escaping any embedded single quote.
+ *
+ * Lives in core because two callers need it: `gmux resume --print` emits a line
+ * meant to be pasted into a shell, and the picker's fzf reload binding is a
+ * shell command string. In both, an unquoted path with a space silently runs
+ * the wrong thing rather than failing loudly.
+ */
+export function shellQuote(value) {
+    return /^[A-Za-z0-9_./:@-]+$/.test(value) ? value : `'${value.replace(/'/g, `'\\''`)}'`;
+}
+/** Pad or clip a cell to an exact display width. */
+export function cell(input, width) {
+    const flat = input.replace(/\s+/g, " ").trim();
+    if (flat.length === width)
+        return flat;
+    if (flat.length < width)
+        return flat.padEnd(width, " ");
+    return `${flat.slice(0, Math.max(0, width - 1))}…`;
+}
+//# sourceMappingURL=text.js.map

package/dist/core/text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.js","sourceRoot":"","sources":["../../src/core/text.ts"],"names":[],"mappings":"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"}

package/dist/core/types.d.ts

@@ -0,0 +1,322 @@
+/**
+ * The shared vocabulary of gmux. Every layer speaks these types.
+ *
+ * `core` imports nothing internal — see docs/architecture.md for the layer rule.
+ */
+/** Stable identifier for a harness, e.g. "claude-code" or "codex". */
+export type HarnessId = string;
+/** Schema version for every `--json` payload. Bump on breaking changes. */
+export declare const SCHEMA_VERSION = 1;
+/** A session file located on disk, before it has been parsed. */
+export interface SessionRef {
+    harness: HarnessId;
+    sessionId: string;
+    filePath: string;
+    /** Modification time in ms. Half of the index cache key. */
+    mtimeMs: number;
+    /** Size in bytes. The other half of the cache key. */
+    size: number;
+}
+/**
+ * One tmux pane as gmux sees it: geometry plus enough to resolve it to a
+ * session. `command` is `pane_current_command` (the foreground process, e.g.
+ * "claude", "codex", "node", "zsh") — a weak signal, since a node-based harness
+ * often shows as "node"; the cwd carries most of the resolution.
+ */
+export interface TmuxPane {
+    paneId: string;
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+    cwd: string;
+    command: string;
+    /** The pane's shell pid — the root for resolving which agent runs in it. */
+    pid: number;
+    /** tmux window id (`@N`), or null on tmux builds that omit it. */
+    windowId: string | null;
+    /** True when this is the active pane in its window. */
+    active: boolean;
+}
+/**
+ * An exact pane→session link recorded by `gmux run`. Ephemeral runtime state: a
+ * `paneId` means nothing once the tmux server dies, so this lives in the cache
+ * and is pruned to the live pane set on every read of the overlay.
+ */
+export interface PaneLink {
+    paneId: string;
+    harness: HarnessId;
+    sessionId: string;
+}
+/** A pull request a session produced. */
+export interface PrLink {
+    number: number;
+    url: string;
+    repository?: string;
+}
+/**
+ * Hard facts about one session, extracted by an adapter.
+ *
+ * Everything here is free: no model call, no network. `title` comes from the
+ * harness and describes where the session STARTED — prefer a SessionSummary
+ * when deciding what a session ended up being about.
+ */
+export interface SessionRecord {
+    harness: HarnessId;
+    sessionId: string;
+    filePath: string;
+    /** Working directory the session ran in. Needed to resume in the right place. */
+    cwd: string | null;
+    /** Basename of `cwd`, for display. */
+    project: string | null;
+    gitBranch: string | null;
+    startedAt: string | null;
+    updatedAt: string;
+    messageCount: number;
+    userPromptCount: number;
+    /** Harness-provided title. Reflects the START of the session; often stale. */
+    title: string | null;
+    /** The last thing the human actually said. The single most useful hard fact. */
+    lastUserPrompt: string | null;
+    /** Recent human turns, oldest first. Feeds the summarizer. */
+    recentUserPrompts: string[];
+    /**
+     * Evenly-spaced human turns sampled across the WHOLE session, oldest first.
+     * `arcPrompts[0]` is the original ask.
+     *
+     * `recentUserPrompts` says how the work ended; this says what shape it had.
+     * Both are needed: a summary written from the tail alone has no subject, and
+     * one written from the head alone is just the stale harness title again.
+     */
+    arcPrompts: string[];
+    /** Files the agent edited or wrote. */
+    filesTouched: string[];
+    prLinks: PrLink[];
+    /** Tail of the final assistant message. Feeds the summarizer. */
+    lastAssistantText: string | null;
+    /** Most recent failing tool call, if any. Strong signal of unfinished work. */
+    lastToolFailure: string | null;
+    /** True when the session was interrupted or ended on a failure. */
+    endedMidTask: boolean;
+    /** Subagent transcript rather than a top-level conversation. */
+    isSidechain: boolean;
+    /**
+     * A non-interactive run (`claude -p`, `codex exec`) rather than a conversation
+     * someone sat through. Hidden by default: these are automation, not work you
+     * would context-switch back into — and gmux's own summarizer creates
+     * them, so listing them would make the tool pollute its own output.
+     */
+    isAutomated: boolean;
+}
+/**
+ * A written summary of where a session LANDED, and what it is about.
+ *
+ * Generated from the session's arc — start, middle, end — so it describes the
+ * latest work without losing the thread that leads to it. Never from the head
+ * alone: that is just the stale harness title again.
+ */
+export interface SessionSummary {
+    harness: HarnessId;
+    sessionId: string;
+    /** Hash of the distilled input. Changes when the session changes. */
+    sourceHash: string;
+    /**
+     * SimHash of the session's narrative at summary time. Lets a watcher ask "has
+     * this diverged *enough* to re-summarise?" by bit-distance, rather than
+     * re-summarising on every keystroke. Absent on summaries written before 0.9.0.
+     */
+    fingerprint?: string;
+    /**
+     * Exact hash of the low-churn *significant* signals — prompt version, last tool
+     * failure, mid-task flag, files touched. These always force a refresh when they
+     * change, catching the small-but-important flips the SimHash distance would
+     * sleep through. Absent on pre-0.9.0 summaries.
+     */
+    signalHash?: string;
+    generatedAt: string;
+    /** Provider that wrote it, e.g. "claude -p". */
+    provider: string;
+    /** One line: what this work IS. The scannable label; the top of the drilldown. */
+    headline: string;
+    /** 2-3 sentences: what the session is fundamentally about. */
+    overview: string;
+    /**
+     * A paragraph or two: the real drilldown — how the work evolved and where it
+     * stands, enough to reorient without opening the session. Absent on summaries
+     * written before 0.10.0.
+     */
+    summary?: string;
+    /** What got done most recently. */
+    landed: string;
+    /** What is unresolved or blocked. */
+    open: string;
+    /** The concrete next action. */
+    nextStep: string;
+}
+/** A session paired with its summary, if one has been generated. */
+export interface SessionView {
+    record: SessionRecord;
+    summary: SessionSummary | null;
+}
+/** The distilled arc of a session, as handed to a summary provider. */
+export interface SummaryInput {
+    /**
+     * Bumped when the prompt changes shape. Part of the hash, and therefore of
+     * the cache key: a prompt edit must invalidate summaries written by the old
+     * prompt, or the change never reaches anything already on disk.
+     */
+    promptVersion: number;
+    harness: HarnessId;
+    sessionId: string;
+    project: string | null;
+    gitBranch: string | null;
+    title: string | null;
+    recentUserPrompts: string[];
+    /** Evenly-spaced turns across the whole session. `[0]` is the original ask. */
+    arcPrompts: string[];
+    lastAssistantText: string | null;
+    filesTouched: string[];
+    lastToolFailure: string | null;
+    endedMidTask: boolean;
+    /** Stable hash of the above. The summary cache key. */
+    hash: string;
+}
+/** The five fields a summary provider must return. */
+export interface SummaryFields {
+    headline: string;
+    overview: string;
+    summary: string;
+    landed: string;
+    open: string;
+    nextStep: string;
+}
+/**
+ * A model CLI gmux may call.
+ *
+ * `command` is argv for a one-shot call: prompt on stdin, text on stdout. That
+ * is the whole contract, and it is why gmux depends on no vendor SDK.
+ */
+export interface ProviderChoice {
+    /** Catalog id ("claude-code", "codex"), or "custom" for a hand-written command. */
+    id: string;
+    command: string[];
+}
+/** Config schema version. Bump when `GmConfig` changes shape incompatibly. */
+export declare const CONFIG_VERSION = 1;
+/**
+ * The choices a human made, persisted.
+ *
+ * Config is NOT cache. Wiping `~/.cache/gmux` must cost you summaries,
+ * never your provider choice — which is why this lives under the config dir and
+ * is keyed by nothing.
+ */
+export interface GmConfig {
+    version: number;
+    /**
+     * null means "make no model calls". A supported answer, not a missing value —
+     * `gmux setup` offers it, and it is how you decline the token spend outright.
+     */
+    provider: ProviderChoice | null;
+    /** Keep the recent window summarized in the background. */
+    autoSummarize: boolean;
+    /** gmux daemon + guardian settings. Absent on configs written before gmux. */
+    gmux?: import("./gmux-types.js").GmuxConfig;
+}
+/** One exchange in an `gmux ask` conversation. */
+export interface AskTurn {
+    question: string;
+    answer: string;
+}
+/**
+ * One record in the picker's chat thread, as it is appended to disk.
+ *
+ * Events rather than turns, and that is forced: the echo of a question must
+ * land the instant you press enter, ~9–20s before there is an answer to pair it
+ * with, and the log is append-only — so "the question, and the answer when it
+ * comes" has to be two records. `AskTurn` is what these fold *into*
+ * (`foldCompletedTurns`), which is why the two live side by side.
+ *
+ * `seq` keys everything, never file order: two writers append here (the sender
+ * writes `question`, the worker writes `chunk`/`end`), and a fold that depended
+ * on position would depend on a lock in another module.
+ *
+ * `meta` is written once, by the first sender, inside the same open that creates
+ * the file. Its reader is a human running `cat` on a transcript whose answers
+ * look wrong: `provider` is the field that says which CLI produced them — the
+ * argv, never the environment, which carries the fzf api key.
+ */
+export type AskEvent = {
+    t: "meta";
+    runId: string;
+    startedAt: string;
+    provider: string;
+} | {
+    t: "question";
+    seq: number;
+    at: string;
+    focus: string | null;
+    text: string;
+} | {
+    t: "chunk";
+    seq: number;
+    text: string;
+} | {
+    t: "end";
+    seq: number;
+    at: string;
+} | {
+    t: "aborted";
+    seq: number;
+    at: string;
+} | {
+    t: "error";
+    seq: number;
+    at: string;
+    message: string;
+};
+/** Everything `gmux ask` knows about your sessions, before a question is asked. */
+export interface AskContext {
+    /** The sessions the picker/list had loaded. Summaries where they exist. */
+    sessions: SessionView[];
+    /** The session the user was looking at when they hit ctrl-o, if any. */
+    focusId: string | null;
+}
+/**
+ * Pluggable chat provider. Mocked in tests; never called for real by them.
+ *
+ * Deliberately the same shape of contract as `SummaryProvider`: a prompt goes
+ * in, text comes out. The difference is that the CLI behind it is invoked with
+ * permission to run `gmux grep`, so the tool loop belongs to the harness rather
+ * than to us.
+ */
+export interface AskProvider {
+    readonly name: string;
+    isAvailable(): Promise<boolean>;
+    ask(prompt: string): Promise<string>;
+}
+/** Pluggable summarizer. Mocked in tests; never called for real by them. */
+export interface SummaryProvider {
+    /** Human-readable name, recorded on the summary. */
+    readonly name: string;
+    /** True when the underlying CLI is actually installed. */
+    isAvailable(): Promise<boolean>;
+    generate(input: SummaryInput): Promise<SummaryFields>;
+}
+/** One hit from a full-text search, resolved back to its session. */
+export interface SearchHit {
+    session: SessionRecord;
+    matchCount: number;
+    /** Representative matching lines, already trimmed for display. */
+    snippets: string[];
+}
+/** Filters shared by `ls` and the picker. */
+export interface ListFilters {
+    harness?: string;
+    project?: string;
+    branch?: string;
+    /** ISO timestamp; sessions older than this are dropped. */
+    since?: string;
+    limit?: number;
+    includeSidechains?: boolean;
+    includeAutomated?: boolean;
+}

package/dist/core/types.js

@@ -0,0 +1,10 @@
+/**
+ * The shared vocabulary of gmux. Every layer speaks these types.
+ *
+ * `core` imports nothing internal — see docs/architecture.md for the layer rule.
+ */
+/** Schema version for every `--json` payload. Bump on breaking changes. */
+export const SCHEMA_VERSION = 1;
+/** Config schema version. Bump when `GmConfig` changes shape incompatibly. */
+export const CONFIG_VERSION = 1;
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,2EAA2E;AAC3E,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC;AA8MhC,8EAA8E;AAC9E,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC"}