@gigaflow/gmux 0.15.0

package/dist/services/config.js

@@ -0,0 +1,325 @@
+/**
+ * Config: the one thing gmux remembers because a human said so.
+ *
+ * Everything else in `~/.cache/gmux` is derived and disposable. This
+ * isn't, which is why it lives under the config dir instead — see core/paths.ts.
+ *
+ * Two rules run through this file:
+ *
+ * 1. **A bad config is not an error.** Unreadable, malformed, or written by a
+ *    future version — all are treated as *absent*. `gmux ls` must not die because
+ *    a JSON file got truncated; it should fall back to the behavior of someone
+ *    who never ran `gmux setup`, which is a behavior that works.
+ * 2. **The env var wins.** `GMUX_SUMMARY_CMD` sat on top before config
+ *    existed, and every script, test and CI job that sets it must keep working
+ *    without being told about a new file.
+ */
+import { mkdir, readFile, rename, writeFile } from "node:fs/promises";
+import { dirname } from "node:path";
+import { configPath } from "../core/paths.js";
+import { DEFAULT_GMUX_CONFIG } from "../core/gmux-types.js";
+import { CONFIG_VERSION } from "../core/types.js";
+import { askArgvFor, firstDetected, summaryArgvFor } from "./providers.js";
+/** The last-resort provider, unchanged from before config existed. */
+export const FALLBACK_COMMAND = ["claude", "-p"];
+/** The env var that outranks everything here. */
+export const SUMMARY_CMD_ENV = "GMUX_SUMMARY_CMD";
+/**
+ * Set on any `gmux` we spawn ourselves.
+ *
+ * THE RECURSION GUARD. `gmux ask` runs a provider that may run `gmux grep`, and
+ * `gmux grep` would otherwise fire the postAction hook and spawn a summarizer —
+ * from inside a process that a summarizer-adjacent call started. The lock would
+ * absorb most of it; this stops it being a question in the first place.
+ */
+export const CHILD_ENV = "GMUX_CHILD";
+export function isChildProcess(env = process.env) {
+    const raw = env[CHILD_ENV];
+    return raw != null && raw.trim() !== "" && raw !== "0";
+}
+/** The env a spawned provider gets: ours, plus the marker. */
+export function childEnv(env = process.env) {
+    return { ...env, [CHILD_ENV]: "1" };
+}
+export function defaultConfig() {
+    return { version: CONFIG_VERSION, provider: null, autoSummarize: false };
+}
+/** Parse a config blob. Returns null for anything we cannot trust. */
+export function parseConfig(raw) {
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed))
+        return null;
+    const object = parsed;
+    // A config from a future version may mean things we'd misread. Ignoring it is
+    // safe; guessing is not.
+    const version = object["version"];
+    if (typeof version !== "number" || version > CONFIG_VERSION)
+        return null;
+    // Every field must be present and well-typed, or the file is not one we
+    // wrote and we do not get to guess at what it meant.
+    if (typeof object["autoSummarize"] !== "boolean")
+        return null;
+    if (!("provider" in object))
+        return null;
+    /**
+     * THE DISTINCTION THIS FUNCTION EXISTS FOR.
+     *
+     * An explicit `"provider": null` is a *decision* — "make no model calls" —
+     * and must be honored. A provider that is present but malformed is
+     * *corruption*, and must make the whole config untrusted, which resolves to
+     * autodetect.
+     *
+     * Collapsing the two means a truncated write, or a hand-edited file with a
+     * typo, silently disables every model-backed feature — permanently, since the
+     * file still exists and so the wizard never runs again. The user would see
+     * summaries stop and have nothing to look at but a config that reads fine.
+     */
+    const raw_provider = object["provider"];
+    let provider = null;
+    if (raw_provider !== null) {
+        provider = parseProvider(raw_provider);
+        if (!provider)
+            return null;
+    }
+    // gmux is newer than the rest of GmConfig, so its absence — or a partial
+    // block from a version that wrote fewer fields — must not untrust the whole
+    // file. resolveGmuxConfig fills in whatever this leaves out.
+    const gmux = parseGmuxBlock(object["gmux"]);
+    return { version, provider, autoSummarize: object["autoSummarize"], ...(gmux ? { gmux } : {}) };
+}
+/**
+ * Parse the gmux block leniently: field-by-field, keeping whatever is
+ * well-typed and dropping the rest — never the whole block, and never the
+ * config it lives in. `resolveGmuxConfig` is what turns this partial result
+ * into a complete `GmuxConfig`.
+ */
+function parseGmuxBlock(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return undefined;
+    const object = value;
+    const result = {};
+    if (object["guardianPolicy"] === "off" || object["guardianPolicy"] === "notify" || object["guardianPolicy"] === "auto") {
+        result.guardianPolicy = object["guardianPolicy"];
+    }
+    if (typeof object["memoryThreshold"] === "number")
+        result.memoryThreshold = object["memoryThreshold"];
+    if (typeof object["cooldownSeconds"] === "number")
+        result.cooldownSeconds = object["cooldownSeconds"];
+    if (typeof object["tickMs"] === "number")
+        result.tickMs = object["tickMs"];
+    if (Object.keys(result).length === 0)
+        return undefined;
+    return result;
+}
+/**
+ * Fill in whatever a stored `gmux` block leaves out, from `DEFAULT_GMUX_CONFIG`.
+ *
+ * Never fails on a missing or partial block — older configs have none at all,
+ * and `parseGmuxBlock` above only ever keeps well-typed fields, so what
+ * reaches here is trustworthy as far as it goes.
+ */
+export function resolveGmuxConfig(config) {
+    const g = config?.gmux;
+    if (!g)
+        return { ...DEFAULT_GMUX_CONFIG };
+    const policy = g.guardianPolicy === "off" || g.guardianPolicy === "notify" || g.guardianPolicy === "auto"
+        ? g.guardianPolicy
+        : DEFAULT_GMUX_CONFIG.guardianPolicy;
+    return {
+        guardianPolicy: policy,
+        memoryThreshold: typeof g.memoryThreshold === "number" ? g.memoryThreshold : DEFAULT_GMUX_CONFIG.memoryThreshold,
+        cooldownSeconds: typeof g.cooldownSeconds === "number" ? g.cooldownSeconds : DEFAULT_GMUX_CONFIG.cooldownSeconds,
+        tickMs: typeof g.tickMs === "number" ? g.tickMs : DEFAULT_GMUX_CONFIG.tickMs,
+    };
+}
+/**
+ * Parse a provider. Null means malformed — NOT "no provider".
+ *
+ * The caller turns a null here into an untrusted config. A command containing
+ * anything that is not a string is rejected rather than filtered: dropping the
+ * bad part would spawn a *different* command than the one on disk, which is a
+ * worse outcome than declining to spawn anything.
+ */
+function parseProvider(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return null;
+    const object = value;
+    const id = object["id"];
+    const command = object["command"];
+    if (typeof id !== "string" || id.trim() === "")
+        return null;
+    if (!Array.isArray(command) || command.length === 0)
+        return null;
+    if (!command.every((part) => typeof part === "string"))
+        return null;
+    return { id, command: [...command] };
+}
+/** The config on disk, or null when there isn't a usable one. */
+export async function readConfig() {
+    try {
+        return parseConfig(await readFile(configPath(), "utf8"));
+    }
+    catch {
+        return null; // Absent, unreadable — same answer either way.
+    }
+}
+/**
+ * True when a config file exists, however broken.
+ *
+ * Distinct from `readConfig() !== null` on purpose: the first-run wizard keys
+ * off *existence*, so a corrupt file doesn't re-launch the wizard on every
+ * single run. It falls back to defaults quietly instead, and `gmux doctor` says so.
+ */
+export async function configExists() {
+    try {
+        await readFile(configPath(), "utf8");
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Write config through a temp file and a rename, so a kill can't truncate it. */
+export async function writeConfig(config) {
+    const path = configPath();
+    await mkdir(dirname(path), { recursive: true });
+    const temp = `${path}.${process.pid}.tmp`;
+    await writeFile(temp, `${JSON.stringify(config, null, 2)}\n`, "utf8");
+    await rename(temp, path);
+}
+/**
+ * Split a command string into argv, honoring quotes and backslash escapes.
+ *
+ * Splitting on whitespace alone was wrong in a way that fails quietly: a
+ * perfectly reasonable `llm -m "model name"` became four arguments with literal
+ * quote characters embedded — `["llm","-m","\"model","name\""]` — and gmux then
+ * spawned a command the user never typed. The wizard invites free-form input, so
+ * "don't type spaces in your arguments" is not a rule we get to have.
+ *
+ * This is not a shell. It handles the quoting a person actually uses in an
+ * answer to a prompt — single quotes, double quotes, backslash escapes — and
+ * deliberately does NOT do expansion, substitution, globbing or operators. The
+ * argv goes to `spawn` without a shell, so there is nothing for those to mean,
+ * and pretending otherwise would invite an injection surface where none exists.
+ *
+ * An unterminated quote closes at end of input rather than throwing: the user is
+ * standing at a prompt, and taking their obvious intent beats an error message
+ * about lexing.
+ */
+export function parseCommand(input) {
+    const argv = [];
+    let current = "";
+    let started = false; // Distinguishes a real empty argument ("") from no argument.
+    let quote = null;
+    for (let i = 0; i < input.length; i++) {
+        const char = input[i];
+        if (quote === null && (char === " " || char === "\t" || char === "\n")) {
+            if (started)
+                argv.push(current);
+            current = "";
+            started = false;
+            continue;
+        }
+        // Backslash escapes the next character, except inside single quotes — where
+        // a backslash is a literal backslash, as in every POSIX shell.
+        if (char === "\\" && quote !== "'" && i + 1 < input.length) {
+            current += input[++i];
+            started = true;
+            continue;
+        }
+        if (quote === null && (char === '"' || char === "'")) {
+            quote = char;
+            started = true; // `gmux ask ""` is an empty argument, not an absent one.
+            continue;
+        }
+        if (char === quote) {
+            quote = null;
+            continue;
+        }
+        current += char;
+        started = true;
+    }
+    if (started)
+        argv.push(current);
+    return argv;
+}
+/**
+ * The command to use for summaries, or null for "make no model calls".
+ *
+ * Pure, and takes `detected` rather than probing PATH itself, so the precedence
+ * rule can be tested without a machine that happens to have Claude installed.
+ *
+ * Highest wins:
+ *   1. GMUX_SUMMARY_CMD
+ *   2. config.provider.command
+ *   3. first detected provider
+ *   4. `claude -p`
+ *
+ * Rules 3 and 4 are the pre-config behavior, preserved exactly: someone with no
+ * config file sees no change at all.
+ */
+export function resolveSummaryCommand(config, env = process.env, detected = firstDetected()) {
+    const override = env[SUMMARY_CMD_ENV];
+    if (override && override.trim() !== "")
+        return parseCommand(override);
+    // Only an existing config can say "no": absent config means "not asked yet",
+    // which falls through to autodetect rather than to silence. A known provider
+    // re-derives from the catalog (summaryArgvFor), so a flag added after setup
+    // reaches it — the same self-healing resolveAskCommand already has.
+    if (config)
+        return config.provider ? summaryArgvFor(config.provider) : null;
+    if (detected)
+        return [...detected.summaryArgv];
+    return [...FALLBACK_COMMAND];
+}
+/**
+ * The command to use for `gmux ask`, or null for "make no model calls".
+ *
+ * Same precedence, but the catalog's `askArgv` is used where we recognise the
+ * provider — that's the variant permitted to run `gmux grep`.
+ */
+export function resolveAskCommand(config, env = process.env, detected = firstDetected()) {
+    const override = env[SUMMARY_CMD_ENV];
+    if (override && override.trim() !== "")
+        return parseCommand(override);
+    if (config)
+        return config.provider ? askArgvFor(config.provider) : null;
+    if (detected)
+        return [...detected.askArgv];
+    return [...FALLBACK_COMMAND];
+}
+/**
+ * Whether background summaries are allowed.
+ *
+ * `GMUX_AUTO_SUMMARIZE=0` is checked by the caller and still wins. This
+ * adds the config answer: a user who said "no" in the wizard has said it once
+ * and for good, and must not be asked again by a token spend they declined.
+ *
+ * No config means yes — the pre-config default.
+ */
+export function autoSummarizeAllowed(config) {
+    return config ? config.autoSummarize : true;
+}
+export function shouldRunSetupWizard(gate) {
+    if (gate.hasConfig)
+        return false;
+    if (!gate.isTty)
+        return false;
+    if (gate.isJson)
+        return false;
+    // `__`-prefixed commands are the hidden internals we spawn at ourselves.
+    // Neither has a human at the other end, and `__picker-rows` runs while fzf
+    // owns the terminal — a prompt there would corrupt the display.
+    if (gate.commandName.startsWith("__"))
+        return false;
+    if (gate.commandName === "setup")
+        return false;
+    return true;
+}
+//# sourceMappingURL=config.js.map

package/dist/services/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/services/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAwC,MAAM,uBAAuB,CAAC;AAClG,OAAO,EAAE,cAAc,EAAsC,MAAM,kBAAkB,CAAC;AACtF,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,cAAc,EAAqB,MAAM,gBAAgB,CAAC;AAE9F,sEAAsE;AACtE,MAAM,CAAC,MAAM,gBAAgB,GAAsB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;AAEpE,iDAAiD;AACjD,MAAM,CAAC,MAAM,eAAe,GAAG,kBAAkB,CAAC;AAElD;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,YAAY,CAAC;AAEtC,MAAM,UAAU,cAAc,CAAC,MAAyB,OAAO,CAAC,GAAG;IACjE,MAAM,GAAG,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC;IAC3B,OAAO,GAAG,IAAI,IAAI,IAAI,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,GAAG,KAAK,GAAG,CAAC;AACzD,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,QAAQ,CAAC,MAAyB,OAAO,CAAC,GAAG;IAC3D,OAAO,EAAE,GAAG,GAAG,EAAE,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC;AAC3E,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IAChF,MAAM,MAAM,GAAG,MAAiC,CAAC;IAEjD,8EAA8E;IAC9E,yBAAyB;IACzB,MAAM,OAAO,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;IAClC,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,GAAG,cAAc;QAAE,OAAO,IAAI,CAAC;IAEzE,wEAAwE;IACxE,qDAAqD;IACrD,IAAI,OAAO,MAAM,CAAC,eAAe,CAAC,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IAC9D,IAAI,CAAC,CAAC,UAAU,IAAI,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IAEzC;;;;;;;;;;;;OAYG;IACH,MAAM,YAAY,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;IACxC,IAAI,QAAQ,GAA0B,IAAI,CAAC;IAC3C,IAAI,YAAY,KAAK,IAAI,EAAE,CAAC;QAC1B,QAAQ,GAAG,aAAa,CAAC,YAAY,CAAC,CAAC;QACvC,IAAI,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAC;IAC7B,CAAC;IAED,yEAAyE;IACzE,4EAA4E;IAC5E,6DAA6D;IAC7D,MAAM,IAAI,GAAG,cAAc,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IAE5C,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,CAAC,eAAe,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;AAClG,CAAC;AAED;;;;;GAKG;AACH,SAAS,cAAc,CAAC,KAAc;IACpC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAClF,MAAM,MAAM,GAAG,KAAgC,CAAC;IAChD,MAAM,MAAM,GAAwB,EAAE,CAAC;IACvC,IAAI,MAAM,CAAC,gBAAgB,CAAC,KAAK,KAAK,IAAI,MAAM,CAAC,gBAAgB,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,gBAAgB,CAAC,KAAK,MAAM,EAAE,CAAC;QACvH,MAAM,CAAC,cAAc,GAAG,MAAM,CAAC,gBAAgB,CAAC,CAAC;IACnD,CAAC;IACD,IAAI,OAAO,MAAM,CAAC,iBAAiB,CAAC,KAAK,QAAQ;QAAE,MAAM,CAAC,eAAe,GAAG,MAAM,CAAC,iBAAiB,CAAC,CAAC;IACtG,IAAI,OAAO,MAAM,CAAC,iBAAiB,CAAC,KAAK,QAAQ;QAAE,MAAM,CAAC,eAAe,GAAG,MAAM,CAAC,iBAAiB,CAAC,CAAC;IACtG,IAAI,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,QAAQ;QAAE,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC3E,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IACvD,OAAO,MAAoB,CAAC;AAC9B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAuB;IACvD,MAAM,CAAC,GAAG,MAAM,EAAE,IAAI,CAAC;IACvB,IAAI,CAAC,CAAC;QAAE,OAAO,EAAE,GAAG,mBAAmB,EAAE,CAAC;IAC1C,MAAM,MAAM,GACV,CAAC,CAAC,cAAc,KAAK,KAAK,IAAI,CAAC,CAAC,cAAc,KAAK,QAAQ,IAAI,CAAC,CAAC,cAAc,KAAK,MAAM;QACxF,CAAC,CAAC,CAAC,CAAC,cAAc;QAClB,CAAC,CAAC,mBAAmB,CAAC,cAAc,CAAC;IACzC,OAAO;QACL,cAAc,EAAE,MAAM;QACtB,eAAe,EAAE,OAAO,CAAC,CAAC,eAAe,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,mBAAmB,CAAC,eAAe;QAChH,eAAe,EAAE,OAAO,CAAC,CAAC,eAAe,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,mBAAmB,CAAC,eAAe;QAChH,MAAM,EAAE,OAAO,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,mBAAmB,CAAC,MAAM;KAC7E,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,aAAa,CAAC,KAAc;IACnC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC7E,MAAM,MAAM,GAAG,KAAgC,CAAC;IAChD,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IACxB,MAAM,OAAO,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;IAClC,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IAC5D,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACjE,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IACpF,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,EAAE,CAAC;AACvC,CAAC;AAED,iEAAiE;AACjE,MAAM,CAAC,KAAK,UAAU,UAAU;IAC9B,IAAI,CAAC;QACH,OAAO,WAAW,CAAC,MAAM,QAAQ,CAAC,UAAU,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC;IAC3D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC,CAAC,+CAA+C;IAC9D,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY;IAChC,IAAI,CAAC;QACH,MAAM,QAAQ,CAAC,UAAU,EAAE,EAAE,MAAM,CAAC,CAAC;QACrC,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,kFAAkF;AAClF,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,MAAgB;IAChD,MAAM,IAAI,GAAG,UAAU,EAAE,CAAC;IAC1B,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAChD,MAAM,IAAI,GAAG,GAAG,IAAI,IAAI,OAAO,CAAC,GAAG,MAAM,CAAC;IAC1C,MAAM,SAAS,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACtE,MAAM,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AAC3B,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,IAAI,OAAO,GAAG,EAAE,CAAC;IACjB,IAAI,OAAO,GAAG,KAAK,CAAC,CAAC,6DAA6D;IAClF,IAAI,KAAK,GAAqB,IAAI,CAAC;IAEnC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;QAEvB,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;YACvE,IAAI,OAAO;gBAAE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAChC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,GAAG,KAAK,CAAC;YAChB,SAAS;QACX,CAAC;QAED,4EAA4E;QAC5E,+DAA+D;QAC/D,IAAI,IAAI,KAAK,IAAI,IAAI,KAAK,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;YAC3D,OAAO,IAAI,KAAK,CAAC,EAAE,CAAC,CAAE,CAAC;YACvB,OAAO,GAAG,IAAI,CAAC;YACf,SAAS;QACX,CAAC;QAED,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACrD,KAAK,GAAG,IAAI,CAAC;YACb,OAAO,GAAG,IAAI,CAAC,CAAC,yDAAyD;YACzE,SAAS;QACX,CAAC;QAED,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;YACnB,KAAK,GAAG,IAAI,CAAC;YACb,SAAS;QACX,CAAC;QAED,OAAO,IAAI,IAAI,CAAC;QAChB,OAAO,GAAG,IAAI,CAAC;IACjB,CAAC;IAED,IAAI,OAAO;QAAE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAChC,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,qBAAqB,CACnC,MAAuB,EACvB,MAAyB,OAAO,CAAC,GAAG,EACpC,WAAgC,aAAa,EAAE;IAE/C,MAAM,QAAQ,GAAG,GAAG,CAAC,eAAe,CAAC,CAAC;IACtC,IAAI,QAAQ,IAAI,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,YAAY,CAAC,QAAQ,CAAC,CAAC;IAEtE,6EAA6E;IAC7E,6EAA6E;IAC7E,4EAA4E;IAC5E,oEAAoE;IACpE,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAE5E,IAAI,QAAQ;QAAE,OAAO,CAAC,GAAG,QAAQ,CAAC,WAAW,CAAC,CAAC;IAC/C,OAAO,CAAC,GAAG,gBAAgB,CAAC,CAAC;AAC/B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAC/B,MAAuB,EACvB,MAAyB,OAAO,CAAC,GAAG,EACpC,WAAgC,aAAa,EAAE;IAE/C,MAAM,QAAQ,GAAG,GAAG,CAAC,eAAe,CAAC,CAAC;IACtC,IAAI,QAAQ,IAAI,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,YAAY,CAAC,QAAQ,CAAC,CAAC;IAEtE,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAExE,IAAI,QAAQ;QAAE,OAAO,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC3C,OAAO,CAAC,GAAG,gBAAgB,CAAC,CAAC;AAC/B,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAuB;IAC1D,OAAO,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC;AAC9C,CAAC;AAsBD,MAAM,UAAU,oBAAoB,CAAC,IAAe;IAClD,IAAI,IAAI,CAAC,SAAS;QAAE,OAAO,KAAK,CAAC;IACjC,IAAI,CAAC,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IAC9B,IAAI,IAAI,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAC9B,yEAAyE;IACzE,2EAA2E;IAC3E,gEAAgE;IAChE,IAAI,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IACpD,IAAI,IAAI,CAAC,WAAW,KAAK,OAAO;QAAE,OAAO,KAAK,CAAC;IAC/C,OAAO,IAAI,CAAC;AACd,CAAC"}

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

@@ -0,0 +1,9 @@
+import type { WorkspaceSnapshot } from "../core/gmux-types.js";
+export declare function readSnapshotFile(path?: string): Promise<{
+    snapshot: WorkspaceSnapshot;
+    ageMs: number;
+} | null>;
+export declare function subscribe(onSnapshot: (s: WorkspaceSnapshot) => void, opts?: {
+    socketPath?: string;
+    onError?: (e: Error) => void;
+}): () => void;

package/dist/services/daemon-client.js

@@ -0,0 +1,34 @@
+import { connect } from "node:net";
+import { readFile, stat } from "node:fs/promises";
+import { gmuxSnapshotPath, gmuxSocketPath } from "../core/paths.js";
+export async function readSnapshotFile(path = gmuxSnapshotPath()) {
+    try {
+        const [raw, st] = await Promise.all([readFile(path, "utf8"), stat(path)]);
+        const snapshot = JSON.parse(raw);
+        return { snapshot, ageMs: Math.max(0, Date.now() - st.mtimeMs) };
+    }
+    catch {
+        return null;
+    }
+}
+export function subscribe(onSnapshot, opts = {}) {
+    const sock = connect(opts.socketPath ?? gmuxSocketPath());
+    let buf = "";
+    sock.on("data", (d) => {
+        buf += d.toString();
+        let nl;
+        while ((nl = buf.indexOf("\n")) >= 0) {
+            const line = buf.slice(0, nl);
+            buf = buf.slice(nl + 1);
+            if (line.trim()) {
+                try {
+                    onSnapshot(JSON.parse(line));
+                }
+                catch { /* skip */ }
+            }
+        }
+    });
+    sock.on("error", (e) => opts.onError?.(e));
+    return () => sock.destroy();
+}
+//# sourceMappingURL=daemon-client.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"daemon-client.js","sourceRoot":"","sources":["../../src/services/daemon-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACnC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEpE,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,OAAe,gBAAgB,EAAE;IAEjC,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC1E,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAsB,CAAC;QACtD,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IACnE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,SAAS,CACvB,UAA0C,EAC1C,OAA8D,EAAE;IAEhE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,UAAU,IAAI,cAAc,EAAE,CAAC,CAAC;IAC1D,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE;QACpB,GAAG,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;QACpB,IAAI,EAAU,CAAC;QACf,OAAO,CAAC,EAAE,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;YACrC,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC9B,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;YACxB,IAAI,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;gBAAC,IAAI,CAAC;oBAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAsB,CAAC,CAAC;gBAAC,CAAC;gBAAC,MAAM,CAAC,CAAC,UAAU,CAAC,CAAC;YAAC,CAAC;QACtG,CAAC;IACH,CAAC,CAAC,CAAC;IACH,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3C,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;AAC9B,CAAC"}

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

@@ -0,0 +1,30 @@
+import type { WorkspaceModel } from "./workspace.js";
+export declare class ModelServer {
+    private readonly model;
+    private readonly socketPath;
+    private readonly snapshotPath;
+    private server;
+    private clients;
+    private readonly onChange;
+    /** Serializes snapshot-file writes so overlapping "change" bursts never
+     *  race on the same temp path (one write's `rename` could otherwise yank
+     *  the temp file out from under another still-in-flight write). */
+    private writeChain;
+    private writeCounter;
+    constructor(model: WorkspaceModel, socketPath?: string, snapshotPath?: string);
+    start(): Promise<void>;
+    private line;
+    private broadcast;
+    /**
+     * Serialized through `writeChain` so a burst of near-simultaneous "change"
+     * events (e.g. N `upsertIdentity` calls during an initial scan) never has
+     * two writes in flight at once — an overlapping `rename()` could otherwise
+     * yank the shared temp file out from under a sibling write (ENOENT) and
+     * crash the process via an unhandled rejection. Each call also gets its
+     * own temp filename as belt-and-suspenders. Never rejects: a failed write
+     * is swallowed rather than surfaced, so it can't become an unhandled
+     * rejection further up the chain either.
+     */
+    private writeSnapshot;
+    stop(): Promise<void>;
+}

package/dist/services/daemon-socket.js

@@ -0,0 +1,76 @@
+// src/services/daemon-socket.ts
+import { createServer } from "node:net";
+import { mkdir, rename, rm, writeFile } from "node:fs/promises";
+import { dirname } from "node:path";
+import { gmuxSnapshotPath, gmuxSocketPath } from "../core/paths.js";
+export class ModelServer {
+    model;
+    socketPath;
+    snapshotPath;
+    server;
+    clients = new Set();
+    onChange = () => { void this.broadcast().catch(() => { }); };
+    /** Serializes snapshot-file writes so overlapping "change" bursts never
+     *  race on the same temp path (one write's `rename` could otherwise yank
+     *  the temp file out from under another still-in-flight write). */
+    writeChain = Promise.resolve();
+    writeCounter = 0;
+    constructor(model, socketPath = gmuxSocketPath(), snapshotPath = gmuxSnapshotPath()) {
+        this.model = model;
+        this.socketPath = socketPath;
+        this.snapshotPath = snapshotPath;
+    }
+    async start() {
+        await mkdir(dirname(this.socketPath), { recursive: true });
+        await rm(this.socketPath, { force: true });
+        this.server = createServer((sock) => {
+            this.clients.add(sock);
+            sock.on("close", () => this.clients.delete(sock));
+            sock.on("error", () => this.clients.delete(sock));
+            sock.write(this.line()); // initial snapshot
+        });
+        await new Promise((resolve, reject) => {
+            this.server.once("error", reject);
+            this.server.listen(this.socketPath, resolve);
+        });
+        this.model.on("change", this.onChange);
+        await this.writeSnapshot(this.line());
+    }
+    line() { return JSON.stringify(this.model.snapshot()) + "\n"; }
+    async broadcast() {
+        const line = this.line();
+        // Write the snapshot file first so it never lags behind what clients see
+        // (also avoids a race where a socket read outpaces the async fs write).
+        await this.writeSnapshot(line);
+        for (const c of this.clients)
+            c.write(line);
+    }
+    /**
+     * Serialized through `writeChain` so a burst of near-simultaneous "change"
+     * events (e.g. N `upsertIdentity` calls during an initial scan) never has
+     * two writes in flight at once — an overlapping `rename()` could otherwise
+     * yank the shared temp file out from under a sibling write (ENOENT) and
+     * crash the process via an unhandled rejection. Each call also gets its
+     * own temp filename as belt-and-suspenders. Never rejects: a failed write
+     * is swallowed rather than surfaced, so it can't become an unhandled
+     * rejection further up the chain either.
+     */
+    async writeSnapshot(content) {
+        const tmp = `${this.snapshotPath}.${process.pid}.${this.writeCounter++}.tmp`;
+        this.writeChain = this.writeChain.then(async () => {
+            await mkdir(dirname(this.snapshotPath), { recursive: true });
+            await writeFile(tmp, content, "utf8");
+            await rename(tmp, this.snapshotPath);
+        }).catch(() => { });
+        await this.writeChain;
+    }
+    async stop() {
+        this.model.off("change", this.onChange);
+        for (const c of this.clients)
+            c.destroy();
+        this.clients.clear();
+        await new Promise((resolve) => (this.server ? this.server.close(() => resolve()) : resolve()));
+        await rm(this.socketPath, { force: true });
+    }
+}
+//# sourceMappingURL=daemon-socket.js.map

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

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

package/dist/services/daemon.d.ts

@@ -0,0 +1,43 @@
+/**
+ * The daemon tick loop: registry diff → attach/detach sensors → observe →
+ * classify → write state to the model → evict gone panes.
+ *
+ * No LLM here (Phase 0) — `classifyState` is a pure heuristic over the raw
+ * `Observation`. Sensors and the clock are injected so the whole loop can be
+ * driven headlessly in tests, without a real tmux server.
+ */
+import type { PaneIdentity } from "../core/gmux-types.js";
+import type { TmuxGateway } from "./tmux-gateway.js";
+import type { Guardian } from "./guardian.js";
+import type { ResourceMonitor } from "./resources.js";
+import { type Sensor } from "./sensors.js";
+import type { SemanticWorker } from "./semantic.js";
+import type { WorkspaceModel } from "./workspace.js";
+export interface DaemonDeps {
+    gateway: TmuxGateway;
+    model: WorkspaceModel;
+    now: () => number;
+    makeSensor?: (id: PaneIdentity, gw: TmuxGateway) => Sensor;
+    semantic?: SemanticWorker;
+    resources?: ResourceMonitor;
+    guardian?: Guardian;
+    /**
+     * Overrides which present panes count as "agent panes" for guardian
+     * broadcast targeting. Defaults to panes the registry has resolved to a
+     * harness + session (`harness && sessionId`). This override exists only
+     * so tests can mark panes as agents without a full link fixture — real
+     * callers should leave it unset.
+     */
+    resolveAgents?: (present: PaneIdentity[]) => string[];
+}
+export declare class Daemon {
+    private readonly deps;
+    private registry;
+    /** Long-lived per pane: created on appear, torn down on vanish. This is
+     * what lets AgentSensor's lazy transcript-file resolution pay off over
+     * the pane's whole lifetime instead of retrying from scratch each tick. */
+    private sensors;
+    private make;
+    constructor(deps: DaemonDeps);
+    tickOnce(): Promise<void>;
+}

package/dist/services/daemon.js

@@ -0,0 +1,106 @@
+/**
+ * The daemon tick loop: registry diff → attach/detach sensors → observe →
+ * classify → write state to the model → evict gone panes.
+ *
+ * No LLM here (Phase 0) — `classifyState` is a pure heuristic over the raw
+ * `Observation`. Sensors and the clock are injected so the whole loop can be
+ * driven headlessly in tests, without a real tmux server.
+ */
+import { classifyState } from "../core/pane-state.js";
+import { PaneRegistry } from "./pane-registry.js";
+import { makeSensor as defaultMakeSensor } from "./sensors.js";
+export class Daemon {
+    deps;
+    registry;
+    /** Long-lived per pane: created on appear, torn down on vanish. This is
+     * what lets AgentSensor's lazy transcript-file resolution pay off over
+     * the pane's whole lifetime instead of retrying from scratch each tick. */
+    sensors = new Map();
+    make;
+    constructor(deps) {
+        this.deps = deps;
+        this.registry = new PaneRegistry(deps.gateway);
+        this.make = deps.makeSensor ?? defaultMakeSensor;
+    }
+    async tickOnce() {
+        const now = this.deps.now();
+        let diff;
+        try {
+            diff = await this.registry.diff();
+        }
+        catch {
+            // tmux hiccup (e.g. listPanes throws): idle this tick, loop survives.
+            return;
+        }
+        const { present, vanished } = diff;
+        for (const id of vanished) {
+            await this.sensors.get(id)?.teardown().catch(() => { });
+            this.sensors.delete(id);
+            this.deps.model.markGone(id);
+        }
+        for (const id of present) {
+            this.deps.model.upsertIdentity(id);
+            let sensor = this.sensors.get(id.paneId);
+            if (!sensor) {
+                sensor = this.make(id, this.deps.gateway);
+                this.sensors.set(id.paneId, sensor);
+            }
+            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
+                }
+            }
+            catch {
+                // A single sensor failure must never abort the whole tick.
+            }
+        }
+        if (this.deps.resources) {
+            try {
+                const panePids = new Map(present.map((p) => [p.paneId, p.pid]));
+                const { perPane, host } = await this.deps.resources.sample(panePids);
+                for (const [paneId, res] of perPane)
+                    this.deps.model.applyResources(paneId, res);
+                this.deps.model.setHostPressure(host);
+                if (this.deps.guardian) {
+                    const agentIds = this.deps.resolveAgents?.(present)
+                        ?? present.filter((p) => p.harness && p.sessionId).map((p) => p.paneId);
+                    const agentIdSet = new Set(agentIds);
+                    // Guardian.decide treats a pane as an agent via identity.harness &&
+                    // 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) => {
+                        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 } };
+                    });
+                    const decision = this.deps.guardian.decide(host, panes, now);
+                    if (decision.action !== "none") {
+                        if (decision.action === "broadcast") {
+                            for (const id of agentIds) {
+                                await this.deps.gateway.send(id, decision.message + "\n").catch(() => { });
+                            }
+                        }
+                        this.deps.model.logGuardian({
+                            ts: now,
+                            pressure: host.usedRatio,
+                            culpritPaneId: decision.culpritPaneId,
+                            culpritLabel: decision.culpritLabel,
+                            action: decision.action,
+                            message: decision.message,
+                        });
+                    }
+                }
+            }
+            catch {
+                // Resource sampling / guardian failures must never abort the tick.
+            }
+        }
+        this.deps.model.evictGone();
+    }
+}
+//# sourceMappingURL=daemon.js.map