@g3nomaly/mods 0.0.0-stage → 0.1.1

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";
+/**
+ * @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 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,69 @@
+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";
+}>;
+/** Kind of a mod file: `manifest`, `hooks`, `types` or `asset`. */
+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>;
+/**
+ * File entry of a mod, as `ModFileSchema` parses it.
+ *
+ * @property path - `<mod>/<file>`, relative to the install directory.
+ * @property type - Kind of the file.
+ */
+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>;
+    forkedFrom: z.ZodOptional<z.ZodString>;
+    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>;
+/**
+ * Entry of one mod in `mods.json`, as `ModMetaSchema` parses it.
+ *
+ * @property group - Source name, so `ls` groups by source.
+ * @property files - Installable files of the mod.
+ */
+export type ModMeta = z.infer<typeof ModMetaSchema>;
+/** Mods keyed by their folder name. */
+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,mEAAmE;AACnE,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,+GAA+G;AAC/G,eAAO,MAAM,aAAa;;;;;;;;;;iBAExB,CAAC;AAEH;;;;;GAKG;AACH,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAEpD;;;;GAIG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;iBAGxB,CAAC;AAEH;;;;;GAKG;AACH,MAAM,MAAM,OAAO,GAAO,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AACxD,uCAAuC;AACvC,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;AAKjF,+GAA+G;AAC/G,MAAM,CAAC,MAAM,aAAa,GAAG,mBAAmB,CAAC,MAAM,CAAC;IACtD,IAAI,EAAE,iBAAiB;CACxB,CAAC,CAAC;AAUH;;;;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"}

package/dist/viewer/extension.d.ts

@@ -0,0 +1,28 @@
+/** Lowest Claude Code release whose mod API the g3n mods are written against. */
+export declare const MIN_ENGINE_VERSION = "2.1.296";
+/**
+ * @brief One installed copy of the Claude Code VS Code extension.
+ *
+ * @property version - Release the folder name carries, e.g. `2.1.296`.
+ * @property dir - Absolute extension folder, e.g. `/home/me/.vscode/extensions/anthropic.claude-code-2.1.296`.
+ */
+export interface ClaudeExtension {
+    version: string;
+    dir: string;
+}
+/**
+ * @brief Compares two `major.minor.patch` versions; negative when `a` is older than `b`.
+ *
+ * @param a - Version to compare, e.g. `2.1.296`.
+ * @param b - Version to compare against, e.g. `2.1.300`.
+ * @returns Negative when `a` is older, `0` when equal, positive when `a` is newer.
+ */
+export declare function compareVersions(a: string, b: string): number;
+/**
+ * @brief 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 with its version and folder, 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;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAM,MAAM,CAAC;CACjB;AAED;;;;;;GAMG;AACH,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,49 @@
+// 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+)(?:-.+)?$/;
+/**
+ * @brief Compares two `major.minor.patch` versions; negative when `a` is older than `b`.
+ *
+ * @param a - Version to compare, e.g. `2.1.296`.
+ * @param b - Version to compare against, e.g. `2.1.300`.
+ * @returns Negative when `a` is older, `0` when equal, positive when `a` is newer.
+ */
+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;
+}
+/**
+ * @brief 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 with its version and folder, 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;AAazE;;;;;;GAMG;AACH,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,37 @@
+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";
+}>;
+/** Value of `ViewerLocationSchema`: `panel` for an editor tab, `sidebar` for the side bar. */
+export type ViewerLocation = z.infer<typeof ViewerLocationSchema>;
+/**
+ * @brief What `configureViewer` did to the workspace settings.
+ *
+ * @property kind - `written` when the file changed, `unchanged` when it already held the values, `unreadable` when the file is not plain JSON (comments, trailing commas); nothing is written then.
+ * @property file - Absolute path of `.vscode/settings.json`.
+ * @property settings - Values that would have been written; present only with `unreadable`.
+ */
+export type ViewerSettingsResult = {
+    kind: "written";
+    file: string;
+} | {
+    kind: "unchanged";
+    file: string;
+} | {
+    kind: "unreadable";
+    file: string;
+    settings: Record<string, unknown>;
+};
+/**
+ * @brief 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.
+ * @returns What was done to the settings file.
+ */
+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,8FAA8F;AAC9F,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAQlE;;;;;;GAMG;AACH,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,GACnC;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC;AAE5E;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,cAAc,GAAG,oBAAoB,CAkBpG"}

package/dist/viewer/settings.js

@@ -0,0 +1,51 @@
+// 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());
+/**
+ * @brief 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.
+ * @returns What was done to the settings file.
+ */
+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 };
+}
+/**
+ * @brief Parses JSON text, returning `undefined` instead of throwing.
+ *
+ * @param text - Raw file contents, e.g. the text of a `settings.json` file.
+ * @returns The parsed value, or `undefined` when the text is not valid JSON.
+ */
+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;AAKjE,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;AAczD;;;;;;;;GAQG;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;;;;;GAKG;AACH,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.1",
+  "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.2",
+    "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"
+  }
+}