fraim-framework 2.0.95 → 2.0.97

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

@@ -1,61 +1,68 @@
 "use strict";
 /**
- * Workflow checks for FRAIM doctor command
- * Validates workflow installation and versions
+ * Job checks for FRAIM doctor command
+ * Validates job installation and versions
  * Issue #144: Enhanced doctor command
  */
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getWorkflowChecks = getWorkflowChecks;
+exports.getJobChecks = getJobChecks;
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const inheritance_parser_1 = require("../../../core/utils/inheritance-parser");
+const project_fraim_paths_1 = require("../../../core/utils/project-fraim-paths");
+function getJobStubDirs() {
+    return [
+        (0, project_fraim_paths_1.getWorkspaceFraimPath)(process.cwd(), 'ai-employee', 'jobs'),
+        (0, project_fraim_paths_1.getWorkspaceFraimPath)(process.cwd(), 'ai-manager', 'jobs')
+    ];
+}
 /**
- * Check if workflows directory exists
+ * Check if jobs directory exists
  */
-function checkWorkflowsDirectoryExists() {
+function checkJobsDirectoryExists() {
     return {
-        name: 'Workflows directory exists',
-        category: 'workflows',
+        name: 'Jobs directory exists',
+        category: 'jobs',
         critical: true,
         run: async () => {
-            const workflowsDir = path_1.default.join(process.cwd(), '.fraim', 'workflows');
-            if (fs_1.default.existsSync(workflowsDir)) {
+            const jobDirs = getJobStubDirs();
+            const existingJobDirs = jobDirs.filter(fs_1.default.existsSync);
+            if ((0, project_fraim_paths_1.workspaceFraimExists)(process.cwd()) && existingJobDirs.length > 0) {
                 return {
                     status: 'passed',
-                    message: 'Workflows directory exists',
-                    details: { path: workflowsDir }
+                    message: 'Jobs directory exists',
+                    details: { paths: existingJobDirs }
                 };
             }
             return {
                 status: 'error',
-                message: 'Workflows directory missing',
-                suggestion: 'Run fraim sync to fetch workflows',
+                message: 'Jobs directory missing',
+                suggestion: 'Run fraim sync to hydrate local job stubs. Onboarding can still start through MCP if your agent is already connected.',
                 command: 'fraim sync'
             };
         }
     };
 }
 /**
- * Check if workflow stubs are present
+ * Check if job stubs are present
  */
-function checkWorkflowStubsPresent() {
+function checkJobStubsPresent() {
     return {
-        name: 'Workflow stubs present',
-        category: 'workflows',
+        name: 'Job stubs present',
+        category: 'jobs',
         critical: false,
         run: async () => {
-            const workflowsDir = path_1.default.join(process.cwd(), '.fraim', 'workflows');
-            if (!fs_1.default.existsSync(workflowsDir)) {
+            const jobDirs = getJobStubDirs().filter(fs_1.default.existsSync);
+            if (jobDirs.length === 0) {
                 return {
                     status: 'error',
-                    message: 'Cannot check stubs - workflows directory missing'
+                    message: 'Cannot check stubs - jobs directory missing'
                 };
             }
             try {
-                // Count all .md files recursively
                 let stubCount = 0;
                 const countStubs = (dir) => {
                     const entries = fs_1.default.readdirSync(dir, { withFileTypes: true });
@@ -68,25 +75,25 @@ function checkWorkflowStubsPresent() {
                         }
                     }
                 };
-                countStubs(workflowsDir);
+                jobDirs.forEach(countStubs);
                 if (stubCount > 0) {
                     return {
                         status: 'passed',
-                        message: `${stubCount} workflow stubs found`,
+                        message: `${stubCount} job stubs found`,
                         details: { stubCount }
                     };
                 }
                 return {
                     status: 'warning',
-                    message: 'No workflow stubs found',
-                    suggestion: 'Run fraim sync to fetch workflows',
+                    message: 'No job stubs found',
+                    suggestion: 'Run fraim sync to hydrate local job stubs. This does not block agent-led onboarding if MCP access is healthy.',
                     command: 'fraim sync'
                 };
             }
             catch (error) {
                 return {
                     status: 'error',
-                    message: 'Failed to count workflow stubs',
+                    message: 'Failed to count job stubs',
                     details: { error: error.message }
                 };
             }
@@ -94,28 +101,27 @@ function checkWorkflowStubsPresent() {
     };
 }
 /**
- * Check if workflows are up to date
+ * Check if jobs are up to date
  */
-function checkWorkflowsUpToDate() {
+function checkJobsUpToDate() {
     return {
-        name: 'Workflows up to date',
-        category: 'workflows',
+        name: 'Jobs up to date',
+        category: 'jobs',
         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: 'warning',
-                    message: 'Cannot check workflow version - config missing'
+                    message: 'Cannot check job version - config missing'
                 };
             }
             try {
                 const config = JSON.parse(fs_1.default.readFileSync(configPath, 'utf8'));
-                // Try multiple paths to find package.json
                 const possiblePaths = [
-                    path_1.default.join(__dirname, '../../../../package.json'), // From dist/src/cli/doctor/checks
-                    path_1.default.join(__dirname, '../../../package.json'), // From src/cli/doctor/checks
-                    path_1.default.join(process.cwd(), 'package.json') // From project root
+                    path_1.default.join(__dirname, '../../../../package.json'),
+                    path_1.default.join(__dirname, '../../../package.json'),
+                    path_1.default.join(process.cwd(), 'package.json')
                 ];
                 let packageJson = null;
                 for (const pkgPath of possiblePaths) {
@@ -135,14 +141,14 @@ function checkWorkflowsUpToDate() {
                 if (configVersion === currentVersion) {
                     return {
                         status: 'passed',
-                        message: `Workflows up to date (v${currentVersion})`,
+                        message: `Jobs up to date (v${currentVersion})`,
                         details: { version: currentVersion }
                     };
                 }
                 return {
                     status: 'warning',
-                    message: `Workflows outdated (v${configVersion} → v${currentVersion})`,
-                    suggestion: 'Update workflows with fraim sync',
+                    message: `Jobs outdated (v${configVersion} -> v${currentVersion})`,
+                    suggestion: 'Update local job stubs with fraim sync.',
                     command: 'fraim sync',
                     details: { configVersion, currentVersion }
                 };
@@ -150,7 +156,7 @@ function checkWorkflowsUpToDate() {
             catch (error) {
                 return {
                     status: 'error',
-                    message: 'Failed to check workflow version',
+                    message: 'Failed to check job version',
                     details: { error: error.message }
                 };
             }
@@ -163,12 +169,11 @@ function checkWorkflowsUpToDate() {
 function checkOverrideSyntaxValid() {
     return {
         name: 'Override syntax valid',
-        category: 'workflows',
+        category: 'jobs',
         critical: false,
         run: async () => {
-            const personalizedDir = path_1.default.join(process.cwd(), '.fraim', 'personalized-employee');
-            const legacyOverridesDir = path_1.default.join(process.cwd(), '.fraim', 'overrides');
-            if (!fs_1.default.existsSync(personalizedDir) && !fs_1.default.existsSync(legacyOverridesDir)) {
+            const personalizedDir = (0, project_fraim_paths_1.getWorkspaceFraimPath)(process.cwd(), 'personalized-employee');
+            if (!fs_1.default.existsSync(personalizedDir)) {
                 return {
                     status: 'passed',
                     message: 'No overrides (not required)',
@@ -180,7 +185,6 @@ function checkOverrideSyntaxValid() {
                 const overrides = [];
                 let invalidCount = 0;
                 const errors = [];
-                // Scan for all override files
                 const scanDir = (dir, base = '') => {
                     const entries = fs_1.default.readdirSync(dir, { withFileTypes: true });
                     for (const entry of entries) {
@@ -193,17 +197,9 @@ function checkOverrideSyntaxValid() {
                         }
                     }
                 };
-                if (fs_1.default.existsSync(personalizedDir)) {
-                    scanDir(personalizedDir);
-                }
-                if (fs_1.default.existsSync(legacyOverridesDir)) {
-                    scanDir(legacyOverridesDir);
-                }
-                // Validate each override
+                scanDir(personalizedDir);
                 for (const override of overrides) {
-                    const primaryPath = path_1.default.join(personalizedDir, override);
-                    const legacyPath = path_1.default.join(legacyOverridesDir, override);
-                    const overridePath = fs_1.default.existsSync(primaryPath) ? primaryPath : legacyPath;
+                    const overridePath = path_1.default.join(personalizedDir, override);
                     const content = fs_1.default.readFileSync(overridePath, 'utf-8');
                     const parseResult = parser.parse(content);
                     if (parseResult.hasImports) {
@@ -243,13 +239,13 @@ function checkOverrideSyntaxValid() {
     };
 }
 /**
- * Get all workflow checks
+ * Get all job checks
  */
-function getWorkflowChecks() {
+function getJobChecks() {
     return [
-        checkWorkflowsDirectoryExists(),
-        checkWorkflowStubsPresent(),
-        checkWorkflowsUpToDate(),
+        checkJobsDirectoryExists(),
+        checkJobStubsPresent(),
+        checkJobsUpToDate(),
         checkOverrideSyntaxValid()
     ];
 }

package/dist/src/cli/doctor/reporters/console-reporter.js

@@ -13,7 +13,7 @@ const chalk_1 = __importDefault(require("chalk"));
 const CATEGORY_NAMES = {
     globalSetup: 'Global Setup',
     projectSetup: 'Project Setup',
-    workflows: 'Workflows',
+    jobs: 'Jobs',
     ideConfiguration: 'IDE Configuration',
     mcpConnectivity: 'MCP Server Connectivity',
     scripts: 'Scripts'

package/dist/src/cli/fraim.js

@@ -49,6 +49,7 @@ const override_1 = require("./commands/override");
 const list_overridable_1 = require("./commands/list-overridable");
 const login_1 = require("./commands/login");
 const mcp_1 = require("./commands/mcp");
+const migrate_project_fraim_1 = require("./commands/migrate-project-fraim");
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const program = new commander_1.Command();
@@ -74,7 +75,7 @@ catch (e) {
 }
 program
     .name('fraim')
-    .description('FRAIM Framework CLI - Manage your AI workflows and rules')
+    .description('FRAIM Framework CLI - Manage your AI jobs and rules')
     .version(packageJson.version);
 program.addCommand(sync_1.syncCommand);
 program.addCommand(doctor_1.doctorCommand);
@@ -87,6 +88,7 @@ program.addCommand(override_1.overrideCommand);
 program.addCommand(list_overridable_1.listOverridableCommand);
 program.addCommand(login_1.loginCommand);
 program.addCommand(mcp_1.mcpCommand);
+program.addCommand(migrate_project_fraim_1.migrateProjectFraimCommand);
 // Wait for async command initialization before parsing
 (async () => {
     // Import the initialization promise from setup command

package/dist/src/cli/mcp/mcp-server-registry.js

@@ -31,7 +31,7 @@ exports.BASE_MCP_SERVERS = [
     {
         id: 'fraim',
         name: 'FRAIM',
-        description: 'FRAIM workflow orchestration and mentoring',
+        description: 'FRAIM job orchestration and mentoring',
         buildServer: (fraimKey) => ({
             command: 'npx',
             args: ['-y', 'fraim-framework@latest', 'mcp'],

package/dist/src/cli/services/device-flow-service.js

@@ -0,0 +1,83 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DeviceFlowService = void 0;
+const axios_1 = __importDefault(require("axios"));
+const chalk_1 = __importDefault(require("chalk"));
+class DeviceFlowService {
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Start the Device Flow Login
+     */
+    async login() {
+        console.log(chalk_1.default.blue('\n🔗 Starting Authentication...'));
+        try {
+            // 1. Request device and user codes
+            const deviceCode = await this.requestDeviceCode();
+            console.log(chalk_1.default.yellow('\nACTION REQUIRED:'));
+            console.log(`1. Go to: ${chalk_1.default.cyan.underline(deviceCode.verification_uri)}`);
+            console.log(`2. Enter the code: ${chalk_1.default.bold.green(deviceCode.user_code)}`);
+            console.log(chalk_1.default.gray(`\nWaiting for authorization (expires in ${Math.floor(deviceCode.expires_in / 60)} minutes)...`));
+            // 2. Poll for the access token
+            const token = await this.pollForToken(deviceCode.device_code, deviceCode.interval);
+            console.log(chalk_1.default.green('\n✅ Authentication Successful!'));
+            return token;
+        }
+        catch (error) {
+            console.error(chalk_1.default.red(`\n❌ Authentication failed: ${error.message}`));
+            throw error;
+        }
+    }
+    async requestDeviceCode() {
+        const response = await axios_1.default.post(this.config.authUrl, {
+            client_id: this.config.clientId,
+            scope: this.config.scope
+        }, {
+            headers: { Accept: 'application/json' }
+        });
+        return response.data;
+    }
+    async pollForToken(deviceCode, interval) {
+        let currentInterval = interval * 1000;
+        return new Promise((resolve, reject) => {
+            const poll = async () => {
+                try {
+                    const response = await axios_1.default.post(this.config.tokenUrl, {
+                        client_id: this.config.clientId,
+                        device_code: deviceCode,
+                        grant_type: 'urn:ietf:params:oauth:grant-type:device_code'
+                    }, {
+                        headers: { Accept: 'application/json' }
+                    });
+                    if (response.data.access_token) {
+                        resolve(response.data.access_token);
+                        return;
+                    }
+                    if (response.data.error) {
+                        const error = response.data.error;
+                        if (error === 'authorization_pending') {
+                            // Keep polling
+                            setTimeout(poll, currentInterval);
+                        }
+                        else if (error === 'slow_down') {
+                            currentInterval += 5000;
+                            setTimeout(poll, currentInterval);
+                        }
+                        else {
+                            reject(new Error(response.data.error_description || error));
+                        }
+                    }
+                }
+                catch (error) {
+                    reject(error);
+                }
+            };
+            setTimeout(poll, currentInterval);
+        });
+    }
+}
+exports.DeviceFlowService = DeviceFlowService;

package/dist/src/cli/setup/auto-mcp-setup.js

@@ -64,7 +64,7 @@ const promptForIDESelection = async (detectedIDEs, tokenInput) => {
         console.log(chalk_1.default.gray(`      Config: ${ide.configPath}`));
     });
     console.log(chalk_1.default.blue('FRAIM will add these MCP servers to selected IDEs:'));
-    console.log(chalk_1.default.gray('   • fraim (required for FRAIM workflows)'));
+    console.log(chalk_1.default.gray('   • fraim (required for FRAIM jobs)'));
     console.log(chalk_1.default.gray('   • git (version control integration)'));
     // Show configured provider MCP servers dynamically
     const allProviderIds = await (0, provider_registry_1.getAllProviderIds)();
@@ -325,7 +325,7 @@ const autoConfigureMCP = async (fraimKey, tokenInput, selectedIDEs, providerConf
         console.log(chalk_1.default.cyan('   1. Restart your configured IDEs'));
         console.log(chalk_1.default.cyan('   2. Go to any project directory'));
         console.log(chalk_1.default.cyan('   3. Run: npx fraim-framework@latest init-project'));
-        console.log(chalk_1.default.cyan('   4. Ask your AI agent: "list fraim workflows"'));
+        console.log(chalk_1.default.cyan('   4. Tell your AI agent: "Onboard this project"'));
     }
 };
 exports.autoConfigureMCP = autoConfigureMCP;

package/dist/src/cli/setup/first-run.js

@@ -43,6 +43,7 @@ const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const os_1 = __importDefault(require("os"));
 const script_sync_utils_1 = require("../utils/script-sync-utils");
+const project_fraim_paths_1 = require("../../core/utils/project-fraim-paths");
 const loadGlobalConfig = () => {
     const globalConfigPath = path_1.default.join((0, script_sync_utils_1.getUserFraimDir)(), 'config.json');
     if (!fs_1.default.existsSync(globalConfigPath)) {
@@ -214,7 +215,7 @@ const runFirstRunExperience = async () => {
             const resolvedPath = path.resolve(process.cwd(), pathResponse.archDocPath);
             if (fs.existsSync(resolvedPath)) {
                 try {
-                    const configPath = path.resolve(process.cwd(), '.fraim', 'config.json');
+                    const configPath = (0, project_fraim_paths_1.getWorkspaceConfigPath)(process.cwd());
                     if (fs.existsSync(configPath)) {
                         const configContent = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
                         if (!configContent.customizations)
@@ -224,7 +225,7 @@ const runFirstRunExperience = async () => {
                         console.log(chalk_1.default.green(`\n✅ Linked architecture document: ${pathResponse.archDocPath}`));
                     }
                     else {
-                        console.log(chalk_1.default.red('\n❌ .fraim/config.json not found. Could not save preference.'));
+                        console.log(chalk_1.default.red(`\n❌ ${(0, project_fraim_paths_1.getWorkspaceFraimDisplayPath)('config.json')} not found. Could not save preference.`));
                     }
                 }
                 catch (e) {
@@ -236,6 +237,6 @@ const runFirstRunExperience = async () => {
             }
         }
     }
-    console.log(chalk_1.default.green('\n✅ Workflows are installed in .fraim/workflows.\n'));
+    console.log(chalk_1.default.green(`\n✅ Jobs are installed in ${(0, project_fraim_paths_1.getWorkspaceFraimDisplayPath)('ai-employee/jobs')} and ${(0, project_fraim_paths_1.getWorkspaceFraimDisplayPath)('ai-manager/jobs')}.\n`));
 };
 exports.runFirstRunExperience = runFirstRunExperience;

package/dist/src/cli/utils/agent-adapters.js

@@ -0,0 +1,126 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ensureAgentAdapterFiles = ensureAgentAdapterFiles;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const project_fraim_paths_1 = require("../../core/utils/project-fraim-paths");
+const START_MARKER = '<!-- FRAIM_AGENT_ADAPTER_START -->';
+const END_MARKER = '<!-- FRAIM_AGENT_ADAPTER_END -->';
+const CURSOR_RULE_PATH = path_1.default.join('.cursor', 'rules', 'fraim.mdc');
+const CURSOR_FRONTMATTER = `---
+description: FRAIM discovery and execution contract
+alwaysApply: true
+---`;
+function buildManagedSection(body) {
+    return `${START_MARKER}
+${body.trim()}
+${END_MARKER}
+`;
+}
+function mergeManagedSection(existingContent, managedSection) {
+    const normalized = existingContent.replace(/\r\n/g, '\n');
+    const startIndex = normalized.indexOf(START_MARKER);
+    const endIndex = normalized.indexOf(END_MARKER);
+    if (startIndex !== -1 && endIndex !== -1 && endIndex > startIndex) {
+        const before = normalized.slice(0, startIndex).trimEnd();
+        const after = normalized.slice(endIndex + END_MARKER.length).trimStart();
+        const pieces = [before, managedSection.trim(), after].filter(Boolean);
+        return `${pieces.join('\n\n').trim()}\n`;
+    }
+    if (!normalized.trim()) {
+        return `${managedSection.trim()}\n`;
+    }
+    return `${normalized.trimEnd()}\n\n${managedSection.trim()}\n`;
+}
+function mergeCursorRule(existingContent, managedSection) {
+    const normalized = existingContent.replace(/\r\n/g, '\n').trimStart();
+    const bodyWithoutLeadingFrontmatter = normalized.replace(/^(?:---\n[\s\S]*?\n---(?:\n+)?)*/, '');
+    const mergedBody = mergeManagedSection(bodyWithoutLeadingFrontmatter, managedSection).trim();
+    return `${CURSOR_FRONTMATTER}\n\n${mergedBody}\n`;
+}
+function getAdapterFiles() {
+    const fraimRoot = (0, project_fraim_paths_1.getWorkspaceFraimDisplayPath)().replace(/\/$/, '');
+    const employeeJobsPath = (0, project_fraim_paths_1.getWorkspaceFraimDisplayPath)('ai-employee/jobs');
+    const managerJobsPath = (0, project_fraim_paths_1.getWorkspaceFraimDisplayPath)('ai-manager/jobs');
+    const employeeSkillsPath = (0, project_fraim_paths_1.getWorkspaceFraimDisplayPath)('ai-employee/skills');
+    const employeeRulesPath = (0, project_fraim_paths_1.getWorkspaceFraimDisplayPath)('ai-employee/rules');
+    const personalizedRootPath = (0, project_fraim_paths_1.getWorkspaceFraimDisplayPath)('personalized-employee');
+    const projectRulesPath = (0, project_fraim_paths_1.getWorkspaceFraimDisplayPath)('personalized-employee/rules/project_rules.md');
+    const markdownBody = buildManagedSection(`
+## FRAIM
+
+This repository uses FRAIM.
+
+- The FRAIM discovery catalog lives under \`${fraimRoot}/\`.
+- Jobs under \`${employeeJobsPath}/\` and \`${managerJobsPath}/\` are FRAIM's primary execution units. Treat them like first-class workflows when deciding how to execute work.
+- Skills under \`${employeeSkillsPath}/\` are reusable capabilities that jobs compose.
+- Rules under \`${employeeRulesPath}/\` are always-on constraints and conventions.
+- Repo-specific overrides and learning artifacts live under \`${personalizedRootPath}/\` and take precedence over synced baseline content.
+- Use stub filenames and summaries to discover what to invoke. Once you identify a relevant job, call \`get_fraim_job({ job: "<job-name>" })\`.
+- For deeper capability detail, call \`get_fraim_file({ path: "skills/<category>/<skill-name>.md" })\` or \`get_fraim_file({ path: "rules/<category>/<rule-name>.md" })\`.
+- Read \`${projectRulesPath}\` if it exists before doing work.
+`);
+    const cursorManagedBody = buildManagedSection(`
+Use FRAIM as the repo's execution framework.
+
+- Discover available jobs, skills, and rules under \`${fraimRoot}/\`.
+- Jobs are the primary execution units; treat them like first-class workflows.
+- Skills are reusable capability modules jobs compose.
+- Rules are always-on constraints.
+- Repo-specific overrides and learnings under \`${personalizedRootPath}/\` take precedence.
+- Choose a relevant job from the stubs, then call \`get_fraim_job(...)\` for the full phased instructions.
+`);
+    const copilotBody = buildManagedSection(`
+## FRAIM
+
+- Use \`${fraimRoot}/\` as the repository's FRAIM catalog.
+- FRAIM jobs are the primary execution units and should be treated like first-class workflows.
+- FRAIM skills are reusable capabilities jobs compose.
+- FRAIM rules are always-on constraints and conventions.
+- Repo-specific overrides and learnings live under \`${personalizedRootPath}/\`.
+- Use the stubs to identify which job to invoke before fetching full content with FRAIM MCP tools.
+`);
+    const fraimReadme = `# FRAIM Catalog
+
+This directory is the repository-visible FRAIM surface.
+
+- \`ai-employee/jobs/\`: employee job stubs
+- \`ai-manager/jobs/\`: manager job stubs
+- \`ai-employee/skills/\`: skill stubs
+- \`ai-employee/rules/\`: rule stubs
+- \`personalized-employee/\`: repo-specific overrides and learnings
+
+Use the stubs here to discover which FRAIM job, skill, or rule is relevant, then load the full content through FRAIM MCP tools.
+`;
+    return [
+        { path: 'AGENTS.md', content: markdownBody },
+        { path: 'CLAUDE.md', content: markdownBody },
+        { path: path_1.default.join('.github', 'copilot-instructions.md'), content: copilotBody },
+        { path: CURSOR_RULE_PATH, content: cursorManagedBody },
+        { path: path_1.default.join(project_fraim_paths_1.WORKSPACE_FRAIM_DIRNAME, 'README.md'), content: fraimReadme }
+    ];
+}
+function ensureAgentAdapterFiles(projectRoot) {
+    const updatedPaths = [];
+    for (const file of getAdapterFiles()) {
+        const fullPath = path_1.default.join(projectRoot, file.path);
+        const dir = path_1.default.dirname(fullPath);
+        if (!fs_1.default.existsSync(dir)) {
+            fs_1.default.mkdirSync(dir, { recursive: true });
+        }
+        const existing = fs_1.default.existsSync(fullPath) ? fs_1.default.readFileSync(fullPath, 'utf8') : '';
+        const next = file.path === CURSOR_RULE_PATH
+            ? mergeCursorRule(existing, file.content)
+            : file.path.endsWith('README.md')
+                ? file.content
+                : mergeManagedSection(existing, file.content);
+        if (existing !== next) {
+            fs_1.default.writeFileSync(fullPath, next, 'utf8');
+            updatedPaths.push(file.path.replace(/\\/g, '/'));
+        }
+    }
+    return updatedPaths;
+}

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

@@ -9,16 +9,11 @@ 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/'
+    'fraim/ai-employee/',
+    'fraim/ai-manager/',
+    'fraim/docs/',
 ];
 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)
@@ -26,19 +21,18 @@ const ensureFraimSyncedContentIgnored = (projectRoot) => {
         : '';
     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');
+    const managedBlock = `${exports.FRAIM_SYNC_GITIGNORE_START}\n${exports.FRAIM_SYNC_GITIGNORE_ENTRIES.join('\n')}\n${exports.FRAIM_SYNC_GITIGNORE_END}`;
+    const blockPattern = new RegExp(`\\n?${escapeRegExp(exports.FRAIM_SYNC_GITIGNORE_START)}[\\s\\S]*?${escapeRegExp(exports.FRAIM_SYNC_GITIGNORE_END)}\\n?`, 'm');
+    const withoutManagedBlock = normalized.replace(blockPattern, '\n').trimEnd();
+    const cleaned = withoutManagedBlock
+        .replace(/\n{3,}/g, '\n\n')
+        .replace(/^\n+/, '')
+        .trimEnd();
+    const next = cleaned.length > 0
+        ? `${cleaned}\n\n${managedBlock}\n`
+        : `${managedBlock}\n`;
+    if (next !== normalized) {
+        fs_1.default.writeFileSync(gitignorePath, next.replace(/\n/g, newline), 'utf8');
         return true;
     }
     return false;