fraim-framework 2.0.201 → 2.0.203

package/dist/src/cli/utils/version-utils.js

@@ -18,7 +18,7 @@ function getFraimVersion() {
         if (fs_1.default.existsSync(pkgPath)) {
             try {
                 const pkg = JSON.parse(fs_1.default.readFileSync(pkgPath, 'utf-8'));
-                if (pkg.name === 'fraim-framework') {
+                if (pkg.name === 'fraim-framework' || pkg.name === 'fraim') {
                     return pkg.version;
                 }
             }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fraim-framework",
-  "version": "2.0.201",
+  "version": "2.0.203",
   "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

@@ -6439,21 +6439,20 @@ function renderFirstRunLanding(mode) {
 // Company · Manager · Projects. It ADDS UI around the existing surface and
 // removes no existing ids or handlers.
 //
-// Reads the extended bootstrap (firstRun, teamContext, brain, personas).
-// Per-project employee/job assignments and the project list live in
-// localStorage (the same model as conversations); the workspace conversation
-// pane reuses the existing run/poll/coaching code paths verbatim.
-// ===========================================================================
-
-const STORAGE_KEY_PROJECTS_512 = 'fraim.aiHub.projects.v1';
-const STORAGE_KEY_ASSIGNMENTS_512 = 'fraim.aiHub.assignments.v1';
+// Reads the extended bootstrap (firstRun, teamContext, brain, personas).
+// Project tabs are server-owned local-machine state; per-project employee/job
+// assignments remain UI-local. The workspace conversation pane reuses the
+// existing run/poll/coaching code paths verbatim.
+// ===========================================================================
+
+const STORAGE_KEY_ASSIGNMENTS_512 = 'fraim.aiHub.assignments.v1';
 
 const tf = {
   enabled: false,
   area: 'projects',          // company | manager | projects | brain | connected
   projectView: 'overview',   // overview | workspace
   activeProjectId: null,
-  projects: [],              // [{ id, name, intent, brief }] — roster derived from hired personas, not stored
+  projects: [],              // server-owned [{ id, name, folderPath, intent, brief }]
   assignments: {},           // { [projectId]: [{ id, employeeKey, jobName, jobId }] }
   // #726: canonical paths just removed this session. A delete switches workspaces first,
   // and that switch's (possibly cached) bootstrap merge would otherwise re-add the project
@@ -6488,7 +6487,7 @@ function tfPersonaByKey(key) { return tfPersonas().find((p) => p.key === key) ||
 function tfProjectTeamKeys() { return tfHiredPersonas().map((p) => p.key); }
 
 // ---------------------------------------------------------------------------
-// Persistence (projects + assignments, mirrors the conversation model)
+// Persistence (server-owned projects + client-local assignments)
 // ---------------------------------------------------------------------------
 function tfCanonicalProjectPath(folderPath) {
   const value = String(folderPath || '').replace(/\\/g, '/').replace(/\/+$/, '');
@@ -6538,30 +6537,9 @@ function tfApplyUniqueProjectIds(projects) {
   });
 }
 
-function tfMergeProjects(projects) {
-  const merged = new Map();
-  const add = (project) => {
-    const normalized = tfNormalizeProject(project);
-    if (!normalized) return;
-    const key = tfCanonicalProjectPath(normalized.folderPath);
-    // #726: never re-add a project removed this session (stale/cached bootstrap merge).
-    if (tf.removedPaths && tf.removedPaths.has(key)) return;
-    const existing = merged.get(key);
-    if (existing) {
-      const next = { ...existing, ...normalized, folderPath: normalized.folderPath || existing.folderPath };
-      merged.set(key, next);
-    } else {
-      merged.set(key, normalized);
-    }
-  };
-  for (const project of tf.projects || []) add(project);
-  for (const project of projects || []) add(project);
-  tf.projects = tfApplyUniqueProjectIds(Array.from(merged.values()));
-}
-
-function tfProjectForPath(folderPath) {
-  const key = tfCanonicalProjectPath(folderPath);
-  return tf.projects.find((project) => tfCanonicalProjectPath(project.folderPath || project.path || project.folder) === key) || null;
+function tfProjectForPath(folderPath) {
+  const key = tfCanonicalProjectPath(folderPath);
+  return tf.projects.find((project) => tfCanonicalProjectPath(project.folderPath || project.path || project.folder) === key) || null;
 }
 
 function tfEnsureCurrentProject() {
@@ -6576,34 +6554,41 @@ function tfEnsureCurrentProject() {
     name: friendlyProjectShortName(state.projectPath),
     folderPath: state.projectPath,
   }, state.projectPath);
-  tfMergeProjects([current]);
-  const resolved = tfProjectForPath(state.projectPath);
-  if (!tf.activeProjectId || !tf.projects.some((project) => project.id === tf.activeProjectId)) {
-    tf.activeProjectId = resolved ? resolved.id : tf.projects[0]?.id || null;
-  }
-  return resolved;
-}
-
-function tfLoadStorage() {
-  try {
-    const stored = JSON.parse(window.localStorage.getItem(STORAGE_KEY_PROJECTS_512) || '[]');
-    const normalized = Array.isArray(stored) ? stored.map((project) => tfNormalizeProject(project)).filter(Boolean) : [];
-    tf.projects = tfApplyUniqueProjectIds(normalized);
-  }
-  catch { tf.projects = []; }
-  try { tf.assignments = JSON.parse(window.localStorage.getItem(STORAGE_KEY_ASSIGNMENTS_512) || '{}'); }
-  catch { tf.assignments = {}; }
-}
-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, reviveRemovedPaths }),
-  }).catch((error) => console.warn('[512] Could not persist projects to local disk:', error));
-}
+  let resolved = existingForPath;
+  if (!resolved && current && !(tf.removedPaths && tf.removedPaths.has(tfCanonicalProjectPath(current.folderPath)))) {
+    // Fallback only for the server bootstrap's active project path. General
+    // project-list ownership remains in bootstrap.projects / /api/ai-hub/projects.
+    tf.projects = tfApplyUniqueProjectIds([...(tf.projects || []), current]);
+    resolved = tfProjectForPath(state.projectPath);
+  }
+  if (!tf.activeProjectId || !tf.projects.some((project) => project.id === tf.activeProjectId)) {
+    tf.activeProjectId = resolved ? resolved.id : tf.projects[0]?.id || null;
+  }
+  return resolved;
+}
+
+function tfClearLegacyProjectStorage() {
+  try { window.localStorage.removeItem('fraim.aiHub.projects.v1'); } catch {}
+}
+
+function tfLoadClientState() {
+  tf.projects = [];
+  tfClearLegacyProjectStorage();
+  try { tf.assignments = JSON.parse(window.localStorage.getItem(STORAGE_KEY_ASSIGNMENTS_512) || '{}'); }
+  catch { tf.assignments = {}; }
+}
+
+async function tfSaveProjectsToServer(projects, options) {
+  if (!state.projectPath) throw new Error('No active project path available.');
+  const reviveRemovedPaths = options && Array.isArray(options.reviveRemovedPaths) ? options.reviveRemovedPaths : [];
+  const payload = await requestJson('/api/ai-hub/projects', {
+    method: 'PUT',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify({ projectPath: state.projectPath, projects: Array.isArray(projects) ? projects : [], reviveRemovedPaths }),
+  });
+  tfAdoptServerProjects(payload && payload.projects);
+  return payload;
+}
 function tfPersistAssignments() {
   try { window.localStorage.setItem(STORAGE_KEY_ASSIGNMENTS_512, JSON.stringify(tf.assignments)); } catch {}
 }
@@ -7037,9 +7022,9 @@ function tfConfirmProjectRemove(proj, cardEl) {
   });
 }
 
-// R10: adopt a server projects list as the authoritative tf.projects — a REPLACE,
-// not a tfMergeProjects union, so a later tfPersistProjects PUT cannot re-add a
-// removed project from stale in-memory state.
+// R10: adopt a server projects list as the authoritative tf.projects - a REPLACE,
+// not a client-side union, so stale in-memory/browser state cannot re-add a
+// removed project.
 function tfAdoptServerProjects(projects) {
   const normalized = (Array.isArray(projects) ? projects : [])
     .map((project) => tfNormalizeProject(project))
@@ -7099,8 +7084,7 @@ async function tfRemoveProject(proj) {
   if (!tf.projects.some((p) => p.id === tf.activeProjectId)) {
     tf.activeProjectId = tf.projects[0] ? tf.projects[0].id : null;
   }
-  tfPersistProjects();
-  tfRenderProjectTabs();
+  tfRenderProjectTabs();
   tfRenderOverview();
   if (typeof renderRail === 'function') renderRail();
   showStatus('"' + (proj.name || 'Project') + '" was removed from the Hub. Its files on disk are untouched.', false);
@@ -10287,26 +10271,36 @@ async function tfCreateProject() {
     brief: intent,
     team: tf.npSelectedEmployees.slice(),
   };
-  tf.projects.push(project);
-  tf.assignments[id] = [];
-  // #726: re-creating a project at a previously-removed path lifts the client guard
-  // (the server revive is handled via reviveRemovedPaths below).
-  tf.removedPaths.delete(tfCanonicalProjectPath(folderPath));
-  tfPersistProjects({ reviveRemovedPaths: [folderPath] });
-  tfPersistAssignments();
-  tf.activeProjectId = id;
-  tfCloseNewProject();
-  tfRenderProjectTabs();
-
-  // Switch the active workspace to this project's folder so all runs,
-  // context reads, and learnings scope to the right place.
-  await tfSwitchProjectFolder(folderPath);
+  const removedKey = tfCanonicalProjectPath(folderPath);
+  try {
+    await tfSaveProjectsToServer([...(tf.projects || []), project], { reviveRemovedPaths: [folderPath] });
+    tf.removedPaths.delete(removedKey);
+  } catch (error) {
+    showStatus('Could not create project: ' + (error && error.message ? error.message : 'request failed.'), true);
+    return;
+  }
+  const savedProject = tfProjectForPath(folderPath) || project;
+  if (!tf.assignments[savedProject.id]) tf.assignments[savedProject.id] = [];
+  tfPersistAssignments();
+  tf.activeProjectId = savedProject.id;
+  tfCloseNewProject();
+  tfRenderProjectTabs();
+
+  // Switch the active workspace to this project's folder so all runs,
+  // context reads, and learnings scope to the right place.
+  await tfSwitchProjectFolder(folderPath);
+  const currentProject = tfProjectForPath(folderPath) || savedProject;
+  if (currentProject) {
+    tf.activeProjectId = currentProject.id;
+    if (!tf.assignments[currentProject.id]) tf.assignments[currentProject.id] = [];
+    tfPersistAssignments();
+  }
 
   // #521 fix: re-render the new project's tree + Brief/Learnings top sections so
   // they reflect THIS project (the folder switch cleared the project-scoped
   // context cache; this re-fetches it) instead of leaving the previous project's
   // brief on screen ("random stuff in the brief").
-  tf._lastWorkspaceProject = id;
+  tf._lastWorkspaceProject = currentProject ? currentProject.id : savedProject.id;
   tfRenderTree();
   tfRenderProjectContextTop();
 
@@ -10371,12 +10365,11 @@ async function tfSwitchProjectFolder(folderPath) {
   } else {
     await conversationsPromise;
   }
-  tfMergeProjects(state.bootstrap && Array.isArray(state.bootstrap.projects) ? state.bootstrap.projects : []);
-  const currentProject = tfEnsureCurrentProject();
-  if (currentProject) tf.activeProjectId = currentProject.id;
-  tfPersistProjects();
-  tfRefreshAfterBootstrap();
-}
+  tfAdoptServerProjects(state.bootstrap && Array.isArray(state.bootstrap.projects) ? state.bootstrap.projects : []);
+  const currentProject = tfEnsureCurrentProject();
+  if (currentProject) tf.activeProjectId = currentProject.id;
+  tfRefreshAfterBootstrap();
+}
 
 // ---------------------------------------------------------------------------
 // Assign-job modal (job-first with locks + per-employee filter)
@@ -10939,20 +10932,19 @@ function tfInitShell() {
   document.body.classList.add('hub-shell');
   const tabs = document.getElementById('hub-tabs');
   if (tabs) tabs.hidden = false;
-  tfLoadStorage();
-  tfMergeProjects(state.bootstrap && Array.isArray(state.bootstrap.projects) ? state.bootstrap.projects : []);
+  tfLoadClientState();
+  tfAdoptServerProjects(state.bootstrap && Array.isArray(state.bootstrap.projects) ? state.bootstrap.projects : []);
   tfWireShell();
   tfPopulateAccountMenu(); // #533: show the real account identity, not "SM"
   // Seed a project from the loaded folder so the workspace reuses the existing
   // conversation machinery for that real project path.
   const currentProject = tfEnsureCurrentProject();
   if (currentProject && !tf.assignments[currentProject.id]) tf.assignments[currentProject.id] = [];
-  if (currentProject) {
-    tf.activeProjectId = currentProject.id;
-    tfPersistProjects();
-  } else if (tf.projects.length && !tf.activeProjectId) {
-    tf.activeProjectId = tf.projects[0].id;
-  }
+  if (currentProject) {
+    tf.activeProjectId = currentProject.id;
+  } else if (tf.projects.length && !tf.activeProjectId) {
+    tf.activeProjectId = tf.projects[0].id;
+  }
   tfRenderProjectTabs();
   tfShowArea('projects');
   // Issue #578: wire deployment modal buttons.
@@ -10974,12 +10966,11 @@ function tfInitShell() {
 }
 
 // Refresh shell-derived UI after a bootstrap reload (e.g. project picked).
-function tfRefreshAfterBootstrap() {
-  if (!tf.enabled) return;
-  tfMergeProjects(state.bootstrap && Array.isArray(state.bootstrap.projects) ? state.bootstrap.projects : []);
-  tfEnsureCurrentProject();
-  tfPersistProjects();
-  tfRenderProjectTabs();
+function tfRefreshAfterBootstrap() {
+  if (!tf.enabled) return;
+  tfAdoptServerProjects(state.bootstrap && Array.isArray(state.bootstrap.projects) ? state.bootstrap.projects : []);
+  tfEnsureCurrentProject();
+  tfRenderProjectTabs();
   if (tf.area === 'company') tfRenderCompany();
   else if (tf.area === 'manager') tfRenderManager();
   else if (tf.area === 'brain') tfRenderBrain();