qwai-tech_obsidian-plugin-i.../docs/README.md
Leon Ward 99c52d6ed1 refactor: comprehensive architectural cleanup and bug fixes
Phase 1 — Dead code & bugs:
- Delete 3 zombie services (LLMService, RAGService, MemoryService)
- Delete 2 dead components (ChatViewComponent, MessageListComponent)
- Delete ProviderRegistry (unused, referenced non-existent methods)
- Delete embedding-worker.ts (hash-based pseudo-embeddings)
- Delete base-provider.interface.ts (dual type system, merged into types/common/llm.ts)
- Delete think.ts (orphan type, never used)
- Fix Brave/Mojeek search returning zero results due to wrong type casts
- Fix Tavily search type name

Phase 2 — Feature cleanup:
- Remove RAG unimplemented UI options (MMR, hybrid, compression, caching, re-ranking)
- Remove DOMParser-based search providers (DuckDuckGo, Yahoo, Yandex)
- Remove 1194-line commented CSS block from chat-view.ts

Phase 2.5 — Quality:
- Rename domain Message class -> MessageEntity (avoid naming conflict)
- Extract deepClone to shared utility (type-guards.ts)
- Fix pluginSettingsToUserConfig dropping provider list on round-trip
- Add _writeLock to ConversationStorageService for concurrency safety
- Remove SAP AI Core false embedding capability claim
- Extract 4 inline modal classes from chat-view.ts to modals/
- Agent templates: replace hardcoded OpenAI models with default strategy

Phase 3 — Architecture:
- Unify dual ILLMProvider type systems -> types/common/llm.ts
- Add native function calling support (OpenAI provider: tool accumulator + delta parsing)
- Add toolCalls to StreamChunk/ParsedStreamChunk types
- Wire executeAgentLoop to use native tools with text-fallback
- Implement ChatController.generateResponse() (was hollow stub)
- Add generateConversationTitle/Icon to ChatService
- Wire agent config fields that were dead: contextWindow, reactEnabled, reactMaxSteps

Other:
- Bump version to 0.0.3
- Update README and docs to reflect current feature state
- Clean up outdated task documentation
- Update vault path for dev deployment

51 files changed, +1071 -4682

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-19 10:23:52 +08:00

1.3 KiB

Intelligence Assistant — Documentation

This folder contains all documentation for the Intelligence Assistant Obsidian plugin.

Contents

Path Description
architecture/overview-en.md Architecture overview (English)
architecture/overview-zh.md Architecture overview (Chinese)
project/project-guide-en.md Developer-oriented project guide (English)
project/project-guide-zh.md Developer-oriented project guide (Chinese)
reference/project-structure.md Full annotated source tree
reference/api.md Internal API reference (core layer)

Quick orientation

  • Main README: ../README.md — user-facing feature docs and quick start
  • Source: ../src/ — all TypeScript source under six top-level namespaces: core, domain, application, infrastructure, presentation, types
  • Entry point: ../main.ts — Obsidian plugin bootstrap
  • Styles: ../styles.css — all CSS (auto-loaded by Obsidian)

Adding new docs

Place new documents in the most appropriate subfolder and add a link to the table above so they can be discovered.