update symlink

Author: c4pt0r

agfs-sdk/go/README.md

@@ -114,6 +114,13 @@ err := client.Chmod("/script.sh", 0755)
 
 // Delete a file
 err := client.Remove("/archive/oldfile.txt")
+
+// Create symbolic link
+err := client.Symlink("/data/original", "/shortcuts/link")
+
+// Read symbolic link target
+target, err := client.Readlink("/shortcuts/link")
+fmt.Printf("Link points to: %s\n", target)
 ```
 
 ### Directory Operations
@@ -167,6 +174,38 @@ resp, err := client.Digest("/iso/installer.iso", "xxh3")
 fmt.Printf("Digest: %s\n", resp.Digest)
 ```
 
+### Symbolic Links
+
+AGFS supports virtual symbolic links that work across all mounted filesystems without requiring backend support.
+
+```go
+// Create a symbolic link
+err := client.Symlink("/s3fs/bucket/data", "/shortcuts/s3data")
+if err != nil {
+    log.Fatalf("Failed to create symlink: %v", err)
+}
+
+// Read the target of a symlink
+target, err := client.Readlink("/shortcuts/s3data")
+if err != nil {
+    log.Fatalf("Failed to read symlink: %v", err)
+}
+fmt.Printf("Symlink points to: %s\n", target)
+
+// Symlinks work transparently with other operations
+data, err := client.Read("/shortcuts/s3data/file.txt", 0, -1)
+
+// Remove a symlink (does not affect the target)
+err = client.Remove("/shortcuts/s3data")
+```
+
+**Features:**
+- Virtual symlinks at the AGFS layer (no backend support required)
+- Support for relative and absolute paths
+- Cross-mount symlinks (link across different filesystems)
+- Symlink chain resolution with cycle detection
+- Transparent access through symlinks for read/write operations
+
 ## Testing
 
 To run the SDK tests:

agfs-sdk/python/README.md

@@ -142,6 +142,38 @@ result = client.digest("/path/to/file.txt", algorithm="xxh3")
 print(f"Hash: {result['digest']}")
 ```
 
+### Symbolic Links
+
+AGFS supports virtual symbolic links that work across all mounted filesystems without requiring backend support.
+
+```python
+# Create a symbolic link
+client.symlink("/s3fs/bucket/data", "/shortcuts/s3data")
+
+# Read the target of a symlink
+target = client.readlink("/shortcuts/s3data")
+print(f"Symlink points to: {target}")
+
+# Symlinks work transparently with other operations
+content = client.cat("/shortcuts/s3data/file.txt")
+
+# Remove a symlink (does not affect the target)
+client.rm("/shortcuts/s3data")
+
+# Create relative path symlinks
+client.symlink("../config/app.conf", "/local/tmp/local_config")
+
+# Cross-mount symlinks work
+client.symlink("/memfs/cache", "/local/shortcuts/cache")
+```
+
+**Features:**
+- Virtual symlinks at the AGFS layer (no backend support required)
+- Support for relative and absolute paths
+- Cross-mount symlinks (link across different filesystems)
+- Symlink chain resolution with cycle detection
+- Transparent access through symlinks for read/write operations
+
 ## API Reference
 
 ### AGFSClient
@@ -160,6 +192,8 @@ print(f"Hash: {result['digest']}")
 - `chmod(path, mode)` - Change file permissions
 - `touch(path)` - Update file timestamp
 - `digest(path, algorithm="xxh3")` - Calculate file hash
+- `symlink(target, link_path)` - Create symbolic link
+- `readlink(link_path)` - Read symbolic link target
 
 #### Directory Operations
 - `mkdir(path, mode="755")` - Create directory

agfs-shell/README.md

@@ -65,7 +65,7 @@ agfs-shell is a lightweight, educational shell that demonstrates Unix pipeline c
 - **Comments**: `#` and `//` style comments
 
 ### Built-in Commands (42+)
-- **File Operations**: cd, pwd, ls, tree, cat, mkdir, touch, rm, mv, stat, cp, upload, download
+- **File Operations**: cd, pwd, ls, tree, cat, mkdir, touch, rm, mv, stat, cp, ln, upload, download
 - **Text Processing**: echo, grep, jq, wc, head, tail, tee, sort, uniq, tr, rev, cut
 - **Path Utilities**: basename, dirname
 - **Variables**: export, env, unset, local
@@ -592,13 +592,16 @@ pwd                      # /local/mydir
 ```
 
 #### ls [-l] [path]
-List directory contents.
+List directory contents. Symlinks are displayed in cyan color with arrow notation.
 
 ```bash
 ls                       # List current directory
 ls /local                # List specific directory
 ls -l                    # Long format with details
 ls -l /local/*.txt       # List with glob pattern
+
+# Symlink display example:
+# aws2 -> /s3fs/aws      # Symlinks shown with arrow and target
 ```
 
 #### tree [OPTIONS] [path]
@@ -694,6 +697,35 @@ download /local/tmp/data.json ~/Downloads/
 download -r /local/tmp/logs ~/backup/logs/
 ```
 
+#### ln [-s] target link_path
+Create symbolic links. The `-s` flag is required (hard links are not supported).
+
+```bash
+# Create a symbolic link
+ln -s /s3fs/aws /s3fs/backup
+
+# Create a symlink to a directory
+ln -s /local/data /shortcuts/mydata
+
+# Relative path symlinks
+cd /local/tmp
+ln -s ../config/app.conf local_config
+
+# Cross-mount symlinks work
+ln -s /memfs/cache /local/shortcuts/cache
+
+# Symlinks appear in ls with cyan color and arrow notation
+ls -l /shortcuts
+# mydata -> /local/data
+```
+
+**Features:**
+- Virtual symlinks at the AGFS layer (no backend support required)
+- Support for relative and absolute paths
+- Cross-mount symlinks (link across different filesystems)
+- Symlink chain resolution with cycle detection
+- Symlinks work with `cd`, `ls`, `cat`, and other file operations
+
 ### Text Processing
 
 #### echo [args...]