ai-dev-harness 0.1.0 → 0.1.2

package/dist/config.js

@@ -4,11 +4,13 @@ import { pathExists, readTextIfExists } from "./utils.js";
 export const defaultConfig = {
     agents: {
         codex: { command: "codex exec --full-auto -" },
-        claude: { command: "claude -p -" }
+        claude: { command: "claude -p -" },
+        cursor: { command: "cursor-agent" },
+        gemini: { command: "gemini" }
     },
     mcp: {
-        codegraph: { url: "http://localhost:7331/mcp" },
-        knowledgeGraph: { url: "http://localhost:7332/mcp" },
+        codegraph: { type: "http", url: "http://localhost:7331/mcp", headers: {} },
+        knowledgeGraph: { type: "http", url: "http://localhost:7332/mcp", headers: {} },
         timeoutMs: 15000
     },
     verify: {
@@ -18,6 +20,21 @@ export const defaultConfig = {
     context: {
         fallbackInclude: ["AGENTS.md", "TOOLS.md", "SKILLS.md", "README.md", "package.json", "src"],
         exclude: ["node_modules", ".git", "dist", "build", ".next", "coverage", "runs"]
+    },
+    loop: {
+        maxIterations: 1,
+        stopOn: ["same_failure_repeated", "max_iterations_reached"]
+    },
+    policy: {
+        protectedPaths: [".github/", "scripts/release/", "security/"],
+        requireApproval: [
+            "protected_path_change",
+            "dependency_change",
+            "delete_files",
+            "public_api_change_declared",
+            "security_change_declared"
+        ],
+        approvalMode: "file"
     }
 };
 export function renderYaml(value, indent = 0) {
@@ -48,6 +65,8 @@ export function renderYaml(value, indent = 0) {
             .join("\n");
     }
     if (typeof value === "object" && value !== null) {
+        if (Object.keys(value).length === 0)
+            return `${pad}{}`;
         return Object.entries(value)
             .map(([key, item]) => {
             if (typeof item === "object" && item !== null)
@@ -65,7 +84,10 @@ function readScalar(raw) {
     const value = raw.trim().replace(/^["']|["']$/g, "");
     if (/^\d+$/.test(value))
         return Number(value);
-    return value;
+    return expandEnv(value);
+}
+function expandEnv(value) {
+    return value.replace(/\$\{([A-Za-z_][A-Za-z0-9_]*)\}/g, (_match, name) => process.env[name] ?? "");
 }
 function parseVerifyCommands(text) {
     const commands = [];
@@ -95,14 +117,73 @@ function blockList(text, key) {
     const match = text.match(new RegExp(`^\\s*${key}:\\n([\\s\\S]*?)(?=^\\s*[a-zA-Z][\\w]*:|^\\S|$)`, "m"));
     return match ? parseStringList(match[1]) : [];
 }
+function mcpAskFor(text, source) {
+    const lines = text.split("\n");
+    const sourceIndex = lines.findIndex((line) => line === `  ${source}:`);
+    if (sourceIndex < 0)
+        return [];
+    const askForIndex = lines.findIndex((line, index) => index > sourceIndex && line === "    ask_for:");
+    if (askForIndex < 0)
+        return [];
+    const values = [];
+    for (const line of lines.slice(askForIndex + 1)) {
+        if (!line.trim())
+            continue;
+        if (!line.startsWith("      - "))
+            break;
+        values.push(String(readScalar(line.slice("      - ".length))));
+    }
+    return values;
+}
+function objectBlock(text, key) {
+    const values = {};
+    const lines = text.split("\n");
+    const start = lines.findIndex((line) => line.match(new RegExp(`^\\s*${key}:\\s*$`)));
+    if (start < 0)
+        return values;
+    const baseIndent = lines[start].match(/^\s*/)?.[0].length ?? 0;
+    for (const line of lines.slice(start + 1)) {
+        if (!line.trim())
+            continue;
+        const indent = line.match(/^\s*/)?.[0].length ?? 0;
+        if (indent <= baseIndent)
+            break;
+        const item = line.match(/^\s*([A-Za-z0-9_-]+):\s*(.+)$/);
+        if (item)
+            values[item[1]] = String(readScalar(item[2]));
+    }
+    return values;
+}
+function indentedSection(text, key, indent) {
+    const lines = text.split("\n");
+    const start = lines.findIndex((line) => line.match(new RegExp(`^ {${indent}}${key}:\\s*$`)));
+    if (start < 0)
+        return "";
+    const collected = [];
+    for (const line of lines.slice(start + 1)) {
+        if (!line.trim()) {
+            collected.push(line);
+            continue;
+        }
+        const currentIndent = line.match(/^\s*/)?.[0].length ?? 0;
+        if (currentIndent <= indent)
+            break;
+        collected.push(line);
+    }
+    return collected.join("\n");
+}
 export async function loadConfig(cwd) {
     const configPath = path.join(cwd, "harness.yaml");
     if (!(await pathExists(configPath)))
         return defaultConfig;
-    const text = await readFile(configPath, "utf8");
+    const text = (await readFile(configPath, "utf8")).replace(/\r\n/g, "\n");
     const verifyRoot = topSection(text, "verify");
     const verifySection = verifyRoot.match(/defaultCommands:\n([\s\S]*?)(?=^\S|^  [a-zA-Z][\w]*:|$)/m)?.[1] ?? "";
     const contextSection = topSection(text, "context");
+    const loopSection = topSection(text, "loop");
+    const policySection = topSection(text, "policy");
+    const codegraphSection = indentedSection(text, "codegraph", 2);
+    const knowledgeSection = indentedSection(text, "knowledgeGraph", 2);
     return {
         agents: {
             codex: {
@@ -110,14 +191,24 @@ export async function loadConfig(cwd) {
             },
             claude: {
                 command: String(scalar(text, /agents:\n[\s\S]*?claude:\n\s+command:\s*([^\n]+)/m, defaultConfig.agents.claude.command))
+            },
+            cursor: {
+                command: String(scalar(text, /agents:\n[\s\S]*?cursor:\n\s+command:\s*([^\n]+)/m, defaultConfig.agents.cursor.command))
+            },
+            gemini: {
+                command: String(scalar(text, /agents:\n[\s\S]*?gemini:\n\s+command:\s*([^\n]+)/m, defaultConfig.agents.gemini.command))
             }
         },
         mcp: {
             codegraph: {
-                url: String(scalar(text, /mcp:\n[\s\S]*?codegraph:\n\s+url:\s*([^\n]+)/m, defaultConfig.mcp.codegraph.url))
+                type: String(scalar(codegraphSection, /^\s*type:\s*([^\n]+)/m, defaultConfig.mcp.codegraph.type ?? "http")),
+                url: String(scalar(codegraphSection, /^\s*url:\s*([^\n]+)/m, defaultConfig.mcp.codegraph.url)),
+                headers: objectBlock(codegraphSection, "headers")
             },
             knowledgeGraph: {
-                url: String(scalar(text, /mcp:\n[\s\S]*?knowledgeGraph:\n\s+url:\s*([^\n]+)/m, defaultConfig.mcp.knowledgeGraph.url))
+                type: String(scalar(knowledgeSection, /^\s*type:\s*([^\n]+)/m, defaultConfig.mcp.knowledgeGraph.type ?? "http")),
+                url: String(scalar(knowledgeSection, /^\s*url:\s*([^\n]+)/m, defaultConfig.mcp.knowledgeGraph.url)),
+                headers: objectBlock(knowledgeSection, "headers")
             },
             timeoutMs: Number(scalar(text, /mcp:\n[\s\S]*?timeoutMs:\s*([^\n]+)/m, defaultConfig.mcp.timeoutMs))
         },
@@ -134,6 +225,19 @@ export async function loadConfig(cwd) {
             exclude: blockList(contextSection, "exclude").length
                 ? blockList(contextSection, "exclude")
                 : defaultConfig.context.exclude
+        },
+        loop: {
+            maxIterations: Number(scalar(loopSection, /maxIterations:\s*([^\n]+)/m, defaultConfig.loop.maxIterations)),
+            stopOn: blockList(loopSection, "stopOn").length ? blockList(loopSection, "stopOn") : defaultConfig.loop.stopOn
+        },
+        policy: {
+            protectedPaths: blockList(policySection, "protectedPaths").length
+                ? blockList(policySection, "protectedPaths")
+                : defaultConfig.policy.protectedPaths,
+            requireApproval: blockList(policySection, "requireApproval").length
+                ? blockList(policySection, "requireApproval")
+                : defaultConfig.policy.requireApproval,
+            approvalMode: "file"
         }
     };
 }
@@ -143,14 +247,19 @@ export async function loadSkill(cwd, name) {
         throw new Error(`Skill not found: ${name}. Expected ${path.join(dir, "SKILL.md")}`);
     }
     const markdown = await readTextIfExists(path.join(dir, "SKILL.md"));
-    const verifyText = await readTextIfExists(path.join(dir, "verify.yaml"));
-    const contextText = await readTextIfExists(path.join(dir, "context.yaml"));
+    const verifyText = (await readTextIfExists(path.join(dir, "verify.yaml"))).replace(/\r\n/g, "\n");
+    const contextText = (await readTextIfExists(path.join(dir, "context.yaml"))).replace(/\r\n/g, "\n");
     return {
         name,
         dir,
         markdown,
         verifyCommands: parseVerifyCommands(verifyText),
         contextQueries: blockList(contextText, "queries"),
+        mcpPreflight: {
+            codegraph: mcpAskFor(contextText, "codegraph"),
+            knowledgeGraph: mcpAskFor(contextText, "knowledgeGraph")
+        },
+        stopConditions: blockList(contextText, "stop_conditions"),
         fallbackInclude: blockList(contextText, "fallbackInclude")
     };
 }

package/dist/context.js

@@ -41,24 +41,15 @@ async function fallbackContext(cwd, config, skill) {
     }
     return snippets.join("\n\n");
 }
+function listSection(items, empty = "- (none configured)") {
+    return items.length ? items.map((item) => `- ${item}`).join("\n") : empty;
+}
 export async function buildContextPack(options) {
     const { cwd, task, config, skill, contextPackPath, mcpLogPath, audit } = options;
-    await audit.event({ stage: "context_pack", event: "mcp_query", status: "started" });
+    await audit.event({ stage: "context_pack", event: "mcp_sources_record", status: "started" });
     const source = new ContextSource(config, mcpLogPath);
     const { codeContext, knowledgeContext } = await source.searchTaskContext(task, skill);
-    const degraded = codeContext.degraded || knowledgeContext.degraded;
-    if (degraded)
-        await audit.event({
-            stage: "context_pack",
-            event: "mcp_query",
-            status: "degraded",
-            detail: {
-                codegraph: codeContext.error,
-                knowledgeGraph: knowledgeContext.error
-            }
-        });
-    else
-        await audit.event({ stage: "context_pack", event: "mcp_query", status: "succeeded" });
+    await audit.event({ stage: "context_pack", event: "mcp_sources_record", status: "succeeded" });
     const branch = await git(cwd, "branch --show-current");
     const status = await git(cwd, "status --short");
     const recent = await git(cwd, "log -5 --oneline");
@@ -66,12 +57,62 @@ export async function buildContextPack(options) {
     const markdown = `# Context Pack
 
 ## How To Use This Context
-- Treat CodeGraph and Knowledge Graph results as primary context when status is ok.
-- If either MCP source is degraded, explicitly mention the degraded source in your analysis and rely on fallback context carefully.
+- CodeGraph and Knowledge Graph are agent-side MCP sources. Use the current execution agent's MCP tools directly before and during execution when available.
+- For colbymchenry/codegraph, prefer the default codegraph_explore tool first. Ask it with the suspected flow, file, symbol, or behavior; use its grouped source, line-numbered source, call paths, dynamic dispatch hops, and blast-radius summary to build context.
+- For browser_knowledge_service, use progressive disclosure: list_path/search_docs/search_sections/search_chunks or hybrid_search/answer_context first, then read_doc_outline, then read_section/read_doc_range/read_chunk/get_related_chunks for exact evidence. Do not call propose_doc in Harness v1; write suggestions to persist_suggestions.md.
+- Harness records MCP configuration and audit evidence, but it does not implement MCP transport or replace the agent MCP client.
+- If the current agent cannot access an MCP source, explicitly mention the missing source and rely on fallback context carefully.
 - Do not assume fallback file snippets are complete repository knowledge.
 - Cross-check task assumptions against Git state, project rules, and available source files before editing.
 - Prefer minimal changes in files directly connected to the task.
 
+## Agent Context Assembly Protocol
+Before editing, assemble context in this exact shape:
+
+### MCP Preflight Findings
+- CodeGraph tools used:
+- CodeGraph primary query:
+- CodeGraph findings:
+  - Source grouped by file:
+  - Current line-numbered source:
+  - Call paths:
+  - Dynamic dispatch hops:
+  - Blast-radius summary:
+- Knowledge Graph tools used:
+- Knowledge Graph findings:
+  - Search tools used:
+  - Candidate concept_ids:
+  - Read tools used:
+  - Evidence sections/chunks:
+  - ADRs / decisions:
+  - Module notes:
+  - API notes:
+  - Runbooks / known issues:
+  - Audit/backlink findings:
+- Missing context:
+
+### Impact Analysis
+- Root cause or implementation intent:
+- Affected files/modules:
+- User-visible behavior:
+- Compatibility and risk:
+
+### Proposed Plan
+- Files to inspect:
+- Files to change:
+- Verification plan:
+- Stop conditions checked:
+
+## Skill MCP Preflight Requirements
+### CodeGraph ask_for
+${listSection(skill.mcpPreflight.codegraph)}
+
+### Knowledge Graph ask_for
+${listSection(skill.mcpPreflight.knowledgeGraph)}
+
+## Skill Stop Conditions
+${listSection(skill.stopConditions)}
+
 ## Task
 ${task}
 
@@ -92,15 +133,15 @@ ${status || "(clean or unavailable)"}
 ${recent || "(unavailable)"}
 \`\`\`
 
-## CodeGraph MCP
-Status: ${codeContext.ok ? "ok" : "degraded"}
+## CodeGraph MCP Source
+Mode: agent-driven
 
 \`\`\`json
 ${truncate(JSON.stringify(codeContext.data ?? { error: codeContext.error }, null, 2), 12000)}
 \`\`\`
 
-## Knowledge Graph MCP
-Status: ${knowledgeContext.ok ? "ok" : "degraded"}
+## Knowledge Graph MCP Source
+Mode: agent-driven
 
 \`\`\`json
 ${truncate(JSON.stringify(knowledgeContext.data ?? { error: knowledgeContext.error }, null, 2), 12000)}
@@ -110,5 +151,5 @@ ${truncate(JSON.stringify(knowledgeContext.data ?? { error: knowledgeContext.err
 ${fallback || "(no fallback context found)"}
 `;
     await writeFile(contextPackPath, markdown, "utf8");
-    return { markdown, degraded, mcpResults: [codeContext, knowledgeContext] };
+    return { markdown, mcpResults: [codeContext, knowledgeContext] };
 }

package/dist/contextScore.js

@@ -0,0 +1,44 @@
+import { writeFile } from "node:fs/promises";
+function hasValueAfter(label, output) {
+    const escaped = label.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    const match = output.match(new RegExp(`${escaped}\\s*[:：]?\\s*([^\\n]+)`, "i"));
+    if (!match)
+        return false;
+    const value = match[1].trim();
+    return Boolean(value && !/^[-(]?\s*(none|n\/a|unknown|无|没有|未使用|缺失|不适用)/i.test(value));
+}
+function hasAnyValueAfter(labels, output) {
+    return labels.some((label) => hasValueAfter(label, output));
+}
+function hasAnyPattern(patterns, output) {
+    return patterns.some((pattern) => pattern.test(output));
+}
+export function createContextScore(output) {
+    const requiredFields = {
+        codegraphToolsUsed: hasAnyValueAfter(["CodeGraph tools used", "CodeGraph 工具", "CodeGraph 使用工具", "代码图谱工具"], output) ||
+            hasAnyPattern([/codegraph[_-]?\w+/i, /codegraph_explore/i], output),
+        blastRadiusSummary: hasAnyValueAfter(["Blast-radius summary", "Blast radius summary", "影响范围", "影响面", "变更影响范围"], output) ||
+            hasAnyPattern([/blast[_ -]?radius/i, /影响范围\s*[:：]\s*\S+/i], output),
+        knowledgeConceptIds: hasAnyValueAfter(["Candidate concept_ids", "Concept IDs", "候选 concept_ids", "知识库 concept_ids", "知识概念"], output) ||
+            hasAnyPattern([/concept[_ -]?ids?\s*[:：]\s*\S+/i, /\/[^ \n]+\/(overview|features|metrics|api|playbooks|references)\//i], output),
+        missingContextDeclared: hasAnyValueAfter(["Missing context", "缺失上下文", "上下文缺口", "未确认上下文"], output) ||
+            hasAnyPattern([/Missing context\s*[:：]/i, /缺失上下文\s*[:：]/i, /上下文缺口\s*[:：]/i], output)
+    };
+    const missing = Object.entries(requiredFields)
+        .filter(([, present]) => !present)
+        .map(([key]) => key);
+    const presentCount = Object.values(requiredFields).filter(Boolean).length;
+    return {
+        status: presentCount >= 4 ? "strong" : presentCount >= 2 ? "acceptable" : "weak",
+        requiredFields,
+        missing,
+        recommendation: missing.length
+            ? `下一轮请补充以下上下文证据：${missing.join(", ")}。`
+            : "上下文证据结构完整。"
+    };
+}
+export async function writeContextScore(path, output) {
+    const score = createContextScore(output);
+    await writeFile(path, `${JSON.stringify(score, null, 2)}\n`, "utf8");
+    return score;
+}

package/dist/diagnostics.js

@@ -0,0 +1,58 @@
+import { writeFile } from "node:fs/promises";
+import { truncate } from "./utils.js";
+const FILE_PATTERN = /(?:^|\s)([A-Za-z]:[\\/][^\s:]+|\b[\w./\\-]+\.(?:ts|tsx|js|jsx|json|md|yaml|yml|py|java|cc|cpp|h|hpp|cs|go|rs))(?::(\d+))?/g;
+function uniq(values) {
+    return [...new Set(values.filter(Boolean))].slice(0, 20);
+}
+function errorLines(log) {
+    return log
+        .split(/\r?\n/)
+        .filter((line) => /error|failed|failure|exception|assert|not ok|FAIL|Error:/i.test(line))
+        .slice(0, 30)
+        .map((line) => truncate(line, 500));
+}
+function suspectedFiles(log) {
+    const files = [];
+    for (const match of log.matchAll(FILE_PATTERN))
+        files.push(match[1].replace(/\\/g, "/"));
+    return uniq(files);
+}
+function testNames(log) {
+    const names = [];
+    for (const line of log.split(/\r?\n/)) {
+        const subtest = line.match(/# Subtest:\s*(.+)$/);
+        if (subtest)
+            names.push(subtest[1].trim());
+        const jest = line.match(/(?:FAIL|✕|×)\s+(.+)$/);
+        if (jest)
+            names.push(jest[1].trim());
+    }
+    return uniq(names);
+}
+export function createVerifyDiagnostics(verify) {
+    const failedCommands = verify.commands
+        .filter((command) => command.exitCode !== 0)
+        .map((command) => {
+        const log = `${command.stdout}\n${command.stderr}`;
+        const errors = errorLines(log);
+        return {
+            name: command.name,
+            command: command.command,
+            exitCode: command.exitCode,
+            failureSummary: errors[0] ?? truncate(log.trim() || "验证命令失败但没有输出。", 1000),
+            errorLines: errors,
+            suspectedFiles: suspectedFiles(log),
+            testNames: testNames(log),
+            rawLogRef: "verify.json"
+        };
+    });
+    return {
+        status: verify.status,
+        failedCommands
+    };
+}
+export async function writeVerifyDiagnostics(path, verify) {
+    const diagnostics = createVerifyDiagnostics(verify);
+    await writeFile(path, `${JSON.stringify(diagnostics, null, 2)}\n`, "utf8");
+    return diagnostics;
+}

package/dist/doctor.js

@@ -0,0 +1,100 @@
+import path from "node:path";
+import { git, pathExists, runCommand } from "./utils.js";
+const agentLabels = ["codex", "claude", "cursor", "gemini"];
+function commandHead(command) {
+    const trimmed = command.trim();
+    const quoted = trimmed.match(/^"([^"]+)"/);
+    if (quoted)
+        return quoted[1];
+    return trimmed.split(/\s+/)[0] ?? "";
+}
+async function commandAvailable(command, cwd) {
+    const head = commandHead(command);
+    if (!head)
+        return false;
+    const probe = process.platform === "win32" ? `where ${head}` : `command -v ${head}`;
+    const result = await runCommand(probe, cwd, undefined, 5000);
+    return result.exitCode === 0;
+}
+function renderStatus(status) {
+    if (status === "ok")
+        return "OK";
+    if (status === "warn")
+        return "WARN";
+    return "FAIL";
+}
+export async function runDoctor(cwd, config) {
+    const checks = [];
+    const isGitRepo = Boolean(await git(cwd, "rev-parse --show-toplevel"));
+    checks.push({
+        name: "Git 仓库",
+        status: isGitRepo ? "ok" : "fail",
+        detail: isGitRepo ? "当前目录是 Git 仓库。" : "当前目录不是 Git 仓库，请在业务仓库根目录运行。"
+    });
+    const gitStatus = isGitRepo ? await git(cwd, "status --short") : "";
+    checks.push({
+        name: "Git 工作区",
+        status: gitStatus ? "warn" : "ok",
+        detail: gitStatus ? "当前存在未提交改动，restore 会拒绝自动恢复运行前已有改动。" : "当前工作区 clean。"
+    });
+    checks.push({
+        name: "harness.yaml",
+        status: (await pathExists(path.join(cwd, "harness.yaml"))) ? "ok" : "fail",
+        detail: (await pathExists(path.join(cwd, "harness.yaml"))) ? "配置文件存在。" : "未找到 harness.yaml，请先运行 harness init。"
+    });
+    const skillNames = ["fix_bug", "add_feature", "write_tests", "update_docs"];
+    const missingSkills = [];
+    for (const skill of skillNames) {
+        if (!(await pathExists(path.join(cwd, "skills", skill, "SKILL.md"))))
+            missingSkills.push(skill);
+    }
+    checks.push({
+        name: "内置 Skills",
+        status: missingSkills.length ? "fail" : "ok",
+        detail: missingSkills.length ? `缺少 Skill：${missingSkills.join(", ")}。` : "内置 Skill 文件完整。"
+    });
+    checks.push({
+        name: "对话集成脚本",
+        status: (await pathExists(path.join(cwd, ".harness", "ai-dev-harness", "scripts", "run-harness.ps1"))) ? "ok" : "warn",
+        detail: (await pathExists(path.join(cwd, ".harness", "ai-dev-harness", "scripts", "run-harness.ps1")))
+            ? "run-harness.ps1 已安装。"
+            : "未找到对话集成脚本；CLI 仍可用，可运行 harness install-integration --agent all。"
+    });
+    for (const agent of agentLabels) {
+        const command = config.agents[agent].command;
+        const available = await commandAvailable(command, cwd);
+        checks.push({
+            name: `${agent} 执行器`,
+            status: available ? "ok" : "warn",
+            detail: available ? `命令可用：${command}` : `命令不可用或不在 PATH：${command}。不用该 agent 可忽略。`
+        });
+    }
+    const mcpUrls = [
+        ["CodeGraph MCP", config.mcp.codegraph.url],
+        ["Knowledge Graph MCP", config.mcp.knowledgeGraph.url]
+    ];
+    for (const [name, url] of mcpUrls) {
+        const isDefaultLocal = /localhost:733[12]/.test(url);
+        checks.push({
+            name,
+            status: url && !isDefaultLocal ? "ok" : "warn",
+            detail: url
+                ? isDefaultLocal
+                    ? `当前仍是默认地址：${url}。本地试点请改成真实 MCP source metadata。`
+                    : `已配置地址：${url}。Harness 只记录 metadata，不主动连接。`
+                : "未配置 MCP 地址。"
+        });
+    }
+    const verifyCommands = config.verify.defaultCommands;
+    const onlyGitStatus = verifyCommands.length === 1 && verifyCommands[0].command === "git status --short";
+    checks.push({
+        name: "验证命令强度",
+        status: onlyGitStatus ? "warn" : "ok",
+        detail: onlyGitStatus
+            ? "当前只有 git status，适合冒烟但验证较弱；试点真实任务建议补充 test/lint/typecheck。"
+            : `已配置 ${verifyCommands.length} 条默认验证命令。`
+    });
+    const failed = checks.some((check) => check.status === "fail");
+    const text = ["AI Dev Harness Doctor", ...checks.map((check) => `- [${renderStatus(check.status)}] ${check.name}: ${check.detail}`)].join("\n");
+    return { checks, failed, text };
+}

package/dist/feedback.js

@@ -0,0 +1,5 @@
+import { appendFile } from "node:fs/promises";
+import { nowIso } from "./utils.js";
+export async function feedbackEvent(feedbackPath, event, detail = {}) {
+    await appendFile(feedbackPath, `${JSON.stringify({ timestamp: nowIso(), event, ...detail })}\n`, "utf8");
+}

package/dist/init.js

@@ -1,29 +1,17 @@
 import path from "node:path";
-import { mkdir } from "node:fs/promises";
-import { rootTemplates, skillTemplates } from "./templates.js";
+import { defaultProjectTemplates, packageRootFromHere } from "./templates.js";
 import { ensureDir, writeFileIfMissing } from "./utils.js";
-export async function initHarness(cwd) {
+export async function initHarness(cwd, packageRoot = packageRootFromHere()) {
     const created = [];
     const skipped = [];
-    for (const [file, content] of Object.entries(rootTemplates)) {
-        const target = path.join(cwd, file);
-        if (await writeFileIfMissing(target, content))
-            created.push(file);
-        else
-            skipped.push(file);
-    }
     await ensureDir(path.join(cwd, "runs"));
     await ensureDir(path.join(cwd, "skills"));
-    for (const [skillName, files] of Object.entries(skillTemplates)) {
-        await mkdir(path.join(cwd, "skills", skillName), { recursive: true });
-        for (const [file, content] of Object.entries(files)) {
-            const rel = path.join("skills", skillName, file);
-            const target = path.join(cwd, rel);
-            if (await writeFileIfMissing(target, content))
-                created.push(rel);
-            else
-                skipped.push(rel);
-        }
+    for (const file of await defaultProjectTemplates(packageRoot)) {
+        const target = path.join(cwd, file.relPath);
+        if (await writeFileIfMissing(target, file.content))
+            created.push(file.relPath);
+        else
+            skipped.push(file.relPath);
     }
     return { created, skipped };
 }