@g3nomaly/mods 0.0.0-stage → 0.1.1

package/LICENSE

@@ -0,0 +1,95 @@
+Copyright (c) 2026 G3NTs - G3nomaly
+
+Elastic License 2.0
+
+URL: https://www.elastic.co/licensing/elastic-license
+
+## Acceptance
+
+By using the software, you agree to all of the terms and conditions below.
+
+## Copyright License
+
+The licensor grants you a non-exclusive, royalty-free, worldwide,
+non-sublicensable, non-transferable license to use, copy, distribute, make
+available, and prepare derivative works of the software, in each case subject to
+the limitations and conditions below.
+
+## Limitations
+
+You may not provide the software to third parties as a hosted or managed
+service, where the service provides users with access to any substantial set of
+the features or functionality of the software.
+
+You may not move, change, disable, or circumvent the license key functionality
+in the software, and you may not remove or obscure any functionality in the
+software that is protected by the license key.
+
+You may not alter, remove, or obscure any licensing, copyright, or other notices
+of the licensor in the software. Any use of the licensor’s trademarks is subject
+to applicable law.
+
+## Patents
+
+The licensor grants you a license, under any patent claims the licensor can
+license, or becomes able to license, to make, have made, use, sell, offer for
+sale, import and have imported the software, in each case subject to the
+limitations and conditions in this license. This license does not cover any
+patent claims that you cause to be infringed by modifications or additions to
+the software. If you or your company make any written claim that the software
+infringes or contributes to infringement of any patent, your patent license for
+the software granted under these terms ends immediately. If your company makes
+such a claim, your patent license ends immediately for work on behalf of your
+company.
+
+## Notices
+
+You must ensure that anyone who gets a copy of any part of the software from you
+also gets a copy of these terms.
+
+If you modify the software, you must include in any modified copies of the
+software prominent notices stating that you have modified the software.
+
+## No Other Rights
+
+These terms do not imply any licenses other than those expressly granted in
+these terms.
+
+## Termination
+
+If you use the software in violation of these terms, such use is not licensed,
+and your licenses will automatically terminate. If the licensor provides you
+with a notice of your violation, and you cease all violation of this license no
+later than 30 days after you receive that notice, your licenses will be
+reinstated retroactively. However, if you violate these terms after such
+reinstatement, any additional violation of these terms will cause your licenses
+to terminate automatically and permanently.
+
+## No Liability
+
+*As far as the law allows, the software comes as is, without any warranty or
+condition, and the licensor will not be liable to you for any damages arising
+out of these terms or the use or nature of the software, under any kind of
+legal claim.*
+
+## Definitions
+
+The **licensor** is the entity offering these terms, and the **software** is the
+software the licensor makes available under these terms, including any portion
+of it.
+
+**you** refers to the individual or entity agreeing to these terms.
+
+**your company** is any legal entity, sole proprietorship, or other kind of
+organization that you work for, plus all organizations that have control over,
+are under the control of, or are under common control with that
+organization. **control** means ownership of substantially all the assets of an
+entity, or the power to direct its management and policies by vote, contract, or
+otherwise. Control can be direct or indirect.
+
+**your licenses** are all the licenses granted to you for the software under
+these terms.
+
+**use** means anything you do with the software requiring one of your licenses.
+
+**trademark** means trademarks, service marks, and similar rights.

package/README.md

@@ -1,3 +1,96 @@
-# Temporary Holding Version
+# @g3nomaly/mods
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+`g3n-mods` installs Claude Code mods into a project. A mod adds a pane, a status line, a slash command or a hook to Claude Code. The g3n mods from [`@g3nomaly/g3n-mods`](../g3n-mods) are available by default, and you can register other sources: a git repository, an npm package or a local folder.
+
+Mods are drawn by the Claude Code extension for VS Code. They also load in the terminal, but they are built for the extension.
+
+## Requirements
+
+- [Bun](https://bun.sh)
+- Claude Code for VS Code (`anthropic.claude-code`) 2.1.296 or newer
+- A git repository to install into, unless you install with `--user`
+
+## Install the mods
+
+Run these from the root of your project:
+
+```sh
+bunx @g3nomaly/mods init                # creates .claude/mods.json and sets up VS Code
+bunx @g3nomaly/mods ls                  # lists the mods you can install
+bunx @g3nomaly/mods add context-bar     # installs one mod
+bunx @g3nomaly/mods add g3n-mods        # or every mod from the g3n-mods source
+```
+
+Then open the project in VS Code and trust the workspace when asked. Claude Code does not load mods from an untrusted workspace. New sessions load the mods. In a session that is already open, run `/reload-plugins`.
+
+Mods are copied to `.claude/skills/<mod>/`, where Claude Code finds them, and recorded in `.claude/mods.json`. Commit both if your team should get the same mods.
+
+To install for every project instead of one, add `--user` to any command. Mods then go to `~/.claude/`.
+
+## The g3n mods
+
+| Mod | What it does | Command |
+|---|---|---|
+| `context-bar` | One bar of context-window use split by source, with the total and where compaction starts | `/context-bar` |
+| `tool-timeline` | Each tool call with its duration. A denied call is struck through, next to the call that replaced it | `/tool-timeline` |
+| `delete-guard` | Denies `rm -rf` and other permanent deletes and points Claude to the trash | `/delete-guard on \| off` |
+| `agents-panel` | The agents in `.claude/agents` with their model and a run button | `/agents-panel` |
+| `focus-mode` | A timed focus block with a countdown and an end button | `/focus-mode [minutes] \| end` |
+| `hide-personal-data` | Masks names, emails and other personal data in replies. Hover to show them | `/hide-personal-data on \| off` |
+| `mini-game` | Minesweeper, to play while Claude works | `/mini-game` |
+| `custom-crab-agents` | Each subagent as a crab with a hat: effort, model, steps, tokens, cost and time | `/crabs` |
+| `handoff` | Writes a handoff, clears the session, and gives the handoff to your next prompt | `/handoff-new [what the next session is for]` |
+| `you-should-know` | A card under long replies with their key point. It makes one small Haiku call per long reply | none |
+
+Each pane opens with its command. For `context-bar`, `tool-timeline`, `agents-panel` and `custom-crab-agents`, running the command again closes the pane.
+
+## Showing mods in VS Code
+
+`init` writes two settings to `.vscode/settings.json`:
+
+- `claudeCode.preferredLocation`: `panel` opens Claude in an editor tab, where panes have room. Pass `--location sidebar` to keep it in the side bar.
+- `claudeCode.useTerminal`: `false`, because mods are drawn in the extension's own UI, not in the terminal.
+
+The other settings in the file are kept. If the file has comments, `init` leaves it alone and prints the two settings to add by hand.
+
+To give Claude a window of its own, run **Claude Code: Open in New Window** from the command palette.
+
+## Keep mods up to date
+
+```sh
+bunx @g3nomaly/mods update              # every installed mod
+bunx @g3nomaly/mods update focus-mode   # one mod
+bunx @g3nomaly/mods update --dry-run    # shows what would change
+bunx @g3nomaly/mods remove mini-game
+bunx @g3nomaly/mods ls --installed
+```
+
+When you have changed an installed file, `update` asks whether to restore the source version, fork the mod under a new name that updates leave alone, or skip it and ask again next time. Pass `-f` to restore without asking, for example in a script.
+
+## Other sources
+
+```sh
+bunx @g3nomaly/mods source add owner/repo                  # a GitHub repository
+bunx @g3nomaly/mods source add https://git.example.com/mods.git --ref v1
+bunx @g3nomaly/mods source add npm:some-mods               # an npm package
+bunx @g3nomaly/mods source add ./my-mods --name mine       # a local folder
+bunx @g3nomaly/mods source ls
+bunx @g3nomaly/mods add some-mod@mine                      # a mod from one source
+bunx @g3nomaly/mods source remove mine
+```
+
+`g3n-mods` is built in and cannot be removed.
+
+A source lists its mods in `.claude-plugin/marketplace.json`. Without one, the source is read as one mod, or as a folder of mods under `mods/`. A mod is a plugin folder with `.claude-plugin/plugin.json` and `hooks/hooks.json`, and the folder name must match the plugin name. Mods are TypeScript only: a mod with any `.js`, `.mjs`, `.cjs` or `.jsx` file is refused.
+
+## Development
+
+Run `bun install` at the repository root first, then every command from this directory.
+
+```sh
+bun run mods -- ls       # the CLI from source
+bun run typecheck
+bun run build
+```
+
+The reasons behind the design are in [`documentation/spec/mods/decisions.md`](../../documentation/spec/mods/decisions.md).

package/dist/cli/commands/add.d.ts

@@ -0,0 +1,24 @@
+import type { InstallOptions } from "@g3nomaly/core/cli";
+import type { ProjectDeps, Scope } from "../project";
+/**
+ * Options of `addCommand`, on top of the core install options.
+ *
+ * @property scope - Scope to install into; `project` when absent.
+ * @property source - Read only this registered source.
+ */
+export interface AddOptions extends InstallOptions {
+    scope?: Scope;
+    source?: string;
+}
+/**
+ * @brief Installs mods, or every mod of a source, from the registered sources into
+ * the scope's `.claude/skills/`, records them in `mods.json` and sets up the
+ * viewer. A name more than one source offers is picked as `<name>@<source>`;
+ * with no names the user picks from what the sources provide.
+ *
+ * @param names - Mods to install, e.g. `auth-guard` or `auth-guard@my-source`; empty to pick interactively.
+ * @param options - Scope, source filter and install options.
+ * @param deps - Overrides for the project lookup, used by tests.
+ */
+export declare function addCommand(names: string[], options?: AddOptions, deps?: ProjectDeps): Promise<void>;
+//# sourceMappingURL=add.d.ts.map

package/dist/cli/commands/add.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/add.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,OAAO,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAGrD;;;;;GAKG;AACH,MAAM,WAAW,UAAW,SAAQ,cAAc;IAChD,KAAK,CAAC,EAAG,KAAK,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;GASG;AACH,wBAAsB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,UAAe,EAAE,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAajH"}

package/dist/cli/commands/add.js

@@ -0,0 +1,29 @@
+// packages/mods/src/cli/commands/add.ts
+import { addFromSources, c, lineInfo } from "@g3nomaly/core/cli";
+import { MOD_CONTEXT, installedMods, openModProject, openModRegistry } from "../project";
+import { setUpViewer } from "../viewer";
+/**
+ * @brief Installs mods, or every mod of a source, from the registered sources into
+ * the scope's `.claude/skills/`, records them in `mods.json` and sets up the
+ * viewer. A name more than one source offers is picked as `<name>@<source>`;
+ * with no names the user picks from what the sources provide.
+ *
+ * @param names - Mods to install, e.g. `auth-guard` or `auth-guard@my-source`; empty to pick interactively.
+ * @param options - Scope, source filter and install options.
+ * @param deps - Overrides for the project lookup, used by tests.
+ */
+export async function addCommand(names, options = {}, deps = {}) {
+    const project = openModProject(options.scope ?? "project", deps);
+    const registry = await openModRegistry(project, options.source);
+    try {
+        await addFromSources([project.target], names, registry, options, MOD_CONTEXT);
+    }
+    finally {
+        registry.dispose();
+    }
+    if (Object.keys(installedMods(project)).length > 0) {
+        setUpViewer(project);
+        console.log(lineInfo(`New sessions load the mods; in a running one, run ${c.cmd("/reload-plugins")}.`));
+    }
+}
+//# sourceMappingURL=add.js.map

package/dist/cli/commands/add.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"add.js","sourceRoot":"","sources":["../../../src/cli/commands/add.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,OAAO,EAAE,cAAc,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEjE,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEzF,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAaxC;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,KAAe,EAAE,OAAO,GAAe,EAAE,EAAE,IAAI,GAAgB,EAAE;IAChG,MAAM,OAAO,GAAI,cAAc,CAAC,OAAO,CAAC,KAAK,IAAI,SAAS,EAAE,IAAI,CAAC,CAAC;IAClE,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAChE,IAAI,CAAC;QACH,MAAM,cAAc,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC;IAChF,CAAC;YAAS,CAAC;QACT,QAAQ,CAAC,OAAO,EAAE,CAAC;IACrB,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACnD,WAAW,CAAC,OAAO,CAAC,CAAC;QACrB,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,qDAAqD,CAAC,CAAC,GAAG,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1G,CAAC;AACH,CAAC"}

package/dist/cli/commands/init.d.ts

@@ -0,0 +1,21 @@
+import type { ViewerLocation } from "../../viewer";
+import type { ProjectDeps, Scope } from "../project";
+/**
+ * Options of `initCommand`.
+ *
+ * @property scope - Scope to create `mods.json` in; `project` when absent.
+ * @property location - Where Claude opens in VS Code; a location already set is kept when absent.
+ */
+export interface InitOptions {
+    scope?: Scope;
+    location?: ViewerLocation;
+}
+/**
+ * @brief Creates the scope's `mods.json` when missing, sets up the viewer, and lists
+ * the sources mods can be installed from.
+ *
+ * @param options - Scope and viewer location.
+ * @param deps - Overrides for the project lookup, used by tests.
+ */
+export declare function initCommand(options?: InitOptions, deps?: ProjectDeps): void;
+//# sourceMappingURL=init.d.ts.map

package/dist/cli/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,OAAO,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAIrD;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,EAAK,KAAK,CAAC;IACjB,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,OAAO,GAAE,WAAgB,EAAE,IAAI,GAAE,WAAgB,GAAG,IAAI,CAYnF"}

package/dist/cli/commands/init.js

@@ -0,0 +1,27 @@
+// packages/mods/src/cli/commands/init.ts
+import fs from "node:fs";
+import { c, lineSuccess } from "@g3nomaly/core/cli";
+import { saveInstallManifest } from "@g3nomaly/core/installer";
+import { ModMetaSchema } from "../../registry/types";
+import { openModProject } from "../project";
+import { setUpViewer } from "../viewer";
+import { sourceLsCommand } from "./source";
+/**
+ * @brief Creates the scope's `mods.json` when missing, sets up the viewer, and lists
+ * the sources mods can be installed from.
+ *
+ * @param options - Scope and viewer location.
+ * @param deps - Overrides for the project lookup, used by tests.
+ */
+export function initCommand(options = {}, deps = {}) {
+    const project = openModProject(options.scope ?? "project", deps);
+    if (!fs.existsSync(project.target.manifest.filePath)) {
+        saveInstallManifest(project.target.manifest, ModMetaSchema);
+        console.log(lineSuccess(`Created ${c.file(project.target.manifest.filePath)}`));
+    }
+    setUpViewer(project, options.location);
+    console.log(c.header("\nSources"));
+    sourceLsCommand({ scope: project.scope }, deps);
+    console.log(`\nRun ${c.cmd("g3n-mods ls")} to see the mods, ${c.cmd("g3n-mods add <mod>")} to install one.`);
+}
+//# sourceMappingURL=init.js.map

package/dist/cli/commands/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,CAAC,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAa3C;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,OAAO,GAAgB,EAAE,EAAE,IAAI,GAAgB,EAAE;IAC3E,MAAM,OAAO,GAAG,cAAc,CAAC,OAAO,CAAC,KAAK,IAAI,SAAS,EAAE,IAAI,CAAC,CAAC;IAEjE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QACrD,mBAAmB,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;QAC5D,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;IAClF,CAAC;IACD,WAAW,CAAC,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAEvC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC;IACnC,eAAe,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,CAAC;IAChD,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,qBAAqB,CAAC,CAAC,GAAG,CAAC,oBAAoB,CAAC,kBAAkB,CAAC,CAAC;AAC/G,CAAC"}

package/dist/cli/commands/ls.d.ts

@@ -0,0 +1,22 @@
+import type { LSOptions } from "@g3nomaly/core/cli";
+import type { ProjectDeps, Scope } from "../project";
+/**
+ * Options of `lsCommand`, on top of the core listing options.
+ *
+ * @property scope - Scope to list; `project` when absent.
+ * @property installed - List what `mods.json` records instead of what the sources provide.
+ * @property source - Only the mods of this registered source.
+ */
+export interface LsOptions extends LSOptions {
+    scope?: Scope;
+    installed?: boolean;
+    source?: string;
+}
+/**
+ * @brief Lists the mods the scope's sources provide, `●` marking installed ones, or with `installed` only what is installed.
+ *
+ * @param options - Scope, source filter and listing options.
+ * @param deps - Overrides for the project lookup, used by tests.
+ */
+export declare function lsCommand(options?: LsOptions, deps?: ProjectDeps): Promise<void>;
+//# sourceMappingURL=ls.d.ts.map

package/dist/cli/commands/ls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ls.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/ls.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD,OAAO,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAErD;;;;;;GAMG;AACH,MAAM,WAAW,SAAU,SAAQ,SAAS;IAC1C,KAAK,CAAC,EAAM,KAAK,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAK,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAsB,SAAS,CAAC,OAAO,GAAE,SAAc,EAAE,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAe9F"}

package/dist/cli/commands/ls.js

@@ -0,0 +1,25 @@
+// packages/mods/src/cli/commands/ls.ts
+import { lsEntries, lsSourceRegistry } from "@g3nomaly/core/cli";
+import { installedMods, openModProject, openModRegistry, modSources } from "../project";
+/**
+ * @brief Lists the mods the scope's sources provide, `●` marking installed ones, or with `installed` only what is installed.
+ *
+ * @param options - Scope, source filter and listing options.
+ * @param deps - Overrides for the project lookup, used by tests.
+ */
+export async function lsCommand(options = {}, deps = {}) {
+    const project = openModProject(options.scope ?? "project", deps);
+    const installed = installedMods(project);
+    if (options.installed === true) {
+        lsEntries(installed, options);
+        return;
+    }
+    const registry = await openModRegistry(project, options.source);
+    try {
+        lsSourceRegistry(registry, modSources(project), installed, options);
+    }
+    finally {
+        registry.dispose();
+    }
+}
+//# sourceMappingURL=ls.js.map

package/dist/cli/commands/ls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ls.js","sourceRoot":"","sources":["../../../src/cli/commands/ls.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEjE,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAgBxF;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAAO,GAAc,EAAE,EAAE,IAAI,GAAgB,EAAE;IAC7E,MAAM,OAAO,GAAK,cAAc,CAAC,OAAO,CAAC,KAAK,IAAI,SAAS,EAAE,IAAI,CAAC,CAAC;IACnE,MAAM,SAAS,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;IAEzC,IAAI,OAAO,CAAC,SAAS,KAAK,IAAI,EAAE,CAAC;QAC/B,SAAS,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAC9B,OAAO;IACT,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAChE,IAAI,CAAC;QACH,gBAAgB,CAAC,QAAQ,EAAE,UAAU,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;IACtE,CAAC;YAAS,CAAC;QACT,QAAQ,CAAC,OAAO,EAAE,CAAC;IACrB,CAAC;AACH,CAAC"}

package/dist/cli/commands/remove.d.ts

@@ -0,0 +1,21 @@
+import type { InstallOptions } from "@g3nomaly/core/cli";
+import type { ProjectDeps, Scope } from "../project";
+/**
+ * Options of `removeCommand`, on top of the core install options.
+ *
+ * @property scope - Scope to remove from; `project` when absent.
+ */
+export interface RemoveOptions extends InstallOptions {
+    scope?: Scope;
+}
+/**
+ * @brief Removes installed mods, or every mod of a source, with the type
+ * declarations Claude Code wrote beside them, and drops them from
+ * `mods.json`. With no names the user picks from what is installed.
+ *
+ * @param names - Mods to remove; empty to pick from what is installed.
+ * @param options - Scope and install options.
+ * @param deps - Overrides for the project lookup, used by tests.
+ */
+export declare function removeCommand(names: string[], options?: RemoveOptions, deps?: ProjectDeps): Promise<void>;
+//# sourceMappingURL=remove.d.ts.map

package/dist/cli/commands/remove.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/remove.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAkB,MAAM,oBAAoB,CAAC;AAGzE,OAAO,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAErD;;;;GAIG;AACH,MAAM,WAAW,aAAc,SAAQ,cAAc;IACnD,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAoBD;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,aAAkB,EAAE,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAGvH"}

package/dist/cli/commands/remove.js

@@ -0,0 +1,37 @@
+// packages/mods/src/cli/commands/remove.ts
+import fs from "node:fs";
+import path from "node:path";
+import { removeFromTargets } from "@g3nomaly/core/cli";
+import { createInstallerIO, pruneEmptyDirs } from "@g3nomaly/core/installer";
+import { MOD_CONTEXT, openModProject } from "../project";
+/** Folder Claude Code writes the mod API's declarations into when it loads a mod; never recorded in `mods.json`. */
+const ENGINE_TYPES_DIR = path.join(".claude-plugin", "types");
+/**
+ * Deletes the declarations Claude Code wrote into removed mods, then their emptied folders.
+ *
+ * @param target - Install destination the mods were removed from.
+ * @param removed - Folder names of the removed mods.
+ */
+function removeEngineTypes(target, removed) {
+    const io = createInstallerIO();
+    for (const key of removed) {
+        const typesDir = path.join(target.installDir, key, ENGINE_TYPES_DIR);
+        if (fs.existsSync(typesDir))
+            fs.rmSync(typesDir, { recursive: true });
+        pruneEmptyDirs(path.dirname(typesDir), target.installDir, io);
+    }
+}
+/**
+ * @brief Removes installed mods, or every mod of a source, with the type
+ * declarations Claude Code wrote beside them, and drops them from
+ * `mods.json`. With no names the user picks from what is installed.
+ *
+ * @param names - Mods to remove; empty to pick from what is installed.
+ * @param options - Scope and install options.
+ * @param deps - Overrides for the project lookup, used by tests.
+ */
+export async function removeCommand(names, options = {}, deps = {}) {
+    const project = openModProject(options.scope ?? "project", deps);
+    await removeFromTargets([project.target], names, options, MOD_CONTEXT, removeEngineTypes);
+}
+//# sourceMappingURL=remove.js.map

package/dist/cli/commands/remove.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove.js","sourceRoot":"","sources":["../../../src/cli/commands/remove.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAC3C,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEvD,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC7E,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAYzD,oHAAoH;AACpH,MAAM,gBAAgB,GAAG,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC;AAE9D;;;;;GAKG;AACH,SAAS,iBAAiB,CAAC,MAAsB,EAAE,OAAiB;IAClE,MAAM,EAAE,GAAG,iBAAiB,EAAE,CAAC;IAC/B,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;QAC1B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,GAAG,EAAE,gBAAgB,CAAC,CAAC;QACrE,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;YAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACtE,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAChE,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,KAAe,EAAE,OAAO,GAAkB,EAAE,EAAE,IAAI,GAAgB,EAAE;IACtG,MAAM,OAAO,GAAG,cAAc,CAAC,OAAO,CAAC,KAAK,IAAI,SAAS,EAAE,IAAI,CAAC,CAAC;IACjE,MAAM,iBAAiB,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,iBAAiB,CAAC,CAAC;AAC5F,CAAC"}

package/dist/cli/commands/source.d.ts

@@ -0,0 +1,60 @@
+import type { ProjectDeps, Scope } from "../project";
+/**
+ * Options of `sourceAddCommand`.
+ *
+ * @property scope - Scope to register in; `project` when absent.
+ * @property name - Name to register under; derived from the spec when absent.
+ * @property ref - Branch or tag of a git source.
+ */
+export interface SourceAddOptions {
+    scope?: Scope;
+    name?: string;
+    ref?: string;
+}
+/**
+ * Options of `sourceLsCommand`.
+ *
+ * @property scope - Scope to list; `project` when absent.
+ * @property json - Output as JSON.
+ */
+export interface SourceLsOptions {
+    scope?: Scope;
+    json?: boolean;
+}
+/**
+ * Options of `sourceRemoveCommand`.
+ *
+ * @property scope - Scope to unregister from; `project` when absent.
+ * @property force - Unregister even while installed mods come from the source.
+ */
+export interface SourceRemoveOptions {
+    scope?: Scope;
+    force?: boolean;
+}
+/**
+ * @brief Registers a git repository, npm package or local folder as a mod source in
+ * the scope's `mods.json`, after checking it provides at least one mod. A
+ * local path is stored relative to the project root, and absolute for the
+ * user scope, which every project shares.
+ *
+ * @param input - Git URL, `owner/repo`, npm spec or local folder path.
+ * @param options - Scope, name and ref.
+ * @param deps - Overrides for the project lookup, used by tests.
+ */
+export declare function sourceAddCommand(input: string, options?: SourceAddOptions, deps?: ProjectDeps): Promise<void>;
+/**
+ * @brief Lists the built-in and registered sources of the scope, with how many installed mods came from each.
+ *
+ * @param options - Scope and output format.
+ * @param deps - Overrides for the project lookup, used by tests.
+ */
+export declare function sourceLsCommand(options?: SourceLsOptions, deps?: ProjectDeps): void;
+/**
+ * @brief Unregisters a source; refused for built-in sources and, unless forced, while installed mods came from it.
+ *
+ * @param name - Name of the source to unregister.
+ * @param options - Scope and force flag.
+ * @param deps - Overrides for the project lookup, used by tests.
+ */
+export declare function sourceRemoveCommand(name: string, options?: SourceRemoveOptions, deps?: ProjectDeps): void;
+//# sourceMappingURL=source.d.ts.map

package/dist/cli/commands/source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/source.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAc,WAAW,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEjE;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,IAAI,CAAC,EAAG,MAAM,CAAC;IACf,GAAG,CAAC,EAAI,MAAM,CAAC;CAChB;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,IAAI,CAAC,EAAG,OAAO,CAAC;CACjB;AAED;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAWD;;;;;;;;;GASG;AACH,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,gBAAqB,EAAE,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAG3H;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,GAAE,eAAoB,EAAE,IAAI,GAAE,WAAgB,GAAG,IAAI,CAG3F;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAwB,EAAE,IAAI,GAAE,WAAgB,GAAG,IAAI,CAGjH"}

package/dist/cli/commands/source.js

@@ -0,0 +1,49 @@
+// packages/mods/src/cli/commands/source.ts
+import { addSourceEntries, lsSources, removeSourceEntries } from "@g3nomaly/core/cli";
+import { readModSource } from "../../registry/readSource";
+import { BUILTIN_SOURCES } from "../../sources/builtins";
+import { MOD_CONTEXT, openModProject } from "../project";
+/**
+ * @brief Builds the context the core source commands use for mods in one scope.
+ *
+ * @param project - Scope the commands work on.
+ */
+function sourceContext(project) {
+    return { ...MOD_CONTEXT, builtins: BUILTIN_SOURCES, readSource: readModSource, projectRoot: project.projectRoot };
+}
+/**
+ * @brief Registers a git repository, npm package or local folder as a mod source in
+ * the scope's `mods.json`, after checking it provides at least one mod. A
+ * local path is stored relative to the project root, and absolute for the
+ * user scope, which every project shares.
+ *
+ * @param input - Git URL, `owner/repo`, npm spec or local folder path.
+ * @param options - Scope, name and ref.
+ * @param deps - Overrides for the project lookup, used by tests.
+ */
+export async function sourceAddCommand(input, options = {}, deps = {}) {
+    const project = openModProject(options.scope ?? "project", deps);
+    await addSourceEntries([project.target], input, { name: options.name, ref: options.ref, absolutePaths: project.scope === "user" }, sourceContext(project));
+}
+/**
+ * @brief Lists the built-in and registered sources of the scope, with how many installed mods came from each.
+ *
+ * @param options - Scope and output format.
+ * @param deps - Overrides for the project lookup, used by tests.
+ */
+export function sourceLsCommand(options = {}, deps = {}) {
+    const project = openModProject(options.scope ?? "project", deps);
+    lsSources([project.target], options, sourceContext(project));
+}
+/**
+ * @brief Unregisters a source; refused for built-in sources and, unless forced, while installed mods came from it.
+ *
+ * @param name - Name of the source to unregister.
+ * @param options - Scope and force flag.
+ * @param deps - Overrides for the project lookup, used by tests.
+ */
+export function sourceRemoveCommand(name, options = {}, deps = {}) {
+    const project = openModProject(options.scope ?? "project", deps);
+    removeSourceEntries([project.target], name, options, sourceContext(project));
+}
+//# sourceMappingURL=source.js.map

package/dist/cli/commands/source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.js","sourceRoot":"","sources":["../../../src/cli/commands/source.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAC3C,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEtF,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE1D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAsCzD;;;;GAIG;AACH,SAAS,aAAa,CAAC,OAAmB;IACxC,OAAO,EAAE,GAAG,WAAW,EAAE,QAAQ,EAAE,eAAe,EAAE,UAAU,EAAE,aAAa,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC;AACpH,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,KAAa,EAAE,OAAO,GAAqB,EAAE,EAAE,IAAI,GAAgB,EAAE;IAC1G,MAAM,OAAO,GAAG,cAAc,CAAC,OAAO,CAAC,KAAK,IAAI,SAAS,EAAE,IAAI,CAAC,CAAC;IACjE,MAAM,gBAAgB,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,aAAa,EAAE,OAAO,CAAC,KAAK,KAAK,MAAM,EAAE,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC;AAC7J,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,OAAO,GAAoB,EAAE,EAAE,IAAI,GAAgB,EAAE;IACnF,MAAM,OAAO,GAAG,cAAc,CAAC,OAAO,CAAC,KAAK,IAAI,SAAS,EAAE,IAAI,CAAC,CAAC;IACjE,SAAS,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC;AAC/D,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAY,EAAE,OAAO,GAAwB,EAAE,EAAE,IAAI,GAAgB,EAAE;IACzG,MAAM,OAAO,GAAG,cAAc,CAAC,OAAO,CAAC,KAAK,IAAI,SAAS,EAAE,IAAI,CAAC,CAAC;IACjE,mBAAmB,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC;AAC/E,CAAC"}

package/dist/cli/commands/update.d.ts

@@ -0,0 +1,21 @@
+import type { InstallOptions } from "@g3nomaly/core/cli";
+import type { ProjectDeps, Scope } from "../project";
+/**
+ * Options of `updateCommand`, on top of the core install options.
+ *
+ * @property scope - Scope to update; `project` when absent.
+ */
+export interface UpdateOptions extends InstallOptions {
+    scope?: Scope;
+}
+/**
+ * @brief Re-installs installed mods from the source each one was installed from,
+ * at that source's current revision; with no names, everything installed.
+ * Files the user changed since install are kept unless overwritten.
+ *
+ * @param names - Mods to update; empty for everything installed.
+ * @param options - Scope and install options.
+ * @param deps - Overrides for the project lookup, used by tests.
+ */
+export declare function updateCommand(names: string[], options?: UpdateOptions, deps?: ProjectDeps): Promise<void>;
+//# sourceMappingURL=update.d.ts.map

package/dist/cli/commands/update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/update.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,OAAO,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAErD;;;;GAIG;AACH,MAAM,WAAW,aAAc,SAAQ,cAAc;IACnD,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,aAAkB,EAAE,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAGvH"}

package/dist/cli/commands/update.js

@@ -0,0 +1,17 @@
+// packages/mods/src/cli/commands/update.ts
+import { updateFromSources } from "@g3nomaly/core/cli";
+import { MOD_CONTEXT, openModProject, openModRegistry } from "../project";
+/**
+ * @brief Re-installs installed mods from the source each one was installed from,
+ * at that source's current revision; with no names, everything installed.
+ * Files the user changed since install are kept unless overwritten.
+ *
+ * @param names - Mods to update; empty for everything installed.
+ * @param options - Scope and install options.
+ * @param deps - Overrides for the project lookup, used by tests.
+ */
+export async function updateCommand(names, options = {}, deps = {}) {
+    const project = openModProject(options.scope ?? "project", deps);
+    await updateFromSources([project.target], names, () => openModRegistry(project), options, MOD_CONTEXT);
+}
+//# sourceMappingURL=update.js.map

package/dist/cli/commands/update.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.js","sourceRoot":"","sources":["../../../src/cli/commands/update.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEvD,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAY1E;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,KAAe,EAAE,OAAO,GAAkB,EAAE,EAAE,IAAI,GAAgB,EAAE;IACtG,MAAM,OAAO,GAAG,cAAc,CAAC,OAAO,CAAC,KAAK,IAAI,SAAS,EAAE,IAAI,CAAC,CAAC;IACjE,MAAM,iBAAiB,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,eAAe,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC;AACzG,CAAC"}

package/dist/cli/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env bun
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":""}