fifony 0.1.21 → 0.1.22

package/dist/mcp/server.js

@@ -1,105 +1,29 @@
 import {
   inferCapabilityPaths,
+  parseIssueState,
   renderPrompt,
   resolveTaskCapabilities
-} from "../chunk-SMGXYOWU.js";
+} from "../chunk-O665NS5E.js";
 
 // src/mcp/server.ts
-import { createHash } from "crypto";
-import { existsSync as existsSync3 } from "fs";
-import { dirname, join as join3, resolve as resolve3 } from "path";
-import { env as env2, stdin, stdout } from "process";
-import { fileURLToPath as fileURLToPath2 } from "url";
-
-// src/integrations/catalog.ts
-import { existsSync, readdirSync, readFileSync } from "fs";
-import { homedir } from "os";
-import { join, resolve } from "path";
-function listNames(basePath) {
-  if (!existsSync(basePath)) {
-    return [];
-  }
-  return readdirSync(basePath, { withFileTypes: true }).filter((entry) => entry.isDirectory() || entry.isFile()).map((entry) => entry.name).sort((left, right) => left.localeCompare(right));
-}
-function readSkillSummary(skillPath) {
-  try {
-    const skillFile = join(skillPath, "SKILL.md");
-    if (!existsSync(skillFile)) {
-      return "";
-    }
-    const contents = readFileSync(skillFile, "utf8");
-    const firstParagraph = contents.split("\n").map((line) => line.trim()).filter(Boolean).find((line) => !line.startsWith("#"));
-    return firstParagraph ?? "";
-  } catch {
-    return "";
-  }
-}
-function discoverIntegrations(workspaceRoot) {
-  const home = homedir();
-  const agentLocations = [
-    resolve(workspaceRoot, ".codex", "agents"),
-    resolve(workspaceRoot, "agents"),
-    join(home, ".codex", "agents"),
-    join(home, ".claude", "agents")
-  ];
-  const skillLocations = [
-    resolve(workspaceRoot, ".codex", "skills"),
-    resolve(workspaceRoot, ".claude", "skills"),
-    join(home, ".codex", "skills"),
-    join(home, ".claude", "skills")
-  ];
-  const agencyItems = agentLocations.flatMap((location) => listNames(location).map((name) => ({ location, name }))).filter(({ name }) => name.startsWith("agency-")).map(({ location, name }) => `${name} @ ${location}`);
-  const impeccableItems = skillLocations.flatMap((location) => listNames(location).map((name) => ({ location, name }))).filter(
-    ({ name }) => name === "teach-impeccable" || name === "frontend-design" || name === "polish" || name === "audit" || name === "critique" || name.includes("impeccable")
-  ).map(({ location, name }) => {
-    const summary = readSkillSummary(join(location, name));
-    return summary ? `${name} @ ${location} \u2014 ${summary}` : `${name} @ ${location}`;
-  });
-  return [
-    {
-      id: "agency-agents",
-      kind: "agents",
-      installed: agencyItems.length > 0,
-      locations: agentLocations.filter((location) => existsSync(location)),
-      items: agencyItems,
-      summary: agencyItems.length > 0 ? "Local specialized agent profiles are available for planner/executor/reviewer roles." : "No agency agent profiles were detected in the standard local locations."
-    },
-    {
-      id: "impeccable",
-      kind: "skills",
-      installed: impeccableItems.length > 0,
-      locations: skillLocations.filter((location) => existsSync(location)),
-      items: impeccableItems,
-      summary: impeccableItems.length > 0 ? "Frontend and design-oriented skills are available for review and polish workflows." : "No impeccable-related skills were detected in the standard local skill directories."
-    }
-  ];
-}
-async function buildIntegrationSnippet(integrationId, workspaceRoot) {
-  if (integrationId === "agency-agents") {
-    return renderPrompt("integrations-agency-agents", { workspaceRoot });
-  }
-  if (integrationId === "impeccable") {
-    return renderPrompt("integrations-impeccable");
-  }
-  return "Unknown integration.";
-}
+import { env as env3, stdin } from "process";
 
 // src/mcp/database.ts
-import { existsSync as existsSync2, readFileSync as readFileSync2 } from "fs";
-import { basename, join as join2, resolve as resolve2 } from "path";
+import { existsSync, readFileSync } from "fs";
+import { basename, join, resolve } from "path";
 import { env } from "process";
-import { homedir as homedir2 } from "os";
+import { homedir } from "os";
 import { fileURLToPath } from "url";
 var WORKSPACE_ROOT = env.FIFONY_WORKSPACE_ROOT ?? process.cwd();
 var PERSISTENCE_ROOT = env.FIFONY_PERSISTENCE ?? WORKSPACE_ROOT;
 var STATE_ROOT = resolvePersistenceRoot(PERSISTENCE_ROOT);
-var DATABASE_PATH = join2(STATE_ROOT, "s3db");
+var DATABASE_PATH = join(STATE_ROOT, "s3db");
 var STORAGE_BUCKET = env.FIFONY_STORAGE_BUCKET ?? "fifony";
 var STORAGE_KEY_PREFIX = env.FIFONY_STORAGE_KEY_PREFIX ?? "state";
 var DEBUG_BOOT = env.FIFONY_DEBUG_BOOT === "1";
 function resolvePersistenceRoot(value) {
-  const resolved = value.startsWith("file://") ? fileURLToPath(value) : value.startsWith("~/") ? resolve2(homedir2(), value.slice(2)) : resolve2(value);
-  return basename(resolved) === ".fifony" ? resolved : join2(resolved, ".fifony");
+  const resolved = value.startsWith("file://") ? fileURLToPath(value) : value.startsWith("~/") ? resolve(homedir(), value.slice(2)) : resolve(value);
+  return basename(resolved) === ".fifony" ? resolved : join(resolved, ".fifony");
 }
 var RUNTIME_RESOURCE = "runtime_state";
 var ISSUE_RESOURCE = "issues";
@@ -128,7 +52,7 @@ function nowIso() {
   return (/* @__PURE__ */ new Date()).toISOString();
 }
 function safeRead(path) {
-  return existsSync2(path) ? readFileSync2(path, "utf8") : "";
+  return existsSync(path) ? readFileSync(path, "utf8") : "";
 }
 async function loadS3dbModule() {
   try {
@@ -315,23 +239,134 @@ async function appendEvent(level, message, payload = {}, issueId) {
   });
 }
 
-// src/mcp/server.ts
+// src/mcp/jsonrpc-transport.ts
+import { stdout } from "process";
+
+// src/integrations/catalog.ts
+import { existsSync as existsSync2, readdirSync, readFileSync as readFileSync2 } from "fs";
+import { homedir as homedir2 } from "os";
+import { join as join2, resolve as resolve2 } from "path";
+function listNames(basePath) {
+  if (!existsSync2(basePath)) {
+    return [];
+  }
+  return readdirSync(basePath, { withFileTypes: true }).filter((entry) => entry.isDirectory() || entry.isFile()).map((entry) => entry.name).sort((left, right) => left.localeCompare(right));
+}
+function readSkillSummary(skillPath) {
+  try {
+    const skillFile = join2(skillPath, "SKILL.md");
+    if (!existsSync2(skillFile)) {
+      return "";
+    }
+    const contents = readFileSync2(skillFile, "utf8");
+    const firstParagraph = contents.split("\n").map((line) => line.trim()).filter(Boolean).find((line) => !line.startsWith("#"));
+    return firstParagraph ?? "";
+  } catch {
+    return "";
+  }
+}
+function discoverIntegrations(workspaceRoot) {
+  const home = homedir2();
+  const agentLocations = [
+    resolve2(workspaceRoot, ".codex", "agents"),
+    resolve2(workspaceRoot, "agents"),
+    join2(home, ".codex", "agents"),
+    join2(home, ".claude", "agents")
+  ];
+  const skillLocations = [
+    resolve2(workspaceRoot, ".codex", "skills"),
+    resolve2(workspaceRoot, ".claude", "skills"),
+    join2(home, ".codex", "skills"),
+    join2(home, ".claude", "skills")
+  ];
+  const agencyItems = agentLocations.flatMap((location) => listNames(location).map((name) => ({ location, name }))).filter(({ name }) => name.startsWith("agency-")).map(({ location, name }) => `${name} @ ${location}`);
+  const impeccableItems = skillLocations.flatMap((location) => listNames(location).map((name) => ({ location, name }))).filter(
+    ({ name }) => name === "teach-impeccable" || name === "frontend-design" || name === "polish" || name === "audit" || name === "critique" || name.includes("impeccable")
+  ).map(({ location, name }) => {
+    const summary = readSkillSummary(join2(location, name));
+    return summary ? `${name} @ ${location} \u2014 ${summary}` : `${name} @ ${location}`;
+  });
+  return [
+    {
+      id: "agency-agents",
+      kind: "agents",
+      installed: agencyItems.length > 0,
+      locations: agentLocations.filter((location) => existsSync2(location)),
+      items: agencyItems,
+      summary: agencyItems.length > 0 ? "Local specialized agent profiles are available for planner/executor/reviewer roles." : "No agency agent profiles were detected in the standard local locations."
+    },
+    {
+      id: "impeccable",
+      kind: "skills",
+      installed: impeccableItems.length > 0,
+      locations: skillLocations.filter((location) => existsSync2(location)),
+      items: impeccableItems,
+      summary: impeccableItems.length > 0 ? "Frontend and design-oriented skills are available for review and polish workflows." : "No impeccable-related skills were detected in the standard local skill directories."
+    }
+  ];
+}
+async function buildIntegrationSnippet(integrationId, workspaceRoot) {
+  if (integrationId === "agency-agents") {
+    return renderPrompt("integrations-agency-agents", { workspaceRoot });
+  }
+  if (integrationId === "impeccable") {
+    return renderPrompt("integrations-impeccable");
+  }
+  return "Unknown integration.";
+}
+
+// src/mcp/api-client.ts
+import { env as env2 } from "process";
+async function resolveApiBaseUrl() {
+  const envPort = env2.FIFONY_API_PORT;
+  if (envPort) return `http://localhost:${envPort}`;
+  const runtime = await getRuntimeSnapshot();
+  const config = runtime.config;
+  const port = config?.dashboardPort;
+  if (port) return `http://localhost:${port}`;
+  for (const candidate of [4e3, 3e3, 8080]) {
+    try {
+      const res = await fetch(`http://localhost:${candidate}/health`, { signal: AbortSignal.timeout(1e3) });
+      if (res.ok) return `http://localhost:${candidate}`;
+    } catch {
+    }
+  }
+  throw new Error("Fifony runtime API is not reachable. Start the runtime with --port to enable plan/refine/approve/analytics tools.");
+}
+async function apiPost(path, body = {}) {
+  const base = await resolveApiBaseUrl();
+  const res = await fetch(`${base}${path}`, {
+    method: "POST",
+    headers: { "content-type": "application/json" },
+    body: JSON.stringify(body),
+    signal: AbortSignal.timeout(12e4)
+  });
+  const json = await res.json();
+  if (!res.ok || json.ok === false) {
+    throw new Error(typeof json.error === "string" ? json.error : `API request failed: ${res.status}`);
+  }
+  return json;
+}
+async function apiGet(path) {
+  const base = await resolveApiBaseUrl();
+  const res = await fetch(`${base}${path}`, {
+    signal: AbortSignal.timeout(3e4)
+  });
+  const json = await res.json();
+  if (!res.ok || json.ok === false) {
+    throw new Error(typeof json.error === "string" ? json.error : `API request failed: ${res.status}`);
+  }
+  return json;
+}
+
+// src/mcp/resources/resource-builder.ts
+import { dirname, join as join3, resolve as resolve3 } from "path";
+import { fileURLToPath as fileURLToPath2 } from "url";
 var __filename = fileURLToPath2(import.meta.url);
 var __dirname = dirname(__filename);
-var PACKAGE_ROOT = resolve3(__dirname, "../..");
-var WORKFLOW_PATH = join3(WORKSPACE_ROOT, "WORKFLOW.md");
+var PACKAGE_ROOT = resolve3(__dirname, "../../..");
 var README_PATH = join3(PACKAGE_ROOT, "README.md");
 var FIFONY_GUIDE_PATH = join3(PACKAGE_ROOT, "FIFONY.md");
-var DEBUG_BOOT2 = env2.FIFONY_DEBUG_BOOT === "1";
-var incomingBuffer = Buffer.alloc(0);
-function debugBoot2(message) {
-  if (!DEBUG_BOOT2) return;
-  process.stderr.write(`[FIFONY_DEBUG_BOOT] ${message}
-`);
-}
-function hashInput(value) {
-  return createHash("sha1").update(value).digest("hex").slice(0, 10);
-}
 async function buildIntegrationGuide() {
   return renderPrompt("mcp-integration-guide", {
     workspaceRoot: WORKSPACE_ROOT,
@@ -363,7 +398,6 @@ async function buildStateSummary() {
     workspaceRoot: WORKSPACE_ROOT,
     persistenceRoot: PERSISTENCE_ROOT,
     stateRoot: STATE_ROOT,
-    workflowPresent: existsSync3(WORKFLOW_PATH),
     runtimeUpdatedAt: runtime.updatedAt ?? null,
     issueCount: issues.length,
     issuesByState: byState,
@@ -387,13 +421,15 @@ async function buildIssuePrompt(issue, provider, role) {
     provider,
     id: issue.id,
     title: issue.title,
-    state: issue.state ?? "Todo",
+    state: issue.state ?? "Planning",
     capabilityCategory: resolution.category,
     overlays: resolution.overlays,
     paths: Array.isArray(issue.paths) ? issue.paths.filter((value) => typeof value === "string") : [],
     description: issue.description || "No description provided."
   });
 }
+
+// src/mcp/resources/resource-handlers.ts
 async function listResourcesMcp() {
   const issues = await getIssues();
   const resources = [
@@ -405,9 +441,6 @@ async function listResourcesMcp() {
     { uri: "fifony://integrations", name: "Fifony integrations", description: "Discovered local integrations such as agency-agents and impeccable skills.", mimeType: "application/json" },
     { uri: "fifony://capabilities", name: "Fifony capability routing", description: "How Fifony would route current issues to providers, profiles, and overlays.", mimeType: "application/json" }
   ];
-  if (existsSync3(WORKFLOW_PATH)) {
-    resources.push({ uri: "fifony://workspace/workflow", name: "Workspace workflow", description: "The active WORKFLOW.md from the target workspace.", mimeType: "text/markdown" });
-  }
   resources.push(
     { uri: "fifony://analytics", name: "Token usage analytics", description: "Token usage analytics snapshot including totals, cost estimates, and per-model breakdown.", mimeType: "application/json" },
     { uri: "fifony://workflow/config", name: "Workflow config", description: "Current pipeline workflow configuration (plan/execute/review providers, models, and effort).", mimeType: "application/json" },
@@ -466,7 +499,6 @@ async function readResource(uri) {
       )
     }];
   }
-  if (uri === "fifony://workspace/workflow") return [{ uri, mimeType: "text/markdown", text: safeRead(WORKFLOW_PATH) }];
   if (uri === "fifony://analytics") {
     try {
       const result = await apiGet("/api/analytics/tokens");
@@ -548,407 +580,52 @@ async function readResource(uri) {
   }
   throw new Error(`Unknown resource: ${uri}`);
 }
-function listPrompts() {
+
+// src/mcp/tools/tool-list.ts
+function listTools() {
   return [
-    { name: "fifony-integrate-client", description: "Generate setup instructions for connecting an MCP-capable client to Fifony.", arguments: [{ name: "client", description: "Client name, e.g. codex or claude.", required: true }, { name: "goal", description: "What the client should do with Fifony.", required: false }] },
-    { name: "fifony-plan-issue", description: "Generate a planning prompt for a specific issue in the Fifony store.", arguments: [{ name: "issueId", description: "Issue identifier.", required: true }, { name: "provider", description: "Agent provider name.", required: false }] },
-    { name: "fifony-review-workflow", description: "Review the current WORKFLOW.md and propose improvements for orchestration quality.", arguments: [{ name: "provider", description: "Reviewing model or client.", required: false }] },
-    { name: "fifony-use-integration", description: "Generate a concrete integration prompt for agency-agents or impeccable.", arguments: [{ name: "integration", description: "Integration id: agency-agents or impeccable.", required: true }] },
-    { name: "fifony-route-task", description: "Explain which providers, profiles, and overlays Fifony would choose for a task.", arguments: [{ name: "title", description: "Task title.", required: true }, { name: "description", description: "Task description.", required: false }, { name: "labels", description: "Comma-separated labels.", required: false }, { name: "paths", description: "Comma-separated target paths or files.", required: false }] },
-    { name: "fifony-diagnose-blocked", description: "Help diagnose why an issue is blocked or failing, analyzing the issue plan, last error, history, and events.", arguments: [{ name: "issueId", description: "Issue identifier to diagnose.", required: true }] },
-    { name: "fifony-weekly-summary", description: "Generate a weekly progress summary including issues created, completed, blocked, and token usage.", arguments: [] },
-    { name: "fifony-refine-plan", description: "Guided plan refinement prompt that shows the current plan and helps provide specific feedback.", arguments: [{ name: "issueId", description: "Issue identifier whose plan to refine.", required: true }, { name: "concern", description: "Optional specific concern to address in refinement.", required: false }] },
-    { name: "fifony-code-review", description: "Review code changes for an issue by analyzing its git diff.", arguments: [{ name: "issueId", description: "Issue identifier to review.", required: true }] }
+    { name: "fifony.status", description: "Return a compact status summary for the current Fifony workspace.", inputSchema: { type: "object", properties: {}, additionalProperties: false } },
+    { name: "fifony.list_issues", description: "List issues from the Fifony durable store.", inputSchema: { type: "object", properties: { state: { type: "string" }, capabilityCategory: { type: "string" }, category: { type: "string" } }, additionalProperties: false } },
+    { name: "fifony.create_issue", description: "Create a new issue directly in the Fifony durable store.", inputSchema: { type: "object", properties: { id: { type: "string" }, title: { type: "string" }, description: { type: "string" }, priority: { type: "number" }, state: { type: "string" }, labels: { type: "array", items: { type: "string" } }, paths: { type: "array", items: { type: "string" } } }, required: ["title"], additionalProperties: false } },
+    { name: "fifony.update_issue_state", description: "Update an issue state in the Fifony store and append an event.", inputSchema: { type: "object", properties: { issueId: { type: "string" }, state: { type: "string" }, note: { type: "string" } }, required: ["issueId", "state"], additionalProperties: false } },
+    { name: "fifony.plan", description: "Generate an AI plan for an issue. The issue must be in Planning state. Returns the plan summary and step count.", inputSchema: { type: "object", properties: { issueId: { type: "string", description: "The issue identifier to plan." }, fast: { type: "boolean", description: "Use fast planning mode (less thorough but quicker)." } }, required: ["issueId"], additionalProperties: false } },
+    { name: "fifony.refine", description: "Refine an existing plan with feedback. The issue must already have a plan.", inputSchema: { type: "object", properties: { issueId: { type: "string", description: "The issue identifier whose plan to refine." }, feedback: { type: "string", description: "Feedback to guide the plan refinement." } }, required: ["issueId", "feedback"], additionalProperties: false } },
+    { name: "fifony.approve", description: "Approve a plan and move the issue to Planned for execution.", inputSchema: { type: "object", properties: { issueId: { type: "string", description: "The issue identifier to approve." } }, required: ["issueId"], additionalProperties: false } },
+    { name: "fifony.merge", description: "Merge workspace changes back into the project root. Copies new/modified files from the issue workspace to TARGET_ROOT and removes files that were deleted. Skips fifony internal files, node_modules, .git, and dist.", inputSchema: { type: "object", properties: { issueId: { type: "string", description: "The issue identifier whose workspace to merge." } }, required: ["issueId"], additionalProperties: false } },
+    { name: "fifony.analytics", description: "Get token usage analytics including overall totals, cost estimates, and top issues by token consumption.", inputSchema: { type: "object", properties: {}, additionalProperties: false } },
+    { name: "fifony.integration_config", description: "Generate a ready-to-paste MCP client configuration snippet for this Fifony workspace.", inputSchema: { type: "object", properties: { client: { type: "string" } }, additionalProperties: false } },
+    { name: "fifony.list_integrations", description: "List discovered local integrations such as agency-agents profiles and impeccable skills.", inputSchema: { type: "object", properties: {}, additionalProperties: false } },
+    { name: "fifony.integration_snippet", description: "Generate a workflow or prompt snippet for a discovered integration.", inputSchema: { type: "object", properties: { integration: { type: "string" } }, required: ["integration"], additionalProperties: false } },
+    { name: "fifony.resolve_capabilities", description: "Resolve which providers, roles, profiles, and overlays Fifony should use for a task.", inputSchema: { type: "object", properties: { title: { type: "string" }, description: { type: "string" }, labels: { type: "array", items: { type: "string" } }, paths: { type: "array", items: { type: "string" } } }, required: ["title"], additionalProperties: false } },
+    { name: "fifony.get_issue", description: "Get full detail of a single issue including plan, history, events, and diff status.", inputSchema: { type: "object", properties: { issueId: { type: "string", description: "The issue identifier." } }, required: ["issueId"], additionalProperties: false } },
+    { name: "fifony.cancel_issue", description: "Cancel an issue, moving it to Cancelled state.", inputSchema: { type: "object", properties: { issueId: { type: "string", description: "The issue identifier to cancel." } }, required: ["issueId"], additionalProperties: false } },
+    { name: "fifony.retry_issue", description: "Retry a failed or blocked issue, resetting it to Planned state.", inputSchema: { type: "object", properties: { issueId: { type: "string", description: "The issue identifier to retry." } }, required: ["issueId"], additionalProperties: false } },
+    { name: "fifony.enhance", description: "AI-enhance an issue title or description. Provide either an issueId to enhance an existing issue, or title+description for standalone enhancement.", inputSchema: { type: "object", properties: { issueId: { type: "string", description: "Issue identifier (optional, for existing issues)." }, title: { type: "string", description: "Issue title (for standalone enhancement)." }, description: { type: "string", description: "Issue description (for standalone enhancement)." }, field: { type: "string", enum: ["title", "description"], description: "Which field to enhance." } }, required: ["field"], additionalProperties: false } },
+    { name: "fifony.get_diff", description: "Get git diff for an issue's workspace, including per-file summary and full diff text.", inputSchema: { type: "object", properties: { issueId: { type: "string", description: "The issue identifier." } }, required: ["issueId"], additionalProperties: false } },
+    { name: "fifony.get_live", description: "Get live agent output for a running issue, including log tail, PID, elapsed time, and status.", inputSchema: { type: "object", properties: { issueId: { type: "string", description: "The issue identifier." } }, required: ["issueId"], additionalProperties: false } },
+    { name: "fifony.get_events", description: "Get event feed, optionally filtered by issue, kind, or limited.", inputSchema: { type: "object", properties: { issueId: { type: "string", description: "Filter events by issue identifier." }, kind: { type: "string", description: "Filter events by kind (info, error, state, manual, progress)." }, limit: { type: "number", description: "Maximum number of events to return (default 50)." } }, additionalProperties: false } },
+    { name: "fifony.get_workflow", description: "Get the current pipeline workflow configuration including providers, models, and effort for plan/execute/review stages.", inputSchema: { type: "object", properties: {}, additionalProperties: false } },
+    { name: "fifony.set_workflow", description: "Update the pipeline workflow configuration. Each stage (plan, execute, review) needs provider, model, and effort.", inputSchema: { type: "object", properties: { plan: { type: "object", properties: { provider: { type: "string" }, model: { type: "string" }, effort: { type: "string" } }, required: ["provider", "model", "effort"] }, execute: { type: "object", properties: { provider: { type: "string" }, model: { type: "string" }, effort: { type: "string" } }, required: ["provider", "model", "effort"] }, review: { type: "object", properties: { provider: { type: "string" }, model: { type: "string" }, effort: { type: "string" } }, required: ["provider", "model", "effort"] } }, required: ["plan", "execute", "review"], additionalProperties: false } },
+    { name: "fifony.scan_project", description: "Scan the target project structure, returning files, directories, and detected technologies.", inputSchema: { type: "object", properties: {}, additionalProperties: false } },
+    { name: "fifony.install_agents", description: "Install agents from the Fifony catalog into the target workspace.", inputSchema: { type: "object", properties: { agents: { type: "array", items: { type: "string" }, description: "List of agent names to install." } }, required: ["agents"], additionalProperties: false } },
+    { name: "fifony.install_skills", description: "Install skills from the Fifony catalog into the target workspace.", inputSchema: { type: "object", properties: { skills: { type: "array", items: { type: "string" }, description: "List of skill names to install." } }, required: ["skills"], additionalProperties: false } }
   ];
 }
-async function getPrompt(name, args = {}) {
-  if (name === "fifony-integrate-client") {
-    const client = typeof args.client === "string" && args.client.trim() ? args.client.trim() : "mcp-client";
-    const goal = typeof args.goal === "string" && args.goal.trim() ? args.goal.trim() : "integrate with the local Fifony workspace";
-    const integrationGuide = await buildIntegrationGuide();
-    return {
-      description: "Client integration prompt for Fifony.",
-      messages: [{
-        role: "user",
-        content: {
-          type: "text",
-          text: await renderPrompt("mcp-integrate-client", { client, goal, integrationGuide })
-        }
-      }]
-    };
-  }
-  if (name === "fifony-plan-issue") {
-    const issueId = typeof args.issueId === "string" ? args.issueId : "";
-    const provider = typeof args.provider === "string" && args.provider.trim() ? args.provider.trim() : "codex";
-    const issue = issueId ? await getIssue(issueId) : null;
-    if (!issue) throw new Error(`Issue not found: ${issueId}`);
-    return {
-      description: "Issue planning prompt grounded in the Fifony issue store.",
-      messages: [{
-        role: "user",
-        content: { type: "text", text: await buildIssuePrompt(issue, provider, "planner") }
-      }]
-    };
-  }
-  if (name === "fifony-review-workflow") {
-    const provider = typeof args.provider === "string" && args.provider.trim() ? args.provider.trim() : "claude";
-    return {
-      description: "Workflow review prompt for Fifony orchestration.",
-      messages: [{
-        role: "user",
-        content: {
-          type: "text",
-          text: await renderPrompt("mcp-review-workflow", {
-            provider,
-            workspaceRoot: WORKSPACE_ROOT,
-            workflowPresent: existsSync3(WORKFLOW_PATH) ? "yes" : "no"
-          })
-        }
-      }]
-    };
-  }
-  if (name === "fifony-use-integration") {
-    const integration = typeof args.integration === "string" ? args.integration : "";
-    return {
-      description: "Integration guidance for a discovered Fifony extension.",
-      messages: [{
-        role: "user",
-        content: { type: "text", text: await buildIntegrationSnippet(integration, WORKSPACE_ROOT) }
-      }]
-    };
-  }
-  if (name === "fifony-route-task") {
-    const title = typeof args.title === "string" ? args.title : "";
-    const description = typeof args.description === "string" ? args.description : "";
-    const labels = typeof args.labels === "string" ? args.labels.split(",").map((label) => label.trim()).filter(Boolean) : [];
-    const paths = typeof args.paths === "string" ? args.paths.split(",").map((value) => value.trim()).filter(Boolean) : [];
-    const resolution = resolveTaskCapabilities({ title, description, labels, paths });
-    return {
-      description: "Task routing prompt produced by the Fifony capability resolver.",
-      messages: [{
-        role: "user",
-        content: {
-          type: "text",
-          text: await renderPrompt("mcp-route-task", {
-            resolutionJson: JSON.stringify(resolution, null, 2)
-          })
-        }
-      }]
-    };
-  }
-  if (name === "fifony-diagnose-blocked") {
-    const issueId = typeof args.issueId === "string" ? args.issueId.trim() : "";
-    if (!issueId) throw new Error("issueId is required");
-    const issue = await getIssue(issueId);
-    if (!issue) throw new Error(`Issue not found: ${issueId}`);
-    const issueData = issue;
-    let events = [];
-    try {
-      const evResult = await apiGet(`/api/events/feed?issueId=${encodeURIComponent(issueId)}`);
-      events = Array.isArray(evResult.events) ? evResult.events.slice(0, 30) : [];
-    } catch {
-      const localEvents = await listEvents({ limit: 100 });
-      events = localEvents.filter((event) => event.issueId === issueId).slice(0, 30);
-    }
-    const plan = issueData.plan ?? null;
-    const history = Array.isArray(issueData.history) ? issueData.history : [];
-    const lastError = issueData.lastError ?? null;
-    const state = issueData.state ?? "Unknown";
-    const attempts = issueData.attempts ?? 0;
-    const maxAttempts = issueData.maxAttempts ?? 3;
-    const diagnosticText = [
-      `# Diagnostic Report for Issue ${issueId}`,
-      ``,
-      `## Issue Details`,
-      `- **Title**: ${issueData.title ?? "Unknown"}`,
-      `- **State**: ${state}`,
-      `- **Attempts**: ${attempts} / ${maxAttempts}`,
-      `- **Last Error**: ${lastError ?? "None"}`,
-      `- **Updated At**: ${issueData.updatedAt ?? "Unknown"}`,
-      ``,
-      `## Plan`,
-      plan ? `- **Summary**: ${plan.summary ?? plan.title ?? "No summary"}` : "No plan generated.",
-      plan?.steps ? `- **Steps**: ${plan.steps.length} step(s)` : "",
-      plan?.estimatedComplexity ? `- **Estimated Complexity**: ${plan.estimatedComplexity}` : "",
-      ``,
-      `## History`,
-      ...history.length > 0 ? history.slice(-15).map((entry) => `- ${entry}`) : ["No history entries."],
-      ``,
-      `## Recent Events`,
-      ...events.length > 0 ? events.slice(0, 15).map((event) => `- [${event.kind ?? "info"}] ${event.at ?? ""}: ${event.message ?? ""}`) : ["No events found."],
-      ``,
-      `## Diagnostic Questions`,
-      `Based on the information above, please analyze:`,
-      `1. What is the root cause of the issue being in "${state}" state?`,
-      `2. Is the error recoverable? If so, what steps should be taken?`,
-      `3. Does the plan need modification before retrying?`,
-      `4. Are there any dependency or configuration issues that need resolution?`,
-      `5. What is the recommended next action?`
-    ].filter((line) => line !== void 0).join("\n");
-    return {
-      description: `Diagnostic prompt for blocked/failed issue ${issueId}.`,
-      messages: [{
-        role: "user",
-        content: { type: "text", text: diagnosticText }
-      }]
-    };
-  }
-  if (name === "fifony-weekly-summary") {
-    const issues = await getIssues();
-    let analytics = {};
-    try {
-      analytics = await apiGet("/api/analytics/tokens");
-    } catch {
-    }
-    const overall = analytics.overall ?? {};
-    const byState = issues.reduce((accumulator, issue) => {
-      const key = issue.state ?? "Unknown";
-      accumulator[key] = (accumulator[key] ?? 0) + 1;
-      return accumulator;
-    }, {});
-    const totalIssues = issues.length;
-    const completed = byState["Done"] ?? 0;
-    const blocked = (byState["Blocked"] ?? 0) + (byState["Failed"] ?? 0);
-    const inProgress = (byState["Running"] ?? 0) + (byState["In Review"] ?? 0) + (byState["Queued"] ?? 0);
-    const todo = byState["Todo"] ?? 0;
-    const planning = byState["Planning"] ?? 0;
-    const cancelled = byState["Cancelled"] ?? 0;
-    const inputTokens = typeof overall.inputTokens === "number" ? overall.inputTokens : 0;
-    const outputTokens = typeof overall.outputTokens === "number" ? overall.outputTokens : 0;
-    const totalTokens = typeof overall.totalTokens === "number" ? overall.totalTokens : 0;
-    const estimatedCost = inputTokens / 1e6 * 3 + outputTokens / 1e6 * 15;
-    const summaryText = [
-      `# Fifony Weekly Progress Summary`,
-      ``,
-      `## Issue Statistics`,
-      `| Status | Count |`,
-      `|--------|-------|`,
-      `| Total Issues | ${totalIssues} |`,
-      `| Completed (Done) | ${completed} |`,
-      `| In Progress | ${inProgress} |`,
-      `| Todo | ${todo} |`,
-      `| Planning | ${planning} |`,
-      `| Blocked/Failed | ${blocked} |`,
-      `| Cancelled | ${cancelled} |`,
-      ``,
-      `## Token Usage`,
-      `- **Total Tokens**: ${totalTokens.toLocaleString()}`,
-      `- **Input Tokens**: ${inputTokens.toLocaleString()}`,
-      `- **Output Tokens**: ${outputTokens.toLocaleString()}`,
-      `- **Estimated Cost**: $${(Math.round(estimatedCost * 100) / 100).toFixed(2)}`,
-      ``,
-      `## Analysis Request`,
-      `Based on these metrics, please provide:`,
-      `1. A brief summary of overall progress this week`,
-      `2. Identification of any bottlenecks (blocked/failed issues)`,
-      `3. Token usage efficiency assessment`,
-      `4. Recommendations for improving throughput`,
-      `5. Priority items for next week`
-    ].join("\n");
-    return {
-      description: "Weekly progress summary prompt for the Fifony workspace.",
-      messages: [{
-        role: "user",
-        content: { type: "text", text: summaryText }
-      }]
-    };
-  }
-  if (name === "fifony-refine-plan") {
-    const issueId = typeof args.issueId === "string" ? args.issueId.trim() : "";
-    const concern = typeof args.concern === "string" ? args.concern.trim() : "";
-    if (!issueId) throw new Error("issueId is required");
-    const issue = await getIssue(issueId);
-    if (!issue) throw new Error(`Issue not found: ${issueId}`);
-    const issueData = issue;
-    const plan = issueData.plan ?? null;
-    const steps = plan?.steps ?? [];
-    const stepsText = steps.length > 0 ? steps.map((step, index) => `${index + 1}. **${step.title ?? step.description ?? "Step"}**
-   ${step.description ?? step.detail ?? ""}`).join("\n") : "No steps defined.";
-    const refinementText = [
-      `# Plan Refinement for Issue ${issueId}`,
-      ``,
-      `## Issue`,
-      `- **Title**: ${issueData.title ?? "Unknown"}`,
-      `- **Description**: ${issueData.description ?? "No description"}`,
-      ``,
-      `## Current Plan`,
-      plan ? `- **Summary**: ${plan.summary ?? plan.title ?? "No summary"}` : "No plan exists yet.",
-      plan?.estimatedComplexity ? `- **Complexity**: ${plan.estimatedComplexity}` : "",
-      ``,
-      `### Steps`,
-      stepsText,
-      ``,
-      concern ? `## Specific Concern
-${concern}
-` : "",
-      `## Refinement Guidance`,
-      `Please review the current plan and provide specific, actionable feedback:`,
-      `1. Are the steps correctly ordered and complete?`,
-      `2. Are there missing edge cases or error handling steps?`,
-      `3. Is the complexity estimate accurate?`,
-      `4. Are the file paths and affected areas correct?`,
-      `5. Should any steps be split, merged, or removed?`,
-      ``,
-      `Provide your feedback, and it will be used to refine the plan via \`fifony.refine\`.`
-    ].filter((line) => line !== void 0).join("\n");
-    return {
-      description: `Plan refinement prompt for issue ${issueId}.`,
-      messages: [{
-        role: "user",
-        content: { type: "text", text: refinementText }
-      }]
-    };
-  }
-  if (name === "fifony-code-review") {
-    const issueId = typeof args.issueId === "string" ? args.issueId.trim() : "";
-    if (!issueId) throw new Error("issueId is required");
-    const issue = await getIssue(issueId);
-    if (!issue) throw new Error(`Issue not found: ${issueId}`);
-    const issueData = issue;
-    let diffData = {};
-    try {
-      diffData = await apiGet(`/api/diff/${encodeURIComponent(issueId)}`);
-    } catch (error) {
-      throw new Error(`Cannot fetch diff for issue ${issueId}. Is the runtime running? ${String(error)}`);
-    }
-    const files = Array.isArray(diffData.files) ? diffData.files : [];
-    const diff = typeof diffData.diff === "string" ? diffData.diff : "";
-    const totalAdditions = typeof diffData.totalAdditions === "number" ? diffData.totalAdditions : 0;
-    const totalDeletions = typeof diffData.totalDeletions === "number" ? diffData.totalDeletions : 0;
-    if (!diff.trim()) {
-      return {
-        description: `Code review prompt for issue ${issueId} (no changes).`,
-        messages: [{
-          role: "user",
-          content: { type: "text", text: `# Code Review for ${issueId}
-
-No code changes found for this issue. The workspace may not have been created yet or no modifications were made.` }
-        }]
-      };
-    }
-    const filesTable = files.map((file) => `| ${file.path} | ${file.status} | +${file.additions} | -${file.deletions} |`).join("\n");
-    const reviewText = [
-      `# Code Review for Issue ${issueId}`,
-      ``,
-      `## Issue Context`,
-      `- **Title**: ${issueData.title ?? "Unknown"}`,
-      `- **Description**: ${issueData.description ?? "No description"}`,
-      `- **State**: ${issueData.state ?? "Unknown"}`,
-      ``,
-      `## Change Summary`,
-      `- **Files Changed**: ${files.length}`,
-      `- **Total Additions**: +${totalAdditions}`,
-      `- **Total Deletions**: -${totalDeletions}`,
-      ``,
-      `### Files`,
-      `| Path | Status | Additions | Deletions |`,
-      `|------|--------|-----------|-----------|`,
-      filesTable,
-      ``,
-      `## Diff`,
-      "```diff",
-      diff.length > 5e4 ? diff.substring(0, 5e4) + "\n... (diff truncated at 50KB)" : diff,
-      "```",
-      ``,
-      `## Review Checklist`,
-      `Please review the changes and evaluate:`,
-      `1. **Correctness**: Do the changes correctly implement what the issue describes?`,
-      `2. **Code Quality**: Is the code clean, readable, and follows project conventions?`,
-      `3. **Error Handling**: Are edge cases and errors properly handled?`,
-      `4. **Security**: Are there any security concerns (hardcoded secrets, SQL injection, XSS)?`,
-      `5. **Performance**: Are there any performance concerns or inefficiencies?`,
-      `6. **Tests**: Are changes adequately covered by tests?`,
-      `7. **Breaking Changes**: Do any changes break backward compatibility?`
-    ].join("\n");
-    return {
-      description: `Code review prompt for issue ${issueId}.`,
-      messages: [{
-        role: "user",
-        content: { type: "text", text: reviewText }
-      }]
-    };
-  }
-  throw new Error(`Unknown prompt: ${name}`);
-}
-function listTools() {
-  return [
-    { name: "fifony.status", description: "Return a compact status summary for the current Fifony workspace.", inputSchema: { type: "object", properties: {}, additionalProperties: false } },
-    { name: "fifony.list_issues", description: "List issues from the Fifony durable store.", inputSchema: { type: "object", properties: { state: { type: "string" }, capabilityCategory: { type: "string" }, category: { type: "string" } }, additionalProperties: false } },
-    { name: "fifony.create_issue", description: "Create a new issue directly in the Fifony durable store.", inputSchema: { type: "object", properties: { id: { type: "string" }, title: { type: "string" }, description: { type: "string" }, priority: { type: "number" }, state: { type: "string" }, labels: { type: "array", items: { type: "string" } }, paths: { type: "array", items: { type: "string" } } }, required: ["title"], additionalProperties: false } },
-    { name: "fifony.update_issue_state", description: "Update an issue state in the Fifony store and append an event.", inputSchema: { type: "object", properties: { issueId: { type: "string" }, state: { type: "string" }, note: { type: "string" } }, required: ["issueId", "state"], additionalProperties: false } },
-    { name: "fifony.plan", description: "Generate an AI plan for an issue. The issue must be in Planning state. Returns the plan summary and step count.", inputSchema: { type: "object", properties: { issueId: { type: "string", description: "The issue identifier to plan." }, fast: { type: "boolean", description: "Use fast planning mode (less thorough but quicker)." } }, required: ["issueId"], additionalProperties: false } },
-    { name: "fifony.refine", description: "Refine an existing plan with feedback. The issue must already have a plan.", inputSchema: { type: "object", properties: { issueId: { type: "string", description: "The issue identifier whose plan to refine." }, feedback: { type: "string", description: "Feedback to guide the plan refinement." } }, required: ["issueId", "feedback"], additionalProperties: false } },
-    { name: "fifony.approve", description: "Approve a plan and move the issue to Todo for execution.", inputSchema: { type: "object", properties: { issueId: { type: "string", description: "The issue identifier to approve." } }, required: ["issueId"], additionalProperties: false } },
-    { name: "fifony.merge", description: "Merge workspace changes back into the project root. Copies new/modified files from the issue workspace to TARGET_ROOT and removes files that were deleted. Skips fifony internal files, node_modules, .git, and dist.", inputSchema: { type: "object", properties: { issueId: { type: "string", description: "The issue identifier whose workspace to merge." } }, required: ["issueId"], additionalProperties: false } },
-    { name: "fifony.analytics", description: "Get token usage analytics including overall totals, cost estimates, and top issues by token consumption.", inputSchema: { type: "object", properties: {}, additionalProperties: false } },
-    { name: "fifony.integration_config", description: "Generate a ready-to-paste MCP client configuration snippet for this Fifony workspace.", inputSchema: { type: "object", properties: { client: { type: "string" } }, additionalProperties: false } },
-    { name: "fifony.list_integrations", description: "List discovered local integrations such as agency-agents profiles and impeccable skills.", inputSchema: { type: "object", properties: {}, additionalProperties: false } },
-    { name: "fifony.integration_snippet", description: "Generate a workflow or prompt snippet for a discovered integration.", inputSchema: { type: "object", properties: { integration: { type: "string" } }, required: ["integration"], additionalProperties: false } },
-    { name: "fifony.resolve_capabilities", description: "Resolve which providers, roles, profiles, and overlays Fifony should use for a task.", inputSchema: { type: "object", properties: { title: { type: "string" }, description: { type: "string" }, labels: { type: "array", items: { type: "string" } }, paths: { type: "array", items: { type: "string" } } }, required: ["title"], additionalProperties: false } },
-    { name: "fifony.get_issue", description: "Get full detail of a single issue including plan, history, events, and diff status.", inputSchema: { type: "object", properties: { issueId: { type: "string", description: "The issue identifier." } }, required: ["issueId"], additionalProperties: false } },
-    { name: "fifony.cancel_issue", description: "Cancel an issue, moving it to Cancelled state.", inputSchema: { type: "object", properties: { issueId: { type: "string", description: "The issue identifier to cancel." } }, required: ["issueId"], additionalProperties: false } },
-    { name: "fifony.retry_issue", description: "Retry a failed or blocked issue, resetting it to Todo state.", inputSchema: { type: "object", properties: { issueId: { type: "string", description: "The issue identifier to retry." } }, required: ["issueId"], additionalProperties: false } },
-    { name: "fifony.enhance", description: "AI-enhance an issue title or description. Provide either an issueId to enhance an existing issue, or title+description for standalone enhancement.", inputSchema: { type: "object", properties: { issueId: { type: "string", description: "Issue identifier (optional, for existing issues)." }, title: { type: "string", description: "Issue title (for standalone enhancement)." }, description: { type: "string", description: "Issue description (for standalone enhancement)." }, field: { type: "string", enum: ["title", "description"], description: "Which field to enhance." } }, required: ["field"], additionalProperties: false } },
-    { name: "fifony.get_diff", description: "Get git diff for an issue's workspace, including per-file summary and full diff text.", inputSchema: { type: "object", properties: { issueId: { type: "string", description: "The issue identifier." } }, required: ["issueId"], additionalProperties: false } },
-    { name: "fifony.get_live", description: "Get live agent output for a running issue, including log tail, PID, elapsed time, and status.", inputSchema: { type: "object", properties: { issueId: { type: "string", description: "The issue identifier." } }, required: ["issueId"], additionalProperties: false } },
-    { name: "fifony.get_events", description: "Get event feed, optionally filtered by issue, kind, or limited.", inputSchema: { type: "object", properties: { issueId: { type: "string", description: "Filter events by issue identifier." }, kind: { type: "string", description: "Filter events by kind (info, error, state, manual, progress)." }, limit: { type: "number", description: "Maximum number of events to return (default 50)." } }, additionalProperties: false } },
-    { name: "fifony.get_workflow", description: "Get the current pipeline workflow configuration including providers, models, and effort for plan/execute/review stages.", inputSchema: { type: "object", properties: {}, additionalProperties: false } },
-    { name: "fifony.set_workflow", description: "Update the pipeline workflow configuration. Each stage (plan, execute, review) needs provider, model, and effort.", inputSchema: { type: "object", properties: { plan: { type: "object", properties: { provider: { type: "string" }, model: { type: "string" }, effort: { type: "string" } }, required: ["provider", "model", "effort"] }, execute: { type: "object", properties: { provider: { type: "string" }, model: { type: "string" }, effort: { type: "string" } }, required: ["provider", "model", "effort"] }, review: { type: "object", properties: { provider: { type: "string" }, model: { type: "string" }, effort: { type: "string" } }, required: ["provider", "model", "effort"] } }, required: ["plan", "execute", "review"], additionalProperties: false } },
-    { name: "fifony.scan_project", description: "Scan the target project structure, returning files, directories, and detected technologies.", inputSchema: { type: "object", properties: {}, additionalProperties: false } },
-    { name: "fifony.install_agents", description: "Install agents from the Fifony catalog into the target workspace.", inputSchema: { type: "object", properties: { agents: { type: "array", items: { type: "string" }, description: "List of agent names to install." } }, required: ["agents"], additionalProperties: false } },
-    { name: "fifony.install_skills", description: "Install skills from the Fifony catalog into the target workspace.", inputSchema: { type: "object", properties: { skills: { type: "array", items: { type: "string" }, description: "List of skill names to install." } }, required: ["skills"], additionalProperties: false } }
-  ];
-}
-function toolText(text) {
-  return { content: [{ type: "text", text }] };
-}
-async function resolveApiBaseUrl() {
-  const envPort = env2.FIFONY_API_PORT;
-  if (envPort) return `http://localhost:${envPort}`;
-  const runtime = await getRuntimeSnapshot();
-  const config = runtime.config;
-  const port = config?.dashboardPort;
-  if (port) return `http://localhost:${port}`;
-  for (const candidate of [4e3, 3e3, 8080]) {
-    try {
-      const res = await fetch(`http://localhost:${candidate}/health`, { signal: AbortSignal.timeout(1e3) });
-      if (res.ok) return `http://localhost:${candidate}`;
-    } catch {
-    }
-  }
-  throw new Error("Fifony runtime API is not reachable. Start the runtime with --port to enable plan/refine/approve/analytics tools.");
-}
-async function apiPost(path, body = {}) {
-  const base = await resolveApiBaseUrl();
-  const res = await fetch(`${base}${path}`, {
-    method: "POST",
-    headers: { "content-type": "application/json" },
-    body: JSON.stringify(body),
-    signal: AbortSignal.timeout(12e4)
-  });
-  const json = await res.json();
-  if (!res.ok || json.ok === false) {
-    throw new Error(typeof json.error === "string" ? json.error : `API request failed: ${res.status}`);
-  }
-  return json;
-}
-async function apiGet(path) {
-  const base = await resolveApiBaseUrl();
-  const res = await fetch(`${base}${path}`, {
-    signal: AbortSignal.timeout(3e4)
-  });
-  const json = await res.json();
-  if (!res.ok || json.ok === false) {
-    throw new Error(typeof json.error === "string" ? json.error : `API request failed: ${res.status}`);
-  }
-  return json;
-}
-async function callTool(name, args = {}) {
-  if (name === "fifony.status") return toolText(await buildStateSummary());
-  if (name === "fifony.list_issues") {
-    const stateFilter = typeof args.state === "string" && args.state.trim() ? args.state.trim() : "";
-    const capabilityCategory = typeof args.capabilityCategory === "string" && args.capabilityCategory.trim() ? args.capabilityCategory.trim() : typeof args.category === "string" && args.category.trim() ? args.category.trim() : "";
-    return toolText(JSON.stringify(await listIssues({ state: stateFilter || void 0, capabilityCategory: capabilityCategory || void 0 }), null, 2));
+
+// src/mcp/tools/tool-executor.ts
+import { createHash } from "crypto";
+function hashInput(value) {
+  return createHash("sha1").update(value).digest("hex").slice(0, 10);
+}
+function toolText(text) {
+  return { content: [{ type: "text", text }] };
+}
+async function callTool(name, args = {}) {
+  if (name === "fifony.status") return toolText(await buildStateSummary());
+  if (name === "fifony.list_issues") {
+    const stateFilter = typeof args.state === "string" && args.state.trim() ? args.state.trim() : "";
+    const capabilityCategory = typeof args.capabilityCategory === "string" && args.capabilityCategory.trim() ? args.capabilityCategory.trim() : typeof args.category === "string" && args.category.trim() ? args.category.trim() : "";
+    return toolText(JSON.stringify(await listIssues({ state: stateFilter || void 0, capabilityCategory: capabilityCategory || void 0 }), null, 2));
   }
   if (name === "fifony.create_issue") {
     await initDatabase();
@@ -959,7 +636,7 @@ async function callTool(name, args = {}) {
     const issueId = explicitId || `LOCAL-${hashInput(`${title}:${nowIso()}`)}`.toUpperCase();
     const description = typeof args.description === "string" ? args.description : "";
     const priority = typeof args.priority === "number" ? args.priority : 2;
-    const state = typeof args.state === "string" && args.state.trim() ? args.state.trim() : "Todo";
+    const state = parseIssueState(args.state) ?? "Planning";
     const baseLabels = Array.isArray(args.labels) ? args.labels.filter((value) => typeof value === "string") : ["fifony", "mcp"];
     const paths = Array.isArray(args.paths) ? args.paths.filter((value) => typeof value === "string") : [];
     const inferredPaths = inferCapabilityPaths({ id: issueId, identifier: issueId, title, description, labels: baseLabels, paths });
@@ -994,9 +671,9 @@ async function callTool(name, args = {}) {
     await initDatabase();
     const { issueResource: issueResource2 } = getResources();
     const issueId = typeof args.issueId === "string" ? args.issueId.trim() : "";
-    const state = typeof args.state === "string" ? args.state.trim() : "";
+    const state = parseIssueState(args.state);
     const note = typeof args.note === "string" ? args.note : "";
-    if (!issueId || !state) throw new Error("issueId and state are required");
+    if (!issueId || !state) throw new Error("issueId and a valid canonical state are required");
     const current = await issueResource2?.get(issueId);
     if (!current) throw new Error(`Issue not found: ${issueId}`);
     const updated = await issueResource2?.update(issueId, { state, updatedAt: nowIso() });
@@ -1044,8 +721,8 @@ async function callTool(name, args = {}) {
     const issue = result.issue;
     return toolText(JSON.stringify({
       issueId,
-      state: issue?.state ?? "Todo",
-      message: `Plan approved for ${issueId}. Issue moved to Todo and is ready for execution.`
+      state: issue?.state ?? "Planned",
+      message: `Plan approved for ${issueId}. Issue moved to Planned and is ready for execution.`
     }, null, 2));
   }
   if (name === "fifony.merge") {
@@ -1073,12 +750,7 @@ async function callTool(name, args = {}) {
       overall: { inputTokens, outputTokens, totalTokens },
       estimatedCostUsd: Math.round(estimatedCost * 100) / 100,
       modelBreakdown: byModel ?? {},
-      topIssues: (topIssues ?? []).slice(0, 10).map((issue) => ({
-        id: issue.id,
-        totalTokens: issue.totalTokens,
-        inputTokens: issue.inputTokens,
-        outputTokens: issue.outputTokens
-      }))
+      topIssues: (topIssues ?? []).slice(0, 10).map((issue) => ({ id: issue.id, totalTokens: issue.totalTokens, inputTokens: issue.inputTokens, outputTokens: issue.outputTokens }))
     }, null, 2));
   }
   if (name === "fifony.integration_config") {
@@ -1139,7 +811,7 @@ async function callTool(name, args = {}) {
     try {
       const result = await apiPost(`/api/issues/${encodeURIComponent(issueId)}/retry`);
       const issue = result.issue;
-      return toolText(JSON.stringify({ issueId, state: issue?.state ?? "Todo", message: `Issue ${issueId} has been retried and reset to Todo.` }, null, 2));
+      return toolText(JSON.stringify({ issueId, state: issue?.state ?? "Planned", message: `Issue ${issueId} has been retried and reset to Planned.` }, null, 2));
     } catch (error) {
       throw new Error(`Failed to retry issue ${issueId}: ${String(error)}`);
     }
@@ -1163,97 +835,411 @@ async function callTool(name, args = {}) {
       throw new Error(`Failed to enhance ${field}: ${String(error)}`);
     }
   }
-  if (name === "fifony.get_diff") {
-    const issueId = typeof args.issueId === "string" ? args.issueId.trim() : "";
-    if (!issueId) throw new Error("issueId is required");
+  if (name === "fifony.get_diff") {
+    const issueId = typeof args.issueId === "string" ? args.issueId.trim() : "";
+    if (!issueId) throw new Error("issueId is required");
+    try {
+      const result = await apiGet(`/api/diff/${encodeURIComponent(issueId)}`);
+      return toolText(JSON.stringify(result, null, 2));
+    } catch (error) {
+      throw new Error(`Failed to get diff for ${issueId}: ${String(error)}`);
+    }
+  }
+  if (name === "fifony.get_live") {
+    const issueId = typeof args.issueId === "string" ? args.issueId.trim() : "";
+    if (!issueId) throw new Error("issueId is required");
+    try {
+      const result = await apiGet(`/api/live/${encodeURIComponent(issueId)}`);
+      return toolText(JSON.stringify(result, null, 2));
+    } catch (error) {
+      throw new Error(`Failed to get live output for ${issueId}: ${String(error)}`);
+    }
+  }
+  if (name === "fifony.get_events") {
+    const issueId = typeof args.issueId === "string" ? args.issueId.trim() : "";
+    const kind = typeof args.kind === "string" ? args.kind.trim() : "";
+    const limit = typeof args.limit === "number" ? args.limit : 50;
+    const params = new URLSearchParams();
+    if (issueId) params.set("issueId", issueId);
+    if (kind) params.set("kind", kind);
+    const query = params.toString();
+    try {
+      const result = await apiGet(`/api/events/feed${query ? `?${query}` : ""}`);
+      const events = Array.isArray(result.events) ? result.events.slice(0, limit) : [];
+      return toolText(JSON.stringify({ events, count: events.length }, null, 2));
+    } catch (error) {
+      const events = await listEvents({ limit });
+      const filtered = events.filter((event) => {
+        if (issueId && event.issueId !== issueId) return false;
+        if (kind && event.kind !== kind) return false;
+        return true;
+      }).slice(0, limit);
+      return toolText(JSON.stringify({ events: filtered, count: filtered.length }, null, 2));
+    }
+  }
+  if (name === "fifony.get_workflow") {
+    try {
+      const result = await apiGet("/api/config/workflow");
+      return toolText(JSON.stringify(result, null, 2));
+    } catch (error) {
+      throw new Error(`Failed to get workflow config: ${String(error)}`);
+    }
+  }
+  if (name === "fifony.set_workflow") {
+    const plan = args.plan;
+    const execute = args.execute;
+    const review = args.review;
+    if (!plan || !execute || !review) throw new Error("plan, execute, and review are all required");
+    try {
+      const result = await apiPost("/api/config/workflow", { workflow: { plan, execute, review } });
+      return toolText(JSON.stringify({ message: "Workflow configuration updated successfully.", workflow: result.workflow }, null, 2));
+    } catch (error) {
+      throw new Error(`Failed to set workflow config: ${String(error)}`);
+    }
+  }
+  if (name === "fifony.scan_project") {
+    try {
+      const result = await apiGet("/api/scan/project");
+      return toolText(JSON.stringify(result, null, 2));
+    } catch (error) {
+      throw new Error(`Failed to scan project: ${String(error)}`);
+    }
+  }
+  if (name === "fifony.install_agents") {
+    const agents = Array.isArray(args.agents) ? args.agents.filter((value) => typeof value === "string") : [];
+    if (agents.length === 0) throw new Error("At least one agent name is required");
+    try {
+      const result = await apiPost("/api/install/agents", { agents });
+      return toolText(JSON.stringify(result, null, 2));
+    } catch (error) {
+      throw new Error(`Failed to install agents: ${String(error)}`);
+    }
+  }
+  if (name === "fifony.install_skills") {
+    const skills = Array.isArray(args.skills) ? args.skills.filter((value) => typeof value === "string") : [];
+    if (skills.length === 0) throw new Error("At least one skill name is required");
+    try {
+      const result = await apiPost("/api/install/skills", { skills });
+      return toolText(JSON.stringify(result, null, 2));
+    } catch (error) {
+      throw new Error(`Failed to install skills: ${String(error)}`);
+    }
+  }
+  throw new Error(`Unknown tool: ${name}`);
+}
+
+// src/mcp/prompts/prompt-list.ts
+function listPrompts() {
+  return [
+    { name: "fifony-integrate-client", description: "Generate setup instructions for connecting an MCP-capable client to Fifony.", arguments: [{ name: "client", description: "Client name, e.g. codex or claude.", required: true }, { name: "goal", description: "What the client should do with Fifony.", required: false }] },
+    { name: "fifony-plan-issue", description: "Generate a planning prompt for a specific issue in the Fifony store.", arguments: [{ name: "issueId", description: "Issue identifier.", required: true }, { name: "provider", description: "Agent provider name.", required: false }] },
+    { name: "fifony-use-integration", description: "Generate a concrete integration prompt for agency-agents or impeccable.", arguments: [{ name: "integration", description: "Integration id: agency-agents or impeccable.", required: true }] },
+    { name: "fifony-route-task", description: "Explain which providers, profiles, and overlays Fifony would choose for a task.", arguments: [{ name: "title", description: "Task title.", required: true }, { name: "description", description: "Task description.", required: false }, { name: "labels", description: "Comma-separated labels.", required: false }, { name: "paths", description: "Comma-separated target paths or files.", required: false }] },
+    { name: "fifony-diagnose-blocked", description: "Help diagnose why an issue is blocked or failing, analyzing the issue plan, last error, history, and events.", arguments: [{ name: "issueId", description: "Issue identifier to diagnose.", required: true }] },
+    { name: "fifony-weekly-summary", description: "Generate a weekly progress summary including issues created, completed, blocked, and token usage.", arguments: [] },
+    { name: "fifony-refine-plan", description: "Guided plan refinement prompt that shows the current plan and helps provide specific feedback.", arguments: [{ name: "issueId", description: "Issue identifier whose plan to refine.", required: true }, { name: "concern", description: "Optional specific concern to address in refinement.", required: false }] },
+    { name: "fifony-code-review", description: "Review code changes for an issue by analyzing its git diff.", arguments: [{ name: "issueId", description: "Issue identifier to review.", required: true }] }
+  ];
+}
+
+// src/mcp/prompts/prompt-handler.ts
+async function getPrompt(name, args = {}) {
+  if (name === "fifony-integrate-client") {
+    const client = typeof args.client === "string" && args.client.trim() ? args.client.trim() : "mcp-client";
+    const goal = typeof args.goal === "string" && args.goal.trim() ? args.goal.trim() : "integrate with the local Fifony workspace";
+    const integrationGuide = await buildIntegrationGuide();
+    return {
+      description: "Client integration prompt for Fifony.",
+      messages: [{
+        role: "user",
+        content: {
+          type: "text",
+          text: await renderPrompt("mcp-integrate-client", { client, goal, integrationGuide })
+        }
+      }]
+    };
+  }
+  if (name === "fifony-plan-issue") {
+    const issueId = typeof args.issueId === "string" ? args.issueId : "";
+    const provider = typeof args.provider === "string" && args.provider.trim() ? args.provider.trim() : "codex";
+    const issue = issueId ? await getIssue(issueId) : null;
+    if (!issue) throw new Error(`Issue not found: ${issueId}`);
+    return {
+      description: "Issue planning prompt grounded in the Fifony issue store.",
+      messages: [{
+        role: "user",
+        content: { type: "text", text: await buildIssuePrompt(issue, provider, "planner") }
+      }]
+    };
+  }
+  if (name === "fifony-use-integration") {
+    const integration = typeof args.integration === "string" ? args.integration : "";
+    return {
+      description: "Integration guidance for a discovered Fifony extension.",
+      messages: [{
+        role: "user",
+        content: { type: "text", text: await buildIntegrationSnippet(integration, WORKSPACE_ROOT) }
+      }]
+    };
+  }
+  if (name === "fifony-route-task") {
+    const title = typeof args.title === "string" ? args.title : "";
+    const description = typeof args.description === "string" ? args.description : "";
+    const labels = typeof args.labels === "string" ? args.labels.split(",").map((label) => label.trim()).filter(Boolean) : [];
+    const paths = typeof args.paths === "string" ? args.paths.split(",").map((value) => value.trim()).filter(Boolean) : [];
+    const resolution = resolveTaskCapabilities({ title, description, labels, paths });
+    return {
+      description: "Task routing prompt produced by the Fifony capability resolver.",
+      messages: [{
+        role: "user",
+        content: {
+          type: "text",
+          text: await renderPrompt("mcp-route-task", {
+            resolutionJson: JSON.stringify(resolution, null, 2)
+          })
+        }
+      }]
+    };
+  }
+  if (name === "fifony-diagnose-blocked") {
+    const issueId = typeof args.issueId === "string" ? args.issueId.trim() : "";
+    if (!issueId) throw new Error("issueId is required");
+    const issue = await getIssue(issueId);
+    if (!issue) throw new Error(`Issue not found: ${issueId}`);
+    const issueData = issue;
+    let events = [];
+    try {
+      const evResult = await apiGet(`/api/events/feed?issueId=${encodeURIComponent(issueId)}`);
+      events = Array.isArray(evResult.events) ? evResult.events.slice(0, 30) : [];
+    } catch {
+      const localEvents = await listEvents({ limit: 100 });
+      events = localEvents.filter((event) => event.issueId === issueId).slice(0, 30);
+    }
+    const plan = issueData.plan ?? null;
+    const history = Array.isArray(issueData.history) ? issueData.history : [];
+    const lastError = issueData.lastError ?? null;
+    const state = issueData.state ?? "Unknown";
+    const attempts = issueData.attempts ?? 0;
+    const maxAttempts = issueData.maxAttempts ?? 3;
+    const diagnosticText = [
+      `# Diagnostic Report for Issue ${issueId}`,
+      ``,
+      `## Issue Details`,
+      `- **Title**: ${issueData.title ?? "Unknown"}`,
+      `- **State**: ${state}`,
+      `- **Attempts**: ${attempts} / ${maxAttempts}`,
+      `- **Last Error**: ${lastError ?? "None"}`,
+      `- **Updated At**: ${issueData.updatedAt ?? "Unknown"}`,
+      ``,
+      `## Plan`,
+      plan ? `- **Summary**: ${plan.summary ?? plan.title ?? "No summary"}` : "No plan generated.",
+      plan?.steps ? `- **Steps**: ${plan.steps.length} step(s)` : "",
+      plan?.estimatedComplexity ? `- **Estimated Complexity**: ${plan.estimatedComplexity}` : "",
+      ``,
+      `## History`,
+      ...history.length > 0 ? history.slice(-15).map((entry) => `- ${entry}`) : ["No history entries."],
+      ``,
+      `## Recent Events`,
+      ...events.length > 0 ? events.slice(0, 15).map((event) => `- [${event.kind ?? "info"}] ${event.at ?? ""}: ${event.message ?? ""}`) : ["No events found."],
+      ``,
+      `## Diagnostic Questions`,
+      `Based on the information above, please analyze:`,
+      `1. What is the root cause of the issue being in "${state}" state?`,
+      `2. Is the error recoverable? If so, what steps should be taken?`,
+      `3. Does the plan need modification before retrying?`,
+      `4. Are there any dependency or configuration issues that need resolution?`,
+      `5. What is the recommended next action?`
+    ].filter((line) => line !== void 0).join("\n");
+    return {
+      description: `Diagnostic prompt for blocked/failed issue ${issueId}.`,
+      messages: [{
+        role: "user",
+        content: { type: "text", text: diagnosticText }
+      }]
+    };
+  }
+  if (name === "fifony-weekly-summary") {
+    const issues = await getIssues();
+    let analytics = {};
     try {
-      const result = await apiGet(`/api/diff/${encodeURIComponent(issueId)}`);
-      return toolText(JSON.stringify(result, null, 2));
-    } catch (error) {
-      throw new Error(`Failed to get diff for ${issueId}: ${String(error)}`);
+      analytics = await apiGet("/api/analytics/tokens");
+    } catch {
     }
+    const overall = analytics.overall ?? {};
+    const byState = issues.reduce((accumulator, issue) => {
+      const key = issue.state ?? "Unknown";
+      accumulator[key] = (accumulator[key] ?? 0) + 1;
+      return accumulator;
+    }, {});
+    const totalIssues = issues.length;
+    const completed = byState["Done"] ?? 0;
+    const blocked = (byState["Blocked"] ?? 0) + (byState["Failed"] ?? 0);
+    const inProgress = (byState["Running"] ?? 0) + (byState["Reviewing"] ?? 0) + (byState["Reviewed"] ?? 0) + (byState["Queued"] ?? 0);
+    const planned = byState["Planned"] ?? 0;
+    const planning = byState["Planning"] ?? 0;
+    const cancelled = byState["Cancelled"] ?? 0;
+    const inputTokens = typeof overall.inputTokens === "number" ? overall.inputTokens : 0;
+    const outputTokens = typeof overall.outputTokens === "number" ? overall.outputTokens : 0;
+    const totalTokens = typeof overall.totalTokens === "number" ? overall.totalTokens : 0;
+    const estimatedCost = inputTokens / 1e6 * 3 + outputTokens / 1e6 * 15;
+    const summaryText = [
+      `# Fifony Weekly Progress Summary`,
+      ``,
+      `## Issue Statistics`,
+      `| Status | Count |`,
+      `|--------|-------|`,
+      `| Total Issues | ${totalIssues} |`,
+      `| Completed (Done) | ${completed} |`,
+      `| In Progress | ${inProgress} |`,
+      `| Planned | ${planned} |`,
+      `| Planning | ${planning} |`,
+      `| Blocked/Failed | ${blocked} |`,
+      `| Cancelled | ${cancelled} |`,
+      ``,
+      `## Token Usage`,
+      `- **Total Tokens**: ${totalTokens.toLocaleString()}`,
+      `- **Input Tokens**: ${inputTokens.toLocaleString()}`,
+      `- **Output Tokens**: ${outputTokens.toLocaleString()}`,
+      `- **Estimated Cost**: $${(Math.round(estimatedCost * 100) / 100).toFixed(2)}`,
+      ``,
+      `## Analysis Request`,
+      `Based on these metrics, please provide:`,
+      `1. A brief summary of overall progress this week`,
+      `2. Identification of any bottlenecks (blocked/failed issues)`,
+      `3. Token usage efficiency assessment`,
+      `4. Recommendations for improving throughput`,
+      `5. Priority items for next week`
+    ].join("\n");
+    return {
+      description: "Weekly progress summary prompt for the Fifony workspace.",
+      messages: [{
+        role: "user",
+        content: { type: "text", text: summaryText }
+      }]
+    };
   }
-  if (name === "fifony.get_live") {
+  if (name === "fifony-refine-plan") {
     const issueId = typeof args.issueId === "string" ? args.issueId.trim() : "";
+    const concern = typeof args.concern === "string" ? args.concern.trim() : "";
     if (!issueId) throw new Error("issueId is required");
-    try {
-      const result = await apiGet(`/api/live/${encodeURIComponent(issueId)}`);
-      return toolText(JSON.stringify(result, null, 2));
-    } catch (error) {
-      throw new Error(`Failed to get live output for ${issueId}: ${String(error)}`);
-    }
+    const issue = await getIssue(issueId);
+    if (!issue) throw new Error(`Issue not found: ${issueId}`);
+    const issueData = issue;
+    const plan = issueData.plan ?? null;
+    const steps = plan?.steps ?? [];
+    const stepsText = steps.length > 0 ? steps.map((step, index) => `${index + 1}. **${step.title ?? step.description ?? "Step"}**
+   ${step.description ?? step.detail ?? ""}`).join("\n") : "No steps defined.";
+    const refinementText = [
+      `# Plan Refinement for Issue ${issueId}`,
+      ``,
+      `## Issue`,
+      `- **Title**: ${issueData.title ?? "Unknown"}`,
+      `- **Description**: ${issueData.description ?? "No description"}`,
+      ``,
+      `## Current Plan`,
+      plan ? `- **Summary**: ${plan.summary ?? plan.title ?? "No summary"}` : "No plan exists yet.",
+      plan?.estimatedComplexity ? `- **Complexity**: ${plan.estimatedComplexity}` : "",
+      ``,
+      `### Steps`,
+      stepsText,
+      ``,
+      concern ? `## Specific Concern
+${concern}
+` : "",
+      `## Refinement Guidance`,
+      `Please review the current plan and provide specific, actionable feedback:`,
+      `1. Are the steps correctly ordered and complete?`,
+      `2. Are there missing edge cases or error handling steps?`,
+      `3. Is the complexity estimate accurate?`,
+      `4. Are the file paths and affected areas correct?`,
+      `5. Should any steps be split, merged, or removed?`,
+      ``,
+      `Provide your feedback, and it will be used to refine the plan via \`fifony.refine\`.`
+    ].filter((line) => line !== void 0).join("\n");
+    return {
+      description: `Plan refinement prompt for issue ${issueId}.`,
+      messages: [{
+        role: "user",
+        content: { type: "text", text: refinementText }
+      }]
+    };
   }
-  if (name === "fifony.get_events") {
+  if (name === "fifony-code-review") {
     const issueId = typeof args.issueId === "string" ? args.issueId.trim() : "";
-    const kind = typeof args.kind === "string" ? args.kind.trim() : "";
-    const limit = typeof args.limit === "number" ? args.limit : 50;
-    const params = new URLSearchParams();
-    if (issueId) params.set("issueId", issueId);
-    if (kind) params.set("kind", kind);
-    const query = params.toString();
-    try {
-      const result = await apiGet(`/api/events/feed${query ? `?${query}` : ""}`);
-      const events = Array.isArray(result.events) ? result.events.slice(0, limit) : [];
-      return toolText(JSON.stringify({ events, count: events.length }, null, 2));
-    } catch (error) {
-      const events = await listEvents({ limit });
-      const filtered = events.filter((event) => {
-        if (issueId && event.issueId !== issueId) return false;
-        if (kind && event.kind !== kind) return false;
-        return true;
-      }).slice(0, limit);
-      return toolText(JSON.stringify({ events: filtered, count: filtered.length }, null, 2));
-    }
-  }
-  if (name === "fifony.get_workflow") {
-    try {
-      const result = await apiGet("/api/config/workflow");
-      return toolText(JSON.stringify(result, null, 2));
-    } catch (error) {
-      throw new Error(`Failed to get workflow config: ${String(error)}`);
-    }
-  }
-  if (name === "fifony.set_workflow") {
-    const plan = args.plan;
-    const execute = args.execute;
-    const review = args.review;
-    if (!plan || !execute || !review) throw new Error("plan, execute, and review are all required");
-    try {
-      const result = await apiPost("/api/config/workflow", { workflow: { plan, execute, review } });
-      return toolText(JSON.stringify({ message: "Workflow configuration updated successfully.", workflow: result.workflow }, null, 2));
-    } catch (error) {
-      throw new Error(`Failed to set workflow config: ${String(error)}`);
-    }
-  }
-  if (name === "fifony.scan_project") {
-    try {
-      const result = await apiGet("/api/scan/project");
-      return toolText(JSON.stringify(result, null, 2));
-    } catch (error) {
-      throw new Error(`Failed to scan project: ${String(error)}`);
-    }
-  }
-  if (name === "fifony.install_agents") {
-    const agents = Array.isArray(args.agents) ? args.agents.filter((value) => typeof value === "string") : [];
-    if (agents.length === 0) throw new Error("At least one agent name is required");
+    if (!issueId) throw new Error("issueId is required");
+    const issue = await getIssue(issueId);
+    if (!issue) throw new Error(`Issue not found: ${issueId}`);
+    const issueData = issue;
+    let diffData = {};
     try {
-      const result = await apiPost("/api/install/agents", { agents });
-      return toolText(JSON.stringify(result, null, 2));
+      diffData = await apiGet(`/api/diff/${encodeURIComponent(issueId)}`);
     } catch (error) {
-      throw new Error(`Failed to install agents: ${String(error)}`);
+      throw new Error(`Cannot fetch diff for issue ${issueId}. Is the runtime running? ${String(error)}`);
     }
-  }
-  if (name === "fifony.install_skills") {
-    const skills = Array.isArray(args.skills) ? args.skills.filter((value) => typeof value === "string") : [];
-    if (skills.length === 0) throw new Error("At least one skill name is required");
-    try {
-      const result = await apiPost("/api/install/skills", { skills });
-      return toolText(JSON.stringify(result, null, 2));
-    } catch (error) {
-      throw new Error(`Failed to install skills: ${String(error)}`);
+    const files = Array.isArray(diffData.files) ? diffData.files : [];
+    const diff = typeof diffData.diff === "string" ? diffData.diff : "";
+    const totalAdditions = typeof diffData.totalAdditions === "number" ? diffData.totalAdditions : 0;
+    const totalDeletions = typeof diffData.totalDeletions === "number" ? diffData.totalDeletions : 0;
+    if (!diff.trim()) {
+      return {
+        description: `Code review prompt for issue ${issueId} (no changes).`,
+        messages: [{
+          role: "user",
+          content: { type: "text", text: `# Code Review for ${issueId}
+
+No code changes found for this issue. The workspace may not have been created yet or no modifications were made.` }
+        }]
+      };
     }
+    const filesTable = files.map((file) => `| ${file.path} | ${file.status} | +${file.additions} | -${file.deletions} |`).join("\n");
+    const reviewText = [
+      `# Code Review for Issue ${issueId}`,
+      ``,
+      `## Issue Context`,
+      `- **Title**: ${issueData.title ?? "Unknown"}`,
+      `- **Description**: ${issueData.description ?? "No description"}`,
+      `- **State**: ${issueData.state ?? "Unknown"}`,
+      ``,
+      `## Change Summary`,
+      `- **Files Changed**: ${files.length}`,
+      `- **Total Additions**: +${totalAdditions}`,
+      `- **Total Deletions**: -${totalDeletions}`,
+      ``,
+      `### Files`,
+      `| Path | Status | Additions | Deletions |`,
+      `|------|--------|-----------|-----------|`,
+      filesTable,
+      ``,
+      `## Diff`,
+      "```diff",
+      diff.length > 5e4 ? diff.substring(0, 5e4) + "\n... (diff truncated at 50KB)" : diff,
+      "```",
+      ``,
+      `## Review Checklist`,
+      `Please review the changes and evaluate:`,
+      `1. **Correctness**: Do the changes correctly implement what the issue describes?`,
+      `2. **Code Quality**: Is the code clean, readable, and follows project conventions?`,
+      `3. **Error Handling**: Are edge cases and errors properly handled?`,
+      `4. **Security**: Are there any security concerns (hardcoded secrets, SQL injection, XSS)?`,
+      `5. **Performance**: Are there any performance concerns or inefficiencies?`,
+      `6. **Tests**: Are changes adequately covered by tests?`,
+      `7. **Breaking Changes**: Do any changes break backward compatibility?`
+    ].join("\n");
+    return {
+      description: `Code review prompt for issue ${issueId}.`,
+      messages: [{
+        role: "user",
+        content: { type: "text", text: reviewText }
+      }]
+    };
   }
-  throw new Error(`Unknown tool: ${name}`);
+  throw new Error(`Unknown prompt: ${name}`);
+}
+
+// src/mcp/jsonrpc-transport.ts
+var incomingBuffer = Buffer.alloc(0);
+function setIncomingBuffer(buffer) {
+  incomingBuffer = buffer;
 }
 function sendMessage(message) {
   const payload = Buffer.from(JSON.stringify(message), "utf8");
@@ -1331,13 +1317,21 @@ function processIncomingBuffer() {
     void handleRequest(request);
   }
 }
+
+// src/mcp/server.ts
+var DEBUG_BOOT2 = env3.FIFONY_DEBUG_BOOT === "1";
+function debugBoot2(message) {
+  if (!DEBUG_BOOT2) return;
+  process.stderr.write(`[FIFONY_DEBUG_BOOT] ${message}
+`);
+}
 async function bootstrap() {
   debugBoot2("mcp:bootstrap:start");
   await initDatabase();
   debugBoot2("mcp:bootstrap:database-ready");
   await appendEvent("info", "Fifony MCP server started.", { workspaceRoot: WORKSPACE_ROOT, persistenceRoot: PERSISTENCE_ROOT });
   stdin.on("data", (chunk) => {
-    incomingBuffer = Buffer.concat([incomingBuffer, chunk]);
+    setIncomingBuffer(Buffer.concat([incomingBuffer, chunk]));
     processIncomingBuffer();
   });
   stdin.resume();