fix(lint): add ESLint config and clear all errors

Ship .eslintrc.js (was missing — lint crashed like grok-faf-mcp),
drop unused imports/params, replace require('os') with imports,
createRequire for optional WASM kernel, and fix template/empty-catch
hotspots. Errors only — warnings not in scope.

Author: Wolfe-Jam

.eslintrc.js

@@ -0,0 +1,44 @@
+module.exports = {
+  root: true,
+  parser: '@typescript-eslint/parser',
+  parserOptions: {
+    ecmaVersion: 2022,
+    sourceType: 'module',
+    project: './tsconfig.json',
+  },
+  plugins: ['@typescript-eslint'],
+  extends: [
+    'eslint:recommended',
+    'plugin:@typescript-eslint/recommended',
+    'plugin:@typescript-eslint/recommended-requiring-type-checking',
+  ],
+  env: {
+    node: true,
+    es2022: true,
+  },
+  rules: {
+    // Championship rules - strict but sensible
+    // TODO: Upgrade these from 'warn' to 'error' after proper type safety refactor
+    '@typescript-eslint/no-explicit-any': 'warn',
+    '@typescript-eslint/no-unsafe-assignment': 'warn',
+    '@typescript-eslint/no-unsafe-member-access': 'warn',
+    '@typescript-eslint/no-unsafe-call': 'warn',
+    '@typescript-eslint/no-unsafe-return': 'warn',
+    '@typescript-eslint/no-unsafe-argument': 'warn',
+    '@typescript-eslint/require-await': 'warn',
+    '@typescript-eslint/explicit-function-return-type': 'off',
+    '@typescript-eslint/no-unused-vars': ['error', {
+      argsIgnorePattern: '^_',
+      varsIgnorePattern: '^_'
+    }],
+    '@typescript-eslint/no-floating-promises': 'error',
+    '@typescript-eslint/no-misused-promises': 'error',
+    'no-console': 'off', // We use console for MCP logging
+  },
+  ignorePatterns: [
+    'dist/**',
+    'node_modules/**',
+    '**/*.test.ts',
+    'jest.config.js',
+  ],
+};

src/faf-core/commands/audit.ts

@@ -26,7 +26,7 @@ export interface AuditResult {
   message: string;
 }
 
-export async function auditFafFile(projectPath?: string, options: AuditOptions = {}): Promise<AuditResult> {
+export async function auditFafFile(projectPath?: string, _options: AuditOptions = {}): Promise<AuditResult> {
   try {
     const fafPath = projectPath ? `${projectPath}/project.faf` : await findFafFile();
 

src/faf-core/commands/auto.ts

@@ -5,6 +5,7 @@
  */
 
 import { findFafFile } from '../utils/file-utils.js';
+import * as os from 'os';
 import { initFafFile, type InitResult } from './init.js';
 import { scoreFafFile, type ScoreResult } from './score.js';
 
@@ -35,7 +36,7 @@ export async function autoCommand(
 
   try {
     const targetDir = directory || process.cwd();
-    const homeDir = require('os').homedir();
+    const homeDir = os.homedir();
 
     // CRITICAL: Prevent running in home or root directory
     if (!directory && (targetDir === homeDir || targetDir === '/')) {

src/faf-core/commands/formats.ts

@@ -3,7 +3,6 @@
  * Lists all discovered formats in the project
  */
 
-import * as fs from 'fs';
 import * as path from 'path';
 import { fileExists } from '../utils/file-utils';
 
@@ -26,7 +25,7 @@ export interface FormatsResult {
   message: string;
 }
 
-export async function formatsCommand(projectPath?: string, options: FormatsOptions = {}): Promise<FormatsResult> {
+export async function formatsCommand(projectPath?: string, _options: FormatsOptions = {}): Promise<FormatsResult> {
   try {
     const projectRoot = projectPath || process.cwd();
     const startTime = Date.now();

src/faf-core/commands/init.ts

@@ -4,6 +4,7 @@
  */
 
 import { promises as fs } from 'fs';
+import * as os from 'os';
 import * as path from 'path';
 import { detectProjectType, fileExists } from '../utils/file-utils.js';
 import { generateFafFromProject } from '../generators/faf-generator-championship.js';
@@ -41,7 +42,7 @@ export async function initFafFile(
 
   try {
     const projectRoot = projectPath || process.cwd();
-    const homeDir = require('os').homedir();
+    const homeDir = os.homedir();
 
     // CRITICAL: Prevent running in home or root directory
     if (!projectPath && (projectRoot === homeDir || projectRoot === '/')) {

src/faf-core/commands/sync.ts

@@ -6,7 +6,7 @@
 import { promises as fs } from 'fs';
 import * as path from 'path';
 import { parse as parseYAML, stringify as stringifyYAML } from '../fix-once/yaml';
-import { findFafFile, findPackageJson, fileExists } from '../utils/file-utils';
+import { findFafFile, fileExists } from '../utils/file-utils';
 
 export interface SyncOptions {
   auto?: boolean;

src/faf-core/commands/update.ts

@@ -16,7 +16,7 @@ export interface UpdateResult {
   message: string;
 }
 
-export async function updateFafFile(projectPath?: string, options: UpdateOptions = {}): Promise<UpdateResult> {
+export async function updateFafFile(projectPath?: string, _options: UpdateOptions = {}): Promise<UpdateResult> {
   try {
     const fafPath = projectPath ? `${projectPath}/project.faf` : await findFafFile();
 

src/faf-core/commands/validate.ts

@@ -26,7 +26,7 @@ export interface ValidateResult {
   message: string;
 }
 
-export async function validateFafFile(projectPath?: string, options: ValidateOptions = {}): Promise<ValidateResult> {
+export async function validateFafFile(projectPath?: string, _options: ValidateOptions = {}): Promise<ValidateResult> {
   try {
     const fafPath = projectPath ? `${projectPath}/project.faf` : await findFafFile();
 

src/faf-core/compiler/faf-compiler.ts

@@ -8,10 +8,13 @@
 
 import { parse as parseYAML } from '../fix-once/yaml';
 import * as crypto from 'crypto';
+import { createRequire } from 'node:module';
 import { ChromeExtensionDetector } from '../utils/chrome-extension-detector';
 import { FabFormatsProcessor } from '../engines/fab-formats-processor';
 import * as path from 'path';
 
+const nodeRequire = createRequire(__filename);
+
 // ============================================================================
 // TYPE_DEFINITIONS - Single Source of Truth for Project Types
 // Ported from faf-cli v3.2.5 for scoring parity
@@ -958,8 +961,8 @@ export class FafCompiler {
     let mk4Total: number | null = null;
 
     try {
-      const kernel = require('faf-scoring-kernel');
-      const { stringify } = require('yaml');
+      const kernel = nodeRequire('faf-scoring-kernel') as { score_faf: (yaml: string) => string };
+      const { stringify } = nodeRequire('yaml') as { stringify: (data: unknown) => string };
 
       const projectType = this.detectProjectTypeFromContext(ast);
       const applicableSlots = getSlotsForType(projectType);

src/faf-core/engines/dependency-tsa.ts

@@ -11,7 +11,6 @@
 import * as fs from 'fs';
 import * as path from 'path';
 import { findSourceFiles } from '../utils/native-file-finder';
-import { execSync } from 'child_process';
 
 export interface DependencyInspection {
   package: string;