dsh-mnemon-source-skills 0.5.8 → 0.5.10

package/README.md

@@ -61,3 +61,5 @@ The optional `./client` entry is an ordinary DSH Client plugin. This package own
 From a source checkout, install the declared dependencies and run `pnpm verify` to check the Source's behavior, the market's parsers and archive reader, and Source-backed page interactions.
 
 [Plugin development](https://github.com/omdsh-dev/dsh-mnemon/blob/main/docs/en/development/extensions.md) · [中文指南](https://github.com/omdsh-dev/dsh-mnemon/blob/main/docs/zh-CN/development/extensions.md)
+
+The optional Host `skills.autoAdopt` setting is off by default. It queues only new idle-review suggestions, requires complete paired text backtests without per-case or per-check regression, retries at most two rewrites, and uses Source-owned adoption under the storage lock. Source checks the exact draft/cases/results and current file again; cancellation is checked inside queued writes. Automatic activity and manual-review reasons are visible on each suggestion. See the [Skills guide](../../docs/en/guides/skills.md#optional-automatic-adoption) for limits and the distinction from real external-action validation.

package/lib/client.js

@@ -35,7 +35,7 @@ window.__ModuleLoader__.load({
 		function json(value) {
 			return JSON.parse(JSON.stringify(value ?? null));
 		}
-		const CONFLICT = /revision conflict|changed since it was read; reload/u;
+		const CONFLICT = /revision conflict|Skills Source changed since it was read; reload/u;
 		/**
 		* The Source's revision moves with every background review and run, so each
 		* write fetches it first and tries once more if a background write slipped in
@@ -127,6 +127,7 @@ window.__ModuleLoader__.load({
 					id,
 					content
 				}),
+				cancelRun: (id) => mutate("run-cancel", { id }),
 				adoptDraft: (id, root) => mutate("draft-adopt", root === void 0 ? { id } : {
 					id,
 					root
@@ -317,7 +318,9 @@ window.__ModuleLoader__.load({
 			"evolution.noAgent": "当前没有可用的任务 Agent",
 			"evolution.drafting": "正在生成草案",
 			"evolution.draftFailed": "草案生成失败：{error}",
-			"evolution.skillGone": "这个技能已不存在。",
+			"evolution.skillGone": "原技能文件已删除、移动或无法读取。请恢复文件，或在新位置打开技能并重新生成草案。",
+			"evolution.originUnavailable": "旧记录未可靠保存原工作区。请切换到原工作区，在技能页打开该技能并重新生成草案；现有草案和证据会保留。",
+			"evolution.currentSkill": "当前技能文件",
 			"evolution.skillChanged": "技能在建议之后被改过，生成草案前会以当前版本为准。",
 			"evolution.adopted": "已采纳",
 			"evolution.openSkill": "查看技能",
@@ -533,7 +536,34 @@ window.__ModuleLoader__.load({
 			"evolution.loadFailedBody": "请重试，或在左侧选择其他建议。",
 			"tests.model": "全局模型",
 			"tests.modelCard": "所选回测模型",
-			"tests.modelAuto": "跟随默认"
+			"tests.modelAuto": "跟随默认",
+			"draft.baseChanged": "原技能已变更，此草案已过期。请基于当前文件重新生成并回测。",
+			"draft.targetExists": "同名技能已存在。请重新生成为改进草案并回测，再确认采纳。",
+			"draft.refreshGuidance": "基于当前技能文件重新生成，保留最近的修改，并重新运行回测。",
+			"draft.regenerate": "重新生成并回测",
+			"draft.cancelBacktest": "取消回测",
+			"draft.interrupted": "回测已中断。可以重新回测，或在检查草案后手动采纳。",
+			"evolution.auto.title": "自动采纳",
+			"evolution.auto.history": "自动采纳活动记录",
+			"evolution.auto.attempt": "第 {count} 轮",
+			"evolution.auto.scores": "基线 {baseline} / 草案 {draft}",
+			"evolution.auto.stage.queued": "等待处理",
+			"evolution.auto.stage.drafting": "正在起草",
+			"evolution.auto.stage.backtesting": "正在对比回测",
+			"evolution.auto.stage.rewriting": "依据退步结果重写",
+			"evolution.auto.stage.adopted": "已自动采纳",
+			"evolution.auto.stage.paused": "已停止自动处理",
+			"evolution.auto.stage.review": "需要人工审查",
+			"evolution.auto.reason.disabled": "自动采纳或所需权限已关闭",
+			"evolution.auto.reason.no-cases": "没有启用的回测用例",
+			"evolution.auto.reason.case-limit": "启用的用例超过每轮上限；调整用例或上限后手动处理本建议",
+			"evolution.auto.reason.unmeasured": "回测未完整测出所有检查项，或存在图片依赖、错误、中断",
+			"evolution.auto.reason.regressed": "至少一个用例或原先通过的检查项出现退步",
+			"evolution.auto.reason.changed": "建议、草案或用例已变动",
+			"evolution.auto.reason.failed": "自动处理失败，保留人工处理入口",
+			"evolution.auto.reason.queue-full": "自动处理队列已满",
+			"evolution.auto.reason.model-unavailable": "无法确定起草或回测模型",
+			"evolution.auto.reason.interrupted": "Host 已停止，不自动重启此建议"
 		};
 		var en = {
 			"page.title": "Skills",
@@ -671,7 +701,9 @@ window.__ModuleLoader__.load({
 			"evolution.noAgent": "No task Agent is available",
 			"evolution.drafting": "Drafting",
 			"evolution.draftFailed": "Drafting failed: {error}",
-			"evolution.skillGone": "This skill no longer exists.",
+			"evolution.skillGone": "The original skill file was deleted, moved, or cannot be read. Restore it or open the skill at its new location and generate a new draft.",
+			"evolution.originUnavailable": "The original workspace was not recorded reliably. Select its original workspace, open the skill on the Skills page and generate a new draft; the existing draft and evidence are kept.",
+			"evolution.currentSkill": "Current skill file",
 			"evolution.skillChanged": "The skill changed after this suggestion; the draft starts from its current version.",
 			"evolution.adopted": "Adopted",
 			"evolution.openSkill": "Open skill",
@@ -887,7 +919,34 @@ window.__ModuleLoader__.load({
 			"evolution.loadFailedBody": "Retry, or select another suggestion on the left.",
 			"tests.model": "Global model",
 			"tests.modelCard": "Selected model",
-			"tests.modelAuto": "Follow default"
+			"tests.modelAuto": "Follow default",
+			"draft.baseChanged": "The original skill changed. This draft is out of date; regenerate it against the current file and backtest it.",
+			"draft.targetExists": "A skill with this name now exists. Regenerate an update and backtest it before adopting.",
+			"draft.refreshGuidance": "Regenerate against the current skill file, preserving its latest changes, then run backtests.",
+			"draft.regenerate": "Regenerate and backtest",
+			"draft.cancelBacktest": "Cancel backtests",
+			"draft.interrupted": "Backtests were interrupted. Run them again, or review the draft before adopting manually.",
+			"evolution.auto.title": "Automatic adoption",
+			"evolution.auto.history": "Automatic adoption activity",
+			"evolution.auto.attempt": "Attempt {count}",
+			"evolution.auto.scores": "Baseline {baseline} / draft {draft}",
+			"evolution.auto.stage.queued": "Queued",
+			"evolution.auto.stage.drafting": "Drafting",
+			"evolution.auto.stage.backtesting": "Backtesting a pair",
+			"evolution.auto.stage.rewriting": "Rewriting after regression",
+			"evolution.auto.stage.adopted": "Automatically adopted",
+			"evolution.auto.stage.paused": "Automatic work stopped",
+			"evolution.auto.stage.review": "Manual review required",
+			"evolution.auto.reason.disabled": "Automatic adoption or its required permissions were disabled",
+			"evolution.auto.reason.no-cases": "No enabled evaluation cases",
+			"evolution.auto.reason.case-limit": "Enabled cases exceed the per-run limit; adjust cases or the limit and review this suggestion manually",
+			"evolution.auto.reason.unmeasured": "Some checks were not fully measured, or a case needs images, failed or was interrupted",
+			"evolution.auto.reason.regressed": "At least one case or previously passing check regressed",
+			"evolution.auto.reason.changed": "The suggestion, draft or evaluation cases changed",
+			"evolution.auto.reason.failed": "Automatic work failed; manual review remains available",
+			"evolution.auto.reason.queue-full": "Automatic queue is full",
+			"evolution.auto.reason.model-unavailable": "No resolved draft or backtest model",
+			"evolution.auto.reason.interrupted": "Host stopped; this suggestion will not restart automatically"
 		};
 		//#endregion
 		//#region \0source-css:/home/runner/work/dsh-mnemon/dsh-mnemon/plugins/dsh-mnemon-source-skills/presentation/page.module.css.mjs
@@ -3726,6 +3785,7 @@ window.__ModuleLoader__.load({
 					context.refresh();
 				} catch (error) {
 					context.fail(error);
+					context.refresh();
 				} finally {
 					setBusy(false);
 				}
@@ -3748,7 +3808,7 @@ window.__ModuleLoader__.load({
 								className: css.skKicker,
 								children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(ActionTag, { action: suggestion.action }), suggestion.status !== "pending" && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(StatusTag, { status: suggestion.status })]
 							}),
-							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("h3", { children: view.skill === void 0 ? suggestion.skillName : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("h3", { children: view.skill === void 0 || view.skillInCatalog === false ? suggestion.skillName : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
 								type: "button",
 								className: css.skTitleLink,
 								onClick: () => context.navigate({
@@ -3811,12 +3871,13 @@ window.__ModuleLoader__.load({
 					suggestion.rationale !== void 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(Clamp, { text: suggestion.rationale }),
 					suggestion.action === "update" && view.skill === void 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
 						className: css.skWarn,
-						children: t("evolution.skillGone")
+						children: t(view.resolution === "origin-unavailable" ? "evolution.originUnavailable" : "evolution.skillGone")
 					}),
 					suggestion.action === "update" && view.skill !== void 0 && !view.hashCurrent && suggestion.status === "pending" && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
 						className: css.skWarn,
 						children: t("evolution.skillChanged")
 					}),
+					suggestion.autoAdoption !== void 0 && suggestion.autoAdoption.length > 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(AutoAdoptionHistory, { events: suggestion.autoAdoption }),
 					suggestion.status === "drafting" && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(Busy, { label: t("evolution.drafting") }),
 					suggestion.lastError !== void 0 && suggestion.status === "pending" && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
 						className: css.inlineError,
@@ -3832,7 +3893,7 @@ window.__ModuleLoader__.load({
 						children: [
 							t("evolution.adopted"),
 							" ",
-							/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("button", {
+							view.skillInCatalog !== false && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("button", {
 								type: "button",
 								className: css.skLink,
 								onClick: () => context.navigate({
@@ -3843,9 +3904,16 @@ window.__ModuleLoader__.load({
 							})
 						]
 					}),
-					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 						className: css.skFolds,
-						children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(Fold, {
+						children: [view.skill !== void 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(Fold, {
+							title: t("evolution.currentSkill"),
+							meta: t(`root.${view.skill.root}`),
+							children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+								className: css.skMuted,
+								children: view.skill.path
+							}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(SkillMarkdown, { body: view.skill.body })]
+						}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(Fold, {
 							title: t("evolution.evidence"),
 							meta: t("evolution.evidenceMeta", {
 								conversations: references.length,
@@ -3884,7 +3952,7 @@ window.__ModuleLoader__.load({
 									})]
 								}, index);
 							})
-						})
+						})]
 					})
 				]
 			});
@@ -3968,6 +4036,7 @@ window.__ModuleLoader__.load({
 					context.refresh();
 				} catch (error) {
 					context.fail(error);
+					context.refresh();
 				} finally {
 					setBusy(false);
 				}
@@ -3986,16 +4055,22 @@ window.__ModuleLoader__.load({
 				});
 				const started = await context.client.backtest({
 					skillName: draft.skillName,
-					target: { kind: draft.action === "update" ? "current" : "none" }
+					target: {
+						kind: draft.action === "update" ? "current" : "none",
+						...draft.action === "update" ? { draftId: draft.id } : {}
+					}
 				});
 				await context.client.linkRun(draft.id, started.runId);
 			});
-			const redraft = (note) => act(() => context.client.generateDraft({
-				...draft.suggestionId === void 0 ? { skill: draft.skillName } : { suggestionId: draft.suggestionId },
+			const redraft = (note, backtest = false) => act(() => context.client.generateDraft({
+				...backtest ? { backtest: true } : {},
+				draftId: draft.id,
+				...draft.suggestionId === void 0 ? {} : { suggestionId: draft.suggestionId },
 				guidance: note,
 				...route
 			}), () => setRedrafting(null));
 			const ready = draft.status === "ready";
+			const originalAvailable = draft.action !== "update" || view.base !== void 0;
 			const progress = (run) => run === void 0 ? 0 : run.progress.done;
 			const total = (candidate?.progress.total ?? 0) + (baseline?.progress.total ?? 0);
 			const results = /* @__PURE__ */ new Map();
@@ -4029,7 +4104,7 @@ window.__ModuleLoader__.load({
 							/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Button, {
 								variant: "primary",
 								size: "sm",
-								disabled: !context.writable || busy || editing !== null || running,
+								disabled: !context.writable || busy || editing !== null || running || view.conflict !== void 0 || !originalAvailable,
 								onClick: () => regressed ? setConfirmAdopt(true) : void adopt(),
 								children: t("draft.adopt")
 							}),
@@ -4047,13 +4122,27 @@ window.__ModuleLoader__.load({
 								items: [{
 									id: "edit",
 									label: t("draft.edit")
-								}, ...context.client.canAssist("skill-draft") ? [{
+								}, ...originalAvailable && context.client.canAssist("skill-draft") ? [{
 									id: "redraft",
 									label: t("draft.redraft")
 								}] : []]
 							})
 						] })]
 					}),
+					!originalAvailable && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+						className: css.skWarn,
+						children: t(view.resolution === "origin-unavailable" ? "evolution.originUnavailable" : "evolution.skillGone")
+					}),
+					view.conflict !== void 0 && ready && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+						className: css.skWarn,
+						role: "status",
+						children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", { children: t(view.conflict === "target-exists" ? "draft.targetExists" : "draft.baseChanged") }), originalAvailable && context.client.canAssist("skill-draft") && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Button, {
+							size: "sm",
+							disabled: !context.writable || busy || running,
+							onClick: () => void redraft(t("draft.refreshGuidance"), true),
+							children: t("draft.regenerate")
+						})]
+					}),
 					draft.notes !== "" && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(Clamp, { text: draft.notes }),
 					draft.changes.length > 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(MoreList, {
 						items: draft.changes,
@@ -4062,37 +4151,53 @@ window.__ModuleLoader__.load({
 					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 						className: css.skBacktest,
 						"data-tone": regressed ? "bad" : candidateScore !== void 0 && baselineScore !== void 0 && candidateScore > baselineScore ? "good" : void 0,
-						children: [running ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(Busy, { label: t("draft.backtesting", {
-							done: progress(candidate) + progress(baseline),
-							total
-						}) }) : candidateScore !== void 0 && baselineScore !== void 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("button", {
-							type: "button",
-							className: css.skBacktestLine,
-							"aria-expanded": details,
-							onClick: () => setDetails((value) => !value),
-							children: [
-								/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { children: t("draft.backtest") }),
-								/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("strong", { children: [
-									baseline?.target.kind === "none" ? t("draft.withoutSkill") : t("draft.current"),
-									" ",
-									points(baselineScore),
-									" → ",
-									t("draft.candidate"),
-									" ",
-									points(candidateScore)
-								] }),
-								/* @__PURE__ */ (0, react_jsx_runtime.jsx)("em", { children: candidateScore === baselineScore ? t("draft.same") : `${candidateScore > baselineScore ? "+" : "−"}${Math.round(Math.abs(candidateScore - baselineScore) * 100)}` })
-							]
-						}) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
-							className: css.skMuted,
-							children: cases === 0 ? t("draft.noTests") : view.runs.length === 0 ? t("draft.notTested") : t("draft.notComparable")
-						}), !running && (cases ?? 0) > 0 && context.client.canAssist("skill-backtest") && ready && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Button, {
-							variant: "ghost",
-							size: "sm",
-							disabled: !context.writable || busy,
-							onClick: () => void backtest(),
-							children: view.runs.length === 0 ? t("draft.runBacktest") : t("draft.rerun")
-						})]
+						children: [
+							running ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(Busy, { label: t("draft.backtesting", {
+								done: progress(candidate) + progress(baseline),
+								total
+							}) }) : candidateScore !== void 0 && baselineScore !== void 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("button", {
+								type: "button",
+								className: css.skBacktestLine,
+								"aria-expanded": details,
+								onClick: () => setDetails((value) => !value),
+								children: [
+									/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { children: t("draft.backtest") }),
+									/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("strong", { children: [
+										baseline?.target.kind === "none" ? t("draft.withoutSkill") : t("draft.current"),
+										" ",
+										points(baselineScore),
+										" → ",
+										t("draft.candidate"),
+										" ",
+										points(candidateScore)
+									] }),
+									/* @__PURE__ */ (0, react_jsx_runtime.jsx)("em", { children: candidateScore === baselineScore ? t("draft.same") : `${candidateScore > baselineScore ? "+" : "−"}${Math.round(Math.abs(candidateScore - baselineScore) * 100)}` })
+								]
+							}) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+								className: css.skMuted,
+								children: cases === 0 ? t("draft.noTests") : view.runs.length === 0 ? t("draft.notTested") : t("draft.notComparable")
+							}),
+							running && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Button, {
+								variant: "ghost",
+								size: "sm",
+								disabled: !context.writable || busy,
+								onClick: () => void act(async () => {
+									for (const run of view.runs.filter((item) => item.status === "running")) await context.client.cancelRun(run.id);
+								}),
+								children: t("draft.cancelBacktest")
+							}),
+							!running && (candidate?.status === "interrupted" || baseline?.status === "interrupted") && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+								role: "status",
+								children: t("draft.interrupted")
+							}),
+							!running && (cases ?? 0) > 0 && context.client.canAssist("skill-backtest") && ready && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Button, {
+								variant: "ghost",
+								size: "sm",
+								disabled: !context.writable || busy || !originalAvailable,
+								onClick: () => void backtest(),
+								children: view.runs.length === 0 ? t("draft.runBacktest") : t("draft.rerun")
+							})
+						]
 					}),
 					excluded > 0 && !running && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
 						className: css.skMuted,
@@ -4188,6 +4293,35 @@ window.__ModuleLoader__.load({
 				]
 			});
 		}
+		function AutoAdoptionHistory(props) {
+			const t = useT();
+			const latest = props.events[props.events.length - 1];
+			const describe = (event) => /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [
+				t(`evolution.auto.stage.${event.stage}`),
+				event.attempt > 0 ? ` · ${t("evolution.auto.attempt", { count: event.attempt })}` : "",
+				event.reason === void 0 ? "" : ` · ${t(`evolution.auto.reason.${event.reason}`)}`,
+				event.baselineScore === void 0 || event.draftScore === void 0 ? "" : ` · ${t("evolution.auto.scores", {
+					baseline: points(event.baselineScore),
+					draft: points(event.draftScore)
+				})}`,
+				event.detail === void 0 ? "" : ` · ${event.detail}`
+			] });
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("section", {
+				"aria-label": t("evolution.auto.title"),
+				children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("p", { children: [
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("strong", { children: t("evolution.auto.title") }),
+					" · ",
+					describe(latest)
+				] }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(Fold, {
+					title: t("evolution.auto.history"),
+					children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("ol", { children: props.events.map((event, index) => /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("li", { children: [
+						stamp(event.at),
+						" · ",
+						describe(event)
+					] }, index)) })
+				})]
+			});
+		}
 		//#endregion
 		//#region src/contracts.ts
 		const SKILL_ROOT_KINDS = [

package/lib/contracts-CwhbQi-u.js

@@ -0,0 +1,119 @@
+//#region src/auto-adoption.ts
+/** Stable evaluation inputs, excluding presentation timestamps and provenance. Hash at the server boundary. */
+function skillCaseSignature(cases) {
+	return JSON.stringify([...cases].sort((a, b) => a.id < b.id ? -1 : a.id > b.id ? 1 : 0).map((entry) => [
+		entry.id,
+		entry.skillName,
+		entry.title,
+		entry.prompt,
+		entry.context ?? "",
+		entry.enabled,
+		entry.requiresVision === true,
+		entry.checks.map((check) => [
+			check.id,
+			check.text,
+			check.must
+		])
+	]));
+}
+/** Automatic decisions require full matching coverage, not the UI's scored intersection. */
+function compareAutomaticSkillRuns(cases, baseline, draft, casesHash) {
+	const unmeasured = { outcome: "unmeasured" };
+	if (cases.length === 0 || cases.some((entry) => !entry.enabled || entry.requiresVision === true || entry.checks.length === 0)) return unmeasured;
+	const ids = new Set(cases.map((entry) => entry.id));
+	if (ids.size !== cases.length || baseline === void 0 || draft === void 0 || baseline.model === void 0 || draft.model === void 0 || baseline.model.provider !== draft.model.provider || baseline.model.model !== draft.model.model || baseline.model.reasoningEffort !== draft.model.reasoningEffort) return unmeasured;
+	const complete = (run) => {
+		if (run.status !== "completed" || run.casesHash !== casesHash || run.errors || run.caseIds.length !== ids.size || new Set(run.caseIds).size !== ids.size || run.caseIds.some((id) => !ids.has(id)) || run.results.length !== ids.size || run.progress.done !== ids.size || run.progress.total !== ids.size) return;
+		const results = new Map(run.results.map((result) => [result.caseId, result]));
+		if (results.size !== ids.size) return;
+		for (const entry of cases) {
+			const result = results.get(entry.id);
+			if (result === void 0 || result.fullyGraded !== true || result.verdict === "error" || result.unmeasuredReason !== void 0 || result.error !== void 0 || !Number.isFinite(result.score)) return;
+			const checks = new Map(result.checks.map((check) => [check.checkId, check.pass]));
+			if (checks.size !== entry.checks.length || result.checks.length !== checks.size || entry.checks.some((check) => typeof checks.get(check.id) !== "boolean")) return;
+			const weight = entry.checks.reduce((sum, check) => sum + (check.must ? 2 : 1), 0);
+			const score = entry.checks.reduce((sum, check) => sum + (checks.get(check.id) ? check.must ? 2 : 1 : 0), 0) / weight;
+			const verdict = entry.checks.every((check) => !check.must || checks.get(check.id)) ? "pass" : "fail";
+			if (Math.abs(result.score - score) > 1e-8 || result.verdict !== verdict) return;
+		}
+		return results;
+	};
+	const before = complete(baseline);
+	const after = complete(draft);
+	if (before === void 0 || after === void 0) return unmeasured;
+	const baselineScore = cases.reduce((sum, entry) => sum + before.get(entry.id).score, 0) / cases.length;
+	const draftScore = cases.reduce((sum, entry) => sum + after.get(entry.id).score, 0) / cases.length;
+	return {
+		outcome: cases.some((entry) => {
+			const left = before.get(entry.id);
+			const right = after.get(entry.id);
+			const checks = new Map(right.checks.map((check) => [check.checkId, check.pass]));
+			return right.score + 1e-8 < left.score || left.checks.some((check) => check.pass && !checks.get(check.checkId));
+		}) ? "regressed" : "not-worse",
+		baselineScore,
+		draftScore
+	};
+}
+//#endregion
+//#region src/contracts.ts
+const SKILL_ROOT_KINDS = [
+	"project-dsh",
+	"project-agents",
+	"user-dsh",
+	"user-agents"
+];
+const SKILL_ROOT_RANK = {
+	"project-dsh": 100,
+	"project-agents": 200,
+	"user-dsh": 400,
+	"user-agents": 500
+};
+const EVOLUTION_SIGNALS = [
+	"correction",
+	"directive",
+	"tool-failure",
+	"approach-change",
+	"procedure",
+	"skill-gap",
+	"skill-misleading",
+	"success"
+];
+const SUGGESTION_STATUSES = [
+	"pending",
+	"drafting",
+	"review",
+	"adopted",
+	"dismissed",
+	"expired",
+	"invalidated"
+];
+const DEFAULT_SKILLS_POLICY = Object.freeze({
+	allowCreate: true,
+	allowUpdate: true,
+	minConfidence: .6,
+	expiryDays: 7,
+	maxPendingPerSession: 5
+});
+const AUTO_ADOPTION_STAGES = [
+	"queued",
+	"drafting",
+	"backtesting",
+	"rewriting",
+	"adopted",
+	"paused",
+	"review"
+];
+const AUTO_ADOPTION_REASONS = [
+	"disabled",
+	"no-cases",
+	"case-limit",
+	"unmeasured",
+	"regressed",
+	"changed",
+	"failed",
+	"queue-full",
+	"model-unavailable",
+	"interrupted"
+];
+//#endregion
+export { SKILL_ROOT_KINDS as a, compareAutomaticSkillRuns as c, EVOLUTION_SIGNALS as i, skillCaseSignature as l, AUTO_ADOPTION_STAGES as n, SKILL_ROOT_RANK as o, DEFAULT_SKILLS_POLICY as r, SUGGESTION_STATUSES as s, AUTO_ADOPTION_REASONS as t };

package/lib/contracts.d.ts

@@ -20,6 +20,16 @@ interface DetectedSource {
   label: string;
 }
 //#endregion
+//#region src/auto-adoption.d.ts
+/** Stable evaluation inputs, excluding presentation timestamps and provenance. Hash at the server boundary. */
+declare function skillCaseSignature(cases: readonly EvalCase[]): string;
+/** Automatic decisions require full matching coverage, not the UI's scored intersection. */
+declare function compareAutomaticSkillRuns(cases: readonly EvalCase[], baseline: BacktestRun | undefined, draft: BacktestRun | undefined, casesHash: string): {
+  outcome: 'unmeasured' | 'regressed' | 'not-worse';
+  baselineScore?: number;
+  draftScore?: number;
+};
+//#endregion
 //#region src/contracts.d.ts
 /** The DSH skill roots this Source reads and writes, in DSH's precedence order. */
 type SkillRootKind = 'project-dsh' | 'project-agents' | 'user-dsh' | 'user-agents';
@@ -163,6 +173,13 @@ interface EvidenceReference {
 }
 type SuggestionStatus = 'pending' | 'drafting' | 'review' | 'adopted' | 'dismissed' | 'expired' | 'invalidated';
 declare const SUGGESTION_STATUSES: readonly SuggestionStatus[];
+/** A file selected by the Source catalog, independent of the page's storage scope. */
+interface SkillOrigin {
+  path: string;
+  /** The owning project root; absent for user skills. */
+  workspace?: string;
+}
+type SkillResolution = 'available' | 'missing' | 'origin-unavailable';
 interface SkillSuggestion {
   id: string;
   skillName: string;
@@ -177,12 +194,15 @@ interface SkillSuggestion {
   /** For `update`: the SKILL.md the reviewer read, so a later edit invalidates it. */
   skillKey?: string;
   skillFileHash?: string;
+  /** Absent on legacy records; never supplied by the model. */
+  origin?: SkillOrigin;
   sourceSessionId?: string;
   sourceSessionTitle?: string;
   reviewId?: string;
   status: SuggestionStatus;
   draftId?: string;
   lastError?: string;
+  autoAdoption?: AutoAdoptionEvent[];
   createdAt: string;
   updatedAt: string;
   expiresAt: string;
@@ -196,6 +216,8 @@ interface SkillDraft {
   /** For `update`, the SKILL.md hash the draft was written against. */
   baseKey?: string;
   baseHash?: string;
+  /** The file this update replaces; absent on legacy records. */
+  origin?: SkillOrigin;
   /** For `create`, where adopting writes the new bundle. */
   targetRoot?: SkillRootKind;
   content: string;
@@ -281,6 +303,8 @@ interface CaseResult {
   error?: string;
   /** Kept under verdict=error so older readers also exclude it from scores. */
   unmeasuredReason?: 'requires-vision';
+  /** Every expected judge check was explicitly returned; absent on older runs. */
+  fullyGraded?: boolean;
 }
 type RunStatus = 'running' | 'completed' | 'failed' | 'interrupted';
 interface BacktestRun {
@@ -293,6 +317,11 @@ interface BacktestRun {
     total: number;
   };
   caseIds: string[];
+  /** Source-verified case inputs at start; absent on older runs. */
+  casesHash?: string;
+  model?: ModelRoute & {
+    reasoningEffort?: string;
+  };
   results: CaseResult[];
   /** Over the graded cases; absent when none could be graded. */
   passRate?: number;
@@ -319,6 +348,10 @@ interface ReviewLogEntry {
   error?: string;
   /** The conversation turn the reviewed window ended with. */
   turn?: number;
+  autoAdoptions?: Array<AutoAdoptionEvent & {
+    suggestionId: string;
+    skillName: string;
+  }>;
   /** The suggestions this review created or strengthened. */
   suggestionIds?: string[];
 }
@@ -422,6 +455,8 @@ interface ReviewRecordResult {
   reviewId: string;
   trajectoryId?: string;
   suggestionIds: string[];
+  /** Newly inserted ids only; older Sources omit this capability. */
+  createdSuggestionIds?: string[];
   inserted: number;
   updated: number;
   casesAdded: number;
@@ -467,14 +502,20 @@ interface SuggestionView {
   suggestion: SkillSuggestion;
   /** The loaded file is still the one the reviewer read. */
   hashCurrent: boolean;
-  skill?: SkillSummary;
+  skill?: SkillDocument;
+  resolution?: SkillResolution;
+  /** Whether the selected scope's catalog offers this same file for navigation. */
+  skillInCatalog?: boolean;
   draft?: SkillDraft;
   trajectories: TrajectorySummary[];
 }
 interface DraftView {
   draft: SkillDraft;
+  /** File changes need a new draft, never a retry with a newer revision. */
+  conflict?: 'base-changed' | 'target-exists';
   /** The file the draft replaces, as it is now. */
   base?: SkillDocument;
+  resolution?: SkillResolution;
   runs: BacktestRun[];
 }
 /** A string, or the same text per language. */
@@ -622,5 +663,27 @@ interface MarketInstall {
   files: number;
   installedAt: string;
 }
+declare const AUTO_ADOPTION_STAGES: readonly ["queued", "drafting", "backtesting", "rewriting", "adopted", "paused", "review"];
+declare const AUTO_ADOPTION_REASONS: readonly ["disabled", "no-cases", "case-limit", "unmeasured", "regressed", "changed", "failed", "queue-full", "model-unavailable", "interrupted"];
+interface AutoAdoptionEvent {
+  at: string;
+  stage: typeof AUTO_ADOPTION_STAGES[number];
+  attempt: number;
+  reason?: typeof AUTO_ADOPTION_REASONS[number];
+  detail?: string;
+  baselineScore?: number;
+  draftScore?: number;
+}
+type DraftExpectation = {
+  id: string;
+  hash: string;
+} | null;
+interface AutomaticAdoption {
+  attempt: number;
+  draftHash: string;
+  baselineRunId: string;
+  draftRunId: string;
+  casesHash: string;
+}
 //#endregion
-export { BacktestRun, CaseResult, CatalogView, DEFAULT_SKILLS_POLICY, type DetectedSource, DraftPreferences, DraftPreferencesView, DraftStatus, DraftView, EVOLUTION_SIGNALS, EvalCase, EvalCheck, EvidencePack, EvidenceReference, EvolutionSignal, LocalizedText, MarketAudit, MarketEntry, MarketInstall, MarketInstallState, MarketItem, MarketPreview, MarketRegistry, MarketRegistryFile, MarketSearchResult, MarketSource, type MarketSourceKind, MarketView, ModelRoute, ReviewLogEntry, ReviewRecordInput, ReviewRecordResult, ReviewScore, RunStatus, RunTarget, RunTargetKind, SKILL_ROOT_KINDS, SKILL_ROOT_RANK, SUGGESTION_STATUSES, SkillCatalog, SkillDocument, SkillDraft, SkillInvocation, SkillProblem, SkillRoot, SkillRootKind, SkillSuggestion, SkillSummary, SkillVersion, SkillVersionReason, SkillsOverview, SkillsPolicy, SuggestionStatus, SuggestionView, Trajectory, TrajectoryAnnotation, TrajectoryStats, TrajectoryStep, TrajectoryStepKind, TrajectorySummary, TrashEntry, TrashRestoreInput, TrashRestorePreview };
+export { AUTO_ADOPTION_REASONS, AUTO_ADOPTION_STAGES, AutoAdoptionEvent, AutomaticAdoption, BacktestRun, CaseResult, CatalogView, DEFAULT_SKILLS_POLICY, type DetectedSource, DraftExpectation, DraftPreferences, DraftPreferencesView, DraftStatus, DraftView, EVOLUTION_SIGNALS, EvalCase, EvalCheck, EvidencePack, EvidenceReference, EvolutionSignal, LocalizedText, MarketAudit, MarketEntry, MarketInstall, MarketInstallState, MarketItem, MarketPreview, MarketRegistry, MarketRegistryFile, MarketSearchResult, MarketSource, type MarketSourceKind, MarketView, ModelRoute, ReviewLogEntry, ReviewRecordInput, ReviewRecordResult, ReviewScore, RunStatus, RunTarget, RunTargetKind, SKILL_ROOT_KINDS, SKILL_ROOT_RANK, SUGGESTION_STATUSES, SkillCatalog, SkillDocument, SkillDraft, SkillInvocation, SkillOrigin, SkillProblem, SkillResolution, SkillRoot, SkillRootKind, SkillSuggestion, SkillSummary, SkillVersion, SkillVersionReason, SkillsOverview, SkillsPolicy, SuggestionStatus, SuggestionView, Trajectory, TrajectoryAnnotation, TrajectoryStats, TrajectoryStep, TrajectoryStepKind, TrajectorySummary, TrashEntry, TrashRestoreInput, TrashRestorePreview, compareAutomaticSkillRuns, skillCaseSignature };