memhouse 0.11.0 → 0.11.2

package/README.md

@@ -237,6 +237,27 @@ an old house cannot be corrupted by a new shipper. `memhouse migrate-rooms` rebu
 copy, atomic swap, and the old room kept as `<room>_pre_epoch` for you to drop. The house
 records the move in `house_events`, and `memhouse doctor` reads it back.
 
+## Upgrading
+
+`memhouse update` upgrades the code, restarts the daemons, and — from 0.10.0 onward —
+detects a schema migration the house needs and prompts to run it.
+
+**One exception: upgrading from 0.9.x.** That release predates migrations, and `update`
+runs the *old* version's code (it replaces itself mid-run), so it cannot prompt. After
+the upgrade the first ship refuses (nothing is lost) and tells you the one command to
+run by hand:
+
+```bash
+memhouse update      # installs the new version, refuses to ship the old-schema house
+memhouse migrate     # the one-time rebuild it named — copy + atomic swap, nothing deleted
+memhouse doctor      # every line a check mark
+```
+
+If other machines ship into the same house as the same member, upgrade them too — a
+pre-0.10 shipper still deletes-before-reinsert; `memhouse doctor` flags any that are
+behind, and prints the `REVOKE ALTER DELETE, ALTER UPDATE` fallback that stops them
+destructively until you can.
+
 ## Troubleshooting
 
 ### An editor reads zero sessions

package/bin/memhouse.js

@@ -1607,7 +1607,7 @@ async function cmdDoctor() {
       } else {
         keysCorrect = wrongKeys.length === 0;
         add(keysCorrect, `sorting keys${keysCorrect ? ` carry origin and epoch correctly (${checked}/${ROOM_TYPES.length} rooms)` : `: wrong on ${wrongKeys.join(', ')}`}`,
-          'those rooms predate the epoch key, so the shipper refuses to write into them.\n     rebuild them (nothing is deleted): memhouse migrate-rooms');
+          'those rooms predate the epoch key, so the shipper refuses to write into them.\n     rebuild them (nothing is deleted): memhouse migrate');
       }
     } catch (e) { add(false, 'sorting keys', e.message); }
     // What the house says about ITSELF — its schema generation and whether a rebuild was

package/memhouse/delivery/plugin/skills/hello/SKILL.md

@@ -34,6 +34,25 @@ fi
 
 (Do not print the env values, and do not narrate that you are withholding them — just use them.)
 
+## What memhouse is — the overview (give this in every state, before the tour)
+
+One paragraph, grounded not sold: **memhouse is your personal, permanent archive of every
+AI coding session.** A background shipper reads the session files your editors write —
+Claude Code, Codex, Cursor, VS Code, Zed, OpenCode, Gemini CLI and 10 more, 17 in all —
+and ships them into a ClickHouse database you own, called a **house**. YOU choose that
+ClickHouse: a local one on your laptop, one on your own VM, or any ClickHouse server you
+control — managed or remote. memhouse itself is not a hosted service and phones nothing
+home; your sessions go only to the house you point it at, and it runs no LLM in its write
+or read path — it stores rows, the agent reading them (this chat) does the thinking. It
+outlives the transcripts on disk: editors compact and delete their local session files
+after weeks, so for anything older than ~30 days the house is the only place it still
+exists. One archive spans every editor, every project, every machine you ship from.
+
+What it gives you, in one breath: **ask** your own history a question and get a cited
+answer, **search** for the session you half-remember, **query** the raw data for numbers,
+browse a **dashboard**, and **invite** other people onto your ClickHouse so memories can be
+**shared** read-only. The tour below names each.
+
 ## Then introduce it — three states, three openings
 
 **Configured and answering** — open with the numbers: "Your memory holds N sessions
@@ -61,6 +80,12 @@ What you can DO from this chat:
 - `/mem:sql <question or SQL>` — ad-hoc analytics (tokens, costs, rankings)
 - `/mem:status` — is it healthy, how much is stored, which machines ship into it
 
+The first three overlap — same words work in each — so give the reader the rule that
+separates them: **want a session → search. Want an answer → ask. Want a number → sql.**
+`ask` runs a `search` first, then reads the turns it finds and writes you a cited answer;
+`search` stops at the ranked list of sessions; `sql` counts and aggregates the columns
+rather than hunting text.
+
 And around other people — **inviting comes before sharing**:
 
 - `/mem:invite <name>` — mint a friend's account + their own house on your ClickHouse,

package/memhouse/shipper/ship.js

@@ -387,13 +387,15 @@ async function assertRoomKeys(client, rooms) {
   }
   if (wrong.length) {
     throw new Error(
-      'these rooms have the wrong sorting key, so a ship pass would corrupt them:\n'
+      'this house needs a one-time migration before it can be shipped to. Run:\n'
+      + '\n    memhouse migrate\n'
+      + '\n  (an upgrade from a pre-0.10 memhouse cannot prompt for this itself — the old\n'
+      + '  `update` command predates migrations, so run the line above once, by hand.)\n'
+      + '\n  Why: these rooms have the wrong sorting key, so a ship pass would corrupt them:\n'
       + wrong.map((s) => `    ${s}`).join('\n')
-      + '\n  ORDER BY cannot be altered in place — the rooms have to be rebuilt:'
-      + '\n    memhouse migrate-rooms'
-      + '\n  It copies each room into one with the current key, swaps them atomically, and'
-      + '\n  keeps the old one as <room>_pre_epoch for you to drop. Nothing is deleted.'
-      + '\n  A house with no imported rows can also just be re-shipped from scratch.');
+      + '\n  ORDER BY cannot be altered in place, so migrate copies each room into one with\n'
+      + '  the current key, swaps them atomically, and keeps the old one as <room>_pre_epoch\n'
+      + '  for you to drop. Nothing is deleted.');
   }
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "memhouse",
-  "version": "0.11.0",
+  "version": "0.11.2",
   "description": "memhouse — agent conversation memory across 17 editors: parse-on-client shippers, a typed ClickHouse store with one set of rooms per member, kernel-agency install, and the agentlytics dashboard",
   "main": "bin/memhouse.js",
   "bin": {