svharness 0.8.0 → 0.13.2

package/dist/core/extra-assets-intake.js

@@ -0,0 +1,254 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.intakeExtraAssets = intakeExtraAssets;
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const node_path_1 = __importDefault(require("node:path"));
+const js_yaml_1 = __importDefault(require("js-yaml"));
+/**
+ * Stage user-provided extra runtime assets into
+ * `<harness>/agent-env/_incoming/skills/` and emit a manifest for S65 merge.
+ */
+async function intakeExtraAssets(opts) {
+    const incomingRoot = node_path_1.default.join(opts.harnessRoot, 'agent-env', '_incoming');
+    const incomingSkillsDir = node_path_1.default.join(incomingRoot, 'skills');
+    await fs_extra_1.default.ensureDir(incomingSkillsDir);
+    const sourcePaths = await collectAssetSourcePaths(opts.inputs, opts.cwd);
+    const usedIncomingNames = new Set();
+    const entries = [];
+    for (const sourcePath of sourcePaths) {
+        const stat = await fs_extra_1.default.stat(sourcePath);
+        const baseName = node_path_1.default.basename(sourcePath);
+        const incomingName = await allocateName(incomingSkillsDir, baseName, usedIncomingNames);
+        usedIncomingNames.add(incomingName);
+        const incomingAbsPath = node_path_1.default.join(incomingSkillsDir, incomingName);
+        await fs_extra_1.default.copy(sourcePath, incomingAbsPath, { overwrite: true, errorOnExist: false });
+        const detectedType = await detectAssetType(sourcePath, stat);
+        entries.push({
+            source_path: sourcePath,
+            source_kind: stat.isDirectory() ? 'directory' : 'file',
+            incoming_path: toPosix(node_path_1.default.relative(opts.harnessRoot, incomingAbsPath)),
+            detected_type: detectedType,
+            suggested_name: buildSuggestedName(sourcePath, detectedType),
+            conflicts: [],
+            action: 'PENDING_CONFIRMATION',
+        });
+    }
+    const manifest = {
+        schema_version: 1,
+        generated_at: new Date().toISOString(),
+        source_inputs: opts.inputs,
+        entries,
+    };
+    const manifestAbsPath = node_path_1.default.join(incomingRoot, 'manifest.yaml');
+    await fs_extra_1.default.outputFile(manifestAbsPath, js_yaml_1.default.dump(manifest, { lineWidth: 100, noRefs: true, sortKeys: false }), 'utf8');
+    return {
+        manifestAbsPath,
+        manifestRelPath: toPosix(node_path_1.default.relative(opts.harnessRoot, manifestAbsPath)),
+        incomingTotal: entries.length,
+        skillsCount: entries.filter((entry) => entry.detected_type === 'skill').length,
+        rulesCount: entries.filter((entry) => entry.detected_type === 'rule').length,
+        unknownCount: entries.filter((entry) => entry.detected_type === 'unknown').length,
+    };
+}
+async function collectAssetSourcePaths(inputs, cwd) {
+    const out = new Set();
+    for (const input of inputs) {
+        const value = input.trim();
+        if (!value)
+            continue;
+        if (isGlob(value)) {
+            const matched = await globExpand(value, cwd);
+            for (const item of matched) {
+                for (const resolved of await resolveAssetPath(item)) {
+                    out.add(resolved);
+                }
+            }
+            continue;
+        }
+        const absPath = node_path_1.default.isAbsolute(value) ? value : node_path_1.default.resolve(cwd, value);
+        if (!(await fs_extra_1.default.pathExists(absPath)))
+            continue;
+        for (const resolved of await resolveAssetPath(absPath)) {
+            out.add(resolved);
+        }
+    }
+    return [...out].sort();
+}
+async function resolveAssetPath(inputPath) {
+    const stat = await fs_extra_1.default.stat(inputPath);
+    if (stat.isFile()) {
+        if (node_path_1.default.basename(inputPath).toLowerCase() === 'skill.md') {
+            return [node_path_1.default.dirname(inputPath)];
+        }
+        if (node_path_1.default.basename(inputPath).toLowerCase() === '.gitkeep') {
+            return [];
+        }
+        return [inputPath];
+    }
+    if (!(await hasSkillFile(inputPath))) {
+        return collectAssetsFromDir(inputPath);
+    }
+    return [inputPath];
+}
+async function collectAssetsFromDir(dirPath) {
+    if (await hasSkillFile(dirPath))
+        return [dirPath];
+    const out = [];
+    const entries = await fs_extra_1.default.readdir(dirPath, { withFileTypes: true });
+    for (const entry of entries) {
+        if (entry.name === '.git' || entry.name === 'node_modules' || entry.name === 'dist')
+            continue;
+        const abs = node_path_1.default.join(dirPath, entry.name);
+        if (entry.isDirectory()) {
+            out.push(...(await collectAssetsFromDir(abs)));
+        }
+        else if (entry.isFile() && entry.name.toLowerCase() !== '.gitkeep') {
+            if (entry.name.toLowerCase() === 'skill.md') {
+                out.push(node_path_1.default.dirname(abs));
+            }
+            else {
+                out.push(abs);
+            }
+        }
+    }
+    return out;
+}
+function isGlob(value) {
+    return /[*?[\]{}]/.test(value);
+}
+async function globExpand(pattern, cwd) {
+    const expanded = expandBraces(pattern);
+    const out = new Set();
+    for (const one of expanded) {
+        for (const pathItem of await globOne(one, cwd))
+            out.add(pathItem);
+    }
+    return [...out];
+}
+function expandBraces(pattern) {
+    const m = /\{([^{}]+)\}/.exec(pattern);
+    if (!m)
+        return [pattern];
+    const [whole, inner] = m;
+    const options = inner.split(',');
+    const head = pattern.slice(0, m.index);
+    const tail = pattern.slice(m.index + whole.length);
+    return options.flatMap((option) => expandBraces(head + option + tail));
+}
+async function globOne(pattern, cwd) {
+    const normalized = pattern.replace(/\\/g, '/');
+    const firstMeta = normalized.search(/[*?[]/);
+    if (firstMeta === -1) {
+        const abs = node_path_1.default.isAbsolute(normalized)
+            ? node_path_1.default.normalize(normalized)
+            : node_path_1.default.resolve(cwd, normalized);
+        return (await fs_extra_1.default.pathExists(abs)) ? [abs] : [];
+    }
+    const lastSlashBeforeMeta = normalized.lastIndexOf('/', firstMeta);
+    const basePart = lastSlashBeforeMeta === -1 ? '.' : normalized.slice(0, lastSlashBeforeMeta) || '/';
+    const tail = lastSlashBeforeMeta === -1 ? normalized : normalized.slice(lastSlashBeforeMeta + 1);
+    const baseAbs = node_path_1.default.isAbsolute(basePart) ? basePart : node_path_1.default.resolve(cwd, basePart);
+    if (!(await fs_extra_1.default.pathExists(baseAbs)))
+        return [];
+    const matcher = globToRegex(tail);
+    const all = await walkEntries(baseAbs);
+    return all.filter((entryPath) => matcher.test(toPosix(node_path_1.default.relative(baseAbs, entryPath))));
+}
+function globToRegex(glob) {
+    let source = '^';
+    for (let i = 0; i < glob.length; i++) {
+        const c = glob[i];
+        if (c === '*') {
+            if (glob[i + 1] === '*') {
+                source += '.*';
+                i++;
+                if (glob[i + 1] === '/')
+                    i++;
+            }
+            else {
+                source += '[^/]*';
+            }
+        }
+        else if (c === '?') {
+            source += '[^/]';
+        }
+        else if ('.+^$()|\\'.includes(c)) {
+            source += '\\' + c;
+        }
+        else {
+            source += c;
+        }
+    }
+    source += '$';
+    return new RegExp(source);
+}
+async function walkEntries(dirPath) {
+    const out = [];
+    const entries = await fs_extra_1.default.readdir(dirPath, { withFileTypes: true });
+    for (const entry of entries) {
+        if (entry.name === '.git' || entry.name === 'node_modules' || entry.name === 'dist')
+            continue;
+        const abs = node_path_1.default.join(dirPath, entry.name);
+        out.push(abs);
+        if (entry.isDirectory()) {
+            out.push(...(await walkEntries(abs)));
+        }
+    }
+    return out;
+}
+async function detectAssetType(sourcePath, stat) {
+    if (stat.isDirectory()) {
+        return (await hasSkillFile(sourcePath)) ? 'skill' : 'unknown';
+    }
+    const fileName = node_path_1.default.basename(sourcePath).toLowerCase();
+    const ext = node_path_1.default.extname(fileName);
+    if (ext === '.mdc')
+        return 'rule';
+    if (fileName === 'skill.md')
+        return 'skill';
+    if (fileName.startsWith('harness-apply-rules-'))
+        return 'rule';
+    if (fileName.startsWith('harness-apply-skills-'))
+        return 'skill';
+    if (fileName.includes('-rules-') && ext === '.md')
+        return 'rule';
+    return 'unknown';
+}
+async function hasSkillFile(dirPath) {
+    return fs_extra_1.default.pathExists(node_path_1.default.join(dirPath, 'SKILL.md'));
+}
+function buildSuggestedName(sourcePath, detectedType) {
+    if (detectedType === 'unknown')
+        return undefined;
+    const raw = node_path_1.default.basename(sourcePath, node_path_1.default.extname(sourcePath));
+    const normalized = raw
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .replace(/--+/g, '-');
+    if (!normalized)
+        return undefined;
+    if (detectedType === 'skill')
+        return `harness-apply-skills-${normalized}`;
+    return `harness-apply-rules-${normalized}`;
+}
+async function allocateName(targetDir, baseName, used) {
+    if (!used.has(baseName) && !(await fs_extra_1.default.pathExists(node_path_1.default.join(targetDir, baseName)))) {
+        return baseName;
+    }
+    const ext = node_path_1.default.extname(baseName);
+    const stem = ext ? baseName.slice(0, -ext.length) : baseName;
+    for (let i = 1; i < 1000; i++) {
+        const next = ext ? `${stem}-${i}${ext}` : `${stem}-${i}`;
+        if (!used.has(next) && !(await fs_extra_1.default.pathExists(node_path_1.default.join(targetDir, next)))) {
+            return next;
+        }
+    }
+    throw new Error(`无法为 incoming 资源分配唯一文件名: ${baseName}`);
+}
+function toPosix(input) {
+    return input.replace(/\\/g, '/');
+}

package/dist/core/markitdown-client.js

@@ -0,0 +1,156 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MarkItDownClientError = void 0;
+exports.ping = ping;
+exports.postConvert = postConvert;
+exports.postConvertWithRetry = postConvertWithRetry;
+/**
+ * Thin HTTP client for a cloud-deployed `markitdown_serve` instance
+ * (FastAPI + Microsoft MarkItDown).
+ *
+ * The server contract is defined once in `markitdown_serve/README.md`:
+ *
+ *   POST /convert
+ *     Content-Type: multipart/form-data
+ *     field: file (binary)
+ *     200 { markdown, source_name, mime }
+ *     413 { error: 'file_too_large', limit_mb }
+ *     415 { error: 'unsupported_format', ext }
+ *     500 { error: 'internal', trace_id }
+ *
+ *   GET /healthz  -> 200 { status: 'ok', markitdown_version }
+ *
+ * We rely exclusively on Node 18+ built-ins (`fetch`, `FormData`, `Blob`), so
+ * there is no extra npm dependency to ship.
+ */
+const promises_1 = __importDefault(require("node:fs/promises"));
+const node_path_1 = __importDefault(require("node:path"));
+class MarkItDownClientError extends Error {
+    status;
+    retryable;
+    body;
+    constructor(message, status, retryable, body) {
+        super(message);
+        this.name = 'MarkItDownClientError';
+        this.status = status;
+        this.retryable = retryable;
+        this.body = body;
+    }
+}
+exports.MarkItDownClientError = MarkItDownClientError;
+/**
+ * Probe the remote service. Resolves to the parsed health payload on success,
+ * throws a `MarkItDownClientError` otherwise. Used by the `convert` command
+ * to fail fast with a clear message before attempting any upload.
+ */
+async function ping(endpoint, timeoutMs = 10_000) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        const res = await fetch(`${endpoint}/healthz`, {
+            method: 'GET',
+            signal: controller.signal,
+        });
+        if (!res.ok) {
+            throw new MarkItDownClientError(`/healthz responded HTTP ${res.status}`, res.status, false);
+        }
+        return (await res.json());
+    }
+    catch (err) {
+        if (err instanceof MarkItDownClientError)
+            throw err;
+        throw new MarkItDownClientError(`healthz unreachable: ${err.message}`, 0, true);
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+/**
+ * Upload a single file to `POST /convert` and return the parsed Markdown
+ * payload. 5xx / network errors surface as retryable errors; 4xx surfaces as
+ * non-retryable (no point re-uploading an unsupported format).
+ */
+async function postConvert(endpoint, filePath, timeoutMs) {
+    const buf = await promises_1.default.readFile(filePath);
+    const fileName = node_path_1.default.basename(filePath);
+    const form = new FormData();
+    // Node's global Blob accepts Uint8Array; DOM's BlobPart type is not in
+    // ES2022 lib, so we go through `any` to avoid pulling in DOM typings.
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    form.append('file', new Blob([buf]), fileName);
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        const res = await fetch(`${endpoint}/convert`, {
+            method: 'POST',
+            body: form,
+            signal: controller.signal,
+        });
+        const rawText = await res.text();
+        let parsed;
+        try {
+            parsed = rawText ? JSON.parse(rawText) : undefined;
+        }
+        catch {
+            parsed = rawText;
+        }
+        if (!res.ok) {
+            const retryable = res.status >= 500;
+            throw new MarkItDownClientError(describeHttpError(res.status, parsed), res.status, retryable, parsed);
+        }
+        const body = parsed;
+        if (!body || typeof body.markdown !== 'string') {
+            throw new MarkItDownClientError(`unexpected response shape, missing "markdown" field`, res.status, false, parsed);
+        }
+        return {
+            markdown: body.markdown,
+            source_name: body.source_name || fileName,
+            mime: body.mime,
+        };
+    }
+    catch (err) {
+        if (err instanceof MarkItDownClientError)
+            throw err;
+        if (err.name === 'AbortError') {
+            throw new MarkItDownClientError(`request timed out after ${Math.round(timeoutMs / 1000)}s`, 0, true);
+        }
+        throw new MarkItDownClientError(`network error: ${err.message}`, 0, true);
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+/**
+ * `postConvert` with one automatic retry on retryable errors (5xx / network).
+ * 4xx errors bypass the retry to keep diagnostics fast.
+ */
+async function postConvertWithRetry(endpoint, filePath, timeoutMs) {
+    try {
+        return await postConvert(endpoint, filePath, timeoutMs);
+    }
+    catch (err) {
+        if (err instanceof MarkItDownClientError && err.retryable) {
+            return await postConvert(endpoint, filePath, timeoutMs);
+        }
+        throw err;
+    }
+}
+function describeHttpError(status, body) {
+    if (body && typeof body === 'object') {
+        const b = body;
+        if (status === 415 && b.error === 'unsupported_format') {
+            return `server rejected unsupported format (ext=${String(b.ext ?? '?')})`;
+        }
+        if (status === 413 && b.error === 'file_too_large') {
+            return `server size limit exceeded (limit_mb=${String(b.limit_mb ?? '?')})`;
+        }
+        if (b.error) {
+            const trace = b.trace_id ? ` trace_id=${String(b.trace_id)}` : '';
+            return `server error ${status}: ${String(b.error)}${trace}`;
+        }
+    }
+    return `server returned HTTP ${status}`;
+}

package/dist/core/next-steps.js

@@ -20,11 +20,16 @@ function printNextSteps(input) {
     lines.push('');
     lines.push(`1. ${picocolors_1.default.cyan('cd ' + input.targetRoot)}`);
     lines.push('');
-    lines.push('2. 确认构建辅助 skill 已加载到 Agent 的 skill 目录: ' +
+    lines.push('2. 打开项目根下的 ' +
+        picocolors_1.default.cyan(input.adapter.projectEntryFile) +
+        '，并确认构建辅助 skill 已加载: ' +
         picocolors_1.default.cyan(input.adapter.skillsDir + '/'));
+    lines.push('   - harness-build-skills-main           （harness-build 总清单 / 二级调度，优先入口）');
     lines.push('   - harness-build-skill-orchestrator       （构建总调度）');
     lines.push('   - harness-build-skill-spec-builder       （raw → requirements → specs）');
-    lines.push('   - harness-build-skill-knowledge-builder  （baseline/code 样本 / rules / skills & tasks）');
+    lines.push('   - harness-build-skill-references-intake  （S60 references convert + 结构化索引）');
+    lines.push('   - harness-build-skill-agent-env-merge    （S61 确认 + S65 合并写入）');
+    lines.push('   - harness-build-skill-knowledge-builder  （S10 样本 / S70 skills & tasks）');
     lines.push('   - harness-build-skill-wiki-writer        （按 TASKS.md 逐页撰写 baseline wiki 正文）');
     lines.push('');
     if (input.adapter.rulesDir) {
@@ -33,17 +38,24 @@ function printNextSteps(input) {
         lines.push('');
     }
     if (input.hasSource) {
-        lines.push('3. 已识别到基线源码（反向提取模式）。将原始需求文档放入 ' +
-            picocolors_1.default.cyan('assets/raw/') +
-            '，然后打开 AI 会话并说：');
+        lines.push('3. 已识别到基线源码（反向提取模式）。先准备 P2 相关文件：' +
+            picocolors_1.default.cyan('requirements/raw/') +
+            '、' +
+            picocolors_1.default.cyan('references/raw/') +
+            '，并确认是否有额外运行期 skills/rules，然后打开 AI 会话并说：');
     }
     else {
-        lines.push('3. 全新项目模式。将需求文档编写或粘贴到 ' +
-            picocolors_1.default.cyan('assets/raw/') +
-            '，然后打开 AI 会话并说：');
+        lines.push('3. 全新项目模式。先准备 P2 相关文件：' +
+            picocolors_1.default.cyan('requirements/raw/') +
+            '、' +
+            picocolors_1.default.cyan('references/raw/') +
+            '，并确认是否有额外运行期 skills/rules，然后打开 AI 会话并说：');
     }
     lines.push('');
-    lines.push('   ' + picocolors_1.default.bold(picocolors_1.default.yellow('>> 开始构建 harness')));
+    lines.push('   ' +
+        picocolors_1.default.bold(picocolors_1.default.yellow('>> 按 harness-build-skills-main 开始构建')) +
+        ' 或 ' +
+        picocolors_1.default.bold(picocolors_1.default.yellow('>> 开始构建 harness')));
     lines.push('');
     lines.push('4. 随时用下面的命令查看进度: ' +
         picocolors_1.default.cyan('cat .harness-build-state.yaml'));
@@ -51,34 +63,33 @@ function printNextSteps(input) {
     if (input.hasSource) {
         lines.push(picocolors_1.default.bold('Baseline Repomix（XML，默认）'));
         lines.push('   输出文件: ' + picocolors_1.default.cyan((0, repomix_pack_1.repomixPackRelFile)()));
-        lines.push('   （若 init 中 Repomix 步骤失败，请查看上方日志中的具体报错）');
         lines.push('');
     }
     if (wikiMode === 'tasks') {
         lines.push(picocolors_1.default.bold('Baseline wiki 任务清单已生成（默认 tasks-only 模式）'));
-        lines.push('   清单位置: ' + picocolors_1.default.cyan('assets/baseline/wiki/TASKS.md'));
-        lines.push('   Outline XML: ' + picocolors_1.default.cyan('assets/baseline/wiki/structure.xml'));
-        lines.push('   源码快照: ' + picocolors_1.default.cyan('assets/baseline/code/'));
+        lines.push('   清单位置: ' + picocolors_1.default.cyan('baseline/wiki/TASKS.md'));
+        lines.push('   Outline XML: ' + picocolors_1.default.cyan('baseline/wiki/structure.xml'));
+        lines.push('   源码快照: ' + picocolors_1.default.cyan('baseline/code/'));
         lines.push('   打开 AI 会话并说: ' +
             picocolors_1.default.bold(picocolors_1.default.yellow('>> 按 TASKS.md 逐页生成 baseline wiki')));
-        lines.push('   （由 harness-build-skill-wiki-writer skill 接管，源码引用统一指向 assets/baseline/code/）');
-        lines.push('   .harness-build-state.yaml 中 P1_wiki 初始为 PENDING，');
+        lines.push('   （由 harness-build-skill-wiki-writer skill 接管，源码引用统一指向 baseline/code/）');
+        lines.push('   .harness-build-state.yaml 中 S10_wiki 初始为 PENDING，');
         lines.push('   全部 [x] 后由 harness-build-skill-orchestrator 标记 DONE。');
         lines.push('');
     }
     else if (wikiMode === 'full') {
         lines.push(picocolors_1.default.bold('Baseline wiki 已完整生成（--generate-wiki 模式）'));
-        lines.push('   wiki 目录: ' + picocolors_1.default.cyan('assets/baseline/wiki/'));
-        lines.push('   .harness-build-state.yaml 中 P1_wiki 初始为 DONE。');
+        lines.push('   wiki 目录: ' + picocolors_1.default.cyan('baseline/wiki/'));
+        lines.push('   .harness-build-state.yaml 中 S10_wiki 初始为 DONE。');
         lines.push('');
     }
     // 更显眼的提示框
     const tipBox = [
-        '┌──────────────────────────────────────────────────────────────────────────┐',
-        '│  💡 提示                                                                 │',
-        '│  svharness 已完成骨架初始化及辅助 skill 的注入到 Agent 的 skill目录    │',
-        '│  自此起所有构建步骤均由 Agent 驱动                                         │',
-        '└──────────────────────────────────────────────────────────────────────────┘',
+        '┌──────────────────────────────────────────────────────────────────────────',
+        '│  💡 提示                                                                 ',
+        '│  svharness 已完成骨架初始化及辅助 skill 的注入到 Agent 的 skill目录    ',
+        '│  自此起所有构建步骤均由 Agent 驱动                                         ',
+        '└──────────────────────────────────────────────────────────────────────────',
     ];
     for (const line of tipBox) {
         lines.push(picocolors_1.default.bold(picocolors_1.default.yellow(line)));

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/core/reference-apply-skills.js

@@ -0,0 +1,35 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadApplySkillRegistry = loadApplySkillRegistry;
+exports.registryEntriesForBinding = registryEntriesForBinding;
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const node_path_1 = __importDefault(require("node:path"));
+const js_yaml_1 = __importDefault(require("js-yaml"));
+async function loadApplySkillRegistry(harnessRoot) {
+    const registryPath = node_path_1.default.join(harnessRoot, 'references', 'apply-skills-registry.yaml');
+    if (!(await fs_extra_1.default.pathExists(registryPath)))
+        return undefined;
+    const raw = js_yaml_1.default.load(await fs_extra_1.default.readFile(registryPath, 'utf8'));
+    if (!raw?.skills?.length)
+        return undefined;
+    return raw;
+}
+function registryEntriesForBinding(registry) {
+    return registry.skills
+        .filter((s) => s.enabled)
+        .map((s) => {
+        const row = {
+            name: s.skill_name,
+            reference_md: s.reference_md,
+            description: s.description,
+        };
+        if (s.entry)
+            row.entry = s.entry;
+        if (s.source_id)
+            row.source_id = s.source_id;
+        return row;
+    });
+}

package/dist/core/render-meta.js

@@ -11,7 +11,8 @@ const ejs_1 = __importDefault(require("ejs"));
 const logger_1 = require("../utils/logger");
 const META_FILES = [
     { tplName: 'harness.yaml.ejs', outName: 'harness.yaml' },
-    { tplName: 'AGENTS.md.ejs', outName: 'AGENTS.md' },
+    { tplName: 'AGENTS_BUILD.md.ejs', outName: 'AGENTS_BUILD.md' },
+    { tplName: 'AGENTS_APPLY.md.ejs', outName: 'AGENTS_APPLY.md' },
     { tplName: 'README.md.ejs', outName: 'README.md' },
     { tplName: 'VERSION.ejs', outName: 'VERSION' },
     { tplName: 'CHANGELOG.md.ejs', outName: 'CHANGELOG.md' },

package/dist/core/repomix-pack.js

@@ -9,15 +9,15 @@ exports.runRepomixPackBaseline = runRepomixPackBaseline;
 const fs_extra_1 = __importDefault(require("fs-extra"));
 const node_path_1 = __importDefault(require("node:path"));
 const repomix_1 = require("repomix");
-/** Relative to harness root: `assets/baseline/repomix/repomix-pack.xml`. */
-exports.REPOMIX_BASELINE_REL_DIR = node_path_1.default.join('assets', 'baseline', 'repomix');
+/** Relative to harness root: `baseline/repomix/repomix-pack.xml`. */
+exports.REPOMIX_BASELINE_REL_DIR = node_path_1.default.join('baseline', 'repomix');
 exports.REPOMIX_PACK_FILENAME = 'repomix-pack.xml';
 function repomixPackRelFile() {
     return node_path_1.default.join(exports.REPOMIX_BASELINE_REL_DIR, exports.REPOMIX_PACK_FILENAME).replace(/\\/g, '/');
 }
 /**
  * Pack `packRootFs` with Repomix (library `runCli`) and write XML to
- * `<harnessRootFs>/assets/baseline/repomix/repomix-pack.xml`.
+ * `<harnessRootFs>/baseline/repomix/repomix-pack.xml`.
  */
 async function runRepomixPackBaseline(opts) {
     const { packRootFs, harnessRootFs, onLog } = opts;