codemaxxing 0.2.1 → 0.3.1

package/dist/index.js

@@ -12,6 +12,7 @@ import { isGitRepo, getBranch, getStatus, getDiff, undoLastCommit } from "./util
 import { getTheme, listThemes, THEMES, DEFAULT_THEME } from "./themes.js";
 import { PROVIDERS, getCredentials, openRouterOAuth, anthropicSetupToken, importCodexToken, importQwenToken, copilotDeviceFlow } from "./utils/auth.js";
 import { listInstalledSkills, installSkill, removeSkill, getRegistrySkills, searchRegistry, createSkillScaffold, getActiveSkills, getActiveSkillCount } from "./utils/skills.js";
+import { listServers, addServer, removeServer, getConnectedServers } from "./utils/mcp.js";
 const VERSION = "0.1.9";
 // ── Helpers ──
 function formatTimeAgo(date) {
@@ -54,6 +55,15 @@ const SLASH_COMMANDS = [
     { cmd: "/skills search", desc: "search registry" },
     { cmd: "/skills on", desc: "enable skill for session" },
     { cmd: "/skills off", desc: "disable skill for session" },
+    { cmd: "/architect", desc: "toggle architect mode" },
+    { cmd: "/lint", desc: "show auto-lint status" },
+    { cmd: "/lint on", desc: "enable auto-lint" },
+    { cmd: "/lint off", desc: "disable auto-lint" },
+    { cmd: "/mcp", desc: "show MCP servers" },
+    { cmd: "/mcp tools", desc: "list MCP tools" },
+    { cmd: "/mcp add", desc: "add MCP server" },
+    { cmd: "/mcp remove", desc: "remove MCP server" },
+    { cmd: "/mcp reconnect", desc: "reconnect MCP servers" },
     { cmd: "/quit", desc: "exit" },
 ];
 const SPINNER_FRAMES = ["⣾", "⣽", "⣻", "⢿", "⡿", "⣟", "⣯", "⣷"];
@@ -236,6 +246,15 @@ function App() {
                 const savedStr = saved >= 1000 ? `${(saved / 1000).toFixed(1)}k` : String(saved);
                 addMsg("info", `📦 Context compressed (~${savedStr} tokens freed)`);
             },
+            onArchitectPlan: (plan) => {
+                addMsg("info", `🏗️ Architect Plan:\n${plan}`);
+            },
+            onLintResult: (file, errors) => {
+                addMsg("info", `🔍 Lint errors in ${file}:\n${errors}`);
+            },
+            onMCPStatus: (server, status) => {
+                addMsg("info", `🔌 MCP ${server}: ${status}`);
+            },
             contextCompressionThreshold: config.defaults.contextCompressionThreshold,
             onToolApproval: (name, args, diff) => {
                 return new Promise((resolve) => {
@@ -246,6 +265,18 @@ function App() {
         });
         // Initialize async context (repo map)
         await a.init();
+        // Show project rules in banner
+        const rulesSource = a.getProjectRulesSource();
+        if (rulesSource) {
+            info.push(`📋 ${rulesSource} loaded`);
+            setConnectionInfo([...info]);
+        }
+        // Show MCP server count
+        const mcpCount = a.getMCPServerCount();
+        if (mcpCount > 0) {
+            info.push(`🔌 ${mcpCount} MCP server${mcpCount > 1 ? "s" : ""} connected`);
+            setConnectionInfo([...info]);
+        }
         setAgent(a);
         setModelName(provider.model);
         providerRef.current = { baseUrl: provider.baseUrl, apiKey: provider.apiKey };
@@ -287,7 +318,7 @@ function App() {
                 // Commands that need args (like /commit, /model) — fill input instead of executing
                 if (selected.cmd === "/commit" || selected.cmd === "/model" || selected.cmd === "/session delete" ||
                     selected.cmd === "/skills install" || selected.cmd === "/skills remove" || selected.cmd === "/skills search" ||
-                    selected.cmd === "/skills on" || selected.cmd === "/skills off") {
+                    selected.cmd === "/skills on" || selected.cmd === "/skills off" || selected.cmd === "/architect") {
                     setInput(selected.cmd + " ");
                     setCmdIndex(0);
                     setInputKey((k) => k + 1);
@@ -347,6 +378,15 @@ function App() {
                 "  /git on    — enable auto-commits",
                 "  /git off   — disable auto-commits",
                 "  /skills    — manage skill packs",
+                "  /architect — toggle architect mode (plan then execute)",
+                "  /lint      — show auto-lint status & detected linter",
+                "  /lint on   — enable auto-lint",
+                "  /lint off  — disable auto-lint",
+                "  /mcp       — show MCP servers & status",
+                "  /mcp tools — list all MCP tools",
+                "  /mcp add   — add MCP server to global config",
+                "  /mcp remove — remove MCP server",
+                "  /mcp reconnect — reconnect all MCP servers",
                 "  /quit      — exit",
             ].join("\n"));
             return;
@@ -455,6 +495,130 @@ function App() {
             addMsg("info", `✅ Switched to theme: ${THEMES[themeName].name}`);
             return;
         }
+        // ── Architect commands (work without agent) ──
+        if (trimmed === "/architect") {
+            if (!agent) {
+                addMsg("info", "🏗️ Architect mode: no agent connected. Connect first with /login or /connect.");
+                return;
+            }
+            const current = agent.getArchitectModel();
+            if (current) {
+                agent.setArchitectModel(null);
+                addMsg("info", "🏗️ Architect mode OFF");
+            }
+            else {
+                // Use config default or a sensible default
+                const defaultModel = loadConfig().defaults.architectModel || agent.getModel();
+                agent.setArchitectModel(defaultModel);
+                addMsg("info", `🏗️ Architect mode ON (planner: ${defaultModel})`);
+            }
+            return;
+        }
+        if (trimmed.startsWith("/architect ")) {
+            const model = trimmed.replace("/architect ", "").trim();
+            if (!model) {
+                addMsg("info", "Usage: /architect <model> or /architect to toggle");
+                return;
+            }
+            if (agent) {
+                agent.setArchitectModel(model);
+                addMsg("info", `🏗️ Architect mode ON (planner: ${model})`);
+            }
+            else {
+                addMsg("info", "⚠ No agent connected. Connect first.");
+            }
+            return;
+        }
+        // ── Lint commands (work without agent) ──
+        if (trimmed === "/lint") {
+            const { detectLinter } = await import("./utils/lint.js");
+            const linter = detectLinter(process.cwd());
+            const enabled = agent ? agent.isAutoLintEnabled() : true;
+            if (linter) {
+                addMsg("info", `🔍 Auto-lint: ${enabled ? "ON" : "OFF"}\n  Detected: ${linter.name}\n  Command: ${linter.command} <file>`);
+            }
+            else {
+                addMsg("info", `🔍 Auto-lint: ${enabled ? "ON" : "OFF"}\n  No linter detected in this project.`);
+            }
+            return;
+        }
+        if (trimmed === "/lint on") {
+            if (agent)
+                agent.setAutoLint(true);
+            addMsg("info", "🔍 Auto-lint ON");
+            return;
+        }
+        if (trimmed === "/lint off") {
+            if (agent)
+                agent.setAutoLint(false);
+            addMsg("info", "🔍 Auto-lint OFF");
+            return;
+        }
+        // ── MCP commands (partially work without agent) ──
+        if (trimmed === "/mcp" || trimmed === "/mcp list") {
+            const servers = listServers(process.cwd());
+            if (servers.length === 0) {
+                addMsg("info", "🔌 No MCP servers configured.\n  Add one: /mcp add <name> <command> [args...]");
+            }
+            else {
+                const lines = servers.map((s) => {
+                    const status = s.connected ? `✔ connected (${s.toolCount} tools)` : "✗ not connected";
+                    return `  ${s.connected ? "●" : "○"} ${s.name} [${s.source}] — ${s.command}\n    ${status}`;
+                });
+                addMsg("info", `🔌 MCP Servers:\n${lines.join("\n")}`);
+            }
+            return;
+        }
+        if (trimmed === "/mcp tools") {
+            const servers = getConnectedServers();
+            if (servers.length === 0) {
+                addMsg("info", "🔌 No MCP servers connected.");
+                return;
+            }
+            const lines = [];
+            for (const server of servers) {
+                lines.push(`${server.name} (${server.tools.length} tools):`);
+                for (const tool of server.tools) {
+                    lines.push(`  • ${tool.name} — ${tool.description ?? "(no description)"}`);
+                }
+            }
+            addMsg("info", `🔌 MCP Tools:\n${lines.join("\n")}`);
+            return;
+        }
+        if (trimmed.startsWith("/mcp add ")) {
+            const parts = trimmed.replace("/mcp add ", "").trim().split(/\s+/);
+            if (parts.length < 2) {
+                addMsg("info", "Usage: /mcp add <name> <command> [args...]\n  Example: /mcp add github npx -y @modelcontextprotocol/server-github");
+                return;
+            }
+            const [name, command, ...cmdArgs] = parts;
+            const result = addServer(name, { command, args: cmdArgs.length > 0 ? cmdArgs : undefined });
+            addMsg(result.ok ? "info" : "error", result.ok ? `✅ ${result.message}` : `✗ ${result.message}`);
+            return;
+        }
+        if (trimmed.startsWith("/mcp remove ")) {
+            const name = trimmed.replace("/mcp remove ", "").trim();
+            if (!name) {
+                addMsg("info", "Usage: /mcp remove <name>");
+                return;
+            }
+            const result = removeServer(name);
+            addMsg(result.ok ? "info" : "error", result.ok ? `✅ ${result.message}` : `✗ ${result.message}`);
+            return;
+        }
+        if (trimmed === "/mcp reconnect") {
+            if (!agent) {
+                addMsg("info", "⚠ No agent connected. Connect first.");
+                return;
+            }
+            addMsg("info", "🔌 Reconnecting MCP servers...");
+            await agent.reconnectMCP();
+            const count = agent.getMCPServerCount();
+            addMsg("info", count > 0
+                ? `✅ ${count} MCP server${count > 1 ? "s" : ""} reconnected.`
+                : "No MCP servers connected.");
+            return;
+        }
         // Commands below require an active LLM connection
         if (!agent) {
             addMsg("info", "⚠ No LLM connected. Use /login to authenticate with a provider, or start a local server.");
@@ -641,8 +805,8 @@ function App() {
         setSpinnerMsg(SPINNER_MESSAGES[Math.floor(Math.random() * SPINNER_MESSAGES.length)]);
         try {
             // Response is built incrementally via onToken callback
-            // chat() returns the final text but we don't need to add it again
-            await agent.chat(trimmed);
+            // send() routes through architect if enabled, otherwise direct chat
+            await agent.send(trimmed);
         }
         catch (err) {
             addMsg("error", `Error: ${err.message}`);
@@ -1192,7 +1356,7 @@ function App() {
                         })(), modelName ? ` · 🤖 ${modelName}` : "", (() => {
                             const count = getActiveSkillCount(process.cwd(), sessionDisabledSkills);
                             return count > 0 ? ` · 🧠 ${count} skill${count !== 1 ? "s" : ""}` : "";
-                        })()] }) }))] }));
+                        })(), agent.getArchitectModel() ? " · 🏗️ architect" : ""] }) }))] }));
 }
 // Clear screen before render
 process.stdout.write("\x1B[2J\x1B[3J\x1B[H");

package/dist/utils/context.d.ts

@@ -1,3 +1,11 @@
+/**
+ * Load project rules from CODEMAXXING.md, .codemaxxing/CODEMAXXING.md, or .cursorrules
+ * Returns { content, source } or null if none found
+ */
+export declare function loadProjectRules(cwd: string): {
+    content: string;
+    source: string;
+} | null;
 /**
  * Build a project context string by scanning the working directory
  */
@@ -5,7 +13,7 @@ export declare function buildProjectContext(cwd: string): Promise<string>;
 /**
  * Get the system prompt for the coding agent
  */
-export declare function getSystemPrompt(projectContext: string, skillPrompts?: string): Promise<string>;
+export declare function getSystemPrompt(projectContext: string, skillPrompts?: string, projectRules?: string): Promise<string>;
 /**
  * Synchronous version for backwards compatibility (without repo map)
  * @deprecated Use async buildProjectContext instead

package/dist/utils/context.js

@@ -1,6 +1,30 @@
 import { existsSync, readFileSync, readdirSync, statSync } from "fs";
 import { join } from "path";
 import { buildRepoMap } from "./repomap.js";
+/**
+ * Load project rules from CODEMAXXING.md, .codemaxxing/CODEMAXXING.md, or .cursorrules
+ * Returns { content, source } or null if none found
+ */
+export function loadProjectRules(cwd) {
+    const candidates = [
+        { path: join(cwd, "CODEMAXXING.md"), source: "CODEMAXXING.md" },
+        { path: join(cwd, ".codemaxxing", "CODEMAXXING.md"), source: ".codemaxxing/CODEMAXXING.md" },
+        { path: join(cwd, ".cursorrules"), source: ".cursorrules" },
+    ];
+    for (const { path, source } of candidates) {
+        if (existsSync(path)) {
+            try {
+                const content = readFileSync(path, "utf-8").trim();
+                if (content)
+                    return { content, source };
+            }
+            catch {
+                // skip unreadable files
+            }
+        }
+    }
+    return null;
+}
 /**
  * Build a project context string by scanning the working directory
  */
@@ -26,14 +50,6 @@ export async function buildProjectContext(cwd) {
     if (found.length > 0) {
         lines.push(`Project files: ${found.join(", ")}`);
     }
-    // Read PIERRE.md if it exists (like QWEN.md — project context file)
-    const contextMd = join(cwd, "CODEMAXXING.md");
-    if (existsSync(contextMd)) {
-        const content = readFileSync(contextMd, "utf-8");
-        lines.push("\n--- CODEMAXXING.md (project context) ---");
-        lines.push(content.slice(0, 4000));
-        lines.push("--- end CODEMAXXING.md ---");
-    }
     // Read package.json for project info
     const pkgPath = join(cwd, "package.json");
     if (existsSync(pkgPath)) {
@@ -86,7 +102,7 @@ export async function buildProjectContext(cwd) {
 /**
  * Get the system prompt for the coding agent
  */
-export async function getSystemPrompt(projectContext, skillPrompts = "") {
+export async function getSystemPrompt(projectContext, skillPrompts = "", projectRules = "") {
     const base = `You are CODEMAXXING, an AI coding assistant running in the terminal.
 
 You help developers understand, write, debug, and refactor code. You have access to tools that let you read files, write files, list directories, search code, and run shell commands.
@@ -111,10 +127,14 @@ ${projectContext}
 - Use code blocks with language tags
 - Be direct and helpful
 - If the user asks to "just do it", skip explanations and execute`;
+    let prompt = base;
+    if (projectRules) {
+        prompt += "\n\n--- Project Rules (CODEMAXXING.md) ---\n" + projectRules + "\n--- End Project Rules ---";
+    }
     if (skillPrompts) {
-        return base + "\n\n## Active Skills\n" + skillPrompts;
+        prompt += "\n\n## Active Skills\n" + skillPrompts;
     }
-    return base;
+    return prompt;
 }
 /**
  * Synchronous version for backwards compatibility (without repo map)

package/dist/utils/lint.d.ts

@@ -0,0 +1,13 @@
+interface LinterInfo {
+    name: string;
+    command: string;
+}
+/**
+ * Detect the project linter based on config files in the working directory
+ */
+export declare function detectLinter(cwd: string): LinterInfo | null;
+/**
+ * Run the linter on a specific file and return errors (or null if clean)
+ */
+export declare function runLinter(linter: LinterInfo, filePath: string, cwd: string): string | null;
+export {};

package/dist/utils/lint.js

@@ -0,0 +1,108 @@
+import { existsSync } from "fs";
+import { join, extname } from "path";
+import { execSync } from "child_process";
+/**
+ * Detect the project linter based on config files in the working directory
+ */
+export function detectLinter(cwd) {
+    // JavaScript/TypeScript — check for biome first (faster), then eslint
+    if (existsSync(join(cwd, "biome.json")) || existsSync(join(cwd, "biome.jsonc"))) {
+        return { name: "Biome", command: "npx biome check" };
+    }
+    if (existsSync(join(cwd, ".eslintrc")) ||
+        existsSync(join(cwd, ".eslintrc.js")) ||
+        existsSync(join(cwd, ".eslintrc.cjs")) ||
+        existsSync(join(cwd, ".eslintrc.json")) ||
+        existsSync(join(cwd, ".eslintrc.yml")) ||
+        existsSync(join(cwd, "eslint.config.js")) ||
+        existsSync(join(cwd, "eslint.config.mjs")) ||
+        existsSync(join(cwd, "eslint.config.ts"))) {
+        return { name: "ESLint", command: "npx eslint" };
+    }
+    // Check package.json for eslint dependency as fallback
+    if (existsSync(join(cwd, "package.json"))) {
+        try {
+            const pkg = JSON.parse(require("fs").readFileSync(join(cwd, "package.json"), "utf-8"));
+            const allDeps = { ...pkg.dependencies, ...pkg.devDependencies };
+            if (allDeps["@biomejs/biome"]) {
+                return { name: "Biome", command: "npx biome check" };
+            }
+            if (allDeps["eslint"]) {
+                return { name: "ESLint", command: "npx eslint" };
+            }
+        }
+        catch {
+            // ignore
+        }
+    }
+    // Python — ruff (fast) or flake8/pylint
+    if (existsSync(join(cwd, "ruff.toml")) || existsSync(join(cwd, ".ruff.toml"))) {
+        return { name: "Ruff", command: "ruff check" };
+    }
+    if (existsSync(join(cwd, "pyproject.toml"))) {
+        try {
+            const content = require("fs").readFileSync(join(cwd, "pyproject.toml"), "utf-8");
+            if (content.includes("[tool.ruff]")) {
+                return { name: "Ruff", command: "ruff check" };
+            }
+        }
+        catch {
+            // ignore
+        }
+        return { name: "Ruff", command: "ruff check" };
+    }
+    // Rust
+    if (existsSync(join(cwd, "Cargo.toml"))) {
+        return { name: "Clippy", command: "cargo clippy --message-format=short --" };
+    }
+    // Go
+    if (existsSync(join(cwd, "go.mod"))) {
+        return { name: "golangci-lint", command: "golangci-lint run" };
+    }
+    return null;
+}
+/**
+ * Run the linter on a specific file and return errors (or null if clean)
+ */
+export function runLinter(linter, filePath, cwd) {
+    // Skip files that the linter can't handle
+    const ext = extname(filePath).toLowerCase();
+    const jsExts = new Set([".js", ".jsx", ".ts", ".tsx", ".mjs", ".cjs", ".mts", ".cts"]);
+    const pyExts = new Set([".py", ".pyi"]);
+    const rsExts = new Set([".rs"]);
+    const goExts = new Set([".go"]);
+    // Only lint files matching the linter's language
+    if ((linter.name === "ESLint" || linter.name === "Biome") && !jsExts.has(ext))
+        return null;
+    if (linter.name === "Ruff" && !pyExts.has(ext))
+        return null;
+    if (linter.name === "Clippy" && !rsExts.has(ext))
+        return null;
+    if (linter.name === "golangci-lint" && !goExts.has(ext))
+        return null;
+    try {
+        // Clippy works on the whole project, not individual files
+        const command = linter.name === "Clippy"
+            ? linter.command
+            : `${linter.command} ${filePath}`;
+        execSync(command, {
+            cwd,
+            encoding: "utf-8",
+            timeout: 15000,
+            stdio: ["pipe", "pipe", "pipe"],
+        });
+        return null; // No errors
+    }
+    catch (e) {
+        const output = (e.stdout || "") + (e.stderr || "");
+        const trimmed = output.trim();
+        if (!trimmed)
+            return null;
+        // Limit output to avoid flooding context
+        const lines = trimmed.split("\n");
+        if (lines.length > 30) {
+            return lines.slice(0, 30).join("\n") + `\n... (${lines.length - 30} more lines)`;
+        }
+        return trimmed;
+    }
+}

package/dist/utils/mcp.d.ts

@@ -0,0 +1,55 @@
+/**
+ * MCP (Model Context Protocol) client support
+ * Connects to external MCP servers and exposes their tools to the LLM agent.
+ */
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
+import type { ChatCompletionTool } from "openai/resources/chat/completions";
+export interface MCPServerConfig {
+    command: string;
+    args?: string[];
+    env?: Record<string, string>;
+}
+export interface MCPConfig {
+    mcpServers: Record<string, MCPServerConfig>;
+}
+export interface ConnectedServer {
+    name: string;
+    client: Client;
+    transport: StdioClientTransport;
+    tools: Array<{
+        name: string;
+        description?: string;
+        inputSchema: Record<string, unknown>;
+    }>;
+}
+export declare function loadMCPConfig(cwd: string): MCPConfig;
+export declare function connectToServers(config: MCPConfig, onStatus?: (name: string, status: string) => void): Promise<ConnectedServer[]>;
+export declare function disconnectAll(): Promise<void>;
+export declare function getConnectedServers(): ConnectedServer[];
+export declare function getAllMCPTools(servers: ConnectedServer[]): ChatCompletionTool[];
+/**
+ * Parse an MCP tool call name to extract server name and tool name.
+ * Format: mcp_<serverName>_<toolName>
+ * Server names can contain hyphens but not underscores (by convention).
+ */
+export declare function parseMCPToolName(fullName: string): {
+    serverName: string;
+    toolName: string;
+} | null;
+export declare function callMCPTool(serverName: string, toolName: string, args: Record<string, unknown>): Promise<string>;
+export declare function addServer(name: string, config: MCPServerConfig): {
+    ok: boolean;
+    message: string;
+};
+export declare function removeServer(name: string): {
+    ok: boolean;
+    message: string;
+};
+export declare function listServers(cwd: string): Array<{
+    name: string;
+    source: string;
+    command: string;
+    connected: boolean;
+    toolCount: number;
+}>;