fraim-framework 2.0.85 → 2.0.87

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/init-project.js

@@ -16,6 +16,7 @@ const version_utils_1 = require("../utils/version-utils");
 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 promptForJiraProjectKey = async (jiraBaseUrl) => {
     console.log(chalk_1.default.blue('\n🎫 Jira Project Configuration'));
     console.log(chalk_1.default.gray(`Jira instance: ${jiraBaseUrl}`));
@@ -166,6 +167,9 @@ const runInitProject = async () => {
             console.log(chalk_1.default.green(`Created .fraim/${dir}`));
         }
     });
+    if ((0, fraim_gitignore_1.ensureFraimSyncedContentIgnored)(projectRoot)) {
+        console.log(chalk_1.default.green('Updated .gitignore with FRAIM synced content ignore rules'));
+    }
     if (!process.env.FRAIM_SKIP_SYNC) {
         await (0, sync_1.runSync)({});
     }

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

@@ -46,11 +46,19 @@ const path_1 = __importDefault(require("path"));
 const auto_mcp_setup_1 = require("../setup/auto-mcp-setup");
 const version_utils_1 = require("../utils/version-utils");
 const platform_detection_1 = require("../utils/platform-detection");
-const get_provider_client_1 = require("../api/get-provider-client");
+const provider_client_1 = require("../api/provider-client");
 const provider_prompts_1 = require("../setup/provider-prompts");
 const provider_registry_1 = require("../providers/provider-registry");
 const init_project_1 = require("./init-project");
 const script_sync_utils_1 = require("../utils/script-sync-utils");
+function parseModeOption(mode) {
+    if (mode === 'conversational' || mode === 'integrated' || mode === 'split') {
+        return mode;
+    }
+    console.log(chalk_1.default.red(`❌ Invalid mode "${mode}"`));
+    console.log(chalk_1.default.yellow('💡 Valid values: integrated, split, conversational'));
+    process.exit(1);
+}
 const promptForFraimKey = async () => {
     console.log(chalk_1.default.blue('🔑 FRAIM Key Setup'));
     console.log('FRAIM requires a valid API key to access workflows and features.\n');
@@ -293,22 +301,28 @@ const runSetup = async (options) => {
         // Get FRAIM key
         fraimKey = options.key || await promptForFraimKey();
         console.log(chalk_1.default.green('✅ FRAIM key accepted\n'));
-        // Ask for mode preference
-        mode = await promptForMode();
+        // Ask for mode preference (or use explicit option)
+        mode = options.mode ? parseModeOption(options.mode) : await promptForMode();
+        // Parse provider CLI flags on first-time setup too
+        const parsed = await parseLegacyOptions(options, fraimKey);
+        requestedProviders = parsed.requestedProviders;
+        providedTokens = parsed.providedTokens;
+        providedConfigs = parsed.providedConfigs;
     }
+    const providerClient = new provider_client_1.ProviderClient(fraimKey, process.env.FRAIM_REMOTE_URL || undefined);
     // Handle platform tokens based on mode
     if (mode === 'integrated') {
         let providersToSetup = requestedProviders;
         // If no specific providers requested and not an update, ask user
         if (!isUpdate && providersToSetup.length === 0) {
-            providersToSetup = await (0, provider_prompts_1.promptForProviders)((0, get_provider_client_1.getProviderClient)());
+            providersToSetup = await (0, provider_prompts_1.promptForProviders)(providerClient);
         }
         // Get credentials for each provider
         for (const providerId of providersToSetup) {
             if (!tokens[providerId]) {
                 try {
                     // Use provided tokens if available, otherwise prompt
-                    const creds = await (0, provider_prompts_1.promptForProviderCredentials)((0, get_provider_client_1.getProviderClient)(), providerId, providedTokens[providerId], providedConfigs[providerId]);
+                    const creds = await (0, provider_prompts_1.promptForProviderCredentials)(providerClient, providerId, providedTokens[providerId], providedConfigs[providerId]);
                     tokens[providerId] = creds.token;
                     if (creds.config) {
                         configs[providerId] = creds.config;
@@ -336,12 +350,12 @@ const runSetup = async (options) => {
         console.log(chalk_1.default.blue('\n🔀 Split Mode Configuration'));
         console.log(chalk_1.default.gray('Configure separate platforms for code hosting and issue tracking.\n'));
         // Get code repository platform
-        const codeRepoProvider = await (0, provider_prompts_1.promptForSingleProvider)((0, get_provider_client_1.getProviderClient)(), 'code');
+        const codeRepoProvider = await (0, provider_prompts_1.promptForSingleProvider)(providerClient, 'code');
         // Get code repository credentials
         if (!tokens[codeRepoProvider]) {
             try {
                 // Use provided tokens if available, otherwise prompt
-                const creds = await (0, provider_prompts_1.promptForProviderCredentials)((0, get_provider_client_1.getProviderClient)(), codeRepoProvider, providedTokens[codeRepoProvider], providedConfigs[codeRepoProvider]);
+                const creds = await (0, provider_prompts_1.promptForProviderCredentials)(providerClient, codeRepoProvider, providedTokens[codeRepoProvider], providedConfigs[codeRepoProvider]);
                 tokens[codeRepoProvider] = creds.token;
                 if (creds.config) {
                     configs[codeRepoProvider] = creds.config;
@@ -354,12 +368,12 @@ const runSetup = async (options) => {
             }
         }
         // Get issue tracking platform
-        const issueProvider = await (0, provider_prompts_1.promptForSingleProvider)((0, get_provider_client_1.getProviderClient)(), 'issues');
+        const issueProvider = await (0, provider_prompts_1.promptForSingleProvider)(providerClient, 'issues');
         // Get issue tracking credentials (if different from code repo)
         if (!tokens[issueProvider]) {
             try {
                 // Use provided tokens if available, otherwise prompt
-                const creds = await (0, provider_prompts_1.promptForProviderCredentials)((0, get_provider_client_1.getProviderClient)(), issueProvider, providedTokens[issueProvider], providedConfigs[issueProvider]);
+                const creds = await (0, provider_prompts_1.promptForProviderCredentials)(providerClient, issueProvider, providedTokens[issueProvider], providedConfigs[issueProvider]);
                 tokens[issueProvider] = creds.token;
                 if (creds.config) {
                     configs[issueProvider] = creds.config;
@@ -474,6 +488,7 @@ exports.runSetup = runSetup;
 exports.setupCommand = new commander_1.Command('setup')
     .description('Complete global FRAIM setup with platform configuration')
     .option('--key <key>', 'FRAIM API key')
+    .option('--mode <mode>', 'Usage mode: integrated | split | conversational')
     .option('--ide <ides>', 'Configure specific IDEs');
 // Track initialization promise for CLI entry point
 exports.setupCommandInitialization = null;

package/dist/src/cli/utils/fraim-gitignore.js

@@ -0,0 +1,46 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ensureFraimSyncedContentIgnored = exports.FRAIM_SYNC_GITIGNORE_ENTRIES = exports.FRAIM_SYNC_GITIGNORE_END = exports.FRAIM_SYNC_GITIGNORE_START = void 0;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+exports.FRAIM_SYNC_GITIGNORE_START = '# BEGIN FRAIM SYNCED CONTENT';
+exports.FRAIM_SYNC_GITIGNORE_END = '# END FRAIM SYNCED CONTENT';
+exports.FRAIM_SYNC_GITIGNORE_ENTRIES = [
+    '.fraim/workflows/',
+    '.fraim/docs/',
+    '.fraim/ai-employee/',
+    '.fraim/ai-manager/'
+];
+const escapeRegExp = (value) => value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+/**
+ * Ensures the repo .gitignore contains a managed FRAIM synced-content block.
+ * Returns true when the file was modified.
+ */
+const ensureFraimSyncedContentIgnored = (projectRoot) => {
+    const gitignorePath = path_1.default.join(projectRoot, '.gitignore');
+    const existingRaw = fs_1.default.existsSync(gitignorePath)
+        ? fs_1.default.readFileSync(gitignorePath, 'utf8')
+        : '';
+    const newline = existingRaw.includes('\r\n') ? '\r\n' : '\n';
+    const normalized = existingRaw.replace(/\r\n/g, '\n');
+    const managedBlock = [
+        exports.FRAIM_SYNC_GITIGNORE_START,
+        '# Synced by fraim init-project (generated content)',
+        ...exports.FRAIM_SYNC_GITIGNORE_ENTRIES,
+        exports.FRAIM_SYNC_GITIGNORE_END
+    ].join('\n');
+    const blockPattern = new RegExp(`${escapeRegExp(exports.FRAIM_SYNC_GITIGNORE_START)}[\\s\\S]*?${escapeRegExp(exports.FRAIM_SYNC_GITIGNORE_END)}\\n?`, 'm');
+    const hasManagedBlock = blockPattern.test(normalized);
+    const updatedNormalized = hasManagedBlock
+        ? normalized.replace(blockPattern, `${managedBlock}\n`)
+        : `${normalized.trimEnd()}${normalized.trimEnd().length > 0 ? '\n\n' : ''}${managedBlock}\n`;
+    if (updatedNormalized !== normalized) {
+        fs_1.default.writeFileSync(gitignorePath, updatedNormalized.replace(/\n/g, newline), 'utf8');
+        return true;
+    }
+    return false;
+};
+exports.ensureFraimSyncedContentIgnored = ensureFraimSyncedContentIgnored;

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

@@ -17,6 +17,84 @@ const fs_1 = require("fs");
 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 LOCK_SYNCED_CONTENT_ENV = 'FRAIM_LOCK_SYNCED_CONTENT';
+const SYNCED_CONTENT_BANNER_MARKER = '<!-- FRAIM_SYNC_MANAGED_CONTENT -->';
+function shouldLockSyncedContent() {
+    const raw = process.env[LOCK_SYNCED_CONTENT_ENV];
+    if (!raw) {
+        return true;
+    }
+    const normalized = raw.trim().toLowerCase();
+    return !['0', 'false', 'off', 'no'].includes(normalized);
+}
+function getSyncedContentLockTargets(projectRoot) {
+    return fraim_gitignore_1.FRAIM_SYNC_GITIGNORE_ENTRIES
+        .map((entry) => entry.replace(/[\\/]+$/, ''))
+        .filter((entry) => entry.length > 0)
+        .map((entry) => (0, path_1.join)(projectRoot, entry));
+}
+function setFileWriteLockRecursively(dirPath, readOnly) {
+    if (!(0, fs_1.existsSync)(dirPath)) {
+        return;
+    }
+    const entries = (0, fs_1.readdirSync)(dirPath, { withFileTypes: true });
+    for (const entry of entries) {
+        const fullPath = (0, path_1.join)(dirPath, entry.name);
+        if (entry.isDirectory()) {
+            setFileWriteLockRecursively(fullPath, readOnly);
+            continue;
+        }
+        try {
+            // Cross-platform write lock for text files:
+            // - Unix: mode bits
+            // - Windows: toggles read-only attribute behavior for file writes
+            (0, fs_1.chmodSync)(fullPath, readOnly ? 0o444 : 0o666);
+        }
+        catch {
+            // Best-effort permission adjustment; keep sync non-blocking.
+        }
+    }
+}
+function getBannerRegistryPath(file) {
+    if (file.type === 'job') {
+        return `jobs/${file.path}`;
+    }
+    if (file.type === 'skill') {
+        return `skills/${file.path}`;
+    }
+    if (file.type === 'rule') {
+        return `rules/${file.path}`;
+    }
+    return null;
+}
+function insertAfterFrontmatter(content, banner) {
+    const normalized = content.replace(/^\uFEFF/, '');
+    const frontmatterMatch = normalized.match(/^---\r?\n[\s\S]*?\r?\n---(?:\r?\n)?/);
+    if (!frontmatterMatch) {
+        return `${banner}${normalized}`;
+    }
+    const frontmatter = frontmatterMatch[0];
+    const body = normalized.slice(frontmatter.length);
+    return `${frontmatter}${banner}${body}`;
+}
+function buildSyncedContentBanner(typeLabel, registryPath) {
+    const overridePath = `.fraim/personalized-employee/${registryPath}`;
+    return `${SYNCED_CONTENT_BANNER_MARKER}
+> [!IMPORTANT]
+> This ${typeLabel} is synced from FRAIM and will be overwritten on the next \`fraim sync\`.
+> Do not edit this file.
+`;
+}
+function applySyncedContentBanner(file) {
+    const registryPath = getBannerRegistryPath(file);
+    if (!registryPath) {
+        return file.content;
+    }
+    const typeLabel = file.type === 'job' ? 'job stub' : `${file.type} file`;
+    const banner = buildSyncedContentBanner(typeLabel, registryPath);
+    return insertAfterFrontmatter(file.content, banner);
+}
 /**
  * Sync workflows and scripts from remote FRAIM server
  */
@@ -61,6 +139,13 @@ async function syncFromRemote(options) {
                 error: 'No files received'
             };
         }
+        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);
+            }
+        }
         // Sync workflows
         const workflowFiles = files.filter(f => f.type === 'workflow');
         const workflowsDir = (0, path_1.join)(options.projectRoot, '.fraim', 'workflows');
@@ -94,7 +179,7 @@ async function syncFromRemote(options) {
             if (!(0, fs_1.existsSync)(fileDir)) {
                 (0, fs_1.mkdirSync)(fileDir, { recursive: true });
             }
-            (0, fs_1.writeFileSync)(filePath, file.content, 'utf8');
+            (0, fs_1.writeFileSync)(filePath, applySyncedContentBanner(file), 'utf8');
             console.log(chalk_1.default.gray(`  + ai-employee/jobs/${file.path}`));
         }
         // Sync ai-manager job stubs to .fraim/ai-manager/jobs/
@@ -110,7 +195,7 @@ async function syncFromRemote(options) {
             if (!(0, fs_1.existsSync)(fileDir)) {
                 (0, fs_1.mkdirSync)(fileDir, { recursive: true });
             }
-            (0, fs_1.writeFileSync)(filePath, file.content, 'utf8');
+            (0, fs_1.writeFileSync)(filePath, applySyncedContentBanner(file), 'utf8');
             console.log(chalk_1.default.gray(`  + ai-manager/jobs/${managerRelativePath}`));
         }
         // Sync full skill files to .fraim/ai-employee/skills/
@@ -126,7 +211,7 @@ async function syncFromRemote(options) {
             if (!(0, fs_1.existsSync)(fileDir)) {
                 (0, fs_1.mkdirSync)(fileDir, { recursive: true });
             }
-            (0, fs_1.writeFileSync)(filePath, file.content, 'utf8');
+            (0, fs_1.writeFileSync)(filePath, applySyncedContentBanner(file), 'utf8');
             console.log(chalk_1.default.gray(`  + ai-employee/skills/${file.path}`));
         }
         // Sync full rule files to .fraim/ai-employee/rules/
@@ -142,7 +227,7 @@ async function syncFromRemote(options) {
             if (!(0, fs_1.existsSync)(fileDir)) {
                 (0, fs_1.mkdirSync)(fileDir, { recursive: true });
             }
-            (0, fs_1.writeFileSync)(filePath, file.content, 'utf8');
+            (0, fs_1.writeFileSync)(filePath, applySyncedContentBanner(file), 'utf8');
             console.log(chalk_1.default.gray(`  + ai-employee/rules/${file.path}`));
         }
         // Sync scripts to user directory
@@ -180,6 +265,12 @@ async function syncFromRemote(options) {
             (0, fs_1.writeFileSync)(filePath, file.content, 'utf8');
             console.log(chalk_1.default.gray(`  + docs/${file.path}`));
         }
+        if (shouldLockSyncedContent()) {
+            for (const target of lockTargets) {
+                setFileWriteLockRecursively(target, true);
+            }
+            console.log(chalk_1.default.gray(`  🔒 Synced FRAIM content locked as read-only (set ${LOCK_SYNCED_CONTENT_ENV}=false to disable)`));
+        }
         return {
             success: true,
             workflowsSynced: workflowFiles.length,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fraim-framework",
-  "version": "2.0.85",
+  "version": "2.0.87",
   "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": {
@@ -114,6 +114,7 @@
     "express": "^5.2.1",
     "mongodb": "^7.0.0",
     "prompts": "^2.4.2",
+    "resend": "^6.9.3",
     "stripe": "^20.3.1",
     "toml": "^3.0.0",
     "tree-kill": "^1.2.2"