n2n-nexus 0.11.0 → 0.12.1

package/CHANGELOG.md

@@ -4,6 +4,37 @@
 
 All notable changes to this project will be documented in this file.
 
+## [0.12.1] - 2026-10-29
+
+### Changed
+
+- New tray icon, also the README logo: a small network on a charcoal tile with a grey edge, a red node in the middle joined by light blue links to four white nodes. It replaces the teal disc in the tray and the hexagon logo; the old icon and banner files are gone from `assets`. On macOS the menu bar shows the network alone as a template image, black or white to suit the menu bar.
+
+### Fixed
+
+- A message the host posts because of your own call (the seat taken, the AI consensus notice, the seat's decision or veto) counts as read for you: the seat drafts the next point right after taking the seat or deciding one, and the member whose stance completed the AI consensus posts right after it, without a refusal for that message.
+- Meeting news no longer repeats what `read_messages` returned in unread mode: reading a meeting also marks those messages announced, so the next hook notification shows only what came after.
+- In a meeting with the user's seat, the message about a changed approver list no longer names the seat, which is in none of the approver lists.
+
+## [0.12.0] - 2026-10-29
+
+Upgrade the host and the client on every machine together (contract version 4). The database is upgraded in place: keep `nexus.db`.
+
+### Added
+
+- Meetings with the user's seat: the conversation the user sits at takes the seat with `seat: "user"` on `start_meeting` or `join_meeting`; taking it moves it from whoever held it. The seat's `endorse` of the current draft makes the host post the `DECISION` (with the objections still open) and the meeting goes on to the next point; its `object` vetoes the draft. The others' consensus decides nothing there and is only reported when it is reached or lost. Only the seat ends such a meeting, with a summary; anyone else's `end_meeting` is posted as a proposal to end it. `list_meetings` returns `seat`, and `approvals` the seat's stance.
+- Cleanup by age, at startup and every hour, with two `settings.json` fields: `meetingRetentionDays` (default 30) and `retentionDays` (default 7). Read or expired direct messages, delivered notices, events, finished tasks, sessions without activity (unless a direct message still references them) and adapter instances not seen go after `retentionDays`; an active meeting without a message for `meetingRetentionDays` closes with `endReason: expired`, and a closed or archived meeting goes `meetingRetentionDays` after it ended. Each cleanup that changed something writes a `maintenance.cleanup` event.
+- `host_maintenance` actions `cleanup` (with `dryRun` to see what would go) and `export` (a meeting as markdown).
+
+### Changed
+
+- Read before posting: `send_message` to a meeting, and `endorse` / `object`, are refused while messages of others are unread; the result attaches them (texts cut at `notifyTextChars`) and they count as read. The next post after a refusal goes through with a note of what was unread; a draft or a `DECISION` only once everything is read. `withdraw` goes through with the unread messages attached.
+- Meeting notifications show each message with its text, like direct messages; what a wake, a Stop or a prompt shows whole counts as read.
+- An objection, and a stance that changes your last one, need grounds in the note (`#n`, a file path, a URL, or a sentence starting with 实测：/文档：/数据： or Measured:/Docs:/Data:); a stance on a proposal can change at most twice.
+- Meeting messages, global chat and meeting members keep the sender's name and machine as they were when written; `read_messages` returns `senderBackfilled` and members `machine` and `backfilled` for the rows of older databases, filled in at the upgrade.
+- Sessions report their environment (the WSL distribution, shown after the platform: `Vector · WSL Ubuntu_26`); on macOS the hostname is the computer name set in System Settings. A session is named `<client>@<dir>#<the last 4 letters and digits of its id>`, with more of the id while another recorded session has that name, so names are not reused.
+- The tray menu's first line says only whether the host runs (`Running`, `Running · background service` or `Not running`); the address is on its own line, and the error takes that line when no host answers. The `(LAN)` suffix is gone: the **Allow LAN access** item shows the same.
+
 ## [0.11.0] - 2026-10-29
 
 Upgrade the host and the client on every machine together, and delete `nexus.db` from the host's data directory before the new host starts: this release starts a new database and contract version, and an older host or client no longer works with it.

package/README.md

@@ -11,7 +11,6 @@ Local-first MCP coordination hub from N2NS Lab for multi-AI assistant collaborat
 [![license](https://img.shields.io/github/license/n2ns/n2n-nexus)](https://github.com/n2ns/n2n-nexus/blob/main/LICENSE)
 [![MCP Protocol](https://img.shields.io/badge/MCP-Protocol-blue)](https://modelcontextprotocol.io)
 [![node version](https://img.shields.io/node/v/n2n-nexus)](https://nodejs.org)
-[![DataFrog.io](https://datafrog.io/badges/datafrog.svg)](https://datafrog.io)
 
 [中文版](./docs/README_zh.md)
 
@@ -32,6 +31,7 @@ n2n-nexus is an open-source Model Context Protocol (MCP) coordination server for
 - [Real-world example](#-real-world-example)
 - [FAQ](#-faq)
 - [Documentation](#-documentation)
+- [License](#-license)
 
 ## 🔎 Looking for
 
@@ -62,8 +62,10 @@ n2n-nexus gives AI assistants a shared coordination workspace. A long-running lo
 ## 🎯 Why use it?
 
 - Coordinate multiple AI assistants working on the same project.
+- Let Claude Code and Codex conversations message each other directly: a message arrives whole through the client's hooks, wakes a waiting conversation, and is answered with `reply`; each session shows the machine and environment it runs on.
+- Hold meetings among assistants and keep their decisions. When you take part, your conversation holds the user's seat: you decide each draft and end the meeting, and the assistants' consensus is only reported.
 - Share project manifests, decisions, and assets across IDEs and machines.
-- Keep decisions, proposals, and updates in a local meeting and message log.
+- Keep decisions, proposals, and updates in a local meeting and message log; old data is cleaned up after the retention you set.
 - Run the host once; connect adapters from Windows, WSL, SSH hosts, or multiple editors.
 - Avoid giving each assistant broad filesystem or backend access.
 
@@ -85,7 +87,7 @@ n2n-nexus gives AI assistants a shared coordination workspace. A long-running lo
 
 - **The host is the source of truth**: install it once and keep it running, as a tray app or as a background service.
 - **MCP adapters are stateless**: each IDE starts an adapter (`n2n-nexus mcp`), which forwards tool calls to the host.
-- **Every Claude Code and Codex conversation has its own identity**: client hooks register the conversation with the host and notify it of new direct messages; each tool call names its conversation through the request metadata the client attaches, never through model-supplied arguments.
+- **Every Claude Code and Codex conversation has its own identity**: client hooks register the conversation with the host and deliver new direct messages and meeting messages to it; each tool call names its conversation through the request metadata the client attaches, never through model-supplied arguments.
 - **Cross-environment by design**: point `NEXUS_ENDPOINT` at the same host from different machines or shells. The host listens on `127.0.0.1` by default; turn on LAN access only on a trusted network.
 
 ## 🚀 Quick start
@@ -107,9 +109,9 @@ The host exposes 36 tools, grouped by purpose:
 | **Global docs** | `list_global_docs`, `get_global_doc`, `sync_global_doc`, `get_global_strategy`, `update_global_strategy` | List, read, create and update shared global documents and the master strategy document. |
 | **Messaging** | `send_message`, `read_messages`, `list_events` | Post meeting or global messages; read them and the activity log. |
 | **Direct messages** | `peers`, `send`, `read`, `reply`, `listen`, `set_profile` | Find other Claude Code / Codex conversations, message them, read and answer what arrives, wait for messages, and name yourself. |
-| **Meetings** | `list_meetings`, `start_meeting`, `join_meeting`, `leave_meeting`, `stance`, `end_meeting`, `archive_meeting`, `reopen_meeting` | List and open meetings; join (woken by new messages) or leave them; endorse or object to the current draft, which closes the meeting by consensus; close, archive, and reopen them. |
+| **Meetings** | `list_meetings`, `start_meeting`, `join_meeting`, `leave_meeting`, `stance`, `end_meeting`, `archive_meeting`, `reopen_meeting` | List and open meetings; join (woken by new messages) or leave them; endorse or object to the current draft, which closes the meeting by consensus or, with the user's seat, is decided by the user; close, archive, and reopen them. |
 | **Tasks** | `create_task`, `get_task`, `list_tasks`, `update_task`, `cancel_task` | Create, update and track tasks that assistants manage themselves. |
-| **Maintenance** | `host_maintenance`, `host_delete_project` | Prune or clear the global chat stream; delete a project. |
+| **Maintenance** | `host_maintenance`, `host_delete_project` | Prune or clear the global chat stream; run the retention cleanup now; export a meeting as markdown; delete a project. |
 
 See [Tools reference](./docs/TOOLS_REFERENCE.md) for parameter schemas and call examples.
 
@@ -152,6 +154,10 @@ Yes. Run the host in one environment and point every adapter at it with `NEXUS_E
 
 No cloud service is needed. Data stays in the configured local directory. Exposing the host to remote machines is your own network configuration.
 
+### How long does it keep data?
+
+Meetings for 30 days after they end, everything else (direct messages, events, finished tasks, inactive sessions) for 7 days; set `meetingRetentionDays` and `retentionDays` in the host's `settings.json`. `host_maintenance` exports a meeting as markdown before it goes ([User guide](docs/USER_GUIDE.md#settingsjson)).
+
 ### Is it a vector database or a source code indexer?
 
 No. n2n-nexus coordinates project metadata, messages, meetings, docs, tasks and assets; it does no semantic code search.

package/build/cli/machine.js

@@ -1,9 +1,10 @@
 /**
  * Where this conversation runs, which the hook command adds to the input of
  * every event it forwards as `machine`, so that other sessions can tell the machines apart
- * (several sessions share a name and a working directory across machines).
+ * (sessions on different machines or WSL distributions often share a working directory).
  * Node built-ins only: the hook command imports this on client events.
  */
+import { execFileSync } from "node:child_process";
 import fs from "node:fs";
 import os from "node:os";
 /** darwin, linux, win32 as Node reports them; wsl for a Linux that runs under Windows. */
@@ -17,11 +18,31 @@ export function platformOf(platform = process.platform, readProcVersion = () =>
         return "linux";
     }
 }
-/** The host name without the `.local` suffix that macOS adds. */
-export function hostnameOf(hostname = os.hostname()) {
+/**
+ * The machine's name. On macOS the name set in System Settings (ComputerName):
+ * the host name there is a model name such as MacBook-Air that two Macs share,
+ * and it changes with the network. Elsewhere, and when that cannot be read, the
+ * host name without the `.local` suffix that macOS adds.
+ */
+export function hostnameOf(platform = process.platform, hostname = os.hostname(), readComputerName = () => execFileSync("scutil", ["--get", "ComputerName"], { encoding: "utf8", timeout: 1000, stdio: ["ignore", "pipe", "ignore"] })) {
+    if (platform === "darwin") {
+        try {
+            const name = readComputerName().trim();
+            if (name)
+                return name;
+        }
+        catch {
+            // fall back to the host name
+        }
+    }
     return hostname.replace(/\.local$/i, "");
 }
+/** What tells environments that share the host name apart: the WSL distribution, else "". */
+export function environmentOf(platform, env = process.env) {
+    return platform === "wsl" ? env.WSL_DISTRO_NAME ?? "" : "";
+}
 export function machineInfo(now = new Date()) {
+    const platform = platformOf();
     // 0 - x, not -x: at UTC -x is -0, which JSON writes as 0.
-    return { hostname: hostnameOf(), platform: platformOf(), utcOffset: 0 - now.getTimezoneOffset() };
+    return { hostname: hostnameOf(), platform, environment: environmentOf(platform), utcOffset: 0 - now.getTimezoneOffset() };
 }

package/contract/errors.json

@@ -1,5 +1,5 @@
 {
-  "contractVersion": 3,
+  "contractVersion": 4,
   "errorBody": {
     "type": "object",
     "properties": {
@@ -21,7 +21,7 @@
         "ok": true,
         "service": "n2n-nexus",
         "version": "<host version>",
-        "contractVersion": 3,
+        "contractVersion": 4,
         "sessions": {
           "online": "<number of agent sessions not offline>"
         }

package/contract/hook.json

@@ -1,5 +1,5 @@
 {
-  "contractVersion": 3,
+  "contractVersion": 4,
   "clients": [
     "claude",
     "codex"
@@ -78,12 +78,26 @@
     "replyTool": "The reply tool is %s.",
     "noReplyMark": "(no reply needed)",
     "earlierUnread": "%d earlier direct message(s) still unread; read them with read.",
-    "meetingNews": "Meeting \"%s\" (%s): %d new message(s) (#%d–#%d) from %s.",
-    "meetingClosing": "Read them with read_messages(meetingId); post with send_message(meetingId) only when you have something to add.",
+    "meetingNews": "Meeting \"%s\" (%s): %d new message(s), #%d–#%d:",
+    "meetingMessageHeader": "--- Meeting message #%d from %s at %s%s ---",
+    "meetingMessageEnd": "--- End of meeting message #%d ---",
+    "meetingNotShown": "- %d more message(s) not shown (#%d–#%d).",
+    "meetingReadRest": "read_messages(meetingId) returns the meeting messages that are cut or not shown here.",
+    "meetingClosing": "Post with send_message(meetingId) only when you have something to add.",
+    "sentWithUnread": "[n2n-nexus: sent while %s were unread by the sender.]",
     "meetingEnded": "Meeting \"%s\" (%s) has ended%s. No reply needed.",
     "stanceNotice": "%s %s draft #%d of meeting \"%s\" (%s)%s. No reply needed.",
     "approversChanged": "Required approvers of draft #%d changed (version %d): %s.",
     "consensusDecision": "Decision by consensus on draft #%d: every required approver (%s) endorsed it.\n\n%s",
+    "seatSender": "user's seat (via %s)",
+    "seatTaken": "The user's seat is taken by %s: its stances on the current draft and its end_meeting are the user's decisions.",
+    "seatMoved": "The user's seat moved from %s to %s.",
+    "seatDecision": "Decision on draft #%d, approved by the user's seat (%s)%s.%s\n\n%s",
+    "seatOpenObjections": " Objections still open when it was approved: %s.",
+    "seatVeto": "Draft #%d was vetoed by the user's seat (%s): %s",
+    "aiConsensus": "AI consensus on draft #%d: every required approver besides the user's seat (%s) endorsed it. Only the user's seat decides it.",
+    "aiConsensusLost": "AI consensus on draft #%d is lost.",
+    "proposedEnd": "Proposed end of the meeting (only the user's seat ends it): %s",
     "stanceReminder": "Meeting \"%s\" (%s) waits for your stance on draft #%d: call stance with meetingId and messageId %d, endorse or object (with a reason). No other reply needed.",
     "stanceWaiting": "Meeting \"%s\" (%s): draft #%d still waits for the stance of %s. No reply needed.",
     "noAgentSessionError": "This call carries no agent session, so direct messaging cannot tell who you are. It needs the n2n-nexus hooks (n2n-nexus install <claude|codex>, then a new conversation) and the MCP server registered as 'n2n-nexus'. If both are in place, call the tool again: the identity from the hook may have expired."
@@ -196,6 +210,10 @@
             "win32"
           ]
         },
+        "environment": {
+          "type": "string",
+          "description": "The WSL distribution, \"\" otherwise"
+        },
         "utcOffset": {
           "type": "integer",
           "minimum": -1440,
@@ -205,6 +223,7 @@
       "required": [
         "hostname",
         "platform",
+        "environment",
         "utcOffset"
       ]
     }