memorix 1.8.8 → 1.9.0

package/plugins/antigravity/memorix/plugin.json

@@ -1,4 +1,4 @@
 {
   "name": "memorix",
-  "version": "1.8.8"
+  "version": "1.9.0"
 }

package/plugins/claude/memorix/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://anthropic.com/claude-code/plugin.schema.json",
   "name": "memorix",
-  "version": "1.8.8",
+  "version": "1.9.0",
   "description": "Shared workspace memory for Claude Code and other AI coding agents.",
   "author": {
     "name": "AVIDS2",

package/plugins/codebuddy/memorix/.codebuddy-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "memorix",
-  "version": "1.8.8",
+  "version": "1.9.0",
   "description": "Local-first project memory for CodeBuddy Code and other coding agents.",
   "author": {
     "name": "AVIDS2",

package/plugins/codex/memorix/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "memorix",
-  "version": "1.8.8",
+  "version": "1.9.0",
   "description": "Shared workspace memory for Codex and other AI coding agents.",
   "author": {
     "name": "AVIDS2",

package/plugins/copilot/memorix/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "memorix",
-  "version": "1.8.8",
+  "version": "1.9.0",
   "description": "Shared local workspace memory for GitHub Copilot CLI and other AI coding agents.",
   "author": {
     "name": "AVIDS2",

package/plugins/gemini/memorix/gemini-extension.json

@@ -1,6 +1,6 @@
 {
   "name": "memorix",
-  "version": "1.8.8",
+  "version": "1.9.0",
   "mcpServers": {
     "memorix": {
       "command": "memorix",

package/plugins/hermes/memorix/plugin.yaml

@@ -1,5 +1,5 @@
 name: memorix
-version: "1.8.8"
+version: "1.9.0"
 description: Shared workspace memory bridge for Hermes Agent.
 author: AVIDS2
 license: Apache-2.0

package/plugins/omp/memorix/package.json

@@ -1,6 +1,6 @@
 {
   "name": "memorix-omp-package",
-  "version": "1.8.8",
+  "version": "1.9.0",
   "description": "Memorix shared workspace memory package for Oh-my-Pi.",
   "license": "Apache-2.0",
   "keywords": [

package/plugins/openclaw/memorix/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "memorix",
-  "version": "1.8.8",
+  "version": "1.9.0",
   "description": "Shared workspace memory for OpenClaw and other AI coding agents.",
   "author": {
     "name": "AVIDS2",

package/plugins/pi/memorix/package.json

@@ -1,6 +1,6 @@
 {
   "name": "memorix-pi-package",
-  "version": "1.8.8",
+  "version": "1.9.0",
   "description": "Memorix shared workspace memory package for Pi coding agent.",
   "license": "Apache-2.0",
   "keywords": [

package/server.json

@@ -7,7 +7,7 @@
     "url": "https://github.com/AVIDS2/memorix",
     "source": "github"
   },
-  "version": "1.8.8",
+  "version": "1.9.0",
   "websiteUrl": "https://mem.rglens.com",
   "icons": [
     {
@@ -22,7 +22,7 @@
     {
       "registryType": "npm",
       "identifier": "memorix",
-      "version": "1.8.8",
+      "version": "1.9.0",
       "runtimeHint": "npx",
       "packageArguments": [
         {

package/src/cli/command-guide.ts

@@ -209,7 +209,15 @@ const GUIDES: Record<string, CliCommandGuide> = {
   },
   sync: {
     summary: 'Synchronize agent rules and workspace artifacts through explicit routes.',
-    usage: ['memorix sync rules --action status', 'memorix sync workspace --action scan'],
+    usage: [
+      'memorix sync rules --action status',
+      'memorix sync workspace --action scan',
+      'memorix sync store status --json',
+      'memorix sync store push|pull [--dry] [--json]',
+      'memorix sync store compact --dry --through device=sequence',
+      'memorix sync store device rotate',
+    ],
+    notes: ['Store sync is opt-in, project-scoped, and never copies the live SQLite database.'],
   },
   ingest: {
     summary: 'Ingest Git and image evidence into project memory.',

package/src/cli/commands/agent-integrations.ts

@@ -126,6 +126,7 @@ const GUIDANCE_AGENTS = new Set<AgentName>([
   'trae',
   'dsh',
   'workbuddy',
+  'grok',
 ]);
 
 const CODEX_PLUGIN_NAME = 'memorix';
@@ -167,7 +168,7 @@ function worstStatus(statuses: AgentIntegrationStatus[]): AgentIntegrationStatus
 }
 
 function isMcpConfigAgent(agent: AgentName): agent is McpConfigAgent {
-  return agent !== 'pi';
+  return agent !== 'pi' && agent !== 'grok';
 }
 
 function isActionableMcpRepairIssue(issue: string): boolean {

package/src/cli/commands/hooks-install.ts

@@ -166,6 +166,7 @@ function getAgentLabel(agent: string): string {
     trae: 'Trae',
     dsh: 'DeepSeek Harness',
     workbuddy: 'WorkBuddy',
+    grok: 'Grok Build',
   };
   return labels[agent] || agent;
 }
@@ -186,6 +187,7 @@ function getAgentHint(agent: string): string {
     trae: '.trae/rules/project_rules.md (rules only, no hooks system)',
     dsh: '~/.dsh/cordis.patch.yml MCP row via `memorix setup --agent dsh` (no hooks system)',
     workbuddy: '~/.workbuddy/mcp.json MCP row via `memorix setup --agent workbuddy` (no hooks system)',
+    grok: '~/.grok/hooks/memorix.json (own file, not RuleSync dest)',
     codex: 'Codex plugin hooks; use `memorix setup --agent codex`',
   };
   return hints[agent] || '';

package/src/cli/commands/integrate.ts

@@ -116,6 +116,7 @@ function getAgentLabel(agent: string): string {
     trae: 'Trae',
     dsh: 'DeepSeek Harness',
     workbuddy: 'WorkBuddy',
+    grok: 'Grok Build',
   };
   return labels[agent] || agent;
 }
@@ -134,6 +135,7 @@ function getAgentHint(agent: string): string {
     trae: 'rules',
     dsh: 'MCP patch + AGENTS.md + skills',
     workbuddy: 'MCP + AGENTS.md',
+    grok: 'hooks file (~/.grok/hooks/memorix.json)',
   };
   return hints[agent] || 'integration files';
 }

package/src/cli/commands/serve-http.ts

@@ -21,6 +21,7 @@
 
 import { defineCommand } from 'citty';
 import type { IncomingMessage, ServerResponse } from 'node:http';
+import { getHeapStatistics } from 'node:v8';
 import type { ObservationStore } from '../../store/obs-store.js';
 import { resolveToolProfile } from '../../server/tool-profile.js';
 import { scopeKnowledgeGraphToProject } from '../../memory/graph-scope.js';
@@ -1714,6 +1715,8 @@ export default defineCommand({
       // This is the readiness signal for background start / status.
       if (url.pathname === '/health') {
         const { getEmbeddingRuntimeHealth } = await import('../../embedding/provider.js');
+        const memory = process.memoryUsage();
+        const heap = getHeapStatistics();
         res.writeHead(200, { 'Content-Type': 'application/json' });
         res.end(JSON.stringify({
           status: 'ok',
@@ -1725,6 +1728,14 @@ export default defineCommand({
           projectId: defaultProject?.id ?? '__unresolved__',
           projectName: defaultProject?.name ?? null,
           readyAt: httpReadyAt,
+          memory: {
+            rss: memory.rss,
+            heapUsed: memory.heapUsed,
+            heapTotal: memory.heapTotal,
+            external: memory.external,
+            arrayBuffers: memory.arrayBuffers,
+            heapLimit: heap.heap_size_limit,
+          },
           embedding: getEmbeddingRuntimeHealth(),
         }));
         return;

package/src/cli/commands/setup.ts

@@ -195,6 +195,7 @@ const SUPPORTED_SETUP_AGENTS: AgentName[] = [
   'dsh',
   'workbuddy',
   'pi',
+  'grok',
 ];
 
 export function getSetupAgentTargets(): AgentName[] {
@@ -211,7 +212,9 @@ export function buildSetupPlan(options: {
   plugin?: boolean;
   global?: boolean;
 }): SetupPlan {
-  const mcp = options.mcp ?? 'stdio';
+  // Grok owns its MCP configuration through `grok mcp`; Memorix setup only
+  // installs the independent hooks/rules integration for this target.
+  const mcp = options.agent === 'grok' ? 'none' : options.mcp ?? 'stdio';
   const actions: SetupAction[] = [];
   const isPackageOwnedAgent = options.agent !== 'all' && PACKAGE_OWNED_INTEGRATION_AGENTS.has(options.agent);
   const includeHooks = options.hooks ?? true;
@@ -388,7 +391,7 @@ function relativePosix(from: string, to: string): string {
   return rel;
 }
 
-export type McpConfigAgent = Exclude<AgentName, 'pi'>;
+export type McpConfigAgent = Exclude<AgentName, 'pi' | 'grok'>;
 
 export function getMcpAdapter(agent: McpConfigAgent): MCPConfigAdapter {
   const adapters: Record<McpConfigAgent, MCPConfigAdapter> = {
@@ -1453,7 +1456,7 @@ export async function installAgentSetup(agent: AgentName, plan: SetupPlan, globa
   const hasCodeBuddyPlugin = plan.actions.includes('codebuddy-plugin') && agent === 'codebuddy';
   // Codex's supported default is the user-level plugin. Never create a
   // project-local .codex/config.toml as an implicit fallback.
-  const wantsMcpConfig = plan.mcp !== 'none' && agent !== 'pi' && !(agent === 'codex' && !global);
+  const wantsMcpConfig = plan.mcp !== 'none' && agent !== 'pi' && agent !== 'grok' && !(agent === 'codex' && !global);
 
   if (PLUGIN_PACKAGE_AGENTS.has(agent) && plan.includePlugin && !global) {
     p.log.info(`${agent}: project setup leaves user-level plugins untouched. Run \`memorix setup --agent ${agent} --global\` to install its plugin, skills, and lifecycle hooks.`);
@@ -1633,6 +1636,9 @@ export async function installAgentSetup(agent: AgentName, plan: SetupPlan, globa
 
   if (agent === 'pi') {
     p.log.info('pi: Pi has no MCP config lane in the current CLI; use the installed package extension and skill.');
+  } else if (agent === 'grok') {
+    p.log.info('grok: lifecycle hooks write ~/.grok/hooks/memorix.json. MCP stays host-owned (do not write config.toml).');
+    if (!global) p.log.info('grok: project hooks require `/hooks-trust` or launching Grok with `--trust`.');
   } else if (plan.mcp === 'stdio') {
     p.log.info(`${agent}: MCP server command is \`memorix serve\``);
   } else if (plan.mcp === 'http') {
@@ -1669,7 +1675,7 @@ export default defineCommand({
   args: {
     agent: {
       type: 'string',
-      description: 'Target agent (claude, codex, codebuddy, opencode, cursor, windsurf, copilot, gemini-cli, antigravity, openclaw, hermes, omp, kiro, trae, dsh, pi, all)',
+      description: 'Target agent (claude, codex, codebuddy, opencode, cursor, windsurf, copilot, gemini-cli, antigravity, openclaw, hermes, omp, kiro, trae, dsh, pi, grok, all)',
       required: false,
     },
     mcp: {
@@ -1738,6 +1744,7 @@ export default defineCommand({
           { value: 'codex', label: 'Codex', hint: 'plugin package + marketplace + MCP' },
           { value: 'copilot', label: 'GitHub Copilot CLI', hint: 'plugin package + hooks + MCP' },
           { value: 'cursor', label: 'Cursor', hint: 'MCP + rules + skills' },
+          { value: 'grok', label: 'Grok Build', hint: 'hooks file; MCP stays host-owned' },
           { value: 'gemini-cli', label: 'Gemini CLI', hint: 'extension + MCP' },
           { value: 'openclaw', label: 'OpenClaw', hint: 'bundle + hook pack + skills + MCP' },
           { value: 'hermes', label: 'Hermes Agent', hint: 'plugin + hooks + commands + skills + MCP' },

package/src/cli/commands/sync-store.ts

@@ -0,0 +1,191 @@
+/**
+ * `memorix sync store <push|pull|status>` — multi-device store replication.
+ *
+ * Separated from `memorix sync rules|workspace` (cross-agent rules) so the two
+ * meanings of "sync" never collide. Store sync is opt-in and provider-agnostic;
+ * the remote is selected by `MEMORIX_SYNC_PROVIDER`.
+ */
+
+import { defineCommand } from 'citty';
+
+import { getCliProjectContext, emitError, emitResult } from './operator-shared.js';
+import { getObservationStore, initObservationStore } from '../../store/obs-store.js';
+import { runSync } from '../../sync/engine.js';
+import { createSqliteSyncStore } from '../../sync/store-port.js';
+import { resolveSyncConfig, createRemote } from '../../sync/remote-factory.js';
+import type { SyncReport } from '../../sync/types.js';
+
+function renderReport(report: SyncReport): string {
+  const lines = [
+    `Store sync (${report.remote}) — device ${report.deviceId}${report.dryRun ? ' [dry-run]' : ''}`,
+    `- Pushed changes:   ${report.pushed}`,
+    `- Pulled batches:   ${report.pulledBatches}`,
+    `- Applied upserts:  ${report.applied}`,
+    `- Applied deletes:  ${report.tombstoned}`,
+    `- Skipped (older):  ${report.skipped}`,
+    `- Excluded locally:  ${report.excluded}`,
+    `- Conflicts recorded: ${report.conflicts}`,
+    `- Pending outbox:    ${report.pending}`,
+  ];
+  if (report.dryRun && report.decisions.length > 0) {
+    lines.push('', 'Decisions:');
+    for (const d of report.decisions) {
+      lines.push(`  ${d.syncKey} ${d.kind} -> ${d.outcome} (${d.reason})`);
+    }
+  }
+  return lines.join('\n');
+}
+
+export default defineCommand({
+  meta: {
+    name: 'sync-store',
+    description: 'Replicate the local observation store across your devices (opt-in, provider-agnostic)',
+  },
+  args: {
+    dry: { type: 'boolean', description: 'Preview changes without writing anything', default: false },
+    json: { type: 'boolean', description: 'Emit JSON', default: false },
+    'push-only': { type: 'boolean', description: 'Only push local changes', default: false },
+    'pull-only': { type: 'boolean', description: 'Only pull remote changes', default: false },
+    through: { type: 'string', description: 'Compaction cutoff: device=sequence,device=sequence' },
+    yes: { type: 'boolean', description: 'Confirm destructive remote compaction', default: false },
+  },
+  run: async ({ args }) => {
+    const asJson = Boolean(args.json);
+    const action = (args._ as string[])?.[0] || 'status';
+    if (action === 'device') {
+      const { project, dataDir } = await getCliProjectContext();
+      await initObservationStore(dataDir);
+      const syncStore = createSqliteSyncStore(dataDir, getObservationStore(), project.id);
+      const subaction = (args._ as string[])?.[1] || '';
+      if (subaction !== 'rotate') {
+        emitError('expected "memorix sync store device rotate"', asJson);
+        process.exitCode = 2;
+        return;
+      }
+      const deviceId = syncStore.rotateDevice();
+      emitResult({ project: project.id, deviceId, rotated: true }, `Sync device identity rotated: ${deviceId}`, asJson);
+      return;
+    }
+    if (action !== 'push' && action !== 'pull' && action !== 'status' && action !== 'compact') {
+      emitError(`unknown action "${action}" (expected push|pull|status|compact|device rotate)`, asJson);
+      process.exitCode = 2;
+      return;
+    }
+
+    let config;
+    try {
+      config = resolveSyncConfig();
+    } catch (err) {
+      emitError((err as Error).message, asJson);
+      process.exitCode = 2;
+      return;
+    }
+
+    if (!config.enabled || !config.provider) {
+      emitResult(
+        { enabled: false },
+        'Store sync is disabled. Set MEMORIX_SYNC_PROVIDER=fs|github|s3|postgres to enable it.',
+        asJson,
+      );
+      return;
+    }
+
+    const { project, dataDir } = await getCliProjectContext();
+    await initObservationStore(dataDir);
+    const obsStore = getObservationStore();
+    const syncStore = createSqliteSyncStore(dataDir, obsStore, project.id);
+
+    if (action === 'compact') {
+      if (!args.yes && !args.dry) {
+        emitError('remote compaction deletes relay events; repeat with --yes after specifying --through device=sequence', asJson);
+        process.exitCode = 2;
+        return;
+      }
+      const raw = String(args.through ?? '');
+      const through: Record<string, number> = {};
+      for (const item of raw.split(',').map((value) => value.trim()).filter(Boolean)) {
+        const [device, sequence] = item.split('=', 2);
+        const parsed = Number(sequence);
+        if (!device || !Number.isSafeInteger(parsed) || parsed < 0) {
+          emitError('invalid --through; expected device=sequence[,device=sequence]', asJson);
+          process.exitCode = 2;
+          return;
+        }
+        through[device] = parsed;
+      }
+      if (Object.keys(through).length === 0) {
+        emitError('--through is required for compaction', asJson);
+        process.exitCode = 2;
+        return;
+      }
+      let remote;
+      try {
+        remote = await createRemote(config.provider, syncStore.namespace());
+      } catch (err) {
+        emitError((err as Error).message, asJson);
+        process.exitCode = 1;
+        return;
+      }
+      try {
+        await remote.init({ create: false });
+        const result = await remote.compact(through, { dryRun: Boolean(args.dry) });
+        emitResult({ project: project.id, through, ...result, dryRun: Boolean(args.dry) }, `Compaction candidates: ${result.candidates}; deleted: ${result.deleted}`, asJson);
+      } catch (err) {
+        emitError((err as Error).message, asJson);
+        process.exitCode = 1;
+      } finally {
+        await remote.close();
+      }
+      return;
+    }
+
+    if (action === 'status') {
+      let remote;
+      try {
+        remote = await createRemote(config.provider, syncStore.namespace());
+      } catch (err) {
+        emitError((err as Error).message, asJson);
+        process.exitCode = 1;
+        return;
+      }
+      try {
+        const report = await runSync(syncStore, remote, {
+          deviceId: syncStore.deviceId(),
+          dryRun: true,
+          push: true,
+          pull: true,
+        });
+        emitResult({ project: project.id, ...report }, renderReport(report), asJson);
+      } catch (err) {
+        emitError((err as Error).message, asJson);
+        process.exitCode = 1;
+      }
+      return;
+    }
+
+    const doPush = action === 'push' || !args['pull-only'];
+    const doPull = action === 'pull' || !args['push-only'];
+
+    let remote;
+    try {
+      remote = await createRemote(config.provider, syncStore.namespace());
+    } catch (err) {
+      emitError((err as Error).message, asJson);
+      process.exitCode = 1;
+      return;
+    }
+
+    try {
+      const report = await runSync(syncStore, remote, {
+        deviceId: syncStore.deviceId(),
+        dryRun: Boolean(args.dry),
+        push: doPush,
+        pull: doPull,
+      });
+      emitResult({ project: project.id, ...report }, renderReport(report), asJson);
+    } catch (err) {
+      emitError((err as Error).message, asJson);
+      process.exitCode = 1;
+    }
+  },
+});

package/src/cli/commands/sync.ts

@@ -51,6 +51,14 @@ export default defineCommand({
   },
   run: async ({ args }) => {
     const section = (args._ as string[])?.[0] || '';
+
+    // Store replication is a distinct concern from rules/workspace sync.
+    if (section === 'store') {
+      const storeCmd = (await import('./sync-store.js')).default;
+      const rest = (args._ as string[]).slice(1);
+      await storeCmd.run!({ args: { ...args, _: rest } } as never);
+      return;
+    }
     const asJson = !!args.json;
 
     if (section === 'rules' || section === 'workspace') {

package/src/hooks/handler.ts

@@ -737,6 +737,12 @@ export function formatHookOutput(
     };
   }
 
+  // Grok's documented hook contract only gives passive hooks a success exit
+  // signal; it does not define a Claude-style additionalContext response.
+  // Returning an empty object keeps Memorix capture-only and never changes
+  // Grok's prompt, tool, or stop decisions.
+  if (agent === 'grok') return {};
+
   const finalOutput: Record<string, unknown> = { ...output };
   const hookSpecificOutputEvents = new Set([
     'PreToolUse',