@g3nomaly/skills 1.0.0 → 1.0.2

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC"}

package/dist/index.js

@@ -1,11 +1,5 @@
 // packages/skills/src/index.ts
-export * from "./schemas";
-export * from "./filetree";
-export * from "./hooks";
 export * from "./registry";
-export * from "./remote";
-export * from "./task-manager";
-export * from "./vocabulary";
-export * from "./decisions";
-export * from "./workflow";
+export * from "./sources";
+export * from "./packages";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC"}

package/dist/packages/index.d.ts

@@ -0,0 +1,3 @@
+export { installSkillPackages, removeSkillPackages } from "./install";
+export type { PackageInstall } from "./install";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/packages/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AACtE,YAAY,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC"}

package/dist/packages/index.js

@@ -0,0 +1,3 @@
+// packages/skills/src/packages/index.ts
+export { installSkillPackages, removeSkillPackages } from "./install";
+//# sourceMappingURL=index.js.map

package/dist/packages/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/packages/index.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC"}

package/dist/packages/install.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @brief Outcome of installing one skill's packages.
+ *
+ * @property key - Skill key, the folder name under the install directory.
+ * @property error - Message from `bun install` when it failed; `undefined` when it succeeded.
+ */
+export interface PackageInstall {
+    key: string;
+    error?: string;
+}
+/**
+ * @brief Runs `bun install` in each installed skill folder that ships a
+ * `package.json`, with `--frozen-lockfile` when it ships a `bun.lock` too.
+ * The packages land in the skill's own `node_modules`.
+ *
+ * @param installDir - Absolute install directory, e.g. `/home/me/app/.claude/skills`
+ * @param keys - Skill keys to install, e.g. `["emphasise"]`.
+ * @returns one entry per skill that has a `package.json`; skills without one are left out
+ */
+export declare function installSkillPackages(installDir: string, keys: readonly string[]): Promise<PackageInstall[]>;
+/**
+ * @brief Deletes the `node_modules` of skills that are no longer installed, then the
+ * skill folder when nothing else is left in it.
+ *
+ * @param installDir - Absolute install directory, e.g. `/home/me/app/.claude/skills`
+ * @param keys - Skills whose files were removed
+ */
+export declare function removeSkillPackages(installDir: string, keys: readonly string[]): void;
+//# sourceMappingURL=install.d.ts.map

package/dist/packages/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../src/packages/install.ts"],"names":[],"mappings":"AAQA;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAK,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;GAQG;AACH,wBAAsB,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAgBjH;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAMrF"}

package/dist/packages/install.js

@@ -0,0 +1,48 @@
+// packages/skills/src/packages/install.ts
+import fs from "node:fs";
+import path from "node:path";
+const PACKAGE_FILE = "package.json";
+const LOCK_FILE = "bun.lock";
+const MODULES_DIR = "node_modules";
+/**
+ * @brief Runs `bun install` in each installed skill folder that ships a
+ * `package.json`, with `--frozen-lockfile` when it ships a `bun.lock` too.
+ * The packages land in the skill's own `node_modules`.
+ *
+ * @param installDir - Absolute install directory, e.g. `/home/me/app/.claude/skills`
+ * @param keys - Skill keys to install, e.g. `["emphasise"]`.
+ * @returns one entry per skill that has a `package.json`; skills without one are left out
+ */
+export async function installSkillPackages(installDir, keys) {
+    const results = [];
+    for (const key of keys) {
+        const skillDir = path.join(installDir, key);
+        if (!fs.existsSync(path.join(skillDir, PACKAGE_FILE)))
+            continue;
+        const frozen = fs.existsSync(path.join(skillDir, LOCK_FILE)) ? ["--frozen-lockfile"] : [];
+        const proc = Bun.spawn([process.execPath, "install", "--silent", ...frozen], {
+            cwd: skillDir,
+            stdout: "ignore",
+            stderr: "pipe",
+        });
+        const [stderr, exitCode] = await Promise.all([new Response(proc.stderr).text(), proc.exited]);
+        results.push(exitCode === 0 ? { key } : { key, error: stderr.trim() || `bun install exited with ${exitCode}` });
+    }
+    return results;
+}
+/**
+ * @brief Deletes the `node_modules` of skills that are no longer installed, then the
+ * skill folder when nothing else is left in it.
+ *
+ * @param installDir - Absolute install directory, e.g. `/home/me/app/.claude/skills`
+ * @param keys - Skills whose files were removed
+ */
+export function removeSkillPackages(installDir, keys) {
+    for (const key of keys) {
+        const skillDir = path.join(installDir, key);
+        fs.rmSync(path.join(skillDir, MODULES_DIR), { recursive: true, force: true });
+        if (fs.existsSync(skillDir) && fs.readdirSync(skillDir).length === 0)
+            fs.rmdirSync(skillDir);
+    }
+}
+//# sourceMappingURL=install.js.map

package/dist/packages/install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../../src/packages/install.ts"],"names":[],"mappings":"AAAA,0CAA0C;AAC1C,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,YAAY,GAAG,cAAc,CAAC;AACpC,MAAM,SAAS,GAAM,UAAU,CAAC;AAChC,MAAM,WAAW,GAAI,cAAc,CAAC;AAapC;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,UAAkB,EAAE,IAAuB;IACpF,MAAM,OAAO,GAAqB,EAAE,CAAC;IACrC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;QAC5C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;YAAE,SAAS;QAEhE,MAAM,MAAM,GAAG,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1F,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC,EAAE;YAC3E,GAAG,EAAK,QAAQ;YAChB,MAAM,EAAE,QAAQ;YAChB,MAAM,EAAE,MAAM;SACf,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;QAC9F,OAAO,CAAC,IAAI,CAAC,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,EAAE,IAAI,2BAA2B,QAAQ,EAAE,EAAE,CAAC,CAAC;IAClH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,UAAkB,EAAE,IAAuB;IAC7E,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;QAC5C,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9E,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,MAAM,KAAK,CAAC;YAAE,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IAC/F,CAAC;AACH,CAAC"}

package/dist/registry/index.d.ts

@@ -1,5 +1,7 @@
 export * from "./types";
-export { resolvePluginsRoot, listGroups, loadPackageRegistry, resolveSkillSourcePath } from "./loadPackageRegistry";
 export { readSkillDir, SKILL_FILE } from "./readSkillDir";
-export { manifestPath, loadUserManifest, saveUserManifest } from "./userManifest";
+export { locateSkills } from "./locate";
+export type { SkillPlugin, SkillScan } from "./locate";
+export { readSkillSource } from "./readSource";
+export { skillsManifestPath } from "./manifest";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/registry/index.ts"],"names":[],"mappings":"AACA,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACpH,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/registry/index.ts"],"names":[],"mappings":"AACA,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC"}

package/dist/registry/index.js

@@ -1,6 +1,7 @@
 // packages/skills/src/registry/index.ts
 export * from "./types";
-export { resolvePluginsRoot, listGroups, loadPackageRegistry, resolveSkillSourcePath } from "./loadPackageRegistry";
 export { readSkillDir, SKILL_FILE } from "./readSkillDir";
-export { manifestPath, loadUserManifest, saveUserManifest } from "./userManifest";
+export { locateSkills } from "./locate";
+export { readSkillSource } from "./readSource";
+export { skillsManifestPath } from "./manifest";
 //# sourceMappingURL=index.js.map

package/dist/registry/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/registry/index.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACpH,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/registry/index.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC"}

package/dist/registry/locate.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @brief One plugin of a source with the skill folders it holds.
+ *
+ * @property name - Plugin name, from its manifest or the marketplace entry.
+ * @property version - Version from the plugin manifest, when it sets one.
+ * @property skillDirs - Absolute skill folders, each holding a SKILL.md.
+ */
+export interface SkillPlugin {
+    name: string;
+    version?: string;
+    skillDirs: string[];
+}
+/**
+ * @brief The plugins found in one source, with what was skipped and why.
+ *
+ * @property plugins - Plugins that hold at least one skill folder.
+ * @property warnings - One message per skipped item, e.g. a plugin without skills.
+ */
+export interface SkillScan {
+    plugins: SkillPlugin[];
+    warnings: string[];
+}
+/**
+ * @brief Finds the skills a source provides. A `marketplace.json` lists plugin
+ * folders; a root `plugin.json` makes the source itself a plugin. Both
+ * `.claude-plugin` and `.cursor-plugin` layouts are read.
+ *
+ * @param sourceRoot - Absolute root of the source checkout
+ * @returns The plugins with their skill folders, and the warnings about what was skipped.
+ * @throws when the source has neither manifest; plain skill folders are rejected
+ */
+export declare function locateSkills(sourceRoot: string): SkillScan;
+//# sourceMappingURL=locate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"locate.d.ts","sourceRoot":"","sources":["../../src/registry/locate.ts"],"names":[],"mappings":"AAyBA;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAO,MAAM,CAAC;IAClB,OAAO,CAAC,EAAG,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;;;;GAKG;AACH,MAAM,WAAW,SAAS;IACxB,OAAO,EAAG,WAAW,EAAE,CAAC;IACxB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAqCD;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CA+B1D"}

package/dist/registry/locate.js

@@ -0,0 +1,88 @@
+// packages/skills/src/registry/locate.ts
+import fs from "node:fs";
+import path from "node:path";
+import { z } from "zod";
+import { manifestFile, readMarketplace, resolveInside } from "@g3nomaly/core/installer";
+import { SKILL_FILE } from "./readSkillDir";
+const PLUGIN_FILE = "plugin.json";
+const DEFAULT_SKILLS_DIR = "skills";
+const PluginManifestSchema = z.object({
+    name: z.string().min(1).optional(),
+    version: z.string().optional(),
+    skills: z.union([z.string().min(1), z.array(z.string().min(1))]).optional(),
+});
+/** Folders 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();
+}
+/**
+ * @brief A plugin's skill folders: the listed ones, or a scan of its skills folder.
+ *
+ * @param pluginDir - Absolute plugin folder.
+ * @param sourceRoot - Absolute source root that listed skill paths must stay inside.
+ * @param manifest - The plugin's parsed `plugin.json`, or `{}` when it has none.
+ * @returns Absolute skill folders.
+ */
+function pluginSkillDirs(pluginDir, sourceRoot, manifest) {
+    if (Array.isArray(manifest.skills)) {
+        return manifest.skills.map((rel) => resolveInside(sourceRoot, pluginDir, rel));
+    }
+    if (typeof manifest.skills === "string") {
+        return scanSkillDirs(resolveInside(sourceRoot, pluginDir, manifest.skills));
+    }
+    return scanSkillDirs(path.join(pluginDir, DEFAULT_SKILLS_DIR));
+}
+/**
+ * @brief Finds the skills a source provides. A `marketplace.json` lists plugin
+ * folders; a root `plugin.json` makes the source itself a plugin. Both
+ * `.claude-plugin` and `.cursor-plugin` layouts are read.
+ *
+ * @param sourceRoot - Absolute root of the source checkout
+ * @returns The plugins with their skill folders, and the warnings about what was skipped.
+ * @throws when the source has neither manifest; plain skill folders are rejected
+ */
+export function locateSkills(sourceRoot) {
+    const marketplace = readMarketplace(sourceRoot);
+    const warnings = [...(marketplace?.warnings ?? [])];
+    const pluginDirs = new Map();
+    for (const plugin of marketplace?.plugins ?? [])
+        pluginDirs.set(plugin.dir, plugin.name);
+    const root = path.resolve(sourceRoot);
+    if (manifestFile(root, PLUGIN_FILE) !== null && !pluginDirs.has(root))
+        pluginDirs.set(root, undefined);
+    if (pluginDirs.size === 0) {
+        throw new Error("no .claude-plugin or .cursor-plugin manifest found, the source 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 ? {} : PluginManifestSchema.parse(JSON.parse(fs.readFileSync(manifestPath, "utf8")));
+        const name = manifest.name ?? marketplaceName ?? path.basename(dir);
+        const skillDirs = pluginSkillDirs(dir, sourceRoot, manifest);
+        if (skillDirs.length === 0) {
+            withoutSkills.push(name);
+            continue;
+        }
+        plugins.push({ name, version: manifest.version, skillDirs });
+    }
+    if (withoutSkills.length > 0) {
+        warnings.push(`${withoutSkills.length} plugin(s) without skills skipped: ${withoutSkills.join(", ")}`);
+    }
+    return { plugins, warnings };
+}
+//# sourceMappingURL=locate.js.map

package/dist/registry/locate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"locate.js","sourceRoot":"","sources":["../../src/registry/locate.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACxF,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C,MAAM,WAAW,GAAU,aAAa,CAAC;AACzC,MAAM,kBAAkB,GAAG,QAAQ,CAAC;AAEpC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,IAAI,EAAK,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACrC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,MAAM,EAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CAC7E,CAAC,CAAC;AAmCH,qFAAqF;AACrF,SAAS,aAAa,CAAC,GAAW;IAChC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IACnC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,KAAK,GAAG,CAAC,OAAe,EAAQ,EAAE;QACtC,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC;YAClD,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACpB,OAAO;QACT,CAAC;QACD,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,WAAW,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;YACjE,IAAI,CAAC,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,cAAc;gBAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QACjH,CAAC;IACH,CAAC,CAAC;IACF,KAAK,CAAC,GAAG,CAAC,CAAC;IACX,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC;AACtB,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,eAAe,CAAC,SAAiB,EAAE,UAAkB,EAAE,QAAwB;IACtF,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACnC,OAAO,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,aAAa,CAAC,UAAU,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC,CAAC;IACjF,CAAC;IACD,IAAI,OAAO,QAAQ,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QACxC,OAAO,aAAa,CAAC,aAAa,CAAC,UAAU,EAAE,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IAC9E,CAAC;IACD,OAAO,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,kBAAkB,CAAC,CAAC,CAAC;AACjE,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,YAAY,CAAC,UAAkB;IAC7C,MAAM,WAAW,GAAG,eAAe,CAAC,UAAU,CAAC,CAAC;IAChD,MAAM,QAAQ,GAAM,CAAC,GAAG,CAAC,WAAW,EAAE,QAAQ,IAAI,EAAE,CAAC,CAAC,CAAC;IACvD,MAAM,UAAU,GAAI,IAAI,GAAG,EAA8B,CAAC;IAC1D,KAAK,MAAM,MAAM,IAAI,WAAW,EAAE,OAAO,IAAI,EAAE;QAAE,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IAEzF,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACtC,IAAI,YAAY,CAAC,IAAI,EAAE,WAAW,CAAC,KAAK,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IACvG,IAAI,UAAU,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,+FAA+F,CAAC,CAAC;IACnH,CAAC;IAED,MAAM,OAAO,GAAkB,EAAE,CAAC;IAClC,MAAM,aAAa,GAAa,EAAE,CAAC;IACnC,KAAK,MAAM,CAAC,GAAG,EAAE,eAAe,CAAC,IAAI,UAAU,EAAE,CAAC;QAChD,MAAM,YAAY,GAAG,YAAY,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;QACpD,MAAM,QAAQ,GAAO,YAAY,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,oBAAoB,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;QAChI,MAAM,IAAI,GAAW,QAAQ,CAAC,IAAI,IAAI,eAAe,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QAE5E,MAAM,SAAS,GAAG,eAAe,CAAC,GAAG,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;QAC7D,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3B,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACzB,SAAS;QACX,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC;IAC/D,CAAC;IACD,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7B,QAAQ,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,MAAM,sCAAsC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACzG,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;AAC/B,CAAC"}

package/dist/registry/manifest.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @brief Path of a target's `skills.json`, which sits beside its install directory:
+ * `.claude/skills` → `.claude/skills.json`.
+ *
+ * @param projectRoot - Absolute project root.
+ * @param installDir - Relative to `projectRoot`, e.g. `.claude/skills`
+ * @returns absolute path
+ */
+export declare function skillsManifestPath(projectRoot: string, installDir: string): string;
+//# sourceMappingURL=manifest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/registry/manifest.ts"],"names":[],"mappings":"AAKA;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAElF"}

package/dist/registry/manifest.js

@@ -0,0 +1,15 @@
+// packages/skills/src/registry/manifest.ts
+import path from "node:path";
+const MANIFEST_FILE = "skills.json";
+/**
+ * @brief Path of a target's `skills.json`, which sits beside its install directory:
+ * `.claude/skills` → `.claude/skills.json`.
+ *
+ * @param projectRoot - Absolute project root.
+ * @param installDir - Relative to `projectRoot`, e.g. `.claude/skills`
+ * @returns absolute path
+ */
+export function skillsManifestPath(projectRoot, installDir) {
+    return path.join(projectRoot, path.dirname(installDir), MANIFEST_FILE);
+}
+//# sourceMappingURL=manifest.js.map

package/dist/registry/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../src/registry/manifest.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAC3C,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,aAAa,GAAG,aAAa,CAAC;AAEpC;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAAC,WAAmB,EAAE,UAAkB;IACxE,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,aAAa,CAAC,CAAC;AACzE,CAAC"}

package/dist/registry/readSkillDir.d.ts

@@ -1,12 +1,15 @@
+import type { ReadContext } from "@g3nomaly/core/installer";
 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.
+ * @brief Reads one skill folder into its registry entry. The key is the folder
+ * name and every file below it, hooks included, becomes a `files[]` entry at
+ * `<key>/<file>`, so the skill installs as one self-contained folder.
  *
- * @throws when the directory holds no SKILL.md or its frontmatter is invalid
+ * @param skillDir - Absolute skill folder inside a source checkout
+ * @param context - Origin to record, the plugin as group, and the plugin's version
+ * @returns The skill key and its registry entry.
+ * @throws when the folder holds no SKILL.md or its frontmatter is invalid
  */
-export declare function readSkillDir(skillDir: string, group: string, version?: string): Promise<[string, SkillMeta]>;
+export declare function readSkillDir(skillDir: string, context: ReadContext): Promise<[string, SkillMeta]>;
 //# sourceMappingURL=readSkillDir.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"readSkillDir.d.ts","sourceRoot":"","sources":["../../src/registry/readSkillDir.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,OAAO,KAAK,EAA4B,SAAS,EAAE,MAAM,SAAS,CAAC;AAEnE,eAAO,MAAM,UAAU,aAAa,CAAC;AAqBrC;;;;;;;;;GASG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAqBvG"}

package/dist/registry/readSkillDir.js

@@ -3,56 +3,56 @@ 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";
+import { listFiles } from "@g3nomaly/core/installer";
+import { readFrontmatter } from "../utils/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(),
 });
+/**
+ * @brief Kind of a file by its path inside the skill: `SKILL.md`, an agent file, a hook, or a reference.
+ *
+ * @param relativeToSkill - Path of the file inside the skill folder, e.g. `agents/planner.md`.
+ * @returns The kind of the file.
+ */
 function fileType(relativeToSkill) {
     if (relativeToSkill === SKILL_FILE)
         return "skill";
     if (relativeToSkill.startsWith(`agents${path.sep}`))
         return "agent";
+    if (relativeToSkill.startsWith(`hooks${path.sep}`))
+        return "hook";
     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.
+ * @brief Reads one skill folder into its registry entry. The key is the folder
+ * name and every file below it, hooks included, becomes a `files[]` entry at
+ * `<key>/<file>`, so the skill installs as one self-contained folder.
  *
- * @throws when the directory holds no SKILL.md or its frontmatter is invalid
+ * @param skillDir - Absolute skill folder inside a source checkout
+ * @param context - Origin to record, the plugin as group, and the plugin's version
+ * @returns The skill key and its registry entry.
+ * @throws when the folder holds no SKILL.md or its frontmatter is invalid
  */
-export async function readSkillDir(skillDir, group, version) {
+export async function readSkillDir(skillDir, context) {
     const skillMd = path.join(skillDir, SKILL_FILE);
-    if (!fs.existsSync(skillMd)) {
+    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)),
-        });
+    for (const rel of listFiles(skillDir)) {
+        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,
+            version: context.version,
+            group: context.group,
             registryDependencies: frontmatter.registryDependencies,
+            origin: context.origin,
             files,
         }];
 }

package/dist/registry/readSkillDir.js.map

@@ -1 +1 @@
-{"version":3,"file":"readSkillDir.js","sourceRoot":"","sources":["../../src/registry/readSkillDir.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAG1D,MAAM,CAAC,MAAM,UAAU,GAAG,UAAU,CAAC;AAErC,MAAM,sBAAsB,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,0EAA0E;IAC1E,oBAAoB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CAC5D,CAAC,CAAC;AAEH,SAAS,QAAQ,CAAC,eAAuB;IACvC,IAAI,eAAe,KAAK,UAAU;QAAE,OAAO,OAAO,CAAC;IACnD,IAAI,eAAe,CAAC,UAAU,CAAC,SAAS,IAAI,CAAC,GAAG,EAAE,CAAC;QAAE,OAAO,OAAO,CAAC;IACpE,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,SAAS,IAAI,CAAC,GAAW,EAAE,IAAI,GAAW,GAAG;IAC3C,OAAO,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE;QAChE,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;QACpC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,QAAgB,EAAE,KAAa,EAAE,OAAgB;IAClF,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IAChD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,GAAG,QAAQ,aAAa,UAAU,EAAE,CAAC,CAAC;IACxD,CAAC;IAED,MAAM,GAAG,GAAW,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC5C,MAAM,WAAW,GAAG,sBAAsB,CAAC,KAAK,CAAC,MAAM,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC;IAEjF,MAAM,KAAK,GAAgB,EAAE,CAAC;IAC9B,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QACxC,KAAK,CAAC,IAAI,CAAC;YACT,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC;YACzB,IAAI,EAAE,QAAQ,CAAC,GAAG,CAAC;YACnB,IAAI,EAAE,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;SAC/C,CAAC,CAAC;IACL,CAAC;IAED,OAAO,CAAC,GAAG,EAAE;YACX,IAAI,EAAkB,WAAW,CAAC,IAAI;YACtC,WAAW,EAAW,WAAW,CAAC,WAAW;YAC7C,OAAO;YACP,KAAK;YACL,oBAAoB,EAAE,WAAW,CAAC,oBAAoB;YACtD,KAAK;SACN,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"readSkillDir.js","sourceRoot":"","sources":["../../src/registry/readSkillDir.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAErD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAGvD,MAAM,CAAC,MAAM,UAAU,GAAG,UAAU,CAAC;AAErC,MAAM,sBAAsB,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,oBAAoB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CAC5D,CAAC,CAAC;AAEH;;;;;GAKG;AACH,SAAS,QAAQ,CAAC,eAAuB;IACvC,IAAI,eAAe,KAAK,UAAU;QAAE,OAAO,OAAO,CAAC;IACnD,IAAI,eAAe,CAAC,UAAU,CAAC,SAAS,IAAI,CAAC,GAAG,EAAE,CAAC;QAAE,OAAO,OAAO,CAAC;IACpE,IAAI,eAAe,CAAC,UAAU,CAAC,QAAQ,IAAI,CAAC,GAAG,EAAE,CAAC;QAAE,OAAO,MAAM,CAAC;IAClE,OAAO,WAAW,CAAC;AACrB,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,QAAgB,EAAE,OAAoB;IACvE,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IAChD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,QAAQ,aAAa,UAAU,EAAE,CAAC,CAAC;IAEnF,MAAM,GAAG,GAAW,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC5C,MAAM,WAAW,GAAG,sBAAsB,CAAC,KAAK,CAAC,MAAM,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC;IAEjF,MAAM,KAAK,GAAgB,EAAE,CAAC;IAC9B,KAAK,MAAM,GAAG,IAAI,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;QACtC,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;IACjH,CAAC;IAED,OAAO,CAAC,GAAG,EAAE;YACX,IAAI,EAAkB,WAAW,CAAC,IAAI;YACtC,WAAW,EAAW,WAAW,CAAC,WAAW;YAC7C,OAAO,EAAe,OAAO,CAAC,OAAO;YACrC,KAAK,EAAiB,OAAO,CAAC,KAAK;YACnC,oBAAoB,EAAE,WAAW,CAAC,oBAAoB;YACtD,MAAM,EAAgB,OAAO,CAAC,MAAM;YACpC,KAAK;SACN,CAAC,CAAC;AACL,CAAC"}

package/dist/registry/readSource.d.ts

@@ -0,0 +1,12 @@
+import type { ReadSource } from "@g3nomaly/core/installer";
+import type { SkillMeta } from "./types";
+/**
+ * @brief Reads every skill a checked-out source declares through its plugin
+ * manifests, with the plugin as group. An unreadable skill is skipped with a
+ * warning. Handed to `loadSourceRegistry` by every skills command.
+ *
+ * @param checkout - The checked-out source: its folder, name and revision.
+ * @returns The skills read, and the warnings about those skipped.
+ */
+export declare const readSkillSource: ReadSource<SkillMeta>;
+//# sourceMappingURL=readSource.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"readSource.d.ts","sourceRoot":"","sources":["../../src/registry/readSource.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAI3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzC;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,EAAE,UAAU,CAAC,SAAS,CAmBjD,CAAC"}

package/dist/registry/readSource.js

@@ -0,0 +1,33 @@
+// packages/skills/src/registry/readSource.ts
+import path from "node:path";
+import { errorMessage } from "@g3nomaly/core/utils";
+import { locateSkills } from "./locate";
+import { readSkillDir } from "./readSkillDir";
+/**
+ * @brief Reads every skill a checked-out source declares through its plugin
+ * manifests, with the plugin as group. An unreadable skill is skipped with a
+ * warning. Handed to `loadSourceRegistry` by every skills command.
+ *
+ * @param checkout - The checked-out source: its folder, name and revision.
+ * @returns The skills read, and the warnings about those skipped.
+ */
+export const readSkillSource = async (checkout) => {
+    const { plugins, warnings } = locateSkills(checkout.dir);
+    const entries = [];
+    for (const plugin of plugins) {
+        for (const skillDir of plugin.skillDirs) {
+            try {
+                entries.push(await readSkillDir(skillDir, {
+                    origin: { source: checkout.name, dir: path.relative(checkout.dir, path.dirname(skillDir)), commit: checkout.commit, version: checkout.version },
+                    group: plugin.name,
+                    version: plugin.version,
+                }));
+            }
+            catch (error) {
+                warnings.push(`skipped ${path.relative(checkout.dir, skillDir)}: ${errorMessage(error)}`);
+            }
+        }
+    }
+    return { entries, warnings };
+};
+//# sourceMappingURL=readSource.js.map

package/dist/registry/readSource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readSource.js","sourceRoot":"","sources":["../../src/registry/readSource.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAG9C;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,eAAe,GAA0B,KAAK,EAAE,QAAQ,EAAE,EAAE;IACvE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,YAAY,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IACzD,MAAM,OAAO,GAA0B,EAAE,CAAC;IAE1C,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;YACxC,IAAI,CAAC;gBACH,OAAO,CAAC,IAAI,CAAC,MAAM,YAAY,CAAC,QAAQ,EAAE;oBACxC,MAAM,EAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE;oBAChJ,KAAK,EAAI,MAAM,CAAC,IAAI;oBACpB,OAAO,EAAE,MAAM,CAAC,OAAO;iBACxB,CAAC,CAAC,CAAC;YACN,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,QAAQ,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,KAAK,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAC5F,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;AAC/B,CAAC,CAAC"}

package/dist/registry/types.d.ts

@@ -1,53 +1,64 @@
 import { z } from "zod";
 export declare const SkillFileTypeSchema: z.ZodEnum<{
     agent: "agent";
+    hook: "hook";
     reference: "reference";
     skill: "skill";
 }>;
+/** Kind of a file inside a skill: `skill`, `agent`, `hook` or `reference`. */
 export type SkillFileType = z.infer<typeof SkillFileTypeSchema>;
+/** One file of a skill; `path` is `<skill>/<file>`, relative to the install directory. */
 export declare const SkillFileSchema: z.ZodObject<{
     path: z.ZodString;
+    hash: z.ZodOptional<z.ZodString>;
+    version: z.ZodOptional<z.ZodString>;
     type: z.ZodEnum<{
         agent: "agent";
+        hook: "hook";
         reference: "reference";
         skill: "skill";
     }>;
-    hash: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
+/** One file of a skill, as recorded in `skills.json`; its `path` is relative to the install directory. */
 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
+ * One installable skill. Built from a source's plugin manifest plus the
+ * skill's `SKILL.md` frontmatter by `readSkillDir`, 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>;
+    origin: z.ZodObject<{
+        source: z.ZodString;
+        dir: z.ZodString;
+        commit: z.ZodOptional<z.ZodString>;
+        version: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    forkedFrom: 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;
+        hash: z.ZodOptional<z.ZodString>;
+        version: z.ZodOptional<z.ZodString>;
         type: z.ZodEnum<{
             agent: "agent";
+            hook: "hook";
             reference: "reference";
             skill: "skill";
         }>;
-        hash: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
+/**
+ * @brief One installable skill, as `SkillMetaSchema` validates it.
+ *
+ * @property group - Plugin the skill ships in, e.g. `speech`.
+ * @property registryDependencies - Skills this one needs installed beside it. As read from a source these are `<key>` or `<key>@<source>`; once installed, the resolved keys.
+ * @property files - Every file of the skill, each with its `<key>/<file>` path.
+ */
 export type SkillMeta = z.infer<typeof SkillMetaSchema>;
+/** Installed skills of one target, keyed by skill key. */
 export type SkillRegistry = Record<string, SkillMeta>;
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/registry/types.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,mBAAmB;;;;;EAAkD,CAAC;AAEnF,8EAA8E;AAC9E,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,0FAA0F;AAC1F,eAAO,MAAM,eAAe;;;;;;;;;;iBAE1B,CAAC;AAEH,0GAA0G;AAC1G,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD;;;;GAIG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;iBAI1B,CAAC;AAEH;;;;;;GAMG;AACH,MAAM,MAAM,SAAS,GAAO,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAC5D,0DAA0D;AAC1D,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC"}