@atlashub/smartstack-cli 1.36.0 → 2.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atlashub/smartstack-cli",
-  "version": "1.36.0",
+  "version": "2.0.0",
   "description": "SmartStack Claude Code automation toolkit - GitFlow, APEX, EF Core migrations, prompts and more",
   "author": {
     "name": "SmartStack",
@@ -14,7 +14,8 @@
   "types": "./dist/index.d.ts",
   "bin": {
     "smartstack": "./dist/index.js",
-    "ss": "./dist/index.js"
+    "ss": "./dist/index.js",
+    "smartstack-mcp": "./dist/mcp-entry.mjs"
   },
   "files": [
     "dist",
@@ -69,7 +70,10 @@
     "ralph:start": "node dist/index.js ralph start",
     "ralph:status": "node dist/index.js ralph status",
     "ralph:logs": "node dist/index.js ralph logs",
-    "health": "node dist/index.js doctor --json"
+    "health": "node dist/index.js doctor --json",
+    "test:mcp": "vitest run --config vitest.mcp.config.ts",
+    "test:mcp:watch": "vitest --config vitest.mcp.config.ts",
+    "test:mcp:coverage": "vitest run --config vitest.mcp.config.ts --coverage"
   },
   "dependencies": {
     "bcryptjs": "^2.4.3",
@@ -82,7 +86,10 @@
     "jsonwebtoken": "^9.0.3",
     "mssql": "^11.0.1",
     "ora": "^8.0.1",
-    "zod": "^3.22.4"
+    "zod": "^3.25.0",
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "handlebars": "^4.7.8",
+    "axios": "^1.7.0"
   },
   "devDependencies": {
     "@types/bcryptjs": "^2.4.6",
@@ -96,6 +103,8 @@
     "eslint": "^8.56.0",
     "prettier": "^3.2.4",
     "tsup": "^8.0.1",
-    "typescript": "^5.3.3"
+    "typescript": "^5.3.3",
+    "vitest": "^2.1.0",
+    "@vitest/coverage-v8": "^2.1.0"
   }
 }

package/templates/agents/gitflow/start.md

@@ -15,9 +15,10 @@ Creation rapide de branche GitFlow avec worktree.
 1. **Analyser**: Contexte (branche, version, ahead/behind)
 2. **Choisir**: Type (feature/release/hotfix)
 3. **Creer**: Worktree ou checkout
-4. **Configurer**: appsettings.Local.json si .NET
-5. **Verifier ports**: Detecter conflits entre projets
-6. **Resume**: Prochaines etapes
+4. **Configurer**: appsettings.Local.json + launchSettings.json Local profile si .NET
+5. **Configurer**: .env.local + npm run local si Web
+6. **Verifier ports**: Detecter conflits entre projets
+7. **Resume**: Prochaines etapes
 
 ## Commandes
 
@@ -48,7 +49,7 @@ BRANCH CREATED
   Name: {branch}
   Base: {develop|main}
   Worktree: ../worktrees/{type}s/{name}
-  Config: {appsettings.Local.json created|skipped}
+  Config: {appsettings.Local.json + launchSettings.json Local|skipped}
   Ports: {✓ OK|⚠️ Conflicts resolved|⚠️ Conflicts ignored}
 
 NEXT STEPS:

package/templates/agents/mcp-healthcheck.md

@@ -10,6 +10,8 @@ tools: Bash, Read, Write, Glob
 
 Validates that SmartStack MCP is properly configured and up-to-date before any operation.
 
+> **Note:** The MCP server is now bundled inside `@atlashub/smartstack-cli`. No separate package required.
+
 ## Status File
 
 Location: `.claude/mcp-status.json`
@@ -17,8 +19,8 @@ Location: `.claude/mcp-status.json`
 ```json
 {
   "lastCheck": "2024-01-15T10:30:00Z",
-  "mcpVersion": "1.5.0",
-  "mcpPath": "D:\\01 - projets\\SmartStack.mcp",
+  "mcpVersion": "2.0.0",
+  "bundled": true,
   "status": "ok",
   "tools": ["validate_conventions", "scaffold_extension", "check_migrations", "..."]
 }
@@ -55,7 +57,7 @@ If fails → Run full check
 
 ```bash
 # Check Claude Code MCP config
-cat ~/.claude/settings.json | grep -A 20 "smartstack"
+claude mcp list 2>/dev/null | grep -i smartstack
 ```
 
 #### 3.2 Test MCP Tools Availability
@@ -71,15 +73,15 @@ Call each critical tool to verify availability:
 #### 3.3 Check MCP Version
 
 ```bash
-# Read MCP package.json
-cat "D:\\01 - projets\\SmartStack.mcp\\package.json" | grep version
+# Read version from CLI package (MCP is bundled)
+smartstack --version 2>/dev/null || npx @atlashub/smartstack-cli --version
 ```
 
 #### 3.4 Compare with Latest Release
 
 ```bash
 # Check npm registry for latest version
-npm view @anthropic/smartstack-mcp version 2>/dev/null || echo "Not published"
+npm view @atlashub/smartstack-cli version 2>/dev/null || echo "Registry check failed"
 ```
 
 ### 4. Update Status File
@@ -88,7 +90,7 @@ npm view @anthropic/smartstack-mcp version 2>/dev/null || echo "Not published"
 Write(".claude/mcp-status.json", {
   lastCheck: new Date().toISOString(),
   mcpVersion: "<detected_version>",
-  mcpPath: "<configured_path>",
+  bundled: true,
   status: "ok" | "error",
   tools: ["<available_tools>"],
   errors: ["<any_errors>"] // if status = error
@@ -101,18 +103,18 @@ Write(".claude/mcp-status.json", {
 ```
 MCP HEALTH CHECK
   Status: ✓ OK
-  Version: 1.5.0 (latest)
+  Version: 2.0.0 (bundled in CLI)
   Last check: 2024-01-15
-  Tools available: 12/12
+  Tools available: 19/19
 ```
 
 ### Warning (outdated)
 ```
 MCP HEALTH CHECK
   Status: ⚠️ UPDATE AVAILABLE
-  Current: 1.4.0
-  Latest: 1.5.0
-  Action: Run `cd SmartStack.mcp && git pull`
+  Current: 1.38.0
+  Latest: 2.0.0
+  Action: npm update -g @atlashub/smartstack-cli
 ```
 
 ### Error
@@ -120,7 +122,7 @@ MCP HEALTH CHECK
 MCP HEALTH CHECK
   Status: ❌ ERROR
   Issue: MCP server not responding
-  Action: Verify MCP configuration in Claude Code settings
+  Action: claude mcp add smartstack -- npx -p @atlashub/smartstack-cli smartstack-mcp
 ```
 
 ## Integration

package/templates/mcp-scaffolding/component.tsx.hbs

@@ -0,0 +1,298 @@
+import React, { useState, useEffect, useCallback } from 'react';
+
+// ============================================================================
+// Types
+// ============================================================================
+
+export interface {{name}}Data {
+  id?: string;
+  createdAt?: string;
+  updatedAt?: string;
+  // TODO: Add {{name}} specific properties
+}
+
+export interface {{name}}Props {
+  /** Entity ID for edit mode */
+  id?: string;
+  /** Initial data */
+  initialData?: Partial<{{name}}Data>;
+  /** Callback when data is saved */
+  onSave?: (data: {{name}}Data) => void;
+  /** Callback when cancelled */
+  onCancel?: () => void;
+  /** Loading state from parent */
+  loading?: boolean;
+  /** Read-only mode */
+  readOnly?: boolean;
+}
+
+// ============================================================================
+// Component
+// ============================================================================
+
+/**
+ * {{name}} component
+ *
+ * @example
+ * ```tsx
+ * <{{name}}
+ *   id="123"
+ *   onSave={(data) => console.log('Saved:', data)}
+ *   onCancel={() => navigate(-1)}
+ * />
+ * ```
+ */
+export const {{name}}: React.FC<{{name}}Props> = ({
+  id,
+  initialData,
+  onSave,
+  onCancel,
+  loading: externalLoading,
+  readOnly = false,
+}) => {
+  // State
+  const [data, setData] = useState<{{name}}Data>(initialData || {});
+  const [loading, setLoading] = useState(false);
+  const [error, setError] = useState<string | null>(null);
+  const [isDirty, setIsDirty] = useState(false);
+
+  // Combined loading state
+  const isLoading = loading || externalLoading;
+
+  // Fetch data when ID changes
+  useEffect(() => {
+    if (id && !initialData) {
+      fetchData(id);
+    }
+  }, [id, initialData]);
+
+  // Fetch data from API
+  const fetchData = useCallback(async (fetchId: string) => {
+    setLoading(true);
+    setError(null);
+
+    try {
+      // TODO: Implement API call
+      // const response = await {{nameCamel}}Api.getById(fetchId);
+      // setData(response);
+
+      // Placeholder
+      setData({ id: fetchId });
+    } catch (e) {
+      setError(e instanceof Error ? e.message : 'Failed to load data');
+    } finally {
+      setLoading(false);
+    }
+  }, []);
+
+  // Handle field change
+  const handleChange = useCallback((field: keyof {{name}}Data, value: unknown) => {
+    setData(prev => ({ ...prev, [field]: value }));
+    setIsDirty(true);
+  }, []);
+
+  // Handle form submission
+  const handleSubmit = useCallback(async (e: React.FormEvent) => {
+    e.preventDefault();
+
+    if (readOnly) return;
+
+    setLoading(true);
+    setError(null);
+
+    try {
+      // TODO: Implement API call
+      // const result = data.id
+      //   ? await {{nameCamel}}Api.update(data.id, data)
+      //   : await {{nameCamel}}Api.create(data);
+
+      if (onSave) {
+        onSave(data);
+      }
+
+      setIsDirty(false);
+    } catch (e) {
+      setError(e instanceof Error ? e.message : 'Failed to save');
+    } finally {
+      setLoading(false);
+    }
+  }, [data, onSave, readOnly]);
+
+  // Handle cancel
+  const handleCancel = useCallback(() => {
+    if (isDirty) {
+      const confirmed = window.confirm('You have unsaved changes. Are you sure you want to cancel?');
+      if (!confirmed) return;
+    }
+
+    if (onCancel) {
+      onCancel();
+    }
+  }, [isDirty, onCancel]);
+
+  // Render loading state
+  if (isLoading && !data.id) {
+    return (
+      <div className="flex items-center justify-center p-8">
+        <div className="animate-spin rounded-full h-8 w-8 border-b-2 border-blue-500" />
+        <span className="ml-2 text-gray-600">Loading...</span>
+      </div>
+    );
+  }
+
+  // Render error state
+  if (error) {
+    return (
+      <div className="p-4 bg-red-50 border border-red-200 rounded-lg">
+        <div className="flex items-center">
+          <svg className="h-5 w-5 text-red-400" viewBox="0 0 20 20" fill="currentColor">
+            <path fillRule="evenodd" d="M10 18a8 8 0 100-16 8 8 0 000 16zM8.707 7.293a1 1 0 00-1.414 1.414L8.586 10l-1.293 1.293a1 1 0 101.414 1.414L10 11.414l1.293 1.293a1 1 0 001.414-1.414L11.414 10l1.293-1.293a1 1 0 00-1.414-1.414L10 8.586 8.707 7.293z" clipRule="evenodd" />
+          </svg>
+          <span className="ml-2 text-red-700">{error}</span>
+        </div>
+        <button
+          onClick={() => id && fetchData(id)}
+          className="mt-2 text-sm text-red-600 hover:text-red-800 underline"
+        >
+          Try again
+        </button>
+      </div>
+    );
+  }
+
+  return (
+    <div className="bg-white rounded-lg shadow-sm border border-gray-200">
+      {/* Header */}
+      <div className="px-6 py-4 border-b border-gray-200">
+        <h2 className="text-xl font-semibold text-gray-900">
+          {id ? 'Edit' : 'Create'} {{name}}
+        </h2>
+        {isDirty && (
+          <span className="text-sm text-amber-600">Unsaved changes</span>
+        )}
+      </div>
+
+      {/* Form */}
+      <form onSubmit={handleSubmit} className="p-6 space-y-6">
+        {/* TODO: Add form fields */}
+        <div className="text-gray-500 text-center py-8">
+          Add your form fields here
+        </div>
+
+        {/* Actions */}
+        {!readOnly && (
+          <div className="flex items-center justify-end gap-3 pt-4 border-t border-gray-200">
+            {onCancel && (
+              <button
+                type="button"
+                onClick={handleCancel}
+                disabled={isLoading}
+                className="px-4 py-2 text-gray-700 bg-white border border-gray-300 rounded-lg hover:bg-gray-50 disabled:opacity-50"
+              >
+                Cancel
+              </button>
+            )}
+            <button
+              type="submit"
+              disabled={isLoading || !isDirty}
+              className="px-4 py-2 text-white bg-blue-600 rounded-lg hover:bg-blue-700 disabled:opacity-50 disabled:cursor-not-allowed"
+            >
+              {isLoading ? 'Saving...' : 'Save'}
+            </button>
+          </div>
+        )}
+      </form>
+    </div>
+  );
+};
+
+export default {{name}};
+
+// ============================================================================
+// Hook
+// ============================================================================
+
+export interface Use{{name}}Options {
+  id?: string;
+  autoFetch?: boolean;
+}
+
+export function use{{name}}(options: Use{{name}}Options = {}) {
+  const { id, autoFetch = true } = options;
+
+  const [data, setData] = useState<{{name}}Data | null>(null);
+  const [loading, setLoading] = useState(false);
+  const [error, setError] = useState<Error | null>(null);
+
+  const fetch = useCallback(async (fetchId?: string) => {
+    const targetId = fetchId || id;
+    if (!targetId) return;
+
+    setLoading(true);
+    setError(null);
+
+    try {
+      // TODO: Implement API call
+      // const result = await {{nameCamel}}Api.getById(targetId);
+      // setData(result);
+    } catch (e) {
+      setError(e instanceof Error ? e : new Error('Unknown error'));
+    } finally {
+      setLoading(false);
+    }
+  }, [id]);
+
+  const save = useCallback(async (saveData: {{name}}Data) => {
+    setLoading(true);
+    setError(null);
+
+    try {
+      // TODO: Implement API call
+      // const result = saveData.id
+      //   ? await {{nameCamel}}Api.update(saveData.id, saveData)
+      //   : await {{nameCamel}}Api.create(saveData);
+      // setData(result);
+      // return result;
+    } catch (e) {
+      setError(e instanceof Error ? e : new Error('Unknown error'));
+      throw e;
+    } finally {
+      setLoading(false);
+    }
+  }, []);
+
+  const remove = useCallback(async (removeId?: string) => {
+    const targetId = removeId || id;
+    if (!targetId) return;
+
+    setLoading(true);
+    setError(null);
+
+    try {
+      // TODO: Implement API call
+      // await {{nameCamel}}Api.delete(targetId);
+      setData(null);
+    } catch (e) {
+      setError(e instanceof Error ? e : new Error('Unknown error'));
+      throw e;
+    } finally {
+      setLoading(false);
+    }
+  }, [id]);
+
+  useEffect(() => {
+    if (autoFetch && id) {
+      fetch();
+    }
+  }, [autoFetch, id, fetch]);
+
+  return {
+    data,
+    loading,
+    error,
+    fetch,
+    save,
+    remove,
+    setData,
+  };
+}

package/templates/mcp-scaffolding/controller.cs.hbs

@@ -0,0 +1,184 @@
+using System;
+using System.Collections.Generic;
+using System.Threading;
+using System.Threading.Tasks;
+using Microsoft.AspNetCore.Authorization;
+using Microsoft.AspNetCore.Mvc;
+using Microsoft.Extensions.Logging;
+
+namespace {{namespace}}.Controllers;
+
+/// <summary>
+/// API controller for {{name}} operations
+/// </summary>
+[ApiController]
+[Route("api/[controller]")]
+{{#if navRoute}}
+[NavRoute("{{navRoute}}")]
+{{/if}}
+[Authorize]
+[Produces("application/json")]
+public class {{name}}Controller : ControllerBase
+{
+    private readonly ILogger<{{name}}Controller> _logger;
+    // private readonly I{{name}}Service _{{nameCamel}}Service;
+
+    public {{name}}Controller(
+        ILogger<{{name}}Controller> logger
+        // I{{name}}Service {{nameCamel}}Service
+    )
+    {
+        _logger = logger ?? throw new ArgumentNullException(nameof(logger));
+        // _{{nameCamel}}Service = {{nameCamel}}Service ?? throw new ArgumentNullException(nameof({{nameCamel}}Service));
+    }
+
+    /// <summary>
+    /// Get all {{namePlural}}
+    /// </summary>
+    /// <param name="cancellationToken">Cancellation token</param>
+    /// <returns>List of {{namePlural}}</returns>
+    [HttpGet]
+{{#if navRoute}}
+    [Authorize(Policy = "{{navRoute}}.read")]
+{{/if}}
+    [ProducesResponseType(typeof(IEnumerable<{{name}}Dto>), 200)]
+    public async Task<ActionResult<IEnumerable<{{name}}Dto>>> GetAll(CancellationToken cancellationToken = default)
+    {
+        _logger.LogInformation("Getting all {{namePlural}}");
+
+        // TODO: Implement using service
+        // var result = await _{{nameCamel}}Service.GetAllAsync(cancellationToken);
+        // return Ok(result);
+
+        return Ok(Array.Empty<{{name}}Dto>());
+    }
+
+    /// <summary>
+    /// Get {{nameCamel}} by ID
+    /// </summary>
+    /// <param name="id">{{name}} ID</param>
+    /// <param name="cancellationToken">Cancellation token</param>
+    /// <returns>{{name}} details</returns>
+    [HttpGet("{id:guid}")]
+{{#if navRoute}}
+    [Authorize(Policy = "{{navRoute}}.read")]
+{{/if}}
+    [ProducesResponseType(typeof({{name}}Dto), 200)]
+    [ProducesResponseType(404)]
+    public async Task<ActionResult<{{name}}Dto>> GetById(
+        Guid id,
+        CancellationToken cancellationToken = default)
+    {
+        _logger.LogInformation("Getting {{nameCamel}} {Id}", id);
+
+        // TODO: Implement using service
+        // var result = await _{{nameCamel}}Service.GetByIdAsync(id, cancellationToken);
+        // if (result == null) return NotFound();
+        // return Ok(result);
+
+        return NotFound();
+    }
+
+    /// <summary>
+    /// Create new {{nameCamel}}
+    /// </summary>
+    /// <param name="request">Create request</param>
+    /// <param name="cancellationToken">Cancellation token</param>
+    /// <returns>Created {{nameCamel}}</returns>
+    [HttpPost]
+{{#if navRoute}}
+    [Authorize(Policy = "{{navRoute}}.create")]
+{{/if}}
+    [ProducesResponseType(typeof({{name}}Dto), 201)]
+    [ProducesResponseType(400)]
+    public async Task<ActionResult<{{name}}Dto>> Create(
+        [FromBody] Create{{name}}Request request,
+        CancellationToken cancellationToken = default)
+    {
+        _logger.LogInformation("Creating new {{nameCamel}}");
+
+        // TODO: Validate and create using service
+        // var result = await _{{nameCamel}}Service.CreateAsync(request, cancellationToken);
+        // return CreatedAtAction(nameof(GetById), new { id = result.Id }, result);
+
+        var id = Guid.NewGuid();
+        return CreatedAtAction(nameof(GetById), new { id }, null);
+    }
+
+    /// <summary>
+    /// Update {{nameCamel}}
+    /// </summary>
+    /// <param name="id">{{name}} ID</param>
+    /// <param name="request">Update request</param>
+    /// <param name="cancellationToken">Cancellation token</param>
+    [HttpPut("{id:guid}")]
+{{#if navRoute}}
+    [Authorize(Policy = "{{navRoute}}.update")]
+{{/if}}
+    [ProducesResponseType(204)]
+    [ProducesResponseType(404)]
+    [ProducesResponseType(400)]
+    public async Task<ActionResult> Update(
+        Guid id,
+        [FromBody] Update{{name}}Request request,
+        CancellationToken cancellationToken = default)
+    {
+        _logger.LogInformation("Updating {{nameCamel}} {Id}", id);
+
+        // TODO: Implement using service
+        // await _{{nameCamel}}Service.UpdateAsync(id, request, cancellationToken);
+
+        return NoContent();
+    }
+
+    /// <summary>
+    /// Delete {{nameCamel}}
+    /// </summary>
+    /// <param name="id">{{name}} ID</param>
+    /// <param name="cancellationToken">Cancellation token</param>
+    [HttpDelete("{id:guid}")]
+{{#if navRoute}}
+    [Authorize(Policy = "{{navRoute}}.delete")]
+{{/if}}
+    [ProducesResponseType(204)]
+    [ProducesResponseType(404)]
+    public async Task<ActionResult> Delete(
+        Guid id,
+        CancellationToken cancellationToken = default)
+    {
+        _logger.LogInformation("Deleting {{nameCamel}} {Id}", id);
+
+        // TODO: Implement using service
+        // await _{{nameCamel}}Service.DeleteAsync(id, cancellationToken);
+
+        return NoContent();
+    }
+}
+
+// ============================================================================
+// DTOs
+// ============================================================================
+
+/// <summary>
+/// {{name}} data transfer object
+/// </summary>
+public record {{name}}Dto(
+    Guid Id,
+    DateTime CreatedAt,
+    DateTime? UpdatedAt
+    // TODO: Add additional properties
+);
+
+/// <summary>
+/// Request to create a new {{nameCamel}}
+/// </summary>
+public record Create{{name}}Request(
+    // TODO: Add creation properties
+);
+
+/// <summary>
+/// Request to update a {{nameCamel}}
+/// </summary>
+public record Update{{name}}Request(
+    // TODO: Add update properties
+);