feat: redesign metaspec contribute for simplicity (v0.6.4)

Complete redesign of contribute command for better UX:

Breaking Changes:
- Removed --command option (auto-detected from pyproject.toml)
- Removed --interactive flag (no longer interactive)
- No longer generates JSON by default (use --save-json if needed)

New Features:
- --open flag: One-click browser opening
- --save-json flag: Optional metadata preview
- Auto-extract repository URL from pyproject.toml or git remote
- Auto-extract metadata (name, version, description, commands)
- Generate pre-filled GitHub issue URL
- Display what bot will extract (transparency)

Key Improvements:
- Simpler: No interactive prompts, no manual data entry
- Faster: 15-30 minutes → 30 seconds
- Clearer: Shows exactly what bot will extract
- One-click: --open opens browser automatically
- Honest: JSON is optional preview, not required

Why:
awesome-spec-kits bot already extracts all metadata automatically,
making manual JSON generation unnecessary. The new design aligns
with actual workflow and provides much better UX.

Philosophy:
The best automation is invisible automation. Users shouldn't
manually enter data that bots can extract automatically.

Implementation:
- Complete rewrite of src/metaspec/cli/contribute.py
- Updated all tests (17 tests passing)
- Updated README.md and CHANGELOG.md
- All 156 tests passing

Author: NeilJo-GY

CHANGELOG.md

@@ -9,6 +9,70 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ---
 
+## [0.6.4] - 2025-11-15
+
+### 🎉 Changed - Major UX Improvement
+
+**`metaspec contribute` - Redesigned for Simplicity**
+
+Completely redesigned `metaspec contribute` to focus on its true value: validation + one-click submission.
+
+**Why**: awesome-spec-kits bot already extracts all metadata automatically, making manual JSON generation unnecessary. The new design aligns with the actual workflow.
+
+**New behavior**:
+```bash
+# Validate only
+metaspec contribute --check-only
+
+# Default: Show pre-filled issue URL  
+metaspec contribute
+# → Validates + displays GitHub issue URL
+
+# One-click: Open browser automatically
+metaspec contribute --open
+# → Validates + opens pre-filled issue in browser (done in ~30 seconds!)
+
+# Optional: Preview metadata
+metaspec contribute --save-json
+# → Saves JSON file for preview (not required)
+```
+
+**Key improvements**:
+- ✅ **Simpler**: No interactive prompts
+- ✅ **Faster**: 15-30 minutes → 30 seconds
+- ✅ **Clearer**: Shows what bot will extract
+- ✅ **One-click**: `--open` opens browser
+- ✅ **Honest**: JSON is optional, not required
+
+**Breaking Changes**:
+- ❌ Removed: `--command` option (auto-detected)
+- ❌ Removed: `--interactive` flag
+- ❌ Changed: No longer generates JSON by default
+- ✅ Added: `--open` flag
+- ✅ Added: `--save-json` flag
+
+**Migration**:
+```bash
+# Old (v0.6.3)
+metaspec contribute my-command
+# → Interactive prompts
+
+# New (v0.6.4+)
+metaspec contribute --open
+# → One command, done!
+```
+
+**Implementation**:
+- Auto-extract repository URL from pyproject.toml or git remote
+- Auto-extract metadata from pyproject.toml
+- Generate pre-filled GitHub issue URL
+- Display what bot will extract
+- Optional JSON preview with `--save-json`
+
+**Philosophy**: The best automation is invisible automation. Users shouldn't manually enter data that bots can extract automatically.
+
+---
+
 ## [0.6.3] - 2025-11-15
 
 ### ✨ Features

README.md

@@ -246,10 +246,21 @@ metaspec contribute --check-only
 # → Validates requirements (pyproject.toml, README, LICENSE, etc.)
 # → Shows what's missing with fix suggestions
 
-# Contribute your speckit
-metaspec contribute my-speckit
-# → Validates + Generates metadata JSON
-# → Submit PR to awesome-spec-kits
+# Contribute your speckit (one command!)
+metaspec contribute --open
+# → Validates your project
+# → Opens pre-filled GitHub issue in browser
+# → Bot automatically extracts metadata from your repo
+# → Done in ~30 seconds!
+
+# Or just get the URL
+metaspec contribute
+# → Shows registration URL to paste in browser
+
+# Preview metadata (optional)
+metaspec contribute --save-json
+# → Generates JSON file for preview
+# → Note: Bot extracts from repo, JSON is optional
 ```
 
 **Join the community**:

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "meta-spec"
-version = "0.6.3"
+version = "0.6.4"
 description = "Meta-specification framework for generating Spec-Driven X (SD-X) toolkits for AI agents"
 readme = "README.md"
 requires-python = ">=3.11"

src/metaspec/__init__.py

@@ -5,7 +5,7 @@
 from YAML definitions.
 """
 
-__version__ = "0.6.3"
+__version__ = "0.6.4"
 
 __all__ = ["__version__"]