feat: add automated release system

Implement comprehensive release automation to streamline version management
and publishing workflow.

Changes:
- Add release scripts (patch/minor/major) to package.json
- Create automated release script (scripts/release.js) that handles:
  - Version bumping in package.json and src/server.ts
  - Running tests and builds
  - Creating git commits and tags
  - Pushing to GitHub
  - Creating GitHub releases (when gh CLI available)
  - Triggering npm publish via GitHub Actions
- Add RELEASING.md documentation with complete release guide
- Support semantic versioning with single-command releases

This eliminates manual steps and potential errors in the release process,
ensuring consistent releases every time.

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

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

Author: Really Him

RELEASING.md

@@ -0,0 +1,126 @@
+# Release Process
+
+This project uses automated release scripts to streamline the publishing process.
+
+## 🚀 Quick Release Commands
+
+```bash
+# For bug fixes and patches (1.2.3 -> 1.2.4)
+npm run release:patch
+
+# For new features (1.2.3 -> 1.3.0)
+npm run release:minor
+
+# For breaking changes (1.2.3 -> 2.0.0)
+npm run release:major
+```
+
+## 📋 What Happens During Release
+
+When you run a release command, the following steps occur automatically:
+
+1. **Version Bump**: Updates version in `package.json` and `src/server.ts`
+2. **Tests**: Runs the full test suite to ensure everything works
+3. **Build**: Compiles TypeScript and prepares distribution files
+4. **Git Commit**: Commits the version changes
+5. **Git Tag**: Creates an annotated git tag (e.g., `v1.2.3`)
+6. **Push**: Pushes commits and tags to GitHub
+7. **GitHub Release**: Creates a GitHub release (if `gh` CLI is installed)
+8. **NPM Publish**: GitHub Actions automatically publishes to npm
+
+## 🔧 Prerequisites
+
+### Required Setup
+
+1. **NPM Token in GitHub Secrets**
+   - Go to npmjs.com → Account Settings → Access Tokens
+   - Create an "Automation" token
+   - Add to GitHub: Settings → Secrets → Actions → `NPM_TOKEN`
+
+2. **GitHub CLI (Optional but Recommended)**
+   ```bash
+   # macOS
+   brew install gh
+   
+   # Or download from: https://cli.github.com/
+   ```
+
+3. **Clean Working Directory**
+   - Commit or stash all changes before releasing
+   - The release script will check this automatically
+
+## 📝 Manual Release Process
+
+If you prefer to release manually:
+
+```bash
+# 1. Update version in package.json
+npm version patch  # or minor/major
+
+# 2. Update src/server.ts version to match
+
+# 3. Run tests
+npm test
+
+# 4. Commit changes
+git add -A
+git commit -m "chore: release v1.2.3"
+
+# 5. Create and push tag
+git tag -a v1.2.3 -m "Release v1.2.3"
+git push origin main
+git push origin v1.2.3
+
+# 6. Create GitHub release
+# Go to: https://github.com/hesreallyhim/diy-tools-mcp/releases/new
+# Select the tag and publish
+```
+
+## 🎯 Semantic Versioning Guide
+
+- **Patch** (`1.2.3` → `1.2.4`): Bug fixes, typos, small improvements
+- **Minor** (`1.2.3` → `1.3.0`): New features, backwards compatible
+- **Major** (`1.2.3` → `2.0.0`): Breaking changes, API changes
+
+## 🔍 Troubleshooting
+
+### NPM Publish Fails in GitHub Actions
+
+- Check that `NPM_TOKEN` secret is set correctly
+- Ensure the version doesn't already exist on npm
+- View action logs at: https://github.com/hesreallyhim/diy-tools-mcp/actions
+
+### Release Script Fails
+
+- Ensure you have a clean git working directory
+- Check that you're on the main branch
+- Verify you have push permissions to GitHub
+
+### Version Mismatch
+
+The release script automatically keeps `package.json` and `src/server.ts` in sync.
+
+## 📊 Monitoring Releases
+
+- **NPM Package**: https://www.npmjs.com/package/diy-tools-mcp
+- **GitHub Releases**: https://github.com/hesreallyhim/diy-tools-mcp/releases
+- **GitHub Actions**: https://github.com/hesreallyhim/diy-tools-mcp/actions
+
+## 🔄 Rollback Process
+
+If you need to rollback a release:
+
+1. **Unpublish from npm** (within 72 hours):
+   ```bash
+   npm unpublish diy-tools-mcp@1.2.3
+   ```
+
+2. **Delete git tag**:
+   ```bash
+   git tag -d v1.2.3
+   git push origin --delete v1.2.3
+   ```
+
+3. **Delete GitHub release**: Via GitHub UI
+
+⚠️ **Note**: Once a version is published to npm for >72 hours, it cannot be unpublished.

package.json

@@ -31,7 +31,14 @@
     "format": "prettier --write 'src/**/*.ts' 'demo.ts'",
     "format:check": "prettier --check 'src/**/*.ts' 'demo.ts'",
     "prepublishOnly": "npm run clean && npm run build && npm test",
-    "prepare": "husky"
+    "prepare": "husky",
+    "version:patch": "npm version patch --no-git-tag-version",
+    "version:minor": "npm version minor --no-git-tag-version",
+    "version:major": "npm version major --no-git-tag-version",
+    "release:patch": "npm run version:patch && npm run release:do",
+    "release:minor": "npm run version:minor && npm run release:do",
+    "release:major": "npm run version:major && npm run release:do",
+    "release:do": "node scripts/release.js"
   },
   "repository": {
     "type": "git",

scripts/release.js

@@ -0,0 +1,160 @@
+#!/usr/bin/env node
+
+import { execSync } from 'child_process';
+import { readFileSync, writeFileSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const rootDir = join(__dirname, '..');
+
+// Colors for console output
+const colors = {
+  reset: '\x1b[0m',
+  bright: '\x1b[1m',
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  blue: '\x1b[34m',
+  red: '\x1b[31m',
+};
+
+function log(message, color = 'reset') {
+  console.log(`${colors[color]}${message}${colors.reset}`);
+}
+
+function exec(command, options = {}) {
+  try {
+    return execSync(command, { encoding: 'utf-8', cwd: rootDir, ...options });
+  } catch (error) {
+    log(`Error executing: ${command}`, 'red');
+    log(error.message, 'red');
+    process.exit(1);
+  }
+}
+
+function getPackageVersion() {
+  const packageJson = JSON.parse(readFileSync(join(rootDir, 'package.json'), 'utf-8'));
+  return packageJson.version;
+}
+
+function updateServerVersion(version) {
+  const serverPath = join(rootDir, 'src', 'server.ts');
+  let serverContent = readFileSync(serverPath, 'utf-8');
+  serverContent = serverContent.replace(/version:\s*['"][\d.]+['"]/, `version: '${version}'`);
+  writeFileSync(serverPath, serverContent);
+}
+
+async function main() {
+  log('\n🚀 Starting automated release process...', 'bright');
+
+  // 1. Check git status
+  log('\n📋 Checking git status...', 'blue');
+  const gitStatus = exec('git status --porcelain');
+  const uncommittedFiles = gitStatus
+    .split('\n')
+    .filter(
+      (line) => line.trim() && !line.includes('package.json') && !line.includes('src/server.ts')
+    );
+
+  if (uncommittedFiles.length > 0) {
+    log('Error: You have uncommitted changes:', 'red');
+    console.log(uncommittedFiles.join('\n'));
+    log('\nPlease commit or stash your changes before releasing.', 'yellow');
+    process.exit(1);
+  }
+
+  // 2. Get current version
+  const version = getPackageVersion();
+  log(`\n📦 Preparing to release version: ${version}`, 'green');
+
+  // 3. Update server.ts version
+  log('\n🔧 Updating server.ts version...', 'blue');
+  updateServerVersion(version);
+
+  // 4. Run tests
+  log('\n🧪 Running tests...', 'blue');
+  exec('npm test', { stdio: 'inherit' });
+
+  // 5. Build the project
+  log('\n🔨 Building project...', 'blue');
+  exec('npm run build');
+
+  // 6. Commit version changes
+  log('\n💾 Committing version changes...', 'blue');
+  exec('git add package.json package-lock.json src/server.ts');
+
+  const commitMessage = `chore: release v${version}
+
+🤖 Generated with [Claude Code](https://claude.ai/code)
+
+Co-Authored-By: Claude <noreply@anthropic.com>`;
+
+  exec(`git commit -m "${commitMessage}"`);
+
+  // 7. Create git tag
+  log('\n🏷️  Creating git tag...', 'blue');
+  const tagMessage = `Release v${version}
+
+Published to npm registry`;
+  exec(`git tag -a v${version} -m "${tagMessage}"`);
+
+  // 8. Push to GitHub
+  log('\n📤 Pushing to GitHub...', 'blue');
+  exec('git push origin main');
+  exec(`git push origin v${version}`);
+
+  // 9. Create GitHub release
+  log('\n📝 Creating GitHub release...', 'blue');
+  try {
+    // Check if gh CLI is installed
+    exec('gh --version', { stdio: 'pipe' });
+
+    const releaseNotes = `## Release v${version}
+
+### 📦 Installation
+\`\`\`bash
+npm install -g diy-tools-mcp@${version}
+\`\`\`
+
+### 🚀 What's Changed
+- See commit history for details
+
+### 📝 Full Changelog
+https://github.com/hesreallyhim/diy-tools-mcp/compare/v${getPreviousVersion()}...v${version}`;
+
+    exec(`gh release create v${version} --title "v${version}" --notes "${releaseNotes}"`);
+    log('✅ GitHub release created!', 'green');
+  } catch (error) {
+    log('⚠️  GitHub CLI not found. Please create release manually at:', 'yellow');
+    log(`https://github.com/hesreallyhim/diy-tools-mcp/releases/new?tag=v${version}`, 'blue');
+  }
+
+  // Success message
+  log('\n✨ Release process complete!', 'green');
+  log(`\n📊 Version ${version} has been:`, 'bright');
+  log('  ✅ Committed to git', 'green');
+  log('  ✅ Tagged in git', 'green');
+  log('  ✅ Pushed to GitHub', 'green');
+  log('  ✅ Will be published to npm via GitHub Actions', 'green');
+
+  log('\n📈 Monitor the publish action at:', 'blue');
+  log('https://github.com/hesreallyhim/diy-tools-mcp/actions', 'blue');
+}
+
+function getPreviousVersion() {
+  try {
+    const tags = exec('git tag -l --sort=-version:refname')
+      .split('\n')
+      .filter((t) => t.startsWith('v'));
+    return tags[1] || 'v1.0.0';
+  } catch {
+    return 'v1.0.0';
+  }
+}
+
+// Run the release
+main().catch((error) => {
+  log('\n❌ Release failed:', 'red');
+  console.error(error);
+  process.exit(1);
+});