@mytechtoday/augment-extensions 0.2.0 → 0.5.0

package/cli/dist/utils/mcp-integration.js

@@ -0,0 +1,292 @@
+"use strict";
+/**
+ * MCP Integration Utilities
+ *
+ * Provides integration with Model Context Protocol (MCP) servers
+ * using mcporter-inspired patterns for CLI wrapping.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getMCPConfigDir = getMCPConfigDir;
+exports.loadMCPConfigs = loadMCPConfigs;
+exports.saveMCPConfigs = saveMCPConfigs;
+exports.addMCPServer = addMCPServer;
+exports.removeMCPServer = removeMCPServer;
+exports.executeMCPCommand = executeMCPCommand;
+exports.generateMCPSkillWrapper = generateMCPSkillWrapper;
+exports.discoverMCPTools = discoverMCPTools;
+exports.isMCPorterAvailable = isMCPorterAvailable;
+exports.generateCLIWithMCPorter = generateCLIWithMCPorter;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const child_process_1 = require("child_process");
+/**
+ * Get MCP configuration directory
+ */
+function getMCPConfigDir(repoRoot) {
+    const root = repoRoot || process.cwd();
+    return path.join(root, '.augment', 'mcp');
+}
+/**
+ * Load MCP server configurations
+ */
+function loadMCPConfigs(repoRoot) {
+    const configDir = getMCPConfigDir(repoRoot);
+    const configFile = path.join(configDir, 'servers.json');
+    if (!fs.existsSync(configFile)) {
+        return [];
+    }
+    try {
+        const content = fs.readFileSync(configFile, 'utf-8');
+        const config = JSON.parse(content);
+        return config.servers || [];
+    }
+    catch (error) {
+        console.warn(`Failed to load MCP configs: ${error}`);
+        return [];
+    }
+}
+/**
+ * Save MCP server configurations
+ */
+function saveMCPConfigs(configs, repoRoot) {
+    const configDir = getMCPConfigDir(repoRoot);
+    const configFile = path.join(configDir, 'servers.json');
+    // Ensure directory exists
+    if (!fs.existsSync(configDir)) {
+        fs.mkdirSync(configDir, { recursive: true });
+    }
+    fs.writeFileSync(configFile, JSON.stringify({ servers: configs }, null, 2), 'utf-8');
+}
+/**
+ * Add MCP server configuration
+ */
+function addMCPServer(config, repoRoot) {
+    const configs = loadMCPConfigs(repoRoot);
+    // Check if server already exists
+    const existing = configs.findIndex(c => c.name === config.name);
+    if (existing >= 0) {
+        configs[existing] = config;
+    }
+    else {
+        configs.push(config);
+    }
+    saveMCPConfigs(configs, repoRoot);
+}
+/**
+ * Remove MCP server configuration
+ */
+function removeMCPServer(name, repoRoot) {
+    const configs = loadMCPConfigs(repoRoot);
+    const filtered = configs.filter(c => c.name !== name);
+    if (filtered.length === configs.length) {
+        return false; // Server not found
+    }
+    saveMCPConfigs(filtered, repoRoot);
+    return true;
+}
+/**
+ * Execute MCP server command (stdio transport)
+ */
+function executeMCPCommand(serverName, toolName, args, repoRoot) {
+    return new Promise((resolve, reject) => {
+        const configs = loadMCPConfigs(repoRoot);
+        const config = configs.find(c => c.name === serverName);
+        if (!config) {
+            reject(new Error(`MCP server not found: ${serverName}`));
+            return;
+        }
+        if (config.transport !== 'stdio') {
+            reject(new Error(`Only stdio transport is currently supported`));
+            return;
+        }
+        // Spawn the MCP server process
+        const child = (0, child_process_1.spawn)(config.command, config.args || [], {
+            stdio: ['pipe', 'pipe', 'pipe'],
+            env: { ...process.env, ...config.env }
+        });
+        let stdout = '';
+        let stderr = '';
+        child.stdout?.on('data', (data) => {
+            stdout += data.toString();
+        });
+        child.stderr?.on('data', (data) => {
+            stderr += data.toString();
+        });
+        child.on('error', (error) => {
+            reject(new Error(`Failed to spawn MCP server: ${error.message}`));
+        });
+        child.on('exit', (code) => {
+            if (code !== 0) {
+                reject(new Error(`MCP server exited with code ${code}\nStderr: ${stderr}`));
+                return;
+            }
+            try {
+                // Parse JSON-RPC response
+                const response = JSON.parse(stdout);
+                resolve(response);
+            }
+            catch (error) {
+                reject(new Error(`Failed to parse MCP response: ${error}\nStdout: ${stdout}`));
+            }
+        });
+        // Send JSON-RPC request
+        const request = {
+            jsonrpc: '2.0',
+            id: 1,
+            method: `tools/${toolName}`,
+            params: args
+        };
+        child.stdin?.write(JSON.stringify(request) + '\n');
+        child.stdin?.end();
+    });
+}
+/**
+ * Generate CLI wrapper for MCP server
+ *
+ * This creates a skill file that wraps an MCP server tool as a CLI command.
+ */
+function generateMCPSkillWrapper(serverName, toolName, skillId, category, repoRoot) {
+    const configs = loadMCPConfigs(repoRoot);
+    const config = configs.find(c => c.name === serverName);
+    if (!config) {
+        throw new Error(`MCP server not found: ${serverName}`);
+    }
+    // Generate skill file content
+    const skillContent = `---
+id: ${skillId}
+name: ${toolName} (MCP)
+version: 1.0.0
+category: ${category}
+tags: [mcp, ${serverName}, ${toolName}]
+tokenBudget: 1500
+priority: medium
+dependencies: []
+cliCommand: augx mcp exec ${serverName} ${toolName}
+mcpServer: ${serverName}
+autoLoad: false
+---
+
+# ${toolName} (MCP Tool)
+
+## Purpose
+
+This skill wraps the \`${toolName}\` tool from the \`${serverName}\` MCP server.
+
+## Usage
+
+Execute this skill using the MCP integration:
+
+\`\`\`bash
+augx mcp exec ${serverName} ${toolName} --args '{"key": "value"}'
+\`\`\`
+
+Or inject into context:
+
+\`\`\`bash
+augx skill inject ${skillId}
+\`\`\`
+
+## MCP Server Configuration
+
+- **Server**: ${serverName}
+- **Transport**: ${config.transport}
+- **Command**: ${config.command}
+
+## Notes
+
+This is an auto-generated skill wrapper for an MCP server tool.
+The actual tool execution is handled by the MCP integration layer.
+`;
+    return skillContent;
+}
+/**
+ * Discover available MCP tools from a server
+ *
+ * Note: This is a simplified version. Full implementation would require
+ * proper MCP protocol negotiation and tool discovery.
+ */
+async function discoverMCPTools(serverName, repoRoot) {
+    // Placeholder implementation
+    // In a full implementation, this would:
+    // 1. Connect to the MCP server
+    // 2. Send a tools/list request
+    // 3. Parse the response
+    // 4. Return the list of available tools
+    console.warn('MCP tool discovery not yet fully implemented');
+    return [];
+}
+/**
+ * Check if mcporter is available
+ */
+function isMCPorterAvailable() {
+    try {
+        const { execSync } = require('child_process');
+        execSync('npx mcporter --version', { stdio: 'ignore' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Generate CLI using mcporter (if available)
+ */
+async function generateCLIWithMCPorter(serverCommand, outputPath) {
+    const { spawn } = require('child_process');
+    return new Promise((resolve, reject) => {
+        const child = spawn('npx', [
+            'mcporter',
+            'generate-cli',
+            '--command',
+            serverCommand,
+            '--bundle',
+            outputPath
+        ], {
+            stdio: 'inherit'
+        });
+        child.on('error', (error) => {
+            reject(new Error(`Failed to run mcporter: ${error.message}`));
+        });
+        child.on('exit', (code) => {
+            if (code !== 0) {
+                reject(new Error(`mcporter exited with code ${code}`));
+                return;
+            }
+            resolve();
+        });
+    });
+}
+//# sourceMappingURL=mcp-integration.js.map

package/cli/dist/utils/mcp-integration.js.map

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

package/cli/dist/utils/module-system.d.ts

@@ -0,0 +1,232 @@
+/**
+ * Module metadata interface
+ */
+export interface ModuleMetadata {
+    name: string;
+    version: string;
+    displayName: string;
+    description: string;
+    type: 'coding-standards' | 'domain-rules' | 'workflows' | 'examples' | 'marketing-standards' | 'writing-standards' | 'themes';
+    tags?: string[];
+    augment?: {
+        characterCount?: number;
+        priority?: 'high' | 'medium' | 'low';
+        category?: string;
+    };
+    installation?: 'required' | 'optional';
+    dependencies?: string[];
+}
+/**
+ * Module structure interface
+ */
+export interface Module {
+    metadata: ModuleMetadata;
+    path: string;
+    fullName: string;
+    rules: string[];
+    examples: string[];
+}
+/**
+ * Validation result interface
+ */
+export interface ValidationResult {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+}
+/**
+ * Get the modules directory path
+ */
+export declare function getModulesDir(): string;
+/**
+ * Validate module.json structure
+ */
+export declare function validateModuleMetadata(metadata: any): ValidationResult;
+/**
+ * Validate semantic version format
+ * Supports: MAJOR.MINOR.PATCH[-prerelease][+build]
+ * Examples: 1.0.0, 1.0.0-alpha, 1.0.0-beta.1, 1.0.0+20130313144700, 1.0.0-beta+exp.sha.5114f85
+ */
+export declare function isValidSemanticVersion(version: string): boolean;
+/**
+ * Parse semantic version into components
+ */
+export interface SemanticVersion {
+    major: number;
+    minor: number;
+    patch: number;
+    prerelease?: string;
+    build?: string;
+}
+export declare function parseSemanticVersion(version: string): SemanticVersion | null;
+/**
+ * Compare two semantic versions
+ * Returns: -1 if v1 < v2, 0 if v1 === v2, 1 if v1 > v2
+ */
+export declare function compareSemanticVersions(v1: string, v2: string): number;
+/**
+ * Check if version satisfies a range (simple implementation)
+ * Supports: ^1.0.0 (compatible), ~1.0.0 (patch), >=1.0.0, >1.0.0, <=1.0.0, <1.0.0, 1.0.0 (exact)
+ */
+export declare function satisfiesVersionRange(version: string, range: string): boolean;
+/**
+ * Load module from path
+ */
+export declare function loadModule(modulePath: string): Module | null;
+/**
+ * Extended module metadata with file information
+ */
+export interface ExtendedModuleMetadata extends ModuleMetadata {
+    files?: {
+        total: number;
+        rules: number;
+        examples: number;
+        other: number;
+    };
+    size?: {
+        totalBytes: number;
+        totalCharacters: number;
+    };
+    lastModified?: Date;
+}
+/**
+ * Extract comprehensive metadata from a module
+ * Includes file counts, sizes, and last modified dates
+ */
+export declare function extractModuleMetadata(modulePath: string): ExtendedModuleMetadata | null;
+/**
+ * Generate default metadata for modules without module.json
+ */
+export declare function generateDefaultMetadata(modulePath: string): ModuleMetadata;
+/**
+ * File information interface
+ */
+export interface FileInfo {
+    name: string;
+    path: string;
+    relativePath: string;
+    size: number;
+    modified: Date;
+    type: 'rule' | 'example' | 'config' | 'documentation' | 'other';
+    extension: string;
+    directory: string;
+}
+/**
+ * List all files in a module with metadata
+ */
+export declare function listModuleFiles(modulePath: string, options?: {
+    recursive?: boolean;
+    filter?: string;
+    groupByDirectory?: boolean;
+}): FileInfo[];
+/**
+ * Group files by directory
+ */
+export declare function groupFilesByDirectory(files: FileInfo[]): Map<string, FileInfo[]>;
+/**
+ * Get file statistics for a list of files
+ */
+export declare function getFileStatistics(files: FileInfo[]): {
+    totalFiles: number;
+    totalSize: number;
+    byType: Record<FileInfo['type'], number>;
+    byExtension: Record<string, number>;
+};
+/**
+ * Discover all modules in the modules directory
+ */
+export declare function discoverModules(): Module[];
+/**
+ * Collection metadata interface
+ */
+export interface CollectionMetadata {
+    name: string;
+    version: string;
+    displayName: string;
+    description: string;
+    type: 'collection';
+    tags?: string[];
+    modules: Array<{
+        id: string;
+        version: string;
+        required: boolean;
+    }>;
+    augment?: {
+        priority?: 'high' | 'medium' | 'low';
+        category?: string;
+    };
+}
+/**
+ * Collection structure interface
+ */
+export interface Collection {
+    metadata: CollectionMetadata;
+    path: string;
+    fullName: string;
+}
+/**
+ * Discover all collections in the collections directory
+ */
+export declare function discoverCollections(): Collection[];
+/**
+ * Find module by name (supports both "category/module" and "module" formats)
+ */
+export declare function findModule(moduleName: string): Module | null;
+/**
+ * Search for modules by name with fuzzy matching
+ * Supports exact, partial, and case-insensitive matching
+ */
+export interface ModuleSearchOptions {
+    caseSensitive?: boolean;
+    exactMatch?: boolean;
+    category?: string;
+}
+export declare function searchModules(searchTerm: string, options?: ModuleSearchOptions): Module[];
+/**
+ * Find module with enhanced discovery
+ * Tries exact match first, then falls back to fuzzy search
+ */
+export declare function findModuleEnhanced(moduleName: string): Module | null;
+/**
+ * Get module suggestions for a search term
+ * Returns up to maxSuggestions similar modules
+ */
+export declare function getModuleSuggestions(searchTerm: string, maxSuggestions?: number): Module[];
+/**
+ * Find collection by name (supports both "collections/name" and "name" formats)
+ */
+export declare function findCollection(collectionName: string): Collection | null;
+/**
+ * Resolve collection to its constituent modules
+ * Returns array of module IDs that are part of the collection
+ */
+export declare function resolveCollection(collection: Collection): string[];
+/**
+ * Resolve collection by name to its constituent modules
+ */
+export declare function resolveCollectionByName(collectionName: string): string[] | null;
+/**
+ * Check if a name refers to a collection
+ */
+export declare function isCollection(name: string): boolean;
+/**
+ * Check if a name refers to a module
+ */
+export declare function isModule(name: string): boolean;
+/**
+ * Validate module structure
+ */
+export declare function validateModuleStructure(modulePath: string): ValidationResult;
+/**
+ * Validate module category matches directory structure
+ */
+export declare function validateModuleCategory(module: Module): ValidationResult;
+/**
+ * Calculate character count for a module
+ */
+export declare function calculateModuleCharacterCount(modulePath: string): number;
+/**
+ * Validate module is project-agnostic (no hardcoded paths or URLs)
+ */
+export declare function validateProjectAgnostic(modulePath: string): ValidationResult;
+//# sourceMappingURL=module-system.d.ts.map

package/cli/dist/utils/module-system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-system.d.ts","sourceRoot":"","sources":["../../src/utils/module-system.ts"],"names":[],"mappings":"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"}