Skip to content

Commit 2f76113

Browse files
committed
refine commit policy and workspace profile fallback
1 parent 7f12f9f commit 2f76113

37 files changed

Lines changed: 841 additions & 162 deletions

‎.mcp.json‎

Lines changed: 5 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,21 +1,20 @@
11
{
2-
"$schema": "https://json.schemastore.org/mcp-servers.json",
3-
"servers": {
2+
"mcpServers": {
43
"devcodex-memory": {
54
"type": "stdio",
65
"command": "node",
76
"args": [
8-
"${workspaceFolder}/.claude/mcp/memory-server.js",
9-
"${workspaceFolder}"
7+
"${CLAUDE_PROJECT_DIR:-.}/.claude/mcp/memory-server.js",
8+
"${CLAUDE_PROJECT_DIR:-.}"
109
],
1110
"_note": "Reads/writes .devcodex/.memory/ session files and records CP confirmations."
1211
},
1312
"devcodex-profile": {
1413
"type": "stdio",
1514
"command": "node",
1615
"args": [
17-
"${workspaceFolder}/.claude/mcp/profile-server.js",
18-
"${workspaceFolder}"
16+
"${CLAUDE_PROJECT_DIR:-.}/.claude/mcp/profile-server.js",
17+
"${CLAUDE_PROJECT_DIR:-.}"
1918
],
2019
"_note": "Loads .devcodex/profile/ files and returns ENV_MODE / agent config."
2120
}

‎CLAUDE.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -31,7 +31,7 @@
3131

3232
---
3333

34-
## 强制约束(C01~C18)
34+
## 强制约束(C01~C19)
3535

3636
| # | 约束 | 规则 |
3737
|:-:|------|------|
@@ -114,7 +114,7 @@
114114
| 影响点 | `prod`(默认)| `dev` |
115115
|--------|:------------:|:-----:|
116116
| CP 门控 | 🔴 强制等待用户确认 | 🔴 强制等待用户确认 |
117-
| 合规检查 | 不执行 | 全量 FC1~FC6 + SC1~SC14 + RC1~RC4 + T1~T9 |
117+
| 合规检查 | 不执行 | 全量 FC1~FC7 + SC1~SC15 + RC1~RC4 + T1~T9 |
118118
| 预检查输出 | 不输出 | 输出 PC0~PC7 |
119119
| 合规状态块 | 不输出 | 输出全量状态块(chat 豁免合规块,但仍须预检查)|
120120
| 安全底线 S01~S06 | 🔴 强制 | 🔴 强制 |

‎README.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -53,7 +53,7 @@ npx devcodex init
5353
├── instructions/ ← Instructions 约束(12 个,含全部工作流规则)
5454
├── agents/ ← Copilot 自定义 Agent(v1.9.8 起恢复默认分发)
5555
├── skills/ ← Skill 详细检查标准(35 个,按需读取)
56-
├── prompts/ ← Prompt 模板(24 个)
56+
├── prompts/ ← Prompt 模板(25 个)
5757
├── hooks/ ← 宿主生命周期 Hook 配置与运行时
5858
│ ├── devcodex.lifecycle.json
5959
│ └── _runtime/
@@ -185,7 +185,7 @@ devcodex/
185185
├── agents/ # Agent 源文件;Copilot 端默认分发,Claude Code 端不分发
186186
├── instructions/ # 全局 Instructions(12 个,含工作流规则摘要,自动注入)
187187
├── skills/ # Skill 详细检查标准(35 个,按 01-common §按需读取表 路由读取)
188-
├── prompts/ # Prompt 模板(24 个)
188+
├── prompts/ # Prompt 模板(25 个)
189189
├── hooks/ # Workspace Hooks 配置与分发到 `.github/hooks/_runtime/` 的运行时
190190
├── data/ # 运行时数据模板(分发到目标项目的空骨架)
191191
│ ├── README.md

‎changelogs/unreleased.md‎

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,15 @@
1+
# 未发布变更(Unreleased)
2+
3+
> **用途**: 记录尚未正式发版的实现级变更、修复、规范调整。
4+
> **写入规则**: 用户未明确要求 `tag` / `release` / `publish` 时,默认写入本文件;正式发版时再归档到 `changelogs/vX.Y.Z.md`。
5+
> **维护方式**: 保持倒序,按日期分组;归档完成后移除已发布条目或重置为空模板。
6+
7+
---
8+
9+
## 2026-05-25
10+
11+
- **Claude MCP / 宿主适配收口**:修复 Claude Code 项目级 MCP 配置与 `.claude/settings` 权限放开逻辑,补齐 `mcpServers`、permissions allowlist、部署同步与对应校验探针,降低 Claude 宿主下的假绿与反复授权问题。
12+
- **TypeScript 无产物类型校验补强**:为 dev/fix 主链补入 TS 项目执行后类型校验要求,优先项目既有 `typecheck`,否则执行 `tsc --noEmit`,并明确禁止通过临时 `tsconfig` 或参数文件污染仓库来“过校验”。
13+
- **发布与 CHANGELOG 双阶段收口**:建立“未明确发版默认写 `unreleased`、明确发版后再归档正式版本”的统一规则,新增三层日志模型说明并同步到规范、文档同步、发布指南和报告模板。
14+
- **控制面规则与 API 验证模板收口**:统一前置复审显式输出、控制面交叉验证、语义批次 `unreleased/commit` 边界和 `fix.default` 路径锚点;同时把 `api-verification` 的 `.http/.cjs` 模板、Skill 示例和 `validate.js` 探针修到一致,并同步工作区 `AGENTS.md`、`.github`、`.claude` 部署副本。
15+
- **工作区优先配置与 profile 读取链升级**:新增工作区级 VS Code 启动配置(`chat/payment/user/search/resource/push`),并把 runtime 与 MCP profile 读取升级为“项目根优先、工作区兜底、不隐式合并”,同时补齐需求级实施报告、会话产物与记忆索引,便于按语义批次追踪与本地回滚。

‎data/README.md‎

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -31,6 +31,7 @@ data/
3131

3232
- `data/violations.md`
3333
- `data/pending-fixes.md`
34+
- `data/pending-issues.md`
3435
- `data/process-improvements.md`
3536

3637
而在**源仓**里:
@@ -39,3 +40,9 @@ data/
3940
- `.devcodex/.maintainer-state/`:维护者自己的实际记录,不参与 npm 分发
4041

4142
换句话说,规范里写 `data/*.md` 时,表达的是“应该把记录落到运行时台账”,不是说源仓根 `data/` 目录里直接保存真实记录。
43+
44+
## 问题池说明
45+
46+
- `data/pending-fixes.md`:承载运行时 PF(规范缺口)记录,主要由 PC4 / spec-radar / audit 轻量登记使用
47+
- `data/pending-issues.md`:承载**已确认但不阻断当前任务**的治理改进项,按批次进入后续需求或 bug 修复流程
48+
- `data/process-improvements.md`:只记录“已确认更优的执行策略”,不替代前两者

‎data/pending-issues.md‎

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,20 @@
1+
# Pending Issues(问题池)
2+
3+
> **文件路径**: `data/pending-issues.md`
4+
> **用途**: 记录已确认、但**不阻断当前任务**的规范优化、流程补强、模板体验或工作区协作改进项,供后续按批次统一修复。
5+
> **区别**:
6+
> - `data/pending-fixes.md`:运行时 PF 缺口台账
7+
> - `data/process-improvements.md`:已确认采纳的更优执行策略
8+
> - `data/pending-issues.md`:尚未进入实施、但已明确需要后续处理的问题池
9+
10+
## 使用规则
11+
12+
1. 非阻断项默认写入本文件,不在当前主任务中途穿插修复。
13+
2. 每条问题应至少包含:标题、发现时间、影响范围、建议动作、状态。
14+
3. 问题进入正式需求或 bug 修复流程后,应补充关联目录或报告路径,并在关闭时注明收口批次。
15+
16+
---
17+
18+
## 当前状态
19+
20+
- 当前暂无已登记的非阻断问题池条目。

‎data/process-improvements.md‎

Lines changed: 45 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,45 @@
1+
# Process Improvements(过程改进记录)
2+
3+
> **文件路径**: `data/process-improvements.md`
4+
> **写入时机**: 当用户建议的策略经验证优于当前执行方式时,由 AI 自动追加(不得询问是否记录)
5+
> **关联规范**: `01-common.instructions.md` C17
6+
7+
## PI-008
8+
- 发现时间:2026-05-25
9+
- 场景:开发/修复完成后,用户并未明确要求 `tag`、`release`、`publish`
10+
- 原做法:变更日志、版本号、tag、publish 的边界定义不够清晰,实施层容易把“开发完成”顺滑推进成“准备正式发版”
11+
- 更优做法:默认只记录 `changelogs/unreleased.md`;仅在用户明确确认 `tag` / `release` / `publish` 时,才固化版本号、归档正式 changelog 并执行 tag/publish
12+
- 改进收益:避免预占未来版本号,减少日常开发误触发 release 流程,也让需求日志、未发布实现日志、已发布版本日志职责更清晰
13+
- 状态:已纳入规范(发布与 CHANGELOG 双阶段模型)
14+
15+
## PI-009
16+
- 发现时间:2026-05-25
17+
- 场景:修复/开发过程中,一个会话内连续解决多个问题或多个同源发现项时,如何处理 `commit` 与 `unreleased` 记录
18+
- 原做法:容易滑向两种极端,要么完全不记未发布变更,要么倾向“每修完一个问题就 commit 一次”
19+
- 更优做法:每完成一个**已验证的语义修复批次**,默认更新 `changelogs/unreleased.md`;`commit` 不自动按“问题个数”切分,而是按**语义批次**提交,仅在用户明确要求、需要独立回滚点、或边界清晰且已闭环时再提交
20+
- 改进收益:既保留未发布变更追溯,又避免产生大量碎片化 commit;更符合回滚、审阅和 release 归档的真实边界
21+
- 状态:已纳入规范(待同步到提交/文档同步/发布边界相关规则)
22+
23+
## PI-010
24+
- 发现时间:2026-05-25
25+
- 场景:用户确认后进入下一阶段前,尤其是控制面规则、多文件联动、真相源同步场景的前置复审
26+
- 原做法:前置复审虽已存在,但容易停留在内部自检,既不稳定显式输出,也未强制交叉验证
27+
- 更优做法:前置复审结果必须显式输出;当场景涉及控制面规则、多文件联动、真相源同步、模板/示例/校验链联动时,必须追加交叉验证,并在发现阻断项时先修正当前产物再重新确认
28+
- 改进收益:能显著降低“带着阻断项继续推进”的概率,也能把规则、示例和校验链漂移更早拦住
29+
- 状态:已纳入规范(待同步到 common / cp-gate / dev / fix 主规则)
30+
31+
## PI-011
32+
- 发现时间:2026-05-25
33+
- 场景:多项目工作区中,开发/修复完成后虽已写入 `changelogs/unreleased.md`,但若没有本地 `commit`,缺少明确回滚锚点与 commit hash 追溯
34+
- 原做法:默认只更新 `unreleased`,`commit` 仍停留在“看情况是否执行”的弱约束
35+
- 更优做法:每完成一个**已验证的语义变更批次**,默认建议执行**本地 `commit`** 作为回滚锚点,但仍不默认 `push/tag/publish`
36+
- 改进收益:既保留未发布阶段的低风险节奏,又补齐本地回滚、diff 定位与批次追溯能力
37+
- 状态:已纳入规范(提交边界已收口,待本轮实现完成后按批次执行)
38+
39+
## PI-012
40+
- 发现时间:2026-05-25
41+
- 场景:执行中临时发现的规范/流程问题,若一律“发现即修”,容易把主任务切碎并造成范围漂移
42+
- 原做法:阻断项与非阻断项缺少统一分流,临时发现的问题常直接穿插进入当前会话修复
43+
- 更优做法:阻断项即时修复;非阻断项统一进入 `data/pending-issues.md`,按批次进入需求或 bug 修复流程
44+
- 改进收益:能稳定主任务边界,降低会话漂移,同时保留后续持续优化的入口
45+
- 状态:已纳入规范(问题池机制已建立)

‎hooks/_runtime/lifecycle.cjs‎

Lines changed: 65 additions & 38 deletions
Original file line numberDiff line numberDiff line change
@@ -19,19 +19,12 @@ const STATE_DIR = path.join(WORKSPACE_ROOT, '.devcodex', '.memory', 'hooks')
1919
const STATE_FILE = path.join(STATE_DIR, 'lifecycle-state.json')
2020
const FINAL_PAYLOAD_FLAG = path.join(STATE_DIR, 'capture-final-payload.flag')
2121
const FINAL_PAYLOAD_LOG = path.join(STATE_DIR, 'captured-final-payloads.ndjson')
22-
const PROFILE_CONFIG_FILE = path.join(WORKSPACE_ROOT, '.devcodex', 'profile', 'config.json')
2322
const PAYLOAD_PREVIEW_LIMIT = 160
2423

2524
// ─── CP Gate constants ────────────────────────────────────────────────────────
2625
const CP1_FILE = '01-需求概述.md'
2726
const CP2_FILE = '02-技术方案.md'
2827
const CP3_FILE = '04-实施计划.md'
29-
const REQUIREMENTS_DIR = path.join(WORKSPACE_ROOT, '.devcodex', 'requirements')
30-
const BUGS_DIR = path.join(WORKSPACE_ROOT, '.devcodex', 'bugs')
31-
const TASK_ROOTS = [
32-
{ kind: 'requirements', dir: REQUIREMENTS_DIR },
33-
{ kind: 'bugs', dir: BUGS_DIR }
34-
]
3528
const EXECUTION_MODE = { CONFIRM: 'confirm', AUTO: 'auto' }
3629
const AUTO_ALLOWED_PATH_PATTERNS = [
3730
/^\.devcodex\//,
@@ -82,14 +75,41 @@ function readJsonFile(p) {
8275
try { return JSON.parse(raw) } catch { return null }
8376
}
8477

85-
function readProfileMode() {
86-
const cfg = readJsonFile(PROFILE_CONFIG_FILE)
78+
function getWorkspaceProfileConfigPath() {
79+
return path.join(WORKSPACE_ROOT, '.devcodex', 'profile', 'config.json')
80+
}
81+
82+
function getProjectRoot(projectName) {
83+
return projectName ? path.join(WORKSPACE_ROOT, projectName) : WORKSPACE_ROOT
84+
}
85+
86+
function getActiveProjectRoot(state) {
87+
return getProjectRoot(state?.activeProject || '')
88+
}
89+
90+
function getProfileSearchRoots(state, explicitProject) {
91+
const roots = []
92+
const projectRoot = getProjectRoot(explicitProject || state?.activeProject || '')
93+
roots.push(projectRoot)
94+
if (projectRoot !== WORKSPACE_ROOT) roots.push(WORKSPACE_ROOT)
95+
return [...new Set(roots)]
96+
}
97+
98+
function readResolvedProfileConfig(state, explicitProject) {
99+
for (const root of getProfileSearchRoots(state, explicitProject)) {
100+
const cfg = readJsonFile(path.join(root, '.devcodex', 'profile', 'config.json'))
101+
if (cfg) return cfg
102+
}
103+
return null
104+
}
105+
106+
function readProfileMode(state, explicitProject) {
107+
const cfg = readResolvedProfileConfig(state, explicitProject)
87108
return String(cfg?.mode ?? 'prod').trim().toLowerCase() === 'dev' ? 'dev' : 'prod'
88109
}
89110

90-
function readProjectProfileConfig(state) {
91-
const projectRoot = getActiveProjectRoot(state)
92-
return readJsonFile(path.join(projectRoot, '.devcodex', 'profile', 'config.json')) || null
111+
function readProjectProfileConfig(state, explicitProject) {
112+
return readResolvedProfileConfig(state, explicitProject)
93113
}
94114

95115
function listMemoryAgents(state) {
@@ -322,11 +342,6 @@ function touchesPath(payload, ...needles) {
322342
return strings.some(s => needles.some(n => s.includes(normalizeText(n))))
323343
}
324344

325-
function getActiveProjectRoot(state) {
326-
if (state?.activeProject) return path.join(WORKSPACE_ROOT, state.activeProject)
327-
return WORKSPACE_ROOT
328-
}
329-
330345
function buildProjectScopedNeedles(projectRoot, segments) {
331346
const absolute = path.join(projectRoot, ...segments)
332347
const relativeRoot = path.relative(WORKSPACE_ROOT, projectRoot)
@@ -378,9 +393,9 @@ function buildDefaultState(mode) {
378393
}
379394

380395
function loadState(modeHint) {
381-
const mode = modeHint || readProfileMode()
382-
const current = buildDefaultState(mode)
383396
const saved = readJsonFile(STATE_FILE)
397+
const mode = modeHint || readProfileMode(saved || null)
398+
const current = buildDefaultState(mode)
384399
if (!saved || typeof saved !== 'object') return current
385400
return {
386401
...current, ...saved, mode,
@@ -526,9 +541,10 @@ function hasTaskArtifact(task, phase) {
526541
return false
527542
}
528543

529-
function listTaskDirs() {
544+
function listTaskDirs(state) {
545+
const taskRoots = getTaskRoots(state)
530546
const out = []
531-
for (const root of TASK_ROOTS) {
547+
for (const root of taskRoots) {
532548
if (!fs.existsSync(root.dir)) continue
533549
let entries
534550
try { entries = fs.readdirSync(root.dir) } catch { continue }
@@ -543,8 +559,16 @@ function listTaskDirs() {
543559
return out.sort((a, b) => (b.mtimeMs || 0) - (a.mtimeMs || 0))
544560
}
545561

546-
function findIncompleteTask() {
547-
const dirs = listTaskDirs()
562+
function getTaskRoots(state) {
563+
const projectRoot = getActiveProjectRoot(state)
564+
return [
565+
{ kind: 'requirements', dir: path.join(projectRoot, '.devcodex', 'requirements') },
566+
{ kind: 'bugs', dir: path.join(projectRoot, '.devcodex', 'bugs') }
567+
]
568+
}
569+
570+
function findIncompleteTask(state) {
571+
const dirs = listTaskDirs(state)
548572
if (!dirs.length) return null
549573

550574
return dirs.find(d => {
@@ -597,12 +621,12 @@ function extractToolPaths(payload) {
597621

598622
// Map a file path to its owning task scope (.devcodex/requirements/<X>/... or .devcodex/bugs/<X>/...).
599623
// returns null when the path is not under any supported task directory.
600-
function getTaskScopeFromPath(p) {
624+
function getTaskScopeFromPath(p, state) {
601625
if (!p) return null
602626
let abs = p
603627
if (!path.isAbsolute(abs)) abs = path.resolve(WORKSPACE_ROOT, abs)
604628
const norm = path.normalize(abs)
605-
for (const root of TASK_ROOTS) {
629+
for (const root of getTaskRoots(state)) {
606630
const rootDir = path.normalize(root.dir)
607631
if (!norm.toLowerCase().startsWith(rootDir.toLowerCase() + path.sep)) continue
608632
const rel = path.relative(rootDir, norm)
@@ -653,13 +677,13 @@ function checkAutoWhitelist(payload, platform, state) {
653677
// Path-aware CP gate: when all tool paths belong to specific task dirs,
654678
// only check those tasks' CP status (avoids cross-task deny).
655679
// Falls back to global findIncompleteTask() for mixed/source-code paths.
656-
function findIncompleteTaskForPaths(payload) {
680+
function findIncompleteTaskForPaths(payload, state) {
657681
const paths = extractToolPaths(payload)
658-
if (paths.length === 0) return findIncompleteTask()
682+
if (paths.length === 0) return findIncompleteTask(state)
659683

660-
const taskScopes = paths.map(getTaskScopeFromPath)
684+
const taskScopes = paths.map(p => getTaskScopeFromPath(p, state))
661685
const allInTask = taskScopes.every(scope => scope !== null)
662-
if (!allInTask) return findIncompleteTask() // mixed or source-code → preserve original behavior
686+
if (!allInTask) return findIncompleteTask(state) // mixed or source-code → preserve original behavior
663687

664688
const targetMap = new Map()
665689
for (const scope of taskScopes) targetMap.set(`${scope.kind}:${scope.name}`, scope)
@@ -675,10 +699,10 @@ function findIncompleteTaskForPaths(payload) {
675699
return null // all target tasks have CP3 confirmed → allow
676700
}
677701

678-
function checkCpGate(payload) {
702+
function checkCpGate(payload, state) {
679703
const task = (payload && extractToolPaths(payload).length > 0)
680-
? findIncompleteTaskForPaths(payload)
681-
: findIncompleteTask()
704+
? findIncompleteTaskForPaths(payload, state)
705+
: findIncompleteTask(state)
682706
if (!task) return null
683707
const confirmed = readCpConfirmations(task.fullPath)
684708
if (!hasTaskArtifact(task, 'CP2') || !confirmed.CP2) {
@@ -886,16 +910,19 @@ async function main() {
886910

887911
const eventName = getEventName(payload)
888912
const platform = detectPlatform(payload)
889-
const mode = readProfileMode()
890-
let state = loadState(mode)
913+
const prompt = eventName === 'UserPromptSubmit' ? extractUserPrompt(payload) : ''
914+
const explicitProject = eventName === 'UserPromptSubmit' ? detectProjectFromPrompt(prompt) : ''
915+
const modeHint = eventName === 'UserPromptSubmit' && explicitProject
916+
? readProfileMode(null, explicitProject)
917+
: undefined
918+
let state = loadState(modeHint)
919+
const mode = state.mode
891920

892921
updateVisibleReplyState(state, payload, eventName)
893922
state.lastEvent = eventName || state.lastEvent
894923

895924
// ── UserPromptSubmit ───────────────────────────────────────────────────────
896925
if (eventName === 'UserPromptSubmit') {
897-
const prompt = extractUserPrompt(payload)
898-
const explicitProject = detectProjectFromPrompt(prompt)
899926
state = resetState(mode, state)
900927
state.executionMode = detectExecutionMode(payload)
901928
if (hasMultiProjectExemption(prompt)) {
@@ -906,7 +933,7 @@ async function main() {
906933
// Multi-project workspace guard (v1.9.8+):
907934
// when no workspace-root profile exists and ≥2 sibling projects detected,
908935
// require the user to specify the target project explicitly.
909-
const hasWorkspaceProfile = fs.existsSync(PROFILE_CONFIG_FILE)
936+
const hasWorkspaceProfile = fs.existsSync(getWorkspaceProfileConfigPath())
910937
if (!hasWorkspaceProfile && isMultiProjectWorkspace()) {
911938
if (!hasMultiProjectExemption(prompt) && !state.activeProject) {
912939
state.lastReason = 'multi-project-workspace-block'
@@ -977,7 +1004,7 @@ async function main() {
9771004

9781005
// 3. CP gate — block source code mutations until checkpoints confirmed
9791006
// payload-aware: when tool paths target specific requirement dirs, only that requirement's CP is checked
980-
const gate = checkCpGate(payload)
1007+
const gate = checkCpGate(payload, state)
9811008
if (gate && isSourceCodeMutation(payload, platform)) {
9821009
state.lastReason = `cp-gate-${gate.phase}`
9831010
saveState(state)

0 commit comments

Comments
 (0)