@detergent-software/atk 0.12.1-dev.2

package/build/lib/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/lib/paths.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAEhF;AAQD;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAgCzD;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C"}

package/build/lib/paths.js

@@ -0,0 +1,68 @@
+import { existsSync } from 'node:fs';
+import { dirname, join, relative, resolve } from 'node:path';
+/**
+ * Replace all backslashes with forward slashes in a path string.
+ * Used to normalize Windows-style paths for consistent lockfile storage.
+ */
+export function normalizeLockfilePath(p) {
+    return p.replace(/\\/g, '/');
+}
+/**
+ * Convert an absolute path to a project-relative path with forward slashes.
+ * Used to store portable paths in the lockfile.
+ */
+export function toRelativePosix(projectDir, absolutePath) {
+    return normalizeLockfilePath(relative(projectDir, absolutePath));
+}
+/** Per-process cache keyed by starting directory to avoid repeated filesystem walks. */
+const projectRootCache = new Map();
+/** Project root markers in discovery priority order. */
+const ROOT_MARKERS = ['.atk-lock.json', '.claude', '.git'];
+/**
+ * Walk up from `startDir` looking for project root markers.
+ *
+ * Discovery priority:
+ *   1. `.atk-lock.json` file
+ *   2. `.claude/` directory
+ *   3. `.git/` directory
+ *   4. Fallback to the resolved `startDir`
+ *
+ * Results are cached per starting directory for the lifetime of the process.
+ */
+export function findProjectRoot(startDir) {
+    const start = resolve(startDir ?? process.cwd());
+    const cached = projectRootCache.get(start);
+    if (cached !== undefined) {
+        return cached;
+    }
+    let current = start;
+    while (true) {
+        for (const marker of ROOT_MARKERS) {
+            try {
+                if (existsSync(join(current, marker))) {
+                    projectRootCache.set(start, current);
+                    return current;
+                }
+            }
+            catch {
+                // Permission error or other filesystem issue — skip this marker and continue.
+            }
+        }
+        const parent = dirname(current);
+        if (parent === current) {
+            // Reached the filesystem root without finding a marker — fall back to startDir.
+            break;
+        }
+        current = parent;
+    }
+    projectRootCache.set(start, start);
+    return start;
+}
+/**
+ * Clear the project-root cache. Intended for use in tests so each test
+ * can control the filesystem layout without stale cached values.
+ */
+export function resetProjectRootCache() {
+    projectRootCache.clear();
+}
+//# sourceMappingURL=paths.js.map

package/build/lib/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/lib/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE7D;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,CAAS;IAC7C,OAAO,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AAC/B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,UAAkB,EAAE,YAAoB;IACtE,OAAO,qBAAqB,CAAC,QAAQ,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC,CAAC;AACnE,CAAC;AAED,wFAAwF;AACxF,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAkB,CAAC;AAEnD,wDAAwD;AACxD,MAAM,YAAY,GAAG,CAAC,gBAAgB,EAAE,SAAS,EAAE,MAAM,CAAU,CAAC;AAEpE;;;;;;;;;;GAUG;AACH,MAAM,UAAU,eAAe,CAAC,QAAiB;IAC/C,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAEjD,MAAM,MAAM,GAAG,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAC3C,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB,OAAO,IAAI,EAAE,CAAC;QACZ,KAAK,MAAM,MAAM,IAAI,YAAY,EAAE,CAAC;YAClC,IAAI,CAAC;gBACH,IAAI,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC;oBACtC,gBAAgB,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;oBACrC,OAAO,OAAO,CAAC;gBACjB,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,8EAA8E;YAChF,CAAC;QACH,CAAC;QAED,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;QAChC,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;YACvB,gFAAgF;YAChF,MAAM;QACR,CAAC;QACD,OAAO,GAAG,MAAM,CAAC;IACnB,CAAC;IAED,gBAAgB,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IACnC,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB;IACnC,gBAAgB,CAAC,KAAK,EAAE,CAAC;AAC3B,CAAC"}

package/build/lib/publisher.d.ts

@@ -0,0 +1,49 @@
+import type { Bundle } from './schemas/bundle.js';
+import type { AssetType, Manifest } from './schemas/manifest.js';
+import type { Registry } from './schemas/registry.js';
+export interface PublishPlan {
+    branchName: string;
+    checksum: string;
+    files: string[];
+    isUpdate: boolean;
+    prBody: string;
+    prTitle: string;
+    registryPath: string;
+    resolvedVersion: string;
+    target: PublishTarget;
+}
+export interface PublishResult {
+    branchName: string;
+    prUrl: string;
+}
+export interface PublishTarget {
+    assetType?: AssetType;
+    data: Bundle | Manifest;
+    sourceDir: string;
+    type: PublishType;
+}
+export type PublishType = 'asset' | 'bundle';
+export interface ValidationResult {
+    errors: string[];
+    valid: boolean;
+    warnings: string[];
+}
+export type VersionCheckResult = {
+    latestVersion: string;
+    status: 'needs-bump';
+} | {
+    latestVersion: string;
+    status: 'version-already-bumped';
+} | {
+    status: 'new-asset';
+};
+export declare function buildPublishPlan(target: PublishTarget, resolvedVersion: string, isUpdate: boolean, message?: string): Promise<PublishPlan>;
+export declare function bumpVersion(currentVersion: string, bumpType: 'major' | 'minor' | 'patch'): string;
+export declare function checkRegistryVersion(target: PublishTarget, registry: Registry): VersionCheckResult;
+export declare function detectPublishType(directoryPath: string): Promise<PublishTarget>;
+export declare function executePublish(plan: PublishPlan, token: string, progressCallback: (msg: string) => void): Promise<PublishResult>;
+export declare function generatePrBody(target: PublishTarget, name: string, version: string, isUpdate: boolean, files: string[], message?: string): string;
+export declare function mapPublishError(error: unknown): string;
+export declare function updateManifestVersion(sourceDir: string, manifestFile: string, newVersion: string): Promise<void>;
+export declare function validatePublishTarget(target: PublishTarget): Promise<ValidationResult>;
+//# sourceMappingURL=publisher.d.ts.map

package/build/lib/publisher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"publisher.d.ts","sourceRoot":"","sources":["../../src/lib/publisher.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAgBtD,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,aAAa,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,WAAW,CAAC;CACnB;AAED,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE7C,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,MAAM,kBAAkB,GAC1B;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,YAAY,CAAA;CAAE,GAC/C;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,wBAAwB,CAAA;CAAE,GAC3D;IAAE,MAAM,EAAE,WAAW,CAAA;CAAE,CAAC;AAM5B,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,aAAa,EACrB,eAAe,EAAE,MAAM,EACvB,QAAQ,EAAE,OAAO,EACjB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,WAAW,CAAC,CA+BtB;AAMD,wBAAgB,WAAW,CAAC,cAAc,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,CAMjG;AAMD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,QAAQ,GAAG,kBAAkB,CA2BlG;AAMD,wBAAsB,iBAAiB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CA4BrF;AAED,wBAAsB,cAAc,CAClC,IAAI,EAAE,WAAW,EACjB,KAAK,EAAE,MAAM,EACb,gBAAgB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GACtC,OAAO,CAAC,aAAa,CAAC,CA4DxB;AAMD,wBAAgB,cAAc,CAC5B,MAAM,EAAE,aAAa,EACrB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,OAAO,EACjB,KAAK,EAAE,MAAM,EAAE,EACf,OAAO,CAAC,EAAE,MAAM,GACf,MAAM,CAqFR;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CA0BtD;AAMD,wBAAsB,qBAAqB,CACzC,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAMf;AAED,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA+E5F"}

package/build/lib/publisher.js

@@ -0,0 +1,388 @@
+import { execFile } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { cp, mkdir, readFile, rm, writeFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { basename, join } from 'node:path';
+import { promisify } from 'node:util';
+import { compare as semverCompare, inc as semverInc, valid as semverValid } from 'semver';
+import { hashDirectory } from './checksum.js';
+import { DEFAULT_REGISTRY_BRANCH_DEV, DEFAULT_REGISTRY_REPO } from './github.js';
+import { validateAssetName } from './init.js';
+import { parseAndValidate } from './parse-json.js';
+import { findAsset, findBundle } from './registry.js';
+import { BundleSchema } from './schemas/bundle.js';
+import { ManifestSchema } from './schemas/manifest.js';
+const execFileAsync = promisify(execFile);
+// ---------------------------------------------------------------------------
+// Detection
+// ---------------------------------------------------------------------------
+export async function buildPublishPlan(target, resolvedVersion, isUpdate, message) {
+    const checksum = await hashDirectory(target.sourceDir);
+    const name = target.data.name;
+    let branchName;
+    let registryPath;
+    if (target.type === 'asset') {
+        const assetType = target.data.type;
+        branchName = `asset/${assetType}/${name}/${resolvedVersion}`;
+        registryPath = `assets/${assetType}s/${name}/${resolvedVersion}/`;
+    }
+    else {
+        branchName = `bundle/${name}/${resolvedVersion}`;
+        registryPath = `bundles/${name}/${resolvedVersion}/`;
+    }
+    const files = collectFilesToPublish(target);
+    const prTitle = generatePrTitle(target, name, resolvedVersion, isUpdate);
+    const prBody = generatePrBody(target, name, resolvedVersion, isUpdate, files, message);
+    return {
+        branchName,
+        checksum,
+        files,
+        isUpdate,
+        prBody,
+        prTitle,
+        registryPath,
+        resolvedVersion,
+        target,
+    };
+}
+// ---------------------------------------------------------------------------
+// Validation
+// ---------------------------------------------------------------------------
+export function bumpVersion(currentVersion, bumpType) {
+    const result = semverInc(currentVersion, bumpType);
+    if (!result) {
+        throw new Error(`Failed to bump version '${currentVersion}' with type '${bumpType}'`);
+    }
+    return result;
+}
+// ---------------------------------------------------------------------------
+// Version checking
+// ---------------------------------------------------------------------------
+export function checkRegistryVersion(target, registry) {
+    const name = target.data.name;
+    const manifestVersion = target.data.version;
+    if (target.type === 'bundle') {
+        const existing = findBundle(registry, name);
+        if (!existing) {
+            return { status: 'new-asset' };
+        }
+        const cmp = semverCompare(manifestVersion, existing.version);
+        if (cmp > 0) {
+            return { latestVersion: existing.version, status: 'version-already-bumped' };
+        }
+        return { latestVersion: existing.version, status: 'needs-bump' };
+    }
+    const resolved = findAsset(registry, name, target.assetType);
+    if (!resolved) {
+        return { status: 'new-asset' };
+    }
+    const cmp = semverCompare(manifestVersion, resolved.asset.latest);
+    if (cmp > 0) {
+        return { latestVersion: resolved.asset.latest, status: 'version-already-bumped' };
+    }
+    return { latestVersion: resolved.asset.latest, status: 'needs-bump' };
+}
+// ---------------------------------------------------------------------------
+// Version bumping
+// ---------------------------------------------------------------------------
+export async function detectPublishType(directoryPath) {
+    const manifestPath = join(directoryPath, 'manifest.json');
+    const bundlePath = join(directoryPath, 'bundle.json');
+    if (existsSync(manifestPath)) {
+        const raw = await readFile(manifestPath, 'utf-8');
+        const data = parseAndValidate(raw, ManifestSchema, 'Invalid manifest.json');
+        return {
+            assetType: data.type,
+            data,
+            sourceDir: directoryPath,
+            type: 'asset',
+        };
+    }
+    if (existsSync(bundlePath)) {
+        const raw = await readFile(bundlePath, 'utf-8');
+        const data = parseAndValidate(raw, BundleSchema, 'Invalid bundle.json');
+        return {
+            data,
+            sourceDir: directoryPath,
+            type: 'bundle',
+        };
+    }
+    throw new Error(`No manifest.json or bundle.json found in ${directoryPath}. Run 'atk init' to scaffold a new asset.`);
+}
+export async function executePublish(plan, token, progressCallback) {
+    const tempDir = join(tmpdir(), `atk-publish-${crypto.randomUUID()}`);
+    try {
+        progressCallback('Cloning registry repository...');
+        await execFileAsync('git', [
+            'clone',
+            '--depth',
+            '1',
+            '--branch',
+            DEFAULT_REGISTRY_BRANCH_DEV,
+            `https://x-access-token:${token}@github.com/${DEFAULT_REGISTRY_REPO}.git`,
+            tempDir,
+        ]);
+        progressCallback('Creating branch...');
+        await execFileAsync('git', ['-C', tempDir, 'checkout', '-b', plan.branchName]);
+        progressCallback('Copying files...');
+        const targetDir = join(tempDir, plan.registryPath);
+        await mkdir(targetDir, { recursive: true });
+        for (const file of plan.files) {
+            const sourcePath = join(plan.target.sourceDir, file);
+            const destPath = join(targetDir, basename(file));
+            await cp(sourcePath, destPath);
+        }
+        progressCallback('Committing changes...');
+        await execFileAsync('git', ['-C', tempDir, 'add', '.']);
+        await execFileAsync('git', ['-C', tempDir, 'commit', '-m', plan.prTitle]);
+        progressCallback('Pushing changes...');
+        await execFileAsync('git', ['-C', tempDir, 'push', 'origin', plan.branchName]);
+        progressCallback('Creating pull request...');
+        const { stdout } = await execFileAsync('gh', [
+            'pr',
+            'create',
+            '--repo',
+            DEFAULT_REGISTRY_REPO,
+            '--base',
+            DEFAULT_REGISTRY_BRANCH_DEV,
+            '--head',
+            plan.branchName,
+            '--title',
+            plan.prTitle,
+            '--body',
+            plan.prBody,
+        ]);
+        const prUrl = stdout.trim();
+        return {
+            branchName: plan.branchName,
+            prUrl,
+        };
+    }
+    finally {
+        await rm(tempDir, { force: true, recursive: true }).catch(() => { });
+    }
+}
+// ---------------------------------------------------------------------------
+// Publish plan
+// ---------------------------------------------------------------------------
+export function generatePrBody(target, name, version, isUpdate, files, message) {
+    const heading = isUpdate ? `## Updated Asset: ${name}` : `## New Asset: ${name}`;
+    const lines = [heading, ''];
+    if (target.type === 'asset') {
+        const manifest = target.data;
+        lines.push(`**Type:** ${manifest.type}`);
+        lines.push(`**Version:** ${version}`);
+        lines.push(`**Author:** ${manifest.author}`);
+        lines.push(`**Trust Level:** ${manifest.trustLevel ?? 'experimental'}`);
+        lines.push('');
+        lines.push('### Description');
+        lines.push('');
+        lines.push(manifest.description);
+        lines.push('');
+        lines.push('### Tool Compatibility');
+        lines.push('');
+        if (manifest.tools && manifest.tools.length > 0) {
+            for (const tool of manifest.tools) {
+                lines.push(`- ${tool.tool}`);
+            }
+        }
+        else {
+            lines.push('none');
+        }
+        lines.push('');
+        lines.push('### Tags');
+        lines.push('');
+        lines.push(manifest.tags && manifest.tags.length > 0 ? manifest.tags.join(', ') : 'none');
+        lines.push('');
+        lines.push('### Dependencies');
+        lines.push('');
+        if (manifest.dependencies && manifest.dependencies.length > 0) {
+            for (const dep of manifest.dependencies) {
+                lines.push(`- ${dep.type}:${dep.name}${dep.version ? `@${dep.version}` : ''}`);
+            }
+        }
+        else {
+            lines.push('none');
+        }
+    }
+    else {
+        const bundle = target.data;
+        lines.push(`**Version:** ${version}`);
+        lines.push(`**Author:** ${bundle.author}`);
+        lines.push('');
+        lines.push('### Description');
+        lines.push('');
+        lines.push(bundle.description);
+        lines.push('');
+        lines.push('### Tags');
+        lines.push('');
+        lines.push(bundle.tags && bundle.tags.length > 0 ? bundle.tags.join(', ') : 'none');
+        lines.push('');
+        lines.push('### Included Assets');
+        lines.push('');
+        for (const asset of bundle.assets) {
+            lines.push(`- ${asset.type}:${asset.name}${asset.version ? `@${asset.version}` : ''}`);
+        }
+    }
+    lines.push('');
+    lines.push('### Files');
+    lines.push('');
+    for (const file of files) {
+        lines.push(`- ${file}`);
+    }
+    lines.push('');
+    lines.push('### Checklist');
+    lines.push('');
+    lines.push('- [ ] Manifest schema is valid');
+    lines.push('- [ ] All referenced files are present');
+    lines.push('- [ ] Asset has been tested locally');
+    lines.push('- [ ] README.md is included');
+    if (message) {
+        lines.push('');
+        lines.push('### Notes from Author');
+        lines.push('');
+        lines.push(message);
+    }
+    lines.push('');
+    lines.push('---');
+    lines.push('*Published via `atk publish`*');
+    return lines.join('\n');
+}
+export function mapPublishError(error) {
+    const msg = error instanceof Error ? error.message : String(error);
+    if (msg.includes('already exists')) {
+        return `Branch already exists. A PR may already be open for this version.`;
+    }
+    if (msg.includes('Authentication') || msg.includes('auth') || msg.includes('403') || msg.includes('401')) {
+        return `GitHub authentication failed. Run 'gh auth login' or set GITHUB_TOKEN.`;
+    }
+    if (msg.includes('not found') || msg.includes('gh')) {
+        if (msg.includes('ENOENT') || msg.includes('not recognized') || msg.includes('command not found')) {
+            return `GitHub CLI (gh) is required for publishing. Install it from https://cli.github.com`;
+        }
+    }
+    if (msg.includes('Could not resolve host') || msg.includes('ENOTFOUND') || msg.includes('network')) {
+        return `Failed to reach GitHub. Check your internet connection.`;
+    }
+    if (msg.includes('permission') || msg.includes('denied')) {
+        return `Push failed. Check that you have write access to the repository.`;
+    }
+    return msg;
+}
+// ---------------------------------------------------------------------------
+// PR content generation
+// ---------------------------------------------------------------------------
+export async function updateManifestVersion(sourceDir, manifestFile, newVersion) {
+    const filePath = join(sourceDir, manifestFile);
+    const raw = await readFile(filePath, 'utf-8');
+    const parsed = JSON.parse(raw);
+    parsed['version'] = newVersion;
+    await writeFile(filePath, JSON.stringify(parsed, null, '\t') + '\n', 'utf-8');
+}
+export async function validatePublishTarget(target) {
+    const errors = [];
+    const warnings = [];
+    if (target.type === 'asset') {
+        const manifest = target.data;
+        // Entrypoint exists check (skip for mcp-config — fileless type)
+        if (manifest.type !== 'mcp-config' && manifest.entrypoint) {
+            const entrypointPath = join(target.sourceDir, manifest.entrypoint);
+            if (!existsSync(entrypointPath)) {
+                errors.push(`Entrypoint file '${manifest.entrypoint}' not found in ${target.sourceDir}`);
+            }
+        }
+        // Files array check
+        for (const file of manifest.files ?? []) {
+            const filePath = join(target.sourceDir, file);
+            if (!existsSync(filePath)) {
+                errors.push(`File '${file}' referenced in manifest but not found`);
+            }
+        }
+        // Name format validation
+        const nameResult = validateAssetName(manifest.name);
+        if (!nameResult.valid) {
+            errors.push(nameResult.error);
+        }
+        // Version format validation
+        if (!semverValid(manifest.version)) {
+            errors.push(`Invalid version '${manifest.version}'. Must be valid semver (e.g., 1.0.0)`);
+        }
+        // Missing optional fields warnings
+        if (!manifest.tags || manifest.tags.length === 0) {
+            warnings.push('No tags specified. Adding tags improves discoverability.');
+        }
+        if (!existsSync(join(target.sourceDir, 'README.md'))) {
+            warnings.push('No README.md found. Including a README is recommended.');
+        }
+        if (!manifest.tools || manifest.tools.length === 0) {
+            warnings.push('No tool compatibility specified. Adding tools improves discoverability.');
+        }
+        if (!manifest.security) {
+            warnings.push('No security block specified.');
+        }
+    }
+    else {
+        const bundle = target.data;
+        // Name format validation
+        const nameResult = validateAssetName(bundle.name);
+        if (!nameResult.valid) {
+            errors.push(nameResult.error);
+        }
+        // Version format validation
+        if (!semverValid(bundle.version)) {
+            errors.push(`Invalid version '${bundle.version}'. Must be valid semver (e.g., 1.0.0)`);
+        }
+        // Missing optional fields warnings
+        if (!bundle.tags || bundle.tags.length === 0) {
+            warnings.push('No tags specified. Adding tags improves discoverability.');
+        }
+        if (!existsSync(join(target.sourceDir, 'README.md'))) {
+            warnings.push('No README.md found. Including a README is recommended.');
+        }
+    }
+    return {
+        errors,
+        valid: errors.length === 0,
+        warnings,
+    };
+}
+// ---------------------------------------------------------------------------
+// Publish execution
+// ---------------------------------------------------------------------------
+function collectFilesToPublish(target) {
+    const files = [];
+    if (target.type === 'asset') {
+        const manifest = target.data;
+        files.push('manifest.json');
+        if (manifest.entrypoint && existsSync(join(target.sourceDir, manifest.entrypoint))) {
+            files.push(manifest.entrypoint);
+        }
+        for (const file of manifest.files ?? []) {
+            if (existsSync(join(target.sourceDir, file))) {
+                files.push(file);
+            }
+        }
+    }
+    else {
+        files.push('bundle.json');
+    }
+    if (existsSync(join(target.sourceDir, 'README.md'))) {
+        files.push('README.md');
+    }
+    return files;
+}
+// ---------------------------------------------------------------------------
+// Error helpers
+// ---------------------------------------------------------------------------
+function generatePrTitle(target, name, version, isUpdate) {
+    if (target.type === 'bundle') {
+        return isUpdate
+            ? `feat(registry): update bundle ${name} to ${version}`
+            : `feat(registry): add bundle ${name}@${version}`;
+    }
+    const assetType = target.data.type;
+    return isUpdate
+        ? `feat(registry): update ${assetType} ${name} to ${version}`
+        : `feat(registry): add ${assetType} ${name}@${version}`;
+}
+//# sourceMappingURL=publisher.js.map

package/build/lib/publisher.js.map

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

package/build/lib/registry.d.ts

@@ -0,0 +1,97 @@
+import { type Registry, type RegistryAsset, type RegistryAssetVersion, type RegistryBundle } from './schemas/registry.js';
+/**
+ * Result of a version-aware asset lookup.
+ * Contains the registry asset, the resolved version string, and the version-specific metadata.
+ */
+export interface ResolvedAsset {
+    /** The registry asset entry (name, type, tags, versions map, latest). */
+    asset: RegistryAsset;
+    /** The resolved semver version string. */
+    version: string;
+    /** The version-specific metadata (author, checksum, dependencies, etc.). */
+    versionData: RegistryAssetVersion;
+}
+/**
+ * Metadata about the registry cache file.
+ */
+export interface CacheStatus {
+    /** Age of the cache in milliseconds (0 if missing). */
+    ageMs: number;
+    /** Whether the cache file exists. */
+    exists: boolean;
+    /** Whether the cache has exceeded its TTL. */
+    expired: boolean;
+    /** Absolute path to the cache file. */
+    path: string;
+    /** Size in bytes (0 if missing). */
+    sizeBytes: number;
+    /** Configured TTL in minutes. */
+    ttlMinutes: number;
+}
+export declare class RegistryError extends Error {
+    constructor(message: string);
+}
+/**
+ * Clear the registry cache.
+ */
+export declare function clearCache(): Promise<void>;
+/**
+ * Fetch the registry, using cache when available and not expired.
+ */
+export declare function fetchRegistry(options?: {
+    force?: boolean;
+}): Promise<Registry>;
+/**
+ * Find an asset in the registry by name and resolve a specific version.
+ *
+ * Version resolution strategy:
+ * - If `version` is omitted or undefined, resolves to the `latest` version.
+ * - If `version` is an exact semver string (e.g. "1.2.3"), looks up that exact version.
+ * - If `version` is a semver range (e.g. "^1.0.0", ">=2.0.0"), resolves via `semver.maxSatisfying`.
+ *
+ * @param registry - The registry to search.
+ * @param name - Asset name to find.
+ * @param type - Optional asset type filter.
+ * @param version - Optional semver version or range. Defaults to the asset's `latest` version.
+ * @returns The resolved asset with version metadata, or undefined if not found.
+ */
+export declare function findAsset(registry: Registry, name: string, type?: string, version?: string): ResolvedAsset | undefined;
+/**
+ * Find a bundle in the registry by name.
+ */
+export declare function findBundle(registry: Registry, name: string): RegistryBundle | undefined;
+/**
+ * Get all assets of a given type from the registry.
+ */
+export declare function getAssetsByType(registry: Registry, type: string): RegistryAsset[];
+/**
+ * Get metadata about the registry cache file.
+ */
+export declare function getCacheStatus(): Promise<CacheStatus>;
+/**
+ * Extract and sort versions from a resolved registry asset.
+ *
+ * @param asset - The registry asset to extract versions from.
+ * @returns An object with the sorted version list (newest first) and the latest version.
+ */
+export declare function getSortedVersions(asset: RegistryAsset): {
+    latest: string;
+    versions: string[];
+};
+/**
+ * Check if an asset is deprecated.
+ */
+export declare function isDeprecated(registry: Registry, name: string, type?: string): {
+    deprecated: boolean;
+    reason?: string;
+    replacement?: string;
+};
+/**
+ * Resolve a version against an asset's versions map.
+ *
+ * @param asset - The registry asset to resolve a version for.
+ * @param version - Optional semver version or range. Defaults to the asset's `latest` version.
+ * @returns The resolved asset with version metadata, or undefined if the version cannot be resolved.
+ */
+export declare function resolveAssetVersion(asset: RegistryAsset, version?: string): ResolvedAsset | undefined;
+//# sourceMappingURL=registry.d.ts.map

package/build/lib/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/lib/registry.ts"],"names":[],"mappings":"AAUA,OAAO,EACL,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,KAAK,oBAAoB,EACzB,KAAK,cAAc,EAEpB,MAAM,uBAAuB,CAAC;AAE/B;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,yEAAyE;IACzE,KAAK,EAAE,aAAa,CAAC;IACrB,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,4EAA4E;IAC5E,WAAW,EAAE,oBAAoB,CAAC;CACnC;AAKD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,uDAAuD;IACvD,KAAK,EAAE,MAAM,CAAC;IACd,qCAAqC;IACrC,MAAM,EAAE,OAAO,CAAC;IAChB,8CAA8C;IAC9C,OAAO,EAAE,OAAO,CAAC;IACjB,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,iCAAiC;IACjC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,aAAc,SAAQ,KAAK;gBAC1B,OAAO,EAAE,MAAM;CAI5B;AAED;;GAEG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAShD;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,QAAQ,CAAC,CAoBpF;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,SAAS,CACvB,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,MAAM,GACf,aAAa,GAAG,SAAS,CAO3B;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAEvF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,aAAa,EAAE,CAEjF;AAED;;GAEG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,WAAW,CAAC,CAe3D;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,aAAa,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAY9F;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,GACZ;IAAE,UAAU,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,CAUhE;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAkCrG"}