diff --git a/refactor/baselines/engineering-integration.json b/refactor/baselines/engineering-integration.json new file mode 100644 index 000000000..0939eb7cc --- /dev/null +++ b/refactor/baselines/engineering-integration.json @@ -0,0 +1,99 @@ +{ + "schemaVersion": 1, + "task": "ENG-09", + "status": "done", + "sourceCommit": "f35fb876155f1ff1dc67b3ef90cedf33ccc5cf17", + "children": [ + "e0aacc5d", + "6abac891", + "f35fb876" + ], + "checks": { + "commitAudit": { + "doneTasks": 83, + "bootstrapException": 4 + }, + "impact": { + "coreAffectedPackages": [ + "artplayer", + "artplayer-plugin-ads", + "artplayer-plugin-ambilight", + "artplayer-plugin-asr", + "artplayer-plugin-audio-track", + "artplayer-plugin-auto-thumbnail", + "artplayer-plugin-chapter", + "artplayer-plugin-chromecast", + "artplayer-plugin-danmuku", + "artplayer-plugin-danmuku-mask", + "artplayer-plugin-dash-control", + "artplayer-plugin-document-pip", + "artplayer-plugin-hls-control", + "artplayer-plugin-jassub", + "artplayer-plugin-multiple-subtitles", + "artplayer-plugin-vast", + "artplayer-plugin-vtt-thumbnail", + "artplayer-proxy-canvas", + "artplayer-proxy-mediabunny", + "artplayer-tool-iframe", + "artplayer-tool-thumbnail", + "artplayer-vitepress" + ], + "requiredChecks": [ + { + "job": "checks", + "command": "yarn ci:check", + "scope": "Toolchain, task/commit/impact contracts, lint, current strict projects and existing Node/baseline suites" + }, + { + "job": "checks", + "command": "yarn ci:build", + "scope": "All library builds, i18n, editor declarations, docs site and existing import suites" + }, + { + "job": "browser-smoke", + "command": "yarn test:package", + "scope": "Installed core/chapter consumers only; other package installation acceptance remains pending" + }, + { + "job": "browser-smoke", + "command": "yarn test:browser", + "scope": "All existing three-engine browser suites; does not imply every package/device has a suite" + }, + { + "job": "browser-smoke", + "command": "yarn test:performance", + "scope": "Existing installed performance and resource-cleanup scenarios" + }, + { + "job": "coverage", + "command": "yarn test:coverage", + "scope": "Current coverage-policy packages and critical module thresholds only" + } + ] + }, + "contracts": { + "assignedRows": 264, + "missingTestIndexRows": 255 + }, + "plan": "220 tasks, dependency graph and local links passed" + }, + "logs": [ + { + "file": "refactor/.cache/engineering-audit.log", + "sha256": "ded400ec2bbeda75467e05b24538ceff422dd7480e417b37f992dafb40f6bcaa" + }, + { + "file": "refactor/.cache/engineering-impact.log", + "sha256": "edb61dc20791ba4edeb2e6c15556ed009fe31f02673edf0f5e643b7ae45bf116" + }, + { + "file": "refactor/.cache/engineering-contracts.log", + "sha256": "a426ed65f4730328ef110d95762ccc64dfdd81862310f8047e71e4c3f602516a" + } + ], + "limitations": [ + "Integration checks only; no new full CI/browser run claimed", + "Exact support ranges, exhaustive member mapping, installed consumers and device/vendor gates remain in package/REVIEW/REL tasks", + "No remote Actions, push or npm publish" + ] +} diff --git a/refactor/changes/2026-09-12-ENG-09-integration.md b/refactor/changes/2026-09-12-ENG-09-integration.md new file mode 100644 index 000000000..e943edc40 --- /dev/null +++ b/refactor/changes/2026-09-12-ENG-09-integration.md @@ -0,0 +1,20 @@ +# ENG-09 全包影响、文档与提交检查整合 + +本任务整合三个已独立提交的子项:ENG-AUDIT-01(e0aacc5d)、ENG-IMPACT-01(6abac891) +和ENG-COVERAGE-01(f35fb876)。不重复计算其单元测试,也不将工程门槛当作包发布验收。 + +| 验收项 | 实际实现和限制 | +| --- | --- | +| 核心/共享变更触发全生态 | impact-policy及实际导入/manifest关系,核心影响22包;六类CI门槛保持执行,未知路径扩大范围 | +| 每完成任务独立提交 | commit-audit读取真实Git状态迁移及证据;DOC-01至04仅有固定历史bootstrap例外 | +| 契约与版本责任 | 12类契约×22包有归属,29个冻结版本对照点;不据此推断连续支持窗口 | +| 测试与报告对应 | 固定ID、断言标题、真实Node事件和候选输入指纹;当前10项精确索引,255行仍需补录 | +| 文档/CI一致 | 静态表检查、命令接入顺序及必需workflow检查可运行;大型/动态报告进入既有CI artifact目录 | + +本轮重跑提交审计、影响分析、契约/文档检查并保存结构化整合结果。完整主CI918项及 +44项重复观察执行沿用子项f35fb876对应的证据,未因本轮只改文档/状态重新宣称全套执行。 +精确来源见 [整合验证](../baselines/engineering-integration.json)。 + +仍需后续各包契约任务逐成员映射与类型/浏览器/设备/SDK验证,CI-04负责真实远端运行; +REVIEW/REL负责发布准入。当前统一安装消费者只有core/chapter,其他包的历史专属测试 +不能被统一脚本范围替代。本任务不推送或发布。完成后按独立commit审计本任务自身。 diff --git a/refactor/plan.md b/refactor/plan.md index b5cf227a4..5b0fe70c1 100644 --- a/refactor/plan.md +++ b/refactor/plan.md @@ -4,7 +4,7 @@ 基线:`40fcda6a37d0049d42e49c1e64e70d4fd9ba5f7f`。总任务 220 项,范围 22 个包及工作区/示例。 -状态:todo 131 / doing 6 / blocked 0 / done 83 / deferred 0。风险 L/M/H 表示兼容风险,不表示工期。 +状态:todo 130 / doing 6 / blocked 0 / done 84 / deferred 0。风险 L/M/H 表示兼容风险,不表示工期。 前置依赖是启动条件;验收是完成条件。任务可以继续拆分,但不能复用或悄悄删除旧 ID。 @@ -85,7 +85,7 @@ | ENG-AUDIT-01 | workspace
核对每任务完成提交的真实Git历史 | ENG-07, DOC-04 | 独立完成提交、初始DOC例外、父分支合并和证据共提交审计;CI完整历史与报告 | 真实仓库及隔离Git反例通过,done任务不允许缺独立commit,固定DOC-01~04例外可追溯;提交后验证自身 | M | done | | ENG-IMPACT-01 | workspace
建立全包依赖与共享变更影响映射 | ENG-07, DOC-04 | 核心/构建/类型/锁文件到受影响包和必需生态检查的映射及CI接入 | 核心变化触发必需生态检查;新增包、未知共享文件或失配依赖不能静默漏检;解释受影响路径和测试命令 | M | done | | ENG-COVERAGE-01 | workspace
建立公开契约与版本测试证据覆盖索引 | BASE-08, CORE-22, ENG-07 | 契约-包-支持版本-固定测试ID-命令-候选/报告-责任任务索引和文档检查 | 计划、已执行和缺证据状态分开,所有公开契约都有验证归属;无效路径、版本依据或报告对应不明确会被识别 | M | done | -| ENG-09 | workspace
建立全包依赖影响和文档检查 | ENG-07, DOC-04, ENG-AUDIT-01, ENG-IMPACT-01, ENG-COVERAGE-01 | 共享核心/构建影响映射、文档及每任务完成提交的 Git 审计接入;契约-支持版本-测试 ID-命令-候选/报告-任务的覆盖索引 | 核心变化触发必需生态检查;原有 DOC-01 至 04 基线例外明确,后续 done 任务不能缺失独立 commit;计划/已执行/缺证据分开,识别缺少验证归属的公开契约 | M | todo | +| ENG-09 | workspace
建立全包依赖影响和文档检查 | ENG-07, DOC-04, ENG-AUDIT-01, ENG-IMPACT-01, ENG-COVERAGE-01 | 共享核心/构建影响映射、文档及每任务完成提交的 Git 审计接入;契约-支持版本-测试 ID-命令-候选/报告-任务的覆盖索引 | 核心变化触发必需生态检查;原有 DOC-01 至 04 基线例外明确,后续 done 任务不能缺失独立 commit;计划/已执行/缺证据分开,识别缺少验证归属的公开契约 | M | done | | ENG-10 | workspace
建立历史失败分级和测试可靠性规则 | ENG-03, ENG-04, ENG-05, ENG-07, BASE-07 | 历史失败 ID/环境/旧版复现/负责修复任务、逐模块门槛、受控等待与 trace/retry 规则 | 不靠全局忽略或无理由 skip 隐藏问题,新增回归阻止交付,设备缺口和偶发失败单独可见;以 risks.json 为统一差异索引;关闭必须有 resolutionEvidence/rationale,已复现、源码事实、未验证分开,登记不等于豁免 | M | done | | ENG-11 | workspace
增加不改变产物的模块构建分析 | ENG-03, ENG-08 | 正式构建的可选模块归因报告及源码/产物指纹 | 相同构建开关前后三格式字节一致,报告不进入分发包;区分 Rollup 渲染字节与压缩体积,并保留真实工作区/发布来源 | L | done | @@ -443,6 +443,7 @@ - ENG-AUDIT-01: [记录](commit-audit.md) [记录](changes/2026-09-12-ENG-AUDIT-01-commits.md) [记录](baselines/commit-audit-validation.json) - ENG-IMPACT-01: [记录](impact-analysis.md) [记录](changes/2026-09-12-ENG-IMPACT-01-mapping.md) [记录](baselines/impact-validation.json) - ENG-COVERAGE-01: [记录](contract-coverage.md) [记录](contract-index.md) [记录](changes/2026-09-12-ENG-COVERAGE-01-index.md) [记录](baselines/contracts-validation.json) +- ENG-09: [记录](changes/2026-09-12-ENG-09-integration.md) [记录](baselines/engineering-integration.json) - ENG-10: [记录](changes/2026-09-10-ENG-10-test-reliability.md) [记录](test-reliability.md) - ENG-11: [记录](build-analysis.md) [记录](baselines/bundle-attribution.json) [记录](changes/2026-09-11-ENG-11-build-analysis.md) - PILOT-01: [记录](changes/2026-09-10-PILOT-01-chapter.md) [记录](baselines/pilot-validation.json) diff --git a/refactor/progress.md b/refactor/progress.md index ffa78e2f9..05de2f8c8 100644 --- a/refactor/progress.md +++ b/refactor/progress.md @@ -1,5 +1,13 @@ # 进度与证据 +## 最新完成:ENG-09 工程保障整合 + +提交审计、核心到22包影响映射、264行契约归属和文档检查整合核验通过;三个子项已有 +独立提交,保留DOC-01至04固定例外及255行精确测试索引缺口。本轮仅重跑整合检查, +完整CI沿用已提交子项证据,不声称新设备或发布验收。当前220项:84 done、6 doing、 +130 todo。见 [整合记录](changes/2026-09-12-ENG-09-integration.md) 和 +[验证证据](baselines/engineering-integration.json)。下一步继续Ambilight契约及源码迁移。 + ## 最新完成:ENG-COVERAGE-01 契约归属及精确证据索引 22包×12类契约共264行已分配验证任务,29个冻结版本对照点可校验。逐条核对10个已有 diff --git a/refactor/tasks.json b/refactor/tasks.json index a3908f9b2..a449d3da0 100644 --- a/refactor/tasks.json +++ b/refactor/tasks.json @@ -683,11 +683,14 @@ "ENG-IMPACT-01", "ENG-COVERAGE-01" ], - "status": "todo", + "status": "done", "risk": "M", "deliverable": "共享核心/构建影响映射、文档及每任务完成提交的 Git 审计接入;契约-支持版本-测试 ID-命令-候选/报告-任务的覆盖索引", "acceptance": "核心变化触发必需生态检查;原有 DOC-01 至 04 基线例外明确,后续 done 任务不能缺失独立 commit;计划/已执行/缺证据分开,识别缺少验证归属的公开契约", - "evidence": [] + "evidence": [ + "changes/2026-09-12-ENG-09-integration.md", + "baselines/engineering-integration.json" + ] }, { "scope": [