feat: file edit added

webui/backend/app/api/routes_files.py

@@ -2,7 +2,7 @@ from __future__ import annotations
 
 from fastapi import APIRouter, Depends
 
-from backend.app.api.schemas import DeleteRequest, DeleteResponse, MkdirRequest, MkdirResponse, RenameRequest, RenameResponse, ViewResponse
+from backend.app.api.schemas import DeleteRequest, DeleteResponse, MkdirRequest, MkdirResponse, RenameRequest, RenameResponse, SaveRequest, SaveResponse, ViewResponse
 from backend.app.dependencies import get_file_ops_service
 from backend.app.services.file_ops_service import FileOpsService
 
@@ -36,6 +36,19 @@ async def delete(
 @router.get("/view", response_model=ViewResponse)
 async def view(
     path: str,
+    for_edit: bool = False,
     service: FileOpsService = Depends(get_file_ops_service),
 ) -> ViewResponse:
-    return service.view(path=path)
+    return service.view(path=path, for_edit=for_edit)
+
+
+@router.post("/save", response_model=SaveResponse)
+async def save(
+    request: SaveRequest,
+    service: FileOpsService = Depends(get_file_ops_service),
+) -> SaveResponse:
+    return service.save(
+        path=request.path,
+        content=request.content,
+        expected_modified=request.expected_modified,
+    )

webui/backend/app/api/schemas.py

@@ -65,9 +65,22 @@ class ViewResponse(BaseModel):
     encoding: str
     truncated: bool
     size: int
+    modified: str
     content: str
 
 
+class SaveRequest(BaseModel):
+    path: str
+    content: str
+    expected_modified: str
+
+
+class SaveResponse(BaseModel):
+    path: str
+    size: int
+    modified: str
+
+
 class TaskListItem(BaseModel):
     id: str
     operation: str

webui/backend/app/fs/filesystem_adapter.py

@@ -65,11 +65,25 @@ class FilesystemAdapter:
         limit = max_bytes + 1
         with path.open("rb") as in_f:
             raw = in_f.read(limit)
+        modified = self.modified_iso(path)
         truncated = size > max_bytes or len(raw) > max_bytes
         if truncated:
             raw = raw[:max_bytes]
         return {
             "size": size,
+            "modified": modified,
             "truncated": truncated,
             "content": raw.decode(encoding, errors="replace"),
         }
+
+    def write_text_file(self, path: Path, content: str, encoding: str = "utf-8") -> dict:
+        path.write_text(content, encoding=encoding)
+        return {
+            "size": int(path.stat().st_size),
+            "modified": self.modified_iso(path),
+        }
+
+    @staticmethod
+    def modified_iso(path: Path) -> str:
+        stat = path.stat()
+        return datetime.fromtimestamp(stat.st_mtime, tz=timezone.utc).isoformat().replace("+00:00", "Z")

webui/backend/app/services/file_ops_service.py

@@ -3,11 +3,12 @@ from __future__ import annotations
 from pathlib import Path
 
 from backend.app.api.errors import AppError
-from backend.app.api.schemas import DeleteResponse, MkdirResponse, RenameResponse, ViewResponse
+from backend.app.api.schemas import DeleteResponse, MkdirResponse, RenameResponse, SaveResponse, ViewResponse
 from backend.app.fs.filesystem_adapter import FilesystemAdapter
 from backend.app.security.path_guard import PathGuard
 
 TEXT_PREVIEW_MAX_BYTES = 256 * 1024
+TEXT_EDIT_MAX_BYTES = 256 * 1024
 TEXT_CONTENT_TYPES = {
     ".txt": "text/plain",
     ".log": "text/plain",
@@ -146,7 +147,7 @@ class FileOpsService:
 
         return DeleteResponse(path=resolved_target.relative)
 
-    def view(self, path: str) -> ViewResponse:
+    def view(self, path: str, for_edit: bool = False) -> ViewResponse:
         resolved_target = self._path_guard.resolve_existing_path(path)
 
         if resolved_target.absolute.is_dir():
@@ -173,6 +174,14 @@ class FileOpsService:
                 details={"path": resolved_target.relative},
             )
 
+        if for_edit and resolved_target.absolute.stat().st_size > TEXT_EDIT_MAX_BYTES:
+            raise AppError(
+                code="file_too_large",
+                message="File is too large for edit",
+                status_code=409,
+                details={"path": resolved_target.relative},
+            )
+
         try:
             preview = self._filesystem.read_text_preview(
                 resolved_target.absolute,
@@ -194,9 +203,71 @@ class FileOpsService:
             encoding="utf-8",
             truncated=preview["truncated"],
             size=preview["size"],
+            modified=preview["modified"],
             content=preview["content"],
         )
 
+    def save(self, path: str, content: str, expected_modified: str) -> SaveResponse:
+        resolved_target = self._path_guard.resolve_existing_path(path)
+
+        if resolved_target.absolute.is_dir():
+            raise AppError(
+                code="type_conflict",
+                message="Source must be a file",
+                status_code=409,
+                details={"path": resolved_target.relative},
+            )
+        if not resolved_target.absolute.is_file():
+            raise AppError(
+                code="type_conflict",
+                message="Unsupported path type for save",
+                status_code=409,
+                details={"path": resolved_target.relative},
+            )
+        if self._content_type_for(resolved_target.absolute) is None:
+            raise AppError(
+                code="unsupported_type",
+                message="File type is not supported for edit",
+                status_code=409,
+                details={"path": resolved_target.relative},
+            )
+        if len(content.encode("utf-8")) > TEXT_EDIT_MAX_BYTES:
+            raise AppError(
+                code="file_too_large",
+                message="File is too large for edit",
+                status_code=409,
+                details={"path": resolved_target.relative},
+            )
+
+        current_modified = self._filesystem.modified_iso(resolved_target.absolute)
+        if current_modified != expected_modified:
+            raise AppError(
+                code="conflict",
+                message="File changed since it was opened",
+                status_code=409,
+                details={"path": resolved_target.relative},
+            )
+
+        try:
+            saved = self._filesystem.write_text_file(
+                resolved_target.absolute,
+                content=content,
+                encoding="utf-8",
+            )
+        except OSError as exc:
+            raise AppError(
+                code="io_error",
+                message="Filesystem operation failed",
+                status_code=500,
+                details={"reason": str(exc)},
+            )
+
+        return SaveResponse(
+            path=resolved_target.relative,
+            size=saved["size"],
+            modified=saved["modified"],
+        )
+
     @staticmethod
     def _join_relative(base: str, name: str) -> str:
         return f"{base}/{name}" if base else name