@codyswann/lisa 2.150.1 → 2.152.0

package/dist/opencode/agent-installer.js

@@ -0,0 +1,120 @@
+/**
+ * Install Lisa-bundled agents into a host project's `.opencode/agents/`.
+ *
+ * Pipeline per agent:
+ *   1. Read the source `.md` from the Lisa plugin (discovered via the shared
+ *      `discoverLisaAgents` walker, identical to the Codex overlay).
+ *   2. Transform Markdown + YAML frontmatter → OpenCode subagent Markdown
+ *      (frontmatter `description` + `mode: subagent`; body is the prompt). This
+ *      is a near-passthrough — OpenCode agents are Markdown like Claude's, so it
+ *      is simpler than the Codex TOML transform.
+ *   3. Write the result to `.opencode/agents/lisa-<id>.md`.
+ *
+ * The `lisa-` filename prefix is the ownership boundary: OpenCode derives an
+ * agent's name from its filename and reads `.opencode/agents/` flat (verified on
+ * opencode 1.16.2 — `opencode agent list` surfaces files placed there), so a
+ * prefix — rather than a `lisa/` subdir as used for skills — is what keeps Lisa
+ * agents from colliding with host-authored agents and gives stale cleanup a safe
+ * scope. Host agents (any file NOT starting with `lisa-`) are never touched.
+ *
+ * Stale agents (in the previous manifest but no longer shipped by Lisa) are
+ * deleted so renames in the source tree don't leave orphans behind.
+ * @module opencode/agent-installer
+ */
+import * as fse from "fs-extra";
+import { readFile, unlink, writeFile } from "node:fs/promises";
+import * as path from "node:path";
+import { discoverLisaAgents, } from "../codex/agent-installer.js";
+import { isHarnessVariantPlugin } from "../core/lisa-skill-sources.js";
+import { transformAgentMarkdownToOpencode } from "./agent-transformer.js";
+import { OPENCODE_CONFIG_DIR } from "./manifest.js";
+export { discoverLisaAgents, } from "../codex/agent-installer.js";
+/** Subdirectory inside `.opencode/` where Lisa-owned agents live */
+export const LISA_AGENTS_SUBDIR = "agents";
+/**
+ * Filename prefix marking an agent file as Lisa-owned. OpenCode reads
+ * `.opencode/agents/` flat, so the prefix (not a subdirectory) is the ownership
+ * boundary used for collision avoidance and stale cleanup.
+ */
+export const LISA_AGENT_FILE_PREFIX = "lisa-";
+/**
+ * Install all discovered agents into `<destDir>/.opencode/agents/`.
+ *
+ * Returns a result describing what was written and what stale files were
+ * deleted, so the caller can update the Lisa-managed manifest.
+ * @param sources - Agent sources from discoverLisaAgents
+ * @param destDir - Absolute path to the destination project root
+ * @param previousManagedFiles - Files Lisa managed on the previous run
+ *   (relative to `.opencode/`); used to detect stale agents to delete
+ * @returns Result describing installed/deleted/managedFiles
+ */
+export async function installAgents(sources, destDir, previousManagedFiles) {
+    const agentsDir = path.join(destDir, OPENCODE_CONFIG_DIR, LISA_AGENTS_SUBDIR);
+    await fse.ensureDir(agentsDir);
+    const installed = await Promise.all(sources.map(source => installSingleAgent(source, agentsDir)));
+    const managedFiles = installed.map(agent => agent.relativePath);
+    const deleted = await deleteStaleAgents(previousManagedFiles, managedFiles, destDir);
+    return {
+        installed: Object.freeze(installed),
+        deleted: Object.freeze(deleted),
+        managedFiles: Object.freeze(managedFiles),
+    };
+}
+/**
+ * Transform + write a single agent file.
+ * @param source - Discovered agent source (id, plugin, source path)
+ * @param agentsDir - Absolute path to `.opencode/agents/` in the host project
+ * @returns Result describing the installed file
+ */
+async function installSingleAgent(source, agentsDir) {
+    const sourceContent = await readFile(source.sourcePath, "utf8");
+    const markdown = transformAgentMarkdownToOpencode(sourceContent);
+    const filename = `${LISA_AGENT_FILE_PREFIX}${source.id}.md`;
+    await writeFile(path.join(agentsDir, filename), markdown, "utf8");
+    return {
+        id: source.id,
+        relativePath: path.join(LISA_AGENTS_SUBDIR, filename),
+    };
+}
+/**
+ * Delete files that were Lisa-managed last run but aren't shipped this run.
+ * Only deletes files inside `.opencode/agents/` whose basename carries the
+ * `lisa-` prefix, so host-authored agents are never removed even if the
+ * previous manifest somehow references them.
+ * @param previousManagedFiles - Files Lisa managed on the previous run
+ *   (relative to `.opencode/`)
+ * @param currentManagedFiles - Files Lisa is shipping this run (relative
+ *   to `.opencode/`)
+ * @param destDir - Absolute path to the host project root
+ * @returns The list of relative paths that were deleted
+ */
+async function deleteStaleAgents(previousManagedFiles, currentManagedFiles, destDir) {
+    const currentSet = new Set(currentManagedFiles);
+    const lisaAgentPrefix = `${LISA_AGENTS_SUBDIR}${path.sep}${LISA_AGENT_FILE_PREFIX}`;
+    const stale = previousManagedFiles.filter(file => !currentSet.has(file) && file.startsWith(lisaAgentPrefix));
+    await Promise.all(stale.map(async (file) => {
+        const absPath = path.join(destDir, OPENCODE_CONFIG_DIR, file);
+        if (await fse.pathExists(absPath)) {
+            await unlink(absPath);
+        }
+    }));
+    return Object.freeze(stale);
+}
+/**
+ * Convenience one-shot: discover Lisa agents from `lisaDir` and install them.
+ *
+ * Discovery is restricted to canonical plugins — the per-harness fanout variants
+ * (`*-agy`, `*-copilot`, `*-cursor`) are skipped. The copilot variants rename
+ * agents to `*.agent.md`, which would otherwise slip past id-dedup and ship a
+ * duplicate `lisa-<name>.agent` for every agent; the cursor/agy variants are
+ * just reformatted copies of the base agents.
+ * @param lisaDir - Absolute path to the Lisa repo / installed package
+ * @param destDir - Absolute path to the destination project root
+ * @param previousManagedFiles - Files Lisa managed on the previous run
+ * @returns Result describing installed/deleted/managedFiles
+ */
+export async function discoverAndInstallAgents(lisaDir, destDir, previousManagedFiles) {
+    const sources = await discoverLisaAgents(lisaDir, name => !isHarnessVariantPlugin(name));
+    return installAgents(sources, destDir, previousManagedFiles);
+}
+//# sourceMappingURL=agent-installer.js.map

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

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

package/dist/opencode/agent-transformer.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Transform a Claude Code-style agent definition (Markdown with YAML
+ * frontmatter) into an OpenCode subagent Markdown file.
+ *
+ * Claude Code agent shape:
+ * ```
+ * ---
+ * name: bug-fixer
+ * description: ...
+ * tools: Read, Bash             # optional; preserved as compatibility context
+ * model: sonnet                 # optional; preserved as compatibility context
+ * skills: [skill-a, skill-b]    # optional; preserved as context
+ * ---
+ * # Body becomes the agent prompt
+ * ```
+ *
+ * OpenCode agent shape (per https://opencode.ai/docs/agents):
+ * ```
+ * ---
+ * description: ...
+ * mode: subagent
+ * ---
+ * # Body is the agent prompt
+ * ```
+ *
+ * OpenCode agents are Markdown like Claude's, so — unlike the Codex TOML
+ * transform — this is a near-passthrough: the body is preserved verbatim and
+ * the only required reshape is the frontmatter. The agent NAME is derived by
+ * OpenCode from the destination filename (not a frontmatter field), so the
+ * installer owns naming; this transformer only owns the file contents.
+ *
+ * Claude-only metadata (`tools`, `model`, `skills`) is NOT emitted as OpenCode
+ * frontmatter — `model` expects a `provider/model` string that a Claude alias
+ * (`sonnet`) would violate, and `tools`/`skills` have no 1:1 frontmatter slot.
+ * Instead that metadata is preserved as a context block in the body so nothing
+ * is silently dropped, mirroring the Codex transformer's compatibility blocks.
+ * @module opencode/agent-transformer
+ */
+import { type ParsedAgent } from "../codex/agent-transformer.js";
+/**
+ * Transform a parsed Lisa agent into OpenCode subagent Markdown.
+ * @param parsed - Output of parseAgentMarkdown (frontmatter + body)
+ * @returns OpenCode agent Markdown (frontmatter + prompt body)
+ */
+export declare function transformAgentToOpencodeMarkdown(parsed: ParsedAgent): string;
+/**
+ * One-shot helper: parse + transform.
+ * @param source - Raw contents of an agent .md file
+ * @returns OpenCode agent Markdown
+ */
+export declare function transformAgentMarkdownToOpencode(source: string): string;
+//# sourceMappingURL=agent-transformer.d.ts.map

package/dist/opencode/agent-transformer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-transformer.d.ts","sourceRoot":"","sources":["../../src/opencode/agent-transformer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,OAAO,EACL,KAAK,WAAW,EAEjB,MAAM,+BAA+B,CAAC;AAEvC;;;;GAIG;AACH,wBAAgB,gCAAgC,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAU5E;AAED;;;;GAIG;AACH,wBAAgB,gCAAgC,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEvE"}

package/dist/opencode/agent-transformer.js

@@ -0,0 +1,133 @@
+/**
+ * Transform a Claude Code-style agent definition (Markdown with YAML
+ * frontmatter) into an OpenCode subagent Markdown file.
+ *
+ * Claude Code agent shape:
+ * ```
+ * ---
+ * name: bug-fixer
+ * description: ...
+ * tools: Read, Bash             # optional; preserved as compatibility context
+ * model: sonnet                 # optional; preserved as compatibility context
+ * skills: [skill-a, skill-b]    # optional; preserved as context
+ * ---
+ * # Body becomes the agent prompt
+ * ```
+ *
+ * OpenCode agent shape (per https://opencode.ai/docs/agents):
+ * ```
+ * ---
+ * description: ...
+ * mode: subagent
+ * ---
+ * # Body is the agent prompt
+ * ```
+ *
+ * OpenCode agents are Markdown like Claude's, so — unlike the Codex TOML
+ * transform — this is a near-passthrough: the body is preserved verbatim and
+ * the only required reshape is the frontmatter. The agent NAME is derived by
+ * OpenCode from the destination filename (not a frontmatter field), so the
+ * installer owns naming; this transformer only owns the file contents.
+ *
+ * Claude-only metadata (`tools`, `model`, `skills`) is NOT emitted as OpenCode
+ * frontmatter — `model` expects a `provider/model` string that a Claude alias
+ * (`sonnet`) would violate, and `tools`/`skills` have no 1:1 frontmatter slot.
+ * Instead that metadata is preserved as a context block in the body so nothing
+ * is silently dropped, mirroring the Codex transformer's compatibility blocks.
+ * @module opencode/agent-transformer
+ */
+import { parseAgentMarkdown, } from "../codex/agent-transformer.js";
+/**
+ * Transform a parsed Lisa agent into OpenCode subagent Markdown.
+ * @param parsed - Output of parseAgentMarkdown (frontmatter + body)
+ * @returns OpenCode agent Markdown (frontmatter + prompt body)
+ */
+export function transformAgentToOpencodeMarkdown(parsed) {
+    const frontmatter = [
+        "---",
+        `description: ${jsonScalar(parsed.frontmatter.description)}`,
+        "mode: subagent",
+        "---",
+        "",
+    ].join("\n");
+    const body = composeAgentBody(parsed);
+    return `${frontmatter}${body}\n`;
+}
+/**
+ * One-shot helper: parse + transform.
+ * @param source - Raw contents of an agent .md file
+ * @returns OpenCode agent Markdown
+ */
+export function transformAgentMarkdownToOpencode(source) {
+    return transformAgentToOpencodeMarkdown(parseAgentMarkdown(source));
+}
+/**
+ * Build the OpenCode agent body. The original Claude body is preserved
+ * verbatim; any Claude-only metadata that has no OpenCode frontmatter slot is
+ * prepended as a context block so the information survives the transform.
+ * @param parsed - Output of parseAgentMarkdown for the source agent file
+ * @returns The composed Markdown body
+ */
+function composeAgentBody(parsed) {
+    const compatibilityBlock = formatCompatibilityBlock(parsed);
+    const skillsBlock = formatSkillsBlock(parsed);
+    return [compatibilityBlock, skillsBlock, parsed.body.trimEnd()]
+        .filter(block => block.length > 0)
+        .join("\n\n");
+}
+/**
+ * Preserve Claude-only `model`/`tools` metadata as an OpenCode context block.
+ * OpenCode governs model and tool access through its own runtime/config, so
+ * these are advisory notes rather than enforced settings.
+ * @param parsed - Parsed source agent
+ * @returns Markdown compatibility block, or an empty string when unnecessary
+ */
+function formatCompatibilityBlock(parsed) {
+    const { model, tools } = parsed.frontmatter;
+    const modelLines = model === undefined
+        ? []
+        : [
+            `- Claude requested model: \`${model}\`. OpenCode uses the active session model unless the host sets \`model\` on this agent.`,
+        ];
+    const toolLines = tools === undefined
+        ? []
+        : [
+            `- Claude allowed tools: \`${tools}\`. OpenCode tool access is governed by the active OpenCode runtime, \`permission\` settings, and project policy.`,
+        ];
+    const lines = [...modelLines, ...toolLines];
+    if (lines.length === 0) {
+        return "";
+    }
+    return ["## Claude Agent Compatibility", "", ...lines].join("\n");
+}
+/**
+ * Preserve the source agent's `skills:` list as a context block. OpenCode
+ * discovers these skills natively from `.opencode/skills/lisa/`, so this block
+ * just documents which ones the agent is expected to use.
+ * @param parsed - Parsed source agent
+ * @returns Markdown skills block, or an empty string when no skills are listed
+ */
+function formatSkillsBlock(parsed) {
+    const skills = parsed.frontmatter.skills;
+    if (skills === undefined || skills.length === 0) {
+        return "";
+    }
+    return [
+        "## Available Lisa Skills",
+        "",
+        "This agent operates in a Lisa-managed OpenCode environment with access to the following skills:",
+        "",
+        ...skills.map(skill => `- ${skill}`),
+    ].join("\n");
+}
+/**
+ * Encode a string as a YAML-safe flow scalar. A JSON-encoded string is always a
+ * valid YAML double-quoted scalar, so this safely handles descriptions that
+ * contain colons, quotes, or other YAML-significant characters.
+ * @param value - The raw string to encode
+ * @returns A double-quoted YAML scalar
+ */
+function jsonScalar(value) {
+    return JSON.stringify(value);
+}
+//# sourceMappingURL=agent-transformer.js.map

package/dist/opencode/agent-transformer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-transformer.js","sourceRoot":"","sources":["../../src/opencode/agent-transformer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,OAAO,EAEL,kBAAkB,GACnB,MAAM,+BAA+B,CAAC;AAEvC;;;;GAIG;AACH,MAAM,UAAU,gCAAgC,CAAC,MAAmB;IAClE,MAAM,WAAW,GAAG;QAClB,KAAK;QACL,gBAAgB,UAAU,CAAC,MAAM,CAAC,WAAW,CAAC,WAAW,CAAC,EAAE;QAC5D,gBAAgB;QAChB,KAAK;QACL,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACb,MAAM,IAAI,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACtC,OAAO,GAAG,WAAW,GAAG,IAAI,IAAI,CAAC;AACnC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gCAAgC,CAAC,MAAc;IAC7D,OAAO,gCAAgC,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC;AACtE,CAAC;AAED;;;;;;GAMG;AACH,SAAS,gBAAgB,CAAC,MAAmB;IAC3C,MAAM,kBAAkB,GAAG,wBAAwB,CAAC,MAAM,CAAC,CAAC;IAC5D,MAAM,WAAW,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC9C,OAAO,CAAC,kBAAkB,EAAE,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;SAC5D,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;SACjC,IAAI,CAAC,MAAM,CAAC,CAAC;AAClB,CAAC;AAED;;;;;;GAMG;AACH,SAAS,wBAAwB,CAAC,MAAmB;IACnD,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC,WAAW,CAAC;IAC5C,MAAM,UAAU,GACd,KAAK,KAAK,SAAS;QACjB,CAAC,CAAC,EAAE;QACJ,CAAC,CAAC;YACE,+BAA+B,KAAK,0FAA0F;SAC/H,CAAC;IACR,MAAM,SAAS,GACb,KAAK,KAAK,SAAS;QACjB,CAAC,CAAC,EAAE;QACJ,CAAC,CAAC;YACE,6BAA6B,KAAK,mHAAmH;SACtJ,CAAC;IACR,MAAM,KAAK,GAAG,CAAC,GAAG,UAAU,EAAE,GAAG,SAAS,CAAC,CAAC;IAC5C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,CAAC,+BAA+B,EAAE,EAAE,EAAE,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACpE,CAAC;AAED;;;;;;GAMG;AACH,SAAS,iBAAiB,CAAC,MAAmB;IAC5C,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC;IACzC,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChD,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO;QACL,0BAA0B;QAC1B,EAAE;QACF,iGAAiG;QACjG,EAAE;QACF,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,KAAK,EAAE,CAAC;KACrC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED;;;;;;GAMG;AACH,SAAS,UAAU,CAAC,KAAa;IAC/B,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC"}

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

@@ -0,0 +1,47 @@
+import { type LisaCommandSource } from "../core/lisa-skill-sources.js";
+export { type LisaCommandSource, discoverLisaCommands, } from "../core/lisa-skill-sources.js";
+/** Subdirectory inside `.opencode/` where Lisa-owned commands live */
+export declare const LISA_COMMANDS_SUBDIR = "commands";
+/**
+ * Filename prefix marking a command file as Lisa-owned. The shared command
+ * discovery already names every command `lisa-<...>`, so this matches the
+ * basename of every file Lisa writes and scopes stale cleanup safely.
+ */
+export declare const LISA_COMMAND_FILE_PREFIX = "lisa-";
+/** Result of installing one command */
+export interface InstalledCommand {
+    /** Command name (the `lisa-` prefixed, dash-joined skill name) */
+    readonly name: string;
+    /** Path written, relative to the destination project's `.opencode/` directory */
+    readonly relativePath: string;
+}
+/** Aggregated result of an install pass */
+export interface CommandInstallResult {
+    readonly installed: readonly InstalledCommand[];
+    /** Stale command files deleted from `.opencode/commands/` (relative to `.opencode/`) */
+    readonly deleted: readonly string[];
+    /** Files written, relative to `.opencode/`. Used to update the manifest. */
+    readonly managedFiles: readonly string[];
+}
+/**
+ * Install all discovered commands into `<destDir>/.opencode/commands/`.
+ * @param sources - Command sources from discoverLisaCommands
+ * @param destDir - Absolute path to the destination project root
+ * @param previousManagedFiles - Files Lisa managed on the previous run
+ *   (relative to `.opencode/`); used to detect stale commands to delete
+ * @returns Result describing installed/deleted/managedFiles
+ */
+export declare function installCommands(sources: readonly LisaCommandSource[], destDir: string, previousManagedFiles: readonly string[]): Promise<CommandInstallResult>;
+/**
+ * Convenience one-shot: discover Lisa commands from `lisaDir` and install them.
+ *
+ * Discovery is restricted to canonical plugins — the per-harness fanout variants
+ * (`*-agy`, `*-copilot`, `*-cursor`) are skipped so a reformatted variant copy
+ * of a command body never wins the last-wins dedup over the canonical source.
+ * @param lisaDir - Absolute path to the Lisa repo / installed package
+ * @param destDir - Absolute path to the destination project root
+ * @param previousManagedFiles - Files Lisa managed on the previous run
+ * @returns Result describing installed/deleted/managedFiles
+ */
+export declare function discoverAndInstallCommands(lisaDir: string, destDir: string, previousManagedFiles: readonly string[]): Promise<CommandInstallResult>;
+//# sourceMappingURL=command-installer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"command-installer.d.ts","sourceRoot":"","sources":["../../src/opencode/command-installer.ts"],"names":[],"mappings":"AAyBA,OAAO,EACL,KAAK,iBAAiB,EAGvB,MAAM,+BAA+B,CAAC;AAIvC,OAAO,EACL,KAAK,iBAAiB,EACtB,oBAAoB,GACrB,MAAM,+BAA+B,CAAC;AAEvC,sEAAsE;AACtE,eAAO,MAAM,oBAAoB,aAAa,CAAC;AAE/C;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,UAAU,CAAC;AAEhD,uCAAuC;AACvC,MAAM,WAAW,gBAAgB;IAC/B,kEAAkE;IAClE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,iFAAiF;IACjF,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED,2CAA2C;AAC3C,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,SAAS,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAChD,wFAAwF;IACxF,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,4EAA4E;IAC5E,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1C;AAED;;;;;;;GAOG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,SAAS,iBAAiB,EAAE,EACrC,OAAO,EAAE,MAAM,EACf,oBAAoB,EAAE,SAAS,MAAM,EAAE,GACtC,OAAO,CAAC,oBAAoB,CAAC,CA0B/B;AAyDD;;;;;;;;;;GAUG;AACH,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,oBAAoB,EAAE,SAAS,MAAM,EAAE,GACtC,OAAO,CAAC,oBAAoB,CAAC,CAM/B"}

package/dist/opencode/command-installer.js

@@ -0,0 +1,112 @@
+/**
+ * Install Lisa commands as native OpenCode custom commands in
+ * `.opencode/commands/`.
+ *
+ * Pipeline per command:
+ *   1. Discover `plugins/<plugin>/commands/**\/*.md` via the shared
+ *      `discoverLisaCommands` walker (identical discovery to the skills path).
+ *   2. Transform the command Markdown → OpenCode command Markdown (frontmatter
+ *      `description`; body preserves `$ARGUMENTS` for native substitution).
+ *   3. Write the result to `.opencode/commands/<lisa-name>.md`, where the
+ *      filename is the shared dash-joined `lisa-` prefixed name (e.g.
+ *      `lisa-git-commit`), so the command surfaces as `/lisa-git-commit`.
+ *
+ * This is ADDITIVE and native-fidelity: Lisa commands already work on OpenCode
+ * as `lisa-` prefixed skills, so the lower-priority value here is exposing them
+ * through OpenCode's first-class command surface with native argument handling.
+ *
+ * The `lisa-` filename prefix (already baked into the shared command skill name)
+ * is the ownership boundary — host-authored commands (any file NOT starting with
+ * `lisa-`) are never touched, and stale cleanup is scoped to `lisa-` files only.
+ * @module opencode/command-installer
+ */
+import * as fse from "fs-extra";
+import { readFile, unlink, writeFile } from "node:fs/promises";
+import * as path from "node:path";
+import { discoverLisaCommands, isHarnessVariantPlugin, } from "../core/lisa-skill-sources.js";
+import { transformCommandToOpencode } from "./command-transformer.js";
+import { OPENCODE_CONFIG_DIR } from "./manifest.js";
+export { discoverLisaCommands, } from "../core/lisa-skill-sources.js";
+/** Subdirectory inside `.opencode/` where Lisa-owned commands live */
+export const LISA_COMMANDS_SUBDIR = "commands";
+/**
+ * Filename prefix marking a command file as Lisa-owned. The shared command
+ * discovery already names every command `lisa-<...>`, so this matches the
+ * basename of every file Lisa writes and scopes stale cleanup safely.
+ */
+export const LISA_COMMAND_FILE_PREFIX = "lisa-";
+/**
+ * Install all discovered commands into `<destDir>/.opencode/commands/`.
+ * @param sources - Command sources from discoverLisaCommands
+ * @param destDir - Absolute path to the destination project root
+ * @param previousManagedFiles - Files Lisa managed on the previous run
+ *   (relative to `.opencode/`); used to detect stale commands to delete
+ * @returns Result describing installed/deleted/managedFiles
+ */
+export async function installCommands(sources, destDir, previousManagedFiles) {
+    const commandsDir = path.join(destDir, OPENCODE_CONFIG_DIR, LISA_COMMANDS_SUBDIR);
+    await fse.ensureDir(commandsDir);
+    const installed = await Promise.all(sources.map(source => installSingleCommand(source, commandsDir)));
+    const managedFiles = installed.map(command => command.relativePath);
+    const deleted = await deleteStaleCommands(previousManagedFiles, managedFiles, destDir);
+    return {
+        installed: Object.freeze(installed),
+        deleted: Object.freeze(deleted),
+        managedFiles: Object.freeze(managedFiles),
+    };
+}
+/**
+ * Transform + write a single command file.
+ * @param source - Discovered command source (skill name, display name, path)
+ * @param commandsDir - Absolute path to `.opencode/commands/` in the host
+ * @returns Result describing the installed file
+ */
+async function installSingleCommand(source, commandsDir) {
+    const sourceContent = await readFile(source.sourcePath, "utf8");
+    const markdown = transformCommandToOpencode(sourceContent, source.displayName);
+    const filename = `${source.skillName}.md`;
+    await writeFile(path.join(commandsDir, filename), markdown, "utf8");
+    return {
+        name: source.skillName,
+        relativePath: path.join(LISA_COMMANDS_SUBDIR, filename),
+    };
+}
+/**
+ * Delete files that were Lisa-managed last run but aren't shipped this run.
+ * Only deletes files inside `.opencode/commands/` whose basename carries the
+ * `lisa-` prefix, so host-authored commands are never removed.
+ * @param previousManagedFiles - Files Lisa managed on the previous run
+ *   (relative to `.opencode/`)
+ * @param currentManagedFiles - Files Lisa is shipping this run (relative
+ *   to `.opencode/`)
+ * @param destDir - Absolute path to the host project root
+ * @returns The list of relative paths that were deleted
+ */
+async function deleteStaleCommands(previousManagedFiles, currentManagedFiles, destDir) {
+    const currentSet = new Set(currentManagedFiles);
+    const lisaCommandPrefix = `${LISA_COMMANDS_SUBDIR}${path.sep}${LISA_COMMAND_FILE_PREFIX}`;
+    const stale = previousManagedFiles.filter(file => !currentSet.has(file) && file.startsWith(lisaCommandPrefix));
+    await Promise.all(stale.map(async (file) => {
+        const absPath = path.join(destDir, OPENCODE_CONFIG_DIR, file);
+        if (await fse.pathExists(absPath)) {
+            await unlink(absPath);
+        }
+    }));
+    return Object.freeze(stale);
+}
+/**
+ * Convenience one-shot: discover Lisa commands from `lisaDir` and install them.
+ *
+ * Discovery is restricted to canonical plugins — the per-harness fanout variants
+ * (`*-agy`, `*-copilot`, `*-cursor`) are skipped so a reformatted variant copy
+ * of a command body never wins the last-wins dedup over the canonical source.
+ * @param lisaDir - Absolute path to the Lisa repo / installed package
+ * @param destDir - Absolute path to the destination project root
+ * @param previousManagedFiles - Files Lisa managed on the previous run
+ * @returns Result describing installed/deleted/managedFiles
+ */
+export async function discoverAndInstallCommands(lisaDir, destDir, previousManagedFiles) {
+    const sources = await discoverLisaCommands(lisaDir, name => !isHarnessVariantPlugin(name));
+    return installCommands(sources, destDir, previousManagedFiles);
+}
+//# sourceMappingURL=command-installer.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"command-installer.js","sourceRoot":"","sources":["../../src/opencode/command-installer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC;AAChC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAEL,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAEpD,OAAO,EAEL,oBAAoB,GACrB,MAAM,+BAA+B,CAAC;AAEvC,sEAAsE;AACtE,MAAM,CAAC,MAAM,oBAAoB,GAAG,UAAU,CAAC;AAE/C;;;;GAIG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,OAAO,CAAC;AAmBhD;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,OAAqC,EACrC,OAAe,EACf,oBAAuC;IAEvC,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAC3B,OAAO,EACP,mBAAmB,EACnB,oBAAoB,CACrB,CAAC;IACF,MAAM,GAAG,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IAEjC,MAAM,SAAS,GAAgC,MAAM,OAAO,CAAC,GAAG,CAC9D,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,oBAAoB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CACjE,CAAC;IACF,MAAM,YAAY,GAAsB,SAAS,CAAC,GAAG,CACnD,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,YAAY,CAChC,CAAC;IAEF,MAAM,OAAO,GAAG,MAAM,mBAAmB,CACvC,oBAAoB,EACpB,YAAY,EACZ,OAAO,CACR,CAAC;IAEF,OAAO;QACL,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC;QACnC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC;QAC/B,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC;KAC1C,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,KAAK,UAAU,oBAAoB,CACjC,MAAyB,EACzB,WAAmB;IAEnB,MAAM,aAAa,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IAChE,MAAM,QAAQ,GAAG,0BAA0B,CACzC,aAAa,EACb,MAAM,CAAC,WAAW,CACnB,CAAC;IACF,MAAM,QAAQ,GAAG,GAAG,MAAM,CAAC,SAAS,KAAK,CAAC;IAC1C,MAAM,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IACpE,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,SAAS;QACtB,YAAY,EAAE,IAAI,CAAC,IAAI,CAAC,oBAAoB,EAAE,QAAQ,CAAC;KACxD,CAAC;AACJ,CAAC;AAED;;;;;;;;;;GAUG;AACH,KAAK,UAAU,mBAAmB,CAChC,oBAAuC,EACvC,mBAAsC,EACtC,OAAe;IAEf,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,mBAAmB,CAAC,CAAC;IAChD,MAAM,iBAAiB,GAAG,GAAG,oBAAoB,GAAG,IAAI,CAAC,GAAG,GAAG,wBAAwB,EAAE,CAAC;IAC1F,MAAM,KAAK,GAAG,oBAAoB,CAAC,MAAM,CACvC,IAAI,CAAC,EAAE,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,CACpE,CAAC;IACF,MAAM,OAAO,CAAC,GAAG,CACf,KAAK,CAAC,GAAG,CAAC,KAAK,EAAC,IAAI,EAAC,EAAE;QACrB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,mBAAmB,EAAE,IAAI,CAAC,CAAC;QAC9D,IAAI,MAAM,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YAClC,MAAM,MAAM,CAAC,OAAO,CAAC,CAAC;QACxB,CAAC;IACH,CAAC,CAAC,CACH,CAAC;IACF,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC9B,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,OAAe,EACf,OAAe,EACf,oBAAuC;IAEvC,MAAM,OAAO,GAAG,MAAM,oBAAoB,CACxC,OAAO,EACP,IAAI,CAAC,EAAE,CAAC,CAAC,sBAAsB,CAAC,IAAI,CAAC,CACtC,CAAC;IACF,OAAO,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,oBAAoB,CAAC,CAAC;AACjE,CAAC"}

package/dist/opencode/command-transformer.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Pure transform: convert a Lisa command Markdown into an OpenCode command
+ * Markdown.
+ * @param commandSource - Raw contents of the command .md file
+ * @param displayName - Human-readable name used as a fallback description
+ *   (e.g. "lisa:git:commit")
+ * @returns The OpenCode command Markdown content as a string
+ */
+export declare function transformCommandToOpencode(commandSource: string, displayName: string): string;
+//# sourceMappingURL=command-transformer.d.ts.map

package/dist/opencode/command-transformer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-transformer.d.ts","sourceRoot":"","sources":["../../src/opencode/command-transformer.ts"],"names":[],"mappings":"AAmCA;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CACxC,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,GAClB,MAAM,CAoBR"}

package/dist/opencode/command-transformer.js

@@ -0,0 +1,74 @@
+/**
+ * Convert a Lisa command Markdown file into an OpenCode custom command.
+ *
+ * Lisa commands already work today on OpenCode as `lisa-` prefixed skills (see
+ * `opencode/skills-installer.ts`). This transformer is the additive, native
+ * path: OpenCode has a first-class command format
+ * (https://opencode.ai/docs/commands) with its own frontmatter and native
+ * `$ARGUMENTS` / `$1` / `@file` substitution.
+ *
+ * Claude command shape:
+ * ```
+ * ---
+ * description: ...
+ * argument-hint: "<x>"          # optional
+ * ---
+ * Body with $ARGUMENTS
+ * ```
+ *
+ * OpenCode command shape:
+ * ```
+ * ---
+ * description: ...
+ * ---
+ * Body with $ARGUMENTS
+ * ```
+ *
+ * Unlike the command-to-SKILL conversion (which strips `$ARGUMENTS` because a
+ * skill has no argument channel), this PRESERVES `$ARGUMENTS` verbatim because
+ * OpenCode substitutes it natively (verified on opencode 1.16.2 — the resolved
+ * config keeps `$ARGUMENTS` in the command template). The body is otherwise
+ * passed through unchanged.
+ * @module opencode/command-transformer
+ */
+import yaml from "js-yaml";
+/**
+ * Pure transform: convert a Lisa command Markdown into an OpenCode command
+ * Markdown.
+ * @param commandSource - Raw contents of the command .md file
+ * @param displayName - Human-readable name used as a fallback description
+ *   (e.g. "lisa:git:commit")
+ * @returns The OpenCode command Markdown content as a string
+ */
+export function transformCommandToOpencode(commandSource, displayName) {
+    const match = /^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/.exec(commandSource);
+    if (match === null || match[1] === undefined || match[2] === undefined) {
+        throw new Error(`Command source is missing YAML frontmatter for ${displayName}`);
+    }
+    const description = parseDescription(yaml.load(match[1]), displayName);
+    const body = match[2].trimStart().trimEnd();
+    const frontmatter = [
+        "---",
+        `description: ${JSON.stringify(description)}`,
+        "---",
+        "",
+    ].join("\n");
+    return `${frontmatter}${body}\n`;
+}
+/**
+ * Extract the command description from parsed frontmatter, falling back to the
+ * display name when none is present.
+ * @param parsed - Output of `yaml.load(rawFrontmatter)` (untrusted shape)
+ * @param displayName - Fallback used when no description is available
+ * @returns The description string
+ */
+function parseDescription(parsed, displayName) {
+    if (parsed === null || typeof parsed !== "object") {
+        return displayName;
+    }
+    const obj = parsed;
+    return typeof obj.description === "string" && obj.description.length > 0
+        ? obj.description
+        : displayName;
+}
+//# sourceMappingURL=command-transformer.js.map

package/dist/opencode/command-transformer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-transformer.js","sourceRoot":"","sources":["../../src/opencode/command-transformer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,OAAO,IAAI,MAAM,SAAS,CAAC;AAE3B;;;;;;;GAOG;AACH,MAAM,UAAU,0BAA0B,CACxC,aAAqB,EACrB,WAAmB;IAEnB,MAAM,KAAK,GAAG,6CAA6C,CAAC,IAAI,CAC9D,aAAa,CACd,CAAC;IACF,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;QACvE,MAAM,IAAI,KAAK,CACb,kDAAkD,WAAW,EAAE,CAChE,CAAC;IACJ,CAAC;IACD,MAAM,WAAW,GAAG,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC;IACvE,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,OAAO,EAAE,CAAC;IAE5C,MAAM,WAAW,GAAG;QAClB,KAAK;QACL,gBAAgB,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,EAAE;QAC7C,KAAK;QACL,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,OAAO,GAAG,WAAW,GAAG,IAAI,IAAI,CAAC;AACnC,CAAC;AAED;;;;;;GAMG;AACH,SAAS,gBAAgB,CAAC,MAAe,EAAE,WAAmB;IAC5D,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAClD,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,MAAM,GAAG,GAAG,MAAiC,CAAC;IAC9C,OAAO,OAAO,GAAG,CAAC,WAAW,KAAK,QAAQ,IAAI,GAAG,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC;QACtE,CAAC,CAAC,GAAG,CAAC,WAAW;QACjB,CAAC,CAAC,WAAW,CAAC;AAClB,CAAC"}

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

@@ -0,0 +1,54 @@
+import type { ProjectType } from "../core/config.js";
+/** Subdirectory inside `.opencode/` where OpenCode discovers project plugins */
+export declare const OPENCODE_PLUGIN_SUBDIR = "plugin";
+/** Filename of the OpenCode project config merged at the host root */
+export declare const OPENCODE_CONFIG_FILENAME = "opencode.json";
+/** Result of the OpenCode hooks install pass */
+export interface OpencodeHooksInstallResult {
+    /** Files written, relative to `.opencode/` (added to the manifest). */
+    readonly managedFiles: readonly string[];
+    /** Number of plugin templates emitted into `.opencode/plugin/`. */
+    readonly pluginCount: number;
+    /** Whether `opencode.json` was created (vs merged into an existing file). */
+    readonly configCreated: boolean;
+    /** Stale Lisa plugin files removed because they're no longer shipped. */
+    readonly deleted: readonly string[];
+}
+/**
+ * Install Lisa's OpenCode hooks: merge `permission.bash` deny rules into
+ * `opencode.json` and emit the applicable `.opencode/plugin/lisa-*.ts` modules.
+ *
+ * `opencode.json` lives at the host ROOT (outside `.opencode/`), is a shared
+ * merged file, and is intentionally NOT returned in `managedFiles` — the
+ * `.opencode/`-relative manifest never deletes it. Plugin files under
+ * `.opencode/plugin/` ARE tracked so renames clean up stale modules.
+ * @param destDir - Absolute path to the host project root.
+ * @param detectedTypes - Project types Lisa detected; gates stack-specific
+ *   plugins. Universal plugins/config install regardless.
+ * @param previousManagedFiles - Files Lisa managed last run (relative to
+ *   `.opencode/`); used to detect stale plugin modules.
+ * @returns Result describing what was written + removed.
+ */
+export declare function installHooks(destDir: string, detectedTypes: readonly ProjectType[], previousManagedFiles: readonly string[]): Promise<OpencodeHooksInstallResult>;
+/**
+ * Merge the `block-no-verify` deny globs into an `opencode.json` (JSONC) body.
+ * Pure function for testability; `mergeOpencodeConfig` is the I/O wrapper.
+ *
+ * Empty input yields a clean Lisa-authored document. A host `permission.bash`
+ * set to a bare string (e.g. `"allow"`) is re-seeded as a `{ "*": <string> }`
+ * catch-all so the host's posture survives alongside the deny rules. Otherwise
+ * each deny glob is added as its own key, preserving host bash patterns. `$schema`
+ * is set only when absent. Throws on invalid JSONC so a corrupt host file is
+ * surfaced, not silently overwritten.
+ * @param existingJsonc - Current contents of `opencode.json` (or "").
+ * @returns Merged JSON/JSONC string with host content preserved.
+ */
+export declare function mergeNoVerifyDenyRules(existingJsonc: string): string;
+/**
+ * Enumerate the Lisa plugin filenames currently present in a host's
+ * `.opencode/plugin/` directory. Exposed for tests/diagnostics.
+ * @param destDir - Absolute path to the host project root.
+ * @returns Sorted list of `lisa-*.ts` filenames (empty if the dir is absent).
+ */
+export declare function listInstalledPluginFiles(destDir: string): Promise<readonly string[]>;
+//# sourceMappingURL=hooks-installer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hooks-installer.d.ts","sourceRoot":"","sources":["../../src/opencode/hooks-installer.ts"],"names":[],"mappings":"AAsCA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIrD,gFAAgF;AAChF,eAAO,MAAM,sBAAsB,WAAW,CAAC;AAE/C,sEAAsE;AACtE,eAAO,MAAM,wBAAwB,kBAAkB,CAAC;AAiExD,gDAAgD;AAChD,MAAM,WAAW,0BAA0B;IACzC,uEAAuE;IACvE,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,mEAAmE;IACnE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,6EAA6E;IAC7E,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,yEAAyE;IACzE,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,SAAS,WAAW,EAAE,EACrC,oBAAoB,EAAE,SAAS,MAAM,EAAE,GACtC,OAAO,CAAC,0BAA0B,CAAC,CAmCrC;AAgGD;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAoCpE;AA+ED;;;;;GAKG;AACH,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAa5B"}