From bf801603c426f41dd10be008e363562c29279798 Mon Sep 17 00:00:00 2001
From: Rohit Ghumare
Date: Wed, 11 Nov 2026 16:36:40 +0530
Subject: [PATCH 1/7] fix(cli): say when an agent is connected with MCP only
An agent connected with MCP only and no hooks captures nothing on its
own. Observations are stored only when the agent calls memory_save.
connect and status never said so, so users expected automatic capture.
connect now prints one line after an MCP-only setup. It names
--with-hooks only for adapters that can install hooks, points
plugin-based agents at their plugin, and otherwise says the agent
must call memory_save. Each adapter declares its capture mode in a
new autoCapture field; JSON MCP adapters with a hook installer get
"with-hooks" automatically.
The status report and the status command warn when the server has
no sessions and no capture activity, which means no hook has reached
it yet. Sessions come from hooks or imports, never from MCP calls,
so the existing session count is the signal. No new storage is added.
Signed-off-by: Rohit Ghumare
---
src/cli.ts | 4 +
src/cli/connect/capture-notice.ts | 23 ++++++
src/cli/connect/claude-code.ts | 1 +
src/cli/connect/codex.ts | 1 +
src/cli/connect/copilot-cli.ts | 1 +
src/cli/connect/cursor.ts | 1 +
src/cli/connect/dsh.ts | 1 +
src/cli/connect/hermes.ts | 1 +
src/cli/connect/index.ts | 3 +
src/cli/connect/json-mcp-adapter.ts | 6 +-
src/cli/connect/omp.ts | 1 +
src/cli/connect/openclaw.ts | 1 +
src/cli/connect/opencode.ts | 1 +
src/cli/connect/pi.ts | 2 +-
src/cli/connect/types.ts | 7 ++
src/functions/status.ts | 17 +++++
test/connect-capture-notice.test.ts | 109 ++++++++++++++++++++++++++++
test/status.test.ts | 29 ++++++++
18 files changed, 207 insertions(+), 2 deletions(-)
create mode 100644 src/cli/connect/capture-notice.ts
create mode 100644 test/connect-capture-notice.test.ts
diff --git a/src/cli.ts b/src/cli.ts
index b2b89ab08d..f267139e9b 100644
--- a/src/cli.ts
+++ b/src/cli.ts
@@ -104,6 +104,7 @@ import { bearerHeaders, resolveClientSecret } from "./secret-store.js";
import { assertComposePortsFree, composeCall, composeRegistryFailureMessage, composeStateRegistryFailure, composeWorkerFailureSummary, ownedComposeProject, readComposeLogFromOffset, startComposeDaemon, writeComposeState, type ComposeStatus } from "./cli/compose-control.js";
import { COMPOSE_WORKER_VERSIONS, composeDownTimeoutMs, composeNamespace } from "./cli/compose-project.js";
import { legacyDockerStateMessage, type LegacyDockerEngineState } from "./cli/legacy-docker-state.js";
+import { NO_HOOK_CAPTURE } from "./functions/status.js";
const __dirname = dirname(fileURLToPath(import.meta.url));
const args = process.argv.slice(2);
@@ -1973,6 +1974,9 @@ async function runStatus() {
}
}
p.note(lines.join("\n"), "agentmemory");
+ if (Array.isArray(sessionsRes?.sessions) && sessions === 0) {
+ p.log.warn(`${NO_HOOK_CAPTURE.message}\n${NO_HOOK_CAPTURE.fix}`);
+ }
} catch (err) {
p.log.error(err instanceof Error ? err.message : String(err));
process.exit(1);
diff --git a/src/cli/connect/capture-notice.ts b/src/cli/connect/capture-notice.ts
new file mode 100644
index 0000000000..9dc84ce15f
--- /dev/null
+++ b/src/cli/connect/capture-notice.ts
@@ -0,0 +1,23 @@
+import type { ConnectAdapter, ConnectOptions, ConnectResult } from "./types.js";
+
+export function mcpOnlyCaptureNotice(
+ adapter: Pick,
+ opts: Pick,
+ result: ConnectResult,
+): string | null {
+ if (result.kind !== "installed" && result.kind !== "already-wired") return null;
+ const mode = adapter.autoCapture;
+ if (mode === "built-in") return null;
+ if (opts.withHooks && (mode === "with-hooks" || mode === "plugin-or-with-hooks")) return null;
+ const lead = `${adapter.displayName}: MCP only. Nothing is captured automatically`;
+ switch (mode) {
+ case "with-hooks":
+ return `${lead}. Rerun with --with-hooks to capture sessions automatically.`;
+ case "plugin":
+ return `${lead} unless the agentmemory plugin for ${adapter.displayName} is installed. Without it, the agent must call memory_save to store anything.`;
+ case "plugin-or-with-hooks":
+ return `${lead} unless the agentmemory plugin is installed. Install the plugin, or rerun with --with-hooks.`;
+ default:
+ return `${lead}. The agent must call memory_save to store anything.`;
+ }
+}
diff --git a/src/cli/connect/claude-code.ts b/src/cli/connect/claude-code.ts
index 271468bf2e..3ceb5d5f61 100644
--- a/src/cli/connect/claude-code.ts
+++ b/src/cli/connect/claude-code.ts
@@ -50,6 +50,7 @@ export const adapter: ConnectAdapter = {
name: "claude-code",
displayName: "Claude Code",
category: "native",
+ autoCapture: "plugin-or-with-hooks",
docs: "https://github.com/rohitg00/agentmemory#claude-code-one-block-paste-it",
protocolNote:
"→ Using MCP. Hooks are also available — see https://github.com/rohitg00/agentmemory#claude-code-one-block-paste-it.",
diff --git a/src/cli/connect/codex.ts b/src/cli/connect/codex.ts
index b31b35d119..d5f6824d22 100644
--- a/src/cli/connect/codex.ts
+++ b/src/cli/connect/codex.ts
@@ -64,6 +64,7 @@ export const adapter: ConnectAdapter = {
name: "codex",
displayName: "Codex CLI",
category: "native",
+ autoCapture: "plugin-or-with-hooks",
docs: "https://github.com/rohitg00/agentmemory#codex-cli-codex-plugin-platform",
protocolNote:
"→ Using MCP. Hooks ship via the Codex plugin; on Codex Desktop, also pass --with-hooks to install the global hooks.json workaround.",
diff --git a/src/cli/connect/copilot-cli.ts b/src/cli/connect/copilot-cli.ts
index 1f7b43dd87..7f50e37f5b 100644
--- a/src/cli/connect/copilot-cli.ts
+++ b/src/cli/connect/copilot-cli.ts
@@ -31,6 +31,7 @@ export const adapter: ConnectAdapter = {
name: "copilot-cli",
displayName: "GitHub Copilot CLI",
category: "native",
+ autoCapture: "plugin",
docs: "https://github.com/rohitg00/agentmemory#github-copilot-cli",
protocolNote:
"→ Using MCP. Install the plugin too for full hooks/skills coverage.",
diff --git a/src/cli/connect/cursor.ts b/src/cli/connect/cursor.ts
index 642add4efb..63d41a4025 100644
--- a/src/cli/connect/cursor.ts
+++ b/src/cli/connect/cursor.ts
@@ -8,6 +8,7 @@ export const adapter = createJsonMcpAdapter({
// Cursor speaks lifecycle hooks as well as MCP, so it groups with the
// native hosts rather than the MCP-only ones.
category: "native",
+ autoCapture: "plugin",
detectDir: join(homedir(), ".cursor"),
configPath: join(homedir(), ".cursor", "mcp.json"),
docs: "https://github.com/rohitg00/agentmemory#cursor",
diff --git a/src/cli/connect/dsh.ts b/src/cli/connect/dsh.ts
index f18c93b7e9..48391858c5 100644
--- a/src/cli/connect/dsh.ts
+++ b/src/cli/connect/dsh.ts
@@ -100,6 +100,7 @@ export const adapter: ConnectAdapter = {
protocolNote:
"→ Using MCP via $DSH_HOME/cordis.patch.yml (the home-level patch layer every profile loads). Tools appear as mcp__agentmemory__*. Pass --with-hooks to also wire auto-capture with the bundled native DSH plugin.",
category: "native",
+ autoCapture: "with-hooks",
detect(): boolean {
return existsSync(resolveDshHome());
},
diff --git a/src/cli/connect/hermes.ts b/src/cli/connect/hermes.ts
index d7bc5e6b6f..09a7f577b1 100644
--- a/src/cli/connect/hermes.ts
+++ b/src/cli/connect/hermes.ts
@@ -18,6 +18,7 @@ export const adapter: ConnectAdapter = {
name: "hermes",
displayName: "Hermes Agent",
category: "native",
+ autoCapture: "built-in",
docs: DOCS,
protocolNote: "→ Installs the native memory provider and bundled skills into the active Hermes profile. Credentials stay managed by Hermes.",
detect: () => existsSync(hermesHome()),
diff --git a/src/cli/connect/index.ts b/src/cli/connect/index.ts
index 055cb547d3..2de3da9551 100644
--- a/src/cli/connect/index.ts
+++ b/src/cli/connect/index.ts
@@ -3,6 +3,7 @@ import * as p from "@clack/prompts";
import pc from "picocolors";
import type { ConnectAdapter, ConnectOptions, ConnectResult } from "./types.js";
import { writeGuideline } from "./guidelines.js";
+import { mcpOnlyCaptureNotice } from "./capture-notice.js";
import { adapter as antigravity } from "./antigravity.js";
import { adapter as antigravityCli } from "./antigravity-cli.js";
import { adapter as claudeCode } from "./claude-code.js";
@@ -129,6 +130,8 @@ export async function runAdapter(
);
}
}
+ const captureNotice = mcpOnlyCaptureNotice(adapter, opts, result);
+ if (captureNotice) p.log.warn(captureNotice);
return result;
} catch (err) {
p.log.error(
diff --git a/src/cli/connect/json-mcp-adapter.ts b/src/cli/connect/json-mcp-adapter.ts
index 0b76aa754f..d968f73e45 100644
--- a/src/cli/connect/json-mcp-adapter.ts
+++ b/src/cli/connect/json-mcp-adapter.ts
@@ -1,7 +1,7 @@
import { existsSync, mkdirSync } from "node:fs";
import { dirname } from "node:path";
import * as p from "@clack/prompts";
-import type { ConnectAdapter, ConnectOptions, ConnectResult } from "./types.js";
+import type { AutoCapture, ConnectAdapter, ConnectOptions, ConnectResult } from "./types.js";
import {
AGENTMEMORY_MCP_BLOCK,
backupFile,
@@ -23,6 +23,7 @@ export type JsonMcpAdapterConfig = {
// JSON MCP config writer is MCP-only by construction; hosts that also
// ship hooks (e.g. OpenClaw) pass "native".
category?: "native" | "mcp";
+ autoCapture?: AutoCapture;
// Wrapper key under which servers live. Default "mcpServers".
// Zed uses "context_servers"; otherwise same shape.
wrapperKey?: string;
@@ -47,10 +48,13 @@ export function createJsonMcpAdapter(
config: JsonMcpAdapterConfig,
): ConnectAdapter {
const wrapperKey = config.wrapperKey ?? "mcpServers";
+ const autoCapture: AutoCapture | undefined =
+ config.autoCapture ?? (config.installHooks ? "with-hooks" : undefined);
return {
name: config.name,
displayName: config.displayName,
category: config.category ?? "mcp",
+ ...(autoCapture !== undefined && { autoCapture }),
...(config.docs !== undefined && { docs: config.docs }),
...(config.protocolNote !== undefined && {
protocolNote: config.protocolNote,
diff --git a/src/cli/connect/omp.ts b/src/cli/connect/omp.ts
index 90a4d59000..d0de985939 100644
--- a/src/cli/connect/omp.ts
+++ b/src/cli/connect/omp.ts
@@ -22,6 +22,7 @@ export const adapter: ConnectAdapter = {
name: "omp",
displayName: "Oh My Pi",
category: "native",
+ autoCapture: "built-in",
docs: "https://github.com/rohitg00/agentmemory/tree/main/integrations/omp",
protocolNote: "Installs native recall, capture and skills. Add --with-mcp for the full memory toolset.",
detect: () => { try { const paths = ompPaths(); return existsSync(paths.agent) || existsSync(paths.root); } catch { return false; } },
diff --git a/src/cli/connect/openclaw.ts b/src/cli/connect/openclaw.ts
index 6b992a61d7..60ef6b6382 100644
--- a/src/cli/connect/openclaw.ts
+++ b/src/cli/connect/openclaw.ts
@@ -25,6 +25,7 @@ export const adapter: ConnectAdapter = {
name: "openclaw",
displayName: "OpenClaw",
category: "native",
+ autoCapture: "built-in",
docs: "https://github.com/rohitg00/agentmemory/tree/main/integrations/openclaw",
protocolNote: "→ Installs native recall/capture and bundled skills into the active OpenClaw state directory. MCP tools are opt-in with --with-mcp.",
detect: () => existsSync(paths().config) || existsSync(paths().state),
diff --git a/src/cli/connect/opencode.ts b/src/cli/connect/opencode.ts
index 76ddbf63d1..9016ecc1c4 100644
--- a/src/cli/connect/opencode.ts
+++ b/src/cli/connect/opencode.ts
@@ -45,6 +45,7 @@ export const adapter: ConnectAdapter = {
name: "opencode",
displayName: "OpenCode",
category: "mcp",
+ autoCapture: "plugin",
docs: "https://github.com/rohitg00/agentmemory#other-agents",
protocolNote:
"Using MCP via ~/.config/opencode/opencode.json (top-level `mcp` key). For full auto-capture, also install the bundled plugin in plugin/opencode/.",
diff --git a/src/cli/connect/pi.ts b/src/cli/connect/pi.ts
index 8d954fa21d..8489cc9e44 100644
--- a/src/cli/connect/pi.ts
+++ b/src/cli/connect/pi.ts
@@ -34,7 +34,7 @@ function hasPackage(config: Record, configDir: string, target:
}
export const adapter: ConnectAdapter = {
- name: "pi", displayName: "Pi", category: "native",
+ name: "pi", displayName: "Pi", category: "native", autoCapture: "built-in",
docs: "https://github.com/rohitg00/agentmemory/tree/main/integrations/pi",
protocolNote: "Installs native recall, capture and skills. Add --with-mcp for the full memory toolset.",
detect: () => existsSync(agentDir()) || existsSync(join(homedir(), ".pi")),
diff --git a/src/cli/connect/types.ts b/src/cli/connect/types.ts
index 4d71df33cc..2bd9511642 100644
--- a/src/cli/connect/types.ts
+++ b/src/cli/connect/types.ts
@@ -12,6 +12,12 @@ export type ConnectOptions = {
guidelines?: boolean;
};
+export type AutoCapture =
+ | "built-in"
+ | "with-hooks"
+ | "plugin"
+ | "plugin-or-with-hooks";
+
export type ConnectAdapter = {
name: string;
displayName: string;
@@ -24,6 +30,7 @@ export type ConnectAdapter = {
*/
protocolNote?: string;
category?: "native" | "mcp";
+ autoCapture?: AutoCapture;
detect(): boolean;
install(opts: ConnectOptions): Promise;
};
diff --git a/src/functions/status.ts b/src/functions/status.ts
index 6967f7249b..f73401256a 100644
--- a/src/functions/status.ts
+++ b/src/functions/status.ts
@@ -487,6 +487,9 @@ export function evaluateStatus(input: StatusInputs): StatusReport {
});
}
problems.push(...captureProblems(input.capture ?? null, input.now, input.ports.rest));
+ if (input.index.sessions === 0 && !captureActivity(input.capture ?? null)) {
+ problems.push({ level: "warn", code: "no-hook-capture", ...NO_HOOK_CAPTURE });
+ }
if (input.stateStore && !input.stateStore.ok) {
problems.push({
@@ -555,6 +558,20 @@ export function captureRestBase(restPort: number | null): string {
return `http://localhost:${restPort ?? 3111}/agentmemory`;
}
+export const NO_HOOK_CAPTURE = {
+ message:
+ "No hook has reached this server yet: there are no sessions, so nothing is captured automatically. An agent connected with MCP only stores observations only when it calls memory_save.",
+ fix: "Install the agent's hooks: rerun npx @agentmemory/agentmemory connect --with-hooks, or install the agentmemory plugin for that agent. If you only just connected an agent, run one session and check again.",
+};
+
+function captureActivity(capture: CaptureStatus | null): boolean {
+ if (!capture) return false;
+ const inbox = capture.inbox;
+ const queued = inbox ? inbox.pending + inbox.retrying + inbox.dead : 0;
+ const spooled = capture.spool.reduce((n, s) => n + s.records, 0);
+ return capture.sinceStart.accepted > 0 || queued > 0 || spooled > 0;
+}
+
function captureProblems(capture: CaptureStatus | null, now: Date, restPort: number | null): StatusProblem[] {
if (!capture) return [];
const problems: StatusProblem[] = [];
diff --git a/test/connect-capture-notice.test.ts b/test/connect-capture-notice.test.ts
new file mode 100644
index 0000000000..70c749f1c0
--- /dev/null
+++ b/test/connect-capture-notice.test.ts
@@ -0,0 +1,109 @@
+import { beforeEach, describe, expect, it, vi } from "vitest";
+import type { ConnectAdapter } from "../src/cli/connect/types.js";
+
+const log = vi.hoisted(() => ({
+ info: vi.fn(),
+ warn: vi.fn(),
+ step: vi.fn(),
+ message: vi.fn(),
+ error: vi.fn(),
+ success: vi.fn(),
+}));
+vi.mock("@clack/prompts", () => ({ log }));
+
+import { mcpOnlyCaptureNotice } from "../src/cli/connect/capture-notice.js";
+import { ADAPTERS, runAdapter } from "../src/cli/connect/index.js";
+
+const installed = { kind: "installed" } as const;
+
+describe("mcpOnlyCaptureNotice", () => {
+ it("tells MCP-only agents without hook support that the agent must call memory_save", () => {
+ const notice = mcpOnlyCaptureNotice({ displayName: "Gemini CLI" }, { withHooks: false }, installed);
+ expect(notice).toBe("Gemini CLI: MCP only. Nothing is captured automatically. The agent must call memory_save to store anything.");
+ expect(notice).not.toContain("--with-hooks");
+ });
+
+ it("does not suggest --with-hooks when the adapter cannot install hooks, even if the flag was passed", () => {
+ const notice = mcpOnlyCaptureNotice({ displayName: "Kiro" }, { withHooks: true }, installed);
+ expect(notice).toContain("memory_save");
+ expect(notice).not.toContain("--with-hooks");
+ });
+
+ it("suggests --with-hooks only for adapters that support it", () => {
+ const notice = mcpOnlyCaptureNotice({ displayName: "Antigravity", autoCapture: "with-hooks" }, { withHooks: false }, installed);
+ expect(notice).toBe("Antigravity: MCP only. Nothing is captured automatically. Rerun with --with-hooks to capture sessions automatically.");
+ });
+
+ it("stays quiet once hooks were requested for an adapter that installs them", () => {
+ expect(mcpOnlyCaptureNotice({ displayName: "Droid", autoCapture: "with-hooks" }, { withHooks: true }, installed)).toBeNull();
+ expect(mcpOnlyCaptureNotice({ displayName: "Codex CLI", autoCapture: "plugin-or-with-hooks" }, { withHooks: true }, installed)).toBeNull();
+ });
+
+ it("points plugin-based agents at their plugin", () => {
+ const plugin = mcpOnlyCaptureNotice({ displayName: "Cursor", autoCapture: "plugin" }, { withHooks: false }, installed);
+ expect(plugin).toContain("unless the agentmemory plugin for Cursor is installed");
+ expect(plugin).toContain("memory_save");
+ expect(plugin).not.toContain("--with-hooks");
+ const both = mcpOnlyCaptureNotice({ displayName: "Claude Code", autoCapture: "plugin-or-with-hooks" }, { withHooks: false }, installed);
+ expect(both).toContain("Install the plugin, or rerun with --with-hooks.");
+ });
+
+ it("stays quiet for built-in capture and for results that did not wire anything", () => {
+ expect(mcpOnlyCaptureNotice({ displayName: "Hermes Agent", autoCapture: "built-in" }, { withHooks: false }, installed)).toBeNull();
+ expect(mcpOnlyCaptureNotice({ displayName: "Gemini CLI" }, { withHooks: false }, { kind: "skipped", reason: "exception" })).toBeNull();
+ expect(mcpOnlyCaptureNotice({ displayName: "OpenHuman" }, { withHooks: false }, { kind: "stub", reason: "manual" })).toBeNull();
+ expect(mcpOnlyCaptureNotice({ displayName: "Gemini CLI" }, { withHooks: false }, { kind: "already-wired" })).not.toBeNull();
+ });
+});
+
+describe("adapter capture modes", () => {
+ it("declares how each adapter captures automatically", () => {
+ const modes = Object.fromEntries(ADAPTERS.map((a) => [a.name, a.autoCapture ?? "none"]));
+ expect(modes).toMatchObject({
+ "claude-code": "plugin-or-with-hooks",
+ codex: "plugin-or-with-hooks",
+ cursor: "plugin",
+ "copilot-cli": "plugin",
+ opencode: "plugin",
+ antigravity: "with-hooks",
+ "antigravity-cli": "with-hooks",
+ droid: "with-hooks",
+ devin: "with-hooks",
+ dsh: "with-hooks",
+ hermes: "built-in",
+ openclaw: "built-in",
+ pi: "built-in",
+ omp: "built-in",
+ "gemini-cli": "none",
+ kiro: "none",
+ qwen: "none",
+ zed: "none",
+ });
+ });
+});
+
+describe("runAdapter capture notice", () => {
+ beforeEach(() => {
+ vi.clearAllMocks();
+ });
+
+ const fake = (overrides: Partial = {}): ConnectAdapter => ({
+ name: "fake",
+ displayName: "Fake Agent",
+ detect: () => true,
+ install: async () => ({ kind: "installed" }),
+ ...overrides,
+ });
+
+ it("prints the MCP-only line after a hook-less install", async () => {
+ await runAdapter(fake(), { dryRun: true, force: false, guidelines: false });
+ expect(log.warn).toHaveBeenCalledWith(
+ "Fake Agent: MCP only. Nothing is captured automatically. The agent must call memory_save to store anything.",
+ );
+ });
+
+ it("does not print it when --with-hooks installed the hooks", async () => {
+ await runAdapter(fake({ autoCapture: "with-hooks" }), { dryRun: true, force: false, withHooks: true, guidelines: false });
+ expect(log.warn).not.toHaveBeenCalled();
+ });
+});
diff --git a/test/status.test.ts b/test/status.test.ts
index 375f846cc6..6f7995d9ae 100644
--- a/test/status.test.ts
+++ b/test/status.test.ts
@@ -117,6 +117,35 @@ describe("evaluateStatus", () => {
expect(problem?.fix).toMatch(/Restart agentmemory/);
});
+ it("warns when no hook has ever reached the server", () => {
+ const report = evaluateStatus(inputs({ index: { ...inputs().index, sessions: 0 } }));
+ expect(codes(report)).toEqual(["no-hook-capture"]);
+ expect(report.status).toBe("warn");
+ const problem = report.problems[0];
+ expect(problem.message).toMatch(/nothing is captured automatically/);
+ expect(problem.message).toMatch(/memory_save/);
+ expect(problem.fix).toMatch(/--with-hooks/);
+ });
+
+ it("skips the no-hook warning while hook captures are in flight or the session count is unknown", () => {
+ const capture = {
+ policy: { maxAttempts: 5, retryIntervalMs: 10_000, dedupRetentionHours: 168, inboxMax: 10_000, deadMax: 1000, eventsMax: 100_000 },
+ inbox: { pending: 0, retrying: 0, dead: 0, oldestAcceptedAt: null, nextAttemptAt: null, lastError: null },
+ sinceStart: { accepted: 0, completed: 0, duplicates: 0, retried: 0, recovered: 0, deadLettered: 0, rejected: 0, pruned: 0 },
+ lastSweepAt: null,
+ lastPruneAt: null,
+ lastBootDrain: null,
+ spool: [],
+ } as unknown as NonNullable;
+ const empty = { ...inputs().index, sessions: 0 };
+ expect(codes(evaluateStatus(inputs({ index: empty, capture })))).toContain("no-hook-capture");
+ const accepted = { ...capture, sinceStart: { ...capture.sinceStart, accepted: 2 } };
+ expect(codes(evaluateStatus(inputs({ index: empty, capture: accepted })))).not.toContain("no-hook-capture");
+ const pending = { ...capture, inbox: { ...capture.inbox!, pending: 1 } };
+ expect(codes(evaluateStatus(inputs({ index: empty, capture: pending })))).not.toContain("no-hook-capture");
+ expect(codes(evaluateStatus(inputs({ index: { ...empty, sessions: null } })))).not.toContain("no-hook-capture");
+ });
+
it("notes when the index check timed out instead of claiming the index is fine", () => {
const report = evaluateStatus(inputs({ index: { ...inputs().index, missingObservations: null, sessions: null } }));
expect(codes(report)).toEqual(["index-check-unavailable"]);
From 23772d154b709afc7d05340e520eb77e90fbfd61 Mon Sep 17 00:00:00 2001
From: Rohit Ghumare
Date: Wed, 11 Nov 2026 16:36:40 +0530
Subject: [PATCH 2/7] docs: sync generated stats
Run npm run docs:sync after the MCP-only capture notice change.
Signed-off-by: Rohit Ghumare
---
AGENTS.md | 4 ++--
README.md | 4 ++--
READMEs/README.ar-SA.md | 4 ++--
READMEs/README.bn-BD.md | 4 ++--
READMEs/README.cs-CZ.md | 4 ++--
READMEs/README.da-DK.md | 4 ++--
READMEs/README.de-DE.md | 4 ++--
READMEs/README.el-GR.md | 4 ++--
READMEs/README.es-ES.md | 4 ++--
READMEs/README.fi-FI.md | 4 ++--
READMEs/README.fr-FR.md | 4 ++--
READMEs/README.he-IL.md | 4 ++--
READMEs/README.hi-IN.md | 4 ++--
READMEs/README.hu-HU.md | 4 ++--
READMEs/README.id-ID.md | 4 ++--
READMEs/README.it-IT.md | 4 ++--
READMEs/README.ja-JP.md | 4 ++--
READMEs/README.ko-KR.md | 4 ++--
READMEs/README.nb-NO.md | 4 ++--
READMEs/README.nl-NL.md | 4 ++--
READMEs/README.pl-PL.md | 4 ++--
READMEs/README.pt-BR.md | 4 ++--
READMEs/README.pt-PT.md | 4 ++--
READMEs/README.ro-RO.md | 4 ++--
READMEs/README.ru-RU.md | 4 ++--
READMEs/README.sv-SE.md | 4 ++--
READMEs/README.th-TH.md | 4 ++--
READMEs/README.tl-PH.md | 4 ++--
READMEs/README.tr-TR.md | 4 ++--
READMEs/README.uk-UA.md | 4 ++--
READMEs/README.ur-PK.md | 4 ++--
READMEs/README.vi-VN.md | 4 ++--
READMEs/README.zh-CN.md | 4 ++--
READMEs/README.zh-TW.md | 4 ++--
assets/tags/light/stat-tests.svg | 4 ++--
assets/tags/stat-tests.svg | 4 ++--
scripts/docs-sync.state.json | 4 ++--
37 files changed, 74 insertions(+), 74 deletions(-)
diff --git a/AGENTS.md b/AGENTS.md
index 3897c7910e..81b4eed6fa 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -101,7 +101,7 @@ Hook scripts in `src/hooks/` are standalone Node.js scripts (no iii-sdk import).
## Testing
-- Before every commit run, in order: `npm run build`, `npm run skills:gen`, `npm run docs:sync`, `npm run skills:check`, `npm test` (4,700+ tests). Commit anything the generators changed. CI runs the same build, skills check and tests.
+- Before every commit run, in order: `npm run build`, `npm run skills:gen`, `npm run docs:sync`, `npm run skills:check`, `npm test` (4,800+ tests). Commit anything the generators changed. CI runs the same build, skills check and tests.
- Before any npm publish: `npm run release:gate` must pass. It installs the packed tarballs into a clean home and runs capture, recovery, restart, export/import, MCP and status checks against the installed CLI (see CONTRIBUTING.md, Release process)
- Mock pattern: `vi.mock("iii-sdk")` with mock `sdk.trigger`, `kv.get/set/list`
- Test files go in `test/` with `.test.ts` extension
@@ -114,4 +114,4 @@ Hook scripts in `src/hooks/` are standalone Node.js scripts (no iii-sdk import).
- 6 MCP resources, 3 MCP prompts
- 12 hooks, 17 skills
- 322+ iii functions
-- 4,700+ tests
+- 4,800+ tests
diff --git a/README.md b/README.md
index cd40701a05..7590f939b8 100644
--- a/README.md
+++ b/README.md
@@ -69,7 +69,7 @@
-
+
@@ -1313,7 +1313,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Authorization:
```bash
npm run dev # Hot reload
npm run build # Production build
-npm test # 4,700+ tests
+npm test # 4,800+ tests
npm run test:integration # API tests (requires running services)
```
diff --git a/READMEs/README.ar-SA.md b/READMEs/README.ar-SA.md
index 19dfdad2f8..40b6c0699d 100644
--- a/READMEs/README.ar-SA.md
+++ b/READMEs/README.ar-SA.md
@@ -71,7 +71,7 @@
-
+
@@ -1244,7 +1244,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Authorization:
```bash
npm run dev # Hot reload
npm run build # Production build
-npm test # 4,700+ tests
+npm test # 4,800+ tests
npm run test:integration # API tests (requires running services)
```
diff --git a/READMEs/README.bn-BD.md b/READMEs/README.bn-BD.md
index a0881d0c27..b16b1f7bd4 100644
--- a/READMEs/README.bn-BD.md
+++ b/READMEs/README.bn-BD.md
@@ -69,7 +69,7 @@
-
+
@@ -1257,7 +1257,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Authorization:
```bash
npm run dev # Hot reload
npm run build # Production build
-npm test # 4,700+ tests
+npm test # 4,800+ tests
npm run test:integration # API tests (requires running services)
```
diff --git a/READMEs/README.cs-CZ.md b/READMEs/README.cs-CZ.md
index 3837c5eb6e..41c98ab4df 100644
--- a/READMEs/README.cs-CZ.md
+++ b/READMEs/README.cs-CZ.md
@@ -69,7 +69,7 @@
-
+
@@ -1243,7 +1243,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Authorization:
```bash
npm run dev # Hot reload
npm run build # Production build
-npm test # 4,700+ tests
+npm test # 4,800+ tests
npm run test:integration # API tests (requires running services)
```
diff --git a/READMEs/README.da-DK.md b/READMEs/README.da-DK.md
index 209257de1f..6e96f1ad65 100644
--- a/READMEs/README.da-DK.md
+++ b/READMEs/README.da-DK.md
@@ -69,7 +69,7 @@
-
+
@@ -1251,7 +1251,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Authorization:
```bash
npm run dev # Hot reload
npm run build # Production build
-npm test # 4,700+ tests
+npm test # 4,800+ tests
npm run test:integration # API tests (requires running services)
```
diff --git a/READMEs/README.de-DE.md b/READMEs/README.de-DE.md
index a0b4b683b8..f09b2211b6 100644
--- a/READMEs/README.de-DE.md
+++ b/READMEs/README.de-DE.md
@@ -69,7 +69,7 @@
-
+
@@ -1249,7 +1249,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Authorization:
```bash
npm run dev # Hot reload
npm run build # Production build
-npm test # 4,700+ tests
+npm test # 4,800+ tests
npm run test:integration # API tests (requires running services)
```
diff --git a/READMEs/README.el-GR.md b/READMEs/README.el-GR.md
index 49f0fb50b2..20190d727a 100644
--- a/READMEs/README.el-GR.md
+++ b/READMEs/README.el-GR.md
@@ -69,7 +69,7 @@
-
+
@@ -1243,7 +1243,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Authorization:
```bash
npm run dev # Hot reload
npm run build # Production build
-npm test # 4,700+ tests
+npm test # 4,800+ tests
npm run test:integration # API tests (requires running services)
```
diff --git a/READMEs/README.es-ES.md b/READMEs/README.es-ES.md
index 0cf25dab97..6ca88703a2 100644
--- a/READMEs/README.es-ES.md
+++ b/READMEs/README.es-ES.md
@@ -69,7 +69,7 @@
-
+
@@ -1245,7 +1245,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Authorization:
```bash
npm run dev # Hot reload
npm run build # Production build
-npm test # 4,700+ tests
+npm test # 4,800+ tests
npm run test:integration # API tests (requires running services)
```
diff --git a/READMEs/README.fi-FI.md b/READMEs/README.fi-FI.md
index c580718e9f..c82e700071 100644
--- a/READMEs/README.fi-FI.md
+++ b/READMEs/README.fi-FI.md
@@ -69,7 +69,7 @@
-
+
@@ -1243,7 +1243,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Authorization:
```bash
npm run dev # Hot reload
npm run build # Production build
-npm test # 4,700+ tests
+npm test # 4,800+ tests
npm run test:integration # API tests (requires running services)
```
diff --git a/READMEs/README.fr-FR.md b/READMEs/README.fr-FR.md
index 3f508c8454..981e72e4f9 100644
--- a/READMEs/README.fr-FR.md
+++ b/READMEs/README.fr-FR.md
@@ -69,7 +69,7 @@
-
+
@@ -1252,7 +1252,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Authorization:
```bash
npm run dev # Hot reload
npm run build # Production build
-npm test # 4,700+ tests
+npm test # 4,800+ tests
npm run test:integration # API tests (requires running services)
```
diff --git a/READMEs/README.he-IL.md b/READMEs/README.he-IL.md
index 73f6e4a233..313f456302 100644
--- a/READMEs/README.he-IL.md
+++ b/READMEs/README.he-IL.md
@@ -71,7 +71,7 @@
-
+
@@ -1244,7 +1244,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Authorization:
```bash
npm run dev # Hot reload
npm run build # Production build
-npm test # 4,700+ tests
+npm test # 4,800+ tests
npm run test:integration # API tests (requires running services)
```
diff --git a/READMEs/README.hi-IN.md b/READMEs/README.hi-IN.md
index 4c3a8d31e2..9bed3ca5eb 100644
--- a/READMEs/README.hi-IN.md
+++ b/READMEs/README.hi-IN.md
@@ -69,7 +69,7 @@
-
+
@@ -1258,7 +1258,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Authorization:
```bash
npm run dev # Hot reload
npm run build # Production build
-npm test # 4,700+ tests
+npm test # 4,800+ tests
npm run test:integration # API tests (requires running services)
```
diff --git a/READMEs/README.hu-HU.md b/READMEs/README.hu-HU.md
index 20d0e86604..819b196d68 100644
--- a/READMEs/README.hu-HU.md
+++ b/READMEs/README.hu-HU.md
@@ -69,7 +69,7 @@
-
+
@@ -1241,7 +1241,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Authorization:
```bash
npm run dev # Hot reload
npm run build # Production build
-npm test # 4,700+ tests
+npm test # 4,800+ tests
npm run test:integration # API tests (requires running services)
```
diff --git a/READMEs/README.id-ID.md b/READMEs/README.id-ID.md
index 855cd4dd52..a5813dcfc8 100644
--- a/READMEs/README.id-ID.md
+++ b/READMEs/README.id-ID.md
@@ -69,7 +69,7 @@
-
+
@@ -1258,7 +1258,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Authorization:
```bash
npm run dev # Hot reload
npm run build # Production build
-npm test # 4,700+ tests
+npm test # 4,800+ tests
npm run test:integration # API tests (requires running services)
```
diff --git a/READMEs/README.it-IT.md b/READMEs/README.it-IT.md
index cd396e06e9..a2e6f3aa8e 100644
--- a/READMEs/README.it-IT.md
+++ b/READMEs/README.it-IT.md
@@ -69,7 +69,7 @@
-
+
@@ -1251,7 +1251,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Authorization:
```bash
npm run dev # Hot reload
npm run build # Production build
-npm test # 4,700+ tests
+npm test # 4,800+ tests
npm run test:integration # API tests (requires running services)
```
diff --git a/READMEs/README.ja-JP.md b/READMEs/README.ja-JP.md
index 9dfe1e726c..412d9f4224 100644
--- a/READMEs/README.ja-JP.md
+++ b/READMEs/README.ja-JP.md
@@ -69,7 +69,7 @@
-
+
@@ -1257,7 +1257,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Authorization:
```bash
npm run dev # Hot reload
npm run build # Production build
-npm test # 4,700+ tests
+npm test # 4,800+ tests
npm run test:integration # API tests (requires running services)
```
diff --git a/READMEs/README.ko-KR.md b/READMEs/README.ko-KR.md
index 4c77e312b0..db1bee6bd2 100644
--- a/READMEs/README.ko-KR.md
+++ b/READMEs/README.ko-KR.md
@@ -69,7 +69,7 @@
-
+
@@ -1256,7 +1256,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Authorization:
```bash
npm run dev # Hot reload
npm run build # Production build
-npm test # 4,700+ tests
+npm test # 4,800+ tests
npm run test:integration # API tests (requires running services)
```
diff --git a/READMEs/README.nb-NO.md b/READMEs/README.nb-NO.md
index e617bec5e1..def9fa24d0 100644
--- a/READMEs/README.nb-NO.md
+++ b/READMEs/README.nb-NO.md
@@ -69,7 +69,7 @@
-
+
@@ -1249,7 +1249,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Authorization:
```bash
npm run dev # Hot reload
npm run build # Production build
-npm test # 4,700+ tests
+npm test # 4,800+ tests
npm run test:integration # API tests (requires running services)
```
diff --git a/READMEs/README.nl-NL.md b/READMEs/README.nl-NL.md
index ab0aa4972b..a41ab0bf2e 100644
--- a/READMEs/README.nl-NL.md
+++ b/READMEs/README.nl-NL.md
@@ -69,7 +69,7 @@
-
+
@@ -1245,7 +1245,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Authorization:
```bash
npm run dev # Hot reload
npm run build # Production build
-npm test # 4,700+ tests
+npm test # 4,800+ tests
npm run test:integration # API tests (requires running services)
```
diff --git a/READMEs/README.pl-PL.md b/READMEs/README.pl-PL.md
index c24834e624..be1064ea75 100644
--- a/READMEs/README.pl-PL.md
+++ b/READMEs/README.pl-PL.md
@@ -69,7 +69,7 @@
-
+
@@ -1241,7 +1241,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Authorization:
```bash
npm run dev # Hot reload
npm run build # Production build
-npm test # 4,700+ tests
+npm test # 4,800+ tests
npm run test:integration # API tests (requires running services)
```
diff --git a/READMEs/README.pt-BR.md b/READMEs/README.pt-BR.md
index 8cba9a4b83..14023e43ce 100644
--- a/READMEs/README.pt-BR.md
+++ b/READMEs/README.pt-BR.md
@@ -69,7 +69,7 @@
-
+
@@ -1249,7 +1249,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Authorization:
```bash
npm run dev # Hot reload
npm run build # Production build
-npm test # 4,700+ tests
+npm test # 4,800+ tests
npm run test:integration # API tests (requires running services)
```
diff --git a/READMEs/README.pt-PT.md b/READMEs/README.pt-PT.md
index c237b780d8..3f2e79bb91 100644
--- a/READMEs/README.pt-PT.md
+++ b/READMEs/README.pt-PT.md
@@ -69,7 +69,7 @@
-
+
@@ -1245,7 +1245,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Authorization:
```bash
npm run dev # Hot reload
npm run build # Production build
-npm test # 4,700+ tests
+npm test # 4,800+ tests
npm run test:integration # API tests (requires running services)
```
diff --git a/READMEs/README.ro-RO.md b/READMEs/README.ro-RO.md
index 620d55913d..91d70e2ffe 100644
--- a/READMEs/README.ro-RO.md
+++ b/READMEs/README.ro-RO.md
@@ -69,7 +69,7 @@
-
+
@@ -1237,7 +1237,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Authorization:
```bash
npm run dev # Hot reload
npm run build # Production build
-npm test # 4,700+ tests
+npm test # 4,800+ tests
npm run test:integration # API tests (requires running services)
```
diff --git a/READMEs/README.ru-RU.md b/READMEs/README.ru-RU.md
index 3086998cdd..aed56590dc 100644
--- a/READMEs/README.ru-RU.md
+++ b/READMEs/README.ru-RU.md
@@ -69,7 +69,7 @@
-
+
@@ -1243,7 +1243,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Authorization:
```bash
npm run dev # Hot reload
npm run build # Production build
-npm test # 4,700+ tests
+npm test # 4,800+ tests
npm run test:integration # API tests (requires running services)
```
diff --git a/READMEs/README.sv-SE.md b/READMEs/README.sv-SE.md
index c29d00dbee..fc2f4d5b80 100644
--- a/READMEs/README.sv-SE.md
+++ b/READMEs/README.sv-SE.md
@@ -69,7 +69,7 @@
-
+
@@ -1251,7 +1251,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Authorization:
```bash
npm run dev # Hot reload
npm run build # Production build
-npm test # 4,700+ tests
+npm test # 4,800+ tests
npm run test:integration # API tests (requires running services)
```
diff --git a/READMEs/README.th-TH.md b/READMEs/README.th-TH.md
index 49a0e9ce46..fa1bd6d710 100644
--- a/READMEs/README.th-TH.md
+++ b/READMEs/README.th-TH.md
@@ -69,7 +69,7 @@
-
+
@@ -1244,7 +1244,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Authorization:
```bash
npm run dev # Hot reload
npm run build # Production build
-npm test # 4,700+ tests
+npm test # 4,800+ tests
npm run test:integration # API tests (requires running services)
```
diff --git a/READMEs/README.tl-PH.md b/READMEs/README.tl-PH.md
index 9eacba7baf..27cec827c0 100644
--- a/READMEs/README.tl-PH.md
+++ b/READMEs/README.tl-PH.md
@@ -69,7 +69,7 @@
-
+
@@ -1253,7 +1253,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Authorization:
```bash
npm run dev # Hot reload
npm run build # Production build
-npm test # 4,700+ tests
+npm test # 4,800+ tests
npm run test:integration # API tests (requires running services)
```
diff --git a/READMEs/README.tr-TR.md b/READMEs/README.tr-TR.md
index f1aa62a40a..d26df964c2 100644
--- a/READMEs/README.tr-TR.md
+++ b/READMEs/README.tr-TR.md
@@ -69,7 +69,7 @@
-
+
@@ -1243,7 +1243,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Authorization:
```bash
npm run dev # Hot reload
npm run build # Production build
-npm test # 4,700+ tests
+npm test # 4,800+ tests
npm run test:integration # API tests (requires running services)
```
diff --git a/READMEs/README.uk-UA.md b/READMEs/README.uk-UA.md
index 11019c61fe..08832163f6 100644
--- a/READMEs/README.uk-UA.md
+++ b/READMEs/README.uk-UA.md
@@ -69,7 +69,7 @@
-
+
@@ -1244,7 +1244,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Authorization:
```bash
npm run dev # Hot reload
npm run build # Production build
-npm test # 4,700+ tests
+npm test # 4,800+ tests
npm run test:integration # API tests (requires running services)
```
diff --git a/READMEs/README.ur-PK.md b/READMEs/README.ur-PK.md
index a4a9b37b3c..c61fdbc3ef 100644
--- a/READMEs/README.ur-PK.md
+++ b/READMEs/README.ur-PK.md
@@ -71,7 +71,7 @@
-
+
@@ -1248,7 +1248,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Authorization:
```bash
npm run dev # Hot reload
npm run build # Production build
-npm test # 4,700+ tests
+npm test # 4,800+ tests
npm run test:integration # API tests (requires running services)
```
diff --git a/READMEs/README.vi-VN.md b/READMEs/README.vi-VN.md
index 47177b4c47..6b3d54b63f 100644
--- a/READMEs/README.vi-VN.md
+++ b/READMEs/README.vi-VN.md
@@ -69,7 +69,7 @@
-
+
@@ -1253,7 +1253,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Authorization:
```bash
npm run dev # Hot reload
npm run build # Production build
-npm test # 4,700+ tests
+npm test # 4,800+ tests
npm run test:integration # API tests (requires running services)
```
diff --git a/READMEs/README.zh-CN.md b/READMEs/README.zh-CN.md
index 0a5f9c2d05..e7a3f90896 100644
--- a/READMEs/README.zh-CN.md
+++ b/READMEs/README.zh-CN.md
@@ -69,7 +69,7 @@
-
+
@@ -1254,7 +1254,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Authorization:
```bash
npm run dev # Hot reload
npm run build # Production build
-npm test # 4,700+ tests
+npm test # 4,800+ tests
npm run test:integration # API tests (requires running services)
```
diff --git a/READMEs/README.zh-TW.md b/READMEs/README.zh-TW.md
index c2e315c886..74e1eca426 100644
--- a/READMEs/README.zh-TW.md
+++ b/READMEs/README.zh-TW.md
@@ -69,7 +69,7 @@
-
+
@@ -1246,7 +1246,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Authorization:
```bash
npm run dev # Hot reload
npm run build # Production build
-npm test # 4,700+ tests
+npm test # 4,800+ tests
npm run test:integration # API tests (requires running services)
```
diff --git a/assets/tags/light/stat-tests.svg b/assets/tags/light/stat-tests.svg
index 1b4179cfc2..743b0d095d 100644
--- a/assets/tags/light/stat-tests.svg
+++ b/assets/tags/light/stat-tests.svg
@@ -1,5 +1,5 @@
-