@codyswann/lisa 1.95.0 → 2.0.0

package/dist/codex/manifest.js

@@ -0,0 +1,86 @@
+/**
+ * Tracking manifest for Lisa-managed Codex artifacts.
+ *
+ * When Lisa emits files into a host project's `.codex/` directory, it needs
+ * a way to identify those files on the next run so:
+ *   1. Stale files (agents/hooks Lisa stopped shipping) can be cleaned up
+ *   2. Host-authored files (siblings in `.codex/agents/`, custom hook entries)
+ *      are never accidentally overwritten or deleted
+ *
+ * For agent files specifically we cannot embed marker fields *inside* the
+ * TOML itself (Codex's `RawAgentRoleFileToml` deserializer is configured with
+ * `#[serde(deny_unknown_fields)]` — a `_lisa_managed` key would cause Codex
+ * to reject the file at load time). The manifest is the workaround.
+ *
+ * The manifest lives at `.codex/.lisa-managed.json` in the destination
+ * project. It is checked into the host repo so the cleanup behavior is
+ * deterministic across machines.
+ * @module codex/manifest
+ */
+import * as fse from "fs-extra";
+import { readFile, writeFile } from "node:fs/promises";
+import * as path from "node:path";
+/** Filename of the Lisa-managed manifest, relative to `.codex/` */
+export const LISA_MANAGED_MANIFEST_FILENAME = ".lisa-managed.json";
+/**
+ * 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 async function readManagedManifest(destDir) {
+    const manifestPath = path.join(destDir, ".codex", LISA_MANAGED_MANIFEST_FILENAME);
+    if (!(await fse.pathExists(manifestPath))) {
+        return { files: [] };
+    }
+    const raw = await readFile(manifestPath, "utf8");
+    const parsed = JSON.parse(raw);
+    return validateManifest(parsed, manifestPath);
+}
+/**
+ * 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 async function writeManagedManifest(destDir, files) {
+    const codexDir = path.join(destDir, ".codex");
+    await fse.ensureDir(codexDir);
+    const manifestPath = path.join(codexDir, LISA_MANAGED_MANIFEST_FILENAME);
+    const manifest = {
+        files: [...files].sort((a, b) => a.localeCompare(b)),
+    };
+    await writeFile(manifestPath, `${JSON.stringify(manifest, null, 2)}\n`, "utf8");
+}
+/**
+ * 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 function diffManifests(previous, current) {
+    const currentSet = new Set(current);
+    return previous.files.filter(file => !currentSet.has(file));
+}
+/**
+ * Type-guard validator. Throws on shape errors so a corrupted manifest is
+ * surfaced rather than silently producing data loss.
+ * @param parsed - Untrusted JSON value
+ * @param manifestPath - Path used in error messages
+ * @returns Validated manifest
+ */
+function validateManifest(parsed, manifestPath) {
+    if (parsed === null || typeof parsed !== "object") {
+        throw new Error(`Invalid Lisa-managed manifest at ${manifestPath}: expected JSON object`);
+    }
+    const obj = parsed;
+    if (!Array.isArray(obj.files)) {
+        throw new Error(`Invalid Lisa-managed manifest at ${manifestPath}: expected "files" array`);
+    }
+    const files = obj.files.filter((file) => typeof file === "string");
+    if (files.length !== obj.files.length) {
+        throw new Error(`Invalid Lisa-managed manifest at ${manifestPath}: "files" must contain only strings`);
+    }
+    return { files: Object.freeze(files) };
+}
+//# sourceMappingURL=manifest.js.map

package/dist/codex/manifest.js.map

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

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

@@ -0,0 +1,48 @@
+/** Filename of the Codex config file inside `.codex/` */
+export declare const CONFIG_FILENAME = "config.toml";
+/**
+ * Lisa-required settings to merge into `.codex/config.toml`. Host wins on
+ * conflict for any key NOT in this list; for these keys, Lisa wins.
+ *
+ * Why these specific keys:
+ * - `project_doc_max_bytes`: Codex truncates AGENTS.md / project doc walks
+ *   at 32 KiB by default; Lisa's bundled rules can exceed that, so bump to
+ *   64 KiB. Hosts can override upward if they need more headroom.
+ */
+export declare const LISA_REQUIRED_SETTINGS: Readonly<Record<string, unknown>>;
+/** Result of a settings install pass */
+export interface SettingsInstallResult {
+    /** Files written, relative to `.codex/`. Used to update the manifest. */
+    readonly managedFiles: readonly string[];
+    /** Whether the config file was newly created (vs. patched in place) */
+    readonly created: boolean;
+}
+/**
+ * Install or update Lisa's required settings in `.codex/config.toml`.
+ *
+ * Uses `patch` semantics: only keys that differ are written; everything else
+ * (comments, blank lines, key order, host-authored keys) is preserved
+ * byte-for-byte.
+ * @param destDir - Absolute path to the host project root
+ * @returns Result describing what was written
+ */
+export declare function installSettings(destDir: string): Promise<SettingsInstallResult>;
+/**
+ * Merge Lisa-required settings into a TOML document. Pure function for
+ * testability; the installer above is the I/O wrapper.
+ *
+ * If the existing content is empty, we synthesize a minimal TOML document
+ * containing only Lisa's required keys.
+ *
+ * Subtle TOML correctness note: `toml-patch.patch()` appends new root-level
+ * keys at the end of the document, which in TOML semantically attaches them
+ * to the last `[section]` header — a bug for our use case. To work around
+ * this, root keys that aren't already present are PREPENDED above the first
+ * section header instead of going through `patch()`. Existing keys that
+ * differ in value are still patched in place, preserving surrounding
+ * comments and key order.
+ * @param existingToml - Current contents of `.codex/config.toml` (or "")
+ * @returns Merged TOML string with comments/format preserved
+ */
+export declare function mergeSettings(existingToml: string): string;
+//# sourceMappingURL=settings-installer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"settings-installer.d.ts","sourceRoot":"","sources":["../../src/codex/settings-installer.ts"],"names":[],"mappings":"AAsBA,yDAAyD;AACzD,eAAO,MAAM,eAAe,gBAAgB,CAAC;AAE7C;;;;;;;;GAQG;AACH,eAAO,MAAM,sBAAsB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEpE,CAAC;AAEF,wCAAwC;AACxC,MAAM,WAAW,qBAAqB;IACpC,yEAAyE;IACzE,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,uEAAuE;IACvE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,qBAAqB,CAAC,CAchC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAc1D"}

package/dist/codex/settings-installer.js

@@ -0,0 +1,276 @@
+/**
+ * Manage Lisa-required settings in `.codex/config.toml`.
+ *
+ * Codex configuration is TOML, layered system → user → project; Lisa writes
+ * only the project-level file (`<destDir>/.codex/config.toml`). The merge
+ * preserves any host-authored keys, comments, blank lines, and key ordering
+ * by using `@decimalturn/toml-patch` — the only Node TOML library that
+ * round-trips comments correctly (verified during round-3 research).
+ *
+ * Lisa-managed keys (currently a small set; expand as needs arise):
+ *   - `project_doc_max_bytes`: bumped to 65536 so AGENTS.md content beyond
+ *     Codex's 32 KiB default isn't truncated.
+ * @module codex/settings-installer
+ */
+import * as fse from "fs-extra";
+import { readFile, writeFile } from "node:fs/promises";
+import * as path from "node:path";
+import { parse as parseToml, patch as patchToml, } from "@decimalturn/toml-patch";
+/** Filename of the Codex config file inside `.codex/` */
+export const CONFIG_FILENAME = "config.toml";
+/**
+ * Lisa-required settings to merge into `.codex/config.toml`. Host wins on
+ * conflict for any key NOT in this list; for these keys, Lisa wins.
+ *
+ * Why these specific keys:
+ * - `project_doc_max_bytes`: Codex truncates AGENTS.md / project doc walks
+ *   at 32 KiB by default; Lisa's bundled rules can exceed that, so bump to
+ *   64 KiB. Hosts can override upward if they need more headroom.
+ */
+export const LISA_REQUIRED_SETTINGS = {
+    project_doc_max_bytes: 65536,
+};
+/**
+ * Install or update Lisa's required settings in `.codex/config.toml`.
+ *
+ * Uses `patch` semantics: only keys that differ are written; everything else
+ * (comments, blank lines, key order, host-authored keys) is preserved
+ * byte-for-byte.
+ * @param destDir - Absolute path to the host project root
+ * @returns Result describing what was written
+ */
+export async function installSettings(destDir) {
+    const codexDir = path.join(destDir, ".codex");
+    await fse.ensureDir(codexDir);
+    const configPath = path.join(codexDir, CONFIG_FILENAME);
+    const exists = await fse.pathExists(configPath);
+    const existingContent = exists ? await readFile(configPath, "utf8") : "";
+    const merged = mergeSettings(existingContent);
+    await writeFile(configPath, merged, "utf8");
+    return {
+        managedFiles: Object.freeze([CONFIG_FILENAME]),
+        created: !exists,
+    };
+}
+/**
+ * Merge Lisa-required settings into a TOML document. Pure function for
+ * testability; the installer above is the I/O wrapper.
+ *
+ * If the existing content is empty, we synthesize a minimal TOML document
+ * containing only Lisa's required keys.
+ *
+ * Subtle TOML correctness note: `toml-patch.patch()` appends new root-level
+ * keys at the end of the document, which in TOML semantically attaches them
+ * to the last `[section]` header — a bug for our use case. To work around
+ * this, root keys that aren't already present are PREPENDED above the first
+ * section header instead of going through `patch()`. Existing keys that
+ * differ in value are still patched in place, preserving surrounding
+ * comments and key order.
+ * @param existingToml - Current contents of `.codex/config.toml` (or "")
+ * @returns Merged TOML string with comments/format preserved
+ */
+export function mergeSettings(existingToml) {
+    if (existingToml.trim().length === 0) {
+        // Nothing to preserve — emit a clean Lisa-managed file
+        return `${formatLisaSettings()}\n`;
+    }
+    const parsed = parseToml(existingToml);
+    const partitioned = partitionRequiredKeys(parsed);
+    const afterUpdates = applyUpdatedKeys(existingToml, parsed, partitioned.updated);
+    const afterPrepend = applyNewKeys(afterUpdates, partitioned.added);
+    return afterPrepend.endsWith("\n") ? afterPrepend : `${afterPrepend}\n`;
+}
+/**
+ * Split Lisa's required settings into "already-present-but-different" (which
+ * we update in place via toml-patch to preserve comments) and "wholly new"
+ * (which need careful insertion above the first table to avoid TOML's
+ * "attach to last section" semantics).
+ * @param parsed - Existing TOML parsed as a JS object
+ * @returns Two records: keys to update, keys to add
+ */
+function partitionRequiredKeys(parsed) {
+    const entries = Object.entries(LISA_REQUIRED_SETTINGS);
+    const updated = Object.fromEntries(entries.filter(([key, value]) => key in parsed && parsed[key] !== value));
+    const added = Object.fromEntries(entries.filter(([key]) => !(key in parsed)));
+    return { updated, added };
+}
+/**
+ * Patch in-place updates via `toml-patch` so surrounding comments, blank
+ * lines, and key order survive untouched. No-op when nothing to update.
+ * @param toml - Existing TOML source
+ * @param parsed - Existing TOML parsed as a JS object
+ * @param updated - Keys whose values should change
+ * @returns Patched TOML, or `toml` unchanged if no updates were needed
+ */
+function applyUpdatedKeys(toml, parsed, updated) {
+    if (Object.keys(updated).length === 0) {
+        return toml;
+    }
+    return patchToml(toml, { ...parsed, ...updated });
+}
+/**
+ * Add wholly new root keys ABOVE the first table header, sidestepping
+ * `toml-patch`'s default behavior of appending at the end (which would
+ * silently nest the new keys under the trailing section).
+ * @param toml - TOML source after in-place updates were applied
+ * @param added - Keys to insert
+ * @returns TOML with the new keys prepended (or unchanged if `added` is empty)
+ */
+function applyNewKeys(toml, added) {
+    if (Object.keys(added).length === 0) {
+        return toml;
+    }
+    return prependRootKeys(toml, added);
+}
+/**
+ * Insert root-level key=value lines above the first `[section]` header in
+ * the provided TOML string. If no section header exists, append at the end.
+ *
+ * Required because TOML attaches every key to the most-recent table header,
+ * so naively appending a root key at the end of a document with sections
+ * silently nests it under the last section.
+ *
+ * Quote-state-aware: a line whose first non-whitespace char is `[` does
+ * NOT count as a section header if it sits inside an open multi-line string
+ * (`"""..."""` or `'''...'''`). Without this guard, a host config like
+ * `notes = """\n[release-notes]\nv1\n"""` would have Lisa keys spliced into
+ * the middle of the string, corrupting the file.
+ * @param toml - The TOML source to mutate
+ * @param keys - Root-level keys to insert
+ * @returns The TOML source with the new keys placed above any sections
+ */
+function prependRootKeys(toml, keys) {
+    const block = Object.entries(keys)
+        .map(([key, value]) => `${key} = ${formatTomlValue(value)}`)
+        .join("\n");
+    const lines = toml.split("\n");
+    const sectionIndex = findFirstSectionHeaderIndex(lines);
+    if (sectionIndex === -1) {
+        // No sections — safe to append at the end
+        return `${stripTrailingNewlines(toml)}\n${block}\n`;
+    }
+    const before = stripTrailingNewlines(lines.slice(0, sectionIndex).join("\n"));
+    const after = lines.slice(sectionIndex).join("\n");
+    const beforePart = before.length > 0 ? `${before}\n` : "";
+    return `${beforePart}${block}\n\n${after}`;
+}
+/**
+ * Find the line index of the first real `[section]` header, skipping any
+ * `[`-prefixed lines that sit inside an open multi-line TOML string.
+ *
+ * Tracks a single "currently-open multi-line delimiter" (either `"""` or
+ * `'''`). Per TOML grammar these can't be nested, so a string token is
+ * sufficient state.
+ * @param lines - The TOML source split on `\n`
+ * @returns The 0-based line index, or -1 if no section header exists
+ */
+function findFirstSectionHeaderIndex(lines) {
+    return lines.reduce((acc, line, idx) => {
+        if (acc.index !== -1) {
+            return acc;
+        }
+        const nextDelim = updateMultilineState(line, acc.openDelim);
+        // A `[` line only counts when we're NOT currently inside a multi-line
+        // string AND the line didn't open one this iteration.
+        if (acc.openDelim === undefined &&
+            nextDelim === undefined &&
+            /^[ \t]*\[/.test(line)) {
+            return { index: idx, openDelim: nextDelim };
+        }
+        return { index: -1, openDelim: nextDelim };
+    }, { index: -1, openDelim: undefined }).index;
+}
+/**
+ * Compute the new "currently-open multi-line delimiter" state for a line.
+ *
+ * Counts `"""` and `'''` occurrences on the line (each pair toggles).
+ * When entering, `openDelim` becomes the delimiter type; an odd count
+ * within the same line toggles state; an even count leaves it unchanged.
+ * @param line - One line of TOML source
+ * @param openDelim - Currently open delimiter (`"""` / `'''` / undefined)
+ * @returns The state after consuming this line
+ */
+function updateMultilineState(line, openDelim) {
+    if (openDelim !== undefined) {
+        const occurrences = countOccurrences(line, openDelim);
+        return occurrences % 2 === 1 ? undefined : openDelim;
+    }
+    const tripleDouble = countOccurrences(line, '"""');
+    const tripleSingle = countOccurrences(line, "'''");
+    if (tripleDouble % 2 === 1) {
+        return '"""';
+    }
+    if (tripleSingle % 2 === 1) {
+        return "'''";
+    }
+    return undefined;
+}
+/**
+ * Count non-overlapping occurrences of `needle` in `haystack`.
+ * @param haystack - String to search within
+ * @param needle - Substring to count
+ * @returns Non-negative integer
+ */
+function countOccurrences(haystack, needle) {
+    if (needle.length === 0) {
+        return 0;
+    }
+    // Splitting on the needle gives N+1 segments for N occurrences.
+    return haystack.split(needle).length - 1;
+}
+/**
+ * Strip a run of trailing `\n` characters from a string without using a
+ * regex (Sonar flags `\n+$` as potentially-backtracking, even though it
+ * isn't). Other trailing whitespace (spaces, tabs) is preserved because
+ * TOML doesn't care and we want minimal change.
+ * @param value - String to strip
+ * @returns The same string with any trailing newlines removed
+ */
+function stripTrailingNewlines(value) {
+    const lastNonNewline = lastNonNewlineIndex(value);
+    return value.slice(0, lastNonNewline + 1);
+}
+/**
+ * Find the index of the last character in `value` that isn't `\n`. Returns
+ * -1 if the string is empty or all newlines.
+ * @param value - String to scan
+ * @returns The 0-based index of the last non-newline character, or -1
+ */
+function lastNonNewlineIndex(value) {
+    return Array.from(value)
+        .map((char, idx) => ({ char, idx }))
+        .filter(({ char }) => char !== "\n")
+        .reduce((_, { idx }) => idx, -1);
+}
+/**
+ * Render Lisa's required settings as a fresh TOML block. Used when no
+ * host config file exists yet.
+ * @returns The starter TOML content (without trailing newline)
+ */
+function formatLisaSettings() {
+    const header = [
+        "# This file is partly managed by Lisa.",
+        "# The keys Lisa owns are listed below; other keys you add are preserved on update.",
+    ];
+    const settings = Object.entries(LISA_REQUIRED_SETTINGS).map(([key, value]) => `${key} = ${formatTomlValue(value)}`);
+    return [...header, ...settings].join("\n");
+}
+/**
+ * Minimal TOML value formatter for the small set of value shapes we emit
+ * in fresh-file mode (numbers, strings, booleans).
+ * @param value - A value drawn from LISA_REQUIRED_SETTINGS
+ * @returns The TOML literal representation
+ */
+function formatTomlValue(value) {
+    if (typeof value === "number") {
+        return String(value);
+    }
+    if (typeof value === "boolean") {
+        return value ? "true" : "false";
+    }
+    if (typeof value === "string") {
+        return JSON.stringify(value);
+    }
+    throw new Error(`Unsupported settings value type ${typeof value}: ${String(value)}`);
+}
+//# sourceMappingURL=settings-installer.js.map

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

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

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

@@ -0,0 +1,46 @@
+/** Subdirectory inside `.codex/skills/` where Lisa-owned skills live */
+export declare const LISA_SKILLS_SUBDIR: string;
+/** Prefix applied to Lisa command-as-skill names */
+export declare const LISA_COMMAND_SKILL_PREFIX = "lisa-";
+/** Result of one skill copy */
+export interface InstalledSkill {
+    /** Skill name (matches the SKILL.md `name` frontmatter) */
+    readonly name: string;
+    /** Source kind: bundled skill folder or generated from command */
+    readonly source: "bundled" | "command";
+    /** Path written, relative to `.codex/` */
+    readonly relativePath: string;
+}
+/** Aggregated result */
+export interface SkillsInstallResult {
+    readonly installed: readonly InstalledSkill[];
+    readonly managedFiles: readonly string[];
+    /** Skill directories deleted because Lisa stopped shipping them */
+    readonly deleted: readonly string[];
+}
+/**
+ * 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 declare function installSkills(lisaDir: string, destDir: string, previousManagedFiles: readonly string[]): Promise<SkillsInstallResult>;
+/**
+ * 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 declare function convertCommandToSkill(commandSource: string, skillName: string, displayName: string): string;
+//# sourceMappingURL=skills-installer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skills-installer.d.ts","sourceRoot":"","sources":["../../src/codex/skills-installer.ts"],"names":[],"mappings":"AAiCA,wEAAwE;AACxE,eAAO,MAAM,kBAAkB,QAA8B,CAAC;AAE9D,oDAAoD;AACpD,eAAO,MAAM,yBAAyB,UAAU,CAAC;AAKjD,+BAA+B;AAC/B,MAAM,WAAW,cAAc;IAC7B,2DAA2D;IAC3D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,kEAAkE;IAClE,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,CAAC;IACvC,0CAA0C;IAC1C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED,wBAAwB;AACxB,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,SAAS,EAAE,SAAS,cAAc,EAAE,CAAC;IAC9C,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,mEAAmE;IACnE,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,oBAAoB,EAAE,SAAS,MAAM,EAAE,GACtC,OAAO,CAAC,mBAAmB,CAAC,CAyC9B;AAuTD;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CACnC,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,GAClB,MAAM,CAgCR"}