mustflow 2.112.8 → 2.112.10

package/README.md

@@ -401,7 +401,7 @@ npx mf init --set git.auto_commit=true
 - `--agent-lang`: Default language for final agent reports.
 - `--interactive`: Choose init settings via prompts.
 - `--yes`: Use default English init settings without prompts.
-- `--set`: Set an allowed preference during installation. Supported keys include `git.auto_stage`, `git.auto_commit`, `git.auto_push=false`, `git.commit_message.style`, `git.commit_message.language`, `git.commit_message.max_suggestions`, `git.commit_message.include_body`, `git.commit_message.split_when_multiple_concerns`, `reporting.commit_suggestion.enabled`, `language.memory.summary`, and boolean `release.versioning.*` fields such as `release.versioning.suggest_bump=false`, `verification.selection.*` fields, and `testing.authoring.*` fields. Versioning preferences do not assume a fixed version file; agents must locate the repository-specific version source before suggesting or editing versions. Repositories needing an explicit version source can add `.mustflow/config/versioning.toml`; `mf init` does not install this optional file by default. `git.commit_message.style` accepts `conventional`, `descriptive`, or `gitmoji`; `gitmoji` only changes the suggested message format. `git.commit_message.language` accepts `preserve_existing`, `agent_response`, `docs`, or a locale tag such as `ja`, `de`, or `pt-BR`. `testing.authoring.new_test_policy` accepts `evidence_required`, `manual_approval`, or `broad`.
+- `--set`: Set an allowed preference during installation. Supported keys include `git.auto_stage`, `git.auto_commit`, `git.auto_push=false`, `git.commit_message.style`, `git.commit_message.language`, `git.commit_message.max_suggestions`, `git.commit_message.include_body`, `git.commit_message.gitmoji.map`, `git.commit_message.body.template`, `git.commit_message.body.require_validation_line`, `git.commit_message.split_when_multiple_concerns`, `reporting.commit_suggestion.enabled`, `language.memory.summary`, and boolean `release.versioning.*` fields such as `release.versioning.suggest_bump=false`, `verification.selection.*` fields, and `testing.authoring.*` fields. Versioning preferences do not assume a fixed version file; agents must locate the repository-specific version source before suggesting or editing versions. Repositories needing an explicit version source can add `.mustflow/config/versioning.toml`; `mf init` does not install this optional file by default. `git.commit_message.style` accepts `conventional`, `descriptive`, or `gitmoji`; `gitmoji` changes the suggested message format, while `git.commit_message.gitmoji.map=conventional_default` declares the conventional-type-to-Gitmoji mapping (`feat=✨`, `fix=🐛`, `docs=📝`, `refactor=♻️`, `test=✅`, `chore/build/config=🔧`). `git.commit_message.body.template=summary_validation` asks bodies to summarize the change and validation evidence; `git.commit_message.body.require_validation_line` accepts `true` or `false`. `git.commit_message.language` accepts `preserve_existing`, `agent_response`, `docs`, or a locale tag such as `ja`, `de`, or `pt-BR`. `testing.authoring.new_test_policy` accepts `evidence_required`, `manual_approval`, or `broad`.
 - `--product-source-locale`, `--product-locale`: Source and target locales for user-facing product strings.
 - `--lang`: CLI output language. Current values are `en`, `ko`, `zh`, `es`, `fr`, and `hi`.
 

package/dist/cli/commands/init.js

@@ -8,7 +8,7 @@ import { localeMessage, t } from '../lib/i18n.js';
 import { isLocaleTag } from '../lib/locale-tags.js';
 import { MANIFEST_LOCK_RELATIVE_PATH, sha256File } from '../lib/manifest-lock.js';
 import { formatCliOptionParseError, hasCliOptionToken, parseCliOptions } from '../lib/option-parser.js';
-import { isCommitMessageStyle, isTestAuthoringPolicy } from '../lib/preferences-options.js';
+import { isCommitMessageBodyTemplate, isCommitMessageGitmojiMap, isCommitMessageStyle, isTestAuthoringPolicy, } from '../lib/preferences-options.js';
 import { discoverNestedRepositories, getRepoMapConfig } from '../lib/repo-map.js';
 import { getDefaultTemplate, getTemplateFiles } from '../lib/templates.js';
 const MUSTFLOW_BLOCK_START = '<!-- mustflow:start schema=1 -->';
@@ -232,6 +232,43 @@ function createPreferenceOverride(key, value, reporter, lang) {
             renderedValue: tomlString(value),
         };
     }
+    if (key === 'git.commit_message.gitmoji.map') {
+        if (!isCommitMessageGitmojiMap(value)) {
+            reporter.stderr(t(lang, 'init.error.invalidPreferenceValue', { key, value }));
+            return undefined;
+        }
+        return {
+            key,
+            section: 'git.commit_message.gitmoji',
+            field: 'map',
+            renderedValue: tomlString(value),
+        };
+    }
+    if (key === 'git.commit_message.body.template') {
+        if (!isCommitMessageBodyTemplate(value)) {
+            reporter.stderr(t(lang, 'init.error.invalidPreferenceValue', { key, value }));
+            return undefined;
+        }
+        return {
+            key,
+            section: 'git.commit_message.body',
+            field: 'template',
+            renderedValue: tomlString(value),
+        };
+    }
+    if (key === 'git.commit_message.body.require_validation_line') {
+        const parsed = parseBoolean(value);
+        if (parsed === undefined) {
+            reporter.stderr(t(lang, 'init.error.invalidPreferenceValue', { key, value }));
+            return undefined;
+        }
+        return {
+            key,
+            section: 'git.commit_message.body',
+            field: 'require_validation_line',
+            renderedValue: String(parsed),
+        };
+    }
     if (key === 'git.commit_message.split_when_multiple_concerns') {
         const parsed = parseBoolean(value);
         if (parsed === undefined) {

package/dist/cli/i18n/en.js

@@ -512,6 +512,12 @@ export const enMessages = {
     "dashboard.setting.git.commit_message.include_body.description.never": "Never include a commit message body; suggest a subject line only.",
     "dashboard.setting.git.commit_message.include_body.description.when_non_trivial": "Include a body only when the change needs more context than the subject line.",
     "dashboard.setting.git.commit_message.include_body.description.always": "Always include a commit message body in suggestions.",
+    "dashboard.setting.git.commit_message.gitmoji.map": "Gitmoji map",
+    "dashboard.setting.git.commit_message.gitmoji.map.description.conventional_default": "Map conventional types to Gitmoji prefixes: feat=✨, fix=🐛, docs=📝, refactor=♻️, test=✅, chore=🔧.",
+    "dashboard.setting.git.commit_message.body.template": "Commit body template",
+    "dashboard.setting.git.commit_message.body.template.description.summary_validation": "Use a concise body with what changed, why it changed when useful, and validation evidence.",
+    "dashboard.setting.git.commit_message.body.require_validation_line": "Require validation line",
+    "dashboard.setting.git.commit_message.body.require_validation_line.description": "Ask suggested commit bodies to include the checks or evidence used to validate the change.",
     "dashboard.setting.git.commit_message.split_when_multiple_concerns": "Suggest split commits",
     "dashboard.setting.git.commit_message.avoid_sensitive_details": "Avoid sensitive details",
     "dashboard.setting.git.commit_message.avoid_sensitive_details.description": "Avoid secrets, credentials, personal data, and private incident details.",

package/dist/cli/i18n/es.js

@@ -512,6 +512,12 @@ export const esMessages = {
     "dashboard.setting.git.commit_message.include_body.description.never": "No incluye cuerpo en el mensaje de commit; solo sugiere el asunto.",
     "dashboard.setting.git.commit_message.include_body.description.when_non_trivial": "Incluye cuerpo solo cuando el cambio necesita más contexto que el asunto.",
     "dashboard.setting.git.commit_message.include_body.description.always": "Incluye siempre un cuerpo en las sugerencias de mensaje de commit.",
+    "dashboard.setting.git.commit_message.gitmoji.map": "Mapa Gitmoji",
+    "dashboard.setting.git.commit_message.gitmoji.map.description.conventional_default": "Mapea tipos conventional comunes a prefijos Gitmoji: feat, fix, docs, refactor, test y chore.",
+    "dashboard.setting.git.commit_message.body.template": "Plantilla del cuerpo de commit",
+    "dashboard.setting.git.commit_message.body.template.description.summary_validation": "Usa un cuerpo conciso con qué cambió, por qué cambió cuando sea útil y evidencia de validación.",
+    "dashboard.setting.git.commit_message.body.require_validation_line": "Exigir línea de validación",
+    "dashboard.setting.git.commit_message.body.require_validation_line.description": "Pide que los cuerpos sugeridos incluyan las comprobaciones o evidencias usadas para validar el cambio.",
     "dashboard.setting.git.commit_message.split_when_multiple_concerns": "Sugerir commits separados",
     "dashboard.setting.git.commit_message.avoid_sensitive_details": "Evitar detalles sensibles",
     "dashboard.setting.git.commit_message.avoid_sensitive_details.description": "Evita secretos, credenciales, datos personales y detalles privados de incidentes.",

package/dist/cli/i18n/fr.js

@@ -512,6 +512,12 @@ export const frMessages = {
     "dashboard.setting.git.commit_message.include_body.description.never": "N'ajoute jamais de corps au message de commit ; suggère seulement le sujet.",
     "dashboard.setting.git.commit_message.include_body.description.when_non_trivial": "Ajoute un corps seulement quand le changement demande plus de contexte que le sujet.",
     "dashboard.setting.git.commit_message.include_body.description.always": "Ajoute toujours un corps aux suggestions de message de commit.",
+    "dashboard.setting.git.commit_message.gitmoji.map": "Carte Gitmoji",
+    "dashboard.setting.git.commit_message.gitmoji.map.description.conventional_default": "Associe les types conventional courants aux préfixes Gitmoji : feat, fix, docs, refactor, test et chore.",
+    "dashboard.setting.git.commit_message.body.template": "Modèle de corps de commit",
+    "dashboard.setting.git.commit_message.body.template.description.summary_validation": "Utilise un corps concis avec ce qui a changé, pourquoi quand c'est utile, et les preuves de validation.",
+    "dashboard.setting.git.commit_message.body.require_validation_line": "Exiger une ligne de validation",
+    "dashboard.setting.git.commit_message.body.require_validation_line.description": "Demande aux corps suggérés d'inclure les contrôles ou preuves utilisés pour valider le changement.",
     "dashboard.setting.git.commit_message.split_when_multiple_concerns": "Suggérer des commits séparés",
     "dashboard.setting.git.commit_message.avoid_sensitive_details": "Éviter les détails sensibles",
     "dashboard.setting.git.commit_message.avoid_sensitive_details.description": "Évite les secrets, identifiants, données personnelles et détails d'incident privés.",

package/dist/cli/i18n/hi.js

@@ -512,6 +512,12 @@ export const hiMessages = {
     "dashboard.setting.git.commit_message.include_body.description.never": "commit message body कभी न जोड़ें; केवल subject line सुझाएँ।",
     "dashboard.setting.git.commit_message.include_body.description.when_non_trivial": "body तभी जोड़ें जब बदलाव को subject line से अधिक संदर्भ चाहिए।",
     "dashboard.setting.git.commit_message.include_body.description.always": "commit message सुझावों में हमेशा body जोड़ें।",
+    "dashboard.setting.git.commit_message.gitmoji.map": "Gitmoji map",
+    "dashboard.setting.git.commit_message.gitmoji.map.description.conventional_default": "सामान्य conventional types को Gitmoji prefixes से जोड़ें: feat, fix, docs, refactor, test, और chore.",
+    "dashboard.setting.git.commit_message.body.template": "Commit body template",
+    "dashboard.setting.git.commit_message.body.template.description.summary_validation": "क्या बदला, उपयोगी होने पर क्यों बदला, और validation evidence के साथ छोटा body इस्तेमाल करें.",
+    "dashboard.setting.git.commit_message.body.require_validation_line": "Validation line आवश्यक करें",
+    "dashboard.setting.git.commit_message.body.require_validation_line.description": "सुझाए गए commit bodies में बदलाव validate करने वाली checks या evidence शामिल करवाएँ.",
     "dashboard.setting.git.commit_message.split_when_multiple_concerns": "अलग commits सुझाएँ",
     "dashboard.setting.git.commit_message.avoid_sensitive_details": "संवेदनशील विवरण से बचें",
     "dashboard.setting.git.commit_message.avoid_sensitive_details.description": "secrets, credentials, personal data और private incident details से बचें।",

package/dist/cli/i18n/ko.js

@@ -512,6 +512,12 @@ export const koMessages = {
     "dashboard.setting.git.commit_message.include_body.description.never": "커밋 메시지 본문을 넣지 않습니다. 제목 한 줄만 제안합니다.",
     "dashboard.setting.git.commit_message.include_body.description.when_non_trivial": "변경 내용을 제목만으로 설명하기 어려울 때만 본문을 함께 제안합니다.",
     "dashboard.setting.git.commit_message.include_body.description.always": "항상 커밋 메시지 본문을 넣습니다.",
+    "dashboard.setting.git.commit_message.gitmoji.map": "Gitmoji 매핑",
+    "dashboard.setting.git.commit_message.gitmoji.map.description.conventional_default": "conventional 타입을 Gitmoji 접두어에 연결합니다: feat=✨, fix=🐛, docs=📝, refactor=♻️, test=✅, chore=🔧.",
+    "dashboard.setting.git.commit_message.body.template": "커밋 본문 템플릿",
+    "dashboard.setting.git.commit_message.body.template.description.summary_validation": "무엇을 바꿨는지, 필요하면 왜 바꿨는지, 어떤 검증을 했는지 간결한 본문으로 제안합니다.",
+    "dashboard.setting.git.commit_message.body.require_validation_line": "검증 줄 요구",
+    "dashboard.setting.git.commit_message.body.require_validation_line.description": "커밋 본문 제안에 실행한 검사나 검증 근거를 포함하게 합니다.",
     "dashboard.setting.git.commit_message.split_when_multiple_concerns": "여러 주제면 커밋 분리 제안",
     "dashboard.setting.git.commit_message.avoid_sensitive_details": "민감한 세부 정보 제외",
     "dashboard.setting.git.commit_message.avoid_sensitive_details.description": "비밀값, 인증 정보, 개인정보, 비공개 장애 세부사항을 메시지에서 제외합니다.",

package/dist/cli/i18n/zh.js

@@ -512,6 +512,12 @@ export const zhMessages = {
     "dashboard.setting.git.commit_message.include_body.description.never": "不包含提交正文；只建议标题行。",
     "dashboard.setting.git.commit_message.include_body.description.when_non_trivial": "只有当标题行不足以说明变更时，才建议提交正文。",
     "dashboard.setting.git.commit_message.include_body.description.always": "始终在建议中包含提交正文。",
+    "dashboard.setting.git.commit_message.gitmoji.map": "Gitmoji 映射",
+    "dashboard.setting.git.commit_message.gitmoji.map.description.conventional_default": "将常见 conventional 类型映射到 Gitmoji 前缀：feat、fix、docs、refactor、test 和 chore。",
+    "dashboard.setting.git.commit_message.body.template": "提交正文模板",
+    "dashboard.setting.git.commit_message.body.template.description.summary_validation": "使用简洁正文说明改了什么、必要时说明原因，并包含验证证据。",
+    "dashboard.setting.git.commit_message.body.require_validation_line": "要求验证行",
+    "dashboard.setting.git.commit_message.body.require_validation_line.description": "要求建议的提交正文包含用于验证改动的检查或证据。",
     "dashboard.setting.git.commit_message.split_when_multiple_concerns": "建议拆分提交",
     "dashboard.setting.git.commit_message.avoid_sensitive_details": "避免敏感细节",
     "dashboard.setting.git.commit_message.avoid_sensitive_details.description": "避免写入密钥、凭据、个人数据和非公开事故细节。",

package/dist/cli/lib/dashboard-locale.js

@@ -286,6 +286,12 @@ export const DASHBOARD_UI_MESSAGE_KEYS = [
     'dashboard.setting.git.commit_message.include_body.description.never',
     'dashboard.setting.git.commit_message.include_body.description.when_non_trivial',
     'dashboard.setting.git.commit_message.include_body.description.always',
+    'dashboard.setting.git.commit_message.gitmoji.map',
+    'dashboard.setting.git.commit_message.gitmoji.map.description.conventional_default',
+    'dashboard.setting.git.commit_message.body.template',
+    'dashboard.setting.git.commit_message.body.template.description.summary_validation',
+    'dashboard.setting.git.commit_message.body.require_validation_line',
+    'dashboard.setting.git.commit_message.body.require_validation_line.description',
     'dashboard.setting.git.commit_message.split_when_multiple_concerns',
     'dashboard.setting.git.commit_message.avoid_sensitive_details',
     'dashboard.setting.git.commit_message.avoid_sensitive_details.description',

package/dist/cli/lib/dashboard-preferences.js

@@ -4,7 +4,7 @@ import { isRecord } from './command-contract.js';
 import { readUtf8FileInsideWithoutSymlinks, writeUtf8FileInsideWithoutSymlinks } from './filesystem.js';
 import { isLocaleTag } from './locale-tags.js';
 import { ensureManifestLockTargetSafe, markManifestLockFileCustomized } from './manifest-lock.js';
-import { COMMIT_MESSAGE_STYLES, TEST_AUTHORING_POLICIES } from './preferences-options.js';
+import { COMMIT_MESSAGE_BODY_TEMPLATES, COMMIT_MESSAGE_GITMOJI_MAPS, COMMIT_MESSAGE_STYLES, TEST_AUTHORING_POLICIES, } from './preferences-options.js';
 import { parseTomlText } from './toml.js';
 const PREFERENCES_RELATIVE_PATH = '.mustflow/config/preferences.toml';
 export const DASHBOARD_PREFERENCE_SETTINGS = [
@@ -65,6 +65,29 @@ export const DASHBOARD_PREFERENCE_SETTINGS = [
         fallback: 'when_non_trivial',
         options: ['never', 'when_non_trivial', 'always'],
     },
+    {
+        id: 'git.commit_message.gitmoji.map',
+        path: ['git', 'commit_message', 'gitmoji', 'map'],
+        label: 'Gitmoji map',
+        kind: 'select',
+        fallback: 'conventional_default',
+        options: COMMIT_MESSAGE_GITMOJI_MAPS,
+    },
+    {
+        id: 'git.commit_message.body.template',
+        path: ['git', 'commit_message', 'body', 'template'],
+        label: 'Commit body template',
+        kind: 'select',
+        fallback: 'summary_validation',
+        options: COMMIT_MESSAGE_BODY_TEMPLATES,
+    },
+    {
+        id: 'git.commit_message.body.require_validation_line',
+        path: ['git', 'commit_message', 'body', 'require_validation_line'],
+        label: 'Require validation line',
+        kind: 'boolean',
+        fallback: true,
+    },
     {
         id: 'git.commit_message.split_when_multiple_concerns',
         path: ['git', 'commit_message', 'split_when_multiple_concerns'],

package/dist/cli/lib/preferences-options.js

@@ -1,8 +1,16 @@
 export const COMMIT_MESSAGE_STYLES = ['conventional', 'descriptive', 'gitmoji'];
+export const COMMIT_MESSAGE_GITMOJI_MAPS = ['conventional_default'];
+export const COMMIT_MESSAGE_BODY_TEMPLATES = ['summary_validation'];
 export const TEST_AUTHORING_POLICIES = ['evidence_required', 'manual_approval', 'broad'];
 export function isCommitMessageStyle(value) {
     return COMMIT_MESSAGE_STYLES.includes(value);
 }
+export function isCommitMessageGitmojiMap(value) {
+    return COMMIT_MESSAGE_GITMOJI_MAPS.includes(value);
+}
+export function isCommitMessageBodyTemplate(value) {
+    return COMMIT_MESSAGE_BODY_TEMPLATES.includes(value);
+}
 export function isTestAuthoringPolicy(value) {
     return TEST_AUTHORING_POLICIES.includes(value);
 }

package/dist/cli/lib/validation/constants.js

@@ -1,4 +1,4 @@
-import { COMMIT_MESSAGE_STYLES, TEST_AUTHORING_POLICIES } from '../preferences-options.js';
+import { COMMIT_MESSAGE_BODY_TEMPLATES, COMMIT_MESSAGE_GITMOJI_MAPS, COMMIT_MESSAGE_STYLES, TEST_AUTHORING_POLICIES, } from '../preferences-options.js';
 import { VERSION_SOURCE_AUTHORITIES, VERSION_SOURCE_KINDS, } from '../../../core/version-sources.js';
 import { SKILL_ROUTE_CATEGORY_LABELS } from '../../../core/skill-route-alignment.js';
 export { SKILL_ROUTE_CATEGORY_LABELS };
@@ -66,6 +66,8 @@ export const FORBIDDEN_RELEASE_VERSIONING_CONTRACT_FIELDS = [
 export const ALLOWED_VERSION_SOURCE_KINDS = new Set(VERSION_SOURCE_KINDS);
 export const ALLOWED_VERSION_SOURCE_AUTHORITIES = new Set(VERSION_SOURCE_AUTHORITIES);
 export const ALLOWED_COMMIT_MESSAGE_STYLES = new Set(COMMIT_MESSAGE_STYLES);
+export const ALLOWED_COMMIT_MESSAGE_GITMOJI_MAPS = new Set(COMMIT_MESSAGE_GITMOJI_MAPS);
+export const ALLOWED_COMMIT_MESSAGE_BODY_TEMPLATES = new Set(COMMIT_MESSAGE_BODY_TEMPLATES);
 export const VERIFICATION_SELECTION_BOOLEAN_FIELDS = [
     'prefer_related_tests',
     'skip_docs_only_full_test',

package/dist/cli/lib/validation/index.js

@@ -21,7 +21,7 @@ import { VERSIONING_CONFIG_PATH, detectVersionSourcePaths, readDeclaredVersionSo
 import { normalizeTechnologyPreferencesTable, TECHNOLOGY_CONFIG_RELATIVE_PATH, } from '../../../core/technology-preferences.js';
 import { isPromptCacheStableLeafSkillSurface, measurePromptCacheReferenceBlockBytes, } from '../../../core/prompt-cache-rendering.js';
 import { validateSkillRouteFixtures } from '../../../core/skill-route-fixtures.js';
-import { ALLOWED_APPROVAL_ACTIONS, ALLOWED_APPROVAL_GATES, ALLOWED_BUDGET_LIMIT_ACTIONS, ALLOWED_CAPABILITY_STATES, ALLOWED_COMMIT_MESSAGE_STYLES, ALLOWED_COMPACTION_CATEGORIES, ALLOWED_COMPACTION_LONG_LIMIT_ACTIONS, ALLOWED_COMPACTION_RAW_LIMIT_ACTIONS, ALLOWED_COMPACTION_STATE_STORES, ALLOWED_COMPACTION_STRATEGIES, ALLOWED_CONTEXT_AUTHORITIES, ALLOWED_CONTEXT_DOCUMENT_AUTHORITIES, ALLOWED_CONTEXT_READ_POLICIES, ALLOWED_HANDOFF_MODES, ALLOWED_HARNESS_FRESH_CONTEXT_MODES, ALLOWED_HARNESS_MODES, ALLOWED_HARNESS_PHASES, ALLOWED_ISOLATION_PREFERENCES, ALLOWED_MAP_MODES, ALLOWED_MAP_PRIVACY_LEVELS, ALLOWED_PROJECT_PROFILES, ALLOWED_REPO_MAP_DEGRADED_VALUES, ALLOWED_REPO_MAP_GIT_LS_FILES_STATUSES, ALLOWED_REPO_FLOW_DEGRADED_VALUES, ALLOWED_PROMPT_CACHE_STABLE_PREFIX_POLICIES, ALLOWED_PROMPT_CACHE_STRATEGIES, ALLOWED_PROMPT_CACHE_TASK_READ_POLICIES, ALLOWED_REFRESH_CHECKPOINTS, ALLOWED_REFRESH_METHODS, ALLOWED_REFRESH_MODES, ALLOWED_REFRESH_STATE_STORES, ALLOWED_SKILL_RESOURCE_TYPES, ALLOWED_SKILL_ROUTE_CATEGORIES, ALLOWED_SKILL_ROUTE_PROFILES, ALLOWED_SKILL_ROUTE_TYPES, ALLOWED_STALE_TEST_ACTIONS, ALLOWED_TEST_AUTHORING_POLICIES, ALLOWED_TEST_DELETION_REASONS, ALLOWED_TESTING_POLICIES, ALLOWED_TRANSLATION_POLICIES, ALLOWED_VERIFICATION_SELECTION_STRATEGIES, ALLOWED_VERSION_SOURCE_AUTHORITIES, ALLOWED_VERSION_SOURCE_KINDS, CAPABILITY_BOOLEAN_FIELDS, CAPABILITY_STATE_FIELDS, CONTEXT_AUTHORITY_DRIFT_PATTERNS, DESIGN_TOKEN_DEFINITION_PATTERNS, FORBIDDEN_RELEASE_VERSIONING_CONTRACT_FIELDS, FORBIDDEN_TEST_DELETION_REASONS, FORBIDDEN_VERIFICATION_SELECTION_AUTHORITY_FIELDS, LOCAL_ABSOLUTE_PATH_PATTERNS, LOCAL_TASK_STATE_ROOTS, RAW_COMMAND_FENCE_PATTERN, RELEASE_VERSIONING_BOOLEAN_FIELDS, REPO_MAP_DOC_ID, REPO_MAP_GENERATOR, REPO_MAP_LIFECYCLE, REPO_MAP_PRIVACY_MODE, REPO_MAP_RELATIVE_ROOT, REPO_MAP_REMOTE_OR_BRANCH_PATTERNS, REPO_MAP_SOURCE_FINGERPRINT_PATTERN, REPO_MAP_SOURCE_POLICY, REPO_FLOW_DOC_ID, REPO_FLOW_GENERATOR, REPO_FLOW_LIFECYCLE, REPO_FLOW_PRIVACY_MODE, REPO_FLOW_RELATIVE_ROOT, REPO_FLOW_REMOTE_OR_BRANCH_PATTERNS, REPO_FLOW_SOURCE_FINGERPRINT_PATTERN, REPO_FLOW_SOURCE_POLICY, REQUIRED_AGENT_LOOP_PHASES, REQUIRED_SKILL_SCRIPT_RUN_POLICY, REQUIRED_SKILL_SECTION_IDS, ROUTER_INDEX_FILES, ROUTER_INDEX_PROCEDURE_SECTION_PATTERN, SECRET_LIKE_CONTEXT_PATTERNS, SKILL_COMMAND_PERMISSION_CLAIM_PATTERNS, SKILL_INDEX_PATH, SKILL_PACK_ID_PATTERN, SKILL_RESOURCE_MANIFEST, SKILL_RESOURCE_ROOTS, SKILL_RESOURCE_TYPE_BY_ROOT, SKILL_ROUTE_CATEGORY_LABELS, SKILL_ROUTES_METADATA_PATH, SUPPORTED_SKILL_SCHEMA_VERSION, TEST_AUTHORING_BOOLEAN_FIELDS, VERIFICATION_SELECTION_BOOLEAN_FIELDS, VOLATILE_REPO_FLOW_PATTERNS, VOLATILE_REPO_MAP_PATTERNS } from './constants.js';
+import { ALLOWED_APPROVAL_ACTIONS, ALLOWED_APPROVAL_GATES, ALLOWED_BUDGET_LIMIT_ACTIONS, ALLOWED_CAPABILITY_STATES, ALLOWED_COMMIT_MESSAGE_BODY_TEMPLATES, ALLOWED_COMMIT_MESSAGE_GITMOJI_MAPS, ALLOWED_COMMIT_MESSAGE_STYLES, ALLOWED_COMPACTION_CATEGORIES, ALLOWED_COMPACTION_LONG_LIMIT_ACTIONS, ALLOWED_COMPACTION_RAW_LIMIT_ACTIONS, ALLOWED_COMPACTION_STATE_STORES, ALLOWED_COMPACTION_STRATEGIES, ALLOWED_CONTEXT_AUTHORITIES, ALLOWED_CONTEXT_DOCUMENT_AUTHORITIES, ALLOWED_CONTEXT_READ_POLICIES, ALLOWED_HANDOFF_MODES, ALLOWED_HARNESS_FRESH_CONTEXT_MODES, ALLOWED_HARNESS_MODES, ALLOWED_HARNESS_PHASES, ALLOWED_ISOLATION_PREFERENCES, ALLOWED_MAP_MODES, ALLOWED_MAP_PRIVACY_LEVELS, ALLOWED_PROJECT_PROFILES, ALLOWED_REPO_MAP_DEGRADED_VALUES, ALLOWED_REPO_MAP_GIT_LS_FILES_STATUSES, ALLOWED_REPO_FLOW_DEGRADED_VALUES, ALLOWED_PROMPT_CACHE_STABLE_PREFIX_POLICIES, ALLOWED_PROMPT_CACHE_STRATEGIES, ALLOWED_PROMPT_CACHE_TASK_READ_POLICIES, ALLOWED_REFRESH_CHECKPOINTS, ALLOWED_REFRESH_METHODS, ALLOWED_REFRESH_MODES, ALLOWED_REFRESH_STATE_STORES, ALLOWED_SKILL_RESOURCE_TYPES, ALLOWED_SKILL_ROUTE_CATEGORIES, ALLOWED_SKILL_ROUTE_PROFILES, ALLOWED_SKILL_ROUTE_TYPES, ALLOWED_STALE_TEST_ACTIONS, ALLOWED_TEST_AUTHORING_POLICIES, ALLOWED_TEST_DELETION_REASONS, ALLOWED_TESTING_POLICIES, ALLOWED_TRANSLATION_POLICIES, ALLOWED_VERIFICATION_SELECTION_STRATEGIES, ALLOWED_VERSION_SOURCE_AUTHORITIES, ALLOWED_VERSION_SOURCE_KINDS, CAPABILITY_BOOLEAN_FIELDS, CAPABILITY_STATE_FIELDS, CONTEXT_AUTHORITY_DRIFT_PATTERNS, DESIGN_TOKEN_DEFINITION_PATTERNS, FORBIDDEN_RELEASE_VERSIONING_CONTRACT_FIELDS, FORBIDDEN_TEST_DELETION_REASONS, FORBIDDEN_VERIFICATION_SELECTION_AUTHORITY_FIELDS, LOCAL_ABSOLUTE_PATH_PATTERNS, LOCAL_TASK_STATE_ROOTS, RAW_COMMAND_FENCE_PATTERN, RELEASE_VERSIONING_BOOLEAN_FIELDS, REPO_MAP_DOC_ID, REPO_MAP_GENERATOR, REPO_MAP_LIFECYCLE, REPO_MAP_PRIVACY_MODE, REPO_MAP_RELATIVE_ROOT, REPO_MAP_REMOTE_OR_BRANCH_PATTERNS, REPO_MAP_SOURCE_FINGERPRINT_PATTERN, REPO_MAP_SOURCE_POLICY, REPO_FLOW_DOC_ID, REPO_FLOW_GENERATOR, REPO_FLOW_LIFECYCLE, REPO_FLOW_PRIVACY_MODE, REPO_FLOW_RELATIVE_ROOT, REPO_FLOW_REMOTE_OR_BRANCH_PATTERNS, REPO_FLOW_SOURCE_FINGERPRINT_PATTERN, REPO_FLOW_SOURCE_POLICY, REQUIRED_AGENT_LOOP_PHASES, REQUIRED_SKILL_SCRIPT_RUN_POLICY, REQUIRED_SKILL_SECTION_IDS, ROUTER_INDEX_FILES, ROUTER_INDEX_PROCEDURE_SECTION_PATTERN, SECRET_LIKE_CONTEXT_PATTERNS, SKILL_COMMAND_PERMISSION_CLAIM_PATTERNS, SKILL_INDEX_PATH, SKILL_PACK_ID_PATTERN, SKILL_RESOURCE_MANIFEST, SKILL_RESOURCE_ROOTS, SKILL_RESOURCE_TYPE_BY_ROOT, SKILL_ROUTE_CATEGORY_LABELS, SKILL_ROUTES_METADATA_PATH, SUPPORTED_SKILL_SCHEMA_VERSION, TEST_AUTHORING_BOOLEAN_FIELDS, VERIFICATION_SELECTION_BOOLEAN_FIELDS, VOLATILE_REPO_FLOW_PATTERNS, VOLATILE_REPO_MAP_PATTERNS } from './constants.js';
 import { hasOwn, isPositiveInteger, isSafeRelativePath, pushStrictIssue, pushStrictWarning, validateAllowedStringField, validateBooleanField, validateExactStringArrayField, validateNestedTable, validatePathArrayField, validatePathField, validatePositiveIntegerField, validateRequiredFiles, validateRequiredPathField, validateRequiredStringField, validateStringArrayField, validateStringArrayMembers, validateStringField, validateTable, validateToml, validateWorkspaceRoots } from './primitives.js';
 import { isConfiguredCommandIntent, isDeclaredCommandIntent } from './command-intents.js';
 import { parseSimpleFrontmatter, readFrontmatterList, readSkillSectionIds } from './frontmatter.js';
@@ -364,6 +364,15 @@ function validatePreferencesConfig(preferencesToml, issues) {
             validatePositiveIntegerField(commitMessage, 'max_suggestions', '[preferences.git.commit_message].max_suggestions', issues);
             validateBooleanField(commitMessage, 'split_when_multiple_concerns', '[preferences.git.commit_message].split_when_multiple_concerns', issues);
             validateBooleanField(commitMessage, 'avoid_sensitive_details', '[preferences.git.commit_message].avoid_sensitive_details', issues);
+            const commitMessageGitmoji = validateNestedTable(commitMessage, 'gitmoji', '[preferences.git.commit_message.gitmoji]', issues);
+            if (commitMessageGitmoji) {
+                validateAllowedStringField(commitMessageGitmoji, 'map', '[preferences.git.commit_message.gitmoji].map', ALLOWED_COMMIT_MESSAGE_GITMOJI_MAPS, issues);
+            }
+            const commitMessageBody = validateNestedTable(commitMessage, 'body', '[preferences.git.commit_message.body]', issues);
+            if (commitMessageBody) {
+                validateAllowedStringField(commitMessageBody, 'template', '[preferences.git.commit_message.body].template', ALLOWED_COMMIT_MESSAGE_BODY_TEMPLATES, issues);
+                validateBooleanField(commitMessageBody, 'require_validation_line', '[preferences.git.commit_message.body].require_validation_line', issues);
+            }
         }
     }
     const reporting = validateTable(preferencesToml, 'reporting', issues);

package/dist/core/active-run-locks.js

@@ -9,6 +9,7 @@ const LOCK_ROOT_RELATIVE_PATH = '.mustflow/state/locks';
 export const ACTIVE_RUN_LOCK_ID_ENV = 'MUSTFLOW_ACTIVE_RUN_LOCK_ID';
 const LOCK_MUTEX_STALE_MS = 30_000;
 const LOCK_MUTEX_WAIT_MS = 1_000;
+const RUN_STATE_UPDATE_MUTEX_WAIT_MS = 35_000;
 const LOCK_MUTEX_SLEEP_MS = 25;
 const LOCK_MUTEX_SLEEP_BUFFER = new Int32Array(new SharedArrayBuffer(4));
 const LOCK_MUTEX_RECOVERY_DIRECTORY = 'mutex.recovery';
@@ -342,13 +343,14 @@ function recoverStaleMutexWithoutOwner(mutex) {
         releaseRecovery();
     }
 }
-function acquireMutex(projectRoot) {
+function acquireMutex(projectRoot, options = {}) {
     const root = activeLockRoot(projectRoot);
     const mutex = activeLockMutexDirectory(projectRoot);
     const ownerPath = path.join(mutex, 'owner.json');
     const ownerToken = sha256(`${process.pid}:${Date.now()}:${process.hrtime.bigint()}`);
     mkdirSync(root, { recursive: true });
     const startedAt = Date.now();
+    const waitMs = options.waitMs ?? LOCK_MUTEX_WAIT_MS;
     while (true) {
         try {
             mkdirSync(mutex);
@@ -378,7 +380,7 @@ function acquireMutex(projectRoot) {
             if (!error || typeof error !== 'object' || !('code' in error) || error.code !== 'EEXIST') {
                 throw error;
             }
-            if (Date.now() - startedAt > LOCK_MUTEX_WAIT_MS) {
+            if (Date.now() - startedAt > waitMs) {
                 const owner = readMutexOwner(ownerPath);
                 if (owner) {
                     if (mutexOwnerIsStale(owner) && recoverStaleMutexWithOwner(mutex, ownerPath, owner)) {
@@ -414,6 +416,15 @@ function acquireMutex(projectRoot) {
         }
     }
 }
+export function withRunStateUpdateMutex(projectRoot, callback) {
+    const releaseMutex = acquireMutex(projectRoot, { waitMs: RUN_STATE_UPDATE_MUTEX_WAIT_MS });
+    try {
+        return callback();
+    }
+    finally {
+        releaseMutex();
+    }
+}
 export function inspectActiveRunLocks(projectRoot, contract, intentName) {
     const effects = normalizeCommandEffects(projectRoot, contract, intentName);
     const records = readActiveRecords(projectRoot);

package/dist/core/run-performance-history.js

@@ -1,5 +1,6 @@
 import { existsSync, readFileSync } from 'node:fs';
 import path from 'node:path';
+import { withRunStateUpdateMutex } from './active-run-locks.js';
 import { writeJsonFileInsideWithoutSymlinks } from './safe-filesystem.js';
 const PERFORMANCE_HISTORY_SCHEMA_VERSION = '1';
 const PERFORMANCE_HISTORY_DIR = path.join('.mustflow', 'state', 'perf');
@@ -318,14 +319,16 @@ export function recordRunPerformanceHistory(projectRoot, receipt) {
         return;
     }
     try {
-        const historyDir = path.join(projectRoot, PERFORMANCE_HISTORY_DIR);
-        const samplesPath = path.join(historyDir, PERFORMANCE_SAMPLES_FILE);
-        const summaryPath = path.join(historyDir, PERFORMANCE_SUMMARY_FILE);
-        const samples = enforceSizeLimit(pruneSamples([...readSamples(samplesPath), sample], sample.observed_day), sample.observed_day);
-        const samplesFile = createSamplesFile(samples);
-        const summaryFile = createSummary(samples, sample.observed_day);
-        writeJsonFileInsideWithoutSymlinks(projectRoot, samplesPath, samplesFile);
-        writeJsonFileInsideWithoutSymlinks(projectRoot, summaryPath, summaryFile);
+        withRunStateUpdateMutex(projectRoot, () => {
+            const historyDir = path.join(projectRoot, PERFORMANCE_HISTORY_DIR);
+            const samplesPath = path.join(historyDir, PERFORMANCE_SAMPLES_FILE);
+            const summaryPath = path.join(historyDir, PERFORMANCE_SUMMARY_FILE);
+            const samples = enforceSizeLimit(pruneSamples([...readSamples(samplesPath), sample], sample.observed_day), sample.observed_day);
+            const samplesFile = createSamplesFile(samples);
+            const summaryFile = createSummary(samples, sample.observed_day);
+            writeJsonFileInsideWithoutSymlinks(projectRoot, samplesPath, samplesFile);
+            writeJsonFileInsideWithoutSymlinks(projectRoot, summaryPath, summaryFile);
+        });
     }
     catch {
         // Performance history is a local optimization hint. A write failure must not affect command execution.

package/dist/core/run-profile.js

@@ -1,5 +1,6 @@
 import { performance } from 'node:perf_hooks';
 import path from 'node:path';
+import { withRunStateUpdateMutex } from './active-run-locks.js';
 import { writeJsonFileInsideWithoutSymlinks } from './safe-filesystem.js';
 const RUN_PROFILE_SCHEMA_VERSION = '1';
 const RUN_PROFILE_ENV = 'MUSTFLOW_RUN_PROFILE';
@@ -75,7 +76,9 @@ export class RunProfiler {
             profile_path: getProfileRelativePath(),
         };
         const profilePath = path.join(input.projectRoot, RUN_PROFILE_DIR, LATEST_RUN_PROFILE);
-        writeJsonFileInsideWithoutSymlinks(input.projectRoot, profilePath, profile);
+        withRunStateUpdateMutex(input.projectRoot, () => {
+            writeJsonFileInsideWithoutSymlinks(input.projectRoot, profilePath, profile);
+        });
     }
     recordPhase(name, startedAtMs) {
         this.phases.push({

package/dist/core/run-receipt.js

@@ -1,5 +1,6 @@
 import { createHash } from 'node:crypto';
 import path from 'node:path';
+import { withRunStateUpdateMutex } from './active-run-locks.js';
 import { createStateRunId } from './atomic-state-write.js';
 import { COMMAND_OUTPUT_LIMIT_SCOPE } from './command-output-limits.js';
 import { decodeUtf8Tail } from './bounded-output.js';
@@ -295,9 +296,11 @@ export function writeRunReceipt(projectRoot, receipt, policy) {
     if (relativeToRunDir.startsWith('..') || path.isAbsolute(relativeToRunDir)) {
         throw new Error(`Run receipt path must stay inside ${RUN_RECEIPT_DIR}`);
     }
-    writeJsonFileInsideWithoutSymlinks(projectRoot, receiptPath, receipt);
-    writeJsonFileInsideWithoutSymlinks(projectRoot, latestPath, receipt);
-    if (policy) {
-        updateRunReceiptState(projectRoot, policy);
-    }
+    withRunStateUpdateMutex(projectRoot, () => {
+        writeJsonFileInsideWithoutSymlinks(projectRoot, receiptPath, receipt);
+        writeJsonFileInsideWithoutSymlinks(projectRoot, latestPath, receipt);
+        if (policy) {
+            updateRunReceiptState(projectRoot, policy);
+        }
+    });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mustflow",
-  "version": "2.112.8",
+  "version": "2.112.10",
   "description": "Agent workflow documents and CLI for mustflow repository roots.",
   "type": "module",
   "license": "MIT-0",

package/templates/default/common/.mustflow/config/preferences.toml

@@ -75,6 +75,16 @@ include_body = "when_non_trivial"
 split_when_multiple_concerns = true
 avoid_sensitive_details = true
 
+[git.commit_message.gitmoji]
+# conventional_default maps common conventional types to Gitmoji prefixes:
+# feat=✨, fix=🐛, docs=📝, refactor=♻️, test=✅, chore/build/config=🔧.
+map = "conventional_default"
+
+[git.commit_message.body]
+# summary_validation keeps suggested bodies concise and evidence-backed.
+template = "summary_validation"
+require_validation_line = true
+
 [reporting.commit_suggestion]
 enabled = true
 when = "files_changed"

package/templates/default/manifest.toml

@@ -1,6 +1,6 @@
 id = "default"
 name = "default"
-version = "2.112.8"
+version = "2.112.10"
 description = "Minimal workflow for LLM agents to read, edit, and verify their work in a repository."
 common_root = "common"
 locales_root = "locales"