svharness 0.13.5 → 0.14.2

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

@@ -0,0 +1,72 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkRequirements = checkRequirements;
+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");
+async function checkRequirements(ctx) {
+    const id = 'requirements';
+    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({
+            checkId: id,
+            severity: 'error',
+            message: 'requirements/raw/ 无真实文档（不得仅含 .gitkeep）',
+            path: 'requirements/raw',
+        });
+    }
+    const yamlFiles = (await (0, utils_1.listRealFilesRecursive)(yamlDir, { extensions: ['.yaml', '.yml'] })).filter((f) => !f.endsWith('schema.json'));
+    if (yamlFiles.length === 0) {
+        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) {
+            try {
+                const raw = await fs_extra_1.default.readFile(file, 'utf8');
+                if (!raw.trim()) {
+                    findings.push({
+                        checkId: id,
+                        severity: 'error',
+                        message: 'requirements YAML 文件为空',
+                        path: (0, utils_1.rel)(ctx.harnessRoot, file),
+                    });
+                    continue;
+                }
+                js_yaml_1.default.load(raw);
+            }
+            catch (err) {
+                findings.push({
+                    checkId: id,
+                    severity: 'error',
+                    message: `requirements YAML 解析失败：${err.message}`,
+                    path: (0, utils_1.rel)(ctx.harnessRoot, file),
+                });
+            }
+        }
+    }
+    const mdDir = node_path_1.default.join(ctx.harnessRoot, 'requirements', 'md');
+    if (rawFiles.length > 0 && (await (0, utils_1.listDirEntries)(mdDir)).length === 0) {
+        findings.push({
+            checkId: id,
+            severity: 'warning',
+            message: 'requirements/raw 有文件但 requirements/md/ 为空，请确认 S30 已完成',
+            path: 'requirements/md',
+        });
+    }
+    return { id, title: '需求文档', findings };
+}

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

@@ -0,0 +1,104 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkSkillsTasks = checkSkillsTasks;
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const node_path_1 = __importDefault(require("node:path"));
+const utils_1 = require("./utils");
+const skill_md_validate_1 = require("../../utils/skill-md-validate");
+async function countTaskCategories(templatesDir) {
+    if (!(await fs_extra_1.default.pathExists(templatesDir)))
+        return 0;
+    const entries = await fs_extra_1.default.readdir(templatesDir, { withFileTypes: true });
+    let matched = 0;
+    const seen = new Set();
+    for (const ent of entries) {
+        if (!ent.isDirectory())
+            continue;
+        const dirPath = node_path_1.default.join(templatesDir, ent.name);
+        const mdFiles = (await fs_extra_1.default.readdir(dirPath)).filter((n) => n.endsWith('.md'));
+        if (mdFiles.length === 0)
+            continue;
+        const haystack = `${ent.name} ${mdFiles.join(' ')}`.toLowerCase();
+        for (let i = 0; i < utils_1.TASK_CATEGORY_HINTS.length; i++) {
+            if (seen.has(i))
+                continue;
+            if (utils_1.TASK_CATEGORY_HINTS[i].some((kw) => haystack.includes(kw.toLowerCase()))) {
+                seen.add(i);
+                matched++;
+            }
+        }
+    }
+    if (matched < 3) {
+        const flatMd = await fs_extra_1.default
+            .readdir(templatesDir)
+            .then((names) => names.filter((n) => n.endsWith('.md')));
+        if (flatMd.length >= 3)
+            matched = 3;
+    }
+    return matched;
+}
+async function checkSkillsTasks(ctx) {
+    const id = 'skills-tasks';
+    const findings = [];
+    const skillsDir = node_path_1.default.join(ctx.harnessRoot, 'agent-env', 'skills');
+    const templatesDir = node_path_1.default.join(ctx.harnessRoot, 'tasks', 'templates');
+    if (!(await fs_extra_1.default.pathExists(skillsDir))) {
+        findings.push({
+            checkId: id,
+            severity: 'error',
+            message: '缺少 agent-env/skills/',
+            path: 'agent-env/skills',
+        });
+    }
+    else {
+        const skillDirs = (await fs_extra_1.default.readdir(skillsDir, { withFileTypes: true })).filter((d) => d.isDirectory() && !d.name.startsWith('.'));
+        const runtimeSkills = skillDirs.filter((d) => !d.name.startsWith('harness-build-'));
+        if (runtimeSkills.length === 0) {
+            findings.push({
+                checkId: id,
+                severity: 'error',
+                message: 'agent-env/skills/ 无运行期 skill 子目录',
+                path: 'agent-env/skills',
+            });
+        }
+        for (const dir of runtimeSkills) {
+            const skillMd = node_path_1.default.join(skillsDir, dir.name, 'SKILL.md');
+            if (!(await fs_extra_1.default.pathExists(skillMd))) {
+                findings.push({
+                    checkId: id,
+                    severity: 'error',
+                    message: `skill 目录缺少 SKILL.md：${dir.name}`,
+                    path: (0, utils_1.rel)(ctx.harnessRoot, node_path_1.default.join(skillsDir, dir.name)),
+                });
+                continue;
+            }
+            for (const msg of await (0, skill_md_validate_1.validateFrontmatterFields)({
+                targetRoot: ctx.harnessRoot,
+                file: skillMd,
+                requiredKeys: ['name', 'description'],
+            })) {
+                findings.push({ checkId: id, severity: 'error', message: msg, path: (0, utils_1.rel)(ctx.harnessRoot, skillMd) });
+            }
+            for (const msg of await (0, skill_md_validate_1.validateSkillNameMatchesDir)({
+                targetRoot: ctx.harnessRoot,
+                file: skillMd,
+            })) {
+                findings.push({ checkId: id, severity: 'warning', message: msg, path: (0, utils_1.rel)(ctx.harnessRoot, skillMd) });
+            }
+        }
+    }
+    const state = await (0, utils_1.readBuildState)(ctx.harnessRoot);
+    const categoryCount = await countTaskCategories(templatesDir);
+    if (categoryCount < 3 && !(0, utils_1.isPhaseNotReached)(ctx.mode, state, 'S70_runtime_assets')) {
+        findings.push({
+            checkId: id,
+            severity: 'error',
+            message: `tasks/templates/ 须覆盖三类典型场景（当前识别 ${categoryCount}/3）`,
+            path: 'tasks/templates',
+        });
+    }
+    return { id, title: 'Skills 与 Tasks', findings };
+}

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

@@ -0,0 +1,87 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkSpecs = checkSpecs;
+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 ajv_1 = __importDefault(require("ajv"));
+const ajv_formats_1 = __importDefault(require("ajv-formats"));
+const utils_1 = require("./utils");
+const SPEC_DOMAINS = ['signals', 'ui', 'behavior', 'interfaces'];
+async function checkSpecs(ctx) {
+    const id = 'specs';
+    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');
+        if (!(await fs_extra_1.default.pathExists(schemaPath))) {
+            findings.push({
+                checkId: id,
+                severity: 'error',
+                message: `缺少 schema：specs/${domain}/schema.json`,
+                path: `specs/${domain}/schema.json`,
+            });
+            continue;
+        }
+        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) {
+            if (!deferSpecs) {
+                findings.push({
+                    checkId: id,
+                    severity: 'error',
+                    message: `specs/${domain}/ 无模块 YAML（除 schema.json 外）`,
+                    path: `specs/${domain}`,
+                });
+            }
+            continue;
+        }
+        let validate;
+        try {
+            const schema = JSON.parse(await fs_extra_1.default.readFile(schemaPath, 'utf8'));
+            validate = ajv.compile(schema);
+        }
+        catch (err) {
+            findings.push({
+                checkId: id,
+                severity: 'error',
+                message: `specs/${domain}/schema.json 无效：${err.message}`,
+                path: `specs/${domain}/schema.json`,
+            });
+            continue;
+        }
+        for (const file of moduleYaml) {
+            try {
+                const doc = js_yaml_1.default.load(await fs_extra_1.default.readFile(file, 'utf8'));
+                if (!validate(doc)) {
+                    const detail = (validate.errors ?? [])
+                        .slice(0, 3)
+                        .map((e) => `${e.instancePath || '/'} ${e.message}`)
+                        .join('; ');
+                    findings.push({
+                        checkId: id,
+                        severity: 'error',
+                        message: `schema 校验失败：${detail}`,
+                        path: (0, utils_1.rel)(ctx.harnessRoot, file),
+                    });
+                }
+            }
+            catch (err) {
+                findings.push({
+                    checkId: id,
+                    severity: 'error',
+                    message: `YAML 解析失败：${err.message}`,
+                    path: (0, utils_1.rel)(ctx.harnessRoot, file),
+                });
+            }
+        }
+    }
+    return { id, title: 'Specs 四域与 schema', findings };
+}

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

@@ -0,0 +1,116 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": 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',
+    'S10_wiki',
+    'S20_collect_inputs',
+    'S30_convert_docs',
+    'S40_extract_requirements',
+    'S50_generate_specs',
+    'S60_process_references',
+    'S61_confirm_baseline_extraction',
+    'S65_customize_agent_env',
+    'S70_runtime_assets',
+    'S80_seed_memory',
+];
+async function checkStatePhases(ctx) {
+    const id = 'state-phases';
+    const findings = [];
+    const statePath = node_path_1.default.join(ctx.harnessRoot, '.harness-build-state.yaml');
+    const state = await (0, utils_1.readBuildState)(ctx.harnessRoot);
+    if (!state) {
+        findings.push({
+            checkId: id,
+            severity: 'error',
+            message: '缺少 .harness-build-state.yaml，请先运行 svharness build',
+            path: (0, utils_1.rel)(ctx.harnessRoot, statePath),
+        });
+        return { id, title: '构建阶段状态', findings };
+    }
+    if (ctx.mode === 'pre-seal') {
+        for (const phaseId of PRE_SEAL_PHASES) {
+            const phase = state.phases[phaseId];
+            if (!phase) {
+                if (phaseId === 'S10_wiki')
+                    continue;
+                findings.push({
+                    checkId: id,
+                    severity: 'error',
+                    message: `阶段 ${phaseId} 未在状态文件中定义`,
+                });
+                continue;
+            }
+            if (phase.status !== 'DONE') {
+                findings.push({
+                    checkId: id,
+                    severity: 'error',
+                    message: `阶段 ${phaseId} 状态为 ${phase.status}，封存前须为 DONE`,
+                });
+            }
+        }
+        const s61 = state.phases.S61_confirm_baseline_extraction;
+        if (s61 && s61.baseline_auto_extract === 'UNSET') {
+            findings.push({
+                checkId: id,
+                severity: 'error',
+                message: 'S61_confirm_baseline_extraction.baseline_auto_extract 仍为 UNSET，须先确认',
+            });
+        }
+    }
+    for (const [phaseId, phase] of Object.entries(state.phases)) {
+        if (phase.status === 'FAILED' || phase.status === 'BLOCKED') {
+            findings.push({
+                checkId: id,
+                severity: 'error',
+                message: `阶段 ${phaseId} 处于 ${phase.status}，须先解除`,
+            });
+        }
+        if (phaseId === 'S85_pre_seal_validation' && ctx.mode === 'pre-seal') {
+            // S85 is validated separately; not required DONE before doctor in pre-seal mode
+        }
+        if (phaseId === 'S90_finalize' && ctx.mode === 'pre-seal' && phase.status === 'DONE') {
+            findings.push({
+                checkId: id,
+                severity: 'warning',
+                message: 'S90_finalize 已为 DONE，doctor pre-seal 模式通常应在封板前执行',
+            });
+        }
+    }
+    if (!state.phases.S85_pre_seal_validation && ctx.mode === 'pre-seal') {
+        findings.push({
+            checkId: id,
+            severity: 'warning',
+            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/check-wiki.js

@@ -0,0 +1,52 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkWiki = checkWiki;
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const node_path_1 = __importDefault(require("node:path"));
+const utils_1 = require("./utils");
+async function checkWiki(ctx) {
+    const id = 'wiki';
+    const findings = [];
+    const state = await (0, utils_1.readBuildState)(ctx.harnessRoot);
+    const wikiPhase = state?.phases.S10_wiki;
+    if (!wikiPhase) {
+        return { id, title: 'Baseline Wiki', findings };
+    }
+    if (wikiPhase.status !== 'DONE' && ctx.mode === 'pre-seal') {
+        findings.push({
+            checkId: id,
+            severity: 'error',
+            message: `S10_wiki 状态为 ${wikiPhase.status}，封存前须为 DONE`,
+        });
+        return { id, title: 'Baseline Wiki', findings };
+    }
+    const wikiDir = node_path_1.default.join(ctx.harnessRoot, 'baseline', 'wiki');
+    const wikiPages = (await (0, utils_1.listRealFilesRecursive)(wikiDir, { extensions: ['.md'] })).filter((f) => !f.endsWith('TASKS.md') && !f.endsWith('README.md'));
+    if (wikiPhase.mode === 'outline-only' || wikiPhase.status === 'PENDING') {
+        const tasksFile = node_path_1.default.join(ctx.harnessRoot, wikiPhase.tasks_file ?? 'baseline/wiki/TASKS.md');
+        if (await fs_extra_1.default.pathExists(tasksFile)) {
+            const content = await fs_extra_1.default.readFile(tasksFile, 'utf8');
+            const openTasks = content.match(/- \[ \]/g);
+            if (openTasks && openTasks.length > 0) {
+                findings.push({
+                    checkId: id,
+                    severity: 'error',
+                    message: `TASKS.md 仍有 ${openTasks.length} 项未完成 [ ]`,
+                    path: (0, utils_1.rel)(ctx.harnessRoot, tasksFile),
+                });
+            }
+        }
+    }
+    if (wikiPhase.status === 'DONE' && wikiPages.length === 0) {
+        findings.push({
+            checkId: id,
+            severity: 'warning',
+            message: 'baseline/wiki/ 无实质 wiki 页面（除 TASKS/README）',
+            path: 'baseline/wiki',
+        });
+    }
+    return { id, title: 'Baseline Wiki', findings };
+}