@specforge/mcp 2.0.9 → 2.1.0

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

@@ -0,0 +1,90 @@
+/**
+ * Debug Command Registration
+ *
+ * Registers all debug commands with the CLI framework.
+ */
+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';
+/**
+ * Register all debug commands with the CLI
+ */
+export function registerDebugCommands(program) {
+    // Call command - directly call MCP tools
+    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-mcp call list_projects
+  $ specforge-mcp call get_ticket --args='{"ticketId":"abc123"}'
+  $ specforge-mcp call list_tickets --format toon
+  $ specforge-mcp 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);
+    }));
+    // Tools command - list available MCP tools
+    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-mcp tools
+  $ specforge-mcp tools --category context
+  $ specforge-mcp tools --search ticket
+  $ specforge-mcp 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);
+    }));
+    // Test command - test API connection
+    program
+        .command('test')
+        .description('Test API connection and authentication')
+        .addHelpText('after', `
+Examples:
+  $ specforge-mcp 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();
+    }));
+    // Whoami command - show current user and config
+    program
+        .command('whoami')
+        .description('Show current user and configuration')
+        .option('--json', 'Output as JSON')
+        .addHelpText('after', `
+Examples:
+  $ specforge-mcp whoami
+  $ specforge-mcp 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);
+    }));
+}
+//# sourceMappingURL=register.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"register.js","sourceRoot":"","sources":["../../../../src/cli/commands/debug/register.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AACrE,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;AAG5C;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAgB;IACpD,yCAAyC;IACzC,OAAO;SACJ,OAAO,CAAC,aAAa,CAAC;SACtB,WAAW,CAAC,2BAA2B,CAAC;SACxC,MAAM,CAAC,eAAe,EAAE,wBAAwB,CAAC;SACjD,MAAM,CAAC,mBAAmB,EAAE,4BAA4B,EAAE,MAAM,CAAC;SACjE,MAAM,CAAC,OAAO,EAAE,uBAAuB,CAAC;SACxC,WAAW,CACV,OAAO,EACP;;;;;;;;;;CAUL,CACI;SACA,MAAM,CACL,gBAAgB,CAAC,KAAK,EAAE,IAAY,EAAE,OAAoB,EAAE,EAAE;QAC5D,MAAM,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACnC,CAAC,CAAC,CACH,CAAC;IAEJ,2CAA2C;IAC3C,OAAO;SACJ,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,0BAA0B,CAAC;SACvC,MAAM,CAAC,uBAAuB,EAAE,oBAAoB,CAAC;SACrD,MAAM,CAAC,kBAAkB,EAAE,gCAAgC,CAAC;SAC5D,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC;SAClC,WAAW,CACV,OAAO,EACP;;;;;;;;;;CAUL,CACI;SACA,MAAM,CACL,gBAAgB,CAAC,KAAK,EAAE,OAAqB,EAAE,EAAE;QAC/C,MAAM,YAAY,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC,CAAC,CACH,CAAC;IAEJ,qCAAqC;IACrC,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,wCAAwC,CAAC;SACrD,WAAW,CACV,OAAO,EACP;;;;;;;CAOL,CACI;SACA,MAAM,CACL,gBAAgB,CAAC,KAAK,IAAI,EAAE;QAC1B,MAAM,WAAW,EAAE,CAAC;IACtB,CAAC,CAAC,CACH,CAAC;IAEJ,gDAAgD;IAChD,OAAO;SACJ,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,qCAAqC,CAAC;SAClD,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC;SAClC,WAAW,CACV,OAAO,EACP;;;;;;;;CAQL,CACI;SACA,MAAM,CACL,gBAAgB,CAAC,KAAK,EAAE,OAAsB,EAAE,EAAE;QAChD,MAAM,aAAa,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC,CAAC,CACH,CAAC;AACN,CAAC"}

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;AA8EH;;;;GAIG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CA2CjD"}

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

@@ -0,0 +1,117 @@
+/**
+ * Test Command Implementation
+ *
+ * Tests the API connection and authentication, displaying connection status,
+ * response time, and user information.
+ */
+import chalk from 'chalk';
+import ora from 'ora';
+import { resolveConfig } from '../../config/index.js';
+import { ApiClient } from '../../../client/api-client.js';
+/**
+ * Mask API key for display
+ */
+function maskApiKey(apiKey) {
+    if (apiKey.length < 12) {
+        return '****';
+    }
+    return `${apiKey.slice(0, 8)}...${apiKey.slice(-4)}`;
+}
+/**
+ * Display test header with configuration
+ */
+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();
+}
+/**
+ * Display successful test results
+ */
+function displaySuccess(result) {
+    console.log(chalk.green(`✓ Connection successful (${result.responseTime}ms)`));
+    console.log(chalk.green('✓ Authentication valid'));
+    if (result.userEmail) {
+        console.log(chalk.green(`✓ User: ${result.userEmail}`));
+    }
+    if (result.projectCount !== undefined) {
+        console.log(chalk.green(`✓ Projects accessible: ${result.projectCount}`));
+    }
+    console.log();
+}
+/**
+ * Display connection failure
+ */
+function displayFailure(error) {
+    if (error.includes('401') || error.includes('Unauthorized')) {
+        console.log(chalk.red('✗ Authentication failed: Invalid API key'));
+        console.log(chalk.dim('\nCheck your API key:'));
+        console.log(chalk.dim('  - Run "specforge-mcp 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('✗ 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('✗ 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('✗ 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(`✗ Error: ${error}`));
+    }
+    console.log();
+}
+/**
+ * Test command implementation
+ *
+ * Tests the API connection and authentication.
+ */
+export async function testCommand() {
+    const config = resolveConfig();
+    const apiUrl = process.env.SPECFORGE_API_URL || 'https://mcp.specforge.com.br/mcp';
+    // Display header
+    displayTestHeader(apiUrl, config.apiKey);
+    const spinner = ora('Testing connection...').start();
+    try {
+        const startTime = Date.now();
+        const client = new ApiClient({
+            apiKey: config.apiKey,
+            apiUrl,
+            debug: config.debug,
+        });
+        // Test with list_projects - a simple authenticated endpoint
+        const response = await client.call('list_projects', {});
+        const elapsed = Date.now() - startTime;
+        spinner.stop();
+        // Extract user info from response
+        const userEmail = response.userEmail || 'Unknown';
+        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);
+    }
+}
+//# sourceMappingURL=test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"test.js","sourceRoot":"","sources":["../../../../src/cli/commands/debug/test.ts"],"names":[],"mappings":"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"}

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,117 @@
+/**
+ * Tools Command Implementation
+ *
+ * Lists all available MCP tools with filtering and search capabilities.
+ */
+import chalk from 'chalk';
+import { getTools } from '../../../tools/index.js';
+import { TOOL_CATEGORIES as categories } from './types.js';
+/**
+ * Get category for a tool
+ */
+function getToolCategory(toolName) {
+    for (const [category, toolNames] of Object.entries(categories)) {
+        if (toolNames.includes(toolName)) {
+            return category;
+        }
+    }
+    return 'Other';
+}
+/**
+ * Build tool list from MCP tools registry
+ */
+function buildToolList() {
+    const tools = getTools();
+    return tools.map(tool => ({
+        name: tool.name,
+        description: tool.description || '',
+        category: getToolCategory(tool.name),
+    }));
+}
+/**
+ * Filter tools by category
+ */
+function filterByCategory(toolList, category) {
+    return toolList.filter(t => t.category.toLowerCase().includes(category.toLowerCase()));
+}
+/**
+ * Filter tools by search query
+ */
+function filterBySearch(toolList, search) {
+    const searchLower = search.toLowerCase();
+    return toolList.filter(t => t.name.toLowerCase().includes(searchLower) ||
+        t.description.toLowerCase().includes(searchLower));
+}
+/**
+ * Group tools by category
+ */
+function groupByCategory(toolList) {
+    const grouped = {};
+    for (const tool of toolList) {
+        if (!grouped[tool.category]) {
+            grouped[tool.category] = [];
+        }
+        grouped[tool.category].push(tool);
+    }
+    return grouped;
+}
+/**
+ * Display tools in formatted output
+ */
+function displayTools(byCategory, total) {
+    console.log(chalk.bold('\nAvailable MCP Tools'));
+    console.log('═══════════════════\n');
+    // Sort categories for consistent display
+    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) {
+            // Truncate long descriptions
+            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)\n`));
+}
+/**
+ * Tools command implementation
+ *
+ * Lists all available MCP tools with filtering and search.
+ */
+export async function toolsCommand(options) {
+    // Build tool list from registry
+    let toolList = buildToolList();
+    // Apply category filter
+    if (options.category) {
+        toolList = filterByCategory(toolList, options.category);
+    }
+    // Apply search filter
+    if (options.search) {
+        toolList = filterBySearch(toolList, options.search);
+    }
+    // JSON output
+    if (options.json) {
+        console.log(JSON.stringify({ tools: toolList }, null, 2));
+        return;
+    }
+    // Check if any tools match
+    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-mcp tools" without filters to see all tools.'));
+        return;
+    }
+    // Group and display
+    const byCategory = groupByCategory(toolList);
+    displayTools(byCategory, toolList.length);
+}
+//# sourceMappingURL=tools.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../../src/cli/commands/debug/tools.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,117 @@
+/**
+ * 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 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;
+    /** Default output format */
+    format: 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,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,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAC;CAChB;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,cAiC7B,CAAC"}

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

@@ -0,0 +1,43 @@
+/**
+ * Debug Command Types & Interfaces
+ *
+ * Type definitions for debug commands including call, tools, test, and whoami.
+ */
+/**
+ * Default tool categories
+ */
+export 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_implementation_session',
+        'end_session',
+        'start_ticket',
+        'complete_ticket',
+        'update_ticket_progress',
+    ],
+    Validation: ['validate_ticket', 'validate_acceptance_criteria'],
+};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/cli/commands/debug/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAuHH;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAmB;IAC7C,iBAAiB,EAAE;QACjB,eAAe;QACf,aAAa;QACb,qBAAqB;QACrB,mBAAmB;QACnB,sBAAsB;QACtB,sBAAsB;QACtB,YAAY;QACZ,UAAU;QACV,aAAa;QACb,aAAa;QACb,cAAc;QACd,YAAY;QACZ,eAAe;QACf,eAAe;QACf,gBAAgB;KACjB;IACD,cAAc,EAAE;QACd,qBAAqB;QACrB,qBAAqB;QACrB,4BAA4B;QAC5B,kBAAkB;QAClB,mBAAmB;KACpB;IACD,qBAAqB,EAAE;QACrB,8BAA8B;QAC9B,aAAa;QACb,cAAc;QACd,iBAAiB;QACjB,wBAAwB;KACzB;IACD,UAAU,EAAE,CAAC,iBAAiB,EAAE,8BAA8B,CAAC;CAChE,CAAC"}

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;AAMH,OAAO,KAAK,EAAE,aAAa,EAAc,MAAM,YAAY,CAAC;AA6E5D;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAiFzE"}