docs: consolidate design documentation and standardize crate English

2026-10-12 14:58:00 +09:00
parent a633a53274
commit 4efb0ace1f
404 changed files with 4556 additions and 11654 deletions
@@ -0,0 +1,11 @@
+# fs-operation
+
+Provides provider-side filesystem operations, bounded search, and pure text editing. Access checks and I/O for logical paths go through the provider's `FsAccessPolicy`. Does not own Workdir identity, Runtime transport, or Tool read history.
+
+## Reference index
+
+- [`FsAccessPolicy`] — provider access, I/O, and resource limits.
+- [`CheckedTarget`] — checked saves retaining descriptors and identity.
+- [`run_list`] — bounded live pagination.
+- [`run_glob`] / [`run_grep`] — provider-side search.
+- [`text`] — shared argument, UTF-8 byte limit, and edit result handling.