fraim 2.0.100

package/dist/src/cli/commands/list.js

@@ -0,0 +1,57 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listCommand = void 0;
+const commander_1 = require("commander");
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const chalk_1 = __importDefault(require("chalk"));
+const project_fraim_paths_1 = require("../../core/utils/project-fraim-paths");
+function collectRelativeMarkdownPaths(rootDir, currentRelativeDir = '') {
+    if (!fs_1.default.existsSync(rootDir)) {
+        return [];
+    }
+    const results = [];
+    const entries = fs_1.default.readdirSync(rootDir, { withFileTypes: true });
+    for (const entry of entries) {
+        const relativePath = currentRelativeDir
+            ? path_1.default.join(currentRelativeDir, entry.name)
+            : entry.name;
+        const fullPath = path_1.default.join(rootDir, entry.name);
+        if (entry.isDirectory()) {
+            results.push(...collectRelativeMarkdownPaths(fullPath, relativePath));
+            continue;
+        }
+        if (entry.isFile() && entry.name.endsWith('.md')) {
+            results.push(relativePath.replace(/\\/g, '/'));
+        }
+    }
+    return results;
+}
+exports.listCommand = new commander_1.Command('list')
+    .description('List available FRAIM jobs in the project')
+    .action(() => {
+    const projectRoot = process.cwd();
+    const employeeJobsDir = (0, project_fraim_paths_1.getWorkspaceFraimPath)(projectRoot, 'ai-employee', 'jobs');
+    const managerJobsDir = (0, project_fraim_paths_1.getWorkspaceFraimPath)(projectRoot, 'ai-manager', 'jobs');
+    if (!(0, project_fraim_paths_1.workspaceFraimExists)(projectRoot) || (!fs_1.default.existsSync(employeeJobsDir) && !fs_1.default.existsSync(managerJobsDir))) {
+        console.log(chalk_1.default.yellow(`No local job stubs found under ${(0, project_fraim_paths_1.getWorkspaceFraimDisplayPath)('ai-employee/jobs')} or ${(0, project_fraim_paths_1.getWorkspaceFraimDisplayPath)('ai-manager/jobs')}. Run "fraim setup" or "fraim init-project" first.`));
+        return;
+    }
+    const stubs = [
+        ...collectRelativeMarkdownPaths(employeeJobsDir).map(stub => `ai-employee/${stub}`),
+        ...collectRelativeMarkdownPaths(managerJobsDir).map(stub => `ai-manager/${stub}`)
+    ];
+    if (stubs.length === 0) {
+        console.log(chalk_1.default.gray('No jobs found.'));
+        return;
+    }
+    console.log(chalk_1.default.blue(`${stubs.length} Local Jobs Found:`));
+    stubs.sort().forEach(stub => {
+        const jobName = stub.replace('.md', '');
+        console.log(chalk_1.default.white(`  - ${jobName}`));
+    });
+    console.log(chalk_1.default.gray('\nTip: Use these stubs for AI agent discoverability.'));
+});

package/dist/src/cli/commands/login.js

@@ -0,0 +1,84 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loginCommand = void 0;
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+const device_flow_service_1 = require("../internal/device-flow-service");
+const provider_client_1 = require("../api/provider-client");
+const script_sync_utils_1 = require("../utils/script-sync-utils");
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const version_utils_1 = require("../utils/version-utils");
+const auto_mcp_setup_1 = require("../setup/auto-mcp-setup");
+exports.loginCommand = new commander_1.Command('login')
+    .description('Login to platforms (GitHub, etc.)');
+exports.loginCommand
+    .command('github')
+    .description('Login to GitHub using Device Flow')
+    .action(async () => {
+    // Load the token to global config
+    const globalConfigDir = (0, script_sync_utils_1.getUserFraimDir)();
+    const globalConfigPath = path_1.default.join(globalConfigDir, 'config.json');
+    let config = {};
+    if (fs_1.default.existsSync(globalConfigPath)) {
+        config = JSON.parse(fs_1.default.readFileSync(globalConfigPath, 'utf8'));
+    }
+    if (!config.apiKey) {
+        console.error(chalk_1.default.red('\n❌ No FRAIM API key found. Please run "fraim setup" first.'));
+        process.exit(1);
+    }
+    const client = new provider_client_1.ProviderClient(config.apiKey);
+    let githubConfig;
+    try {
+        const providers = await client.getAllProviders();
+        githubConfig = providers.find(p => p.id === 'github')?.deviceFlowConfig;
+        if (!githubConfig) {
+            console.error(chalk_1.default.red('\n❌ Device flow configuration for GitHub not found on server.'));
+            process.exit(1);
+        }
+    }
+    catch (error) {
+        console.error(chalk_1.default.red(`\n❌ Failed to fetch provider configuration: ${error.message}`));
+        process.exit(1);
+    }
+    const deviceFlow = new device_flow_service_1.DeviceFlowService(githubConfig);
+    try {
+        const token = await deviceFlow.login();
+        config.tokens = {
+            ...(config.tokens || {}),
+            github: token
+        };
+        config.version = config.version || (0, version_utils_1.getFraimVersion)();
+        config.updatedAt = new Date().toISOString();
+        fs_1.default.writeFileSync(globalConfigPath, JSON.stringify(config, null, 2));
+        console.log(chalk_1.default.green('\n✅ GitHub token saved to global configuration.'));
+        // Trigger MCP reconfiguration
+        if (config.apiKey) {
+            console.log(chalk_1.default.blue('🔌 Updating MCP server configurations...'));
+            const mcpTokens = {};
+            Object.entries(config.tokens).forEach(([id, t]) => {
+                mcpTokens[id] = t;
+            });
+            // Re-use existing provider configs if any
+            const providerConfigsMap = {};
+            if (config.providerConfigs) {
+                Object.entries(config.providerConfigs).forEach(([key, val]) => {
+                    const providerId = key.replace('Config', '');
+                    providerConfigsMap[providerId] = val;
+                });
+            }
+            await (0, auto_mcp_setup_1.autoConfigureMCP)(config.apiKey, mcpTokens, undefined, providerConfigsMap);
+            console.log(chalk_1.default.green('✅ MCP servers updated with new GitHub token.'));
+        }
+        else {
+            console.log(chalk_1.default.yellow('⚠️  No FRAIM API key found. Run "fraim setup" to complete configuration.'));
+        }
+    }
+    catch (error) {
+        console.error(chalk_1.default.red(`\n❌ Login failed: ${error.message}`));
+        process.exit(1);
+    }
+});

package/dist/src/cli/commands/mcp.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mcpCommand = void 0;
+const commander_1 = require("commander");
+const stdio_server_1 = require("../../local-mcp-server/stdio-server");
+/**
+ * mcpCommand - Entry point for starting the local FRAIM MCP server.
+ * This integrates the local-mcp-server into the main CLI.
+ */
+exports.mcpCommand = new commander_1.Command('mcp')
+    .description('Start the local FRAIM MCP server (stdio)')
+    .action(() => {
+    const server = new stdio_server_1.FraimLocalMCPServer();
+    server.start();
+});

package/dist/src/cli/commands/migrate-project-fraim.js

@@ -0,0 +1,42 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.migrateProjectFraimCommand = exports.runMigrateProjectFraim = void 0;
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+const project_fraim_migration_1 = require("../../core/utils/project-fraim-migration");
+const runMigrateProjectFraim = async () => {
+    const result = (0, project_fraim_migration_1.migrateLegacyProjectFraimDir)(process.cwd());
+    if (!result.legacyDirFound) {
+        console.log(chalk_1.default.gray('No project .fraim directory found. Nothing to migrate.'));
+        return;
+    }
+    if (result.migratedPaths.length === 0 && result.prunedLegacyPaths.length === 0 && result.conflictPaths.length === 0) {
+        console.log(chalk_1.default.gray('No migratable legacy FRAIM content found in project .fraim/.'));
+        return;
+    }
+    if (result.migratedPaths.length > 0) {
+        console.log(chalk_1.default.green(`Migrated into fraim/: ${result.migratedPaths.join(', ')}`));
+    }
+    if (result.prunedLegacyPaths.length > 0) {
+        console.log(chalk_1.default.green(`Removed legacy synced content from project .fraim/: ${result.prunedLegacyPaths.join(', ')}`));
+    }
+    if (result.conflictPaths.length > 0) {
+        console.log(chalk_1.default.yellow(`Conflicts left in project .fraim/: ${result.conflictPaths.join(', ')}`));
+        console.log(chalk_1.default.yellow('Review those files and make sure the canonical version in fraim/ is correct before deleting project .fraim/.'));
+        return;
+    }
+    if (result.legacyDirReadyForDeletion) {
+        console.log(chalk_1.default.green('Migration complete. Everything that FRAIM still uses is now under fraim/.'));
+        console.log(chalk_1.default.yellow('You can now delete the project .fraim/ folder.'));
+        return;
+    }
+    console.log(chalk_1.default.green('Migration complete. Everything that FRAIM still uses is now under fraim/.'));
+    console.log(chalk_1.default.yellow('After you verify the migrated files, delete the project .fraim/ folder.'));
+};
+exports.runMigrateProjectFraim = runMigrateProjectFraim;
+exports.migrateProjectFraimCommand = new commander_1.Command('migrate-project-fraim')
+    .description('One-time migration from project .fraim/ to fraim/')
+    .action(exports.runMigrateProjectFraim);

package/dist/src/cli/commands/override.js

@@ -0,0 +1,177 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.overrideCommand = void 0;
+const commander_1 = require("commander");
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const chalk_1 = __importDefault(require("chalk"));
+const axios_1 = __importDefault(require("axios"));
+const git_utils_1 = require("../../core/utils/git-utils");
+const project_fraim_paths_1 = require("../../core/utils/project-fraim-paths");
+exports.overrideCommand = new commander_1.Command('override')
+    .description('Create a local override for a FRAIM registry file')
+    .argument('<path>', 'Registry path to override (e.g., jobs/product-building/spec.md)')
+    .option('--inherit', 'Create override with {{ import }} directive (inherits from global)')
+    .option('--copy', 'Copy current content from server to local')
+    .option('--local', 'Fetch from local development server (port derived from git branch)')
+    .action(async (registryPath, options) => {
+    const projectRoot = process.cwd();
+    const configPath = (0, project_fraim_paths_1.getWorkspaceConfigPath)(projectRoot);
+    const personalizedRootDisplayPath = (0, project_fraim_paths_1.getWorkspaceFraimDisplayPath)('personalized-employee');
+    if (!(0, project_fraim_paths_1.workspaceFraimExists)(projectRoot)) {
+        console.log(chalk_1.default.red(`❌ ${(0, project_fraim_paths_1.getWorkspaceFraimDisplayPath)()} directory not found. Run "fraim setup" or "fraim init-project" first.`));
+        process.exit(1);
+    }
+    if (registryPath.includes('..') || path_1.default.isAbsolute(registryPath)) {
+        console.log(chalk_1.default.red('❌ Invalid path. Path must be relative and cannot contain ".."'));
+        process.exit(1);
+    }
+    if (options.inherit && options.copy) {
+        console.log(chalk_1.default.red('❌ Cannot use both --inherit and --copy. Choose one.'));
+        process.exit(1);
+    }
+    if (!options.inherit && !options.copy) {
+        console.log(chalk_1.default.red('❌ Must specify either --inherit or --copy.'));
+        process.exit(1);
+    }
+    const overridePath = (0, project_fraim_paths_1.getWorkspaceFraimPath)(projectRoot, 'personalized-employee', registryPath);
+    const overrideDir = path_1.default.dirname(overridePath);
+    if (!fs_1.default.existsSync(overrideDir)) {
+        fs_1.default.mkdirSync(overrideDir, { recursive: true });
+    }
+    if (fs_1.default.existsSync(overridePath)) {
+        console.log(chalk_1.default.yellow(`⚠️ Override already exists: ${registryPath}`));
+        console.log(chalk_1.default.gray(`   Location: ${overridePath}`));
+        process.exit(0);
+    }
+    let content;
+    if (options.inherit) {
+        content = `{{ import: ${registryPath} }}\n\n<!-- Add your custom content below -->\n`;
+        console.log(chalk_1.default.blue(`Creating inherited override for: ${registryPath}`));
+    }
+    else {
+        const isLocal = options.local || false;
+        const serverType = isLocal ? 'local server' : 'remote server';
+        console.log(chalk_1.default.blue(`Fetching current content from ${serverType}: ${registryPath}`));
+        try {
+            let config = {};
+            if (fs_1.default.existsSync(configPath)) {
+                config = JSON.parse(fs_1.default.readFileSync(configPath, 'utf-8'));
+            }
+            let serverUrl;
+            if (isLocal) {
+                const localPort = process.env.FRAIM_MCP_PORT ? parseInt(process.env.FRAIM_MCP_PORT) : (0, git_utils_1.getPort)();
+                serverUrl = `http://localhost:${localPort}`;
+            }
+            else {
+                serverUrl = config.remoteUrl || process.env.FRAIM_REMOTE_URL || 'https://fraim.wellnessatwork.me';
+            }
+            const apiKey = isLocal ? 'local-dev' : (config.apiKey || process.env.FRAIM_API_KEY);
+            const headers = { 'Content-Type': 'application/json' };
+            if (apiKey) {
+                headers['x-api-key'] = apiKey;
+            }
+            const connectRequest = {
+                jsonrpc: '2.0',
+                id: 0,
+                method: 'tools/call',
+                params: {
+                    name: 'fraim_connect',
+                    arguments: {
+                        agent: { name: 'fraim-cli', model: 'override-command' },
+                        machine: {
+                            hostname: require('os').hostname(),
+                            platform: process.platform,
+                            memory: require('os').totalmem(),
+                            cpus: require('os').cpus().length
+                        },
+                        repo: {
+                            url: config.repository?.url || 'https://github.com/unknown/unknown',
+                            owner: config.repository?.owner || 'unknown',
+                            name: config.repository?.name || 'unknown',
+                            branch: 'main'
+                        }
+                    }
+                }
+            };
+            const connectResponse = await axios_1.default.post(`${serverUrl}/mcp`, connectRequest, { headers, timeout: 30000 });
+            const sessionId = connectResponse.data?.result?.sessionId;
+            if (typeof sessionId !== 'string' || sessionId.trim().length === 0) {
+                throw new Error('fraim_connect did not return a sessionId');
+            }
+            let toolName;
+            let toolArgs;
+            if (registryPath.startsWith('workflows/')) {
+                const parts = registryPath.split('/');
+                const workflowName = parts[parts.length - 1].replace('.md', '');
+                toolName = 'get_fraim_workflow';
+                toolArgs = { workflow: workflowName };
+            }
+            else if (registryPath.startsWith('jobs/')) {
+                const parts = registryPath.split('/');
+                const jobName = parts[parts.length - 1].replace('.md', '');
+                toolName = 'get_fraim_job';
+                toolArgs = { job: jobName };
+            }
+            else {
+                toolName = 'get_fraim_file';
+                toolArgs = { path: registryPath };
+            }
+            console.log(chalk_1.default.gray(`   Using MCP tool: ${toolName}`));
+            const mcpRequest = {
+                jsonrpc: '2.0',
+                id: 1,
+                method: 'tools/call',
+                params: {
+                    name: toolName,
+                    sessionId: sessionId.trim(),
+                    arguments: {
+                        ...toolArgs,
+                        sessionId: sessionId.trim()
+                    }
+                }
+            };
+            const response = await axios_1.default.post(`${serverUrl}/mcp`, mcpRequest, {
+                headers,
+                timeout: 30000
+            });
+            if (response.data.error) {
+                throw new Error(response.data.error.message || 'MCP request failed');
+            }
+            const result = response.data.result;
+            if (!result || !result.content || !Array.isArray(result.content)) {
+                throw new Error('Unexpected MCP response format');
+            }
+            const textContent = result.content.find((c) => c.type === 'text');
+            if (!textContent || !textContent.text) {
+                throw new Error('No text content in MCP response');
+            }
+            content = textContent.text;
+            console.log(chalk_1.default.green(`✅ Fetched ${content.length} bytes from ${serverType}`));
+        }
+        catch (error) {
+            console.log(chalk_1.default.red(`❌ Failed to fetch content from ${serverType}: ${error.message}`));
+            if (isLocal) {
+                console.log(chalk_1.default.gray('   Tip: Make sure the FRAIM server is running locally (npm run start:fraim)'));
+            }
+            else {
+                console.log(chalk_1.default.gray('   Tip: Check your API key and network connection'));
+                console.log(chalk_1.default.gray('   Or use --local to fetch from a locally running server'));
+            }
+            process.exit(1);
+        }
+    }
+    try {
+        fs_1.default.writeFileSync(overridePath, content, 'utf-8');
+        console.log(chalk_1.default.green(`✅ Created override: ${registryPath}`));
+        console.log(chalk_1.default.gray(`   Location: ${overridePath}`));
+        console.log(chalk_1.default.gray(`   Overrides are stored in ${personalizedRootDisplayPath}`));
+    }
+    catch (error) {
+        console.log(chalk_1.default.red(`❌ Failed to write override file: ${error.message}`));
+        process.exit(1);
+    }
+});