@codyswann/lisa 1.47.1 → 1.49.0

package/scripts/install-claude-plugins.sh

@@ -0,0 +1,45 @@
+#!/usr/bin/env bash
+# Registers the Lisa marketplace and installs required Claude Code plugins.
+# Runs as Lisa's postinstall lifecycle script.
+set -euo pipefail
+
+if ! command -v claude &>/dev/null; then exit 0; fi
+
+PROJECT_ROOT="${npm_config_local_prefix:-${INIT_CWD:-}}"
+if [ -z "$PROJECT_ROOT" ]; then exit 0; fi
+
+LISA_DIR="$PROJECT_ROOT/node_modules/@codyswann/lisa"
+if [ ! -d "$LISA_DIR" ]; then exit 0; fi
+
+cd "$PROJECT_ROOT"
+
+# Register the Lisa marketplace pointing to this npm package
+claude marketplace add "$LISA_DIR" </dev/null 2>&1 || true
+
+# Detect which stack plugin to install from .claude/settings.json
+SETTINGS_FILE="$PROJECT_ROOT/.claude/settings.json"
+LISA_PLUGIN=""
+if [ -f "$SETTINGS_FILE" ]; then
+  for stack in typescript expo nestjs cdk rails; do
+    if grep -q "\"${stack}@lisa\"" "$SETTINGS_FILE" 2>/dev/null; then
+      LISA_PLUGIN="${stack}@lisa"
+      break
+    fi
+  done
+fi
+
+if [ -n "$LISA_PLUGIN" ]; then
+  claude plugin install "$LISA_PLUGIN" --scope project </dev/null 2>&1 || true
+fi
+
+# Install third-party plugins required by all Lisa stacks
+for plugin in \
+  "typescript-lsp@claude-plugins-official" \
+  "code-simplifier@claude-plugins-official" \
+  "code-review@claude-plugins-official" \
+  "playwright@claude-plugins-official" \
+  "coderabbit@claude-plugins-official" \
+  "sentry@claude-plugins-official" \
+  "safety-net@cc-marketplace"; do
+  claude plugin install "$plugin" --scope project </dev/null 2>&1 || true
+done

package/scripts/lisa-commit-and-pr-local.sh

@@ -0,0 +1,204 @@
+#!/bin/bash
+#
+# Lisa Local Project Commit & PR
+#
+# Iterates over projects defined in .lisa.config.local.json, creates
+# date-stamped branches for any projects with uncommitted changes,
+# commits those changes, pushes to remote, and opens pull requests.
+#
+# Intended to run after `lisa-update-local.sh` has applied Lisa templates
+# to all local projects, so each project's changes get their own PR.
+#
+# Usage:
+#   ./scripts/lisa-commit-and-pr-local.sh [--dry-run]
+#
+# Example:
+#   ./scripts/lisa-commit-and-pr-local.sh
+#   ./scripts/lisa-commit-and-pr-local.sh --dry-run
+#
+# Prerequisites:
+#   - jq installed
+#   - GitHub CLI (gh) installed and authenticated
+#   - .lisa.config.local.json exists in the project root
+#
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+LISA_ROOT="$(dirname "$SCRIPT_DIR")"
+CONFIG_FILE="$LISA_ROOT/.lisa.config.local.json"
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+CYAN='\033[0;36m'
+NC='\033[0m' # No Color
+
+log_info() {
+  echo -e "${BLUE}[INFO]${NC} $1"
+}
+
+log_success() {
+  echo -e "${GREEN}[SUCCESS]${NC} $1"
+}
+
+log_warning() {
+  echo -e "${YELLOW}[WARNING]${NC} $1"
+}
+
+log_error() {
+  echo -e "${RED}[ERROR]${NC} $1"
+}
+
+log_dry_run() {
+  echo -e "${CYAN}[DRY-RUN]${NC} $1"
+}
+
+# Parse arguments
+DRY_RUN=false
+if [[ "${1:-}" == "--dry-run" ]]; then
+  DRY_RUN=true
+  log_warning "Running in dry-run mode - no changes will be made"
+  echo ""
+fi
+
+# Validate prerequisites
+if ! command -v jq &> /dev/null; then
+  log_error "jq is required but not installed. Install with: brew install jq"
+  exit 1
+fi
+
+if ! command -v gh &> /dev/null; then
+  log_error "GitHub CLI (gh) is required but not installed. Install with: brew install gh"
+  exit 1
+fi
+
+if [[ ! -f "$CONFIG_FILE" ]]; then
+  log_error "Config file not found: $CONFIG_FILE"
+  log_info "Create .lisa.config.local.json with project paths and target branches"
+  exit 1
+fi
+
+# Validate JSON
+if ! jq empty "$CONFIG_FILE" 2>/dev/null; then
+  log_error "Invalid JSON in $CONFIG_FILE"
+  exit 1
+fi
+
+# Check GitHub CLI authentication (skip in dry-run since we won't use it)
+if [[ "$DRY_RUN" == false ]]; then
+  log_info "Checking GitHub CLI authentication..."
+  if ! gh auth status > /dev/null 2>&1; then
+    log_error "GitHub CLI is not authenticated. Please run 'gh auth login' first."
+    exit 1
+  fi
+  log_success "GitHub CLI authenticated"
+  echo ""
+fi
+
+project_count=$(jq 'length' "$CONFIG_FILE")
+log_info "Found $project_count project(s) in config"
+echo ""
+
+DATE_STAMP=$(date +%Y-%m-%d)
+
+# Counters
+success_count=0
+fail_count=0
+skip_count=0
+
+while IFS=$'\t' read -r project_path target_branch; do
+  # Expand tilde to $HOME
+  expanded_path="${project_path/#\~/$HOME}"
+
+  echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+  log_info "Project: $project_path (base: $target_branch)"
+
+  # Validate directory exists
+  if [[ ! -d "$expanded_path" ]]; then
+    log_error "Directory does not exist: $expanded_path"
+    ((fail_count++)) || true
+    continue
+  fi
+
+  # Check for changes
+  if [[ -z "$(git -C "$expanded_path" status --porcelain)" ]]; then
+    log_info "No changes detected, skipping"
+    ((skip_count++)) || true
+    continue
+  fi
+
+  # Determine unique branch name
+  branch_name="chore/lisa-update-$DATE_STAMP"
+  suffix=1
+  while git -C "$expanded_path" show-ref --verify --quiet "refs/heads/$branch_name" 2>/dev/null; do
+    ((suffix++)) || true
+    branch_name="chore/lisa-update-$DATE_STAMP-$suffix"
+  done
+
+  if [[ "$DRY_RUN" == true ]]; then
+    log_dry_run "Would create branch: $branch_name"
+    log_dry_run "Would stage all changes"
+    log_dry_run "Would commit: chore: update Lisa configuration"
+    log_dry_run "Would push to origin/$branch_name"
+    log_dry_run "Would create PR: chore: update Lisa configuration (base: $target_branch)"
+    ((success_count++)) || true
+    continue
+  fi
+
+  # Create branch
+  log_info "Creating branch: $branch_name"
+  if ! git -C "$expanded_path" checkout -b "$branch_name" "$target_branch" 2>&1; then
+    log_error "Failed to create branch $branch_name in $expanded_path"
+    ((fail_count++)) || true
+    continue
+  fi
+
+  # Stage and commit
+  log_info "Staging and committing changes..."
+  if ! git -C "$expanded_path" add -A 2>&1; then
+    log_error "Failed to stage changes in $expanded_path"
+    ((fail_count++)) || true
+    continue
+  fi
+  if ! git -C "$expanded_path" commit -m "chore: update Lisa configuration" 2>&1; then
+    log_error "Failed to commit changes in $expanded_path"
+    ((fail_count++)) || true
+    continue
+  fi
+
+  # Push
+  log_info "Pushing to origin/$branch_name..."
+  if ! GIT_SSH_COMMAND="ssh -o ServerAliveInterval=30 -o ServerAliveCountMax=5" git -C "$expanded_path" push -u origin "$branch_name" 2>&1; then
+    log_error "Failed to push $branch_name in $expanded_path"
+    ((fail_count++)) || true
+    continue
+  fi
+
+  # Create PR
+  log_info "Creating pull request..."
+  if ! (cd "$expanded_path" && gh pr create --title "chore: update Lisa configuration" --base "$target_branch" --body "Automated Lisa configuration update applied on $DATE_STAMP."); then
+    log_error "Failed to create PR for $expanded_path"
+    ((fail_count++)) || true
+    continue
+  fi
+
+  log_success "PR created for $project_path"
+  ((success_count++)) || true
+
+done < <(jq -r 'to_entries[] | "\(.key)\t\(.value)"' "$CONFIG_FILE")
+
+# Summary
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+
+if [[ "$DRY_RUN" == true ]]; then
+  log_info "Dry run complete. $success_count project(s) would have PRs created, $skip_count skipped (no changes)."
+else
+  log_info "Commit & PR complete"
+  echo -e "  ${GREEN}Succeeded${NC}: $success_count"
+  echo -e "  ${RED}Failed${NC}:    $fail_count"
+  echo -e "  ${YELLOW}Skipped${NC}:   $skip_count"
+fi

package/scripts/lisa-update-local.sh

@@ -0,0 +1,158 @@
+#!/bin/bash
+#
+# Lisa Local Project Update
+#
+# Iterates over projects defined in .lisa.config.local.json, checks out their
+# target branches, pulls latest changes, and applies Lisa templates using
+# `bun run dev <path> -y`.
+#
+# This enables batch-updating all locally managed projects in a single command
+# rather than manually visiting each project directory.
+#
+# Usage:
+#   ./scripts/lisa-update-local.sh [--dry-run]
+#
+# Example:
+#   ./scripts/lisa-update-local.sh
+#   ./scripts/lisa-update-local.sh --dry-run
+#
+# Prerequisites:
+#   - jq installed
+#   - bun installed
+#   - .lisa.config.local.json exists in the project root
+#
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+LISA_ROOT="$(dirname "$SCRIPT_DIR")"
+CONFIG_FILE="$LISA_ROOT/.lisa.config.local.json"
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+CYAN='\033[0;36m'
+NC='\033[0m' # No Color
+
+log_info() {
+  echo -e "${BLUE}[INFO]${NC} $1"
+}
+
+log_success() {
+  echo -e "${GREEN}[SUCCESS]${NC} $1"
+}
+
+log_warning() {
+  echo -e "${YELLOW}[WARNING]${NC} $1"
+}
+
+log_error() {
+  echo -e "${RED}[ERROR]${NC} $1"
+}
+
+log_dry_run() {
+  echo -e "${CYAN}[DRY-RUN]${NC} $1"
+}
+
+# Parse arguments
+DRY_RUN=false
+if [[ "${1:-}" == "--dry-run" ]]; then
+  DRY_RUN=true
+  log_warning "Running in dry-run mode - no changes will be made"
+  echo ""
+fi
+
+# Validate prerequisites
+if ! command -v jq &> /dev/null; then
+  log_error "jq is required but not installed. Install with: brew install jq"
+  exit 1
+fi
+
+if ! command -v bun &> /dev/null; then
+  log_error "bun is required but not installed. Install from: https://bun.sh"
+  exit 1
+fi
+
+if [[ ! -f "$CONFIG_FILE" ]]; then
+  log_error "Config file not found: $CONFIG_FILE"
+  log_info "Create .lisa.config.local.json with project paths and target branches"
+  exit 1
+fi
+
+# Validate JSON
+if ! jq empty "$CONFIG_FILE" 2>/dev/null; then
+  log_error "Invalid JSON in $CONFIG_FILE"
+  exit 1
+fi
+
+project_count=$(jq 'length' "$CONFIG_FILE")
+log_info "Found $project_count project(s) in config"
+echo ""
+
+success_count=0
+fail_count=0
+
+while IFS=$'\t' read -r project_path target_branch; do
+  # Expand tilde to $HOME
+  expanded_path="${project_path/#\~/$HOME}"
+
+  echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+  log_info "Project: $project_path (branch: $target_branch)"
+
+  # Validate directory exists
+  if [[ ! -d "$expanded_path" ]]; then
+    log_error "Directory does not exist: $expanded_path"
+    ((fail_count++)) || true
+    continue
+  fi
+
+  if [[ "$DRY_RUN" == true ]]; then
+    log_dry_run "Would checkout '$target_branch' in $expanded_path"
+    log_dry_run "Would pull latest from origin/$target_branch"
+    log_dry_run "Would run: bun run dev $expanded_path -y"
+    ((success_count++)) || true
+    continue
+  fi
+
+  # Checkout target branch
+  log_info "Checking out $target_branch..."
+  if ! git -C "$expanded_path" checkout "$target_branch" 2>&1; then
+    log_error "Failed to checkout $target_branch in $expanded_path (dirty worktree?)"
+    ((fail_count++)) || true
+    continue
+  fi
+
+  # Pull latest
+  log_info "Pulling latest from origin/$target_branch..."
+  if ! git -C "$expanded_path" pull origin "$target_branch" 2>&1; then
+    log_error "Failed to pull origin/$target_branch in $expanded_path"
+    ((fail_count++)) || true
+    continue
+  fi
+
+  # Apply Lisa templates
+  log_info "Applying Lisa templates..."
+  if ! (cd "$LISA_ROOT" && bun run dev "$expanded_path" -y); then
+    log_error "Lisa CLI failed for $expanded_path"
+    ((fail_count++)) || true
+    continue
+  fi
+
+  log_success "Updated $project_path"
+  ((success_count++)) || true
+
+done < <(jq -r 'to_entries[] | "\(.key)\t\(.value)"' "$CONFIG_FILE")
+
+# Summary
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+
+if [[ "$DRY_RUN" == true ]]; then
+  log_info "Dry run complete. $success_count project(s) would be updated."
+else
+  log_info "Update complete"
+  echo -e "  ${GREEN}Succeeded${NC}: $success_count"
+  echo -e "  ${RED}Failed${NC}:    $fail_count"
+fi

package/scripts/update-node-version.ts

@@ -0,0 +1,197 @@
+#!/usr/bin/env npx tsx
+/**
+ * Updates Node.js version across all configuration files in the Lisa project.
+ *
+ * Reads the version from .nvmrc and updates:
+ * - GitHub workflow files (node_version, node-version inputs)
+ * - package.json engine constraints
+ *
+ * @example
+ * ```bash
+ * # Run from project root
+ * npx tsx scripts/update-node-version.ts
+ *
+ * # Or with bun
+ * bun scripts/update-node-version.ts
+ * ```
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+
+const PROJECT_ROOT = path.resolve(import.meta.dirname, "..");
+
+/**
+ * Patterns to match and replace in workflow files
+ */
+interface ReplacementPattern {
+  /** Regex pattern to match */
+  readonly pattern: RegExp;
+  /** Replacement string (use $1, $2 for capture groups, {{version}} for the new version) */
+  readonly replacement: string;
+}
+
+const WORKFLOW_PATTERNS: readonly ReplacementPattern[] = [
+  // node_version: '22.21.1' (workflow input defaults)
+  {
+    pattern: /(node_version:\s*['"])[\d.]+(['"])/g,
+    replacement: "$1{{version}}$2",
+  },
+  // node-version: '22.21.1' (actions/setup-node)
+  {
+    pattern: /(node-version:\s*['"])[\d.]+(['"])/g,
+    replacement: "$1{{version}}$2",
+  },
+  // node-version: '22.x' (major version pattern)
+  {
+    pattern: /(node-version:\s*['"])\d+\.x(['"])/g,
+    replacement: "$1{{major}}.x$2",
+  },
+];
+
+const PACKAGE_JSON_PATTERN: ReplacementPattern = {
+  pattern: /("node":\s*["'])[\d.]+(["'])/g,
+  replacement: "$1{{version}}$2",
+};
+
+/**
+ * Files to update (relative to project root)
+ */
+const FILES_TO_UPDATE: readonly string[] = [
+  // This project's workflows
+  ".github/workflows/ci.yml",
+  ".github/workflows/quality.yml",
+  ".github/workflows/publish-to-npm.yml",
+
+  // TypeScript template workflows
+  "typescript/copy-overwrite/.github/workflows/quality.yml",
+  "typescript/copy-overwrite/.github/workflows/release.yml",
+  "typescript/copy-overwrite/.github/workflows/create-github-issue-on-failure.yml",
+  "typescript/copy-overwrite/.github/workflows/create-jira-issue-on-failure.yml",
+  "typescript/copy-overwrite/.github/workflows/create-sentry-issue-on-failure.yml",
+  "typescript/merge/package.json",
+
+  // Expo template workflows
+  "expo/copy-overwrite/.github/workflows/ci.yml",
+  "expo/copy-overwrite/.github/workflows/deploy.yml",
+  "expo/copy-overwrite/.github/workflows/build.yml",
+  "expo/copy-overwrite/.github/workflows/lighthouse.yml",
+
+  // NestJS template workflows
+  "nestjs/copy-overwrite/.github/workflows/ci.yml",
+  "nestjs/copy-overwrite/.github/workflows/deploy.yml",
+
+  // CDK template workflows
+  "cdk/copy-overwrite/workflows/ci.yml",
+
+  // npm-package template workflows
+  "npm-package/copy-overwrite/.github/workflows/publish-to-npm.yml",
+];
+
+/**
+ * Reads the Node.js version from .nvmrc
+ */
+function readNvmrcVersion(): string {
+  const nvmrcPath = path.join(PROJECT_ROOT, ".nvmrc");
+  const content = fs.readFileSync(nvmrcPath, "utf-8").trim();
+
+  if (!/^\d+\.\d+\.\d+$/.test(content)) {
+    throw new Error(
+      `Invalid version format in .nvmrc: "${content}". Expected semver (e.g., 22.21.1)`
+    );
+  }
+
+  return content;
+}
+
+/**
+ * Extracts the major version from a semver string
+ */
+function getMajorVersion(version: string): string {
+  return version.split(".")[0];
+}
+
+/**
+ * Updates a file with the new Node version
+ */
+function updateFile(
+  filePath: string,
+  version: string,
+  majorVersion: string
+): { updated: boolean; changes: number } {
+  const fullPath = path.join(PROJECT_ROOT, filePath);
+
+  if (!fs.existsSync(fullPath)) {
+    console.log(`  [SKIP] ${filePath} (file not found)`);
+    return { updated: false, changes: 0 };
+  }
+
+  const originalContent = fs.readFileSync(fullPath, "utf-8");
+  let content = originalContent;
+  let totalChanges = 0;
+
+  const patterns = filePath.endsWith(".json")
+    ? [PACKAGE_JSON_PATTERN]
+    : WORKFLOW_PATTERNS;
+
+  patterns.forEach(({ pattern, replacement }) => {
+    const resolvedReplacement = replacement
+      .replace("{{version}}", version)
+      .replace("{{major}}", majorVersion);
+
+    const matches = content.match(pattern);
+    if (matches) {
+      totalChanges += matches.length;
+    }
+
+    content = content.replace(pattern, resolvedReplacement);
+  });
+
+  if (content !== originalContent) {
+    fs.writeFileSync(fullPath, content, "utf-8");
+    console.log(`  [OK] ${filePath} (${totalChanges} replacements)`);
+    return { updated: true, changes: totalChanges };
+  }
+
+  console.log(`  [SKIP] ${filePath} (no changes needed)`);
+  return { updated: false, changes: 0 };
+}
+
+/**
+ * Main entry point
+ */
+function main(): void {
+  console.log("Node Version Updater");
+  console.log("====================\n");
+
+  const version = readNvmrcVersion();
+  const majorVersion = getMajorVersion(version);
+
+  console.log(`Source: .nvmrc`);
+  console.log(`Version: ${version}`);
+  console.log(`Major: ${majorVersion}.x\n`);
+
+  console.log("Updating files...\n");
+
+  let filesUpdated = 0;
+  let totalChanges = 0;
+
+  FILES_TO_UPDATE.forEach(file => {
+    const result = updateFile(file, version, majorVersion);
+    if (result.updated) {
+      filesUpdated++;
+      totalChanges += result.changes;
+    }
+  });
+
+  console.log("\n====================");
+  console.log(`Files updated: ${filesUpdated}`);
+  console.log(`Total replacements: ${totalChanges}`);
+
+  if (filesUpdated > 0) {
+    console.log(
+      "\nRemember to commit these changes and regenerate package-lock.json if needed."
+    );
+  }
+}
+
+main();

package/tsconfig/build.json

@@ -0,0 +1,8 @@
+{
+  "extends": "./typescript.json",
+  "compilerOptions": {
+    "noEmit": false,
+    "outDir": "dist"
+  },
+  "exclude": ["node_modules", "dist", "**/*.test.ts", "**/*.spec.ts"]
+}

package/tsconfig/cdk.json

@@ -0,0 +1,16 @@
+{
+  "extends": "./base.json",
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "commonjs",
+    "lib": ["es2020"],
+    "sourceMap": false,
+    "inlineSourceMap": true,
+    "inlineSources": true,
+    "experimentalDecorators": true,
+    "strictPropertyInitialization": false,
+    "noUnusedLocals": false,
+    "noUnusedParameters": false
+  },
+  "include": ["lib/**/*", "bin/**/*", "test/**/*"]
+}

package/tsconfig/eslint.json

@@ -0,0 +1,12 @@
+{
+  "extends": "./typescript.json",
+  "compilerOptions": {
+    "rootDir": ".",
+    "noEmit": true,
+    "allowImportingTsExtensions": true,
+    "module": "preserve",
+    "moduleResolution": "bundler"
+  },
+  "include": ["**/*.ts"],
+  "exclude": ["node_modules", "dist", "build"]
+}

package/tsconfig/expo.json

@@ -0,0 +1,18 @@
+{
+  "extends": ["expo/tsconfig.base", "./base.json"],
+  "compilerOptions": {
+    "strict": true,
+    "jsx": "react-native",
+    "baseUrl": "./",
+    "noEmit": true,
+    "declaration": false,
+    "allowImportingTsExtensions": true,
+    "paths": {
+      "@/graphql/*": ["./generated/*"],
+      "@/*": ["./*"]
+    },
+    "moduleSuffixes": [".ios", ".android", ".native", ".web", ""]
+  },
+  "include": ["**/*.ts", "**/*.tsx", "nativewind-env.d.ts"],
+  "exclude": ["node_modules", "dist", "web-build", "components/ui"]
+}

package/tsconfig/nestjs.json

@@ -0,0 +1,18 @@
+{
+  "extends": "./base.json",
+  "compilerOptions": {
+    "module": "commonjs",
+    "target": "ES2021",
+    "emitDecoratorMetadata": true,
+    "experimentalDecorators": true,
+    "declaration": true,
+    "sourceMap": true,
+    "outDir": ".build",
+    "baseUrl": "./",
+    "paths": {
+      "@/*": ["./src/*"]
+    }
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", ".build", "dist", "**/*.test.ts", "**/*.spec.ts"]
+}

package/tsconfig/spec.json

@@ -0,0 +1,7 @@
+{
+  "extends": "./typescript.json",
+  "compilerOptions": {
+    "types": ["jest", "node"]
+  },
+  "include": ["**/*.spec.ts", "**/*.test.ts", "**/*.d.ts"]
+}

package/{typescript/copy-overwrite/tsconfig.typescript.json → tsconfig/typescript.json}

@@ -1,5 +1,5 @@
 {
-  "extends": "./tsconfig.base.json",
+  "extends": "./base.json",
   "compilerOptions": {
     "target": "ES2022",
     "module": "NodeNext",