memorix 1.2.8 → 1.2.10

package/docs/AGENT_OPERATOR_PLAYBOOK.md

@@ -243,7 +243,7 @@ memorix setup --agent omp --global
 What this installs depends on the target agent:
 
 - Claude Code: local `memorix-local` marketplace plugin, best-effort `claude plugin install memorix@memorix-local`, plugin-bundled stdio MCP, hooks, skills, plus `CLAUDE.md` guidance.
-- Codex: local Personal marketplace plugin under `~/.codex/plugins/memorix`, marketplace entry at `~/.agents/plugins/marketplace.json`, best-effort `codex plugin add memorix@personal`, plugin-bundled stdio MCP, skills, and `SessionStart` / `UserPromptSubmit` / `PostToolUse` / `PreCompact` / `Stop` hooks, plus `AGENTS.md` guidance. Codex asks the user to review plugin hooks once in `/hooks` before non-managed hooks run.
+- Codex: local Personal marketplace plugin under `~/plugins/memorix`, marketplace entry at `~/.agents/plugins/marketplace.json`, best-effort `codex plugin add memorix@personal`, plugin-bundled stdio MCP, skills, and `SessionStart` / `UserPromptSubmit` / `PostToolUse` / `PreCompact` / `Stop` hooks. It does not create project `.codex` files or overwrite model, approval, or sandbox settings. Codex asks the user to review plugin hooks once in `/hooks` before non-managed hooks run.
 - GitHub Copilot CLI: local plugin package under `~/.copilot/plugins/local/memorix`, best-effort `copilot plugin install <local-path>`, plugin-bundled stdio MCP, hooks, and skills.
 - Cursor: Cursor MCP config, `.cursor/rules/memorix.mdc`, skills, and hook guidance through Cursor's project config surfaces.
 - Pi: user Pi package with extension-based hook capture and a Memorix skill, registered through `pi install <path> --approve`; project-local setup uses `-l`.
@@ -668,7 +668,7 @@ If it reports stale MCP command paths, missing `memorix` MCP entries, missing Cl
 memorix repair agents --agent <agent>
 ```
 
-Repair only rewrites Memorix-owned MCP entries, Memorix-owned guidance blocks, and an explicitly targeted Codex Memorix plugin bundle. It does not edit unrelated user config or turn on a user-disabled Codex plugin; enable that one from `/plugins`.
+Repair only rewrites Memorix-owned MCP entries, Memorix-owned guidance blocks, and an explicitly targeted Codex Memorix plugin bundle. It does not edit unrelated user config, grant Codex hook trust, or turn on a user-disabled Codex plugin; review hooks in `/hooks` and enable a disabled plugin in `/plugins`.
 
 ### 1. Is the workspace a Git repo?
 

package/docs/DEVELOPMENT.md

@@ -321,7 +321,13 @@ npm publish --access public
 
 Notes:
 
-- `prepublishOnly` runs build + test, but does not contact live model catalog APIs
+- `prepublishOnly` synchronizes and checks Registry metadata, then runs build + test; it does not contact live model catalog APIs
+- `server.json` is the official MCP Registry record. Keep it synchronized with
+  `package.json` by running `npm run sync:mcp-registry`; verify it with
+  `npm run check:mcp-registry` before a release.
+- The GitHub publish workflow publishes npm first, then uses GitHub OIDC to
+  publish the same verified version to the official MCP Registry. It does not
+  require a Registry token or private key in repository secrets.
 - `@memorix/ai`, `@memorix/agent-core`, `@memorix/tui`, and `@memorix/memcode` are internal workspaces. Their code is bundled into the root `memorix` distribution and they must stay `private` unless the project deliberately establishes an owned npm scope and a separate package-support contract.
 - npm publish is usually manual, especially when 2FA is enabled
 - GitHub release automation should not be treated as a substitute for manual runtime validation

package/docs/INTEGRATIONS.md

@@ -49,7 +49,7 @@ Generated guidance also has scope:
 | Agent | Recommended install | Official entry | What gets installed | Notes |
 | --- | --- | --- | --- | --- |
 | Claude Code | `memorix setup --agent claude --global` | Claude Code plugin marketplace | Local `memorix-local` marketplace, plugin-bundled stdio MCP, skills, hooks, plus `CLAUDE.md` guidance | Setup attempts `claude plugin marketplace add` and `claude plugin install memorix@memorix-local`. |
-| Codex | `memorix setup --agent codex --global` | Codex Personal marketplace plugin | Local plugin under `~/.codex/plugins/memorix`, Personal marketplace entry, plugin-bundled stdio MCP, skills, hooks, plus `AGENTS.md` guidance | Setup attempts `codex plugin add memorix@personal`. Run `memorix doctor agents --agent codex --scope global` to verify the bundle, marketplace, enabled state, and five declared/trusted hooks; start a new thread after setup. |
+| Codex | `memorix setup --agent codex --global` | Codex Personal marketplace plugin | User plugin under `~/plugins/memorix`, Personal marketplace entry, plugin-bundled stdio MCP, skills, and hooks | Setup attempts `codex plugin add memorix@personal`. It leaves project `.codex` files and model/approval/sandbox settings alone. `memorix doctor agents --agent codex --scope global` verifies the bundle, marketplace, and enabled state, then reports any one-time hook review Codex still requires; start a new thread after setup. |
 | GitHub Copilot CLI | `memorix setup --agent copilot --global` | Copilot CLI plugin package | Local plugin under `~/.copilot/plugins/local/memorix` with MCP, skills, and hooks | Setup attempts `copilot plugin install <local-path>` when Copilot CLI is available. |
 | Cursor | `memorix setup --agent cursor --global` | Cursor MCP and rules config | Cursor MCP config, `.cursor/rules/memorix.mdc`, skills, and hook guidance | Reload Cursor after setup so it can pick up project config changes. |
 | Gemini CLI | `memorix setup --agent gemini-cli --global` | Gemini CLI extension | Extension under `~/.gemini/extensions/memorix` with MCP, `GEMINI.md` context, hooks, commands, and skills | Antigravity CLI has an official Gemini CLI migration path, but Gemini CLI remains an active standalone Google CLI target. |

package/docs/SETUP.md

@@ -76,7 +76,7 @@ memorix setup --agent omp --global
 What this does:
 
 - Claude Code: installs a local marketplace plugin, attempts `claude plugin install memorix@memorix-local`, and writes `CLAUDE.md` guidance.
-- Codex: installs a local Personal marketplace plugin, attempts `codex plugin add memorix@personal`, and writes `AGENTS.md` guidance.
+- Codex: installs a user-level Personal marketplace plugin under `~/plugins/memorix`, attempts `codex plugin add memorix@personal`, and keeps project-local `.codex` configuration untouched. The plugin owns its MCP server, skills, and optional hooks without changing your model, approval, or sandbox settings.
 - GitHub Copilot CLI: installs a local plugin package and attempts `copilot plugin install <local-path>`.
 - Cursor: writes Cursor MCP config, rules, skills, and hook guidance.
 - Pi: installs the user-level Memorix Pi package and attempts `pi install <path> --approve`.
@@ -132,9 +132,9 @@ memorix doctor agents --agent <agent>
 memorix repair agents --agent <agent>
 ```
 
-The doctor checks Memorix-owned MCP entries and guidance files for stale command paths, missing `memorix` MCP servers, missing Claude `alwaysLoad`, and outdated Memory Autopilot rules. For `codex --scope global`, it also checks the local plugin bundle, Personal marketplace entry, five declared lifecycle hooks, Codex's trusted hook state, and the installed/enabled state reported by `codex plugin list`.
+The doctor checks Memorix-owned MCP entries and guidance files for stale command paths, missing `memorix` MCP servers, missing Claude `alwaysLoad`, and outdated Memory Autopilot rules. For `codex --scope global`, MCP is owned by the user-level plugin rather than a direct `config.toml` entry. The doctor checks the plugin bundle, Personal marketplace entry, five declared lifecycle hooks, and the installed/enabled state reported by `codex plugin list`; it reports, but never auto-grants, any hook review Codex still requires.
 
-After Codex setup, start a new thread so enabled plugins can load. Codex does not expose a command that proves hooks are already active inside the current thread. If doctor reports `codex-plugin-disabled`, open `/plugins` and turn Memorix on there; repair does not toggle a user-disabled plugin.
+After Codex setup, start a new thread so enabled plugins can load. If Codex asks to review plugin hooks, approve or decline them in `/hooks`; this is user-level plugin consent, not project trust. If doctor reports `codex-plugin-disabled`, open `/plugins` and turn Memorix on there; repair does not toggle a user-disabled plugin.
 
 ### Option B: manual stdio MCP
 
@@ -330,7 +330,9 @@ HTTP variants in Windsurf-like clients may use `serverUrl`:
 }
 ```
 
-### Codex fallback
+### Codex manual MCP compatibility
+
+The user-level plugin is the default and should be the only Memorix route for Codex. Use this compatibility fallback only when the Codex plugin system is unavailable; do not add it alongside `memorix@personal`, because that creates duplicate MCP ownership.
 
 Config file: `~/.codex/config.toml`
 

package/docs/hooks-architecture.md

@@ -27,7 +27,7 @@
 |-------|---------|------|
 | VS Code Copilot | `.github/hooks/*.json` | Claude Code 兼容 |
 | Claude Code | `.claude/settings.json` | 原生 |
-| Codex | Memorix 插件内 `hooks/hooks.json` | Codex plugin hooks；通过 `memorix setup --agent codex` 安装 |
+| Codex | 用户级 Memorix 插件内 `hooks/hooks.json` | Codex plugin hooks；通过 `memorix setup --agent codex --global` 安装，不写项目 `.codex/hooks.json` |
 | Windsurf | `.windsurf/cascade.json` | Windsurf 格式 |
 | Cursor | `.cursor/hooks.json` | Cursor 格式 |
 | Kiro | `.kiro/hooks/*.hook.md` | Markdown + YAML |

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "memorix",
-  "version": "1.2.8",
+  "mcpName": "io.github.AVIDS2/memorix",
+  "version": "1.2.10",
   "description": "Local-first shared memory layer for AI coding agents across MCP clients, Git history, reasoning context, and project sessions.",
   "type": "module",
   "sideEffects": false,
@@ -33,6 +34,7 @@
   "files": [
     "dist",
     "src",
+    "server.json",
     "!src/**/*.js",
     "!src/**/*.js.map",
     "!src/**/*.d.ts",
@@ -63,9 +65,11 @@
     "test:e2e": "vitest run tests/e2e/",
     "benchmark:codegraph": "node scripts/benchmark-codegraph-provider.cjs",
     "benchmark:retrieval": "npm run build && node scripts/benchmark-retrieval.mjs",
+    "sync:mcp-registry": "node scripts/sync-mcp-registry-manifest.mjs",
+    "check:mcp-registry": "node scripts/check-mcp-registry-manifest.mjs",
     "audit:pi-upstream": "node scripts/pi-upstream-audit.mjs",
     "lint": "tsc --noEmit",
-    "prepublishOnly": "npm run build && npm test"
+    "prepublishOnly": "npm run sync:mcp-registry && npm run check:mcp-registry && npm run build && npm test"
   },
   "keywords": [
     "mcp",

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.2.8",
+  "version": "1.2.10",
   "description": "Shared workspace memory for Claude Code and other AI coding agents.",
   "author": {
     "name": "AVIDS2",

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

@@ -1,6 +1,6 @@
 {
   "name": "memorix",
-  "version": "1.2.8",
+  "version": "1.2.10",
   "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.2.8",
+  "version": "1.2.10",
   "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.2.8",
+  "version": "1.2.10",
   "mcpServers": {
     "memorix": {
       "command": "memorix",

package/plugins/omp/memorix/package.json

@@ -1,6 +1,6 @@
 {
   "name": "memorix-omp-package",
-  "version": "1.2.8",
+  "version": "1.2.10",
   "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.2.8",
+  "version": "1.2.10",
   "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.2.8",
+  "version": "1.2.10",
   "description": "Memorix shared workspace memory package for Pi coding agent.",
   "license": "Apache-2.0",
   "keywords": [

package/server.json

@@ -0,0 +1,38 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "io.github.AVIDS2/memorix",
+  "title": "Memorix",
+  "description": "Local-first persistent project memory for AI coding agents across MCP clients and sessions.",
+  "repository": {
+    "url": "https://github.com/AVIDS2/memorix",
+    "source": "github"
+  },
+  "version": "1.2.10",
+  "websiteUrl": "https://github.com/AVIDS2/memorix#readme",
+  "icons": [
+    {
+      "src": "https://raw.githubusercontent.com/AVIDS2/memorix/main/assets/logo.png",
+      "mimeType": "image/png",
+      "sizes": [
+        "1024x1024"
+      ]
+    }
+  ],
+  "packages": [
+    {
+      "registryType": "npm",
+      "identifier": "memorix",
+      "version": "1.2.10",
+      "runtimeHint": "npx",
+      "packageArguments": [
+        {
+          "type": "positional",
+          "value": "serve"
+        }
+      ],
+      "transport": {
+        "type": "stdio"
+      }
+    }
+  ]
+}

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

@@ -12,6 +12,7 @@ import {
   getSetupAgentTargets,
   installPluginPackage,
   installMcpConfig,
+  migrateLegacyCodexIntegration,
   tryInstallCodexPlugin,
   type McpConfigAgent,
 } from './setup.js';
@@ -228,7 +229,7 @@ function asRecordArray(value: unknown): JsonRecord[] {
 }
 
 function codexPluginPath(): string {
-  return `${homedir()}/.codex/plugins/${CODEX_PLUGIN_NAME}`;
+  return `${homedir()}/plugins/${CODEX_PLUGIN_NAME}`;
 }
 
 function codexPluginMcpPath(): string {
@@ -254,7 +255,10 @@ function isMemorixCodexPlugin(value: JsonRecord): boolean {
 
 export function parseCodexPluginList(output: string): AgentPluginCheck['runtime'] | null {
   try {
-    const parsed = asRecord(JSON.parse(output));
+    const start = output.indexOf('{');
+    const end = output.lastIndexOf('}');
+    if (start < 0 || end < start) return null;
+    const parsed = asRecord(JSON.parse(output.slice(start, end + 1)));
     if (!parsed) return null;
     const entries = [...asRecordArray(parsed.installed), ...asRecordArray(parsed.available)];
     const plugin = entries.find(isMemorixCodexPlugin);
@@ -407,7 +411,7 @@ async function inspectCodexMarketplace(): Promise<AgentPluginCheck> {
 
   const source = asRecord(entry.source);
   const sourcePath = typeof source?.path === 'string' ? source.path : '';
-  const issues = source?.source === 'local' && normalizeMarketplacePath(sourcePath) === '.codex/plugins/memorix'
+  const issues = source?.source === 'local' && normalizeMarketplacePath(sourcePath) === 'plugins/memorix'
     ? []
     : ['codex-marketplace-entry-stale'];
   return {
@@ -1060,9 +1064,11 @@ export async function repairAgentIntegrations(options: {
         } else {
           if (!options.dry) {
             await installPluginPackage({ agent: 'codex' });
-            if (needsInstall) {
-              const install = tryInstallCodexPlugin();
-              if (!install.ok) skipped.push('codex:plugin:global:install-pending');
+            const install = tryInstallCodexPlugin();
+            if (install.ok) {
+              await migrateLegacyCodexIntegration({ projectRoot });
+            } else {
+              skipped.push('codex:plugin:global:install-pending');
             }
           }
           changed.push('codex:plugin:global');

package/src/cli/commands/operator-shared.ts

@@ -110,7 +110,10 @@ export async function getCliProjectContext(options?: CliContextOptions): Promise
   } catch {
     // CLI reads remain available even if optional background maintenance metadata fails.
   }
-  await initObservations(dataDir);
+  await initObservations(dataDir, {
+    embeddingWriteMode: 'deferred',
+    projectRoot: project.rootPath,
+  });
   await initSessionStore(dataDir);
   const teamStore = await initTeamStore(dataDir);
 

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

@@ -24,6 +24,7 @@ import type { IncomingMessage, ServerResponse } from 'node:http';
 import type { ObservationStore } from '../../store/obs-store.js';
 import { resolveToolProfile } from '../../server/tool-profile.js';
 import { scopeKnowledgeGraphToProject } from '../../memory/graph-scope.js';
+import { projectObservationRetention, summarizeRetentionProjections } from '../../memory/retention.js';
 import { canManageObservation, filterReadableObservations } from '../../memory/visibility.js';
 
 export const DEFAULT_SESSION_TIMEOUT_MS = 30 * 60 * 1000;
@@ -760,20 +761,7 @@ export default defineCommand({
           await initGraphStore(statsDataDir);
           const graph = { entities: getGraphStore().loadEntities(), relations: getGraphStore().loadRelations() };
 
-          const observations = await loadDashboardProjectObservations(statsDataDir, statsProjectId, 'active') as Array<{
-            type?: string;
-            id?: number;
-            title?: string;
-            entityName?: string;
-            createdAt?: string;
-            source?: string;
-            commitHash?: string;
-            filesModified?: string[];
-            relatedEntities?: string[];
-            status?: string;
-            importance?: number;
-            accessCount?: number;
-          }>;
+          const observations = await loadDashboardProjectObservations(statsDataDir, statsProjectId, 'active');
           const statsStore = await getDashboardObservationStore(statsDataDir);
           const nextId = await statsStore.loadIdCounter();
           const typeCounts: Record<string, number> = {};
@@ -811,20 +799,17 @@ export default defineCommand({
             filesModified: o.filesModified,
           }));
 
-          let retentionSummary = { active: 0, stale: 0, archive: 0, immune: 0 };
-          for (const obs of observations) {
-            const age = now - new Date(obs.createdAt || now).getTime();
-            const ageHours = age / (1000 * 60 * 60);
-            const importance = obs.importance ?? 5;
-            const accessCount = obs.accessCount ?? 0;
-            const lambda = 0.01;
-            const score = Math.min(importance * Math.exp(-lambda * ageHours) + Math.min(accessCount * 0.5, 3), 10);
-            const isImmune = importance >= 8 || obs.type === 'gotcha' || obs.type === 'decision';
-            if (isImmune) retentionSummary.immune++;
-            if (score >= 3) retentionSummary.active++;
-            else if (score >= 1) retentionSummary.stale++;
-            else retentionSummary.archive++;
-          }
+          const retention = summarizeRetentionProjections(
+            observations
+              .filter((observation) => observation.type !== 'probe')
+              .map((observation) => projectObservationRetention(observation, { referenceTime: new Date(now) })),
+          );
+          const retentionSummary = {
+            active: retention.active,
+            stale: retention.stale,
+            archive: retention.archiveCandidates,
+            immune: retention.immune,
+          };
 
           const sorted = [...observations].filter(o => o.type !== 'probe').sort((a, b) => (b.id || 0) - (a.id || 0)).slice(0, 10);
 
@@ -959,26 +944,38 @@ export default defineCommand({
 
         if (apiPath === '/retention') {
           const { projectId: retProjectId, dataDir: retDataDir } = await resolveRequestProject(url);
-          const observations = await loadDashboardProjectObservations(retDataDir, retProjectId, 'active') as Array<{ id?: number; title?: string; type?: string; importance?: number; accessCount?: number; lastAccessedAt?: string; createdAt?: string; entityName?: string }>;
-          const now = Date.now();
-          const scored = observations.map(obs => {
-            const age = now - new Date(obs.createdAt || now).getTime();
-            const ageHours = age / (1000 * 60 * 60);
-            const importance = obs.importance ?? 5;
-            const accessCount = obs.accessCount ?? 0;
-            const lambda = 0.01;
-            const decayScore = importance * Math.exp(-lambda * ageHours);
-            const accessBonus = Math.min(accessCount * 0.5, 3);
-            const score = Math.min(decayScore + accessBonus, 10);
-            const isImmune = importance >= 8 || obs.type === 'gotcha' || obs.type === 'decision';
-            return { id: obs.id, title: obs.title, type: obs.type, entityName: obs.entityName, score: Math.round(score * 100) / 100, isImmune, ageHours: Math.round(ageHours * 10) / 10, accessCount };
+          const observations = await loadDashboardProjectObservations(retDataDir, retProjectId, 'active');
+          const referenceTime = new Date();
+          const rows = observations
+            .filter((observation) => observation.type !== 'probe')
+            .map((observation) => ({
+              observation,
+              retention: projectObservationRetention(observation, { referenceTime }),
+            }))
+            .sort((a, b) => b.retention.displayScore - a.retention.displayScore);
+          const summary = summarizeRetentionProjections(rows.map((row) => row.retention));
+          const items = rows.map(({ observation, retention }) => ({
+            id: observation.id,
+            title: observation.title,
+            type: observation.type,
+            entityName: observation.entityName,
+            score: retention.displayScore,
+            isImmune: retention.immune,
+            zone: retention.zone,
+            ageHours: retention.ageHours,
+            accessCount: retention.accessCount,
+            effectiveRetentionDays: retention.effectiveRetentionDays,
+            immunityReason: retention.immunityReason,
+          }));
+          sendJson({
+            summary: {
+              active: summary.active,
+              stale: summary.stale,
+              archive: summary.archiveCandidates,
+              immune: summary.immune,
+            },
+            items,
           });
-          scored.sort((a, b) => b.score - a.score);
-          const activeCount = scored.filter(s => s.score >= 3).length;
-          const staleCount = scored.filter(s => s.score < 3 && s.score >= 1).length;
-          const archiveCount = scored.filter(s => s.score < 1).length;
-          const immuneCount = scored.filter(s => s.isImmune).length;
-          sendJson({ summary: { active: activeCount, stale: staleCount, archive: archiveCount, immune: immuneCount }, items: scored });
           return;
         }