@g3nomaly/mods 0.0.0-stage → 0.1.0

package/dist/cli/project.d.ts

@@ -0,0 +1,49 @@
+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";
+}>;
+export type Scope = z.infer<typeof ScopeSchema>;
+/**
+ * One install scope opened for a command: where mods go, the `mods.json`
+ * that records them, and the root that sources resolve against.
+ */
+export interface ModProject {
+    scope: Scope;
+    /** Absolute root for local source paths and the `node_modules` lookup: the git project, or home for `user` outside one */
+    projectRoot: string;
+    /** Absolute `.claude/` directory of the scope */
+    claudeDir: string;
+    /** The one install destination with the `mods.json` that backs it */
+    target: ManifestTarget;
+}
+/** Injection point for tests; the real project root comes from git discovery. */
+export interface ProjectDeps {
+    resolveProjectRoot?: typeof resolveProjectRoot;
+    home?: string;
+}
+/**
+ * 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.
+ */
+export declare function openModProject(scope: Scope, deps?: ProjectDeps): ModProject;
+/** Built-in sources first, then the ones registered in this scope's `mods.json`. */
+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>;
+/** Installed mods of the scope. */
+export declare function installedMods(project: ModProject): ModRegistry;
+/**
+ * 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 only - Source name to read alone; exits when no such source is registered
+ */
+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,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAKhD;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,KAAK,EAAQ,KAAK,CAAC;IACnB,0HAA0H;IAC1H,WAAW,EAAE,MAAM,CAAC;IACpB,iDAAiD;IACjD,SAAS,EAAI,MAAM,CAAC;IACpB,qEAAqE;IACrE,MAAM,EAAO,cAAc,CAAC;CAC7B;AAED,iFAAiF;AACjF,MAAM,WAAW,WAAW;IAC1B,kBAAkB,CAAC,EAAE,OAAO,kBAAkB,CAAC;IAC/C,IAAI,CAAC,EAAgB,MAAM,CAAC;CAC7B;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,GAAE,WAAgB,GAAG,UAAU,CAiB/E;AAED,oFAAoF;AACpF,wBAAgB,UAAU,CAAC,OAAO,EAAE,UAAU,GAAG,gBAAgB,EAAE,CAElE;AAED,0EAA0E;AAC1E,eAAO,MAAM,WAAW,EAAE,qBAAqB,CAAC,OAAO,CAAgE,CAAC;AAExH,mCAAmC;AACnC,wBAAgB,aAAa,CAAC,OAAO,EAAE,UAAU,GAAG,WAAW,CAE9D;AAED;;;;;GAKG;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,58 @@
+// 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";
+/**
+ * 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.
+ */
+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 },
+    };
+}
+/** Built-in sources first, then the ones registered in this scope's `mods.json`. */
+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 };
+/** Installed mods of the scope. */
+export function installedMods(project) {
+    return installedEntries(project.target.manifest, ModMetaSchema);
+}
+/**
+ * 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 only - Source name to read alone; exits when no such source is registered
+ */
+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":"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"}

package/dist/cli/viewer.d.ts

@@ -0,0 +1,11 @@
+import type { ViewerLocation } from "../viewer";
+import type { ModProject } from "./project";
+/**
+ * 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 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;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,cAAc,GAAG,IAAI,CAkBhF"}

package/dist/cli/viewer.js

@@ -0,0 +1,32 @@
+// packages/mods/src/cli/viewer.ts
+import { c, lineInfo, lineSuccess, lineWarn } from "@g3nomaly/core/cli";
+import { MIN_ENGINE_VERSION, compareVersions, configureViewer, findClaudeExtension } from "../viewer";
+/**
+ * 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 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;;;;;;GAMG;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,16 @@
+/** The mod folders found in one source checkout, with what was skipped and why. */
+export interface ModScan {
+    /** Absolute mod folders */
+    dirs: string[];
+    warnings: string[];
+}
+/**
+ * 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
+ */
+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,mFAAmF;AACnF,MAAM,WAAW,OAAO;IACtB,2BAA2B;IAC3B,IAAI,EAAM,MAAM,EAAE,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAUD;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAgBhD"}

package/dist/registry/locate.js

@@ -0,0 +1,41 @@
+// 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";
+/** 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));
+}
+/**
+ * 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
+ */
+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;AASxB,iFAAiF;AACjF,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;;;;;;;GAOG;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 @@
+/**
+ * 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
+ */
+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";
+/**
+ * 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
+ */
+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;
+/** Whether `dir` is a plugin with a `hooks/hooks.json`, which makes it a mod; `readModDir` checks the rest. */
+export declare function isModDir(dir: string): boolean;
+/**
+ * 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,+GAA+G;AAC/G,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE7C;AAWD;;;;;;;;;;;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,79 @@
+// 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),
+});
+/** Whether `dir` is a plugin with a `hooks/hooks.json`, which makes it a mod; `readModDir` checks the rest. */
+export function isModDir(dir) {
+    return fs.existsSync(path.join(dir, PLUGIN_MANIFEST)) && fs.existsSync(path.join(dir, HOOKS_MANIFEST));
+}
+/** Kind of a file by the folder it sits in inside the mod. */
+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";
+}
+/**
+ * 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";
+/**
+ * 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"}

package/dist/registry/readSource.js

@@ -0,0 +1,27 @@
+// packages/mods/src/registry/readSource.ts
+import path from "node:path";
+import { errorMessage } from "@g3nomaly/core/utils";
+import { locateMods } from "./locate";
+import { readModDir } from "./readModDir";
+/**
+ * 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 const readModSource = async (checkout) => {
+    const { dirs, warnings } = locateMods(checkout.dir);
+    const entries = [];
+    for (const modDir of dirs) {
+        try {
+            entries.push(await readModDir(modDir, {
+                origin: { source: checkout.name, dir: path.relative(checkout.dir, path.dirname(modDir)), commit: checkout.commit, version: checkout.version },
+                group: checkout.name,
+            }));
+        }
+        catch (error) {
+            warnings.push(`skipped ${path.relative(checkout.dir, modDir) || "."}: ${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,2CAA2C;AAC3C,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG1C;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAwB,KAAK,EAAE,QAAQ,EAAE,EAAE;IACnE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IACpD,MAAM,OAAO,GAAwB,EAAE,CAAC;IAExC,KAAK,MAAM,MAAM,IAAI,IAAI,EAAE,CAAC;QAC1B,IAAI,CAAC;YACH,OAAO,CAAC,IAAI,CAAC,MAAM,UAAU,CAAC,MAAM,EAAE;gBACpC,MAAM,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE;gBAC7I,KAAK,EAAG,QAAQ,CAAC,IAAI;aACtB,CAAC,CAAC,CAAC;QACN,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,QAAQ,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,GAAG,KAAK,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACjG,CAAC;IACH,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;AAC/B,CAAC,CAAC"}

package/dist/registry/types.d.ts

@@ -0,0 +1,54 @@
+import { z } from "zod";
+/** What part of a mod a file is: its manifests, its hooks module, its type contract, or anything else it ships. */
+export declare const ModFileTypeSchema: z.ZodEnum<{
+    asset: "asset";
+    hooks: "hooks";
+    manifest: "manifest";
+    types: "types";
+}>;
+export type ModFileType = z.infer<typeof ModFileTypeSchema>;
+/** One installed or installable file of a mod; `path` is `<mod>/<file>`, relative to the install directory. */
+export declare const ModFileSchema: z.ZodObject<{
+    path: z.ZodString;
+    hash: z.ZodOptional<z.ZodString>;
+    version: z.ZodOptional<z.ZodString>;
+    type: z.ZodEnum<{
+        asset: "asset";
+        hooks: "hooks";
+        manifest: "manifest";
+        types: "types";
+    }>;
+}, z.core.$strip>;
+export type ModFile = z.infer<typeof ModFileSchema>;
+/**
+ * One installable mod. Built from a mod folder's `plugin.json` by
+ * `readModDir`, and written per install into `mods.json` by the `add` and
+ * `update` commands. `group` is the source name, so `ls` groups by source.
+ */
+export declare const ModMetaSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    version: z.ZodOptional<z.ZodString>;
+    registryDependencies: z.ZodOptional<z.ZodArray<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;
+    files: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        hash: z.ZodOptional<z.ZodString>;
+        version: z.ZodOptional<z.ZodString>;
+        type: z.ZodEnum<{
+            asset: "asset";
+            hooks: "hooks";
+            manifest: "manifest";
+            types: "types";
+        }>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ModMeta = z.infer<typeof ModMetaSchema>;
+export type ModRegistry = Record<string, ModMeta>;
+//# 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,mHAAmH;AACnH,eAAO,MAAM,iBAAiB;;;;;EAAkD,CAAC;AAEjF,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,+GAA+G;AAC/G,eAAO,MAAM,aAAa;;;;;;;;;;iBAExB,CAAC;AAEH,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAEpD;;;;GAIG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;iBAGxB,CAAC;AAEH,MAAM,MAAM,OAAO,GAAO,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AACxD,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC"}

package/dist/registry/types.js

@@ -0,0 +1,20 @@
+// packages/mods/src/registry/types.ts
+import { z } from "zod";
+import { BaseFileEntrySchema } from "@g3nomaly/core/registry";
+import { OriginEntrySchema } from "@g3nomaly/core/installer";
+/** What part of a mod a file is: its manifests, its hooks module, its type contract, or anything else it ships. */
+export const ModFileTypeSchema = z.enum(["manifest", "hooks", "types", "asset"]);
+/** One installed or installable file of a mod; `path` is `<mod>/<file>`, relative to the install directory. */
+export const ModFileSchema = BaseFileEntrySchema.extend({
+    type: ModFileTypeSchema,
+});
+/**
+ * One installable mod. Built from a mod folder's `plugin.json` by
+ * `readModDir`, and written per install into `mods.json` by the `add` and
+ * `update` commands. `group` is the source name, so `ls` groups by source.
+ */
+export const ModMetaSchema = OriginEntrySchema.extend({
+    group: z.string().min(1),
+    files: z.array(ModFileSchema).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,sCAAsC;AACtC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D,mHAAmH;AACnH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;AAIjF,+GAA+G;AAC/G,MAAM,CAAC,MAAM,aAAa,GAAG,mBAAmB,CAAC,MAAM,CAAC;IACtD,IAAI,EAAE,iBAAiB;CACxB,CAAC,CAAC;AAIH;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,iBAAiB,CAAC,MAAM,CAAC;IACpD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;CACrC,CAAC,CAAC"}

package/dist/sources/builtins.d.ts

@@ -0,0 +1,4 @@
+import type { SourceRecord } from "@g3nomaly/core/sources";
+/** Sources every install scope reads from without registering them; never written to `mods.json` and never removable. */
+export declare const BUILTIN_SOURCES: SourceRecord;
+//# sourceMappingURL=builtins.d.ts.map

package/dist/sources/builtins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtins.d.ts","sourceRoot":"","sources":["../../src/sources/builtins.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE3D,yHAAyH;AACzH,eAAO,MAAM,eAAe,EAAE,YAE7B,CAAC"}

package/dist/sources/builtins.js

@@ -0,0 +1,5 @@
+/** Sources every install scope reads from without registering them; never written to `mods.json` and never removable. */
+export const BUILTIN_SOURCES = {
+    "g3n-mods": { kind: "npm", package: "@g3nomaly/g3n-mods" },
+};
+//# sourceMappingURL=builtins.js.map

package/dist/sources/builtins.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtins.js","sourceRoot":"","sources":["../../src/sources/builtins.ts"],"names":[],"mappings":"AAGA,yHAAyH;AACzH,MAAM,CAAC,MAAM,eAAe,GAAiB;IAC3C,UAAU,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,oBAAoB,EAAE;CAC3D,CAAC"}

package/dist/sources/index.d.ts

@@ -0,0 +1,2 @@
+export { BUILTIN_SOURCES } from "./builtins";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sources/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC"}

package/dist/sources/index.js

@@ -0,0 +1,3 @@
+// packages/mods/src/sources/index.ts
+export { BUILTIN_SOURCES } from "./builtins";
+//# sourceMappingURL=index.js.map

package/dist/sources/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sources/index.ts"],"names":[],"mappings":"AAAA,qCAAqC;AACrC,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC"}