@rubytech/create-maxy-code 0.1.482 → 0.1.484

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rubytech/create-maxy-code",
-  "version": "0.1.482",
+  "version": "0.1.484",
   "description": "Install Maxy — AI for Productive People",
   "bin": {
     "create-maxy-code": "./dist/index.js"

package/payload/platform/package-lock.json

@@ -577,6 +577,10 @@
       "resolved": "plugins/filesystem/mcp",
       "link": true
     },
+    "node_modules/@maxy/google": {
+      "resolved": "plugins/google/mcp",
+      "link": true
+    },
     "node_modules/@maxy/graph-viewer": {
       "resolved": "plugins/graph-viewer/mcp",
       "link": true
@@ -585,6 +589,10 @@
       "resolved": "plugins/joblogic/mcp",
       "link": true
     },
+    "node_modules/@maxy/ledger": {
+      "resolved": "plugins/ledger/mcp",
+      "link": true
+    },
     "node_modules/@maxy/memory": {
       "resolved": "plugins/memory/mcp",
       "link": true
@@ -609,6 +617,10 @@
       "resolved": "plugins/scheduling/mcp",
       "link": true
     },
+    "node_modules/@maxy/storage-broker": {
+      "resolved": "plugins/storage-broker/mcp",
+      "link": true
+    },
     "node_modules/@maxy/telegram-channel": {
       "resolved": "services/telegram-channel",
       "link": true
@@ -617,6 +629,10 @@
       "resolved": "plugins/url-get/mcp",
       "link": true
     },
+    "node_modules/@maxy/voice-mirror-mcp": {
+      "resolved": "plugins/voice-mirror/mcp",
+      "link": true
+    },
     "node_modules/@maxy/webchat-channel": {
       "resolved": "services/webchat-channel",
       "link": true
@@ -5618,7 +5634,211 @@
       },
       "devDependencies": {
         "@types/node": "^22.0.0",
-        "typescript": "^5.7.0"
+        "typescript": "^5.7.0",
+        "vitest": "^4.1.10"
+      }
+    },
+    "plugins/cloudflare/mcp/node_modules/@vitest/expect": {
+      "version": "4.1.10",
+      "resolved": "https://registry.npmjs.org/@vitest/expect/-/expect-4.1.10.tgz",
+      "integrity": "sha512-YsCn+qAk1GWjQOWFEsEcL2gNQ0zmVmQu3T03qP6UyjhtmdtwtbuI+DASn/7iQB3HGTXkdBwGddzxPlmiql5vlA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@standard-schema/spec": "^1.1.0",
+        "@types/chai": "^5.2.2",
+        "@vitest/spy": "4.1.10",
+        "@vitest/utils": "4.1.10",
+        "chai": "^6.2.2",
+        "tinyrainbow": "^3.1.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/vitest"
+      }
+    },
+    "plugins/cloudflare/mcp/node_modules/@vitest/pretty-format": {
+      "version": "4.1.10",
+      "resolved": "https://registry.npmjs.org/@vitest/pretty-format/-/pretty-format-4.1.10.tgz",
+      "integrity": "sha512-W1HsjSH4MXQ9YfmmhLAoIYf1HRfekQCGngeIgcei6MP5QQGWUe0gkopdZQaVCFO+JDJMrAJGwa5pRpNpvy4P8Q==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "tinyrainbow": "^3.1.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/vitest"
+      }
+    },
+    "plugins/cloudflare/mcp/node_modules/@vitest/runner": {
+      "version": "4.1.10",
+      "resolved": "https://registry.npmjs.org/@vitest/runner/-/runner-4.1.10.tgz",
+      "integrity": "sha512-IKI6kpIH+LmpROplyLwBBaCfMgOZOMsygVa6BARD6ahA04VRuJSa6OaVG7kRvSEMD870Vd91rSSw0eegtWyLGg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@vitest/utils": "4.1.10",
+        "pathe": "^2.0.3"
+      },
+      "funding": {
+        "url": "https://opencollective.com/vitest"
+      }
+    },
+    "plugins/cloudflare/mcp/node_modules/@vitest/snapshot": {
+      "version": "4.1.10",
+      "resolved": "https://registry.npmjs.org/@vitest/snapshot/-/snapshot-4.1.10.tgz",
+      "integrity": "sha512-xRkfOT1qpTAi/Ti4Y1LtfRc3kEuqxGw59eN2jN9pRWMtS/XDevekhcFSqvQqjUNGksfjMJu3Y+oJ+4Ypn2OaJw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@vitest/pretty-format": "4.1.10",
+        "@vitest/utils": "4.1.10",
+        "magic-string": "^0.30.21",
+        "pathe": "^2.0.3"
+      },
+      "funding": {
+        "url": "https://opencollective.com/vitest"
+      }
+    },
+    "plugins/cloudflare/mcp/node_modules/@vitest/spy": {
+      "version": "4.1.10",
+      "resolved": "https://registry.npmjs.org/@vitest/spy/-/spy-4.1.10.tgz",
+      "integrity": "sha512-PLf/Ugvoq5wO/b4rwYCR1h2PSIdXz7wnkQFMiUpLdtM7l6pqVFcQIBEHyT1+l+cj7mNwAfZHzqXqDyjvOuwbDw==",
+      "dev": true,
+      "license": "MIT",
+      "funding": {
+        "url": "https://opencollective.com/vitest"
+      }
+    },
+    "plugins/cloudflare/mcp/node_modules/@vitest/utils": {
+      "version": "4.1.10",
+      "resolved": "https://registry.npmjs.org/@vitest/utils/-/utils-4.1.10.tgz",
+      "integrity": "sha512-fy9am/HWxbaGt/Sawrp90vt6Y6jQwf1RX77cz3uwoJwJVMli/e1IEwRPnMNJ7vKfPTwo0diXifkpPvwH9v7nGA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@vitest/pretty-format": "4.1.10",
+        "convert-source-map": "^2.0.0",
+        "tinyrainbow": "^3.1.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/vitest"
+      }
+    },
+    "plugins/cloudflare/mcp/node_modules/vitest": {
+      "version": "4.1.10",
+      "resolved": "https://registry.npmjs.org/vitest/-/vitest-4.1.10.tgz",
+      "integrity": "sha512-R9jUTe5S4Qb0HCd4TNqpC7oGcrMssMRGXLW80ubjWsW9VH5GF8y1Y0SFLY9AbqSk6nt0PnOx4H4WNJYZ13GUPw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@vitest/expect": "4.1.10",
+        "@vitest/mocker": "4.1.10",
+        "@vitest/pretty-format": "4.1.10",
+        "@vitest/runner": "4.1.10",
+        "@vitest/snapshot": "4.1.10",
+        "@vitest/spy": "4.1.10",
+        "@vitest/utils": "4.1.10",
+        "es-module-lexer": "^2.0.0",
+        "expect-type": "^1.3.0",
+        "magic-string": "^0.30.21",
+        "obug": "^2.1.1",
+        "pathe": "^2.0.3",
+        "picomatch": "^4.0.3",
+        "std-env": "^4.0.0-rc.1",
+        "tinybench": "^2.9.0",
+        "tinyexec": "^1.0.2",
+        "tinyglobby": "^0.2.15",
+        "tinyrainbow": "^3.1.0",
+        "vite": "^6.0.0 || ^7.0.0 || ^8.0.0",
+        "why-is-node-running": "^2.3.0"
+      },
+      "bin": {
+        "vitest": "vitest.mjs"
+      },
+      "engines": {
+        "node": "^20.0.0 || ^22.0.0 || >=24.0.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/vitest"
+      },
+      "peerDependencies": {
+        "@edge-runtime/vm": "*",
+        "@opentelemetry/api": "^1.9.0",
+        "@types/node": "^20.0.0 || ^22.0.0 || >=24.0.0",
+        "@vitest/browser-playwright": "4.1.10",
+        "@vitest/browser-preview": "4.1.10",
+        "@vitest/browser-webdriverio": "4.1.10",
+        "@vitest/coverage-istanbul": "4.1.10",
+        "@vitest/coverage-v8": "4.1.10",
+        "@vitest/ui": "4.1.10",
+        "happy-dom": "*",
+        "jsdom": "*",
+        "vite": "^6.0.0 || ^7.0.0 || ^8.0.0"
+      },
+      "peerDependenciesMeta": {
+        "@edge-runtime/vm": {
+          "optional": true
+        },
+        "@opentelemetry/api": {
+          "optional": true
+        },
+        "@types/node": {
+          "optional": true
+        },
+        "@vitest/browser-playwright": {
+          "optional": true
+        },
+        "@vitest/browser-preview": {
+          "optional": true
+        },
+        "@vitest/browser-webdriverio": {
+          "optional": true
+        },
+        "@vitest/coverage-istanbul": {
+          "optional": true
+        },
+        "@vitest/coverage-v8": {
+          "optional": true
+        },
+        "@vitest/ui": {
+          "optional": true
+        },
+        "happy-dom": {
+          "optional": true
+        },
+        "jsdom": {
+          "optional": true
+        },
+        "vite": {
+          "optional": false
+        }
+      }
+    },
+    "plugins/cloudflare/mcp/node_modules/vitest/node_modules/@vitest/mocker": {
+      "version": "4.1.10",
+      "resolved": "https://registry.npmjs.org/@vitest/mocker/-/mocker-4.1.10.tgz",
+      "integrity": "sha512-v0xaezt+DKEmKfaxg133ldzADrwLGd7Ze1MfQQTYfvs8OqZIwbxyxaYURivwV7sWy5fqn3rH5uOrSp07bp44Ow==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@vitest/spy": "4.1.10",
+        "estree-walker": "^3.0.3",
+        "magic-string": "^0.30.21"
+      },
+      "funding": {
+        "url": "https://opencollective.com/vitest"
+      },
+      "peerDependencies": {
+        "msw": "^2.4.9",
+        "vite": "^6.0.0 || ^7.0.0 || ^8.0.0"
+      },
+      "peerDependenciesMeta": {
+        "msw": {
+          "optional": true
+        },
+        "vite": {
+          "optional": true
+        }
       }
     },
     "plugins/connector/mcp": {
@@ -6395,6 +6615,18 @@
         }
       }
     },
+    "plugins/google/mcp": {
+      "name": "@maxy/google",
+      "version": "0.1.0",
+      "dependencies": {
+        "@modelcontextprotocol/sdk": "^1.12.1",
+        "zod": "^3.24.0"
+      },
+      "devDependencies": {
+        "@types/node": "^22.0.0",
+        "typescript": "^5.7.0"
+      }
+    },
     "plugins/graph-viewer/mcp": {
       "name": "@maxy/graph-viewer",
       "version": "0.1.0",
@@ -6424,6 +6656,19 @@
         "typescript": "^5.7.0"
       }
     },
+    "plugins/ledger/mcp": {
+      "name": "@maxy/ledger",
+      "version": "0.1.0",
+      "dependencies": {
+        "@modelcontextprotocol/sdk": "^1.12.1",
+        "neo4j-driver": "^5.28.1"
+      },
+      "devDependencies": {
+        "@types/node": "^22.0.0",
+        "typescript": "^5.7.0",
+        "vitest": "^4.1.2"
+      }
+    },
     "plugins/memory/mcp": {
       "name": "@maxy/memory",
       "version": "0.1.0",
@@ -6491,6 +6736,19 @@
         "vitest": "^4.1.2"
       }
     },
+    "plugins/storage-broker/mcp": {
+      "name": "@maxy/storage-broker",
+      "version": "0.1.0",
+      "dependencies": {
+        "@modelcontextprotocol/sdk": "^1.12.1",
+        "zod": "^3.24.0"
+      },
+      "devDependencies": {
+        "@types/node": "^22.0.0",
+        "typescript": "^5.7.0",
+        "vitest": "^4.1.7"
+      }
+    },
     "plugins/tasks/mcp": {
       "name": "@maxy/tasks",
       "version": "0.1.0",
@@ -6531,6 +6789,18 @@
         "vitest": "^4.1.2"
       }
     },
+    "plugins/voice-mirror/mcp": {
+      "name": "@maxy/voice-mirror-mcp",
+      "version": "0.1.0",
+      "dependencies": {
+        "@modelcontextprotocol/sdk": "^1.12.1",
+        "neo4j-driver": "^5.28.1"
+      },
+      "devDependencies": {
+        "@types/node": "^22.0.0",
+        "typescript": "^5.7.0"
+      }
+    },
     "plugins/waitlist/mcp": {
       "name": "@maxy/waitlist",
       "version": "0.1.0",

package/payload/platform/plugins/admin/PLUGIN.md

@@ -169,6 +169,7 @@ Tools are available via the `admin` MCP server.
 | Set up business profile | Admin asks to set up, complete, or update business operational data | `skills/business-profile/SKILL.md` |
 | Generate a QR code | User asks to generate, create, or make a QR code from a URL, Wi-Fi details, contact, or text | `skills/qr-code/SKILL.md` |
 | Timezone queries | User asks for the time in another city, timezone conversion, UTC offset, or DST status | `skills/datetime/SKILL.md` |
+| What's new / release notes | User asks what's new, what changed, latest updates, recent changes, or how current their install is | `skills/whats-new/SKILL.md` |
 | Manage access grants | Admin asks to invite visitors, revoke or extend access, list who has access, or set an agent's access mode | `skills/access-manager/SKILL.md` |
 | Manage plugins and settings | User asks to install, enable, disable, or configure plugins, or change account settings | `skills/plugin-management/SKILL.md` |
 | Manage specialists | User asks to install or remove a specialist subagent, or activate/deactivate premium plugin agents | `skills/specialist-management/SKILL.md` |

package/payload/platform/plugins/admin/skills/platform-architecture/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: platform-architecture
 description: Use when grounding any documented-surface claim about what Maxy ships — plugins, skills, specialists, install/deploy flows, internals. This is the install catalogue, not evidence of what is enabled on the current account. For install state on this account, call `capabilities-here`; for documented surface, cite the `Source:` URL inline.
-content-hash: sha256:c7a28352289a7121b08a8d8f2d5bcb1e79497a6acda2e355756cf7b02051c3a5
+content-hash: sha256:103d5688cd9255611a9bf233effbaf7ffd8b45afa48b26d4f92b86febcfac1f5
 brand: maxy-code
 product-name: Maxy
 ---
@@ -2237,26 +2237,33 @@ force Google's annual third-party security assessment. Calendar is only a
 
 ## Connecting an account
 
-`google-account-register` returns a consent URL. Relay it to the user: they open
-it on any device, sign in, and approve.
-
-What happens next depends on where they approved.
-
-**If they approved on the machine this install runs on**, the connection
-completes by itself and their browser shows a page naming the connected account.
-Nothing is pasted. That page asks them to return to the chat and say so — do
-that, then call `google-account-register-poll` to confirm.
-
-**If they approved on another device**, such as a phone, their browser lands on
-a page that **fails to load**. That is expected, not a fault: the vendor app is
-a Desktop client, so Google redirects to a loopback address on the install, and
-a phone has no route to it. The address bar still carries the code. Ask them to
-copy the **whole URL** from the address bar and pass it to
-`google-account-register-submit`, which completes the connection.
-
-Paste the entire URL — the tool pulls the code out. A bare code, a `code=...`
-fragment, and a value containing `%2F` all work too.
-`google-account-register-poll` reports the outcome at any point.
+`google-account-register` resolves which of two routes applies to this install
+and returns one `instruction` field plus a `readback` directive. Relay the
+`instruction` to the user verbatim. Do not narrate both routes or decide between
+them yourself; the tool already chose.
+
+The two routes behind that resolution:
+
+**Auto-opened** (`path: "auto-open"`), when the install's own browser is
+reachable. Register opens the Google sign-in in it, so no link is handed over.
+The user signs in and approves there and the connection completes by itself. A
+backup link comes back in `consentUrl` for the rare case the page did not open
+in front of them.
+
+**Paste** (`path: "paste"`), when no on-host browser is reachable, such as a
+browserless brand or a phone. Register returns a consent URL to relay. The user
+opens it, signs in, and approves; the loopback page then fails to load, which is
+expected, because the vendor app is a Desktop client that redirects to a
+loopback address the device cannot reach. The address bar still carries the
+code, so they copy the whole URL from it and pass it to
+`google-account-register-submit`. The tool pulls the code out of a whole URL, a
+bare code, a `code=...` fragment, or a value containing `%2F`.
+
+Either way, read the outcome back with `google-account-register-poll`, per the
+result's `readback` field: `registered` names the connected email, `pending`
+means it has not completed, `expired` means the code timed out and register
+should be re-run. Do not tell the user they are connected before poll returns
+`registered`.
 
 The register tool does not block and does not wait. A second register while one
 is already live is refused rather than overwriting it; that refusal names how
@@ -3283,6 +3290,31 @@ documented in
 [`platform.md`](platform.md) "The Web Interface" — that paragraph is
 authoritative. This section names the surfaces and what backs each.
 
+> **Redesigned chrome.** The admin shell was rebuilt so the sidebar
+> owns all navigation; the full-width top header bar, the burger flyout, and the
+> "Powered by Claude Code" footer strip are retired. After the redesign:
+>
+> - **Nav rows** are Dashboard, Chat, Tasks, Calendar, Data, the brand container
+>   row (Projects / Properties / Jobs, opening the graph filtered to the brand's
+>   primary container), Activity, and Browser. The active row carries an accent
+>   left indicator. The older People / Agents / Artefacts entries in the table
+>   below are pre-redesign.
+> - **Dashboard home** renders on `/` (a greeting, stat cards, a Live-now column,
+>   a Recent artefacts card, and a Channels column), consuming existing endpoints
+>   only.
+> - **Per-surface header.** Each surface carries its own header (`PageHeader`):
+>   the sidebar collapse toggle, the page title, and a Claude status pill on the
+>   right (Connected / Connect, driven by `/api/health`). The pill replaces the
+>   retired burger Disconnect visibility and footer strip.
+> - **Account kebab.** The version / Connect-Disconnect / Change PIN / Switch
+>   account / Log out items moved from the burger onto a kebab on the sidebar user
+>   footer (`AccountMenu`, extracted from the old `HeaderMenu`; the operator
+>   variant still mounts `AccountMenu` for its reduced set).
+> - **Mobile (< 720px).** The sidebar opens as a drawer from a 44x44 header menu
+>   button, and a fixed bottom tab bar (Home, Chat, Tasks, Data, Calendar) sits
+>   under the content; Graph, Activity, and Browser stay reachable through the
+>   drawer. Between 721 and 1080px the sidebar defaults to the rail.
+
 > **Admin variant only.** Every surface below belongs to the `admin` shell
 > variant. The **operator** variant (`operator.<host>`) mounts no sidebar at
 > all: its dashboard is the persistent admin webchat at `/` and the data
@@ -3760,6 +3792,7 @@ If a session never runs an insight pass, its prose nodes are not lost — the ne
 | Person | AUTHORED | Report |
 | Person | AUTHORED | Page |
 | Person | AUTHORED | Note |
+| Person | AUTHORED | KnowledgeDocument |
 | KnowledgeDocument | ATTACHED_TO | Meeting |
 | Page | ATTACHED_TO | Project |
 | Note | ATTACHED_TO | Project |

package/payload/platform/plugins/admin/skills/whats-new/SKILL.md

@@ -0,0 +1,57 @@
+---
+name: whats-new
+description: "The platform's release notes: a dated, high-level timeline of the features and fixes that have shipped. Use when the operator asks what's new, what changed, what has been updated, latest updates, recent changes, release notes, or what the assistant can do now."
+---
+
+# What's new
+
+Invoked by the admin agent directly.
+
+This is the platform's release timeline, newest first. Each entry shows the date it shipped and the version it shipped in, so you can tell the operator how current their install is. To compare, read the installed version from `capabilities-here` and match it against the versions below. Keep answers high level and in plain English; this is a summary, not a full commit log.
+
+## 2026-07-21 (0.1.482)
+
+- WhatsApp now runs a separate connection for each client account, so one client's messages never mix with another's.
+- A client account can pair its own WhatsApp number, and the assistant can reply inside an existing WhatsApp thread on that number.
+
+## 2026-07-20 (0.1.481)
+
+- Data portal: a client can browse their whole folder tree, not just uploads, and download files held on the device through a private timed link.
+- The activity page was rebuilt as one card per live session, with a date-range filter and active-time for each session.
+- The tasks list now opens inside the admin screen instead of a separate view.
+- Incoming WhatsApp messages are now saved under the correct account.
+- Outlook sign-in is steadier: token refreshes no longer clash between processes.
+
+## 2026-07-11 (0.1.436)
+
+- Reading a WhatsApp history now finds the right account's conversations.
+
+## 2026-07-10 (0.1.427)
+
+- You can now reassign which team member manages a client account.
+- Time spent can be recorded against a task.
+- Email setup can point drafts at a chosen folder.
+
+## 2026-07-08 (0.1.414)
+
+- The client view now shows the account manager's WhatsApp threads alongside the rest.
+
+## 2026-07-05 (0.1.401)
+
+- Each brand now carries its own colour theme.
+- The chat box shows a Connect prompt when the assistant is offline, instead of failing silently.
+
+## 2026-07-01 (0.1.377)
+
+- The WhatsApp reader shows saved conversations even when nothing is in the live cache.
+
+## 2026-06-28 (0.1.370)
+
+- Public booking page: set how far ahead people can book, page through five days at a time, and allow back-to-back slots.
+- The admin calendar links straight to your public booking page.
+- Telegram is now a first-class channel, the same as WhatsApp and web chat.
+
+## 2026-06-18 (0.1.336)
+
+- Every operator-facing reply is now written in plain English.
+- Project guides added: stakeholder mapping, pre-mortem, prioritisation, and turning a meeting into tasks.

package/payload/platform/plugins/docs/references/admin-ui.md

@@ -393,6 +393,31 @@ documented in
 [`platform.md`](platform.md) "The Web Interface" — that paragraph is
 authoritative. This section names the surfaces and what backs each.
 
+> **Redesigned chrome.** The admin shell was rebuilt so the sidebar
+> owns all navigation; the full-width top header bar, the burger flyout, and the
+> "Powered by Claude Code" footer strip are retired. After the redesign:
+>
+> - **Nav rows** are Dashboard, Chat, Tasks, Calendar, Data, the brand container
+>   row (Projects / Properties / Jobs, opening the graph filtered to the brand's
+>   primary container), Activity, and Browser. The active row carries an accent
+>   left indicator. The older People / Agents / Artefacts entries in the table
+>   below are pre-redesign.
+> - **Dashboard home** renders on `/` (a greeting, stat cards, a Live-now column,
+>   a Recent artefacts card, and a Channels column), consuming existing endpoints
+>   only.
+> - **Per-surface header.** Each surface carries its own header (`PageHeader`):
+>   the sidebar collapse toggle, the page title, and a Claude status pill on the
+>   right (Connected / Connect, driven by `/api/health`). The pill replaces the
+>   retired burger Disconnect visibility and footer strip.
+> - **Account kebab.** The version / Connect-Disconnect / Change PIN / Switch
+>   account / Log out items moved from the burger onto a kebab on the sidebar user
+>   footer (`AccountMenu`, extracted from the old `HeaderMenu`; the operator
+>   variant still mounts `AccountMenu` for its reduced set).
+> - **Mobile (< 720px).** The sidebar opens as a drawer from a 44x44 header menu
+>   button, and a fixed bottom tab bar (Home, Chat, Tasks, Data, Calendar) sits
+>   under the content; Graph, Activity, and Browser stay reachable through the
+>   drawer. Between 721 and 1080px the sidebar defaults to the rail.
+
 > **Admin variant only.** Every surface below belongs to the `admin` shell
 > variant. The **operator** variant (`operator.<host>`) mounts no sidebar at
 > all: its dashboard is the persistent admin webchat at `/` and the data

package/payload/platform/plugins/docs/references/google-guide.md

@@ -11,26 +11,33 @@ force Google's annual third-party security assessment. Calendar is only a
 
 ## Connecting an account
 
-`google-account-register` returns a consent URL. Relay it to the user: they open
-it on any device, sign in, and approve.
-
-What happens next depends on where they approved.
-
-**If they approved on the machine this install runs on**, the connection
-completes by itself and their browser shows a page naming the connected account.
-Nothing is pasted. That page asks them to return to the chat and say so — do
-that, then call `google-account-register-poll` to confirm.
-
-**If they approved on another device**, such as a phone, their browser lands on
-a page that **fails to load**. That is expected, not a fault: the vendor app is
-a Desktop client, so Google redirects to a loopback address on the install, and
-a phone has no route to it. The address bar still carries the code. Ask them to
-copy the **whole URL** from the address bar and pass it to
-`google-account-register-submit`, which completes the connection.
-
-Paste the entire URL — the tool pulls the code out. A bare code, a `code=...`
-fragment, and a value containing `%2F` all work too.
-`google-account-register-poll` reports the outcome at any point.
+`google-account-register` resolves which of two routes applies to this install
+and returns one `instruction` field plus a `readback` directive. Relay the
+`instruction` to the user verbatim. Do not narrate both routes or decide between
+them yourself; the tool already chose.
+
+The two routes behind that resolution:
+
+**Auto-opened** (`path: "auto-open"`), when the install's own browser is
+reachable. Register opens the Google sign-in in it, so no link is handed over.
+The user signs in and approves there and the connection completes by itself. A
+backup link comes back in `consentUrl` for the rare case the page did not open
+in front of them.
+
+**Paste** (`path: "paste"`), when no on-host browser is reachable, such as a
+browserless brand or a phone. Register returns a consent URL to relay. The user
+opens it, signs in, and approves; the loopback page then fails to load, which is
+expected, because the vendor app is a Desktop client that redirects to a
+loopback address the device cannot reach. The address bar still carries the
+code, so they copy the whole URL from it and pass it to
+`google-account-register-submit`. The tool pulls the code out of a whole URL, a
+bare code, a `code=...` fragment, or a value containing `%2F`.
+
+Either way, read the outcome back with `google-account-register-poll`, per the
+result's `readback` field: `registered` names the connected email, `pending`
+means it has not completed, `expired` means the code timed out and register
+should be re-run. Do not tell the user they are connected before poll returns
+`registered`.
 
 The register tool does not block and does not wait. A second register while one
 is already live is refused rather than overwriting it; that refusal names how

package/payload/platform/plugins/docs/references/neo4j.md

@@ -55,6 +55,7 @@ If a session never runs an insight pass, its prose nodes are not lost — the ne
 | Person | AUTHORED | Report |
 | Person | AUTHORED | Page |
 | Person | AUTHORED | Note |
+| Person | AUTHORED | KnowledgeDocument |
 | KnowledgeDocument | ATTACHED_TO | Meeting |
 | Page | ATTACHED_TO | Project |
 | Note | ATTACHED_TO | Project |