vrr/Aventuras
2
0
Fork 0
mirror of https://github.com/AventurasTeam/Aventuras.git synced 2026-08-22 23:43:19 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 1
Aventuras/docs
History
Exact
Pento 8ae0d79a0d
Image markers, database transactions, and the classifier's read of a scene (#445) 
* **New Features**
* Added MP3/WAV selection for OpenAI-compatible text-to-speech services.
* Added configurable recent-entry context for world-state
classification.
* Added image-generation availability checks for background, portrait,
and reference images.
  * Added lore-management error banners with retry and dismiss actions.
  * Improved character presence tracking and duplicate-entry handling.

* **Bug Fixes**
* Improved inline-image retries, recovery, rendering safety, and
generation limits.
* Improved atomic updates for runtime variables and database
transactions.
* Improved prompt formatting, text matching, and narrator-markup
handling
2026-08-16 09:27:47 +02:00
..
architecture Image markers, database transactions, and the classifier's read of a scene (#445) 2026-08-16 09:27:47 +02:00
development Lore management: a session ledger, a shared chapter-read budget, and a duplicate consolidation window (#437) 2026-08-12 15:32:41 +02:00
README.md Lore management: a session ledger, a shared chapter-read budget, and a duplicate consolidation window (#437) 2026-08-12 15:32:41 +02:00

README.md

Aventuras — internal documentation

How the app is put together and why it is put together that way. The user-facing page is the repository README; this is for whoever is changing the code.

These documents carry the reasoning that does not fit in a comment: the measured numbers, the failure a design exists to prevent, the two things that must stay in step. Code comments stay short and say only what the next reader cannot infer — see CLAUDE.md.

Architecture

Document Read it before touching
overview.md the repository layout, StoryEntry/branches/chapters/world state, or the generation pipeline and its phases
context-injection.md services/ai/retrieval/, WorldStateInjector, the three tiers, stickiness, agentic or static memory retrieval
lore-management.md services/ai/lorebook/, services/duplicates/, LoreManagementCoordinator, the duplicates window
prompts.md anything under services/prompts/templates/, prompt packs, or the order blocks are assembled in
ai-services.md adding a ServiceId, agent profiles, reasoning effort, or a default in ai/core/defaults.ts
persistence.md SQLite, a new migration, src-tauri/src/, or the shape of the settings blob
dialogue-and-tts.md utils/dialogue.ts, dialogue highlighting, or the TTS pipeline

Development

Document Read it before
testing.md writing a test — the suite has real constraints on what it can import
release.md cutting a release, or changing the updater, CI or the build scripts

Keeping them true

If a change alters behaviour a document describes, update the document in the same commit. A document nobody trusts costs more than no document: the numbers in these files were measured, and a stale one is read as a measurement.