smart-spec-kit-mcp 2.0.0

package/README.md

@@ -0,0 +1,262 @@
+# 🚀 Spec-Kit MCP Server
+
+Plateforme d'orchestration automatisée pour transformer vos work items Azure DevOps en spécifications complètes via **GitHub Copilot**.
+
+## ✨ Fonctionnalités
+
+- **🤖 Orchestration Automatisée**: Un seul prompt, Copilot fait le reste
+- **🔄 Workflows YAML**: Processus personnalisables étape par étape
+- **🛡️ Gouvernance Intégrée**: RGPD, Sécurité, Architecture, Design System
+- **📝 Templates**: Spécifications, bugfix reports, documentation
+- **🔗 Azure DevOps**: Intégration native via MCP
+
+---
+
+## ⚡ Installation Express
+
+### Via Slash Command (Recommandé)
+
+Dans **GitHub Copilot Chat**:
+
+```text
+/setupSpecKit
+```
+
+L'assistant configure tout automatiquement selon votre environnement.
+
+### Via NPX (Zero Config)
+
+Ajoutez dans VS Code `settings.json`:
+
+```json
+{
+  "mcp": {
+    "servers": {
+      "spec-kit": {
+        "command": "npx",
+        "args": ["-y", "spec-kit-mcp"]
+      }
+    }
+  }
+}
+```
+
+Rechargez VS Code (`Ctrl+Shift+P` → "Developer: Reload Window").
+
+### Installation Locale
+
+```bash
+git clone https://github.com/your-org/spec-kit-mcp.git
+cd spec-kit-mcp
+npm install
+npm run build
+```
+
+```json
+{
+  "mcp": {
+    "servers": {
+      "spec-kit": {
+        "command": "node",
+        "args": ["/path/to/spec-kit-mcp/dist/index.js"]
+      }
+    }
+  }
+}
+```
+
+---
+
+## 🚀 Usage
+
+### Démarrer un Workflow
+
+```text
+@spec-kit start_workflow workflow_name="feature-standard" context_id="12345"
+```
+
+Le serveur orchestre automatiquement:
+
+1. Récupération du work item Azure DevOps
+2. Génération de la spécification (SpecAgent)
+3. Planification technique (PlanAgent)
+4. Validation gouvernance (GovAgent)
+5. Création des artefacts
+
+> Validez chaque étape avec "OK" - c'est tout!
+
+### Workflows Disponibles
+
+| Workflow           | Description                              |
+| ------------------ | ---------------------------------------- |
+| `feature-standard` | Spécification fonctionnelle (5 étapes)   |
+| `feature-full`     | Spec + gouvernance complète (10 étapes)  |
+| `bugfix`           | Rapport de correction de bug (5 étapes)  |
+
+---
+
+## 🛠 MCP Tools
+
+### Orchestration
+
+| Tool              | Description                     |
+| ----------------- | ------------------------------- |
+| `start_workflow`  | Démarre un workflow automatisé  |
+| `execute_step`    | Continue à l'étape suivante     |
+| `workflow_status` | Statut de la session active     |
+| `list_workflows`  | Liste les workflows disponibles |
+| `abort_workflow`  | Annule le workflow en cours     |
+
+### Utilitaires
+
+| Tool   | Description             |
+| ------ | ----------------------- |
+| `ping` | Health check du serveur |
+| `help` | Aide et documentation   |
+
+---
+
+## 🤖 Agents IA
+
+| Agent        | Rôle          | Utilisation                      |
+| ------------ | ------------- | -------------------------------- |
+| **SpecAgent**| Rédacteur     | Spécifications fonctionnelles    |
+| **PlanAgent**| Planificateur | Découpage en tâches techniques   |
+| **GovAgent** | Validateur    | Conformité RGPD, Sécurité, Archi |
+| **TestAgent**| Testeur       | Stratégies et cas de tests       |
+
+---
+
+## 📁 Structure du Projet
+
+```text
+spec-kit-mcp/
+├── src/
+│   ├── index.ts                 # Entrypoint MCP Server
+│   ├── engine/
+│   │   ├── sessionManager.ts    # Gestion des sessions
+│   │   └── workflowEngine.ts    # Moteur d'orchestration
+│   ├── tools/
+│   │   └── orchestrationTools.ts # Tools MCP
+│   ├── prompts/
+│   │   └── agents.ts            # System prompts des agents
+│   ├── schemas/
+│   │   └── workflowSchema.ts    # Validation Zod
+│   └── utils/
+│       ├── workflowLoader.ts    # Chargeur YAML
+│       └── markdownGenerator.ts # Générateur de templates
+├── workflows/                   # Définitions YAML
+│   ├── feature-standard.yaml
+│   ├── feature-full.yaml
+│   └── bugfix.yaml
+├── templates/                   # Templates Markdown
+│   ├── functional-spec.md
+│   └── bugfix-report.md
+└── .github/
+    └── copilot/
+        └── setupSpecKit.md      # Slash command setup
+```
+
+---
+
+## 🔗 Intégration Azure DevOps
+
+Pour activer l'intégration ADO, ajoutez le serveur MCP Azure DevOps:
+
+```json
+{
+  "mcp": {
+    "servers": {
+      "spec-kit": {
+        "command": "npx",
+        "args": ["-y", "spec-kit-mcp"]
+      },
+      "azure-devops": {
+        "command": "npx",
+        "args": ["-y", "@modelcontextprotocol/server-azure-devops"],
+        "env": {
+          "AZURE_DEVOPS_ORG_URL": "https://dev.azure.com/your-org",
+          "AZURE_DEVOPS_PAT": "your-personal-access-token"
+        }
+      }
+    }
+  }
+}
+```
+
+---
+
+## 📐 Créer un Workflow Custom
+
+```yaml
+name: mon-workflow
+displayName: "Mon Workflow"
+description: "Description"
+template: mon-template.md
+defaultAgent: SpecAgent
+
+steps:
+  - id: fetch
+    name: "Récupération"
+    action: fetch_ado
+    description: "Récupère le work item"
+    
+  - id: generate
+    name: "Génération"
+    action: call_agent
+    agent: SpecAgent
+    description: "Génère le contenu"
+```
+
+**Actions disponibles**: `fetch_ado`, `generate_content`, `call_agent`, `review`, `create_file`
+
+---
+
+## 🧪 Développement
+
+```bash
+npm run build    # Compile TypeScript
+npm run dev      # Watch mode
+npm run start    # Lance le serveur
+```
+
+---
+
+## � Personnalisation
+
+### Initialiser la config locale
+
+```text
+@spec-kit init
+```
+
+Crée `.spec-kit/` avec des workflows et templates personnalisables.
+
+### Voir la configuration
+
+```text
+@spec-kit config
+```
+
+Affiche les chemins de recherche et workflows disponibles (locaux vs package).
+
+### Ordre de résolution
+
+1. **Local**: `.spec-kit/workflows/` et `.spec-kit/templates/`
+2. **Package**: Workflows par défaut (feature-standard, bugfix, etc.)
+
+> 📖 Voir [docs/PACKAGING.md](docs/PACKAGING.md) pour le guide complet de personnalisation.
+
+---
+
+## �📄 License
+
+MIT
+
+---
+
+## 🙏 Technologies
+
+- [@modelcontextprotocol/sdk](https://github.com/modelcontextprotocol/sdk) - MCP Framework
+- [Zod](https://zod.dev) - Schema Validation
+- [js-yaml](https://github.com/nodeca/js-yaml) - YAML Parser

package/dist/engine/sessionManager.d.ts

@@ -0,0 +1,137 @@
+/**
+ * Workflow Session Manager
+ *
+ * Manages workflow execution state with persistence.
+ * Each session tracks: current step, collected data, and workflow context.
+ */
+/**
+ * Data collected during workflow execution
+ */
+export interface WorkflowData {
+    /** Raw work item data from Azure DevOps */
+    workItemData?: Record<string, unknown>;
+    /** Generated specification content */
+    specification?: string;
+    /** Technical plan */
+    technicalPlan?: string;
+    /** Validation reports */
+    validations?: {
+        rgpd?: {
+            status: string;
+            issues: string[];
+        };
+        security?: {
+            status: string;
+            issues: string[];
+        };
+        architecture?: {
+            status: string;
+            issues: string[];
+        };
+        design?: {
+            status: string;
+            issues: string[];
+        };
+        general?: {
+            status: string;
+            issues: string[];
+        };
+        [key: string]: {
+            status: string;
+            issues: string[];
+        } | undefined;
+    };
+    /** Generated tasks */
+    tasks?: Array<{
+        id: string;
+        title: string;
+        estimate: string;
+    }>;
+    /** Any additional data collected during steps */
+    [key: string]: unknown;
+}
+/**
+ * Workflow session state
+ */
+export interface WorkflowSession {
+    /** Unique session identifier */
+    sessionId: string;
+    /** Workflow name being executed */
+    workflowName: string;
+    /** Context ID (e.g., Azure DevOps work item ID) */
+    contextId: string;
+    /** Current step index */
+    currentStepIndex: number;
+    /** Current step ID */
+    currentStepId: string;
+    /** Session status */
+    status: "active" | "paused" | "completed" | "failed";
+    /** Collected data from all steps */
+    data: WorkflowData;
+    /** Timestamp of session creation */
+    createdAt: string;
+    /** Timestamp of last update */
+    updatedAt: string;
+    /** History of executed steps */
+    history: Array<{
+        stepId: string;
+        stepName: string;
+        status: "completed" | "skipped" | "failed";
+        timestamp: string;
+        output?: string;
+    }>;
+    /** Pending action for Copilot */
+    pendingAction?: {
+        type: "call_tool" | "user_input" | "confirmation" | "generate";
+        instruction: string;
+        toolName?: string;
+        toolArgs?: Record<string, unknown>;
+    };
+}
+/**
+ * Session store - in-memory with file persistence
+ */
+declare class SessionStore {
+    private sessions;
+    private persistDir;
+    constructor();
+    /**
+     * Initialize the session store
+     */
+    init(): Promise<void>;
+    /**
+     * Generate a unique session ID
+     */
+    generateSessionId(): string;
+    /**
+     * Create a new session
+     */
+    create(workflowName: string, contextId: string, firstStepId: string): Promise<WorkflowSession>;
+    /**
+     * Get a session by ID
+     */
+    get(sessionId: string): WorkflowSession | undefined;
+    /**
+     * Get the most recent active session
+     */
+    getActiveSession(): WorkflowSession | undefined;
+    /**
+     * Update a session
+     */
+    update(session: WorkflowSession): Promise<void>;
+    /**
+     * Persist session to disk
+     */
+    private persist;
+    /**
+     * Delete a session
+     */
+    delete(sessionId: string): Promise<void>;
+    /**
+     * List all sessions
+     */
+    list(): WorkflowSession[];
+}
+export declare const sessionStore: SessionStore;
+export {};
+//# sourceMappingURL=sessionManager.d.ts.map

package/dist/engine/sessionManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionManager.d.ts","sourceRoot":"","sources":["../../src/engine/sessionManager.ts"],"names":[],"mappings":"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"}

package/dist/engine/sessionManager.js

@@ -0,0 +1,128 @@
+/**
+ * Workflow Session Manager
+ *
+ * Manages workflow execution state with persistence.
+ * Each session tracks: current step, collected data, and workflow context.
+ */
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import * as os from "node:os";
+/**
+ * Session store - in-memory with file persistence
+ */
+class SessionStore {
+    sessions = new Map();
+    persistDir;
+    constructor() {
+        this.persistDir = path.join(os.tmpdir(), "spec-kit-sessions");
+    }
+    /**
+     * Initialize the session store
+     */
+    async init() {
+        try {
+            await fs.mkdir(this.persistDir, { recursive: true });
+            // Load existing sessions
+            const files = await fs.readdir(this.persistDir);
+            for (const file of files) {
+                if (file.endsWith(".json")) {
+                    const content = await fs.readFile(path.join(this.persistDir, file), "utf-8");
+                    const session = JSON.parse(content);
+                    this.sessions.set(session.sessionId, session);
+                }
+            }
+        }
+        catch {
+            // Directory might not exist yet, that's fine
+        }
+    }
+    /**
+     * Generate a unique session ID
+     */
+    generateSessionId() {
+        const timestamp = Date.now().toString(36);
+        const random = Math.random().toString(36).substring(2, 8);
+        return `wf-${timestamp}-${random}`;
+    }
+    /**
+     * Create a new session
+     */
+    async create(workflowName, contextId, firstStepId) {
+        const sessionId = this.generateSessionId();
+        const now = new Date().toISOString();
+        const session = {
+            sessionId,
+            workflowName,
+            contextId,
+            currentStepIndex: 0,
+            currentStepId: firstStepId,
+            status: "active",
+            data: {},
+            createdAt: now,
+            updatedAt: now,
+            history: [],
+        };
+        this.sessions.set(sessionId, session);
+        await this.persist(session);
+        return session;
+    }
+    /**
+     * Get a session by ID
+     */
+    get(sessionId) {
+        return this.sessions.get(sessionId);
+    }
+    /**
+     * Get the most recent active session
+     */
+    getActiveSession() {
+        let latest;
+        for (const session of this.sessions.values()) {
+            if (session.status === "active") {
+                if (!latest || session.updatedAt > latest.updatedAt) {
+                    latest = session;
+                }
+            }
+        }
+        return latest;
+    }
+    /**
+     * Update a session
+     */
+    async update(session) {
+        session.updatedAt = new Date().toISOString();
+        this.sessions.set(session.sessionId, session);
+        await this.persist(session);
+    }
+    /**
+     * Persist session to disk
+     */
+    async persist(session) {
+        const filePath = path.join(this.persistDir, `${session.sessionId}.json`);
+        await fs.writeFile(filePath, JSON.stringify(session, null, 2), "utf-8");
+    }
+    /**
+     * Delete a session
+     */
+    async delete(sessionId) {
+        this.sessions.delete(sessionId);
+        const filePath = path.join(this.persistDir, `${sessionId}.json`);
+        try {
+            await fs.unlink(filePath);
+        }
+        catch {
+            // File might not exist
+        }
+    }
+    /**
+     * List all sessions
+     */
+    list() {
+        return Array.from(this.sessions.values());
+    }
+}
+// Singleton instance
+export const sessionStore = new SessionStore();
+// Initialize on module load
+sessionStore.init().catch(console.error);
+//# sourceMappingURL=sessionManager.js.map

package/dist/engine/sessionManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionManager.js","sourceRoot":"","sources":["../../src/engine/sessionManager.ts"],"names":[],"mappings":"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"}

package/dist/engine/workflowEngine.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Workflow Engine
+ *
+ * Orchestrates automatic workflow execution.
+ * Each step returns instructions for Copilot to execute the next action.
+ */
+import { type WorkflowSession } from "./sessionManager.js";
+/**
+ * Result of executing a workflow step
+ */
+export interface StepResult {
+    /** Whether the step completed successfully */
+    success: boolean;
+    /** Session ID for tracking */
+    sessionId: string;
+    /** Current step info */
+    currentStep: {
+        index: number;
+        id: string;
+        name: string;
+    };
+    /** Message to display to user */
+    userMessage: string;
+    /**
+     * Next action for Copilot to execute.
+     * This is the KEY for automation - Copilot will execute this instruction.
+     */
+    nextAction: {
+        type: "call_mcp_tool" | "user_confirmation" | "workflow_complete" | "error";
+        /** Human-readable description of what will happen */
+        description: string;
+        /** For call_mcp_tool: the exact instruction for Copilot */
+        copilotInstruction?: string;
+        /** For user_confirmation: what the user needs to confirm */
+        confirmationPrompt?: string;
+        /** Is this an automatic action or does it need user approval? */
+        requiresApproval: boolean;
+    };
+    /** Data collected/generated in this step */
+    data?: Record<string, unknown>;
+}
+/**
+ * Start a new workflow execution
+ */
+export declare function startWorkflow(workflowName: string, contextId: string): Promise<StepResult>;
+/**
+ * Execute the next step in a workflow
+ */
+export declare function executeStep(sessionId: string, previousOutput?: string | Record<string, unknown>): Promise<StepResult>;
+/**
+ * Get current session status
+ */
+export declare function getSessionStatus(sessionId?: string): Promise<{
+    session: WorkflowSession | null;
+    summary: string;
+}>;
+//# sourceMappingURL=workflowEngine.d.ts.map

package/dist/engine/workflowEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflowEngine.d.ts","sourceRoot":"","sources":["../../src/engine/workflowEngine.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,OAAO,EAEL,KAAK,eAAe,EAErB,MAAM,qBAAqB,CAAC;AAG7B;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,8CAA8C;IAC9C,OAAO,EAAE,OAAO,CAAC;IACjB,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,wBAAwB;IACxB,WAAW,EAAE;QACX,KAAK,EAAE,MAAM,CAAC;QACd,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IACF,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,UAAU,EAAE;QACV,IAAI,EAAE,eAAe,GAAG,mBAAmB,GAAG,mBAAmB,GAAG,OAAO,CAAC;QAC5E,qDAAqD;QACrD,WAAW,EAAE,MAAM,CAAC;QACpB,2DAA2D;QAC3D,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,4DAA4D;QAC5D,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,iEAAiE;QACjE,gBAAgB,EAAE,OAAO,CAAC;KAC3B,CAAC;IACF,4CAA4C;IAC5C,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,UAAU,CAAC,CAcrB;AAED;;GAEG;AACH,wBAAsB,WAAW,CAC/B,SAAS,EAAE,MAAM,EACjB,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChD,OAAO,CAAC,UAAU,CAAC,CAiErB;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAClE,OAAO,EAAE,eAAe,GAAG,IAAI,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC,CA0BD"}