merge upstream v0.1.20

Author: dengmik-commits

.deepcode/AGENTS.md

@@ -8,21 +8,23 @@ src/
 ├── session.ts           # SessionManager — LLM loop, compaction, tool orchestration
 ├── settings.ts          # Settings resolution from ~/.deepcode/settings.json
 ├── prompt.ts            # System prompt builder, tool definitions, agent-drift-guard skill
-├── model-capabilities.ts # Model detection and thinking-mode defaults
+├── common/
+│   ├── model-capabilities.ts # Model detection and thinking-mode defaults
+│   ├── file-utils.ts    # File read/write with encoding and diff preview
+│   ├── shell-utils.ts   # Shell path resolution (Git Bash, zsh, bash)
+│   ├── state.ts         # In-memory file state and snippet tracking
+│   └── runtime.ts       # Tool validation runtime helpers
 ├── ui/
 │   ├── App.tsx          # Root Ink component — state, routing, session orchestration
 │   ├── PromptInput.tsx  # Multi-line input with slash commands, image paste, skills
 │   ├── MessageView.tsx  # Renders assistant/tool messages with markdown
+│   ├── DropdownMenu.tsx # Reusable dropdown for skill/model selection
 │   ├── SessionList.tsx  # Session picker for /resume
+│   ├── promptUndoRedo.ts # Ctrl+- undo / Ctrl+Shift+- redo for prompt input
 │   └── ...
 ├── mcp/
 │   ├── mcp-client.ts    # MCP client — JSON-RPC communication with MCP servers
 │   └── mcp-manager.ts   # MCP manager — lifecycle, tool registration, execution
-├── common/
-│   ├── file-utils.ts    # File read/write with encoding and diff preview
-│   ├── shell-utils.ts   # Shell path resolution (Git Bash, zsh, bash)
-│   ├── state.ts         # In-memory file state and snippet tracking
-│   └── runtime.ts       # Tool validation runtime helpers (executeValidatedTool, semanticBoolean)
 ├── tools/
 │   ├── executor.ts      # ToolExecutor — dispatches tool calls to handlers
 │   ├── bash-handler.ts  # Executes shell commands
@@ -32,9 +34,10 @@ src/
 │   ├── web-search-handler.ts # Web search tool
 │   └── ask-user-question-handler.ts # Interactive user prompts
 ├── tests/               # Test suite — one *.test.ts per module
-docs/
+templates/
 ├── tools/               # Tool descriptions fed to the LLM
 ├── prompts/             # EJS templates (e.g., init_command.md.ejs)
+docs/                    # User-facing documentation
 dist/                    # Bundled CLI output (gitignored)
 ```
 
@@ -49,7 +52,7 @@ dist/                    # Bundled CLI output (gitignored)
 | `npm run format:check` | Prettier in check-only mode |
 | `npm run check` | Runs typecheck + lint + format:check together |
 | `npm run bundle` | esbuild bundles `src/cli.tsx` → `dist/cli.js` (ESM, Node 18) |
-| `npm run build` | `check` + `bundle` — full CI gate before publish |
+| `npm run build` | `check` + `bundle` + chmod 755 — full CI gate before publish |
 | `npm test` | Runs all tests via `tsx --test src/tests/*.test.ts` |
 | `npm run test:single -- <file>` | Run a single test file (e.g., `npm run test:single -- src/tests/session.test.ts`) |
 
@@ -87,7 +90,8 @@ Run the CLI locally for manual testing: `node dist/cli.js` (after `npm run bundl
 - `fix:` — bug fix (e.g., `fix(ui): redraw cleanly after terminal resize`)
 - `chore:` — tooling, deps, hooks (e.g., `chore: add husky + lint-staged`)
 - `refactor:` — code restructuring (e.g., `refactor(ui): optimize App hooks`)
-- `style:` — formatting-only changes
+- `style:` — formatting-only changes (e.g., `style: adjust the tree structure symbols`)
+- `docs:` — documentation (e.g., `docs: add MCP configuration guide`)
 
 **Pull requests** should include:
 - A clear description of what changed and why
@@ -100,7 +104,7 @@ Run the CLI locally for manual testing: `node dist/cli.js` (after `npm run bundl
 
 The CLI renders a terminal UI using [Ink](https://github.com/vadimdemedes/ink) (React for terminals). `SessionManager` drives the LLM interaction loop: it builds system prompts, sends user messages with optional skills/images, streams responses, executes tool calls via `ToolExecutor`, and compacts context when token thresholds are exceeded (512K for DeepSeek V4 models, 128K for others).
 
-Six tools are available to the LLM: `bash`, `read`, `write`, `edit`, `AskUserQuestion`, and `WebSearch`. Tool definitions are registered in `src/tools/executor.ts` and described to the LLM via `src/prompt.ts` and `docs/tools/`.
+Six tools are available to the LLM: `bash`, `read`, `write`, `edit`, `AskUserQuestion`, and `WebSearch`. Tool definitions are registered in `src/tools/executor.ts` and described to the LLM via `src/prompt.ts` and `templates/tools/`.
 
 ## Agent-Specific Instructions
 

.lintstagedrc

@@ -1,5 +1,5 @@
 {
-  "*.{ts,tsx,js,mjs,cjs,ejs,jsx}": [
+  "*.{ts,tsx,js,mjs,cjs,jsx}": [
     "eslint --fix",
     "prettier --write"
   ],

AGENTS.md

@@ -0,0 +1,35 @@
+# Repository Guidelines
+
+## Project Structure & Module Organization
+
+- `src/` contains the TypeScript CLI implementation, with tool handlers in `src/tools/`, MCP integration in `src/mcp/`, UI components in `src/ui/`, and shared helpers in `src/common/`.
+- `src/tests/` contains Node test files named `*.test.ts`.
+- `templates/` contains runtime prompt assets: `templates/prompts/` for EJS prompt templates and `templates/tools/` for tool instruction Markdown loaded into the system prompt.
+- `docs/` is reserved for user-facing documentation such as configuration and MCP guides.
+- `resources/` stores static images used by the documentation or UI.
+
+## Build, Test, and Development Commands
+
+- `npm test` runs all test files with `tsx --test`.
+- `npm run test:single -- src/tests/<name>.test.ts` runs one test file.
+- `npm run typecheck` verifies TypeScript types without emitting files.
+- `npm run lint` checks ESLint rules for `src/`.
+- `npm run build` runs checks, bundles `src/cli.tsx` to `dist/cli.js`, and marks the bundle executable.
+
+## Coding Style & Naming Conventions
+
+- Use TypeScript ES modules and keep imports explicit.
+- Prefer small, focused functions; keep filesystem path construction centralized when a path is reused.
+- Use two-space indentation and Prettier-compatible formatting.
+- Respond in standard technical English. Avoid nonstandard phrasing and corporate jargon.
+
+## Testing Guidelines
+
+- Add or update tests in `src/tests/` when changing command behavior, prompt rendering, session flow, tools, or settings.
+- Prefer Node's built-in `node:test` and `node:assert/strict` APIs, matching the existing tests.
+- Keep tests deterministic by using temporary directories and mocked network calls where needed.
+
+## Commit & Pull Request Guidelines
+
+- Keep commits focused on a single change and use concise, imperative commit messages.
+- In pull requests, describe the behavior change, list verification commands, and note any packaging or template path changes.

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "@vegamo/deepcode-cli",
-  "version": "0.1.19",
+  "version": "0.1.20",
   "description": "Deep Code CLI - Vibe coding for the deepseek-v4 model in your terminal",
   "license": "MIT",
   "type": "module",
@@ -15,8 +15,8 @@
   "main": "./dist/cli.js",
   "files": [
     "dist/cli.js",
-    "docs/tools/**",
-    "docs/prompts/**",
+    "templates/tools/**",
+    "templates/prompts/**",
     "README.md",
     "LICENSE"
   ],

package.json

@@ -0,0 +1,16 @@
+export const DEEPSEEK_V4_MODELS = new Set(["deepseek-v4-flash", "deepseek-v4-pro"]);
+
+export const NON_MULTIMODAL_MODELS = new Set([
+  "deepseek-v4-pro",
+  "deepseek-v4-flash",
+  "deepseek-chat",
+  "deepseek-reasoner",
+]);
+
+export function defaultsToThinkingMode(model: string): boolean {
+  return DEEPSEEK_V4_MODELS.has(model);
+}
+
+export function supportsMultimodal(model: string): boolean {
+  return !NON_MULTIMODAL_MODELS.has(model.trim());
+}

src/debug-logger.ts src/common/debug-logger.tssrc/debug-logger.ts renamed to src/common/debug-logger.ts

@@ -1,4 +1,4 @@
-import type { ReasoningEffort } from "./settings";
+import type { ReasoningEffort } from "../settings";
 
 type ThinkingConfig = {
   type: "enabled" | "disabled";