@codyswann/lisa 2.119.1 → 2.121.0

package/.claude-plugin/marketplace.json

@@ -61,6 +61,24 @@
       "source": "./plugins/lisa-openclaw",
       "description": "Connect staff to Telegram or Slack via OpenClaw — facilitator/specialist routing and repo-coding topics (Claude + Codex)",
       "category": "productivity"
+    },
+    {
+      "name": "lisa-cursor",
+      "source": "./plugins/lisa-cursor",
+      "description": "Cursor (cursor-agent) variant — skills and agents consumed via Cursor's native .claude-plugin loader",
+      "category": "productivity"
+    },
+    {
+      "name": "lisa-agy",
+      "source": "./plugins/lisa-agy",
+      "description": "Antigravity (agy) variant — bare-manifest plugin with skills and agents; rules baked into AGENTS.md since agy plugin hooks don't fire",
+      "category": "productivity"
+    },
+    {
+      "name": "lisa-copilot",
+      "source": "./plugins/lisa-copilot",
+      "description": "GitHub Copilot variant — agents emitted as <name>.agent.md with camelCase hook events",
+      "category": "productivity"
     }
   ]
 }

package/dist/agy/agents-md-installer.d.ts

@@ -0,0 +1,24 @@
+/** Filename of agy's project memory file (auto-loaded since v1.20.3). */
+export declare const AGENTS_MD_FILENAME = "AGENTS.md";
+/** Marker placed at the start of the Lisa-managed block in AGENTS.md. */
+export declare const LISA_RULES_START_MARKER = "<!-- LISA_RULES_START -->";
+/** Marker placed at the end of the Lisa-managed block in AGENTS.md. */
+export declare const LISA_RULES_END_MARKER = "<!-- LISA_RULES_END -->";
+/** Result of the agy AGENTS.md install pass. */
+export interface AgyAgentsMdInstallResult {
+    /** Absolute path to the AGENTS.md file. */
+    readonly path: string;
+    /** True when this run created the file for the first time. */
+    readonly created: boolean;
+    /** Number of `.md` rule files baked into the marker block. */
+    readonly rulesBaked: number;
+}
+/**
+ * Install (or refresh) Lisa's AGENTS.md at the host project root for agy.
+ * @param destDir - Absolute path to the host project root.
+ * @param rulesEagerDir - Absolute path to the plugin's `rules/eager/` directory
+ *   containing the rule bodies to bake in.
+ * @returns Install result describing path, creation, and rules baked.
+ */
+export declare function installAgyAgentsMd(destDir: string, rulesEagerDir: string): Promise<AgyAgentsMdInstallResult>;
+//# sourceMappingURL=agents-md-installer.d.ts.map

package/dist/agy/agents-md-installer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents-md-installer.d.ts","sourceRoot":"","sources":["../../src/agy/agents-md-installer.ts"],"names":[],"mappings":"AA6BA,yEAAyE;AACzE,eAAO,MAAM,kBAAkB,cAAc,CAAC;AAE9C,yEAAyE;AACzE,eAAO,MAAM,uBAAuB,8BAA8B,CAAC;AACnE,uEAAuE;AACvE,eAAO,MAAM,qBAAqB,4BAA4B,CAAC;AAE/D,gDAAgD;AAChD,MAAM,WAAW,wBAAwB;IACvC,2CAA2C;IAC3C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,8DAA8D;IAC9D,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,8DAA8D;IAC9D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AA+ED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,wBAAwB,CAAC,CAiBnC"}

package/dist/agy/agents-md-installer.js

@@ -0,0 +1,126 @@
+/**
+ * Write Lisa's AGENTS.md template for agy host projects, with rule content
+ * baked directly into the file body.
+ *
+ * Per the parity research artifact (Cluster 4-agy / Option α), Lisa cannot
+ * polyfill rules-injection on agy via a SessionStart hook because agy plugin
+ * hooks do not fire in `-p` headless mode. The alternative is to bake the
+ * eager rule content into the AGENTS.md template that agy auto-loads at
+ * session start (verified-by-doc since v1.20.3).
+ *
+ * Behavior diverges from `src/codex/agents-md-installer.ts`:
+ *   - Codex installer is create-only and references hooks for rule injection.
+ *   - agy installer is also create-only but appends the rule bodies directly
+ *     to the template, with a Lisa-managed section marker so re-runs can
+ *     refresh the rule content without overwriting host-authored sections.
+ *
+ * The marker block convention mirrors the tagged-merge pattern used in
+ * `src/codex/hooks-merger.ts`. On re-runs, the installer:
+ *   1. Reads the existing AGENTS.md.
+ *   2. Strips the `<!-- LISA_RULES_START -->...<!-- LISA_RULES_END -->` block
+ *      if present.
+ *   3. Re-emits Lisa's current eager rules between fresh markers.
+ *   4. Preserves all content outside the marker block (host-authored guidance).
+ * @module agy/agents-md-installer
+ */
+import { mkdir, readFile, readdir, writeFile } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import * as path from "node:path";
+/** Filename of agy's project memory file (auto-loaded since v1.20.3). */
+export const AGENTS_MD_FILENAME = "AGENTS.md";
+/** Marker placed at the start of the Lisa-managed block in AGENTS.md. */
+export const LISA_RULES_START_MARKER = "<!-- LISA_RULES_START -->";
+/** Marker placed at the end of the Lisa-managed block in AGENTS.md. */
+export const LISA_RULES_END_MARKER = "<!-- LISA_RULES_END -->";
+const HEADER = `# AGENTS.md
+
+This file is auto-loaded by Antigravity (\`agy\`) at the start of every
+session. Lisa polyfills rule injection by baking its eager rule content
+directly into this file (agy plugin hooks do not fire in \`-p\` headless
+mode, so the SessionStart-hook strategy Lisa uses on Claude and Codex is
+not available on agy).
+
+Anything between the markers below is Lisa-managed and is rewritten on
+every \`lisa apply\` run. Add project-specific guidance OUTSIDE the marker
+block — it will be preserved across re-applies.
+`;
+/**
+ * Read all eager rule files (the bodies Lisa wants in session context)
+ * sorted by filename for stable output.
+ * @param rulesEagerDir - Absolute path to the plugin's `rules/eager/` directory.
+ * @returns Array of `{ filename, body }` pairs.
+ */
+async function readEagerRules(rulesEagerDir) {
+    if (!existsSync(rulesEagerDir))
+        return [];
+    const entries = await readdir(rulesEagerDir, { withFileTypes: true });
+    const mdEntries = [
+        ...entries.filter(entry => entry.isFile() && entry.name.endsWith(".md")),
+    ].sort((a, b) => a.name.localeCompare(b.name));
+    return await Promise.all(mdEntries.map(async (entry) => {
+        const filePath = path.join(rulesEagerDir, entry.name);
+        const body = await readFile(filePath, "utf8");
+        return { filename: entry.name, body };
+    }));
+}
+/**
+ * Build the Lisa-managed marker block from the eager rule bodies.
+ * @param rules - Eager rule contents read from `rules/eager/*.md`.
+ * @returns Markdown text including the start/end markers.
+ */
+function buildLisaBlock(rules) {
+    const sections = rules.map(rule => {
+        // Drop any existing leading H1 from rule bodies — they are already
+        // contextual subsections inside AGENTS.md, not standalone documents.
+        // Strip an optional leading H1 line — bounded to one line and one trailing
+        // newline pair to satisfy sonarjs/slow-regex (no unbounded `+` quantifiers).
+        const trimmed = rule.body.replace(/^# [^\n]{0,256}\n\n?/, "").trim();
+        const heading = `## ${rule.filename.replace(/\.md$/, "")}\n\n`;
+        return `${heading + trimmed}\n`;
+    });
+    return `${LISA_RULES_START_MARKER}\n\n${sections.join("\n")}\n${LISA_RULES_END_MARKER}\n`;
+}
+/**
+ * Strip an existing Lisa-managed block from the AGENTS.md body and return the
+ * surrounding host-authored content.
+ *
+ * Tolerates either ordering and whitespace variance around the markers.
+ * @param body - Existing AGENTS.md file contents.
+ * @returns The body with the Lisa block (if present) removed.
+ */
+function stripExistingLisaBlock(body) {
+    const startIdx = body.indexOf(LISA_RULES_START_MARKER);
+    const endIdx = body.indexOf(LISA_RULES_END_MARKER);
+    if (startIdx === -1 || endIdx === -1 || endIdx < startIdx) {
+        return body;
+    }
+    const before = body.slice(0, startIdx);
+    const after = body.slice(endIdx + LISA_RULES_END_MARKER.length);
+    // Use a bounded quantifier instead of `{3,}` (unbounded) to satisfy
+    // sonarjs/slow-regex — three or more consecutive newlines collapse to two.
+    return `${(before + after).replace(/\n\n\n+/g, "\n\n").trim()}\n`;
+}
+/**
+ * Install (or refresh) Lisa's AGENTS.md at the host project root for agy.
+ * @param destDir - Absolute path to the host project root.
+ * @param rulesEagerDir - Absolute path to the plugin's `rules/eager/` directory
+ *   containing the rule bodies to bake in.
+ * @returns Install result describing path, creation, and rules baked.
+ */
+export async function installAgyAgentsMd(destDir, rulesEagerDir) {
+    await mkdir(destDir, { recursive: true });
+    const filePath = path.join(destDir, AGENTS_MD_FILENAME);
+    const rules = await readEagerRules(rulesEagerDir);
+    const lisaBlock = buildLisaBlock(rules);
+    if (!existsSync(filePath)) {
+        const body = `${HEADER}\n${lisaBlock}`;
+        await writeFile(filePath, body, "utf8");
+        return { path: filePath, created: true, rulesBaked: rules.length };
+    }
+    const existing = await readFile(filePath, "utf8");
+    const hostContent = stripExistingLisaBlock(existing);
+    const updated = `${hostContent.trimEnd()}\n\n${lisaBlock}`;
+    await writeFile(filePath, updated, "utf8");
+    return { path: filePath, created: false, rulesBaked: rules.length };
+}
+//# sourceMappingURL=agents-md-installer.js.map

package/dist/agy/agents-md-installer.js.map

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

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

@@ -0,0 +1,84 @@
+/** Marker field tagged onto every Lisa-owned MCP server entry. */
+export declare const LISA_MANAGED_MARKER: "_lisaManaged";
+/**
+ * Where agy reads user-scope MCP config (shared with Antigravity desktop).
+ * @returns Absolute path to `~/.gemini/config/mcp_config.json`.
+ */
+export declare function defaultUserMcpConfigPath(): string;
+/**
+ * Where agy reads project-scope MCP config (per-workspace override).
+ * @param destDir - Absolute path to the host project root.
+ * @returns Absolute path to `<destDir>/.agents/mcp_config.json`.
+ */
+export declare function defaultProjectMcpConfigPath(destDir: string): string;
+/** A single MCP server entry in agy's mcp_config.json schema. */
+export interface AgyMcpServerEntry {
+    /** stdio: command to launch. Mutually exclusive with serverUrl. */
+    readonly command?: string;
+    readonly args?: readonly string[];
+    readonly env?: Readonly<Record<string, string>>;
+    /** HTTP transport: agy-specific key (NOT `url`). */
+    readonly serverUrl?: string;
+    readonly headers?: Readonly<Record<string, string>>;
+    /** Lisa ownership marker; only present on Lisa-managed entries. */
+    readonly [LISA_MANAGED_MARKER]?: boolean;
+}
+/** Top-level mcp_config.json shape. */
+export interface AgyMcpConfig {
+    readonly mcpServers?: Readonly<Record<string, AgyMcpServerEntry>>;
+}
+/** Input MCP server entry in Claude/Codex shape, before agy translation. */
+export interface ClaudeMcpServerEntry {
+    /** stdio command. */
+    readonly command?: string;
+    readonly args?: readonly string[];
+    readonly env?: Readonly<Record<string, string>>;
+    /** Claude/Codex HTTP shape: `{type:"http", url:"..."}`. */
+    readonly type?: "stdio" | "http" | "sse";
+    readonly url?: string;
+    readonly headers?: Readonly<Record<string, string>>;
+}
+/**
+ * Translate a Claude/Codex-shape MCP entry to agy's shape.
+ *
+ * Rules:
+ *   - stdio entries: pass through `command`/`args`/`env` unchanged.
+ *   - http entries: rename `url` → `serverUrl`, drop the `type` field, keep
+ *     `headers` if present.
+ *   - sse entries: agy SSE support is unverified at the schema level; pass
+ *     through `serverUrl` and headers for parity with HTTP. Caller should
+ *     verify before relying on SSE on agy.
+ *
+ * The Lisa-managed marker is attached at write time, not in this pure transform.
+ * @param input Claude/Codex-format MCP server entry.
+ * @returns agy-format MCP server entry.
+ */
+export declare function translateMcpEntryToAgy(input: ClaudeMcpServerEntry): AgyMcpServerEntry;
+/** Result of the agy MCP install pass. */
+export interface AgyMcpInstallResult {
+    /** Absolute path written. */
+    readonly path: string;
+    /** Number of Lisa-managed entries written. */
+    readonly lisaEntryCount: number;
+    /** Number of host-authored entries preserved. */
+    readonly hostEntryCount: number;
+}
+/**
+ * Install Lisa's MCP servers into agy's mcp_config.json using tagged-merge.
+ *
+ * Tagged-merge rules:
+ *   1. Read existing mcpServers (if any).
+ *   2. Strip every entry where `_lisaManaged === true`.
+ *   3. Add Lisa's entries with `_lisaManaged: true` attached.
+ *   4. Host entries (no marker) are preserved verbatim.
+ *
+ * The target path defaults to `~/.gemini/config/mcp_config.json`. Pass
+ * `targetPath` to override (e.g. for the project-level `.agents/mcp_config.json`).
+ * @param lisaMcpServers - Lisa's MCP servers in Claude/Codex shape, keyed by
+ *   server name.
+ * @param targetPath - Absolute path to the mcp_config.json file. Defaults to
+ *   the user-level path.
+ * @returns Result with the path written and entry counts.
+ */
+export declare function installAgyMcpConfig(lisaMcpServers: Readonly<Record<string, ClaudeMcpServerEntry>>, targetPath?: string): Promise<AgyMcpInstallResult>;
+//# sourceMappingURL=mcp-installer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-installer.d.ts","sourceRoot":"","sources":["../../src/agy/mcp-installer.ts"],"names":[],"mappings":"AAyBA,kEAAkE;AAClE,eAAO,MAAM,mBAAmB,EAAG,cAAuB,CAAC;AAE3D;;;GAGG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,CAEjD;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED,iEAAiE;AACjE,MAAM,WAAW,iBAAiB;IAChC,mEAAmE;IACnE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAChD,oDAAoD;IACpD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACpD,mEAAmE;IACnE,QAAQ,CAAC,CAAC,mBAAmB,CAAC,CAAC,EAAE,OAAO,CAAC;CAC1C;AAED,uCAAuC;AACvC,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC;CACnE;AAED,4EAA4E;AAC5E,MAAM,WAAW,oBAAoB;IACnC,qBAAqB;IACrB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAChD,2DAA2D;IAC3D,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,KAAK,CAAC;IACzC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACrD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,oBAAoB,GAC1B,iBAAiB,CAgBnB;AAED,0CAA0C;AAC1C,MAAM,WAAW,mBAAmB;IAClC,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;AAkBD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,mBAAmB,CACvC,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC,EAC9D,UAAU,GAAE,MAAmC,GAC9C,OAAO,CAAC,mBAAmB,CAAC,CAsC9B"}

package/dist/agy/mcp-installer.js

@@ -0,0 +1,134 @@
+/**
+ * Install Lisa's MCP server config into agy's user-level mcp_config.json.
+ *
+ * agy reads MCP server configs from `~/.gemini/config/mcp_config.json` (user
+ * scope, shared with Antigravity 2.0 desktop) or `<project>/.agents/mcp_config.json`
+ * (project scope). MCP is NOT a plugin component on agy — the file lives
+ * outside any plugin and is consumed independently per
+ * `wiki/architecture/coding-agent-parity.md` and
+ * `reference_agy_plugin_capabilities` memory.
+ *
+ * Schema differences from Claude/Codex:
+ *   - agy uses `serverUrl` for HTTP transport (NOT `url` or `httpUrl`).
+ *   - stdio servers use the same `command`/`args`/`env` shape as Claude/Codex.
+ *
+ * Tagged-merge convention: Lisa-owned entries carry `_lisaManaged: true` at
+ * the per-server level so the installer can rewrite Lisa's entries while
+ * preserving host-authored entries on re-runs (mirrors the
+ * `src/codex/hooks-merger.ts` pattern).
+ * @module agy/mcp-installer
+ */
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+/** Marker field tagged onto every Lisa-owned MCP server entry. */
+export const LISA_MANAGED_MARKER = "_lisaManaged";
+/**
+ * Where agy reads user-scope MCP config (shared with Antigravity desktop).
+ * @returns Absolute path to `~/.gemini/config/mcp_config.json`.
+ */
+export function defaultUserMcpConfigPath() {
+    return path.join(os.homedir(), ".gemini", "config", "mcp_config.json");
+}
+/**
+ * Where agy reads project-scope MCP config (per-workspace override).
+ * @param destDir - Absolute path to the host project root.
+ * @returns Absolute path to `<destDir>/.agents/mcp_config.json`.
+ */
+export function defaultProjectMcpConfigPath(destDir) {
+    return path.join(destDir, ".agents", "mcp_config.json");
+}
+/**
+ * Translate a Claude/Codex-shape MCP entry to agy's shape.
+ *
+ * Rules:
+ *   - stdio entries: pass through `command`/`args`/`env` unchanged.
+ *   - http entries: rename `url` → `serverUrl`, drop the `type` field, keep
+ *     `headers` if present.
+ *   - sse entries: agy SSE support is unverified at the schema level; pass
+ *     through `serverUrl` and headers for parity with HTTP. Caller should
+ *     verify before relying on SSE on agy.
+ *
+ * The Lisa-managed marker is attached at write time, not in this pure transform.
+ * @param input Claude/Codex-format MCP server entry.
+ * @returns agy-format MCP server entry.
+ */
+export function translateMcpEntryToAgy(input) {
+    if (input.command !== undefined) {
+        return {
+            command: input.command,
+            ...(input.args !== undefined ? { args: input.args } : {}),
+            ...(input.env !== undefined ? { env: input.env } : {}),
+        };
+    }
+    if (input.url !== undefined) {
+        return {
+            serverUrl: input.url,
+            ...(input.headers !== undefined ? { headers: input.headers } : {}),
+        };
+    }
+    // Empty / unknown shape — return as-is minus the type field.
+    return {};
+}
+/**
+ * Read the existing mcp_config.json file (or empty when absent).
+ * @param filePath - Absolute path to the config file.
+ * @returns Parsed object or {} when the file is missing.
+ */
+async function readExistingConfig(filePath) {
+    if (!existsSync(filePath))
+        return {};
+    try {
+        const raw = await readFile(filePath, "utf8");
+        if (raw.trim() === "")
+            return {};
+        return JSON.parse(raw);
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * Install Lisa's MCP servers into agy's mcp_config.json using tagged-merge.
+ *
+ * Tagged-merge rules:
+ *   1. Read existing mcpServers (if any).
+ *   2. Strip every entry where `_lisaManaged === true`.
+ *   3. Add Lisa's entries with `_lisaManaged: true` attached.
+ *   4. Host entries (no marker) are preserved verbatim.
+ *
+ * The target path defaults to `~/.gemini/config/mcp_config.json`. Pass
+ * `targetPath` to override (e.g. for the project-level `.agents/mcp_config.json`).
+ * @param lisaMcpServers - Lisa's MCP servers in Claude/Codex shape, keyed by
+ *   server name.
+ * @param targetPath - Absolute path to the mcp_config.json file. Defaults to
+ *   the user-level path.
+ * @returns Result with the path written and entry counts.
+ */
+export async function installAgyMcpConfig(lisaMcpServers, targetPath = defaultUserMcpConfigPath()) {
+    await mkdir(path.dirname(targetPath), { recursive: true });
+    const existing = await readExistingConfig(targetPath);
+    const existingServers = existing.mcpServers ?? {};
+    // Strip Lisa-managed entries from the existing config (immutable filter).
+    const hostEntries = Object.fromEntries(Object.entries(existingServers).filter(([, entry]) => entry?.[LISA_MANAGED_MARKER] !== true));
+    // Translate Lisa's entries and tag them (immutable map).
+    const lisaEntries = Object.fromEntries(Object.entries(lisaMcpServers).map(([name, claudeEntry]) => [
+        name,
+        {
+            ...translateMcpEntryToAgy(claudeEntry),
+            [LISA_MANAGED_MARKER]: true,
+        },
+    ]));
+    const merged = {
+        ...existing,
+        mcpServers: { ...hostEntries, ...lisaEntries },
+    };
+    await writeFile(targetPath, `${JSON.stringify(merged, null, 2)}\n`, "utf8");
+    return {
+        path: targetPath,
+        lisaEntryCount: Object.keys(lisaEntries).length,
+        hostEntryCount: Object.keys(hostEntries).length,
+    };
+}
+//# sourceMappingURL=mcp-installer.js.map

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

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

package/dist/agy/plugin-installer.d.ts

@@ -0,0 +1,21 @@
+/** Result of the agy plugin install pass. */
+export interface AgyPluginInstallResult {
+    /** True when agy was on PATH and the install command was attempted. */
+    readonly attempted: boolean;
+    /** True when the install command exited 0. False on any error. */
+    readonly installed: boolean;
+    /** Resolved absolute path to the source plugin tree that was installed. */
+    readonly source: string | undefined;
+    /** Error message when installation failed, or undefined on success/no-op. */
+    readonly error: string | undefined;
+}
+/**
+ * Install Lisa's agy plugin variant via `agy plugin install <local-path>`.
+ * @param lisaPluginRoot - Absolute path to Lisa's plugins directory (typically
+ *   the `plugins/` directory inside the @codyswann/lisa package). The agy
+ *   variant lives at `<lisaPluginRoot>/lisa-agy/`.
+ * @returns Install result describing whether the install was attempted, whether
+ *   it succeeded, and any error message captured.
+ */
+export declare function installAgyPlugin(lisaPluginRoot: string): Promise<AgyPluginInstallResult>;
+//# sourceMappingURL=plugin-installer.d.ts.map

package/dist/agy/plugin-installer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-installer.d.ts","sourceRoot":"","sources":["../../src/agy/plugin-installer.ts"],"names":[],"mappings":"AAsBA,6CAA6C;AAC7C,MAAM,WAAW,sBAAsB;IACrC,uEAAuE;IACvE,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,kEAAkE;IAClE,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,2EAA2E;IAC3E,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,6EAA6E;IAC7E,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;CACpC;AAkBD;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CACpC,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,sBAAsB,CAAC,CAuCjC"}

package/dist/agy/plugin-installer.js

@@ -0,0 +1,84 @@
+/**
+ * Detect `agy` (Antigravity CLI) and install Lisa's agy plugin variant.
+ *
+ * agy reads bare `plugin.json` plugins via `agy plugin install <local-path>`.
+ * Lisa's Pattern B build pipeline produces the agy-shaped variant at
+ * `plugins/lisa-agy/` (see `scripts/generate-agy-plugin-artifacts.mjs`).
+ *
+ * Detection rule: `agy` must be on `$PATH`. If absent, this installer is a
+ * no-op — the user does not have Antigravity installed and Lisa cannot help.
+ *
+ * Idempotence rule: re-running `agy plugin install` against the same source
+ * is treated as success (agy itself idempotently overwrites the import entry
+ * per its `installed_plugins.json` format).
+ * @module agy/plugin-installer
+ */
+import { exec } from "node:child_process";
+import { promisify } from "node:util";
+import { existsSync } from "node:fs";
+import * as path from "node:path";
+const execAsync = promisify(exec);
+/**
+ * Detect whether `agy` is on PATH.
+ *
+ * Uses `command -v agy` for portability across the shells Lisa supports
+ * (bash + zsh). Returns true on success exit, false on non-zero or any error.
+ * @returns True when agy is callable.
+ */
+async function detectAgy() {
+    try {
+        await execAsync("command -v agy");
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Install Lisa's agy plugin variant via `agy plugin install <local-path>`.
+ * @param lisaPluginRoot - Absolute path to Lisa's plugins directory (typically
+ *   the `plugins/` directory inside the @codyswann/lisa package). The agy
+ *   variant lives at `<lisaPluginRoot>/lisa-agy/`.
+ * @returns Install result describing whether the install was attempted, whether
+ *   it succeeded, and any error message captured.
+ */
+export async function installAgyPlugin(lisaPluginRoot) {
+    if (!(await detectAgy())) {
+        return {
+            attempted: false,
+            installed: false,
+            source: undefined,
+            error: undefined,
+        };
+    }
+    const agyVariant = path.join(lisaPluginRoot, "lisa-agy");
+    if (!existsSync(path.join(agyVariant, "plugin.json"))) {
+        return {
+            attempted: true,
+            installed: false,
+            source: agyVariant,
+            error: `agy plugin variant not found at ${agyVariant}/plugin.json — run \`bun run build:plugins\` first`,
+        };
+    }
+    try {
+        // agy plugin install handles its own idempotence — re-installing the same
+        // source updates the entry in installed_plugins.json without erroring.
+        await execAsync(`agy plugin install ${JSON.stringify(agyVariant)}`);
+        return {
+            attempted: true,
+            installed: true,
+            source: agyVariant,
+            error: undefined,
+        };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return {
+            attempted: true,
+            installed: false,
+            source: agyVariant,
+            error: message,
+        };
+    }
+}
+//# sourceMappingURL=plugin-installer.js.map

package/dist/agy/plugin-installer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-installer.js","sourceRoot":"","sources":["../../src/agy/plugin-installer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;AAclC;;;;;;GAMG;AACH,KAAK,UAAU,SAAS;IACtB,IAAI,CAAC;QACH,MAAM,SAAS,CAAC,gBAAgB,CAAC,CAAC;QAClC,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,cAAsB;IAEtB,IAAI,CAAC,CAAC,MAAM,SAAS,EAAE,CAAC,EAAE,CAAC;QACzB,OAAO;YACL,SAAS,EAAE,KAAK;YAChB,SAAS,EAAE,KAAK;YAChB,MAAM,EAAE,SAAS;YACjB,KAAK,EAAE,SAAS;SACjB,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,UAAU,CAAC,CAAC;IACzD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC,EAAE,CAAC;QACtD,OAAO;YACL,SAAS,EAAE,IAAI;YACf,SAAS,EAAE,KAAK;YAChB,MAAM,EAAE,UAAU;YAClB,KAAK,EAAE,mCAAmC,UAAU,oDAAoD;SACzG,CAAC;IACJ,CAAC;IAED,IAAI,CAAC;QACH,0EAA0E;QAC1E,uEAAuE;QACvE,MAAM,SAAS,CAAC,sBAAsB,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;QACpE,OAAO;YACL,SAAS,EAAE,IAAI;YACf,SAAS,EAAE,IAAI;YACf,MAAM,EAAE,UAAU;YAClB,KAAK,EAAE,SAAS;SACjB,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,OAAO;YACL,SAAS,EAAE,IAAI;YACf,SAAS,EAAE,KAAK;YAChB,MAAM,EAAE,UAAU;YAClB,KAAK,EAAE,OAAO;SACf,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/claude/claude-md-installer.d.ts

@@ -0,0 +1,18 @@
+/** Filename of the Claude project doc at the host project root. */
+export declare const CLAUDE_MD_FILENAME = "CLAUDE.md";
+/** Result of the CLAUDE.md install pass. */
+export interface ClaudeMdInstallResult {
+    /** True when Lisa created the file (false when it already existed). */
+    readonly created: boolean;
+    /** Path written, relative to the host project root, or undefined on no-op. */
+    readonly relativePath: string | undefined;
+}
+/**
+ * Write a starter CLAUDE.md at the host project root, but only if the file
+ * doesn't already exist.
+ *
+ * @param destDir - Absolute path to the host project root.
+ * @returns Result describing whether a file was created.
+ */
+export declare function installClaudeMd(destDir: string): Promise<ClaudeMdInstallResult>;
+//# sourceMappingURL=claude-md-installer.d.ts.map

package/dist/claude/claude-md-installer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-md-installer.d.ts","sourceRoot":"","sources":["../../src/claude/claude-md-installer.ts"],"names":[],"mappings":"AAkBA,mEAAmE;AACnE,eAAO,MAAM,kBAAkB,cAAc,CAAC;AAE9C,4CAA4C;AAC5C,MAAM,WAAW,qBAAqB;IACpC,uEAAuE;IACvE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,8EAA8E;IAC9E,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3C;AA8BD;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,qBAAqB,CAAC,CAOhC"}

package/dist/claude/claude-md-installer.js

@@ -0,0 +1,62 @@
+/**
+ * Write Lisa's CLAUDE.md template for Claude Code host projects.
+ *
+ * Claude Code auto-loads `CLAUDE.md` from the project tree at session start
+ * as repository-specific guidance. Lisa ships a starter template that:
+ *
+ *   - Advertises that Lisa governance is active in the project.
+ *   - Points downstream readers at the Lisa plugin (CodySwannGT/lisa).
+ *   - Reserves space for project-specific guidance the host can edit.
+ *
+ * Create-only semantics: Lisa never overwrites a host-authored CLAUDE.md.
+ * The Claude counterpart to `src/codex/agents-md-installer.ts`.
+ * @module claude/claude-md-installer
+ */
+import { writeFile } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import * as path from "node:path";
+/** Filename of the Claude project doc at the host project root. */
+export const CLAUDE_MD_FILENAME = "CLAUDE.md";
+const TEMPLATE = `# Claude Instructions
+
+This file is auto-loaded by Claude Code at session start as repository-specific
+guidance. Anthropic's Claude Code reads CLAUDE.md from the project root, the
+parent tree, and the user-level home directory; project-level takes precedence.
+
+## Lisa Governance
+
+This project uses [Lisa](https://github.com/CodySwannGT/lisa) for AI-assisted
+software development governance. The Lisa Claude Code plugin ships skills,
+agents, slash commands, hooks, rules, and MCP servers via the GitHub plugin
+marketplace.
+
+Lisa's eager rules are auto-injected into every Claude Code session via the
+plugin's \`SessionStart\` and \`SubagentStart\` hooks (see
+\`plugins/lisa/hooks/inject-rules.sh\` in the Lisa repository). The rules cover
+coding philosophy, intent routing, leaf-only lifecycle, PRD lifecycle rollup,
+repo-scope splits, security audit handling, documentation-source paths, and
+empirical-inquiry discipline.
+
+## Add Project-Specific Guidance Below
+
+The lines above are managed by Lisa; the rest of this file is owned by the host
+project. Add convention notes, terminology, architectural shorthand, or any
+project-specific guidance Claude Code should consume at session start.
+
+`;
+/**
+ * Write a starter CLAUDE.md at the host project root, but only if the file
+ * doesn't already exist.
+ *
+ * @param destDir - Absolute path to the host project root.
+ * @returns Result describing whether a file was created.
+ */
+export async function installClaudeMd(destDir) {
+    const filePath = path.join(destDir, CLAUDE_MD_FILENAME);
+    if (existsSync(filePath)) {
+        return { created: false, relativePath: undefined };
+    }
+    await writeFile(filePath, TEMPLATE, "utf8");
+    return { created: true, relativePath: CLAUDE_MD_FILENAME };
+}
+//# sourceMappingURL=claude-md-installer.js.map

package/dist/claude/claude-md-installer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-md-installer.js","sourceRoot":"","sources":["../../src/claude/claude-md-installer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,mEAAmE;AACnE,MAAM,CAAC,MAAM,kBAAkB,GAAG,WAAW,CAAC;AAU9C,MAAM,QAAQ,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;CA0BhB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,OAAe;IAEf,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAC;IACxD,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,CAAC;IACrD,CAAC;IACD,MAAM,SAAS,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC5C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,kBAAkB,EAAE,CAAC;AAC7D,CAAC"}