charness 3.6.1 → 3.8.0

package/dist/cli/tscWatchGuard.js

@@ -0,0 +1,295 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tscFreshCompileTimeoutMs = exports.tscWatchRestartWindowMs = exports.tscWatchRestartBudget = exports.tscWatchStaleGraceMs = exports.tscWatchCheckIntervalMs = void 0;
+exports.readWatcherStatus = readWatcherStatus;
+exports.getOutputPath = getOutputPath;
+exports.listStaleSources = listStaleSources;
+exports.runFreshTscCompile = runFreshTscCompile;
+exports.createTscWatchGuard = createTscWatchGuard;
+exports.readTscWatchGuardTimings = readTscWatchGuardTimings;
+const child_process_1 = require("child_process");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const emittedSource_1 = require("../selfUpdate/emittedSource");
+/**
+ * @description The hot supervisor's check that its `tsc -w` is not blind. TypeScript's watch mode learns that a source
+ * changed ONLY from file-system events, and Node reads them through one inotify queue (16384 events by default): a burst —
+ * a pull of dozens of commits followed by `yarn install` while the compiler is busy — overflows it and the events are
+ * dropped without a word. The watcher then keeps the old text of the files it missed: it reports errors where an old
+ * definition meets new callers, or reports a clean build that emitted nothing, `touch tsconfig.json` re-reads none of the
+ * files (measured), and only a new `tsc -w` is right again — while the worker keeps running the old build and nobody is told.
+ *
+ * The guard compares what the watcher says with what is on disk: a compiled source NEWER than its output, a minute after the
+ * change, while the watcher is idle. With "0 errors" that is a missed change and the watcher is restarted. With errors it
+ * may just be a broken edit, so a one-shot compile of the same tree decides: clean there means the watcher is wrong. Pure
+ * decisions and the file scan live here; the supervisor (`hot.ts`) wires the process side and loads nothing else for it.
+ */
+/** How often the supervisor compares the watcher with the tree (production). */
+exports.tscWatchCheckIntervalMs = 30 * 1000;
+/** How long a source may stay newer than its output before the watcher is blamed (production): far above a compile's debounce. */
+exports.tscWatchStaleGraceMs = 60 * 1000;
+/** The watcher restarts at most this many times within {@link tscWatchRestartWindowMs}: a tree the guard cannot cure is reported, not looped on. */
+exports.tscWatchRestartBudget = 3;
+exports.tscWatchRestartWindowMs = 60 * 60 * 1000;
+/** A one-shot compile that runs longer is given up on (production tree: about 30 s). */
+exports.tscFreshCompileTimeoutMs = 5 * 60 * 1000;
+/** The test-only timing seam's variable (`testTimingsEnvName` in `testTimings.ts`, which this module must not import — see {@link readTscWatchGuardTimings}). */
+const testTimingsVariableName = 'CHARNESS_TEST_TIMINGS';
+const sourceDirectoryName = 'src';
+const outputDirectoryName = 'dist';
+const sourceExtension = '.ts';
+const outputExtension = '.js';
+const maxExamplesInReason = 3;
+/** The tail of tsc's output kept between chunks so a marker split across two reads is still found. */
+const outputTailLength = 200;
+const compilingMarker = /Starting compilation in watch mode|File change detected\. Starting incremental compilation/g;
+const idleMarker = /Found (\d+) errors?\. Watching for file changes\./g;
+/**
+ * @description The watcher's status after a chunk of its output: the LAST marker in `text` wins (a chunk may hold a whole
+ * rebuild), none leaves `previous`.
+ */
+function readWatcherStatus(text, previous) {
+    let status = previous;
+    let statusIndex = -1;
+    for (const match of text.matchAll(compilingMarker)) {
+        if (match.index >= statusIndex) {
+            status = { kind: 'compiling' };
+            statusIndex = match.index;
+        }
+    }
+    for (const match of text.matchAll(idleMarker)) {
+        if (match.index >= statusIndex) {
+            status = { kind: 'idle', errorCount: Number(match[1]) };
+            statusIndex = match.index;
+        }
+    }
+    return status;
+}
+const defaultStaleScanFs = {
+    readDirectory: (directory) => fs.readdirSync(directory, { withFileTypes: true }),
+    getModifiedMs: (filePath) => {
+        try {
+            return fs.statSync(filePath).mtimeMs;
+        }
+        catch {
+            return null;
+        }
+    },
+};
+/** `src/cli/hot.ts` → `dist/cli/hot.js` (the tsconfig's `rootDir` / `outDir`). */
+function getOutputPath(sourcePath) {
+    const withoutRoot = sourcePath.slice(`${sourceDirectoryName}/`.length, -sourceExtension.length);
+    return `${outputDirectoryName}/${withoutRoot}${outputExtension}`;
+}
+/**
+ * @description The compiled sources under `projectRoot/src` whose output is older than they are (or missing) and which changed
+ * more than `graceMs` before `nowMs` — the ones a watcher that is up to date has long since emitted. A file the compiler skips
+ * (tests, the release tooling, declarations) is never listed.
+ */
+function listStaleSources(projectRoot, nowMs, graceMs, scanFs = defaultStaleScanFs) {
+    const stale = [];
+    const visit = (relativeDirectory) => {
+        for (const entry of scanFs.readDirectory(path.join(projectRoot, relativeDirectory))) {
+            const relativePath = `${relativeDirectory}/${entry.name}`;
+            if (entry.isDirectory()) {
+                visit(relativePath);
+                continue;
+            }
+            if (!(0, emittedSource_1.checkIsEmittedSource)(relativePath))
+                continue;
+            const sourceMtimeMs = scanFs.getModifiedMs(path.join(projectRoot, relativePath));
+            if (sourceMtimeMs === null || nowMs - sourceMtimeMs < graceMs)
+                continue;
+            const outputMtimeMs = scanFs.getModifiedMs(path.join(projectRoot, getOutputPath(relativePath)));
+            if (outputMtimeMs === null || outputMtimeMs < sourceMtimeMs)
+                stale.push({ sourcePath: relativePath, sourceMtimeMs, outputMtimeMs });
+        }
+    };
+    visit(sourceDirectoryName);
+    return stale;
+}
+/**
+ * @description Compile the project once with a fresh TypeScript program and write nothing (`tsc --noEmit`): `true` when it is
+ * clean. The guard's referee when the watcher reports errors — a watcher that missed file events is wrong, a fresh program
+ * reads every file again. A compile that fails to run or outlives `timeoutMs` is "not clean": the watcher is left as it is.
+ */
+function runFreshTscCompile(projectRoot, tscBin, timeoutMs = exports.tscFreshCompileTimeoutMs) {
+    return new Promise((resolve) => {
+        const compile = (0, child_process_1.spawn)(process.execPath, [tscBin, '--noEmit'], { cwd: projectRoot, stdio: 'ignore' });
+        const timeout = setTimeout(() => compile.kill('SIGKILL'), timeoutMs);
+        compile.on('error', () => {
+            clearTimeout(timeout);
+            resolve(false);
+        });
+        compile.on('exit', (code) => {
+            clearTimeout(timeout);
+            resolve(code === 0);
+        });
+    });
+}
+function formatStaleReason(stale) {
+    const examples = stale.slice(0, maxExamplesInReason).map((source) => source.sourcePath).join(', ');
+    return `${stale.length} compiled source(s) newer than their output (${examples}${stale.length > maxExamplesInReason ? ', …' : ''})`;
+}
+function createTscWatchGuard(ports, options) {
+    let status = { kind: 'unknown' };
+    let outputTail = '';
+    let timer = null;
+    let isChecking = false;
+    /** The stale set a fresh compile already found genuinely broken: not compiled again until it changes. */
+    let confirmedBrokenSignature = null;
+    let restartTimesMs = [];
+    let isBudgetReported = false;
+    /** The stale set the last restart was for, and a stale set a restart did not cure (the watcher cannot emit it): not restarted for again. */
+    let restartedForSignature = null;
+    let uncuredSignature = null;
+    /** Restart the watcher unless the hour's budget is spent; whether it did. */
+    const restartWatcher = (reason) => {
+        const nowMs = ports.getNowMs();
+        restartTimesMs = restartTimesMs.filter((restartMs) => nowMs - restartMs < exports.tscWatchRestartWindowMs);
+        if (restartTimesMs.length >= exports.tscWatchRestartBudget) {
+            if (!isBudgetReported) {
+                isBudgetReported = true;
+                ports.log(`charness hot: the TypeScript watcher is out of step with the sources (${reason}) but was already restarted ${restartTimesMs.length} times in the last hour — leaving it as it is\n`);
+            }
+            return false;
+        }
+        restartTimesMs.push(nowMs);
+        isBudgetReported = false;
+        ports.log(`charness hot: the TypeScript watcher missed a source change (${reason}) — restarting it\n`);
+        status = { kind: 'unknown' };
+        outputTail = '';
+        confirmedBrokenSignature = null;
+        ports.restartWatcher();
+        return true;
+    };
+    const check = async () => {
+        if (isChecking || status.kind !== 'idle')
+            return;
+        isChecking = true;
+        try {
+            const stale = ports.listStaleSources(options.staleGraceMs);
+            if (stale.length === 0) {
+                confirmedBrokenSignature = null;
+                restartedForSignature = null;
+                uncuredSignature = null;
+                return;
+            }
+            const reason = formatStaleReason(stale);
+            const staleSignature = stale.map((source) => `${source.sourcePath}@${source.sourceMtimeMs}`).join(',');
+            if (staleSignature === uncuredSignature)
+                return;
+            if (staleSignature === restartedForSignature) {
+                // A fresh watcher compiled the whole tree and these sources are STILL newer than their output: it cannot emit them (a
+                // modification time in the future, a path tsconfig excludes that the stale scan does not know) — restarting again is a loop.
+                uncuredSignature = staleSignature;
+                ports.log(`charness hot: ${reason} after the TypeScript watcher was restarted for exactly these — it cannot emit them; not restarting it for this again\n`);
+                return;
+            }
+            const reportedErrors = status.errorCount;
+            if (reportedErrors === 0) {
+                if (restartWatcher(`${reason}, yet it reports 0 errors`))
+                    restartedForSignature = staleSignature;
+                return;
+            }
+            const signature = `${reportedErrors}|${staleSignature}`;
+            if (signature === confirmedBrokenSignature)
+                return;
+            const isCleanOnFreshCompile = await ports.runFreshCompile();
+            // The watcher moved on while the compile ran (an edit, a rebuild): the next tick judges the new state.
+            if (status.kind !== 'idle' || status.errorCount !== reportedErrors)
+                return;
+            if (isCleanOnFreshCompile) {
+                if (restartWatcher(`${reason}; it reports ${reportedErrors} errors, a fresh compile of the same tree finds none`))
+                    restartedForSignature = staleSignature;
+            }
+            else {
+                confirmedBrokenSignature = signature;
+            }
+        }
+        finally {
+            isChecking = false;
+        }
+    };
+    return {
+        noteOutput: (text) => {
+            const inspected = outputTail + text;
+            status = readWatcherStatus(inspected, status);
+            outputTail = inspected.slice(-outputTailLength);
+        },
+        check,
+        start: () => {
+            if (timer !== null)
+                return;
+            timer = setInterval(() => {
+                check().catch((error) => ports.log(`charness hot: the TypeScript watcher check failed: ${error instanceof Error ? error.message : error}\n`));
+            }, options.checkIntervalMs);
+            timer.unref();
+        },
+        stop: () => {
+            if (timer !== null)
+                clearInterval(timer);
+            timer = null;
+        },
+    };
+}
+/**
+ * @description The two windows the supervisor's guard runs with: production, or shortened by a flow through
+ * `CHARNESS_TEST_TIMINGS`. The supervisor does not load `testTimings.ts` (it pulls half the bot in, and every module the
+ * supervisor loads is one whose change asks it to re-execute): it reads just these two keys, and a value that is not a whole
+ * number of ms within the production window is ignored — the worker's boot is what refuses it by name.
+ */
+function readTscWatchGuardTimings(env) {
+    const productionTimings = { checkIntervalMs: exports.tscWatchCheckIntervalMs, staleGraceMs: exports.tscWatchStaleGraceMs };
+    const rawTestTimings = env[testTimingsVariableName];
+    if (rawTestTimings === undefined || rawTestTimings.trim() === '')
+        return productionTimings;
+    let overrides;
+    try {
+        overrides = JSON.parse(rawTestTimings);
+    }
+    catch {
+        return productionTimings;
+    }
+    if (overrides === null || typeof overrides !== 'object')
+        return productionTimings;
+    const pick = (overrideMs, productionMs) => overrideMs !== undefined && Number.isInteger(overrideMs) && overrideMs > 0 && overrideMs <= productionMs ? overrideMs : productionMs;
+    return {
+        checkIntervalMs: pick(overrides.tscWatchCheckIntervalMs, exports.tscWatchCheckIntervalMs),
+        staleGraceMs: pick(overrides.tscWatchStaleGraceMs, exports.tscWatchStaleGraceMs),
+    };
+}
+//# sourceMappingURL=tscWatchGuard.js.map

package/dist/cli/tscWatchGuard.js.map

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

package/dist/cli.js

@@ -42,6 +42,8 @@ const applyDnsFix_1 = require("./cli/applyDnsFix");
 const bot_1 = require("./cli/bot");
 const hot_1 = require("./cli/hot");
 (0, applyDnsFix_1.applyDnsFix)();
+/** How long a finished `runner-gate` waits for its stdout to drain before it ends the process. */
+const gateExitGraceMs = 5000;
 /**
  * @description Print the package version to stdout for `charness --version`.
  *
@@ -75,7 +77,14 @@ function printUsage() {
         `                               in-flight agent sessions are reattached)\n` +
         `  charness claude-profiles  Claude account profiles + usage from the bot's cache;\n` +
         `                              --best prints the CLAUDE_CONFIG_DIR to launch under\n` +
-        `                              (empty = default), --model <name>, --json\n` +
+        `                              (empty = default), --model <name>, --json,\n` +
+        `                              --current <name> [--stopped-by-limit] for a resumed session\n` +
+        `  charness remote-run       Run a command (tests, builds, e2e) on a runner machine (paired, or reached by ssh):\n` +
+        `                              \`remote-run [--bg] <command…>\`, \`remote-run runners\` (see docs/remote-run.md)\n` +
+        `  charness runners          Pair and manage runner machines, like /runners in Telegram:\n` +
+        `                              \`ls\`, \`pair --host <address>\`, \`remove|pause|resume <name>\`\n` +
+        `  charness-runner           The program a paired machine runs (\`run\`, \`service install\`, \`status\`);\n` +
+        `                              the line that installs it comes from /runners\n` +
         `  charness --help, -h       Show this help\n` +
         `  charness --version, -v    Print the version\n` +
         `\n` +
@@ -94,6 +103,10 @@ function printUsage() {
  * Branches on `argv[2]`:
  *   - missing          → start the Telegram bot
  *   - `hot`            → hot-reload dev mode
+ *   - `remote-run`     → run a command on a runner (`remoteRun/`)
+ *   - `runners`        → the paired runners: list, pair, remove, pause, resume (`runners/`)
+ *   - `runner-gate`    → what sshd starts for a runner's key (hidden; `runners/gate.ts`)
+ *   - `runner-proxy`   → the ProxyCommand of the ssh calls to a paired runner (hidden; `runners/runnerProxy.ts`)
  *   - `-h | --help | help` → usage
  *   - `-v | --version | version` → print the package version
  *   - anything else → usage + exit 2
@@ -131,6 +144,47 @@ async function main() {
         process.exitCode = await runClaudeProfilesCli(process.argv.slice(3));
         return;
     }
+    // Run a command on a runner (ssh + rsync + Pueue); it loads no env file and no instance state, and lazily, so the bot's own start
+    // path stays as it was.
+    if (sub === 'remote-run') {
+        const { runRemoteRunCli } = await Promise.resolve().then(() => __importStar(require('./remoteRun/remoteRunCli')));
+        process.exitCode = await runRemoteRunCli(process.argv.slice(3));
+        return;
+    }
+    // The paired runners (`/runners`' headless twin); lazy, and it loads no env file, like remote-run.
+    if (sub === 'runners') {
+        const { runRunnersCli } = await Promise.resolve().then(() => __importStar(require('./runners/runnersCli')));
+        const { createProcessIo } = await Promise.resolve().then(() => __importStar(require('./remoteRun/output')));
+        process.exitCode = await runRunnersCli(process.argv.slice(3), createProcessIo());
+        return;
+    }
+    // What sshd starts for a runner's key (hidden: only the forced command of an `authorized_keys` line names it). Its stdout is the
+    // runner's channel: nothing else may be printed on the way.
+    if (sub === 'runner-gate') {
+        const { runRunnerGate } = await Promise.resolve().then(() => __importStar(require('./runners/gate')));
+        const code = await runRunnerGate(process.argv.slice(3), process.env, {
+            stdin: process.stdin,
+            stdout: process.stdout,
+            log: (line) => { process.stderr.write(`charness-gate: ${line}\n`); },
+        });
+        process.exitCode = code;
+        // The link's stdin may still hold the loop open; give stdout a moment to drain, then leave.
+        setTimeout(() => process.exit(code), gateExitGraceMs).unref();
+        return;
+    }
+    // The ProxyCommand of the ssh calls to a paired runner (hidden): joins ssh's stdio to the gate's unix socket.
+    if (sub === 'runner-proxy') {
+        const { runRunnerProxy } = await Promise.resolve().then(() => __importStar(require('./runners/runnerProxy')));
+        const [socketPath] = process.argv.slice(3);
+        if (socketPath === undefined) {
+            process.stderr.write('Usage: charness runner-proxy <socket>\n');
+            process.exit(2);
+        }
+        const code = await runRunnerProxy(socketPath, { stdin: process.stdin, stdout: process.stdout, stderr: process.stderr });
+        process.stdin.destroy();
+        process.exitCode = code;
+        return;
+    }
     // The updater's pre-switch probe of a new install (hidden: not in --help).
     if (sub === 'self-check') {
         const { runSelfCheckCli } = await Promise.resolve().then(() => __importStar(require('./selfUpdate/selfCheck')));

package/dist/cli.js.map

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

package/dist/configDirFile.d.ts

@@ -52,9 +52,13 @@ export interface ConfigFileLoader<TConfig> {
 /** @description A loader for one config-directory file: its own cache, the shared parse and error wording. */
 export declare function createConfigFileLoader<TConfig>(options: ConfigFileLoaderOptions<TConfig>): ConfigFileLoader<TConfig>;
 /**
- * @description Write `value` as JSON to `filePath` with `fileMode`, creating missing directories, through a temp
- * file and a rename so a reader never sees half a file. The caller validates first: a caller that builds an
- * invalid file has a bug.
+ * @description Write `text` to `filePath` with `fileMode`, creating missing directories, through a temp file and a
+ * rename so a reader never sees half a file.
+ */
+export declare function writeTextFileAtomically(filePath: string, text: string, fileMode: number): void;
+/**
+ * @description Write `value` as JSON to `filePath` with `fileMode` (see {@link writeTextFileAtomically}). The caller
+ * validates first: a caller that builds an invalid file has a bug.
  */
 export declare function writeJsonFileAtomically(filePath: string, value: object, fileMode: number): void;
 /**

package/dist/configDirFile.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"configDirFile.d.ts","sourceRoot":"","sources":["../src/configDirFile.ts"],"names":[],"mappings":"AAiBA,yHAAyH;AACzH,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAEjD;AAED,yGAAyG;AACzG,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAE1D;AAeD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,EAAE,OAAO,GAAE,MAAqB,GAAG,MAAM,CAGnI;AAED,mGAAmG;AACnG,MAAM,MAAM,gBAAgB,CAAC,OAAO,IAAI;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAExG;;;;GAIG;AACH,MAAM,MAAM,cAAc,CAAC,OAAO,IAC9B;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GACtC;IAAE,MAAM,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GACjC;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAEpE,MAAM,WAAW,uBAAuB,CAAC,OAAO;IAC9C,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,WAAW,EAAE,MAAM,OAAO,CAAC;IAC3B,iHAAiH;IACjH,QAAQ,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,gBAAgB,CAAC,OAAO,CAAC,CAAC;CAC7D;AAED,MAAM,WAAW,gBAAgB,CAAC,OAAO;IACvC;;;OAGG;IACH,IAAI,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,cAAc,CAAC,OAAO,CAAC,CAAC;IACpD,6EAA6E;IAC7E,UAAU,EAAE,MAAM,IAAI,CAAC;CACxB;AAgBD,8GAA8G;AAC9G,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,EAAE,uBAAuB,CAAC,OAAO,CAAC,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAgDpH;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAU/F;AAkBD;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CASvE;AAMD;;;;;GAKG;AACH,wBAAgB,gCAAgC,CAC9C,QAAQ,EAAE,MAAM,EAChB,cAAc,GAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAuB,EAC9D,YAAY,GAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAkD,GACtF,OAAO,CAST"}
+{"version":3,"file":"configDirFile.d.ts","sourceRoot":"","sources":["../src/configDirFile.ts"],"names":[],"mappings":"AAiBA,yHAAyH;AACzH,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAEjD;AAED,yGAAyG;AACzG,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAE1D;AAeD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,EAAE,OAAO,GAAE,MAAqB,GAAG,MAAM,CAGnI;AAED,mGAAmG;AACnG,MAAM,MAAM,gBAAgB,CAAC,OAAO,IAAI;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAExG;;;;GAIG;AACH,MAAM,MAAM,cAAc,CAAC,OAAO,IAC9B;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GACtC;IAAE,MAAM,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GACjC;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAEpE,MAAM,WAAW,uBAAuB,CAAC,OAAO;IAC9C,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,WAAW,EAAE,MAAM,OAAO,CAAC;IAC3B,iHAAiH;IACjH,QAAQ,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,gBAAgB,CAAC,OAAO,CAAC,CAAC;CAC7D;AAED,MAAM,WAAW,gBAAgB,CAAC,OAAO;IACvC;;;OAGG;IACH,IAAI,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,cAAc,CAAC,OAAO,CAAC,CAAC;IACpD,6EAA6E;IAC7E,UAAU,EAAE,MAAM,IAAI,CAAC;CACxB;AAgBD,8GAA8G;AAC9G,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,EAAE,uBAAuB,CAAC,OAAO,CAAC,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAgDpH;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAU9F;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAE/F;AAkBD;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CASvE;AAMD;;;;;GAKG;AACH,wBAAgB,gCAAgC,CAC9C,QAAQ,EAAE,MAAM,EAChB,cAAc,GAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAuB,EAC9D,YAAY,GAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAkD,GACtF,OAAO,CAST"}

package/dist/configDirFile.js

@@ -37,6 +37,7 @@ exports.getErrnoCode = getErrnoCode;
 exports.getCaughtErrnoCode = getCaughtErrnoCode;
 exports.getConfigDirFilePath = getConfigDirFilePath;
 exports.createConfigFileLoader = createConfigFileLoader;
+exports.writeTextFileAtomically = writeTextFileAtomically;
 exports.writeJsonFileAtomically = writeJsonFileAtomically;
 exports.getConfigFileWriteBlock = getConfigFileWriteBlock;
 exports.checkIsConfigFileOnContainerDisk = checkIsConfigFileOnContainerDisk;
@@ -141,15 +142,14 @@ function createConfigFileLoader(options) {
     };
 }
 /**
- * @description Write `value` as JSON to `filePath` with `fileMode`, creating missing directories, through a temp
- * file and a rename so a reader never sees half a file. The caller validates first: a caller that builds an
- * invalid file has a bug.
+ * @description Write `text` to `filePath` with `fileMode`, creating missing directories, through a temp file and a
+ * rename so a reader never sees half a file.
  */
-function writeJsonFileAtomically(filePath, value, fileMode) {
+function writeTextFileAtomically(filePath, text, fileMode) {
     fs.mkdirSync(path.dirname(filePath), { recursive: true });
     const tempPath = `${filePath}.${process.pid}.tmp`;
     try {
-        fs.writeFileSync(tempPath, `${JSON.stringify(value, null, 2)}\n`, { mode: fileMode });
+        fs.writeFileSync(tempPath, text, { mode: fileMode });
         fs.renameSync(tempPath, filePath);
     }
     catch (e) {
@@ -157,6 +157,13 @@ function writeJsonFileAtomically(filePath, value, fileMode) {
         throw e;
     }
 }
+/**
+ * @description Write `value` as JSON to `filePath` with `fileMode` (see {@link writeTextFileAtomically}). The caller
+ * validates first: a caller that builds an invalid file has a bug.
+ */
+function writeJsonFileAtomically(filePath, value, fileMode) {
+    writeTextFileAtomically(filePath, `${JSON.stringify(value, null, 2)}\n`, fileMode);
+}
 /** The nearest directory of `filePath`'s ancestors that exists (the save creates the rest), or the errno code that stops the walk. */
 function findNearestExistingDirectory(filePath) {
     let directory = path.dirname(filePath);

package/dist/configDirFile.js.map

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

package/dist/connectors/jira/answerSink.d.ts

@@ -4,6 +4,7 @@ import { type JiraAccount, type JiraClient } from './client';
 import { type JiraUnconfirmedPosts } from './unconfirmedPosts';
 import type { JiraContextLedger } from './contextLedger';
 import type { JiraTrust } from './trustedGroup';
+import type { TaskAgentSlotDecision } from '../../trackers/taskAgentSlots';
 /**
  * @description The Jira connector's answer sink (plan J6, D20, R18): an answer
  * becomes one or more comments by the AI account, in order; a `question` or a
@@ -39,6 +40,11 @@ export declare function buildJiraAlertText(requestId: string, reason: RequestAle
 export declare function buildJiraParkText(runBudgetPer24h: number): string;
 /** @description The mention park notice (D10): over the run budget, nothing is handed back — the issue was never handed over. */
 export declare function buildJiraMentionParkText(runBudgetPer24h: number): string;
+/**
+ * @description The queued notice (D10): every task-agent slot of the bot is busy, so this hand-over waits and starts by itself.
+ * Posted once, when the issue joins the list; `aheadCount` is how many issues were in front of it then.
+ */
+export declare function buildJiraQueuedText(maxConcurrent: number, aheadCount: number): string;
 /**
  * @description The warning that rides an answer's result when some of `replyToCommentIds` were left out: the
  * answer itself was delivered, so the agent is told what to know, never to resend it.
@@ -69,6 +75,10 @@ export interface JiraAnswerSink extends AnswerSink {
     parkIssue(issueKey: string, requester: JiraAccount | null): Promise<void>;
     /** A mention over the run budget (D10): the park notice, no hand-back (nothing was handed over). Never rejects. */
     parkMention(issueKey: string): Promise<void>;
+    /** A hand-over that waits for a task-agent slot (D10): the notice saying so, no hand-back — the issue stays the AI's. Never rejects. */
+    postQueuedNotice(issueKey: string, queue: Extract<TaskAgentSlotDecision, {
+        kind: 'queued';
+    }>): Promise<void>;
     /** A hand-over the trusted group `groupName` does not back: the fixed notice, then the hand-back. Never rejects. */
     refuseUntrusted(issueKey: string, requester: JiraAccount | null, groupName: string): Promise<void>;
 }

package/dist/connectors/jira/answerSink.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"answerSink.d.ts","sourceRoot":"","sources":["../../../src/connectors/jira/answerSink.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAA+C,MAAM,2BAA2B,CAAC;AACzG,OAAO,KAAK,EAAE,kBAAkB,EAAiB,MAAM,sBAAsB,CAAC;AAY9E,OAAO,EAAiB,KAAK,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AAC5E,OAAO,EAAsB,KAAK,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAGnF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD;;;;;;;;;;;;;;GAcG;AAEH,6EAA6E;AAC7E,eAAO,MAAM,wBAAwB,KAAK,CAAC;AAC3C;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,QAAY,CAAC;AACjD;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,QAAS,CAAC;AAU1C,6FAA6F;AAC7F,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAExF;AAED,4IAA4I;AAC5I,wBAAgB,iBAAiB,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,CAGjE;AAED,iIAAiI;AACjI,wBAAgB,wBAAwB,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,CAGxE;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAGlF;AAED,mHAAmH;AACnH,eAAO,MAAM,wBAAwB,0EAA0E,CAAC;AAEhH;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,IAAI,CAAC,UAAU,EAAE,YAAY,GAAG,mBAAmB,GAAG,UAAU,GAAG,aAAa,GAAG,YAAY,CAAC,CAAC;IACzG,WAAW,EAAE,MAAM,CAAC;IACpB,+FAA+F;IAC/F,aAAa,EAAE,IAAI,CAAC,iBAAiB,EAAE,eAAe,CAAC,CAAC;IACxD,gHAAgH;IAChH,QAAQ,EAAE,MAAM,SAAS,GAAG,IAAI,CAAC;IACjC,eAAe,EAAE,MAAM,CAAC;IACxB,GAAG,EAAE,MAAM,MAAM,CAAC;IAClB,gEAAgE;IAChE,IAAI,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,gBAAgB,EAAE,IAAI,CAAC,oBAAoB,EAAE,aAAa,GAAG,mBAAmB,GAAG,QAAQ,CAAC,CAAC;CAC9F;AAkCD,MAAM,WAAW,cAAe,SAAQ,UAAU;IAChD,qFAAqF;IACrF,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1E,mHAAmH;IACnH,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,oHAAoH;IACpH,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,GAAG,IAAI,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpG;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,kBAAkB,GAAG,cAAc,CA+O7E"}
+{"version":3,"file":"answerSink.d.ts","sourceRoot":"","sources":["../../../src/connectors/jira/answerSink.ts"],"names":[],"mappings":"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"}

package/dist/connectors/jira/answerSink.js

@@ -4,6 +4,7 @@ exports.jiraQuestionContinueText = exports.jiraReadBackDelayMs = exports.jiraRea
 exports.buildJiraAlertText = buildJiraAlertText;
 exports.buildJiraParkText = buildJiraParkText;
 exports.buildJiraMentionParkText = buildJiraMentionParkText;
+exports.buildJiraQueuedText = buildJiraQueuedText;
 exports.buildJiraReplyLeftOutWarning = buildJiraReplyLeftOutWarning;
 exports.buildJiraUntrustedText = buildJiraUntrustedText;
 exports.createJiraAnswerSink = createJiraAnswerSink;
@@ -64,6 +65,15 @@ function buildJiraMentionParkText(runBudgetPer24h) {
     return `⏸ The AI was asked about this issue ${runBudgetPer24h} times in the last 24 hours (hand-overs and mentions together), ` +
         'its limit, so this mention was not answered. Mention it again later, or ask the operator to raise the limit.';
 }
+/**
+ * @description The queued notice (D10): every task-agent slot of the bot is busy, so this hand-over waits and starts by itself.
+ * Posted once, when the issue joins the list; `aheadCount` is how many issues were in front of it then.
+ */
+function buildJiraQueuedText(maxConcurrent, aheadCount) {
+    const place = aheadCount === 0 ? 'it is next in line' : `${aheadCount} ${aheadCount === 1 ? 'issue is' : 'issues are'} ahead of it`;
+    return `⏳ The AI is working on ${maxConcurrent} ${maxConcurrent === 1 ? 'task' : 'tasks'} at once, its limit, so this issue is queued (${place}). ` +
+        'It starts by itself when a slot frees up; nothing is needed from you.';
+}
 /**
  * @description The warning that rides an answer's result when some of `replyToCommentIds` were left out: the
  * answer itself was delivered, so the agent is told what to know, never to resend it.
@@ -341,6 +351,9 @@ function createJiraAnswerSink(deps) {
         parkMention: async (issueKey) => {
             await postNotice(issueKey, (0, adf_1.convertMarkdownToAdf)(buildJiraMentionParkText(deps.runBudgetPer24h)), 'mention park');
         },
+        postQueuedNotice: async (issueKey, queue) => {
+            await postNotice(issueKey, (0, adf_1.convertMarkdownToAdf)(buildJiraQueuedText(queue.maxConcurrent, queue.aheadCount)), 'queued');
+        },
         refuseUntrusted: (issueKey, requester, groupName) => postNoticeAndHandBack(issueKey, requester, (0, adf_1.createPlainTextAdf)(buildJiraUntrustedText(groupName)), 'untrusted'),
     };
 }