feat: harden repair, profile, and release workflows

Author: rockyshi1993

CHANGELOG.md

@@ -1,14 +1,15 @@
 # 变更日志 (CHANGELOG)
 
 > **说明**: 版本概览摘要。最新版本的详细变更见下方表格首行的 `changelogs/releases/vX.Y.Z.md` 链接；历史版本见对应详细变更文件
-> **最后更新**: 2026-07-09
+> **最后更新**: 2026-07-10
 
 ---
 
 ## 版本概览
 
 | 版本 | 日期 | 变更摘要 | 详细 |
 |------|------|---------|------|
+| [v1.11.33](./changelogs/releases/v1.11.33.md) | 2026-07-10 | 🔧 **修复协作、Profile 真相与发布闭环**：归档模型无关双层修复契约、MCP/Profile/audit/生成站点阻断修复，并新增 `ProfileTruthReconciliationGate`、`AuthorizedLocalSecurityAuditPresentationGate`、`PublisherCredentialTopologyGate` 与 V87~V90 | [查看](./changelogs/releases/v1.11.33.md) |
 | [v1.11.32](./changelogs/releases/v1.11.32.md) | 2026-07-09 | 🔧 **专家能力、记忆启动链与发布包依赖闭包**：新增 `expert-output-quality`、17 个专家 Owner Skill、`ExpertOutputQualityGate`、`ExpertOwnerSkillGate`、`MemoryCannotSatisfyBootstrapGate` 与 `PackagedScriptDependencyClosureGate`，补齐 V84/V85/V86 探针，防止专家口径泛化、宿主 Memories 替代文件真相源，以及源码测试通过但 tarball 公开脚本缺运行时依赖 | [查看](./changelogs/releases/v1.11.32.md) |
 | [v1.11.31](./changelogs/releases/v1.11.31.md) | 2026-07-09 | 🔧 **最新吸纳执行包与 Profile 三档闭环**：归档 A1~A10 `LatestAbsorptionExecutionPack`、新增 V82/V83，固化配置 canonical namespace、Profile runtime contract、文档/示例真相、派生消费者、功能清单证据矩阵、多批次状态进度、Profile 三档标准与全 `.devcodex` 校验 | [查看](./changelogs/releases/v1.11.31.md) |
 | [v1.11.30](./changelogs/releases/v1.11.30.md) | 2026-07-08 | 🔧 **用户侧文档 review 与规范吸纳执行入口收口**：新增 `audit-user-manual` 与 `spec-absorption`，固化用户侧文档、项目文档、菜单导航、sidebar、信息架构审查聚合，以及 `.devcodex/*/data` 候选通用性证明、消费者证明和项目独有规则剔除；新增 V80/V81 探针 | [查看](./changelogs/releases/v1.11.30.md) |

README.md

@@ -44,14 +44,19 @@ DevCodex 通过 `.github/`（Copilot）、`CLAUDE.md + .claude/ + .mcp.json`（C
 - **可配置并发策略**: Profile `config.json` 可配置 `extensions.devcodex.concurrency`；默认 `auto` 表示只读准备和隔离验证可并行、共享状态写入保持单写者，保守项目可设为 `serial`
 - **文件真相源优先的记忆启动链**: `MemoryCannotSatisfyBootstrapGate` 要求宿主 Memories、模型长期偏好、SUMMARY 或交接卡只能作为 `navigation-hint`；新线程、resume、summary 恢复或跨项目切换仍必须实际读取当前 active namespace 的 Profile、tasks、reports、review checklist 和源码 / 文档真相源。V86 探针防止把内置记忆当成 bootstrap / CP / 报告 / 验证证据。
 - **支撑型 Skill**: `execution-contract` / `test-router` / `release-verification` / `host-contract-verification` / `source-consumer-sync` 为控制面、多批次、测试路线、宿主契约验证与真相源-消费者同步提供可审计支撑，不新增工作流分支
+- **模型无关双层修复协作契约**: AI 判断任务目标为 repair task 时至少建立 `lightweight` 决策/验收层 + 执行/验证层契约；P0/P1、安全、控制面、公共契约、多批次、角色交接或发布风险升级 `full`，用 `findingToPatchMap`、`handoffIntegrity` 与 `independentReReview` 防止范围漂移和补丁作者唯一自证。模型名称或是否切换 Agent 不是触发条件
 - **发布前审查能力**: `audit-release` 负责 release readiness、发布说明质量、兼容/迁移风险、package/plugin 元数据、文档/Profile/website 同步、回滚策略、registry/tag 风险与发布后验收 review；`release-verification` 仍负责 R0~R7 执行验证链
+- **审计与修复授权分离**: `AuditMutationBoundaryGate` 规定 audit 只写报告、audit-state、记忆和运行态台账；任何源码/规范/配置/测试/文档/部署副本修复都需用户显式授权后进入独立 fix/self-fix，audit 不自动改源、`git add` 或继承修复权限
 - **分析与用户文档能力**: `analyze-default` 承接默认只读多轮分析、代码事实优先、analyze-lite CRS 与 PCV 收敛验证；`analyze-research` 承接技术调研/选型。`user-manual-authoring` 负责站点文档、最终用户使用文档、README、quick start、接入手册和 docs-first 用户手册的用户路径、信息架构、配置/排错和真实工作流；`readme-authoring` 是 README 专项分支，`audit-user-manual` 是用户侧文档 / 项目文档 / 菜单导航 / 信息架构专项 review 聚合入口，`audit-readme` 负责 README / 用户使用文档专项 review；`UserPerspectiveDocsGate` 要求文档按使用者第一次成功、常见任务、字段/参数/状态/错误解释、排错恢复和低心智负担组织，`UserDocsImmediateComprehensionGate` 要求用户文档输出功能完整性、配置易懂性和首次读者即时理解三轴结论，`UserDocsPrimarySurfaceGate` 要求站点文档 / README / quick start 先冻结 targetSurface、documentLocation 与 primaryAudience，首页首屏、quick start、nav/sidebar、CTA 和 reference 主路径必须服务用户使用而不是开发契约，`FinalUserManualFirstGate` / `DocsSiteInformationArchitectureGate` / `UserManualFlowAndFailureGate` / `QueueDocsRealWorkflowGate` 要求需求概况后优先产出最终用户使用文档，文档站按任务组织并覆盖成功、失败恢复和队列/异步真实工作流，`PublicUserDocsMaintainerBoundaryGate` 要求公开用户文档不混入维护者 checklist、内部同步清单或台账状态，`DocsConsumerSweep` 与 `UserPathContractSweep` 负责同步 README、website、Profile、示例、模板、导航、validate、部署副本和代码消费点
 - **专家型产物质量能力**: `expert-output-quality` 负责代码、文档、示例、fixture、quick start、技术方案和报告的专家型输出质量；`ExpertOutputQualityGate` 要求先给生产推荐路径、框架原生能力和项目既有能力，再说明 fixture/mock/demo 边界、反模式和证据矩阵。V84 探针会阻止把测试夹具、硬编码单例或每个 route 重复声明包装成生产推荐实践。
 - **专家 Owner Skill 能力**: 17 个专家 Owner Skill 分别承接产品策略、开发者体验、UX 交互、前端架构、后端领域架构、生产可用性 / SRE、API 契约、外部集成、平台生态、AI Agent 系统、数据架构、安全威胁建模、质量策略、设计系统、无障碍/国际化、增长分析和商业模型；`growth-analytics` 与 `business-model-review` 为 P3 条件触发，未命中时写 `N/A + skipReason`；`ExpertOwnerSkillGate` 要求报告 ownerSkill、triggerReason、requiredFields、validationRoute、skipReason 和 V85/targeted probe 证据，避免“专家视角”只停留在泛泛口号。
 - **复审清单能力**: `review-checklist` 负责正式复审、ECR、发布前复审、多轮收敛和外部 finding 批次的清单创建、范围冻结、逐项证据执行、遗漏逃逸分析、状态新鲜度和收敛关闭；`PostConfirmationReviewScopeGate` 要求 CP 确认后按风险选择轻量或全面复审；`ReviewEscapeRecordGate` 要求发现遗漏时先在清单写入 `whyMissed / prevention / checklistPatch / rerunEvidence`，再补清单和重跑验证
 - **实施偏移与文档 IA 守门**: `DevelopmentDriftGate` 在编码前和实施中核对 `allowedFirstBatch / blockedScope / driftTriggers / validationRoute`；`VerificationPlanMaterializationProbe` 要求技术方案物化验证计划、验收标准和退出条件；`ChinesePrimaryExpressionGate`、`SidebarPageRoleMaterializationProbe` 与 `SidebarGroupSemanticModelProbe` 要求用户文档中文主表达、页面角色和 sidebar 分组语义可验证
 - **自我进化治理能力**: `evolution-governance` 负责自我进化、自动吸纳、模型辅助规范优化、自动补 Skill / Prompt / Probe 和自动治理候选的控制面，执行 `EvolutionCapabilityControlPlaneGate`，冻结授权、模型配置、租户 / 权限、配额、数据边界、审计、回滚和发布审批；模型输出只能进入候选态，不能直接写 active 规范或发版
 - **Profile 新鲜度审查**: audit 会先执行 `Profile Freshness Check`，反向核对 Profile 是否仍匹配当前包版本、目录资产、脚本、发布状态、宿主能力和任务现实
+- **Profile 真相对账**: `ProfileTruthReconciliationGate` 由 `load-profile` 统一承接；项目级 analyze 使用 targeted 模式，audit 使用 full/PFresh 模式并反查 repo shape 与 Profile 档位/生命周期文件。`ProfileTruthMatrix` 记录声明、实际来源、漂移分类、结论权威和修订路线；只读工作流只矫正结论，不直接修改 Profile。V88 提供正负向同步探针。
+- **授权本地安全审查呈现**: `AuthorizedLocalSecurityAuditPresentationGate` 由 `security-threat-modeling` 承接，分离用户可见最小证据和隔离本地探针；内容不可见或额外安全检查发生时保存 `SafetyInterruptionCard` 并从文件真相/审查状态恢复，不把表达调整描述成绕过平台控制。V89 验证授权、证据预算与恢复链。
+- **发布凭据拓扑**: `PublisherCredentialTopologyGate` 由 `release-verification` 承接；首次发布或 publisher/repository/package/registry/auth topology 变化时核对发布身份、secret scope/access/inheritance、workflow permission、package ownership 和最近成功 run。只验证拓扑，不读取或输出 secret value；普通 patch 可记录 unchanged evidence。V90 与 R0~R7 共同守门。
 - **Profile 三档闭环校验**: Profile 按 `profile-lite` / `profile-standard` / `profile-closed-loop` 三档维护，执行 `ProfileTierStandardGate` 与 `ProfileLifecycleClassificationGate` 区分稳定基线、活文档和条件 / 本地文档；规范维护、SDK/CLI、文档站、public API 或用户要求全工作区校验时执行 `AllDevCodexProfileValidationGate`，通过 `node scripts/validate-all-profiles.js --workspace <workspace-root>` 扫描 `.devcodex/workspace/profile` 与 `.devcodex/<project>/profile`
 - **项目工程泄漏审查**: 项目工程 / 代码质量审查执行 `PE-12 资源生命周期与泄漏风险`，必须检查内存泄露、资源泄漏、监听器/定时器/连接/流未释放、缓存无界增长和组件卸载清理缺失
 - **泄漏风险稳定性压测**: 写测试用例或回归验证时先执行 `LeakRiskStabilityPressureTest` 条件判定；命中长运行、高并发、缓存/连接/监听器/定时器/流/socket/worker/订阅/组件生命周期或 `PE-12` 风险时，TestRoute 纳入场景/负载/稳定性压测并记录基线、冷却后回落和资源指标前后对比；低风险任务写 `N/A + skipReason`
@@ -197,6 +202,7 @@ AGENTS.md                 ← 与 instructions.md / copilot-instructions.md / CL
 - **ArtifactDecisionMatrix**：CP1/CP2/CP3/ECR 会按任务规模列出关键产物的 `create` / `update` / `skip` / `N/A` 状态，覆盖入口类型、需求概况、产品完整需求、需求变更概况、问题概况、需求确认、需求变更确认、问题确认、技术方案、实施计划、实施进度、关键决策、目标文档、报告和记忆；判定优先级为已有真相源回写 > 任务触发条件 > SimpleTaskFastPath > 子类型豁免，避免模板“必填”口径压过轻路径或条件触发。
 - **Hook closure 三态**：Stop/PreCompact 可见回复验证区分 `verified-present`、`verified-missing`、`unverified`；无法解析最终 assistant 内容时只提示无法验证，并给出 payload capture 指引，不再断言“未输出”。
 - **长流程执行契约**：Auto、控制面、多批次、预计修改 ≥10 文件或发布前置任务会触发 ExecutionContract；测试路线不明显时触发 TestRoute；正式发版前触发 ReleaseAudit 与 ReleaseVerification；控制面消费链联动时建立 Concept Sync Map；宿主契约变化时触发 `host-contract-verification`。
+- **修复协作分级**：`repair-collaboration` 由修复语义和风险触发，不由 Sol/Ultra 等模型名触发；低风险可内联 lightweight，高风险必须 full，并禁止从 executing 直接跳到 accepted。
 - **执行期 CP3 回退**：若执行过程中实际修改范围扩展到 CP3 门槛（≥5 文件、高风险、控制面联动），必须暂停执行并先补做 CP3，再继续改动。
 - **边界先确认**：若已判断为新需求切换，且当前工作区还有未提交变更，会先提醒是否应先提交当前变更。
 - **报告推荐项**：当报告中存在多个可执行建议或后续路径时，会明确给出推荐结论和推荐理由；没有建议时也会写明“推荐：无后续动作”。

RULES.md

@@ -1,6 +1,6 @@
-# DevCodex v1.11.32 — 使用入口
+# DevCodex v1.11.33 — 使用入口
 
-> AI workflow injector for Copilot / Claude Code / Codex · publisher: Rocky · version: 1.11.32
+> AI workflow injector for Copilot / Claude Code / Codex · publisher: Rocky · version: 1.11.33
 
 ## 正式主支持客户端
 

changelogs/releases/v1.11.33.md

@@ -0,0 +1,57 @@
+# v1.11.33 修复协作、Profile 真相与发布闭环
+
+## 版本信息
+
+| 项目 | 内容 |
+|------|------|
+| 版本号 | v1.11.33 |
+| 发布日期 | 2026-07-10 |
+| 变更类型 | 控制面修复 / 规范吸纳 / Profile 与发布可靠性 |
+| 风险级别 | P1（控制面与发布面） |
+| 向后兼容 | ✅ 兼容；无 CLI/public API breaking change |
+
+## 变更摘要
+
+本版本把此前分散的高风险修复、Profile 三档契约、审计只读边界和发布阻断修复合并为一个经过三轮零发现复审的正式版本，并新增三项通用治理能力：Profile 真相对账、授权本地安全审查的安全兼容呈现、发布凭据拓扑验证。验证链由 V87 扩展到 V90。
+
+## 新增能力
+
+- `DualLayerRepairCollaborationContract` / `repair-collaboration`：所有 repair task 至少使用 lightweight 双层契约，高风险修复使用 full finding-to-patch、handoff integrity 与 independent re-review；触发与模型名称无关（V87）。
+- `ProfileTruthReconciliationGate`：项目级 analyze 使用 targeted，对所有 audit 使用 full/PFresh；`ProfileTruthMatrix` 记录声明、实际来源、漂移状态、结论权威和修订路线。只读工作流只矫正结论，不直接修改 Profile（V88）。
+- `AuthorizedLocalSecurityAuditPresentationGate`：授权本地安全审查显式记录授权与防御目标，分离用户可见最小证据和隔离本地探针；安全提示发生时用 `SafetyInterruptionCard` 恢复，不承诺绕过平台控制（V89）。
+- `PublisherCredentialTopologyGate`：首次发布或 publisher/repository/package/registry/auth topology 变化时核对发布身份、secret scope/access/inheritance、workflow permission、package ownership 与成功运行证据；不读取或输出 secret value（V90）。
+
+## 修复
+
+- MCP workspace-namespace 路径 containment：新增共享 `mcp/path-guard.js`，memory/profile 工具拒绝把项目参数解析到工作区之外；补 CLI 分发依赖闭包和负向 replay。
+- Profile 三档共享契约：新增 `mcp/profile-contract.js`，bootstrap、单项目 validator 与全工作区 validator 共享 `profile-lite / profile-standard / profile-closed-loop` 必需文件与生命周期判定；PF-098 修复普通项目版本被错误对齐到 DevCodex pluginVersion 的问题。
+- PF-100 补强 source repo instance identity：同包名的历史/重构仓不再仅因 package identity 被施加当前 pluginVersion；只有显式 `--source-repo-profile` 或 exact current plugin root 才启用源码仓版本对齐，并新增 same-package/different-root 回归样例。
+- `AuditMutationBoundaryGate`：audit 只记录 finding、报告、审查状态和交接；源码/规范/配置修复必须进入独立 fix/self-fix/dev 契约。
+- 生成站点目录链接闭包：目录型链接显式指向 index，新增 `scripts/check-generated-site-links.js` 与正负向测试；fresh build 152 HTML / 0 missing。
+- 官网公开定位统一为面向使用者和集成开发者的官方文档站，维护者指南后置；修正历史任务 stale active 状态。
+
+## 消费链与 Profile
+
+- 同步 analyze/audit/release Skills、ExecutionContract、TestRoute、report、technical/implementation/report prompts、README、website guide/intro、active changelog、Profile 04~07 与 Copilot/Claude Code/Codex 受管部署副本。
+- 全工作区 `.devcodex/*/data` 扫描覆盖 23 个 namespace、64 个直接台账文件；PI-090/092、PF-096/099 与 zig-node/PI-001 已完成通用吸纳，项目局部项未被误关闭。
+
+## 验证摘要
+
+- `node scripts/test-spec-governance.js`：V88~V90 正负向通过。
+- `node scripts/validate.js`：V1~V90 全通过，V8 三宿主部署副本一致。
+- `node scripts/validate-all-profiles.js --workspace E:\Worker --strict-warnings`：34/34，errors=0，warnings=0。
+- `npm test`、`npm run test:audit`：通过，production audit 0 vulnerabilities。
+- website fresh build + generated-site checker：152 HTML / 0 missing。
+- `npm pack --dry-run`：225 files；三个新增 owner 的 source/.github/.claude/.agents SHA-256 一致。
+- 修复后审查：R1~R3 连续三轮有效零发现，CRS/PCV passed。
+
+## 发布与凭据拓扑
+
+- package=`@vextjs/devcodex`，registry=`https://npm.pkg.github.com`，repository=`vextjs/devcodex`。
+- 当前 authMode=`local-token`，源码仓无 GitHub Actions workflow，因此 workflowPermissions=`N/A + no-workflow`；发布使用项目既有本地认证配置，不读取或记录 token value。
+- 正式发布继续执行 npm publish dry-run、pack install smoke、main/tag push、registry/tag/install R7 后验收。
+
+## 已知非阻断尾项
+
+- F-007 requirements/sidebar 映射、F-008 destination-only managed manifest、F-010 ledger canonical state、F-011 远端 CI/coverage 继续作为 transferred 后续项。
+- F-012 validator/test 单体拆分按用户要求延后，不在 v1.11.33 扩张。