mustflow 2.112.9 → 2.112.13

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/contract-lint.js

@@ -1,13 +1,11 @@
-import { existsSync } from 'node:fs';
-import path from 'node:path';
 import { lintCommandContract } from '../../core/contract-lint.js';
-import { readCommandContract, isRecord } from '../../core/config-loading.js';
+import { readCommandContract } from '../../core/config-loading.js';
+import { readEffectivePreferencesToml } from '../../core/preferences.js';
 import { releaseVersioningIsEnabled } from '../../core/version-sources.js';
 import { printUsageError, renderHelp } from '../lib/cli-output.js';
 import { t } from '../lib/i18n.js';
 import { formatCliOptionParseError, hasCliOptionToken, hasParsedCliOption, parseCliOptions, } from '../lib/option-parser.js';
 import { resolveMustflowRoot } from '../lib/project-root.js';
-import { readMustflowTomlFile } from '../lib/toml.js';
 const CONTRACT_LINT_SCHEMA_VERSION = '1';
 const CONTRACT_LINT_OPTIONS = [
     { name: '--coverage', kind: 'boolean' },
@@ -31,14 +29,6 @@ export function getContractLintHelp(lang = 'en') {
         ],
     }, lang);
 }
-function readPreferences(projectRoot) {
-    const preferencesPath = path.join(projectRoot, '.mustflow', 'config', 'preferences.toml');
-    if (!existsSync(preferencesPath)) {
-        return undefined;
-    }
-    const preferences = readMustflowTomlFile(projectRoot, '.mustflow/config/preferences.toml');
-    return isRecord(preferences) ? preferences : undefined;
-}
 function createContractLintOutput(projectRoot, coverage, suggest) {
     return {
         schema_version: CONTRACT_LINT_SCHEMA_VERSION,
@@ -48,7 +38,7 @@ function createContractLintOutput(projectRoot, coverage, suggest) {
             coverage,
             suggest,
             projectRoot,
-            releaseVersioningEnabled: releaseVersioningIsEnabled(readPreferences(projectRoot)),
+            releaseVersioningEnabled: releaseVersioningIsEnabled(readEffectivePreferencesToml(projectRoot)),
         }),
     };
 }

package/dist/cli/commands/impact.js

@@ -1,12 +1,11 @@
 import { createChangeClassificationReport } from '../../core/change-classification.js';
+import { readEffectivePreferencesToml } from '../../core/preferences.js';
 import { summarizeVersionImpact } from '../../core/version-impact.js';
 import { printUsageError, renderHelp } from '../lib/cli-output.js';
-import { isRecord } from '../lib/command-contract.js';
 import { requireGitChangedFiles } from '../lib/git-changes.js';
 import { t } from '../lib/i18n.js';
 import { formatCliOptionParseError, hasCliOptionToken, hasParsedCliOption, parseCliOptions, } from '../lib/option-parser.js';
 import { resolveMustflowRoot } from '../lib/project-root.js';
-import { readMustflowTomlFile } from '../lib/toml.js';
 import { detectVersionSources, releaseVersioningIsEnabled, } from '../../core/version-sources.js';
 const IMPACT_SCHEMA_VERSION = '1';
 const IMPACT_OPTIONS = [
@@ -38,15 +37,6 @@ function parseImpactArgs(args) {
         error: parsed.error,
     };
 }
-function readPreferences(projectRoot) {
-    try {
-        const preferences = readMustflowTomlFile(projectRoot, '.mustflow/config/preferences.toml');
-        return isRecord(preferences) ? preferences : undefined;
-    }
-    catch {
-        return undefined;
-    }
-}
 function createImpactOutput(projectRoot, parsed) {
     const source = parsed.changed ? 'changed' : 'paths';
     const files = parsed.changed ? requireGitChangedFiles(projectRoot) : parsed.paths;
@@ -58,7 +48,7 @@ function createImpactOutput(projectRoot, parsed) {
         mustflow_root: projectRoot,
         source,
         files: classificationReport.files,
-        versioning_enabled: releaseVersioningIsEnabled(readPreferences(projectRoot)),
+        versioning_enabled: releaseVersioningIsEnabled(readEffectivePreferencesToml(projectRoot)),
         version_sources: versionSources,
         classification_summary: classificationReport.summary,
         version_impact: summarizeVersionImpact(classificationReport, versionSources),

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 -->';
@@ -158,7 +158,7 @@ const VERIFICATION_SELECTION_BOOLEAN_FIELDS = new Set([
 ]);
 const TEST_AUTHORING_BOOLEAN_FIELDS = new Set(['prefer_existing_tests', 'require_new_test_rationale']);
 function createPreferenceOverride(key, value, reporter, lang) {
-    if (key === 'git.auto_stage' || key === 'git.auto_commit') {
+    if (key === 'git.auto_stage' || key === 'git.auto_commit' || key === 'git.auto_push') {
         const parsed = parseBoolean(value);
         if (parsed === undefined) {
             reporter.stderr(t(lang, 'init.error.invalidPreferenceValue', { key, value }));
@@ -171,18 +171,6 @@ function createPreferenceOverride(key, value, reporter, lang) {
             renderedValue: String(parsed),
         };
     }
-    if (key === 'git.auto_push') {
-        if (value !== 'false') {
-            reporter.stderr(t(lang, 'init.error.invalidPreferenceValue', { key, value }));
-            return undefined;
-        }
-        return {
-            key,
-            section: 'git',
-            field: 'auto_push',
-            renderedValue: 'false',
-        };
-    }
     if (key === 'git.commit_message.language') {
         if (!isSupportedLanguagePreference(value)) {
             reporter.stderr(t(lang, 'init.error.invalidPreferenceValue', { key, value }));
@@ -232,6 +220,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/commands/onboard.js

@@ -1,13 +1,11 @@
-import { existsSync } from 'node:fs';
-import path from 'node:path';
 import { lintCommandContract, } from '../../core/contract-lint.js';
-import { isRecord, readCommandContract, } from '../../core/config-loading.js';
+import { readCommandContract } from '../../core/config-loading.js';
+import { readEffectivePreferencesToml } from '../../core/preferences.js';
 import { releaseVersioningIsEnabled } from '../../core/version-sources.js';
 import { printUsageError, renderHelp } from '../lib/cli-output.js';
 import { t } from '../lib/i18n.js';
 import { formatCliOptionParseError, hasCliOptionToken, hasParsedCliOption, parseCliOptions, } from '../lib/option-parser.js';
 import { resolveMustflowRoot } from '../lib/project-root.js';
-import { readMustflowTomlFile } from '../lib/toml.js';
 const ONBOARD_COMMANDS_SCHEMA_VERSION = '1';
 const COMMAND_CONTRACT_PATH = '.mustflow/config/commands.toml';
 const ONBOARD_COMMANDS_OPTIONS = [
@@ -28,14 +26,6 @@ export function getOnboardHelp(lang = 'en') {
         ],
     }, lang);
 }
-function readPreferences(projectRoot) {
-    const preferencesPath = path.join(projectRoot, '.mustflow', 'config', 'preferences.toml');
-    if (!existsSync(preferencesPath)) {
-        return undefined;
-    }
-    const preferences = readMustflowTomlFile(projectRoot, '.mustflow/config/preferences.toml');
-    return isRecord(preferences) ? preferences : undefined;
-}
 function countSuggestionsByKind(suggestions, sourceKind) {
     return suggestions.filter((suggestion) => suggestion.sourceKind === sourceKind).length;
 }
@@ -56,7 +46,7 @@ function createOnboardCommandsOutput(projectRoot) {
     const report = lintCommandContract(readCommandContract(projectRoot), {
         suggest: true,
         projectRoot,
-        releaseVersioningEnabled: releaseVersioningIsEnabled(readPreferences(projectRoot)),
+        releaseVersioningEnabled: releaseVersioningIsEnabled(readEffectivePreferencesToml(projectRoot)),
     });
     const suggestions = report.suggestions ?? [];
     return {

package/dist/cli/commands/version-sources.js

@@ -1,9 +1,8 @@
+import { readEffectivePreferencesToml } from '../../core/preferences.js';
 import { printUsageError, renderHelp } from '../lib/cli-output.js';
-import { isRecord } from '../lib/command-contract.js';
 import { t } from '../lib/i18n.js';
 import { formatCliOptionParseError, hasCliOptionToken, hasParsedCliOption, parseCliOptions, } from '../lib/option-parser.js';
 import { resolveMustflowRoot } from '../lib/project-root.js';
-import { readMustflowTomlFile } from '../lib/toml.js';
 import { detectVersionSources, releaseVersioningIsEnabled, } from '../../core/version-sources.js';
 const VERSION_SOURCES_SCHEMA_VERSION = '1';
 const VERSION_SOURCES_OPTIONS = [
@@ -24,17 +23,8 @@ export function getVersionSourcesHelp(lang = 'en') {
         ],
     }, lang);
 }
-function readPreferences(projectRoot) {
-    try {
-        const preferences = readMustflowTomlFile(projectRoot, '.mustflow/config/preferences.toml');
-        return isRecord(preferences) ? preferences : undefined;
-    }
-    catch {
-        return undefined;
-    }
-}
 function getVersionSourcesOutput(projectRoot) {
-    const preferences = readPreferences(projectRoot);
+    const preferences = readEffectivePreferencesToml(projectRoot);
     return {
         schema_version: VERSION_SOURCES_SCHEMA_VERSION,
         command: 'version-sources',

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/agent-context.js

@@ -10,6 +10,7 @@ import { MUSTFLOW_JSON_MAX_BYTES, readMustflowTextFile, readMustflowTextFileIfEx
 import { createRunPlan } from './run-plan.js';
 import { readMustflowTomlFile } from './toml.js';
 import { normalizeTechnologyPreferencesTable, TECHNOLOGY_CONFIG_RELATIVE_PATH, } from '../../core/technology-preferences.js';
+import { readEffectivePreferencesToml } from '../../core/preferences.js';
 import { isPromptCacheStableLeafSkillSurface, measurePromptCacheReferenceBlockBytes, renderPromptCacheReferenceBlock, } from '../../core/prompt-cache-rendering.js';
 import { resolveSkillRoutes } from '../../core/skill-route-resolution.js';
 const CONTEXT_SCHEMA_VERSION = '1';
@@ -1487,7 +1488,7 @@ export async function getPromptCacheProfileContext(projectRoot, profile, options
 }
 export function getAgentContext(projectRoot) {
     const mustflow = readTomlTableIfExists(projectRoot, MUSTFLOW_RELATIVE_PATH);
-    const preferences = readTomlTableIfExists(projectRoot, PREFERENCES_RELATIVE_PATH);
+    const preferences = readEffectivePreferencesToml(projectRoot);
     const authority = isRecord(mustflow?.authority) ? mustflow.authority : undefined;
     const capabilities = isRecord(mustflow?.capabilities) ? mustflow.capabilities : undefined;
     const readOrder = mustflow ? readStringArray(mustflow, 'read_order') ?? [] : [];

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/preferences.js

@@ -0,0 +1,79 @@
+import { existsSync } from 'node:fs';
+import path from 'node:path';
+import { isRecord, readMustflowOwnedTomlFile, } from './config-loading.js';
+export const PREFERENCES_CONFIG_RELATIVE_PATH = '.mustflow/config/preferences.toml';
+function hasMustflowMarker(directoryPath) {
+    return (existsSync(path.join(directoryPath, '.mustflow', 'config', 'mustflow.toml')) ||
+        existsSync(path.join(directoryPath, '.mustflow', 'config', 'commands.toml')));
+}
+function preferencesPath(projectRoot) {
+    return path.join(projectRoot, ...PREFERENCES_CONFIG_RELATIVE_PATH.split('/'));
+}
+function readPreferencesAtRoot(projectRoot) {
+    if (!existsSync(preferencesPath(projectRoot))) {
+        return undefined;
+    }
+    const parsed = readMustflowOwnedTomlFile(projectRoot, PREFERENCES_CONFIG_RELATIVE_PATH);
+    return isRecord(parsed) ? parsed : undefined;
+}
+function parentMustflowRoots(projectRoot) {
+    const roots = [];
+    let current = path.dirname(path.resolve(projectRoot));
+    while (true) {
+        if (hasMustflowMarker(current)) {
+            roots.push(current);
+        }
+        const parent = path.dirname(current);
+        if (parent === current) {
+            return roots;
+        }
+        current = parent;
+    }
+}
+function clonePreferenceValue(value) {
+    if (Array.isArray(value)) {
+        return value.map((entry) => clonePreferenceValue(entry));
+    }
+    if (isRecord(value)) {
+        return mergePreferenceTables({}, value);
+    }
+    return value;
+}
+function mergePreferenceTables(base, override) {
+    const merged = {};
+    for (const [key, value] of Object.entries(base)) {
+        merged[key] = clonePreferenceValue(value);
+    }
+    for (const [key, value] of Object.entries(override)) {
+        const existing = merged[key];
+        if (isRecord(existing) && isRecord(value)) {
+            merged[key] = mergePreferenceTables(existing, value);
+        }
+        else {
+            merged[key] = clonePreferenceValue(value);
+        }
+    }
+    return merged;
+}
+export function readLocalPreferencesToml(projectRoot) {
+    return readPreferencesAtRoot(projectRoot);
+}
+/**
+ * mf:anchor core.preferences.inheritance
+ * purpose: Resolve low-authority workflow preferences across nested mustflow roots.
+ * search: preferences inheritance, parent workspace defaults, git auto push, release versioning
+ * invariant: Parent preferences are defaults only; child-local values override field by field, and command contracts are never inherited here.
+ * risk: config
+ */
+export function readEffectivePreferencesToml(projectRoot) {
+    const roots = [...parentMustflowRoots(projectRoot).reverse(), path.resolve(projectRoot)];
+    let effective;
+    for (const root of roots) {
+        const preferences = readPreferencesAtRoot(root);
+        if (!preferences) {
+            continue;
+        }
+        effective = effective ? mergePreferenceTables(effective, preferences) : mergePreferenceTables({}, preferences);
+    }
+    return effective;
+}

package/dist/core/repo-version-source.js

@@ -1,7 +1,6 @@
 import { createHash } from 'node:crypto';
-import { existsSync } from 'node:fs';
 import path from 'node:path';
-import { isRecord, readMustflowOwnedTomlFile } from './config-loading.js';
+import { readEffectivePreferencesToml } from './preferences.js';
 import { detectVersionSources, releaseVersioningIsEnabled, VERSIONING_CONFIG_PATH, } from './version-sources.js';
 export const REPO_VERSION_SOURCE_PACK_ID = 'repo';
 export const REPO_VERSION_SOURCE_SCRIPT_ID = 'version-source';
@@ -10,21 +9,6 @@ export const REPO_VERSION_SOURCE_PREFERENCES_PATH = '.mustflow/config/preference
 function sha256(value) {
     return `sha256:${createHash('sha256').update(value).digest('hex')}`;
 }
-function readPreferences(projectRoot, issues) {
-    const preferencesPath = path.join(projectRoot, ...REPO_VERSION_SOURCE_PREFERENCES_PATH.split('/'));
-    if (!existsSync(preferencesPath)) {
-        return undefined;
-    }
-    try {
-        const parsed = readMustflowOwnedTomlFile(projectRoot, REPO_VERSION_SOURCE_PREFERENCES_PATH);
-        return isRecord(parsed) ? parsed : undefined;
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        issues.push(`Could not read ${REPO_VERSION_SOURCE_PREFERENCES_PATH}: ${message}`);
-        return undefined;
-    }
-}
 function countSources(sources) {
     return {
         sources: sources.length,
@@ -40,7 +24,14 @@ function createInputHash(reportInput) {
 export function inspectRepoVersionSource(projectRoot) {
     const root = path.resolve(projectRoot);
     const issues = [];
-    const preferences = readPreferences(root, issues);
+    let preferences;
+    try {
+        preferences = readEffectivePreferencesToml(root);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        issues.push(`Could not read local or inherited ${REPO_VERSION_SOURCE_PREFERENCES_PATH}: ${message}`);
+    }
     const versioningEnabled = releaseVersioningIsEnabled(preferences);
     const sources = detectVersionSources(root);
     const findings = [];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mustflow",
-  "version": "2.112.9",
+  "version": "2.112.13",
   "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"