@atlashub/smartstack-cli 1.32.0 → 1.34.0

package/.documentation/installation.html

@@ -713,10 +713,7 @@ $npmPath = "$env:APPDATA\npm"
 # 3. Recharger le PATH dans cette session
 $env:PATH += ";$npmPath"
 
-# 4. Verifier l'installation
-smartstack --version
-
-# 5. Deployer les skills, agents et hooks
+# 4. Deployer les skills, agents et hooks
 smartstack install</code></pre>
                                     </div>
                                     <div class="tutorial-note" style="margin-top: 0.5rem;">
@@ -812,15 +809,12 @@ claude mcp add context7 -- context7-mcp</code></pre>
 
                                     <div class="code-block">
                                         <button class="copy-btn">Copy</button>
-                                        <pre><code># 1. Definir vos credentials Azure DevOps
-$env:AZURE_DEVOPS_ORG_URL = "https://dev.azure.com/votre-org"
+                                        <pre><code># 1. Definir votre PAT Azure DevOps
+$env:AZURE_DEVOPS_AUTH_METHOD = "pat"
 $env:AZURE_DEVOPS_PAT = "votre-pat-token"
 
-# 2. Installer le package
-npm install -g @anthropic/azure-devops-mcp
-
-# 3. Enregistrer dans Claude
-claude mcp add azure-devops -- azure-devops-mcp</code></pre>
+# 2. Enregistrer dans Claude (remplacez votre-org par votre organisation)
+claude mcp add azure-devops -- npx -y @azure-devops/mcp votre-org</code></pre>
                                     </div>
 
                                     <div class="tutorial-note" style="margin-top: 0.5rem;">

package/README.md

@@ -16,641 +16,84 @@
 
 **By [AtlasHub](https://www.atlashub.ch)** | [support@atlashub.ch](mailto:support@atlashub.ch)
 
-## What's New in v1.5.2
-
-- **Azure DevOps Support** - Full GitFlow integration with Azure DevOps PRs and pipelines
-- **npm Auto-Publish** - Automated publishing via Azure Pipelines (@next and @latest tags)
-- **Ralph Loop Integration** - Fully automated BA orchestration with Ralph Loop framework
-- **Prompts System** - Expert prompt creation and optimization tools
-- **Quick Search** - Lightning-fast codebase exploration
-
----
-
-## Table of Contents
-
-- [Prerequisites](#prerequisites)
-- [Installation](#installation)
-- [Update](#update)
-- [Project Creation](#project-creation)
-- [CLI Commands](#cli-commands)
-- [Claude Code Commands](#claude-code-commands)
-- [VS Code Configuration](#vs-code-configuration)
-- [Troubleshooting](#troubleshooting)
-
 ---
 
 ## Prerequisites
 
-### 1. Git
-
-**Download:** https://git-scm.com/downloads
-
-Git is **required** for GitFlow workflow and version control.
-
-```powershell
-# Verify installation
-git --version
-
-# Configure your identity
-git config --global user.name "Your Name"
-git config --global user.email "your@email.com"
-```
-
-#### Option A: GitHub
-
-```powershell
-# Generate SSH key
-ssh-keygen -t ed25519 -C "your@email.com"
-
-# Start SSH agent and add key
-eval "$(ssh-agent -s)"
-ssh-add ~/.ssh/id_ed25519
-
-# Copy public key
-cat ~/.ssh/id_ed25519.pub
-
-# Test connection
-ssh -T git@github.com
-```
-
-**Add key on GitHub:** https://github.com/settings/keys
+Before installing SmartStack CLI, verify that the following tools are installed:
 
-#### Option B: Azure DevOps
+| Tool | Minimum version | Verification |
+|------|----------------|--------------|
+| **Node.js** | >= 18.0.0 | `node --version` |
+| **npm** | >= 9.0.0 | `npm --version` |
+| **Git** | >= 2.0.0 | `git --version` |
+| **.NET SDK** | >= 10.0.0 | `dotnet --version` |
+| **Claude Code** | latest | `claude --version` |
 
 ```powershell
-# Git Credential Manager (recommended - included with Git for Windows)
-git config --global credential.helper manager
-
-# Clone a repo - credentials will be prompted automatically
-git clone https://dev.azure.com/YourOrg/YourProject/_git/YourRepo
+# Verify all prerequisites at once
+node --version && npm --version && git --version && dotnet --version && claude --version
 ```
 
-> **Windows Users:** Git Credential Manager handles Azure DevOps authentication automatically. On first clone, a browser window opens for login.
-
-### 2. Node.js (v18 or higher)
-
-**Download:** https://nodejs.org/
-
-```powershell
-node --version   # Should display v18.x.x or higher
-npm --version    # Should display 9.x.x or higher
-```
-
-### 3. .NET SDK (v10.0 or higher)
-
-**Download:** https://dotnet.microsoft.com/download
-
-```powershell
-dotnet --version   # Should display 10.x.x or higher
-```
-
-### 4. Visual Studio Code + Claude Code
-
-**Download VS Code:** https://code.visualstudio.com/
-
-Install Claude Code extension:
-```powershell
-code --install-extension anthropic.claude-code
-```
-
-Or manually: Open VS Code → Extensions (`Ctrl+Shift+X`) → Search "Claude Code" → Install
-
-### 5. MCP Servers (Required)
-
-MCP servers are **required** for SmartStack advanced features.
-
-#### Step A: Download MCP packages
-
-```powershell
-# SmartStack MCP - Convention validation, scaffolding, API docs
-npm install -g @atlashub/smartstack-mcp
-
-# Context7 MCP - Library documentation, code examples
-npm install -g @upstash/context7-mcp
-```
-
-#### Step B: Register in Claude Code
-
-```powershell
-# Register SmartStack MCP
-claude mcp add smartstack -- npx @atlashub/smartstack-mcp
-
-# Register Context7 MCP
-claude mcp add context7 -- npx @upstash/context7-mcp
-
-# Verify installation
-claude mcp list
-```
-
-> **Expected result:** `claude mcp list` should show **smartstack** and **context7** in the active servers list.
+> **Node.js** : [nodejs.org](https://nodejs.org/) | **.NET SDK** : [dotnet.microsoft.com](https://dotnet.microsoft.com/download) | **Claude Code** : `npm install -g @anthropic-ai/claude-code`
 
 ---
 
 ## Installation
 
-### Step 1: Install the npm package
-
 ```powershell
+# 1. Install SmartStack CLI
 npm install -g @atlashub/smartstack-cli
-```
-
-### Step 2: Install commands into Claude Code
-
-```powershell
-smartstack install
-```
-
-Or with the short alias:
-```powershell
-ss install
-```
-
-### Step 3: Verify installation
-
-```powershell
-# Check installation status
-smartstack status --verbose
-
-# Run full diagnostic
-smartstack doctor
-
-# Verify MCP servers
-smartstack check-mcp
-```
-
-### Local Installation (project only)
-
-If you prefer a project-scoped installation:
-
-```powershell
-cd C:\path\to\your\project
-smartstack install --local
-```
-
----
-
-## Update
-
-### Update SmartStack CLI
-
-```powershell
-# Automatic update (package + commands)
-smartstack update
-```
-
-### Manual Update
-
-```powershell
-# 1. Update npm package
-npm update -g @atlashub/smartstack-cli
-
-# 2. Reinstall commands
-smartstack install --force
-```
-
-### Check for available updates
-
-```powershell
-npm outdated -g @atlashub/smartstack-cli
-```
-
----
-
-## Project Creation
-
-### Method 1: `smartstack init` command (Recommended)
-
-The `smartstack init` command creates a complete SmartStack project with an interactive wizard.
-
-#### Interactive creation
-
-```powershell
-smartstack init MyProject
-```
-
-The wizard will ask for:
-1. **Project type**: Full Stack, Backend Only, or Frontend Only
-2. **Database**: SQL Server, PostgreSQL, or SQLite
-3. **Modules**: Auth, Navigation, AI, Notifications
-
-#### Quick creation (default values)
-
-```powershell
-smartstack init MyProject -y
-```
-
-#### Available options
-
-| Option | Description |
-|--------|-------------|
-| `--full-stack` | Backend .NET + Frontend React (default) |
-| `--backend` | Backend .NET only |
-| `--frontend` | Frontend React only |
-| `--db <type>` | Database: `sqlserver`, `postgresql`, `sqlite` |
-| `--dry-run` | Simulation without creating files |
-| `--skip-mcp-check` | Skip MCP servers verification |
-| `-y, --yes` | Use default values |
-
-#### Examples
-
-```powershell
-# Full-stack project with SQL Server (default)
-smartstack init MyApp
-
-# Backend only with PostgreSQL
-smartstack init MyApi --backend --db postgresql
-
-# Frontend only
-smartstack init MyFrontend --frontend
-
-# Simulation (see what would be created)
-smartstack init MyProject --dry-run
-```
-
-#### Created structure
-
-```
-MyProject/
-├── src/
-│   ├── MyProject.Domain/           # Entities and interfaces
-│   ├── MyProject.Application/      # Services and DTOs
-│   ├── MyProject.Infrastructure/   # EF Core, repositories
-│   └── MyProject.Api/              # Controllers and configuration
-├── web/
-│   └── myproject-web/              # Frontend React + Vite
-├── tests/
-├── MyProject.sln
-├── Directory.Build.props
-├── .gitignore
-└── README.md
-```
-
-#### After creation
-
-```powershell
-cd MyProject
 
-# 1. Configure connection string in appsettings.json
+# 2. Add npm to PATH (permanent)
+$npmPath = "$env:APPDATA\npm"
+[Environment]::SetEnvironmentVariable("PATH", $env:PATH + ";$npmPath", "User")
 
-# 2. Create initial migration
-dotnet ef migrations add InitialCreate -p src/MyProject.Infrastructure -s src/MyProject.Api
+# 3. Reload PATH in this session
+$env:PATH += ";$npmPath"
 
-# 3. Apply migration
-dotnet ef database update -p src/MyProject.Infrastructure -s src/MyProject.Api
-
-# 4. Run backend
-dotnet run --project src/MyProject.Api
-
-# 5. Run frontend (another terminal)
-cd web/myproject-web
-npm run dev
-```
-
-### Method 2: Initialize existing project with GitFlow
-
-If you already have a project and want to add GitFlow:
-
-```powershell
-cd C:\Projects\MyExistingProject
-code .
-```
-
-In VS Code with Claude Code active:
-```
-/gitflow init
-```
-
----
-
-## CLI Commands
-
-All commands support the short alias `ss` (e.g., `ss install`, `ss status`).
-
-### install
-
-Install SmartStack commands, agents, and hooks.
-
-```powershell
-smartstack install [options]
-```
-
-| Option | Alias | Description |
-|--------|-------|-------------|
-| `--force` | `-f` | Overwrite existing files |
-| `--global` | `-g` | Install to ~/.claude (default) |
-| `--local` | `-l` | Install to ./.claude (project) |
-| `--commands-only` | | Install only commands |
-| `--agents-only` | | Install only agents |
-| `--hooks-only` | | Install only hooks |
-| `--no-config` | | Skip config file creation |
-| `--no-plugins` | | Skip Claude Code plugin installation |
-
-### uninstall
-
-Remove SmartStack commands, agents, and hooks.
-
-```powershell
-smartstack uninstall [options]
-```
-
-| Option | Alias | Description |
-|--------|-------|-------------|
-| `--global` | `-g` | Uninstall from ~/.claude (default) |
-| `--local` | `-l` | Uninstall from ./.claude |
-| `--commands-only` | | Remove only commands |
-| `--agents-only` | | Remove only agents |
-| `--hooks-only` | | Remove only hooks |
-| `--keep-config` | | Keep configuration file |
-| `--yes` | `-y` | Skip confirmation prompt |
-
-### status
-
-Show installation status.
-
-```powershell
-smartstack status [options]
-```
-
-| Option | Alias | Description |
-|--------|-------|-------------|
-| `--global` | `-g` | Check ~/.claude (default) |
-| `--local` | `-l` | Check ./.claude |
-| `--verbose` | `-v` | Show detailed command list |
-
-### update
-
-Update commands to the latest version.
-
-```powershell
-smartstack update [options]
-```
-
-| Option | Alias | Description |
-|--------|-------|-------------|
-| `--global` | `-g` | Update ~/.claude (default) |
-| `--local` | `-l` | Update ./.claude |
-
-### init
-
-Initialize a new SmartStack project.
-
-```powershell
-smartstack init <name> [options]
-```
-
-| Option | Alias | Description |
-|--------|-------|-------------|
-| `--full-stack` | | Backend + Frontend (default) |
-| `--backend` | | Backend .NET only |
-| `--frontend` | | Frontend React only |
-| `--db <type>` | | Database: sqlserver, postgresql, sqlite |
-| `--dry-run` | | Show what would be created |
-| `--yes` | `-y` | Skip prompts, use defaults |
-| `--skip-mcp-check` | | Skip MCP servers check |
-
-### docs
-
-Open SmartStack documentation in browser.
-
-```powershell
-smartstack docs [page] [options]
-```
-
-| Option | Alias | Description |
-|--------|-------|-------------|
-| `--list` | `-l` | List available documentation pages |
-
-**Available pages:**
-- `index` - Home page
-- `installation` - Installation guide
-- `commands` - Commands reference
-- `agents` - Agents documentation
-- `apex` - APEX methodology
-- `business-analyse` - Business Analysis workflow
-- `gitflow` - GitFlow workflow
-- `efcore` - EF Core migrations
-- `hooks` - Hooks configuration
-- `test-web` - Web testing
-
-**Examples:**
-```powershell
-smartstack docs                    # Open home page
-smartstack docs gitflow            # Open GitFlow documentation
-smartstack docs --list             # List all available pages
-```
-
-### license
-
-Manage SmartStack CLI license.
-
-```powershell
-smartstack license <command> [options]
-```
-
-| Command | Description |
-|---------|-------------|
-| `activate <key>` | Activate a license key |
-| `status` | Show current license status |
-| `deactivate` | Remove the current license |
-| `verify <key>` | Verify a license key without activating |
-
-**Examples:**
-```powershell
-smartstack license activate ABC123-DEF456    # Activate license
-smartstack license status                     # Check license status
-smartstack license deactivate                 # Remove license
-smartstack license verify ABC123-DEF456       # Verify without activating
-```
-
----
-
-## Claude Code Commands
-
-### GitFlow Workflow
-
-| Skill | Description |
-|---------|-------------|
-| `/gitflow` | Full GitFlow workflow |
-| `/gitflow init` | Initialize GitFlow structure |
-| `/gitflow status` | Show repository status |
-| `/gitflow commit` | Smart commit with validation |
-| `/gitflow start` | Start feature/release/hotfix |
-| `/gitflow finish` | Finish and tag |
-| `/gitflow pr` | Create a Pull Request |
-| `/gitflow cleanup` | Cleanup worktrees |
-
-### Development Methodologies
-
-| Skill | Description |
-|---------|-------------|
-| `/apex` | APEX methodology (Analyze-Plan-Execute-eXamine) |
-| `/debug` | Systematic debugging |
-| `/explore` | Deep codebase exploration |
-| `/refactor` | Code refactoring |
-| `/review-code` | Code review |
-
-### Business Analysis
-
-| Skill | Description |
-|---------|-------------|
-| `/business-analyse` | Full BA workflow with orchestration |
-| `/business-analyse init` | Initialize BA structure |
-| `/business-analyse discover` | Requirements elicitation |
-| `/business-analyse analyse` | Business analysis (BRD) |
-| `/business-analyse specify` | Functional specification (FRD) |
-| `/business-analyse validate` | User validation gate |
-| `/business-analyse handoff` | Implementation brief |
-
-### EF Core Migrations
-
-| Skill | Description |
-|---------|-------------|
-| `/efcore` | EF Core orchestrator |
-| `/efcore migration` | Create/recreate migration |
-| `/efcore db-status` | Show migration status |
-| `/efcore db-deploy` | Apply migrations |
-| `/efcore db-seed` | Seed database |
-| `/efcore db-reset` | Reset database |
-| `/efcore scan` | Scan migrations across branches |
-| `/efcore conflicts` | Detect conflicts |
-| `/prompts:command` | Command prompt patterns |
-| `/prompts:claude-memory` | CLAUDE.md file management |
-
-### Ralph Loop
-
-| Command | Description |
-|---------|-------------|
-| `/ralph-loop` | Start autonomous Ralph Loop session |
-| `/ralph-loop:cancel-ralph` | Cancel active Ralph Loop |
-| `/ralph-loop:help` | Ralph Loop documentation |
-
-### Quick Search
-
-| Command | Description |
-|---------|-------------|
-| `/quick-search` | Lightning-fast codebase search |
-
----
-
-## VS Code Configuration
-
-### Recommended settings
-
-Add to `.vscode/settings.json`:
-
-```json
-{
-  "claude-code.enableSmartStack": true,
-  "files.associations": {
-    "*.md": "markdown"
-  },
-  "editor.formatOnSave": true
-}
+# 4. Deploy skills, agents and hooks
+smartstack install
 ```
 
-### Useful keyboard shortcuts
-
-| Shortcut | Action |
-|----------|--------|
-| `Ctrl+Shift+P` | Command palette |
-| `Ctrl+Shift+C` | Open Claude Code |
-| `Ctrl+ù` | Integrated terminal |
+> **Alias available:** You can use `ss` instead of `smartstack` (e.g., `ss install`).
 
 ---
 
-## Troubleshooting
-
-### "smartstack" is not recognized
+## Documentation
 
-**Cause:** npm global is not in PATH.
+Once installed, open the interactive documentation in your browser:
 
-**Solution:**
 ```powershell
-# Find npm global path
-npm config get prefix
-
-# Add to PATH (replace with your path)
-$env:Path += ";C:\Users\YourName\AppData\Roaming\npm"
+ss docs
 ```
 
-### Permission error
+The documentation covers the full installation checklist (Git, MCP servers, VS Code), all CLI commands, Claude Code skills, project creation, troubleshooting, and more.
 
-**Solution:** Run PowerShell as administrator, then:
 ```powershell
-npm install -g @atlashub/smartstack-cli
-```
-
-### Commands don't appear in Claude Code
-
-```powershell
-# Reinstall with force
-smartstack install --force
-
-# Check status
-smartstack status --verbose
+ss docs installation    # Installation guide
+ss docs gitflow         # GitFlow workflow
+ss docs efcore          # EF Core migrations
+ss docs apex            # APEX methodology
+ss docs --list          # List all available pages
 ```
 
-### "MCP servers missing" error during `smartstack init`
+### Command not recognized?
 
-**Solution:** Install required MCP servers:
-```powershell
-# 1. Download packages
-npm install -g @atlashub/smartstack-mcp
-npm install -g @upstash/context7-mcp
+If `ss` or `smartstack` is not recognized after installation:
 
-# 2. Register in Claude Code
-claude mcp add smartstack -- npx @atlashub/smartstack-mcp
-claude mcp add context7 -- npx @upstash/context7-mcp
-```
-
-Or skip verification:
-```powershell
-smartstack init MyProject --skip-mcp-check
-```
-
-### Complete reinstallation
-
-```powershell
-# Uninstall
-smartstack uninstall
-npm uninstall -g @atlashub/smartstack-cli
-
-# Reinstall
-npm install -g @atlashub/smartstack-cli
-smartstack install
-```
-
----
-
-## Resources
-
-- [Official Website](https://smartstack.app)
-- [SmartStack Documentation](https://docs.smartstack.app)
-- [GitFlow Documentation](.documentation/gitflow.html)
-- [Business Analysis Documentation](.documentation/business-analyse.html)
+1. **Close and reopen your terminal** (PowerShell) to reload the PATH
+2. If the problem persists, manually add npm to the PATH:
+   ```powershell
+   $npmPath = "$env:APPDATA\npm"
+   [Environment]::SetEnvironmentVariable("PATH", $env:PATH + ";$npmPath", "User")
+   $env:PATH += ";$npmPath"
+   ```
+3. Verify that the package is installed:
+   ```powershell
+   npm list -g @atlashub/smartstack-cli
+   ```
 
 ---
 
-## About AtlasHub
-
-**[AtlasHub](https://www.atlashub.ch)** builds intelligent tools for modern development teams. SmartStack is our flagship CLI toolkit, designed to accelerate .NET and full-stack development with AI-powered automation.
-
-**Need help?** Contact us at [support@atlashub.ch](mailto:support@atlashub.ch)
-
-## Development
-
-### Publishing
-
-> **INTERDICTION DE PUBLIER MANUELLEMENT SUR NPM**
->
-> La publication sur npm est **automatique** via Azure Pipelines.
-> Ne jamais exécuter `npm publish` manuellement.
->
-> **Workflow:**
-> 1. Créer une release avec `/gitflow:10-start release`
-> 2. Finaliser avec `/gitflow:11-finish`
-> 3. Le tag déclenche automatiquement le pipeline de publication
-
-## License
-
-MIT - Free for personal and commercial use.
+**[AtlasHub](https://www.atlashub.ch)** | [support@atlashub.ch](mailto:support@atlashub.ch) | MIT License