feat: Mode system with inheritance and multilingual support (#412)

* feat: add domain management system with support for multiple domain profiles - Introduced DomainManager class for loading and managing domain profiles. - Added support for a default domain ('code') and fallback mechanisms. - Implemented domain configuration validation and error handling. - Created types for domain configuration, observation types, and concepts. - Added new directory for domain profiles and ensured its existence. - Updated SettingsDefaultsManager to include CLAUDE_MEM_DOMAIN setting. * Refactor domain management to mode management - Removed DomainManager class and replaced it with ModeManager for better clarity and functionality. - Updated types from DomainConfig to ModeConfig and DomainPrompts to ModePrompts. - Changed references from domains to modes in the settings and paths. - Ensured backward compatibility by maintaining the fallback mechanism to the 'code' mode. * feat: add migration 008 to support mode-agnostic observations and refactor service layer references in documentation * feat: add new modes for code development and email investigation with detailed observation types and concepts * Refactor observation parsing and prompt generation to incorporate mode-specific configurations - Updated `parseObservations` function to use 'observation' as a universal fallback type instead of 'change', utilizing active mode's valid observation types. - Modified `buildInitPrompt` and `buildContinuationPrompt` functions to accept a `ModeConfig` parameter, allowing for dynamic prompt content based on the active mode. - Enhanced `ModePrompts` interface to include additional guidance for observers, such as recording focus and skip guidance. - Adjusted the SDKAgent to load the active mode and pass it to prompt generation functions, ensuring prompts are tailored to the current mode's context. * fix: correct mode prompt injection to preserve exact wording and type list visibility - Add script to extract prompts from main branch prompts.ts into code.yaml - Fix prompts.ts to show type list in XML template (e.g., "[ bugfix | feature | ... ]") - Keep 'change' as fallback type in parser.ts (maintain backwards compatibility) - Regenerate code.yaml with exact wording from original hardcoded prompts - Build succeeds with no TypeScript errors * fix: update ModeManager to load JSON mode files and improve validation - Changed ModeManager to load mode configurations from JSON files instead of YAML. - Removed the requirement for an "observation" type and updated validation to require at least one observation type. - Updated fallback behavior in the parser to use the first type from the active mode's type list. - Added comprehensive tests for mode loading, prompt injection, and parser integration, ensuring correct behavior across different modes. - Introduced new mode JSON files for "Code Development" and "Email Investigation" with detailed observation types and prompts. * Add mode configuration loading and update licensing information for Ragtime - Implemented loading of mode configuration in WorkerService before database initialization. - Added PolyForm Noncommercial License 1.0.0 to Ragtime directory. - Created README.md for Ragtime with licensing details and usage guidelines. * fix: add datasets directory to .gitignore to prevent accidental commits * refactor: remove unused plugin package.json file * chore: add package.json for claude-mem plugin with version 7.4.5 * refactor: remove outdated tests and improve error handling - Deleted tests for ChromaSync error handling, smart install, strip memory tags, and user prompt tag stripping due to redundancy or outdated logic. - Removed vitest configuration as it is no longer needed. - Added a comprehensive implementation plan for fixing the modes system, addressing critical issues and improving functionality. - Created a detailed test analysis report highlighting the quality and effectiveness of the current test suite, identifying areas for improvement. - Introduced a new plugin package.json for runtime dependencies related to claude-mem hooks. * refactor: remove parser regression tests to streamline codebase * docs: update CLAUDE.md to clarify test management and changelog generation * refactor: remove migration008 for mode-agnostic observations * Refactor observation type handling to use ModeManager for icons and emojis - Removed direct mappings of observation types to icons and work emojis in context-generator, FormattingService, SearchManager, and TimelineService. - Integrated ModeManager to dynamically retrieve icons and emojis based on the active mode. - Improved maintainability by centralizing the logic for observation type representation. * Refactor observation metadata constants and update context generator - Removed the explicit declaration of OBSERVATION_TYPES and OBSERVATION_CONCEPTS from observation-metadata.ts. - Introduced fallback default strings for DEFAULT_OBSERVATION_TYPES_STRING and DEFAULT_OBSERVATION_CONCEPTS_STRING. - Updated context-generator.ts to utilize observation types and concepts from ModeManager instead of constants. * refactor: remove intermediate error handling from hooks (Phase 1) Apply "fail fast" error handling strategy - errors propagate and crash loud instead of being caught, wrapped, and re-thrown at intermediate layers. Changes: - Remove try/catch around fetch calls in all hooks - let errors throw - Add try/catch ONLY around JSON.parse at entry points - Delete error-handler.ts and hook-error-handler.ts (no longer needed) - Update worker-utils.ts: functions now throw instead of returning null - Update transcript-parser.ts: throw on missing path, empty file, malformed JSON - Remove all handleWorkerError, handleFetchError imports Philosophy: If something breaks, we KNOW it broke. No silent failures. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com> * refactor: remove intermediate error handling from worker service (Phase 2) Apply "fail fast" error handling strategy to worker service layer. Changes: - worker-service.ts: Remove try/catch from version endpoint, cleanup, MCP close, process enumeration, force kill, and isAlive check - SessionRoutes.ts: Remove try/catch from JSON.stringify calls, remove .catch() from Chroma sync and SDK agent calls - SettingsRoutes.ts: Remove try/catch from toggleMcp() - DatabaseManager.ts: Remove .catch() from backfill and close operations - SDKAgent.ts: Keep outer try/catch (top-level), remove .catch() from Chroma sync operations - SSEBroadcaster.ts: Remove try/catch from broadcast and sendToClient Philosophy: Errors propagate and crash loud. BaseRouteHandler.wrapHandler provides top-level catching for HTTP routes. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com> * refactor: remove error swallowing from SQLite services (Phase 3) Apply "fail fast" error handling strategy to database layer. SessionStore.ts migrations: - ensureWorkerPortColumn(): Remove outer try/catch, let it throw - ensurePromptTrackingColumns(): Remove outer try/catch, let it throw - removeSessionSummariesUniqueConstraint(): Keep inner transaction rollback, remove outer catch - addObservationHierarchicalFields(): Remove outer try/catch - makeObservationsTextNullable(): Keep inner transaction rollback, remove outer catch - createUserPromptsTable(): Keep inner transaction rollback, remove outer catch - getFilesForSession(): Remove try/catch around JSON.parse SessionSearch.ts: - ensureFTSTables(): Remove try/catch, let it throw Philosophy: Migration errors that are swallowed mean we think the database is fine when it's not. Keep only inner transaction rollback try/catch blocks. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com> * refactor: remove error hiding from utilities (Phase 4) Apply "fail fast" error handling strategy to utility layer. logger.ts: - formatTool(): Remove try/catch, let JSON.parse throw on malformed input context-generator.ts: - loadContextConfig(): Remove try/catch, let parseInt throw on invalid settings - Transcript extraction: Remove try/catch, let file read errors propagate ChromaSync.ts: - close(): Remove nested try/catch blocks, let close errors propagate Philosophy: No silent fallbacks or hidden defaults. If something breaks, we know it broke immediately. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com> * feat: serve static UI assets and update package root path - Added middleware to serve static UI assets (JS, CSS, fonts, etc.) in ViewerRoutes. - Updated getPackageRoot function to correctly return the package root directory as one level up from the current directory. * feat: Enhance mode loading with inheritance support - Introduced parseInheritance method to handle parent--override mode IDs. - Added deepMerge method for recursively merging mode configurations. - Updated loadMode method to support inheritance, loading parent modes and applying overrides. - Improved error handling for missing mode files and logging for better traceability. * fix(modes): correct inheritance file resolution and path handling * Refactor code structure for improved readability and maintainability * feat: Add mode configuration documentation and examples * fix: Improve concurrency handling in translateReadme function * Refactor SDK prompts to enhance clarity and structure - Updated the `buildInitPrompt` and `buildContinuationPrompt` functions in `prompts.ts` to improve the organization of prompt components, including the addition of language instructions and footer messages. - Removed redundant instructions and emphasized the importance of recording observations. - Modified the `ModePrompts` interface in `types.ts` to include new properties for system identity, language instructions, and output format header, ensuring better flexibility and clarity in prompt generation. * Enhance prompts with language instructions and XML formatting - Updated `buildInitPrompt`, `buildSummaryPrompt`, and `buildContinuationPrompt` functions to include detailed language instructions in XML comments. - Ensured that language instructions guide users to keep XML tags in English while writing content in the specified language. - Modified the `buildSummaryPrompt` function to accept `mode` as a parameter for consistency. - Adjusted the call to `buildSummaryPrompt` in `SDKAgent` to pass the `mode` argument. * Refactor XML prompt generation in SDK - Updated the buildInitPrompt, buildSummaryPrompt, and buildContinuationPrompt functions to use new placeholders for XML elements, improving maintainability and readability. - Removed redundant language instructions in comments for clarity. - Added new properties to ModePrompts interface for better structure and organization of XML placeholders and section headers. * feat: Update observation prompts and structure across multiple languages * chore: Remove planning docs and update Ragtime README Remove ephemeral development artifacts: - .claude/plans/modes-system-fixes.md - .claude/test-analysis-report.md - PROMPT_INJECTION_ANALYSIS.md Update ragtime/README.md to explain: - Feature is not yet implemented - Dependency on modes system (now complete in PR #412) - Ready to be scripted out in future release 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com> * fix: Move summary prompts to mode files for multilingual support Summary prompts were hardcoded in English in prompts.ts, breaking multilingual support. Now properly mode-based: - Added summary_instruction, summary_context_label, summary_format_instruction, summary_footer to code.json - Updated buildSummaryPrompt() to use mode fields instead of hardcoded text - Added summary_footer with language instructions to all 10 language modes - Language modes keep English prompts + language requirement footer This fixes the gaslighting where we claimed full multilingual support but summaries were still generated in English. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com> * chore: Clean up README by removing local preview instructions and streamlining beta features section * Add translated README files for Ukrainian, Vietnamese, and Chinese languages * Add new language modes for code development in multiple languages - Introduced JSON configurations for Code Development in Greek, Finnish, Hebrew, Hindi, Hungarian, Indonesian, Italian, Dutch, Norwegian, Polish, Brazilian Portuguese, Romanian, Swedish, Turkish, and Ukrainian. - Each configuration includes prompts for observations, summaries, and instructions tailored to the respective language. - Ensured that all prompts emphasize the importance of generating observations without referencing the agent's actions. * Add multilingual support links to README files in various languages - Updated README.id.md, README.it.md, README.ja.md, README.ko.md, README.nl.md, README.no.md, README.pl.md, README.pt-br.md, README.ro.md, README.ru.md, README.sv.md, README.th.md, README.tr.md, README.uk.md, README.vi.md, and README.zh.md to include links to other language versions. - Each README now features a centered paragraph with flags and links for easy navigation between different language documents. --------- Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-22 20:14:18 -05:00
parent db02da148f
commit 3ea0b60b9f
141 changed files with 11834 additions and 6699 deletions
@@ -30,10 +30,8 @@ export class DatabaseManager {
    // Initialize ChromaSync
    this.chromaSync = new ChromaSync('claude-mem');

-    // Start background backfill (fire-and-forget, with error logging)
-    this.chromaSync.ensureBackfilled().catch((error) => {
-      logger.error('DB', 'Chroma backfill failed (non-fatal)', {}, error);
-    });
+    // Start background backfill (fire-and-forget)
+    this.chromaSync.ensureBackfilled();

    logger.info('DB', 'Database initialized');
  }
@@ -44,14 +42,10 @@ export class DatabaseManager {
  async close(): Promise<void> {
    // Close ChromaSync first (terminates uvx/python processes)
    if (this.chromaSync) {
-      try {
-        await this.chromaSync.close();
-        this.chromaSync = null;
-      } catch (error) {
-        logger.error('DB', 'Failed to close ChromaSync', {}, error as Error);
-      }
+      await this.chromaSync.close();
+      this.chromaSync = null;
    }
-    
+
    if (this.sessionStore) {
      this.sessionStore.close();
      this.sessionStore = null;
@@ -4,7 +4,7 @@
 */

 import { ObservationSearchResult, SessionSummarySearchResult, UserPromptSearchResult } from '../sqlite/types.js';
-import { TYPE_ICON_MAP, TYPE_WORK_EMOJI_MAP } from '../../constants/observation-metadata.js';
+import { ModeManager } from '../domain/ModeManager.js';

 // Token estimation constant (matches context-generator)
 const CHARS_PER_TOKEN_ESTIMATE = 4;
@@ -55,10 +55,10 @@ Tips:
  formatObservationIndex(obs: ObservationSearchResult, _index: number): string {
    const id = `#${obs.id}`;
    const time = this.formatTime(obs.created_at_epoch);
-    const icon = TYPE_ICON_MAP[obs.type as keyof typeof TYPE_ICON_MAP] || '•';
+    const icon = ModeManager.getInstance().getTypeIcon(obs.type);
    const title = obs.title || 'Untitled';
    const readTokens = this.estimateReadTokens(obs);
-    const workEmoji = TYPE_WORK_EMOJI_MAP[obs.type as keyof typeof TYPE_WORK_EMOJI_MAP] || '🔍';
+    const workEmoji = ModeManager.getInstance().getWorkEmoji(obs.type);
    const workTokens = obs.discovery_tokens || 0;
    const workDisplay = workTokens > 0 ? `${workEmoji} ${workTokens}` : '-';

@@ -116,7 +116,7 @@ Tips:
  formatObservationSearchRow(obs: ObservationSearchResult, lastTime: string): { row: string; time: string } {
    const id = `#${obs.id}`;
    const time = this.formatTime(obs.created_at_epoch);
-    const icon = TYPE_ICON_MAP[obs.type as keyof typeof TYPE_ICON_MAP] || '•';
+    const icon = ModeManager.getInstance().getTypeIcon(obs.type);
    const title = obs.title || 'Untitled';
    const readTokens = this.estimateReadTokens(obs);

@@ -10,7 +10,7 @@ The Worker Service is an Express HTTP server that handles all claude-mem operati
 Hook (plugin/scripts/*-hook.js)
  → HTTP Request to Worker (localhost:37777)
    → Route Handler (http/routes/*.ts)
-      → MCP Server Tool (for search) OR Domain Service (for session/data)
+      → MCP Server Tool (for search) OR Service Layer (for session/data)
        → Database (SQLite3 + Chroma vector DB)
 ```

@@ -22,13 +22,13 @@ src/services/worker/
 ├── WorkerService.ts              # Slim orchestrator (~150 lines)
 ├── http/                         # HTTP layer
 │   ├── middleware.ts             # Shared middleware (logging, CORS, etc.)
-│   └── routes/                   # Route handlers organized by domain
+│   └── routes/                   # Route handlers organized by feature area
 │       ├── SessionRoutes.ts      # Session lifecycle (init, observations, summarize, complete)
 │       ├── DataRoutes.ts         # Data retrieval (get observations, summaries, prompts, stats)
 │       ├── SearchRoutes.ts       # Search/MCP proxy (all search endpoints)
 │       ├── SettingsRoutes.ts     # Settings, MCP toggle, branch switching
 │       └── ViewerRoutes.ts       # Health check, viewer UI, SSE stream
-└── domain/                       # Business logic (existing services, NO CHANGES in Phase 1)
+└── services/                     # Business logic services (existing, NO CHANGES in Phase 1)
    ├── DatabaseManager.ts        # SQLite connection management
    ├── SessionManager.ts         # Session state tracking
    ├── SDKAgent.ts               # Claude Agent SDK for observations/summaries
@@ -46,7 +46,7 @@ src/services/worker/
 - `GET /stream` - SSE stream for real-time updates

 ### SessionRoutes.ts
-Session lifecycle operations (use domain services directly):
+Session lifecycle operations (use service layer directly):
 - `POST /sessions/init` - Initialize new session
 - `POST /sessions/:sessionId/observations` - Add tool usage observations
 - `POST /sessions/:sessionId/summarize` - Trigger session summary
@@ -58,7 +58,7 @@ Session lifecycle operations (use domain services directly):
 - `POST /sessions/claude-id/:claudeId/complete` - Complete by claude_id

 ### DataRoutes.ts
-Data retrieval operations (use domain services directly):
+Data retrieval operations (use service layer directly):
 - `GET /observations` - List observations (paginated)
 - `GET /summaries` - List session summaries (paginated)
 - `GET /prompts` - List user prompts (paginated)
@@ -91,7 +91,7 @@ All search operations (proxy to MCP server):
 - `GET /search/help` - Search help

 ### SettingsRoutes.ts
-Settings and configuration (use domain services directly):
+Settings and configuration (use service layer directly):
 - `GET /settings` - Get user settings
 - `POST /settings` - Update user settings
 - `GET /mcp/status` - Get MCP server status
@@ -109,14 +109,14 @@ Settings and configuration (use domain services directly):

 **MCP vs Direct DB Split** (inherited, not changed in Phase 1):
 - Search operations → MCP server (mem-search)
- Session/data operations → Direct DB access via domain services
+- Session/data operations → Direct DB access via service layer

 ## Future Phase 2

 Phase 2 will unify the architecture:
 1. Expand MCP server to handle ALL operations (not just search)
 2. Convert all route handlers to proxy through MCP
-3. Move database logic from domain services into MCP tools
+3. Move database logic from service layer into MCP tools
 4. Result: Worker becomes pure HTTP → MCP proxy for maximum portability

 This separation allows the worker to be deployed anywhere (as a CLI tool, cloud service, etc.) without carrying database dependencies.
@@ -126,7 +126,7 @@ This separation allows the worker to be deployed anywhere (as a CLI tool, cloud
 1. Choose the appropriate route file based on the endpoint's purpose
 2. Add the route handler method to the class
 3. Register the route in the `setupRoutes()` method
-4. Import any needed domain services in the constructor
+4. Import any needed services in the constructor
 5. Follow the existing patterns for error handling and logging

 Example:
@@ -149,7 +149,7 @@ app.get('/foo', this.handleGetFoo.bind(this));
 ## Key Design Principles

 1. **Progressive Disclosure**: Navigate from high-level (WorkerService.ts) to specific routes to implementation details
-2. **Single Responsibility**: Each route class handles one domain area
+2. **Single Responsibility**: Each route class handles one feature area
 3. **Dependency Injection**: Route classes receive only the services they need
 4. **Consistent Error Handling**: All handlers use try/catch with logger.failure()
 5. **Bound Methods**: All route handlers use `.bind(this)` to preserve context
@@ -19,6 +19,7 @@ import { buildInitPrompt, buildObservationPrompt, buildSummaryPrompt, buildConti
 import { SettingsDefaultsManager } from '../../shared/SettingsDefaultsManager.js';
 import { USER_SETTINGS_PATH } from '../../shared/paths.js';
 import type { ActiveSession, SDKUserMessage, PendingMessage } from '../worker-types.js';
+import { ModeManager } from '../domain/ModeManager.js';

 // Import Agent SDK (assumes it's installed)
 // @ts-ignore - Agent SDK types may not be available
@@ -185,6 +186,9 @@ export class SDKAgent {
   * - We just use the session_id we're given - simple and reliable
   */
  private async *createMessageGenerator(session: ActiveSession): AsyncIterableIterator<SDKUserMessage> {
+    // Load active mode
+    const mode = ModeManager.getInstance().getActiveMode();
+
    // Yield initial user prompt with context (or continuation if prompt #2+)
    // CRITICAL: Both paths use session.claudeSessionId from the hook
    yield {
@@ -192,8 +196,8 @@ export class SDKAgent {
      message: {
        role: 'user',
        content: session.lastPromptNumber === 1
-          ? buildInitPrompt(session.project, session.claudeSessionId, session.userPrompt)
-          : buildContinuationPrompt(session.userPrompt, session.lastPromptNumber, session.claudeSessionId)
+          ? buildInitPrompt(session.project, session.claudeSessionId, session.userPrompt, mode)
+          : buildContinuationPrompt(session.userPrompt, session.lastPromptNumber, session.claudeSessionId, mode)
      },
      session_id: session.claudeSessionId,
      parent_tool_use_id: null,
@@ -237,7 +241,7 @@ export class SDKAgent {
              user_prompt: session.userPrompt,
              last_user_message: message.last_user_message || '',
              last_assistant_message: message.last_assistant_message || ''
-            })
+            }, mode)
          },
          session_id: session.claudeSessionId,
          parent_tool_use_id: null,
@@ -276,7 +280,7 @@ export class SDKAgent {
        concepts: obs.concepts?.length ?? 0
      });

-      // Sync to Chroma with error logging
+      // Sync to Chroma
      const chromaStart = Date.now();
      const obsType = obs.type;
      const obsTitle = obs.title || '(untitled)';
@@ -296,13 +300,6 @@ export class SDKAgent {
          type: obsType,
          title: obsTitle
        });
-      }).catch(err => {
-        logger.error('CHROMA', 'Failed to sync observation', {
-          obsId,
-          sessionId: session.sessionDbId,
-          type: obsType,
-          title: obsTitle
-        }, err);
      });

      // Broadcast to SSE clients (for web UI)
@@ -352,7 +349,7 @@ export class SDKAgent {
        hasNextSteps: !!summary.next_steps
      });

-      // Sync to Chroma with error logging
+      // Sync to Chroma
      const chromaStart = Date.now();
      const summaryRequest = summary.request || '(no request)';
      this.dbManager.getChromaSync().syncSummary(
@@ -370,12 +367,6 @@ export class SDKAgent {
          duration: `${chromaDuration}ms`,
          request: summaryRequest
        });
-      }).catch(err => {
-        logger.error('CHROMA', 'Failed to sync summary', {
-          summaryId,
-          sessionId: session.sessionDbId,
-          request: summaryRequest
-        }, err);
      });

      // Broadcast to SSE clients (for web UI)
@@ -53,15 +53,9 @@ export class SSEBroadcaster {

    logger.debug('WORKER', 'SSE broadcast sent', { eventType: event.type, clients: this.sseClients.size });

-    // Single-pass write + cleanup
+    // Single-pass write
    for (const client of this.sseClients) {
-      try {
-        client.write(data);
-      } catch (err) {
-        // Remove failed client immediately
-        this.sseClients.delete(client);
-        logger.debug('WORKER', 'Client removed due to write error');
-      }
+      client.write(data);
    }
  }

@@ -77,10 +71,6 @@ export class SSEBroadcaster {
   */
  private sendToClient(res: Response, event: SSEEvent): void {
    const data = `data: ${JSON.stringify(event)}\n\n`;
-    try {
-      res.write(data);
-    } catch (err) {
-      this.sseClients.delete(res);
-    }
+    res.write(data);
  }
 }
@@ -15,6 +15,7 @@ import { TimelineService, TimelineItem } from './TimelineService.js';
 import { ObservationSearchResult, SessionSummarySearchResult, UserPromptSearchResult } from '../sqlite/types.js';
 import { logger } from '../../utils/logger.js';
 import { formatDate, formatTime, formatDateTime, extractFirstFile, groupByDate, estimateTokens } from '../../shared/timeline-formatting.js';
+import { ModeManager } from '../domain/ModeManager.js';

 const COLLECTION_NAME = 'cm__claude-mem';
 const RECENCY_WINDOW_DAYS = 90;
@@ -590,15 +591,7 @@ export class SearchManager {
                lastTime = '';
              }

-              let icon = '•';
-              switch (obs.type) {
-                case 'bugfix': icon = '🔴'; break;
-                case 'feature': icon = '🟣'; break;
-                case 'refactor': icon = '🔄'; break;
-                case 'change': icon = '✅'; break;
-                case 'discovery': icon = '🔵'; break;
-                case 'decision': icon = '🧠'; break;
-              }
+              const icon = ModeManager.getInstance().getTypeIcon(obs.type);

              const time = formatTime(item.epoch);
              const title = obs.title || 'Untitled';
@@ -1675,15 +1668,7 @@ export class SearchManager {
              }

              // Map observation type to emoji
-              let icon = '•';
-              switch (obs.type) {
-                case 'bugfix': icon = '🔴'; break;
-                case 'feature': icon = '🟣'; break;
-                case 'refactor': icon = '🔄'; break;
-                case 'change': icon = '✅'; break;
-                case 'discovery': icon = '🔵'; break;
-                case 'decision': icon = '🧠'; break;
-              }
+              const icon = ModeManager.getInstance().getTypeIcon(obs.type);

              const time = formatTime(item.epoch);
              const title = obs.title || 'Untitled';
@@ -1927,15 +1912,7 @@ export class SearchManager {
                }

                // Map observation type to emoji
-                let icon = '•';
-                switch (obs.type) {
-                  case 'bugfix': icon = '🔴'; break;
-                  case 'feature': icon = '🟣'; break;
-                  case 'refactor': icon = '🔄'; break;
-                  case 'change': icon = '✅'; break;
-                  case 'discovery': icon = '🔵'; break;
-                  case 'decision': icon = '🧠'; break;
-                }
+                const icon = ModeManager.getInstance().getTypeIcon(obs.type);

                const time = formatTime(item.epoch);
                const title = obs.title || 'Untitled';
@@ -4,6 +4,7 @@
 */

 import { ObservationSearchResult, SessionSummarySearchResult, UserPromptSearchResult } from '../sqlite/types.js';
+import { ModeManager } from '../domain/ModeManager.js';

 /**
 * Timeline item for unified chronological display
@@ -210,15 +211,7 @@ export class TimelineService {
   * Get icon for observation type
   */
  private getTypeIcon(type: string): string {
-    switch (type) {
-      case 'bugfix': return '🔴';
-      case 'feature': return '🟣';
-      case 'refactor': return '🔄';
-      case 'change': return '✅';
-      case 'discovery': return '🔵';
-      case 'decision': return '🧠';
-      default: return '•';
-    }
+    return ModeManager.getInstance().getTypeIcon(type);
  }

  /**
@@ -2,7 +2,7 @@
 * Data Routes
 *
 * Handles data retrieval operations: observations, summaries, prompts, stats, processing status.
- * All endpoints use direct database access via domain services.
+ * All endpoints use direct database access via service layer.
 */

 import express, { Request, Response } from 'express';
@@ -51,9 +51,6 @@ export class SessionRoutes extends BaseRouteHandler {
      });

      session.generatorPromise = this.sdkAgent.startSession(session, this.workerService)
-        .catch(err => {
-          logger.failure('SDK', 'SDK agent error', { sessionId: sessionDbId }, err);
-        })
        .finally(() => {
          logger.info('SESSION', `Generator finished`, { sessionId: sessionDbId });
          session.generatorPromise = null;
@@ -102,7 +99,7 @@ export class SessionRoutes extends BaseRouteHandler {
        created_at_epoch: latestPrompt.created_at_epoch
      });

-      // Sync user prompt to Chroma with error logging
+      // Sync user prompt to Chroma
      const chromaStart = Date.now();
      const promptText = latestPrompt.prompt_text;
      this.dbManager.getChromaSync().syncUserPrompt(
@@ -122,11 +119,6 @@ export class SessionRoutes extends BaseRouteHandler {
          duration: `${chromaDuration}ms`,
          prompt: truncatedPrompt
        });
-      }).catch(err => {
-        logger.error('CHROMA', 'Failed to sync user_prompt', {
-          promptId: latestPrompt.id,
-          sessionId: sessionDbId
-        }, err);
      });
    }

@@ -138,9 +130,6 @@ export class SessionRoutes extends BaseRouteHandler {
    });

    session.generatorPromise = this.sdkAgent.startSession(session, this.workerService)
-      .catch(err => {
-        logger.failure('SDK', 'SDK agent error', { sessionId: sessionDbId }, err);
-      })
      .finally(() => {
        // Clear generator reference when completed
        logger.info('SESSION', `Generator finished`, { sessionId: sessionDbId });
@@ -309,26 +298,13 @@ export class SessionRoutes extends BaseRouteHandler {
    }

    // Strip memory tags from tool_input and tool_response
-    let cleanedToolInput = '{}';
-    let cleanedToolResponse = '{}';
+    const cleanedToolInput = tool_input !== undefined
+      ? stripMemoryTagsFromJson(JSON.stringify(tool_input))
+      : '{}';

-    try {
-      cleanedToolInput = tool_input !== undefined
-        ? stripMemoryTagsFromJson(JSON.stringify(tool_input))
-        : '{}';
-    } catch (error) {
-      logger.debug('SESSION', 'Failed to serialize tool_input', { sessionDbId }, error);
-      cleanedToolInput = '{"error": "Failed to serialize tool_input"}';
-    }
-
-    try {
-      cleanedToolResponse = tool_response !== undefined
-        ? stripMemoryTagsFromJson(JSON.stringify(tool_response))
-        : '{}';
-    } catch (error) {
-      logger.debug('SESSION', 'Failed to serialize tool_result', { sessionDbId }, error);
-      cleanedToolResponse = '{"error": "Failed to serialize tool_response"}';
-    }
+    const cleanedToolResponse = tool_response !== undefined
+      ? stripMemoryTagsFromJson(JSON.stringify(tool_response))
+      : '{}';

    // Queue observation
    this.sessionManager.queueObservation(sessionDbId, {
@@ -13,12 +13,7 @@ import { getPackageRoot } from '../../../../shared/paths.js';
 import { logger } from '../../../../utils/logger.js';
 import { SettingsManager } from '../../SettingsManager.js';
 import { getBranchInfo, switchBranch, pullUpdates } from '../../BranchManager.js';
-import {
-  OBSERVATION_TYPES,
-  OBSERVATION_CONCEPTS,
-  ObservationType,
-  ObservationConcept
-} from '../../../../constants/observation-metadata.js';
+import { ModeManager } from '../../domain/ModeManager.js';
 import { BaseRouteHandler } from '../BaseRouteHandler.js';
 import { SettingsDefaultsManager } from '../../../../shared/SettingsDefaultsManager.js';
 import { clearPortCache } from '../../../../shared/worker-utils.js';
@@ -296,25 +291,11 @@ export class SettingsRoutes extends BaseRouteHandler {
      }
    }

-    // Validate observation types
-    if (settings.CLAUDE_MEM_CONTEXT_OBSERVATION_TYPES) {
-      const types = settings.CLAUDE_MEM_CONTEXT_OBSERVATION_TYPES.split(',').map((t: string) => t.trim());
-      for (const type of types) {
-        if (type && !OBSERVATION_TYPES.includes(type as ObservationType)) {
-          return { valid: false, error: `Invalid observation type: ${type}. Valid types: ${OBSERVATION_TYPES.join(', ')}` };
-        }
-      }
-    }
+    // Skip observation types validation - any type string is valid since modes define their own types
+    // The database accepts any TEXT value, and mode-specific validation happens at parse time

-    // Validate observation concepts
-    if (settings.CLAUDE_MEM_CONTEXT_OBSERVATION_CONCEPTS) {
-      const concepts = settings.CLAUDE_MEM_CONTEXT_OBSERVATION_CONCEPTS.split(',').map((c: string) => c.trim());
-      for (const concept of concepts) {
-        if (concept && !OBSERVATION_CONCEPTS.includes(concept as ObservationConcept)) {
-          return { valid: false, error: `Invalid observation concept: ${concept}. Valid concepts: ${OBSERVATION_CONCEPTS.join(', ')}` };
-        }
-      }
-    }
+    // Skip observation concepts validation - any concept string is valid since modes define their own concepts
+    // The database accepts any TEXT value, and mode-specific validation happens at parse time

    return { valid: true };
  }
@@ -332,25 +313,20 @@ export class SettingsRoutes extends BaseRouteHandler {
   * Toggle MCP search server (rename .mcp.json <-> .mcp.json.disabled)
   */
  private toggleMcp(enabled: boolean): void {
-    try {
-      const packageRoot = getPackageRoot();
-      const mcpPath = path.join(packageRoot, 'plugin', '.mcp.json');
-      const mcpDisabledPath = path.join(packageRoot, 'plugin', '.mcp.json.disabled');
+    const packageRoot = getPackageRoot();
+    const mcpPath = path.join(packageRoot, 'plugin', '.mcp.json');
+    const mcpDisabledPath = path.join(packageRoot, 'plugin', '.mcp.json.disabled');

-      if (enabled && existsSync(mcpDisabledPath)) {
-        // Enable: rename .mcp.json.disabled -> .mcp.json
-        renameSync(mcpDisabledPath, mcpPath);
-        logger.info('WORKER', 'MCP search server enabled');
-      } else if (!enabled && existsSync(mcpPath)) {
-        // Disable: rename .mcp.json -> .mcp.json.disabled
-        renameSync(mcpPath, mcpDisabledPath);
-        logger.info('WORKER', 'MCP search server disabled');
-      } else {
-        logger.debug('WORKER', 'MCP toggle no-op (already in desired state)', { enabled });
-      }
-    } catch (error) {
-      logger.failure('WORKER', 'Failed to toggle MCP', { enabled }, error as Error);
-      throw error;
+    if (enabled && existsSync(mcpDisabledPath)) {
+      // Enable: rename .mcp.json.disabled -> .mcp.json
+      renameSync(mcpDisabledPath, mcpPath);
+      logger.info('WORKER', 'MCP search server enabled');
+    } else if (!enabled && existsSync(mcpPath)) {
+      // Disable: rename .mcp.json -> .mcp.json.disabled
+      renameSync(mcpPath, mcpDisabledPath);
+      logger.info('WORKER', 'MCP search server disabled');
+    } else {
+      logger.debug('WORKER', 'MCP toggle no-op (already in desired state)', { enabled });
    }
  }

@@ -24,6 +24,10 @@ export class ViewerRoutes extends BaseRouteHandler {
  }

  setupRoutes(app: express.Application): void {
+    // Serve static UI assets (JS, CSS, fonts, etc.)
+    const packageRoot = getPackageRoot();
+    app.use(express.static(path.join(packageRoot, 'ui')));
+
    app.get('/health', this.handleHealth.bind(this));
    app.get('/', this.handleViewerUI.bind(this));
    app.get('/stream', this.handleSSEStream.bind(this));