smart-spec-kit-mcp 2.2.9 → 2.3.1

package/dist/utils/stackDetector.test.js

@@ -0,0 +1,93 @@
+/**
+ * Tests for stack detection and constitution update.
+ */
+import { test } from "node:test";
+import assert from "node:assert/strict";
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import * as os from "node:os";
+import { detectStack } from "./stackDetector.js";
+import { updateConstitution } from "./constitutionUpdater.js";
+async function createTempProject() {
+    const dir = await fs.mkdtemp(path.join(os.tmpdir(), "spec-kit-test-"));
+    return dir;
+}
+test("detectStack infers TypeScript + React + Jest + PostgreSQL", async () => {
+    const projectPath = await createTempProject();
+    await fs.writeFile(path.join(projectPath, "package.json"), JSON.stringify({
+        name: "demo-app",
+        dependencies: {
+            react: "18.0.0",
+            pg: "8.0.0",
+        },
+        devDependencies: {
+            typescript: "5.0.0",
+            jest: "29.0.0",
+        },
+    }, null, 2), "utf-8");
+    await fs.writeFile(path.join(projectPath, "tsconfig.json"), "{}", "utf-8");
+    const detection = await detectStack(projectPath);
+    assert.equal(detection.projectName, "demo-app");
+    assert.equal(detection.language, "TypeScript");
+    assert.equal(detection.framework, "React");
+    assert.equal(detection.testing, "Jest");
+    assert.equal(detection.database, "PostgreSQL");
+});
+test("updateConstitution fills tech stack placeholders", async () => {
+    const projectPath = await createTempProject();
+    const memoryDir = path.join(projectPath, ".spec-kit", "memory");
+    await fs.mkdir(memoryDir, { recursive: true });
+    const constitutionTemplate = `# Project Constitution
+
+## Project Information
+
+- **Project Name**: [TO FILL: Your project name]
+- **Ratification Date**: [TO FILL: YYYY-MM-DD]
+- **Last Amended**: [TO FILL: YYYY-MM-DD]
+- **Version**: 1.0.0
+
+---
+
+## Tech Stack Guidelines
+
+### Preferred Technologies
+| Category | Technology | Notes |
+|----------|------------|-------|
+| Language | [TO FILL] | |
+| Framework | [TO FILL] | |
+| Database | [TO FILL] | |
+| Testing | [TO FILL] | |
+
+### Code Style
+- [TO FILL: Link to style guide or describe key conventions]
+
+---
+
+## Version History
+
+| Version | Date | Changes |
+|---------|------|---------|
+| 1.0.0 | [TO FILL] | Initial constitution |
+`;
+    const constitutionPath = path.join(memoryDir, "constitution.md");
+    await fs.writeFile(constitutionPath, constitutionTemplate, "utf-8");
+    const update = await updateConstitution(projectPath, {
+        language: "TypeScript",
+        framework: "React",
+        database: "PostgreSQL",
+        testing: "Vitest",
+        evidence: [],
+    }, {
+        projectName: "SpecKit Demo",
+        codeStyle: "ESLint + Prettier",
+    });
+    assert.equal(update.updated, true);
+    const updated = await fs.readFile(constitutionPath, "utf-8");
+    assert.match(updated, /\*\*Project Name\*\*: SpecKit Demo/);
+    assert.match(updated, /\| Language \|\s*TypeScript\s*\|/);
+    assert.match(updated, /\| Framework \|\s*React\s*\|/);
+    assert.match(updated, /\| Database \|\s*PostgreSQL\s*\|/);
+    assert.match(updated, /\| Testing \|\s*Vitest\s*\|/);
+    assert.match(updated, /- ESLint \+ Prettier/);
+});
+//# sourceMappingURL=stackDetector.test.js.map

package/dist/utils/stackDetector.test.js.map

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

package/dist/utils/workflowLoader.d.ts

@@ -51,7 +51,11 @@ export declare function getWorkflowStep(workflow: Workflow, stepId: string): {
     action: "fetch_ado" | "generate_content" | "review" | "create_file" | "call_agent";
     description: string;
     agent?: string | undefined;
-    inputs?: Record<string, string> | undefined;
+    inputs?: Record<string, string | string[]> | {
+        name: string;
+        description?: string | undefined;
+        required?: boolean | undefined;
+    }[] | undefined;
     outputs?: string[] | undefined;
     next?: string | undefined;
 } | undefined;
@@ -64,7 +68,11 @@ export declare function getFirstStep(workflow: Workflow): {
     action: "fetch_ado" | "generate_content" | "review" | "create_file" | "call_agent";
     description: string;
     agent?: string | undefined;
-    inputs?: Record<string, string> | undefined;
+    inputs?: Record<string, string | string[]> | {
+        name: string;
+        description?: string | undefined;
+        required?: boolean | undefined;
+    }[] | undefined;
     outputs?: string[] | undefined;
     next?: string | undefined;
 } | undefined;
@@ -77,7 +85,11 @@ export declare function getNextStep(workflow: Workflow, currentStepId: string):
     action: "fetch_ado" | "generate_content" | "review" | "create_file" | "call_agent";
     description: string;
     agent?: string | undefined;
-    inputs?: Record<string, string> | undefined;
+    inputs?: Record<string, string | string[]> | {
+        name: string;
+        description?: string | undefined;
+        required?: boolean | undefined;
+    }[] | undefined;
     outputs?: string[] | undefined;
     next?: string | undefined;
 } | null | undefined;

package/dist/utils/workflowLoader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workflowLoader.d.ts","sourceRoot":"","sources":["../../src/utils/workflowLoader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAG7E,YAAY,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAmH7D;;GAEG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAGvD;AAED;;GAEG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CACpD;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,GAAG,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,CAC9D,CAEA;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CA8B1E;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAaxE;AAED;;GAEG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAGvD;AAED;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC;IAAE,QAAQ,EAAE,QAAQ,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAKnD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM;;;;;;;;;cAEjE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,QAAQ;;;;;;;;;cAE9C;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM;;;;;;;;;qBAepE;AAED;;GAEG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAiErD;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE;QAAE,SAAS,EAAE,MAAM,EAAE,CAAC;QAAC,SAAS,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;CAC3D,CASA"}
+{"version":3,"file":"workflowLoader.d.ts","sourceRoot":"","sources":["../../src/utils/workflowLoader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAG7E,YAAY,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAmH7D;;GAEG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAGvD;AAED;;GAEG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CACpD;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,GAAG,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,CAC9D,CAEA;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CA8B1E;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAaxE;AAED;;GAEG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAGvD;AAED;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC;IAAE,QAAQ,EAAE,QAAQ,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAKnD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM;;;;;;;;;;;;;cAEjE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,QAAQ;;;;;;;;;;;;;cAE9C;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM;;;;;;;;;;;;;qBAepE;AAED;;GAEG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAiErD;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE;QAAE,SAAS,EAAE,MAAM,EAAE,CAAC;QAAC,SAAS,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;CAC3D,CASA"}

package/docs/DOCUMENTATION.md

@@ -52,6 +52,41 @@ Spec-Kit is an MCP (Model Context Protocol) server that provides **customizable
 
 > **Note**: All parameters are optional. Spec-Kit is designed to be conversational - if you don't provide information upfront, Copilot will ask for it.
 
+### init
+
+**Purpose**: Initialize Spec-Kit in the current project. If `guided` is not specified, Spec-Kit asks you to choose guided vs auto. Guided mode is interactive (Q/A). Auto mode fills the constitution from project detection.
+
+**Keyword Triggers**: `speckit: init`, `init`
+
+**Parameters** (all optional):
+
+- `force`: Overwrite existing Spec-Kit files
+- `guided`: Enable guided setup (detect stack and fill constitution)
+- `session_id`: Session ID for guided mode
+- `answer`: Answer for the current guided question
+- `cancel`: Cancel guided session
+- `answers`: Overrides for constitution fields
+  - `projectName`, `ratificationDate`, `lastAmended`
+  - `language`, `framework`, `database`, `testing`, `codeStyle`
+  - `approvers`
+
+**Examples**:
+
+```text
+speckit: init
+speckit: init guided=true
+speckit: init guided=true answer="My Project"
+speckit: init guided=true session_id=init-abc answer="auto"
+speckit: init guided=true answers={"projectName":"Demo","language":"TypeScript","framework":"React"}
+```
+
+**Behavior**:
+
+1. Installs prompts, templates, memory, rules, agents, and specs folders
+2. If `guided` is enabled, detects the stack from project files
+3. Updates `.spec-kit/memory/constitution.md` with detected or provided values
+4. Lists any remaining placeholders to fill
+
 ### speckit_specify
 
 **Purpose**: Create a functional specification from requirements.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "smart-spec-kit-mcp",
-  "version": "2.2.9",
+  "version": "2.3.1",
   "description": "AI-driven specification platform using MCP (Model Context Protocol) for VS Code & GitHub Copilot",
   "main": "dist/index.js",
   "type": "module",
@@ -25,7 +25,7 @@
     "dev": "tsx watch src/index.ts",
     "start": "node dist/index.js",
     "setup": "tsx src/utils/vsCodeConfigGenerator.ts",
-    "test": "tsx src/index.ts",
+    "test": "npm run build && node --test dist/**/*.test.js",
     "prepublishOnly": "npm run build"
   },
   "keywords": [

package/starter-kit/workflows/bugfix.yaml

@@ -1,12 +1,12 @@
 # Bugfix Workflow
-# Streamlined process for bug fixes with validation checkpoints
+# Structured process for bug fixes
 
 name: bugfix
 displayName: "Bug Fix"
 description: "Structured workflow for analyzing, fixing, and validating bug corrections"
 
 metadata:
-  version: "1.0"
+  version: "2.0"
   author: "Spec-Kit"
   tags:
     - bugfix
@@ -17,31 +17,37 @@ template: bugfix-report.md
 defaultAgent: SpecAgent
 
 steps:
+  # Step 1: Analyze Bug
   - id: analyze-bug
-    name: "Analyze Bug & Root Cause"
-    action: fetch_ado
+    name: "1. Analyze Bug"
+    action: call_agent
+    agent: SpecAgent
     description: |
-      Retrieve the bug work item from Azure DevOps and analyze:
-      - Reproduction steps
-      - Error logs and stack traces
-      - Affected components
-      - User impact assessment
+      Analyze the bug based on user description:
+      
+      - Understand the symptoms
+      - Identify reproduction steps
+      - Locate affected components
+      - Determine root cause
       
-      Identify the root cause of the issue.
+      Document findings clearly.
+    inputs:
+      bug_description: "Description from user"
     outputs:
-      - bug_data
       - root_cause_analysis
 
+  # Step 2: Plan Fix
   - id: plan-fix
-    name: "Plan Correction"
+    name: "2. Plan Correction"
     action: call_agent
     agent: PlanAgent
     description: |
-      Create a correction plan including:
+      Create a correction plan:
+      
       - Proposed fix approach
       - Files/components to modify
       - Potential side effects
-      - Rollback strategy if needed
+      - Test cases to verify fix
       
       Keep the fix minimal and focused.
     inputs:
@@ -49,51 +55,36 @@ steps:
     outputs:
       - fix_plan
 
-  - id: security-check
-    name: "Security Validation"
-    action: review
-    agent: GovAgent
-    description: |
-      Quick security review of the proposed fix:
-      - [ ] No new vulnerabilities introduced
-      - [ ] Input validation maintained
-      - [ ] No sensitive data exposure
-      - [ ] Authentication/Authorization intact
-    inputs:
-      document: "fix_plan"
-    outputs:
-      - security_clearance
-
+  # Step 3: Implement Fix
   - id: implement-fix
-    name: "Implement & Test"
-    action: generate_content
+    name: "3. Implement Fix"
+    action: call_agent
+    agent: SpecAgent
     description: |
-      Implement the fix following the plan:
-      1. Write the code fix
-      2. Add unit tests for the bug scenario
-      3. Add regression tests
-      4. Update documentation if needed
+      Implement the bug fix:
       
-      Ensure test coverage for the fixed code path.
+      - Make minimal changes
+      - Follow project conventions
+      - Add/update tests
+      - Document the fix
     inputs:
-      plan: "fix_plan"
+      source: "fix_plan"
     outputs:
-      - code_changes
-      - test_cases
+      - implementation
 
-  - id: final-review
-    name: "Final Review"
+  # Step 4: Verify
+  - id: verify-fix
+    name: "4. Verify Fix"
     action: review
     agent: GovAgent
     description: |
-      Final validation before merge:
-      - [ ] Fix addresses root cause
-      - [ ] No regression introduced
+      Verify the fix is complete:
+      
+      - [ ] Bug is resolved
+      - [ ] No regressions introduced
       - [ ] Tests pass
-      - [ ] Code review approved
-      - [ ] Documentation updated
+      - [ ] No security issues
     inputs:
-      changes: "code_changes"
-      tests: "test_cases"
+      source: "implementation"
     outputs:
-      - approval_status
+      - verification_report