@g3nomaly/skills 0.3.0 → 1.0.0

package/dist/registry/loadPackageRegistry.js

@@ -0,0 +1,59 @@
+// packages/skills/src/registry/loadPackageRegistry.ts
+import fs from "node:fs";
+import path from "node:path";
+import { z } from "zod";
+import { createRegistryStore, register } from "@g3nomaly/core/registry";
+import { readSkillDir } from "./readSkillDir";
+const PLUGIN_MANIFEST = path.join(".claude-plugin", "plugin.json");
+/** Folder inside every group that holds its skill directories. */
+const SKILLS_DIR = "skills";
+/** `plugins/` directory shipped beside this module, from `src/` and `dist/` alike. */
+export function resolvePluginsRoot() {
+    return path.join(import.meta.dir, "..", "plugins");
+}
+const PluginManifestSchema = z.object({
+    name: z.string().min(1),
+    version: z.string().optional(),
+    skills: z.array(z.string().min(1)).default([]),
+});
+/** Group plugin roots: every direct child of `plugins/` holding a `plugin.json`. */
+export function listGroups(pluginsRoot = resolvePluginsRoot()) {
+    return fs.readdirSync(pluginsRoot, { withFileTypes: true })
+        .filter((d) => d.isDirectory() && fs.existsSync(path.join(pluginsRoot, d.name, PLUGIN_MANIFEST)))
+        .map((d) => d.name)
+        .sort();
+}
+/**
+ * Scans every group plugin root under `plugins/` and hydrates a store keyed by
+ * skill directory name. Run fresh on each CLI invocation; no build step.
+ */
+export async function loadPackageRegistry(pluginsRoot = resolvePluginsRoot()) {
+    const store = createRegistryStore();
+    for (const group of listGroups(pluginsRoot)) {
+        const groupDir = path.join(pluginsRoot, group);
+        const manifest = PluginManifestSchema.parse(JSON.parse(fs.readFileSync(path.join(groupDir, PLUGIN_MANIFEST), "utf8")));
+        for (const skillRel of manifest.skills) {
+            if (path.dirname(path.normalize(skillRel)) !== SKILLS_DIR) {
+                throw new Error(`group "${group}" lists skill "${skillRel}", which is not directly under ${SKILLS_DIR}/`);
+            }
+            const [key, meta] = await readSkillDir(path.join(groupDir, skillRel), group, manifest.version);
+            if (store.store.state[key]) {
+                throw new Error(`skill "${key}" is defined by more than one group (${store.store.state[key].group}, ${group})`);
+            }
+            register(store, key, meta);
+        }
+    }
+    for (const [key, meta] of Object.entries(store.store.state)) {
+        for (const dep of meta.registryDependencies ?? []) {
+            if (!store.store.state[dep]) {
+                throw new Error(`skill "${key}" depends on "${dep}", which no group defines`);
+            }
+        }
+    }
+    return store;
+}
+/** Absolute source path of a registry file; `filePath` is `<skill>/...`, sources live under `<group>/skills/`. */
+export function resolveSkillSourcePath(group, filePath, pluginsRoot = resolvePluginsRoot()) {
+    return path.join(pluginsRoot, group, SKILLS_DIR, filePath);
+}
+//# sourceMappingURL=loadPackageRegistry.js.map

package/dist/registry/loadPackageRegistry.js.map

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

package/dist/registry/readSkillDir.d.ts

@@ -0,0 +1,12 @@
+import type { SkillMeta } from "./types";
+export declare const SKILL_FILE = "SKILL.md";
+/**
+ * Reads one skill directory into its registry entry; the key is the directory
+ * name and every file below it becomes a `files[]` entry at `<key>/<file>`.
+ * Used by `loadPackageRegistry` for shipped skills and by the remote registry
+ * for cloned repositories.
+ *
+ * @throws when the directory holds no SKILL.md or its frontmatter is invalid
+ */
+export declare function readSkillDir(skillDir: string, group: string, version?: string): Promise<[string, SkillMeta]>;
+//# sourceMappingURL=readSkillDir.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"readSkillDir.d.ts","sourceRoot":"","sources":["../../src/registry/readSkillDir.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAA4B,SAAS,EAAE,MAAM,SAAS,CAAC;AAEnE,eAAO,MAAM,UAAU,aAAa,CAAC;AAsBrC;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CA0BlH"}

package/dist/registry/readSkillDir.js

@@ -0,0 +1,59 @@
+// packages/skills/src/registry/readSkillDir.ts
+import fs from "node:fs";
+import path from "node:path";
+import { z } from "zod";
+import { hashFile } from "@g3nomaly/core/hash";
+import { readFrontmatter } from "../filetree/frontmatter";
+export const SKILL_FILE = "SKILL.md";
+const SkillFrontmatterSchema = z.object({
+    name: z.string().min(1),
+    description: z.string().optional(),
+    /** Registry keys (skill directory names) of skills this one references */
+    registryDependencies: z.array(z.string().min(1)).optional(),
+});
+function fileType(relativeToSkill) {
+    if (relativeToSkill === SKILL_FILE)
+        return "skill";
+    if (relativeToSkill.startsWith(`agents${path.sep}`))
+        return "agent";
+    return "reference";
+}
+function walk(dir, base = dir) {
+    return fs.readdirSync(dir, { withFileTypes: true }).flatMap((d) => {
+        const full = path.join(dir, d.name);
+        return d.isDirectory() ? walk(full, base) : [path.relative(base, full)];
+    });
+}
+/**
+ * Reads one skill directory into its registry entry; the key is the directory
+ * name and every file below it becomes a `files[]` entry at `<key>/<file>`.
+ * Used by `loadPackageRegistry` for shipped skills and by the remote registry
+ * for cloned repositories.
+ *
+ * @throws when the directory holds no SKILL.md or its frontmatter is invalid
+ */
+export async function readSkillDir(skillDir, group, version) {
+    const skillMd = path.join(skillDir, SKILL_FILE);
+    if (!fs.existsSync(skillMd)) {
+        throw new Error(`${skillDir} holds no ${SKILL_FILE}`);
+    }
+    const key = path.basename(skillDir);
+    const frontmatter = SkillFrontmatterSchema.parse(await readFrontmatter(skillMd));
+    const files = [];
+    for (const rel of walk(skillDir).sort()) {
+        files.push({
+            path: path.join(key, rel),
+            type: fileType(rel),
+            hash: await hashFile(path.join(skillDir, rel)),
+        });
+    }
+    return [key, {
+            name: frontmatter.name,
+            description: frontmatter.description,
+            version,
+            group,
+            registryDependencies: frontmatter.registryDependencies,
+            files,
+        }];
+}
+//# sourceMappingURL=readSkillDir.js.map

package/dist/registry/readSkillDir.js.map

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

package/dist/registry/types.d.ts

@@ -0,0 +1,53 @@
+import { z } from "zod";
+export declare const SkillFileTypeSchema: z.ZodEnum<{
+    agent: "agent";
+    reference: "reference";
+    skill: "skill";
+}>;
+export type SkillFileType = z.infer<typeof SkillFileTypeSchema>;
+export declare const SkillFileSchema: z.ZodObject<{
+    path: z.ZodString;
+    type: z.ZodEnum<{
+        agent: "agent";
+        reference: "reference";
+        skill: "skill";
+    }>;
+    hash: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type SkillFile = z.infer<typeof SkillFileSchema>;
+/** Where a remote-installed skill came from; absent on skills shipped in the package. */
+export declare const SkillSourceSchema: z.ZodObject<{
+    remote: z.ZodString;
+    commit: z.ZodString;
+    dir: z.ZodString;
+}, z.core.$strip>;
+export type SkillSource = z.infer<typeof SkillSourceSchema>;
+/**
+ * One installable skill. Built from a group's `plugin.json` plus the skill's
+ * `SKILL.md` frontmatter by `loadPackageRegistry`, and written per install
+ * into `skills.json` by the `add` and `update` commands.
+ */
+export declare const SkillMetaSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    version: z.ZodOptional<z.ZodString>;
+    group: z.ZodString;
+    registryDependencies: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    source: z.ZodOptional<z.ZodObject<{
+        remote: z.ZodString;
+        commit: z.ZodString;
+        dir: z.ZodString;
+    }, z.core.$strip>>;
+    files: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        type: z.ZodEnum<{
+            agent: "agent";
+            reference: "reference";
+            skill: "skill";
+        }>;
+        hash: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type SkillMeta = z.infer<typeof SkillMetaSchema>;
+export type SkillRegistry = Record<string, SkillMeta>;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/registry/types.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,mBAAmB;;;;EAA0C,CAAC;AAE3E,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,eAAO,MAAM,eAAe;;;;;;;;iBAK1B,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD,yFAAyF;AACzF,eAAO,MAAM,iBAAiB;;;;iBAO5B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D;;;;GAIG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;iBAU1B,CAAC;AAEH,MAAM,MAAM,SAAS,GAAO,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAC5D,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC"}

package/dist/registry/types.js

@@ -0,0 +1,35 @@
+// packages/skills/src/registry/types.ts
+import { z } from "zod";
+export const SkillFileTypeSchema = z.enum(["skill", "agent", "reference"]);
+export const SkillFileSchema = z.object({
+    /** Relative to the install directory, e.g. `emphasise/SKILL.md`; the source adds the group: `<group>/<path>` */
+    path: z.string().min(1),
+    type: SkillFileTypeSchema,
+    hash: z.string().optional(),
+});
+/** Where a remote-installed skill came from; absent on skills shipped in the package. */
+export const SkillSourceSchema = z.object({
+    /** Git URL the skill was installed from */
+    remote: z.string().min(1),
+    /** Commit the clone resolved to at install time */
+    commit: z.string().min(1),
+    /** Repo-relative directory holding the skill directory, so `<dir>/<files[].path>` is the source file */
+    dir: z.string(),
+});
+/**
+ * One installable skill. Built from a group's `plugin.json` plus the skill's
+ * `SKILL.md` frontmatter by `loadPackageRegistry`, and written per install
+ * into `skills.json` by the `add` and `update` commands.
+ */
+export const SkillMetaSchema = z.object({
+    name: z.string().min(1),
+    description: z.string().optional(),
+    version: z.string().optional(),
+    /** Plugin root the skill ships in, e.g. `speech` */
+    group: z.string().min(1),
+    /** Registry keys (skill directory names) this skill needs installed alongside it */
+    registryDependencies: z.array(z.string().min(1)).optional(),
+    source: SkillSourceSchema.optional(),
+    files: z.array(SkillFileSchema).min(1),
+});
+//# sourceMappingURL=types.js.map

package/dist/registry/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/registry/types.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC;AAI3E,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,gHAAgH;IAChH,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,IAAI,EAAE,mBAAmB;IACzB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC5B,CAAC,CAAC;AAIH,yFAAyF;AACzF,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,2CAA2C;IAC3C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACzB,mDAAmD;IACnD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACzB,wGAAwG;IACxG,GAAG,EAAK,CAAC,CAAC,MAAM,EAAE;CACnB,CAAC,CAAC;AAIH;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,IAAI,EAAS,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,OAAO,EAAM,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,oDAAoD;IACpD,KAAK,EAAQ,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,oFAAoF;IACpF,oBAAoB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC3D,MAAM,EAAO,iBAAiB,CAAC,QAAQ,EAAE;IACzC,KAAK,EAAQ,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;CAC7C,CAAC,CAAC"}

package/dist/registry/userManifest.d.ts

@@ -0,0 +1,7 @@
+import type { RegistryStore } from "@g3nomaly/core/registry";
+/** `skills.json` sits beside the install directory: `.claude/skills` → `.claude/skills.json`. */
+export declare function manifestPath(projectRoot: string, installDir: string): string;
+/** Store bound to one target's `skills.json`, hydrated when the file exists. */
+export declare function loadUserManifest(projectRoot: string, installDir: string): Promise<RegistryStore>;
+export declare function saveUserManifest(store: RegistryStore): void;
+//# sourceMappingURL=userManifest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"userManifest.d.ts","sourceRoot":"","sources":["../../src/registry/userManifest.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAI7D,iGAAiG;AACjG,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAE5E;AAED,gFAAgF;AAChF,wBAAsB,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAItG;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CAG3D"}

package/dist/registry/userManifest.js

@@ -0,0 +1,21 @@
+// packages/skills/src/registry/userManifest.ts
+import fs from "node:fs";
+import path from "node:path";
+import { createRegistryStore, load, flush, jsonHandler } from "@g3nomaly/core/registry";
+const MANIFEST_FILE = "skills.json";
+/** `skills.json` sits beside the install directory: `.claude/skills` → `.claude/skills.json`. */
+export function manifestPath(projectRoot, installDir) {
+    return path.join(projectRoot, path.dirname(installDir), MANIFEST_FILE);
+}
+/** Store bound to one target's `skills.json`, hydrated when the file exists. */
+export async function loadUserManifest(projectRoot, installDir) {
+    const store = createRegistryStore({ filePath: manifestPath(projectRoot, installDir), handler: jsonHandler });
+    await load(store);
+    return store;
+}
+export function saveUserManifest(store) {
+    if (store.filePath !== undefined)
+        fs.mkdirSync(path.dirname(store.filePath), { recursive: true });
+    flush(store);
+}
+//# sourceMappingURL=userManifest.js.map

package/dist/registry/userManifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"userManifest.js","sourceRoot":"","sources":["../../src/registry/userManifest.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,mBAAmB,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAGxF,MAAM,aAAa,GAAG,aAAa,CAAC;AAEpC,iGAAiG;AACjG,MAAM,UAAU,YAAY,CAAC,WAAmB,EAAE,UAAkB;IAClE,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,aAAa,CAAC,CAAC;AACzE,CAAC;AAED,gFAAgF;AAChF,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,WAAmB,EAAE,UAAkB;IAC5E,MAAM,KAAK,GAAG,mBAAmB,CAAC,EAAE,QAAQ,EAAE,YAAY,CAAC,WAAW,EAAE,UAAU,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC;IAC7G,MAAM,IAAI,CAAC,KAAK,CAAC,CAAC;IAClB,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAoB;IACnD,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS;QAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAClG,KAAK,CAAC,KAAK,CAAC,CAAC;AACf,CAAC"}

package/dist/remote/fetch.d.ts

@@ -0,0 +1,16 @@
+/** One shallow clone of a remote repository, removed on `removeCheckout` and at process exit. */
+export interface RemoteCheckout {
+    url: string;
+    /** Absolute checkout root */
+    dir: string;
+    commit: string;
+}
+/**
+ * Shallow-clones `url` into a temporary directory and resolves its HEAD commit.
+ * The directory is removed at process exit even when a command bails out early.
+ *
+ * @throws when the URL is not a git remote or the clone fails
+ */
+export declare function cloneRemote(url: string): Promise<RemoteCheckout>;
+export declare function removeCheckout(checkout: RemoteCheckout): void;
+//# sourceMappingURL=fetch.d.ts.map

package/dist/remote/fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../../src/remote/fetch.ts"],"names":[],"mappings":"AAKA,iGAAiG;AACjG,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAK,MAAM,CAAC;IACf,6BAA6B;IAC7B,GAAG,EAAK,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAoBD;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAWtE;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,CAE7D"}

package/dist/remote/fetch.js

@@ -0,0 +1,41 @@
+// packages/skills/src/remote/fetch.ts
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+const REMOTE_URL = /^(https?:\/\/|ssh:\/\/|git:\/\/|git@)\S+$/;
+async function git(args, cwd) {
+    const proc = Bun.spawn(["git", ...args], {
+        cwd,
+        stdout: "pipe",
+        stderr: "pipe",
+        env: { ...process.env, GIT_TERMINAL_PROMPT: "0" },
+    });
+    const [stdout, stderr, exitCode] = await Promise.all([
+        new Response(proc.stdout).text(),
+        new Response(proc.stderr).text(),
+        proc.exited,
+    ]);
+    if (exitCode !== 0)
+        throw new Error(stderr.trim() !== "" ? stderr.trim() : `git ${args[0]} failed`);
+    return stdout.trim();
+}
+/**
+ * Shallow-clones `url` into a temporary directory and resolves its HEAD commit.
+ * The directory is removed at process exit even when a command bails out early.
+ *
+ * @throws when the URL is not a git remote or the clone fails
+ */
+export async function cloneRemote(url) {
+    if (!REMOTE_URL.test(url)) {
+        throw new Error(`"${url}" is not a git URL (expected https://, ssh://, git:// or git@)`);
+    }
+    const dir = fs.mkdtempSync(path.join(os.tmpdir(), "g3n-skills-remote-"));
+    process.once("exit", () => fs.rmSync(dir, { recursive: true, force: true }));
+    await git(["clone", "--depth", "1", "--quiet", "--", url, dir]);
+    const commit = await git(["rev-parse", "HEAD"], dir);
+    return { url, dir, commit };
+}
+export function removeCheckout(checkout) {
+    fs.rmSync(checkout.dir, { recursive: true, force: true });
+}
+//# sourceMappingURL=fetch.js.map

package/dist/remote/fetch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.js","sourceRoot":"","sources":["../../src/remote/fetch.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAU7B,MAAM,UAAU,GAAG,2CAA2C,CAAC;AAE/D,KAAK,UAAU,GAAG,CAAC,IAAc,EAAE,GAAY;IAC7C,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,EAAE;QACvC,GAAG;QACH,MAAM,EAAE,MAAM;QACd,MAAM,EAAE,MAAM;QACd,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,mBAAmB,EAAE,GAAG,EAAE;KAClD,CAAC,CAAC;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACnD,IAAI,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE;QAChC,IAAI,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE;QAChC,IAAI,CAAC,MAAM;KACZ,CAAC,CAAC;IACH,IAAI,QAAQ,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACpG,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;AACvB,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,GAAW;IAC3C,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,IAAI,GAAG,gEAAgE,CAAC,CAAC;IAC3F,CAAC;IAED,MAAM,GAAG,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,oBAAoB,CAAC,CAAC,CAAC;IACzE,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAE7E,MAAM,GAAG,CAAC,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;IAChE,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,CAAC,WAAW,EAAE,MAAM,CAAC,EAAE,GAAG,CAAC,CAAC;IACrD,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,QAAwB;IACrD,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AAC5D,CAAC"}

package/dist/remote/index.d.ts

@@ -0,0 +1,7 @@
+export { cloneRemote, removeCheckout } from "./fetch";
+export type { RemoteCheckout } from "./fetch";
+export { locateRemotePlugins } from "./manifest";
+export type { RemotePlugin, RemotePluginScan } from "./manifest";
+export { loadRemoteRegistry, remoteSkillSource } from "./registry";
+export type { RemoteRegistry } from "./registry";
+//# sourceMappingURL=index.d.ts.map

package/dist/remote/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/remote/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACtD,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACnE,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}

package/dist/remote/index.js

@@ -0,0 +1,5 @@
+// packages/skills/src/remote/index.ts
+export { cloneRemote, removeCheckout } from "./fetch";
+export { locateRemotePlugins } from "./manifest";
+export { loadRemoteRegistry, remoteSkillSource } from "./registry";
+//# sourceMappingURL=index.js.map

package/dist/remote/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/remote/index.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAEtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEjD,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC"}

package/dist/remote/manifest.d.ts

@@ -0,0 +1,23 @@
+/** One plugin found in a checked-out repository. */
+export interface RemotePlugin {
+    name: string;
+    version?: string;
+    /** Absolute plugin root inside the checkout */
+    dir: string;
+    /** Absolute skill directories, each holding a SKILL.md */
+    skillDirs: string[];
+}
+export interface RemotePluginScan {
+    plugins: RemotePlugin[];
+    warnings: string[];
+}
+/**
+ * Plugin roots and their skills declared by a repository's manifests. A root
+ * `marketplace.json` enumerates plugin directories; a root `plugin.json` makes
+ * the repository itself a plugin. Both `.claude-plugin` and `.cursor-plugin`
+ * layouts are read.
+ *
+ * @throws when the repository has neither manifest — plain skill folders are rejected
+ */
+export declare function locateRemotePlugins(repoRoot: string): RemotePluginScan;
+//# sourceMappingURL=manifest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/remote/manifest.ts"],"names":[],"mappings":"AA2BA,oDAAoD;AACpD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAM,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+CAA+C;IAC/C,GAAG,EAAO,MAAM,CAAC;IACjB,0DAA0D;IAC1D,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAG,YAAY,EAAE,CAAC;IACzB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAoDD;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,CAyCtE"}

package/dist/remote/manifest.js

@@ -0,0 +1,116 @@
+// packages/skills/src/remote/manifest.ts
+import fs from "node:fs";
+import path from "node:path";
+import { z } from "zod";
+import { SKILL_FILE } from "../registry/readSkillDir";
+const MANIFEST_DIRS = [".claude-plugin", ".cursor-plugin"];
+const MARKETPLACE_FILE = "marketplace.json";
+const PLUGIN_FILE = "plugin.json";
+const DEFAULT_SKILLS_DIR = "skills";
+const MarketplaceSchema = z.object({
+    plugins: z.array(z.object({
+        name: z.string().min(1),
+        source: z.unknown(),
+    })).default([]),
+});
+const RemotePluginManifestSchema = z.object({
+    name: z.string().min(1).optional(),
+    version: z.string().optional(),
+    /** A list of skill directories, or one directory to scan for them */
+    skills: z.union([z.string().min(1), z.array(z.string().min(1))]).optional(),
+});
+/** First existing `.claude-plugin`/`.cursor-plugin` file of the given name under `dir`. */
+function manifestFile(dir, file) {
+    for (const manifestDir of MANIFEST_DIRS) {
+        const candidate = path.join(dir, manifestDir, file);
+        if (fs.existsSync(candidate))
+            return candidate;
+    }
+    return null;
+}
+function readJson(file) {
+    return JSON.parse(fs.readFileSync(file, "utf8"));
+}
+/** Resolves `rel` against `base`, rejecting paths that escape the checkout at `root`. */
+function resolveInside(root, base, rel) {
+    const resolved = path.resolve(base, rel);
+    if (resolved !== root && !resolved.startsWith(root + path.sep)) {
+        throw new Error(`manifest path "${rel}" points outside the repository`);
+    }
+    return resolved;
+}
+/** Directories under `dir` holding a SKILL.md; a match is not descended into further. */
+function scanSkillDirs(dir) {
+    if (!fs.existsSync(dir))
+        return [];
+    const found = [];
+    const visit = (current) => {
+        if (fs.existsSync(path.join(current, SKILL_FILE))) {
+            found.push(current);
+            return;
+        }
+        for (const d of fs.readdirSync(current, { withFileTypes: true })) {
+            if (d.isDirectory() && !d.name.startsWith(".") && d.name !== "node_modules")
+                visit(path.join(current, d.name));
+        }
+    };
+    visit(dir);
+    return found.sort();
+}
+/** A plugin's skill directories: the listed ones, or a scan of its skills directory. */
+function pluginSkillDirs(pluginDir, repoRoot, manifest) {
+    if (Array.isArray(manifest.skills)) {
+        return manifest.skills.map((rel) => resolveInside(repoRoot, pluginDir, rel));
+    }
+    if (typeof manifest.skills === "string") {
+        return scanSkillDirs(resolveInside(repoRoot, pluginDir, manifest.skills));
+    }
+    return scanSkillDirs(path.join(pluginDir, DEFAULT_SKILLS_DIR));
+}
+/**
+ * Plugin roots and their skills declared by a repository's manifests. A root
+ * `marketplace.json` enumerates plugin directories; a root `plugin.json` makes
+ * the repository itself a plugin. Both `.claude-plugin` and `.cursor-plugin`
+ * layouts are read.
+ *
+ * @throws when the repository has neither manifest — plain skill folders are rejected
+ */
+export function locateRemotePlugins(repoRoot) {
+    const warnings = [];
+    const pluginDirs = new Map();
+    const marketplacePath = manifestFile(repoRoot, MARKETPLACE_FILE);
+    if (marketplacePath !== null) {
+        const marketplace = MarketplaceSchema.parse(readJson(marketplacePath));
+        for (const plugin of marketplace.plugins) {
+            if (typeof plugin.source !== "string") {
+                warnings.push(`${plugin.name} — marketplace source is not a local path, skipped`);
+                continue;
+            }
+            pluginDirs.set(resolveInside(repoRoot, repoRoot, plugin.source), plugin.name);
+        }
+    }
+    if (manifestFile(repoRoot, PLUGIN_FILE) !== null && !pluginDirs.has(path.resolve(repoRoot))) {
+        pluginDirs.set(path.resolve(repoRoot), undefined);
+    }
+    if (pluginDirs.size === 0) {
+        throw new Error("no .claude-plugin or .cursor-plugin manifest found — the repository is not a plugin or marketplace");
+    }
+    const plugins = [];
+    const withoutSkills = [];
+    for (const [dir, marketplaceName] of pluginDirs) {
+        const manifestPath = manifestFile(dir, PLUGIN_FILE);
+        const manifest = manifestPath === null ? {} : RemotePluginManifestSchema.parse(readJson(manifestPath));
+        const name = manifest.name ?? marketplaceName ?? path.basename(dir);
+        const skillDirs = pluginSkillDirs(dir, repoRoot, manifest);
+        if (skillDirs.length === 0) {
+            withoutSkills.push(name);
+            continue;
+        }
+        plugins.push({ name, version: manifest.version, dir, skillDirs });
+    }
+    if (withoutSkills.length > 0) {
+        warnings.push(`${withoutSkills.length} plugin(s) without skills skipped: ${withoutSkills.join(", ")}`);
+    }
+    return { plugins, warnings };
+}
+//# sourceMappingURL=manifest.js.map

package/dist/remote/manifest.js.map

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

package/dist/remote/registry.d.ts

@@ -0,0 +1,18 @@
+import type { EntrySource } from "@g3nomaly/core/cli";
+import type { SkillRegistry } from "../registry/types";
+import type { RemoteCheckout } from "./fetch";
+export interface RemoteRegistry {
+    registry: SkillRegistry;
+    warnings: string[];
+}
+/**
+ * Hydrates a registry from a checkout's plugin manifests, keyed by skill
+ * directory name with the plugin name as group. Each entry records its
+ * `source` so the install can resolve files inside the checkout and the user
+ * manifest keeps the provenance. `registryDependencies` are dropped with a
+ * warning — a remote repository cannot resolve against the package registry.
+ */
+export declare function loadRemoteRegistry(checkout: RemoteCheckout): Promise<RemoteRegistry>;
+/** Resolves a remote entry's files inside its checkout via the `source` recorded on it. */
+export declare function remoteSkillSource(checkout: RemoteCheckout): EntrySource;
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/remote/registry.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,aAAa,CAAC;IACxB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAmC1F;AAED,2FAA2F;AAC3F,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,cAAc,GAAG,WAAW,CAMvE"}

package/dist/remote/registry.js

@@ -0,0 +1,58 @@
+// packages/skills/src/remote/registry.ts
+import path from "node:path";
+import { copySource } from "@g3nomaly/core/installer";
+import { readSkillDir } from "../registry/readSkillDir";
+import { SkillMetaSchema } from "../registry/types";
+import { locateRemotePlugins } from "./manifest";
+/**
+ * Hydrates a registry from a checkout's plugin manifests, keyed by skill
+ * directory name with the plugin name as group. Each entry records its
+ * `source` so the install can resolve files inside the checkout and the user
+ * manifest keeps the provenance. `registryDependencies` are dropped with a
+ * warning — a remote repository cannot resolve against the package registry.
+ */
+export async function loadRemoteRegistry(checkout) {
+    const { plugins, warnings } = locateRemotePlugins(checkout.dir);
+    const registry = {};
+    for (const plugin of plugins) {
+        for (const skillDir of plugin.skillDirs) {
+            let entry;
+            try {
+                entry = await readSkillDir(skillDir, plugin.name, plugin.version);
+            }
+            catch (error) {
+                warnings.push(`skipped ${path.relative(checkout.dir, skillDir)} — ${error instanceof Error ? error.message : String(error)}`);
+                continue;
+            }
+            const [key, meta] = entry;
+            const existing = registry[key];
+            if (existing !== undefined) {
+                warnings.push(`skill "${key}" is defined by both ${existing.group} and ${plugin.name} — using the ${existing.group} one`);
+                continue;
+            }
+            const { registryDependencies, ...rest } = meta;
+            if (registryDependencies !== undefined) {
+                warnings.push(`${key} declares dependencies (${registryDependencies.join(", ")}) — they are not installed from a remote`);
+            }
+            registry[key] = {
+                ...rest,
+                source: {
+                    remote: checkout.url,
+                    commit: checkout.commit,
+                    dir: path.relative(checkout.dir, path.dirname(skillDir)),
+                },
+            };
+        }
+    }
+    return { registry, warnings };
+}
+/** Resolves a remote entry's files inside its checkout via the `source` recorded on it. */
+export function remoteSkillSource(checkout) {
+    return (entry) => {
+        const { source } = SkillMetaSchema.pick({ source: true }).parse(entry);
+        if (source === undefined)
+            throw new Error(`entry "${entry.name}" carries no remote source`);
+        return copySource((filePath) => path.join(checkout.dir, source.dir, filePath));
+    };
+}
+//# sourceMappingURL=registry.js.map

package/dist/remote/registry.js.map

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

package/dist/schemas/config.d.ts

@@ -0,0 +1,3 @@
+export { SkillTargetSchema, SkillsInstallDirsSchema, SkillsSettingsSchema, SkillsConfigSchema, } from "@g3nomaly/core/config";
+export type { SkillTarget, SkillsInstallDirs, SkillsSettings, SkillsConfig, } from "@g3nomaly/core/config";
+//# sourceMappingURL=config.d.ts.map