[feature] Implement file.pwd() (#1419)

* feat(eldritch-libfile): Add pwd method

Added `pwd` method to `FileLibrary` trait and implementations.
- `lib.rs`: Added `pwd` to trait definition.
- `std.rs`: Implemented `pwd` using `std::env::current_dir`.
- `fake.rs`: Implemented mock `pwd`.
- Added unit test for `pwd`.

* feat(eldritch-libfile): Add pwd method and update documentation

Added `pwd` method to `FileLibrary` trait and implementations.
- `lib.rs`: Added `pwd` to trait definition.
- `std.rs`: Implemented `pwd` using `std::env::current_dir`.
- `fake.rs`: Implemented mock `pwd`.
- Added unit test for `pwd`.
- Updated `eldritch.md` with documentation for `file.pwd`, labeled as `(V2-Only)`.

* feat(eldritch-libfile): Add pwd method, update documentation and tests

Added `pwd` method to `FileLibrary` trait and implementations.
- `lib.rs`: Added `pwd` to trait definition.
- `std.rs`: Implemented `pwd` using `std::env::current_dir`.
- `fake.rs`: Implemented mock `pwd`.
- Added unit test for `pwd`.
- Updated `eldritch.md` with documentation for `file.pwd`, labeled as `(V2-Only)`.
- Updated `bindings_test.rs` to verify `file.pwd` is exposed.

* feat(eldritch-libfile): Add pwd method, update documentation and tests

Added `pwd` method to `FileLibrary` trait and implementations.
- `lib.rs`: Added `pwd` to trait definition.
- `std.rs`: Implemented `pwd` using `std::env::current_dir`.
- `fake.rs`: Implemented mock `pwd`.
- Added unit test for `pwd`.
- Updated `eldritch.md` with documentation for `file.pwd`, labeled as `(V2-Only)`.
- Updated `bindings_test.rs` to verify `file.pwd` is exposed.

---------

Co-authored-by: google-labs-jules[bot] <161369871+google-labs-jules[bot]@users.noreply.github.com>
Co-authored-by: KCarretto <Kcarretto@gmail.com>

Author: google-labs-jules[bot]

docs/_docs/user-guide/eldritch.md

@@ -455,6 +455,12 @@ The <b>file.moveto</b> method moves a file or directory from `src` to `dst`. If
 
 The <b>file.parent_dir</b> method returns the parent directory of a give path. Eg `/etc/ssh/sshd_config` -> `/etc/ssh`
 
+### file.pwd (V2-Only)
+
+`file.pwd() -> Option<str>`
+
+The <b>file.pwd</b> method returns the current working directory of the process. If it could not be determined, `None` is returned.
+
 ### file.read
 
 `file.read(path: str) -> str`

implants/lib/eldritchv2/eldritchv2/src/bindings_test.rs

@@ -60,6 +60,7 @@ fn test_file_bindings() {
             "mkdir",
             "move",
             "parent_dir",
+            "pwd",
             "read",
             "read_binary",
             "remove",

implants/lib/eldritchv2/stdlib/eldritch-libfile/src/fake.rs

@@ -253,6 +253,10 @@ impl FileLibrary for FileLibraryFake {
         }
     }
 
+    fn pwd(&self) -> Result<Option<String>, String> {
+        Ok(Some("/home/user".to_string()))
+    }
+
     fn remove(&self, path: String) -> Result<(), String> {
         let mut root = self.root.lock();
         let parts = Self::normalize_path(&path);

implants/lib/eldritchv2/stdlib/eldritch-libfile/src/lib.rs

@@ -223,6 +223,13 @@ pub trait FileLibrary {
     /// - Returns an error string if the file cannot be read.
     fn read_binary(&self, path: String) -> Result<Vec<u8>, String>;
 
+    #[eldritch_method]
+    /// Returns the current working directory of the process.
+    ///
+    /// **Returns**
+    /// - `Option<str>`: The current working directory path, or None if it cannot be determined.
+    fn pwd(&self) -> Result<Option<String>, String>;
+
     #[eldritch_method]
     /// Deletes a file or directory recursively.
     ///

implants/lib/eldritchv2/stdlib/eldritch-libfile/src/std.rs

@@ -124,6 +124,12 @@ impl FileLibrary for StdFileLibrary {
         fs::read(&path).map_err(|e| format!("Failed to read file {path}: {e}"))
     }
 
+    fn pwd(&self) -> Result<Option<String>, String> {
+        Ok(::std::env::current_dir()
+            .ok()
+            .map(|p| p.to_string_lossy().to_string()))
+    }
+
     fn remove(&self, path: String) -> Result<(), String> {
         let p = Path::new(&path);
         if p.is_dir() {
@@ -1346,4 +1352,14 @@ cb
 
         Ok(())
     }
+
+    #[test]
+    fn test_pwd() -> AnyhowResult<()> {
+        let lib = StdFileLibrary;
+        let pwd = lib.pwd().unwrap();
+        assert!(pwd.is_some());
+        let pwd = pwd.unwrap();
+        assert!(std::path::Path::new(&pwd).is_absolute());
+        Ok(())
+    }
 }