@dommaker/harness 0.19.0 → 1.0.0

package/bin/harness.js

@@ -2,595 +2,174 @@
 
 /**
  * @dommaker/harness CLI 入口
- * 
+ *
  * 通用工程约束框架
+ *
+ * H5（#44）：命令注册表驱动生成（R6 消灭手工 commander 块 + commands/index.ts
+ * 两处同步）+ per-command 懒加载（O2，拆单一 commands barrel）。
+ * 本文件是纯通用引擎：命令形状（名称/别名/选项/子命令/实现引用）全部来自
+ * COMMAND_DEFINITIONS（非门禁命令）与 GATE_DEFINITIONS.cli（6 门禁命令），
+ * 不含任何单命令知识；新增命令 = 命令文件 + 定义表一条 + 测试，不再改本文件。
  */
 
 const { Command } = require('commander');
 const { version } = require('../package.json');
 
 /**
- * 懒加载命令实现（工单 17）：只在 .action 执行时 require 命令桶，
- * --version/--help 等不触发命令体的调用不再加载全部实现。
+ * 命令定义表（纯数据模块，无实现 import），--help/--version 懒加载不受影响；
+ * 门禁注册表双向闭环校验在实现加载期执行（src/gates/registry.ts），
+ * 命令实现引用可解析性断言在测试期执行（src/cli/commands/__tests__/registry.test.ts）。
  */
-function cmd(name) {
-  return require('../dist/cli/commands/index')[name];
+const { COMMAND_DEFINITIONS } = require('../dist/cli/commands/definitions');
+const { GATE_DEFINITIONS } = require('../dist/gates/definitions');
+
+/**
+ * per-command 懒加载（O2）：按定义表中的 module+export 引用，只在 action
+ * 执行时 require 对应命令模块——任一命令执行不再经单一 barrel 加载全部命令实现。
+ */
+function loadImpl(ref) {
+  const mod = require('../dist/cli/commands/' + ref.module);
+  const fn = mod[ref.export];
+  if (typeof fn !== 'function') {
+    throw new Error(
+      `[harness] 命令实现 "${ref.export}" 在 dist/cli/commands/${ref.module} 中不存在或不是函数。`
+    );
+  }
+  return fn;
 }
 
-const program = new Command();
+function callImpl(ref, args = []) {
+  return loadImpl(ref)(...args);
+}
 
-program
-  .name('harness')
-  .description('通用工程约束框架 - 铁律系统、检查点验证、测试门控、执行追踪')
-  .version(version);
+/** 位置参数个数（'[a] [b]' → 2；无声明 → 0） */
+function positionalCount(argument) {
+  if (!argument) return 0;
+  const matches = argument.match(/\[[^\]]+\]|<[^>]+>/g);
+  return matches ? matches.length : 0;
+}
 
-// ========================================
-// harness check
-// ========================================
-program
-  .command('check')
-  .description('检查铁律是否满足')
-  .option('-p, --preset <preset>', '预设名称', 'standard')
-  .option('-s, --staged', '只检查暂存文件', false)
-  .option('-t, --trigger <trigger>', '触发条件')
-  .option('--project-path <path>', '项目路径')
-  .option('--list', '列出所有铁律')
-  .action(async (options) => {
-    if (options.list) {
-      cmd('listLaws')();
+/**
+ * 定义表 → commander 命令树（递归处理 children，如 constraints report/retire）
+ */
+function buildCommand(parent, def) {
+  const command = parent.command(def.command + (def.argument ? ' ' + def.argument : ''));
+  command.description(def.description);
+  if (def.alias) command.alias(def.alias);
+  for (const opt of def.options) {
+    if (opt.defaultValue !== undefined) {
+      command.option(opt.flags, opt.description, opt.defaultValue);
     } else {
-      await cmd('check')(options);
+      command.option(opt.flags, opt.description);
     }
-  });
-
-// ========================================
-// harness validate
-// ========================================
-program
-  .command('validate')
-  .description('验证检查点是否满足')
-  .option('-f, --file <path>', '检查点文件路径')
-  .option('-p, --project-path <path>', '项目路径')
-  .option('--strict', '严格模式（任何失败都退出）', false)
-  .action(async (options) => {
-    await cmd('validate')(options);
-  });
+  }
+
+  const argCount = positionalCount(def.argument);
+  command.action(async (...args) => {
+    // commander：有位置参数时 [p1..pN（缺失为 null）, options, command]；
+    // 无位置参数时 [options, command]
+    const positionals = argCount > 0
+      ? args.slice(0, argCount).map(p => (p === null ? undefined : p))
+      : [];
+    const options = argCount > 0 ? args[argCount] : args[0];
+    await runDefinition(command, def, positionals, options);
+  });
+
+  for (const child of def.children || []) {
+    buildCommand(command, child);
+  }
+}
 
-// ========================================
-// harness passes-gate
-// ========================================
-program
-  .command('passes-gate')
-  .description('运行测试门控，确保测试通过')
-  .alias('pg')
-  .option('-t, --test-command <command>', '测试命令')
-  .option('-p, --project-path <path>', '项目路径')
-  .option('--allow-partial', '允许部分测试通过', false)
-  .option('--max-retries <n>', '最大重试次数', '2')
-  .option('--coverage', '检查测试覆盖率')
-  .option('--coverage-threshold <n>', '覆盖率阈值', '80')
-  .action(async (options) => {
-    if (options.coverage) {
-      const threshold = parseInt(options.coverageThreshold, 10);
-      await cmd('runPassesGate')(options);
-      const projectPath = options.projectPath || process.cwd();
-      await cmd('checkCoverage')(projectPath, threshold);
-    } else {
-      await cmd('runPassesGate')(options);
+/**
+ * 执行一条命令定义：
+ * 1. optionRoutes（选项条件路由，全部匹配项按序执行，替代默认 action）
+ * 2. subcommands（位置参数首值路由；strict 下未知值报错退出）
+ * 3. 默认 action
+ * afterRun 统一接收返回值（如 sync-docs --check 失败 exit(1)）
+ */
+async function runDefinition(command, def, positionals, options) {
+  if (def.optionRoutes) {
+    const matched = def.optionRoutes.filter(r => options[r.flag] === r.when);
+    if (matched.length > 0) {
+      for (const route of matched) {
+        await callImpl(route.impl, route.args ? route.args(positionals, options) : [options]);
+      }
+      return;
     }
-  });
-
-// ========================================
-// harness init
-// ========================================
-program
-  .command('init')
-  .description('初始化项目的 harness 配置')
-  .option('-p, --preset <preset>', '预设名称 (strict/standard/relaxed)', 'standard')
-  .option('-g, --governance <level>', '治理级别 (minimal/standard/strict)')
-  .option('-t, --type <type>', '项目类型 (node-api/nextjs-app/python-api/custom)')
-  .option('--project-path <path>', '项目路径')
-  .option('--no-git-hooks', '不创建 Git hooks')
-  .option('--no-github-actions', '不创建 GitHub Actions')
-  .option('--print-snippets', '只输出代码片段，不创建文件')
-  .action(async (options) => {
-    await cmd('init')(options);
-  });
-
-// ========================================
-// harness report
-// ========================================
-program
-  .command('report')
-  .description('生成检查报告')
-  .option('-o, --output <path>', '输出文件路径')
-  .option('-f, --format <format>', '输出格式 (json/markdown/html)', 'markdown')
-  .option('-p, --project-path <path>', '项目路径')
-  .action(async (options) => {
-    await cmd('report')(options);
-  });
-
-// ========================================
-// harness status
-// ========================================
-program
-  .command('status')
-  .description('显示 Harness 状态、统计、异常检测')
-  .option('-p, --project-path <path>', '项目路径')
-  .option('-d, --detail', '显示详细信息', false)
-  .option('-a, --anomalies', '只显示异常', false)
-  .option('--hours <n>', '分析最近 N 小时', '24')
-  .action(async (options) => {
-    await cmd('status')({
-      projectPath: options.projectPath,
-      detail: options.detail,
-      anomalies: options.anomalies,
-      hours: parseInt(options.hours, 10),
-    });
-  });
-
-// ========================================
-// harness spec
-// ========================================
-program
-  .command('spec [subcommand]')
-  .description('Spec 验证命令')
-  .option('-s, --schema <path>', 'Schema 路径（项目定义）')
-  .option('--staged', '只验证暂存文件', false)
-  .option('-f, --file <path>', '验证指定文件')
-  .option('-p, --project-path <path>', '项目路径')
-  .option('-v, --verbose', '详细输出', false)
-  .action(async (subcommand, options, command) => {
-    if (subcommand === 'list') {
-      cmd('listSpecTypes')();
+  }
+
+  if (def.subcommands) {
+    const sub = positionals[0];
+    if (sub != null) {
+      const entry = def.subcommands[sub];
+      if (entry) {
+        const result = await callImpl(entry.impl, entry.args ? entry.args(positionals.slice(1), options) : [options]);
+        if (def.afterRun) def.afterRun(result, options);
+        return;
+      }
+      if (def.subcommandStrict !== false) {
+        console.error(`未知子命令: ${sub}`);
+        process.exit(1);
+      }
+      // 非 strict（如 spec）：未知位置参数落回默认 action
     } else {
-      // 默认执行 validate
-      await cmd('specValidate')({
-        schema: options.schema,
-        staged: options.staged,
-        file: options.file || (subcommand && !subcommand.startsWith('-') ? subcommand : undefined),
-        projectPath: options.projectPath,
-        verbose: options.verbose,
-      });
+      // 无子命令时显示帮助
+      command.help();
+      return;
     }
-  });
+  }
+
+  if (!def.action) {
+    command.help();
+    return;
+  }
+  const result = await callImpl(def.action, def.mapActionArgs ? def.mapActionArgs(positionals, options) : [options]);
+  if (def.afterRun) def.afterRun(result, options);
+}
 
-// ========================================
-// harness acceptance
-// ========================================
-program
-  .command('acceptance [subcommand]')
-  .description('验收标准门控，检查任务是否满足验收标准')
-  .alias('acc')
-  .option('-t, --task-id <id>', '任务 ID')
-  .option('--tasks-path <path>', 'tasks.yml 路径')
-  .option('-p, --project-path <path>', '项目路径')
-  .option('--check-all', '检查所有任务', false)
-  .option('--run-e2e', '运行 E2E 测试', false)
-  .action(async (subcommand, options, command) => {
-    if (subcommand === 'list') {
-      await cmd('listAcceptanceCriteria')(options);
-    } else {
-      await cmd('acceptance')(options);
-    }
-  });
+const program = new Command();
 
-// ========================================
-// harness performance
-// ========================================
 program
-  .command('performance')
-  .description('性能门控，检查性能指标')
-  .alias('perf')
-  .option('-p, --project-path <path>', '项目路径')
-  .option('--coverage', '检查测试覆盖率', false)
-  .option('--coverage-threshold <n>', '覆盖率阈值', '80')
-  .option('--bundle', '检查打包大小', false)
-  .option('--bundle-threshold <n>', '打包大小阈值 (KB)', '500')
-  .option('--benchmark', '运行基准测试', false)
-  .option('--benchmark-timeout <n>', '基准测试超时（秒）', '60')
-  .action(async (options) => {
-    await cmd('performance')({
-      projectPath: options.projectPath,
-      coverage: options.coverage,
-      coverageThreshold: parseInt(options.coverageThreshold, 10),
-      bundle: options.bundle,
-      bundleThreshold: parseInt(options.bundleThreshold, 10),
-      benchmark: options.benchmark,
-      benchmarkTimeout: parseInt(options.benchmarkTimeout, 10),
-    });
-  });
+  .name('harness')
+  .description('通用工程约束框架 - 铁律系统、检查点验证、测试门控、执行追踪')
+  .version(version);
 
 // ========================================
-// harness security
+// 非门禁命令：COMMAND_DEFINITIONS 注册表驱动生成
 // ========================================
-program
-  .command('security [subcommand]')
-  .description('安全门控，检查安全漏洞')
-  .alias('sec')
-  .option('-p, --project-path <path>', '项目路径')
-  .option('--severity <level>', '严重性阈值 (low/moderate/high/critical)', 'high')
-  .option('--ignore-warnings', '忽略警告', false)
-  .option('--ignore-dev-deps', '忽略开发依赖', false)
-  .option('--scan-command <cmd>', '自定义扫描命令')
-  .action(async (subcommand, options, command) => {
-    if (subcommand === 'audit') {
-      await cmd('auditDetails')(options);
-    } else {
-      await cmd('security')(options);
-    }
-  });
+for (const def of COMMAND_DEFINITIONS) {
+  buildCommand(program, def);
+}
 
 // ========================================
-// harness contract
+// 门禁命令（6 个）：GATE_DEFINITIONS.cli 注册表驱动生成（G1）
 // ========================================
-program
-  .command('contract [subcommand]')
-  .description('API 契约门控，检查 OpenAPI Schema')
-  .option('-p, --project-path <path>', '项目路径')
-  .option('--contract-path <path>', '契约文件路径', 'openapi.yaml')
-  .option('--no-strict', '关闭严格模式')
-  .option('--allow-breaking', '允许破坏性变更', false)
-  .action(async (subcommand, options, command) => {
-    if (subcommand === 'validate') {
-      await cmd('validateSchema')(options);
+for (const def of GATE_DEFINITIONS) {
+  const cli = def.cli;
+  const command = program.command(cli.command + (cli.argument ? ' ' + cli.argument : ''));
+  command.description(cli.description);
+  if (cli.alias) {
+    command.alias(cli.alias);
+  }
+  for (const opt of cli.options) {
+    if (opt.defaultValue !== undefined) {
+      command.option(opt.flags, opt.description, opt.defaultValue);
     } else {
-      await cmd('contract')(options);
+      command.option(opt.flags, opt.description);
     }
-  });
-
-// ========================================
-// harness review
-// ========================================
-program
-  .command('review [subcommand]')
-  .description('代码审查门控，检查审查状态')
-  .option('-p, --project-path <path>', '项目路径')
-  .option('--min-reviewers <n>', '最少审查人数', '1')
-  .option('--no-require-approval', '不要求审批')
-  .option('--no-block-on-changes', '不阻止变更请求')
-  .option('--allowed-reviewers <list>', '允许的审查者（逗号分隔）')
-  .action(async (subcommand, options, command) => {
-    if (subcommand === 'status') {
-      await cmd('reviewStatus')(options);
+  }
+  command.action(async (arg, options) => {
+    // commander：无位置参数的命令把 options 传入第一个形参
+    const realArg = cli.argument ? arg : undefined;
+    const realOptions = cli.argument ? options : arg;
+    const sub = cli.subcommands && realArg != null ? cli.subcommands[realArg] : undefined;
+    if (sub) {
+      await callImpl(sub, [realOptions]);
     } else {
-      await cmd('review')({
-        projectPath: options.projectPath,
-        minReviewers: parseInt(options.minReviewers, 10),
-        requireApproval: options.requireApproval,
-        blockOnChangesRequested: options.blockOnChanges,
-        allowedReviewers: options.allowedReviewers,
-      });
-    }
-  });
-
-// ========================================
-// harness command
-// ========================================
-program
-  .command('command [cmd]')
-  .description('检查命令是否在黑名单中')
-  .alias('cmd')
-  .option('-l, --level', '显示风险等级')
-  .option('--list', '列出所有黑名单规则')
-  .option('--json', 'JSON 格式输出')
-  .option('--strict', '严格模式（warn 也阻止）')
-  .action(async (cmdArg, options) => {
-    await cmd('executeCommand')(cmdArg, options);
-  });
-
-// ========================================
-// harness sync-docs
-// ========================================
-program
-  .command('sync-docs')
-  .description('同步项目文档（CAPABILITIES.md、CONTEXT.md、AGENTS.md）')
-  .option('-p, --project-path <path>', '项目路径')
-  .option('-c, --check', '只检查不修改（CI 模式）', false)
-  .option('--json', '输出 JSON 格式（供 LLM 消费）', false)
-  .option('--agents', '同步 AGENTS.md（agent 导读；PRESERVE 标记段重新生成时保留）', false)
-  .option('--compact', '一次性迁移：将 CAPABILITIES.md 文件表格折叠为目录条目', false)
-  .action(async (options) => {
-    const ok = await cmd('syncDocs')(options);
-    if (!ok && options.check) {
-      process.exit(1);
-    }
-  });
-
-// ========================================
-// harness knowledge
-// ========================================
-program
-  .command('knowledge [subcommand] [arg]')
-  .description('知识库管理（list/search/import/decay/stats/audit）')
-  .alias('kb')
-  .option('-p, --project-path <path>', '项目路径')
-  .option('--type <types>', '按类型过滤（逗号分隔）')
-  .option('--maturity <levels>', '按成熟度过滤（逗号分隔）')
-  .option('--tag <tags>', '按标签过滤（逗号分隔）')
-  .option('--sources <sources>', '导入源（逗号分隔: code,git,docs）')
-  .option('--limit <n>', '结果数量限制', '20')
-  .option('--reset', '重置导入状态', false)
-  .option('--scope <scope>', '知识范围（用于 upsert 去重）')
-  .option('--title <title>', '知识标题（用于 upsert）')
-  .option('--content <content>', '知识内容 Markdown（用于 upsert）')
-  .option('--file <path>', '从文件读取内容（用于 upsert）')
-  .option('--source <source>', '知识来源 (analyst/cli/design)', 'cli')
-  .option('--fix', '自动修复（用于 audit）', false)
-  .option('--dry-run', '只输出报告不修改（用于 audit）', false)
-  .option('--threshold <n>', '短内容阈值（字符数，用于 audit）', '50')
-  .option('--dir <path>', '知识库目录（覆盖默认路径）')
-  .option('--json', 'JSON 格式输出', false)
-  .action(async (subcommand, arg, options) => {
-    const opts = { projectPath: options.projectPath, json: options.json };
-    switch (subcommand) {
-      case 'list':
-      case 'ls':
-        await cmd('knowledgeList')({ ...opts, type: options.type, maturity: options.maturity, tag: options.tag });
-        break;
-      case 'search':
-      case 's':
-        if (!arg) { console.error('请提供搜索关键词'); process.exit(1); }
-        await cmd('knowledgeSearch')(arg, { ...opts, limit: parseInt(options.limit, 10) });
-        break;
-      case 'import':
-      case 'i':
-        await cmd('knowledgeImport')({ ...opts, sources: options.sources, reset: options.reset });
-        break;
-      case 'decay':
-      case 'd':
-        await cmd('knowledgeDecay')(opts);
-        break;
-      case 'stats':
-      case 'st':
-        await cmd('knowledgeStats')(opts);
-        break;
-      case 'sync-rag':
-        await cmd('knowledgeSyncRag')(opts);
-        break;
-      case 'sync-status':
-      case 'sync':
-        await cmd('knowledgeSyncStatus')(opts);
-        break;
-      case 'upsert':
-      case 'up':
-        await cmd('knowledgeUpsert')({
-          scope: options.scope || '',
-          title: options.title || '',
-          content: options.content || '',
-          file: options.file || '',
-          type: options.type || 'architecture',
-          source: options.source || 'cli',
-        });
-        break;
-      case 'audit':
-      case 'a':
-        await cmd('knowledgeAudit')({
-          ...opts,
-          fix: options.fix,
-          dryRun: options.dryRun,
-          threshold: options.threshold,
-          dir: options.dir,
-        });
-        break;
-      case 'snapshot':
-        cmd('knowledgeSnapshot')({ ...opts, dir: options.dir });
-        break;
-      case 'migrate':
-        cmd('knowledgeMigrate')({ ...opts, dir: options.dir });
-        break;
-      case 'index':
-      case 'idx':
-        cmd('knowledgeIndex')({ ...opts, dir: options.dir });
-        break;
-      case 'health':
-      case 'h':
-        await cmd('knowledgeHealth')({ ...opts, dir: options.dir });
-        break;
-      default:
-        // 无子命令时显示帮助
-        if (!subcommand) {
-          program.commands.find(c => c.name() === 'knowledge').help();
-        } else {
-          console.error(`未知子命令: ${subcommand}`);
-          process.exit(1);
-        }
-    }
-  });
-
-// ========================================
-// harness sdd
-// ========================================
-program
-  .command('sdd [subcommand]')
-  .description('SDD 管理（index）')
-  .option('-p, --project-path <path>', '项目路径')
-  .option('--dir <dir>', '指定基础目录')
-  .option('--json', 'JSON 输出')
-  .action(async (subcommand, options) => {
-    const opts = { projectPath: options.projectPath, json: options.json };
-    switch (subcommand) {
-      case 'index':
-      case 'idx':
-        cmd('sddIndex')({ ...opts, dir: options.dir });
-        break;
-      default:
-        if (!subcommand) {
-          program.commands.find(c => c.name() === 'sdd').help();
-        } else {
-          console.error(`未知子命令: ${subcommand}`);
-          process.exit(1);
-        }
-    }
-  });
-
-// ========================================
-// harness failure
-// ========================================
-program
-  .command('failure [subcommand]')
-  .description('失败记录管理（list/stats/clear）')
-  .option('-p, --project-path <path>', '项目路径')
-  .option('--type <type>', '按错误类型过滤')
-  .option('--level <level>', '按失败等级过滤 (L1/L2/L3/L4)')
-  .option('--limit <n>', '结果数量限制', '20')
-  .option('--json', 'JSON 格式输出', false)
-  .action(async (subcommand, options) => {
-    const opts = { projectPath: options.projectPath, json: options.json };
-    switch (subcommand) {
-      case 'list':
-      case 'ls':
-        await cmd('failureList')({ ...opts, limit: parseInt(options.limit, 10), type: options.type, level: options.level });
-        break;
-      case 'stats':
-      case 'st':
-        await cmd('failureStats')(opts);
-        break;
-      case 'clear':
-        await cmd('failureClear')(opts);
-        break;
-      default:
-        if (!subcommand) {
-          program.commands.find(c => c.name() === 'failure').help();
-        } else {
-          console.error(`未知子命令: ${subcommand}`);
-          process.exit(1);
-        }
+      await callImpl(cli.action, cli.mapActionArgs(realArg, realOptions));
     }
   });
-
-// ========================================
-// harness posteval-plan
-// ========================================
-program
-  .command('posteval-plan <planPath>')
-  .description('验证 plan 文件的 checklist items 是否都有对应的 staged diff')
-  .action(async (planPath) => {
-    await cmd('postevalPlan')({ planPath });
-  });
-
-// ========================================
-// harness update-user-model
-// ========================================
-program
-  .command('update-user-model')
-  .description('从新对话中提取信号，更新用户思维模型（增量演化）')
-  .alias('uum')
-  .option('--json', 'JSON 格式输出', false)
-  .option('--dry-run', '只显示变化，不更新状态', false)
-  .option('--days <n>', '只处理最近 N 天的会话（自然日，含今天）')
-  .action(async (options) => {
-    await cmd('updateUserModel')({
-      days: options.days !== undefined ? parseInt(options.days, 10) : undefined,
-      json: options.json,
-      dryRun: options.dryRun,
-    });
-  });
-
-// ========================================
-// harness release
-// ========================================
-program
-  .command('release')
-  .description('npm 发布流水线：tsc → dist 验证 → npm version → git push → npm publish → gh release。不依赖 Studio API。')
-  .option('--bump <type>', '版本递增类型', 'patch')
-  .option('--dry-run <bool>', '仅模拟执行', 'false')
-  .action(async (options) => {
-    await cmd('release')({ bumpType: options.bump, dryRun: options.dryRun });
-  });
-
-// ========================================
-// harness analyze-sessions
-// ========================================
-program
-  .command('analyze-sessions')
-  .description('分析 Claude Code 对话，挖掘纠正模式和高频概念，生成规则候选')
-  .alias('analyze')
-  .option('-d, --days <n>', '分析最近 N 天的会话', '7')
-  .option('--json', 'JSON 格式输出', false)
-  .action(async (options) => {
-    await cmd('analyzeSessions')({
-      days: parseInt(options.days, 10),
-      json: options.json,
-    });
-  });
-
-// ========================================
-// harness constraints
-// ========================================
-const constraintsCmd = program
-  .command('constraints')
-  .description('输出约束集合元数据（版本、hash、计数、文本大小）')
-  .option('--json', '输出 JSON 格式', false)
-  .action(async (options) => {
-    await cmd('constraints')(options);
-  });
-
-constraintsCmd
-  .command('report')
-  .description('约束使用报告：check 层统计表、退役候选诊断、prompt 注入清单、配置健康（只读）')
-  .option('-p, --project-path <path>', '项目路径')
-  .option('--export [file]', '导出脱敏 markdown 摘要（缺省 .harness/reports/constraints-<YYYYMMDD>.md）')
-  .option('--json', '输出 JSON 格式', false)
-  .option('--zero-intercept-min <n>', '零拦截候选的最小评估样本数', '50')
-  .option('--noise-fail-rate <rate>', '高噪候选 fail 率阈值', '0.8')
-  .option('--noise-min-total <n>', '高噪候选最小评估样本数', '20')
-  .action(async (options) => {
-    await cmd('constraintsReport')({
-      projectPath: options.projectPath,
-      export: options.export,
-      json: options.json,
-      zeroInterceptMin: parseInt(options.zeroInterceptMin, 10),
-      noiseFailRate: parseFloat(options.noiseFailRate),
-      noiseMinTotal: parseInt(options.noiseMinTotal, 10),
-    });
-  });
-
-constraintsCmd
-  .command('retire [id]')
-  .description('退役约束：无 id 进入交互式候选选择（人确认）；带 id 直达退役需显式 --yes（写 config.yml + KnowledgeStore + 同步 CLAUDE.md 注入段）')
-  .option('-p, --project-path <path>', '项目路径')
-  .option('--reason <text>', '退役原因')
-  .option('-y, --yes', '显式确认直达退役（人确认闸门；无此 flag 直达报错并提示改走交互模式）', false)
-  .action(async (id, options) => {
-    await cmd('constraintsRetire')(id, {
-      projectPath: options.projectPath,
-      reason: options.reason,
-      yes: options.yes,
-    });
-  });
-
-// ========================================
-// harness doc-freshness-check
-// ========================================
-program
-  .command('doc-freshness-check <docPath>')
-  .description('检查文档声明的新鲜度：提取可验证声明，与代码对照')
-  .option('--changed-files <list>', '变更文件列表（逗号分隔）')
-  .option('--format <format>', '输出格式 (table/json)', 'table')
-  .option('-p, --project-path <path>', '项目路径')
-  .action(async (docPath, options) => {
-    await cmd('docFreshnessCheck')(docPath, {
-      changedFiles: options.changedFiles,
-      format: options.format,
-      projectPath: options.projectPath,
-    });
-  });
-
-// ========================================
-// harness spec-baseline-check
-// ========================================
-program
-  .command('spec-baseline-check <specPath>')
-  .description('验证 spec 文件的前置条件是否满足')
-  .option('-p, --project-path <path>', '项目路径')
-  .option('--json', '输出 JSON 格式', false)
-  .action(async (specPath, options) => {
-    await cmd('specBaselineCheck')(specPath, {
-      projectPath: options.projectPath,
-      json: options.json,
-    });
-  });
+}
 
 // 解析命令行参数
 program.parse();