@gigaflow/gmux 0.15.0 → 0.16.0

package/dist/core/organize-types.js

@@ -0,0 +1,33 @@
+/**
+ * Pure plan representation for `gmux organize`.
+ *
+ * A plan never carries a destructive op: the tagged union below is 1:1 with
+ * the tmux gateway's relocation verbs (`newWindow`, `renameWindow`,
+ * `joinPane`, `breakPane`, `swapPane`, `selectLayout`) and nothing else. There
+ * is deliberately no `kill-pane`/`kill-window` step — see the design
+ * invariant in the organize spec: reorganization relocates panes, it never
+ * destroys their processes.
+ */
+/** tmux preset layouts we allow the planner to choose. */
+export const LAYOUTS = [
+    "tiled",
+    "even-horizontal",
+    "even-vertical",
+    "main-horizontal",
+    "main-vertical",
+];
+export function isLayoutName(v) {
+    return LAYOUTS.includes(v);
+}
+/**
+ * Pure. The plan as numbered preview lines: the summary, then one line per step
+ * (`1. <description>`). No footer and no styling — callers append their own
+ * ("run with --apply" for the command, an apply/cancel hint for the overlay).
+ * Shared so the CLI command and the ctrl-g overlay render an identical plan.
+ */
+export function organizePreviewLines(plan) {
+    const lines = [plan.summary];
+    plan.steps.forEach((step, i) => lines.push(`${i + 1}. ${step.description}`));
+    return lines;
+}
+//# sourceMappingURL=organize-types.js.map

package/dist/core/organize-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"organize-types.js","sourceRoot":"","sources":["../../src/core/organize-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,0DAA0D;AAC1D,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,OAAO;IACP,iBAAiB;IACjB,eAAe;IACf,iBAAiB;IACjB,eAAe;CACP,CAAC;AAGX,MAAM,UAAU,YAAY,CAAC,CAAS;IACpC,OAAQ,OAA6B,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;AACpD,CAAC;AAiDD;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAkB;IACrD,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC7B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;IAC7E,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/core/paths.d.ts

@@ -14,6 +14,10 @@
  *   category is named here and in AGENTS.md #1 rather than left as a habit,
  *   because a rule with an unwritten exception is a rule the next person
  *   "fixes".
+ *
+ * One deliberate exception: `workReportPath()` lives under `tmpdir()`, not
+ * either root, because it's a disposable render target overwritten on every
+ * report, not gmux state.
  */
 /** Root of gmux's config. Honors XDG_CONFIG_HOME. */
 export declare function configDir(): string;
@@ -26,6 +30,15 @@ export declare function indexPath(): string;
 /** Directory of generated summaries, one JSON file per session. */
 export declare function summaryDir(): string;
 export declare function summaryPath(harness: string, sessionId: string): string;
+/** Directory of generated work-view fragments, one JSON file per session. */
+export declare function workViewDir(): string;
+/** Cached work-view (metadata + HTML fragment) for one session. */
+export declare function workViewPath(harness: string, sessionId: string): string;
+/**
+ * The assembled work report. One stable file in the temp dir so re-pressing `v`
+ * overwrites it and the `file://` link the cockpit shows stays the same.
+ */
+export declare function workReportPath(): string;
 /**
  * The pane→session links written by `gmux run`. Cache, not config: keyed by tmux
  * pane ids that die with the server, disposable, regenerated by living in the

package/dist/core/paths.js

@@ -14,8 +14,12 @@
  *   category is named here and in AGENTS.md #1 rather than left as a habit,
  *   because a rule with an unwritten exception is a rule the next person
  *   "fixes".
+ *
+ * One deliberate exception: `workReportPath()` lives under `tmpdir()`, not
+ * either root, because it's a disposable render target overwritten on every
+ * report, not gmux state.
  */
-import { homedir } from "node:os";
+import { homedir, tmpdir } from "node:os";
 import { join } from "node:path";
 /** Root of gmux's config. Honors XDG_CONFIG_HOME. */
 export function configDir() {
@@ -44,6 +48,21 @@ export function summaryDir() {
 export function summaryPath(harness, sessionId) {
     return join(summaryDir(), `${harness}-${sessionId}.json`);
 }
+/** Directory of generated work-view fragments, one JSON file per session. */
+export function workViewDir() {
+    return join(cacheDir(), "work-views");
+}
+/** Cached work-view (metadata + HTML fragment) for one session. */
+export function workViewPath(harness, sessionId) {
+    return join(workViewDir(), `${harness}-${sessionId}.json`);
+}
+/**
+ * The assembled work report. One stable file in the temp dir so re-pressing `v`
+ * overwrites it and the `file://` link the cockpit shows stays the same.
+ */
+export function workReportPath() {
+    return join(tmpdir(), "gmux-work-report.html");
+}
 /**
  * The pane→session links written by `gmux run`. Cache, not config: keyed by tmux
  * pane ids that die with the server, disposable, regenerated by living in the

package/dist/core/paths.js.map

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

package/dist/services/ask-router.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Ask-box intent router.
+ *
+ * The ctrl-g overlay's ask box takes free text. Most of it is a *question* for
+ * the running agents (the existing broadcast). Some of it is a request to
+ * *rearrange the tmux workspace* ("group these by project", "put the shells in
+ * their own window"). `classifyIntent` decides which, using the same provider
+ * plumbing as summaries — a one-shot CLI that reads a prompt and writes text.
+ *
+ * SAFETY: this defaults to "ask" on every uncertainty. Empty prompt, no
+ * provider configured, a spawn failure, a timeout, or any reply that is not an
+ * unambiguous "ORGANIZE" all resolve to "ask", so a normal question is never
+ * misread as a reorganization. The caller then previews-and-confirms before
+ * anything touches tmux; misclassifying the other direction (a genuine reorg
+ * read as a question) merely broadcasts it, which is harmless.
+ */
+import { runProviderCommand } from "./provider-process.js";
+export type AskIntent = "organize" | "ask";
+export interface ClassifyDeps {
+    /**
+     * The provider argv. Left `undefined` it is resolved from config (same as the
+     * summarizer). Pass `null` for "no provider" and a concrete argv (e.g. a
+     * `node -e` fake) in tests. When passed, it is used as-is — no config read.
+     */
+    command?: string[] | null;
+    /** The spawn seam, injectable for tests. Defaults to the real provider run. */
+    run?: typeof runProviderCommand;
+}
+/** Pure. The one-shot classification prompt. */
+export declare function buildClassifyPrompt(prompt: string): string;
+/**
+ * Pure. Reads a raw provider reply as an intent, conservatively: only the
+ * unambiguous first word "organize" (case-insensitive, punctuation ignored)
+ * counts as ORGANIZE. Anything else — including empty, prose, or "ask" — is
+ * "ask". Mirrors the classifier's "reply with exactly one word" instruction
+ * while tolerating a trailing period or newline.
+ */
+export declare function parseIntent(raw: string): AskIntent;
+/**
+ * Decide whether an ask-box prompt is a workspace-reorganization request
+ * ("organize") or a question for the agents ("ask"). Never throws; every
+ * failure path returns "ask".
+ */
+export declare function classifyIntent(prompt: string, deps?: ClassifyDeps): Promise<AskIntent>;

package/dist/services/ask-router.js

@@ -0,0 +1,63 @@
+/**
+ * Ask-box intent router.
+ *
+ * The ctrl-g overlay's ask box takes free text. Most of it is a *question* for
+ * the running agents (the existing broadcast). Some of it is a request to
+ * *rearrange the tmux workspace* ("group these by project", "put the shells in
+ * their own window"). `classifyIntent` decides which, using the same provider
+ * plumbing as summaries — a one-shot CLI that reads a prompt and writes text.
+ *
+ * SAFETY: this defaults to "ask" on every uncertainty. Empty prompt, no
+ * provider configured, a spawn failure, a timeout, or any reply that is not an
+ * unambiguous "ORGANIZE" all resolve to "ask", so a normal question is never
+ * misread as a reorganization. The caller then previews-and-confirms before
+ * anything touches tmux; misclassifying the other direction (a genuine reorg
+ * read as a question) merely broadcasts it, which is harmless.
+ */
+import { readConfig, resolveSummaryCommand } from "./config.js";
+import { runProviderCommand } from "./provider-process.js";
+/** Kept tight: this is a single-word classification, not a summary or an answer. */
+const CLASSIFY_TIMEOUT_MS = 30_000;
+/** Pure. The one-shot classification prompt. */
+export function buildClassifyPrompt(prompt) {
+    return [
+        "Classify the user's message. Reply with exactly one word and nothing else:",
+        "ORGANIZE if it asks to rearrange/reorganize the tmux workspace layout (windows, panes, tiling, grouping, moving panes),",
+        "or ASK if it is a question or instruction for the running agents.",
+        "",
+        `Message: ${prompt}`,
+    ].join("\n");
+}
+/**
+ * Pure. Reads a raw provider reply as an intent, conservatively: only the
+ * unambiguous first word "organize" (case-insensitive, punctuation ignored)
+ * counts as ORGANIZE. Anything else — including empty, prose, or "ask" — is
+ * "ask". Mirrors the classifier's "reply with exactly one word" instruction
+ * while tolerating a trailing period or newline.
+ */
+export function parseIntent(raw) {
+    const first = raw.toLowerCase().match(/[a-z]+/);
+    return first && first[0] === "organize" ? "organize" : "ask";
+}
+/**
+ * Decide whether an ask-box prompt is a workspace-reorganization request
+ * ("organize") or a question for the agents ("ask"). Never throws; every
+ * failure path returns "ask".
+ */
+export async function classifyIntent(prompt, deps = {}) {
+    const trimmed = prompt.trim();
+    if (trimmed === "")
+        return "ask"; // Nothing to classify — and never spawn for it.
+    const argv = deps.command !== undefined ? deps.command : resolveSummaryCommand(await readConfig());
+    if (!argv || argv.length === 0)
+        return "ask"; // No provider is a "no", not an error.
+    try {
+        const run = deps.run ?? runProviderCommand;
+        const raw = await run(argv, buildClassifyPrompt(trimmed), { timeoutMs: CLASSIFY_TIMEOUT_MS });
+        return parseIntent(raw);
+    }
+    catch {
+        return "ask"; // Timeout, nonzero exit, spawn failure — default to the safe path.
+    }
+}
+//# sourceMappingURL=ask-router.js.map

package/dist/services/ask-router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ask-router.js","sourceRoot":"","sources":["../../src/services/ask-router.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,UAAU,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAI3D,oFAAoF;AACpF,MAAM,mBAAmB,GAAG,MAAM,CAAC;AAanC,gDAAgD;AAChD,MAAM,UAAU,mBAAmB,CAAC,MAAc;IAChD,OAAO;QACL,4EAA4E;QAC5E,yHAAyH;QACzH,mEAAmE;QACnE,EAAE;QACF,YAAY,MAAM,EAAE;KACrB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,MAAM,KAAK,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAChD,OAAO,KAAK,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC;AAC/D,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,MAAc,EAAE,OAAqB,EAAE;IAC1E,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;IAC9B,IAAI,OAAO,KAAK,EAAE;QAAE,OAAO,KAAK,CAAC,CAAC,gDAAgD;IAElF,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,qBAAqB,CAAC,MAAM,UAAU,EAAE,CAAC,CAAC;IACnG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,CAAC,uCAAuC;IAErF,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,kBAAkB,CAAC;QAC3C,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,mBAAmB,CAAC,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,mBAAmB,EAAE,CAAC,CAAC;QAC9F,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC,CAAC,mEAAmE;IACnF,CAAC;AACH,CAAC"}

package/dist/services/daemon-lock.d.ts

@@ -0,0 +1,31 @@
+/**
+ * The `gmux daemon run` PID lockfile — extracted to its own leaf module (no
+ * dependents within `cli/`) so `cli/tmux-label.ts` can detect a live daemon
+ * without importing `cli/commands/daemon.ts` (which itself imports
+ * `cli/tmux-label.ts` for `enableBorder`, and a cycle between the two is
+ * fragile to depend on even where it happens to work).
+ *
+ * Same shape (`{ pid, startedAt }`) and staleness rule as
+ * `services/auto-summarize.ts`'s lock: owner dead, or too old. It lives under
+ * `gmuxDir()` rather than `cacheDir()` directly because it is gmux-specific
+ * ephemeral state, not shared with the rest of gmux.
+ */
+/** A lock older than this belongs to a process that died without cleaning up. */
+export declare const DAEMON_LOCK_STALE_MS: number;
+export interface DaemonLock {
+    pid: number;
+    startedAt: string;
+}
+export declare function daemonLockPath(): string;
+/** A lock is stale when its owner is gone, or when it is simply too old. */
+export declare function isDaemonLockStale(lock: DaemonLock, now?: Date, staleMs?: number): boolean;
+/** Corrupt or missing lock reads as "not running" — never throws. */
+export declare function readDaemonLock(): Promise<DaemonLock | null>;
+export declare function releaseDaemonLock(): Promise<void>;
+/**
+ * Take the lock for this process, refusing if a live one already exists.
+ *
+ * Returns false — never throws — when another daemon is already running, so
+ * callers can print a clear message and exit rather than crash.
+ */
+export declare function acquireDaemonLock(now?: Date): Promise<boolean>;

package/dist/services/daemon-lock.js

@@ -0,0 +1,77 @@
+/**
+ * The `gmux daemon run` PID lockfile — extracted to its own leaf module (no
+ * dependents within `cli/`) so `cli/tmux-label.ts` can detect a live daemon
+ * without importing `cli/commands/daemon.ts` (which itself imports
+ * `cli/tmux-label.ts` for `enableBorder`, and a cycle between the two is
+ * fragile to depend on even where it happens to work).
+ *
+ * Same shape (`{ pid, startedAt }`) and staleness rule as
+ * `services/auto-summarize.ts`'s lock: owner dead, or too old. It lives under
+ * `gmuxDir()` rather than `cacheDir()` directly because it is gmux-specific
+ * ephemeral state, not shared with the rest of gmux.
+ */
+import { mkdir, readFile, rm, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { gmuxDir } from "../core/paths.js";
+/** A lock older than this belongs to a process that died without cleaning up. */
+export const DAEMON_LOCK_STALE_MS = 10 * 60_000;
+export function daemonLockPath() {
+    return join(gmuxDir(), "daemon.lock");
+}
+function processAlive(pid) {
+    if (pid <= 0)
+        return false;
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (error) {
+        // EPERM means the process exists but belongs to someone else — still alive.
+        return error.code === "EPERM";
+    }
+}
+/** A lock is stale when its owner is gone, or when it is simply too old. */
+export function isDaemonLockStale(lock, now = new Date(), staleMs = DAEMON_LOCK_STALE_MS) {
+    const started = Date.parse(lock.startedAt);
+    if (Number.isNaN(started))
+        return true;
+    if (now.getTime() - started > staleMs)
+        return true;
+    return !processAlive(lock.pid);
+}
+/** Corrupt or missing lock reads as "not running" — never throws. */
+export async function readDaemonLock() {
+    try {
+        const parsed = JSON.parse(await readFile(daemonLockPath(), "utf8"));
+        if (typeof parsed?.startedAt !== "string")
+            return null;
+        const pid = Number(parsed.pid);
+        if (!Number.isFinite(pid))
+            return null;
+        return { pid, startedAt: parsed.startedAt };
+    }
+    catch {
+        return null;
+    }
+}
+async function writeDaemonLock(lock) {
+    await mkdir(gmuxDir(), { recursive: true });
+    await writeFile(daemonLockPath(), JSON.stringify(lock), "utf8");
+}
+export async function releaseDaemonLock() {
+    await rm(daemonLockPath(), { force: true });
+}
+/**
+ * Take the lock for this process, refusing if a live one already exists.
+ *
+ * Returns false — never throws — when another daemon is already running, so
+ * callers can print a clear message and exit rather than crash.
+ */
+export async function acquireDaemonLock(now = new Date()) {
+    const existing = await readDaemonLock();
+    if (existing && !isDaemonLockStale(existing, now))
+        return false;
+    await writeDaemonLock({ pid: process.pid, startedAt: now.toISOString() });
+    return true;
+}
+//# sourceMappingURL=daemon-lock.js.map

package/dist/services/daemon-lock.js.map

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

package/dist/services/daemon.js

@@ -38,6 +38,11 @@ export class Daemon {
             this.sensors.delete(id);
             this.deps.model.markGone(id);
         }
+        // Collected here, enqueued after the loop against a single snapshot below
+        // — looking each pane's just-applied entry up via `model.snapshot()`
+        // *inside* this loop would take an O(n)-sized snapshot on every one of
+        // its n iterations.
+        const toEnqueue = [];
         for (const id of present) {
             this.deps.model.upsertIdentity(id);
             let sensor = this.sensors.get(id.paneId);
@@ -48,16 +53,26 @@ export class Daemon {
             try {
                 const obs = await sensor.observe(now);
                 this.deps.model.applyState(id.paneId, classifyState(obs, now), obs.lastActivityTs, now);
-                if (this.deps.semantic) {
-                    const entry = this.deps.model.snapshot().panes.find((p) => p.identity.paneId === id.paneId);
-                    if (entry)
-                        this.deps.semantic.enqueue(entry, obs, now); // fire-and-forget, never awaited
-                }
+                if (this.deps.semantic)
+                    toEnqueue.push({ paneId: id.paneId, obs });
             }
             catch {
                 // A single sensor failure must never abort the whole tick.
             }
         }
+        // Enqueue any collected observations against a snapshot taken exactly
+        // once per tick, shared with the guardian's pane list below (when
+        // resources are sampled this tick) instead of each taking its own O(n)
+        // snapshot.
+        const enqueueSemantic = (byId) => {
+            if (!this.deps.semantic)
+                return;
+            for (const { paneId, obs } of toEnqueue) {
+                const entry = byId.get(paneId);
+                if (entry)
+                    this.deps.semantic.enqueue(entry, obs, now); // fire-and-forget, never awaited
+            }
+        };
         if (this.deps.resources) {
             try {
                 const panePids = new Map(present.map((p) => [p.paneId, p.pid]));
@@ -65,6 +80,13 @@ export class Daemon {
                 for (const [paneId, res] of perPane)
                     this.deps.model.applyResources(paneId, res);
                 this.deps.model.setHostPressure(host);
+                // The one `model.snapshot()` call for this tick — taken after
+                // resources are applied so it (and the guardian below) sees this
+                // tick's resource data, and reused via `byId` for the semantic
+                // enqueue above instead of a second full pass.
+                const snap = this.deps.model.snapshot();
+                const byId = new Map(snap.panes.map((p) => [p.identity.paneId, p]));
+                enqueueSemantic(byId);
                 if (this.deps.guardian) {
                     const agentIds = this.deps.resolveAgents?.(present)
                         ?? present.filter((p) => p.harness && p.sessionId).map((p) => p.paneId);
@@ -73,7 +95,7 @@ export class Daemon {
                     // identity.sessionId. `resolveAgents` is a test-only override, so
                     // when it's set, patch those fields (decision purposes only, never
                     // persisted to the model) so the guardian agrees with the override.
-                    const panes = this.deps.model.snapshot().panes.map((p) => {
+                    const panes = snap.panes.map((p) => {
                         if (!this.deps.resolveAgents || !agentIdSet.has(p.identity.paneId) || p.identity.harness)
                             return p;
                         return { ...p, identity: { ...p.identity, harness: "test-agent", sessionId: p.identity.paneId } };
@@ -100,6 +122,13 @@ export class Daemon {
                 // Resource sampling / guardian failures must never abort the tick.
             }
         }
+        else if (this.deps.semantic) {
+            // No resource sampling this tick, so take the single snapshot here
+            // instead — same timing as before this change, minus the redundant
+            // per-pane snapshots.
+            const snap = this.deps.model.snapshot();
+            enqueueSemantic(new Map(snap.panes.map((p) => [p.identity.paneId, p])));
+        }
         this.deps.model.evictGone();
     }
 }

package/dist/services/daemon.js.map

@@ -1 +1 @@
-{"version":3,"file":"daemon.js","sourceRoot":"","sources":["../../src/services/daemon.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEtD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlD,OAAO,EAAE,UAAU,IAAI,iBAAiB,EAAe,MAAM,cAAc,CAAC;AAsB5E,MAAM,OAAO,MAAM;IAQY;IAPrB,QAAQ,CAAe;IAC/B;;+EAE2E;IACnE,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;IACpC,IAAI,CAAgD;IAE5D,YAA6B,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;QAC3C,IAAI,CAAC,QAAQ,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC/C,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,UAAU,IAAI,iBAAiB,CAAC;IACnD,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;QAC5B,IAAI,IAAI,CAAC;QACT,IAAI,CAAC;YACH,IAAI,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QACpC,CAAC;QAAC,MAAM,CAAC;YACP,sEAAsE;YACtE,OAAO;QACT,CAAC;QACD,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;QAEnC,KAAK,MAAM,EAAE,IAAI,QAAQ,EAAE,CAAC;YAC1B,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YACvD,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACxB,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QAC/B,CAAC;QAED,KAAK,MAAM,EAAE,IAAI,OAAO,EAAE,CAAC;YACzB,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC;YACnC,IAAI,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;YACzC,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBAC1C,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YACtC,CAAC;YACD,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;gBACtC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,GAAG,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC;gBACxF,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;oBACvB,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,KAAK,EAAE,CAAC,MAAM,CAAC,CAAC;oBAC5F,IAAI,KAAK;wBAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,iCAAiC;gBAC3F,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,2DAA2D;YAC7D,CAAC;QACH,CAAC;QAED,IAAI,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACxB,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;gBAChE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;gBACrE,KAAK,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,OAAO;oBAAE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;gBACjF,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;gBAEtC,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;oBACvB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC,OAAO,CAAC;2BAC9C,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;oBAC1E,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC;oBACrC,oEAAoE;oBACpE,kEAAkE;oBAClE,mEAAmE;oBACnE,oEAAoE;oBACpE,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;wBACvD,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,OAAO;4BAAE,OAAO,CAAC,CAAC;wBACnG,OAAO,EAAE,GAAG,CAAC,EAAE,QAAQ,EAAE,EAAE,GAAG,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,CAAC,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;oBACpG,CAAC,CAAC,CAAC;oBACH,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;oBAC7D,IAAI,QAAQ,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;wBAC/B,IAAI,QAAQ,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;4BACpC,KAAK,MAAM,EAAE,IAAI,QAAQ,EAAE,CAAC;gCAC1B,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,QAAQ,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;4BAC5E,CAAC;wBACH,CAAC;wBACD,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC;4BAC1B,EAAE,EAAE,GAAG;4BACP,QAAQ,EAAE,IAAI,CAAC,SAAS;4BACxB,aAAa,EAAE,QAAQ,CAAC,aAAa;4BACrC,YAAY,EAAE,QAAQ,CAAC,YAAY;4BACnC,MAAM,EAAE,QAAQ,CAAC,MAAM;4BACvB,OAAO,EAAE,QAAQ,CAAC,OAAO;yBAC1B,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,mEAAmE;YACrE,CAAC;QACH,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;IAC9B,CAAC;CACF"}
+{"version":3,"file":"daemon.js","sourceRoot":"","sources":["../../src/services/daemon.ts"],"names":[],"mappings":"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"}

package/dist/services/guardian.js

@@ -1,4 +1,5 @@
 import { basename } from "node:path";
+import { formatBytes } from "../core/bytes.js";
 /**
  * Pure policy state machine: pressure + policy + clock in, a decision out.
  * The ONE component that acts (types into agents via the caller), so it
@@ -63,9 +64,8 @@ function topConsumer(panes, host) {
         return { culprit: null, label: "a source outside tracked panes" };
     }
     const name = best.identity.cwd ? basename(best.identity.cwd) : best.identity.command;
-    // Binary units (matches the cockpit's formatBytes) so the same pane shows
-    // the same GB figure in both the cockpit memory column and this message.
-    const gb = (bestRss / 1024 ** 3).toFixed(1);
-    return { culprit: best.identity.paneId, label: `window \`${name}\` (${gb} GB)` };
+    // Shared with the cockpit's memory column so the same pane shows the same
+    // figure in both places.
+    return { culprit: best.identity.paneId, label: `window \`${name}\` (${formatBytes(bestRss)})` };
 }
 //# sourceMappingURL=guardian.js.map

package/dist/services/guardian.js.map

@@ -1 +1 @@
-{"version":3,"file":"guardian.js","sourceRoot":"","sources":["../../src/services/guardian.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"guardian.js","sourceRoot":"","sources":["../../src/services/guardian.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAU/C;;;;;GAKG;AACH,MAAM,OAAO,QAAQ;IAIU;IAHrB,OAAO,GAAkB,IAAI,CAAC;IAC9B,cAAc,GAAG,KAAK,CAAC;IAE/B,YAA6B,IAA4E;QAA5E,SAAI,GAAJ,IAAI,CAAwE;IAAG,CAAC;IAE7G,MAAM,CAAC,IAAkB,EAAE,KAAkB,EAAE,GAAW;QACxD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC;QACnD,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,IAAI,IAAI,CAAC,OAAO,KAAK,IAAI;gBAAE,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;YACtD,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC;QACrB,CAAC;QAED,2EAA2E;QAC3E,oEAAoE;QACpE,IAAI,IAAI,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;YAC1B,MAAM,OAAO,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;YAC5C,MAAM,SAAS,GAAG,IAAI,CAAC,cAAc,IAAI,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC;YAC9E,IAAI,CAAC,SAAS;gBAAE,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC;QACrC,CAAC;QAED,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACpD,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QAC/E,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,GAAG,GAAG,CAAC,CAAC;QAC7C,MAAM,OAAO,GAAG,eAAe,GAAG,qBAAqB,KAAK,uDAAuD,CAAC;QAEpH,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;YAC/B,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,aAAa,EAAE,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;QACtF,CAAC;QACD,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;YAClC,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;QAC3D,CAAC;QACD,oBAAoB;QACpB,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,aAAa,EAAE,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;QACtF,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;IAC9D,CAAC;IAEO,IAAI,CACV,MAA8B,EAC9B,OAAsB,EACtB,KAAa,EACb,OAAe,EACf,GAAW;QAEX,IAAI,CAAC,OAAO,GAAG,GAAG,CAAC;QACnB,IAAI,CAAC,cAAc,GAAG,KAAK,CAAC;QAC5B,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;IAC1E,CAAC;IAEO,IAAI;QACV,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IAChF,CAAC;CACF;AAED,SAAS,WAAW,CAAC,KAAkB,EAAE,IAAkB;IACzD,IAAI,IAAI,GAAqB,IAAI,CAAC;IAClC,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,SAAS,CAAC,UAAU,GAAG,IAAI,CAAC,SAAU,CAAC,UAAU,CAAC;YAAE,IAAI,GAAG,CAAC,CAAC;IAC9F,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,EAAE,SAAS,EAAE,UAAU,IAAI,CAAC,CAAC;IACjD,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,YAAY,GAAG,OAAO,EAAE,CAAC;QACzC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,gCAAgC,EAAE,CAAC;IACpE,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;IACrF,0EAA0E;IAC1E,yBAAyB;IACzB,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,KAAK,EAAE,YAAY,IAAI,OAAO,WAAW,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;AAClG,CAAC"}

package/dist/services/organize.d.ts

@@ -0,0 +1,91 @@
+/**
+ * `gmux organize`: turns the live pane set into an `OrganizePlan` (grouping
+ * work by project into windows) and, on request, executes that plan against
+ * the tmux gateway.
+ *
+ * Two planners share the `OrganizePlanner` interface:
+ *   - `HeuristicOrganizePlanner` — deterministic, no model call, no I/O. The
+ *     graceful floor: `gmux organize` with no intent and no provider always
+ *     has something sensible to do.
+ *   - `LlmOrganizePlanner` — reuses the same provider-CLI plumbing as session
+ *     summaries (`resolveSummaryCommand` + `runProviderCommand`) to turn a
+ *     natural-language intent into a plan, and NEVER throws: any missing
+ *     provider, timeout, or malformed reply falls back to the heuristic.
+ *
+ * `applyPlan` is the only place in this file that touches the gateway. It
+ * validates every step against the live pane/window set (plus handles bound
+ * by earlier steps in the same run) and skips — never throws for — a step
+ * that no longer makes sense, so one stale reference can't abort the rest of
+ * the plan.
+ *
+ * DESTRUCTION GUARANTEE: `applyPlan` only ever calls
+ * `newWindow`/`renameWindow`/`joinPane`/`breakPane`/`swapPane`/`selectLayout`
+ * on the gateway. None of those kills a process. A pane moved out of a window
+ * that tmux then closes (now empty) has already left *with* its process.
+ * There is no code path from a plan to `kill-pane`/`kill-window` — those
+ * verbs do not appear anywhere below, and `OrganizeStep` has no op that maps
+ * to one.
+ */
+import { type OrganizePane, type OrganizePlan, type OrganizePlanner, type OrganizeStep } from "../core/organize-types.js";
+import type { TmuxGateway } from "./tmux-gateway.js";
+export type { OrganizePlanner } from "../core/organize-types.js";
+/**
+ * Deterministic, pure, no-I/O planner. Groups agent panes by project
+ * (`basename(cwd)`) into one window each, and idle shells into a shared
+ * "shells" window. Ignores `intent` — it has no natural-language input to
+ * interpret, which is exactly why it is the safe default and the fallback
+ * for `LlmOrganizePlanner`.
+ */
+export declare class HeuristicOrganizePlanner implements OrganizePlanner {
+    plan(panes: OrganizePane[], _intent?: string): Promise<OrganizePlan>;
+}
+/** Pure. The prompt an LLM planner is asked to reply to. */
+export declare function buildOrganizePrompt(panes: OrganizePane[], intent: string): string;
+/**
+ * Pure. Turns a raw model reply into a validated `OrganizePlan`, dropping —
+ * never throwing on — any step that is malformed, references an unknown
+ * pane, or references a window handle not bound by an earlier step in the
+ * same reply. Mirrors `parseSummaryFields`/`parseLabelFields`: take the
+ * outermost `{`…`}` rather than trusting the whole reply to parse, because
+ * models fence or preface their JSON more often than they should.
+ */
+export declare function parseOrganizePlan(raw: string, panes: OrganizePane[]): OrganizePlan;
+/**
+ * LLM-backed planner. Reuses the exact provider infra the semantic labeler
+ * uses (`resolveSummaryCommand` + `runProviderCommand`). Never throws to the
+ * caller: no provider configured, no intent given, a timeout, a malformed
+ * reply, or a reply that parses to zero usable steps all fall back to
+ * `fallback` (a fresh `HeuristicOrganizePlanner` by default).
+ *
+ * `argv`, when passed to the constructor, is used as-is (mainly for tests, to
+ * avoid touching real config/PATH); when omitted, it is resolved fresh from
+ * config on every `plan()` call, same as the labeler does.
+ */
+export declare class LlmOrganizePlanner implements OrganizePlanner {
+    private readonly fallback;
+    private readonly argv?;
+    constructor(fallback?: OrganizePlanner, argv?: string[] | null | undefined);
+    plan(panes: OrganizePane[], intent?: string): Promise<OrganizePlan>;
+}
+export interface ApplyResult {
+    applied: OrganizeStep[];
+    skipped: Array<{
+        step: OrganizeStep;
+        reason: string;
+    }>;
+}
+/**
+ * Execute a plan against `gateway`, one step at a time, in order.
+ *
+ * Every step is validated against the live pane/window set (snapshotted once,
+ * up front) plus any window handle a prior step in THIS run has bound —
+ * never against a fresh `listPanes()` call, so the validation set is stable
+ * for the whole run. A step that fails validation, or whose gateway call
+ * throws (a tmux race, "can't break the only pane in a window", …), is
+ * pushed to `skipped` with a reason and execution continues — one bad step
+ * never aborts the rest of the plan.
+ *
+ * Only `newWindow`/`renameWindow`/`joinPane`/`breakPane`/`swapPane`/
+ * `selectLayout` are ever called here. None of those kills a process.
+ */
+export declare function applyPlan(plan: OrganizePlan, gateway: TmuxGateway): Promise<ApplyResult>;