updates CLAUDE.md files

Author: DenizOkcu

CLAUDE.md

@@ -1,68 +1,70 @@
 # CLAUDE.md
 
-This file provides guidance to Claude Code when working with code in this repository.
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
 
 ## Project Overview
 
 ChatGPT MD is an Obsidian plugin that integrates multiple AI providers (OpenAI, OpenRouter, Anthropic, Gemini, Ollama, LM Studio) into Obsidian for seamless chat interactions within markdown notes. Users can have AI conversations directly in their notes, with support for note linking, streaming responses, and per-note configuration via frontmatter.
 
-## v3.0.0 Release - Privacy-First AI Tool Calling
+## v3.0.0 - Privacy-First AI Tool Calling
 
-**Latest Release**: v3.0.0 (December 2025)
-
-Major new feature: **Privacy-first AI tool calling** with human-in-the-loop approval:
+Major feature: **Privacy-first AI tool calling** with human-in-the-loop approval:
 
 - **Vault Search**: AI can search your notes (you approve which files to share)
 - **File Reading**: AI can request access to specific files (you select which ones)
 - **Web Search**: AI can search the web via Brave Search API (1,000 free queries/month)
 - **Three-Layer Approval**: Approve execution → Review results → Select what to share
-- **All tools disabled by default** (opt-in feature only)
-
-See [`planning/code-review/`](planning/code-review/) for comprehensive code review and implementation guidance.
+- **All tools disabled by default** (opt-in via Settings → ChatGPT MD → Tool Calling)
 
 ## Quick Reference
 
 **Entry point**: `src/main.ts` → `main.js`
 
-**Common commands**:
+**Commands**:
 
 ```bash
 npm run dev        # Development with watch mode
 npm run build      # Production build with TypeScript checks
 npm run lint       # Check code quality
 npm run lint:fix   # Auto-fix linting issues
+npm run analyze    # Bundle size analysis
 ```
 
+**No test suite**: This project does not currently have automated tests.
+
 ## Architecture Overview
 
-The plugin uses **Service Locator pattern** for dependency injection:
+The plugin uses **constructor injection** via `ServiceContainer`:
 
-- `src/core/ServiceLocator.ts` - Central DI container
-- `src/core/CommandRegistry.ts` - Manages all Obsidian commands
-- AI services implement `IAiApiService` interface
+- `src/core/ServiceContainer.ts` - DI container with readonly service instances
+- `src/Commands/` - Command handlers (extracted from old CommandRegistry)
+- `src/Services/AiProviderService.ts` - Unified AI service with adapter pattern
 
-**Message flow**: User command → EditorService extracts messages → MessageService parses → AI service calls API → Response streamed to editor
+**AI SDK**: Uses Vercel AI SDK (`ai` package) with provider-specific adapters (`@ai-sdk/openai`, `@ai-sdk/anthropic`, `@ai-sdk/google`, `@openrouter/ai-sdk-provider`).
+
+**Message flow**: User command → EditorService extracts messages → MessageService parses → AiProviderService calls API → Response streamed to editor
 
 ## Code Organization
 
-Each directory has its own CLAUDE.md with detailed context that auto-loads when you work in that area:
+Each directory has its own CLAUDE.md with detailed context:
 
-- `src/core/` - Core infrastructure (ServiceLocator, CommandRegistry)
-- `src/Services/` - Service implementations
-- `src/Views/` - UI components
+- `src/core/` - ServiceContainer (DI)
+- `src/Commands/` - Obsidian command handlers
+- `src/Services/` - Service implementations + `Adapters/` subdirectory
+- `src/Views/` - UI components and modals
 - `src/Models/` - TypeScript interfaces
+- `src/Types/` - AI service type definitions
+- `src/Utilities/` - Pure helper functions
 
 ## Cross-cutting Documentation
 
-For topics that span multiple areas:
-
 - **[docs/development.md](docs/development.md)** - Build process, tooling, esbuild setup
 - **[docs/message-flow.md](docs/message-flow.md)** - Complete flow from user input to AI response
 
 ## Key Design Patterns
 
-1. **Service Locator** - Centralized dependency injection
-2. **Strategy Pattern** - Different AI services, same interface
+1. **Constructor Injection** - Dependencies passed via ServiceContainer
+2. **Adapter Pattern** - Provider-specific adapters implement common interface
 3. **Frontmatter-driven config** - Per-note settings override globals
-4. **Streaming responses** - Real-time AI output with SSE
+4. **Streaming responses** - Real-time AI output via Vercel AI SDK
 5. **Link context injection** - Auto-include `[[Wiki Links]]` in prompts

src/Commands/CLAUDE.md

@@ -0,0 +1,113 @@
+# Commands
+
+Obsidian command handlers extracted from the old `CommandRegistry.ts`.
+
+## Architecture
+
+Commands follow a handler pattern with interfaces defined in `CommandHandler.ts`:
+
+```typescript
+interface CommandHandler {
+  getCommand(): CommandMetadata; // { id, name, icon }
+}
+
+interface EditorCommandHandler extends CommandHandler {
+  execute(editor: Editor): void | Promise<void>;
+}
+
+interface EditorViewCommandHandler extends CommandHandler {
+  execute(editor: Editor, view: MarkdownView): void | Promise<void>;
+}
+
+interface CallbackCommandHandler extends CommandHandler {
+  execute(): void | Promise<void>;
+}
+```
+
+## CommandRegistrar.ts
+
+**Utility for simplifying command registration**
+
+Reduces boilerplate in `main.ts`:
+
+```typescript
+const registrar = new CommandRegistrar(plugin);
+registrar.registerEditorCommand(chatHandler);
+registrar.registerEditorViewCommand(inferTitleHandler);
+registrar.registerCallbackCommand(stopStreamingHandler);
+```
+
+## Main Handlers
+
+### ChatHandler.ts
+
+**Main chat command** - The primary command users invoke.
+
+Flow:
+
+1. Get messages from editor via EditorService
+2. Parse frontmatter for model/settings
+3. Get appropriate AI service from AiProviderService
+4. Call AI API with messages + config
+5. Stream response to editor
+6. Optional auto title inference
+
+Uses `ServiceContainer` for dependency injection.
+
+### ModelSelectHandler.ts
+
+**Model selection modal**
+
+- Opens model selection modal
+- Fetches fresh models from all configured providers
+- Updates note frontmatter when selected
+
+### InferTitleHandler.ts
+
+**Generate title from conversation**
+
+- Calls AI to suggest title based on messages
+- Renames note file with inferred title
+- Validates title (no special characters)
+
+### StopStreamingHandler.ts
+
+**Abort in-progress streaming**
+
+- Calls `aiService.stopStreaming()`
+- Desktop only (uses abort controller)
+
+## Utility Handlers
+
+### SimpleHandlers.ts
+
+Simple one-liner commands:
+
+- **AddDividerHandler** - Inserts `<hr class="__chatgpt_plugin">`
+- **AddCommentBlockHandler** - Inserts comment block markers
+- **ClearChatHandler** - Removes messages, keeps frontmatter
+
+### RemainingHandlers.ts
+
+Additional commands:
+
+- **NewChatWithHighlightedTextHandler** - Create chat from selection
+- **ChooseChatTemplateHandler** - Create chat from template
+
+## CommandUtilities.ts
+
+**Shared utilities for command handlers**
+
+- `getAiApiUrls(frontmatter)` - Get service URLs from merged frontmatter
+- Status bar helpers
+
+## StatusBarManager
+
+Reusable status bar management:
+
+```typescript
+class StatusBarManager {
+  setText(text: string): void;
+  clear(): void;
+}
+```