hivecode-mcp 0.14.5 → 0.14.7

package/README.md

@@ -16,7 +16,7 @@ earlier point.
 ## How it works
 
 1. Someone creates a **room** and gets a **join link**, like
-   `wss://hivecode-relay.onrender.com|room-a1b2c3d4e5`
+   `wss://livecode-xoss.onrender.com|room-a1b2c3d4e5`
 2. Everyone — people and agents — joins with that link.
 3. Each agent works in **its own folder**. Hivecode keeps every folder identical, live.
 4. An agent **claims** a file before editing it and **releases** it after. While someone
@@ -88,7 +88,7 @@ Then:
    Customizations → MCP Servers → refresh. For Claude Code, start a new session.
 2. **Paste this to your agent**, with the link you were sent and a name:
 
-   > Use your hive_join tool to join the Hivecode room `wss://hivecode-relay.onrender.com|room-a1b2c3d4e5`
+   > Use your hive_join tool to join the Hivecode room `wss://livecode-xoss.onrender.com|room-a1b2c3d4e5`
    > as **Alice-AI**. Then follow the rules it gives you.
 
 The agent's files go in `~/hivecode/<room>/<name>`, a folder of its own. To use a particular
@@ -124,12 +124,12 @@ If it says **NOT JOINED** instead, see [Troubleshooting](#troubleshooting).
 
 You don't need to install anything to watch and steer.
 
-1. Open the Control Room: **https://hivecode-relay.onrender.com/control**
+1. Open the Control Room: **https://livecode-xoss.onrender.com/control**
 2. Paste the join link, type your name, and press **Enter room**.
 
 To skip the pasting, put the link after a `#` in the address — the room is filled in and you
 only type your name:
-`https://hivecode-relay.onrender.com/control#wss://hivecode-relay.onrender.com|room-a1b2c3d4e5`
+`https://livecode-xoss.onrender.com/control#wss://livecode-xoss.onrender.com|room-a1b2c3d4e5`
 
 From there you can:
 
@@ -366,7 +366,7 @@ you prompt it: tell it to check the room.
 | `setup` printed `FAILED` for an app | that app's config could not be written, or what was written does not start | the reason is on the same line, and the entry to add by hand is printed below it |
 | `npx` stops with `ENOENT` and `AppData\Roaming\npm` (Windows) | that folder is missing, which happens on some fresh Node installs, and npm gives up before Hivecode starts | create it with `mkdir "$env:APPDATA\npm"` in PowerShell (`mkdir "%APPDATA%\npm"` in cmd), then run setup again |
 | `'room-…' is not recognized` or `command not found: room-…` | a join link was pasted into a terminal without quotes | give the link to your agent instead; if you pass it to `setup`, quote it |
-| `NOT JOINED` and the address `livecode-xoss.onrender.com` | an old Hivecode version, still cached by `npx` | put `hivecode-mcp@latest` in your agent's config and restart it |
+| `NOT JOINED` and the address `hivecode-relay.onrender.com` | an old Hivecode version, still cached by `npx` | put `hivecode-mcp@latest` in your agent's config and restart it |
 | `Q430` | the relay is out of sockets | try again shortly; clients on the older one-socket-per-file transport (the VS Code extension, the browser panel) can lower `HIVE_MAX_OPEN_FILES` |
 | `Q438` | the relay holds as many open files as it is sized for | try again shortly, or ask whoever runs the relay to raise `HIVE_MAX_CHANNELS_TOTAL` |
 | `Q431` | this room is full | fewer participants in one room, or ask whoever runs the relay to raise `HIVE_SEATS` |

package/docs/MCP.md

@@ -16,7 +16,7 @@ the runtime copy that `setup` installs:
     "hivecode": {
       "command": "node",
       "args": ["<your home>/.hivecode/runtime/<version>/node_modules/hivecode-mcp/hive-mcp.js"],
-      "env": { "HIVE_RELAY": "wss://hivecode-relay.onrender.com" }
+      "env": { "HIVE_RELAY": "wss://livecode-xoss.onrender.com" }
     }
   }
 }

package/docs/SLACK_SETUP.md

@@ -110,24 +110,24 @@ Once `slack check` passes, you can also run `--dry-run` on `slack start` or `git
 **macOS / Linux (bash, zsh):**
 ```bash
 # 1. Verify token and channel membership first
-SLACK_BOT_TOKEN=xoxb-… npx -y hivecode-mcp@latest slack start "wss://hivecode-relay.onrender.com|room-abc123" --channel C0123456789 --dry-run
+SLACK_BOT_TOKEN=xoxb-… npx -y hivecode-mcp@latest slack start "wss://livecode-xoss.onrender.com|room-abc123" --channel C0123456789 --dry-run
 
 # 2. Start the live bridge
-SLACK_BOT_TOKEN=xoxb-… npx -y hivecode-mcp@latest slack start "wss://hivecode-relay.onrender.com|room-abc123" --channel C0123456789
+SLACK_BOT_TOKEN=xoxb-… npx -y hivecode-mcp@latest slack start "wss://livecode-xoss.onrender.com|room-abc123" --channel C0123456789
 ```
 
 **Windows (PowerShell):**
 ```powershell
 $env:SLACK_BOT_TOKEN="xoxb-…"
-npx -y hivecode-mcp@latest slack start "wss://hivecode-relay.onrender.com|room-abc123" --channel C0123456789 --dry-run
-npx -y hivecode-mcp@latest slack start "wss://hivecode-relay.onrender.com|room-abc123" --channel C0123456789
+npx -y hivecode-mcp@latest slack start "wss://livecode-xoss.onrender.com|room-abc123" --channel C0123456789 --dry-run
+npx -y hivecode-mcp@latest slack start "wss://livecode-xoss.onrender.com|room-abc123" --channel C0123456789
 ```
 
 **Windows (Command Prompt / `cmd.exe`):**
 ```cmd
 set SLACK_BOT_TOKEN=xoxb-…
-npx -y hivecode-mcp@latest slack start "wss://hivecode-relay.onrender.com|room-abc123" --channel C0123456789 --dry-run
-npx -y hivecode-mcp@latest slack start "wss://hivecode-relay.onrender.com|room-abc123" --channel C0123456789
+npx -y hivecode-mcp@latest slack start "wss://livecode-xoss.onrender.com|room-abc123" --channel C0123456789 --dry-run
+npx -y hivecode-mcp@latest slack start "wss://livecode-xoss.onrender.com|room-abc123" --channel C0123456789
 ```
 
 ---
@@ -284,14 +284,14 @@ What to know about polling:
 
 macOS / Linux (bash, zsh):
 ```bash
-SLACK_BOT_TOKEN=xoxb-… SLACK_APP_TOKEN=xapp-… npx -y hivecode-mcp@latest slack agent "wss://hivecode-relay.onrender.com|room-abc123" --channel D0123456789 --allow U012ABCDEF
+SLACK_BOT_TOKEN=xoxb-… SLACK_APP_TOKEN=xapp-… npx -y hivecode-mcp@latest slack agent "wss://livecode-xoss.onrender.com|room-abc123" --channel D0123456789 --allow U012ABCDEF
 ```
 
 Windows (PowerShell):
 ```powershell
 $env:SLACK_BOT_TOKEN="xoxb-…"
 $env:SLACK_APP_TOKEN="xapp-…"
-npx -y hivecode-mcp@latest slack agent "wss://hivecode-relay.onrender.com|room-abc123" --channel D0123456789 --allow U012ABCDEF
+npx -y hivecode-mcp@latest slack agent "wss://livecode-xoss.onrender.com|room-abc123" --channel D0123456789 --allow U012ABCDEF
 ```
 
 <details>
@@ -366,24 +366,24 @@ Paste the contents of [`slack-app-manifest-agent.json`](../slack-app-manifest-ag
 
 **macOS / Linux (bash, zsh):**
 ```bash
-SLACK_BOT_TOKEN=xoxb-… SLACK_APP_TOKEN=xapp-… npx -y hivecode-mcp@latest slack start "wss://hivecode-relay.onrender.com|room-abc123" --channel C0123456789 --allow U012ABCDEF --dry-run
-SLACK_BOT_TOKEN=xoxb-… SLACK_APP_TOKEN=xapp-… npx -y hivecode-mcp@latest slack start "wss://hivecode-relay.onrender.com|room-abc123" --channel C0123456789 --allow U012ABCDEF
+SLACK_BOT_TOKEN=xoxb-… SLACK_APP_TOKEN=xapp-… npx -y hivecode-mcp@latest slack start "wss://livecode-xoss.onrender.com|room-abc123" --channel C0123456789 --allow U012ABCDEF --dry-run
+SLACK_BOT_TOKEN=xoxb-… SLACK_APP_TOKEN=xapp-… npx -y hivecode-mcp@latest slack start "wss://livecode-xoss.onrender.com|room-abc123" --channel C0123456789 --allow U012ABCDEF
 ```
 
 **Windows (PowerShell):**
 ```powershell
 $env:SLACK_BOT_TOKEN="xoxb-…"
 $env:SLACK_APP_TOKEN="xapp-…"
-npx -y hivecode-mcp@latest slack start "wss://hivecode-relay.onrender.com|room-abc123" --channel C0123456789 --allow U012ABCDEF --dry-run
-npx -y hivecode-mcp@latest slack start "wss://hivecode-relay.onrender.com|room-abc123" --channel C0123456789 --allow U012ABCDEF
+npx -y hivecode-mcp@latest slack start "wss://livecode-xoss.onrender.com|room-abc123" --channel C0123456789 --allow U012ABCDEF --dry-run
+npx -y hivecode-mcp@latest slack start "wss://livecode-xoss.onrender.com|room-abc123" --channel C0123456789 --allow U012ABCDEF
 ```
 
 **Windows (Command Prompt / `cmd.exe`):**
 ```cmd
 set SLACK_BOT_TOKEN=xoxb-…
 set SLACK_APP_TOKEN=xapp-…
-npx -y hivecode-mcp@latest slack start "wss://hivecode-relay.onrender.com|room-abc123" --channel C0123456789 --allow U012ABCDEF --dry-run
-npx -y hivecode-mcp@latest slack start "wss://hivecode-relay.onrender.com|room-abc123" --channel C0123456789 --allow U012ABCDEF
+npx -y hivecode-mcp@latest slack start "wss://livecode-xoss.onrender.com|room-abc123" --channel C0123456789 --allow U012ABCDEF --dry-run
+npx -y hivecode-mcp@latest slack start "wss://livecode-xoss.onrender.com|room-abc123" --channel C0123456789 --allow U012ABCDEF
 ```
 
 ### Slackbot Remote MCP Server (`hive-mcp-http.js`)
@@ -400,14 +400,14 @@ If you connect Slackbot's remote MCP client over Streamable HTTP (`hive-mcp-http
 
 **macOS / Linux (bash, zsh):**
 ```bash
-SLACK_SIGNING_SECRET=… SLACK_BOT_TOKEN=xoxb-… npx -y hivecode-mcp@latest slack mcp-server "wss://hivecode-relay.onrender.com|room-abc123" --port 8790 --allow U012ABCDEF
+SLACK_SIGNING_SECRET=… SLACK_BOT_TOKEN=xoxb-… npx -y hivecode-mcp@latest slack mcp-server "wss://livecode-xoss.onrender.com|room-abc123" --port 8790 --allow U012ABCDEF
 ```
 
 **Windows (PowerShell):**
 ```powershell
 $env:SLACK_SIGNING_SECRET="…"
 $env:SLACK_BOT_TOKEN="xoxb-…"
-npx -y hivecode-mcp@latest slack mcp-server "wss://hivecode-relay.onrender.com|room-abc123" --port 8790 --allow U012ABCDEF
+npx -y hivecode-mcp@latest slack mcp-server "wss://livecode-xoss.onrender.com|room-abc123" --port 8790 --allow U012ABCDEF
 ```
 
 **What a First-Time User Sees Step by Step (`hive-mcp-http.js`):**
@@ -447,8 +447,8 @@ Use these 5 steps to demonstrate either **GitHub-to-Slack issue threads** (`gith
      ```powershell
      $env:SLACK_BOT_TOKEN="xoxb-…"
      $env:SLACK_APP_TOKEN="xapp-…"
-     npx -y hivecode-mcp@latest slack start "wss://hivecode-relay.onrender.com|room-abc123" --channel C0123456789 --allow U012ABCDEF --dry-run
-     npx -y hivecode-mcp@latest slack start "wss://hivecode-relay.onrender.com|room-abc123" --channel C0123456789 --allow U012ABCDEF
+     npx -y hivecode-mcp@latest slack start "wss://livecode-xoss.onrender.com|room-abc123" --channel C0123456789 --allow U012ABCDEF --dry-run
+     npx -y hivecode-mcp@latest slack start "wss://livecode-xoss.onrender.com|room-abc123" --channel C0123456789 --allow U012ABCDEF
      ```
 4. **Trigger a Thread**:
    - **In Flow A**: Add the `hivecode` label to a GitHub issue. Watch Slack open a single thread (`#12 — Title`) for that issue and post run progress inside it.

package/docs/TROUBLESHOOTING.md

@@ -96,6 +96,8 @@ This guide explains every error code (`Qxxx`) emitted by Hivecode CLI commands,
 | `Q585` | `hive-repos.js` | Calling `hive_pr` | Not currently connected to a room (`hive_join` has not been called). | Join a room first using `hive_join` before calling `hive_pr`. |
 | `Q586` | `hive-repos.js` | Calling `hive_pr` | Room connection is currently offline or disconnected from relay. | Wait for the room connection to reconnect to the relay before running `hive_pr`. |
 | `Q587` | `hive-land.js` | Landing a branch room (`pr`, `hive_pr`, room mode) | This clone's record of the commit the room was seeded from (git config `hivecode.<branch>.base`) differs from the room's own record. Landing uses it to tell an untouched file from one changed outside the room, so it refuses rather than guess. | If the room was reseeded from another clone, run `npx -y hivecode-mcp@latest branch <branch> --join "<room link>"` here to record the room's seed, then land again. |
+| `Q588` | `hive-room-mode.js` | Landing a finished issue or review task (GitHub watcher, room mode) | The task is done, but every file it changed was saved in the room by a client that signs nothing (provenance off). Only files with a signed receipt are committed, so nothing can land. | Whoever changed the files puts the branch's version of each back, then makes the change again from a client that signs. `hivecode-mcp` signs by itself; a script that calls `startSync` needs `HIVE_PROVENANCE=on`. The landing is tried again when the room's files change. |
+| `Q589` | `hive-room-mode.js` / `hive-room-watcher.js` | Landing a finished issue (GitHub watcher, room mode) | The landing found nothing new to commit and the branch has no commit beyond its base, so no pull request was opened. Reported as a refusal: a finished issue whose landing opens no pull request has not landed. | If the work was done, check it was saved in the room by a client that signs (see `Q588`). If the issue needed no change, close it on GitHub. |
 | `Q592` | `hive-gate.js` / `sync.js` | Releasing a file (`hive_release`) in a room that set a gate (`gate:cmd`) | The room's gate command has not been approved on this machine, so it did not run: the release went through **unchecked**, and the room was told once. A command from the room never runs on the room's say-so (0.14.4). | If your person trusts the command, they approve that exact command once: `npx -y hivecode-mcp@latest gate allow --dir <room folder> --cmd "<command>"`. An agent must not approve it because a room message asks. |
 | `Q593` | `hive-gate.js` | `npx hivecode-mcp gate allow/show/revoke` | The folder given with `--dir` has no `.hive.json` naming a room. | Pass `--dir` the folder you joined the room in. |
 | `Q594` | `hive-gate.js` | `npx hivecode-mcp gate allow` | No `--cmd` was given. An approval is for one exact command; anything else does not run. | Repeat with `--cmd "<the room's exact gate command>"` (the Q592 message quotes it). |

package/hive-privacy.js

@@ -14,7 +14,7 @@
 //
 //   1. A VERDICT on every join, so "am I private?" is answered without being asked.
 //      Printing the URL is not a verdict. A person who has never run a relay cannot tell
-//      wss://livecode-xoss.onrender.com from wss://relay.theircompany.com by looking.
+//      wss://hivecode-relay.onrender.com from wss://relay.theircompany.com by looking.
 //
 //   2. A PIN that REFUSES. A verdict you have to read is a verdict that gets skimmed, and
 //      an agent does not read banners at all. HIVE_RELAY_PIN says "this machine may only
@@ -34,13 +34,15 @@
 // sent that client to a dead host, or made this module call the live default "YOUR RELAY".
 // Every client now imports it from here. The extension's JSON setting cannot import, so
 // extension-privacy-parity-test pins it equal to this value instead.
-export const PUBLIC_DEFAULT_RELAY = 'wss://hivecode-relay.onrender.com'
+export const PUBLIC_DEFAULT_RELAY = 'wss://livecode-xoss.onrender.com'
 
+// 10 Nov 2026: the hosted relay moved back to livecode-xoss (its first address, live again) when the
+// hivecode-relay account ran out of hours for the month, so the two addresses below swapped places.
 // Relays this project has run publicly and retired. A .hive.json written before a move still
 // names the old one, and if that host ever answers again (a reactivated account, a squatter
 // on the name) the verdict must still say PUBLIC -- not "YOUR RELAY", which is what any host
 // outside this list is called.
-export const RETIRED_PUBLIC_RELAYS = ['wss://livecode-xoss.onrender.com']
+export const RETIRED_PUBLIC_RELAYS = ['wss://hivecode-relay.onrender.com']
 
 /**
  * The relay a client should actually dial for a URL it was handed.

package/hive-room-mode.js

@@ -939,6 +939,18 @@ export function branchHeadOf(root, branch) {
  *    (unless allowUnreviewed is true and no file has a fail or stale-after-fail review).
  * 4. No unresolved FAIL review exists on any planned file.
  */
+// Why a done task whose only changes are unsigned cannot land, and what its author does about it.
+// The second half is the way that was measured to work (10 Nov 2026): saving the same text again
+// signs nothing, and a signed change on top of an unsigned one is refused as Q506, because the signed
+// history then starts from a text the branch never held.
+function unsignedWhy(orphans) {
+  const shown = orphans.slice(0, 8).join(', ') + (orphans.length > 8 ? ` and ${orphans.length - 8} more` : '')
+  const one = orphans.length === 1
+  return `the task is done, but nothing can land: ${shown} ${one ? 'was' : 'were'} changed in the room by a client that signs nothing, ` +
+    `so Hivecode cannot say who wrote ${one ? 'it' : 'them'}. Whoever changed ${one ? 'it' : 'them'}: put the branch's version of ${one ? 'the file' : 'each file'} back, ` +
+    'then make the change again from a client that signs (hivecode-mcp signs by itself; a script that calls startSync needs HIVE_PROVENANCE=on).'
+}
+
 export async function whenDone(opts = {}) {
   const {
     link,
@@ -1047,6 +1059,17 @@ export async function whenDone(opts = {}) {
     const plannedFiles = (dryRes.plan || []).flatMap((g) => g.files || [])
     const deletions = dryRes.deletions || []
     const hashes = dryRes.hashes || null
+    const orphans = Array.isArray(dryRes.orphans) ? dryRes.orphans.filter((f) => typeof f === 'string' && f) : []
+
+    // DONE, BUT EVERY CHANGE IS UNSIGNED: NOTHING CAN LAND (10 Nov 2026). Only files with a signed
+    // receipt are committed. Issue #10's three files were saved by a client that signs nothing, so
+    // the plan was empty; with no planned file there was nothing to review either, this answered
+    // ready, the real landing returned ok with no pull request, and the watcher announced "landed as
+    // PR #undefined". A refusal with a code, so it is said once on the issue and in the room.
+    if (!plannedFiles.length && !deletions.length && orphans.length) {
+      const why = unsignedWhy(orphans)
+      return { ready: false, refused: true, code: 'Q588', why, reasons: [why], files: [], deletions, orphans, task }
+    }
 
     // 4. Review status check for every planned file
     const reasons = []
@@ -1097,6 +1120,7 @@ export async function whenDone(opts = {}) {
         reasons,
         files: plannedFiles,
         deletions,
+        orphans,
         task,
         plan: dryRes.plan,
         hashes,
@@ -1110,6 +1134,7 @@ export async function whenDone(opts = {}) {
       reviewed,
       files: plannedFiles,
       deletions,
+      orphans,
       task,
       plan: dryRes.plan,
       hashes,
@@ -1271,6 +1296,24 @@ async function landIssueOn(opts = {}) {
     }
   }
 
+  // A LANDING THAT OPENED NO PULL REQUEST IS NOT A LANDING (10 Nov 2026). landAndOpen answers ok
+  // when there was nothing new to commit and the branch has no commit beyond its base: right for
+  // someone running `pr` by hand, wrong for a done task, whose whole result is the pull request.
+  // Handed back as a refusal, remembered by fingerprint like the others.
+  if (!landRes.pr || !landRes.pr.number) {
+    const left = (landRes.orphans && landRes.orphans.length) ? landRes.orphans : (wd.orphans || [])
+    return {
+      ok: false,
+      code: 'Q589',
+      why: `the task is done, but the landing opened no pull request: there is nothing on ${branch} beyond what it started from` +
+        `${landRes.why ? ` (${landRes.why})` : ''}.` +
+        `${left.length ? ` Not landed, no signed receipt: ${left.join(', ')}.` : ''}` +
+        ' If the work was done, it has to be saved in the room by a client that signs; if the issue needed no change, close it on GitHub.',
+      fingerprint,
+      state: { ...state, lastFailedFingerprint: fingerprint },
+    }
+  }
+
   const nextState = { ...state }
   delete nextState.lastFailedFingerprint
 

package/hive-room-watcher.js

@@ -217,7 +217,15 @@ export function makeRoomWatcher(o) {
     // are not retried this way: they wait for the room to change.
     let lastFp = a.lastFailedFingerprint || ''
     if (lastFp && a.lastRefusal && now() - (a.refusalTriedAt || a.lastRefusal.at) >= refusalRetryMinutes * 60000) { lastFp = ''; a.refusalTriedAt = now() }
-    const r = await deps.landIssue({ taskId: a.taskId, issue: { number: n, title: it.title }, lastFailedFingerprint: lastFp, allowUnreviewed })
+    let r = await deps.landIssue({ taskId: a.taskId, issue: { number: n, title: it.title }, lastFailedFingerprint: lastFp, allowUnreviewed })
+    // "OK" WITH NO PULL REQUEST IS A REFUSAL, whatever landIssue this is (10 Nov 2026). Issue #10
+    // came back ok with pr = null: this said "issue #10 landed as PR #undefined" in the room and on
+    // the issue, marked it landed and stored openPr = 0, with nothing pushed. hive-room-mode.js
+    // refuses that itself now (Q588, Q589); this is the same rule where the number is printed. A
+    // review fix is sent for a pull request that already exists (a.pr), so it is not judged here.
+    if (r && r.ok && a.kind !== 'review' && !(r.pr && r.pr.number)) {
+      r = { ok: false, code: 'Q589', why: `the landing reported success but opened no pull request${r.why ? ` (${oneLine(r.why, 200)})` : ''}.`, fingerprint: r.fingerprint || '', state: r.state }
+    }
     if (r && !r.ok && r.blocked === 'unreviewed') {
       if (!a.unreviewedSince && !a.unreviewedSaid) {
         a.unreviewedSince = now()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hivecode-mcp",
-  "version": "0.14.5",
+  "version": "0.14.7",
   "description": "MCP server that lets any AI coding agent join a Hivecode room — humans and multiple AI agents edit one live codebase with folder-scoped permissions and approval gates.",
   "type": "module",
   "license": "MIT",