Skip to content

Commit 94347cb

Browse files
committed
release: v1.11.5
1 parent 86c37e3 commit 94347cb

10 files changed

Lines changed: 282 additions & 10 deletions

‎CHANGELOG.md‎

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,7 @@
99

1010
| 版本 | 日期 | 变更摘要 | 详细 |
1111
|------|------|---------|------|
12+
| [v1.11.5](./changelogs/v1.11.5.md) | 2026-05-29 | 🔧 **requirement 运行时产物结构探针 + 最近样本收口**:新增 `V41` 与 `test-requirement-artifacts`,把 `01/04/05` 的运行时最低结构纳入自动校验,并回补近期 requirement 样本的计划/进度漂移 | [查看](./changelogs/v1.11.5.md) |
1213
| [v1.11.4](./changelogs/v1.11.4.md) | 2026-05-29 | 🎯 **治理 Intake 全模式收口 + 本地 Profile overlay + README 专项治理**:将 Improvement Intake / 分流矩阵统一到所有模式,新增 `config.local.json` 受控 overlay、`V39/V40` 与 targeted tests,并补 `readme-authoring` / `audit-readme` / README 专项 review | [查看](./changelogs/v1.11.4.md) |
1314
| [v1.11.3](./changelogs/v1.11.3.md) | 2026-05-29 | 🛡️ **命名空间安全边界与宿主配置保护收口**:统一 `workspace-layout` 真相源,阻断 MCP `project` 路径穿越、修复 nested monorepo 命名空间碰撞与无会话 sticky 误继承;Claude adapter 改为备份+保守合并,`doctor` 去除 Codex 偏置,并将 `test:audit` 从确定性主链拆分 | [查看](./changelogs/v1.11.3.md) |
1415
| [v1.11.2](./changelogs/v1.11.2.md) | 2026-05-28 | 🔧 **治理生命周期与运行态落点收口**:新增 `spec-governance` / RecordRouter / SCV 验证链,修复 workspace-namespace 运行态落点、临时/备份产物漂移、MCP SUMMARY 模板与 release/profile/audit-state 防漂移校验,并同步 Profile 全模式 PC0~PC7 与历史归档页口径 | [查看](./changelogs/v1.11.2.md) |
@@ -90,8 +91,9 @@
9091

9192
## 相关文档
9293

93-
- [`changelogs/v1.11.4.md`](./changelogs/v1.11.4.md) — 最新版本详细变更文档
94-
- [`changelogs/v1.11.3.md`](./changelogs/v1.11.3.md) — 上一个版本详细变更文档
94+
- [`changelogs/v1.11.5.md`](./changelogs/v1.11.5.md) — 最新版本详细变更文档
95+
- [`changelogs/v1.11.4.md`](./changelogs/v1.11.4.md) — 上一个版本详细变更文档
96+
- [`changelogs/v1.11.3.md`](./changelogs/v1.11.3.md) — 历史版本详细变更文档
9597
- [`changelogs/v1.11.1.md`](./changelogs/v1.11.1.md) — 上一个版本详细变更文档
9698
- [`changelogs/v1.11.0.md`](./changelogs/v1.11.0.md) — 历史版本详细变更文档
9799
- [`changelogs/v1.10.0.md`](./changelogs/v1.10.0.md) — 历史版本详细变更文档

‎RULES.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
1-
# DevCodex v1.11.4 — 使用入口
1+
# DevCodex v1.11.5 — 使用入口
22

3-
> AI workflow injector for Copilot / Claude Code / Codex · publisher: Rocky · version: 1.11.4
3+
> AI workflow injector for Copilot / Claude Code / Codex · publisher: Rocky · version: 1.11.5
44
55
## 正式主支持客户端
66

‎changelogs/unreleased.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,4 +12,4 @@
1212
- 宿主输出、Hook 或项目现实扩展相关条目,建议显式写出 `verified-present / verified-missing / unverified`、sticky `activeProject` 与用户可见 `意图扩展摘要` 是否发生变化。
1313
- 执行闭环、确认机制或发布门禁相关条目,建议补充 `Intent Expansion Card`、`ConfirmationRequest`、`ECR` 与验证证据,方便正式发版时直接归档到版本 changelog。
1414

15-
已归档到最近版本;等待后续新增未发布条目。
15+
已归档到 `v1.11.5`;等待后续新增未发布条目。

‎changelogs/v1.11.5.md‎

Lines changed: 37 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,37 @@
1+
# v1.11.5 — requirement 运行时产物结构探针补强
2+
3+
> 发布日期:2026-05-29
4+
5+
## Highlights
6+
7+
- requirement 运行时产物现在有了正式守门探针:`validate.js` 新增 `V41`,会检查近期 requirement 目录里的 `01-需求概述.md`、`04-实施计划.md`、`05-实施进度.md` 是否保持最低结构。
8+
- 新增 targeted test `scripts/test-requirement-artifacts.js`,覆盖“合格 recent requirement”“不合格 recent requirement”“历史 requirement 不纳入本轮检查”三条关键路径。
9+
- 回补近期 requirement 样本漂移,收口“模板源已收紧、运行时产物却持续变薄”的逃逸问题。
10+
11+
## Changed
12+
13+
- `scripts/validate.js` 接入 `scripts/lib/requirement-artifact-check.js`,以 active runtime root 为准扫描近期 requirement 运行时产物。
14+
- `package.json` 的 `test:all` 新增 `test-requirement-artifacts` 主链校验。
15+
- 当前 requirement 样本 `治理台账状态回写与遗留项收敛` 的 `01/04/05` 已补回目录导航、计划骨架、进度元信息、验证结果、阻塞与恢复、下一步和变更记录。
16+
- 近期 requirement 当前消费者中的计划/进度漂移已同步修补:`控制面能力模块化与发布闭环`、`规范治理生命周期与落点闭环`、`规范资产跨层漂移收敛与校验补强`、`治理台账优化清单与主动记录强制化`。
17+
18+
## Added
19+
20+
- `scripts/lib/requirement-artifact-check.js`
21+
- `scripts/test-requirement-artifacts.js`
22+
- `validate.js` 探针 `V41 Requirement runtime artifact structure sync`
23+
24+
## Validation
25+
26+
- `node scripts/test-requirement-artifacts.js`
27+
- `node scripts/validate.js`
28+
- `npm test`
29+
- `npm run test:all`
30+
- `git diff --check`
31+
- `node .\devcodex-v1\index.js update`
32+
- `npm pack --dry-run`
33+
- `npm publish --dry-run --access restricted`
34+
35+
## Included Changes
36+
37+
- 2026-05-29 `requirement产物结构与进度探针补强修复`:修复运行时 requirement `01/04/05` 结构漂移,新增最近 requirement 结构探针与 targeted test,并完成近期样本交叉修补。

‎package-lock.json‎

Lines changed: 2 additions & 2 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

‎package.json‎

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,14 @@
11
{
22
"name": "@vextjs/devcodex",
3-
"version": "1.11.4",
3+
"version": "1.11.5",
44
"description": "DevCodex — AI-powered development workflow rules for Copilot, Claude Code and Codex",
55
"main": "index.js",
66
"bin": {
77
"devcodex": "index.js"
88
},
99
"scripts": {
1010
"test": "node scripts/validate-versions.js && node scripts/validate.js",
11-
"test:all": "npm test && node scripts/test-spec-governance.js && node scripts/test-governance-intake.js && node scripts/test-validate-profile.js && node scripts/test-readme-governance.js && node scripts/test-hooks-runtime.js && node scripts/test-instruction-fallback-check.js && node scripts/test-mcp-servers.js && node scripts/test-migrate-layout.js && node scripts/test-cli-behavior.js && node scripts/test-pack-clean.js && npm --prefix website run build && node scripts/check-syntax.js",
11+
"test:all": "npm test && node scripts/test-spec-governance.js && node scripts/test-governance-intake.js && node scripts/test-validate-profile.js && node scripts/test-readme-governance.js && node scripts/test-requirement-artifacts.js && node scripts/test-hooks-runtime.js && node scripts/test-instruction-fallback-check.js && node scripts/test-mcp-servers.js && node scripts/test-migrate-layout.js && node scripts/test-cli-behavior.js && node scripts/test-pack-clean.js && npm --prefix website run build && node scripts/check-syntax.js",
1212
"test:all:with-audit": "npm run test:all && npm run test:audit",
1313
"test:audit": "npm audit --omit=dev && npm --prefix website audit --omit=dev",
1414
"test:cli-behavior": "node scripts/test-cli-behavior.js",
@@ -19,6 +19,7 @@
1919
"test:pack-clean": "node scripts/test-pack-clean.js",
2020
"test:profile-governance": "node scripts/test-validate-profile.js",
2121
"test:readme-governance": "node scripts/test-readme-governance.js",
22+
"test:requirement-artifacts": "node scripts/test-requirement-artifacts.js",
2223
"test:governance-intake": "node scripts/test-governance-intake.js",
2324
"test:spec-governance": "node scripts/test-spec-governance.js",
2425
"validate": "node scripts/validate.js"

‎plugin.json‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
"_format": "DevCodex internal metadata — NOT a GitHub Copilot official format. Copilot reads .github/agents|skills|instructions|prompts directly.",
33
"_note_skills": "Adding a new sub-type Skill (e.g. dev-<name> / fix-<name>) requires L1~L3 sync per audit-dimensions D5: (L1) routing/SKILL.md 路由表 (L2) 02-output-paths.instructions.md 产物目录 (L3) 对应 report 模板子类型字段. Skill name field must match directory name. See audit-dimensions D5 关键检查 for full rules.",
44
"id": "devcodex",
5-
"version": "1.11.4",
5+
"version": "1.11.5",
66
"name": "DevCodex",
77
"publisher": "Rocky",
88
"displayName": "DevCodex — AI Development Workflow Assistant",
Lines changed: 105 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,105 @@
1+
'use strict'
2+
3+
const fs = require('fs')
4+
const path = require('path')
5+
6+
const RECENT_REQUIREMENT_ARTIFACT_DAYS = 2
7+
const REQUIREMENT_FILES = ['01-需求概述.md', '04-实施计划.md', '05-实施进度.md']
8+
9+
function hasText(filePath, needle) {
10+
return fs.readFileSync(filePath, 'utf8').includes(needle)
11+
}
12+
13+
function hasAnyText(filePath, needles) {
14+
const text = fs.readFileSync(filePath, 'utf8')
15+
return needles.some(needle => text.includes(needle))
16+
}
17+
18+
function hasRecentArtifact(dirPath, nowMs, recentDays) {
19+
const cutoff = nowMs - recentDays * 24 * 60 * 60 * 1000
20+
return REQUIREMENT_FILES
21+
.map(name => path.join(dirPath, name))
22+
.filter(filePath => fs.existsSync(filePath))
23+
.some(filePath => fs.statSync(filePath).mtimeMs >= cutoff)
24+
}
25+
26+
function checkRequirementDir(dirPath) {
27+
const issues = []
28+
const relDir = path.basename(dirPath)
29+
const requirementFile = path.join(dirPath, '01-需求概述.md')
30+
const planFile = path.join(dirPath, '04-实施计划.md')
31+
const progressFile = path.join(dirPath, '05-实施进度.md')
32+
33+
if (fs.existsSync(requirementFile) && !hasText(requirementFile, '## 目录导航')) {
34+
issues.push(`${relDir}/01-需求概述.md missing "## 目录导航"`)
35+
}
36+
37+
if (fs.existsSync(planFile)) {
38+
if (!hasText(planFile, '## 目录导航')) {
39+
issues.push(`${relDir}/04-实施计划.md missing "## 目录导航"`)
40+
}
41+
if (!hasText(planFile, '计划模式')) {
42+
issues.push(`${relDir}/04-实施计划.md missing plan mode`)
43+
}
44+
if (!hasAnyText(planFile, ['验证路线', '独立验证方式', '验证方式'])) {
45+
issues.push(`${relDir}/04-实施计划.md missing validation section`)
46+
}
47+
if (!hasAnyText(planFile, ['回滚摘要', '回滚触发', '回滚方案'])) {
48+
issues.push(`${relDir}/04-实施计划.md missing rollback section`)
49+
}
50+
}
51+
52+
if (fs.existsSync(progressFile)) {
53+
const requiredNeedles = [
54+
'当前轮次',
55+
'当前 CP',
56+
'当前批次',
57+
'## 目录导航',
58+
'进度总览',
59+
'支撑产物状态',
60+
'本轮验证结果',
61+
'阻塞与恢复',
62+
'下一步',
63+
'变更记录'
64+
]
65+
for (const needle of requiredNeedles) {
66+
if (!hasText(progressFile, needle)) {
67+
issues.push(`${relDir}/05-实施进度.md missing "${needle}"`)
68+
}
69+
}
70+
}
71+
72+
return issues
73+
}
74+
75+
function collectRecentRequirementArtifactIssues({
76+
activeRoot,
77+
recentDays = RECENT_REQUIREMENT_ARTIFACT_DAYS,
78+
nowMs = Date.now()
79+
}) {
80+
const requirementsRoot = path.join(activeRoot, 'requirements')
81+
const checkedDirs = []
82+
const issues = []
83+
84+
if (!fs.existsSync(requirementsRoot)) {
85+
return { checkedDirs, issues }
86+
}
87+
88+
for (const entry of fs.readdirSync(requirementsRoot, { withFileTypes: true })) {
89+
if (!entry.isDirectory()) continue
90+
const dirPath = path.join(requirementsRoot, entry.name)
91+
const hasTrackedArtifact = REQUIREMENT_FILES.some(name => fs.existsSync(path.join(dirPath, name)))
92+
if (!hasTrackedArtifact) continue
93+
if (!hasRecentArtifact(dirPath, nowMs, recentDays)) continue
94+
checkedDirs.push(entry.name)
95+
issues.push(...checkRequirementDir(dirPath))
96+
}
97+
98+
return { checkedDirs, issues }
99+
}
100+
101+
module.exports = {
102+
RECENT_REQUIREMENT_ARTIFACT_DAYS,
103+
checkRequirementDir,
104+
collectRecentRequirementArtifactIssues
105+
}
Lines changed: 108 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,108 @@
1+
#!/usr/bin/env node
2+
'use strict'
3+
4+
const assert = require('assert')
5+
const fs = require('fs')
6+
const os = require('os')
7+
const path = require('path')
8+
9+
const {
10+
RECENT_REQUIREMENT_ARTIFACT_DAYS,
11+
collectRecentRequirementArtifactIssues
12+
} = require('./lib/requirement-artifact-check')
13+
14+
function write(filePath, content) {
15+
fs.mkdirSync(path.dirname(filePath), { recursive: true })
16+
fs.writeFileSync(filePath, content, 'utf8')
17+
}
18+
19+
function setAge(filePath, daysAgo) {
20+
const time = new Date(Date.now() - daysAgo * 24 * 60 * 60 * 1000)
21+
fs.utimesSync(filePath, time, time)
22+
}
23+
24+
const tempRoot = fs.mkdtempSync(path.join(os.tmpdir(), 'devcodex-v41-'))
25+
26+
try {
27+
const requirementsRoot = path.join(tempRoot, 'requirements')
28+
29+
write(path.join(requirementsRoot, 'good-requirement', '01-需求概述.md'), [
30+
'# good',
31+
'',
32+
'## 目录导航',
33+
'',
34+
'- [背景](#背景)'
35+
].join('\n'))
36+
write(path.join(requirementsRoot, 'good-requirement', '04-实施计划.md'), [
37+
'# plan',
38+
'',
39+
'> 计划模式:轻计划摘要',
40+
'',
41+
'## 目录导航',
42+
'',
43+
'## 验证路线',
44+
'',
45+
'## 回滚摘要'
46+
].join('\n'))
47+
write(path.join(requirementsRoot, 'good-requirement', '05-实施进度.md'), [
48+
'# progress',
49+
'',
50+
'> 当前轮次:R1',
51+
'> 当前 CP:执行中',
52+
'> 当前批次:Batch 1 / 3',
53+
'',
54+
'## 目录导航',
55+
'',
56+
'## 进度总览',
57+
'',
58+
'## 支撑产物状态',
59+
'',
60+
'**本轮验证结果**:',
61+
'',
62+
'## 阻塞与恢复',
63+
'',
64+
'## 下一步',
65+
'',
66+
'## 变更记录'
67+
].join('\n'))
68+
69+
write(path.join(requirementsRoot, 'bad-requirement', '01-需求概述.md'), '# bad\n')
70+
write(path.join(requirementsRoot, 'bad-requirement', '04-实施计划.md'), [
71+
'# bad plan',
72+
'',
73+
'## 目录导航',
74+
'',
75+
'## 验证路线'
76+
].join('\n'))
77+
write(path.join(requirementsRoot, 'bad-requirement', '05-实施进度.md'), [
78+
'# bad progress',
79+
'',
80+
'> 当前轮次:R1',
81+
'> 当前 CP:执行中',
82+
'',
83+
'## 目录导航',
84+
'',
85+
'## 进度总览'
86+
].join('\n'))
87+
88+
write(path.join(requirementsRoot, 'old-requirement', '01-需求概述.md'), '# old\n')
89+
setAge(path.join(requirementsRoot, 'old-requirement', '01-需求概述.md'), RECENT_REQUIREMENT_ARTIFACT_DAYS + 10)
90+
91+
const { checkedDirs, issues } = collectRecentRequirementArtifactIssues({
92+
activeRoot: tempRoot,
93+
recentDays: RECENT_REQUIREMENT_ARTIFACT_DAYS
94+
})
95+
96+
assert(checkedDirs.includes('good-requirement'))
97+
assert(checkedDirs.includes('bad-requirement'))
98+
assert(!checkedDirs.includes('old-requirement'))
99+
assert(issues.some(item => item.includes('bad-requirement/01-需求概述.md missing "## 目录导航"')))
100+
assert(issues.some(item => item.includes('bad-requirement/04-实施计划.md missing plan mode')))
101+
assert(issues.some(item => item.includes('bad-requirement/04-实施计划.md missing rollback section')))
102+
assert(issues.some(item => item.includes('bad-requirement/05-实施进度.md missing "支撑产物状态"')))
103+
assert(!issues.some(item => item.includes('good-requirement')))
104+
105+
console.log('Requirement runtime artifact checks passed')
106+
} finally {
107+
fs.rmSync(tempRoot, { recursive: true, force: true })
108+
}

‎scripts/validate.js‎

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -36,6 +36,7 @@
3636
* V38 README authoring/review governance sync(README 用户视角写作、专项 review、targeted test 与消费者链)
3737
* V39 Governance improvement intake sync(全模式主动优化清单、统一回执、PI/PF 联动与强制探针)
3838
* V40 Profile local config sync(config.local schema、env 引用、受控扩展位与本地 overlay 消费链)
39+
* V41 Requirement runtime artifact structure sync(recent requirements 的 01/04/05 运行时结构探针)
3940
*
4041
* Exit: 0=OK, 1=error, 2=warnings only
4142
*/
@@ -46,6 +47,10 @@ const os = require('os')
4647
const path = require('path')
4748
const crypto = require('crypto')
4849
const { execSync, execFileSync } = require('child_process')
50+
const {
51+
RECENT_REQUIREMENT_ARTIFACT_DAYS,
52+
collectRecentRequirementArtifactIssues
53+
} = require('./lib/requirement-artifact-check')
4954

5055
const ROOT = path.resolve(__dirname, '..')
5156
const WORKSPACE_ROOT = path.dirname(ROOT)
@@ -2344,6 +2349,19 @@ function checkV40() {
23442349
console.log('[V40] profile local config sync checked')
23452350
}
23462351

2352+
function checkV41() {
2353+
const { checkedDirs, issues } = collectRecentRequirementArtifactIssues({
2354+
activeRoot: ACTIVE_DEVCODEX_ROOT,
2355+
recentDays: RECENT_REQUIREMENT_ARTIFACT_DAYS
2356+
})
2357+
2358+
for (const issue of issues) {
2359+
err(`[V41] ${issue}`)
2360+
}
2361+
2362+
console.log(`[V41] requirement runtime artifact structure checked: ${checkedDirs.length} dirs`)
2363+
}
2364+
23472365
function checkV29() {
23482366
const probes = [
23492367
{
@@ -2597,6 +2615,7 @@ checkV37()
25972615
checkV38()
25982616
checkV39()
25992617
checkV40()
2618+
checkV41()
26002619

26012620
console.log('')
26022621
if (errors.length) {

0 commit comments

Comments
 (0)