@codyswann/lisa 2.148.0 → 2.150.0

package/dist/opencode/mcp-installer.d.ts

@@ -0,0 +1,89 @@
+import type { ClaudeMcpServerEntry } from "../agy/mcp-installer.js";
+/** Marker field tagged onto every Lisa-owned MCP server entry. */
+export declare const LISA_MANAGED_MARKER: "_lisaManaged";
+/** A stdio MCP server in OpenCode's shape (`command` is an argv array). */
+export interface OpencodeLocalMcpEntry {
+    readonly type: "local";
+    readonly command: readonly string[];
+    readonly environment?: Readonly<Record<string, string>>;
+    readonly enabled: boolean;
+    readonly [LISA_MANAGED_MARKER]?: boolean;
+}
+/** An HTTP MCP server in OpenCode's shape (`url`, not `command`). */
+export interface OpencodeRemoteMcpEntry {
+    readonly type: "remote";
+    readonly url: string;
+    readonly headers?: Readonly<Record<string, string>>;
+    readonly enabled: boolean;
+    readonly [LISA_MANAGED_MARKER]?: boolean;
+}
+/** Any MCP server entry in OpenCode's `mcp` map. */
+export type OpencodeMcpServerEntry = OpencodeLocalMcpEntry | OpencodeRemoteMcpEntry;
+/** Top-level `opencode.json` shape, narrowed to the keys this module touches. */
+export interface OpencodeConfigShape {
+    readonly mcp?: Readonly<Record<string, OpencodeMcpServerEntry>>;
+}
+/** Result of the OpenCode MCP install pass. */
+export interface OpencodeMcpInstallResult {
+    /** Absolute path written. */
+    readonly path: string;
+    /** Number of Lisa-managed entries written. */
+    readonly lisaEntryCount: number;
+    /** Number of host-authored entries preserved. */
+    readonly hostEntryCount: number;
+}
+/**
+ * Resolve the absolute path to a project's `opencode.json`.
+ * @param destDir - Absolute path to the host project root.
+ * @returns Absolute path to `<destDir>/opencode.json`.
+ */
+export declare function resolveOpencodeConfigPath(destDir: string): string;
+/**
+ * Translate a Claude/Codex-shape MCP entry to OpenCode's shape.
+ *
+ * Rules:
+ *   - stdio (`command` present): `type: "local"`, fold `command` + `args` into
+ *     a single argv array, rename `env` → `environment`, set `enabled: true`.
+ *   - http/sse (`url` present): `type: "remote"`, keep `url` + `headers`, set
+ *     `enabled: true`.
+ *
+ * The `_lisaManaged` marker is attached at write time, not in this pure transform.
+ * Throws if the entry has neither `command` nor `url` (un-translatable).
+ * @param input - Claude/Codex-format MCP server entry.
+ * @returns OpenCode-format MCP server entry.
+ */
+export declare function translateMcpEntryToOpencode(input: ClaudeMcpServerEntry): OpencodeMcpServerEntry;
+/**
+ * Install Lisa's MCP servers into `<destDir>/opencode.json` using tagged-merge.
+ *
+ * Always call this — even with an empty `lisaMcpServers` — so previously written
+ * `_lisaManaged` entries are stripped when a project stops shipping MCP servers.
+ * @param lisaMcpServers - Lisa's MCP servers in Claude/Codex shape, keyed by name.
+ * @param configPath - Absolute path to the target `opencode.json`.
+ * @returns Result with the path written and entry counts.
+ */
+export declare function installOpencodeMcpConfig(lisaMcpServers: Readonly<Record<string, ClaudeMcpServerEntry>>, configPath: string): Promise<OpencodeMcpInstallResult>;
+/** Merge outcome: the rewritten document plus Lisa/host entry counts. */
+interface McpMergeResult {
+    readonly text: string;
+    readonly lisaEntryCount: number;
+    readonly hostEntryCount: number;
+}
+/**
+ * Merge Lisa's MCP servers into the `mcp` key of an `opencode.json` document.
+ * Pure function for testability; `installOpencodeMcpConfig` is the I/O wrapper.
+ *
+ * Tagged-merge rules:
+ *   1. Translate + tag Lisa's entries with `_lisaManaged: true`.
+ *   2. Drop every existing entry already tagged `_lisaManaged` (Lisa's prior run).
+ *   3. Preserve host-authored entries (untagged) verbatim.
+ *   4. Rewrite only the `mcp` key; the rest of the document is untouched.
+ *
+ * Throws on invalid JSONC so a corrupt host file is surfaced, not overwritten.
+ * @param existingJsonc - Current contents of `opencode.json` (or "").
+ * @param lisaMcpServers - Lisa's MCP servers in Claude/Codex shape, keyed by name.
+ * @returns The merged document text and entry counts.
+ */
+export declare function mergeMcpServers(existingJsonc: string, lisaMcpServers: Readonly<Record<string, ClaudeMcpServerEntry>>): McpMergeResult;
+export {};
+//# sourceMappingURL=mcp-installer.d.ts.map

package/dist/opencode/mcp-installer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-installer.d.ts","sourceRoot":"","sources":["../../src/opencode/mcp-installer.ts"],"names":[],"mappings":"AA+BA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAGpE,kEAAkE;AAClE,eAAO,MAAM,mBAAmB,EAAG,cAAuB,CAAC;AAO3D,2EAA2E;AAC3E,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,WAAW,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACxD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,CAAC,mBAAmB,CAAC,CAAC,EAAE,OAAO,CAAC;CAC1C;AAED,qEAAqE;AACrE,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACpD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,CAAC,mBAAmB,CAAC,CAAC,EAAE,OAAO,CAAC;CAC1C;AAED,oDAAoD;AACpD,MAAM,MAAM,sBAAsB,GAC9B,qBAAqB,GACrB,sBAAsB,CAAC;AAE3B,iFAAiF;AACjF,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC,CAAC;CACjE;AAED,+CAA+C;AAC/C,MAAM,WAAW,wBAAwB;IACvC,6BAA6B;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,8CAA8C;IAC9C,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,iDAAiD;IACjD,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEjE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,oBAAoB,GAC1B,sBAAsB,CAoBxB;AAED;;;;;;;;GAQG;AACH,wBAAsB,wBAAwB,CAC5C,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC,EAC9D,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,wBAAwB,CAAC,CAanC;AAED,yEAAyE;AACzE,UAAU,cAAc;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAC7B,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC,GAC7D,cAAc,CA0ChB"}

package/dist/opencode/mcp-installer.js

@@ -0,0 +1,160 @@
+/**
+ * Install Lisa's MCP servers into a host project's `opencode.json` `mcp` key.
+ *
+ * OpenCode does NOT load plugin-bundled MCP servers — they must be declared in
+ * config (the "Wrap" pattern). So `processOpencodeEmit` collects Lisa's servers
+ * from the built plugin `.mcp.json` files (base + each detected stack, via the
+ * shared `collectLisaMcpServers`) and writes them into the `mcp` object of the
+ * project's `opencode.json`, translated to OpenCode's transport shape:
+ *
+ *   - stdio  → `{ type: "local",  command: [...], environment: {...}, enabled }`
+ *     (`command` is a single ARRAY — argv[0] is the binary, the rest are args).
+ *   - http   → `{ type: "remote", url: "...", headers: {...}, enabled }`
+ *
+ * See opencode.ai/docs/mcp-servers and /docs/config.
+ *
+ * Tagged-merge convention (mirrors `src/agy/mcp-installer.ts`): every Lisa-owned
+ * server entry carries `_lisaManaged: true`, so a re-run strips Lisa's previous
+ * entries and rewrites them while preserving any host-authored servers verbatim.
+ * The edit is surgical (only the `mcp` key is rewritten via `jsonc-parser`), so
+ * sibling keys, comments, and formatting elsewhere in `opencode.json` survive.
+ * @module opencode/mcp-installer
+ */
+import { existsSync } from "node:fs";
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import * as path from "node:path";
+import { applyEdits, modify, parse as parseJsonc, } from "jsonc-parser";
+import { CONFIG_FILENAME, OPENCODE_SCHEMA_URL } from "./settings-installer.js";
+/** Marker field tagged onto every Lisa-owned MCP server entry. */
+export const LISA_MANAGED_MARKER = "_lisaManaged";
+/** JSONC edit formatting — 2-space indent, matching the repo's JSON style. */
+const FORMATTING_OPTIONS = {
+    formattingOptions: { tabSize: 2, insertSpaces: true },
+};
+/**
+ * Resolve the absolute path to a project's `opencode.json`.
+ * @param destDir - Absolute path to the host project root.
+ * @returns Absolute path to `<destDir>/opencode.json`.
+ */
+export function resolveOpencodeConfigPath(destDir) {
+    return path.join(destDir, CONFIG_FILENAME);
+}
+/**
+ * Translate a Claude/Codex-shape MCP entry to OpenCode's shape.
+ *
+ * Rules:
+ *   - stdio (`command` present): `type: "local"`, fold `command` + `args` into
+ *     a single argv array, rename `env` → `environment`, set `enabled: true`.
+ *   - http/sse (`url` present): `type: "remote"`, keep `url` + `headers`, set
+ *     `enabled: true`.
+ *
+ * The `_lisaManaged` marker is attached at write time, not in this pure transform.
+ * Throws if the entry has neither `command` nor `url` (un-translatable).
+ * @param input - Claude/Codex-format MCP server entry.
+ * @returns OpenCode-format MCP server entry.
+ */
+export function translateMcpEntryToOpencode(input) {
+    if (input.command !== undefined) {
+        return {
+            type: "local",
+            command: [input.command, ...(input.args ?? [])],
+            ...(input.env !== undefined ? { environment: input.env } : {}),
+            enabled: true,
+        };
+    }
+    if (input.url !== undefined) {
+        return {
+            type: "remote",
+            url: input.url,
+            ...(input.headers !== undefined ? { headers: input.headers } : {}),
+            enabled: true,
+        };
+    }
+    throw new Error("translateMcpEntryToOpencode: entry has neither `command` (stdio) nor `url` (http)");
+}
+/**
+ * Install Lisa's MCP servers into `<destDir>/opencode.json` using tagged-merge.
+ *
+ * Always call this — even with an empty `lisaMcpServers` — so previously written
+ * `_lisaManaged` entries are stripped when a project stops shipping MCP servers.
+ * @param lisaMcpServers - Lisa's MCP servers in Claude/Codex shape, keyed by name.
+ * @param configPath - Absolute path to the target `opencode.json`.
+ * @returns Result with the path written and entry counts.
+ */
+export async function installOpencodeMcpConfig(lisaMcpServers, configPath) {
+    const exists = existsSync(configPath);
+    const existingContent = exists ? await readFile(configPath, "utf8") : "";
+    const merged = mergeMcpServers(existingContent, lisaMcpServers);
+    await mkdir(path.dirname(configPath), { recursive: true });
+    await writeFile(configPath, merged.text, "utf8");
+    return {
+        path: configPath,
+        lisaEntryCount: merged.lisaEntryCount,
+        hostEntryCount: merged.hostEntryCount,
+    };
+}
+/**
+ * Merge Lisa's MCP servers into the `mcp` key of an `opencode.json` document.
+ * Pure function for testability; `installOpencodeMcpConfig` is the I/O wrapper.
+ *
+ * Tagged-merge rules:
+ *   1. Translate + tag Lisa's entries with `_lisaManaged: true`.
+ *   2. Drop every existing entry already tagged `_lisaManaged` (Lisa's prior run).
+ *   3. Preserve host-authored entries (untagged) verbatim.
+ *   4. Rewrite only the `mcp` key; the rest of the document is untouched.
+ *
+ * Throws on invalid JSONC so a corrupt host file is surfaced, not overwritten.
+ * @param existingJsonc - Current contents of `opencode.json` (or "").
+ * @param lisaMcpServers - Lisa's MCP servers in Claude/Codex shape, keyed by name.
+ * @returns The merged document text and entry counts.
+ */
+export function mergeMcpServers(existingJsonc, lisaMcpServers) {
+    const lisaEntries = Object.fromEntries(Object.entries(lisaMcpServers).map(([name, entry]) => [
+        name,
+        { ...translateMcpEntryToOpencode(entry), [LISA_MANAGED_MARKER]: true },
+    ]));
+    if (existingJsonc.trim().length === 0) {
+        const doc = { $schema: OPENCODE_SCHEMA_URL, mcp: lisaEntries };
+        return {
+            text: `${JSON.stringify(doc, null, 2)}\n`,
+            lisaEntryCount: Object.keys(lisaEntries).length,
+            hostEntryCount: 0,
+        };
+    }
+    const current = parseJsoncOrThrow(existingJsonc);
+    const existingMcp = current.mcp !== null &&
+        typeof current.mcp === "object" &&
+        !Array.isArray(current.mcp)
+        ? current.mcp
+        : {};
+    const hostEntries = Object.fromEntries(Object.entries(existingMcp).filter(([, entry]) => entry?.[LISA_MANAGED_MARKER] !== true));
+    const mergedMcp = { ...hostEntries, ...lisaEntries };
+    const edits = modify(existingJsonc, ["mcp"], mergedMcp, FORMATTING_OPTIONS);
+    const applied = applyEdits(existingJsonc, edits);
+    return {
+        text: applied.endsWith("\n") ? applied : `${applied}\n`,
+        lisaEntryCount: Object.keys(lisaEntries).length,
+        hostEntryCount: Object.keys(hostEntries).length,
+    };
+}
+/**
+ * Parse JSONC, throwing a descriptive error on the first syntax problem so a
+ * corrupt host `opencode.json` is surfaced rather than silently overwritten.
+ * @param jsonc - Raw `opencode.json` contents.
+ * @returns The parsed object (empty object if the root is a non-object).
+ */
+function parseJsoncOrThrow(jsonc) {
+    const errors = [];
+    const parsed = parseJsonc(jsonc, errors, {
+        allowTrailingComma: true,
+        disallowComments: false,
+    });
+    if (errors.length > 0) {
+        throw new Error(`opencode.json is not valid JSONC (offset ${errors[0]?.offset ?? 0}); ` +
+            `refusing to overwrite host config`);
+    }
+    return parsed !== null && typeof parsed === "object"
+        ? parsed
+        : {};
+}
+//# sourceMappingURL=mcp-installer.js.map

package/dist/opencode/mcp-installer.js.map

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

package/dist/opencode/settings-installer.d.ts

@@ -0,0 +1,41 @@
+/** Filename of OpenCode's project-scope config file (at the project root). */
+export declare const CONFIG_FILENAME = "opencode.json";
+/** OpenCode's config JSON-schema URL, used to seed `$schema` on fresh files. */
+export declare const OPENCODE_SCHEMA_URL = "https://opencode.ai/config.json";
+/**
+ * Lisa-required settings forced into `opencode.json`. For these keys Lisa wins
+ * on conflict; every other key the host authors is preserved untouched.
+ *
+ * `share: "disabled"` is the headline entry — OpenCode sharing is ON by default
+ * and creates public URLs, so disabling it is an enterprise-safety guarantee.
+ */
+export declare const LISA_REQUIRED_SETTINGS: Readonly<Record<string, unknown>>;
+/** Result of a settings install pass. */
+export interface SettingsInstallResult {
+    /** Files written, relative to the project root. */
+    readonly managedFiles: readonly string[];
+    /** Whether `opencode.json` was newly created (vs. merged in place). */
+    readonly created: boolean;
+}
+/**
+ * Install or update Lisa's required settings in `<destDir>/opencode.json`.
+ *
+ * Host keys, comments, and formatting survive because the merge edits the
+ * document surgically rather than reserializing it.
+ * @param destDir - Absolute path to the host project root.
+ * @returns Result describing what was written.
+ */
+export declare function installSettings(destDir: string): Promise<SettingsInstallResult>;
+/**
+ * Merge Lisa-required settings into an `opencode.json` (JSONC) document. Pure
+ * function for testability; `installSettings` is the I/O wrapper.
+ *
+ * Empty input yields a clean Lisa-authored document. Non-empty input is parsed
+ * tolerantly (comments + trailing commas allowed) and edited key-by-key so
+ * surrounding host content is preserved byte-for-byte. Throws on invalid JSONC
+ * so a malformed host file is surfaced rather than silently overwritten.
+ * @param existingJsonc - Current contents of `opencode.json` (or "").
+ * @returns Merged JSON/JSONC string with host content preserved.
+ */
+export declare function mergeSettings(existingJsonc: string): string;
+//# sourceMappingURL=settings-installer.d.ts.map

package/dist/opencode/settings-installer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-installer.d.ts","sourceRoot":"","sources":["../../src/opencode/settings-installer.ts"],"names":[],"mappings":"AAgCA,8EAA8E;AAC9E,eAAO,MAAM,eAAe,kBAAkB,CAAC;AAE/C,gFAAgF;AAChF,eAAO,MAAM,mBAAmB,oCAAoC,CAAC;AAErE;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEpE,CAAC;AAOF,yCAAyC;AACzC,MAAM,WAAW,qBAAqB;IACpC,mDAAmD;IACnD,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,uEAAuE;IACvE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED;;;;;;;GAOG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,qBAAqB,CAAC,CAahC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAmB3D"}

package/dist/opencode/settings-installer.js

@@ -0,0 +1,127 @@
+/**
+ * Manage Lisa-required settings in a host project's `opencode.json`.
+ *
+ * OpenCode reads project-scope config from `opencode.json` at the project root
+ * (JSON or JSONC — comments and trailing commas are allowed; see
+ * opencode.ai/docs/config). Config files across scopes are *merged*, not
+ * replaced, so Lisa writes only the project file and only the handful of keys it
+ * owns; every host-authored key, comment, and formatting choice is preserved by
+ * editing the document surgically via `jsonc-parser` (the JSON analogue of the
+ * `toml-patch` round-trip the Codex settings installer relies on).
+ *
+ * Lisa-owned keys (host wins for everything NOT listed; Lisa wins for these):
+ *   - `share`: forced to `"disabled"`. OpenCode session sharing defaults to ON
+ *     and mints PUBLIC share URLs for conversations — an enterprise data-exposure
+ *     hazard. Lisa disables it so applying the fleet config can never silently
+ *     publish a host's sessions.
+ *
+ * `$schema` is set to OpenCode's schema URL ONLY when absent (a default, not a
+ * force) so editor validation works on fresh files without clobbering a host
+ * that pinned a different schema.
+ * @module opencode/settings-installer
+ */
+import { existsSync } from "node:fs";
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import * as path from "node:path";
+import { applyEdits, modify, parse as parseJsonc, } from "jsonc-parser";
+/** Filename of OpenCode's project-scope config file (at the project root). */
+export const CONFIG_FILENAME = "opencode.json";
+/** OpenCode's config JSON-schema URL, used to seed `$schema` on fresh files. */
+export const OPENCODE_SCHEMA_URL = "https://opencode.ai/config.json";
+/**
+ * Lisa-required settings forced into `opencode.json`. For these keys Lisa wins
+ * on conflict; every other key the host authors is preserved untouched.
+ *
+ * `share: "disabled"` is the headline entry — OpenCode sharing is ON by default
+ * and creates public URLs, so disabling it is an enterprise-safety guarantee.
+ */
+export const LISA_REQUIRED_SETTINGS = {
+    share: "disabled",
+};
+/** JSONC edit formatting — 2-space indent, matching the repo's JSON style. */
+const FORMATTING_OPTIONS = {
+    formattingOptions: { tabSize: 2, insertSpaces: true },
+};
+/**
+ * Install or update Lisa's required settings in `<destDir>/opencode.json`.
+ *
+ * Host keys, comments, and formatting survive because the merge edits the
+ * document surgically rather than reserializing it.
+ * @param destDir - Absolute path to the host project root.
+ * @returns Result describing what was written.
+ */
+export async function installSettings(destDir) {
+    const configPath = path.join(destDir, CONFIG_FILENAME);
+    const exists = existsSync(configPath);
+    const existingContent = exists ? await readFile(configPath, "utf8") : "";
+    const merged = mergeSettings(existingContent);
+    await mkdir(path.dirname(configPath), { recursive: true });
+    await writeFile(configPath, merged, "utf8");
+    return {
+        managedFiles: Object.freeze([CONFIG_FILENAME]),
+        created: !exists,
+    };
+}
+/**
+ * Merge Lisa-required settings into an `opencode.json` (JSONC) document. Pure
+ * function for testability; `installSettings` is the I/O wrapper.
+ *
+ * Empty input yields a clean Lisa-authored document. Non-empty input is parsed
+ * tolerantly (comments + trailing commas allowed) and edited key-by-key so
+ * surrounding host content is preserved byte-for-byte. Throws on invalid JSONC
+ * so a malformed host file is surfaced rather than silently overwritten.
+ * @param existingJsonc - Current contents of `opencode.json` (or "").
+ * @returns Merged JSON/JSONC string with host content preserved.
+ */
+export function mergeSettings(existingJsonc) {
+    if (existingJsonc.trim().length === 0) {
+        const fresh = { $schema: OPENCODE_SCHEMA_URL, ...LISA_REQUIRED_SETTINGS };
+        return `${JSON.stringify(fresh, null, 2)}\n`;
+    }
+    const current = parseJsoncOrThrow(existingJsonc);
+    const withForced = Object.entries(LISA_REQUIRED_SETTINGS).reduce((text, [key, value]) => upsertKey(text, [key], value, current[key]), existingJsonc);
+    // `$schema` is a default, not a force: only set it when the host omitted it.
+    const withSchema = current["$schema"] === undefined
+        ? upsertKey(withForced, ["$schema"], OPENCODE_SCHEMA_URL, undefined)
+        : withForced;
+    return withSchema.endsWith("\n") ? withSchema : `${withSchema}\n`;
+}
+/**
+ * Parse JSONC, throwing a descriptive error on the first syntax problem.
+ *
+ * Comments and trailing commas are tolerated (OpenCode permits both); genuine
+ * syntax errors throw so a corrupt host config is never silently clobbered.
+ * @param jsonc - Raw `opencode.json` contents.
+ * @returns The parsed object (empty object if the root is a non-object).
+ */
+function parseJsoncOrThrow(jsonc) {
+    const errors = [];
+    const parsed = parseJsonc(jsonc, errors, {
+        allowTrailingComma: true,
+        disallowComments: false,
+    });
+    if (errors.length > 0) {
+        throw new Error(`opencode.json is not valid JSONC (offset ${errors[0]?.offset ?? 0}); ` +
+            `refusing to overwrite host config`);
+    }
+    return parsed !== null && typeof parsed === "object"
+        ? parsed
+        : {};
+}
+/**
+ * Set `value` at `keyPath` via a surgical JSONC edit, skipping the write when
+ * the document already holds that value (keeps re-runs no-op-clean).
+ * @param text - Current document text.
+ * @param keyPath - JSON path to the key (single-segment for our keys).
+ * @param value - Value to set.
+ * @param currentValue - The value already present at `keyPath` (or undefined).
+ * @returns The edited document text.
+ */
+function upsertKey(text, keyPath, value, currentValue) {
+    if (currentValue === value) {
+        return text;
+    }
+    const edits = modify(text, [...keyPath], value, FORMATTING_OPTIONS);
+    return applyEdits(text, edits);
+}
+//# sourceMappingURL=settings-installer.js.map

package/dist/opencode/settings-installer.js.map

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

package/dist/opencode/skills-installer.d.ts

@@ -0,0 +1,32 @@
+/** Subdirectory inside `.opencode/skills/` where Lisa-owned skills live */
+export declare const LISA_SKILLS_SUBDIR: string;
+/** Result of one skill copy */
+export interface InstalledSkill {
+    /** Skill name (matches the SKILL.md `name` frontmatter) */
+    readonly name: string;
+    /** Source kind: bundled skill folder or generated from command */
+    readonly source: "bundled" | "command";
+    /** Path written, relative to `.opencode/` */
+    readonly relativePath: string;
+}
+/** Aggregated result */
+export interface SkillsInstallResult {
+    readonly installed: readonly InstalledSkill[];
+    readonly managedFiles: readonly string[];
+    /** Skill directories deleted because Lisa stopped shipping them */
+    readonly deleted: readonly string[];
+}
+/**
+ * Install all Lisa-bundled skills + command-derived skills into
+ * `.opencode/skills/lisa/`.
+ *
+ * Stale skills (in the previous manifest but no longer in Lisa's catalog) are
+ * deleted so renames in the source tree don't leave orphan directories behind.
+ * @param lisaDir - Absolute path to the Lisa repo root.
+ * @param destDir - Absolute path to the host project root.
+ * @param previousManagedFiles - Files Lisa managed on the previous run
+ *   (relative to `.opencode/`); used to detect stale skill directories.
+ * @returns Result describing installed skills + managed files + deletions.
+ */
+export declare function installSkills(lisaDir: string, destDir: string, previousManagedFiles: readonly string[]): Promise<SkillsInstallResult>;
+//# sourceMappingURL=skills-installer.d.ts.map

package/dist/opencode/skills-installer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills-installer.d.ts","sourceRoot":"","sources":["../../src/opencode/skills-installer.ts"],"names":[],"mappings":"AAsCA,2EAA2E;AAC3E,eAAO,MAAM,kBAAkB,QAA8B,CAAC;AAW9D,+BAA+B;AAC/B,MAAM,WAAW,cAAc;IAC7B,2DAA2D;IAC3D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,kEAAkE;IAClE,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,CAAC;IACvC,6CAA6C;IAC7C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED,wBAAwB;AACxB,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,SAAS,EAAE,SAAS,cAAc,EAAE,CAAC;IAC9C,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,mEAAmE;IACnE,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,oBAAoB,EAAE,SAAS,MAAM,EAAE,GACtC,OAAO,CAAC,mBAAmB,CAAC,CA6C9B"}

package/dist/opencode/skills-installer.js

@@ -0,0 +1,159 @@
+/**
+ * Install Lisa-bundled skills into a host project's `.opencode/skills/lisa/`.
+ *
+ * OpenCode discovers skills (the open Agent Skills format: SKILL.md + optional
+ * siblings) natively from `.opencode/skills/<name>/`, walking up from the cwd to
+ * the git worktree (see opencode.ai/docs/skills). It ALSO reads `.claude/skills`
+ * and `.agents/skills`, but Lisa writes into the OpenCode-owned `.opencode/`
+ * tree so its artifacts never collide with a Claude install on the same machine
+ * (OpenCode dedupes duplicate skill names with a warning — verified-by-run on
+ * opencode 1.16.2).
+ *
+ * What this installs:
+ *   1. Lisa-bundled skill folders from `plugins/<p>/skills/<n>/` copied verbatim
+ *      to `.opencode/skills/lisa/<n>/` (OpenCode reads SKILL.md verbatim — no
+ *      transform needed, unlike the Codex TOML/openai.yaml path).
+ *   2. Lisa commands converted to skills with a `lisa-` prefix, since the safest
+ *      cross-runtime carrier for a Lisa command is a self-complete skill.
+ *
+ * Source discovery (walking the plugin tree, dedup, denylist) is shared with the
+ * Codex overlay via `core/lisa-skill-sources`.
+ * @module opencode/skills-installer
+ */
+import * as fse from "fs-extra";
+import { mkdir, copyFile, readFile, rm, writeFile } from "node:fs/promises";
+import * as path from "node:path";
+import { discoverBundledSkills, discoverLisaCommands, loadSkillDenylist, } from "../core/lisa-skill-sources.js";
+import { convertCommandToSkill } from "../codex/command-skill-transformer.js";
+import { OPENCODE_CONFIG_DIR } from "./manifest.js";
+/** Runtime label threaded into generated command-as-skill compatibility notes */
+const OPENCODE_RUNTIME_LABEL = "OpenCode";
+/** Subdirectory inside `.opencode/skills/` where Lisa-owned skills live */
+export const LISA_SKILLS_SUBDIR = path.join("skills", "lisa");
+/** Filename of the skill manifest at the root of every skill folder */
+const SKILL_MD_FILENAME = "SKILL.md";
+/** Path to the OpenCode skill distribution policy, relative to the Lisa root */
+const INTERNAL_OPENCODE_SKILL_POLICY_RELATIVE_PATH = path.join("scripts", "internal-opencode-skill-policy.json");
+/**
+ * Install all Lisa-bundled skills + command-derived skills into
+ * `.opencode/skills/lisa/`.
+ *
+ * Stale skills (in the previous manifest but no longer in Lisa's catalog) are
+ * deleted so renames in the source tree don't leave orphan directories behind.
+ * @param lisaDir - Absolute path to the Lisa repo root.
+ * @param destDir - Absolute path to the host project root.
+ * @param previousManagedFiles - Files Lisa managed on the previous run
+ *   (relative to `.opencode/`); used to detect stale skill directories.
+ * @returns Result describing installed skills + managed files + deletions.
+ */
+export async function installSkills(lisaDir, destDir, previousManagedFiles) {
+    const skillsDir = path.join(destDir, OPENCODE_CONFIG_DIR, LISA_SKILLS_SUBDIR);
+    await fse.ensureDir(skillsDir);
+    const denylistedSkills = await loadSkillDenylist(lisaDir, INTERNAL_OPENCODE_SKILL_POLICY_RELATIVE_PATH);
+    // Step 1: bundled skills
+    const bundled = await discoverBundledSkills(lisaDir, denylistedSkills);
+    const bundledInstalls = await Promise.all(bundled.map(source => copyBundledSkill(source, skillsDir)));
+    const bundledFiles = bundled.flatMap(source => source.files.map(file => path.join(LISA_SKILLS_SUBDIR, source.skillName, file)));
+    // Step 2: command-as-skill conversions
+    const commandSkills = await discoverLisaCommands(lisaDir);
+    const commandInstalls = await Promise.all(commandSkills.map(cmd => emitCommandAsSkill(cmd, skillsDir)));
+    const commandFiles = commandInstalls.map(install => path.join(LISA_SKILLS_SUBDIR, install.name, SKILL_MD_FILENAME));
+    const installed = [
+        ...bundledInstalls,
+        ...commandInstalls,
+    ];
+    // Step 3: delete stale skill directories
+    const deleted = await deleteStaleSkills(previousManagedFiles, new Set(installed.map(s => s.name)), destDir);
+    return {
+        installed: Object.freeze(installed),
+        managedFiles: Object.freeze([...bundledFiles, ...commandFiles]),
+        deleted: Object.freeze(deleted),
+    };
+}
+/**
+ * Delete skill directories that were Lisa-managed last run but aren't shipped
+ * this run. Identifies skill names from the previous manifest by looking for
+ * paths inside `.opencode/skills/lisa/<name>/...`.
+ *
+ * Whole directories are removed (not individual files) so siblings the host
+ * accidentally added inside a Lisa skill folder also disappear — Lisa owns the
+ * directory boundary, not just specific files.
+ * @param previousManagedFiles - Files Lisa managed on the previous run
+ *   (relative to `.opencode/`).
+ * @param currentSkillNames - Skill names Lisa is shipping this run.
+ * @param destDir - Absolute path to the host project root.
+ * @returns Sorted list of stale skill names that were deleted.
+ */
+async function deleteStaleSkills(previousManagedFiles, currentSkillNames, destDir) {
+    const lisaSkillsPrefix = `${LISA_SKILLS_SUBDIR}${path.sep}`;
+    const previousSkillNames = extractPreviousSkillNames(previousManagedFiles, lisaSkillsPrefix);
+    const stale = previousSkillNames.filter(name => !currentSkillNames.has(name));
+    await Promise.all(stale.map(async (name) => {
+        const absPath = path.join(destDir, OPENCODE_CONFIG_DIR, LISA_SKILLS_SUBDIR, name);
+        if (await fse.pathExists(absPath)) {
+            await rm(absPath, { recursive: true, force: true });
+        }
+    }));
+    return Object.freeze([...stale].sort((a, b) => a.localeCompare(b)));
+}
+/**
+ * Pick the unique skill-folder names out of the previous manifest's file list —
+ * every path inside `.opencode/skills/lisa/<name>/...` contributes `<name>`.
+ * @param previousManagedFiles - Files Lisa managed on the previous run.
+ * @param lisaSkillsPrefix - The path prefix that identifies Lisa skill files.
+ * @returns Unique skill names extracted from those paths.
+ */
+function extractPreviousSkillNames(previousManagedFiles, lisaSkillsPrefix) {
+    const names = previousManagedFiles
+        .filter(file => file.startsWith(lisaSkillsPrefix))
+        .map(file => file.slice(lisaSkillsPrefix.length).split(path.sep)[0])
+        .filter((name) => Boolean(name));
+    return Array.from(new Set(names));
+}
+/**
+ * Copy one bundled skill folder verbatim into `.opencode/skills/lisa/`.
+ * @param source - Bundled-skill source to copy.
+ * @param skillsDir - Absolute path to `<destDir>/.opencode/skills/lisa/`.
+ * @returns Result describing the installed skill.
+ */
+async function copyBundledSkill(source, skillsDir) {
+    const destSkillDir = path.join(skillsDir, source.skillName);
+    // Clean-replace the Lisa-owned skill folder before copying so files removed
+    // from the source between releases don't linger inside a surviving skill.
+    // Lisa owns this directory boundary (host customizations belong outside it).
+    await rm(destSkillDir, { recursive: true, force: true });
+    await fse.ensureDir(destSkillDir);
+    await Promise.all(source.files.map(async (file) => {
+        const srcPath = path.join(source.sourceDir, file);
+        const destPath = path.join(destSkillDir, file);
+        await mkdir(path.dirname(destPath), { recursive: true });
+        await copyFile(srcPath, destPath);
+    }));
+    return {
+        name: source.skillName,
+        source: "bundled",
+        relativePath: path.join(LISA_SKILLS_SUBDIR, source.skillName),
+    };
+}
+/**
+ * Convert a Lisa command Markdown file into an OpenCode skill.
+ *
+ * The command body becomes the skill body, with `$ARGUMENTS` replaced by an
+ * explicit instruction to use the user's surrounding request as arguments.
+ * @param cmd - Discovered command source.
+ * @param skillsDir - Absolute path to `<destDir>/.opencode/skills/lisa/`.
+ * @returns Result describing the installed (command-derived) skill.
+ */
+async function emitCommandAsSkill(cmd, skillsDir) {
+    const sourceContent = await readFile(cmd.sourcePath, "utf8");
+    const skillContent = convertCommandToSkill(sourceContent, cmd.skillName, cmd.displayName, OPENCODE_RUNTIME_LABEL);
+    const destSkillDir = path.join(skillsDir, cmd.skillName);
+    await fse.ensureDir(destSkillDir);
+    await writeFile(path.join(destSkillDir, SKILL_MD_FILENAME), skillContent, "utf8");
+    return {
+        name: cmd.skillName,
+        source: "command",
+        relativePath: path.join(LISA_SKILLS_SUBDIR, cmd.skillName),
+    };
+}
+//# sourceMappingURL=skills-installer.js.map

package/dist/opencode/skills-installer.js.map

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