@runcore-sh/runcore 0.1.2

package/dist/core/registry/search.js

@@ -0,0 +1,132 @@
+/**
+ * Template & Skill Sharing Registry — Search and filtering.
+ *
+ * Provides text search, faceted filtering, and relevance scoring
+ * for registry entries. Operates on the in-memory store.
+ */
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/** Tokenize text into lowercase words for matching. */
+function tokenize(text) {
+    return text
+        .toLowerCase()
+        .replace(/[^\w\s]/g, " ")
+        .split(/\s+/)
+        .filter((w) => w.length > 1);
+}
+/**
+ * Score an entry against a free-text query.
+ * Returns 0 if no match, higher for better matches.
+ * Weights: name match > tag match > description match.
+ */
+function scoreEntry(entry, queryTokens) {
+    if (queryTokens.length === 0)
+        return 1; // No query = match all
+    let score = 0;
+    const nameTokens = new Set(tokenize(entry.name));
+    const descTokens = new Set(tokenize(entry.description));
+    const tagTokens = new Set(entry.tags.flatMap((t) => tokenize(t)));
+    for (const qt of queryTokens) {
+        // Exact name match (highest weight)
+        if (nameTokens.has(qt)) {
+            score += 3;
+        }
+        // Partial name match
+        else if ([...nameTokens].some((nt) => nt.includes(qt) || qt.includes(nt))) {
+            score += 2;
+        }
+        // Tag match
+        if (tagTokens.has(qt)) {
+            score += 2;
+        }
+        // Description match
+        if (descTokens.has(qt)) {
+            score += 1;
+        }
+    }
+    // Normalize by query length to get a 0–1 ish score
+    return score / (queryTokens.length * 3);
+}
+// ---------------------------------------------------------------------------
+// Filtering
+// ---------------------------------------------------------------------------
+/** Apply all filters from a search query to an entry list. */
+function applyFilters(entries, query) {
+    return entries.filter((entry) => {
+        // Status filter (default: published)
+        const targetStatus = query.status ?? "published";
+        if (entry.status !== targetStatus)
+            return false;
+        // Type filter
+        if (query.type && entry.type !== query.type)
+            return false;
+        // Category filter
+        if (query.category && entry.category !== query.category)
+            return false;
+        // Author filter
+        if (query.author && entry.author !== query.author)
+            return false;
+        // Tags filter (all specified tags must be present)
+        if (query.tags && query.tags.length > 0) {
+            const entryTagSet = new Set(entry.tags.map((t) => t.toLowerCase()));
+            for (const tag of query.tags) {
+                if (!entryTagSet.has(tag.toLowerCase()))
+                    return false;
+            }
+        }
+        return true;
+    });
+}
+/** Sort scored entries by the requested field and direction. */
+function sortEntries(scored, sortBy, sortOrder) {
+    const dir = sortOrder === "desc" ? -1 : 1;
+    return scored.sort((a, b) => {
+        switch (sortBy) {
+            case "name":
+                return dir * a.entry.name.localeCompare(b.entry.name);
+            case "publishedAt":
+                return dir * a.entry.publishedAt.localeCompare(b.entry.publishedAt);
+            case "downloads":
+                return dir * (a.entry.downloads - b.entry.downloads);
+            case "relevance":
+            default:
+                // Relevance: higher is better, so reverse the default
+                return -dir * (a.relevance - b.relevance);
+        }
+    });
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Search the registry with filtering, scoring, sorting, and pagination.
+ */
+export function searchRegistry(allEntries, query) {
+    // 1. Apply hard filters
+    const filtered = applyFilters(allEntries, query);
+    // 2. Score against free-text query
+    const queryTokens = query.query ? tokenize(query.query) : [];
+    let scored = filtered.map((entry) => ({
+        entry,
+        relevance: scoreEntry(entry, queryTokens),
+    }));
+    // 3. If there's a query, filter out zero-relevance entries
+    if (queryTokens.length > 0) {
+        scored = scored.filter((s) => s.relevance > 0);
+    }
+    // 4. Sort
+    const sortBy = query.sortBy ?? (queryTokens.length > 0 ? "relevance" : "publishedAt");
+    const sortOrder = query.sortOrder ?? (sortBy === "publishedAt" ? "desc" : "asc");
+    const sorted = sortEntries(scored, sortBy, sortOrder);
+    // 5. Paginate
+    const offset = query.offset ?? 0;
+    const limit = query.limit ?? 20;
+    const page = sorted.slice(offset, offset + limit);
+    return {
+        entries: page.map((s) => s.entry),
+        total: sorted.length,
+        query,
+    };
+}
+//# sourceMappingURL=search.js.map

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

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

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

@@ -0,0 +1,55 @@
+/**
+ * Template & Skill Sharing Registry — File-backed persistence.
+ *
+ * Stores registry entries as individual JSON files in brain/registry/entries/
+ * and versions as append-only JSONL in brain/registry/versions.jsonl.
+ * Follows the AgentRegistry pattern: in-memory Map + file persistence.
+ */
+import type { RegistryEntry, RegistryVersion } from "./types.js";
+export declare class RegistryStore {
+    /** In-memory entry map, keyed by entry ID. */
+    private readonly entries;
+    /** In-memory version list, keyed by entryId. */
+    private readonly versions;
+    /** Base directory for registry persistence. */
+    private readonly baseDir;
+    /** Path to entries directory. */
+    private readonly entriesDir;
+    /** Path to versions JSONL file. */
+    private readonly versionsFile;
+    private loaded;
+    constructor(opts: {
+        registryDir: string;
+    });
+    /** Load all entries and versions from disk into memory. */
+    load(): Promise<void>;
+    /** Get an entry by ID. */
+    getEntry(id: string): RegistryEntry | undefined;
+    /** Find an entry by name and type. */
+    findEntry(name: string, type: string): RegistryEntry | undefined;
+    /** Get all entries. */
+    allEntries(): RegistryEntry[];
+    /** Save (create or update) an entry. Persists to disk. */
+    saveEntry(entry: RegistryEntry): Promise<void>;
+    /** Remove an entry from memory and disk. */
+    removeEntry(id: string): Promise<void>;
+    /** Total number of entries. */
+    get entryCount(): number;
+    /** Get all versions for an entry, sorted newest first. */
+    getVersions(entryId: string): RegistryVersion[];
+    /** Get a specific version. */
+    getVersion(entryId: string, version: string): RegistryVersion | undefined;
+    /** Append a version record. Persists to JSONL (append-only). */
+    addVersion(ver: RegistryVersion): Promise<void>;
+    /** Ensure required directories exist. */
+    private ensureDirs;
+    /** Load all entry JSON files from entries/ directory. */
+    private loadEntries;
+    /** Load versions from append-only JSONL file. */
+    private loadVersions;
+    /** Write a single entry to its JSON file (atomic via rename). */
+    private persistEntry;
+    /** Append a version record to the JSONL file. */
+    private appendVersion;
+}
+//# sourceMappingURL=store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../src/core/registry/store.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAMjE,qBAAa,aAAa;IACxB,8CAA8C;IAC9C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoC;IAE5D,gDAAgD;IAChD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAwC;IAEjE,+CAA+C;IAC/C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IAEjC,iCAAiC;IACjC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IAEpC,mCAAmC;IACnC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IAEtC,OAAO,CAAC,MAAM,CAAS;gBAEX,IAAI,EAAE;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE;IAUzC,2DAA2D;IACrD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAa3B,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAI/C,sCAAsC;IACtC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAOhE,uBAAuB;IACvB,UAAU,IAAI,aAAa,EAAE;IAI7B,0DAA0D;IACpD,SAAS,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAKpD,4CAA4C;IACtC,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU5C,+BAA+B;IAC/B,IAAI,UAAU,IAAI,MAAM,CAEvB;IAMD,0DAA0D;IAC1D,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,EAAE;IAM/C,8BAA8B;IAC9B,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAMzE,gEAAgE;IAC1D,UAAU,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAWrD,yCAAyC;YAC3B,UAAU;IAIxB,yDAAyD;YAC3C,WAAW;IAuBzB,iDAAiD;YACnC,YAAY;IAwB1B,iEAAiE;YACnD,YAAY;IAO1B,iDAAiD;YACnC,aAAa;CAe5B"}

package/dist/core/registry/store.js

@@ -0,0 +1,185 @@
+/**
+ * Template & Skill Sharing Registry — File-backed persistence.
+ *
+ * Stores registry entries as individual JSON files in brain/registry/entries/
+ * and versions as append-only JSONL in brain/registry/versions.jsonl.
+ * Follows the AgentRegistry pattern: in-memory Map + file persistence.
+ */
+import { readdir, readFile, writeFile, mkdir, rename, unlink } from "node:fs/promises";
+import { join } from "node:path";
+// ---------------------------------------------------------------------------
+// RegistryStore
+// ---------------------------------------------------------------------------
+export class RegistryStore {
+    /** In-memory entry map, keyed by entry ID. */
+    entries = new Map();
+    /** In-memory version list, keyed by entryId. */
+    versions = new Map();
+    /** Base directory for registry persistence. */
+    baseDir;
+    /** Path to entries directory. */
+    entriesDir;
+    /** Path to versions JSONL file. */
+    versionsFile;
+    loaded = false;
+    constructor(opts) {
+        this.baseDir = opts.registryDir;
+        this.entriesDir = join(opts.registryDir, "entries");
+        this.versionsFile = join(opts.registryDir, "versions.jsonl");
+    }
+    // -------------------------------------------------------------------------
+    // Initialization
+    // -------------------------------------------------------------------------
+    /** Load all entries and versions from disk into memory. */
+    async load() {
+        if (this.loaded)
+            return;
+        await this.ensureDirs();
+        await this.loadEntries();
+        await this.loadVersions();
+        this.loaded = true;
+    }
+    // -------------------------------------------------------------------------
+    // Entry CRUD
+    // -------------------------------------------------------------------------
+    /** Get an entry by ID. */
+    getEntry(id) {
+        return this.entries.get(id);
+    }
+    /** Find an entry by name and type. */
+    findEntry(name, type) {
+        for (const entry of this.entries.values()) {
+            if (entry.name === name && entry.type === type)
+                return entry;
+        }
+        return undefined;
+    }
+    /** Get all entries. */
+    allEntries() {
+        return Array.from(this.entries.values());
+    }
+    /** Save (create or update) an entry. Persists to disk. */
+    async saveEntry(entry) {
+        this.entries.set(entry.id, entry);
+        await this.persistEntry(entry);
+    }
+    /** Remove an entry from memory and disk. */
+    async removeEntry(id) {
+        this.entries.delete(id);
+        const filePath = join(this.entriesDir, `${id}.json`);
+        try {
+            await unlink(filePath);
+        }
+        catch {
+            // File may not exist
+        }
+    }
+    /** Total number of entries. */
+    get entryCount() {
+        return this.entries.size;
+    }
+    // -------------------------------------------------------------------------
+    // Version CRUD
+    // -------------------------------------------------------------------------
+    /** Get all versions for an entry, sorted newest first. */
+    getVersions(entryId) {
+        return (this.versions.get(entryId) ?? []).slice().sort((a, b) => b.publishedAt.localeCompare(a.publishedAt));
+    }
+    /** Get a specific version. */
+    getVersion(entryId, version) {
+        const versions = this.versions.get(entryId);
+        if (!versions)
+            return undefined;
+        return versions.find((v) => v.version === version);
+    }
+    /** Append a version record. Persists to JSONL (append-only). */
+    async addVersion(ver) {
+        const list = this.versions.get(ver.entryId) ?? [];
+        list.push(ver);
+        this.versions.set(ver.entryId, list);
+        await this.appendVersion(ver);
+    }
+    // -------------------------------------------------------------------------
+    // Internal: persistence
+    // -------------------------------------------------------------------------
+    /** Ensure required directories exist. */
+    async ensureDirs() {
+        await mkdir(this.entriesDir, { recursive: true });
+    }
+    /** Load all entry JSON files from entries/ directory. */
+    async loadEntries() {
+        let files;
+        try {
+            files = await readdir(this.entriesDir);
+        }
+        catch {
+            return;
+        }
+        for (const file of files) {
+            if (!file.endsWith(".json"))
+                continue;
+            const filePath = join(this.entriesDir, file);
+            try {
+                const raw = await readFile(filePath, "utf-8");
+                const entry = JSON.parse(raw);
+                if (entry.id) {
+                    this.entries.set(entry.id, entry);
+                }
+            }
+            catch {
+                // Skip corrupt files
+            }
+        }
+    }
+    /** Load versions from append-only JSONL file. */
+    async loadVersions() {
+        let raw;
+        try {
+            raw = await readFile(this.versionsFile, "utf-8");
+        }
+        catch {
+            return; // File doesn't exist yet
+        }
+        for (const line of raw.split("\n")) {
+            const trimmed = line.trim();
+            if (!trimmed || trimmed.startsWith("{\"_schema\""))
+                continue;
+            try {
+                const ver = JSON.parse(trimmed);
+                if (ver.entryId && ver.version) {
+                    const list = this.versions.get(ver.entryId) ?? [];
+                    list.push(ver);
+                    this.versions.set(ver.entryId, list);
+                }
+            }
+            catch {
+                // Skip malformed lines
+            }
+        }
+    }
+    /** Write a single entry to its JSON file (atomic via rename). */
+    async persistEntry(entry) {
+        const filePath = join(this.entriesDir, `${entry.id}.json`);
+        const tmpPath = filePath + ".tmp";
+        await writeFile(tmpPath, JSON.stringify(entry, null, 2), "utf-8");
+        await rename(tmpPath, filePath);
+    }
+    /** Append a version record to the JSONL file. */
+    async appendVersion(ver) {
+        const line = JSON.stringify(ver) + "\n";
+        try {
+            // Append to existing file
+            const existing = await readFile(this.versionsFile, "utf-8");
+            await writeFile(this.versionsFile, existing + line, "utf-8");
+        }
+        catch {
+            // File doesn't exist — create with schema header
+            const header = JSON.stringify({
+                _schema: "registry-version",
+                fields: ["entryId", "version", "content", "checksum", "changelog", "publishedAt"],
+            }) + "\n";
+            await writeFile(this.versionsFile, header + line, "utf-8");
+        }
+    }
+}
+//# sourceMappingURL=store.js.map

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

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

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

@@ -0,0 +1,141 @@
+/**
+ * Template & Skill Sharing Registry — Type definitions.
+ *
+ * Defines the data model for publishable, discoverable, and versionable
+ * resources (agent templates and skills) in the sharing registry.
+ */
+/** What kind of resource is being shared. */
+export type RegistryItemType = "template" | "skill";
+/** Lifecycle status of a registry entry. */
+export type RegistryItemStatus = "draft" | "published" | "deprecated" | "withdrawn";
+/** Valid status transitions. */
+export declare const STATUS_TRANSITIONS: Record<RegistryItemStatus, RegistryItemStatus[]>;
+/** Template categories (aligned with agent-templates-spec.md). */
+export type TemplateCategory = "code-review" | "bug-investigation" | "feature-implementation" | "testing" | "deployment-ops" | "integration" | "custom";
+/** A published entry in the sharing registry. */
+export interface RegistryEntry {
+    /** Unique identifier (generated on publish). */
+    id: string;
+    /** Type of shared resource. */
+    type: RegistryItemType;
+    /** Human-readable name (unique per type). */
+    name: string;
+    /** Current semver version string. */
+    version: string;
+    /** Short description for search results. */
+    description: string;
+    /** Author identifier. */
+    author: string;
+    /** Searchable tags. */
+    tags: string[];
+    /** Template category (only for type "template"). */
+    category?: TemplateCategory;
+    /** The resource content (YAML frontmatter + markdown for skills, prompt pattern for templates). */
+    content: string;
+    /** IDs of other registry entries this depends on. */
+    dependencies: string[];
+    /** Lifecycle status. */
+    status: RegistryItemStatus;
+    /** SHA-256 hex digest of content for integrity verification. */
+    checksum: string;
+    /** Download/install count. */
+    downloads: number;
+    /** ISO timestamp of first publish. */
+    publishedAt: string;
+    /** ISO timestamp of last update. */
+    updatedAt: string;
+}
+/** A version snapshot stored alongside the entry. */
+export interface RegistryVersion {
+    /** ID of the parent registry entry. */
+    entryId: string;
+    /** Semver version string. */
+    version: string;
+    /** Content at this version. */
+    content: string;
+    /** SHA-256 hex digest of content. */
+    checksum: string;
+    /** What changed in this version. */
+    changelog: string;
+    /** ISO timestamp. */
+    publishedAt: string;
+}
+/** Input for publishing a new entry or new version. */
+export interface PublishRequest {
+    type: RegistryItemType;
+    name: string;
+    version: string;
+    description: string;
+    author: string;
+    content: string;
+    tags?: string[];
+    category?: TemplateCategory;
+    dependencies?: string[];
+    changelog?: string;
+}
+/** Result of a publish operation. */
+export interface PublishResult {
+    ok: boolean;
+    entry?: RegistryEntry;
+    errors: string[];
+    warnings: string[];
+}
+/** Validation result for pre-publish checks. */
+export interface ValidationResult {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+}
+/** Search/filter query for the registry. */
+export interface RegistrySearchQuery {
+    /** Free-text search (matched against name, description, tags). */
+    query?: string;
+    /** Filter by resource type. */
+    type?: RegistryItemType;
+    /** Filter by template category. */
+    category?: TemplateCategory;
+    /** Filter by tags (all must match). */
+    tags?: string[];
+    /** Filter by author. */
+    author?: string;
+    /** Filter by status (default: published). */
+    status?: RegistryItemStatus;
+    /** Sort field. */
+    sortBy?: "name" | "publishedAt" | "downloads" | "relevance";
+    /** Sort direction. */
+    sortOrder?: "asc" | "desc";
+    /** Max results (default: 20). */
+    limit?: number;
+    /** Offset for pagination. */
+    offset?: number;
+}
+/** Paginated search results. */
+export interface RegistrySearchResult {
+    entries: RegistryEntry[];
+    total: number;
+    query: RegistrySearchQuery;
+}
+/** Input for installing a registry entry locally. */
+export interface InstallRequest {
+    /** Registry entry ID. */
+    entryId: string;
+    /** Specific version (latest if omitted). */
+    version?: string;
+    /** Override install directory. */
+    targetDir?: string;
+}
+/** Result of an install operation. */
+export interface InstallResult {
+    ok: boolean;
+    entry?: RegistryEntry;
+    installedPath?: string;
+    errors: string[];
+}
+/** Thrown on invalid status transitions. */
+export declare class RegistryStatusError extends Error {
+    readonly entryId: string;
+    readonly currentStatus: RegistryItemStatus;
+    readonly attemptedStatus: RegistryItemStatus;
+    constructor(entryId: string, currentStatus: RegistryItemStatus, attemptedStatus: RegistryItemStatus);
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/registry/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,6CAA6C;AAC7C,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG,OAAO,CAAC;AAEpD,4CAA4C;AAC5C,MAAM,MAAM,kBAAkB,GAC1B,OAAO,GACP,WAAW,GACX,YAAY,GACZ,WAAW,CAAC;AAEhB,gCAAgC;AAChC,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,kBAAkB,EAAE,kBAAkB,EAAE,CAK/E,CAAC;AAEF,kEAAkE;AAClE,MAAM,MAAM,gBAAgB,GACxB,aAAa,GACb,mBAAmB,GACnB,wBAAwB,GACxB,SAAS,GACT,gBAAgB,GAChB,aAAa,GACb,QAAQ,CAAC;AAMb,iDAAiD;AACjD,MAAM,WAAW,aAAa;IAC5B,gDAAgD;IAChD,EAAE,EAAE,MAAM,CAAC;IAEX,+BAA+B;IAC/B,IAAI,EAAE,gBAAgB,CAAC;IAEvB,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IAEb,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;IAEhB,4CAA4C;IAC5C,WAAW,EAAE,MAAM,CAAC;IAEpB,yBAAyB;IACzB,MAAM,EAAE,MAAM,CAAC;IAEf,uBAAuB;IACvB,IAAI,EAAE,MAAM,EAAE,CAAC;IAEf,oDAAoD;IACpD,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAE5B,mGAAmG;IACnG,OAAO,EAAE,MAAM,CAAC;IAEhB,qDAAqD;IACrD,YAAY,EAAE,MAAM,EAAE,CAAC;IAEvB,wBAAwB;IACxB,MAAM,EAAE,kBAAkB,CAAC;IAE3B,gEAAgE;IAChE,QAAQ,EAAE,MAAM,CAAC;IAEjB,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;IAElB,sCAAsC;IACtC,WAAW,EAAE,MAAM,CAAC;IAEpB,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qDAAqD;AACrD,MAAM,WAAW,eAAe;IAC9B,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAC;IAEhB,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;IAEhB,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAC;IAEhB,qCAAqC;IACrC,QAAQ,EAAE,MAAM,CAAC;IAEjB,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;IAElB,qBAAqB;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB;AAMD,uDAAuD;AACvD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,gBAAgB,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qCAAqC;AACrC,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,gDAAgD;AAChD,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,4CAA4C;AAC5C,MAAM,WAAW,mBAAmB;IAClC,kEAAkE;IAClE,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,+BAA+B;IAC/B,IAAI,CAAC,EAAE,gBAAgB,CAAC;IAExB,mCAAmC;IACnC,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAE5B,uCAAuC;IACvC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAEhB,wBAAwB;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,6CAA6C;IAC7C,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAE5B,kBAAkB;IAClB,MAAM,CAAC,EAAE,MAAM,GAAG,aAAa,GAAG,WAAW,GAAG,WAAW,CAAC;IAE5D,sBAAsB;IACtB,SAAS,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IAE3B,iCAAiC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,6BAA6B;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,gCAAgC;AAChC,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,mBAAmB,CAAC;CAC5B;AAED,qDAAqD;AACrD,MAAM,WAAW,cAAc;IAC7B,yBAAyB;IACzB,OAAO,EAAE,MAAM,CAAC;IAEhB,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,kCAAkC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,sCAAsC;AACtC,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAMD,4CAA4C;AAC5C,qBAAa,mBAAoB,SAAQ,KAAK;aAE1B,OAAO,EAAE,MAAM;aACf,aAAa,EAAE,kBAAkB;aACjC,eAAe,EAAE,kBAAkB;gBAFnC,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,kBAAkB,EACjC,eAAe,EAAE,kBAAkB;CAOtD"}

package/dist/core/registry/types.js

@@ -0,0 +1,30 @@
+/**
+ * Template & Skill Sharing Registry — Type definitions.
+ *
+ * Defines the data model for publishable, discoverable, and versionable
+ * resources (agent templates and skills) in the sharing registry.
+ */
+/** Valid status transitions. */
+export const STATUS_TRANSITIONS = {
+    draft: ["published", "withdrawn"],
+    published: ["deprecated", "withdrawn"],
+    deprecated: ["published", "withdrawn"], // can un-deprecate
+    withdrawn: [], // terminal
+};
+// ---------------------------------------------------------------------------
+// Error
+// ---------------------------------------------------------------------------
+/** Thrown on invalid status transitions. */
+export class RegistryStatusError extends Error {
+    entryId;
+    currentStatus;
+    attemptedStatus;
+    constructor(entryId, currentStatus, attemptedStatus) {
+        super(`Invalid registry status transition for "${entryId}": ${currentStatus} → ${attemptedStatus}`);
+        this.entryId = entryId;
+        this.currentStatus = currentStatus;
+        this.attemptedStatus = attemptedStatus;
+        this.name = "RegistryStatusError";
+    }
+}
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/registry/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAgBH,gCAAgC;AAChC,MAAM,CAAC,MAAM,kBAAkB,GAAqD;IAClF,KAAK,EAAE,CAAC,WAAW,EAAE,WAAW,CAAC;IACjC,SAAS,EAAE,CAAC,YAAY,EAAE,WAAW,CAAC;IACtC,UAAU,EAAE,CAAC,WAAW,EAAE,WAAW,CAAC,EAAE,mBAAmB;IAC3D,SAAS,EAAE,EAAE,EAA2B,WAAW;CACpD,CAAC;AAkLF,8EAA8E;AAC9E,QAAQ;AACR,8EAA8E;AAE9E,4CAA4C;AAC5C,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAE1B;IACA;IACA;IAHlB,YACkB,OAAe,EACf,aAAiC,EACjC,eAAmC;QAEnD,KAAK,CACH,2CAA2C,OAAO,MAAM,aAAa,MAAM,eAAe,EAAE,CAC7F,CAAC;QANc,YAAO,GAAP,OAAO,CAAQ;QACf,kBAAa,GAAb,aAAa,CAAoB;QACjC,oBAAe,GAAf,eAAe,CAAoB;QAKnD,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF"}

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

@@ -0,0 +1,56 @@
+/**
+ * Template & Skill Sharing Registry — Version management.
+ *
+ * Handles version listing, comparison, rollback, and compatibility checks
+ * for registry entries. Builds on the version records stored by RegistryStore.
+ */
+import type { RegistryEntry, RegistryVersion } from "./types.js";
+import type { RegistryStore } from "./store.js";
+/** Summary of an entry's version history. */
+export interface VersionHistory {
+    entryId: string;
+    currentVersion: string;
+    versions: VersionSummary[];
+}
+/** Minimal version info for listing. */
+export interface VersionSummary {
+    version: string;
+    changelog: string;
+    publishedAt: string;
+}
+/**
+ * Get the full version history for a registry entry.
+ */
+export declare function getVersionHistory(entry: RegistryEntry, store: RegistryStore): VersionHistory;
+/**
+ * Get the content of a specific version for an entry.
+ * Returns null if the version doesn't exist.
+ */
+export declare function getVersionContent(entryId: string, version: string, store: RegistryStore): string | null;
+/**
+ * Check if a specific version exists for an entry.
+ */
+export declare function hasVersion(entryId: string, version: string, store: RegistryStore): boolean;
+/**
+ * Get the latest version record for an entry.
+ */
+export declare function getLatestVersion(entryId: string, store: RegistryStore): RegistryVersion | null;
+/**
+ * Verify the integrity of a version's content against its checksum.
+ */
+export declare function verifyChecksum(version: RegistryVersion): boolean;
+/**
+ * Rollback an entry to a previous version.
+ * Updates the entry in-place and persists the change.
+ * Returns the rolled-back entry, or null if the version doesn't exist.
+ */
+export declare function rollbackToVersion(entryId: string, targetVersion: string, store: RegistryStore): Promise<RegistryEntry | null>;
+/**
+ * Check if an update is available by comparing a local version against the registry.
+ */
+export declare function isUpdateAvailable(localVersion: string, entry: RegistryEntry): boolean;
+/**
+ * List versions newer than a given version.
+ */
+export declare function getNewerVersions(entryId: string, sinceVersion: string, store: RegistryStore): VersionSummary[];
+//# sourceMappingURL=versions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"versions.d.ts","sourceRoot":"","sources":["../../../src/core/registry/versions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAOhD,6CAA6C;AAC7C,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,cAAc,EAAE,CAAC;CAC5B;AAED,wCAAwC;AACxC,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAMD;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,aAAa,EACpB,KAAK,EAAE,aAAa,GACnB,cAAc,CAWhB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,aAAa,GACnB,MAAM,GAAG,IAAI,CAGf;AAED;;GAEG;AACH,wBAAgB,UAAU,CACxB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,aAAa,GACnB,OAAO,CAET;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,aAAa,GACnB,eAAe,GAAG,IAAI,CAKxB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAEhE;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,aAAa,GACnB,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAqB/B;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,aAAa,GACnB,OAAO,CAET;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,aAAa,GACnB,cAAc,EAAE,CASlB"}