fraim-framework 2.0.171 → 2.0.174

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

@@ -51,6 +51,7 @@ const mcp_server_registry_1 = require("../mcp/mcp-server-registry");
 const get_provider_client_1 = require("../api/get-provider-client");
 const provider_prompts_1 = require("../setup/provider-prompts");
 const provider_registry_1 = require("../providers/provider-registry");
+const user_config_1 = require("../utils/user-config");
 const loadGlobalConfig = async () => {
     const globalConfigPath = path_1.default.join((0, script_sync_utils_1.getUserFraimDir)(), 'config.json');
     if (!fs_1.default.existsSync(globalConfigPath)) {
@@ -410,6 +411,7 @@ const runAddIDE = async (options) => {
         try {
             await configureIDEMCP(ide, globalConfig.fraimKey, platformTokens, globalConfig.providerConfigs);
             results.successful.push(ide.name);
+            (0, user_config_1.addInstalledIde)((0, ide_detector_1.getAdapterConfigType)(ide));
         }
         catch (error) {
             const errorMessage = error instanceof Error ? error.message : 'Unknown error';

package/dist/src/cli/commands/cleanup-artifacts.js

@@ -0,0 +1,39 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cleanupArtifactsCommand = void 0;
+exports.runCleanupArtifactsCommand = runCleanupArtifactsCommand;
+const commander_1 = require("commander");
+const node_path_1 = __importDefault(require("node:path"));
+const artifact_retention_cleanup_1 = require("../../local-mcp-server/artifact-retention-cleanup");
+function runCleanupArtifactsCommand(options) {
+    const activeUserEmail = options.user || process.env.FRAIM_ACTIVE_USER_EMAIL || '';
+    if (!activeUserEmail.trim()) {
+        throw new Error('Missing active user email. Pass --user <email> or set FRAIM_ACTIVE_USER_EMAIL.');
+    }
+    const workspaceRoot = node_path_1.default.resolve(options.workspaceRoot || options.root || process.cwd());
+    const report = (0, artifact_retention_cleanup_1.runArtifactCleanup)(workspaceRoot, {
+        activeUserEmail: activeUserEmail.trim(),
+        apply: Boolean(options.apply),
+    });
+    process.stdout.write(`${JSON.stringify(report, null, 2)}\n`);
+}
+exports.cleanupArtifactsCommand = new commander_1.Command('cleanup-artifacts')
+    .alias('cleanup-artifact')
+    .description('Evaluate and optionally apply artifact retention cleanup for the current FRAIM workspace')
+    .option('--user <email>', 'Active user email used only for user-scoped cleanup categories')
+    .option('--workspace-root <path>', 'Workspace root containing fraim/config.json')
+    .option('--root <path>', 'Alias for --workspace-root')
+    .option('--apply', 'Delete eligible files. Without this flag the command performs a dry run.')
+    .action((options) => {
+    try {
+        runCleanupArtifactsCommand(options);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        process.stderr.write(`artifact cleanup failed: ${message}\n`);
+        process.exit(1);
+    }
+});

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

@@ -18,6 +18,7 @@ const fraim_gitignore_1 = require("../utils/fraim-gitignore");
 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 user_config_1 = require("../utils/user-config");
 const checkGlobalSetup = () => {
     const fraimUserDir = process.env.FRAIM_USER_DIR || path_1.default.join(os_1.default.homedir(), '.fraim');
     const globalConfigPath = path_1.default.join(fraimUserDir, 'config.json');
@@ -178,20 +179,26 @@ const runInitProject = async (options = {}) => {
     else {
         result.warnings.push('Sync was skipped for this run.');
     }
-    const codexAvailable = (0, ide_detector_1.detectInstalledIDEs)().some((ide) => ide.configType === 'codex') ||
-        (0, ide_detector_1.detectInstalledIDEs)('cli-runnable').some((ide) => ide.configType === 'codex');
+    const detectedIdes = [
+        ...(0, ide_detector_1.detectInstalledIDEs)(),
+        ...(0, ide_detector_1.detectInstalledIDEs)('cli-runnable')
+    ];
+    const detectedConfigTypes = [...new Set(detectedIdes.map((ide) => (0, ide_detector_1.getAdapterConfigType)(ide)))];
+    if (detectedConfigTypes.length > 0) {
+        (0, user_config_1.writeUserFraimConfig)({ installedIdes: detectedConfigTypes });
+    }
+    const codexAvailable = detectedIdes.some((ide) => ide.configType === 'codex');
     if (codexAvailable) {
         const codexLocalResult = (0, codex_local_config_1.ensureCodexLocalConfig)(projectRoot);
         const status = codexLocalResult.created ? 'Created' : codexLocalResult.updated ? 'Updated' : 'Verified';
         console.log(chalk_1.default.green(`${status} project Codex config at ${codexLocalResult.path}`));
     }
     // Enable token telemetry for Claude Code (user-level, applies to all projects)
-    const claudeCodeAvailable = (0, ide_detector_1.detectInstalledIDEs)().some((ide) => ide.configType === 'claude-code') ||
-        (0, ide_detector_1.detectInstalledIDEs)('cli-runnable').some((ide) => ide.configType === 'claude-code');
+    const claudeCodeAvailable = detectedIdes.some((ide) => ide.configType === 'claude-code');
     if (claudeCodeAvailable) {
         (0, claude_code_telemetry_1.ensureClaudeCodeTelemetryEnv)();
     }
-    const adapterUpdates = (0, agent_adapters_1.ensureAgentAdapterFiles)(projectRoot);
+    const adapterUpdates = (0, agent_adapters_1.ensureAgentAdapterFiles)(projectRoot, detectedConfigTypes.length > 0 ? detectedConfigTypes : null);
     if (adapterUpdates.length > 0) {
         console.log(chalk_1.default.green(`Updated FRAIM agent adapter files: ${adapterUpdates.join(', ')}`));
     }

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

@@ -47,6 +47,9 @@ const script_sync_utils_1 = require("../utils/script-sync-utils");
 const git_utils_1 = require("../../core/utils/git-utils");
 const agent_adapters_1 = require("../utils/agent-adapters");
 const fraim_gitignore_1 = require("../utils/fraim-gitignore");
+const user_config_1 = require("../utils/user-config");
+const ide_detector_1 = require("../setup/ide-detector");
+const remote_sync_1 = require("../utils/remote-sync");
 const project_fraim_paths_1 = require("../../core/utils/project-fraim-paths");
 function resolveExplicitLocalSyncUrl() {
     const candidates = [
@@ -83,9 +86,10 @@ function loadUserApiKey() {
         return undefined;
     }
 }
-function writeSyncMetadata(fraimDir, mode, remoteUrl) {
-    fs_1.default.mkdirSync(fraimDir, { recursive: true });
-    fs_1.default.writeFileSync(path_1.default.join(fraimDir, '.sync-metadata.json'), JSON.stringify({
+function writeSyncMetadata(mode, remoteUrl) {
+    const userDir = (0, project_fraim_paths_1.getUserFraimDirPath)();
+    fs_1.default.mkdirSync(userDir, { recursive: true });
+    fs_1.default.writeFileSync(path_1.default.join(userDir, '.sync-metadata.json'), JSON.stringify({
         localVersion: (0, version_utils_1.getFraimVersion)(),
         mode,
         remoteUrl,
@@ -109,6 +113,65 @@ function removeLegacyVersionFromConfig(fraimDir) {
         console.warn(chalk_1.default.yellow('Could not remove legacy version from config.json.'));
     }
 }
+function resolveAllowedConfigTypes() {
+    const persisted = (0, user_config_1.getInstalledIdes)();
+    const liveDetected = [
+        ...(0, ide_detector_1.detectInstalledIDEs)(),
+        ...(0, ide_detector_1.detectInstalledIDEs)('cli-runnable')
+    ].map((ide) => (0, ide_detector_1.getAdapterConfigType)(ide));
+    const liveSet = [...new Set(liveDetected)];
+    if (!persisted) {
+        return liveSet.length > 0 ? liveSet : null;
+    }
+    const merged = [...new Set([...persisted, ...liveSet])];
+    return merged.length > 0 ? merged : null;
+}
+async function cleanupStaleAdapterFiles(projectRoot, allowedConfigTypes) {
+    if (!allowedConfigTypes) {
+        return;
+    }
+    (0, project_fraim_paths_1.assertWorkspaceFraimRoot)(projectRoot);
+    const { execFile } = await Promise.resolve().then(() => __importStar(require('child_process')));
+    const { promisify } = await Promise.resolve().then(() => __importStar(require('util')));
+    const execFileAsync = promisify(execFile);
+    for (const [relPath, configType] of Object.entries((0, agent_adapters_1.getAdapterConfigTypes)())) {
+        if (configType === 'standard' || allowedConfigTypes.includes(configType)) {
+            continue;
+        }
+        const fullPath = path_1.default.join(projectRoot, relPath);
+        if (!fs_1.default.existsSync(fullPath)) {
+            continue;
+        }
+        try {
+            const content = fs_1.default.readFileSync(fullPath, 'utf8');
+            if (!content.includes(remote_sync_1.SYNCED_CONTENT_BANNER_MARKER)) {
+                continue;
+            }
+        }
+        catch {
+            continue;
+        }
+        try {
+            await execFileAsync('git', ['rm', '--cached', relPath], { cwd: projectRoot });
+        }
+        catch {
+            // Not tracked or git unavailable — still clean up from disk and gitignore.
+        }
+        try {
+            (0, fraim_gitignore_1.addToFraimGitignore)(projectRoot, relPath);
+        }
+        catch {
+            // Best-effort.
+        }
+        try {
+            fs_1.default.unlinkSync(fullPath);
+            console.log(chalk_1.default.green(`Removed stale FRAIM adapter file: ${relPath}`));
+        }
+        catch {
+            // Best-effort.
+        }
+    }
+}
 function failSync(mode, message) {
     if (mode === 'throw') {
         throw new Error(message);
@@ -222,9 +285,11 @@ const runSync = async (options) => {
         if (result.success) {
             console.log(chalk_1.default.green(`Successfully synced ${result.employeeJobsSynced} ai-employee jobs, ${result.managerJobsSynced} ai-manager jobs, ${result.skillsSynced} skills, ${result.rulesSynced} rules, ${result.scriptsSynced} scripts, and ${result.docsSynced} docs from local server`));
             removeLegacyVersionFromConfig(fraimDir);
-            writeSyncMetadata(fraimDir, 'local', localUrl);
+            writeSyncMetadata('local', localUrl);
             refreshLocalIgnoreConfig();
-            const adapterUpdates = (0, agent_adapters_1.ensureAgentAdapterFiles)(projectRoot);
+            const allowedTypes = resolveAllowedConfigTypes();
+            await cleanupStaleAdapterFiles(projectRoot, allowedTypes);
+            const adapterUpdates = (0, agent_adapters_1.ensureAgentAdapterFiles)(projectRoot, allowedTypes);
             if (adapterUpdates.length > 0) {
                 console.log(chalk_1.default.green(`Updated FRAIM agent adapter files: ${adapterUpdates.join(', ')}`));
             }
@@ -267,9 +332,11 @@ const runSync = async (options) => {
     }
     console.log(chalk_1.default.green(`Successfully synced ${result.employeeJobsSynced} ai-employee jobs, ${result.managerJobsSynced} ai-manager jobs, ${result.skillsSynced} skills, ${result.rulesSynced} rules, ${result.scriptsSynced} scripts, and ${result.docsSynced} docs from remote`));
     removeLegacyVersionFromConfig(fraimDir);
-    writeSyncMetadata(fraimDir, 'remote', config.remoteUrl || process.env.FRAIM_REMOTE_URL || 'https://fraim.wellnessatwork.me');
+    writeSyncMetadata('remote', config.remoteUrl || process.env.FRAIM_REMOTE_URL || 'https://fraim.wellnessatwork.me');
     refreshLocalIgnoreConfig();
-    const adapterUpdates = (0, agent_adapters_1.ensureAgentAdapterFiles)(projectRoot);
+    const allowedTypes = resolveAllowedConfigTypes();
+    await cleanupStaleAdapterFiles(projectRoot, allowedTypes);
+    const adapterUpdates = (0, agent_adapters_1.ensureAgentAdapterFiles)(projectRoot, allowedTypes);
     if (adapterUpdates.length > 0) {
         console.log(chalk_1.default.green(`Updated FRAIM agent adapter files: ${adapterUpdates.join(', ')}`));
     }

package/dist/src/cli/fraim.js

@@ -55,6 +55,7 @@ const first_run_1 = require("./commands/first-run");
 const workspace_config_1 = require("./commands/workspace-config");
 const org_1 = require("./commands/org");
 const manager_1 = require("./commands/manager");
+const cleanup_artifacts_1 = require("./commands/cleanup-artifacts");
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const program = new commander_1.Command();
@@ -99,6 +100,7 @@ program.addCommand(first_run_1.firstRunCommand);
 program.addCommand(workspace_config_1.workspaceConfigCommand);
 program.addCommand(org_1.orgCommand);
 program.addCommand(manager_1.managerCommand);
+program.addCommand(cleanup_artifacts_1.cleanupArtifactsCommand);
 // Wait for async command initialization before parsing
 (async () => {
     // Import the initialization promise from setup command

package/dist/src/cli/setup/ide-detector.js

@@ -4,10 +4,15 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.expandPath = exports.findIDEByName = exports.getAllSupportedIDEs = exports.detectInstalledIDEs = exports.IDE_CONFIGS = void 0;
+exports.getAdapterConfigType = getAdapterConfigType;
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const os_1 = __importDefault(require("os"));
 const child_process_1 = require("child_process");
+/** Returns the configType to use for adapter file filtering. Falls back to configType when adapterConfigType is not set. */
+function getAdapterConfigType(ide) {
+    return ide.adapterConfigType ?? ide.configType;
+}
 const expandPath = (filePath) => {
     if (filePath.startsWith('~/')) {
         return path_1.default.join(os_1.default.homedir(), filePath.slice(2));
@@ -151,6 +156,7 @@ exports.IDE_CONFIGS = [
         configPath: '~/.cursor/mcp.json',
         configFormat: 'json',
         configType: 'kiro',
+        adapterConfigType: 'cursor',
         invocationProfile: 'cursor-mention',
         detectMethod: detectCursor,
         alternativePaths: [

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

@@ -3,6 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.getAdapterConfigTypes = getAdapterConfigTypes;
 exports.ensureAgentAdapterFiles = ensureAgentAdapterFiles;
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
@@ -47,7 +48,7 @@ function mergeCursorRule(existingContent, managedSection) {
     const mergedBody = mergeManagedSection(bodyWithoutLeadingFrontmatter, managedSection).trim();
     return `${ide_invocation_surfaces_1.CURSOR_MDC_FRONTMATTER}\n\n${mergedBody}\n`;
 }
-function getAdapterFiles() {
+function getAdapterFiles(allowedConfigTypes = null) {
     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');
@@ -109,27 +110,48 @@ ${(0, ide_invocation_surfaces_1.buildFraimInvocationBody)('generic-tool-discover
 
 @../AGENTS.md
 `;
-    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: VSCODE_FRAIM_PROMPT_PATH, content: vscodePrompt },
-        { path: path_1.default.join(project_fraim_paths_1.WORKSPACE_FRAIM_DIRNAME, 'README.md'), content: fraimReadme },
-        { path: CLAUDE_FRAIM_SKILL_PATH, content: (0, ide_invocation_surfaces_1.buildClaudeSkillContent)() },
-        { path: CLAUDE_FRAIM_COMMAND_PATH, content: (0, ide_invocation_surfaces_1.buildClaudeCommandShimContent)() },
-        { path: CODEX_FRAIM_SKILL_PATH, content: (0, ide_invocation_surfaces_1.buildCodexSkillContent)() },
-        { path: GROK_FRAIM_SKILL_PATH, content: (0, ide_invocation_surfaces_1.buildGrokSkillContent)() },
-        { path: GEMINI_FRAIM_COMMAND_PATH, content: (0, ide_invocation_surfaces_1.buildGeminiCommandContent)() },
-        { path: GEMINI_PROJECT_INSTRUCTIONS_PATH, content: geminiProjectInstructions },
-        { path: WINDSURF_FRAIM_COMMAND_PATH, content: (0, ide_invocation_surfaces_1.buildWindsurfCommandContent)() },
-        { path: KIRO_FRAIM_COMMAND_PATH, content: (0, ide_invocation_surfaces_1.buildKiroCommandContent)() }
+    const all = [
+        { path: 'AGENTS.md', content: markdownBody, configType: 'standard' },
+        { path: 'CLAUDE.md', content: markdownBody, configType: 'standard' },
+        { path: path_1.default.join('.github', 'copilot-instructions.md'), content: copilotBody, configType: 'vscode' },
+        { path: CURSOR_RULE_PATH, content: cursorManagedBody, configType: 'cursor' },
+        { path: VSCODE_FRAIM_PROMPT_PATH, content: vscodePrompt, configType: 'vscode' },
+        { path: path_1.default.join(project_fraim_paths_1.WORKSPACE_FRAIM_DIRNAME, 'README.md'), content: fraimReadme, configType: 'standard' },
+        { path: CLAUDE_FRAIM_SKILL_PATH, content: (0, ide_invocation_surfaces_1.buildClaudeSkillContent)(), configType: 'claude-code' },
+        { path: CLAUDE_FRAIM_COMMAND_PATH, content: (0, ide_invocation_surfaces_1.buildClaudeCommandShimContent)(), configType: 'claude-code' },
+        { path: CODEX_FRAIM_SKILL_PATH, content: (0, ide_invocation_surfaces_1.buildCodexSkillContent)(), configType: 'codex' },
+        { path: GROK_FRAIM_SKILL_PATH, content: (0, ide_invocation_surfaces_1.buildGrokSkillContent)(), configType: 'grok' },
+        { path: GEMINI_FRAIM_COMMAND_PATH, content: (0, ide_invocation_surfaces_1.buildGeminiCommandContent)(), configType: 'gemini-cli' },
+        { path: GEMINI_PROJECT_INSTRUCTIONS_PATH, content: geminiProjectInstructions, configType: 'gemini-cli' },
+        { path: WINDSURF_FRAIM_COMMAND_PATH, content: (0, ide_invocation_surfaces_1.buildWindsurfCommandContent)(), configType: 'windsurf' },
+        { path: KIRO_FRAIM_COMMAND_PATH, content: (0, ide_invocation_surfaces_1.buildKiroCommandContent)(), configType: 'kiro' }
     ];
+    if (allowedConfigTypes === null) {
+        return all;
+    }
+    return all.filter(f => f.configType === 'standard' || allowedConfigTypes.includes(f.configType));
+}
+function getAdapterConfigTypes() {
+    const result = {};
+    for (const f of getAdapterFiles()) {
+        result[f.path.replace(/\\/g, '/')] = f.configType;
+    }
+    return result;
 }
-function ensureAgentAdapterFiles(projectRoot) {
+function ensureAgentAdapterFiles(projectRoot, allowedConfigTypes = null) {
+    (0, project_fraim_paths_1.assertWorkspaceFraimRoot)(projectRoot);
     const updatedPaths = [];
-    for (const file of getAdapterFiles()) {
+    const resolvedProjectRoot = path_1.default.resolve(projectRoot);
+    for (const file of getAdapterFiles(allowedConfigTypes)) {
         const fullPath = path_1.default.join(projectRoot, file.path);
+        const resolvedFullPath = path_1.default.resolve(fullPath);
+        const relativeToProject = path_1.default.relative(resolvedProjectRoot, resolvedFullPath);
+        if (relativeToProject === '' || relativeToProject.startsWith('..') || path_1.default.isAbsolute(relativeToProject)) {
+            throw new Error(`Refusing to write FRAIM adapter outside project root: ${resolvedFullPath}`);
+        }
+        if (file.path.replace(/\\/g, '/').startsWith(`${project_fraim_paths_1.WORKSPACE_FRAIM_DIRNAME}/`)) {
+            (0, project_fraim_paths_1.assertWorkspaceFraimPath)(projectRoot, fullPath);
+        }
         const dir = path_1.default.dirname(fullPath);
         if (!fs_1.default.existsSync(dir)) {
             fs_1.default.mkdirSync(dir, { recursive: true });

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

@@ -4,6 +4,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ensureFraimSyncedContentLocallyExcluded = exports.removeFraimSyncedContentGitignoreBlock = exports.FRAIM_SYNC_GITIGNORE_ENTRIES = exports.FRAIM_SYNC_GITIGNORE_END = exports.FRAIM_SYNC_GITIGNORE_START = void 0;
+exports.addToFraimGitignore = addToFraimGitignore;
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 exports.FRAIM_SYNC_GITIGNORE_START = '# BEGIN FRAIM SYNCED CONTENT';
@@ -73,6 +74,18 @@ const removeFraimSyncedContentGitignoreBlock = (projectRoot) => {
     return true;
 };
 exports.removeFraimSyncedContentGitignoreBlock = removeFraimSyncedContentGitignoreBlock;
+function addToFraimGitignore(projectRoot, entry) {
+    const gitignorePath = path_1.default.join(projectRoot, '.gitignore');
+    const existing = fs_1.default.existsSync(gitignorePath) ? fs_1.default.readFileSync(gitignorePath, 'utf8') : '';
+    const lines = existing.replace(/\r\n/g, '\n').split('\n');
+    if (lines.includes(entry)) {
+        return;
+    }
+    const appended = existing.trimEnd().length > 0
+        ? `${existing.trimEnd()}\n${entry}\n`
+        : `${entry}\n`;
+    fs_1.default.writeFileSync(gitignorePath, appended, 'utf8');
+}
 const ensureFraimSyncedContentLocallyExcluded = (projectRoot) => {
     const gitignoreUpdated = (0, exports.removeFraimSyncedContentGitignoreBlock)(projectRoot);
     const excludePath = resolveGitInfoExcludePath(projectRoot);