charness 3.6.1 → 3.7.0

package/dist/remoteRun/output.js

@@ -0,0 +1,82 @@
+"use strict";
+/**
+ * @description What the commands write and where: the job's output to stdout, remote-run's own lines to stderr prefixed `remote-run: `.
+ * The job script writes ITS progress lines (waiting for another job of the project, installing dependencies, a timeout) into the job's
+ * log with the same prefix, so the router sends every log line that starts with it to stderr — a command that prints such a line itself
+ * only moves it to the other stream.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ownLinePrefix = void 0;
+exports.sayOwn = sayOwn;
+exports.createJobOutputRouter = createJobOutputRouter;
+exports.createExitMarkerFilter = createExitMarkerFilter;
+exports.ownLinePrefix = 'remote-run: ';
+/** @description One of remote-run's own lines, to stderr. */
+function sayOwn(io, line) {
+    io.stderr(`${exports.ownLinePrefix}${line}\n`);
+}
+function createJobOutputRouter(io) {
+    let pending = '';
+    const emit = (line) => {
+        if (line.startsWith(exports.ownLinePrefix))
+            io.stderr(line);
+        else
+            io.stdout(line);
+    };
+    return {
+        write(chunk) {
+            pending += chunk;
+            let newline = pending.indexOf('\n');
+            while (newline >= 0) {
+                emit(pending.slice(0, newline + 1));
+                pending = pending.slice(newline + 1);
+                newline = pending.indexOf('\n');
+            }
+        },
+        flush() {
+            if (pending !== '')
+                emit(pending);
+            pending = '';
+        },
+    };
+}
+/** The line `runner.sh exec` ends its stderr with: RS (U+001E), the name, the command's exit code, a newline. */
+const exitMarkerPattern = /\u001eremote-run-exit:(\d+)\n/g;
+/** A marker that has begun but not arrived whole is held back at most this long (the marker is shorter than this). */
+const exitMarkerHoldBackLength = 40;
+/**
+ * @description Takes the exit marker `runner.sh exec` prints out of a stderr stream, however the stream is cut into chunks, and hands on
+ * everything else at once — a partial marker is held back only until the rest arrives or the stream ends.
+ */
+function createExitMarkerFilter(forward) {
+    let pending = '';
+    let exitCode = null;
+    return {
+        write(chunk) {
+            let text = pending + chunk;
+            pending = '';
+            let handedOn = 0;
+            for (const match of text.matchAll(exitMarkerPattern)) {
+                if (match.index > handedOn)
+                    forward(text.slice(handedOn, match.index));
+                exitCode = Number(match[1]);
+                handedOn = match.index + match[0].length;
+            }
+            text = text.slice(handedOn);
+            const markerStart = text.lastIndexOf('\u001e');
+            if (markerStart >= 0 && text.length - markerStart < exitMarkerHoldBackLength && !text.slice(markerStart).includes('\n')) {
+                pending = text.slice(markerStart);
+                text = text.slice(0, markerStart);
+            }
+            if (text !== '')
+                forward(text);
+        },
+        flush() {
+            if (pending !== '')
+                forward(pending);
+            pending = '';
+        },
+        getExitCode: () => exitCode,
+    };
+}
+//# sourceMappingURL=output.js.map

package/dist/remoteRun/output.js.map

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

package/dist/remoteRun/pathPatterns.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @description The ONE definition of what a path pattern of `.remote-run` (`pull:`, `exclude:`, `send:`, `install-key:`) means, as
+ * extended regular expressions: the main box applies them with `RegExp` and the runner script with bash's `=~` over the very same
+ * strings, so the two can never disagree about which files a pattern names.
+ *
+ * A pattern is relative to the project root. `*` is any run of characters inside one path segment, `?` one character, `**` a whole
+ * segment of any depth (`**` + `/` before a name, `/` + `**` at the end). A pattern names a file OR a directory: a directory brings
+ * everything below it (`test-results` is `test-results/a/b.png` too). Nothing floats: `snapshots` is the folder at the root only,
+ * `**` + `/snapshots` any `snapshots` folder.
+ */
+/** @description Why `pattern` cannot be used, or `null` when it can: not empty, relative, inside the project, no control characters. */
+export declare function getPathPatternProblem(pattern: string): string | null;
+/** @description The extended regular expression (anchored) a project-relative path must match to be named by `pattern`. */
+export declare function compilePathPattern(pattern: string): string;
+/** @description The compiled expressions of `patterns`, in order (the form the runner script receives, one per line). */
+export declare function compilePathPatterns(patterns: readonly string[]): string[];
+/** The root every path of the project lies under. */
+export declare const projectSearchRoot = ".";
+/**
+ * @description The folder a walk must start from to find every path `pattern` names: its leading segments that hold no `*`, `?` or `**`
+ * (`e2e/artifacts` → itself, `test-results/**` + `/*.xml` → `test-results`, `**` + `/*.png` → `.`). A fully literal pattern is its own root: a file or
+ * a folder, either is found from there.
+ */
+export declare function getPathPatternSearchRoot(pattern: string): string;
+/**
+ * @description The folders to walk to find what any of `patterns` names, without the ones another root already covers; just `.` as soon
+ * as one pattern starts with a wildcard (that one needs the whole tree). The runner walks these instead of the whole copy, which holds
+ * `node_modules` and every build folder.
+ */
+export declare function getPathPatternSearchRoots(patterns: readonly string[]): string[];
+/** @description A predicate over project-relative paths: does any of `patterns` name it? No pattern names nothing. */
+export declare function createPathMatcher(patterns: readonly string[]): (relativePath: string) => boolean;
+//# sourceMappingURL=pathPatterns.d.ts.map

package/dist/remoteRun/pathPatterns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pathPatterns.d.ts","sourceRoot":"","sources":["../../src/remoteRun/pathPatterns.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAoBH,wIAAwI;AACxI,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQpE;AAED,2HAA2H;AAC3H,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAsB1D;AAED,yHAAyH;AACzH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CAEzE;AAED,qDAAqD;AACrD,eAAO,MAAM,iBAAiB,MAAM,CAAC;AAErC;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAOhE;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CAI/E;AAED,sHAAsH;AACtH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAGhG"}

package/dist/remoteRun/pathPatterns.js

@@ -0,0 +1,115 @@
+"use strict";
+/**
+ * @description The ONE definition of what a path pattern of `.remote-run` (`pull:`, `exclude:`, `send:`, `install-key:`) means, as
+ * extended regular expressions: the main box applies them with `RegExp` and the runner script with bash's `=~` over the very same
+ * strings, so the two can never disagree about which files a pattern names.
+ *
+ * A pattern is relative to the project root. `*` is any run of characters inside one path segment, `?` one character, `**` a whole
+ * segment of any depth (`**` + `/` before a name, `/` + `**` at the end). A pattern names a file OR a directory: a directory brings
+ * everything below it (`test-results` is `test-results/a/b.png` too). Nothing floats: `snapshots` is the folder at the root only,
+ * `**` + `/snapshots` any `snapshots` folder.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.projectSearchRoot = void 0;
+exports.getPathPatternProblem = getPathPatternProblem;
+exports.compilePathPattern = compilePathPattern;
+exports.compilePathPatterns = compilePathPatterns;
+exports.getPathPatternSearchRoot = getPathPatternSearchRoot;
+exports.getPathPatternSearchRoots = getPathPatternSearchRoots;
+exports.createPathMatcher = createPathMatcher;
+const regexSpecialCharacters = /[.[\]{}()*+?|^$\\]/g;
+const anyDepthPrefix = '(.*/)?';
+const anyDepthSuffix = '.*';
+const singleSegmentRun = '[^/]*';
+const singleCharacter = '[^/]';
+/** Control characters (a newline would split the pattern file the runner reads one pattern per line). */
+const controlCharacters = /[\x00-\x1f\x7f]/;
+function escapeLiteral(text) {
+    return text.replace(regexSpecialCharacters, '\\$&');
+}
+/** The parts of a pattern between slashes, without `./` prefixes, trailing slashes or empty parts; consecutive `**` parts are one (they mean the same, and nested any-depth groups backtrack badly). */
+function splitPatternSegments(pattern) {
+    const segments = pattern.replace(/^(\.\/)+/, '').replace(/\/+$/, '').split('/').filter((segment) => segment !== '' && segment !== '.');
+    return segments.filter((segment, index) => !(segment === '**' && segments[index - 1] === '**'));
+}
+/** @description Why `pattern` cannot be used, or `null` when it can: not empty, relative, inside the project, no control characters. */
+function getPathPatternProblem(pattern) {
+    if (pattern.trim() === '')
+        return 'is empty';
+    if (controlCharacters.test(pattern))
+        return 'holds a control character';
+    if (pattern.startsWith('/'))
+        return 'must be relative to the project root, not absolute';
+    if (pattern.startsWith('~'))
+        return 'must be relative to the project root, not start with ~';
+    if (pattern.split('/').includes('..'))
+        return 'must stay inside the project (no ".." part)';
+    if (splitPatternSegments(pattern).length === 0)
+        return 'names no path (name a file or a folder of the project)';
+    return null;
+}
+/** @description The extended regular expression (anchored) a project-relative path must match to be named by `pattern`. */
+function compilePathPattern(pattern) {
+    const problem = getPathPatternProblem(pattern);
+    if (problem !== null)
+        throw new Error(`a path pattern ${problem}`);
+    const segments = splitPatternSegments(pattern);
+    let source = '';
+    segments.forEach((segment, index) => {
+        const isLast = index === segments.length - 1;
+        if (segment === '**') {
+            source += isLast ? anyDepthSuffix : anyDepthPrefix;
+            return;
+        }
+        let escaped = '';
+        for (const character of segment) {
+            if (character === '*')
+                escaped += singleSegmentRun;
+            else if (character === '?')
+                escaped += singleCharacter;
+            else
+                escaped += escapeLiteral(character);
+        }
+        source += isLast ? escaped : `${escaped}/`;
+    });
+    // A trailing `**` already ends in `.*` after a slash; a trailing name may be a directory with files below it.
+    const needsDirectoryTail = segments[segments.length - 1] !== '**';
+    return `^${source}${needsDirectoryTail ? '(/.*)?' : ''}$`;
+}
+/** @description The compiled expressions of `patterns`, in order (the form the runner script receives, one per line). */
+function compilePathPatterns(patterns) {
+    return patterns.map(compilePathPattern);
+}
+/** The root every path of the project lies under. */
+exports.projectSearchRoot = '.';
+/**
+ * @description The folder a walk must start from to find every path `pattern` names: its leading segments that hold no `*`, `?` or `**`
+ * (`e2e/artifacts` → itself, `test-results/**` + `/*.xml` → `test-results`, `**` + `/*.png` → `.`). A fully literal pattern is its own root: a file or
+ * a folder, either is found from there.
+ */
+function getPathPatternSearchRoot(pattern) {
+    const fixedSegments = [];
+    for (const segment of splitPatternSegments(pattern)) {
+        if (segment.includes('*') || segment.includes('?'))
+            break;
+        fixedSegments.push(segment);
+    }
+    return fixedSegments.length === 0 ? exports.projectSearchRoot : fixedSegments.join('/');
+}
+/**
+ * @description The folders to walk to find what any of `patterns` names, without the ones another root already covers; just `.` as soon
+ * as one pattern starts with a wildcard (that one needs the whole tree). The runner walks these instead of the whole copy, which holds
+ * `node_modules` and every build folder.
+ */
+function getPathPatternSearchRoots(patterns) {
+    const roots = [...new Set(patterns.map(getPathPatternSearchRoot))];
+    if (roots.includes(exports.projectSearchRoot))
+        return [exports.projectSearchRoot];
+    return roots.filter((root) => !roots.some((other) => other !== root && root.startsWith(`${other}/`)));
+}
+/** @description A predicate over project-relative paths: does any of `patterns` name it? No pattern names nothing. */
+function createPathMatcher(patterns) {
+    const expressions = compilePathPatterns(patterns).map((source) => new RegExp(source));
+    return (relativePath) => expressions.some((expression) => expression.test(relativePath));
+}
+//# sourceMappingURL=pathPatterns.js.map

package/dist/remoteRun/pathPatterns.js.map

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

package/dist/remoteRun/probe.d.ts

@@ -0,0 +1,56 @@
+/**
+ * @description What a runner says about itself (`runner.sh probe`), parsed, and the short block `remote-run runners` prints for it.
+ * The runner prints `key=value` lines; an unknown key is ignored (a newer runner script, an older main box) and a missing one is
+ * "unknown", never a guess.
+ */
+export declare const runnerCapabilities: readonly ["android", "ios", "docker", "playwright"];
+export type RunnerCapability = (typeof runnerCapabilities)[number];
+/** @name CapabilityReport @description One capability: whether the runner can do it and, in plain words, how / why not. */
+export interface CapabilityReport {
+    isAvailable: boolean;
+    detail: string;
+}
+/** @name RunnerProbe @description The facts of one probe. Numbers are `null` when the runner did not report them. */
+export interface RunnerProbe {
+    os: string;
+    osName: string;
+    osVersion: string;
+    kernel: string;
+    arch: string;
+    cpuModel: string;
+    cpuCores: number | null;
+    cpuThreads: number | null;
+    load: number | null;
+    ramTotalMb: number | null;
+    ramFreeMb: number | null;
+    diskFreeMb: number | null;
+    /** The Pueue version, `null` when Pueue is missing on the runner. */
+    pueueVersion: string | null;
+    jobsRunning: number;
+    jobsQueued: number;
+    jobsProjects: number;
+    capabilities: Record<RunnerCapability, CapabilityReport>;
+}
+/** @description Parse the `key=value` lines of `runner.sh probe`. */
+export declare function parseProbeOutput(text: string): RunnerProbe;
+/** @description Does the probed runner have `capability`? */
+export declare function checkHasCapability(probe: RunnerProbe, capability: RunnerCapability): boolean;
+/** @description The three lines under a runner's heading: hardware, jobs and groups, capabilities. */
+export declare function formatRunnerDetails(probe: RunnerProbe, groupLimits: Readonly<Record<string, number>>): string[];
+/** @name RunnerReport @description What `runners` knows of one runner after probing: live, or the last snapshot with why it is offline. */
+export type RunnerReport = {
+    name: string;
+    status: 'online';
+    probe: RunnerProbe;
+    groupLimits: Record<string, number>;
+} | {
+    name: string;
+    status: 'offline';
+    reason: string;
+    lastSeenAtMs: number | null;
+    lastProbe: RunnerProbe | null;
+    groupLimits: Record<string, number>;
+};
+/** @description The block `remote-run runners` prints for one runner. An offline one shows its last snapshot, marked as old. */
+export declare function formatRunnerBlock(report: RunnerReport): string;
+//# sourceMappingURL=probe.d.ts.map

package/dist/remoteRun/probe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"probe.d.ts","sourceRoot":"","sources":["../../src/remoteRun/probe.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,kBAAkB,qDAAsD,CAAC;AACtF,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnE,2HAA2H;AAC3H,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,qHAAqH;AACrH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,qEAAqE;IACrE,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC,gBAAgB,EAAE,gBAAgB,CAAC,CAAC;CAC1D;AAUD,qEAAqE;AACrE,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAmC1D;AAED,6DAA6D;AAC7D,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,gBAAgB,GAAG,OAAO,CAE5F;AAoCD,sGAAsG;AACtG,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,MAAM,EAAE,CAQ/G;AAED,2IAA2I;AAC3I,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,WAAW,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAC3F;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,SAAS,EAAE,WAAW,GAAG,IAAI,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAAC;AAOzJ,gIAAgI;AAChI,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAU9D"}

package/dist/remoteRun/probe.js

@@ -0,0 +1,123 @@
+"use strict";
+/**
+ * @description What a runner says about itself (`runner.sh probe`), parsed, and the short block `remote-run runners` prints for it.
+ * The runner prints `key=value` lines; an unknown key is ignored (a newer runner script, an older main box) and a missing one is
+ * "unknown", never a guess.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runnerCapabilities = void 0;
+exports.parseProbeOutput = parseProbeOutput;
+exports.checkHasCapability = checkHasCapability;
+exports.formatRunnerDetails = formatRunnerDetails;
+exports.formatRunnerBlock = formatRunnerBlock;
+exports.runnerCapabilities = ['android', 'ios', 'docker', 'playwright'];
+const megabytesPerGigabyte = 1024;
+function readNumber(value) {
+    if (value === undefined || value.trim() === '')
+        return null;
+    const parsed = Number(value);
+    return Number.isFinite(parsed) ? parsed : null;
+}
+/** @description Parse the `key=value` lines of `runner.sh probe`. */
+function parseProbeOutput(text) {
+    const fields = new Map();
+    for (const line of text.split('\n')) {
+        const separator = line.indexOf('=');
+        if (separator > 0)
+            fields.set(line.slice(0, separator).trim(), line.slice(separator + 1).trim());
+    }
+    const readCapability = (name) => ({
+        isAvailable: fields.get(`cap_${name}`) === 'yes',
+        detail: fields.get(`cap_${name}_detail`) ?? '',
+    });
+    const pueue = fields.get('pueue');
+    return {
+        os: fields.get('os') ?? '',
+        osName: fields.get('os_name') ?? fields.get('os') ?? '',
+        osVersion: fields.get('os_version') ?? '',
+        kernel: fields.get('kernel') ?? '',
+        arch: fields.get('arch') ?? '',
+        cpuModel: fields.get('cpu_model') ?? '',
+        cpuCores: readNumber(fields.get('cpu_cores')),
+        cpuThreads: readNumber(fields.get('cpu_threads')),
+        load: readNumber(fields.get('load')),
+        ramTotalMb: readNumber(fields.get('ram_total_mb')),
+        ramFreeMb: readNumber(fields.get('ram_free_mb')),
+        diskFreeMb: readNumber(fields.get('disk_free_mb')),
+        pueueVersion: pueue === undefined || pueue === 'missing' || pueue === '' ? null : pueue,
+        jobsRunning: readNumber(fields.get('jobs_running')) ?? 0,
+        jobsQueued: readNumber(fields.get('jobs_queued')) ?? 0,
+        jobsProjects: readNumber(fields.get('jobs_projects')) ?? 0,
+        capabilities: {
+            android: readCapability('android'),
+            ios: readCapability('ios'),
+            docker: readCapability('docker'),
+            playwright: readCapability('playwright'),
+        },
+    };
+}
+/** @description Does the probed runner have `capability`? */
+function checkHasCapability(probe, capability) {
+    return probe.capabilities[capability].isAvailable;
+}
+function formatGigabytes(megabytes) {
+    if (megabytes === null)
+        return '?';
+    const gigabytes = megabytes / megabytesPerGigabyte;
+    return `${gigabytes >= 10 ? Math.round(gigabytes) : Math.round(gigabytes * 10) / 10} GB`;
+}
+/** `Ubuntu 24.04 (Linux 6.8, x86_64)` — the kernel trimmed to major.minor; the kernel's own name is left out when it is the system's name too. */
+function formatSystem(probe) {
+    const kernel = probe.kernel.split('.').slice(0, 2).join('.');
+    const system = [probe.osName, probe.osVersion].filter((part) => part !== '').join(' ');
+    const kernelLabel = probe.osName === probe.os ? kernel : [probe.os, kernel].filter((part) => part !== '').join(' ');
+    const details = [kernelLabel, probe.arch].filter((part) => part !== '').join(', ');
+    return details === '' ? system : `${system} (${details})`;
+}
+function formatCpu(probe) {
+    const model = probe.cpuModel === '' ? 'CPU' : `CPU ${probe.cpuModel}`;
+    const shape = probe.cpuCores === null ? '' : `, ${probe.cpuCores} cores / ${probe.cpuThreads ?? '?'} threads`;
+    const load = probe.load === null ? '' : `, load ${probe.load}`;
+    return `${model}${shape}${load}`;
+}
+/** The `can:` parts in plain words: what the runner can do first (`android (KVM, emulator)`), then what it cannot with why (`ios: no (Linux)`). */
+function formatCapabilities(probe) {
+    const available = [];
+    const unavailable = [];
+    for (const name of exports.runnerCapabilities) {
+        const report = probe.capabilities[name];
+        if (report.isAvailable)
+            available.push(report.detail === '' ? name : `${name} (${report.detail})`);
+        else
+            unavailable.push(`${name}: no${report.detail === '' ? '' : ` (${report.detail})`}`);
+    }
+    return [...available, ...unavailable];
+}
+/** @description The three lines under a runner's heading: hardware, jobs and groups, capabilities. */
+function formatRunnerDetails(probe, groupLimits) {
+    const groups = Object.entries(groupLimits).map(([groupName, parallel]) => `${groupName} ${parallel}`).join(', ');
+    const jobs = `jobs: ${probe.jobsRunning} running, ${probe.jobsQueued} queued, ${probe.jobsProjects} ${probe.jobsProjects === 1 ? 'project' : 'projects'}`;
+    return [
+        `  ${formatCpu(probe)} · RAM ${formatGigabytes(probe.ramTotalMb)}, ${formatGigabytes(probe.ramFreeMb)} free · disk ${formatGigabytes(probe.diskFreeMb)} free (work dir)`,
+        `  ${jobs}${groups === '' ? '' : ` · groups: ${groups}`}${probe.pueueVersion === null ? ' · Pueue: MISSING (install it, see docs/remote-run.md)' : ''}`,
+        `  can: ${formatCapabilities(probe).join(' · ')}`,
+    ];
+}
+/** `2026-10-30 14:02 UTC` */
+function formatLastSeen(timestampMs) {
+    return `${new Date(timestampMs).toISOString().slice(0, 16).replace('T', ' ')} UTC`;
+}
+/** @description The block `remote-run runners` prints for one runner. An offline one shows its last snapshot, marked as old. */
+function formatRunnerBlock(report) {
+    if (report.status === 'online') {
+        return [`${report.name} — online · ${formatSystem(report.probe)}`, ...formatRunnerDetails(report.probe, report.groupLimits)].join('\n');
+    }
+    const lastSeen = report.lastSeenAtMs === null ? 'never seen' : `last seen ${formatLastSeen(report.lastSeenAtMs)}`;
+    if (report.lastProbe === null)
+        return `${report.name} — offline (${report.reason}) · ${lastSeen}`;
+    return [
+        `${report.name} — offline (${report.reason}) · ${lastSeen} — as it was then: ${formatSystem(report.lastProbe)}`,
+        ...formatRunnerDetails(report.lastProbe, report.groupLimits),
+    ].join('\n');
+}
+//# sourceMappingURL=probe.js.map

package/dist/remoteRun/probe.js.map

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

package/dist/remoteRun/project.d.ts

@@ -0,0 +1,26 @@
+import { type ProjectConfig } from './projectConfig';
+import { type SendPlan } from './sendPlan';
+export interface ProjectContext {
+    /** The git working tree's root, absolute and real. */
+    root: string;
+    /** The folder the command runs in, relative to the root (`''` for the root itself), with `/` separators. */
+    subfolder: string;
+    config: ProjectConfig;
+    slug: string;
+}
+/** @description The project of `cwd`: refused with a clear message when `cwd` is not inside a git working tree. */
+export declare function getProjectContext(cwd: string): ProjectContext;
+/** @description `.remote-run` of the project, or the empty config when there is none; a bad file is an error naming its lines. */
+export declare function readProjectConfig(root: string): ProjectConfig;
+/** @description What goes to the runner for this project: git's lists, trimmed and opted in by `.remote-run` (`planSendList`). */
+export declare function planProjectSend(project: ProjectContext): SendPlan;
+/**
+ * @description The folders of the project (relative, `/`-separated) in which a file runs on this machine at the next git command, so a
+ * result file from a runner must never land there: where git looks for hooks (`git rev-parse --git-path hooks`, which already folds in
+ * `core.hooksPath`) when that is inside the project — and, for husky's `_` shim folder, its parent, where the real hooks are — plus the
+ * conventional hook folders, which become live the moment a hook manager's install step points git at them. A hooks folder that is the
+ * project root itself is `''`: nothing may come back. Ones outside the project (the default `.git/hooks` is covered by the `.git` rule; a
+ * worktree's lives in the main checkout) are not the project's to protect.
+ */
+export declare function getHookDirectories(projectRoot: string): string[];
+//# sourceMappingURL=project.d.ts.map

package/dist/remoteRun/project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../src/remoteRun/project.ts"],"names":[],"mappings":"AAMA,OAAO,EAAyC,KAAK,aAAa,EAA4B,MAAM,iBAAiB,CAAC;AACtH,OAAO,EAAgB,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AAoBzD,MAAM,WAAW,cAAc;IAC7B,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,4GAA4G;IAC5G,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,aAAa,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,mHAAmH;AACnH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,CAS7D;AAED,kIAAkI;AAClI,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAY7D;AA4CD,kIAAkI;AAClI,wBAAgB,eAAe,CAAC,OAAO,EAAE,cAAc,GAAG,QAAQ,CAIjE;AAOD;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAehE"}

package/dist/remoteRun/project.js

@@ -0,0 +1,159 @@
+"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.getProjectContext = getProjectContext;
+exports.readProjectConfig = readProjectConfig;
+exports.planProjectSend = planProjectSend;
+exports.getHookDirectories = getHookDirectories;
+const child_process_1 = require("child_process");
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const remoteRunError_1 = require("./remoteRunError");
+const jobId_1 = require("./jobId");
+const projectConfig_1 = require("./projectConfig");
+const sendPlan_1 = require("./sendPlan");
+/**
+ * @description The local side of a submit: which project the command is run in, what `.remote-run` says, and which files git says
+ * are sendable. The project is the git working tree the command runs in; the command later runs in the same subfolder on the runner.
+ */
+const gitDeadlineMs = 60 * 1000;
+const gitOutputLimitBytes = 512 * 1024 * 1024;
+/** A gitlink (submodule) entry's mode in `git ls-files -s`. */
+const gitlinkMode = '160000';
+function runGit(directory, args) {
+    const result = (0, child_process_1.spawnSync)('git', ['-C', directory, ...args], { encoding: 'utf8', timeout: gitDeadlineMs, maxBuffer: gitOutputLimitBytes });
+    if (result.error !== undefined || result.status !== 0) {
+        throw new remoteRunError_1.RemoteRunError(`git ${args[0]} failed in ${directory}: ${(result.stderr ?? '').trim().split('\n')[0] || result.error?.message || 'no output'}`);
+    }
+    return result.stdout;
+}
+/** @description The project of `cwd`: refused with a clear message when `cwd` is not inside a git working tree. */
+function getProjectContext(cwd) {
+    const probe = (0, child_process_1.spawnSync)('git', ['-C', cwd, 'rev-parse', '--show-toplevel'], { encoding: 'utf8', timeout: gitDeadlineMs });
+    if (probe.error !== undefined || probe.status !== 0) {
+        throw new remoteRunError_1.RemoteRunError(`${cwd} is not inside a git working tree — remote-run sends the project's files as git lists them (tracked and untracked, not ignored), so it needs a git project`);
+    }
+    const root = fs.realpathSync(probe.stdout.trim());
+    const relative = path.relative(root, fs.realpathSync(cwd));
+    const subfolder = relative === '' ? '' : relative.split(path.sep).join('/');
+    return { root, subfolder, config: readProjectConfig(root), slug: (0, jobId_1.getProjectSlug)(root, { hostname: os.hostname(), uid: os.userInfo().uid }) };
+}
+/** @description `.remote-run` of the project, or the empty config when there is none; a bad file is an error naming its lines. */
+function readProjectConfig(root) {
+    const configPath = path.join(root, projectConfig_1.projectConfigName);
+    let text;
+    try {
+        text = fs.readFileSync(configPath, 'utf8');
+    }
+    catch (error) {
+        if (error instanceof Error && 'code' in error && error.code === 'ENOENT')
+            return (0, projectConfig_1.createEmptyProjectConfig)();
+        throw new remoteRunError_1.RemoteRunError(`${projectConfig_1.projectConfigName} could not be read`);
+    }
+    const parsed = (0, projectConfig_1.parseProjectConfig)(text);
+    if (!parsed.ok)
+        throw new remoteRunError_1.RemoteRunError(parsed.errors.join('\n'));
+    return parsed.config;
+}
+function splitNul(output) {
+    return output.split('\0').filter((entry) => entry !== '');
+}
+function listGitDirectory(directory) {
+    const files = splitNul(runGit(directory, ['ls-files', '-co', '--exclude-standard', '-z', '--deduplicate']));
+    const staged = splitNul(runGit(directory, ['ls-files', '-s', '-z']));
+    const gitlinks = staged.filter((entry) => entry.startsWith(`${gitlinkMode} `)).map((entry) => entry.slice(entry.indexOf('\t') + 1));
+    return { files, gitlinks };
+}
+/** Every sendable path of `directory` and of its checked-out submodules (recursively), relative to `directory`, prefixed with `prefix`. */
+function listFilesRecursively(directory, prefix) {
+    const { files, gitlinks } = listGitDirectory(directory);
+    const result = files.filter((file) => !gitlinks.includes(file)).map((file) => `${prefix}${file}`);
+    for (const gitlink of gitlinks) {
+        const submodule = path.join(directory, gitlink);
+        if (fs.existsSync(path.join(submodule, '.git')))
+            result.push(...listFilesRecursively(submodule, `${prefix}${gitlink}/`));
+    }
+    return result;
+}
+/** A file git lists but that is gone from the disk (deleted, not yet staged) or is not a file or a link is not sent: the runner's copy loses it. */
+function checkIsSendable(root, relativePath) {
+    try {
+        const stat = fs.lstatSync(path.join(root, relativePath));
+        return stat.isFile() || stat.isSymbolicLink();
+    }
+    catch {
+        return false;
+    }
+}
+/** Ignored files that exist, consulted only for what `send:` opts in; a collapsed ignored DIRECTORY (`node_modules/`) is never one of them. */
+function listIgnoredFiles(root) {
+    return splitNul(runGit(root, ['ls-files', '-o', '-i', '--exclude-standard', '--directory', '-z'])).filter((entry) => !entry.endsWith('/'));
+}
+/** @description What goes to the runner for this project: git's lists, trimmed and opted in by `.remote-run` (`planSendList`). */
+function planProjectSend(project) {
+    const files = listFilesRecursively(project.root, '').filter((file) => checkIsSendable(project.root, file));
+    const ignoredFiles = project.config.send.length === 0 ? [] : listIgnoredFiles(project.root).filter((file) => checkIsSendable(project.root, file));
+    return (0, sendPlan_1.planSendList)({ files, ignoredFiles, exclude: project.config.exclude, send: project.config.send });
+}
+/** The folders hook managers conventionally keep git hooks in (husky's, and the common `.githooks`): protected whether or not git points at them yet. */
+const conventionalHookDirectories = ['.husky', '.githooks'];
+/** The folder husky 9 points `core.hooksPath` at; the hooks a developer writes are in its parent. */
+const huskyShimDirectoryName = '_';
+/**
+ * @description The folders of the project (relative, `/`-separated) in which a file runs on this machine at the next git command, so a
+ * result file from a runner must never land there: where git looks for hooks (`git rev-parse --git-path hooks`, which already folds in
+ * `core.hooksPath`) when that is inside the project — and, for husky's `_` shim folder, its parent, where the real hooks are — plus the
+ * conventional hook folders, which become live the moment a hook manager's install step points git at them. A hooks folder that is the
+ * project root itself is `''`: nothing may come back. Ones outside the project (the default `.git/hooks` is covered by the `.git` rule; a
+ * worktree's lives in the main checkout) are not the project's to protect.
+ */
+function getHookDirectories(projectRoot) {
+    const directories = new Set(conventionalHookDirectories);
+    const result = (0, child_process_1.spawnSync)('git', ['-C', projectRoot, 'rev-parse', '--git-path', 'hooks'], { encoding: 'utf8', timeout: gitDeadlineMs });
+    if (result.error === undefined && result.status === 0 && result.stdout.trim() !== '') {
+        const relative = path.relative(fs.realpathSync(projectRoot), path.resolve(projectRoot, result.stdout.trim()));
+        if (!relative.startsWith('..') && !path.isAbsolute(relative)) {
+            const hooksDirectory = relative.split(path.sep).join('/');
+            directories.add(hooksDirectory);
+            if (path.posix.basename(hooksDirectory) === huskyShimDirectoryName) {
+                const parent = path.posix.dirname(hooksDirectory);
+                directories.add(parent === '.' ? '' : parent);
+            }
+        }
+    }
+    return [...directories];
+}
+//# sourceMappingURL=project.js.map