@memorax/memorax-code 0.1.5 → 0.1.7

package/lib/memorax-code-claude-marketplace/plugins/memorax-code-claude-adapter/memorax-code-adapter-common/src/hooks/memory-skill-reminder-hook.mjs

@@ -23,10 +23,11 @@ export async function runMemorySkillReminderHook(options, hookInput) {
     const result = await evaluateMemorySkillReminder(options, input);
     if (!result) return;
     process.stdout.write(`${JSON.stringify({
-      hookSpecificOutput: {
+      ...(result.systemMessage ? { systemMessage: result.systemMessage } : {}),
+      ...(result.additionalContext ? { hookSpecificOutput: {
         hookEventName: "UserPromptSubmit",
         additionalContext: result.additionalContext,
-      },
+      } } : {}),
     })}\n`);
     if (result.reminder) await notifyReminder(options, result.reminder);
   } catch (error) {
@@ -80,7 +81,8 @@ export async function evaluateMemorySkillReminder(options, input) {
     const { memoryReminderDue, supplementalReminderDue } = update;
 
     const baseAdditionalContext = stringOption(options.baseAdditionalContext);
-    if (!baseAdditionalContext && !memoryReminderDue && !supplementalReminderDue) return undefined;
+    const systemMessage = stringOption(options.systemMessage);
+    if (!baseAdditionalContext && !memoryReminderDue && !supplementalReminderDue && !systemMessage) return undefined;
     const cadenceReminderContext = memoryReminderDue
       ? await buildCadenceReminderContext(options, input)
       : undefined;
@@ -97,7 +99,8 @@ export async function evaluateMemorySkillReminder(options, input) {
       ...(supplementalReminderDue ? ["post_compaction"] : []),
     ];
     return {
-      additionalContext,
+      ...(systemMessage ? { systemMessage } : {}),
+      ...(additionalContext ? { additionalContext } : {}),
       ...(reminderContext ? {
         reminder: {
           sessionId,

package/lib/memorax-code-claude-marketplace/plugins/memorax-code-claude-adapter/memorax-code-adapter-common/src/setup-completion.d.mts

@@ -0,0 +1,81 @@
+import type { JsonFileLockOptions } from "./config-utils.mjs";
+import {
+  RuntimeRecordError,
+  type RuntimeRecordWriteResult,
+  type RuntimeRecordWriteRuntime,
+} from "./runtime-record.mjs";
+
+export type SetupCompletionRecord = Readonly<{
+  version: 1;
+  state: "complete";
+  completedAt: string;
+  completedByVersion: string;
+}>;
+
+export type SetupCompletionRecordInvalidReason =
+  | "unreadable"
+  | "malformed_json"
+  | "invalid_record"
+  | "invalid_version"
+  | "unknown_fields"
+  | "invalid_state"
+  | "invalid_completed_at"
+  | "invalid_completed_by_version";
+
+export type SetupCompletionRecordState =
+  | Readonly<{ status: "absent" }>
+  | Readonly<{ status: "valid"; record: SetupCompletionRecord }>
+  | Readonly<{ status: "invalid"; reason: SetupCompletionRecordInvalidReason }>
+  | Readonly<{ status: "unsupported"; version: number }>;
+
+export type WritableSetupCompletionRecordState = Extract<
+  SetupCompletionRecordState,
+  { status: "absent" | "valid" }
+>;
+
+export type SetupCompletionClearResult = Readonly<{
+  path: string;
+  removed: boolean;
+}>;
+
+export type SetupCompletionLockMutation = Readonly<{
+  clear(): SetupCompletionClearResult;
+}>;
+
+export const SETUP_COMPLETION_RECORD_VERSION: 1;
+
+export class SetupCompletionRecordError extends RuntimeRecordError {
+  constructor(
+    state: Extract<SetupCompletionRecordState, { status: "invalid" | "unsupported" }>,
+    path: string,
+  );
+}
+
+export function setupCompletionPath(memoraxCodeHome?: string): string;
+
+export function readSetupCompletionRecord(
+  memoraxCodeHome?: string,
+): SetupCompletionRecordState;
+
+export function writeSetupCompletionRecord(
+  options: {
+    memoraxCodeHome?: string;
+    completedAt: string;
+    completedByVersion: string;
+  },
+  runtime?: RuntimeRecordWriteRuntime,
+): RuntimeRecordWriteResult<SetupCompletionRecord>;
+
+export function clearSetupCompletionRecord(
+  memoraxCodeHome?: string,
+  options?: JsonFileLockOptions,
+): Promise<SetupCompletionClearResult>;
+
+export function withSetupCompletionLock<T>(
+  memoraxCodeHome: string,
+  operation: (
+    state: WritableSetupCompletionRecordState,
+    mutation: SetupCompletionLockMutation,
+  ) => T | Promise<T>,
+  options?: JsonFileLockOptions,
+): Promise<T>;

package/lib/memorax-code-claude-marketplace/plugins/memorax-code-claude-adapter/memorax-code-adapter-common/src/setup-completion.mjs

@@ -0,0 +1,154 @@
+import { unlinkSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { withJsonFileLockAsync } from "./config-utils.mjs";
+import {
+  readJsonRuntimeRecord,
+  RuntimeRecordError,
+  writePrivateJsonRecord,
+} from "./runtime-record.mjs";
+
+export const SETUP_COMPLETION_RECORD_VERSION = 1;
+
+const SETUP_COMPLETION_RECORD_KEYS = new Set([
+  "version",
+  "state",
+  "completedAt",
+  "completedByVersion",
+]);
+const ISO_TIMESTAMP_PATTERN = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d{1,9})?(?:Z|[+-]\d{2}:\d{2})$/;
+
+export class SetupCompletionRecordError extends RuntimeRecordError {
+  constructor(state, path) {
+    super({
+      name: "Setup completion record",
+      path,
+      state,
+      codePrefix: "SETUP_COMPLETION_RECORD",
+      recovery: state.status === "unsupported"
+        ? "upgrade MemoraX Code or restore a supported setup completion record"
+        : "inspect the setup completion record before replacing it",
+    });
+    this.name = "SetupCompletionRecordError";
+  }
+}
+
+export function setupCompletionPath(memoraxCodeHome = defaultMemoraxCodeHome()) {
+  return join(memoraxCodeHome, "runtime", "setup", "setup-completion.json");
+}
+
+export function readSetupCompletionRecord(memoraxCodeHome = defaultMemoraxCodeHome()) {
+  const path = setupCompletionPath(memoraxCodeHome);
+  const state = readJsonRuntimeRecord(path);
+  if (state.status !== "present") return state;
+  const value = state.value;
+  if (value.version !== SETUP_COMPLETION_RECORD_VERSION) {
+    if (Number.isSafeInteger(value.version) && value.version > 0) {
+      return { status: "unsupported", version: value.version };
+    }
+    return { status: "invalid", reason: "invalid_version" };
+  }
+  if (Object.keys(value).some((key) => !SETUP_COMPLETION_RECORD_KEYS.has(key))) {
+    return { status: "invalid", reason: "unknown_fields" };
+  }
+  if (value.state !== "complete") {
+    return { status: "invalid", reason: "invalid_state" };
+  }
+  const completedAt = isoTimestamp(value.completedAt);
+  if (!completedAt) return { status: "invalid", reason: "invalid_completed_at" };
+  const completedByVersion = nonEmptyString(value.completedByVersion);
+  if (!completedByVersion) {
+    return { status: "invalid", reason: "invalid_completed_by_version" };
+  }
+  return {
+    status: "valid",
+    record: {
+      version: SETUP_COMPLETION_RECORD_VERSION,
+      state: "complete",
+      completedAt,
+      completedByVersion,
+    },
+  };
+}
+
+export function writeSetupCompletionRecord(options, runtime) {
+  const memoraxCodeHome = nonEmptyString(options?.memoraxCodeHome) ?? defaultMemoraxCodeHome();
+  const completedAt = isoTimestamp(options?.completedAt);
+  if (!completedAt) {
+    throw new TypeError("Setup completion record requires a valid ISO completedAt timestamp");
+  }
+  const completedByVersion = nonEmptyString(options?.completedByVersion);
+  if (!completedByVersion) {
+    throw new TypeError("Setup completion record requires a non-empty completedByVersion");
+  }
+  const path = setupCompletionPath(memoraxCodeHome);
+  const existing = readSetupCompletionRecord(memoraxCodeHome);
+  if (existing.status === "invalid" || existing.status === "unsupported") {
+    throw new SetupCompletionRecordError(existing, path);
+  }
+  return writePrivateJsonRecord(path, {
+    version: SETUP_COMPLETION_RECORD_VERSION,
+    state: "complete",
+    completedAt,
+    completedByVersion,
+  }, {
+    ...runtime,
+    durableBoundary: memoraxCodeHome,
+  });
+}
+
+export async function clearSetupCompletionRecord(
+  memoraxCodeHome = defaultMemoraxCodeHome(),
+  options,
+) {
+  const home = nonEmptyString(memoraxCodeHome) ?? defaultMemoraxCodeHome();
+  return await withSetupCompletionLock(
+    home,
+    (_state, mutation) => mutation.clear(),
+    options,
+  );
+}
+
+export async function withSetupCompletionLock(
+  memoraxCodeHome,
+  operation,
+  options,
+) {
+  const home = nonEmptyString(memoraxCodeHome);
+  if (!home) throw new TypeError("Setup completion lock requires a MemoraX Code home");
+  if (typeof operation !== "function") {
+    throw new TypeError("Setup completion lock requires an operation");
+  }
+  const path = setupCompletionPath(home);
+  return await withJsonFileLockAsync(path, async () => {
+    let state = readSetupCompletionRecord(home);
+    if (state.status === "invalid" || state.status === "unsupported") {
+      throw new SetupCompletionRecordError(state, path);
+    }
+    return await operation(state, {
+      clear() {
+        if (state.status === "absent") return { path, removed: false };
+        unlinkSync(path);
+        state = { status: "absent" };
+        return { path, removed: true };
+      },
+    });
+  }, options);
+}
+
+function defaultMemoraxCodeHome() {
+  return join(homedir(), ".memorax-code");
+}
+
+function nonEmptyString(value) {
+  return typeof value === "string" && value.trim() ? value.trim() : undefined;
+}
+
+function isoTimestamp(value) {
+  const candidate = nonEmptyString(value);
+  return candidate
+    && ISO_TIMESTAMP_PATTERN.test(candidate)
+    && Number.isFinite(Date.parse(candidate))
+    ? candidate
+    : undefined;
+}

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

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

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

@@ -35,12 +35,14 @@ try {
       pluginRoot: process.env.CLAUDE_PLUGIN_ROOT,
     });
     const additionalContext = stringValue(response?.additionalContext);
-    if (additionalContext) {
+    const systemMessage = stringValue(response?.userNotice);
+    if (additionalContext || systemMessage) {
       process.stdout.write(`${JSON.stringify({
-        hookSpecificOutput: {
+        ...(systemMessage ? { systemMessage } : {}),
+        ...(additionalContext ? { hookSpecificOutput: {
           hookEventName: "UserPromptSubmit",
           additionalContext,
-        },
+        } } : {}),
       })}\n`);
     }
   } else if (event === "Stop") {

package/lib/memorax-code-claude-marketplace/plugins/memorax-code-claude-adapter/skills/memorax-code/references/memorax-add.md

@@ -83,4 +83,6 @@ Do not add speculation, assistant-only praise, or a current instruction merely b
 
 ## Output
 
+If a successful Add returns `quotaNotice`, or prints it as a quota-reminder line in the default CLI output, present the complete reminder once and prominently before the normal result summary. Do not reduce it to only a percentage or omit its account URL or conditional local Mark ID retrieval instructions. Never run `memorax-code account --show-mark-id` for the user, ask for its output, or reproduce a Mark ID in chat. Treat the reminder as user-facing operational output, not coding memory content, and continue the current task.
+
 After an add request is accepted, confirm briefly that it was submitted for processing and identify the reusable coding lesson at a high level. If add is disabled or fails, report the issue and continue without bypassing the CLI.

package/lib/memorax-code-claude-marketplace/plugins/memorax-code-claude-adapter/skills/memorax-code/references/memorax-search.md

@@ -6,11 +6,11 @@ Use these instructions only to search reusable coding memory through `memorax-cl
 
 Run the CLI from the active task workspace. The installed Hook and session binding supply the authoritative workspace root; do not run `git rev-parse`, infer the root from Git metadata, or substitute an unrelated working directory. Do not make `memorax-cli status` a mandatory preflight; use it only to diagnose a configuration or scope failure.
 
-Coding memory uses `<MemoraX base user ID>@<normalized repository name>` for Git workspaces and the normalized folder name for genuine non-Git directories. MemoraX Code resolves `.git`, `gitdir`, and `commondir` without executing Git. Linked worktrees share one repository scope; another clone, repository, or non-Git directory retains a different local session key even when its readable name matches.
+Coding memory uses `<MemoraX base username>@<normalized repository name>` for Git workspaces and the normalized folder name for genuine non-Git directories. MemoraX Code resolves `.git`, `gitdir`, and `commondir` without executing Git. Linked worktrees share one repository scope; another clone, repository, or non-Git directory retains a different local session key even when its readable name matches.
 
 If a successful Search result reports `workspaceScopeFallbackReason: git_metadata_invalid`, malformed or incomplete metadata inside a direct `.git` directory was downgraded to the normalized local folder scope. Search has already run with the reported `effectiveUserId`. Present its `userNotice` once without pausing the current task or asking the user to repair Git first, then continue with the returned memory and live evidence. After the repository or `.git` metadata is repaired, later Search, Add, and automatic writeback in the same client session automatically use the restored Git repository scope.
 
-Require a readable active workspace binding. A CLI command from a linked worktree of the bound repository is valid. If `memorax-cli search` reports `workspace_scope_mismatch` or `workspace_scope_unavailable`, do not bypass the scope or fall back to an unscoped user id. Do not change the CLI working directory and retry. Tell the user that memory search was not executed and no request was sent to MemoraX, then present the CLI's `userAction` in natural language. Continue the current task using only live code and documentation.
+Require a readable active workspace binding. A CLI command from a linked worktree of the bound repository is valid. If `memorax-cli search` reports `workspace_scope_mismatch` or `workspace_scope_unavailable`, do not bypass the scope or fall back to an unscoped username. Do not change the CLI working directory and retry. Tell the user that memory search was not executed and no request was sent to MemoraX, then present the CLI's `userAction` in natural language. Continue the current task using only live code and documentation.
 
 If `memorax-cli` is not on `PATH`, or memory is disabled, unconfigured, or unavailable, report that briefly and continue with live code or documentation. Authenticate through MemoraX Code configuration; never recover credentials from shell history or place tokens in prompts. Treat injected memory as a hypothesis and verify it against the current checkout.
 
@@ -88,4 +88,6 @@ Do not apply this retry to `memorax-cli add`, authentication or configuration fa
 
 ## Output
 
+If a successful Search returns `quotaNotice`, or prints it as a quota-reminder line in the default CLI output, present the complete reminder once and prominently before the normal result summary. Do not reduce it to only a percentage or omit its account URL or conditional local Mark ID retrieval instructions. Never run `memorax-code account --show-mark-id` for the user, ask for its output, or reproduce a Mark ID in chat. Treat the reminder as user-facing operational output, not recalled memory, and continue the current task.
+
 Mention only an invariant, pitfall, convention, or validation idea that materially affects the answer. Ground claims about current implementation behavior in live code and checks.

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

@@ -1,6 +1,6 @@
 {
   "name": "memorax-code-codex-adapter",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "Codex adapter, memory skill, and local hooks for MemoraX Code.",
   "author": {
     "name": "MemoraX AI"

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

@@ -1,5 +1,5 @@
 {
   "version": 1,
-  "shellVersion": "0.1.5",
+  "shellVersion": "0.1.7",
   "runtimeAbi": 1
 }

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

@@ -1,6 +1,6 @@
 {
   "name": "@memorax-code/codex-adapter",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "private": true,
   "type": "module",
   "description": "Codex Hook and memory integration for MemoraX Code.",

package/lib/memorax-code-codex-adapter/runtime-hooks/memory-skill-reminder.mjs

@@ -53,6 +53,7 @@ try {
       requireTranscriptPath: true,
       runtime: "codex",
       supplementalReminderAfterCompact: true,
+      systemMessage: turnStartResult.userNotice,
     }, normalizedInput);
   }
 } catch (error) {
@@ -83,6 +84,7 @@ async function recordTurnStart(body) {
       recorded: true,
       additionalContext: stringValue(response?.additionalContext),
       repoMemoryWorktree: stringValue(response?.repoMemoryWorktree),
+      userNotice: stringValue(response?.userNotice),
     };
   } catch (error) {
     debugHookError(error);

package/lib/memorax-code-codex-adapter/skills/memorax-code/references/memorax-add.md

@@ -83,4 +83,6 @@ Do not add speculation, assistant-only praise, or a current instruction merely b
 
 ## Output
 
+If a successful Add returns `quotaNotice`, or prints it as a quota-reminder line in the default CLI output, present the complete reminder once and prominently before the normal result summary. Do not reduce it to only a percentage or omit its account URL or conditional local Mark ID retrieval instructions. Never run `memorax-code account --show-mark-id` for the user, ask for its output, or reproduce a Mark ID in chat. Treat the reminder as user-facing operational output, not coding memory content, and continue the current task.
+
 After an add request is accepted, confirm briefly that it was submitted for processing and identify the reusable coding lesson at a high level. If add is disabled or fails, report the issue and continue without bypassing the CLI.

package/lib/memorax-code-codex-adapter/skills/memorax-code/references/memorax-search.md

@@ -6,11 +6,11 @@ Use these instructions only to search reusable coding memory through `memorax-cl
 
 Run the CLI from the active task workspace. The installed Hook and session binding supply the authoritative workspace root; do not run `git rev-parse`, infer the root from Git metadata, or substitute an unrelated working directory. Do not make `memorax-cli status` a mandatory preflight; use it only to diagnose a configuration or scope failure.
 
-Coding memory uses `<MemoraX base user ID>@<normalized repository name>` for Git workspaces and the normalized folder name for genuine non-Git directories. MemoraX Code resolves `.git`, `gitdir`, and `commondir` without executing Git. Linked worktrees share one repository scope; another clone, repository, or non-Git directory retains a different local session key even when its readable name matches.
+Coding memory uses `<MemoraX base username>@<normalized repository name>` for Git workspaces and the normalized folder name for genuine non-Git directories. MemoraX Code resolves `.git`, `gitdir`, and `commondir` without executing Git. Linked worktrees share one repository scope; another clone, repository, or non-Git directory retains a different local session key even when its readable name matches.
 
 If a successful Search result reports `workspaceScopeFallbackReason: git_metadata_invalid`, malformed or incomplete metadata inside a direct `.git` directory was downgraded to the normalized local folder scope. Search has already run with the reported `effectiveUserId`. Present its `userNotice` once without pausing the current task or asking the user to repair Git first, then continue with the returned memory and live evidence. After the repository or `.git` metadata is repaired, later Search, Add, and automatic writeback in the same client session automatically use the restored Git repository scope.
 
-Require a readable active workspace binding. A CLI command from a linked worktree of the bound repository is valid. If `memorax-cli search` reports `workspace_scope_mismatch` or `workspace_scope_unavailable`, do not bypass the scope or fall back to an unscoped user id. Do not change the CLI working directory and retry. Tell the user that memory search was not executed and no request was sent to MemoraX, then present the CLI's `userAction` in natural language. Continue the current task using only live code and documentation.
+Require a readable active workspace binding. A CLI command from a linked worktree of the bound repository is valid. If `memorax-cli search` reports `workspace_scope_mismatch` or `workspace_scope_unavailable`, do not bypass the scope or fall back to an unscoped username. Do not change the CLI working directory and retry. Tell the user that memory search was not executed and no request was sent to MemoraX, then present the CLI's `userAction` in natural language. Continue the current task using only live code and documentation.
 
 If `memorax-cli` is not on `PATH`, or memory is disabled, unconfigured, or unavailable, report that briefly and continue with live code or documentation. Authenticate through MemoraX Code configuration; never recover credentials from shell history or place tokens in prompts. Treat injected memory as a hypothesis and verify it against the current checkout.
 
@@ -88,4 +88,6 @@ Do not apply this retry to `memorax-cli add`, authentication or configuration fa
 
 ## Output
 
+If a successful Search returns `quotaNotice`, or prints it as a quota-reminder line in the default CLI output, present the complete reminder once and prominently before the normal result summary. Do not reduce it to only a percentage or omit its account URL or conditional local Mark ID retrieval instructions. Never run `memorax-code account --show-mark-id` for the user, ask for its output, or reproduce a Mark ID in chat. Treat the reminder as user-facing operational output, not recalled memory, and continue the current task.
+
 Mention only an invariant, pitfall, convention, or validation idea that materially affects the answer. Ground claims about current implementation behavior in live code and checks.

package/lib/memorax-code-dsh-adapter/hooks/repo-memory-job.mjs

@@ -4,7 +4,10 @@ import { dirname, join, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import { runRepoMemoryJob } from "../memorax-code-adapter-common/src/repo-memory/repo-memory-job-supervisor.mjs";
 import { evaluateRepository } from "../memorax-code-adapter-common/src/repo-memory/repo-memory-update-policy-evaluator.mjs";
-import { requireEnabledDshRuntime } from "../src/runtime-state.mjs";
+import {
+  buildDshCommand,
+  requireEnabledDshRuntime,
+} from "../src/runtime-state.mjs";
 
 const ADAPTER_PACKAGE_NAME = "@memorax-code/dsh-memorax-code";
 const HEADLESS_BUNDLE_NAME = "@deepseek-ai/dsh-headless";
@@ -23,7 +26,7 @@ try {
     validatorPath: resolve(pluginRoot, "skills/memorax-code/scripts/validate_memory.py"),
     evaluateRepository,
     createCommand({ prompt }) {
-      return [runtime.dshCommand, "--profile", profile, prompt];
+      return buildDshCommand(runtime.dshCommand, ["--profile", profile, prompt]);
     },
   });
   process.stdout.write(`${JSON.stringify(payload)}\n`);

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

@@ -1,6 +1,6 @@
 {
   "name": "@memorax-code/dsh-memorax-code",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "private": true,
   "type": "module",
   "description": "DeepSeek Harness native memory adapter for MemoraX Code.",

package/lib/memorax-code-dsh-adapter/skills/memorax-code/references/memorax-add.md

@@ -83,4 +83,6 @@ Do not add speculation, assistant-only praise, or a current instruction merely b
 
 ## Output
 
+If a successful Add returns `quotaNotice`, or prints it as a quota-reminder line in the default CLI output, present the complete reminder once and prominently before the normal result summary. Do not reduce it to only a percentage or omit its account URL or conditional local Mark ID retrieval instructions. Never run `memorax-code account --show-mark-id` for the user, ask for its output, or reproduce a Mark ID in chat. Treat the reminder as user-facing operational output, not coding memory content, and continue the current task.
+
 After an add request is accepted, confirm briefly that it was submitted for processing and identify the reusable coding lesson at a high level. If add is disabled or fails, report the issue and continue without bypassing the CLI.

package/lib/memorax-code-dsh-adapter/skills/memorax-code/references/memorax-search.md

@@ -6,11 +6,11 @@ Use these instructions only to search reusable coding memory through `memorax-cl
 
 Run the CLI from the active task workspace. The installed Hook and session binding supply the authoritative workspace root; do not run `git rev-parse`, infer the root from Git metadata, or substitute an unrelated working directory. Do not make `memorax-cli status` a mandatory preflight; use it only to diagnose a configuration or scope failure.
 
-Coding memory uses `<MemoraX base user ID>@<normalized repository name>` for Git workspaces and the normalized folder name for genuine non-Git directories. MemoraX Code resolves `.git`, `gitdir`, and `commondir` without executing Git. Linked worktrees share one repository scope; another clone, repository, or non-Git directory retains a different local session key even when its readable name matches.
+Coding memory uses `<MemoraX base username>@<normalized repository name>` for Git workspaces and the normalized folder name for genuine non-Git directories. MemoraX Code resolves `.git`, `gitdir`, and `commondir` without executing Git. Linked worktrees share one repository scope; another clone, repository, or non-Git directory retains a different local session key even when its readable name matches.
 
 If a successful Search result reports `workspaceScopeFallbackReason: git_metadata_invalid`, malformed or incomplete metadata inside a direct `.git` directory was downgraded to the normalized local folder scope. Search has already run with the reported `effectiveUserId`. Present its `userNotice` once without pausing the current task or asking the user to repair Git first, then continue with the returned memory and live evidence. After the repository or `.git` metadata is repaired, later Search, Add, and automatic writeback in the same client session automatically use the restored Git repository scope.
 
-Require a readable active workspace binding. A CLI command from a linked worktree of the bound repository is valid. If `memorax-cli search` reports `workspace_scope_mismatch` or `workspace_scope_unavailable`, do not bypass the scope or fall back to an unscoped user id. Do not change the CLI working directory and retry. Tell the user that memory search was not executed and no request was sent to MemoraX, then present the CLI's `userAction` in natural language. Continue the current task using only live code and documentation.
+Require a readable active workspace binding. A CLI command from a linked worktree of the bound repository is valid. If `memorax-cli search` reports `workspace_scope_mismatch` or `workspace_scope_unavailable`, do not bypass the scope or fall back to an unscoped username. Do not change the CLI working directory and retry. Tell the user that memory search was not executed and no request was sent to MemoraX, then present the CLI's `userAction` in natural language. Continue the current task using only live code and documentation.
 
 If `memorax-cli` is not on `PATH`, or memory is disabled, unconfigured, or unavailable, report that briefly and continue with live code or documentation. Authenticate through MemoraX Code configuration; never recover credentials from shell history or place tokens in prompts. Treat injected memory as a hypothesis and verify it against the current checkout.
 
@@ -88,4 +88,6 @@ Do not apply this retry to `memorax-cli add`, authentication or configuration fa
 
 ## Output
 
+If a successful Search returns `quotaNotice`, or prints it as a quota-reminder line in the default CLI output, present the complete reminder once and prominently before the normal result summary. Do not reduce it to only a percentage or omit its account URL or conditional local Mark ID retrieval instructions. Never run `memorax-code account --show-mark-id` for the user, ask for its output, or reproduce a Mark ID in chat. Treat the reminder as user-facing operational output, not recalled memory, and continue the current task.
+
 Mention only an invariant, pitfall, convention, or validation idea that materially affects the answer. Ground claims about current implementation behavior in live code and checks.