feat(memory): project-scoped memory writes and .qwen/QWEN.local.md

packages/acp-bridge/src/status.ts

@@ -307,15 +307,17 @@ export interface ServeSessionSupportedCommandsStatus {
  * so the SDK reducer can render any of these with one pattern.
  */
 
-export type ServeContextFileScope = 'workspace' | 'global';
+export type ServeContextFileScope = 'workspace' | 'local' | 'global';
 
 export interface ServeWorkspaceMemoryFile {
   kind: 'memory_file';
   /** Absolute path to the discovered memory file. */
   path: string;
   /**
-   * 'workspace' for files under the bound workspace tree, 'global' for
-   * `~/.qwen/QWEN.md` style entries. Helps adapters render scope chips.
+   * 'workspace' for files under the bound workspace tree, 'local' for
+   * `.qwen/QWEN.local.md` (gitignored project-local instructions),
+   * 'global' for `~/.qwen/QWEN.md` style entries.
+   * Helps adapters render scope chips.
    */
   scope: ServeContextFileScope;
   /** Size in bytes of the file's serialized contents on disk. */

packages/cli/src/serve/workspaceMemory.ts

@@ -12,8 +12,11 @@ import {
   WorkspaceMemoryFileTooLargeError,
   WorkspaceMemoryWriteTimeoutError,
   getAllGeminiMdFilenames,
+  getLocalContextFilePath,
   writeWorkspaceContextFile,
+  type WriteContextFileScope,
 } from '@qwen-code/qwen-code-core';
+import { findProjectRoot } from '@qwen-code/qwen-code-core';
 import { writeStderrLine } from '../utils/stdioHelpers.js';
 import { isServeDebugMode } from './debugMode.js';
 import type { HttpAcpBridge } from './httpAcpBridge.js';
@@ -78,6 +81,13 @@ export interface WorkspaceMemoryRouteDeps {
 
 const MAX_MEMORY_CONTENT_BYTES = 1024 * 1024;
 
+const VALID_SCOPES: ReadonlySet<string> = new Set([
+  'workspace',
+  'global',
+  'local',
+  'auto',
+]);
+
 /** Mount the two memory routes on the supplied Express app. */
 export function mountWorkspaceMemoryRoutes(
   app: Application,
@@ -116,9 +126,9 @@ export function mountWorkspaceMemoryRoutes(
       const body = deps.safeBody(req);
 
       const scope = body['scope'];
-      if (scope !== 'workspace' && scope !== 'global') {
+      if (!VALID_SCOPES.has(scope as string)) {
         res.status(400).json({
-          error: '`scope` must be "workspace" or "global"',
+          error: `\`scope\` must be one of: ${[...VALID_SCOPES].map((s) => `"${s}"`).join(', ')}`,
           code: 'invalid_scope',
         });
         return;
@@ -183,7 +193,7 @@ export function mountWorkspaceMemoryRoutes(
 
       try {
         const result = await writeWorkspaceContextFile({
-          scope,
+          scope: scope as WriteContextFileScope,
           mode,
           content,
           projectRoot: deps.boundWorkspace,
@@ -204,7 +214,7 @@ export function mountWorkspaceMemoryRoutes(
           deps.bridge.publishWorkspaceEvent({
             type: 'memory_changed',
             data: {
-              scope,
+              scope: result.resolvedScope,
               filePath: result.filePath,
               mode,
               bytesWritten: result.bytesWritten,
@@ -337,6 +347,36 @@ async function collectWorkspaceMemoryStatus(
   );
   files.push(...workspaceFiles);
 
+  // Probe for .qwen/QWEN.local.md at the project root (git root, not
+  // necessarily the bound workspace). Uses findProjectRoot to match
+  // the discovery path in memoryDiscovery.ts — in a monorepo where
+  // the daemon is bound to a subdirectory, both must probe the same
+  // directory or writes will silently disappear from the prompt.
+  const resolvedWorkspace = path.resolve(boundWorkspace);
+  const foundProjectRoot = await findProjectRoot(resolvedWorkspace);
+  const effectiveRoot = foundProjectRoot ?? resolvedWorkspace;
+  const localPath = getLocalContextFilePath(effectiveRoot);
+  try {
+    const stat = await fs.stat(localPath);
+    if (stat.isFile()) {
+      files.push({
+        absolutePath: localPath,
+        scope: 'local',
+        bytes: stat.size,
+      });
+    }
+  } catch (err) {
+    if (!isEnoent(err)) {
+      errors.push({
+        kind: 'memory_file',
+        status: 'error',
+        error: err instanceof Error ? err.message : String(err),
+        errorKind: 'stat_failed',
+        hint: localPath,
+      });
+    }
+  }
+
   const globalDir = Storage.getGlobalQwenDir();
   for (const filename of filenames) {
     const candidate = path.join(globalDir, filename);

packages/core/src/memory/const.ts

@@ -4,10 +4,24 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 
+import * as path from 'node:path';
+import { QWEN_DIR } from '../utils/paths.js';
+
 export const DEFAULT_CONTEXT_FILENAME = 'QWEN.md';
 export const AGENT_CONTEXT_FILENAME = 'AGENTS.md';
+export const LOCAL_CONTEXT_FILENAME = 'QWEN.local.md';
 export const MEMORY_SECTION_HEADER = '## Qwen Added Memories';
 
+/**
+ * Returns the absolute path to `.qwen/QWEN.local.md` for a given
+ * project root. Centralized here so all call sites use a single
+ * source of truth — if the directory name or filename changes, only
+ * this function needs updating.
+ */
+export function getLocalContextFilePath(projectRoot: string): string {
+  return path.join(projectRoot, QWEN_DIR, LOCAL_CONTEXT_FILENAME);
+}
+
 // This variable will hold the currently configured filename for context files.
 // It defaults to include both QWEN.md and AGENTS.md but can be overridden by setGeminiMdFilename.
 // QWEN.md is first to maintain backward compatibility (used by /init command tool).