docs: Add cache management instructions to README and refactor script lookup logic in run_script_actor.

Author: shahen94

README.md

@@ -98,6 +98,16 @@ craft start   # Equivalent to: craft run start
 craft test    # Equivalent to: craft run test
 ```
 
+### Manage Cache
+
+Clean the global package cache:
+
+```bash
+craft cache clean --force
+```
+
+> **Note**: The `--force` flag is required for confirmation. Without it, the command will show a warning message.
+
 ## 🤝 Contributing
 
 Contributions are welcome! Please feel free to submit a Pull Request.

crates/actor/src/run_script_actor.rs

@@ -24,13 +24,13 @@ impl Actor<RunScriptActorPayload> for RunScriptActor {
 
     async fn run(&self) -> contract::Result<()> {
         debug::info!("Running script: {}", self.payload.script);
-
         let mut script = self.payload.script.clone();
         let package_json = PackageJson::from_file().await?;
-        if let Some(scripts) = package_json.scripts {
-            if let Some(package_script) = scripts.get(&script) {
-                script = package_script.clone();
-            }
+
+        if let Some(scripts) = package_json.scripts
+            && let Some(package_script) = scripts.get(&script)
+        {
+            script = package_script.clone();
         }
         let cwd = std::env::current_dir()?;