@g3nomaly/mods 0.0.0-stage → 0.1.1

package/dist/cli/index.js

@@ -0,0 +1,100 @@
+#!/usr/bin/env bun
+// packages/mods/src/cli/index.ts
+import { Command } from "commander";
+import { readPackageMeta, warnIfOutdated } from "@g3nomaly/core/utils";
+import { ViewerLocationSchema } from "../viewer";
+import { addCommand } from "./commands/add";
+import { initCommand } from "./commands/init";
+import { lsCommand } from "./commands/ls";
+import { removeCommand } from "./commands/remove";
+import { sourceAddCommand, sourceLsCommand, sourceRemoveCommand } from "./commands/source";
+import { updateCommand } from "./commands/update";
+/**
+ * @brief Maps the `--user` flag to a scope, so every command can work on `~/.claude/`.
+ *
+ * @param opts - Parsed options holding the `--user` flag.
+ * @returns `user` when the flag is set, `project` otherwise.
+ */
+function scopeOf(opts) {
+    return opts.user === true ? "user" : "project";
+}
+const program = new Command()
+    .name("g3n-mods")
+    .description("Install Claude Code mods from registered sources");
+program
+    .command("init")
+    .description("Create mods.json and set up VS Code to show mods")
+    .option("-u, --user", "Work on ~/.claude/ for every project")
+    .option("--location <where>", "Where Claude opens in VS Code: panel (an editor tab) or sidebar")
+    .action((opts) => {
+    const location = opts.location === undefined ? undefined : ViewerLocationSchema.parse(opts.location);
+    initCommand({ scope: scopeOf(opts), location });
+});
+program
+    .command("ls")
+    .description("List the mods the registered sources provide")
+    .option("-u, --user", "Work on ~/.claude/ for every project")
+    .option("-i, --installed", "List installed mods instead")
+    .option("-s, --source <name>", "Only this source")
+    .option("--json", "Output as JSON")
+    .action(async (opts) => {
+    await lsCommand({ scope: scopeOf(opts), installed: opts.installed, source: opts.source, json: opts.json });
+});
+program
+    .command("add [mods...]")
+    .description("Install mods, or every mod of a source")
+    .option("-u, --user", "Work on ~/.claude/ for every project")
+    .option("-s, --source <name>", "Only read this source")
+    .option("-f, --force", "Overwrite locally modified files")
+    .action(async (mods, opts) => {
+    await addCommand(mods, { scope: scopeOf(opts), source: opts.source, force: opts.force });
+});
+program
+    .command("update [mods...]")
+    .description("Re-install installed mods from their sources")
+    .option("-u, --user", "Work on ~/.claude/ for every project")
+    .option("-f, --force", "Overwrite locally modified files without prompting")
+    .option("--dry-run", "Report what would change without writing")
+    .action(async (mods, opts) => {
+    await updateCommand(mods, { scope: scopeOf(opts), force: opts.force, dryRun: opts.dryRun });
+});
+program
+    .command("remove [mods...]")
+    .description("Remove installed mods")
+    .option("-u, --user", "Work on ~/.claude/ for every project")
+    .option("-f, --force", "Remove even if files have been modified")
+    .action(async (mods, opts) => {
+    await removeCommand(mods, { scope: scopeOf(opts), force: opts.force });
+});
+const source = program
+    .command("source")
+    .description("Register, list and unregister mod sources");
+source
+    .command("add <source>")
+    .description("Register a git URL, owner/repo, npm package (npm:<pkg>, @scope/pkg) or local folder")
+    .option("-u, --user", "Work on ~/.claude/ for every project")
+    .option("-n, --name <name>", "Name to register it under")
+    .option("-r, --ref <ref>", "Branch or tag of a git source")
+    .action(async (input, opts) => {
+    await sourceAddCommand(input, { scope: scopeOf(opts), name: opts.name, ref: opts.ref });
+});
+source
+    .command("ls")
+    .description("List built-in and registered sources")
+    .option("-u, --user", "Work on ~/.claude/ for every project")
+    .option("--json", "Output as JSON")
+    .action((opts) => {
+    sourceLsCommand({ scope: scopeOf(opts), json: opts.json });
+});
+source
+    .command("remove <name>")
+    .description("Unregister a source")
+    .option("-u, --user", "Work on ~/.claude/ for every project")
+    .option("-f, --force", "Unregister even while installed mods come from it")
+    .action((name, opts) => {
+    sourceRemoveCommand(name, { scope: scopeOf(opts), force: opts.force });
+});
+const self = readPackageMeta(import.meta.url);
+await warnIfOutdated(self.name, self.version, import.meta.url);
+await 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/cli/project.d.ts

@@ -0,0 +1,72 @@
+import { z } from "zod";
+import { resolveProjectRoot } from "@g3nomaly/core/config";
+import type { InstallCommandContext, ManifestTarget } from "@g3nomaly/core/cli";
+import type { SourceRegistry } from "@g3nomaly/core/installer";
+import type { RegisteredSource } from "@g3nomaly/core/sources";
+import type { ModMeta, ModRegistry } from "../registry/types";
+/** `project` installs into the repository's `.claude/`, `user` into `~/.claude/` for every project. */
+export declare const ScopeSchema: z.ZodEnum<{
+    project: "project";
+    user: "user";
+}>;
+/** Install scope, one of the values of `ScopeSchema`. */
+export type Scope = z.infer<typeof ScopeSchema>;
+/**
+ * Install scope opened for one command: where mods go, the `mods.json` that
+ * records them, and the root that sources resolve against. Created by
+ * `openModProject`.
+ *
+ * @property scope - Scope the project was opened for.
+ * @property projectRoot - Absolute root for local source paths and the `node_modules` lookup: the git project, or home for `user` outside one.
+ * @property claudeDir - Absolute `.claude/` directory of the scope.
+ * @property target - The one install destination with the `mods.json` that backs it.
+ */
+export interface ModProject {
+    scope: Scope;
+    projectRoot: string;
+    claudeDir: string;
+    target: ManifestTarget;
+}
+/**
+ * Overrides for the project lookup, used by tests.
+ *
+ * @property resolveProjectRoot - Replaces git discovery of the project root.
+ * @property home - Home folder for the `user` scope, instead of `os.homedir()`.
+ */
+export interface ProjectDeps {
+    resolveProjectRoot?: typeof resolveProjectRoot;
+    home?: string;
+}
+/**
+ * @brief Opens the scope's `.claude/` directory and its `mods.json`. Exits with an
+ * error when the project scope is asked for outside a git repository.
+ *
+ * @param scope - Scope to open.
+ * @param deps - Overrides for the project lookup, used by tests.
+ * @returns The opened project.
+ */
+export declare function openModProject(scope: Scope, deps?: ProjectDeps): ModProject;
+/**
+ * @brief Lists the sources of a scope: built-in ones first, then those registered in its `mods.json`.
+ *
+ * @param project - Scope to list sources for.
+ */
+export declare function modSources(project: ModProject): RegisteredSource[];
+/** What the core install and source commands print and check for mods. */
+export declare const MOD_CONTEXT: InstallCommandContext<ModMeta>;
+/**
+ * @brief Reads the mods installed in the scope.
+ *
+ * @param project - Scope to read.
+ */
+export declare function installedMods(project: ModProject): ModRegistry;
+/**
+ * @brief Reads every mod the scope's sources provide, or only those of `only`, and
+ * prints each warning. The caller disposes the result when done.
+ *
+ * @param project - Scope to read sources for.
+ * @param only - Source name to read alone; exits when no such source is registered.
+ * @returns Registry of the mods read.
+ */
+export declare function openModRegistry(project: ModProject, only?: string): Promise<SourceRegistry<ModMeta>>;
+//# sourceMappingURL=project.d.ts.map

package/dist/cli/project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../src/cli/project.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAE3D,OAAO,KAAK,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEhF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAI/D,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAG9D,uGAAuG;AACvG,eAAO,MAAM,WAAW;;;EAA8B,CAAC;AAEvD,yDAAyD;AACzD,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAKhD;;;;;;;;;GASG;AACH,MAAM,WAAW,UAAU;IACzB,KAAK,EAAQ,KAAK,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAI,MAAM,CAAC;IACpB,MAAM,EAAO,cAAc,CAAC;CAC7B;AAED;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,kBAAkB,CAAC,EAAE,OAAO,kBAAkB,CAAC;IAC/C,IAAI,CAAC,EAAgB,MAAM,CAAC;CAC7B;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,GAAE,WAAgB,GAAG,UAAU,CAiB/E;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,UAAU,GAAG,gBAAgB,EAAE,CAElE;AAED,0EAA0E;AAC1E,eAAO,MAAM,WAAW,EAAE,qBAAqB,CAAC,OAAO,CAAgE,CAAC;AAExH;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,UAAU,GAAG,WAAW,CAE9D;AAED;;;;;;;GAOG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAI1G"}

package/dist/cli/project.js

@@ -0,0 +1,72 @@
+// packages/mods/src/cli/project.ts
+import os from "node:os";
+import path from "node:path";
+import { z } from "zod";
+import { resolveProjectRoot } from "@g3nomaly/core/config";
+import { lineError, narrowSources, orExit, reportSourceRegistry } from "@g3nomaly/core/cli";
+import { installedEntries, loadInstallManifest, loadSourceRegistry, manifestSources } from "@g3nomaly/core/installer";
+import { modsManifestPath } from "../registry/manifest";
+import { readModSource } from "../registry/readSource";
+import { ModMetaSchema } from "../registry/types";
+import { BUILTIN_SOURCES } from "../sources/builtins";
+/** `project` installs into the repository's `.claude/`, `user` into `~/.claude/` for every project. */
+export const ScopeSchema = z.enum(["project", "user"]);
+/** Folder under `.claude/` that Claude Code auto-loads plugins from, as `<name>@skills-dir`. */
+const INSTALL_DIR = "skills";
+/**
+ * @brief Opens the scope's `.claude/` directory and its `mods.json`. Exits with an
+ * error when the project scope is asked for outside a git repository.
+ *
+ * @param scope - Scope to open.
+ * @param deps - Overrides for the project lookup, used by tests.
+ * @returns The opened project.
+ */
+export function openModProject(scope, deps = {}) {
+    const home = deps.home ?? os.homedir();
+    const found = (deps.resolveProjectRoot ?? resolveProjectRoot)();
+    if (scope === "project" && found === null) {
+        console.error(lineError("No project found — run g3n-mods inside a git repository, or pass --user to install for every project."));
+        process.exit(1);
+    }
+    const projectRoot = found ?? home;
+    const claudeDir = path.join(scope === "user" ? home : projectRoot, ".claude");
+    const manifest = orExit(() => loadInstallManifest(modsManifestPath(claudeDir), ModMetaSchema));
+    return {
+        scope,
+        projectRoot,
+        claudeDir,
+        target: { label: scope, installDir: path.join(claudeDir, INSTALL_DIR), store: manifest.store, manifest },
+    };
+}
+/**
+ * @brief Lists the sources of a scope: built-in ones first, then those registered in its `mods.json`.
+ *
+ * @param project - Scope to list sources for.
+ */
+export function modSources(project) {
+    return manifestSources([project.target.manifest], BUILTIN_SOURCES);
+}
+/** What the core install and source commands print and check for mods. */
+export const MOD_CONTEXT = { bin: "g3n-mods", noun: "mod", entrySchema: ModMetaSchema };
+/**
+ * @brief Reads the mods installed in the scope.
+ *
+ * @param project - Scope to read.
+ */
+export function installedMods(project) {
+    return installedEntries(project.target.manifest, ModMetaSchema);
+}
+/**
+ * @brief Reads every mod the scope's sources provide, or only those of `only`, and
+ * prints each warning. The caller disposes the result when done.
+ *
+ * @param project - Scope to read sources for.
+ * @param only - Source name to read alone; exits when no such source is registered.
+ * @returns Registry of the mods read.
+ */
+export async function openModRegistry(project, only) {
+    const registry = await loadSourceRegistry(narrowSources(modSources(project), only, "g3n-mods"), project.projectRoot, readModSource);
+    reportSourceRegistry(registry);
+    return registry;
+}
+//# sourceMappingURL=project.js.map

package/dist/cli/project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.js","sourceRoot":"","sources":["../../src/cli/project.ts"],"names":[],"mappings":"AAAA,mCAAmC;AACnC,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE5F,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAGtH,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD,uGAAuG;AACvG,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;AAKvD,gGAAgG;AAChG,MAAM,WAAW,GAAG,QAAQ,CAAC;AA8B7B;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAAC,KAAY,EAAE,IAAI,GAAgB,EAAE;IACjE,MAAM,IAAI,GAAI,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC;IACxC,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,kBAAkB,IAAI,kBAAkB,CAAC,EAAE,CAAC;IAChE,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAC1C,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,uGAAuG,CAAC,CAAC,CAAC;QAClI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,WAAW,GAAG,KAAK,IAAI,IAAI,CAAC;IAClC,MAAM,SAAS,GAAK,IAAI,CAAC,IAAI,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;IAChF,MAAM,QAAQ,GAAM,MAAM,CAAC,GAAG,EAAE,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,SAAS,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC;IAClG,OAAO;QACL,KAAK;QACL,WAAW;QACX,SAAS;QACT,MAAM,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,QAAQ,EAAE;KACzG,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,OAAmB;IAC5C,OAAO,eAAe,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,eAAe,CAAC,CAAC;AACrE,CAAC;AAED,0EAA0E;AAC1E,MAAM,CAAC,MAAM,WAAW,GAAmC,EAAE,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,CAAC;AAExH;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,OAAmB;IAC/C,OAAO,gBAAgB,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;AAClE,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,OAAmB,EAAE,IAAa;IACtE,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CAAC,aAAa,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,UAAU,CAAC,EAAE,OAAO,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;IACpI,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAC/B,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/cli/viewer.d.ts

@@ -0,0 +1,12 @@
+import type { ViewerLocation } from "../viewer";
+import type { ModProject } from "./project";
+/**
+ * @brief Sets up where mods are seen and prints what it found: the project's VS
+ * Code settings (project scope only) and the installed extension's version
+ * against the one the mod API needs.
+ *
+ * @param project - Scope to set up; VS Code settings are written only for `project`.
+ * @param location - Where Claude opens; when absent, a location already set is kept.
+ */
+export declare function setUpViewer(project: ModProject, location?: ViewerLocation): void;
+//# sourceMappingURL=viewer.d.ts.map

package/dist/cli/viewer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewer.d.ts","sourceRoot":"","sources":["../../src/cli/viewer.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAE5C;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,cAAc,GAAG,IAAI,CAkBhF"}

package/dist/cli/viewer.js

@@ -0,0 +1,33 @@
+// packages/mods/src/cli/viewer.ts
+import { c, lineInfo, lineSuccess, lineWarn } from "@g3nomaly/core/cli";
+import { MIN_ENGINE_VERSION, compareVersions, configureViewer, findClaudeExtension } from "../viewer";
+/**
+ * @brief Sets up where mods are seen and prints what it found: the project's VS
+ * Code settings (project scope only) and the installed extension's version
+ * against the one the mod API needs.
+ *
+ * @param project - Scope to set up; VS Code settings are written only for `project`.
+ * @param location - Where Claude opens; when absent, a location already set is kept.
+ */
+export function setUpViewer(project, location) {
+    if (project.scope === "project") {
+        const result = configureViewer(project.projectRoot, location);
+        if (result.kind === "written") {
+            console.log(lineSuccess(`VS Code opens Claude in its native UI ${c.dim(`(${c.file(result.file)})`)}`));
+        }
+        else if (result.kind === "unreadable") {
+            console.log(lineWarn(`${c.file(result.file)} is not plain JSON — add these settings by hand: ${JSON.stringify(result.settings)}`));
+        }
+    }
+    const extension = findClaudeExtension();
+    if (extension === null) {
+        console.log(lineWarn(`Claude Code for VS Code is not installed — mods draw in its native UI. Install it from the marketplace (anthropic.claude-code), ${MIN_ENGINE_VERSION} or newer.`));
+    }
+    else if (compareVersions(extension.version, MIN_ENGINE_VERSION) < 0) {
+        console.log(lineWarn(`Claude Code for VS Code is ${extension.version}; mods need ${MIN_ENGINE_VERSION} or newer. Update the extension.`));
+    }
+    else {
+        console.log(lineInfo(`Claude Code for VS Code ${extension.version} draws mod panes. Run ${c.cmd("Claude Code: Open in New Window")} to give them a window of their own.`));
+    }
+}
+//# sourceMappingURL=viewer.js.map

package/dist/cli/viewer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewer.js","sourceRoot":"","sources":["../../src/cli/viewer.ts"],"names":[],"mappings":"AAAA,kCAAkC;AAClC,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACxE,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAItG;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW,CAAC,OAAmB,EAAE,QAAyB;IACxE,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAChC,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;QAC9D,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC9B,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,yCAAyC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;QACzG,CAAC;aAAM,IAAI,MAAM,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YACxC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,oDAAoD,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;QACrI,CAAC;IACH,CAAC;IAED,MAAM,SAAS,GAAG,mBAAmB,EAAE,CAAC;IACxC,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;QACvB,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,mIAAmI,kBAAkB,YAAY,CAAC,CAAC,CAAC;IAC3L,CAAC;SAAM,IAAI,eAAe,CAAC,SAAS,CAAC,OAAO,EAAE,kBAAkB,CAAC,GAAG,CAAC,EAAE,CAAC;QACtE,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,8BAA8B,SAAS,CAAC,OAAO,eAAe,kBAAkB,kCAAkC,CAAC,CAAC,CAAC;IAC5I,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,2BAA2B,SAAS,CAAC,OAAO,yBAAyB,CAAC,CAAC,GAAG,CAAC,iCAAiC,CAAC,sCAAsC,CAAC,CAAC,CAAC;IAC7K,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./registry";
+export * from "./sources";
+export * from "./viewer";
+//# 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,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+// packages/mods/src/index.ts
+export * from "./registry";
+export * from "./sources";
+export * from "./viewer";
+//# 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,6BAA6B;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC"}

package/dist/registry/index.d.ts

@@ -0,0 +1,7 @@
+export * from "./types";
+export { isModDir, readModDir, PLUGIN_MANIFEST, HOOKS_MANIFEST } from "./readModDir";
+export { locateMods } from "./locate";
+export type { ModScan } from "./locate";
+export { readModSource } from "./readSource";
+export { modsManifestPath } 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,QAAQ,EAAE,UAAU,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACrF,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,YAAY,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC"}

package/dist/registry/index.js

@@ -0,0 +1,7 @@
+// packages/mods/src/registry/index.ts
+export * from "./types";
+export { isModDir, readModDir, PLUGIN_MANIFEST, HOOKS_MANIFEST } from "./readModDir";
+export { locateMods } from "./locate";
+export { readModSource } from "./readSource";
+export { modsManifestPath } 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,sCAAsC;AACtC,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACrF,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEtC,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC"}

package/dist/registry/locate.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Mod folders found in one source checkout, and what was skipped.
+ *
+ * @property dirs - Absolute mod folders.
+ * @property warnings - Why each skipped plugin or folder was left out.
+ */
+export interface ModScan {
+    dirs: string[];
+    warnings: string[];
+}
+/**
+ * @brief Finds the mods a source provides. A `marketplace.json` lists them by
+ * relative path; without one, the source root is the mod when it is one,
+ * else every mod folder directly under `mods/` or the root. Plugins that
+ * hold no hooks module are skipped with a warning.
+ *
+ * @param root - Absolute root of the source checkout.
+ * @returns Mod folders, and warnings for what was skipped.
+ */
+export declare function locateMods(root: string): ModScan;
+//# 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":"AAQA;;;;;GAKG;AACH,MAAM,WAAW,OAAO;IACtB,IAAI,EAAM,MAAM,EAAE,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAUD;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAgBhD"}

package/dist/registry/locate.js

@@ -0,0 +1,42 @@
+// packages/mods/src/registry/locate.ts
+import fs from "node:fs";
+import path from "node:path";
+import { readMarketplace } from "@g3nomaly/core/installer";
+import { isModDir } from "./readModDir";
+const MODS_DIR = "mods";
+/** Lists the direct child folders of `dir`, leaving out hidden ones and `node_modules`. */
+function childDirs(dir) {
+    if (!fs.existsSync(dir))
+        return [];
+    return fs.readdirSync(dir, { withFileTypes: true })
+        .filter((d) => d.isDirectory() && !d.name.startsWith(".") && d.name !== "node_modules")
+        .map((d) => path.join(dir, d.name));
+}
+/**
+ * @brief Finds the mods a source provides. A `marketplace.json` lists them by
+ * relative path; without one, the source root is the mod when it is one,
+ * else every mod folder directly under `mods/` or the root. Plugins that
+ * hold no hooks module are skipped with a warning.
+ *
+ * @param root - Absolute root of the source checkout.
+ * @returns Mod folders, and warnings for what was skipped.
+ */
+export function locateMods(root) {
+    const marketplace = readMarketplace(root);
+    if (marketplace !== null) {
+        const warnings = [...marketplace.warnings];
+        const dirs = [];
+        for (const plugin of marketplace.plugins) {
+            if (isModDir(plugin.dir))
+                dirs.push(plugin.dir);
+            else
+                warnings.push(`${plugin.name}: a plugin without a hooks module, not a mod, skipped`);
+        }
+        return { dirs: dirs.sort(), warnings };
+    }
+    if (isModDir(root))
+        return { dirs: [root], warnings: [] };
+    const dirs = [...childDirs(path.join(root, MODS_DIR)), ...childDirs(root)].filter(isModDir);
+    return { dirs: [...new Set(dirs)].sort(), 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,uCAAuC;AACvC,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAExC,MAAM,QAAQ,GAAG,MAAM,CAAC;AAaxB,2FAA2F;AAC3F,SAAS,SAAS,CAAC,GAAW;IAC5B,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IACnC,OAAO,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;SAChD,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,cAAc,CAAC;SACtF,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AACxC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,MAAM,WAAW,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IAC1C,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,CAAC,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;QAC3C,MAAM,IAAI,GAAa,EAAE,CAAC;QAC1B,KAAK,MAAM,MAAM,IAAI,WAAW,CAAC,OAAO,EAAE,CAAC;YACzC,IAAI,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC;gBAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;;gBAC3C,QAAQ,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,IAAI,uDAAuD,CAAC,CAAC;QAC5F,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,CAAC;IACzC,CAAC;IAED,IAAI,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;IAE1D,MAAM,IAAI,GAAG,CAAC,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,EAAE,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC5F,OAAO,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;AAC3D,CAAC"}

package/dist/registry/manifest.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @brief Builds the path of `mods.json` in a Claude directory.
+ *
+ * @param claudeDir - Absolute `.claude` directory of the scope, e.g. `/home/me/app/.claude`
+ * @returns Absolute path of the file.
+ */
+export declare function modsManifestPath(claudeDir: 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;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE1D"}

package/dist/registry/manifest.js

@@ -0,0 +1,13 @@
+// packages/mods/src/registry/manifest.ts
+import path from "node:path";
+const MANIFEST_FILE = "mods.json";
+/**
+ * @brief Builds the path of `mods.json` in a Claude directory.
+ *
+ * @param claudeDir - Absolute `.claude` directory of the scope, e.g. `/home/me/app/.claude`
+ * @returns Absolute path of the file.
+ */
+export function modsManifestPath(claudeDir) {
+    return path.join(claudeDir, 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,yCAAyC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,aAAa,GAAG,WAAW,CAAC;AAElC;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,SAAiB;IAChD,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;AAC7C,CAAC"}

package/dist/registry/readModDir.d.ts

@@ -0,0 +1,20 @@
+import type { ReadContext } from "@g3nomaly/core/installer";
+import type { ModMeta } from "./types";
+export declare const PLUGIN_MANIFEST: string;
+export declare const HOOKS_MANIFEST: string;
+/** Tells whether `dir` holds the plugin and hooks manifests a mod needs; `readModDir` checks the rest. */
+export declare function isModDir(dir: string): boolean;
+/**
+ * @brief Reads one mod folder into its registry entry. The key is the folder name,
+ * which must equal the `name` in its `plugin.json`, the name Claude Code
+ * loads it under; every installable file becomes a `files[]` entry at
+ * `<key>/<file>`.
+ *
+ * @param modDir - Absolute mod folder inside a source checkout
+ * @param context - Origin to record, the source as group, and the version to fall back on
+ * @throws when the folder is not a mod, its manifests are invalid, its name
+ *   differs from its folder, its hooks module is not TypeScript, or it holds
+ *   any JavaScript file
+ */
+export declare function readModDir(modDir: string, context: ReadContext): Promise<[string, ModMeta]>;
+//# sourceMappingURL=readModDir.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"readModDir.d.ts","sourceRoot":"","sources":["../../src/registry/readModDir.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAwB,OAAO,EAAE,MAAM,SAAS,CAAC;AAE7D,eAAO,MAAM,eAAe,QAA6C,CAAC;AAC1E,eAAO,MAAM,cAAc,QAAoC,CAAC;AAsBhE,0GAA0G;AAC1G,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE7C;AAgBD;;;;;;;;;;;GAWG;AACH,wBAAsB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA8BjG"}

package/dist/registry/readModDir.js

@@ -0,0 +1,84 @@
+// packages/mods/src/registry/readModDir.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";
+export const PLUGIN_MANIFEST = path.join(".claude-plugin", "plugin.json");
+export const HOOKS_MANIFEST = path.join("hooks", "hooks.json");
+/** Folders and files a mod folder may hold that are never installed: tests, the engine's type output, build state. */
+const SKIPPED_DIRS = ["tests", path.join(".claude-plugin", "types")];
+const SKIPPED_FILES = /(\.test\.tsx?$)|(^tsconfig\.json$)|(^\.DS_Store$)/;
+const PluginManifestSchema = z.object({
+    name: z.string().regex(/^[a-z0-9][a-z0-9-]*$/, "use lowercase letters, digits and `-`"),
+    version: z.string().min(1).optional(),
+    description: z.string().optional(),
+});
+/** JavaScript in any form; a mod holding one is refused. */
+const JAVASCRIPT_FILE = /\.(?:js|mjs|cjs|jsx)$/i;
+/** Hooks modules are TypeScript only. */
+const TYPESCRIPT_MODULE = /\.(?:ts|tsx|mts|cts)$/i;
+const HooksManifestSchema = z.object({
+    modules: z.array(z.string().regex(TYPESCRIPT_MODULE, "must be a TypeScript file (.ts, .tsx, .mts, .cts)")).min(1),
+});
+/** Tells whether `dir` holds the plugin and hooks manifests a mod needs; `readModDir` checks the rest. */
+export function isModDir(dir) {
+    return fs.existsSync(path.join(dir, PLUGIN_MANIFEST)) && fs.existsSync(path.join(dir, HOOKS_MANIFEST));
+}
+/**
+ * @brief Classifies a file by the top folder it sits in inside the mod.
+ *
+ * @param relativeToMod - File path relative to the mod folder.
+ * @returns Kind of the file; `asset` for anything outside the known folders.
+ */
+function fileType(relativeToMod) {
+    const [top] = relativeToMod.split(path.sep);
+    if (top === ".claude-plugin")
+        return "manifest";
+    if (top === "hooks")
+        return "hooks";
+    if (top === "types")
+        return "types";
+    return "asset";
+}
+/**
+ * @brief Reads one mod folder into its registry entry. The key is the folder name,
+ * which must equal the `name` in its `plugin.json`, the name Claude Code
+ * loads it under; every installable file becomes a `files[]` entry at
+ * `<key>/<file>`.
+ *
+ * @param modDir - Absolute mod folder inside a source checkout
+ * @param context - Origin to record, the source as group, and the version to fall back on
+ * @throws when the folder is not a mod, its manifests are invalid, its name
+ *   differs from its folder, its hooks module is not TypeScript, or it holds
+ *   any JavaScript file
+ */
+export async function readModDir(modDir, context) {
+    if (!isModDir(modDir)) {
+        throw new Error(`${modDir} is not a mod: it needs ${PLUGIN_MANIFEST} and ${HOOKS_MANIFEST}`);
+    }
+    const manifest = PluginManifestSchema.parse(JSON.parse(fs.readFileSync(path.join(modDir, PLUGIN_MANIFEST), "utf8")));
+    HooksManifestSchema.parse(JSON.parse(fs.readFileSync(path.join(modDir, HOOKS_MANIFEST), "utf8")));
+    const key = path.basename(modDir);
+    if (manifest.name !== key) {
+        throw new Error(`plugin.json names it "${manifest.name}", but its folder is "${key}"; they must match`);
+    }
+    const rels = listFiles(modDir, { skipDirs: SKIPPED_DIRS, skipFiles: SKIPPED_FILES });
+    const javascript = rels.filter((rel) => JAVASCRIPT_FILE.test(rel));
+    if (javascript.length > 0) {
+        throw new Error(`holds JavaScript (${javascript.join(", ")}); mods are TypeScript only`);
+    }
+    const files = [];
+    for (const rel of rels) {
+        files.push({ path: path.join(key, rel), type: fileType(rel), hash: await hashFile(path.join(modDir, rel)) });
+    }
+    return [key, {
+            name: manifest.name,
+            description: manifest.description,
+            version: manifest.version ?? context.version,
+            group: context.group,
+            origin: context.origin,
+            files,
+        }];
+}
+//# sourceMappingURL=readModDir.js.map

package/dist/registry/readModDir.js.map

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

package/dist/registry/readSource.d.ts

@@ -0,0 +1,9 @@
+import type { ReadSource } from "@g3nomaly/core/installer";
+import type { ModMeta } from "./types";
+/**
+ * @brief Reads every mod a checked-out source provides, with the source as group.
+ * An unreadable mod is skipped with a warning. Handed to
+ * `loadSourceRegistry` by every mods command.
+ */
+export declare const readModSource: ReadSource<ModMeta>;
+//# 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,OAAO,EAAE,MAAM,SAAS,CAAC;AAEvC;;;;GAIG;AACH,eAAO,MAAM,aAAa,EAAE,UAAU,CAAC,OAAO,CAgB7C,CAAC"}