fraim-framework 2.0.192 → 2.0.193

package/dist/src/ai-hub/preferences.js

@@ -19,6 +19,7 @@ const defaultPreferences = (projectPath) => ({
     recentJobInstructions: {},
     personaKey: null,
     projects: normalizeAiHubProjectList([], projectPath),
+    removedProjectPaths: [],
 });
 function normalizeProjectPath(projectPath) {
     return path_1.default.resolve(projectPath || process.cwd());
@@ -38,6 +39,21 @@ function projectPathExists(projectPath) {
 function projectIdForPath(projectPath) {
     return `p-${(0, crypto_1.createHash)('sha1').update(canonicalProjectPath(projectPath)).digest('base64url').slice(0, 16)}`;
 }
+function normalizeRemovedProjectPaths(raw, currentProjectPath) {
+    if (!Array.isArray(raw))
+        return [];
+    const currentKey = currentProjectPath ? canonicalProjectPath(currentProjectPath) : null;
+    const seen = new Set();
+    for (const value of raw) {
+        if (typeof value !== 'string' || value.trim().length === 0)
+            continue;
+        const key = canonicalProjectPath(value);
+        if (currentKey && key === currentKey)
+            continue;
+        seen.add(key);
+    }
+    return Array.from(seen);
+}
 function uniqueProjectId(entry, seenIds) {
     const fallbackId = projectIdForPath(entry.folderPath);
     const rawId = typeof entry.id === 'string' ? entry.id.trim() : '';
@@ -86,10 +102,13 @@ function normalizeProjectEntry(raw, fallbackPath) {
 function normalizeAiHubProjectList(projects, currentProjectPath, options = {}) {
     const byPath = new Map();
     const currentKey = currentProjectPath ? normalizeProjectPath(currentProjectPath) : null;
+    const removedKeys = new Set(normalizeRemovedProjectPaths(options.removedProjectPaths, currentProjectPath));
     const add = (entry) => {
         if (!entry)
             return;
         const key = normalizeProjectPath(entry.folderPath);
+        if (removedKeys.has(canonicalProjectPath(key)))
+            return;
         if (!options.includeMissing && key !== currentKey && !projectPathExists(key))
             return;
         const existing = byPath.get(key);
@@ -111,6 +130,7 @@ class AiHubPreferencesStore {
         }
         try {
             const raw = JSON.parse(fs_1.default.readFileSync(this.stateFilePath, 'utf8'));
+            const removedProjectPaths = normalizeRemovedProjectPaths(raw.removedProjectPaths, projectPath);
             return {
                 projectPath: raw.projectPath || projectPath,
                 employeeId: (raw.employeeId === 'claude' || raw.employeeId === 'codex' || raw.employeeId === 'gemini' || raw.employeeId === 'copilot') ? raw.employeeId : DEFAULT_EMPLOYEE,
@@ -121,7 +141,8 @@ class AiHubPreferencesStore {
                     : {},
                 personaKey: typeof raw.personaKey === 'string' ? raw.personaKey : null,
                 apiKey: typeof raw.apiKey === 'string' && raw.apiKey.length > 0 ? raw.apiKey : undefined,
-                projects: normalizeAiHubProjectList(Array.isArray(raw.projects) ? raw.projects : [], projectPath),
+                projects: normalizeAiHubProjectList(Array.isArray(raw.projects) ? raw.projects : [], projectPath, { removedProjectPaths }),
+                removedProjectPaths,
             };
         }
         catch {
@@ -132,18 +153,30 @@ class AiHubPreferencesStore {
         fs_1.default.mkdirSync(path_1.default.dirname(this.stateFilePath), { recursive: true });
         fs_1.default.writeFileSync(this.stateFilePath, JSON.stringify(preferences, null, 2));
     }
-    saveProjects(projectPath, projects) {
+    saveProjects(projectPath, projects, options = {}) {
         const normalizedProjectPath = normalizeProjectPath(projectPath);
         const preferences = this.load(normalizedProjectPath);
-        const nextProjects = normalizeAiHubProjectList(projects, normalizedProjectPath);
-        this.save({ ...preferences, projectPath: normalizedProjectPath, projects: nextProjects });
+        const reviveKeys = new Set(normalizeRemovedProjectPaths(options.reviveRemovedPaths, normalizedProjectPath));
+        const removedProjectPaths = normalizeRemovedProjectPaths(preferences.removedProjectPaths, normalizedProjectPath)
+            .filter((removedPath) => !reviveKeys.has(removedPath));
+        const nextProjects = normalizeAiHubProjectList(projects, normalizedProjectPath, { removedProjectPaths });
+        this.save({ ...preferences, projectPath: normalizedProjectPath, projects: nextProjects, removedProjectPaths });
         return nextProjects;
     }
     mergeProjects(projectPath, projects) {
         const normalizedProjectPath = normalizeProjectPath(projectPath);
         const preferences = this.load(normalizedProjectPath);
-        const nextProjects = normalizeAiHubProjectList([...(preferences.projects || []), ...projects], normalizedProjectPath);
-        this.save({ ...preferences, projectPath: normalizedProjectPath, projects: nextProjects });
+        const removedProjectPaths = normalizeRemovedProjectPaths(preferences.removedProjectPaths, normalizedProjectPath);
+        const nextProjects = normalizeAiHubProjectList([...(preferences.projects || []), ...projects], normalizedProjectPath, { removedProjectPaths });
+        this.save({ ...preferences, projectPath: normalizedProjectPath, projects: nextProjects, removedProjectPaths });
+        return nextProjects;
+    }
+    removeProject(projectPath, projects, removedProjectPath) {
+        const normalizedProjectPath = normalizeProjectPath(projectPath);
+        const preferences = this.load(normalizedProjectPath);
+        const removedProjectPaths = normalizeRemovedProjectPaths([...(preferences.removedProjectPaths || []), removedProjectPath], normalizedProjectPath);
+        const nextProjects = normalizeAiHubProjectList(projects, normalizedProjectPath, { removedProjectPaths });
+        this.save({ ...preferences, projectPath: normalizedProjectPath, projects: nextProjects, removedProjectPaths });
         return nextProjects;
     }
     remember(preferences, jobId, instructions) {

package/dist/src/ai-hub/server.js

@@ -1382,10 +1382,7 @@ class AiHubServer {
             ...(preferences.projects || []),
             ...conversationProjects,
             ...extras,
-        ], normalizedProjectPath);
-    }
-    saveKnownProjects(projectPath, projects) {
-        return this.preferencesStore.saveProjects(path_1.default.resolve(projectPath || this.projectPath), this.knownProjects(projectPath, projects));
+        ], normalizedProjectPath, { removedProjectPaths: preferences.removedProjectPaths || [] });
     }
     async bootstrapResponse(projectPath, apiKey) {
         const normalizedProjectPath = path_1.default.resolve(projectPath || this.projectPath);
@@ -2270,7 +2267,7 @@ class AiHubServer {
                 if (!Array.isArray(body.projects)) {
                     return res.status(400).json({ error: 'projects array required' });
                 }
-                const projects = this.saveKnownProjects(projectPath, body.projects);
+                const projects = this.preferencesStore.saveProjects(projectPath, [...this.knownProjects(projectPath), ...body.projects], { reviveRemovedPaths: Array.isArray(body.reviveRemovedPaths) ? body.reviveRemovedPaths : [] });
                 return res.json({ projectPath, projects, source: 'disk' });
             }
             catch (error) {
@@ -2312,9 +2309,9 @@ class AiHubServer {
             // Delete the conversation-store KEY — an empty list would still re-derive
             // the project via listProjectPaths (R9).
             this.conversationStore.removeProject(entry.folderPath);
-            // Persist the filtered list directly: saveKnownProjects unions with the
-            // derived list by design and cannot express removal.
-            const projects = this.preferencesStore.saveProjects(projectPath, known.filter((project) => project.id !== entry.id));
+            // Persist the filtered list with a tombstone: a normal project save
+            // still merges derived projects and cannot express removal.
+            const projects = this.preferencesStore.removeProject(projectPath, known.filter((project) => project.id !== entry.id), entry.folderPath);
             return res.json({ ok: true, projects });
         });
         this.app.post('/api/ai-hub/api-key', (req, res) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fraim-framework",
-  "version": "2.0.192",
+  "version": "2.0.193",
   "description": "FRAIM: AI Workforce Infrastructure — the organizational capability that turns AI agents into an accountable workforce, their operators into capable AI managers, and executives into leaders with clear optics on AI proficiency.",
   "main": "index.js",
   "bin": {

package/public/ai-hub/script.js

@@ -1011,6 +1011,21 @@ function aggregateDotClass(dots) {
 
 function renderRail() {
   renderTeamRoster();
+  const activeRailProjectKey = (typeof tf !== 'undefined' && tf && tf.activeProjectId)
+    || state.projectPath
+    || 'current';
+  const employeeGroupOpenState = new Map();
+  els['conv-list'].querySelectorAll('details.conv-employee-group[data-employee-key]').forEach((details) => {
+    const key = details.dataset ? details.dataset.employeeKey : '';
+    const projectKey = details.dataset ? (details.dataset.projectKey || activeRailProjectKey) : activeRailProjectKey;
+    if (key) employeeGroupOpenState.set(projectKey + ':' + key, details.open);
+  });
+  const employeeGroupStateKey = (key) => activeRailProjectKey + ':' + key;
+  const preservedEmployeeGroupOpen = (key) => (
+    employeeGroupOpenState.has(employeeGroupStateKey(key))
+      ? employeeGroupOpenState.get(employeeGroupStateKey(key))
+      : true
+  );
   els['conv-list'].innerHTML = '';
   // R4: filter by selected persona when one is active.
   // #693 R1: the "Project Updates" section was retired; project-lifecycle runs
@@ -1167,7 +1182,9 @@ function renderRail() {
   for (const group of groups.values()) {
     const details = document.createElement('details');
     details.className = 'conv-employee-group';
-    details.open = true;
+    details.dataset.employeeKey = group.key;
+    details.dataset.projectKey = activeRailProjectKey;
+    details.open = preservedEmployeeGroupOpen(group.key);
     const summary = document.createElement('summary');
     summary.className = 'conv-employee-tab';
     const avatar = buildConversationEmployeeAvatar(group.sample, 'conv-employee-avatar');
@@ -1237,7 +1254,9 @@ function renderRail() {
   if (watercoolerConvs.length > 0) {
     const wcDetails = document.createElement('details');
     wcDetails.className = 'conv-employee-group conv-employee-group--adhoc';
-    wcDetails.open = true;
+    wcDetails.dataset.employeeKey = '__watercooler__';
+    wcDetails.dataset.projectKey = activeRailProjectKey;
+    wcDetails.open = preservedEmployeeGroupOpen('__watercooler__');
     const wcSummary = document.createElement('summary');
     wcSummary.className = 'conv-employee-tab';
     // #693.8: watercooler icon (replaces the blank dashed placeholder).
@@ -6400,13 +6419,14 @@ function tfLoadStorage() {
   try { tf.assignments = JSON.parse(window.localStorage.getItem(STORAGE_KEY_ASSIGNMENTS_512) || '{}'); }
   catch { tf.assignments = {}; }
 }
-function tfPersistProjects() {
+function tfPersistProjects(options) {
   try { window.localStorage.setItem(STORAGE_KEY_PROJECTS_512, JSON.stringify(tf.projects)); } catch {}
   if (!state.projectPath) return;
+  const reviveRemovedPaths = options && Array.isArray(options.reviveRemovedPaths) ? options.reviveRemovedPaths : [];
   requestJson('/api/ai-hub/projects', {
     method: 'PUT',
     headers: { 'Content-Type': 'application/json' },
-    body: JSON.stringify({ projectPath: state.projectPath, projects: tf.projects }),
+    body: JSON.stringify({ projectPath: state.projectPath, projects: tf.projects, reviveRemovedPaths }),
   }).catch((error) => console.warn('[512] Could not persist projects to local disk:', error));
 }
 function tfPersistAssignments() {
@@ -9400,32 +9420,32 @@ function tfCloseConnectedSurface() {
   tfShowArea(returnArea);
 }
 
-async function tfHandleConnectedAuthMessage(event) {
-  const frame = document.getElementById('connected-frame');
-  if (frame && frame.contentWindow && event.source !== frame.contentWindow) return;
-  let remoteOrigin = '';
-  try { remoteOrigin = new URL(tfConnectedRemoteBase()).origin; }
+async function tfHandleConnectedAuthMessage(event) {
+  const frame = document.getElementById('connected-frame');
+  if (frame && frame.contentWindow && event.source !== frame.contentWindow) return;
+  let remoteOrigin = '';
+  try { remoteOrigin = new URL(tfConnectedRemoteBase()).origin; }
   catch { return; }
   if (event.origin !== remoteOrigin) return;
-  const msg = event.data || {};
-  if (!msg || msg.type !== 'fraim-auth-api-key' || typeof msg.apiKey !== 'string' || !msg.apiKey) return;
-  const previousKey = tfConnectedApiKey();
-  await tfRememberConnectedApiKey(msg.apiKey);
-  if (state.connectedSurface) {
-    const nextUrl = tfConnectedSurfaceUrl(state.connectedSurface);
-    const frameEl = document.getElementById('connected-frame');
-    if (frameEl) {
-      try {
-        const current = new URL(frameEl.src || '', window.location.href);
-        const next = new URL(nextUrl, window.location.href);
-        if (previousKey === msg.apiKey && current.origin === next.origin && current.pathname === next.pathname) {
-          return;
-        }
-      } catch {}
-      frameEl.src = nextUrl;
-    }
-  }
-}
+  const msg = event.data || {};
+  if (!msg || msg.type !== 'fraim-auth-api-key' || typeof msg.apiKey !== 'string' || !msg.apiKey) return;
+  const previousKey = tfConnectedApiKey();
+  await tfRememberConnectedApiKey(msg.apiKey);
+  if (state.connectedSurface) {
+    const nextUrl = tfConnectedSurfaceUrl(state.connectedSurface);
+    const frameEl = document.getElementById('connected-frame');
+    if (frameEl) {
+      try {
+        const current = new URL(frameEl.src || '', window.location.href);
+        const next = new URL(nextUrl, window.location.href);
+        if (previousKey === msg.apiKey && current.origin === next.origin && current.pathname === next.pathname) {
+          return;
+        }
+      } catch {}
+      frameEl.src = nextUrl;
+    }
+  }
+}
 
 async function tfRememberConnectedApiKey(apiKey) {
   const changed = apiKey !== state.storedApiKey;
@@ -9808,7 +9828,7 @@ async function tfCreateProject() {
   };
   tf.projects.push(project);
   tf.assignments[id] = [];
-  tfPersistProjects();
+  tfPersistProjects({ reviveRemovedPaths: [folderPath] });
   tfPersistAssignments();
   tf.activeProjectId = id;
   tfCloseNewProject();