@specforge/canary-cli 0.1.0

package/dist/cli/commands/debug/whoami.js

@@ -0,0 +1,131 @@
+import chalk from "chalk";
+import ora from "ora";
+import { resolveConfig, getConfigPaths } from "../../config/index.js";
+import { createCliClient } from "../../../client/cli-client.js";
+import { CHANNEL } from "../../../channel.js";
+function maskApiKey(apiKey) {
+  if (apiKey.length < 12) {
+    return "****";
+  }
+  return `${apiKey.slice(0, 8)}...${apiKey.slice(-4)}`;
+}
+function getConfigSource(config) {
+  if (process.env.SPECFORGE_API_KEY) {
+    return "environment";
+  }
+  if (config.projectId) {
+    return ".specforge.json (project)";
+  }
+  if (config.apiKey) {
+    return "~/.specforge/config.json (global)";
+  }
+  return "defaults";
+}
+function displayUserInfo(info) {
+  console.log(chalk.bold("\nUser"));
+  console.log("\u2500\u2500\u2500\u2500");
+  if (info.user.name) {
+    console.log(`Name:     ${info.user.name}`);
+  }
+  console.log(`Email:    ${info.user.email}`);
+  console.log(`API Key:  ${info.user.apiKey}`);
+}
+function displayConfiguration(info) {
+  console.log(chalk.bold("\nConfiguration"));
+  console.log("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
+  console.log(`Source:   ${info.configuration.source}`);
+  if (info.configuration.projectName) {
+    console.log(`Project:  ${info.configuration.projectName} (${info.configuration.projectId})`);
+  } else if (info.configuration.projectId) {
+    console.log(`Project:  ${info.configuration.projectId}`);
+  } else {
+    console.log(`Project:  ${chalk.dim("(not set)")}`);
+  }
+  if (info.configuration.specificationTitle) {
+    console.log(`Spec:     ${info.configuration.specificationTitle} (${info.configuration.specificationId})`);
+  } else if (info.configuration.specificationId) {
+    console.log(`Spec:     ${info.configuration.specificationId}`);
+  } else {
+    console.log(`Spec:     ${chalk.dim("(not set)")}`);
+  }
+  console.log(`MCP format: ${info.configuration.mcpOutputFormat}`);
+}
+function displayPaths(info) {
+  console.log(chalk.bold("\nPaths"));
+  console.log("\u2500\u2500\u2500\u2500\u2500");
+  console.log(`Project config: ${info.paths.projectConfig}`);
+  console.log(`MCP config:     ${info.paths.mcpConfig}`);
+  console.log(`Global config:  ${info.paths.globalConfig}`);
+  console.log();
+}
+async function whoamiCommand(options) {
+  const config = resolveConfig();
+  const paths = getConfigPaths();
+  const spinner = ora("Fetching user info...").start();
+  try {
+    const client = createCliClient({
+      apiKey: config.apiKey,
+      apiUrl: process.env.SPECFORGE_API_URL || CHANNEL.endpoint.primary,
+      debug: config.debug
+    });
+    const userResponse = await client.call("get_current_user", {});
+    const userEmail = userResponse.email || "Unknown";
+    const userName = userResponse.name;
+    let projectName;
+    if (config.projectId) {
+      try {
+        const proj = await client.call("get_project", { projectId: config.projectId });
+        projectName = proj.name;
+      } catch {
+      }
+    }
+    let specTitle;
+    if (config.specificationId) {
+      try {
+        const spec = await client.call("get_specification", {
+          specificationId: config.specificationId
+        });
+        specTitle = spec.title;
+      } catch {
+      }
+    }
+    spinner.stop();
+    const info = {
+      user: {
+        name: userName,
+        email: userEmail,
+        apiKey: maskApiKey(config.apiKey)
+      },
+      configuration: {
+        source: getConfigSource(config),
+        projectId: config.projectId || void 0,
+        projectName,
+        specificationId: config.specificationId || void 0,
+        specificationTitle: specTitle,
+        mcpOutputFormat: config.mcpOutputFormat || "json"
+      },
+      paths: {
+        projectConfig: paths.projectConfig,
+        mcpConfig: paths.mcpConfig,
+        globalConfig: paths.globalConfig
+      }
+    };
+    if (options.json) {
+      console.log(JSON.stringify(info, null, 2));
+      return;
+    }
+    displayUserInfo(info);
+    displayConfiguration(info);
+    displayPaths(info);
+  } catch (error) {
+    spinner.fail("Failed to fetch user info");
+    const message = error instanceof Error ? error.message : "Unknown error";
+    console.error(chalk.red(`
+Error: ${message}`));
+    process.exit(1);
+  }
+}
+export {
+  whoamiCommand
+};
+//# sourceMappingURL=whoami.js.map

package/dist/cli/commands/debug/whoami.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/cli/commands/debug/whoami.ts"],"sourcesContent":["/**\n * Whoami Command Implementation\n *\n * Displays current user information, configuration settings, and config file paths.\n */\n\nimport chalk from 'chalk';\nimport ora from 'ora';\nimport { resolveConfig, getConfigPaths } from '../../config/index.js';\nimport { createCliClient } from '../../../client/cli-client.js';\nimport { CHANNEL } from '../../../channel.js';\nimport type { WhoamiOptions, WhoamiInfo } from './types.js';\n\n/**\n * Mask API key for display\n */\nfunction maskApiKey(apiKey: string): string {\n  if (apiKey.length < 12) {\n    return '****';\n  }\n  return `${apiKey.slice(0, 8)}...${apiKey.slice(-4)}`;\n}\n\n/**\n * Determine configuration source\n */\nfunction getConfigSource(config: { apiKey?: string | null; projectId?: string | null }): string {\n  if (process.env.SPECFORGE_API_KEY) {\n    return 'environment';\n  }\n  if (config.projectId) {\n    return '.specforge.json (project)';\n  }\n  if (config.apiKey) {\n    return '~/.specforge/config.json (global)';\n  }\n  return 'defaults';\n}\n\n/**\n * Display user information\n */\nfunction displayUserInfo(info: WhoamiInfo): void {\n  console.log(chalk.bold('\\nUser'));\n  console.log('────');\n  if (info.user.name) {\n    console.log(`Name:     ${info.user.name}`);\n  }\n  console.log(`Email:    ${info.user.email}`);\n  console.log(`API Key:  ${info.user.apiKey}`);\n}\n\n/**\n * Display configuration information\n */\nfunction displayConfiguration(info: WhoamiInfo): void {\n  console.log(chalk.bold('\\nConfiguration'));\n  console.log('─────────────');\n  console.log(`Source:   ${info.configuration.source}`);\n\n  if (info.configuration.projectName) {\n    console.log(`Project:  ${info.configuration.projectName} (${info.configuration.projectId})`);\n  } else if (info.configuration.projectId) {\n    console.log(`Project:  ${info.configuration.projectId}`);\n  } else {\n    console.log(`Project:  ${chalk.dim('(not set)')}`);\n  }\n\n  if (info.configuration.specificationTitle) {\n    console.log(`Spec:     ${info.configuration.specificationTitle} (${info.configuration.specificationId})`);\n  } else if (info.configuration.specificationId) {\n    console.log(`Spec:     ${info.configuration.specificationId}`);\n  } else {\n    console.log(`Spec:     ${chalk.dim('(not set)')}`);\n  }\n\n  console.log(`MCP format: ${info.configuration.mcpOutputFormat}`);\n}\n\n/**\n * Display configuration file paths\n */\nfunction displayPaths(info: WhoamiInfo): void {\n  console.log(chalk.bold('\\nPaths'));\n  console.log('─────');\n  console.log(`Project config: ${info.paths.projectConfig}`);\n  console.log(`MCP config:     ${info.paths.mcpConfig}`);\n  console.log(`Global config:  ${info.paths.globalConfig}`);\n  console.log();\n}\n\n/**\n * Whoami command implementation\n *\n * Displays current user and configuration information.\n */\nexport async function whoamiCommand(options: WhoamiOptions): Promise<void> {\n  const config = resolveConfig();\n  const paths = getConfigPaths();\n\n  const spinner = ora('Fetching user info...').start();\n\n  try {\n    const client = createCliClient({\n      apiKey: config.apiKey!,\n      apiUrl: process.env.SPECFORGE_API_URL || CHANNEL.endpoint.primary,\n      debug: config.debug,\n    });\n\n    // Get user info\n    const userResponse = await client.call('get_current_user', {}) as { email?: string; name?: string };\n    const userEmail = userResponse.email || 'Unknown';\n    const userName = userResponse.name;\n\n    // Get project name if configured\n    let projectName: string | undefined;\n    if (config.projectId) {\n      try {\n        const proj = await client.call('get_project', { projectId: config.projectId });\n        projectName = (proj as { name?: string }).name;\n      } catch {\n        // Ignore - project might not exist\n      }\n    }\n\n    // Get specification title if configured\n    let specTitle: string | undefined;\n    if (config.specificationId) {\n      try {\n        const spec = await client.call('get_specification', {\n          specificationId: config.specificationId\n        });\n        specTitle = (spec as { title?: string }).title;\n      } catch {\n        // Ignore - spec might not exist\n      }\n    }\n\n    spinner.stop();\n\n    // Build whoami info\n    const info: WhoamiInfo = {\n      user: {\n        name: userName,\n        email: userEmail,\n        apiKey: maskApiKey(config.apiKey!),\n      },\n      configuration: {\n        source: getConfigSource(config),\n        projectId: config.projectId || undefined,\n        projectName,\n        specificationId: config.specificationId || undefined,\n        specificationTitle: specTitle,\n        mcpOutputFormat: config.mcpOutputFormat || 'json',\n      },\n      paths: {\n        projectConfig: paths.projectConfig,\n        mcpConfig: paths.mcpConfig,\n        globalConfig: paths.globalConfig,\n      },\n    };\n\n    // JSON output\n    if (options.json) {\n      console.log(JSON.stringify(info, null, 2));\n      return;\n    }\n\n    // Display formatted output\n    displayUserInfo(info);\n    displayConfiguration(info);\n    displayPaths(info);\n\n  } catch (error) {\n    spinner.fail('Failed to fetch user info');\n    const message = error instanceof Error ? error.message : 'Unknown error';\n    console.error(chalk.red(`\\nError: ${message}`));\n    process.exit(1);\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/cli/commands/doctor.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Doctor Command
+ *
+ * Diagnoses configuration and connection issues for SpecForge MCP.
+ */
+import { Command } from 'commander';
+import { DoctorOptions } from './doctor.types.js';
+/**
+ * Doctor command action handler
+ */
+export declare function doctorAction(options: DoctorOptions): Promise<void>;
+/**
+ * Register doctor command with Commander
+ */
+export declare function registerDoctorCommand(program: Command): void;
+//# sourceMappingURL=doctor.d.ts.map

package/dist/cli/commands/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/doctor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAcpC,OAAO,EACL,aAAa,EAkBd,MAAM,mBAAmB,CAAC;AAoZ3B;;GAEG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CA2DxE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAsB5D"}

package/dist/cli/commands/doctor.js

@@ -0,0 +1,413 @@
+import fs from "node:fs";
+import {
+  resolveConfig,
+  loadGlobalConfig,
+  tryLoadProjectConfig,
+  getConfigPaths
+} from "../config/index.js";
+import { withErrorHandler } from "../middleware/error-handler.js";
+import { printBlank, printHeader } from "../ui/output.js";
+import { colors } from "../ui/colors.js";
+import { forgeProgress } from "../ui/spinner.js";
+import { createCliClient } from "../../client/cli-client.js";
+import { CHANNEL } from "../../channel.js";
+import {
+  createPassResult,
+  createFailResult,
+  createWarnResult,
+  calculateSummary,
+  hasFailures,
+  getStatusIcon,
+  CHECK_CATEGORIES,
+  CONFIG_CHECK_NAMES,
+  AUTH_CHECK_NAMES,
+  CONNECTION_CHECK_NAMES,
+  PROJECT_CHECK_NAMES,
+  PERFORMANCE_THRESHOLDS,
+  API_KEY_VALIDATION,
+  FIX_SUGGESTIONS
+} from "./doctor.types.js";
+function maskApiKey(apiKey, visibleChars = 8) {
+  if (apiKey.length <= visibleChars) {
+    return "***";
+  }
+  return `${API_KEY_VALIDATION.PREFIX}...${apiKey.slice(-visibleChars)}`;
+}
+function runConfigurationChecks() {
+  const results = [];
+  const paths = getConfigPaths();
+  const globalConfig = loadGlobalConfig();
+  const projectConfig = tryLoadProjectConfig();
+  results.push(createPassResult(
+    CONFIG_CHECK_NAMES.CHANNEL,
+    `${CHANNEL.name} \xB7 ${CHANNEL.packageName} \xB7 ${CHANNEL.endpoint.primary}`,
+    { name: CHANNEL.name, packageName: CHANNEL.packageName, endpoint: CHANNEL.endpoint.primary }
+  ));
+  if (fs.existsSync(paths.mcpConfig)) {
+    results.push(createPassResult(
+      CONFIG_CHECK_NAMES.MCP_CONFIG_FOUND,
+      paths.mcpConfig
+    ));
+  } else {
+    results.push(createFailResult(
+      CONFIG_CHECK_NAMES.MCP_CONFIG_FOUND,
+      "File not found",
+      FIX_SUGGESTIONS.MISSING_MCP_CONFIG
+    ));
+  }
+  if (projectConfig) {
+    results.push(createPassResult(
+      CONFIG_CHECK_NAMES.PROJECT_CONFIG_FOUND,
+      paths.projectConfig
+    ));
+  } else {
+    results.push(createWarnResult(
+      CONFIG_CHECK_NAMES.PROJECT_CONFIG_FOUND,
+      "File not found (optional)",
+      FIX_SUGGESTIONS.MISSING_PROJECT_CONFIG
+    ));
+  }
+  results.push(createPassResult(
+    CONFIG_CHECK_NAMES.GLOBAL_CONFIG_DIR,
+    paths.globalConfig
+  ));
+  if (projectConfig?.planningSessionId) {
+    results.push(createPassResult(
+      CONFIG_CHECK_NAMES.PLANNING_SESSION,
+      projectConfig.planningSessionId
+    ));
+  } else {
+    results.push(createWarnResult(
+      CONFIG_CHECK_NAMES.PLANNING_SESSION,
+      "None (no planning session persisted for this spec)"
+    ));
+  }
+  const apiKeySource = process.env.SPECFORGE_API_KEY ? "From environment variable" : globalConfig.apiKey ? "From ~/.specforge/config.json" : void 0;
+  if (apiKeySource) {
+    results.push(createPassResult(
+      CONFIG_CHECK_NAMES.API_KEY_CONFIGURED,
+      apiKeySource
+    ));
+  } else {
+    results.push(createFailResult(
+      CONFIG_CHECK_NAMES.API_KEY_CONFIGURED,
+      "No API key found",
+      FIX_SUGGESTIONS.MISSING_API_KEY
+    ));
+  }
+  return results;
+}
+async function runAuthenticationChecks(apiKey) {
+  const results = [];
+  if (!apiKey) {
+    results.push(createFailResult(
+      AUTH_CHECK_NAMES.API_KEY_FORMAT,
+      "No API key to validate"
+    ));
+    return results;
+  }
+  const hasValidPrefix = apiKey.startsWith(API_KEY_VALIDATION.PREFIX);
+  const hasValidLength = apiKey.length >= API_KEY_VALIDATION.MIN_LENGTH;
+  if (hasValidPrefix && hasValidLength) {
+    results.push(createPassResult(
+      AUTH_CHECK_NAMES.API_KEY_FORMAT,
+      maskApiKey(apiKey)
+    ));
+  } else {
+    const issues = [];
+    if (!hasValidPrefix) issues.push(`should start with ${API_KEY_VALIDATION.PREFIX}`);
+    if (!hasValidLength) issues.push(`minimum ${API_KEY_VALIDATION.MIN_LENGTH} characters`);
+    results.push(createFailResult(
+      AUTH_CHECK_NAMES.API_KEY_FORMAT,
+      `Invalid format (${issues.join(", ")})`,
+      FIX_SUGGESTIONS.INVALID_API_KEY_FORMAT
+    ));
+    return results;
+  }
+  const config = resolveConfig();
+  const client = createCliClient({
+    apiKey,
+    apiUrl: config.apiUrl,
+    debug: config.debug
+  });
+  try {
+    await client.call("list_projects", {});
+    results.push(createPassResult(
+      AUTH_CHECK_NAMES.API_KEY_AUTHENTICATED,
+      "Successfully authenticated"
+    ));
+    try {
+      const userResponse = await client.call(
+        "get_current_user",
+        {}
+      );
+      const userInfo = userResponse.name ? `${userResponse.name} (${userResponse.email})` : userResponse.email || "Unknown";
+      results.push(createPassResult(
+        AUTH_CHECK_NAMES.USER_INFO,
+        userInfo
+      ));
+    } catch {
+      results.push(createPassResult(
+        AUTH_CHECK_NAMES.USER_INFO,
+        "Authenticated (email not available)"
+      ));
+    }
+  } catch (error) {
+    const message = error instanceof Error ? error.message : "Unknown error";
+    if (message.includes("401") || message.includes("Unauthorized")) {
+      results.push(createFailResult(
+        AUTH_CHECK_NAMES.API_KEY_AUTHENTICATED,
+        "Invalid or expired API key",
+        FIX_SUGGESTIONS.EXPIRED_API_KEY
+      ));
+    } else {
+      results.push(createFailResult(
+        AUTH_CHECK_NAMES.API_KEY_AUTHENTICATED,
+        `Authentication failed: ${message}`
+      ));
+    }
+  }
+  return results;
+}
+async function runConnectionChecks(apiKey) {
+  const results = [];
+  const config = resolveConfig();
+  const apiUrl = config.apiUrl;
+  if (!apiKey) {
+    results.push(createFailResult(
+      CONNECTION_CHECK_NAMES.API_ENDPOINT_REACHABLE,
+      "No API key to test connection",
+      FIX_SUGGESTIONS.MISSING_API_KEY
+    ));
+    return results;
+  }
+  const client = createCliClient({
+    apiKey,
+    apiUrl: config.apiUrl,
+    debug: config.debug
+  });
+  try {
+    const start = Date.now();
+    await client.call("list_projects", {});
+    const elapsed = Date.now() - start;
+    results.push(createPassResult(
+      CONNECTION_CHECK_NAMES.API_ENDPOINT_REACHABLE,
+      apiUrl
+    ));
+    if (elapsed < PERFORMANCE_THRESHOLDS.RESPONSE_TIME_WARNING) {
+      results.push(createPassResult(
+        CONNECTION_CHECK_NAMES.RESPONSE_TIME,
+        `${elapsed}ms`,
+        { elapsed }
+      ));
+    } else if (elapsed < PERFORMANCE_THRESHOLDS.RESPONSE_TIME_ERROR) {
+      results.push(createWarnResult(
+        CONNECTION_CHECK_NAMES.RESPONSE_TIME,
+        `${elapsed}ms (slow)`,
+        void 0,
+        { elapsed }
+      ));
+    } else {
+      results.push(createFailResult(
+        CONNECTION_CHECK_NAMES.RESPONSE_TIME,
+        `${elapsed}ms (very slow)`,
+        FIX_SUGGESTIONS.CONNECTION_TIMEOUT,
+        { elapsed }
+      ));
+    }
+  } catch (error) {
+    const message = error instanceof Error ? error.message : "Unknown error";
+    if (message.includes("ENOTFOUND") || message.includes("ECONNREFUSED") || message.includes("getaddrinfo")) {
+      results.push(createFailResult(
+        CONNECTION_CHECK_NAMES.API_ENDPOINT_REACHABLE,
+        "Could not connect to API",
+        FIX_SUGGESTIONS.CONNECTION_FAILED
+      ));
+    } else if (message.includes("timeout") || message.includes("TimeoutError")) {
+      results.push(createFailResult(
+        CONNECTION_CHECK_NAMES.API_ENDPOINT_REACHABLE,
+        "Connection timed out",
+        FIX_SUGGESTIONS.CONNECTION_TIMEOUT
+      ));
+    } else if (message.includes("401") || message.includes("Unauthorized")) {
+      results.push(createPassResult(
+        CONNECTION_CHECK_NAMES.API_ENDPOINT_REACHABLE,
+        `${apiUrl} (auth issue handled separately)`
+      ));
+    } else {
+      results.push(createFailResult(
+        CONNECTION_CHECK_NAMES.API_ENDPOINT_REACHABLE,
+        message
+      ));
+    }
+  }
+  return results;
+}
+async function runProjectAccessChecks() {
+  const results = [];
+  const config = resolveConfig();
+  if (!config.apiKey) {
+    return results;
+  }
+  const client = createCliClient({
+    apiKey: config.apiKey,
+    apiUrl: config.apiUrl,
+    debug: config.debug
+  });
+  if (config.projectId) {
+    try {
+      await client.call("get_project", { projectId: config.projectId });
+      results.push(createPassResult(
+        PROJECT_CHECK_NAMES.PROJECT_ACCESSIBLE,
+        config.projectId
+      ));
+    } catch (error) {
+      const message = error instanceof Error ? error.message : "Unknown error";
+      results.push(createFailResult(
+        PROJECT_CHECK_NAMES.PROJECT_ACCESSIBLE,
+        `Cannot access: ${message}`,
+        FIX_SUGGESTIONS.PROJECT_NOT_ACCESSIBLE
+      ));
+    }
+  } else {
+    results.push(createWarnResult(
+      PROJECT_CHECK_NAMES.PROJECT_ACCESSIBLE,
+      "No default project configured",
+      FIX_SUGGESTIONS.NO_PROJECT_CONFIGURED
+    ));
+  }
+  if (config.specificationId) {
+    try {
+      await client.call("get_specification", { specificationId: config.specificationId });
+      results.push(createPassResult(
+        PROJECT_CHECK_NAMES.SPECIFICATION_ACCESSIBLE,
+        config.specificationId
+      ));
+    } catch (error) {
+      const message = error instanceof Error ? error.message : "Unknown error";
+      results.push(createFailResult(
+        PROJECT_CHECK_NAMES.SPECIFICATION_ACCESSIBLE,
+        `Cannot access: ${message}`,
+        FIX_SUGGESTIONS.SPEC_NOT_ACCESSIBLE
+      ));
+    }
+  } else {
+    results.push(createWarnResult(
+      PROJECT_CHECK_NAMES.SPECIFICATION_ACCESSIBLE,
+      "No default specification configured"
+    ));
+  }
+  return results;
+}
+function displayReport(report) {
+  printBlank();
+  printHeader("SpecForge MCP Health Check");
+  printBlank();
+  for (const category of CHECK_CATEGORIES) {
+    const checks = report.checks[category.id];
+    if (checks.length === 0) continue;
+    console.log(colors.bold(category.name));
+    for (const check of checks) {
+      const icon = check.status === "pass" ? colors.success(getStatusIcon("pass")) : check.status === "warn" ? colors.warning(getStatusIcon("warn")) : colors.error(getStatusIcon("fail"));
+      console.log(`  ${icon} ${check.name}: ${check.message}`);
+      if (check.fix && check.status !== "pass") {
+        console.log(colors.muted(`    \u2192 ${check.fix}`));
+      }
+    }
+    printBlank();
+  }
+  const { passed, failed, warnings, total } = report.summary;
+  if (failed === 0 && warnings === 0) {
+    console.log(colors.success(`All ${total} checks passed!`));
+  } else if (failed === 0) {
+    console.log(
+      colors.success("All checks passed!") + colors.warning(` (${warnings} warning${warnings > 1 ? "s" : ""})`)
+    );
+  } else {
+    const failMsg = `${failed} check${failed > 1 ? "s" : ""} failed`;
+    const warnMsg = warnings > 0 ? `, ${warnings} warning${warnings > 1 ? "s" : ""}` : "";
+    console.log(colors.error(failMsg) + colors.warning(warnMsg));
+  }
+  printBlank();
+}
+async function doctorAction(options) {
+  const config = resolveConfig();
+  let configChecks = [];
+  let authChecks = [];
+  let connectionChecks = [];
+  let projectChecks = [];
+  if (options.json) {
+    configChecks = runConfigurationChecks();
+    authChecks = await runAuthenticationChecks(config.apiKey);
+    connectionChecks = await runConnectionChecks(config.apiKey);
+    projectChecks = await runProjectAccessChecks();
+  } else {
+    await forgeProgress("Running diagnostics", [
+      {
+        label: "config",
+        fn: async () => {
+          configChecks = runConfigurationChecks();
+        }
+      },
+      {
+        label: "auth",
+        fn: async () => {
+          authChecks = await runAuthenticationChecks(config.apiKey);
+        }
+      },
+      {
+        label: "connection",
+        fn: async () => {
+          connectionChecks = await runConnectionChecks(config.apiKey);
+        }
+      },
+      {
+        label: "project",
+        fn: async () => {
+          projectChecks = await runProjectAccessChecks();
+        }
+      }
+    ]);
+  }
+  const checks = {
+    configuration: configChecks,
+    authentication: authChecks,
+    connection: connectionChecks,
+    projectAccess: projectChecks
+  };
+  const report = {
+    checks,
+    summary: calculateSummary(checks),
+    timestamp: (/* @__PURE__ */ new Date()).toISOString()
+  };
+  if (options.json) {
+    console.log(JSON.stringify(report, null, 2));
+  } else {
+    displayReport(report);
+  }
+  if (hasFailures(report)) {
+    process.exit(1);
+  }
+}
+function registerDoctorCommand(program) {
+  program.command("doctor").description("Diagnose configuration and connection issues").option("--json", "Output as JSON for scripting").option("--fix", "Attempt to fix issues automatically (future)").addHelpText("after", `
+Examples:
+  $ specforge doctor              # Run health checks
+  $ specforge doctor --json       # Output as JSON
+
+Check Categories:
+  Configuration   - Config files presence and validity
+  Authentication  - API key format and authentication
+  Connection      - API connectivity and response time
+  Project Access  - Access to configured project/specification
+
+Exit Codes:
+  0 - All checks passed (warnings OK)
+  1 - One or more checks failed
+`).action(withErrorHandler(doctorAction));
+}
+export {
+  doctorAction,
+  registerDoctorCommand
+};
+//# sourceMappingURL=doctor.js.map

package/dist/cli/commands/doctor.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/cli/commands/doctor.ts"],"sourcesContent":["/**\n * Doctor Command\n *\n * Diagnoses configuration and connection issues for SpecForge MCP.\n */\n\nimport { Command } from 'commander';\nimport fs from 'node:fs';\nimport {\n  resolveConfig,\n  loadGlobalConfig,\n  tryLoadProjectConfig,\n  getConfigPaths,\n} from '../config/index.js';\nimport { withErrorHandler } from '../middleware/error-handler.js';\nimport { printBlank, printHeader } from '../ui/output.js';\nimport { colors } from '../ui/colors.js';\nimport { forgeProgress } from '../ui/spinner.js';\nimport { createCliClient } from '../../client/cli-client.js';\nimport { CHANNEL } from '../../channel.js';\nimport {\n  DoctorOptions,\n  DoctorReport,\n  CheckResult,\n  CheckCategory,\n  createPassResult,\n  createFailResult,\n  createWarnResult,\n  calculateSummary,\n  hasFailures,\n  getStatusIcon,\n  CHECK_CATEGORIES,\n  CONFIG_CHECK_NAMES,\n  AUTH_CHECK_NAMES,\n  CONNECTION_CHECK_NAMES,\n  PROJECT_CHECK_NAMES,\n  PERFORMANCE_THRESHOLDS,\n  API_KEY_VALIDATION,\n  FIX_SUGGESTIONS,\n} from './doctor.types.js';\n\n/**\n * Mask an API key for display (show only last N characters)\n */\nfunction maskApiKey(apiKey: string, visibleChars = 8): string {\n  if (apiKey.length <= visibleChars) {\n    return '***';\n  }\n  return `${API_KEY_VALIDATION.PREFIX}...${apiKey.slice(-visibleChars)}`;\n}\n\n/**\n * Run configuration checks\n */\nfunction runConfigurationChecks(): CheckResult[] {\n  const results: CheckResult[] = [];\n  const paths = getConfigPaths();\n  const globalConfig = loadGlobalConfig();\n  const projectConfig = tryLoadProjectConfig();\n\n  // Channel + endpoint the binary is wired to (M9.6c).\n  results.push(createPassResult(\n    CONFIG_CHECK_NAMES.CHANNEL,\n    `${CHANNEL.name} · ${CHANNEL.packageName} · ${CHANNEL.endpoint.primary}`,\n    { name: CHANNEL.name, packageName: CHANNEL.packageName, endpoint: CHANNEL.endpoint.primary },\n  ));\n\n  // Check .mcp.json\n  if (fs.existsSync(paths.mcpConfig)) {\n    results.push(createPassResult(\n      CONFIG_CHECK_NAMES.MCP_CONFIG_FOUND,\n      paths.mcpConfig\n    ));\n  } else {\n    results.push(createFailResult(\n      CONFIG_CHECK_NAMES.MCP_CONFIG_FOUND,\n      'File not found',\n      FIX_SUGGESTIONS.MISSING_MCP_CONFIG\n    ));\n  }\n\n  // Check .specforge.json (optional)\n  if (projectConfig) {\n    results.push(createPassResult(\n      CONFIG_CHECK_NAMES.PROJECT_CONFIG_FOUND,\n      paths.projectConfig\n    ));\n  } else {\n    results.push(createWarnResult(\n      CONFIG_CHECK_NAMES.PROJECT_CONFIG_FOUND,\n      'File not found (optional)',\n      FIX_SUGGESTIONS.MISSING_PROJECT_CONFIG\n    ));\n  }\n\n  // Global config directory (M9.6c — channel-aware path).\n  results.push(createPassResult(\n    CONFIG_CHECK_NAMES.GLOBAL_CONFIG_DIR,\n    paths.globalConfig\n  ));\n\n  // Active planning session for this spec (M9.6c) — read from local config; the\n  // agent injects this id per-call. (The old `get_working_context` op is dead.)\n  if (projectConfig?.planningSessionId) {\n    results.push(createPassResult(\n      CONFIG_CHECK_NAMES.PLANNING_SESSION,\n      projectConfig.planningSessionId\n    ));\n  } else {\n    results.push(createWarnResult(\n      CONFIG_CHECK_NAMES.PLANNING_SESSION,\n      'None (no planning session persisted for this spec)'\n    ));\n  }\n\n  // Check API key configured\n  const apiKeySource = process.env.SPECFORGE_API_KEY\n    ? 'From environment variable'\n    : globalConfig.apiKey\n      ? 'From ~/.specforge/config.json'\n      : undefined;\n\n  if (apiKeySource) {\n    results.push(createPassResult(\n      CONFIG_CHECK_NAMES.API_KEY_CONFIGURED,\n      apiKeySource\n    ));\n  } else {\n    results.push(createFailResult(\n      CONFIG_CHECK_NAMES.API_KEY_CONFIGURED,\n      'No API key found',\n      FIX_SUGGESTIONS.MISSING_API_KEY\n    ));\n  }\n\n  return results;\n}\n\n/**\n * Run authentication checks\n */\nasync function runAuthenticationChecks(apiKey: string | null | undefined): Promise<CheckResult[]> {\n  const results: CheckResult[] = [];\n\n  if (!apiKey) {\n    results.push(createFailResult(\n      AUTH_CHECK_NAMES.API_KEY_FORMAT,\n      'No API key to validate'\n    ));\n    return results;\n  }\n\n  // Check format\n  const hasValidPrefix = apiKey.startsWith(API_KEY_VALIDATION.PREFIX);\n  const hasValidLength = apiKey.length >= API_KEY_VALIDATION.MIN_LENGTH;\n\n  if (hasValidPrefix && hasValidLength) {\n    results.push(createPassResult(\n      AUTH_CHECK_NAMES.API_KEY_FORMAT,\n      maskApiKey(apiKey)\n    ));\n  } else {\n    const issues: string[] = [];\n    if (!hasValidPrefix) issues.push(`should start with ${API_KEY_VALIDATION.PREFIX}`);\n    if (!hasValidLength) issues.push(`minimum ${API_KEY_VALIDATION.MIN_LENGTH} characters`);\n\n    results.push(createFailResult(\n      AUTH_CHECK_NAMES.API_KEY_FORMAT,\n      `Invalid format (${issues.join(', ')})`,\n      FIX_SUGGESTIONS.INVALID_API_KEY_FORMAT\n    ));\n    return results; // Don't test against backend if format is invalid\n  }\n\n  // Validate against backend\n  const config = resolveConfig();\n  const client = createCliClient({\n    apiKey,\n    apiUrl: config.apiUrl,\n    debug: config.debug,\n  });\n\n  try {\n    // First verify authentication works\n    await client.call('list_projects', {});\n\n    results.push(createPassResult(\n      AUTH_CHECK_NAMES.API_KEY_AUTHENTICATED,\n      'Successfully authenticated'\n    ));\n\n    // Get user info\n    try {\n      const userResponse = await client.call<{ email?: string; name?: string }>(\n        'get_current_user',\n        {}\n      );\n      const userInfo = userResponse.name\n        ? `${userResponse.name} (${userResponse.email})`\n        : userResponse.email || 'Unknown';\n      results.push(createPassResult(\n        AUTH_CHECK_NAMES.USER_INFO,\n        userInfo\n      ));\n    } catch {\n      results.push(createPassResult(\n        AUTH_CHECK_NAMES.USER_INFO,\n        'Authenticated (email not available)'\n      ));\n    }\n  } catch (error) {\n    const message = error instanceof Error ? error.message : 'Unknown error';\n\n    if (message.includes('401') || message.includes('Unauthorized')) {\n      results.push(createFailResult(\n        AUTH_CHECK_NAMES.API_KEY_AUTHENTICATED,\n        'Invalid or expired API key',\n        FIX_SUGGESTIONS.EXPIRED_API_KEY\n      ));\n    } else {\n      results.push(createFailResult(\n        AUTH_CHECK_NAMES.API_KEY_AUTHENTICATED,\n        `Authentication failed: ${message}`\n      ));\n    }\n  }\n\n  return results;\n}\n\n/**\n * Run connection checks\n */\nasync function runConnectionChecks(apiKey: string | null | undefined): Promise<CheckResult[]> {\n  const results: CheckResult[] = [];\n  const config = resolveConfig();\n  const apiUrl = config.apiUrl;\n\n  // Skip connection check if no API key (auth checks will fail anyway)\n  if (!apiKey) {\n    results.push(createFailResult(\n      CONNECTION_CHECK_NAMES.API_ENDPOINT_REACHABLE,\n      'No API key to test connection',\n      FIX_SUGGESTIONS.MISSING_API_KEY\n    ));\n    return results;\n  }\n\n  const client = createCliClient({\n    apiKey,\n    apiUrl: config.apiUrl,\n    debug: config.debug,\n  });\n\n  try {\n    const start = Date.now();\n    // Use an authenticated call to test connectivity\n    await client.call('list_projects', {});\n    const elapsed = Date.now() - start;\n\n    results.push(createPassResult(\n      CONNECTION_CHECK_NAMES.API_ENDPOINT_REACHABLE,\n      apiUrl\n    ));\n\n    // Response time check\n    if (elapsed < PERFORMANCE_THRESHOLDS.RESPONSE_TIME_WARNING) {\n      results.push(createPassResult(\n        CONNECTION_CHECK_NAMES.RESPONSE_TIME,\n        `${elapsed}ms`,\n        { elapsed }\n      ));\n    } else if (elapsed < PERFORMANCE_THRESHOLDS.RESPONSE_TIME_ERROR) {\n      results.push(createWarnResult(\n        CONNECTION_CHECK_NAMES.RESPONSE_TIME,\n        `${elapsed}ms (slow)`,\n        undefined,\n        { elapsed }\n      ));\n    } else {\n      results.push(createFailResult(\n        CONNECTION_CHECK_NAMES.RESPONSE_TIME,\n        `${elapsed}ms (very slow)`,\n        FIX_SUGGESTIONS.CONNECTION_TIMEOUT,\n        { elapsed }\n      ));\n    }\n  } catch (error) {\n    const message = error instanceof Error ? error.message : 'Unknown error';\n\n    if (message.includes('ENOTFOUND') || message.includes('ECONNREFUSED') || message.includes('getaddrinfo')) {\n      results.push(createFailResult(\n        CONNECTION_CHECK_NAMES.API_ENDPOINT_REACHABLE,\n        'Could not connect to API',\n        FIX_SUGGESTIONS.CONNECTION_FAILED\n      ));\n    } else if (message.includes('timeout') || message.includes('TimeoutError')) {\n      results.push(createFailResult(\n        CONNECTION_CHECK_NAMES.API_ENDPOINT_REACHABLE,\n        'Connection timed out',\n        FIX_SUGGESTIONS.CONNECTION_TIMEOUT\n      ));\n    } else if (message.includes('401') || message.includes('Unauthorized')) {\n      // Auth issue, but connection works\n      results.push(createPassResult(\n        CONNECTION_CHECK_NAMES.API_ENDPOINT_REACHABLE,\n        `${apiUrl} (auth issue handled separately)`\n      ));\n    } else {\n      results.push(createFailResult(\n        CONNECTION_CHECK_NAMES.API_ENDPOINT_REACHABLE,\n        message\n      ));\n    }\n  }\n\n  return results;\n}\n\n/**\n * Run project access checks\n */\nasync function runProjectAccessChecks(): Promise<CheckResult[]> {\n  const results: CheckResult[] = [];\n  const config = resolveConfig();\n\n  if (!config.apiKey) {\n    // Skip if no API key (auth checks already failed)\n    return results;\n  }\n\n  const client = createCliClient({\n    apiKey: config.apiKey,\n    apiUrl: config.apiUrl,\n    debug: config.debug,\n  });\n\n  // Check project access\n  if (config.projectId) {\n    try {\n      await client.call('get_project', { projectId: config.projectId });\n      results.push(createPassResult(\n        PROJECT_CHECK_NAMES.PROJECT_ACCESSIBLE,\n        config.projectId\n      ));\n    } catch (error) {\n      const message = error instanceof Error ? error.message : 'Unknown error';\n      results.push(createFailResult(\n        PROJECT_CHECK_NAMES.PROJECT_ACCESSIBLE,\n        `Cannot access: ${message}`,\n        FIX_SUGGESTIONS.PROJECT_NOT_ACCESSIBLE\n      ));\n    }\n  } else {\n    results.push(createWarnResult(\n      PROJECT_CHECK_NAMES.PROJECT_ACCESSIBLE,\n      'No default project configured',\n      FIX_SUGGESTIONS.NO_PROJECT_CONFIGURED\n    ));\n  }\n\n  // Check specification access\n  if (config.specificationId) {\n    try {\n      await client.call('get_specification', { specificationId: config.specificationId });\n      results.push(createPassResult(\n        PROJECT_CHECK_NAMES.SPECIFICATION_ACCESSIBLE,\n        config.specificationId\n      ));\n    } catch (error) {\n      const message = error instanceof Error ? error.message : 'Unknown error';\n      results.push(createFailResult(\n        PROJECT_CHECK_NAMES.SPECIFICATION_ACCESSIBLE,\n        `Cannot access: ${message}`,\n        FIX_SUGGESTIONS.SPEC_NOT_ACCESSIBLE\n      ));\n    }\n  } else {\n    results.push(createWarnResult(\n      PROJECT_CHECK_NAMES.SPECIFICATION_ACCESSIBLE,\n      'No default specification configured'\n    ));\n  }\n\n  // NOTE: the implementation-session probe (old `get_working_context`) was\n  // removed in M8/M9 — that backend op no longer exists. The active planning\n  // session is surfaced from local config in runConfigurationChecks (M9.6c).\n\n  return results;\n}\n\n/**\n * Display the report in formatted console output\n */\nfunction displayReport(report: DoctorReport): void {\n  printBlank();\n  printHeader('SpecForge MCP Health Check');\n  printBlank();\n\n  for (const category of CHECK_CATEGORIES) {\n    const checks = report.checks[category.id];\n    if (checks.length === 0) continue;\n\n    console.log(colors.bold(category.name));\n\n    for (const check of checks) {\n      const icon = check.status === 'pass'\n        ? colors.success(getStatusIcon('pass'))\n        : check.status === 'warn'\n          ? colors.warning(getStatusIcon('warn'))\n          : colors.error(getStatusIcon('fail'));\n\n      console.log(`  ${icon} ${check.name}: ${check.message}`);\n\n      if (check.fix && check.status !== 'pass') {\n        console.log(colors.muted(`    → ${check.fix}`));\n      }\n    }\n\n    printBlank();\n  }\n\n  // Summary\n  const { passed, failed, warnings, total } = report.summary;\n\n  if (failed === 0 && warnings === 0) {\n    console.log(colors.success(`All ${total} checks passed!`));\n  } else if (failed === 0) {\n    console.log(\n      colors.success('All checks passed!') +\n      colors.warning(` (${warnings} warning${warnings > 1 ? 's' : ''})`)\n    );\n  } else {\n    const failMsg = `${failed} check${failed > 1 ? 's' : ''} failed`;\n    const warnMsg = warnings > 0\n      ? `, ${warnings} warning${warnings > 1 ? 's' : ''}`\n      : '';\n    console.log(colors.error(failMsg) + colors.warning(warnMsg));\n  }\n\n  printBlank();\n}\n\n/**\n * Doctor command action handler\n */\nexport async function doctorAction(options: DoctorOptions): Promise<void> {\n  const config = resolveConfig();\n\n  let configChecks: CheckResult[] = [];\n  let authChecks: CheckResult[] = [];\n  let connectionChecks: CheckResult[] = [];\n  let projectChecks: CheckResult[] = [];\n\n  if (options.json) {\n    configChecks = runConfigurationChecks();\n    authChecks = await runAuthenticationChecks(config.apiKey);\n    connectionChecks = await runConnectionChecks(config.apiKey);\n    projectChecks = await runProjectAccessChecks();\n  } else {\n    await forgeProgress('Running diagnostics', [\n      {\n        label: 'config',\n        fn: async () => { configChecks = runConfigurationChecks(); },\n      },\n      {\n        label: 'auth',\n        fn: async () => { authChecks = await runAuthenticationChecks(config.apiKey); },\n      },\n      {\n        label: 'connection',\n        fn: async () => { connectionChecks = await runConnectionChecks(config.apiKey); },\n      },\n      {\n        label: 'project',\n        fn: async () => { projectChecks = await runProjectAccessChecks(); },\n      },\n    ]);\n  }\n\n  // Compile report\n  const checks: Record<CheckCategory, CheckResult[]> = {\n    configuration: configChecks,\n    authentication: authChecks,\n    connection: connectionChecks,\n    projectAccess: projectChecks,\n  };\n\n  const report: DoctorReport = {\n    checks,\n    summary: calculateSummary(checks),\n    timestamp: new Date().toISOString(),\n  };\n\n  // Output\n  if (options.json) {\n    console.log(JSON.stringify(report, null, 2));\n  } else {\n    displayReport(report);\n  }\n\n  // Exit with error if any checks failed\n  if (hasFailures(report)) {\n    process.exit(1);\n  }\n}\n\n/**\n * Register doctor command with Commander\n */\nexport function registerDoctorCommand(program: Command): void {\n  program\n    .command('doctor')\n    .description('Diagnose configuration and connection issues')\n    .option('--json', 'Output as JSON for scripting')\n    .option('--fix', 'Attempt to fix issues automatically (future)')\n    .addHelpText('after', `\nExamples:\n  $ specforge doctor              # Run health checks\n  $ specforge doctor --json       # Output as JSON\n\nCheck Categories:\n  Configuration   - Config files presence and validity\n  Authentication  - API key format and authentication\n  Connection      - API connectivity and response time\n  Project Access  - Access to configured project/specification\n\nExit Codes:\n  0 - All checks passed (warnings OK)\n  1 - One or more checks failed\n`)\n    .action(withErrorHandler(doctorAction));\n}\n"],"mappings":"AAOA,OAAO,QAAQ;AACf;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,wBAAwB;AACjC,SAAS,YAAY,mBAAmB;AACxC,SAAS,cAAc;AACvB,SAAS,qBAAqB;AAC9B,SAAS,uBAAuB;AAChC,SAAS,eAAe;AACxB;AAAA,EAKE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAKP,SAAS,WAAW,QAAgB,eAAe,GAAW;AAC5D,MAAI,OAAO,UAAU,cAAc;AACjC,WAAO;AAAA,EACT;AACA,SAAO,GAAG,mBAAmB,MAAM,MAAM,OAAO,MAAM,CAAC,YAAY,CAAC;AACtE;AAKA,SAAS,yBAAwC;AAC/C,QAAM,UAAyB,CAAC;AAChC,QAAM,QAAQ,eAAe;AAC7B,QAAM,eAAe,iBAAiB;AACtC,QAAM,gBAAgB,qBAAqB;AAG3C,UAAQ,KAAK;AAAA,IACX,mBAAmB;AAAA,IACnB,GAAG,QAAQ,IAAI,SAAM,QAAQ,WAAW,SAAM,QAAQ,SAAS,OAAO;AAAA,IACtE,EAAE,MAAM,QAAQ,MAAM,aAAa,QAAQ,aAAa,UAAU,QAAQ,SAAS,QAAQ;AAAA,EAC7F,CAAC;AAGD,MAAI,GAAG,WAAW,MAAM,SAAS,GAAG;AAClC,YAAQ,KAAK;AAAA,MACX,mBAAmB;AAAA,MACnB,MAAM;AAAA,IACR,CAAC;AAAA,EACH,OAAO;AACL,YAAQ,KAAK;AAAA,MACX,mBAAmB;AAAA,MACnB;AAAA,MACA,gBAAgB;AAAA,IAClB,CAAC;AAAA,EACH;AAGA,MAAI,eAAe;AACjB,YAAQ,KAAK;AAAA,MACX,mBAAmB;AAAA,MACnB,MAAM;AAAA,IACR,CAAC;AAAA,EACH,OAAO;AACL,YAAQ,KAAK;AAAA,MACX,mBAAmB;AAAA,MACnB;AAAA,MACA,gBAAgB;AAAA,IAClB,CAAC;AAAA,EACH;AAGA,UAAQ,KAAK;AAAA,IACX,mBAAmB;AAAA,IACnB,MAAM;AAAA,EACR,CAAC;AAID,MAAI,eAAe,mBAAmB;AACpC,YAAQ,KAAK;AAAA,MACX,mBAAmB;AAAA,MACnB,cAAc;AAAA,IAChB,CAAC;AAAA,EACH,OAAO;AACL,YAAQ,KAAK;AAAA,MACX,mBAAmB;AAAA,MACnB;AAAA,IACF,CAAC;AAAA,EACH;AAGA,QAAM,eAAe,QAAQ,IAAI,oBAC7B,8BACA,aAAa,SACX,kCACA;AAEN,MAAI,cAAc;AAChB,YAAQ,KAAK;AAAA,MACX,mBAAmB;AAAA,MACnB;AAAA,IACF,CAAC;AAAA,EACH,OAAO;AACL,YAAQ,KAAK;AAAA,MACX,mBAAmB;AAAA,MACnB;AAAA,MACA,gBAAgB;AAAA,IAClB,CAAC;AAAA,EACH;AAEA,SAAO;AACT;AAKA,eAAe,wBAAwB,QAA2D;AAChG,QAAM,UAAyB,CAAC;AAEhC,MAAI,CAAC,QAAQ;AACX,YAAQ,KAAK;AAAA,MACX,iBAAiB;AAAA,MACjB;AAAA,IACF,CAAC;AACD,WAAO;AAAA,EACT;AAGA,QAAM,iBAAiB,OAAO,WAAW,mBAAmB,MAAM;AAClE,QAAM,iBAAiB,OAAO,UAAU,mBAAmB;AAE3D,MAAI,kBAAkB,gBAAgB;AACpC,YAAQ,KAAK;AAAA,MACX,iBAAiB;AAAA,MACjB,WAAW,MAAM;AAAA,IACnB,CAAC;AAAA,EACH,OAAO;AACL,UAAM,SAAmB,CAAC;AAC1B,QAAI,CAAC,eAAgB,QAAO,KAAK,qBAAqB,mBAAmB,MAAM,EAAE;AACjF,QAAI,CAAC,eAAgB,QAAO,KAAK,WAAW,mBAAmB,UAAU,aAAa;AAEtF,YAAQ,KAAK;AAAA,MACX,iBAAiB;AAAA,MACjB,mBAAmB,OAAO,KAAK,IAAI,CAAC;AAAA,MACpC,gBAAgB;AAAA,IAClB,CAAC;AACD,WAAO;AAAA,EACT;AAGA,QAAM,SAAS,cAAc;AAC7B,QAAM,SAAS,gBAAgB;AAAA,IAC7B;AAAA,IACA,QAAQ,OAAO;AAAA,IACf,OAAO,OAAO;AAAA,EAChB,CAAC;AAED,MAAI;AAEF,UAAM,OAAO,KAAK,iBAAiB,CAAC,CAAC;AAErC,YAAQ,KAAK;AAAA,MACX,iBAAiB;AAAA,MACjB;AAAA,IACF,CAAC;AAGD,QAAI;AACF,YAAM,eAAe,MAAM,OAAO;AAAA,QAChC;AAAA,QACA,CAAC;AAAA,MACH;AACA,YAAM,WAAW,aAAa,OAC1B,GAAG,aAAa,IAAI,KAAK,aAAa,KAAK,MAC3C,aAAa,SAAS;AAC1B,cAAQ,KAAK;AAAA,QACX,iBAAiB;AAAA,QACjB;AAAA,MACF,CAAC;AAAA,IACH,QAAQ;AACN,cAAQ,KAAK;AAAA,QACX,iBAAiB;AAAA,QACjB;AAAA,MACF,CAAC;AAAA,IACH;AAAA,EACF,SAAS,OAAO;AACd,UAAM,UAAU,iBAAiB,QAAQ,MAAM,UAAU;AAEzD,QAAI,QAAQ,SAAS,KAAK,KAAK,QAAQ,SAAS,cAAc,GAAG;AAC/D,cAAQ,KAAK;AAAA,QACX,iBAAiB;AAAA,QACjB;AAAA,QACA,gBAAgB;AAAA,MAClB,CAAC;AAAA,IACH,OAAO;AACL,cAAQ,KAAK;AAAA,QACX,iBAAiB;AAAA,QACjB,0BAA0B,OAAO;AAAA,MACnC,CAAC;AAAA,IACH;AAAA,EACF;AAEA,SAAO;AACT;AAKA,eAAe,oBAAoB,QAA2D;AAC5F,QAAM,UAAyB,CAAC;AAChC,QAAM,SAAS,cAAc;AAC7B,QAAM,SAAS,OAAO;AAGtB,MAAI,CAAC,QAAQ;AACX,YAAQ,KAAK;AAAA,MACX,uBAAuB;AAAA,MACvB;AAAA,MACA,gBAAgB;AAAA,IAClB,CAAC;AACD,WAAO;AAAA,EACT;AAEA,QAAM,SAAS,gBAAgB;AAAA,IAC7B;AAAA,IACA,QAAQ,OAAO;AAAA,IACf,OAAO,OAAO;AAAA,EAChB,CAAC;AAED,MAAI;AACF,UAAM,QAAQ,KAAK,IAAI;AAEvB,UAAM,OAAO,KAAK,iBAAiB,CAAC,CAAC;AACrC,UAAM,UAAU,KAAK,IAAI,IAAI;AAE7B,YAAQ,KAAK;AAAA,MACX,uBAAuB;AAAA,MACvB;AAAA,IACF,CAAC;AAGD,QAAI,UAAU,uBAAuB,uBAAuB;AAC1D,cAAQ,KAAK;AAAA,QACX,uBAAuB;AAAA,QACvB,GAAG,OAAO;AAAA,QACV,EAAE,QAAQ;AAAA,MACZ,CAAC;AAAA,IACH,WAAW,UAAU,uBAAuB,qBAAqB;AAC/D,cAAQ,KAAK;AAAA,QACX,uBAAuB;AAAA,QACvB,GAAG,OAAO;AAAA,QACV;AAAA,QACA,EAAE,QAAQ;AAAA,MACZ,CAAC;AAAA,IACH,OAAO;AACL,cAAQ,KAAK;AAAA,QACX,uBAAuB;AAAA,QACvB,GAAG,OAAO;AAAA,QACV,gBAAgB;AAAA,QAChB,EAAE,QAAQ;AAAA,MACZ,CAAC;AAAA,IACH;AAAA,EACF,SAAS,OAAO;AACd,UAAM,UAAU,iBAAiB,QAAQ,MAAM,UAAU;AAEzD,QAAI,QAAQ,SAAS,WAAW,KAAK,QAAQ,SAAS,cAAc,KAAK,QAAQ,SAAS,aAAa,GAAG;AACxG,cAAQ,KAAK;AAAA,QACX,uBAAuB;AAAA,QACvB;AAAA,QACA,gBAAgB;AAAA,MAClB,CAAC;AAAA,IACH,WAAW,QAAQ,SAAS,SAAS,KAAK,QAAQ,SAAS,cAAc,GAAG;AAC1E,cAAQ,KAAK;AAAA,QACX,uBAAuB;AAAA,QACvB;AAAA,QACA,gBAAgB;AAAA,MAClB,CAAC;AAAA,IACH,WAAW,QAAQ,SAAS,KAAK,KAAK,QAAQ,SAAS,cAAc,GAAG;AAEtE,cAAQ,KAAK;AAAA,QACX,uBAAuB;AAAA,QACvB,GAAG,MAAM;AAAA,MACX,CAAC;AAAA,IACH,OAAO;AACL,cAAQ,KAAK;AAAA,QACX,uBAAuB;AAAA,QACvB;AAAA,MACF,CAAC;AAAA,IACH;AAAA,EACF;AAEA,SAAO;AACT;AAKA,eAAe,yBAAiD;AAC9D,QAAM,UAAyB,CAAC;AAChC,QAAM,SAAS,cAAc;AAE7B,MAAI,CAAC,OAAO,QAAQ;AAElB,WAAO;AAAA,EACT;AAEA,QAAM,SAAS,gBAAgB;AAAA,IAC7B,QAAQ,OAAO;AAAA,IACf,QAAQ,OAAO;AAAA,IACf,OAAO,OAAO;AAAA,EAChB,CAAC;AAGD,MAAI,OAAO,WAAW;AACpB,QAAI;AACF,YAAM,OAAO,KAAK,eAAe,EAAE,WAAW,OAAO,UAAU,CAAC;AAChE,cAAQ,KAAK;AAAA,QACX,oBAAoB;AAAA,QACpB,OAAO;AAAA,MACT,CAAC;AAAA,IACH,SAAS,OAAO;AACd,YAAM,UAAU,iBAAiB,QAAQ,MAAM,UAAU;AACzD,cAAQ,KAAK;AAAA,QACX,oBAAoB;AAAA,QACpB,kBAAkB,OAAO;AAAA,QACzB,gBAAgB;AAAA,MAClB,CAAC;AAAA,IACH;AAAA,EACF,OAAO;AACL,YAAQ,KAAK;AAAA,MACX,oBAAoB;AAAA,MACpB;AAAA,MACA,gBAAgB;AAAA,IAClB,CAAC;AAAA,EACH;AAGA,MAAI,OAAO,iBAAiB;AAC1B,QAAI;AACF,YAAM,OAAO,KAAK,qBAAqB,EAAE,iBAAiB,OAAO,gBAAgB,CAAC;AAClF,cAAQ,KAAK;AAAA,QACX,oBAAoB;AAAA,QACpB,OAAO;AAAA,MACT,CAAC;AAAA,IACH,SAAS,OAAO;AACd,YAAM,UAAU,iBAAiB,QAAQ,MAAM,UAAU;AACzD,cAAQ,KAAK;AAAA,QACX,oBAAoB;AAAA,QACpB,kBAAkB,OAAO;AAAA,QACzB,gBAAgB;AAAA,MAClB,CAAC;AAAA,IACH;AAAA,EACF,OAAO;AACL,YAAQ,KAAK;AAAA,MACX,oBAAoB;AAAA,MACpB;AAAA,IACF,CAAC;AAAA,EACH;AAMA,SAAO;AACT;AAKA,SAAS,cAAc,QAA4B;AACjD,aAAW;AACX,cAAY,4BAA4B;AACxC,aAAW;AAEX,aAAW,YAAY,kBAAkB;AACvC,UAAM,SAAS,OAAO,OAAO,SAAS,EAAE;AACxC,QAAI,OAAO,WAAW,EAAG;AAEzB,YAAQ,IAAI,OAAO,KAAK,SAAS,IAAI,CAAC;AAEtC,eAAW,SAAS,QAAQ;AAC1B,YAAM,OAAO,MAAM,WAAW,SAC1B,OAAO,QAAQ,cAAc,MAAM,CAAC,IACpC,MAAM,WAAW,SACf,OAAO,QAAQ,cAAc,MAAM,CAAC,IACpC,OAAO,MAAM,cAAc,MAAM,CAAC;AAExC,cAAQ,IAAI,KAAK,IAAI,IAAI,MAAM,IAAI,KAAK,MAAM,OAAO,EAAE;AAEvD,UAAI,MAAM,OAAO,MAAM,WAAW,QAAQ;AACxC,gBAAQ,IAAI,OAAO,MAAM,cAAS,MAAM,GAAG,EAAE,CAAC;AAAA,MAChD;AAAA,IACF;AAEA,eAAW;AAAA,EACb;AAGA,QAAM,EAAE,QAAQ,QAAQ,UAAU,MAAM,IAAI,OAAO;AAEnD,MAAI,WAAW,KAAK,aAAa,GAAG;AAClC,YAAQ,IAAI,OAAO,QAAQ,OAAO,KAAK,iBAAiB,CAAC;AAAA,EAC3D,WAAW,WAAW,GAAG;AACvB,YAAQ;AAAA,MACN,OAAO,QAAQ,oBAAoB,IACnC,OAAO,QAAQ,KAAK,QAAQ,WAAW,WAAW,IAAI,MAAM,EAAE,GAAG;AAAA,IACnE;AAAA,EACF,OAAO;AACL,UAAM,UAAU,GAAG,MAAM,SAAS,SAAS,IAAI,MAAM,EAAE;AACvD,UAAM,UAAU,WAAW,IACvB,KAAK,QAAQ,WAAW,WAAW,IAAI,MAAM,EAAE,KAC/C;AACJ,YAAQ,IAAI,OAAO,MAAM,OAAO,IAAI,OAAO,QAAQ,OAAO,CAAC;AAAA,EAC7D;AAEA,aAAW;AACb;AAKA,eAAsB,aAAa,SAAuC;AACxE,QAAM,SAAS,cAAc;AAE7B,MAAI,eAA8B,CAAC;AACnC,MAAI,aAA4B,CAAC;AACjC,MAAI,mBAAkC,CAAC;AACvC,MAAI,gBAA+B,CAAC;AAEpC,MAAI,QAAQ,MAAM;AAChB,mBAAe,uBAAuB;AACtC,iBAAa,MAAM,wBAAwB,OAAO,MAAM;AACxD,uBAAmB,MAAM,oBAAoB,OAAO,MAAM;AAC1D,oBAAgB,MAAM,uBAAuB;AAAA,EAC/C,OAAO;AACL,UAAM,cAAc,uBAAuB;AAAA,MACzC;AAAA,QACE,OAAO;AAAA,QACP,IAAI,YAAY;AAAE,yBAAe,uBAAuB;AAAA,QAAG;AAAA,MAC7D;AAAA,MACA;AAAA,QACE,OAAO;AAAA,QACP,IAAI,YAAY;AAAE,uBAAa,MAAM,wBAAwB,OAAO,MAAM;AAAA,QAAG;AAAA,MAC/E;AAAA,MACA;AAAA,QACE,OAAO;AAAA,QACP,IAAI,YAAY;AAAE,6BAAmB,MAAM,oBAAoB,OAAO,MAAM;AAAA,QAAG;AAAA,MACjF;AAAA,MACA;AAAA,QACE,OAAO;AAAA,QACP,IAAI,YAAY;AAAE,0BAAgB,MAAM,uBAAuB;AAAA,QAAG;AAAA,MACpE;AAAA,IACF,CAAC;AAAA,EACH;AAGA,QAAM,SAA+C;AAAA,IACnD,eAAe;AAAA,IACf,gBAAgB;AAAA,IAChB,YAAY;AAAA,IACZ,eAAe;AAAA,EACjB;AAEA,QAAM,SAAuB;AAAA,IAC3B;AAAA,IACA,SAAS,iBAAiB,MAAM;AAAA,IAChC,YAAW,oBAAI,KAAK,GAAE,YAAY;AAAA,EACpC;AAGA,MAAI,QAAQ,MAAM;AAChB,YAAQ,IAAI,KAAK,UAAU,QAAQ,MAAM,CAAC,CAAC;AAAA,EAC7C,OAAO;AACL,kBAAc,MAAM;AAAA,EACtB;AAGA,MAAI,YAAY,MAAM,GAAG;AACvB,YAAQ,KAAK,CAAC;AAAA,EAChB;AACF;AAKO,SAAS,sBAAsB,SAAwB;AAC5D,UACG,QAAQ,QAAQ,EAChB,YAAY,8CAA8C,EAC1D,OAAO,UAAU,8BAA8B,EAC/C,OAAO,SAAS,8CAA8C,EAC9D,YAAY,SAAS;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,CAczB,EACI,OAAO,iBAAiB,YAAY,CAAC;AAC1C;","names":[]}