specky-sdd 1.0.0

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 Paula Silva (@paulasilvatech, @paulanunes85)
+Americas Software GBB
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,446 @@
+# Specky
+
+**The open-source MCP server for Spec-Driven Development (SDD).**
+
+*The fun name, the serious engine.*
+
+![Version](https://img.shields.io/badge/version-1.0.0-blue.svg)
+![License](https://img.shields.io/badge/license-MIT-green.svg)
+![Node](https://img.shields.io/badge/node-%3E%3D18-brightgreen.svg)
+![MCP](https://img.shields.io/badge/MCP-compatible-purple.svg)
+![Tools](https://img.shields.io/badge/MCP_tools-17-orange.svg)
+
+**Created by [Paula Silva](https://github.com/paulasilvatech)** ([@paulanunes85](https://twitter.com/paulanunes85)) | Americas Software GBB
+
+---
+
+## What is Specky?
+
+Specky is an **MCP server** that transforms natural language project ideas — or meeting transcripts — into production-grade specifications. It enforces **EARS notation** (Easy Approach to Requirements Syntax), maintains a **state machine** across 7 pipeline phases, and writes real files to disk.
+
+```
+You ──→ AI Assistant ──→ Specky (17 tools) ──→ .specs/ files on disk
+        (Copilot/Claude)                       CONSTITUTION.md
+                                               SPECIFICATION.md
+                                               DESIGN.md
+                                               TASKS.md
+                                               ANALYSIS.md
+```
+
+### What is MCP?
+
+**MCP (Model Context Protocol)** is an open standard that lets AI assistants call external tools. Think of it like USB — a universal plug between any AI and any tool. Specky is a "device" that speaks MCP, giving Copilot and Claude the ability to create structured specification files.
+
+### Key Features
+
+- **17 MCP tools** for the full specification lifecycle
+- **EARS notation** validation with 6 pattern types and improvement suggestions
+- **7-phase pipeline** with state machine enforcement
+- **Meeting transcript → full spec** — VTT, SRT, TXT, MD formats
+- **Power Automate + OneDrive** integration for automated workflows
+- **Quality gates** with traceability matrix and coverage analysis
+- **Atomic file writes** — safe, no corruption on crash
+- **Auto-steering** — scans your codebase to tailor discovery questions
+- **Zero external dependencies** — runs entirely local, no API calls
+- **GitHub Copilot agents** + **Claude Code commands** included
+
+### Two Ways to Use
+
+| Mode | How | Best For |
+|------|-----|----------|
+| **Interactive** | Conversation with AI, step by step | New projects, learning SDD |
+| **Transcript** | Feed a meeting recording, get full spec | Existing meetings, automation |
+
+---
+
+## Quick Start
+
+### npx (recommended)
+
+```bash
+npx specky
+```
+
+### npm global install
+
+```bash
+npm install -g specky
+specky
+```
+
+### Docker
+
+```bash
+docker compose up
+# Server starts on http://localhost:3200
+```
+
+---
+
+## Setup
+
+### VS Code (GitHub Copilot)
+
+Create or update `.vscode/mcp.json`:
+
+```json
+{
+  "servers": {
+    "specky": {
+      "command": "npx",
+      "args": ["-y", "specky"],
+      "env": {
+        "SDD_WORKSPACE": "${workspaceFolder}"
+      }
+    }
+  }
+}
+```
+
+### Claude Code
+
+```bash
+# Quick setup (one command):
+claude mcp add specky npx -y specky --env SDD_WORKSPACE=$(pwd)
+```
+
+Or manually add to MCP settings:
+
+```json
+{
+  "mcpServers": {
+    "specky": {
+      "command": "npx",
+      "args": ["-y", "specky"],
+      "env": {
+        "SDD_WORKSPACE": "/path/to/your/project"
+      }
+    }
+  }
+}
+```
+
+### Claude Desktop
+
+Add to `claude_desktop_config.json`:
+
+| OS | Config File Location |
+|----|---------------------|
+| macOS | `~/Library/Application Support/Claude/claude_desktop_config.json` |
+| Linux | `~/.config/Claude/claude_desktop_config.json` |
+| Windows | `%APPDATA%\Claude\claude_desktop_config.json` |
+
+```json
+{
+  "mcpServers": {
+    "specky": {
+      "command": "npx",
+      "args": ["-y", "specky"],
+      "env": {
+        "SDD_WORKSPACE": "/path/to/your/project"
+      }
+    }
+  }
+}
+```
+
+---
+
+## Meeting Transcript to Specs (Auto Pipeline)
+
+**One command. Full specification from a Teams/Zoom meeting.**
+
+```
+/sdd:transcript meeting.vtt my-project
+```
+
+Or call the tool directly:
+
+```json
+{
+  "name": "sdd_auto_pipeline",
+  "arguments": {
+    "file_path": "meeting.vtt",
+    "project_name": "my-project"
+  }
+}
+```
+
+**What happens automatically:**
+
+1. Parses the VTT/SRT/TXT/MD transcript
+2. Extracts participants, topics, decisions, action items
+3. Generates EARS requirements from meeting content
+4. Creates all 6 spec files in one call:
+
+| File | Content |
+|------|---------|
+| `CONSTITUTION.md` | Project charter with principles from the meeting |
+| `SPECIFICATION.md` | EARS requirements extracted from decisions and discussions |
+| `DESIGN.md` | Architecture overview based on topics discussed |
+| `TASKS.md` | Implementation tasks from requirements + action items |
+| `ANALYSIS.md` | Traceability matrix and quality gate |
+| `TRANSCRIPT.md` | Clean markdown version of the meeting |
+
+**Supported formats:**
+
+| Format | Source | Extension |
+|--------|--------|-----------|
+| WebVTT | Microsoft Teams | `.vtt` |
+| SubRip | Zoom | `.srt` |
+| Plain text | Otter.ai, manual notes | `.txt` |
+| Markdown | Any structured notes | `.md` |
+
+### Power Automate + OneDrive Integration
+
+For fully automated meeting-to-spec workflows:
+
+```
+Teams Meeting → Power Automate → OneDrive/Transcripts/ → sdd_batch_transcripts → .specs/
+```
+
+**Power Automate flow:**
+1. Trigger: "When a Teams meeting recording is available"
+2. Action: Get the meeting transcript
+3. Action: Convert to Markdown
+4. Action: Save to `OneDrive/Transcripts/{meeting-title}.md`
+
+**Specky picks up from there:**
+
+```json
+{
+  "name": "sdd_batch_transcripts",
+  "arguments": {
+    "transcripts_dir": "~/OneDrive/Transcripts"
+  }
+}
+```
+
+Each transcript in the folder becomes its own numbered feature spec package (`001-sprint-planning/`, `002-architecture-review/`, etc.) with 6 files each.
+
+---
+
+## Pipeline Overview
+
+```
+sdd_init → sdd_discover → sdd_write_spec → sdd_clarify → sdd_write_design → sdd_write_tasks → sdd_run_analysis
+```
+
+Each phase produces a Markdown artifact in `.specs/001-your-feature/`:
+
+| Phase | Tool | Output |
+|-------|------|--------|
+| Init | `sdd_init` | `CONSTITUTION.md` |
+| Discover | `sdd_discover` | 7 structured questions (JSON) |
+| Specify | `sdd_write_spec` | `SPECIFICATION.md` |
+| Clarify | `sdd_clarify` | 5 disambiguation questions (JSON) |
+| Design | `sdd_write_design` | `DESIGN.md` |
+| Tasks | `sdd_write_tasks` | `TASKS.md` |
+| Analyze | `sdd_run_analysis` | `ANALYSIS.md` + gate decision |
+
+---
+
+## Tool Reference
+
+### Pipeline Tools (8)
+
+| Tool | Description | R/W |
+|------|-------------|-----|
+| `sdd_init` | Creates `.specs/` directory, writes CONSTITUTION.md, initializes state machine | Write |
+| `sdd_discover` | Returns 7 tailored discovery questions based on your project idea | Read |
+| `sdd_write_spec` | Validates EARS notation and writes SPECIFICATION.md | Write |
+| `sdd_clarify` | Identifies ambiguous requirements, returns disambiguation questions | Read |
+| `sdd_write_design` | Writes DESIGN.md with Mermaid diagrams, ADRs, and API contracts | Write |
+| `sdd_write_tasks` | Writes TASKS.md with gates, parallel markers, and traceability | Write |
+| `sdd_run_analysis` | Generates traceability matrix, returns APPROVE/CHANGES_NEEDED/BLOCK | Write |
+| `sdd_advance_phase` | Validates prerequisites and advances the state machine | Write |
+
+### Utility Tools (6)
+
+| Tool | Description | R/W |
+|------|-------------|-----|
+| `sdd_get_status` | Returns current phase, completion %, files on disk, next action | Read |
+| `sdd_get_template` | Returns raw template with {{placeholders}} intact | Read |
+| `sdd_write_bugfix` | Writes BUGFIX_SPEC.md (not gated by state machine) | Write |
+| `sdd_check_sync` | Compares spec requirements vs code references, reports drift | Read |
+| `sdd_scan_codebase` | Scans project structure, detects tech stack for auto-steering | Read |
+| `sdd_amend` | Appends amendment to CONSTITUTION.md changelog | Write |
+
+### Transcript Automation Tools (3)
+
+| Tool | Description | R/W |
+|------|-------------|-----|
+| `sdd_import_transcript` | Parses VTT/SRT/TXT/MD, extracts topics, decisions, requirements | Read |
+| `sdd_auto_pipeline` | FULL AUTOMATION: transcript → all 6 spec files in one call | Write |
+| `sdd_batch_transcripts` | Scan folder for transcripts, process ALL in one call (Power Automate + OneDrive) | Write |
+
+---
+
+## EARS Notation
+
+Specky validates all requirements against 6 EARS patterns:
+
+| Pattern | Syntax | Example |
+|---------|--------|---------|
+| Ubiquitous | The system shall ... | The system shall log all API requests. |
+| Event-driven | When X, the system shall ... | When a user logs in, the system shall create a session. |
+| State-driven | While X, the system shall ... | While in maintenance mode, the system shall reject writes. |
+| Optional | Where X, the system shall ... | Where dark mode is enabled, the system shall use dark theme. |
+| Unwanted | If X, then the system shall ... | If the database is unreachable, then the system shall retry. |
+| Complex | Combination of above | While online, when a message arrives, the system shall notify. |
+
+---
+
+## GitHub Copilot Agents
+
+Specky ships with 4 GitHub Copilot custom agents in `.github/agents/`:
+
+| Agent | Role | Tools |
+|-------|------|-------|
+| `@spec-engineer` | Full pipeline orchestrator | All 17 tools |
+| `@design-architect` | Architecture and design | 7 design tools |
+| `@task-planner` | Task decomposition | 5 task tools |
+| `@spec-reviewer` | Quality audit and analysis | 7 analysis tools |
+
+---
+
+## Claude Code Commands
+
+| Command | Purpose |
+|---------|---------|
+| `/sdd:spec` | Start specification workflow |
+| `/sdd:design` | Create architecture design |
+| `/sdd:tasks` | Break down into implementation tasks |
+| `/sdd:analyze` | Run quality gate analysis |
+| `/sdd:bugfix` | Create bugfix specification |
+| `/sdd:transcript` | Convert meeting transcript to full spec (VTT/SRT/TXT/MD) |
+| `/sdd:onedrive` | Batch process all transcripts from OneDrive folder |
+
+---
+
+## Environment Variables
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `SDD_WORKSPACE` | `process.cwd()` | Workspace root for file operations |
+| `PORT` | `3200` | HTTP port (with `--http` flag) |
+
+---
+
+## HTTP Mode
+
+For remote deployment or MCP Inspector testing:
+
+```bash
+# Direct
+node dist/index.js --http
+
+# Docker
+docker compose up
+```
+
+The server listens on `http://localhost:3200/mcp` for Streamable HTTP transport.
+
+---
+
+## Project Structure
+
+```
+.specs/
+  001-your-feature/
+    CONSTITUTION.md      # Project charter, principles, constraints
+    SPECIFICATION.md     # EARS requirements with acceptance criteria
+    DESIGN.md            # Architecture, Mermaid diagrams, ADRs
+    TASKS.md             # Implementation tasks with gates
+    ANALYSIS.md          # Traceability matrix, quality gate
+  .sdd-state.json        # Pipeline state (phase, timestamps)
+```
+
+---
+
+## Comparison with Alternatives
+
+| Feature | Specky | Manual Specs | Kiro | Traditional |
+|---------|--------|-------------|------|-------------|
+| MCP native | Yes | No | Yes | No |
+| EARS notation | Yes | Manual | No | No |
+| State machine | Yes | No | Yes | No |
+| File generation | Yes | Manual | Yes | Manual |
+| Quality gates | Yes | Manual | Yes | No |
+| Open source | MIT | N/A | Proprietary | Varies |
+| GitHub Copilot agents | Yes | No | No | No |
+| Claude Code commands | Yes | No | No | No |
+
+---
+
+## How It Works Inside
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                    SPECKY MCP SERVER                        │
+│                                                             │
+│  Transport: stdio (default) or HTTP (:3200)                 │
+│  Protocol:  JSON-RPC 2.0 (MCP standard)                    │
+│                                                             │
+│  ┌─── 17 Tools ───────────────────────────────────────────┐ │
+│  │  Pipeline (8)  │  Utility (6)  │  Transcript (3)       │ │
+│  └────────────────┴───────────────┴───────────────────────┘ │
+│                          │                                  │
+│  ┌─── 6 Services ────────────────────────────────────────┐  │
+│  │  FileManager       │ StateMachine   │ TemplateEngine   │  │
+│  │  EarsValidator     │ CodebaseScanner│ TranscriptParser  │  │
+│  └────────────────────┴────────────────┴─────────────────┘  │
+│                          │                                  │
+│  ┌─── 7 Templates ──────────────────────────────────────┐   │
+│  │  constitution │ specification │ design │ tasks        │   │
+│  │  analysis     │ bugfix        │ sync-report           │   │
+│  └───────────────┴───────────────┴───────────────────────┘  │
+└─────────────────────────────────────────────────────────────┘
+```
+
+**Key design principle:** Tools are thin (validate input, call service, format output). Services are fat (all business logic). FileManager owns all disk I/O.
+
+---
+
+## Documentation
+
+| Document | Purpose |
+|----------|---------|
+| [GETTING-STARTED.md](GETTING-STARTED.md) | Step-by-step tutorial from zero to first spec |
+| [CONTRIBUTING.md](CONTRIBUTING.md) | How to add tools, templates, and services |
+| [PUBLISH.md](PUBLISH.md) | How to publish to GitHub, npm, and Docker |
+
+---
+
+## Development
+
+```bash
+# Clone and setup
+git clone https://github.com/paulasilvatech/specky.git
+cd specky
+npm install
+
+# Build
+npm run build
+
+# Development mode (auto-reload)
+npm run dev
+
+# Verify MCP handshake
+echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}' | node dist/index.js 2>/dev/null
+
+# Clean build artifacts
+npm run clean
+```
+
+---
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.
+
+---
+
+**Created by [Paula Silva](https://github.com/paulasilvatech)** ([@paulanunes85](https://twitter.com/paulanunes85)) | Americas Software GBB
+
+*Specky — The fun name, the serious engine.*

package/dist/constants.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Specky MCP Server — Constants
+ * All shared constants, enums, and configuration values.
+ */
+/** Specky server version — matches package.json */
+export declare const VERSION = "1.0.0";
+/** Server name for MCP handshake */
+export declare const SERVER_NAME = "specky";
+/** Maximum response size in characters before truncation */
+export declare const CHARACTER_LIMIT = 25000;
+/** Default directory for SDD specifications */
+export declare const DEFAULT_SPEC_DIR = ".specs";
+/** State file name */
+export declare const STATE_FILE = ".sdd-state.json";
+/** Default HTTP port for Streamable HTTP transport */
+export declare const DEFAULT_HTTP_PORT = 3200;
+/** Default scan depth for codebase scanner */
+export declare const DEFAULT_SCAN_DEPTH = 3;
+/** Maximum scan depth allowed */
+export declare const MAX_SCAN_DEPTH = 5;
+/** Default exclude patterns for codebase scanning */
+export declare const DEFAULT_EXCLUDE_PATTERNS: readonly string[];
+/**
+ * SDD Pipeline phases in order.
+ * Each phase requires its predecessor to be completed.
+ */
+export declare enum Phase {
+    Init = "init",
+    Discover = "discover",
+    Specify = "specify",
+    Clarify = "clarify",
+    Design = "design",
+    Tasks = "tasks",
+    Analyze = "analyze"
+}
+/** Ordered array of all phases for iteration */
+export declare const PHASE_ORDER: readonly Phase[];
+/** Maps each phase to the required file(s) that must exist before advancing past it */
+export declare const PHASE_REQUIRED_FILES: Record<Phase, readonly string[]>;
+/** All MCP tool names — prefixed with sdd_ */
+export declare const TOOL_NAMES: {
+    readonly INIT: "sdd_init";
+    readonly DISCOVER: "sdd_discover";
+    readonly WRITE_SPEC: "sdd_write_spec";
+    readonly CLARIFY: "sdd_clarify";
+    readonly WRITE_DESIGN: "sdd_write_design";
+    readonly WRITE_TASKS: "sdd_write_tasks";
+    readonly RUN_ANALYSIS: "sdd_run_analysis";
+    readonly ADVANCE_PHASE: "sdd_advance_phase";
+    readonly GET_STATUS: "sdd_get_status";
+    readonly GET_TEMPLATE: "sdd_get_template";
+    readonly WRITE_BUGFIX: "sdd_write_bugfix";
+    readonly CHECK_SYNC: "sdd_check_sync";
+    readonly SCAN_CODEBASE: "sdd_scan_codebase";
+    readonly AMEND: "sdd_amend";
+    readonly IMPORT_TRANSCRIPT: "sdd_import_transcript";
+    readonly AUTO_PIPELINE: "sdd_auto_pipeline";
+    readonly BATCH_TRANSCRIPTS: "sdd_batch_transcripts";
+};
+/** Template names matching files in templates/ directory */
+export declare const TEMPLATE_NAMES: readonly ["constitution", "specification", "design", "tasks", "analysis", "bugfix", "sync_report"];
+export type TemplateName = (typeof TEMPLATE_NAMES)[number];
+/** EARS pattern names */
+export declare const EARS_PATTERNS: readonly ["ubiquitous", "event_driven", "state_driven", "optional", "unwanted", "complex", "unknown"];
+export type EarsPatternName = (typeof EARS_PATTERNS)[number];
+/** Package manifest files for tech stack detection, in priority order */
+export declare const PACKAGE_MANIFESTS: readonly string[];
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,mDAAmD;AACnD,eAAO,MAAM,OAAO,UAAU,CAAC;AAE/B,oCAAoC;AACpC,eAAO,MAAM,WAAW,WAAW,CAAC;AAEpC,4DAA4D;AAC5D,eAAO,MAAM,eAAe,QAAS,CAAC;AAEtC,+CAA+C;AAC/C,eAAO,MAAM,gBAAgB,WAAW,CAAC;AAEzC,sBAAsB;AACtB,eAAO,MAAM,UAAU,oBAAoB,CAAC;AAE5C,sDAAsD;AACtD,eAAO,MAAM,iBAAiB,OAAO,CAAC;AAEtC,8CAA8C;AAC9C,eAAO,MAAM,kBAAkB,IAAI,CAAC;AAEpC,iCAAiC;AACjC,eAAO,MAAM,cAAc,IAAI,CAAC;AAEhC,qDAAqD;AACrD,eAAO,MAAM,wBAAwB,EAAE,SAAS,MAAM,EAUrD,CAAC;AAEF;;;GAGG;AACH,oBAAY,KAAK;IACf,IAAI,SAAS;IACb,QAAQ,aAAa;IACrB,OAAO,YAAY;IACnB,OAAO,YAAY;IACnB,MAAM,WAAW;IACjB,KAAK,UAAU;IACf,OAAO,YAAY;CACpB;AAED,gDAAgD;AAChD,eAAO,MAAM,WAAW,EAAE,SAAS,KAAK,EAQvC,CAAC;AAEF,uFAAuF;AACvF,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAQjE,CAAC;AAEF,8CAA8C;AAC9C,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;CAqBb,CAAC;AAEX,4DAA4D;AAC5D,eAAO,MAAM,cAAc,oGAQjB,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3D,yBAAyB;AACzB,eAAO,MAAM,aAAa,uGAQhB,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7D,yEAAyE;AACzE,eAAO,MAAM,iBAAiB,EAAE,SAAS,MAAM,EAQ9C,CAAC"}

package/dist/constants.js

@@ -0,0 +1,120 @@
+/**
+ * Specky MCP Server — Constants
+ * All shared constants, enums, and configuration values.
+ */
+/** Specky server version — matches package.json */
+export const VERSION = "1.0.0";
+/** Server name for MCP handshake */
+export const SERVER_NAME = "specky";
+/** Maximum response size in characters before truncation */
+export const CHARACTER_LIMIT = 25_000;
+/** Default directory for SDD specifications */
+export const DEFAULT_SPEC_DIR = ".specs";
+/** State file name */
+export const STATE_FILE = ".sdd-state.json";
+/** Default HTTP port for Streamable HTTP transport */
+export const DEFAULT_HTTP_PORT = 3200;
+/** Default scan depth for codebase scanner */
+export const DEFAULT_SCAN_DEPTH = 3;
+/** Maximum scan depth allowed */
+export const MAX_SCAN_DEPTH = 5;
+/** Default exclude patterns for codebase scanning */
+export const DEFAULT_EXCLUDE_PATTERNS = [
+    "node_modules",
+    ".git",
+    "dist",
+    ".next",
+    "__pycache__",
+    ".venv",
+    "target",
+    "build",
+    "coverage",
+];
+/**
+ * SDD Pipeline phases in order.
+ * Each phase requires its predecessor to be completed.
+ */
+export var Phase;
+(function (Phase) {
+    Phase["Init"] = "init";
+    Phase["Discover"] = "discover";
+    Phase["Specify"] = "specify";
+    Phase["Clarify"] = "clarify";
+    Phase["Design"] = "design";
+    Phase["Tasks"] = "tasks";
+    Phase["Analyze"] = "analyze";
+})(Phase || (Phase = {}));
+/** Ordered array of all phases for iteration */
+export const PHASE_ORDER = [
+    Phase.Init,
+    Phase.Discover,
+    Phase.Specify,
+    Phase.Clarify,
+    Phase.Design,
+    Phase.Tasks,
+    Phase.Analyze,
+];
+/** Maps each phase to the required file(s) that must exist before advancing past it */
+export const PHASE_REQUIRED_FILES = {
+    [Phase.Init]: ["CONSTITUTION.md"],
+    [Phase.Discover]: [],
+    [Phase.Specify]: ["SPECIFICATION.md"],
+    [Phase.Clarify]: ["SPECIFICATION.md"],
+    [Phase.Design]: ["DESIGN.md"],
+    [Phase.Tasks]: ["TASKS.md"],
+    [Phase.Analyze]: ["ANALYSIS.md"],
+};
+/** All MCP tool names — prefixed with sdd_ */
+export const TOOL_NAMES = {
+    // Pipeline tools
+    INIT: "sdd_init",
+    DISCOVER: "sdd_discover",
+    WRITE_SPEC: "sdd_write_spec",
+    CLARIFY: "sdd_clarify",
+    WRITE_DESIGN: "sdd_write_design",
+    WRITE_TASKS: "sdd_write_tasks",
+    RUN_ANALYSIS: "sdd_run_analysis",
+    ADVANCE_PHASE: "sdd_advance_phase",
+    // Utility tools
+    GET_STATUS: "sdd_get_status",
+    GET_TEMPLATE: "sdd_get_template",
+    WRITE_BUGFIX: "sdd_write_bugfix",
+    CHECK_SYNC: "sdd_check_sync",
+    SCAN_CODEBASE: "sdd_scan_codebase",
+    AMEND: "sdd_amend",
+    // Transcript automation tools
+    IMPORT_TRANSCRIPT: "sdd_import_transcript",
+    AUTO_PIPELINE: "sdd_auto_pipeline",
+    BATCH_TRANSCRIPTS: "sdd_batch_transcripts",
+};
+/** Template names matching files in templates/ directory */
+export const TEMPLATE_NAMES = [
+    "constitution",
+    "specification",
+    "design",
+    "tasks",
+    "analysis",
+    "bugfix",
+    "sync_report",
+];
+/** EARS pattern names */
+export const EARS_PATTERNS = [
+    "ubiquitous",
+    "event_driven",
+    "state_driven",
+    "optional",
+    "unwanted",
+    "complex",
+    "unknown",
+];
+/** Package manifest files for tech stack detection, in priority order */
+export const PACKAGE_MANIFESTS = [
+    "package.json",
+    "requirements.txt",
+    "pyproject.toml",
+    "go.mod",
+    "Cargo.toml",
+    "pom.xml",
+    "build.gradle",
+];
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+/**
+ * Specky MCP Server — Entry Point
+ * Spec-Driven Development engine for AI agents.
+ *
+ * Creator: Paula Silva @paulasilvatech @paulanunes85 | Americas Software GBB
+ * License: MIT
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;GAMG"}