@senior-skills/node 1.0.0

package/dist/archive.d.ts

@@ -0,0 +1,25 @@
+import { type ArchiveEntry, type ArchiveReader } from '@senior-skills/core';
+/**
+ * Reads `.tar.gz` payloads into memory.
+ *
+ * This class only *parses*; it deliberately makes no safety decisions. Entry paths, link
+ * types and sizes are handed to the installer exactly as the archive recorded them, so every
+ * rejection rule lives in one reviewed place (`SafeExtractor`) instead of being split across
+ * a parser and a consumer.
+ *
+ * The one thing enforced here is resource exhaustion: decompression stops as soon as the
+ * output exceeds the configured budget, which is what makes a gzip bomb a fast error rather
+ * than an out-of-memory kill.
+ */
+export interface ArchiveLimits {
+    readonly maxEntries: number;
+    readonly maxEntryBytes: number;
+    readonly maxTotalBytes: number;
+}
+export declare const DEFAULT_ARCHIVE_LIMITS: ArchiveLimits;
+export declare class NodeArchiveReader implements ArchiveReader {
+    private readonly limits;
+    constructor(limits?: ArchiveLimits);
+    read(data: Uint8Array): Promise<readonly ArchiveEntry[]>;
+}
+//# sourceMappingURL=archive.d.ts.map

package/dist/archive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"archive.d.ts","sourceRoot":"","sources":["../src/archive.ts"],"names":[],"mappings":"AAGA,OAAO,EAGL,KAAK,YAAY,EACjB,KAAK,aAAa,EACnB,MAAM,qBAAqB,CAAC;AAE7B;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED,eAAO,MAAM,sBAAsB,EAAE,aAIpC,CAAC;AAEF,qBAAa,iBAAkB,YAAW,aAAa;IACrD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;gBAE3B,MAAM,GAAE,aAAsC;IAIpD,IAAI,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,YAAY,EAAE,CAAC;CAyG/D"}

package/dist/archive.js

@@ -0,0 +1,101 @@
+import { Readable } from 'node:stream';
+import { createGunzip } from 'node:zlib';
+import * as tar from 'tar';
+import { AgentSkillsError, ErrorCode, } from '@senior-skills/core';
+export const DEFAULT_ARCHIVE_LIMITS = {
+    maxEntries: 5_000,
+    maxEntryBytes: 16 * 1024 * 1024,
+    maxTotalBytes: 64 * 1024 * 1024,
+};
+export class NodeArchiveReader {
+    limits;
+    constructor(limits = DEFAULT_ARCHIVE_LIMITS) {
+        this.limits = limits;
+    }
+    async read(data) {
+        const entries = [];
+        let totalBytes = 0;
+        const parser = new tar.Parser({
+            // Never let the parser itself resolve or strip anything; we want the raw recorded path.
+            strict: false,
+        });
+        const finished = new Promise((resolve, reject) => {
+            parser.on('entry', (entry) => {
+                if (entries.length >= this.limits.maxEntries) {
+                    reject(new AgentSkillsError(ErrorCode.UNSAFE_ARCHIVE, `Archive contains more than ${this.limits.maxEntries} entries`, { data: { maxEntries: this.limits.maxEntries } }));
+                    entry.resume();
+                    return;
+                }
+                const chunks = [];
+                let size = 0;
+                entry.on('data', (chunk) => {
+                    size += chunk.length;
+                    totalBytes += chunk.length;
+                    if (size > this.limits.maxEntryBytes) {
+                        reject(new AgentSkillsError(ErrorCode.UNSAFE_ARCHIVE, `Archive entry "${entry.path}" exceeds ${this.limits.maxEntryBytes} bytes`, { data: { path: entry.path, maxEntryBytes: this.limits.maxEntryBytes } }));
+                        return;
+                    }
+                    if (totalBytes > this.limits.maxTotalBytes) {
+                        reject(new AgentSkillsError(ErrorCode.UNSAFE_ARCHIVE, `Archive expands to more than ${this.limits.maxTotalBytes} bytes`, {
+                            details: ['This is the signature of a decompression bomb.'],
+                            data: { maxTotalBytes: this.limits.maxTotalBytes },
+                        }));
+                        return;
+                    }
+                    chunks.push(chunk);
+                });
+                entry.on('end', () => {
+                    entries.push({
+                        path: String(entry.path),
+                        type: toEntryType(entry.type),
+                        size,
+                        mode: entry.mode ?? 0,
+                        ...(entry.linkpath == null ? {} : { linkTarget: String(entry.linkpath) }),
+                        bytes: new Uint8Array(Buffer.concat(chunks)),
+                    });
+                });
+            });
+            parser.on('error', (cause) => reject(new AgentSkillsError(ErrorCode.UNSAFE_ARCHIVE, 'Could not read archive', {
+                details: [cause.message],
+                hints: ['The download may be truncated or is not a valid .tar.gz'],
+                cause,
+            })));
+            parser.on('end', () => resolve());
+        });
+        const gunzip = createGunzip();
+        gunzip.on('error', () => {
+            /* surfaced through the pipeline promise below */
+        });
+        await Promise.all([
+            finished,
+            new Promise((resolve, reject) => {
+                Readable.from([Buffer.from(data)])
+                    .pipe(gunzip)
+                    .on('error', (cause) => reject(new AgentSkillsError(ErrorCode.UNSAFE_ARCHIVE, 'Could not decompress archive', {
+                    details: [cause.message],
+                    cause,
+                })))
+                    .pipe(parser)
+                    .on('finish', () => resolve())
+                    .on('error', reject);
+            }),
+        ]);
+        return entries;
+    }
+}
+function toEntryType(type) {
+    switch (type) {
+        case 'File':
+        case 'OldFile':
+        case 'ContiguousFile':
+            return 'file';
+        case 'Directory':
+            return 'directory';
+        case 'SymbolicLink':
+        case 'Link':
+            return 'symlink';
+        default:
+            return 'other';
+    }
+}
+//# sourceMappingURL=archive.js.map

package/dist/archive.js.map

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

package/dist/config-store.d.ts

@@ -0,0 +1,27 @@
+import { type AgentSkillsConfig, type ConfigStore, type Environment, type FileSystem, type RegistryConfig, type RegistryKind } from '@senior-skills/core';
+export declare const CONFIG_SCHEMA_VERSION = 1;
+export declare const CONFIG_DIRNAME = ".senior-skills";
+export declare const CONFIG_FILENAME = "config.json";
+/** Overrides the whole `~/.senior-skills` directory. Primarily how the tests stay hermetic. */
+export declare const HOME_ENV_VAR = "SENIOR_SKILLS_HOME";
+export declare const OFFICIAL_REGISTRY: RegistryConfig;
+export declare function defaultConfig(): AgentSkillsConfig;
+/**
+ * JSON configuration in `~/.senior-skills/config.json`.
+ *
+ * Written atomically: a half-flushed config would be worse than none, since the registry list
+ * is what determines where the tool downloads executable-adjacent content from.
+ */
+export declare class FileConfigStore implements ConfigStore {
+    private readonly fs;
+    private readonly env;
+    constructor(fs: FileSystem, env: Environment);
+    location(): string;
+    load(): Promise<AgentSkillsConfig>;
+    save(config: AgentSkillsConfig): Promise<void>;
+}
+export declare function configHome(fs: FileSystem, env: Environment): string;
+export declare function cacheHome(fs: FileSystem, env: Environment): string;
+/** Kind can be declared, but is inferred from the URL when omitted — the common case. */
+export declare function inferKind(declared: unknown, url: string): RegistryKind;
+//# sourceMappingURL=config-store.d.ts.map

package/dist/config-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-store.d.ts","sourceRoot":"","sources":["../src/config-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,YAAY,EAClB,MAAM,qBAAqB,CAAC;AAE7B,eAAO,MAAM,qBAAqB,IAAI,CAAC;AACvC,eAAO,MAAM,cAAc,mBAAmB,CAAC;AAC/C,eAAO,MAAM,eAAe,gBAAgB,CAAC;AAE7C,+FAA+F;AAC/F,eAAO,MAAM,YAAY,uBAAuB,CAAC;AAEjD,eAAO,MAAM,iBAAiB,EAAE,cAK/B,CAAC;AAEF,wBAAgB,aAAa,IAAI,iBAAiB,CAOjD;AAED;;;;;GAKG;AACH,qBAAa,eAAgB,YAAW,WAAW;IACjD,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAa;IAChC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAc;gBAEtB,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,WAAW;IAK5C,QAAQ,IAAI,MAAM;IAIZ,IAAI,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAyClC,IAAI,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;CAOrD;AAED,wBAAgB,UAAU,CAAC,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,WAAW,GAAG,MAAM,CAInE;AAED,wBAAgB,SAAS,CAAC,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,WAAW,GAAG,MAAM,CAElE;AA4CD,yFAAyF;AACzF,wBAAgB,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,YAAY,CAYtE"}

package/dist/config-store.js

@@ -0,0 +1,155 @@
+import { AgentSkillsError, ErrorCode, } from '@senior-skills/core';
+export const CONFIG_SCHEMA_VERSION = 1;
+export const CONFIG_DIRNAME = '.senior-skills';
+export const CONFIG_FILENAME = 'config.json';
+/** Overrides the whole `~/.senior-skills` directory. Primarily how the tests stay hermetic. */
+export const HOME_ENV_VAR = 'SENIOR_SKILLS_HOME';
+export const OFFICIAL_REGISTRY = {
+    name: 'official',
+    url: 'https://github.com/robsonkades/senior-skills.git',
+    kind: 'git',
+    trusted: true,
+};
+export function defaultConfig() {
+    return {
+        schemaVersion: CONFIG_SCHEMA_VERSION,
+        registries: [OFFICIAL_REGISTRY],
+        agents: {},
+        cache: { ttlSeconds: 3600 },
+    };
+}
+/**
+ * JSON configuration in `~/.senior-skills/config.json`.
+ *
+ * Written atomically: a half-flushed config would be worse than none, since the registry list
+ * is what determines where the tool downloads executable-adjacent content from.
+ */
+export class FileConfigStore {
+    fs;
+    env;
+    constructor(fs, env) {
+        this.fs = fs;
+        this.env = env;
+    }
+    location() {
+        return this.fs.join(configHome(this.fs, this.env), CONFIG_FILENAME);
+    }
+    async load() {
+        const path = this.location();
+        if (!(await this.fs.exists(path)))
+            return defaultConfig();
+        let raw;
+        try {
+            raw = JSON.parse(await this.fs.readTextFile(path));
+        }
+        catch (cause) {
+            throw new AgentSkillsError(ErrorCode.USAGE, `Could not parse ${path}`, {
+                details: [cause instanceof Error ? cause.message : String(cause)],
+                hints: [`Fix the JSON, or delete ${path} to fall back to defaults`],
+                cause,
+                data: { path },
+            });
+        }
+        if (raw === null || typeof raw !== 'object' || Array.isArray(raw)) {
+            throw new AgentSkillsError(ErrorCode.USAGE, `${path} must be a JSON object`, {
+                data: { path },
+            });
+        }
+        const doc = raw;
+        const registries = readRegistries(doc['registries'], path);
+        return {
+            schemaVersion: typeof doc['schemaVersion'] === 'number' ? doc['schemaVersion'] : CONFIG_SCHEMA_VERSION,
+            // An empty list is a deliberate choice (offline / local-only), not a reason to
+            // silently reinstate the official registry.
+            registries,
+            agents: readAgents(doc['agents']),
+            cache: {
+                ttlSeconds: typeof doc['cache']?.['ttlSeconds'] === 'number'
+                    ? doc['cache']['ttlSeconds']
+                    : 3600,
+            },
+        };
+    }
+    async save(config) {
+        const path = this.location();
+        const staging = `${path}.tmp-${process.pid}`;
+        await this.fs.mkdirp(this.fs.dirname(path));
+        await this.fs.writeFile(staging, `${JSON.stringify(config, null, 2)}\n`);
+        await this.fs.rename(staging, path);
+    }
+}
+export function configHome(fs, env) {
+    const override = env.env()[HOME_ENV_VAR];
+    if (override !== undefined && override.trim() !== '')
+        return fs.resolve(override);
+    return fs.join(env.homeDir(), CONFIG_DIRNAME);
+}
+export function cacheHome(fs, env) {
+    return fs.join(configHome(fs, env), 'cache');
+}
+function readRegistries(value, path) {
+    if (value === undefined)
+        return defaultConfig().registries;
+    if (!Array.isArray(value)) {
+        throw new AgentSkillsError(ErrorCode.USAGE, `${path}: "registries" must be an array`, {
+            data: { path },
+        });
+    }
+    const seen = new Set();
+    const registries = [];
+    for (const entry of value) {
+        if (entry === null || typeof entry !== 'object')
+            continue;
+        const record = entry;
+        const name = record['name'];
+        const url = record['url'];
+        if (typeof name !== 'string' || typeof url !== 'string')
+            continue;
+        if (seen.has(name)) {
+            throw new AgentSkillsError(ErrorCode.REGISTRY_DUPLICATE, `${path}: duplicate registry "${name}"`, {
+                hints: ['Registry names must be unique; precedence is decided by list order'],
+                data: { path, name },
+            });
+        }
+        seen.add(name);
+        registries.push({
+            name,
+            url,
+            kind: inferKind(record['kind'], url),
+            trusted: record['trusted'] !== false,
+            ...(typeof record['ref'] === 'string' ? { ref: record['ref'] } : {}),
+        });
+    }
+    return registries;
+}
+/** Kind can be declared, but is inferred from the URL when omitted — the common case. */
+export function inferKind(declared, url) {
+    if (declared === 'git' || declared === 'http' || declared === 'local')
+        return declared;
+    if (url.startsWith('file://') ||
+        /^[a-zA-Z]:[\\/]/.test(url) ||
+        url.startsWith('/') ||
+        url.startsWith('.')) {
+        return 'local';
+    }
+    if (url.endsWith('.git') || url.includes('github.com') || url.includes('gitlab.'))
+        return 'git';
+    return 'http';
+}
+function readAgents(value) {
+    if (value === null || typeof value !== 'object' || Array.isArray(value))
+        return {};
+    const agents = {};
+    for (const [id, raw] of Object.entries(value)) {
+        if (raw === null || typeof raw !== 'object')
+            continue;
+        const record = raw;
+        agents[id] = {
+            enabled: record['enabled'] !== false,
+            ...(typeof record['globalRoot'] === 'string' ? { globalRoot: record['globalRoot'] } : {}),
+            ...(typeof record['projectRoot'] === 'string' ? { projectRoot: record['projectRoot'] } : {}),
+        };
+    }
+    return agents;
+}
+//# sourceMappingURL=config-store.js.map

package/dist/config-store.js.map

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

package/dist/file-system.d.ts

@@ -0,0 +1,40 @@
+import { type DirEntry, type FileStat, type FileSystem } from '@senior-skills/core';
+/**
+ * The real filesystem.
+ *
+ * Every `node:fs` call in the entire project lives in this class. Errors are translated into
+ * {@link AgentSkillsError} here so no higher layer ever has to interpret an `EACCES`.
+ */
+export declare class NodeFileSystem implements FileSystem {
+    readonly separator: "/" | "\\";
+    readFile(target: string): Promise<Uint8Array>;
+    readTextFile(target: string): Promise<string>;
+    writeFile(target: string, data: Uint8Array | string): Promise<void>;
+    exists(target: string): Promise<boolean>;
+    lstat(target: string): Promise<FileStat>;
+    stat(target: string): Promise<FileStat>;
+    readDir(target: string): Promise<readonly DirEntry[]>;
+    mkdirp(target: string): Promise<void>;
+    remove(target: string): Promise<void>;
+    rename(from: string, to: string): Promise<void>;
+    copyFile(from: string, to: string): Promise<void>;
+    realpath(target: string): Promise<string>;
+    readlink(target: string): Promise<string>;
+    makeTempDir(parent: string, prefix: string): Promise<string>;
+    /**
+     * Probes writability without writing.
+     *
+     * `fs.access(W_OK)` is unreliable on Windows for directories, so a failed probe there falls
+     * back to a create-and-delete on a uniquely named entry rather than reporting a false
+     * negative that would block a perfectly good install.
+     */
+    isWritable(target: string): Promise<boolean>;
+    join(...parts: readonly string[]): string;
+    resolve(...parts: readonly string[]): string;
+    dirname(target: string): string;
+    basename(target: string): string;
+    relative(from: string, to: string): string;
+    isAbsolute(target: string): boolean;
+    private guard;
+}
+//# sourceMappingURL=file-system.d.ts.map

package/dist/file-system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-system.d.ts","sourceRoot":"","sources":["../src/file-system.ts"],"names":[],"mappings":"AAIA,OAAO,EAGL,KAAK,QAAQ,EACb,KAAK,QAAQ,EACb,KAAK,UAAU,EAChB,MAAM,qBAAqB,CAAC;AAE7B;;;;;GAKG;AACH,qBAAa,cAAe,YAAW,UAAU;IAC/C,QAAQ,CAAC,SAAS,aAAY;IAExB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAI7C,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAI7C,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOnE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IASxC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAIxC,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAIvC,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,QAAQ,EAAE,CAAC;IAYrD,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMrC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMrC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO/C,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOjD,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAIzC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAIzC,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAOlE;;;;;;OAMG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAiBlD,IAAI,CAAC,GAAG,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM;IAIzC,OAAO,CAAC,GAAG,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM;IAI5C,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAI/B,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAIhC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM;IAI1C,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;YAIrB,KAAK;CAOpB"}

package/dist/file-system.js

@@ -0,0 +1,189 @@
+import { constants } from 'node:fs';
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { AgentSkillsError, ErrorCode, } from '@senior-skills/core';
+/**
+ * The real filesystem.
+ *
+ * Every `node:fs` call in the entire project lives in this class. Errors are translated into
+ * {@link AgentSkillsError} here so no higher layer ever has to interpret an `EACCES`.
+ */
+export class NodeFileSystem {
+    separator = path.sep;
+    async readFile(target) {
+        return this.guard(target, 'read', async () => new Uint8Array(await fs.readFile(target)));
+    }
+    async readTextFile(target) {
+        return this.guard(target, 'read', () => fs.readFile(target, 'utf8'));
+    }
+    async writeFile(target, data) {
+        return this.guard(target, 'write', async () => {
+            await fs.mkdir(path.dirname(target), { recursive: true });
+            await fs.writeFile(target, data);
+        });
+    }
+    async exists(target) {
+        try {
+            await fs.access(target, constants.F_OK);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async lstat(target) {
+        return this.guard(target, 'stat', async () => toStat(await fs.lstat(target)));
+    }
+    async stat(target) {
+        return this.guard(target, 'stat', async () => toStat(await fs.stat(target)));
+    }
+    async readDir(target) {
+        return this.guard(target, 'read', async () => {
+            const entries = await fs.readdir(target, { withFileTypes: true });
+            return entries.map((entry) => ({
+                name: entry.name,
+                isFile: entry.isFile(),
+                isDirectory: entry.isDirectory(),
+                isSymbolicLink: entry.isSymbolicLink(),
+            }));
+        });
+    }
+    async mkdirp(target) {
+        return this.guard(target, 'create', async () => {
+            await fs.mkdir(target, { recursive: true });
+        });
+    }
+    async remove(target) {
+        return this.guard(target, 'remove', async () => {
+            await fs.rm(target, { recursive: true, force: true });
+        });
+    }
+    async rename(from, to) {
+        return this.guard(to, 'rename', async () => {
+            await fs.mkdir(path.dirname(to), { recursive: true });
+            await fs.rename(from, to);
+        });
+    }
+    async copyFile(from, to) {
+        return this.guard(to, 'copy', async () => {
+            await fs.mkdir(path.dirname(to), { recursive: true });
+            await fs.copyFile(from, to);
+        });
+    }
+    async realpath(target) {
+        return this.guard(target, 'resolve', () => fs.realpath(target));
+    }
+    async readlink(target) {
+        return this.guard(target, 'read', () => fs.readlink(target));
+    }
+    async makeTempDir(parent, prefix) {
+        return this.guard(parent, 'create', async () => {
+            await fs.mkdir(parent, { recursive: true });
+            return fs.mkdtemp(path.join(parent, prefix));
+        });
+    }
+    /**
+     * Probes writability without writing.
+     *
+     * `fs.access(W_OK)` is unreliable on Windows for directories, so a failed probe there falls
+     * back to a create-and-delete on a uniquely named entry rather than reporting a false
+     * negative that would block a perfectly good install.
+     */
+    async isWritable(target) {
+        try {
+            await fs.access(target, constants.W_OK);
+            return true;
+        }
+        catch {
+            if (process.platform !== 'win32')
+                return false;
+        }
+        const probe = path.join(target, `.senior-skills-write-probe-${process.pid}-${Date.now()}`);
+        try {
+            await fs.writeFile(probe, '');
+            await fs.rm(probe, { force: true });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    join(...parts) {
+        return path.join(...parts);
+    }
+    resolve(...parts) {
+        return path.resolve(...parts);
+    }
+    dirname(target) {
+        return path.dirname(target);
+    }
+    basename(target) {
+        return path.basename(target);
+    }
+    relative(from, to) {
+        return path.relative(from, to);
+    }
+    isAbsolute(target) {
+        return path.isAbsolute(target);
+    }
+    async guard(target, action, work) {
+        try {
+            return await work();
+        }
+        catch (cause) {
+            throw translate(cause, target, action);
+        }
+    }
+}
+function toStat(stats) {
+    return {
+        isFile: stats.isFile(),
+        isDirectory: stats.isDirectory(),
+        isSymbolicLink: stats.isSymbolicLink(),
+        size: stats.size,
+        mtimeMs: stats.mtimeMs,
+        mode: stats.mode,
+    };
+}
+function translate(cause, target, action) {
+    const code = cause?.code;
+    if (code === 'EACCES' || code === 'EPERM') {
+        return new AgentSkillsError(ErrorCode.PERMISSION_DENIED, `Permission denied: cannot ${action} ${target}`, {
+            hints: [
+                'Check the directory permissions',
+                process.platform === 'win32'
+                    ? 'On Windows, a file open in another program can also cause this'
+                    : 'Avoid sudo; install into a directory you own, or use --project',
+            ],
+            cause,
+            data: { path: target, action, errno: code },
+        });
+    }
+    if (code === 'ENOENT') {
+        return new AgentSkillsError(ErrorCode.IO_ERROR, `No such file or directory: ${target}`, {
+            cause,
+            data: { path: target, action, errno: code },
+        });
+    }
+    if (code === 'ENOSPC') {
+        return new AgentSkillsError(ErrorCode.IO_ERROR, `No space left on device while trying to ${action} ${target}`, {
+            cause,
+            data: { path: target, action, errno: code },
+        });
+    }
+    if (code === 'EXDEV') {
+        // The installer stages beside the target precisely to avoid this; seeing it means an
+        // assumption broke, so say so rather than silently degrading to a copy.
+        return new AgentSkillsError(ErrorCode.INSTALL_FAILED, `Cannot ${action} ${target}: source and destination are on different filesystems`, {
+            hints: ['Report this: staging is meant to happen on the destination filesystem'],
+            cause,
+            data: { path: target, action, errno: code },
+        });
+    }
+    return new AgentSkillsError(ErrorCode.IO_ERROR, `Failed to ${action} ${target}`, {
+        details: [cause instanceof Error ? cause.message : String(cause)],
+        cause,
+        data: { path: target, action, ...(code === undefined ? {} : { errno: code }) },
+    });
+}
+//# sourceMappingURL=file-system.js.map

package/dist/file-system.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * `@senior-skills/node` — Node.js implementations of the infrastructure ports.
+ *
+ * This is the only package that imports `node:fs`, `node:child_process`, `fetch` or `tar`.
+ * Swapping it out is how the rest of the system would run on a different runtime.
+ */
+export { NodeFileSystem } from './file-system.ts';
+export { FileUpdateStateStore } from './update-state.ts';
+export { NpmToolUpdater } from './tool-updater.ts';
+export { NodeSelectionPrompt } from './selection-prompt.ts';
+export { ConsoleLogger, NodeCommandRunner, NodeEnvironment, NodeHasher, NodeHttpClient, SystemClock, } from './runtime.ts';
+export { DEFAULT_ARCHIVE_LIMITS, NodeArchiveReader, type ArchiveLimits } from './archive.ts';
+export { CONFIG_DIRNAME, CONFIG_FILENAME, CONFIG_SCHEMA_VERSION, FileConfigStore, HOME_ENV_VAR, OFFICIAL_REGISTRY, cacheHome, configHome, defaultConfig, inferKind, } from './config-store.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,UAAU,EACV,cAAc,EACd,WAAW,GACZ,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7F,OAAO,EACL,cAAc,EACd,eAAe,EACf,qBAAqB,EACrB,eAAe,EACf,YAAY,EACZ,iBAAiB,EACjB,SAAS,EACT,UAAU,EACV,aAAa,EACb,SAAS,GACV,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,14 @@
+/**
+ * `@senior-skills/node` — Node.js implementations of the infrastructure ports.
+ *
+ * This is the only package that imports `node:fs`, `node:child_process`, `fetch` or `tar`.
+ * Swapping it out is how the rest of the system would run on a different runtime.
+ */
+export { NodeFileSystem } from "./file-system.js";
+export { FileUpdateStateStore } from "./update-state.js";
+export { NpmToolUpdater } from "./tool-updater.js";
+export { NodeSelectionPrompt } from "./selection-prompt.js";
+export { ConsoleLogger, NodeCommandRunner, NodeEnvironment, NodeHasher, NodeHttpClient, SystemClock, } from "./runtime.js";
+export { DEFAULT_ARCHIVE_LIMITS, NodeArchiveReader } from "./archive.js";
+export { CONFIG_DIRNAME, CONFIG_FILENAME, CONFIG_SCHEMA_VERSION, FileConfigStore, HOME_ENV_VAR, OFFICIAL_REGISTRY, cacheHome, configHome, defaultConfig, inferKind, } from "./config-store.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,UAAU,EACV,cAAc,EACd,WAAW,GACZ,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,sBAAsB,EAAE,iBAAiB,EAAsB,MAAM,cAAc,CAAC;AAC7F,OAAO,EACL,cAAc,EACd,eAAe,EACf,qBAAqB,EACrB,eAAe,EACf,YAAY,EACZ,iBAAiB,EACjB,SAAS,EACT,UAAU,EACV,aAAa,EACb,SAAS,GACV,MAAM,mBAAmB,CAAC"}