@g3nomaly/mods 0.0.0-stage → 0.1.0

package/dist/viewer/extension.d.ts

@@ -0,0 +1,18 @@
+/** Lowest Claude Code release whose mod API the g3n mods are written against. */
+export declare const MIN_ENGINE_VERSION = "2.1.296";
+/** One installed copy of the Claude Code VS Code extension. */
+export interface ClaudeExtension {
+    version: string;
+    /** Absolute extension folder */
+    dir: string;
+}
+/** Compares two `major.minor.patch` versions; negative when `a` is older than `b`. */
+export declare function compareVersions(a: string, b: string): number;
+/**
+ * Newest Claude Code extension installed for any editor of the VS Code family.
+ *
+ * @param home - Home directory to search under; the current user's by default
+ * @returns the newest copy, or `null` when none is installed
+ */
+export declare function findClaudeExtension(home?: string): ClaudeExtension | null;
+//# sourceMappingURL=extension.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"extension.d.ts","sourceRoot":"","sources":["../../src/viewer/extension.ts"],"names":[],"mappings":"AAKA,iFAAiF;AACjF,eAAO,MAAM,kBAAkB,YAAY,CAAC;AAO5C,+DAA+D;AAC/D,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,gCAAgC;IAChC,GAAG,EAAM,MAAM,CAAC;CACjB;AAED,sFAAsF;AACtF,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAQ5D;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,GAAE,MAAqB,GAAG,eAAe,GAAG,IAAI,CAYvF"}

package/dist/viewer/extension.js

@@ -0,0 +1,43 @@
+// packages/mods/src/viewer/extension.ts
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+/** Lowest Claude Code release whose mod API the g3n mods are written against. */
+export const MIN_ENGINE_VERSION = "2.1.296";
+/** Extension folders of the VS Code family, relative to the home directory: local, WSL/SSH server, Insiders, Cursor. */
+const EXTENSION_ROOTS = [".vscode/extensions", ".vscode-server/extensions", ".vscode-insiders/extensions", ".cursor/extensions"];
+const EXTENSION_DIR = /^anthropic\.claude-code-(\d+\.\d+\.\d+)(?:-.+)?$/;
+/** Compares two `major.minor.patch` versions; negative when `a` is older than `b`. */
+export function compareVersions(a, b) {
+    const pa = a.split(".").map(Number);
+    const pb = b.split(".").map(Number);
+    for (let i = 0; i < 3; i++) {
+        const diff = (pa[i] ?? 0) - (pb[i] ?? 0);
+        if (diff !== 0)
+            return diff;
+    }
+    return 0;
+}
+/**
+ * Newest Claude Code extension installed for any editor of the VS Code family.
+ *
+ * @param home - Home directory to search under; the current user's by default
+ * @returns the newest copy, or `null` when none is installed
+ */
+export function findClaudeExtension(home = os.homedir()) {
+    let newest = null;
+    for (const root of EXTENSION_ROOTS) {
+        const dir = path.join(home, root);
+        if (!fs.existsSync(dir))
+            continue;
+        for (const name of fs.readdirSync(dir)) {
+            const version = EXTENSION_DIR.exec(name)?.[1];
+            if (version === undefined)
+                continue;
+            if (newest === null || compareVersions(version, newest.version) > 0)
+                newest = { version, dir: path.join(dir, name) };
+        }
+    }
+    return newest;
+}
+//# sourceMappingURL=extension.js.map

package/dist/viewer/extension.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension.js","sourceRoot":"","sources":["../../src/viewer/extension.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,iFAAiF;AACjF,MAAM,CAAC,MAAM,kBAAkB,GAAG,SAAS,CAAC;AAE5C,wHAAwH;AACxH,MAAM,eAAe,GAAG,CAAC,oBAAoB,EAAE,2BAA2B,EAAE,6BAA6B,EAAE,oBAAoB,CAAC,CAAC;AAEjI,MAAM,aAAa,GAAG,kDAAkD,CAAC;AASzE,sFAAsF;AACtF,MAAM,UAAU,eAAe,CAAC,CAAS,EAAE,CAAS;IAClD,MAAM,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACpC,MAAM,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACpC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QACzC,IAAI,IAAI,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;IAC9B,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAI,GAAW,EAAE,CAAC,OAAO,EAAE;IAC7D,IAAI,MAAM,GAA2B,IAAI,CAAC;IAC1C,KAAK,MAAM,IAAI,IAAI,eAAe,EAAE,CAAC;QACnC,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS;QAClC,KAAK,MAAM,IAAI,IAAI,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;YACvC,MAAM,OAAO,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;YAC9C,IAAI,OAAO,KAAK,SAAS;gBAAE,SAAS;YACpC,IAAI,MAAM,KAAK,IAAI,IAAI,eAAe,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC;gBAAE,MAAM,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,CAAC;QACvH,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/viewer/index.d.ts

@@ -0,0 +1,5 @@
+export { MIN_ENGINE_VERSION, compareVersions, findClaudeExtension } from "./extension";
+export type { ClaudeExtension } from "./extension";
+export { ViewerLocationSchema, configureViewer } from "./settings";
+export type { ViewerLocation, ViewerSettingsResult } from "./settings";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/viewer/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACvF,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AACnE,YAAY,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC"}

package/dist/viewer/index.js

@@ -0,0 +1,4 @@
+// packages/mods/src/viewer/index.ts
+export { MIN_ENGINE_VERSION, compareVersions, findClaudeExtension } from "./extension";
+export { ViewerLocationSchema, configureViewer } from "./settings";
+//# sourceMappingURL=index.js.map

package/dist/viewer/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/viewer/index.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEvF,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC"}

package/dist/viewer/settings.d.ts

@@ -0,0 +1,31 @@
+import { z } from "zod";
+/** Where the Claude Code extension opens: an editor tab (`panel`) or the side bar. */
+export declare const ViewerLocationSchema: z.ZodEnum<{
+    panel: "panel";
+    sidebar: "sidebar";
+}>;
+export type ViewerLocation = z.infer<typeof ViewerLocationSchema>;
+/** What `configureViewer` did to the workspace settings. */
+export type ViewerSettingsResult = {
+    kind: "written";
+    file: string;
+} | {
+    kind: "unchanged";
+    file: string;
+}
+/** The file exists but is not plain JSON (comments, trailing commas); nothing was written */
+ | {
+    kind: "unreadable";
+    file: string;
+    settings: Record<string, unknown>;
+};
+/**
+ * Points the project's VS Code workspace at the extension's native UI, the
+ * surface mods draw on: sets where Claude opens and turns off terminal mode.
+ * Other settings in the file are kept.
+ *
+ * @param projectRoot - Absolute project root holding `.vscode/`
+ * @param location - Where Claude opens; when absent, a location already set is kept and `panel` is the default
+ */
+export declare function configureViewer(projectRoot: string, location?: ViewerLocation): ViewerSettingsResult;
+//# sourceMappingURL=settings.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../../src/viewer/settings.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,sFAAsF;AACtF,eAAO,MAAM,oBAAoB;;;EAA+B,CAAC;AAEjE,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAQlE,4DAA4D;AAC5D,MAAM,MAAM,oBAAoB,GAC5B;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE;AACrC,6FAA6F;GAC3F;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC;AAE5E;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,cAAc,GAAG,oBAAoB,CAkBpG"}

package/dist/viewer/settings.js

@@ -0,0 +1,44 @@
+// packages/mods/src/viewer/settings.ts
+import fs from "node:fs";
+import path from "node:path";
+import { z } from "zod";
+/** Where the Claude Code extension opens: an editor tab (`panel`) or the side bar. */
+export const ViewerLocationSchema = z.enum(["panel", "sidebar"]);
+const SETTINGS_FILE = path.join(".vscode", "settings.json");
+const LOCATION_KEY = "claudeCode.preferredLocation";
+const TERMINAL_KEY = "claudeCode.useTerminal";
+const SettingsSchema = z.record(z.string(), z.unknown());
+/**
+ * Points the project's VS Code workspace at the extension's native UI, the
+ * surface mods draw on: sets where Claude opens and turns off terminal mode.
+ * Other settings in the file are kept.
+ *
+ * @param projectRoot - Absolute project root holding `.vscode/`
+ * @param location - Where Claude opens; when absent, a location already set is kept and `panel` is the default
+ */
+export function configureViewer(projectRoot, location) {
+    const file = path.join(projectRoot, SETTINGS_FILE);
+    let current = {};
+    if (fs.existsSync(file)) {
+        const parsed = SettingsSchema.safeParse(safeJson(fs.readFileSync(file, "utf8")));
+        current = parsed.success ? parsed.data : undefined;
+    }
+    const kept = ViewerLocationSchema.safeParse(current?.[LOCATION_KEY]);
+    const wanted = { [LOCATION_KEY]: location ?? (kept.success ? kept.data : "panel"), [TERMINAL_KEY]: false };
+    if (current === undefined)
+        return { kind: "unreadable", file, settings: wanted };
+    if (Object.entries(wanted).every(([key, value]) => current[key] === value))
+        return { kind: "unchanged", file };
+    fs.mkdirSync(path.dirname(file), { recursive: true });
+    fs.writeFileSync(file, JSON.stringify({ ...current, ...wanted }, null, 2) + "\n");
+    return { kind: "written", file };
+}
+function safeJson(text) {
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=settings.js.map

package/dist/viewer/settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.js","sourceRoot":"","sources":["../../src/viewer/settings.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,sFAAsF;AACtF,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC;AAIjE,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC;AAC5D,MAAM,YAAY,GAAI,8BAA8B,CAAC;AACrD,MAAM,YAAY,GAAI,wBAAwB,CAAC;AAE/C,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;AASzD;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,WAAmB,EAAE,QAAyB;IAC5E,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;IAEnD,IAAI,OAAO,GAAwC,EAAE,CAAC;IACtD,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,MAAM,MAAM,GAAG,cAAc,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;QACjF,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;IACrD,CAAC;IAED,MAAM,IAAI,GAAK,oBAAoB,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC;IACvE,MAAM,MAAM,GAAG,EAAE,CAAC,YAAY,CAAC,EAAE,QAAQ,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,YAAY,CAAC,EAAE,KAAK,EAAE,CAAC;IAC3G,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;IAEjF,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IAE/G,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtD,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,OAAO,EAAE,GAAG,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAClF,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;AACnC,CAAC;AAED,SAAS,QAAQ,CAAC,IAAY;IAC5B,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAY,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,39 @@
 {
   "name": "@g3nomaly/mods",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "Installer for Claude Code mods: registers mod sources and installs, updates and removes mods from them.",
+  "type": "module",
+  "bin": {
+    "g3n-mods": "./dist/cli/index.js"
+  },
+  "main": "./dist/index.js",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "rm -rf dist && tsc --project tsconfig.build.json",
+    "typecheck": "tsc --noEmit",
+    "mods": "bun run src/cli/index.ts"
+  },
+  "dependencies": {
+    "@g3nomaly/core": "^0.3.1",
+    "chalk": "^6.0.0",
+    "commander": "^15.0.0",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@types/bun": "^1.4.0",
+    "typescript": "~7.0.2"
+  },
+  "license": "Elastic-2.0",
+  "publishConfig": {
+    "access": "public"
+  }
+}