@memorax/memorax-code 0.1.1 → 0.1.3

package/lib/memorax-code-backend/dist/{memory-viewer-store.js → viewer/store.js}

@@ -1,19 +1,19 @@
 import { randomUUID } from "node:crypto";
 import { resolve } from "node:path";
-import { clearClaudeLocalTranscriptProjections, readClaudeLocalTranscriptHistory, } from "./claude-local-transcript.js";
-import { stripCodexPreambleSegments } from "./codex-effective-prompt.js";
-import { clearIncrementalJsonlProjections, readIncrementalJsonlProjectionSnapshot, } from "./incremental-jsonl-projection.js";
-import { clearMemoryViewerDataProjectionCache, clearMemoryViewerDataProjections, memoryViewerDataProjectionCacheSize, prepareMemoryViewerDataProjectionHistory, readMemoryViewerDataProjection, shareMemoryViewerDataProjectionValue, shouldCacheMemoryViewerDataProjection, writeMemoryViewerDataProjection, } from "./memory-viewer-data-projection-cache.js";
-import { memoryViewerActivityProjection, memoryViewerActivitySummary, } from "./memory-viewer-activity.js";
-import { memoryViewerEventKey } from "./memory-viewer-event-identity.js";
-import { memoryViewerEventTurnIds } from "./memory-viewer-turn-reference.js";
-import { foldMemoryViewerSupersededTurnStarts, foldMemoryViewerTurnMaterializations, } from "./memory-viewer-history-projection.js";
-import { memoryProjectFromUnknown, resolveMemoryProject, UNCLASSIFIED_PROJECT_ID, } from "./memory-project.js";
-import { sanitizeMemoryViewerDetails } from "./memory-viewer-redaction.js";
-import { earliestMemoryViewerSessionTitleCandidates, } from "./memory-viewer-session-title.js";
-import { projectMemoryViewerUserData, } from "./memory-viewer-user-projection.js";
-import { completeMemoryViewerWriteback, foldMemoryViewerWritebackStatuses, memoryText, memoryViewerWritebackOutcome, nonNegativeInteger, pendingMemoryViewerWritebacks, stringArray, writebackOutcomeForStatus, } from "./memory-viewer-writeback-status.js";
-import { clientTracePaths, tracePaths } from "./trace-config.js";
+import { clearClaudeLocalTranscriptProjections, readClaudeLocalTranscriptHistory, } from "./history/claude-transcript.js";
+import { stripCodexPreambleSegments } from "../clients/codex/effective-prompt.js";
+import { clearIncrementalJsonlProjections, readIncrementalJsonlProjectionSnapshot, } from "../shared/incremental-jsonl-projection.js";
+import { clearMemoryViewerDataProjectionCache, clearMemoryViewerDataProjections, memoryViewerDataProjectionCacheSize, prepareMemoryViewerDataProjectionHistory, readMemoryViewerDataProjection, shareMemoryViewerDataProjectionValue, shouldCacheMemoryViewerDataProjection, writeMemoryViewerDataProjection, } from "./projection/cache.js";
+import { memoryViewerActivityProjection, memoryViewerActivitySummary, } from "./projection/activity.js";
+import { memoryViewerEventKey } from "./projection/event-identity.js";
+import { memoryViewerEventTurnIds } from "./projection/turn-reference.js";
+import { foldMemoryViewerSupersededTurnStarts, foldMemoryViewerTurnMaterializations, } from "./projection/history.js";
+import { memoryProjectFromUnknown, resolveMemoryProject, UNCLASSIFIED_PROJECT_ID, } from "../memory/project.js";
+import { sanitizeMemoryViewerDetails } from "./projection/redaction.js";
+import { earliestMemoryViewerSessionTitleCandidates, } from "./history/session-title.js";
+import { projectMemoryViewerUserData } from "./projection/user.js";
+import { completeMemoryViewerWriteback, foldMemoryViewerWritebackStatuses, memoryText, memoryViewerWritebackOutcome, nonNegativeInteger, pendingMemoryViewerWritebacks, stringArray, writebackOutcomeForStatus, } from "./projection/writeback-status.js";
+import { clientTracePaths, tracePaths } from "../trace/config.js";
 export { completeMemoryViewerWriteback, memoryViewerEventTurnIds, pendingMemoryViewerWritebacks, };
 const CAPACITY = 200;
 const TURN_CAPACITY = 50;
@@ -25,6 +25,8 @@ const EMPTY_MEMORY_VIEWER_HISTORY = Object.freeze([]);
 const claudeTranscriptSources = new Map();
 export function recordMemoryViewerEvent(input) {
     const client = memoryViewerClient(input);
+    if (!client)
+        return undefined;
     const response = record(input.response);
     const request = record(input.request);
     const items = arrayValue(response?.items);
@@ -275,6 +277,13 @@ function eventContent(operation, request, response, items, error) {
     return stringValue(payload?.query) || "Memory retrieval completed.";
 }
 async function readTraceHistory(memoraxCodeHome, resolveProject, client, claudeProjectsRoot = false) {
+    if (client !== undefined && !isMemoryViewerClient(client)) {
+        return {
+            values: [],
+            complete: true,
+            claudeLocal: EMPTY_MEMORY_VIEWER_HISTORY,
+        };
+    }
     const historyCacheRoot = resolve(memoraxCodeHome);
     const projectsByCwd = new Map();
     const resolveProjectOnce = (cwd) => {
@@ -310,9 +319,9 @@ async function readTraceHistory(memoraxCodeHome, resolveProject, client, claudeP
         },
         compare: compareMemoryViewerEvents,
     });
-    if (client === "codex") {
-        const codex = await readClient("codex");
-        return { ...codex, claudeLocal: EMPTY_MEMORY_VIEWER_HISTORY };
+    if (client === "codex" || client === "dsh" || client === "opencode") {
+        const selected = await readClient(client);
+        return { ...selected, claudeLocal: EMPTY_MEMORY_VIEWER_HISTORY };
     }
     const claudeLocalPromise = readClaudeLocalTranscriptHistory(claudeProjectsRoot, resolveProject);
     if (client === "claude") {
@@ -321,33 +330,37 @@ async function readTraceHistory(memoraxCodeHome, resolveProject, client, claudeP
             claudeLocalPromise,
         ]);
         return {
-            values: combinedTraceHistory(`${historyCacheRoot}\u0000client=claude\u0000source=${claudeProjectsRoot || "disabled"}`, EMPTY_MEMORY_VIEWER_HISTORY, claude.values, claudeLocal),
+            values: combinedTraceHistory(`${historyCacheRoot}\u0000client=claude\u0000source=${claudeProjectsRoot || "disabled"}`, EMPTY_MEMORY_VIEWER_HISTORY, claude.values, EMPTY_MEMORY_VIEWER_HISTORY, EMPTY_MEMORY_VIEWER_HISTORY, claudeLocal),
             complete: claude.complete,
             claudeLocal,
         };
     }
-    const [codex, claude, claudeLocal] = await Promise.all([
+    const [codex, claude, dsh, opencode, claudeLocal] = await Promise.all([
         readClient("codex"),
         readClient("claude"),
+        readClient("dsh"),
+        readClient("opencode"),
         claudeLocalPromise,
     ]);
     return {
-        values: combinedTraceHistory(`${historyCacheRoot}\u0000client=all\u0000source=${claudeProjectsRoot || "disabled"}`, codex.values, claude.values, claudeLocal),
-        complete: codex.complete && claude.complete,
+        values: combinedTraceHistory(`${historyCacheRoot}\u0000client=all\u0000source=${claudeProjectsRoot || "disabled"}`, codex.values, claude.values, dsh.values, opencode.values, claudeLocal),
+        complete: codex.complete && claude.complete && dsh.complete && opencode.complete,
         claudeLocal,
     };
 }
-function combinedTraceHistory(cacheKey, codex, claude, claudeLocal) {
+function combinedTraceHistory(cacheKey, codex, claude, dsh, opencode, claudeLocal) {
     const cached = combinedTraceHistories.get(cacheKey);
     if (cached?.codex === codex
         && cached.claude === claude
+        && cached.dsh === dsh
+        && cached.opencode === opencode
         && cached.claudeLocal === claudeLocal) {
         return cached.values;
     }
     // Native Claude transcripts invalidate this cached identity, but they are
     // admitted only after retained and live Hook trace events are merged.
-    const values = [...codex, ...claude].sort(compareMemoryViewerEvents);
-    combinedTraceHistories.set(cacheKey, { codex, claude, claudeLocal, values });
+    const values = [...codex, ...claude, ...dsh, ...opencode].sort(compareMemoryViewerEvents);
+    combinedTraceHistories.set(cacheKey, { codex, claude, dsh, opencode, claudeLocal, values });
     return values;
 }
 function admitClaudeTranscriptEvents(traceEvents, localEvents) {
@@ -938,27 +951,41 @@ function sessionId(value) {
     return safeMemoryViewerSessionId(value);
 }
 function memoryViewerClient(input) {
-    if (input.traceContext?.client === "claude")
-        return "claude";
-    if (input.traceContext?.client === "codex")
-        return "codex";
+    if (input.traceContext?.client !== undefined) {
+        return isMemoryViewerClient(input.traceContext.client)
+            ? input.traceContext.client
+            : undefined;
+    }
+    if (input.source === "dsh_native_retrieval" || input.source === "dsh_native_writeback") {
+        return undefined;
+    }
     if (input.source === "claude_hook_retrieval" || input.source === "claude_hook_writeback")
         return "claude";
+    if (input.source === "opencode_plugin_retrieval" || input.source === "opencode_plugin_writeback")
+        return "opencode";
     return "codex";
 }
+function isMemoryViewerClient(client) {
+    return client === "codex" || client === "claude" || client === "dsh" || client === "opencode";
+}
 function memoryViewerEventId(client, eventId) {
     if (eventId)
         return persistedMemoryViewerEventId(client, eventId);
-    return client === "codex"
-        ? `memory-viewer:${randomUUID()}`
-        : `claude-memory-viewer:${randomUUID()}`;
+    return `${client === "codex" ? "" : `${client}-`}memory-viewer:${randomUUID()}`;
 }
 function persistedMemoryViewerEventId(client, eventId) {
-    return client === "codex" ? `trace:${eventId}` : `claude-trace:${eventId}`;
+    return client === "codex" ? `trace:${eventId}` : `${client}-trace:${eventId}`;
 }
 function memoryViewerProjectionKey(memoraxCodeHome, client) {
+    if (client !== undefined && !isMemoryViewerClient(client)) {
+        return `${resolve(memoraxCodeHome)}\u0000client=unsupported`;
+    }
     if (client === "claude")
         return clientTracePaths("claude", memoraxCodeHome).sessionsRoot;
+    if (client === "dsh")
+        return clientTracePaths("dsh", memoraxCodeHome).sessionsRoot;
+    if (client === "opencode")
+        return clientTracePaths("opencode", memoraxCodeHome).sessionsRoot;
     const codexSessionsRoot = tracePaths(memoraxCodeHome).sessionsRoot;
     return client === "codex" ? `${codexSessionsRoot}\u0000client=codex` : codexSessionsRoot;
 }

package/lib/memorax-code-backend/dist/viewer/ui/icon.js

@@ -0,0 +1 @@
+export const MEMORAX_ICON_DATA_URL = "data:image/png;base64,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";

package/lib/memorax-code-backend/dist/{memory-viewer-user-html.js → viewer/ui/user-html.js}

@@ -5,6 +5,7 @@ export function memoryViewerUserHtml() {
   <meta charset="utf-8">
   <meta name="viewport" content="width=device-width,initial-scale=1">
   <meta name="theme-color" content="#f7f8fc">
+  <link rel="icon" type="image/png" sizes="64x64" href="/memory-viewer/favicon.png">
   <title>MemoraX Code Memory Viewer</title>
   <script>
     const THEME_STORAGE_KEY='memorax-code-memory-viewer-theme',LANGUAGE_STORAGE_KEY='memorax-code-memory-viewer-language';
@@ -15,9 +16,10 @@ export function memoryViewerUserHtml() {
     document.documentElement.lang=language==='en'?'en':'zh-CN';
     document.querySelector('meta[name="theme-color"]').content=theme==='dark'?'#10121a':'#f7f8fc';
     window.addEventListener('DOMContentLoaded',()=>{
-      const E=id=>document.getElementById(id),project=E('project'),clientButtons=[...document.querySelectorAll('[data-client]')],bootstrapUrl=new URL(location.href),params=bootstrapUrl.searchParams;
+      const E=id=>document.getElementById(id),project=E('project'),clientSelect=E('client-select'),bootstrapUrl=new URL(location.href),params=bootstrapUrl.searchParams;
       if(params.has('token')){bootstrapUrl.searchParams.delete('token');history.replaceState(null,'',bootstrapUrl)}
-      let selected=params.get('projectId')||'',client=['claude','claude-code','cc'].includes((params.get('client')||'').toLowerCase())?'claude-code':'codex',controller,lastBody=null,connectionState=null;
+      const requestedClient=(params.get('client')||'').toLowerCase();
+      let selected=params.get('projectId')||'',client=['claude','claude-code','cc'].includes(requestedClient)?'claude-code':['dsh','opencode'].includes(requestedClient)?requestedClient:'codex',controller,lastBody=null,connectionState=null;
       const esc=value=>String(value??'').replace(/[&<>"']/g,char=>({'&':'&amp;','<':'&lt;','>':'&gt;','"':'&quot;',"'":'&#39;'}[char]));
       const COPY={
         zh:{
@@ -27,8 +29,8 @@ export function memoryViewerUserHtml() {
           cardTurns:'会话',cardSearch:'搜索',cardAdd:'写入',cardRepo:'仓库记忆',loading:'正在加载',checking:'正在检查',repoLoading:'仓库知识状态',recentActivity:'最近活动',
           empty:'当前范围还没有会话、搜索或写入活动',error:'暂时无法加载记忆活动，请稍后重试。',selectProject:'选择仓库',selectProjectForStatus:'选择仓库后查看状态',noProjects:'暂无可识别仓库',unassignedProject:'未归属仓库',systemActivity:'系统活动',
           turnNote:'轮客户端会话',searchUnit:'次搜索',addUnit:'次写入',processingUnit:'个处理中',unknownUnit:'个数量未知',activityUnit:'条',
-          repoStates:{ready:'可用',preparing:'准备中',not_ready:'未就绪',unknown:'未知'},
-          reasons:{usable:'仓库知识可以使用',active_job:'正在生成或更新',bundle_missing:'尚未生成仓库知识',bundle_invalid:'仓库知识需要重新生成',project_unresolved:'无法定位仓库',validator_unavailable:'暂时无法检查'},
+          repoStates:{ready:'可用',preparing:'生成中',not_ready:'未就绪',unknown:'未知'},
+          reasons:{usable:'仓库知识可以使用',active_job:'正在生成或更新',bundle_missing:'正在生成仓库知识',bundle_missing_idle:'仓库知识尚未初始化',bundle_invalid:'仓库知识需要重新生成',project_unresolved:'无法定位仓库',validator_unavailable:'暂时无法检查'},
           statuses:{completed:'完成',saved:'已保存',skipped:'未写入',processing:'进行中',interrupted:'已中断',failed:'失败',unknown:'数量未知'},
           sources:{client:'客户端会话',assistant:'助手主动',automatic:'系统自动'}
         },
@@ -39,8 +41,8 @@ export function memoryViewerUserHtml() {
           cardTurns:'Turns',cardSearch:'Search',cardAdd:'Add',cardRepo:'Repo Memory',loading:'Loading',checking:'Checking',repoLoading:'Repository knowledge status',recentActivity:'Recent activity',
           empty:'No turn, Search, or Add activity in the current scope',error:'Memory activity is temporarily unavailable. Please try again later.',selectProject:'Select a repository',selectProjectForStatus:'Select a repository to view its status',noProjects:'No repositories found',unassignedProject:'Unassigned repository',systemActivity:'System activity',
           turnNote:'client turns',searchUnit:'searches',addUnit:'adds',processingUnit:'processing',unknownUnit:'with unknown counts',activityUnit:'items',
-          repoStates:{ready:'Ready',preparing:'Preparing',not_ready:'Not Ready',unknown:'Unknown'},
-          reasons:{usable:'Repository knowledge is ready',active_job:'Generating or updating repository knowledge',bundle_missing:'Repository knowledge has not been generated',bundle_invalid:'Repository knowledge needs to be regenerated',project_unresolved:'Repository could not be resolved',validator_unavailable:'Status is temporarily unavailable'},
+          repoStates:{ready:'Ready',preparing:'Generating',not_ready:'Not Ready',unknown:'Unknown'},
+          reasons:{usable:'Repository knowledge is ready',active_job:'Generating or updating repository knowledge',bundle_missing:'Generating repository knowledge',bundle_missing_idle:'Repository knowledge has not been initialized',bundle_invalid:'Repository knowledge needs to be regenerated',project_unresolved:'Repository could not be resolved',validator_unavailable:'Status is temporarily unavailable'},
           statuses:{completed:'Completed',saved:'Saved',skipped:'No Add',processing:'Processing',interrupted:'Interrupted',failed:'Failed',unknown:'Count unknown'},
           sources:{client:'Client session',assistant:'Assistant initiated',automatic:'Automatic'}
         }
@@ -48,13 +50,13 @@ export function memoryViewerUserHtml() {
       const icons={turn:'<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.9"><path d="M5 6h14v10H9l-4 3z" stroke-linejoin="round"/></svg>',search:'<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.9"><circle cx="10.5" cy="10.5" r="5.5"/><path d="m15 15 4 4" stroke-linecap="round"/></svg>',add:'<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.9"><path d="M12 7v10M7 12h10" stroke-linecap="round"/></svg>'};
       const copy=()=>COPY[language],locale=()=>language==='en'?'en-US':'zh-CN',number=value=>Number(value||0).toLocaleString(locale()),date=value=>new Intl.DateTimeFormat(locale(),{month:'short',day:'numeric',hour:'2-digit',minute:'2-digit'}).format(new Date(value));
       function endpoint(){const next=new URL('/memory-viewer/api/summary',location.href);next.searchParams.set('client',client);if(selected)next.searchParams.set('projectId',selected);return next.pathname+next.search}
-      function syncClient(){clientButtons.forEach(button=>button.setAttribute('aria-pressed',String(button.dataset.client===client)))}
+      function syncClient(){clientSelect.value=client}
       function syncStaticCopy(){const current=copy();document.title=current.pageTitle;document.documentElement.lang=language==='en'?'en':'zh-CN';document.querySelectorAll('[data-i18n]').forEach(node=>{const value=current[node.dataset.i18n];if(typeof value==='string')node.textContent=value});document.querySelectorAll('[data-i18n-aria]').forEach(node=>{const value=current[node.dataset.i18nAria];if(typeof value==='string')node.setAttribute('aria-label',value)});document.querySelectorAll('[data-i18n-title]').forEach(node=>{const value=current[node.dataset.i18nTitle];if(typeof value==='string')node.setAttribute('title',value)});E('language-toggle').textContent=language==='zh'?'EN':'中';E('language-toggle').setAttribute('aria-label',current.languageSwitch);E('language-toggle').title=current.languageSwitch;syncThemeButton()}
       function syncThemeButton(){const label=theme==='dark'?copy().themeLight:copy().themeDark;E('theme-toggle').setAttribute('aria-label',label);E('theme-toggle').title=label}
       function setTheme(next,persist=true){theme=next;document.documentElement.dataset.theme=theme;document.querySelector('meta[name="theme-color"]').content=theme==='dark'?'#10121a':'#f7f8fc';if(persist)writePreference(THEME_STORAGE_KEY,theme);syncThemeButton()}
       function setLanguage(next,persist=true){language=next;if(persist)writePreference(LANGUAGE_STORAGE_KEY,language);syncStaticCopy();if(lastBody)render(lastBody);if(connectionState!==null)connection(connectionState)}
       function syncProjects(items){const current=selected;project.innerHTML='<option value="">'+esc(copy().allProjects)+'</option>'+items.map(item=>'<option value="'+esc(item.projectId)+'">'+esc(item.projectLabel)+'</option>').join('');project.value=items.some(item=>item.projectId===current)?current:'';selected=project.value}
-      function repoState(items){const current=copy(),target=selected?items.find(item=>item.projectId===selected):items.length===1?items[0]:null,state=target?.repoMemory||{status:'unknown',reason:'project_unresolved'};E('repo-state').className='repo-state';E('repo-dot').className='state-dot '+state.status;E('repo-label').textContent=target?(current.repoStates[state.status]||current.repoStates.unknown):current.selectProject;E('repo-note').classList.remove('skeleton','loading-copy');E('repo-note').textContent=target?(target.projectLabel+' · '+(current.reasons[state.reason]||current.reasons.validator_unavailable)):items.length?current.selectProjectForStatus:current.noProjects}
+      function repoState(items){const current=copy(),target=selected?items.find(item=>item.projectId===selected):items.length===1?items[0]:null,state=target?.repoMemory||{status:'unknown',reason:'project_unresolved'},idleOpenCodeBundle=client==='opencode'&&state.reason==='bundle_missing',displayStatus=state.reason==='bundle_missing'&&!idleOpenCodeBundle?'preparing':state.status,reason=idleOpenCodeBundle?'bundle_missing_idle':state.reason;E('repo-state').className='repo-state';E('repo-dot').className='state-dot '+displayStatus;E('repo-label').textContent=target?(current.repoStates[displayStatus]||current.repoStates.unknown):current.selectProject;E('repo-note').classList.remove('skeleton','loading-copy');E('repo-note').textContent=target?(target.projectLabel+' · '+(current.reasons[reason]||current.reasons.validator_unavailable)):items.length?current.selectProjectForStatus:current.noProjects}
       function memoryCount(value){if(language==='zh')return value+' 条记忆';return value+' '+(value===1?'memory':'memories')}
       function activityTitle(item){if(language==='zh'){if(item.kind==='turn')return item.status==='processing'?'会话进行中':item.status==='interrupted'?'会话已中断':'完成一轮会话';if(item.kind==='search')return item.status==='failed'?'搜索失败':'搜索 · '+memoryCount(item.count??0);if(item.status==='saved')return item.count===null?'写入 · 数量未知':'写入 · '+memoryCount(item.count);if(item.status==='skipped')return '写入 · 没有新记忆';if(item.status==='processing')return '写入处理中';if(item.status==='failed')return '写入失败';return '写入完成 · 数量未知'}if(item.kind==='turn')return item.status==='processing'?'Session in progress':item.status==='interrupted'?'Session interrupted':'Session turn completed';if(item.kind==='search')return item.status==='failed'?'Search failed':'Search · '+memoryCount(item.count??0);if(item.status==='saved')return item.count===null?'Add · Count unknown':'Add · '+memoryCount(item.count);if(item.status==='skipped')return 'Add · No new memory';if(item.status==='processing')return 'Add in progress';if(item.status==='failed')return 'Add failed';return 'Add completed · Count unknown'}
       function metaItem(value){return '<span class="meta-item">'+esc(value)+'</span>'}
@@ -62,7 +64,7 @@ export function memoryViewerUserHtml() {
       function connection(ok){connectionState=ok;const current=copy(),pill=E('connection-pill');pill.classList.toggle('offline',!ok);E('connection').textContent=ok?current.connected:current.disconnected;E('connection-time').textContent=ok?current.updated:''}
       async function refresh(){if(controller)controller.abort();const request=new AbortController();controller=request;E('refresh').classList.add('loading');E('refresh').disabled=true;try{const response=await fetch(endpoint(),{signal:request.signal,credentials:'same-origin'});if(!response.ok)throw new Error('HTTP '+response.status);render(await response.json());connection(true)}catch(error){if(error.name==='AbortError')return;connection(false);E('error').hidden=false}finally{if(controller===request){E('refresh').classList.remove('loading');E('refresh').disabled=false}}}
       async function poll(){if(document.visibilityState==='visible')await refresh();setTimeout(poll,10000)}
-      clientButtons.forEach(button=>button.onclick=()=>{if(button.dataset.client===client)return;client=button.dataset.client;selected='';syncClient();const next=new URL(location.href);next.searchParams.set('client',client);next.searchParams.delete('projectId');history.replaceState(null,'',next);refresh()});
+      clientSelect.onchange=()=>{if(clientSelect.value===client)return;client=clientSelect.value;selected='';syncClient();const next=new URL(location.href);next.searchParams.set('client',client);next.searchParams.delete('projectId');history.replaceState(null,'',next);refresh()};
       project.onchange=()=>{selected=project.value;const next=new URL(location.href);next.searchParams.set('client',client);if(selected)next.searchParams.set('projectId',selected);else next.searchParams.delete('projectId');history.replaceState(null,'',next);refresh()};
       E('language-toggle').onclick=()=>setLanguage(language==='zh'?'en':'zh');
       E('theme-toggle').onclick=()=>setTheme(theme==='light'?'dark':'light');
@@ -79,7 +81,7 @@ export function memoryViewerUserHtml() {
     .shell{width:min(1080px,calc(100% - 48px));margin:0 auto}
     header{position:sticky;top:0;z-index:5;border-bottom:1px solid var(--header-border);background:var(--header-bg);backdrop-filter:blur(18px) saturate(150%)}
     .header-inner{height:72px;display:flex;align-items:center}.brand{display:flex;align-items:center;gap:14px;min-width:0}.logo{display:block;height:27px;max-width:168px;transition:filter .18s}.brand-divider{width:1px;height:22px;background:var(--line-strong)}.product-name{font-size:13px;font-weight:650;letter-spacing:.01em;color:var(--product-ink);white-space:nowrap}[data-theme="dark"] .logo{filter:brightness(0) invert(1)}
-    .header-actions{margin-left:auto;display:flex;align-items:center;gap:10px}.client-switch{display:flex;padding:3px;border:1px solid var(--line);border-radius:10px;background:var(--control-bg)}.client-button{height:28px;padding:0 11px;border:0;border-radius:7px;background:transparent;color:var(--muted);font-size:11px;font-weight:680;cursor:pointer}.client-button[aria-pressed="true"]{background:var(--control-bg-strong);color:var(--ink);box-shadow:var(--active-shadow)}.connection{display:flex;align-items:center;gap:8px;min-height:34px;padding:0 12px;border:1px solid var(--line);border-radius:999px;background:var(--control-bg);color:var(--muted);font-size:11px;font-weight:600}.connection-dot{position:relative;width:7px;height:7px;border-radius:50%;background:var(--green);box-shadow:0 0 0 4px rgba(22,132,82,.1)}.connection.offline{color:var(--red);border-color:color-mix(in srgb,var(--red) 35%,var(--line));background:var(--red-soft)}.connection.offline .connection-dot{background:var(--red);box-shadow:0 0 0 4px rgba(194,59,80,.1)}
+    .header-actions{margin-left:auto;display:flex;align-items:center;gap:10px}.client-switch{display:flex;padding:3px;border:1px solid var(--line);border-radius:10px;background:var(--control-bg)}.client-select{height:28px;min-width:134px;padding:0 8px;border:0;border-radius:7px;outline:0;background:var(--control-bg-strong);color:var(--ink);font-size:11px;font-weight:680;cursor:pointer}.connection{display:flex;align-items:center;gap:8px;min-height:34px;padding:0 12px;border:1px solid var(--line);border-radius:999px;background:var(--control-bg);color:var(--muted);font-size:11px;font-weight:600}.connection-dot{position:relative;width:7px;height:7px;border-radius:50%;background:var(--green);box-shadow:0 0 0 4px rgba(22,132,82,.1)}.connection.offline{color:var(--red);border-color:color-mix(in srgb,var(--red) 35%,var(--line));background:var(--red-soft)}.connection.offline .connection-dot{background:var(--red);box-shadow:0 0 0 4px rgba(194,59,80,.1)}
     .preference-actions{display:flex;align-items:center;gap:6px}.icon-button{display:grid;width:34px;height:34px;padding:0;place-items:center;border:1px solid var(--line);border-radius:10px;background:var(--control-bg);cursor:pointer;transition:border-color .18s,background-color .18s,transform .18s}.icon-button:hover{border-color:var(--line-strong);background:var(--control-bg-strong);transform:translateY(-1px)}.icon-button:active{transform:translateY(0)}.icon-button svg{width:15px;height:15px}.icon-button.loading svg{animation:spin .8s linear infinite}.language-button{font-size:10px;font-weight:760;letter-spacing:.02em}.theme-sun{display:none}[data-theme="dark"] .theme-sun{display:block}[data-theme="dark"] .theme-moon{display:none}
     main{padding:56px 0 80px}.hero{display:grid;grid-template-columns:minmax(0,1fr) 280px;align-items:end;gap:40px;margin-bottom:28px}.eyebrow{display:flex;align-items:center;gap:8px;margin-bottom:11px;color:var(--violet);font-size:11px;font-weight:760;letter-spacing:.11em;text-transform:uppercase}.eyebrow:before{content:"";width:19px;height:2px;border-radius:2px;background:currentColor}.hero h1{margin:0;font-size:clamp(30px,4vw,42px);font-weight:730;line-height:1.12;letter-spacing:-.04em}.hero p{max-width:620px;margin:13px 0 0;color:var(--muted);font-size:14px;line-height:1.7}
     .scope label{display:block;margin:0 0 8px;color:var(--muted);font-size:11px;font-weight:650}.select-wrap{position:relative}.select-wrap svg{position:absolute;right:13px;top:50%;width:14px;height:14px;pointer-events:none;transform:translateY(-50%);color:var(--quiet)}.scope select{width:100%;height:44px;padding:0 40px 0 13px;appearance:none;border:1px solid var(--line-strong);border-radius:12px;outline:none;background:var(--select-bg);color:var(--ink);font-size:13px;font-weight:570;box-shadow:0 1px 2px rgba(25,27,39,.025);transition:border-color .18s,box-shadow .18s}.scope select:hover{border-color:color-mix(in srgb,var(--violet) 28%,var(--line-strong))}.scope select:focus{border-color:color-mix(in srgb,var(--violet) 60%,transparent);box-shadow:0 0 0 4px color-mix(in srgb,var(--violet) 12%,transparent)}
@@ -90,13 +92,13 @@ export function memoryViewerUserHtml() {
     .skeleton{overflow:hidden;color:transparent!important;border-radius:6px;background:linear-gradient(90deg,var(--skeleton-a) 25%,var(--skeleton-b) 50%,var(--skeleton-a) 75%);background-size:200% 100%;animation:shimmer 1.2s infinite}.metric.skeleton{width:70px;height:40px}.repo-state.skeleton{width:110px;height:25px}.loading-copy{width:90px;height:13px;margin-top:7px}
     :focus-visible{outline:2px solid var(--violet);outline-offset:3px}@keyframes spin{to{transform:rotate(360deg)}}@keyframes shimmer{to{background-position:-200% 0}}
     @media(max-width:780px){.shell{width:min(100% - 28px,1080px)}main{padding:38px 0 60px}.hero{grid-template-columns:1fr;gap:24px}.scope{max-width:none}.cards{grid-template-columns:1fr}.card{min-height:150px}.metric{margin-top:15px}.repo-state{margin-top:18px}.activity{padding:3px 16px}.section-head{padding:18px}.row{grid-template-columns:32px minmax(0,1fr);gap:11px}.status{grid-column:2;justify-self:start;margin-top:-7px}.brand-divider,.product-name{display:none}}
-    @media(max-width:720px){.header-inner{height:auto;min-height:108px;display:grid;grid-template-columns:minmax(0,1fr) auto;align-content:center;gap:10px 12px;padding:10px 0}.header-actions{display:contents}.client-switch{grid-column:1/-1;grid-row:2}.client-button{flex:1}.connection{display:none}.preference-actions{grid-column:2;grid-row:1;justify-self:end}}
+    @media(max-width:720px){.header-inner{height:auto;min-height:108px;display:grid;grid-template-columns:minmax(0,1fr) auto;align-content:center;gap:10px 12px;padding:10px 0}.header-actions{display:contents}.client-switch{grid-column:1/-1;grid-row:2}.client-select{width:100%}.connection{display:none}.preference-actions{grid-column:2;grid-row:1;justify-self:end}}
     @media(max-width:440px){.shell{width:calc(100% - 22px)}.logo{height:24px;max-width:145px}.hero h1{font-size:29px}.hero p{font-size:13px}.card{border-radius:16px}.activity-section{border-radius:16px}.row-meta{display:block;white-space:normal;line-height:1.55}.meta-separator{display:none}.meta-item{margin-right:6px}}
     @media(prefers-reduced-motion:reduce){*,*:before,*:after{scroll-behavior:auto!important;animation-duration:.01ms!important;animation-iteration-count:1!important;transition-duration:.01ms!important}}
   </style>
 </head>
 <body>
-  <header><div class="header-inner shell"><div class="brand"><img class="logo" src="/memory-viewer/logo" alt="MemoraX AI"><span class="brand-divider" aria-hidden="true"></span><span class="product-name" data-i18n="productName">Memory Viewer</span></div><div class="header-actions"><div class="client-switch" role="group" aria-label="Select client" data-i18n-aria="clientGroup"><button class="client-button" type="button" data-client="codex" aria-pressed="true">Codex</button><button class="client-button" type="button" data-client="claude-code" aria-pressed="false">Claude Code</button></div><div id="connection-pill" class="connection" role="status"><span class="connection-dot"></span><span id="connection" data-i18n="connecting">Connecting</span><span id="connection-time" class="connection-time"></span></div><div class="preference-actions"><button id="language-toggle" class="icon-button language-button" type="button" aria-label="切换到中文" title="切换到中文">中</button><button id="theme-toggle" class="icon-button" type="button" aria-label="Switch to dark mode" title="Switch to dark mode"><svg class="theme-moon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8"><path d="M20 15.1A8.5 8.5 0 0 1 8.9 4a8.5 8.5 0 1 0 11.1 11.1Z" stroke-linecap="round" stroke-linejoin="round"/></svg><svg class="theme-sun" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8"><circle cx="12" cy="12" r="3.5"/><path d="M12 2v2M12 20v2M4.93 4.93l1.42 1.42M17.65 17.65l1.42 1.42M2 12h2M20 12h2M4.93 19.07l1.42-1.42M17.65 6.35l1.42-1.42" stroke-linecap="round"/></svg></button><button id="refresh" class="icon-button" type="button" aria-label="Refresh memory activity" title="Refresh memory activity" data-i18n-aria="refresh" data-i18n-title="refresh"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8"><path d="M20 11a8 8 0 1 0-2.34 5.66M20 4v7h-7" stroke-linecap="round" stroke-linejoin="round"/></svg></button></div></div></div></header>
+  <header><div class="header-inner shell"><div class="brand"><img class="logo" src="/memory-viewer/logo" alt="MemoraX AI"><span class="brand-divider" aria-hidden="true"></span><span class="product-name" data-i18n="productName">Memory Viewer</span></div><div class="header-actions"><div class="client-switch"><select id="client-select" class="client-select" aria-label="Select client" data-i18n-aria="clientGroup"><option value="codex">Codex</option><option value="claude-code">Claude Code</option><option value="dsh">DeepSeek</option><option value="opencode">OpenCode</option></select></div><div id="connection-pill" class="connection" role="status"><span class="connection-dot"></span><span id="connection" data-i18n="connecting">Connecting</span><span id="connection-time" class="connection-time"></span></div><div class="preference-actions"><button id="language-toggle" class="icon-button language-button" type="button" aria-label="切换到中文" title="切换到中文">中</button><button id="theme-toggle" class="icon-button" type="button" aria-label="Switch to dark mode" title="Switch to dark mode"><svg class="theme-moon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8"><path d="M20 15.1A8.5 8.5 0 0 1 8.9 4a8.5 8.5 0 1 0 11.1 11.1Z" stroke-linecap="round" stroke-linejoin="round"/></svg><svg class="theme-sun" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8"><circle cx="12" cy="12" r="3.5"/><path d="M12 2v2M12 20v2M4.93 4.93l1.42 1.42M17.65 17.65l1.42 1.42M2 12h2M20 12h2M4.93 19.07l1.42-1.42M17.65 6.35l1.42-1.42" stroke-linecap="round"/></svg></button><button id="refresh" class="icon-button" type="button" aria-label="Refresh memory activity" title="Refresh memory activity" data-i18n-aria="refresh" data-i18n-title="refresh"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8"><path d="M20 11a8 8 0 1 0-2.34 5.66M20 4v7h-7" stroke-linecap="round" stroke-linejoin="round"/></svg></button></div></div></div></header>
   <main class="shell">
     <section class="hero">
       <div class="hero-copy"><div class="eyebrow" data-i18n="eyebrow">Memory at a glance</div><h1 data-i18n="heading">Memory usage</h1><p data-i18n="intro">See how client sessions use project memory and whether repository knowledge is ready.</p></div>

package/lib/memorax-code-backend/dist/windows-cli-invocation.js

@@ -1,148 +1 @@
-import { spawn, spawnSync } from "node:child_process";
-import { existsSync } from "node:fs";
-import path from "node:path";
-export function resolveWindowsCliInvocation(command, args, options = {}) {
-    const platform = options.platform ?? process.platform;
-    if (platform !== "win32")
-        return { command, args };
-    const pathApi = path.win32;
-    const fileExists = options.existsSync ?? existsSync;
-    const env = options.env ?? process.env;
-    let resolvedCommand = options.resolvedCommand;
-    if (!resolvedCommand && !/[\\/]/.test(command)) {
-        const located = options.whereOutput === undefined
-            ? (options.spawnSync ?? spawnSync)("where.exe", [command], {
-                env,
-                encoding: "utf8",
-                stdio: ["ignore", "pipe", "pipe"],
-                windowsHide: true,
-            })
-            : { status: 0, stdout: options.whereOutput };
-        if (located.status === 0) {
-            resolvedCommand = selectWindowsCommandCandidate(command, located.stdout);
-        }
-    }
-    resolvedCommand ??= command;
-    if (/\.(?:exe|com)$/i.test(resolvedCommand))
-        return { command: resolvedCommand, args };
-    if (!/\.(?:cmd|bat)$/i.test(resolvedCommand)) {
-        throw new Error(`refusing to execute unsupported Windows command shim: ${resolvedCommand}`);
-    }
-    const name = pathApi.basename(resolvedCommand).replace(/\.(?:cmd|bat)$/i, "").toLowerCase();
-    const nativeCli = nativeCliEntrypointCandidates(name, resolvedCommand, env, pathApi)
-        .filter(isNativeEntrypoint)
-        .find((candidate) => fileExists(candidate));
-    if (nativeCli)
-        return { command: nativeCli, args };
-    const cli = cliEntrypointCandidates(name, resolvedCommand, env, pathApi)
-        .filter(isNodeEntrypoint)
-        .find((candidate) => fileExists(candidate));
-    if (!cli) {
-        const override = name === "claude" ? "MEMORAX_CODE_CLAUDE_CLI_JS" : "MEMORAX_CODE_CODEX_CLI_JS";
-        throw new Error(`refusing to execute ${pathApi.basename(resolvedCommand)} through a command shell; `
-            + `set ${override} to its Node entrypoint`);
-    }
-    return { command: options.nodePath ?? process.execPath, args: [cli, ...args] };
-}
-function nativeCliEntrypointCandidates(name, command, env, pathApi) {
-    if (name !== "claude")
-        return [];
-    const root = pathApi.dirname(command);
-    return [
-        env.MEMORAX_CODE_CLAUDE_CLI_EXE,
-        env.CLAUDE_CLI_EXE,
-        pathApi.join(root, "node_modules", "@anthropic-ai", "claude-code", "bin", "claude.exe"),
-        pathApi.join(root, "..", "@anthropic-ai", "claude-code", "bin", "claude.exe"),
-    ].filter((candidate) => typeof candidate === "string");
-}
-function cliEntrypointCandidates(name, command, env, pathApi) {
-    const root = pathApi.dirname(command);
-    if (name === "codex") {
-        return [
-            env.MEMORAX_CODE_CODEX_CLI_JS,
-            env.CODEX_CLI_JS,
-            pathApi.join(root, "node_modules", "@openai", "codex", "bin", "codex.js"),
-            pathApi.join(root, "..", "@openai", "codex", "bin", "codex.js"),
-        ].filter((candidate) => typeof candidate === "string");
-    }
-    if (name === "claude") {
-        return [
-            env.MEMORAX_CODE_CLAUDE_CLI_JS,
-            env.CLAUDE_CLI_JS,
-            pathApi.join(root, "node_modules", "@anthropic-ai", "claude-code", "cli.js"),
-            pathApi.join(root, "..", "@anthropic-ai", "claude-code", "cli.js"),
-        ].filter((candidate) => typeof candidate === "string");
-    }
-    return [];
-}
-function isNativeEntrypoint(value) {
-    return /\.(?:exe|com)$/i.test(value);
-}
-function isNodeEntrypoint(value) {
-    return /\.(?:cjs|js|mjs)$/i.test(value);
-}
-export function selectWindowsCommandCandidate(command, output) {
-    const candidates = String(output ?? "")
-        .split(/\r?\n/)
-        .map((value) => value.trim())
-        .filter(Boolean);
-    const selected = candidates.find((value) => /\.(?:cmd|bat)$/i.test(value))
-        ?? candidates.find((value) => /\.(?:exe|com)$/i.test(value));
-    if (!selected) {
-        throw new Error(`where.exe did not return a safe executable or command shim for ${command}`);
-    }
-    return selected;
-}
-export function resolveWindowsNpmInvocation(args, env, options = {}) {
-    const platform = options.platform ?? process.platform;
-    if (platform !== "win32")
-        return { command: "npm", args };
-    const nodePath = options.nodePath ?? process.execPath;
-    const fileExists = options.existsSync ?? existsSync;
-    const candidates = [
-        env.MEMORAX_CODE_NPM_EXEC_PATH,
-        env.npm_execpath,
-        env.NPM_CLI_JS,
-        path.win32.join(path.win32.dirname(nodePath), "node_modules", "npm", "bin", "npm-cli.js"),
-        path.win32.join(path.win32.dirname(path.win32.dirname(nodePath)), "lib", "node_modules", "npm", "bin", "npm-cli.js"),
-    ].filter((candidate) => (typeof candidate === "string" && /\.(?:cjs|js|mjs)$/i.test(candidate)));
-    const npmCli = candidates.find((candidate) => fileExists(candidate));
-    if (!npmCli) {
-        throw new Error("npm CLI JavaScript entrypoint was not found; set MEMORAX_CODE_NPM_EXEC_PATH, "
-            + "npm_execpath, or NPM_CLI_JS");
-    }
-    return { command: nodePath, args: [npmCli, ...args] };
-}
-export function runProcessWithWindowsNpm(command, args, options) {
-    return new Promise((resolveResult) => {
-        let invocation = { command, args };
-        try {
-            if (command === "npm") {
-                invocation = resolveWindowsNpmInvocation(args, options.env);
-            }
-        }
-        catch (error) {
-            resolveResult({
-                ok: false,
-                stdout: "",
-                stderr: error instanceof Error ? error.message : String(error),
-            });
-            return;
-        }
-        const child = spawn(invocation.command, invocation.args, {
-            cwd: options.cwd,
-            env: options.env,
-            stdio: ["ignore", "pipe", "pipe"],
-        });
-        let stdout = "";
-        let stderr = "";
-        child.stdout.on("data", (chunk) => { stdout += String(chunk); });
-        child.stderr.on("data", (chunk) => { stderr += String(chunk); });
-        child.on("error", (error) => {
-            resolveResult({ ok: false, stdout, stderr: stderr || error.message });
-        });
-        child.on("close", (code) => {
-            resolveResult({ ok: code === 0, stdout, stderr });
-        });
-    });
-}
+export * from "./shared/windows-cli-invocation.js";

package/lib/memorax-code-backend/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@memorax-code/backend",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "private": true,
   "type": "module",
   "description": "Local memory integration, lifecycle, trace, and diagnostics for MemoraX Code.",
@@ -13,8 +13,8 @@
     "dev": "tsc --watch --preserveWatchOutput",
     "dev:backend": "node --watch dist/server.js",
     "typecheck": "tsc --noEmit",
-    "test": "npm run build && node --test --test-timeout=5000 --test-force-exit test/*.test.mjs",
-    "test:memory-viewer": "npm run build && node --test --test-timeout=5000 --test-force-exit test/memory-viewer-routes.test.mjs"
+    "test": "npm run build && node --test --test-timeout=5000 --test-force-exit \"test/**/*.test.mjs\"",
+    "test:memory-viewer": "npm run build && node --test --test-timeout=5000 --test-force-exit test/viewer/http/memory-viewer-routes.test.mjs"
   },
   "devDependencies": {
     "@types/node": "^24.13.2",

package/lib/memorax-code-claude-adapter/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "memorax-code-claude-adapter",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Memory skill and local hooks for MemoraX Code in Claude Code.",
   "author": {
     "name": "MemoraX Code Maintainers"

package/lib/memorax-code-claude-adapter/hooks/runtime-shell.json

@@ -1,5 +1,5 @@
 {
   "version": 1,
-  "shellVersion": "0.1.1",
+  "shellVersion": "0.1.3",
   "runtimeAbi": 1
 }

package/lib/memorax-code-claude-adapter/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@memorax-code/claude-adapter",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "private": true,
   "type": "module",
   "description": "Claude Code Hook adapter for MemoraX Code memory services.",

package/lib/memorax-code-claude-adapter/runtime-hooks/memory-turn.mjs

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 import { resolveBackendConnection } from "../../memorax-code-adapter-common/src/backend-connection.mjs";
 import { readStdinJson } from "../../memorax-code-adapter-common/src/config-utils.mjs";
+import { scheduleMissingRepoMemoryBuild } from "../../memorax-code-adapter-common/src/repo-memory/repo-memory-auto-build.mjs";
 import { isRepoMemoryJobWorker } from "../../memorax-code-adapter-common/src/repo-memory/repo-memory-job-context.mjs";
 
 const RETRIEVAL_BACKEND_TIMEOUT_MS = 12_000;
@@ -29,6 +30,10 @@ try {
       cwd: stringValue(input.cwd),
       workspaceKind: stringValue(input.workspace_kind) ?? stringValue(input.workspaceKind),
     });
+    scheduleMissingRepoMemoryBuild(stringValue(response?.repoMemoryWorktree), {
+      debugEnv: "MEMORAX_CODE_CLAUDE_HOOK_DEBUG",
+      pluginRoot: process.env.CLAUDE_PLUGIN_ROOT,
+    });
     const additionalContext = stringValue(response?.additionalContext);
     if (additionalContext) {
       process.stdout.write(`${JSON.stringify({

package/lib/memorax-code-claude-adapter/skills/memorax-code/SKILL.md

@@ -1,27 +1,31 @@
 ---
 name: memorax-code
 description: >-
-  Use this skill as the single entry point for persistent coding and
-  repository-local memory work, regardless of type, wording, or operation. Use
-  it whenever a request may involve information that should persist beyond the
-  current task,
-  knowledge remembered from prior work, repository memory,
-  reusable procedures or working rules, or durable user profile and interaction
-  preferences. This applies even when the user does not call it memory,
-  including naturally stated habits, preferences,
+  Use this skill as the single router for persistent coding and repository-local
+  memory. Invoke it whenever a request may involve prior-work knowledge,
+  repository memory, reusable procedures or rules, durable profile or
+  interaction preferences, or information worth retaining beyond the current
+  task. This applies without memory wording, including habits, preferences,
   checklists, action sequences, prerequisites, gates, exceptions, validation
   rules, communication style, preferred language, or result presentation.
-  Determine whether the request belongs to MemoraX Code coding memory,
-  repository memory, personal procedure memory, personal profile
-  memory, or no persistent memory, then route it to the appropriate operation.
-  Prefer this router over any underlying memory workflow. Ask one focused
-  question only when the memory authority remains ambiguous after routing.
+  Classify the request as coding memory, repository memory, personal procedure
+  memory, personal profile memory, or no persistent memory, then route it to the
+  matching operation. Invoking this router does not require coding-memory
+  search. Reuse a relevant coding-memory result already retrieved in this
+  conversation; otherwise let the matching operation decide on search. Prefer
+  this router over underlying memory workflows. Ask one focused question only when
+  memory authority remains ambiguous.
 ---
 
 # MemoraX Code
 
 Classify the requested memory authority first, then its operation. Load only the matching reference unless the request genuinely spans authorities or operations.
 
+After selecting an operation reference, read it completely in a standalone
+tool call and wait for the full result before constructing or executing that
+operation. Never combine reading a required reference with the command or
+action it governs in the same shell command or tool call.
+
 ## Authority Router
 
 ### MemoraX Code Coding Memory
@@ -52,8 +56,11 @@ Use personal memory for user-owned repository procedures and durable profile or
 - Route ordered actions, checklists, prerequisites, gates, exceptions, and validation rules to personal procedure memory, even when phrased as "I prefer", "I like", "我的习惯", or "我喜欢".
 - Route preferred name, answer language, tone, verbosity, explanation style, and result presentation to personal profile memory.
 - Route task-learned repairs, coding pitfalls, project engineering conventions, and reusable design lessons to MemoraX Code coding memory.
+- Route prior project discussions, experiment conclusions, saved engineering findings, earlier fixes, and reusable project lessons to MemoraX Code coding memory. Do not route them to repo memory merely because they concern a project. Use repo memory for repository identity, architecture, module maps, commits, PRs, MRs, and issues.
 - Route repository architecture, module maps, commit history, PRs, MRs, and issues to repo memory. Verify claims about current behavior against live code.
+- Use both repo memory and MemoraX Code coding memory only when a request genuinely needs distinct repository evidence and reusable engineering lessons. This can apply to implementation, debugging, refactoring, migration planning, or validation when the answer may depend on repository module maps, commit/PR/issue evidence, and prior fixes, pitfalls, conventions, validation patterns, or design rationale. Do not use both authorities just because a request mentions a repository, file, module, or "previous".
 - Route current-task instructions and temporary plans to the current task only; do not persist them.
+- Current-task-only applies only when completing the request does not depend on prior project state. Do not select it merely because the requested action happens in the current turn. When implementation, debugging, review, experiment continuation, or validation depends on earlier project decisions, results, fixes, constraints, or plans that the user has not explicitly and completely supplied, route to MemoraX Code coding memory.
 - Do not infer an authority from verbs such as "remember", "recall", "refresh", or "update" alone. Ask one focused question when the target remains ambiguous.
 
 Examples:
@@ -73,11 +80,12 @@ Repo memory and personal memory remain local `.repo_memory` authorities. Resolve
 
 Apply instructions in this order: system and developer instructions, `AGENTS.md`, the current user request, then stored memory. Memory is guidance or historical context, not proof of current repository behavior.
 
-For MemoraX Code coding memory, use `memorax-cli` exactly as described by the selected reference. Invoke this skill as `$memorax-code` in Codex or `/memorax-code` in Claude Code; neither invocation is a shell command. `memorax-code` is the lifecycle CLI and must not be used for memory search or add. Do not call MemoraX HTTP endpoints directly.
+For MemoraX Code coding memory, use `memorax-cli` exactly as described by the selected reference. Invoke this skill as `$memorax-code` in Codex or `/memorax-code` in Claude Code. In OpenCode, ask the agent to use the `memorax-code` skill by name. These invocation forms are not shell commands. `memorax-code` is the lifecycle CLI and must not be used for memory search or add. Do not call MemoraX HTTP endpoints directly.
 
 When explaining Memory Viewer, describe only `/memory-viewer`. It is a
 content-free local summary and must not expose conversation or memory text,
 session or turn identifiers, paths, or trace details. The page never queries
-MemoraX directly; client Hooks are the trace ingress authority.
+MemoraX directly; it projects client-qualified local activity and keeps each
+supported harness isolated.
 
 Never store secrets, credentials, `.env` content, sensitive personal data, raw transcripts, hidden tests, exact patches, temporary target commits, or unsafe destructive commands. Do not announce internal routing or reference loading.