feat(clean): add subcommand clean for easy cleanup

Author: sayanarijit

SPECIFICATION.md

@@ -1,6 +1,6 @@
 # SettingSpec Specification
 
-**Version:** 0.5.1  
+**Version:** 0.6  
 **Status:** Released  
 **Authors:** Arijit Basu and SettingSpec Contributors  
 **Repository:** <https://github.com/sayanarijit/settingspec>
@@ -721,15 +721,44 @@ All commands support:
 -V, --version    Show the version.
 ```
 
-### 7.2 `export`
+### 7.2 `init`
+
+Creates a starter `settingspec.toml` in the current directory.
+
+```bash
+settingspec init [OPTIONS]
+```
+
+### 7.3 `check`
+
+Checks the configuration without creating files.
+
+```bash
+settingspec check [OPTIONS]
+```
+
+It checks:
+
+- TOML syntax.
+- Reserved keywords in setting names and profiles.
+- Profile completeness.
+- Required environment variables for active profile.
+- Decryption identities for encrypted environment files used by the active profile.
+
+Exit codes:
+
+- `0` — validation passed.
+- Non-zero — validation failed.
+
+### 7.4 `export`
 
 Generates the configured export files and/or writes resolved settings to standard output.
 
 ```bash
 settingspec export [OPTIONS]
 ```
 
-### 7.3 `run`
+### 7.5 `run`
 
 Runs another command with the resolved configuration available to it.
 
@@ -750,28 +779,7 @@ settingspec run [OPTIONS] -- <COMMAND> [ARGS...]
    - With `export.keep = true`, generated files remain.
 8. SettingSpec exits with the same status code as the child command.
 
-### 7.4 `check`
-
-Checks the configuration without creating files.
-
-```bash
-settingspec check [OPTIONS]
-```
-
-It checks:
-
-- TOML syntax.
-- Reserved keywords in setting names and profiles.
-- Profile completeness.
-- Required environment variables for active profile.
-- Decryption identities for encrypted environment files used by the active profile.
-
-Exit codes:
-
-- `0` — validation passed.
-- Non-zero — validation failed.
-
-### 7.5 `watch`
+### 7.6 `watch`
 
 Runs SettingSpec as a long-running service and regenerates the configured export files whenever `settingspec.toml` changes.
 
@@ -781,16 +789,16 @@ Upon exit, files are cleaned up as per declared `spec.export.keep` behavior.
 settingspec watch [OPTIONS]
 ```
 
-### 7.6 `init`
+If `settingspec.toml` already exists, `init` does nothing and does not overwrite it.
 
-Creates a starter `settingspec.toml` in the current directory.
+### 7.7 `clean`
+
+Deletes the export files defined in `spec.export.file`. Keeps the gitignore entries.
 
 ```bash
-settingspec init [OPTIONS]
+settingspec clean [OPTIONS]
 ```
 
-If `settingspec.toml` already exists, `init` does nothing and does not overwrite it.
-
 ---
 
 ## 8. Security

src/cli.rs

@@ -57,6 +57,9 @@ pub enum Commands {
     },
     /// Watches settingspec.toml and regenerates exports whenever it changes
     Watch,
+
+    /// Deletes all generated export files
+    Clean,
 }
 
 pub const INIT_CONFIG: &str = r#"[spec]
@@ -169,6 +172,7 @@ pub fn run_cli() -> Result<()> {
             execute_run(&ctx, &command)
         }
         Commands::Watch => run_watch(),
+        Commands::Clean => clean_exported_files(),
     }
 }
 
@@ -278,6 +282,17 @@ fn perform_export(ctx: &ExecutionContext) -> Result<Vec<PathBuf>> {
     Ok(generated_files)
 }
 
+fn clean_exported_files() -> Result<()> {
+    let ctx = load_and_resolve()?;
+
+    let _guard = CleanupGuard {
+        keep: false,
+        paths: ctx.doc.spec.export.file.keys().map(PathBuf::from).collect(),
+    };
+
+    Ok(())
+}
+
 fn execute_run(ctx: &ExecutionContext, command_args: &[String]) -> Result<()> {
     if command_args.is_empty() {
         return Err(SettingSpecError::InvalidToml(

tests/test_cli_commands.rs

@@ -14,7 +14,8 @@ fn test_cli_help_and_version() {
         .stdout(predicate::str::contains("export"))
         .stdout(predicate::str::contains("check"))
         .stdout(predicate::str::contains("watch"))
-        .stdout(predicate::str::contains("run"));
+        .stdout(predicate::str::contains("run"))
+        .stdout(predicate::str::contains("clean"));
 
     let mut cmd_ver = Command::cargo_bin("settingspec").unwrap();
     cmd_ver
@@ -1046,3 +1047,42 @@ key.default.val = "from_child"
     let content = std::fs::read_to_string(sub.child("settings.toml").path()).unwrap();
     assert!(content.contains("key = \"from_child\""));
 }
+
+#[test]
+fn test_cli_clean_exported_files() {
+    let temp = assert_fs::TempDir::new().unwrap();
+    let config = temp.child("settingspec.toml");
+    config
+        .write_str(
+            r#"
+[spec.export.file]
+"settings.toml" = true
+[settings]
+key.default.val = "val"
+"#,
+        )
+        .unwrap();
+
+    // First export to create the file
+    let mut export_cmd = Command::cargo_bin("settingspec").unwrap();
+    export_cmd
+        .current_dir(temp.path())
+        .arg("export")
+        .assert()
+        .success();
+
+    temp.child("settings.toml")
+        .assert(predicate::path::exists());
+
+    // Now run clean command to remove exported files
+    let mut clean_cmd = Command::cargo_bin("settingspec").unwrap();
+    clean_cmd
+        .current_dir(temp.path())
+        .arg("clean")
+        .assert()
+        .success();
+
+    // Verify exported file is removed
+    temp.child("settings.toml")
+        .assert(predicate::path::missing());
+}