svharness 0.8.0 → 0.13.2

package/dist/commands/references-apply-skills.js

@@ -0,0 +1,47 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runReferencesApplySkills = runReferencesApplySkills;
+const node_path_1 = __importDefault(require("node:path"));
+const prompts_1 = __importDefault(require("prompts"));
+const logger_1 = require("../utils/logger");
+const reference_apply_skills_1 = require("../core/reference-apply-skills");
+async function runReferencesApplySkills(opts) {
+    (0, logger_1.setVerbose)(!!opts.verbose);
+    const cwd = opts.cwd ?? process.cwd();
+    const harnessRoot = node_path_1.default.resolve(cwd, opts.harness);
+    logger_1.logger.configBox('references → apply skills', [
+        { label: 'harness', value: harnessRoot },
+        { label: 'force', value: opts.force ? 'yes' : 'no' },
+    ]);
+    if (!opts.yes) {
+        const { ok } = await (0, prompts_1.default)({
+            type: 'confirm',
+            name: 'ok',
+            message: '根据 references/yaml/index.yaml 生成 harness-apply-skills-* 并写入 registry？',
+            initial: true,
+        });
+        if (!ok) {
+            logger_1.logger.warn('用户取消');
+            return;
+        }
+    }
+    const result = await (0, reference_apply_skills_1.materializeReferenceApplySkills)(harnessRoot, {
+        force: opts.force,
+    });
+    logger_1.logger.success(`registry: ${node_path_1.default.relative(harnessRoot, result.registryPath)}`);
+    if (result.created.length > 0) {
+        logger_1.logger.success(`新建 skill: ${result.created.join(', ')}`);
+    }
+    if (result.updated.length > 0) {
+        logger_1.logger.success(`更新 skill: ${result.updated.join(', ')}`);
+    }
+    if (result.skipped.length > 0) {
+        logger_1.logger.warn(`跳过（已存在，未使用 --force）: ${result.skipped.join(', ')}`);
+    }
+    logger_1.logger.plain('');
+    logger_1.logger.plain('下一步：svharness apply --harness <path> --target <project> --yes');
+    logger_1.logger.plain('  apply 会把 registry 中的 skill 注入目标 Agent，并注册到 harness-apply-skills-main');
+}

package/dist/commands/wizard.js

@@ -0,0 +1,442 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runWizard = runWizard;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const prompts_1 = __importDefault(require("prompts"));
+const validate_args_1 = require("../utils/validate-args");
+const harness_name_1 = require("../utils/harness-name");
+const logger_1 = require("../utils/logger");
+const save_config_1 = require("../config/save-config");
+const init_1 = require("./init");
+const apply_1 = require("./apply");
+const convert_1 = require("./convert");
+const DEFAULT_ARCH = 'android-compose';
+const DEFAULT_AGENT = 'codechat';
+function validateExistingPath(cwd, raw) {
+    const value = raw.trim();
+    if (!value)
+        return '路径不能为空';
+    const abs = node_path_1.default.resolve(cwd, value);
+    if (!node_fs_1.default.existsSync(abs))
+        return `路径不存在: ${abs}`;
+    const stat = node_fs_1.default.statSync(abs);
+    if (!stat.isFile() && !stat.isDirectory()) {
+        return `路径必须是文件或目录: ${abs}`;
+    }
+    return true;
+}
+async function askTarget() {
+    const { target } = await (0, prompts_1.default)({
+        type: 'select',
+        name: 'target',
+        message: '选择要配置/执行的命令',
+        choices: [
+            { title: 'build — 创建 harness 骨架', value: 'build' },
+            { title: 'apply — 绑定 harness 到目标项目', value: 'apply' },
+            { title: 'convert — 文档转 Markdown', value: 'convert' },
+        ],
+    });
+    return target ?? null;
+}
+async function askFinishAction() {
+    const { action } = await (0, prompts_1.default)({
+        type: 'select',
+        name: 'action',
+        message: '下一步',
+        choices: [
+            { title: '立即执行', value: 'run' },
+            { title: '仅保存到 svharness.config.yaml', value: 'save' },
+            { title: '保存并执行', value: 'both' },
+        ],
+    });
+    return action ?? null;
+}
+async function runBuildWizard(cwd) {
+    const arches = [...(0, validate_args_1.listSupportedArches)()];
+    const agents = [...(0, validate_args_1.listSupportedAgents)()];
+    const answers = await (0, prompts_1.default)([
+        {
+            type: 'text',
+            name: 'harnessName',
+            message: 'harness 名称（如 my-app，将生成 .my-app-harness/）',
+            validate: (v) => /^[a-z][a-z0-9-]{1,39}$/.test((0, harness_name_1.harnessNameCore)(v)) || '名称格式无效',
+        },
+        {
+            type: 'select',
+            name: 'arch',
+            message: '架构模板',
+            choices: arches.map((a) => ({ title: a, value: a })),
+            initial: arches.indexOf(DEFAULT_ARCH),
+        },
+        {
+            type: 'select',
+            name: 'agent',
+            message: '目标 Agent',
+            choices: agents.map((a) => ({ title: a, value: a })),
+            initial: agents.indexOf(DEFAULT_AGENT),
+        },
+        {
+            type: 'confirm',
+            name: 'useBaseline',
+            message: '是否使用 baseline 源码？',
+            initial: false,
+        },
+        {
+            type: (_prev, values) => values.useBaseline ? 'text' : null,
+            name: 'baseline',
+            message: 'baseline 路径或 Git URL',
+            validate: (v) => {
+                const value = v.trim();
+                if (!value)
+                    return '请输入 baseline 路径或 Git URL';
+                if ((0, validate_args_1.detectBaselineMode)(value) === 'local') {
+                    return validateExistingPath(cwd, value);
+                }
+                return true;
+            },
+        },
+        {
+            type: (_prev, values) => values.useBaseline &&
+                typeof values.baseline === 'string' &&
+                values.baseline.trim() &&
+                (0, validate_args_1.detectBaselineMode)(values.baseline) === 'git'
+                ? 'text'
+                : null,
+            name: 'baselineBranch',
+            message: 'Git 分支（可选，默认 main）',
+            initial: 'main',
+        },
+        {
+            type: 'confirm',
+            name: 'useRequirements',
+            message: '是否导入需求文档？',
+            initial: false,
+        },
+        {
+            type: (_prev, values) => values.useRequirements ? 'text' : null,
+            name: 'requirements',
+            message: '需求文档路径（文件/目录）',
+            validate: (v) => validateExistingPath(cwd, v),
+        },
+        {
+            type: (_prev, values) => values.useRequirements ? 'text' : null,
+            name: 'requirementsNote',
+            message: '需求说明（可选，写入配置文件供团队阅读）',
+        },
+        {
+            type: 'confirm',
+            name: 'useReferences',
+            message: '是否导入参考资料？',
+            initial: false,
+        },
+        {
+            type: (_prev, values) => values.useReferences ? 'text' : null,
+            name: 'references',
+            message: '参考资料路径（文件/目录）',
+            validate: (v) => validateExistingPath(cwd, v),
+        },
+        {
+            type: (_prev, values) => values.useReferences ? 'text' : null,
+            name: 'referencesNote',
+            message: '参考资料说明（可选）',
+        },
+        {
+            type: 'confirm',
+            name: 'useExtraSkills',
+            message: '是否导入额外 skills/rules？',
+            initial: false,
+        },
+        {
+            type: (_prev, values) => values.useExtraSkills ? 'text' : null,
+            name: 'extraSkillsRaw',
+            message: '额外资源路径（多个用逗号分隔）',
+        },
+        {
+            type: (_prev, values) => values.useExtraSkills ? 'text' : null,
+            name: 'extraSkillsNote',
+            message: '额外资源说明（可选）',
+        },
+        {
+            type: (_prev, values) => values.useBaseline ? 'select' : null,
+            name: 'wikiMode',
+            message: 'Wiki 生成模式',
+            choices: [
+                { title: '禁用', value: 'off' },
+                { title: '仅任务清单（默认，有 baseline 时）', value: 'tasks' },
+                { title: '完整生成', value: 'full' },
+            ],
+            initial: 1,
+        },
+        {
+            type: 'confirm',
+            name: 'force',
+            message: '覆盖已存在的 harness 目录？',
+            initial: false,
+        },
+        {
+            type: 'confirm',
+            name: 'yes',
+            message: '跳过最终确认提示？',
+            initial: true,
+        },
+    ]);
+    if (!answers.harnessName) {
+        logger_1.logger.warn('用户取消');
+        return;
+    }
+    const buildSection = {
+        harnessName: (0, harness_name_1.normalizeHarnessName)(String(answers.harnessName).trim()),
+        arch: answers.arch,
+        agent: answers.agent,
+        force: !!answers.force,
+        yes: !!answers.yes,
+    };
+    if (answers.useBaseline && answers.baseline) {
+        buildSection.baseline = String(answers.baseline).trim();
+        if (answers.baselineBranch) {
+            buildSection.baselineBranch = String(answers.baselineBranch).trim();
+        }
+    }
+    if (answers.useRequirements && answers.requirements) {
+        buildSection.requirements = String(answers.requirements).trim();
+        if (answers.requirementsNote) {
+            buildSection.requirementsNote = String(answers.requirementsNote).trim();
+        }
+    }
+    if (answers.useReferences && answers.references) {
+        buildSection.references = String(answers.references).trim();
+        if (answers.referencesNote) {
+            buildSection.referencesNote = String(answers.referencesNote).trim();
+        }
+    }
+    if (answers.useExtraSkills && answers.extraSkillsRaw) {
+        buildSection.extraSkills = String(answers.extraSkillsRaw)
+            .split(',')
+            .map((s) => s.trim())
+            .filter(Boolean);
+        if (answers.extraSkillsNote) {
+            buildSection.extraSkillsNote = String(answers.extraSkillsNote).trim();
+        }
+    }
+    if (answers.wikiMode === 'full') {
+        buildSection.generateWiki = true;
+    }
+    else if (answers.wikiMode === 'tasks') {
+        buildSection.wikiTasksOnly = true;
+    }
+    const finish = await askFinishAction();
+    if (!finish) {
+        logger_1.logger.warn('用户取消');
+        return;
+    }
+    if (finish === 'save' || finish === 'both') {
+        const out = await (0, save_config_1.saveConfigSection)({ cwd, build: buildSection });
+        logger_1.logger.success(`配置已保存：${out}`);
+    }
+    if (finish === 'run' || finish === 'both') {
+        await (0, init_1.runInit)({
+            name: buildSection.harnessName,
+            arch: (buildSection.arch ?? DEFAULT_ARCH),
+            agent: (buildSection.agent ?? DEFAULT_AGENT),
+            baseline: buildSection.baseline,
+            requirements: buildSection.requirements,
+            references: buildSection.references,
+            extraSkills: buildSection.extraSkills,
+            baselineBranch: buildSection.baselineBranch,
+            force: buildSection.force,
+            yes: buildSection.yes,
+            generateWiki: buildSection.generateWiki,
+            wikiTasksOnly: buildSection.wikiTasksOnly,
+            cwd,
+        });
+    }
+}
+async function runApplyWizard(cwd) {
+    const agents = [...(0, validate_args_1.listSupportedAgents)()];
+    const answers = await (0, prompts_1.default)([
+        {
+            type: 'text',
+            name: 'harness',
+            message: '已构建的 harness 目录路径',
+            initial: './my-app-harness',
+            validate: (v) => (v.trim() ? true : '路径不能为空'),
+        },
+        {
+            type: 'text',
+            name: 'target',
+            message: '目标项目根目录',
+            initial: '.',
+        },
+        {
+            type: 'select',
+            name: 'agent',
+            message: '目标 Agent（可选，回车使用 harness 状态文件）',
+            choices: [
+                { title: '（从 .harness-build-state.yaml 读取）', value: '' },
+                ...agents.map((a) => ({ title: a, value: a })),
+            ],
+        },
+        {
+            type: 'confirm',
+            name: 'clone',
+            message: '克隆整个 harness 到目标项目？',
+            initial: false,
+        },
+        {
+            type: 'confirm',
+            name: 'force',
+            message: '覆盖已存在的 dispatcher skill？',
+            initial: false,
+        },
+        {
+            type: 'confirm',
+            name: 'yes',
+            message: '跳过最终确认？',
+            initial: true,
+        },
+    ]);
+    if (!answers.harness) {
+        logger_1.logger.warn('用户取消');
+        return;
+    }
+    const applySection = {
+        harness: node_path_1.default.resolve(cwd, String(answers.harness).trim()),
+        target: node_path_1.default.resolve(cwd, String(answers.target || '.').trim()),
+        clone: !!answers.clone,
+        force: !!answers.force,
+        yes: !!answers.yes,
+    };
+    const agentVal = String(answers.agent ?? '').trim();
+    if (agentVal && (0, validate_args_1.listSupportedAgents)().includes(agentVal)) {
+        applySection.agent = agentVal;
+    }
+    const finish = await askFinishAction();
+    if (!finish) {
+        logger_1.logger.warn('用户取消');
+        return;
+    }
+    if (finish === 'save' || finish === 'both') {
+        const out = await (0, save_config_1.saveConfigSection)({ cwd, apply: applySection });
+        logger_1.logger.success(`配置已保存：${out}`);
+    }
+    if (finish === 'run' || finish === 'both') {
+        await (0, apply_1.runApply)({
+            harness: applySection.harness,
+            target: applySection.target,
+            agent: applySection.agent,
+            clone: applySection.clone,
+            force: applySection.force,
+            yes: applySection.yes,
+            cwd,
+        });
+    }
+}
+async function runConvertWizard(cwd) {
+    const answers = await (0, prompts_1.default)([
+        {
+            type: 'text',
+            name: 'inputRaw',
+            message: '源文件/目录/glob（多个用逗号分隔）',
+            initial: '.',
+        },
+        {
+            type: 'text',
+            name: 'output',
+            message: '输出目录（独立模式=最终 md 目录；harness 模式=含 harness.yaml 的根目录，默认当前目录）',
+            initial: '.',
+        },
+        {
+            type: 'select',
+            name: 'type',
+            message: '转换目标类型',
+            choices: [
+                { title: 'requirements', value: 'requirements' },
+                { title: 'references', value: 'references' },
+            ],
+        },
+        {
+            type: 'text',
+            name: 'endpoint',
+            message: 'markitdown 服务地址（可选）',
+            initial: '',
+        },
+        {
+            type: 'confirm',
+            name: 'force',
+            message: '覆盖已存在同名 .md？',
+            initial: false,
+        },
+        {
+            type: 'confirm',
+            name: 'yes',
+            message: '跳过上传前确认？',
+            initial: true,
+        },
+    ]);
+    if (answers.inputRaw === undefined) {
+        logger_1.logger.warn('用户取消');
+        return;
+    }
+    const convertSection = {
+        input: String(answers.inputRaw)
+            .split(',')
+            .map((s) => s.trim())
+            .filter(Boolean),
+        output: node_path_1.default.resolve(cwd, String(answers.output || '.').trim()),
+        type: answers.type ?? 'requirements',
+        force: !!answers.force,
+        yes: !!answers.yes,
+    };
+    if (answers.endpoint) {
+        convertSection.endpoint = String(answers.endpoint).trim();
+    }
+    const finish = await askFinishAction();
+    if (!finish) {
+        logger_1.logger.warn('用户取消');
+        return;
+    }
+    if (finish === 'save' || finish === 'both') {
+        const out = await (0, save_config_1.saveConfigSection)({ cwd, convert: convertSection });
+        logger_1.logger.success(`配置已保存：${out}`);
+    }
+    if (finish === 'run' || finish === 'both') {
+        await (0, convert_1.runConvert)({
+            input: convertSection.input ?? [],
+            output: convertSection.output,
+            endpoint: convertSection.endpoint,
+            type: convertSection.type,
+            force: convertSection.force,
+            yes: convertSection.yes,
+            cwd,
+        });
+    }
+}
+/**
+ * Interactive TUI wizard for build / apply / convert.
+ */
+async function runWizard(opts = {}) {
+    const cwd = opts.cwd ?? process.cwd();
+    logger_1.logger.plain('');
+    logger_1.logger.plain('svharness wizard — 分步配置（路径 + 说明均可填写）');
+    logger_1.logger.plain('');
+    const target = await askTarget();
+    if (!target) {
+        logger_1.logger.warn('用户取消');
+        return;
+    }
+    switch (target) {
+        case 'build':
+            await runBuildWizard(cwd);
+            break;
+        case 'apply':
+            await runApplyWizard(cwd);
+            break;
+        case 'convert':
+            await runConvertWizard(cwd);
+            break;
+    }
+}

package/dist/config/constants.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CONFIG_SCHEMA_VERSION = exports.DEFAULT_CONFIG_FILENAME = void 0;
+/** Default config filename searched in cwd when --config is omitted. */
+exports.DEFAULT_CONFIG_FILENAME = 'svharness.config.yaml';
+/** Supported config file schema version. */
+exports.CONFIG_SCHEMA_VERSION = 1;

package/dist/config/index.js

@@ -0,0 +1,18 @@
+"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;
+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; } });
+var load_config_1 = require("./load-config");
+Object.defineProperty(exports, "loadConfig", { enumerable: true, get: function () { return load_config_1.loadConfig; } });
+Object.defineProperty(exports, "resolveConfigPath", { enumerable: true, get: function () { return load_config_1.resolveConfigPath; } });
+var normalize_1 = require("./normalize");
+Object.defineProperty(exports, "normalizeConfig", { enumerable: true, get: function () { return normalize_1.normalizeConfig; } });
+Object.defineProperty(exports, "resolveConfigHarnessName", { enumerable: true, get: function () { return normalize_1.resolveConfigHarnessName; } });
+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; } });
+var save_config_1 = require("./save-config");
+Object.defineProperty(exports, "saveConfigSection", { enumerable: true, get: function () { return save_config_1.saveConfigSection; } });

package/dist/config/load-config.js

@@ -0,0 +1,54 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveConfigPath = resolveConfigPath;
+exports.loadConfig = loadConfig;
+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 constants_1 = require("./constants");
+const normalize_1 = require("./normalize");
+function parseConfigFile(absPath) {
+    const rawText = fs_extra_1.default.readFileSync(absPath, 'utf8');
+    const ext = node_path_1.default.extname(absPath).toLowerCase();
+    let parsed;
+    if (ext === '.json') {
+        parsed = JSON.parse(rawText);
+    }
+    else {
+        parsed = js_yaml_1.default.load(rawText);
+    }
+    return (0, normalize_1.normalizeConfig)(parsed, absPath);
+}
+/**
+ * Resolve config file path: explicit --config, else cwd/svharness.config.yaml if present.
+ */
+function resolveConfigPath(explicit, cwd = process.cwd()) {
+    if (explicit) {
+        const abs = node_path_1.default.isAbsolute(explicit) ? explicit : node_path_1.default.resolve(cwd, explicit);
+        if (!fs_extra_1.default.existsSync(abs)) {
+            throw new Error(`配置文件不存在: ${abs}`);
+        }
+        return abs;
+    }
+    const candidate = node_path_1.default.join(cwd, constants_1.DEFAULT_CONFIG_FILENAME);
+    if (fs_extra_1.default.existsSync(candidate))
+        return candidate;
+    return undefined;
+}
+/**
+ * Load config from disk. Returns undefined when no file is found (and explicit not required).
+ */
+function loadConfig(options) {
+    const cwd = options.cwd ?? process.cwd();
+    const resolved = resolveConfigPath(options.configPath, cwd);
+    if (!resolved) {
+        if (options.required) {
+            throw new Error(`未找到配置文件。请传入 --config <path> 或在当前目录创建 ${constants_1.DEFAULT_CONFIG_FILENAME}`);
+        }
+        return undefined;
+    }
+    return { config: parseConfigFile(resolved), path: resolved };
+}

package/dist/config/merge-options.js

@@ -0,0 +1,115 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mergeBuildOptions = mergeBuildOptions;
+exports.mergeApplyOptions = mergeApplyOptions;
+exports.mergeConvertOptions = mergeConvertOptions;
+const normalize_1 = require("./normalize");
+function getSource(cmd, key) {
+    if (!cmd)
+        return undefined;
+    try {
+        return cmd.getOptionValueSource(key);
+    }
+    catch {
+        return undefined;
+    }
+}
+function isCliSource(cmd, key) {
+    return getSource(cmd, key) === 'cli';
+}
+function pickString(key, cliValue, configValue, cmd) {
+    if (isCliSource(cmd, key) && cliValue !== undefined)
+        return cliValue;
+    if (configValue !== undefined)
+        return configValue;
+    return cliValue;
+}
+function pickNumber(key, cliValue, configValue, cmd) {
+    if (isCliSource(cmd, key) && cliValue !== undefined)
+        return cliValue;
+    if (configValue !== undefined)
+        return configValue;
+    return cliValue;
+}
+function pickStringArray(key, cliValue, configValue, cmd) {
+    if (isCliSource(cmd, key) && cliValue !== undefined)
+        return cliValue;
+    if (configValue !== undefined)
+        return configValue;
+    return cliValue;
+}
+function pickBool(key, cliValue, configValue, defaultValue, cmd) {
+    if (isCliSource(cmd, key))
+        return !!cliValue;
+    if (configValue !== undefined)
+        return configValue;
+    if (defaultValue !== undefined)
+        return defaultValue;
+    return cliValue;
+}
+function mergeSection(section, defaults) {
+    if (!defaults)
+        return (section ?? {});
+    return { ...defaults, ...section };
+}
+function mergeBuildOptions(cli, configSection, defaults, cmd) {
+    const cfg = mergeSection(configSection, defaults);
+    const harnessFromConfig = (0, normalize_1.resolveConfigHarnessName)(cfg);
+    const harnessNameCli = pickString('harnessName', cli.harnessName, undefined, cmd);
+    const nameCli = pickString('name', cli.name, undefined, cmd);
+    return {
+        harnessName: harnessNameCli ?? harnessFromConfig,
+        name: nameCli ?? cfg.name,
+        arch: pickString('arch', cli.arch, cfg.arch, cmd),
+        agent: pickString('agent', cli.agent, cfg.agent, cmd),
+        baseline: pickString('baseline', cli.baseline, cfg.baseline, cmd),
+        requirements: pickString('requirements', cli.requirements, cfg.requirements, cmd),
+        references: pickString('references', cli.references, cfg.references, cmd),
+        extraSkills: pickStringArray('extraSkills', cli.extraSkills, cfg.extraSkills, cmd),
+        baselineBranch: pickString('baselineBranch', cli.baselineBranch, cfg.baselineBranch, cmd),
+        baselineMaxFileKb: pickNumber('baselineMaxFileKb', cli.baselineMaxFileKb, cfg.baselineMaxFileKb, cmd),
+        convertEndpoint: pickString('convertEndpoint', cli.convertEndpoint, cfg.convertEndpoint, cmd),
+        convertConcurrency: pickNumber('convertConcurrency', cli.convertConcurrency, cfg.convertConcurrency, cmd),
+        convertMaxFileMb: pickNumber('convertMaxFileMb', cli.convertMaxFileMb, cfg.convertMaxFileMb, cmd),
+        convertTimeoutSec: pickNumber('convertTimeoutSec', cli.convertTimeoutSec, cfg.convertTimeoutSec, cmd),
+        convertForce: pickBool('convertForce', cli.convertForce, cfg.convertForce, undefined, cmd),
+        force: pickBool('force', cli.force, cfg.force, defaults?.force, cmd),
+        yes: pickBool('yes', cli.yes, cfg.yes, defaults?.yes, cmd),
+        verbose: pickBool('verbose', cli.verbose, cfg.verbose, defaults?.verbose, cmd),
+        generateWiki: pickBool('generateWiki', cli.generateWiki, cfg.generateWiki, undefined, cmd),
+        wikiTasksOnly: pickBool('wikiTasksOnly', cli.wikiTasksOnly, cfg.wikiTasksOnly, undefined, cmd),
+        wikiLang: pickString('wikiLang', cli.wikiLang, cfg.wikiLang, cmd),
+        wikiModel: pickString('wikiModel', cli.wikiModel, cfg.wikiModel, cmd),
+        wikiBaseUrl: pickString('wikiBaseUrl', cli.wikiBaseUrl, cfg.wikiBaseUrl, cmd),
+        wikiApiKey: pickString('wikiApiKey', cli.wikiApiKey, cfg.wikiApiKey, cmd),
+        wikiSource: pickString('wikiSource', cli.wikiSource, cfg.wikiSource, cmd),
+    };
+}
+function mergeApplyOptions(cli, configSection, defaults, cmd) {
+    const cfg = mergeSection(configSection, defaults);
+    return {
+        harness: pickString('harness', cli.harness, cfg.harness, cmd),
+        target: pickString('target', cli.target, cfg.target, cmd),
+        agent: pickString('agent', cli.agent, cfg.agent, cmd),
+        force: pickBool('force', cli.force, cfg.force, defaults?.force, cmd),
+        clone: pickBool('clone', cli.clone, cfg.clone, undefined, cmd),
+        yes: pickBool('yes', cli.yes, cfg.yes, defaults?.yes, cmd),
+        verbose: pickBool('verbose', cli.verbose, cfg.verbose, defaults?.verbose, cmd),
+    };
+}
+function mergeConvertOptions(cli, configSection, defaults, cmd) {
+    const cfg = mergeSection(configSection, defaults);
+    return {
+        input: pickStringArray('input', cli.input, cfg.input, cmd),
+        harness: pickString('harness', cli.harness, cfg.harness, cmd),
+        output: pickString('output', cli.output, cfg.output, cmd),
+        endpoint: pickString('endpoint', cli.endpoint, cfg.endpoint, cmd),
+        concurrency: pickNumber('concurrency', cli.concurrency, cfg.concurrency, cmd),
+        maxFileMb: pickNumber('maxFileMb', cli.maxFileMb, cfg.maxFileMb, cmd),
+        timeoutSec: pickNumber('timeoutSec', cli.timeoutSec, cfg.timeoutSec, cmd),
+        type: pickString('type', cli.type, cfg.type, cmd),
+        force: pickBool('force', cli.force, cfg.force, defaults?.force, cmd),
+        yes: pickBool('yes', cli.yes, cfg.yes, defaults?.yes, cmd),
+        verbose: pickBool('verbose', cli.verbose, cfg.verbose, defaults?.verbose, cmd),
+    };
+}