@specforge/cli 0.1.0

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/cli/commands/debug/call.ts"],"sourcesContent":["/**\n * Call Command Implementation\n *\n * Allows directly calling MCP tools with JSON arguments, useful for testing\n * and debugging.\n */\n\nimport chalk from 'chalk';\nimport ora from 'ora';\nimport { resolveConfig } from '../../config/index.js';\nimport { colors } from '../../ui/colors.js';\nimport { ApiClient } from '../../../client/api-client.js';\nimport { handleToolCall } from '../../../tools/index.js';\nimport type { CallOptions } from './types.js';\n\n/**\n * Parse JSON arguments safely\n */\nfunction parseArgs(argsString: string | undefined): Record<string, unknown> {\n  if (!argsString) {\n    return {};\n  }\n\n  try {\n    return JSON.parse(argsString);\n  } catch (error) {\n    throw new Error(\n      `Invalid JSON in --args. Example: --args='{\"ticketId\": \"abc123\"}'`\n    );\n  }\n}\n\n/**\n * Format response as TOON\n */\nfunction formatToon(response: unknown): string {\n  if (typeof response === 'object' && response !== null) {\n    const lines: string[] = ['@response'];\n    const entries = Object.entries(response);\n    for (const [key, value] of entries) {\n      if (typeof value === 'object' && value !== null) {\n        lines.push(`  ${key}: ${JSON.stringify(value)}`);\n      } else {\n        lines.push(`  ${key}: ${value}`);\n      }\n    }\n    return lines.join('\\n');\n  }\n  return String(response);\n}\n\n/**\n * Format output based on options\n */\nfunction formatOutput(response: unknown, options: CallOptions): string {\n  if (options.raw) {\n    return typeof response === 'string' ? response : JSON.stringify(response);\n  }\n\n  if (options.format === 'toon') {\n    return formatToon(response);\n  }\n\n  // Default to formatted JSON\n  return JSON.stringify(response, null, 2);\n}\n\n/**\n * Call command implementation\n *\n * Directly calls an MCP tool with optional JSON arguments.\n */\nexport async function callCommand(tool: string, options: CallOptions): Promise<void> {\n  // Validate tool name\n  if (!tool) {\n    console.error(colors.error('\\nError: Tool name is required.'));\n    console.error(\"Usage: specforge call <tool> --args='{\\\"key\\\": \\\"value\\\"}'\");\n    process.exit(1);\n  }\n\n  const config = resolveConfig();\n\n  // Parse arguments\n  let args: Record<string, unknown>;\n  try {\n    args = parseArgs(options.args);\n  } catch (error) {\n    const message = error instanceof Error ? error.message : 'Invalid JSON';\n    console.error(colors.error(`\\nError: ${message}`));\n    process.exit(1);\n  }\n\n  const spinner = ora(`Calling ${tool}...`).start();\n\n  try {\n    if (!config.apiKey) {\n      spinner.fail('Not authenticated');\n      console.error(colors.error('\\nError: Not authenticated.'));\n      console.error(colors.muted('Run `specforge login` to authenticate first.'));\n      process.exit(1);\n    }\n\n    const client = new ApiClient({\n      apiKey: config.apiKey,\n      apiUrl: config.apiUrl,\n      debug: config.debug,\n    });\n\n    // Use handleToolCall to route through MCP tool dispatcher\n    // This handles local tools (workflow_guide, feedback, blueprint) properly\n    // while forwarding backend tools to the API\n    const response = await handleToolCall(client, tool, args, config.debug);\n\n    spinner.stop();\n\n    // Format and display output\n    const output = formatOutput(response, options);\n    console.log(output);\n  } catch (error) {\n    spinner.fail(`Failed to call ${tool}`);\n    const message = error instanceof Error ? error.message : 'Unknown error';\n\n    // Provide helpful error messages\n    if (message.includes('Unknown tool') || message.includes('not found')) {\n      console.error(colors.error(`\\nError: Unknown tool \"${tool}\".`));\n      console.error(colors.muted(\"Run 'specforge tools' to see available tools.\"));\n    } else if (message.includes('required')) {\n      console.error(colors.error(`\\nError: ${message}`));\n      console.error(colors.muted('Check the tool requires specific arguments.'));\n    } else {\n      console.error(colors.error(`\\nError: ${message}`));\n    }\n\n    process.exit(1);\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/cli/commands/debug/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Debug Command Module
+ *
+ * Exports all debug command types and utilities.
+ */
+export * from './types.js';
+export { callCommand } from './call.js';
+export { toolsCommand } from './tools.js';
+export { testCommand } from './test.js';
+export { whoamiCommand } from './whoami.js';
+export { registerDebugCommands } from './register.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/commands/debug/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/debug/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC"}

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

@@ -0,0 +1,14 @@
+export * from "./types.js";
+import { callCommand } from "./call.js";
+import { toolsCommand } from "./tools.js";
+import { testCommand } from "./test.js";
+import { whoamiCommand } from "./whoami.js";
+import { registerDebugCommands } from "./register.js";
+export {
+  callCommand,
+  registerDebugCommands,
+  testCommand,
+  toolsCommand,
+  whoamiCommand
+};
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/cli/commands/debug/index.ts"],"sourcesContent":["/**\n * Debug Command Module\n *\n * Exports all debug command types and utilities.\n */\n\nexport * from './types.js';\nexport { callCommand } from './call.js';\nexport { toolsCommand } from './tools.js';\nexport { testCommand } from './test.js';\nexport { whoamiCommand } from './whoami.js';\nexport { registerDebugCommands } from './register.js';\n"],"mappings":"AAMA,cAAc;AACd,SAAS,mBAAmB;AAC5B,SAAS,oBAAoB;AAC7B,SAAS,mBAAmB;AAC5B,SAAS,qBAAqB;AAC9B,SAAS,6BAA6B;","names":[]}

package/dist/cli/commands/debug/register.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Debug Command Registration
+ *
+ * Registers all debug commands with the CLI framework.
+ */
+import { Command } from 'commander';
+/**
+ * Register all debug commands with the CLI
+ */
+export declare function registerDebugCommands(program: Command): void;
+//# sourceMappingURL=register.d.ts.map

package/dist/cli/commands/debug/register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/debug/register.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQpC;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAkG5D"}

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

@@ -0,0 +1,78 @@
+import { withErrorHandler } from "../../middleware/error-handler.js";
+import { callCommand } from "./call.js";
+import { toolsCommand } from "./tools.js";
+import { testCommand } from "./test.js";
+import { whoamiCommand } from "./whoami.js";
+function registerDebugCommands(program) {
+  program.command("call <tool>").description("Directly call an MCP tool").option("--args <json>", "Tool arguments as JSON").option("--format <format>", "Output format (json, toon)", "json").option("--raw", "Show raw API response").addHelpText(
+    "after",
+    `
+Examples:
+  $ specforge call list_projects
+  $ specforge call get_ticket --args='{"ticketId":"abc123"}'
+  $ specforge call list_tickets --format toon
+  $ specforge call get_specification --args='{"specificationId":"spec-1"}' --raw
+
+The call command allows you to directly invoke MCP tools with JSON arguments.
+This is useful for testing, debugging, and scripting. Output can be formatted
+as JSON (default), TOON, or raw API response.
+`
+  ).action(
+    withErrorHandler(async (tool, options) => {
+      await callCommand(tool, options);
+    })
+  );
+  program.command("tools").description("List available MCP tools").option("--category <category>", "Filter by category").option("--search <query>", "Search tool names/descriptions").option("--json", "Output as JSON").addHelpText(
+    "after",
+    `
+Examples:
+  $ specforge tools
+  $ specforge tools --category context
+  $ specforge tools --search ticket
+  $ specforge tools --json
+
+The tools command lists all available MCP tools grouped by category.
+Use filters to narrow down the list. This command doesn't require
+authentication since it lists locally defined tools.
+`
+  ).action(
+    withErrorHandler(async (options) => {
+      await toolsCommand(options);
+    })
+  );
+  program.command("test").description("Test API connection and authentication").addHelpText(
+    "after",
+    `
+Examples:
+  $ specforge test
+
+The test command verifies your API connection and authentication.
+It displays response time, user information, and accessible projects.
+Helpful error messages are provided for common connection issues.
+`
+  ).action(
+    withErrorHandler(async () => {
+      await testCommand();
+    })
+  );
+  program.command("whoami").description("Show current user and configuration").option("--json", "Output as JSON").addHelpText(
+    "after",
+    `
+Examples:
+  $ specforge whoami
+  $ specforge whoami --json
+
+The whoami command displays your current user information, configuration
+settings, and config file paths. Useful for debugging authentication and
+configuration issues.
+`
+  ).action(
+    withErrorHandler(async (options) => {
+      await whoamiCommand(options);
+    })
+  );
+}
+export {
+  registerDebugCommands
+};
+//# sourceMappingURL=register.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/cli/commands/debug/register.ts"],"sourcesContent":["/**\n * Debug Command Registration\n *\n * Registers all debug commands with the CLI framework.\n */\n\nimport { Command } from 'commander';\nimport { withErrorHandler } from '../../middleware/error-handler.js';\nimport { callCommand } from './call.js';\nimport { toolsCommand } from './tools.js';\nimport { testCommand } from './test.js';\nimport { whoamiCommand } from './whoami.js';\nimport type { CallOptions, ToolsOptions, WhoamiOptions } from './types.js';\n\n/**\n * Register all debug commands with the CLI\n */\nexport function registerDebugCommands(program: Command): void {\n  // Call command - directly call MCP tools\n  program\n    .command('call <tool>')\n    .description('Directly call an MCP tool')\n    .option('--args <json>', 'Tool arguments as JSON')\n    .option('--format <format>', 'Output format (json, toon)', 'json')\n    .option('--raw', 'Show raw API response')\n    .addHelpText(\n      'after',\n      `\nExamples:\n  $ specforge call list_projects\n  $ specforge call get_ticket --args='{\"ticketId\":\"abc123\"}'\n  $ specforge call list_tickets --format toon\n  $ specforge call get_specification --args='{\"specificationId\":\"spec-1\"}' --raw\n\nThe call command allows you to directly invoke MCP tools with JSON arguments.\nThis is useful for testing, debugging, and scripting. Output can be formatted\nas JSON (default), TOON, or raw API response.\n`\n    )\n    .action(\n      withErrorHandler(async (tool: string, options: CallOptions) => {\n        await callCommand(tool, options);\n      })\n    );\n\n  // Tools command - list available MCP tools\n  program\n    .command('tools')\n    .description('List available MCP tools')\n    .option('--category <category>', 'Filter by category')\n    .option('--search <query>', 'Search tool names/descriptions')\n    .option('--json', 'Output as JSON')\n    .addHelpText(\n      'after',\n      `\nExamples:\n  $ specforge tools\n  $ specforge tools --category context\n  $ specforge tools --search ticket\n  $ specforge tools --json\n\nThe tools command lists all available MCP tools grouped by category.\nUse filters to narrow down the list. This command doesn't require\nauthentication since it lists locally defined tools.\n`\n    )\n    .action(\n      withErrorHandler(async (options: ToolsOptions) => {\n        await toolsCommand(options);\n      })\n    );\n\n  // Test command - test API connection\n  program\n    .command('test')\n    .description('Test API connection and authentication')\n    .addHelpText(\n      'after',\n      `\nExamples:\n  $ specforge test\n\nThe test command verifies your API connection and authentication.\nIt displays response time, user information, and accessible projects.\nHelpful error messages are provided for common connection issues.\n`\n    )\n    .action(\n      withErrorHandler(async () => {\n        await testCommand();\n      })\n    );\n\n  // Whoami command - show current user and config\n  program\n    .command('whoami')\n    .description('Show current user and configuration')\n    .option('--json', 'Output as JSON')\n    .addHelpText(\n      'after',\n      `\nExamples:\n  $ specforge whoami\n  $ specforge whoami --json\n\nThe whoami command displays your current user information, configuration\nsettings, and config file paths. Useful for debugging authentication and\nconfiguration issues.\n`\n    )\n    .action(\n      withErrorHandler(async (options: WhoamiOptions) => {\n        await whoamiCommand(options);\n      })\n    );\n}\n"],"mappings":"AAOA,SAAS,wBAAwB;AACjC,SAAS,mBAAmB;AAC5B,SAAS,oBAAoB;AAC7B,SAAS,mBAAmB;AAC5B,SAAS,qBAAqB;AAMvB,SAAS,sBAAsB,SAAwB;AAE5D,UACG,QAAQ,aAAa,EACrB,YAAY,2BAA2B,EACvC,OAAO,iBAAiB,wBAAwB,EAChD,OAAO,qBAAqB,8BAA8B,MAAM,EAChE,OAAO,SAAS,uBAAuB,EACvC;AAAA,IACC;AAAA,IACA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWF,EACC;AAAA,IACC,iBAAiB,OAAO,MAAc,YAAyB;AAC7D,YAAM,YAAY,MAAM,OAAO;AAAA,IACjC,CAAC;AAAA,EACH;AAGF,UACG,QAAQ,OAAO,EACf,YAAY,0BAA0B,EACtC,OAAO,yBAAyB,oBAAoB,EACpD,OAAO,oBAAoB,gCAAgC,EAC3D,OAAO,UAAU,gBAAgB,EACjC;AAAA,IACC;AAAA,IACA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWF,EACC;AAAA,IACC,iBAAiB,OAAO,YAA0B;AAChD,YAAM,aAAa,OAAO;AAAA,IAC5B,CAAC;AAAA,EACH;AAGF,UACG,QAAQ,MAAM,EACd,YAAY,wCAAwC,EACpD;AAAA,IACC;AAAA,IACA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQF,EACC;AAAA,IACC,iBAAiB,YAAY;AAC3B,YAAM,YAAY;AAAA,IACpB,CAAC;AAAA,EACH;AAGF,UACG,QAAQ,QAAQ,EAChB,YAAY,qCAAqC,EACjD,OAAO,UAAU,gBAAgB,EACjC;AAAA,IACC;AAAA,IACA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASF,EACC;AAAA,IACC,iBAAiB,OAAO,YAA2B;AACjD,YAAM,cAAc,OAAO;AAAA,IAC7B,CAAC;AAAA,EACH;AACJ;","names":[]}

package/dist/cli/commands/debug/test.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Test Command Implementation
+ *
+ * Tests the API connection and authentication, displaying connection status,
+ * response time, and user information.
+ */
+/**
+ * Test command implementation
+ *
+ * Tests the API connection and authentication.
+ */
+export declare function testCommand(): Promise<void>;
+//# sourceMappingURL=test.d.ts.map

package/dist/cli/commands/debug/test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/debug/test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA+EH;;;;GAIG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CA6CjD"}

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

@@ -0,0 +1,91 @@
+import chalk from "chalk";
+import ora from "ora";
+import { resolveConfig } 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 displayTestHeader(apiUrl, apiKey) {
+  console.log(chalk.bold("\nTesting SpecForge API connection..."));
+  console.log();
+  console.log(`Endpoint: ${chalk.cyan(apiUrl)}`);
+  console.log(`API Key:  ${chalk.cyan(maskApiKey(apiKey))} (valid format)`);
+  console.log();
+}
+function displaySuccess(result) {
+  console.log(chalk.green(`\u2713 Connection successful (${result.responseTime}ms)`));
+  console.log(chalk.green("\u2713 Authentication valid"));
+  if (result.userEmail) {
+    console.log(chalk.green(`\u2713 User: ${result.userEmail}`));
+  }
+  if (result.projectCount !== void 0) {
+    console.log(chalk.green(`\u2713 Projects accessible: ${result.projectCount}`));
+  }
+  console.log();
+}
+function displayFailure(error) {
+  if (error.includes("401") || error.includes("Unauthorized")) {
+    console.log(chalk.red("\u2717 Authentication failed: Invalid API key"));
+    console.log(chalk.dim("\nCheck your API key:"));
+    console.log(chalk.dim('  - Run "specforge login" to authenticate'));
+    console.log(chalk.dim("  - Or set SPECFORGE_API_KEY environment variable"));
+  } else if (error.includes("ENOTFOUND") || error.includes("ECONNREFUSED")) {
+    console.log(chalk.red("\u2717 Connection failed: Could not reach API"));
+    console.log(chalk.dim("\nCheck your network connection:"));
+    console.log(chalk.dim("  - Verify internet connectivity"));
+    console.log(chalk.dim("  - Check if API URL is correct"));
+  } else if (error.includes("timeout") || error.includes("ETIMEDOUT")) {
+    console.log(chalk.red("\u2717 Connection timeout"));
+    console.log(chalk.dim("\nThe API took too long to respond:"));
+    console.log(chalk.dim("  - Check your network speed"));
+    console.log(chalk.dim("  - Try again later"));
+  } else if (error.includes("certificate") || error.includes("SSL")) {
+    console.log(chalk.red("\u2717 SSL/TLS error"));
+    console.log(chalk.dim("\nThere was a certificate issue:"));
+    console.log(chalk.dim("  - Check your system time is correct"));
+    console.log(chalk.dim("  - Your network may be blocking secure connections"));
+  } else {
+    console.log(chalk.red(`\u2717 Error: ${error}`));
+  }
+  console.log();
+}
+async function testCommand() {
+  const config = resolveConfig();
+  const apiUrl = process.env.SPECFORGE_API_URL || CHANNEL.endpoint.primary;
+  displayTestHeader(apiUrl, config.apiKey);
+  const spinner = ora("Testing connection...").start();
+  try {
+    const startTime = Date.now();
+    const client = createCliClient({
+      apiKey: config.apiKey,
+      apiUrl,
+      debug: config.debug
+    });
+    const userResponse = await client.call("get_current_user", {});
+    const userEmail = userResponse.email || "Unknown";
+    const response = await client.call("list_projects", {});
+    const elapsed = Date.now() - startTime;
+    spinner.stop();
+    const projects = response.projects || [];
+    const result = {
+      success: true,
+      responseTime: elapsed,
+      userEmail,
+      projectCount: projects.length
+    };
+    displaySuccess(result);
+  } catch (error) {
+    spinner.stop();
+    const message = error instanceof Error ? error.message : "Unknown error";
+    displayFailure(message);
+    process.exit(1);
+  }
+}
+export {
+  testCommand
+};
+//# sourceMappingURL=test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/cli/commands/debug/test.ts"],"sourcesContent":["/**\n * Test Command Implementation\n *\n * Tests the API connection and authentication, displaying connection status,\n * response time, and user information.\n */\n\nimport chalk from 'chalk';\nimport ora from 'ora';\nimport { resolveConfig } from '../../config/index.js';\nimport { createCliClient } from '../../../client/cli-client.js';\nimport { CHANNEL } from '../../../channel.js';\nimport type { TestResult } 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 * Display test header with configuration\n */\nfunction displayTestHeader(apiUrl: string, apiKey: string): void {\n  console.log(chalk.bold('\\nTesting SpecForge API connection...'));\n  console.log();\n  console.log(`Endpoint: ${chalk.cyan(apiUrl)}`);\n  console.log(`API Key:  ${chalk.cyan(maskApiKey(apiKey))} (valid format)`);\n  console.log();\n}\n\n/**\n * Display successful test results\n */\nfunction displaySuccess(result: TestResult): void {\n  console.log(chalk.green(`✓ Connection successful (${result.responseTime}ms)`));\n  console.log(chalk.green('✓ Authentication valid'));\n\n  if (result.userEmail) {\n    console.log(chalk.green(`✓ User: ${result.userEmail}`));\n  }\n\n  if (result.projectCount !== undefined) {\n    console.log(chalk.green(`✓ Projects accessible: ${result.projectCount}`));\n  }\n\n  console.log();\n}\n\n/**\n * Display connection failure\n */\nfunction displayFailure(error: string): void {\n  if (error.includes('401') || error.includes('Unauthorized')) {\n    console.log(chalk.red('✗ Authentication failed: Invalid API key'));\n    console.log(chalk.dim('\\nCheck your API key:'));\n    console.log(chalk.dim('  - Run \"specforge login\" to authenticate'));\n    console.log(chalk.dim('  - Or set SPECFORGE_API_KEY environment variable'));\n  } else if (error.includes('ENOTFOUND') || error.includes('ECONNREFUSED')) {\n    console.log(chalk.red('✗ Connection failed: Could not reach API'));\n    console.log(chalk.dim('\\nCheck your network connection:'));\n    console.log(chalk.dim('  - Verify internet connectivity'));\n    console.log(chalk.dim('  - Check if API URL is correct'));\n  } else if (error.includes('timeout') || error.includes('ETIMEDOUT')) {\n    console.log(chalk.red('✗ Connection timeout'));\n    console.log(chalk.dim('\\nThe API took too long to respond:'));\n    console.log(chalk.dim('  - Check your network speed'));\n    console.log(chalk.dim('  - Try again later'));\n  } else if (error.includes('certificate') || error.includes('SSL')) {\n    console.log(chalk.red('✗ SSL/TLS error'));\n    console.log(chalk.dim('\\nThere was a certificate issue:'));\n    console.log(chalk.dim('  - Check your system time is correct'));\n    console.log(chalk.dim('  - Your network may be blocking secure connections'));\n  } else {\n    console.log(chalk.red(`✗ Error: ${error}`));\n  }\n\n  console.log();\n}\n\n/**\n * Test command implementation\n *\n * Tests the API connection and authentication.\n */\nexport async function testCommand(): Promise<void> {\n  const config = resolveConfig();\n  const apiUrl = process.env.SPECFORGE_API_URL || CHANNEL.endpoint.primary;\n\n  // Display header\n  displayTestHeader(apiUrl, config.apiKey!);\n\n  const spinner = ora('Testing connection...').start();\n\n  try {\n    const startTime = Date.now();\n\n    const client = createCliClient({\n      apiKey: config.apiKey!,\n      apiUrl,\n      debug: config.debug,\n    });\n\n    // Get user info first\n    const userResponse = await client.call('get_current_user', {}) as { email?: string };\n    const userEmail = userResponse.email || 'Unknown';\n\n    // Test with list_projects\n    const response = await client.call('list_projects', {});\n    const elapsed = Date.now() - startTime;\n\n    spinner.stop();\n\n    const projects = (response as { projects?: unknown[] }).projects || [];\n\n    const result: TestResult = {\n      success: true,\n      responseTime: elapsed,\n      userEmail,\n      projectCount: projects.length,\n    };\n\n    displaySuccess(result);\n\n  } catch (error) {\n    spinner.stop();\n    const message = error instanceof Error ? error.message : 'Unknown error';\n    displayFailure(message);\n    process.exit(1);\n  }\n}\n"],"mappings":"AAOA,OAAO,WAAW;AAClB,OAAO,SAAS;AAChB,SAAS,qBAAqB;AAC9B,SAAS,uBAAuB;AAChC,SAAS,eAAe;AAMxB,SAAS,WAAW,QAAwB;AAC1C,MAAI,OAAO,SAAS,IAAI;AACtB,WAAO;AAAA,EACT;AACA,SAAO,GAAG,OAAO,MAAM,GAAG,CAAC,CAAC,MAAM,OAAO,MAAM,EAAE,CAAC;AACpD;AAKA,SAAS,kBAAkB,QAAgB,QAAsB;AAC/D,UAAQ,IAAI,MAAM,KAAK,uCAAuC,CAAC;AAC/D,UAAQ,IAAI;AACZ,UAAQ,IAAI,aAAa,MAAM,KAAK,MAAM,CAAC,EAAE;AAC7C,UAAQ,IAAI,aAAa,MAAM,KAAK,WAAW,MAAM,CAAC,CAAC,iBAAiB;AACxE,UAAQ,IAAI;AACd;AAKA,SAAS,eAAe,QAA0B;AAChD,UAAQ,IAAI,MAAM,MAAM,iCAA4B,OAAO,YAAY,KAAK,CAAC;AAC7E,UAAQ,IAAI,MAAM,MAAM,6BAAwB,CAAC;AAEjD,MAAI,OAAO,WAAW;AACpB,YAAQ,IAAI,MAAM,MAAM,gBAAW,OAAO,SAAS,EAAE,CAAC;AAAA,EACxD;AAEA,MAAI,OAAO,iBAAiB,QAAW;AACrC,YAAQ,IAAI,MAAM,MAAM,+BAA0B,OAAO,YAAY,EAAE,CAAC;AAAA,EAC1E;AAEA,UAAQ,IAAI;AACd;AAKA,SAAS,eAAe,OAAqB;AAC3C,MAAI,MAAM,SAAS,KAAK,KAAK,MAAM,SAAS,cAAc,GAAG;AAC3D,YAAQ,IAAI,MAAM,IAAI,+CAA0C,CAAC;AACjE,YAAQ,IAAI,MAAM,IAAI,uBAAuB,CAAC;AAC9C,YAAQ,IAAI,MAAM,IAAI,2CAA2C,CAAC;AAClE,YAAQ,IAAI,MAAM,IAAI,mDAAmD,CAAC;AAAA,EAC5E,WAAW,MAAM,SAAS,WAAW,KAAK,MAAM,SAAS,cAAc,GAAG;AACxE,YAAQ,IAAI,MAAM,IAAI,+CAA0C,CAAC;AACjE,YAAQ,IAAI,MAAM,IAAI,kCAAkC,CAAC;AACzD,YAAQ,IAAI,MAAM,IAAI,kCAAkC,CAAC;AACzD,YAAQ,IAAI,MAAM,IAAI,iCAAiC,CAAC;AAAA,EAC1D,WAAW,MAAM,SAAS,SAAS,KAAK,MAAM,SAAS,WAAW,GAAG;AACnE,YAAQ,IAAI,MAAM,IAAI,2BAAsB,CAAC;AAC7C,YAAQ,IAAI,MAAM,IAAI,qCAAqC,CAAC;AAC5D,YAAQ,IAAI,MAAM,IAAI,8BAA8B,CAAC;AACrD,YAAQ,IAAI,MAAM,IAAI,qBAAqB,CAAC;AAAA,EAC9C,WAAW,MAAM,SAAS,aAAa,KAAK,MAAM,SAAS,KAAK,GAAG;AACjE,YAAQ,IAAI,MAAM,IAAI,sBAAiB,CAAC;AACxC,YAAQ,IAAI,MAAM,IAAI,kCAAkC,CAAC;AACzD,YAAQ,IAAI,MAAM,IAAI,uCAAuC,CAAC;AAC9D,YAAQ,IAAI,MAAM,IAAI,qDAAqD,CAAC;AAAA,EAC9E,OAAO;AACL,YAAQ,IAAI,MAAM,IAAI,iBAAY,KAAK,EAAE,CAAC;AAAA,EAC5C;AAEA,UAAQ,IAAI;AACd;AAOA,eAAsB,cAA6B;AACjD,QAAM,SAAS,cAAc;AAC7B,QAAM,SAAS,QAAQ,IAAI,qBAAqB,QAAQ,SAAS;AAGjE,oBAAkB,QAAQ,OAAO,MAAO;AAExC,QAAM,UAAU,IAAI,uBAAuB,EAAE,MAAM;AAEnD,MAAI;AACF,UAAM,YAAY,KAAK,IAAI;AAE3B,UAAM,SAAS,gBAAgB;AAAA,MAC7B,QAAQ,OAAO;AAAA,MACf;AAAA,MACA,OAAO,OAAO;AAAA,IAChB,CAAC;AAGD,UAAM,eAAe,MAAM,OAAO,KAAK,oBAAoB,CAAC,CAAC;AAC7D,UAAM,YAAY,aAAa,SAAS;AAGxC,UAAM,WAAW,MAAM,OAAO,KAAK,iBAAiB,CAAC,CAAC;AACtD,UAAM,UAAU,KAAK,IAAI,IAAI;AAE7B,YAAQ,KAAK;AAEb,UAAM,WAAY,SAAsC,YAAY,CAAC;AAErE,UAAM,SAAqB;AAAA,MACzB,SAAS;AAAA,MACT,cAAc;AAAA,MACd;AAAA,MACA,cAAc,SAAS;AAAA,IACzB;AAEA,mBAAe,MAAM;AAAA,EAEvB,SAAS,OAAO;AACd,YAAQ,KAAK;AACb,UAAM,UAAU,iBAAiB,QAAQ,MAAM,UAAU;AACzD,mBAAe,OAAO;AACtB,YAAQ,KAAK,CAAC;AAAA,EAChB;AACF;","names":[]}

package/dist/cli/commands/debug/tools.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Tools Command Implementation
+ *
+ * Lists all available MCP tools with filtering and search capabilities.
+ */
+import type { ToolsOptions } from './types.js';
+/**
+ * Tools command implementation
+ *
+ * Lists all available MCP tools with filtering and search.
+ */
+export declare function toolsCommand(options: ToolsOptions): Promise<void>;
+//# sourceMappingURL=tools.d.ts.map

package/dist/cli/commands/debug/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/debug/tools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAY,MAAM,YAAY,CAAC;AAkGzD;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAsCvE"}

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

@@ -0,0 +1,86 @@
+import chalk from "chalk";
+import { getTools } from "../../../tools/index.js";
+import { TOOL_CATEGORIES as categories } from "./types.js";
+function getToolCategory(toolName) {
+  for (const [category, toolNames] of Object.entries(categories)) {
+    if (toolNames.includes(toolName)) {
+      return category;
+    }
+  }
+  return "Other";
+}
+function buildToolList() {
+  const tools = getTools();
+  return tools.map((tool) => ({
+    name: tool.name,
+    description: tool.description || "",
+    category: getToolCategory(tool.name)
+  }));
+}
+function filterByCategory(toolList, category) {
+  return toolList.filter(
+    (t) => t.category.toLowerCase().includes(category.toLowerCase())
+  );
+}
+function filterBySearch(toolList, search) {
+  const searchLower = search.toLowerCase();
+  return toolList.filter(
+    (t) => t.name.toLowerCase().includes(searchLower) || t.description.toLowerCase().includes(searchLower)
+  );
+}
+function groupByCategory(toolList) {
+  const grouped = {};
+  for (const tool of toolList) {
+    if (!grouped[tool.category]) {
+      grouped[tool.category] = [];
+    }
+    grouped[tool.category].push(tool);
+  }
+  return grouped;
+}
+function displayTools(byCategory, total) {
+  console.log(chalk.bold("\nAvailable MCP Tools"));
+  console.log("\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n");
+  const sortedCategories = Object.keys(byCategory).sort();
+  for (const category of sortedCategories) {
+    const categoryTools = byCategory[category];
+    console.log(chalk.bold(category));
+    for (const tool of categoryTools) {
+      const desc = tool.description.length > 50 ? tool.description.slice(0, 47) + "..." : tool.description;
+      console.log(`  ${chalk.cyan(tool.name.padEnd(30))} ${chalk.dim(desc)}`);
+    }
+    console.log();
+  }
+  console.log(chalk.dim(`(${total} tools total)
+`));
+}
+async function toolsCommand(options) {
+  let toolList = buildToolList();
+  if (options.category) {
+    toolList = filterByCategory(toolList, options.category);
+  }
+  if (options.search) {
+    toolList = filterBySearch(toolList, options.search);
+  }
+  if (options.json) {
+    console.log(JSON.stringify({ tools: toolList }, null, 2));
+    return;
+  }
+  if (toolList.length === 0) {
+    console.log(chalk.yellow("\nNo tools found matching your filters."));
+    if (options.category) {
+      console.log(chalk.dim(`Category filter: "${options.category}"`));
+    }
+    if (options.search) {
+      console.log(chalk.dim(`Search filter: "${options.search}"`));
+    }
+    console.log(chalk.dim('\nRun "specforge tools" without filters to see all tools.'));
+    return;
+  }
+  const byCategory = groupByCategory(toolList);
+  displayTools(byCategory, toolList.length);
+}
+export {
+  toolsCommand
+};
+//# sourceMappingURL=tools.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/cli/commands/debug/tools.ts"],"sourcesContent":["/**\n * Tools Command Implementation\n *\n * Lists all available MCP tools with filtering and search capabilities.\n */\n\nimport chalk from 'chalk';\nimport { getTools } from '../../../tools/index.js';\nimport type { ToolsOptions, ToolInfo } from './types.js';\nimport { TOOL_CATEGORIES as categories } from './types.js';\n\n/**\n * Get category for a tool\n */\nfunction getToolCategory(toolName: string): string {\n  for (const [category, toolNames] of Object.entries(categories)) {\n    if (toolNames.includes(toolName)) {\n      return category;\n    }\n  }\n  return 'Other';\n}\n\n/**\n * Build tool list from MCP tools registry\n */\nfunction buildToolList(): ToolInfo[] {\n  const tools = getTools();\n  return tools.map(tool => ({\n    name: tool.name,\n    description: tool.description || '',\n    category: getToolCategory(tool.name),\n  }));\n}\n\n/**\n * Filter tools by category\n */\nfunction filterByCategory(\n  toolList: ToolInfo[],\n  category: string\n): ToolInfo[] {\n  return toolList.filter(t =>\n    t.category.toLowerCase().includes(category.toLowerCase())\n  );\n}\n\n/**\n * Filter tools by search query\n */\nfunction filterBySearch(\n  toolList: ToolInfo[],\n  search: string\n): ToolInfo[] {\n  const searchLower = search.toLowerCase();\n  return toolList.filter(t =>\n    t.name.toLowerCase().includes(searchLower) ||\n    t.description.toLowerCase().includes(searchLower)\n  );\n}\n\n/**\n * Group tools by category\n */\nfunction groupByCategory(toolList: ToolInfo[]): Record<string, ToolInfo[]> {\n  const grouped: Record<string, ToolInfo[]> = {};\n\n  for (const tool of toolList) {\n    if (!grouped[tool.category]) {\n      grouped[tool.category] = [];\n    }\n    grouped[tool.category].push(tool);\n  }\n\n  return grouped;\n}\n\n/**\n * Display tools in formatted output\n */\nfunction displayTools(byCategory: Record<string, ToolInfo[]>, total: number): void {\n  console.log(chalk.bold('\\nAvailable MCP Tools'));\n  console.log('═══════════════════\\n');\n\n  // Sort categories for consistent display\n  const sortedCategories = Object.keys(byCategory).sort();\n\n  for (const category of sortedCategories) {\n    const categoryTools = byCategory[category];\n    console.log(chalk.bold(category));\n\n    for (const tool of categoryTools) {\n      // Truncate long descriptions\n      const desc = tool.description.length > 50\n        ? tool.description.slice(0, 47) + '...'\n        : tool.description;\n\n      console.log(`  ${chalk.cyan(tool.name.padEnd(30))} ${chalk.dim(desc)}`);\n    }\n\n    console.log();\n  }\n\n  console.log(chalk.dim(`(${total} tools total)\\n`));\n}\n\n/**\n * Tools command implementation\n *\n * Lists all available MCP tools with filtering and search.\n */\nexport async function toolsCommand(options: ToolsOptions): Promise<void> {\n  // Build tool list from registry\n  let toolList = buildToolList();\n\n  // Apply category filter\n  if (options.category) {\n    toolList = filterByCategory(toolList, options.category);\n  }\n\n  // Apply search filter\n  if (options.search) {\n    toolList = filterBySearch(toolList, options.search);\n  }\n\n  // JSON output\n  if (options.json) {\n    console.log(JSON.stringify({ tools: toolList }, null, 2));\n    return;\n  }\n\n  // Check if any tools match\n  if (toolList.length === 0) {\n    console.log(chalk.yellow('\\nNo tools found matching your filters.'));\n\n    if (options.category) {\n      console.log(chalk.dim(`Category filter: \"${options.category}\"`));\n    }\n    if (options.search) {\n      console.log(chalk.dim(`Search filter: \"${options.search}\"`));\n    }\n\n    console.log(chalk.dim('\\nRun \"specforge tools\" without filters to see all tools.'));\n    return;\n  }\n\n  // Group and display\n  const byCategory = groupByCategory(toolList);\n  displayTools(byCategory, toolList.length);\n}\n"],"mappings":"AAMA,OAAO,WAAW;AAClB,SAAS,gBAAgB;AAEzB,SAAS,mBAAmB,kBAAkB;AAK9C,SAAS,gBAAgB,UAA0B;AACjD,aAAW,CAAC,UAAU,SAAS,KAAK,OAAO,QAAQ,UAAU,GAAG;AAC9D,QAAI,UAAU,SAAS,QAAQ,GAAG;AAChC,aAAO;AAAA,IACT;AAAA,EACF;AACA,SAAO;AACT;AAKA,SAAS,gBAA4B;AACnC,QAAM,QAAQ,SAAS;AACvB,SAAO,MAAM,IAAI,WAAS;AAAA,IACxB,MAAM,KAAK;AAAA,IACX,aAAa,KAAK,eAAe;AAAA,IACjC,UAAU,gBAAgB,KAAK,IAAI;AAAA,EACrC,EAAE;AACJ;AAKA,SAAS,iBACP,UACA,UACY;AACZ,SAAO,SAAS;AAAA,IAAO,OACrB,EAAE,SAAS,YAAY,EAAE,SAAS,SAAS,YAAY,CAAC;AAAA,EAC1D;AACF;AAKA,SAAS,eACP,UACA,QACY;AACZ,QAAM,cAAc,OAAO,YAAY;AACvC,SAAO,SAAS;AAAA,IAAO,OACrB,EAAE,KAAK,YAAY,EAAE,SAAS,WAAW,KACzC,EAAE,YAAY,YAAY,EAAE,SAAS,WAAW;AAAA,EAClD;AACF;AAKA,SAAS,gBAAgB,UAAkD;AACzE,QAAM,UAAsC,CAAC;AAE7C,aAAW,QAAQ,UAAU;AAC3B,QAAI,CAAC,QAAQ,KAAK,QAAQ,GAAG;AAC3B,cAAQ,KAAK,QAAQ,IAAI,CAAC;AAAA,IAC5B;AACA,YAAQ,KAAK,QAAQ,EAAE,KAAK,IAAI;AAAA,EAClC;AAEA,SAAO;AACT;AAKA,SAAS,aAAa,YAAwC,OAAqB;AACjF,UAAQ,IAAI,MAAM,KAAK,uBAAuB,CAAC;AAC/C,UAAQ,IAAI,sHAAuB;AAGnC,QAAM,mBAAmB,OAAO,KAAK,UAAU,EAAE,KAAK;AAEtD,aAAW,YAAY,kBAAkB;AACvC,UAAM,gBAAgB,WAAW,QAAQ;AACzC,YAAQ,IAAI,MAAM,KAAK,QAAQ,CAAC;AAEhC,eAAW,QAAQ,eAAe;AAEhC,YAAM,OAAO,KAAK,YAAY,SAAS,KACnC,KAAK,YAAY,MAAM,GAAG,EAAE,IAAI,QAChC,KAAK;AAET,cAAQ,IAAI,KAAK,MAAM,KAAK,KAAK,KAAK,OAAO,EAAE,CAAC,CAAC,IAAI,MAAM,IAAI,IAAI,CAAC,EAAE;AAAA,IACxE;AAEA,YAAQ,IAAI;AAAA,EACd;AAEA,UAAQ,IAAI,MAAM,IAAI,IAAI,KAAK;AAAA,CAAiB,CAAC;AACnD;AAOA,eAAsB,aAAa,SAAsC;AAEvE,MAAI,WAAW,cAAc;AAG7B,MAAI,QAAQ,UAAU;AACpB,eAAW,iBAAiB,UAAU,QAAQ,QAAQ;AAAA,EACxD;AAGA,MAAI,QAAQ,QAAQ;AAClB,eAAW,eAAe,UAAU,QAAQ,MAAM;AAAA,EACpD;AAGA,MAAI,QAAQ,MAAM;AAChB,YAAQ,IAAI,KAAK,UAAU,EAAE,OAAO,SAAS,GAAG,MAAM,CAAC,CAAC;AACxD;AAAA,EACF;AAGA,MAAI,SAAS,WAAW,GAAG;AACzB,YAAQ,IAAI,MAAM,OAAO,yCAAyC,CAAC;AAEnE,QAAI,QAAQ,UAAU;AACpB,cAAQ,IAAI,MAAM,IAAI,qBAAqB,QAAQ,QAAQ,GAAG,CAAC;AAAA,IACjE;AACA,QAAI,QAAQ,QAAQ;AAClB,cAAQ,IAAI,MAAM,IAAI,mBAAmB,QAAQ,MAAM,GAAG,CAAC;AAAA,IAC7D;AAEA,YAAQ,IAAI,MAAM,IAAI,2DAA2D,CAAC;AAClF;AAAA,EACF;AAGA,QAAM,aAAa,gBAAgB,QAAQ;AAC3C,eAAa,YAAY,SAAS,MAAM;AAC1C;","names":[]}

package/dist/cli/commands/debug/types.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Debug Command Types & Interfaces
+ *
+ * Type definitions for debug commands including call, tools, test, and whoami.
+ */
+/**
+ * Options for the call command
+ */
+export interface CallOptions {
+    /** Tool arguments as JSON string */
+    args?: string;
+    /** Output format (json, toon) */
+    format?: 'json' | 'toon';
+    /** Show raw API response */
+    raw?: boolean;
+}
+/**
+ * Options for the tools command
+ */
+export interface ToolsOptions {
+    /** Filter by category */
+    category?: string;
+    /** Search tool names/descriptions */
+    search?: string;
+    /** Output as JSON */
+    json?: boolean;
+}
+/**
+ * Tool information structure
+ */
+export interface ToolInfo {
+    /** Tool name */
+    name: string;
+    /** Tool description */
+    description: string;
+    /** Tool category */
+    category: string;
+}
+/**
+ * Tool categories mapping
+ */
+export type ToolCategories = Record<string, string[]>;
+/**
+ * Options for the whoami command
+ */
+export interface WhoamiOptions {
+    /** Output as JSON */
+    json?: boolean;
+}
+/**
+ * User information structure
+ */
+export interface UserInfo {
+    /** User display name */
+    name?: string;
+    /** User email address */
+    email: string;
+    /** Masked API key */
+    apiKey: string;
+}
+/**
+ * Configuration information structure
+ */
+export interface ConfigurationInfo {
+    /** Configuration source (environment, global, project) */
+    source: string;
+    /** Current project ID if set */
+    projectId?: string;
+    /** Current project name if set */
+    projectName?: string;
+    /** Current specification ID if set */
+    specificationId?: string;
+    /** Current specification title if set */
+    specificationTitle?: string;
+    /** Resolved local MCP response encoding (json or toon) */
+    mcpOutputFormat: string;
+}
+/**
+ * Configuration file paths
+ */
+export interface ConfigPaths {
+    /** Project config path (.specforge.json) */
+    projectConfig: string;
+    /** MCP config path (.mcp.json) */
+    mcpConfig: string;
+    /** Global config path (~/.specforge/config.json) */
+    globalConfig: string;
+}
+/**
+ * Full whoami information structure
+ */
+export interface WhoamiInfo {
+    /** User information */
+    user: UserInfo;
+    /** Configuration information */
+    configuration: ConfigurationInfo;
+    /** Configuration file paths */
+    paths: ConfigPaths;
+}
+/**
+ * Test command result
+ */
+export interface TestResult {
+    /** Whether connection was successful */
+    success: boolean;
+    /** Response time in milliseconds */
+    responseTime?: number;
+    /** User email from API */
+    userEmail?: string;
+    /** Number of accessible projects */
+    projectCount?: number;
+    /** Error message if failed */
+    error?: string;
+}
+/**
+ * Default tool categories
+ */
+export declare const TOOL_CATEGORIES: ToolCategories;
+//# sourceMappingURL=types.d.ts.map

package/dist/cli/commands/debug/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/debug/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,oCAAoC;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iCAAiC;IACjC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,4BAA4B;IAC5B,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,yBAAyB;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qCAAqC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qBAAqB;IACrB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,uBAAuB;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,oBAAoB;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,qBAAqB;IACrB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,wBAAwB;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yBAAyB;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,qBAAqB;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,0DAA0D;IAC1D,MAAM,EAAE,MAAM,CAAC;IACf,gCAAgC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kCAAkC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sCAAsC;IACtC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,yCAAyC;IACzC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,0DAA0D;IAC1D,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,4CAA4C;IAC5C,aAAa,EAAE,MAAM,CAAC;IACtB,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,oDAAoD;IACpD,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,uBAAuB;IACvB,IAAI,EAAE,QAAQ,CAAC;IACf,gCAAgC;IAChC,aAAa,EAAE,iBAAiB,CAAC;IACjC,+BAA+B;IAC/B,KAAK,EAAE,WAAW,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,wCAAwC;IACxC,OAAO,EAAE,OAAO,CAAC;IACjB,oCAAoC;IACpC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,0BAA0B;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oCAAoC;IACpC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,cA+B7B,CAAC"}

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

@@ -0,0 +1,36 @@
+const TOOL_CATEGORIES = {
+  "Core Operations": [
+    "list_projects",
+    "get_project",
+    "list_specifications",
+    "get_specification",
+    "create_specification",
+    "update_specification",
+    "list_epics",
+    "get_epic",
+    "create_epic",
+    "update_epic",
+    "list_tickets",
+    "get_ticket",
+    "create_ticket",
+    "update_ticket",
+    "search_tickets"
+  ],
+  "Context & AI": [
+    "get_working_context",
+    "set_working_context",
+    "get_implementation_context",
+    "get_full_context",
+    "get_pattern_chain"
+  ],
+  "Sessions & Workflow": [
+    "start_ticket",
+    "complete_ticket",
+    "update_ticket_progress"
+  ],
+  Validation: ["validate_ticket", "validate_acceptance_criteria"]
+};
+export {
+  TOOL_CATEGORIES
+};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/cli/commands/debug/types.ts"],"sourcesContent":["/**\n * Debug Command Types & Interfaces\n *\n * Type definitions for debug commands including call, tools, test, and whoami.\n */\n\n/**\n * Options for the call command\n */\nexport interface CallOptions {\n  /** Tool arguments as JSON string */\n  args?: string;\n  /** Output format (json, toon) */\n  format?: 'json' | 'toon';\n  /** Show raw API response */\n  raw?: boolean;\n}\n\n/**\n * Options for the tools command\n */\nexport interface ToolsOptions {\n  /** Filter by category */\n  category?: string;\n  /** Search tool names/descriptions */\n  search?: string;\n  /** Output as JSON */\n  json?: boolean;\n}\n\n/**\n * Tool information structure\n */\nexport interface ToolInfo {\n  /** Tool name */\n  name: string;\n  /** Tool description */\n  description: string;\n  /** Tool category */\n  category: string;\n}\n\n/**\n * Tool categories mapping\n */\nexport type ToolCategories = Record<string, string[]>;\n\n/**\n * Options for the whoami command\n */\nexport interface WhoamiOptions {\n  /** Output as JSON */\n  json?: boolean;\n}\n\n/**\n * User information structure\n */\nexport interface UserInfo {\n  /** User display name */\n  name?: string;\n  /** User email address */\n  email: string;\n  /** Masked API key */\n  apiKey: string;\n}\n\n/**\n * Configuration information structure\n */\nexport interface ConfigurationInfo {\n  /** Configuration source (environment, global, project) */\n  source: string;\n  /** Current project ID if set */\n  projectId?: string;\n  /** Current project name if set */\n  projectName?: string;\n  /** Current specification ID if set */\n  specificationId?: string;\n  /** Current specification title if set */\n  specificationTitle?: string;\n  /** Resolved local MCP response encoding (json or toon) */\n  mcpOutputFormat: string;\n}\n\n/**\n * Configuration file paths\n */\nexport interface ConfigPaths {\n  /** Project config path (.specforge.json) */\n  projectConfig: string;\n  /** MCP config path (.mcp.json) */\n  mcpConfig: string;\n  /** Global config path (~/.specforge/config.json) */\n  globalConfig: string;\n}\n\n/**\n * Full whoami information structure\n */\nexport interface WhoamiInfo {\n  /** User information */\n  user: UserInfo;\n  /** Configuration information */\n  configuration: ConfigurationInfo;\n  /** Configuration file paths */\n  paths: ConfigPaths;\n}\n\n/**\n * Test command result\n */\nexport interface TestResult {\n  /** Whether connection was successful */\n  success: boolean;\n  /** Response time in milliseconds */\n  responseTime?: number;\n  /** User email from API */\n  userEmail?: string;\n  /** Number of accessible projects */\n  projectCount?: number;\n  /** Error message if failed */\n  error?: string;\n}\n\n/**\n * Default tool categories\n */\nexport const TOOL_CATEGORIES: ToolCategories = {\n  'Core Operations': [\n    'list_projects',\n    'get_project',\n    'list_specifications',\n    'get_specification',\n    'create_specification',\n    'update_specification',\n    'list_epics',\n    'get_epic',\n    'create_epic',\n    'update_epic',\n    'list_tickets',\n    'get_ticket',\n    'create_ticket',\n    'update_ticket',\n    'search_tickets',\n  ],\n  'Context & AI': [\n    'get_working_context',\n    'set_working_context',\n    'get_implementation_context',\n    'get_full_context',\n    'get_pattern_chain',\n  ],\n  'Sessions & Workflow': [\n    'start_ticket',\n    'complete_ticket',\n    'update_ticket_progress',\n  ],\n  Validation: ['validate_ticket', 'validate_acceptance_criteria'],\n};\n"],"mappings":"AAgIO,MAAM,kBAAkC;AAAA,EAC7C,mBAAmB;AAAA,IACjB;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAAA,EACA,gBAAgB;AAAA,IACd;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAAA,EACA,uBAAuB;AAAA,IACrB;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAAA,EACA,YAAY,CAAC,mBAAmB,8BAA8B;AAChE;","names":[]}

package/dist/cli/commands/debug/whoami.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Whoami Command Implementation
+ *
+ * Displays current user information, configuration settings, and config file paths.
+ */
+import type { WhoamiOptions } from './types.js';
+/**
+ * Whoami command implementation
+ *
+ * Displays current user and configuration information.
+ */
+export declare function whoamiCommand(options: WhoamiOptions): Promise<void>;
+//# sourceMappingURL=whoami.d.ts.map

package/dist/cli/commands/debug/whoami.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"whoami.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/debug/whoami.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,OAAO,KAAK,EAAE,aAAa,EAAc,MAAM,YAAY,CAAC;AAgF5D;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAmFzE"}