feat: add repo fix command for interactive metadata updates

- new repo fix command prompts for missing description/topics/license
- uses template topics/descriptions and README first line when available
- supports GitHub and GitLab metadata updates; skips unsupported providers
- adds update_description and readme_first_line hooks to provider trait
- README: add repo fix and stats --scope-missing to command table
- help: include repo fix row in devopster --help table

Author: Timna Brown

README.md

@@ -80,11 +80,13 @@ After `make setup` the `devopster` binary is on your `$PATH` and these commands
 | `devopster repo list` | List all repositories in the configured organization |
 | `devopster repo list --topic rust` | Filter repositories by topic |
 | `devopster repo audit` | Audit repos for missing description, topics, license, and default branch |
+| `devopster repo fix` | Prompt for missing description, topics, and license in scoped repos |
 | `devopster repo scaffold --name <name> --template <template>` | Create a new repository from a template defined in config |
 | `devopster repo sync` | Push files from `.github/` to all repositories |
 | `devopster catalog generate` | Export a JSON catalog of all repositories |
 | `devopster topics align` | Add missing template topics to every matching repository |
 | `devopster stats` | Print org summary: config, coverage (description/topics/license/branch), compliance, and top topics |
+| `devopster stats --scope-missing` | Update scoped repos to the non-compliant list |
 
 ### Quick start inside the container
 

src/cli/mod.rs

@@ -35,7 +35,8 @@ Commands:
 {tab}| devopster repo list                           | List repositories in the configured organization  |
 {tab}| devopster repo list --topic <topic>           | Filter repositories by topic                      |
 {tab}| devopster repo audit                          | Audit repos against the configured policy         |
-{tab}| devopster repo scaffold --name <n> --template <t> | Create a new repository from a template      |
+{tab}| devopster repo fix                            | Prompt to fix missing metadata                    |
+{tab}| devopster repo scaffold                       | Create a new repository from a template           |
 {tab}| devopster repo sync                           | Push files from .github/ to all repositories      |
 {tab}+-----------------------------------------------+---------------------------------------------------+
 {tab}| devopster catalog generate                    | Export a catalog.json of all repositories         |

src/cli/repo.rs

@@ -200,6 +200,37 @@ impl Provider for GitHubProvider {
         })
     }
 
+    async fn update_description(
+        &self,
+        organization: &str,
+        repository: &str,
+        description: &str,
+    ) -> Result<()> {
+        let endpoint = self
+            .api_url
+            .join(&format!("/repos/{organization}/{repository}"))
+            .with_context(|| {
+                format!("failed to build GitHub URL for '{organization}/{repository}'")
+            })?;
+
+        self.client
+            .patch(endpoint)
+            .json(&UpdateGitHubRepositoryRequest {
+                description: description.to_string(),
+            })
+            .send()
+            .await
+            .with_context(|| {
+                format!("failed to update description for '{organization}/{repository}'")
+            })?
+            .error_for_status()
+            .with_context(|| {
+                format!("GitHub update repo API returned an error for '{repository}'")
+            })?;
+
+        Ok(())
+    }
+
     async fn align_topics(
         &self,
         organization: &str,
@@ -229,6 +260,46 @@ impl Provider for GitHubProvider {
         Ok(())
     }
 
+    async fn readme_first_line(
+        &self,
+        organization: &str,
+        repository: &str,
+    ) -> Result<Option<String>> {
+        let endpoint = self
+            .api_url
+            .join(&format!("/repos/{organization}/{repository}/readme"))
+            .with_context(|| {
+                format!("failed to build GitHub README URL for '{organization}/{repository}'")
+            })?;
+
+        let response = self.client.get(endpoint).send().await.with_context(|| {
+            format!("failed to fetch README for '{organization}/{repository}'")
+        })?;
+
+        if response.status() == StatusCode::NOT_FOUND {
+            return Ok(None);
+        }
+
+        let response = response.error_for_status().with_context(|| {
+            format!("GitHub README API returned an error for '{repository}'")
+        })?;
+
+        let readme: GitHubReadmeContent = response.json().await.with_context(|| {
+            format!("failed to decode README response for '{repository}'")
+        })?;
+
+        if readme.content.trim().is_empty() {
+            return Ok(None);
+        }
+
+        let cleaned = readme.content.replace('\n', "");
+        let bytes = base64::engine::general_purpose::STANDARD
+            .decode(cleaned)
+            .with_context(|| format!("failed to decode README content for '{repository}'"))?;
+        let text = String::from_utf8_lossy(&bytes);
+        Ok(first_readme_line(&text))
+    }
+
     async fn push_file(
         &self,
         organization: &str,
@@ -451,3 +522,37 @@ struct PushGitHubFileRequest {
     #[serde(skip_serializing_if = "Option::is_none")]
     sha: Option<String>,
 }
+
+#[derive(Debug, Serialize)]
+struct UpdateGitHubRepositoryRequest {
+    description: String,
+}
+
+#[derive(Debug, Deserialize)]
+struct GitHubReadmeContent {
+    #[serde(default)]
+    content: String,
+}
+
+fn first_readme_line(markdown: &str) -> Option<String> {
+    for line in markdown.lines() {
+        let mut s = line.trim();
+        if s.is_empty() {
+            continue;
+        }
+        loop {
+            let trimmed = s.trim_start_matches(|c: char| {
+                c == '#' || c == '>' || c == '-' || c == '*' || c == ' '
+            });
+            if trimmed == s {
+                break;
+            }
+            s = trimmed;
+        }
+        let cleaned = s.trim().trim_matches('`');
+        if !cleaned.is_empty() {
+            return Some(cleaned.to_string());
+        }
+    }
+    None
+}

src/provider/github.rs

@@ -167,6 +167,33 @@ impl Provider for GitLabProvider {
         })
     }
 
+    async fn update_description(
+        &self,
+        organization: &str,
+        repository: &str,
+        description: &str,
+    ) -> Result<()> {
+        let project_path = url_encode_project_path(organization, repository);
+        let endpoint = self.url(&format!("/projects/{project_path}"));
+
+        self.client
+            .put(&endpoint)
+            .json(&UpdateGitLabProjectRequest {
+                description: description.to_string(),
+            })
+            .send()
+            .await
+            .with_context(|| {
+                format!("failed to update description for '{organization}/{repository}'")
+            })?
+            .error_for_status()
+            .with_context(|| {
+                format!("GitLab update project API returned an error for '{repository}'")
+            })?;
+
+        Ok(())
+    }
+
     async fn align_topics(
         &self,
         organization: &str,
@@ -429,6 +456,11 @@ struct UpdateGitLabTopics {
     topics: Vec<String>,
 }
 
+#[derive(Debug, Serialize)]
+struct UpdateGitLabProjectRequest {
+    description: String,
+}
+
 #[derive(Debug, Serialize)]
 struct GitLabFileRequest {
     branch: String,

src/provider/gitlab.rs

@@ -91,6 +91,27 @@ pub trait Provider: Send + Sync {
         Ok(())
     }
 
+    /// Update a repository description.
+    /// Providers that do not support metadata updates will return an error.
+    async fn update_description(
+        &self,
+        _organization: &str,
+        _repository: &str,
+        _description: &str,
+    ) -> Result<()> {
+        anyhow::bail!("update_description is not supported by this provider")
+    }
+
+    /// Best-effort fetch of the first non-empty README line for suggestions.
+    /// Providers that do not support README access may return Ok(None).
+    async fn readme_first_line(
+        &self,
+        _organization: &str,
+        _repository: &str,
+    ) -> Result<Option<String>> {
+        Ok(None)
+    }
+
     /// Create or update a single file in a repository.
     /// Providers that do not support file push will return an error.
     async fn push_file(