@schema-weaver/pg-connector 0.0.0-stage → 2.0.0

package/dist/esm/cli/ui/table.js

@@ -0,0 +1,156 @@
+import { C, alignAnsi, stripAnsi, truncateAnsi, visibleLength } from './colors';
+import { S } from './symbols';
+import { terminalWidth } from './terminal';
+export function renderTable(rows, opts) {
+    if (rows.length === 0)
+        return '';
+    const maxWidth = Math.max(24, opts.maxWidth ?? terminalWidth());
+    const columns = opts.columns.map((col, index) => ({ col, index }));
+    const metas = columns.map(({ col, index }) => buildMeta(rows, col, index));
+    const fitted = fitColumns(metas, maxWidth);
+    if (opts.cardWhenNarrow !== false && (maxWidth < 52 || fitted.length <= 1)) {
+        return renderCards(rows, opts.columns, opts);
+    }
+    const tableWidth = widthFor(fitted);
+    if (tableWidth > maxWidth) {
+        return renderCards(rows, opts.columns, opts);
+    }
+    return renderGrid(rows, fitted, opts);
+}
+function buildMeta(rows, col, index) {
+    const headerLen = visibleLength(col.header);
+    const dataMax = Math.max(0, ...rows.map((row) => visibleLength(formatValue(row, col))));
+    const natural = Math.max(headerLen, dataMax, col.key.length);
+    const cappedNatural = col.maxWidth ? Math.min(natural, col.maxWidth) : natural;
+    const preferred = Math.max(col.width ?? 0, col.minWidth ?? 0, cappedNatural, headerLen);
+    const requestedMin = col.minWidth ?? Math.max(3, headerLen || 3);
+    const hardMin = Math.max(3, Math.min(requestedMin, preferred));
+    return {
+        col,
+        index,
+        preferred,
+        min: hardMin,
+        width: preferred,
+    };
+}
+function fitColumns(metas, maxWidth) {
+    let active = metas.map((meta) => ({ ...meta }));
+    if (widthFor(active) <= maxWidth) {
+        return active;
+    }
+    while (active.length > 2 && minWidthFor(active) > maxWidth) {
+        const removable = [...active]
+            .slice(1)
+            .sort((a, b) => {
+            const pa = a.col.priority ?? a.index + 1;
+            const pb = b.col.priority ?? b.index + 1;
+            if (pa !== pb)
+                return pb - pa;
+            return b.index - a.index;
+        })[0];
+        active = active.filter((meta) => meta !== removable);
+    }
+    let overflow = widthFor(active) - maxWidth;
+    while (overflow > 0) {
+        const shrinkable = active
+            .filter((meta) => meta.width > meta.min)
+            .sort((a, b) => (b.width - b.min) - (a.width - a.min))[0];
+        if (!shrinkable)
+            break;
+        shrinkable.width -= 1;
+        overflow -= 1;
+    }
+    while (widthFor(active) > maxWidth && active.length > 2) {
+        const removable = [...active]
+            .slice(1)
+            .sort((a, b) => {
+            const pa = a.col.priority ?? a.index + 1;
+            const pb = b.col.priority ?? b.index + 1;
+            if (pa !== pb)
+                return pb - pa;
+            return b.index - a.index;
+        })[0];
+        active = active.filter((meta) => meta !== removable);
+    }
+    return active;
+}
+function widthFor(cols) {
+    return cols.reduce((sum, col) => sum + col.width + 3, 1);
+}
+function minWidthFor(cols) {
+    return cols.reduce((sum, col) => sum + col.min + 3, 1);
+}
+function renderGrid(rows, cols, opts) {
+    const headerStyle = opts.headerStyle ?? C.bold;
+    const borderColor = opts.borderColor ?? C.dim;
+    const lines = [];
+    lines.push(borderColor(S.tl + cols.map((c) => S.h.repeat(c.width + 2)).join(S.t) + S.tr));
+    const headerCells = cols.map((meta) => {
+        const text = truncateAnsi(meta.col.header, meta.width);
+        return ' ' + headerStyle(alignAnsi(text, meta.width, meta.col.align ?? 'left')) + ' ';
+    });
+    lines.push(borderColor(S.v) + headerCells.join(borderColor(S.v)) + borderColor(S.v));
+    lines.push(borderColor(S.l + cols.map((c) => S.h.repeat(c.width + 2)).join(S.crossBox) + S.r));
+    for (const row of rows) {
+        const cells = cols.map((meta) => {
+            const raw = formatValue(row, meta.col);
+            const display = truncateAnsi(raw, meta.width, S.ellipsis);
+            const aligned = alignAnsi(display, meta.width, meta.col.align ?? 'left');
+            const color = meta.col.color ? (s) => meta.col.color(s, row) : (s) => s;
+            return ' ' + color(aligned) + ' ';
+        });
+        lines.push(borderColor(S.v) + cells.join(borderColor(S.v)) + borderColor(S.v));
+    }
+    lines.push(borderColor(S.bl + cols.map((c) => S.h.repeat(c.width + 2)).join(S.b) + S.br));
+    return lines.join('\n');
+}
+function renderCards(rows, columns, opts) {
+    const maxWidth = Math.max(24, opts.maxWidth ?? terminalWidth());
+    const contentWidth = Math.max(18, maxWidth - 4);
+    const labelWidth = Math.min(14, Math.max(...columns.map((col) => visibleLength(col.header || col.key)), 6));
+    const borderColor = opts.borderColor ?? C.dim;
+    const lines = [];
+    rows.forEach((row, rowIndex) => {
+        if (rowIndex > 0) {
+            lines.push(borderColor('  ' + S.h.repeat(Math.min(contentWidth, maxWidth - 2))));
+        }
+        for (const col of columns) {
+            const label = truncateAnsi(col.header || col.key, labelWidth);
+            const raw = formatValue(row, col);
+            const valueWidth = Math.max(8, contentWidth - labelWidth - 2);
+            const value = truncateAnsi(raw, valueWidth, S.ellipsis);
+            lines.push(`  ${C.dim(alignAnsi(label, labelWidth, 'left'))}  ${value}`);
+        }
+    });
+    return lines.join('\n');
+}
+function formatValue(row, col) {
+    const raw = row[col.key];
+    if (col.formatter) {
+        return col.formatter(raw, row);
+    }
+    if (raw === null || raw === undefined)
+        return '-';
+    if (typeof raw === 'boolean')
+        return raw ? 'yes' : 'no';
+    return String(raw);
+}
+export function renderSimpleTable(rows, headers) {
+    if (rows.length === 0)
+        return '';
+    const numCols = rows[0].length;
+    const colWidths = Array.from({ length: numCols }, (_, i) => {
+        const headerLen = headers ? visibleLength(headers[i] || '') : 0;
+        const dataLens = rows.map((row) => visibleLength(row[i] || ''));
+        return Math.max(headerLen, ...dataLens);
+    });
+    const renderedRows = rows.map((row) => {
+        return row.map((cell, i) => stripAnsi(cell).padEnd(colWidths[i])).join('  ');
+    });
+    if (!headers)
+        return renderedRows.join('\n');
+    const headerLine = headers.map((h, i) => h.padEnd(colWidths[i])).join('  ');
+    const separator = colWidths.map((w) => S.h.repeat(w)).join('  ');
+    return [C.bold(headerLine), C.dim(separator), ...renderedRows].join('\n');
+}
+//# sourceMappingURL=table.js.map

package/dist/esm/cli/ui/table.js.map

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

package/dist/esm/cli/ui/terminal.d.ts

@@ -0,0 +1,7 @@
+export declare function terminalWidth(fallback?: number): number;
+export declare function clampWidth(width: number, min: number, max?: number): number;
+export declare function clearScreen(): void;
+export declare function clearLine(): void;
+export declare function fitLine(line: string, width?: number): string;
+export declare function indentLines(text: string, spaces?: number): string;
+//# sourceMappingURL=terminal.d.ts.map

package/dist/esm/cli/ui/terminal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal.d.ts","sourceRoot":"","sources":["../../../../src/cli/ui/terminal.ts"],"names":[],"mappings":"AAEA,wBAAgB,aAAa,CAAC,QAAQ,SAAK,GAAG,MAAM,CAUnD;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,SAAkB,GAAG,MAAM,CAEpF;AAED,wBAAgB,WAAW,IAAI,IAAI,CAElC;AAED,wBAAgB,SAAS,IAAI,IAAI,CAEhC;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,SAAkB,GAAG,MAAM,CAKrE;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,SAAI,GAAG,MAAM,CAG5D"}

package/dist/esm/cli/ui/terminal.js

@@ -0,0 +1,32 @@
+import { visibleLength, truncateAnsi } from './colors';
+export function terminalWidth(fallback = 80) {
+    const override = process.env.SW_AGENT_COLUMNS ? parseInt(process.env.SW_AGENT_COLUMNS, 10) : 0;
+    if (Number.isFinite(override) && override >= 20) {
+        return override;
+    }
+    const columns = process.stdout.columns;
+    if (!columns || columns < 20) {
+        return fallback;
+    }
+    return columns;
+}
+export function clampWidth(width, min, max = terminalWidth()) {
+    return Math.max(min, Math.min(width, max));
+}
+export function clearScreen() {
+    process.stdout.write('\x1b[2J\x1b[3J\x1b[H');
+}
+export function clearLine() {
+    process.stdout.write('\r\x1b[2K');
+}
+export function fitLine(line, width = terminalWidth()) {
+    if (visibleLength(line) <= width) {
+        return line;
+    }
+    return truncateAnsi(line, Math.max(1, width));
+}
+export function indentLines(text, spaces = 2) {
+    const prefix = ' '.repeat(spaces);
+    return text.split('\n').map((line) => prefix + line).join('\n');
+}
+//# sourceMappingURL=terminal.js.map

package/dist/esm/cli/ui/terminal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal.js","sourceRoot":"","sources":["../../../../src/cli/ui/terminal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAEvD,MAAM,UAAU,aAAa,CAAC,QAAQ,GAAG,EAAE;IACzC,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/F,IAAI,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,QAAQ,IAAI,EAAE,EAAE,CAAC;QAChD,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC;IACvC,IAAI,CAAC,OAAO,IAAI,OAAO,GAAG,EAAE,EAAE,CAAC;QAC7B,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAa,EAAE,GAAW,EAAE,GAAG,GAAG,aAAa,EAAE;IAC1E,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,IAAY,EAAE,KAAK,GAAG,aAAa,EAAE;IAC3D,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,KAAK,EAAE,CAAC;QACjC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,MAAM,GAAG,CAAC;IAClD,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAClC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAClE,CAAC"}

package/dist/esm/config/atomic-write.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Atomic, symlink-refusing, permission-repairing file writes plus the advisory
+ * lock used to serialise read-modify-write sequences over config files.
+ *
+ * Every config file that can hold the agent token or a database password must
+ * go through {@link atomicWriteFile}: a plain `writeFileSync` applies `mode`
+ * only on create (so a pre-existing 0o644 file stays world-readable), follows
+ * symlinks planted by a local attacker, and can truncate the file — which for
+ * the machine config means permanent loss of the agent token.
+ */
+/** Mode every credential-bearing config file is written and repaired to. */
+export declare const ATOMIC_WRITE_FILE_MODE = 384;
+/** Mode the containing directory is created and repaired to. */
+export declare const ATOMIC_WRITE_DIR_MODE = 448;
+export type AtomicWriteErrorCode = 'symlink_refused' | 'write_failed' | 'lock_timeout';
+/** Raised when a config write is refused or cannot be completed. */
+export declare class AtomicWriteError extends Error {
+    readonly code: AtomicWriteErrorCode;
+    constructor(message: string, code?: AtomicWriteErrorCode);
+}
+export interface FileLockOptions {
+    /** Age after which an abandoned lock is reaped. Default 30s. */
+    staleMs?: number;
+    /** How long to wait for a contended lock before failing. Default 5s. */
+    timeoutMs?: number;
+    /** Lock acquisition poll interval. Default 25ms. */
+    retryMs?: number;
+}
+/**
+ * Fails when `target` is a symlink. A missing file is not a symlink, so the
+ * check is safe to run before every create. Use `lstat`, never `stat`: `stat`
+ * follows the link and reports the target's type, which is exactly the check
+ * that has to fail here.
+ */
+export declare function assertNotSymlink(target: string): void;
+/** Creates the containing directory if missing; leaves an existing one alone. */
+export declare function ensureDir(dir: string): void;
+/**
+ * Creates the containing directory and repairs the mode of a pre-existing one
+ * that is group- or world-accessible. Used for the agent home, which holds the
+ * token: a 0o755 home is a failed control, not a cosmetic detail.
+ */
+export declare function ensureSecureDir(dir: string): void;
+/**
+ * Writes `data` to `filePath` atomically:
+ * create a private temp file, fsync it, rename it over the target, then fsync
+ * the directory. A reader therefore only ever sees the complete old file or the
+ * complete new one, and a crash cannot truncate the config.
+ *
+ * The temp file is created with O_EXCL|O_NOFOLLOW, so it can never be
+ * pre-created (or symlinked) by another process, and is chmod'ed to `mode`
+ * unconditionally: `mode` passed to `open` is masked by the umask, so it alone
+ * cannot guarantee 0o600.
+ */
+export declare function atomicWriteFile(filePath: string, data: string | Buffer, mode?: number): void;
+/** `atomicWriteFile` for a JSON document, pretty-printed with a trailing newline. */
+export declare function atomicWriteJson(filePath: string, value: unknown, mode?: number): void;
+/**
+ * Runs `fn` while holding an exclusive advisory lock on `targetPath`. Use it
+ * around every load → mutate → save sequence so two concurrent CLI
+ * invocations cannot lose one another's update. The lock is an `O_EXCL` lock
+ * file, so it is released by the kernel even if the process is killed; a lock
+ * whose holder died is reaped after `staleMs`.
+ *
+ * Re-entrant within one process: a nested call for the same target runs `fn`
+ * directly instead of deadlocking against itself.
+ */
+export declare function withFileLock<T>(targetPath: string, fn: () => T, opts?: FileLockOptions): T;
+//# sourceMappingURL=atomic-write.d.ts.map

package/dist/esm/config/atomic-write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"atomic-write.d.ts","sourceRoot":"","sources":["../../../src/config/atomic-write.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,4EAA4E;AAC5E,eAAO,MAAM,sBAAsB,MAAQ,CAAC;AAE5C,gEAAgE;AAChE,eAAO,MAAM,qBAAqB,MAAQ,CAAC;AAE3C,MAAM,MAAM,oBAAoB,GAAG,iBAAiB,GAAG,cAAc,GAAG,cAAc,CAAC;AAEvF,oEAAoE;AACpE,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;gBAExB,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,oBAAqC;CAKzE;AAED,MAAM,WAAW,eAAe;IAC9B,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wEAAwE;IACxE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AA+CD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAcrD;AAED,iFAAiF;AACjF,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAQ3C;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAGjD;AAgBD;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,GAAG,MAAM,EACrB,IAAI,GAAE,MAA+B,GACpC,IAAI,CA4BN;AAED,qFAAqF;AACrF,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,OAAO,EACd,IAAI,GAAE,MAA+B,GACpC,IAAI,CAEN;AAmED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAC5B,UAAU,EAAE,MAAM,EAClB,EAAE,EAAE,MAAM,CAAC,EACX,IAAI,GAAE,eAAoB,GACzB,CAAC,CAkBH"}

package/dist/esm/config/atomic-write.js

@@ -0,0 +1,246 @@
+/**
+ * Atomic, symlink-refusing, permission-repairing file writes plus the advisory
+ * lock used to serialise read-modify-write sequences over config files.
+ *
+ * Every config file that can hold the agent token or a database password must
+ * go through {@link atomicWriteFile}: a plain `writeFileSync` applies `mode`
+ * only on create (so a pre-existing 0o644 file stays world-readable), follows
+ * symlinks planted by a local attacker, and can truncate the file — which for
+ * the machine config means permanent loss of the agent token.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import * as crypto from 'crypto';
+/** Mode every credential-bearing config file is written and repaired to. */
+export const ATOMIC_WRITE_FILE_MODE = 0o600;
+/** Mode the containing directory is created and repaired to. */
+export const ATOMIC_WRITE_DIR_MODE = 0o700;
+/** Raised when a config write is refused or cannot be completed. */
+export class AtomicWriteError extends Error {
+    code;
+    constructor(message, code = 'write_failed') {
+        super(message);
+        this.name = 'AtomicWriteError';
+        this.code = code;
+    }
+}
+const DEFAULT_LOCK_STALE_MS = 30_000;
+const DEFAULT_LOCK_TIMEOUT_MS = 5_000;
+const DEFAULT_LOCK_RETRY_MS = 25;
+const NOFOLLOW = fs.constants.O_NOFOLLOW ?? 0;
+const TEMP_WRITE_FLAGS = fs.constants.O_WRONLY | fs.constants.O_CREAT | fs.constants.O_EXCL | NOFOLLOW;
+const heldLocks = new Set();
+function errText(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+function hasCode(err, code) {
+    return (typeof err === 'object' && err !== null && err.code === code);
+}
+function chmodIfPosix(target, mode) {
+    if (process.platform === 'win32')
+        return;
+    fs.chmodSync(target, mode);
+}
+function closeQuietly(fd) {
+    try {
+        fs.closeSync(fd);
+    }
+    catch {
+        // ignore
+    }
+}
+function unlinkQuietly(target) {
+    try {
+        fs.unlinkSync(target);
+    }
+    catch {
+        // ignore
+    }
+}
+function sleepSync(ms) {
+    Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms);
+}
+/**
+ * Fails when `target` is a symlink. A missing file is not a symlink, so the
+ * check is safe to run before every create. Use `lstat`, never `stat`: `stat`
+ * follows the link and reports the target's type, which is exactly the check
+ * that has to fail here.
+ */
+export function assertNotSymlink(target) {
+    let stats;
+    try {
+        stats = fs.lstatSync(target);
+    }
+    catch (err) {
+        if (hasCode(err, 'ENOENT'))
+            return;
+        throw new AtomicWriteError(`Cannot inspect ${target}: ${errText(err)}`);
+    }
+    if (stats.isSymbolicLink()) {
+        throw new AtomicWriteError(`Refusing to write through the symlink ${target}. Remove it or point SW_AGENT_HOME somewhere else.`, 'symlink_refused');
+    }
+}
+/** Creates the containing directory if missing; leaves an existing one alone. */
+export function ensureDir(dir) {
+    try {
+        fs.mkdirSync(dir, { recursive: true, mode: ATOMIC_WRITE_DIR_MODE });
+    }
+    catch (err) {
+        if (!hasCode(err, 'EEXIST')) {
+            throw new AtomicWriteError(`Failed to create directory ${dir}: ${errText(err)}`);
+        }
+    }
+}
+/**
+ * Creates the containing directory and repairs the mode of a pre-existing one
+ * that is group- or world-accessible. Used for the agent home, which holds the
+ * token: a 0o755 home is a failed control, not a cosmetic detail.
+ */
+export function ensureSecureDir(dir) {
+    ensureDir(dir);
+    chmodIfPosix(dir, ATOMIC_WRITE_DIR_MODE);
+}
+/** fsync of the directory so the rename survives a power loss, where supported. */
+function fsyncDir(dir) {
+    if (process.platform === 'win32')
+        return;
+    let fd;
+    try {
+        fd = fs.openSync(dir, 'r');
+        fs.fsyncSync(fd);
+    }
+    catch {
+        // EINVAL/EPERM/EISDIR: the filesystem does not support directory fsync.
+    }
+    finally {
+        if (fd !== undefined)
+            closeQuietly(fd);
+    }
+}
+/**
+ * Writes `data` to `filePath` atomically:
+ * create a private temp file, fsync it, rename it over the target, then fsync
+ * the directory. A reader therefore only ever sees the complete old file or the
+ * complete new one, and a crash cannot truncate the config.
+ *
+ * The temp file is created with O_EXCL|O_NOFOLLOW, so it can never be
+ * pre-created (or symlinked) by another process, and is chmod'ed to `mode`
+ * unconditionally: `mode` passed to `open` is masked by the umask, so it alone
+ * cannot guarantee 0o600.
+ */
+export function atomicWriteFile(filePath, data, mode = ATOMIC_WRITE_FILE_MODE) {
+    const dir = path.dirname(filePath);
+    ensureDir(dir);
+    assertNotSymlink(filePath);
+    const tmp = `${filePath}.tmp-${process.pid}-${crypto.randomBytes(6).toString('hex')}`;
+    let fd;
+    try {
+        fd = fs.openSync(tmp, TEMP_WRITE_FLAGS, mode);
+        assertNotSymlink(tmp);
+        const buf = typeof data === 'string' ? Buffer.from(data, 'utf8') : data;
+        let written = 0;
+        while (written < buf.length) {
+            written += fs.writeSync(fd, buf, written, buf.length - written);
+        }
+        fs.fsyncSync(fd);
+        fs.closeSync(fd);
+        fd = undefined;
+        chmodIfPosix(tmp, mode);
+        fs.renameSync(tmp, filePath);
+        chmodIfPosix(filePath, mode);
+        fsyncDir(dir);
+    }
+    catch (err) {
+        if (fd !== undefined)
+            closeQuietly(fd);
+        unlinkQuietly(tmp);
+        if (err instanceof AtomicWriteError)
+            throw err;
+        throw new AtomicWriteError(`Failed to write ${filePath}: ${errText(err)}`);
+    }
+}
+/** `atomicWriteFile` for a JSON document, pretty-printed with a trailing newline. */
+export function atomicWriteJson(filePath, value, mode = ATOMIC_WRITE_FILE_MODE) {
+    atomicWriteFile(filePath, `${JSON.stringify(value, null, 2)}\n`, mode);
+}
+/**
+ * True when the lock file next to `target` was abandoned (older than `staleMs`)
+ * or is not a real lock file. Reaps it as a side effect.
+ */
+function reapStaleLock(lockPath, staleMs) {
+    let stats;
+    try {
+        stats = fs.lstatSync(lockPath);
+    }
+    catch (err) {
+        return hasCode(err, 'ENOENT');
+    }
+    if (stats.isSymbolicLink() || !stats.isFile()) {
+        unlinkQuietly(lockPath);
+        return true;
+    }
+    if (Date.now() - stats.mtimeMs > staleMs) {
+        unlinkQuietly(lockPath);
+        return true;
+    }
+    return false;
+}
+function acquireLock(lockPath, staleMs, timeoutMs, retryMs) {
+    const deadline = Date.now() + timeoutMs;
+    for (;;) {
+        try {
+            const fd = fs.openSync(lockPath, 'wx', ATOMIC_WRITE_FILE_MODE);
+            try {
+                fs.writeSync(fd, `${JSON.stringify({ pid: process.pid, acquired_at: new Date().toISOString() })}\n`);
+                fs.fsyncSync(fd);
+            }
+            finally {
+                closeQuietly(fd);
+            }
+            chmodIfPosix(lockPath, ATOMIC_WRITE_FILE_MODE);
+            heldLocks.add(lockPath);
+            return;
+        }
+        catch (err) {
+            if (!hasCode(err, 'EEXIST')) {
+                throw new AtomicWriteError(`Failed to take the lock ${lockPath}: ${errText(err)}`);
+            }
+        }
+        if (reapStaleLock(lockPath, staleMs))
+            continue;
+        if (Date.now() >= deadline) {
+            throw new AtomicWriteError(`Timed out after ${timeoutMs}ms waiting for the lock ${lockPath}. Another sw-agent process is writing the same config; retry once it finishes.`, 'lock_timeout');
+        }
+        sleepSync(retryMs);
+    }
+}
+function releaseLock(lockPath) {
+    heldLocks.delete(lockPath);
+    unlinkQuietly(lockPath);
+}
+/**
+ * Runs `fn` while holding an exclusive advisory lock on `targetPath`. Use it
+ * around every load → mutate → save sequence so two concurrent CLI
+ * invocations cannot lose one another's update. The lock is an `O_EXCL` lock
+ * file, so it is released by the kernel even if the process is killed; a lock
+ * whose holder died is reaped after `staleMs`.
+ *
+ * Re-entrant within one process: a nested call for the same target runs `fn`
+ * directly instead of deadlocking against itself.
+ */
+export function withFileLock(targetPath, fn, opts = {}) {
+    const lockPath = `${targetPath}.lock`;
+    if (heldLocks.has(lockPath)) {
+        return fn();
+    }
+    const dir = path.dirname(lockPath);
+    ensureSecureDir(dir);
+    acquireLock(lockPath, opts.staleMs ?? DEFAULT_LOCK_STALE_MS, opts.timeoutMs ?? DEFAULT_LOCK_TIMEOUT_MS, opts.retryMs ?? DEFAULT_LOCK_RETRY_MS);
+    try {
+        return fn();
+    }
+    finally {
+        releaseLock(lockPath);
+    }
+}
+//# sourceMappingURL=atomic-write.js.map

package/dist/esm/config/atomic-write.js.map

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