@codyswann/lisa 1.94.0 → 1.96.0

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

@@ -0,0 +1,24 @@
+/** Filename of the Codex project doc at the host project root */
+export declare const AGENTS_MD_FILENAME = "AGENTS.md";
+/** Result of the AGENTS.md install pass */
+export interface AgentsMdInstallResult {
+    /** True if Lisa created the file (false if it already existed) */
+    readonly created: boolean;
+    /** Path written, relative to the host project root (or empty if no-op) */
+    readonly relativePath: string | undefined;
+}
+/**
+ * Write a starter AGENTS.md template at the host project root, but only if
+ * the file doesn't already exist (create-only semantics).
+ * @param destDir - Absolute path to the host project root
+ * @returns Result describing whether a file was created
+ */
+export declare function installAgentsMd(destDir: string): Promise<AgentsMdInstallResult>;
+/**
+ * Starter template content. Intentionally short — the heavy lifting (Lisa
+ * rules, intent routing, orchestration) lives in `.codex/lisa-rules/` and
+ * is injected via the SessionStart hook, so AGENTS.md is reserved for
+ * host-specific notes.
+ */
+export declare const AGENTS_MD_TEMPLATE = "# Project Guidance for Codex\n\nThis project uses Lisa governance. Codex sessions automatically receive\nLisa's rules, agents, and skills via the SessionStart hook in\n`.codex/hooks/lisa/inject-rules.sh`.\n\nThis file is for **project-specific guidance** \u2014 add anything Codex should\nknow about *this particular* project that isn't covered by Lisa's rules.\n\n## What lives where\n\n- `.codex/agents/lisa/` \u2014 Lisa-managed subagent role definitions\n- `.codex/skills/lisa/` \u2014 Lisa-managed skills (invoke via `$<name>`)\n- `.codex/lisa-rules/` \u2014 Lisa rules content (injected at session start)\n- `.codex/hooks/lisa/` \u2014 Lisa-managed hook scripts\n- `.codex/config.toml` \u2014 partly Lisa-managed Codex config\n\n## Custom rules for this project\n\nAdd project-specific guidance below. This section is preserved across Lisa\nupdates (`AGENTS.md` is create-only).\n";
+//# sourceMappingURL=agents-md-installer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agents-md-installer.d.ts","sourceRoot":"","sources":["../../src/codex/agents-md-installer.ts"],"names":[],"mappings":"AAmBA,iEAAiE;AACjE,eAAO,MAAM,kBAAkB,cAAc,CAAC;AAE9C,2CAA2C;AAC3C,MAAM,WAAW,qBAAqB;IACpC,kEAAkE;IAClE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,0EAA0E;IAC1E,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3C;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,qBAAqB,CAAC,CAOhC;AAED;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,23BAqB9B,CAAC"}

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

@@ -0,0 +1,63 @@
+/**
+ * Emit a create-only AGENTS.md template into the host project root.
+ *
+ * Codex auto-loads `AGENTS.md` from the project tree on every session
+ * (per `developers.openai.com/codex/guides/agents-md`). Lisa ships a
+ * starter template so hosts know:
+ *   - Lisa governance is active in this project (rules injected via
+ *     SessionStart hook from `.codex/lisa-rules/`)
+ *   - This file is the place to add project-specific guidance
+ *
+ * Create-only: never overwritten on subsequent `lisa` runs. The host owns
+ * the file once it exists. (Lisa's actual rules go via the inject-rules
+ * hook, so AGENTS.md is purely a host-facing knob.)
+ * @module codex/agents-md-installer
+ */
+import * as fse from "fs-extra";
+import { writeFile } from "node:fs/promises";
+import * as path from "node:path";
+/** Filename of the Codex project doc at the host project root */
+export const AGENTS_MD_FILENAME = "AGENTS.md";
+/**
+ * Write a starter AGENTS.md template at the host project root, but only if
+ * the file doesn't already exist (create-only semantics).
+ * @param destDir - Absolute path to the host project root
+ * @returns Result describing whether a file was created
+ */
+export async function installAgentsMd(destDir) {
+    const filePath = path.join(destDir, AGENTS_MD_FILENAME);
+    if (await fse.pathExists(filePath)) {
+        return { created: false, relativePath: undefined };
+    }
+    await writeFile(filePath, AGENTS_MD_TEMPLATE, "utf8");
+    return { created: true, relativePath: AGENTS_MD_FILENAME };
+}
+/**
+ * Starter template content. Intentionally short — the heavy lifting (Lisa
+ * rules, intent routing, orchestration) lives in `.codex/lisa-rules/` and
+ * is injected via the SessionStart hook, so AGENTS.md is reserved for
+ * host-specific notes.
+ */
+export const AGENTS_MD_TEMPLATE = `# Project Guidance for Codex
+
+This project uses Lisa governance. Codex sessions automatically receive
+Lisa's rules, agents, and skills via the SessionStart hook in
+\`.codex/hooks/lisa/inject-rules.sh\`.
+
+This file is for **project-specific guidance** — add anything Codex should
+know about *this particular* project that isn't covered by Lisa's rules.
+
+## What lives where
+
+- \`.codex/agents/lisa/\` — Lisa-managed subagent role definitions
+- \`.codex/skills/lisa/\` — Lisa-managed skills (invoke via \`$<name>\`)
+- \`.codex/lisa-rules/\` — Lisa rules content (injected at session start)
+- \`.codex/hooks/lisa/\` — Lisa-managed hook scripts
+- \`.codex/config.toml\` — partly Lisa-managed Codex config
+
+## Custom rules for this project
+
+Add project-specific guidance below. This section is preserved across Lisa
+updates (\`AGENTS.md\` is create-only).
+`;
+//# sourceMappingURL=agents-md-installer.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agents-md-installer.js","sourceRoot":"","sources":["../../src/codex/agents-md-installer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC;AAChC,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,iEAAiE;AACjE,MAAM,CAAC,MAAM,kBAAkB,GAAG,WAAW,CAAC;AAU9C;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,OAAe;IAEf,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAC;IACxD,IAAI,MAAM,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACnC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,CAAC;IACrD,CAAC;IACD,MAAM,SAAS,CAAC,QAAQ,EAAE,kBAAkB,EAAE,MAAM,CAAC,CAAC;IACtD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,kBAAkB,EAAE,CAAC;AAC7D,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;;;;;;;;;;;;;;;;;;;;;CAqBjC,CAAC"}

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

@@ -0,0 +1,24 @@
+import type { ProjectType } from "../core/config.js";
+/** Subdirectory inside `.codex/` for Lisa-managed hook scripts */
+export declare const LISA_HOOKS_SUBDIR: string;
+/** Subdirectory inside `.codex/` for Lisa rules content (read by inject-rules) */
+export declare const LISA_RULES_SUBDIR = "lisa-rules";
+/** Filename of the Codex hooks config file inside `.codex/` */
+export declare const HOOKS_FILENAME = "hooks.json";
+/** Result of the hooks install pass */
+export interface HooksInstallResult {
+    /** Files written, relative to `.codex/`. Used to update the manifest. */
+    readonly managedFiles: readonly string[];
+    /** Number of Lisa hook entries written into hooks.json */
+    readonly hookEntries: number;
+}
+/**
+ * Install Lisa hook scripts + rules + hooks.json entries.
+ * @param lisaDir - Absolute path to the Lisa repo root (or installed package)
+ * @param destDir - Absolute path to the host project root
+ * @param detectedTypes - Project types Lisa detected; used to filter stack-
+ *   specific hooks. Always includes the universal hooks regardless.
+ * @returns Result describing what was written
+ */
+export declare function installHooks(lisaDir: string, destDir: string, detectedTypes: readonly ProjectType[]): Promise<HooksInstallResult>;
+//# sourceMappingURL=hooks-installer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hooks-installer.d.ts","sourceRoot":"","sources":["../../src/codex/hooks-installer.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAUrD,kEAAkE;AAClE,eAAO,MAAM,iBAAiB,QAA6B,CAAC;AAE5D,kFAAkF;AAClF,eAAO,MAAM,iBAAiB,eAAe,CAAC;AAE9C,+DAA+D;AAC/D,eAAO,MAAM,cAAc,eAAe,CAAC;AAuF3C,uCAAuC;AACvC,MAAM,WAAW,kBAAkB;IACjC,yEAAyE;IACzE,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,0DAA0D;IAC1D,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,SAAS,WAAW,EAAE,GACpC,OAAO,CAAC,kBAAkB,CAAC,CA2C7B"}

package/dist/codex/hooks-installer.js

@@ -0,0 +1,206 @@
+/**
+ * Install Lisa-managed Codex hooks into a host project.
+ *
+ * Pipeline:
+ *   1. Filter hook catalog by detected project types
+ *   2. Copy each script from `src/codex/scripts/` → `.codex/hooks/lisa/`
+ *   3. For inject-rules: also mirror Lisa rules into `.codex/lisa-rules/`
+ *   4. Tagged-merge `.codex/hooks.json`
+ *
+ * Codex hook event support map (vs. Lisa's existing Claude Code hooks):
+ *   - SessionStart, PreToolUse, PostToolUse, UserPromptSubmit, Stop  ✅
+ *   - PermissionRequest                                             ✅ (Codex-only)
+ *   - SubagentStart, SessionEnd, Notification, PreCompact           ❌ (Codex doesn't have these)
+ * @module codex/hooks-installer
+ */
+import * as fse from "fs-extra";
+import { chmod, copyFile, readFile, readdir, writeFile, } from "node:fs/promises";
+import * as path from "node:path";
+import { fileURLToPath } from "node:url";
+import { mergeLisaHooks, parseHooksFile, serializeHooksFile, } from "./hooks-merger.js";
+/** Subdirectory inside `.codex/` for Lisa-managed hook scripts */
+export const LISA_HOOKS_SUBDIR = path.join("hooks", "lisa");
+/** Subdirectory inside `.codex/` for Lisa rules content (read by inject-rules) */
+export const LISA_RULES_SUBDIR = "lisa-rules";
+/** Filename of the Codex hooks config file inside `.codex/` */
+export const HOOKS_FILENAME = "hooks.json";
+/**
+ * Matcher regex shared by every PostToolUse/PreToolUse hook that fires on
+ * a file write. Codex emits these tool names for filesystem edits across
+ * its three write paths (text Edit, file Write, apply_patch diff).
+ */
+const WRITE_MATCHER = "Edit|Write|apply_patch";
+/**
+ * Hook catalog. Adding a new hook? Three steps:
+ *   1. Drop the script into `src/codex/scripts/<filename>`
+ *   2. Add an entry here
+ *   3. Add tests in `tests/unit/codex/hooks-installer.test.ts`
+ *
+ * Stack-specific hooks are gated by `forProjectTypes` so they're only shipped
+ * when the relevant project type is detected.
+ */
+const HOOK_CATALOG = [
+    {
+        id: "inject-rules",
+        event: "SessionStart",
+        matcher: "",
+        scriptFilename: "inject-rules.sh",
+        forProjectTypes: ["*"],
+        statusMessage: "Injecting Lisa rules into session context",
+    },
+    {
+        id: "notify-ntfy",
+        event: "Stop",
+        matcher: "",
+        scriptFilename: "notify-ntfy.sh",
+        forProjectTypes: ["*"],
+    },
+    {
+        id: "format-on-edit",
+        event: "PostToolUse",
+        matcher: WRITE_MATCHER,
+        scriptFilename: "format-on-edit.sh",
+        forProjectTypes: ["typescript"],
+    },
+    {
+        id: "lint-on-edit",
+        event: "PostToolUse",
+        matcher: WRITE_MATCHER,
+        scriptFilename: "lint-on-edit.sh",
+        forProjectTypes: ["typescript"],
+    },
+    {
+        id: "sg-scan-on-edit",
+        event: "PostToolUse",
+        matcher: WRITE_MATCHER,
+        scriptFilename: "sg-scan-on-edit.sh",
+        forProjectTypes: ["typescript"],
+    },
+    {
+        id: "rubocop-on-edit",
+        event: "PostToolUse",
+        matcher: WRITE_MATCHER,
+        scriptFilename: "rubocop-on-edit.sh",
+        forProjectTypes: ["rails"],
+    },
+    {
+        id: "block-migration-edits",
+        event: "PreToolUse",
+        matcher: WRITE_MATCHER,
+        scriptFilename: "block-migration-edits.sh",
+        forProjectTypes: ["nestjs"],
+    },
+];
+/**
+ * Install Lisa hook scripts + rules + hooks.json entries.
+ * @param lisaDir - Absolute path to the Lisa repo root (or installed package)
+ * @param destDir - Absolute path to the host project root
+ * @param detectedTypes - Project types Lisa detected; used to filter stack-
+ *   specific hooks. Always includes the universal hooks regardless.
+ * @returns Result describing what was written
+ */
+export async function installHooks(lisaDir, destDir, detectedTypes) {
+    const codexDir = path.join(destDir, ".codex");
+    const hooksDir = path.join(codexDir, LISA_HOOKS_SUBDIR);
+    const rulesDir = path.join(codexDir, LISA_RULES_SUBDIR);
+    await fse.ensureDir(hooksDir);
+    await fse.ensureDir(rulesDir);
+    const applicable = filterCatalogByTypes(detectedTypes);
+    // Step 1: copy every applicable script and collect their relative paths
+    const scriptFiles = await Promise.all(applicable.map(async (entry) => {
+        const scriptSource = resolveBundledScript(entry.scriptFilename);
+        const scriptDest = path.join(hooksDir, entry.scriptFilename);
+        await copyFile(scriptSource, scriptDest);
+        await chmod(scriptDest, 0o755);
+        return path.join(LISA_HOOKS_SUBDIR, entry.scriptFilename);
+    }));
+    // Step 2: mirror rules from Lisa into .codex/lisa-rules/ (only when
+    // inject-rules is being installed — i.e., always, since it's a "*" hook)
+    const ruleFiles = applicable.some(e => e.id === "inject-rules")
+        ? (await mirrorRules(lisaDir, rulesDir)).map(file => path.join(LISA_RULES_SUBDIR, file))
+        : [];
+    // Step 3: tagged-merge hooks.json
+    const hooksFilePath = path.join(codexDir, HOOKS_FILENAME);
+    const existing = await readHooksFile(hooksFilePath);
+    const lisaHookSpecs = applicable.map(entry => catalogEntryToSpec(entry, destDir));
+    const merged = mergeLisaHooks(existing, lisaHookSpecs);
+    await writeFile(hooksFilePath, serializeHooksFile(merged), "utf8");
+    return {
+        managedFiles: Object.freeze([...scriptFiles, ...ruleFiles, HOOKS_FILENAME]),
+        hookEntries: lisaHookSpecs.length,
+    };
+}
+/**
+ * Filter the catalog by detected project types. Universal hooks (`"*"`)
+ * always pass; stack-specific hooks pass only if their type is detected.
+ * @param detectedTypes - Project types Lisa detected for the host
+ * @returns The catalog entries that apply to this host
+ */
+function filterCatalogByTypes(detectedTypes) {
+    const detectedSet = new Set(detectedTypes);
+    return HOOK_CATALOG.filter(entry => entry.forProjectTypes.some(t => t === "*" || detectedSet.has(t)));
+}
+/**
+ * Convert a catalog entry into the LisaHookSpec the merger consumes.
+ *
+ * The script path resolves at hook-firing time via
+ * `git rev-parse --show-toplevel` because Codex sets the hook script's cwd
+ * to the session cwd, not the repo root. Falls back to `pwd` if not in a git
+ * repo (rare).
+ * @param entry - One catalog entry to translate
+ * @param _destDir - Reserved for future per-host customization; currently unused
+ * @returns A LisaHookSpec ready to feed into mergeLisaHooks
+ */
+function catalogEntryToSpec(entry, _destDir) {
+    const command = `bash "$(git rev-parse --show-toplevel 2>/dev/null || pwd)/.codex/${LISA_HOOKS_SUBDIR}/${entry.scriptFilename}"`;
+    return {
+        id: entry.id,
+        event: entry.event,
+        matcher: entry.matcher,
+        command,
+        ...(entry.statusMessage !== undefined
+            ? { statusMessage: entry.statusMessage }
+            : {}),
+    };
+}
+/**
+ * Read an existing hooks.json file, returning {} if absent.
+ * @param hooksFilePath - Absolute path to `<destDir>/.codex/hooks.json`
+ * @returns Parsed HooksFile (empty object if the file doesn't exist)
+ */
+async function readHooksFile(hooksFilePath) {
+    if (!(await fse.pathExists(hooksFilePath))) {
+        return {};
+    }
+    const raw = await readFile(hooksFilePath, "utf8");
+    return parseHooksFile(raw);
+}
+/**
+ * Resolve a bundled script path. Scripts ship inside the Lisa source tree at
+ * `src/codex/scripts/<name>` and are accessible at runtime by computing the
+ * path relative to this module's URL.
+ * @param filename - Script filename (e.g. "inject-rules.sh")
+ * @returns Absolute path to the bundled script in the Lisa install
+ */
+function resolveBundledScript(filename) {
+    const moduleDir = path.dirname(fileURLToPath(import.meta.url));
+    return path.join(moduleDir, "scripts", filename);
+}
+/**
+ * Copy every .md file from Lisa's `plugins/lisa/rules/` into the host's
+ * `.codex/lisa-rules/`. Returns the list of filenames copied (without
+ * directory).
+ * @param lisaDir - Absolute path to the Lisa repo / installed package
+ * @param rulesDestDir - Absolute path to `<destDir>/.codex/lisa-rules/`
+ * @returns Filenames (without directory) of every rule .md file copied
+ */
+async function mirrorRules(lisaDir, rulesDestDir) {
+    const rulesSourceDir = path.join(lisaDir, "plugins", "lisa", "rules");
+    if (!(await fse.pathExists(rulesSourceDir))) {
+        return [];
+    }
+    const files = (await readdir(rulesSourceDir)).filter(name => name.endsWith(".md"));
+    await Promise.all(files.map(file => copyFile(path.join(rulesSourceDir, file), path.join(rulesDestDir, file))));
+    return Object.freeze(files);
+}
+//# sourceMappingURL=hooks-installer.js.map

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

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

package/dist/codex/hooks-merger.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Tagged-merge writer for `.codex/hooks.json`.
+ *
+ * Codex's hooks parser is not configured with `deny_unknown_fields` (verified
+ * against `codex-rs/config/src/hook_config.rs`), so Lisa can attach
+ * `_lisaManaged: true` and `_lisaId: "..."` marker fields to individual hook
+ * entries. On every install the merger:
+ *
+ *   1. Reads the existing hooks.json (if any)
+ *   2. Strips every entry where `_lisaManaged === true`
+ *   3. Appends the current Lisa hook set with markers attached
+ *   4. Preserves all entries the host added (no `_lisaManaged` marker)
+ *
+ * This mirrors the pattern Lisa uses for `enabledPlugins` deep-merge in
+ * `.claude/settings.json` — ownership is keyed on a marker field instead of
+ * a key path.
+ * @module codex/hooks-merger
+ */
+/** Markers attached to every Lisa-owned hook entry */
+export declare const LISA_MANAGED_MARKER: "_lisaManaged";
+export declare const LISA_ID_MARKER: "_lisaId";
+/** A single hook handler entry (innermost: type/command/timeout/etc.) */
+export interface HookHandler {
+    readonly type: string;
+    readonly command?: string;
+    readonly timeout?: number;
+    readonly statusMessage?: string;
+    /** Lisa ownership marker (set on Lisa-owned entries only) */
+    readonly [LISA_MANAGED_MARKER]?: boolean;
+    /** Stable identifier so logs can name the hook */
+    readonly [LISA_ID_MARKER]?: string;
+}
+/** A matcher group: a regex matcher + an array of handlers it triggers */
+export interface MatcherGroup {
+    readonly matcher: string;
+    readonly hooks: readonly HookHandler[];
+}
+/** All hook events Codex understands */
+export type CodexHookEvent = "PreToolUse" | "PostToolUse" | "UserPromptSubmit" | "Stop" | "SessionStart" | "PermissionRequest";
+/** The shape of `.codex/hooks.json` */
+export interface HooksFile {
+    readonly hooks?: Readonly<Partial<Record<CodexHookEvent, readonly MatcherGroup[]>>>;
+}
+/** A Lisa-owned hook to be installed (mutable input — markers added by merger) */
+export interface LisaHookSpec {
+    /** Stable identifier; goes into `_lisaId` so logs can name the hook */
+    readonly id: string;
+    /** Codex hook event the entry applies to */
+    readonly event: CodexHookEvent;
+    /** Matcher regex for `matcher` field (use "" for events that don't match) */
+    readonly matcher: string;
+    /** Shell command to run */
+    readonly command: string;
+    /** Optional timeout in seconds (Codex default is 600) */
+    readonly timeout?: number;
+    /** Optional human-readable status message */
+    readonly statusMessage?: string;
+}
+/**
+ * Merge Lisa's current hook set into an existing hooks.json document,
+ * preserving any host-authored entries.
+ * @param existing - Parsed hooks.json (or {} if none)
+ * @param lisaHooks - Lisa-owned hook specs to install
+ * @returns New HooksFile object with Lisa entries replaced and host entries preserved
+ */
+export declare function mergeLisaHooks(existing: HooksFile, lisaHooks: readonly LisaHookSpec[]): HooksFile;
+/**
+ * Serialize a HooksFile to JSON suitable for writing to disk. Two-space
+ * indent, trailing newline.
+ * @param file - Hooks file to serialize
+ * @returns JSON string ending with a newline
+ */
+export declare function serializeHooksFile(file: HooksFile): string;
+/**
+ * Type guard: parse raw JSON into a HooksFile, validating only the shape we
+ * touch. We do NOT reject unknown fields since Codex's parser allows them
+ * and we want to preserve host extensions on round-trip.
+ * @param raw - Untrusted JSON string from disk
+ * @returns Parsed HooksFile
+ */
+export declare function parseHooksFile(raw: string): HooksFile;
+//# sourceMappingURL=hooks-merger.d.ts.map

package/dist/codex/hooks-merger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks-merger.d.ts","sourceRoot":"","sources":["../../src/codex/hooks-merger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,sDAAsD;AACtD,eAAO,MAAM,mBAAmB,EAAG,cAAuB,CAAC;AAC3D,eAAO,MAAM,cAAc,EAAG,SAAkB,CAAC;AAEjD,yEAAyE;AACzE,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,6DAA6D;IAC7D,QAAQ,CAAC,CAAC,mBAAmB,CAAC,CAAC,EAAE,OAAO,CAAC;IACzC,kDAAkD;IAClD,QAAQ,CAAC,CAAC,cAAc,CAAC,CAAC,EAAE,MAAM,CAAC;CACpC;AAED,0EAA0E;AAC1E,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,SAAS,WAAW,EAAE,CAAC;CACxC;AAED,wCAAwC;AACxC,MAAM,MAAM,cAAc,GACtB,YAAY,GACZ,aAAa,GACb,kBAAkB,GAClB,MAAM,GACN,cAAc,GACd,mBAAmB,CAAC;AAExB,uCAAuC;AACvC,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CACvB,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,SAAS,YAAY,EAAE,CAAC,CAAC,CACzD,CAAC;CACH;AAED,kFAAkF;AAClF,MAAM,WAAW,YAAY;IAC3B,uEAAuE;IACvE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,6EAA6E;IAC7E,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,2BAA2B;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,yDAAyD;IACzD,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,6CAA6C;IAC7C,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,SAAS,EACnB,SAAS,EAAE,SAAS,YAAY,EAAE,GACjC,SAAS,CAuCX;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAE1D;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAgBrD"}

package/dist/codex/hooks-merger.js

@@ -0,0 +1,127 @@
+/**
+ * Tagged-merge writer for `.codex/hooks.json`.
+ *
+ * Codex's hooks parser is not configured with `deny_unknown_fields` (verified
+ * against `codex-rs/config/src/hook_config.rs`), so Lisa can attach
+ * `_lisaManaged: true` and `_lisaId: "..."` marker fields to individual hook
+ * entries. On every install the merger:
+ *
+ *   1. Reads the existing hooks.json (if any)
+ *   2. Strips every entry where `_lisaManaged === true`
+ *   3. Appends the current Lisa hook set with markers attached
+ *   4. Preserves all entries the host added (no `_lisaManaged` marker)
+ *
+ * This mirrors the pattern Lisa uses for `enabledPlugins` deep-merge in
+ * `.claude/settings.json` — ownership is keyed on a marker field instead of
+ * a key path.
+ * @module codex/hooks-merger
+ */
+/** Markers attached to every Lisa-owned hook entry */
+export const LISA_MANAGED_MARKER = "_lisaManaged";
+export const LISA_ID_MARKER = "_lisaId";
+/**
+ * Merge Lisa's current hook set into an existing hooks.json document,
+ * preserving any host-authored entries.
+ * @param existing - Parsed hooks.json (or {} if none)
+ * @param lisaHooks - Lisa-owned hook specs to install
+ * @returns New HooksFile object with Lisa entries replaced and host entries preserved
+ */
+export function mergeLisaHooks(existing, lisaHooks) {
+    // Step 1: drop every matcher-group that's pure-Lisa, strip Lisa handlers
+    // out of mixed-ownership groups, keep purely-host groups unchanged.
+    const existingEvents = Object.keys(existing.hooks ?? {});
+    const hostOnly = Object.fromEntries(existingEvents
+        .map(event => {
+        const filtered = stripLisaHandlers(existing.hooks?.[event] ?? []);
+        return [event, filtered];
+    })
+        .filter(([, groups]) => groups.length > 0));
+    // Step 2: append Lisa's current hook set, grouping by event
+    const lisaByEvent = lisaHooks.reduce((acc, spec) => {
+        const existingGroups = acc[spec.event] ?? [];
+        return {
+            ...acc,
+            [spec.event]: [...existingGroups, lisaSpecToMatcherGroup(spec)],
+        };
+    }, {});
+    // Step 3: combine — for events touched by both, host first then Lisa
+    const allEvents = new Set([
+        ...Object.keys(hostOnly),
+        ...Object.keys(lisaByEvent),
+    ]);
+    const merged = Object.fromEntries(Array.from(allEvents).map(event => [
+        event,
+        [...(hostOnly[event] ?? []), ...(lisaByEvent[event] ?? [])],
+    ]));
+    return { hooks: merged };
+}
+/**
+ * Serialize a HooksFile to JSON suitable for writing to disk. Two-space
+ * indent, trailing newline.
+ * @param file - Hooks file to serialize
+ * @returns JSON string ending with a newline
+ */
+export function serializeHooksFile(file) {
+    return `${JSON.stringify(file, null, 2)}\n`;
+}
+/**
+ * Type guard: parse raw JSON into a HooksFile, validating only the shape we
+ * touch. We do NOT reject unknown fields since Codex's parser allows them
+ * and we want to preserve host extensions on round-trip.
+ * @param raw - Untrusted JSON string from disk
+ * @returns Parsed HooksFile
+ */
+export function parseHooksFile(raw) {
+    if (raw.trim().length === 0) {
+        return {};
+    }
+    const parsed = JSON.parse(raw);
+    if (parsed === null || typeof parsed !== "object") {
+        throw new Error("hooks.json must contain a JSON object at the root");
+    }
+    const obj = parsed;
+    if (obj.hooks === undefined) {
+        return {};
+    }
+    if (typeof obj.hooks !== "object" || obj.hooks === null) {
+        throw new Error("hooks.json: 'hooks' field must be an object");
+    }
+    return parsed;
+}
+/**
+ * Drop every Lisa-managed handler from a list of matcher groups. Groups
+ * whose only handlers were Lisa-managed are removed entirely. Groups with
+ * mixed ownership keep their host handlers.
+ * @param groups - Existing matcher groups for one event
+ * @returns The same groups with Lisa-managed handlers removed (empty groups dropped)
+ */
+function stripLisaHandlers(groups) {
+    return groups
+        .map(group => ({
+        matcher: group.matcher,
+        hooks: group.hooks.filter(handler => handler[LISA_MANAGED_MARKER] !== true),
+    }))
+        .filter(group => group.hooks.length > 0);
+}
+/**
+ * Convert a LisaHookSpec into a MatcherGroup with markers attached.
+ * @param spec - One Lisa hook spec to install
+ * @returns A matcher group containing one Lisa-marked handler
+ */
+function lisaSpecToMatcherGroup(spec) {
+    const handler = {
+        type: "command",
+        command: spec.command,
+        [LISA_MANAGED_MARKER]: true,
+        [LISA_ID_MARKER]: spec.id,
+        ...(spec.timeout !== undefined ? { timeout: spec.timeout } : {}),
+        ...(spec.statusMessage !== undefined
+            ? { statusMessage: spec.statusMessage }
+            : {}),
+    };
+    return {
+        matcher: spec.matcher,
+        hooks: [handler],
+    };
+}
+//# sourceMappingURL=hooks-merger.js.map

package/dist/codex/hooks-merger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks-merger.js","sourceRoot":"","sources":["../../src/codex/hooks-merger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,sDAAsD;AACtD,MAAM,CAAC,MAAM,mBAAmB,GAAG,cAAuB,CAAC;AAC3D,MAAM,CAAC,MAAM,cAAc,GAAG,SAAkB,CAAC;AAoDjD;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAC5B,QAAmB,EACnB,SAAkC;IAElC,yEAAyE;IACzE,oEAAoE;IACpE,MAAM,cAAc,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE,CAAqB,CAAC;IAC7E,MAAM,QAAQ,GACZ,MAAM,CAAC,WAAW,CAChB,cAAc;SACX,GAAG,CAAC,KAAK,CAAC,EAAE;QACX,MAAM,QAAQ,GAAG,iBAAiB,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QAClE,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAU,CAAC;IACpC,CAAC,CAAC;SACD,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAC7C,CAAC;IAEJ,4DAA4D;IAC5D,MAAM,WAAW,GAAG,SAAS,CAAC,MAAM,CAElC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE;QACd,MAAM,cAAc,GAAG,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QAC7C,OAAO;YACL,GAAG,GAAG;YACN,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,cAAc,EAAE,sBAAsB,CAAC,IAAI,CAAC,CAAC;SAChE,CAAC;IACJ,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,qEAAqE;IACrE,MAAM,SAAS,GAAG,IAAI,GAAG,CAAiB;QACxC,GAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAsB;QAC9C,GAAI,MAAM,CAAC,IAAI,CAAC,WAAW,CAAsB;KAClD,CAAC,CAAC;IACH,MAAM,MAAM,GACV,MAAM,CAAC,WAAW,CAChB,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QACjC,KAAK;QACL,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;KAC5D,CAAC,CACH,CAAC;IAEJ,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AAC3B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAe;IAChD,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;AAC9C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAY,CAAC;IAC1C,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAClD,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;IACvE,CAAC;IACD,MAAM,GAAG,GAAG,MAAiC,CAAC;IAC9C,IAAI,GAAG,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC5B,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,IAAI,OAAO,GAAG,CAAC,KAAK,KAAK,QAAQ,IAAI,GAAG,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;QACxD,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;IACjE,CAAC;IACD,OAAO,MAAmB,CAAC;AAC7B,CAAC;AAED;;;;;;GAMG;AACH,SAAS,iBAAiB,CACxB,MAA+B;IAE/B,OAAO,MAAM;SACV,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACb,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,CACvB,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,mBAAmB,CAAC,KAAK,IAAI,CACjD;KACF,CAAC,CAAC;SACF,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AAC7C,CAAC;AAED;;;;GAIG;AACH,SAAS,sBAAsB,CAAC,IAAkB;IAChD,MAAM,OAAO,GAAgB;QAC3B,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,CAAC,mBAAmB,CAAC,EAAE,IAAI;QAC3B,CAAC,cAAc,CAAC,EAAE,IAAI,CAAC,EAAE;QACzB,GAAG,CAAC,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChE,GAAG,CAAC,IAAI,CAAC,aAAa,KAAK,SAAS;YAClC,CAAC,CAAC,EAAE,aAAa,EAAE,IAAI,CAAC,aAAa,EAAE;YACvC,CAAC,CAAC,EAAE,CAAC;KACR,CAAC;IACF,OAAO;QACL,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,KAAK,EAAE,CAAC,OAAO,CAAC;KACjB,CAAC;AACJ,CAAC"}

package/dist/codex/manifest.d.ts

@@ -0,0 +1,32 @@
+/** Filename of the Lisa-managed manifest, relative to `.codex/` */
+export declare const LISA_MANAGED_MANIFEST_FILENAME = ".lisa-managed.json";
+/** Schema of `.codex/.lisa-managed.json` */
+export interface LisaManagedManifest {
+    /**
+     * Paths of files Lisa wrote, relative to the `.codex/` directory.
+     * Used to identify which files to delete when they stop being shipped.
+     */
+    readonly files: readonly string[];
+}
+/**
+ * Read the Lisa-managed manifest from `<destDir>/.codex/.lisa-managed.json`.
+ * Returns an empty manifest if the file doesn't exist.
+ * @param destDir - Absolute path to the destination project root
+ * @returns Parsed manifest (with empty file list if absent)
+ */
+export declare function readManagedManifest(destDir: string): Promise<LisaManagedManifest>;
+/**
+ * Write the Lisa-managed manifest to disk, replacing any existing content.
+ * @param destDir - Absolute path to the destination project root
+ * @param files - Sorted list of relative-to-`.codex/` file paths Lisa shipped
+ */
+export declare function writeManagedManifest(destDir: string, files: readonly string[]): Promise<void>;
+/**
+ * Compute the set of stale files: in the previous manifest but not in the
+ * new shipment. These are candidates for deletion.
+ * @param previous - Manifest from the prior run
+ * @param current - File list Lisa is shipping this run (relative to `.codex/`)
+ * @returns Files that should be removed from the host project
+ */
+export declare function diffManifests(previous: LisaManagedManifest, current: readonly string[]): readonly string[];
+//# sourceMappingURL=manifest.d.ts.map

package/dist/codex/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/codex/manifest.ts"],"names":[],"mappings":"AAuBA,mEAAmE;AACnE,eAAO,MAAM,8BAA8B,uBAAuB,CAAC;AAEnE,4CAA4C;AAC5C,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,mBAAmB,CAAC,CAY9B;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,SAAS,MAAM,EAAE,GACvB,OAAO,CAAC,IAAI,CAAC,CAYf;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,mBAAmB,EAC7B,OAAO,EAAE,SAAS,MAAM,EAAE,GACzB,SAAS,MAAM,EAAE,CAGnB"}