Changelog.

• src/infrastructure/codex-cli/CodexCliClient.ts — Added '--enable', 'standalone_web_search' to the args array in runCodexAttempt()

• src/infrastructure/ollama-cli/WebSearcher.ts — DuckDuckGo HTML-based web search executor
• src/infrastructure/ollama-cli/tools.ts — Added WebSearch tool definition
• src/domain/types.ts — Added 'query' to StreamEventSource union

• src/infrastructure/codex-cli/CodexCliClient.ts — extractToolInfo recognizes web_search item types
• src/infrastructure/claude-cli/StreamSessionTracker.ts — inferStage treats WebSearch as a reading-stage tool
• src/main/ipc/handlers.ts — Query handlers broadcast to both query:onStream and chat:streamEvent

• src/renderer/components/QueryManager/ResearchPanel.tsx — Streaming research progress panel
• src/application/QueryService.ts — Added researchTargets() and fillTargetField() methods
• src/main/ipc/handlers.ts — Added query:researchTargets and query:fillTargetField handlers
• agents/QUILL.md — Added Phase 7 (target research & field fill)

• src/infrastructure/claude-cli/ClaudeCodeClient.ts — Added WebSearch to --allowedTools
• src/renderer/components/QueryManager/TargetCard.tsx — Added per-field AI fill buttons

• src/application/PipelineService.ts — Added case 'query-agents' to isPhaseComplete
• src/renderer/components/PipelineSpine/stages.ts — Added 'query-agents' to SHIP stage
• src/renderer/components/PipelineSpine/PipelineSpine.tsx — Phase click navigates to query-manager view

• src/renderer/components/QueryManager/QueryManagerView.tsx
• src/renderer/components/QueryManager/TargetCard.tsx
• src/renderer/components/QueryManager/AddTargetForm.tsx
• src/renderer/components/QueryManager/LetterPreview.tsx
• src/renderer/components/QueryManager/FilterBar.tsx

• src/renderer/stores/queryStore.ts — Zustand store with tracker/letters/loading/generating state

• src/main/index.ts — Named queryService variable, passed to handlers
• agents/QUILL.md — Added Phase 6: Personalized Query Letters

• src/main/ipc/handlers.ts — 9 IPC handlers (loadTracker, saveTracker, addTarget, updateTargetStatus, removeTarget, generateLetter, listLetters, readLetter, saveLetter)
• src/preload/index.ts — Query namespace with 9 methods

• src/application/QueryService.ts — Full IQueryService implementation
• src/application/index.ts — Added QueryService barrel export

• src/domain/types.ts — QueryTargetType, QueryStatus, QuerySubmissionMethod, QueryTarget, QueryTracker, QueryLetter types
• src/domain/interfaces.ts — IQueryService interface with 9 methods
• src/domain/constants.ts — 'query-agents' in PIPELINE_PHASES and PHASE_OUTPUT_FILES

• src/domain/constants.ts — CODEX_STREAM_RETRY_MAX (2) and CODEX_STREAM_RETRY_DELAY_MS (2000)

• src/infrastructure/codex-cli/CodexCliClient.ts — Extracted runCodexAttempt(), retry loop in sendMessage()

• src/infrastructure/codex-cli/CodexCliClient.ts — Added extractStreamError(), rewrote extractError(), improved failure summaries

• src/infrastructure/codex-cli/CodexCliClient.ts — Added unwrapCodexEvent(), rewrote extractText(), extractStatus(), extractUsage()

• src/infrastructure/codex-cli/CodexCliClient.ts — Prevents successful Codex file writes from being reported as errors

• src/infrastructure/codex-cli/CodexCliClient.ts — Added nested event summary detection, compact unknown shape summaries

• src/domain/types.ts — Added ResolvedModelSelection
• src/domain/interfaces.ts — Added IProviderRegistry.resolveModelSelection()
• src/infrastructure/providers/ProviderRegistry.ts — Added deterministic model fallback
• src/renderer/components/Settings/SettingsView.tsx — Shows stale primary-model warning

• src/infrastructure/codex-cli/CodexCliClient.ts — Added tool/file extraction, file-change path normalization, progress inference

• src/infrastructure/codex-cli/CodexCliClient.ts — Recovers assistant text from Codex's final-message file

• src/infrastructure/codex-cli/CodexCliClient.ts — Prevents silent empty Codex exits from being saved as successful empty responses

• prompts/session-program/program-015/ — Session program for Codex silent-exit fix

• prompts/session-program/program-017/ — Session program for Codex file-only completion fix

• src/domain/constants.ts — MAX_CALL_CONTEXT_TOKENS raised from 125_000 to 250_000
• src/infrastructure/ollama-cli/OllamaCodeClient.ts — contextCeiling raised from 90% to 98%; added 80% compaction threshold that triggers compactToolHistory before hard-ceiling check
• src/infrastructure/llama-server/LlamaServerClient.ts — same ceiling/compaction changes as OllamaCodeClient
• src/infrastructure/ollama-cli/contextCompactor.ts — now imported by both OllamaCodeClient and LlamaServerClient

• MAX_CALL_CONTEXT_TOKENS increased to 250K to match modern large-context models.
• Both Ollama and llama-server agents now compact old tool results and assistant messages when context exceeds 80% of window, rather than breaking at 90%.

• RELEASE_NOTES.md — Release notes for v0.6.0 with categorized changes, highlights, and full commit log

• README.md — Added 4 new Key Features sections (Series Bible, Series Import, In-App Helper, Guided Tours & Tooltips); updated source tree with series/, HelperService, SeriesImportService, 4 new stores, 4 new component directories, tours/; corrected counts (158 files, 20 stores)
• docs/index.html — Version v0.6.0; added 4 feature cards (Series Bible, Series Import, In-App Helper, Guided Tours & Tooltips)
• docs/architecture.html — Version v0.6.0; 158 files; added series/ to infra, HelperService + SeriesImportService to app, updated stores (20), hooks (6), component groups (16), added tours/; updated dependency graph
• docs/changelog.html — Version v0.6.0; 63 entries; added 5 new entries + 3 new highlights
• docs/press.html — Version v0.6.0; updated stats (158 files, ~44K LOC, 20 stores)
• docs/contact.html — Version v0.6.0
• docs/evaluation.html — Version v0.6.0

None — documentation and website assets only, no source code changes.

• FORGE-CONFIG.md — First-run program configuration for Novel Engine. Captures stack, module registry, conventions, verification commands, and custom architecture rules. Used by all future Forge runs.
• prompts/feature-requests/intake/small-queue/MASTER.md — Master loop prompt. Instructs the executing agent to iterate through sessions until all are done.
• prompts/feature-requests/intake/small-queue/STATE.md — Session state tracker. All 13 sessions start as pending.
• prompts/feature-requests/intake/small-queue/SESSION-01.md — Bug cluster: revision queue select overflow, sidebar compression, CLI panel scrollbars.
• prompts/feature-requests/intake/small-queue/SESSION-02.md — Done confirm box (first-draft = celebration modal) + onboarding guide pipeline selector fix.
• prompts/feature-requests/intake/small-queue/SESSION-03.md — Book dropdown redesign: simplify to books + New Book + Library panel. Hide archived series groups.
• prompts/feature-requests/intake/small-queue/SESSION-04.md — Sidebar chat expandable: hot take and adhoc revision nested under Chat. Help button relocated to nav bottom.
• prompts/feature-requests/intake/small-queue/SESSION-05.md — Motif Ledger moved from standalone nav item to a tab inside FilesView.
• prompts/feature-requests/intake/small-queue/SESSION-06.md — Archive series: single-action UI button in SeriesModal to archive all books in a series.
• prompts/feature-requests/intake/small-queue/SESSION-07.md — Settings reorganization: four tabs (Writing, Providers, Appearance, Profile).
• prompts/feature-requests/intake/small-queue/SESSION-08.md — Saved prompt library: SavedPrompt domain type, AppSettings field, Saved tab in Quick Actions.
• prompts/feature-requests/intake/small-queue/SESSION-09.md — About.json rich display: dynamic key/value card in FilesView when about.json is selected.
• prompts/feature-requests/intake/small-queue/SESSION-10.md — Query letter / traditional publishing Quick Actions for Quill + HELPER.md improvements + user_guide meta prompt.
• prompts/feature-requests/intake/small-queue/SESSION-11.md — Chapter deep dive backend: IChatService.deepDive, ChatService implementation, IPC handler, preload bridge.
• prompts/feature-requests/intake/small-queue/SESSION-12.md — Chapter deep dive UI: Deep Dive button in FilesView chapter toolbar.
• prompts/feature-requests/intake/small-queue/SESSION-13.md — Reading mode: ManuscriptAssembly type, IFileSystemService.assembleManuscript, IPC, ReadingModeView component, Build view entry point.

• SESSION-08 (when executed): New type SavedPrompt in src/domain/types.ts; new field savedPrompts in AppSettings; updated DEFAULT_SETTINGS in src/domain/constants.ts
• SESSION-11 (when executed): New method on IChatService; new IPC channel chat:deepDive; new bridge method window.novelEngine.chat.deepDive
• SESSION-13 (when executed): New type ManuscriptAssembly in src/domain/types.ts; new method on IFileSystemService; new IPC channel books:assembleManuscript; new view 'reading' in ViewId; new component src/renderer/components/Reading/ReadingModeView.tsx
• SESSION-05 (when executed): Removes 'motif-ledger' from ViewId; zustand persist migration needed (version bump)

• src/domain/interfaces.ts — Added ISettingsService.detectCodexCli().
• src/infrastructure/settings/SettingsService.ts — Added detectCodexCli() using non-interactive codex --version with a 10s timeout.
• src/main/ipc/handlers.ts — Added settings:detectCodexCli IPC handler.
• src/preload/index.ts — Added window.novelEngine.settings.detectCodexCli() bridge method.
• src/renderer/stores/settingsStore.ts — Added detectCodexCli() action that refreshes settings after probing.
• docs/architecture/DOMAIN.md — Documented the new settings contract and current Codex/Ollama provider/settings shapes.
• docs/architecture/INFRASTRUCTURE.md — Documented Codex and Ollama CLI detection behavior in SettingsService.
• docs/architecture/IPC.md — Documented the new Codex detection channel and preload method.
• docs/architecture/RENDERER.md — Documented the new settings store detection action.

• New IPC channel: settings:detectCodexCli
• New preload bridge method: window.novelEngine.settings.detectCodexCli()
• Extended settings service contract: ISettingsService.detectCodexCli()

• src/infrastructure/codex-cli/CodexCliClient.ts — Implements the built-in Codex CLI provider with availability checks, prompt construction, JSONL/text streaming, usage handling, event persistence, and SIGTERM/SIGKILL abort support.
• src/infrastructure/codex-cli/index.ts — Barrel export for the Codex CLI provider.

• docs/architecture/ARCHITECTURE.md — Added src/infrastructure/codex-cli/ to the source tree and Codex CLI to the technology stack.
• docs/architecture/INFRASTRUCTURE.md — Added the codex-cli/ module inventory and documented the chosen codex exec --json invocation.

• New infrastructure module: src/infrastructure/codex-cli/
• New provider implementation: CodexCliClient implements IModelProvider
• New runtime dependency path: Codex CLI provider → local codex exec --json

• src/main/index.ts — Imports and registers CodexCliClient, adds Codex model discovery, persists Codex CLI availability, and skips Codex in the user-provider loop.
• src/domain/constants.ts — Adds fallback Codex model gpt-5.3-codex and default model metadata to the built-in Codex provider config.
• docs/architecture/ARCHITECTURE.md — Updates the service dependency graph for Codex, Ollama, llama-server, and provider registry startup wiring.
• docs/architecture/DOMAIN.md — Documents the current built-in provider IDs and four built-in provider configs.
• docs/architecture/INFRASTRUCTURE.md — Documents Codex startup registration and model discovery fallback behavior.

• New composition root wiring: src/main/index.ts instantiates CodexCliClient(booksDir, db).
• New startup model discovery path: ~/.codex/models_cache.json → built-in gpt-5.3-codex fallback.
• Settings persistence: startup updates hasCodexCli based on CodexCliClient.isAvailable().

• src/renderer/components/Settings/ProviderSection.tsx — Added Codex/Ollama type labels, active badges, active-provider switching, provider-neutral copy, and kept endpoint editing scoped to Ollama/llama-server.
• src/renderer/components/Settings/SettingsView.tsx — Replaced Claude-only status copy with Claude/Codex built-in CLI checks and clarified model selection switches the active provider.
• src/renderer/components/Onboarding/OnboardingWizard.tsx — Updated onboarding setup and ready summary to accept Claude CLI or Codex CLI as local built-in backends.
• src/renderer/stores/providerStore.ts — Reloads settings after setDefault() so active provider state refreshes cleanly.
• docs/architecture/RENDERER.md — Documented provider switching UI, provider store refresh behavior, and Codex-aware onboarding.

• Renderer state flow: providerStore.setDefault() now reloads settingsStore after providers:setDefault.
• No new IPC channels — existing providers:setDefault, settings:detectClaudeCli, and settings:detectCodexCli are reused.

• src/renderer/components/Settings/SettingsView.tsx — Removed Claude-only secondary filtering, reused grouped available-provider model buttons for both pickers, added empty-list guidance, and clarified secondary model copy.
• src/application/AuditService.ts — Resolves AppSettings.secondaryModel through IProviderRegistry for chapter audits before falling back to the primary model.
• docs/architecture/RENDERER.md — Documented that both Settings model pickers use the same available-provider groups and only primary changes switch the active provider.
• docs/architecture/APPLICATION.md — Documented provider-registry secondary model resolution for AuditService.auditChapter().

• Application behavior change: AuditService.auditChapter() can route secondaryModel to any registered available provider through IProviderRegistry.
• Renderer behavior change: SettingsView.tsx uses one grouped model list for primary and secondary pickers.
• No new IPC channels or preload bridge methods.

• prompts/session-program/program-006/input-files/bug-report.md — Captures the screenshot symptoms, initial code pointers, and expected outcome.
• prompts/session-program/program-006/SESSION-01.md — Defines the implementation session for conditional Codex CLI --add-dir support.
• prompts/session-program/program-006/STATE.md — Tracks session status, scope, design decisions, and handoff notes.
• prompts/session-program/program-006/MASTER.md — Defines the execution protocol, recovery steps, and final report requirements.

None — prompt program only, no source wiring changes.

• src/infrastructure/codex-cli/CodexCliClient.ts — Added cached codex exec --help detection for --add-dir, conditional argument construction, and cache invalidation.
• docs/architecture/INFRASTRUCTURE.md — Documented conditional Codex CLI --add-dir support and fallback behavior.

• src/infrastructure/codex-cli/CodexCliClient.ts — Prevents chat requests from hard-failing on Codex CLI installations that reject --add-dir.

• CLI invocation behavior: CodexCliClient now branches on local codex exec --help output before adding --add-dir <booksDir>.
• No domain contracts, IPC channels, renderer stores, or schema changes.

• ./src/infrastructure/codex-cli/CodexCliClient.ts — Added explicit workspace planning for Codex CLI launches, active-book fallback mode, and spawn logging that includes the selected workspace mode.
• ./docs/architecture/INFRASTRUCTURE.md — Documented Codex CLI workspace planning, early directory validation, and fallback status diagnostics.

• ./src/infrastructure/codex-cli/CodexCliClient.ts — Emits a clear error before spawn when the planned working directory is missing and emits an observable status event when older Codex CLI installs run with active-book-only workspace access.

• None — no new dependencies, IPC channels, stores, or schema changes.

• ./src/infrastructure/ollama-cli/OllamaCliRunner.ts — Wraps ollama --version, ollama list, ollama show, ollama serve, and ollama run smoke tests with timeout-safe boolean/empty-list fallbacks.

• ./src/infrastructure/ollama-cli/index.ts — Exports OllamaCliRunner and OllamaCliModel.
• ./docs/architecture/INFRASTRUCTURE.md — Documents the Ollama CLI/API hybrid module and runner behavior.
• ./docs/architecture/ARCHITECTURE.md — Lists ollama-cli, llama-server, and provider infrastructure files in the source tree and technology stack.

• New infrastructure utility: OllamaCliRunner centralizes local ollama command invocation for future Ollama provider routing.
• No new domain contracts, IPC channels, renderer stores, database schema changes, or composition-root wiring.

• ./src/infrastructure/ollama-cli/OllamaCodeClient.ts — Injects OllamaCliRunner, checks local CLI availability before API reachability, attempts ollama serve, and verifies the local API before chat streaming.
• ./src/main/index.ts — Instantiates one OllamaCliRunner, passes it into OllamaCodeClient, uses CLI-backed model discovery for local Ollama, and keeps HTTP discovery for remote hosts.
• ./docs/architecture/INFRASTRUCTURE.md — Documents local CLI-first availability, local API readiness before chat, and remote HTTP behavior.
• ./docs/architecture/ARCHITECTURE.md — Updates the composition root dependency graph for OllamaCliRunner injection.

• New dependency wiring: OllamaCodeClient receives OllamaCliRunner from ./src/main/index.ts.
• Provider behavior change: local Ollama availability is based on CLI detection and model listing before API-only failure; remote Ollama remains HTTP-based.
• No new IPC channels, renderer stores, database schema changes, or domain contracts.

• ./src/renderer/components/Settings/SettingsView.tsx — Added Ollama CLI to built-in CLI status, updated provider guidance, and clarified empty-model copy for local Ollama pulls.
• ./src/renderer/components/Settings/ProviderSection.tsx — Renamed Ollama endpoint copy to an advanced override, added CLI discovery help, and labeled the provider badge as Ollama CLI.
• ./docs/architecture/RENDERER.md — Documented Settings and ProviderSection CLI-first Ollama behavior.

• Renderer behavior change: Settings now calls the existing settings:detectOllamaCli bridge from the built-in CLI status section.
• No new IPC channels, preload methods, stores, database schema changes, or domain contracts.

• src/domain/types.ts — BookDashboardData, BookStatistics, RecentFile, RevisionTaskItem, UsageTimePoint, AgentUsageBreakdown, PhaseUsageBreakdown, WordCountSnapshot types
• src/domain/interfaces.ts — IDashboardService, IStatisticsService interfaces
• src/application/DashboardService.ts — Book overview data aggregation
• src/application/StatisticsService.ts — Usage trends, cost estimates
• src/infrastructure/database/DatabaseService.ts — Dashboard & statistics queries
• src/renderer/components/Dashboard/DashboardView.tsx — Book overview dashboard
• src/renderer/components/Statistics/StatisticsView.tsx — Writing statistics with charts
• src/renderer/components/RevisionQueue/RevisionQueueModal.tsx — Slide-over revision queue
• src/renderer/stores/dashboardStore.ts, statisticsStore.ts, rightPanelStore.ts — New Zustand stores

• src/main/index.ts — Instantiates DashboardService, StatisticsService
• src/main/ipc/handlers.ts — Added dashboard:getData, statistics:get, statistics:recordSnapshot handlers
• src/preload/index.ts — Added dashboard, statistics namespaces
• src/renderer/components/Layout/AppLayout.tsx — Dashboard and statistics views in routing
• src/renderer/stores/viewStore.ts — Added 'dashboard' and 'statistics' view types

• src/renderer/components/Sidebar/BookPanel.tsx — Persistent bookshelf with icon toolbar
• src/renderer/components/Sidebar/ImportChoiceModal.tsx — Import type selection modal

• src/renderer/components/Files/FilesView.tsx — 2-tab → 5-tab layout
• src/renderer/components/Layout/Sidebar.tsx — BookSelector → BookPanel

• src/renderer/components/Files/StructuredBrowser.tsx
• src/renderer/components/Files/CollapsibleSection.tsx
• src/renderer/components/Sidebar/FileTree.tsx
• src/renderer/components/Sidebar/BookSelector.tsx

• src/domain/types.ts — FindReplaceOptions, FindReplaceMatchLocation, FindReplacePreviewItem, FindReplacePreviewResult, FindReplaceApplyResult types
• src/domain/interfaces.ts — IFindReplaceService interface
• src/application/FindReplaceService.ts — Preview + apply with version snapshots
• src/renderer/components/Files/FindReplaceModal.tsx — Three-phase modal UI

• src/main/ipc/handlers.ts — Added findReplace:preview, findReplace:apply handlers
• src/preload/index.ts — Added findReplace namespace
• src/renderer/components/Files/FilesHeader.tsx — Added Find & Replace button

• src/renderer/components/Reading/ReadingModeView.tsx
• src/renderer/components/Files/AboutJsonViewer.tsx
• src/renderer/components/RightPanel/PipelinePanel.tsx
• src/renderer/stores/autoDraftStore.ts

• prompts/meta/architecture-engine/architecture-engine.md — Full architecture engine prompt
• prompts/meta/architecture-engine/readme.md — Explainer document
• FORGE-CONFIG.md — Project-level Forge configuration

• agents/HELPER.md — Helper agent system prompt
• docs/USER_GUIDE.md — Comprehensive 16-section user guide
• src/application/HelperService.ts — Implements IHelperService
• src/renderer/stores/helperStore.ts — Zustand store for helper panel state
• src/renderer/components/Helper/HelperButton.tsx — Floating help button
• src/renderer/components/Helper/HelperPanel.tsx — Slide-up chat panel
• src/renderer/components/Helper/HelperMessageList.tsx — Message list with streaming support

• src/domain/types.ts — Added 'Helper' to AgentName, 'helper' to ConversationPurpose
• src/domain/constants.ts — Added Helper to AGENT_REGISTRY
• src/domain/interfaces.ts — Added IHelperService interface
• src/main/index.ts — Instantiates HelperService
• src/main/ipc/handlers.ts — Added 5 helper:* IPC channels
• src/preload/index.ts — Added helper namespace to preload bridge

• src/renderer/components/common/Tooltip.tsx — Portal-based tooltip with arrow and animation
• src/renderer/components/common/GuidedTourOverlay.tsx — Spotlight overlay with clip-path
• src/renderer/hooks/useTooltip.ts — Positioning hook with viewport clamping
• src/renderer/tours/tourDefinitions.ts — 3 tour definitions (16 total steps)
• src/renderer/stores/tourStore.ts — Tour lifecycle management

• src/domain/types.ts — Added TourId, TourStep, TourStepPlacement, TourState types; completedTours to AppSettings
• 14 components gained tooltips and data-tour attributes
• src/renderer/components/Settings/SettingsView.tsx — Added Guided Tours section with replay buttons

• src/application/SeriesImportService.ts — Batch preview + sequential commit
• src/renderer/stores/seriesImportStore.ts — Wizard state management
• src/renderer/components/Import/ImportSeriesWizard.tsx — Full wizard modal
• src/renderer/components/Import/VolumePreviewList.tsx — Volume list with editing

• src/domain/types.ts — Added SeriesImportVolume, SeriesImportPreview, SeriesImportCommitConfig, SeriesImportResult types
• src/domain/interfaces.ts — Added ISeriesImportService interface
• src/main/ipc/handlers.ts — Added 3 import:series* handlers
• src/preload/index.ts — Added seriesImport namespace

• src/infrastructure/series/SeriesService.ts — Full ISeriesService implementation
• src/renderer/stores/seriesStore.ts — Zustand store with full CRUD
• src/renderer/components/Series/SeriesModal.tsx — Series management modal
• src/renderer/components/Series/SeriesForm.tsx — Create/edit form
• src/renderer/components/Series/VolumeList.tsx — Volume ordering
• src/renderer/components/Series/SeriesBibleEditor.tsx — Markdown editor
• src/renderer/components/Sidebar/SeriesGroup.tsx — Collapsible sidebar group

• src/domain/types.ts — Added SeriesVolume, SeriesMeta, SeriesSummary types
• src/domain/interfaces.ts — Added ISeriesService interface (12 methods)
• src/domain/constants.ts — Added seriesBible to FILE_MANIFEST_KEYS and read guidance
• src/application/ChatService.ts — Added ISeriesService dependency
• src/application/ContextBuilder.ts — Series bible path injection
• src/main/ipc/handlers.ts — Added 11 series:* IPC handlers
• src/preload/index.ts — Added series namespace (11 methods)

• README.md — Full rewrite. Verified all 7 agents against constants.ts. Verified all 14 pipeline phases against PipelineService.ts. Verified all npm scripts against package.json. Verified tech stack versions. Updated src/ tree to include import/ChapterDetector.ts, ManuscriptImportService.ts, SourceGenerationService.ts, Import/ components, importStore.ts. Added 8 new Key Features sections (Manuscript Import, CLI Activity Monitor, Modal Chat, File Version History, File Watchers, OS Notifications, Book Management, Multi-Model Provider Support, Chapter Validation). Corrected store count to 17. Corrected application service listing. Preserved Dedication, Book list, and Testers Needed sections verbatim.

• src/application/MotifLedgerService.ts — Added IProviderRegistry dependency. Replaced per-type normalizer functions with isCanonicalShape() shape detection + normalizeViaCli() CLI call. Added parseLedgerFromCanonical() as best-effort fallback. Added setNormalizationCallback() for progress events. load() now saves normalized data back to disk.
• src/main/index.ts — Passes providerRegistry to MotifLedgerService constructor. Registers normalization callback that broadcasts motifLedger:normalizing events to all renderer windows.
• src/preload/index.ts — Added onNormalizing() event listener to motifLedger namespace.
• src/renderer/stores/motifLedgerStore.ts — Added isNormalizing state and setNormalizing() action.
• src/renderer/components/MotifLedger/MotifLedgerView.tsx — Subscribes to motifLedger:normalizing push events. Shows animated spinner with "Normalizing ledger format via AI..." message during CLI normalization.

• src/domain/types.ts — Added ImportSourceFormat, DetectedChapter, ImportPreview, ImportCommitConfig, ImportResult, SourceGenerationStep, SourceGenerationEvent types
• src/domain/interfaces.ts — Added IManuscriptImportService and ISourceGenerationService interfaces
• src/application/import/ChapterDetector.ts — Pure utility: detects chapter boundaries by heading patterns, "Chapter N" patterns, or fallback single-chapter. Includes ambiguity detection for uneven splits and short documents.
• src/application/ManuscriptImportService.ts — Implements IManuscriptImportService. Reads files, converts DOCX via Pandoc, runs chapter detection, commits by creating book structure.
• src/application/SourceGenerationService.ts — Implements ISourceGenerationService. Runs 4 sequential agent calls (Spark pitch, Verity outline+bible, Verity voice, Verity motif) with per-step progress events.
• src/renderer/stores/importStore.ts — Zustand store managing the multi-step import wizard state machine (idle → loading → preview → importing → success → generating → generated).
• src/renderer/components/Import/ImportWizard.tsx — Modal wizard with step-based rendering: file analysis, chapter preview with editing, import progress, success, source generation progress.
• src/renderer/components/Import/ChapterPreviewList.tsx — Scrollable chapter list with inline rename, merge, and remove controls.

• src/main/index.ts — Instantiates ManuscriptImportService and SourceGenerationService, passes to registerIpcHandlers
• src/main/ipc/handlers.ts — Added import:selectFile, import:preview, import:commit, import:generateSources handlers
• src/preload/index.ts — Added window.novelEngine.import namespace with selectFile, preview, commit, generateSources, onGenerationProgress
• src/renderer/components/Sidebar/BookSelector.tsx — Replaced single "New Book" button with "New Book" + "Import" side-by-side. Renders ImportWizard modal.

• docs/index.html — Added Key Features section (9 cards: Pitch Room, Voice Profile, Auto-Draft, Verity Audit, Motif Ledger, Revision Queue, Version History, Multi-Model, Build & Export). Updated subtitle to mention multi-model. Updated export description for catalog export.
• docs/architecture.html — Added providers/ to infrastructure modules. Added file_versions and schema_version to schema table. Updated file count to 130, store count to 16. Added ProviderRegistry and VersionService to dependency graph. Added multi-model and version history to design decisions. Updated source tree with all current files.
• docs/changelog.html — Full rebuild with all 39 entries (was 21). Updated stats: entries 21→39. Added all 2026-03-28 entries (18 new). Expanded highlight reel with version history and multi-model features.
• docs/press.html — Updated stats: 130 files, 16 stores, 7 tables, 80+ IPC channels. Added "Multi-model support" differentiator card. Updated source file count in "Open source" card.
• docs/contact.html — Updated architecture rules to include barrel export requirement. Minor copy refinements.

• README.md — Full rewrite per prompts/meta/readme-deep-update.md spec. All sections verified against source code.

• src/renderer/stores/providerStore.ts — Zustand store for provider CRUD, status checking
• src/renderer/components/Settings/ProviderSection.tsx — Provider management: cards, status dots, add form, enable/disable/remove

• src/renderer/components/Settings/SettingsView.tsx — Added ProviderSection between CLI status and model selection. Rewrote ModelSelectionSection to group models by provider, show "Text only" badge, and update activeProviderId on cross-provider model selection.

• src/main/ipc/handlers.ts — Added 7 providers:* handlers (list, getConfig, add, update, remove, checkStatus, setDefault). Updated settings:getAvailableModels to use providerRegistry.listAllModels(). Added providerRegistry to services param.
• src/preload/index.ts — Added providers namespace with 7 bridge methods. Updated models.getAvailable return type to ModelInfo[].
• src/main/index.ts — Added providerRegistry to registerIpcHandlers call.

• src/application/ChatService.ts — IClaudeClient → IProviderRegistry, this.claude → this.providers, isAvailable() routes through getDefaultProvider()
• src/application/HotTakeService.ts — IClaudeClient → IProviderRegistry
• src/application/PitchRoomService.ts — IClaudeClient → IProviderRegistry
• src/application/AdhocRevisionService.ts — IClaudeClient → IProviderRegistry
• src/application/AuditService.ts — IClaudeClient → IProviderRegistry
• src/application/RevisionQueueService.ts — IClaudeClient → IProviderRegistry
• src/main/index.ts — Added ProviderRegistry + OpenAiCompatibleProvider setup between infra and service instantiation. Removed redundant settings.load() call.

• src/infrastructure/providers/OpenAiCompatibleProvider.ts — SSE streaming, AbortController cancellation, runtime API key/URL update, /v1/models health check

• src/infrastructure/providers/index.ts — Added OpenAiCompatibleProvider export

• src/infrastructure/providers/ProviderRegistry.ts — Implements IProviderRegistry. Model routing, provider CRUD, config persistence to settings.
• src/infrastructure/providers/index.ts — Barrel export

• src/infrastructure/claude-cli/ClaudeCodeClient.ts — Now implements both IClaudeClient and IModelProvider. Added providerId and capabilities properties.

• src/domain/types.ts — Added 6 provider types (ProviderId, ProviderType, ProviderCapability, ProviderStatus, ProviderConfig, ModelInfo). Extended AppSettings with providers: ProviderConfig[] and activeProviderId: ProviderId.
• src/domain/interfaces.ts — Added IModelProvider interface (same shape as IClaudeClient plus providerId and capabilities). Added IProviderRegistry interface (router + CRUD + convenience delegates). Deprecated IClaudeClient with JSDoc.
• src/domain/constants.ts — Added CLAUDE_CLI_PROVIDER_ID, OPENCODE_CLI_PROVIDER_ID, BUILT_IN_PROVIDER_CONFIGS. Deprecated AVAILABLE_MODELS with JSDoc. Updated DEFAULT_SETTINGS with provider fields. Reordered declarations to avoid forward-reference errors.

• src/main/ipc/handlers.ts — Added catalog:exportZip handler between build and usage sections. Zips paths.booksDir into a user-chosen location with default filename novel-engine-catalog-YYYY-MM-DD.zip.
• src/preload/index.ts — Added catalog namespace with exportZip() bridge method.
• src/renderer/components/Settings/SettingsView.tsx — Added CatalogExportSection component between UsageSection and AuthorProfileSection. Shows export button, disabled state during export, and clickable "Saved to:" path on success.

• src/renderer/components/Files/VersionHistoryPanel.tsx — Full version history UI: timeline with VersionEntry sub-component, integrated DiffViewer, revert with confirmation, pagination, error handling, empty states.

• src/renderer/stores/versionStore.ts — Zustand store with 6 actions: loadHistory, loadMoreHistory, selectVersion, clearSelection, revertToVersion, reset. Paginated at 30 items per page.
• src/renderer/components/Files/DiffViewer.tsx — Renders FileDiff with green (additions), red (deletions), neutral (context) line coloring. Sub-components: HunkHeader, DiffLineRow, DiffSummary.

• src/main/index.ts — Import and instantiate VersionService. Add startup pruning loop. Add fallback snapshot to BookWatcher callback. Pass version to registerIpcHandlers.
• src/main/ipc/handlers.ts — Add IVersionService to services param. Add snapshotChangedFiles helper. Add 6 versions:* IPC handlers. Modify files:write to auto-snapshot. Add snapshot hooks to chat:send, hot-take:start, adhoc-revision:start, and revision queue event forwarding.
• src/preload/index.ts — Add versions namespace with 6 methods: getHistory, getVersion, getDiff, revert, getCount, snapshot. Add type imports for FileDiff, FileVersion, FileVersionSource, FileVersionSummary.

• src/application/VersionService.ts — Implements IVersionService. Depends on IDatabaseService and IFileSystemService via DI. Uses node:crypto for hashing and diff package for structured patches.

• src/domain/interfaces.ts — Extended IDatabaseService with 7 new methods in a // File Versions section: insertFileVersion, getFileVersion, getLatestFileVersion, listFileVersions, countFileVersions, deleteFileVersionsBeyondLimit, getVersionedFilePaths
• src/infrastructure/database/migrations.ts — Added migration v2: creates file_versions table with idx_file_versions_lookup and idx_file_versions_hash indexes
• src/infrastructure/database/DatabaseService.ts — Implemented all 7 new IDatabaseService methods. Added 6 prepared statements and 2 private row mappers (mapFileVersion, mapFileVersionSummary). Added FileVersion, FileVersionSource, FileVersionSummary type imports.

• src/domain/types.ts — Added 7 version control types after the File System section: FileVersionSource, FileVersion, FileVersionSummary, DiffLineType, DiffLine, DiffHunk, FileDiff
• src/domain/interfaces.ts — Added IVersionService interface with 8 methods: snapshotFile, snapshotContent, getHistory, getVersion, getDiff, revertToVersion, getVersionCount, pruneVersions. Added 4 new type imports.

• prompts/meta/intake.md — Document intake and feature decomposition prompt. Parses attached documents, researches current codebase, decomposes into layered sessions, generates MASTER/STATE/SESSION files.

• src/application/MotifLedgerService.ts — Removed auto-writeback of repaired JSON on load. Rewrote repairJson() from global regex to line-by-line structural repair (only matches lines that are purely } or ]). Simplified safeParse() return type (removed repaired flag).

• src/application/MotifLedgerService.ts — Added normalizeAuditRecord() to map agent field names (chapter→chapterSlug, date→auditedAt, findings→notes) and fill missing fields (id, entriesAdded, entriesUpdated). Also added normalizeSystem() (fills missing components array) and normalizeEntry() (fills missing phrase field). Added safeArray() helper to guard against non-array values.
• src/renderer/components/MotifLedger/AuditLogTab.tsx — Sort comparison now uses (b.auditedAt ?? '').localeCompare(a.auditedAt ?? '') as a defensive fallback.

• src/renderer/components/Sidebar/HotTakeButton.tsx — Added fileRevision from useFileChangeStore to the useEffect dependency array so the chapter existence check re-runs when files change on disk.

• docs/changelog.html — Added 3 new entries at top (r003 fixes, MotifLedgerView crash, BookSelector/SystemsTab crash). Updated stats: entries 18→21, replaced "Architecture Changes" stat with "Bug Fixes: 20+". Added r003 and MotifLedger crash fixes to Quality & Stability highlights.

• src/renderer/components/Sidebar/BookSelector.tsx — Changed outer dropdown trigger from <button> to <div role="button"> with tabIndex and onKeyDown, eliminating the nested-button DOM warning.
• src/renderer/components/MotifLedger/SystemsTab.tsx — Guarded sys.components with ?? [] in startEdit() (line 42), render loop (line 165), and iteration (line 167) to prevent crash when ledger JSON has systems with missing components field.

• src/renderer/components/MotifLedger/MotifLedgerView.tsx — Tab count computation now guards against undefined ledger arrays with optional chaining (arr?.length ?? 0) instead of casting to unknown[] and accessing .length directly.

• src/renderer/stores/chatStore.ts — Added _streamOrigin discriminator ('self'|'external'|null). switchBook() only aborts 'self' streams, preserving background auto-draft/hot-take/revision streams.
• src/renderer/stores/autoDraftStore.ts — Added skippedAudits: string[] to AutoDraftSession. Audit/fix catch block now pauses the loop instead of silently continuing. Logs skipped audits on session completion.
• src/application/ChatService.ts — Replaced lastDiagnostics singleton with diagnosticsMap: Map<string, ContextDiagnostics> keyed by conversationId (max 20 entries). getLastDiagnostics() accepts optional conversationId. sendMessage() now returns { changedFiles: string[] }. Removed resetChangedFiles() call and getLastChangedFiles() method.
• src/application/StreamManager.ts — Removed lastChangedFiles singleton, resetChangedFiles(), and getLastChangedFiles(). Each stream tracks its own changedFiles via closure. startStream() returns getChangedFiles() getter.
• src/domain/interfaces.ts — Updated IChatService.sendMessage return type to Promise<{ changedFiles: string[] }>. Updated getLastDiagnostics to accept optional conversationId. Removed getLastChangedFiles(). Added persistStreamEventBatch() to IDatabaseService.
• src/domain/types.ts — Added StreamEventSource type union for event origin discrimination.
• src/main/ipc/handlers.ts — chat:send reads changedFiles from sendMessage() return. adhoc-revision:start captures changedFiles from stream events. All broadcast sites inject source: StreamEventSource. context:getLastDiagnostics passes conversationId. Verity broadcastVerityEvent now accepts source parameter.
• src/preload/index.ts — context.getLastDiagnostics accepts optional conversationId.
• ...and 7 more

• docs/index.html — Landing page: hero, 7 agent cards, 14-phase pipeline visualization, getting started guide, screenshots, published books grid
• docs/evaluation.html — 10-book dual AI evaluation (migrated from old index.html with nav/footer added)
• docs/architecture.html — Technical architecture: 5-layer diagram, tech stack, service dependency graph, design decisions, database schema, source tree, contributing guide
• docs/changelog.html — Formatted changelog with summary stats, highlight reel, collapsible entries for all 18 changelog entries
• docs/press.html — Press kit: quotable pitch, 7 differentiator cards, published works, by-the-numbers stats, quotable lines, asset links
• docs/contact.html — Contact info, contribution guide with architecture rules, bug reporting template, testers-wanted callout with platform badges

• docs/index.html — Replaced single-page evaluation site with full landing page (evaluation content moved to evaluation.html)

• README.md — Full rewrite. Updated source tree, file count, feature descriptions, agent registry, custom-agents directory listing. Added Verity Audit Pipeline, Motif Ledger, and phase-aware Verity prompt sections. Corrected Spark thinking budget from 8K to 4K. Updated store count to 14. Added all missing component groups and application services.

• src/renderer/stores/streamHandler.ts — Shared createStreamHandler() factory encapsulating guard logic and event dispatch for chatStore, modalChatStore, pitchRoomStore

• src/renderer/stores/chatStore.ts — Error catch clears _activeCallId and filters temp message; _handleStreamEvent delegates to shared handler; switchBook() aborts active stream before clearing state
• src/renderer/stores/modalChatStore.ts — Error catch clears _activeCallId and filters temp message; _handleStreamEvent delegates to shared handler; added _closeRequested flag for close-on-stream-end UX
• src/renderer/stores/pitchRoomStore.ts — Error catch clears _activeCallId and filters temp message; _handleStreamEvent delegates to shared handler
• src/renderer/stores/cliActivityStore.ts — Recovery polling uses module-level timer refs to prevent duplicate intervals
• src/domain/types.ts — RevisionQueueEvent session:streamEvent variant now includes optional conversationId
• src/application/RevisionQueueService.ts — Includes conversationId when emitting session:streamEvent
• src/main/ipc/handlers.ts — Forwards conversationId in revision event bridge; added emitVerityCallStart() helper + 4 call sites for Verity audit/fix/motif-audit
• src/infrastructure/claude-cli/ClaudeCodeClient.ts — EPIPE logged with console.warn; DB persistence errors logged on first failure per session; 500KB system prompt size guard before spawn

• issues.md — Full repo evaluation report with 12 findings, coverage matrix, and positive observations

• prompts/standard/update-website.md — 8-step prompt: collect source material → define site map (6 pages) → spec each page → design system tokens → content tone rules → screenshot strategy → build all pages → verify 16-point checklist

• prompts/standard/address-issues.md — 7-step prompt: parse issues → group by affinity → order by severity → generate fix prompts → generate STATE.md → generate MASTER.md → summary report

• src/infrastructure/settings/SettingsService.ts — Added comments to 2 catches (settings load, CLI detection)
• src/infrastructure/filesystem/FileSystemService.ts — Added comments to 2 catches (books dir, active book)
• src/application/MotifLedgerService.ts — Added comments to 2 catches (load, getUnauditedChapters)
• src/application/RevisionQueueService.ts — Added comments to 2 catches (readCache, readState)
• src/main/bootstrap.ts — Added comment to 1 catch (needsBootstrap)
• src/main/ipc/handlers.ts — Added comment to 1 catch (author profile load)

• src/application/ChatService.ts — Removed audit: IAuditService and usage: IUsageService constructor params (no longer directly needed). Final line count: 403.
• src/main/index.ts — Updated ChatService constructor call.

• src/application/HotTakeService.ts — HotTakeService implementing IHotTakeService (98 lines)
• src/application/AdhocRevisionService.ts — AdhocRevisionService implementing IAdhocRevisionService (105 lines)
• src/domain/interfaces.ts — IHotTakeService, IAdhocRevisionService interfaces

• src/application/ChatService.ts — Removed handleHotTake() and handleAdhocRevision(). Added hotTake: IHotTakeService and adhocRevision: IAdhocRevisionService constructor params. ChatService: 559→407 lines.
• src/main/index.ts — Instantiate HotTakeService and AdhocRevisionService, inject into ChatService.

• src/application/PitchRoomService.ts — PitchRoomService class implementing IPitchRoomService (109 lines)
• src/domain/interfaces.ts — IPitchRoomService interface (handleMessage)

• src/application/ChatService.ts — Removed handlePitchRoomMessage(). Added pitchRoom: IPitchRoomService and streamManager: StreamManager constructor params. StreamManager no longer created internally. ChatService: 637→559 lines.
• src/main/index.ts — StreamManager created externally and injected into both ChatService and PitchRoomService. PitchRoomService instantiated and passed to ChatService.

• src/application/AuditService.ts — AuditService class implementing IAuditService (350 lines)
• src/domain/interfaces.ts — IAuditService interface (auditChapter, fixChapter, runMotifAudit)

• src/application/ChatService.ts — Removed 3 method implementations (~320 lines). Added audit: IAuditService constructor param. ChatService reduced from 1,121→637 lines.
• src/domain/interfaces.ts — Moved audit methods from IChatService to new IAuditService
• src/main/ipc/handlers.ts — Added audit: IAuditService to services param. Routed verity:auditChapter, verity:fixChapter, verity:fixChapterWithAudit, verity:runMotifAudit to services.audit
• src/main/index.ts — Instantiate AuditService, inject into ChatService and registerIpcHandlers

• src/application/StreamManager.ts — StreamManager class: startStream(), resetChangedFiles(), getActiveStream(), getActiveStreamForBook(), getLastChangedFiles(), cleanupAbortedStream(), cleanupErroredStream()
• src/application/thinkingBudget.ts — resolveThinkingBudget() pure function (per-message override → global override → per-agent default → undefined)

• src/application/ChatService.ts — Removed private activeStreams and private lastChangedFiles fields. Added private streamManager: StreamManager. All four stream handler methods now use streamManager.startStream() instead of manual buffer/cleanup patterns. Replaced inline resolveThinkingBudget with import from ./thinkingBudget.

• src/domain/interfaces.ts — IChatService interface (sendMessage, createConversation, getConversations, getMessages, abortStream, getActiveStream, getActiveStreamForBook, getLastDiagnostics, getLastChangedFiles, isCliIdle, recoverOrphanedSessions, getRecoveredOrphans, auditChapter, fixChapter, runMotifAudit)
• src/domain/interfaces.ts — IUsageService interface (recordUsage, getSummary, getByConversation)

• src/domain/interfaces.ts — Added imports: ActiveStreamInfo, AuditResult, ContextDiagnostics, ConversationPurpose
• src/application/ChatService.ts — implements IChatService. Constructor param usage: UsageService → usage: IUsageService. Removed concrete UsageService import.
• src/application/UsageService.ts — implements IUsageService
• src/main/ipc/handlers.ts — Replaced import type { ChatService } and import type { UsageService } with IChatService and IUsageService from @domain/interfaces. Updated registerIpcHandlers signature.

• src/infrastructure/database/migrations.ts — Migration type, MIGRATIONS array (v0 baseline + v1 purpose column), runMigrations() function

• src/infrastructure/database/schema.ts — Replaced ad hoc ALTER TABLE check with runMigrations(db) call. Added import of runMigrations.

• agents/FORGE.MD → agents/FORGE.md — Extension casing standardized
• agents/Quill.md → agents/QUILL.md — Name casing standardized
• src/domain/constants.ts — AGENT_REGISTRY.Forge.filename: 'FORGE.MD' → 'FORGE.md', .Quill.filename: 'Quill.md' → 'QUILL.md'
• src/main/bootstrap.ts — Added agent rename migration step in ensureAgents() (runs before file copy)
• docs/architecture/DOMAIN.md — Agent registry table updated with correct filenames

• src/domain/constants.ts — AGENT_REGISTRY.Wrangler.role: 'Context Planner' → 'Revision Plan Parser'
• docs/architecture/DOMAIN.md — Updated Wrangler role in Agent Registry table

• src/domain/constants.ts — Added header comment noting the renderer value import exception
• docs/architecture/ARCHITECTURE.md — Added "Renderer Value Import Exception" section with criteria, allowed imports list, and exclusions
• docs/architecture/RENDERER.md — Added callout noting the exception with link to ARCHITECTURE.md

• src/domain/statusMessages.ts — STATUS_PREPARING, STATUS_WAITING, STATUS_RESPONDING, PITCH_ROOM_FLAVOR arrays and their public accessor functions

• src/domain/constants.ts — Removed all status message arrays and functions (~190 lines)
• src/domain/index.ts — Added export * from './statusMessages' to barrel export
• src/application/ChatService.ts — Import randomPreparingStatus, randomWaitingStatus from @domain/statusMessages
• src/renderer/hooks/useRotatingStatus.ts — Import randomRespondingStatus from @domain/statusMessages
• src/renderer/stores/chatStore.ts — Import randomRespondingStatus from @domain/statusMessages
• src/renderer/stores/modalChatStore.ts — Import randomRespondingStatus from @domain/statusMessages
• src/renderer/stores/pitchRoomStore.ts — Split import: PITCH_ROOM_SLUG from constants, randomRespondingStatus from statusMessages
• src/renderer/components/PitchRoom/PitchRoomView.tsx — Split import: AGENT_REGISTRY from constants, randomPitchRoomFlavor from statusMessages

• agents/VOICE-SETUP.md — Voice profile setup instructions (was VOICE_SETUP_INSTRUCTIONS)
• agents/AUTHOR-PROFILE.md — Author profile setup instructions (was AUTHOR_PROFILE_INSTRUCTIONS)
• agents/PITCH-ROOM.md — Pitch room brainstorming instructions with {{BOOKS_PATH}} placeholder (was buildPitchRoomInstructions())
• agents/HOT-TAKE.md — Hot take assessment instructions (was HOT_TAKE_INSTRUCTIONS)
• agents/MOTIF-AUDIT.md — Scoped phrase & motif audit instructions (was MOTIF_AUDIT_INSTRUCTIONS)
• agents/ADHOC-REVISION.md — Direct feedback mode instructions (was ADHOC_REVISION_INSTRUCTIONS)
• agents/REVISION-VERIFICATION.md — Post-revision verification prompt (was REVISION_VERIFICATION_PROMPT)
• agents/VERITY-FIX.md — Audit fix mode instructions (was VERITY_FIX_INSTRUCTIONS)
• ...and 1 more

• src/domain/constants.ts — Removed 9 exported prompt constants/functions (~289 lines). Updated MOTIF_AUDIT_CADENCE comment to reference agent file instead of deleted constant.
• src/application/ChatService.ts — Replaced all 8 prompt constant references with await this.agents.loadRaw() calls. buildPitchRoomInstructions() replaced with template load + {{BOOKS_PATH}} regex replace.
• src/application/RevisionQueueService.ts — Replaced WRANGLER_SESSION_PARSE_PROMPT with await this.agents.loadRaw('WRANGLER-PARSE.md').

• prompts/arch/STATE.md — State tracker with prompt status, dependency graph, and handoff notes
• prompts/arch/MASTER.md — Master loop prompt that reads state, picks next prompt, executes, and loops
• prompts/arch/ARCH-01.md — Extract prompt templates from constants.ts to agent .md files
• prompts/arch/ARCH-02.md — Extract status messages from constants.ts to statusMessages.ts
• prompts/arch/ARCH-03.md — Add IChatService and IUsageService interfaces
• prompts/arch/ARCH-04.md — Extract StreamManager from ChatService
• prompts/arch/ARCH-05.md — Extract AuditService from ChatService
• prompts/arch/ARCH-06.md — Extract PitchRoomService from ChatService
• ...and 8 more

• src/domain/types.ts — Renamed AuditViolationType variant 'phrase-ledger-hit' → 'flagged-phrase'
• src/domain/constants.ts — Removed source/phrase-ledger.md from AGENT_READ_GUIDANCE (Verity, Lumen). Removed phraseLedger from FILE_MANIFEST_KEYS. Renamed PHRASE_AUDIT_INSTRUCTIONS → MOTIF_AUDIT_INSTRUCTIONS (now writes to motif-ledger.json). Renamed PHRASE_AUDIT_CADENCE → MOTIF_AUDIT_CADENCE. Updated VERITY_FIX_INSTRUCTIONS to use flagged-phrase violation type.
• src/application/ChatService.ts — Renamed runPhraseAudit() → runMotifAudit(). Audit chapter now loads flaggedPhrases from motif-ledger.json instead of reading phrase-ledger.md. Updated ad hoc revision pre-step.
• src/main/ipc/handlers.ts — Renamed IPC channel verity:runPhraseAudit → verity:runMotifAudit
• src/preload/index.ts — Renamed bridge method runPhraseAudit → runMotifAudit
• src/renderer/stores/autoDraftStore.ts — Renamed PHRASE_AUDIT_CADENCE → MOTIF_AUDIT_CADENCE, updated periodic audit labels and method calls
• agents/LUMEN.md — Lens 8 now writes flaggedPhrases to motif-ledger.json instead of phrase-ledger.md. Updated file ownership table.
• agents/VERITY-AUDIT.md — Renamed violation type, updated input description and flagging rules
• ...and 5 more

• source/phrase-ledger.md concept — no longer produced or consumed by any agent or service
• phraseLedger key from FILE_MANIFEST_KEYS

• docs/architecture/ARCHITECTURE.md — Master overview: layer diagram, source tree, service dependency graph, conventions, tech stack
• docs/architecture/DOMAIN.md — All types (60+ types cataloged), all interfaces (11 interfaces with full method tables), all constants
• docs/architecture/INFRASTRUCTURE.md — 6 infrastructure modules, 5 database tables with column details, CLI integration protocol, file watcher docs
• docs/architecture/APPLICATION.md — 8 application services with method tables, context assembly strategy, conversation compaction rules
• docs/architecture/IPC.md — 80+ IPC channels across 17 namespaces, 7 push events, full window.novelEngine preload bridge type shape
• docs/architecture/RENDERER.md — 13 Zustand stores, 8 views, 12 component groups (50+ components), 5 hooks

• docs/architecture/ — New directory for all architecture documentation files

• AGENTS.md — Updated all 20+ references from docs/*.md to docs/architecture/*.md (Rule section, section headers, Workflow mappings, Edge Cases)

• src/main/ipc/handlers.ts — Added motifLedger:load, motifLedger:save, motifLedger:getUnauditedChapters IPC handlers
• src/preload/index.ts — Added motifLedger namespace to the contextBridge API
• src/renderer/stores/motifLedgerStore.ts — Zustand store with full CRUD for all 7 ledger sections, dirty tracking, save/load
• src/renderer/components/MotifLedger/MotifLedgerView.tsx — Main view with 7-tab navigation, save button, Cmd+S shortcut
• src/renderer/components/MotifLedger/SystemsTab.tsx — Motif systems CRUD
• src/renderer/components/MotifLedger/EntriesTab.tsx — Character motif entries CRUD with filtering
• src/renderer/components/MotifLedger/StructuralTab.tsx — Structural devices CRUD
• src/renderer/components/MotifLedger/ForeshadowTab.tsx — Foreshadow registry with status grouping
• ...and 3 more

• src/main/ipc/handlers.ts — Added IMotifLedgerService to services type, MotifLedger to type imports
• src/preload/index.ts — Added MotifLedger type import
• src/renderer/stores/viewStore.ts — Added 'motif-ledger' to ViewId
• src/renderer/components/Layout/AppLayout.tsx — Added MotifLedgerView to ViewContent
• src/renderer/components/Layout/Sidebar.tsx — Added motif-ledger nav item