micro-models-agent 0.40.1 → 0.41.2

package/dist/core/bootstrap.js

@@ -3,6 +3,7 @@ import { Logger } from "../logger/app-logger";
 import { OpenAICompatProvider } from "../llm/openai-compat";
 import { ModelLoader } from "../llm/model-loader";
 import { ToolRegistry, registerAllTools } from "../tools/index";
+import { buildHiddenToolsBlock } from "../tools/hidden-tools-block";
 import { ToolExecutor } from "../tools/executor";
 import { ModuleRegistry } from "../modules/registry";
 import { PluginManager } from "../modules/plugins/manager";
@@ -13,19 +14,22 @@ import { ContextManager } from "../modules/context/manager";
 import { TokenCounter } from "../llm/token-counter";
 import { HallucinationDetector } from "../modules/hallucination/detector";
 import { ExecutionModule } from "../modules/execution/module";
-import { SessionStore, SessionManager, SessionModule, } from "../modules/session/index";
+import { SessionStore, SessionManager, SessionModule } from "../modules/session/index";
 import { UserProfile } from "../modules/user-profile/profile";
 import { SkillsLoader, SkillsModule } from "../modules/skills/index";
 import { BrowserModule } from "../modules/browser/index";
-import { LspModule } from "../modules/lsp/index";
+import { LspModule, DEFAULT_LSP_CONFIG } from "../modules/lsp/index";
+import { runStartupHealthCheck } from "../modules/lsp/startup-check";
 import { IndexerModule } from "../modules/indexer/index";
 import { MCPModule } from "../modules/mcp/index";
 import { MemoryModule } from "../modules/memory/module";
+import { MemoryStore } from "../modules/memory/store";
 import { setLocale } from "../i18n/index";
 import { Agent } from "./agent";
 import { homedir } from "os";
 import { join, resolve } from "path";
 import { existsSync, readFileSync, writeFileSync } from "fs";
+import { readMmaVersion } from "./version";
 export function buildSystemInfo(config, baseDir, profileCompressed) {
     const now = new Date().toISOString().replace("T", " ").slice(0, 19);
     const isWin = profileCompressed.toLowerCase().includes("win32");
@@ -42,12 +46,20 @@ export function buildSystemInfo(config, baseDir, profileCompressed) {
     // files and tests (observed: model wasted 10+ iterations installing tsx
     // instead of running `bun file.ts`).
     lines.push(`Runtime: Bun is available — run TypeScript directly with "bun <file.ts>" and tests with "bun test" (no tsx/ts-node/npm install needed for that).`);
-    lines.push(`Bash: use "workdir" param instead of "cd dir && cmd". One command per call. Long-running processes: pass "background: true" (id immediately), otherwise auto-backgrounded after a few seconds — check with process_log.`, `DEVELOPMENT RULES (strict): 1) install deps BEFORE writing source (npm/pip/cargo, verify lockfile exists; never import uninstalled packages); 2) framework/toolkit init BEFORE app code; 3) follow plan sequentially, after each step verify deliverables exist with real content, then "plan update step=N status=done"; 4) verify work on disk + command output — don't assume success; 5) no premature work (no files/imports for future steps); 6) stuck after 2+ failures: STOP, try a different approach, write files directly, ask the user.`, `PLAN QUALITY: each step = CONCRETE deliverables (exact file paths with extensions, exact packages, exact commands). Vague steps ("Setup the project") forbidden. Cover init → deps → framework → code → verification. 5-8 steps.`);
+    lines.push(`Bash: use "workdir" param instead of "cd dir && cmd". One command per call. Long-running processes: pass "background: true" (id immediately), otherwise auto-backgrounded after a few seconds — check with process_log.`, `DEVELOPMENT RULES (strict): 1) install deps BEFORE writing source (npm/pip/cargo, verify lockfile exists; never import uninstalled packages); 2) framework/toolkit init BEFORE app code; 3) follow plan sequentially, after each step verify deliverables exist with real content, then "plan update step=N status=done"; 4) verify work on disk + command output — don't assume success; 5) no premature work (no files/imports for future steps); 6) stuck after 2+ failures: STOP, try a different approach, write files directly, ask the user.`, `VERIFY EVERY WRITE: after write_file or edit_file, if the tool result contains NO [LSP errors], [LSP warnings], [Syntax check failed], or [Project typecheck failed] feedback, call the "lsp_check" tool on the file you just wrote BEFORE marking the step done. Never assume a written file is valid — prove it.`, `PLAN QUALITY: each step = CONCRETE deliverables (exact file paths with extensions, exact packages, exact commands). Vague steps ("Setup the project") forbidden. Cover init → deps → framework → code → verification. 5-8 steps.`, `For "check/fix errors" tasks, each verification step must name the exact command that proves the errors are gone — "bun run build", "bun test", or the "lsp_check" tool — and the step is done only after that check reports clean.`);
     if (config.autoPlan) {
         lines.push(`Plan rule (MANDATORY): any task creating files, installing packages, or requiring multiple actions MUST create a plan with the "plan" tool BEFORE starting. Each step = a concrete deliverable.`);
     }
-    const hasMCP = config.mcpServers &&
-        Object.values(config.mcpServers).some((s) => s.enabled !== false);
+    // When a bug is described in terms of runtime behavior (what happens when
+    // the app runs), the fix is only provable by REPRODUCING it — running the
+    // app/build/browser and comparing against actual output. The model decides
+    // when this applies (no keyword classification). Stale dev servers started
+    // before a config/deps change keep the OLD pipeline in memory and still
+    // throw the original error (observed: old vite on 5173-5176 kept failing
+    // postcss after the fix was on disk, while a fresh server on 5177 was
+    // clean) — the fix is only real when the USER's running server is clean.
+    lines.push(`Runtime verification: when a bug is described in terms of runtime behavior (what happens when the app runs), reproduce it — run the app / build / browser tool — and confirm the fix against actual runtime output before calling "plan update step=N status=done". Check existing servers first with process_list/process_log: a stale dev server started BEFORE your change still runs the old pipeline and keeps failing even after the files on disk are fixed. Restart or kill it (process_kill) and verify the exact endpoint/port the user reported — a fresh server on a new port does NOT prove the user's error is gone.`);
+    const hasMCP = config.mcpServers && Object.values(config.mcpServers).some((s) => s.enabled !== false);
     if (hasMCP) {
         lines.push(`MCP servers are available — use the named MCP tools (prefixed mcp__) to query external services.`);
     }
@@ -55,9 +67,7 @@ export function buildSystemInfo(config, baseDir, profileCompressed) {
 }
 export async function bootstrap(configDir, projectDir, noAgentsMd, exitOnComplete) {
     const dir = configDir || join(homedir(), ".mma");
-    const projectConfigPath = projectDir
-        ? join(projectDir, ".mmrc")
-        : join(process.cwd(), ".mmrc");
+    const projectConfigPath = projectDir ? join(projectDir, ".mmrc") : join(process.cwd(), ".mmrc");
     const config = loadConfig({ configDir: dir, projectConfigPath });
     setLocale(config.locale);
     // Update global audit notifier with config
@@ -126,7 +136,9 @@ export async function bootstrap(configDir, projectDir, noAgentsMd, exitOnComplet
     const skillsBudget = Math.floor(config.contextWindow * config.skills.budget);
     const skillsModule = new SkillsModule(availableSkills, skillsBudget);
     const toolRegistry = new ToolRegistry();
-    registerAllTools(toolRegistry, skillsModule);
+    registerAllTools(toolRegistry, skillsModule, {
+        enableOnDemand: config.tools?.enableOnDemand,
+    });
     const pluginManager = new PluginManager();
     const systemInfoContent = buildSystemInfo(config, baseDir, profile.compress());
     const systemInfoPrompt = {
@@ -153,6 +165,17 @@ export async function bootstrap(configDir, projectDir, noAgentsMd, exitOnComplet
         sessionManager.create();
     }
     const tokenCounter = new TokenCounter(config.model);
+    // Mutable set of active tool tags, shared between the agent loop and the
+    // `enable_tools` tool. The loop re-reads it every iteration to recompute the
+    // LLM-visible tool set; enable_tools pushes tags into it. When on-demand
+    // enabling is disabled the tag set stays empty, which restores the legacy
+    // all-tools behavior (getAllForLLM returns everything for empty tags).
+    const enableOnDemand = config.tools?.enableOnDemand !== false;
+    const activeToolTags = enableOnDemand
+        ? config.tools?.defaultTags
+            ? [...config.tools.defaultTags]
+            : []
+        : [];
     const contextManager = new ContextManager(config.contextWindow, config.contextBudget, tokenCounter);
     const toolCtx = {
         config,
@@ -160,6 +183,7 @@ export async function bootstrap(configDir, projectDir, noAgentsMd, exitOnComplet
         logger,
         exitOnComplete,
         contextManager,
+        activeToolTags,
         sessionId: sessionManager.getActiveMeta()?.id,
         sessionContext: sessionManager.getSessionContext() ?? undefined,
         recursionDepth: 0,
@@ -206,7 +230,8 @@ export async function bootstrap(configDir, projectDir, noAgentsMd, exitOnComplet
     const mcpModule = new MCPModule(config);
     await mcpModule.initialize();
     moduleRegistry.register(mcpModule);
-    const memoryModule = new MemoryModule(join(dir, "memory"));
+    const memoryStore = new MemoryStore(join(dir, "memory"));
+    const memoryModule = new MemoryModule(memoryStore);
     moduleRegistry.register(memoryModule);
     if (config.browser.enabled) {
         const browserModule = new BrowserModule();
@@ -224,6 +249,16 @@ export async function bootstrap(configDir, projectDir, noAgentsMd, exitOnComplet
         lspPlugin.isBuiltin = true;
         pluginManager.register(lspPlugin);
     }
+    // Startup health check: scan project for existing errors so the model
+    // knows the baseline before it starts working. Skip for one-shot runs and
+    // test environments. Started in the background (never awaited) so the REPL
+    // banner is not blocked by `npx tsc` on the whole project; the Agent awaits
+    // it before the first LLM call via `lazyPromptBlocks` (already resolved by
+    // the time the user types in the interactive REPL).
+    let startupCheckBlock = null;
+    const startupCheckPromise = !exitOnComplete && process.env.NODE_ENV !== "test"
+        ? runStartupHealthCheck(config.lsp ?? DEFAULT_LSP_CONFIG, baseDir)
+        : Promise.resolve(null);
     const moduleTools = moduleRegistry.collectToolDefinitions();
     for (const tool of moduleTools) {
         toolRegistry.register(tool);
@@ -258,8 +293,15 @@ export async function bootstrap(configDir, projectDir, noAgentsMd, exitOnComplet
     const pluginLoader = new PluginLoader();
     const globalPluginsDir = join(homedir(), ".mma", "plugins");
     const projectPluginsDir = join(baseDir, ".mma", "plugins");
-    pluginLoader.loadFromDir(globalPluginsDir, pluginManager, logger);
-    pluginLoader.loadFromDir(projectPluginsDir, pluginManager, logger);
+    const mmaVersion = readMmaVersion();
+    pluginLoader.loadFromDir(globalPluginsDir, pluginManager, logger, {
+        source: "global",
+        mmaVersion,
+    });
+    pluginLoader.loadFromDir(projectPluginsDir, pluginManager, logger, {
+        source: "project",
+        mmaVersion,
+    });
     contextManager.onCompact = (summary) => {
         const meta = sessionManager.getActiveMeta();
         if (!meta || !config.session.autoSave)
@@ -271,6 +313,11 @@ export async function bootstrap(configDir, projectDir, noAgentsMd, exitOnComplet
             timestamp: new Date().toISOString(),
         });
     };
+    // Carry the active plan (id, progress, current step) into the compaction
+    // summary so a 9B model doesn't re-create the plan from scratch right after
+    // compaction (observed: ses_msvuao0h — plan_e07pb2 (1/6) discarded for a
+    // fresh plan_xzq9xe the same iteration the old plan was still visible).
+    contextManager.setPlanSummaryProvider(() => execModule.getPlanSummary());
     const agentsMdBlocks = [];
     const skipAgentsMd = noAgentsMd === true;
     if (!skipAgentsMd) {
@@ -295,7 +342,7 @@ export async function bootstrap(configDir, projectDir, noAgentsMd, exitOnComplet
     }
     const promptBlocks = [
         systemInfoPrompt,
-        ...moduleRegistry.collectPromptBlocks(),
+        ...moduleRegistry.collectPromptBlocks(["indexer"]),
         ...agentsMdBlocks,
     ];
     const agentDeps = {
@@ -307,6 +354,7 @@ export async function bootstrap(configDir, projectDir, noAgentsMd, exitOnComplet
         hallucinationDetector,
         logger,
         baseDir,
+        toolTags: activeToolTags,
         promptBlocks,
         getDynamicPromptBlocks: () => {
             const blocks = [];
@@ -316,10 +364,29 @@ export async function bootstrap(configDir, projectDir, noAgentsMd, exitOnComplet
             const skillsBlock = skillsModule.getSystemPromptBlock();
             if (skillsBlock)
                 blocks.push(skillsBlock);
+            const mapBlock = indexerModule.getSystemPromptBlock();
+            if (mapBlock)
+                blocks.push(mapBlock);
+            const hiddenToolsBlock = buildHiddenToolsBlock(toolRegistry.getAll(), activeToolTags);
+            if (hiddenToolsBlock) {
+                blocks.push({
+                    content: hiddenToolsBlock,
+                    priority: "low",
+                    essential: false,
+                    estimatedTokens: Math.ceil(hiddenToolsBlock.length / 4),
+                });
+            }
             return blocks;
         },
         finalAudit: () => execModule.runFinalAudit(),
+        lazyPromptBlocks: async () => {
+            if (startupCheckBlock)
+                return [startupCheckBlock];
+            startupCheckBlock = (await startupCheckPromise) ?? null;
+            return startupCheckBlock ? [startupCheckBlock] : [];
+        },
         sessionManager,
+        memoryStore,
         exitOnComplete,
     };
     const agent = new Agent(agentDeps);

package/dist/core/index.js

@@ -1,2 +1,2 @@
-export { PromptBuilder } from './prompt-builder';
-export { Agent } from './agent';
+export { PromptBuilder } from "./prompt-builder";
+export { Agent } from "./agent";

package/dist/core/prompt-builder.js

@@ -4,6 +4,10 @@ const PRIORITY_ORDER = {
     normal: 2,
     low: 3,
 };
+function blockLabel(content) {
+    const firstLine = content.split("\n")[0].trim();
+    return firstLine.length > 70 ? firstLine.slice(0, 67) + "..." : firstLine;
+}
 export class PromptBuilder {
     blocks = [];
     budget;
@@ -33,23 +37,40 @@ export class PromptBuilder {
         let usedTokens = 0;
         const included = [];
         const excluded = [];
+        const blocks = [];
         for (const block of essential) {
             included.push(block.content);
             usedTokens += block.estimatedTokens;
+            blocks.push({
+                label: blockLabel(block.content),
+                priority: block.priority,
+                essential: true,
+                tokens: block.estimatedTokens,
+                included: true,
+            });
         }
         for (const block of nonEssential) {
             const tokens = block.estimatedTokens;
-            if (usedTokens + tokens <= this.budget) {
+            const fits = usedTokens + tokens <= this.budget;
+            if (fits) {
                 included.push(block.content);
                 usedTokens += tokens;
             }
             else {
                 excluded.push(block.content);
             }
+            blocks.push({
+                label: blockLabel(block.content),
+                priority: block.priority,
+                essential: false,
+                tokens,
+                included: fits,
+            });
         }
         return {
-            prompt: included.join('\n\n'),
+            prompt: included.join("\n\n"),
             excluded,
+            blocks,
         };
     }
 }

package/dist/core/session-logger.js

@@ -118,14 +118,56 @@ export class SessionLogger {
             iteration,
         });
     }
-    logCompaction(content, iteration, contextTokens, contextLimit) {
+    logCompaction(info) {
         this.session?.appendLog({
             ts: new Date().toISOString(),
             type: "compaction",
-            content,
+            content: `${info.reason}, iteration ${info.iteration}`,
+            iteration: info.iteration,
+            reason: info.reason,
+            tokensBefore: info.tokensBefore,
+            tokensAfter: info.tokensAfter,
+            qualityBefore: info.qualityBefore,
+            qualityAfter: info.qualityAfter,
+            messagesBefore: info.messagesBefore,
+            messagesAfter: info.messagesAfter,
+            removedTurns: info.removedTurns,
+            keptTurns: info.keptTurns,
+            summary: info.summary,
+        });
+    }
+    logContext(info) {
+        this.session?.appendLog({
+            ts: new Date().toISOString(),
+            type: "context",
+            content: info.kind === "start"
+                ? "context snapshot at session start"
+                : `context at iteration ${info.iteration}`,
+            iteration: info.iteration,
+            window: info.window,
+            systemBudget: info.systemBudget,
+            reserveBudget: info.reserveBudget,
+            historyBudget: info.historyBudget,
+            systemTokens: info.systemTokens,
+            toolTokens: info.toolTokens,
+            contextTokens: info.tokens,
+            quality: info.quality,
+            messageCount: info.messageCount,
+            compactionCount: info.compactionCount,
+            iterationsSinceCompaction: info.iterationsSinceCompaction,
+            blocks: info.blocks,
+        });
+    }
+    logLlmUsage(iteration, usage) {
+        this.session?.appendLog({
+            ts: new Date().toISOString(),
+            type: "llm_usage",
             iteration,
-            ...(contextTokens !== undefined ? { contextTokens } : {}),
-            ...(contextLimit !== undefined ? { contextLimit } : {}),
+            promptTokens: usage.promptTokens,
+            completionTokens: usage.completionTokens,
+            totalTokens: usage.totalTokens,
+            source: usage.source,
+            durationMs: usage.durationMs,
         });
     }
     logError(message) {

package/dist/core/version.js

@@ -0,0 +1,24 @@
+import { existsSync, readFileSync } from "fs";
+import { join, dirname } from "path";
+import { fileURLToPath } from "url";
+/**
+ * Read the MMA version from package.json at runtime (never a static import —
+ * bundlers inline a stale value at build time, see design rule #12).
+ */
+export function readMmaVersion() {
+    const here = dirname(fileURLToPath(import.meta.url));
+    const candidates = [join(here, "..", "..", "package.json"), join(here, "..", "package.json")];
+    for (const p of candidates) {
+        if (existsSync(p)) {
+            try {
+                const raw = JSON.parse(readFileSync(p, "utf8"));
+                if (raw.version)
+                    return raw.version;
+            }
+            catch {
+                // Broken package.json — fall through to the next candidate
+            }
+        }
+    }
+    return "0.0.0";
+}

package/dist/i18n/en.json

@@ -28,6 +28,7 @@
     "error.response_blocked": "Response blocked: {reason}",
     "error.max_iters": "Max iterations ({max}) reached",
     "error.empty_response": "Model returned an empty response after retries",
+    "error.audit_failed": "Task could not be verified as complete: {summary}",
     "error.grep_failed": "Grep failed: {message}",
     "error.search_failed": "Search failed: {message}",
     "error.fetch_failed": "Fetch failed: {message}",
@@ -86,9 +87,12 @@
     "tool.friendly.web_search": "Web search",
     "tool.friendly.web_fetch": "Fetching page",
     "tool.friendly.web_browse": "Browsing page",
+    "tool.friendly.download_file": "Downloading file",
     "tool.web_fetch_result": "Fetched page: {url} — {chars} chars, {lines} lines{truncated}",
     "tool.web_browse_result": "Browsed page: {url} — {chars} chars, {lines} lines{truncated}",
     "tool.web_search_result": "Search results for \"{query}\" — {count} results",
+    "tool.downloaded": "Downloaded {url} \u2192 {path} ({size} bytes, {type})",
+    "tool.download_too_large": "Download blocked: file exceeds the {max} bytes limit",
     "tool.friendly.browser": "Browser",
     "tool.friendly.subagent": "Sub-agent task",
     "tool.friendly.question": "Question to user",
@@ -96,8 +100,10 @@
     "tool.friendly.search_history": "Searching history",
     "tool.friendly.pipeline_run": "Running pipeline",
     "tool.friendly.mcp_call": "MCP call",
+    "tool.friendly.lsp_check": "Checking code",
     "tool.truncated": "[Truncated: {tokens} tokens removed]",
     "tool.subagent_queued": "Sub-agent task queued: {task}",
+    "tool.subagent_artifact": "Sub-agent completed. Full result saved to artifact: {path}\nIterations: {iterations}\nSummary:\n{summary}",
     "tool.pipeline_started": "Pipeline \"{name}\" execution started. Pipeline engine is a stub \u2014 run dispatched.",
     "tool.mcp_call": "MCP call: {server}/{tool} with {args}",
     "tool.action_required": "Action is required.",
@@ -118,6 +124,8 @@
     "tool.question.unanswered": "Unanswered",
     "tool.question.answered": "User has answered your questions: {formatted}. You can now continue with the user's answers in mind.",
     "tool.name_or_task": "Provide either \"name\" or \"task\" parameter",
+    "tool.chunk_query_no_query": "chunk_query: a query string is required.",
+    "tool.chunk_query_no_input": "chunk_query: provide input_path or text.",
     "tool.invalid_params": "Invalid parameters",
     "tool.skill_budget": "Skill \"{name}\" loaded ({tokens} tokens, {remaining} remaining in skills budget). Skill content is now in system prompt — no need to reload after context compaction.",
     "tool.skill_available_hint": "Available skills",
@@ -135,6 +143,7 @@
     "proc.started": "Started background process {id} (PID {pid}).\nCommand: {command}",
     "proc.promoted_hint": "Command still running after {ms} ms — moved to the background",
     "proc.manage_hint": "Check output: process_log id={id}. Stop it: process_kill id={id}. List all: process_list.",
+    "proc.output_preview": "First output:\n{lines}",
     "proc.none": "No background processes running.",
     "proc.not_found": "Process not found: {id}",
     "proc.killed": "Process {id} (PID {pid}) killed.",
@@ -157,12 +166,20 @@
     "plan.title_steps": "Plan \"{title}\" created with {count} steps",
     "plan.step_marked": "Step {step} marked as {status}",
     "plan.aborted": "Plan aborted",
+    "plan.completed_archived": "Plan {id} is complete ({done}/{total} steps) — archived. You may create a new plan for new work (plan create), or reply with your final answer.",
     "plan.unknown_action": "Unknown plan action: {action}",
     "plan.updated": "Plan updated: {title} ({steps} steps)",
     "plan.acknowledged": "Plan {action}: acknowledged",
     "plan.step_status": "Step {step}: {status}",
     "plan.no_active": "No active plan",
     "plan.step_not_found": "Step not found",
+    "plan.step_already_done": "Step {step} is already done — nothing to do. Plan progress:",
+    "plan.order_blocked": "Cannot mark step {step} done: step {first} (\"{desc}\") is not finished yet. Complete earlier steps first, or mark step {first} status=skipped if it is not needed.",
+    "plan.deliverables_missing": "Cannot mark step {step} done: the files it names do not exist yet: {files}. Create these files first (or mark the step status=skipped if they are not actually needed).",
+    "plan.kinds_mismatch": "kinds array length must match steps",
+    "plan.kinds_invalid": "Invalid step kind(s): {kinds}. Use \"create\" or \"delete\".",
+    "plan.kinds_not_array": "kinds must be an array of \"create\" or \"delete\"",
+    "plan.deliverables_remain": "Cannot mark step {step} done: the files it names still exist: {files}. This step is kind=delete — delete these files first (or set status=skipped if they should stay).",
     "plan.show_header": "Plan status:",
     "plan.show_empty": "(plan has no steps)",
     "plan.list_header": "Plans:",
@@ -172,9 +189,14 @@
     "plan.switched": "Switched to plan {id}: {title}",
     "plan.replanned": "Plan re-planned: {kept} completed steps kept, {steps} new steps added",
     "plan.replan_no_steps": "Provide new steps for re-planning",
+    "plan.active_in_progress": "Cannot create a new plan: active plan {id} already has progress ({done}/{total} done, current: step {current}). Resume it — use \"plan show\" to view, then continue working. To replace it, call \"plan abort\" first, then \"plan create\" again.",
+    "plan.id_ignored": "note: plan ids are auto-generated; use \"plan switch\" to activate an existing plan by id.",
+    "plan.existing_fresh": "note: the previous active plan had no progress and was preserved as a draft.",
     "todo.added": "Added {count} todo(s): {items}",
     "todo.marked_done": "Marked {count} item(s) as done",
     "todo.no_active": "No active todos",
+    "todo.no_items": "No todo items specified — provide items to mark done",
+    "todo.subtask_not_found": "No matching sub-task(s) found for: {items}",
     "todo.unknown_action": "Unknown todo action: {action}",
     "todo.acknowledged": "Todo acknowledged",
     "verify.passed": "Verification passed",
@@ -184,6 +206,14 @@
     "verify.script_passed": "Script '{script}' passed",
     "verify.script_failed": "Script '{script}' failed: {message}",
     "verify.syntax_error": "Syntax error in: {path}",
+    "verify.no_files": "Step {step} has no named files to verify — run a real check instead (bash: bun run build / bun test / lsp_check) and confirm the result.",
+    "lsp.unavailable": "static checks are unavailable (server not found). Verify via the project's own build/test instead.",
+    "lsp.check_disabled": "LSP checks are disabled in the config.",
+    "lsp.check_no_path": "Provide a path (file or directory) to check.",
+    "lsp.check_notfound": "Path not found: {path}",
+    "lsp.check_unsupported": "No LSP server configured for: {path}",
+    "lsp.check_clean": "No errors or warnings detected ({count} file(s) checked).",
+    "lsp.startup_header": "[Existing project errors (checked at session start) — fix these before continuing]:",
     "cli.description": "Micro Models Agent \u2014 AI coding agent for small models",
     "cli.init": "Run interactive setup wizard",
     "cli.config_saved": "Configuration saved to ~/.mma/config.json",
@@ -296,6 +326,13 @@
     "cli.security.recommended_for": "Recommended for",
     "cli.yes": "Yes",
     "cli.no": "No",
+    "cli.plugins.description": "Manage plugins",
+    "cli.plugins.list": "List loaded plugins (name, version, source)",
+    "cli.plugins.all": "Include builtin plugins",
+    "cli.plugins.only_external": "(builtin plugins omitted — use --all to show them)",
+    "cli.plugins.none": "No plugins loaded",
+    "cli.plugins.header": "Plugins: {count} loaded (MMA v{mma})",
+    "cli.plugins.builtin_mark": "●",
     "repl.help": "Show available commands",
     "repl.help_usage": "Usage: /help",
     "repl.exit": "Exit the REPL",
@@ -310,6 +347,8 @@
     "repl.reasoning_usage": "Usage: /reasoning",
     "repl.status": "Show agent status",
     "repl.status_usage": "Usage: /status",
+    "repl.plugins": "List loaded plugins",
+    "repl.plugins_usage": "Usage: /plugins [--all]",
     "repl.sessions": "List all sessions (* active)",
     "repl.sessions_usage": "Usage: /sessions",
     "repl.new": "Create a new session",
@@ -336,6 +375,7 @@
     "repl.skill_unknown_sub": "Unknown skill subcommand: {subcmd}",
     "repl.skill_usage": "Usage: /skill [list|loaded|load|unload|search]",
     "repl.agent": "Agent: ",
+    "repl.you": "You: ",
     "repl.interrupt": "Interrupted (Esc)",
     "repl.title": "MMA REPL v{version}",
     "repl.model": "Model:",
@@ -353,6 +393,10 @@
     "repl.skills_label": "Skills:",
     "repl.plugins_label": "Plugins:",
     "repl.mcp_label": "MCP:",
+    "repl.lsp_label": "LSP:",
+    "repl.lsp_timeout": "timeout",
+    "repl.lsp_failed": "did not start",
+    "repl.lsp_unknown": "unknown",
     "repl.work_dir": "Dir:",
     "repl.agents_label": "Instructions:",
     "repl.not_found": "not found",
@@ -427,6 +471,8 @@
     "exec.tool_errors_recovery": "Tool {tool} has failed {count} times in a row. Try an alternative: create files directly via write_file, use a different command, or if nothing works — skip this step via plan update step=N status=skipped with a note explaining why.",
     "exec.repetitive_tool": "Called {tool} {count} times with identical arguments and result. Try a different approach — create files directly, change arguments, or check process status via process_log.",
     "exec.consecutive_failures_recovery": "{count} consecutive tool failures. Create files directly via write_file instead of terminal commands. Check that dependencies are installed (npm install). Do not run build/tests until all files are created.",
+    "exec.read_only_loop": "No write/exec for {count} tool calls — the agent is only reading/exploring.",
+    "exec.read_only_loop_recovery": "{count} consecutive read-only tool calls (read_file/glob/grep/browser) with no writes. STOP exploring and make the edit the task requires: read the file, then call write_file or edit_file. If you cannot finish the task, ask the user instead of re-reading the same files.",
     "exec.plan_warning": "Current plan step {step} is \"{description}\", but {tool} is being called for files outside this step. Complete the current step first, then call plan update step={step} status=done before moving to the next step.",
     "exec.plan_blocked": "{max} consecutive calls outside the current step. Finish step {step} before proceeding — other steps should wait until this one is complete.",
     "exec.off_track": "Step {stepId} — \"{description}\" — but you are using {tool} on a different path. Return to the current step.",
@@ -436,13 +482,18 @@
     "exec.step_gate_ok": "[\u2713] Step {step} completed and verified. MOVING to step {nextStep}: \"{nextDesc}\". Work ONLY on this step.",
     "exec.step_gate_last": "[\u2713] Step {step} completed — that was the final step. Verify everything together and provide the final answer.]",
     "exec.audit_pass": "[\u2713] Task complete: {done}/{total} steps done, {files} files verified",
+    "exec.audit_pending": "[\u2717] Task incomplete: {done}/{total} steps done — remaining steps are not marked done",
     "exec.audit_fail": "[\u2717] Task incomplete: {done}/{total} steps done, {files} files missing",
+    "exec.audit_leftovers": "[\u2717] Task incomplete: {done}/{total} steps done, {files} files from delete-steps still exist",
+    "exec.audit_fail_tests": "[\u2717] Task incomplete: {done}/{total} steps done, tests FAILING: {failed} failed / {passed} passed — {detail}",
     "exec.audit_fail_typecheck": "[\u2717] Task incomplete: {done}/{total} steps done, {missing} files missing, typecheck error: {typeError}",
     "exec.audit_incomplete": "[\u26a0 Final audit incomplete: {summary}. Task is NOT finished \u2014 continue working. Remaining steps: {steps}]",
     "exec.mass_edit_warning": "\u26a0\ufe0f Plan affects {count} files \u2014 review the full list before proceeding.",
     "exec.escalation": "\n\n\u26a0\ufe0f Agent stuck on step {stepId} ({description}). Escalating to user \u2014 please provide guidance.",
     "exec.hints": "\n[Hints]\n{hints}",
     "exec.file_rewrite_warning": "\u26a0\ufe0f File {file} has been rewritten {count} times. Consider a different approach \u2014 the current fix strategy is not working.",
+    "exec.forbidden_cmd": "STOP using \"{cmd}\" via the bash tool \u2014 it is not a native Windows cmd.exe command and has failed repeatedly this session. Use the dedicated tool instead: grep \u2192 the grep tool, ls/dir \u2192 list_dir, find \u2192 glob, rm \u2192 delete_file, sed \u2192 edit_file, touch \u2192 write_file, which \u2192 `where`, cp/mv \u2192 move_file, diff \u2192 read_file. Do NOT call bash for this purpose again.",
+    "exec.npm_exec_hint": "\"could not determine executable to run\" \u2014 no \"bin\" for that package/script. Use \"npm run <script>\" (script must exist in package.json) or \"bunx <pkg>\" for a package that declares a bin.",
     "hall.max_retries_exhausted": "Model returned empty or insufficient responses after multiple retries",
     "hall.short_response": "Response too short or empty",
     "hall.repetitive": "Response too repetitive ({pct}% overlap)",
@@ -468,11 +519,17 @@
     "browser.no_page_short": "No page",
     "browser.no_elements": "(no interactive elements on page)",
     "browser.more_elements": "... and more elements not shown. Use scroll or search to find others.",
+    "browser.content_header": "Content:",
+    "browser.console_header": "Console:",
+    "browser.network_errors_header": "Network errors:",
+    "browser.truncated": "... (truncated)",
     "pipeline.invalid": "Invalid pipeline: name and steps required",
     "pipeline.step_missing_fields": "Step missing required fields (id, agent, prompt): {step}",
     "pipeline.circular": "Circular dependency: {stepId}",
     "plugin.loaded": "Loaded plugin: {name}",
     "plugin.skipped": "Skipped incompatible plugin: {entry} ({message})",
+    "plugin.incompatible": "Skipped plugin {name}: requires MMA v{min}, current is v{current}",
+    "plugin.dedup_older": "Plugin {name} v{version} skipped: a newer version is already loaded",
     "migration.detected": "[MMA] Detected old config. {summary}",
     "migration.summary": "[MMA] {summary}",
     "migration.config_bak": "- config \u2192 config.json.bak",
@@ -483,6 +540,7 @@
     "ui.success_prefix": "\u2713 ",
     "ui.warning_prefix": "\u26a0 ",
     "ui.thinking": "Thinking…",
+    "ui.step_context": "step {id}: {desc}",
     "indexer.map_header": "Project map",
     "indexer.top_directories": "Top directories",
     "indexer.files": "Files",
@@ -496,6 +554,10 @@
     "indexer.not_indexed": "Project has not been indexed yet",
     "indexer.find_results": "Found {count} matching files:\n{results}",
     "indexer.no_matches": "No matching files for \"{query}\"",
+    "indexer.duplicates": "Duplicate basenames (verify which file is the real source): {names}",
+    "indexer.stack_deps": "deps",
+    "indexer.stack_dev": "dev",
+    "indexer.stack_scripts": "scripts",
     "tool.friendly.project_map": "Project map",
     "config.decryption_warning": "Warning: Failed to decrypt config: {error}",
     "config.encryption_warning": "Warning: Failed to encrypt config: {error}",
@@ -520,6 +582,17 @@
     "ctx.compactions": "compactions: {count}",
     "ctx.quality": "quality: {percent}%",
     "ctx.delta_pos": "ctx +{tokens}",
-    "ctx.delta_neg": "ctx -{tokens} ↓",
-    "ctx.delta_zero": "ctx ±0"
+    "ctx.delta_neg": "ctx -{tokens}  ",
+    "ctx.delta_zero": "ctx +0",
+    "updater.check_error": "[updater] update check failed: {error}",
+    "updater.available": "[updater] Update available: {current} → {latest}. Run `npm install -g micro-models-agent` to upgrade.",
+    "updater.installing": "[updater] Installing {latest} globally (current: {current})…",
+    "updater.installed": "[updater] Installed {latest}. Restart MMA to use it (was {current}).",
+    "updater.install_failed": "[updater] Failed to install {latest}: {error}. Update manually with `npm install -g micro-models-agent`.",
+    "tools.enable_no_tags": "enable_tools requires at least one tag in the \"tags\" array.",
+    "tools.enable_no_executor": "Tool executor is not available — cannot enumerate enabled tools.",
+    "tools.enable_already_active": "Tool tags already active: {tags}.",
+    "tools.enable_added": "Enabled tool tags: {tags}. Available tools now: {tools}",
+    "tools.hidden_header": "Additional tools (enable on demand via enable_tools or route to subagent tool_tags):",
+    "tool.friendly.enable_tools": "Enable tools"
 }