@codyswann/lisa 1.15.0 → 1.16.0

package/all/copy-overwrite/.claude/hooks/enforce-plan-rules.sh

@@ -0,0 +1,15 @@
+#!/bin/bash
+# Reinjects plan-mode rules on every prompt when Claude is in plan mode.
+# Wired as a UserPromptSubmit hook in .claude/settings.json.
+
+INPUT=$(cat)
+PERMISSION_MODE=$(echo "$INPUT" | jq -r '.permission_mode // "default"')
+
+if [ "$PERMISSION_MODE" = "plan" ]; then
+  PLAN_RULES="$CLAUDE_PROJECT_DIR/.claude/rules/plan.md"
+  if [ -f "$PLAN_RULES" ]; then
+    echo "PLAN MODE RULES (reinforced):"
+    cat "$PLAN_RULES"
+  fi
+fi
+exit 0

package/all/copy-overwrite/.claude/hooks/track-plan-sessions.sh

@@ -0,0 +1,155 @@
+#!/usr/bin/env bash
+#
+# track-plan-sessions.sh - Tracks which sessions work on each plan file
+#
+# Triggered by two hooks:
+#   1. PostToolUse (Write|Edit) - Detects plan file writes via absolute path comparison,
+#      stamps session ID into the plan's ## Sessions table, and saves a session-specific
+#      marker file so subsequent UserPromptSubmit events can reliably find the active plan.
+#   2. UserPromptSubmit - Finds the active plan file by checking for a session-specific
+#      marker file first (set by PostToolUse), falling back to the most recently CREATED
+#      .md file in plans/ (ls -tU on macOS sorts by birth time). This avoids the mtime bug
+#      where another plan file's modification time (e.g., from a hook writing a session ID
+#      to it, or format-on-edit touching it) could cause the wrong file to appear "newest."
+#
+# Marker files: $PLANS_DIR/.active-plan-<session-id> contain the absolute path to the
+# active plan file. Stale markers (>24h) are cleaned up on each invocation.
+#
+# Debug logging: All key decisions are logged to $PLANS_DIR/.track-plan-debug.log for
+# diagnostics if session IDs land in the wrong plan file.
+#
+# Input (via stdin): JSON with session_id, permission_mode, hook_event_name, etc.
+#
+
+set -euo pipefail
+
+INPUT=$(cat)
+
+SESSION_ID=$(echo "$INPUT" | jq -r '.session_id // empty')
+PERMISSION_MODE=$(echo "$INPUT" | jq -r '.permission_mode // "default"')
+HOOK_EVENT=$(echo "$INPUT" | jq -r '.hook_event_name // empty')
+
+# Session ID is required
+if [[ -z "$SESSION_ID" ]]; then
+  exit 0
+fi
+
+# Resolve plans directory from settings (default ./plans)
+PLANS_DIR="./plans"
+SETTINGS_FILE="${CLAUDE_PROJECT_DIR:-.}/.claude/settings.json"
+if [[ -f "$SETTINGS_FILE" ]]; then
+  CONFIGURED_DIR=$(jq -r '.plansDirectory // empty' "$SETTINGS_FILE")
+  if [[ -n "$CONFIGURED_DIR" ]]; then
+    PLANS_DIR="$CONFIGURED_DIR"
+  fi
+fi
+
+# Debug logging
+DEBUG_LOG="$PLANS_DIR/.track-plan-debug.log"
+
+log_debug() {
+  printf '[%s] [%s] [%s] %s\n' \
+    "$(date -u +"%Y-%m-%dT%H:%M:%SZ")" \
+    "$SESSION_ID" \
+    "$HOOK_EVENT" \
+    "$1" >> "$DEBUG_LOG" 2>/dev/null || true
+}
+
+# Session-specific marker file for reliable active-plan detection
+MARKER_FILE="$PLANS_DIR/.active-plan-${SESSION_ID}"
+
+# Clean stale marker files older than 24h
+find "$PLANS_DIR" -name ".active-plan-*" -mmin +1440 -delete 2>/dev/null || true
+
+PLAN_FILE=""
+RESOLUTION_METHOD=""
+
+if [[ "$HOOK_EVENT" == "PostToolUse" ]]; then
+  # Trigger A: Plan file was written/edited
+  FILE_PATH=$(echo "$INPUT" | jq -r '.tool_input.file_path // empty')
+
+  if [[ -z "$FILE_PATH" ]]; then
+    log_debug "PostToolUse: no file_path in tool_input, exiting"
+    exit 0
+  fi
+
+  # Resolve PLANS_DIR to absolute path for comparison
+  ABS_PLANS_DIR=$(cd "$PLANS_DIR" 2>/dev/null && pwd)
+
+  if [[ -z "$ABS_PLANS_DIR" ]]; then
+    log_debug "PostToolUse: could not resolve PLANS_DIR=$PLANS_DIR to absolute path, exiting"
+    exit 0
+  fi
+
+  # Check if the written file is in the plans directory
+  if [[ "$FILE_PATH" == "$ABS_PLANS_DIR"/* ]]; then
+    PLAN_FILE="$FILE_PATH"
+    RESOLUTION_METHOD="PostToolUse-direct"
+    log_debug "PostToolUse: matched plan file=$PLAN_FILE"
+
+    # Save marker so UserPromptSubmit can find this plan reliably
+    echo "$PLAN_FILE" > "$MARKER_FILE"
+    log_debug "PostToolUse: saved marker file=$MARKER_FILE"
+  else
+    log_debug "PostToolUse: file_path=$FILE_PATH not in plans dir=$ABS_PLANS_DIR, exiting"
+    exit 0
+  fi
+
+elif [[ "$HOOK_EVENT" == "UserPromptSubmit" ]]; then
+  # Trigger B: Find the active plan file
+  # Priority 1: Session-specific marker file (reliable — set by PostToolUse when plan was written)
+  if [[ -f "$MARKER_FILE" ]]; then
+    PLAN_FILE=$(cat "$MARKER_FILE")
+    RESOLUTION_METHOD="marker-file"
+    log_debug "UserPromptSubmit: resolved via marker file=$PLAN_FILE"
+  else
+    # Priority 2: Most recently CREATED file (ls -tU on macOS sorts by birth time)
+    PLAN_FILE=$(ls -tU "$PLANS_DIR"/*.md 2>/dev/null | head -1)
+    RESOLUTION_METHOD="fallback-ls-tU"
+    log_debug "UserPromptSubmit: no marker file, fallback ls -tU resolved=$PLAN_FILE"
+  fi
+
+  if [[ -z "$PLAN_FILE" || ! -f "$PLAN_FILE" ]]; then
+    log_debug "UserPromptSubmit: no valid plan file found, exiting"
+    exit 0
+  fi
+else
+  exit 0
+fi
+
+# Verify the plan file exists
+if [[ ! -f "$PLAN_FILE" ]]; then
+  log_debug "plan file=$PLAN_FILE does not exist, exiting"
+  exit 0
+fi
+
+# Check if session ID already exists in the file (dedup)
+if grep -qF "$SESSION_ID" "$PLAN_FILE" 2>/dev/null; then
+  log_debug "dedup: session ID already in $PLAN_FILE (resolved via $RESOLUTION_METHOD), skipping write"
+  exit 0
+fi
+
+# Determine phase from permission_mode
+PHASE=$( [[ "$PERMISSION_MODE" == "plan" ]] && echo "plan" || echo "implement" )
+TIMESTAMP=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+
+# Check if ## Sessions section exists
+if grep -q "^## Sessions" "$PLAN_FILE" 2>/dev/null; then
+  # Append row to existing table
+  printf '| %s | %s | %s |\n' "$SESSION_ID" "$TIMESTAMP" "$PHASE" >> "$PLAN_FILE"
+else
+  # Create ## Sessions section at end of file
+  {
+    echo ""
+    echo "## Sessions"
+    echo ""
+    echo "<!-- Auto-maintained by track-plan-sessions.sh -->"
+    echo "| Session ID | First Seen | Phase |"
+    echo "|------------|------------|-------|"
+    printf '| %s | %s | %s |\n' "$SESSION_ID" "$TIMESTAMP" "$PHASE"
+  } >> "$PLAN_FILE"
+fi
+
+log_debug "wrote session to $PLAN_FILE (resolved via $RESOLUTION_METHOD, phase=$PHASE)"
+
+exit 0

package/all/copy-overwrite/.claude/rules/plan.md

@@ -0,0 +1,29 @@
+# Plan Mode Rules
+
+These rules are enforced whenever Claude is in plan mode. They are loaded at session start via `.claude/rules/` and reinforced on every prompt via the `enforce-plan-rules.sh` `UserPromptSubmit` hook.
+
+## Required Behaviors
+
+When making a plan:
+
+- Always determine which skills should be used during execution of the plan and include them in the plan
+- Always make sure you understand the correct versions of third party libraries
+- Always save the plan with a name befitting the actual plan contents
+- Always look for code that can be reused for implementation
+- The plan MUST including written instructions to create a task list using TaskCreate for each task. The list should contain items related to the plan and specify that subagents should handle as many in parallel as possible. The following should always be included in the task list
+  - update/add/remove tests, containing the tests that need to get updated, added or removed
+  - update/add/remove documentation (jsdocs, markdown files, etc), containing the documentation that need to get updated, added or removed
+  - archive the plan (to be completed after all other tasks have been completed). This task should explcitly say to:
+    - create a folder named <plan-name> in ./plans/completed
+    - rename this plan to a name befitting the actual plan contents
+    - move it into ./plans/completed/<plan-name>
+    - read the session ids from ./plans/completed/<plan-name>
+    - For each session id, move the ~/.claude/tasks/<session-id> directory to ./plans/completed/<plan-name>/tasks
+- If you're on a protected branch (dev, staging, main), create a new branch named based on the nature of the project and include in the plan pull requests should go to the protected branch you bracnehd from. 
+- If you're on a non-protected branch with an open pull request, submit pushes to the open pull request
+- If you're on a non-protected branch with no existing PR, clarify which protected branch to open the pull request to. 
+- If referencing a ticket (jira, linear, etc), always include the ticket url in your plan
+- If referencing a ticket (jira, linear, etc), always update the ticket with the branch you're working off of
+- If referencing a ticket (jira, linear, etc), always add a comment to the ticket with the finalized plan
+- The `## Sessions` section in plan files is auto-maintained by the `track-plan-sessions.sh` hook — do not manually edit it
+

package/all/copy-overwrite/.claude/settings.json

@@ -10,9 +10,39 @@
             "timeout": 1
           }
         ]
+      },
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "$CLAUDE_PROJECT_DIR/.claude/hooks/enforce-plan-rules.sh",
+            "timeout": 5
+          }
+        ]
+      },
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "$CLAUDE_PROJECT_DIR/.claude/hooks/track-plan-sessions.sh",
+            "timeout": 5
+          }
+        ]
       }
     ],
     "PostToolUse": [
+      {
+        "matcher": "Write|Edit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "$CLAUDE_PROJECT_DIR/.claude/hooks/track-plan-sessions.sh",
+            "timeout": 5
+          }
+        ]
+      },
       {
         "matcher": "TaskCreate|TaskUpdate",
         "hooks": [

package/all/copy-overwrite/CLAUDE.md

@@ -16,7 +16,7 @@ Always use project-relative paths rather than absolute paths in documentation an
 Always ignore build folders (dist, build, etc) unless specified otherwise
 Always delete and remove old code completely - no deprecation needed
 Always add `GIT_SSH_COMMAND="ssh -o ServerAliveInterval=30 -o ServerAliveCountMax=5" ` when running `git push`
-
+Always err on the side of creating a plan before directly executing a coding task 
 
 Never modify this file (CLAUDE.md) directly. To add a memory or learning, add it to .claude/rules/PROJECT_RULES.md or create a skill with /skill-creator.
 Never commit changes to an environment branch (dev, staging, main) directly. This is enforced by the pre-commit hook.
@@ -52,12 +52,5 @@ ONLY use ts-ignore as a last resort and confirm with human before doing so
 ONLY use ts-expect-error as a last resort and confirm with human before doing so
 ONLY use ts-nocheck as a last resort and confirm with human before doing so
 
+Never update CHANGELOG
 
-When making a plan, always determine which skills should be used during execution of the plan and include them in the plan
-When making a plan, always make sure you understand the correct versions of third party libraries
-When making a plan, always create a task list of items related to the plan and specify that subagents should handle as many in parallel as possible
-When making a plan, always save the plan with a name befitting the actual plan contents.
-When making a plan, always look for code that can be reused for implementation
-When making a plan, always include a task to update/add/remove documentation
-
-Never update CHANGELOG

package/expo/copy-overwrite/jest.expo.ts

@@ -13,8 +13,14 @@
  * `window` property, causing "Cannot redefine property: window" errors.
  *
  * Instead, this config manually replicates the preset's resolution,
- * transform, and haste settings while using only `jest-expo/src/preset/setup.js`
- * (the safe subset) in `setupFiles`.
+ * transform, and haste settings without any preset setupFiles.
+ *
+ * `setupFiles` is intentionally empty because `jest-expo/src/preset/setup.js`
+ * requires `__DEV__` to be defined before it runs, and `mergeConfigs`
+ * concatenates arrays with base entries first — making it impossible for
+ * project-local setupFiles to prepend a `__DEV__` definition. Projects
+ * should add their own setupFiles in `jest.config.local.ts` with the
+ * correct ordering (define globals first, then load jest-expo setup).
  *
  * Coverage collection is scoped to standard Expo source directories
  * rather than a catch-all glob, preventing config files, scripts, and
@@ -60,8 +66,10 @@ interface ExpoJestOptions {
  * @param options.thresholds - Coverage thresholds (merged defaults + project overrides)
  * @returns Jest config object with jsdom environment, babel-jest transform, and React Native resolver
  * @remarks Avoids `jest-expo` preset to prevent jsdom + `react-native/jest/setup.js`
- * incompatibility. Manually configures haste, resolver, transform, and setupFiles
- * to match the preset's behavior without the problematic window redefinition.
+ * incompatibility. Manually configures haste, resolver, and transform to match the
+ * preset's behavior without the problematic window redefinition. `setupFiles` is
+ * empty — projects must provide their own in `jest.config.local.ts` with correct
+ * ordering (define `__DEV__` before loading `jest-expo/src/preset/setup.js`).
  */
 export const getExpoJestConfig = ({
   thresholds = defaultThresholds,
@@ -72,7 +80,7 @@ export const getExpoJestConfig = ({
     platforms: ["android", "ios", "native"],
   },
   resolver: "react-native/jest/resolver.js",
-  setupFiles: ["jest-expo/src/preset/setup.js"],
+  setupFiles: [],
   transform: {
     "\\.[jt]sx?$": [
       "babel-jest",
@@ -87,15 +95,10 @@ export const getExpoJestConfig = ({
     "^.+\\.(bmp|gif|jpg|jpeg|mp4|png|psd|svg|webp|ttf|otf|woff|woff2)$":
       "jest-expo/src/preset/assetFileTransformer.js",
   },
-  testMatch: [
-    "<rootDir>/**/*.test.ts",
-    "<rootDir>/**/*.test.tsx",
-    "<rootDir>/**/__tests__/**/*.ts",
-    "<rootDir>/**/__tests__/**/*.tsx",
-  ],
+  testMatch: ["<rootDir>/**/*.test.ts", "<rootDir>/**/*.test.tsx"],
   testPathIgnorePatterns: ["/node_modules/", "/dist/", "/.expo/"],
   transformIgnorePatterns: [
-    "node_modules/(?!((jest-)?react-native|@react-native(-community)?)|expo(nent)?|@expo(nent)?/.*|@expo-google-fonts/.*|react-navigation|@react-navigation/.*|@sentry/react-native|native-base|react-native-svg|@gluestack-ui/.*|@gluestack-style/.*|nativewind|react-native-css-interop)",
+    "node_modules/(?!((jest-)?react-native|@react-native(-community)?)|expo(nent)?|@expo(nent)?/.*|@expo-google-fonts/.*|react-navigation|@react-navigation/.*|@sentry/react-native|native-base|react-native-svg|@gluestack-ui/.*|@gluestack-style/.*|nativewind|react-native-css-interop|react-native-reanimated|react-native-worklets|lucide-react-native|@gorhom|@shopify)",
   ],
   moduleFileExtensions: ["ts", "tsx", "js", "jsx", "json", "node"],
   collectCoverageFrom: [

package/expo/copy-overwrite/knip.json

@@ -53,7 +53,7 @@
     "**/metro.config.js",
     "**/babel.config.js"
   ],
-  "ignoreBinaries": ["audit", "ast-grep", "maestro", "eas", "source-map-explorer"],
+  "ignoreBinaries": ["ast-grep", "audit", "eas", "maestro", "serve", "source-map-explorer"],
   "ignoreDependencies": [
     "@dnd-kit/modifiers",
     "@expo-google-fonts/inter",

package/expo/copy-overwrite/tsconfig.expo.json

@@ -4,7 +4,11 @@
     "strict": true,
     "jsx": "react-native",
     "baseUrl": "./",
+    "noEmit": true,
+    "declaration": false,
+    "allowImportingTsExtensions": true,
     "paths": {
+      "@/graphql/*": ["./generated/*"],
       "@/*": ["./*"]
     },
     "moduleSuffixes": [".ios", ".android", ".native", ".web", ""]

package/expo/copy-overwrite/tsconfig.json

@@ -1,5 +1,5 @@
 {
   "extends": ["./tsconfig.expo.json", "./tsconfig.local.json"],
-  "include": ["**/*.ts", "**/*.tsx"],
+  "include": ["**/*.ts", "**/*.tsx", "nativewind-env.d.ts"],
   "exclude": ["node_modules", "dist", "web-build"]
 }

package/expo/create-only/babel.config.js

@@ -0,0 +1,27 @@
+/**
+ * Babel Configuration
+ *
+ * Configures Babel for Expo with NativeWind JSX transform support.
+ * This file is create-only — Lisa will create it but never overwrite
+ * your customizations.
+ *
+ * @remarks Required by the `jest.expo.ts` babel-jest transform which
+ * uses a metro caller config. Without this file, babel-jest cannot
+ * resolve the correct presets for React Native compilation.
+ * @see https://docs.expo.dev/versions/latest/config/babel/
+ * @module babel.config
+ */
+module.exports = function (api) {
+  api.cache(true);
+  return {
+    presets: [
+      [
+        "babel-preset-expo",
+        {
+          jsxImportSource: "nativewind",
+        },
+      ],
+      "nativewind/babel",
+    ],
+  };
+};

package/expo/create-only/jest.config.local.ts

@@ -0,0 +1,34 @@
+/**
+ * Jest Configuration - Project-Local Customizations
+ *
+ * Add project-specific Jest settings here. This file is create-only,
+ * meaning Lisa will create it but never overwrite your customizations.
+ *
+ * The Expo stack's `jest.expo.ts` provides haste, resolver, transform,
+ * and base coverage settings. This file should only contain settings
+ * that are project-specific or need to override the base config.
+ *
+ * @remarks `setupFiles` must define `__DEV__` and other React Native
+ * globals before any RN modules load — `jest.setup.pre.js` handles this.
+ * @see https://jestjs.io/docs/configuration
+ * @module jest.config.local
+ */
+import type { Config } from "jest";
+
+const config: Config = {
+  setupFiles: ["<rootDir>/jest.setup.pre.js"],
+  setupFilesAfterEnv: ["<rootDir>/jest.setup.ts"],
+
+  // Path aliases matching tsconfig.expo.json paths
+  moduleNameMapper: {
+    "^@/(.*)$": "<rootDir>/$1",
+  },
+
+  coveragePathIgnorePatterns: [
+    "/node_modules/",
+    "/generated/",
+    "\\.mock\\.(ts|tsx|js|jsx)$",
+  ],
+};
+
+export default config;

package/expo/create-only/jest.config.react-native-mock.js

@@ -0,0 +1,88 @@
+/**
+ * React Native TurboModule Mock Configuration
+ *
+ * Provides mock implementations for React Native's TurboModule native
+ * modules used in the test environment. These mocks are loaded by
+ * `jest.setup.pre.js` via `__turboModuleProxy`.
+ *
+ * @remarks Projects should add additional module mocks as needed.
+ * Only the baseline modules required by React Native core are included
+ * here — project-specific native modules (e.g., camera, maps) should
+ * be added to the project's copy of this file.
+ * @see https://reactnative.dev/docs/the-new-architecture/pillars-turbomodules
+ * @module jest.config.react-native-mock
+ */
+
+// Dynamically read React Native version from package.json
+const fs = require("fs");
+const path = require("path");
+
+/**
+ * Parses React Native version from package.json for PlatformConstants mock
+ * @returns The React Native version object with major, minor, and patch numbers
+ * @remarks Falls back to 0.81.4 if parsing fails — update the fallback
+ * when upgrading React Native
+ */
+const getReactNativeVersion = () => {
+  try {
+    const packageJson = JSON.parse(
+      fs.readFileSync(path.join(__dirname, "package.json"), "utf8")
+    );
+    const version = packageJson.dependencies["react-native"];
+    // Handle version formats: "0.81.4", "^0.81.4", "~0.81.4"
+    const versionMatch = version.match(/(\d+)\.(\d+)\.(\d+)/);
+    if (versionMatch) {
+      return {
+        major: parseInt(versionMatch[1], 10),
+        minor: parseInt(versionMatch[2], 10),
+        patch: parseInt(versionMatch[3], 10),
+      };
+    }
+  } catch (error) {
+    // Fallback to a default version if parsing fails
+    console.warn(
+      "Failed to parse React Native version from package.json:",
+      error
+    );
+  }
+  // Fallback version
+  return { major: 0, minor: 81, patch: 4 };
+};
+
+module.exports = {
+  PlatformConstants: {
+    getConstants: () => ({
+      reactNativeVersion: getReactNativeVersion(),
+      forceTouchAvailable: false,
+      osVersion: "14.4",
+      systemName: "iOS",
+      interfaceIdiom: "phone",
+    }),
+  },
+  AppState: {
+    getConstants: () => ({ initialAppState: "active" }),
+    getCurrentAppState: () => Promise.resolve({ app_state: "active" }),
+    addListener: () => {},
+    addEventListener: () => {},
+    removeListeners: () => {},
+    removeEventListener: () => {},
+    currentState: "active",
+  },
+  Appearance: {
+    getConstants: () => ({ initialColorScheme: "light" }),
+    getColorScheme: () => "light",
+    setColorScheme: () => {},
+    addChangeListener: () => ({ remove: () => {} }),
+    removeChangeListener: () => {},
+    addListener: () => ({ remove: () => {} }),
+    removeListeners: () => {},
+  },
+  DeviceInfo: {
+    getConstants: () => ({
+      Dimensions: {
+        window: { width: 375, height: 667, scale: 2, fontScale: 1 },
+        screen: { width: 375, height: 667, scale: 2, fontScale: 1 },
+      },
+    }),
+  },
+};

package/expo/create-only/jest.setup.pre.js

@@ -0,0 +1,106 @@
+/**
+ * Jest Pre-Setup File
+ *
+ * Runs before Jest loads any other modules to set up global flags needed
+ * by React Native. This file must be JavaScript (not TypeScript) and must
+ * not import any modules that depend on the global flags being set.
+ *
+ * @remarks
+ * - Listed in `setupFiles` (runs before test framework loads)
+ * - Sets `__DEV__`, `IS_REACT_ACT_ENVIRONMENT`, and other RN globals
+ * - Stubs `__turboModuleProxy` so native module requires don't throw
+ * - React 19 throws null on cleanup — the unhandledRejection handler
+ *   suppresses those while still surfacing real errors
+ * @see https://github.com/expo/expo/issues/38046 React 19 cleanup issue
+ * @see https://github.com/expo/expo/issues/40184 Jest 30 + expo-router
+ * @module jest.setup.pre
+ */
+
+// Polyfill structuredClone for jsdom environment
+// structuredClone is available in Node.js 17+ but jsdom doesn't expose it
+if (typeof global.structuredClone === "undefined") {
+  global.structuredClone = val => JSON.parse(JSON.stringify(val));
+}
+
+// Handle unhandled promise rejections BEFORE any other code runs
+// This must be set up first to catch React 19 "thrown: null" issues
+// Store the handler so it can be removed after tests complete (in jest.setup.ts)
+global.__unhandledRejectionHandler = (reason, _promise) => {
+  // Silently ignore null rejections from React 19 cleanup
+  if (reason === null) {
+    return;
+  }
+  // Re-throw other unhandled rejections so tests still fail for real issues
+  throw reason;
+};
+process.on("unhandledRejection", global.__unhandledRejectionHandler);
+
+// Disable RTLRN's auto cleanup to avoid "thrown: null" errors from React 19
+// We handle cleanup manually in jest.setup.ts
+process.env.RNTL_SKIP_AUTO_CLEANUP = "true";
+
+// Set React Native test environment flags BEFORE any modules are loaded
+global.__DEV__ = true;
+global.IS_REACT_ACT_ENVIRONMENT = true;
+global.IS_REACT_NATIVE_TEST_ENVIRONMENT = true;
+
+// Mock React Native bridge for testing
+global.__fbBatchedBridgeConfig = {
+  remoteModuleConfig: [],
+  localModulesConfig: [],
+};
+
+// Mock TurboModuleRegistry using external mock configuration
+const mockModules = require("./jest.config.react-native-mock");
+
+global.__turboModuleProxy = function (moduleName) {
+  return mockModules[moduleName] || null;
+};
+
+// Ensure global timers are available (required by @testing-library/react-native)
+// Jest's environment should have these, but we ensure they're set
+if (typeof global.setTimeout === "undefined") {
+  global.setTimeout = globalThis.setTimeout;
+}
+if (typeof global.clearTimeout === "undefined") {
+  global.clearTimeout = globalThis.clearTimeout;
+}
+if (typeof global.setInterval === "undefined") {
+  global.setInterval = globalThis.setInterval;
+}
+if (typeof global.clearInterval === "undefined") {
+  global.clearInterval = globalThis.clearInterval;
+}
+
+// Mock window object for web-specific code in platform-agnostic tests
+// This allows tests that check Platform.OS === 'web' branches to work
+// Important: Include timer functions because RTLRN checks typeof window !== 'undefined'
+global.window = {
+  // Timer functions (required by RTLRN)
+  setTimeout: global.setTimeout,
+  clearTimeout: global.clearTimeout,
+  setInterval: global.setInterval,
+  clearInterval: global.clearInterval,
+  setImmediate: global.setImmediate,
+  // Web-specific mocks
+  confirm: jest.fn(() => true),
+  alert: jest.fn(),
+  open: jest.fn(),
+  location: {
+    href: "",
+    origin: "http://localhost",
+    pathname: "/",
+    search: "",
+    hash: "",
+  },
+  addEventListener: jest.fn(),
+  removeEventListener: jest.fn(),
+  navigator: {
+    userAgent: "jest-test",
+  },
+  matchMedia: jest.fn(() => ({
+    matches: false,
+    addListener: jest.fn(),
+    removeListener: jest.fn(),
+  })),
+};

package/expo/create-only/jest.setup.ts

@@ -0,0 +1,118 @@
+/**
+ * Jest Setup File
+ *
+ * Configures the testing environment after Jest loads modules.
+ * Sets up React Native Testing Library matchers, global mocks,
+ * and manual cleanup for React 19 compatibility.
+ *
+ * @remarks
+ * - Listed in `setupFilesAfterEnv` (runs after test framework loads)
+ * - Basic globals like `__DEV__` are set earlier in `jest.setup.pre.js`
+ * - Manual cleanup replaces RTLRN auto-cleanup to handle React 19's
+ *   null-throw behavior during component teardown
+ * @see https://github.com/expo/expo/issues/38046 React 19 cleanup issue
+ * @see https://github.com/expo/expo/issues/40184 Jest 30 + expo-router
+ * @see {@link https://callstack.github.io/react-native-testing-library/ | RTLRN Docs}
+ * @module jest.setup
+ */
+
+// Import from pure to avoid auto-cleanup (we set RNTL_SKIP_AUTO_CLEANUP in pre-setup)
+// Then extend Jest matchers with React Native Testing Library matchers
+import { cleanup } from "@testing-library/react-native/pure";
+import "@testing-library/react-native/build/matchers/extend-expect";
+
+// Mock environment variables module for type-safe env access in tests
+// Tests can override specific values via jest.spyOn or jest.doMock
+// Replace the mock below with your project's actual env module and values
+jest.mock("@/lib/env", () => ({
+  env: {
+    EXPO_PUBLIC_ENV: "dev",
+    // Add your project-specific environment variables here
+  },
+}));
+
+// Extend global type for the unhandledRejection handler set in jest.setup.pre.js
+declare global {
+  let __unhandledRejectionHandler:
+    | ((reason: unknown, promise: Promise<unknown>) => void)
+    | undefined;
+}
+
+// Manual cleanup after each test (replacing RTLRN's auto cleanup)
+// This handles React 19's cleanup which can throw null
+afterEach(async () => {
+  try {
+    await cleanup();
+  } catch (error) {
+    // Silently ignore null throws from React 19 cleanup
+    if (error !== null) {
+      throw error;
+    }
+  }
+});
+
+// Mock ResizeObserver for tests that use it
+// eslint-disable-next-line functional/no-classes -- Mock implementation required for testing
+global.ResizeObserver = class ResizeObserver {
+  /** Starts observing an element — no-op for tests */
+  observe(): void {}
+  /** Stops observing an element — no-op for tests */
+  unobserve(): void {}
+  /** Disconnects observer — no-op for tests */
+  disconnect(): void {}
+};
+
+// Mock expo-router for tests using navigation hooks
+jest.mock("expo-router", () => ({
+  useRouter: jest.fn(() => ({
+    push: jest.fn(),
+    replace: jest.fn(),
+    back: jest.fn(),
+    canGoBack: jest.fn(() => true),
+  })),
+  usePathname: jest.fn(() => "/"),
+  useLocalSearchParams: jest.fn(() => ({})),
+  useGlobalSearchParams: jest.fn(() => ({})),
+  useSegments: jest.fn(() => []),
+  useNavigation: jest.fn(() => ({
+    navigate: jest.fn(),
+    goBack: jest.fn(),
+    getParent: jest.fn(() => ({
+      setOptions: jest.fn(),
+    })),
+  })),
+  Link: ({ children }: { children: React.ReactNode }) => children,
+  Stack: {
+    Screen: () => null,
+  },
+  Tabs: {
+    Screen: () => null,
+  },
+}));
+
+// Mock @react-native-firebase/analytics
+jest.mock("@react-native-firebase/analytics", () => {
+  const logEvent = jest.fn();
+  const getAnalytics = jest.fn(() => ({}));
+  return { logEvent, getAnalytics };
+});
+
+// Mock firebase/analytics
+jest.mock("firebase/analytics", () => {
+  const logEvent = jest.fn();
+  const getAnalytics = jest.fn(() => ({}));
+  return { logEvent, getAnalytics };
+});
+
+// Clear mocks after each test
+afterEach(() => {
+  jest.clearAllMocks();
+});
+
+// Remove the unhandledRejection handler after all tests to allow Jest to exit cleanly
+// The handler is registered in jest.setup.pre.js and stored on global
+afterAll(() => {
+  if (__unhandledRejectionHandler) {
+    process.removeListener("unhandledRejection", __unhandledRejectionHandler);
+  }
+});

package/package.json

@@ -85,7 +85,7 @@
   },
   "resolutions": {},
   "name": "@codyswann/lisa",
-  "version": "1.15.0",
+  "version": "1.16.0",
   "description": "Claude Code governance framework that applies guardrails, guidance, and automated enforcement to projects",
   "main": "dist/index.js",
   "bin": {

package/typescript/copy-contents/.husky/pre-push

@@ -79,7 +79,11 @@ elif [ "$PACKAGE_MANAGER" = "bun" ]; then
   # Excluding GHSA-8qq5-rm4j-mr97: node-tar path sanitization vulnerability
   # Nested dependency in @expo/cli - bun resolves to patched version but audit still flags it
   # Risk: Low - only affects tar extraction with malicious filenames, not our use case
-  if ! bun audit --audit-level=high --ignore GHSA-5j98-mcp5-4vw2 --ignore GHSA-8qq5-rm4j-mr97; then
+
+  # Excluding GHSA-37qj-frw5-hhjh: fast-xml-parser RangeError DoS with numeric entities
+  # Transitive dependency via @react-native-community/cli (Android/iOS build tooling)
+  # Risk: None - CLI build tool, not a production runtime dependency
+  if ! bun audit --audit-level=high --ignore GHSA-5j98-mcp5-4vw2 --ignore GHSA-8qq5-rm4j-mr97 --ignore GHSA-37qj-frw5-hhjh; then
     echo "⚠️ Security audit failed. Please fix high/critical vulnerabilities before pushing."
     exit 1
   fi

package/typescript/copy-overwrite/.claude/settings.json

@@ -11,6 +11,16 @@
           }
         ]
       },
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "$CLAUDE_PROJECT_DIR/.claude/hooks/enforce-plan-rules.sh",
+            "timeout": 5
+          }
+        ]
+      },
       {
         "matcher": "",
         "hooks": [

package/typescript/copy-overwrite/eslint.base.ts

@@ -109,7 +109,7 @@ export const getBaseConfigs = () => [
   },
 
   // Code quality
-  sonarjs.configs.recommended,
+  ...(sonarjs.configs?.recommended ? [sonarjs.configs.recommended] : []),
   {
     plugins: {
       "@eslint-community/eslint-comments": eslintComments,

package/typescript/copy-overwrite/eslint.ignore.config.json

@@ -31,6 +31,7 @@
 
     ".lisabak/**",
     ".claude-active-project/**",
+    ".claude-active-plan/**",
     "coverage/**",
     "**/*spec.ts",
     "resolver-test.setup.ts",

package/typescript/copy-overwrite/jest.base.ts

@@ -44,6 +44,7 @@ export const defaultCoverageExclusions: readonly string[] = [
   "!**/tests/**",
   "!**/__tests__/**",
   "!**/__mocks__/**",
+  "!**/components/ui/**",
 ];
 
 /**