@codyswann/lisa 2.117.0 → 2.118.0

package/package.json

@@ -83,7 +83,7 @@
     "lodash": ">=4.18.1"
   },
   "name": "@codyswann/lisa",
-  "version": "2.117.0",
+  "version": "2.118.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.117.0",
+  "version": "2.118.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.117.0",
+  "version": "2.118.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.117.0",
+  "version": "2.118.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.117.0",
+  "version": "2.118.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.117.0",
+  "version": "2.118.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.117.0",
+  "version": "2.118.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.117.0",
+  "version": "2.118.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.117.0",
+  "version": "2.118.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.117.0",
+  "version": "2.118.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.117.0",
+  "version": "2.118.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.117.0",
+  "version": "2.118.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.117.0",
+  "version": "2.118.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.117.0",
+  "version": "2.118.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.117.0",
+  "version": "2.118.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.117.0",
+  "version": "2.118.0",
   "description": "TypeScript-specific hooks — Prettier formatting, ESLint linting, ast-grep scanning, and error-suppression blocking on edit",
   "author": {
     "name": "Cody Swann"

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

@@ -1,6 +1,6 @@
 {
   "name": "lisa-typescript",
-  "version": "2.117.0",
+  "version": "2.118.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.117.0",
+  "version": "2.118.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.117.0",
+  "version": "2.118.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/plugins/lisa-wiki/scripts/ensure-gitignore.mjs

@@ -0,0 +1,131 @@
+#!/usr/bin/env node
+/**
+ * ensure-gitignore.mjs — merge the lisa-wiki gitignore block into the project's
+ * `.gitignore`, idempotently. Dependency-free.
+ *
+ * The block is delimited by `# BEGIN: AI GUARDRAILS WIKI` and
+ * `# END: AI GUARDRAILS WIKI` markers (see templates/wrapper-gitignore.txt).
+ * Behavior matches the base lisa plugin's copy-contents strategy
+ * (src/strategies/copy-contents.ts):
+ *
+ *   - If the file is missing, create it with just the block.
+ *   - If the block markers exist, replace the block in place.
+ *   - If the markers don't exist, append the block to the end (preserving a
+ *     trailing newline).
+ *
+ * Patterns outside the marker block are NEVER touched. Re-running produces no
+ * spurious diff once the file is in sync.
+ *
+ * Usage: node ensure-gitignore.mjs [--cwd <project-dir>] [--dry-run]
+ *   default cwd: process.cwd()
+ *   --dry-run    prints the proposed merge result to stdout instead of writing
+ *
+ * Exit code 0 = ok (file was created, updated, or already in sync).
+ * Exit code 1 = error (e.g. template missing).
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+const BEGIN_MARKER = "# BEGIN: AI GUARDRAILS WIKI";
+const END_MARKER = "# END: AI GUARDRAILS WIKI";
+
+function fail(msg) {
+  console.error(`✗ ${msg}`);
+  process.exit(1);
+}
+
+const scriptDir = path.dirname(fileURLToPath(import.meta.url));
+const pluginRoot = path.dirname(scriptDir);
+const templatePath = path.join(
+  pluginRoot,
+  "templates",
+  "wrapper-gitignore.txt"
+);
+
+const argv = process.argv.slice(2);
+const cwdIndex = argv.indexOf("--cwd");
+const projectDir =
+  cwdIndex !== -1 && argv[cwdIndex + 1]
+    ? path.resolve(argv[cwdIndex + 1])
+    : process.cwd();
+const dryRun = argv.includes("--dry-run");
+
+if (!fs.existsSync(templatePath)) {
+  fail(`template not found: ${templatePath}`);
+}
+
+const templateRaw = fs.readFileSync(templatePath, "utf8");
+const block = extractBlock(templateRaw);
+if (!block) {
+  fail(
+    `template at ${templatePath} does not contain the expected marker pair (${BEGIN_MARKER} / ${END_MARKER})`
+  );
+}
+
+const gitignorePath = path.join(projectDir, ".gitignore");
+const existing = fs.existsSync(gitignorePath)
+  ? fs.readFileSync(gitignorePath, "utf8")
+  : null;
+
+const merged = mergeBlock(existing, block);
+
+if (existing !== null && merged === existing) {
+  console.log(`✓ .gitignore already in sync (${gitignorePath})`);
+  process.exit(0);
+}
+
+if (dryRun) {
+  process.stdout.write(merged);
+  process.exit(0);
+}
+
+fs.writeFileSync(gitignorePath, merged);
+const verb = existing === null ? "created" : "updated";
+console.log(`✓ ${verb} ${gitignorePath}`);
+process.exit(0);
+
+/**
+ * Pull the block (markers included) out of arbitrary text. Returns null when
+ * the marker pair is missing or out of order.
+ */
+function extractBlock(text) {
+  const startIdx = text.indexOf(BEGIN_MARKER);
+  if (startIdx === -1) return null;
+  const endStart = text.indexOf(END_MARKER, startIdx + BEGIN_MARKER.length);
+  if (endStart === -1) return null;
+  const endIdx = endStart + END_MARKER.length;
+  return text.slice(startIdx, endIdx);
+}
+
+/**
+ * Merge a freshly-rendered block into the destination file content.
+ *   - existing === null → return the block alone (file will be created)
+ *   - existing has the markers → replace the block in place
+ *   - existing lacks the markers → append the block at the end
+ * Always normalizes to exactly one trailing newline.
+ */
+function mergeBlock(existing, freshBlock) {
+  if (existing === null) {
+    return `${freshBlock.trimEnd()}\n`;
+  }
+
+  const startIdx = existing.indexOf(BEGIN_MARKER);
+  if (startIdx !== -1) {
+    const endStart = existing.indexOf(
+      END_MARKER,
+      startIdx + BEGIN_MARKER.length
+    );
+    if (endStart !== -1) {
+      const endIdx = endStart + END_MARKER.length;
+      const before = existing.slice(0, startIdx);
+      const after = existing.slice(endIdx);
+      const trimmedAfter = after.startsWith("\n") ? after : `\n${after}`;
+      return `${before}${freshBlock.trimEnd()}${trimmedAfter}`;
+    }
+  }
+
+  // No marker pair in the destination — append.
+  const base = existing.endsWith("\n") ? existing : `${existing}\n`;
+  return `${base}\n${freshBlock.trimEnd()}\n`;
+}

package/plugins/lisa-wiki/skills/lisa-wiki-setup/SKILL.md

@@ -30,13 +30,22 @@ never overwrites human-authored content.
 3. **Contract.** Render `wiki/schema/llm-wiki-contract.md` from the plugin templates + config via
    `scripts/render-contract.mjs`, stamping the `kernelVersion`. This snapshot keeps the wiki
    self-describing without the plugin installed.
-4. **Pointers.** Ensure `AGENTS.md` / `CLAUDE.md` point at the contract + plugin (thin pointers only).
-5. **Staff.** For each `config.staff[]` entry (the standard roster by default), generate the role's
+4. **Gitignore.** Merge the lisa-wiki gitignore block into the project's `.gitignore` via
+   `scripts/ensure-gitignore.mjs`. The block (delimited by `# BEGIN: AI GUARDRAILS WIKI` /
+   `# END: AI GUARDRAILS WIKI`) covers transient per-session worktrees and Lisa backup snapshots
+   (`.claude/worktrees/`, `.codex/worktrees/`, `.lisabak/`). Idempotent: re-running produces no
+   diff once the block is present. The block coexists with the base lisa plugin's
+   `# BEGIN: AI GUARDRAILS` block — both can be installed without overwriting each other because
+   the copy-contents strategy keys on the marker suffix. Wiki-wrapper repos (mode `wrapper` /
+   `standalone`) typically don't enable the base lisa plugin, so this step is the only path by
+   which they get the worktree-ignore patterns.
+5. **Pointers.** Ensure `AGENTS.md` / `CLAUDE.md` point at the contract + plugin (thin pointers only).
+6. **Staff.** For each `config.staff[]` entry (the standard roster by default), generate the role's
    `wiki/staff/<role>.md` page and its dual-runtime subagents by delegating to `lisa-wiki-add-role`
    (running the subagents is out of scope).
-6. **README.** Apply the chosen README mode (ingest the old README first; `rich` keeps install/usage +
+7. **README.** Apply the chosen README mode (ingest the old README first; `rich` keeps install/usage +
    adds the onboarding line; `stub` is the minimal pointer; `preserve` leaves it).
-7. **Verify.** Run `lisa-wiki-doctor` and report the verdict + any blocking items.
+8. **Verify.** Run `lisa-wiki-doctor` and report the verdict + any blocking items.
 
 ## Standard roster
 The default operating team seeded into `config.staff[]` for every new wiki (Chief of Staff plus six

package/plugins/lisa-wiki/templates/wrapper-gitignore.txt

@@ -0,0 +1,19 @@
+# BEGIN: AI GUARDRAILS WIKI
+# Managed by the lisa-wiki kernel. Do not edit between these markers — re-run
+# /lisa-wiki:setup (or the equivalent script) to update. Patterns outside the
+# block are preserved untouched. The "WIKI" suffix lets this block coexist
+# with the base lisa plugin's "# BEGIN: AI GUARDRAILS" block when both are
+# installed (the copy-contents strategy keys on the marker suffix).
+
+# Claude Code per-session git worktrees. Each Claude session that needs an
+# isolated working copy spawns one under .claude/worktrees/ (via
+# `git worktree add`). They are transient, large (often hundreds of MB each),
+# and per-developer; they must never be committed.
+/.claude/worktrees/
+
+# Codex CLI per-session worktrees (Codex equivalent of the above).
+/.codex/worktrees/
+
+# Lisa backup snapshots (created by `lisa` runs).
+/.lisabak/
+# END: AI GUARDRAILS WIKI

package/plugins/src/wiki/scripts/ensure-gitignore.mjs

@@ -0,0 +1,131 @@
+#!/usr/bin/env node
+/**
+ * ensure-gitignore.mjs — merge the lisa-wiki gitignore block into the project's
+ * `.gitignore`, idempotently. Dependency-free.
+ *
+ * The block is delimited by `# BEGIN: AI GUARDRAILS WIKI` and
+ * `# END: AI GUARDRAILS WIKI` markers (see templates/wrapper-gitignore.txt).
+ * Behavior matches the base lisa plugin's copy-contents strategy
+ * (src/strategies/copy-contents.ts):
+ *
+ *   - If the file is missing, create it with just the block.
+ *   - If the block markers exist, replace the block in place.
+ *   - If the markers don't exist, append the block to the end (preserving a
+ *     trailing newline).
+ *
+ * Patterns outside the marker block are NEVER touched. Re-running produces no
+ * spurious diff once the file is in sync.
+ *
+ * Usage: node ensure-gitignore.mjs [--cwd <project-dir>] [--dry-run]
+ *   default cwd: process.cwd()
+ *   --dry-run    prints the proposed merge result to stdout instead of writing
+ *
+ * Exit code 0 = ok (file was created, updated, or already in sync).
+ * Exit code 1 = error (e.g. template missing).
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+const BEGIN_MARKER = "# BEGIN: AI GUARDRAILS WIKI";
+const END_MARKER = "# END: AI GUARDRAILS WIKI";
+
+function fail(msg) {
+  console.error(`✗ ${msg}`);
+  process.exit(1);
+}
+
+const scriptDir = path.dirname(fileURLToPath(import.meta.url));
+const pluginRoot = path.dirname(scriptDir);
+const templatePath = path.join(
+  pluginRoot,
+  "templates",
+  "wrapper-gitignore.txt"
+);
+
+const argv = process.argv.slice(2);
+const cwdIndex = argv.indexOf("--cwd");
+const projectDir =
+  cwdIndex !== -1 && argv[cwdIndex + 1]
+    ? path.resolve(argv[cwdIndex + 1])
+    : process.cwd();
+const dryRun = argv.includes("--dry-run");
+
+if (!fs.existsSync(templatePath)) {
+  fail(`template not found: ${templatePath}`);
+}
+
+const templateRaw = fs.readFileSync(templatePath, "utf8");
+const block = extractBlock(templateRaw);
+if (!block) {
+  fail(
+    `template at ${templatePath} does not contain the expected marker pair (${BEGIN_MARKER} / ${END_MARKER})`
+  );
+}
+
+const gitignorePath = path.join(projectDir, ".gitignore");
+const existing = fs.existsSync(gitignorePath)
+  ? fs.readFileSync(gitignorePath, "utf8")
+  : null;
+
+const merged = mergeBlock(existing, block);
+
+if (existing !== null && merged === existing) {
+  console.log(`✓ .gitignore already in sync (${gitignorePath})`);
+  process.exit(0);
+}
+
+if (dryRun) {
+  process.stdout.write(merged);
+  process.exit(0);
+}
+
+fs.writeFileSync(gitignorePath, merged);
+const verb = existing === null ? "created" : "updated";
+console.log(`✓ ${verb} ${gitignorePath}`);
+process.exit(0);
+
+/**
+ * Pull the block (markers included) out of arbitrary text. Returns null when
+ * the marker pair is missing or out of order.
+ */
+function extractBlock(text) {
+  const startIdx = text.indexOf(BEGIN_MARKER);
+  if (startIdx === -1) return null;
+  const endStart = text.indexOf(END_MARKER, startIdx + BEGIN_MARKER.length);
+  if (endStart === -1) return null;
+  const endIdx = endStart + END_MARKER.length;
+  return text.slice(startIdx, endIdx);
+}
+
+/**
+ * Merge a freshly-rendered block into the destination file content.
+ *   - existing === null → return the block alone (file will be created)
+ *   - existing has the markers → replace the block in place
+ *   - existing lacks the markers → append the block at the end
+ * Always normalizes to exactly one trailing newline.
+ */
+function mergeBlock(existing, freshBlock) {
+  if (existing === null) {
+    return `${freshBlock.trimEnd()}\n`;
+  }
+
+  const startIdx = existing.indexOf(BEGIN_MARKER);
+  if (startIdx !== -1) {
+    const endStart = existing.indexOf(
+      END_MARKER,
+      startIdx + BEGIN_MARKER.length
+    );
+    if (endStart !== -1) {
+      const endIdx = endStart + END_MARKER.length;
+      const before = existing.slice(0, startIdx);
+      const after = existing.slice(endIdx);
+      const trimmedAfter = after.startsWith("\n") ? after : `\n${after}`;
+      return `${before}${freshBlock.trimEnd()}${trimmedAfter}`;
+    }
+  }
+
+  // No marker pair in the destination — append.
+  const base = existing.endsWith("\n") ? existing : `${existing}\n`;
+  return `${base}\n${freshBlock.trimEnd()}\n`;
+}

package/plugins/src/wiki/skills/lisa-wiki-setup/SKILL.md

@@ -30,13 +30,22 @@ never overwrites human-authored content.
 3. **Contract.** Render `wiki/schema/llm-wiki-contract.md` from the plugin templates + config via
    `scripts/render-contract.mjs`, stamping the `kernelVersion`. This snapshot keeps the wiki
    self-describing without the plugin installed.
-4. **Pointers.** Ensure `AGENTS.md` / `CLAUDE.md` point at the contract + plugin (thin pointers only).
-5. **Staff.** For each `config.staff[]` entry (the standard roster by default), generate the role's
+4. **Gitignore.** Merge the lisa-wiki gitignore block into the project's `.gitignore` via
+   `scripts/ensure-gitignore.mjs`. The block (delimited by `# BEGIN: AI GUARDRAILS WIKI` /
+   `# END: AI GUARDRAILS WIKI`) covers transient per-session worktrees and Lisa backup snapshots
+   (`.claude/worktrees/`, `.codex/worktrees/`, `.lisabak/`). Idempotent: re-running produces no
+   diff once the block is present. The block coexists with the base lisa plugin's
+   `# BEGIN: AI GUARDRAILS` block — both can be installed without overwriting each other because
+   the copy-contents strategy keys on the marker suffix. Wiki-wrapper repos (mode `wrapper` /
+   `standalone`) typically don't enable the base lisa plugin, so this step is the only path by
+   which they get the worktree-ignore patterns.
+5. **Pointers.** Ensure `AGENTS.md` / `CLAUDE.md` point at the contract + plugin (thin pointers only).
+6. **Staff.** For each `config.staff[]` entry (the standard roster by default), generate the role's
    `wiki/staff/<role>.md` page and its dual-runtime subagents by delegating to `lisa-wiki-add-role`
    (running the subagents is out of scope).
-6. **README.** Apply the chosen README mode (ingest the old README first; `rich` keeps install/usage +
+7. **README.** Apply the chosen README mode (ingest the old README first; `rich` keeps install/usage +
    adds the onboarding line; `stub` is the minimal pointer; `preserve` leaves it).
-7. **Verify.** Run `lisa-wiki-doctor` and report the verdict + any blocking items.
+8. **Verify.** Run `lisa-wiki-doctor` and report the verdict + any blocking items.
 
 ## Standard roster
 The default operating team seeded into `config.staff[]` for every new wiki (Chief of Staff plus six

package/plugins/src/wiki/templates/wrapper-gitignore.txt

@@ -0,0 +1,19 @@
+# BEGIN: AI GUARDRAILS WIKI
+# Managed by the lisa-wiki kernel. Do not edit between these markers — re-run
+# /lisa-wiki:setup (or the equivalent script) to update. Patterns outside the
+# block are preserved untouched. The "WIKI" suffix lets this block coexist
+# with the base lisa plugin's "# BEGIN: AI GUARDRAILS" block when both are
+# installed (the copy-contents strategy keys on the marker suffix).
+
+# Claude Code per-session git worktrees. Each Claude session that needs an
+# isolated working copy spawns one under .claude/worktrees/ (via
+# `git worktree add`). They are transient, large (often hundreds of MB each),
+# and per-developer; they must never be committed.
+/.claude/worktrees/
+
+# Codex CLI per-session worktrees (Codex equivalent of the above).
+/.codex/worktrees/
+
+# Lisa backup snapshots (created by `lisa` runs).
+/.lisabak/
+# END: AI GUARDRAILS WIKI