@codyswann/lisa 1.0.0

package/typescript/copy-overwrite/eslint.config.mjs

@@ -0,0 +1,390 @@
+/**
+ * ESLint 9 Flat Config
+ *
+ * This configuration file replaces the legacy .eslintrc.json format.
+ * It uses JavaScript modules and explicit imports for all plugins and configs.
+ *
+ * @see https://eslint.org/docs/latest/use/configure/configuration-files-new
+ * @module eslint.config
+ */
+import eslintComments from "@eslint-community/eslint-plugin-eslint-comments";
+import js from "@eslint/js";
+import functional from "eslint-plugin-functional";
+import jsdoc from "eslint-plugin-jsdoc";
+import prettier from "eslint-plugin-prettier/recommended";
+import sonarjs from "eslint-plugin-sonarjs";
+import globals from "globals";
+import path from "path";
+import tseslint from "typescript-eslint";
+import { fileURLToPath } from "url";
+
+// Project-specific configuration loaded from JSON files
+// Edit these files to customize for your project; this JS file can be shared unchanged
+import ignoreConfig from "./eslint.ignore.config.json" with { type: "json" };
+import thresholdsConfig from "./eslint.thresholds.config.json" with { type: "json" };
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+/** Default ignore patterns used when not specified in config */
+const defaultIgnores = [
+  "build/**",
+  "dist/**",
+  ".build/**",
+  ".esbuild/**",
+  ".serverless/**",
+  ".webpack/**",
+  "_warmup/**",
+  "node_modules/**",
+  "**/node_modules/**",
+  "src/graphql/**",
+  "src/graphql.ts",
+  "src/graphql-generated/**",
+  "src/generated/**",
+  "graphql/**",
+  "graphql-generated/**",
+  "generated/**",
+  "components/ui/**",
+  "coverage/**",
+  "**/*spec.ts",
+  "resolver-test.setup.ts",
+  "**/*.factory.ts",
+  "**/test-utils/**",
+  "**/test/**",
+  "**/database/migrations/**",
+  "cypress/**",
+  "e2e/**",
+  "playwright-report/**",
+  ".lighthouseci/**",
+  ".expo/**",
+  ".github/**",
+  "public/**",
+  ".dead/**",
+  "example/**",
+  "tmp/**",
+  ".vscode/**",
+  "*.config.js",
+  "*.config.mjs",
+  "babel.config.js",
+  "metro.config.js",
+  "webpack.*.js",
+  "*.d.ts",
+  "esbuild.plugins.js",
+  "projects/**/scripts/**",
+  "scripts/**",
+  "lib/**/*.js",
+  "cdk.out/**",
+];
+
+/** Default thresholds used when not specified in config */
+const defaultThresholds = {
+  cognitiveComplexity: 10,
+  maxLines: 300,
+};
+
+const ignorePatterns = ignoreConfig.ignores || defaultIgnores;
+const thresholds = { ...defaultThresholds, ...thresholdsConfig };
+
+// Custom plugins and configs (CommonJS - use createRequire)
+import { createRequire } from "module";
+const require = createRequire(import.meta.url);
+
+// Custom plugins
+const codeOrganization = require("./eslint-plugin-code-organization/index.js");
+
+// Expo config (CommonJS)
+
+export default [
+  // Global ignores - loaded from eslint.ignore.config.json
+  {
+    ignores: ignorePatterns,
+  },
+
+  // Base configurations
+  js.configs.recommended,
+
+  // TypeScript configuration
+  ...tseslint.configs.recommended,
+
+  // Functional programming - manual configuration since v7 requires type info
+  // We'll configure specific rules we need without type checking
+  {
+    plugins: {
+      functional,
+    },
+  },
+
+  // Code quality
+  sonarjs.configs.recommended,
+  {
+    plugins: {
+      "@eslint-community/eslint-comments": eslintComments,
+    },
+    rules: {
+      ...eslintComments.configs.recommended.rules,
+    },
+  },
+
+  // Documentation
+  jsdoc.configs["flat/recommended-typescript-flavor"],
+
+  // Prettier (must be last of shared configs)
+  prettier,
+
+  // Base configuration for all files
+  {
+    languageOptions: {
+      globals: {
+        ...globals.browser,
+        ...globals.node,
+        ...globals.es2021,
+      },
+      parserOptions: {
+        ecmaVersion: 2021,
+        sourceType: "module",
+      },
+    },
+    plugins: {
+      "code-organization": codeOrganization,
+      // folders: foldersPlugin, // Disabled: not compatible with ESLint 9 flat config
+    },
+    rules: {
+      // Prettier: Disabled because running Prettier inside ESLint is redundant and slower.
+      // We use `format:check` from package.json for formatting validation and editor Prettier integration.
+      // The eslint-config-prettier (imported above) still disables conflicting ESLint rules.
+      // @see https://prettier.io/docs/en/integrating-with-linters.html
+      "prettier/prettier": "off",
+
+      // Code organization
+      "code-organization/enforce-statement-order": "error",
+
+      // Import rules
+      "no-restricted-imports": [
+        "warn",
+        {
+          patterns: ["@/features/*/*"],
+        },
+      ],
+
+      // File size - threshold loaded from eslint.thresholds.config.json
+      "max-lines": [
+        "error",
+        {
+          max: thresholds.maxLines,
+          skipBlankLines: true,
+          skipComments: true,
+        },
+      ],
+
+      // Folder naming
+      // NOTE: eslint-plugin-folders is not compatible with ESLint 9 flat config
+      // The rule has no schema defined and ESLint 9 validates rule options strictly
+      // This needs to be addressed in a separate PR or the plugin needs to be updated
+      // "folders/match-regex": ["error", "^([a-z][a-z0-9]*)(-[a-z0-9]+)*$", "/src/"],
+
+      // SonarJS rules - threshold loaded from eslint.thresholds.config.json
+      "sonarjs/cognitive-complexity": ["error", thresholds.cognitiveComplexity],
+      "sonarjs/no-identical-functions": "error",
+      "sonarjs/no-duplicate-string": "error",
+      "sonarjs/no-nested-template-literals": "warn",
+      "sonarjs/prefer-immediate-return": "warn",
+      "sonarjs/prefer-single-boolean-return": "warn",
+      "sonarjs/no-collapsible-if": "warn",
+      // New rules in SonarJS v3 - disabled temporarily to allow migration
+      // These need to be addressed in a separate cleanup task
+      "sonarjs/pseudo-random": "error",
+      "sonarjs/no-clear-text-protocols": "error",
+      "sonarjs/prefer-read-only-props": "error",
+      "sonarjs/no-empty-test-file": "warn",
+      "sonarjs/no-nested-conditional": "off",
+      "sonarjs/no-commented-code": "warn",
+      "sonarjs/no-ignored-exceptions": "warn",
+      "sonarjs/todo-tag": "warn",
+      // Next takes forever and doesn't provide value
+      "sonarjs/aws-restricted-ip-admin-access": "off",
+
+      // ESLint comments
+      "@eslint-community/eslint-comments/require-description": "error",
+      "@eslint-community/eslint-comments/disable-enable-pair": "error",
+      "@eslint-community/eslint-comments/no-unlimited-disable": "error",
+
+      // Configuration enforcement - prevent direct process.env access
+      // All configuration should go through ConfigService or getStandaloneConfig()
+      // @see PROJECT_RULES.md
+      "no-restricted-syntax": [
+        "error",
+        {
+          selector:
+            "MemberExpression[object.name='process'][property.name='env']",
+          message:
+            "Direct process.env access is forbidden. Use ConfigService (in NestJS context) or getStandaloneConfig() (in Lambda handlers). See PROJECT_RULES.md.",
+        },
+      ],
+
+      // General rules
+      "no-extra-boolean-cast": "off",
+      "prefer-const": "error",
+      "no-param-reassign": "error",
+      "no-var": "error",
+      "brace-style": "error",
+      "prefer-template": "error",
+      radix: "error",
+      "space-before-blocks": "error",
+      "no-unused-vars": "off",
+
+      // TypeScript rules
+      "@typescript-eslint/no-explicit-any": "error",
+      "@typescript-eslint/no-unused-vars": [
+        "error",
+        {
+          argsIgnorePattern: "^_",
+          varsIgnorePattern: "^_|^unstable_settings$|^React$",
+          caughtErrorsIgnorePattern: "^_",
+        },
+      ],
+      // New rules in typescript-eslint v8 - disabled temporarily
+      "@typescript-eslint/no-require-imports": "off",
+      "@typescript-eslint/no-non-null-asserted-optional-chain": "off",
+      "@typescript-eslint/ban-ts-comment": "off",
+      "@typescript-eslint/prefer-as-const": "off",
+      "@typescript-eslint/no-empty-object-type": "off",
+      "@typescript-eslint/no-unused-expressions": "off",
+      "@typescript-eslint/no-unsafe-function-type": "off",
+
+      // Functional rules - configured to avoid type-checking requirements
+      // Rules that require type info are disabled
+      "functional/no-mixed-types": "off",
+      "functional/functional-parameters": "off",
+      "functional/prefer-immutable-types": "off",
+      "functional/no-expression-statements": "off",
+      "functional/no-conditional-statements": "off",
+      "functional/prefer-property-signatures": "off",
+      "functional/no-return-void": "off",
+      "functional/no-throw-statements": "off",
+      "functional/prefer-readonly-type": "off",
+      "functional/prefer-tacit": "off",
+      "functional/readonly-type": "off",
+      "functional/type-declaration-immutability": "off",
+      // Rules we want - these work without type info
+      // NOTE: functional/immutable-data requires type info - enabled in TypeScript file config below
+      "functional/immutable-data": "off",
+      "functional/no-let": "error",
+      // Disabled: NestJS relies heavily on classes for modules, controllers, services, etc.
+      "functional/no-classes": "off",
+
+      // JSDoc rules
+      "jsdoc/require-jsdoc": [
+        "error",
+        {
+          require: {
+            FunctionDeclaration: true,
+            MethodDefinition: false,
+            ClassDeclaration: false,
+            ArrowFunctionExpression: false,
+            FunctionExpression: false,
+          },
+          contexts: [
+            "TSInterfaceDeclaration",
+            "TSTypeAliasDeclaration",
+            "VariableDeclaration[declarations.0.init.type='ArrowFunctionExpression']:has([id.name=/^[A-Z]/])",
+          ],
+        },
+      ],
+      "jsdoc/require-param-description": "error",
+      "jsdoc/require-returns-description": "error",
+      "jsdoc/require-property-description": "error",
+      "jsdoc/check-tag-names": ["error", { definedTags: ["remarks"] }],
+      "jsdoc/no-types": "off",
+      "jsdoc/require-param-type": "off",
+      "jsdoc/require-returns-type": "off",
+      "jsdoc/require-property-type": "off",
+    },
+  },
+
+  // JavaScript files override
+  {
+    files: ["**/*.js"],
+    rules: {
+      "sonarjs/cognitive-complexity": "off",
+      "@typescript-eslint/no-require-imports": "off", // CommonJS files
+    },
+  },
+
+  // Shared hooks and components
+  {
+    files: ["hooks/shared/**/*", "components/shared/**/*"],
+    rules: {
+      "no-restricted-imports": "off",
+    },
+  },
+
+  // Test files and Jest setup
+  {
+    files: [
+      "**/*.test.js",
+      "**/*.test.ts",
+      "**/*.spec.js",
+      "**/*.spec.ts",
+      "jest.setup.js",
+      "jest.setup.ts",
+      "jest.setup.pre.js",
+      "**/__tests__/*",
+    ],
+    languageOptions: {
+      globals: {
+        ...globals.jest,
+      },
+    },
+    rules: {
+      "@typescript-eslint/no-explicit-any": "off",
+      // Tests often need to mutate state for mocks, setup, and assertions
+      "functional/immutable-data": "off",
+      // Tests need to manipulate process.env for environment setup
+      "no-restricted-syntax": "off",
+    },
+  },
+
+  // TypeScript files - enable type-checked linting
+  {
+    files: ["**/*.ts"],
+    // languageOptions: {
+    //   parserOptions: {
+    //     projectService: true,
+    //     tsconfigRootDir: __dirname,
+    //   },
+    // },
+    rules: {
+      // Enable immutable-data rule now that type-checking is available
+      "functional/immutable-data": [
+        "off",
+        {
+          ignoreClasses: true,
+          ignoreImmediateMutation: true,
+          ignoreNonConstDeclarations: {
+            treatParametersAsConst: true,
+          },
+          ignoreAccessorPattern: ["*.displayName", "*.current", "*.value"],
+        },
+      ],
+    },
+  },
+
+  // TypeScript test files - disable immutable-data (must come after TypeScript config)
+  {
+    files: ["**/*.test.ts", "**/*.spec.ts"],
+    rules: {
+      // Tests often need to mutate state for mocks, setup, and assertions
+      "functional/immutable-data": "off",
+    },
+  },
+
+  // Configuration file - allowed to use process.env (single source of truth)
+  {
+    files: ["src/config/configuration.ts"],
+    rules: {
+      // This is the ONLY file allowed to access process.env directly
+      // All other code must use ConfigService or getStandaloneConfig()
+      "no-restricted-syntax": "off",
+    },
+  },
+];

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

@@ -0,0 +1,57 @@
+{
+  "ignores": [
+    "build/**",
+    "dist/**",
+    ".build/**",
+    ".esbuild/**",
+    ".serverless/**",
+    ".webpack/**",
+    "_warmup/**",
+
+    "node_modules/**",
+    "**/node_modules/**",
+
+    "src/graphql/**",
+    "src/graphql.ts",
+    "src/graphql-generated/**",
+    "src/generated/**",
+    "graphql/**",
+    "graphql-generated/**",
+    "generated/**",
+    "components/ui/**",
+
+    "coverage/**",
+    "**/*spec.ts",
+    "resolver-test.setup.ts",
+    "**/*.factory.ts",
+    "**/test-utils/**",
+    "**/test/**",
+    "**/database/migrations/**",
+    "cypress/**",
+    "e2e/**",
+    "playwright-report/**",
+    ".lighthouseci/**",
+
+    ".expo/**",
+    ".github/**",
+    "public/**",
+    ".dead/**",
+    "example/**",
+    "tmp/**",
+    ".vscode/**",
+
+    "*.config.js",
+    "*.config.mjs",
+    "babel.config.js",
+    "metro.config.js",
+    "webpack.*.js",
+    "*.d.ts",
+    "esbuild.plugins.js",
+
+    "projects/**/scripts/**",
+    "scripts/**",
+
+    "lib/**/*.js",
+    "cdk.out/**"
+  ]
+}

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

@@ -0,0 +1,5 @@
+{
+  "cognitiveComplexity": 10,
+  "maxLines": 300,
+  "maxLinesView": 300
+}

package/typescript/github-rulesets/base.json

@@ -0,0 +1,106 @@
+{
+  "id": 11725285,
+  "name": "base",
+  "target": "branch",
+  "source_type": "Repository",
+  "source": "gunnertech/thumbwar-backend",
+  "enforcement": "active",
+  "conditions": {
+    "ref_name": {
+      "exclude": [],
+      "include": [
+        "~DEFAULT_BRANCH",
+        "refs/heads/dev",
+        "refs/heads/main",
+        "refs/heads/staging"
+      ]
+    }
+  },
+  "rules": [
+    {
+      "type": "deletion"
+    },
+    {
+      "type": "non_fast_forward"
+    },
+    {
+      "type": "code_quality",
+      "parameters": {
+        "severity": "warnings"
+      }
+    },
+    {
+      "type": "pull_request",
+      "parameters": {
+        "required_approving_review_count": 0,
+        "dismiss_stale_reviews_on_push": false,
+        "required_reviewers": [],
+        "require_code_owner_review": false,
+        "require_last_push_approval": false,
+        "required_review_thread_resolution": true,
+        "allowed_merge_methods": [
+          "merge",
+          "squash",
+          "rebase"
+        ]
+      }
+    },
+    {
+      "type": "required_status_checks",
+      "parameters": {
+        "strict_required_status_checks_policy": true,
+        "do_not_enforce_on_create": true,
+        "required_status_checks": [
+          {
+            "context": "GitGuardian Security Checks",
+            "integration_id": 46505
+          },
+          {
+            "context": "CodeRabbit",
+            "integration_id": 347564
+          },
+          {
+            "context": "🔍 Quality Checks / 🧪 Run Unit Tests",
+            "integration_id": 15368
+          },
+          {
+            "context": "🔍 Quality Checks / 🧪 Run Integration Tests",
+            "integration_id": 15368
+          },
+          {
+            "context": "🔍 Quality Checks / 🔍 Type Check",
+            "integration_id": 15368
+          },
+          {
+            "context": "🔍 Quality Checks / 🏗️ Build",
+            "integration_id": 15368
+          },
+          {
+            "context": "🔍 Quality Checks / 📐 Check Formatting",
+            "integration_id": 15368
+          },
+          {
+            "context": "🔍 Quality Checks / 🧹 Lint",
+            "integration_id": 15368
+          },
+          {
+            "context": "🔍 Quality Checks / 🔒 Security Scan",
+            "integration_id": 15368
+          }
+        ]
+      }
+    }
+  ],
+  "bypass_actors": [
+    {
+      "actor_id": null,
+      "actor_type": "DeployKey",
+      "bypass_mode": "always"
+    },
+    {
+      "actor_id": null,
+      "actor_type": "OrganizationAdmin",
+      "bypass_mode": "always"
+    }
+  ]
+}

package/typescript/merge/.claude/settings.json

@@ -0,0 +1,28 @@
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "startup",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "$CLAUDE_PROJECT_DIR/.claude/hooks/install_pkgs.sh",
+            "timeout": 480
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "Write|Edit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "$CLAUDE_PROJECT_DIR/.claude/hooks/format-on-edit.sh",
+            "timeout": 10
+          }
+        ]
+      }
+    ]
+  }
+}

package/typescript/merge/package.json

@@ -0,0 +1,71 @@
+{
+  "lint-staged": {
+    "*.{js,ts,tsx}": [
+      "eslint --quiet --cache --fix"
+    ],
+    "*.{js,ts,jsx,tsx,html,css,scss,yaml,yml,graphql}": [
+      "prettier --write"
+    ]
+  },
+  "engines": {
+    "npm": "please-use-bun",
+    "yarn": "please-use-bun",
+    "bun": ">= 1.3.5",
+    "node": "22.21.1"
+  },
+  "config": {
+    "commitizen": {
+      "path": "./node_modules/cz-conventional-changelog"
+    }
+  },
+  "scripts": {
+    "//docs": "The following commands MUST be defined for CI/CD to work properly - even if they're no-ops.",
+    "lint": "eslint . --quiet",
+    "lint:fix": "eslint . --fix",
+    "build": "tsc --noEmit",
+    "test": "NODE_ENV=test jest --passWithNoTests",
+    "test:unit": "NODE_ENV=test jest --testPathIgnorePatterns=\"\\.integration\\.test\\.(ts|tsx)$\" --passWithNoTests",
+    "test:integration": "NODE_ENV=test jest --testPathPatterns=\"\\.integration\\.test\\.(ts|tsx)$\" --passWithNoTests",
+    "test:cov": "NODE_ENV=test jest --coverage",
+    "types:check": "tsc --noEmit",
+    "typecheck": "tsc --noEmit",
+    "format:check": "prettier --check .",
+    "format": "prettier --check . --write",
+    "prepare": "node -e \"if (process.env.INIT_CWD && process.env.INIT_CWD.includes('.serverless')) { process.exit(0); }\" && husky install || true",
+    "//end-docs": ""
+  },
+  "devDependencies": {
+    "@commitlint/cli": "^20.3.1",
+    "@commitlint/config-conventional": "^20.3.1",
+    "@eslint-community/eslint-plugin-eslint-comments": "^4.5.0",
+    "@eslint/eslintrc": "^3.2.0",
+    "@eslint/js": "^9.39.0",
+    "@istanbuljs/nyc-config-typescript": "^1.0.2",
+    "@jest/test-sequencer": "^30.2.0",
+    "@types/jest": "^30.0.0",
+    "commitizen": "^4.3.0",
+    "cz-conventional-changelog": "^3.3.0",
+    "eslint": "^9.39.0",
+    "eslint-config-prettier": "^10.0.0",
+    "eslint-plugin-code-organization": "file:./eslint-plugin-code-organization",
+    "eslint-plugin-functional": "^9.0.0",
+    "eslint-plugin-jsdoc": "^61.5.0",
+    "eslint-plugin-prettier": "^5.5.0",
+    "eslint-plugin-sonarjs": "^3.0.0",
+    "husky": "^8.0.0",
+    "jest": "^30.0.0",
+    "jscodeshift": "0.15.2",
+    "lint-staged": "^16.2.7",
+    "prettier": "^3.3.3",
+    "standard-version": "^9.5.0",
+    "ts-jest": "^29.4.6",
+    "ts-morph": "^27.0.2",
+    "ts-node": "^10.9.2",
+    "typescript": "~5.9.2",
+    "typescript-eslint": "^8.0.0"
+  },
+  "resolutions": {},
+  "trustedDependencies": [
+    "@sentry/cli"
+  ]
+}