dave-code 1.0.3 → 1.1.0

package/README.md

@@ -5,10 +5,17 @@ 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.
+- 🧭 **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.
 - ⚙️ **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.
+- 🧠 **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 +42,17 @@ 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`, and `temperature`.
+
 ## Available Commands
 
 - `/help` - Show help instructions.
 - `/stats` / `/tokens` - Display session and last request token usage statistics.
 - `/effort` - Interactively adjust AI thinking/reading effort level.
+- `/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.
 - `/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 +61,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, read, and 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`.
+
 ## License
 
 ISC License.