fix: harden profile tier detection

Author: rockyshi1993

changelogs/unreleased.md

@@ -8,7 +8,7 @@
 
 ## 当前未发布变更
 
-暂无。
+- 2026-07-09：修复 `validate-profile` 档位检测在 workspace fallback 与项目本地 Profile 混合时可能被 fallback `profile-lite` 误导的问题；项目本地显式 `Profile 档位` 现在优先，新增回归测试覆盖 standard 项缺少 04/05 时必须失败，支撑 `ProfileTierStandardGate` / `AllDevCodexProfileValidationGate` 的真实退出码验证。
 
 ## 记录提示
 

scripts/test-validate-profile.js

@@ -477,6 +477,36 @@ function main() {
         assert.strictEqual(explicitFallbackResult.status, 0, explicitFallbackOutput)
         assert.doesNotMatch(explicitFallbackOutput, /missing required/)
 
+        const localTierOverridesFallbackRoot = createWorkspaceNamespaceWorkspace(currentProjectInfo())
+        const localStandardProfileDir = path.join(localTierOverridesFallbackRoot, '.devcodex', 'sample', 'profile')
+        writeFile(localTierOverridesFallbackRoot, '.devcodex/sample/profile/01-项目信息.md', [
+            currentProjectInfo(),
+            '',
+            '- Profile 档位：profile-standard。'
+        ].join('\n'))
+        fs.mkdirSync(path.join(localTierOverridesFallbackRoot, 'sample'), { recursive: true })
+        writeFile(localTierOverridesFallbackRoot, 'sample/package.json', JSON.stringify({
+            name: 'sample',
+            version: '0.0.1',
+            scripts: { test: 'node -e "1"' }
+        }, null, 2))
+        const localTierOverridesFallbackResult = runValidateWithArgs(
+            path.join(localTierOverridesFallbackRoot, 'sample'),
+            [
+                '--profile-dir',
+                localStandardProfileDir,
+                '--workspace-profile',
+                path.join(localTierOverridesFallbackRoot, '.devcodex', 'workspace', 'profile'),
+                '--project-root',
+                path.join(localTierOverridesFallbackRoot, 'sample')
+            ]
+        )
+        const localTierOverridesFallbackOutput = `${localTierOverridesFallbackResult.stdout}\n${localTierOverridesFallbackResult.stderr}`
+
+        assert.strictEqual(localTierOverridesFallbackResult.status, 1, localTierOverridesFallbackOutput)
+        assert.match(localTierOverridesFallbackOutput, /profile-standard requires 04-测试规范\.md/)
+        assert.match(localTierOverridesFallbackOutput, /profile-standard requires 05-交付发布规范\.md or 05-发布规范\.md/)
+
         const allProfilesRoot = createWorkspaceNamespaceWorkspace(currentProjectInfo())
         writeFile(allProfilesRoot, '.devcodex/chat/profile/01-项目信息.md', currentProjectInfo())
         const allProfilesResult = runValidateAll(allProfilesRoot)

scripts/validate-profile.js

@@ -142,6 +142,19 @@ function profileCorpus(fileNames) {
     .join('\n')
 }
 
+function profileCorpusEntries(fileNames) {
+  return fileNames.map(fileName => {
+    const info = profileFileInfo(fileName)
+    const text = info.source === 'missing' ? '' : fs.readFileSync(info.path, 'utf8')
+    return { fileName, info, text }
+  })
+}
+
+function extractExplicitProfileTiers(text) {
+  return [...String(text || '').matchAll(/Profile\s*档位[：:]\s*`?(profile-(?:lite|standard|closed-loop))`?/gi)]
+    .map(match => match[1])
+}
+
 function hasCurrentAgentsDistribution(text) {
   return /devcodex\/agents\/\s*→\s*\.github\/agents\//.test(text) &&
     /(Copilot[^\n。]*默认分发|默认分发[^\n。]*Copilot)/.test(text) &&
@@ -594,7 +607,7 @@ const PROFILE_TIER_GATES = [
 ]
 
 function detectProfileTier() {
-  const combined = profileCorpus([
+  const tierFiles = [
     'README.md',
     '01-项目信息.md',
     '02-架构约束.md',
@@ -604,11 +617,34 @@ function detectProfileTier() {
     '05-发布规范.md',
     '06-功能清单.md',
     '07-用户文档与契约规范.md'
-  ])
-  const explicitTier = combined.match(/Profile\s*档位[：:]\s*`?(profile-(?:lite|standard|closed-loop))`?/i)
-  if (explicitTier) {
-    return { tier: explicitTier[1], combined }
+  ]
+  const entries = profileCorpusEntries(tierFiles)
+  const combined = entries
+    .map(entry => `\n--- ${entry.fileName} (${entry.info.source}) ---\n${entry.text}`)
+    .join('\n')
+
+  const projectTiers = entries
+    .filter(entry => entry.info.source === 'project')
+    .flatMap(entry => extractExplicitProfileTiers(entry.text))
+  const uniqueProjectTiers = [...new Set(projectTiers)]
+  if (uniqueProjectTiers.length > 1) {
+    warn(`[profile] multiple project-local profile tiers declared: ${uniqueProjectTiers.join(', ')}`)
+  }
+  if (uniqueProjectTiers.length >= 1) {
+    return { tier: uniqueProjectTiers[0], combined }
+  }
+
+  const fallbackTiers = entries
+    .filter(entry => entry.info.source !== 'missing')
+    .flatMap(entry => extractExplicitProfileTiers(entry.text))
+  const uniqueFallbackTiers = [...new Set(fallbackTiers)]
+  if (uniqueFallbackTiers.length > 1) {
+    warn(`[profile] multiple fallback profile tiers declared: ${uniqueFallbackTiers.join(', ')}`)
+  }
+  if (uniqueFallbackTiers.length >= 1) {
+    return { tier: uniqueFallbackTiers[0], combined }
   }
+
   const matches = [...combined.matchAll(/\bprofile-(?:lite|standard|closed-loop)\b/g)].map(match => match[0])
   const unique = [...new Set(matches)]
   if (unique.length > 1) {