@aligndottech/cli 0.48.0 → 0.50.0

package/dist/lib/ask-key-offer.js

@@ -0,0 +1,130 @@
+/**
+ * The AI-provider key, asked for where it is used: `align ask` on a terminal, the first time
+ * it has nothing to write prose with.
+ *
+ * It used to be the last step of the first-run wizard (ALI-1284's guided Groq + Gemini
+ * offer), immediately before align opened the coding agent. Read in that position, a Groq key
+ * looks like something Claude Code needs - it is not. Inside a wrapped agent the agent writes
+ * the prose from the MCP results; the key only serves align's own terminal `align ask`. So the
+ * wizard no longer asks, and this module asks lazily, with the reason stated first.
+ *
+ * Secrets: a key is read through a masked password prompt, stored in the 0600 config file
+ * (config.setProviderKey, the same store as every other saved credential) and never printed -
+ * not in a log line, not in a confirmation. It is never written to process.env either (H1):
+ * local-llm reads saved keys as data on every call, so it is live at once, and a child process
+ * (the coding agent bare `align` opens) cannot inherit it.
+ */
+import * as p from '@clack/prompts';
+import chalk from 'chalk';
+import { listConfiguredCredentials, unusedExportedKeys } from './local-llm.js';
+import { PROVIDER_KEY_URL, PROVIDER_LABEL, STORABLE_PROVIDERS, } from './llm-providers.js';
+import { guardedPrompt } from './prompt-guard.js';
+/** The command that re-opens this choice later. */
+export const CHOOSE_PROVIDER_COMMAND = 'align ai';
+/** Masked paste for one provider. null when nothing usable was entered (or the prompt crashed). */
+async function pasteKey(id) {
+    p.log.info(`Get one: ${chalk.bold(PROVIDER_KEY_URL[id])}`);
+    const key = await guardedPrompt(`${PROVIDER_LABEL[id]} API key`, () => p.password({ message: `  ${PROVIDER_LABEL[id]} API key:` }));
+    if (p.isCancel(key))
+        return key;
+    return typeof key === 'string' && key.trim() ? key.trim() : null;
+}
+/**
+ * "Use a key I already have": pick the provider, paste, save. Returns the provider saved, or
+ * null when the user backed out or pasted nothing.
+ */
+export async function promptForProviderKey(config) {
+    // Keys already exported for a provider align does not use on its own (HF_TOKEN for model
+    // downloads, say) come first: picking one saves only the CHOICE, so the key stays in the
+    // user's shell and is never copied into align's config.
+    const exported = unusedExportedKeys().filter((k) => k.id !== 'custom' && k.id !== 'ollama');
+    const choice = await guardedPrompt('Provider', () => p.select({
+        message: 'Which provider is the key for?',
+        options: [
+            ...exported.map((k) => ({ value: `env:${k.id}`, label: `${PROVIDER_LABEL[k.id]} (found ${k.envVar} in your shell)` })),
+            ...STORABLE_PROVIDERS.map((value) => ({ value, label: PROVIDER_LABEL[value] })),
+        ],
+    }));
+    if (choice === null || p.isCancel(choice) || typeof choice !== 'string')
+        return null;
+    if (choice.startsWith('env:')) {
+        const id = choice.slice(4);
+        config.setLlmPreference({ provider: id });
+        p.log.success(`${chalk.bold('align ask')} now uses ${PROVIDER_LABEL[id]} with the key in your shell.`);
+        return id;
+    }
+    const id = choice;
+    const key = await pasteKey(id);
+    if (key === null || typeof key !== 'string') {
+        if (key === null)
+            p.log.warn('No key entered - nothing saved.');
+        return null;
+    }
+    config.setProviderKey(id, key);
+    p.log.success(`Saved your ${PROVIDER_LABEL[id]} key - ${chalk.bold('align ask')} uses it from now on.`);
+    return id;
+}
+/** "Get a free Groq key": today's guided path, Gemini backup included. */
+async function freeGroqKey(config) {
+    p.log.info(`Groq's free tier needs no card, ever.`);
+    const groq = await pasteKey('groq');
+    if (typeof groq !== 'string') {
+        if (groq === null)
+            p.log.warn('No key entered - nothing saved.');
+        return false;
+    }
+    config.setProviderKey('groq', groq);
+    p.log.success(`Saved - ${chalk.bold('align ask')} will use it on this machine from now on.`);
+    const wantGemini = await p.confirm({
+        message: `Also add a Gemini key as backup for when Groq's daily limit is hit? (also free, no card)`,
+        initialValue: true,
+    });
+    if (p.isCancel(wantGemini) || !wantGemini)
+        return true;
+    const gemini = await pasteKey('gemini');
+    if (typeof gemini === 'string') {
+        config.setProviderKey('gemini', gemini);
+        p.log.success('Saved as backup.');
+    }
+    else if (gemini === null) {
+        p.log.warn('No key entered - skipping the backup.');
+    }
+    return true;
+}
+/**
+ * The first-ask choice. 'configured': a key was saved and is live for the next call - ask again.
+ * 'dismissed': "Not now", remembered so `align ask` stops asking. 'cancelled': backed out
+ * (Ctrl-C, empty paste) - nothing saved, nothing remembered, the list prints as usual.
+ */
+export async function offerAskProviderKey(config) {
+    p.log.info(`${chalk.bold('align ask')} writes answers with an AI model. Inside your coding agent you don't need this - the agent writes them.`);
+    const choice = await guardedPrompt('AI model', () => p.select({
+        message: `To get answers here in the terminal, pick one (change it any time: ${CHOOSE_PROVIDER_COMMAND}):`,
+        options: [
+            { value: 'existing', label: 'Use a key I already have' },
+            { value: 'groq', label: 'Get a free Groq key' },
+            { value: 'later', label: 'Not now - just show matching decisions' },
+        ],
+        initialValue: 'later',
+    }));
+    if (choice === null || p.isCancel(choice))
+        return 'cancelled';
+    if (choice === 'later') {
+        config.setAskKeyOfferDismissed(true);
+        return 'dismissed';
+    }
+    const saved = choice === 'groq' ? await freeGroqKey(config) : (await promptForProviderKey(config)) !== null;
+    return saved ? 'configured' : 'cancelled';
+}
+/**
+ * Every provider `align ask` could use right now, in the default order (exported credentials,
+ * then saved ones, then Ollama). The Ollama check is the same 2s /api/tags probe the ask path
+ * runs, injected so tests never touch the network.
+ */
+export async function detectProviders(probeOllama) {
+    const found = listConfiguredCredentials();
+    if (await probeOllama())
+        found.push({ id: 'ollama', source: 'local' });
+    return found;
+}
+//# sourceMappingURL=ask-key-offer.js.map

package/dist/lib/ask-key-offer.js.map

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

package/dist/lib/backfill-state.d.ts

@@ -0,0 +1,116 @@
+export declare const BACKFILL_STATUS_ENV = "ALIGN_BACKFILL_STATUS";
+export declare const MAX_PER_SOURCE = 1;
+export declare const MAX_TOTAL = 3;
+export interface BackfillStatus {
+    source: string;
+    pid: number;
+    started_at: string;
+    state: 'running' | 'done' | 'failed';
+    finished_at?: string;
+    exit_code?: number;
+    last_line?: string;
+}
+/** Where the state home is, from an explicit environment (the launcher is handed one; tests pass their own). */
+export declare function stateHomeFor(env: Record<string, string | undefined>, home: string, platform: string): string;
+/** `<state home>/align-cli` as a PATH ONLY: nothing is created or checked. For readers (the launch hook) that must not touch the disk. */
+export declare function alignStateDirPath(env: Record<string, string | undefined>, home: string, platform: string): string;
+/**
+ * The directory, created private, or null when anything BELOW the state home is not ours and
+ * private: `align-cli` and `backfill` are each checked with lstat before anything is created
+ * inside them, so a symlink planted at either is refused instead of written through. (The state
+ * home itself is the user's own choice and may legitimately sit behind links, as /var does on macOS.)
+ */
+export declare function backfillDir(): string | null;
+/** `<state home>/align-cli`, created private and checked with lstat (L5: the sync lock and the
+ *  launch summary live beside `backfill/`, and share its refusal of a planted link), or null. */
+export declare function alignStateDir(): string | null;
+export declare function statusPath(dir: string, source: string): string;
+export declare function readStatus(file: string): BackfillStatus | null;
+/** Atomic (write a sibling, rename over): a reader never sees half a file. */
+export declare function writeStatus(file: string, status: BackfillStatus): void;
+/** Is this process alive? EPERM means it exists and is not ours, which is alive. */
+export declare function pidAlive(pid: number): boolean;
+export declare function liveBackfills(dir: string, alive?: (pid: number) => boolean): BackfillStatus[];
+export declare function admit(live: BackfillStatus[], source: string): {
+    ok: true;
+} | {
+    ok: false;
+    reason: 'source' | 'total';
+    running: BackfillStatus[];
+};
+export type Reservation = {
+    ok: true;
+    release(): void;
+} | {
+    ok: false;
+    reason: 'source' | 'total';
+    running: BackfillStatus[];
+}
+/** The state directory could not be used safely, so no slot can be recorded: nothing starts. */
+ | {
+    ok: false;
+    reason: 'state';
+    running: [];
+};
+/**
+ * Take a slot for `source`, SYNCHRONOUSLY (no await anywhere in here). Counts what is running
+ * (status files), what this process has reserved, and what other server processes have reserved
+ * (placeholder `<source>.lock` files made with O_EXCL, so two processes cannot both pass). The
+ * caller releases it once the child is confirmed (its status file then holds the slot) or has
+ * failed to start.
+ */
+export declare function reserveSlot(dir: string, source: string, alive?: (pid: number) => boolean): Reservation;
+/**
+ * How to start `align <argv>` as a child. An npm install runs `node <entry> ...`. A compiled
+ * binary (`bun build --compile`) has a bunfs path in argv[1], which is not a user argument, so
+ * the child is the executable with the arguments directly (alignDistribution() is decided at
+ * build time, not sniffed).
+ */
+export declare function backfillChildCommand(argv: string[], o?: {
+    dist?: 'npm' | 'binary';
+    execPath?: string;
+    argv1?: string | undefined;
+}): {
+    command: string;
+    args: string[];
+};
+/**
+ * Start the child detached and wait up to ~300 ms for the OS to confirm it exists. "Started" is
+ * claimed only on that confirmation: a spawn that fails asynchronously (ENOENT, EMFILE) arrives as
+ * an 'error' event, and stdio is ignored, so nothing else would ever say.
+ */
+/**
+ * Set on a child an agent's tool call starts, so what the child writes can be attributed to the agent (scope-connect.ts `startedByAgent`).
+ * The spawner NAMES its caller: 'mcp' (the default, so existing callers stay as they were) stamps it; 'launcher' (the person's own `align`
+ * launch, a background refresh nobody's agent asked for) does not, and also strips a marker inherited from this process.
+ */
+export type ChildCaller = 'mcp' | 'launcher';
+export declare const STARTED_BY_AGENT_ENV = "ALIGN_STARTED_BY";
+/** The environment a child gets: marked as an agent's only when an agent's tool call started it. */
+export declare function stampCaller(env: Record<string, string | undefined>, caller: ChildCaller): Record<string, string | undefined>;
+export declare function startBackfillChild(source: string, argv: string[], file: string | undefined, cmd?: {
+    command: string;
+    args: string[];
+}, caller?: ChildCaller, 
+/** The environment the child inherits. Defaults to this process's own; the sync launch hook passes a reduced one. */
+baseEnv?: Record<string, string | undefined>, 
+/** Where the child runs (default: here). The sync launcher passes the home folder, so a folder never picks scope for an unattended run. */
+cwd?: string): Promise<{
+    ok: boolean;
+    pid?: number;
+}>;
+export interface ChildTrack {
+    /** The last thing worth knowing about this run; written into the final status. */
+    note(line: string): void;
+    /** Write the final state now (idempotent; also runs at process exit). */
+    finish(code: number): void;
+}
+/**
+ * The child's side. Reads the status path from the environment, but only trusts one inside the
+ * backfill directory: the variable is not a way to make this process overwrite another file.
+ * Writes `running` now and the final state at exit (the exit code, and the last line it noted).
+ * Called at the very top of the entry point (startup-backfill-track.ts) so a run that dies before
+ * any command code - a bad flag, a parse error - still records that it failed. Memoised per file.
+ */
+export declare function trackChildFromEnv(env?: Record<string, string | undefined>): ChildTrack | null;
+//# sourceMappingURL=backfill-state.d.ts.map

package/dist/lib/backfill-state.d.ts.map

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

package/dist/lib/backfill-state.js

@@ -0,0 +1,342 @@
+/**
+ * L3: the on-disk record of `align_backfill` children, so the tool can cap them and `align_sync`
+ * (L5) can find them later. One small JSON file per source under
+ * `$XDG_STATE_HOME/align-cli/backfill/<source>.json` (default ~/.local/state; %LOCALAPPDATA% on
+ * Windows). Written by the parent when the child has started and by the child when it ends.
+ *
+ * Caps: at most one running child per source and three in all. "Running" means the file says so
+ * AND the pid is alive: a child that was killed leaves a file behind, and that must not block
+ * the next backfill. A pid can be reused, so a finished file is never counted as running.
+ */
+import { spawn } from 'node:child_process';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { alignDistribution } from './distribution.js';
+import { readRegularFile } from './sync/safe-read.js';
+import { absoluteXdg } from './xdg.js';
+export const BACKFILL_STATUS_ENV = 'ALIGN_BACKFILL_STATUS';
+export const MAX_PER_SOURCE = 1;
+export const MAX_TOTAL = 3;
+/** How long the parent waits for the OS to confirm the child exists before saying it could not start. */
+const START_CONFIRM_MS = 300;
+/** Where the state home is, from an explicit environment (the launcher is handed one; tests pass their own). */
+export function stateHomeFor(env, home, platform) {
+    const xdg = absoluteXdg(env, 'XDG_STATE_HOME');
+    if (xdg)
+        return xdg;
+    if (platform === 'win32')
+        return env['LOCALAPPDATA'] ?? path.join(home, 'AppData', 'Local');
+    return path.join(home, '.local', 'state');
+}
+function stateHome() {
+    return stateHomeFor(process.env, os.homedir(), process.platform);
+}
+/** `<state home>/align-cli` as a PATH ONLY: nothing is created or checked. For readers (the launch hook) that must not touch the disk. */
+export function alignStateDirPath(env, home, platform) {
+    return path.join(stateHomeFor(env, home, platform), 'align-cli');
+}
+/** One directory of the chain: a real directory (never a link someone planted), ours, private. */
+function ensureOwnPrivateDir(d) {
+    try {
+        let st = fs.lstatSync(d, { throwIfNoEntry: false });
+        if (!st) {
+            fs.mkdirSync(d, { mode: 0o700 });
+            st = fs.lstatSync(d);
+        }
+        if (!st.isDirectory() || st.isSymbolicLink())
+            return false;
+        if (typeof process.getuid === 'function') {
+            if (st.uid !== process.getuid())
+                return false;
+            // Ours but open to the group or the world: tighten it. If that fails, do not trust it.
+            if ((st.mode & 0o077) !== 0)
+                fs.chmodSync(d, 0o700);
+        }
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * The directory, created private, or null when anything BELOW the state home is not ours and
+ * private: `align-cli` and `backfill` are each checked with lstat before anything is created
+ * inside them, so a symlink planted at either is refused instead of written through. (The state
+ * home itself is the user's own choice and may legitimately sit behind links, as /var does on macOS.)
+ */
+export function backfillDir() {
+    try {
+        const base = alignStateDir();
+        if (base === null)
+            return null;
+        const dir = path.join(base, 'backfill');
+        return ensureOwnPrivateDir(dir) ? dir : null;
+    }
+    catch {
+        return null;
+    }
+}
+/** `<state home>/align-cli`, created private and checked with lstat (L5: the sync lock and the
+ *  launch summary live beside `backfill/`, and share its refusal of a planted link), or null. */
+export function alignStateDir() {
+    try {
+        const home = stateHome();
+        fs.mkdirSync(home, { recursive: true });
+        const base = path.join(home, 'align-cli');
+        return ensureOwnPrivateDir(base) ? base : null;
+    }
+    catch {
+        return null;
+    }
+}
+export function statusPath(dir, source) {
+    return path.join(dir, `${source}.json`);
+}
+export function readStatus(file) {
+    try {
+        const text = readRegularFile(file, 65_536);
+        if (text === undefined)
+            return null;
+        const raw = JSON.parse(text);
+        if (typeof raw.source !== 'string' || !Number.isInteger(raw.pid) || typeof raw.started_at !== 'string')
+            return null;
+        if (raw.state !== 'running' && raw.state !== 'done' && raw.state !== 'failed')
+            return null;
+        return raw;
+    }
+    catch {
+        return null;
+    }
+}
+/** Atomic (write a sibling, rename over): a reader never sees half a file. */
+export function writeStatus(file, status) {
+    const tmp = `${file}.${process.pid}.tmp`;
+    fs.writeFileSync(tmp, JSON.stringify(status), { mode: 0o600 });
+    fs.renameSync(tmp, file);
+}
+/** Is this process alive? EPERM means it exists and is not ours, which is alive. */
+export function pidAlive(pid) {
+    if (!Number.isInteger(pid) || pid <= 0)
+        return false;
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (e) {
+        return e.code === 'EPERM';
+    }
+}
+/** A "running" file older than this is a leftover (SIGKILL, OOM, reboot), whatever its pid says now:
+ *  pids are reused, and a backfill that has run for a day is not running. */
+const STALE_RUNNING_MS = 24 * 3_600_000;
+export function liveBackfills(dir, alive = pidAlive) {
+    let names;
+    try {
+        names = fs.readdirSync(dir).filter((n) => n.endsWith('.json'));
+    }
+    catch {
+        return [];
+    }
+    return names
+        .map((n) => readStatus(path.join(dir, n)))
+        .filter((s) => s !== null && s.state === 'running' && !isStale(s) && alive(s.pid));
+}
+function isStale(s) {
+    const started = Date.parse(s.started_at);
+    return Number.isNaN(started) || Date.now() - started > STALE_RUNNING_MS;
+}
+export function admit(live, source) {
+    const same = live.filter((s) => s.source === source);
+    if (same.length >= MAX_PER_SOURCE)
+        return { ok: false, reason: 'source', running: same };
+    if (live.length >= MAX_TOTAL)
+        return { ok: false, reason: 'total', running: live };
+    return { ok: true };
+}
+/** Sources whose slot THIS process has taken and not yet handed over to a status file. MCP does not
+ *  queue requests, so five tool calls can be in flight at once; the check and the take happen in
+ *  one synchronous stretch, before any await, or all five pass. */
+const reservedHere = new Set();
+/** A placeholder older than this, or whose process is gone, is a leftover. */
+const LOCK_FRESH_MS = 60_000;
+function lockHolderActive(file, alive) {
+    try {
+        const raw = JSON.parse(fs.readFileSync(file, 'utf8'));
+        return typeof raw.pid === 'number' && typeof raw.at === 'number' && Date.now() - raw.at < LOCK_FRESH_MS && alive(raw.pid);
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Take a slot for `source`, SYNCHRONOUSLY (no await anywhere in here). Counts what is running
+ * (status files), what this process has reserved, and what other server processes have reserved
+ * (placeholder `<source>.lock` files made with O_EXCL, so two processes cannot both pass). The
+ * caller releases it once the child is confirmed (its status file then holds the slot) or has
+ * failed to start.
+ */
+export function reserveSlot(dir, source, alive = pidAlive) {
+    const lock = path.join(dir, `${source}.lock`);
+    const held = new Map();
+    for (const s of liveBackfills(dir, alive))
+        held.set(s.source, s);
+    for (const r of reservedHere)
+        held.set(r, held.get(r) ?? { source: r, pid: process.pid, started_at: new Date().toISOString(), state: 'running' });
+    try {
+        for (const n of fs.readdirSync(dir)) {
+            if (!n.endsWith('.lock'))
+                continue;
+            const src = n.slice(0, -'.lock'.length);
+            if (lockHolderActive(path.join(dir, n), alive))
+                held.set(src, held.get(src) ?? { source: src, pid: 0, started_at: new Date().toISOString(), state: 'running' });
+        }
+    }
+    catch { /* an unreadable directory counts as empty; the exclusive create below still decides */ }
+    const admission = admit([...held.values()], source);
+    if (!admission.ok)
+        return admission;
+    const take = () => {
+        try {
+            fs.writeFileSync(lock, JSON.stringify({ pid: process.pid, at: Date.now() }), { flag: 'wx', mode: 0o600 });
+            return true;
+        }
+        catch (e) {
+            if (e.code !== 'EEXIST')
+                return true; // cannot make the file: the in-process set still holds
+            return false;
+        }
+    };
+    if (!take()) {
+        if (lockHolderActive(lock, alive))
+            return { ok: false, reason: 'source', running: [held.get(source) ?? { source, pid: 0, started_at: new Date().toISOString(), state: 'running' }] };
+        try {
+            fs.unlinkSync(lock);
+        }
+        catch { /* raced with another process's cleanup */ }
+        if (!take())
+            return { ok: false, reason: 'source', running: [] };
+    }
+    reservedHere.add(source);
+    return {
+        ok: true,
+        release: () => {
+            reservedHere.delete(source);
+            try {
+                fs.unlinkSync(lock);
+            }
+            catch { /* already gone */ }
+        },
+    };
+}
+/**
+ * How to start `align <argv>` as a child. An npm install runs `node <entry> ...`. A compiled
+ * binary (`bun build --compile`) has a bunfs path in argv[1], which is not a user argument, so
+ * the child is the executable with the arguments directly (alignDistribution() is decided at
+ * build time, not sniffed).
+ */
+export function backfillChildCommand(argv, o = {}) {
+    const dist = o.dist ?? alignDistribution();
+    const execPath = o.execPath ?? process.execPath;
+    if (dist === 'binary')
+        return { command: execPath, args: argv };
+    const argv1 = 'argv1' in o ? o.argv1 : process.argv[1];
+    return { command: execPath, args: [argv1 ?? 'align', ...argv] };
+}
+function withoutStatusEnv(env) {
+    const { [BACKFILL_STATUS_ENV]: _drop, ...rest } = env;
+    return rest;
+}
+export const STARTED_BY_AGENT_ENV = 'ALIGN_STARTED_BY';
+/** The environment a child gets: marked as an agent's only when an agent's tool call started it. */
+export function stampCaller(env, caller) {
+    const { [STARTED_BY_AGENT_ENV]: _drop, ...rest } = env;
+    return caller === 'mcp' ? { ...rest, [STARTED_BY_AGENT_ENV]: 'mcp' } : rest;
+}
+export function startBackfillChild(source, argv, file, cmd = backfillChildCommand(argv), caller = 'mcp', 
+/** The environment the child inherits. Defaults to this process's own; the sync launch hook passes a reduced one. */
+baseEnv = process.env, 
+/** Where the child runs (default: here). The sync launcher passes the home folder, so a folder never picks scope for an unattended run. */
+cwd) {
+    const { command, args } = cmd;
+    return new Promise((resolve) => {
+        let settled = false;
+        const done = (r) => { if (!settled) {
+            settled = true;
+            resolve(r);
+        } };
+        let child;
+        try {
+            child = spawn(command, args, {
+                detached: true,
+                stdio: 'ignore',
+                windowsHide: true,
+                // L5: a sync child has no status file (the sync lock and source_sync record it), so it must
+                // not inherit one from this process either.
+                ...(cwd !== undefined ? { cwd } : {}),
+                env: stampCaller(file === undefined ? withoutStatusEnv(baseEnv) : { ...baseEnv, [BACKFILL_STATUS_ENV]: file }, caller),
+            });
+        }
+        catch {
+            return done({ ok: false });
+        }
+        const confirm = () => {
+            const pid = child.pid;
+            if (pid === undefined)
+                return done({ ok: false });
+            try {
+                if (file !== undefined)
+                    writeStatus(file, { source, pid, started_at: new Date().toISOString(), state: 'running' });
+            }
+            catch { /* the child still runs; only the cap loses sight of it */ }
+            child.unref();
+            done({ ok: true, pid });
+        };
+        child.on('error', () => done({ ok: false }));
+        child.on('spawn', confirm);
+        setTimeout(() => { if (!settled)
+            (child.pid !== undefined ? confirm : () => done({ ok: false }))(); }, START_CONFIRM_MS).unref();
+    });
+}
+const tracks = new Map();
+/**
+ * The child's side. Reads the status path from the environment, but only trusts one inside the
+ * backfill directory: the variable is not a way to make this process overwrite another file.
+ * Writes `running` now and the final state at exit (the exit code, and the last line it noted).
+ * Called at the very top of the entry point (startup-backfill-track.ts) so a run that dies before
+ * any command code - a bad flag, a parse error - still records that it failed. Memoised per file.
+ */
+export function trackChildFromEnv(env = process.env) {
+    const file = env[BACKFILL_STATUS_ENV];
+    const dir = backfillDir();
+    if (!file || !dir)
+        return null;
+    if (path.resolve(path.dirname(file)) !== path.resolve(dir) || !file.endsWith('.json'))
+        return null;
+    const known = tracks.get(file);
+    if (known)
+        return known;
+    const source = path.basename(file, '.json');
+    const started_at = readStatus(file)?.started_at ?? new Date().toISOString();
+    let last;
+    try {
+        writeStatus(file, { source, pid: process.pid, started_at, state: 'running' });
+    }
+    catch {
+        return null;
+    }
+    const finish = (code) => {
+        try {
+            writeStatus(file, {
+                source, pid: process.pid, started_at, state: code === 0 ? 'done' : 'failed',
+                finished_at: new Date().toISOString(), exit_code: code, ...(last !== undefined ? { last_line: last.slice(0, 200) } : {}),
+            });
+        }
+        catch { /* nothing to report to */ }
+    };
+    process.on('exit', (code) => finish(code));
+    const track = { note: (line) => { last = line; }, finish };
+    tracks.set(file, track);
+    return track;
+}
+//# sourceMappingURL=backfill-state.js.map

package/dist/lib/backfill-state.js.map

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

package/dist/lib/backup-copy.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Copy rows into a `*_backup` table by column NAME, never by position.
+ *
+ * The backup tables (`decisions_merged_backup`, `decisions_purged_backup`, ...) are created with
+ * `CREATE TABLE ... AS SELECT * ... WHERE 0`, so they carry the columns their source had on the day
+ * of the migration. A later migration that adds a column to `decisions` would make a positional
+ * `INSERT INTO backup SELECT * FROM decisions` fail ("table has N columns but M values were
+ * supplied") on every purge and on EVERY ingest that folds a twin. Naming the columns keeps both
+ * working; the columns the backup lacks are then the only thing not backed up, and
+ * backup-copy.test.ts fails the build when that set is not empty, so the migration that adds the
+ * column must add it to the backup table too.
+ */
+import type { DatabaseSync } from 'node:sqlite';
+/** The columns both tables have, in the backup table's order. */
+export declare function sharedColumns(db: DatabaseSync, source: string, backup: string): string[];
+export declare function copyRowsToBackup(db: DatabaseSync, source: string, backup: string, keyColumn: string, key: string): void;
+//# sourceMappingURL=backup-copy.d.ts.map

package/dist/lib/backup-copy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup-copy.d.ts","sourceRoot":"","sources":["../../src/lib/backup-copy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAMhD,iEAAiE;AACjE,wBAAgB,aAAa,CAAC,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAGxF;AAED,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAGvH"}