fraim-framework 2.0.106 → 2.0.108

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

@@ -633,24 +633,49 @@ const runSetup = async (options) => {
             console.log(chalk_1.default.cyan('   To initialize a project later, cd into a repo and run: fraim init-project'));
         }
     }
-    // Show summary
-    console.log(chalk_1.default.green('\n🎯 Setup complete!'));
-    console.log(chalk_1.default.gray(`   Mode: ${mode}`));
+    // Show mode-aware summary with clear value prop and next steps
+    console.log(chalk_1.default.green('\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'));
+    console.log(chalk_1.default.green('  FRAIM is ready!'));
+    console.log(chalk_1.default.green('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'));
+    console.log(chalk_1.default.white('\n  FRAIM is an AI management layer that turns you into'));
+    console.log(chalk_1.default.white('  a manager of AI agents. Run multiple agents through'));
+    console.log(chalk_1.default.white('  structured jobs, get manager-style coaching, and build'));
+    console.log(chalk_1.default.white('  a learning loop where agents improve over time.'));
+    console.log(chalk_1.default.gray('\n  60+ jobs across engineering, marketing, fundraising,'));
+    console.log(chalk_1.default.gray('  legal, product, hiring, customer development, and more.'));
+    // Show which IDEs were configured and how to use FRAIM in each
+    const { detectInstalledIDEs: detectIDEs } = await Promise.resolve().then(() => __importStar(require('../setup/ide-detector')));
+    const configuredIDEs = detectIDEs();
+    if (configuredIDEs.length > 0) {
+        const ideNames = configuredIDEs.map(ide => ide.name).join(', ');
+        console.log(chalk_1.default.cyan(`\n  FRAIM is configured for: `) + chalk_1.default.white(ideNames));
+        console.log(chalk_1.default.cyan('\n  Get started — open any of those tools and:'));
+    }
+    else {
+        console.log(chalk_1.default.cyan('\n  Get started — open your AI tool and:'));
+    }
+    // Check if Claude is among configured IDEs
+    const hasClaude = configuredIDEs.some(ide => ide.name.toLowerCase().includes('claude'));
+    if (hasClaude) {
+        console.log(chalk_1.default.white('    /fraim                           ') + chalk_1.default.gray('(Claude Code) Browse all jobs'));
+    }
+    console.log(chalk_1.default.white('    "What can FRAIM help me with?"   ') + chalk_1.default.gray('Works in any AI tool'));
+    console.log(chalk_1.default.gray('\n  Just tell your AI what you need — FRAIM will find the right job.'));
     if (mode !== 'conversational') {
+        console.log(chalk_1.default.cyan('\n  To set up FRAIM in a specific project:'));
+        console.log(chalk_1.default.white('    cd your-project && fraim init-project'));
+        console.log(chalk_1.default.gray('    This enables project-specific customizations,'));
+        console.log(chalk_1.default.gray('    GitHub workflows, and team learning.'));
         const configuredProviders = await Promise.all(Object.keys(tokens).map(async (id) => await (0, provider_registry_1.getProviderDisplayName)(id)));
-        console.log(chalk_1.default.gray(`   Platforms: ${configuredProviders.join(', ') || 'none'}`));
-    }
-    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: "FRAIM was just installed. Read the FRAIM docs, explain what it can do for me, then run project-onboarding."'));
-    if (mode === 'integrated') {
+        if (configuredProviders.length > 0) {
+            console.log(chalk_1.default.gray(`\n  Platforms: ${configuredProviders.join(', ')}`));
+        }
         const allProviderIds = await (0, provider_registry_1.getAllProviderIds)();
         const unconfiguredProviders = allProviderIds.filter(id => !tokens[id]);
         if (unconfiguredProviders.length > 0) {
-            console.log(chalk_1.default.gray('\n💡 To add more platforms later:'));
+            console.log(chalk_1.default.gray('\n  To add more platforms later:'));
             unconfiguredProviders.forEach(id => {
-                console.log(chalk_1.default.gray(`   fraim setup --${id}`));
+                console.log(chalk_1.default.gray(`    fraim setup --${id}`));
             });
         }
     }

package/dist/src/cli/setup/ide-global-integration.js

@@ -22,7 +22,14 @@ const FRAIM_SLASH_COMMAND_CONTENT = `The user wants to run FRAIM. The requested
 
 Follow this process:
 
-1. **If no argument was given** (the line above ends with ": "): call \`list_fraim_jobs()\` to discover available jobs. List each by name and its Intent line. Ask the user which job they want to run, then proceed to step 2.
+1. **If no argument was given** (the line above ends with ": "):
+   Call \`list_fraim_jobs()\` to discover available jobs. Present the results to the user grouped by business function (the server returns jobs organized by category — use those categories as group headings). For each group, list 3-5 of the most impactful jobs with a one-line description.
+
+   After listing, suggest 2-3 starting points based on what seems most relevant:
+   - If in a code repo: suggest jobs from engineering/product-building categories
+   - If no repo context: suggest jobs from marketing, fundraising, or business categories
+
+   Ask the user which job they want to run, then proceed to step 2.
 
 2. **Find the match**: from the list returned by \`list_fraim_jobs()\`, find the job whose name matches or closely resembles the argument. If no job matches, search for a matching skill by calling \`get_fraim_file({ path: "skills/<likely-category>/<argument>.md" })\` — try common categories like \`engineering/\`, \`marketing/\`, \`business/\`, \`product-management/\`, \`ai-tools/\`. Confirm the match with the user.
 

package/dist/src/cli/setup/user-level-sync.js

@@ -1,37 +1,4 @@
 "use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
@@ -39,11 +6,18 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ensureUserLevelDirectories = ensureUserLevelDirectories;
 exports.syncUserLevelArtifacts = syncUserLevelArtifacts;
 /**
- * User-Level FRAIM Artifact Sync
+ * User-Level FRAIM Setup
+ *
+ * Ensures the user-level ~/.fraim/ directory has the minimal structure needed
+ * for FRAIM to work outside of any project:
  *
- * Syncs jobs, skills, rules, and docs stubs from the remote FRAIM server
- * to the user-level ~/.fraim/ directory. This makes FRAIM discoverable
- * everywhere without requiring fraim init-project.
+ * - config.json — auth, mode, tokens (managed by setup.ts)
+ * - scripts/ — locally-executed scripts (synced during any fraim sync)
+ * - personalized-employee/ — user-level overrides and learnings
+ *
+ * Job/skill/rule stubs are NOT synced to user-level. The MCP proxy serves
+ * those on demand via list_fraim_jobs() and get_fraim_job(). Stubs only exist
+ * at project-level (fraim/) where CLAUDE.md tells agents to scan them on disk.
  *
  * Part of: User-Level FRAIM Artifacts with Local Shadow Semantics
  */
@@ -52,21 +26,17 @@ const path_1 = __importDefault(require("path"));
 const chalk_1 = __importDefault(require("chalk"));
 const script_sync_utils_1 = require("../utils/script-sync-utils");
 /**
- * Ensure the user-level FRAIM directory structure exists for content sync.
- * Creates directories for synced content and personalized overrides.
+ * Ensure the user-level FRAIM directory structure exists.
+ * Creates personalized-employee dirs for user-level overrides.
+ * Scripts dir is handled by existing script-sync-utils during any fraim sync.
  */
 function ensureUserLevelDirectories(userFraimDir) {
     const baseDir = userFraimDir || (0, script_sync_utils_1.getUserFraimDir)();
     const dirs = [
-        path_1.default.join(baseDir, 'ai-employee', 'jobs'),
-        path_1.default.join(baseDir, 'ai-employee', 'skills'),
-        path_1.default.join(baseDir, 'ai-employee', 'rules'),
-        path_1.default.join(baseDir, 'ai-manager', 'jobs'),
         path_1.default.join(baseDir, 'personalized-employee', 'jobs'),
         path_1.default.join(baseDir, 'personalized-employee', 'skills'),
         path_1.default.join(baseDir, 'personalized-employee', 'rules'),
         path_1.default.join(baseDir, 'personalized-employee', 'learnings'),
-        path_1.default.join(baseDir, 'docs'),
     ];
     for (const dir of dirs) {
         if (!fs_1.default.existsSync(dir)) {
@@ -75,65 +45,15 @@ function ensureUserLevelDirectories(userFraimDir) {
     }
 }
 /**
- * Sync FRAIM artifacts (jobs, skills, rules, docs) from the remote server
- * to the user-level ~/.fraim/ directory.
- *
- * Uses the same remote sync endpoint as project-level sync, but writes
- * content directly to the user-level directory structure instead of under
- * a project's fraim/ subdirectory.
+ * Set up the user-level FRAIM directory.
+ * Creates the personalized-employee structure so FRAIM works outside any project.
  *
  * @param userFraimDir - Override for the target directory (for testing)
  */
 async function syncUserLevelArtifacts(userFraimDir) {
     const baseDir = userFraimDir || (0, script_sync_utils_1.getUserFraimDir)();
-    console.log(chalk_1.default.blue('📦 Syncing FRAIM content to user-level directory...'));
+    console.log(chalk_1.default.blue('📦 Setting up user-level FRAIM directory...'));
     console.log(chalk_1.default.gray(`   Target: ${baseDir}`));
-    // Ensure directory structure exists
     ensureUserLevelDirectories(baseDir);
-    // Try to sync from remote. If this fails (no network, no key),
-    // we still have the directory structure in place.
-    try {
-        const { syncFromRemote } = await Promise.resolve().then(() => __importStar(require('../utils/remote-sync')));
-        const apiKey = loadApiKeyFromConfig(baseDir);
-        if (!apiKey) {
-            console.log(chalk_1.default.yellow('⚠️  No API key found. User-level content sync skipped.'));
-            console.log(chalk_1.default.gray('   Directory structure created. Content will sync on next fraim sync --global.'));
-            return;
-        }
-        const result = await syncFromRemote({
-            apiKey,
-            projectRoot: baseDir,
-            targetIsUserLevel: true,
-            skipUpdates: true
-        });
-        if (result.success) {
-            console.log(chalk_1.default.green(`✅ Synced ${result.employeeJobsSynced} ai-employee jobs, ` +
-                `${result.managerJobsSynced} ai-manager jobs, ` +
-                `${result.skillsSynced} skills, ${result.rulesSynced} rules, ` +
-                `${result.scriptsSynced} scripts, and ${result.docsSynced} docs to ~/.fraim/`));
-        }
-        else {
-            console.log(chalk_1.default.yellow(`⚠️  User-level content sync failed: ${result.error}`));
-            console.log(chalk_1.default.gray('   Directory structure created. Content will sync on next fraim sync --global.'));
-        }
-    }
-    catch (error) {
-        console.log(chalk_1.default.yellow(`⚠️  User-level content sync failed: ${error.message}`));
-        console.log(chalk_1.default.gray('   Directory structure created. Content will sync on next fraim sync --global.'));
-    }
-}
-/**
- * Load API key from the user-level config file.
- */
-function loadApiKeyFromConfig(userFraimDir) {
-    const configPath = path_1.default.join(userFraimDir, 'config.json');
-    if (!fs_1.default.existsSync(configPath))
-        return undefined;
-    try {
-        const config = JSON.parse(fs_1.default.readFileSync(configPath, 'utf8'));
-        return config.apiKey;
-    }
-    catch {
-        return undefined;
-    }
+    console.log(chalk_1.default.green('✅ User-level FRAIM directory ready'));
 }

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

@@ -135,17 +135,8 @@ async function syncFromRemote(options) {
                 error: 'No files received'
             };
         }
-        // Helper: resolve path within the FRAIM content directory.
-        // For user-level sync, write directly to projectRoot (which IS ~/.fraim/).
-        // For project-level sync, use getWorkspaceFraimPath which prepends 'fraim/'.
-        const resolveFraimPath = (...parts) => {
-            if (options.targetIsUserLevel) {
-                return (0, path_1.join)(options.projectRoot, ...parts);
-            }
-            return (0, project_fraim_paths_1.getWorkspaceFraimPath)(options.projectRoot, ...parts);
-        };
-        const lockTargets = options.targetIsUserLevel ? [] : getSyncedContentLockTargets(options.projectRoot);
-        if (!options.targetIsUserLevel && shouldLockSyncedContent()) {
+        const lockTargets = getSyncedContentLockTargets(options.projectRoot);
+        if (shouldLockSyncedContent()) {
             // If previous sync locked these paths read-only, temporarily unlock before cleanup/write.
             for (const target of lockTargets) {
                 setFileWriteLockRecursively(target, false);
@@ -155,7 +146,7 @@ async function syncFromRemote(options) {
         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 = resolveFraimPath('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 });
         }
@@ -175,7 +166,7 @@ async function syncFromRemote(options) {
             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 = resolveFraimPath('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 });
         }
@@ -196,7 +187,7 @@ async function syncFromRemote(options) {
         }
         // Sync skill STUBS to fraim/ai-employee/skills/
         const skillFiles = files.filter(f => f.type === 'skill');
-        const skillsDir = resolveFraimPath('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 });
         }
@@ -216,7 +207,7 @@ async function syncFromRemote(options) {
         }
         // Sync rule STUBS to fraim/ai-employee/rules/
         const ruleFiles = files.filter(f => f.type === 'rule');
-        const rulesDir = resolveFraimPath('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 });
         }
@@ -255,7 +246,7 @@ async function syncFromRemote(options) {
         }
         // Sync docs to fraim/docs/
         const docsFiles = files.filter(f => f.type === 'docs');
-        const docsDir = resolveFraimPath('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 });
         }
@@ -269,7 +260,7 @@ async function syncFromRemote(options) {
             (0, fs_1.writeFileSync)(filePath, file.content, 'utf8');
             console.log(chalk_1.default.gray(`  + ${(0, project_fraim_paths_1.getWorkspaceFraimDisplayPath)(`docs/${file.path}`)}`));
         }
-        if (!options.targetIsUserLevel && shouldLockSyncedContent()) {
+        if (shouldLockSyncedContent()) {
             for (const target of lockTargets) {
                 setFileWriteLockRecursively(target, true);
             }

package/package.json

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