refactor: improve init command output formatting

- Generate cleaner TOML with proper sectioning via generate_toml_with_comments()
- Simplify example template by removing redundant comments
- Update hint message to suggest 'secretspec check' instead of 'set'
- Add project configuration file

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

Author: domenkozar

secretspec.toml

@@ -0,0 +1,18 @@
+[project]
+name = "secretspec"
+revision = "1.0"
+# Extend configurations from subdirectories
+# extends = [ "subdir1", "subdir2" ]
+
+[profiles.default]
+# API_KEY = { description = "API key for external service", required = true }
+# DATABASE_URL = { description = "Database connection string", required = true }
+
+[profiles.development]
+# API_KEY = { description = "API key for external service", required = false, default = "dev-api-key" }
+# DATABASE_URL = { description = "Database connection string", required = true, default = "sqlite:///dev.db" }
+# JWT_SECRET = { description = "Secret key for JWT token signing", required = true }
+# REDIS_URL = { description = "Redis connection URL for caching", required = false, default = "redis://localhost:6379" }
+# EMAIL_PROVIDER = { description = "Email service provider", required = false, default = "console" }
+# OAUTH_CLIENT_ID = { description = "OAuth client ID", required = false }
+# OAUTH_CLIENT_SECRET = { description = "OAuth client secret", required = false }

src/lib.rs

@@ -112,16 +112,9 @@ pub fn project_config_from_path(from: &Path) -> Result<ProjectConfig> {
 }
 
 pub fn get_example_toml() -> &'static str {
-    r#"
-# Example secrets configuration
-# Uncomment and modify the sections you need
-
-# API_KEY = { description = "API key for external service", required = true }
+    r#"# API_KEY = { description = "API key for external service", required = true }
 # DATABASE_URL = { description = "Database connection string", required = true }
 
-# Extend configurations from subdirectories
-# extends = [ "subdir1", "subdir2" ]
-
 [profiles.development]
 # API_KEY = { description = "API key for external service", required = false, default = "dev-api-key" }
 # DATABASE_URL = { description = "Database connection string", required = true, default = "sqlite:///dev.db" }
@@ -133,6 +126,39 @@ pub fn get_example_toml() -> &'static str {
 "#
 }
 
+pub fn generate_toml_with_comments(config: &ProjectConfig) -> Result<String> {
+    let mut output = String::new();
+
+    // Project section
+    output.push_str("[project]\n");
+    output.push_str(&format!("name = \"{}\"\n", config.project.name));
+    output.push_str(&format!("revision = \"{}\"\n", config.project.revision));
+
+    // Add extends comment and field if needed
+    output.push_str("# Extend configurations from subdirectories\n");
+    output.push_str("# extends = [ \"subdir1\", \"subdir2\" ]\n");
+
+    // Profile sections
+    for (profile_name, profile_config) in &config.profiles {
+        output.push_str(&format!("\n[profiles.{}]\n", profile_name));
+
+        for (secret_name, secret_config) in &profile_config.secrets {
+            output.push_str(&format!(
+                "{} = {{ description = \"{}\", required = {}",
+                secret_name, secret_config.description, secret_config.required
+            ));
+
+            if let Some(default) = &secret_config.default {
+                output.push_str(&format!(", default = \"{}\"", default));
+            }
+
+            output.push_str(" }\n");
+        }
+    }
+
+    Ok(output)
+}
+
 pub struct SecretSpec {
     registry: ProviderRegistry,
     config: ProjectConfig,
@@ -241,7 +267,7 @@ impl SecretSpec {
                 "!".yellow(),
                 from.display()
             );
-            println!("  secretspec set <SECRET_NAME>");
+            println!("  secretspec check");
         }
 
         Ok(())

src/main.rs

@@ -117,7 +117,7 @@ fn main() -> Result<()> {
     match cli.command {
         Commands::Init { from } => {
             let project_config = secretspec::project_config_from_path(&from)?;
-            let mut content = toml::to_string_pretty(&project_config)?;
+            let mut content = secretspec::generate_toml_with_comments(&project_config)?;
 
             // Append comprehensive example
             content.push_str(secretspec::get_example_toml());