fraim-framework 2.0.96 → 2.0.98

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

@@ -10,27 +10,25 @@ 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., workflows/product-building/spec.md)')
+    .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 fraimDir = path_1.default.join(projectRoot, '.fraim');
-    const configPath = path_1.default.join(fraimDir, 'config.json');
-    // Validate .fraim directory exists
-    if (!fs_1.default.existsSync(fraimDir)) {
-        console.log(chalk_1.default.red('❌ .fraim/ directory not found. Run "fraim setup" or "fraim init-project" first.'));
+    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);
     }
-    // Validate path format
     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);
     }
-    // Ensure exactly one option is specified
     if (options.inherit && options.copy) {
         console.log(chalk_1.default.red('❌ Cannot use both --inherit and --copy. Choose one.'));
         process.exit(1);
@@ -39,13 +37,11 @@ exports.overrideCommand = new commander_1.Command('override')
         console.log(chalk_1.default.red('❌ Must specify either --inherit or --copy.'));
         process.exit(1);
     }
-    // Create personalized override directory structure
-    const overridePath = path_1.default.join(fraimDir, 'personalized-employee', registryPath);
+    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 });
     }
-    // Check if override already exists
     if (fs_1.default.existsSync(overridePath)) {
         console.log(chalk_1.default.yellow(`⚠️ Override already exists: ${registryPath}`));
         console.log(chalk_1.default.gray(`   Location: ${overridePath}`));
@@ -53,22 +49,18 @@ exports.overrideCommand = new commander_1.Command('override')
     }
     let content;
     if (options.inherit) {
-        // Create file with import directive
         content = `{{ import: ${registryPath} }}\n\n<!-- Add your custom content below -->\n`;
-        console.log(chalk_1.default.blue(`📝 Creating inherited override for: ${registryPath}`));
+        console.log(chalk_1.default.blue(`Creating inherited override for: ${registryPath}`));
     }
     else {
-        // Fetch current content from server using MCP protocol
         const isLocal = options.local || false;
         const serverType = isLocal ? 'local server' : 'remote server';
-        console.log(chalk_1.default.blue(`📥 Fetching current content from ${serverType}: ${registryPath}`));
+        console.log(chalk_1.default.blue(`Fetching current content from ${serverType}: ${registryPath}`));
         try {
-            // Read config to get remote URL
             let config = {};
             if (fs_1.default.existsSync(configPath)) {
                 config = JSON.parse(fs_1.default.readFileSync(configPath, 'utf-8'));
             }
-            // Determine server URL
             let serverUrl;
             if (isLocal) {
                 const localPort = process.env.FRAIM_MCP_PORT ? parseInt(process.env.FRAIM_MCP_PORT) : (0, git_utils_1.getPort)();
@@ -78,13 +70,10 @@ exports.overrideCommand = new commander_1.Command('override')
                 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'
-            };
+            const headers = { 'Content-Type': 'application/json' };
             if (apiKey) {
                 headers['x-api-key'] = apiKey;
             }
-            // First, establish session with fraim_connect
             const connectRequest = {
                 jsonrpc: '2.0',
                 id: 0,
@@ -113,19 +102,15 @@ exports.overrideCommand = new commander_1.Command('override')
             if (typeof sessionId !== 'string' || sessionId.trim().length === 0) {
                 throw new Error('fraim_connect did not return a sessionId');
             }
-            // Now determine MCP tool and arguments based on path
             let toolName;
             let toolArgs;
             if (registryPath.startsWith('workflows/')) {
-                // Extract workflow name from path
-                // e.g., "workflows/product-building/spec.md" -> "spec"
                 const parts = registryPath.split('/');
                 const workflowName = parts[parts.length - 1].replace('.md', '');
                 toolName = 'get_fraim_workflow';
                 toolArgs = { workflow: workflowName };
             }
             else if (registryPath.startsWith('jobs/')) {
-                // e.g., "jobs/product-building/feature-specification.md" -> "feature-specification"
                 const parts = registryPath.split('/');
                 const jobName = parts[parts.length - 1].replace('.md', '');
                 toolName = 'get_fraim_job';
@@ -136,7 +121,6 @@ exports.overrideCommand = new commander_1.Command('override')
                 toolArgs = { path: registryPath };
             }
             console.log(chalk_1.default.gray(`   Using MCP tool: ${toolName}`));
-            // Make MCP JSON-RPC request
             const mcpRequest = {
                 jsonrpc: '2.0',
                 id: 1,
@@ -144,19 +128,16 @@ exports.overrideCommand = new commander_1.Command('override')
                 params: {
                     name: toolName,
                     sessionId: sessionId.trim(),
-                    arguments: toolArgs
+                    arguments: {
+                        ...toolArgs,
+                        sessionId: sessionId.trim()
+                    }
                 }
             };
-            // Mirror sessionId in arguments for compatibility with both server and proxy paths.
-            mcpRequest.params.arguments = {
-                ...mcpRequest.params.arguments,
-                sessionId: sessionId.trim()
-            };
             const response = await axios_1.default.post(`${serverUrl}/mcp`, mcpRequest, {
                 headers,
                 timeout: 30000
             });
-            // Extract content from MCP response
             if (response.data.error) {
                 throw new Error(response.data.error.message || 'MCP request failed');
             }
@@ -164,7 +145,6 @@ exports.overrideCommand = new commander_1.Command('override')
             if (!result || !result.content || !Array.isArray(result.content)) {
                 throw new Error('Unexpected MCP response format');
             }
-            // Extract text content from MCP response
             const textContent = result.content.find((c) => c.type === 'text');
             if (!textContent || !textContent.text) {
                 throw new Error('No text content in MCP response');
@@ -175,21 +155,20 @@ exports.overrideCommand = new commander_1.Command('override')
         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)`));
+                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`));
+                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);
         }
     }
-    // Write override file
     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(`   Edit this file to customize for your project`));
+        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}`));

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

@@ -594,7 +594,7 @@ const runSetup = async (options) => {
     console.log(chalk_1.default.cyan('\n📝 For future projects:'));
     console.log(chalk_1.default.cyan('   1. cd into any project directory'));
     console.log(chalk_1.default.cyan('   2. Run: fraim init-project'));
-    console.log(chalk_1.default.cyan('   3. Ask your AI agent "list fraim workflows"'));
+    console.log(chalk_1.default.cyan('   3. Tell your AI agent: "Onboard this project"'));
     if (mode === 'integrated') {
         const allProviderIds = await (0, provider_registry_1.getAllProviderIds)();
         const unconfiguredProviders = allProviderIds.filter(id => !tokens[id]);

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

@@ -45,6 +45,8 @@ const config_loader_1 = require("../../core/config-loader");
 const version_utils_1 = require("../utils/version-utils");
 const script_sync_utils_1 = require("../utils/script-sync-utils");
 const git_utils_1 = require("../../core/utils/git-utils");
+const agent_adapters_1 = require("../utils/agent-adapters");
+const project_fraim_paths_1 = require("../../core/utils/project-fraim-paths");
 /**
  * Load API key from user-level config (~/.fraim/config.json)
  */
@@ -57,8 +59,8 @@ function loadUserApiKey() {
         const userConfig = JSON.parse(fs_1.default.readFileSync(userConfigPath, 'utf8'));
         return userConfig.apiKey;
     }
-    catch (error) {
-        console.warn(chalk_1.default.yellow('⚠️ Failed to read user-level config for API key'));
+    catch {
+        console.warn(chalk_1.default.yellow('Failed to read user-level config for API key'));
         return undefined;
     }
 }
@@ -73,29 +75,27 @@ function updateVersionInConfig(fraimDir) {
         if (currentConfig.version !== newVersion) {
             currentConfig.version = newVersion;
             fs_1.default.writeFileSync(configPath, JSON.stringify(currentConfig, null, 2));
-            console.log(chalk_1.default.green(`✅ Updated FRAIM version to ${newVersion} in config.`));
+            console.log(chalk_1.default.green(`Updated FRAIM version to ${newVersion} in config.`));
         }
     }
-    catch (e) {
-        console.warn(chalk_1.default.yellow('⚠️ Could not update version in config.json.'));
+    catch {
+        console.warn(chalk_1.default.yellow('Could not update version in config.json.'));
     }
 }
 const runSync = async (options) => {
     const projectRoot = process.cwd();
     const config = (0, config_loader_1.loadFraimConfig)();
-    const fraimDir = path_1.default.join(projectRoot, '.fraim');
-    // Check if running via npx
+    const fraimDir = (0, project_fraim_paths_1.getWorkspaceFraimDir)(projectRoot);
     const isNpx = process.env.npm_config_prefix === undefined || process.env.npm_lifecycle_event === 'npx';
     const isGlobal = !isNpx && (process.env.npm_config_global === 'true' || process.env.npm_config_prefix);
     if (isGlobal && !options.skipUpdates) {
-        console.log(chalk_1.default.yellow('⚠️  You are running a global installation of FRAIM.'));
-        console.log(chalk_1.default.gray('   Updates are not automatic in this mode.'));
-        console.log(chalk_1.default.cyan('   💡 Recommended: Use "npx fraim-framework@latest sync" instead.\n'));
+        console.log(chalk_1.default.yellow('You are running a global installation of FRAIM.'));
+        console.log(chalk_1.default.gray('Updates are not automatic in this mode.'));
+        console.log(chalk_1.default.cyan('Recommended: Use "npx fraim-framework@latest sync" instead.\n'));
     }
     const { syncFromRemote } = await Promise.resolve().then(() => __importStar(require('../utils/remote-sync')));
-    // Path 1: --local flag → hit localhost MCP server
     if (options.local) {
-        console.log(chalk_1.default.blue('🔄 Syncing FRAIM workflows from local server...'));
+        console.log(chalk_1.default.blue('Syncing FRAIM jobs from local server...'));
         const localPort = process.env.FRAIM_MCP_PORT ? parseInt(process.env.FRAIM_MCP_PORT) : (0, git_utils_1.getPort)();
         const result = await syncFromRemote({
             remoteUrl: `http://localhost:${localPort}`,
@@ -104,51 +104,58 @@ const runSync = async (options) => {
             skipUpdates: true
         });
         if (result.success) {
-            console.log(chalk_1.default.green(`✅ Successfully synced ${result.workflowsSynced} workflows, ${result.employeeJobsSynced} ai-employee jobs, ${result.managerJobsSynced} ai-manager jobs, ${result.skillsSynced} skills, ${result.rulesSynced} rules, ${result.scriptsSynced} scripts, and ${result.docsSynced} docs from local server`));
+            console.log(chalk_1.default.green(`Successfully synced ${result.employeeJobsSynced} ai-employee jobs, ${result.managerJobsSynced} ai-manager jobs, ${result.skillsSynced} skills, ${result.rulesSynced} rules, ${result.scriptsSynced} scripts, and ${result.docsSynced} docs from local server`));
             updateVersionInConfig(fraimDir);
+            const adapterUpdates = (0, agent_adapters_1.ensureAgentAdapterFiles)(projectRoot);
+            if (adapterUpdates.length > 0) {
+                console.log(chalk_1.default.green(`Updated FRAIM agent adapter files: ${adapterUpdates.join(', ')}`));
+            }
             return;
         }
-        console.error(chalk_1.default.red(`❌ Local sync failed: ${result.error}`));
-        console.error(chalk_1.default.yellow('💡 Make sure the FRAIM MCP server is running locally (npm run dev).'));
+        console.error(chalk_1.default.red(`Local sync failed: ${result.error}`));
+        console.error(chalk_1.default.yellow('Make sure the FRAIM MCP server is running locally (npm run dev).'));
         process.exit(1);
     }
-    // Path 2: Remote sync with API key
     let apiKey = loadUserApiKey() || config.apiKey || process.env.FRAIM_API_KEY;
     if (!apiKey) {
         if (process.env.TEST_MODE === 'true') {
-            console.log(chalk_1.default.yellow('⚠️ TEST_MODE: No API key configured. Using test placeholder key.'));
+            console.log(chalk_1.default.yellow('TEST_MODE: No API key configured. Using test placeholder key.'));
             apiKey = 'test-mode-key';
         }
         else {
-            console.error(chalk_1.default.red('❌ No API key configured. Cannot sync.'));
-            console.error(chalk_1.default.yellow('💡 Set FRAIM_API_KEY in your environment, or add apiKey to ~/.fraim/config.json or .fraim/config.json'));
-            console.error(chalk_1.default.yellow('💡 Or use --local to sync from a locally running FRAIM server.'));
+            console.error(chalk_1.default.red('No API key configured. Cannot sync.'));
+            console.error(chalk_1.default.yellow(`Set FRAIM_API_KEY in your environment, or add apiKey to ~/.fraim/config.json or ${(0, project_fraim_paths_1.getWorkspaceFraimDisplayPath)('config.json')}`));
+            console.error(chalk_1.default.yellow('Or use --local to sync from a locally running FRAIM server.'));
             process.exit(1);
         }
     }
-    console.log(chalk_1.default.blue('🔄 Syncing FRAIM workflows from remote server...'));
+    console.log(chalk_1.default.blue('Syncing FRAIM jobs from remote server...'));
     const result = await syncFromRemote({
         remoteUrl: config.remoteUrl,
-        apiKey: apiKey,
+        apiKey,
         projectRoot,
         skipUpdates: options.skipUpdates || false
     });
     if (!result.success) {
-        console.error(chalk_1.default.red(`❌ Remote sync failed: ${result.error}`));
-        console.error(chalk_1.default.yellow('💡 Check your API key and network connection.'));
+        console.error(chalk_1.default.red(`Remote sync failed: ${result.error}`));
+        console.error(chalk_1.default.yellow('Check your API key and network connection.'));
         if (process.env.TEST_MODE === 'true') {
-            console.log(chalk_1.default.yellow('⚠️ TEST_MODE: Continuing without remote sync (server may be unavailable).'));
+            console.log(chalk_1.default.yellow('TEST_MODE: Continuing without remote sync (server may be unavailable).'));
             updateVersionInConfig(fraimDir);
             return;
         }
         process.exit(1);
     }
-    console.log(chalk_1.default.green(`✅ Successfully synced ${result.workflowsSynced} workflows, ${result.employeeJobsSynced} ai-employee jobs, ${result.managerJobsSynced} ai-manager jobs, ${result.skillsSynced} skills, ${result.rulesSynced} rules, ${result.scriptsSynced} scripts, and ${result.docsSynced} docs from remote`));
+    console.log(chalk_1.default.green(`Successfully synced ${result.employeeJobsSynced} ai-employee jobs, ${result.managerJobsSynced} ai-manager jobs, ${result.skillsSynced} skills, ${result.rulesSynced} rules, ${result.scriptsSynced} scripts, and ${result.docsSynced} docs from remote`));
     updateVersionInConfig(fraimDir);
+    const adapterUpdates = (0, agent_adapters_1.ensureAgentAdapterFiles)(projectRoot);
+    if (adapterUpdates.length > 0) {
+        console.log(chalk_1.default.green(`Updated FRAIM agent adapter files: ${adapterUpdates.join(', ')}`));
+    }
 };
 exports.runSync = runSync;
 exports.syncCommand = new commander_1.Command('sync')
-    .description('Sync workflow stubs from the framework registry')
+    .description('Sync job stubs from the framework registry')
     .option('-f, --force', 'Force sync even if digest matches')
     .option('--skip-updates', 'Skip checking for CLI updates (legacy)')
     .option('--local', 'Sync from local development server (port derived from git branch)')

package/dist/src/cli/doctor/check-runner.js

@@ -76,7 +76,7 @@ async function runCheckWithTimeout(check, timeout = CHECK_TIMEOUT) {
  */
 function filterChecks(checks, options) {
     // If no specific flags, run all checks
-    if (!options.testMcp && !options.testConfig && !options.testWorkflows) {
+    if (!options.testMcp && !options.testConfig && !options.testJobs) {
         return checks;
     }
     return checks.filter(check => {
@@ -84,7 +84,7 @@ function filterChecks(checks, options) {
             return true;
         if (options.testConfig && (check.category === 'globalSetup' || check.category === 'projectSetup' || check.category === 'ideConfiguration'))
             return true;
-        if (options.testWorkflows && check.category === 'workflows')
+        if (options.testJobs && check.category === 'jobs')
             return true;
         return false;
     });
@@ -127,7 +127,7 @@ async function runChecks(checks, options, version) {
     const categories = {
         globalSetup: { checks: [] },
         projectSetup: { checks: [] },
-        workflows: { checks: [] },
+        jobs: { checks: [] },
         ideConfiguration: { checks: [] },
         mcpConnectivity: { checks: [] },
         scripts: { checks: [] }

package/dist/src/cli/doctor/checks/global-setup-checks.js

@@ -12,7 +12,7 @@ exports.getGlobalSetupChecks = getGlobalSetupChecks;
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const os_1 = __importDefault(require("os"));
-const GLOBAL_CONFIG_PATH = path_1.default.join(os_1.default.homedir(), '.fraim', 'config.json');
+const getGlobalConfigPath = () => path_1.default.join(os_1.default.homedir(), '.fraim', 'config.json');
 /**
  * Check if global config exists
  */
@@ -22,11 +22,11 @@ function checkGlobalConfigExists() {
         category: 'globalSetup',
         critical: true,
         run: async () => {
-            if (fs_1.default.existsSync(GLOBAL_CONFIG_PATH)) {
+            if (fs_1.default.existsSync(getGlobalConfigPath())) {
                 return {
                     status: 'passed',
                     message: 'Global config exists',
-                    details: { path: GLOBAL_CONFIG_PATH }
+                    details: { path: getGlobalConfigPath() }
                 };
             }
             return {
@@ -48,13 +48,13 @@ function checkModeValid() {
         critical: false,
         run: async () => {
             try {
-                if (!fs_1.default.existsSync(GLOBAL_CONFIG_PATH)) {
+                if (!fs_1.default.existsSync(getGlobalConfigPath())) {
                     return {
                         status: 'error',
                         message: 'Cannot check mode - global config missing'
                     };
                 }
-                const config = JSON.parse(fs_1.default.readFileSync(GLOBAL_CONFIG_PATH, 'utf8'));
+                const config = JSON.parse(fs_1.default.readFileSync(getGlobalConfigPath(), 'utf8'));
                 const mode = config.mode || 'conversational';
                 const validModes = ['conversational', 'integrated', 'split'];
                 if (validModes.includes(mode)) {
@@ -91,13 +91,13 @@ function checkApiKeyConfigured() {
         critical: false,
         run: async () => {
             try {
-                if (!fs_1.default.existsSync(GLOBAL_CONFIG_PATH)) {
+                if (!fs_1.default.existsSync(getGlobalConfigPath())) {
                     return {
                         status: 'error',
                         message: 'Cannot check API key - global config missing'
                     };
                 }
-                const config = JSON.parse(fs_1.default.readFileSync(GLOBAL_CONFIG_PATH, 'utf8'));
+                const config = JSON.parse(fs_1.default.readFileSync(getGlobalConfigPath(), 'utf8'));
                 if (config.apiKey) {
                     const maskedKey = config.apiKey.substring(0, 10) + '...';
                     return {
@@ -110,7 +110,7 @@ function checkApiKeyConfigured() {
                     status: 'warning',
                     message: 'API key not configured',
                     suggestion: 'Add apiKey to global config for remote features',
-                    details: { configPath: GLOBAL_CONFIG_PATH }
+                    details: { configPath: getGlobalConfigPath() }
                 };
             }
             catch (error) {
@@ -133,13 +133,13 @@ function checkGitHubTokenConfigured() {
         critical: false,
         run: async () => {
             try {
-                if (!fs_1.default.existsSync(GLOBAL_CONFIG_PATH)) {
+                if (!fs_1.default.existsSync(getGlobalConfigPath())) {
                     return {
                         status: 'error',
                         message: 'Cannot check GitHub token - global config missing'
                     };
                 }
-                const config = JSON.parse(fs_1.default.readFileSync(GLOBAL_CONFIG_PATH, 'utf8'));
+                const config = JSON.parse(fs_1.default.readFileSync(getGlobalConfigPath(), 'utf8'));
                 // Check if repository provider is GitHub
                 if (config.repository?.provider === 'github') {
                     // Token would be in IDE MCP configs, not global config
@@ -175,13 +175,13 @@ function checkRemoteUrlConfigured() {
         critical: false,
         run: async () => {
             try {
-                if (!fs_1.default.existsSync(GLOBAL_CONFIG_PATH)) {
+                if (!fs_1.default.existsSync(getGlobalConfigPath())) {
                     return {
                         status: 'error',
                         message: 'Cannot check remote URL - global config missing'
                     };
                 }
-                const config = JSON.parse(fs_1.default.readFileSync(GLOBAL_CONFIG_PATH, 'utf8'));
+                const config = JSON.parse(fs_1.default.readFileSync(getGlobalConfigPath(), 'utf8'));
                 if (config.remoteUrl) {
                     return {
                         status: 'passed',
@@ -193,7 +193,7 @@ function checkRemoteUrlConfigured() {
                 return {
                     status: 'passed',
                     message: 'Remote URL not configured (optional)',
-                    details: { configPath: GLOBAL_CONFIG_PATH, optional: true }
+                    details: { configPath: getGlobalConfigPath(), optional: true }
                 };
             }
             catch (error) {

package/dist/src/cli/doctor/checks/project-setup-checks.js

@@ -10,8 +10,8 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getProjectSetupChecks = getProjectSetupChecks;
 const fs_1 = __importDefault(require("fs"));
-const path_1 = __importDefault(require("path"));
 const child_process_1 = require("child_process");
+const project_fraim_paths_1 = require("../../../core/utils/project-fraim-paths");
 /**
  * Check if project is initialized
  */
@@ -21,8 +21,8 @@ function checkProjectInitialized() {
         category: 'projectSetup',
         critical: true,
         run: async () => {
-            const fraimDir = path_1.default.join(process.cwd(), '.fraim');
-            if (fs_1.default.existsSync(fraimDir)) {
+            const fraimDir = (0, project_fraim_paths_1.getWorkspaceFraimDir)(process.cwd());
+            if ((0, project_fraim_paths_1.workspaceFraimExists)(process.cwd())) {
                 return {
                     status: 'passed',
                     message: 'Project initialized',
@@ -47,7 +47,7 @@ function checkProjectConfigValid() {
         category: 'projectSetup',
         critical: true,
         run: async () => {
-            const configPath = path_1.default.join(process.cwd(), '.fraim', 'config.json');
+            const configPath = (0, project_fraim_paths_1.getWorkspaceConfigPath)(process.cwd());
             if (!fs_1.default.existsSync(configPath)) {
                 return {
                     status: 'error',
@@ -62,7 +62,7 @@ function checkProjectConfigValid() {
                     return {
                         status: 'warning',
                         message: 'Project config incomplete',
-                        suggestion: 'Add project name to .fraim/config.json'
+                        suggestion: `Add project name to ${(0, project_fraim_paths_1.getWorkspaceFraimDisplayPath)('config.json')}`
                     };
                 }
                 return {
@@ -75,7 +75,7 @@ function checkProjectConfigValid() {
                 return {
                     status: 'error',
                     message: 'Project config corrupted',
-                    suggestion: 'Fix JSON syntax in .fraim/config.json',
+                    suggestion: `Fix JSON syntax in ${(0, project_fraim_paths_1.getWorkspaceFraimDisplayPath)('config.json')}`,
                     details: { error: error.message }
                 };
             }
@@ -129,7 +129,7 @@ function checkProviderMatches() {
         category: 'projectSetup',
         critical: false,
         run: async () => {
-            const configPath = path_1.default.join(process.cwd(), '.fraim', 'config.json');
+            const configPath = (0, project_fraim_paths_1.getWorkspaceConfigPath)(process.cwd());
             if (!fs_1.default.existsSync(configPath)) {
                 return {
                     status: 'error',
@@ -163,7 +163,7 @@ function checkProviderMatches() {
                     return {
                         status: 'warning',
                         message: `Provider mismatch: config says ${provider} but remote is ${remote}`,
-                        suggestion: 'Update repository.provider in .fraim/config.json'
+                        suggestion: `Update repository.provider in ${(0, project_fraim_paths_1.getWorkspaceFraimDisplayPath)('config.json')}`
                     };
                 }
                 catch {
@@ -193,7 +193,7 @@ function checkConfigMatchesMode() {
         category: 'projectSetup',
         critical: false,
         run: async () => {
-            const configPath = path_1.default.join(process.cwd(), '.fraim', 'config.json');
+            const configPath = (0, project_fraim_paths_1.getWorkspaceConfigPath)(process.cwd());
             if (!fs_1.default.existsSync(configPath)) {
                 return {
                     status: 'error',
@@ -217,7 +217,7 @@ function checkConfigMatchesMode() {
                         return {
                             status: 'error',
                             message: 'Integrated mode requires repository configuration',
-                            suggestion: 'Add repository config to .fraim/config.json'
+                            suggestion: `Add repository config to ${(0, project_fraim_paths_1.getWorkspaceFraimDisplayPath)('config.json')}`
                         };
                     }
                     return {
@@ -232,14 +232,14 @@ function checkConfigMatchesMode() {
                         return {
                             status: 'error',
                             message: 'Split mode requires repository configuration',
-                            suggestion: 'Add repository config to .fraim/config.json'
+                            suggestion: `Add repository config to ${(0, project_fraim_paths_1.getWorkspaceFraimDisplayPath)('config.json')}`
                         };
                     }
                     if (!config.issueTracking?.provider) {
                         return {
                             status: 'error',
                             message: 'Split mode requires issue tracking configuration',
-                            suggestion: 'Add issueTracking config to .fraim/config.json'
+                            suggestion: `Add issueTracking config to ${(0, project_fraim_paths_1.getWorkspaceFraimDisplayPath)('config.json')}`
                         };
                     }
                     return {

package/dist/src/cli/doctor/checks/scripts-checks.js

@@ -32,7 +32,7 @@ function checkScriptsDirectoryExists() {
             return {
                 status: 'warning',
                 message: 'Scripts directory missing',
-                suggestion: 'Run fraim sync to create scripts directory',
+                suggestion: 'Run fraim sync to hydrate local scripts for the repo.',
                 command: 'fraim sync'
             };
         }
@@ -65,7 +65,7 @@ function checkScriptsSynced() {
                 return {
                     status: 'warning',
                     message: 'No scripts found',
-                    suggestion: 'Run fraim sync to fetch scripts',
+                    suggestion: 'Run fraim sync to hydrate local scripts.',
                     command: 'fraim sync'
                 };
             }