@unerr-ai/unerr 0.2.1 → 0.2.3

package/dist/config/instruction-writer.js

@@ -1,388 +0,0 @@
-/**
- * Instruction Writer — injects tool-preference instructions into agent instruction files.
- *
- * Registry-driven: uses agent-registry.ts to determine instruction file path and format.
- * Idempotent — uses sentinel markers to create/update/skip sections without clobbering user content.
- *
- * Supported formats:
- *   - markdown: CLAUDE.md, AGENTS.md, GEMINI.md, copilot-instructions.md, .clinerules
- *     Uses <!-- unerr:start --> / <!-- unerr:end --> sentinel markers
- *   - mdc: .cursor/rules/*.mdc files (standalone file, overwrite entire file)
- */
-import { existsSync, mkdirSync, readFileSync, unlinkSync, writeFileSync, } from "node:fs";
-import { dirname, join } from "node:path";
-import { getAgent } from "./agent-registry.js";
-const SENTINEL_START = "<!-- unerr:start -->";
-const SENTINEL_END = "<!-- unerr:end -->";
-/**
- * The tool-preference instructions injected into agent instruction files.
- * Concise: tells the agent WHEN and WHY to use unerr tools over built-ins.
- */
-function getInstructionContent(ide) {
-    const isClaudeCode = ide === "claude-code";
-    // Claude Code requires built-in Read before Edit (readFileState constraint).
-    // Other agents can use file_read directly before editing.
-    const readForEditRow = isClaudeCode
-        ? `| Understand a file before editing | \`file_read\` with \`purpose:'explore'\` to understand, then built-in \`Read\` (offset/limit) on target lines before Edit | Reading entire file |`
-        : "| Read a file before editing | `file_read` with `entity` param or offset/limit for targeted access | Reading entire file |";
-    const twoStepSection = isClaudeCode
-        ? `
-### IMPORTANT: Two-step Read Routing (Claude Code specific)
-
-**Why this matters:** Claude Code's Edit tool requires built-in \`Read\` to have been called on the file first. \`file_read\` (unerr MCP) does NOT satisfy this because it's a separate MCP tool. Meanwhile, built-in Read misses project conventions and facts that \`file_read\` auto-injects.
-
-**The rule — two paths, choose by intent:**
-
-| Intent | Tool | Why |
-|--------|------|-----|
-| Reading to understand code | \`file_read\` (unerr MCP) | Auto-injects conventions, facts, drift status |
-| Reading immediately before Edit | Built-in \`Read\` with offset/limit | Required by Edit tool — \`file_read\` does NOT satisfy this. Use targeted reads (offset/limit) for only the lines you plan to edit. |
-
-When your next action is Edit, use built-in Read with offset/limit on the target lines. For everything else, use \`file_read\`.
-
-**Common failure mode:** Using \`file_read\` to understand a file, then attempting Edit without calling built-in Read first. The Edit tool WILL reject with "File has not been read yet". Always call built-in Read (with offset/limit) immediately before Edit.`
-        : "";
-    const summaryEditNote = isClaudeCode
-        ? "\nNEVER use built-in Read/Grep/Glob for code navigation. EXCEPTION: built-in Read (with offset/limit) is REQUIRED immediately before Edit (file_read cannot substitute — Edit will fail without it)."
-        : "\nNEVER use built-in Read/Grep/Glob for code navigation — use unerr MCP tools instead.";
-    return `## REQUIRED: Use unerr Graph Intelligence Tools (22 MCP tools)
-
-This project has unerr MCP tools installed. You MUST use these instead of built-in Read/Grep/Glob for code navigation. unerr tools are graph-backed, return results in <5ms, and include project context that built-in tools miss.
-
-### Tool Routing (MANDATORY — match your goal before calling any tool)
-
-| If you need to... | You MUST call | DO NOT use |
-|---|---|---|
-| Find a function, class, or type | \`search_code\` | Grep, Glob |
-| Find callers or callees | \`get_references\` (direction: callers/callees) | Grep for function name |
-| Read a file for understanding | \`file_read\` with \`purpose:'explore'\` (default, auto-injects conventions/facts) | Built-in Read/Grep/Glob |
-${readForEditRow}
-| Get file structure overview | \`file_outline\` | Reading the whole file |
-| Get a specific function or class | \`get_entity\` or \`file_read\` with \`entity\` param | Reading entire file |
-| Trace imports/dependencies | \`get_imports\` or \`get_references\` (direction: callees) | Manual import scanning |
-| Find hotspots / high fan-in / blast-radius candidates | \`get_critical_nodes\` | \`get_entity\` (won't show ranked list), guessing |
-| Run a shell command | Automatic — routed through shell intelligence | N/A |
-
-### FORBIDDEN Patterns (these waste tokens and miss context)
-
-- Reading an entire file to find one function -> use \`get_entity\` or \`file_read\` with \`entity\` param
-- Grep for a function name to find callers -> use \`get_references\` (finds indirect refs too)
-- Glob + Grep to search for code -> use \`search_code\` (indexes ALL entities, <5ms)
-- Reading multiple files to understand conventions -> use \`get_conventions\`
-- Guessing code style for new code -> use \`get_conventions\`
-- Guessing which entity has the highest fan-in / is the biggest hotspot -> use \`get_critical_nodes\`
-- Reading a full file when you only need a section -> use \`file_read\` with \`entity\` param or offset/limit${twoStepSection}
-
-### Tool Reference
-
-#### Graph Navigation (6 tools)
-
-| Task | Tool | Replaces |
-|------|------|----------|
-| Find callers or callees | \`get_references\` (direction: callers/callees) | Grep for function name / manual import tracing |
-| Search code entities | \`search_code\` | Glob + Grep across files |
-| Get entity details | \`get_entity\` | Reading full file for one function/class |
-| Get file summary | \`get_file\` | Reading entire file top-to-bottom |
-| Trace imports | \`get_imports\` | Scanning import statements |
-| Detect conventions | \`get_conventions\` | Guessing code style |
-
-#### Structural Analysis (5 tools)
-
-| Task | Tool | Replaces |
-|------|------|----------|
-| Find chokepoint entities | \`get_critical_nodes\` | Manually tracing callers across files |
-| Find cross-module coupling | \`get_cross_boundary_links\` | Manually tracing imports across directories |
-| Project overview stats | \`get_project_stats\` | Counting files / reading multiple files |
-| File dependency neighborhood | \`file_connections\` | Scanning import statements across codebase |
-| Find tests for an entity | \`get_test_coverage\` | Grepping for function names in test files |
-
-#### File Protocol (2 tools)
-
-| Task | Tool | Replaces |
-|------|------|----------|
-| File structure overview | \`file_outline\` | Reading entire large files |
-| Read file with context | \`file_read\` | Built-in Read (misses conventions) |
-
-\`file_read\` auto-injects relevant facts and conventions. For files >50 lines, call \`file_outline\` first, then \`file_read\` with \`entity\` param for targeted access.
-
-**\`purpose\` parameter:** Controls read behavior — set it to match your intent:
-- \`purpose:'explore'\` (default) — budget-capped, returns outline for large files. Use for browsing and pre-edit understanding.
-- \`purpose:'reference'\` — tight budget, entity/offset reads only. Use for quick lookups.
-
-#### Shell Compression (automatic)
-
-All shell commands automatically route through unerr's compression layer. It strips ANSI codes, classifies output (diffs, test results, logs, errors), and returns compressed summaries — saving tokens without losing critical information.
-
-#### Response Signal Prefix \`ur|<tag>\`
-
-unerr tool responses may begin with one or more \`ur|<tag> <message>\` lines BEFORE the actual content. These are anti-drift signals injected directly in the body (because MCP \`_meta\` is filtered by clients before reaching you). Treat them as high-priority instructions and act on them before consuming the rest of the response.
-
-The bare \`ur|\` prefix is deliberately short — it tokenizes to 1-2 BPE tokens, and the 3-char tag is another token. Total signal overhead: ~2-3 tokens.
-
-| Tag | Meaning | What to do |
-|---|---|---|
-| \`hlt\` | halt — loop / circuit-break detected | Stop retrying this entity; switch approach |
-| \`dft\` | drift — file or entity changed since last seen | Re-read with \`file_read\`/\`get_entity\` before editing |
-| \`rsk\` | risk — high blast radius (many callers/callees) | Check callers via \`get_references\` before editing |
-| \`wrn\` | warn — anti-pattern / negative fact | Avoid the listed failure mode |
-| \`hnt\` | hint — guidance / co-change suggestion | Consider co-modifying the listed files |
-| \`fct\` | fact — surfaced project fact (subtype in [brackets]: procedural, convention, semantic) | Use as session/project context |
-| \`ctx\` | context already delivered for this entity | Do not re-query; use what was already returned |
-| \`hth\` | health — session degraded | Consider starting a new session |
-| \`hst\` | hist — prior failures on this entity | Read failure modes carefully before retrying |
-| (no tag) | \`ur| <msg>\` generic nudge | Read the message |
-
-Example:
-\`\`\`
-ur|rsk fan_in=24 fan_out=3 (high blast radius — get_references first)
-ur|dft modified on main by intent-abc
-
-{actual tool response data here…}
-\`\`\`
-
-When you see one of these prefixes, act on it. Do not strip or ignore them in your reasoning.
-
-#### Pagination & Narrowing
-
-unerr tool responses are universally capped (typical default 5-30 items per call) and may show this hint right after the prefix:
-\`\`\`
-ur| <tool>: N more available — pass limit:N or <filter>:V to narrow (use token_budget bump only for full payloads)
-\`\`\`
-**Prefer narrowing over budget bumps.** When you see the page hint:
-- Pass a more specific filter — \`fact_type:negative\`, \`entity:<name>\`, \`kind:function\`, \`direction:callees\`. This returns the *missing* slice.
-- Bump \`limit:N\` only if you genuinely need more items of the same kind.
-- \`token_budget:N\` is a special-case escape hatch — use only when you must read a full payload (e.g., reading a complete function body to refactor it).
-
-#### Response Body Formats
-
-Three on-the-wire shapes; the body's first line tells you which:
-- \`{...JSON...}\` — minified JSON (default for single objects)
-- \`_fmt:columnar\` — pipe-delimited table; line 2 is the column header (\`col1|col2|...\`), rows below
-- \`_fmt:multi\` — multi-section: \`@meta k=v|...\` for scalars, then \`@<arrayName>[col1|col2|...]\` for tabular sections, \`@<arrayName>[]\` for string lists. Used by \`file_outline\`, \`file_connections\`, \`get_conventions\`.
-
-A cell is escaped if it contains \`|\` or \`"\` — wrapped in double quotes, internal quotes doubled. Newlines in cell values become literal \`\\n\`.
-
-#### Persistent Intelligence (2 tools)
-
-| Task | Tool |
-|------|------|
-| Record a project fact/convention/anti-pattern | \`record_fact\` |
-| Recall stored facts | \`recall_facts\` |
-
-When the user says "remember this" or states a convention/anti-pattern, call \`record_fact\`. Facts also auto-detect from coding sessions — conventions, hot files, file coupling, and modification history are learned automatically. Episodic facts capture what was built, why, and how — they surface as \`ur|fct\` prefix lines on \`file_read\` / \`recall_facts\` responses when you work on previously-modified files.
-
-#### Session Narrative — Markers (4 tools)
-
-| Task | Tool |
-|------|------|
-| Mark the start of a non-trivial task (one short sentence) | \`mark_intent\` |
-| Record a deliberate choice between approaches | \`mark_decision\` |
-| Flag an unresolved obstacle you hit this turn | \`mark_blocker\` |
-| Resolve a previously marked blocker | \`mark_resolution\` (pass the marker_id from mark_blocker as \`blocker_ref\`) |
-
-Emit markers inline as you work — NOT as an end-of-turn summary. Each is one short string; mark_intent ≤80 chars, the rest ≤140. Unresolved blockers carry into the next session's resume strip. Markers are persisted to the shadow ledger and timeline.db; they power turn titles, intent stitching, and loop/blocker mining. Optional: layer is useful without them, but agents that mark intent + decisions make the timeline dramatically more readable.
-
-### When to fall back to built-in tools
-
-ONLY use built-in Read/Grep/Glob when:
-- The unerr MCP server is not responding
-- You need to read a non-code file (images, binaries, PDFs)
-- You need complex regex patterns that \`search_code\` doesn't support
-
-### Summary (CRITICAL — read this even if you skimmed above)
-
-ALWAYS use unerr MCP tools: \`search_code\`, \`get_references\`, \`file_read\`, \`file_outline\`, \`get_entity\`.${summaryEditNote}
-Before writing code: \`get_conventions\`. To record decisions: \`record_fact\`.`;
-}
-/**
- * Generate MDC-formatted instruction content for Cursor rules.
- */
-function getMdcContent() {
-    return `---
-description: REQUIRED — use unerr graph intelligence tools instead of built-in Read/Grep/Glob
-alwaysApply: true
----
-
-${getInstructionContent("cursor")}
-`;
-}
-/**
- * Write tool-preference instructions into the agent's instruction file.
- * Idempotent: creates, updates, or skips based on current state.
- */
-export function writeInstructionFile(cwd, ide) {
-    const agentDef = getAgent(ide);
-    if (!agentDef?.instructionFilePath) {
-        return { path: "", action: "skipped" };
-    }
-    const filePath = join(cwd, agentDef.instructionFilePath);
-    if (agentDef.instructionFormat === "mdc") {
-        return writeMdcInstructionFile(filePath);
-    }
-    if (agentDef.instructionFormat === "windsurf-rule") {
-        mkdirSync(dirname(filePath), { recursive: true });
-        const content = getInstructionContent(ide);
-        // Windsurf enforces 6K char limit per rule
-        const truncatedContent = content.length > 5800
-            ? `${content.slice(0, 5800)}\n\n[Truncated — full content exceeds Windsurf 6K limit]`
-            : content;
-        const windsurfContent = `---\ntrigger: always_on\ndescription: "Tool routing instructions for unerr MCP integration"\n---\n\n${truncatedContent}\n`;
-        const existed = existsSync(filePath);
-        if (existed) {
-            const existing = readFileSync(filePath, "utf-8");
-            if (existing === windsurfContent) {
-                return { path: filePath, action: "skipped" };
-            }
-        }
-        writeFileSync(filePath, windsurfContent, "utf-8");
-        return { path: filePath, action: existed ? "updated" : "created" };
-    }
-    if (agentDef.instructionFormat === "antigravity-rule") {
-        mkdirSync(dirname(filePath), { recursive: true });
-        const content = getInstructionContent(ide);
-        const antigravityContent = `---\nname: unerr-instructions\ndescription: Tool routing instructions for unerr MCP integration\ntype: manual\n---\n\n${content}\n`;
-        const existed = existsSync(filePath);
-        if (existed) {
-            const existing = readFileSync(filePath, "utf-8");
-            if (existing === antigravityContent) {
-                return { path: filePath, action: "skipped" };
-            }
-        }
-        writeFileSync(filePath, antigravityContent, "utf-8");
-        return { path: filePath, action: existed ? "updated" : "created" };
-    }
-    // markdown format (CLAUDE.md, AGENTS.md, GEMINI.md, copilot-instructions.md, .clinerules)
-    return mergeMarkdownSection(filePath, getInstructionContent(ide));
-}
-/**
- * Merge a sentinel-wrapped section into a markdown file.
- * - File doesn't exist → create with sentinel-wrapped content → "created"
- * - File exists, no sentinel → append at end → "updated"
- * - File exists, sentinel present, same content → "skipped"
- * - File exists, sentinel present, different → replace block → "updated"
- */
-function mergeMarkdownSection(filePath, content) {
-    const wrappedContent = `${SENTINEL_START}\n${content}\n${SENTINEL_END}`;
-    if (!existsSync(filePath)) {
-        // Create new file with sentinel-wrapped content
-        const dir = dirname(filePath);
-        if (!existsSync(dir))
-            mkdirSync(dir, { recursive: true });
-        writeFileSync(filePath, `${wrappedContent}\n`);
-        return { path: filePath, action: "created" };
-    }
-    const existing = readFileSync(filePath, "utf-8");
-    const startIdx = existing.indexOf(SENTINEL_START);
-    const endIdx = existing.indexOf(SENTINEL_END);
-    if (startIdx === -1 || endIdx === -1) {
-        // No sentinel markers — prepend at top (primacy bias: top-positioned instructions
-        // are followed 2-3x more often by LLMs than bottom-positioned ones)
-        writeFileSync(filePath, `${wrappedContent}\n\n${existing}`);
-        return { path: filePath, action: "updated" };
-    }
-    // Sentinel markers found — check if content is identical
-    const existingBlock = existing.slice(startIdx, endIdx + SENTINEL_END.length);
-    if (existingBlock === wrappedContent) {
-        return { path: filePath, action: "skipped" };
-    }
-    // Replace existing block
-    const before = existing.slice(0, startIdx);
-    const after = existing.slice(endIdx + SENTINEL_END.length);
-    writeFileSync(filePath, `${before}${wrappedContent}${after}`);
-    return { path: filePath, action: "updated" };
-}
-/**
- * Write a standalone .mdc instruction file for Cursor.
- * Overwrites entire file (it's ours). Returns "created" or "skipped".
- */
-function writeMdcInstructionFile(filePath) {
-    const content = getMdcContent();
-    const alreadyExists = existsSync(filePath);
-    if (alreadyExists) {
-        const existing = readFileSync(filePath, "utf-8");
-        if (existing === content) {
-            return { path: filePath, action: "skipped" };
-        }
-    }
-    const dir = dirname(filePath);
-    if (!existsSync(dir))
-        mkdirSync(dir, { recursive: true });
-    writeFileSync(filePath, content);
-    return {
-        path: filePath,
-        action: alreadyExists ? "updated" : "created",
-    };
-}
-/**
- * Remove unerr instruction section from the agent's instruction file.
- * For markdown: removes sentinel-wrapped block. For mdc: deletes the file.
- */
-export function removeInstructionSection(cwd, ide) {
-    const agentDef = getAgent(ide);
-    if (!agentDef?.instructionFilePath)
-        return false;
-    const filePath = join(cwd, agentDef.instructionFilePath);
-    if (!existsSync(filePath))
-        return false;
-    if (agentDef.instructionFormat === "mdc") {
-        // Delete the entire file (it's ours)
-        unlinkSync(filePath);
-        return true;
-    }
-    if (agentDef.instructionFormat === "windsurf-rule") {
-        if (existsSync(filePath)) {
-            unlinkSync(filePath);
-            return true;
-        }
-        return false;
-    }
-    if (agentDef.instructionFormat === "antigravity-rule") {
-        if (existsSync(filePath)) {
-            unlinkSync(filePath);
-            return true;
-        }
-        return false;
-    }
-    // Markdown: remove sentinel block
-    const content = readFileSync(filePath, "utf-8");
-    const startIdx = content.indexOf(SENTINEL_START);
-    const endIdx = content.indexOf(SENTINEL_END);
-    if (startIdx === -1 || endIdx === -1)
-        return false;
-    const before = content.slice(0, startIdx);
-    const after = content.slice(endIdx + SENTINEL_END.length);
-    // Clean up extra blank lines left behind
-    const cleaned = `${(before + after).replace(/\n{3,}/g, "\n\n").trimEnd()}\n`;
-    // If nothing meaningful remains, delete the file only if we created it
-    const trimmed = cleaned.replace(/\s/g, "");
-    if (trimmed.length === 0) {
-        unlinkSync(filePath);
-    }
-    else {
-        writeFileSync(filePath, cleaned);
-    }
-    return true;
-}
-/**
- * Generate formatted custom instructions text for --show-instructions output.
- */
-export function generateCustomInstructions(ide) {
-    const content = getInstructionContent(ide);
-    if (ide && ide !== "other") {
-        const agentDef = getAgent(ide);
-        if (agentDef?.instructionFilePath) {
-            return [
-                `Add the following to ${agentDef.instructionFilePath}:`,
-                "",
-                content,
-            ].join("\n");
-        }
-    }
-    // Generic instructions for any agent
-    return [
-        "Add the following to your agent's instruction file",
-        "(CLAUDE.md, AGENTS.md, .cursorrules, GEMINI.md, etc.):",
-        "",
-        content,
-    ].join("\n");
-}

package/dist/config/mcp-config-writer.js

@@ -1,266 +0,0 @@
-/**
- * MCP Config Writer — generates per-agent MCP config with unerr server configuration.
- *
- * Registry-driven: uses agent-registry.ts to determine config path and format.
- * Idempotent — never overwrites user customizations, only adds/merges unerr entry.
- *
- * Supported formats:
- *   - mcp-json: { mcpServers: { unerr: { ... } } }
- *   - settings-json: { "mcp": { "servers": { unerr: { ... } } } } (Gemini CLI)
- *   - continue-config: { mcpServers: [{ name: "unerr", ... }] } (Continue.dev)
- */
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
-import { homedir } from "node:os";
-import { dirname, join } from "node:path";
-import { getAgent, } from "./agent-registry.js";
-const UNERR_SERVER_KEY = "unerr";
-function createUnerrServerEntry() {
-    return {
-        type: "stdio",
-        command: "unerr",
-        args: ["--mcp"],
-    };
-}
-function createCopilotServerEntry() {
-    return {
-        type: "local",
-        command: "unerr",
-        args: ["--mcp"],
-    };
-}
-/**
- * Write MCP config for a detected agent.
- * Idempotent: if config exists with unerr entry, skips.
- * If config exists without unerr entry, merges without overwriting.
- */
-export function writeMcpConfig(cwd, ide) {
-    const agent = getAgent(ide);
-    if (!agent) {
-        return { path: "", action: "skipped" };
-    }
-    const configPath = agent.configScope === "global"
-        ? join(homedir(), agent.projectConfigPath)
-        : join(cwd, agent.projectConfigPath);
-    const dir = dirname(configPath);
-    if (!existsSync(dir)) {
-        mkdirSync(dir, { recursive: true });
-    }
-    switch (agent.configFormat) {
-        case "mcp-json":
-            return writeMcpJsonFormat(configPath);
-        case "settings-json":
-            return writeSettingsJsonFormat(configPath);
-        case "copilot-json":
-            return writeCopilotJsonFormat(configPath);
-        case "continue-config":
-            return writeContinueFormat(configPath);
-        default:
-            return writeMcpJsonFormat(configPath);
-    }
-}
-/**
- * Write config for ALL detected agents at once.
- */
-export function writeAllMcpConfigs(cwd, agents) {
-    return agents.map((ide) => {
-        const result = writeMcpConfig(cwd, ide);
-        return { ide, ...result };
-    });
-}
-/**
- * Remove unerr entry from MCP config.
- */
-export function removeMcpConfig(cwd, ide) {
-    const agent = getAgent(ide);
-    if (!agent)
-        return false;
-    const configPath = agent.configScope === "global"
-        ? join(homedir(), agent.projectConfigPath)
-        : join(cwd, agent.projectConfigPath);
-    if (!existsSync(configPath))
-        return false;
-    try {
-        const existing = JSON.parse(readFileSync(configPath, "utf-8"));
-        if (agent.configFormat === "continue-config") {
-            if (!Array.isArray(existing.mcpServers))
-                return false;
-            existing.mcpServers = existing.mcpServers.filter((s) => s.name !== UNERR_SERVER_KEY);
-        }
-        else if (agent.configFormat === "settings-json") {
-            if (!existing.mcp?.servers?.[UNERR_SERVER_KEY])
-                return false;
-            delete existing.mcp.servers[UNERR_SERVER_KEY];
-        }
-        else if (agent.configFormat === "copilot-json") {
-            if (!existing.mcpServers?.[UNERR_SERVER_KEY])
-                return false;
-            delete existing.mcpServers[UNERR_SERVER_KEY];
-        }
-        else {
-            if (!existing.mcpServers?.[UNERR_SERVER_KEY])
-                return false;
-            delete existing.mcpServers[UNERR_SERVER_KEY];
-        }
-        writeFileSync(configPath, JSON.stringify(existing, null, 2), "utf-8");
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-/**
- * Check if unerr is already configured for an IDE.
- */
-export function isConfigured(cwd, ide) {
-    const agent = getAgent(ide);
-    if (!agent)
-        return false;
-    const configPath = agent.configScope === "global"
-        ? join(homedir(), agent.projectConfigPath)
-        : join(cwd, agent.projectConfigPath);
-    if (!existsSync(configPath))
-        return false;
-    try {
-        const existing = JSON.parse(readFileSync(configPath, "utf-8"));
-        if (agent.configFormat === "continue-config") {
-            return (Array.isArray(existing.mcpServers) &&
-                existing.mcpServers.some((s) => s.name === UNERR_SERVER_KEY));
-        }
-        if (agent.configFormat === "settings-json") {
-            return !!existing.mcp?.servers?.[UNERR_SERVER_KEY];
-        }
-        if (agent.configFormat === "copilot-json") {
-            return !!existing.mcpServers?.[UNERR_SERVER_KEY];
-        }
-        return !!existing.mcpServers?.[UNERR_SERVER_KEY];
-    }
-    catch {
-        return false;
-    }
-}
-/**
- * Generate the MCP config JSON string for manual copy-paste.
- * Useful for agents that can't be auto-configured.
- */
-export function generateConfigSnippet(ide) {
-    const agent = getAgent(ide);
-    if (!agent)
-        return "";
-    const entry = createUnerrServerEntry();
-    switch (agent.configFormat) {
-        case "settings-json":
-            return JSON.stringify({ mcp: { servers: { [UNERR_SERVER_KEY]: entry } } }, null, 2);
-        case "copilot-json": {
-            const copilotEntry = createCopilotServerEntry();
-            return JSON.stringify({ mcpServers: { [UNERR_SERVER_KEY]: copilotEntry } }, null, 2);
-        }
-        case "continue-config":
-            return JSON.stringify({ mcpServers: [{ name: UNERR_SERVER_KEY, ...entry }] }, null, 2);
-        default:
-            return JSON.stringify({ mcpServers: { [UNERR_SERVER_KEY]: entry } }, null, 2);
-    }
-}
-/**
- * Get config info for display purposes.
- */
-export function getConfigInfo(ide) {
-    const agent = getAgent(ide);
-    if (!agent)
-        return null;
-    return {
-        path: agent.projectConfigPath,
-        format: agent.configFormat,
-    };
-}
-// ── Format-specific writers ─────────────────────────────────────
-function writeMcpJsonFormat(configPath) {
-    if (existsSync(configPath)) {
-        try {
-            const existing = JSON.parse(readFileSync(configPath, "utf-8"));
-            if (existing.mcpServers?.[UNERR_SERVER_KEY]) {
-                return { path: configPath, action: "skipped" };
-            }
-            existing.mcpServers = existing.mcpServers ?? {};
-            existing.mcpServers[UNERR_SERVER_KEY] = createUnerrServerEntry();
-            writeFileSync(configPath, JSON.stringify(existing, null, 2), "utf-8");
-            return { path: configPath, action: "updated" };
-        }
-        catch {
-            return { path: configPath, action: "skipped" };
-        }
-    }
-    const config = {
-        mcpServers: { [UNERR_SERVER_KEY]: createUnerrServerEntry() },
-    };
-    writeFileSync(configPath, JSON.stringify(config, null, 2), "utf-8");
-    return { path: configPath, action: "created" };
-}
-function writeSettingsJsonFormat(configPath) {
-    if (existsSync(configPath)) {
-        try {
-            const existing = JSON.parse(readFileSync(configPath, "utf-8"));
-            const mcp = (existing.mcp ?? {});
-            const servers = (mcp.servers ?? {});
-            if (servers[UNERR_SERVER_KEY]) {
-                return { path: configPath, action: "skipped" };
-            }
-            servers[UNERR_SERVER_KEY] = createUnerrServerEntry();
-            mcp.servers = servers;
-            existing.mcp = mcp;
-            writeFileSync(configPath, JSON.stringify(existing, null, 2), "utf-8");
-            return { path: configPath, action: "updated" };
-        }
-        catch {
-            return { path: configPath, action: "skipped" };
-        }
-    }
-    const config = {
-        mcp: { servers: { [UNERR_SERVER_KEY]: createUnerrServerEntry() } },
-    };
-    writeFileSync(configPath, JSON.stringify(config, null, 2), "utf-8");
-    return { path: configPath, action: "created" };
-}
-function writeContinueFormat(configPath) {
-    const entry = { name: UNERR_SERVER_KEY, ...createUnerrServerEntry() };
-    if (existsSync(configPath)) {
-        try {
-            const existing = JSON.parse(readFileSync(configPath, "utf-8"));
-            const servers = (existing.mcpServers ?? []);
-            if (servers.some((s) => s.name === UNERR_SERVER_KEY)) {
-                return { path: configPath, action: "skipped" };
-            }
-            servers.push(entry);
-            existing.mcpServers = servers;
-            writeFileSync(configPath, JSON.stringify(existing, null, 2), "utf-8");
-            return { path: configPath, action: "updated" };
-        }
-        catch {
-            return { path: configPath, action: "skipped" };
-        }
-    }
-    const config = { mcpServers: [entry] };
-    writeFileSync(configPath, JSON.stringify(config, null, 2), "utf-8");
-    return { path: configPath, action: "created" };
-}
-function writeCopilotJsonFormat(configPath) {
-    if (existsSync(configPath)) {
-        try {
-            const existing = JSON.parse(readFileSync(configPath, "utf-8"));
-            if (existing.mcpServers?.[UNERR_SERVER_KEY]) {
-                return { path: configPath, action: "skipped" };
-            }
-            existing.mcpServers = existing.mcpServers ?? {};
-            existing.mcpServers[UNERR_SERVER_KEY] = createCopilotServerEntry();
-            writeFileSync(configPath, JSON.stringify(existing, null, 2), "utf-8");
-            return { path: configPath, action: "updated" };
-        }
-        catch {
-            return { path: configPath, action: "skipped" };
-        }
-    }
-    const config = {
-        mcpServers: { [UNERR_SERVER_KEY]: createCopilotServerEntry() },
-    };
-    writeFileSync(configPath, JSON.stringify(config, null, 2), "utf-8");
-    return { path: configPath, action: "created" };
-}