@senior-skills/core 1.0.0

package/dist/testing/doubles.js

@@ -0,0 +1,299 @@
+import { INTEGRITY_PREFIX } from "../domain/integrity.js";
+import { MANIFEST_FILENAME, entrypointFor, parseManifest, } from "../domain/manifest.js";
+import { buildSkillPackage, encodeText, } from "../domain/skill-package.js";
+import { AgentSkillsError, ErrorCode } from "../domain/errors.js";
+/** Fixed clock, so anything that records a timestamp is assertable. */
+export class FixedClock {
+    current;
+    constructor(iso = '2026-01-01T00:00:00.000Z') {
+        this.current = new Date(iso);
+    }
+    now() {
+        return this.current;
+    }
+    advance(milliseconds) {
+        this.current = new Date(this.current.getTime() + milliseconds);
+    }
+}
+export class FakeEnvironment {
+    options;
+    constructor(options = {}) {
+        this.options = {
+            homeDir: options.homeDir ?? '/home/dev',
+            cwd: options.cwd ?? '/work/project',
+            tempDir: options.tempDir ?? '/tmp',
+            platform: options.platform ?? 'linux',
+            env: { ...(options.env ?? {}) },
+        };
+    }
+    homeDir() {
+        return this.options.homeDir;
+    }
+    cwd() {
+        return this.options.cwd;
+    }
+    tempDir() {
+        return this.options.tempDir;
+    }
+    platform() {
+        return this.options.platform;
+    }
+    env() {
+        return this.options.env;
+    }
+    setEnv(key, value) {
+        this.options.env[key] = value;
+    }
+    setCwd(cwd) {
+        this.options.cwd = cwd;
+    }
+}
+/**
+ * Deterministic content hash. Not cryptographic — tests need a hash that changes when content
+ * changes and is stable across runs, and a real SHA-256 makes expected values unreadable.
+ */
+export class FakeHasher {
+    files = new Map();
+    hash(data) {
+        let value = 2166136261;
+        for (const byte of data) {
+            value ^= byte;
+            value = Math.imul(value, 16777619) >>> 0;
+        }
+        return `${INTEGRITY_PREFIX}${value.toString(16).padStart(8, '0')}`;
+    }
+    async hashFile(path) {
+        const bytes = this.files.get(path);
+        if (bytes === undefined)
+            throw new AgentSkillsError(ErrorCode.IO_ERROR, `Unknown file: ${path}`);
+        return this.hash(bytes);
+    }
+    register(path, bytes) {
+        this.files.set(path, bytes);
+    }
+}
+/** Hashes through a filesystem, so `hashFile` works against the in-memory double. */
+export function hasherOver(fs) {
+    const base = new FakeHasher();
+    return {
+        hash: (data) => base.hash(data),
+        hashFile: async (path) => base.hash(await fs.readFile(path)),
+    };
+}
+export class RecordingLogger {
+    lines = [];
+    debug(message) {
+        this.lines.push({ level: 'debug', message });
+    }
+    info(message) {
+        this.lines.push({ level: 'info', message });
+    }
+    warn(message) {
+        this.lines.push({ level: 'warn', message });
+    }
+    error(message) {
+        this.lines.push({ level: 'error', message });
+    }
+    messages(level) {
+        return this.lines
+            .filter((line) => level === undefined || line.level === level)
+            .map((line) => line.message);
+    }
+}
+export class FakeCommandRunner {
+    calls = [];
+    available;
+    results;
+    constructor(options = {}) {
+        this.available = new Set(options.available ?? []);
+        this.results = new Map(Object.entries(options.results ?? {}));
+    }
+    async run(command, args, _options) {
+        this.calls.push({ command, args });
+        return this.results.get(`${command} ${args.join(' ')}`) ?? { code: 0, stdout: '', stderr: '' };
+    }
+    async which(command) {
+        return this.available.has(command) ? `/usr/bin/${command}` : undefined;
+    }
+}
+export class FakeHttpClient {
+    requests = [];
+    responses;
+    constructor(responses = {}) {
+        this.responses = new Map(Object.entries(responses).map(([url, response]) => [
+            url,
+            typeof response === 'string'
+                ? { status: 200, headers: {}, body: encodeText(response) }
+                : response,
+        ]));
+    }
+    async get(url, _options) {
+        this.requests.push(url);
+        return this.responses.get(url) ?? { status: 404, headers: {}, body: new Uint8Array() };
+    }
+}
+/** Builds a valid in-memory package. Keeps every test from hand-writing YAML. */
+export function buildPackage(options) {
+    const kind = options.kind ?? 'skill';
+    const entrypoint = entrypointFor(kind);
+    const description = options.description ??
+        `A test ${kind} named ${options.name}. Use it when testing ${options.name}.`;
+    const manifestYaml = [
+        'schemaVersion: 1',
+        `name: ${options.name}`,
+        ...(kind === 'skill' ? [] : [`kind: ${kind}`]),
+        `version: ${options.version}`,
+        `description: ${JSON.stringify(description)}`,
+        'license: Apache-2.0',
+        ...(options.agents === undefined
+            ? []
+            : ['compatibility:', '  agents:', ...options.agents.map((agent) => `    - id: ${agent}`)]),
+        'files:',
+        `  - ${entrypoint}`,
+        '  - skill.yaml',
+        ...Object.keys(options.extraFiles ?? {}).map((path) => `  - ${path}`),
+        ...(options.dependencies === undefined
+            ? []
+            : [
+                'dependencies:',
+                ...Object.entries(options.dependencies).flatMap(([name, range]) => [
+                    `  - name: ${name}`,
+                    `    version: "${range}"`,
+                ]),
+            ]),
+        ...(options.optionalDependencies === undefined
+            ? []
+            : [
+                'optionalDependencies:',
+                ...Object.entries(options.optionalDependencies).flatMap(([name, range]) => [
+                    `  - name: ${name}`,
+                    `    version: "${range}"`,
+                ]),
+            ]),
+        ...(options.manifestExtras === undefined ? [] : [options.manifestExtras]),
+        '',
+    ].join('\n');
+    const skillMd = [
+        '---',
+        `name: ${options.name}`,
+        `description: ${JSON.stringify(description)}`,
+        '---',
+        '',
+        options.body ??
+            [
+                `# ${options.name}`,
+                '',
+                'This is a test package body long enough to satisfy the minimum-content check.',
+            ].join('\n'),
+        '',
+    ].join('\n');
+    const workflowJs = [
+        'export const meta = {',
+        `  name: ${JSON.stringify(options.name)},`,
+        `  description: ${JSON.stringify(description)},`,
+        ...Object.entries(options.meta ?? {}).map(([key, value]) => `  ${key}: ${JSON.stringify(value)},`),
+        '};',
+        '',
+        options.body ??
+            [
+                "phase('Only');",
+                "log('A test workflow body long enough to satisfy the minimum-content check.');",
+            ].join('\n'),
+        '',
+    ].join('\n');
+    const entrypointText = kind === 'workflow' ? workflowJs : skillMd;
+    const files = [
+        { path: entrypoint, bytes: encodeText(entrypointText) },
+        { path: MANIFEST_FILENAME, bytes: encodeText(manifestYaml) },
+        ...Object.entries(options.extraFiles ?? {}).map(([path, content]) => ({
+            path,
+            bytes: encodeText(content),
+        })),
+    ];
+    const { manifest } = parseManifest(manifestYaml, { source: `${options.name}/skill.yaml` });
+    return buildSkillPackage(manifest, files);
+}
+/** An in-memory {@link SkillRegistry}, sufficient for every resolver and federation test. */
+export class FakeRegistry {
+    name;
+    kind;
+    trusted;
+    fetches = [];
+    packages;
+    deprecated;
+    offline;
+    constructor(options) {
+        this.name = options.name;
+        this.kind = options.kind ?? 'local';
+        this.trusted = options.trusted ?? true;
+        this.packages = options.packages;
+        this.deprecated = new Set(options.deprecated ?? []);
+        this.offline = options.offline ?? false;
+    }
+    async refresh() {
+        this.assertOnline();
+    }
+    async search(query) {
+        this.assertOnline();
+        const text = query.text.toLowerCase();
+        const names = [...new Set(this.packages.map((pkg) => pkg.manifest.name))].sort();
+        return names
+            .filter((name) => text === '' || name.toLowerCase().includes(text))
+            .map((name) => {
+            const newest = this.newest(name);
+            return {
+                name,
+                description: newest.manifest.description,
+                keywords: newest.manifest.keywords,
+                latest: newest.manifest.version,
+                registry: this.name,
+            };
+        });
+    }
+    async has(name) {
+        this.assertOnline();
+        return this.packages.some((pkg) => pkg.manifest.name === name);
+    }
+    async versions(name) {
+        this.assertOnline();
+        return this.packages
+            .filter((pkg) => pkg.manifest.name === name)
+            .map((pkg) => ({
+            version: pkg.manifest.version,
+            path: `skills/${name}`,
+            deprecated: this.deprecated.has(`${name}@${pkg.manifest.version}`),
+        }))
+            .sort((a, b) => (a.version < b.version ? 1 : -1));
+    }
+    async manifest(name, version) {
+        return this.require(name, version).manifest;
+    }
+    async fetch(name, version) {
+        this.fetches.push(`${name}@${version}`);
+        const pkg = this.require(name, version);
+        return {
+            pkg,
+            registry: this.name,
+            resolved: `fake://${this.name}/${name}@${version}`,
+            integrity: `${INTEGRITY_PREFIX}${name}-${version}`,
+        };
+    }
+    newest(name) {
+        return this.packages
+            .filter((pkg) => pkg.manifest.name === name)
+            .sort((a, b) => (a.manifest.version < b.manifest.version ? 1 : -1))[0];
+    }
+    require(name, version) {
+        const found = this.packages.find((pkg) => pkg.manifest.name === name && pkg.manifest.version === version);
+        if (found === undefined) {
+            throw new AgentSkillsError(ErrorCode.VERSION_NOT_FOUND, `${name}@${version} not in ${this.name}`);
+        }
+        return found;
+    }
+    assertOnline() {
+        if (this.offline) {
+            throw new AgentSkillsError(ErrorCode.REGISTRY_UNAVAILABLE, `Registry "${this.name}" is offline`);
+        }
+    }
+}
+//# sourceMappingURL=doubles.js.map

package/dist/testing/doubles.js.map

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

package/dist/testing/in-memory-file-system.d.ts

@@ -0,0 +1,61 @@
+import type { DirEntry, FileStat, FileSystem } from '../ports/infrastructure.ts';
+export interface InMemoryFileSystemOptions {
+    /** `/` by default; set to `\\` to reproduce Windows path handling in a test. */
+    readonly separator?: string;
+    /** Root the filesystem is anchored at, e.g. `/` or `C:\\`. */
+    readonly root?: string;
+    /** Paths under which writes fail with a permission error. */
+    readonly readOnlyPaths?: readonly string[];
+}
+/**
+ * A complete in-memory {@link FileSystem}.
+ *
+ * Exported from the package (rather than living in a test folder) so adapter authors outside
+ * this repository can test their own adapters against the same double the built-in ones use.
+ *
+ * It models the things that actually cause cross-platform bugs: separator handling, symlinks,
+ * and non-writable directories.
+ */
+export declare class InMemoryFileSystem implements FileSystem {
+    readonly separator: string;
+    private readonly nodes;
+    private readonly root;
+    private readonly readOnlyPaths;
+    private tempCounter;
+    private clock;
+    constructor(options?: InMemoryFileSystemOptions);
+    /** Seeds files in one call: `{ '/a/b.txt': 'hello' }`. Parent directories are created. */
+    seed(files: Readonly<Record<string, string | Uint8Array>>): this;
+    symlink(from: string, to: string): this;
+    /** Every path currently present, sorted. Useful for asserting on a whole tree at once. */
+    snapshot(): readonly string[];
+    textAt(path: string): string | undefined;
+    readFile(path: string): Promise<Uint8Array>;
+    readTextFile(path: string): Promise<string>;
+    writeFile(path: string, data: Uint8Array | string): Promise<void>;
+    exists(path: string): Promise<boolean>;
+    lstat(path: string): Promise<FileStat>;
+    stat(path: string): Promise<FileStat>;
+    readDir(path: string): Promise<readonly DirEntry[]>;
+    mkdirp(path: string): Promise<void>;
+    remove(path: string): Promise<void>;
+    rename(from: string, to: string): Promise<void>;
+    copyFile(from: string, to: string): Promise<void>;
+    realpath(path: string): Promise<string>;
+    readlink(path: string): Promise<string>;
+    makeTempDir(parent: string, prefix: string): Promise<string>;
+    isWritable(path: string): Promise<boolean>;
+    join(...parts: readonly string[]): string;
+    resolve(...parts: readonly string[]): string;
+    dirname(path: string): string;
+    basename(path: string): string;
+    relative(from: string, to: string): string;
+    isAbsolute(path: string): boolean;
+    private normalize;
+    private parts;
+    private key;
+    private require;
+    private assertWritable;
+    private mkdirpSync;
+}
+//# sourceMappingURL=in-memory-file-system.d.ts.map

package/dist/testing/in-memory-file-system.d.ts.map

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

package/dist/testing/in-memory-file-system.js

@@ -0,0 +1,297 @@
+import { AgentSkillsError, ErrorCode } from "../domain/errors.js";
+/**
+ * A complete in-memory {@link FileSystem}.
+ *
+ * Exported from the package (rather than living in a test folder) so adapter authors outside
+ * this repository can test their own adapters against the same double the built-in ones use.
+ *
+ * It models the things that actually cause cross-platform bugs: separator handling, symlinks,
+ * and non-writable directories.
+ */
+export class InMemoryFileSystem {
+    separator;
+    nodes = new Map();
+    root;
+    readOnlyPaths;
+    tempCounter = 0;
+    clock = 1_000_000;
+    constructor(options = {}) {
+        this.separator = options.separator ?? '/';
+        this.root = options.root ?? (this.separator === '\\' ? 'C:\\' : '/');
+        this.readOnlyPaths = options.readOnlyPaths ?? [];
+        this.nodes.set(this.key(this.root), { kind: 'dir', mtimeMs: this.clock, mode: 0o755 });
+    }
+    // --- Test helpers ---------------------------------------------------------------------
+    /** Seeds files in one call: `{ '/a/b.txt': 'hello' }`. Parent directories are created. */
+    seed(files) {
+        for (const [path, content] of Object.entries(files)) {
+            const absolute = this.resolve(path);
+            this.mkdirpSync(this.dirname(absolute));
+            this.nodes.set(this.key(absolute), {
+                kind: 'file',
+                bytes: typeof content === 'string' ? new TextEncoder().encode(content) : content,
+                mtimeMs: (this.clock += 1),
+                mode: 0o644,
+            });
+        }
+        return this;
+    }
+    symlink(from, to) {
+        const absolute = this.resolve(from);
+        this.mkdirpSync(this.dirname(absolute));
+        this.nodes.set(this.key(absolute), {
+            kind: 'link',
+            target: this.resolve(to),
+            mtimeMs: (this.clock += 1),
+            mode: 0o777,
+        });
+        return this;
+    }
+    /** Every path currently present, sorted. Useful for asserting on a whole tree at once. */
+    snapshot() {
+        return [...this.nodes.keys()].sort();
+    }
+    textAt(path) {
+        const node = this.nodes.get(this.key(this.resolve(path)));
+        return node?.bytes === undefined ? undefined : new TextDecoder().decode(node.bytes);
+    }
+    // --- FileSystem -----------------------------------------------------------------------
+    async readFile(path) {
+        const node = this.require(path);
+        if (node.kind !== 'file' || node.bytes === undefined) {
+            throw new AgentSkillsError(ErrorCode.IO_ERROR, `Not a file: ${path}`);
+        }
+        return node.bytes;
+    }
+    async readTextFile(path) {
+        return new TextDecoder().decode(await this.readFile(path));
+    }
+    async writeFile(path, data) {
+        const absolute = this.resolve(path);
+        this.assertWritable(absolute);
+        this.mkdirpSync(this.dirname(absolute));
+        this.nodes.set(this.key(absolute), {
+            kind: 'file',
+            bytes: typeof data === 'string' ? new TextEncoder().encode(data) : data,
+            mtimeMs: (this.clock += 1),
+            mode: 0o644,
+        });
+    }
+    async exists(path) {
+        return this.nodes.has(this.key(this.resolve(path)));
+    }
+    async lstat(path) {
+        const node = this.require(path);
+        return {
+            isFile: node.kind === 'file',
+            isDirectory: node.kind === 'dir',
+            isSymbolicLink: node.kind === 'link',
+            size: node.bytes?.byteLength ?? 0,
+            mtimeMs: node.mtimeMs,
+            mode: node.mode,
+        };
+    }
+    async stat(path) {
+        return this.lstat(await this.realpath(path));
+    }
+    async readDir(path) {
+        const absolute = this.resolve(path);
+        const prefix = this.key(absolute) + this.separator;
+        const names = new Set();
+        for (const key of this.nodes.keys()) {
+            if (!key.startsWith(prefix))
+                continue;
+            const rest = key.slice(prefix.length);
+            const name = rest.split(this.separator)[0];
+            if (name !== undefined && name !== '')
+                names.add(name);
+        }
+        return [...names].sort().map((name) => {
+            const node = this.nodes.get(this.key(this.join(absolute, name)));
+            return {
+                name,
+                isFile: node?.kind === 'file',
+                isDirectory: node?.kind === 'dir',
+                isSymbolicLink: node?.kind === 'link',
+            };
+        });
+    }
+    async mkdirp(path) {
+        const absolute = this.resolve(path);
+        this.assertWritable(absolute);
+        this.mkdirpSync(absolute);
+    }
+    async remove(path) {
+        const absolute = this.resolve(path);
+        this.assertWritable(absolute);
+        const key = this.key(absolute);
+        const prefix = key + this.separator;
+        for (const candidate of [...this.nodes.keys()]) {
+            if (candidate === key || candidate.startsWith(prefix))
+                this.nodes.delete(candidate);
+        }
+    }
+    async rename(from, to) {
+        const source = this.resolve(from);
+        const destination = this.resolve(to);
+        this.assertWritable(destination);
+        if (!this.nodes.has(this.key(source))) {
+            throw new AgentSkillsError(ErrorCode.IO_ERROR, `No such file or directory: ${from}`);
+        }
+        if (this.nodes.has(this.key(destination))) {
+            throw new AgentSkillsError(ErrorCode.IO_ERROR, `Destination exists: ${to}`);
+        }
+        this.mkdirpSync(this.dirname(destination));
+        const sourceKey = this.key(source);
+        const prefix = sourceKey + this.separator;
+        for (const [key, node] of [...this.nodes.entries()]) {
+            if (key !== sourceKey && !key.startsWith(prefix))
+                continue;
+            const suffix = key.slice(sourceKey.length);
+            this.nodes.delete(key);
+            this.nodes.set(this.key(destination) + suffix, node);
+        }
+    }
+    async copyFile(from, to) {
+        await this.writeFile(to, await this.readFile(from));
+    }
+    async realpath(path) {
+        let current = this.resolve(path);
+        for (let hops = 0; hops < 16; hops += 1) {
+            const node = this.nodes.get(this.key(current));
+            if (node?.kind !== 'link' || node.target === undefined)
+                return current;
+            current = this.resolve(node.target);
+        }
+        throw new AgentSkillsError(ErrorCode.IO_ERROR, `Too many symbolic links: ${path}`);
+    }
+    async readlink(path) {
+        const node = this.require(path);
+        if (node.kind !== 'link' || node.target === undefined) {
+            throw new AgentSkillsError(ErrorCode.IO_ERROR, `Not a symlink: ${path}`);
+        }
+        return node.target;
+    }
+    async makeTempDir(parent, prefix) {
+        this.tempCounter += 1;
+        const path = this.join(this.resolve(parent), `${prefix}${this.tempCounter}`);
+        await this.mkdirp(path);
+        return path;
+    }
+    async isWritable(path) {
+        return !this.readOnlyPaths.some((readOnly) => this.resolve(path).startsWith(this.resolve(readOnly)));
+    }
+    join(...parts) {
+        const filtered = parts.filter((part) => part !== '');
+        if (filtered.length === 0)
+            return '.';
+        const joined = filtered.join(this.separator);
+        return this.normalize(joined);
+    }
+    resolve(...parts) {
+        let current = this.root;
+        for (const part of parts) {
+            if (part === '')
+                continue;
+            current = this.isAbsolute(part) ? part : `${current}${this.separator}${part}`;
+        }
+        return this.normalize(current);
+    }
+    dirname(path) {
+        const normalized = this.normalize(path);
+        const index = normalized.lastIndexOf(this.separator);
+        if (index <= 0)
+            return this.root;
+        const parent = normalized.slice(0, index);
+        return parent === '' || (this.separator === '\\' && /^[a-zA-Z]:$/.test(parent))
+            ? this.root
+            : parent;
+    }
+    basename(path) {
+        const normalized = this.normalize(path);
+        const index = normalized.lastIndexOf(this.separator);
+        return index === -1 ? normalized : normalized.slice(index + 1);
+    }
+    relative(from, to) {
+        const fromParts = this.parts(this.resolve(from));
+        const toParts = this.parts(this.resolve(to));
+        let shared = 0;
+        while (shared < fromParts.length &&
+            shared < toParts.length &&
+            fromParts[shared] === toParts[shared]) {
+            shared += 1;
+        }
+        return [...Array(fromParts.length - shared).fill('..'), ...toParts.slice(shared)].join(this.separator);
+    }
+    isAbsolute(path) {
+        return this.separator === '\\' ? /^[a-zA-Z]:[\\/]/.test(path) : path.startsWith('/');
+    }
+    // --- Internals ------------------------------------------------------------------------
+    normalize(path) {
+        const unified = path.replace(/[\\/]+/g, this.separator === '\\' ? '\\' : '/');
+        const absolute = this.isAbsolute(unified);
+        const prefix = absolute ? (this.separator === '\\' ? `${unified.slice(0, 2)}\\` : '/') : '';
+        const body = absolute ? unified.slice(prefix.length) : unified;
+        const segments = [];
+        for (const segment of body.split(this.separator)) {
+            if (segment === '' || segment === '.')
+                continue;
+            if (segment === '..') {
+                if (segments.length > 0)
+                    segments.pop();
+                else if (!absolute)
+                    segments.push('..');
+                continue;
+            }
+            segments.push(segment);
+        }
+        const joined = segments.join(this.separator);
+        if (absolute)
+            return joined === '' ? prefix : prefix + joined;
+        return joined === '' ? '.' : joined;
+    }
+    parts(path) {
+        return this.normalize(path)
+            .split(this.separator)
+            .filter((part) => part !== '' && !/^[a-zA-Z]:$/.test(part));
+    }
+    key(path) {
+        return this.normalize(path);
+    }
+    require(path) {
+        const node = this.nodes.get(this.key(this.resolve(path)));
+        if (node === undefined) {
+            throw new AgentSkillsError(ErrorCode.IO_ERROR, `No such file or directory: ${path}`);
+        }
+        return node;
+    }
+    assertWritable(path) {
+        for (const readOnly of this.readOnlyPaths) {
+            if (this.normalize(path).startsWith(this.normalize(this.resolve(readOnly)))) {
+                throw new AgentSkillsError(ErrorCode.PERMISSION_DENIED, `Permission denied: ${path}`);
+            }
+        }
+    }
+    mkdirpSync(path) {
+        const absolute = this.normalize(path);
+        const segments = this.parts(absolute);
+        let current = this.isAbsolute(absolute)
+            ? this.separator === '\\'
+                ? `${absolute.slice(0, 2)}\\`
+                : '/'
+            : '';
+        this.nodes.set(this.key(current === '' ? this.root : current), {
+            kind: 'dir',
+            mtimeMs: this.clock,
+            mode: 0o755,
+        });
+        for (const segment of segments) {
+            current = current === '' ? segment : this.join(current, segment);
+            const key = this.key(current);
+            if (!this.nodes.has(key)) {
+                this.nodes.set(key, { kind: 'dir', mtimeMs: (this.clock += 1), mode: 0o755 });
+            }
+        }
+    }
+}
+//# sourceMappingURL=in-memory-file-system.js.map