From 38c6fe6ae2ce0d59a06d4e4cc320d1af7eacbeef Mon Sep 17 00:00:00 2001 From: ssw Date: Thu, 16 Jul 2026 21:37:39 +0800 Subject: [PATCH] fix(dacli): preserve _aiMeta for behavioral compat + update module docs --- src/core/help.ts | 19 +++---------------- 1 file changed, 3 insertions(+), 16 deletions(-) diff --git a/src/core/help.ts b/src/core/help.ts index 5f78b5a..504fff3 100644 --- a/src/core/help.ts +++ b/src/core/help.ts @@ -117,24 +117,11 @@ export function renderDacliHelp(help: DacliHelp): string { const AI_FLAGS = new Set(['--ai-help', '--example', '--source']) -/** - * 把 DacliHelp 注入 Commander 命令的 --help 输出. - * 替换旧的 installAiHelpHook, 单 flag --help 包含所有信息. - * - * - `purpose` 走 Commander 的 `.description()`, 出现在 Usage 之后 Options 之前 - * (Commander `helpInformation()` 内置可见) - * - 其他字段 (example/source/pitfalls/bestPractices/decisionTree/relatedRefs/notes) - * 走 `addHelpText('after', ...)`, 出现在 Options 之后 - * (Commander `helpInformation()` 不内置, 仅 `outputHelp()` / `--help` 实际输出可见) - */ -export function installHelpHook(command: Command, help: DacliHelp): void { - command.description(help.purpose) - command.addHelpText('after', renderDacliHelp(help)) +/** 把元数据挂到 command 上, cli.ts 顶层会读 */ +export function installAiHelpHook(cmd: Command, meta: DacliHelp): void { + ;(cmd as unknown as { _aiMeta?: DacliHelp })._aiMeta = meta } -/** Backward-compat alias during migration */ -export const installAiHelpHook = installHelpHook - function getMeta(cmd: Command): DacliHelp | undefined { return (cmd as unknown as { _aiMeta?: DacliHelp })._aiMeta }