@codyswann/lisa 1.0.0

package/expo/copy-overwrite/lighthouserc.js

@@ -0,0 +1,194 @@
+/**
+ * Lighthouse CI Configuration
+ *
+ * This configuration file defines performance budgets and assertion rules for
+ * Lighthouse CI to monitor and enforce web performance standards in CI/CD pipelines.
+ *
+ * ## Configuration Approach
+ *
+ * Uses assertions (not budget.json) for:
+ * - More comprehensive checks available
+ * - Better CI integration and error reporting
+ * - Ability to combine preset with custom assertions
+ * - Note: Cannot use both budget.json and assertions together
+ *
+ * ## Project-Specific Configuration
+ *
+ * Thresholds are loaded from `lighthouserc-config.json`. To customize for your
+ * project, edit that file. This JS file can be copied between projects unchanged.
+ *
+ * ## Threshold Strategy
+ *
+ * Thresholds are set to be realistic for Expo web apps while preventing
+ * significant regressions. CI environments have higher variance than local.
+ *
+ * Known issues that remain as "warn" (non-blocking):
+ * - errors-in-console: Missing favicon.ico causes 404
+ * - image-aspect-ratio: Some images have incorrect sizing
+ * - meta-description: Not a priority for mobile-first app
+ * - max-potential-fid: High variance in CI environments
+ * - largest-contentful-paint: Expo apps struggle to meet Core Web Vital threshold
+ *
+ * @see {@link https://github.com/GoogleChrome/lighthouse-ci/blob/main/docs/configuration.md|Lighthouse CI Configuration}
+ * @see {@link https://web.dev/vitals/|Core Web Vitals}
+ */
+
+const fs = require("fs");
+const path = require("path");
+
+/**
+ * Default configuration values.
+ * These are used when lighthouserc-config.json doesn't specify a value.
+ */
+const defaults = {
+  collect: {
+    staticDistDir: "./dist",
+    numberOfRuns: 5,
+  },
+  assertions: {
+    buttonName: { minScore: 0.9 },
+    validSourceMaps: { minScore: 0.9 },
+    errorsInConsole: { minScore: 1 },
+    performance: { minScore: 0.55 },
+    firstContentfulPaint: { maxNumericValue: 1500 },
+    largestContentfulPaint: { maxNumericValue: 4000 },
+    interactive: { maxNumericValue: 6000 },
+    cumulativeLayoutShift: { maxNumericValue: 0.1 },
+    totalByteWeight: { maxNumericValue: 850000 },
+    scriptSize: { maxNumericValue: 750000 },
+    fontDisplay: { minScore: 0.9 },
+    imageAspectRatio: { minScore: 1 },
+    metaDescription: { minScore: 1 },
+    unusedJavascript: { maxLength: 2 },
+    bootupTime: { minScore: 0.9 },
+    mainthreadWorkBreakdown: { minScore: 0.9 },
+    maxPotentialFid: { minScore: 1 },
+    legacyJavascript: { maxLength: 2 },
+    legacyJavascriptInsight: { minScore: 0.4 },
+    speedIndex: { minScore: 0.9 },
+  },
+};
+
+/**
+ * Load and merge project-specific configuration from lighthouserc-config.json.
+ *
+ * @returns {object} Merged configuration with defaults
+ */
+function loadConfig() {
+  const configPath = path.join(__dirname, "lighthouserc-config.json");
+
+  if (!fs.existsSync(configPath)) {
+    return defaults;
+  }
+
+  const projectConfig = JSON.parse(fs.readFileSync(configPath, "utf8"));
+
+  return {
+    collect: { ...defaults.collect, ...projectConfig.collect },
+    assertions: {
+      ...defaults.assertions,
+      ...Object.fromEntries(
+        Object.entries(projectConfig.assertions || {}).map(([key, value]) => [
+          key,
+          { ...defaults.assertions[key], ...value },
+        ])
+      ),
+    },
+  };
+}
+
+const config = loadConfig();
+const { collect, assertions: a } = config;
+
+module.exports = {
+  ci: {
+    collect: {
+      staticDistDir: collect.staticDistDir,
+      numberOfRuns: collect.numberOfRuns,
+      chromePath: process.env.CHROME_PATH || undefined,
+    },
+
+    assert: {
+      preset: "lighthouse:recommended",
+
+      assertions: {
+        // Accessibility
+        "button-name": ["error", { minScore: a.buttonName.minScore }],
+        "valid-source-maps": [
+          "error",
+          { minScore: a.validSourceMaps.minScore },
+        ],
+        "errors-in-console": ["warn", { minScore: a.errorsInConsole.minScore }],
+
+        // Performance Score
+        "categories:performance": [
+          "error",
+          { minScore: a.performance.minScore, aggregationMethod: "median" },
+        ],
+
+        // Core Web Vitals - Timing Metrics
+        "first-contentful-paint": [
+          "error",
+          { maxNumericValue: a.firstContentfulPaint.maxNumericValue },
+        ],
+        "largest-contentful-paint": [
+          "warn",
+          { maxNumericValue: a.largestContentfulPaint.maxNumericValue },
+        ],
+        interactive: [
+          "error",
+          { maxNumericValue: a.interactive.maxNumericValue },
+        ],
+        "cumulative-layout-shift": [
+          "error",
+          { maxNumericValue: a.cumulativeLayoutShift.maxNumericValue },
+        ],
+
+        // Resource Budgets
+        "total-byte-weight": [
+          "error",
+          { maxNumericValue: a.totalByteWeight.maxNumericValue },
+        ],
+        "resource-summary:script:size": [
+          "error",
+          { maxNumericValue: a.scriptSize.maxNumericValue },
+        ],
+
+        // Best Practices
+        "font-display": ["error", { minScore: a.fontDisplay.minScore }],
+        "image-aspect-ratio": [
+          "warn",
+          { minScore: a.imageAspectRatio.minScore },
+        ],
+
+        // SEO
+        "meta-description": ["warn", { minScore: a.metaDescription.minScore }],
+
+        // Performance Insights
+        "unused-javascript": [
+          "error",
+          { maxLength: a.unusedJavascript.maxLength },
+        ],
+        "bootup-time": ["error", { minScore: a.bootupTime.minScore }],
+        "mainthread-work-breakdown": [
+          "error",
+          { minScore: a.mainthreadWorkBreakdown.minScore },
+        ],
+        "max-potential-fid": ["warn", { minScore: a.maxPotentialFid.minScore }],
+        "legacy-javascript": [
+          "error",
+          { maxLength: a.legacyJavascript.maxLength },
+        ],
+        "legacy-javascript-insight": [
+          "warn",
+          { minScore: a.legacyJavascriptInsight.minScore },
+        ],
+        "speed-index": ["error", { minScore: a.speedIndex.minScore }],
+      },
+    },
+
+    upload: {
+      target: "temporary-public-storage",
+    },
+  },
+};

package/expo/create-only/lighthouserc-config.json

@@ -0,0 +1,28 @@
+{
+  "collect": {
+    "staticDistDir": "./dist",
+    "numberOfRuns": 5
+  },
+  "assertions": {
+    "buttonName": { "minScore": 0.9 },
+    "validSourceMaps": { "minScore": 0.9 },
+    "errorsInConsole": { "minScore": 1 },
+    "performance": { "minScore": 0.55 },
+    "firstContentfulPaint": { "maxNumericValue": 1500 },
+    "largestContentfulPaint": { "maxNumericValue": 4000 },
+    "interactive": { "maxNumericValue": 6000 },
+    "cumulativeLayoutShift": { "maxNumericValue": 0.1 },
+    "totalByteWeight": { "maxNumericValue": 850000 },
+    "scriptSize": { "maxNumericValue": 750000 },
+    "fontDisplay": { "minScore": 0.9 },
+    "imageAspectRatio": { "minScore": 1 },
+    "metaDescription": { "minScore": 1 },
+    "unusedJavascript": { "maxLength": 2 },
+    "bootupTime": { "minScore": 0.9 },
+    "mainthreadWorkBreakdown": { "minScore": 0.9 },
+    "maxPotentialFid": { "minScore": 1 },
+    "legacyJavascript": { "maxLength": 2 },
+    "legacyJavascriptInsight": { "minScore": 0.4 },
+    "speedIndex": { "minScore": 0.9 }
+  }
+}

package/expo/merge/package.json

@@ -0,0 +1,132 @@
+{
+  "scripts": {
+    "start:local": "cp .env.localhost .env.local && EXPO_ATLAS=true expo start",
+    "start:dev": "EXPO_ATLAS=true cp .env.development .env.local && EXPO_ATLAS=true expo start",
+    "start:staging": "cp .env.staging .env.local && EXPO_ATLAS=true expo start",
+    "start:production": "cp .env.production .env.local && EXPO_ATLAS=true expo start",
+    "fetch:graphql:schema:dev": "./scripts/fetch-graphql-schema.sh development",
+    "fetch:graphql:schema:staging": "./scripts/fetch-graphql-schema.sh staging",
+    "fetch:graphql:schema:production": "./scripts/fetch-graphql-schema.sh production",
+    "export:web": "expo export --platform web --source-maps",
+    "lighthouse:check": "lhci autorun --collect.settings.chromeFlags='--no-sandbox --disable-gpu --headless'",
+    "playwright:build": "expo export --platform web",
+    "playwright:test": "bun run playwright:build && playwright test",
+    "playwright:test:ui": "bun run playwright:build && playwright test --ui",
+    "maestro:test": "maestro test .maestro/flows",
+    "maestro:test:smoke": "maestro test .maestro/flows --include-tags=smoke",
+    "maestro:studio": "maestro studio",
+    "pre-build:eas": "cat .gitignore > .easignore && cat .easignore.extra >> .easignore",
+    "android": "expo run:android",
+    "ios": "expo run:ios"
+  },
+  "main": "expo-router/entry",
+  "dependencies": {
+    "@apollo/client": "^3.10.8",
+    "@expo/metro-runtime": "~6.1.2",
+    "@gluestack-ui/core": "^3.0.10",
+    "@gluestack-ui/utils": "^3.0.7",
+    "@gorhom/bottom-sheet": "^5.2.6",
+    "@hookform/resolvers": "^3.9.0",
+    "@legendapp/motion": "^2.4.0",
+    "@react-native-async-storage/async-storage": "2.2.0",
+    "@react-native-masked-view/masked-view": "^0.3.2",
+    "@react-navigation/drawer": "^7.5.0",
+    "@react-navigation/elements": "^1.3.31",
+    "@sentry/react-native": "7.2.0",
+    "@shopify/flash-list": "2.0.2",
+    "@shopify/react-native-skia": "2.2.12",
+    "apollo-link-sentry": "^4.0.0",
+    "base-64": "^1.0.0",
+    "date-fns": "^3.6.0",
+    "date-fns-tz": "^3.1.3",
+    "events": "^3.3.0",
+    "expo": "~54.0.31",
+    "expo-application": "~7.0.8",
+    "expo-battery": "~10.0.8",
+    "expo-build-properties": "~1.0.10",
+    "expo-clipboard": "~8.0.8",
+    "expo-constants": "~18.0.13",
+    "expo-crypto": "^15.0.8",
+    "expo-dev-client": "~6.0.20",
+    "expo-device": "~8.0.10",
+    "expo-font": "~14.0.10",
+    "expo-linear-gradient": "~15.0.8",
+    "expo-linking": "~8.0.11",
+    "expo-localization": "^17.0.8",
+    "expo-network": "~8.0.8",
+    "expo-notifications": "~0.32.16",
+    "expo-router": "~6.0.21",
+    "expo-secure-store": "~15.0.8",
+    "expo-splash-screen": "~31.0.13",
+    "expo-status-bar": "~3.0.9",
+    "expo-system-ui": "~6.0.9",
+    "expo-updates": "~29.0.16",
+    "graphql": "^16.12.0",
+    "i18n-js": "^4.5.1",
+    "lucide-react-native": "^0.562.0",
+    "nativewind": "^4.2.1",
+    "patch-package": "^8.0.0",
+    "react": "19.1.0",
+    "react-dom": "19.1.0",
+    "react-hook-form": "^7.70.0",
+    "react-native": "0.81.4",
+    "react-native-gesture-handler": "~2.30.0",
+    "react-native-keyboard-controller": "1.20.4",
+    "react-native-reanimated": "~4.2.1",
+    "react-native-safe-area-context": "^5.6.2",
+    "react-native-screens": "~4.19.0",
+    "react-native-store-version": "^1.4.1",
+    "react-native-svg": "^15.15.1",
+    "react-native-web": "^0.21.2",
+    "react-native-worklets": "0.7.1",
+    "tailwindcss": "^3.4.7",
+    "tar": "^7.5.3",
+    "text-encoding-polyfill": "^0.6.7",
+    "use-debounce": "^10.1.0",
+    "usehooks-ts": "^3.1.1",
+    "zod": "^4.3.5"
+  },
+  "devDependencies": {
+    "@babel/core": "^7.20.0",
+    "@babel/plugin-proposal-export-namespace-from": "^7.18.9",
+    "@graphql-codegen/cli": "^6.1.0",
+    "@graphql-codegen/typescript": "^4.1.6",
+    "@graphql-codegen/typescript-operations": "^4.4.2",
+    "@graphql-codegen/typescript-react-apollo": "^4.3.4",
+    "@lhci/cli": "^0.15.1",
+    "@playwright/test": "^1.57.0",
+    "@react-native-community/cli": "^20.0.2",
+    "@react-native-community/cli-platform-android": "^20.0.2",
+    "@react-native-community/cli-platform-ios": "^20.0.2",
+    "@testing-library/react-native": "^13.0.0",
+    "@types/base-64": "^1.0.2",
+    "@types/react": "~19.1.10",
+    "@types/react-dom": "^19.1.7",
+    "babel-plugin-istanbul": "^6.1.1",
+    "babel-plugin-module-resolver": "^5.0.2",
+    "baseline-browser-mapping": "^2.9.2",
+    "eslint-config-expo": "^10.0.0",
+    "eslint-plugin-component-structure": "file:./eslint-plugin-component-structure",
+    "eslint-plugin-jsx-a11y": "^6.10.0",
+    "eslint-plugin-react": "^7.37.0",
+    "eslint-plugin-react-compiler": "^19.1.0-rc.2",
+    "eslint-plugin-react-hooks": "^7.0.0",
+    "eslint-plugin-react-perf": "^3.3.0",
+    "eslint-plugin-tailwindcss": "^3.18.0",
+    "eslint-plugin-ui-standards": "file:./eslint-plugin-ui-standards",
+    "expo-atlas": "^0.4.0",
+    "globals": "^16.0.0",
+    "jest-environment-jsdom": "^30.2.0",
+    "jest-expo": "^54.0.12",
+    "react-test-renderer": "19.1.0"
+  },
+  "resolutions": {
+    "eslint-plugin-react-hooks": "^7.0.0",
+    "tar": "^7.5.3"
+  },
+  "overrides": {
+    "eslint-plugin-react-hooks": "^7.0.0",
+    "zod-validation-error": "^4.0.0",
+    "tar": "^7.5.3"
+  }
+}

package/lisa.sh

@@ -0,0 +1,35 @@
+#!/usr/bin/env bash
+#
+# Lisa - Claude Code governance framework
+#
+# This script wraps the TypeScript implementation. If Node.js is not available,
+# it falls back to the legacy bash implementation.
+#
+
+set -euo pipefail
+
+LISA_DIR="$(cd "$(dirname "$0")" && pwd)"
+
+# Check if Node.js is available and the dist directory exists
+if command -v node &> /dev/null && [[ -d "$LISA_DIR/dist" ]]; then
+    # Run the TypeScript version
+    exec node "$LISA_DIR/dist/index.js" "$@"
+elif command -v npx &> /dev/null && [[ -f "$LISA_DIR/package.json" ]]; then
+    # Try building and running via npm
+    echo "[INFO] Building TypeScript version..."
+    cd "$LISA_DIR"
+    npm run build --silent 2>/dev/null || true
+    if [[ -d "$LISA_DIR/dist" ]]; then
+        exec node "$LISA_DIR/dist/index.js" "$@"
+    fi
+fi
+
+# If we get here, TypeScript version is not available
+echo "[ERROR] TypeScript version not available."
+echo ""
+echo "To use Lisa, please ensure Node.js is installed and run:"
+echo "  cd $LISA_DIR && npm install && npm run build"
+echo ""
+echo "Then run Lisa again:"
+echo "  $0 $*"
+exit 1

package/nestjs/copy-overwrite/.claude/skills/nestjs-graphql/SKILL.md

@@ -0,0 +1,176 @@
+---
+name: nestjs-graphql
+description: Comprehensive guide for NestJS GraphQL development using Apollo and code-first approach. This skill should be used when writing GraphQL resolvers, mutations, queries, types, subscriptions, or implementing advanced features like field middleware, complexity limits, and custom scalars. Also covers project-specific patterns including zero-trust auth decorators and DataLoader integration.
+---
+
+# NestJS GraphQL Development Guide
+
+## Overview
+
+This skill provides comprehensive guidance for building GraphQL APIs with NestJS using Apollo Server and the code-first approach. It covers official NestJS GraphQL patterns plus project-specific implementations for authentication, authorization, and data loading.
+
+## When to Use This Skill
+
+- Writing new GraphQL resolvers, queries, or mutations
+- Creating GraphQL object types, input types, or enums
+- Implementing field resolvers or computed fields
+- Adding subscriptions for real-time updates
+- Configuring query complexity limits
+- Creating custom scalars or field middleware
+- Implementing authentication/authorization on GraphQL operations
+- Setting up DataLoader for N+1 prevention
+
+## Quick Reference
+
+### Core Decorators
+
+| Decorator | Purpose | Import |
+|-----------|---------|--------|
+| `@Resolver()` | Define resolver class | `@nestjs/graphql` |
+| `@Query()` | Define query operation | `@nestjs/graphql` |
+| `@Mutation()` | Define mutation operation | `@nestjs/graphql` |
+| `@Args()` | Extract arguments | `@nestjs/graphql` |
+| `@Context()` | Access GraphQL context | `@nestjs/graphql` |
+| `@Parent()` | Access parent in field resolver | `@nestjs/graphql` |
+| `@ResolveField()` | Define field resolver | `@nestjs/graphql` |
+| `@ObjectType()` | Define GraphQL object type | `@nestjs/graphql` |
+| `@InputType()` | Define GraphQL input type | `@nestjs/graphql` |
+| `@Field()` | Define field on type | `@nestjs/graphql` |
+| `@Extensions()` | Attach metadata to fields | `@nestjs/graphql` |
+
+### Type Decorators
+
+| Decorator | GraphQL Type | TypeScript Type |
+|-----------|-------------|-----------------|
+| `@Field(() => String)` | "String!" | `string` |
+| `@Field(() => Int)` | "Int!" | `number` |
+| `@Field(() => Float)` | "Float!" | `number` |
+| `@Field(() => Boolean)` | "Boolean!" | `boolean` |
+| `@Field(() => ID)` | "ID!" | `string` |
+| `@Field(() => [String])` | "[String!]!" | `string[]` |
+| `@Field({ nullable: true })` | `String` | `string \| null` |
+
+## Code-First Patterns
+
+### Basic Resolver Structure
+
+```typescript
+import { Args, Context, Mutation, Query, Resolver } from "@nestjs/graphql";
+import { Public, Authed } from "../auth";
+
+@Resolver(() => Entity)
+export class EntityResolver {
+  constructor(private readonly entityService: EntityService) {}
+
+  @Query(() => Entity, { description: "Retrieve entity by ID" })
+  @Authed()
+  async entity(@Args("id", { type: () => ID }) id: string): Promise<Entity> {
+    return this.entityService.findById(id);
+  }
+
+  @Mutation(() => Entity, { description: "Create new entity" })
+  @Authed()
+  async createEntity(
+    @Args("input") input: CreateEntityInput,
+    @Context() { req }: GraphQLContext
+  ): Promise<Entity> {
+    return this.entityService.create(input, req.user.id);
+  }
+}
+```
+
+### Object Type Definition
+
+```typescript
+import { Field, ID, ObjectType } from "@nestjs/graphql";
+
+@ObjectType({ description: "Represents a user in the system" })
+export class User {
+  @Field(() => ID, { description: "Unique identifier" })
+  id: string;
+
+  @Field(() => String, { description: "User's email address" })
+  email: string;
+
+  @Field(() => String, { nullable: true, description: "Display name" })
+  displayName?: string;
+
+  @Field(() => Date, { description: "Account creation timestamp" })
+  createdAt: Date;
+}
+```
+
+### Input Type Definition
+
+```typescript
+import { Field, InputType } from "@nestjs/graphql";
+
+@InputType({ description: "Input for creating a new user" })
+export class CreateUserInput {
+  @Field(() => String, { description: "User's email address" })
+  email: string;
+
+  @Field(() => String, { description: "User's password" })
+  password: string;
+
+  @Field(() => String, { nullable: true, description: "Optional display name" })
+  displayName?: string;
+}
+```
+
+## References
+
+This skill includes detailed reference files for specific topics:
+
+### references/quick-start.md
+Setup and configuration for NestJS GraphQL with Apollo driver, module configuration, and code-first vs schema-first approaches.
+
+### references/resolvers-mutations.md
+Comprehensive guide to writing resolvers, queries, mutations, field resolvers, and using decorators like @Args, @Context, @Parent.
+
+### references/types-scalars.md
+Creating object types, input types, enums, interfaces, unions, and custom scalars. Includes mapped types (PartialType, PickType, etc.).
+
+### references/advanced-features.md
+Field middleware, query complexity, plugins, subscriptions, and extensions.
+
+### references/project-patterns.md
+Project-specific patterns including zero-trust auth decorators (@Public, @Authed, @Owner, @Groups), DataLoader integration, and GraphQL documentation standards.
+
+## Common Tasks
+
+### Adding a New Query
+
+1. Add method to resolver with `@Query()` decorator
+2. Add auth decorator (`@Public()`, `@Authed()`, or `@Groups()`)
+3. Define return type in decorator: `@Query(() => ReturnType)`
+4. Add description: `@Query(() => ReturnType, { description: "..." })`
+5. Use `@Args()` for parameters with descriptions
+
+### Adding a New Mutation
+
+1. Add method to resolver with `@Mutation()` decorator
+2. Add auth decorator (mutations typically use `@Authed()`)
+3. Create InputType for complex inputs
+4. Access user context via `@Context() { req }: GraphQLContext`
+
+### Adding Field Resolver
+
+```typescript
+@ResolveField(() => [Comment], { description: "Entity's comments" })
+async comments(
+  @Parent() entity: Entity,
+  @Context() { loaders }: GraphQLContext
+): Promise<Comment[]> {
+  return loaders.commentsLoader.load(entity.id);
+}
+```
+
+### Adding DataLoader for New Entity
+
+1. Add batch method to service: `getByIds(ids: string[]): Promise<Entity[]>`
+2. Add loader type to `IDataLoaders` interface
+3. Create loader in `DataLoaderService.getLoaders()`
+4. Use in resolver: `loaders.entityLoader.load(id)`
+
+See `references/project-patterns.md` for detailed DataLoader patterns.