nanocode-cli 0.5.9__tar.gz → 0.5.11__tar.gz

{nanocode_cli-0.5.9/nanocode_cli.egg-info → nanocode_cli-0.5.11}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nanocode-cli
-Version: 0.5.9
+Version: 0.5.11
 Summary: A small terminal coding agent written in Python
 Author-email: hit9 <hit9@icloud.com>
 License-Expression: BSD-3-Clause
@@ -22,7 +22,7 @@ Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: anthropic>=0.64.0
-Requires-Dist: code-symbol-index>=0.1.13
+Requires-Dist: code-symbol-index>=0.3.0
 Requires-Dist: json-repair
 Requires-Dist: openai>=2.37.0
 Requires-Dist: prompt-toolkit>=3.0
@@ -39,6 +39,8 @@ A small terminal coding agent written in Python.
 
 [简体中文](README.zh-CN.md)
 
+[Chinese blog](https://hit9.dev/post/nanocode)
+
 nanocode is pre-1.0 software. Commands, configuration, and tool behavior may change before a stable release.
 
 ![nanocode screenshot](snapshots/nanocode-snapshot.png)
@@ -48,7 +50,7 @@ nanocode is pre-1.0 software. Commands, configuration, and tool behavior may cha
 - **Live turn control**: Add follow-up input while the agent is still working, without losing the current tool flow.
 - **File-state brain**: Reads and edits build a current, line-numbered view of the files that matter now.
 - **Stale-edit protection**: `line:hash` anchors reject edits when the target code has drifted.
-- **Project-aware navigation**: Use the symbol index to jump through outlines, references, and changed files quickly.
+- **Project-aware navigation**: Use the symbol index to jump through outlines, references, implementors, call chains, and changed files quickly.
 - **Recoverable context**: Tool output stays bounded in the prompt, while raw `tr.N` results remain recallable.
 - **Cache-aware context**: Stable sections stay early and noisy working state stays late to improve prompt-cache reuse.
 - **Focused working memory**: `Note` separates goal, plan, and known facts from noisy execution logs.
@@ -138,6 +140,16 @@ Main fields:
 
 `api = "auto"` chooses between Chat Completions and Anthropic Messages using provider/model profiles. `prompt_cache_key = "auto"` derives a stable key from provider, model, workspace, and tool schema names.
 
+
+## Tested Providers
+
+The following providers have been tested with nanocode:
+
+- **deepseek**: DeepSeek API
+- **opencode**: OpenCode API
+- **aliyun**: Alibaba Cloud (Tongyi Qianwen) API via Chat Completions
+- **llama.cpp**: Local inference via llama.cpp server
+
 ## Context Design
 
 Each model request is built manually from explicit messages. Stable context comes first, conversation stays as messages, working memory follows, and the latest file state is appended at the end.

{nanocode_cli-0.5.9 → nanocode_cli-0.5.11}/README.md

@@ -4,6 +4,8 @@ A small terminal coding agent written in Python.
 
 [简体中文](README.zh-CN.md)
 
+[Chinese blog](https://hit9.dev/post/nanocode)
+
 nanocode is pre-1.0 software. Commands, configuration, and tool behavior may change before a stable release.
 
 ![nanocode screenshot](snapshots/nanocode-snapshot.png)
@@ -13,7 +15,7 @@ nanocode is pre-1.0 software. Commands, configuration, and tool behavior may cha
 - **Live turn control**: Add follow-up input while the agent is still working, without losing the current tool flow.
 - **File-state brain**: Reads and edits build a current, line-numbered view of the files that matter now.
 - **Stale-edit protection**: `line:hash` anchors reject edits when the target code has drifted.
-- **Project-aware navigation**: Use the symbol index to jump through outlines, references, and changed files quickly.
+- **Project-aware navigation**: Use the symbol index to jump through outlines, references, implementors, call chains, and changed files quickly.
 - **Recoverable context**: Tool output stays bounded in the prompt, while raw `tr.N` results remain recallable.
 - **Cache-aware context**: Stable sections stay early and noisy working state stays late to improve prompt-cache reuse.
 - **Focused working memory**: `Note` separates goal, plan, and known facts from noisy execution logs.
@@ -103,6 +105,16 @@ Main fields:
 
 `api = "auto"` chooses between Chat Completions and Anthropic Messages using provider/model profiles. `prompt_cache_key = "auto"` derives a stable key from provider, model, workspace, and tool schema names.
 
+
+## Tested Providers
+
+The following providers have been tested with nanocode:
+
+- **deepseek**: DeepSeek API
+- **opencode**: OpenCode API
+- **aliyun**: Alibaba Cloud (Tongyi Qianwen) API via Chat Completions
+- **llama.cpp**: Local inference via llama.cpp server
+
 ## Context Design
 
 Each model request is built manually from explicit messages. Stable context comes first, conversation stays as messages, working memory follows, and the latest file state is appended at the end.

{nanocode_cli-0.5.9 → nanocode_cli-0.5.11}/README.zh-CN.md

@@ -4,6 +4,8 @@
 
 [English](README.md)
 
+[中文博客](https://hit9.dev/post/nanocode)
+
 nanocode 仍是 1.0 前的软件。稳定版发布前，命令、配置和工具行为都可能变化。
 
 ![nanocode screenshot](snapshots/nanocode-snapshot.png)
@@ -103,6 +105,15 @@ nanocode --init-config
 
 `api = "auto"` 会根据 provider/model profile 在 Chat Completions 和 Anthropic Messages 之间选择。`prompt_cache_key = "auto"` 会根据 provider、model、workspace 和工具 schema 名称生成稳定 key。
 
+
+## 已测试的 Provider
+
+以下 provider 已在 nanocode 中测试通过：
+
+- **deepseek**: DeepSeek API
+- **opencode**: OpenCode API
+- **aliyun**: 阿里云通义千问 API（Chat Completions）
+- **llama.cpp**: 通过 llama.cpp 服务端本地推理
 ## 上下文设计
 
 每次模型请求都由 nanocode 手动构建成明确的 messages。稳定上下文在前，会话作为 messages 保留，工作记忆随后，最新文件状态放在末尾。

{nanocode_cli-0.5.9 → nanocode_cli-0.5.11}/nanocode.py

@@ -55,7 +55,7 @@ from prompt_toolkit.widgets import SearchToolbar
 from rich.console import Console
 from rich.markdown import Markdown
 
-__version__ = "0.5.9"
+__version__ = "0.5.11"
 
 Json = dict[str, Any]
 HTTP_USER_AGENT = "nanocode/" + __version__
@@ -553,6 +553,7 @@ class Session:
     tool_counter: int = 0
     usage: ModelUsage = field(default_factory=ModelUsage)
     update: UpdateStatus = field(default_factory=UpdateStatus)
+    _gitignore_cache: dict[str, tuple[int, list[str]]] = field(default_factory=dict)
 
     def __post_init__(self) -> None:
         if self.system_info is None:
@@ -759,12 +760,23 @@ class Tool:
 
     def gitignore_patterns(self, root: str) -> list[str]:
         patterns = []
-        for path in dict.fromkeys([os.path.join(self.session.cwd, ".gitignore"), *([os.path.join(root, ".gitignore")] if os.path.isdir(root) else [])]):
+        cache = self.session._gitignore_cache
+        paths = [os.path.join(self.session.cwd, ".gitignore")]
+        if os.path.isdir(root):
+            paths.append(os.path.join(root, ".gitignore"))
+        for path in dict.fromkeys(paths):
             try:
+                mtime = os.stat(path).st_mtime_ns
+                cached = cache.get(path)
+                if cached is not None and cached[0] == mtime:
+                    patterns.extend(cached[1])
+                    continue
                 with open(path, encoding="utf-8") as file:
-                    patterns.extend(line.strip() for line in file if line.strip() and not line.lstrip().startswith("#") and not line.startswith("!"))
+                    pats = [line.strip() for line in file if line.strip() and not line.lstrip().startswith("#") and not line.startswith("!")]
+                cache[path] = (mtime, pats)
+                patterns.extend(pats)
             except OSError:
-                pass
+                cache.pop(path, None)
         return patterns
 
     def ignored(self, path: str, patterns: list[str]) -> bool:
@@ -1435,31 +1447,44 @@ class InspectCodeTool(Tool):
     NAME = "InspectCode"
     MAX_LIMIT: ClassVar[int] = 80
     MAX_OUTLINE_LIMIT: ClassVar[int] = 1000
-    DESCRIPTION = "Use the code index: find returns symbols, inspect returns anchors/members/references, outline returns a file symbol tree."
-    SIGNATURE = "InspectCode(mode,target,kind?,path?,symbol?,limit?,exact_only?)"
+    MAX_DEPTH: ClassVar[int] = 5
+    MODES: ClassVar[tuple[str, ...]] = ("find", "inspect", "outline", "refs", "impls", "callers", "callees")
+    SYMBOL_MODES: ClassVar[frozenset[str]] = frozenset({"find", "inspect", "refs", "impls", "callers", "callees"})
+    RESOLVE_MODES: ClassVar[frozenset[str]] = frozenset({"inspect", "refs", "impls", "callers", "callees"})
+    CHAIN_MODES: ClassVar[frozenset[str]] = frozenset({"callers", "callees"})
+    OPTION_KEYS: ClassVar[tuple[str, ...]] = ("limit", "kind", "path", "symbol", "exact_only", "depth", "offset", "all_kinds", "ref_kind", "loose")
+    DESCRIPTION = "Use the code index: find returns symbols; inspect returns anchors/members/references; outline returns a file symbol tree; refs lists classified references; impls lists implementors; callers/callees walk the call chain."
+    SIGNATURE = "InspectCode(mode,target,kind?,path?,symbol?,limit?,exact_only?,depth?,offset?,all_kinds?,ref_kind?,loose?)"
     EXAMPLE = (
         'Find symbols; kind can be class|function|method|variable|constant|enum|struct|interface|module|type|trait|field|property|impl|namespace|dict_key, comma-ok. Example: {"mode":"find","target":"Tool","kind":"class,function","limit":20}',
-        'Find exact symbol in a path. Example: {"mode":"find","target":"Session","path":"src","exact_only":true,"limit":10}',
         'Inspect one symbol; path narrows candidates. Example: {"mode":"inspect","target":"Tool","path":"src/app.py"}',
         'Outline one file; symbol narrows subtree. Example: {"mode":"outline","target":"src/app.py","symbol":"App","limit":300}',
+        'List references; default hides import/attribute noise, ref_kind filters to call|read|write|inherit|type|import|attribute|usage (comma-ok), all_kinds shows everything, offset pages. Example: {"mode":"refs","target":"Tool","ref_kind":"call,write","offset":0}',
+        'List implementors of an interface/base. Example: {"mode":"impls","target":"Tool","kind":"class"}',
+        'Walk transitive callers/callees up to depth; callees loose includes ambiguous cross-module matches. Example: {"mode":"callers","target":"handle_job","depth":3}',
     )
 
     @classmethod
     def params_schema(cls) -> Json:
         props = {
-            "mode": {"type": "string", "enum": ["find", "inspect", "outline"]},
+            "mode": {"type": "string", "enum": list(cls.MODES)},
             "target": {"type": "string"},
             "limit": {"type": "integer", "minimum": 1, "maximum": cls.MAX_OUTLINE_LIMIT},
             "kind": {"type": "string"},
             "path": {"type": "string"},
             "symbol": {"type": "string"},
             "exact_only": {"type": "boolean"},
+            "depth": {"type": "integer", "minimum": 1, "maximum": cls.MAX_DEPTH},
+            "offset": {"type": "integer", "minimum": 0},
+            "all_kinds": {"type": "boolean"},
+            "ref_kind": {"type": "string"},
+            "loose": {"type": "boolean"},
         }
         return {"type": "object", "properties": props, "required": ["mode", "target"], "additionalProperties": False}
 
     @classmethod
     def payload_args(cls, payload: Json) -> list[Any]:
-        options = {key: payload[key] for key in ("limit", "kind", "path", "symbol", "exact_only") if key in payload}
+        options = {key: payload[key] for key in cls.OPTION_KEYS if key in payload}
         return [str(payload.get("mode") or ""), str(payload.get("target") or ""), *([options] if options else [])]
 
     def call(self) -> str:
@@ -1471,22 +1496,37 @@ class InspectCodeTool(Tool):
         if len(self.args) == 3 and not isinstance(self.args[2], dict):
             raise ToolError("InspectCode options must be an object")
         options = self.args[2] if len(self.args) == 3 else {}
-        if unexpected := sorted(set(options) - {"limit", "kind", "path", "symbol", "exact_only"}):
+        if unexpected := sorted(set(options) - set(self.OPTION_KEYS)):
             raise ToolError("InspectCode unexpected option: " + ", ".join(unexpected))
-        if mode not in {"find", "inspect", "outline"}:
-            raise ToolError("InspectCode mode must be find, inspect, or outline")
+        if mode not in self.MODES:
+            raise ToolError("InspectCode mode must be one of: " + ", ".join(self.MODES))
         if not target:
             raise ToolError("InspectCode target is required")
-        if mode in {"find", "inspect"} and re.search(r"\s", target):
+        if mode in self.SYMBOL_MODES and re.search(r"\s", target):
             raise ToolError("InspectCode symbol target must not contain whitespace")
-        if mode == "inspect" and (target.endswith(".py") or os.path.exists(self.session.resolve_path(target))):
-            raise ToolError("InspectCode inspect target must be a symbol, not a file")
+        if mode in self.RESOLVE_MODES and (target.endswith(".py") or os.path.exists(self.session.resolve_path(target))):
+            raise ToolError(f"InspectCode {mode} target must be a symbol, not a file")
         if mode == "outline" and not os.path.isfile(self.session.resolve_path(target)):
             raise ToolError("InspectCode outline target must be an existing file")
         limit = options.get("limit")
         max_limit = self.MAX_OUTLINE_LIMIT if mode == "outline" else self.MAX_LIMIT
         if limit is not None and (isinstance(limit, bool) or not isinstance(limit, int) or limit < 1 or limit > max_limit):
             raise ToolError(f"InspectCode {mode} limit must be 1..{max_limit}")
+        depth = options.get("depth")
+        if depth is not None and (isinstance(depth, bool) or not isinstance(depth, int) or depth < 1 or depth > self.MAX_DEPTH):
+            raise ToolError(f"InspectCode depth must be 1..{self.MAX_DEPTH}")
+        offset = options.get("offset")
+        if offset is not None and (isinstance(offset, bool) or not isinstance(offset, int) or offset < 0):
+            raise ToolError("InspectCode offset must be >= 0")
+        ref_kind = options.get("ref_kind")
+        if ref_kind is not None:
+            if not isinstance(ref_kind, str):
+                raise ToolError("InspectCode ref_kind must be a string")
+            if options.get("all_kinds"):
+                raise ToolError("InspectCode ref_kind and all_kinds are mutually exclusive")
+            tokens = [token.strip() for token in ref_kind.split(",") if token.strip()]
+            if unknown := sorted(set(tokens) - csi.REFERENCE_KINDS):
+                raise ToolError("InspectCode unknown ref_kind: " + ", ".join(unknown) + "; valid: " + ", ".join(sorted(csi.REFERENCE_KINDS)))
         index = CodeIndex(self.session)
         if not index.available():
             raise ToolError("code index is not available; run /index")
@@ -1508,6 +1548,16 @@ class InspectCodeTool(Tool):
             return csi.search(target, limit=limit or csi.DEFAULT_SEARCH_LIMIT, **common)
         if mode == "inspect":
             return csi.inspect(target, limit=limit or csi.DEFAULT_PAGE_LIMIT, anchors=True, **common)
+        if mode == "refs":
+            ref_kinds = options.get("ref_kind") or ("all" if options.get("all_kinds") else "behavioral")
+            return csi.refs(target, limit=limit or csi.DEFAULT_MAX_REFERENCES, offset=int(options.get("offset") or 0), ref_kinds=ref_kinds, **common)
+        if mode == "impls":
+            return csi.impls(target, limit=limit or csi.DEFAULT_MAX_IMPLEMENTORS, offset=int(options.get("offset") or 0), **common)
+        if mode in self.CHAIN_MODES:
+            depth = int(options.get("depth") or 3)
+            if mode == "callees":
+                return csi.callees(target, limit=limit or csi.DEFAULT_MAX_CALLEES, depth=depth, loose=bool(options.get("loose")), **common)
+            return csi.callers(target, limit=limit or csi.DEFAULT_MAX_CALLERS, depth=depth, **common)
         symbol = options.get("symbol") or None
         return csi.outline(
             target, root=self.session.cwd, symbol=str(symbol) if symbol else None, max_symbols=limit or csi.DEFAULT_MAX_OUTLINE_SYMBOLS, format="text"
@@ -1746,7 +1796,7 @@ class EditTool(Tool):
 
 class BashTool(Tool):
     NAME = "Bash"
-    DESCRIPTION = "Run one bash shell invocation in the workspace; returns exit_code/stdout/stderr and shows live output."
+    DESCRIPTION = "Run one bash shell invocation in the workspace; returns exit_code/stdout/stderr and shows live output. Avoid unbounded output; limit noisy commands with head/tail/sed/rg filters or command-specific limits, and inspect large outputs in chunks."
     SIGNATURE = "Bash(command)"
     EXAMPLE = (
         'Check environment. Example: {"command":"python3 --version"}',
@@ -1873,7 +1923,7 @@ class BashTool(Tool):
 
 class GitTool(Tool):
     NAME = "Git"
-    DESCRIPTION = 'Run git with explicit argv in the workspace. For add, pass explicit file paths; broad add is rejected.'
+    DESCRIPTION = 'Run git with explicit argv (default: cwd from Environment; use cwd= for other directories). For add, pass explicit file paths; broad add is rejected.'
     SIGNATURE = "Git(argv=[command,...], cwd?)"
     EXAMPLE = (
         'Status. Example: {"argv":["status","--short"]}',

{nanocode_cli-0.5.9 → nanocode_cli-0.5.11/nanocode_cli.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nanocode-cli
-Version: 0.5.9
+Version: 0.5.11
 Summary: A small terminal coding agent written in Python
 Author-email: hit9 <hit9@icloud.com>
 License-Expression: BSD-3-Clause
@@ -22,7 +22,7 @@ Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: anthropic>=0.64.0
-Requires-Dist: code-symbol-index>=0.1.13
+Requires-Dist: code-symbol-index>=0.3.0
 Requires-Dist: json-repair
 Requires-Dist: openai>=2.37.0
 Requires-Dist: prompt-toolkit>=3.0
@@ -39,6 +39,8 @@ A small terminal coding agent written in Python.
 
 [简体中文](README.zh-CN.md)
 
+[Chinese blog](https://hit9.dev/post/nanocode)
+
 nanocode is pre-1.0 software. Commands, configuration, and tool behavior may change before a stable release.
 
 ![nanocode screenshot](snapshots/nanocode-snapshot.png)
@@ -48,7 +50,7 @@ nanocode is pre-1.0 software. Commands, configuration, and tool behavior may cha
 - **Live turn control**: Add follow-up input while the agent is still working, without losing the current tool flow.
 - **File-state brain**: Reads and edits build a current, line-numbered view of the files that matter now.
 - **Stale-edit protection**: `line:hash` anchors reject edits when the target code has drifted.
-- **Project-aware navigation**: Use the symbol index to jump through outlines, references, and changed files quickly.
+- **Project-aware navigation**: Use the symbol index to jump through outlines, references, implementors, call chains, and changed files quickly.
 - **Recoverable context**: Tool output stays bounded in the prompt, while raw `tr.N` results remain recallable.
 - **Cache-aware context**: Stable sections stay early and noisy working state stays late to improve prompt-cache reuse.
 - **Focused working memory**: `Note` separates goal, plan, and known facts from noisy execution logs.
@@ -138,6 +140,16 @@ Main fields:
 
 `api = "auto"` chooses between Chat Completions and Anthropic Messages using provider/model profiles. `prompt_cache_key = "auto"` derives a stable key from provider, model, workspace, and tool schema names.
 
+
+## Tested Providers
+
+The following providers have been tested with nanocode:
+
+- **deepseek**: DeepSeek API
+- **opencode**: OpenCode API
+- **aliyun**: Alibaba Cloud (Tongyi Qianwen) API via Chat Completions
+- **llama.cpp**: Local inference via llama.cpp server
+
 ## Context Design
 
 Each model request is built manually from explicit messages. Stable context comes first, conversation stays as messages, working memory follows, and the latest file state is appended at the end.

{nanocode_cli-0.5.9 → nanocode_cli-0.5.11}/nanocode_cli.egg-info/requires.txt

@@ -1,5 +1,5 @@
 anthropic>=0.64.0
-code-symbol-index>=0.1.13
+code-symbol-index>=0.3.0
 json-repair
 openai>=2.37.0
 prompt-toolkit>=3.0

{nanocode_cli-0.5.9 → nanocode_cli-0.5.11}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "nanocode-cli"
-version = "0.5.9"
+version = "0.5.11"
 description = "A small terminal coding agent written in Python"
 readme = "README.md"
 requires-python = ">=3.11"
@@ -28,7 +28,7 @@ classifiers = [
 ]
 dependencies = [
     "anthropic>=0.64.0",
-    "code-symbol-index>=0.1.13",
+    "code-symbol-index>=0.3.0",
     "json-repair",
     "openai>=2.37.0",
     "prompt-toolkit>=3.0",