feat(workhub): add composable routing experiments and filtered anchor rail

apps/desktop/renderer-architecture.json

@@ -89,6 +89,7 @@
     "src/renderer/locales/shell-copy.ts",
     "src/renderer/locales/shell-remaining-copy.ts",
     "src/renderer/locales/task-readiness-copy.ts",
+    "src/renderer/locales/workhub-copy.ts",
     "src/renderer/main.tsx",
     "src/renderer/mcp-brand-contrast.ts",
     "src/renderer/mcp-brand-marks.tsx",
@@ -247,7 +248,6 @@
     "src/renderer/workhub-coordination-host-scope.ts",
     "src/renderer/workhub-coordination-lifecycle.ts",
     "src/renderer/workhub-coordination-port.ts",
-    "src/renderer/workhub-route-policy.ts",
     "src/renderer/workhub-send-lease.ts",
     "src/renderer/workhub-session-port.ts",
     "src/renderer/workhub-surface.tsx",
@@ -1791,6 +1791,15 @@
         "actionFactories": [],
         "dependencyPaths": {}
       },
+      "src/renderer/locales/workhub-copy.ts": {
+        "bridgePaths": {},
+        "environmentCapabilities": {},
+        "hookCalls": {},
+        "lifecycleMethods": {},
+        "unresolvedDependencies": 0,
+        "actionFactories": [],
+        "dependencyPaths": {}
+      },
       "src/renderer/mcp-brand-contrast.ts": {
         "bridgePaths": {},
         "environmentCapabilities": {},
@@ -4565,7 +4574,7 @@
         "unresolvedDependencies": 0,
         "actionFactories": [],
         "dependencyPaths": {
-          "./workhub-route-policy.js": 1
+          "./features/workhub/index.js": 1
         }
       },
       "src/renderer/workhub-coordination-host-scope.ts": {
@@ -4603,17 +4612,6 @@
           "@maka/core/session": 1
         }
       },
-      "src/renderer/workhub-route-policy.ts": {
-        "bridgePaths": {},
-        "environmentCapabilities": {},
-        "hookCalls": {},
-        "lifecycleMethods": {},
-        "unresolvedDependencies": 0,
-        "actionFactories": [],
-        "dependencyPaths": {
-          "./application/contracts/workhub-request-intent.js": 1
-        }
-      },
       "src/renderer/workhub-send-lease.ts": {
         "bridgePaths": {},
         "environmentCapabilities": {
@@ -4656,6 +4654,8 @@
         "unresolvedDependencies": 0,
         "actionFactories": [],
         "dependencyPaths": {
+          "./features/workhub/index.js": 1,
+          "./locales/workhub-copy.js": 1,
           "./workhub-coordination-port.js": 1,
           "./workhub-send-lease.js": 1,
           "@astryxdesign/core": 1,

apps/desktop/src/main/__tests__/workhub-anchor-rail.test.ts

@@ -0,0 +1,133 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+import assert from "node:assert/strict";
+import test from "node:test";
+import { createElement } from "react";
+import { renderToStaticMarkup } from "react-dom/server";
+import type { WorkHubSessionSummary } from "../../renderer/workhub-controller.js";
+import {
+  deriveWorkHubAnchors,
+  matchesWorkHubFilter,
+  MAX_WORKHUB_ANCHORS,
+  WorkHubNavigationRail,
+} from "../../renderer/features/workhub/index.js";
+import { getWorkHubRailCopy } from "../../renderer/locales/workhub-copy.js";
+
+function session(
+  sessionId: string,
+  state: WorkHubSessionSummary["state"],
+  updatedAt: number,
+  archived = false,
+): WorkHubSessionSummary {
+  return {
+    target: { sessionId },
+    projectName: "Maka",
+    sessionName: sessionId,
+    archived,
+    state,
+    updatedAt,
+  };
+}
+
+const sessions = [
+  session("recent", "active", 100),
+  session("focus", "running", 10),
+  session("delegated", "waiting_for_user", 20),
+  session("blocked", "blocked", 90),
+  session("stopped", "aborted", 80),
+  session("archived", "active", 110, true),
+];
+
+test("anchors prioritize focus and delegation before recent Session facts", () => {
+  const before = structuredClone(sessions);
+  const anchors = deriveWorkHubAnchors({
+    sessions,
+    focusSessionId: "focus",
+    delegatedSessionIds: ["delegated", "focus", "missing"],
+    filter: "all",
+  });
+  assert.deepEqual(sessions, before);
+  assert.deepEqual(anchors.map((value) => value.target.sessionId),
+    ["focus", "delegated", "archived", "recent", "blocked", "stopped"]);
+  assert.deepEqual(deriveWorkHubAnchors({ sessions, delegatedSessionIds: ["delegated"], filter: "all" })[0], sessions[2]);
+});
+
+test("filters are derived from Session state and archive facts only", () => {
+  assert.deepEqual(
+    sessions
+      .filter((value) => matchesWorkHubFilter(value, "active"))
+      .map((value) => value.target.sessionId),
+    ["recent", "focus"],
+  );
+  assert.deepEqual(
+    sessions
+      .filter((value) => matchesWorkHubFilter(value, "attention"))
+      .map((value) => value.target.sessionId),
+    ["delegated", "blocked"],
+  );
+  assert.deepEqual(
+    sessions
+      .filter((value) => matchesWorkHubFilter(value, "stopped"))
+      .map((value) => value.target.sessionId),
+    ["stopped", "archived"],
+  );
+});
+
+test("anchor projection is deduplicated and hard-bounded", () => {
+  const many = Array.from({ length: 20 }, (_, index) =>
+    session(`session-${index}`, "active", index),
+  );
+  const anchors = deriveWorkHubAnchors({
+    sessions: [...many, many[0]!, many[4]!],
+    delegatedSessionIds: [...many, many[0]!].map((value) => value.target.sessionId),
+    filter: "all",
+  });
+  assert.equal(anchors.length, MAX_WORKHUB_ANCHORS);
+  assert.equal(
+    new Set(anchors.map((value) => value.target.sessionId)).size,
+    anchors.length,
+  );
+});
+
+test("rail copy distinguishes bounded anchors from all matching work", () => {
+  const many = Array.from({ length: 20 }, (_, index) =>
+    session(`session-${index}`, "active", index),
+  );
+  const markup = renderToStaticMarkup(createElement(WorkHubNavigationRail, {
+    locale: "en",
+    sessions: many,
+    delegatedSessionIds: [],
+    copy: getWorkHubRailCopy("en"),
+    onOpenSession: () => undefined,
+  }));
+
+  assert.match(markup, /8\/20 anchors · 20 total/u);
+  assert.equal(markup.match(/<li[ >]/gu)?.length, 8);
+});
+
+
+test("focus display is derived from the selected Session ID, not delegation priority", () => {
+  const markup = renderToStaticMarkup(createElement(WorkHubNavigationRail, {
+    locale: "en", sessions, focusSessionId: "focus", delegatedSessionIds: ["delegated"],
+    copy: getWorkHubRailCopy("en"), onOpenSession: () => undefined,
+  }));
+  assert.equal(markup.match(/aria-current="page"/gu)?.length, 1);
+  assert.equal(markup.match(/Focused · Running/gu)?.length, 1);
+});