fraim 2.0.357 → 2.0.358-next.0

package/dist/src/cli/api/get-provider-client.js

@@ -30,9 +30,11 @@ function getProviderClient() {
         if (!fraimKey) {
             throw new Error('FRAIM API key not found in config');
         }
-        // Use FRAIM_REMOTE_URL if set (for tests or custom deployments)
-        // Otherwise ProviderClient will use its default
-        const serverUrl = process.env.FRAIM_REMOTE_URL || undefined;
+        // Resolve the remote URL: env var priority over config.json channel over PROD default.
+        const channel = (process.env.FRAIM_RELEASE_CHANNEL || config.releaseChannel || '').toLowerCase();
+        const serverUrl = channel === 'ppe'
+            ? 'https://app-ashley-fraim-ppe.azurewebsites.net'
+            : (process.env.FRAIM_REMOTE_URL || undefined);
         return new provider_client_1.ProviderClient(fraimKey, serverUrl);
     }
     catch (error) {

package/dist/src/cli/api/provider-client.js

@@ -8,10 +8,7 @@ exports.ProviderClient = void 0;
 const axios_1 = __importDefault(require("axios"));
 class ProviderClient {
     constructor(fraimKey, serverUrl) {
-        const isPpe = (process.env.FRAIM_RELEASE_CHANNEL || '').toUpperCase() === 'PPE';
-        this.serverUrl = serverUrl ||
-            (isPpe ? 'https://app-ashley-fraim-ppe.azurewebsites.net'
-                : (process.env.FRAIM_REMOTE_URL || 'https://fraim.wellnessatwork.me'));
+        this.serverUrl = serverUrl || process.env.FRAIM_REMOTE_URL || 'https://fraim.wellnessatwork.me';
         this.client = axios_1.default.create({
             baseURL: this.serverUrl,
             headers: {

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

@@ -20,7 +20,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.addSurfaceCommand = void 0;
 const commander_1 = require("commander");
 const chalk_1 = __importDefault(require("chalk"));
-const FRAIM_REMOTE_URL = 'https://fraim.wellnessatwork.me';
+const user_config_1 = require("../utils/user-config");
+const FRAIM_REMOTE_URL = (0, user_config_1.getRemoteUrl)();
 const MCP_ENDPOINT = `${FRAIM_REMOTE_URL}/mcp`;
 // ─── surface handlers ────────────────────────────────────────────────────────
 function printClaudeWebInstructions(surface) {

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

@@ -10,6 +10,7 @@ const path_1 = __importDefault(require("path"));
 const chalk_1 = __importDefault(require("chalk"));
 const axios_1 = __importDefault(require("axios"));
 const git_utils_1 = require("../../core/utils/git-utils");
+const user_config_1 = require("../utils/user-config");
 const project_fraim_paths_1 = require("../../core/utils/project-fraim-paths");
 exports.overrideCommand = new commander_1.Command('override')
     .description('Create a local override for a FRAIM registry file')
@@ -67,7 +68,7 @@ exports.overrideCommand = new commander_1.Command('override')
                 serverUrl = `http://localhost:${localPort}`;
             }
             else {
-                serverUrl = config.remoteUrl || ((process.env.FRAIM_RELEASE_CHANNEL || '').toUpperCase() === 'PPE' ? 'https://app-ashley-fraim-ppe.azurewebsites.net' : (process.env.FRAIM_REMOTE_URL || 'https://fraim.wellnessatwork.me'));
+                serverUrl = config.remoteUrl || (0, user_config_1.getRemoteUrl)();
             }
             const apiKey = isLocal ? 'local-dev' : (config.apiKey || process.env.FRAIM_API_KEY);
             const headers = { 'Content-Type': 'application/json' };

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

@@ -48,6 +48,7 @@ const git_utils_1 = require("../../core/utils/git-utils");
 const project_catalog_cleanup_1 = require("../utils/project-catalog-cleanup");
 const fraim_gitignore_1 = require("../utils/fraim-gitignore");
 const remote_sync_1 = require("../utils/remote-sync");
+const user_config_1 = require("../utils/user-config");
 const project_fraim_paths_1 = require("../../core/utils/project-fraim-paths");
 function resolveExplicitLocalSyncUrl() {
     const candidates = [
@@ -125,7 +126,7 @@ const runSync = async (options) => {
     // Order: user-level config → env var → project config (only if in a project)
     const remoteUrl = useLocal
         ? resolveExplicitLocalSyncUrl() || `http://localhost:${process.env.FRAIM_MCP_PORT || (0, git_utils_1.getPort)()}`
-        : (process.env.FRAIM_RELEASE_CHANNEL || '').toUpperCase() === 'PPE' ? 'https://app-ashley-fraim-ppe.azurewebsites.net' : (process.env.FRAIM_REMOTE_URL || 'https://fraim.wellnessatwork.me');
+        : (0, user_config_1.getRemoteUrl)();
     let apiKey = useLocal ? 'local-dev' : loadUserApiKey() || process.env.FRAIM_API_KEY;
     const hasProject = (0, project_fraim_paths_1.workspaceFraimExists)(projectRoot);
     if (!apiKey && hasProject) {

package/dist/src/cli/doctor/checks/fraim-mcp-diagnostics.js

@@ -14,6 +14,7 @@ exports.analyzeFraimProxyLog = analyzeFraimProxyLog;
 exports.diagnoseFraimServerConfigConsistency = diagnoseFraimServerConfigConsistency;
 const fs_1 = __importDefault(require("fs"));
 const redact_secrets_1 = require("../../../core/utils/redact-secrets");
+const user_config_1 = require("../../utils/user-config");
 exports.DEFAULT_FRAIM_REMOTE_URL = 'https://fraim.wellnessatwork.me';
 exports.FRAIM_PROXY_LOG_FILE = 'fraim-mcp-proxy.log';
 function fingerprintSecret(secret) {
@@ -250,7 +251,7 @@ options = {}) {
 function diagnoseFraimServerConfigConsistency(fraimServer, options = {}) {
     const configuredKey = fraimServer?.env?.FRAIM_API_KEY ? String(fraimServer.env.FRAIM_API_KEY) : '';
     const configuredRemoteUrl = String(fraimServer?.env?.FRAIM_REMOTE_URL || exports.DEFAULT_FRAIM_REMOTE_URL);
-    const expectedRemoteUrl = options.expectedRemoteUrl || process.env.FRAIM_REMOTE_URL || exports.DEFAULT_FRAIM_REMOTE_URL;
+    const expectedRemoteUrl = options.expectedRemoteUrl || (0, user_config_1.getRemoteUrl)();
     const apiKeyMatchesExpected = options.expectedApiKey && configuredKey
         ? configuredKey === options.expectedApiKey
         : null;

package/dist/src/cli/doctor/checks/mcp-connectivity-checks.js

@@ -58,6 +58,7 @@ const toml = __importStar(require("toml"));
 const redact_secrets_1 = require("../../../core/utils/redact-secrets");
 const ide_detector_1 = require("../../setup/ide-detector");
 const fraim_mcp_latest_launcher_1 = require("../../mcp/fraim-mcp-latest-launcher");
+const user_config_1 = require("../../utils/user-config");
 const fraim_mcp_diagnostics_1 = require("./fraim-mcp-diagnostics");
 const fraim_mcp_cache_repair_1 = require("./fraim-mcp-cache-repair");
 // Cache the npm major version so execFileSync is called at most once per process.
@@ -300,7 +301,7 @@ async function testFraimConnectivity() {
         }
         // Test connectivity by making a request to the FRAIM server
         const startTime = Date.now();
-        const remoteUrl = process.env.FRAIM_REMOTE_URL || fraim_mcp_diagnostics_1.DEFAULT_FRAIM_REMOTE_URL;
+        const remoteUrl = (0, user_config_1.getRemoteUrl)();
         // Debug: Log what we're testing (helpful for troubleshooting)
         if (process.env.DEBUG_DOCTOR) {
             console.log('[DOCTOR DEBUG] Testing FRAIM connectivity:');
@@ -541,7 +542,7 @@ async function validateIDEMCPConfig(ide) {
             const keyDiagnostic = resolveFraimApiKeyForDiagnostics();
             const consistencyDiagnostic = (0, fraim_mcp_diagnostics_1.diagnoseFraimServerConfigConsistency)(fraimServer, {
                 expectedApiKey: keyDiagnostic.apiKey,
-                expectedRemoteUrl: process.env.FRAIM_REMOTE_URL || fraim_mcp_diagnostics_1.DEFAULT_FRAIM_REMOTE_URL
+                expectedRemoteUrl: (0, user_config_1.getRemoteUrl)()
             });
             if (consistencyDiagnostic.status !== 'passed') {
                 return {

package/dist/src/cli/mcp/fraim-mcp-latest-launcher.js

@@ -73,7 +73,15 @@ const CACHE_GENERATIONS_KEPT = ${CACHE_GENERATIONS_KEPT};
 const CACHE_MIN_AGE_MS = ${CACHE_MIN_AGE_MS};
 const USER_DIR = process.env.FRAIM_USER_DIR || path.join(os.homedir(), '.fraim');
 const STATE_DIR = path.join(USER_DIR, 'mcp-launcher');
-const DIST_TAG = (process.env.FRAIM_RELEASE_CHANNEL || '').toUpperCase() === 'PPE' ? 'next' : 'latest';
+// Env var takes priority; fall back to ~/.fraim/config.json releaseChannel.
+// Some MCP clients (codex) replace the inherited env and strip FRAIM_RELEASE_CHANNEL,
+// so the config file is the stable cross-client source of truth.
+const CHANNEL = (() => {
+  if (process.env.FRAIM_RELEASE_CHANNEL) return process.env.FRAIM_RELEASE_CHANNEL;
+  try { const c = JSON.parse(fs.readFileSync(path.join(USER_DIR, 'config.json'), 'utf8')); if (c.releaseChannel) return c.releaseChannel; } catch {}
+  return '';
+})();
+const DIST_TAG = CHANNEL.toUpperCase() === 'PPE' ? 'next' : 'latest';
 const STATE_PATH = path.join(STATE_DIR, 'latest-' + DIST_TAG + '.json');
 const CACHE_ROOT = path.join(USER_DIR, 'npm-cache', 'mcp');
 const REFRESH_LOCK = path.join(STATE_DIR, 'refresh-' + DIST_TAG + '.lock');

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

@@ -11,6 +11,7 @@ exports.buildAllBaseServers = buildAllBaseServers;
 const provider_registry_1 = require("../providers/provider-registry");
 const command_resolution_1 = require("./command-resolution");
 const fraim_mcp_latest_launcher_1 = require("./fraim-mcp-latest-launcher");
+const user_config_1 = require("../utils/user-config");
 exports.BASE_MCP_SERVERS = [
     {
         id: 'git',
@@ -42,6 +43,7 @@ exports.BASE_MCP_SERVERS = [
         description: 'FRAIM job orchestration and mentoring',
         buildServer: (fraimKey) => {
             const launcher = (0, fraim_mcp_latest_launcher_1.ensureFraimMcpLatestLauncher)();
+            const channel = (0, user_config_1.getReleaseChannel)();
             return {
                 command: launcher.command,
                 args: launcher.args,
@@ -49,10 +51,8 @@ exports.BASE_MCP_SERVERS = [
                     // Include API key for IDE configs (Codex, VSCode, etc.)
                     // The stdio-server will use this if set, otherwise falls back to ~/.fraim/config.json
                     FRAIM_API_KEY: fraimKey,
-                    FRAIM_REMOTE_URL: (process.env.FRAIM_RELEASE_CHANNEL || '').toUpperCase() === 'PPE'
-                        ? 'https://app-ashley-fraim-ppe.azurewebsites.net'
-                        : 'https://fraim.wellnessatwork.me',
-                    ...(process.env.FRAIM_RELEASE_CHANNEL ? { FRAIM_RELEASE_CHANNEL: process.env.FRAIM_RELEASE_CHANNEL } : {})
+                    FRAIM_REMOTE_URL: (0, user_config_1.getRemoteUrl)(),
+                    ...(channel ? { FRAIM_RELEASE_CHANNEL: channel } : {})
                 }
             };
         }

package/dist/src/cli/utils/manager-pack-sync.js

@@ -143,7 +143,7 @@ async function discoverCloudManagerStorage(options) {
         const apiKey = options?.apiKey || (0, user_config_1.readUserFraimConfig)().apiKey;
         if (!apiKey || apiKey === 'local-dev' || apiKey === 'test-mode-key')
             return null;
-        const remoteUrl = options?.remoteUrl || ((process.env.FRAIM_RELEASE_CHANNEL || '').toUpperCase() === 'PPE' ? 'https://app-ashley-fraim-ppe.azurewebsites.net' : (process.env.FRAIM_REMOTE_URL || 'https://fraim.wellnessatwork.me'));
+        const remoteUrl = options?.remoteUrl || (0, user_config_1.getRemoteUrl)();
         const pack = await fetchCloudPack(remoteUrl, apiKey);
         if (pack.files.length === 0)
             return null;
@@ -217,7 +217,7 @@ async function syncManagerCache(options) {
             writeHomeMetadata(metadata);
             return { status: 'synced', metadata };
         }
-        const remoteUrl = options?.remoteUrl || ((process.env.FRAIM_RELEASE_CHANNEL || '').toUpperCase() === 'PPE' ? 'https://app-ashley-fraim-ppe.azurewebsites.net' : (process.env.FRAIM_REMOTE_URL || 'https://fraim.wellnessatwork.me'));
+        const remoteUrl = options?.remoteUrl || (0, user_config_1.getRemoteUrl)();
         const apiKey = options?.apiKey || (0, user_config_1.readUserFraimConfig)().apiKey;
         if (!apiKey)
             throw new Error('No FRAIM API key available for the fraim-cloud manager backend.');

package/dist/src/cli/utils/manager-publish.js

@@ -58,7 +58,7 @@ async function publishManagerArtifacts(artifacts, opts) {
         return { backend: 'local-folder', writtenPaths, deletedPaths };
     }
     if (managerStorage.backend === 'fraim-cloud') {
-        const remoteUrl = opts?.remoteUrl || process.env.FRAIM_REMOTE_URL || 'https://fraim.wellnessatwork.me';
+        const remoteUrl = opts?.remoteUrl || (0, user_config_1.getRemoteUrl)();
         const apiKey = opts?.apiKey || (0, user_config_1.readUserFraimConfig)().apiKey;
         if (!apiKey)
             throw new Error('No FRAIM API key available for the fraim-cloud manager backend.');

package/dist/src/cli/utils/org-pack-sync.js

@@ -187,7 +187,7 @@ async function discoverCloudOrganization(options) {
         const apiKey = options?.apiKey || (0, user_config_1.readUserFraimConfig)().apiKey;
         if (!apiKey || apiKey === 'local-dev' || apiKey === 'test-mode-key')
             return null;
-        const remoteUrl = options?.remoteUrl || process.env.FRAIM_REMOTE_URL || 'https://fraim.wellnessatwork.me';
+        const remoteUrl = options?.remoteUrl || (0, user_config_1.getRemoteUrl)();
         const pack = await fetchCloudPack(remoteUrl, apiKey);
         if (pack.files.length === 0)
             return null;
@@ -266,7 +266,7 @@ async function syncOrgCache(options) {
             writeHomeMetadata(metadata);
             return { status: 'synced', metadata };
         }
-        const remoteUrl = options?.remoteUrl || process.env.FRAIM_REMOTE_URL || 'https://fraim.wellnessatwork.me';
+        const remoteUrl = options?.remoteUrl || (0, user_config_1.getRemoteUrl)();
         const apiKey = options?.apiKey || (0, user_config_1.readUserFraimConfig)().apiKey;
         if (!apiKey)
             throw new Error('No FRAIM API key available for the fraim-cloud org backend.');

package/dist/src/cli/utils/org-publish.js

@@ -93,7 +93,7 @@ async function publishOrgArtifacts(artifacts, opts) {
         return { backend: 'local-folder', writtenPaths, deletedPaths };
     }
     if (organization.backend === 'fraim-cloud') {
-        const remoteUrl = opts?.remoteUrl || process.env.FRAIM_REMOTE_URL || 'https://fraim.wellnessatwork.me';
+        const remoteUrl = opts?.remoteUrl || (0, user_config_1.getRemoteUrl)();
         const apiKey = opts?.apiKey || (0, user_config_1.readUserFraimConfig)().apiKey;
         if (!apiKey)
             throw new Error('No FRAIM API key available for the fraim-cloud org backend.');

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

@@ -23,6 +23,7 @@ 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 user_config_1 = require("./user-config");
 const capability_index_1 = require("../../core/utils/capability-index");
 const project_fraim_paths_1 = require("../../core/utils/project-fraim-paths");
 const LOCK_SYNCED_CONTENT_ENV = 'FRAIM_LOCK_SYNCED_CONTENT';
@@ -316,7 +317,7 @@ async function syncSkillsAndRulesToUserDir(files) {
  * Sync jobs and scripts from remote FRAIM server
  */
 async function syncFromRemote(options) {
-    const remoteUrl = options.remoteUrl || process.env.FRAIM_REMOTE_URL || 'https://fraim.wellnessatwork.me';
+    const remoteUrl = options.remoteUrl || (0, user_config_1.getRemoteUrl)();
     const apiKey = options.apiKey || process.env.FRAIM_API_KEY || '';
     if (!apiKey) {
         return {

package/dist/src/cli/utils/user-config.js

@@ -8,6 +8,8 @@ exports.isLayerMisconfigured = isLayerMisconfigured;
 exports.setLayerBackend = setLayerBackend;
 exports.readUserFraimConfig = readUserFraimConfig;
 exports.writeUserFraimConfig = writeUserFraimConfig;
+exports.getReleaseChannel = getReleaseChannel;
+exports.getRemoteUrl = getRemoteUrl;
 exports.getInstalledIdes = getInstalledIdes;
 exports.addInstalledIde = addInstalledIde;
 exports.getOrganizationConfig = getOrganizationConfig;
@@ -89,6 +91,19 @@ function writeUserFraimConfig(patch) {
     fs_1.default.writeFileSync(getUserConfigPath(), JSON.stringify(merged, null, 2));
     return merged;
 }
+/**
+ * Resolve the active release channel. Env var takes priority over config
+ * so per-session overrides work without touching the file.
+ */
+function getReleaseChannel() {
+    return (process.env.FRAIM_RELEASE_CHANNEL || readUserFraimConfig().releaseChannel || '').toLowerCase();
+}
+/** Resolve the active FRAIM remote URL from channel + env. */
+function getRemoteUrl() {
+    if (getReleaseChannel() === 'ppe')
+        return 'https://app-ashley-fraim-ppe.azurewebsites.net';
+    return process.env.FRAIM_REMOTE_URL || 'https://fraim.wellnessatwork.me';
+}
 function getInstalledIdes() {
     const raw = readUserFraimConfig().installedIdes;
     return Array.isArray(raw) ? raw : null;

package/dist/src/local-mcp-server/stdio-server.js

@@ -560,9 +560,7 @@ class FraimLocalMCPServer {
         this.orgCacheRefreshInFlight = false;
         this.managerCacheRefreshInFlight = false;
         this.writer = writer || process.stdout.write.bind(process.stdout);
-        const isPpe = (process.env.FRAIM_RELEASE_CHANNEL || '').toUpperCase() === 'PPE';
-        this.remoteUrl = isPpe ? 'https://app-ashley-fraim-ppe.azurewebsites.net'
-            : (process.env.FRAIM_REMOTE_URL || 'https://fraim.wellnessatwork.me');
+        this.remoteUrl = this.loadRemoteUrl();
         this.apiKey = this.loadApiKey();
         this.localVersion = this.detectLocalVersion();
         if (!this.apiKey) {
@@ -622,6 +620,28 @@ class FraimLocalMCPServer {
         }
         return '';
     }
+    /**
+     * Priority: FRAIM_RELEASE_CHANNEL env var > config.releaseChannel > FRAIM_REMOTE_URL env var > default prod URL.
+     */
+    loadRemoteUrl() {
+        const channel = (() => {
+            if (process.env.FRAIM_RELEASE_CHANNEL)
+                return process.env.FRAIM_RELEASE_CHANNEL;
+            try {
+                const homeDir = process.env.HOME || process.env.USERPROFILE || '';
+                if (!homeDir)
+                    return '';
+                const config = JSON.parse((0, fs_1.readFileSync)((0, path_1.join)(homeDir, '.fraim', 'config.json'), 'utf8'));
+                if (config.releaseChannel)
+                    return config.releaseChannel;
+            }
+            catch { }
+            return '';
+        })();
+        if (channel.toUpperCase() === 'PPE')
+            return 'https://app-ashley-fraim-ppe.azurewebsites.net';
+        return process.env.FRAIM_REMOTE_URL || 'https://fraim.wellnessatwork.me';
+    }
     // #533: persist the authenticated user email into ~/.fraim/preferences.json so
     // the AI Hub (a separate process) can resolve personal learnings + show the real
     // profile. Merge-and-write; never throw out of the connect path.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fraim",
-  "version": "2.0.357",
+  "version": "2.0.358-next.0",
   "description": "FRAIM core CLI and MCP package.",
   "main": "index.js",
   "bin": {