@pcircle/memesh 4.8.2 → 4.8.5

package/dist/transports/agent-messaging.d.ts

@@ -1,11 +1,20 @@
 import { z } from 'zod';
 import type { MemeshDatabase } from '../storage/sqlite.js';
+import { AgentMessagingError } from '../core/agent-messaging.js';
 import { MessageSchema } from './schemas.js';
+import { sendAgentRouterRequest } from '../core/agent-router.js';
 export type AgentMessageActionInput = z.infer<typeof MessageSchema>;
 export interface AgentMessageTransportContext {
     transport: 'cli' | 'http' | 'mcp';
     sourceHost: string;
     signal?: AbortSignal;
 }
-export declare function executeAgentMessageAction(db: MemeshDatabase, rawInput: unknown, context: AgentMessageTransportContext): Promise<unknown>;
+export interface AgentMessageTransportDependencies {
+    sendRouterRequest?: typeof sendAgentRouterRequest;
+}
+export declare class AgentRecipientUnavailableError extends AgentMessagingError {
+    readonly code = "recipient_unavailable";
+    constructor();
+}
+export declare function executeAgentMessageAction(db: MemeshDatabase, rawInput: unknown, context: AgentMessageTransportContext, dependencies?: AgentMessageTransportDependencies): Promise<unknown>;
 //# sourceMappingURL=agent-messaging.d.ts.map

package/dist/transports/agent-messaging.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-messaging.d.ts","sourceRoot":"","sources":["../../src/transports/agent-messaging.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAe3D,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAK7C,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAEpE,MAAM,WAAW,4BAA4B;IAC3C,SAAS,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,CAAC;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAsSD,wBAAsB,yBAAyB,CAC7C,EAAE,EAAE,cAAc,EAClB,QAAQ,EAAE,OAAO,EACjB,OAAO,EAAE,4BAA4B,GACpC,OAAO,CAAC,OAAO,CAAC,CAmElB"}
+{"version":3,"file":"agent-messaging.d.ts","sourceRoot":"","sources":["../../src/transports/agent-messaging.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAEL,mBAAmB,EAYpB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAEL,sBAAsB,EAGvB,MAAM,yBAAyB,CAAC;AAGjC,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAEpE,MAAM,WAAW,4BAA4B;IAC3C,SAAS,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,CAAC;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,iCAAiC;IAChD,iBAAiB,CAAC,EAAE,OAAO,sBAAsB,CAAC;CACnD;AAED,qBAAa,8BAA+B,SAAQ,mBAAmB;IACrE,QAAQ,CAAC,IAAI,2BAA2B;;CAKzC;AA4WD,wBAAsB,yBAAyB,CAC7C,EAAE,EAAE,cAAc,EAClB,QAAQ,EAAE,OAAO,EACjB,OAAO,EAAE,4BAA4B,EACrC,YAAY,GAAE,iCAAsC,GACnD,OAAO,CAAC,OAAO,CAAC,CAyFlB"}

package/dist/transports/agent-messaging.js

@@ -1,9 +1,17 @@
-import { AgentMessageAccessError, AgentMessagingError, fetchAgentMessage, pollAgentEvents, readAgentMessageReceipts, recordAgentReceipt, sendAgentMessage, waitForAgentEvents, } from '../core/agent-messaging.js';
+import { randomUUID } from 'node:crypto';
+import path from 'node:path';
+import { AgentMessageAccessError, AgentMessagingError, AgentNativeMessageTooLargeError, fetchAgentMessage, pollAgentEvents, readAgentMessageReceipts, recordAgentReceipt, sendAgentMessage, waitForAgentEvents, } from '../core/agent-messaging.js';
 import { MessageSchema } from './schemas.js';
-import { createAgentRouterNotifier } from '../core/agent-router.js';
+import { createAgentRouterNotifier, sendAgentRouterRequest, } from '../core/agent-router.js';
 import { getMemeshDirFromDbPath } from '../core/paths.js';
-import path from 'node:path';
+export class AgentRecipientUnavailableError extends AgentMessagingError {
+    code = 'recipient_unavailable';
+    constructor() {
+        super('recipient_unavailable: the exact active session did not accept the native message.');
+    }
+}
 const AGENT_MESSAGE_STORAGE_QUOTA_ENV = 'MEMESH_AGENT_MESSAGE_STORAGE_QUOTA_BYTES';
+const EXACT_SESSION_NATIVE_TIMEOUT_MS = 12_000;
 const PUBLIC_DISPOSITIONS = new Set(['accepted', 'rejected', 'completed', 'cancelled', 'deferred']);
 function configuredAgentMessageStorageQuotaBytes() {
     const raw = process.env[AGENT_MESSAGE_STORAGE_QUOTA_ENV];
@@ -18,15 +26,72 @@ function configuredAgentMessageStorageQuotaBytes() {
     }
     return parsed;
 }
+function routerSocketPath() {
+    return process.env.MEMESH_ROUTER_SOCKET
+        ?? path.join(getMemeshDirFromDbPath(), 'agent-router.sock');
+}
 function optionalRouterNotifier() {
     try {
-        return createAgentRouterNotifier(process.env.MEMESH_ROUTER_SOCKET
-            ?? path.join(getMemeshDirFromDbPath(), 'agent-router.sock'));
+        return createAgentRouterNotifier(routerSocketPath());
     }
     catch {
         return undefined;
     }
 }
+function nativeAcceptance(row) {
+    return {
+        status: 'native_accepted',
+        delivery_id: row.delivery_id,
+        adapter_kind: row.adapter_kind,
+        receipt: parseStoredObject(row.receipt_json, 'agent_host_accepts.receipt_json'),
+        accepted_at: row.created_at,
+    };
+}
+async function requireExactSessionNativeAcceptance(db, sent, dependencies) {
+    const existing = readHostAccept(db, sent.delivery_id);
+    if (existing)
+        return nativeAcceptance(existing);
+    const request = {
+        version: 1,
+        type: 'notify',
+        request_id: randomUUID(),
+        project: sent.project,
+        delivery_id: sent.delivery_id,
+        hops: 0,
+    };
+    try {
+        const result = await (dependencies.sendRouterRequest ?? sendAgentRouterRequest)(routerSocketPath(), request, EXACT_SESSION_NATIVE_TIMEOUT_MS);
+        if (result.delivered !== true) {
+            const accepted = readHostAccept(db, sent.delivery_id);
+            if (accepted)
+                return nativeAcceptance(accepted);
+            if (readLatestDispatchFailureCode(db, sent.delivery_id) === 'native_message_too_large') {
+                throw new AgentNativeMessageTooLargeError();
+            }
+            throw new AgentRecipientUnavailableError();
+        }
+    }
+    catch (error) {
+        if (error instanceof AgentRecipientUnavailableError
+            || error instanceof AgentNativeMessageTooLargeError)
+            throw error;
+        throw new AgentRecipientUnavailableError();
+    }
+    const accepted = readHostAccept(db, sent.delivery_id);
+    if (!accepted)
+        throw new AgentRecipientUnavailableError();
+    return nativeAcceptance(accepted);
+}
+function readLatestDispatchFailureCode(db, deliveryId) {
+    const row = db.prepare(`
+    SELECT failure_code
+    FROM agent_dispatch_attempts
+    WHERE delivery_id = ? AND result = 'adapter_rejected' AND failure_code IS NOT NULL
+    ORDER BY attempt_number DESC
+    LIMIT 1
+  `).get(deliveryId);
+    return row?.failure_code;
+}
 function receiptDetail(note, context) {
     return {
         transport: context.transport,
@@ -203,11 +268,11 @@ function parseStoredObject(raw, label) {
     }
     throw new AgentMessagingError(`Invalid stored JSON object in ${label}.`);
 }
-export async function executeAgentMessageAction(db, rawInput, context) {
+export async function executeAgentMessageAction(db, rawInput, context, dependencies = {}) {
     const input = MessageSchema.parse(rawInput);
     switch (input.action) {
-        case 'send':
-            return sendAgentMessage(db, {
+        case 'send': {
+            const sent = sendAgentMessage(db, {
                 project: input.project,
                 sender: input.sender,
                 sender_host: context.sourceHost,
@@ -224,9 +289,16 @@ export async function executeAgentMessageAction(db, rawInput, context) {
                     source_host: context.sourceHost,
                 },
             }, {
-                notifier: optionalRouterNotifier(),
+                notifier: input.target_kind === 'session' ? undefined : optionalRouterNotifier(),
                 storage_quota_bytes: configuredAgentMessageStorageQuotaBytes(),
             });
+            if (sent.target_kind !== 'session')
+                return sent;
+            return {
+                ...sent,
+                native_delivery: await requireExactSessionNativeAcceptance(db, sent, dependencies),
+            };
+        }
         case 'poll': {
             const query = {
                 project: input.project,
@@ -238,6 +310,17 @@ export async function executeAgentMessageAction(db, rawInput, context) {
                 ? waitForAgentEvents(db, { ...query, wait_ms: input.wait_ms }, context.signal)
                 : pollAgentEvents(db, query);
         }
+        case 'discover': {
+            const request = {
+                version: 1,
+                type: 'discover',
+                request_id: randomUUID(),
+                project: input.project,
+                limit: input.limit,
+                hops: 0,
+            };
+            return await (dependencies.sendRouterRequest ?? sendAgentRouterRequest)(routerSocketPath(), request);
+        }
         case 'fetch':
             return fetchAgentMessage(db, input);
         case 'intake':

package/dist/transports/agent-messaging.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-messaging.js","sourceRoot":"","sources":["../../src/transports/agent-messaging.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"agent-messaging.js","sourceRoot":"","sources":["../../src/transports/agent-messaging.ts"],"names":[],"mappings":"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"}

package/dist/transports/cli/cli.d.ts

@@ -4,5 +4,9 @@ export declare function feedbackBrowserOpenCommand(platform: NodeJS.Platform, ur
     command: string;
     args: [string];
 };
+export declare function resolveUpgradePluginScript(packageRootPath: string, pluginCacheRoot: string, pluginRegistryPath?: string): {
+    script: string;
+    newest: string | null;
+} | null;
 export declare function runCli(argv?: readonly string[]): Promise<void>;
 //# sourceMappingURL=cli.d.ts.map

package/dist/transports/cli/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../../src/transports/cli/cli.ts"],"names":[],"mappings":";AAkMA,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,IAAI,CASN;AAGD,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,MAAM,CAAC,QAAQ,EACzB,GAAG,EAAE,MAAM,GACV;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,CAAC,MAAM,CAAC,CAAA;CAAE,CAKrC;AAw7FD,wBAAsB,MAAM,CAAC,IAAI,GAAE,SAAS,MAAM,EAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAElF"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../../src/transports/cli/cli.ts"],"names":[],"mappings":";AAqMA,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,IAAI,CASN;AAGD,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,MAAM,CAAC,QAAQ,EACzB,GAAG,EAAE,MAAM,GACV;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,CAAC,MAAM,CAAC,CAAA;CAAE,CAKrC;AAumDD,wBAAgB,0BAA0B,CACxC,eAAe,EAAE,MAAM,EACvB,eAAe,EAAE,MAAM,EACvB,kBAAkB,CAAC,EAAE,MAAM,GAC1B;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAAG,IAAI,CAYlD;AAi5CD,wBAAsB,MAAM,CAAC,IAAI,GAAE,SAAS,MAAM,EAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAElF"}

package/dist/transports/cli/cli.js

@@ -9,6 +9,7 @@ import { remember, recallWithConflicts, forget, exportMemories, importMemories,
 import { readConfig, writeConfig, maskApiKey, detectCapabilities } from '../../core/config.js';
 import { MAX_LANGUAGE_LENGTH, languageValueError } from '../../core/output-language.js';
 import { getDbPath, getProjectName, homeDir, redactSecrets, redactUserPaths } from '../../core/paths.js';
+import { agentScopeIdRejection, canonicalAgentScopeId } from '../../core/agent-scope-id.js';
 import { flushPendingEmbeddings, canRefillVectorIndex } from '../../core/embedder.js';
 import { NAMESPACES } from '../../core/types.js';
 import { assembleBriefing } from '../../core/briefing.js';
@@ -16,9 +17,11 @@ import { inspectHosts, allWired } from '../../core/setup.js';
 import { installHooks } from '../../core/install-hooks.js';
 import { getTaskState, setTaskState } from '../../core/task-state-store.js';
 import { TASK_STATE_FIELDS, taskStateLines } from '../../core/task-state.js';
+import { AGENT_MESSAGE_JSON_MAX_BYTES, AGENT_NATIVE_MESSAGE_MAX_BYTES } from '../../core/agent-messaging.js';
 import { executeAgentMessageAction } from '../agent-messaging.js';
 import { getAgentMessageStorageReport, pruneTerminalAgentMessagePayloads, } from '../../core/agent-message-storage.js';
 import { assertSecureLocalHostRuntimeSupported, ensureRouterTokenFile, } from '../../host-runtime/config.js';
+import { pluginHostConfigRoot, versionedPluginCacheRoots } from '../../core/install-channel.js';
 async function withDatabase(fn) {
     try {
         openDatabase();
@@ -302,6 +305,7 @@ program
             name: opts.name,
             observation: opts.observation,
         });
+        const didSomething = result.archived === true || result.observation_removed === true;
         if (opts.json) {
             console.log(JSON.stringify(result));
         }
@@ -314,12 +318,12 @@ program
         else if (opts.observation !== undefined && result.entity_found) {
             console.log(`Entity "${opts.name}" has no observation matching that text (${result.remaining_observations} observation(s) present).`);
             console.log(`See them with: memesh recall "${opts.name}" --json`);
-            process.exitCode = 1;
         }
         else {
             console.log(`Entity "${opts.name}" not found`);
-            process.exitCode = 1;
         }
+        if (!didSomething)
+            process.exitCode = 1;
     });
 });
 function registerPinCommand(name, description, pinned, onFound) {
@@ -518,7 +522,7 @@ program
 });
 const messageCmd = program
     .command('message')
-    .description('Send, wait for, fetch, and explicitly receipt durable local agent messages');
+    .description('Send, discover, wait for, fetch, and explicitly receipt local agent messages');
 function parseCliMessagePayload(raw, contentType) {
     if (contentType !== 'application/json')
         return raw;
@@ -529,22 +533,33 @@ function parseCliMessagePayload(raw, contentType) {
         throw new Error('stdin must contain valid JSON when --content-type is application/json.');
     }
 }
-const MAX_CLI_MESSAGE_STDIN_BYTES = 65_536;
+function boundedCliDeclaration(value, option, maxCharacters) {
+    const normalized = value.trim();
+    if (normalized.length === 0 || normalized.length > maxCharacters) {
+        throw new Error(`${option} must be a non-empty string of at most ${maxCharacters} characters.`);
+    }
+    return normalized;
+}
 async function readCliMessagePayloadFromStdin(contentType) {
     let raw = '';
     let bytes = 0;
     for await (const chunk of process.stdin) {
         const text = typeof chunk === 'string' ? chunk : Buffer.from(chunk).toString('utf8');
         bytes += Buffer.byteLength(text, 'utf8');
-        if (bytes > MAX_CLI_MESSAGE_STDIN_BYTES) {
-            throw new Error(`stdin payload exceeds ${MAX_CLI_MESSAGE_STDIN_BYTES} UTF-8 bytes.`);
+        if (bytes > AGENT_MESSAGE_JSON_MAX_BYTES) {
+            throw new Error(`stdin payload exceeds ${AGENT_MESSAGE_JSON_MAX_BYTES} UTF-8 bytes.`);
         }
         raw += text;
     }
     if (bytes === 0) {
         throw new Error('stdin payload is empty.');
     }
-    return parseCliMessagePayload(raw, contentType);
+    const payload = parseCliMessagePayload(raw, contentType);
+    const encodedBytes = Buffer.byteLength(JSON.stringify(payload), 'utf8');
+    if (encodedBytes > AGENT_MESSAGE_JSON_MAX_BYTES) {
+        throw new Error(`payload must be at most ${AGENT_MESSAGE_JSON_MAX_BYTES} UTF-8 bytes when encoded as JSON.`);
+    }
+    return payload;
 }
 async function runCliMessage(input) {
     await withDatabase(async () => {
@@ -567,15 +582,23 @@ function isAgentPollResult(value) {
     const candidate = value;
     return Array.isArray(candidate.events) && typeof candidate.next_cursor === 'string';
 }
+messageCmd
+    .command('discover')
+    .description('Discover active leased agents in one project without sending or acknowledging messages')
+    .requiredOption('--project <name>', 'Project scope')
+    .option('--limit <n>', 'Maximum live agents, 1-100', wholeNumber('--limit'), 50)
+    .action((opts) => runCliMessage({
+    action: 'discover', project: opts.project, limit: opts.limit,
+}));
 messageCmd
     .command('send')
-    .description('Durably send one exact-recipient local message (idempotent)')
+    .description(`Durably send one exact-recipient message (payload 64 KiB; complete native envelope 16 KiB; idempotent)`)
     .requiredOption('--project <name>', 'Project scope')
     .requiredOption('--sender <id>', 'Stable sender agent/host ID')
     .requiredOption('--recipient <id>', 'Stable recipient agent/host ID')
     .option('--target-kind <kind>', 'principal | session', 'principal')
     .requiredOption('--idempotency-key <key>', 'Stable retry key')
-    .requiredOption('--payload-stdin', 'Read the complete text or JSON payload from stdin (never argv)')
+    .requiredOption('--payload-stdin', `Read untrusted text or JSON from stdin, never argv (stdin read cap ${AGENT_MESSAGE_JSON_MAX_BYTES} UTF-8 bytes; JSON-encoded durable payload cap ${AGENT_MESSAGE_JSON_MAX_BYTES}; exact-session complete native envelope cap ${AGENT_NATIVE_MESSAGE_MAX_BYTES})`)
     .option('--content-type <type>', 'text/plain | application/json', 'text/plain')
     .option('--privacy <scope>', 'private | team', 'private')
     .option('--correlation-id <id>', 'Conversation or task correlation ID')
@@ -783,6 +806,8 @@ agentCmd
     .requiredOption('--project <name>', 'Project scope used for exact routing')
     .requiredOption('--principal <id>', 'Stable logical recipient ID')
     .option('--workspace <path>', 'Managed Codex/Gemini workspace', process.cwd())
+    .option('--model <id>', 'Optional declared model identifier')
+    .option('--work-summary <text>', 'Optional declared current work summary')
     .option('--json', 'Output machine-readable setup result')
     .action((host, opts) => {
     requireOneOf(host, ['codex-session', 'codex', 'claude', 'gemini'], '<host>');
@@ -801,8 +826,10 @@ agentCmd
     const common = {
         router_socket: path.join(messageDir, 'agent-router.sock'),
         token_file: routerTokenFile,
-        project: opts.project,
-        principal_id: opts.principal,
+        project: requireAgentScopeArg(opts.project, 'project', '--project'),
+        principal_id: requireAgentScopeArg(opts.principal, 'recipient', '--principal'),
+        ...(opts.model === undefined ? {} : { model: boundedCliDeclaration(opts.model, '--model', 200) }),
+        ...(opts.workSummary === undefined ? {} : { work_summary: boundedCliDeclaration(opts.workSummary, '--work-summary', 200) }),
     };
     const config = host === 'codex-session'
         ? { ...common, workspace: fs.realpathSync(path.resolve(opts.workspace)) }
@@ -845,10 +872,11 @@ program
     .command('briefing')
     .description('The assembled work topology for a project — task state, decisions, lessons, knowledge, recent activity')
     .option('--project <name>', 'Project name (default: the current directory’s project)')
+    .option('--recipient <id>', 'Exact recipient; enables recipient-scoped unread message guidance')
     .option('--json', 'Output as JSON')
     .action(async (opts) => {
     await withDatabase(() => {
-        const result = assembleBriefing(opts.project);
+        const result = assembleBriefing(opts.project, opts.recipient);
         if (opts.json) {
             console.log(JSON.stringify(result));
             return;
@@ -1362,29 +1390,38 @@ program
         process.exit(1);
     }
 });
+export function resolveUpgradePluginScript(packageRootPath, pluginCacheRoot, pluginRegistryPath) {
+    const roots = versionedPluginCacheRoots(pluginCacheRoot);
+    const newestRoot = roots[roots.length - 1];
+    const bundled = path.join(packageRootPath, 'scripts', 'upgrade-plugin.sh');
+    const hasRepairTarget = Boolean(newestRoot || (pluginRegistryPath && fs.existsSync(pluginRegistryPath)));
+    if (fs.existsSync(bundled) && hasRepairTarget) {
+        return { script: bundled, newest: newestRoot ? path.basename(newestRoot) : null };
+    }
+    if (!newestRoot)
+        return null;
+    const newest = path.basename(newestRoot);
+    const script = path.join(newestRoot, 'scripts', 'upgrade-plugin.sh');
+    return { script, newest };
+}
 program
     .command('upgrade-plugin')
     .description('Upgrade the Claude Code plugin install (finds and runs its bundled upgrade script)')
     .action(async () => {
     const { spawnSync } = await import('child_process');
-    const cacheRoot = path.join(homeDir(), '.claude', 'plugins', 'cache', 'pcircle-memesh', 'memesh');
-    let versions = [];
-    try {
-        versions = fs.readdirSync(cacheRoot, { withFileTypes: true })
-            .filter((entry) => entry.isDirectory() && /^\d+\.\d+\.\d+/.test(entry.name))
-            .map((entry) => entry.name);
-    }
-    catch { }
-    if (versions.length === 0) {
-        console.error('No Claude Code plugin install found (looked in ~/.claude/plugins/cache/pcircle-memesh).');
+    const configRoot = pluginHostConfigRoot('claude-code');
+    const cacheRoot = path.join(configRoot, 'plugins', 'cache', 'pcircle-memesh', 'memesh');
+    const registryPath = path.join(configRoot, 'plugins', 'installed_plugins.json');
+    const resolved = resolveUpgradePluginScript(packageRoot, cacheRoot, registryPath);
+    if (!resolved) {
+        console.error(`No Claude Code plugin install found (looked in ${cacheRoot}).`);
         console.error('If you installed via npm, upgrade with: memesh update');
+        console.error('If you installed through Codex, run `memesh doctor` for the Codex refresh command.');
         process.exit(1);
     }
-    versions.sort((a, b) => a.localeCompare(b, undefined, { numeric: true }));
-    const newest = versions[versions.length - 1];
-    const script = path.join(cacheRoot, newest, 'scripts', 'upgrade-plugin.sh');
+    const { script, newest } = resolved;
     if (!fs.existsSync(script)) {
-        console.error(`Plugin install found (v${newest}), but it has no scripts/upgrade-plugin.sh — plugin versions before 4.2.5 shipped without it.`);
+        console.error(`Plugin install found${newest ? ` (v${newest})` : ''}, but it has no scripts/upgrade-plugin.sh — plugin versions before 4.2.5 shipped without it.`);
         console.error('Reinstall once from the Claude Code /plugin UI, or run the npm-global copy directly:');
         console.error('  bash "$(npm prefix -g)/lib/node_modules/@pcircle/memesh/scripts/upgrade-plugin.sh"');
         process.exit(1);
@@ -1392,7 +1429,8 @@ program
     const installHints = {
         node: 'node is required by the upgrade script. Install Node.js from https://nodejs.org',
         npm: 'npm is required by the upgrade script. It ships with Node.js — reinstall from https://nodejs.org',
-        rsync: 'rsync is required by the upgrade script. macOS: already installed; Debian/Ubuntu: sudo apt install rsync',
+        git: 'git is required by the upgrade script. macOS: xcode-select --install; Debian/Ubuntu: sudo apt install git',
+        tar: 'tar is required by the upgrade script. macOS: already installed; Debian/Ubuntu: sudo apt install tar',
     };
     const missing = Object.keys(installHints).filter((tool) => !isOnPath(tool));
     if (missing.length > 0) {
@@ -1400,7 +1438,10 @@ program
             console.error(installHints[tool]);
         process.exit(1);
     }
-    const run = spawnSync('bash', [script], { stdio: 'inherit' });
+    const run = spawnSync('bash', [script], {
+        stdio: 'inherit',
+        env: { ...process.env, CLAUDE_CONFIG_DIR: configRoot },
+    });
     if (run.error) {
         console.error(`Could not run the upgrade script: ${run.error.message}`);
         console.error('bash is required to run it. If bash is available under another name, run it yourself:');
@@ -1556,9 +1597,15 @@ kgCmd
         }
     });
 });
+function requireAgentScopeArg(value, field, flag) {
+    const rejection = agentScopeIdRejection(field, value);
+    if (rejection)
+        throw new Error(`${flag}: ${rejection}`);
+    return canonicalAgentScopeId(value);
+}
 kgCmd
     .command('rename-project')
-    .description('Merge or rename a project:<name> tag across all entities (heals mis-homed tags from before git-based project identity)')
+    .description('Merge or rename a project across all entities AND durable agent messages (heals mis-homed tags from before git-based project identity, and the message scopes that go with them)')
     .option('--from <name>', 'Existing project name to rewrite. Omit both --from/--to to just LIST all project tags + counts.')
     .option('--to <name>', 'New project name to rewrite it to')
     .option('--apply', 'Actually write the change. Default is a dry-run preview. Backs up the DB first.')
@@ -1587,20 +1634,22 @@ kgCmd
             process.exitCode = 1;
             return;
         }
-        const preview = renameProjectTag(opts.from, opts.to, { apply: false });
+        const to = requireAgentScopeArg(opts.to, 'project', '--to');
+        const preview = renameProjectTag(opts.from, to, { apply: false });
         if (!opts.apply) {
             if (opts.json) {
                 console.log(JSON.stringify({ ...preview, dryRun: true }, null, 2));
                 return;
             }
-            console.log(`Dry-run: project:${opts.from} → project:${opts.to}`);
+            console.log(`Dry-run: project:${opts.from} → project:${to}`);
             console.log(`  ${preview.affectedEntities} entit${preview.affectedEntities === 1 ? 'y' : 'ies'} carry project:${opts.from}`);
-            console.log(`  ${preview.renamed} would be renamed, ${preview.merged} already have project:${opts.to} (their project:${opts.from} row would be removed)`);
+            console.log(`  ${preview.renamed} would be renamed, ${preview.merged} already have project:${to} (their project:${opts.from} row would be removed)`);
+            console.log(`  ${preview.messageRows} durable agent-message row(s) scoped to ${opts.from} would move to ${to}`);
             console.log(`\nNothing written. Re-run with --apply to commit (the DB is backed up first).`);
             return;
         }
-        if (preview.affectedEntities === 0) {
-            console.log(`No entities carry project:${opts.from} — nothing to do.`);
+        if (preview.affectedEntities === 0 && preview.messageRows === 0) {
+            console.log(`Nothing carries project ${opts.from} — no entity tags and no agent-message rows. Nothing to do.`);
             return;
         }
         const dbPath = getDbPath();
@@ -1616,13 +1665,14 @@ kgCmd
             process.exitCode = 1;
             return;
         }
-        const result = renameProjectTag(opts.from, opts.to, { apply: true });
+        const result = renameProjectTag(opts.from, to, { apply: true });
         if (opts.json) {
             console.log(JSON.stringify({ ...result, backupPath }, null, 2));
             return;
         }
-        console.log(`✅ project:${opts.from} → project:${opts.to}`);
+        console.log(`✅ project:${opts.from} → project:${to}`);
         console.log(`  ${result.renamed} renamed, ${result.merged} merged (${result.affectedEntities} entities total)`);
+        console.log(`  ${result.messageRows} agent-message row(s) moved${result.messageRowsBlocked > 0 ? `, ${result.messageRowsBlocked} left in place (${to} already holds an equivalent row)` : ''}`);
         console.log(`  Backup: ${backupPath}`);
         console.log(`  Restore if needed: cp "${backupPath}" "${dbPath}"`);
     });
@@ -2118,7 +2168,7 @@ dreamCmd
 });
 program
     .command('install-hooks')
-    .description('Wire memesh\'s session hooks into Claude Code (~/.claude/settings.json)')
+    .description('Wire memesh\'s session hooks into Claude Code user settings')
     .option('--scope <scope>', 'user (default) or project — project writes to ./.claude/settings.json', 'user')
     .option('--dry-run', 'Show what would change without modifying any file')
     .option('--force-over-plugin', 'Write user-level hooks even when Claude Code\'s plugin runtime already wires them. Causes double-firing — only use if you genuinely want both surfaces.')
@@ -2139,7 +2189,7 @@ program
             console.log('');
             console.log('Hooks are active. Verify with: memesh doctor');
             console.log('');
-            console.log('If you really want a second copy in ~/.claude/settings.json on top of the plugin, re-run with --force-over-plugin. (Not recommended — every session-start / Stop / PreToolUse event will fire memesh\'s hooks twice.)');
+            console.log(`If you really want a second copy in ${result.settingsPath} on top of the plugin, re-run with --force-over-plugin. (Not recommended — every session-start / Stop / PreToolUse event will fire memesh's hooks twice.)`);
             if (result.citationRule.action === 'foreign-file') {
                 console.log('');
                 console.log(`WARNING: the citation contract was NOT installed — a file memesh did not write already exists at ${result.citationRule.path}.`);