@senior-skills/core 1.0.0

package/dist/application/list-installed.js

@@ -0,0 +1,68 @@
+import { INSTALL_SCOPES } from "../domain/agent.js";
+import { targetsFor } from "./agent-selection.js";
+import { findProjectRoot } from "./workspace.js";
+/**
+ * Lists what is installed, per agent and scope.
+ *
+ * Unlike install, this never fails when an agent is undetected: showing an empty Codex
+ * section is more useful than an error, because the usual question is "what do I have?"
+ * rather than "what can I install into?".
+ */
+export class ListInstalled {
+    ctx;
+    constructor(ctx) {
+        this.ctx = ctx;
+    }
+    async execute(options = {}) {
+        const requested = (options.agents ?? []).filter((value) => value.trim() !== '');
+        const adapters = requested.length === 0 || requested.includes('all')
+            ? this.ctx.agents.all()
+            : requested
+                .map((value) => this.ctx.agents.find(value))
+                .filter((adapter) => adapter !== undefined);
+        const projectRoot = options.projectRoot ??
+            (await findProjectRoot(this.ctx.fs, options.startDir ?? this.ctx.env.cwd(), this.ctx.env.homeDir()));
+        const scopes = options.scope === undefined ? INSTALL_SCOPES : [options.scope];
+        const entries = [];
+        const seenRoots = new Set();
+        let total = 0;
+        for (const adapter of adapters) {
+            for (const scope of scopes) {
+                // A project scope without a project is not an error here, just nothing to show.
+                if (scope === 'project' && projectRoot === undefined)
+                    continue;
+                for (const target of targetsFor(this.ctx, adapter, scope, projectRoot)) {
+                    // An agent whose global and project roots resolve to the same directory (possible
+                    // when the config directory has been relocated into a repository) must not have its
+                    // skills counted twice. The comparison must be on the canonical path: the global
+                    // root comes from an environment variable and the project root from the cwd, and
+                    // on macOS those can name the same directory through different symlink forms
+                    // (/var/... versus /private/var/...).
+                    const rootKey = await this.canonical(target.root);
+                    if (seenRoots.has(`${adapter.id}:${rootKey}`))
+                        continue;
+                    seenRoots.add(`${adapter.id}:${rootKey}`);
+                    const all = await this.ctx.installer.list(target);
+                    const skills = options.includeUnmanaged === true ? all : all.filter((skill) => !skill.unmanaged);
+                    total += skills.length;
+                    entries.push({ target, skills });
+                }
+            }
+        }
+        return {
+            entries,
+            ...(projectRoot === undefined ? {} : { projectRoot }),
+            total,
+        };
+    }
+    /**
+     * Canonical form of a root for identity comparison. A root that does not exist yet has no
+     * canonical form to resolve — the resolved literal path is the best available identity.
+     */
+    async canonical(root) {
+        if (!(await this.ctx.fs.exists(root)))
+            return this.ctx.fs.resolve(root);
+        return this.ctx.fs.realpath(root);
+    }
+}
+//# sourceMappingURL=list-installed.js.map

package/dist/application/list-installed.js.map

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

package/dist/application/package-loader.d.ts

@@ -0,0 +1,42 @@
+import { type PackageKind } from '../domain/manifest.ts';
+import { type PackageFile, type SkillPackage } from '../domain/skill-package.ts';
+import type { FileSystem } from '../ports/infrastructure.ts';
+import type { ValidationIssue } from '../domain/validation.ts';
+export interface LoadPackageOptions {
+    /** Unknown manifest fields become errors. Used by `publish` and `validate --strict`. */
+    readonly strict?: boolean;
+    /** Hard cap on total package size, guarding against a hostile local tree. */
+    readonly maxTotalBytes?: number;
+    readonly maxFiles?: number;
+}
+export interface LoadedPackage {
+    readonly pkg: SkillPackage;
+    readonly directory: string;
+    readonly issues: readonly ValidationIssue[];
+}
+export declare const DEFAULT_MAX_TOTAL_BYTES: number;
+export declare const DEFAULT_MAX_FILES = 2000;
+/**
+ * Reads a skill package from a directory on disk.
+ *
+ * Shared by `validate`, `publish`, `create --check` and the local/git registries, so the
+ * definition of "what is in a package" exists once.
+ */
+export declare function loadPackageFromDirectory(fs: FileSystem, directory: string, options?: LoadPackageOptions): Promise<LoadedPackage>;
+/**
+ * Builds the initial package contents for `senior-skills create`.
+ * Kept here so the scaffold and the validator cannot drift apart.
+ */
+export declare function scaffoldPackage(name: string, options?: {
+    readonly kind?: PackageKind;
+    readonly description?: string;
+    readonly license?: string;
+    readonly author?: string;
+}): readonly PackageFile[];
+/** Reads name/description/version out of a `SKILL.md` on disk without loading the package. */
+export declare function peekSkillDocument(fs: FileSystem, skillMdPath: string): Promise<{
+    name?: string;
+    description?: string;
+    version?: string;
+}>;
+//# sourceMappingURL=package-loader.d.ts.map

package/dist/application/package-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-loader.d.ts","sourceRoot":"","sources":["../../src/application/package-loader.ts"],"names":[],"mappings":"AACA,OAAO,EAML,KAAK,WAAW,EAEjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAGL,KAAK,WAAW,EAChB,KAAK,YAAY,EAClB,MAAM,4BAA4B,CAAC;AASpC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE/D,MAAM,WAAW,kBAAkB;IACjC,wFAAwF;IACxF,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,6EAA6E;IAC7E,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,GAAG,EAAE,YAAY,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,CAAC;CAC7C;AAED,eAAO,MAAM,uBAAuB,QAAmB,CAAC;AACxD,eAAO,MAAM,iBAAiB,OAAO,CAAC;AAKtC;;;;;GAKG;AACH,wBAAsB,wBAAwB,CAC5C,EAAE,EAAE,UAAU,EACd,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,aAAa,CAAC,CAgCxB;AAkGD;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;IACP,QAAQ,CAAC,IAAI,CAAC,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CACrB,GACL,SAAS,WAAW,EAAE,CAsFxB;AAwID,8FAA8F;AAC9F,wBAAsB,iBAAiB,CACrC,EAAE,EAAE,UAAU,EACd,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAQpE"}

package/dist/application/package-loader.js

@@ -0,0 +1,320 @@
+import { AgentSkillsError, ErrorCode } from "../domain/errors.js";
+import { DEFAULT_PACKAGE_KIND, MANIFEST_FILENAME, SKILL_ENTRYPOINT, entrypointFor, parseManifest, } from "../domain/manifest.js";
+import { buildSkillPackage, encodeText, } from "../domain/skill-package.js";
+import { normalize, toPosix } from "../domain/posix-path.js";
+import { documentDescription, documentName, parseSkillDocument, stringifySkillDocument, } from "../domain/skill-document.js";
+import { parseVersion } from "../domain/version.js";
+export const DEFAULT_MAX_TOTAL_BYTES = 32 * 1024 * 1024;
+export const DEFAULT_MAX_FILES = 2000;
+/** Directories never shipped in a package, regardless of what `files` says. */
+const ALWAYS_EXCLUDED = new Set(['.git', 'node_modules', '.senior-skills', '.DS_Store']);
+/**
+ * Reads a skill package from a directory on disk.
+ *
+ * Shared by `validate`, `publish`, `create --check` and the local/git registries, so the
+ * definition of "what is in a package" exists once.
+ */
+export async function loadPackageFromDirectory(fs, directory, options = {}) {
+    const root = fs.resolve(directory);
+    if (!(await fs.exists(root))) {
+        throw new AgentSkillsError(ErrorCode.INVALID_PACKAGE, `No such directory: ${directory}`, {
+            hints: ['Pass the path to a skill package directory (the one containing SKILL.md)'],
+            data: { directory },
+        });
+    }
+    const manifestPath = fs.join(root, MANIFEST_FILENAME);
+    if (!(await fs.exists(manifestPath))) {
+        throw new AgentSkillsError(ErrorCode.INVALID_PACKAGE, `${directory} is not a skill package: no ${MANIFEST_FILENAME}`, {
+            hints: [
+                `A package has ${MANIFEST_FILENAME} and its entrypoint (${SKILL_ENTRYPOINT} or ${entrypointFor('command')}) at its root`,
+                'senior-skills create <name>   to scaffold one',
+            ],
+            data: { directory },
+        });
+    }
+    const parsed = parseManifest(await fs.readTextFile(manifestPath), {
+        source: manifestPath,
+        ...(options.strict === undefined ? {} : { strict: options.strict }),
+    });
+    const files = await collectFiles(fs, root, parsed.manifest, options);
+    return { pkg: buildSkillPackage(parsed.manifest, files), directory: root, issues: parsed.issues };
+}
+async function collectFiles(fs, root, manifest, options) {
+    const maxFiles = options.maxFiles ?? DEFAULT_MAX_FILES;
+    const maxBytes = options.maxTotalBytes ?? DEFAULT_MAX_TOTAL_BYTES;
+    const collected = new Map();
+    let totalBytes = 0;
+    const addFile = async (absolute, relative) => {
+        if (collected.has(relative))
+            return;
+        const stat = await fs.lstat(absolute);
+        if (stat.isSymbolicLink) {
+            // Rejected rather than followed: a symlink in a package is either an escape attempt or
+            // a portability bug, and neither should silently become a real file at install time.
+            throw new AgentSkillsError(ErrorCode.UNSAFE_PATH, `Symbolic links are not allowed in skill packages: ${relative}`, {
+                details: [`-> ${await fs.readlink(absolute).catch(() => '(unreadable)')}`],
+                hints: ['Replace the link with a real file'],
+                data: { path: relative },
+            });
+        }
+        if (!stat.isFile)
+            return;
+        totalBytes += stat.size;
+        if (collected.size >= maxFiles) {
+            throw new AgentSkillsError(ErrorCode.INVALID_PACKAGE, `Package has more than ${maxFiles} files`, { hints: ['Trim the "files" list in skill.yaml'], data: { maxFiles } });
+        }
+        if (totalBytes > maxBytes) {
+            throw new AgentSkillsError(ErrorCode.INVALID_PACKAGE, `Package exceeds the ${Math.round(maxBytes / 1024 / 1024)} MB limit`, { hints: ['Move large assets out of the package'], data: { maxBytes } });
+        }
+        collected.set(relative, {
+            path: relative,
+            bytes: await fs.readFile(absolute),
+            sourcePath: absolute,
+        });
+    };
+    const addTree = async (absolute, relative) => {
+        const stat = await fs.lstat(absolute);
+        if (stat.isSymbolicLink) {
+            throw new AgentSkillsError(ErrorCode.UNSAFE_PATH, `Symbolic links are not allowed in skill packages: ${relative}`, { data: { path: relative } });
+        }
+        if (stat.isFile) {
+            await addFile(absolute, relative);
+            return;
+        }
+        if (!stat.isDirectory)
+            return;
+        for (const entry of await fs.readDir(absolute)) {
+            if (ALWAYS_EXCLUDED.has(entry.name))
+                continue;
+            await addTree(fs.join(absolute, entry.name), normalize(`${relative}/${entry.name}`));
+        }
+    };
+    for (const declared of manifest.files) {
+        const relative = normalize(declared.replace(/\/+$/, ''));
+        if (relative === '.' || relative === '')
+            continue;
+        const absolute = fs.join(root, ...relative.split('/'));
+        if (!(await fs.exists(absolute))) {
+            // Missing declared paths are a validation finding, not a load failure, so `validate`
+            // can list every problem at once.
+            continue;
+        }
+        await addTree(absolute, relative);
+    }
+    // The manifest always ships, even if the author forgot to list it.
+    const manifestRelative = MANIFEST_FILENAME;
+    if (!collected.has(manifestRelative)) {
+        await addFile(fs.join(root, manifestRelative), manifestRelative);
+    }
+    return [...collected.values()];
+}
+/**
+ * Builds the initial package contents for `senior-skills create`.
+ * Kept here so the scaffold and the validator cannot drift apart.
+ */
+export function scaffoldPackage(name, options = {}) {
+    const kind = options.kind ?? DEFAULT_PACKAGE_KIND;
+    const license = options.license ?? 'Apache-2.0';
+    const title = name
+        .split('-')
+        .map((part) => (part.length === 0 ? part : part[0].toUpperCase() + part.slice(1)))
+        .join(' ');
+    if (kind === 'command') {
+        return scaffoldCommand(name, title, license, options);
+    }
+    if (kind === 'workflow') {
+        return scaffoldWorkflow(name, title, license, options);
+    }
+    const description = options.description ??
+        `What ${name} covers, and when an agent should use it. Replace this with a description that names the situations this skill applies to.`;
+    const manifest = [
+        'schemaVersion: 1',
+        '',
+        `name: ${name}`,
+        'version: 0.1.0',
+        `description: ${JSON.stringify(description)}`,
+        `license: ${license}`,
+        ...(options.author === undefined ? [] : ['', 'authors:', `  - name: ${options.author}`]),
+        '',
+        'keywords: []',
+        '',
+        '# Omit `compatibility` to declare the skill works with every agent.',
+        '# compatibility:',
+        '#   agents:',
+        '#     - id: claude-code',
+        '#     - id: codex',
+        '',
+        'files:',
+        '  - SKILL.md',
+        '  - skill.yaml',
+        '  - references/',
+        '',
+        'dependencies: []',
+        '',
+    ].join('\n');
+    const skillDoc = stringifySkillDocument({
+        frontmatter: { name, description },
+        body: [
+            `# ${title}`,
+            '',
+            '## Purpose',
+            '',
+            'One paragraph on what this skill makes the agent better at, and what it deliberately',
+            'does not cover.',
+            '',
+            '## Workflow',
+            '',
+            '1. First step the agent should take.',
+            '2. Second step.',
+            '3. How to know the work is done.',
+            '',
+            '## Rules',
+            '',
+            '- A concrete rule that changes what the agent does.',
+            '- Another rule. Prefer specifics over generic advice.',
+            '',
+            '## References',
+            '',
+            '- [Detailed notes](references/notes.md) — read when the task needs the full detail.',
+            '',
+        ].join('\n'),
+    });
+    const notes = [
+        `# ${title} — reference notes`,
+        '',
+        'Put material here that is only needed for some tasks. `SKILL.md` stays short; this file',
+        'is read on demand.',
+        '',
+    ].join('\n');
+    return [
+        { path: SKILL_ENTRYPOINT, bytes: encodeText(skillDoc) },
+        { path: MANIFEST_FILENAME, bytes: encodeText(manifest) },
+        { path: 'references/notes.md', bytes: encodeText(notes) },
+    ];
+}
+/**
+ * A command is one file, so its scaffold is one file plus the manifest: no `references/`,
+ * because nothing but the entrypoint would be installed.
+ */
+function scaffoldCommand(name, title, license, options) {
+    const entrypoint = entrypointFor('command');
+    const description = options.description ??
+        `What /${name} does. One line: this is what the user sees in the command list.`;
+    const manifest = [
+        'schemaVersion: 1',
+        '',
+        `name: ${name}`,
+        'kind: command',
+        'version: 0.1.0',
+        `description: ${JSON.stringify(description)}`,
+        `license: ${license}`,
+        ...(options.author === undefined ? [] : ['', 'authors:', `  - name: ${options.author}`]),
+        '',
+        'keywords: []',
+        '',
+        '# Codex has no user-invoked commands; declaring compatibility keeps installs honest.',
+        'compatibility:',
+        '  agents:',
+        '    - id: claude-code',
+        '',
+        'files:',
+        `  - ${entrypoint}`,
+        '  - skill.yaml',
+        '',
+        'dependencies: []',
+        '',
+    ].join('\n');
+    const commandDoc = stringifySkillDocument({
+        frontmatter: { name, description, 'argument-hint': '[what the command takes]' },
+        body: [
+            `# ${title}`,
+            '',
+            'The body is the prompt the agent runs when the user types the command.',
+            'Write it as instructions to the agent, not as documentation for a reader.',
+            '',
+            '## Task',
+            '',
+            'What to do with $ARGUMENTS.',
+            '',
+            '## Steps',
+            '',
+            '1. First step.',
+            '2. Second step.',
+            '3. How to know the work is done.',
+            '',
+        ].join('\n'),
+    });
+    return [
+        { path: entrypoint, bytes: encodeText(commandDoc) },
+        { path: MANIFEST_FILENAME, bytes: encodeText(manifest) },
+    ];
+}
+/**
+ * A workflow is a script Claude Code compiles, so the scaffold is a runnable skeleton
+ * rather than prose: `meta` first (it must be the first statement), then phases that match
+ * the titles declared in it.
+ */
+function scaffoldWorkflow(name, title, license, options) {
+    const entrypoint = entrypointFor('workflow');
+    const description = options.description ?? `What ${name} orchestrates, in one line. Shown by search and info.`;
+    const manifest = [
+        'schemaVersion: 1',
+        '',
+        `name: ${name}`,
+        'kind: workflow',
+        'version: 0.1.0',
+        `description: ${JSON.stringify(description)}`,
+        `license: ${license}`,
+        ...(options.author === undefined ? [] : ['', 'authors:', `  - name: ${options.author}`]),
+        '',
+        'keywords: []',
+        '',
+        '# Only Claude Code runs workflows; declaring it keeps installs honest.',
+        'compatibility:',
+        '  agents:',
+        '    - id: claude-code',
+        '',
+        'files:',
+        `  - ${entrypoint}`,
+        '  - skill.yaml',
+        '',
+        'dependencies: []',
+        '',
+    ].join('\n');
+    const script = [
+        'export const meta = {',
+        `  name: ${JSON.stringify(name)},`,
+        `  description: ${JSON.stringify(description)},`,
+        '  phases: [',
+        `    { title: "Investigate", detail: ${JSON.stringify(`What ${title} gathers first.`)} },`,
+        '    { title: "Report" },',
+        '  ],',
+        '};',
+        '',
+        '// Phase titles are matched against meta.phases exactly.',
+        'phase("Investigate");',
+        'await agent({',
+        `  description: ${JSON.stringify(`${title}: investigate`)},`,
+        '  prompt: "What the sub-agent should do. $ARGUMENTS is available here.",',
+        '});',
+        '',
+        'phase("Report");',
+        'log("What the run produced.");',
+        '',
+    ].join('\n');
+    return [
+        { path: entrypoint, bytes: encodeText(script) },
+        { path: MANIFEST_FILENAME, bytes: encodeText(manifest) },
+    ];
+}
+/** Reads name/description/version out of a `SKILL.md` on disk without loading the package. */
+export async function peekSkillDocument(fs, skillMdPath) {
+    const doc = parseSkillDocument(await fs.readTextFile(skillMdPath), toPosix(skillMdPath));
+    const rawVersion = doc.frontmatter['version'];
+    return {
+        ...(documentName(doc) === undefined ? {} : { name: documentName(doc) }),
+        ...(documentDescription(doc) === undefined ? {} : { description: documentDescription(doc) }),
+        ...(typeof rawVersion === 'string' ? { version: parseVersion(rawVersion, skillMdPath) } : {}),
+    };
+}
+//# sourceMappingURL=package-loader.js.map

package/dist/application/package-loader.js.map

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

package/dist/application/publish-skill.d.ts

@@ -0,0 +1,41 @@
+import type { IndexSkillEntry, IndexVersionEntry } from '../domain/registry-index.ts';
+import type { Hasher } from '../ports/infrastructure.ts';
+import type { ApplicationContext } from './context.ts';
+export interface PublishOptions {
+    /** Package directory. Defaults to the process cwd. */
+    readonly directory?: string;
+    /** Registry the version is destined for; used for the "already published" check. */
+    readonly registry?: string;
+    readonly dryRun?: boolean;
+}
+export interface PublishReport {
+    readonly name: string;
+    readonly version: string;
+    readonly directory: string;
+    readonly integrity: string;
+    readonly registry?: string;
+    /** The entry a maintainer adds to the registry index. */
+    readonly indexEntry: IndexVersionEntry;
+    /** Full skill entry, for a registry that does not yet list this name. */
+    readonly skillEntry: IndexSkillEntry;
+    readonly files: readonly string[];
+    readonly warnings: readonly string[];
+}
+/**
+ * `publish` is prepare-and-emit, not upload.
+ *
+ * The v1 registry is a git repository, whose write path is a pull request — a better review
+ * surface for "here is a new skill that will run inside your agent" than an API token. The
+ * command therefore does every check a server would do, then hands back the exact index
+ * entry to commit. `PublishTarget` exists so an HTTP registry can later take the same
+ * validated result and POST it.
+ */
+export declare class PublishSkill {
+    private readonly ctx;
+    private readonly hasher;
+    constructor(ctx: ApplicationContext, hasher: Hasher);
+    execute(options?: PublishOptions): Promise<PublishReport>;
+    private assertVersionIsNew;
+    private assertDependenciesResolve;
+}
+//# sourceMappingURL=publish-skill.d.ts.map

package/dist/application/publish-skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"publish-skill.d.ts","sourceRoot":"","sources":["../../src/application/publish-skill.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAEtF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAIvD,MAAM,WAAW,cAAc;IAC7B,sDAAsD;IACtD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,oFAAoF;IACpF,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,yDAAyD;IACzD,QAAQ,CAAC,UAAU,EAAE,iBAAiB,CAAC;IACvC,yEAAyE;IACzE,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC;IACrC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAED;;;;;;;;GAQG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAqB;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,GAAG,EAAE,kBAAkB,EAAE,MAAM,EAAE,MAAM;IAK7C,OAAO,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,aAAa,CAAC;YAwDrD,kBAAkB;YA4ClB,yBAAyB;CAsBxC"}

package/dist/application/publish-skill.js

@@ -0,0 +1,112 @@
+import { AgentSkillsError, ErrorCode } from "../domain/errors.js";
+import { computePackageIntegrity } from "../domain/integrity.js";
+import { compareVersions } from "../domain/version.js";
+import { formatIssue } from "./install-skills.js";
+import { validateDirectory } from "./validate-package.js";
+/**
+ * `publish` is prepare-and-emit, not upload.
+ *
+ * The v1 registry is a git repository, whose write path is a pull request — a better review
+ * surface for "here is a new skill that will run inside your agent" than an API token. The
+ * command therefore does every check a server would do, then hands back the exact index
+ * entry to commit. `PublishTarget` exists so an HTTP registry can later take the same
+ * validated result and POST it.
+ */
+export class PublishSkill {
+    ctx;
+    hasher;
+    constructor(ctx, hasher) {
+        this.ctx = ctx;
+        this.hasher = hasher;
+    }
+    async execute(options = {}) {
+        const directory = options.directory ?? this.ctx.env.cwd();
+        // Strict: unknown manifest fields are errors when publishing, because a typo that only
+        // warns locally becomes a permanent part of a public registry.
+        const validated = await validateDirectory(this.ctx, directory, { strict: true });
+        if (!validated.ok) {
+            throw new AgentSkillsError(ErrorCode.PUBLISH_REJECTED, 'Package failed validation', {
+                details: validated.errors.map(formatIssue),
+                hints: [`senior-skills validate ${directory} --strict   to iterate on the problems`],
+                data: { directory, issues: validated.errors },
+            });
+        }
+        const { manifest } = validated.pkg;
+        const warnings = validated.warnings.map(formatIssue);
+        await this.assertVersionIsNew(manifest.name, manifest.version, options.registry, warnings);
+        await this.assertDependenciesResolve(manifest, warnings);
+        const integrity = computePackageIntegrity(validated.pkg, this.hasher);
+        if (manifest.integrity !== undefined && manifest.integrity !== integrity) {
+            warnings.push(`skill.yaml declares integrity ${manifest.integrity}, but the contents hash to ${integrity}; the computed value is authoritative`);
+        }
+        const indexEntry = {
+            version: manifest.version,
+            path: `skills/${manifest.name}`,
+            integrity,
+            publishedAt: this.ctx.clock.now().toISOString(),
+            deprecated: false,
+        };
+        return {
+            name: manifest.name,
+            version: manifest.version,
+            directory: validated.directory,
+            integrity,
+            ...(options.registry === undefined ? {} : { registry: options.registry }),
+            indexEntry,
+            skillEntry: {
+                name: manifest.name,
+                description: manifest.description,
+                keywords: manifest.keywords,
+                latest: manifest.version,
+                versions: [indexEntry],
+            },
+            files: validated.pkg.files.map((file) => file.path),
+            warnings,
+        };
+    }
+    async assertVersionIsNew(name, version, registryName, warnings) {
+        const registry = registryName === undefined
+            ? this.ctx.registry.members()[0]
+            : this.ctx.registry.named(registryName);
+        if (registry === undefined)
+            return;
+        let published;
+        try {
+            published = await registry.versions(name);
+        }
+        catch {
+            // A registry that cannot be reached must not block preparing a release; the
+            // maintainer's pull request is the real gate.
+            warnings.push(`Could not reach registry "${registry.name}" to check for version collisions`);
+            return;
+        }
+        if (published.length === 0)
+            return;
+        if (published.some((entry) => entry.version === version)) {
+            throw new AgentSkillsError(ErrorCode.PUBLISH_REJECTED, `${name}@${version} is already published in "${registry.name}"`, {
+                hints: ['Bump the version in skill.yaml (and in SKILL.md if it declares one)'],
+                data: { name, version, registry: registry.name },
+            });
+        }
+        const newest = published[0].version;
+        if (compareVersions(version, newest) < 0) {
+            warnings.push(`${version} is older than the currently published ${newest}; publishing it will not change "latest"`);
+        }
+    }
+    async assertDependenciesResolve(manifest, warnings) {
+        for (const dependency of manifest.dependencies) {
+            const owner = await this.ctx.registry.ownerOf(dependency.name).catch(() => undefined);
+            if (owner === undefined) {
+                throw new AgentSkillsError(ErrorCode.PUBLISH_REJECTED, `Dependency "${dependency.name}" is not published in any configured registry`, {
+                    hints: [
+                        'Publish the dependency first, or make it an optionalDependency',
+                        'senior-skills registry list   to check where the CLI is looking',
+                    ],
+                    data: { dependency: dependency.name },
+                });
+            }
+            warnings.push(`dependency ${dependency.name}@${dependency.version} resolves via "${owner}"`);
+        }
+    }
+}
+//# sourceMappingURL=publish-skill.js.map

package/dist/application/publish-skill.js.map

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