memorix 1.8.0 → 1.8.1

package/CHANGELOG.md

@@ -4,6 +4,15 @@ All notable changes to this project will be documented in this file.
 
 ## [Unreleased]
 
+## [1.8.1] - 2026-08-24
+
+### Changed
+- **Truthful coordination status** -- the persistent SQLite `TeamStore` is the
+  sole coordination truth for agents, tasks, messages, locks, handoffs, and poll
+  state. The Dashboard exposes read-only `Coordination Status` and `Task Status`
+  views, and `/api/team` reports explicit `error` or `degraded` status instead of
+  presenting a failed coordination read as a healthy empty result.
+
 ## [1.8.0] - 2026-08-23
 
 ### Added

package/dist/cli/index.js

@@ -3232,7 +3232,7 @@ ${import_picocolors.default.gray(m3)}  ${s4}
 
 // src/cli/version.ts
 function getCliVersion() {
-  return true ? "1.8.0" : pkg.version;
+  return true ? "1.8.1" : pkg.version;
 }
 var init_version = __esm({
   "src/cli/version.ts"() {
@@ -220770,6 +220770,37 @@ function normalizeDashboardTask(task) {
     preferredRole: task.preferred_role ?? task.preferredRole ?? null
   };
 }
+function emptyTeamSnapshot(mode, scope, status) {
+  return {
+    status,
+    mode,
+    readOnly: true,
+    scope,
+    agents: [],
+    activeCount: 0,
+    recentCount: 0,
+    historicalCount: 0,
+    totalAgents: 0,
+    recentWindowDays: 7,
+    locks: [],
+    tasks: [],
+    availableTasks: 0,
+    sessions: 0,
+    roles: [],
+    roleOccupancy: [],
+    handoffs: [],
+    openTasks: 0,
+    openHandoffs: 0,
+    totalUnread: 0,
+    activeSessions: 0,
+    error: status === "error" ? "Coordination state unavailable" : "Coordination state is incomplete",
+    errorCode: status === "error" ? "COORDINATION_STATE_UNAVAILABLE" : "COORDINATION_STATE_DEGRADED"
+  };
+}
+function logTeamSnapshotFailure(scope, status) {
+  const safeScope = scope === "global" ? "global" : "project";
+  console.error("[dashboard] coordination snapshot unavailable", { status, scope: safeScope });
+}
 async function buildTeamSnapshot(dataDir, projectId, scope, mode) {
   try {
     const { initTeamStore: initTeamStore2 } = await Promise.resolve().then(() => (init_team_store(), team_store_exports));
@@ -220796,8 +220827,9 @@ async function buildTeamSnapshot(dataDir, projectId, scope, mode) {
     const roleOccupancy = effectiveProjectId ? teamStore.getRoleOccupancy(effectiveProjectId) : [];
     const handoffs = effectiveProjectId ? teamStore.listHandoffs(effectiveProjectId) : [];
     return {
+      status: "ok",
       mode,
-      readOnly: mode === "standalone",
+      readOnly: true,
       scope,
       agents: withTier,
       activeCount,
@@ -220818,28 +220850,8 @@ async function buildTeamSnapshot(dataDir, projectId, scope, mode) {
       activeSessions: activeCount
     };
   } catch {
-    return {
-      mode,
-      readOnly: mode === "standalone",
-      scope,
-      agents: [],
-      activeCount: 0,
-      recentCount: 0,
-      historicalCount: 0,
-      totalAgents: 0,
-      recentWindowDays: 7,
-      locks: [],
-      tasks: [],
-      availableTasks: 0,
-      sessions: 0,
-      roles: [],
-      roleOccupancy: [],
-      handoffs: [],
-      openTasks: 0,
-      openHandoffs: 0,
-      totalUnread: 0,
-      activeSessions: 0
-    };
+    logTeamSnapshotFailure(scope, "error");
+    return emptyTeamSnapshot(mode, scope, "error");
   }
 }
 function readBody(req) {
@@ -220858,13 +220870,12 @@ function readBody(req) {
     req.on("error", reject);
   });
 }
-async function startDashboard(dataDir, port, staticDir, projectId, projectName, autoOpen = true, teamInstances, projectRoot = null, projectResolved = true) {
+async function startDashboard(dataDir, port, staticDir, projectId, projectName, autoOpen = true, projectRoot = null, projectResolved = true) {
   await initObservationStore(dataDir);
   await initSessionStore(dataDir);
   const resolvedStaticDir = staticDir;
   const baseDir = getBaseDataDir();
-  const isControlPlane = !!teamInstances;
-  const state = { projectId, projectName, dataDir, projectRoot, projectResolved, mode: isControlPlane ? "control-plane" : "standalone", port };
+  const state = { projectId, projectName, dataDir, projectRoot, projectResolved, mode: "standalone", port };
   const server = createServer(async (req, res) => {
     const url2 = req.url || "/";
     if (url2.startsWith("/api/set-current-project") && req.method === "POST") {
@@ -220886,54 +220897,20 @@ async function startDashboard(dataDir, port, staticDir, projectId, projectName,
       }
       return;
     }
-    if (url2.startsWith("/api/team")) {
-      if (!teamInstances) {
-        const parsedUrl = new URL(url2, `http://127.0.0.1:${port}`);
-        const scope = parsedUrl.searchParams.get("scope") || "project";
-        sendJson(res, await buildTeamSnapshot(state.dataDir, state.projectId, scope, state.mode));
-        return;
-      }
-      try {
-        teamInstances.fileLocks.cleanExpired();
-        const agents = teamInstances.registry.listAgents();
-        const locks = teamInstances.fileLocks.listLocks();
-        const tasks = teamInstances.taskManager.list();
-        const available = teamInstances.taskManager.getAvailable();
-        let roles = [];
-        let roleOccupancy = [];
-        let handoffs = [];
-        try {
-          const { getTeamStore: getTeamStore2, isTeamStoreInitialized: isTeamStoreInitialized2 } = await Promise.resolve().then(() => (init_team_store(), team_store_exports));
-          if (isTeamStoreInitialized2()) {
-            const teamStore = getTeamStore2();
-            const projectId2 = state.projectId;
-            roles = teamStore.listRoles(projectId2);
-            roleOccupancy = teamStore.getRoleOccupancy(projectId2);
-            handoffs = teamStore.listHandoffs(projectId2);
-          }
-        } catch {
-        }
+    const parsedUrl = new URL(url2, `http://127.0.0.1:${port}`);
+    if (parsedUrl.pathname === "/api/team") {
+      if (req.method !== "GET") {
         sendJson(res, {
-          agents: agents.map((a4) => ({
-            ...a4,
-            unread: teamInstances.messageBus.getUnreadCount(a4.id)
-          })),
-          activeCount: teamInstances.registry.getActiveCount(),
-          locks,
-          tasks,
-          availableTasks: available.length,
-          roles,
-          roleOccupancy,
-          handoffs,
-          // Resume data for "Continue this project" area
-          openTasks: tasks.filter((t4) => t4.status === "pending" || t4.status === "in_progress").length,
-          openHandoffs: handoffs.filter((h5) => h5.handoff_status === "open" || h5.handoffStatus === "open").length,
-          totalUnread: agents.reduce((sum, a4) => sum + teamInstances.messageBus.getUnreadCount(a4.id), 0),
-          activeSessions: agents.filter((a4) => a4.status === "active").length
-        });
-      } catch {
-        sendJson(res, { agents: [], activeCount: 0, locks: [], tasks: [], availableTasks: 0, roles: [], roleOccupancy: [], handoffs: [] });
+          status: "error",
+          readOnly: true,
+          error: "Coordination status is read-only",
+          errorCode: "COORDINATION_STATUS_READ_ONLY"
+        }, 405);
+        return;
       }
+      const scope = parsedUrl.searchParams.get("scope") || "project";
+      const snapshot = await buildTeamSnapshot(state.dataDir, state.projectId, scope, state.mode);
+      sendJson(res, snapshot, snapshot.status === "error" ? 503 : 200);
       return;
     }
     if (url2.startsWith("/api/")) {
@@ -220954,13 +220931,12 @@ async function startDashboard(dataDir, port, staticDir, projectId, projectName,
     server.listen(port, "127.0.0.1", () => {
       const url2 = `http://127.0.0.1:${port}`;
       const resolvedLabel = projectResolved ? "resolved" : "unresolved";
-      const modeLabel = isControlPlane ? "Control Plane" : "Standalone";
+      const modeLabel = "Standalone";
       console.error(`  Memorix Dashboard [${modeLabel}]`);
       console.error(`  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500`);
       console.error(`  Mode:     ${modeLabel}`);
       console.error(`  Project:  ${projectName} (${projectId}) [${resolvedLabel}]`);
       console.error(`  Local:    ${url2}`);
-      if (isControlPlane) console.error(`  MCP:      ${url2}/mcp`);
       console.error(`  Data dir: ${dataDir}`);
       console.error(`
   Press Ctrl+C to stop
@@ -261396,7 +261372,7 @@ The path should point to a directory containing a .git folder.`
   };
   const server = existingServer ?? new McpServer({
     name: "memorix",
-    version: true ? "1.8.0" : "1.0.1"
+    version: true ? "1.8.1" : "1.0.1"
   });
   const originalRegisterTool = server.registerTool.bind(server);
   server.registerTool = ((name, ...args) => {
@@ -264549,7 +264525,7 @@ ${json4}
           }
         }
         console.error(`[memorix] Dashboard staticDir: ${staticDir}`);
-        startDashboard2(projectDir2, portNum, staticDir, project.id, project.name, false, void 0, project.rootPath, projectResolved).then(() => {
+        startDashboard2(projectDir2, portNum, staticDir, project.id, project.name, false, project.rootPath, projectResolved).then(() => {
           dashboardRunning = true;
         }).catch((err) => {
           console.error("[memorix] Dashboard error:", err);
@@ -264891,7 +264867,7 @@ ${lines.join("\n")}` }] };
   server.registerTool(
     "team_task",
     {
-      title: "Task Board",
+      title: "Task Status",
       description: 'Create, claim, complete, or list tasks in the team task board. Supports dependencies. Action "create": create a task. Action "claim": assign to yourself (atomic, race-safe). Action "complete": mark done with result. Action "list": show tasks.',
       inputSchema: {
         action: external_exports2.enum(["create", "claim", "complete", "list"]).describe("Operation to perform"),
@@ -269160,6 +269136,15 @@ var init_serve_http = __esm({
               return;
             }
             if (apiPath === "/team") {
+              if (req.method !== "GET") {
+                sendJson2({
+                  status: "error",
+                  readOnly: true,
+                  error: "Coordination status is read-only",
+                  errorCode: "COORDINATION_STATUS_READ_ONLY"
+                }, 405);
+                return;
+              }
               const { projectId: teamProjectId, dataDir: teamDataDir } = await resolveRequestProject(url2);
               const ts2 = await getTeamStore2(teamDataDir);
               const scope = url2.searchParams.get("scope") || "project";
@@ -269224,8 +269209,9 @@ var init_serve_http = __esm({
               const handoffs = effectiveTeamProjectId ? ts2.listHandoffs(effectiveTeamProjectId) : [];
               const openHandoffs = handoffs.filter((handoff) => handoff.status !== "completed").length;
               sendJson2({
+                status: "ok",
                 mode: "control-plane",
-                readOnly: false,
+                readOnly: true,
                 scope,
                 agents: withTier,
                 // Primary headline number
@@ -269798,6 +269784,23 @@ var init_serve_http = __esm({
             }
             sendJson2({ error: "Not found" }, 404);
           } catch (err) {
+            if (apiPath === "/team") {
+              const scope = url2.searchParams.get("scope") === "global" ? "global" : "project";
+              console.error("[memorix] coordination snapshot unavailable", { status: "error", scope });
+              sendJson2({
+                status: "error",
+                mode: "control-plane",
+                readOnly: true,
+                scope,
+                agents: [],
+                locks: [],
+                tasks: [],
+                handoffs: [],
+                error: "Coordination state unavailable",
+                errorCode: "COORDINATION_STATE_UNAVAILABLE"
+              }, 503);
+              return;
+            }
             sendJson2({ error: err instanceof Error ? err.message : "Unknown error" }, 500);
           }
         }
@@ -276684,7 +276687,7 @@ var init_dashboard = __esm({
         }
         const cliDir = path45.dirname(fileURLToPath9(import.meta.url));
         const staticDir = path45.join(cliDir, "..", "dashboard", "static");
-        await startDashboard2(dataDir, port, staticDir, project.id, project.name, true, void 0, project.rootPath, true);
+        await startDashboard2(dataDir, port, staticDir, project.id, project.name, true, project.rootPath, true);
         await new Promise(() => {
         });
       }

package/dist/dashboard/static/app.js

@@ -142,17 +142,21 @@ const i18n = {
     noRetentionDesc: 'Store observations to see memory retention scores',
 
     // Team -> Coordination
-    teamTitle: 'Coordination',
-    teamSubtitle: 'Coordinated agents, tasks, locks, and handoffs',
-    teamNoData: 'No coordination workflow activity yet',
-    teamNoDataHint: 'Use the CLI orchestrator or inspect coordination state.',
+    teamTitle: 'Coordination Status',
+    teamSubtitle: 'Read-only project coordination status',
+    teamNoData: 'No coordination status is available',
+    teamNoDataHint: 'Coordination state is read-only and comes from the project SQLite store.',
+    teamStatusError: 'Coordination status unavailable',
+    teamStatusDegraded: 'Coordination status degraded',
+    teamStatusErrorDesc: 'The persistent coordination state could not be read. This view has no write actions.',
+    teamStatusDegradedDesc: 'Some persistent coordination state could not be read. Values may be incomplete.',
     teamActiveAgents: 'Active Agents',
     teamLockedFiles: 'Locked Files',
     teamTasks: 'Tasks',
     teamAvailable: 'Available',
     teamAgents: 'Agents',
     teamLocks: 'File Locks',
-    teamTaskBoard: 'Task Board',
+    teamTaskStatus: 'Task Status',
     // Resume area
     resumeTitle: 'Continue This Project',
     resumeDesc: 'What needs attention right now',
@@ -282,7 +286,7 @@ const i18n = {
     projectUnresolved: 'Unresolved',
     projectUnresolvedDesc: 'No project bound — select a project from the switcher',
     projectResolved: 'Resolved',
-    projectScopeProject: 'Project Coordination',
+    projectScopeProject: 'Project Coordination Status',
     projectScopeGlobal: 'All Projects',
     projectScopeProjectDesc: 'Agents and tasks coordinated for this project',
     projectScopeGlobalDesc: 'Agents and tasks coordinated across projects',
@@ -469,8 +473,8 @@ const i18n = {
     // Mode banner
     modeStandalone: 'Standalone',
     modeControlPlane: 'Control Plane',
-    modeStandaloneHint: 'Standalone dashboard - memory and read-only coordination state',
-    modeControlPlaneHint: 'HTTP control plane - shared MCP access and live dashboard',
+    modeStandaloneHint: 'Standalone dashboard - memory and read-only coordination status',
+    modeControlPlaneHint: 'HTTP control plane - shared MCP access and read-only coordination status',
     modeBannerProject: 'Project',
     modeBannerMcp: 'MCP',
 
@@ -621,17 +625,21 @@ const i18n = {
     noRetentionDesc: '存储观察记录以查看记忆衰减分数',
 
     // Team -> 编排协作
-    teamTitle: '编排协作',
-    teamSubtitle: 'agents、任务、文件锁和交接状态',
-    teamNoData: '暂无编排协作活动',
-    teamNoDataHint: '使用 CLI 编排任务，或查看协调状态。',
+    teamTitle: '协作状态',
+    teamSubtitle: '只读项目协作状态',
+    teamNoData: '暂无可用的协作状态',
+    teamNoDataHint: '协作状态为只读，并来自项目 SQLite 存储。',
+    teamStatusError: '协作状态不可用',
+    teamStatusDegraded: '协作状态已降级',
+    teamStatusErrorDesc: '无法读取持久协作状态。此视图不提供写入操作。',
+    teamStatusDegradedDesc: '部分持久协作状态无法读取，当前数据可能不完整。',
     teamActiveAgents: '活跃 Agent',
     teamLockedFiles: '锁定文件',
     teamTasks: '任务',
     teamAvailable: '可领取',
     teamAgents: 'Agent',
     teamLocks: '文件锁',
-    teamTaskBoard: '任务看板',
+    teamTaskStatus: '任务状态',
     // Resume area
     resumeTitle: '继续这个项目',
     resumeDesc: '当前需要关注的事项',
@@ -761,7 +769,7 @@ const i18n = {
     projectUnresolved: '未绑定',
     projectUnresolvedDesc: '无项目绑定 — 请从切换器选择项目',
     projectResolved: '已绑定',
-    projectScopeProject: '项目编排协作',
+    projectScopeProject: '项目协作状态',
     projectScopeGlobal: '所有项目',
     projectScopeProjectDesc: '当前项目中的 agents 和任务',
     projectScopeGlobalDesc: '所有项目中的 agents 和任务',
@@ -953,8 +961,8 @@ const i18n = {
     // Mode banner
     modeStandalone: '独立模式',
     modeControlPlane: '控制平面',
-    modeStandaloneHint: '独立看板 - 记忆与只读协调状态',
-    modeControlPlaneHint: 'HTTP 控制平面 - 共享 MCP 接入与实时看板',
+    modeStandaloneHint: '独立视图 - 记忆与只读协作状态',
+    modeControlPlaneHint: 'HTTP 控制平面 - 共享 MCP 接入与只读协作状态',
     modeBannerProject: '项目',
     modeBannerMcp: 'MCP',
 
@@ -1157,8 +1165,12 @@ async function api(endpoint) {
       ? `/api/${endpoint}${sep}project=${encodeURIComponent(selectedProject)}`
       : `/api/${endpoint}`;
     const res = await fetch(url);
-    if (!res.ok) throw new Error(`HTTP ${res.status}`);
-    return await res.json();
+    const payload = await res.json().catch(() => null);
+    if (!res.ok) {
+      if (endpoint.startsWith('team') && payload?.status) return payload;
+      throw new Error(`HTTP ${res.status}`);
+    }
+    return payload;
   } catch (err) {
     console.error(`API error (${endpoint}):`, err);
     return null;
@@ -4492,7 +4504,10 @@ async function loadTeam() {
   }
 
   const data = await api('team?scope=' + teamScope);
-  if (!data || data.unavailable) {
+  if (!data || data.unavailable || data.status === 'error' || data.status === 'degraded') {
+    const isDegraded = data?.status === 'degraded';
+    const statusTitle = isDegraded ? t('teamStatusDegraded') : (data?.status === 'error' ? t('teamStatusError') : t('teamNoData'));
+    const statusDescription = isDegraded ? t('teamStatusDegradedDesc') : (data?.status === 'error' ? t('teamStatusErrorDesc') : t('teamNoDataHint'));
     container.innerHTML = `
       <div class="page-header">
         <h1 class="page-title">${t('teamTitle')}</h1>
@@ -4501,10 +4516,9 @@ async function loadTeam() {
       <div class="panel">
         <div class="panel-body" style="text-align:center;padding:48px;">
           <div style="font-size:36px;margin-bottom:12px;"><span class="iconify" data-icon="lucide:users" style="font-size:36px;"></span></div>
-          <div style="font-size:16px;font-weight:600;color:var(--text-primary);margin-bottom:8px;">${t('teamNoData')}</div>
+          <div style="font-size:16px;font-weight:600;color:var(--text-primary);margin-bottom:8px;">${statusTitle}</div>
           <div style="font-size:13px;color:var(--text-muted);max-width:480px;margin:0 auto;line-height:1.6;">
-            ${t('teamNoDataHint')}<br>
-            <code style="background:var(--bg-surface);padding:4px 10px;border-radius:6px;margin-top:8px;display:inline-block;font-size:12px;">memorix orchestrate · memorix team status · memorix task list</code>
+            ${statusDescription}<br>
           </div>
         </div>
       </div>
@@ -4763,7 +4777,7 @@ async function loadTeam() {
 
     <div class="panel">
       <div class="panel-header">
-        <span class="panel-title">${t('teamTaskBoard')}</span>
+        <span class="panel-title">${t('teamTaskStatus')}</span>
         <span class="team-panel-count">${data.availableTasks || 0} ${t('teamAvailableToClaim')}</span>
       </div>
       <div class="panel-body">

package/dist/dashboard/static/index.html

@@ -135,7 +135,7 @@
         </svg>
         <span class="nav-label">Sessions</span>
       </button>
-      <button class="nav-btn" data-page="team" title="Coordination" aria-label="Coordination">
+      <button class="nav-btn" data-page="team" title="Coordination Status" aria-label="Coordination Status">
         <svg width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
           <path d="M17 21v-2a4 4 0 0 0-4-4H5a4 4 0 0 0-4 4v2"/>
           <circle cx="9" cy="7" r="4"/>

package/dist/index.d.ts

@@ -479,7 +479,7 @@ type ToolProfile = 'micro' | 'lite' | 'team' | 'full';
  * Create and configure the Memorix MCP Server.
  */
 /** Optional shared TeamStore — passed by serve-http so all sessions share state */
-interface SharedTeamInstances {
+interface SharedTeamStore {
     teamStore: TeamStore;
 }
 interface CreateMemorixServerOptions {
@@ -500,7 +500,7 @@ interface CreateMemorixServerOptions {
      */
     projectBinding?: ProjectBindingController;
 }
-declare function createMemorixServer(cwd?: string, existingServer?: McpServer, sharedTeam?: SharedTeamInstances, options?: CreateMemorixServerOptions): Promise<{
+declare function createMemorixServer(cwd?: string, existingServer?: McpServer, sharedTeam?: SharedTeamStore, options?: CreateMemorixServerOptions): Promise<{
     server: McpServer;
     graphManager: KnowledgeGraphManager;
     projectId: string;