@senior-skills/node 1.0.0

package/dist/runtime.d.ts

@@ -0,0 +1,51 @@
+import { type Clock, type CommandOptions, type CommandResult, type CommandRunner, type Environment, type Hasher, type HttpClient, type HttpRequestOptions, type HttpResponse, type LogLevel, type Logger } from '@senior-skills/core';
+export declare class NodeEnvironment implements Environment {
+    homeDir(): string;
+    cwd(): string;
+    tempDir(): string;
+    platform(): string;
+    env(): Readonly<Record<string, string | undefined>>;
+}
+export declare class SystemClock implements Clock {
+    now(): Date;
+}
+export declare class NodeHasher implements Hasher {
+    hash(data: Uint8Array): string;
+    hashFile(target: string): Promise<string>;
+}
+/**
+ * HTTPS client built on `fetch`.
+ *
+ * Two policies are enforced here rather than at call sites: plaintext HTTP is refused
+ * outright (loopback excepted, for local development registries), and the response body is
+ * capped so a hostile server cannot exhaust memory before integrity checking gets a chance
+ * to run.
+ */
+export declare class NodeHttpClient implements HttpClient {
+    private readonly userAgent;
+    private readonly allowInsecure;
+    constructor(userAgent: string, allowInsecure?: boolean);
+    get(url: string, options?: HttpRequestOptions): Promise<HttpResponse>;
+    private assertTransport;
+}
+/**
+ * Runs external commands. Used only for `git` and for agent version probes.
+ *
+ * Arguments are always passed as an array and the shell is never involved, so a registry URL
+ * containing shell metacharacters cannot become a command injection.
+ */
+export declare class NodeCommandRunner implements CommandRunner {
+    run(command: string, args: readonly string[], options?: CommandOptions): Promise<CommandResult>;
+    which(command: string): Promise<string | undefined>;
+}
+/** Logs to stderr so `--json` output on stdout stays machine-parseable. */
+export declare class ConsoleLogger implements Logger {
+    private readonly threshold;
+    constructor(level?: LogLevel);
+    debug(message: string, ...args: readonly unknown[]): void;
+    info(message: string, ...args: readonly unknown[]): void;
+    warn(message: string, ...args: readonly unknown[]): void;
+    error(message: string, ...args: readonly unknown[]): void;
+    private write;
+}
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAMA,OAAO,EAIL,KAAK,KAAK,EACV,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,MAAM,EACX,KAAK,UAAU,EACf,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,KAAK,QAAQ,EACb,KAAK,MAAM,EACZ,MAAM,qBAAqB,CAAC;AAE7B,qBAAa,eAAgB,YAAW,WAAW;IACjD,OAAO,IAAI,MAAM;IAIjB,GAAG,IAAI,MAAM;IAIb,OAAO,IAAI,MAAM;IAIjB,QAAQ,IAAI,MAAM;IAIlB,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;CAGpD;AAED,qBAAa,WAAY,YAAW,KAAK;IACvC,GAAG,IAAI,IAAI;CAGZ;AAED,qBAAa,UAAW,YAAW,MAAM;IACvC,IAAI,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM;IAIxB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAKhD;AAKD;;;;;;;GAOG;AACH,qBAAa,cAAe,YAAW,UAAU;IAC/C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAU;gBAE5B,SAAS,EAAE,MAAM,EAAE,aAAa,UAAQ;IAK9C,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,YAAY,CAAC;IAuD/E,OAAO,CAAC,eAAe;CA2BxB;AAED;;;;;GAKG;AACH,qBAAa,iBAAkB,YAAW,aAAa;IAC/C,GAAG,CACP,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,aAAa,CAAC;IAsDnB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;CAmB1D;AAID,2EAA2E;AAC3E,qBAAa,aAAc,YAAW,MAAM;IAC1C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,KAAK,GAAE,QAAiB;IAIpC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,SAAS,OAAO,EAAE,GAAG,IAAI;IAIzD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,SAAS,OAAO,EAAE,GAAG,IAAI;IAIxD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,SAAS,OAAO,EAAE,GAAG,IAAI;IAIxD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,SAAS,OAAO,EAAE,GAAG,IAAI;IAIzD,OAAO,CAAC,KAAK;CAMd"}

package/dist/runtime.js

@@ -0,0 +1,215 @@
+import { createHash } from 'node:crypto';
+import { createReadStream } from 'node:fs';
+import { spawn } from 'node:child_process';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { access, constants } from 'node:fs/promises';
+import { AgentSkillsError, ErrorCode, INTEGRITY_PREFIX, } from '@senior-skills/core';
+export class NodeEnvironment {
+    homeDir() {
+        return os.homedir();
+    }
+    cwd() {
+        return process.cwd();
+    }
+    tempDir() {
+        return os.tmpdir();
+    }
+    platform() {
+        return process.platform;
+    }
+    env() {
+        return process.env;
+    }
+}
+export class SystemClock {
+    now() {
+        return new Date();
+    }
+}
+export class NodeHasher {
+    hash(data) {
+        return INTEGRITY_PREFIX + createHash('sha256').update(data).digest('base64');
+    }
+    async hashFile(target) {
+        const digest = createHash('sha256');
+        for await (const chunk of createReadStream(target))
+            digest.update(chunk);
+        return INTEGRITY_PREFIX + digest.digest('base64');
+    }
+}
+const DEFAULT_TIMEOUT_MS = 30_000;
+const DEFAULT_MAX_BYTES = 64 * 1024 * 1024;
+/**
+ * HTTPS client built on `fetch`.
+ *
+ * Two policies are enforced here rather than at call sites: plaintext HTTP is refused
+ * outright (loopback excepted, for local development registries), and the response body is
+ * capped so a hostile server cannot exhaust memory before integrity checking gets a chance
+ * to run.
+ */
+export class NodeHttpClient {
+    userAgent;
+    allowInsecure;
+    constructor(userAgent, allowInsecure = false) {
+        this.userAgent = userAgent;
+        this.allowInsecure = allowInsecure;
+    }
+    async get(url, options = {}) {
+        this.assertTransport(url);
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), options.timeoutMs ?? DEFAULT_TIMEOUT_MS);
+        try {
+            const response = await fetch(url, {
+                signal: controller.signal,
+                redirect: 'follow',
+                headers: { 'user-agent': this.userAgent, ...(options.headers ?? {}) },
+            });
+            const maxBytes = options.maxBytes ?? DEFAULT_MAX_BYTES;
+            const declared = Number(response.headers.get('content-length') ?? '0');
+            if (declared > maxBytes) {
+                throw new AgentSkillsError(ErrorCode.UNSAFE_ARCHIVE, `Response from ${url} declares ${declared} bytes, over the ${maxBytes} byte limit`, { data: { url, declared, maxBytes } });
+            }
+            const body = new Uint8Array(await response.arrayBuffer());
+            if (body.byteLength > maxBytes) {
+                throw new AgentSkillsError(ErrorCode.UNSAFE_ARCHIVE, `Response from ${url} is ${body.byteLength} bytes, over the ${maxBytes} byte limit`, { data: { url, size: body.byteLength, maxBytes } });
+            }
+            return {
+                status: response.status,
+                headers: Object.fromEntries(response.headers.entries()),
+                body,
+            };
+        }
+        catch (cause) {
+            if (cause instanceof AgentSkillsError)
+                throw cause;
+            const aborted = cause instanceof Error && cause.name === 'AbortError';
+            throw new AgentSkillsError(ErrorCode.REGISTRY_UNAVAILABLE, aborted ? `Request to ${url} timed out` : `Request to ${url} failed`, {
+                details: aborted ? [] : [cause instanceof Error ? cause.message : String(cause)],
+                hints: ['Check your network connection and any proxy settings'],
+                cause,
+                data: { url },
+            });
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+    }
+    assertTransport(url) {
+        let parsed;
+        try {
+            parsed = new URL(url);
+        }
+        catch (cause) {
+            throw new AgentSkillsError(ErrorCode.USAGE, `Invalid URL: ${url}`, { cause, data: { url } });
+        }
+        if (parsed.protocol === 'https:')
+            return;
+        const loopback = parsed.hostname === 'localhost' ||
+            parsed.hostname === '127.0.0.1' ||
+            parsed.hostname === '::1';
+        if (parsed.protocol === 'http:' && (this.allowInsecure || loopback))
+            return;
+        throw new AgentSkillsError(ErrorCode.INSECURE_TRANSPORT, `Refusing to fetch over ${parsed.protocol}//`, {
+            details: [url, '', 'Skill packages become instructions your coding agent follows.'],
+            hints: ['Use an https:// URL', 'For a local development registry, use http://localhost'],
+            data: { url, protocol: parsed.protocol },
+        });
+    }
+}
+/**
+ * Runs external commands. Used only for `git` and for agent version probes.
+ *
+ * Arguments are always passed as an array and the shell is never involved, so a registry URL
+ * containing shell metacharacters cannot become a command injection.
+ */
+export class NodeCommandRunner {
+    async run(command, args, options = {}) {
+        return new Promise((resolve, reject) => {
+            const child = spawn(command, [...args], {
+                cwd: options.cwd ?? process.cwd(),
+                env: { ...process.env, ...(options.env ?? {}) },
+                shell: false,
+                windowsHide: true,
+            });
+            let stdout = '';
+            let stderr = '';
+            let settled = false;
+            const timer = setTimeout(() => {
+                if (settled)
+                    return;
+                settled = true;
+                child.kill('SIGKILL');
+                reject(new AgentSkillsError(ErrorCode.IO_ERROR, `Command timed out: ${command} ${args.join(' ')}`, {
+                    data: { command, args },
+                }));
+            }, options.timeoutMs ?? DEFAULT_TIMEOUT_MS);
+            child.stdout?.on('data', (chunk) => (stdout += String(chunk)));
+            child.stderr?.on('data', (chunk) => (stderr += String(chunk)));
+            child.on('error', (cause) => {
+                if (settled)
+                    return;
+                settled = true;
+                clearTimeout(timer);
+                reject(new AgentSkillsError(ErrorCode.IO_ERROR, `Could not run "${command}"`, {
+                    details: [cause.message],
+                    hints: command === 'git' ? ['Install git, or use an http registry instead'] : [],
+                    cause,
+                    data: { command, args },
+                }));
+            });
+            child.on('close', (code) => {
+                if (settled)
+                    return;
+                settled = true;
+                clearTimeout(timer);
+                resolve({ code: code ?? 0, stdout, stderr });
+            });
+        });
+    }
+    async which(command) {
+        const isWindows = process.platform === 'win32';
+        const extensions = isWindows
+            ? (process.env['PATHEXT'] ?? '.EXE;.CMD;.BAT;.COM').split(';').filter(Boolean)
+            : [''];
+        for (const directory of (process.env['PATH'] ?? '').split(path.delimiter).filter(Boolean)) {
+            for (const extension of extensions) {
+                const candidate = path.join(directory, command + extension);
+                try {
+                    await access(candidate, isWindows ? constants.F_OK : constants.X_OK);
+                    return candidate;
+                }
+                catch {
+                    // Try the next candidate.
+                }
+            }
+        }
+        return undefined;
+    }
+}
+const LEVEL_ORDER = { debug: 10, info: 20, warn: 30, error: 40 };
+/** Logs to stderr so `--json` output on stdout stays machine-parseable. */
+export class ConsoleLogger {
+    threshold;
+    constructor(level = 'info') {
+        this.threshold = LEVEL_ORDER[level];
+    }
+    debug(message, ...args) {
+        this.write('debug', message, args);
+    }
+    info(message, ...args) {
+        this.write('info', message, args);
+    }
+    warn(message, ...args) {
+        this.write('warn', message, args);
+    }
+    error(message, ...args) {
+        this.write('error', message, args);
+    }
+    write(level, message, args) {
+        if (LEVEL_ORDER[level] < this.threshold)
+            return;
+        process.stderr.write(`${level === 'info' ? '' : `${level}: `}${message}${args.length > 0 ? ` ${args.map(String).join(' ')}` : ''}\n`);
+    }
+}
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

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

package/dist/selection-prompt.d.ts

@@ -0,0 +1,21 @@
+import type { Readable, Writable } from 'node:stream';
+import type { SelectionPrompt } from '@senior-skills/core';
+export type PromptInput = Readable & {
+    isTTY?: boolean;
+    isRaw?: boolean;
+    setRawMode(mode: boolean): unknown;
+    ref?(): unknown;
+    unref?(): unknown;
+};
+export type PromptOutput = Writable & {
+    isTTY?: boolean;
+    columns?: number;
+};
+/** A small terminal menu: arrows, digits, Enter, and Escape; no shell or agent process. */
+export declare class NodeSelectionPrompt implements SelectionPrompt {
+    private readonly input;
+    private readonly output;
+    constructor(input?: PromptInput, output?: PromptOutput);
+    choose(message: string, choices: readonly string[]): Promise<number | undefined>;
+}
+//# sourceMappingURL=selection-prompt.d.ts.map

package/dist/selection-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection-prompt.d.ts","sourceRoot":"","sources":["../src/selection-prompt.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG;IACnC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC;IACnC,GAAG,CAAC,IAAI,OAAO,CAAC;IAChB,KAAK,CAAC,IAAI,OAAO,CAAC;CACnB,CAAC;AACF,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5E,2FAA2F;AAC3F,qBAAa,mBAAoB,YAAW,eAAe;IACzD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAc;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;gBAE1B,KAAK,GAAE,WAA2B,EAAE,MAAM,GAAE,YAA6B;IAK/E,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;CA+DvF"}

package/dist/selection-prompt.js

@@ -0,0 +1,75 @@
+import { emitKeypressEvents } from 'node:readline';
+/** A small terminal menu: arrows, digits, Enter, and Escape; no shell or agent process. */
+export class NodeSelectionPrompt {
+    input;
+    output;
+    constructor(input = process.stdin, output = process.stderr) {
+        this.input = input;
+        this.output = output;
+    }
+    async choose(message, choices) {
+        if (!this.input.isTTY || !this.output.isTTY || choices.length === 0)
+            return undefined;
+        const input = this.input;
+        const output = this.output;
+        const wasRaw = input.isRaw === true;
+        const wasFlowing = input.readableFlowing === true;
+        let selected = 0;
+        output.write(`\n${message}\n\n`);
+        // Keep each redrawn menu row on one physical line, including on narrow terminals.
+        const fit = (text) => {
+            const width = Math.max(10, (output.columns || 80) - 1);
+            return text.length <= width ? text : `${text.slice(0, width - 3)}...`;
+        };
+        const draw = () => {
+            choices.forEach((choice, index) => output.write(`\x1b[2K\r${fit(`${index === selected ? '>' : ' '} ${index + 1}. ${choice}`)}\n`));
+            output.write(`\x1b[2K\r${fit('Use arrows or a number, Enter to select, Esc to continue.')}`);
+        };
+        emitKeypressEvents(input);
+        return new Promise((resolve) => {
+            let finished = false;
+            const finish = (value) => {
+                if (finished)
+                    return;
+                finished = true;
+                input.off('keypress', onKey);
+                input.off('end', onEnd);
+                input.off('close', onEnd);
+                input.off('error', onEnd);
+                input.setRawMode(wasRaw);
+                if (!wasFlowing) {
+                    input.pause();
+                    input.unref?.();
+                }
+                output.write('\n');
+                resolve(value);
+            };
+            const onEnd = () => finish();
+            const onKey = (_text, key) => {
+                if (key.name === 'escape' || (key.ctrl && ['c', 'd'].includes(key.name ?? '')))
+                    return finish();
+                if (key.name === 'return' || key.name === 'enter')
+                    return finish(selected);
+                if (key.name === 'up')
+                    selected = (selected + choices.length - 1) % choices.length;
+                else if (key.name === 'down' || key.name === 'tab')
+                    selected = (selected + 1) % choices.length;
+                else if (/^[1-9]$/.test(key.sequence ?? '') && Number(key.sequence) <= choices.length)
+                    selected = Number(key.sequence) - 1;
+                else
+                    return;
+                output.write(`\r\x1b[${choices.length}A`);
+                draw();
+            };
+            input.on('keypress', onKey);
+            input.once('end', onEnd);
+            input.once('close', onEnd);
+            input.once('error', onEnd);
+            input.setRawMode(true);
+            input.ref?.();
+            input.resume();
+            draw();
+        });
+    }
+}
+//# sourceMappingURL=selection-prompt.js.map

package/dist/selection-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection-prompt.js","sourceRoot":"","sources":["../src/selection-prompt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAY,MAAM,eAAe,CAAC;AAa7D,2FAA2F;AAC3F,MAAM,OAAO,mBAAmB;IACb,KAAK,CAAc;IACnB,MAAM,CAAe;IAEtC,YAAY,QAAqB,OAAO,CAAC,KAAK,EAAE,SAAuB,OAAO,CAAC,MAAM;QACnF,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,OAAe,EAAE,OAA0B;QACtD,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,SAAS,CAAC;QACtF,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACzB,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC3B,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,KAAK,IAAI,CAAC;QACpC,MAAM,UAAU,GAAG,KAAK,CAAC,eAAe,KAAK,IAAI,CAAC;QAClD,IAAI,QAAQ,GAAG,CAAC,CAAC;QACjB,MAAM,CAAC,KAAK,CAAC,KAAK,OAAO,MAAM,CAAC,CAAC;QACjC,kFAAkF;QAClF,MAAM,GAAG,GAAG,CAAC,IAAY,EAAE,EAAE;YAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;YACvD,OAAO,IAAI,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;QACxE,CAAC,CAAC;QACF,MAAM,IAAI,GAAG,GAAG,EAAE;YAChB,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAChC,MAAM,CAAC,KAAK,CACV,YAAY,GAAG,CAAC,GAAG,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,KAAK,GAAG,CAAC,KAAK,MAAM,EAAE,CAAC,IAAI,CACjF,CACF,CAAC;YACF,MAAM,CAAC,KAAK,CAAC,YAAY,GAAG,CAAC,2DAA2D,CAAC,EAAE,CAAC,CAAC;QAC/F,CAAC,CAAC;QACF,kBAAkB,CAAC,KAAK,CAAC,CAAC;QAC1B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YAC7B,IAAI,QAAQ,GAAG,KAAK,CAAC;YACrB,MAAM,MAAM,GAAG,CAAC,KAAc,EAAE,EAAE;gBAChC,IAAI,QAAQ;oBAAE,OAAO;gBACrB,QAAQ,GAAG,IAAI,CAAC;gBAChB,KAAK,CAAC,GAAG,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;gBAC7B,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;gBACxB,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;gBAC1B,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;gBAC1B,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;gBACzB,IAAI,CAAC,UAAU,EAAE,CAAC;oBAChB,KAAK,CAAC,KAAK,EAAE,CAAC;oBACd,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC;gBAClB,CAAC;gBACD,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBACnB,OAAO,CAAC,KAAK,CAAC,CAAC;YACjB,CAAC,CAAC;YACF,MAAM,KAAK,GAAG,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC;YAC7B,MAAM,KAAK,GAAG,CAAC,KAAa,EAAE,GAAQ,EAAE,EAAE;gBACxC,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;oBAC5E,OAAO,MAAM,EAAE,CAAC;gBAClB,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,IAAI,GAAG,CAAC,IAAI,KAAK,OAAO;oBAAE,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC;gBAC3E,IAAI,GAAG,CAAC,IAAI,KAAK,IAAI;oBAAE,QAAQ,GAAG,CAAC,QAAQ,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;qBAC9E,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM,IAAI,GAAG,CAAC,IAAI,KAAK,KAAK;oBAChD,QAAQ,GAAG,CAAC,QAAQ,GAAG,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;qBACxC,IAAI,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,OAAO,CAAC,MAAM;oBACnF,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;;oBACjC,OAAO;gBACZ,MAAM,CAAC,KAAK,CAAC,UAAU,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;gBAC1C,IAAI,EAAE,CAAC;YACT,CAAC,CAAC;YACF,KAAK,CAAC,EAAE,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;YAC5B,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;YACzB,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YAC3B,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YAC3B,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;YACvB,KAAK,CAAC,GAAG,EAAE,EAAE,CAAC;YACd,KAAK,CAAC,MAAM,EAAE,CAAC;YACf,IAAI,EAAE,CAAC;QACT,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/tool-updater.d.ts

@@ -0,0 +1,20 @@
+import { type CommandRunner, type Environment, type FileSystem, type HttpClient, type SemanticVersion, type ToolUpdateAction, type ToolUpdater } from '@senior-skills/core';
+export declare const TOOL_PACKAGE = "@senior-skills/cli";
+export declare const TOOL_VERSION_URL = "https://registry.npmjs.org/@senior-skills%2fcli/latest";
+interface Options {
+    readonly fs: FileSystem;
+    readonly env: Environment;
+    readonly commands: CommandRunner;
+    readonly http: HttpClient;
+    readonly packageDirectory: string;
+    readonly nodeExecutable: string;
+}
+/** npm metadata is data only. Neither commands nor executable paths come from the response. */
+export declare class NpmToolUpdater implements ToolUpdater {
+    private readonly options;
+    constructor(options: Options);
+    latestVersion(): Promise<SemanticVersion | undefined>;
+    action(version: SemanticVersion): Promise<ToolUpdateAction>;
+}
+export {};
+//# sourceMappingURL=tool-updater.d.ts.map

package/dist/tool-updater.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-updater.d.ts","sourceRoot":"","sources":["../src/tool-updater.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,WAAW,EACjB,MAAM,qBAAqB,CAAC;AAE7B,eAAO,MAAM,YAAY,uBAAuB,CAAC;AACjD,eAAO,MAAM,gBAAgB,2DAA2D,CAAC;AAEzF,UAAU,OAAO;IACf,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC;IACxB,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,+FAA+F;AAC/F,qBAAa,cAAe,YAAW,WAAW;IAChD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;gBAEtB,OAAO,EAAE,OAAO;IAItB,aAAa,IAAI,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC;IAmBrD,MAAM,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAkElE"}

package/dist/tool-updater.js

@@ -0,0 +1,96 @@
+import { AgentSkillsError, ErrorCode, isSemanticVersion, parseVersion, } from '@senior-skills/core';
+export const TOOL_PACKAGE = '@senior-skills/cli';
+export const TOOL_VERSION_URL = 'https://registry.npmjs.org/@senior-skills%2fcli/latest';
+/** npm metadata is data only. Neither commands nor executable paths come from the response. */
+export class NpmToolUpdater {
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    async latestVersion() {
+        const response = await this.options.http.get(TOOL_VERSION_URL, {
+            timeoutMs: 2000,
+            maxBytes: 256 * 1024,
+        });
+        if (response.status !== 200)
+            return undefined;
+        const raw = JSON.parse(new TextDecoder().decode(response.body));
+        if (raw === null || typeof raw !== 'object')
+            return undefined;
+        const version = raw['version'];
+        // Automatic notices target stable releases, even if a publisher mis-tags a prerelease.
+        if (typeof version !== 'string' ||
+            !/^\d+\.\d+\.\d+(?:\+[\w.-]+)?$/.test(version) ||
+            !isSemanticVersion(version))
+            return undefined;
+        return parseVersion(version);
+    }
+    async action(version) {
+        // Revalidate even cached metadata at the execution boundary.
+        if (!/^\d+\.\d+\.\d+(?:\+[\w.-]+)?$/.test(version) || !isSemanticVersion(version)) {
+            throw new AgentSkillsError(ErrorCode.INVALID_VERSION, 'Invalid CLI update version');
+        }
+        const { fs, env, commands, packageDirectory, nodeExecutable } = this.options;
+        const directory = await fs.realpath(packageDirectory);
+        const normalized = directory.replace(/\\/g, '/');
+        if (normalized.includes('/_npx/'))
+            return { label: `npx ${TOOL_PACKAGE}@${version} <command>` };
+        const manual = {
+            label: 'Update this installation with its original package manager, then restart senior-skills.',
+        };
+        if (fs.basename(directory) !== 'cli' || fs.basename(fs.dirname(directory)) !== '@senior-skills')
+            return manual;
+        const modules = fs.dirname(fs.dirname(directory));
+        if (fs.basename(modules) !== 'node_modules' || /\/(?:\.pnpm|\.yarn|\.bun)\//.test(normalized))
+            return manual;
+        const npm = await commands.which('npm');
+        if (npm === undefined)
+            return manual;
+        let executable = npm;
+        let prefix = [];
+        const realNpm = await fs.realpath(npm);
+        const script = /\.(?:cmd|bat)$/i.test(npm)
+            ? fs.join(fs.dirname(npm), 'node_modules', 'npm', 'bin', 'npm-cli.js')
+            : realNpm;
+        if (script.endsWith('.js') && (await fs.exists(script))) {
+            executable = nodeExecutable;
+            prefix = [script];
+        }
+        else if (/\.(?:cmd|bat)$/i.test(npm))
+            return manual;
+        const root = await commands.run(executable, [...prefix, 'root', '--global'], {
+            cwd: env.homeDir(),
+            timeoutMs: 2000,
+        });
+        const globalRoot = root.stdout.trim();
+        const isGlobal = root.code === 0 &&
+            fs.isAbsolute(globalRoot) &&
+            (await fs.exists(globalRoot)) &&
+            (await fs.realpath(globalRoot)) === (await fs.realpath(modules));
+        const cwd = isGlobal ? env.homeDir() : fs.dirname(modules);
+        let saveFlag = [];
+        if (!isGlobal) {
+            // A local update may edit a manifest/lockfile. Require evidence that npm owns it and
+            // that the CLI is a direct dependency, rather than converting a transitive install.
+            for (const lock of ['pnpm-lock.yaml', 'yarn.lock', 'bun.lock', 'bun.lockb']) {
+                if (await fs.exists(fs.join(cwd, lock)))
+                    return manual;
+            }
+            if (!(await fs.exists(fs.join(cwd, 'package-lock.json'))))
+                return manual;
+            const pkg = JSON.parse(await fs.readTextFile(fs.join(cwd, 'package.json')));
+            if (typeof pkg['devDependencies']?.[TOOL_PACKAGE] === 'string')
+                saveFlag = ['--save-dev'];
+            else if (typeof pkg['optionalDependencies']?.[TOOL_PACKAGE] === 'string')
+                saveFlag = ['--save-optional'];
+            else if (typeof pkg['dependencies']?.[TOOL_PACKAGE] !== 'string')
+                return manual;
+        }
+        const args = ['install', ...(isGlobal ? ['--global'] : saveFlag), `${TOOL_PACKAGE}@${version}`];
+        return {
+            label: `npm ${args.join(' ')}${isGlobal ? '' : ` (in ${cwd})`}`,
+            run: () => commands.run(executable, [...prefix, ...args], { cwd, timeoutMs: 300_000 }),
+        };
+    }
+}
+//# sourceMappingURL=tool-updater.js.map

package/dist/tool-updater.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-updater.js","sourceRoot":"","sources":["../src/tool-updater.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,SAAS,EACT,iBAAiB,EACjB,YAAY,GAQb,MAAM,qBAAqB,CAAC;AAE7B,MAAM,CAAC,MAAM,YAAY,GAAG,oBAAoB,CAAC;AACjD,MAAM,CAAC,MAAM,gBAAgB,GAAG,wDAAwD,CAAC;AAWzF,+FAA+F;AAC/F,MAAM,OAAO,cAAc;IACR,OAAO,CAAU;IAElC,YAAY,OAAgB;QAC1B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,aAAa;QACjB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,gBAAgB,EAAE;YAC7D,SAAS,EAAE,IAAI;YACf,QAAQ,EAAE,GAAG,GAAG,IAAI;SACrB,CAAC,CAAC;QACH,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG;YAAE,OAAO,SAAS,CAAC;QAC9C,MAAM,GAAG,GAAY,IAAI,CAAC,KAAK,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;QACzE,IAAI,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ;YAAE,OAAO,SAAS,CAAC;QAC9D,MAAM,OAAO,GAAI,GAA+B,CAAC,SAAS,CAAC,CAAC;QAC5D,uFAAuF;QACvF,IACE,OAAO,OAAO,KAAK,QAAQ;YAC3B,CAAC,+BAA+B,CAAC,IAAI,CAAC,OAAO,CAAC;YAC9C,CAAC,iBAAiB,CAAC,OAAO,CAAC;YAE3B,OAAO,SAAS,CAAC;QACnB,OAAO,YAAY,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,OAAwB;QACnC,6DAA6D;QAC7D,IAAI,CAAC,+BAA+B,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,EAAE,CAAC;YAClF,MAAM,IAAI,gBAAgB,CAAC,SAAS,CAAC,eAAe,EAAE,4BAA4B,CAAC,CAAC;QACtF,CAAC;QACD,MAAM,EAAE,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,gBAAgB,EAAE,cAAc,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC;QAC7E,MAAM,SAAS,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC;QACtD,MAAM,UAAU,GAAG,SAAS,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACjD,IAAI,UAAU,CAAC,QAAQ,CAAC,QAAQ,CAAC;YAAE,OAAO,EAAE,KAAK,EAAE,OAAO,YAAY,IAAI,OAAO,YAAY,EAAE,CAAC;QAChG,MAAM,MAAM,GAAG;YACb,KAAK,EACH,yFAAyF;SAC5F,CAAC;QACF,IAAI,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,KAAK,gBAAgB;YAC7F,OAAO,MAAM,CAAC;QAChB,MAAM,OAAO,GAAG,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;QAClD,IAAI,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,cAAc,IAAI,6BAA6B,CAAC,IAAI,CAAC,UAAU,CAAC;YAC3F,OAAO,MAAM,CAAC;QAEhB,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACxC,IAAI,GAAG,KAAK,SAAS;YAAE,OAAO,MAAM,CAAC;QACrC,IAAI,UAAU,GAAG,GAAG,CAAC;QACrB,IAAI,MAAM,GAAa,EAAE,CAAC;QAC1B,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QACvC,MAAM,MAAM,GAAG,iBAAiB,CAAC,IAAI,CAAC,GAAG,CAAC;YACxC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,cAAc,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,CAAC;YACtE,CAAC,CAAC,OAAO,CAAC;QACZ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;YACxD,UAAU,GAAG,cAAc,CAAC;YAC5B,MAAM,GAAG,CAAC,MAAM,CAAC,CAAC;QACpB,CAAC;aAAM,IAAI,iBAAiB,CAAC,IAAI,CAAC,GAAG,CAAC;YAAE,OAAO,MAAM,CAAC;QAEtD,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,GAAG,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE;YAC3E,GAAG,EAAE,GAAG,CAAC,OAAO,EAAE;YAClB,SAAS,EAAE,IAAI;SAChB,CAAC,CAAC;QACH,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QACtC,MAAM,QAAQ,GACZ,IAAI,CAAC,IAAI,KAAK,CAAC;YACf,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC;YACzB,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;YAC7B,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;QACnE,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC3D,IAAI,QAAQ,GAAa,EAAE,CAAC;QAC5B,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,qFAAqF;YACrF,oFAAoF;YACpF,KAAK,MAAM,IAAI,IAAI,CAAC,gBAAgB,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,CAAC,EAAE,CAAC;gBAC5E,IAAI,MAAM,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;oBAAE,OAAO,MAAM,CAAC;YACzD,CAAC;YACD,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,mBAAmB,CAAC,CAAC,CAAC;gBAAE,OAAO,MAAM,CAAC;YACzE,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,YAAY,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC,CAGzE,CAAC;YACF,IAAI,OAAO,GAAG,CAAC,iBAAiB,CAAC,EAAE,CAAC,YAAY,CAAC,KAAK,QAAQ;gBAAE,QAAQ,GAAG,CAAC,YAAY,CAAC,CAAC;iBACrF,IAAI,OAAO,GAAG,CAAC,sBAAsB,CAAC,EAAE,CAAC,YAAY,CAAC,KAAK,QAAQ;gBACtE,QAAQ,GAAG,CAAC,iBAAiB,CAAC,CAAC;iBAC5B,IAAI,OAAO,GAAG,CAAC,cAAc,CAAC,EAAE,CAAC,YAAY,CAAC,KAAK,QAAQ;gBAAE,OAAO,MAAM,CAAC;QAClF,CAAC;QACD,MAAM,IAAI,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,GAAG,YAAY,IAAI,OAAO,EAAE,CAAC,CAAC;QAChG,OAAO;YACL,KAAK,EAAE,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,GAAG,EAAE;YAC/D,GAAG,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,GAAG,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC;SACvF,CAAC;IACJ,CAAC;CACF"}

package/dist/update-state.d.ts

@@ -0,0 +1,10 @@
+import { type Environment, type FileSystem, type UpdateState, type UpdateStateStore } from '@senior-skills/core';
+/** Corrupt or newer advisory state is discarded; it must never break a CLI command. */
+export declare class FileUpdateStateStore implements UpdateStateStore {
+    private readonly fs;
+    private readonly path;
+    constructor(fs: FileSystem, env: Environment);
+    load(): Promise<UpdateState>;
+    save(state: UpdateState): Promise<void>;
+}
+//# sourceMappingURL=update-state.d.ts.map

package/dist/update-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-state.d.ts","sourceRoot":"","sources":["../src/update-state.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,WAAW,EAChB,KAAK,UAAU,EAEf,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACtB,MAAM,qBAAqB,CAAC;AAG7B,uFAAuF;AACvF,qBAAa,oBAAqB,YAAW,gBAAgB;IAC3D,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAa;IAChC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;gBAElB,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,WAAW;IAKtC,IAAI,IAAI,OAAO,CAAC,WAAW,CAAC;IAuC5B,IAAI,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;CAY9C"}

package/dist/update-state.js

@@ -0,0 +1,70 @@
+import { emptyUpdateState, isSemanticVersion, } from '@senior-skills/core';
+import { configHome } from "./config-store.js";
+/** Corrupt or newer advisory state is discarded; it must never break a CLI command. */
+export class FileUpdateStateStore {
+    fs;
+    path;
+    constructor(fs, env) {
+        this.fs = fs;
+        this.path = fs.join(configHome(fs, env), 'updates.json');
+    }
+    async load() {
+        try {
+            if ((await this.fs.lstat(this.path)).size > 1024 * 1024)
+                return emptyUpdateState();
+            const raw = JSON.parse(await this.fs.readTextFile(this.path));
+            if (!record(raw) || raw['schemaVersion'] !== 1)
+                return emptyUpdateState();
+            const checks = {};
+            if (record(raw['checks'])) {
+                for (const [key, value] of Object.entries(raw['checks']).slice(-1000)) {
+                    if (!record(value) || !timestamp(value['checkedAt']) || !Array.isArray(value['versions']))
+                        continue;
+                    const versions = value['versions'];
+                    if (!versions.every((v) => typeof v === 'string' && isSemanticVersion(v)))
+                        continue;
+                    Object.defineProperty(checks, key, {
+                        value: { checkedAt: value['checkedAt'], versions: versions },
+                        enumerable: true,
+                        writable: true,
+                        configurable: true,
+                    });
+                }
+            }
+            const dismissed = Array.isArray(raw['dismissed'])
+                ? raw['dismissed']
+                    .filter((id) => typeof id === 'string')
+                    .slice(-1000)
+                : [];
+            const deferred = record(raw['deferred'])
+                ? Object.fromEntries(Object.entries(raw['deferred'])
+                    .filter((entry) => timestamp(entry[1]))
+                    .slice(-1000))
+                : {};
+            return { checks, dismissed, deferred };
+        }
+        catch {
+            return emptyUpdateState();
+        }
+    }
+    async save(state) {
+        const parent = this.fs.dirname(this.path);
+        await this.fs.mkdirp(parent);
+        const staging = await this.fs.makeTempDir(parent, '.updates-');
+        try {
+            const file = this.fs.join(staging, 'updates.json');
+            await this.fs.writeFile(file, `${JSON.stringify({ schemaVersion: 1, ...state })}\n`);
+            await this.fs.rename(file, this.path);
+        }
+        finally {
+            await this.fs.remove(staging);
+        }
+    }
+}
+function record(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+function timestamp(value) {
+    return typeof value === 'number' && Number.isFinite(value) && value >= 0;
+}
+//# sourceMappingURL=update-state.js.map

package/dist/update-state.js.map

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