fraim-framework 2.0.86 → 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/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.86",
+  "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"