rex-claude 1.1.7 → 2.0.0

package/dist/cli.js

@@ -1,504 +0,0 @@
-#!/usr/bin/env node
-import { cpSync, existsSync, mkdirSync, readFileSync, writeFileSync, copyFileSync } from 'fs';
-import { join, resolve, dirname } from 'path';
-import { homedir, platform } from 'os';
-import { execSync } from 'child_process';
-import { fileURLToPath } from 'url';
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const HOME = homedir();
-const CLAUDE_DIR = join(HOME, '.claude');
-const REX_MEMORY_DIR = join(HOME, '.rex-memory');
-const PKG_DIR = resolve(__dirname, '..');
-const GREEN = '\x1b[32m';
-const YELLOW = '\x1b[33m';
-const RED = '\x1b[31m';
-const CYAN = '\x1b[36m';
-const BOLD = '\x1b[1m';
-const DIM = '\x1b[2m';
-const RESET = '\x1b[0m';
-function log(icon, msg) { console.log(`  ${icon}  ${msg}`); }
-function ok(msg) { log(`${GREEN}✓${RESET}`, msg); }
-function warn(msg) { log(`${YELLOW}⚠${RESET}`, msg); }
-function info(msg) { log(`${CYAN}→${RESET}`, msg); }
-function fail(msg) { log(`${RED}✗${RESET}`, msg); }
-// ─── Helpers ──────────────────────────────────────────────────────────────────
-function safeWhich(bin, fallback) {
-    try {
-        return execSync(`which ${bin}`, { stdio: 'pipe' }).toString().trim() || fallback;
-    }
-    catch {
-        return fallback;
-    }
-}
-function ensureDir(dirPath) {
-    try {
-        mkdirSync(dirPath, { recursive: true });
-        return true;
-    }
-    catch (e) {
-        warn(`Impossible de créer ${dirPath}: ${e.message?.split('\n')[0]}`);
-        return false;
-    }
-}
-function safeReadFile(filePath) {
-    try {
-        return readFileSync(filePath, 'utf-8');
-    }
-    catch {
-        return null;
-    }
-}
-function safeWriteFile(filePath, content) {
-    try {
-        writeFileSync(filePath, content);
-        return true;
-    }
-    catch (e) {
-        warn(`Impossible d'écrire ${filePath}: ${e.message?.split('\n')[0]}`);
-        return false;
-    }
-}
-function backup(filePath) {
-    if (!existsSync(filePath))
-        return null;
-    const backupPath = `${filePath}.backup-${Date.now()}`;
-    try {
-        copyFileSync(filePath, backupPath);
-        return backupPath;
-    }
-    catch (e) {
-        warn(`Backup impossible pour ${filePath}: ${e.message?.split('\n')[0]}`);
-        return null;
-    }
-}
-function loadPlist(plistPath) {
-    try {
-        execSync(`launchctl unload "${plistPath}" 2>/dev/null; launchctl load "${plistPath}"`, { stdio: 'pipe' });
-    }
-    catch (e) {
-        throw new Error(`launchctl load: ${e.message?.split('\n')[0]}`);
-    }
-}
-// ─── Settings merge ───────────────────────────────────────────────────────────
-function deepMerge(target, source) {
-    const result = { ...target };
-    for (const key of Object.keys(source)) {
-        if (result[key] && typeof result[key] === 'object' && !Array.isArray(result[key]) &&
-            typeof source[key] === 'object' && !Array.isArray(source[key])) {
-            result[key] = deepMerge(result[key], source[key]);
-        }
-        else {
-            result[key] = source[key];
-        }
-    }
-    return result;
-}
-function mergeArraysByMatcher(existing, incoming) {
-    const result = [...existing];
-    for (const item of incoming) {
-        const idx = result.findIndex((e) => e.matcher === item.matcher);
-        if (idx === -1)
-            result.push(item);
-        else
-            result[idx] = item;
-    }
-    return result;
-}
-function mergeSettings(existingPath, rexSettingsPath) {
-    let existing = {};
-    if (existsSync(existingPath)) {
-        try {
-            existing = JSON.parse(readFileSync(existingPath, 'utf-8'));
-        }
-        catch {
-            warn('settings.json existant corrompu — réinitialisé');
-        }
-    }
-    let rex = {};
-    try {
-        rex = JSON.parse(readFileSync(rexSettingsPath, 'utf-8'));
-    }
-    catch (e) {
-        throw new Error(`settings.json REX illisible: ${e.message}`);
-    }
-    const merged = deepMerge(existing, rex);
-    if (rex.hooks) {
-        merged.hooks = { ...existing.hooks };
-        for (const hookType of Object.keys(rex.hooks)) {
-            if (Array.isArray(rex.hooks[hookType])) {
-                merged.hooks[hookType] = mergeArraysByMatcher(existing.hooks?.[hookType] || [], rex.hooks[hookType]);
-            }
-        }
-    }
-    if (!merged.mcpServers)
-        merged.mcpServers = {};
-    merged.mcpServers['rex-memory'] = {
-        command: 'node',
-        args: [join(REX_MEMORY_DIR, 'dist', 'server.js')]
-    };
-    return merged;
-}
-// ─── Install steps ────────────────────────────────────────────────────────────
-function installOllama(os) {
-    const ollamaPath = safeWhich('ollama', '');
-    if (!ollamaPath) {
-        warn('Ollama non installé — embeddings désactivés');
-        info('  brew install ollama && ollama pull nomic-embed-text');
-        return;
-    }
-    ok(`Ollama détecté (${ollamaPath})`);
-    if (os !== 'darwin') {
-        // Linux: systemd user service
-        info('Linux: démarrer Ollama manuellement ou via systemd');
-        info('  ollama serve &');
-        return;
-    }
-    const launchAgentsDir = join(HOME, 'Library', 'LaunchAgents');
-    if (!ensureDir(launchAgentsDir))
-        return;
-    const logsDir = join(REX_MEMORY_DIR, 'logs');
-    if (!ensureDir(logsDir))
-        return;
-    const plistPath = join(launchAgentsDir, 'com.rex.ollama.plist');
-    const plist = `<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
-<plist version="1.0">
-<dict>
-  <key>Label</key>
-  <string>com.rex.ollama</string>
-  <key>ProgramArguments</key>
-  <array>
-    <string>${ollamaPath}</string>
-    <string>serve</string>
-  </array>
-  <key>EnvironmentVariables</key>
-  <dict>
-    <key>HOME</key>
-    <string>${HOME}</string>
-    <key>OLLAMA_HOST</key>
-    <string>127.0.0.1:11434</string>
-  </dict>
-  <key>RunAtLoad</key>
-  <true/>
-  <key>KeepAlive</key>
-  <true/>
-  <key>StandardOutPath</key>
-  <string>${join(logsDir, 'ollama.log')}</string>
-  <key>StandardErrorPath</key>
-  <string>${join(logsDir, 'ollama-error.log')}</string>
-  <key>ThrottleInterval</key>
-  <integer>10</integer>
-</dict>
-</plist>`;
-    if (!safeWriteFile(plistPath, plist))
-        return;
-    try {
-        loadPlist(plistPath);
-        ok('LaunchAgent Ollama installé (keepalive au login)');
-    }
-    catch (e) {
-        warn(`LaunchAgent Ollama créé — chargement manuel: launchctl load "${plistPath}"`);
-        info(`  Erreur: ${e.message}`);
-    }
-}
-function installMemoryIngest(os) {
-    const ingestScript = join(REX_MEMORY_DIR, 'dist', 'ingest.js');
-    if (!existsSync(ingestScript)) {
-        warn('ingest.js non trouvé — ingest auto ignoré (rex-memory non compilé ?)');
-        return;
-    }
-    const logsDir = join(REX_MEMORY_DIR, 'logs');
-    if (!ensureDir(logsDir))
-        return;
-    const nodePath = safeWhich('node', process.execPath);
-    if (os === 'darwin') {
-        const launchAgentsDir = join(HOME, 'Library', 'LaunchAgents');
-        if (!ensureDir(launchAgentsDir))
-            return;
-        const plistPath = join(launchAgentsDir, 'com.rex.memory-ingest.plist');
-        const plist = `<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
-<plist version="1.0">
-<dict>
-  <key>Label</key>
-  <string>com.rex.memory-ingest</string>
-  <key>ProgramArguments</key>
-  <array>
-    <string>${nodePath}</string>
-    <string>${ingestScript}</string>
-  </array>
-  <key>EnvironmentVariables</key>
-  <dict>
-    <key>HOME</key>
-    <string>${HOME}</string>
-    <key>OLLAMA_URL</key>
-    <string>http://localhost:11434</string>
-  </dict>
-  <key>StartInterval</key>
-  <integer>21600</integer>
-  <key>StandardOutPath</key>
-  <string>${join(logsDir, 'ingest.log')}</string>
-  <key>StandardErrorPath</key>
-  <string>${join(logsDir, 'ingest-error.log')}</string>
-  <key>RunAtLoad</key>
-  <false/>
-</dict>
-</plist>`;
-        if (!safeWriteFile(plistPath, plist))
-            return;
-        try {
-            loadPlist(plistPath);
-            ok('LaunchAgent ingest mémoire installé (toutes les 6h)');
-        }
-        catch (e) {
-            warn(`LaunchAgent ingest créé — chargement manuel: launchctl load "${plistPath}"`);
-            info(`  Erreur: ${e.message}`);
-        }
-    }
-    else {
-        // Linux: write to temp file then pipe to crontab (avoids quoting hell)
-        try {
-            const existing = (() => {
-                try {
-                    return execSync('crontab -l', { stdio: 'pipe' }).toString();
-                }
-                catch {
-                    return '';
-                }
-            })();
-            if (existing.includes('rex-memory')) {
-                ok('Cron ingest mémoire déjà configuré');
-                return;
-            }
-            const cronLine = `0 */6 * * * ${nodePath} ${ingestScript} >> ${join(logsDir, 'ingest.log')} 2>&1`;
-            const tmpFile = `/tmp/rex-cron-${Date.now()}`;
-            writeFileSync(tmpFile, existing.trim() + '\n' + cronLine + '\n');
-            execSync(`crontab ${tmpFile}`, { stdio: 'pipe' });
-            execSync(`rm ${tmpFile}`, { stdio: 'pipe' });
-            ok('Cron ingest mémoire installé (toutes les 6h)');
-        }
-        catch (e) {
-            warn('Impossible de configurer le cron — ajouter manuellement :');
-            info(`  0 */6 * * * ${nodePath} ${ingestScript}`);
-        }
-    }
-}
-function installTmuxHook() {
-    try {
-        execSync('which tmux', { stdio: 'pipe' });
-    }
-    catch {
-        warn('tmux non installé — auto-start ignoré');
-        info('  brew install tmux');
-        return;
-    }
-    const shell = process.env.SHELL || '';
-    const candidates = [
-        shell.includes('zsh') ? join(HOME, '.zshrc') : null,
-        shell.includes('bash') ? join(HOME, '.bashrc') : null,
-        existsSync(join(HOME, '.zshrc')) ? join(HOME, '.zshrc') : null,
-        existsSync(join(HOME, '.bashrc')) ? join(HOME, '.bashrc') : null,
-    ].filter(Boolean);
-    const rcFile = candidates.find(f => existsSync(f)) ?? null;
-    if (!rcFile) {
-        warn('Shell RC introuvable — tmux auto-start ignoré');
-        info('  Ajouter manuellement dans ~/.zshrc ou ~/.bashrc');
-        return;
-    }
-    const existing = safeReadFile(rcFile);
-    if (existing === null) {
-        warn(`Impossible de lire ${rcFile} — tmux auto-start ignoré`);
-        return;
-    }
-    if (existing.includes('REX — Auto-start tmux')) {
-        ok('tmux auto-start déjà configuré');
-        return;
-    }
-    // Backup before modifying shell RC
-    const b = backup(rcFile);
-    if (b)
-        info(`${rcFile.replace(HOME, '~')} sauvegardé → ${b.replace(HOME, '~')}`);
-    const hook = `
-# REX — Auto-start tmux
-if command -v tmux &>/dev/null && [ -z "$TMUX" ] && [ "$TERM_PROGRAM" != "vscode" ] && [ "$TERM_PROGRAM" != "cursor" ]; then
-  tmux attach -t main 2>/dev/null || tmux new-session -s main
-fi
-`;
-    if (!safeWriteFile(rcFile, existing + hook)) {
-        warn('Écriture .zshrc échouée — tmux auto-start ignoré');
-        return;
-    }
-    ok(`tmux auto-start ajouté dans ${rcFile.replace(HOME, '~')}`);
-}
-// ─── Main install ─────────────────────────────────────────────────────────────
-function main() {
-    console.log(`\n${BOLD}${CYAN}  ╔══════════════════════════════╗${RESET}`);
-    console.log(`${BOLD}${CYAN}  ║   REX — Setup & Install      ║${RESET}`);
-    console.log(`${BOLD}${CYAN}  ╚══════════════════════════════╝${RESET}\n`);
-    const os = platform();
-    if (os !== 'darwin' && os !== 'linux') {
-        fail(`OS non supporté : ${os}. REX supporte macOS et Linux.`);
-        process.exit(1);
-    }
-    info(`OS détecté : ${os === 'darwin' ? 'macOS' : 'Linux'}`);
-    // 1. ~/.claude/
-    if (!ensureDir(CLAUDE_DIR))
-        process.exit(1);
-    ok('~/.claude/ prêt');
-    // 2. dotfiles → ~/.claude/
-    const dotfilesDir = join(PKG_DIR, 'dotfiles');
-    for (const dir of ['rules', 'skills', 'docs', 'commands', 'templates', 'agents']) {
-        const src = join(dotfilesDir, dir);
-        if (!existsSync(src))
-            continue;
-        try {
-            cpSync(src, join(CLAUDE_DIR, dir), { recursive: true, force: true });
-            ok(`Copié dotfiles/${dir}/ → ~/.claude/${dir}/`);
-        }
-        catch (e) {
-            warn(`Copie dotfiles/${dir} échouée: ${e.message?.split('\n')[0]}`);
-        }
-    }
-    // CLAUDE.md
-    const claudeMdSrc = join(dotfilesDir, 'CLAUDE.md');
-    if (existsSync(claudeMdSrc)) {
-        const claudeMdDest = join(CLAUDE_DIR, 'CLAUDE.md');
-        const b = backup(claudeMdDest);
-        if (b)
-            warn(`CLAUDE.md existant sauvegardé → ${b}`);
-        try {
-            copyFileSync(claudeMdSrc, claudeMdDest);
-            ok('Copié CLAUDE.md → ~/.claude/CLAUDE.md');
-        }
-        catch (e) {
-            warn(`Copie CLAUDE.md échouée: ${e.message?.split('\n')[0]}`);
-        }
-    }
-    // 3. settings.json
-    const settingsPath = join(CLAUDE_DIR, 'settings.json');
-    const rexSettingsPath = join(dotfilesDir, 'settings.json');
-    if (existsSync(rexSettingsPath)) {
-        try {
-            const merged = mergeSettings(settingsPath, rexSettingsPath);
-            if (!safeWriteFile(settingsPath, JSON.stringify(merged, null, 2) + '\n')) {
-                warn('settings.json non mis à jour');
-            }
-            else {
-                ok('Mergé settings.json (hooks, plugins, env, mcpServers)');
-            }
-        }
-        catch (e) {
-            warn(`Merge settings.json échoué: ${e.message?.split('\n')[0]}`);
-        }
-    }
-    // 4. memory/ → ~/.rex-memory/
-    const memorySrc = join(PKG_DIR, 'memory');
-    if (existsSync(memorySrc)) {
-        if (!ensureDir(REX_MEMORY_DIR) || !ensureDir(join(REX_MEMORY_DIR, 'db'))) {
-            warn('Création ~/.rex-memory/ échouée — MCP memory ignoré');
-        }
-        else {
-            for (const sub of ['src', 'package.json', 'package-lock.json', 'tsconfig.json']) {
-                const s = join(memorySrc, sub);
-                if (!existsSync(s))
-                    continue;
-                try {
-                    cpSync(s, join(REX_MEMORY_DIR, sub), { recursive: true, force: true });
-                }
-                catch (e) {
-                    warn(`Copie memory/${sub} échouée: ${e.message?.split('\n')[0]}`);
-                }
-            }
-            ok('Copié memory/ → ~/.rex-memory/');
-            // 5. npm install + build
-            info('Installation des dépendances rex-memory...');
-            try {
-                execSync('npm install --production=false', { cwd: REX_MEMORY_DIR, stdio: 'pipe' });
-                execSync('npm run build', { cwd: REX_MEMORY_DIR, stdio: 'pipe' });
-                ok('rex-memory compilé avec succès');
-            }
-            catch (e) {
-                fail(`Erreur compilation rex-memory: ${e.message?.split('\n')[0]}`);
-                info('  cd ~/.rex-memory && npm install && npm run build');
-            }
-        }
-    }
-    // 6. tmux config
-    const tmuxSrc = join(PKG_DIR, 'tmux', '.tmux.conf');
-    if (existsSync(tmuxSrc)) {
-        const tmuxDest = join(HOME, '.tmux.conf');
-        const b = backup(tmuxDest);
-        if (b)
-            warn(`~/.tmux.conf sauvegardé → ${b}`);
-        try {
-            copyFileSync(tmuxSrc, tmuxDest);
-            ok('Copié tmux/.tmux.conf → ~/.tmux.conf');
-        }
-        catch (e) {
-            warn(`Copie .tmux.conf échouée: ${e.message?.split('\n')[0]}`);
-        }
-    }
-    // 7. Hammerspoon (macOS only)
-    if (os === 'darwin') {
-        const activitySrc = join(PKG_DIR, 'activity');
-        if (existsSync(activitySrc)) {
-            const hsDir = join(HOME, '.hammerspoon');
-            if (existsSync(hsDir)) {
-                try {
-                    cpSync(activitySrc, hsDir, { recursive: true, force: true });
-                    ok('Copié activity/ → ~/.hammerspoon/');
-                }
-                catch (e) {
-                    warn(`Copie Hammerspoon échouée: ${e.message?.split('\n')[0]}`);
-                }
-            }
-            else {
-                warn('Hammerspoon non installé — activity logger ignoré');
-                info('  brew install --cask hammerspoon');
-            }
-        }
-    }
-    // 8. Ollama keepalive
-    installOllama(os);
-    // 9. Ingest mémoire (toutes les 6h)
-    installMemoryIngest(os);
-    // 10. tmux auto-start
-    installTmuxHook();
-    console.log(`\n${BOLD}${GREEN}  ══════════════════════════════${RESET}`);
-    console.log(`${BOLD}${GREEN}  REX installé avec succès !${RESET}`);
-    console.log(`${DIM}  ~/.claude/     → rules, skills, docs, commands${RESET}`);
-    console.log(`${DIM}  ~/.rex-memory/ → MCP memory server${RESET}`);
-    console.log(`${DIM}  ~/.tmux.conf   → tmux config${RESET}`);
-    console.log(`${DIM}  Ollama         → keepalive au login${RESET}`);
-    console.log(`${DIM}  Ingest mémoire → toutes les 6h${RESET}`);
-    console.log(`${DIM}  tmux           → auto-attach au démarrage terminal${RESET}`);
-    console.log(`${BOLD}${GREEN}  ══════════════════════════════${RESET}\n`);
-}
-// ─── Other commands ───────────────────────────────────────────────────────────
-function update() {
-    console.log(`\n${BOLD}${CYAN}  ╔══════════════════════════════╗${RESET}`);
-    console.log(`${BOLD}${CYAN}  ║   REX — Update               ║${RESET}`);
-    console.log(`${BOLD}${CYAN}  ╚══════════════════════════════╝${RESET}\n`);
-    info('Mise à jour de rex-claude depuis npm...');
-    try {
-        execSync('npm install -g rex-claude@latest', { stdio: 'inherit' });
-        ok('rex-claude mis à jour');
-        info('Relance "rex" pour appliquer les changements');
-    }
-    catch (e) {
-        fail(`Échec de la mise à jour: ${e.message?.split('\n')[0]}`);
-        process.exit(1);
-    }
-}
-// ─── Routing ──────────────────────────────────────────────────────────────────
-const cmd = process.argv[2];
-if (cmd === 'update') {
-    update();
-}
-else if (cmd === 'doctor' || cmd === 'setup') {
-    fail(`"rex ${cmd}" arrive bientôt — utilise "rex" pour l'instant`);
-    process.exit(1);
-}
-else {
-    main();
-}

package/dotfiles/CLAUDE.md

@@ -1,136 +0,0 @@
-# REX
-
-Tu es **REX**, l'assistant dev de Kevin (D-Studio). Réponds toujours en tant que REX.
-
-# TODO
-
-- [ ] Gateway Telegram : skill/script pour envoyer des messages via Garry ou Milo bot (BOT_TOKEN + CHAT_ID en env, appel HTTP Telegram Bot API). Permet à REX de notifier Kevin (lien PR, deploy done, etc.) via `/notify "message"`.
-
-# Global Instructions
-
-## Identity & Authorship
-
-- NEVER add "Co-Authored-By" lines in commits. All commits, PRs, issues, and branches must appear as made by the user (Keiy / kevin@dstudio.company) only.
-- NEVER mention Claude, AI, or any assistant in PR descriptions, commit messages, or issue comments.
-
-## Git & GitHub Workflow
-
-- Write concise, descriptive commit messages focused on the "why", not the "what".
-- Use conventional commit style when the project uses it (feat:, fix:, refactor:, etc.).
-- ALWAYS create a new branch for changes unless told otherwise. Branch names: kebab-case, descriptive (e.g., `fix/auth-token-refresh`, `feat/add-oauth`).
-- Before committing, run the project's linter/formatter if one exists.
-- See `~/.claude/rules/git-workflow.md` for full conventions.
-
-## PR Review Loop
-
-- After creating a PR, pull automated review comments from GitHub Copilot and Gemini Code Assist:
-  - `gh pr view <number> --comments`
-  - `gh api repos/{owner}/{repo}/pulls/{number}/comments`
-- Evaluate each comment: fix what's valid, dismiss what's not.
-- Push fixes, then notify the user to review the final diff between v1 and v2.
-
-## Code Quality
-
-- ALWAYS provide a way to verify work: run tests, build, lint, or take a screenshot for UI changes.
-- Prefer editing existing files over creating new ones to avoid file bloat.
-- Follow existing patterns in the codebase. Read before writing.
-- Do not add unnecessary comments, docstrings, or type annotations to code you didn't change.
-- Do not over-engineer. Only make changes that are directly requested or clearly necessary.
-
-## Task Approach
-
-- For non-trivial tasks: explore first (read relevant code), plan, then implement.
-- Break large problems into smaller chunks. One focused task per conversation when possible.
-- If stuck after 2 failed attempts at the same approach, stop and ask the user rather than brute-forcing.
-- Use subagents for research-heavy tasks to keep the main context clean.
-
-## Context Management
-
-- Start fresh conversations (`/clear`) between unrelated tasks.
-- When context gets long, use `/compact` to preserve only what matters.
-- Scope investigations narrowly. Don't read hundreds of files without purpose.
-
-## Contexte Kevin
-
-- Développeur full-stack solo (D-Studio)
-- Langue : français par défaut dans les réponses
-- Stack : TypeScript/Node, CakePHP, Angular/Ionic, Flutter, React/Next.js
-- Comptes IA : Claude Max (Opus+Sonnet), Claude Pro, ChatGPT Plus
-- Outils : GitHub, Monday, n8n, Bitwarden
-
-## Modèle switching
-
-- **Opus** → architecture, conception, missions complexes
-- **Sonnet** → code standard, PR, refactoring
-- **Haiku** → tâches répétitives, lecture de fichiers, quick fixes
-
-## Checklist obligatoire AVANT chaque feature (CRITICAL)
-
-Avant d'écrire du code, cocher chacun de ces 7 points :
-
-1. **Pagination** : liste > 20 items ? → limit+offset+total à l'API, Load More côté front
-2. **Fallback/erreur** : API vide ? null ? 500 ? timeout ? → TOUJOURS gérer tous les cas
-3. **État vide** : 0 résultat ? → TOUJOURS afficher un empty state
-4. **Chargement** : pendant le fetch ? → TOUJOURS afficher un loading state
-5. **Scalabilité** : 10x plus d'utilisateurs/items/requêtes ? → index DB, chunking, cache
-6. **Sync front/back** : bon endpoint, bons params, bonne forme de réponse ? → TOUJOURS vérifier
-7. **Effets de bord** : qui d'autre lit cet état ? → grep les consumers
-
-See `~/.claude/rules/defensive-engineering.md` for full details.
-
-## Documentation-First (CRITICAL)
-
-Avant de coder avec un framework/lib, lire `~/.claude/docs/{framework}.md` si existant, sinon fetcher via Context7.
-Après chaque projet, sauvegarder les patterns/gotchas découverts dans `~/.claude/docs/`.
-IMPORTANT : ne JAMAIS lire les fichiers docs/ au démarrage — uniquement quand le framework est pertinent pour la tâche.
-See `~/.claude/rules/docs-first.md` for details.
-
-## Optimisation tokens
-
-- Sous-agents pour la recherche lourde (garde le contexte principal propre)
-- `/compact` à ~70% du contexte (auto-compact configuré à 75%)
-- `/clear` entre projets différents
-- Séparer la documentation longue en `spec.md` / `tech.md` / `lessons.md` + `@imports`
-
-## Compaction instructions
-When compacting, always preserve:
-- Full list of modified files and their paths
-- Any test/build commands discovered for the current project
-- Active branch name and PR number if in progress
-- Any error messages seen during the session
-- Current task context and user requirements
-
-## Testing & Verification
-
-Après CHAQUE implémentation, OBLIGATOIRE avant de déclarer "done" :
-
-1. `npm run build` (ou commande équivalente) — zéro erreur
-2. Démarrer le dev server, confirmer que l'app charge (au minimum `curl` homepage → 200)
-3. Pour les changements UI : screenshot ou browser automation
-4. Pour SSR/Next.js : surveiller les hydration mismatches
-
-Si le projet a une suite de tests, la lancer après les changements.
-Corriger les causes racines, pas les symptômes. Ne jamais supprimer des tests pour les faire passer.
-
-See `~/.claude/rules/testing.md` for full testing conventions.
-
-## Security
-
-- Never commit secrets, API keys, .env files, or credentials.
-- Check for OWASP top 10 vulnerabilities in code you write.
-- If you notice insecure code while working, flag it to the user.
-- SQL : requêtes paramétrées uniquement, jamais de concaténation.
-
-See `~/.claude/rules/security.md` for full security rules.
-
----
-
-Rules directory: `~/.claude/rules/`
-- `defensive-engineering.md` — Scale, pagination, rate limits, error handling
-- `api-design.md` — REST conventions, response envelopes, status codes
-- `frontend.md` — Loading/empty/error states, SSR, hydration, forms, a11y
-- `security.md` — OWASP, secrets, SQL injection, XSS, CORS, auth
-- `testing.md` — Test discipline, build verification, mocking
-- `git-workflow.md` — Commit conventions, branching, PR process
-- `never-assume.md` — What never to assume, alternatives, mistake tracking
-- `docs-first.md` — Documentation-first rule, local cache, Context7/SiteMCP usage

package/dotfiles/commands/clean.md

@@ -1,8 +0,0 @@
-Find and remove dead code, stale TODOs, and unused dependencies.
-
-Steps:
-1. Search for unused exports and imports
-2. Find TODO/FIXME/HACK comments older than 30 days (check git blame)
-3. Check for unused dependencies in package.json (use depcheck if available)
-4. Find dead code: unreachable branches, unused functions
-5. Report findings — do NOT auto-delete without confirmation

package/dotfiles/commands/doc.md

@@ -1,8 +0,0 @@
-Generate or update project documentation.
-
-Steps:
-1. Read existing README.md
-2. Analyze project structure, scripts in package.json, environment variables needed
-3. Update or create sections: Setup, Development, Deployment, Environment Variables, Architecture
-4. Keep documentation concise and practical — no filler text
-5. If API routes exist, document them with method, path, params, response shape

package/dotfiles/commands/review.md

@@ -1,15 +0,0 @@
-Review the current branch's changes before creating a PR.
-
-Steps:
-1. Run `git diff main...HEAD` to see all changes
-2. Check for:
-   - Security issues (hardcoded secrets, SQL injection, XSS)
-   - Missing error handling (uncaught promises, missing try/catch)
-   - Missing loading/empty/error states in UI components
-   - Pagination missing on list endpoints
-   - TypeScript `any` or `@ts-ignore` without justification
-   - Console.log left in production code
-   - Unused imports or variables
-3. Run the project's linter if available
-4. Run `npm run build` to verify compilation
-5. Report findings with severity (critical/warning/info) and suggested fixes

package/dotfiles/commands/scaffold.md

@@ -1,11 +0,0 @@
-Create a new project from the template structure.
-
-Usage: /scaffold <project-name> <category>
-Categories: keiy (personal), dstudio (client), bots (telegram)
-
-Steps:
-1. Ask for project name and category if not provided
-2. Create directory in ~/Documents/Developer/<category>/<project-name>/
-3. Initialize with: git init, package.json, tsconfig.json, .env.example, .gitignore, .claudeignore
-4. Create CLAUDE.md from ~/.claude/templates/CLAUDE.md.template
-5. Report the created structure