om-memory-system 4.30.1 → 4.31.1

package/dist/config-template.d.ts

@@ -3,4 +3,4 @@
  * src/config.ts until that file reached its size ceiling; the text is
  * unchanged. Shared by config.ts and the global settings writer.
  */
-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  // Days before an inactive workflow is eligible for removal. A workflow seen\n  // userProfileMinEvidenceForRetention times or more is kept.\n  \"userProfileWorkflowStaleDays\": 30,\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  // Merge duplicate or vague profile items every N analysed prompts (about 1 model call per 100 items)\n  \"userProfileAutoCleanupEnabled\": true,\n  \"userProfileAutoCleanupInterval\": 500,\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. Leave unset to\n  // follow the default for your embedding model: 0.5 for qwen3-embedding:0.6b\n  // (the only model measured), 0.6 for every other embedder.\n  // \"similarityThreshold\": 0.5,\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  // Skill learning: record each full turn (prompt, replies, tool calls with\n  // their outcome, and the skills used) in ~/.omms/data/skills.db, so OMMS can\n  // rank your skills and draft better versions. Off by default. A project config\n  // can turn it off but never on. No model call is made to record a turn.\n  // \"skillLearning\": false,\n  // Remove <private> text and common API key formats before a turn is stored.\n  // Global config only. Turning this off stores text as written.\n  // \"skillLearningRedact\": true,\n  // Folders OMMS reads skills from. Absolute or starting with ~/. Global config\n  // only. Unset: ~/.agents/skills and the Claude Code folder's skills folder.\n  // \"skillFolders\": [\"~/.agents/skills\"],\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  // Days before an inactive workflow is eligible for removal. A workflow seen\n  // userProfileMinEvidenceForRetention times or more is kept.\n  \"userProfileWorkflowStaleDays\": 30,\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  // Merge duplicate or vague profile items every N analysed prompts (about 1 model call per 100 items)\n  \"userProfileAutoCleanupEnabled\": true,\n  \"userProfileAutoCleanupInterval\": 500,\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. Leave unset to\n  // follow the default for your embedding model: 0.5 for qwen3-embedding:0.6b\n  // (the only model measured), 0.6 for every other embedder.\n  // \"similarityThreshold\": 0.5,\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";

package/dist/config-template.js

@@ -242,6 +242,18 @@ export const CONFIG_TEMPLATE = `{
   // "captureTraceRetentionDays": 7,
   // "captureAttemptRetentionDays": 30,
 
+  // Skill learning: record each full turn (prompt, replies, tool calls with
+  // their outcome, and the skills used) in ~/.omms/data/skills.db, so OMMS can
+  // rank your skills and draft better versions. Off by default. A project config
+  // can turn it off but never on. No model call is made to record a turn.
+  // "skillLearning": false,
+  // Remove <private> text and common API key formats before a turn is stored.
+  // Global config only. Turning this off stores text as written.
+  // "skillLearningRedact": true,
+  // Folders OMMS reads skills from. Absolute or starting with ~/. Global config
+  // only. Unset: ~/.agents/skills and the Claude Code folder's skills folder.
+  // "skillFolders": ["~/.agents/skills"],
+
   // Capture retry queue: when a live capture fails because the model cannot be
   // reached (network error, timeout, HTTP 408, 429 or 5xx), OMMS keeps a copy of
   // the turn in ~/.omms/data and tries it again later. The copy has <private>

package/dist/config.d.ts

@@ -57,6 +57,12 @@ interface OmmsConfig {
     captureAttemptRetentionDays?: number;
     /** Hours to keep failed live captures for retry. 0 turns the queue off. Global config only. */
     captureRetryRetentionHours?: number;
+    /** Record full turns into skills.db (ADR-036). A project can only turn it off. */
+    skillLearning?: boolean;
+    /** Remove `<private>` text and secrets from recorded turns. Default true. Global config only. */
+    skillLearningRedact?: boolean;
+    /** Folders OMMS reads skills from. Absolute or `~/`. Unset: the shared and Claude Code skill folders. Global config only. */
+    skillFolders?: string[];
     autoBackfill?: boolean;
     opencodeBackfillModel?: string;
     piBackfillModel?: string;
@@ -125,49 +131,6 @@ export declare function normalizeAutoCaptureMaxContextBytes(value: number): numb
 export declare function normalizeCaptureRetryRetentionHours(value: unknown): number;
 export declare function normalizeAutoCleanupRetentionDays(value: number): number;
 declare function buildConfig(fileConfig: OmmsConfig): {
-    storagePath: string;
-    userEmailOverride: string | undefined;
-    userNameOverride: string | undefined;
-    embeddingModel: string;
-    embeddingDimensions: number;
-    embeddingUseTaskPrefixes: boolean;
-    embeddingApiUrl: string | undefined;
-    embeddingApiKey: string | undefined;
-    similarityThreshold: number;
-    rerankerEnabled: boolean;
-    rerankerApiUrl: string | undefined;
-    rerankerModel: string | undefined;
-    rerankerApiKey: string | undefined;
-    rerankerTimeoutMs: number;
-    keywordBoost: number;
-    keywordMode: KeywordMode;
-    maxMemories: number;
-    retrievalMaxTokens: number;
-    maxProfileItems: number;
-    injectProfile: boolean;
-    containerTagPrefix: string;
-    autoCaptureEnabled: boolean;
-    autoCaptureMaxIterations: number;
-    autoCaptureIterationTimeout: number;
-    autoCaptureMaxRetries: number;
-    autoCaptureMaxContextBytes: number;
-    autoCaptureLanguage: string | undefined;
-    memoryProvider: "openai-chat" | "openai-responses" | "anthropic" | "minimax" | "orcarouter" | "google-gemini";
-    memoryModel: string | undefined;
-    memoryApiUrl: string | undefined;
-    memoryApiKey: string | undefined;
-    memoryTemperature: number | false | undefined;
-    memoryExtraParams: Record<string, unknown> | undefined;
-    opencodeProvider: string | undefined;
-    opencodeModel: string | undefined;
-    piProvider: string | undefined;
-    piModel: string | undefined;
-    autoCaptureProviderStatus: import("./config.js").AutoCaptureProviderStatus;
-    aiSessionRetentionDays: number;
-    captureTrace: boolean;
-    captureTraceRetentionDays: number;
-    captureAttemptRetentionDays: number;
-    captureRetryRetentionHours: number;
     autoBackfill: boolean;
     opencodeBackfillModel: string;
     piBackfillModel: string;
@@ -225,12 +188,12 @@ declare function buildConfig(fileConfig: OmmsConfig): {
         maxAgeDays: number | undefined;
         injectOn: "first" | "always";
     };
-};
-export declare function getGlobalConfigSourcePath(): string | undefined;
-export declare function getGlobalConfigWritePath(): string;
-export declare function validateGlobalConfig(value: unknown): void;
-export declare let CONFIG: {
+    skillLearning: boolean;
+    skillLearningRedact: boolean;
+    skillFolders: string[] | undefined;
     storagePath: string;
+    /** The global `storagePath` when a project moved `storagePath`; `skills.db` stays there. */
+    skillStoragePath: string | undefined;
     userEmailOverride: string | undefined;
     userNameOverride: string | undefined;
     embeddingModel: string;
@@ -273,6 +236,11 @@ export declare let CONFIG: {
     captureTraceRetentionDays: number;
     captureAttemptRetentionDays: number;
     captureRetryRetentionHours: number;
+};
+export declare function getGlobalConfigSourcePath(): string | undefined;
+export declare function getGlobalConfigWritePath(): string;
+export declare function validateGlobalConfig(value: unknown): void;
+export declare let CONFIG: {
     autoBackfill: boolean;
     opencodeBackfillModel: string;
     piBackfillModel: string;
@@ -330,6 +298,54 @@ export declare let CONFIG: {
         maxAgeDays: number | undefined;
         injectOn: "first" | "always";
     };
+    skillLearning: boolean;
+    skillLearningRedact: boolean;
+    skillFolders: string[] | undefined;
+    storagePath: string;
+    /** The global `storagePath` when a project moved `storagePath`; `skills.db` stays there. */
+    skillStoragePath: string | undefined;
+    userEmailOverride: string | undefined;
+    userNameOverride: string | undefined;
+    embeddingModel: string;
+    embeddingDimensions: number;
+    embeddingUseTaskPrefixes: boolean;
+    embeddingApiUrl: string | undefined;
+    embeddingApiKey: string | undefined;
+    similarityThreshold: number;
+    rerankerEnabled: boolean;
+    rerankerApiUrl: string | undefined;
+    rerankerModel: string | undefined;
+    rerankerApiKey: string | undefined;
+    rerankerTimeoutMs: number;
+    keywordBoost: number;
+    keywordMode: KeywordMode;
+    maxMemories: number;
+    retrievalMaxTokens: number;
+    maxProfileItems: number;
+    injectProfile: boolean;
+    containerTagPrefix: string;
+    autoCaptureEnabled: boolean;
+    autoCaptureMaxIterations: number;
+    autoCaptureIterationTimeout: number;
+    autoCaptureMaxRetries: number;
+    autoCaptureMaxContextBytes: number;
+    autoCaptureLanguage: string | undefined;
+    memoryProvider: "openai-chat" | "openai-responses" | "anthropic" | "minimax" | "orcarouter" | "google-gemini";
+    memoryModel: string | undefined;
+    memoryApiUrl: string | undefined;
+    memoryApiKey: string | undefined;
+    memoryTemperature: number | false | undefined;
+    memoryExtraParams: Record<string, unknown> | undefined;
+    opencodeProvider: string | undefined;
+    opencodeModel: string | undefined;
+    piProvider: string | undefined;
+    piModel: string | undefined;
+    autoCaptureProviderStatus: import("./config.js").AutoCaptureProviderStatus;
+    aiSessionRetentionDays: number;
+    captureTrace: boolean;
+    captureTraceRetentionDays: number;
+    captureAttemptRetentionDays: number;
+    captureRetryRetentionHours: number;
 };
 type RuntimeConfig = ReturnType<typeof buildConfig>;
 export { getAutoCaptureProviderStatus, type AutoCaptureProviderStatus, } from "./services/ai/live-model-choice.js";

package/dist/config.js

@@ -9,6 +9,7 @@ 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 { parseIgnoredDirectories, parseImportPathMaps } from "./importer/import-path-maps.js";
+import { normaliseSkillConfig, projectSkillOverride, } from "./services/skill-learning/skill-config.js";
 import { checkedMemoryLimit, MEMORY_LIMITS } from "./utils/memory-limits.js";
 import { defaultSimilarityThreshold } from "./utils/threshold-default.js";
 import { RERANKER_TIMEOUT_DEFAULT_MS } from "./services/request-timeouts.js";
@@ -62,6 +63,8 @@ const DEFAULTS = {
     captureTraceRetentionDays: 7,
     captureAttemptRetentionDays: 30,
     captureRetryRetentionHours: 72,
+    skillLearning: false,
+    skillLearningRedact: true,
     autoBackfill: true,
     opencodeBackfillModel: "inherit",
     piBackfillModel: "inherit",
@@ -126,6 +129,14 @@ function expandPath(path) {
     }
     return path;
 }
+function storagePathFrom(fileConfig) {
+    return fileConfig.storagePath ? expandPath(fileConfig.storagePath) : resolveDefaultStoragePath();
+}
+/** Keeps skills.db in the global storage path when a project config moves storagePath (ADR-036). */
+function withSkillStorage(config, global) {
+    const path = storagePathFrom(global);
+    return { ...config, skillStoragePath: path === config.storagePath ? undefined : path };
+}
 /**
  * Load the first config file that exists, in priority order. A file that
  * exists but cannot be read or parsed is not skipped: falling through would let
@@ -304,9 +315,9 @@ function buildConfig(fileConfig) {
         throw new Error(`Invalid userProfileAutoCleanupInterval config: ${userProfileAutoCleanupInterval}`);
     }
     return {
-        storagePath: fileConfig.storagePath
-            ? expandPath(fileConfig.storagePath)
-            : resolveDefaultStoragePath(),
+        storagePath: storagePathFrom(fileConfig),
+        /** The global `storagePath` when a project moved `storagePath`; `skills.db` stays there. */
+        skillStoragePath: undefined,
         userEmailOverride: fileConfig.userEmailOverride,
         userNameOverride: fileConfig.userNameOverride,
         embeddingModel: fileConfig.embeddingModel ?? DEFAULTS.embeddingModel,
@@ -359,6 +370,7 @@ function buildConfig(fileConfig) {
         captureTraceRetentionDays: Math.max(1, Math.floor(fileConfig.captureTraceRetentionDays ?? DEFAULTS.captureTraceRetentionDays)),
         captureAttemptRetentionDays: normalizeAutoCleanupRetentionDays(fileConfig.captureAttemptRetentionDays ?? DEFAULTS.captureAttemptRetentionDays),
         captureRetryRetentionHours: normalizeCaptureRetryRetentionHours(fileConfig.captureRetryRetentionHours),
+        ...normaliseSkillConfig(fileConfig),
         autoBackfill: fileConfig.autoBackfill ?? DEFAULTS.autoBackfill,
         opencodeBackfillModel: fileConfig.opencodeBackfillModel ?? DEFAULTS.opencodeBackfillModel,
         piBackfillModel: fileConfig.piBackfillModel ?? DEFAULTS.piBackfillModel,
@@ -442,6 +454,7 @@ export function validateGlobalConfig(value) {
 }
 const _globalFileConfig = loadConfigFromPaths(CONFIG_FILES);
 let lastFileConfig = _globalFileConfig;
+let lastGlobalFileConfig = _globalFileConfig;
 export let CONFIG = buildConfig(_globalFileConfig);
 export { getAutoCaptureProviderStatus, } from "./services/ai/live-model-choice.js";
 export { isPlaceholderApiKey };
@@ -521,6 +534,15 @@ export function initConfig(directory, options = {}) {
     delete projectOverrides.captureTraceRetentionDays;
     // The queue holds conversation text, so only the global file sets how long.
     delete projectOverrides.captureRetryRetentionHours;
+    // Skill learning stores full turns: a project may only turn it off.
+    const skillRule = projectSkillOverride(projectConfig);
+    if (skillRule.ignoredTurnOn) {
+        log("Project config cannot turn on skillLearning; the value was ignored", { directory });
+    }
+    delete projectOverrides.skillLearning;
+    delete projectOverrides.skillLearningRedact;
+    delete projectOverrides.skillFolders;
+    Object.assign(projectOverrides, skillRule.override);
     delete projectOverrides.autoBackfill;
     delete projectOverrides.opencodeBackfillModel;
     delete projectOverrides.piBackfillModel;
@@ -539,8 +561,9 @@ export function initConfig(directory, options = {}) {
     delete projectOverrides.webServerAutoStart;
     delete projectOverrides.webServerEnabled;
     const merged = { ...globalConfig, ...projectOverrides };
-    const nextConfig = buildConfig(merged);
+    const nextConfig = withSkillStorage(buildConfig(merged), globalConfig);
     lastFileConfig = merged;
+    lastGlobalFileConfig = globalConfig;
     CONFIG = nextConfig;
     lastConfigDirectory = directory;
     lastConfigSignature = configSignature(directory);
@@ -551,7 +574,7 @@ export function initConfig(directory, options = {}) {
  * ~/.omms/data when the migration marker says it succeeded.
  */
 function refreshStorageResolution() {
-    CONFIG = buildConfig(lastFileConfig);
+    CONFIG = withSkillStorage(buildConfig(lastFileConfig), lastGlobalFileConfig);
 }
 /**
  * initConfig plus the one-time legacy store migration (decision D13).

package/dist/core/host.d.ts

@@ -1,7 +1,14 @@
 import type { MemoryHost, MemorySourceType } from "../types/index.js";
+export type CaptureToolOutcome = "ok" | "error" | "unknown";
 export interface CaptureToolCall {
     name: string;
     input: string;
+    /** Set by the host readers for skill learning. Memory capture ignores it. */
+    outcome?: CaptureToolOutcome;
+    /** Error text the host reported, at most 2,000 characters. Memory capture ignores it. */
+    error?: string;
+    /** Full path of a read-type call, for skill detection. Memory capture ignores it. */
+    path?: string;
 }
 export interface CaptureConversation {
     textResponses: string[];

package/dist/core/profile-backoff.d.ts

@@ -1,17 +1,25 @@
 import { type ProfileFailureCode } from "./profile-failure.js";
 /** After a failed profile pass, the process waits this long before the next one. */
 export declare const PROFILE_FAILURE_WAIT_MS: number;
-/**
- * An in-process gate: a failing batch is not retried, and paid for, after
- * every turn. Capture never checks it. A restart clears it.
- */
-export declare const profileBackoff: {
+export interface Backoff {
     canRun(now?: number): boolean;
     recordSuccess(): void;
     recordFailure(now?: number): void;
-};
-/** Log one metadata record for a failed pass and start the wait. */
-export declare function recordProfileFailure(host: "opencode" | "pi" | "claude-code", message: string, error: unknown, now?: number): ProfileFailureCode;
+}
+/**
+ * An in-process gate: a failing batch is not retried, and paid for, after
+ * every turn. Capture never checks it. A restart clears it. Each instance
+ * keeps its own wait, so a failure in one never pauses another.
+ */
+export declare function createBackoff(waitMs: number): Backoff;
+export declare const profileBackoff: Backoff;
+/** After a failed skill draft, automatic review waits 10 minutes. Profile learning keeps running. */
+export declare const skillDraftBackoff: Backoff;
+/**
+ * Log one metadata record for a failed pass and start the wait on `backoff`.
+ * `host` is null for skill drafting, which runs for every host.
+ */
+export declare function recordProfileFailure(host: "opencode" | "pi" | "claude-code" | null, message: string, error: unknown, now?: number, backoff?: Backoff): ProfileFailureCode;
 /** One catch-up run at a time, and no live pass in this process while it runs. */
 export declare const profileCatchUpLock: {
     isActive: () => boolean;

package/dist/core/profile-backoff.js

@@ -2,26 +2,35 @@ import { log } from "../services/logger.js";
 import { profileFailureCode } from "./profile-failure.js";
 /** After a failed profile pass, the process waits this long before the next one. */
 export const PROFILE_FAILURE_WAIT_MS = 10 * 60 * 1000;
-let lastFailureAt = null;
 /**
  * An in-process gate: a failing batch is not retried, and paid for, after
- * every turn. Capture never checks it. A restart clears it.
+ * every turn. Capture never checks it. A restart clears it. Each instance
+ * keeps its own wait, so a failure in one never pauses another.
  */
-export const profileBackoff = {
-    canRun(now = Date.now()) {
-        return lastFailureAt === null || now - lastFailureAt >= PROFILE_FAILURE_WAIT_MS;
-    },
-    recordSuccess() {
-        lastFailureAt = null;
-    },
-    recordFailure(now = Date.now()) {
-        lastFailureAt = now;
-    },
-};
-/** Log one metadata record for a failed pass and start the wait. */
-export function recordProfileFailure(host, message, error, now = Date.now()) {
+export function createBackoff(waitMs) {
+    let lastFailureAt = null;
+    return {
+        canRun(now = Date.now()) {
+            return lastFailureAt === null || now - lastFailureAt >= waitMs;
+        },
+        recordSuccess() {
+            lastFailureAt = null;
+        },
+        recordFailure(now = Date.now()) {
+            lastFailureAt = now;
+        },
+    };
+}
+export const profileBackoff = createBackoff(PROFILE_FAILURE_WAIT_MS);
+/** After a failed skill draft, automatic review waits 10 minutes. Profile learning keeps running. */
+export const skillDraftBackoff = createBackoff(10 * 60 * 1000);
+/**
+ * Log one metadata record for a failed pass and start the wait on `backoff`.
+ * `host` is null for skill drafting, which runs for every host.
+ */
+export function recordProfileFailure(host, message, error, now = Date.now(), backoff = profileBackoff) {
     const reason = profileFailureCode(error);
-    profileBackoff.recordFailure(now);
+    backoff.recordFailure(now);
     log(message, { host, reason }, "error");
     return reason;
 }

package/dist/core/skill-agent-modes.d.ts

@@ -0,0 +1,4 @@
+import type { SkillOperationArgs, SkillOperationResult, SkillOperationsDeps } from "./skill-operations.js";
+export declare function evidence(args: SkillOperationArgs, deps: SkillOperationsDeps, now: number): Promise<SkillOperationResult>;
+export declare function propose(args: SkillOperationArgs, deps: SkillOperationsDeps, now: number): Promise<SkillOperationResult>;
+export declare function undo(args: SkillOperationArgs, deps: SkillOperationsDeps, now: number): Promise<SkillOperationResult>;

package/dist/core/skill-agent-modes.js

@@ -0,0 +1,145 @@
+import { DEFAULT_EVIDENCE_TURNS, MAX_EVIDENCE_TURNS, proposeImprovement, proposeNewSkill, skillEvidence, } from "../services/skill-learning/agent-proposals.js";
+import { undoProposal } from "../services/skill-learning/apply.js";
+import { getProposal } from "../services/skill-learning/proposal-store.js";
+import { rankSkills } from "../services/skill-learning/ranking.js";
+import { getSkillIndex } from "../services/skill-learning/skill-index.js";
+import { reply, resolveSkillPath, watchedTarget } from "./skill-operation-reply.js";
+/**
+ * The agent fixes a skill without the external API (design §8): `evidence`
+ * gives the file and its turns, `propose` saves the agent's revised file as a
+ * pending proposal, and `undo` reverts an applied one. No mode calls a model.
+ */
+const NEXT_STEP = "Write the fixed SKILL.md, then call propose with skill, content and summary. Show the user the diff. Call apply only when the user asks.";
+function isReply(value) {
+    return "code" in value;
+}
+function parseLimit(value) {
+    if (value === undefined || value === "")
+        return DEFAULT_EVIDENCE_TURNS;
+    const limit = Number(value);
+    return Number.isInteger(limit) && limit >= 1 && limit <= MAX_EVIDENCE_TURNS ? limit : null;
+}
+/** Turn ids from numbers, `T12` labels, or a comma-separated list. */
+function parseTurnIds(value) {
+    const items = typeof value === "string" ? value.split(",") : (value ?? []);
+    const ids = [];
+    for (const item of items) {
+        const match = /^\s*T?(\d+)\s*$/i.exec(String(item));
+        if (match)
+            ids.push(Number(match[1]));
+    }
+    return ids;
+}
+function turnText(turn) {
+    const parts = [`[T${turn.id}] ${new Date(turn.createdAt).toISOString()} ${turn.host}`];
+    if (turn.failedAfterUse)
+        parts.push("A tool call failed after the skill loaded.");
+    parts.push(`Prompt: ${turn.prompt}`);
+    if (turn.tools.length > 0) {
+        parts.push("Tool calls:");
+        for (const t of turn.tools) {
+            parts.push(`- ${t.name}: ${t.outcome}${t.error ? ` (${t.error})` : ""}`);
+        }
+    }
+    parts.push(...turn.replies.map((r, i) => `Reply ${i + 1}: ${r}`));
+    if (turn.cut)
+        parts.push("(cut)");
+    return parts.join("\n");
+}
+export async function evidence(args, deps, now) {
+    const skill = args.skill?.trim();
+    if (!skill)
+        return reply("evidence", false, "invalid-args", "Give skill: a name or a path.");
+    const limit = parseLimit(args.limit);
+    if (limit === null) {
+        return reply("evidence", false, "invalid-args", `limit must be 1 to ${MAX_EVIDENCE_TURNS}.`);
+    }
+    const index = getSkillIndex(deps.folders, now);
+    const found = resolveSkillPath("evidence", skill, index);
+    if (isReply(found))
+        return found;
+    const result = await skillEvidence(found.path, limit, { store: deps.store, index, now });
+    if (!result.ok)
+        return reply("evidence", false, result.code, result.message);
+    const ranked = (await rankSkills(deps.store, index, now)).find((r) => r.path === found.path);
+    const numbers = {
+        uses: ranked?.uses ?? 0,
+        failedTurns: ranked?.failedTurns ?? 0,
+        attention: ranked?.attention ?? 0,
+    };
+    const text = [
+        `Skill: ${result.ref.name}`,
+        `File: ${found.path}`,
+        `Last 30 days: ${numbers.uses} uses, ${numbers.failedTurns} failed turns, attention ${numbers.attention.toFixed(2)}`,
+        `Current SKILL.md:\n<<<\n${result.content}\n>>>`,
+        "Recorded turns, failed first:",
+        result.turns.map(turnText).join("\n\n") || "(none)",
+        NEXT_STEP,
+    ].join("\n\n");
+    return reply("evidence", true, "ok", text, {
+        name: result.ref.name,
+        path: found.path,
+        content: result.content,
+        ...numbers,
+        turns: result.turns,
+    });
+}
+function proposeReply(result) {
+    if (!result.ok)
+        return reply("propose", false, result.code, result.message);
+    if (result.code === "no-change")
+        return reply("propose", true, "no-change", result.message);
+    const p = result.proposal;
+    return reply("propose", true, "proposed", `Saved pending proposal ${p.id} for ${p.skillName}. Show the user the diff below. Call apply only when the user asks.\n\n${p.diff ?? ""}`, { proposal: p });
+}
+export async function propose(args, deps, now) {
+    if (typeof args.content !== "string" || args.content.trim() === "") {
+        return reply("propose", false, "invalid-args", "Give content: the full new SKILL.md.");
+    }
+    const input = {
+        content: args.content,
+        summary: args.summary ?? "",
+        evidenceTurnIds: parseTurnIds(args.evidence),
+    };
+    const index = getSkillIndex(deps.folders, now);
+    const agentDeps = { store: deps.store, index, now };
+    if (args.idea) {
+        const name = args.idea.name?.trim();
+        if (!name)
+            return reply("propose", false, "invalid-args", "An idea needs a name.");
+        const target = watchedTarget("propose", deps.folders, args.folder);
+        if (isReply(target))
+            return target;
+        await deps.store.init();
+        return proposeReply(await proposeNewSkill(name, target.folder, input, agentDeps));
+    }
+    const skill = args.skill?.trim();
+    if (!skill)
+        return reply("propose", false, "invalid-args", "Give skill, or idea and folder.");
+    const found = resolveSkillPath("propose", skill, index);
+    if (isReply(found))
+        return found;
+    await deps.store.init();
+    return proposeReply(await proposeImprovement(found.path, input, agentDeps));
+}
+export async function undo(args, deps, now) {
+    if (!args.id)
+        return reply("undo", false, "invalid-args", "Give the proposal id.");
+    if (!(await getProposal(deps.store, args.id))) {
+        return reply("undo", false, "not-found", `No proposal ${args.id}.`);
+    }
+    await deps.store.init();
+    const result = await undoProposal(args.id, {
+        store: deps.store,
+        folders: deps.folders,
+        now: () => now,
+    });
+    if (!result.ok) {
+        const data = result.savedContent === undefined ? undefined : { savedContent: result.savedContent };
+        return reply("undo", false, result.code, result.message, data);
+    }
+    return reply("undo", true, "undone", `Undid proposal ${args.id} and restored ${result.path}.`, {
+        proposal: result.proposal,
+        path: result.path,
+    });
+}

package/dist/core/skill-operation-reply.d.ts

@@ -0,0 +1,16 @@
+import type { SkillIndex } from "../services/skill-learning/skill-index.js";
+import type { SkillOperationResult } from "./skill-operations.js";
+/** Helpers that `skill-operations.ts` and `skill-agent-modes.ts` share. */
+export declare function reply(mode: string, success: boolean, code: string, text: string, data?: Record<string, unknown>): SkillOperationResult;
+export declare function expandHome(path: string): string;
+/**
+ * The `SKILL.md` path for a skill name or path, or the reply that explains
+ * why there is none: no skill of that name, or more than one.
+ */
+export declare function resolveSkillPath(mode: string, skill: string, index: SkillIndex): {
+    path: string;
+} | SkillOperationResult;
+/** `folder` when it is one of the watched folders, or the reply that lists them. */
+export declare function watchedTarget(mode: string, folders: readonly string[], folder: string | undefined): {
+    folder: string;
+} | SkillOperationResult;