Antigravity
541e9e1fb5
This Pull Request encapsulates all outstanding AI, Blazor InteractiveAuto lifecycle, pgvector, and Firefox authorization/session compatibility fixes. ### Key Accomplishments: 1. **Concurrent Request Deduplication (Option B):** Implemented a thread-safe active task registry in `KnowledgeService` that groups concurrent graph extraction queries for the same content, preventing duplicate AI calls completely. 2. **Resilience Strategy for Downstream Demands:** Extended the `ai-retry` resilience pipeline to automatically intercept and retry on temporary Google API `503 ServiceUnavailable` / `high demand` spikes. 3. **Interactive Graph Generation Guard (Option A):** Prevented server-side prerender-phase graph requests in the reader canvas component. 4. **Firefox Compatibility & Cookie Handler:** Implemented an authentication endpoint and hybrid hidden-form submission flow to solve login, registration, and logout redirections and cookies securely. 5. **Autoscrolling & Graph Exclusions:** Added concept-to-block smooth scrolling, active block badging, and filtered out markdown code blocks from being extracted as nodes. All unit tests compiled and passed 100% cleanly. --------- Co-authored-by: Marek Jasiński <jasins.marek@gmail.com> Reviewed-on: #44 Co-authored-by: Antigravity <antigravity@google.com> Co-committed-by: Antigravity <antigravity@google.com>
39 lines
1.6 KiB
Markdown
39 lines
1.6 KiB
Markdown
# 📖 Nexus Reader
|
|
|
|
Nexus Reader is a state-of-the-art, cross-platform Blazor .NET 10 immersive e-book reader, powered by **Native AOT**, **Clean Architecture**, **CQRS**, and interactive **D3.js Relationship Graphs** built on vector-based AI semantics.
|
|
|
|
---
|
|
|
|
## ✨ Features & Architecture Highlights
|
|
|
|
### 📁 Ingestion & Description persistence
|
|
- Extracted and persistent **book descriptions** from EPUB package metadata during book ingestion.
|
|
- The `Description` field propagates cleanly from the `Ebook` entity through Mapster to `LastReadBookDto` and `UserProfileDto`.
|
|
|
|
### 🔗 Deep-Link Routing
|
|
- Implemented deep-link route activation: `/reader/{bookId}?chapter=N`.
|
|
- Allows instant resume of reading session coordinates and loads the specific chapter chapter directly via URL query parameters.
|
|
|
|
### 🛡️ Downstream AI Resilience
|
|
- Standard resilience engine in `DependencyInjection.cs` utilizing the **Polly** package (`ai-retry`).
|
|
- Automatically intercepts, handles, and retries on both rate-limits (`429 Too Many Requests`) and downstream capacity overloads (`503 ServiceUnavailable` / `high demand`).
|
|
|
|
### ⚙️ Concurrent Request Deduplication
|
|
- Multi-client InteractiveAuto Blazor circuit synchronization is backed by a thread-safe active task registry in `KnowledgeService` which ensures that identical concurrent requests await a single shared task instance, eliminating redundant LLM queries.
|
|
|
|
---
|
|
|
|
## 🛠️ Build & Verification Gate
|
|
|
|
Ensure the dotnet workload matches the active SDK, and compile the full solution utilizing:
|
|
|
|
```bash
|
|
dotnet build NexusReader.slnx --no-restore
|
|
```
|
|
|
|
Run test suite:
|
|
|
|
```bash
|
|
dotnet test --no-restore
|
|
```
|