mustflow 2.112.9 → 2.112.13
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.md +1 -1
- package/dist/cli/commands/contract-lint.js +3 -13
- package/dist/cli/commands/impact.js +2 -12
- package/dist/cli/commands/init.js +39 -14
- package/dist/cli/commands/onboard.js +3 -13
- package/dist/cli/commands/version-sources.js +2 -12
- package/dist/cli/i18n/en.js +6 -0
- package/dist/cli/i18n/es.js +6 -0
- package/dist/cli/i18n/fr.js +6 -0
- package/dist/cli/i18n/hi.js +6 -0
- package/dist/cli/i18n/ko.js +6 -0
- package/dist/cli/i18n/zh.js +6 -0
- package/dist/cli/lib/agent-context.js +2 -1
- package/dist/cli/lib/dashboard-locale.js +6 -0
- package/dist/cli/lib/dashboard-preferences.js +24 -1
- package/dist/cli/lib/preferences-options.js +8 -0
- package/dist/cli/lib/validation/constants.js +3 -1
- package/dist/cli/lib/validation/index.js +10 -1
- package/dist/core/preferences.js +79 -0
- package/dist/core/repo-version-source.js +9 -18
- package/package.json +1 -1
- package/templates/default/common/.mustflow/config/preferences.toml +10 -0
- package/templates/default/i18n.toml +19 -19
- package/templates/default/locales/en/.mustflow/docs/agent-workflow.md +10 -4
- package/templates/default/locales/en/.mustflow/skills/INDEX.md +4 -4
- package/templates/default/locales/en/.mustflow/skills/async-timing-boundary-review/SKILL.md +19 -5
- package/templates/default/locales/en/.mustflow/skills/backend-log-evidence-review/SKILL.md +10 -3
- package/templates/default/locales/en/.mustflow/skills/cache-integrity-review/SKILL.md +63 -21
- package/templates/default/locales/en/.mustflow/skills/concurrency-invariant-review/SKILL.md +13 -3
- package/templates/default/locales/en/.mustflow/skills/cross-platform-filesystem-safety/SKILL.md +10 -9
- package/templates/default/locales/en/.mustflow/skills/dependency-upgrade-review/SKILL.md +8 -3
- package/templates/default/locales/en/.mustflow/skills/memory-lifetime-review/SKILL.md +19 -3
- package/templates/default/locales/en/.mustflow/skills/observability-debuggability-review/SKILL.md +31 -21
- package/templates/default/locales/en/.mustflow/skills/race-condition-review/SKILL.md +38 -25
- package/templates/default/locales/en/.mustflow/skills/repro-first-debug/SKILL.md +43 -10
- package/templates/default/locales/en/.mustflow/skills/routes.toml +4 -4
- package/templates/default/locales/en/.mustflow/skills/security-flow-review/SKILL.md +19 -4
- package/templates/default/locales/en/.mustflow/skills/security-privacy-review/SKILL.md +8 -3
- package/templates/default/locales/en/AGENTS.md +9 -1
- package/templates/default/locales/es/AGENTS.md +2 -0
- package/templates/default/locales/fr/AGENTS.md +2 -0
- package/templates/default/locales/hi/AGENTS.md +2 -0
- package/templates/default/locales/ko/AGENTS.md +3 -1
- package/templates/default/locales/zh/AGENTS.md +2 -0
- package/templates/default/manifest.toml +1 -1
|
@@ -41,6 +41,7 @@ Los detalles gestionados por mustflow se encuentran en `.mustflow/`.
|
|
|
41
41
|
- Usa `mf doctor` o `mf doctor --json` para una revisión de salud de solo lectura antes de cambios amplios.
|
|
42
42
|
- `mf context --json` puede ayudar con orientación legible por máquina, pero no reemplaza las reglas ni la especificación de comandos.
|
|
43
43
|
- Las preferencias en `.mustflow/config/preferences.toml` tienen menor prioridad que las instrucciones directas del usuario y el estilo existente del proyecto.
|
|
44
|
+
- Si este repositorio es un repositorio hijo sin su propio `.mustflow/config/preferences.toml`, hereda como valores predeterminados las preferencias del mustflow root padre más cercano. Esto incluye `[git]`, `[git.commit_message]`, `[release.versioning]`, verification, testing, language, reporting y otras secciones de preferencias. Las preferencias locales del repositorio hijo sobrescriben las del padre campo por campo. No heredes nunca `.mustflow/config/commands.toml`; la autoridad de comandos sigue siendo local del repositorio.
|
|
44
45
|
- Cuando cambies código, plantillas, esquemas, comportamiento de CLI, metadatos de paquete, documentación visible para usuarios, salida de instalación o pruebas, revisa `[release.versioning]` en `.mustflow/config/preferences.toml` antes del informe final. Los archivos de versión solo pueden modificarse según esas preferencias: aplica el aumento automático cuando `auto_bump = true` y `require_user_confirmation = false`; en caso contrario, sugiere el aumento o pide confirmación antes de editar según la configuración. No asumas que la fuente de versión es `package.json`; localiza la fuente propia del repositorio antes de sugerir o editar versiones.
|
|
45
46
|
- Los archivos de contexto en `.mustflow/context/` explican la dirección del proyecto y las convenciones del dominio. Trátalos como contexto específico de la tarea, no como sustituto de código, pruebas, comandos o instrucciones del usuario.
|
|
46
47
|
- Si existe `DESIGN.md`, léelo solo para tareas de interfaz, diseño visual, maquetación, tokens de diseño o accesibilidad. No crees un `DESIGN.md` si no existe.
|
|
@@ -57,6 +58,7 @@ Los detalles gestionados por mustflow se encuentran en `.mustflow/`.
|
|
|
57
58
|
- Si hay conflicto entre reglas de flujo, estilo, pruebas o comandos, sigue el `AGENTS.md` del repositorio hijo y `.mustflow/config/commands.toml`.
|
|
58
59
|
- Las reglas de seguridad sobre secretos, privacidad, comandos destructivos y rutas permitidas de edición son acumulativas. Aplica la regla más estricta.
|
|
59
60
|
- Al entrar en un repositorio anidado, vuelve a leer su `AGENTS.md` y `.mustflow/config/*.toml` antes de editar.
|
|
61
|
+
- Si el repositorio anidado no tiene un archivo local de preferences, aplica las preferences del mustflow padre más cercano como valores heredados mientras sigues obedeciendo el `AGENTS.md` y el command contract del repositorio anidado.
|
|
60
62
|
- No edites fuera del repositorio hijo seleccionado salvo solicitud explícita.
|
|
61
63
|
|
|
62
64
|
## Compatibilidad con Instrucciones del Host
|
|
@@ -41,6 +41,7 @@ Les détails gérés par mustflow se trouvent dans `.mustflow/`.
|
|
|
41
41
|
- Utiliser `mf doctor` ou `mf doctor --json` pour un contrôle de santé en lecture seule avant des changements importants.
|
|
42
42
|
- `mf context --json` peut aider pour une orientation lisible par machine, mais ne remplace pas les règles ni la spécification des commandes.
|
|
43
43
|
- Les préférences dans `.mustflow/config/preferences.toml` ont une priorité plus faible que les instructions utilisateur directes et que le style existant du projet.
|
|
44
|
+
- Si ce dépôt est un dépôt enfant sans son propre `.mustflow/config/preferences.toml`, hériter comme valeurs par défaut des préférences du mustflow root parent le plus proche. Cela inclut `[git]`, `[git.commit_message]`, `[release.versioning]`, verification, testing, language, reporting et les autres sections de préférences. Les préférences locales du dépôt enfant remplacent celles du parent champ par champ. Ne jamais hériter de `.mustflow/config/commands.toml` ; l’autorité de commande reste locale au dépôt.
|
|
44
45
|
- Quand le code, les modèles, les schémas, le comportement CLI, les métadonnées du paquet, la documentation visible par l’utilisateur, la sortie d’installation ou les tests changent, vérifier `[release.versioning]` dans `.mustflow/config/preferences.toml` avant le rapport final.
|
|
45
46
|
Les fichiers de version ne peuvent être modifiés que selon ces préférences : appliquer un changement automatique quand `auto_bump = true` et `require_user_confirmation = false` ; sinon, suggérer le changement ou demander confirmation avant modification selon la configuration. Ne pas supposer que la source de version est `package.json` ; localiser la source de version propre au dépôt avant de suggérer ou d’éditer des versions.
|
|
46
47
|
- Les fichiers de contexte dans `.mustflow/context/` expliquent la direction du projet et les conventions du domaine. Les considérer comme un contexte spécifique à la tâche, pas comme un remplacement du code, des tests, des commandes ou des instructions utilisateur.
|
|
@@ -58,6 +59,7 @@ Les détails gérés par mustflow se trouvent dans `.mustflow/`.
|
|
|
58
59
|
- En cas de conflit entre les règles de flux, de style, de tests ou de commandes, suivre le `AGENTS.md` du dépôt enfant et `.mustflow/config/commands.toml`.
|
|
59
60
|
- Les règles de sécurité sur les secrets, la vie privée, les commandes destructrices et les chemins d’édition autorisés sont cumulatives. Appliquer la règle la plus stricte.
|
|
60
61
|
- Lors de la navigation vers un dépôt imbriqué, relire le `AGENTS.md` de ce dépôt et `.mustflow/config/*.toml` avant d’éditer.
|
|
62
|
+
- Si le dépôt imbriqué n’a pas de fichier preferences local, appliquer les preferences du mustflow parent le plus proche comme valeurs héritées tout en continuant de suivre le `AGENTS.md` et le command contract du dépôt imbriqué.
|
|
61
63
|
- Ne pas éditer en dehors du dépôt enfant sélectionné, sauf demande explicite.
|
|
62
64
|
|
|
63
65
|
## Compatibilité avec les instructions du host
|
|
@@ -41,6 +41,7 @@ mustflow द्वारा प्रबंधित विवरण `.mustflow/
|
|
|
41
41
|
- बड़े बदलावों से पहले read-only स्वास्थ्य जांच के लिए `mf doctor` या `mf doctor --json` चलाएं।
|
|
42
42
|
- `mf context --json` मशीन-पठनीय आउटपुट दे सकता है, लेकिन यह नियम और कमांड विनिर्देशन का विकल्प नहीं है।
|
|
43
43
|
- `.mustflow/config/preferences.toml` की प्राथमिकता सीधे उपयोगकर्ता निर्देशों और मौजूदा परियोजना शैली से कम है।
|
|
44
|
+
- यदि यह repository ऐसी child repository है जिसके पास अपना `.mustflow/config/preferences.toml` नहीं है, तो निकटतम parent mustflow root की preferences को defaults के रूप में inherit करें। इसमें `[git]`, `[git.commit_message]`, `[release.versioning]`, verification, testing, language, reporting, और अन्य preference sections शामिल हैं। child-local preferences parent preferences को field-by-field override करती हैं। `.mustflow/config/commands.toml` को कभी inherit न करें; command authority repository-local command contract में ही रहती है।
|
|
44
45
|
- code, templates, schemas, CLI व्यवहार, package metadata, user-visible docs, installation output, या tests बदलने पर अंतिम रिपोर्ट से पहले `.mustflow/config/preferences.toml` में `[release.versioning]` देखें। version files केवल उन्हीं preferences के अनुसार बदली जा सकती हैं: यदि `auto_bump = true` और `require_user_confirmation = false` हो तो automatic bump लागू करें; अन्यथा configuration के अनुसार bump सुझाएं या संपादन से पहले confirmation मांगें। version source को `package.json` मानकर न चलें; version suggest या edit करने से पहले repository-specific version source खोजें।
|
|
45
46
|
- `.mustflow/context/` की संदर्भ फाइलें परियोजना दिशा और डोमेन परंपराएं बताती हैं। इन्हें कार्य-विशिष्ट संदर्भ के रूप में लें, न कि कोड, परीक्षण, कमांड या उपयोगकर्ता निर्देशों के स्थान पर।
|
|
46
47
|
- यदि `DESIGN.md` मौजूद हो, तो उसे केवल UI, दृश्य डिज़ाइन, लेआउट, design token, या अभिगम्यता कार्य के लिए पढ़ें। यदि `DESIGN.md` नहीं है, तो नई फाइल न बनाएं।
|
|
@@ -57,6 +58,7 @@ mustflow द्वारा प्रबंधित विवरण `.mustflow/
|
|
|
57
58
|
- यदि कार्यप्रवाह, शैली, परीक्षण, या कमांड नियमों में टकराव हो, तो child रिपॉजिटरी के `AGENTS.md` और `.mustflow/config/commands.toml` का पालन करें।
|
|
58
59
|
- secrets, गोपनीयता, destructive commands, और अनुमत संपादन मार्गों के सुरक्षा नियम संचयी होते हैं। अधिक सख्त नियम अपनाएं।
|
|
59
60
|
- nested रिपॉजिटरी में जाने पर संपादन से पहले उसका `AGENTS.md` और `.mustflow/config/*.toml` फिर से पढ़ें।
|
|
61
|
+
- यदि nested repository में local preferences file नहीं है, तो nested repository के `AGENTS.md` और command contract का पालन करते हुए निकटतम parent mustflow preferences को inherited defaults के रूप में लागू करें।
|
|
60
62
|
- स्पष्ट अनुरोध के बिना चुनी हुई child रिपॉजिटरी के बाहर संपादन न करें।
|
|
61
63
|
|
|
62
64
|
## होस्ट-विशिष्ट निर्देश अनुकूलता
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
mustflow_doc: agents.root
|
|
3
3
|
locale: ko
|
|
4
4
|
canonical: false
|
|
5
|
-
revision:
|
|
5
|
+
revision: 28
|
|
6
6
|
lifecycle: user-editable
|
|
7
7
|
authority: binding
|
|
8
8
|
---
|
|
@@ -45,6 +45,7 @@ mustflow가 관리하는 세부 문서와 설정은 `.mustflow/` 폴더 아래
|
|
|
45
45
|
- 수정 전 현재 mustflow 루트 상태와 다음 단계를 빠르게 확인하려면 `mf doctor` 또는 `mf doctor --json`을 사용합니다. 이 명령은 파일을 쓰지 않는 진단용 명령입니다.
|
|
46
46
|
- `mf context --json`은 읽기 전용 컨텍스트 확인 용도로 사용할 수 있으나, 실제 작업 규칙이나 명령 계약을 대체하지 않습니다.
|
|
47
47
|
- `.mustflow/config/preferences.toml`의 선호 설정은 사용자 직접 지시와 기존 파일 스타일보다 낮은 기본값으로 취급합니다.
|
|
48
|
+
- 이 저장소가 자체 `.mustflow/config/preferences.toml`이 없는 하위 저장소라면, 가장 가까운 상위 mustflow 루트의 선호 설정을 기본값으로 상속합니다. 여기에는 `[git]`, `[git.commit_message]`, `[release.versioning]`, verification, testing, language, reporting 및 기타 preference section이 포함됩니다. 하위 저장소의 로컬 preference 값은 상위 값을 field 단위로 덮어씁니다. `.mustflow/config/commands.toml`은 절대 상속하지 않습니다. 명령 실행 권한은 저장소별 command contract에 남아 있어야 합니다.
|
|
48
49
|
- 코드, 템플릿, 스키마, CLI 동작, 패키지 메타데이터, 사용자에게 보이는 문서, 설치 출력, 테스트가 변경되면 최종 보고 전에 `.mustflow/config/preferences.toml`의 `[release.versioning]`을 확인합니다. 버전 파일은 해당 선호 설정에 따라서만 변경할 수 있습니다. `auto_bump = true`이고 `require_user_confirmation = false`이면 자동으로 버전 올림(버전 범프)을 적용하며, 그렇지 않으면 설정에 따라 버전 올림을 제안하거나 수정 전에 사용자 확인을 받습니다. 버전 기준 파일이 `package.json`이라고 가정하지 말고, 제안하거나 수정하기 전에 이 저장소에서 실제 기준으로 사용하는 버전 위치를 반드시 확인합니다.
|
|
49
50
|
- `.mustflow/context/` 파일은 프로젝트 방향과 도메인 약속을 설명하는 작업별 컨텍스트입니다. 코드, 테스트, 명령 계약, 사용자 지시를 대신하는 최종 기준으로 보지 않습니다.
|
|
50
51
|
- `DESIGN.md`가 있으면 UI, 시각 디자인, 레이아웃, 디자인 토큰, 접근성 작업에서만 읽습니다. 없는 `DESIGN.md`를 임의로 생성하지 않습니다.
|
|
@@ -72,6 +73,7 @@ mustflow가 관리하는 세부 문서와 설정은 `.mustflow/` 폴더 아래
|
|
|
72
73
|
- 작업 방식, 코드 스타일, 테스트 방식, 명령 실행 규칙이 충돌할 경우 하위 저장소의 `AGENTS.md`와 `.mustflow/config/commands.toml`을 우선합니다.
|
|
73
74
|
- 보안, 비밀 정보, 개인정보, 파괴적 명령, 수정 가능 경로 등 안전 규칙은 누적 적용하며 더 엄격한 규칙을 따릅니다.
|
|
74
75
|
- 상위 작업 공간에서 하위 저장소로 진입한 경우, 하위 저장소의 `AGENTS.md`와 `.mustflow/config/*.toml`을 다시 읽은 뒤 작업합니다.
|
|
76
|
+
- 하위 저장소에 로컬 preferences 파일이 없다면, 하위 저장소의 `AGENTS.md`와 command contract를 계속 따르면서 가장 가까운 상위 mustflow preferences를 상속 기본값으로 적용합니다.
|
|
75
77
|
- repository farm에서는 각 하위 저장소가 소유한 명령은 해당 저장소의 command contract를 우선합니다. 상위 루트가 하위 저장소를 의도적으로 orchestration해야 한다면 상위 소유 명령을 `.mustflow/config/commands/` 아래 repo 이름별 fragment로 나누고, `mf workspace command-fragments`로 읽기 전용 안내를 확인합니다.
|
|
76
78
|
- 명시적 요청 없이 선택한 하위 저장소 밖의 파일은 수정하지 않습니다.
|
|
77
79
|
|
|
@@ -40,6 +40,7 @@ authority: binding
|
|
|
40
40
|
- 大范围修改前,应使用 `mf doctor` 或 `mf doctor --json` 进行只读健康检查。
|
|
41
41
|
- `mf context --json` 提供机器可读的方向信息,但不能替代规则和命令规范。
|
|
42
42
|
- `.mustflow/config/preferences.toml` 中的偏好优先级低于用户直接指令及项目既有风格。
|
|
43
|
+
- 如果本仓库是没有自己的 `.mustflow/config/preferences.toml` 的子仓库,则把最近的父级 mustflow 根目录中的 preferences 作为默认值继承。继承范围包括 `[git]`、`[git.commit_message]`、`[release.versioning]`、verification、testing、language、reporting 以及其他 preference section。子仓库本地 preference 按字段覆盖父级默认值。绝不要继承 `.mustflow/config/commands.toml`;命令权限仍然是仓库本地的 command contract。
|
|
43
44
|
- 当代码、模板、schema、CLI 行为、包元数据、用户可见文档、安装输出或测试发生变更时,需在最终报告前检查 `.mustflow/config/preferences.toml` 中的 `[release.versioning]`。
|
|
44
45
|
版本文件只能按偏好修改:当 `auto_bump = true` 且 `require_user_confirmation = false` 时,自动升级版本;否则应按配置建议升级或编辑前请求确认。
|
|
45
46
|
不得假设版本来源为 `package.json`,应先定位仓库自身版本来源。
|
|
@@ -58,6 +59,7 @@ authority: binding
|
|
|
58
59
|
- 工作流、风格、测试或命令规则冲突时,遵循子仓库的 `AGENTS.md` 和 `.mustflow/config/commands.toml`。
|
|
59
60
|
- 针对 secrets、隐私、破坏性命令和允许编辑路径的安全规则为累加,执行更严格的规则。
|
|
60
61
|
- 进入嵌套仓库时,编辑前应重新阅读该仓库的 `AGENTS.md` 和 `.mustflow/config/*.toml`。
|
|
62
|
+
- 如果嵌套仓库没有本地 preferences 文件,在继续遵循该仓库 `AGENTS.md` 和 command contract 的同时,使用最近父级 mustflow preferences 作为继承默认值。
|
|
61
63
|
- 未经明确请求,不得编辑所选子仓库之外的内容。
|
|
62
64
|
|
|
63
65
|
## 宿主专用指令兼容性
|