fraim 2.0.203 → 2.0.205

package/dist/src/cli/setup/first-run.js

@@ -1,242 +0,0 @@
-"use strict";
-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;
-    };
-})();
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.runFirstRunExperience = void 0;
-const prompts_1 = __importDefault(require("prompts"));
-const chalk_1 = __importDefault(require("chalk"));
-const fs_1 = __importDefault(require("fs"));
-const path_1 = __importDefault(require("path"));
-const os_1 = __importDefault(require("os"));
-const script_sync_utils_1 = require("../utils/script-sync-utils");
-const project_fraim_paths_1 = require("../../core/utils/project-fraim-paths");
-const loadGlobalConfig = () => {
-    const globalConfigPath = path_1.default.join((0, script_sync_utils_1.getUserFraimDir)(), 'config.json');
-    if (!fs_1.default.existsSync(globalConfigPath)) {
-        return null;
-    }
-    try {
-        const config = JSON.parse(fs_1.default.readFileSync(globalConfigPath, 'utf8'));
-        return {
-            fraimKey: config.apiKey,
-            githubToken: config.githubToken
-        };
-    }
-    catch (e) {
-        return null;
-    }
-};
-const checkMCPConfigurations = () => {
-    const sources = [];
-    // Check Kiro MCP config
-    const kiroConfigPath = path_1.default.join(os_1.default.homedir(), '.kiro', 'settings', 'mcp.json');
-    if (fs_1.default.existsSync(kiroConfigPath)) {
-        try {
-            const kiroConfig = JSON.parse(fs_1.default.readFileSync(kiroConfigPath, 'utf8'));
-            if (kiroConfig.mcpServers?.fraim) {
-                sources.push('Kiro');
-            }
-        }
-        catch (e) {
-            // Ignore parsing errors
-        }
-    }
-    // Check Claude Desktop / Cowork config
-    const claudeConfigPath = path_1.default.join(os_1.default.homedir(), 'AppData', 'Roaming', 'Claude', 'claude_desktop_config.json');
-    if (fs_1.default.existsSync(claudeConfigPath)) {
-        try {
-            const claudeConfig = JSON.parse(fs_1.default.readFileSync(claudeConfigPath, 'utf8'));
-            if (claudeConfig.mcpServers?.fraim) {
-                sources.push('Claude Desktop / Cowork');
-            }
-        }
-        catch (e) {
-            // Ignore parsing errors
-        }
-    }
-    // Check macOS Claude Desktop / Cowork config path
-    const claudeMacPath = path_1.default.join(os_1.default.homedir(), 'Library', 'Application Support', 'Claude', 'claude_desktop_config.json');
-    if (fs_1.default.existsSync(claudeMacPath)) {
-        try {
-            const claudeConfig = JSON.parse(fs_1.default.readFileSync(claudeMacPath, 'utf8'));
-            if (claudeConfig.mcpServers?.fraim) {
-                sources.push('Claude Desktop / Cowork (macOS)');
-            }
-        }
-        catch (e) {
-            // Ignore parsing errors
-        }
-    }
-    // Check VS Code MCP config (uses "servers" key)
-    const vscodePaths = [
-        path_1.default.join(os_1.default.homedir(), 'AppData', 'Roaming', 'Code', 'User', 'mcp.json'),
-        path_1.default.join(os_1.default.homedir(), 'Library', 'Application Support', 'Code', 'User', 'mcp.json'),
-        path_1.default.join(os_1.default.homedir(), '.config', 'Code', 'User', 'mcp.json')
-    ];
-    for (const vscodePath of vscodePaths) {
-        if (fs_1.default.existsSync(vscodePath)) {
-            try {
-                const vscodeConfig = JSON.parse(fs_1.default.readFileSync(vscodePath, 'utf8'));
-                if (vscodeConfig.servers?.fraim) {
-                    sources.push('VSCode');
-                    break;
-                }
-            }
-            catch (e) {
-                // Ignore parsing errors
-            }
-        }
-    }
-    return {
-        found: sources.length > 0,
-        sources
-    };
-};
-const runFirstRunExperience = async () => {
-    // Skip interactive setup in CI/Test environments
-    if (process.env.CI === 'true' || process.env.TEST_MODE === 'true') {
-        console.log(chalk_1.default.yellow('ℹ️  Skipping interactive first-run experience (CI/TEST_MODE detected)'));
-        return;
-    }
-    console.log(chalk_1.default.blue('\n👋 Welcome to FRAIM! Let\'s get you set up.\n'));
-    // Check for existing configuration
-    const globalConfig = loadGlobalConfig();
-    const mcpCheck = checkMCPConfigurations();
-    if (globalConfig && globalConfig.fraimKey) {
-        console.log(chalk_1.default.green('✅ Found existing FRAIM configuration'));
-        if (mcpCheck.found) {
-            console.log(chalk_1.default.green(`✅ Found FRAIM MCP configuration in: ${mcpCheck.sources.join(', ')}`));
-            console.log(chalk_1.default.blue('🎉 You\'re all set! FRAIM is ready to use.\n'));
-        }
-        else {
-            console.log(chalk_1.default.yellow('⚠️  FRAIM key found but no MCP configuration detected.'));
-            console.log(chalk_1.default.cyan('💡 Consider running "fraim add-ide" to configure your IDE.\n'));
-        }
-    }
-    else if (mcpCheck.found) {
-        console.log(chalk_1.default.green(`✅ Found FRAIM MCP configuration in: ${mcpCheck.sources.join(', ')}`));
-        console.log(chalk_1.default.yellow('⚠️  But no global FRAIM configuration found.'));
-        console.log(chalk_1.default.cyan('💡 Your MCP setup looks good! Skipping key setup.\n'));
-    }
-    else {
-        // No existing configuration found - ask for FRAIM key
-        console.log(chalk_1.default.yellow('🔍 No existing FRAIM configuration detected.\n'));
-        let response;
-        try {
-            response = await (0, prompts_1.default)({
-                type: 'text',
-                name: 'fraimKey',
-                message: 'Do you have a FRAIM key? (Input key or press Enter to skip)',
-                validate: (value) => true // Optional input
-            });
-        }
-        catch (e) {
-            console.warn(chalk_1.default.yellow('\n⚠️  Interactive prompts experienced an issue. Skipping setup.\n'));
-            return;
-        }
-        if (response.fraimKey && response.fraimKey.trim().length > 0) {
-            const key = response.fraimKey.trim();
-            console.log(chalk_1.default.green('\n✅ Key received.'));
-            console.log(chalk_1.default.yellow('\nPlease add the following to your IDE\'s MCP config (e.g. claude_desktop_config.json):'));
-            const mcpConfig = {
-                mcpServers: {
-                    fraim: {
-                        serverUrl: "https://fraim.wellnessatwork.me",
-                        headers: {
-                            "x-api-key": key
-                        }
-                    }
-                }
-            };
-            console.log(chalk_1.default.cyan(JSON.stringify(mcpConfig, null, 2)));
-            console.log('\n');
-        }
-        else {
-            console.log(chalk_1.default.yellow('\nℹ️  If you need a key, please email sid.mathur@gmail.com to request one.\n'));
-        }
-    }
-    // 2. Ask about Architecture Document
-    const archResponse = await (0, prompts_1.default)({
-        type: 'confirm',
-        name: 'hasArchDoc',
-        message: 'Do you have an architecture document for this project?',
-        initial: false
-    });
-    if (!archResponse.hasArchDoc) {
-        console.log(chalk_1.default.yellow('\n💡 To create an architecture document, please ask your IDE Agent:'));
-        console.log(chalk_1.default.cyan('  "Run the bootstrap/create-architecture workflow"'));
-        console.log(chalk_1.default.gray('  (This ensures your agent understands your codebase structure)\n'));
-    }
-    else {
-        const pathResponse = await (0, prompts_1.default)({
-            type: 'text',
-            name: 'archDocPath',
-            message: 'Please provide the relative path to your architecture document:',
-            initial: 'docs/architecture.md',
-            validate: (value) => value.length > 0 ? true : 'Path cannot be empty'
-        });
-        if (pathResponse.archDocPath) {
-            const fs = await Promise.resolve().then(() => __importStar(require('fs')));
-            const path = await Promise.resolve().then(() => __importStar(require('path')));
-            const resolvedPath = path.resolve(process.cwd(), pathResponse.archDocPath);
-            if (fs.existsSync(resolvedPath)) {
-                try {
-                    const configPath = (0, project_fraim_paths_1.getWorkspaceConfigPath)(process.cwd());
-                    if (fs.existsSync(configPath)) {
-                        const configContent = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
-                        if (!configContent.customizations)
-                            configContent.customizations = {};
-                        configContent.customizations.architectureDoc = pathResponse.archDocPath;
-                        fs.writeFileSync(configPath, JSON.stringify(configContent, null, 2));
-                        console.log(chalk_1.default.green(`\n✅ Linked architecture document: ${pathResponse.archDocPath}`));
-                    }
-                    else {
-                        console.log(chalk_1.default.red(`\n❌ ${(0, project_fraim_paths_1.getWorkspaceFraimDisplayPath)('config.json')} not found. Could not save preference.`));
-                    }
-                }
-                catch (e) {
-                    console.error(chalk_1.default.red('\n❌ Failed to update config:'), e);
-                }
-            }
-            else {
-                console.log(chalk_1.default.yellow(`\n⚠️  File not found at ${pathResponse.archDocPath}. We'll skip linking it for now.`));
-            }
-        }
-    }
-    console.log(chalk_1.default.green(`\n✅ Jobs are installed in ${(0, project_fraim_paths_1.getWorkspaceFraimDisplayPath)('ai-employee/jobs')} and ${(0, project_fraim_paths_1.getWorkspaceFraimDisplayPath)('ai-manager/jobs')}.\n`));
-};
-exports.runFirstRunExperience = runFirstRunExperience;

package/dist/src/core/config-writer.js

@@ -1,75 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.readFraimConfigRaw = readFraimConfigRaw;
-exports.mergeFraimConfig = mergeFraimConfig;
-exports.writeFraimConfigUpdate = writeFraimConfigUpdate;
-exports.writeFraimConfig = writeFraimConfig;
-const fs_1 = require("fs");
-const path_1 = require("path");
-const config_loader_1 = require("./config-loader");
-const types_1 = require("./types");
-function isPlainObject(value) {
-    return typeof value === 'object' && value !== null && !Array.isArray(value);
-}
-function deepMerge(baseValue, updateValue) {
-    if (updateValue === undefined) {
-        return baseValue;
-    }
-    if (Array.isArray(updateValue)) {
-        return [...updateValue];
-    }
-    if (!isPlainObject(updateValue)) {
-        return updateValue;
-    }
-    const baseObject = isPlainObject(baseValue) ? baseValue : {};
-    const merged = { ...baseObject };
-    for (const [key, value] of Object.entries(updateValue)) {
-        merged[key] = deepMerge(baseObject[key], value);
-    }
-    return merged;
-}
-function ensureWritableFraimConfigShape(rawConfig) {
-    const config = { ...rawConfig };
-    if (typeof config.version !== 'string' || config.version.trim().length === 0) {
-        config.version = types_1.DEFAULT_FRAIM_CONFIG.version;
-    }
-    const projectConfig = isPlainObject(config.project) ? config.project : {};
-    config.project = {
-        ...types_1.DEFAULT_FRAIM_CONFIG.project,
-        ...projectConfig
-    };
-    const customizationsConfig = isPlainObject(config.customizations) ? config.customizations : {};
-    config.customizations = {
-        ...types_1.DEFAULT_FRAIM_CONFIG.customizations,
-        ...customizationsConfig
-    };
-    return config;
-}
-function readFraimConfigRaw(configPath) {
-    if (!(0, fs_1.existsSync)(configPath)) {
-        return {};
-    }
-    const parsed = JSON.parse((0, fs_1.readFileSync)(configPath, 'utf8'));
-    if (!isPlainObject(parsed)) {
-        throw new Error('FRAIM config must contain a JSON object at the top level.');
-    }
-    return parsed;
-}
-function mergeFraimConfig(existingRawConfig, update) {
-    const rawConfig = ensureWritableFraimConfigShape(deepMerge(existingRawConfig, update));
-    return {
-        config: (0, config_loader_1.normalizeFraimConfig)(rawConfig),
-        created: Object.keys(existingRawConfig).length === 0,
-        rawConfig
-    };
-}
-function writeFraimConfigUpdate(configPath, update) {
-    const existingRawConfig = readFraimConfigRaw(configPath);
-    const result = mergeFraimConfig(existingRawConfig, update);
-    (0, fs_1.mkdirSync)((0, path_1.dirname)(configPath), { recursive: true });
-    (0, fs_1.writeFileSync)(configPath, JSON.stringify(result.rawConfig, null, 2));
-    return result;
-}
-function writeFraimConfig(configPath, config) {
-    return writeFraimConfigUpdate(configPath, config);
-}

package/dist/src/core/utils/job-aliases.js

@@ -1,47 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DEPRECATED_FRAIM_JOB_NAMES = void 0;
-exports.resolveFraimJobName = resolveFraimJobName;
-exports.isListableFraimJob = isListableFraimJob;
-const DEPRECATED_TO_CANONICAL_JOB_MAP = {
-    'learn-and-scale': 'upskill-employee',
-    'model-behavior': 'upskill-employee',
-    'promote-learning': 'upskill-employee',
-    'refine-jobs': 'upskill-employee',
-    'refine-skills': 'upskill-employee'
-};
-const DIRECT_JOB_ALIASES = {
-    'sleep on learnings': 'sleep-on-learnings'
-};
-exports.DEPRECATED_FRAIM_JOB_NAMES = new Set(Object.keys(DEPRECATED_TO_CANONICAL_JOB_MAP));
-function normalizeJobLookupInput(input) {
-    return input.trim().toLowerCase().replace(/[_\s]+/g, '-');
-}
-function resolveFraimJobName(input) {
-    const normalizedJobName = normalizeJobLookupInput(input);
-    const directAliasTarget = DIRECT_JOB_ALIASES[input.trim().toLowerCase()];
-    if (directAliasTarget) {
-        return {
-            requestedJobName: input,
-            normalizedJobName,
-            canonicalJobName: directAliasTarget
-        };
-    }
-    const deprecatedAliasTarget = DEPRECATED_TO_CANONICAL_JOB_MAP[normalizedJobName];
-    if (deprecatedAliasTarget) {
-        return {
-            requestedJobName: input,
-            normalizedJobName,
-            canonicalJobName: deprecatedAliasTarget,
-            deprecatedAliasTarget
-        };
-    }
-    return {
-        requestedJobName: input,
-        normalizedJobName,
-        canonicalJobName: normalizedJobName
-    };
-}
-function isListableFraimJob(jobName) {
-    return !exports.DEPRECATED_FRAIM_JOB_NAMES.has(normalizeJobLookupInput(jobName));
-}

package/dist/src/core/utils/workflow-parser.js

@@ -1,174 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.WorkflowParser = void 0;
-const fs_1 = require("fs");
-const path_1 = require("path");
-class WorkflowParser {
-    static extractMetadataBlock(content) {
-        const frontmatterMatch = content.match(/^---\r?\n([\s\S]+?)\r?\n---/);
-        if (frontmatterMatch) {
-            try {
-                return {
-                    state: 'valid',
-                    metadata: JSON.parse(frontmatterMatch[1]),
-                    bodyStartIndex: frontmatterMatch[0].length
-                };
-            }
-            catch {
-                return { state: 'invalid' };
-            }
-        }
-        const trimmedStart = content.search(/\S/);
-        if (trimmedStart === -1 || content[trimmedStart] !== '{') {
-            return { state: 'none' };
-        }
-        let depth = 0;
-        let inString = false;
-        let escaping = false;
-        for (let i = trimmedStart; i < content.length; i++) {
-            const ch = content[i];
-            if (inString) {
-                if (escaping) {
-                    escaping = false;
-                }
-                else if (ch === '\\') {
-                    escaping = true;
-                }
-                else if (ch === '"') {
-                    inString = false;
-                }
-                continue;
-            }
-            if (ch === '"') {
-                inString = true;
-                continue;
-            }
-            if (ch === '{') {
-                depth++;
-                continue;
-            }
-            if (ch === '}') {
-                depth--;
-                if (depth === 0) {
-                    const bodyStartIndex = i + 1;
-                    const remainder = content.slice(bodyStartIndex).trimStart();
-                    // `{...}\n---` is usually malformed frontmatter, not bare JSON metadata.
-                    if (remainder.startsWith('---')) {
-                        return { state: 'none' };
-                    }
-                    try {
-                        return {
-                            state: 'valid',
-                            metadata: JSON.parse(content.slice(trimmedStart, bodyStartIndex)),
-                            bodyStartIndex
-                        };
-                    }
-                    catch {
-                        return { state: 'invalid' };
-                    }
-                }
-            }
-        }
-        return { state: 'none' };
-    }
-    /**
-     * Parse a workflow markdown file into a structured definition
-     * Supports three formats:
-     * 1. Phase-based workflows with JSON frontmatter
-     * 2. Phase-based workflows with bare leading JSON metadata
-     * 3. Simple workflows without metadata
-     */
-    static parse(filePath) {
-        if (!(0, fs_1.existsSync)(filePath))
-            return null;
-        let content = (0, fs_1.readFileSync)(filePath, 'utf-8');
-        if (content.charCodeAt(0) === 0xfeff) {
-            content = content.slice(1);
-        }
-        const metadataBlock = this.extractMetadataBlock(content);
-        if (metadataBlock.state === 'invalid') {
-            return null;
-        }
-        if (metadataBlock.state === 'valid') {
-            return this.parsePhaseBasedWorkflow(filePath, content, metadataBlock.metadata, metadataBlock.bodyStartIndex);
-        }
-        return this.parseSimpleWorkflow(filePath, content);
-    }
-    static parsePhaseBasedWorkflow(filePath, content, metadata, bodyStartIndex) {
-        const contentAfterMetadata = content.substring(bodyStartIndex).trim();
-        const firstPhaseIndex = contentAfterMetadata.search(/^##\s+Phase:/m);
-        let overview = '';
-        let restOfContent = '';
-        if (firstPhaseIndex !== -1) {
-            overview = contentAfterMetadata.substring(0, firstPhaseIndex).trim();
-            restOfContent = contentAfterMetadata.substring(firstPhaseIndex);
-        }
-        else {
-            overview = contentAfterMetadata;
-        }
-        const phases = new Map();
-        const phaseSections = restOfContent.split(/^##\s+Phase:\s+/m);
-        if (!metadata.phases) {
-            metadata.phases = {};
-        }
-        for (let i = 1; i < phaseSections.length; i++) {
-            const section = phaseSections[i];
-            const sectionLines = section.split('\n');
-            const firstLine = sectionLines[0].trim();
-            const id = firstLine.split(/[ (]/)[0].trim().toLowerCase();
-            phases.set(id, `## Phase: ${section.trim()}`);
-        }
-        return {
-            metadata,
-            overview,
-            phases,
-            isSimple: false,
-            path: filePath
-        };
-    }
-    static parseSimpleWorkflow(filePath, content) {
-        const workflowName = (0, path_1.basename)(filePath, '.md');
-        const metadata = {
-            name: workflowName
-        };
-        return {
-            metadata,
-            overview: content.trim(),
-            phases: new Map(),
-            isSimple: true,
-            path: filePath
-        };
-    }
-    static parseContent(content, name, path) {
-        if (content.charCodeAt(0) === 0xfeff) {
-            content = content.slice(1);
-        }
-        const metadataBlock = this.extractMetadataBlock(content);
-        if (metadataBlock.state === 'invalid') {
-            return null;
-        }
-        if (metadataBlock.state === 'valid') {
-            return this.parsePhaseBasedWorkflow(path || `content:${name}`, content, metadataBlock.metadata, metadataBlock.bodyStartIndex);
-        }
-        return this.parseSimpleWorkflow(path || `content:${name}`, content);
-    }
-    static getOverviewFromContent(content, name) {
-        const wf = this.parseContent(content, name);
-        return wf ? wf.overview : null;
-    }
-    static getOverview(filePath) {
-        const wf = this.parse(filePath);
-        return wf ? wf.overview : null;
-    }
-    static extractDescription(filePath) {
-        const wf = this.parse(filePath);
-        if (!wf)
-            return '';
-        const intentMatch = wf.overview.match(/## Intent\s+([\s\S]+?)(?:\r?\n##|$)/);
-        if (intentMatch)
-            return intentMatch[1].trim().split(/\r?\n/)[0];
-        const firstPara = wf.overview.split(/\r?\n/).find(l => l.trim() !== '' && !l.startsWith('#'));
-        return firstPara ? firstPara.trim() : '';
-    }
-}
-exports.WorkflowParser = WorkflowParser;