superpowers-mcp 6.4.8 → 6.4.10
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.es.md +17 -2
- package/README.hi.md +17 -2
- package/README.ja.md +17 -2
- package/README.ko.md +17 -2
- package/README.md +20 -5
- package/README.pt-BR.md +17 -2
- package/README.zh-TW.md +17 -2
- package/out/server.js +161 -142
- package/out/setup-runner.js +35 -35
- package/out/setup.js +36 -36
- package/package.json +3 -3
- package/skills/brainstorming/scripts/server.cjs +30 -2
- package/skills/brainstorming/scripts/start-server.ps1 +2 -2
- package/skills/brainstorming/scripts/start-server.sh +2 -2
- package/skills/subagent-driven-development/scripts/sdd-workspace.ps1 +3 -1
package/README.es.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
[English](README.md) | [繁體中文](README.zh-TW.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [Español](README.es.md) | [Português (BR)](README.pt-BR.md) | [हिन्दी](README.hi.md)
|
|
4
4
|
|
|
5
|
-
[](https://github.com/Poseidoncode/superpowers-mcp)
|
|
6
6
|
[](LICENSE)
|
|
7
7
|
|
|
8
8
|
Este documento resume la información y las instrucciones de uso para empaquetar las habilidades (skills) de Superpowers y el sistema de flujos de trabajo autónomos en un servidor **Model Context Protocol (MCP)** independiente, de alto rendimiento y seguro.
|
|
@@ -182,7 +182,22 @@ Para ayudarte a elegir el skill adecuado, hemos estructurado los 15 skills a lo
|
|
|
182
182
|
|
|
183
183
|
## 🆕 Novedades recientes
|
|
184
184
|
|
|
185
|
-
### v6.4.
|
|
185
|
+
### v6.4.10 (última versión)
|
|
186
|
+
|
|
187
|
+
- **`--remove` de la instalación ahora es completo** (CWE-459): TOML elimina todas las tablas de matriz `[[mcp_servers.superpowers]]` gestionadas y sus subtablas, JSON elimina todas las entradas raíz equivalentes y YAML elimina las entradas de flow map con contenido, dejando intacto un `mcp_servers:` anidado bajo otro padre (`tests/setup_test.js` ahora **100/100**).
|
|
188
|
+
- **Comprobación de propietario de `SKILLS_PATH`** (CWE-22 / CWE-668): en POSIX la raíz debe ser un directorio existente, propiedad del usuario actual y sin permisos de escritura para grupo/otros. **Cambio de comportamiento:** `/tmp` en Linux (incluido `SKILLS_PATH=$(mktemp -d)`) se rechaza y se usan las skills incluidas; usa un directorio dentro de tu home. Las raíces `/private/var/folders` de macOS siguen funcionando.
|
|
189
|
+
- **Entrada no confiable acotada**: los `skill_name` y URI `skill://` de más de 256 caracteres se rechazan, y los mensajes de error y `stderr` recortan a 80 caracteres cualquier entrada repetida, evitando la amplificación de respuestas con nombres de varios megabytes (`tests/mcp_coverage_test.js`).
|
|
190
|
+
- **Menos memoria y bloqueos**: el WebSocket de brainstorm ya no recopia su búfer en cada fragmento de un marco fragmentado, el presupuesto de la caché de contenido usa el tamaño de la instantánea stat en lugar de volver a medir cada cuerpo, y la comparación de archivos de revisión de `sdd-task-reviewer` / `sdd-re-review` ya no bloquea el bucle de eventos.
|
|
191
|
+
- **Automatización del repositorio**: se añadieron Dependabot (npm + GitHub Actions) y un workflow de CI en `.github/`.
|
|
192
|
+
- Verificación: `npm run build` correcto; `npm test` en verde — **16/23** suites (**7** suites de PowerShell omitidas sin `pwsh`).
|
|
193
|
+
|
|
194
|
+
### v6.4.9
|
|
195
|
+
|
|
196
|
+
- **Remediación CodeQL (`list_skills` + YAML setup)**: `escapeListMarkdown` escapa toda la puntuación ASCII y colapsa saltos de línea para que descripciones no confiables no inyecten Markdown ni HTML crudo en `list_skills` (`tests/client_truncation_test.js`). La detección de claves anidadas YAML usa `isBareYamlMappingKey()` lineal en lugar del regex con backtracking `/:\s*(?:#.*)?$/` (alerta CodeQL #11; fijado en `tests/setup_test.js`).
|
|
197
|
+
- **Comprobaciones allowed-root en macOS**: `safeWriteConfig` resuelve rutas de configuración mediante el ancestro padre existente más profundo, de modo que `/var/folders/...` y `/private/var/folders/...` coinciden en la contención de raíces permitidas. Corrige rechazos falsos al configurar con un clic bajo el árbol temp del usuario en macOS (`tests/setup_test.js` **97/97**).
|
|
198
|
+
- Verificación: `npm run build` correcto; `npm test` en verde — **16/23** suites (**7** de PowerShell omitidas sin `pwsh`).
|
|
199
|
+
|
|
200
|
+
### v6.4.8
|
|
186
201
|
|
|
187
202
|
- **Límites de respuesta al cliente MCP**: el cuerpo inline de las skills se limita a **20 KB** en `read_skill`, `list_skills`, resources y la guía de compositions para que un `SKILL.md` enorme no agote el contexto del agente (`tests/client_truncation_test.js`).
|
|
188
203
|
- **Detección de reemplazo del directorio raíz** (`EROOTCHANGED`): se registra el inode del directorio de skills al arrancar; si `SKILLS_PATH` se sustituye sin reiniciar el servidor MCP, listados y lecturas en caliente fallan de forma segura con aviso de reinicio (edge-cases Test 15).
|
package/README.hi.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
[English](README.md) | [繁體中文](README.zh-TW.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [Español](README.es.md) | [Português (BR)](README.pt-BR.md) | [हिन्दी](README.hi.md)
|
|
4
4
|
|
|
5
|
-
[](https://github.com/Poseidoncode/superpowers-mcp)
|
|
6
6
|
[](LICENSE)
|
|
7
7
|
|
|
8
8
|
यह दस्तावेज़ Superpowers skills लाइब्रेरी और स्वायत्त वर्कफ़्लो सिस्टम को एक स्वतंत्र, उच्च-प्रदर्शन और सुरक्षित **Model Context Protocol (MCP)** सर्वर के रूप में पैकेज करने की जानकारी और उपयोग निर्देशों का सारांश है।
|
|
@@ -182,7 +182,22 @@ systematic-debugging ➔ using-git-worktrees ➔ dispatching-parallel-agents ➔
|
|
|
182
182
|
|
|
183
183
|
## 🆕 हाल के अपडेट
|
|
184
184
|
|
|
185
|
-
### v6.4.
|
|
185
|
+
### v6.4.10 (नवीनतम)
|
|
186
|
+
|
|
187
|
+
- **सेटअप `--remove` अब पूर्ण है** (CWE-459): TOML सभी प्रबंधित `[[mcp_servers.superpowers]]` ऐरे टेबल और उनकी उप-तालिकाएँ हटाता है, JSON सभी समतुल्य रूट प्रविष्टियाँ हटाता है, और YAML भरे हुए flow map प्रविष्टियाँ हटाता है तथा किसी अन्य पैरेंट के अंतर्गत नेस्टेड `mcp_servers:` को अछूता छोड़ता है (`tests/setup_test.js` अब **100/100**)।
|
|
188
|
+
- **`SKILLS_PATH` स्वामित्व जाँच** (CWE-22 / CWE-668): POSIX पर रूट एक मौजूदा डायरेक्टरी होनी चाहिए, जो वर्तमान उपयोगकर्ता की हो और जिस पर group/other के लिए लिखने की अनुमति न हो। **व्यवहार परिवर्तन:** Linux का `/tmp` (`SKILLS_PATH=$(mktemp -d)` सहित) अस्वीकार हो जाता है और बंडल्ड स्किल्स पर लौट आता है — होम के अंतर्गत कोई डायरेक्टरी उपयोग करें। macOS के `/private/var/folders` रूट अब भी काम करते हैं।
|
|
189
|
+
- **अविश्वसनीय इनपुट पर सीमा**: 256 अक्षरों से लंबे `skill_name` और `skill://` URI अस्वीकार किए जाते हैं, और त्रुटि संदेश व `stderr` में दोहराया गया इनपुट 80 अक्षरों तक काट दिया जाता है, जिससे कई मेगाबाइट के नामों से होने वाला रिस्पॉन्स एम्प्लिफिकेशन रुकता है (`tests/mcp_coverage_test.js`)।
|
|
190
|
+
- **कम मेमोरी और ब्लॉकिंग**: brainstorm WebSocket अब खंडित फ्रेम के हर चंक पर बफ़र को दोबारा कॉपी नहीं करता, कंटेंट कैश बजट हर बॉडी को दोबारा नापने की बजाय stat स्नैपशॉट के आकार का उपयोग करता है, और `sdd-task-reviewer` / `sdd-re-review` की रिव्यू फ़ाइल तुलना अब इवेंट लूप को ब्लॉक नहीं करती।
|
|
191
|
+
- **रिपॉज़िटरी ऑटोमेशन**: `.github/` में Dependabot (npm + GitHub Actions) और CI वर्कफ़्लो जोड़े गए हैं।
|
|
192
|
+
- सत्यापन: `npm run build` सफल; `npm test` सब हरा — **16/23** सूट (`pwsh` न होने से **7** PowerShell सूट छोड़े गए)।
|
|
193
|
+
|
|
194
|
+
### v6.4.9
|
|
195
|
+
|
|
196
|
+
- **CodeQL उपाय (`list_skills` + YAML setup)**: `escapeListMarkdown` सभी ASCII विराम चिह्नों को escape करके लाइन ब्रेक समेटता है, ताकि अविश्वसनीय skill विवरण `list_skills` आउटपुट में Markdown या कच्चा HTML न घुसा सकें (`tests/client_truncation_test.js`)। YAML नेस्टेड-की पहचान रैखिक `isBareYamlMappingKey()` से, बैकट्रैकिंग वाले `/:\s*(?:#.*)?$/` regex की जगह (CodeQL alert #11; `tests/setup_test.js` में पिन)।
|
|
197
|
+
- **macOS setup allowed-root जाँच**: `safeWriteConfig` अब सबसे गहरे मौजूदा पैरेंट के ज़रिए कॉन्फ़िग पथ हल करता है, ताकि `/var/folders/...` और `/private/var/folders/...` allowed-root में समान माने जाएँ। macOS पर उपयोगकर्ता temp के नीचे वन-क्लिक सेटअप में गलत `Refusing to write configuration outside allowed roots` ठीक (`tests/setup_test.js` **97/97**).
|
|
198
|
+
- सत्यापन: `npm run build` पास; `npm test` हरा — **16/23** सुइट (`pwsh` के बिना PowerShell **7** स्किप).
|
|
199
|
+
|
|
200
|
+
### v6.4.8
|
|
186
201
|
|
|
187
202
|
- **MCP क्लाइंट प्रतिक्रिया सीमा**: `read_skill`, `list_skills`, स्किल resources और compositions guide के इनलाइन बॉडी **20 KB** पर सीमित, ताकि एक विशाल `SKILL.md` एजेंट संदर्भ न खत्म करे (`tests/client_truncation_test.js`).
|
|
188
203
|
- **स्किल रूट बदलाव पहचान** (`EROOTCHANGED`): स्टार्टअप पर स्किल डायरेक्टरी inode ट्रैक; MCP सर्वर रीस्टार्ट के बिना `SKILLS_PATH` बदलने पर हॉट-पाथ लिस्ट/रीड fail-closed और रीस्टार्ट संकेत (edge-cases Test 15).
|
package/README.ja.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
[English](README.md) | [繁體中文](README.zh-TW.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [Español](README.es.md) | [Português (BR)](README.pt-BR.md) | [हिन्दी](README.hi.md)
|
|
4
4
|
|
|
5
|
-
[](https://github.com/Poseidoncode/superpowers-mcp)
|
|
6
6
|
[](LICENSE)
|
|
7
7
|
|
|
8
8
|
このドキュメントは、Superpowers スキルライブラリと自律型ワークフローを、独立した高パフォーマンスかつ安全な **Model Context Protocol (MCP)** サーバーにパッケージ化した使用説明書です。
|
|
@@ -183,7 +183,22 @@ systematic-debugging ➔ using-git-worktrees ➔ dispatching-parallel-agents ➔
|
|
|
183
183
|
|
|
184
184
|
## 🆕 最近の更新
|
|
185
185
|
|
|
186
|
-
### v6.4.
|
|
186
|
+
### v6.4.10(最新)
|
|
187
|
+
|
|
188
|
+
- **セットアップの `--remove` が完全に**(CWE-459):TOML は管理対象の `[[mcp_servers.superpowers]]` 配列テーブルとサブテーブルをすべて削除し、JSON は同等のルートエントリをすべて削除、YAML は値入りの flow map エントリを削除しつつ、別の親の下にあるネストした `mcp_servers:` には触れません(`tests/setup_test.js` は **100/100**)。
|
|
189
|
+
- **`SKILLS_PATH` の所有者チェック**(CWE-22 / CWE-668):POSIX ではルートが既存のディレクトリで、現在のユーザーが所有し、グループ/その他に書き込み権限がないことが必須です。**動作変更:** Linux の `/tmp`(`SKILLS_PATH=$(mktemp -d)` を含む)は拒否され、同梱スキルにフォールバックします。ホーム配下のディレクトリを使用してください。macOS の `/private/var/folders` は引き続き利用できます。
|
|
190
|
+
- **信頼できない入力の制限**:256 文字を超える `skill_name` と `skill://` URI は拒否され、エラーメッセージと `stderr` に出力される入力は 80 文字に切り詰められます。巨大な名前によるレスポンス増幅を防ぎます(`tests/mcp_coverage_test.js`)。
|
|
191
|
+
- **メモリ使用量とブロッキングの低減**:brainstorm WebSocket は分割フレームのチャンクごとにバッファを再コピーしなくなり、コンテンツキャッシュの予算は各本文を再計測せず stat スナップショットのサイズを使用し、`sdd-task-reviewer` / `sdd-re-review` のレビューファイル比較もイベントループをブロックしません。
|
|
192
|
+
- **リポジトリの自動化**:`.github/` に Dependabot(npm + GitHub Actions)と CI ワークフローを追加しました。
|
|
193
|
+
- 検証:`npm run build` 成功、`npm test` 全て成功 — **16/23** スイート(`pwsh` がないため PowerShell **7** スイートはスキップ)。
|
|
194
|
+
|
|
195
|
+
### v6.4.9
|
|
196
|
+
|
|
197
|
+
- **CodeQL 対応(`list_skills` + YAML setup)**:`escapeListMarkdown` が ASCII 句読点をすべてエスケープし改行を折りたたむため、信頼できない skill 説明が `list_skills` 出力に Markdown や生 HTML を注入できない(`tests/client_truncation_test.js`)。YAML のネストキー判定は線形の `isBareYamlMappingKey()` に置き換え、バックトラックする `/:\s*(?:#.*)?$/` を廃止(CodeQL alert #11;`tests/setup_test.js` で固定)。
|
|
198
|
+
- **macOS セットアップの allowed-root チェック**:`safeWriteConfig` が最深の既存親ディレクトリ経由で設定パスを解決し、`/var/folders/...` と `/private/var/folders/...` を同一ツリーとして扱うようにした。macOS のユーザー temp 配下でのワンクリックセットアップ時に誤って `Refusing to write configuration outside allowed roots` となる問題を修正(`tests/setup_test.js` は **97/97**)。
|
|
199
|
+
- 検証:`npm run build` 成功;`npm test` グリーン——**16/23** スイート(`pwsh` なしで PowerShell **7** 件スキップ)。
|
|
200
|
+
|
|
201
|
+
### v6.4.8
|
|
187
202
|
|
|
188
203
|
- **MCP クライアント向けレスポンス上限**:`read_skill`、`list_skills`、スキル resource、compositions guide のインライン本文を **20 KB** に制限し、巨大な 1 つの `SKILL.md` がエージェントのコンテキストを枯渇させないようにした(`tests/client_truncation_test.js`)。
|
|
189
204
|
- **スキルルート差し替え検知**(`EROOTCHANGED`):起動時にスキルディレクトリの inode を記録。MCP サーバーを再起動せず `SKILLS_PATH` が置き換わった場合、ホットパスの一覧・読み取りは fail-closed で再起動を促す(edge-cases Test 15)。
|
package/README.ko.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
[English](README.md) | [繁體中文](README.zh-TW.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [Español](README.es.md) | [Português (BR)](README.pt-BR.md) | [हिन्दी](README.hi.md)
|
|
4
4
|
|
|
5
|
-
[](https://github.com/Poseidoncode/superpowers-mcp)
|
|
6
6
|
[](LICENSE)
|
|
7
7
|
|
|
8
8
|
이 문서는 Superpowers 스킬 라이브러리와 자율 에이전트 워크플로우를 독립적이고 고성능이며 안전한 **Model Context Protocol (MCP)** 서버로 패키징한 사용 지침을 요약한 것입니다.
|
|
@@ -181,7 +181,22 @@ systematic-debugging ➔ using-git-worktrees ➔ dispatching-parallel-agents ➔
|
|
|
181
181
|
|
|
182
182
|
## 🆕 최근 업데이트
|
|
183
183
|
|
|
184
|
-
### v6.4.
|
|
184
|
+
### v6.4.10 (최신)
|
|
185
|
+
|
|
186
|
+
- **설치 `--remove`가 완전해졌습니다** (CWE-459): TOML은 관리되는 모든 `[[mcp_servers.superpowers]]` 배열 테이블과 하위 테이블을, JSON은 동등한 모든 루트 항목을 제거하며, YAML은 값이 채워진 flow map 항목을 제거하고 다른 부모 아래의 중첩된 `mcp_servers:`는 건드리지 않습니다 (`tests/setup_test.js` **100/100**).
|
|
187
|
+
- **`SKILLS_PATH` 소유자 검사** (CWE-22 / CWE-668): POSIX에서는 루트가 존재하는 디렉터리이고 현재 사용자 소유이며 그룹/기타 쓰기 권한이 없어야 합니다. **동작 변경:** Linux의 `/tmp`(`SKILLS_PATH=$(mktemp -d)` 포함)는 거부되어 번들 스킬로 대체되므로 홈 디렉터리 아래 폴더를 사용하세요. macOS의 `/private/var/folders`는 계속 사용할 수 있습니다.
|
|
188
|
+
- **신뢰할 수 없는 입력 제한**: 256자를 넘는 `skill_name`과 `skill://` URI는 거부되며, 오류 메시지와 `stderr`에 되풀이되는 입력은 80자로 잘립니다. 매우 큰 이름으로 인한 응답 증폭을 방지합니다 (`tests/mcp_coverage_test.js`).
|
|
189
|
+
- **메모리 및 블로킹 감소**: brainstorm WebSocket은 분할된 프레임의 청크마다 버퍼를 다시 복사하지 않고, 콘텐츠 캐시 예산은 본문을 매번 다시 측정하는 대신 stat 스냅샷의 크기를 사용하며, `sdd-task-reviewer` / `sdd-re-review`의 리뷰 파일 비교도 이벤트 루프를 막지 않습니다.
|
|
190
|
+
- **저장소 자동화**: `.github/`에 Dependabot(npm + GitHub Actions)과 CI 워크플로를 추가했습니다.
|
|
191
|
+
- 검증: `npm run build` 통과, `npm test` 모두 성공 — **16/23** 스위트 (`pwsh`가 없어 PowerShell **7**개 스위트는 건너뜀).
|
|
192
|
+
|
|
193
|
+
### v6.4.9
|
|
194
|
+
|
|
195
|
+
- **CodeQL 수정 (`list_skills` + YAML setup)**: `escapeListMarkdown`이 ASCII 문장부호를 모두 이스케이프하고 줄바꿈을 접어 신뢰할 수 없는 skill 설명이 `list_skills` 출력에 Markdown·원시 HTML을 주입하지 못하게 함 (`tests/client_truncation_test.js`). YAML 중첩 키 판별은 선형 `isBareYamlMappingKey()`로 대체, 백트래킹 `/:\s*(?:#.*)?$/` 제거 (CodeQL alert #11; `tests/setup_test.js` 고정).
|
|
196
|
+
- **macOS setup allowed-root 검사**: `safeWriteConfig`가 가장 깊은 기존 부모를 통해 설정 경로를 해석해 `/var/folders/...`와 `/private/var/folders/...`를 동일 트리로 취급. macOS 사용자 temp 아래 원클릭 설정 시 잘못된 `Refusing to write configuration outside allowed roots` 거부를 수정 (`tests/setup_test.js` **97/97**).
|
|
197
|
+
- 검증: `npm run build` 통과; `npm test` 그린 — **16/23** 스위트 (`pwsh` 없음으로 PowerShell **7**개 스킵).
|
|
198
|
+
|
|
199
|
+
### v6.4.8
|
|
185
200
|
|
|
186
201
|
- **MCP 클라이언트 응답 한도**: `read_skill`, `list_skills`, 스킬 resource, compositions guide에 반환되는 인라인 스킬 본문을 **20 KB**로 제한해 하나의 큰 `SKILL.md`가 agent 컨텍스트를 고갈시키지 않도록 함 (`tests/client_truncation_test.js`).
|
|
187
202
|
- **스킬 루트 교체 감지** (`EROOTCHANGED`): 시작 시 스킬 디렉터리 inode를 추적. MCP 서버를 재시작하지 않고 `SKILLS_PATH`가 바뀌면 핫 경로 목록/읽기가 fail-closed로 재시작을 안내 (edge-cases Test 15).
|
package/README.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
[English](README.md) | [繁體中文](README.zh-TW.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [Español](README.es.md) | [Português (BR)](README.pt-BR.md) | [हिन्दी](README.hi.md)
|
|
4
4
|
|
|
5
|
-
[](https://github.com/Poseidoncode/superpowers-mcp)
|
|
6
6
|
[](LICENSE)
|
|
7
7
|
|
|
8
8
|
This document summarizes the information and usage instructions for packaging the Superpowers skills and autonomous workflow system into an independent, high-performance, and secure **Model Context Protocol (MCP)** server.
|
|
@@ -182,7 +182,22 @@ To help you choose the right skill, we have structured all 15 skills across the
|
|
|
182
182
|
|
|
183
183
|
## 🆕 Recent Updates
|
|
184
184
|
|
|
185
|
-
### v6.4.
|
|
185
|
+
### v6.4.10 (Latest)
|
|
186
|
+
|
|
187
|
+
- **Setup `--remove` is now complete** (CWE-459): TOML removes every managed `[[mcp_servers.superpowers]]` array table and its subtables, JSON removes every equivalent root entry, and YAML removes populated flow-map entries while leaving a nested `mcp_servers:` under another parent untouched (`tests/setup_test.js` now **100/100**).
|
|
188
|
+
- **`SKILLS_PATH` ownership check** (CWE-22 / CWE-668): on POSIX the root must be an existing directory owned by the current user with no group/world write bits. **Behavior change:** Linux `/tmp` (including `SKILLS_PATH=$(mktemp -d)`) is rejected and falls back to the bundled skills — use a directory under your home. macOS `/private/var/folders` roots still work.
|
|
189
|
+
- **Bounded untrusted input**: `skill_name` and `skill://` URIs over 256 characters are rejected, and error messages / `stderr` clip any echoed input to 80 characters, removing response amplification from multi-megabyte names (`tests/mcp_coverage_test.js`).
|
|
190
|
+
- **Lower memory / blocking**: the brainstorm WebSocket no longer re-copies its buffer on every chunk of a fragmented frame, the content cache budget reads sizes from the stat snapshot instead of re-measuring every body, and review-file comparison for `sdd-task-reviewer` / `sdd-re-review` no longer blocks the event loop.
|
|
191
|
+
- **Repository automation**: Dependabot (npm + GitHub Actions) and a CI workflow are now configured under `.github/`.
|
|
192
|
+
- Verification: `npm run build` passed; `npm test` green — **16/23** suites (**7** PowerShell suites skipped without `pwsh`).
|
|
193
|
+
|
|
194
|
+
### v6.4.9
|
|
195
|
+
|
|
196
|
+
- **CodeQL remediation (`list_skills` + YAML setup)**: `escapeListMarkdown` escapes all ASCII punctuation and collapses line breaks so untrusted skill descriptions cannot inject Markdown or raw HTML in `list_skills` output (`tests/client_truncation_test.js`). YAML nested-key detection uses linear `isBareYamlMappingKey()` instead of a backtracking `/:\s*(?:#.*)?$/` regex (CodeQL alert #11; pinned in `tests/setup_test.js`).
|
|
197
|
+
- **macOS setup allowed-root checks**: `safeWriteConfig` resolves configuration paths through the deepest existing parent so `/var/folders/...` and `/private/var/folders/...` match under allowed-root containment. This fixes false `Refusing to write configuration outside allowed roots` errors during one-click setup when paths sit under the per-user temp tree on macOS (`tests/setup_test.js` now **97/97**).
|
|
198
|
+
- Verification: `npm run build` passed; `npm test` green — **16/23** suites (**7** PowerShell suites skipped without `pwsh`).
|
|
199
|
+
|
|
200
|
+
### v6.4.8
|
|
186
201
|
|
|
187
202
|
- **MCP client response budgets**: Inline skill bodies are capped at **20 KB** for `read_skill`, `list_skills`, skill resources, and the compositions guide so one huge `SKILL.md` cannot exhaust agent context (`tests/client_truncation_test.js`).
|
|
188
203
|
- **Skills root swap detection** (`EROOTCHANGED`): the skills directory inode is tracked at startup; if `SKILLS_PATH` is replaced without restarting the MCP server, hot-path listing and reads fail closed with a restart hint (edge-cases Test 15).
|
|
@@ -198,9 +213,9 @@ To help you choose the right skill, we have structured all 15 skills across the
|
|
|
198
213
|
### v6.4.7
|
|
199
214
|
|
|
200
215
|
- **Full project security scan (2026-10-09)**: `src/*.ts`, the brainstorming companion server, `scripts/`, `esbuild.js`, npm packaging and lockfile integrity, secret/permission hygiene, and every automated suite. Baseline controls re-verified clean — 0 `eval` / `new Function` / `innerHTML` / `document.write` / `shell: true` in shipped source, `child_process` argv-only, 0 hardcoded secrets, 0 world-writable tracked files (details in [SECURITY.md](SECURITY.md)).
|
|
201
|
-
- **`--remove` could report success while a live MCP entry survived** (CWE-459, reproduced by execution): TOML keeps all but the last `[[mcp_servers.superpowers]]` array table and orphans `[[mcp_servers.superpowers.env]]`; JSON clears only the first root key holding a `superpowers` entry; YAML removal is a no-op on a populated flow map `superpowers: {…}`. A caller-chosen `command` therefore keeps auto-launching after an uninstall that reported success.
|
|
202
|
-
- **YAML `--remove` could delete another parent's `superpowers` block** (CWE-459): the new root-level guard covers the empty-map rewrite but not the entry deletion, so a nested `mcp_servers:` under a different top-level key lost its `superpowers` subtree — including user keys such as `env`.
|
|
203
|
-
- **`SKILLS_PATH` containment is a blocklist, not an allowlist** (CWE-22, pre-existing): `~/.ssh`, `~/.config/gh` and `/Users/Shared` are accepted because they exist, while `~/.aws` is rejected only for non-existence. On **Linux** the documented `SKILLS_PATH=$(mktemp -d)` flow resolves to world-writable `/tmp`, so a local user on a shared host can plant skill content the agent then treats as trusted instructions.
|
|
216
|
+
- **`--remove` could report success while a live MCP entry survived** (CWE-459, reproduced by execution): TOML keeps all but the last `[[mcp_servers.superpowers]]` array table and orphans `[[mcp_servers.superpowers.env]]`; JSON clears only the first root key holding a `superpowers` entry; YAML removal is a no-op on a populated flow map `superpowers: {…}`. A caller-chosen `command` therefore keeps auto-launching after an uninstall that reported success. **Remediated in v6.4.10:** TOML removes every managed `[[mcp_servers.superpowers]]` array table plus its subtables, JSON removes every equivalent root entry, and YAML removes populated flow-map entries (regression tests in `tests/setup_test.js`).
|
|
217
|
+
- **YAML `--remove` could delete another parent's `superpowers` block** (CWE-459): the new root-level guard covers the empty-map rewrite but not the entry deletion, so a nested `mcp_servers:` under a different top-level key lost its `superpowers` subtree — including user keys such as `env`. **Remediated in v6.4.10:** only the root-level (column 0) `mcp_servers:` mapping is managed; nested same-named keys and their descendants are left untouched (regression test in `tests/setup_test.js`).
|
|
218
|
+
- **`SKILLS_PATH` containment is a blocklist, not an allowlist** (CWE-22, pre-existing): `~/.ssh`, `~/.config/gh` and `/Users/Shared` are accepted because they exist, while `~/.aws` is rejected only for non-existence. On **Linux** the documented `SKILLS_PATH=$(mktemp -d)` flow resolves to world-writable `/tmp`, so a local user on a shared host can plant skill content the agent then treats as trusted instructions. **Remediated in v6.4.10:** POSIX roots must now be an existing directory owned by the current user with no group/world write bits, and Linux `/tmp` (including `mktemp -d` output) is rejected and falls back to the bundled skills — use a directory under your home instead. On macOS, private roots under `/private/var/folders` are still honored.
|
|
204
219
|
- **`[MODEL]` is no longer dropped for `sdd-task-reviewer` / `sdd-re-review`** (found by this scan, fixed here): both templates spelled that slot `model: [MODEL — REQUIRED: …]`, which carries no literal token, so the caller's `model` value reached the rendered prompt **zero** times and the new diagnostic could not see it. Both now use `model: [MODEL]` plus a `#` comment, matching `implementer-prompt.md`, and are pinned by two fail-without / pass-with assertions.
|
|
205
220
|
- **CodeQL `js/polynomial-redos` #9/#10 closed — the YAML managed-entry matcher was quadratic** (reproduced by execution): `managedEntryPattern` put an optional `{…}` group between two `\s*` runs, so any line it could not complete made the engine retry every split of that whitespace run. No exotic payload is needed — `superpowers:` + a long space run + **one stray character** is an ordinary malformed config line, and a 200 KB line cost **18.3 s** in a single match, stalling `setup`. Replaced by `managedEntryIndent()`, a single-pass scanner: **18.3 s → 0.08 ms**. The accepted-line set is provably unchanged (a **300 030**-line differential fuzz against the removed regex found **0** mismatches), the three sibling patterns were measured linear and left alone, and two new `tests/setup_test.js` cases pin both the timing and the exact accepted set (verified fail-on-vulnerable / pass-on-fixed).
|
|
206
221
|
- **Packaging hardening targets**: `npm pack` does not rebuild (`prepublishOnly` is publish-only and `out/` is gitignored, so a packed tarball ships on-disk `out/*.js` unreviewed — the build belongs in `prepack`); and `files: ["scripts"]` ships the installer, which prefers a co-located `setup.js`.
|
package/README.pt-BR.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
[English](README.md) | [繁體中文](README.zh-TW.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [Español](README.es.md) | [Português (BR)](README.pt-BR.md) | [हिन्दी](README.hi.md)
|
|
4
4
|
|
|
5
|
-
[](https://github.com/Poseidoncode/superpowers-mcp)
|
|
6
6
|
[](LICENSE)
|
|
7
7
|
|
|
8
8
|
Este documento resume as informações e instruções de uso para empacotar as skills do Superpowers e o sistema de fluxos de trabalho autônomos em um servidor **Model Context Protocol (MCP)** independente, de alta performance e seguro.
|
|
@@ -182,7 +182,22 @@ Para ajudar você a escolher a skill certa, estruturamos as 15 skills ao longo d
|
|
|
182
182
|
|
|
183
183
|
## 🆕 Novidades recentes
|
|
184
184
|
|
|
185
|
-
### v6.4.
|
|
185
|
+
### v6.4.10 (atual)
|
|
186
|
+
|
|
187
|
+
- **`--remove` da instalação agora é completo** (CWE-459): TOML remove todas as tabelas de array `[[mcp_servers.superpowers]]` gerenciadas e suas subtabelas, JSON remove todas as entradas raiz equivalentes e YAML remove entradas de flow map preenchidas, preservando um `mcp_servers:` aninhado sob outro pai (`tests/setup_test.js` agora **100/100**).
|
|
188
|
+
- **Verificação de proprietário de `SKILLS_PATH`** (CWE-22 / CWE-668): em POSIX, a raiz deve ser um diretório existente, pertencente ao usuário atual e sem permissão de escrita para grupo/outros. **Mudança de comportamento:** `/tmp` no Linux (incluindo `SKILLS_PATH=$(mktemp -d)`) é rejeitado e as skills incluídas são usadas; use um diretório dentro do seu home. As raízes `/private/var/folders` do macOS continuam funcionando.
|
|
189
|
+
- **Entrada não confiável limitada**: `skill_name` e URIs `skill://` com mais de 256 caracteres são rejeitados, e mensagens de erro e `stderr` cortam em 80 caracteres qualquer entrada repetida, evitando a amplificação de respostas com nomes de vários megabytes (`tests/mcp_coverage_test.js`).
|
|
190
|
+
- **Menos memória e bloqueio**: o WebSocket do brainstorm não recopia mais o buffer a cada fragmento de um frame fragmentado, o orçamento do cache de conteúdo usa o tamanho do snapshot de stat em vez de remedir cada corpo, e a comparação de arquivos de revisão de `sdd-task-reviewer` / `sdd-re-review` não bloqueia mais o event loop.
|
|
191
|
+
- **Automação do repositório**: Dependabot (npm + GitHub Actions) e um workflow de CI foram adicionados em `.github/`.
|
|
192
|
+
- Verificação: `npm run build` passou; `npm test` verde — **16/23** suítes (**7** suítes de PowerShell ignoradas sem `pwsh`).
|
|
193
|
+
|
|
194
|
+
### v6.4.9
|
|
195
|
+
|
|
196
|
+
- **Remediação CodeQL (`list_skills` + YAML setup)**: `escapeListMarkdown` escapa toda pontuação ASCII e colapsa quebras de linha para impedir injeção de Markdown ou HTML bruto em `list_skills` (`tests/client_truncation_test.js`). Detecção de chaves YAML aninhadas usa `isBareYamlMappingKey()` linear no lugar do regex com backtracking `/:\s*(?:#.*)?$/` (alerta CodeQL #11; fixado em `tests/setup_test.js`).
|
|
197
|
+
- **Checagens allowed-root no macOS**: `safeWriteConfig` resolve caminhos de configuração pelo ancestral pai existente mais profundo, para que `/var/folders/...` e `/private/var/folders/...` coincidam na contenção de raízes permitidas. Corrige recusas falsas `Refusing to write configuration outside allowed roots` na configuração com um clique sob o temp por usuário no macOS (`tests/setup_test.js` **97/97**).
|
|
198
|
+
- Verificação: `npm run build` ok; `npm test` verde — **16/23** suítes (**7** PowerShell ignoradas sem `pwsh`).
|
|
199
|
+
|
|
200
|
+
### v6.4.8
|
|
186
201
|
|
|
187
202
|
- **Limites de resposta ao cliente MCP**: corpos inline de skills limitados a **20 KB** em `read_skill`, `list_skills`, resources e o guia de compositions para que um `SKILL.md` enorme não esgote o contexto do agente (`tests/client_truncation_test.js`).
|
|
188
203
|
- **Detecção de troca da raiz de skills** (`EROOTCHANGED`): o inode do diretório de skills é registrado na inicialização; se `SKILLS_PATH` for substituído sem reiniciar o servidor MCP, listagens e leituras em caminho quente falham de forma segura com aviso de reinício (edge-cases Test 15).
|
package/README.zh-TW.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
[English](README.md) | [繁體中文](README.zh-TW.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [Español](README.es.md) | [Português (BR)](README.pt-BR.md) | [हिन्दी](README.hi.md)
|
|
4
4
|
|
|
5
|
-
[](https://github.com/Poseidoncode/superpowers-mcp)
|
|
6
6
|
[](LICENSE)
|
|
7
7
|
|
|
8
8
|
本文檔總結了將 Superpowers 技能庫與自主 Agent 工作流架構打包成獨立、高效能且安全加固的 **Model Context Protocol (MCP)** 伺服器之相關資訊與使用說明。
|
|
@@ -181,7 +181,22 @@ systematic-debugging ➔ using-git-worktrees ➔ dispatching-parallel-agents ➔
|
|
|
181
181
|
|
|
182
182
|
## 🆕 最近更新
|
|
183
183
|
|
|
184
|
-
### v6.4.
|
|
184
|
+
### v6.4.10(最新版)
|
|
185
|
+
|
|
186
|
+
- **安裝程式 `--remove` 現已完整**(CWE-459):TOML 會移除所有受管的 `[[mcp_servers.superpowers]]` 陣列表及其子表,JSON 會移除所有等價的根層項目,YAML 會移除已填入的 flow map 項目,並保留其他父層底下的巢狀 `mcp_servers:`(`tests/setup_test.js` 現為 **100/100**)。
|
|
187
|
+
- **`SKILLS_PATH` 擁有者檢查**(CWE-22 / CWE-668):在 POSIX 上,根目錄必須是現存、由目前使用者擁有且群組/其他人皆無寫入權限的目錄。**行為變更:** Linux 的 `/tmp`(包含 `SKILLS_PATH=$(mktemp -d)`)會被拒絕並退回內建技能,請改用家目錄底下的資料夾。macOS 的 `/private/var/folders` 仍可使用。
|
|
188
|
+
- **限制不受信任的輸入**:超過 256 字元的 `skill_name` 與 `skill://` URI 會被拒絕,錯誤訊息與 `stderr` 回顯的輸入最多截為 80 字元,避免超大名稱造成回應放大(`tests/mcp_coverage_test.js`)。
|
|
189
|
+
- **降低記憶體與阻塞**:brainstorm WebSocket 不再於分段訊框的每個區塊重複複製緩衝區;內容快取預算改用 stat 快照的檔案大小,不再逐一重新計算內容位元組;`sdd-task-reviewer` / `sdd-re-review` 的 review 檔案比對也不再阻塞事件迴圈。
|
|
190
|
+
- **儲存庫自動化**:`.github/` 新增 Dependabot(npm + GitHub Actions)與 CI 工作流程。
|
|
191
|
+
- 驗證:`npm run build` 通過;`npm test` 全綠——**16/23** 套件(**7** 個 PowerShell 因無 `pwsh` 跳過)。
|
|
192
|
+
|
|
193
|
+
### v6.4.9
|
|
194
|
+
|
|
195
|
+
- **CodeQL 修復(`list_skills` + YAML setup)**:`escapeListMarkdown` 會跳脫所有 ASCII 標點並折疊換行,避免不受信任的技能描述在 `list_skills` 輸出中注入 Markdown 或原始 HTML(`tests/client_truncation_test.js`)。YAML 巢狀鍵偵測改為線性 `isBareYamlMappingKey()`,取代會回溯的 `/:\s*(?:#.*)?$/` 正則(CodeQL alert #11;`tests/setup_test.js` 釘住)。
|
|
196
|
+
- **macOS 安裝 allowed-root 檢查**:`safeWriteConfig` 會沿最深一層已存在的父目錄解析設定檔路徑,使 `/var/folders/...` 與 `/private/var/folders/...` 在允許根目錄比對中視為同一路徑,修正 macOS 使用者暫存目錄下一鍵安裝誤報「超出 allowed roots」的問題(`tests/setup_test.js` 現為 **97/97**)。
|
|
197
|
+
- 驗證:`npm run build` 通過;`npm test` 全綠——**16/23** 套件(**7** 個 PowerShell 因無 `pwsh` 跳過)。
|
|
198
|
+
|
|
199
|
+
### v6.4.8
|
|
185
200
|
|
|
186
201
|
- **MCP 客戶端回應上限**:`read_skill`、`list_skills`、技能資源與 compositions guide 的內嵌技能正文上限為 **20 KB**,避免單一巨大 `SKILL.md` 撐爆 agent 上下文(`tests/client_truncation_test.js`)。
|
|
187
202
|
- **技能根目錄替換偵測**(`EROOTCHANGED`):啟動時記錄技能目錄 inode;若未重啟 MCP 即替換 `SKILLS_PATH`,熱路徑清單與讀取會 fail-closed 並提示重啟(edge-cases Test 15)。
|