Update encoding documentation

Author: peteretelej

docs/API.md

@@ -22,19 +22,17 @@ Analyze file structure with semantic outline and search hints.
 **Signature:**
 ```python
 def get_overview(
-    absolute_file_path: str,
-    encoding: str = "utf-8"
+    absolute_file_path: str
 ) -> FileOverview
 ```
 
 **Parameters:**
 - `absolute_file_path`: Absolute path to the file (required)
-- `encoding`: File encoding (default: "utf-8")
 
 **Returns:** `FileOverview` object with:
 - `line_count`: Total lines in file
 - `file_size`: File size in bytes
-- `encoding`: Detected or specified encoding
+- `encoding`: Auto-detected file encoding
 - `has_long_lines`: True if any line exceeds 1000 characters
 - `outline`: Hierarchical structure via Tree-sitter (if supported)
 - `search_hints`: Suggested search patterns for exploration
@@ -58,8 +56,7 @@ def search_content(
     pattern: str,
     max_results: int = 20,
     context_lines: int = 2,
-    fuzzy: bool = True,
-    encoding: str = "utf-8"
+    fuzzy: bool = True
 ) -> List[SearchResult]
 ```
 
@@ -69,7 +66,6 @@ def search_content(
 - `max_results`: Maximum number of results to return (default: 20)
 - `context_lines`: Number of context lines before/after match (default: 2)
 - `fuzzy`: Enable fuzzy matching with similarity scoring (default: True)
-- `encoding`: File encoding (default: "utf-8")
 
 **Returns:** List of `SearchResult` objects with:
 - `line_number`: Line where match was found
@@ -100,16 +96,14 @@ Read targeted content by line number or pattern with semantic chunking.
 def read_content(
     absolute_file_path: str,
     target: Union[int, str],
-    mode: str = "lines",
-    encoding: str = "utf-8"
+    mode: str = "lines"
 ) -> str
 ```
 
 **Parameters:**
 - `absolute_file_path`: Absolute path to the file (required)
 - `target`: Line number (int) or search pattern (str) to locate content (required)
 - `mode`: Reading mode - "lines", "semantic", or "function" (default: "lines")
-- `encoding`: File encoding (default: "utf-8")
 
 **Reading Modes:**
 - `"lines"`: Read specific line number or lines around pattern match
@@ -141,8 +135,7 @@ def edit_content(
     search_text: str,
     replace_text: str,
     fuzzy: bool = True,
-    preview: bool = True,
-    encoding: str = "utf-8"
+    preview: bool = True
 ) -> EditResult
 ```
 
@@ -152,7 +145,6 @@ def edit_content(
 - `replace_text`: Replacement text (required)
 - `fuzzy`: Enable fuzzy matching for search_text (default: True)
 - `preview`: Show preview without making changes (default: True)
-- `encoding`: File encoding (default: "utf-8")
 
 **Returns:** `EditResult` object with:
 - `success`: True if operation succeeded

docs/design.md

@@ -186,7 +186,7 @@ def edit_content(
 class FileOverview:
     line_count: int
     file_size: int
-    encoding: str
+    encoding: str  # Auto-detected file encoding
     has_long_lines: bool  # >1000 chars (triggers truncation)
     outline: List[OutlineItem]  # Hierarchical via Tree-sitter
     search_hints: List[str]  # Common patterns for exploration
@@ -281,7 +281,7 @@ src/
 
 ## Scope
 
-**In**: UTF-8 text files, **search/replace editing**, fuzzy pattern matching, semantic structure, hierarchical navigation  
+**In**: Text files (auto-detected encoding), **search/replace editing**, fuzzy pattern matching, semantic structure, hierarchical navigation  
 **Out**: Binary files, multi-file ops, collaboration, version control, **line-based editing**
 
 ## LLM Usage Patterns

docs/plans/README.md

@@ -0,0 +1,5 @@
+# plans
+
+The docs/plans directory contains design docs and implementation plans.
+
+All documents in this directory are temporary and are deleted when features land in the main codebase. If referencing these docs, please use their Github Permalinks.

docs/plans/encoding.md

@@ -73,9 +73,16 @@
 
 #### Phase 5: Documentation and testing
 
-- [ ] Update API.md, design.md, examples
-- [ ] Add encoding detection tests
-- [ ] Test various encodings and edge cases
+- [x] Update API.md, design.md, examples
+- [x] Add encoding detection tests
+- [x] Test various encodings and edge cases
+
+**Implementation Notes:**
+- API.md updated to remove all encoding parameters from tool signatures
+- design.md updated to reflect auto-detected encoding support
+- examples.md already clean (no encoding parameters used)
+- **Existing tests comprehensive**: UTF-8, Latin-1, UTF-16, empty files, non-existent files
+- **ASCII detection fix**: ASCII files now default to UTF-8 for better compatibility
 
 #### Phase 6: Quality assurance