dave-code 1.0.4 → 1.2.0

package/README.md

@@ -5,10 +5,19 @@ A terminal-based AI coding assistant CLI similar to Claude Code. Dave Code integ
 ## Features
 
 - ⚡ **Interactive CLI REPL**: Ask questions and run commands in your workspace with animated terminal visual elements.
-- ⚙️ **Effort Presets**: Adjust AI's effort level from `/effort` (choose between `low`, `medium`, `high`, `xhigh`, `max`, and `ultracode`) to control token consumption and task complexity.
-- 📖 **Smart Incremental Reading (精读模式)**: For non-ultra modes, the assistant silently and delicately reads large files in precise range chunks (e.g. lines 40-100) instead of loading the entire file, saving context tokens and prevent terminal warning clutter.
-- 🔄 **Ultracode Digestion Workflow**: In `ultracode` mode, read and digest large files (>1000 lines) concurrently in chunks with live, animated progress indicators.
-- 🧠 **DeepSeek Reasoning Support**: Detects and cleanly renders internal reasoning (`<think>` blocks) in grey, preventing raw HTML tags from polluting your terminal.
+- 🧭 **Structured Activity Timeline**: Model requests, tool calls, permissions, retries, and context compaction use one stable event-driven terminal renderer.
+- 🔒 **Explicit Coding Turns**: Normal chat is read-only. Workspace changes are available only through a non-empty `/code ...` request and every mutation is still confirmed.
+- 📋 **Persistent Named Plans**: `/plan name: request` creates a detailed what-and-how implementation plan. Multiple plans are stored per workspace and shown in the status panel.
+- ✍️ **Stream-Aware Answers**: Anthropic, OpenAI-compatible, and Gemini endpoints use streaming transport with automatic fallback; text is committed after tool/final classification so tool prefaces cannot overlap the UI.
+- 🛠️ **Complete Workspace Tools**: Read, search, focused exact edits, file creation, directory creation, move, delete, and workspace command execution, including recovery of DeepSeek DSML tool calls.
+- 🔐 **Confirmed Mutations**: Edits, writes, moves, deletes, and commands show a preview and require approval before changing the workspace.
+- 💾 **Workspace-Aware Sessions**: New sessions remember their workspace and active file. Older sessions without workspace metadata require one `/open <project-directory>` before file tools can continue.
+- 🔎 **Adaptive Scan**: every repository task starts with a scan that chooses an active-context budget and a compact reading strategy. On first Highway use, Dave outlines effective files locally, reads only key entry/configuration/request-related source, and creates the notebook with one synthesis call for typical repositories. Later scans reuse the ready notebook directly.
+- 🗒️ **Private Highway Notebook**: the per-workspace notebook keeps twelve fixed project-analysis sections plus evidence-backed file cards under `~/.dave-code-notes/`. It is never printed automatically, detects external drift, and refreshes after Dave changes code.
+- 📖 **Budget-Aware Reading**: Files that fit the active budget can be read whole; larger results are streamed in numbered pages with a stable continuation cursor.
+- 🧭 **Coherent Context Cache**: Unchanged outlines and ranges replay their exact content. Older tool results are summarized only after the model has received the complete latest result.
+- 🧠 **Workspace Memory**: Durable preferences, conventions, architecture facts, commands, decisions, and debugging learnings can be extracted across chats, retrieved by relevance, and audited or disabled with `/memory`.
+- 🧠 **Reasoning Privacy**: Removes `<think>` and reasoning blocks from the terminal and future conversation context.
 - 📊 **Token Usage Statistics**: Real-time prompt, completion, and total token usage tracked and printed after each request. Run `/stats` or `/tokens` to see session totals.
 - 🌐 **Proxy & Key Configuration**: Interactively configure API keys, models, base URLs, and proxies via `/config`, `/model`, or `/api`.
 
@@ -35,11 +44,34 @@ npm install -g dave-code
 
 3. Type `/help` to see list of available commands.
 
+Streaming is enabled by default. Set `DAVE_CODE_STREAM=0` to force compatibility mode for endpoints that do not support SSE. Set `DAVE_CODE_DEBUG=1` to enable local request diagnostics; API credentials are redacted.
+
+Dave uses native structured tools for OpenAI-compatible, Anthropic, and Gemini providers. For an older endpoint that only understands text tags, set `"toolMode": "legacy"` in that profile. Optional profile fields include `provider`, `maxOutputTokens`, `contextWindowTokens`, and `temperature`. Dave recognizes common model context windows automatically; set `contextWindowTokens` for custom endpoints or models whose limits differ.
+
+Dave renders terminal-safe Markdown instead of printing its source markers. Headings, emphasis, inline and fenced code, lists, quotes, links, and tables receive a readable terminal layout. Wide tables automatically switch to a vertical field view. Common LaTeX written as `$...$`, `$$...$$`, `\(...\)`, or `\[...\]` is converted to Unicode mathematics for terminals.
+
+Font family and font size are controlled by the host terminal (for example Windows Terminal, iTerm2, or the IDE terminal), not by a portable CLI escape sequence. Dave adapts its layout to the reported terminal width and caps prose width for readability; change the font in the terminal profile and Dave will reflow on the next render.
+
 ## Available Commands
 
+Dave Code has two session-scoped workflows. **Highway** uses a focused single Agent. **Thunder** creates a PM-led office team, negotiates staffing and validation depth, performs parallel read-only planning, and waits for an explicit `/code <plan>` before any workspace change. Both modes use `Scan → Read → Act → Verify` and share the same workspace snapshot cache.
+
+Highway keeps the visible `Scan → Read → Act → Verify` track. Scan is deliberately lightweight: it inspects cached metadata, compact file outlines, and the private notebook catalog, then makes one capped planning call. Dave uses the recommended read plan automatically; set `DAVE_CODE_REVIEW_PLAN=1` when an interactive pre-read review is desired.
+
+READ creates or incrementally updates the private notebook. The model receives only a compact read brief and can fetch notebook sections on demand, so the same long notebook text is not resent on every tool step. Token budgets are soft warnings; physical context pressure triggers automatic structured compaction while recent messages remain lossless. Thunder intentionally keeps its metadata-only team scan.
+
+Use `/mode highway`, `/mode thunder`, or `/thunder <request>`. Use `/agents` to inspect the latest active Thunder team. Thunder defaults to six members and four concurrent model requests; its performance tier requires explicit approval.
+
+Running `/mode` opens a two-position horizontal selector. Use the left/right arrow keys and Enter; entering Thunder plays a short green activation transition before the team workflow starts.
+
 - `/help` - Show help instructions.
 - `/stats` / `/tokens` - Display session and last request token usage statistics.
-- `/effort` - Interactively adjust AI thinking/reading effort level.
+- `/effort` - Deprecated compatibility notice; adaptive Scan now chooses context budgets automatically.
+- `/memory` - View, toggle, or delete cross-chat memories for the current workspace.
+- `/note status|refresh|rebuild|clear` - Inspect or maintain the private Highway project notebook without displaying its body. Thunder reports this command as unsupported.
+- `/plan <name>: <request>` - Create a read-only implementation plan that explains both what to change and how to change it. Run `/plan` without arguments to manage saved plans.
+- `/code <request-or-plan-name>` - Authorize one coding turn. `/code @<plan-name>` selects a plan explicitly and `/code --prompt <text>` forces an ad-hoc request.
+- `/undo` - Restore the most recent file mutation recorded by the current Dave process.
 - `/model` - Switch active LLM profile.
 - `/api` - Set or change the API key for the active profile.
 - `/open <path>` - Open a file or folder in your workspace.
@@ -48,6 +80,8 @@ npm install -g dave-code
 - `/lang` - Switch terminal interface between Chinese and English.
 - `/exit` - Exit the assistant.
 
+Read-only chat and planning can list, glob, read, and regex-search workspace files. Sensitive files such as `.env`, private keys, certificates, and credential files always require explicit confirmation before their contents are sent to a model. Commands, writes, edits, directory creation, moves, and deletes are blocked outside `/code`. Mutation prompts accept `y` for this action, `a` for the same tool during the current turn, and `n` to deny; move and delete always ask individually.
+
 ## License
 
 ISC License.