spec-wave 2.1.1

package/lib/cli.js

@@ -0,0 +1,1034 @@
+import { existsSync, mkdirSync, readFileSync, renameSync } from 'node:fs';
+import { readFile, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import readline from 'node:readline';
+import { fileURLToPath } from 'node:url';
+import { cmdGraph } from "./cli-graph.js";
+import { cmdHost, listKnownHostIds } from "./cli-host.js";
+import { cmdRefreshIdeBlocks, countStaleIdeLiterals } from "./cli-refresh-ide-blocks.js";
+import { cmdDiscipline, cmdLifecycle } from "./cli-lifecycle.js";
+import { cmdSkills } from "./cli-skills.js";
+import { buildDoneSnapshot, CliError, evaluateMayStart30, extractSection, extractTaskSlug, fail, findGate, kitLayoutJoin, KIT_LAYOUT_DIR, LEGACY_LAYOUT_DIR, legacyLayoutHint, normalizeSlug, packageRoot, parseHarnessMeta, parseHumanGates, resolveLayoutFile, resolveTarget, resolveTaskPath, STATUS_RE, takeOption } from "./cli-shared.js";
+import { checkPre30InvokeHats, evalCloseGuard, findReview, findSpecReview, listBareSpecFiles, lintTaskFile, PLACEHOLDER_RE, runTestCheck, shouldSkipSpecAudit, } from "./cli-checks.js";
+import { cmdStatus, cmdTimeline } from "./cli-status.js";
+import { cmdSync } from "./cli-sync.js";
+import { cmdTaskCheck, cmdTaskLintDone, cmdTaskLintWikiDelta, lintWikiDeltaMissing } from "./cli-task-extra.js";
+import { cmdWiki } from "./cli-wiki.js";
+// DEF-003 阶段二 T6 + PRD_DEF-003 后续棒 + doc-health：close 守卫求值顺序
+const CLOSE_GUARD_ORDER = [
+    'close_invoke',
+    'close_self_check',
+    'close_acceptance',
+    'close_slug',
+    'close_status',
+    'close_review',
+    'close_graph_delta',
+    'close_kpi',
+    'close_experience',
+    'close_wiki_delta',
+    'close_wiki_promotion',
+    'close_pr_merged',
+    'close_hub_index',
+];
+// init --preset 合法词表（DEF-013 D1：当前唯一合法值；新增 preset 须先扩展此常量）
+const VALID_PRESETS = ['harness-only'];
+async function readPkgVersion() {
+    if (process.env.HARNESS_VERSION)
+        return process.env.HARNESS_VERSION;
+    const raw = await readFile(path.join(packageRoot(), 'package.json'), 'utf8');
+    const pkg = JSON.parse(raw);
+    return pkg.version ?? 'unknown';
+}
+function usage(version) {
+    console.log(`specgate CLI (v${version})
+过渡: npx dsh-coding-kit 仍可用（同入口）
+
+用法:
+  npx spec-wave --version | -V
+  npx spec-wave --help | -h
+  npx spec-wave init [--preset NAME] [--tools all|none|LIST] [--profile core|expanded] [--host-adapt|--no-host-adapt] [--target PATH] [--yes]  （NAME 词表: harness-only）
+  npx spec-wave upgrade [--target PATH] [--yes]
+  npx spec-wave refresh-ide-blocks [--target PATH] [--dry-run] [--yes] [--json]
+  npx spec-wave check [--target PATH]
+  npx spec-wave verify [--target PATH] [--task FILE | --spec FILE] [--json] [--with-wiki-lint]
+  npx spec-wave gate-check [--target PATH] [--task FILE] [--json]
+  npx spec-wave audit [--target PATH] [--task FILE]
+  npx spec-wave task lint --file PATH
+  npx spec-wave task close --file PATH [--yes] [--json]
+  npx spec-wave status [--target PATH] [--task FILE] [--json] [--check]
+  npx spec-wave timeline --task FILE [--target PATH] [--json] [--limit N] [--ingest]
+  npx spec-wave lifecycle show [--json]
+  npx spec-wave lifecycle dry-run --transition ID --from STATE [--task PATH] [--target PATH]
+  npx spec-wave discipline show [--json]
+  npx spec-wave graph yaml compile|check|export …
+  npx spec-wave graph ingest|snapshot|axioms …
+  npx spec-wave sync index [--target PATH]
+  npx spec-wave sync prompts [--target PATH] [--yes] [--force] [--json]
+  npx spec-wave skills install [--target DIR] [--out DIR] [--global] [--force] [--with-execute-hats]
+  npx spec-wave skills build [--with-execute-hats]
+  npx spec-wave skills check
+  npx spec-wave host validate [--file PATH] [--json]
+  npx spec-wave host apply --tools LIST [--profile core] [--target PATH] [--file PATH] [--json] [--dry-run|--yes]
+  npx spec-wave host update [--tools LIST] [--profile core] [--target PATH] [--file PATH] [--json] [--dry-run|--yes] [--force]
+  npx spec-wave wiki export --json [--target PATH]
+  npx spec-wave task lint-done [--target PATH]
+  npx spec-wave task lint-wiki-delta [--target PATH] [--scope all|active|done] [--strict] [--json]
+    诊断码: wiki_delta_missing（缺字段）· wiki_delta_wrong_section（字段写在 ## Harness 元信息 之外的节 · 替代 missing 不双报）
+    --strict 追加: wiki_delta_invalid / wiki_delta_path_missing；task lint --file E8 同口径查 wiki_delta 存在性
+  npx spec-wave task check --file PATH
+
+Exit codes (P0 gates · failClosed):
+  0  pass / informational (check always exits 0)
+  1  usage error or non-blocking failure
+  2  gate BLOCKED — do not proceed (verify / gate-check / audit / D5)
+`);
+}
+/** 新写入路径（F4：一律 .coding-kit） */
+function manifestWritePath(target) {
+    return kitLayoutJoin(target, 'manifest.json');
+}
+/** 解析路径（读：新优先，legacy 回退） */
+function manifestPath(target) {
+    return resolveLayoutFile(target, 'manifest.json').abs;
+}
+async function readManifest(target) {
+    const hit = resolveLayoutFile(target, 'manifest.json');
+    if (hit.source === 'none')
+        return null;
+    return JSON.parse(await readFile(hit.abs, 'utf8'));
+}
+function nowUtc() {
+    return new Date().toISOString().replace(/\.\d{3}Z$/, 'Z');
+}
+// 数值三元组比较（x.y.z）：-1 a<b · 0 相等 · 1 a>b。
+// 限制：不支持 pre-release 形态（如 1.2.2-beta.1）；遇非纯数字段按「不等且方向未知」归 -1（维持旧版可升级提示），版本历史均为纯 x.y.z，未来引入 pre-release 再升级比较器。
+// DEF-030：旧包 @cyning/harness 产品线版本形态词表（2.x 系列）。
+// from_version 属 kit 线（1.x）时不算跨产品线迁移，回落原「降级安装」语义。
+function isLegacyHarnessLineVersion(version) {
+    return /^2\./.test(version.trim());
+}
+function compareVersion(a, b) {
+    if (a === b)
+        return 0;
+    const pa = a.split('.').map((p) => Number.parseInt(p, 10));
+    const pb = b.split('.').map((p) => Number.parseInt(p, 10));
+    for (let i = 0; i < 3; i++) {
+        const x = pa[i];
+        const y = pb[i];
+        if (x === undefined || y === undefined || Number.isNaN(x) || Number.isNaN(y))
+            return -1;
+        if (x !== y)
+            return x < y ? -1 : 1;
+    }
+    return 0;
+}
+const INIT_USAGE = 'init [--preset NAME] [--tools all|none|LIST] [--profile core|expanded] [--host-adapt|--no-host-adapt] [--target PATH] [--yes]  （NAME 词表: harness-only）';
+/** 非 TTY / CI：须显式 `--tools`（对齐 OpenSpec） */
+export function isInteractiveInit(stdin = process.stdin) {
+    return Boolean(stdin.isTTY);
+}
+/** 解析 init `--tools`；`none` 仅 init；`all`=适配表全量 */
+export function parseInitToolsArg(toolsArg, knownIds) {
+    const tokens = Array.from(new Set(toolsArg
+        .split(',')
+        .map((s) => s.trim())
+        .filter((s) => s.length > 0)));
+    if (tokens.length < 1) {
+        fail(`init --tools 须为 all|none|LIST（逗号分隔 host_id）\n用法: ${INIT_USAGE}`);
+    }
+    if (tokens.includes('none')) {
+        if (tokens.length !== 1) {
+            fail(`init --tools none 不可与其它 host_id 混用\n用法: ${INIT_USAGE}`);
+        }
+        return { mode: 'none' };
+    }
+    if (tokens.includes('all')) {
+        if (tokens.length !== 1) {
+            fail(`init --tools all 不可与其它 host_id 混用\n用法: ${INIT_USAGE}`);
+        }
+        return { mode: 'hosts', ids: [...knownIds], toolsArg: 'all' };
+    }
+    const known = new Set(knownIds);
+    const unknown = tokens.filter((id) => !known.has(id));
+    if (unknown.length > 0) {
+        fail(`init --tools 未知 host_id: ${unknown.join(', ')}（合法: ${knownIds.join(', ')}）\n用法: ${INIT_USAGE}`);
+    }
+    return { mode: 'hosts', ids: tokens, toolsArg: tokens.join(',') };
+}
+/**
+ * TTY 询问宿主选型（可注入 stdin/stdout；测用 mock Readable）。
+ * 接受：逗号多选 / all / none。
+ */
+export async function promptInitTools(knownIds, io = {}) {
+    const input = io.input ?? process.stdin;
+    const output = io.output ?? process.stdout;
+    const rl = readline.createInterface({ input, output, terminal: false });
+    const ask = (q) => new Promise((resolve) => {
+        rl.question(q, (answer) => resolve(answer));
+    });
+    try {
+        output.write(`请选择要物化的 IDE/宿主（多选逗号分隔，或 all / none）\n可选: ${knownIds.join(', ')}\n`);
+        for (;;) {
+            const raw = (await ask('> ')).trim();
+            if (!raw) {
+                output.write('须输入 all、none 或 host_id 列表（不可空）\n');
+                continue;
+            }
+            try {
+                return parseInitToolsArg(raw, knownIds);
+            }
+            catch (err) {
+                if (err instanceof CliError) {
+                    output.write(`${err.message}\n`);
+                    continue;
+                }
+                throw err;
+            }
+        }
+    }
+    finally {
+        rl.close();
+    }
+}
+async function cmdInit(args, pkgVersion) {
+    if (args.includes('--help') || args.includes('-h')) {
+        console.log(`用法: npx spec-wave ${INIT_USAGE}`);
+        return;
+    }
+    const yes = args.includes('--yes');
+    const hostAdapt = args.includes('--host-adapt');
+    const noHostAdapt = args.includes('--no-host-adapt');
+    if (hostAdapt && noHostAdapt) {
+        fail(`init: --host-adapt 与 --no-host-adapt 不可同现\n用法: ${INIT_USAGE}`);
+    }
+    let rest = args.filter((a) => a !== '--yes' && a !== '--host-adapt' && a !== '--no-host-adapt');
+    const { value: preset, rest: r1 } = takeOption(rest, '--preset');
+    rest = r1;
+    const { value: targetArg, rest: r2 } = takeOption(rest, '--target');
+    rest = r2;
+    const hasToolsFlag = rest.includes('--tools');
+    const { value: toolsArg, rest: r3 } = takeOption(rest, '--tools');
+    rest = r3;
+    if (hasToolsFlag && toolsArg === undefined) {
+        fail(`init --tools 须跟 all|none|LIST\n用法: ${INIT_USAGE}`);
+    }
+    const { value: profileArg, rest: r4 } = takeOption(rest, '--profile');
+    rest = r4;
+    if (rest.length > 0)
+        fail(`init 未知参数: ${rest.join(' ')}\n用法: ${INIT_USAGE}`);
+    const profile = profileArg ?? 'core';
+    if (profile !== 'core' && profile !== 'expanded') {
+        fail(`init 仅支持 --profile core|expanded（收到: ${profile}）\n用法: ${INIT_USAGE}`);
+    }
+    const target = resolveTarget(process.cwd(), targetArg);
+    const chosenPreset = preset || 'harness-only';
+    if (!VALID_PRESETS.includes(chosenPreset)) {
+        fail(`init --preset 取值非法: ${chosenPreset}（合法词表: ${VALID_PRESETS.join(' / ')}）`);
+    }
+    const knownIds = listKnownHostIds();
+    let selection;
+    if (toolsArg === undefined) {
+        if (!isInteractiveInit()) {
+            fail(`init 非交互环境须显式 --tools all|none|LIST（对齐 OpenSpec；禁止假装已询问）\n用法: ${INIT_USAGE}`);
+        }
+        selection = await promptInitTools(knownIds);
+    }
+    else {
+        selection = parseInitToolsArg(toolsArg, knownIds);
+    }
+    const existing = await readManifest(target);
+    if (existing) {
+        console.log(`manifest 已存在，跳过写入: ${manifestPath(target)}`);
+    }
+    else {
+        const mf = {
+            version: pkgVersion,
+            preset: chosenPreset,
+            ide: [],
+            from_version: null,
+            upgraded_at: nowUtc(),
+        };
+        const dest = manifestWritePath(target);
+        mkdirSync(path.dirname(dest), { recursive: true });
+        await writeFile(dest, `${JSON.stringify(mf, null, 2)}\n`, 'utf8');
+        console.log(`已写入 manifest: ${dest}`);
+        console.log(`manifest: ${dest}`);
+    }
+    // freeze：`--no-host-adapt` → 只做过程根，不 apply、不写粘性（避免「记住了却未物化」）
+    const shouldApply = selection.mode === 'hosts' && !noHostAdapt;
+    if (selection.mode === 'none') {
+        console.log('已跳过 host 物化（--tools none）');
+    }
+    else if (!shouldApply) {
+        console.log('已跳过 host 物化（--no-host-adapt；未写粘性）');
+    }
+    else {
+        const applyArgs = [
+            'apply',
+            '--tools',
+            selection.toolsArg,
+            '--profile',
+            profile,
+            '--target',
+            target,
+        ];
+        if (yes)
+            applyArgs.push('--yes');
+        console.log(`联动 host apply（同进程）: --tools ${selection.toolsArg} --profile ${profile}${yes ? ' --yes' : '（dry-run；加 --yes 写盘）'}`);
+        await cmdHost(applyArgs);
+    }
+    if (!yes)
+        console.log('init 完成。');
+}
+async function cmdUpgrade(args, pkgVersion) {
+    if (args.includes('--help') || args.includes('-h')) {
+        console.log('用法: npx spec-wave upgrade [--target PATH] [--yes]');
+        return;
+    }
+    const yes = args.includes('--yes');
+    let rest = args.filter((a) => a !== '--yes');
+    const { value: targetArg, rest: r1 } = takeOption(rest, '--target');
+    rest = r1;
+    if (rest.length > 0)
+        fail(`upgrade 未知参数: ${rest.join(' ')}`);
+    const target = resolveTarget(process.cwd(), targetArg);
+    const current = await readManifest(target);
+    if (!current) {
+        fail('未接入（无 .coding-kit/manifest.json 或 legacy .cyning-harness/manifest.json）。建议: npx spec-wave init --preset harness-only --yes');
+    }
+    const next = {
+        version: pkgVersion,
+        preset: current.preset || 'harness-only',
+        ide: Array.isArray(current.ide) ? current.ide : [],
+        from_version: current.version === pkgVersion ? current.from_version : current.version,
+        upgraded_at: nowUtc(),
+    };
+    const dest = manifestWritePath(target);
+    mkdirSync(path.dirname(dest), { recursive: true });
+    await writeFile(dest, `${JSON.stringify(next, null, 2)}\n`, 'utf8');
+    console.log(`upgrade: ${current.version} → ${pkgVersion}`);
+    console.log(`manifest: ${dest}`);
+    const legHint = legacyLayoutHint(target);
+    if (legHint)
+        console.log(legHint);
+    if (!yes)
+        console.log('upgrade 完成（S2 路径未写入）。');
+    // R-07 §5.2：upgrade 内嵌 dry-run 只读提示（不写 IDE 文件、不改 exit 码；扫描异常吞为提示级）
+    try {
+        const stale = countStaleIdeLiterals(target);
+        if (stale > 0) {
+            console.log('提示: 检测到 ' + stale + ' 处 IDE 块内旧命令字面；运行 `npx spec-wave refresh-ide-blocks --yes` 刷写（先 `refresh-ide-blocks --dry-run` 看详情）。');
+        }
+    }
+    catch {
+        // 提示级：扫描异常不影响 upgrade 语义
+    }
+    console.log('提示: manifest 已升级 · prompts 未自动同步（含 FRAGMENT_hat_reanchor / FRAGMENT_00_delegate_only） · 运行 `npx spec-wave sync prompts --yes`（先 `sync prompts` dry-run 看清单）。');
+}
+async function cmdCheck(args, pkgVersion) {
+    if (args.includes('--help') || args.includes('-h')) {
+        console.log('用法: npx spec-wave check [--target PATH]');
+        return;
+    }
+    let rest = args;
+    const { value: targetArg, rest: r1 } = takeOption(rest, '--target');
+    rest = r1;
+    if (rest.length > 0)
+        fail(`check 未知参数: ${rest.join(' ')}`);
+    const target = resolveTarget(process.cwd(), targetArg);
+    const manifest = await readManifest(target);
+    console.log(`目标: ${target}`);
+    console.log(`包版本: ${pkgVersion}`);
+    if (!manifest) {
+        console.log('状态: 未接入（无 .coding-kit/manifest.json 或 legacy .cyning-harness/manifest.json）');
+        console.log('建议: npx spec-wave init --preset harness-only --yes');
+        return;
+    }
+    console.log(`manifest.version: ${manifest.version}`);
+    console.log(`manifest.preset: ${manifest.preset}`);
+    const cmp = compareVersion(manifest.version, pkgVersion);
+    if (cmp === 0) {
+        console.log('状态: 已是最新');
+    }
+    else if (cmp < 0) {
+        console.log('状态: 可升级');
+        console.log('建议: npx spec-wave upgrade --yes');
+    }
+    else if (manifest.from_version != null && isLegacyHarnessLineVersion(manifest.from_version)) {
+        // DEF-028：from_version 属旧包产品线（2.x 系列）= 从旧产品线迁来，跨产品线版本号不可比，输出迁移语义而非降级警告
+        // DEF-030：判据收窄——kit 线（1.x）from_version 不走本分支，回落下方「降级安装」语义
+        console.log(`状态: 跨产品线迁移：@cyning/harness ${manifest.version} → dsh-coding-kit ${pkgVersion}（跨产品线版本号不可比）`);
+        console.log('建议: npx spec-wave upgrade --yes');
+    }
+    else {
+        console.log('状态: manifest 版本高于包版本（可能为降级安装）');
+        console.log('建议: 核对接入来源（manifest 由更高版本 CLI 写入）');
+    }
+    const bareSpecs = listBareSpecFiles(target);
+    if (bareSpecs.length > 0) {
+        console.log(`WARN: docs/spec 根级裸 SPEC-*.md（${bareSpecs.length}）· 见 docs/spec/doc-health（新 SPEC 须专属夹）`);
+        for (const f of bareSpecs)
+            console.log(`  - docs/spec/${f}`);
+    }
+}
+function formatGateCheck(taskFile, content) {
+    const gates = parseHumanGates(content);
+    const draft = findGate(gates, 'HG-TASK-DRAFT');
+    const audit = findGate(gates, 'HG-AUDIT-R1');
+    const graph = findGate(gates, 'HG-GRAPH-MODULES');
+    const lines = [];
+    lines.push(`task: ${path.basename(taskFile)}`);
+    lines.push('| gate | status | blocks_30 | 30 影响 |');
+    lines.push('|------|--------|-----------|--------|');
+    const draftStatus = draft?.status ?? '?';
+    const draftBlocks = draft?.blocksHats ?? '?';
+    const draftImpact = draftStatus === 'approved' ? '—' : draftBlocks.includes('30') ? '❌ 拒 30' : '—';
+    lines.push(`| HG-TASK-DRAFT | ${draftStatus} | ${draftBlocks} | ${draftImpact} |`);
+    const auditStatus = audit?.status ?? '?';
+    lines.push(`| HG-AUDIT-R1 | ${auditStatus} | 30 | ${auditStatus === 'approved' ? '✅ 可 30' : '❌ 拒 30'} |`);
+    if (graph && graph.status !== '—' && graph.status !== '?') {
+        lines.push(`| HG-GRAPH-MODULES | ${graph.status} | — | ${graph.status === 'approved' ? '✅' : '❌ 若 pending 拒 30'} |`);
+    }
+    lines.push('');
+    const may = evaluateMayStart30(gates);
+    let blocked = false;
+    if (auditStatus !== 'approved') {
+        blocked = true;
+        lines.push('→ 30 不可开工: HG-AUDIT-R1 非 approved（须维护者签 task 表）');
+    }
+    if (draft && draft.status !== 'approved' && draft.blocksHats.includes('30')) {
+        blocked = true;
+        lines.push('→ 30 不可开工: HG-TASK-DRAFT pending 且 blocks 30');
+    }
+    if (graph?.status === 'pending') {
+        blocked = true;
+        lines.push('→ 30 不可开工: HG-GRAPH-MODULES pending');
+    }
+    if (!blocked && !may.ok) {
+        blocked = true;
+        lines.push(`→ 30 不可开工: ${may.reason}`);
+    }
+    lines.push('');
+    return { text: lines.join('\n'), blocked };
+}
+async function cmdGateCheck(args) {
+    if (args.includes('--help') || args.includes('-h')) {
+        console.log('用法: npx spec-wave gate-check [--target PATH] [--task FILE] [--json]');
+        return;
+    }
+    const json = args.includes('--json');
+    let rest = args.filter((a) => a !== '--json');
+    const { value: targetArg, rest: r1 } = takeOption(rest, '--target');
+    rest = r1;
+    const { value: taskFile, rest: r2 } = takeOption(rest, '--task');
+    rest = r2;
+    if (rest.length > 0)
+        fail(`gate-check 未知参数: ${rest.join(' ')}`);
+    const target = resolveTarget(process.cwd(), targetArg);
+    const mf = await readManifest(target);
+    if (!json) {
+        console.log('=== Harness gate-check ===');
+        console.log(`目标: ${target}`);
+        if (mf) {
+            console.log(`manifest.version: ${mf.version}`);
+            console.log(`manifest.preset: ${mf.preset}`);
+        }
+        else {
+            console.log(`manifest: (未接入 · 无 ${manifestPath(target)})`);
+        }
+        console.log('');
+    }
+    if (!taskFile)
+        fail('gate-check 须指定 --task FILE（1.1.0 P0 子集）');
+    const abs = resolveTaskPath(target, taskFile);
+    if (!existsSync(abs))
+        fail(`错误: 未找到 --task 文件 ${abs}`);
+    const formatted = formatGateCheck(abs, await readFile(abs, 'utf8'));
+    if (json) {
+        console.log(JSON.stringify({
+            command: 'gate-check',
+            target,
+            task: taskFile,
+            blocked: formatted.blocked,
+            verdict: formatted.blocked ? 'BLOCKED' : 'PASS',
+        }, null, 2));
+    }
+    else {
+        process.stdout.write(formatted.text);
+    }
+    if (formatted.blocked)
+        fail('', 2);
+    if (!json) {
+        console.log('闸检查: 未发现阻塞（仍须 Agent 首输出 GATE_VERIFY · 不得采信 invoke 字面 approved）');
+    }
+}
+async function cmdAudit(args) {
+    if (args.includes('--help') || args.includes('-h')) {
+        console.log('用法: npx spec-wave audit [--target PATH] [--task FILE]');
+        return;
+    }
+    let rest = args;
+    const { value: targetArg, rest: r1 } = takeOption(rest, '--target');
+    rest = r1;
+    const { value: taskFile, rest: r2 } = takeOption(rest, '--task');
+    rest = r2;
+    if (rest.length > 0)
+        fail(`audit 未知参数: ${rest.join(' ')}`);
+    const target = resolveTarget(process.cwd(), targetArg);
+    console.log(`目标: ${target}`);
+    if (taskFile)
+        console.log(`task: ${taskFile}`);
+    let gateOk = true;
+    let gateText = '';
+    if (taskFile) {
+        const abs = resolveTaskPath(target, taskFile);
+        if (!existsSync(abs))
+            fail(`错误: 未找到 --task 文件 ${abs}`);
+        const formatted = formatGateCheck(abs, await readFile(abs, 'utf8'));
+        gateText = formatted.text;
+        gateOk = !formatted.blocked;
+        process.stdout.write(gateText);
+    }
+    const test = runTestCheck(target, taskFile);
+    console.log(`audit: ${gateOk && test.ok ? 'PASS' : 'FAIL'}`);
+    console.log(`  gate-check: ${gateOk ? 'PASS' : 'FAIL'}`);
+    console.log(`  test-check: ${test.ok ? 'PASS' : 'FAIL'}`);
+    if (test.reason)
+        console.log(`    ${test.reason}`);
+    if (!gateOk || !test.ok)
+        fail('ICVO audit 未通过', 2);
+}
+function wikiLintJson(res) {
+    return { ok: res.ok, issues: res.issues, scanned: res.scanned };
+}
+function printWikiLintIssues(res) {
+    console.log('verify: 缺 wiki_delta 字段的 task（lint-wiki-delta · scope=all · 缺口可能来自兄弟 active/done task）:');
+    for (const m of res.issues) {
+        console.log(`  - ${m.path} · ${m.code} · ${m.detail}`);
+    }
+    console.log('复跑（与 PR CI 同命令）: npx --yes spec-wave task lint-wiki-delta --target .');
+}
+// PRD_DEF-003 后续棒：verify --spec 真闸（SPEC→00 前查审查文存在性 · 消灭最后一个 notDelivered 命令面）。
+// 语义映射旧包 @cyning/harness@2.24.0 lib/verify.js verifySpecTarget（差异见 cli-checks.ts findSpecReview 注释与 PR body）：
+//   · 仅查审查文存在性，不跑 gate-check / audit D5 / task lint（与 --task 模式分离）
+//   · bugfix / skip_spec_audit 元信息豁免（shouldSkipSpecAudit）→ PASS
+//   · 缺失 → VERIFY: BLOCKED · missing spec R<n> review · exit 2
+//   · --allow-no-spec-review（canonical · lifecycle.yaml 登记）/ --allow-no-review（别名）真豁免 · 留痕（文本 + JSON waived[]，与 T4 口径一致）
+async function verifySpecMode(target, specFile, opts) {
+    const abs = resolveTaskPath(target, specFile);
+    const label = path.basename(abs);
+    const emitJson = (blocked, extra, wikiLint) => {
+        console.log(JSON.stringify({
+            command: 'verify',
+            target,
+            spec: specFile,
+            blocked,
+            verdict: blocked ? 'BLOCKED' : 'PASS',
+            ...(extra?.skipped ? { skipped: extra.skipped } : {}),
+            ...(extra?.waived && extra.waived.length > 0 ? { waived: extra.waived } : {}),
+            ...(wikiLint ? { wiki_lint: wikiLintJson(wikiLint) } : {}),
+        }, null, 2));
+    };
+    if (!existsSync(abs))
+        fail(`错误: 未找到 --spec 文件 ${abs}`);
+    const content = await readFile(abs, 'utf8');
+    // K3：--with-wiki-lint 在 --spec 模式同生效（20 审 R1 已定 · 复用 lintWikiDeltaMissing 导出 · 默认档 scope=all）
+    const wikiLint = opts.withWikiLint ? lintWikiDeltaMissing(target, { scope: 'all' }) : null;
+    if (shouldSkipSpecAudit(content)) {
+        if (wikiLint && !wikiLint.ok) {
+            if (opts.json)
+                emitJson(true, { skipped: 'bugfix / skip_spec_audit' }, wikiLint);
+            else {
+                console.log('verify: INFO · skip SPEC review gate（bugfix / skip_spec_audit）');
+                printWikiLintIssues(wikiLint);
+                console.log(`VERIFY: BLOCKED · wiki_delta 缺口（lint-wiki-delta · scope=all）· ${label}`);
+            }
+            fail('', 2);
+        }
+        if (opts.json)
+            emitJson(false, { skipped: 'bugfix / skip_spec_audit' }, wikiLint);
+        else {
+            console.log('verify: INFO · skip SPEC review gate（bugfix / skip_spec_audit）');
+            if (wikiLint)
+                console.log(`verify: wiki-lint PASS · scanned: ${wikiLint.scanned} · scope: all`);
+            console.log(`VERIFY: PASS · ${label}`);
+        }
+        return;
+    }
+    const allowFlag = opts.allowNoSpecReview ? '--allow-no-spec-review' : opts.allowNoReview ? '--allow-no-review' : null;
+    const reviewFound = findSpecReview(target, abs, content);
+    if (!reviewFound && !allowFlag) {
+        if (opts.json)
+            emitJson(true);
+        else
+            console.log(`VERIFY: BLOCKED · missing spec R<n> review · ${label}`);
+        fail('', 2);
+    }
+    const waived = [];
+    if (!reviewFound && allowFlag) {
+        waived.push(`missing spec R<n> review（${allowFlag} 豁免）`);
+        if (!opts.json) {
+            console.log(`verify: 留痕 · 缺 spec R<n> 审查文 · ${allowFlag} 豁免生效（仍须补审并由维护者签 HG-SPEC-SIGNOFF）`);
+        }
+    }
+    if (wikiLint && !wikiLint.ok) {
+        if (opts.json)
+            emitJson(true, { waived }, wikiLint);
+        else {
+            printWikiLintIssues(wikiLint);
+            console.log(`VERIFY: BLOCKED · wiki_delta 缺口（lint-wiki-delta · scope=all）· ${label}`);
+        }
+        fail('', 2);
+    }
+    if (opts.json)
+        emitJson(false, { waived }, wikiLint);
+    else {
+        if (wikiLint)
+            console.log(`verify: wiki-lint PASS · scanned: ${wikiLint.scanned} · scope: all`);
+        console.log(`VERIFY: PASS · ${label}`);
+    }
+}
+async function cmdVerify(args) {
+    if (args.includes('--help') || args.includes('-h')) {
+        console.log('用法: npx spec-wave verify [--target PATH] [--task FILE | --spec FILE] [--json] [--with-wiki-lint] [--allow-no-review] [--allow-invoke-gap] [--allow-no-spec-review]');
+        return;
+    }
+    const json = args.includes('--json');
+    let rest = args.filter((a) => a !== '--json');
+    const { value: targetArg, rest: r1 } = takeOption(rest, '--target');
+    rest = r1;
+    const { value: taskFile, rest: r2 } = takeOption(rest, '--task');
+    rest = r2;
+    const { value: specFile, rest: r3 } = takeOption(rest, '--spec');
+    rest = r3;
+    // DEF-003 阶段二 T4/T5：--allow-no-review / --allow-invoke-gap 真生效（硬闸豁免 · 留痕）；
+    // PRD_DEF-003 后续棒：--allow-no-spec-review 真生效（verify --spec 豁免 · 留痕）；
+    // 其余 --allow-* 仍走 DEF-011 fail-fast（--allow-lint-fail 等归 DEF-011 交接清单）
+    const allowNoReview = rest.includes('--allow-no-review');
+    rest = rest.filter((a) => a !== '--allow-no-review');
+    const allowInvokeGap = rest.includes('--allow-invoke-gap');
+    rest = rest.filter((a) => a !== '--allow-invoke-gap');
+    const allowNoSpecReview = rest.includes('--allow-no-spec-review');
+    rest = rest.filter((a) => a !== '--allow-no-spec-review');
+    // K3：--with-wiki-lint 追加闸（显式旗标 · 非破坏；preset 默认开启为独立决策点，本 task 不做）
+    const withWikiLint = rest.includes('--with-wiki-lint');
+    rest = rest.filter((a) => a !== '--with-wiki-lint');
+    if (rest.length > 0)
+        fail(`verify 未知参数: ${rest.join(' ')}`);
+    const target = resolveTarget(process.cwd(), targetArg);
+    // --task 与 --spec 互斥（旧包 lib/cli.js#487-491 语义 · exit 1 用法错误）
+    if (taskFile && specFile)
+        fail('verify：--task 与 --spec 互斥');
+    if (specFile) {
+        await verifySpecMode(target, specFile, { json, allowNoSpecReview, allowNoReview, withWikiLint });
+        return;
+    }
+    if (!taskFile)
+        fail('verify 须指定 --task FILE 或 --spec FILE');
+    const abs = resolveTaskPath(target, taskFile);
+    const label = path.basename(abs);
+    const emitJson = (blocked, waived, wikiLint) => {
+        console.log(JSON.stringify({
+            command: 'verify',
+            target,
+            task: taskFile,
+            blocked,
+            verdict: blocked ? 'BLOCKED' : 'PASS',
+            ...(waived && waived.length > 0 ? { waived } : {}),
+            ...(wikiLint ? { wiki_lint: wikiLintJson(wikiLint) } : {}),
+        }, null, 2));
+    };
+    if (!existsSync(abs)) {
+        if (json)
+            emitJson(true);
+        else
+            console.log(`VERIFY: BLOCKED · task 文件不存在 · ${label}`);
+        fail('', 2);
+    }
+    const content = await readFile(abs, 'utf8');
+    const formatted = formatGateCheck(abs, content);
+    if (!json)
+        process.stdout.write(formatted.text);
+    if (formatted.blocked) {
+        const gates = parseHumanGates(content);
+        const audit = findGate(gates, 'HG-AUDIT-R1');
+        const reason = audit?.status !== 'approved' ? 'HG-AUDIT-R1 pending' : formatted.text.includes('HG-TASK-DRAFT')
+            ? 'HG-TASK-DRAFT pending'
+            : 'gate-check blocked';
+        if (json)
+            emitJson(true);
+        else
+            console.log(`VERIFY: BLOCKED · ${reason} · ${label}`);
+        fail('', 2);
+    }
+    const test = runTestCheck(target, taskFile);
+    if (!test.ok) {
+        if (json)
+            emitJson(true);
+        else
+            console.log(`VERIFY: BLOCKED · ${test.reason} · ${label}`);
+        fail('', 2);
+    }
+    // DEF-003 阶段二 T4：R<n> 审查文存在性硬闸（findReview 与 status / dry-run 同口径 · cli-checks 单一实现源）
+    const reviewFound = findReview(target, abs);
+    if (!reviewFound && !allowNoReview) {
+        if (json)
+            emitJson(true);
+        else
+            console.log(`VERIFY: BLOCKED · missing R<n> review · ${label}`);
+        fail('', 2);
+    }
+    const waived = [];
+    if (!reviewFound && allowNoReview) {
+        waived.push('missing R<n> review（--allow-no-review 豁免）');
+        if (!json) {
+            console.log('verify: 留痕 · 缺 R<n> 审查文 · --allow-no-review 豁免生效（仍须补审并由维护者签 HG-AUDIT-R1）');
+        }
+    }
+    // DEF-003 阶段二 T5：pre-30 invoke hats 硬闸（required ∩ {10,20,00} · cli-checks 单一实现源，
+    // 与 task close 帽集合检查同口径；缺 40 不挡 30 · minimal 无 preRequired 不挡）
+    const invoke = checkPre30InvokeHats(target, abs);
+    if (!invoke.ok && !allowInvokeGap) {
+        if (json)
+            emitJson(true);
+        else
+            console.log(`VERIFY: BLOCKED · missing pre-30 invoke hats: ${invoke.missing.join(',')} · ${label}`);
+        fail('', 2);
+    }
+    if (!invoke.ok && allowInvokeGap) {
+        waived.push(`missing pre-30 invoke hats: ${invoke.missing.join(',')}（--allow-invoke-gap 豁免）`);
+        if (!json) {
+            console.log(`verify: 留痕 · 缺 pre-30 invoke hats: ${invoke.missing.join(',')}（${invoke.source}）· --allow-invoke-gap 豁免生效（仍须补落 invoke 快照）`);
+        }
+    }
+    // K3：--with-wiki-lint 追加闸（既有全部硬闸之后 · 复用 lintWikiDeltaMissing 导出 · 默认档 scope=all）；
+    // target 无 docs/tasks/ 候选目录时 scanned:0/ok:true，不得误 BLOCKED（失败路径表边缘行）
+    if (withWikiLint) {
+        const wikiLint = lintWikiDeltaMissing(target, { scope: 'all' });
+        if (!wikiLint.ok) {
+            if (json)
+                emitJson(true, waived, wikiLint);
+            else {
+                printWikiLintIssues(wikiLint);
+                console.log(`VERIFY: BLOCKED · wiki_delta 缺口（lint-wiki-delta · scope=all）· ${label}`);
+            }
+            fail('', 2);
+        }
+        if (json)
+            emitJson(false, waived, wikiLint);
+        else {
+            console.log(`verify: wiki-lint PASS · scanned: ${wikiLint.scanned} · scope: all`);
+            console.log(`VERIFY: PASS · ${label}`);
+        }
+        return;
+    }
+    if (json)
+        emitJson(false, waived);
+    else {
+        console.log(`VERIFY: PASS · ${label}`);
+    }
+}
+async function cmdTaskLint(args) {
+    const json = args.includes('--json');
+    let rest = args.filter((a) => a !== '--json');
+    const { value: fileArg, rest: r1 } = takeOption(rest, '--file');
+    rest = r1;
+    if (rest.length > 0)
+        fail(`task lint 未知参数: ${rest.join(' ')}`);
+    if (!fileArg)
+        fail('task lint 须指定 --file PATH');
+    const result = lintTaskFile(fileArg, process.cwd());
+    if (json) {
+        console.log(JSON.stringify(result, null, 2));
+    }
+    else {
+        for (const e of result.errors) {
+            console.log(`  - [${e.rule}${e.line ? `:L${e.line}` : ''}] ${e.message}`);
+        }
+        for (const w of result.warnings) {
+            console.log(`warn: [${w.rule}${w.line ? `:L${w.line}` : ''}] ${w.message}`);
+        }
+        console.log(`LINT: ${result.ok ? 'PASS' : 'FAIL'} · ${path.basename(result.file)}`);
+    }
+    if (!result.ok)
+        fail('', 2);
+}
+async function cmdTaskClose(args) {
+    const yes = args.includes('--yes');
+    // K5（close-done-snapshot · 拟 1.8.0）：task close 新增 --json 旗标
+    // （done_snapshot 唯绑归档事件 · 20 审 R2 口径裁决）
+    const json = args.includes('--json');
+    // DEF-003 阶段二 T6 + doc-health：close 守卫豁免旗标
+    const allowUnchecked = args.includes('--allow-unchecked');
+    const allowInvokeGap = args.includes('--allow-invoke-gap');
+    const allowNoReview = args.includes('--allow-no-review');
+    const allowKpiGap = args.includes('--allow-kpi-gap');
+    const allowExperienceGap = args.includes('--allow-experience-gap');
+    const allowWikiGap = args.includes('--allow-wiki-gap');
+    const allowNoPrMerge = args.includes('--allow-no-pr-merge');
+    const allowNoHub = args.includes('--allow-no-hub');
+    let rest = args.filter((a) => a !== '--yes' &&
+        a !== '--json' &&
+        a !== '--allow-unchecked' &&
+        a !== '--allow-invoke-gap' &&
+        a !== '--allow-no-review' &&
+        a !== '--allow-kpi-gap' &&
+        a !== '--allow-experience-gap' &&
+        a !== '--allow-wiki-gap' &&
+        a !== '--allow-no-pr-merge' &&
+        a !== '--allow-no-hub');
+    const { value: fileArg, rest: r1 } = takeOption(rest, '--file');
+    rest = r1;
+    const { value: targetArg, rest: r2 } = takeOption(rest, '--target');
+    rest = r2;
+    if (rest.length > 0)
+        fail(`task close 未知参数: ${rest.join(' ')}`);
+    if (!fileArg)
+        fail('task close 须指定 --file PATH');
+    const abs = path.resolve(process.cwd(), fileArg);
+    if (!existsSync(abs))
+        fail(`task 文件不存在: ${fileArg}`, 2);
+    const content = await readFile(abs, 'utf8');
+    const meta = parseHarnessMeta(content);
+    const fileSlug = extractTaskSlug(abs);
+    const slug = meta.task_slug ?? fileSlug;
+    const blockers = [];
+    const traces = [];
+    const closeAllowFlags = {
+        close_invoke: allowInvokeGap ? '--allow-invoke-gap' : undefined,
+        close_acceptance: allowUnchecked ? '--allow-unchecked' : undefined,
+        close_review: allowNoReview ? '--allow-no-review' : undefined,
+        close_kpi: allowKpiGap ? '--allow-kpi-gap' : undefined,
+        close_experience: allowExperienceGap ? '--allow-experience-gap' : undefined,
+        close_wiki_delta: allowWikiGap ? '--allow-wiki-gap' : undefined,
+        close_wiki_promotion: allowWikiGap ? '--allow-wiki-gap' : undefined,
+        close_pr_merged: allowNoPrMerge ? '--allow-no-pr-merge' : undefined,
+        close_hub_index: allowNoHub ? '--allow-no-hub' : undefined,
+    };
+    for (const guardId of CLOSE_GUARD_ORDER) {
+        const outcome = evalCloseGuard(guardId, abs, content);
+        if (!outcome)
+            continue;
+        if (outcome.status === 'warn') {
+            traces.push(`close: warn · ${guardId} · ${outcome.detail}`);
+            continue;
+        }
+        if (outcome.status === 'fail') {
+            const flag = closeAllowFlags[guardId];
+            if (flag)
+                traces.push(`close: 留痕 · ${guardId} · ${outcome.detail} → ${flag} 豁免生效`);
+            else
+                blockers.push(`${guardId}: ${outcome.detail}`);
+        }
+    }
+    const activeDir = path.dirname(abs);
+    const inActive = path.basename(activeDir) === 'active';
+    let dest = null;
+    if (targetArg && path.basename(targetArg).endsWith('.md')) {
+        dest = path.resolve(process.cwd(), targetArg);
+    }
+    else if (!inActive) {
+        blockers.push('源文件不在 */active/ 且未指定 --target（拒绝对 done 文件二次 close）');
+    }
+    else {
+        dest = path.join(path.dirname(activeDir), 'done', path.basename(abs));
+    }
+    if (dest && existsSync(dest))
+        blockers.push(`目标已存在（不覆盖）: ${dest}`);
+    if (!json) {
+        for (const t of traces)
+            console.log(t);
+    }
+    if (blockers.length > 0) {
+        if (json) {
+            // K5：--json BLOCKED —— 非 0 退出 · JSON 仅错误面（无 done_snapshot 字段）
+            console.log(JSON.stringify({ ok: false, status: 'BLOCKED', slug, blockers, traces }, null, 2));
+        }
+        else {
+            for (const b of blockers)
+                console.log(`  - ${b}`);
+            console.log(`CLOSE: BLOCKED · ${slug}`);
+        }
+        fail('', 2);
+    }
+    if (!yes) {
+        if (json) {
+            // K5：--json READY（dry-run · 含豁免 dry-run）—— 未归档 → done_snapshot 恒 null · exit 0
+            console.log(JSON.stringify({ ok: true, status: 'READY', slug, dest, traces, done_snapshot: null }, null, 2));
+        }
+        else {
+            console.log('mode: dry-run（未执行 mv · 加 --yes 执行）');
+            console.log(`dest: ${dest}`);
+            console.log(`CLOSE: READY · ${slug}`);
+        }
+        return;
+    }
+    if (!dest)
+        fail('无法解析归档目标', 2);
+    mkdirSync(path.dirname(dest), { recursive: true });
+    renameSync(abs, dest);
+    // K5：真归档（renameSync 执行）后构建 done 片段快照 —— 摘录归档文件内
+    // '## Harness 元信息' 节原文（extractSection · 归档真值防模板漂移）；快照存在性
+    // 唯绑归档事件，与豁免旗标无关（20 审 R2 口径裁决：豁免 + --yes → 快照照打）
+    const snapshot = buildDoneSnapshot(dest);
+    if (json) {
+        console.log(JSON.stringify({
+            ok: true,
+            status: 'PASS',
+            slug,
+            dest,
+            traces,
+            done_snapshot: {
+                path: snapshot.path,
+                harness_meta_section: snapshot.harness_meta_section,
+            },
+        }, null, 2));
+        return;
+    }
+    console.log(`moved: ${abs} → ${dest}`);
+    console.log(`CLOSE: PASS · ${slug}`);
+    // K5（W1）：PASS 分支 stdout 追加快照块 —— 归档后路径 + 元信息节摘录 + 禁手写提示；
+    // 取不到元信息节（异常态）打 canonical 模板占位 + WARN 行；不改 CLOSE: PASS 冻结文案，仅追加
+    console.log(`done_snapshot · path: ${snapshot.path}`);
+    if (snapshot.warn)
+        console.log(`WARN: ${snapshot.warn}`);
+    console.log('done_snapshot · harness_meta_section:');
+    console.log(snapshot.harness_meta_section);
+    console.log('done_snapshot · 禁止手写 done · 以此快照为格式真值');
+}
+const TASK_USAGE = 'task lint --file PATH · task close --file PATH [--yes] [--json] [--allow-unchecked] [--allow-invoke-gap] [--allow-no-review] [--allow-kpi-gap] [--allow-experience-gap] [--allow-wiki-gap] [--allow-no-pr-merge] [--allow-no-hub] · task lint-done · task lint-wiki-delta · task check --file PATH';
+async function cmdTask(args) {
+    const [sub, ...rest] = args;
+    if (sub === '--help' || sub === '-h') {
+        console.log(`用法: ${TASK_USAGE}`);
+        return;
+    }
+    if (!sub)
+        fail(`task 子命令未知: (空)\n用法: ${TASK_USAGE}`);
+    if (sub === 'lint') {
+        await cmdTaskLint(rest);
+        return;
+    }
+    if (sub === 'close') {
+        await cmdTaskClose(rest);
+        return;
+    }
+    if (sub === 'lint-done') {
+        await cmdTaskLintDone(rest);
+        return;
+    }
+    if (sub === 'lint-wiki-delta') {
+        await cmdTaskLintWikiDelta(rest);
+        return;
+    }
+    if (sub === 'check') {
+        await cmdTaskCheck(rest);
+        return;
+    }
+    fail(`task 子命令未知: ${sub}\n用法: ${TASK_USAGE}`);
+}
+export async function runCli(argv) {
+    const pkgVersion = await readPkgVersion();
+    if (argv.length === 0 || argv[0] === '-h' || argv[0] === '--help') {
+        usage(pkgVersion);
+        return;
+    }
+    if (argv.includes('--version') || argv.includes('-V')) {
+        console.log(pkgVersion);
+        return;
+    }
+    const [cmd, ...rest] = argv;
+    if (cmd === 'init') {
+        await cmdInit(rest, pkgVersion);
+        return;
+    }
+    if (cmd === 'upgrade') {
+        await cmdUpgrade(rest, pkgVersion);
+        return;
+    }
+    if (cmd === 'check') {
+        await cmdCheck(rest, pkgVersion);
+        return;
+    }
+    if (cmd === 'refresh-ide-blocks') {
+        await cmdRefreshIdeBlocks(rest);
+        return;
+    }
+    if (cmd === 'audit') {
+        await cmdAudit(rest);
+        return;
+    }
+    if (cmd === 'gate-check') {
+        await cmdGateCheck(rest);
+        return;
+    }
+    if (cmd === 'verify') {
+        await cmdVerify(rest);
+        return;
+    }
+    if (cmd === 'task') {
+        await cmdTask(rest);
+        return;
+    }
+    if (cmd === 'status') {
+        await cmdStatus(rest);
+        return;
+    }
+    if (cmd === 'timeline') {
+        await cmdTimeline(rest);
+        return;
+    }
+    if (cmd === 'lifecycle') {
+        await cmdLifecycle(rest);
+        return;
+    }
+    if (cmd === 'discipline') {
+        await cmdDiscipline(rest);
+        return;
+    }
+    if (cmd === 'skills') {
+        await cmdSkills(rest);
+        return;
+    }
+    if (cmd === 'host') {
+        await cmdHost(rest);
+        return;
+    }
+    if (cmd === 'sync') {
+        await cmdSync(rest);
+        return;
+    }
+    if (cmd === 'graph') {
+        await cmdGraph(rest);
+        return;
+    }
+    if (cmd === 'wiki') {
+        await cmdWiki(rest);
+        return;
+    }
+    fail(`未知命令: ${cmd}\n`);
+}
+function isMain() {
+    const entry = process.argv[1];
+    if (!entry)
+        return false;
+    try {
+        const resolved = path.resolve(entry);
+        const self = fileURLToPath(import.meta.url);
+        if (resolved === self)
+            return true;
+        return path.basename(resolved) === path.basename(self);
+    }
+    catch {
+        return false;
+    }
+}
+if (isMain()) {
+    runCli(process.argv.slice(2)).catch((err) => {
+        const e = err;
+        if (e.message)
+            console.error(e.message);
+        process.exit(typeof e.exitCode === 'number' ? e.exitCode : 1);
+    });
+}
+//# sourceMappingURL=cli.js.map