svharness 0.13.5 → 0.14.2

package/dist/commands/doctor/index.js

@@ -0,0 +1,105 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.writeDoctorReportFile = exports.formatDoctorReportJson = exports.formatDoctorReportText = void 0;
+exports.runDoctorChecks = runDoctorChecks;
+exports.renderDoctorReport = renderDoctorReport;
+const node_path_1 = __importDefault(require("node:path"));
+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");
+const check_memory_1 = require("./check-memory");
+const check_incoming_1 = require("./check-incoming");
+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; } });
+Object.defineProperty(exports, "formatDoctorReportJson", { enumerable: true, get: function () { return report_2.formatDoctorReportJson; } });
+Object.defineProperty(exports, "writeDoctorReportFile", { enumerable: true, get: function () { return report_2.writeDoctorReportFile; } });
+async function runDoctorChecks(input) {
+    const harnessRoot = node_path_1.default.resolve(input.harnessRoot);
+    const ctx = {
+        harnessRoot,
+        mode: input.mode,
+        strict: input.strict,
+    };
+    const runners = [
+        check_state_phases_1.checkStatePhases,
+        check_bootstrap_1.checkBootstrap,
+        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,
+        check_memory_1.checkMemory,
+        check_incoming_1.checkIncoming,
+        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) {
+        checks.push(await run(ctx));
+    }
+    return (0, report_1.buildDoctorReport)({
+        harnessRoot,
+        mode: input.mode,
+        checks,
+        strict: input.strict,
+    });
+}
+async function renderDoctorReport(report, format) {
+    if (format === 'json') {
+        const { formatDoctorReportJson } = await Promise.resolve().then(() => __importStar(require('./report')));
+        return formatDoctorReportJson(report);
+    }
+    const { formatDoctorReportText } = await Promise.resolve().then(() => __importStar(require('./report')));
+    return formatDoctorReportText(report);
+}

package/dist/commands/doctor/report.js

@@ -0,0 +1,79 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildDoctorReport = buildDoctorReport;
+exports.formatDoctorReportText = formatDoctorReportText;
+exports.formatDoctorReportJson = formatDoctorReportJson;
+exports.writeDoctorReportFile = writeDoctorReportFile;
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const node_path_1 = __importDefault(require("node:path"));
+const picocolors_1 = __importDefault(require("picocolors"));
+function countBySeverity(checks, severity) {
+    let n = 0;
+    for (const c of checks) {
+        for (const f of c.findings) {
+            if (f.severity === severity)
+                n++;
+        }
+    }
+    return n;
+}
+function buildDoctorReport(input) {
+    let errorCount = countBySeverity(input.checks, 'error');
+    const warningCount = countBySeverity(input.checks, 'warning');
+    if (input.strict) {
+        errorCount += warningCount;
+    }
+    return {
+        harnessRoot: input.harnessRoot,
+        mode: input.mode,
+        passed: errorCount === 0,
+        errorCount,
+        warningCount: input.strict ? 0 : warningCount,
+        checks: input.checks,
+        generatedAt: new Date().toISOString(),
+    };
+}
+function formatDoctorReportText(report) {
+    const lines = [];
+    lines.push(`svharness doctor — ${report.mode}`);
+    lines.push(`harness: ${report.harnessRoot}`);
+    lines.push(`时间: ${report.generatedAt}`);
+    lines.push(report.passed
+        ? picocolors_1.default.green('结果: 通过')
+        : picocolors_1.default.red(`结果: 未通过（error: ${report.errorCount}, warning: ${report.warningCount}）`));
+    lines.push('');
+    for (const check of report.checks) {
+        const errors = check.findings.filter((f) => f.severity === 'error');
+        const warnings = check.findings.filter((f) => f.severity === 'warning');
+        const infos = check.findings.filter((f) => f.severity === 'info');
+        if (check.findings.length === 0) {
+            lines.push(picocolors_1.default.green(`[OK] ${check.title}`));
+            continue;
+        }
+        lines.push(`[${check.id}] ${check.title}`);
+        for (const f of errors) {
+            lines.push(picocolors_1.default.red(`  ERROR: ${f.message}${f.path ? ` (${f.path})` : ''}`));
+        }
+        for (const f of warnings) {
+            lines.push(picocolors_1.default.yellow(`  WARN:  ${f.message}${f.path ? ` (${f.path})` : ''}`));
+        }
+        for (const f of infos) {
+            lines.push(`  INFO:  ${f.message}${f.path ? ` (${f.path})` : ''}`);
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+function formatDoctorReportJson(report) {
+    return JSON.stringify(report, null, 2);
+}
+async function writeDoctorReportFile(reportPath, report, format) {
+    await fs_extra_1.default.ensureDir(node_path_1.default.dirname(reportPath));
+    const body = format === 'json' || reportPath.endsWith('.json')
+        ? formatDoctorReportJson(report)
+        : formatDoctorReportText(report);
+    await fs_extra_1.default.writeFile(reportPath, body, 'utf8');
+}

package/dist/commands/doctor/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/commands/doctor/utils.js

@@ -0,0 +1,180 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TASK_CATEGORY_HINTS = exports.AGENT_BLACKLIST = exports.EMPTY_DIR_WHITELIST = void 0;
+exports.rel = rel;
+exports.isRealFileName = isRealFileName;
+exports.listDirEntries = listDirEntries;
+exports.listRealFilesRecursive = listRealFilesRecursive;
+exports.dirHasOnlyGitkeep = dirHasOnlyGitkeep;
+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, '/');
+}
+function isRealFileName(name) {
+    if (SKIP_FILE_NAMES.has(name))
+        return false;
+    if (name.startsWith('.'))
+        return false;
+    return true;
+}
+async function listDirEntries(dir) {
+    if (!(await fs_extra_1.default.pathExists(dir)))
+        return [];
+    const names = await fs_extra_1.default.readdir(dir);
+    return names.filter(isRealFileName);
+}
+async function listRealFilesRecursive(root, opts) {
+    const out = [];
+    if (!(await fs_extra_1.default.pathExists(root)))
+        return out;
+    async function walk(dir) {
+        const entries = await fs_extra_1.default.readdir(dir, { withFileTypes: true });
+        for (const ent of entries) {
+            if (!isRealFileName(ent.name))
+                continue;
+            const full = node_path_1.default.join(dir, ent.name);
+            if (ent.isDirectory()) {
+                await walk(full);
+            }
+            else if (ent.isFile()) {
+                if (opts?.extensions) {
+                    const ext = node_path_1.default.extname(ent.name).toLowerCase();
+                    if (!opts.extensions.includes(ext))
+                        continue;
+                }
+                out.push(full);
+            }
+        }
+    }
+    await walk(root);
+    return out;
+}
+async function dirHasOnlyGitkeep(dir) {
+    if (!(await fs_extra_1.default.pathExists(dir)))
+        return false;
+    const entries = await fs_extra_1.default.readdir(dir);
+    const meaningful = entries.filter((n) => n !== '.gitkeep' && !n.startsWith('.'));
+    if (meaningful.length === 0) {
+        return entries.includes('.gitkeep') || entries.length === 0;
+    }
+    return false;
+}
+async function isEmptyOrGitkeepOnly(dir) {
+    if (!(await fs_extra_1.default.pathExists(dir)))
+        return true;
+    const entries = await fs_extra_1.default.readdir(dir);
+    const meaningful = entries.filter((n) => n !== '.gitkeep' && !n.startsWith('.'));
+    return meaningful.length === 0;
+}
+function basenameWithoutExt(filePath) {
+    return node_path_1.default.basename(filePath, node_path_1.default.extname(filePath));
+}
+async function readBuildState(harnessRoot) {
+    const statePath = node_path_1.default.join(harnessRoot, '.harness-build-state.yaml');
+    if (!(await fs_extra_1.default.pathExists(statePath)))
+        return undefined;
+    try {
+        const raw = await fs_extra_1.default.readFile(statePath, 'utf8');
+        const body = raw.replace(/^#.*\n/gm, '');
+        return js_yaml_1.default.load(body);
+    }
+    catch {
+        return undefined;
+    }
+}
+async function readHarnessYaml(harnessRoot) {
+    const p = node_path_1.default.join(harnessRoot, 'harness.yaml');
+    if (!(await fs_extra_1.default.pathExists(p)))
+        return {};
+    try {
+        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 (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',
+    'agent-env/tools',
+]);
+exports.AGENT_BLACKLIST = [
+    'qoder',
+    'codechat',
+    'cursor',
+    'claude-code',
+    'opencode',
+    'claude',
+    'chatgpt',
+    'gpt-4',
+    '.qoder/',
+    '.codechat/',
+    '.cursor/',
+    '.claude/',
+    '.opencode/',
+];
+exports.TASK_CATEGORY_HINTS = [
+    ['新增', '信号', '接口', '数据', 'increment', 'add'],
+    ['重构', '适配', 'refactor', 'adapt', 'migrate'],
+    ['测试', '校验', 'test', 'verify', 'validation', 'check'],
+];

package/dist/commands/doctor.js

@@ -0,0 +1,51 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runDoctor = runDoctor;
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const node_path_1 = __importDefault(require("node:path"));
+const index_1 = require("./doctor/index");
+const logger_1 = require("../utils/logger");
+async function runDoctor(opts) {
+    if (opts.verbose)
+        (0, logger_1.setVerbose)(true);
+    const cwd = opts.cwd ?? process.cwd();
+    const harnessInput = opts.harness?.trim();
+    if (!harnessInput) {
+        throw new Error('--harness <path> 是必填参数（可在配置文件的 doctor.harness 中提供）');
+    }
+    const harnessRoot = node_path_1.default.resolve(cwd, harnessInput);
+    if (!(await fs_extra_1.default.pathExists(harnessRoot))) {
+        throw new Error(`harness 目录不存在：${harnessRoot}`);
+    }
+    const stateFile = node_path_1.default.join(harnessRoot, '.harness-build-state.yaml');
+    if (!(await fs_extra_1.default.pathExists(stateFile))) {
+        throw new Error(`未找到 .harness-build-state.yaml，请先在该目录运行 svharness build：${harnessRoot}`);
+    }
+    const mode = opts.mode ?? 'pre-seal';
+    if (mode !== 'pre-seal' && mode !== 'health') {
+        throw new Error(`--mode 仅支持 pre-seal | health，收到：${mode}`);
+    }
+    const format = opts.format ?? 'text';
+    if (format !== 'text' && format !== 'json') {
+        throw new Error(`--format 仅支持 text | json，收到：${format}`);
+    }
+    const strict = !!opts.strict;
+    logger_1.logger.info(`doctor 检查：${harnessRoot}（mode=${mode}${strict ? ', strict' : ''}）`);
+    const report = await (0, index_1.runDoctorChecks)({ harnessRoot, mode, strict });
+    const body = await (0, index_1.renderDoctorReport)(report, format);
+    logger_1.logger.plain(body);
+    const outPath = opts.report?.trim()
+        ? node_path_1.default.resolve(cwd, opts.report.trim())
+        : node_path_1.default.join(harnessRoot, 'doctor-report.json');
+    await (0, index_1.writeDoctorReportFile)(outPath, report, 'json');
+    logger_1.logger.info(`JSON 报告已写入：${outPath}`);
+    if (report.passed) {
+        logger_1.logger.success('doctor 检查通过');
+        return 0;
+    }
+    logger_1.logger.error(`doctor 检查未通过（error: ${report.errorCount}）`);
+    return 1;
+}

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/config/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.saveConfigSection = exports.mergeConvertOptions = exports.mergeApplyOptions = exports.mergeBuildOptions = exports.resolveConfigHarnessName = exports.normalizeConfig = exports.resolveConfigPath = exports.loadConfig = exports.CONFIG_SCHEMA_VERSION = exports.DEFAULT_CONFIG_FILENAME = void 0;
+exports.saveConfigSection = exports.mergeDoctorOptions = exports.mergeConvertOptions = exports.mergeApplyOptions = exports.mergeBuildOptions = exports.resolveConfigHarnessName = exports.normalizeConfig = exports.resolveConfigPath = exports.loadConfig = exports.CONFIG_SCHEMA_VERSION = exports.DEFAULT_CONFIG_FILENAME = void 0;
 var constants_1 = require("./constants");
 Object.defineProperty(exports, "DEFAULT_CONFIG_FILENAME", { enumerable: true, get: function () { return constants_1.DEFAULT_CONFIG_FILENAME; } });
 Object.defineProperty(exports, "CONFIG_SCHEMA_VERSION", { enumerable: true, get: function () { return constants_1.CONFIG_SCHEMA_VERSION; } });
@@ -14,5 +14,6 @@ var merge_options_1 = require("./merge-options");
 Object.defineProperty(exports, "mergeBuildOptions", { enumerable: true, get: function () { return merge_options_1.mergeBuildOptions; } });
 Object.defineProperty(exports, "mergeApplyOptions", { enumerable: true, get: function () { return merge_options_1.mergeApplyOptions; } });
 Object.defineProperty(exports, "mergeConvertOptions", { enumerable: true, get: function () { return merge_options_1.mergeConvertOptions; } });
+Object.defineProperty(exports, "mergeDoctorOptions", { enumerable: true, get: function () { return merge_options_1.mergeDoctorOptions; } });
 var save_config_1 = require("./save-config");
 Object.defineProperty(exports, "saveConfigSection", { enumerable: true, get: function () { return save_config_1.saveConfigSection; } });

package/dist/config/merge-options.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.mergeBuildOptions = mergeBuildOptions;
 exports.mergeApplyOptions = mergeApplyOptions;
 exports.mergeConvertOptions = mergeConvertOptions;
+exports.mergeDoctorOptions = mergeDoctorOptions;
 const normalize_1 = require("./normalize");
 function getSource(cmd, key) {
     if (!cmd)
@@ -116,3 +117,15 @@ function mergeConvertOptions(cli, configSection, defaults, cmd) {
         verbose: pickBool('verbose', cli.verbose, cfg.verbose, defaults?.verbose, cmd),
     };
 }
+function mergeDoctorOptions(cli, configSection, defaults, cmd) {
+    const cfg = mergeSection(configSection, defaults);
+    return {
+        harness: pickString('harness', cli.harness, cfg.harness, cmd),
+        mode: pickString('mode', cli.mode, cfg.mode, cmd),
+        format: pickString('format', cli.format, cfg.format, cmd),
+        report: pickString('report', cli.report, cfg.report, cmd),
+        strict: pickBool('strict', cli.strict, cfg.strict, undefined, cmd),
+        yes: pickBool('yes', cli.yes, cfg.yes, defaults?.yes, cmd),
+        verbose: pickBool('verbose', cli.verbose, cfg.verbose, defaults?.verbose, cmd),
+    };
+}

package/dist/core/agent-injector.js

@@ -19,6 +19,7 @@ const BUILD_SKILLS = [
     'harness-build-skill-agent-env-merge.md',
     'harness-build-skill-knowledge-builder.md',
     'harness-build-skill-wiki-writer.md',
+    'harness-build-skill-pre-seal-review.md',
 ];
 async function writeInjectedFile(input) {
     const exists = await fs_extra_1.default.pathExists(input.dstPath);

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' },
 ];

package/dist/core/state.js

@@ -16,7 +16,8 @@ const logger_1 = require("../utils/logger");
  *
  * Phase order: 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 → S90_finalize
+ *   → S65_customize_agent_env → S70_runtime_assets → S80_seed_memory
+ *   → S85_pre_seal_validation → S90_finalize
  *
  * Design: S10_wiki comes before S20_collect_inputs because baseline wiki is the project
  * experience foundation — it provides architectural knowledge that helps the
@@ -42,11 +43,25 @@ function buildInitialState(input) {
         };
     }
     // S20_collect_inputs: collect related inputs (requirements/references/optional extra skills & rules)
-    phases.S20_collect_inputs = { status: 'PENDING', manual_required: true };
+    phases.S20_collect_inputs = {
+        status: 'PENDING',
+        manual_required: true,
+        task_list_file: 'task_list.md',
+    };
     // S30_convert_docs: convert non-md raw docs to markdown for downstream entry-ization
     phases.S30_convert_docs = { status: 'PENDING', requires_agent: true };
-    phases.S40_extract_requirements = { status: 'PENDING', requires_agent: true };
-    phases.S50_generate_specs = { status: 'PENDING', requires_agent: true };
+    phases.S40_extract_requirements = {
+        status: 'PENDING',
+        requires_agent: true,
+        coverage_report: 'requirements/coverage-report.yaml',
+        coverage_ratio: null,
+    };
+    phases.S50_generate_specs = {
+        status: 'PENDING',
+        requires_agent: true,
+        spec_coverage_report: 'specs/coverage-report.yaml',
+        spec_coverage_ratio: null,
+    };
     // S60: references convert + structured indexing
     phases.S60_process_references = { status: 'PENDING', requires_agent: true };
     // S61: explicitly confirm whether baseline auto-extraction (skills/rules) is enabled
@@ -67,12 +82,21 @@ function buildInitialState(input) {
     };
     phases.S70_runtime_assets = { status: 'PENDING', requires_agent: true };
     phases.S80_seed_memory = { status: 'PENDING', requires_agent: true };
+    phases.S85_pre_seal_validation = {
+        status: 'PENDING',
+        requires_agent: true,
+        doctor_required: true,
+        review_report_path: 'HARNESS-REVIEW-REPORT.md',
+        depth_review_required: true,
+        min_depth_score: 5.0,
+        min_depth_grade: 'C',
+    };
     phases.S90_finalize = { status: 'PENDING' };
     // current_phase starts at S10_wiki (if present) or S20_collect_inputs (if no baseline)
     const startPhase = wp !== 'none' ? 'S10_wiki' : 'S20_collect_inputs';
     const startAction = wp !== 'none'
         ? '请先构建 baseline wiki（项目经验底座），完成后进入 S20 输入文件收集。'
-        : '请先完成 S20 输入文件收集：requirements/raw、references/raw，并确认是否有额外 skills/rules。';
+        : '请先完成 S20 输入文件收集：requirements/raw、references/raw，并按 task_list.md 执行阶段门禁。';
     const state = {
         project: input.name,
         arch: input.arch,

package/dist/index.js

@@ -9,6 +9,7 @@ const init_1 = require("./commands/init");
 const apply_1 = require("./commands/apply");
 const convert_1 = require("./commands/convert");
 const wizard_1 = require("./commands/wizard");
+const doctor_1 = require("./commands/doctor");
 const config_1 = require("./config");
 /**
  * Default values surfaced to users (also reflected in README "全部参数" tables).
@@ -314,6 +315,46 @@ function main() {
             process.exitCode = 1;
         }
     });
+    program
+        .command('doctor')
+        .description('检查 harness 健康度与封存前完整性（阶段状态、空目录、文档配对、specs schema 等）。')
+        .option('--config <path>', `从配置文件读取 doctor 节（默认 ${config_1.DEFAULT_CONFIG_FILENAME}）`)
+        .option('--harness <path>', 'harness 根目录（可在配置文件的 doctor.harness 中提供）')
+        .option('--mode <mode>', '检查模式：pre-seal（封存前，默认）| health（日常巡检）', 'pre-seal')
+        .option('--format <format>', '输出格式：text | json', 'text')
+        .option('--report <path>', 'JSON 报告输出路径（默认 <harness>/doctor-report.json）')
+        .option('--strict', '将 warning 视为 error')
+        .option('-y, --yes', '跳过交互确认（预留）')
+        .option('--verbose', '显示详细日志')
+        .action(async (opts, cmd) => {
+        try {
+            const loaded = (0, config_1.loadConfig)({ configPath: opts.config });
+            const merged = (0, config_1.mergeDoctorOptions)(opts, loaded?.config.doctor, loaded?.config.defaults, cmd);
+            const mode = merged.mode ?? 'pre-seal';
+            if (mode !== 'pre-seal' && mode !== 'health') {
+                throw new Error(`--mode 仅支持 pre-seal | health，收到：${mode}`);
+            }
+            const format = merged.format ?? 'text';
+            if (format !== 'text' && format !== 'json') {
+                throw new Error(`--format 仅支持 text | json，收到：${format}`);
+            }
+            const exitCode = await (0, doctor_1.runDoctor)({
+                harness: merged.harness ?? '',
+                mode,
+                format,
+                report: merged.report,
+                strict: !!merged.strict,
+                verbose: !!merged.verbose,
+            });
+            if (exitCode !== 0) {
+                process.exitCode = exitCode;
+            }
+        }
+        catch (err) {
+            logger_1.logger.error(err.message);
+            process.exitCode = 1;
+        }
+    });
     program.parseAsync(process.argv).catch((err) => {
         logger_1.logger.error(err.message);
         process.exitCode = 1;