refactor: restructure CLI command hierarchy and remove slug parameter (#44)

* refactor: remove slug parameter from CLI, enforce title-first workflow

- Remove slug parameter from CLI arguments (dot <slug>)
- Remove slug from Create and RecipeCommands::New commands
- Update handle_create to only accept title, auto-generate slug
- Update non-interactive mode to require --title instead of slug
- Update README to remove outdated CLI examples
- Remove macOS Intel from README installation instructions
- Enforce consistent title-first workflow across all interfaces

This simplifies the CLI interface and ensures slugs are always
auto-generated from titles, reducing user confusion and errors.

* refactor: restructure CLI command hierarchy for scalability

Make CLI future-proof by requiring explicit subcommands:

Breaking changes:
- Remove `dot` with no args (now requires subcommand)
- Remove `dot create` command
- Remove slug parameter entirely from CLI and SDK
- Rename `dot recipe new` to `dot recipe create`

Changes:
- Make command field required (not optional) in Cli struct
- Move all recipe creation arguments to global scope
- Enforce title-first workflow (slug auto-generated)
- Reserve top-level namespace for cross-cutting commands only

Users must now use:
- `dot recipe create` instead of `dot` or `dot create`
- `--title` is required in non-interactive mode

This change prepares the CLI for future non-recipe features while
maintaining a clean, predictable command structure.

* docs: update all documentation for new CLI command structure

Update documentation to reflect the refactored command hierarchy:

Changes:
- Replace `dot` and `dot create` with `dot recipe create`
- Replace slug parameters with --title flag
- Update macOS binary names to user-friendly versions
- Update command examples in all docs
- Add comprehensive command list to architecture.md
- Update non-interactive examples to require --title

Files updated:
- README.md: Updated CLI usage examples
- CONTRIBUTING.md: Updated installation and command reference
- cli/README.md: Complete rewrite of commands and examples
- docs/architecture.md: Updated CLI commands section
- docs/testing.md: Updated test recipe creation
- core/VERSION_MANAGEMENT.md: Updated scaffolding example

All documentation now accurately reflects the new command structure
where `dot recipe create` is the canonical way to create recipes.

* test: update CLI integration tests for new command structure

Update all CLI integration tests to use the new command hierarchy:

Changes:
- Replace `dot <slug>` with `dot recipe create --title "..."`
- Replace `dot create <slug>` with `dot recipe create --title "..."`
- Update help text assertion (removed "Polkadot Cookbook")
- Update error message assertions (slug → title)
- Use valid titles that pass validation rules
- Remove slug validation tests (no longer relevant)
- Keep empty test placeholders for future title validation

All 13 tests now pass with the new command structure.

* ci: update SDK workflow for new CLI command structure

Update test-sdk.yml to use the new CLI command hierarchy:

Changes:
- Rename "Test CLI - Valid slug" to "Test CLI - Valid recipe creation"
- Update command: `dot test-ci-valid` → `dot recipe create --title "Testing CLI Validation"`
- Rename "Test CLI - Invalid slug" to "Test CLI - Missing required title"
- Update validation test to check for missing --title flag instead of invalid slug

The workflow now tests the new command structure where recipe creation
requires `dot recipe create --title "..."` instead of `dot <slug>`.

Author: brunopgalvao

.github/workflows/test-sdk.yml

@@ -301,21 +301,21 @@ jobs:
         if: needs.check-changes.outputs.sdk_changed == 'true'
         run: cargo build --package cli --verbose
 
-      - name: Test CLI - Valid slug
+      - name: Test CLI - Valid recipe creation
         if: needs.check-changes.outputs.sdk_changed == 'true'
         run: |
-          cargo run --package cli -- test-ci-valid --skip-install --no-git --non-interactive
-          if [ ! -f "recipes/test-ci-valid/README.md" ]; then
+          cargo run --package cli -- recipe create --title "Testing CLI Validation" --skip-install --no-git --non-interactive
+          if [ ! -f "recipes/testing-cli-validation/README.md" ]; then
             echo "Error: Project was not created"
             exit 1
           fi
-          rm -rf recipes/test-ci-valid
+          rm -rf recipes/testing-cli-validation
 
-      - name: Test CLI - Invalid slug
+      - name: Test CLI - Missing required title
         if: needs.check-changes.outputs.sdk_changed == 'true'
         run: |
-          if cargo run --package cli -- Invalid-Slug --non-interactive 2>&1 | grep -q "Invalid recipe slug"; then
-            echo "✓ Invalid slug error message found"
+          if cargo run --package cli -- recipe create --non-interactive 2>&1 | grep -q "Title argument"; then
+            echo "✓ Missing title error message found"
             exit 0
           else
             echo "✗ Expected error message not found"

CONTRIBUTING.md

@@ -29,12 +29,8 @@ Thank you for your interest in contributing! The easiest way to contribute a rec
 curl -L https://github.com/polkadot-developers/polkadot-cookbook/releases/latest/download/dot-linux-amd64.tar.gz | tar xz
 sudo mv dot /usr/local/bin/
 
-# macOS (Intel)
-curl -L https://github.com/polkadot-developers/polkadot-cookbook/releases/latest/download/dot-macos-amd64.tar.gz | tar xz
-sudo mv dot /usr/local/bin/
-
 # macOS (Apple Silicon)
-curl -L https://github.com/polkadot-developers/polkadot-cookbook/releases/latest/download/dot-macos-arm64.tar.gz | tar xz
+curl -L https://github.com/polkadot-developers/polkadot-cookbook/releases/latest/download/dot-macos-apple-silicon.tar.gz | tar xz
 sudo mv dot /usr/local/bin/
 ```
 
@@ -63,10 +59,7 @@ dot setup
 
 ```bash
 # Interactive mode (recommended)
-dot
-
-# Or with a slug
-dot my-recipe-name
+dot recipe create
 ```
 
 The CLI will guide you through:
@@ -149,22 +142,20 @@ dot setup          # Check and setup your environment
 dot doctor         # Run comprehensive health checks
 
 # Recipe management
-dot                # Create recipe (interactive)
-dot <slug>         # Create recipe with slug
-dot recipe new     # Create recipe (explicit command)
-dot recipe list    # List all recipes
-dot recipe test    # Test a recipe
+dot recipe create   # Create recipe (interactive)
+dot recipe list     # List all recipes
+dot recipe test     # Test a recipe
 dot recipe validate # Validate recipe structure
-dot recipe lint    # Run linting checks
-dot recipe submit  # Submit as pull request
+dot recipe lint     # Run linting checks
+dot recipe submit   # Submit as pull request
 
 # Non-interactive mode
-dot my-recipe \
-  --non-interactive \
+dot recipe create \
   --title "My Recipe Title" \
   --pathway runtime \
   --difficulty beginner \
-  --content-type tutorial
+  --content-type tutorial \
+  --non-interactive
 ```
 
 <hr />

README.md

@@ -108,12 +108,8 @@ cargo build --release
 curl -L https://github.com/polkadot-developers/polkadot-cookbook/releases/latest/download/dot-linux-amd64.tar.gz | tar xz
 sudo mv dot /usr/local/bin/
 
-# macOS (Intel)
-curl -L https://github.com/polkadot-developers/polkadot-cookbook/releases/latest/download/dot-macos-amd64.tar.gz | tar xz
-sudo mv dot /usr/local/bin/
-
 # macOS (Apple Silicon)
-curl -L https://github.com/polkadot-developers/polkadot-cookbook/releases/latest/download/dot-macos-arm64.tar.gz | tar xz
+curl -L https://github.com/polkadot-developers/polkadot-cookbook/releases/latest/download/dot-macos-apple-silicon.tar.gz | tar xz
 sudo mv dot /usr/local/bin/
 ```
 
@@ -132,10 +128,7 @@ dot setup
 dot doctor
 
 # Create a new recipe (interactive mode)
-dot
-
-# Or create with a specific slug
-dot my-pallet
+dot recipe create
 
 # Test your recipe
 dot recipe test my-pallet

cli/README.md

@@ -28,15 +28,15 @@ export PATH="$PATH:/path/to/polkadot-cookbook/target/release"
 ### Create a Recipe (Interactive)
 
 ```bash
-dot create
+dot recipe create
 ```
 
 This launches an interactive prompt that guides you through recipe creation.
 
-### Create a Recipe (Command Line)
+### Create a Recipe (Non-Interactive)
 
 ```bash
-dot create my-awesome-recipe
+dot recipe create --title "My Awesome Recipe" --non-interactive
 ```
 
 ### View Versions
@@ -54,36 +54,37 @@ dot versions my-recipe --show-source
 
 ## Commands
 
-### `create`
+### `recipe create`
 
 Create a new recipe with scaffolded structure.
 
 **Usage:**
 ```bash
-dot create [OPTIONS] [SLUG]
+dot recipe create [OPTIONS]
 ```
 
-**Arguments:**
-- `SLUG` - Recipe slug (e.g., "my-recipe"). Optional in interactive mode.
-
 **Options:**
+- `--title <TITLE>` - Recipe title (required in non-interactive mode)
+- `--pathway <PATHWAY>` - Recipe pathway: runtime, contracts, basic-interaction, xcm, testing
+- `--difficulty <DIFFICULTY>` - Difficulty level: beginner, intermediate, advanced
+- `--content-type <TYPE>` - Content type: tutorial, guide
 - `--skip-install` - Skip npm dependency installation
 - `--no-git` - Skip git branch creation
-- `--non-interactive` - Non-interactive mode (requires SLUG)
+- `--non-interactive` - Non-interactive mode (requires --title)
 
 **Examples:**
 ```bash
 # Interactive mode (recommended)
-dot create
+dot recipe create
 
-# With slug
-dot create custom-pallet-recipe
+# Non-interactive with title (slug auto-generated)
+dot recipe create --title "Custom Pallet Recipe"
 
 # Skip installation for faster creation
-dot create my-recipe --skip-install
+dot recipe create --title "My Recipe" --skip-install --non-interactive
 
-# CI/CD mode
-dot create my-recipe --non-interactive --skip-install
+# CI/CD mode with full options
+dot recipe create --title "My Recipe" --pathway runtime --difficulty beginner --non-interactive --skip-install
 ```
 
 **What it creates:**
@@ -160,7 +161,7 @@ versions:
 
 ```bash
 # 1. Create recipe structure
-dot create my-awesome-recipe
+dot recipe create --title "My Awesome Recipe"
 
 # 2. Write content
 cd recipes/my-awesome-recipe
@@ -185,7 +186,7 @@ git push origin recipe/my-awesome-recipe
 
 ```bash
 # Create recipe
-dot create test-new-version
+dot recipe create --title "Test New Version"
 
 # Edit versions
 cd recipes/test-new-version
@@ -231,17 +232,17 @@ Edit `recipes/<slug>/recipe.config.yml` to configure:
 
 ```bash
 cd /path/to/polkadot-cookbook
-dot create my-recipe
+dot recipe create --title "My Recipe"
 ```
 
-### "Slug argument is required"
+### "Title argument is required"
 
-**Problem:** Non-interactive mode without slug
+**Problem:** Non-interactive mode without title
 
-**Solution:** Provide slug argument
+**Solution:** Provide --title argument
 
 ```bash
-dot create my-recipe --non-interactive
+dot recipe create --title "My Recipe" --non-interactive
 ```
 
 ### "Failed to resolve versions"