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, 7 deletions

diff --git a/crates/shirabe/src/repository/vcs_repository.rs b/crates/shirabe/src/repository/vcs_repository.rs
index 7ce00ce5..059d4dbd 100644
--- a/crates/shirabe/src/repository/vcs_repository.rs
+++ b/crates/shirabe/src/repository/vcs_repository.rs
@@ -265,12 +265,10 @@ impl VcsRepository {
         self.branch_error_occurred.get()
     }
 
-    /// @return list<string>
     pub fn get_empty_references(&self) -> Vec<String> {
         self.empty_references.borrow().clone()
     }
 
-    /// @return array<'tags'|'branches', array<string, TransportException>>
     pub fn get_version_transport_exceptions(
         &self,
     ) -> IndexMap<String, IndexMap<String, TransportException>> {
@@ -835,9 +833,6 @@ impl VcsRepository {
         Ok(())
     }
 
-    /// @param array{name?: string, dist?: array{type: string, url: string, reference: string, shasum: string}, source?: array{type: string, url: string, reference: string}} $data
-    ///
-    /// @return array{name: string|null, dist: array{type: string, url: string, reference: string, shasum: string}|null, source: array{type: string, url: string, reference: string}}
     fn pre_process(
         &self,
         driver: &dyn VcsDriverInterface,
@@ -916,7 +911,6 @@ impl VcsRepository {
         Ok(data)
     }
 
-    /// @return string|false
     fn validate_branch(&self, branch: &str) -> Option<String> {
         let result = self
             .version_parser
@@ -941,7 +935,6 @@ impl VcsRepository {
         None
     }
 
-    /// @return string|false
     fn validate_tag(&self, version: &str) -> Option<String> {
         self.version_parser
             .borrow()