@specforge/mcp 2.0.9 → 2.1.0

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

@@ -0,0 +1,161 @@
+/**
+ * Whoami Command Implementation
+ *
+ * Displays current user information, configuration settings, and config file paths.
+ */
+import chalk from 'chalk';
+import ora from 'ora';
+import { resolveConfig, getConfigPaths } 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)}`;
+}
+/**
+ * Determine configuration source
+ */
+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';
+}
+/**
+ * Display user information
+ */
+function displayUserInfo(info) {
+    console.log(chalk.bold('\nUser'));
+    console.log('────');
+    console.log(`Email:    ${info.user.email}`);
+    console.log(`API Key:  ${info.user.apiKey}`);
+}
+/**
+ * Display configuration information
+ */
+function displayConfiguration(info) {
+    console.log(chalk.bold('\nConfiguration'));
+    console.log('─────────────');
+    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(`Format:   ${info.configuration.format}`);
+}
+/**
+ * Display configuration file paths
+ */
+function displayPaths(info) {
+    console.log(chalk.bold('\nPaths'));
+    console.log('─────');
+    console.log(`Project config: ${info.paths.projectConfig}`);
+    console.log(`MCP config:     ${info.paths.mcpConfig}`);
+    console.log(`Global config:  ${info.paths.globalConfig}`);
+    console.log();
+}
+/**
+ * Whoami command implementation
+ *
+ * Displays current user and configuration information.
+ */
+export async function whoamiCommand(options) {
+    const config = resolveConfig();
+    const paths = getConfigPaths();
+    const spinner = ora('Fetching user info...').start();
+    try {
+        const client = new ApiClient({
+            apiKey: config.apiKey,
+            apiUrl: process.env.SPECFORGE_API_URL || 'https://mcp.specforge.com.br/mcp',
+            debug: config.debug,
+        });
+        // Get user info from list_projects
+        const response = await client.call('list_projects', {});
+        const userEmail = response.userEmail || 'Unknown';
+        // Get project name if configured
+        let projectName;
+        if (config.projectId) {
+            try {
+                const proj = await client.call('get_project', { projectId: config.projectId });
+                projectName = proj.name;
+            }
+            catch {
+                // Ignore - project might not exist
+            }
+        }
+        // Get specification title if configured
+        let specTitle;
+        if (config.specificationId) {
+            try {
+                const spec = await client.call('get_specification', {
+                    specificationId: config.specificationId
+                });
+                specTitle = spec.title;
+            }
+            catch {
+                // Ignore - spec might not exist
+            }
+        }
+        spinner.stop();
+        // Build whoami info
+        const info = {
+            user: {
+                email: userEmail,
+                apiKey: maskApiKey(config.apiKey),
+            },
+            configuration: {
+                source: getConfigSource(config),
+                projectId: config.projectId || undefined,
+                projectName,
+                specificationId: config.specificationId || undefined,
+                specificationTitle: specTitle,
+                format: config.format || 'json',
+            },
+            paths: {
+                projectConfig: paths.projectConfig,
+                mcpConfig: paths.mcpConfig,
+                globalConfig: paths.globalConfig,
+            },
+        };
+        // JSON output
+        if (options.json) {
+            console.log(JSON.stringify(info, null, 2));
+            return;
+        }
+        // Display formatted output
+        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(`\nError: ${message}`));
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=whoami.js.map

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

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

package/dist/cli/commands/docs/content/api.d.ts

@@ -0,0 +1,7 @@
+/**
+ * API Documentation Content
+ *
+ * Provides API reference including authentication, endpoints, protocol, and error codes.
+ */
+export declare const API_CONTENT: string;
+//# sourceMappingURL=api.d.ts.map

package/dist/cli/commands/docs/content/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/docs/content/api.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,eAAO,MAAM,WAAW,QAwDvB,CAAC"}

package/dist/cli/commands/docs/content/api.js

@@ -0,0 +1,64 @@
+/**
+ * API Documentation Content
+ *
+ * Provides API reference including authentication, endpoints, protocol, and error codes.
+ */
+import chalk from 'chalk';
+export const API_CONTENT = `
+${chalk.bold('SpecForge API Reference')}
+${'═'.repeat(50)}
+
+${chalk.bold('Authentication')}
+${'─'.repeat(50)}
+API keys start with: ${chalk.cyan('sf_live_')}
+Get yours at: ${chalk.underline('https://specforge.com.br/settings/api-keys')}
+
+${chalk.bold('Configuration Methods')}
+${'─'.repeat(50)}
+1. Environment variable: SPECFORGE_API_KEY
+2. Global config: ~/.specforge/config.json
+3. Project config: .specforge.json
+
+${chalk.bold('API Endpoint')}
+${'─'.repeat(50)}
+Production: ${chalk.cyan('https://mcp.specforge.com.br/mcp')}
+Custom:     Set SPECFORGE_API_URL environment variable
+
+${chalk.bold('MCP Protocol')}
+${'─'.repeat(50)}
+SpecForge uses the Model Context Protocol (MCP) for AI integration.
+
+Request format:
+{
+  "method": "call",
+  "params": {
+    "name": "tool_name",
+    "arguments": { ... }
+  }
+}
+
+Response format:
+{
+  "result": { ... }
+}
+
+${chalk.bold('Rate Limits')}
+${'─'.repeat(50)}
+• 100 requests per minute (standard)
+• 1000 requests per minute (pro)
+
+${chalk.bold('Error Codes')}
+${'─'.repeat(50)}
+• 401: Invalid or expired API key
+• 403: Insufficient permissions
+• 404: Resource not found
+• 429: Rate limit exceeded
+• 500: Server error
+
+${chalk.bold('CLI Configuration')}
+${'─'.repeat(50)}
+Run 'specforge-mcp login' for interactive setup
+Run 'specforge-mcp configure' to modify settings
+Run 'specforge-mcp test' to verify connection
+`;
+//# sourceMappingURL=api.js.map

package/dist/cli/commands/docs/content/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../../../../src/cli/commands/docs/content/api.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,MAAM,CAAC,MAAM,WAAW,GAAG;EACzB,KAAK,CAAC,IAAI,CAAC,yBAAyB,CAAC;EACrC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;;EAEd,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC;EAC5B,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;uBACO,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC;gBAC7B,KAAK,CAAC,SAAS,CAAC,4CAA4C,CAAC;;EAE3E,KAAK,CAAC,IAAI,CAAC,uBAAuB,CAAC;EACnC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;;;;;EAKd,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC;EAC1B,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;cACF,KAAK,CAAC,IAAI,CAAC,kCAAkC,CAAC;;;EAG1D,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC;EAC1B,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;;;;;;;;;;;;;;;;;EAiBd,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC;EACzB,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;;;;EAId,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC;EACzB,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;;;;;;;EAOd,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC;EAC/B,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;;;;CAIf,CAAC"}

package/dist/cli/commands/docs/content/concepts.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Concepts Documentation Content
+ *
+ * Explains core SpecForge concepts including specifications, epics, tickets, patterns, and dependencies.
+ */
+export declare const CONCEPTS_CONTENT: string;
+//# sourceMappingURL=concepts.d.ts.map

package/dist/cli/commands/docs/content/concepts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"concepts.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/docs/content/concepts.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,eAAO,MAAM,gBAAgB,QA4D5B,CAAC"}

package/dist/cli/commands/docs/content/concepts.js

@@ -0,0 +1,68 @@
+/**
+ * Concepts Documentation Content
+ *
+ * Explains core SpecForge concepts including specifications, epics, tickets, patterns, and dependencies.
+ */
+import chalk from 'chalk';
+export const CONCEPTS_CONTENT = `
+${chalk.bold('SpecForge Core Concepts')}
+${'═'.repeat(50)}
+
+${chalk.bold('📋 Specification')}
+${'─'.repeat(50)}
+A specification is the top-level container for a project implementation.
+It contains:
+• Goals and requirements
+• Technical architecture
+• Code patterns and standards
+• Epics (grouped work items)
+
+${chalk.bold('📦 Epic')}
+${'─'.repeat(50)}
+An epic groups related tickets that share a common goal.
+It contains:
+• Objective and description
+• Shared patterns (inherited by tickets)
+• Tickets (individual work items)
+• Dependencies on other epics
+
+${chalk.bold('🎫 Ticket')}
+${'─'.repeat(50)}
+A ticket is a single implementable unit of work.
+It contains:
+• Description and acceptance criteria
+• Implementation steps
+• Technical details (files, patterns)
+• Dependencies on other tickets
+• Estimated hours and complexity
+
+${chalk.bold('🧬 Pattern')}
+${'─'.repeat(50)}
+Patterns are reusable code standards that cascade down:
+Specification → Epic → Ticket
+
+Pattern types:
+• Code standards (naming, error handling)
+• Return types (Result<T>, etc.)
+• Common imports
+• File templates
+
+${chalk.bold('🎯 Working Context')}
+${'─'.repeat(50)}
+The working context tracks what you're currently focused on:
+• Project
+• Specification
+• Epic (optional)
+• Ticket (optional)
+
+Set with: set_working_context({ projectId, specificationId, ... })
+Get with: get_working_context()
+
+${chalk.bold('🔗 Dependencies')}
+${'─'.repeat(50)}
+Tickets can depend on other tickets.
+• dependsOn: Array of ticket IDs that must complete first
+• Status auto-transitions: pending → ready when deps complete
+• Critical path: longest chain of dependencies
+`;
+//# sourceMappingURL=concepts.js.map

package/dist/cli/commands/docs/content/concepts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"concepts.js","sourceRoot":"","sources":["../../../../../src/cli/commands/docs/content/concepts.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,MAAM,CAAC,MAAM,gBAAgB,GAAG;EAC9B,KAAK,CAAC,IAAI,CAAC,yBAAyB,CAAC;EACrC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;;EAEd,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC;EAC9B,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;;;;;;;;EAQd,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC;EACrB,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;;;;;;;;EAQd,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC;EACvB,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;;;;;;;;;EASd,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC;EACxB,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;;;;;;;;;;EAUd,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC;EAChC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;;;;;;;;;;EAUd,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC;EAC7B,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;;;;;CAKf,CAAC"}

package/dist/cli/commands/docs/content/examples.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Examples Documentation Content
+ *
+ * Provides practical usage examples for SpecForge commands and workflows.
+ */
+export declare const EXAMPLES_CONTENT: string;
+//# sourceMappingURL=examples.d.ts.map

package/dist/cli/commands/docs/content/examples.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"examples.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/docs/content/examples.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,eAAO,MAAM,gBAAgB,QA4E5B,CAAC"}

package/dist/cli/commands/docs/content/examples.js

@@ -0,0 +1,84 @@
+/**
+ * Examples Documentation Content
+ *
+ * Provides practical usage examples for SpecForge commands and workflows.
+ */
+import chalk from 'chalk';
+export const EXAMPLES_CONTENT = `
+${chalk.bold('SpecForge Usage Examples')}
+${'═'.repeat(50)}
+
+${chalk.bold('Example 1: Import a Plan')}
+${'─'.repeat(50)}
+# In Claude Code:
+/sf-import-plan docs/implementation-plan.md
+
+# This creates:
+# - Specification with patterns
+# - Epics for each phase
+# - Tickets with dependencies
+
+${chalk.bold('Example 2: Start Implementation')}
+${'─'.repeat(50)}
+# Initialize
+/sf-init
+
+# Check what's ready
+/sf-status
+
+# Start next ticket
+/sf-next
+
+# Or specific ticket
+/sf-ticket-implementation E1-T3
+
+${chalk.bold('Example 3: Batch Implementation')}
+${'─'.repeat(50)}
+# Implement up to 5 tickets automatically
+/sf-run-autonomous 5
+
+${chalk.bold('Example 4: CLI Commands')}
+${'─'.repeat(50)}
+# View current context
+specforge-mcp status
+
+# List projects
+specforge-mcp projects
+
+# Switch specification
+specforge-mcp switch spec123
+
+# List tickets
+specforge-mcp tickets --status pending
+
+# View ticket details
+specforge-mcp ticket 42
+
+${chalk.bold('Example 5: MCP Tool Calls')}
+${'─'.repeat(50)}
+# Direct tool call
+specforge-mcp call get_ticket --args='{"ticketId":"abc123"}'
+
+# List available tools
+specforge-mcp tools --category context
+
+${chalk.bold('Example 6: Session Management')}
+${'─'.repeat(50)}
+# Start implementation session
+specforge-mcp session start
+
+# Check session status
+specforge-mcp session
+
+# End session with summary
+specforge-mcp session end --summary "Completed auth module"
+
+${chalk.bold('Example 7: Scaffolding Commands')}
+${'─'.repeat(50)}
+# Scaffold for Claude Code
+specforge-mcp scaffold --target claude
+
+# Scaffold for project
+specforge-mcp scaffold --target claude --project
+`;
+//# sourceMappingURL=examples.js.map

package/dist/cli/commands/docs/content/examples.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"examples.js","sourceRoot":"","sources":["../../../../../src/cli/commands/docs/content/examples.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,MAAM,CAAC,MAAM,gBAAgB,GAAG;EAC9B,KAAK,CAAC,IAAI,CAAC,0BAA0B,CAAC;EACtC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;;EAEd,KAAK,CAAC,IAAI,CAAC,0BAA0B,CAAC;EACtC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;;;;;;;;;EASd,KAAK,CAAC,IAAI,CAAC,iCAAiC,CAAC;EAC7C,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;;;;;;;;;;;;;EAad,KAAK,CAAC,IAAI,CAAC,iCAAiC,CAAC;EAC7C,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;;;;EAId,KAAK,CAAC,IAAI,CAAC,yBAAyB,CAAC;EACrC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;;;;;;;;;;;;;;;;EAgBd,KAAK,CAAC,IAAI,CAAC,2BAA2B,CAAC;EACvC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;;;;;;;EAOd,KAAK,CAAC,IAAI,CAAC,+BAA+B,CAAC;EAC3C,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;;;;;;;;;;EAUd,KAAK,CAAC,IAAI,CAAC,iCAAiC,CAAC;EAC7C,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;;;;;;CAMf,CAAC"}

package/dist/cli/commands/docs/content/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Documentation Content Exports
+ *
+ * Exports all documentation content modules.
+ */
+export { WORKFLOW_CONTENT } from './workflow.js';
+export { CONCEPTS_CONTENT } from './concepts.js';
+export { API_CONTENT } from './api.js';
+export { EXAMPLES_CONTENT } from './examples.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/commands/docs/content/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/docs/content/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC"}

package/dist/cli/commands/docs/content/index.js

@@ -0,0 +1,10 @@
+/**
+ * Documentation Content Exports
+ *
+ * Exports all documentation content modules.
+ */
+export { WORKFLOW_CONTENT } from './workflow.js';
+export { CONCEPTS_CONTENT } from './concepts.js';
+export { API_CONTENT } from './api.js';
+export { EXAMPLES_CONTENT } from './examples.js';
+//# sourceMappingURL=index.js.map

package/dist/cli/commands/docs/content/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/cli/commands/docs/content/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC"}

package/dist/cli/commands/docs/content/workflow.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Workflow Documentation Content
+ *
+ * Provides comprehensive workflow guide for SpecForge implementation process.
+ */
+export declare const WORKFLOW_CONTENT: string;
+//# sourceMappingURL=workflow.d.ts.map

package/dist/cli/commands/docs/content/workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/docs/content/workflow.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,eAAO,MAAM,gBAAgB,QAoC5B,CAAC"}

package/dist/cli/commands/docs/content/workflow.js

@@ -0,0 +1,44 @@
+/**
+ * Workflow Documentation Content
+ *
+ * Provides comprehensive workflow guide for SpecForge implementation process.
+ */
+import chalk from 'chalk';
+export const WORKFLOW_CONTENT = `
+${chalk.bold('SpecForge Implementation Workflow')}
+${'═'.repeat(50)}
+
+${chalk.bold('1. Setup')}
+   specforge-mcp login           # One-time authentication
+   specforge-mcp init            # Configure project
+
+${chalk.bold('2. Planning')}
+   /sf-import-plan <file>        # Import plan to specification
+   /sf-create-spec <file>        # Create spec step-by-step
+   /sf-create-epics <spec>       # Add epics to spec
+   /sf-create-tickets <epic>     # Add tickets to epic
+
+${chalk.bold('3. Implementation')}
+   /sf-init <spec-id>            # Initialize for implementation
+   /sf-status                    # View progress
+   /sf-next                      # Start next ticket
+   /sf-run-autonomous            # Batch implement
+
+${chalk.bold('4. Review')}
+   /sf-review                    # Accomplishment review
+   /sf-validate                  # System health check
+
+${chalk.bold('Key Concepts')}
+${'─'.repeat(50)}
+• ${chalk.cyan('Specification')}: High-level project plan with patterns
+• ${chalk.cyan('Epic')}: Group of related tickets with shared patterns
+• ${chalk.cyan('Ticket')}: Single implementable unit of work
+• ${chalk.cyan('Pattern')}: Reusable code standards and conventions
+• ${chalk.cyan('Working Context')}: Current focus (project/spec/epic/ticket)
+
+${chalk.bold('Status Flow')}
+${'─'.repeat(50)}
+pending → ready → active → done
+    ↑_______|  (auto-transitions based on dependencies)
+`;
+//# sourceMappingURL=workflow.js.map

package/dist/cli/commands/docs/content/workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.js","sourceRoot":"","sources":["../../../../../src/cli/commands/docs/content/workflow.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,MAAM,CAAC,MAAM,gBAAgB,GAAG;EAC9B,KAAK,CAAC,IAAI,CAAC,mCAAmC,CAAC;EAC/C,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;;EAEd,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC;;;;EAItB,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC;;;;;;EAMzB,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC;;;;;;EAM/B,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC;;;;EAIvB,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC;EAC1B,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;IACZ,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC;IAClB,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC;IACpB,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC;IACrB,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC;;EAE/B,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC;EACzB,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;;;CAGf,CAAC"}

package/dist/cli/commands/docs/content.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Documentation Content Aggregation
+ *
+ * Central module for accessing all documentation content by topic.
+ */
+import type { DocsContent, DocsTopic } from './types.js';
+/**
+ * All documentation content
+ */
+export declare const DOCS: DocsContent;
+/**
+ * Get documentation content for a topic
+ */
+export declare function getDocsContent(topic: DocsTopic): string | undefined;
+/**
+ * Check if a topic is valid
+ */
+export declare function isValidTopic(topic: string): topic is DocsTopic;
+/**
+ * Get all valid topic names
+ */
+export declare function getValidTopics(): DocsTopic[];
+//# sourceMappingURL=content.d.ts.map

package/dist/cli/commands/docs/content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/docs/content.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAMzD;;GAEG;AACH,eAAO,MAAM,IAAI,EAAE,WAMlB,CAAC;AAEF;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS,CAEnE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,SAAS,CAE9D;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,SAAS,EAAE,CAE5C"}

package/dist/cli/commands/docs/content.js

@@ -0,0 +1,38 @@
+/**
+ * Documentation Content Aggregation
+ *
+ * Central module for accessing all documentation content by topic.
+ */
+import { WORKFLOW_CONTENT } from './content/workflow.js';
+import { CONCEPTS_CONTENT } from './content/concepts.js';
+import { API_CONTENT } from './content/api.js';
+import { EXAMPLES_CONTENT } from './content/examples.js';
+/**
+ * All documentation content
+ */
+export const DOCS = {
+    workflow: WORKFLOW_CONTENT,
+    concepts: CONCEPTS_CONTENT,
+    api: API_CONTENT,
+    examples: EXAMPLES_CONTENT,
+    tools: '', // Tools content is generated dynamically
+};
+/**
+ * Get documentation content for a topic
+ */
+export function getDocsContent(topic) {
+    return DOCS[topic];
+}
+/**
+ * Check if a topic is valid
+ */
+export function isValidTopic(topic) {
+    return topic in DOCS;
+}
+/**
+ * Get all valid topic names
+ */
+export function getValidTopics() {
+    return Object.keys(DOCS);
+}
+//# sourceMappingURL=content.js.map

package/dist/cli/commands/docs/content.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content.js","sourceRoot":"","sources":["../../../../src/cli/commands/docs/content.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD;;GAEG;AACH,MAAM,CAAC,MAAM,IAAI,GAAgB;IAC/B,QAAQ,EAAE,gBAAgB;IAC1B,QAAQ,EAAE,gBAAgB;IAC1B,GAAG,EAAE,WAAW;IAChB,QAAQ,EAAE,gBAAgB;IAC1B,KAAK,EAAE,EAAE,EAAE,yCAAyC;CACrD,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,KAAgB;IAC7C,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC;AACrB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,OAAO,KAAK,IAAI,IAAI,CAAC;AACvB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAgB,CAAC;AAC1C,CAAC"}

package/dist/cli/commands/docs/display.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Docs Display Utilities
+ *
+ * Provides consistent display functions for documentation output.
+ */
+/**
+ * Display documentation overview
+ */
+export declare function displayDocsOverview(): void;
+/**
+ * Display topic content
+ */
+export declare function displayTopicContent(content: string): void;
+/**
+ * Display error for unknown topic
+ */
+export declare function displayTopicError(topic: string): void;
+/**
+ * Display search results header
+ */
+export declare function displaySearchHeader(query: string): void;
+/**
+ * Display no results message
+ */
+export declare function displayNoResults(query: string): void;
+//# sourceMappingURL=display.d.ts.map

package/dist/cli/commands/docs/display.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"display.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/docs/display.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAe1C;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAEzD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAGrD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAGvD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAIpD"}