From 550e7011ff04c5c1f620b9cef0db3891911c2651 Mon Sep 17 00:00:00 2001 From: Ed_ Date: Tue, 5 May 2026 18:29:19 -0400 Subject: [PATCH] docs(conductor): Synchronize docs for track 'Undo/Redo History Support' --- conductor/product.md | 5 +++++ conductor/tech-stack.md | 2 ++ 2 files changed, 7 insertions(+) diff --git a/conductor/product.md b/conductor/product.md index 0e27992..89c9125 100644 --- a/conductor/product.md +++ b/conductor/product.md @@ -58,6 +58,11 @@ For deep implementation details when planning or implementing tracks, consult `d - **Deep Discussion Integration:** Retrieved context fragments are automatically prepended to agent prompts and captured in the discussion history, featuring a dedicated visualization mode with source buttons for instant file navigation. - **Configurable Strategy:** Users can toggle RAG globally and fine-tune retrieval parameters (source, embedding provider, chunk size/overlap) directly within the AI Settings. - **Automated Synchronization:** Features background re-indexing of the project workspace, ensuring the vector store remains consistent with the current project state. +- **Undo/Redo History Support:** Implements a robust, non-provider based undo/redo system for managing UI state and discussion mutations. + - **Comprehensive State Snapshots:** Captures all critical UI state, including text inputs (system prompts, AI input), model parameters (Temperature, Top-P), and context management (files, screenshots). + - **Discussion Mutation Tracking:** Allows reverting and redoing additions, deletions, and structural changes to the discussion history. + - **History List View:** Features a dedicated, scrollable panel showing recent actions with timestamps, allowing users to jump directly to any historical state. + - **Tactile Hotkeys:** Supports industry-standard shortcuts (`Ctrl+Z`, `Ctrl+Y`, `Ctrl+Shift+Z`) for fast, intuitive state navigation. - **High-Fidelity Selectable UI:** Most read-only labels and logs across the interface (including discussion history, comms payloads, tool outputs, and telemetry metrics) are now implemented as selectable text fields. This enables standard OS-level text selection and copying (Ctrl+C) while maintaining a high-density, non-editable aesthetic. - **High-Fidelity UI Rendering:** Employs advanced 3x font oversampling and sub-pixel positioning to ensure crisp, high-clarity text rendering across all resolutions, enhancing readability for dense logs and complex code fragments. - **Enhanced MMA Observability:** Worker streams and ticket previews now support direct text selection, allowing for easy extraction of specific logs or reasoning fragments during parallel execution. diff --git a/conductor/tech-stack.md b/conductor/tech-stack.md index f5bd3ca..bf5e255 100644 --- a/conductor/tech-stack.md +++ b/conductor/tech-stack.md @@ -47,6 +47,8 @@ - **src/rag_engine.py:** Core RAG implementation managing the vector store lifecycle, chunking strategies (character-based and AST-aware), and multi-provider search. Integrates with **ChromaDB** for local persistence and provides a bridge for external MCP retrieval tools. +- **src/history.py:** Implements the core `HistoryManager` and `UISnapshot` logic for the non-provider undo/redo system. Manages state stacks with a fixed capacity and provides jumping capabilities. + - **src/paths.py:** Centralized module for path resolution. - **tree-sitter / AST Parsing:** For deterministic AST parsing and automated generation of curated "Skeleton Views" and "Targeted Views" (extracting specific functions and their dependencies). Features an integrated AST cache with mtime-based invalidation to minimize re-parsing overhead. Supplemented by `SummaryCache` which provides persistent, hash-based (SHA256) caching with LRU eviction for AI-generated file summaries. - **pydantic / dataclasses:** For defining strict state schemas (Tracks, Tickets) used in linear orchestration.