chore: drop @param/@return tags that only restate Rust types

The ported docblocks copied @param and @return straight from the PHP
source. When such a tag carries nothing but a type and an argument name,
the Rust signature already states it, so the line is noise. Tags whose
text adds prose beyond the type are kept.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

1 files changed, 0 insertions, 5 deletions

diff --git a/crates/shirabe/src/cache.rs b/crates/shirabe/src/cache.rs
index 2e7ff3cb..354e559e 100644
--- a/crates/shirabe/src/cache.rs
+++ b/crates/shirabe/src/cache.rs
@@ -124,7 +124,6 @@ impl Cache {
         &self.root
     }
 
-    /// @return string|false
     pub fn read(&mut self, file: &str) -> Option<String> {
         if self.is_enabled() {
             let file = Preg::replace(format!("{{[^{}]}}i", self.allowlist), "-", file);
@@ -344,8 +343,6 @@ impl Cache {
         false
     }
 
-    /// @return int|false
-    /// @phpstan-return int<0, max>|false
     pub fn get_age(&mut self, file: &str) -> Option<i64> {
         if self.is_enabled() {
             let file = Preg::replace(format!("{{[^{}]}}i", self.allowlist), "-", file);
@@ -463,7 +460,6 @@ impl Cache {
         false
     }
 
-    /// @return string|false
     pub fn sha1(&mut self, file: &str) -> Option<String> {
         if self.is_enabled() {
             let file = Preg::replace(format!("{{[^{}]}}i", self.allowlist), "-", file);
@@ -476,7 +472,6 @@ impl Cache {
         None
     }
 
-    /// @return string|false
     pub fn sha256(&mut self, file: &str) -> Option<String> {
         if self.is_enabled() {
             let file = Preg::replace(format!("{{[^{}]}}i", self.allowlist), "-", file);