@skillbase/spm 0.1.0

package/dist/core/manifest.d.ts

@@ -0,0 +1,6 @@
+import type { SkillManifest } from "../types/index.js";
+export declare function getDefaultManifest(): SkillManifest;
+export declare function readManifest(cwd: string): Promise<SkillManifest | null>;
+export declare function writeManifest(cwd: string, manifest: SkillManifest): Promise<void>;
+export declare function addDependency(cwd: string, skillRef: string, version: string): Promise<void>;
+//# sourceMappingURL=manifest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/core/manifest.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,wBAAgB,kBAAkB,IAAI,aAAa,CAUlD;AAED,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAQ7E;AAED,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAGvF;AAED,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAIjG"}

package/dist/core/manifest.js

@@ -0,0 +1,33 @@
+import fs from "node:fs/promises";
+import { getManifestPath } from "./paths.js";
+export function getDefaultManifest() {
+    return {
+        schema_version: 1,
+        name: "my-project",
+        version: "1.0.0",
+        description: "Project skill bundle",
+        dependencies: {},
+        author: "",
+        license: "MIT",
+    };
+}
+export async function readManifest(cwd) {
+    const manifestPath = getManifestPath(cwd);
+    try {
+        const raw = await fs.readFile(manifestPath, "utf-8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+export async function writeManifest(cwd, manifest) {
+    const manifestPath = getManifestPath(cwd);
+    await fs.writeFile(manifestPath, JSON.stringify(manifest, null, 2) + "\n", "utf-8");
+}
+export async function addDependency(cwd, skillRef, version) {
+    const manifest = (await readManifest(cwd)) ?? getDefaultManifest();
+    manifest.dependencies[skillRef] = `^${version}`;
+    await writeManifest(cwd, manifest);
+}
+//# sourceMappingURL=manifest.js.map

package/dist/core/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../src/core/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAG7C,MAAM,UAAU,kBAAkB;IAChC,OAAO;QACL,cAAc,EAAE,CAAC;QACjB,IAAI,EAAE,YAAY;QAClB,OAAO,EAAE,OAAO;QAChB,WAAW,EAAE,sBAAsB;QACnC,YAAY,EAAE,EAAE;QAChB,MAAM,EAAE,EAAE;QACV,OAAO,EAAE,KAAK;KACf,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,GAAW;IAC5C,MAAM,YAAY,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;IAC1C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QACrD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAkB,CAAC;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,GAAW,EAAE,QAAuB;IACtE,MAAM,YAAY,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;IAC1C,MAAM,EAAE,CAAC,SAAS,CAAC,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;AACtF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,GAAW,EAAE,QAAgB,EAAE,OAAe;IAChF,MAAM,QAAQ,GAAG,CAAC,MAAM,YAAY,CAAC,GAAG,CAAC,CAAC,IAAI,kBAAkB,EAAE,CAAC;IACnE,QAAQ,CAAC,YAAY,CAAC,QAAQ,CAAC,GAAG,IAAI,OAAO,EAAE,CAAC;IAChD,MAAM,aAAa,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;AACrC,CAAC"}

package/dist/core/paths.d.ts

@@ -0,0 +1,8 @@
+export declare function getGlobalSkillsDir(): string;
+export declare function getProjectSkillsDir(cwd: string): string;
+export declare function getInstalledDir(skillsDir: string): string;
+export declare function getIndexPath(skillsDir: string): string;
+export declare function getFeedbackPath(skillsDir: string): string;
+export declare function getConfigPath(skillsDir: string): string;
+export declare function getManifestPath(cwd: string): string;
+//# sourceMappingURL=paths.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/core/paths.ts"],"names":[],"mappings":"AAUA,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEnD"}

package/dist/core/paths.js

@@ -0,0 +1,30 @@
+import path from "node:path";
+import os from "node:os";
+const SKILLS_DIR_NAME = ".skills";
+const INSTALLED_DIR = "installed";
+const INDEX_FILE = "index.json";
+const FEEDBACK_FILE = "feedback.json";
+const CONFIG_FILE = "config.json";
+const MANIFEST_FILE = "skill.json";
+export function getGlobalSkillsDir() {
+    return path.join(os.homedir(), SKILLS_DIR_NAME);
+}
+export function getProjectSkillsDir(cwd) {
+    return path.join(cwd, SKILLS_DIR_NAME);
+}
+export function getInstalledDir(skillsDir) {
+    return path.join(skillsDir, INSTALLED_DIR);
+}
+export function getIndexPath(skillsDir) {
+    return path.join(skillsDir, INDEX_FILE);
+}
+export function getFeedbackPath(skillsDir) {
+    return path.join(skillsDir, FEEDBACK_FILE);
+}
+export function getConfigPath(skillsDir) {
+    return path.join(skillsDir, CONFIG_FILE);
+}
+export function getManifestPath(cwd) {
+    return path.join(cwd, MANIFEST_FILE);
+}
+//# sourceMappingURL=paths.js.map

package/dist/core/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/core/paths.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,SAAS,CAAC;AAEzB,MAAM,eAAe,GAAG,SAAS,CAAC;AAClC,MAAM,aAAa,GAAG,WAAW,CAAC;AAClC,MAAM,UAAU,GAAG,YAAY,CAAC;AAChC,MAAM,aAAa,GAAG,eAAe,CAAC;AACtC,MAAM,WAAW,GAAG,aAAa,CAAC;AAClC,MAAM,aAAa,GAAG,YAAY,CAAC;AAEnC,MAAM,UAAU,kBAAkB;IAChC,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,eAAe,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,GAAW;IAC7C,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,SAAiB;IAC/C,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,SAAiB;IAC5C,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,SAAiB;IAC/C,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,SAAiB;IAC7C,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC;AACvC,CAAC"}

package/dist/core/plugins/index.d.ts

@@ -0,0 +1,8 @@
+import type { LoadContext } from "./types.js";
+export declare function initPlugins(): Promise<void>;
+/**
+ * Runs all onLoad hooks in sequence, piping content through each transformer.
+ */
+export declare function runLoadHooks(ctx: LoadContext): Promise<string>;
+export type { SkillBasePlugin, LoadContext, LoadHookResult, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/plugins/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/plugins/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,WAAW,EACZ,MAAM,YAAY,CAAC;AAOpB,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAOjD;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAcpE;AAGD,YAAY,EACV,eAAe,EACf,WAAW,EACX,cAAc,GACf,MAAM,YAAY,CAAC"}

package/dist/core/plugins/index.js

@@ -0,0 +1,30 @@
+import { loadPlugins } from "./loader.js";
+// ── Plugin Manager (singleton) ───────────────────────────────────────
+let plugins = [];
+export async function initPlugins() {
+    plugins = await loadPlugins();
+    for (const p of plugins) {
+        if (p.init) {
+            await p.init();
+        }
+    }
+}
+/**
+ * Runs all onLoad hooks in sequence, piping content through each transformer.
+ */
+export async function runLoadHooks(ctx) {
+    let { content } = ctx;
+    for (const p of plugins) {
+        if (!p.onLoad)
+            continue;
+        try {
+            const result = await p.onLoad({ ...ctx, content });
+            content = result.content;
+        }
+        catch (err) {
+            console.error(`[plugins] ${p.name}.onLoad error:`, err);
+        }
+    }
+    return content;
+}
+//# sourceMappingURL=index.js.map

package/dist/core/plugins/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/plugins/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,wEAAwE;AAExE,IAAI,OAAO,GAAsB,EAAE,CAAC;AAEpC,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,OAAO,GAAG,MAAM,WAAW,EAAE,CAAC;IAC9B,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;YACX,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;QACjB,CAAC;IACH,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,GAAgB;IACjD,IAAI,EAAE,OAAO,EAAE,GAAG,GAAG,CAAC;IAEtB,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,IAAI,CAAC,CAAC,CAAC,MAAM;YAAE,SAAS;QACxB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,MAAM,CAAC,EAAE,GAAG,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC;YACnD,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QAC3B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,IAAI,gBAAgB,EAAE,GAAG,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/core/plugins/loader.d.ts

@@ -0,0 +1,9 @@
+import type { SkillBasePlugin } from "./types.js";
+/**
+ * Scans the `plugins/` directory at the project root for plugin modules.
+ * Each subdirectory must export an `SkillBasePlugin` as default or named `plugin`.
+ *
+ * Plugins are optional — if the directory doesn't exist, returns empty array.
+ */
+export declare function loadPlugins(): Promise<SkillBasePlugin[]>;
+//# sourceMappingURL=loader.d.ts.map

package/dist/core/plugins/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../src/core/plugins/loader.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAQlD;;;;;GAKG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC,CAgD9D"}

package/dist/core/plugins/loader.js

@@ -0,0 +1,57 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import semver from "semver";
+import { createRequire } from "node:module";
+const require = createRequire(import.meta.url);
+const { version: skillbaseVersion } = require("../../../package.json");
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+/**
+ * Scans the `plugins/` directory at the project root for plugin modules.
+ * Each subdirectory must export an `SkillBasePlugin` as default or named `plugin`.
+ *
+ * Plugins are optional — if the directory doesn't exist, returns empty array.
+ */
+export async function loadPlugins() {
+    const plugins = [];
+    // plugins/ directory lives at project root (3 levels up from src/core/plugins/)
+    const pluginsDir = path.resolve(__dirname, "../../../plugins");
+    let entries;
+    try {
+        entries = await fs.readdir(pluginsDir);
+    }
+    catch {
+        // No plugins directory — that's fine
+        return plugins;
+    }
+    for (const entry of entries) {
+        const pluginDir = path.join(pluginsDir, entry);
+        const stat = await fs.stat(pluginDir).catch(() => null);
+        if (!stat?.isDirectory())
+            continue;
+        // Try to import the plugin's index
+        const indexPath = path.join(pluginDir, "index.js");
+        const indexExists = await fs.access(indexPath).then(() => true).catch(() => false);
+        if (!indexExists)
+            continue;
+        try {
+            const mod = await import(indexPath);
+            const plugin = mod.default ?? mod.plugin;
+            if (!plugin?.name) {
+                console.warn(`[plugins] Skipping ${entry}: no valid plugin export found`);
+                continue;
+            }
+            if (plugin.compatibility && !semver.satisfies(skillbaseVersion, plugin.compatibility)) {
+                console.warn(`[plugins] Skipping ${plugin.name}: requires skillbase ${plugin.compatibility}, current ${skillbaseVersion}`);
+                continue;
+            }
+            plugins.push(plugin);
+            console.log(`[plugins] Loaded: ${plugin.name}`);
+        }
+        catch (err) {
+            console.warn(`[plugins] Failed to load ${entry}:`, err instanceof Error ? err.message : err);
+        }
+    }
+    return plugins;
+}
+//# sourceMappingURL=loader.js.map

package/dist/core/plugins/loader.js.map

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

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

@@ -0,0 +1,79 @@
+export interface ScanDetail {
+    pattern: string;
+    line: number;
+    snippet: string;
+}
+export interface ScanResult {
+    score: number;
+    status: "clean" | "flagged" | "blocked";
+    flags: string[];
+    details: ScanDetail[];
+}
+export interface PublishContext {
+    content: string;
+    manifest: Record<string, unknown>;
+    permissions: string[];
+    authorName: string;
+}
+export interface LoadContext {
+    content: string;
+    name: string;
+    version: string;
+    permissions: string[];
+}
+export interface PluginFeedbackContext {
+    skillName: string;
+    result: string;
+    type: string;
+    rating?: number;
+    comment?: string;
+}
+export interface PublishHookResult {
+    /** If "blocked", publish is rejected with 403. */
+    action: "allow" | "flag" | "block";
+    scan?: ScanResult;
+    /** Data to upsert into the plugin's own table (keyed by skill_id). */
+    tableData?: Record<string, unknown>;
+}
+export interface LoadHookResult {
+    /** Transformed content (e.g. with spotlighting delimiters). */
+    content: string;
+}
+export interface PluginTableColumn {
+    /** Column name in the plugin table. */
+    name: string;
+    /** SQL type. */
+    type: "text" | "real" | "integer" | "jsonb";
+    /** Value returned in API when the plugin is not loaded or row doesn't exist. */
+    fallback: unknown;
+}
+export interface PluginTable {
+    /** Table name (e.g. "skill_safety"). Must be globally unique. */
+    name: string;
+    /** Columns to expose in skill API responses (excluding skill_id). */
+    columns: PluginTableColumn[];
+}
+export interface SkillBasePlugin {
+    /** Unique plugin name. */
+    name: string;
+    /** Semver range of skillbase versions this plugin is compatible with (e.g. ">=0.1.0"). */
+    compatibility?: string;
+    /**
+     * Declares a plugin-owned table joined to skills via skill_id.
+     * The framework handles LEFT JOIN in queries and UPSERT on publish.
+     */
+    table?(): PluginTable;
+    /** SQL migrations to run on startup. Each string is an idempotent SQL statement. */
+    migrations?(ctx: {
+        tableName: string;
+    }): string[];
+    /** Called once during server startup (after migrations). */
+    init?(): Promise<void>;
+    /** Called when a skill is published. Can block or flag the publish. */
+    onPublish?(ctx: PublishContext): Promise<PublishHookResult>;
+    /** Called when a skill is loaded into an agent. Can transform content. */
+    onLoad?(ctx: LoadContext): Promise<LoadHookResult>;
+    /** Called when feedback is recorded. */
+    onFeedback?(ctx: PluginFeedbackContext): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/plugins/types.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;IACxC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,UAAU,EAAE,CAAC;CACvB;AAID,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAID,MAAM,WAAW,iBAAiB;IAChC,kDAAkD;IAClD,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;IACnC,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED,MAAM,WAAW,cAAc;IAC7B,+DAA+D;IAC/D,OAAO,EAAE,MAAM,CAAC;CACjB;AAID,MAAM,WAAW,iBAAiB;IAChC,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB;IAChB,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;IAC5C,gFAAgF;IAChF,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,iEAAiE;IACjE,IAAI,EAAE,MAAM,CAAC;IACb,qEAAqE;IACrE,OAAO,EAAE,iBAAiB,EAAE,CAAC;CAC9B;AAID,MAAM,WAAW,eAAe;IAC9B,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IAEb,0FAA0F;IAC1F,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;OAGG;IACH,KAAK,CAAC,IAAI,WAAW,CAAC;IAEtB,oFAAoF;IACpF,UAAU,CAAC,CAAC,GAAG,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,EAAE,CAAC;IAElD,4DAA4D;IAC5D,IAAI,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvB,uEAAuE;IACvE,SAAS,CAAC,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAE5D,0EAA0E;IAC1E,MAAM,CAAC,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAEnD,wCAAwC;IACxC,UAAU,CAAC,CAAC,GAAG,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACxD"}

package/dist/core/plugins/types.js

@@ -0,0 +1,3 @@
+// ── Scan result (plugin-defined, no internal imports) ────────────────
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/plugins/types.ts"],"names":[],"mappings":"AAAA,wEAAwE"}

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

@@ -0,0 +1,80 @@
+import type { SkillsConfig, RemoteSkillEntry, RegistrySearchResult, SkillManifest } from "../types/index.js";
+export interface PublishResult {
+    published: boolean;
+    name: string;
+    version: string;
+    updated: boolean;
+    size?: number;
+}
+export interface DownloadResult {
+    name: string;
+    version: string;
+    manifest: Record<string, unknown>;
+    integrity: string | null;
+    tokens_estimate: number;
+    download_url: string;
+}
+export declare class RegistryClient {
+    private readonly url;
+    private readonly token?;
+    constructor(url: string, token?: string | undefined);
+    private headers;
+    private skillUrl;
+    search(query?: string, tag?: string, page?: number): Promise<RegistrySearchResult>;
+    getSkill(author: string, name: string): Promise<RemoteSkillEntry | null>;
+    getContent(author: string, name: string, version?: string): Promise<{
+        name: string;
+        version: string;
+        content: string;
+        manifest: SkillManifest;
+        integrity: string;
+        tokens_estimate: number;
+    }>;
+    publish(body: {
+        manifest: SkillManifest;
+        content: string;
+        compact_content?: string;
+        source?: {
+            type: "github";
+            url: string;
+            ref?: string;
+            path?: string;
+        };
+    }): Promise<PublishResult>;
+    publishWithArchive(metadata: {
+        manifest: SkillManifest;
+        content: string;
+        compact_content?: string;
+    }, archive: Buffer): Promise<PublishResult>;
+    getDownloadUrl(author: string, name: string, version?: string): Promise<DownloadResult>;
+    getVersions(author: string, name: string): Promise<{
+        version: string;
+        created_at: string;
+    }[]>;
+    startDeviceAuth(): Promise<{
+        session_id: string;
+        user_code: string;
+        verification_uri: string;
+        interval: number;
+    }>;
+    pollDeviceAuth(sessionId: string): Promise<{
+        status: string;
+        interval?: number;
+        author?: {
+            id: number;
+            name: string;
+        };
+        token?: string;
+    }>;
+    register(name: string, githubUsername?: string): Promise<{
+        author: {
+            id: number;
+            name: string;
+        };
+        token: string;
+    }>;
+    sendFeedback(author: string, skillName: string, result: string, comment?: string): Promise<void>;
+}
+export declare function createRegistryClients(config: SkillsConfig): Map<string, RegistryClient>;
+export declare function getClientForSkill(config: SkillsConfig, _skillRef: string): RegistryClient | null;
+//# sourceMappingURL=registry-client.d.ts.map

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

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

package/dist/core/registry-client.js

@@ -0,0 +1,166 @@
+export class RegistryClient {
+    url;
+    token;
+    constructor(url, token) {
+        this.url = url;
+        this.token = token;
+    }
+    headers() {
+        const h = { "Content-Type": "application/json" };
+        if (this.token)
+            h["Authorization"] = `Bearer ${this.token}`;
+        return h;
+    }
+    skillUrl(author, name) {
+        return `${this.url}/api/skills/${author}/${name}`;
+    }
+    async search(query, tag, page = 1) {
+        const params = new URLSearchParams();
+        if (query)
+            params.set("q", query);
+        if (tag)
+            params.set("tag", tag);
+        params.set("page", String(page));
+        const res = await fetch(`${this.url}/api/skills/search?${params}`, {
+            headers: this.headers(),
+        });
+        if (!res.ok)
+            throw new Error(`Registry search failed: ${res.status} ${res.statusText}`);
+        return (await res.json());
+    }
+    async getSkill(author, name) {
+        const res = await fetch(this.skillUrl(author, name), {
+            headers: this.headers(),
+        });
+        if (res.status === 404)
+            return null;
+        if (!res.ok)
+            throw new Error(`Registry request failed: ${res.status}`);
+        return (await res.json());
+    }
+    async getContent(author, name, version) {
+        const params = new URLSearchParams();
+        if (version)
+            params.set("version", version);
+        const res = await fetch(`${this.skillUrl(author, name)}/content?${params}`, { headers: this.headers() });
+        if (!res.ok)
+            throw new Error(`Failed to fetch skill content: ${res.status}`);
+        return (await res.json());
+    }
+    async publish(body) {
+        const res = await fetch(`${this.url}/api/skills`, {
+            method: "POST",
+            headers: this.headers(),
+            body: JSON.stringify(body),
+        });
+        if (!res.ok) {
+            const err = await res.json().catch(() => ({}));
+            throw new Error(`Publish failed: ${res.status} ${err.error ?? res.statusText}`);
+        }
+        return (await res.json());
+    }
+    async publishWithArchive(metadata, archive) {
+        const formData = new FormData();
+        formData.append("metadata", JSON.stringify(metadata));
+        formData.append("archive", new Blob([archive]), "skill.tar.gz");
+        const headers = {};
+        if (this.token)
+            headers["Authorization"] = `Bearer ${this.token}`;
+        const res = await fetch(`${this.url}/api/skills`, {
+            method: "POST",
+            headers,
+            body: formData,
+        });
+        if (!res.ok) {
+            const err = await res.json().catch(() => ({}));
+            throw new Error(`Publish failed: ${res.status} ${err.error ?? res.statusText}`);
+        }
+        return (await res.json());
+    }
+    async getDownloadUrl(author, name, version) {
+        const params = new URLSearchParams();
+        if (version)
+            params.set("version", version);
+        const res = await fetch(`${this.skillUrl(author, name)}/download?${params}`, { headers: this.headers() });
+        if (!res.ok)
+            throw new Error(`Failed to get download URL: ${res.status}`);
+        return (await res.json());
+    }
+    async getVersions(author, name) {
+        const res = await fetch(`${this.skillUrl(author, name)}/versions`, { headers: this.headers() });
+        if (res.status === 404)
+            return [];
+        if (!res.ok)
+            throw new Error(`Failed to fetch versions: ${res.status}`);
+        const data = (await res.json());
+        return data.versions;
+    }
+    async startDeviceAuth() {
+        const res = await fetch(`${this.url}/auth/github/device`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({}),
+        });
+        if (!res.ok) {
+            const err = await res.json().catch(() => ({}));
+            throw new Error(`GitHub auth failed: ${err.error ?? res.statusText}`);
+        }
+        return (await res.json());
+    }
+    async pollDeviceAuth(sessionId) {
+        const res = await fetch(`${this.url}/auth/github/device/poll`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({ session_id: sessionId }),
+        });
+        if (res.status === 410) {
+            throw new Error("Session expired. Please try again.");
+        }
+        if (res.status === 404) {
+            throw new Error("Session not found. Please try again.");
+        }
+        if (!res.ok) {
+            const err = await res.json().catch(() => ({}));
+            throw new Error(`Poll failed: ${err.error ?? res.statusText}`);
+        }
+        return (await res.json());
+    }
+    async register(name, githubUsername) {
+        const res = await fetch(`${this.url}/api/auth/register`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({ name, github_username: githubUsername }),
+        });
+        if (!res.ok) {
+            const err = await res.json().catch(() => ({}));
+            throw new Error(`Registration failed: ${err.error ?? res.statusText}`);
+        }
+        return (await res.json());
+    }
+    async sendFeedback(author, skillName, result, comment) {
+        const res = await fetch(`${this.skillUrl(author, skillName)}/feedback`, {
+            method: "POST",
+            headers: this.headers(),
+            body: JSON.stringify({ result, comment }),
+        });
+        if (!res.ok)
+            throw new Error(`Feedback failed: ${res.status}`);
+    }
+}
+export function createRegistryClients(config) {
+    const clients = new Map();
+    for (const reg of config.registries) {
+        clients.set(reg.name, new RegistryClient(reg.url, reg.token));
+    }
+    return clients;
+}
+export function getClientForSkill(config, _skillRef) {
+    const registryName = config.scopes["*"];
+    if (!registryName)
+        return null;
+    const reg = config.registries.find((r) => r.name === registryName);
+    if (!reg)
+        return null;
+    return new RegistryClient(reg.url, reg.token);
+}
+//# sourceMappingURL=registry-client.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry-client.js","sourceRoot":"","sources":["../../src/core/registry-client.ts"],"names":[],"mappings":"AA0BA,MAAM,OAAO,cAAc;IAEN;IACA;IAFnB,YACmB,GAAW,EACX,KAAc;QADd,QAAG,GAAH,GAAG,CAAQ;QACX,UAAK,GAAL,KAAK,CAAS;IAC9B,CAAC;IAEI,OAAO;QACb,MAAM,CAAC,GAA2B,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC;QACzE,IAAI,IAAI,CAAC,KAAK;YAAE,CAAC,CAAC,eAAe,CAAC,GAAG,UAAU,IAAI,CAAC,KAAK,EAAE,CAAC;QAC5D,OAAO,CAAC,CAAC;IACX,CAAC;IAEO,QAAQ,CAAC,MAAc,EAAE,IAAY;QAC3C,OAAO,GAAG,IAAI,CAAC,GAAG,eAAe,MAAM,IAAI,IAAI,EAAE,CAAC;IACpD,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAAc,EAAE,GAAY,EAAE,IAAI,GAAG,CAAC;QACjD,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;QACrC,IAAI,KAAK;YAAE,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAClC,IAAI,GAAG;YAAE,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAChC,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;QAEjC,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,GAAG,sBAAsB,MAAM,EAAE,EAAE;YACjE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE;SACxB,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC;QACxF,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAyB,CAAC;IACpD,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,MAAc,EAAE,IAAY;QACzC,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE;YACnD,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE;SACxB,CAAC,CAAC;QACH,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG;YAAE,OAAO,IAAI,CAAC;QACpC,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;QACvE,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAqB,CAAC;IAChD,CAAC;IAED,KAAK,CAAC,UAAU,CACd,MAAc,EACd,IAAY,EACZ,OAAgB;QAShB,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;QACrC,IAAI,OAAO;YAAE,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAE5C,MAAM,GAAG,GAAG,MAAM,KAAK,CACrB,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,YAAY,MAAM,EAAE,EAClD,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,CAC5B,CAAC;QACF,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;QAC7E,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAOvB,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,IAKb;QACC,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,GAAG,aAAa,EAAE;YAChD,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE;YACvB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;SAC3B,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAC/C,MAAM,IAAI,KAAK,CACb,mBAAmB,GAAG,CAAC,MAAM,IAAK,GAA0B,CAAC,KAAK,IAAI,GAAG,CAAC,UAAU,EAAE,CACvF,CAAC;QACJ,CAAC;QACD,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAkB,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,kBAAkB,CAAC,QAIxB,EAAE,OAAe;QAChB,MAAM,QAAQ,GAAG,IAAI,QAAQ,EAAE,CAAC;QAChC,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;QACtD,QAAQ,CAAC,MAAM,CACb,SAAS,EACT,IAAI,IAAI,CAAC,CAAC,OAAiC,CAAC,CAAC,EAC7C,cAAc,CACf,CAAC;QAEF,MAAM,OAAO,GAA2B,EAAE,CAAC;QAC3C,IAAI,IAAI,CAAC,KAAK;YAAE,OAAO,CAAC,eAAe,CAAC,GAAG,UAAU,IAAI,CAAC,KAAK,EAAE,CAAC;QAElE,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,GAAG,aAAa,EAAE;YAChD,MAAM,EAAE,MAAM;YACd,OAAO;YACP,IAAI,EAAE,QAAQ;SACf,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAC/C,MAAM,IAAI,KAAK,CACb,mBAAmB,GAAG,CAAC,MAAM,IAAK,GAA0B,CAAC,KAAK,IAAI,GAAG,CAAC,UAAU,EAAE,CACvF,CAAC;QACJ,CAAC;QACD,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAkB,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,cAAc,CAClB,MAAc,EACd,IAAY,EACZ,OAAgB;QAEhB,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;QACrC,IAAI,OAAO;YAAE,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAE5C,MAAM,GAAG,GAAG,MAAM,KAAK,CACrB,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,aAAa,MAAM,EAAE,EACnD,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,CAC5B,CAAC;QACF,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;QAC1E,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAmB,CAAC;IAC9C,CAAC;IAED,KAAK,CAAC,WAAW,CACf,MAAc,EACd,IAAY;QAEZ,MAAM,GAAG,GAAG,MAAM,KAAK,CACrB,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,WAAW,EACzC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,CAC5B,CAAC;QACF,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG;YAAE,OAAO,EAAE,CAAC;QAClC,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;QACxE,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAG7B,CAAC;QACF,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,eAAe;QAMnB,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,GAAG,qBAAqB,EAAE;YACxD,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;SACzB,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAC/C,MAAM,IAAI,KAAK,CACb,uBAAwB,GAA0B,CAAC,KAAK,IAAI,GAAG,CAAC,UAAU,EAAE,CAC7E,CAAC;QACJ,CAAC;QACD,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAKvB,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,SAAiB;QAMpC,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,GAAG,0BAA0B,EAAE;YAC7D,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC;SAChD,CAAC,CAAC;QACH,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;QACxD,CAAC;QACD,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC1D,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAC/C,MAAM,IAAI,KAAK,CACb,gBAAiB,GAA0B,CAAC,KAAK,IAAI,GAAG,CAAC,UAAU,EAAE,CACtE,CAAC;QACJ,CAAC;QACD,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAKvB,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,QAAQ,CACZ,IAAY,EACZ,cAAuB;QAEvB,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,GAAG,oBAAoB,EAAE;YACvD,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,cAAc,EAAE,CAAC;SAChE,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAC/C,MAAM,IAAI,KAAK,CAAC,wBAAyB,GAA0B,CAAC,KAAK,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC;QACjG,CAAC;QACD,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAA4D,CAAC;IACvF,CAAC;IAED,KAAK,CAAC,YAAY,CAChB,MAAc,EACd,SAAiB,EACjB,MAAc,EACd,OAAgB;QAEhB,MAAM,GAAG,GAAG,MAAM,KAAK,CACrB,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,WAAW,EAC9C;YACE,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE;YACvB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;SAC1C,CACF,CAAC;QACF,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;IACjE,CAAC;CACF;AAED,MAAM,UAAU,qBAAqB,CAAC,MAAoB;IACxD,MAAM,OAAO,GAAG,IAAI,GAAG,EAA0B,CAAC;IAClD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;QACpC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,cAAc,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;IAChE,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,MAAoB,EACpB,SAAiB;IAEjB,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACxC,IAAI,CAAC,YAAY;QAAE,OAAO,IAAI,CAAC;IAE/B,MAAM,GAAG,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC;IACnE,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IAEtB,OAAO,IAAI,cAAc,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC;AAChD,CAAC"}

package/dist/core/registry.d.ts

@@ -0,0 +1,11 @@
+import type { SkillIndex, IndexSkillEntry } from "../types/index.js";
+export interface RegistryOptions {
+    cwd?: string;
+}
+/**
+ * Reads and merges skill indexes from project-level and global directories.
+ * Project skills override global ones by name.
+ */
+export declare function getSkillIndex(options?: RegistryOptions): Promise<SkillIndex>;
+export declare function findSkill(index: SkillIndex, name: string): IndexSkillEntry | undefined;
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/core/registry.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAYrE,MAAM,WAAW,eAAe;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAAC,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,UAAU,CAAC,CA4BtF;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAEtF"}

package/dist/core/registry.js

@@ -0,0 +1,44 @@
+import fs from "node:fs/promises";
+import { getGlobalSkillsDir, getProjectSkillsDir, getIndexPath } from "./paths.js";
+async function readIndex(skillsDir) {
+    const indexPath = getIndexPath(skillsDir);
+    try {
+        const raw = await fs.readFile(indexPath, "utf-8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Reads and merges skill indexes from project-level and global directories.
+ * Project skills override global ones by name.
+ */
+export async function getSkillIndex(options = {}) {
+    const cwd = options.cwd ?? process.cwd();
+    const globalDir = getGlobalSkillsDir();
+    const projectDir = getProjectSkillsDir(cwd);
+    const [globalIndex, projectIndex] = await Promise.all([
+        readIndex(globalDir),
+        readIndex(projectDir),
+    ]);
+    const skillMap = new Map();
+    // Global first — project overrides
+    if (globalIndex) {
+        for (const skill of globalIndex.skills) {
+            skillMap.set(skill.name, skill);
+        }
+    }
+    if (projectIndex) {
+        for (const skill of projectIndex.skills) {
+            skillMap.set(skill.name, skill);
+        }
+    }
+    const skills = Array.from(skillMap.values());
+    skills.sort((a, b) => b.priority - a.priority);
+    return { version: "1.0.0", skills };
+}
+export function findSkill(index, name) {
+    return index.skills.find((s) => s.name === name);
+}
+//# sourceMappingURL=registry.js.map