deepy-cli 0.2.11__tar.gz → 0.2.13__tar.gz

{deepy_cli-0.2.11 → deepy_cli-0.2.13}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: deepy-cli
-Version: 0.2.11
+Version: 0.2.13
 Summary: Deepy - Vibe coding for DeepSeek models in your terminal
 Keywords: deepseek,coding-agent,terminal,cli,agents
 Author: kirineko
@@ -15,8 +15,10 @@ Classifier: Topic :: Terminals
 Requires-Dist: openai-agents>=0.17.0
 Requires-Dist: openai>=2.26,<3
 Requires-Dist: orjson>=3.10,<4
+Requires-Dist: pathspec>=1.1.1
 Requires-Dist: pydantic>=2.12,<3
 Requires-Dist: prompt-toolkit>=3.0,<4
+Requires-Dist: regex>=2026.5.9
 Requires-Dist: pyyaml>=6.0,<7
 Requires-Dist: rich>=14.2,<15
 Requires-Dist: textual>=8.2,<9

{deepy_cli-0.2.11 → deepy_cli-0.2.13}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "deepy-cli"
-version = "0.2.11"
+version = "0.2.13"
 description = "Deepy - Vibe coding for DeepSeek models in your terminal"
 readme = "README.md"
 authors = [
@@ -21,8 +21,10 @@ dependencies = [
     "openai-agents>=0.17.0",
     "openai>=2.26,<3",
     "orjson>=3.10,<4",
+    "pathspec>=1.1.1",
     "pydantic>=2.12,<3",
     "prompt-toolkit>=3.0,<4",
+    "regex>=2026.5.9",
     "pyyaml>=6.0,<7",
     "rich>=14.2,<15",
     "textual>=8.2,<9",

{deepy_cli-0.2.11 → deepy_cli-0.2.13}/src/deepy/__init__.py

@@ -1,6 +1,6 @@
 from __future__ import annotations
 
-__version__ = "0.2.11"
+__version__ = "0.2.13"
 
 
 def main() -> None:

deepy_cli-0.2.13/src/deepy/data/tools/Search.md

@@ -0,0 +1,20 @@
+## Search
+
+Search local project files without shell `grep`, `find`, or `rg`.
+
+Args: `query`, `path`, `glob`, `mode`, `output_mode`, `case_sensitive`,
+`context`, `limit`, `offset`, `include_ignored`.
+
+Use `Search` for repository code/text search before falling back to `shell`.
+It is built into Deepy and does not require ripgrep or platform-specific shell
+commands. It is read-only.
+
+Defaults and guidance:
+- Use `mode: "literal"` unless the user clearly needs a regex.
+- Use `output_mode: "files"` for broad discovery, then `read_file` specific
+  files or rerun with `output_mode: "content"`.
+- Use `output_mode: "count"` to understand match distribution.
+- Use `glob` or a narrower `path` to keep results focused.
+- Use `limit` and `offset` to page through large result sets.
+- Leave `include_ignored` false unless ignored build artifacts or dependencies
+  are explicitly relevant. Sensitive files are still filtered.

deepy_cli-0.2.13/src/deepy/data/tools/apply_patch.md

@@ -0,0 +1,68 @@
+## apply_patch
+
+Batch structured file operations in one call.
+
+Args: `operations`.
+
+Use this when a change has multiple edits in one file, touches multiple files,
+creates/deletes/moves files, replaces a larger block, or needs one all-or-nothing
+preflight before writing. Use `edit_text` only for one small single-file exact
+edit where `old_string` and `new_string` are straightforward.
+
+Each operation is an object with a `type` and the fields relevant to that type.
+Set unrelated nullable fields to `null` when required by the schema.
+
+Supported operation types:
+
+- `create_file`: create a new text file with `file_path` and `content`.
+- `replace_file`: explicitly replace a whole existing file with `file_path`,
+  `content`, `overwrite=true`, and either `snapshot_id` or `expected_hash`.
+- `delete_file`: delete `file_path`.
+- `move_file`: move `file_path` to `destination_path`.
+- `replace_block`: replace exact `old_text` with `new_text`.
+- `insert_before`: insert `content` before exact `anchor`.
+- `insert_after`: insert `content` after exact `anchor`.
+- `replace_all`: replace every exact `old_text` match with `new_text`.
+
+Example:
+
+```json
+{
+  "operations": [
+    {
+      "type": "replace_block",
+      "file_path": "portfolio/index.html",
+      "old_text": "<p>Old bio</p>",
+      "new_text": "<p>New bio</p>",
+      "expected_occurrences": 1,
+      "destination_path": null,
+      "content": null,
+      "anchor": null,
+      "replace_all": null,
+      "overwrite": null,
+      "snapshot_id": null,
+      "expected_hash": null
+    },
+    {
+      "type": "insert_after",
+      "file_path": "portfolio/styles.css",
+      "anchor": ".about {\\n  display: grid;\\n}\\n",
+      "content": "\\n.about-tags {\\n  display: flex;\\n}\\n",
+      "expected_occurrences": 1,
+      "destination_path": null,
+      "old_text": null,
+      "new_text": null,
+      "replace_all": null,
+      "overwrite": null,
+      "snapshot_id": null,
+      "expected_hash": null
+    }
+  ]
+}
+```
+
+Deepy preflights all operations before committing file side effects, preserves
+existing encodings and line endings on updates, writes new text files as UTF-8
+without BOM, and returns per-operation, changed-file, diff, and diff-preview
+metadata. Exact text and anchor operations reject absent, ambiguous, no-op, and
+unexpected-count matches with structured diagnostics.

deepy_cli-0.2.13/src/deepy/data/tools/edit_text.md

@@ -0,0 +1,21 @@
+## edit_text
+
+Make a small exact/string edit to an existing text file.
+
+Args: `file_path`, `old_string`, `new_string`, `replace_all`,
+`expected_occurrences`, optional `snippet_id`.
+
+Use this for focused edits where the current text is known. Prefer
+`expected_occurrences` as a safety check, especially with `replace_all`. If a
+partial `read_file` returned a `snippet_id`, pass it only when you intentionally
+want to restrict the replacement to that snippet. For ordinary single-file exact
+edits, pass `file_path` and omit `snippet_id`; Deepy can internally promote a
+fresh partial read to a full-file exact edit when needed. Do not pass
+`snapshot_id` as `snippet_id`; snapshots are for stale protection, while
+snippets are only returned by partial reads.
+
+Deepy preserves the existing file encoding and line endings, rejects stale files,
+rejects no-op edits, and returns structured error metadata for missing,
+ambiguous, or count-mismatched replacements. Use `apply_patch` when there are
+multiple edits in one file, multiple files, create/delete/move operations, or a
+larger block replacement.

deepy_cli-0.2.13/src/deepy/data/tools/read_file.md

@@ -0,0 +1,16 @@
+## read_file
+
+Read files or list directories before changes.
+
+Args: `file_path`, optional `offset`, optional `limit`, optional `pages`.
+
+Text output includes line numbers. Full text reads record a managed snapshot with
+encoding, line-ending, snapshot id, and content hash metadata for later
+`edit_text`, `write_file`, or `apply_patch` calls. Partial reads return snippet
+metadata that can scope later `edit_text` calls but do not authorize unrestricted
+whole-file replacement. For normal single-file exact edits after a partial read,
+prefer `edit_text` with `file_path` and no `snippet_id`; use the snippet only
+when you need to constrain the replacement to that line range.
+
+Non-text files such as images, notebooks, and PDFs may return descriptive
+metadata, but they are not tracked for text mutation.

deepy_cli-0.2.13/src/deepy/data/tools/write_file.md

@@ -0,0 +1,13 @@
+## write_file
+
+Create a new text file or explicitly replace a whole file.
+
+Args: `file_path`, `content`, `overwrite`, optional `snapshot_id`, optional
+`expected_hash`.
+
+For new files, Deepy writes UTF-8 without BOM by default. For existing files,
+whole-file replacement requires `overwrite=true` and a fresh `snapshot_id` or
+`expected_hash` from `read_file`; this prevents accidental stale rewrites.
+
+Prefer `edit_text` for small targeted edits and `apply_patch` for structured or
+multi-file edits.

{deepy_cli-0.2.11 → deepy_cli-0.2.13}/src/deepy/prompts/system.py

@@ -43,10 +43,11 @@ def build_system_prompt(
     return f"""You are Deepy, a terminal coding agent in the user's project.
 
 Core rules:
-- Work in the repo with tools: inspect, modify, test, verify.
+- Work in the repo with tools: inspect, edit, test, verify.
 - Preserve user changes. Prefer small, verifiable edits.
-- Read existing files when you need context; exact `modify` edits can establish the managed snapshot internally.
-- Use `modify` for file changes: `content` only creates new files; existing files use `old_string`/`new_string`.
+- Use `Search` for local project code/text search instead of shell `grep`, `find`, or `rg`; narrow with `path`, `glob`, `output_mode`, `limit`, and `offset`.
+- Read existing files when you need context; exact `edit_text` edits can establish the managed snapshot internally.
+- Use `edit_text` for one small single-file exact edit. Use structured `apply_patch.operations` when a change has multiple edits in one file, touches multiple files, creates/deletes/moves files, or replaces a larger block. Use `write_file` for new files or explicit whole-file replacement.
 - After project generators create scaffold files, read and edit the generated block instead of replacing the file.
 - Run shell commands using the Runtime context's command dialect and path style: `powershell` -> PowerShell with Windows paths; `cmd` -> cmd; `posix` -> POSIX shell.
 - Match visible thinking/reasoning language to the user's latest natural language. If the user asks in Chinese, you MUST write visible thinking/reasoning in Chinese unless they explicitly request another language. Do not switch visible thinking/reasoning to English for Chinese requests.

{deepy_cli-0.2.11 → deepy_cli-0.2.13}/src/deepy/prompts/tool_docs.py

@@ -5,8 +5,11 @@ from importlib import resources
 
 TOOL_DOC_FILES = (
     "shell.md",
-    "read.md",
-    "modify.md",
+    "Search.md",
+    "read_file.md",
+    "edit_text.md",
+    "write_file.md",
+    "apply_patch.md",
     "AskUserQuestion.md",
     "WebSearch.md",
     "WebFetch.md",