Skip to content

Commit 372be1f

Browse files
committed
release: prepare v1.17.11
1 parent f787108 commit 372be1f

71 files changed

Lines changed: 3112 additions & 727 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎CHANGELOG.md‎

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,17 @@
11
# 变更日志 (CHANGELOG)
22

33
> **说明**: 版本概览摘要;历史版本见对应详细变更文件。
4-
> **最新版本详细变更文档**: [`changelogs/releases/v1.17.10.md`](./changelogs/releases/v1.17.10.md)
5-
> **最后更新**: 2026-08-17
6-
> **当前版本**: v1.17.10 统一 DevCodex 的公开产品表达,建立公开用户文档与 GitHub Pages,收敛 README 信息架构和跨入口 metadata,并补强动态工作流、Skill、宿主与 endpoint 身份合同;版本发布权威以对应 Git tag、npm registry 与 GitHub Release 为准。
4+
> **最新版本详细变更文档**: [`changelogs/releases/v1.17.11.md`](./changelogs/releases/v1.17.11.md)
5+
> **最后更新**: 2026-08-22
6+
> **当前版本**: v1.17.11 让日常验证按真实影响边界选择 V0~V2,把完整 V3 保留给显式发布;同时修复 Codex Hook 状态锁恢复、事件输出契约、S15 证据顺序与慢节点 deadline,并纳入 v1.17.10 后的工作区交付和公开文档增强。版本发布权威以对应 Git tag、npm registry 与 GitHub Release 为准。
77
88
---
99

1010
## 版本概览
1111

1212
| 版本 | 日期 | 变更摘要 | 详细 |
1313
|------|------|---------|------|
14+
| [v1.17.11](./changelogs/releases/v1.17.11.md) | 2026-08-22 | ⚡ **影响范围验证与 Codex Hook 韧性**:新增 VerificationIntent V0~V3、类型化影响图、预算卡和精确证据缓存;小改动不再误跑发布全链;修复锁恢复、Codex 事件输出、S15 rebind 顺序、PATH 身份、组合 deadline 与 pack 中断恢复,并汇入工作区绑定、Memory 产物链接、Skill 目录和公开任务文档增强 | [查看](./changelogs/releases/v1.17.11.md) |
1415
| [v1.17.10](./changelogs/releases/v1.17.10.md) | 2026-08-17 | 📚 **公开产品表达与用户文档站**:统一意图驱动 AI Coding 工作流运行时定位;README 迁移到任务型入口,公开 Rspress/Pages 文档上线;package/plugin/CLI/GitHub metadata 对齐;V2 动态事实与 endpoint 身份负向合同防止跨入口漂移 | [查看](./changelogs/releases/v1.17.10.md) |
1516
| [v1.17.9](./changelogs/releases/v1.17.9.md) | 2026-08-17 | 🔧 **Grok Hook 启动与唯一 Owner 修复**:Windows canonical transport 兼容 PowerShell;用户级 Grok Hook 退役受管 lifecycle 声明,由插件独占六事件;verifier 分离物理声明、精确去重结果与 mutation owner,并同步事务、workspace temp、Memory/Profile 发布链闭环 | [查看](./changelogs/releases/v1.17.9.md) |
1617
| [v1.17.8](./changelogs/releases/v1.17.8.md) | 2026-08-16 | 🔧 **宿主稳定入口与 SkillRoute 自举修复**:Hook 信任身份与不可变 runtime generation 解耦;Codex 未分发 UserPromptSubmit 时由结构化 MCP 回退建立同一 SkillRoute envelope;多项目 pending 保留 exact host/显式 Skill,ContextRead 拒绝用 sidecar 覆盖复合返回体失配;S15 兼容 Hook/MCP 两种证据形态并绑定真实入口,closure 复算当前 runtime/adapter/evidence | [查看](./changelogs/releases/v1.17.8.md) |

‎RULES.md‎

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

3-
> AI workflow injector for Copilot / Claude Code / Codex / Gemini / Grok / Cursor Beta · publisher: Rocky · version: 1.17.10
3+
> AI workflow injector for Copilot / Claude Code / Codex / Gemini / Grok / Cursor Beta · publisher: Rocky · version: 1.17.11
44
55
## 正式主支持客户端
66

‎changelogs/releases/v1.17.11.md‎

Lines changed: 41 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,41 @@
1+
# DevCodex v1.17.11
2+
3+
> 发布日期:2026-08-22
4+
> 类型:Patch / 影响范围验证、Codex Hook 韧性与交付体验增强
5+
6+
## 发布摘要
7+
8+
v1.17.11 修复“日常小改动也被推入完整发布验证”的控制面缺陷:验证计划现在显式区分 V0~V3,并由目的、影响边界和类型化消费者关系选择最小充分节点;只有明确授权的发布或全量审计才能进入 V3。版本同时修复 Codex Hook 空锁恢复、事件输出白名单、SkillRoute rebind 证据顺序、真实 CLI 入口选择、复合慢节点 deadline 与 pack 中断恢复。
9+
10+
本版本还汇入 v1.17.10 之后已经落到 `main` 的工作区目标绑定、Memory 产物链接、公开 Skill 分类目录和用户文档任务化增强。
11+
12+
## 影响范围验证(PF-315)
13+
14+
- 新增 `VerificationIntentV1`,把验证等级固定为 V0 静态检查、V1 定向单元/合同、V2 边界集成、V3 完整发布资格。
15+
- `ValidationPlanV2` 通过类型化 runtime、qualification、release consumer 边构建影响图,保留 V1 兼容投影;未知输入失败关闭,不再静默升级成 full。
16+
- `fast` 改为动态影响选择;`profile-deploy` 与 `package-release` 固定为各自 V2 边界,不能吸收旧 full 清单或其他 dirty boundary。
17+
- `BudgetCardV1` 在执行前给出节点数、重节点和预计耗时;非发布重节点需要绑定精确计划摘要,发布 V3 则需要显式 release authority。
18+
- `ValidationEvidenceV2` 绑定 manifest、候选 dirty identity、节点合同/策略和上游 `nodeReceiptDigest`;只复用身份等价的节点证据,V3 永不复用缓存。
19+
- CLI 以 `--intent` 为正式参数,保留 `--purpose` 兼容别名;新增 `test:delivery` 与 `test:boundary`。
20+
21+
## Codex Hook 与证据链修复(PF-321~PF-327)
22+
23+
- 状态锁现在区分空锁、畸形锁、活跃 lease 和可回收 stale lock;并发写入使用有界 backpressure,避免进程终止窗口留下永久阻断。
24+
- Codex Hook stdout 按事件官方字段白名单投影:`PreToolUse` 的 allow/update 与 deny/block 语义保真,无动作输出为 `{}`,跨宿主私有字段不再泄漏。
25+
- S15 强制 generation 0 零正文加载,观察 generation 1 rebind 后的 entry/closeout 顺序;证据同时绑定真实 PATH Codex CLI、runtime、adapter、raw evidence 和 canonical evidence。
26+
- Windows S15 优先解析有效显式覆盖与 PATH 首个 Codex,再使用受控 fallback,避免同机另一安装冒充日常入口。
27+
- `hooks-runtime`、`cli-behavior`、`pack-clean` 等复合节点把父级 deadline 与内部阶段 timeout 分离,合法慢阶段不再被父级提前误杀。
28+
- npm pack 失败、signal 或 timeout 后显式恢复源码 manifest 与内容投影,防止 postpack 未执行污染后续候选。
29+
30+
## v1.17.10 后的交付体验增强
31+
32+
- `HostWorkspaceBindingV1` 与短 TTL `ProjectTargetLeaseV1` 统一宿主工作区、workspace namespace 和 active project 身份,冲突或歧义时立即重判。
33+
- `ArtifactLinkProjectionV1` 为 Memory、提示和续接输出安全生成 canonical containment 内的可点击本地产物链接。
34+
- 86 个 bundled Skill 由 `PublicSkillTaxonomyV1` 精确分类,公开站提供完整目录、过滤和任务入口;Workspace Skill 保持独立。
35+
- 公开文档扩展 Journey / Trust / Reference、工作流选择、教程、宿主设置、CLI、诊断、运行态维护和术语表,旧 URL 保持兼容。
36+
37+
## 兼容性与发布边界
38+
39+
- 不新增 root runtime dependency、后台服务、网络监听、registry 或自定义域名。
40+
- `.playwright-cli/` 继续由 Git/package 路径集合排除;验证不读取、枚举、修改、移动或删除其内容。
41+
- 完整发布资格必须由冻结候选的无缓存 V3、Profile、audit、pack/install、目标提交 CI、tag/GitHub Release、npm registry 与本机更新逐层回读,历史版本证据不可替代。

‎changelogs/unreleased.md‎

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,22 +1,23 @@
11
# 未发布变更(Unreleased)
22

33
> **用途**: 记录尚未正式发版的实现级变更。
4-
> **当前**: v1.17.10 已发布并完成 R7;下列工作区交付链、验证控制面与文档站变更均为未发布工作树候选,不代表 registry 用户已经获得。发行事实以 Git tag、npm registry、GitHub Release 与 Profile 05 的 `ProfileCurrentTruthV1` 为准。
4+
> **当前**: 下列变更已冻结到 v1.17.11;在 Git tag、npm registry、GitHub Release 与 Profile 05 的 `ProfileCurrentTruthV1` 完成一致回读前,仍按发布候选处理,不提前冒充已发布事实。
55
66
## 当前未发布实现候选
77

8-
- **验证分层与计划可解释性**:`ValidationPlanV1` 与 `ValidationExecutionReceiptV2` 明确区分 iterative changed-route 和 qualification route,记录逐节点选择原因、预算、完整回退原因及执行回执;验证控制面自身变化、未知输入或闭包超过阈值时仍 fail closed 到 full,不用“优化”削弱最终资格验证。
8+
- **验证意图、四级执行与预算门(PF-315)**:新增 `VerificationIntentV1`、V0~V3、`ValidationPlanV2`(保留 V1 投影)、`ValidationImpactGraphV2` 类型化 runtime/qualification/release consumers、节点 `minimumLevel` 与 `BudgetCardV1`。`fast` 改为动态影响选择,`profile-deploy` / `package-release` 固定为各自 V2 边界;普通 edit/delivery/boundary 不再因 high risk、R3/R4、ECR、控制面、cache stale、未知输入或闭包比例 silent full。未知影响 BLOCK;`ValidationEvidenceV2` 绑定 manifest、全部节点匹配 dirty 输入、节点契约/策略及依赖 `nodeReceiptDigest`,上游输入即使 stdout 不变也会精确级联失效。CLI 以 `--intent` 为正式参数、保留 `--purpose` 兼容别名,并把预计耗时与硬超时上限分开呈现。新增 `test:delivery` / `test:boundary`,发布候选仍以显式授权的无缓存 V3 保持原 full 99-node parity。
99
- **工作区绑定与续接一致性**:`HostWorkspaceBindingV1` 统一宿主工作区、workspace namespace 与 active project 的物理身份;`ProjectTargetLeaseV1` 只允许在短 TTL、marker/layout/allowlist 均未漂移时沿用目标,歧义、显式冲突或 workspace 选择立即重判,避免 session 轮换导致错误换项目。
1010
- **Memory 产物链接投影**:新增单一 `ArtifactLinkProjectionV1` owner,把合法任务产物投影为可点击本地链接;路径必须 canonical containment、去重且保留原真相源,越界、伪 URI、目录或缺失目标不生成链接。Memory MCP、提示、可见输出、任务续接及 package consumers 同步接入。
1111
- **公开 Skill 分类与可发现目录**:新增 canonical `PublicSkillTaxonomyV1`,将 86 个 bundled Skill 精确归入 workflow-routing 20、domain-architecture 21、quality-delivery 28、runtime-governance 17;83 active + 3 gray 生命周期保持独立。README 与 public-site 从同一投影生成分类计数、代表 Skill 和完整 86 项目录;`SkillCatalog` 服务端默认输出全部目录,并提供关键字、分类、生命周期及 `?category=` 过滤。Workspace Skill 不计入 bundled 86,也不成为第五分类。
12-
- **工作树交付边界**:仓库根 `.playwright-cli/` 由 repository-owned ignore 与 Git/package 路径集合守卫排除;验证只判断其是否被跟踪或进入 tarball,不读取、枚举、修改、移动或删除目录内容。本候选只允许本地实现、审查与验证收敛,不改版本、不 commit/tag/push/publish,也不更新 registry 或已发布运行态。
12+
- **工作树交付边界**:仓库根 `.playwright-cli/` 由 repository-owned ignore 与 Git/package 路径集合守卫排除;验证只判断其是否被跟踪或进入 tarball,不读取、枚举、修改、移动或删除目录内容。候选冻结前不改版本、不发布;本轮已获“修复收敛后发布并更新本机”授权,R4~R7 的真实执行与回读完成前不得提前写成 released。
1313
- **公开站工作流完整分层与语义流程**:公开站从“总览 + 6 个 primary ID”收敛为工作流选择、开发与修复、分析/审查/规划、对话/续接 4 个任务入口;完整解释 8 个 canonical workflow、6 primary + 2 advanced、12 个用户任务 subtype、1 个内部 `dev.plan-review` step 和 7 个 audit target。六个旧 URL 保留,架构与选择流程改为无需图表运行时的语义化响应式列表;控制面仅同步 `other/plan` 与内部步骤术语,runtime/CLI/Hook/MCP 行为和依赖不变。
1414
- **公开用户文档站任务化重构**:公开站从概念摘要扩展为 Journey / Trust / Reference 三层,新增四个任务教程、宿主与 workspace 设置、信任/安全/数据、CLI、状态错误码、运行态维护和术语表;quick start 收敛为单一只读首次成功路径,README 缩短并把深入说明指向 canonical Pages。四张首页能力卡各自进入独立教程;package 版本与生成时间写入 public projection,host reference 与产品表达由测试对账。旧 URL 全部保留,CLI/runtime/adapter 行为和依赖不变。
1515
- **公开站点内容与事实生成升级**:在保留已发布 9 个 URL 的前提下增加 concepts / workflows / 一条续接案例;生成器从现有投影器写出 `public-site/data/public-product-projection.json` 并刷新 marker 与 README V2 数字句;页数合同改为必存在路径 + 下限 23。
1616
- **需求状态字段回写**:把 v1.17.10 从「发布候选」改为已归档;需求 `00-需求概况.md` / `01-需求确认.md` 头部改为 `released-v1.17.10`。不改 README、package、plugin、homepage 或运行时。
1717

1818
## 已归档发布说明
1919

20+
- **v1.17.11 影响范围验证、Codex Hook 韧性与交付体验增强**:日常修改按 VerificationIntent V0~V2 和类型化影响图选择最小充分验证,显式发布才执行无缓存 V3;状态锁、Codex 事件输出、S15 rebind/PATH、组合 deadline 与 pack 中断恢复同步修复。v1.17.10 后的 workspace binding、Memory 产物链接、86 项 Skill 分类目录和公开任务文档增强一并纳入。完整说明见 `changelogs/releases/v1.17.11.md`;发行事实仍以外部回读为准。
2021
- **v1.17.10 公开产品表达、README V2 与 GitHub Pages 已归档**:稳定产品语义与动态工作流/Skill/六宿主投影已经接入;公共 README 收敛为任务入口,详细 Grok/Cursor/sandbox/runtime 内容迁入独立 `public-site/`,维护者 `website/` 继续不进入公开仓/npm 包。Pages 已以 workflow 模式上线并通过 URL/title/brand/404 负向身份回读,package/plugin/CLI/GitHub homepage 已切到该产品页面;npm registry、provenance、fresh install、本机六宿主与新会话证据已在 2026-08-17 R7 关闭。完整说明见 `changelogs/releases/v1.17.10.md`。
2122
- **v1.17.9 聚合发布已归档**:纳入 v1.17.8 发布后已核实的 35 项失败关闭、事务/CAS、workspace temp V2、Memory 与 Profile current-truth 修复;同时修复 Windows Grok 通过 PowerShell 执行受管 Hook 时首个引号可执行文件被解析为字符串而触发 `ParserError`,统一使用可被 `cmd.exe` 与 PowerShell 接受的稳定 Node 启动命令。Grok 用户级全局文件退出 DevCodex lifecycle 声明,六事件由用户级 `devcodex-workspace` plugin 单独拥有;runtime verifier 分别核对物理声明、Grok 精确去重后的有效 handler 与 mutation owner。Grok 默认导入 DevCodex Claude Hook 时,稳定 launcher 依据四项 Grok 保留环境指纹在回执读取前静默退出;用户自有 Hook、Grok Claude 兼容偏好、portable 模式与其他五宿主语义不变。完整说明见 `changelogs/releases/v1.17.9.md`。
2223
- **v1.17.8 宿主稳定入口与 SkillRoute 自举修复已归档(PI-251~255 / PF-303~307)**:六宿主 Hook 改为稳定 launcher,由 committed receipt 安全转发到当前不可变 runtime,避免每次升级改变 Codex Hook 信任身份;`profile_context_plan` 在宿主没有分发 UserPromptSubmit 时返回并复用精确 SkillRoute bootstrap,并把多项目 pending 的 canonical hostVariant/显式 Skill 保真带入 MCP;ContextRead 对复合 content 选择唯一主 schema,拒绝用 sidecar 覆盖可观察的身份失配;S15 归一化 Hook history 与结构化 receipt,并以 evidence-bound hostVariant 阻止 Desktop ambient 污染 CLI。完整说明见 `changelogs/releases/v1.17.8.md`;正式发布事实以 Git tag、npm registry、GitHub Release 与 `ProfileCurrentTruthV1` 为准。

‎content/duplication-inventory.json‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"schemaVersion": "ControlContentDuplicationInventoryV1",
3-
"sourceBundleDigest": "a452888976bfffd0f651f9b7d38c85921cf7f509477b3b965a05a7f30e545b7a",
3+
"sourceBundleDigest": "2968574d3b6b004e25b9b10bdcc5aa9bb8aa89ca1886d40737e3547ac99a99a0",
44
"thresholds": {
55
"minParagraphChars": 100,
66
"sectionThreshold": 0.94,

‎content/instructions.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -145,8 +145,8 @@
145145
### ExecutionChainOptimizationGate(执行链优化与回滚)
146146

147147
- 执行链优化状态使用 `ExecutionOptimizationStateV2` / `OptimizationFeatureStateV1`,生命周期为 `off → shadow → trial → default`,异常进入 `rolled-back`,连续无收益或维护税过高可进入 `sunset`。
148-
- `extensions.devcodex.executionOptimization.mode` 只允许 `safe-auto | full-only`,缺省 `safe-auto`。`full-only` 是正确性优先的 kill switch:禁用索引/cache/changed-scope/section/bundle/snapshot 复用,但保留有界任务定位、完整上下文读取、full validation 与完整项目分析。
149-
- 每个真实消费者在动作前必须读取当前 active-root 的只读状态,并形成 `ExecutionOptimizationFeatureDecisionV1`;`off / shadow / rolled-back / sunset` 必须立即走该 feature 的完整 fallback。状态缺失沿用 trial 兼容路径,状态损坏、超预算、未知 schema、身份不匹配或目标无法确定时必须 fail-closed,禁止只在 status/doctor 展示 lifecycle 而执行链仍继续加速。
148+
- `extensions.devcodex.executionOptimization.mode` 只允许 `safe-auto | full-only`,缺省 `safe-auto`。`full-only` 是正确性优先的 kill switch:禁用索引/cache/changed-scope/section/bundle/snapshot 复用,但保留有界任务定位、完整上下文读取、按已授权 `VerificationIntentV1` 直接生成验证计划与完整项目分析;验证优化关闭不得把 V0~V2 暗升为 V3/full。
149+
- 每个真实消费者在动作前必须读取当前 active-root 的只读状态,并形成 `ExecutionOptimizationFeatureDecisionV1`;`off / shadow / rolled-back / sunset` 必须立即走该 feature 的安全 fallback。验证消费者的 fallback 是 `direct-validation-plan`(关闭 cache/reuse、保留显式 route/level/purpose),无法安全推导时 BLOCK;其余消费者保持各自完整读取路径。状态缺失沿用 trial 兼容路径,状态损坏、超预算、未知 schema、身份不匹配或目标无法确定时必须 fail-closed,禁止只在 status/doctor 展示 lifecycle 而执行链仍继续加速。
150150
- promotion 必须使用 prospective trial:正确性错误为 0、直接收益与样本量达标、full fallback 回归/观测开销/false-positive 在预算内;任何 wrong task/root/CP、mandatory miss、required finding miss 或 false complete 非 0,立即 rollback,禁止用历史成功样例抵消。
151151
- 相关实现或消费者变化必须执行 `test:execution-chain-evolution`、V101 与适用的 full/Profile/package/website 路由;benchmark 未满足可比环境或样本策略时只能标 `provisional`,不得宣称目标收益。
152152

‎content/instructions/00-safety.instructions.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
applyTo: "**"
33
description: 安全底线与输出语言规则,定义 S01~S07、违规处理与不可豁免边界
44
priority: P2
5-
version: 1.17.10
5+
version: 1.17.11
66
---
77
# 安全底线规范(S01~S07)
88

‎content/instructions/01-common.instructions.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
applyTo: "**"
33
description: 通用规范总则,覆盖优先级、意图路由、Profile/active-root、宿主适配与治理总线
44
priority: P5
5-
version: 1.17.10
5+
version: 1.17.11
66
---
77
# 通用规范
88

0 commit comments

Comments
 (0)