fraim-framework 2.0.96 → 2.0.97

package/bin/fraim.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 
 /**
  * FRAIM Framework CLI Entry Point

package/dist/src/cli/commands/add-ide.js

@@ -417,7 +417,7 @@ const runAddIDE = async (options) => {
     if (results.successful.length > 0) {
         console.log(chalk_1.default.blue('\n🔄 Next steps:'));
         console.log(chalk_1.default.cyan('   1. Restart your configured IDEs'));
-        console.log(chalk_1.default.cyan('   2. Ask your AI agent: "list fraim workflows"'));
+        console.log(chalk_1.default.cyan('   2. In any FRAIM-enabled repo, tell your AI agent: "Onboard this project"'));
         console.log(chalk_1.default.blue('\n💡 Use "fraim doctor --test-mcp" to verify the configuration.'));
     }
 };

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

@@ -53,7 +53,7 @@ function getAllChecks() {
     return [
         ...(0, global_setup_checks_1.getGlobalSetupChecks)(),
         ...(0, project_setup_checks_1.getProjectSetupChecks)(),
-        ...(0, workflow_checks_1.getWorkflowChecks)(),
+        ...(0, workflow_checks_1.getJobChecks)(),
         ...(0, ide_config_checks_1.getIDEConfigChecks)(),
         ...(0, mcp_connectivity_checks_1.getMCPConnectivityChecks)(),
         ...(0, scripts_checks_1.getScriptsChecks)()
@@ -63,7 +63,7 @@ exports.doctorCommand = new commander_1.Command('doctor')
     .description('Validate FRAIM installation and configuration')
     .option('--test-mcp', 'Test only MCP server connectivity')
     .option('--test-config', 'Validate only configuration files')
-    .option('--test-workflows', 'Check only workflow status')
+    .option('--test-jobs', 'Check only job status')
     .option('--verbose', 'Show detailed output including successful checks')
     .option('--json', 'Output results as JSON')
     .action(async (cmdOptions) => {
@@ -71,7 +71,7 @@ exports.doctorCommand = new commander_1.Command('doctor')
     const options = {
         testMcp: cmdOptions.testMcp,
         testConfig: cmdOptions.testConfig,
-        testWorkflows: cmdOptions.testWorkflows,
+        testJobs: cmdOptions.testJobs,
         verbose: cmdOptions.verbose,
         json: cmdOptions.json
     };
@@ -80,7 +80,7 @@ exports.doctorCommand = new commander_1.Command('doctor')
         flags: {
             testMcp: options.testMcp || false,
             testConfig: options.testConfig || false,
-            testWorkflows: options.testWorkflows || false,
+            testJobs: options.testJobs || false,
             verbose: options.verbose || false,
             json: options.json || false
         }
@@ -92,8 +92,8 @@ exports.doctorCommand = new commander_1.Command('doctor')
         trackMetric('doctor.flags.test_mcp', 1);
     if (options.testConfig)
         trackMetric('doctor.flags.test_config', 1);
-    if (options.testWorkflows)
-        trackMetric('doctor.flags.test_workflows', 1);
+    if (options.testJobs)
+        trackMetric('doctor.flags.test_jobs', 1);
     if (options.verbose)
         trackMetric('doctor.flags.verbose', 1);
     if (options.json)

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

@@ -18,13 +18,17 @@ const ide_detector_1 = require("../setup/ide-detector");
 const codex_local_config_1 = require("../setup/codex-local-config");
 const provider_registry_1 = require("../providers/provider-registry");
 const fraim_gitignore_1 = require("../utils/fraim-gitignore");
+const config_writer_1 = require("../../core/config-writer");
+const agent_adapters_1 = require("../utils/agent-adapters");
+const project_fraim_paths_1 = require("../../core/utils/project-fraim-paths");
+const project_bootstrap_1 = require("../utils/project-bootstrap");
 const promptForJiraProjectKey = async (jiraBaseUrl) => {
-    console.log(chalk_1.default.blue('\n🎫 Jira Project Configuration'));
+    console.log(chalk_1.default.blue('\nJira Project Configuration'));
     console.log(chalk_1.default.gray(`Jira instance: ${jiraBaseUrl}`));
     console.log(chalk_1.default.gray('Enter the Jira project key for this repository (e.g., TEAM, PROJ, DEV)\n'));
     if (process.env.FRAIM_NON_INTERACTIVE) {
         const defaultKey = process.env.FRAIM_JIRA_PROJECT_KEY || 'PROJ';
-        console.log(chalk_1.default.yellow(`\nℹ️  Non-interactive mode: using Jira project key "${defaultKey}"`));
+        console.log(chalk_1.default.yellow(`\nNon-interactive mode: using Jira project key "${defaultKey}"`));
         return defaultKey;
     }
     const response = await (0, prompts_1.default)({
@@ -42,7 +46,7 @@ const promptForJiraProjectKey = async (jiraBaseUrl) => {
         }
     });
     if (!response.projectKey) {
-        console.log(chalk_1.default.red('\n❌ Jira project key is required for split mode'));
+        console.log(chalk_1.default.red('\nJira project key is required for split mode'));
         process.exit(1);
     }
     return response.projectKey.trim().toUpperCase();
@@ -66,18 +70,12 @@ const checkGlobalSetup = () => {
         return { exists: true, mode: 'integrated', tokens: {} };
     }
 };
-/**
- * Install GitHub workflow files to .github/workflows/
- * Gracefully handles cases where gh CLI is not available
- */
 const installGitHubWorkflows = (projectRoot) => {
     const workflowsDir = path_1.default.join(projectRoot, '.github', 'workflows');
-    // Find registry directory (works in both dev and installed package)
     const registryDir = fs_1.default.existsSync(path_1.default.join(__dirname, '..', '..', '..', 'registry'))
         ? path_1.default.join(__dirname, '..', '..', '..', 'registry')
         : path_1.default.join(__dirname, '..', '..', 'registry');
     const sourceDir = path_1.default.join(registryDir, 'github', 'workflows');
-    // Create .github/workflows directory if it doesn't exist
     if (!fs_1.default.existsSync(workflowsDir)) {
         fs_1.default.mkdirSync(workflowsDir, { recursive: true });
     }
@@ -94,12 +92,7 @@ const installGitHubWorkflows = (projectRoot) => {
         }
     });
 };
-/**
- * Create GitHub labels using gh CLI
- * Gracefully handles cases where gh CLI is not available
- */
 const createGitHubLabels = (projectRoot) => {
-    // Check if gh CLI is available
     try {
         (0, child_process_1.execSync)('gh --version', { stdio: 'ignore' });
     }
@@ -108,7 +101,6 @@ const createGitHubLabels = (projectRoot) => {
         console.log(chalk_1.default.gray('Install gh CLI to enable automatic label creation: https://cli.github.com/'));
         return;
     }
-    // Read labels from labels.json
     const labelsPath = path_1.default.join(__dirname, '..', '..', '..', 'labels.json');
     if (!fs_1.default.existsSync(labelsPath)) {
         console.log(chalk_1.default.yellow('labels.json not found. Skipping label creation.'));
@@ -118,12 +110,10 @@ const createGitHubLabels = (projectRoot) => {
         const labels = JSON.parse(fs_1.default.readFileSync(labelsPath, 'utf8'));
         labels.forEach((label) => {
             try {
-                // Try to create the label, ignore if it already exists
                 (0, child_process_1.execSync)(`gh label create "${label.name}" --color "${label.color}" --description "${label.description}"`, { cwd: projectRoot, stdio: 'ignore' });
                 console.log(chalk_1.default.green(`Created label: ${label.name}`));
             }
             catch (error) {
-                // Label might already exist, which is fine
                 if (error.message && error.message.includes('already exists')) {
                     console.log(chalk_1.default.gray(`Label already exists: ${label.name}`));
                 }
@@ -147,18 +137,25 @@ const runInitProject = async () => {
         process.exit(1);
     }
     const projectRoot = process.cwd();
-    const fraimDir = path_1.default.join(projectRoot, '.fraim');
-    const configPath = path_1.default.join(fraimDir, 'config.json');
+    const fraimDirDisplayPath = (0, project_fraim_paths_1.getWorkspaceFraimDisplayPath)();
+    const configDisplayPath = (0, project_fraim_paths_1.getWorkspaceFraimDisplayPath)('config.json');
+    const fraimDir = (0, project_fraim_paths_1.getWorkspaceFraimDir)(projectRoot);
+    const configPath = (0, project_fraim_paths_1.getWorkspaceConfigPath)(projectRoot);
+    const projectName = path_1.default.basename(projectRoot);
+    const result = (0, project_bootstrap_1.createInitProjectResult)(projectName, globalSetup.mode || 'integrated');
+    result.bootstrapNeeded = !fs_1.default.existsSync(configPath);
     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 ${fraimDirDisplayPath} directory`));
+        (0, project_bootstrap_1.recordPathStatus)(result, fraimDirDisplayPath, true);
     }
     else {
-        console.log(chalk_1.default.yellow('.fraim directory already exists'));
+        console.log(chalk_1.default.yellow(`${fraimDirDisplayPath} directory already exists`));
+        (0, project_bootstrap_1.recordPathStatus)(result, fraimDirDisplayPath, false);
     }
     if (!fs_1.default.existsSync(configPath)) {
-        const projectName = path_1.default.basename(projectRoot);
         const preferredMode = globalSetup.mode || 'integrated';
+        result.mode = preferredMode;
         let config;
         if (preferredMode === 'conversational') {
             config = {
@@ -174,20 +171,19 @@ const runInitProject = async () => {
         else {
             const detection = (0, platform_detection_1.detectPlatformFromGit)();
             if (detection.provider !== 'unknown' && detection.repository) {
-                // Determine issue tracking configuration
+                result.repositoryDetected = true;
                 let issueTracking;
-                // In split mode with Jira configured, use Jira for issue tracking
                 const jiraConfig = globalSetup.providerConfigs?.jiraConfig;
                 if (preferredMode === 'split' && globalSetup.tokens?.jira && jiraConfig?.baseUrl) {
-                    // Prompt for Jira project key (project-specific)
                     const projectKey = process.env.FRAIM_JIRA_PROJECT_KEY ||
                         await promptForJiraProjectKey(jiraConfig.baseUrl);
                     issueTracking = {
                         provider: 'jira',
                         baseUrl: jiraConfig.baseUrl,
-                        projectKey: projectKey,
+                        projectKey,
                         email: jiraConfig.email
                     };
+                    result.issueTrackingDetected = true;
                     console.log(chalk_1.default.blue(`   Code Repository: ${detection.provider.toUpperCase()}`));
                     console.log(chalk_1.default.blue(`   Issue Tracking: JIRA (${projectKey})`));
                 }
@@ -196,6 +192,11 @@ const runInitProject = async () => {
                         provider: detection.provider,
                         ...detection.repository
                     };
+                    result.issueTrackingDetected = true;
+                    if (preferredMode === 'split') {
+                        result.mode = 'integrated';
+                        result.warnings.push('Split mode is not fully configured for this repo yet, so issue tracking fell back to the repository provider.');
+                    }
                     const providerDef = await (0, provider_registry_1.getProvider)(detection.provider);
                     console.log(chalk_1.default.blue(`   Platform: ${providerDef?.displayName || detection.provider.toUpperCase()}`));
                 }
@@ -208,7 +209,6 @@ const runInitProject = async () => {
                     issueTracking,
                     customizations: {}
                 };
-                // Display repository info based on available fields
                 const repo = detection.repository;
                 if (repo.owner && repo.name) {
                     console.log(chalk_1.default.gray(`   Repository: ${repo.owner}/${repo.name}`));
@@ -231,31 +231,57 @@ const runInitProject = async () => {
                     },
                     customizations: {}
                 };
+                result.mode = 'conversational';
+                result.warnings.push('No git remote detected. FRAIM fell back to conversational project setup.');
                 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'));
+        (0, config_writer_1.writeFraimConfig)(configPath, config);
+        console.log(chalk_1.default.green(`Created ${configDisplayPath}`));
+        (0, project_bootstrap_1.recordPathStatus)(result, configDisplayPath, true);
     }
-    ['workflows', 'ai-employee/jobs', 'ai-employee/skills', 'ai-manager/jobs', 'personalized-employee'].forEach((dir) => {
+    else {
+        (0, project_bootstrap_1.recordPathStatus)(result, configDisplayPath, false);
+        try {
+            const existingConfig = JSON.parse(fs_1.default.readFileSync(configPath, 'utf8'));
+            if (existingConfig.mode === 'conversational' || existingConfig.mode === 'integrated' || existingConfig.mode === 'split') {
+                result.mode = existingConfig.mode;
+            }
+            result.repositoryDetected = Boolean(existingConfig.repository?.provider);
+            result.issueTrackingDetected = Boolean(existingConfig.issueTracking?.provider);
+        }
+        catch {
+            result.warnings.push(`Existing ${configDisplayPath} could not be parsed for summary details.`);
+        }
+    }
+    ['jobs', 'ai-employee/jobs', 'ai-employee/skills', 'ai-manager/jobs', 'personalized-employee'].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}`));
+            const displayPath = (0, project_fraim_paths_1.getWorkspaceFraimDisplayPath)(dir);
+            console.log(chalk_1.default.green(`Created ${displayPath}`));
+            (0, project_bootstrap_1.recordPathStatus)(result, displayPath, true);
+        }
+        else {
+            (0, project_bootstrap_1.recordPathStatus)(result, (0, project_fraim_paths_1.getWorkspaceFraimDisplayPath)(dir), false);
         }
     });
     if ((0, fraim_gitignore_1.ensureFraimSyncedContentIgnored)(projectRoot)) {
-        console.log(chalk_1.default.green('Updated .gitignore with FRAIM synced content ignore rules'));
+        console.log(chalk_1.default.green('Updated .gitignore FRAIM managed block'));
     }
-    // Install GitHub workflows and create labels for GitHub repositories
     const detection = (0, platform_detection_1.detectPlatformFromGit)();
     if (detection.provider === 'github') {
         console.log(chalk_1.default.blue('\nSetting up GitHub workflows and labels...'));
         installGitHubWorkflows(projectRoot);
         createGitHubLabels(projectRoot);
+        result.repositoryDetected = true;
     }
     if (!process.env.FRAIM_SKIP_SYNC) {
         await (0, sync_1.runSync)({});
+        result.syncPerformed = true;
+    }
+    else {
+        result.warnings.push('Sync was skipped for this run.');
     }
     const codexAvailable = (0, ide_detector_1.detectInstalledIDEs)().some((ide) => ide.configType === 'codex');
     if (codexAvailable) {
@@ -263,26 +289,11 @@ const runInitProject = async () => {
         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('\nFRAIM project initialized!'));
-    if (!process.env.FRAIM_NON_INTERACTIVE) {
-        const response = await (0, prompts_1.default)({
-            type: 'confirm',
-            name: 'runOnboarding',
-            message: 'Would you like to set up your AI employee for success? Use the "ai-manager/jobs/project-setup/project-onboarding" job now.',
-            initial: true
-        });
-        if (response.runOnboarding) {
-            console.log(chalk_1.default.blue('\n🚀 Proactive Onboarding: Project Success Setup'));
-            console.log(chalk_1.default.gray('Simply tell your AI agent: "run the project-onboarding job under ai-manager/project-setup"'));
-            console.log(chalk_1.default.gray('This will help the AI understand your project goals, tech stack, and industry context.'));
-        }
-        else {
-            console.log(chalk_1.default.cyan('\nTip: You can always ask your AI agent to "list fraim jobs" to see what\'s available.'));
-        }
-    }
-    else {
-        console.log(chalk_1.default.cyan('\nWould you like to set up your AI employee for success? Use the "ai-manager/jobs/project-setup/project-onboarding" job now.'));
+    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(', ')}`));
     }
+    (0, project_bootstrap_1.printInitProjectSummary)(result);
 };
 exports.runInitProject = runInitProject;
 exports.initProjectCommand = new commander_1.Command('init-project')

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

@@ -8,22 +8,18 @@ const commander_1 = require("commander");
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const chalk_1 = __importDefault(require("chalk"));
+const project_fraim_paths_1 = require("../../core/utils/project-fraim-paths");
 exports.listOverridableCommand = new commander_1.Command('list-overridable')
     .description('List all FRAIM registry paths that can be overridden')
-    .option('--job-category <category>', 'Filter by workflow category (e.g., product-building, customer-development, marketing)')
+    .option('--job-category <category>', 'Filter by job category (e.g., product-building, customer-development, marketing)')
     .option('--rules', 'Show all overridable rules')
     .action(async (options) => {
     const projectRoot = process.cwd();
-    const fraimDir = path_1.default.join(projectRoot, '.fraim');
-    const configPath = path_1.default.join(fraimDir, 'config.json');
-    const personalizedDir = path_1.default.join(fraimDir, 'personalized-employee');
-    const legacyOverridesDir = path_1.default.join(fraimDir, 'overrides');
-    // 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 personalizedDir = (0, project_fraim_paths_1.getWorkspaceFraimPath)(projectRoot, '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);
     }
-    // Determine registry location (try framework root first, then node_modules)
     let registryRoot = null;
     const frameworkRoot = path_1.default.join(__dirname, '..', '..', '..');
     const frameworkRegistry = path_1.default.join(frameworkRoot, 'registry');
@@ -37,11 +33,10 @@ exports.listOverridableCommand = new commander_1.Command('list-overridable')
         }
     }
     if (!registryRoot) {
-        console.log(chalk_1.default.red('❌ Could not find FRAIM registry. Please ensure @fraim/framework is installed.'));
+        console.log(chalk_1.default.red('Could not find FRAIM registry. Please ensure @fraim/framework is installed.'));
         process.exit(1);
     }
-    console.log(chalk_1.default.blue('📋 Overridable FRAIM Registry Paths:\n'));
-    // Get list of existing overrides
+    console.log(chalk_1.default.blue('Overridable FRAIM Registry Paths:\n'));
     const existingOverrides = new Set();
     const scanDir = (dir, base = '') => {
         const entries = fs_1.default.readdirSync(dir, { withFileTypes: true });
@@ -58,10 +53,6 @@ exports.listOverridableCommand = new commander_1.Command('list-overridable')
     if (fs_1.default.existsSync(personalizedDir)) {
         scanDir(personalizedDir);
     }
-    if (fs_1.default.existsSync(legacyOverridesDir)) {
-        scanDir(legacyOverridesDir);
-    }
-    // Handle --rules flag
     if (options.rules) {
         const rulesDir = path_1.default.join(registryRoot, 'rules');
         if (fs_1.default.existsSync(rulesDir)) {
@@ -72,9 +63,7 @@ exports.listOverridableCommand = new commander_1.Command('list-overridable')
             for (const file of ruleFiles) {
                 const filePath = `rules/${file}`;
                 const hasOverride = existingOverrides.has(filePath);
-                const status = hasOverride
-                    ? chalk_1.default.green('[OVERRIDDEN]')
-                    : chalk_1.default.gray('[OVERRIDABLE]');
+                const status = hasOverride ? chalk_1.default.green('[OVERRIDDEN]') : chalk_1.default.gray('[OVERRIDABLE]');
                 console.log(`  ${status} ${filePath}`);
             }
             console.log('');
@@ -82,15 +71,14 @@ exports.listOverridableCommand = new commander_1.Command('list-overridable')
         showTips();
         return;
     }
-    // Handle --job-category flag
     if (options.jobCategory) {
         const category = options.jobCategory;
-        const workflowsDir = path_1.default.join(registryRoot, 'workflows', category);
+        const jobsDir = path_1.default.join(registryRoot, 'jobs', category);
         const templatesDir = path_1.default.join(registryRoot, 'templates', category);
-        if (!fs_1.default.existsSync(workflowsDir)) {
-            console.log(chalk_1.default.red(`❌ Category "${category}" not found.`));
+        if (!fs_1.default.existsSync(jobsDir)) {
+            console.log(chalk_1.default.red(`Category "${category}" not found.`));
             console.log(chalk_1.default.gray('\nAvailable categories:'));
-            const categoriesDir = path_1.default.join(registryRoot, 'workflows');
+            const categoriesDir = path_1.default.join(registryRoot, 'jobs');
             const categories = fs_1.default.readdirSync(categoriesDir, { withFileTypes: true })
                 .filter(d => d.isDirectory())
                 .map(d => d.name)
@@ -98,21 +86,17 @@ exports.listOverridableCommand = new commander_1.Command('list-overridable')
             categories.forEach(c => console.log(chalk_1.default.gray(`  - ${c}`)));
             process.exit(1);
         }
-        // Show workflows for this category
-        console.log(chalk_1.default.bold.cyan(`Workflows (${category}):\n`));
-        const workflowFiles = fs_1.default.readdirSync(workflowsDir)
+        console.log(chalk_1.default.bold.cyan(`Jobs (${category}):\n`));
+        const jobFiles = fs_1.default.readdirSync(jobsDir)
             .filter(f => f.endsWith('.md'))
             .sort();
-        for (const file of workflowFiles) {
-            const filePath = `workflows/${category}/${file}`;
+        for (const file of jobFiles) {
+            const filePath = `jobs/${category}/${file}`;
             const hasOverride = existingOverrides.has(filePath);
-            const status = hasOverride
-                ? chalk_1.default.green('[OVERRIDDEN]')
-                : chalk_1.default.gray('[OVERRIDABLE]');
+            const status = hasOverride ? chalk_1.default.green('[OVERRIDDEN]') : chalk_1.default.gray('[OVERRIDABLE]');
             console.log(`  ${status} ${filePath}`);
         }
         console.log('');
-        // Show templates for this category (if they exist)
         if (fs_1.default.existsSync(templatesDir)) {
             console.log(chalk_1.default.bold.cyan(`Templates (${category}):\n`));
             const templateFiles = fs_1.default.readdirSync(templatesDir)
@@ -121,9 +105,7 @@ exports.listOverridableCommand = new commander_1.Command('list-overridable')
             for (const file of templateFiles) {
                 const filePath = `templates/${category}/${file}`;
                 const hasOverride = existingOverrides.has(filePath);
-                const status = hasOverride
-                    ? chalk_1.default.green('[OVERRIDDEN]')
-                    : chalk_1.default.gray('[OVERRIDABLE]');
+                const status = hasOverride ? chalk_1.default.green('[OVERRIDDEN]') : chalk_1.default.gray('[OVERRIDABLE]');
                 console.log(`  ${status} ${filePath}`);
             }
             console.log('');
@@ -131,34 +113,30 @@ exports.listOverridableCommand = new commander_1.Command('list-overridable')
         showTips();
         return;
     }
-    // Default: Show available categories and existing overrides
-    console.log(chalk_1.default.bold.cyan('Available Workflow Categories:\n'));
-    const workflowsDir = path_1.default.join(registryRoot, 'workflows');
-    const categories = fs_1.default.readdirSync(workflowsDir, { withFileTypes: true })
+    console.log(chalk_1.default.bold.cyan('Available Job Categories:\n'));
+    const jobsDir = path_1.default.join(registryRoot, 'jobs');
+    const categories = fs_1.default.readdirSync(jobsDir, { withFileTypes: true })
         .filter(d => d.isDirectory())
         .map(d => d.name)
         .sort();
-    // Group categories for better display
     const columns = 3;
     for (let i = 0; i < categories.length; i += columns) {
         const row = categories.slice(i, i + columns);
-        const formatted = row.map(cat => chalk_1.default.gray(`  • ${cat.padEnd(30)}`)).join('');
+        const formatted = row.map(cat => chalk_1.default.gray(`  - ${cat.padEnd(30)}`)).join('');
         console.log(formatted);
     }
     console.log('');
-    // Show existing overrides
     if (existingOverrides.size > 0) {
         console.log(chalk_1.default.bold.cyan('Your Active Overrides:\n'));
-        // Group by type
         const overridesByType = {
-            workflows: [],
+            jobs: [],
             templates: [],
             rules: [],
             other: []
         };
         for (const override of Array.from(existingOverrides).sort()) {
-            if (override.startsWith('workflows/')) {
-                overridesByType.workflows.push(override);
+            if (override.startsWith('jobs/')) {
+                overridesByType.jobs.push(override);
             }
             else if (override.startsWith('templates/')) {
                 overridesByType.templates.push(override);
@@ -170,9 +148,9 @@ exports.listOverridableCommand = new commander_1.Command('list-overridable')
                 overridesByType.other.push(override);
             }
         }
-        if (overridesByType.workflows.length > 0) {
-            console.log(chalk_1.default.gray('  Workflows:'));
-            overridesByType.workflows.forEach(o => console.log(`    ${chalk_1.default.green('[OVERRIDDEN]')} ${o}`));
+        if (overridesByType.jobs.length > 0) {
+            console.log(chalk_1.default.gray('  Jobs:'));
+            overridesByType.jobs.forEach(o => console.log(`    ${chalk_1.default.green('[OVERRIDDEN]')} ${o}`));
             console.log('');
         }
         if (overridesByType.templates.length > 0) {
@@ -197,10 +175,10 @@ exports.listOverridableCommand = new commander_1.Command('list-overridable')
     showTips();
     function showTips() {
         console.log(chalk_1.default.gray('Tips:'));
-        console.log(chalk_1.default.gray('  • Use "fraim override <path> --inherit" to inherit from global'));
-        console.log(chalk_1.default.gray('  • Use "fraim override <path> --copy" to copy current content'));
-        console.log(chalk_1.default.gray('  • Use --job-category <category> to see category-specific items'));
-        console.log(chalk_1.default.gray('  • Use --rules to see all overridable rules'));
-        console.log(chalk_1.default.gray('  • Overrides are stored in .fraim/personalized-employee/'));
+        console.log(chalk_1.default.gray('  - Use "fraim override <path> --inherit" to inherit from global'));
+        console.log(chalk_1.default.gray('  - Use "fraim override <path> --copy" to copy current content'));
+        console.log(chalk_1.default.gray('  - Use --job-category <category> to see category-specific items'));
+        console.log(chalk_1.default.gray('  - Use --rules to see all overridable rules'));
+        console.log(chalk_1.default.gray(`  - Overrides are stored in ${(0, project_fraim_paths_1.getWorkspaceFraimDisplayPath)('personalized-employee')}`));
     }
 });

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

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

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

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