wikimemory 0.2.10 → 0.2.12

package/README.md

@@ -44,8 +44,9 @@ npx wikimemory install
 
 The installer previews the exact Cloudflare account, Worker, D1 database
 (Cloudflare's managed SQLite), and OAuth/session store before creating anything.
-Open its one-time URL to register the owner passkey, then connect a client and install
-its memory skills:
+Open its one-time URL to register the owner passkey. The installer also prints the
+exact `/mcp` URL to paste into clients that require manual connector setup. Then
+connect a command-line client and install its memory skills:
 
 ```sh
 npx wikimemory connect codex
@@ -56,9 +57,20 @@ npx wikimemory connect claude
 npx wikimemory skills install claude
 ```
 
-Use the same remote MCP from Claude web or mobile by adding the printed HTTPS `/mcp`
-URL as a custom connector. See the complete [installation guide](docs/installation.md)
-for recovery, passkey management, upgrades, and safe uninstall.
+To use Wikimemory on a phone, first add the HTTPS `/mcp` URL printed by the installer
+or by `npx wikimemory status`:
+
+Use the complete URL, including `/mcp`. The deployment root opens the Wikimemory web
+application and is not an MCP endpoint.
+
+- **Claude:** add it as a custom connector in Claude's web settings. It then appears
+  in Claude mobile.
+- **ChatGPT:** enable developer mode on ChatGPT web, create an app using the `/mcp`
+  URL under **Settings → Plugins**, and finish passkey authorization. The app then
+  appears in ChatGPT mobile.
+
+See the complete [installation guide](docs/installation.md) for detailed connection
+steps, recovery, passkey management, upgrades, and safe uninstall.
 
 ## Run locally
 
@@ -75,6 +87,7 @@ and MCP transport remain real.
 
 ```sh
 npx wikimemory status
+npx wikimemory browse
 npx wikimemory upgrade
 npx wikimemory recover
 npx wikimemory passkeys list

package/dist/npm-cli/scripts/browse.js

@@ -0,0 +1,27 @@
+import { spawn } from "node:child_process";
+import process from "node:process";
+import { deploymentRecordPath, readDeploymentRecord } from "./deployment-record.js";
+export function webAppUrl(origin) {
+    return new URL("/", origin).toString();
+}
+export function browserCommand(url, platform = process.platform) {
+    if (platform === "darwin")
+        return { executable: "open", args: [url] };
+    if (platform === "win32")
+        return { executable: "rundll32", args: ["url.dll,FileProtocolHandler", url] };
+    return { executable: "xdg-open", args: [url] };
+}
+export function openBrowser(url) {
+    const invocation = browserCommand(url);
+    const child = spawn(invocation.executable, invocation.args, {
+        detached: true,
+        stdio: "ignore"
+    });
+    child.unref();
+}
+export async function runBrowse(deployment) {
+    const record = await readDeploymentRecord(deploymentRecordPath(deployment));
+    const url = webAppUrl(record.origin);
+    openBrowser(url);
+    console.log(`Opened Wikimemory web app:\n${url}`);
+}

package/dist/npm-cli/scripts/cli.js

@@ -8,7 +8,7 @@ import { packageRoot } from "./package-root.js";
 import { conciseError } from "./subprocess.js";
 const [command, ...args] = process.argv.slice(2);
 function usage() {
-    return `Wikimemory ${WIKIMEMORY_VERSION}\nPersonal, passkey-protected memory for Claude, Codex, and other MCP clients.\n\nUsage: wikimemory COMMAND [OPTIONS]\n\nStart a personal Cloudflare-hosted instance:\n  npx wikimemory install\n\nTry it locally without a Cloudflare deployment:\n  npx wikimemory dev\n\nCommands:\n  wikimemory install [--deployment NAME] [installer options]\n  wikimemory recover [--deployment NAME]\n  wikimemory dev [wrangler dev options]\n  wikimemory status [--deployment NAME]\n  wikimemory upgrade [--deployment NAME] [--yes]\n  wikimemory passkeys [--deployment NAME] list|add|revoke\n  wikimemory connect [--deployment NAME] codex|claude\n  wikimemory skills install codex|claude\n  wikimemory uninstall [--deployment NAME] [--apply]\n  wikimemory --version\n\nUse \`wikimemory COMMAND --help\` for command-specific options.`;
+    return `Wikimemory ${WIKIMEMORY_VERSION}\nPersonal, passkey-protected memory for Claude, Codex, and other MCP clients.\n\nUsage: wikimemory COMMAND [OPTIONS]\n\nStart a personal Cloudflare-hosted instance:\n  npx wikimemory install\n\nTry it locally without a Cloudflare deployment:\n  npx wikimemory dev\n\nCommands:\n  wikimemory install [--deployment NAME] [installer options]\n  wikimemory recover [--deployment NAME]\n  wikimemory dev [wrangler dev options]\n  wikimemory status [--deployment NAME]\n  wikimemory browse [--deployment NAME]\n  wikimemory upgrade [--deployment NAME] [--yes]\n  wikimemory passkeys [--deployment NAME] list|add|revoke\n  wikimemory connect [--deployment NAME] codex|claude\n  wikimemory skills install codex|claude\n  wikimemory uninstall [--deployment NAME] [--apply]\n  wikimemory --version\n\nUse \`wikimemory COMMAND --help\` for command-specific options.`;
 }
 async function main() {
     if (command === undefined || command === "--help" || command === "help") {
@@ -37,6 +37,7 @@ async function main() {
     const requiresInstalledDeployment = !parsed.remaining.includes("--help") &&
         (command === "recover" ||
             command === "status" ||
+            command === "browse" ||
             command === "passkeys" ||
             command === "connect" ||
             command === "uninstall" ||
@@ -66,6 +67,16 @@ async function main() {
         const { runStatus } = await import("./status.js");
         await runStatus(parsed.deployment);
     }
+    else if (command === "browse") {
+        if (parsed.remaining.length === 1 && parsed.remaining[0] === "--help") {
+            console.log("Usage: wikimemory browse [--deployment NAME]");
+            return;
+        }
+        if (parsed.remaining.length !== 0)
+            throw new Error("Usage: wikimemory browse [--deployment NAME]");
+        const { runBrowse } = await import("./browse.js");
+        await runBrowse(parsed.deployment);
+    }
     else if (command === "passkeys") {
         process.env["WIKIMEMORY_STATE_DIR"] = paths.directory;
         process.env["WIKIMEMORY_PACKAGED"] = "1";

package/dist/npm-cli/scripts/client-tools.js

@@ -1,8 +1,14 @@
-import { cp, mkdir } from "node:fs/promises";
+import { cp, mkdir, mkdtemp, rename, rm } from "node:fs/promises";
 import { homedir } from "node:os";
 import { join } from "node:path";
 import { deploymentRecordPath, readDeploymentRecord } from "./deployment-record.js";
 import { commandFailureMessage, runCommand } from "./subprocess.js";
+const SKILL_NAMES = [
+    "wikimemory-recall",
+    "wikimemory-ingest",
+    "wikimemory-lint",
+    "wikimemory-install"
+];
 function client(value) {
     if (value === "codex" || value === "claude")
         return value;
@@ -15,6 +21,69 @@ async function run(command, args, interactive = false) {
     if (result.exitCode !== 0)
         throw new Error(commandFailureMessage(`${command} client configuration`, result));
 }
+function errorCode(error) {
+    if (typeof error !== "object" || error === null)
+        return undefined;
+    return Reflect.get(error, "code");
+}
+async function moveIfPresent(source, destination) {
+    try {
+        await rename(source, destination);
+        return true;
+    }
+    catch (error) {
+        if (errorCode(error) === "ENOENT")
+            return false;
+        throw error;
+    }
+}
+export async function replaceSkillDirectories(packageRoot, destinationRoot, names) {
+    await mkdir(destinationRoot, { recursive: true, mode: 0o700 });
+    const stagingRoot = await mkdtemp(join(destinationRoot, ".wikimemory-install-"));
+    const incomingRoot = join(stagingRoot, "incoming");
+    const replacedRoot = join(stagingRoot, "replaced");
+    const installed = [];
+    try {
+        await mkdir(incomingRoot);
+        await mkdir(replacedRoot);
+        for (const name of names) {
+            if (!/^wikimemory-[a-z0-9-]+$/u.test(name))
+                throw new Error(`Invalid skill name: ${name}`);
+            await cp(join(packageRoot, "skills", name), join(incomingRoot, name), {
+                recursive: true,
+                force: false,
+                errorOnExist: true
+            });
+        }
+        try {
+            for (const name of names) {
+                const destination = join(destinationRoot, name);
+                const backup = join(replacedRoot, name);
+                const hadExisting = await moveIfPresent(destination, backup);
+                try {
+                    await rename(join(incomingRoot, name), destination);
+                }
+                catch (error) {
+                    if (hadExisting)
+                        await rename(backup, destination);
+                    throw error;
+                }
+                installed.push({ destination, backup, hadExisting });
+            }
+        }
+        catch (error) {
+            for (const item of installed.reverse()) {
+                await rm(item.destination, { recursive: true, force: true });
+                if (item.hadExisting)
+                    await rename(item.backup, item.destination);
+            }
+            throw error;
+        }
+    }
+    finally {
+        await rm(stagingRoot, { recursive: true, force: true });
+    }
+}
 export async function connectClient(deployment, selected) {
     const target = client(selected);
     const record = await readDeploymentRecord(deploymentRecordPath(deployment));
@@ -43,13 +112,6 @@ export async function connectClient(deployment, selected) {
 export async function installSkills(packageRoot, selected) {
     const target = client(selected);
     const destinationRoot = join(homedir(), target === "codex" ? ".codex" : ".claude", "skills");
-    await mkdir(destinationRoot, { recursive: true, mode: 0o700 });
-    const names = ["wikimemory-recall", "wikimemory-ingest", "wikimemory-lint", "wikimemory-install"];
-    for (const name of names) {
-        await cp(join(packageRoot, "skills", name), join(destinationRoot, name), {
-            recursive: true,
-            force: true
-        });
-    }
-    console.log(`Installed ${names.length} Wikimemory skills for ${target}. Restart the client.`);
+    await replaceSkillDirectories(packageRoot, destinationRoot, SKILL_NAMES);
+    console.log(`Installed ${SKILL_NAMES.length} Wikimemory skills for ${target}. Restart the client.`);
 }

package/dist/npm-cli/scripts/passkeys.js

@@ -1,10 +1,9 @@
-import { spawn } from "node:child_process";
 import { createHash, randomBytes } from "node:crypto";
 import { readFile, writeFile } from "node:fs/promises";
 import { createServer } from "node:http";
-import process from "node:process";
 import { pathToFileURL } from "node:url";
 import { z } from "zod";
+import { openBrowser } from "./browse.js";
 import { passkeyRuntime } from "./lifecycle-runtime.js";
 import { configuredOrigin } from "./setup.js";
 import { conciseError } from "./subprocess.js";
@@ -71,13 +70,6 @@ async function clientId(origin) {
     });
     return registered.client_id;
 }
-function openBrowser(url) {
-    const platform = process.platform;
-    const executable = platform === "darwin" ? "open" : platform === "win32" ? "cmd" : "xdg-open";
-    const args = platform === "win32" ? ["/c", "start", "", url] : [url];
-    const child = spawn(executable, args, { detached: true, stdio: "ignore" });
-    child.unref();
-}
 async function authorizationCode(authorizeUrl, expectedState) {
     return await new Promise((resolve, reject) => {
         const server = createServer((request, response) => {

package/dist/npm-cli/scripts/setup.js

@@ -348,7 +348,7 @@ export async function verifyEndpoint(origin, path, expectedStatus, fetcher = fet
 }
 export function handoff(origin, rawToken, deploymentName) {
     const endpoint = `${origin}/mcp`;
-    return `Wikimemory is ready for owner setup.\n\nOpen this one-time URL on a device that can create a passkey:\n${origin}/setup#${encodeURIComponent(rawToken)}\n\nAfter setup, connect clients with:\n  npx wikimemory connect --deployment ${deploymentName} codex\n  npx wikimemory connect --deployment ${deploymentName} claude\n\nMCP endpoint: ${endpoint}\nThe setup token was not written to disk. This is the only time it will be printed.`;
+    return `Wikimemory is ready for owner setup.\n\nOpen this one-time URL on a device that can create a passkey:\n${origin}/setup#${encodeURIComponent(rawToken)}\n\nAfter setup, connect clients with:\n  npx wikimemory connect --deployment ${deploymentName} codex\n  npx wikimemory connect --deployment ${deploymentName} claude\n\nManual connector: paste this exact URL into Claude, ChatGPT, or another MCP client:\n${endpoint}\nThe setup token was not written to disk. This is the only time it will be printed.`;
 }
 async function remoteWorkerExists(workerName) {
     const result = await run("npx", ["wrangler", "deployments", "list", "--name", workerName, "--json", "--config", CONFIG_PATH], undefined, true);

package/dist/npm-cli/scripts/status.js

@@ -49,8 +49,10 @@ export async function runStatus(deployment) {
     console.log(statusSummary(status));
 }
 export function statusSummary(status) {
+    const webApp = new URL("/", status.origin).toString();
+    const mcpEndpoint = new URL("/mcp", status.origin).toString();
     const mismatch = status.recordedVersion === status.runningVersion
         ? ""
         : `\nLocal record: ${status.recordedVersion} (run wikimemory upgrade to reconcile)`;
-    return `Wikimemory ${status.deployment}: ready\nURL: ${status.origin}\nVersion: ${status.runningVersion}\nDatabase: up to date.${mismatch}`;
+    return `Wikimemory ${status.deployment}: ready\nWeb app: ${webApp}\nMCP endpoint: ${mcpEndpoint}\nVersion: ${status.runningVersion}\nDatabase: up to date.${mismatch}`;
 }

package/dist/npm-cli/src/version.js

@@ -1,2 +1,2 @@
-export const WIKIMEMORY_VERSION = "0.2.10";
+export const WIKIMEMORY_VERSION = "0.2.12";
 export const LATEST_SCHEMA_VERSION = "0004_credential_bound_registration_tokens.sql";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wikimemory",
-  "version": "0.2.10",
+  "version": "0.2.12",
   "description": "Personal, passkey-protected memory for Claude, Codex, and other MCP clients",
   "license": "MIT",
   "repository": {
@@ -43,7 +43,7 @@
     "deploy": "wrangler deploy --config wrangler.production.jsonc",
     "test": "vitest run && npm run test:installer",
     "test:coverage": "vitest run --coverage.enabled",
-    "test:installer": "node --experimental-strip-types --experimental-test-coverage --test-coverage-include=scripts/setup.ts --test-coverage-include=scripts/uninstall.ts --test-coverage-lines=50 --test-coverage-branches=70 --test-coverage-functions=60 --test scripts/setup.node-test.ts scripts/upgrade.node-test.ts",
+    "test:installer": "node --experimental-strip-types --experimental-test-coverage --test-coverage-include=scripts/setup.ts --test-coverage-include=scripts/uninstall.ts --test-coverage-lines=50 --test-coverage-branches=70 --test-coverage-functions=60 --test scripts/browse.node-test.ts scripts/client-tools.node-test.ts scripts/setup.node-test.ts scripts/upgrade.node-test.ts",
     "test:package": "node --experimental-strip-types scripts/package-smoke.ts",
     "test:passkey": "node --experimental-strip-types scripts/passkey-e2e.ts",
     "test:watch": "vitest",

package/release-manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.2.10",
+  "version": "0.2.12",
   "schemaVersion": "0004_credential_bound_registration_tokens.sql",
   "migrations": [
     {

package/src/mcp/server.ts

@@ -57,8 +57,11 @@ function textContent(text: string): { type: "text"; text: string } {
 }
 
 function toolResult<T extends Record<string, unknown>>(value: T, message: string) {
+  // content[0] is the human-readable summary. content[1] is the MCP-recommended
+  // serialized fallback for clients that do not surface structuredContent.
+  // storedDataResult adds explicit untrusted-data framing to both representations.
   return {
-    content: [textContent(message)],
+    content: [textContent(message), textContent(JSON.stringify(value))],
     structuredContent: value
   };
 }

package/src/version.ts

@@ -1,2 +1,2 @@
-export const WIKIMEMORY_VERSION = "0.2.10";
+export const WIKIMEMORY_VERSION = "0.2.12";
 export const LATEST_SCHEMA_VERSION = "0004_credential_bound_registration_tokens.sql";