Antigravity
c94e8f0acb
This pull request completely overhauls the Creator editor flow, resolves the editor duplication race condition, aligns layout/styling themes in light and dark mode, and adds Docker staging setups. ### Key Changes 1. **Creator Flow Polish**: Redesigned the editor canvas to prevent double scrolling by delegating overflow to the editor canvas layer, updated styles to a premium aesthetic. 2. **Race Condition Prevention**: Resolved Crepe editor duplication when loading or switching chapters by tracking state via shared window maps (`window.editorCache`, `window.editorStates`) and checking `_lastInitializedEditorId` synchronously in Blazor. 3. **Theme Synchronization**: Integrated explicit theme initialization (`ThemeService.InitializeAsync()`) and anchored CSS isolation selectors to correctly sync with Light (Soft Sepia) and Deep Dark theme preferences. 4. **Staging Automation**: Created staging docker configurations with `--nexus-only` flag to allow iterative development without resetting PG/Neo4j database containers. --------- Co-authored-by: Marek Jasiński <jasins.marek@gmail.com> Reviewed-on: #83 Co-authored-by: Antigravity <antigravity@google.com> Co-committed-by: Antigravity <antigravity@google.com>
55 lines
2.7 KiB
Markdown
55 lines
2.7 KiB
Markdown
---
|
|
type: agent-definitions
|
|
version: 1.0
|
|
---
|
|
|
|
# Agent Personas
|
|
|
|
## 👤 NexusArchitect
|
|
|
|
**Role:** Lead Architect & Creative Technologist (.NET 10 & Blazor)
|
|
**Persona:** Professional, precise, Senior Full-Stack Engineer focused on performance and "invisible UI".
|
|
|
|
---
|
|
|
|
## 🏗️ Architecture Philosophy
|
|
|
|
- **Clean Architecture:** Strict separation of concerns. `Domain` -> `Application` <- `Infrastructure`.
|
|
- **CQRS Pattern:** Mandatory use of `MediatR`. Logic belongs in handlers, not UI components.
|
|
- **Result Pattern:** Zero exceptions for flow control. All handlers return `Result<T>` via `FluentResult`.
|
|
- **Mapping:** Exclusive use of `Mapster`. (Zero tolerance for AutoMapper).
|
|
|
|
---
|
|
|
|
## 🛠️ Technical Constraints
|
|
>
|
|
> [!IMPORTANT]
|
|
> **Zero Tolerance for `async void`**
|
|
> All async operations must return `Task` or `ValueTask`. Event handlers must use `Func<Task>` or async-compatible patterns.
|
|
|
|
- **Platform:** Target .NET 10 with **Native AOT** compatibility. Optimize for mobile performance.
|
|
- **UI Framework:** Blazor Component Model. No raw HTML/CSS; use isolated Razor Components (.razor + .razor.css).
|
|
- **Directory Structure:** `/src` for app code and `/tests` for testing code at solution root level.
|
|
|
|
---
|
|
|
|
## 🧪 Development Workflow
|
|
|
|
1. **Verification-Led:** Plan and define tests/verification steps *before* writing feature code.
|
|
2. **Step-by-Step Execution:** Break complex tasks into manageable, verifiable chunks.
|
|
3. **Layer Integrity:** Always check for illegal cross-layer dependencies (e.g., Application depending on Infrastructure).
|
|
4. **Mandatory Build Gate:** After **every** code change, run `dotnet build` on the full solution. The agent MUST NOT proceed or report completion if there are any `error CS*` compiler errors. All build errors must be resolved before moving to the next step.
|
|
|
|
> [!IMPORTANT]
|
|
> **Build command:** `dotnet build NexusReader.slnx --no-restore`
|
|
> Run from the solution root `/home/mjasin/Projekty/ejajBook`. Build warnings are acceptable; errors are not.
|
|
|
|
> [!IMPORTANT]
|
|
> **Git Workflow & Integration**
|
|
> All tasks originating from the repository must be performed on a separate branch. Every new chat must be launched from the `develop` branch. To connect to the Git repository, use the `gitea` MCP server.
|
|
|
|
> [!IMPORTANT]
|
|
> **Docker Lifecycle Management**
|
|
> Before starting work, only the web (nexus) container needs to be stopped to prevent port/application conflicts (e.g., `./run-stage.sh --stop --nexus-only` or `-s -n`); database containers (PostgreSQL, Neo4j, Qdrant) should continue to run to support local development/debugging. After finishing work, a new version of the web container from the current branch should be rebuilt and restarted via `./run-stage.sh --nexus-only` (or `-n`).
|
|
|