smart-spec-kit-mcp 2.0.0

package/dist/utils/workflowLoader.js

@@ -0,0 +1,281 @@
+/**
+ * Workflow Loader v2
+ *
+ * Loads workflows and templates with local override support.
+ *
+ * Resolution order:
+ * 1. Local project: .spec-kit/workflows/ and .spec-kit/templates/
+ * 2. Package defaults: /workflows and /templates
+ *
+ * This allows any project to customize workflows while using defaults.
+ */
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import yaml from "js-yaml";
+import { WorkflowSchema } from "../schemas/workflowSchema.js";
+// Directory names
+const WORKFLOWS_DIR = "workflows";
+const TEMPLATES_DIR = "templates";
+const LOCAL_CONFIG_DIR = ".spec-kit";
+/**
+ * Get the package root directory (where the npm package is installed)
+ */
+function getPackageRoot() {
+    const currentDir = path.dirname(new URL(import.meta.url).pathname);
+    // Handle Windows paths (remove leading slash if present)
+    const normalizedDir = currentDir.replace(/^\/([A-Za-z]:)/, "$1");
+    // Go up from dist/utils/ or src/utils/ to package root
+    return path.resolve(normalizedDir, "..", "..");
+}
+/**
+ * Get the current working directory (user's project)
+ */
+function getProjectRoot() {
+    return process.cwd();
+}
+/**
+ * Check if a file exists
+ */
+async function fileExists(filePath) {
+    try {
+        await fs.access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Get all search paths for assets (local first, then package defaults)
+ */
+function getSearchPaths(assetType) {
+    const projectRoot = getProjectRoot();
+    const packageRoot = getPackageRoot();
+    const dir = assetType === "workflows" ? WORKFLOWS_DIR : TEMPLATES_DIR;
+    return [
+        // 1. Local project override: .spec-kit/workflows/ or .spec-kit/templates/
+        path.join(projectRoot, LOCAL_CONFIG_DIR, dir),
+        // 2. Local project root: workflows/ or templates/ (for dedicated spec projects)
+        path.join(projectRoot, dir),
+        // 3. Package defaults
+        path.join(packageRoot, dir),
+    ];
+}
+/**
+ * Find a file in search paths
+ */
+async function findFile(assetType, fileName) {
+    const searchPaths = getSearchPaths(assetType);
+    for (const basePath of searchPaths) {
+        const filePath = path.join(basePath, fileName);
+        if (await fileExists(filePath)) {
+            return filePath;
+        }
+    }
+    return null;
+}
+/**
+ * List files from all search paths (local overrides + package defaults)
+ */
+async function listFilesFromPaths(assetType, extension) {
+    const searchPaths = getSearchPaths(assetType);
+    const seen = new Set();
+    const results = [];
+    for (let i = 0; i < searchPaths.length; i++) {
+        const basePath = searchPaths[i];
+        const isLocal = i < 2; // First two paths are local
+        try {
+            const files = await fs.readdir(basePath);
+            for (const file of files) {
+                const isYaml = file.endsWith(extension) || file.endsWith(".yml");
+                if (isYaml) {
+                    const name = path.basename(file, path.extname(file));
+                    const alreadySeen = seen.has(name);
+                    if (!alreadySeen) {
+                        seen.add(name);
+                        results.push({
+                            name,
+                            path: path.join(basePath, file),
+                            source: isLocal ? "local" : "package",
+                        });
+                    }
+                }
+            }
+        }
+        catch {
+            // Directory doesn't exist, continue
+        }
+    }
+    return results;
+}
+/**
+ * List all available workflows (local + package defaults)
+ */
+export async function listWorkflows() {
+    const workflows = await listFilesFromPaths("workflows", ".yaml");
+    return workflows.map((w) => w.name);
+}
+/**
+ * List workflows with source information
+ */
+export async function listWorkflowsDetailed() {
+    return listFilesFromPaths("workflows", ".yaml");
+}
+/**
+ * Load and validate a workflow by name
+ */
+export async function loadWorkflow(workflowName) {
+    // Try both .yaml and .yml extensions
+    let filePath = await findFile("workflows", `${workflowName}.yaml`);
+    if (!filePath) {
+        filePath = await findFile("workflows", `${workflowName}.yml`);
+    }
+    if (!filePath) {
+        const available = await listWorkflows();
+        throw new Error(`Workflow "${workflowName}" not found.\nAvailable workflows: ${available.join(", ") || "none"}\n\nTip: Create custom workflows in .spec-kit/workflows/`);
+    }
+    // Read and parse YAML
+    const content = await fs.readFile(filePath, "utf-8");
+    const rawData = yaml.load(content);
+    // Validate with Zod
+    const result = WorkflowSchema.safeParse(rawData);
+    if (!result.success) {
+        const errors = result.error.issues
+            .map((e) => `  - ${String(e.path.join("."))}: ${e.message}`)
+            .join("\n");
+        throw new Error(`Invalid workflow "${workflowName}":\n${errors}`);
+    }
+    return result.data;
+}
+/**
+ * Load a template file by name
+ */
+export async function loadTemplate(templateName) {
+    // Add .md extension if not present
+    const fileName = templateName.endsWith(".md") ? templateName : `${templateName}.md`;
+    const filePath = await findFile("templates", fileName);
+    if (!filePath) {
+        throw new Error(`Template "${templateName}" not found.\n\nTip: Create custom templates in .spec-kit/templates/`);
+    }
+    return await fs.readFile(filePath, "utf-8");
+}
+/**
+ * List all available templates (local + package defaults)
+ */
+export async function listTemplates() {
+    const templates = await listFilesFromPaths("templates", ".md");
+    return templates.map((t) => t.name);
+}
+/**
+ * Load a workflow with its associated template
+ */
+export async function loadWorkflowWithTemplate(workflowName) {
+    const workflow = await loadWorkflow(workflowName);
+    const template = await loadTemplate(workflow.template);
+    return { workflow, template };
+}
+/**
+ * Get workflow step by ID
+ */
+export function getWorkflowStep(workflow, stepId) {
+    return workflow.steps.find((step) => step.id === stepId);
+}
+/**
+ * Get the first step of a workflow
+ */
+export function getFirstStep(workflow) {
+    return workflow.steps[0];
+}
+/**
+ * Get the next step in a workflow
+ */
+export function getNextStep(workflow, currentStepId) {
+    const currentIndex = workflow.steps.findIndex((step) => step.id === currentStepId);
+    if (currentIndex === -1 || currentIndex === workflow.steps.length - 1) {
+        return null;
+    }
+    const currentStep = workflow.steps[currentIndex];
+    // Check if there's an explicit next step
+    if (currentStep?.next) {
+        return getWorkflowStep(workflow, currentStep.next);
+    }
+    // Otherwise return sequential next
+    return workflow.steps[currentIndex + 1];
+}
+/**
+ * Initialize local spec-kit directory with example files
+ */
+export async function initLocalConfig() {
+    const projectRoot = getProjectRoot();
+    const localDir = path.join(projectRoot, LOCAL_CONFIG_DIR);
+    const workflowsDir = path.join(localDir, WORKFLOWS_DIR);
+    const templatesDir = path.join(localDir, TEMPLATES_DIR);
+    // Create directories
+    await fs.mkdir(workflowsDir, { recursive: true });
+    await fs.mkdir(templatesDir, { recursive: true });
+    // Create example workflow
+    const exampleWorkflow = `# Custom Workflow Example
+# This file overrides or extends the default spec-kit workflows.
+# See https://github.com/your-org/spec-kit-mcp for documentation.
+
+name: custom-feature
+displayName: "Custom Feature Workflow"
+description: "Your custom workflow for this project"
+template: custom-spec.md
+defaultAgent: SpecAgent
+
+steps:
+  - id: fetch-requirements
+    name: "Fetch Requirements"
+    action: fetch_ado
+    description: "Retrieve work item from Azure DevOps"
+    outputs:
+      - workitem
+
+  - id: generate-spec
+    name: "Generate Specification"
+    action: call_agent
+    agent: SpecAgent
+    description: "Generate specification document"
+    inputs:
+      source: workitem
+`;
+    const exampleTemplate = `# {{title}}
+
+## Context
+- **Work Item**: {{contextId}}
+- **Date**: {{date}}
+
+## Description
+{{description}}
+
+## Requirements
+<!-- Generated requirements go here -->
+
+## Technical Notes
+<!-- Add your stack-specific notes -->
+`;
+    const workflowPath = path.join(workflowsDir, "custom-feature.yaml");
+    const templatePath = path.join(templatesDir, "custom-spec.md");
+    // Only create if they don't exist
+    if (!(await fileExists(workflowPath))) {
+        await fs.writeFile(workflowPath, exampleWorkflow, "utf-8");
+    }
+    if (!(await fileExists(templatePath))) {
+        await fs.writeFile(templatePath, exampleTemplate, "utf-8");
+    }
+}
+/**
+ * Get configuration info for debugging
+ */
+export function getConfigInfo() {
+    return {
+        packageRoot: getPackageRoot(),
+        projectRoot: getProjectRoot(),
+        searchPaths: {
+            workflows: getSearchPaths("workflows"),
+            templates: getSearchPaths("templates"),
+        },
+    };
+}
+//# sourceMappingURL=workflowLoader.js.map

package/dist/utils/workflowLoader.js.map

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

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "smart-spec-kit-mcp",
+  "version": "2.0.0",
+  "description": "AI-driven specification platform using MCP (Model Context Protocol) for VS Code & GitHub Copilot",
+  "main": "dist/index.js",
+  "type": "module",
+  "bin": {
+    "spec-kit-mcp": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "workflows",
+    "templates",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc && npm run copy-assets",
+    "copy-assets": "node scripts/copy-assets.js",
+    "dev": "tsx watch src/index.ts",
+    "start": "node dist/index.js",
+    "setup": "tsx src/utils/vsCodeConfigGenerator.ts",
+    "test": "tsx src/index.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "copilot",
+    "github-copilot",
+    "azure-devops",
+    "specifications",
+    "documentation",
+    "ai",
+    "workflow",
+    "automation"
+  ],
+  "author": "",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/your-org/spec-kit-mcp.git"
+  },
+  "homepage": "https://github.com/your-org/spec-kit-mcp#readme",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.25.3",
+    "js-yaml": "^4.1.1",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^25.1.0",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3"
+  }
+}

package/templates/bugfix-report.md

@@ -0,0 +1,184 @@
+---
+title: "[TO FILL: Bug Title]"
+workitem_id: "[TO FILL]"
+type: Bug Fix Report
+version: "1.0"
+status: Draft
+author: "[TO FILL]"
+created: "[TO FILL: Date]"
+severity: "[TO FILL: Critical/High/Medium/Low]"
+azure_devops_link: "[TO FILL: Link to ADO Bug]"
+---
+
+# Bug Fix Report: [TO FILL: Bug Title]
+
+## 1. Bug Summary
+
+| Field | Value |
+|-------|-------|
+| **Bug ID** | [TO FILL] |
+| **Severity** | [TO FILL: Critical/High/Medium/Low] |
+| **Priority** | [TO FILL: P1/P2/P3/P4] |
+| **Reported By** | [TO FILL] |
+| **Reported Date** | [TO FILL] |
+| **Environment** | [TO FILL: Production/Staging/Dev] |
+| **Affected Version** | [TO FILL] |
+
+---
+
+## 2. Problem Description
+
+### 2.1 Expected Behavior
+
+[TO FILL: What should happen]
+
+### 2.2 Actual Behavior
+
+[TO FILL: What actually happens]
+
+### 2.3 Reproduction Steps
+
+1. [TO FILL: Step 1]
+2. [TO FILL: Step 2]
+3. [TO FILL: Step 3]
+4. [TO FILL: Observe error]
+
+### 2.4 Error Details
+
+```
+[TO FILL: Error message, stack trace, logs]
+```
+
+### 2.5 Screenshots/Evidence
+
+[TO FILL: Attach or link screenshots]
+
+---
+
+## 3. Impact Assessment
+
+### 3.1 User Impact
+
+| Aspect | Assessment |
+|--------|------------|
+| Users Affected | [TO FILL: All/Subset/Specific role] |
+| Frequency | [TO FILL: Always/Sometimes/Rare] |
+| Workaround Available | [TO FILL: Yes/No] |
+| Business Impact | [TO FILL: Description] |
+
+### 3.2 Affected Components
+
+- [ ] Frontend
+- [ ] Backend API
+- [ ] Database
+- [ ] External Service
+- [ ] Infrastructure
+
+Component details: [TO FILL]
+
+---
+
+## 4. Root Cause Analysis
+
+### 4.1 Investigation Summary
+
+[TO FILL: Summary of investigation steps taken]
+
+### 4.2 Root Cause
+
+[TO FILL: Identified root cause of the bug]
+
+### 4.3 Why It Wasn't Caught
+
+[TO FILL: Gap in testing/review that allowed this bug]
+
+---
+
+## 5. Fix Proposal
+
+### 5.1 Proposed Solution
+
+[TO FILL: Description of the fix]
+
+### 5.2 Files/Components to Modify
+
+| File/Component | Change Type | Description |
+|----------------|-------------|-------------|
+| [TO FILL] | Modify | [TO FILL] |
+| [TO FILL] | Add | [TO FILL] |
+
+### 5.3 Risk Assessment
+
+| Risk | Probability | Impact | Mitigation |
+|------|-------------|--------|------------|
+| Regression in X | [TO FILL] | [TO FILL] | [TO FILL] |
+
+### 5.4 Rollback Plan
+
+[TO FILL: How to rollback if the fix causes issues]
+
+---
+
+## 6. Validation Checklist
+
+### 6.1 Security Review
+
+- [ ] No new vulnerabilities introduced
+- [ ] Input validation maintained
+- [ ] No sensitive data exposure
+- [ ] Auth/Authz intact
+
+### 6.2 Testing
+
+- [ ] Unit test for bug scenario added
+- [ ] Regression tests pass
+- [ ] Manual testing completed
+- [ ] Edge cases covered
+
+### 6.3 Code Quality
+
+- [ ] Code review completed
+- [ ] No new technical debt
+- [ ] Follows coding standards
+- [ ] Documentation updated
+
+---
+
+## 7. Resolution
+
+### 7.1 Fix Implementation
+
+| Field | Value |
+|-------|-------|
+| **Fix Branch** | [TO FILL] |
+| **PR Link** | [TO FILL] |
+| **Deployed To** | [TO FILL] |
+| **Deployed Date** | [TO FILL] |
+| **Verified By** | [TO FILL] |
+
+### 7.2 Lessons Learned
+
+[TO FILL: What can be improved to prevent similar bugs]
+
+### 7.3 Follow-up Actions
+
+- [ ] [TO FILL: Action item 1]
+- [ ] [TO FILL: Action item 2]
+
+---
+
+## 8. Approval
+
+| Role | Name | Date | Status |
+|------|------|------|--------|
+| Developer | [TO FILL] | | ☐ Completed |
+| Code Reviewer | [TO FILL] | | ☐ Approved |
+| QA | [TO FILL] | | ☐ Verified |
+
+---
+
+## Revision History
+
+| Version | Date | Author | Changes |
+|---------|------|--------|---------|
+| 1.0 | [TO FILL] | [TO FILL] | Initial report |