@nonameolsson/nightjar 0.0.0-stage → 0.2.0

package/dist/ledger.js

@@ -0,0 +1,49 @@
+// .factory/runs.jsonl: one line per session with its cost, from which the day's spend is added up.
+import { appendFileSync, mkdirSync, readFileSync } from 'node:fs';
+import { dirname } from 'node:path';
+import { z } from 'zod';
+const EntrySchema = z.looseObject({
+    at: z.string(),
+    repo: z.string(),
+    // a number in a line written before ids were strings
+    feature: z.union([z.string(), z.int()]),
+    ticket: z.union([z.string(), z.int()]).nullable(),
+    branch: z.string(),
+    step: z.enum(['build', 'fix', 'review', 'step']),
+    session: z.string(),
+    costUsd: z.number(),
+    outcome: z.string()
+});
+export function record(path, entry) {
+    mkdirSync(dirname(path), { recursive: true });
+    appendFileSync(path, `${JSON.stringify(entry)}\n`);
+}
+const localDay = (d) => `${String(d.getFullYear())}-${String(d.getMonth() + 1)}-${String(d.getDate())}`;
+// The estimated dollars spent on the local day of `now`. A line that does not parse counts nothing.
+export function spentOn(path, now) {
+    let text;
+    try {
+        text = readFileSync(path, 'utf8');
+    }
+    catch {
+        return 0;
+    }
+    const day = localDay(now);
+    let sum = 0;
+    for (const line of text.split('\n')) {
+        if (line.trim() === '')
+            continue;
+        let value;
+        try {
+            value = JSON.parse(line);
+        }
+        catch {
+            continue;
+        }
+        const entry = EntrySchema.safeParse(value);
+        if (entry.success && localDay(new Date(entry.data.at)) === day)
+            sum += entry.data.costUsd;
+    }
+    return sum;
+}
+//# sourceMappingURL=ledger.js.map

package/dist/ledger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ledger.js","sourceRoot":"","sources":["../src/ledger.ts"],"names":[],"mappings":"AAAA,mGAAmG;AACnG,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAClE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,WAAW,GAAG,CAAC,CAAC,WAAW,CAAC;IACjC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,qDAAqD;IACrD,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;IACvC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE;IACjD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IAChD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;CACnB,CAAC,CAAC;AAcH,MAAM,UAAU,MAAM,CAAC,IAAY,EAAE,KAAY;IAChD,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,cAAc,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,QAAQ,GAAG,CAAC,CAAO,EAAE,EAAE,CAC5B,GAAG,MAAM,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;AAEjF,oGAAoG;AACpG,MAAM,UAAU,OAAO,CAAC,IAAY,EAAE,GAAS;IAC9C,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC;QACJ,IAAI,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,CAAC,CAAC;IACV,CAAC;IACD,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC1B,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACrC,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE;YAAE,SAAS;QACjC,IAAI,KAAc,CAAC;QACnB,IAAI,CAAC;YACJ,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;QAAC,MAAM,CAAC;YACR,SAAS;QACV,CAAC;QACD,MAAM,KAAK,GAAG,WAAW,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAC3C,IAAI,KAAK,CAAC,OAAO,IAAI,QAAQ,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,KAAK,GAAG;YAAE,GAAG,IAAI,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC;IAC3F,CAAC;IACD,OAAO,GAAG,CAAC;AACZ,CAAC"}

package/dist/main.d.ts

@@ -0,0 +1,11 @@
+import type { AzureDevOpsRequest } from './azure-devops/index.js';
+import type { Ask } from './ask.js';
+import type { Env } from './git.js';
+export interface Host {
+    readonly platform: NodeJS.Platform;
+    readonly env: Env;
+    readonly cwd: string;
+    readonly request?: AzureDevOpsRequest;
+    readonly ask?: Ask;
+}
+export declare function runNightjar(argv: readonly string[], given?: Partial<Host>): Promise<number>;

package/dist/main.js

@@ -0,0 +1,215 @@
+// The `nightjar` command.
+import { spawn } from 'node:child_process';
+import { randomUUID } from 'node:crypto';
+import { homedir } from 'node:os';
+import { parseArgs, platformProblem, USAGE } from './args.js';
+import { buildFeature, ledgerPath, LIMITS } from './build.js';
+import { runCheck } from './check.js';
+import { checkMachine, Refusal } from './checks.js';
+import { runDoctor } from './doctor.js';
+import { runInitCommand } from './init.js';
+import { runContractCommand } from './contract/command.js';
+import { runCreateCommand } from './create.js';
+import { ConfigError } from './config.js';
+import { claimPorts, portEnv } from './ports.js';
+import { buildOne, cannotClaim, handBack, queue } from './queue.js';
+import { runSession } from './session.js';
+import { startServe } from './serve.js';
+import { StatusFile, statusPath } from './status.js';
+import { worktreesFor } from './worktree.js';
+import { say, why } from './say.js';
+const sleep = (ms, signal) => new Promise((done) => {
+    const timer = setTimeout(done, ms);
+    signal?.addEventListener('abort', () => {
+        clearTimeout(timer);
+        done();
+    }, { once: true });
+});
+// The checks of a build stop at the first that fails, and the machine's findings are said in one line.
+async function preflight(args, host) {
+    const checked = await checkMachine({
+        useApiKey: args.useApiKey,
+        ...(args.profile === undefined ? {} : { profile: args.profile }),
+        env: host.env,
+        cwd: host.cwd,
+        failFast: true,
+        ...(host.request === undefined ? {} : { request: host.request })
+    });
+    const failed = checked.lines.find((l) => l.status === 'fail' && l.only === undefined);
+    if (failed !== undefined)
+        throw new Refusal(failed.detail);
+    if (checked.ready === null)
+        throw new Refusal('the checks did not finish');
+    const { adapters, me } = checked.ready;
+    say(`${adapters.repo}, as ${me}, on ${checked.ready.login ?? 'ANTHROPIC_API_KEY'}`);
+    for (const l of checked.lines) {
+        if (l.status === 'fail')
+            say(`${l.name} cannot run: ${l.detail}`);
+    }
+    const found = checked.lines.flatMap((l) => (l.summary === null ? [] : [l.summary]));
+    say(`checked: ${found.join(', ')}`);
+    const { assignee, person } = checked.ready;
+    if (assignee !== me)
+        say(`building the Features assigned to ${assignee}`);
+    if (person.dailyUsd !== LIMITS.dailyUsd)
+        say(`daily limit $${String(person.dailyUsd)}`);
+    return checked.ready;
+}
+export async function runNightjar(argv, given = {}) {
+    const host = {
+        platform: process.platform,
+        env: process.env,
+        cwd: process.cwd(),
+        ...given
+    };
+    const unsupported = platformProblem(host.platform);
+    if (unsupported !== null) {
+        console.error(`nightjar: ${unsupported}`);
+        return 2;
+    }
+    if (argv.length === 1 && ['--help', '-h', 'help'].includes(argv[0] ?? '')) {
+        console.log(USAGE);
+        return 0;
+    }
+    if (argv[0] === 'init')
+        return runInitCommand(argv.slice(1), host);
+    if (argv[0] === 'contract')
+        return runContractCommand(argv.slice(1));
+    if (argv[0] === 'create')
+        return runCreateCommand(argv.slice(1));
+    const args = parseArgs(argv);
+    if (typeof args === 'string') {
+        console.error(`nightjar: ${args}\n\n${USAGE}`);
+        return 2;
+    }
+    const env = { ...host.env, GIT_TERMINAL_PROMPT: '0' };
+    if (args.mode === 'doctor') {
+        const { cwd, request } = host;
+        return runDoctor({
+            useApiKey: args.useApiKey,
+            ...(args.profile === undefined ? {} : { profile: args.profile }),
+            env,
+            cwd,
+            ...(request ? { request } : {})
+        });
+    }
+    let ready;
+    try {
+        ready = await preflight(args, { ...host, env });
+    }
+    catch (fault) {
+        if (!(fault instanceof Refusal) && !(fault instanceof ConfigError))
+            throw fault;
+        console.error(`nightjar: ${fault.message}`);
+        return 2;
+    }
+    const { root, config, adapters } = ready;
+    const status = new StatusFile({
+        path: statusPath(root),
+        ledger: ledgerPath(root),
+        now: () => new Date(),
+        pid: process.pid,
+        dailyUsd: ready.person.dailyUsd
+    });
+    // the reserved ports are held until the process ends, whatever ends it
+    const claim = config.ports === undefined ? null : await claimPorts({ count: config.ports.count });
+    if (config.ports !== undefined) {
+        if (claim === null) {
+            console.error(`nightjar: no ${String(config.ports.count)} free, unclaimed ports to reserve; stop another run or lower ports.count in factory.json.`);
+            return 2;
+        }
+        process.once('exit', () => claim.release());
+        say(`ports ${String(claim.port)} to ${String(claim.port + config.ports.count - 1)}`);
+    }
+    const stop = new AbortController();
+    const deps = {
+        tracker: adapters.tracker,
+        codeHost: adapters.codeHost,
+        session: (req) => runSession(req),
+        runCheck,
+        runSetup: runCheck,
+        serve: startServe,
+        now: () => new Date(),
+        newId: () => randomUUID(),
+        say,
+        status
+    };
+    const setup = {
+        root,
+        repo: adapters.repo,
+        worktrees: worktreesFor(homedir(), root),
+        baseBranch: ready.baseBranch,
+        check: config.check,
+        allowedCommands: config.allowedCommands,
+        ...(ready.rules === null ? {} : { rules: ready.rules }),
+        defaults: { model: config.model, effort: config.effort },
+        review: config.review,
+        ...(config.setup === undefined ? {} : { setupCommand: config.setup }),
+        ...(config.workflows === undefined ? {} : { workflows: config.workflows }),
+        ...(config.defaultWorkflow === undefined ? {} : { defaultWorkflow: config.defaultWorkflow }),
+        brokenWorkflows: ready.workflowProblems,
+        ...(config.ports === undefined || claim === null
+            ? {}
+            : { portEnv: portEnv(claim.port, config.ports.env) }),
+        allowApiKey: args.useApiKey,
+        env: ready.env,
+        ...(args.model === undefined ? {} : { model: args.model }),
+        ...(args.effort === undefined ? {} : { effort: args.effort }),
+        limits: { ...LIMITS, dailyUsd: ready.person.dailyUsd },
+        signal: stop.signal
+    };
+    // the Feature being built, so a fault that escapes every catch can still hand it back
+    let building = null;
+    const queueDeps = {
+        tracker: adapters.tracker,
+        person: ready.assignee,
+        build: async (id) => {
+            building = id;
+            try {
+                return await buildFeature(deps, setup, id);
+            }
+            finally {
+                building = null;
+            }
+        },
+        status,
+        now: () => new Date(),
+        say,
+        sleep,
+        signal: stop.signal
+    };
+    process.once('exit', () => status.doing({ kind: 'off' }));
+    // keep a Mac awake, so a long run is not put to sleep and a signing agent stays unlocked
+    if (process.platform === 'darwin') {
+        const awake = spawn('caffeinate', ['-di', '-w', String(process.pid)], { stdio: 'ignore' });
+        awake.on('error', () => undefined);
+    }
+    process.on('SIGINT', () => {
+        if (stop.signal.aborted)
+            process.exit(130);
+        say('stopping: the running session ends and its Ticket goes back; Ctrl-C again to quit at once');
+        stop.abort();
+    });
+    process.once('SIGTERM', () => stop.abort());
+    process.once('uncaughtException', (fault) => {
+        const now = building;
+        void (now === null ? Promise.resolve() : handBack(queueDeps, now, fault)).finally(() => process.exit(1));
+    });
+    if (args.mode === 'feature' && args.feature !== undefined) {
+        let refusal;
+        try {
+            refusal = await cannotClaim(queueDeps, args.feature);
+        }
+        catch (fault) {
+            refusal = why(fault);
+        }
+        if (refusal !== null) {
+            console.error(`nightjar: ${refusal}`);
+            return 2;
+        }
+        const outcome = await buildOne(queueDeps, args.feature);
+        return outcome?.kind === 'pull' || outcome?.kind === 'nothing' ? 0 : 1;
+    }
+    return queue(queueDeps, args.mode === 'once');
+}
+//# sourceMappingURL=main.js.map

package/dist/main.js.map

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

package/dist/person-config.d.ts

@@ -0,0 +1,9 @@
+import type { Env } from './git.js';
+export declare const DEFAULT_DAILY_USD = 60;
+export interface PersonConfig {
+    readonly dailyUsd: number;
+    readonly assignee?: string;
+    readonly profile?: string;
+}
+export declare function personConfigPath(env: Env): string;
+export declare function loadPersonConfig(env: Env): PersonConfig;

package/dist/person-config.js

@@ -0,0 +1,46 @@
+// ~/.config/nightjar/config.json: one person's own settings, which no repo's factory.json may set.
+import { readFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { z } from 'zod';
+import { ConfigError, where } from './config.js';
+import { why } from './say.js';
+export const DEFAULT_DAILY_USD = 60;
+const PersonConfigSchema = z.strictObject({
+    dailyUsd: z.number().positive('a dollar amount above 0').optional(),
+    assignee: z.string().regex(/\S/, 'a login on the Tracker').optional(),
+    profile: z.string().regex(/\S/, 'a Claude profile: a name, a path, or default').optional()
+});
+export function personConfigPath(env) {
+    const base = env.XDG_CONFIG_HOME || join(env.HOME ?? homedir(), '.config');
+    return join(base, 'nightjar', 'config.json');
+}
+// The person's settings, the defaults where the file is missing or silent, or a ConfigError naming each wrong field.
+export function loadPersonConfig(env) {
+    const path = personConfigPath(env);
+    let text;
+    try {
+        text = readFileSync(path, 'utf8');
+    }
+    catch {
+        return { dailyUsd: DEFAULT_DAILY_USD };
+    }
+    let value;
+    try {
+        value = JSON.parse(text);
+    }
+    catch (fault) {
+        throw new ConfigError(`${path} is not JSON: ${why(fault)}`);
+    }
+    const parsed = PersonConfigSchema.safeParse(value);
+    if (!parsed.success) {
+        throw new ConfigError(parsed.error.issues.map((i) => `${path}: ${where(i.path)}${i.message}`).join('\n'));
+    }
+    const { dailyUsd = DEFAULT_DAILY_USD, assignee, profile } = parsed.data;
+    return {
+        dailyUsd,
+        ...(assignee === undefined ? {} : { assignee }),
+        ...(profile === undefined ? {} : { profile })
+    };
+}
+//# sourceMappingURL=person-config.js.map

package/dist/person-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"person-config.js","sourceRoot":"","sources":["../src/person-config.ts"],"names":[],"mappings":"AAAA,mGAAmG;AACnG,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEjD,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAE/B,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAEpC,MAAM,kBAAkB,GAAG,CAAC,CAAC,YAAY,CAAC;IACzC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC,CAAC,QAAQ,EAAE;IACnE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,wBAAwB,CAAC,CAAC,QAAQ,EAAE;IACrE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,8CAA8C,CAAC,CAAC,QAAQ,EAAE;CAC1F,CAAC,CAAC;AAWH,MAAM,UAAU,gBAAgB,CAAC,GAAQ;IACxC,MAAM,IAAI,GAAG,GAAG,CAAC,eAAe,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;IAC3E,OAAO,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,aAAa,CAAC,CAAC;AAC9C,CAAC;AAED,qHAAqH;AACrH,MAAM,UAAU,gBAAgB,CAAC,GAAQ;IACxC,MAAM,IAAI,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;IACnC,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC;QACJ,IAAI,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IACxC,CAAC;IACD,IAAI,KAAc,CAAC;IACnB,IAAI,CAAC;QACJ,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,MAAM,IAAI,WAAW,CAAC,GAAG,IAAI,iBAAiB,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC7D,CAAC;IACD,MAAM,MAAM,GAAG,kBAAkB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACnD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACrB,MAAM,IAAI,WAAW,CACpB,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAClF,CAAC;IACH,CAAC;IACD,MAAM,EAAE,QAAQ,GAAG,iBAAiB,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC;IACxE,OAAO;QACN,QAAQ;QACR,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC;QAC/C,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC;KAC7C,CAAC;AACH,CAAC"}

package/dist/plan.d.ts

@@ -0,0 +1,9 @@
+import type { ItemId, Ticket } from './tracker.js';
+export declare function nextTicket(tickets: readonly Ticket[], built: ReadonlySet<ItemId>): Ticket | null;
+export interface Waiting {
+    readonly id: ItemId;
+    readonly title: string;
+    readonly why: string;
+    readonly blocker?: ItemId;
+}
+export declare function waiting(tickets: readonly Ticket[], built: ReadonlySet<ItemId>): Waiting[];

package/dist/plan.js

@@ -0,0 +1,27 @@
+const unblocked = (ticket, built) => ticket.blockedBy.every((b) => !b.open || built.has(b.id));
+const buildable = (ticket, built) => ticket.open &&
+    !built.has(ticket.id) &&
+    ticket.signals.includes('ready') &&
+    unblocked(ticket, built);
+export function nextTicket(tickets, built) {
+    return tickets.find((t) => buildable(t, built)) ?? null;
+}
+// The open Tickets a run leaves unbuilt, for the pull request and the Feature's comment.
+export function waiting(tickets, built) {
+    return tickets
+        .filter((t) => t.open && !built.has(t.id))
+        .map((t) => ({ id: t.id, title: t.title, ...whyWaiting(t, built) }));
+}
+function whyWaiting(ticket, built) {
+    if (ticket.signals.includes('human'))
+        return { why: 'needs a person' };
+    if (ticket.signals.includes('needsInfo'))
+        return { why: 'needs info' };
+    const blocker = ticket.blockedBy.find((b) => b.open && !built.has(b.id));
+    if (blocker)
+        return { why: 'blocked by', blocker: blocker.id };
+    if (!ticket.signals.includes('ready'))
+        return { why: 'not marked ready' };
+    return { why: 'not reached' };
+}
+//# sourceMappingURL=plan.js.map

package/dist/plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.js","sourceRoot":"","sources":["../src/plan.ts"],"names":[],"mappings":"AAGA,MAAM,SAAS,GAAG,CAAC,MAAc,EAAE,KAA0B,EAAE,EAAE,CAChE,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAE3D,MAAM,SAAS,GAAG,CAAC,MAAc,EAAE,KAA0B,EAAE,EAAE,CAChE,MAAM,CAAC,IAAI;IACX,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;IACrB,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;IAChC,SAAS,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAE1B,MAAM,UAAU,UAAU,CAAC,OAA0B,EAAE,KAA0B;IAChF,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,IAAI,CAAC;AACzD,CAAC;AAUD,yFAAyF;AACzF,MAAM,UAAU,OAAO,CAAC,OAA0B,EAAE,KAA0B;IAC7E,OAAO,OAAO;SACZ,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;SACzC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,GAAG,UAAU,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;AACvE,CAAC;AAED,SAAS,UAAU,CAAC,MAAc,EAAE,KAA0B;IAC7D,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,EAAE,GAAG,EAAE,gBAAgB,EAAE,CAAC;IACvE,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC;QAAE,OAAO,EAAE,GAAG,EAAE,YAAY,EAAE,CAAC;IACvE,MAAM,OAAO,GAAG,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACzE,IAAI,OAAO;QAAE,OAAO,EAAE,GAAG,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC;IAC/D,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,EAAE,GAAG,EAAE,kBAAkB,EAAE,CAAC;IAC1E,OAAO,EAAE,GAAG,EAAE,aAAa,EAAE,CAAC;AAC/B,CAAC"}

package/dist/ports.d.ts

@@ -0,0 +1,16 @@
+export declare const FIRST_PORT = 4477;
+export declare const LAST_PORT = 5476;
+export declare const defaultLocks: () => string;
+export declare function portFree(port: number): Promise<boolean>;
+export interface PortClaim {
+    readonly port: number;
+    release(): void;
+}
+export interface ClaimOptions {
+    readonly count: number;
+    readonly locks?: string;
+    readonly pid?: number;
+    readonly free?: (port: number) => Promise<boolean>;
+}
+export declare function portEnv(first: number, names: readonly string[]): Record<string, string>;
+export declare function claimPorts(options: ClaimOptions): Promise<PortClaim | null>;

package/dist/ports.js

@@ -0,0 +1,104 @@
+// Tests listen on a run's ports only while they run, so a free port is not enough: each port has a lock file holding the owner's pid.
+import { mkdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import { createServer } from 'node:net';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+// clear of the ports dev servers and test runners commonly default to
+export const FIRST_PORT = 4477;
+export const LAST_PORT = 5476;
+export const defaultLocks = () => join(tmpdir(), 'nightjar-ports');
+const alive = (pid) => {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+};
+const holder = (file) => {
+    try {
+        const pid = Number(readFileSync(file, 'utf8').trim());
+        return Number.isInteger(pid) && pid > 0 ? pid : null;
+    }
+    catch {
+        return null;
+    }
+};
+export function portFree(port) {
+    return new Promise((done) => {
+        const server = createServer();
+        server.once('error', () => done(false));
+        server.listen(port, '127.0.0.1', () => server.close(() => done(true)));
+    });
+}
+const pause = (ms) => new Promise((r) => setTimeout(r, ms));
+// The environment variables that hand a run its ports: the first port to the first name, and so on.
+export function portEnv(first, names) {
+    return Object.fromEntries(names.map((name, i) => [name, String(first + i)]));
+}
+// The first block of `count` ports that no live run holds and nothing listens on, or null.
+export async function claimPorts(options) {
+    const { count } = options;
+    const locks = options.locks ?? defaultLocks();
+    const pid = options.pid ?? process.pid;
+    const free = options.free ?? portFree;
+    mkdirSync(locks, { recursive: true });
+    // one picker at a time (mkdir is atomic), so two runs never both read a block as free
+    const picking = join(locks, '.picking');
+    for (let waited = 0;; waited += 1) {
+        try {
+            mkdirSync(picking);
+            break;
+        }
+        catch {
+            const held = holder(join(picking, 'pid'));
+            if ((held !== null && !alive(held)) || (held === null && waited >= 50)) {
+                rmSync(picking, { recursive: true, force: true });
+                continue;
+            }
+            if (waited >= 1200)
+                return null;
+            await pause(100);
+        }
+    }
+    writeFileSync(join(picking, 'pid'), String(pid));
+    try {
+        for (let first = FIRST_PORT; first + count - 1 <= LAST_PORT; first += count) {
+            const ports = Array.from({ length: count }, (_, i) => first + i);
+            // a lock per port, so blocks of different counts on one machine never overlap
+            const taken = ports.some((port) => {
+                const held = holder(join(locks, String(port)));
+                return held !== null && held !== pid && alive(held);
+            });
+            if (taken)
+                continue;
+            let all = true;
+            for (const port of ports) {
+                all = await free(port);
+                if (!all)
+                    break;
+            }
+            if (!all)
+                continue;
+            for (const port of ports)
+                writeFileSync(join(locks, String(port)), String(pid));
+            return {
+                port: first,
+                // removes a lock only while it is still this run's
+                release: () => {
+                    for (const port of ports) {
+                        const lock = join(locks, String(port));
+                        if (holder(lock) === pid)
+                            rmSync(lock, { force: true });
+                    }
+                }
+            };
+        }
+        return null;
+    }
+    finally {
+        rmSync(picking, { recursive: true, force: true });
+    }
+}
+//# sourceMappingURL=ports.js.map

package/dist/ports.js.map

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