Merge remote-tracking branch 'shareai/main' into fix/pr-536-readline-prompt-wrap

# Conflicts:
#	web/src/data/generated/versions.json

s02_tool_use/README.ja.md

@@ -56,25 +56,30 @@ TOOLS = [
 
 ```python
 def run_read(path, limit=None):
-    lines = safe_path(path).read_text().splitlines()
+    lines = safe_path(path).read_text(encoding="utf-8").splitlines()
     if limit:
         lines = lines[:limit]
     return "\n".join(lines)
 
 def run_write(path, content):
-    safe_path(path).write_text(content)
+    safe_path(path).write_text(content, encoding="utf-8")
     return f"Wrote {len(content)} bytes to {path}"
 
 def run_edit(path, old_text, new_text):
-    text = safe_path(path).read_text()
+    text = safe_path(path).read_text(encoding="utf-8")
     if old_text not in text:
         return "Error: text not found"
-    safe_path(path).write_text(text.replace(old_text, new_text, 1))
+    safe_path(path).write_text(text.replace(old_text, new_text, 1), encoding="utf-8")
     return f"Edited {path}"
 
 def run_glob(pattern):
     import glob as g
-    return "\n".join(g.glob(pattern, root_dir=WORKDIR))
+    matches = sorted(set(g.glob(
+        pattern, root_dir=WORKDIR, recursive=True)))
+    shown = matches[:200]
+    if len(matches) > 200:
+        shown.append("... (more matches omitted; narrow the pattern)")
+    return "\n".join(shown)
 ```
 
 ---

s02_tool_use/README.md

@@ -56,25 +56,30 @@ Each tool has its own implementation function:
 
 ```python
 def run_read(path, limit=None):
-    lines = safe_path(path).read_text().splitlines()
+    lines = safe_path(path).read_text(encoding="utf-8").splitlines()
     if limit:
         lines = lines[:limit]
     return "\n".join(lines)
 
 def run_write(path, content):
-    safe_path(path).write_text(content)
+    safe_path(path).write_text(content, encoding="utf-8")
     return f"Wrote {len(content)} bytes to {path}"
 
 def run_edit(path, old_text, new_text):
-    text = safe_path(path).read_text()
+    text = safe_path(path).read_text(encoding="utf-8")
     if old_text not in text:
         return "Error: text not found"
-    safe_path(path).write_text(text.replace(old_text, new_text, 1))
+    safe_path(path).write_text(text.replace(old_text, new_text, 1), encoding="utf-8")
     return f"Edited {path}"
 
 def run_glob(pattern):
     import glob as g
-    return "\n".join(g.glob(pattern, root_dir=WORKDIR))
+    matches = sorted(set(g.glob(
+        pattern, root_dir=WORKDIR, recursive=True)))
+    shown = matches[:200]
+    if len(matches) > 200:
+        shown.append("... (more matches omitted; narrow the pattern)")
+    return "\n".join(shown)
 ```
 
 ---

s02_tool_use/README.zh.md

@@ -56,25 +56,30 @@ TOOLS = [
 
 ```python
 def run_read(path, limit=None):
-    lines = safe_path(path).read_text().splitlines()
+    lines = safe_path(path).read_text(encoding="utf-8").splitlines()
     if limit:
         lines = lines[:limit]
     return "\n".join(lines)
 
 def run_write(path, content):
-    safe_path(path).write_text(content)
+    safe_path(path).write_text(content, encoding="utf-8")
     return f"Wrote {len(content)} bytes to {path}"
 
 def run_edit(path, old_text, new_text):
-    text = safe_path(path).read_text()
+    text = safe_path(path).read_text(encoding="utf-8")
     if old_text not in text:
         return "Error: text not found"
-    safe_path(path).write_text(text.replace(old_text, new_text, 1))
+    safe_path(path).write_text(text.replace(old_text, new_text, 1), encoding="utf-8")
     return f"Edited {path}"
 
 def run_glob(pattern):
     import glob as g
-    return "\n".join(g.glob(pattern, root_dir=WORKDIR))
+    matches = sorted(set(g.glob(
+        pattern, root_dir=WORKDIR, recursive=True)))
+    shown = matches[:200]
+    if len(matches) > 200:
+        shown.append("... (more matches omitted; narrow the pattern)")
+    return "\n".join(shown)
 ```
 
 ---

s02_tool_use/code.py

@@ -77,7 +77,7 @@ def safe_path(p: str) -> Path:
 
 def run_read(path: str, limit: int | None = None) -> str:
     try:
-        lines = safe_path(path).read_text().splitlines()
+        lines = safe_path(path).read_text(encoding="utf-8").splitlines()
         if limit and limit < len(lines):
             lines = lines[:limit] + [f"... ({len(lines) - limit} more lines)"]
         return "\n".join(lines)
@@ -89,7 +89,7 @@ def run_write(path: str, content: str) -> str:
     try:
         file_path = safe_path(path)
         file_path.parent.mkdir(parents=True, exist_ok=True)
-        file_path.write_text(content)
+        file_path.write_text(content, encoding="utf-8")
         return f"Wrote {len(content)} bytes to {path}"
     except Exception as e:
         return f"Error: {e}"
@@ -98,10 +98,10 @@ def run_write(path: str, content: str) -> str:
 def run_edit(path: str, old_text: str, new_text: str) -> str:
     try:
         file_path = safe_path(path)
-        text = file_path.read_text()
+        text = file_path.read_text(encoding="utf-8")
         if old_text not in text:
             return f"Error: text not found in {path}"
-        file_path.write_text(text.replace(old_text, new_text, 1))
+        file_path.write_text(text.replace(old_text, new_text, 1), encoding="utf-8")
         return f"Edited {path}"
     except Exception as e:
         return f"Error: {e}"
@@ -110,11 +110,15 @@ def run_edit(path: str, old_text: str, new_text: str) -> str:
 def run_glob(pattern: str) -> str:
     import glob as g
     try:
-        results = []
-        for match in g.glob(pattern, root_dir=WORKDIR):
-            if (WORKDIR / match).resolve().is_relative_to(WORKDIR):
-                results.append(match)
-        return "\n".join(results) if results else "(no matches)"
+        matches = sorted({
+            match for match in g.glob(
+                pattern, root_dir=WORKDIR, recursive=True)
+            if (WORKDIR / match).resolve().is_relative_to(WORKDIR)
+        })
+        shown = matches[:200]
+        if len(matches) > 200:
+            shown.append("... (more matches omitted; narrow the pattern)")
+        return "\n".join(shown) if shown else "(no matches)"
     except Exception as e:
         return f"Error: {e}"
 
@@ -130,7 +134,7 @@ TOOLS = [
      "input_schema": {"type": "object", "properties": {"path": {"type": "string"}, "content": {"type": "string"}}, "required": ["path", "content"]}},
     {"name": "edit_file", "description": "Replace exact text in a file once.",
      "input_schema": {"type": "object", "properties": {"path": {"type": "string"}, "old_text": {"type": "string"}, "new_text": {"type": "string"}}, "required": ["path", "old_text", "new_text"]}},
-    {"name": "glob", "description": "Find files matching a glob pattern.",
+    {"name": "glob", "description": "Find files matching a glob pattern; ** matches recursively.",
      "input_schema": {"type": "object", "properties": {"pattern": {"type": "string"}}, "required": ["pattern"]}},
 ]