svharness 0.14.1 → 0.14.2

package/README.md

@@ -168,7 +168,7 @@ harness-build-{skill|rule}-<semantic-name>
 | 资源类型 | 目录 | 命名模式 | 现有成员 |
 |----------|------|----------|----------|
 | **Build skill** | `templates/_shared/build-skills/` | `harness-build-skill-<name>.md` | `skills-main` / `orchestrator` / `spec-builder` / `references-intake` / `agent-env-merge` / `knowledge-builder` / `wiki-writer` |
-| **Build rule** | `templates/_shared/build-rules/` | `harness-build-rule-<name>.md` | `agent-agnostic` / `chinese-only` / `memory-write` / `orchestrator-flow` / `skills-tasks-output` / `specs-schema` / `user-interaction` |
+| **Build rule** | `templates/_shared/build-rules/` | `harness-build-rule-<name>.md` | `agent-agnostic` / `chinese-only` / `memory-write` / `orchestrator-flow` / `requirements-extraction` / `skills-tasks-output` / `specs-schema` / `user-interaction` |
 
 约束：
 
@@ -183,10 +183,10 @@ harness-build-{skill|rule}-<semantic-name>
 | 阶段 | 动作 | 产物 |
 |------|------|------|
 | **S10_wiki** | 构建 baseline wiki（仅当有 baseline 时出现，项目经验底座） | `baseline/wiki/` |
-| **S20_collect_inputs** | 添加相关文件：需求/参考文档 + 额外运行期资源征询（`--extra-skills` 单入口，可混放 skills/rules） | `requirements/raw/` + `references/raw/` + `agent-env/_incoming/skills/` |
+| **S20_collect_inputs** | 添加相关文件：需求/参考文档 + 额外运行期资源征询（`--extra-skills` 单入口，可混放 skills/rules） | `requirements/raw/` + `references/raw/` + `agent-env/_incoming/skills/` + `task_list.md` |
 | **S30_convert_docs** | 非 Markdown 原始文档转 Markdown | `requirements/md/` + `references/md/` |
-| **S40_extract_requirements** | 条目化需求 | `requirements/yaml/*.yaml` |
-| **S50_generate_specs** | 生成规格 | `specs/<layer>/<module>.<layer>.yaml` + schema 校验 |
+| **S40_extract_requirements** | 条目化需求 + 覆盖率门禁 | `requirements/yaml/*.yaml` + `requirements/coverage-report.yaml` |
+| **S50_generate_specs** | 生成规格 + REQ→spec 覆盖 | `specs/<layer>/<module>.<layer>.yaml` + schema 校验 + 覆盖率结果 |
 | **S60_process_references** | references 处理（`svharness convert` + 结构化索引 + 用户确认落地） | `references/md/` |
 | **S61_confirm_baseline_extraction** | 确认是否自动从 baseline 提取 skills/rules（表单确认） | `.harness-build-state.yaml`（`phases.S61_confirm_baseline_extraction.baseline_auto_extract`） |
 | **S65_customize_agent_env** | agent-env 定制（extra-skills/extra-rules 冲突建议与重命名建议 → 用户确认 → 写入） | `agent-env/rules/` + `agent-env/skills/` |
@@ -201,6 +201,7 @@ harness-build-{skill|rule}-<semantic-name>
 > **S60_process_references 专注 references：必须执行 `svharness convert`，并产出结构化索引（规制约束 / skills 候选 / signals / manuals），经表单确认后再进入后续阶段。**
 > **S61_confirm_baseline_extraction 必须显式确认是否启用 baseline 自动提取 skills/rules；未经确认不得在 S65 自动提取。**
 > **S65_customize_agent_env 专注 extra-skills/extra-rules：来源可来自 `--extra-skills` 导入后的 `_incoming/manifest.yaml`，先冲突识别与重命名建议，再表单确认写入；推荐命名：`harness-apply-skills-<topic>` 与 `harness-apply-rules-<topic>.md/.mdc`。**
+> **S40/S50/S85 的 DONE 都带覆盖率门禁：未闭环 gap（或未备案 waiver）不得推进。**
 
 ---
 
@@ -416,7 +417,15 @@ svharness doctor --harness ./my-app-harness --mode pre-seal --format json --repo
 | `--report` | JSON 报告路径（默认 `<harness>/doctor-report.json`） |
 | `--strict` | 将 warning 视为 error |
 
-退出码：`0` 通过，`1` 存在 error。通过 doctor 后，由 `harness-build-skill-pre-seal-review` 完成语义层全面审查并经用户确认，方可将 S85 标为 DONE 并进入 S90。
+退出码：`0` 通过，`1` 存在 error。
+
+**S85 Agent 审查（合并 skill）**：doctor 通过后，由 `harness-build-skill-pre-seal-review`（v2，已吸收 `harness-build-harness-data-review`）产出 **`HARNESS-REVIEW-REPORT.md`**：
+
+- **Part A**：从 `harness.yaml` 发现 assets，完整性清单（arch-agnostic）
+- **Part B**：按 `specs.layers` 与 `agent-env/review-profiles/<arch>.yaml` 做深度评分
+- **门禁**：`overall_score >= 5.0`（C 级）、`critical_count == 0`、报告 frontmatter `gate_pass: true`、用户表单确认
+
+`doctor` 另含 `check-review-report`（warning）：S85 已 DONE 时校验报告 frontmatter 与 state 中 `review_gate_pass` 一致。数量覆盖率阻断仍由 S40/S50 表单门禁负责。
 
 ### `convert` —— 文档 → Markdown 预处理（对接 S20_collect_inputs）
 

package/dist/commands/doctor/check-bootstrap.js

@@ -8,12 +8,14 @@ async function checkBootstrap(ctx) {
     if (ctx.mode !== 'pre-seal') {
         return { id, title: 'Bootstrap 模式', findings };
     }
-    const harness = await (0, utils_1.readHarnessYaml)(ctx.harnessRoot);
+    const { doc: harness, error } = await (0, utils_1.readHarnessYaml)(ctx.harnessRoot);
     if (!harness) {
         findings.push({
             checkId: id,
             severity: 'error',
-            message: '缺少或无法解析 harness.yaml',
+            message: error
+                ? `无法解析 harness.yaml：${error}`
+                : '缺少 harness.yaml',
             path: 'harness.yaml',
         });
         return { id, title: 'Bootstrap 模式', findings };

package/dist/commands/doctor/check-empty-dirs.js

@@ -7,28 +7,36 @@ exports.checkEmptyDirs = checkEmptyDirs;
 const fs_extra_1 = __importDefault(require("fs-extra"));
 const node_path_1 = __importDefault(require("node:path"));
 const utils_1 = require("./utils");
-async function collectEmptyDirs(harnessRoot, dir, findings, checkId) {
+async function collectEmptyDirs(ctx, dir, findings, checkId) {
     if (!(await fs_extra_1.default.pathExists(dir)))
         return;
+    const state = await (0, utils_1.readBuildState)(ctx.harnessRoot);
     const entries = await fs_extra_1.default.readdir(dir, { withFileTypes: true });
     for (const ent of entries) {
         if (ent.name.startsWith('.') && ent.name !== '.gitkeep')
             continue;
         const full = node_path_1.default.join(dir, ent.name);
         if (ent.isDirectory()) {
-            const relPath = (0, utils_1.rel)(harnessRoot, full);
+            const relPath = (0, utils_1.rel)(ctx.harnessRoot, full);
+            if ((0, utils_1.isBaselineCodeMirror)(relPath))
+                continue;
+            if ((0, utils_1.isSkillReferencePlaceholder)(relPath))
+                continue;
             if (utils_1.EMPTY_DIR_WHITELIST.has(relPath)) {
-                await collectEmptyDirs(harnessRoot, full, findings, checkId);
+                await collectEmptyDirs(ctx, full, findings, checkId);
                 continue;
             }
             if (relPath === 'agent-env/_incoming/skills') {
-                const state = await (0, utils_1.readBuildState)(harnessRoot);
                 const s65 = state?.phases.S65_customize_agent_env;
                 if (s65?.status === 'DONE') {
-                    await collectEmptyDirs(harnessRoot, full, findings, checkId);
+                    await collectEmptyDirs(ctx, full, findings, checkId);
                     continue;
                 }
             }
+            if ((0, utils_1.isDeferredEmptyDir)(relPath, ctx.mode, state)) {
+                await collectEmptyDirs(ctx, full, findings, checkId);
+                continue;
+            }
             if (await (0, utils_1.isEmptyOrGitkeepOnly)(full)) {
                 findings.push({
                     checkId,
@@ -38,7 +46,7 @@ async function collectEmptyDirs(harnessRoot, dir, findings, checkId) {
                 });
             }
             else {
-                await collectEmptyDirs(harnessRoot, full, findings, checkId);
+                await collectEmptyDirs(ctx, full, findings, checkId);
             }
         }
     }
@@ -46,6 +54,6 @@ async function collectEmptyDirs(harnessRoot, dir, findings, checkId) {
 async function checkEmptyDirs(ctx) {
     const id = 'empty-dirs';
     const findings = [];
-    await collectEmptyDirs(ctx.harnessRoot, ctx.harnessRoot, findings, id);
+    await collectEmptyDirs(ctx, ctx.harnessRoot, findings, id);
     return { id, title: '空目录检查', findings };
 }

package/dist/commands/doctor/check-memory.js

@@ -10,8 +10,9 @@ async function checkMemory(ctx) {
     const id = 'memory';
     const findings = [];
     const categoriesDir = node_path_1.default.join(ctx.harnessRoot, 'agent-env', 'memory', 'categories');
+    const state = await (0, utils_1.readBuildState)(ctx.harnessRoot);
     const mdFiles = await (0, utils_1.listRealFilesRecursive)(categoriesDir, { extensions: ['.md'] });
-    if (mdFiles.length === 0) {
+    if (mdFiles.length === 0 && !(0, utils_1.isPhaseNotReached)(ctx.mode, state, 'S80_seed_memory')) {
         findings.push({
             checkId: id,
             severity: 'error',

package/dist/commands/doctor/check-requirements-coverage.js

@@ -0,0 +1,100 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkRequirementsCoverage = checkRequirementsCoverage;
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const node_path_1 = __importDefault(require("node:path"));
+const js_yaml_1 = __importDefault(require("js-yaml"));
+const utils_1 = require("./utils");
+const SOURCE_ANCHOR_RE = /SyRD-[\w-]+/g;
+const WILDCARD_RE = /\*/;
+function collectStringValues(node, out) {
+    if (typeof node === 'string') {
+        out.push(node);
+        return;
+    }
+    if (Array.isArray(node)) {
+        for (const item of node)
+            collectStringValues(item, out);
+        return;
+    }
+    if (node && typeof node === 'object') {
+        for (const value of Object.values(node)) {
+            collectStringValues(value, out);
+        }
+    }
+}
+function collectAnchors(node, out) {
+    const values = [];
+    collectStringValues(node, values);
+    for (const value of values) {
+        const matches = value.match(SOURCE_ANCHOR_RE);
+        if (!matches)
+            continue;
+        for (const m of matches)
+            out.add(m);
+    }
+}
+async function checkRequirementsCoverage(ctx) {
+    const id = 'requirements-coverage';
+    const findings = [];
+    const state = await (0, utils_1.readBuildState)(ctx.harnessRoot);
+    const coveragePath = node_path_1.default.join(ctx.harnessRoot, 'requirements', 'coverage-report.yaml');
+    const hasCoverageReport = await fs_extra_1.default.pathExists(coveragePath);
+    const s40Done = state?.phases?.S40_extract_requirements?.status === 'DONE';
+    if (s40Done && !hasCoverageReport) {
+        findings.push({
+            checkId: id,
+            severity: 'warning',
+            message: 'S40_extract_requirements 已是 DONE，但缺少 requirements/coverage-report.yaml',
+            path: 'requirements/coverage-report.yaml',
+        });
+    }
+    const mdDir = node_path_1.default.join(ctx.harnessRoot, 'requirements', 'md');
+    const yamlDir = node_path_1.default.join(ctx.harnessRoot, 'requirements', 'yaml');
+    const mdFiles = await (0, utils_1.listRealFilesRecursive)(mdDir, { extensions: ['.md'] });
+    const reqYamlFiles = (await (0, utils_1.listRealFilesRecursive)(yamlDir, { extensions: ['.yaml', '.yml'] })).filter((f) => !f.endsWith('schema.json'));
+    const mdAnchors = new Set();
+    for (const mdFile of mdFiles) {
+        const raw = await fs_extra_1.default.readFile(mdFile, 'utf8');
+        const matches = raw.match(SOURCE_ANCHOR_RE);
+        if (!matches)
+            continue;
+        for (const m of matches)
+            mdAnchors.add(m);
+    }
+    const yamlAnchors = new Set();
+    for (const yamlFile of reqYamlFiles) {
+        try {
+            const parsed = js_yaml_1.default.load(await fs_extra_1.default.readFile(yamlFile, 'utf8'));
+            collectAnchors(parsed, yamlAnchors);
+            const values = [];
+            collectStringValues(parsed, values);
+            if (values.some((v) => WILDCARD_RE.test(v) && /SyRD-|REQ-/i.test(v))) {
+                findings.push({
+                    checkId: id,
+                    severity: 'warning',
+                    message: '检测到可能的通配符聚合锚点，请确认已备案 aggregates/waiver',
+                    path: (0, utils_1.rel)(ctx.harnessRoot, yamlFile),
+                });
+            }
+        }
+        catch {
+            // parse errors are handled by check-requirements
+        }
+    }
+    if (mdAnchors.size > 0) {
+        const ratio = yamlAnchors.size / mdAnchors.size;
+        if (ratio < 0.5) {
+            findings.push({
+                checkId: id,
+                severity: 'warning',
+                message: `requirements 锚点覆盖率偏低（${yamlAnchors.size}/${mdAnchors.size}=${ratio.toFixed(3)}）`,
+                path: 'requirements',
+            });
+        }
+    }
+    return { id, title: '需求覆盖率', findings };
+}

package/dist/commands/doctor/check-requirements.js

@@ -13,6 +13,7 @@ async function checkRequirements(ctx) {
     const findings = [];
     const rawDir = node_path_1.default.join(ctx.harnessRoot, 'requirements', 'raw');
     const yamlDir = node_path_1.default.join(ctx.harnessRoot, 'requirements', 'yaml');
+    const state = await (0, utils_1.readBuildState)(ctx.harnessRoot);
     const rawFiles = await (0, utils_1.listRealFilesRecursive)(rawDir);
     if (rawFiles.length === 0) {
         findings.push({
@@ -24,12 +25,14 @@ async function checkRequirements(ctx) {
     }
     const yamlFiles = (await (0, utils_1.listRealFilesRecursive)(yamlDir, { extensions: ['.yaml', '.yml'] })).filter((f) => !f.endsWith('schema.json'));
     if (yamlFiles.length === 0) {
-        findings.push({
-            checkId: id,
-            severity: 'error',
-            message: 'requirements/yaml/ 无条目化 YAML 产出',
-            path: 'requirements/yaml',
-        });
+        if (!(0, utils_1.isPhaseNotReached)(ctx.mode, state, 'S40_extract_requirements')) {
+            findings.push({
+                checkId: id,
+                severity: 'error',
+                message: 'requirements/yaml/ 无条目化 YAML 产出',
+                path: 'requirements/yaml',
+            });
+        }
     }
     else {
         for (const file of yamlFiles) {

package/dist/commands/doctor/check-review-report.js

@@ -0,0 +1,113 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkReviewReport = checkReviewReport;
+const node_path_1 = __importDefault(require("node:path"));
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const js_yaml_1 = __importDefault(require("js-yaml"));
+const utils_1 = require("./utils");
+function parseFrontmatter(content) {
+    const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
+    if (!match)
+        return null;
+    try {
+        return js_yaml_1.default.load(match[1]);
+    }
+    catch {
+        return null;
+    }
+}
+async function checkReviewReport(ctx) {
+    const id = 'review-report';
+    const findings = [];
+    const state = await (0, utils_1.readBuildState)(ctx.harnessRoot);
+    const s85 = state?.phases?.S85_pre_seal_validation;
+    const reportRel = (s85 && typeof s85 === 'object' && 'review_report_path' in s85 && s85.review_report_path) ||
+        'HARNESS-REVIEW-REPORT.md';
+    const reportPath = node_path_1.default.join(ctx.harnessRoot, String(reportRel));
+    if (ctx.mode !== 'pre-seal' && ctx.mode !== 'health') {
+        return { id, title: '深度审查报告', findings };
+    }
+    if (!s85) {
+        if (ctx.mode === 'pre-seal') {
+            findings.push({
+                checkId: id,
+                severity: 'warning',
+                message: '状态文件缺少 S85_pre_seal_validation 阶段定义',
+            });
+        }
+        return { id, title: '深度审查报告', findings };
+    }
+    const s85Done = s85.status === 'DONE';
+    if (!(await fs_extra_1.default.pathExists(reportPath))) {
+        if (s85Done) {
+            findings.push({
+                checkId: id,
+                severity: 'warning',
+                message: `S85 已为 DONE，但未找到审查报告 ${reportRel}`,
+                path: (0, utils_1.rel)(ctx.harnessRoot, reportPath),
+            });
+        }
+        return { id, title: '深度审查报告', findings };
+    }
+    const content = await fs_extra_1.default.readFile(reportPath, 'utf8');
+    const fm = parseFrontmatter(content);
+    if (!fm) {
+        findings.push({
+            checkId: id,
+            severity: 'warning',
+            message: `${reportRel} 缺少可解析的 YAML frontmatter（需 gate_pass、overall_score 等）`,
+            path: (0, utils_1.rel)(ctx.harnessRoot, reportPath),
+        });
+        return { id, title: '深度审查报告', findings };
+    }
+    const minScore = typeof s85 === 'object' && 'min_depth_score' in s85 && s85.min_depth_score != null
+        ? Number(s85.min_depth_score)
+        : 5.0;
+    if (fm.gate_pass !== true) {
+        findings.push({
+            checkId: id,
+            severity: s85Done ? 'warning' : 'info',
+            message: `审查报告 gate_pass 不为 true（当前：${String(fm.gate_pass)}）`,
+            path: (0, utils_1.rel)(ctx.harnessRoot, reportPath),
+        });
+    }
+    if (typeof fm.overall_score === 'number' && fm.overall_score < minScore) {
+        findings.push({
+            checkId: id,
+            severity: 'warning',
+            message: `overall_score ${fm.overall_score} 低于门禁 ${minScore}`,
+            path: (0, utils_1.rel)(ctx.harnessRoot, reportPath),
+        });
+    }
+    if (typeof fm.critical_count === 'number' && fm.critical_count > 0) {
+        findings.push({
+            checkId: id,
+            severity: 'warning',
+            message: `critical_count=${fm.critical_count}，深度审查存在 Critical 差距`,
+            path: (0, utils_1.rel)(ctx.harnessRoot, reportPath),
+        });
+    }
+    if (s85Done) {
+        if (typeof s85 === 'object' && s85.review_gate_pass !== true) {
+            findings.push({
+                checkId: id,
+                severity: 'warning',
+                message: 'S85 为 DONE 但 review_gate_pass 不为 true，与报告/frontmatter 不一致',
+            });
+        }
+        if (typeof s85 === 'object' &&
+            'critical_gaps' in s85 &&
+            typeof s85.critical_gaps === 'number' &&
+            s85.critical_gaps > 0) {
+            findings.push({
+                checkId: id,
+                severity: 'warning',
+                message: `S85 为 DONE 但 critical_gaps=${s85.critical_gaps}`,
+            });
+        }
+    }
+    return { id, title: '深度审查报告', findings };
+}

package/dist/commands/doctor/check-skills-tasks.js

@@ -90,8 +90,9 @@ async function checkSkillsTasks(ctx) {
             }
         }
     }
+    const state = await (0, utils_1.readBuildState)(ctx.harnessRoot);
     const categoryCount = await countTaskCategories(templatesDir);
-    if (categoryCount < 3) {
+    if (categoryCount < 3 && !(0, utils_1.isPhaseNotReached)(ctx.mode, state, 'S70_runtime_assets')) {
         findings.push({
             checkId: id,
             severity: 'error',

package/dist/commands/doctor/check-specs.js

@@ -16,6 +16,8 @@ async function checkSpecs(ctx) {
     const findings = [];
     const ajv = new ajv_1.default({ allErrors: true, strict: false });
     (0, ajv_formats_1.default)(ajv);
+    const state = await (0, utils_1.readBuildState)(ctx.harnessRoot);
+    const deferSpecs = (0, utils_1.isPhaseNotReached)(ctx.mode, state, 'S50_generate_specs');
     for (const domain of SPEC_DOMAINS) {
         const domainDir = node_path_1.default.join(ctx.harnessRoot, 'specs', domain);
         const schemaPath = node_path_1.default.join(domainDir, 'schema.json');
@@ -31,12 +33,14 @@ async function checkSpecs(ctx) {
         const specFiles = (await (0, utils_1.listRealFilesRecursive)(domainDir, { extensions: ['.yaml', '.yml'] })).filter((f) => !f.endsWith('schema.json') && !f.endsWith('schema.yaml'));
         const moduleYaml = specFiles.filter((f) => node_path_1.default.basename(f) !== 'schema.json');
         if (moduleYaml.length === 0) {
-            findings.push({
-                checkId: id,
-                severity: 'error',
-                message: `specs/${domain}/ 无模块 YAML（除 schema.json 外）`,
-                path: `specs/${domain}`,
-            });
+            if (!deferSpecs) {
+                findings.push({
+                    checkId: id,
+                    severity: 'error',
+                    message: `specs/${domain}/ 无模块 YAML（除 schema.json 外）`,
+                    path: `specs/${domain}`,
+                });
+            }
             continue;
         }
         let validate;

package/dist/commands/doctor/check-state-phases.js

@@ -5,6 +5,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.checkStatePhases = checkStatePhases;
 const node_path_1 = __importDefault(require("node:path"));
+const fs_extra_1 = __importDefault(require("fs-extra"));
 const utils_1 = require("./utils");
 const PRE_SEAL_PHASES = [
     'S00_bootstrap',
@@ -89,5 +90,27 @@ async function checkStatePhases(ctx) {
             message: '状态文件缺少 S85_pre_seal_validation，请由 orchestrator 补丁插入后再封存',
         });
     }
+    if (state.phases.S40_extract_requirements?.status === 'DONE') {
+        const coveragePath = node_path_1.default.join(ctx.harnessRoot, 'requirements', 'coverage-report.yaml');
+        if (!(await fs_extra_1.default.pathExists(coveragePath))) {
+            findings.push({
+                checkId: id,
+                severity: 'warning',
+                message: 'S40_extract_requirements 已 DONE，但未找到 requirements/coverage-report.yaml',
+                path: (0, utils_1.rel)(ctx.harnessRoot, coveragePath),
+            });
+        }
+    }
+    if (state.phases.S50_generate_specs?.status === 'DONE') {
+        const specCoveragePath = node_path_1.default.join(ctx.harnessRoot, 'specs', 'coverage-report.yaml');
+        if (!(await fs_extra_1.default.pathExists(specCoveragePath))) {
+            findings.push({
+                checkId: id,
+                severity: 'warning',
+                message: 'S50_generate_specs 已 DONE，但未找到 specs/coverage-report.yaml',
+                path: (0, utils_1.rel)(ctx.harnessRoot, specCoveragePath),
+            });
+        }
+    }
     return { id, title: '构建阶段状态', findings };
 }

package/dist/commands/doctor/index.js

@@ -44,6 +44,7 @@ const check_state_phases_1 = require("./check-state-phases");
 const check_empty_dirs_1 = require("./check-empty-dirs");
 const check_convert_pairing_1 = require("./check-convert-pairing");
 const check_requirements_1 = require("./check-requirements");
+const check_requirements_coverage_1 = require("./check-requirements-coverage");
 const check_specs_1 = require("./check-specs");
 const check_references_1 = require("./check-references");
 const check_skills_tasks_1 = require("./check-skills-tasks");
@@ -53,6 +54,7 @@ const check_wiki_1 = require("./check-wiki");
 const check_policy_grep_1 = require("./check-policy-grep");
 const check_chinese_heuristic_1 = require("./check-chinese-heuristic");
 const check_bootstrap_1 = require("./check-bootstrap");
+const check_review_report_1 = require("./check-review-report");
 const report_1 = require("./report");
 var report_2 = require("./report");
 Object.defineProperty(exports, "formatDoctorReportText", { enumerable: true, get: function () { return report_2.formatDoctorReportText; } });
@@ -71,6 +73,7 @@ async function runDoctorChecks(input) {
         check_empty_dirs_1.checkEmptyDirs,
         check_convert_pairing_1.checkConvertPairing,
         check_requirements_1.checkRequirements,
+        check_requirements_coverage_1.checkRequirementsCoverage,
         check_specs_1.checkSpecs,
         check_references_1.checkReferences,
         check_skills_tasks_1.checkSkillsTasks,
@@ -79,6 +82,7 @@ async function runDoctorChecks(input) {
         check_wiki_1.checkWiki,
         check_policy_grep_1.checkPolicyGrep,
         check_chinese_heuristic_1.checkChineseHeuristic,
+        check_review_report_1.checkReviewReport,
     ];
     const checks = [];
     for (const run of runners) {

package/dist/commands/doctor/utils.js

@@ -13,9 +13,14 @@ exports.isEmptyOrGitkeepOnly = isEmptyOrGitkeepOnly;
 exports.basenameWithoutExt = basenameWithoutExt;
 exports.readBuildState = readBuildState;
 exports.readHarnessYaml = readHarnessYaml;
+exports.isPhaseNotReached = isPhaseNotReached;
+exports.isDeferredEmptyDir = isDeferredEmptyDir;
+exports.isBaselineCodeMirror = isBaselineCodeMirror;
+exports.isSkillReferencePlaceholder = isSkillReferencePlaceholder;
 const fs_extra_1 = __importDefault(require("fs-extra"));
 const node_path_1 = __importDefault(require("node:path"));
 const js_yaml_1 = __importDefault(require("js-yaml"));
+const yaml_safe_path_1 = require("../../utils/yaml-safe-path");
 const SKIP_FILE_NAMES = new Set(['.gitkeep', '.DS_Store', 'Thumbs.db']);
 function rel(harnessRoot, abs) {
     return node_path_1.default.relative(harnessRoot, abs).replace(/\\/g, '/');
@@ -95,14 +100,59 @@ async function readBuildState(harnessRoot) {
 async function readHarnessYaml(harnessRoot) {
     const p = node_path_1.default.join(harnessRoot, 'harness.yaml');
     if (!(await fs_extra_1.default.pathExists(p)))
-        return undefined;
+        return {};
     try {
-        return js_yaml_1.default.load(await fs_extra_1.default.readFile(p, 'utf8'));
+        const raw = await fs_extra_1.default.readFile(p, 'utf8');
+        const doc = js_yaml_1.default.load((0, yaml_safe_path_1.preprocessHarnessYamlText)(raw));
+        return { doc };
     }
-    catch {
-        return undefined;
+    catch (err) {
+        return { error: err.message };
     }
 }
+/** In health mode, skip checks for artifacts not required until `phaseId` is DONE. */
+function isPhaseNotReached(mode, state, phaseId) {
+    return mode === 'health' && state?.phases[phaseId]?.status !== 'DONE';
+}
+function pathPrefixMatches(relPath, prefix) {
+    const p = prefix.replace(/\/+$/, '');
+    return relPath === p || relPath.startsWith(`${p}/`);
+}
+/** Paths that are allowed empty before a build phase completes (health mode only). */
+function isDeferredEmptyDir(relPath, mode, state) {
+    if (mode !== 'health' || !state)
+        return false;
+    const rules = [
+        ['requirements/yaml', 'S40_extract_requirements'],
+        ['references', 'S60_process_references'],
+        ['specs', 'S50_generate_specs'],
+        ['tasks/templates', 'S70_runtime_assets'],
+        ['agent-env/memory/categories', 'S80_seed_memory'],
+        ['agent-env/memory/inbox', 'S80_seed_memory'],
+        ['baseline/wiki/zh', 'S10_wiki'],
+    ];
+    for (const [prefix, phaseId] of rules) {
+        if (!pathPrefixMatches(relPath, prefix))
+            continue;
+        if (state.phases[phaseId]?.status !== 'DONE')
+            return true;
+    }
+    const incoming = state.phases.S65_customize_agent_env;
+    if (relPath === 'agent-env/_incoming/skills' &&
+        (incoming?.incoming_total ?? 0) === 0 &&
+        incoming?.status !== 'DONE') {
+        return true;
+    }
+    return false;
+}
+/** Do not scan copied baseline snapshot for harness scaffold placeholders. */
+function isBaselineCodeMirror(relPath) {
+    return relPath === 'baseline/code' || relPath.startsWith('baseline/code/');
+}
+/** Arch seed skills may ship empty reference leaf dirs. */
+function isSkillReferencePlaceholder(relPath) {
+    return /^agent-env\/skills\/[^/]+\/references(\/|$)/.test(relPath);
+}
 exports.EMPTY_DIR_WHITELIST = new Set([
     'commands/install',
     'commands/update',

package/dist/commands/init.js

@@ -19,6 +19,7 @@ const next_steps_1 = require("../core/next-steps");
 const build_project_entry_1 = require("../core/build-project-entry");
 const project_ignore_1 = require("../core/project-ignore");
 const harness_name_1 = require("../utils/harness-name");
+const yaml_safe_path_1 = require("../utils/yaml-safe-path");
 const repomix_pack_1 = require("../core/repomix-pack");
 const extra_assets_intake_1 = require("../core/extra-assets-intake");
 const baseline_copy_1 = require("../utils/baseline-copy");
@@ -229,9 +230,11 @@ async function runInit(opts) {
         name: validated.name,
         arch: validated.arch,
         agent: validated.agent,
-        sourcePath: validated.baseline ?? '',
-        requirementsPath: opts.requirements ? node_path_1.default.resolve(cwd, opts.requirements) : '',
-        referencesPath: opts.references ? node_path_1.default.resolve(cwd, opts.references) : '',
+        sourcePath: validated.baseline ? (0, yaml_safe_path_1.toYamlSafePath)(validated.baseline) : '',
+        requirementsPath: opts.requirements
+            ? (0, yaml_safe_path_1.toYamlSafePath)(node_path_1.default.resolve(cwd, opts.requirements))
+            : '',
+        referencesPath: opts.references ? (0, yaml_safe_path_1.toYamlSafePath)(node_path_1.default.resolve(cwd, opts.references)) : '',
         createdAt,
         version: cliVersion,
     };

package/dist/core/build-project-entry.js

@@ -55,6 +55,8 @@ function renderBuildProjectEntryMarkdown(input) {
         '| `harness-build-skill-agent-env-merge` | S61 baseline 自动提取确认 + S65 合并写入 |',
         '| `harness-build-skill-knowledge-builder` | S10 baseline 样本 + S70 skills/tasks 索引 |',
         '| `harness-build-skill-wiki-writer` | 按 `TASKS.md` 撰写 baseline wiki |',
+        '| `harness-build-skill-pre-seal-review` | S85 合并审查（完整性 + 深度质量，`HARNESS-REVIEW-REPORT.md`） |',
+        '| `harness-build-harness-data-review` | 已合并 → `harness-build-skill-pre-seal-review` |',
         '',
         '## 3. 构建规则目录（与 harness 分离，位于项目根）',
         '',

package/dist/core/render-meta.js

@@ -14,6 +14,7 @@ const META_FILES = [
     { tplName: 'AGENTS_BUILD.md.ejs', outName: 'AGENTS_BUILD.md' },
     { tplName: 'AGENTS_APPLY.md.ejs', outName: 'AGENTS_APPLY.md' },
     { tplName: 'README.md.ejs', outName: 'README.md' },
+    { tplName: 'task_list.md.ejs', outName: 'task_list.md' },
     { tplName: 'VERSION.ejs', outName: 'VERSION' },
     { tplName: 'CHANGELOG.md.ejs', outName: 'CHANGELOG.md' },
 ];