feat: configure Biome + Husky + lint-staged for code quality

- Add Biome v2.3.8 as unified formatter and linter (replaces Prettier + ESLint)
- Configure Husky v9.1.7 for git hooks
- Setup lint-staged v16.2.7 to run Biome on staged files
- Update VS Code settings to use Biome as default formatter
- Add comprehensive scripts: format, lint, check, check:ci
- Remove Prettier configuration files
- Update DEVELOPMENT.md with code quality guidelines

Benefits:
- 25x faster than Prettier (Rust-based)
- Single tool instead of 6+ dependencies
- Built-in TypeScript support
- Automatic formatting on commit

Author: AngelAlexQC

.husky/pre-commit

@@ -0,0 +1 @@
+bunx lint-staged

.prettierignore

@@ -1,7 +1,6 @@
 {
   "recommendations": [
-    "dbaeumer.vscode-eslint",
-    "esbenp.prettier-vscode",
+    "biomejs.biome",
     "oven.bun-vscode",
     "editorconfig.editorconfig",
     "github.vscode-github-actions",

.prettierrc

@@ -0,0 +1,151 @@
+{
+  "$schema": "https://biomejs.dev/schemas/2.3.8/schema.json",
+  "vcs": {
+    "enabled": true,
+    "clientKind": "git",
+    "useIgnoreFile": true
+  },
+  "files": {
+    "ignoreUnknown": true,
+    "includes": [
+      "**",
+      "!**/node_modules",
+      "!**/dist",
+      "!**/build",
+      "!**/.vscode",
+      "!**/coverage",
+      "!**/*.log"
+    ]
+  },
+  "formatter": {
+    "enabled": true,
+    "indentStyle": "space",
+    "indentWidth": 2,
+    "lineWidth": 100,
+    "lineEnding": "lf"
+  },
+  "linter": {
+    "enabled": true,
+    "rules": {
+      "recommended": true,
+      "complexity": {
+        "noExtraBooleanCast": "error",
+        "noUselessCatch": "error",
+        "noUselessTypeConstraint": "error",
+        "noAdjacentSpacesInRegex": "error",
+        "noArguments": "error"
+      },
+      "correctness": {
+        "noConstAssign": "error",
+        "noConstantCondition": "error",
+        "noEmptyCharacterClassInRegex": "error",
+        "noEmptyPattern": "error",
+        "noGlobalObjectCalls": "error",
+        "noInvalidConstructorSuper": "error",
+        "noNonoctalDecimalEscape": "error",
+        "noPrecisionLoss": "error",
+        "noSelfAssign": "error",
+        "noSetterReturn": "error",
+        "noSwitchDeclarations": "error",
+        "noUndeclaredVariables": "error",
+        "noUnreachable": "error",
+        "noUnreachableSuper": "error",
+        "noUnsafeFinally": "error",
+        "noUnsafeOptionalChaining": "error",
+        "noUnusedLabels": "error",
+        "noUnusedVariables": "error",
+        "useIsNan": "error",
+        "useValidForDirection": "error",
+        "useYield": "error",
+        "noInvalidBuiltinInstantiation": "error",
+        "useValidTypeof": "error"
+      },
+      "style": {
+        "useConst": "error"
+      },
+      "suspicious": {
+        "noAsyncPromiseExecutor": "error",
+        "noCatchAssign": "error",
+        "noClassAssign": "error",
+        "noCompareNegZero": "error",
+        "noControlCharactersInRegex": "error",
+        "noDebugger": "error",
+        "noDoubleEquals": "warn",
+        "noDuplicateCase": "error",
+        "noDuplicateClassMembers": "error",
+        "noDuplicateObjectKeys": "error",
+        "noDuplicateParameters": "error",
+        "noEmptyBlockStatements": "warn",
+        "noExplicitAny": "error",
+        "noExtraNonNullAssertion": "error",
+        "noFallthroughSwitchClause": "error",
+        "noFunctionAssign": "error",
+        "noGlobalAssign": "error",
+        "noImportAssign": "error",
+        "noMisleadingCharacterClass": "error",
+        "noMisleadingInstantiator": "error",
+        "noPrototypeBuiltins": "error",
+        "noRedeclare": "error",
+        "noShadowRestrictedNames": "error",
+        "noUnsafeDeclarationMerging": "error",
+        "noUnsafeNegation": "error",
+        "useGetterReturn": "error",
+        "noWith": "error",
+        "noVar": "error"
+      }
+    }
+  },
+  "javascript": {
+    "formatter": {
+      "quoteStyle": "single",
+      "jsxQuoteStyle": "double",
+      "quoteProperties": "asNeeded",
+      "trailingCommas": "es5",
+      "semicolons": "always",
+      "arrowParentheses": "always",
+      "bracketSpacing": true,
+      "bracketSameLine": false
+    },
+    "globals": ["Bun"]
+  },
+  "json": {
+    "formatter": {
+      "enabled": true,
+      "indentStyle": "space",
+      "indentWidth": 2,
+      "lineWidth": 100
+    }
+  },
+  "overrides": [
+    {
+      "includes": ["**/*.test.ts", "**/*.spec.ts", "**/__tests__/**"],
+      "linter": {
+        "rules": {
+          "suspicious": {
+            "noExplicitAny": "off"
+          }
+        }
+      }
+    },
+    {
+      "includes": ["**/build.ts"],
+      "linter": {
+        "rules": {
+          "suspicious": {
+            "useIterableCallbackReturn": "off"
+          }
+        }
+      }
+    },
+    {
+      "includes": ["**/src/**/*.ts", "**/cli.ts", "**/mcp-server.ts", "**/extension.ts"],
+      "linter": {
+        "rules": {
+          "complexity": {
+            "noStaticOnlyClass": "warn"
+          }
+        }
+      }
+    }
+  ]
+}

.vscode/extensions.json

@@ -65,7 +65,7 @@ try {
   const totalPackageTime = [coreResult, ...results].reduce((sum, r) => sum + r.duration, 0);
   const timeSaved = totalPackageTime - totalDuration;
 
-  console.log('\n' + '='.repeat(60));
+  console.log(`\n${'='.repeat(60)}`);
   console.log('🎉 All packages built successfully!');
   console.log(`⏱️  Total time: ${totalDuration}ms`);
   console.log(`💾 Time saved by parallelization: ~${timeSaved}ms`);

biome.json

@@ -70,6 +70,14 @@ bun run dev:extension  # Extension en modo watch
 
 # Type checking
 bun run typecheck
+
+# Code quality (Biome)
+bun run format         # Formatear todo el código
+bun run format:check   # Verificar formato sin modificar
+bun run lint           # Ejecutar linter
+bun run lint:fix       # Aplicar fixes automáticos del linter
+bun run check          # Formatear + lint + aplicar fixes
+bun run check:ci       # Check completo para CI (sin modificar)
 ```
 
 ### Por Paquete
@@ -288,10 +296,81 @@ bun run build
 - [ ] Backup/restore functionality
 - [ ] Settings panel en VS Code
 
+## Code Quality
+
+### Biome - Unified Linting & Formatting
+
+Cortex usa **Biome** como herramienta unificada para formateo y linting (reemplaza Prettier + ESLint).
+
+#### Configuración
+
+- **Archivo principal**: `biome.json` en la raíz
+- **Pre-commit hook**: Husky + lint-staged ejecutan Biome automáticamente
+- **VS Code**: La extensión `biomejs.biome` está recomendada
+
+#### Comandos útiles
+
+```bash
+# Formatear todo
+bun run format
+
+# Solo verificar formato
+bun run format:check
+
+# Linting
+bun run lint
+
+# Linting con fixes automáticos
+bun run lint:fix
+
+# Todo junto (format + lint + fix)
+bun run check
+
+# Check completo para CI (no modifica archivos)
+bun run check:ci
+```
+
+#### Reglas principales
+
+- **Quotes**: Single quotes (`'`)
+- **Semicolons**: Always (`;`)
+- **Line width**: 100 caracteres
+- **Indentation**: 2 espacios
+- **Trailing commas**: ES5 style
+- **TypeScript**: Preferir `node:` protocol para imports de Node.js
+
+#### Pre-commit Hook
+
+El hook de Husky ejecuta automáticamente Biome en archivos staged antes de cada commit:
+
+```bash
+# .husky/pre-commit
+bunx lint-staged
+```
+
+Configuración en `package.json`:
+```json
+{
+  "lint-staged": {
+    "*.{ts,tsx,js,jsx,json,jsonc}": [
+      "biome check --write --no-errors-on-unmatched --files-ignore-unknown=true"
+    ]
+  }
+}
+```
+
+#### Warnings vs Errors
+
+- **Errors**: Bloquean el commit (p.ej. sintaxis inválida)
+- **Warnings**: No bloquean pero deben corregirse (p.ej. `any` explícitos)
+
+Los warnings de `noExplicitAny` son comunes en el proyecto y están configurados como warnings en los archivos de código fuente.
+
 ## Resources
 
 - [VS Code Extension API](https://code.visualstudio.com/api)
 - [Bun Documentation](https://bun.sh/docs)
+- [Biome Documentation](https://biomejs.dev)
 - [MCP SDK](https://github.com/modelcontextprotocol/sdk)
 - [TreeView Guide](https://code.visualstudio.com/api/extension-guides/tree-view)
 - [Webview Guide](https://code.visualstudio.com/api/extension-guides/webview)

build.ts

@@ -19,7 +19,19 @@
     "test:core": "bun --cwd packages/core test",
     "test:watch": "bun test --watch --recursive",
     "test:coverage": "bun test --coverage --recursive",
-    "typecheck": "bunx tsc --noEmit"
+    "typecheck": "bunx tsc --noEmit",
+    "format": "biome format --write .",
+    "format:check": "biome format .",
+    "lint": "biome lint .",
+    "lint:fix": "biome lint --write .",
+    "check": "biome check --write .",
+    "check:ci": "biome ci .",
+    "prepare": "husky"
+  },
+  "lint-staged": {
+    "*.{ts,tsx,js,jsx,json,jsonc}": [
+      "biome check --write --no-errors-on-unmatched --files-ignore-unknown=true"
+    ]
   },
   "keywords": [
     "mcp",
@@ -42,9 +54,12 @@
   },
   "homepage": "https://github.com/AngelAlexQC/Cortex#readme",
   "devDependencies": {
+    "@biomejs/biome": "^2.3.8",
     "@types/bun": "^1.1.13",
     "@types/node": "^24.10.2",
     "@types/vscode": "^1.85.0",
+    "husky": "^9.1.7",
+    "lint-staged": "^16.2.7",
     "typescript": "^5.7.3"
   },
   "engines": {

docs/DEVELOPMENT.md

@@ -1,7 +1,7 @@
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { type Memory, MemoryStore } from '@cortex/core';
 import { Command } from 'commander';
-import { MemoryStore } from '@cortex/core';
-import { join } from 'path';
-import { homedir } from 'os';
 
 const program = new Command();
 const store = new MemoryStore();
@@ -40,7 +40,7 @@ program
   .action((query, options) => {
     const results = store.search(query, {
       type: options.type,
-      limit: parseInt(options.limit),
+      limit: parseInt(options.limit, 10),
     });
 
     if (results.length === 0) {
@@ -49,7 +49,7 @@ program
     }
 
     console.log(`\nFound ${results.length} memories:\n`);
-    results.forEach((memory: any, i: number) => {
+    results.forEach((memory: Memory, i: number) => {
       console.log(`${i + 1}. [${memory.type}] ${memory.content}`);
       console.log(`   Source: ${memory.source}`);
       console.log(`   Created: ${memory.createdAt}`);
@@ -69,7 +69,7 @@ program
   .action((options) => {
     const memories = store.list({
       type: options.type,
-      limit: parseInt(options.limit),
+      limit: parseInt(options.limit, 10),
     });
 
     if (memories.length === 0) {
@@ -78,7 +78,7 @@ program
     }
 
     console.log(`\n${memories.length} memories:\n`);
-    memories.forEach((memory: any, i: number) => {
+    memories.forEach((memory: Memory, i: number) => {
       console.log(`${i + 1}. [${memory.type}] ${memory.content}`);
       console.log(`   Source: ${memory.source}`);
       console.log('');
@@ -110,7 +110,7 @@ program
   .command('delete <id>')
   .description('Delete a memory by ID')
   .action((id) => {
-    const deleted = store.delete(parseInt(id));
+    const deleted = store.delete(parseInt(id, 10));
     if (deleted) {
       console.log(`✓ Memory ${id} deleted`);
     } else {

package.json

@@ -8,8 +8,6 @@
       "@cortex/core": ["../core/src/index.ts"]
     }
   },
-  "references": [
-    { "path": "../core" }
-  ],
+  "references": [{ "path": "../core" }],
   "include": ["src/**/*"]
 }