@codyswann/lisa 2.119.1 → 2.121.1

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"}

package/dist/codex/lisa-plugin-detection.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Default Lisa marketplace plugin reference inside `~/.codex/config.toml`.
+ *
+ * [VERIFIED-BY-RUN 2026-05-28, Codex 0.125.0] `codex plugin marketplace add
+ * CodySwannGT/lisa` registers the marketplace under the `name` field of the
+ * repo's `.claude-plugin/marketplace.json` (which is `"lisa"`), producing a
+ * `[marketplaces.lisa]` table. Codex composes plugin keys as
+ * `<plugin-name>@<marketplace-name>`, so the enabled-plugin table is
+ * `[plugins."lisa@lisa"]` — NOT the repo-slug form. The older
+ * `CodySwannGT-lisa` / `CodySwannGT/lisa` shapes are retained as legacy
+ * fallbacks ({@link LEGACY_LISA_PLUGIN_KEYS}) in case an earlier Codex derived
+ * the marketplace name from the repo slug.
+ */
+export declare const DEFAULT_LISA_PLUGIN_KEY = "lisa@lisa";
+/** Legacy/alternative key shapes tried as fallbacks (pre-0.125.0 guesses). */
+export declare const LEGACY_LISA_PLUGIN_KEYS: readonly ["lisa@CodySwannGT-lisa", "lisa@CodySwannGT/lisa"];
+/** Legacy slash-separator key shape (one of {@link LEGACY_LISA_PLUGIN_KEYS}). */
+export declare const SLASH_LISA_PLUGIN_KEY = "lisa@CodySwannGT/lisa";
+/**
+ * Detect whether any known Lisa plugin key shape is enabled.
+ *
+ * Tries the verified 0.125.0 key (`lisa@lisa`) first, then the legacy shapes.
+ * Callers that need a definitive yes/no answer should use this helper rather
+ * than the single-key {@link isLisaInstalledAsCodexPlugin}.
+ *
+ * @returns True when the verified key or any legacy key is enabled.
+ */
+export declare function isLisaInstalledUnderAnyCanonicalKey(): Promise<boolean>;
+/**
+ * Resolve the path to `~/.codex/config.toml`.
+ *
+ * Does not consult `$CODEX_HOME` — this detection runs from `lisa apply`
+ * (a build-tooling context, not an end-user shell) where the caller's
+ * environment may not reflect the user's Codex install location. If
+ * downstream Lisa flows need `$CODEX_HOME`-aware resolution, they can
+ * pass an absolute path to {@link tomlHasEnabledPlugin} directly after
+ * reading the file themselves.
+ *
+ * @returns Absolute path to `~/.codex/config.toml` (whether it exists or not).
+ */
+export declare function codexConfigPath(): string;
+/**
+ * Test whether the given config.toml body declares the Lisa plugin as enabled.
+ *
+ * Looks for a heading of the form `[plugins."<pluginKey>"]` followed by an
+ * `enabled = true` line within the section. Implementation is intentionally
+ * simple-text rather than a full TOML parse to avoid pulling a TOML dependency
+ * into a hot detection path; a stricter parse can replace this if false
+ * positives appear in practice.
+ *
+ * @param tomlBody - Contents of config.toml.
+ * @param pluginKey - The plugin key string (e.g. "lisa@CodySwannGT-lisa").
+ * @returns True when an enabled-true entry for the plugin key is present.
+ */
+export declare function tomlHasEnabledPlugin(tomlBody: string, pluginKey?: string): boolean;
+/**
+ * Detect whether Lisa is currently installed and enabled as a Codex plugin.
+ *
+ * Read-only; safe to call from inside any installer's preflight gate. Returns
+ * false on any error (missing file, parse failure, IO error) so the caller
+ * defaults to running its per-project install path.
+ *
+ * @param pluginKey - The plugin key to look for. Defaults to the canonical
+ *   Lisa marketplace ref.
+ * @returns True when the plugin is enabled in `~/.codex/config.toml`.
+ */
+export declare function isLisaInstalledAsCodexPlugin(pluginKey?: string): Promise<boolean>;
+//# sourceMappingURL=lisa-plugin-detection.d.ts.map

package/dist/codex/lisa-plugin-detection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lisa-plugin-detection.d.ts","sourceRoot":"","sources":["../../src/codex/lisa-plugin-detection.ts"],"names":[],"mappings":"AAuBA;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,uBAAuB,cAAc,CAAC;AAEnD,8EAA8E;AAC9E,eAAO,MAAM,uBAAuB,6DAG1B,CAAC;AAEX,iFAAiF;AACjF,eAAO,MAAM,qBAAqB,0BAA0B,CAAC;AAE7D;;;;;;;;GAQG;AACH,wBAAsB,mCAAmC,IAAI,OAAO,CAAC,OAAO,CAAC,CAM5E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,SAAS,GAAE,MAAgC,GAC1C,OAAO,CAwBT;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,4BAA4B,CAChD,SAAS,GAAE,MAAgC,GAC1C,OAAO,CAAC,OAAO,CAAC,CASlB"}

package/dist/codex/lisa-plugin-detection.js

@@ -0,0 +1,139 @@
+/**
+ * Detect whether Lisa is installed as a Codex plugin (via marketplace).
+ *
+ * Per `wiki/decisions/2026-05-28-codex-skills-canonical-path.md` and Wave 2
+ * fan-out spec §src/codex/, when Lisa is installed via the Codex plugin
+ * marketplace the per-project skills and hooks installers should no-op (the
+ * plugin payload delivers the same components). When Lisa is NOT installed
+ * as a plugin, the per-project installers continue to run as the fallback
+ * delivery path.
+ *
+ * Detection: read `~/.codex/config.toml` (honoring `$CODEX_HOME` if set) and
+ * check for a `[plugins."lisa@lisa"]` table with `enabled = true`.
+ *
+ * This is a best-effort detection. If the config file is missing, malformed,
+ * or unreadable, the function returns `false` (fall through to per-project
+ * install).
+ * @module codex/lisa-plugin-detection
+ */
+import { readFile } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+/**
+ * Default Lisa marketplace plugin reference inside `~/.codex/config.toml`.
+ *
+ * [VERIFIED-BY-RUN 2026-05-28, Codex 0.125.0] `codex plugin marketplace add
+ * CodySwannGT/lisa` registers the marketplace under the `name` field of the
+ * repo's `.claude-plugin/marketplace.json` (which is `"lisa"`), producing a
+ * `[marketplaces.lisa]` table. Codex composes plugin keys as
+ * `<plugin-name>@<marketplace-name>`, so the enabled-plugin table is
+ * `[plugins."lisa@lisa"]` — NOT the repo-slug form. The older
+ * `CodySwannGT-lisa` / `CodySwannGT/lisa` shapes are retained as legacy
+ * fallbacks ({@link LEGACY_LISA_PLUGIN_KEYS}) in case an earlier Codex derived
+ * the marketplace name from the repo slug.
+ */
+export const DEFAULT_LISA_PLUGIN_KEY = "lisa@lisa";
+/** Legacy/alternative key shapes tried as fallbacks (pre-0.125.0 guesses). */
+export const LEGACY_LISA_PLUGIN_KEYS = [
+    "lisa@CodySwannGT-lisa",
+    "lisa@CodySwannGT/lisa",
+];
+/** Legacy slash-separator key shape (one of {@link LEGACY_LISA_PLUGIN_KEYS}). */
+export const SLASH_LISA_PLUGIN_KEY = "lisa@CodySwannGT/lisa";
+/**
+ * Detect whether any known Lisa plugin key shape is enabled.
+ *
+ * Tries the verified 0.125.0 key (`lisa@lisa`) first, then the legacy shapes.
+ * Callers that need a definitive yes/no answer should use this helper rather
+ * than the single-key {@link isLisaInstalledAsCodexPlugin}.
+ *
+ * @returns True when the verified key or any legacy key is enabled.
+ */
+export async function isLisaInstalledUnderAnyCanonicalKey() {
+    if (await isLisaInstalledAsCodexPlugin(DEFAULT_LISA_PLUGIN_KEY))
+        return true;
+    for (const key of LEGACY_LISA_PLUGIN_KEYS) {
+        if (await isLisaInstalledAsCodexPlugin(key))
+            return true;
+    }
+    return false;
+}
+/**
+ * Resolve the path to `~/.codex/config.toml`.
+ *
+ * Does not consult `$CODEX_HOME` — this detection runs from `lisa apply`
+ * (a build-tooling context, not an end-user shell) where the caller's
+ * environment may not reflect the user's Codex install location. If
+ * downstream Lisa flows need `$CODEX_HOME`-aware resolution, they can
+ * pass an absolute path to {@link tomlHasEnabledPlugin} directly after
+ * reading the file themselves.
+ *
+ * @returns Absolute path to `~/.codex/config.toml` (whether it exists or not).
+ */
+export function codexConfigPath() {
+    return path.join(os.homedir(), ".codex", "config.toml");
+}
+/**
+ * Test whether the given config.toml body declares the Lisa plugin as enabled.
+ *
+ * Looks for a heading of the form `[plugins."<pluginKey>"]` followed by an
+ * `enabled = true` line within the section. Implementation is intentionally
+ * simple-text rather than a full TOML parse to avoid pulling a TOML dependency
+ * into a hot detection path; a stricter parse can replace this if false
+ * positives appear in practice.
+ *
+ * @param tomlBody - Contents of config.toml.
+ * @param pluginKey - The plugin key string (e.g. "lisa@CodySwannGT-lisa").
+ * @returns True when an enabled-true entry for the plugin key is present.
+ */
+export function tomlHasEnabledPlugin(tomlBody, pluginKey = DEFAULT_LISA_PLUGIN_KEY) {
+    // Line-by-line scan instead of multiline regex — keeps the matcher trivially
+    // linear in input length and avoids sonarjs/slow-regex warnings.
+    const expectedHeader = `[plugins."${pluginKey}"]`;
+    const lines = tomlBody.split("\n");
+    const stripTrailingComment = (line) => {
+        const hashIdx = line.indexOf("#");
+        return (hashIdx === -1 ? line : line.slice(0, hashIdx)).trim();
+    };
+    const headerIndex = lines.findIndex(line => stripTrailingComment(line) === expectedHeader);
+    if (headerIndex === -1)
+        return false;
+    // Walk forward until the next section header (a line starting with "[") or EOF.
+    // Tolerate whitespace around `enabled = true`, tabs, and trailing comments
+    // (canonical Codex emitter uses `enabled = true` but TOML accepts variants).
+    const tail = lines.slice(headerIndex + 1);
+    const enabledTruePattern = /^enabled\s{0,4}=\s{0,4}true$/;
+    for (const raw of tail) {
+        const line = stripTrailingComment(raw);
+        if (line.startsWith("["))
+            return false; // next section reached without enabled
+        if (enabledTruePattern.test(line))
+            return true;
+    }
+    return false;
+}
+/**
+ * Detect whether Lisa is currently installed and enabled as a Codex plugin.
+ *
+ * Read-only; safe to call from inside any installer's preflight gate. Returns
+ * false on any error (missing file, parse failure, IO error) so the caller
+ * defaults to running its per-project install path.
+ *
+ * @param pluginKey - The plugin key to look for. Defaults to the canonical
+ *   Lisa marketplace ref.
+ * @returns True when the plugin is enabled in `~/.codex/config.toml`.
+ */
+export async function isLisaInstalledAsCodexPlugin(pluginKey = DEFAULT_LISA_PLUGIN_KEY) {
+    const configPath = codexConfigPath();
+    if (!existsSync(configPath))
+        return false;
+    try {
+        const body = await readFile(configPath, "utf8");
+        return tomlHasEnabledPlugin(body, pluginKey);
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=lisa-plugin-detection.js.map

package/dist/codex/lisa-plugin-detection.js.map

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

package/dist/copilot/copilot-instructions-installer.d.ts

@@ -0,0 +1,18 @@
+/** Relative path of Copilot's instruction file inside a host project. */
+export declare const COPILOT_INSTRUCTIONS_RELATIVE_PATH: string;
+/** Result of the Copilot instructions install pass. */
+export interface CopilotInstructionsInstallResult {
+    /** 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 `.github/copilot-instructions.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 installCopilotInstructions(destDir: string): Promise<CopilotInstructionsInstallResult>;
+//# sourceMappingURL=copilot-instructions-installer.d.ts.map

package/dist/copilot/copilot-instructions-installer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"copilot-instructions-installer.d.ts","sourceRoot":"","sources":["../../src/copilot/copilot-instructions-installer.ts"],"names":[],"mappings":"AAmBA,yEAAyE;AACzE,eAAO,MAAM,kCAAkC,QAG9C,CAAC;AAEF,uDAAuD;AACvD,MAAM,WAAW,gCAAgC;IAC/C,uEAAuE;IACvE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,+EAA+E;IAC/E,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3C;AA2BD;;;;;;GAMG;AACH,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,gCAAgC,CAAC,CAQ3C"}

package/dist/copilot/copilot-instructions-installer.js

@@ -0,0 +1,61 @@
+/**
+ * Write Lisa's `.github/copilot-instructions.md` template for Copilot host
+ * projects.
+ *
+ * Verified-by-run (2026-05-28): `copilot init` creates a `.github/` directory
+ * and is documented to write `.github/copilot-instructions.md` containing
+ * project-specific guidance Copilot auto-loads at session start.
+ *
+ * The installer mirrors `src/codex/agents-md-installer.ts`'s create-only
+ * semantics — Lisa never overwrites a host-authored
+ * `.github/copilot-instructions.md`. The Lisa template is short and points
+ * downstream at the canonical rule sources (Lisa plugin's `rules/eager/`
+ * directory, surfaced by the Copilot variant's bundled rules).
+ * @module copilot/copilot-instructions-installer
+ */
+import { mkdir, writeFile } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import * as path from "node:path";
+/** Relative path of Copilot's instruction file inside a host project. */
+export const COPILOT_INSTRUCTIONS_RELATIVE_PATH = path.join(".github", "copilot-instructions.md");
+const TEMPLATE = `# Copilot Instructions
+
+GitHub Copilot CLI auto-loads this file at session start as repository-specific
+guidance.
+
+Lisa governance is active in this project. Lisa's eager rules ship via the
+\`lisa-copilot\` plugin (see
+[CodySwannGT/lisa](https://github.com/CodySwannGT/lisa)) and Copilot loads them
+through the plugin's bundled \`rules/\` directory plus the \`SessionStart\` hook
+\`inject-rules.sh\` (the same polyfill Lisa uses on Claude and Codex when the
+agent does not auto-load rules from a plugin).
+
+This file is the place to add project-specific guidance that Lisa's universal
+rules do not cover. It is create-only from Lisa's perspective — re-running
+\`lisa apply\` will never overwrite host-authored guidance here.
+
+Reference paths Copilot reads natively at session start:
+
+- \`.github/copilot-instructions.md\` (this file)
+- \`AGENTS.md\` at project root, when present
+- \`CLAUDE.md\` at project root, when present (Copilot cross-reads)
+
+Add custom guidance below this line:
+`;
+/**
+ * Write a starter `.github/copilot-instructions.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 installCopilotInstructions(destDir) {
+    const filePath = path.join(destDir, COPILOT_INSTRUCTIONS_RELATIVE_PATH);
+    if (existsSync(filePath)) {
+        return { created: false, relativePath: undefined };
+    }
+    await mkdir(path.dirname(filePath), { recursive: true });
+    await writeFile(filePath, TEMPLATE, "utf8");
+    return { created: true, relativePath: COPILOT_INSTRUCTIONS_RELATIVE_PATH };
+}
+//# sourceMappingURL=copilot-instructions-installer.js.map

package/dist/copilot/copilot-instructions-installer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"copilot-instructions-installer.js","sourceRoot":"","sources":["../../src/copilot/copilot-instructions-installer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,yEAAyE;AACzE,MAAM,CAAC,MAAM,kCAAkC,GAAG,IAAI,CAAC,IAAI,CACzD,SAAS,EACT,yBAAyB,CAC1B,CAAC;AAUF,MAAM,QAAQ,GAAG;;;;;;;;;;;;;;;;;;;;;;;CAuBhB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,OAAe;IAEf,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,kCAAkC,CAAC,CAAC;IACxE,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,CAAC;IACrD,CAAC;IACD,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACzD,MAAM,SAAS,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC5C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,kCAAkC,EAAE,CAAC;AAC7E,CAAC"}

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

@@ -0,0 +1,29 @@
+/** Result of the Copilot plugin install pass. */
+export interface CopilotPluginInstallResult {
+    /** True when copilot was on PATH and an install was attempted. */
+    readonly attempted: boolean;
+    /** True when the install command exited 0. False on any error. */
+    readonly installed: boolean;
+    /** Which install path was used: "marketplace" or "local". */
+    readonly via: "marketplace" | "local" | undefined;
+    /** Resolved source argument passed to `copilot plugin install`. */
+    readonly source: string | undefined;
+    /** Error message captured on failure, or undefined on success/no-op. */
+    readonly error: string | undefined;
+}
+/**
+ * Install Lisa's Copilot plugin variant.
+ *
+ * Tries the marketplace path first (forward-compatible with the
+ * marketplace.json `pluginRoot` doubling fix from Wave 2 spec step 8). On
+ * marketplace failure (including the "plugin source directory not found"
+ * error caused by today's marketplace shape), falls back to local-path
+ * install against `plugins/lisa-copilot/` from the Lisa package.
+ *
+ * @param lisaPluginRoot - Absolute path to Lisa's `plugins/` directory.
+ * @param marketplaceRef - Marketplace install ref, defaulting to
+ *   "lisa@CodySwannGT/lisa".
+ * @returns Install result.
+ */
+export declare function installCopilotPlugin(lisaPluginRoot: string, marketplaceRef?: string): Promise<CopilotPluginInstallResult>;
+//# sourceMappingURL=plugin-installer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-installer.d.ts","sourceRoot":"","sources":["../../src/copilot/plugin-installer.ts"],"names":[],"mappings":"AAiCA,iDAAiD;AACjD,MAAM,WAAW,0BAA0B;IACzC,kEAAkE;IAClE,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,kEAAkE;IAClE,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,6DAA6D;IAC7D,QAAQ,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,GAAG,SAAS,CAAC;IAClD,mEAAmE;IACnE,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,wEAAwE;IACxE,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;CACpC;AA+ED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,oBAAoB,CACxC,cAAc,EAAE,MAAM,EACtB,cAAc,GAAE,MAAgC,GAC/C,OAAO,CAAC,0BAA0B,CAAC,CAyBrC"}

package/dist/copilot/plugin-installer.js

@@ -0,0 +1,144 @@
+/**
+ * Detect `copilot` (GitHub Copilot CLI) and install Lisa's Copilot plugin
+ * variant.
+ *
+ * Two distribution paths are supported (in priority order):
+ *
+ *   1. Marketplace install via `copilot plugin install lisa@CodySwannGT/lisa`.
+ *      This is the documented forward path. As of 2026-05-28 it fails because
+ *      Lisa's `.claude-plugin/marketplace.json` `pluginRoot: "./plugins"` and
+ *      each plugin's `source: "./plugins/lisa"` double-up to `plugins/plugins/lisa`
+ *      under Copilot's marketplace cache. The marketplace.json fix is gated on
+ *      empirical verification (Wave 2 spec step 8); when the fix lands this
+ *      installer's marketplace path becomes usable.
+ *
+ *   2. Local-path install via `copilot plugin install <plugins/lisa-copilot>`.
+ *      Currently emits a deprecation warning ("only plugin@marketplace installs
+ *      will be supported in a future release") but works. Lisa uses this as
+ *      the fallback while the marketplace fix is in-flight.
+ *
+ * Detection rule: `copilot` must be on `$PATH`. If absent, no-op.
+ *
+ * Idempotence rule: Copilot's plugin install handles its own state; re-running
+ * against the same source updates the installed-plugins entry without erroring.
+ * @module copilot/plugin-installer
+ */
+import { exec, execFile } from "node:child_process";
+import { promisify } from "node:util";
+import { existsSync } from "node:fs";
+import * as path from "node:path";
+const execAsync = promisify(exec);
+const execFileAsync = promisify(execFile);
+/**
+ * Detect whether `copilot` is on PATH.
+ *
+ * @returns True when copilot is callable.
+ */
+async function detectCopilot() {
+    try {
+        await execAsync("command -v copilot");
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Try the marketplace install path. Returns the install result.
+ *
+ * @param marketplaceRef - e.g. "lisa@CodySwannGT/lisa".
+ * @returns Result describing whether the install succeeded.
+ */
+async function tryMarketplaceInstall(marketplaceRef) {
+    try {
+        // execFile (no shell): the ref is passed as an argv entry, so it is never
+        // subject to shell quoting/expansion. This also makes Windows paths with
+        // backslashes safe in the local-install path below.
+        await execFileAsync("copilot", ["plugin", "install", marketplaceRef]);
+        return {
+            attempted: true,
+            installed: true,
+            via: "marketplace",
+            source: marketplaceRef,
+            error: undefined,
+        };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return {
+            attempted: true,
+            installed: false,
+            via: "marketplace",
+            source: marketplaceRef,
+            error: message,
+        };
+    }
+}
+/**
+ * Try the local-path install path against Lisa's Copilot variant.
+ *
+ * @param localPath - Absolute path to plugins/lisa-copilot/.
+ * @returns Result describing whether the install succeeded.
+ */
+async function tryLocalInstall(localPath) {
+    try {
+        await execFileAsync("copilot", ["plugin", "install", localPath]);
+        return {
+            attempted: true,
+            installed: true,
+            via: "local",
+            source: localPath,
+            error: undefined,
+        };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return {
+            attempted: true,
+            installed: false,
+            via: "local",
+            source: localPath,
+            error: message,
+        };
+    }
+}
+/**
+ * Install Lisa's Copilot plugin variant.
+ *
+ * Tries the marketplace path first (forward-compatible with the
+ * marketplace.json `pluginRoot` doubling fix from Wave 2 spec step 8). On
+ * marketplace failure (including the "plugin source directory not found"
+ * error caused by today's marketplace shape), falls back to local-path
+ * install against `plugins/lisa-copilot/` from the Lisa package.
+ *
+ * @param lisaPluginRoot - Absolute path to Lisa's `plugins/` directory.
+ * @param marketplaceRef - Marketplace install ref, defaulting to
+ *   "lisa@CodySwannGT/lisa".
+ * @returns Install result.
+ */
+export async function installCopilotPlugin(lisaPluginRoot, marketplaceRef = "lisa@CodySwannGT/lisa") {
+    if (!(await detectCopilot())) {
+        return {
+            attempted: false,
+            installed: false,
+            via: undefined,
+            source: undefined,
+            error: undefined,
+        };
+    }
+    const marketplaceResult = await tryMarketplaceInstall(marketplaceRef);
+    if (marketplaceResult.installed)
+        return marketplaceResult;
+    const localPath = path.join(lisaPluginRoot, "lisa-copilot");
+    if (!existsSync(path.join(localPath, ".claude-plugin", "plugin.json"))) {
+        return {
+            attempted: true,
+            installed: false,
+            via: "local",
+            source: localPath,
+            error: `Lisa Copilot variant not found at ${localPath}/.claude-plugin/plugin.json — run \`bun run build:plugins\` first`,
+        };
+    }
+    return tryLocalInstall(localPath);
+}
+//# sourceMappingURL=plugin-installer.js.map

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

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

package/dist/core/config.d.ts

@@ -21,15 +21,39 @@ export declare const COPY_STRATEGIES: readonly CopyStrategy[];
 /**
  * Target harness(es) for emitted artifacts.
  *
- * - "claude": emit Claude Code artifacts (.claude/, .claude-plugin/, etc.)
- * - "codex":  emit OpenAI Codex CLI artifacts (.codex/, .codex-plugin/, .agents/, AGENTS.md)
- * - "both":   emit both, so a project can use either harness
+ * - "claude":  emit Claude Code artifacts (.claude/, .claude-plugin/, CLAUDE.md)
+ * - "codex":   emit OpenAI Codex CLI artifacts (.codex/, .codex-plugin/, .agents/, AGENTS.md)
+ * - "cursor":  emit Cursor artifacts (Cursor reads .claude-plugin/ natively; no per-project files)
+ * - "agy":     emit Antigravity artifacts (~/.gemini/config/mcp_config.json + AGENTS.md with baked rules)
+ * - "copilot": emit GitHub Copilot artifacts (.github/copilot-instructions.md + plugin install)
+ * - "both":    emit both Claude and Codex (back-compat — predates the per-agent expansion)
+ * - "fleet":   emit for every supported agent (Claude + Codex + Cursor + agy + Copilot)
  */
-export type Harness = "claude" | "codex" | "both";
+export type Harness = "claude" | "codex" | "cursor" | "agy" | "copilot" | "both" | "fleet";
 /**
  * All valid harness values, in canonical order
  */
 export declare const HARNESS_VALUES: readonly Harness[];
+/**
+ * Per-project emit agents that have a dispatch path in `lisa apply`.
+ * (Cursor is intentionally absent — it needs no per-project writes; it consumes
+ * the `lisa-cursor` plugin variant directly via its marketplace/loader.)
+ */
+export type EmitAgent = "claude" | "codex" | "agy" | "copilot";
+/**
+ * Whether a configured harness should emit artifacts for a given agent.
+ *
+ * Centralizes the dispatch-inclusion rule so the four `process<Agent>Emit`
+ * guards stay consistent: a `"fleet"` harness includes every agent, `"both"`
+ * is the Claude+Codex back-compat pair, and any single-agent harness matches
+ * only itself. (A prior copy-paste left `"fleet"` out of the Codex guard, so
+ * fleet installs silently skipped Codex — this predicate prevents that class
+ * of bug.)
+ * @param harness - The configured/CLI-resolved harness value.
+ * @param agent - The emit agent whose dispatch is being gated.
+ * @returns True when the harness should run that agent's emit path.
+ */
+export declare function harnessIncludesAgent(harness: Harness, agent: EmitAgent): boolean;
 /**
  * Default harness when none is configured (backward compatibility — existing
  * host projects predate Codex support and have always emitted .claude/ artifacts)

package/dist/core/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,YAAY,GACpB,gBAAgB,GAChB,eAAe,GACf,aAAa,GACb,OAAO,GACP,cAAc,GACd,cAAc,CAAC;AAEnB;;GAEG;AACH,MAAM,MAAM,WAAW,GACnB,YAAY,GACZ,MAAM,GACN,QAAQ,GACR,KAAK,GACL,eAAe,GACf,aAAa,GACb,OAAO,CAAC;AAEZ;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,QAAQ,CAC3C,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,SAAS,CAAC,CAS/B,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,SAAS,WAAW,EAQ3C,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,SAAS,YAAY,EAOzC,CAAC;AAEX;;;;;;GAMG;AACH,MAAM,MAAM,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC;AAElD;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,SAAS,OAAO,EAInC,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,OAAkB,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,+DAA+D;IAC/D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB,4CAA4C;IAC5C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB,8DAA8D;IAC9D,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IAEzB,8DAA8D;IAC9D,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAE1B,4DAA4D;IAC5D,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAE/B,gFAAgF;IAChF,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAE/B,uEAAuE;IACvE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,UAAU,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,QAAQ,CAAC,MAAM,EACX,QAAQ,GACR,SAAS,GACT,aAAa,GACb,UAAU,GACV,QAAQ,GACR,SAAS,CAAC;IACd,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,6CAA6C;IAC7C,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,oEAAoE;IACpE,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IACrC,QAAQ,CAAC,aAAa,EAAE,SAAS,WAAW,EAAE,CAAC;IAC/C,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,iBAAiB,CAYzD"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,YAAY,GACpB,gBAAgB,GAChB,eAAe,GACf,aAAa,GACb,OAAO,GACP,cAAc,GACd,cAAc,CAAC;AAEnB;;GAEG;AACH,MAAM,MAAM,WAAW,GACnB,YAAY,GACZ,MAAM,GACN,QAAQ,GACR,KAAK,GACL,eAAe,GACf,aAAa,GACb,OAAO,CAAC;AAEZ;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,QAAQ,CAC3C,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,SAAS,CAAC,CAS/B,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,SAAS,WAAW,EAQ3C,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,SAAS,YAAY,EAOzC,CAAC;AAEX;;;;;;;;;;GAUG;AACH,MAAM,MAAM,OAAO,GACf,QAAQ,GACR,OAAO,GACP,QAAQ,GACR,KAAK,GACL,SAAS,GACT,MAAM,GACN,OAAO,CAAC;AAEZ;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,SAAS,OAAO,EAQnC,CAAC;AAEX;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,OAAO,GAAG,KAAK,GAAG,SAAS,CAAC;AAE/D;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,SAAS,GACf,OAAO,CAIT;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,OAAkB,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,+DAA+D;IAC/D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB,4CAA4C;IAC5C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB,8DAA8D;IAC9D,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IAEzB,8DAA8D;IAC9D,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAE1B,4DAA4D;IAC5D,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAE/B,gFAAgF;IAChF,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAE/B,uEAAuE;IACvE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,UAAU,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,QAAQ,CAAC,MAAM,EACX,QAAQ,GACR,SAAS,GACT,aAAa,GACb,UAAU,GACV,QAAQ,GACR,SAAS,CAAC;IACd,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,6CAA6C;IAC7C,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,oEAAoE;IACpE,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IACrC,QAAQ,CAAC,aAAa,EAAE,SAAS,WAAW,EAAE,CAAC;IAC/C,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,iBAAiB,CAYzD"}

package/dist/core/config.js

@@ -39,8 +39,32 @@ export const COPY_STRATEGIES = [
 export const HARNESS_VALUES = [
     "claude",
     "codex",
+    "cursor",
+    "agy",
+    "copilot",
     "both",
+    "fleet",
 ];
+/**
+ * Whether a configured harness should emit artifacts for a given agent.
+ *
+ * Centralizes the dispatch-inclusion rule so the four `process<Agent>Emit`
+ * guards stay consistent: a `"fleet"` harness includes every agent, `"both"`
+ * is the Claude+Codex back-compat pair, and any single-agent harness matches
+ * only itself. (A prior copy-paste left `"fleet"` out of the Codex guard, so
+ * fleet installs silently skipped Codex — this predicate prevents that class
+ * of bug.)
+ * @param harness - The configured/CLI-resolved harness value.
+ * @param agent - The emit agent whose dispatch is being gated.
+ * @returns True when the harness should run that agent's emit path.
+ */
+export function harnessIncludesAgent(harness, agent) {
+    if (harness === "fleet")
+        return true;
+    if (harness === "both")
+        return agent === "claude" || agent === "codex";
+    return harness === agent;
+}
 /**
  * Default harness when none is configured (backward compatibility — existing
  * host projects predate Codex support and have always emitted .claude/ artifacts)