charness 3.6.1 → 3.8.0

package/dist/remoteRun/probe.d.ts

@@ -0,0 +1,78 @@
+import { type RunnerServiceKind } from '../runners/hubRegistry';
+/**
+ * @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;
+}
+/** What the runner's own iOS Simulator boot check found (`ios-check.json`, written by the runner utility's service): it booted one, it could not, or nothing has run the check. */
+export declare const iosBootStatuses: readonly ["ok", "failed", "unchecked"];
+export type IosBootStatus = (typeof iosBootStatuses)[number];
+/** @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>;
+    /** Paused on the runner itself (`charness-runner pause`): no job is sent to it while it is. */
+    isPaused: boolean;
+    /** How the runner utility is kept running; `null` for a hand-made runner (and for an older script that did not say). */
+    serviceKind: RunnerServiceKind | null;
+    /** The charness version a paired runner runs; `null` for a hand-made one. */
+    runnerVersion: string | null;
+    /** The runner's iOS Simulator boot check; `null` when the runner did not report one. */
+    iosBoot: {
+        status: IosBootStatus;
+        detail: string;
+    } | null;
+}
+/** @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;
+export declare function formatGigabytes(megabytes: number | null): string;
+/** @description The lines under a runner's heading: hardware, jobs and groups, capabilities, and for a paired runner its program and service. */
+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>;
+    isPausedByHub: boolean;
+} | {
+    name: string;
+    status: 'offline';
+    reason: string;
+    lastSeenAtMs: number | null;
+    lastProbe: RunnerProbe | null;
+    groupLimits: Record<string, number>;
+    isPausedByHub: boolean;
+};
+/** @description Is the runner held back from new jobs — paused from the hub, or on the runner itself (what it said when it was last seen counts too)? */
+export declare function checkIsRunnerPaused(report: RunnerReport): boolean;
+/** @description `2026-10-30 14:02 UTC` */
+export declare function formatLastSeen(timestampMs: number): string;
+/** @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":"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"}

package/dist/remoteRun/probe.js

@@ -0,0 +1,157 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.iosBootStatuses = exports.runnerCapabilities = void 0;
+exports.parseProbeOutput = parseProbeOutput;
+exports.checkHasCapability = checkHasCapability;
+exports.formatGigabytes = formatGigabytes;
+exports.formatRunnerDetails = formatRunnerDetails;
+exports.checkIsRunnerPaused = checkIsRunnerPaused;
+exports.formatLastSeen = formatLastSeen;
+exports.formatRunnerBlock = formatRunnerBlock;
+const hubRegistry_1 = require("../runners/hubRegistry");
+const runnersList_1 = require("../runners/runnersList");
+/**
+ * @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.
+ */
+exports.runnerCapabilities = ['android', 'ios', 'docker', 'playwright'];
+/** What the runner's own iOS Simulator boot check found (`ios-check.json`, written by the runner utility's service): it booted one, it could not, or nothing has run the check. */
+exports.iosBootStatuses = ['ok', 'failed', 'unchecked'];
+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');
+    const iosBootStatus = exports.iosBootStatuses.find((status) => status === fields.get('ios_boot'));
+    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'),
+        },
+        isPaused: fields.get('paused') === 'yes',
+        serviceKind: hubRegistry_1.runnerServiceKinds.find((kind) => kind === fields.get('service')) ?? null,
+        runnerVersion: fields.get('runner_version') || null,
+        iosBoot: iosBootStatus === undefined ? null : { status: iosBootStatus, detail: fields.get('ios_boot_detail') ?? '' },
+    };
+}
+/** @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];
+}
+/** The line of a paired runner under its capabilities: the charness it runs and how it is kept running. Nothing for a hand-made one. */
+function formatRunnerProgram(probe) {
+    const parts = [
+        ...(probe.runnerVersion === null ? [] : [`charness-runner ${probe.runnerVersion}`]),
+        ...(probe.serviceKind === null ? [] : [runnersList_1.serviceKindLabels[probe.serviceKind]]),
+    ];
+    return parts.length === 0 ? [] : [`  ${parts.join(' · ')}`];
+}
+/** @description The lines under a runner's heading: hardware, jobs and groups, capabilities, and for a paired runner its program and service. */
+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(' · ')}`,
+        ...formatRunnerProgram(probe),
+    ];
+}
+/** @description Is the runner held back from new jobs — paused from the hub, or on the runner itself (what it said when it was last seen counts too)? */
+function checkIsRunnerPaused(report) {
+    if (report.isPausedByHub)
+        return true;
+    const probe = report.status === 'online' ? report.probe : report.lastProbe;
+    return probe?.isPaused === true;
+}
+/** `paused from the hub` / `paused on the runner`, for the heading. */
+function formatPauseTags(report) {
+    const probe = report.status === 'online' ? report.probe : report.lastProbe;
+    return [...(report.isPausedByHub ? ['paused from the hub'] : []), ...(probe?.isPaused === true ? ['paused on the runner'] : [])];
+}
+/** @description `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) {
+    const pauseTags = formatPauseTags(report).map((tag) => ` · ${tag}`).join('');
+    if (report.status === 'online') {
+        return [`${report.name} — online${pauseTags} · ${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})${pauseTags} · ${lastSeen}`;
+    return [
+        `${report.name} — offline (${report.reason})${pauseTags} · ${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

package/dist/remoteRun/project.js.map

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

package/dist/remoteRun/projectConfig.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @description `.remote-run` in the project root: what a project tells remote-run about itself. Optional; `key: value` lines, `#`
+ * starts a comment at the start of a line or after whitespace, blank lines are ignored. An unknown key or a bad value is an error
+ * that names the line.
+ *
+ *   pull: e2e/artifacts test-results                    files that come back (only what the job created or changed)
+ *   install: yarn install --immutable                   replaces the detected dependencies command; `install: none` turns the step off
+ *   install-key: yarn.lock package.json patches         what the dependencies step is keyed on (replaces the default)
+ *   exclude: fixtures/huge                              more paths that are never sent
+ *   send: .env.test                                     secret-looking files that ARE sent (also when git ignores them)
+ *
+ * The list keys (`pull`, `exclude`, `send`, `install-key`) take whitespace-separated patterns (`pathPatterns.ts`) and may repeat;
+ * `install` and `install-key` may each appear once.
+ */
+/** The value of `install:` that turns the dependencies step off. */
+export declare const installNone = "none";
+export interface ProjectConfig {
+    pull: string[];
+    /** The command, `none` for no step, `null` when the file says nothing (the lockfile's default applies). */
+    install: string | null;
+    /** The patterns the dependencies step is keyed on; `null` = the default key set. */
+    installKey: string[] | null;
+    exclude: string[];
+    send: string[];
+}
+export type ProjectConfigParse = {
+    ok: true;
+    config: ProjectConfig;
+} | {
+    ok: false;
+    errors: string[];
+};
+export declare function createEmptyProjectConfig(): ProjectConfig;
+/** @description The file name, for messages. */
+export declare const projectConfigName = ".remote-run";
+/** @description Parse the text of a `.remote-run`; every problem is reported (not just the first), each naming its line. */
+export declare function parseProjectConfig(text: string): ProjectConfigParse;
+//# sourceMappingURL=projectConfig.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"projectConfig.d.ts","sourceRoot":"","sources":["../../src/remoteRun/projectConfig.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;GAaG;AAEH,oEAAoE;AACpE,eAAO,MAAM,WAAW,SAAS,CAAC;AAElC,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,2GAA2G;IAC3G,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,oFAAoF;IACpF,UAAU,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAC5B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,MAAM,MAAM,kBAAkB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,aAAa,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAMvG,wBAAgB,wBAAwB,IAAI,aAAa,CAExD;AAED,gDAAgD;AAChD,eAAO,MAAM,iBAAiB,gBAAwB,CAAC;AAEvD,4HAA4H;AAC5H,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,CAiDnE"}

package/dist/remoteRun/projectConfig.js

@@ -0,0 +1,87 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.projectConfigName = exports.installNone = void 0;
+exports.createEmptyProjectConfig = createEmptyProjectConfig;
+exports.parseProjectConfig = parseProjectConfig;
+const pathPatterns_1 = require("./pathPatterns");
+/**
+ * @description `.remote-run` in the project root: what a project tells remote-run about itself. Optional; `key: value` lines, `#`
+ * starts a comment at the start of a line or after whitespace, blank lines are ignored. An unknown key or a bad value is an error
+ * that names the line.
+ *
+ *   pull: e2e/artifacts test-results                    files that come back (only what the job created or changed)
+ *   install: yarn install --immutable                   replaces the detected dependencies command; `install: none` turns the step off
+ *   install-key: yarn.lock package.json patches         what the dependencies step is keyed on (replaces the default)
+ *   exclude: fixtures/huge                              more paths that are never sent
+ *   send: .env.test                                     secret-looking files that ARE sent (also when git ignores them)
+ *
+ * The list keys (`pull`, `exclude`, `send`, `install-key`) take whitespace-separated patterns (`pathPatterns.ts`) and may repeat;
+ * `install` and `install-key` may each appear once.
+ */
+/** The value of `install:` that turns the dependencies step off. */
+exports.installNone = 'none';
+const projectConfigFileName = '.remote-run';
+const listKeys = ['pull', 'exclude', 'send', 'install-key'];
+const commentPattern = /(^|\s)#.*$/;
+function createEmptyProjectConfig() {
+    return { pull: [], install: null, installKey: null, exclude: [], send: [] };
+}
+/** @description The file name, for messages. */
+exports.projectConfigName = projectConfigFileName;
+/** @description Parse the text of a `.remote-run`; every problem is reported (not just the first), each naming its line. */
+function parseProjectConfig(text) {
+    const config = createEmptyProjectConfig();
+    const errors = [];
+    const seenKeys = new Set();
+    text.split(/\r?\n/).forEach((rawLine, index) => {
+        const lineNumber = index + 1;
+        const line = rawLine.replace(commentPattern, '$1').trim();
+        if (line === '')
+            return;
+        const separator = line.indexOf(':');
+        if (separator <= 0) {
+            errors.push(`${projectConfigFileName} line ${lineNumber}: expected "key: value"`);
+            return;
+        }
+        const key = line.slice(0, separator).trim();
+        const value = line.slice(separator + 1).trim();
+        const fail = (message) => {
+            errors.push(`${projectConfigFileName} line ${lineNumber}: ${message}`);
+        };
+        if (key !== 'install' && !listKeys.some((listKey) => listKey === key)) {
+            fail(`unknown key "${key}" (known: pull, install, install-key, exclude, send)`);
+            return;
+        }
+        if ((key === 'install' || key === 'install-key') && seenKeys.has(key)) {
+            fail(`"${key}" is given twice`);
+            return;
+        }
+        seenKeys.add(key);
+        if (value === '') {
+            fail(`"${key}" has no value`);
+            return;
+        }
+        if (key === 'install') {
+            config.install = value;
+            return;
+        }
+        const patterns = value.split(/\s+/);
+        for (const pattern of patterns) {
+            const problem = (0, pathPatterns_1.getPathPatternProblem)(pattern);
+            if (problem !== null) {
+                fail(`"${key}" pattern ${problem}`);
+                return;
+            }
+        }
+        if (key === 'install-key')
+            config.installKey = patterns;
+        else if (key === 'pull')
+            config.pull.push(...patterns);
+        else if (key === 'exclude')
+            config.exclude.push(...patterns);
+        else
+            config.send.push(...patterns);
+    });
+    return errors.length === 0 ? { ok: true, config } : { ok: false, errors };
+}
+//# sourceMappingURL=projectConfig.js.map

package/dist/remoteRun/projectConfig.js.map

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

package/dist/remoteRun/remoteRunCli.d.ts

@@ -0,0 +1,22 @@
+import { createProcessIo, type CliIo } from './output';
+import { type RunnersConfig } from './runnersConfig';
+/**
+ * @description `charness remote-run …` — send a command to a runner (a machine PAIRED with this charness — `charness runners pair`, the
+ * pasted line — or reached by ordinary ssh and listed in `~/.config/charness/runners.json`) and get its output, exit code and declared result files back as if it had run here. The
+ * contracts are in `src/remoteRun/README.md`; the user-facing description is `docs/remote-run.md`.
+ *
+ * The CLI loads NO env file (it would read the PROJECT's `.env`: agents run it from project folders) and never touches `DATA_DIR` or
+ * the state store: it needs nothing from an instance.
+ */
+export { createProcessIo };
+export declare const remoteRunUsage = "Usage:\n  charness remote-run [--runner <name>] [--needs android|ios|docker|playwright] [--runner-wait <dur>] [--group <g>]\n                      [--timeout <dur>] [--with-git] [-e NAME=VALUE]\u2026 [--bg] <command\u2026>\n                              run <command> on a runner, in the same folder of a copy of this git project;\n                              output and exit code come back, interrupt or timeout kills the remote job.\n                              --bg prints a job id and returns (long runs).\n                              --needs with a paired runner that has it but is offline waits for it up to --runner-wait\n                              (default 15m, 0 = fail at once).\n                              Options go BEFORE the command; a command that starts with a subcommand name goes after --\n  charness remote-run runners                 the runners: online, hardware, load, what each can do\n  charness remote-run ls [--all]              jobs of this project (all projects with --all)\n  charness remote-run status <id>             one job\n  charness remote-run logs <id> [-f] [--tail N]\n  charness remote-run wait <id>               block until the job ends, fetch its files, exit with its code\n  charness remote-run kill <id>\n  charness remote-run fetch <id>              bring a finished job's result files back (again)\n  charness remote-run exec [--runner <name>] <command\u2026>\n                              one-off command in the runner's copy as the last job left it (no sync)\nExit codes: the command's own; 125 remote-run failed, 124 timeout, 130/143/129 interrupted (SIGINT/SIGTERM/SIGHUP), 137 job killed, 2 bad usage.\nSetup: docs/remote-run.md\n";
+/**
+ * @description The runners as they are right now, for a look in the middle of a command (the wait for an offline runner re-reads them at
+ * every look). A file that is half-way through an edit, or a name that clashes for a moment, must not end a wait that may be 15 minutes
+ * in: the list that last loaded is used. Only when nothing ever loaded does a broken file or registry stop the caller with its errors.
+ * No runner at all is an empty list.
+ */
+export declare function readCurrentRunners(homeDir: string): RunnersConfig;
+/** @description Run the command line (the words after `remote-run`); resolves with the exit code. */
+export declare function runRemoteRunCli(argv: readonly string[], io?: CliIo): Promise<number>;
+//# sourceMappingURL=remoteRunCli.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"remoteRunCli.d.ts","sourceRoot":"","sources":["../../src/remoteRun/remoteRunCli.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,eAAe,EAAE,KAAK,KAAK,EAAE,MAAM,UAAU,CAAC;AAGvD,OAAO,EAAwB,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAM3E;;;;;;;GAOG;AAEH,OAAO,EAAE,eAAe,EAAE,CAAC;AAE3B,eAAO,MAAM,cAAc,mqDAoB1B,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,CAOjE;AAyBD,qGAAqG;AACrG,wBAAsB,eAAe,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,EAAE,GAAE,KAAyB,GAAG,OAAO,CAAC,MAAM,CAAC,CAoC7G"}