svharness 0.11.0 → 0.13.2

package/dist/commands/convert.js

@@ -9,7 +9,7 @@ exports.runConvert = runConvert;
  *
  * Upload local source documents (pdf / docx / pptx / xlsx / html / txt / ...)
  * to a remotely-deployed `markitdown_serve` instance and persist the returned
- * Markdown under `<harness>/requirements/md/`.
+ * Markdown under `--output` (standalone) or `<harness>/<type>/md/` (harness mode).
  *
  * Design rules (aligned with the approved plan):
  *   - The CLI is a pure HTTP client. It never spawns / installs / manages the
@@ -68,6 +68,7 @@ async function runConvert(opts) {
         input: opts.input,
         harness: opts.harness,
         output: opts.output,
+        allowMissingHarnessYaml: opts.allowMissingHarnessYaml,
         endpoint: opts.endpoint,
         concurrency: opts.concurrency,
         maxFileMB: opts.maxFileMB,
@@ -75,18 +76,17 @@ async function runConvert(opts) {
         type: opts.type,
     });
     const cwd = opts.cwd ?? process.cwd();
-    const outDir = node_path_1.default.join(v.harness, v.type, 'md');
+    const outDir = v.outputDir;
     await fs_extra_1.default.ensureDir(outDir);
-    logger_1.logger.configBox('svharness convert', [
-        { label: 'harness    ', value: v.harness },
-        { label: 'endpoint   ', value: v.endpoint },
-        { label: 'type       ', value: v.type },
-        { label: 'output dir ', value: outDir },
-        { label: 'concurrency', value: String(v.concurrency) },
-        { label: 'max file   ', value: `${v.maxFileMB} MB` },
-        { label: 'timeout    ', value: `${v.timeoutSec}s` },
-        { label: 'force      ', value: opts.force ? 'yes' : 'no' },
-    ]);
+    const configRows = [
+        { label: 'mode       ', value: v.harnessMode ? 'harness' : 'standalone' },
+    ];
+    if (v.harnessMode && v.harnessRoot) {
+        configRows.push({ label: 'harness    ', value: v.harnessRoot });
+        configRows.push({ label: 'type       ', value: v.type });
+    }
+    configRows.push({ label: 'output dir ', value: outDir }, { label: 'endpoint   ', value: v.endpoint }, { label: 'concurrency', value: String(v.concurrency) }, { label: 'max file   ', value: `${v.maxFileMB} MB` }, { label: 'timeout    ', value: `${v.timeoutSec}s` }, { label: 'force      ', value: opts.force ? 'yes' : 'no' });
+    logger_1.logger.configBox('svharness convert', configRows);
     // 1. Collect candidate files.
     const candidates = await collectFiles(v.input, cwd);
     if (candidates.length === 0) {
@@ -157,9 +157,11 @@ async function runConvert(opts) {
     await Promise.all(workers);
     // 6. Summary.
     printSummary(results);
-    const relocated = await (0, doc_intake_paths_1.relocateMisplacedConvertedMd)(v.harness, v.type);
-    if (relocated > 0) {
-        logger_1.logger.warn(`已将 ${relocated} 个误落在 raw/**/converted_md/ 下的 .md 移至 ${v.type}/md/`);
+    if (v.harnessMode && v.harnessRoot) {
+        const relocated = await (0, doc_intake_paths_1.relocateMisplacedConvertedMd)(v.harnessRoot, v.type);
+        if (relocated > 0) {
+            logger_1.logger.warn(`已将 ${relocated} 个误落在 raw/**/converted_md/ 下的 .md 移至 ${v.type}/md/`);
+        }
     }
     const failed = results.filter((r) => r.status === 'failed');
     if (failed.length > 0) {

package/dist/commands/init.js

@@ -17,6 +17,8 @@ const agent_injector_1 = require("../core/agent-injector");
 const adapters_1 = require("../adapters");
 const next_steps_1 = require("../core/next-steps");
 const build_project_entry_1 = require("../core/build-project-entry");
+const project_ignore_1 = require("../core/project-ignore");
+const harness_name_1 = require("../utils/harness-name");
 const repomix_pack_1 = require("../core/repomix-pack");
 const extra_assets_intake_1 = require("../core/extra-assets-intake");
 const baseline_copy_1 = require("../utils/baseline-copy");
@@ -37,7 +39,9 @@ async function runBuildAutoConvert(targetRoot, rawDir, type, opts) {
     try {
         await (0, convert_1.runConvert)({
             input: [rawDir],
-            output: targetRoot,
+            // Explicit md dir: harness.yaml may not exist yet (convert runs before render-meta).
+            output: node_path_1.default.join(targetRoot, type, 'md'),
+            harness: targetRoot,
             type,
             endpoint: opts.convertEndpoint,
             concurrency: opts.convertConcurrency,
@@ -47,6 +51,7 @@ async function runBuildAutoConvert(targetRoot, rawDir, type, opts) {
             yes: true,
             verbose: opts.verbose,
             cwd: opts.cwd,
+            allowMissingHarnessYaml: true,
         });
         const relocated = await (0, doc_intake_paths_1.relocateMisplacedConvertedMd)(targetRoot, type);
         if (relocated > 0) {
@@ -86,7 +91,8 @@ async function runInit(opts) {
         logger_1.logger.warn('--baseline-branch 在本地基线模式下被忽略');
     }
     const cwd = opts.cwd ?? process.cwd();
-    const targetRoot = node_path_1.default.resolve(cwd, `${validated.name}-harness`);
+    const harnessDirName = (0, harness_name_1.harnessDirNameFromName)(validated.name);
+    const targetRoot = node_path_1.default.resolve(cwd, harnessDirName);
     const cliVersion = (0, version_1.getCliVersion)();
     const createdAt = new Date().toISOString();
     // Baseline code lands at <target>/baseline/code/ for both git & local
@@ -164,9 +170,9 @@ async function runInit(opts) {
                 baseUrl: opts.wikiBaseUrl,
                 model: opts.wikiModel,
             });
-            configItems.push({ label: 'Wiki 模型', value: wikiCfg.model });
+            // configItems.push({ label: 'Wiki 模型', value: wikiCfg.model });
             const displayBaseUrl = wikiCfg.baseUrl.replace(/\/v1$/, '');
-            configItems.push({ label: 'Wiki API', value: displayBaseUrl });
+            // configItems.push({ label: 'Wiki API', value: displayBaseUrl });
         }
         catch (e) {
             // Ignore config resolution errors for display
@@ -321,15 +327,37 @@ async function runInit(opts) {
     }
     {
         const adapterEntry = (0, adapters_1.getAdapter)(validated.agent);
+        const dirName = node_path_1.default.basename(targetRoot);
         await (0, build_project_entry_1.writeBuildProjectEntry)({
             projectRoot: cwd,
             adapter: adapterEntry,
-            harnessDirName: node_path_1.default.basename(targetRoot),
+            harnessDirName: dirName,
             harnessName: validated.name,
             arch: validated.arch,
             agent: validated.agent,
             force: !!opts.force,
         });
+        const ignoreEntries = [
+            `/${dirName}/`,
+            '/AGENTS.md',
+            '/CLAUDE.md',
+            '/.codechat/',
+        ];
+        const ignoreAdded = await (0, project_ignore_1.appendProjectIgnoreEntries)({
+            projectRoot: cwd,
+            entries: ignoreEntries,
+            marker: '# svharness build',
+        });
+        const totalLines = Object.values(ignoreAdded).reduce((n, a) => n + a.length, 0);
+        if (totalLines > 0) {
+            const detail = Object.entries(ignoreAdded)
+                .map(([f, lines]) => `${f}: ${lines.join(', ')}`)
+                .join('；');
+            logger_1.logger.success(`已在项目 ignore 文件中追加：${detail}`);
+        }
+        else {
+            logger_1.logger.info('项目 ignore 文件已包含 build 注入路径，未追加新行');
+        }
     }
     // 6a. Repomix XML pack of baseline code (default when --baseline; non-fatal on failure).
     if (hasBaseline) {

package/dist/commands/wizard.js

@@ -8,6 +8,7 @@ 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");
@@ -61,8 +62,8 @@ async function runBuildWizard(cwd) {
         {
             type: 'text',
             name: 'harnessName',
-            message: 'harness 名称（小写字母、数字、中划线）',
-            validate: (v) => /^[a-z][a-z0-9-]{1,39}$/.test(v.trim()) || '名称格式无效',
+            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',
@@ -188,7 +189,7 @@ async function runBuildWizard(cwd) {
         return;
     }
     const buildSection = {
-        harnessName: String(answers.harnessName).trim(),
+        harnessName: (0, harness_name_1.normalizeHarnessName)(String(answers.harnessName).trim()),
         arch: answers.arch,
         agent: answers.agent,
         force: !!answers.force,
@@ -345,7 +346,7 @@ async function runConvertWizard(cwd) {
         {
             type: 'text',
             name: 'output',
-            message: '输出基目录（harness 根，默认当前目录）',
+            message: '输出目录（独立模式=最终 md 目录；harness 模式=含 harness.yaml 的根目录，默认当前目录）',
             initial: '.',
         },
         {

package/dist/core/apply-project-entry.js

@@ -3,72 +3,52 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.renderApplyProjectEntryMarkdown = renderApplyProjectEntryMarkdown;
 exports.writeApplyProjectEntry = writeApplyProjectEntry;
 const fs_extra_1 = __importDefault(require("fs-extra"));
 const node_path_1 = __importDefault(require("node:path"));
 const logger_1 = require("../utils/logger");
-function entryHeading(projectEntryFile) {
-    if (projectEntryFile === 'CLAUDE.md') {
-        return '# CLAUDE.md';
-    }
-    return '# AGENTS.md';
+function toPosix(p) {
+    return p.replace(/\\/g, '/');
 }
-function normalizeHarnessRootRel(harnessRootRel) {
-    if (harnessRootRel === '.' || harnessRootRel === '') {
-        return './';
+function toHarnessScopedRef(raw, harnessDirName) {
+    const ref = toPosix(raw.trim());
+    if (ref.startsWith('http://') ||
+        ref.startsWith('https://') ||
+        ref.startsWith('mailto:') ||
+        ref.startsWith('#')) {
+        return raw;
     }
-    const trimmed = harnessRootRel.replace(/\\/g, '/').replace(/\/$/, '');
-    return `./${trimmed}/`.replace(/\/+/g, '/');
+    const normalized = ref.replace(/^\.\//, '');
+    const coreMatch = /^(agent-env|baseline|specs|references|tasks)\//.test(normalized) ||
+        /^(harness\.yaml|VERSION|\.harness-build-state\.yaml|AGENTS_BUILD\.md|AGENTS_APPLY\.md)$/.test(normalized);
+    if (!coreMatch)
+        return raw;
+    return `./${harnessDirName}/${normalized}`;
 }
-/**
- * Render the markdown body for the project-root AI entry file
- * (`AGENTS.md` or `CLAUDE.md`) created by `svharness apply`.
- */
-function renderApplyProjectEntryMarkdown(input) {
-    const relHarness = normalizeHarnessRootRel(input.harnessRootRel);
-    const dispatcherSkillRel = `${input.adapter.skillsDir}/harness-apply-skills-main/SKILL${input.adapter.skillExt}`.replace(/\\/g, '/');
-    const title = entryHeading(input.adapter.projectEntryFile);
-    return [
-        title,
-        '',
-        '> 本文件由 `svharness apply` 根据所选 Agent 自动生成，用于指引 AI **载入 harness 应用工作流**。',
-        '> 若内容与你的习惯冲突，可重新执行 `svharness apply --force` 覆盖本文件。',
-        '',
-        '## 1. 必读',
-        '',
-        `1. **Harness（相对目标项目）**：\`${relHarness}\``,
-        '2. **应用指南**：[`AGENTS_APPLY.md`](./AGENTS_APPLY.md)（若 apply 已注入；不存在时请先在 harness 侧完成 build）',
-        '3. **绑定元数据**：dispatcher skill 正文 `## 绑定元数据` 小节（权威来源；勿读 sidecar `references/binding.yaml`）',
-        '',
-        '## 2. harness-apply 总清单 skill（二级调度，优先入口）',
-        '',
-        '在支持 skill 的 Agent IDE 中，**优先**加载并触发：',
-        '',
-        '- **`harness-apply-skills-main`** — 从 skill 内嵌绑定元数据解析 `harness_root` → 装载 `agent-env/rules/` → 扫描 `agent-env/skills/` 与 `apply_skill_registry` → 在目标项目下交付代码。',
-        `- 磁盘路径（相对项目根）：\`${dispatcherSkillRel}\``,
-        '',
-        '## 3. 典型触发',
-        '',
-        '- 应用 harness-apply-skills-main 完成 \<功能\> 开发',
-        '- 基于 harness 做 xxx / 按 harness 规范实现 xxx / apply harness',
-        '',
-        '## 4. 元数据（供人类核对）',
-        '',
-        `- harness 名称：\`${input.harnessName}\``,
-        `- harness 版本：\`${input.harnessVersion}\``,
-        `- 绑定模式：\`${input.mode}\``,
-        `- Agent：\`${input.agent}\``,
-        '',
-    ].join('\n');
+function rewriteEntryReferences(content, harnessDirName) {
+    const withMarkdownLinks = content.replace(/\]\(([^)]+)\)/g, (_m, linkTarget) => {
+        const [pathPart, ...rest] = linkTarget.split('#');
+        const rewritten = toHarnessScopedRef(pathPart, harnessDirName);
+        if (rest.length > 0) {
+            return `](${rewritten}#${rest.join('#')})`;
+        }
+        return `](${rewritten})`;
+    });
+    return withMarkdownLinks.replace(/`([^`\n]+)`/g, (_m, token) => {
+        return `\`${toHarnessScopedRef(token, harnessDirName)}\``;
+    });
 }
 /**
- * Write `AGENTS.md` or `CLAUDE.md` at the target project root when absent,
- * or when `force` is true.
+ * Write `AGENTS.md` or `CLAUDE.md` at the target project root by copying
+ * `<harness>/AGENTS_APPLY.md` and renaming it to the adapter's entry file.
  *
  * @returns relative path written, or undefined when skipped
  */
 async function writeApplyProjectEntry(input) {
+    const src = node_path_1.default.join(input.harnessRoot, 'AGENTS_APPLY.md');
+    if (!(await fs_extra_1.default.pathExists(src))) {
+        throw new Error(`harness 中缺少 AGENTS_APPLY.md：${src}\n  请先重新执行 svharness build 生成应用指南。`);
+    }
     const fileName = input.adapter.projectEntryFile;
     const dest = node_path_1.default.join(input.projectRoot, fileName);
     const rel = fileName;
@@ -78,15 +58,9 @@ async function writeApplyProjectEntry(input) {
             return undefined;
         }
     }
-    const body = renderApplyProjectEntryMarkdown({
-        adapter: input.adapter,
-        harnessRootRel: input.harnessRootRel,
-        harnessName: input.harnessName,
-        harnessVersion: input.harnessVersion,
-        agent: input.agent,
-        mode: input.mode,
-    });
-    await fs_extra_1.default.outputFile(dest, body, 'utf8');
-    logger_1.logger.success(`已写入项目根 AI 入口：${rel}`);
+    const raw = await fs_extra_1.default.readFile(src, 'utf8');
+    const rewritten = rewriteEntryReferences(raw, input.harnessDirName);
+    await fs_extra_1.default.outputFile(dest, rewritten, 'utf8');
+    logger_1.logger.success(`已写入项目根 AI 入口：${rel}（由 AGENTS_APPLY.md 重命名）`);
     return rel;
 }

package/dist/core/project-ignore.js

@@ -0,0 +1,53 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.appendProjectIgnoreEntries = appendProjectIgnoreEntries;
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const node_path_1 = __importDefault(require("node:path"));
+const DEFAULT_IGNORE_FILENAMES = ['.gitignore', '.cursorignore'];
+/**
+ * Idempotently append ignore entries under `projectRoot`.
+ * Always writes `.gitignore` (creates if missing). Updates `.cursorignore` only when it already exists.
+ */
+async function appendProjectIgnoreEntries(input) {
+    const marker = input.marker ?? '# svharness';
+    const filenames = input.filenames ?? DEFAULT_IGNORE_FILENAMES;
+    const normalizedEntries = input.entries.map((e) => e.startsWith('/') ? e : `/${e.replace(/^\/+/, '')}`);
+    const result = {};
+    for (const filename of filenames) {
+        const filePath = node_path_1.default.join(input.projectRoot, filename);
+        const exists = await fs_extra_1.default.pathExists(filePath);
+        if (!exists && filename !== '.gitignore') {
+            continue;
+        }
+        const added = await appendToIgnoreFile(filePath, normalizedEntries, marker, !exists);
+        if (added.length > 0) {
+            result[filename] = added;
+        }
+    }
+    return result;
+}
+async function appendToIgnoreFile(filePath, entries, marker, createNew) {
+    const raw = createNew || !(await fs_extra_1.default.pathExists(filePath))
+        ? ''
+        : await fs_extra_1.default.readFile(filePath, 'utf8');
+    const existing = new Set(raw
+        .split(/\r?\n/)
+        .map((line) => line.trim())
+        .filter((line) => line.length > 0 && !line.startsWith('#')));
+    const added = [];
+    for (const entry of entries) {
+        if (!existing.has(entry)) {
+            existing.add(entry);
+            added.push(entry);
+        }
+    }
+    if (added.length === 0)
+        return [];
+    const appendix = `\n${marker}\n` + added.map((line) => `${line}\n`).join('');
+    const next = raw.endsWith('\n') || raw.length === 0 ? raw + appendix : raw + '\n' + appendix;
+    await fs_extra_1.default.outputFile(filePath, next, 'utf8');
+    return added;
+}

package/dist/index.js

@@ -4,6 +4,7 @@ const commander_1 = require("commander");
 const logger_1 = require("./utils/logger");
 const version_1 = require("./utils/version");
 const validate_args_1 = require("./utils/validate-args");
+const harness_name_1 = require("./utils/harness-name");
 const init_1 = require("./commands/init");
 const apply_1 = require("./commands/apply");
 const convert_1 = require("./commands/convert");
@@ -18,13 +19,21 @@ function resolveHarnessName(opts) {
     if (opts.harnessName && opts.name && opts.harnessName !== opts.name) {
         throw new Error('同时收到 --harness-name 与 --name 但取值不同，请只保留一个（推荐 --harness-name）');
     }
-    if (opts.harnessName)
-        return opts.harnessName;
-    if (opts.name) {
+    const raw = opts.harnessName ?? opts.name;
+    if (!raw) {
+        throw new Error('--harness-name <name> 是必填参数（可在配置文件的 build.harnessName 中提供）');
+    }
+    if (opts.name && !opts.harnessName) {
         logger_1.logger.warn('⚠️  --name 已重命名为 --harness-name，旧名将在下个 minor 版本移除。');
-        return opts.name;
     }
-    throw new Error('--harness-name <name> 是必填参数（可在配置文件的 build.harnessName 中提供）');
+    const check = (0, harness_name_1.validateHarnessNameInput)(raw);
+    if (!check.ok) {
+        throw new Error(check.message);
+    }
+    if (check.normalized !== raw.trim()) {
+        logger_1.logger.info(`harness 名称已规范为 ${check.normalized}（目录：${check.normalized}-harness）`);
+    }
+    return check.normalized;
 }
 function buildSectionFromOpts(opts, harnessName) {
     return {
@@ -105,7 +114,7 @@ function attachBuildOptions(cmd) {
     return cmd
         .option('--config <path>', `从 YAML/JSON 读取参数（默认可选 ${config_1.DEFAULT_CONFIG_FILENAME}）`)
         .option('--save-config [path]', `执行成功后把参数写入配置文件（默认 ${config_1.DEFAULT_CONFIG_FILENAME}）`)
-        .option('--harness-name <name>', '【必填】harness 名称（小写字母、数字、中连线），生成 <name>-harness/ 目录')
+        .option('--harness-name <name>', '【必填】harness 名称（如 my-app → .my-app-harness/ 目录）')
         .option('--name <name>', '【已废弃】--harness-name 的旧别名，下个 minor 版本移除')
         .option('--arch <arch>', '架构模板：' + (0, validate_args_1.listSupportedArches)().join(' | '), DEFAULT_ARCH)
         .option('--agent <agent>', '目标 Agent：' + (0, validate_args_1.listSupportedAgents)().join(' | '), DEFAULT_AGENT)
@@ -163,39 +172,26 @@ function main() {
     program.addHelpText('afterAll', [
         '',
         '┌──────────────────────────────────────────────────────────────────────────',
-        '│  📖 快速上手                                                             ',
+        '│  快速上手, 帮助：svharness <command> --help  或  svharness help <command>                                                             ',
         '├──────────────────────────────────────────────────────────────────────────',
-        '│                                                                          ',
         '│  # 方式零：交互式向导（推荐新手）                                          ',
         '│  svharness wizard                                                        ',
         '│                                                                          ',
-        '│  # 方式一：配置文件驱动                                                   ',
-        '│  svharness build --config svharness.config.yaml --yes                   ',
-        '│                                                                          ',
         '│  # 方式二：仅 --harness-name 必填                                        ',
         '│  svharness build --harness-name my-app                                   ',
         '│                                                                          ',
-        '│  # 方式三：本地基线 + wiki                                               ',
-        '│  svharness build --harness-name my-app --baseline ./src --yes            ',
+        '│  # 方式三：本地基线 + wiki + requirements + references                     ',
+        '│  svharness build --harness-name my-app --baseline ./src \ ',
+        '│  --requirements ./requirements.xlsx --references ./references.pdf      ',
         '│                                                                          ',
         '│  # 方式四：绑定 harness 到目标项目                                        ',
-        '│  svharness apply --harness ./my-app-harness --target . --yes             ',
+        '│  svharness apply --harness ./my-app-harness --target .              ',
         '│                                                                          ',
         '│  # 方式五：文档转 Markdown                                               ',
-        '│  svharness convert --input ./docs/*.pdf --yes                            ',
+        '│  svharness convert --input ./docs/*.pdf --output ./docs/md --type requirements',
         '│                                                                          ',
         '└──────────────────────────────────────────────────────────────────────────',
-        '',
-        '┌──────────────────────────────────────────────────────────────────────────',
-        '│  📋 配置与向导                                                           ',
-        '├──────────────────────────────────────────────────────────────────────────',
-        '│  --config <path>     读取 YAML/JSON（默认查找 ./svharness.config.yaml）   ',
-        '│  --save-config       build 成功后写入当前参数到配置文件                    ',
-        '│  svharness wizard    分步 TUI：路径 + 说明，可保存/执行                    ',
-        '│  优先级：CLI 参数 > 配置文件 > 代码默认值                                 ',
-        '└──────────────────────────────────────────────────────────────────────────',
-        '',
-        '  📚 完整文档：https://yesv-desaysv.feishu.cn/docx/YEIHdD4NGooMdrxQO4McqwfNnjf?pre_pathname=%2Fdrive%2Fhome%2F',
+        '  📚 使用说明文档：https://yesv-desaysv.feishu.cn/docx/OEBwdywTfoncPNxPZ0acClNincg',
         '',
     ].join('\n'));
     attachBuildOptions(program
@@ -227,7 +223,7 @@ function main() {
         .option('--config <path>', `从配置文件读取 convert 节（默认 ${config_1.DEFAULT_CONFIG_FILENAME}）`)
         .option('--input <path...>', '【可选，默认 .】源文件、目录或 glob')
         .option('--harness <path>', '【可选】目标 harness 目录')
-        .option('--output <path>', '【可选，默认 .】Markdown 输出基目录')
+        .option('--output <path>', '【可选，默认 .】Markdown 输出目录；含 harness.yaml 时写入 <output>/<type>/md/')
         .option('--endpoint <url>', 'markitdown_serve 基址')
         .option('--concurrency <n>', '【默认 3】并发上传数', (v) => Number(v))
         .option('--max-file-mb <n>', '【默认 50】单文件大小上限（MB）', (v) => Number(v))

package/dist/utils/harness-name.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeHarnessName = normalizeHarnessName;
+exports.harnessNameCore = harnessNameCore;
+exports.validateHarnessNameInput = validateHarnessNameInput;
+exports.harnessDirNameFromName = harnessDirNameFromName;
+/**
+ * Normalize and validate harness names for `svharness build`.
+ *
+ * User-facing input `my-app` becomes `.my-app`; directory is `.my-app-harness`.
+ */
+const HARNESS_NAME_CORE_RE = /^[a-z][a-z0-9-]{1,39}$/;
+/** Ensure harness name starts with `.` (e.g. `my-app` → `.my-app`). */
+function normalizeHarnessName(raw) {
+    const trimmed = raw.trim();
+    if (!trimmed)
+        return trimmed;
+    return trimmed.startsWith('.') ? trimmed : `.${trimmed}`;
+}
+/** Core segment without leading dot, for validation messages. */
+function harnessNameCore(raw) {
+    const trimmed = raw.trim();
+    return trimmed.startsWith('.') ? trimmed.slice(1) : trimmed;
+}
+function validateHarnessNameInput(raw) {
+    if (!raw?.trim()) {
+        return { ok: false, message: '--harness-name 为必填参数' };
+    }
+    const core = harnessNameCore(raw);
+    if (!HARNESS_NAME_CORE_RE.test(core)) {
+        return {
+            ok: false,
+            message: `harness 名称 "${raw.trim()}" 无效：允许小写字母、数字、中划线；` +
+                '须以字母开头；核心段长度 2–40（不含可选的前导 `.`）。',
+        };
+    }
+    return { ok: true, normalized: normalizeHarnessName(raw) };
+}
+function harnessDirNameFromName(harnessName) {
+    return `${normalizeHarnessName(harnessName)}-harness`;
+}