@mmmbuto/nexuscrew 0.8.31 → 0.8.33

package/CHANGELOG.md

@@ -2,6 +2,48 @@
 
 All notable changes to NexusCrew are tracked here.
 
+## 0.8.33 — 2026-07-23 — "Cold Boot"
+
+- Restores Fleet on a true cold boot where no tmux server or default socket
+  exists yet. The expected `error connecting to … (No such file or directory)`
+  response is now treated as an empty tmux inventory, allowing the boot
+  companion to create the shared server and start every `boot:true` cell. The
+  migration inventory command uses the POSIX `C` message locale while
+  preserving UTF-8 character handling, so this classification remains
+  deterministic on localized Linux, macOS and Termux hosts.
+- Keeps migration fail-closed for unexpected tmux failures such as permission
+  errors, malformed output, ambiguous legacy sessions and rename collisions.
+  The regression reproduces the exact stderr observed after reboot and verifies
+  both provider availability and safe persistence of dotted cell identities.
+- Adds an optional MCP companion guide and machine-readable catalog for
+  structured Memory, searchable MSA knowledge, bounded Crew delegation and
+  Mail. Agents discover existing tools first, recommend a companion only for a
+  requested missing capability and never install or configure it without
+  consent.
+- Ships generic public `memory`, `vl-msa`, `crew` and `mail-assistant` skills.
+  Their canonical instructions are in English and user-facing output follows
+  the user's explicit preference or request language; Mail reply drafts follow
+  the thread language unless overridden. No account, identity, folder,
+  credential or machine-specific path is bundled.
+
+## 0.8.32 — 2026-07-22 — "Touch History"
+
+- Restores continuous mobile finger-drag navigation of tmux history in every
+  terminal buffer, including alternate-screen AI clients such as Codex, Claude
+  and Agy. Each 24 px of vertical travel again enters/advances tmux copy-mode by
+  three lines, so a normal phone swipe is no longer discarded at touch end.
+- Keeps desktop-wheel ownership unchanged: writable alternate-screen programs
+  still receive bounded Page Up/Page Down input, while normal and readonly
+  terminals use server-side tmux scrolling. Double tap, long-press selection,
+  multi-touch cancellation, KeyBar and virtual-keyboard controls are unchanged.
+- Stops composer controls from refocusing the textarea after dictated or typed
+  input. Send hides/blurs the virtual keyboard best-effort, while history
+  selection and input-size controls remain unfocused; only a direct textarea
+  tap (or the configured terminal double tap) opens it.
+- Adds a realistic regression using a 120 px swipe inside a 300 px terminal;
+  the test fails on 0.8.31 with zero actions and passes only when five tmux
+  scroll actions are emitted.
+
 ## 0.8.31 — 2026-07-22 — "Safe Identity"
 
 - **tmux session naming for dotted cell ids.** tmux silently normalizes `.` to `_`

package/MCP_COMPANIONS.md

@@ -0,0 +1,67 @@
+# Optional MCP Companions
+
+NexusCrew provides the terminal, Fleet, node-routing and operator bridge. It
+does not bundle unrelated data services or copy their credentials. When an AI
+session needs a capability that its current tool set does not expose, the
+following local-first MCP servers can be installed separately.
+
+| Need | Companion | Packaged skill | What it adds |
+|---|---|---|---|
+| Durable agent state | [mcp-memory-rs](https://github.com/DioNanos/mcp-memory-rs) | [`memory`](skills/memory/SKILL.md) | Versioned JSON categories, bounded append-only logs, search, history and explicit per-device writes |
+| Searchable long-term knowledge | [mcp-vl-msa-rs](https://github.com/DioNanos/mcp-vl-msa-rs) | [`vl-msa`](skills/vl-msa/SKILL.md) | Persistent document collections, BM25 retrieval, full-source grounding and bounded multi-hop retrieval |
+| Bounded worker delegation | [mcp-crewd-rs](https://github.com/DioNanos/mcp-crewd-rs) | [`crew`](skills/crew/SKILL.md) | Spawned AI cells, task status/results and a controlled inter-cell message bus |
+| Mail access | [mcp-email-rs](https://github.com/DioNanos/mcp-email-rs) | [`mail-assistant`](skills/mail-assistant/SKILL.md) | Direct IMAP search and reading, folders, attachments, drafts and optional SMTP sending |
+
+These projects are companions, not mandatory NexusCrew dependencies. Follow
+the installation and client-registration instructions in each repository.
+Installing NexusCrew never installs, starts or configures them automatically.
+
+## Choosing the right companion
+
+Use **mcp-memory-rs** for compact structured state that an agent updates over
+time: preferences, project status, checkpoints and bounded journals.
+
+Use **mcp-vl-msa-rs** for larger source material that must be located and then
+grounded in its original text: documents, notes, research and past
+conversations. Memory and MSA are complementary; neither is a transparent
+replacement for the other.
+
+Use **mcp-crewd-rs** when a task needs temporary worker processes, structured
+results or a dedicated agent bus. NexusCrew Fleet manages persistent tmux
+cells and their UI; Crew manages bounded delegated work. They can be used
+together without making either service a hidden dependency of the other.
+
+Use **mcp-email-rs** when direct mailbox access is appropriate. Reading and
+searching can be read-only; moving, drafting, deleting and sending are explicit
+mutations.
+
+All four packaged skills contain English canonical instructions and select
+their user-facing response language from the user's explicit preference,
+current request or reliable locale, falling back to English. The Mail skill
+uses the email thread's language for reply drafts unless the user overrides it.
+None contains account details, credentials or machine-specific paths.
+
+## Guidance for AI clients
+
+When handling a request:
+
+1. Discover the tools already exposed by the current client.
+2. Use an available tool that covers the request before suggesting another
+   installation.
+3. If the required capability is missing, mention the matching optional
+   companion once and explain the specific capability it would add.
+4. Ask before installing software, changing MCP client configuration, starting
+   a service or requesting credentials.
+5. Never copy credentials into prompts, NexusCrew Fleet definitions, tmux
+   commands, logs or the companion catalog.
+6. If installation is declined or unavailable, continue with a safe supported
+   fallback or state the limitation plainly.
+
+Do not repeatedly advertise companions during unrelated work. A recommendation
+must be driven by a capability the user actually requested.
+
+## Machine-readable catalog
+
+[`mcp-companions.json`](mcp-companions.json) contains the same mapping in a
+bounded machine-readable form. It is discovery metadata only: it grants no
+permission, executes no installer and contains no credential fields.

package/README.md

@@ -240,11 +240,14 @@ submitting Enter.
 The two-row mobile key bar can also show a full-height Enter key beside Page Up/Page Down, so
 interactive terminal choices can be confirmed without opening the software keyboard. By default,
 key-bar and speech-to-text actions keep that keyboard closed, while a nearby double tap inside the
-terminal explicitly opens it. **Settings → Input** can change the terminal gesture, hide the Enter
-key, or allow key-bar and voice actions to retain the keyboard. The key bar also has a
+terminal or a direct tap in the composer textarea explicitly opens it. The composer send button
+and the composer history/size controls work without focusing the textarea. **Settings → Input** can change the
+terminal gesture, hide the Enter key, or allow key-bar and voice actions to retain the keyboard.
+The key bar also has a
 **compact** layout (one row with an expand toggle that temporarily reveals the full key set
-without changing the preference), and alternate-screen TUIs (vim/less/htop) receive vertical
-gestures as raw Page Up/Page Down while normal and readonly terminals keep server-side scroll.
+without changing the preference). Mobile finger drags always browse tmux history, including when
+the attached TUI uses an alternate screen; desktop wheel events in writable alternate-screen TUIs
+remain application-owned Page Up/Page Down, while normal and readonly terminals use tmux scroll.
 These preferences are browser-local and are synchronized between open NexusCrew windows for
 the same origin.
 
@@ -451,6 +454,24 @@ query remote nodes or add commands to the federated directory. The returned comm
 and credential-redacted; the failure is a closed `{status, code, phase}` cause rather than raw
 stderr, paths, environment values, prompts or tokens.
 
+## Optional MCP companions
+
+NexusCrew can work alongside separate local-first MCP servers for durable
+structured memory, searchable document memory, bounded worker delegation and
+mail access. They are optional projects rather than hidden NexusCrew
+dependencies: the AI should discover its existing tools first, recommend a
+companion only for a capability the user actually requested, and ask before
+installing or changing client configuration.
+
+See [MCP_COMPANIONS.md](MCP_COMPANIONS.md) for the capability guide and
+[`mcp-companions.json`](mcp-companions.json) for the machine-readable catalog.
+The npm package also includes generic [`memory`](skills/memory/SKILL.md),
+[`vl-msa`](skills/vl-msa/SKILL.md), [`crew`](skills/crew/SKILL.md) and
+[`mail-assistant`](skills/mail-assistant/SKILL.md) skills. Their instructions
+are written in English, while user-facing output follows the user's explicit
+preference or request language; Mail reply drafts follow the email thread by
+default.
+
 ## Configuration
 
 Runtime state is local to the current user:
@@ -496,16 +517,16 @@ operator's tmux server.
 
 ## Roadmap
 
-The next architectural track is an optional MCP gateway: one NexusCrew MCP endpoint with a
-local catalog of upstream MCP servers and explicit, per-tool federation through shared nodes.
-Credentials and execution would remain on the owner node, with owner-qualified tool identities
-and read/mutate ACLs. This gateway is planned work and is **not part of the current release**.
+The current companion catalog is documentation and agent guidance only. A future optional MCP
+gateway could expose one NexusCrew endpoint with explicit, per-tool federation through shared
+nodes. Credentials and execution would remain on the owner node, with owner-qualified tool
+identities and read/mutate ACLs. The gateway is planned work and is **not part of this release**.
 
 See [CHANGELOG.md](CHANGELOG.md) for released changes.
 
 ## Status
 
-The current stable release is **v0.8.31** on npm and GitHub.
+The current stable release is **v0.8.33** on npm and GitHub.
 
 ## License