@runcore-sh/runcore 0.1.2

package/dist/core/registry/publisher.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Template & Skill Sharing Registry — Publishing and validation.
+ *
+ * Validates publish requests, generates IDs and checksums, and creates
+ * registry entries. Handles both initial publishes and version bumps.
+ */
+import type { PublishRequest, PublishResult, ValidationResult } from "./types.js";
+import type { RegistryStore } from "./store.js";
+/** Generate a unique entry ID. */
+export declare function generateEntryId(): string;
+/** Compute SHA-256 hex digest of content. */
+export declare function computeChecksum(content: string): string;
+/**
+ * Compare two semver strings.
+ * Returns positive if a > b, negative if a < b, 0 if equal.
+ */
+export declare function compareSemver(a: string, b: string): number;
+/** Validate a publish request without side effects. */
+export declare function validatePublishRequest(req: PublishRequest, store: RegistryStore): ValidationResult;
+/** Publish a new entry or new version of an existing entry. */
+export declare function publishEntry(req: PublishRequest, store: RegistryStore): Promise<PublishResult>;
+//# sourceMappingURL=publisher.d.ts.map

package/dist/core/registry/publisher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"publisher.d.ts","sourceRoot":"","sources":["../../../src/core/registry/publisher.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAGV,cAAc,EACd,aAAa,EACb,gBAAgB,EAGjB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAwBhD,kCAAkC;AAClC,wBAAgB,eAAe,IAAI,MAAM,CAIxC;AAED,6CAA6C;AAC7C,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAO1D;AAMD,uDAAuD;AACvD,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,cAAc,EACnB,KAAK,EAAE,aAAa,GACnB,gBAAgB,CAmFlB;AAMD,+DAA+D;AAC/D,wBAAsB,YAAY,CAChC,GAAG,EAAE,cAAc,EACnB,KAAK,EAAE,aAAa,GACnB,OAAO,CAAC,aAAa,CAAC,CAoExB"}

package/dist/core/registry/publisher.js

@@ -0,0 +1,195 @@
+/**
+ * Template & Skill Sharing Registry — Publishing and validation.
+ *
+ * Validates publish requests, generates IDs and checksums, and creates
+ * registry entries. Handles both initial publishes and version bumps.
+ */
+import { createHash } from "node:crypto";
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const SEMVER_RE = /^\d+\.\d+\.\d+$/;
+const NAME_RE = /^[a-z][a-z0-9\-]{1,63}$/;
+const FRONTMATTER_RE = /^---\r?\n[\s\S]*?\r?\n---/;
+const VALID_CATEGORIES = new Set([
+    "code-review",
+    "bug-investigation",
+    "feature-implementation",
+    "testing",
+    "deployment-ops",
+    "integration",
+    "custom",
+]);
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/** Generate a unique entry ID. */
+export function generateEntryId() {
+    const ts = Date.now().toString(36);
+    const rand = Math.random().toString(36).slice(2, 10);
+    return `reg_${ts}_${rand}`;
+}
+/** Compute SHA-256 hex digest of content. */
+export function computeChecksum(content) {
+    return createHash("sha256").update(content, "utf-8").digest("hex");
+}
+/**
+ * Compare two semver strings.
+ * Returns positive if a > b, negative if a < b, 0 if equal.
+ */
+export function compareSemver(a, b) {
+    const pa = a.split(".").map(Number);
+    const pb = b.split(".").map(Number);
+    for (let i = 0; i < 3; i++) {
+        if (pa[i] !== pb[i])
+            return pa[i] - pb[i];
+    }
+    return 0;
+}
+// ---------------------------------------------------------------------------
+// Validation
+// ---------------------------------------------------------------------------
+/** Validate a publish request without side effects. */
+export function validatePublishRequest(req, store) {
+    const errors = [];
+    const warnings = [];
+    // Required fields
+    if (!req.name)
+        errors.push("Missing required field: name");
+    if (!req.version)
+        errors.push("Missing required field: version");
+    if (!req.description)
+        errors.push("Missing required field: description");
+    if (!req.author)
+        errors.push("Missing required field: author");
+    if (!req.content)
+        errors.push("Missing required field: content");
+    if (!req.type)
+        errors.push("Missing required field: type");
+    // Name format
+    if (req.name && !NAME_RE.test(req.name)) {
+        errors.push(`Invalid name "${req.name}" — must be lowercase alphanumeric with hyphens, 2-64 chars`);
+    }
+    // Version format
+    if (req.version && !SEMVER_RE.test(req.version)) {
+        errors.push(`Invalid version "${req.version}" — must be semver (e.g., 1.0.0)`);
+    }
+    // Type validation
+    if (req.type && req.type !== "template" && req.type !== "skill") {
+        errors.push(`Invalid type "${req.type}" — must be "template" or "skill"`);
+    }
+    // Category validation (templates only)
+    if (req.category) {
+        if (req.type !== "template") {
+            warnings.push("Category is only meaningful for templates");
+        }
+        else if (!VALID_CATEGORIES.has(req.category)) {
+            errors.push(`Invalid category "${req.category}"`);
+        }
+    }
+    // Content validation based on type
+    if (req.content && req.type === "skill") {
+        if (!FRONTMATTER_RE.test(req.content)) {
+            warnings.push("Skill content should have YAML frontmatter (--- delimiters)");
+        }
+    }
+    if (req.content && req.type === "template") {
+        // Templates should contain structural markers
+        const hasContext = /\[CONTEXT\]/i.test(req.content);
+        const hasTask = /\[TASK\]/i.test(req.content);
+        if (!hasContext && !hasTask) {
+            warnings.push("Template content should include [CONTEXT] and [TASK] sections per prompt anatomy");
+        }
+    }
+    // Description length
+    if (req.description && req.description.length > 500) {
+        warnings.push("Description exceeds 500 chars — consider shortening for search results");
+    }
+    // Version bump check for existing entries
+    if (req.name && req.type && req.version) {
+        const existing = store.findEntry(req.name, req.type);
+        if (existing) {
+            if (compareSemver(req.version, existing.version) <= 0) {
+                errors.push(`Version ${req.version} must be greater than current version ${existing.version}`);
+            }
+        }
+    }
+    // Tags sanity
+    if (req.tags) {
+        for (const tag of req.tags) {
+            if (tag.length > 30) {
+                warnings.push(`Tag "${tag}" is very long — keep tags short for search`);
+            }
+        }
+    }
+    return { valid: errors.length === 0, errors, warnings };
+}
+// ---------------------------------------------------------------------------
+// Publishing
+// ---------------------------------------------------------------------------
+/** Publish a new entry or new version of an existing entry. */
+export async function publishEntry(req, store) {
+    // Validate first
+    const validation = validatePublishRequest(req, store);
+    if (!validation.valid) {
+        return { ok: false, errors: validation.errors, warnings: validation.warnings };
+    }
+    const now = new Date().toISOString();
+    const checksum = computeChecksum(req.content);
+    const existing = store.findEntry(req.name, req.type);
+    let entry;
+    if (existing) {
+        // Version bump — update existing entry
+        entry = {
+            ...existing,
+            version: req.version,
+            description: req.description,
+            content: req.content,
+            tags: req.tags ?? existing.tags,
+            category: req.category ?? existing.category,
+            dependencies: req.dependencies ?? existing.dependencies,
+            checksum,
+            status: "published",
+            updatedAt: now,
+        };
+    }
+    else {
+        // New entry
+        entry = {
+            id: generateEntryId(),
+            type: req.type,
+            name: req.name,
+            version: req.version,
+            description: req.description,
+            author: req.author,
+            content: req.content,
+            tags: req.tags ?? [],
+            category: req.type === "template" ? (req.category ?? "custom") : undefined,
+            dependencies: req.dependencies ?? [],
+            status: "published",
+            checksum,
+            downloads: 0,
+            publishedAt: now,
+            updatedAt: now,
+        };
+    }
+    // Persist entry
+    await store.saveEntry(entry);
+    // Record version snapshot
+    const version = {
+        entryId: entry.id,
+        version: req.version,
+        content: req.content,
+        checksum,
+        changelog: req.changelog ?? "",
+        publishedAt: now,
+    };
+    await store.addVersion(version);
+    return {
+        ok: true,
+        entry,
+        errors: [],
+        warnings: validation.warnings,
+    };
+}
+//# sourceMappingURL=publisher.js.map

package/dist/core/registry/publisher.js.map

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

package/dist/core/registry/registry.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Template & Skill Sharing Registry — Main service.
+ *
+ * Orchestrates publishing, discovery, search, versioning, and installation
+ * of shared templates and skills. Integrates with the existing SkillRegistry
+ * for skill installation and the agent template patterns.
+ */
+import type { RegistryEntry, RegistryItemType, RegistryItemStatus, PublishRequest, PublishResult, RegistrySearchQuery, RegistrySearchResult, InstallRequest, InstallResult, ValidationResult } from "./types.js";
+import type { VersionHistory, VersionSummary } from "./versions.js";
+export declare class SharingRegistry {
+    private readonly store;
+    /** Path to brain directory (for skill installation). */
+    private readonly brainDir;
+    /** Path to installed skills directory. */
+    private readonly installedDir;
+    private initialized;
+    constructor(opts: {
+        registryDir: string;
+        brainDir: string;
+    });
+    /** Load registry state from disk. */
+    init(): Promise<void>;
+    /**
+     * Publish a template or skill to the registry.
+     * Creates a new entry or bumps the version of an existing one.
+     */
+    publish(req: PublishRequest): Promise<PublishResult>;
+    /**
+     * Validate a publish request without actually publishing.
+     * Useful for dry-run / pre-flight checks.
+     */
+    validate(req: PublishRequest): ValidationResult;
+    /** Search the registry with filtering, scoring, and pagination. */
+    search(query: RegistrySearchQuery): RegistrySearchResult;
+    /** Get a single entry by ID. */
+    getEntry(id: string): RegistryEntry | undefined;
+    /** Find an entry by name and type. */
+    findEntry(name: string, type: RegistryItemType): RegistryEntry | undefined;
+    /** List all entries of a given type. */
+    listByType(type: RegistryItemType): RegistryEntry[];
+    /** Get entries that an entry depends on. */
+    getDependencies(entryId: string): RegistryEntry[];
+    /** Transition an entry's status (e.g., published → deprecated). */
+    setStatus(entryId: string, newStatus: RegistryItemStatus): Promise<void>;
+    /** Deprecate an entry (still discoverable but flagged). */
+    deprecate(entryId: string): Promise<void>;
+    /** Withdraw an entry from the registry (terminal). */
+    withdraw(entryId: string): Promise<void>;
+    /** Get the full version history for an entry. */
+    getVersionHistory(entryId: string): VersionHistory | null;
+    /** Get content at a specific version. */
+    getVersionContent(entryId: string, version: string): string | null;
+    /** Rollback an entry to a previous version. */
+    rollback(entryId: string, targetVersion: string): Promise<RegistryEntry | null>;
+    /** Check if an update is available for a locally installed version. */
+    checkForUpdate(entryId: string, localVersion: string): {
+        available: boolean;
+        latest?: string;
+        versions?: VersionSummary[];
+    };
+    /**
+     * Install a registry entry locally.
+     *
+     * For skills: writes the content to brain/registry/installed/{name}.md
+     * so the SkillRegistry can discover it on next refresh.
+     *
+     * For templates: writes to brain/registry/installed/{name}.template.md
+     * for use by the agent spawning system.
+     */
+    install(req: InstallRequest): Promise<InstallResult>;
+    /**
+     * Uninstall a previously installed registry entry.
+     * Removes the installed file but does not affect the registry entry.
+     */
+    uninstall(name: string, type: RegistryItemType): Promise<boolean>;
+    /** Get registry statistics. */
+    stats(): {
+        total: number;
+        byType: Record<RegistryItemType, number>;
+        byStatus: Record<RegistryItemStatus, number>;
+    };
+    /** Total entry count. */
+    get size(): number;
+}
+/** Create and initialize the global sharing registry. */
+export declare function createSharingRegistry(opts: {
+    registryDir: string;
+    brainDir: string;
+}): Promise<SharingRegistry>;
+/** Get the global sharing registry (null if not initialized). */
+export declare function getSharingRegistry(): SharingRegistry | null;
+//# sourceMappingURL=registry.d.ts.map

package/dist/core/registry/registry.d.ts.map

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

package/dist/core/registry/registry.js

@@ -0,0 +1,254 @@
+/**
+ * Template & Skill Sharing Registry — Main service.
+ *
+ * Orchestrates publishing, discovery, search, versioning, and installation
+ * of shared templates and skills. Integrates with the existing SkillRegistry
+ * for skill installation and the agent template patterns.
+ */
+import { writeFile, mkdir } from "node:fs/promises";
+import { join } from "node:path";
+import { STATUS_TRANSITIONS, RegistryStatusError } from "./types.js";
+import { RegistryStore } from "./store.js";
+import { publishEntry, validatePublishRequest } from "./publisher.js";
+import { searchRegistry } from "./search.js";
+import { getVersionHistory, getVersionContent, rollbackToVersion, isUpdateAvailable, getNewerVersions, } from "./versions.js";
+// ---------------------------------------------------------------------------
+// SharingRegistry
+// ---------------------------------------------------------------------------
+export class SharingRegistry {
+    store;
+    /** Path to brain directory (for skill installation). */
+    brainDir;
+    /** Path to installed skills directory. */
+    installedDir;
+    initialized = false;
+    constructor(opts) {
+        this.store = new RegistryStore({ registryDir: opts.registryDir });
+        this.brainDir = opts.brainDir;
+        this.installedDir = join(opts.brainDir, "registry", "installed");
+    }
+    // -------------------------------------------------------------------------
+    // Initialization
+    // -------------------------------------------------------------------------
+    /** Load registry state from disk. */
+    async init() {
+        if (this.initialized)
+            return;
+        await this.store.load();
+        this.initialized = true;
+    }
+    // -------------------------------------------------------------------------
+    // Publishing
+    // -------------------------------------------------------------------------
+    /**
+     * Publish a template or skill to the registry.
+     * Creates a new entry or bumps the version of an existing one.
+     */
+    async publish(req) {
+        return publishEntry(req, this.store);
+    }
+    /**
+     * Validate a publish request without actually publishing.
+     * Useful for dry-run / pre-flight checks.
+     */
+    validate(req) {
+        return validatePublishRequest(req, this.store);
+    }
+    // -------------------------------------------------------------------------
+    // Discovery
+    // -------------------------------------------------------------------------
+    /** Search the registry with filtering, scoring, and pagination. */
+    search(query) {
+        return searchRegistry(this.store.allEntries(), query);
+    }
+    /** Get a single entry by ID. */
+    getEntry(id) {
+        return this.store.getEntry(id);
+    }
+    /** Find an entry by name and type. */
+    findEntry(name, type) {
+        return this.store.findEntry(name, type);
+    }
+    /** List all entries of a given type. */
+    listByType(type) {
+        return this.store.allEntries().filter((e) => e.type === type && e.status !== "withdrawn");
+    }
+    /** Get entries that an entry depends on. */
+    getDependencies(entryId) {
+        const entry = this.store.getEntry(entryId);
+        if (!entry)
+            return [];
+        return entry.dependencies
+            .map((depId) => this.store.getEntry(depId))
+            .filter((e) => e !== undefined);
+    }
+    // -------------------------------------------------------------------------
+    // Status management
+    // -------------------------------------------------------------------------
+    /** Transition an entry's status (e.g., published → deprecated). */
+    async setStatus(entryId, newStatus) {
+        const entry = this.store.getEntry(entryId);
+        if (!entry)
+            throw new Error(`Registry entry not found: ${entryId}`);
+        const allowed = STATUS_TRANSITIONS[entry.status];
+        if (!allowed.includes(newStatus)) {
+            throw new RegistryStatusError(entryId, entry.status, newStatus);
+        }
+        const updated = {
+            ...entry,
+            status: newStatus,
+            updatedAt: new Date().toISOString(),
+        };
+        await this.store.saveEntry(updated);
+    }
+    /** Deprecate an entry (still discoverable but flagged). */
+    async deprecate(entryId) {
+        await this.setStatus(entryId, "deprecated");
+    }
+    /** Withdraw an entry from the registry (terminal). */
+    async withdraw(entryId) {
+        await this.setStatus(entryId, "withdrawn");
+    }
+    // -------------------------------------------------------------------------
+    // Version management
+    // -------------------------------------------------------------------------
+    /** Get the full version history for an entry. */
+    getVersionHistory(entryId) {
+        const entry = this.store.getEntry(entryId);
+        if (!entry)
+            return null;
+        return getVersionHistory(entry, this.store);
+    }
+    /** Get content at a specific version. */
+    getVersionContent(entryId, version) {
+        return getVersionContent(entryId, version, this.store);
+    }
+    /** Rollback an entry to a previous version. */
+    async rollback(entryId, targetVersion) {
+        return rollbackToVersion(entryId, targetVersion, this.store);
+    }
+    /** Check if an update is available for a locally installed version. */
+    checkForUpdate(entryId, localVersion) {
+        const entry = this.store.getEntry(entryId);
+        if (!entry)
+            return { available: false };
+        const available = isUpdateAvailable(localVersion, entry);
+        if (!available)
+            return { available: false };
+        return {
+            available: true,
+            latest: entry.version,
+            versions: getNewerVersions(entryId, localVersion, this.store),
+        };
+    }
+    // -------------------------------------------------------------------------
+    // Installation
+    // -------------------------------------------------------------------------
+    /**
+     * Install a registry entry locally.
+     *
+     * For skills: writes the content to brain/registry/installed/{name}.md
+     * so the SkillRegistry can discover it on next refresh.
+     *
+     * For templates: writes to brain/registry/installed/{name}.template.md
+     * for use by the agent spawning system.
+     */
+    async install(req) {
+        const entry = this.store.getEntry(req.entryId);
+        if (!entry) {
+            return { ok: false, errors: ["Entry not found"] };
+        }
+        if (entry.status === "withdrawn") {
+            return { ok: false, errors: ["Entry has been withdrawn"] };
+        }
+        // Resolve version
+        let content = entry.content;
+        if (req.version && req.version !== entry.version) {
+            const versionContent = getVersionContent(entry.id, req.version, this.store);
+            if (!versionContent) {
+                return { ok: false, errors: [`Version ${req.version} not found`] };
+            }
+            content = versionContent;
+        }
+        // Determine install path
+        const targetDir = req.targetDir ?? this.installedDir;
+        await mkdir(targetDir, { recursive: true });
+        const ext = entry.type === "skill" ? ".md" : ".template.md";
+        const installPath = join(targetDir, `${entry.name}${ext}`);
+        // Write the content
+        await writeFile(installPath, content, "utf-8");
+        // Increment download count
+        const updated = {
+            ...entry,
+            downloads: entry.downloads + 1,
+            updatedAt: new Date().toISOString(),
+        };
+        await this.store.saveEntry(updated);
+        return {
+            ok: true,
+            entry: updated,
+            installedPath: installPath,
+            errors: [],
+        };
+    }
+    /**
+     * Uninstall a previously installed registry entry.
+     * Removes the installed file but does not affect the registry entry.
+     */
+    async uninstall(name, type) {
+        const { unlink } = await import("node:fs/promises");
+        const ext = type === "skill" ? ".md" : ".template.md";
+        const installPath = join(this.installedDir, `${name}${ext}`);
+        try {
+            await unlink(installPath);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Metrics
+    // -------------------------------------------------------------------------
+    /** Get registry statistics. */
+    stats() {
+        const entries = this.store.allEntries();
+        const byType = { template: 0, skill: 0 };
+        const byStatus = {
+            draft: 0,
+            published: 0,
+            deprecated: 0,
+            withdrawn: 0,
+        };
+        for (const entry of entries) {
+            byType[entry.type] = (byType[entry.type] ?? 0) + 1;
+            byStatus[entry.status] = (byStatus[entry.status] ?? 0) + 1;
+        }
+        return {
+            total: entries.length,
+            byType: byType,
+            byStatus: byStatus,
+        };
+    }
+    /** Total entry count. */
+    get size() {
+        return this.store.entryCount;
+    }
+}
+// ---------------------------------------------------------------------------
+// Singleton
+// ---------------------------------------------------------------------------
+let _registry = null;
+/** Create and initialize the global sharing registry. */
+export async function createSharingRegistry(opts) {
+    if (_registry)
+        return _registry;
+    _registry = new SharingRegistry(opts);
+    await _registry.init();
+    return _registry;
+}
+/** Get the global sharing registry (null if not initialized). */
+export function getSharingRegistry() {
+    return _registry;
+}
+//# sourceMappingURL=registry.js.map

package/dist/core/registry/registry.js.map

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

package/dist/core/registry/search.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Template & Skill Sharing Registry — Search and filtering.
+ *
+ * Provides text search, faceted filtering, and relevance scoring
+ * for registry entries. Operates on the in-memory store.
+ */
+import type { RegistryEntry, RegistrySearchQuery, RegistrySearchResult } from "./types.js";
+/**
+ * Search the registry with filtering, scoring, sorting, and pagination.
+ */
+export declare function searchRegistry(allEntries: RegistryEntry[], query: RegistrySearchQuery): RegistrySearchResult;
+//# sourceMappingURL=search.d.ts.map

package/dist/core/registry/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../src/core/registry/search.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,aAAa,EACb,mBAAmB,EACnB,oBAAoB,EACrB,MAAM,YAAY,CAAC;AA0HpB;;GAEG;AACH,wBAAgB,cAAc,CAC5B,UAAU,EAAE,aAAa,EAAE,EAC3B,KAAK,EAAE,mBAAmB,GACzB,oBAAoB,CA+BtB"}