fraim-framework 2.0.76 → 2.0.77

package/dist/src/cli/commands/init-project.js

@@ -24,42 +24,38 @@ const checkGlobalSetup = () => {
         const config = JSON.parse(fs_1.default.readFileSync(globalConfigPath, 'utf8'));
         return {
             exists: true,
-            mode: config.mode || 'integrated', // Default to integrated for backward compatibility
+            mode: config.mode || 'integrated',
             tokens: config.tokens || {}
         };
     }
-    catch (e) {
+    catch {
         return { exists: true, mode: 'integrated', tokens: {} };
     }
 };
 const runInitProject = async () => {
-    console.log(chalk_1.default.blue('🚀 Initializing FRAIM project...'));
-    // Check if global setup exists
+    console.log(chalk_1.default.blue('Initializing FRAIM project...'));
     const globalSetup = checkGlobalSetup();
     if (!globalSetup.exists) {
-        console.log(chalk_1.default.red('❌ Global FRAIM setup not found.'));
+        console.log(chalk_1.default.red('Global FRAIM setup not found.'));
         console.log(chalk_1.default.yellow('Please run global setup first:'));
         console.log(chalk_1.default.cyan('   fraim setup'));
         process.exit(1);
     }
-    const mode = globalSetup.mode;
-    const tokens = globalSetup.tokens || {};
-    console.log(chalk_1.default.gray(`   Mode: ${mode === 'conversational' ? 'Conversational' : 'Integrated'} (from global config)`));
     const projectRoot = process.cwd();
     const fraimDir = path_1.default.join(projectRoot, '.fraim');
     const configPath = path_1.default.join(fraimDir, 'config.json');
     if (!fs_1.default.existsSync(fraimDir)) {
         fs_1.default.mkdirSync(fraimDir, { recursive: true });
-        console.log(chalk_1.default.green('✅ Created .fraim directory'));
+        console.log(chalk_1.default.green('Created .fraim directory'));
     }
     else {
-        console.log(chalk_1.default.yellow('ℹ️  .fraim directory already exists'));
+        console.log(chalk_1.default.yellow('.fraim directory already exists'));
     }
     if (!fs_1.default.existsSync(configPath)) {
+        const projectName = path_1.default.basename(projectRoot);
+        const preferredMode = globalSetup.mode || 'integrated';
         let config;
-        if (mode === 'conversational') {
-            // Conversational mode - no platform integration
-            const projectName = path_1.default.basename(projectRoot);
+        if (preferredMode === 'conversational') {
             config = {
                 version: (0, version_utils_1.getFraimVersion)(),
                 project: {
@@ -67,77 +63,72 @@ const runInitProject = async () => {
                 },
                 customizations: {}
             };
-            console.log(chalk_1.default.blue('   Conversational mode: No platform integration'));
+            console.log(chalk_1.default.blue('   conversational mode: no platform integration'));
             console.log(chalk_1.default.gray(`   Project: ${projectName}`));
         }
         else {
-            // Integrated mode - try to detect platform
             const detection = (0, platform_detection_1.detectPlatformFromGit)();
             if (detection.provider !== 'unknown' && detection.repository) {
-                // Check if we have the appropriate token
-                const hasToken = detection.provider === 'github' ? tokens.github : tokens.ado;
-                if (!hasToken) {
-                    console.log(chalk_1.default.yellow(`\n⚠️  Warning: ${detection.provider.toUpperCase()} repository detected but no token configured`));
-                    console.log(chalk_1.default.gray(`   Platform features will be limited.`));
-                    console.log(chalk_1.default.cyan(`   Run: fraim setup --${detection.provider === 'github' ? 'github' : 'ado'}\n`));
-                }
-                // Use detected repository info
+                const issueTracking = detection.provider === 'github'
+                    ? {
+                        provider: 'github',
+                        owner: detection.repository.owner,
+                        name: detection.repository.name
+                    }
+                    : {
+                        provider: 'ado',
+                        organization: detection.repository.organization,
+                        project: detection.repository.project,
+                        name: detection.repository.name
+                    };
                 config = {
                     version: (0, version_utils_1.getFraimVersion)(),
                     project: {
-                        name: detection.repository.name
+                        name: detection.repository.name || projectName
                     },
                     repository: detection.repository,
+                    issueTracking,
                     customizations: {}
                 };
                 console.log(chalk_1.default.blue(`   Platform: ${detection.provider.toUpperCase()}`));
                 if (detection.provider === 'github') {
                     console.log(chalk_1.default.gray(`   Repository: ${detection.repository.owner}/${detection.repository.name}`));
-                    console.log(chalk_1.default.gray(`   Token: ${hasToken ? '✓ Configured' : '✗ Missing'}`));
                 }
                 else if (detection.provider === 'ado') {
                     console.log(chalk_1.default.gray(`   Organization: ${detection.repository.organization}`));
                     console.log(chalk_1.default.gray(`   Project: ${detection.repository.project}`));
                     console.log(chalk_1.default.gray(`   Repository: ${detection.repository.name}`));
-                    console.log(chalk_1.default.gray(`   Token: ${hasToken ? '✓ Configured' : '✗ Missing'}`));
                 }
             }
             else {
-                // No git remote detected - warn user and fallback to conversational-style config
-                console.log(chalk_1.default.yellow('   ⚠️  No git remote detected'));
-                console.log(chalk_1.default.yellow('   Integrated mode requires a git remote for platform features.'));
-                console.log(chalk_1.default.gray('   Falling back to conversational mode configuration...'));
-                const repoName = path_1.default.basename(projectRoot);
                 config = {
                     version: (0, version_utils_1.getFraimVersion)(),
                     project: {
-                        name: repoName
+                        name: projectName
                     },
                     customizations: {}
                 };
-                console.log(chalk_1.default.gray('   Please update .fraim/config.json if you add a repository later.'));
+                console.log(chalk_1.default.yellow('   No git remote detected. Falling back to conversational mode.'));
             }
         }
         fs_1.default.writeFileSync(configPath, JSON.stringify(config, null, 2));
-        console.log(chalk_1.default.green('✅ Created .fraim/config.json'));
+        console.log(chalk_1.default.green('Created .fraim/config.json'));
     }
-    // Create subdirectories
-    ['workflows'].forEach(dir => {
+    ['workflows'].forEach((dir) => {
         const dirPath = path_1.default.join(fraimDir, dir);
         if (!fs_1.default.existsSync(dirPath)) {
             fs_1.default.mkdirSync(dirPath, { recursive: true });
-            console.log(chalk_1.default.green(`✅ Created .fraim/${dir}`));
+            console.log(chalk_1.default.green(`Created .fraim/${dir}`));
         }
     });
-    // Sync workflows from registry
     await (0, sync_1.runSync)({});
     const codexAvailable = (0, ide_detector_1.detectInstalledIDEs)().some((ide) => ide.configType === 'codex');
     if (codexAvailable) {
         const codexLocalResult = (0, codex_local_config_1.ensureCodexLocalConfig)(projectRoot);
         const status = codexLocalResult.created ? 'Created' : codexLocalResult.updated ? 'Updated' : 'Verified';
-        console.log(chalk_1.default.green(`✅ ${status} project Codex config at ${codexLocalResult.path}`));
+        console.log(chalk_1.default.green(`${status} project Codex config at ${codexLocalResult.path}`));
     }
-    console.log(chalk_1.default.green('\n✅ FRAIM project initialized!'));
+    console.log(chalk_1.default.green('\nFRAIM project initialized!'));
     console.log(chalk_1.default.cyan('Try: Ask your AI agent "list fraim workflows"'));
 };
 exports.runInitProject = runInitProject;

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

@@ -46,6 +46,9 @@ function loadFraimConfig() {
                 ...(config.customizations || {})
             }
         };
+        if (config.issueTracking && typeof config.issueTracking === 'object') {
+            mergedConfig.issueTracking = config.issueTracking;
+        }
         // Add optional workflow-driven fields only if they exist in the config
         if (config.compliance) {
             mergedConfig.compliance = config.compliance;

package/dist/src/local-mcp-server/stdio-server.js

@@ -106,19 +106,49 @@ class FraimTemplateEngine {
         return null;
     }
     substitutePlatformActions(content) {
-        const provider = (0, provider_utils_1.detectProvider)(this.repoInfo?.url);
-        const templates = this.loadProviderTemplates(provider);
-        if (!templates)
-            return content;
+        const codeProvider = this.getCodeProvider();
+        const issueProvider = this.getIssueProvider();
+        const codeTemplates = this.loadProviderTemplates(codeProvider);
+        const issueTemplates = issueProvider ? this.loadProviderTemplates(issueProvider) : null;
         let result = content;
-        for (const [action, template] of Object.entries(templates)) {
-            const escapedAction = action.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-            const regex = new RegExp(`\\{\\{${FraimTemplateEngine.PROXY_ACTION_PREFIX}${escapedAction}\\}\\}`, 'g');
-            const renderedTemplate = this.renderActionTemplate(template);
-            result = result.replace(regex, renderedTemplate);
+        if (issueTemplates) {
+            for (const [action, template] of Object.entries(issueTemplates)) {
+                if (!FraimTemplateEngine.ISSUE_ACTIONS.has(action))
+                    continue;
+                const escapedAction = action.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+                const regex = new RegExp(`\\{\\{${FraimTemplateEngine.PROXY_ACTION_PREFIX}${escapedAction}\\}\\}`, 'g');
+                result = result.replace(regex, this.renderActionTemplate(template));
+            }
+        }
+        if (codeTemplates) {
+            for (const [action, template] of Object.entries(codeTemplates)) {
+                if (issueProvider && issueProvider !== codeProvider && FraimTemplateEngine.ISSUE_ACTIONS.has(action))
+                    continue;
+                const escapedAction = action.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+                const regex = new RegExp(`\\{\\{${FraimTemplateEngine.PROXY_ACTION_PREFIX}${escapedAction}\\}\\}`, 'g');
+                result = result.replace(regex, this.renderActionTemplate(template));
+            }
         }
         return result;
     }
+    getCodeProvider() {
+        const repoProvider = this.repoInfo?.provider || this.config?.repository?.provider;
+        if (typeof repoProvider === 'string' && repoProvider.trim().length > 0) {
+            return repoProvider;
+        }
+        return (0, provider_utils_1.detectProvider)(this.repoInfo?.url || this.config?.repository?.url);
+    }
+    getIssueProvider() {
+        const fromRepoInfo = this.repoInfo?.issueTracking?.provider;
+        if (typeof fromRepoInfo === 'string' && fromRepoInfo.trim().length > 0) {
+            return fromRepoInfo;
+        }
+        const fromConfig = this.config?.issueTracking?.provider;
+        if (typeof fromConfig === 'string' && fromConfig.trim().length > 0) {
+            return fromConfig;
+        }
+        return null;
+    }
     loadProviderTemplates(provider) {
         if (this.providerTemplatesCache[provider])
             return this.providerTemplatesCache[provider];
@@ -130,11 +160,12 @@ class FraimTemplateEngine {
         return null;
     }
     renderActionTemplate(template) {
-        if (!this.repoInfo && !this.config?.repository) {
+        if (!this.repoInfo && !this.config?.repository && !this.config?.issueTracking) {
             return template;
         }
         return template.replace(/\{\{([^}]+)\}\}/g, (match, path) => {
             const trimmedPath = path.trim();
+            // Handle proxy.repository.* variables
             if (trimmedPath.startsWith('proxy.repository.')) {
                 const repoPath = trimmedPath.substring('proxy.repository.'.length);
                 if (this.repoInfo) {
@@ -148,12 +179,36 @@ class FraimTemplateEngine {
                         return String(value);
                 }
             }
+            // Handle proxy.issueTracking.* variables (for split provider mode)
+            if (trimmedPath.startsWith('proxy.issueTracking.')) {
+                const issueTrackingPath = trimmedPath.substring('proxy.issueTracking.'.length);
+                if (this.repoInfo?.issueTracking) {
+                    const value = (0, object_utils_1.getNestedValue)(this.repoInfo.issueTracking, issueTrackingPath);
+                    if (value !== undefined)
+                        return String(value);
+                }
+                if (this.config?.issueTracking) {
+                    const value = (0, object_utils_1.getNestedValue)(this.config.issueTracking, issueTrackingPath);
+                    if (value !== undefined)
+                        return String(value);
+                }
+            }
             return match;
         });
     }
 }
 exports.FraimTemplateEngine = FraimTemplateEngine;
 FraimTemplateEngine.PROXY_ACTION_PREFIX = 'proxy.action.';
+FraimTemplateEngine.ISSUE_ACTIONS = new Set([
+    'get_issue',
+    'update_issue_status',
+    'add_issue_comment',
+    'create_issue',
+    'assign_issue',
+    'search_issues',
+    'close_issue',
+    'list_issues'
+]);
 class FraimLocalMCPServer {
     constructor() {
         this.config = null;
@@ -365,16 +420,17 @@ class FraimLocalMCPServer {
                 }).trim();
             }
             catch (error) {
-                // If git command fails, construct URL from config if available
-                if (this.config?.repository?.owner && this.config?.repository?.name) {
-                    const provider = this.config.repository.provider || 'github';
-                    if (provider === 'github') {
-                        repoUrl = `https://github.com/${this.config.repository.owner}/${this.config.repository.name}.git`;
-                    }
-                    else if (provider === 'ado') {
-                        // Azure DevOps URL format
-                        repoUrl = `https://dev.azure.com/${this.config.repository.owner}/${this.config.repository.name}/_git/${this.config.repository.name}`;
-                    }
+                // If git command fails, construct URL from config if available.
+                const repositoryConfig = this.config?.repository;
+                if (repositoryConfig?.provider === 'github' && repositoryConfig.owner && repositoryConfig.name) {
+                    repoUrl = `https://github.com/${repositoryConfig.owner}/${repositoryConfig.name}.git`;
+                    this.log(`📋 Constructed repo URL from config: ${repoUrl}`);
+                }
+                else if (repositoryConfig?.provider === 'ado' &&
+                    repositoryConfig.organization &&
+                    repositoryConfig.project &&
+                    repositoryConfig.name) {
+                    repoUrl = `https://dev.azure.com/${repositoryConfig.organization}/${repositoryConfig.project}/_git/${repositoryConfig.name}`;
                     this.log(`📋 Constructed repo URL from config: ${repoUrl}`);
                 }
             }
@@ -383,10 +439,10 @@ class FraimLocalMCPServer {
                 return null;
             }
             // Parse owner and name from URL
-            let owner = '';
             let name = '';
             let organization = '';
             let project = '';
+            let owner = '';
             // Handle GitHub URLs: https://github.com/owner/repo.git or git@github.com:owner/repo.git
             const githubHttpsMatch = repoUrl.match(/github\.com[\/:]([^\/]+)\/([^\/\.]+)/);
             const adoMatch = repoUrl.match(/dev\.azure\.com\/([^\/]+)\/([^\/]+)\/_git\/([^\/]+)/);
@@ -398,7 +454,6 @@ class FraimLocalMCPServer {
                 // Azure DevOps: organization and project are separate fields
                 organization = adoMatch[1];
                 project = adoMatch[2];
-                owner = organization; // For compatibility
                 name = adoMatch[3];
             }
             else if (this.config?.repository) {
@@ -423,15 +478,21 @@ class FraimLocalMCPServer {
                     branch = this.config.repository.defaultBranch;
                 }
             }
-            this.repoInfo = {
+            const repoInfo = {
                 url: repoUrl,
-                owner: owner || 'unknown',
                 name: name || 'unknown',
                 ...(organization && { organization }),
                 ...(project && { project }),
                 ...(branch && { branch })
             };
-            this.log(`✅ Detected repo info: ${this.repoInfo.owner}/${this.repoInfo.name}`);
+            if (owner) {
+                repoInfo.owner = owner;
+            }
+            this.repoInfo = repoInfo;
+            const repoLabel = this.repoInfo.owner
+                ? `${this.repoInfo.owner}/${this.repoInfo.name}`
+                : this.repoInfo.name;
+            this.log(`✅ Detected repo info: ${repoLabel}`);
             return this.repoInfo;
         }
         catch (error) {
@@ -630,25 +691,57 @@ class FraimLocalMCPServer {
         if (!hasDirectProviderPlaceholders && !hasDeliveryPlaceholders)
             return;
         const engine = this.ensureEngine();
-        const provider = (0, provider_utils_1.detectProvider)(this.detectRepoInfo()?.url);
-        if (engine.hasProviderTemplates(provider))
-            return;
-        if (engine.loadProviderTemplates(provider))
-            return;
-        const filename = `${provider}.json`;
-        const cached = this.readCachedTemplateFile(filename);
-        if (cached) {
-            engine.setProviderTemplates(provider, cached);
-            return;
+        const codeProvider = engine.getCodeProvider();
+        const issueProvider = engine.getIssueProvider();
+        const providers = Array.from(new Set([codeProvider, issueProvider].filter((provider) => typeof provider === 'string' && provider.length > 0)));
+        for (const provider of providers) {
+            if (engine.hasProviderTemplates(provider))
+                continue;
+            if (engine.loadProviderTemplates(provider))
+                continue;
+            const filename = `${provider}.json`;
+            const cached = this.readCachedTemplateFile(filename);
+            if (cached) {
+                engine.setProviderTemplates(provider, cached);
+                continue;
+            }
+            const remoteContent = await this.fetchRegistryFileFromServer(`providers/${filename}`, requestSessionId);
+            if (remoteContent) {
+                const parsed = this.parseTemplateJson(remoteContent, `providers/${filename}`);
+                if (parsed) {
+                    engine.setProviderTemplates(provider, parsed);
+                    this.writeCachedTemplateFile(filename, parsed);
+                    continue;
+                }
+            }
+            const bundled = this.readBundledTemplateFile(filename);
+            if (bundled) {
+                engine.setProviderTemplates(provider, bundled);
+            }
         }
-        const remoteContent = await this.fetchRegistryFileFromServer(`providers/${filename}`, requestSessionId);
-        if (!remoteContent)
-            return;
-        const parsed = this.parseTemplateJson(remoteContent, `providers/${filename}`);
-        if (!parsed)
-            return;
-        engine.setProviderTemplates(provider, parsed);
-        this.writeCachedTemplateFile(filename, parsed);
+    }
+    readBundledTemplateFile(filename) {
+        const candidates = [
+            (0, path_1.join)(__dirname, '..', '..', '..', 'registry', 'providers', filename),
+            (0, path_1.join)(__dirname, '..', '..', 'registry', 'providers', filename),
+            (0, path_1.join)(process.cwd(), 'registry', 'providers', filename)
+        ];
+        for (const candidate of candidates) {
+            try {
+                if (!(0, fs_1.existsSync)(candidate))
+                    continue;
+                const content = (0, fs_1.readFileSync)(candidate, 'utf8');
+                const parsed = JSON.parse(content);
+                if (parsed && typeof parsed === 'object') {
+                    this.log(`✅ Loaded bundled provider template: ${candidate}`);
+                    return parsed;
+                }
+            }
+            catch (error) {
+                this.log(`⚠️ Failed to load bundled template ${candidate}: ${error.message}`);
+            }
+        }
+        return null;
     }
     async hydrateTemplateCachesForResponse(response, requestSessionId) {
         if (!response.result)
@@ -661,10 +754,12 @@ class FraimLocalMCPServer {
         let processedResponse = this.processResponse(response);
         // Delivery substitution can introduce provider action placeholders (e.g. {{proxy.action.update_issue_status}})
         // that were not visible pre-substitution. Run one targeted re-hydration pass if needed.
-        const provider = (0, provider_utils_1.detectProvider)(this.detectRepoInfo()?.url);
         const engine = this.ensureEngine();
-        if (this.responseHasPotentialProviderPlaceholders(processedResponse) &&
-            !engine.hasProviderTemplates(provider)) {
+        const codeProvider = engine.getCodeProvider();
+        const issueProvider = engine.getIssueProvider();
+        const providers = Array.from(new Set([codeProvider, issueProvider].filter((provider) => typeof provider === 'string' && provider.length > 0)));
+        const hasMissingProviderTemplate = providers.some((provider) => !engine.hasProviderTemplates(provider));
+        if (this.responseHasPotentialProviderPlaceholders(processedResponse) && hasMissingProviderTemplate) {
             await this.ensureProviderTemplatesAvailable(processedResponse, requestSessionId);
             processedResponse = this.processResponse(processedResponse);
         }
@@ -988,7 +1083,8 @@ class FraimLocalMCPServer {
                         ...args.repo, // Agent values as fallback
                         ...detectedRepo // Detected values override (always win)
                     };
-                    this.log(`[req:${requestId}] Auto-detected and injected repo info: ${args.repo.owner}/${args.repo.name}`);
+                    const repoLabel = args.repo.owner ? `${args.repo.owner}/${args.repo.name}` : args.repo.name;
+                    this.log(`[req:${requestId}] Auto-detected and injected repo info: ${repoLabel}`);
                 }
                 else {
                     // If detection fails, use agent-provided values (if any)
@@ -1004,12 +1100,25 @@ class FraimLocalMCPServer {
                             }
                         };
                     }
-                    this.log(`[req:${requestId}] Using agent-provided repo info: ${args.repo.owner}/${args.repo.name}`);
+                    const repoLabel = args.repo.owner ? `${args.repo.owner}/${args.repo.name}` : args.repo.name;
+                    this.log(`[req:${requestId}] Using agent-provided repo info: ${repoLabel}`);
                 }
+                const configuredIssueTracking = this.config?.issueTracking;
+                if (configuredIssueTracking && typeof configuredIssueTracking === 'object') {
+                    args.issueTracking = {
+                        ...(args.issueTracking || {}),
+                        ...configuredIssueTracking
+                    };
+                    this.log(`[req:${requestId}] Applied issueTracking context: ${args.issueTracking.provider || 'unknown'}`);
+                }
+                const runtimeRepoContext = {
+                    ...args.repo,
+                    ...(args.issueTracking ? { issueTracking: args.issueTracking } : {})
+                };
                 // Keep proxy runtime repository context in sync with connect payload.
-                this.repoInfo = args.repo;
+                this.repoInfo = runtimeRepoContext;
                 if (this.engine) {
-                    this.engine.setRepoInfo(args.repo);
+                    this.engine.setRepoInfo(runtimeRepoContext);
                 }
                 // Update the request with injected info
                 request.params.arguments = args;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fraim-framework",
-  "version": "2.0.76",
+  "version": "2.0.77",
   "description": "FRAIM v2: Framework for Rigor-based AI Management - Transform from solo developer to AI manager orchestrating production-ready code with enterprise-grade discipline",
   "main": "index.js",
   "bin": {