rex-claude 2.1.0 → 3.0.0

package/dist/skills/pr-review-loop/SKILL.md

@@ -0,0 +1,48 @@
+---
+name: pr-review-loop
+description: Automated PR review loop. Use when user says "review loop", "check PR comments", "fix PR feedback", or after creating a PR. Pulls comments from Gemini Code Assist and GitHub Copilot, fixes valid issues, and pushes updates.
+---
+
+# PR Review Loop
+
+After a PR is created or when asked to check PR feedback:
+
+1. **Pull review comments** from the PR:
+   ```bash
+   # Get PR number from current branch
+   PR_NUMBER=$(gh pr view --json number -q .number 2>/dev/null)
+
+   # Get all review comments (inline code comments)
+   gh api repos/{owner}/{repo}/pulls/$PR_NUMBER/comments --jq '.[] | "[\(.user.login)] \(.path):\(.line // .original_line) - \(.body)"'
+
+   # Get PR review summaries
+   gh pr view $PR_NUMBER --comments
+   ```
+
+2. **Categorize each comment**:
+   - **Valid fix needed**: bug, security issue, logic error, missing edge case
+   - **Good suggestion**: improvement worth making (cleaner code, better naming)
+   - **Dismiss**: style preference, false positive, or not applicable
+
+3. **Fix valid issues**:
+   - Address each valid comment with a targeted fix
+   - Run tests/lint after each fix to ensure no regressions
+   - Do NOT introduce unrelated changes
+
+4. **Commit and push fixes**:
+   - One commit for all review fixes: `fix: address PR review feedback`
+   - Push to the same branch (the PR updates automatically)
+
+5. **Report to user**:
+   - List what was fixed and why
+   - List what was dismissed and why
+   - Ask user to review the diff between v1 and v2
+
+IMPORTANT: Never force-push. Always regular push. The user reviews the incremental diff.
+
+## Auto-Learn
+
+After processing all comments, call `rex_learn` MCP tool for each valid fix:
+- category: `"lesson"`
+- fact: the reviewer feedback pattern + fix (e.g. "Copilot flagged missing null check on X — added guard clause")
+- Skip dismissed comments — only learn from actionable feedback

package/dist/skills/project-init/SKILL.md

@@ -0,0 +1,45 @@
+---
+name: project-init
+description: Initialize a new project with CLAUDE.md, proper git setup, and documentation cache. Use when starting a new project or onboarding an existing one.
+---
+
+# Project Init
+
+Initialize project: $ARGUMENTS (path or name)
+
+## For new projects
+1. Create project directory structure
+2. Generate `CLAUDE.md` with project-specific instructions
+3. Detect stack from user input, create appropriate config files
+4. Load relevant docs from `~/.claude/docs/` or fetch via Context7
+5. Git init, create `.gitignore`, initial commit
+6. Save project context: `rex_learn("Project X uses stack Y, structure Z", "architecture")`
+
+## For existing projects (onboarding)
+1. Read existing `package.json` / `composer.json` / config files to detect stack
+2. Read existing `CLAUDE.md` if present, or create one
+3. Scan project structure: key directories, entry points, routing
+4. Load relevant framework docs from `~/.claude/docs/`
+5. Call `rex_context(project_path)` for any past work history
+6. Report: stack, structure, key files, any issues noticed
+
+## CLAUDE.md template
+```markdown
+# Project Name
+
+## Stack
+- Framework: ...
+- Language: ...
+- Database: ...
+
+## Commands
+- Dev: `npm run dev`
+- Build: `npm run build`
+- Test: `npm test`
+- Lint: `npm run lint`
+
+## Key Files
+- Entry: ...
+- Config: ...
+- Routes: ...
+```

package/dist/skills/research/SKILL.md

@@ -0,0 +1,17 @@
+---
+name: research
+description: Deep research on a topic using web, docs, codebase. Returns concise actionable summary with sources. Use for architecture decisions, library comparisons, debugging.
+---
+
+# Research
+
+Research: $ARGUMENTS
+
+1. Check `~/.claude/docs/` for local cached documentation first
+2. Search web for documentation, best practices, recent changes
+3. Query Context7 for versioned library docs if relevant
+4. Search codebase for existing patterns and usage
+5. Synthesize into concise summary with recommendations
+
+Return: key findings, recommended approach, code references, links.
+Keep it actionable — the goal is to inform a decision, not write an essay.

package/dist/skills/rex-boot/SKILL.md

@@ -0,0 +1,64 @@
+---
+name: rex-boot
+description: Session startup companion. Auto-detects project, loads context, checks environment, asks what to work on. Runs automatically at every session start.
+---
+
+# REX Boot — Session Companion
+
+Tu es REX, senior dev companion de Kevin. A chaque début de session, tu fais ce briefing.
+
+## 1. Detect project context
+
+```bash
+# Where are we?
+pwd
+# Git state
+git branch --show-current 2>/dev/null
+git status --short 2>/dev/null | head -20
+# What project is this?
+cat package.json 2>/dev/null | jq '{name, scripts: .scripts | keys}' 2>/dev/null || cat composer.json 2>/dev/null | jq '.name' 2>/dev/null || echo "No project detected"
+```
+
+## 2. Check for in-progress work
+
+- Open branches with uncommitted changes?
+- Stashed work? (`git stash list`)
+- Open PRs on this repo? (`gh pr list --state open --limit 5`)
+- Failing CI on current branch?
+
+## 3. Load relevant context (ON-DEMAND only)
+
+- If a project is detected: call `rex_context(project_path)` for past session memory
+- If CLAUDE.md exists in project: mention its key points
+- Do NOT load `~/.claude/docs/` yet — wait until the task is clear
+
+## 4. Briefing to Kevin
+
+Format the output as a short briefing:
+
+```
+REX Boot
+---
+Projet: {name} ({path})
+Branche: {branch} | {clean/dirty}
+Stack: {detected stack}
+PR ouvertes: {count}
+Travail en cours: {stash/uncommitted summary}
+Mémoire REX: {brief context if found}
+---
+```
+
+## 5. Ask what to work on
+
+Use AskUserQuestion with smart options based on context:
+- If dirty git state → "Continuer le travail en cours?"
+- If open PRs → "Review la PR #{number}?"
+- If nothing → "Quel est l'objectif aujourd'hui?"
+
+Always offer these options contextually, not a generic menu.
+
+## Rules
+- Keep the boot FAST — no heavy operations, no doc loading
+- Max 3 bash commands total
+- If no project detected (home dir), just ask what Kevin veut faire
+- NEVER read doc files at boot — they load when the task is clear

package/dist/skills/spec-interview/SKILL.md

@@ -0,0 +1,20 @@
+---
+name: spec-interview
+description: Interview the user to write a complete feature spec before coding. Use when user says "/spec-interview" or "interview me about" a feature.
+disable-model-invocation: true
+---
+
+# Feature Spec Interview
+
+I want to build: $ARGUMENTS
+
+Interview me in depth using the AskUserQuestion tool. Cover:
+- Technical implementation and architecture choices
+- UI/UX and user flows
+- Edge cases and failure modes
+- Security implications
+- Performance at scale (10x users/requests)
+- Tradeoffs and alternatives considered
+
+Don't ask obvious questions. Dig into the hard parts I haven't thought through.
+Keep interviewing until we've covered everything, then write a complete spec to `SPEC.md`.

package/dist/skills/token-guard/SKILL.md

@@ -0,0 +1,26 @@
+---
+name: token-guard
+description: Optimize context usage. Audit what's loaded, suggest cleanup, compact if needed. Use when context feels bloated or before long sessions.
+---
+
+# Token Guard
+
+Audit and optimize the current context usage.
+
+## Checks
+1. **Files in context**: list all files that have been read this session
+2. **Redundant reads**: flag files read multiple times
+3. **Large outputs**: flag tool results > 200 lines that could have been scoped
+4. **Stale context**: flag information from early in session that's no longer relevant
+
+## Actions
+- Suggest `/compact` if context > 70%
+- Suggest `/clear` if switching to unrelated task
+- Identify docs/files that could be read on-demand instead of upfront
+- Flag any MCP server responses that returned excessive data
+
+## Reminders
+- Use subagents for heavy research (keeps main context clean)
+- Use `limit` and `offset` when reading large files
+- Use `head_limit` on Grep results
+- Prefer Glob/Grep over Agent for simple lookups

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rex-claude",
-  "version": "2.1.0",
+  "version": "3.0.0",
   "description": "Claude Code sous steroides — guards, health checks, memory RAG",
   "type": "module",
   "bin": {
@@ -36,8 +36,8 @@
   },
   "devDependencies": {
     "@rex/core": "workspace:*",
-    "tsup": "^8.0.0",
-    "typescript": "^5.7.0",
-    "@types/node": "^22.0.0"
+    "@types/node": "^25.3.3",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3"
   }
 }

package/dist/optimize-NE47FMOP.js

@@ -1,111 +0,0 @@
-#!/usr/bin/env node
-
-// src/optimize.ts
-import { readFileSync, existsSync } from "fs";
-import { join } from "path";
-import { homedir } from "os";
-var COLORS = {
-  reset: "\x1B[0m",
-  green: "\x1B[32m",
-  yellow: "\x1B[33m",
-  red: "\x1B[31m",
-  bold: "\x1B[1m",
-  dim: "\x1B[2m",
-  cyan: "\x1B[36m"
-};
-var OLLAMA_URL = process.env.OLLAMA_URL || "http://localhost:11434";
-var PREFERRED_MODELS = ["deepseek-r1:8b", "qwen2.5:1.5b", "llama3.2", "mistral"];
-async function detectModel() {
-  if (process.env.REX_OPTIMIZE_MODEL) return process.env.REX_OPTIMIZE_MODEL;
-  try {
-    const res = await fetch(`${OLLAMA_URL}/api/tags`);
-    const data = await res.json();
-    const available = data.models.map((m) => m.name);
-    for (const pref of PREFERRED_MODELS) {
-      if (available.some((a) => a.includes(pref.split(":")[0]))) {
-        return available.find((a) => a.includes(pref.split(":")[0]));
-      }
-    }
-    return available.find((a) => !a.includes("embed")) || available[0];
-  } catch {
-    return "llama3.2";
-  }
-}
-async function llm(prompt, system, model) {
-  const res = await fetch(`${OLLAMA_URL}/api/generate`, {
-    method: "POST",
-    headers: { "Content-Type": "application/json" },
-    body: JSON.stringify({
-      model: model || "qwen2.5:1.5b",
-      prompt,
-      system,
-      stream: false
-    })
-  });
-  if (!res.ok) throw new Error(`Ollama generate failed: ${res.status}`);
-  const data = await res.json();
-  return data.response;
-}
-async function optimize() {
-  const line = "\u2550".repeat(45);
-  console.log(`
-${line}`);
-  console.log(`${COLORS.bold}        REX OPTIMIZE${COLORS.reset}`);
-  console.log(`${line}
-`);
-  try {
-    const res = await fetch(`${OLLAMA_URL}/api/tags`);
-    if (!res.ok) throw new Error();
-  } catch {
-    console.error(`${COLORS.red}Ollama not running.${COLORS.reset} Start it: ollama serve`);
-    process.exit(1);
-  }
-  const cwd = process.cwd();
-  const projectClaudeMd = join(cwd, "CLAUDE.md");
-  const globalClaudeMd = join(homedir(), ".claude", "CLAUDE.md");
-  const target = existsSync(projectClaudeMd) ? projectClaudeMd : globalClaudeMd;
-  if (!existsSync(target)) {
-    console.error(`${COLORS.red}No CLAUDE.md found.${COLORS.reset}`);
-    process.exit(1);
-  }
-  const content = readFileSync(target, "utf-8");
-  const lines = content.split("\n").length;
-  const chars = content.length;
-  const tokens = Math.ceil(chars / 4);
-  console.log(`  ${COLORS.cyan}Target:${COLORS.reset} ${target}`);
-  console.log(`  ${COLORS.cyan}Size:${COLORS.reset} ${lines} lines, ~${tokens} tokens`);
-  console.log();
-  const model = await detectModel();
-  console.log(`  ${COLORS.dim}Analyzing with ${model}...${COLORS.reset}`);
-  const analysis = await llm(
-    `Analyze this CLAUDE.md file and provide specific suggestions to reduce its token count while keeping all important instructions. Focus on:
-1. Redundant or duplicate instructions
-2. Overly verbose sections that could be shortened
-3. Content that could be moved to separate files and @imported
-4. Dead or outdated references
-
-CLAUDE.md content:
----
-${content.slice(0, 6e3)}
----
-
-Provide a concise analysis with specific, actionable suggestions. Format each suggestion as:
-- [SECTION] What to change and why (estimated savings: N tokens)`,
-    "You are a technical editor that optimizes AI instruction files. Be direct and specific. Output only the analysis, no preamble.",
-    model
-  );
-  console.log(`
-${COLORS.bold}  Analysis:${COLORS.reset}
-`);
-  for (const line2 of analysis.split("\n")) {
-    console.log(`  ${line2}`);
-  }
-  console.log(`
-${COLORS.dim}\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500${COLORS.reset}`);
-  console.log(`
-  ${COLORS.dim}Tip: Run ${COLORS.cyan}rex optimize --apply${COLORS.reset}${COLORS.dim} to auto-apply suggestions${COLORS.reset}`);
-  console.log();
-}
-export {
-  optimize
-};