fraim-framework 2.0.95 → 2.0.97

package/dist/src/cli/utils/project-bootstrap.js

@@ -0,0 +1,93 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createInitProjectResult = createInitProjectResult;
+exports.recordPathStatus = recordPathStatus;
+exports.buildInitProjectSummary = buildInitProjectSummary;
+exports.printInitProjectSummary = printInitProjectSummary;
+const chalk_1 = __importDefault(require("chalk"));
+function formatModeLabel(mode) {
+    switch (mode) {
+        case 'conversational':
+            return 'Conversational';
+        case 'split':
+            return 'Split';
+        default:
+            return 'Integrated';
+    }
+}
+function getModeSpecificNextStep(mode) {
+    switch (mode) {
+        case 'conversational':
+            return 'The agent will focus on project context, validation commands, and durable repo rules.';
+        case 'split':
+            return 'The agent will confirm the code-host and issue-tracker split, then ask only for the missing project details.';
+        default:
+            return 'The agent will review the detected repo setup, then ask only for the highest-value missing project details.';
+    }
+}
+function createInitProjectResult(projectName, mode) {
+    return {
+        mode,
+        projectName,
+        repositoryDetected: false,
+        issueTrackingDetected: false,
+        createdPaths: [],
+        reusedPaths: [],
+        warnings: [],
+        syncPerformed: false,
+        bootstrapNeeded: false
+    };
+}
+function recordPathStatus(result, relativePath, created) {
+    if (created) {
+        result.createdPaths.push(relativePath);
+        return;
+    }
+    result.reusedPaths.push(relativePath);
+}
+function buildInitProjectSummary(result) {
+    return {
+        status: 'FRAIM project initialized.',
+        fields: {
+            mode: formatModeLabel(result.mode),
+            project: result.projectName,
+            repositoryDetection: result.repositoryDetected ? 'detected' : 'not detected',
+            issueTracking: result.issueTrackingDetected ? 'detected' : 'not detected',
+            sync: result.syncPerformed ? 'completed' : 'skipped for this run',
+            createdPaths: [...result.createdPaths],
+            reusedPaths: [...result.reusedPaths]
+        },
+        warnings: [...result.warnings],
+        nextStep: {
+            prompt: 'Tell your AI agent "Onboard this project".',
+            explanation: getModeSpecificNextStep(result.mode)
+        }
+    };
+}
+function printInitProjectSummary(result) {
+    const summary = buildInitProjectSummary(result);
+    console.log(chalk_1.default.green(`\n${summary.status}`));
+    console.log(chalk_1.default.blue('Project summary:'));
+    console.log(chalk_1.default.gray(`   Mode: ${summary.fields.mode}`));
+    console.log(chalk_1.default.gray(`   Project: ${summary.fields.project}`));
+    console.log(chalk_1.default.gray(`   Repository detection: ${summary.fields.repositoryDetection}`));
+    console.log(chalk_1.default.gray(`   Issue tracking: ${summary.fields.issueTracking}`));
+    console.log(chalk_1.default.gray(`   Sync: ${summary.fields.sync}`));
+    if (summary.fields.createdPaths.length > 0) {
+        console.log(chalk_1.default.gray(`   Created: ${summary.fields.createdPaths.join(', ')}`));
+    }
+    if (summary.fields.reusedPaths.length > 0) {
+        console.log(chalk_1.default.gray(`   Reused: ${summary.fields.reusedPaths.join(', ')}`));
+    }
+    if (summary.warnings.length > 0) {
+        console.log(chalk_1.default.yellow('\nWarnings:'));
+        summary.warnings.forEach((warning) => {
+            console.log(chalk_1.default.yellow(`   - ${warning}`));
+        });
+    }
+    console.log(chalk_1.default.cyan(`\nNext step: ${summary.nextStep.prompt}`));
+    console.log(chalk_1.default.gray(summary.nextStep.explanation));
+}

package/dist/src/cli/utils/remote-sync.js

@@ -2,7 +2,7 @@
 /**
  * Remote Registry Sync
  *
- * Fetches workflows and scripts from the remote FRAIM server
+ * Fetches jobs and scripts from the remote FRAIM server
  * instead of bundling them in the npm package.
  *
  * Issue: #83 - Minimize client package by fetching registry remotely
@@ -18,6 +18,7 @@ const path_1 = require("path");
 const chalk_1 = __importDefault(require("chalk"));
 const script_sync_utils_1 = require("./script-sync-utils");
 const fraim_gitignore_1 = require("./fraim-gitignore");
+const project_fraim_paths_1 = require("../../core/utils/project-fraim-paths");
 const LOCK_SYNCED_CONTENT_ENV = 'FRAIM_LOCK_SYNCED_CONTENT';
 const SYNCED_CONTENT_BANNER_MARKER = '<!-- FRAIM_SYNC_MANAGED_CONTENT -->';
 function shouldLockSyncedContent() {
@@ -93,7 +94,7 @@ function applySyncedContentBanner(file) {
     return insertAfterFrontmatter(file.content, banner);
 }
 /**
- * Sync workflows and scripts from remote FRAIM server
+ * Sync jobs and scripts from remote FRAIM server
  */
 async function syncFromRemote(options) {
     const remoteUrl = options.remoteUrl || process.env.FRAIM_REMOTE_URL || 'https://fraim.wellnessatwork.me';
@@ -101,7 +102,6 @@ async function syncFromRemote(options) {
     if (!apiKey) {
         return {
             success: false,
-            workflowsSynced: 0,
             employeeJobsSynced: 0,
             managerJobsSynced: 0,
             skillsSynced: 0,
@@ -126,7 +126,6 @@ async function syncFromRemote(options) {
             console.log(chalk_1.default.yellow('⚠️  No files received from remote server'));
             return {
                 success: false,
-                workflowsSynced: 0,
                 employeeJobsSynced: 0,
                 managerJobsSynced: 0,
                 skillsSynced: 0,
@@ -143,55 +142,11 @@ async function syncFromRemote(options) {
                 setFileWriteLockRecursively(target, false);
             }
         }
-        // Sync workflows to role-specific folders under .fraim
-        const allWorkflowFiles = files.filter(f => f.type === 'workflow');
-        const managerWorkflowFiles = allWorkflowFiles.filter(f => f.path.startsWith('ai-manager/'));
-        const employeeWorkflowFiles = allWorkflowFiles.filter(f => !f.path.startsWith('ai-manager/'));
-        // Write employee workflows
-        const employeeWorkflowsDir = (0, path_1.join)(options.projectRoot, '.fraim', 'ai-employee', 'workflows');
-        if (!(0, fs_1.existsSync)(employeeWorkflowsDir)) {
-            (0, fs_1.mkdirSync)(employeeWorkflowsDir, { recursive: true });
-        }
-        cleanDirectory(employeeWorkflowsDir);
-        for (const file of employeeWorkflowFiles) {
-            // Strip "workflows/" prefix and "ai-employee/" role prefix for cleaner local layout
-            let relPath = file.path;
-            if (relPath.startsWith('workflows/'))
-                relPath = relPath.substring('workflows/'.length);
-            relPath = relPath.replace(/^ai-employee\//, '');
-            const filePath = (0, path_1.join)(employeeWorkflowsDir, relPath);
-            const fileDir = (0, path_1.dirname)(filePath);
-            if (!(0, fs_1.existsSync)(fileDir)) {
-                (0, fs_1.mkdirSync)(fileDir, { recursive: true });
-            }
-            (0, fs_1.writeFileSync)(filePath, file.content, 'utf8');
-            console.log(chalk_1.default.gray(`  + .fraim/ai-employee/workflows/${relPath}`));
-        }
-        // Write manager workflows
-        const managerWorkflowsDir = (0, path_1.join)(options.projectRoot, '.fraim', 'ai-manager', 'workflows');
-        if (!(0, fs_1.existsSync)(managerWorkflowsDir)) {
-            (0, fs_1.mkdirSync)(managerWorkflowsDir, { recursive: true });
-        }
-        cleanDirectory(managerWorkflowsDir);
-        for (const file of managerWorkflowFiles) {
-            // Strip "workflows/" prefix and "ai-manager/" role prefix
-            let relPath = file.path;
-            if (relPath.startsWith('workflows/'))
-                relPath = relPath.substring('workflows/'.length);
-            relPath = relPath.replace(/^ai-manager\//, '');
-            const filePath = (0, path_1.join)(managerWorkflowsDir, relPath);
-            const fileDir = (0, path_1.dirname)(filePath);
-            if (!(0, fs_1.existsSync)(fileDir)) {
-                (0, fs_1.mkdirSync)(fileDir, { recursive: true });
-            }
-            (0, fs_1.writeFileSync)(filePath, file.content, 'utf8');
-            console.log(chalk_1.default.gray(`  + .fraim/ai-manager/workflows/${relPath}`));
-        }
-        // Sync job stubs to role-specific folders under .fraim
+        // Sync job stubs to role-specific folders under fraim/
         const allJobFiles = files.filter(f => f.type === 'job');
         const managerJobFiles = allJobFiles.filter(f => f.path.startsWith('ai-manager/'));
         const jobFiles = allJobFiles.filter(f => !f.path.startsWith('ai-manager/'));
-        const employeeJobsDir = (0, path_1.join)(options.projectRoot, '.fraim', 'ai-employee', 'jobs');
+        const employeeJobsDir = (0, project_fraim_paths_1.getWorkspaceFraimPath)(options.projectRoot, 'ai-employee', 'jobs');
         if (!(0, fs_1.existsSync)(employeeJobsDir)) {
             (0, fs_1.mkdirSync)(employeeJobsDir, { recursive: true });
         }
@@ -208,10 +163,10 @@ async function syncFromRemote(options) {
                 (0, fs_1.mkdirSync)(fileDir, { recursive: true });
             }
             (0, fs_1.writeFileSync)(filePath, applySyncedContentBanner(file), 'utf8');
-            console.log(chalk_1.default.gray(`  + ai-employee/jobs/${relPath}`));
+            console.log(chalk_1.default.gray(`  + ${(0, project_fraim_paths_1.getWorkspaceFraimDisplayPath)(`ai-employee/jobs/${relPath}`)}`));
         }
-        // Sync ai-manager job stubs to .fraim/ai-manager/jobs/
-        const managerJobsDir = (0, path_1.join)(options.projectRoot, '.fraim', 'ai-manager', 'jobs');
+        // Sync ai-manager job stubs to fraim/ai-manager/jobs/
+        const managerJobsDir = (0, project_fraim_paths_1.getWorkspaceFraimPath)(options.projectRoot, 'ai-manager', 'jobs');
         if (!(0, fs_1.existsSync)(managerJobsDir)) {
             (0, fs_1.mkdirSync)(managerJobsDir, { recursive: true });
         }
@@ -228,17 +183,17 @@ async function syncFromRemote(options) {
                 (0, fs_1.mkdirSync)(fileDir, { recursive: true });
             }
             (0, fs_1.writeFileSync)(filePath, applySyncedContentBanner(file), 'utf8');
-            console.log(chalk_1.default.gray(`  + .fraim/ai-manager/jobs/${relPath}`));
+            console.log(chalk_1.default.gray(`  + ${(0, project_fraim_paths_1.getWorkspaceFraimDisplayPath)(`ai-manager/jobs/${relPath}`)}`));
         }
-        // Sync skill STUBS to .fraim/ai-employee/skills/
+        // Sync skill STUBS to fraim/ai-employee/skills/
         const skillFiles = files.filter(f => f.type === 'skill');
-        const skillsDir = (0, path_1.join)(options.projectRoot, '.fraim', 'ai-employee', 'skills');
+        const skillsDir = (0, project_fraim_paths_1.getWorkspaceFraimPath)(options.projectRoot, 'ai-employee', 'skills');
         if (!(0, fs_1.existsSync)(skillsDir)) {
             (0, fs_1.mkdirSync)(skillsDir, { recursive: true });
         }
         cleanDirectory(skillsDir);
         for (const file of skillFiles) {
-            // Strip "skills/" prefix to avoid redundant nesting in .fraim/ai-employee/skills/
+            // Strip "skills/" prefix to avoid redundant nesting in fraim/ai-employee/skills/
             let relPath = file.path;
             if (relPath.startsWith('skills/'))
                 relPath = relPath.substring('skills/'.length);
@@ -248,17 +203,17 @@ async function syncFromRemote(options) {
                 (0, fs_1.mkdirSync)(fileDir, { recursive: true });
             }
             (0, fs_1.writeFileSync)(filePath, applySyncedContentBanner(file), 'utf8');
-            console.log(chalk_1.default.gray(`  + ai-employee/skills/${file.path} (stub)`));
+            console.log(chalk_1.default.gray(`  + ${(0, project_fraim_paths_1.getWorkspaceFraimDisplayPath)(`ai-employee/skills/${relPath}`)} (stub)`));
         }
-        // Sync rule STUBS to .fraim/ai-employee/rules/
+        // Sync rule STUBS to fraim/ai-employee/rules/
         const ruleFiles = files.filter(f => f.type === 'rule');
-        const rulesDir = (0, path_1.join)(options.projectRoot, '.fraim', 'ai-employee', 'rules');
+        const rulesDir = (0, project_fraim_paths_1.getWorkspaceFraimPath)(options.projectRoot, 'ai-employee', 'rules');
         if (!(0, fs_1.existsSync)(rulesDir)) {
             (0, fs_1.mkdirSync)(rulesDir, { recursive: true });
         }
         cleanDirectory(rulesDir);
         for (const file of ruleFiles) {
-            // Strip "rules/" prefix to avoid redundant nesting in .fraim/ai-employee/rules/
+            // Strip "rules/" prefix to avoid redundant nesting in fraim/ai-employee/rules/
             let relPath = file.path;
             if (relPath.startsWith('rules/'))
                 relPath = relPath.substring('rules/'.length);
@@ -268,7 +223,7 @@ async function syncFromRemote(options) {
                 (0, fs_1.mkdirSync)(fileDir, { recursive: true });
             }
             (0, fs_1.writeFileSync)(filePath, applySyncedContentBanner(file), 'utf8');
-            console.log(chalk_1.default.gray(`  + ai-employee/rules/${file.path} (stub)`));
+            console.log(chalk_1.default.gray(`  + ${(0, project_fraim_paths_1.getWorkspaceFraimDisplayPath)(`ai-employee/rules/${relPath}`)} (stub)`));
         }
         // Sync scripts to user directory
         const scriptFiles = files.filter(f => f.type === 'script');
@@ -289,9 +244,9 @@ async function syncFromRemote(options) {
             (0, fs_1.writeFileSync)(filePath, file.content, 'utf8');
             console.log(chalk_1.default.gray(`  + ${file.path}`));
         }
-        // Sync docs to .fraim/docs/
+        // Sync docs to fraim/docs/
         const docsFiles = files.filter(f => f.type === 'docs');
-        const docsDir = (0, path_1.join)(options.projectRoot, '.fraim', 'docs');
+        const docsDir = (0, project_fraim_paths_1.getWorkspaceFraimPath)(options.projectRoot, 'docs');
         if (!(0, fs_1.existsSync)(docsDir)) {
             (0, fs_1.mkdirSync)(docsDir, { recursive: true });
         }
@@ -303,7 +258,7 @@ async function syncFromRemote(options) {
                 (0, fs_1.mkdirSync)(fileDir, { recursive: true });
             }
             (0, fs_1.writeFileSync)(filePath, file.content, 'utf8');
-            console.log(chalk_1.default.gray(`  + docs/${file.path}`));
+            console.log(chalk_1.default.gray(`  + ${(0, project_fraim_paths_1.getWorkspaceFraimDisplayPath)(`docs/${file.path}`)}`));
         }
         if (shouldLockSyncedContent()) {
             for (const target of lockTargets) {
@@ -313,7 +268,6 @@ async function syncFromRemote(options) {
         }
         return {
             success: true,
-            workflowsSynced: allWorkflowFiles.length,
             employeeJobsSynced: jobFiles.length,
             managerJobsSynced: managerJobFiles.length,
             skillsSynced: skillFiles.length,
@@ -326,7 +280,6 @@ async function syncFromRemote(options) {
         console.error(chalk_1.default.red(`❌ Remote sync failed: ${error.message}`));
         return {
             success: false,
-            workflowsSynced: 0,
             employeeJobsSynced: 0,
             managerJobsSynced: 0,
             skillsSynced: 0,

package/dist/src/core/ai-mentor.js

@@ -4,16 +4,16 @@ exports.AIMentor = void 0;
 const include_resolver_1 = require("./utils/include-resolver");
 class AIMentor {
     constructor(resolver) {
-        this.workflowCache = new Map();
+        this.jobCache = new Map();
         this.resolver = resolver;
     }
     /**
      * Handle mentoring/coaching request from agent
      */
     async handleMentoringRequest(args) {
-        const workflow = await this.getOrLoadWorkflow(args.workflowType);
+        const workflow = await this.getOrLoadJob(args.jobName);
         if (!workflow) {
-            throw new Error(`Workflow "${args.workflowType}" not found or invalid.`);
+            throw new Error(`Job "${args.jobName}" not found or invalid.`);
         }
         const validStatus = ['starting', 'complete', 'incomplete', 'failure'].includes(args.status);
         if (!validStatus) {
@@ -25,7 +25,7 @@ class AIMentor {
             const hasMetadata = !!phases[args.currentPhase];
             const hasMarkdown = workflow.phases.has(args.currentPhase);
             if (!hasMetadata && !hasMarkdown && args.currentPhase !== 'starting') {
-                throw new Error(`Phase "${args.currentPhase}" not found in workflow "${args.workflowType}".`);
+                throw new Error(`Phase "${args.currentPhase}" not found in job "${args.jobName}".`);
             }
         }
         // Handle different statuses
@@ -39,14 +39,14 @@ class AIMentor {
             return await this.generateHelpMessage(workflow, args.currentPhase, args.status, args.skipIncludes);
         }
     }
-    async getOrLoadWorkflow(workflowType, preferredType) {
-        if (this.workflowCache.has(workflowType)) {
-            return this.workflowCache.get(workflowType);
+    async getOrLoadJob(jobType) {
+        if (this.jobCache.has(jobType)) {
+            return this.jobCache.get(jobType);
         }
-        const workflow = await this.resolver.getWorkflow(workflowType, preferredType);
-        if (workflow) {
-            this.workflowCache.set(workflowType, workflow);
-            return workflow;
+        const job = await this.resolver.getJob(jobType);
+        if (job) {
+            this.jobCache.set(jobType, job);
+            return job;
         }
         return null;
     }
@@ -60,11 +60,11 @@ class AIMentor {
         const unique = Array.from(new Set(matches));
         throw new Error(`Unresolved include directives in ${context}: ${unique.join(', ')}`);
     }
-    buildReportBackFooter(workflowType, phaseId, phaseFlow) {
+    buildReportBackFooter(jobName, phaseId, phaseFlow) {
         if (!phaseFlow)
             return '';
         const base = `seekMentoring({
-  workflowType: "${workflowType}",
+  jobName: "${jobName}",
   issueNumber: "<issue_number>",
   currentPhase: "${phaseId}",
   status: "complete",`;
@@ -104,8 +104,7 @@ class AIMentor {
         return `${block}\n\n---\n\n${message}`;
     }
     async generateStartingMessage(workflow, phaseId, skipIncludes) {
-        const isJob = workflow.metadata.type === 'job';
-        const entityType = isJob ? 'Job' : 'Workflow';
+        const entityType = 'Job';
         if (workflow.isSimple) {
             const message = `🚀 **Starting ${entityType}: ${workflow.metadata.name}**\n\n${workflow.overview}`;
             this.assertNoUnresolvedIncludes(message, `${workflow.metadata.name} (starting)`);
@@ -118,11 +117,8 @@ class AIMentor {
         const isVeryFirstCall = phaseId === 'starting';
         const targetPhase = isVeryFirstCall ? (workflow.metadata.initialPhase || 'starting') : phaseId;
         let message = '';
-        if (!isJob) {
-            message += `🚀 **Starting Workflow: ${workflow.metadata.name}**\n\n`;
-            if (isVeryFirstCall) {
-                message += `${workflow.overview}\n\n---\n\n`;
-            }
+        if (isVeryFirstCall && workflow.overview) {
+            message += `${workflow.overview}\n\n---\n\n`;
         }
         let instructions = workflow.phases.get(targetPhase);
         if (instructions) {
@@ -132,10 +128,8 @@ class AIMentor {
         else {
             message += `⚠️ No specific instructions found for phase: ${targetPhase}`;
         }
-        if (isJob) {
-            const phaseFlow = workflow.metadata.phases?.[targetPhase];
-            message += this.buildReportBackFooter(workflow.metadata.name, targetPhase, phaseFlow);
-        }
+        const phaseFlow = workflow.metadata.phases?.[targetPhase];
+        message += this.buildReportBackFooter(workflow.metadata.name, targetPhase, phaseFlow);
         if (!skipIncludes) {
             this.assertNoUnresolvedIncludes(message, `${workflow.metadata.name}:${targetPhase} (starting)`);
         }
@@ -146,8 +140,7 @@ class AIMentor {
         };
     }
     async generateCompletionMessage(workflow, phaseId, findings, evidence, skipIncludes) {
-        const isJob = workflow.metadata.type === 'job';
-        const entityType = isJob ? 'Job' : 'Workflow';
+        const entityType = 'Job';
         if (workflow.isSimple) {
             const message = `✅ **${entityType} Complete: ${workflow.metadata.name}**\n\n🎉 Great work! You have completed the ${workflow.metadata.name} ${entityType.toLowerCase()}.`;
             this.assertNoUnresolvedIncludes(message, `${workflow.metadata.name} (complete)`);
@@ -170,21 +163,14 @@ class AIMentor {
         }
         let message = '';
         if (nextPhaseId) {
-            if (isJob) {
-                message += `Great work. Moving to the next phase: **${nextPhaseId}**.\n\n`;
-            }
-            else {
-                message += `✅ **Phase Complete: ${phaseId}**\n\nMoving to the next phase: **${nextPhaseId}**.\n\n`;
-            }
+            message += `Great work. Moving to the next phase: **${nextPhaseId}**.\n\n`;
             let nextInstructions = workflow.phases.get(nextPhaseId);
             if (nextInstructions) {
                 nextInstructions = skipIncludes ? nextInstructions : await this.resolveIncludes(nextInstructions, workflow.path);
                 message += nextInstructions;
             }
-            if (isJob) {
-                const nextPhaseFlow = workflow.metadata.phases?.[nextPhaseId];
-                message += this.buildReportBackFooter(workflow.metadata.name, nextPhaseId, nextPhaseFlow);
-            }
+            const nextPhaseFlow = workflow.metadata.phases?.[nextPhaseId];
+            message += this.buildReportBackFooter(workflow.metadata.name, nextPhaseId, nextPhaseFlow);
         }
         else {
             message += `🎉 **${entityType} Accomplished!** You have completed all phases of the ${workflow.metadata.name} ${entityType.toLowerCase()}.`;
@@ -199,7 +185,7 @@ class AIMentor {
         };
     }
     async generateHelpMessage(workflow, phaseId, status, skipIncludes) {
-        const entityType = workflow.metadata.type === 'job' ? 'Job' : 'Workflow';
+        const entityType = 'Job';
         if (workflow.isSimple) {
             const message = `**${entityType}: ${workflow.metadata.name}**\n\n${workflow.overview}`;
             this.assertNoUnresolvedIncludes(message, `${workflow.metadata.name} (${status})`);
@@ -226,23 +212,19 @@ class AIMentor {
             status
         };
     }
-    async getWorkflowOverview(workflowType) {
-        const workflow = await this.getOrLoadWorkflow(workflowType, 'workflow');
-        return workflow ? { overview: workflow.overview, isSimple: workflow.isSimple } : null;
-    }
     async getJobOverview(jobName) {
-        const job = await this.getOrLoadWorkflow(jobName, 'job');
+        const job = await this.getOrLoadJob(jobName);
         return job ? { overview: job.overview, isSimple: job.isSimple } : null;
     }
-    async getAllWorkflowMetadata() {
-        const items = await this.resolver.listItems('workflow');
-        const workflows = [];
+    async getAllJobMetadata() {
+        const items = await this.resolver.listItems('job');
+        const jobs = [];
         for (const item of items) {
-            const wf = await this.resolver.getWorkflow(item.name, 'workflow');
-            if (wf)
-                workflows.push(wf);
+            const job = await this.resolver.getJob(item.name);
+            if (job)
+                jobs.push(job);
         }
-        return workflows;
+        return jobs;
     }
 }
 exports.AIMentor = AIMentor;

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

@@ -1,85 +1,85 @@
 "use strict";
 /**
  * FRAIM Configuration Loader
- * Loads and validates .fraim/config.json with fallback to defaults
+ * Loads and validates workspace FRAIM config with fallback to defaults.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeFraimConfig = normalizeFraimConfig;
 exports.loadFraimConfig = loadFraimConfig;
 exports.getConfigValue = getConfigValue;
 exports.getRepositoryInfo = getRepositoryInfo;
 const fs_1 = require("fs");
-const path_1 = require("path");
 const types_1 = require("./types");
+const project_fraim_paths_1 = require("./utils/project-fraim-paths");
+function normalizeFraimConfig(config) {
+    // Handle backward compatibility and migration
+    const mergedConfig = {
+        version: config.version || types_1.DEFAULT_FRAIM_CONFIG.version,
+        project: {
+            ...types_1.DEFAULT_FRAIM_CONFIG.project,
+            ...(config.project || {})
+        },
+        repository: {
+            ...types_1.DEFAULT_FRAIM_CONFIG.repository,
+            ...(config.repository || {}),
+            // Migrate from old git config if repository is missing
+            ...((!config.repository && config.git) ? {
+                provider: config.git.provider || 'github',
+                owner: config.git.repoOwner,
+                name: config.git.repoName,
+                defaultBranch: config.git.defaultBranch || 'main'
+            } : {})
+        },
+        customizations: {
+            ...types_1.DEFAULT_FRAIM_CONFIG.customizations,
+            ...(config.customizations || {})
+        }
+    };
+    if (config.customizations?.postCleanupHook || config.customizations?.cleanupCommand) {
+        if (!mergedConfig.customizations)
+            mergedConfig.customizations = {};
+        mergedConfig.customizations.postCleanupHook = config.customizations.postCleanupHook || config.customizations.cleanupCommand;
+    }
+    if (config.issueTracking && typeof config.issueTracking === 'object') {
+        mergedConfig.issueTracking = config.issueTracking;
+    }
+    if (config.compliance) {
+        mergedConfig.compliance = config.compliance;
+    }
+    if (config.learning) {
+        mergedConfig.learning = config.learning;
+    }
+    if (config.competitors && typeof config.competitors === 'object') {
+        mergedConfig.competitors = config.competitors;
+    }
+    return mergedConfig;
+}
 /**
- * Load FRAIM configuration from .fraim/config.json
- * Falls back to defaults if file doesn't exist
+ * Load FRAIM configuration from the workspace FRAIM config file.
+ * Falls back to defaults if the file doesn't exist.
  */
-function loadFraimConfig() {
-    const configPath = (0, path_1.join)(process.cwd(), '.fraim', 'config.json');
+function loadFraimConfig(configPath = (0, project_fraim_paths_1.getWorkspaceConfigPath)(process.cwd())) {
+    const displayPath = (0, project_fraim_paths_1.getWorkspaceFraimDisplayPath)('config.json');
     if (!(0, fs_1.existsSync)(configPath)) {
-        console.log('📋 No .fraim/config.json found, using defaults');
+        console.log(`No ${displayPath} found, using defaults`);
         return { ...types_1.DEFAULT_FRAIM_CONFIG };
     }
     try {
         const configContent = (0, fs_1.readFileSync)(configPath, 'utf-8');
-        const config = JSON.parse(configContent); // Use any for backward compatibility
-        // Handle backward compatibility and migration
-        const mergedConfig = {
-            version: config.version || types_1.DEFAULT_FRAIM_CONFIG.version,
-            project: {
-                ...types_1.DEFAULT_FRAIM_CONFIG.project,
-                ...(config.project || {})
-            },
-            repository: {
-                ...types_1.DEFAULT_FRAIM_CONFIG.repository,
-                ...(config.repository || {}),
-                // Migrate from old git config if repository is missing
-                ...((!config.repository && config.git) ? {
-                    provider: config.git.provider || 'github',
-                    owner: config.git.repoOwner,
-                    name: config.git.repoName,
-                    defaultBranch: config.git.defaultBranch || 'main'
-                } : {})
-            },
-            customizations: {
-                ...types_1.DEFAULT_FRAIM_CONFIG.customizations,
-                ...(config.customizations || {})
-            }
-        };
-        if (config.customizations?.postCleanupHook || config.customizations?.cleanupCommand) {
-            if (!mergedConfig.customizations)
-                mergedConfig.customizations = {};
-            mergedConfig.customizations.postCleanupHook = config.customizations.postCleanupHook || config.customizations.cleanupCommand;
-        }
-        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;
-        }
-        if (config.learning) {
-            mergedConfig.learning = config.learning;
-        }
-        if (config.competitors && typeof config.competitors === 'object') {
-            mergedConfig.competitors = config.competitors;
-        }
-        console.log(`📋 Loaded FRAIM config from .fraim/config.json (version ${mergedConfig.version})`);
-        // Warn about deprecated git config
+        const config = JSON.parse(configContent);
+        const mergedConfig = normalizeFraimConfig(config);
+        console.log(`Loaded FRAIM config from ${displayPath} (version ${mergedConfig.version})`);
         if (config.git && !config.repository) {
-            console.warn('⚠️  Deprecated: "git" config detected. Consider migrating to "repository" config.');
+            console.warn('Deprecated: "git" config detected. Consider migrating to "repository" config.');
         }
         return mergedConfig;
     }
     catch (error) {
-        console.warn(`⚠️  Failed to load .fraim/config.json: ${error instanceof Error ? error.message : 'Unknown error'}`);
-        console.warn('   Using default configuration');
+        console.warn(`Failed to load ${displayPath}: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        console.warn('Using default configuration');
         return { ...types_1.DEFAULT_FRAIM_CONFIG };
     }
 }
-/**
- * Get configuration value by path (e.g., "project.name", "repository.owner")
- */
 function getConfigValue(config, path) {
     const parts = path.split('.');
     let value = config;
@@ -93,11 +93,7 @@ function getConfigValue(config, path) {
     }
     return value;
 }
-/**
- * Get repository info with backward compatibility
- */
 function getRepositoryInfo(config) {
-    // Prefer new repository config
     if (config.repository) {
         return {
             owner: config.repository.owner || config.repository.organization || config.repository.namespace,
@@ -106,7 +102,6 @@ function getRepositoryInfo(config) {
             defaultBranch: config.repository.defaultBranch
         };
     }
-    // Fall back to old git config
     if (config.git) {
         return {
             owner: config.git.repoOwner,