recallx-headless 1.0.8 → 1.2.0

package/README.md

@@ -154,8 +154,10 @@ recallx workspace open --root /Users/name/Documents/RecallX-Test
 - Default API base: `http://127.0.0.1:8787/api/v1`
 - `recallx serve` starts the local RecallX API in-process from the installed package
 - The CLI stays thin for day-to-day API operations and defers behavior to the HTTP API contract
+- MCP tool results keep `structuredContent` as the authoritative payload; when possible the text mirror is a compact deterministic summary rather than a pretty JSON dump
 - `--format json` is useful when scripting, while `--format markdown` is best for `context`
 - `workspace open` switches the active workspace in the running local RecallX service without restarting the server
 - `recallx-mcp` is the direct stdio MCP entrypoint from the npm package
+- MCP tool results keep `structuredContent` authoritative and may render `content.text` as a compact deterministic summary instead of a pretty JSON mirror
 - See the root [`README.md`](../../README.md) for source-run usage and install paths
 - See [`docs/mcp.md`](../../docs/mcp.md) for editor MCP wiring details

package/app/cli/src/cli.js

@@ -6,7 +6,7 @@ import { fileURLToPath, pathToFileURL } from "node:url";
 import { getApiBase, getAuthToken, requestJson } from "./http.js";
 import { RECALLX_VERSION } from "../../shared/version.js";
 import { applyCliUpdate, getCliUpdatePlan } from "./update.js";
-import { renderActivitySearchResults, renderBundleMarkdown, renderGovernanceIssues, renderJson, renderNode, renderRelated, renderSearchResults, renderTelemetryErrors, renderTelemetrySummary, renderText, renderUpdateResult, renderWorkspaceSearchResults, renderWorkspaces, } from "./format.js";
+import { renderActivitySearchResults, renderBundleMarkdown, renderGovernanceIssues, renderJson, renderNode, renderRelated, renderSearchResults, renderTelemetryErrors, renderTelemetrySummary, renderText, renderUpdateResult, renderWorkspaceBackups, renderWorkspaceSearchResults, renderWorkspaces, } from "./format.js";
 const DEFAULT_SOURCE = {
     actorType: "human",
     actorLabel: "recallx-cli",
@@ -465,6 +465,27 @@ async function runWorkspace(apiBase, token, format, args, positionals) {
                 action,
                 rootPath: args.root || args.path || positionals[1],
             });
+        case "backups": {
+            const data = await requestJson(apiBase, "/workspaces/backups", { token });
+            outputData(data, format, "workspace-backups");
+            return;
+        }
+        case "backup":
+            return runPostCommand(apiBase, token, format, "/workspaces/backups", "workspace-backup", {
+                label: args.label || args.name || positionals[1],
+            });
+        case "export":
+            return runPostCommand(apiBase, token, format, "/workspaces/export", "workspace-export", {
+                format: args.format || args.kind || "json",
+            });
+        case "restore":
+            validateRequired(args.backup || args.id || positionals[1], "workspace restore requires --backup");
+            validateRequired(args.root || args.path || positionals[2], "workspace restore requires --root");
+            return runPostCommand(apiBase, token, format, "/workspaces/restore", "workspace-restore", {
+                backupId: args.backup || args.id || positionals[1],
+                targetRootPath: args.root || args.path || positionals[2],
+                workspaceName: args.name || args.title,
+            });
     }
     throw new Error(`Unknown workspace action: ${action}`);
 }
@@ -547,6 +568,9 @@ function outputData(data, format, command) {
         case "workspace-list":
             writeStdout(renderWorkspaces(payload));
             return;
+        case "workspace-backups":
+            writeStdout(renderWorkspaceBackups(payload));
+            return;
         case "append":
         case "create":
         case "link":
@@ -557,6 +581,9 @@ function outputData(data, format, command) {
         case "workspace-current":
         case "workspace-create":
         case "workspace-open":
+        case "workspace-backup":
+        case "workspace-export":
+        case "workspace-restore":
             writeStdout(renderText(payload));
             return;
         case "observability-summary":
@@ -696,6 +723,10 @@ Usage:
   recallx workspace list
   recallx workspace create --root /path/to/workspace [--name "Personal"]
   recallx workspace open --root /path/to/workspace
+  recallx workspace backups
+  recallx workspace backup [--label "before-upgrade"]
+  recallx workspace export [--format json|markdown]
+  recallx workspace restore --backup <id> --root /path/to/restore [--name "Recovered"]
   recallx observability summary [--since 24h]
   recallx observability errors [--since 24h] [--surface mcp] [--limit 50]
 

package/app/cli/src/format.js

@@ -144,6 +144,20 @@ export function renderWorkspaces(data) {
     .join("\n\n")}\n`;
 }
 
+export function renderWorkspaceBackups(data) {
+  const items = data?.items || [];
+  if (!items.length) {
+    return "No backups.\n";
+  }
+
+  return `${items
+    .map(
+      (item, index) =>
+        `${index + 1}. ${item.label || item.id}\n  id: ${item.id}\n  created: ${item.createdAt}\n  path: ${item.backupPath}`,
+    )
+    .join("\n\n")}\n`;
+}
+
 export function renderUpdateResult(data) {
   const lines = [
     `package: ${data?.packageName || ""}`,
@@ -206,8 +220,18 @@ export function renderTelemetrySummary(data) {
     `since: ${data?.since || ""}`,
     `logs: ${data?.logsPath || ""}`,
     `events: ${data?.totalEvents ?? 0}`,
+    `slow threshold: ${data?.slowRequestThresholdMs ?? ""}ms`,
   ];
 
+  const hot = Array.isArray(data?.hotOperations) ? data.hotOperations : [];
+  if (hot.length > 0) {
+    lines.push("");
+    lines.push("Hot operations:");
+    for (const item of hot.slice(0, 5)) {
+      lines.push(`- [${item.surface}] ${item.operation} p95=${item.p95DurationMs ?? ""}ms errors=${item.errorCount}/${item.count}`);
+    }
+  }
+
   const slow = Array.isArray(data?.slowOperations) ? data.slowOperations : [];
   if (slow.length > 0) {
     lines.push("");

package/app/mcp/index.js

@@ -45,7 +45,7 @@ async function resolveObservabilityState() {
             workspaceRoot: typeof workspace.rootPath === "string" ? workspace.rootPath : process.cwd(),
             workspaceName: typeof workspace.workspaceName === "string" ? workspace.workspaceName : "RecallX MCP",
             retentionDays: typeof values["observability.retentionDays"] === "number" ? values["observability.retentionDays"] : 14,
-            slowRequestMs: typeof values["observability.slowRequestMs"] === "number" ? values["observability.slowRequestMs"] : 250,
+            slowRequestMs: typeof values["observability.slowRequestMs"] === "number" ? values["observability.slowRequestMs"] : 50,
             capturePayloadShape: values["observability.capturePayloadShape"] !== false
         };
     }
@@ -55,7 +55,7 @@ async function resolveObservabilityState() {
             workspaceRoot: process.cwd(),
             workspaceName: "RecallX MCP",
             retentionDays: 14,
-            slowRequestMs: 250,
+            slowRequestMs: 50,
             capturePayloadShape: true
         };
     }