@codyswann/lisa 1.94.0 → 1.96.0

package/dist/codex/skills-installer.js

@@ -0,0 +1,344 @@
+/**
+ * Install Lisa-bundled skills into a host project's `.codex/skills/lisa/`.
+ *
+ * Skills are the open Agent Skills format (SKILL.md + optional siblings).
+ * Codex discovers them from the project config folder (`<destDir>/.codex/`)
+ * via the loader at `codex-rs/core-skills/src/loader.rs`.
+ *
+ * What this installs:
+ *   1. Lisa-bundled skill folders from `plugins/<p>/skills/<n>/` are copied
+ *      verbatim to `.codex/skills/lisa/<n>/`.
+ *   2. Lisa commands (e.g., `plugins/lisa/commands/fix.md`) are converted
+ *      to skills since Codex has no first-class slash-command extension
+ *      point. A command at `commands/jira/create.md` becomes a skill named
+ *      `lisa-jira-create` invocable via `$lisa-jira-create`.
+ *
+ * The lisa-namespace prefix ensures Lisa's commands-as-skills don't collide
+ * with same-named skills (e.g., Lisa's `fix.md` command + Lisa's existing
+ * `fix` skill if one ever existed).
+ * @module codex/skills-installer
+ */
+import * as fse from "fs-extra";
+import yaml from "js-yaml";
+import { copyFile, mkdir, readFile, readdir, rm, stat, writeFile, } from "node:fs/promises";
+import * as path from "node:path";
+/** Subdirectory inside `.codex/skills/` where Lisa-owned skills live */
+export const LISA_SKILLS_SUBDIR = path.join("skills", "lisa");
+/** Prefix applied to Lisa command-as-skill names */
+export const LISA_COMMAND_SKILL_PREFIX = "lisa-";
+/** Filename of the skill manifest at the root of every skill folder */
+const SKILL_MD_FILENAME = "SKILL.md";
+/**
+ * Install all Lisa-bundled skills + command-derived skills.
+ *
+ * Stale skills (in the previous manifest but no longer in Lisa's catalog)
+ * are deleted from `.codex/skills/lisa/` so renames in the source tree
+ * don't leave orphan directories behind.
+ * @param lisaDir - Absolute path to the Lisa repo root
+ * @param destDir - Absolute path to the host project root
+ * @param previousManagedFiles - Files Lisa managed on the previous run
+ *   (relative to `.codex/`); used to detect stale skill directories
+ * @returns Result describing installed skills + managed files + deletions
+ */
+export async function installSkills(lisaDir, destDir, previousManagedFiles) {
+    const skillsDir = path.join(destDir, ".codex", LISA_SKILLS_SUBDIR);
+    await fse.ensureDir(skillsDir);
+    // Step 1: bundled skills
+    const bundled = await discoverBundledSkills(lisaDir);
+    const bundledInstalls = await Promise.all(bundled.map(source => copyBundledSkill(source, skillsDir)));
+    const bundledFiles = bundled.flatMap(source => source.files.map(file => path.join(LISA_SKILLS_SUBDIR, source.skillName, file)));
+    // Step 2: command-as-skill conversions
+    const commandSkills = await discoverLisaCommands(lisaDir);
+    const commandInstalls = await Promise.all(commandSkills.map(cmd => emitCommandAsSkill(cmd, skillsDir)));
+    const commandFiles = commandInstalls.map(install => path.join(LISA_SKILLS_SUBDIR, install.name, SKILL_MD_FILENAME));
+    const installed = [
+        ...bundledInstalls,
+        ...commandInstalls,
+    ];
+    // Step 3: delete stale skill directories
+    const deleted = await deleteStaleSkills(previousManagedFiles, new Set(installed.map(s => s.name)), destDir);
+    return {
+        installed: Object.freeze(installed),
+        managedFiles: Object.freeze([...bundledFiles, ...commandFiles]),
+        deleted: Object.freeze(deleted),
+    };
+}
+/**
+ * Delete skill directories that were Lisa-managed last run but aren't
+ * shipped this run. Identifies skill names from the previous manifest by
+ * looking for paths inside `.codex/skills/lisa/<name>/...`.
+ *
+ * Whole directories are removed (not individual files) so siblings the host
+ * accidentally added inside a Lisa skill folder also disappear — Lisa owns
+ * the directory boundary, not just specific files.
+ * @param previousManagedFiles - Files Lisa managed on the previous run
+ *   (relative to `.codex/`)
+ * @param currentSkillNames - Skill names Lisa is shipping this run
+ * @param destDir - Absolute path to the host project root
+ * @returns Sorted list of stale skill names that were deleted
+ */
+async function deleteStaleSkills(previousManagedFiles, currentSkillNames, destDir) {
+    const lisaSkillsPrefix = `${LISA_SKILLS_SUBDIR}${path.sep}`;
+    const previousSkillNames = extractPreviousSkillNames(previousManagedFiles, lisaSkillsPrefix);
+    const stale = previousSkillNames.filter(name => !currentSkillNames.has(name));
+    await Promise.all(stale.map(async (name) => {
+        const absPath = path.join(destDir, ".codex", LISA_SKILLS_SUBDIR, name);
+        if (await fse.pathExists(absPath)) {
+            await rm(absPath, { recursive: true, force: true });
+        }
+    }));
+    return Object.freeze([...stale].sort((a, b) => a.localeCompare(b)));
+}
+/**
+ * Pick the unique skill-folder names out of the previous manifest's file
+ * list — every path inside `.codex/skills/lisa/<name>/...` contributes
+ * `<name>` to the result.
+ * @param previousManagedFiles - Files Lisa managed on the previous run
+ * @param lisaSkillsPrefix - The path prefix that identifies Lisa skill files
+ * @returns Unique skill names extracted from those paths
+ */
+function extractPreviousSkillNames(previousManagedFiles, lisaSkillsPrefix) {
+    const names = previousManagedFiles
+        .filter(file => file.startsWith(lisaSkillsPrefix))
+        .map(file => file.slice(lisaSkillsPrefix.length).split(path.sep)[0])
+        .filter((name) => Boolean(name));
+    return Array.from(new Set(names));
+}
+/**
+ * Walk `plugins/<plugin>/skills/<name>/` discovering each skill folder.
+ * De-duplicates by skill name with last-wins semantics: the base `lisa`
+ * plugin is always processed first, then remaining plugins in alphabetical
+ * order, so any stack-specific or third-party plugin overrides the base
+ * regardless of how the name sorts.
+ * @param lisaDir - Absolute path to the Lisa repo / installed package
+ * @returns De-duplicated bundled-skill sources, sorted by skill name
+ */
+async function discoverBundledSkills(lisaDir) {
+    const pluginsDir = path.join(lisaDir, "plugins");
+    if (!(await fse.pathExists(pluginsDir))) {
+        return [];
+    }
+    // Put the base "lisa" plugin first so it is always overridable by any
+    // other plugin via last-wins Map dedup below.  Remaining plugins are
+    // sorted for deterministic ordering across machines.
+    const all = (await readdir(pluginsDir)).filter(name => name !== "src");
+    const plugins = [
+        ...all.filter(n => n === "lisa"),
+        ...all.filter(n => n !== "lisa").sort((a, b) => a.localeCompare(b)),
+    ];
+    const candidatesByPlugin = await Promise.all(plugins.map(pluginName => discoverSkillsInPlugin(pluginsDir, pluginName)));
+    // Base-first iteration order + last-wins Map → stack-specific (and any
+    // other non-base plugin) overrides base for duplicate skill names.
+    const flat = candidatesByPlugin.flat();
+    const deduped = Array.from(new Map(flat.map(source => [source.skillName, source])).values());
+    return Object.freeze([...deduped].sort((a, b) => a.skillName.localeCompare(b.skillName)));
+}
+/**
+ * Discover every skill directory under one plugin's `skills/` folder. Skips
+ * any non-directory entries (defensive against stray .DS_Store and similar).
+ * @param pluginsDir - Absolute path to `<lisaDir>/plugins`
+ * @param pluginName - Plugin directory name (e.g. "lisa", "lisa-rails")
+ * @returns Bundled-skill sources discovered in this plugin (file order)
+ */
+async function discoverSkillsInPlugin(pluginsDir, pluginName) {
+    const skillsDir = path.join(pluginsDir, pluginName, "skills");
+    if (!(await fse.pathExists(skillsDir))) {
+        return [];
+    }
+    const skillNames = await readdir(skillsDir);
+    const candidates = await Promise.all(skillNames.map(async (skillName) => {
+        const sourceDir = path.join(skillsDir, skillName);
+        const dirStat = await stat(sourceDir);
+        if (!dirStat.isDirectory()) {
+            return undefined;
+        }
+        const files = await listFilesRecursive(sourceDir);
+        return { skillName, sourceDir, files };
+    }));
+    return candidates.filter((entry) => entry !== undefined);
+}
+/**
+ * Recursively list all file paths under `root` as relative paths. Pure
+ * recursion (no mutable accumulator) so the result is referentially clean.
+ * @param root - Absolute path to the directory to walk
+ * @returns Relative paths of every regular file under `root`
+ */
+async function listFilesRecursive(root) {
+    return walkDir(root, "");
+}
+/**
+ * Recursive helper for listFilesRecursive. The relative path is threaded
+ * down so nested files come back as `subdir/file.ext` etc.
+ * @param root - Absolute path to the directory to walk
+ * @param rel - Path under `root` we're currently visiting (relative)
+ * @returns Relative paths of every regular file at or below `root/rel`
+ */
+async function walkDir(root, rel) {
+    const abs = path.join(root, rel);
+    const entries = await readdir(abs, { withFileTypes: true });
+    const childResults = await Promise.all(entries.map(entry => {
+        const childRel = path.join(rel, entry.name);
+        if (entry.isDirectory()) {
+            return walkDir(root, childRel);
+        }
+        if (entry.isFile()) {
+            return Promise.resolve([childRel]);
+        }
+        return Promise.resolve([]);
+    }));
+    return childResults.flat();
+}
+/**
+ * Copy one bundled skill folder verbatim into the host's `.codex/skills/lisa/`.
+ * @param source - Bundled-skill source to copy
+ * @param skillsDir - Absolute path to `<destDir>/.codex/skills/lisa/`
+ * @returns Result describing the installed skill
+ */
+async function copyBundledSkill(source, skillsDir) {
+    const destSkillDir = path.join(skillsDir, source.skillName);
+    await fse.ensureDir(destSkillDir);
+    await Promise.all(source.files.map(async (file) => {
+        const srcPath = path.join(source.sourceDir, file);
+        const destPath = path.join(destSkillDir, file);
+        await mkdir(path.dirname(destPath), { recursive: true });
+        await copyFile(srcPath, destPath);
+    }));
+    return {
+        name: source.skillName,
+        source: "bundled",
+        relativePath: path.join(LISA_SKILLS_SUBDIR, source.skillName),
+    };
+}
+/**
+ * Walk `plugins/<plugin>/commands/**\/*.md` discovering each command file.
+ * Nested directories produce dash-joined skill names: `commands/git/commit.md`
+ * → `lisa-git-commit`.
+ *
+ * De-duplicates by final skill name with last-wins semantics: the base `lisa`
+ * plugin is always processed first, then remaining plugins in alphabetical
+ * order, so any stack-specific or third-party plugin overrides the base
+ * regardless of how the name sorts.
+ * @param lisaDir - Absolute path to the Lisa repo / installed package
+ * @returns De-duplicated command-derived skill sources, sorted by skill name
+ */
+async function discoverLisaCommands(lisaDir) {
+    const pluginsDir = path.join(lisaDir, "plugins");
+    if (!(await fse.pathExists(pluginsDir))) {
+        return [];
+    }
+    // Put the base "lisa" plugin first so it is always overridable by any
+    // other plugin via last-wins Map dedup below.  Remaining plugins are
+    // sorted for deterministic ordering across machines.
+    const all = (await readdir(pluginsDir)).filter(name => name !== "src");
+    const plugins = [
+        ...all.filter(n => n === "lisa"),
+        ...all.filter(n => n !== "lisa").sort((a, b) => a.localeCompare(b)),
+    ];
+    const candidatesByPlugin = await Promise.all(plugins.map(pluginName => discoverCommandsInPlugin(pluginsDir, pluginName)));
+    // Base-first iteration order + last-wins Map → stack-specific (and any
+    // other non-base plugin) overrides base for duplicate command names.
+    const flat = candidatesByPlugin.flat();
+    const deduped = Array.from(new Map(flat.map(source => [source.skillName, source])).values());
+    return Object.freeze([...deduped].sort((a, b) => a.skillName.localeCompare(b.skillName)));
+}
+/**
+ * Discover every Markdown command file under one plugin's `commands/`
+ * folder, turning each into a LisaCommandSource. Returns [] if the plugin
+ * has no commands directory.
+ * @param pluginsDir - Absolute path to `<lisaDir>/plugins`
+ * @param pluginName - Plugin directory name
+ * @returns Command sources discovered in this plugin (file order)
+ */
+async function discoverCommandsInPlugin(pluginsDir, pluginName) {
+    const commandsRoot = path.join(pluginsDir, pluginName, "commands");
+    if (!(await fse.pathExists(commandsRoot))) {
+        return [];
+    }
+    const files = await listFilesRecursive(commandsRoot);
+    return files
+        .filter(relFile => relFile.endsWith(".md"))
+        .map(relFile => {
+        // commands/git/commit.md → ["git", "commit"]
+        const segments = relFile.replace(/\.md$/, "").split(path.sep);
+        const skillName = `${LISA_COMMAND_SKILL_PREFIX}${segments.join("-")}`;
+        return {
+            skillName,
+            sourcePath: path.join(commandsRoot, relFile),
+            displayName: `lisa:${segments.join(":")}`,
+        };
+    });
+}
+/**
+ * Convert a Lisa command Markdown file into a Codex skill.
+ *
+ * The command's frontmatter (description) becomes the skill description.
+ * The command body becomes the skill body, with `$ARGUMENTS` removed since
+ * skills don't have CLI argument substitution — the user's natural-language
+ * input flows in via the surrounding conversation.
+ * @param cmd - Discovered command source
+ * @param skillsDir - Absolute path to `<destDir>/.codex/skills/lisa/`
+ * @returns Result describing the installed (command-derived) skill
+ */
+async function emitCommandAsSkill(cmd, skillsDir) {
+    const sourceContent = await readFile(cmd.sourcePath, "utf8");
+    const skillContent = convertCommandToSkill(sourceContent, cmd.skillName, cmd.displayName);
+    const destSkillDir = path.join(skillsDir, cmd.skillName);
+    await fse.ensureDir(destSkillDir);
+    await writeFile(path.join(destSkillDir, SKILL_MD_FILENAME), skillContent, "utf8");
+    return {
+        name: cmd.skillName,
+        source: "command",
+        relativePath: path.join(LISA_SKILLS_SUBDIR, cmd.skillName),
+    };
+}
+/**
+ * Pure transform: convert a Lisa command markdown to a Codex skill markdown.
+ *
+ * Preserves the description from the command's frontmatter; strips the
+ * `argument-hint` field (no analog in skills); strips `$ARGUMENTS`
+ * substitution markers from the body.
+ * @param commandSource - Raw contents of the command .md file
+ * @param skillName - Target skill name (already includes the `lisa-` prefix)
+ * @param displayName - Human-readable name used as a fallback description
+ * @returns The Codex skill SKILL.md content as a string
+ */
+export function convertCommandToSkill(commandSource, skillName, 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 rawFrontmatter = match[1];
+    const rawBody = match[2];
+    // Parse the frontmatter properly so we get YAML-correct value extraction
+    // (handles quoting, escapes, multiline forms — all of which a hand-rolled
+    // regex would get wrong on adversarial input).
+    const parsedFrontmatter = yaml.load(rawFrontmatter);
+    const description = extractDescription(parsedFrontmatter, displayName);
+    const body = rawBody
+        .trimStart()
+        .replace(/\$ARGUMENTS\s*/g, "")
+        .trimEnd();
+    const frontmatter = [
+        "---",
+        `name: ${skillName}`,
+        `description: ${JSON.stringify(description)}`,
+        "---",
+        "",
+    ].join("\n");
+    return `${frontmatter}${body}\n`;
+}
+/**
+ * Pull the `description` field out of a parsed YAML frontmatter mapping,
+ * falling back to `displayName` if it's missing or not a string.
+ * @param parsed - Output of `yaml.load(rawFrontmatter)` (untrusted shape)
+ * @param displayName - Fallback used when no description is available
+ * @returns The description string to embed in the skill frontmatter
+ */
+function extractDescription(parsed, displayName) {
+    if (parsed === null || typeof parsed !== "object") {
+        return displayName;
+    }
+    const value = parsed.description;
+    return typeof value === "string" && value.length > 0 ? value : displayName;
+}
+//# sourceMappingURL=skills-installer.js.map

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

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

package/dist/core/config.d.ts

@@ -18,6 +18,23 @@ export declare const PROJECT_TYPE_ORDER: readonly ProjectType[];
  * All available copy strategies in processing order
  */
 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
+ */
+export type Harness = "claude" | "codex" | "both";
+/**
+ * All valid harness values, in canonical order
+ */
+export declare const HARNESS_VALUES: readonly Harness[];
+/**
+ * Default harness when none is configured (backward compatibility — existing
+ * host projects predate Codex support and have always emitted .claude/ artifacts)
+ */
+export declare const DEFAULT_HARNESS: Harness;
 /**
  * Runtime configuration for Lisa operations
  */
@@ -34,6 +51,8 @@ export interface LisaConfig {
     readonly validateOnly: boolean;
     /** If true, skip the dirty git working directory check (for postinstall use) */
     readonly skipGitCheck: boolean;
+    /** Target harness(es) for emitted artifacts (claude | codex | both) */
+    readonly harness: Harness;
 }
 /**
  * Operation mode for Lisa execution

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,aAAa,GACb,OAAO,CAAC;AAEZ;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,QAAQ,CAC3C,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,SAAS,CAAC,CAQ/B,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,SAAS,WAAW,EAO3C,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,SAAS,YAAY,EAOzC,CAAC;AAEX;;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;CAChC;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,aAAa,GACb,OAAO,CAAC;AAEZ;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,QAAQ,CAC3C,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,SAAS,CAAC,CAQ/B,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,SAAS,WAAW,EAO3C,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"}

package/dist/core/config.js

@@ -31,6 +31,19 @@ export const COPY_STRATEGIES = [
     "tagged-merge",
     "package-lisa",
 ];
+/**
+ * All valid harness values, in canonical order
+ */
+export const HARNESS_VALUES = [
+    "claude",
+    "codex",
+    "both",
+];
+/**
+ * Default harness when none is configured (backward compatibility — existing
+ * host projects predate Codex support and have always emitted .claude/ artifacts)
+ */
+export const DEFAULT_HARNESS = "claude";
 /**
  * Create initial operation counters with all values at zero
  * @returns Operation counters initialized to zero

package/dist/core/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"AAsBA;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAE/B;IACF,IAAI,EAAE,YAAY;IAClB,MAAM,EAAE,YAAY;IACpB,GAAG,EAAE,YAAY;IACjB,aAAa,EAAE,YAAY;IAC3B,UAAU,EAAE,SAAS;IACrB,KAAK,EAAE,SAAS;CACR,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAA2B;IACxD,YAAY;IACZ,aAAa;IACb,MAAM;IACN,QAAQ;IACR,KAAK;IACL,OAAO;CACC,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAA4B;IACtD,gBAAgB;IAChB,eAAe;IACf,aAAa;IACb,OAAO;IACP,cAAc;IACd,cAAc;CACN,CAAC;AAkFX;;;GAGG;AACH,MAAM,UAAU,qBAAqB;IACnC,OAAO;QACL,MAAM,EAAE,CAAC;QACT,OAAO,EAAE,CAAC;QACV,WAAW,EAAE,CAAC;QACd,QAAQ,EAAE,CAAC;QACX,MAAM,EAAE,CAAC;QACT,OAAO,EAAE,CAAC;QACV,OAAO,EAAE,CAAC;QACV,iBAAiB,EAAE,CAAC;QACpB,iBAAiB,EAAE,CAAC;KACrB,CAAC;AACJ,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"AAsBA;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAE/B;IACF,IAAI,EAAE,YAAY;IAClB,MAAM,EAAE,YAAY;IACpB,GAAG,EAAE,YAAY;IACjB,aAAa,EAAE,YAAY;IAC3B,UAAU,EAAE,SAAS;IACrB,KAAK,EAAE,SAAS;CACR,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAA2B;IACxD,YAAY;IACZ,aAAa;IACb,MAAM;IACN,QAAQ;IACR,KAAK;IACL,OAAO;CACC,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAA4B;IACtD,gBAAgB;IAChB,eAAe;IACf,aAAa;IACb,OAAO;IACP,cAAc;IACd,cAAc;CACN,CAAC;AAWX;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAuB;IAChD,QAAQ;IACR,OAAO;IACP,MAAM;CACE,CAAC;AAEX;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAY,QAAQ,CAAC;AAqFjD;;;GAGG;AACH,MAAM,UAAU,qBAAqB;IACnC,OAAO;QACL,MAAM,EAAE,CAAC;QACT,OAAO,EAAE,CAAC;QACV,WAAW,EAAE,CAAC;QACd,QAAQ,EAAE,CAAC;QACX,MAAM,EAAE,CAAC;QACT,OAAO,EAAE,CAAC;QACV,OAAO,EAAE,CAAC;QACV,iBAAiB,EAAE,CAAC;QACpB,iBAAiB,EAAE,CAAC;KACrB,CAAC;AACJ,CAAC"}

package/dist/core/lisa.d.ts

@@ -140,6 +140,18 @@ export declare class Lisa {
      * @returns Result of the apply operation
      */
     apply(): Promise<LisaResult>;
+    /**
+     * Emit Codex-targeted artifacts (agents, hooks, settings) when the host
+     * project's harness is `codex` or `both`. No-op for `claude` (default).
+     *
+     * Codex artifacts cannot be shipped via plugins (the Codex plugin manifest
+     * has no fields for hooks or agent roles, confirmed in
+     * `codex-rs/core-plugins/src/manifest.rs`). Lisa instead writes them
+     * directly into the host project's `.codex/` tree as part of `apply()`,
+     * tracking ownership via `.codex/.lisa-managed.json` so updates can clean
+     * up stale entries without touching host customizations.
+     */
+    private processCodexEmit;
     /**
      * Schedule a reconciliation re-run when Lisa is invoked as a package-manager
      * lifecycle script. Works around the fact that `bun add` (and similar

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

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

package/dist/core/lisa.js

@@ -3,6 +3,12 @@ import * as fse from "fs-extra";
 import { readFile, stat } from "node:fs/promises";
 import * as path from "node:path";
 import pc from "picocolors";
+import { discoverLisaAgents, installAgents } from "../codex/agent-installer.js";
+import { installHooks } from "../codex/hooks-installer.js";
+import { readManagedManifest, writeManagedManifest, } from "../codex/manifest.js";
+import { installAgentsMd } from "../codex/agents-md-installer.js";
+import { installSettings } from "../codex/settings-installer.js";
+import { installSkills } from "../codex/skills-installer.js";
 import { DestinationNotDirectoryError, DestinationNotFoundError, UserAbortedError, } from "../errors/index.js";
 import { listFilesRecursive } from "../utils/file-operations.js";
 import { loadIgnorePatterns, } from "../utils/ignore-patterns.js";
@@ -395,6 +401,7 @@ export class Lisa {
             await this.processConfigurations();
             await this.processDeletions();
             await this.processMigrations();
+            await this.processCodexEmit();
             await this.registerPlugins();
             await this.finalize();
             this.printSummary();
@@ -406,6 +413,47 @@ export class Lisa {
             return this.handleApplyError(error);
         }
     }
+    /**
+     * Emit Codex-targeted artifacts (agents, hooks, settings) when the host
+     * project's harness is `codex` or `both`. No-op for `claude` (default).
+     *
+     * Codex artifacts cannot be shipped via plugins (the Codex plugin manifest
+     * has no fields for hooks or agent roles, confirmed in
+     * `codex-rs/core-plugins/src/manifest.rs`). Lisa instead writes them
+     * directly into the host project's `.codex/` tree as part of `apply()`,
+     * tracking ownership via `.codex/.lisa-managed.json` so updates can clean
+     * up stale entries without touching host customizations.
+     */
+    async processCodexEmit() {
+        const { harness } = this.config;
+        if (harness !== "codex" && harness !== "both") {
+            return;
+        }
+        if (this.config.dryRun) {
+            this.deps.logger.info(pc.gray("Codex emit: skipped (dry-run mode)"));
+            return;
+        }
+        const previous = await readManagedManifest(this.config.destDir);
+        const agentSources = await discoverLisaAgents(this.config.lisaDir);
+        const agentResult = await installAgents(agentSources, this.config.destDir, previous.files);
+        const hooksResult = await installHooks(this.config.lisaDir, this.config.destDir, this.detectedTypes);
+        const settingsResult = await installSettings(this.config.destDir);
+        const skillsResult = await installSkills(this.config.lisaDir, this.config.destDir, previous.files);
+        // AGENTS.md is create-only — produced once and never managed by Lisa
+        // afterward, so it's not added to the manifest (Lisa doesn't own it).
+        await installAgentsMd(this.config.destDir);
+        const allManagedFiles = [
+            ...agentResult.managedFiles,
+            ...hooksResult.managedFiles,
+            ...settingsResult.managedFiles,
+            ...skillsResult.managedFiles,
+        ];
+        await writeManagedManifest(this.config.destDir, allManagedFiles);
+        const totalStale = agentResult.deleted.length + skillsResult.deleted.length;
+        this.deps.logger.info(pc.cyan(`Codex emit: ${agentResult.installed.length} agents, ${hooksResult.hookEntries} hooks, ${skillsResult.installed.length} skills, settings ${settingsResult.created ? "created" : "merged"}${totalStale > 0
+            ? ` (${agentResult.deleted.length} stale agents, ${skillsResult.deleted.length} stale skills removed)`
+            : ""}`));
+    }
     /**
      * Schedule a reconciliation re-run when Lisa is invoked as a package-manager
      * lifecycle script. Works around the fact that `bun add` (and similar