use built-in publishing; update readme

Author: alexylon

.cargo-release-cheatsheet.md

@@ -7,40 +7,39 @@ cargo test                    # Tests pass?
 cargo fmt                     # Code formatted?
 ```
 
-## Dry Run (Always Do This First!)
+## Preview Release
 ```bash
-cargo release --dry-run       # Preview what will happen
+cargo release patch           # Shows what will happen
 ```
 
 ## Execute Release
 ```bash
 # Patch release (0.1.17 → 0.1.18)
-cargo release patch
+cargo release patch --execute
 
 # Minor release (0.1.17 → 0.2.0)
-cargo release minor
+cargo release minor --execute
 
 # Major release (0.1.17 → 1.0.0)
-cargo release major
-
-# Or just run (auto-detects)
-cargo release
+cargo release major --execute
 ```
 
+**Note:** Always specify patch/minor/major.
+
 ## What Happens Automatically
 1. ✅ Bumps version in `Cargo.toml`
 2. ✅ Runs tests: `cargo test`
 3. ✅ Checks formatting: `cargo fmt --check`
 4. ✅ Updates `CHANGELOG.md`
-5. ✅ Runs: `cargo publish -p sofos`
+5. ✅ Publishes to crates.io
 6. ✅ Creates commit: `Release vX.Y.Z`
 7. ✅ Creates tag: `vX.Y.Z`
 8. ✅ Pushes to remote
 
 ## Skip Publishing
 ```bash
-cargo release --no-publish    # Don't publish to crates.io
-cargo release --no-push       # Don't push to Git
+cargo release patch --execute --no-publish    # Don't publish to crates.io
+cargo release patch --execute --no-push       # Don't push to Git
 ```
 
 ## After Release
@@ -80,4 +79,4 @@ cargo release --sign-tag      # GPG sign tags
 
 ---
 
-**Quick tip:** Always run `cargo release --dry-run` first to preview!
+**Quick tip:** Always run `cargo release patch` first to preview!

CHANGELOG.md

@@ -4,9 +4,16 @@ All notable changes to Sofos are documented in this file.
 
 ## [Unreleased]
 
+### Changed
+- Simplified cargo-release configuration to use built-in publishing
+
 ## [0.1.18] - 2026-01-08
 
-## [0.1.17] - 2026-01-08
+### Added
+- cargo-release automation for versioning and publishing
+- Comprehensive release documentation
+
+## [0.1.17] - 2026-01-05
 
 ### Changed
 - Renamed `mcpServers` to `mcp-servers` in config

README.md

@@ -341,25 +341,25 @@ This project uses **cargo-release** for automated versioning and publishing.
 **Quick commands:**
 
 ```bash
-# Preview the release (dry run)
-cargo release --dry-run
+# Preview the release
+cargo release patch
 
-# Execute the release (full workflow)
-cargo release
+# Execute the release
+cargo release patch --execute
 
 # Release specific version
-cargo release [major|minor|patch]
+cargo release [patch|minor|major] --execute
 ```
 
 The release workflow automatically:
 1. Bumps version in `Cargo.toml`
 2. Runs tests and formatting checks
 3. Updates `CHANGELOG.md`
-4. Creates release commit and Git tag (`v0.1.18`)
-5. Pushes to remote repository
-6. Publishes to crates.io
+4. Publishes to crates.io
+5. Creates release commit and Git tag
+6. Pushes to remote repository
 
-**For detailed instructions** (including setup, troubleshooting, and advanced options), see [RELEASE.md](RELEASE.md).
+**For detailed instructions**, see [RELEASE.md](RELEASE.md).
 
 ## Troubleshooting
 

RELEASE.md

@@ -12,7 +12,7 @@ Cargo-release is already installed. The configuration is in `release.toml`.
 Preview what will happen without making changes:
 
 ```bash
-cargo release --dry-run
+cargo release patch
 ```
 
 This shows:
@@ -25,15 +25,15 @@ This shows:
 Execute the full release workflow:
 
 ```bash
-cargo release
+cargo release patch --execute
 ```
 
 This automatically:
 1. ✅ Bumps version in `Cargo.toml`
 2. ✅ Runs tests: `cargo test`
 3. ✅ Runs formatting check: `cargo fmt --check`
-4. ✅ Updates `CHANGELOG.md` (if configured)
-5. ✅ Runs: `cargo publish -p sofos` (custom publish command)
+4. ✅ Updates `CHANGELOG.md`
+5. ✅ Publishes to crates.io
 6. ✅ Creates release commit: `"Release v0.1.18"`
 7. ✅ Creates Git tag: `v0.1.18`
 8. ✅ Pushes commits and tags to remote
@@ -43,29 +43,29 @@ Bump to a specific version (major, minor, patch):
 
 ```bash
 # Patch release (0.1.17 → 0.1.18)
-cargo release patch
+cargo release patch --execute
 
 # Minor release (0.1.17 → 0.2.0)
-cargo release minor
+cargo release minor --execute
 
 # Major release (0.1.17 → 1.0.0)
-cargo release major
+cargo release major --execute
 ```
 
+**Note:** Always specify a version level (patch/minor/major). Running `cargo release` without a level will try to re-release the current version.
+
 ### 4. Release Without Publishing to crates.io
-To skip the custom publish command (useful for testing):
+If you want to skip publishing:
 
 ```bash
-cargo release --allow-dirty --no-verify
+cargo release patch --execute --no-publish
 ```
 
-Or if you want to run the release but skip the publish hook entirely, you can temporarily comment out the `pre-release-hook` line in `release.toml`.
-
 ### 5. Release Without Pushing to Git
 For testing/staging:
 
 ```bash
-cargo release --no-push
+cargo release patch --execute --no-push
 ```
 
 ## What Gets Updated
@@ -95,8 +95,6 @@ Ensure:
 
 ## crates.io Publishing Setup
 
-The project uses a custom publish command `cargo publish -p sofos` via a pre-release hook. 
-
 If this is your first time publishing to crates.io:
 
 ```bash
@@ -106,16 +104,14 @@ cargo login
 # This creates/updates ~/.cargo/credentials.toml
 ```
 
-The custom publish command is configured in `release.toml` as a `pre-release-hook`, which runs before creating the git commit and tag.
-
 ## Configuration
 
 The release process is configured in `release.toml`:
 
-- **pre-release-hook**: Runs custom publish command: `cargo publish -p sofos`
 - **changelog**: Automatically update CHANGELOG.md
 - **git.push**: Push commits and tags to remote
 - **git.tag-name**: Tag format (v{{version}})
+- **publish**: Publish to crates.io
 
 ## Example Release Workflow
 
@@ -130,12 +126,12 @@ $ cargo release --dry-run
 Prepared release of sofos v0.1.18
 
 # Step 3: Execute release
-$ cargo release
+$ cargo release patch --execute
 Releasing sofos v0.1.18
 - Bump version in Cargo.toml
 - Run pre-release checks
 - Update CHANGELOG.md
-- Run: cargo publish -p sofos
+- Publish to crates.io
 - Create release commit
 - Create git tag v0.1.18
 - Push to remote