@lbruton/spec-workflow-mcp 2.2.4

package/README.it.md

@@ -0,0 +1,314 @@
+# Spec Workflow MCP
+
+[![npm version](https://img.shields.io/npm/v/@pimzino/spec-workflow-mcp)](https://www.npmjs.com/package/@pimzino/spec-workflow-mcp)
+[![VSCode Extension](https://vsmarketplacebadges.dev/version-short/Pimzino.spec-workflow-mcp.svg)](https://marketplace.visualstudio.com/items?itemName=Pimzino.spec-workflow-mcp)
+
+Un server Model Context Protocol (MCP) per lo sviluppo strutturato basato su specifiche con dashboard in tempo reale ed estensione VSCode.
+
+## ☕ Sostieni Questo Progetto
+
+<a href="https://buymeacoffee.com/Pimzino" target="_blank"><img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me A Coffee" style="height: 60px !important;width: 217px !important;" ></a>
+
+## 📺 Showcase
+
+### 🔄 Sistema di Approvazione in Azione
+<a href="https://www.youtube.com/watch?v=C-uEa3mfxd0" target="_blank">
+  <img src="https://img.youtube.com/vi/C-uEa3mfxd0/maxresdefault.jpg" alt="Approval System Demo" width="600">
+</a>
+
+*Guarda come funziona il sistema di approvazione: crea documenti, richiedi approvazione tramite la dashboard, fornisci feedback e traccia le revisioni.*
+
+### 📊 Dashboard e Gestione delle Specifiche
+<a href="https://www.youtube.com/watch?v=g9qfvjLUWf8" target="_blank">
+  <img src="https://img.youtube.com/vi/g9qfvjLUWf8/maxresdefault.jpg" alt="Dashboard Demo" width="600">
+</a>
+
+*Esplora la dashboard in tempo reale: visualizza le specifiche, traccia i progressi, naviga tra i documenti e monitora il tuo flusso di lavoro di sviluppo.*
+
+## ✨ Caratteristiche Principali
+
+- **Flusso di Lavoro Strutturato** - Creazione sequenziale delle specifiche (Requisiti → Design → Task)
+- **Dashboard Web in Tempo Reale** - Monitora specifiche, task e progressi con aggiornamenti live
+- **Estensione VSCode** - Dashboard integrata nella sidebar per utenti VSCode
+- **Flusso di Approvazione** - Processo di approvazione completo con revisioni
+- **Tracciamento Progressi Task** - Barre di progresso visive e stato dettagliato
+- **Log di Implementazione** - Log ricercabili di tutte le implementazioni dei task con statistiche del codice
+- **Supporto Multi-Lingua** - Disponibile in 11 lingue
+
+## 🌍 Lingue Supportate
+
+🇺🇸 English • 🇯🇵 日本語 • 🇨🇳 中文 • 🇪🇸 Español • 🇧🇷 Português • 🇩🇪 Deutsch • 🇫🇷 Français • 🇷🇺 Русский • 🇮🇹 Italiano • 🇰🇷 한국어 • 🇸🇦 العربية
+
+## 🚀 Avvio Rapido
+
+### Passo 1: Aggiungi al tuo strumento AI
+
+Aggiungi alla configurazione MCP (vedi configurazione specifica per client qui sotto):
+
+```json
+{
+  "mcpServers": {
+    "spec-workflow": {
+      "command": "npx",
+      "args": ["-y", "@pimzino/spec-workflow-mcp@latest", "/path/to/your/project"]
+    }
+  }
+}
+```
+
+### Passo 2: Scegli la tua interfaccia
+
+**Opzione A: Dashboard Web** (Richiesta per utenti CLI)
+Avvia la dashboard (viene eseguita sulla porta 5000 di default):
+```bash
+npx -y @pimzino/spec-workflow-mcp@latest --dashboard
+```
+
+La dashboard sarà accessibile a: http://localhost:5000
+
+> **Nota:** È necessaria solo un'istanza della dashboard. Tutti i tuoi progetti si connetteranno alla stessa dashboard.
+
+**Opzione B: Estensione VSCode** (Consigliata per utenti VSCode)
+
+Installa [Spec Workflow MCP Extension](https://marketplace.visualstudio.com/items?itemName=Pimzino.spec-workflow-mcp) dal marketplace VSCode.
+
+## 📝 Come Utilizzare
+
+Menziona semplicemente spec-workflow nella tua conversazione:
+
+- **"Crea una specifica per l'autenticazione utente"** - Crea il flusso completo delle specifiche
+- **"Elenca le mie specifiche"** - Mostra tutte le specifiche e il loro stato
+- **"Esegui il task 1.2 nella specifica user-auth"** - Esegue un task specifico
+
+[Vedi altri esempi →](docs/PROMPTING-GUIDE.it.md)
+
+## 🔧 Configurazione Client MCP
+
+<details>
+<summary><strong>Augment Code</strong></summary>
+
+Configura nelle impostazioni di Augment:
+```json
+{
+  "mcpServers": {
+    "spec-workflow": {
+      "command": "npx",
+      "args": ["-y", "@pimzino/spec-workflow-mcp@latest", "/path/to/your/project"]
+    }
+  }
+}
+```
+</details>
+
+<details>
+<summary><strong>Claude Code CLI</strong></summary>
+
+Aggiungi alla configurazione MCP:
+```bash
+claude mcp add spec-workflow npx @pimzino/spec-workflow-mcp@latest -- /path/to/your/project
+```
+
+**Note Importanti:**
+- Il flag `-y` bypassa i prompt npm per un'installazione più fluida
+- Il separatore `--` assicura che il percorso venga passato allo script spec-workflow, non a npx
+- Sostituisci `/path/to/your/project` con il percorso effettivo della directory del tuo progetto
+
+**Alternativa per Windows (se quanto sopra non funziona):**
+```bash
+claude mcp add spec-workflow cmd.exe /c "npx @pimzino/spec-workflow-mcp@latest /path/to/your/project"
+```
+</details>
+
+<details>
+<summary><strong>Claude Desktop</strong></summary>
+
+Aggiungi a `claude_desktop_config.json`:
+```json
+{
+  "mcpServers": {
+    "spec-workflow": {
+      "command": "npx",
+      "args": ["-y", "@pimzino/spec-workflow-mcp@latest", "/path/to/your/project"]
+    }
+  }
+}
+```
+
+> **Importante:** Esegui la dashboard separatamente con `--dashboard` prima di avviare il server MCP.
+
+</details>
+
+<details>
+<summary><strong>Cline/Claude Dev</strong></summary>
+
+Aggiungi alla configurazione del server MCP:
+```json
+{
+  "mcpServers": {
+    "spec-workflow": {
+      "command": "npx",
+      "args": ["-y", "@pimzino/spec-workflow-mcp@latest", "/path/to/your/project"]
+    }
+  }
+}
+```
+</details>
+
+<details>
+<summary><strong>Continue IDE Extension</strong></summary>
+
+Aggiungi alla configurazione di Continue:
+```json
+{
+  "mcpServers": {
+    "spec-workflow": {
+      "command": "npx",
+      "args": ["-y", "@pimzino/spec-workflow-mcp@latest", "/path/to/your/project"]
+    }
+  }
+}
+```
+</details>
+
+<details>
+<summary><strong>Cursor IDE</strong></summary>
+
+Aggiungi alle impostazioni di Cursor (`settings.json`):
+```json
+{
+  "mcpServers": {
+    "spec-workflow": {
+      "command": "npx",
+      "args": ["-y", "@pimzino/spec-workflow-mcp@latest", "/path/to/your/project"]
+    }
+  }
+}
+```
+</details>
+
+<details>
+<summary><strong>OpenCode</strong></summary>
+
+Aggiungi al file di configurazione `opencode.json`:
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "mcp": {
+    "spec-workflow": {
+      "type": "local",
+      "command": ["npx", "-y", "@pimzino/spec-workflow-mcp@latest", "/path/to/your/project"],
+      "enabled": true
+    }
+  }
+}
+```
+</details>
+
+<details>
+<summary><strong>Windsurf</strong></summary>
+
+Aggiungi al file di configurazione `~/.codeium/windsurf/mcp_config.json`:
+```json
+{
+  "mcpServers": {
+    "spec-workflow": {
+      "command": "npx",
+      "args": ["-y", "@pimzino/spec-workflow-mcp@latest", "/path/to/your/project"]
+    }
+  }
+}
+```
+</details>
+
+<details>
+<summary><strong>Codex</strong></summary>
+
+Aggiungi al file di configurazione `~/.codex/config.toml`:
+```toml
+[mcp_servers.spec-workflow]
+command = "npx"
+args = ["-y", "@pimzino/spec-workflow-mcp@latest", "/path/to/your/project"]
+```
+</details>
+
+## 🐳 Distribuzione Docker
+
+Esegui la dashboard in un container Docker per una distribuzione isolata:
+
+```bash
+# Usando Docker Compose (consigliato)
+cd containers
+docker-compose up --build
+
+# Oppure usando Docker CLI
+docker build -f containers/Dockerfile -t spec-workflow-mcp .
+docker run -p 5000:5000 -v "./workspace/.spec-workflow:/workspace/.spec-workflow:rw" spec-workflow-mcp
+```
+
+La dashboard sarà disponibile a: http://localhost:5000
+
+[Vedi guida configurazione Docker →](containers/README.md)
+
+## 🔒 Ambienti Sandboxed
+
+Per ambienti sandboxed (es. Codex CLI con `sandbox_mode=workspace-write`) dove `$HOME` è in sola lettura, usa la variabile d'ambiente `SPEC_WORKFLOW_HOME` per reindirizzare i file di stato globale in una posizione scrivibile:
+
+```bash
+SPEC_WORKFLOW_HOME=/workspace/.spec-workflow-mcp npx -y @pimzino/spec-workflow-mcp@latest /workspace
+```
+
+[Vedi Guida alla Configurazione →](docs/CONFIGURATION.it.md#variabili-dambiente)
+
+## 📚 Documentazione
+
+- [Guida alla Configurazione](docs/CONFIGURATION.it.md) - Opzioni da riga di comando, file di configurazione
+- [Guida Utente](docs/USER-GUIDE.it.md) - Esempi d'uso completi
+- [Processo di Workflow](docs/WORKFLOW.it.md) - Flusso di lavoro di sviluppo e best practice
+- [Guida alle Interfacce](docs/INTERFACES.it.md) - Dettagli dashboard ed estensione VSCode
+- [Guida ai Prompt](docs/PROMPTING-GUIDE.it.md) - Esempi avanzati di prompting
+- [Riferimento Strumenti](docs/TOOLS-REFERENCE.it.md) - Documentazione completa degli strumenti
+- [Sviluppo](docs/DEVELOPMENT.it.md) - Contribuzione e configurazione sviluppo
+- [Risoluzione Problemi](docs/TROUBLESHOOTING.it.md) - Problemi comuni e soluzioni
+
+## 📁 Struttura del Progetto
+
+```
+your-project/
+  .spec-workflow/
+    approvals/
+    archive/
+    specs/
+    steering/
+    templates/
+    user-templates/
+    config.example.toml
+```
+
+## 🛠️ Sviluppo
+
+```bash
+# Installa le dipendenze
+npm install
+
+# Compila il progetto
+npm run build
+
+# Esegui in modalità sviluppo
+npm run dev
+```
+
+[Vedi guida allo sviluppo →](docs/DEVELOPMENT.it.md)
+
+## 📄 Licenza
+
+GPL-3.0
+
+## ⭐ Cronologia Stelle
+
+<a href="https://www.star-history.com/#Pimzino/spec-workflow-mcp&Date">
+ <picture>
+   <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=Pimzino/spec-workflow-mcp&type=Date&theme=dark" />
+   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=Pimzino/spec-workflow-mcp&type=Date" />
+   <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=Pimzino/spec-workflow-mcp&type=Date" />
+ </picture>
+</a>

package/README.ja.md

@@ -0,0 +1,316 @@
+# Spec Workflow MCP
+
+[![npm version](https://img.shields.io/npm/v/@pimzino/spec-workflow-mcp)](https://www.npmjs.com/package/@pimzino/spec-workflow-mcp)
+[![VSCode Extension](https://vsmarketplacebadges.dev/version-short/Pimzino.spec-workflow-mcp.svg)](https://marketplace.visualstudio.com/items?itemName=Pimzino.spec-workflow-mcp)
+
+リアルタイムダッシュボードとVSCode拡張機能を備えた、構造化された仕様駆動開発のためのModel Context Protocol (MCP) サーバーです。
+
+## ☕ このプロジェクトを支援する
+
+<a href="https://buymeacoffee.com/Pimzino" target="_blank"><img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me A Coffee" style="height: 60px !important;width: 217px !important;" ></a>
+
+## 📺 ショーケース
+
+### 🔄 承認システムの動作
+
+<a href="https://www.youtube.com/watch?v=C-uEa3mfxd0" target="_blank">
+  <img src="https://img.youtube.com/vi/C-uEa3mfxd0/maxresdefault.jpg" alt="Approval System Demo" width="600">
+</a>
+
+*承認システムの動作をご覧ください：ドキュメント作成、ダッシュボードでの承認リクエスト、フィードバック提供、改訂の追跡。*
+
+### 📊 ダッシュボードと仕様管理
+
+<a href="https://www.youtube.com/watch?v=g9qfvjLUWf8" target="_blank">
+  <img src="https://img.youtube.com/vi/g9qfvjLUWf8/maxresdefault.jpg" alt="Dashboard Demo" width="600">
+</a>
+
+*リアルタイムダッシュボードを探索：仕様の表示、進捗の追跡、ドキュメントのナビゲート、開発ワークフローの監視。*
+
+## ✨ 主な機能
+
+- **構造化された開発ワークフロー** - 順次仕様作成（要件 → 設計 → タスク）
+- **リアルタイムWebダッシュボード** - ライブ更新で仕様、タスク、進捗を監視
+- **VSCode拡張機能** - VSCodeユーザー向けの統合サイドバーダッシュボード
+- **承認ワークフロー** - 改訂を含む完全な承認プロセス
+- **タスク進捗追跡** - ビジュアル進捗バーと詳細なステータス
+- **実装ログ** - コード統計を含むすべてのタスク実装の検索可能なログ
+- **多言語サポート** - 11言語で利用可能
+
+## 🌍 サポート言語
+
+🇺🇸 English • 🇯🇵 日本語 • 🇨🇳 中文 • 🇪🇸 Español • 🇧🇷 Português • 🇩🇪 Deutsch • 🇫🇷 Français • 🇷🇺 Русский • 🇮🇹 Italiano • 🇰🇷 한국어 • 🇸🇦 العربية
+
+## 🚀 クイックスタート
+
+### ステップ1: AIツールに追加する
+
+MCP設定に追加します（以下のクライアント固有のセットアップを参照）：
+
+```json
+{
+  "mcpServers": {
+    "spec-workflow": {
+      "command": "npx",
+      "args": ["-y", "@pimzino/spec-workflow-mcp@latest", "/path/to/your/project"]
+    }
+  }
+}
+```
+
+### ステップ2: インターフェースを選択する
+
+**オプションA: Webダッシュボード**（CLIユーザーに必須）
+ダッシュボードを起動します（デフォルトポート5000で実行）：
+```bash
+npx -y @pimzino/spec-workflow-mcp@latest --dashboard
+```
+
+ダッシュボードは以下のURLでアクセス可能です：http://localhost:5000
+
+> **注意：** ダッシュボードインスタンスは1つだけ必要です。すべてのプロジェクトが同じダッシュボードに接続します。
+
+**オプションB: VSCode拡張機能**（VSCodeユーザーに推奨）
+
+VSCodeマーケットプレイスから[Spec Workflow MCP Extension](https://marketplace.visualstudio.com/items?itemName=Pimzino.spec-workflow-mcp)をインストールします。
+
+## 📝 使い方
+
+会話でspec-workflowに言及するだけです：
+
+- **「ユーザー認証の仕様を作成して」** - 完全な仕様ワークフローを作成
+- **「仕様一覧を表示して」** - すべての仕様とそのステータスを表示
+- **「user-auth仕様のタスク1.2を実行して」** - 特定のタスクを実行
+
+[その他の例を見る →](docs/PROMPTING-GUIDE.ja.md)
+
+## 🔧 MCPクライアントセットアップ
+
+<details>
+<summary><strong>Augment Code</strong></summary>
+
+Augment設定で設定します：
+```json
+{
+  "mcpServers": {
+    "spec-workflow": {
+      "command": "npx",
+      "args": ["-y", "@pimzino/spec-workflow-mcp@latest", "/path/to/your/project"]
+    }
+  }
+}
+```
+</details>
+
+<details>
+<summary><strong>Claude Code CLI</strong></summary>
+
+MCP設定に追加します：
+```bash
+claude mcp add spec-workflow npx @pimzino/spec-workflow-mcp@latest -- /path/to/your/project
+```
+
+**重要な注意事項：**
+- `-y`フラグは、スムーズなインストールのためにnpmプロンプトをバイパスします
+- `--`区切り文字により、パスがnpxではなくspec-workflowスクリプトに渡されます
+- `/path/to/your/project`を実際のプロジェクトディレクトリパスに置き換えてください
+
+**Windows用の代替方法（上記が機能しない場合）：**
+```bash
+claude mcp add spec-workflow cmd.exe /c "npx @pimzino/spec-workflow-mcp@latest /path/to/your/project"
+```
+</details>
+
+<details>
+<summary><strong>Claude Desktop</strong></summary>
+
+`claude_desktop_config.json`に追加します：
+```json
+{
+  "mcpServers": {
+    "spec-workflow": {
+      "command": "npx",
+      "args": ["-y", "@pimzino/spec-workflow-mcp@latest", "/path/to/your/project"]
+    }
+  }
+}
+```
+
+> **重要：** MCPサーバーを起動する前に、`--dashboard`を使用してダッシュボードを別途実行してください。
+
+</details>
+
+<details>
+<summary><strong>Cline/Claude Dev</strong></summary>
+
+MCPサーバー設定に追加します：
+```json
+{
+  "mcpServers": {
+    "spec-workflow": {
+      "command": "npx",
+      "args": ["-y", "@pimzino/spec-workflow-mcp@latest", "/path/to/your/project"]
+    }
+  }
+}
+```
+</details>
+
+<details>
+<summary><strong>Continue IDE Extension</strong></summary>
+
+Continue設定に追加します：
+```json
+{
+  "mcpServers": {
+    "spec-workflow": {
+      "command": "npx",
+      "args": ["-y", "@pimzino/spec-workflow-mcp@latest", "/path/to/your/project"]
+    }
+  }
+}
+```
+</details>
+
+<details>
+<summary><strong>Cursor IDE</strong></summary>
+
+Cursor設定（`settings.json`）に追加します：
+```json
+{
+  "mcpServers": {
+    "spec-workflow": {
+      "command": "npx",
+      "args": ["-y", "@pimzino/spec-workflow-mcp@latest", "/path/to/your/project"]
+    }
+  }
+}
+```
+</details>
+
+<details>
+<summary><strong>OpenCode</strong></summary>
+
+`opencode.json`設定ファイルに追加します：
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "mcp": {
+    "spec-workflow": {
+      "type": "local",
+      "command": ["npx", "-y", "@pimzino/spec-workflow-mcp@latest", "/path/to/your/project"],
+      "enabled": true
+    }
+  }
+}
+```
+</details>
+
+<details>
+<summary><strong>Windsurf</strong></summary>
+
+`~/.codeium/windsurf/mcp_config.json`設定ファイルに追加します：
+```json
+{
+  "mcpServers": {
+    "spec-workflow": {
+      "command": "npx",
+      "args": ["-y", "@pimzino/spec-workflow-mcp@latest", "/path/to/your/project"]
+    }
+  }
+}
+```
+</details>
+
+<details>
+<summary><strong>Codex</strong></summary>
+
+`~/.codex/config.toml`設定ファイルに追加します：
+```toml
+[mcp_servers.spec-workflow]
+command = "npx"
+args = ["-y", "@pimzino/spec-workflow-mcp@latest", "/path/to/your/project"]
+```
+</details>
+
+## 🐳 Dockerデプロイ
+
+Dockerコンテナでダッシュボードを実行し、分離されたデプロイを実現します：
+
+```bash
+# Docker Composeを使用（推奨）
+cd containers
+docker-compose up --build
+
+# またはDocker CLIを使用
+docker build -f containers/Dockerfile -t spec-workflow-mcp .
+docker run -p 5000:5000 -v "./workspace/.spec-workflow:/workspace/.spec-workflow:rw" spec-workflow-mcp
+```
+
+ダッシュボードは以下のURLで利用可能になります：http://localhost:5000
+
+[Dockerセットアップガイドを見る →](containers/README.md)
+
+## 🔒 サンドボックス環境
+
+`$HOME`が読み取り専用のサンドボックス環境（例：Codex CLIの`sandbox_mode=workspace-write`）の場合、`SPEC_WORKFLOW_HOME`環境変数を使用してグローバル状態ファイルを書き込み可能な場所にリダイレクトします：
+
+```bash
+SPEC_WORKFLOW_HOME=/workspace/.spec-workflow-mcp npx -y @pimzino/spec-workflow-mcp@latest /workspace
+```
+
+[設定ガイドを見る →](docs/CONFIGURATION.ja.md#environment-variables)
+
+## 📚 ドキュメント
+
+- [設定ガイド](docs/CONFIGURATION.ja.md) - コマンドラインオプション、設定ファイル
+- [ユーザーガイド](docs/USER-GUIDE.ja.md) - 包括的な使用例
+- [ワークフロープロセス](docs/WORKFLOW.ja.md) - 開発ワークフローとベストプラクティス
+- [インターフェースガイド](docs/INTERFACES.ja.md) - ダッシュボードとVSCode拡張機能の詳細
+- [プロンプティングガイド](docs/PROMPTING-GUIDE.ja.md) - 高度なプロンプティング例
+- [ツールリファレンス](docs/TOOLS-REFERENCE.ja.md) - 完全なツールドキュメント
+- [開発](docs/DEVELOPMENT.ja.md) - 貢献と開発セットアップ
+- [トラブルシューティング](docs/TROUBLESHOOTING.ja.md) - 一般的な問題と解決策
+
+## 📁 プロジェクト構造
+
+```
+your-project/
+  .spec-workflow/
+    approvals/
+    archive/
+    specs/
+    steering/
+    templates/
+    user-templates/
+    config.example.toml
+```
+
+## 🛠️ 開発
+
+```bash
+# 依存関係をインストール
+npm install
+
+# プロジェクトをビルド
+npm run build
+
+# 開発モードで実行
+npm run dev
+```
+
+[開発ガイドを見る →](docs/DEVELOPMENT.ja.md)
+
+## 📄 ライセンス
+
+GPL-3.0
+
+## ⭐ スター履歴
+
+<a href="https://www.star-history.com/#Pimzino/spec-workflow-mcp&Date">
+ <picture>
+   <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=Pimzino/spec-workflow-mcp&type=Date&theme=dark" />
+   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=Pimzino/spec-workflow-mcp&type=Date" />
+   <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=Pimzino/spec-workflow-mcp&type=Date" />
+ </picture>
+</a>