wyrm-mcp 7.2.1 → 7.2.2

package/dist/handlers/companion.js

@@ -1,459 +1,28 @@
-/**
- * @copyright 2026 Ghost Protocol (Pvt) Ltd.
- * @license AGPL-3.0-or-later
- */
-import { TOOL_ANNOTATIONS } from "../tool-annotations.js";
-import { injectSystemPrompt } from "../autoconfig.js";
-import { buildPeerBuddyReply } from "../buddy.js";
-import { getCapabilities, renderCapabilityBriefing } from "../capabilities.js";
-import { getUpdateStatus } from "../version-check.js";
-import { isCompanionBuddyCall } from "./alias-adapters.js";
-import { spawn as cpSpawn } from "child_process";
-export const companionToolSpecs = [
-    {
-        name: "wyrm_inject_prompt",
-        description: "Opt-in: inject a Wyrm session-prime instruction block into .github/copilot-instructions.md and/or .cursor/rules for a project. Uses managed markers so re-runs are safe.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                project_path: { type: "string", description: "Absolute path to the project root" },
-                clients: { type: "array", items: { type: "string" }, description: "Clients to inject into: 'copilot', 'cursor' (default: both detected)" },
-            },
-            required: ["project_path"],
-        },
-        annotations: TOOL_ANNOTATIONS["wyrm_inject_prompt"],
-        aliases: [],
-        handler: async (args, ctx) => {
-            const { project_path: injPath, clients: injClients } = args;
-            const injectResult = injectSystemPrompt(injPath, injClients ?? []);
-            let injText = `󱅝 **System Prompt Injection**\n\n`;
-            if (injectResult.injected.length > 0) {
-                injText += `✅ Injected into:\n${injectResult.injected.map((f) => `- ${f}`).join('\n')}\n\n`;
-            }
-            if (injectResult.skipped.length > 0) {
-                injText += `○ Skipped (unknown client): ${injectResult.skipped.join(', ')}\n\n`;
-            }
-            if (injectResult.errors.length > 0) {
-                injText += `❌ Errors:\n${injectResult.errors.map((e) => `- ${e}`).join('\n')}\n\n`;
-            }
-            if (injectResult.injected.length > 0) {
-                injText += `AI models in this project will now call \`wyrm_session_prime\` at the start of each conversation.`;
-            }
-            return { content: [{ type: "text", text: injText }] };
-        },
-    },
-    {
-        name: "buddy",
-        description: "Use when another buddy-compatible MCP server (or the operator) asks Wyrm for a brief, data-grounded status reply - the Buddy Protocol v1.0 well-known entry point. Companion params switch to the full companion reply; bare calls stay protocol-pure. Cycle-protected.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                // v7 F3 (T026): property prose compressed to fund the hot-path
-                // outputSchemas under the 8K default-surface pin (T022/T025 trade).
-                from_buddy: { type: "string", description: "Caller identity" },
-                project_hint: { type: "string", description: "Scope the reply" },
-                mood_hint: { type: "string", enum: ["normal", "celebratory", "stuck", "quiet"] },
-                size: { type: "string", enum: ["full", "compact", "mini"] },
-                format: { type: "string", enum: ["markdown", "json"], description: "Peer mode only." },
-                project_path: { type: "string", description: "Companion mode: project root (default cwd)" },
-                persona: { type: "string", enum: ["wyrm", "drogo", "berlin", "sumair", "custom"], description: "Companion voice." },
-                persona_name: { type: "string", description: "For persona=custom" },
-                mood: { type: "string", description: "Companion override (mood_hint values)" },
-                federate: { type: "boolean", description: "Fold in other buddy MCPs" },
-            },
-        },
-        annotations: TOOL_ANNOTATIONS["buddy"],
-        aliases: [],
-        handler: async (args, ctx) => {
-            const { WYRM_PACKAGE_VERSION, db, runCompanionBuddy } = ctx;
-            const a = args || {};
-            // v7 F3 (T021) buddy fold: wyrm_buddy's companion params live here as
-            // ADDITIVE optional args. Any of them present → the SAME companion
-            // code path wyrm_buddy runs (runCompanionBuddy — one implementation,
-            // not a duplicate). Absent → Buddy Protocol v1.0 peer behavior,
-            // byte-identical to 6.x ("protocol behavior unchanged when absent").
-            if (isCompanionBuddyCall(args ?? {})) {
-                return await runCompanionBuddy(args ?? {});
-            }
-            // Buddy Protocol v1.0 — peer entry point. Other MCP servers' buddies
-            // call this. Project-agnostic by default; project_hint scopes it.
-            const peerReq = args;
-            const reply = buildPeerBuddyReply(db.getDatabase(), peerReq, WYRM_PACKAGE_VERSION);
-            if (peerReq.format === 'json') {
-                return { content: [{ type: 'text', text: JSON.stringify(reply.json, null, 2) }] };
-            }
-            return { content: [{ type: 'text', text: reply.markdown }] };
-        },
-    },
-    {
-        name: "wyrm_buddy",
-        description: "Friendly, data-grounded coding companion. Returns a brief greeting + project state + suggested next step sourced entirely from Wyrm's real data. Every claim cites a real DB row ID — no hallucinated encouragement. Personas: wyrm (default, dragon-themed), drogo (gruff), berlin (precise), sumair (warm), custom. Moods: normal / celebratory / stuck / quiet — auto-detected. Sizes: full (10-line PhantomDragon-style mascot), compact (5-line workspace-friendly), mini (single-line inline prefix). Federates with other registered MCPs that expose `buddy`, `*_buddy`, or `buddy_*` tools — their replies fold into a 'From other buddies' section.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                project_path: { type: "string", description: "Project root. Default: current cwd if registered." },
-                mood: { type: "string", enum: ["normal", "celebratory", "stuck", "quiet"], description: "Override the auto-detected mood." },
-                persona: { type: "string", enum: ["wyrm", "drogo", "berlin", "sumair", "custom"], description: "Voice. Default: WYRM_BUDDY_DEFAULT_PERSONA env or 'wyrm'." },
-                persona_name: { type: "string", description: "Required when persona === 'custom'." },
-                size: { type: "string", enum: ["full", "compact", "mini"], description: "Mascot size. 'full' = 10-line head+shoulder banner (default), 'compact' = 5-line workspace-friendly, 'mini' = single-line inline prefix on the greeting." },
-                federate: { type: "boolean", description: "Query other registered MCPs with *_buddy tools and fold their replies in. Default: true if any are registered." },
-            },
-        },
-        annotations: TOOL_ANNOTATIONS["wyrm_buddy"],
-        aliases: [],
-        handler: async (args, ctx) => {
-            const { runCompanionBuddy } = ctx;
-            // v7 F3 (T021): alias of the well-known `buddy` tool (the buddy fold).
-            // Routes to the EXACT code path buddy's companion mode runs; the alias
-            // spine (handlers/aliases.ts) carries the argument adapter and the
-            // golden replay CI proves equivalence on the live wire.
-            return await runCompanionBuddy(args ?? {});
-        },
-    },
-    {
-        name: "wyrm_token_set",
-        description: "Set a design token for a project. Tokens are colour / type / spacing / motion / shadow / radius / breakpoint / custom — the design system primitives the project is built on. Stored first-class so AI helpers working on creative tasks don't have to re-derive the system from scattered CSS each time. Upserts on (project_id, category, key).",
-        inputSchema: {
-            type: "object",
-            properties: {
-                projectPath: { type: "string", description: "Project root path." },
-                category: { type: "string", enum: ["color", "type", "spacing", "motion", "shadow", "radius", "breakpoint", "custom"], description: "Token category." },
-                key: { type: "string", description: "Short slug, e.g. 'primary' / 'h1' / 'page-padding-md'." },
-                value: { type: "string", description: "Actual value: '#00B89F' / 'Inter 900 2.5rem' / '1.25rem' / etc." },
-                notes: { type: "string", description: "Optional why / when-to-use guidance." },
-                source: { type: "string", enum: ["user", "derived", "imported", "observed"], description: "How the token was determined. Default: 'user'." },
-            },
-            required: ["projectPath", "category", "key", "value"],
-        },
-        annotations: TOOL_ANNOTATIONS["wyrm_token_set"],
-        aliases: [],
-        handler: async (args, ctx) => {
-            const { db, designSystem } = ctx;
-            const { projectPath: tsPath, category: tsCat, key: tsKey, value: tsVal, notes: tsNotes, source: tsSrc } = args;
-            const proj = db.getProject(tsPath);
-            if (!proj)
-                return { content: [{ type: 'text', text: `Project not found: ${tsPath}` }], isError: true };
-            const token = designSystem().setToken({ projectId: proj.id, category: tsCat, key: tsKey, value: tsVal, notes: tsNotes, source: tsSrc });
-            return { content: [{ type: 'text', text: `🎨 token set: \`${token.category}/${token.key}\` = \`${token.value}\`` + (token.notes ? ` — ${token.notes}` : '') }] };
-        },
-    },
-    {
-        name: "wyrm_token_get",
-        description: "Retrieve all design tokens for a project, optionally filtered by category. Returns the design system primitives the project is built on.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                projectPath: { type: "string", description: "Project root path." },
-                category: { type: "string", enum: ["color", "type", "spacing", "motion", "shadow", "radius", "breakpoint", "custom"], description: "Filter by category. Omit for all tokens." },
-            },
-            required: ["projectPath"],
-        },
-        annotations: TOOL_ANNOTATIONS["wyrm_token_get"],
-        aliases: [],
-        handler: async (args, ctx) => {
-            const { db, designSystem } = ctx;
-            const { projectPath: tgPath, category: tgCat } = args;
-            const proj = db.getProject(tgPath);
-            if (!proj)
-                return { content: [{ type: 'text', text: `Project not found: ${tgPath}` }], isError: true };
-            const md = designSystem().formatForContext(proj.id);
-            if (!md)
-                return { content: [{ type: 'text', text: `_(no design tokens for ${proj.name} yet — use \`wyrm_token_set\` to start the design system)_` }] };
-            // If category filter, slice the markdown
-            if (tgCat) {
-                const tokens = designSystem().listTokens(proj.id, tgCat);
-                if (tokens.length === 0)
-                    return { content: [{ type: 'text', text: `_(no ${tgCat} tokens for ${proj.name})_` }] };
-                const lines = [`### 🎨 ${tgCat} tokens for ${proj.name}`, ''];
-                for (const t of tokens)
-                    lines.push(`- \`${t.key}\` = \`${t.value}\`${t.notes ? ` — ${t.notes}` : ''}`);
-                return { content: [{ type: 'text', text: lines.join('\n') }] };
-            }
-            return { content: [{ type: 'text', text: md }] };
-        },
-    },
-    {
-        name: "wyrm_token_delete",
-        description: "Remove a design token from a project.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                projectPath: { type: "string", description: "Project root path." },
-                category: { type: "string", enum: ["color", "type", "spacing", "motion", "shadow", "radius", "breakpoint", "custom"] },
-                key: { type: "string", description: "Token key to remove." },
-            },
-            required: ["projectPath", "category", "key"],
-        },
-        annotations: TOOL_ANNOTATIONS["wyrm_token_delete"],
-        aliases: [],
-        handler: async (args, ctx) => {
-            const { db, designSystem } = ctx;
-            const { projectPath: tdPath, category: tdCat, key: tdKey } = args;
-            const proj = db.getProject(tdPath);
-            if (!proj)
-                return { content: [{ type: 'text', text: `Project not found: ${tdPath}` }], isError: true };
-            const ok = designSystem().deleteToken(proj.id, tdCat, tdKey);
-            return { content: [{ type: 'text', text: ok ? `🗑 removed \`${tdCat}/${tdKey}\`` : `not found: \`${tdCat}/${tdKey}\`` }] };
-        },
-    },
-    {
-        name: "wyrm_reference_add",
-        description: "Clip a design reference (URL, image path, palette, or inline snippet) for inspiration. Stored per-project (or globally if no project path). Tag aggressively — tags drive future search and recall when building a new project in the same vein.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                projectPath: { type: "string", description: "Project root path. Omit to attach as a global reference." },
-                kind: { type: "string", enum: ["url", "image", "palette", "snippet"], description: "Reference type." },
-                location: { type: "string", description: "URL, file path, or inline payload (e.g. palette like '#00B89F,#ff5a55,#0a0c0e' or a code snippet)." },
-                title: { type: "string", description: "Short title — what is this reference?" },
-                notes: { type: "string", description: "Why you saved it / what to remember about it." },
-                tags: { type: "string", description: "Comma-separated tags — 'hero,scroll-tied,framer-motion'." },
-            },
-            required: ["kind", "location"],
-        },
-        annotations: TOOL_ANNOTATIONS["wyrm_reference_add"],
-        aliases: [],
-        handler: async (args, ctx) => {
-            const { db, designSystem } = ctx;
-            const { projectPath: raPath, kind: raKind, location: raLoc, title: raTitle, notes: raNotes, tags: raTags } = args;
-            let projectId = null;
-            if (raPath) {
-                const proj = db.getProject(raPath);
-                if (!proj)
-                    return { content: [{ type: 'text', text: `Project not found: ${raPath}` }], isError: true };
-                projectId = proj.id;
-            }
-            const ref = designSystem().addReference({ projectId, kind: raKind, location: raLoc, title: raTitle, notes: raNotes, tags: raTags });
-            const scope = projectId ? ` (project ${projectId})` : ' (global)';
-            return { content: [{ type: 'text', text: `📌 reference #${ref.id} saved${scope}: \`${ref.kind}\` ${ref.title ?? ref.location.slice(0, 60)}${ref.tags ? ` · tags: ${ref.tags}` : ''}` }] };
-        },
-    },
-    {
-        name: "wyrm_reference_list",
-        description: "Browse saved design references. Filter by project or tag. Default: 50 most recent across all projects.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                projectPath: { type: "string", description: "Limit to a specific project." },
-                tag: { type: "string", description: "Filter to references containing this tag." },
-                limit: { type: "number", description: "Max results (default 50, max 200)." },
-            },
-        },
-        annotations: TOOL_ANNOTATIONS["wyrm_reference_list"],
-        aliases: [],
-        handler: async (args, ctx) => {
-            const { db, designSystem } = ctx;
-            const { projectPath: rlPath, tag: rlTag, limit: rlLimit } = args;
-            let projectId;
-            if (rlPath) {
-                const proj = db.getProject(rlPath);
-                if (!proj)
-                    return { content: [{ type: 'text', text: `Project not found: ${rlPath}` }], isError: true };
-                projectId = proj.id;
-            }
-            const refs = designSystem().listReferences({ projectId, tag: rlTag, limit: rlLimit });
-            if (refs.length === 0)
-                return { content: [{ type: 'text', text: '_(no references match)_' }] };
-            const lines = [`📌 **${refs.length} reference${refs.length === 1 ? '' : 's'}**`];
-            for (const r of refs) {
-                const scope = r.project_id ? `p${r.project_id}` : 'global';
-                lines.push(`- [${r.id}/${scope}] \`${r.kind}\` ${r.title ?? r.location.slice(0, 60)}${r.tags ? ` · ${r.tags}` : ''}`);
-            }
-            return { content: [{ type: 'text', text: lines.join('\n') }] };
-        },
-    },
-    {
-        name: "wyrm_reference_search",
-        description: "Full-text search across design references' title / notes / tags. Returns matching references sorted by recency.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                query: { type: "string", description: "FTS5 query — keywords, phrases in quotes." },
-                projectPath: { type: "string", description: "Limit to a specific project." },
-                limit: { type: "number", description: "Max results (default 20, max 100)." },
-            },
-            required: ["query"],
-        },
-        annotations: TOOL_ANNOTATIONS["wyrm_reference_search"],
-        aliases: [],
-        handler: async (args, ctx) => {
-            const { db, designSystem } = ctx;
-            const { query: rsQuery, projectPath: rsPath, limit: rsLimit } = args;
-            let projectId;
-            if (rsPath) {
-                const proj = db.getProject(rsPath);
-                if (!proj)
-                    return { content: [{ type: 'text', text: `Project not found: ${rsPath}` }], isError: true };
-                projectId = proj.id;
-            }
-            const refs = designSystem().searchReferences(rsQuery, { projectId, limit: rsLimit });
-            if (refs.length === 0)
-                return { content: [{ type: 'text', text: `_(no references match "${rsQuery}")_` }] };
-            const lines = [`🔍 **${refs.length} reference${refs.length === 1 ? '' : 's'}** matching "${rsQuery}"`];
-            for (const r of refs) {
-                const scope = r.project_id ? `p${r.project_id}` : 'global';
-                lines.push(`- [${r.id}/${scope}] \`${r.kind}\` ${r.title ?? r.location.slice(0, 60)}${r.tags ? ` · ${r.tags}` : ''}`);
-            }
-            return { content: [{ type: 'text', text: lines.join('\n') }] };
-        },
-    },
-    {
-        name: "wyrm_capabilities",
-        description: "Use to learn what your memory system can actually do - feature inventory, why each matters, runtime state, and which tool to reach for. Call at session start instead of re-discovering the surface.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                format: { type: "string", enum: ["json", "markdown"] },
-            },
-        },
-        annotations: TOOL_ANNOTATIONS["wyrm_capabilities"],
-        aliases: [],
-        handler: async (args, ctx) => {
-            const { WYRM_TOOL_COUNT, agentDaemon, db } = ctx;
-            const { format: capFmt = "markdown" } = args;
-            const report = getCapabilities(db.getDatabase(), WYRM_TOOL_COUNT, {
-                detectVectorProvider: () => {
-                    if (process.env.WYRM_VECTOR_PROVIDER === 'openai')
-                        return 'openai';
-                    return 'ollama';
-                },
-                hasEncryption: () => !!process.env.WYRM_ENCRYPTION_KEY,
-                isFederationEnabled: () => true,
-                isAgentRunning: () => {
-                    try {
-                        return agentDaemon.status().running;
-                    }
-                    catch {
-                        return null;
-                    }
-                },
-            });
-            if (capFmt === 'json') {
-                return { content: [{ type: 'text', text: JSON.stringify(report, null, 2) }] };
-            }
-            return { content: [{ type: 'text', text: renderCapabilityBriefing(report) }] };
-        },
-    },
-    {
-        name: "wyrm_intro",
-        description: "Return a plain-English explanation of what Wyrm is and what it does. Aimed at HUMANS who don't yet understand Wyrm's value — co-founders, operators, designers, anyone who didn't read the docs. Call this when a human user asks 'what does Wyrm even do?' or seems unaware Wyrm is involved in their AI assistant's behavior. NOT for AI-agent self-orientation (use wyrm_capabilities for that).",
-        inputSchema: {
-            type: "object",
-            properties: {},
-        },
-        annotations: TOOL_ANNOTATIONS["wyrm_intro"],
-        aliases: [],
-        handler: async (args, ctx) => {
-            const { WYRM_PACKAGE_VERSION } = ctx;
-            const { renderIntro } = await import('../visibility.js');
-            return { content: [{ type: 'text', text: renderIntro(WYRM_PACKAGE_VERSION) }] };
-        },
-    },
-    {
-        name: "wyrm_migrate_prompt",
-        description: "Rewrite the Wyrm-managed block in this project's AI-client instruction files (.cursor/rules, .github/copilot-instructions.md, CLAUDE.md, etc.) to the current canonical version. Operator-authored content outside the <!-- wyrm:start --> / <!-- wyrm:end --> markers is preserved verbatim. Dry-run by default; pass apply:true to write changes.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                project_path: { type: "string", description: "Project root containing the client config files." },
-                apply: { type: "boolean", description: "Default false (dry-run). Set true to actually write changes." },
-            },
-            required: ["project_path"],
-        },
-        annotations: TOOL_ANNOTATIONS["wyrm_migrate_prompt"],
-        aliases: [],
-        handler: async (args, ctx) => {
-            const { migrateProject, renderMigrationReport } = await import('../migrate-prompt.js');
-            const { WYRM_INJECT_BLOCK } = await import('../autoconfig.js');
-            const { project_path: mpPath, apply: mpApply = false } = args;
-            if (!mpPath) {
-                return { content: [{ type: 'text', text: 'project_path required' }], isError: true };
-            }
-            const results = migrateProject({ projectPath: mpPath, newBlock: WYRM_INJECT_BLOCK, apply: mpApply });
-            return { content: [{ type: 'text', text: renderMigrationReport(results, mpApply) }] };
-        },
-    },
-    {
-        name: "wyrm_digest",
-        description: "Render a plain-English summary of what Wyrm has done for the operator over a period. Shows counts (sessions tracked, quests completed, repeated failures blocked, ground truths set, references clipped, hours logged) and highlights so a non-technical operator can see Wyrm's actual contribution. Use this when the user asks 'what did Wyrm do?', 'is Wyrm doing anything?', or to demonstrate value to skeptics.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                period: { type: "string", enum: ["today", "week", "month", "quarter", "year", "all"], description: "Reporting window (default: week)." },
-            },
-        },
-        annotations: TOOL_ANNOTATIONS["wyrm_digest"],
-        aliases: [],
-        handler: async (args, ctx) => {
-            const { db } = ctx;
-            const { gatherDigest, renderDigest } = await import('../visibility.js');
-            const { period = 'week' } = args;
-            const data = gatherDigest(db.getDatabase(), period);
-            return { content: [{ type: 'text', text: renderDigest(data) }] };
-        },
-    },
-    {
-        name: "wyrm_check_update",
-        description: "Check whether a newer wyrm-mcp is available on npm. Cached 24h by default; pass force:true to bypass cache.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                force: { type: "boolean", description: "Bypass the 24-hour cache and re-query the registry." },
-            },
-        },
-        annotations: TOOL_ANNOTATIONS["wyrm_check_update"],
-        aliases: [],
-        handler: async (args, ctx) => {
-            const { WYRM_PACKAGE_VERSION, db } = ctx;
-            const { force = false } = args;
-            const status = await getUpdateStatus(db.getDatabase(), WYRM_PACKAGE_VERSION, { force });
-            let text = `󱅝 **Update check**\n\n- Current: ${status.current}\n- Latest: ${status.latest ?? 'unknown (offline?)'}\n- Update available: ${status.updateAvailable ? 'yes' : 'no'}\n- Checked: ${status.checkedAt} (${status.source})`;
-            if (status.updateAvailable) {
-                text += `\n\nRun \`wyrm_self_update\` with \`confirm: true\` to upgrade, or \`npm install -g wyrm-mcp@latest\` from your shell.`;
-            }
-            return { content: [{ type: 'text', text }] };
-        },
-    },
-    {
-        name: "wyrm_self_update",
-        description: "Run `npm install -g wyrm-mcp@latest` to upgrade. Returns the install transcript. Requires the operator to have write access to the global npm prefix.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                confirm: { type: "boolean", description: "Must be true to actually run the upgrade (safety guard)." },
-            },
-            required: ["confirm"],
-        },
-        annotations: TOOL_ANNOTATIONS["wyrm_self_update"],
-        aliases: [],
-        handler: async (args, ctx) => {
-            const { confirm: selfConfirm = false } = args;
-            if (!selfConfirm) {
-                return {
-                    content: [{
-                            type: 'text',
-                            text: '󱅝 **Self-update declined**: call again with `confirm: true` to run `npm install -g wyrm-mcp@latest`. Note: requires write access to the global npm prefix.',
-                        }],
-                };
-            }
-            const transcript = await new Promise((resolve) => {
-                const proc = cpSpawn('npm', ['install', '-g', 'wyrm-mcp@latest'], { stdio: ['ignore', 'pipe', 'pipe'] });
-                const chunks = [];
-                proc.stdout.on('data', (b) => chunks.push(b.toString()));
-                proc.stderr.on('data', (b) => chunks.push(b.toString()));
-                proc.on('close', (code) => {
-                    chunks.push(`\n[exit ${code ?? 'unknown'}]`);
-                    resolve(chunks.join(''));
-                });
-                proc.on('error', (err) => resolve(`spawn failed: ${err.message}`));
-            });
-            return {
-                content: [{
-                        type: 'text',
-                        text: `󱅝 **Self-update transcript**\n\n\`\`\`\n${transcript}\n\`\`\`\n\nRestart your MCP client to pick up the new binary.`,
-                    }],
-            };
-        },
-    },
-];
-//# sourceMappingURL=companion.js.map
+import{TOOL_ANNOTATIONS as l}from"../tool-annotations.js";import{injectSystemPrompt as h}from"../autoconfig.js";import{buildPeerBuddyReply as g}from"../buddy.js";import{getCapabilities as f,renderCapabilityBriefing as w}from"../capabilities.js";import{getUpdateStatus as j}from"../version-check.js";import{isCompanionBuddyCall as b}from"./alias-adapters.js";import{spawn as _}from"child_process";const R=[{name:"wyrm_inject_prompt",description:"Opt-in: inject a Wyrm session-prime instruction block into .github/copilot-instructions.md and/or .cursor/rules for a project. Uses managed markers so re-runs are safe.",inputSchema:{type:"object",properties:{project_path:{type:"string",description:"Absolute path to the project root"},clients:{type:"array",items:{type:"string"},description:"Clients to inject into: 'copilot', 'cursor' (default: both detected)"}},required:["project_path"]},annotations:l.wyrm_inject_prompt,aliases:[],handler:async(o,c)=>{const{project_path:i,clients:a}=o,t=h(i,a??[]);let e=`\u{F115D} **System Prompt Injection**
+
+`;return t.injected.length>0&&(e+=`\u2705 Injected into:
+${t.injected.map(r=>`- ${r}`).join(`
+`)}
+
+`),t.skipped.length>0&&(e+=`\u25CB Skipped (unknown client): ${t.skipped.join(", ")}
+
+`),t.errors.length>0&&(e+=`\u274C Errors:
+${t.errors.map(r=>`- ${r}`).join(`
+`)}
+
+`),t.injected.length>0&&(e+="AI models in this project will now call `wyrm_session_prime` at the start of each conversation."),{content:[{type:"text",text:e}]}}},{name:"buddy",description:"Use when another buddy-compatible MCP server (or the operator) asks Wyrm for a brief, data-grounded status reply - the Buddy Protocol v1.0 well-known entry point. Companion params switch to the full companion reply; bare calls stay protocol-pure. Cycle-protected.",inputSchema:{type:"object",properties:{from_buddy:{type:"string",description:"Caller identity"},project_hint:{type:"string",description:"Scope the reply"},mood_hint:{type:"string",enum:["normal","celebratory","stuck","quiet"]},size:{type:"string",enum:["full","compact","mini"]},format:{type:"string",enum:["markdown","json"],description:"Peer mode only."},project_path:{type:"string",description:"Companion mode: project root (default cwd)"},persona:{type:"string",enum:["wyrm","drogo","berlin","sumair","custom"],description:"Companion voice."},persona_name:{type:"string",description:"For persona=custom"},mood:{type:"string",description:"Companion override (mood_hint values)"},federate:{type:"boolean",description:"Fold in other buddy MCPs"}}},annotations:l.buddy,aliases:[],handler:async(o,c)=>{const{WYRM_PACKAGE_VERSION:i,db:a,runCompanionBuddy:t}=c,e=o||{};if(b(o??{}))return await t(o??{});const r=o,s=g(a.getDatabase(),r,i);return r.format==="json"?{content:[{type:"text",text:JSON.stringify(s.json,null,2)}]}:{content:[{type:"text",text:s.markdown}]}}},{name:"wyrm_buddy",description:"Friendly, data-grounded coding companion. Returns a brief greeting + project state + suggested next step sourced entirely from Wyrm's real data. Every claim cites a real DB row ID \u2014 no hallucinated encouragement. Personas: wyrm (default, dragon-themed), drogo (gruff), berlin (precise), sumair (warm), custom. Moods: normal / celebratory / stuck / quiet \u2014 auto-detected. Sizes: full (10-line PhantomDragon-style mascot), compact (5-line workspace-friendly), mini (single-line inline prefix). Federates with other registered MCPs that expose `buddy`, `*_buddy`, or `buddy_*` tools \u2014 their replies fold into a 'From other buddies' section.",inputSchema:{type:"object",properties:{project_path:{type:"string",description:"Project root. Default: current cwd if registered."},mood:{type:"string",enum:["normal","celebratory","stuck","quiet"],description:"Override the auto-detected mood."},persona:{type:"string",enum:["wyrm","drogo","berlin","sumair","custom"],description:"Voice. Default: WYRM_BUDDY_DEFAULT_PERSONA env or 'wyrm'."},persona_name:{type:"string",description:"Required when persona === 'custom'."},size:{type:"string",enum:["full","compact","mini"],description:"Mascot size. 'full' = 10-line head+shoulder banner (default), 'compact' = 5-line workspace-friendly, 'mini' = single-line inline prefix on the greeting."},federate:{type:"boolean",description:"Query other registered MCPs with *_buddy tools and fold their replies in. Default: true if any are registered."}}},annotations:l.wyrm_buddy,aliases:[],handler:async(o,c)=>{const{runCompanionBuddy:i}=c;return await i(o??{})}},{name:"wyrm_token_set",description:"Set a design token for a project. Tokens are colour / type / spacing / motion / shadow / radius / breakpoint / custom \u2014 the design system primitives the project is built on. Stored first-class so AI helpers working on creative tasks don't have to re-derive the system from scattered CSS each time. Upserts on (project_id, category, key).",inputSchema:{type:"object",properties:{projectPath:{type:"string",description:"Project root path."},category:{type:"string",enum:["color","type","spacing","motion","shadow","radius","breakpoint","custom"],description:"Token category."},key:{type:"string",description:"Short slug, e.g. 'primary' / 'h1' / 'page-padding-md'."},value:{type:"string",description:"Actual value: '#00B89F' / 'Inter 900 2.5rem' / '1.25rem' / etc."},notes:{type:"string",description:"Optional why / when-to-use guidance."},source:{type:"string",enum:["user","derived","imported","observed"],description:"How the token was determined. Default: 'user'."}},required:["projectPath","category","key","value"]},annotations:l.wyrm_token_set,aliases:[],handler:async(o,c)=>{const{db:i,designSystem:a}=c,{projectPath:t,category:e,key:r,value:s,notes:p,source:u}=o,n=i.getProject(t);if(!n)return{content:[{type:"text",text:`Project not found: ${t}`}],isError:!0};const d=a().setToken({projectId:n.id,category:e,key:r,value:s,notes:p,source:u});return{content:[{type:"text",text:`\u{1F3A8} token set: \`${d.category}/${d.key}\` = \`${d.value}\``+(d.notes?` \u2014 ${d.notes}`:"")}]}}},{name:"wyrm_token_get",description:"Retrieve all design tokens for a project, optionally filtered by category. Returns the design system primitives the project is built on.",inputSchema:{type:"object",properties:{projectPath:{type:"string",description:"Project root path."},category:{type:"string",enum:["color","type","spacing","motion","shadow","radius","breakpoint","custom"],description:"Filter by category. Omit for all tokens."}},required:["projectPath"]},annotations:l.wyrm_token_get,aliases:[],handler:async(o,c)=>{const{db:i,designSystem:a}=c,{projectPath:t,category:e}=o,r=i.getProject(t);if(!r)return{content:[{type:"text",text:`Project not found: ${t}`}],isError:!0};const s=a().formatForContext(r.id);if(!s)return{content:[{type:"text",text:`_(no design tokens for ${r.name} yet \u2014 use \`wyrm_token_set\` to start the design system)_`}]};if(e){const p=a().listTokens(r.id,e);if(p.length===0)return{content:[{type:"text",text:`_(no ${e} tokens for ${r.name})_`}]};const u=[`### \u{1F3A8} ${e} tokens for ${r.name}`,""];for(const n of p)u.push(`- \`${n.key}\` = \`${n.value}\`${n.notes?` \u2014 ${n.notes}`:""}`);return{content:[{type:"text",text:u.join(`
+`)}]}}return{content:[{type:"text",text:s}]}}},{name:"wyrm_token_delete",description:"Remove a design token from a project.",inputSchema:{type:"object",properties:{projectPath:{type:"string",description:"Project root path."},category:{type:"string",enum:["color","type","spacing","motion","shadow","radius","breakpoint","custom"]},key:{type:"string",description:"Token key to remove."}},required:["projectPath","category","key"]},annotations:l.wyrm_token_delete,aliases:[],handler:async(o,c)=>{const{db:i,designSystem:a}=c,{projectPath:t,category:e,key:r}=o,s=i.getProject(t);return s?{content:[{type:"text",text:a().deleteToken(s.id,e,r)?`\u{1F5D1} removed \`${e}/${r}\``:`not found: \`${e}/${r}\``}]}:{content:[{type:"text",text:`Project not found: ${t}`}],isError:!0}}},{name:"wyrm_reference_add",description:"Clip a design reference (URL, image path, palette, or inline snippet) for inspiration. Stored per-project (or globally if no project path). Tag aggressively \u2014 tags drive future search and recall when building a new project in the same vein.",inputSchema:{type:"object",properties:{projectPath:{type:"string",description:"Project root path. Omit to attach as a global reference."},kind:{type:"string",enum:["url","image","palette","snippet"],description:"Reference type."},location:{type:"string",description:"URL, file path, or inline payload (e.g. palette like '#00B89F,#ff5a55,#0a0c0e' or a code snippet)."},title:{type:"string",description:"Short title \u2014 what is this reference?"},notes:{type:"string",description:"Why you saved it / what to remember about it."},tags:{type:"string",description:"Comma-separated tags \u2014 'hero,scroll-tied,framer-motion'."}},required:["kind","location"]},annotations:l.wyrm_reference_add,aliases:[],handler:async(o,c)=>{const{db:i,designSystem:a}=c,{projectPath:t,kind:e,location:r,title:s,notes:p,tags:u}=o;let n=null;if(t){const m=i.getProject(t);if(!m)return{content:[{type:"text",text:`Project not found: ${t}`}],isError:!0};n=m.id}const d=a().addReference({projectId:n,kind:e,location:r,title:s,notes:p,tags:u}),y=n?` (project ${n})`:" (global)";return{content:[{type:"text",text:`\u{1F4CC} reference #${d.id} saved${y}: \`${d.kind}\` ${d.title??d.location.slice(0,60)}${d.tags?` \xB7 tags: ${d.tags}`:""}`}]}}},{name:"wyrm_reference_list",description:"Browse saved design references. Filter by project or tag. Default: 50 most recent across all projects.",inputSchema:{type:"object",properties:{projectPath:{type:"string",description:"Limit to a specific project."},tag:{type:"string",description:"Filter to references containing this tag."},limit:{type:"number",description:"Max results (default 50, max 200)."}}},annotations:l.wyrm_reference_list,aliases:[],handler:async(o,c)=>{const{db:i,designSystem:a}=c,{projectPath:t,tag:e,limit:r}=o;let s;if(t){const n=i.getProject(t);if(!n)return{content:[{type:"text",text:`Project not found: ${t}`}],isError:!0};s=n.id}const p=a().listReferences({projectId:s,tag:e,limit:r});if(p.length===0)return{content:[{type:"text",text:"_(no references match)_"}]};const u=[`\u{1F4CC} **${p.length} reference${p.length===1?"":"s"}**`];for(const n of p){const d=n.project_id?`p${n.project_id}`:"global";u.push(`- [${n.id}/${d}] \`${n.kind}\` ${n.title??n.location.slice(0,60)}${n.tags?` \xB7 ${n.tags}`:""}`)}return{content:[{type:"text",text:u.join(`
+`)}]}}},{name:"wyrm_reference_search",description:"Full-text search across design references' title / notes / tags. Returns matching references sorted by recency.",inputSchema:{type:"object",properties:{query:{type:"string",description:"FTS5 query \u2014 keywords, phrases in quotes."},projectPath:{type:"string",description:"Limit to a specific project."},limit:{type:"number",description:"Max results (default 20, max 100)."}},required:["query"]},annotations:l.wyrm_reference_search,aliases:[],handler:async(o,c)=>{const{db:i,designSystem:a}=c,{query:t,projectPath:e,limit:r}=o;let s;if(e){const n=i.getProject(e);if(!n)return{content:[{type:"text",text:`Project not found: ${e}`}],isError:!0};s=n.id}const p=a().searchReferences(t,{projectId:s,limit:r});if(p.length===0)return{content:[{type:"text",text:`_(no references match "${t}")_`}]};const u=[`\u{1F50D} **${p.length} reference${p.length===1?"":"s"}** matching "${t}"`];for(const n of p){const d=n.project_id?`p${n.project_id}`:"global";u.push(`- [${n.id}/${d}] \`${n.kind}\` ${n.title??n.location.slice(0,60)}${n.tags?` \xB7 ${n.tags}`:""}`)}return{content:[{type:"text",text:u.join(`
+`)}]}}},{name:"wyrm_capabilities",description:"Use to learn what your memory system can actually do - feature inventory, why each matters, runtime state, and which tool to reach for. Call at session start instead of re-discovering the surface.",inputSchema:{type:"object",properties:{format:{type:"string",enum:["json","markdown"]}}},annotations:l.wyrm_capabilities,aliases:[],handler:async(o,c)=>{const{WYRM_TOOL_COUNT:i,agentDaemon:a,db:t}=c,{format:e="markdown"}=o,r=f(t.getDatabase(),i,{detectVectorProvider:()=>process.env.WYRM_VECTOR_PROVIDER==="openai"?"openai":"ollama",hasEncryption:()=>!!process.env.WYRM_ENCRYPTION_KEY,isFederationEnabled:()=>!0,isAgentRunning:()=>{try{return a.status().running}catch{return null}}});return e==="json"?{content:[{type:"text",text:JSON.stringify(r,null,2)}]}:{content:[{type:"text",text:w(r)}]}}},{name:"wyrm_intro",description:"Return a plain-English explanation of what Wyrm is and what it does. Aimed at HUMANS who don't yet understand Wyrm's value \u2014 co-founders, operators, designers, anyone who didn't read the docs. Call this when a human user asks 'what does Wyrm even do?' or seems unaware Wyrm is involved in their AI assistant's behavior. NOT for AI-agent self-orientation (use wyrm_capabilities for that).",inputSchema:{type:"object",properties:{}},annotations:l.wyrm_intro,aliases:[],handler:async(o,c)=>{const{WYRM_PACKAGE_VERSION:i}=c,{renderIntro:a}=await import("../visibility.js");return{content:[{type:"text",text:a(i)}]}}},{name:"wyrm_migrate_prompt",description:"Rewrite the Wyrm-managed block in this project's AI-client instruction files (.cursor/rules, .github/copilot-instructions.md, CLAUDE.md, etc.) to the current canonical version. Operator-authored content outside the <!-- wyrm:start --> / <!-- wyrm:end --> markers is preserved verbatim. Dry-run by default; pass apply:true to write changes.",inputSchema:{type:"object",properties:{project_path:{type:"string",description:"Project root containing the client config files."},apply:{type:"boolean",description:"Default false (dry-run). Set true to actually write changes."}},required:["project_path"]},annotations:l.wyrm_migrate_prompt,aliases:[],handler:async(o,c)=>{const{migrateProject:i,renderMigrationReport:a}=await import("../migrate-prompt.js"),{WYRM_INJECT_BLOCK:t}=await import("../autoconfig.js"),{project_path:e,apply:r=!1}=o;if(!e)return{content:[{type:"text",text:"project_path required"}],isError:!0};const s=i({projectPath:e,newBlock:t,apply:r});return{content:[{type:"text",text:a(s,r)}]}}},{name:"wyrm_digest",description:"Render a plain-English summary of what Wyrm has done for the operator over a period. Shows counts (sessions tracked, quests completed, repeated failures blocked, ground truths set, references clipped, hours logged) and highlights so a non-technical operator can see Wyrm's actual contribution. Use this when the user asks 'what did Wyrm do?', 'is Wyrm doing anything?', or to demonstrate value to skeptics.",inputSchema:{type:"object",properties:{period:{type:"string",enum:["today","week","month","quarter","year","all"],description:"Reporting window (default: week)."}}},annotations:l.wyrm_digest,aliases:[],handler:async(o,c)=>{const{db:i}=c,{gatherDigest:a,renderDigest:t}=await import("../visibility.js"),{period:e="week"}=o,r=a(i.getDatabase(),e);return{content:[{type:"text",text:t(r)}]}}},{name:"wyrm_check_update",description:"Check whether a newer wyrm-mcp is available on npm. Cached 24h by default; pass force:true to bypass cache.",inputSchema:{type:"object",properties:{force:{type:"boolean",description:"Bypass the 24-hour cache and re-query the registry."}}},annotations:l.wyrm_check_update,aliases:[],handler:async(o,c)=>{const{WYRM_PACKAGE_VERSION:i,db:a}=c,{force:t=!1}=o,e=await j(a.getDatabase(),i,{force:t});let r=`\u{F115D} **Update check**
+
+- Current: ${e.current}
+- Latest: ${e.latest??"unknown (offline?)"}
+- Update available: ${e.updateAvailable?"yes":"no"}
+- Checked: ${e.checkedAt} (${e.source})`;return e.updateAvailable&&(r+="\n\nRun `wyrm_self_update` with `confirm: true` to upgrade, or `npm install -g wyrm-mcp@latest` from your shell."),{content:[{type:"text",text:r}]}}},{name:"wyrm_self_update",description:"Run `npm install -g wyrm-mcp@latest` to upgrade. Returns the install transcript. Requires the operator to have write access to the global npm prefix.",inputSchema:{type:"object",properties:{confirm:{type:"boolean",description:"Must be true to actually run the upgrade (safety guard)."}},required:["confirm"]},annotations:l.wyrm_self_update,aliases:[],handler:async(o,c)=>{const{confirm:i=!1}=o;return i?{content:[{type:"text",text:`\u{F115D} **Self-update transcript**
+
+\`\`\`
+${await new Promise(t=>{const e=_("npm",["install","-g","wyrm-mcp@latest"],{stdio:["ignore","pipe","pipe"]}),r=[];e.stdout.on("data",s=>r.push(s.toString())),e.stderr.on("data",s=>r.push(s.toString())),e.on("close",s=>{r.push(`
+[exit ${s??"unknown"}]`),t(r.join(""))}),e.on("error",s=>t(`spawn failed: ${s.message}`))})}
+\`\`\`
+
+Restart your MCP client to pick up the new binary.`}]}:{content:[{type:"text",text:"\u{F115D} **Self-update declined**: call again with `confirm: true` to run `npm install -g wyrm-mcp@latest`. Note: requires write access to the global npm prefix."}]}}}];export{R as companionToolSpecs};