diff --git a/docs/1.x-preview-guide.md b/docs/1.x-preview-guide.md index 90bf465..05382d1 100644 --- a/docs/1.x-preview-guide.md +++ b/docs/1.x-preview-guide.md @@ -90,6 +90,23 @@ Tool names have been standardized to short, canonical verbs across Auggie 1.x. I > > **Permission rules** recognize only a subset of legacy names: `view`, `save-file`, `save_file`, `str-replace-editor`, `str_replace_editor`, `grep-search`, `launch-process`, and `shell`. Other legacy names (such as `read_file`, `launch_process`, or `file_search`) are **not** matched by permission rules, so a deny or ask rule using them will not apply. Update permission rules to the canonical names before upgrading. +### Other Tool Changes +Beyond the renames above, several 0.x tools were merged into other tools or removed: + +| 0.x Tool | 1.x Replacement | +|---|---| +| `kill-process`, `read-process`, `write-process`, `list-processes`, `wait-process` | `terminal` (start a command, then manage it with `session_id` and an action such as `wait`, `signal`, or `kill`) | +| `apply_patch` | `edit` | +| `remove-files` | `bash` (e.g. `rm`) | +| `sub-agent` | `agent` (see custom subagents in `.augment/agents/`) | +| `conversation-retrieval` | `session-retrieval` | +| `diagnostics` | `lsp` (`diagnostics` action) | +| `view_tasklist`, `add_tasks`, `update_tasks`, `reorganize_tasklist` | Not available (see Task List below) | +| `render-mermaid` | Not available | +| `enter-plan-mode`, `exit-plan-mode` | Not available | + +Unchanged in 1.x: `codebase-retrieval`, `web-fetch`, `web-search`, `ask-user`, `view-session`, and integration tools such as GitHub, Linear, Jira, Confluence, and Notion. + ### Hook Payloads: Changed Files Detection In 0.x, hook events for shell execution attempted to calculate and inject an internal list of modified files into the hook payload. This has been removed from `bash` hooks (and is being phased out across other tool hooks). Hooks requiring a list of modified files should rely directly on version control (e.g., `git status --porcelain` or `git diff --name-only`) rather than tool-level payload heuristics. @@ -100,6 +117,7 @@ In 0.x, hook events for shell execution attempted to calculate and inject an int ### Not Compatible The following 0.x features will not be supported in 1.x: - **Chat Input Completions**: Inline completions while typing in the chat input are not available, and the `chatInputCompletions` setting in `settings.json` is ignored. +- **Task List**: The 0.x task list (`/task` and the `view_tasklist`, `add_tasks`, `update_tasks`, and `reorganize_tasklist` tools) is not available. Existing 0.x task lists are not carried over. ---