om-memory-system 4.8.0 → 4.10.0

package/dist/cli/web-command.js

@@ -123,7 +123,7 @@ export async function runWebCommand(args, options = {}, online, handover = {}) {
     process.once("SIGTERM", stop);
     // The page's Stop and Restart buttons reach the same process through this callback.
     const { createPowerAction } = await import("./web-power.js");
-    server.setOnPowerAction(createPowerAction({
+    const powerAction = createPowerAction({
         stopServer: async () => {
             clearInterval(keeper);
             process.off("SIGINT", stop);
@@ -140,7 +140,16 @@ export async function runWebCommand(args, options = {}, online, handover = {}) {
         baseUrl: server.getUrl(),
         loginItem: action === "--login-item",
         autostart: options,
-    }));
+    });
+    server.setOnPowerAction(powerAction);
+    // The update button installs the npm release and restarts onto it through the launcher.
+    const { startWebUpdate } = await import("../services/web-update-runtime.js");
+    const { launcherPath } = await import("../services/runtime-record.js");
+    const { ommsDir } = await import("../services/runtime-handoff.js");
+    const { existsSync } = await import("node:fs");
+    // Every restart onto the new copy runs the launcher, the login item's included.
+    const canRestart = () => existsSync(launcherPath(ommsDir()));
+    server.setWebUpdate(startWebUpdate(() => powerAction("update"), canRestart));
     // A newer `web install` asked this web app to give up the port.
     server.setOnStepAside(async () => {
         clearInterval(keeper);

package/dist/cli/web-power.d.ts

@@ -1,6 +1,8 @@
 import type { WebAutostartOptions } from "../services/web-autostart.js";
 /** The two choices the page offers; the web server passes them through unchanged. */
 export type PowerAction = "stop" | "restart";
+/** A restart through the launcher, so the newest copy on the machine serves after an update. */
+export type ProcessAction = PowerAction | "update";
 interface SpawnedChild {
     pid?: number;
     unref(): void;
@@ -16,6 +18,7 @@ export interface PowerDeps {
         stdio: "ignore";
         cwd: string;
         windowsHide: true;
+        env: NodeJS.ProcessEnv;
     }) => SpawnedChild;
     /** Restart the login item through the service manager. False when it cannot. */
     restartLoginItem: () => boolean | Promise<boolean>;
@@ -23,14 +26,29 @@ export interface PowerDeps {
     writeStartLock: (pid: number) => void | Promise<void>;
     /** Remove the start lock when it names `pid`. */
     removeStartLock: (pid: number) => void | Promise<void>;
-    /** True when an OMMS web app answers health at `baseUrl`. */
-    probe: (baseUrl: string) => Promise<boolean>;
+    /**
+     * The OMMS web app that answers at `baseUrl`, or null when none does. The
+     * version is null when this process may not read it, for example behind basic auth.
+     */
+    readOwner: (baseUrl: string) => Promise<{
+        instance: string;
+        version: string | null;
+    } | null>;
+    /** Ask the web app at `baseUrl` to step aside for `version`. True when it agrees. */
+    stepAside: (baseUrl: string, version: string) => Promise<boolean>;
+    /** The instance id the copy reports, so the handoff knows its own copy. */
+    newInstance: () => string;
+    /** The version on disk now; an in-place upgrade changes it after this process started. */
+    version: () => string;
+    env: NodeJS.ProcessEnv;
     sleep: (ms: number) => Promise<void>;
     now: () => number;
     exit: (code: number) => void;
     /** The runtime and arguments of this process, for a detached copy. */
     execPath: string;
     args: string[];
+    /** The launcher at `~/.omms/bin`, or null when it is missing. */
+    launcher: string | null;
     cwd: string;
     pid: number;
     log: (message: string, data: Record<string, unknown>) => void | Promise<void>;
@@ -51,5 +69,5 @@ export declare function createPowerAction(options: {
     loginItem: boolean;
     autostart?: WebAutostartOptions;
     deps?: Partial<PowerDeps>;
-}): (action: PowerAction) => Promise<void>;
+}): (action: ProcessAction) => Promise<string | undefined>;
 export {};

package/dist/cli/web-power.js

@@ -1,10 +1,24 @@
 import { spawn as nodeSpawn } from "node:child_process";
+import { randomUUID } from "node:crypto";
+import { existsSync } from "node:fs";
 import { homedir } from "node:os";
+import { packageVersion } from "../services/package-version.js";
+import { ommsDir } from "../services/runtime-handoff.js";
+import { launcherPath } from "../services/runtime-record.js";
+import { compareVersions } from "../services/version-compare.js";
 /** How long a fresh copy must stay up before the old process stops serving. */
 const SPAWN_CHECK_MS = 1_000;
 /** How long the old process waits for the copy to answer before it serves again. */
 export const HANDOFF_WAIT_MS = 15_000;
 const HANDOFF_POLL_MS = 250;
+let tokenHeader = null;
+/** The web app runs on this machine, so the local token file is enough. Read once. */
+function localTokenHeader() {
+    tokenHeader ??= import("../services/auth-token.js").then(({ AUTH_HEADER, getOrCreateAuthToken }) => ({
+        [AUTH_HEADER]: getOrCreateAuthToken(),
+    }));
+    return tokenHeader;
+}
 function productionDeps(options) {
     return {
         spawn: nodeSpawn,
@@ -14,23 +28,55 @@ function productionDeps(options) {
             nodeLockFs.replace(startLockPath(), JSON.stringify({ pid, at: Date.now() }));
         },
         removeStartLock: async (pid) => (await import("../services/web-ensure.js")).removeStartLockFor(pid),
-        probe: async (baseUrl) => {
+        readOwner: async (baseUrl) => {
+            // Health skips basic auth, so a restart can find its copy with basic auth on.
+            let instance;
+            try {
+                const health = await fetch(`${baseUrl}/api/health`, { signal: AbortSignal.timeout(1_000) });
+                const body = (await health.json());
+                if (!health.ok || typeof body.instance !== "string")
+                    return null;
+                instance = body.instance;
+            }
+            catch {
+                return null;
+            }
             try {
-                const response = await fetch(`${baseUrl}/api/health`, {
+                const response = await fetch(`${baseUrl}/api/web/status`, {
+                    headers: await localTokenHeader(),
                     signal: AbortSignal.timeout(1_000),
                 });
                 const body = (await response.json());
-                return response.ok && body.success === true && body.status === "ok";
+                const version = response.ok && typeof body.version === "string" ? body.version : null;
+                return { instance, version };
+            }
+            catch {
+                return { instance, version: null };
+            }
+        },
+        stepAside: async (baseUrl, version) => {
+            try {
+                const response = await fetch(`${baseUrl}/api/web/step-aside`, {
+                    method: "POST",
+                    headers: { ...(await localTokenHeader()), "content-type": "application/json" },
+                    body: JSON.stringify({ version }),
+                    signal: AbortSignal.timeout(1_000),
+                });
+                return response.status === 202;
             }
             catch {
                 return false;
             }
         },
+        newInstance: () => randomUUID(),
+        version: () => packageVersion(),
+        env: process.env,
         sleep: (ms) => new Promise((resolve) => setTimeout(resolve, ms)),
         now: () => Date.now(),
         exit: (code) => process.exit(code),
         execPath: process.execPath,
         args: process.argv.slice(1),
+        launcher: existsSync(launcherPath(ommsDir())) ? launcherPath(ommsDir()) : null,
         cwd: homedir(),
         pid: process.pid,
         log: async (message, data) => (await import("../services/logger.js")).log(message, data),
@@ -49,14 +95,16 @@ export function createPowerAction(options) {
     const logFailure = (code) => Promise.resolve(deps.log("Web app restart failed", { code })).catch(() => undefined);
     let stopped = false;
     /** Start the copy, check it, stop serving, and wait until the copy answers. */
-    async function handOff() {
+    async function handOff(args) {
         let child;
+        const instance = deps.newInstance();
         try {
-            child = deps.spawn(deps.execPath, deps.args, {
+            child = deps.spawn(deps.execPath, args, {
                 detached: true,
                 stdio: "ignore",
                 cwd: deps.cwd,
                 windowsHide: true,
+                env: { ...deps.env, OMMS_WEB_INSTANCE: instance },
             });
         }
         catch {
@@ -82,12 +130,30 @@ export function createPowerAction(options) {
             stopped = true;
         }
         // The copy waits as a non-owner and takes the port within about 7 seconds.
-        const began = deps.now();
+        let began = deps.now();
+        // Each older owner is asked once; another older waiter can take the port after it.
+        const askedAside = new Set();
         while (deps.now() - began < HANDOFF_WAIT_MS) {
             if (exited)
                 return giveUp("copy-exit", copyPid);
-            if (await deps.probe(options.baseUrl))
-                return deps.exit(0);
+            const owner = await deps.readOwner(options.baseUrl);
+            if (owner?.instance === instance) {
+                deps.exit(0);
+                return undefined;
+            }
+            // Another web app that waited for the port took it first.
+            if (owner) {
+                const ownVersion = deps.version();
+                const order = owner.version === null ? null : compareVersions(owner.version, ownVersion);
+                if (order === null || order >= 0)
+                    return yieldTo(child, copyPid);
+                if (!askedAside.has(owner.instance)) {
+                    askedAside.add(owner.instance);
+                    // The copy needs a fresh wait once the older web app leaves.
+                    if (await deps.stepAside(options.baseUrl, ownVersion))
+                        began = deps.now();
+                }
+            }
             await deps.sleep(HANDOFF_POLL_MS);
         }
         if (exited)
@@ -96,7 +162,15 @@ export function createPowerAction(options) {
         child.kill("SIGTERM");
         return giveUp("handoff", copyPid);
     }
-    /** Keep or resume serving on the old process, and release the lock it wrote. */
+    /** A web app of the same or a newer version serves, so the copy would only wait. */
+    async function yieldTo(child, copyPid) {
+        child.kill("SIGTERM");
+        await deps.removeStartLock(copyPid);
+        await logFailure("other-owner");
+        deps.exit(0);
+        return undefined;
+    }
+    /** Keep or resume serving on the old process, and release the lock it wrote. Returns the code. */
     async function giveUp(code, copyPid) {
         if (copyPid !== undefined)
             await deps.removeStartLock(copyPid);
@@ -104,7 +178,7 @@ export function createPowerAction(options) {
             await deps.removeStartLock(deps.pid);
         await logFailure(code);
         if (!stopped)
-            return;
+            return code;
         try {
             await options.resumeServer();
             stopped = false;
@@ -113,29 +187,39 @@ export function createPowerAction(options) {
             await logFailure(error instanceof Error ? error.name : "resume-error");
             deps.exit(1);
         }
+        return code;
     }
     return async (action) => {
         if (action === "stop") {
             await options.stopServer();
             deps.exit(0);
-            return;
+            return undefined;
+        }
+        // After an update the copy of this process is the old version; the launcher picks the newest.
+        if (action === "update" && !deps.launcher) {
+            await logFailure("no-launcher");
+            return "no-launcher";
         }
+        const args = action === "update" ? [deps.launcher, "web"] : deps.args;
         stopped = false;
         try {
             if (options.loginItem) {
+                // The login item runs the launcher, so the service manager restart covers an update too.
                 await options.stopServer();
                 stopped = true;
-                if (await deps.restartLoginItem())
-                    return deps.exit(0);
+                if (await deps.restartLoginItem()) {
+                    deps.exit(0);
+                    return undefined;
+                }
             }
             else {
                 // Hold other hosts off until the copy owns the port.
                 await deps.writeStartLock(deps.pid);
             }
-            await handOff();
+            return await handOff(args);
         }
         catch (error) {
-            await giveUp(error instanceof Error ? error.name : "unknown");
+            return giveUp(error instanceof Error ? error.name : "unknown");
         }
     };
 }

package/dist/config.d.ts

@@ -54,6 +54,8 @@ interface OmmsConfig {
         from: string;
         to: string;
     }>;
+    /** Unresolved directories the Directory maps page hides. Display only. Global config only. */
+    importIgnoredDirectories?: string[];
     /** Claude Code's folder (its transcripts are in `<folder>/projects`). Empty means `CLAUDE_CONFIG_DIR`, then `~/.claude`. Global config only. */
     claudeConfigDir?: string;
     webServerAutoStart?: boolean;
@@ -104,7 +106,7 @@ interface OmmsConfig {
         injectOn?: "first" | "always";
     };
 }
-export declare const CONFIG_TEMPLATE = "{\n  // ============================================\n  // omms (Opinionated Modular Memory System) Configuration\n  // ============================================\n  \n  // Storage location for the vector database. Leave unset to use the\n  // default ~/.omms/data (a legacy ~/.opencode-mem/data store is migrated\n  // there automatically on first start; see docs/omms-migration.md).\n  // \"storagePath\": \"~/.omms/data\",\n\n  \"userEmailOverride\": \"\",\n  \"userNameOverride\": \"\",\n  \n  // ============================================\n  // Embedding Model (for similarity search)\n  // ============================================\n  // Local = Hugging Face / ONNX via @huggingface/transformers (not Apple MLX).\n  // Remote = set embeddingApiUrl (OpenAI-compatible /embeddings); embeddingApiKey is optional.\n  \n  // Default: Nomic Embed v1 (768 dimensions, 8192 context, multilingual)\n  \"embeddingModel\": \"Xenova/nomic-embed-text-v1\",\n\n  // Opt-in Nomic task prefixes (search_document: / search_query:). After enabling,\n  // re-index existing memories so store and query vectors stay aligned.\n  // \"embeddingUseTaskPrefixes\": true,\n  \n  // Auto-detected dimensions (no need to set manually)\n  // \"embeddingDimensions\": 768,\n  \n  // Other recommended local models:\n  // \"embeddingModel\": \"Xenova/jina-embeddings-v2-base-en\",  // 768 dims, English-only, 8192 context\n  // \"embeddingModel\": \"Xenova/jina-embeddings-v2-small-en\", // 512 dims, faster, 8192 context\n  // \"embeddingModel\": \"Xenova/all-MiniLM-L6-v2\",            // 384 dims, very fast, 512 context\n  // \"embeddingModel\": \"Xenova/all-mpnet-base-v2\",           // 768 dims, good quality, 512 context\n  \n  // Optional: OpenAI-compatible API for embeddings (URL required; key only if the server needs one)\n  // \"embeddingApiUrl\": \"https://api.openai.com/v1\",\n  // \"embeddingApiKey\": \"env://OPENAI_API_KEY\",  // or \"sk-...\" / \"file:///path/to/key\"\n  // \"embeddingModel\": \"text-embedding-3-small\",  // 1536 dims, auto-detected\n \n  // ============================================\n  // Web Server Settings\n  // ============================================\n  \n  // Start a background import of past chats on each host's next start.\n  \"autoBackfill\": true,\n  // \"piBackfillModel\": \"inherit\", // or \"external\", or \"provider/model\"\n  // \"opencodeBackfillModel\": \"inherit\", // or \"external\", or \"provider/model\"\n  // Directory maps for history recorded in moved or deleted directories.\n  // \"importPathMaps\": [{ \"from\": \"~/code/app-feat-x\", \"to\": \"~/code/app\" }],\n  // Claude Code's folder, when it is not ~/.claude (like CLAUDE_CONFIG_DIR).\n  // \"claudeConfigDir\": \"~/.claude-work\",\n\n  // Register the web app to start when you log in.\n  \"webServerAutoStart\": true,\n  // Enable web UI for managing memories (accessible at http://localhost:4747)\n  \"webServerEnabled\": true,\n  \n  // Port for web UI server\n  \"webServerPort\": 4747,\n  \n  // Host address for web UI (use 127.0.0.1 for local only, 0.0.0.0 for network access)\n  \"webServerHost\": \"127.0.0.1\",\n\n  // Optional HTTP Basic Auth for the web UI. Accepts literal, env://, or file:// secrets.\n  // \"webServerAuthPassword\": \"\",\n  // \"webServerAuthUsername\": \"\",\n\n  // Deprecated: imported once into the API token table, then no longer read.\n  // Create API tokens on the Settings page (Keys and access) instead.\n  // \"webServerApiToken\": \"env://OMMS_WEB_TOKEN\",\n  \n  // ============================================\n  // Database Settings\n  // ============================================\n  \n  // Maximum vectors per database shard (auto-creates new shard when limit reached)\n  \"maxVectorsPerShard\": 50000,\n  \n  // Automatically delete old memories based on retention period\n  \"autoCleanupEnabled\": true,\n  \n  // Days to keep memories before auto-cleanup (only if autoCleanupEnabled is true)\n  \"autoCleanupRetentionDays\": 30,\n  \n  // Automatically detect and remove duplicate memories\n  \"deduplicationEnabled\": true,\n  \n   // Similarity threshold (0-1) for detecting duplicates (higher = stricter)\n   \"deduplicationSimilarityThreshold\": 0.90,\n   \n  // ============================================\n  // Memory Scope Settings\n  // ============================================\n\n  // Default scope for memory list/search queries\n  // \"project\" keeps queries within the current project, \"all-projects\" searches across all project shards\n  \"memory\": {\n    \"defaultScope\": \"project\"\n  },\n\n  // ============================================\n  // Model for auto-capture and profile learning (same rule in OpenCode and Pi)\n  // ============================================\n\n   // Which model summarises your work, in this order:\n   //   1. The host model below: opencodeProvider/opencodeModel in OpenCode,\n   //      piProvider/piModel in Pi. Set the model to \"inherit\" to follow\n   //      whatever model the session is using, or to \"external\" to send\n   //      every call to the external API below.\n   //   2. If no host model is set: the external API (memoryModel/memoryApiUrl/\n   //      memoryApiKey further down).\n   //   3. If neither is set: the session's own model.\n   // If the host model fails and the external API is configured, the external\n   // API is used instead.\n   //\n   // Host models go through OpenCode's or Pi's own sign-in (OAuth like Claude\n   // Pro/Max, GitHub Copilot, ChatGPT, or your own key there), so no separate API\n   // key is needed here.\n   //\n   // Examples (OpenCode names from 'opencode providers list'; Pi names from its model list):\n   //   \"opencodeProvider\": \"anthropic\",    \"opencodeModel\": \"claude-haiku-4-5-20251001\"\n   //   \"opencodeProvider\": \"openai\",       \"opencodeModel\": \"inherit\"\n   //   \"piProvider\": \"openai-codex\",       \"piModel\": \"gpt-5.6-luna\"\n   //\n   // \"opencodeProvider\": \"anthropic\",\n   // \"opencodeModel\": \"claude-haiku-4-5-20251001\",\n   // \"piProvider\": \"openai-codex\",\n   // \"piModel\": \"gpt-5.6-luna\",\n\n   // ============================================\n   // Auto-Capture Settings\n   // ============================================\n  \n  // Auto-capture runs in the background without blocking your main session.\n  // Note: Ollama may not support tool calling. Use OpenAI, Anthropic, or Groq for best results.\n  \n  \"autoCaptureEnabled\": true,\n  \n  // Provider type: \"openai-chat\" | \"openai-responses\" | \"anthropic\" | \"minimax\" | \"orcarouter\" | \"google-gemini\"\n  // Note: \"openai-chat\" is a generic OpenAI API-compatible mode.\n  // Any service that follows the OpenAI Chat Completions API can use it via custom \"memoryApiUrl\".\n  \"memoryProvider\": \"openai-chat\",\n  \n  // External API (step 2 above, and the fallback when a host model fails).\n  // Uncomment all 3 lines and replace memoryApiKey before use:\n  // \"memoryModel\": \"gpt-4o-mini\",\n  // \"memoryApiUrl\": \"https://api.openai.com/v1\",\n  // \"memoryApiKey\": \"sk-...\",\n\n  // API Key Formats:\n  // Direct value:        \"sk-...\"\n  // From file:           \"file://~/.config/litellm-key.txt\"\n  // From env variable:   \"env://LITELLM_API_KEY\"\n  \n  // Examples for different providers:\n  // Any OpenAI-compatible endpoint can use the \"openai-chat\" provider pattern below.\n  // Common examples: DeepSeek, Qwen (via Alibaba Cloud ModelStudio),\n  // Zhipu GLM (BigModel platform), and Kimi (Moonshot AI platform).\n\n  // OpenAI Chat Completion (default, backward compatible):\n  //   \"memoryProvider\": \"openai-chat\"\n  //   \"memoryModel\": \"gpt-4o-mini\"\n  //   \"memoryApiUrl\": \"https://api.openai.com/v1\"\n  //   \"memoryApiKey\": \"sk-...\"\n\n  // DeepSeek (OpenAI-compatible example):\n  //   \"memoryProvider\": \"openai-chat\"\n  //   \"memoryModel\": \"deepseek-chat\"\n  //   \"memoryApiUrl\": \"https://api.deepseek.com/v1\"\n  //   \"memoryApiKey\": \"sk-...\"\n  \n  // OpenAI Responses API (recommended, with session support):\n  //   \"memoryProvider\": \"openai-responses\"\n  //   \"memoryModel\": \"gpt-4o\"\n  //   \"memoryApiUrl\": \"https://api.openai.com/v1\"\n  //   \"memoryApiKey\": \"sk-...\"\n  \n  // Anthropic (with session support):\n  //   \"memoryProvider\": \"anthropic\"\n  //   \"memoryModel\": \"claude-3-5-haiku-20241022\"\n  //   \"memoryApiUrl\": \"https://api.anthropic.com/v1\"\n  //   \"memoryApiKey\": \"sk-ant-...\"\n\n  // MiniMax (Anthropic Messages-compatible endpoint, with session support):\n  //   \"memoryProvider\": \"minimax\"\n  //   \"memoryModel\": \"MiniMax-M3\"\n  //   \"memoryApiUrl\": \"https://api.minimax.io\"        // global endpoint\n  //   \"memoryApiKey\": \"<MiniMax API key>\"\n  //   // China endpoint: \"memoryApiUrl\": \"https://api.minimaxi.com\"\n  //   // Optional adaptive thinking for MiniMax-M3:\n  //   \"memoryExtraParams\": { \"thinking\": { \"type\": \"adaptive\" } }\n\n  // OrcaRouter (OpenAI-compatible gateway, namespaced model IDs, with session support):\n  //   \"memoryProvider\": \"orcarouter\"\n  //   \"memoryApiKey\": \"<OrcaRouter API key>\"\n  //   // memoryApiUrl and memoryModel are optional \u2014 they default to\n  //   // https://api.orcarouter.ai/v1 and \"orcarouter/auto\" (a routing alias).\n  //   // OrcaRouter rejects bare model names, so if you set memoryModel, use a\n  //   // namespaced ID such as \"openai/gpt-5.5\" or \"deepseek/deepseek-v4-flash\".\n  //   \"memoryModel\": \"openai/gpt-5.5\"\n\n  // Groq (OpenAI-compatible, use openai-chat provider):\n  //   \"memoryProvider\": \"openai-chat\"\n  //   \"memoryModel\": \"llama-3.3-70b-versatile\"\n  //   \"memoryApiUrl\": \"https://api.groq.com/openai/v1\"\n  //   \"memoryApiKey\": \"gsk_...\"\n  \n  // Maximum iterations for multi-turn AI analysis (for openai-responses, anthropic, and minimax)\n  \"autoCaptureMaxIterations\": 5,\n   \n  // Timeout per iteration in milliseconds (30 seconds default)\n  \"autoCaptureIterationTimeout\": 30000,\n\n  // Tries for one turn's capture, on Pi and OpenCode, 2 and 4 seconds apart. After the\n  // last one fails, a turn the model could not reach goes to the capture retry queue.\n  \"autoCaptureMaxRetries\": 3,\n\n  // Maximum UTF-8 bytes for the auto-capture markdown context sent to the summary model.\n  // Prevents HTTP 400 context overflows on models with ~131K token windows (e.g. Groq Llama).\n  // Rough guide: tokens \u2248 bytes / 4 for mixed code/prose.\n  \"autoCaptureMaxContextBytes\": 131072,\n   \n  // Days to keep AI session history before cleanup\n  \"aiSessionRetentionDays\": 7,\n\n  // Capture diagnostics: every capture attempt always writes one metadata line\n  // (model, stop reason, sizes, outcome) to ~/.omms/omms.log, with no\n  // conversation text. Set captureTrace to true to also write each attempt's\n  // prompt and raw reply to ~/.omms/traces/ for debugging. Traces can contain\n  // conversation content: <private> text and common API key formats are\n  // redacted, files are readable only by you, and they are deleted after\n  // captureTraceRetentionDays. Only this global file can turn tracing on.\n  // \"captureTrace\": false,\n  // \"captureTraceRetentionDays\": 7,\n  // \"captureAttemptRetentionDays\": 30,\n\n  // Capture retry queue: when a live capture fails because the model cannot be\n  // reached (network error, timeout, HTTP 408, 429 or 5xx), OMMS keeps a copy of\n  // the turn in ~/.omms/data and tries it again later. The copy has <private>\n  // text and common API key formats removed. Turns are deleted when the retry\n  // ends or after captureRetryRetentionHours (0 to 720). 0 turns the queue off.\n  // Only this global file can set it.\n  // \"captureRetryRetentionHours\": 72,\n\n  // Temperature for AI API requests (set to false to omit parameter for models that don't support it)\n  // Some reasoning models (like o1, o3, gpt-5) don't support temperature parameter\n  // Set to false and add \"memoryTemperature\": false in config when using such models\n  \"memoryTemperature\": 0.3,\n\n  // Extra parameters to include in API request body\n  // Useful for local inference servers (e.g. llama-server with --jinja) that support\n  // additional parameters like disabling thinking/reasoning mode\n  // Example for Qwen3 models: { \"enable_thinking\": false }\n  // \"memoryExtraParams\": {},\n\n  // Language for auto-capture summaries (default: \"auto\" for auto-detection)\n  // Options: \"auto\", \"en\", \"id\", \"zh\", \"ja\", \"es\", \"fr\", \"de\", \"ru\", \"pt\", \"ar\", \"ko\"\n  // \"autoCaptureLanguage\": \"auto\",\n\n  // ============================================\n  // Toast Notifications\n  // ============================================\n\n  // Show toast when memory is auto-captured\n  \"showAutoCaptureToasts\": true,\n\n  // Show toast when user profile is updated\n  \"showUserProfileToasts\": true,\n\n  // Show toast for error messages\n  \"showErrorToasts\": true,\n\n  // ============================================\n  // User Profile System\n  // ============================================\n\n  // Analyze user prompts every N prompts to build/update your user profile\n  // When N uncaptured prompts accumulate, AI will analyze them to identify:\n  // - User preferences (code style, communication style, tool preferences)\n  // - User patterns (recurring topics, problem domains, technical interests)\n  // - User workflows (development habits, sequences, learning style)\n  // - Skill level (overall and per-domain assessment)\n  \"userProfileAnalysisInterval\": 10,\n\n  // Days before inactive items (all types) are eligible for removal\n  \"userProfileStaleDays\": 2,\n\n  // Number of preferences shown in UI\n  \"userProfileDisplayPreferences\": 20,\n  \n  // Number of patterns shown in UI\n  \"userProfileDisplayPatterns\": 15,\n  \n  // Number of workflows shown in UI\n  \"userProfileDisplayWorkflows\": 10,\n  \n  // Number of preferences injected into LLM conversation context\n  // Keep this small \u2014 the strongest signals are enough; more dilute LLM attention\n  \"userProfileInjectPreferences\": 5,\n  \n  // Number of patterns injected into LLM conversation context\n  \"userProfileInjectPatterns\": 5,\n  \n  // Number of workflows injected into LLM conversation context\n  \"userProfileInjectWorkflows\": 3,\n  \n  // Days before preference confidence starts to decay (if not reinforced)\n  // Preferences that aren't seen again will gradually lose confidence and be removed\n  \"userProfileConfidenceDecayDays\": 30,\n  \n  // Number of profile versions to keep in changelog (for rollback/debugging)\n  // Older versions are automatically cleaned up\n  \"userProfileChangelogRetentionCount\": 5,\n\n  // Minimum evidence count for a preference/pattern to survive confidence decay\n  // Items confirmed fewer times are more likely to be pruned when confidence decays\n  \"userProfileMinEvidenceForRetention\": 3,\n\n  // Periodically merge duplicate or irrelevant profile items with the configured AI provider\n  \"userProfileAutoCleanupEnabled\": true,\n  // Number of analyzed user prompts between automatic AI cleanup runs\n  \"userProfileAutoCleanupInterval\": 100,\n\n  // Enable LLM validation of existing preferences against recent behavior.\n  // When enabled, each analysis round checks if top-5 preferences still match recent prompts.\n  // Experimental \u2014 disabled by default.\n  \"userProfileValidationEnabled\": false,\n\n  // ============================================\n  // Search Settings\n  // ============================================\n  \n  // Minimum similarity score (0-1) for memory search results\n  \"similarityThreshold\": 0.6,\n\n  // Maximum number of memories to return in search results.\n  // Manual searches can ask for fewer; prompt retrieval uses this ceiling.\n  \"maxMemories\": 10,\n\n  // ============================================\n  // Memory Context Controls\n  // ============================================\n\n  // Recent memories added at fresh session start (OpenCode V1 and Claude Code).\n  // Pi and OpenCode V2 search the store with each prompt instead.\n  \"chatMessage\": {\n    \"enabled\": true,\n    // Recent memories injected at session start.\n    \"maxMemories\": 3,\n    \"excludeCurrentSession\": true,\n    // When to inject: \"first\" message of a session or \"always\".\n    // \"injectOn\": \"first\",\n  },\n\n  // OpenCode profile-learning input limit, in UTF-8 bytes. Smaller values can\n  // omit prompts from that input. Does not limit Pi or Claude Code profile input.\n  \"userProfileMaxContextBytes\": 32768,\n\n  // Shared budget for automatic memory context (profile text, memories, and\n  // formatting) across all hosts, in approximate tokens: ceil(UTF-8 bytes / 4).\n  // Covers prompt retrieval, recent-memory injection, and session-memory\n  // restoration. Not an exact provider token limit or a spending limit.\n  \"retrievalMaxTokens\": 2000,\n\n  // ============================================\n  // Advanced Settings\n  // ============================================\n  \n  // Inject user profile into AI context (preferences, patterns, workflows)\n  \"injectProfile\": true\n}\n";
+export declare const CONFIG_TEMPLATE = "{\n  // ============================================\n  // omms (Opinionated Modular Memory System) Configuration\n  // ============================================\n  \n  // Storage location for the vector database. Leave unset to use the\n  // default ~/.omms/data (a legacy ~/.opencode-mem/data store is migrated\n  // there automatically on first start; see docs/omms-migration.md).\n  // \"storagePath\": \"~/.omms/data\",\n\n  \"userEmailOverride\": \"\",\n  \"userNameOverride\": \"\",\n  \n  // ============================================\n  // Embedding Model (for similarity search)\n  // ============================================\n  // Local = Hugging Face / ONNX via @huggingface/transformers (not Apple MLX).\n  // Remote = set embeddingApiUrl (OpenAI-compatible /embeddings); embeddingApiKey is optional.\n  \n  // Default: Nomic Embed v1 (768 dimensions, 8192 context, multilingual)\n  \"embeddingModel\": \"Xenova/nomic-embed-text-v1\",\n\n  // Opt-in Nomic task prefixes (search_document: / search_query:). After enabling,\n  // re-index existing memories so store and query vectors stay aligned.\n  // \"embeddingUseTaskPrefixes\": true,\n  \n  // Auto-detected dimensions (no need to set manually)\n  // \"embeddingDimensions\": 768,\n  \n  // Other recommended local models:\n  // \"embeddingModel\": \"Xenova/jina-embeddings-v2-base-en\",  // 768 dims, English-only, 8192 context\n  // \"embeddingModel\": \"Xenova/jina-embeddings-v2-small-en\", // 512 dims, faster, 8192 context\n  // \"embeddingModel\": \"Xenova/all-MiniLM-L6-v2\",            // 384 dims, very fast, 512 context\n  // \"embeddingModel\": \"Xenova/all-mpnet-base-v2\",           // 768 dims, good quality, 512 context\n  \n  // Optional: OpenAI-compatible API for embeddings (URL required; key only if the server needs one)\n  // \"embeddingApiUrl\": \"https://api.openai.com/v1\",\n  // \"embeddingApiKey\": \"env://OPENAI_API_KEY\",  // or \"sk-...\" / \"file:///path/to/key\"\n  // \"embeddingModel\": \"text-embedding-3-small\",  // 1536 dims, auto-detected\n \n  // ============================================\n  // Web Server Settings\n  // ============================================\n  \n  // Start a background import of past chats on each host's next start.\n  \"autoBackfill\": true,\n  // \"piBackfillModel\": \"inherit\", // or \"external\", or \"provider/model\"\n  // \"opencodeBackfillModel\": \"inherit\", // or \"external\", or \"provider/model\"\n  // Directory maps for history recorded in moved or deleted directories.\n  // \"importPathMaps\": [{ \"from\": \"~/code/app-feat-x\", \"to\": \"~/code/app\" }],\n  // Unresolved directories to hide on the Directory maps page. They stay unimported.\n  // \"importIgnoredDirectories\": [\"/private/tmp/scratch\"],\n  // Claude Code's folder, when it is not ~/.claude (like CLAUDE_CONFIG_DIR).\n  // \"claudeConfigDir\": \"~/.claude-work\",\n\n  // Register the web app to start when you log in.\n  \"webServerAutoStart\": true,\n  // Enable web UI for managing memories (accessible at http://localhost:4747)\n  \"webServerEnabled\": true,\n  \n  // Port for web UI server\n  \"webServerPort\": 4747,\n  \n  // Host address for web UI (use 127.0.0.1 for local only, 0.0.0.0 for network access)\n  \"webServerHost\": \"127.0.0.1\",\n\n  // Optional HTTP Basic Auth for the web UI. Accepts literal, env://, or file:// secrets.\n  // \"webServerAuthPassword\": \"\",\n  // \"webServerAuthUsername\": \"\",\n\n  // Deprecated: imported once into the API token table, then no longer read.\n  // Create API tokens on the Settings page (Keys and access) instead.\n  // \"webServerApiToken\": \"env://OMMS_WEB_TOKEN\",\n  \n  // ============================================\n  // Database Settings\n  // ============================================\n  \n  // Maximum vectors per database shard (auto-creates new shard when limit reached)\n  \"maxVectorsPerShard\": 50000,\n  \n  // Automatically delete old memories based on retention period\n  \"autoCleanupEnabled\": true,\n  \n  // Days to keep memories before auto-cleanup (only if autoCleanupEnabled is true)\n  \"autoCleanupRetentionDays\": 30,\n  \n  // Automatically detect and remove duplicate memories\n  \"deduplicationEnabled\": true,\n  \n   // Similarity threshold (0-1) for detecting duplicates (higher = stricter)\n   \"deduplicationSimilarityThreshold\": 0.90,\n   \n  // ============================================\n  // Memory Scope Settings\n  // ============================================\n\n  // Default scope for memory list/search queries\n  // \"project\" keeps queries within the current project, \"all-projects\" searches across all project shards\n  \"memory\": {\n    \"defaultScope\": \"project\"\n  },\n\n  // ============================================\n  // Model for auto-capture and profile learning (same rule in OpenCode and Pi)\n  // ============================================\n\n   // Which model summarises your work, in this order:\n   //   1. The host model below: opencodeProvider/opencodeModel in OpenCode,\n   //      piProvider/piModel in Pi. Set the model to \"inherit\" to follow\n   //      whatever model the session is using, or to \"external\" to send\n   //      every call to the external API below.\n   //   2. If no host model is set: the external API (memoryModel/memoryApiUrl/\n   //      memoryApiKey further down).\n   //   3. If neither is set: the session's own model.\n   // If the host model fails and the external API is configured, the external\n   // API is used instead.\n   //\n   // Host models go through OpenCode's or Pi's own sign-in (OAuth like Claude\n   // Pro/Max, GitHub Copilot, ChatGPT, or your own key there), so no separate API\n   // key is needed here.\n   //\n   // Examples (OpenCode names from 'opencode providers list'; Pi names from its model list):\n   //   \"opencodeProvider\": \"anthropic\",    \"opencodeModel\": \"claude-haiku-4-5-20251001\"\n   //   \"opencodeProvider\": \"openai\",       \"opencodeModel\": \"inherit\"\n   //   \"piProvider\": \"openai-codex\",       \"piModel\": \"gpt-5.6-luna\"\n   //\n   // \"opencodeProvider\": \"anthropic\",\n   // \"opencodeModel\": \"claude-haiku-4-5-20251001\",\n   // \"piProvider\": \"openai-codex\",\n   // \"piModel\": \"gpt-5.6-luna\",\n\n   // ============================================\n   // Auto-Capture Settings\n   // ============================================\n  \n  // Auto-capture runs in the background without blocking your main session.\n  // Note: Ollama may not support tool calling. Use OpenAI, Anthropic, or Groq for best results.\n  \n  \"autoCaptureEnabled\": true,\n  \n  // Provider type: \"openai-chat\" | \"openai-responses\" | \"anthropic\" | \"minimax\" | \"orcarouter\" | \"google-gemini\"\n  // Note: \"openai-chat\" is a generic OpenAI API-compatible mode.\n  // Any service that follows the OpenAI Chat Completions API can use it via custom \"memoryApiUrl\".\n  \"memoryProvider\": \"openai-chat\",\n  \n  // External API (step 2 above, and the fallback when a host model fails).\n  // Uncomment all 3 lines and replace memoryApiKey before use:\n  // \"memoryModel\": \"gpt-4o-mini\",\n  // \"memoryApiUrl\": \"https://api.openai.com/v1\",\n  // \"memoryApiKey\": \"sk-...\",\n\n  // API Key Formats:\n  // Direct value:        \"sk-...\"\n  // From file:           \"file://~/.config/litellm-key.txt\"\n  // From env variable:   \"env://LITELLM_API_KEY\"\n  \n  // Examples for different providers:\n  // Any OpenAI-compatible endpoint can use the \"openai-chat\" provider pattern below.\n  // Common examples: DeepSeek, Qwen (via Alibaba Cloud ModelStudio),\n  // Zhipu GLM (BigModel platform), and Kimi (Moonshot AI platform).\n\n  // OpenAI Chat Completion (default, backward compatible):\n  //   \"memoryProvider\": \"openai-chat\"\n  //   \"memoryModel\": \"gpt-4o-mini\"\n  //   \"memoryApiUrl\": \"https://api.openai.com/v1\"\n  //   \"memoryApiKey\": \"sk-...\"\n\n  // DeepSeek (OpenAI-compatible example):\n  //   \"memoryProvider\": \"openai-chat\"\n  //   \"memoryModel\": \"deepseek-chat\"\n  //   \"memoryApiUrl\": \"https://api.deepseek.com/v1\"\n  //   \"memoryApiKey\": \"sk-...\"\n  \n  // OpenAI Responses API (recommended, with session support):\n  //   \"memoryProvider\": \"openai-responses\"\n  //   \"memoryModel\": \"gpt-4o\"\n  //   \"memoryApiUrl\": \"https://api.openai.com/v1\"\n  //   \"memoryApiKey\": \"sk-...\"\n  \n  // Anthropic (with session support):\n  //   \"memoryProvider\": \"anthropic\"\n  //   \"memoryModel\": \"claude-3-5-haiku-20241022\"\n  //   \"memoryApiUrl\": \"https://api.anthropic.com/v1\"\n  //   \"memoryApiKey\": \"sk-ant-...\"\n\n  // MiniMax (Anthropic Messages-compatible endpoint, with session support):\n  //   \"memoryProvider\": \"minimax\"\n  //   \"memoryModel\": \"MiniMax-M3\"\n  //   \"memoryApiUrl\": \"https://api.minimax.io\"        // global endpoint\n  //   \"memoryApiKey\": \"<MiniMax API key>\"\n  //   // China endpoint: \"memoryApiUrl\": \"https://api.minimaxi.com\"\n  //   // Optional adaptive thinking for MiniMax-M3:\n  //   \"memoryExtraParams\": { \"thinking\": { \"type\": \"adaptive\" } }\n\n  // OrcaRouter (OpenAI-compatible gateway, namespaced model IDs, with session support):\n  //   \"memoryProvider\": \"orcarouter\"\n  //   \"memoryApiKey\": \"<OrcaRouter API key>\"\n  //   // memoryApiUrl and memoryModel are optional \u2014 they default to\n  //   // https://api.orcarouter.ai/v1 and \"orcarouter/auto\" (a routing alias).\n  //   // OrcaRouter rejects bare model names, so if you set memoryModel, use a\n  //   // namespaced ID such as \"openai/gpt-5.5\" or \"deepseek/deepseek-v4-flash\".\n  //   \"memoryModel\": \"openai/gpt-5.5\"\n\n  // Groq (OpenAI-compatible, use openai-chat provider):\n  //   \"memoryProvider\": \"openai-chat\"\n  //   \"memoryModel\": \"llama-3.3-70b-versatile\"\n  //   \"memoryApiUrl\": \"https://api.groq.com/openai/v1\"\n  //   \"memoryApiKey\": \"gsk_...\"\n  \n  // Maximum iterations for multi-turn AI analysis (for openai-responses, anthropic, and minimax)\n  \"autoCaptureMaxIterations\": 5,\n   \n  // Timeout per iteration in milliseconds (30 seconds default)\n  \"autoCaptureIterationTimeout\": 30000,\n\n  // Tries for one turn's capture, on Pi and OpenCode, 2 and 4 seconds apart. After the\n  // last one fails, a turn the model could not reach goes to the capture retry queue.\n  \"autoCaptureMaxRetries\": 3,\n\n  // Maximum UTF-8 bytes for the auto-capture markdown context sent to the summary model.\n  // Prevents HTTP 400 context overflows on models with ~131K token windows (e.g. Groq Llama).\n  // Rough guide: tokens \u2248 bytes / 4 for mixed code/prose.\n  \"autoCaptureMaxContextBytes\": 131072,\n   \n  // Days to keep AI session history before cleanup\n  \"aiSessionRetentionDays\": 7,\n\n  // Capture diagnostics: every capture attempt always writes one metadata line\n  // (model, stop reason, sizes, outcome) to ~/.omms/omms.log, with no\n  // conversation text. Set captureTrace to true to also write each attempt's\n  // prompt and raw reply to ~/.omms/traces/ for debugging. Traces can contain\n  // conversation content: <private> text and common API key formats are\n  // redacted, files are readable only by you, and they are deleted after\n  // captureTraceRetentionDays. Only this global file can turn tracing on.\n  // \"captureTrace\": false,\n  // \"captureTraceRetentionDays\": 7,\n  // \"captureAttemptRetentionDays\": 30,\n\n  // Capture retry queue: when a live capture fails because the model cannot be\n  // reached (network error, timeout, HTTP 408, 429 or 5xx), OMMS keeps a copy of\n  // the turn in ~/.omms/data and tries it again later. The copy has <private>\n  // text and common API key formats removed. Turns are deleted when the retry\n  // ends or after captureRetryRetentionHours (0 to 720). 0 turns the queue off.\n  // Only this global file can set it.\n  // \"captureRetryRetentionHours\": 72,\n\n  // Temperature for AI API requests (set to false to omit parameter for models that don't support it)\n  // Some reasoning models (like o1, o3, gpt-5) don't support temperature parameter\n  // Set to false and add \"memoryTemperature\": false in config when using such models\n  \"memoryTemperature\": 0.3,\n\n  // Extra parameters to include in API request body\n  // Useful for local inference servers (e.g. llama-server with --jinja) that support\n  // additional parameters like disabling thinking/reasoning mode\n  // Example for Qwen3 models: { \"enable_thinking\": false }\n  // \"memoryExtraParams\": {},\n\n  // Language for auto-capture summaries (default: \"auto\" for auto-detection)\n  // Options: \"auto\", \"en\", \"id\", \"zh\", \"ja\", \"es\", \"fr\", \"de\", \"ru\", \"pt\", \"ar\", \"ko\"\n  // \"autoCaptureLanguage\": \"auto\",\n\n  // ============================================\n  // Toast Notifications\n  // ============================================\n\n  // Show toast when memory is auto-captured\n  \"showAutoCaptureToasts\": true,\n\n  // Show toast when user profile is updated\n  \"showUserProfileToasts\": true,\n\n  // Show toast for error messages\n  \"showErrorToasts\": true,\n\n  // ============================================\n  // User Profile System\n  // ============================================\n\n  // Analyze user prompts every N prompts to build/update your user profile\n  // When N uncaptured prompts accumulate, AI will analyze them to identify:\n  // - User preferences (code style, communication style, tool preferences)\n  // - User patterns (recurring topics, problem domains, technical interests)\n  // - User workflows (development habits, sequences, learning style)\n  // - Skill level (overall and per-domain assessment)\n  \"userProfileAnalysisInterval\": 10,\n\n  // Days before inactive items (all types) are eligible for removal\n  \"userProfileStaleDays\": 2,\n\n  // Number of preferences shown in UI\n  \"userProfileDisplayPreferences\": 20,\n  \n  // Number of patterns shown in UI\n  \"userProfileDisplayPatterns\": 15,\n  \n  // Number of workflows shown in UI\n  \"userProfileDisplayWorkflows\": 10,\n  \n  // Number of preferences injected into LLM conversation context\n  // Keep this small \u2014 the strongest signals are enough; more dilute LLM attention\n  \"userProfileInjectPreferences\": 5,\n  \n  // Number of patterns injected into LLM conversation context\n  \"userProfileInjectPatterns\": 5,\n  \n  // Number of workflows injected into LLM conversation context\n  \"userProfileInjectWorkflows\": 3,\n  \n  // Days before preference confidence starts to decay (if not reinforced)\n  // Preferences that aren't seen again will gradually lose confidence and be removed\n  \"userProfileConfidenceDecayDays\": 30,\n  \n  // Number of profile versions to keep in changelog (for rollback/debugging)\n  // Older versions are automatically cleaned up\n  \"userProfileChangelogRetentionCount\": 5,\n\n  // Minimum evidence count for a preference/pattern to survive confidence decay\n  // Items confirmed fewer times are more likely to be pruned when confidence decays\n  \"userProfileMinEvidenceForRetention\": 3,\n\n  // Periodically merge duplicate or irrelevant profile items with the configured AI provider\n  \"userProfileAutoCleanupEnabled\": true,\n  // Number of analyzed user prompts between automatic AI cleanup runs\n  \"userProfileAutoCleanupInterval\": 100,\n\n  // Enable LLM validation of existing preferences against recent behavior.\n  // When enabled, each analysis round checks if top-5 preferences still match recent prompts.\n  // Experimental \u2014 disabled by default.\n  \"userProfileValidationEnabled\": false,\n\n  // ============================================\n  // Search Settings\n  // ============================================\n  \n  // Minimum similarity score (0-1) for memory search results\n  \"similarityThreshold\": 0.6,\n\n  // Maximum number of memories to return in search results.\n  // Manual searches can ask for fewer; prompt retrieval uses this ceiling.\n  \"maxMemories\": 10,\n\n  // ============================================\n  // Memory Context Controls\n  // ============================================\n\n  // Recent memories added at fresh session start (OpenCode V1 and Claude Code).\n  // Pi and OpenCode V2 search the store with each prompt instead.\n  \"chatMessage\": {\n    \"enabled\": true,\n    // Recent memories injected at session start.\n    \"maxMemories\": 3,\n    \"excludeCurrentSession\": true,\n    // When to inject: \"first\" message of a session or \"always\".\n    // \"injectOn\": \"first\",\n  },\n\n  // OpenCode profile-learning input limit, in UTF-8 bytes. Smaller values can\n  // omit prompts from that input. Does not limit Pi or Claude Code profile input.\n  \"userProfileMaxContextBytes\": 32768,\n\n  // Shared budget for automatic memory context (profile text, memories, and\n  // formatting) across all hosts, in approximate tokens: ceil(UTF-8 bytes / 4).\n  // Covers prompt retrieval, recent-memory injection, and session-memory\n  // restoration. Not an exact provider token limit or a spending limit.\n  \"retrievalMaxTokens\": 2000,\n\n  // ============================================\n  // Advanced Settings\n  // ============================================\n  \n  // Inject user profile into AI context (preferences, patterns, workflows)\n  \"injectProfile\": true\n}\n";
 export declare function normalizeAutoCaptureMaxContextBytes(value: number): number;
 /** Whole hours from 0 to 720. A value that is not a number gives the default. */
 export declare function normalizeCaptureRetryRetentionHours(value: unknown): number;
@@ -150,6 +152,7 @@ declare function buildConfig(fileConfig: OmmsConfig): {
     opencodeBackfillModel: string;
     piBackfillModel: string;
     importPathMaps: import("./importer/importer.js").ImportPathMap[];
+    importIgnoredDirectories: string[];
     claudeConfigDir: string;
     webServerAutoStart: boolean;
     webServerEnabled: boolean;
@@ -246,6 +249,7 @@ export declare let CONFIG: {
     opencodeBackfillModel: string;
     piBackfillModel: string;
     importPathMaps: import("./importer/importer.js").ImportPathMap[];
+    importIgnoredDirectories: string[];
     claudeConfigDir: string;
     webServerAutoStart: boolean;
     webServerEnabled: boolean;

package/dist/config.js

@@ -8,7 +8,7 @@ import { resolveSecretValue } from "./services/secret-resolver.js";
 import { isPlaceholderApiKey } from "./services/ai/api-key-placeholder.js";
 import { getAutoCaptureProviderStatus } from "./services/ai/live-model-choice.js";
 import { parseBackfillModel } from "./importer/backfill-model.js";
-import { parseImportPathMaps } from "./importer/import-path-maps.js";
+import { parseIgnoredDirectories, parseImportPathMaps } from "./importer/import-path-maps.js";
 import { checkedMemoryLimit, MEMORY_LIMITS } from "./utils/memory-limits.js";
 import { resolveDefaultStoragePath, runLegacyStoreMigration, legacyMigrationPaths, } from "./services/legacy-migration.js";
 const OMMS_CONFIG_DIR = join(homedir(), ".config", "omms");
@@ -61,6 +61,7 @@ const DEFAULTS = {
     opencodeBackfillModel: "inherit",
     piBackfillModel: "inherit",
     importPathMaps: [],
+    importIgnoredDirectories: [],
     claudeConfigDir: "",
     webServerAutoStart: true,
     webServerEnabled: true,
@@ -209,6 +210,8 @@ export const CONFIG_TEMPLATE = `{
   // "opencodeBackfillModel": "inherit", // or "external", or "provider/model"
   // Directory maps for history recorded in moved or deleted directories.
   // "importPathMaps": [{ "from": "~/code/app-feat-x", "to": "~/code/app" }],
+  // Unresolved directories to hide on the Directory maps page. They stay unimported.
+  // "importIgnoredDirectories": ["/private/tmp/scratch"],
   // Claude Code's folder, when it is not ~/.claude (like CLAUDE_CONFIG_DIR).
   // "claudeConfigDir": "~/.claude-work",
 
@@ -646,6 +649,7 @@ function buildConfig(fileConfig) {
     parseBackfillModel(fileConfig, "pi");
     parseBackfillModel(fileConfig, "opencode");
     const importPathMaps = parseImportPathMaps(fileConfig.importPathMaps);
+    const importIgnoredDirectories = parseIgnoredDirectories(fileConfig.importIgnoredDirectories);
     if (fileConfig.claudeConfigDir !== undefined &&
         !isValidClaudeConfigDir(fileConfig.claudeConfigDir)) {
         throw new Error("Invalid claudeConfigDir config");
@@ -716,6 +720,7 @@ function buildConfig(fileConfig) {
         opencodeBackfillModel: fileConfig.opencodeBackfillModel ?? DEFAULTS.opencodeBackfillModel,
         piBackfillModel: fileConfig.piBackfillModel ?? DEFAULTS.piBackfillModel,
         importPathMaps,
+        importIgnoredDirectories,
         claudeConfigDir: expandPath(fileConfig.claudeConfigDir?.trim() ?? DEFAULTS.claudeConfigDir),
         webServerAutoStart: fileConfig.webServerAutoStart ?? DEFAULTS.webServerAutoStart,
         webServerEnabled: fileConfig.webServerEnabled ?? DEFAULTS.webServerEnabled,
@@ -874,6 +879,7 @@ export function initConfig(directory, options = {}) {
     delete projectOverrides.opencodeBackfillModel;
     delete projectOverrides.piBackfillModel;
     delete projectOverrides.importPathMaps;
+    delete projectOverrides.importIgnoredDirectories;
     // A checked-in project file must not point the web app at another folder.
     delete projectOverrides.claudeConfigDir;
     delete projectOverrides.webServerAutoStart;

package/dist/importer/import-path-maps.d.ts

@@ -5,6 +5,11 @@ import type { ImportPathMap } from "./importer.js";
  * the first invalid entry, like the rest of config validation.
  */
 export declare function parseImportPathMaps(value: unknown): ImportPathMap[];
+/**
+ * Validate and normalise `importIgnoredDirectories` from the global config:
+ * absolute directories after `~` expansion. Throws on the first invalid entry.
+ */
+export declare function parseIgnoredDirectories(value: unknown): string[];
 /** Saved maps with the run's own maps on top; a run map wins for the same `from`. */
 export declare function mergeImportPathMaps(saved: readonly ImportPathMap[], run: readonly ImportPathMap[]): ImportPathMap[];
 /**

package/dist/importer/import-path-maps.js

@@ -30,6 +30,26 @@ export function parseImportPathMaps(value) {
         return { from: resolve(expanded.from), to: resolve(expanded.to) };
     });
 }
+/**
+ * Validate and normalise `importIgnoredDirectories` from the global config:
+ * absolute directories after `~` expansion. Throws on the first invalid entry.
+ */
+export function parseIgnoredDirectories(value) {
+    if (value === undefined)
+        return [];
+    if (!Array.isArray(value)) {
+        throw new Error("Invalid importIgnoredDirectories config: must be a list");
+    }
+    const paths = value.map((entry, index) => {
+        const expanded = typeof entry === "string" ? expandHome(entry.trim()) : "";
+        if (!expanded || !isAbsolute(expanded)) {
+            throw new Error(`Invalid importIgnoredDirectories config: entry ${index} needs an absolute path`);
+        }
+        return resolve(expanded);
+    });
+    // One folder written in two forms is one entry.
+    return [...new Set(paths)];
+}
 /** Saved maps with the run's own maps on top; a run map wins for the same `from`. */
 export function mergeImportPathMaps(saved, run) {
     const byFrom = new Map();

package/dist/importer/map-suggestions.d.ts

@@ -1,23 +1,50 @@
 import type { UnresolvedDirectory } from "../services/backfill-state.js";
+export type MapConfidence = "exact" | "name" | "guess";
+export type IgnoreReason = "temporary" | "node_modules" | "app-data" | "skills";
+export type MapSuggestion = {
+    kind: "map";
+    target: string;
+    confidence: MapConfidence;
+} | {
+    kind: "ignore";
+    reason: IgnoreReason;
+};
+/** A project the user has history for. Store projects carry their recorded paths and remote. */
+export interface KnownProject {
+    path: string;
+    /** Other directories the memory store recorded for the same project. */
+    candidates?: readonly string[];
+    /** The git remote the memory store recorded for the project. */
+    remote?: string | null;
+}
 export interface MapSuggestionContext {
     /** Existing project directories the user has history for; their parents are searched too. */
-    knownProjects?: readonly string[];
+    knownProjects?: readonly KnownProject[];
     /** OpenCode's recorded project worktree for a session directory, read without writing. */
     opencodeWorktree?: (directory: string) => string | null | undefined;
     /** The user's home folder; the search never climbs above it. Defaults to `homedir()`. */
     home?: string;
+    /** Claude Code's folder, from `resolveClaudeFolder`. Defaults to `<home>/.claude`. */
+    claudeFolder?: string;
     /** Folder listings already read in this request. */
     cache?: Map<string, string[]>;
+    /** Project-marker checks already made in this request. */
+    projects?: Map<string, boolean>;
+    /** Parent folders of the known projects, worked out once per request. */
+    searchRoots?: ReadonlySet<string>;
 }
 /**
- * Suggest an existing target for a directory that no longer exists: first the
- * main repository of a deleted worktree, by the longest leading part of the
- * directory's name or one of its parents' names, then OpenCode's recorded
- * project worktree. Returns null when there is no candidate.
+ * Suggest what to do with a directory that no longer exists. Rules run in
+ * order and the first result wins: (1) ignore a folder that is not a project,
+ * (2) the project with the same stored git remote, (3) OpenCode's recorded
+ * project folder, or rules 2 and 4 to 6 on it when it is gone too, (4) the
+ * main repository of a deleted worktree, (5) the one known project with the
+ * same folder name, (6) a rename guess by name parts and initials. Returns
+ * null when no rule gives a result. Reads folders and `.git` files only.
  */
-export declare function suggestMapTarget(missing: string, context?: MapSuggestionContext): string | null;
+export declare function suggestMapTarget(missing: string, context?: MapSuggestionContext): MapSuggestion | null;
 export interface SuggestedDirectory extends UnresolvedDirectory {
-    suggestion: string | null;
+    suggestion: MapSuggestion | null;
 }
 export declare function suggestMapTargets(directories: readonly UnresolvedDirectory[], context?: MapSuggestionContext): SuggestedDirectory[];
 /**
@@ -26,14 +53,22 @@ export declare function suggestMapTargets(directories: readonly UnresolvedDirect
  */
 export declare function readOpencodeWorktrees(dbPath: string): Promise<Map<string, string>>;
 /**
- * The Directory maps list: saved maps and each host's unresolved directories
- * from its latest run, with suggestions. Paths and counts only.
+ * The memory store's projects with their recorded paths and git remote, read
+ * once through the shard inventory. Empty when there is no store or the read
+ * fails, so the other sources still give suggestions. Never creates a store.
+ */
+export declare function readStoreProjects(currentDirectory: string): Promise<KnownProject[]>;
+/**
+ * The Directory maps list: saved maps, ignored directories, and each host's
+ * unresolved directories from its latest run, with suggestions. Paths and
+ * counts only.
  */
 export declare function directoryMapsView(options?: {
     opencodeDbPath?: string;
-    knownProjects?: readonly string[];
+    knownProjects?: readonly KnownProject[];
 }): Promise<{
     saved: import("./importer.js").ImportPathMap[];
+    ignored: string[];
     pi: SuggestedDirectory[];
     opencode: SuggestedDirectory[];
     "claude-code": SuggestedDirectory[];