clay-server 4.7.0-beta.1 → 4.7.0-beta.2

package/lib/public/modules/app-home-hub.js

@@ -1,5 +1,6 @@
 // app-home-hub.js - Home work hub navigation and first-depth Mate list.
 
+import { showProjectsHub, hideProjectsHub } from './projects-hub.js';
 import { store } from './store.js';
 import { getWs } from './ws-ref.js';
 import { getCachedProjects, switchProject } from './app-projects.js';
@@ -42,7 +43,7 @@ function syncHomePresentation() {
 function syncHomeCloseControl() {
   var close = document.getElementById("home-close-control");
   if (!close) return;
-  close.classList.toggle("hidden", !getHomeReturnSlug());
+  close.classList.remove("hidden");
 }
 
 function getHomeReturnSlug() {
@@ -245,7 +246,8 @@ export function initHomeHub() {
   initHomeDock();
   initHomeDebatesArchive();
   document.getElementById("home-mate-list").addEventListener("keydown", handleMateListKeydown);
-  document.getElementById("home-close-control").addEventListener("click", minimizeHomeHub);
+  document.getElementById("home-close-control").addEventListener("click", function () { showProjectsHub(); });
+  document.getElementById("home-nav-projects").addEventListener("click", function () { showProjectsHub(); });
   window.addEventListener("clay:home-debate", function () { hideHomeHub(); });
   document.addEventListener("visibilitychange", syncHomePresentation);
 
@@ -349,6 +351,8 @@ export function updateHomeIconBadge() {
 }
 
 export function showHomeHub(fromHistory) {
+  hideProjectsHub();
+  store.set({ pendingHomeProjectSlug: null });
   if (store.get('dmMode')) exitDmMode();
   var activeMateId = store.get('homeChatMateId');
   var resume = homeHubSuspended || homeHubVisible;
@@ -399,7 +403,8 @@ export function hideHomeHub() {
 
 export function minimizeHomeHub() {
   var slug = getHomeReturnSlug();
-  if (!slug || !homeHubVisible) return;
+  if (!homeHubVisible) return;
+  if (!slug) { showProjectsHub(); return; }
   switchProject(slug);
   var projectInput = document.getElementById("input");
   if (projectInput && !projectInput.disabled) projectInput.focus({ preventScroll: true });

package/lib/public/modules/app-messages.js

@@ -69,8 +69,6 @@ import { clearPairResultStatus, handlePairResultStatus } from './pair-result-sta
 import { scrollToBottom, addToMessages, addUserMessage, addSystemMessage, removeMatePreThinking, appendDelta, finalizeAssistantBlock, addConflictMessage, addContextOverflowMessage, showSuggestionChips, armStickyBottom, VENDOR_AVATARS, VENDOR_NAMES } from './app-rendering.js';
 import { setActivity, startUrgentBlink, stopUrgentBlink, blinkSessionDot, updateCrossProjectBlink } from './app-favicon.js';
 import { setStatus } from './app-connection.js';
-import { handleWhatsNewState, handleWhatsNewSeenResult, setKnownEntries as setWhatsNewKnownEntries } from './whats-new.js';
-import { closeArticle as closeWhatsNewArticle } from './whats-new-article.js';
 import { resolvePaneSession, resolveSwitchedVendor } from './pane-session.js';
 import { markProjectSessionListHydrated, applyProjectSplitGroups, clearProjectSplitState } from './split-session-boundary.js';
 import { selectDefaultVendorForBlankSession } from './vendor-selection.js';
@@ -837,7 +835,6 @@ export function processMessage(msg) {
       case "session_switched":
         clearPairResultStatus();
         syncAutonomousRunForSession(msg.autonomousRun || null);
-        closeWhatsNewArticle();
         // Save draft from outgoing session
         var _prevSid = store.get('activeSessionId');
         if (_prevSid && inputEl.value) {
@@ -2127,18 +2124,6 @@ export function processMessage(msg) {
         handleAutoContinueChanged(msg);
         break;
 
-      case "whats_new_state":
-        // Keep a known-entries cache for the home page feed (which shows
-        // both seen and unseen entries), then queue unseen ones for the
-        // carousel.
-        if (msg && Array.isArray(msg.entries)) setWhatsNewKnownEntries(msg.entries);
-        handleWhatsNewState(msg);
-        break;
-
-      case "whats_new_seen_result":
-        handleWhatsNewSeenResult(msg);
-        break;
-
       case "set_claude_open_mode_result":
       case "claude_open_mode_changed":
         if (msg.claudeOpenMode === "tui" || msg.claudeOpenMode === "gui") {

package/lib/public/modules/app-projects.js

@@ -1,6 +1,7 @@
 // app-projects.js - Project list, switching, add/remove project modals
 // Extracted from app.js (PR-29)
 
+import { showProjectsHub, hideProjectsHub, completeProjectsOnboarding } from './projects-hub.js';
 import { escapeHtml, showToast } from './utils.js';
 import { refreshIcons } from './icons.js';
 import { parseEmojis } from './markdown.js';
@@ -17,7 +18,6 @@ import { spawnDustParticles } from './sidebar.js';
 import { isSearchOpen, closeSearch } from './session-search.js';
 import { exitDmMode } from './app-dm.js';
 import { isHomeHubVisible, hideHomeHub, showHomeHub } from './app-home-hub.js';
-import { closeArticle as closeWhatsNewArticle } from './whats-new-article.js';
 import { resetFileBrowser } from './filebrowser.js';
 import { closeNotesBrowser } from './sticky-notes-browser.js';
 import { hideMemory } from './mate-memory.js';
@@ -203,7 +203,7 @@ export function initProjects() {
 // --- State accessors ---
 
 export function getCachedProjects() { return cachedProjects; }
-export function setCachedProjects(v) { cachedProjects = v; }
+export function setCachedProjects(v) { cachedProjects = v; store.set({ projectsHubList: v, projectListLoaded: true }); }
 export function getCachedProjectCount() { return cachedProjectCount; }
 export function setCachedProjectCount(v) { cachedProjectCount = v; }
 export function getCachedRemovedProjects() { return cachedRemovedProjects; }
@@ -223,6 +223,7 @@ export function updateProjectList(msg) {
       _lastProjectsJson = projectsJson;
     }
     cachedProjects = msg.projects;
+    store.set({ projectsHubList: cachedProjects, projectListLoaded: true });
   }
   if (msg.removedProjects) cachedRemovedProjects = msg.removedProjects;
   else if (msg.removedProjects === undefined) { /* keep cached */ }
@@ -424,15 +425,16 @@ export function switchProject(slug) {
   var st = store.snap();
   var ws = getWs();
   var targetWsPath = projectWsPath(slug);
-  var homeVisible = isHomeHubVisible();
+  var homeVisible = isHomeHubVisible() || store.get('projectsHubVisible');
   var alreadyInProject = isProjectActivated(st, slug, ws);
   var wasDm = st.dmMode;
   var wasMate = st.dmMode && st.dmTargetUser && st.dmTargetUser.isMate;
   if (st.dmMode) exitDmMode(wasMate);
-  closeWhatsNewArticle();
   if (homeVisible && alreadyInProject) {
     rememberHomePrimarySurface("project", slug);
     hideHomeHub();
+    hideProjectsHub();
+    completeProjectsOnboarding();
     if (document.documentElement.classList.contains("pwa-standalone")) {
       history.replaceState(null, "", "/p/" + slug + "/");
     } else {
@@ -473,6 +475,8 @@ export function completePendingProjectActivation() {
   var slug = store.get('pendingHomeProjectSlug');
   if (!slug || !isProjectActivated(store.snap(), slug, getWs())) return false;
   store.set({ pendingHomeProjectSlug: null });
+  hideProjectsHub();
+  completeProjectsOnboarding();
   rememberHomePrimarySurface("project", slug);
   if (document.documentElement.classList.contains("pwa-standalone")) {
     history.replaceState(null, "", "/p/" + slug + "/");
@@ -492,7 +496,7 @@ export function confirmCurrentProjectSessionActivation() {
 export function finishProjectSessionActivation() {
   var confirmed = confirmCurrentProjectSessionActivation();
   if (!confirmed) return false;
-  if (!store.get('pendingHomeProjectSlug')) return true;
+  if (!store.get('pendingHomeProjectSlug')) return !isHomeHubVisible() && !store.get('projectsHubVisible');
   return completePendingProjectActivation();
 }
 
@@ -639,7 +643,7 @@ export function handleRemoveProjectResult(msg) {
           });
         }
       }
-      cachedProjects = cachedProjects.filter(function (p) { return p.slug !== msg.slug; });
+      setCachedProjects(cachedProjects.filter(function (p) { return p.slug !== msg.slug; }));
       cachedProjectCount = cachedProjects.length;
       store.set({ currentSlug: null });
       renderProjectList();
@@ -648,7 +652,9 @@ export function handleRemoveProjectResult(msg) {
       if (targetSlug) {
         switchProject(targetSlug);
       } else {
-        showHomeHub();
+        store.set({ wsPath: "/ws", basePath: "/", activeProjectSlug: null });
+        showProjectsHub();
+        connect();
       }
     } else {
       showToast(msg.slug.indexOf("--") !== -1 ? "Worktree removed" : "Project removed", "success");
@@ -698,7 +704,7 @@ function switchAddProjectMode(mode) {
   }, 50);
 }
 
-export function openAddProjectModal() {
+export function openAddProjectModal(mode) {
   addProjectModal.classList.remove("hidden");
   addProjectCreateInput.value = "";
   addProjectCloneInput.value = "";
@@ -738,6 +744,7 @@ export function openAddProjectModal() {
     existingBtn.disabled = false;
     switchAddProjectMode("existing");
   }
+  if (mode === "create" || mode === "clone") switchAddProjectMode(mode);
   renderRemovedProjectsList();
 }
 
@@ -855,10 +862,8 @@ export function handleAddProjectResult(msg) {
     } else {
       var toastMsg = addProjectMode === "create" ? "Project created" : addProjectMode === "clone" ? "Project cloned" : "Project added";
       showToast(toastMsg, "success");
-      if (msg.slug) {
-        switchProject(msg.slug);
-      }
     }
+    if (msg.slug) switchProject(msg.slug);
   } else {
     addProjectError.textContent = msg.error || "Failed to add project";
     addProjectError.classList.remove("hidden");

package/lib/public/modules/home-surface-boot.js

@@ -12,13 +12,18 @@ function explicitProjectPath(pathname) {
 export function resolveHomeBootDestination(options) {
   if (!options) return "wait";
   if (options.paneMode || explicitProjectPath(options.pathname)) return "project";
+  if (/^\/projects\/?$/.test(options.pathname || "")) return "projects";
   // The server-selected project embedded in the root shell is authoritative.
   // Home is entered only through an explicit in-app action; reloading `/`
   // returns to the project workspace even if Home was the last open surface.
   if (options.currentSlug) return "project";
   if (options.surfaceLoaded !== true) return "wait";
-  if (options.dockLoaded !== true) return "wait";
-  return "home";
+  if (options.projectsLoaded !== true) return "wait";
+  if (options.surface === "home") {
+    if (options.dockLoaded !== true) return "wait";
+    return "home";
+  }
+  return "projects";
 }
 
 function finishPendingShell() {
@@ -35,6 +40,7 @@ function settleBoot(state) {
   if (resolved) return;
   var destination = resolveHomeBootDestination({
     surfaceLoaded: state.homeSurfaceLoaded,
+    projectsLoaded: state.projectListLoaded,
     dockLoaded: state.homeDockPreferenceLoaded,
     surface: state.homePrimarySurface,
     currentSlug: state.currentSlug,
@@ -55,7 +61,8 @@ function settleBoot(state) {
     if (input && !input.disabled) input.focus({ preventScroll: true });
     return;
   }
-  store.set({ homeSurfaceBootResolved: true, homeSurfaceRestoreRequested: true });
+  if (destination === "projects") store.set({ homeSurfaceBootResolved: true, projectsHubRestoreRequested: true });
+  else store.set({ homeSurfaceBootResolved: true, homeSurfaceRestoreRequested: true });
   finishPendingShell();
 }
 

package/lib/public/modules/home-surface.js

@@ -21,7 +21,7 @@ function normalizeSessions(value) {
 }
 
 function normalizePrimarySurface(value) {
-  return value === "home" || value === "project" ? value : null;
+  return value === "home" || value === "project" || value === "projects" ? value : null;
 }
 
 function normalizeProjectSlug(value) {
@@ -51,6 +51,7 @@ export function updateHomeSurfacePreference(patch) {
     matesCollapsed: state.homeMatesCollapsed === true,
     chatScope: normalizeChatScope(state.homeChatScope),
     subSurface: normalizeSubSurface(state.homeSubSurface),
+    onboardingStep: state.onboardingStep || "welcome",
   };
   if (patch && Object.prototype.hasOwnProperty.call(patch, "surface")) next.surface = normalizePrimarySurface(patch.surface);
   if (patch && Object.prototype.hasOwnProperty.call(patch, "projectSlug")) next.projectSlug = normalizeProjectSlug(patch.projectSlug);
@@ -60,7 +61,12 @@ export function updateHomeSurfacePreference(patch) {
   if (patch && Object.prototype.hasOwnProperty.call(patch, "matesCollapsed")) next.matesCollapsed = patch.matesCollapsed === true;
   if (patch && Object.prototype.hasOwnProperty.call(patch, "chatScope")) next.chatScope = normalizeChatScope(patch.chatScope);
   if (patch && Object.prototype.hasOwnProperty.call(patch, "subSurface")) next.subSurface = normalizeSubSurface(patch.subSurface);
+  if (patch && ["welcome", "project", "complete"].indexOf(patch.onboardingStep) !== -1) {
+    next.onboardingStep = patch.onboardingStep;
+    store.set({ onboardingIntent: patch.onboardingStep });
+  }
   store.set({
+    onboardingStep: next.onboardingStep,
     homePrimarySurface: next.surface,
     homeSurfaceProjectSlug: next.projectSlug,
     homeActiveSessionByMate: normalizeSessions(next.activeSessionByMate),
@@ -78,6 +84,7 @@ export function updateHomeSurfacePreference(patch) {
   if (patch && Object.prototype.hasOwnProperty.call(patch, "matesCollapsed")) outgoing.matesCollapsed = next.matesCollapsed;
   if (patch && Object.prototype.hasOwnProperty.call(patch, "chatScope")) outgoing.chatScope = next.chatScope;
   if (patch && Object.prototype.hasOwnProperty.call(patch, "subSurface")) outgoing.subSurface = next.subSurface;
+  if (patch && Object.prototype.hasOwnProperty.call(patch, "onboardingStep")) outgoing.onboardingStep = next.onboardingStep;
   return send({ type: "home_surface_set", preference: outgoing });
 }
 
@@ -127,7 +134,11 @@ export function handleHomeSurfaceState(msg) {
   var savedSurface = normalizePrimarySurface(preference.surface);
   var savedProject = normalizeProjectSlug(preference.projectSlug);
   var intentConfirmed = !!intent && intent === savedSurface && intendedProject === savedProject;
+  var onboardingIntent = store.get('onboardingIntent');
+  var savedStep = ["welcome", "project", "complete"].indexOf(preference.onboardingStep) !== -1 ? preference.onboardingStep : "welcome";
   var update = {
+    onboardingStep: onboardingIntent || savedStep,
+    onboardingIntent: onboardingIntent === savedStep ? null : onboardingIntent,
     homeSurfaceLoaded: true,
     homePrimarySurface: intent || savedSurface,
     homeSurfaceProjectSlug: intent ? intendedProject : savedProject,
@@ -142,5 +153,6 @@ export function handleHomeSurfaceState(msg) {
     update.homePreferredMateId = store.get('homePreferredMateId') || preference.activeMateId || store.get('homeChatMateId') || null;
   }
   store.set(update);
+  if (onboardingIntent && onboardingIntent !== savedStep) send({ type: "home_surface_set", preference: { onboardingStep: onboardingIntent } });
   if (intent && !intentConfirmed) send({ type: "home_surface_set", preference: { surface: intent, projectSlug: intendedProject } });
 }

package/lib/public/modules/projects-hub-view.js

@@ -0,0 +1,62 @@
+import { escapeHtml } from './utils.js';
+import { iconHtml } from './icons.js';
+
+export function ordinaryProjects(projects) {
+  return (Array.isArray(projects) ? projects : []).filter(function (project) {
+    return project && !project.isMate && project.slug;
+  });
+}
+
+function button(action, label, extra) {
+  return '<button type="button" class="projects-button ' + (extra || '') + '" data-projects-action="' + action + '">' + label + '</button>';
+}
+
+function setupAction(mode, icon, title, text, disabled) {
+  return '<button type="button" class="projects-setup-action" data-projects-mode="' + mode + '"' + (disabled ? ' disabled' : '') + '>' +
+    '<span class="projects-action-icon">' + iconHtml(icon) + '</span><span><strong>' + title + '</strong><span>' + text + '</span></span>' + iconHtml('arrow-up-right') + '</button>';
+}
+
+export function projectsHubContent(state) {
+  var projects = ordinaryProjects(state.projectsHubList);
+  var ready = state.projectListLoaded && state.homeSurfaceLoaded;
+  var welcome = ready && (state.projectsShowGuide || (!projects.length && (state.onboardingStep || 'welcome') === 'welcome'));
+  var allowed = state.projectsAccessLoaded && (!state.permissions || state.permissions.createProject === true);
+  var available = allowed && state.connected && !state.pendingHomeProjectSlug;
+  var html = '<header class="projects-header"><a class="projects-brand" href="/" data-projects-action="home"><img src="/clay-studio-symbol.png" alt="">Clay Studio</a>' +
+    '<nav aria-label="Workspace navigation">' + button('home', 'Home', 'projects-button-quiet') + button('settings', 'Settings', 'projects-button-quiet') + '</nav></header>';
+  html += '<main class="projects-main" aria-labelledby="projects-title">';
+  if (!ready) return html + '<div class="projects-loading" role="status"><h1 id="projects-title" tabindex="-1">Your projects</h1><p>Loading your workspace…</p></div></main>';
+  if (welcome) {
+    return html + '<section class="projects-welcome"><div class="projects-eyebrow">WELCOME TO CLAY</div>' +
+      '<h1 id="projects-title" tabindex="-1">A place for<br>your next idea.</h1>' +
+      '<p class="projects-lead">Bring a project. Describe what you want to build.<br>Your AI Driver helps you take it from there.</p>' +
+      '<div class="projects-intro-grid"><div><span>01 / PROJECTS</span><h2>Work on something real.</h2><p>Open a folder, start fresh, or clone a repository. Your conversations and tools stay with the project.</p></div>' +
+      '<div><span>02 / HOME</span><h2>Make room to think.</h2><p>Talk with Clay and your Mates, explore ideas, and return to your projects whenever you’re ready.</p></div></div>' +
+      '<div class="projects-welcome-actions">' + button('start', projects.length ? 'Explore your projects ' + iconHtml('arrow-right') : 'Set up your first project ' + iconHtml('arrow-right'), 'projects-button-primary') +
+      button('skip', 'Explore Home first', 'projects-button-quiet') + '</div>' +
+      '<p class="projects-footnote">You can revisit this guide from Projects at any time.</p></section></main>';
+  }
+  html += '<div class="projects-heading"><div><div class="projects-eyebrow">YOUR WORKSPACE</div><h1 id="projects-title" tabindex="-1">' + (projects.length ? 'Projects' : 'Start with a project.') + '</h1>' +
+    '<p class="projects-lead">' + (projects.length ? 'Pick up where you left off, or begin something new.' : 'Choose where your work will live. You can add more projects later.') + '</p></div>' + button('guide', 'Getting started', 'projects-button-quiet') + '</div>';
+  if (state.pendingHomeProjectSlug) html += '<p class="projects-status" role="status">Opening your project…</p>';
+  if (projects.length) {
+    html += '<div class="projects-list" aria-label="Your projects">';
+    projects.forEach(function (project) {
+      html += '<button type="button" class="projects-list-item" data-project-slug="' + escapeHtml(project.slug) + '"' + (!state.connected || state.pendingHomeProjectSlug ? ' disabled' : '') + '>' +
+        '<span class="projects-action-icon">' + iconHtml(project.isWorktree ? 'git-branch' : 'folder') + '</span><span><strong>' + escapeHtml(project.title || project.project || project.slug) + '</strong>' +
+        '<span>' + escapeHtml(project.branch || project.path || project.slug) + '</span></span>' + iconHtml('arrow-right') + '</button>';
+    });
+    html += '</div><h2 class="projects-section-title">Add a project</h2>';
+  }
+  if (!state.projectsAccessLoaded) html += '<p class="projects-status" role="status">Checking project access…</p>';
+  else if (!allowed) html += '<p class="projects-status">Ask an administrator to create or share a project with you.</p>';
+  else {
+    html += '<div class="projects-setup-actions">' +
+      setupAction('existing', 'folder-open', 'Open a folder', 'Use a directory on the machine running Clay.', !available) +
+      setupAction('create', 'plus', 'Create a project', 'Start in a new, empty project directory.', !available) +
+      setupAction('clone', 'git-branch', 'Clone a repository', 'Bring an existing Git repository into Clay.', !available) + '</div>';
+    if (!projects.length) html += '<p class="projects-next-step"><span>UP NEXT</span> Choose your AI in the workspace, then tell your Driver what you want to build or fix.</p>';
+  }
+  if (!state.connected) html += '<p class="projects-status" role="status">Reconnecting… Project actions will be available when the connection returns.</p>';
+  return html + '</main><footer class="projects-footer">Your projects, conversations, and tools. One workspace.</footer>';
+}

package/lib/public/modules/projects-hub.js

@@ -0,0 +1,105 @@
+import { store } from './store.js';
+import { getWs } from './ws-ref.js';
+import { hideHomeHub, showHomeHub } from './app-home-hub.js';
+import { openAddProjectModal, switchProject } from './app-projects.js';
+import { openUserSettings } from './user-settings.js';
+import { rememberHomePrimarySurface, updateHomeSurfacePreference } from './home-surface.js';
+import { projectsHubContent } from './projects-hub-view.js';
+import { refreshIcons } from './icons.js';
+
+function root() { return document.getElementById('projects-hub'); }
+
+function render() {
+  var element = root();
+  if (!element || !store.get('projectsHubVisible')) return;
+  var html = projectsHubContent(store.snap());
+  if (store.get('projectsHubMarkup') === html) return;
+  store.set({ projectsHubMarkup: html });
+  var active = element.contains(document.activeElement) ? document.activeElement : null;
+  var action = active && (active.dataset.projectsAction || active.dataset.projectsMode || active.dataset.projectSlug);
+  element.innerHTML = html;
+  refreshIcons();
+  if (action) {
+    var buttons = element.querySelectorAll('button, a');
+    for (var i = 0; i < buttons.length; i++) {
+      if ((buttons[i].dataset.projectsAction || buttons[i].dataset.projectsMode || buttons[i].dataset.projectSlug) === action && !buttons[i].disabled) {
+        buttons[i].focus({ preventScroll: true });
+        break;
+      }
+    }
+  }
+}
+
+function focusHeading() {
+  if (root()) root().scrollTop = 0;
+  var title = document.getElementById('projects-title');
+  if (title) title.focus({ preventScroll: true });
+}
+
+export function showProjectsHub(fromHistory) {
+  hideHomeHub();
+  store.set({ projectsHubVisible: true, pendingHomeProjectSlug: null });
+  document.body.classList.add('projects-active');
+  root().classList.remove('hidden');
+  rememberHomePrimarySurface('projects');
+  if (!fromHistory && location.pathname !== '/projects') {
+    var method = document.documentElement.classList.contains('pwa-standalone') ? 'replaceState' : 'pushState';
+    history[method](null, '', '/projects');
+  }
+  render();
+  focusHeading();
+}
+
+export function hideProjectsHub() {
+  if (!store.get('projectsHubVisible')) return;
+  store.set({ projectsHubVisible: false, projectsShowGuide: false });
+  document.body.classList.remove('projects-active');
+  if (root()) root().classList.add('hidden');
+}
+
+export function completeProjectsOnboarding() {
+  if (store.get('onboardingStep') !== 'project') return;
+  updateHomeSurfacePreference({ onboardingStep: 'complete' });
+}
+
+function handleClick(event) {
+  var button = event.target.closest('[data-projects-action], [data-projects-mode], [data-project-slug]');
+  if (!button || button.disabled) return;
+  event.preventDefault();
+  var action = button.dataset.projectsAction;
+  if (action === 'home') { showHomeHub(); return; }
+  if (action === 'settings') { openUserSettings(); return; }
+  if (action === 'guide') { store.set({ projectsShowGuide: true }); render(); focusHeading(); return; }
+  if (action === 'start' || action === 'skip') {
+    store.set({ projectsShowGuide: false });
+    updateHomeSurfacePreference({ onboardingStep: 'project' });
+    if (action === 'skip') showHomeHub();
+    else { render(); focusHeading(); }
+    return;
+  }
+  var ws = getWs();
+  if (!ws || ws.readyState !== 1) return;
+  if (button.dataset.projectSlug) { switchProject(button.dataset.projectSlug); return; }
+  if (button.dataset.projectsMode) {
+    var permissions = store.get('permissions');
+    if (!store.get('projectsAccessLoaded') || (permissions && permissions.createProject !== true)) return;
+    openAddProjectModal(button.dataset.projectsMode);
+  }
+}
+
+export function initProjectsHub() {
+  root().addEventListener('click', handleClick);
+  store.subscribe(function (state, previous) {
+    if (state.projectsHubRestoreRequested && !previous.projectsHubRestoreRequested) {
+      showProjectsHub(true);
+      if (location.pathname === '/') history.replaceState(null, '', '/projects');
+      store.set({ projectsHubRestoreRequested: false });
+      return;
+    }
+    if (!state.projectsHubVisible) return;
+    if (state.projectsHubList !== previous.projectsHubList || state.projectListLoaded !== previous.projectListLoaded ||
+        state.homeSurfaceLoaded !== previous.homeSurfaceLoaded || state.onboardingStep !== previous.onboardingStep ||
+        state.projectsAccessLoaded !== previous.projectsAccessLoaded || state.permissions !== previous.permissions ||
+        state.connected !== previous.connected || state.pendingHomeProjectSlug !== previous.pendingHomeProjectSlug) render();
+  });
+}

package/lib/public/style.css

@@ -57,3 +57,5 @@
 @import url("css/tui-attention.css?v=20260829-terminal-canvas1");
 @import url("css/pwa-mobile.css?v=20260824f");
 @import url("css/avatar-imprints.css?v=20260829-imprints1");
+
+@import url("css/projects-hub.css");

package/lib/server.js

@@ -814,7 +814,7 @@ function createServer(opts) {
 
     // Root path — render the default project workspace while keeping Home
     // available as an explicit client-side surface.
-    if (fullUrl === "/" && req.method === "GET") {
+    if ((fullUrl === "/" || fullUrl === "/projects" || fullUrl === "/projects/") && req.method === "GET") {
       if (!isRequestAuthed(req)) {
         res.writeHead(200, { "Content-Type": "text/html; charset=utf-8" });
         res.end(auth.getAuthPage());

package/lib/users-home-surface-preferences.js

@@ -31,8 +31,8 @@ function attachHomeSurfacePreferences(deps) {
       if (!validId(mateIds[i]) || !validSessionReference(sessions[mateIds[i]])) continue;
       normalizedSessions[mateIds[i]] = sessions[mateIds[i]];
     }
-    return {
-      surface: source.surface === "home" || source.surface === "project" ? source.surface : null,
+    var result = {
+      surface: source.surface === "home" || source.surface === "project" || source.surface === "projects" ? source.surface : null,
       projectSlug: validProjectSlug(source.projectSlug) ? source.projectSlug : null,
       activeMateId: validId(source.activeMateId) ? source.activeMateId : null,
       activeSessionByMate: normalizedSessions,
@@ -41,6 +41,8 @@ function attachHomeSurfacePreferences(deps) {
       chatScope: source.chatScope === "current" ? "current" : "all",
       subSurface: source.subSurface === "debates" ? "debates" : "chat",
     };
+    if (["welcome", "project", "complete"].indexOf(source.onboardingStep) !== -1) result.onboardingStep = source.onboardingStep;
+    return result;
   }
 
   function loadSingleUserPreference() {

package/lib/users-preferences.js

@@ -484,40 +484,6 @@ function attachPreferences(deps) {
     return { error: "User not found" };
   }
 
-  // --- What's New seen ids ---
-  //
-  // Per-user list of dismissed "What's New" entry ids. The whats-new
-  // service uses this to filter unseen entries on connect. Ids are stable
-  // strings authored in lib/whats-new-content.js.
-
-  function getWhatsNewSeenIds(userId) {
-    var data = loadUsers();
-    for (var i = 0; i < data.users.length; i++) {
-      if (data.users[i].id === userId) {
-        var ids = data.users[i].whatsNewSeenIds;
-        return Array.isArray(ids) ? ids.slice() : [];
-      }
-    }
-    return [];
-  }
-
-  function markWhatsNewSeen(userId, entryId) {
-    if (!entryId || typeof entryId !== "string") return { error: "bad_id" };
-    var data = loadUsers();
-    for (var i = 0; i < data.users.length; i++) {
-      if (data.users[i].id === userId) {
-        var ids = Array.isArray(data.users[i].whatsNewSeenIds) ? data.users[i].whatsNewSeenIds.slice() : [];
-        if (ids.indexOf(entryId) === -1) {
-          ids.push(entryId);
-          data.users[i].whatsNewSeenIds = ids;
-          saveUsers(data);
-        }
-        return { ok: true, seenIds: ids };
-      }
-    }
-    return { error: "User not found" };
-  }
-
   // --- Mate onboarding ---
 
   function setMateOnboarded(userId) {
@@ -556,8 +522,6 @@ function attachPreferences(deps) {
     setMatesEnabled: setMatesEnabled,
     getToolPalettes: getToolPalettes,
     setToolPalette: setToolPalette,
-    getWhatsNewSeenIds: getWhatsNewSeenIds,
-    markWhatsNewSeen: markWhatsNewSeen,
     getTerminalFont: getTerminalFont,
     setTerminalFont: setTerminalFont,
     setMateOnboarded: setMateOnboarded,

package/lib/users.js

@@ -453,8 +453,6 @@ var getMatesEnabled = preferences.getMatesEnabled;
 var setMatesEnabled = preferences.setMatesEnabled;
 var getToolPalettes = preferences.getToolPalettes;
 var setToolPalette = preferences.setToolPalette;
-var getWhatsNewSeenIds = preferences.getWhatsNewSeenIds;
-var markWhatsNewSeen = preferences.markWhatsNewSeen;
 var getTerminalFont = preferences.getTerminalFont;
 var setTerminalFont = preferences.setTerminalFont;
 var setMateOnboarded = preferences.setMateOnboarded;
@@ -541,8 +539,6 @@ module.exports = {
   setCapsulesEnabled: setCapsulesEnabled,
   getToolPalettes: getToolPalettes,
   setToolPalette: setToolPalette,
-  getWhatsNewSeenIds: getWhatsNewSeenIds,
-  markWhatsNewSeen: markWhatsNewSeen,
   getTerminalFont: getTerminalFont,
   setTerminalFont: setTerminalFont,
   getHomeDockPreference: getHomeDockPreference,

package/lib/ws-schema.js

@@ -332,9 +332,6 @@ var schema = {
   // -----------------------------------------------------------------------
   // What's New
   // -----------------------------------------------------------------------
-  "whats_new_state":          { direction: "s2c", handler: "lib/public/modules/whats-new.js", description: "Unseen What's New entries for the connecting user" },
-  "whats_new_seen":           { direction: "c2s", handler: "lib/project-sessions.js", description: "Mark a What's New entry as dismissed by the current user" },
-  "whats_new_seen_result":    { direction: "s2c", handler: "lib/public/modules/whats-new.js", description: "Result of marking a What's New entry seen" },
   "home_dock_get":            { direction: "c2s", handler: "lib/server-home-preferences.js", description: "Request the current user's home dock preference" },
   "home_dock_set":            { direction: "c2s", handler: "lib/server-home-preferences.js", description: "Persist the current user's home dock preference" },
   "home_dock_state":          { direction: "s2c", handler: "lib/public/modules/home-dock.js", description: "Current user home dock preference" },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clay-server",
-  "version": "4.7.0-beta.1",
+  "version": "4.7.0-beta.2",
   "description": "Self-hosted team workspace for Claude Code and Codex. Multi-user, browser-based, with persistent AI mates.",
   "bin": {
     "clay-server": "./bin/cli.js"