@codyswann/lisa 2.35.0 → 2.37.0

package/package.json

@@ -82,7 +82,7 @@
     "lodash": ">=4.18.1"
   },
   "name": "@codyswann/lisa",
-  "version": "2.35.0",
+  "version": "2.37.0",
   "description": "Claude Code governance framework that applies guardrails, guidance, and automated enforcement to projects",
   "main": "dist/index.js",
   "exports": {

package/plugins/lisa/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "lisa",
-  "version": "2.35.0",
+  "version": "2.37.0",
   "description": "Universal governance — agents, skills, commands, hooks, and rules for all projects",
   "author": {
     "name": "Cody Swann"

package/plugins/lisa/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "lisa",
-  "version": "2.35.0",
+  "version": "2.37.0",
   "description": "Universal governance: agents, skills, commands, hooks, and rules for all projects.",
   "author": {
     "name": "Cody Swann"

package/plugins/lisa-cdk/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "lisa-cdk",
-  "version": "2.35.0",
+  "version": "2.37.0",
   "description": "AWS CDK-specific plugin",
   "author": {
     "name": "Cody Swann"

package/plugins/lisa-cdk/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "lisa-cdk",
-  "version": "2.35.0",
+  "version": "2.37.0",
   "description": "AWS CDK-specific Lisa plugin.",
   "author": {
     "name": "Cody Swann"

package/plugins/lisa-expo/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "lisa-expo",
-  "version": "2.35.0",
+  "version": "2.37.0",
   "description": "Expo/React Native-specific skills, agents, rules, and MCP servers",
   "author": {
     "name": "Cody Swann"

package/plugins/lisa-expo/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "lisa-expo",
-  "version": "2.35.0",
+  "version": "2.37.0",
   "description": "Expo and React Native-specific skills, agents, rules, and MCP servers.",
   "author": {
     "name": "Cody Swann"

package/plugins/lisa-harper-fabric/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "lisa-harper-fabric",
-  "version": "2.35.0",
+  "version": "2.37.0",
   "description": "Harper/Fabric-specific rules for TypeScript component apps",
   "author": {
     "name": "Cody Swann"

package/plugins/lisa-harper-fabric/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "lisa-harper-fabric",
-  "version": "2.35.0",
+  "version": "2.37.0",
   "description": "Harper/Fabric-specific Lisa rules for TypeScript component apps.",
   "author": {
     "name": "Cody Swann"

package/plugins/lisa-nestjs/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "lisa-nestjs",
-  "version": "2.35.0",
+  "version": "2.37.0",
   "description": "NestJS-specific skills (GraphQL, TypeORM) and hooks (migration write-protection)",
   "author": {
     "name": "Cody Swann"

package/plugins/lisa-nestjs/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "lisa-nestjs",
-  "version": "2.35.0",
+  "version": "2.37.0",
   "description": "NestJS-specific skills and migration write-protection hooks.",
   "author": {
     "name": "Cody Swann"

package/plugins/lisa-openclaw/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "lisa-openclaw",
-  "version": "2.35.0",
+  "version": "2.37.0",
   "description": "Connect staff roles to Telegram or Slack via OpenClaw — facilitator/specialist hub-and-spoke routing and repo-coding topics, for Claude Code and Codex",
   "author": {
     "name": "Cody Swann"

package/plugins/lisa-openclaw/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "lisa-openclaw",
-  "version": "2.35.0",
+  "version": "2.37.0",
   "description": "Connect staff roles to Telegram or Slack via OpenClaw — facilitator/specialist hub-and-spoke routing and repo-coding topics, across Claude and Codex.",
   "author": {
     "name": "Cody Swann"

package/plugins/lisa-rails/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "lisa-rails",
-  "version": "2.35.0",
+  "version": "2.37.0",
   "description": "Ruby on Rails-specific hooks — RuboCop linting/formatting and ast-grep scanning on edit",
   "author": {
     "name": "Cody Swann"

package/plugins/lisa-rails/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "lisa-rails",
-  "version": "2.35.0",
+  "version": "2.37.0",
   "description": "Ruby on Rails-specific skills and hooks for RuboCop and ast-grep scanning on edit.",
   "author": {
     "name": "Cody Swann"

package/plugins/lisa-typescript/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "lisa-typescript",
-  "version": "2.35.0",
+  "version": "2.37.0",
   "description": "TypeScript-specific hooks — Prettier formatting, ESLint linting, and ast-grep scanning on edit",
   "author": {
     "name": "Cody Swann"

package/plugins/lisa-typescript/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "lisa-typescript",
-  "version": "2.35.0",
+  "version": "2.37.0",
   "description": "TypeScript-specific hooks for formatting, linting, and ast-grep scanning on edit.",
   "author": {
     "name": "Cody Swann"

package/plugins/lisa-wiki/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "lisa-wiki",
-  "version": "2.35.0",
+  "version": "2.37.0",
   "description": "LLM Wiki — a distributable, git-native markdown knowledge base for Claude Code and Codex",
   "author": {
     "name": "Cody Swann"

package/plugins/lisa-wiki/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "lisa-wiki",
-  "version": "2.35.0",
+  "version": "2.37.0",
   "description": "Distributable LLM Wiki kernel — ingest, query, lint, and maintain a git-native markdown knowledge base across Claude and Codex.",
   "author": {
     "name": "Cody Swann"

package/scripts/generate-codex-plugin-artifacts.mjs

@@ -18,32 +18,140 @@
  */
 import fs from "node:fs";
 import path from "node:path";
+import { fileURLToPath } from "node:url";
 
-const [pluginDirArg, versionArg] = process.argv.slice(2);
-if (!pluginDirArg || !versionArg) {
-  console.error(
-    "Usage: generate-codex-plugin-artifacts.mjs <plugin-dir> <version>"
-  );
-  process.exit(1);
+/**
+ * Parse the leading YAML frontmatter block of a SKILL.md file.
+ *
+ * The frontmatter is the simple `key: value` YAML between the first two `---`
+ * fences at the very top of the file (the shape every `plugins/*\/skills/*\/SKILL.md`
+ * uses). Values are read verbatim as strings (trimmed); nested structures and
+ * arrays are not interpreted because skill frontmatter does not use them.
+ *
+ * @param {string} skillMdPath Absolute or relative path to a SKILL.md file.
+ * @returns {{ name?: string, description?: string } & Record<string, string> | null}
+ *   The parsed key/value pairs, or `null` (skip sentinel) when the file has no
+ *   leading `---`-delimited frontmatter block. Pure: never writes.
+ */
+export function parseSkillFrontmatter(skillMdPath) {
+  const raw = fs.readFileSync(skillMdPath, "utf8");
+  // Frontmatter must be the very first thing in the file. Normalize CRLF so a
+  // Windows-authored SKILL.md parses identically to a LF one.
+  const normalized = raw.replace(/\r\n/g, "\n");
+  if (!normalized.startsWith("---\n")) {
+    return null;
+  }
+  const closingIndex = normalized.indexOf("\n---", 3);
+  if (closingIndex === -1) {
+    return null;
+  }
+  const block = normalized.slice(4, closingIndex);
+  const frontmatter = {};
+  for (const line of block.split("\n")) {
+    const trimmed = line.trim();
+    if (trimmed === "" || trimmed.startsWith("#")) {
+      continue;
+    }
+    const separator = trimmed.indexOf(":");
+    if (separator === -1) {
+      continue;
+    }
+    const key = trimmed.slice(0, separator).trim();
+    if (key === "") {
+      continue;
+    }
+    const value = trimmed
+      .slice(separator + 1)
+      .trim()
+      .replace(/^["']|["']$/g, "");
+    frontmatter[key] = value;
+  }
+  return frontmatter;
 }
 
-const pluginDir = path.resolve(pluginDirArg);
-const claudeManifestPath = path.join(
-  pluginDir,
-  ".claude-plugin",
-  "plugin.json"
-);
-if (!fs.existsSync(claudeManifestPath)) {
-  process.exit(0);
+/**
+ * Encode a single string as a YAML double-quoted scalar.
+ *
+ * Double-quoting unconditionally is the deterministic choice: it round-trips
+ * every possible string — colons, leading `#`/`-`, quotes, indicators — without
+ * the branchy "is this plain-safe?" logic that risks emitting ambiguous YAML.
+ * Only the five escapes YAML's double-quoted style requires are applied, in a
+ * fixed order, so output is a pure function of the input.
+ *
+ * @param {string} value Raw string to encode.
+ * @returns {string} The value wrapped in double quotes with `\`, `"`, and the
+ *   C0 control characters (tab, newline, carriage return) escaped.
+ */
+function yamlQuote(value) {
+  const escaped = value
+    .replace(/\\/g, "\\\\")
+    .replace(/"/g, '\\"')
+    .replace(/\t/g, "\\t")
+    .replace(/\n/g, "\\n")
+    .replace(/\r/g, "\\r");
+  return `"${escaped}"`;
 }
 
-const claudeManifest = JSON.parse(fs.readFileSync(claudeManifestPath, "utf8"));
-const pluginName = claudeManifest.name;
+/**
+ * Serialize a Codex `interface` object to deterministic `openai.yaml` content.
+ *
+ * Emits exactly three keys in a fixed order — `display_name`,
+ * `short_description`, then `default_prompt` (a block sequence) — with every
+ * scalar double-quoted and a single trailing newline. The function is pure:
+ * given the same input it returns byte-identical output (no timestamps, no
+ * randomness, no filesystem), which is what keeps `bun run build:plugins`
+ * reproducible and the Plugins Sync CI gate stable.
+ *
+ * @param {{ display_name: string, short_description: string, default_prompt: readonly string[] }} iface
+ *   The normalized interface object. `default_prompt` is always rendered as a
+ *   block sequence (an empty array becomes `default_prompt: []`).
+ * @returns {string} Deterministic YAML, terminated by exactly one newline.
+ */
+export function serializeInterfaceToYaml(iface) {
+  const prompts = iface.default_prompt ?? [];
+  const promptBlock =
+    prompts.length === 0
+      ? "default_prompt: []"
+      : ["default_prompt:", ...prompts.map(p => `  - ${yamlQuote(p)}`)].join(
+          "\n"
+        );
+  const lines = [
+    `display_name: ${yamlQuote(iface.display_name)}`,
+    `short_description: ${yamlQuote(iface.short_description)}`,
+    promptBlock,
+  ];
+  return `${lines.join("\n")}\n`;
+}
+
+function main() {
+  const [pluginDirArg, versionArg] = process.argv.slice(2);
+  if (!pluginDirArg || !versionArg) {
+    console.error(
+      "Usage: generate-codex-plugin-artifacts.mjs <plugin-dir> <version>"
+    );
+    process.exit(1);
+  }
+
+  const pluginDir = path.resolve(pluginDirArg);
+  const claudeManifestPath = path.join(
+    pluginDir,
+    ".claude-plugin",
+    "plugin.json"
+  );
+  if (!fs.existsSync(claudeManifestPath)) {
+    process.exit(0);
+  }
+
+  const claudeManifest = JSON.parse(
+    fs.readFileSync(claudeManifestPath, "utf8")
+  );
+  const pluginName = claudeManifest.name;
 
-writeCodexManifest(pluginName, versionArg);
+  writeCodexManifest(pluginDir, claudeManifest, pluginName, versionArg);
+}
 
-function writeCodexManifest(pluginName, version) {
-  const metadata = metadataFor(pluginName);
+function writeCodexManifest(pluginDir, claudeManifest, pluginName, version) {
+  const metadata = metadataFor(pluginName, claudeManifest);
   const manifest = {
     name: pluginName,
     version,
@@ -53,7 +161,7 @@ function writeCodexManifest(pluginName, version) {
     ...(claudeManifest.dependencies
       ? { dependencies: claudeManifest.dependencies }
       : {}),
-    ...componentPointers(),
+    ...componentPointers(pluginDir),
     interface: {
       displayName: metadata.displayName,
       shortDescription: metadata.shortDescription,
@@ -73,7 +181,7 @@ function writeCodexManifest(pluginName, version) {
   );
 }
 
-function componentPointers() {
+function componentPointers(pluginDir) {
   return {
     ...(fs.existsSync(path.join(pluginDir, "skills"))
       ? { skills: "./skills/" }
@@ -84,7 +192,7 @@ function componentPointers() {
   };
 }
 
-function metadataFor(pluginName) {
+function metadataFor(pluginName, claudeManifest) {
   const map = {
     lisa: {
       displayName: "Lisa",
@@ -236,3 +344,9 @@ function metadataFor(pluginName) {
     }
   );
 }
+
+// Run the generator only when invoked directly (e.g. via build-plugins.sh),
+// not when this module is imported (e.g. by unit tests for the parser).
+if (process.argv[1] && fileURLToPath(import.meta.url) === process.argv[1]) {
+  main();
+}