@g3nomaly/skills 0.3.0 → 1.0.1

package/dist/cli/index.js

@@ -0,0 +1,93 @@
+#!/usr/bin/env bun
+// packages/skills/src/cli/index.ts
+import { Command } from "commander";
+import { readPackageMeta, warnIfOutdated } from "@g3nomaly/core/utils";
+import { SkillTargetSchema } from "@g3nomaly/core/config";
+import { initCommand } from "./commands/init";
+import { addCommand } from "./commands/add";
+import { removeCommand } from "./commands/remove";
+import { updateCommand } from "./commands/update";
+import { lsCommand } from "./commands/ls";
+import { sourceAddCommand, sourceLsCommand, sourceRemoveCommand } from "./commands/source";
+/** The `-t` value as a one-target list, or `undefined` for every configured target. */
+function parseTargets(value) {
+    return value === undefined ? undefined : [SkillTargetSchema.parse(value)];
+}
+const program = new Command()
+    .name("g3n-skills")
+    .description("Install skills, with their hooks, from any registered source into a project's agent directories");
+program
+    .command("init")
+    .description("Configure which harnesses skills are installed for")
+    .option("-f, --force", "Reconfigure without prompting")
+    .option("--targets <list>", "Comma-separated targets (claude,codex); skips the prompt")
+    .action(async (opts) => {
+    const targets = opts.targets?.split(",").map((t) => SkillTargetSchema.parse(t.trim()));
+    await initCommand({ force: opts.force, targets });
+});
+const source = program
+    .command("source")
+    .description("Register, list and unregister the sources skills are installed from");
+source
+    .command("add <source>")
+    .description("Register a git repository (URL or owner/repo), npm package (npm:<pkg> or @scope/pkg) or local folder")
+    .option("--name <name>", "Name to register it under (default: derived from the source)")
+    .option("--ref <ref>", "Branch or tag to pin a git source to (default: its default branch)")
+    .option("-t, --target <target>", "Only this target (claude|codex)")
+    .action(async (input, opts) => {
+    await sourceAddCommand(input, { name: opts.name, ref: opts.ref, targets: parseTargets(opts.target) });
+});
+source
+    .command("ls")
+    .description("List the registered sources, built-in ones first")
+    .option("--json", "Output as JSON")
+    .option("-t, --target <target>", "Only this target (claude|codex)")
+    .action(async (opts) => {
+    await sourceLsCommand({ json: opts.json, targets: parseTargets(opts.target) });
+});
+source
+    .command("remove <name>")
+    .description("Unregister a source; built-in sources cannot be removed")
+    .option("-f, --force", "Unregister even when installed skills came from it")
+    .option("-t, --target <target>", "Only this target (claude|codex)")
+    .action(async (name, opts) => {
+    await sourceRemoveCommand(name, { force: opts.force, targets: parseTargets(opts.target) });
+});
+program
+    .command("add [skills...]")
+    .description("Install skills or whole groups with their dependencies; name one source with <skill>@<source>")
+    .option("-f, --force", "Overwrite locally modified files")
+    .option("-t, --target <target>", "Only this target (claude|codex)")
+    .action(async (skills, opts) => {
+    await addCommand(skills, { force: opts.force, targets: parseTargets(opts.target) });
+});
+program
+    .command("remove [skills...]")
+    .description("Remove installed skills")
+    .option("-f, --force", "Remove even if files have been modified")
+    .option("-t, --target <target>", "Only this target (claude|codex)")
+    .action(async (skills, opts) => {
+    await removeCommand(skills, { force: opts.force, targets: parseTargets(opts.target) });
+});
+program
+    .command("update [skills...]")
+    .description("Re-install installed skills from the source each came from")
+    .option("-f, --force", "Overwrite locally modified files without prompting")
+    .option("--dry-run", "Report what would change without writing")
+    .option("-t, --target <target>", "Only this target (claude|codex)")
+    .action(async (skills, opts) => {
+    await updateCommand(skills, { force: opts.force, dryRun: opts.dryRun, targets: parseTargets(opts.target) });
+});
+program
+    .command("ls")
+    .description("List the skills the registered sources offer")
+    .option("--json", "Output as JSON")
+    .option("--source <name>", "Only this source")
+    .option("--installed", "List what skills.json records instead of what the sources offer")
+    .action(async (opts) => {
+    await lsCommand({ json: opts.json, source: opts.source, installed: opts.installed });
+});
+const self = readPackageMeta(import.meta.url);
+await warnIfOutdated(self.name, self.version, import.meta.url);
+program.parseAsync();
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./registry";
+export * from "./sources";
+export * from "./packages";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,5 @@
+// packages/skills/src/index.ts
+export * from "./registry";
+export * from "./sources";
+export * from "./packages";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"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,24 @@
+/** Outcome of installing one skill's packages. */
+export interface PackageInstall {
+    key: string;
+    /** Message from `bun install` when it failed, `undefined` when it succeeded */
+    error?: string;
+}
+/**
+ * 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`
+ * @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[]>;
+/**
+ * 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,kDAAkD;AAClD,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAK,MAAM,CAAC;IACf,+EAA+E;IAC/E,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;GAOG;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,47 @@
+// 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";
+/**
+ * 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`
+ * @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;
+}
+/**
+ * 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;AASpC;;;;;;;GAOG;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

@@ -0,0 +1,7 @@
+export * from "./types";
+export { readSkillDir, SKILL_FILE } from "./readSkillDir";
+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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,7 @@
+// packages/skills/src/registry/index.ts
+export * from "./types";
+export { readSkillDir, SKILL_FILE } from "./readSkillDir";
+export { locateSkills } from "./locate";
+export { readSkillSource } from "./readSource";
+export { skillsManifestPath } from "./manifest";
+//# sourceMappingURL=index.js.map

package/dist/registry/index.js.map

@@ -0,0 +1 @@
+{"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,22 @@
+/** One plugin of a source with the skill folders it holds. */
+export interface SkillPlugin {
+    name: string;
+    version?: string;
+    /** Absolute skill folders, each holding a SKILL.md */
+    skillDirs: string[];
+}
+/** The plugins found in one source, with what was skipped and why. */
+export interface SkillScan {
+    plugins: SkillPlugin[];
+    warnings: string[];
+}
+/**
+ * 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
+ * @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":"AAmBA,8DAA8D;AAC9D,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAO,MAAM,CAAC;IAClB,OAAO,CAAC,EAAG,MAAM,CAAC;IAClB,sDAAsD;IACtD,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,sEAAsE;AACtE,MAAM,WAAW,SAAS;IACxB,OAAO,EAAG,WAAW,EAAE,CAAC;IACxB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AA8BD;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CA+B1D"}

package/dist/registry/locate.js

@@ -0,0 +1,81 @@
+// 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(),
+    /** A list of skill folders, or one folder to scan for them */
+    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();
+}
+/** A plugin's skill folders: the listed ones, or a scan of its skills folder. */
+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));
+}
+/**
+ * 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
+ * @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":"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"}

package/dist/registry/manifest.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Path of a target's `skills.json`, which sits beside its install directory:
+ * `.claude/skills` → `.claude/skills.json`.
+ *
+ * @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;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAElF"}

package/dist/registry/manifest.js

@@ -0,0 +1,14 @@
+// packages/skills/src/registry/manifest.ts
+import path from "node:path";
+const MANIFEST_FILE = "skills.json";
+/**
+ * Path of a target's `skills.json`, which sits beside its install directory:
+ * `.claude/skills` → `.claude/skills.json`.
+ *
+ * @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;;;;;;GAMG;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

@@ -0,0 +1,14 @@
+import type { ReadContext } from "@g3nomaly/core/installer";
+import type { SkillMeta } from "./types";
+export declare const SKILL_FILE = "SKILL.md";
+/**
+ * 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.
+ *
+ * @param skillDir - Absolute skill folder inside a source checkout
+ * @param context - Origin to record, the plugin as group, and the plugin's version
+ * @throws when the folder holds no SKILL.md or its frontmatter is invalid
+ */
+export declare function readSkillDir(skillDir: string, context: ReadContext): 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,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,OAAO,KAAK,EAA4B,SAAS,EAAE,MAAM,SAAS,CAAC;AAEnE,eAAO,MAAM,UAAU,aAAa,CAAC;AAiBrC;;;;;;;;GAQG;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

@@ -0,0 +1,54 @@
+// 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 { 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(),
+    /** `<key>` or `<key>@<source>` of skills this one needs installed beside it */
+    registryDependencies: z.array(z.string().min(1)).optional(),
+});
+/** Kind of a file by its path inside the skill: `SKILL.md`, an agent file, a hook, or a reference. */
+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";
+}
+/**
+ * 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.
+ *
+ * @param skillDir - Absolute skill folder inside a source checkout
+ * @param context - Origin to record, the plugin as group, and the plugin's version
+ * @throws when the folder holds no SKILL.md or its frontmatter is invalid
+ */
+export async function readSkillDir(skillDir, context) {
+    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 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: context.version,
+            group: context.group,
+            registryDependencies: frontmatter.registryDependencies,
+            origin: context.origin,
+            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":"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,+EAA+E;IAC/E,oBAAoB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CAC5D,CAAC,CAAC;AAEH,sGAAsG;AACtG,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;;;;;;;;GAQG;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,9 @@
+import type { ReadSource } from "@g3nomaly/core/installer";
+import type { SkillMeta } from "./types";
+/**
+ * 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.
+ */
+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;;;;GAIG;AACH,eAAO,MAAM,eAAe,EAAE,UAAU,CAAC,SAAS,CAmBjD,CAAC"}

package/dist/registry/readSource.js

@@ -0,0 +1,30 @@
+// 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";
+/**
+ * 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.
+ */
+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;;;;GAIG;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

@@ -0,0 +1,53 @@
+import { z } from "zod";
+export declare const SkillFileTypeSchema: z.ZodEnum<{
+    agent: "agent";
+    hook: "hook";
+    reference: "reference";
+    skill: "skill";
+}>;
+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";
+    }>;
+}, z.core.$strip>;
+export type SkillFile = z.infer<typeof SkillFileSchema>;
+/**
+ * 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>;
+    group: z.ZodString;
+    registryDependencies: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    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";
+        }>;
+    }, 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;AAIxB,eAAO,MAAM,mBAAmB;;;;;EAAkD,CAAC;AAEnF,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,0FAA0F;AAC1F,eAAO,MAAM,eAAe;;;;;;;;;;iBAE1B,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD;;;;GAIG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;iBAS1B,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,25 @@
+// packages/skills/src/registry/types.ts
+import { z } from "zod";
+import { BaseFileEntrySchema } from "@g3nomaly/core/registry";
+import { OriginEntrySchema } from "@g3nomaly/core/installer";
+export const SkillFileTypeSchema = z.enum(["skill", "agent", "hook", "reference"]);
+/** One file of a skill; `path` is `<skill>/<file>`, relative to the install directory. */
+export const SkillFileSchema = BaseFileEntrySchema.extend({
+    type: SkillFileTypeSchema,
+});
+/**
+ * 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 const SkillMetaSchema = OriginEntrySchema.extend({
+    /** Plugin the skill ships in, e.g. `speech` */
+    group: z.string().min(1),
+    /**
+     * Skills this one needs installed beside it. As read from a source these
+     * are `<key>` or `<key>@<source>`; once installed, the resolved keys.
+     */
+    registryDependencies: z.array(z.string().min(1)).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;AACxB,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC;AAInF,0FAA0F;AAC1F,MAAM,CAAC,MAAM,eAAe,GAAG,mBAAmB,CAAC,MAAM,CAAC;IACxD,IAAI,EAAE,mBAAmB;CAC1B,CAAC,CAAC;AAIH;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,iBAAiB,CAAC,MAAM,CAAC;IACtD,+CAA+C;IAC/C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB;;;OAGG;IACH,oBAAoB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC3D,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;CACvC,CAAC,CAAC"}

package/dist/sources/builtins.d.ts

@@ -0,0 +1,4 @@
+import type { SourceRecord } from "@g3nomaly/core/sources";
+/** Sources every project has without registering them; they cannot be removed. */
+export declare const BUILTIN_SOURCES: SourceRecord;
+//# sourceMappingURL=builtins.d.ts.map