dsh-plugin-effort-declare 0.1.1 → 0.1.3

package/lib/client.js

@@ -12,9 +12,11 @@ window.__ModuleLoader__.load({
 		*
 		* Levels match `@deepseek-ai/dsh-llm-pi-ai` catalog.ts `THINKING_LEVELS`.
 		* Formats match `SUPPORTED_THINKING_FORMATS` in the same file (rc.8).
-		* Tests pin these lists against llm-pi-ai. The settings page never offers
-		* the handwritten thinkingFormat list as writable choices — only the live
-		* schema union, plus a stored value that the union omitted.
+		* Tests pin these lists against a checked-in schema fixture
+		* (`tests/fixtures/pi-ai-thinking-format-union.ts`) and the local level
+		* whitelist. The settings page never offers the handwritten thinkingFormat
+		* list as writable choices — only the live schema union, plus a stored
+		* value that the union omitted.
 		*/
 		/** Selectable reasoning levels, in pi-ai escalation order. */
 		const THINKING_LEVELS = [
@@ -156,6 +158,14 @@ window.__ModuleLoader__.load({
 		* Route-card draft merge: user-layer slices, namespace revision, dirty preserve.
 		* No React — settings UI and tests share these helpers.
 		*/
+		/** JSON-stable equality matching pathOps (key order included). */
+		function sliceEqual(left, right) {
+			return JSON.stringify(left) === JSON.stringify(right);
+		}
+		/** Whether two settings slices differ. */
+		function sliceChanged(before, after) {
+			return !sliceEqual(before, after);
+		}
 		/** Build a draft from the stored user subtree (never from effective `value`). */
 		function routeDraftFromUserProfile(args) {
 			const { provider, displayName, settingsPath, revision, userProfile } = args;
@@ -210,9 +220,103 @@ window.__ModuleLoader__.load({
 				});
 			});
 		}
+		function modelRowId(row) {
+			return String(row.id);
+		}
+		function indexById(rows) {
+			const map = /* @__PURE__ */ new Map();
+			for (const row of rows) {
+				const id = modelRowId(row);
+				if (!map.has(id)) map.set(id, row);
+			}
+			return map;
+		}
+		function effortsPresence(row) {
+			if (row === void 0 || !Object.hasOwn(row, "reasoningEfforts")) return {
+				present: false,
+				value: void 0
+			};
+			return {
+				present: true,
+				value: row.reasoningEfforts
+			};
+		}
+		function effortsEqual(left, right) {
+			if (left.present !== right.present) return false;
+			if (!left.present) return true;
+			return sliceEqual(left.value, right.value);
+		}
+		function overlayLocalEfforts(incomingRow, prevRow) {
+			const next = structuredClone(incomingRow);
+			if (Object.hasOwn(prevRow, "reasoningEfforts")) next.reasoningEfforts = structuredClone(prevRow.reasoningEfforts);
+			else delete next.reasoningEfforts;
+			return next;
+		}
+		function objectKeyChanged(left, right, key) {
+			const leftHas = Object.hasOwn(left, key);
+			if (leftHas !== Object.hasOwn(right, key)) return true;
+			if (!leftHas) return false;
+			return sliceChanged(left[key], right[key]);
+		}
+		/**
+		* Membership follows the latest user-layer models list (Models page add/delete).
+		* Local unsaved `reasoningEfforts` (including a cleared key) overlay by id.
+		*/
+		function mergeModelsById(args) {
+			const prevById = indexById(args.prevModels);
+			const prevOrigById = indexById(args.prevOriginal);
+			const incomingOrigById = indexById(args.incomingOriginal);
+			const incomingIds = new Set(args.incomingModels.map(modelRowId));
+			let conflicted = false;
+			const models = args.incomingModels.map((incomingRow) => {
+				const id = modelRowId(incomingRow);
+				const prevRow = prevById.get(id);
+				if (prevRow === void 0) return structuredClone(incomingRow);
+				const prevOrig = prevOrigById.get(id);
+				if (!!effortsEqual(effortsPresence(prevRow), effortsPresence(prevOrig))) return structuredClone(incomingRow);
+				const incomingOrig = incomingOrigById.get(id);
+				if (!effortsEqual(effortsPresence(prevOrig), effortsPresence(incomingOrig))) conflicted = true;
+				return overlayLocalEfforts(incomingRow, prevRow);
+			});
+			for (const [id, prevRow] of prevById) {
+				if (incomingIds.has(id)) continue;
+				const prevOrig = prevOrigById.get(id);
+				if (effortsEqual(effortsPresence(prevRow), effortsPresence(prevOrig))) continue;
+				if (!effortsEqual(effortsPresence(prevOrig), effortsPresence(incomingOrigById.get(id)))) conflicted = true;
+			}
+			return {
+				models,
+				conflicted
+			};
+		}
 		/**
-		* Apply a freshly loaded table. Dirty cards keep models/compat; originals and
-		* revision follow the incoming snapshot so a later save is against the new user layer.
+		* Three-way compat merge: locally changed keys stay local; everything else
+		* follows incoming. Conflict only when a locally dirty key also moved in originals.
+		*/
+		function mergeCompat(args) {
+			if (!sliceChanged(args.prev, args.prevOriginal)) return {
+				compat: cloneObject(args.incoming),
+				conflicted: false
+			};
+			const compat = cloneObject(args.incoming);
+			let conflicted = false;
+			const keys = /* @__PURE__ */ new Set([...Object.keys(args.prev), ...Object.keys(args.prevOriginal)]);
+			for (const key of keys) {
+				if (!objectKeyChanged(args.prev, args.prevOriginal, key)) continue;
+				if (objectKeyChanged(args.prevOriginal, args.incomingOriginal, key)) conflicted = true;
+				if (Object.hasOwn(args.prev, key)) compat[key] = structuredClone(args.prev[key]);
+				else delete compat[key];
+			}
+			return {
+				compat,
+				conflicted
+			};
+		}
+		/**
+		* Apply a freshly loaded table. Membership and metadata follow incoming;
+		* unsaved reasoningEfforts / dirty compat keys overlay by id. Conflict only
+		* when a locally dirty field also changed in originals (revision-only bumps
+		* and sibling-card saves do not warn).
 		*/
 		function mergeLoadedDrafts(current, incoming, options) {
 			const currentByProvider = new Map(current.map((draft) => [draft.provider, draft]));
@@ -221,13 +325,27 @@ window.__ModuleLoader__.load({
 				drafts: incoming.map((next) => {
 					const prev = currentByProvider.get(next.provider);
 					if (prev === void 0 || !options.preserveDirty || !draftDirty(prev)) return next;
-					conflicted.push(next.provider);
+					const modelsMerge = mergeModelsById({
+						prevModels: prev.models,
+						prevOriginal: prev.originalModels,
+						incomingModels: next.models,
+						incomingOriginal: next.originalModels
+					});
+					const compatMerge = mergeCompat({
+						prev: prev.compat,
+						prevOriginal: prev.originalCompat,
+						incoming: next.compat,
+						incomingOriginal: next.originalCompat
+					});
+					if (modelsMerge.conflicted || compatMerge.conflicted) conflicted.push(next.provider);
 					return {
-						...prev,
+						provider: next.provider,
 						displayName: next.displayName,
 						settingsPath: next.settingsPath,
 						revision: next.revision,
+						models: modelsMerge.models,
 						originalModels: cloneModels(next.originalModels),
+						compat: compatMerge.compat,
 						originalCompat: cloneObject(next.originalCompat),
 						compatPresent: next.compatPresent
 					};
@@ -271,7 +389,10 @@ window.__ModuleLoader__.load({
 			const next = { ...efforts };
 			delete next.off;
 			if (mode === "empty") next.off = null;
-			else if (mode === "value") next.off = value.trim().length > 0 ? value : "none";
+			else if (mode === "value") {
+				const trimmed = value.trim();
+				next.off = trimmed.length > 0 ? trimmed : "none";
+			}
 			return next;
 		}
 		/** Whether a thinking level (other than Off) is currently declared. */
@@ -410,20 +531,104 @@ window.__ModuleLoader__.load({
 			return validateReasoningEfforts(row.reasoningEfforts);
 		}
 		//#endregion
+		//#region src/core/attribution.ts
+		/**
+		* Plugin footer attribution. Version and end-year are frozen into the client
+		* bundle at pack time; this module only formats the line.
+		*/
+		/** First publication year (LICENSE). Not the user's wall clock. */
+		const COPYRIGHT_FROM = 2026;
+		const COPYRIGHT_HOLDER = "Stardust";
+		/**
+		* `0.1.2 © 2026 Stardust` or `0.1.2 © 2026–2027 Stardust`.
+		* Throws if version is empty or `to < from` — a bad stamp must not render.
+		*/
+		function formatAttribution(version, from, to) {
+			if (version.trim() === "") throw new Error("plugin version must be a non-empty string");
+			if (!Number.isInteger(from) || !Number.isInteger(to) || to < from) throw new Error(`invalid copyright range: ${String(from)}\u2013${String(to)}`);
+			return `${version} \u00a9 ${to === from ? String(from) : `${String(from)}\u2013${String(to)}`} ${COPYRIGHT_HOLDER}`;
+		}
+		//#endregion
+		//#region src/client/build-info.ts
+		/**
+		* Footer line frozen into the client bundle. Do not read the clock or
+		* package.json at DSH startup — host apply is empty and the settings page
+		* runs in the browser.
+		*/
+		const PLUGIN_FOOTER_TEXT = formatAttribution("0.1.3", COPYRIGHT_FROM, 2026);
+		//#endregion
 		//#region src/client/load-drafts.ts
 		function schemaDefaultString(node) {
 			if (!isPlainObject(node) || !isPlainObject(node.meta)) return void 0;
 			return typeof node.meta.default === "string" ? node.meta.default : void 0;
 		}
+		/** Namespace revision on a describe snapshot, if that row exists. */
+		function namespaceRevision(snapshot, ns) {
+			return snapshot.view?.namespaces.find((view) => view.ns === ns)?.revision;
+		}
 		/**
-		* First paint: `ensure()` (reads only from idle). Never treat ensure as refresh.
-		* Callers that must not apply a stale settlement compare generation themselves.
-		*
-		* `formats` is the live schema union only. Empty means the dropdown has no
-		* writable choices (stored values stay visible via `thinkingFormatChoices`).
+		* True when `incoming` is the Host echo of a mutate this page already folded,
+		* or an older revision the snapshot has already passed. `echoed` is undefined
+		* until the first successful write.
 		*/
-		async function loadDrafts(api, describe, schema) {
-			await describe.ensure();
+		function isOwnDocumentEcho(echoed, incoming) {
+			return echoed !== void 0 && incoming <= echoed;
+		}
+		/**
+		* After a preserve-dirty reload: conflicted cards get a conflict notice;
+		* live cards drop leftover conflict/error; saved notices stay; gone cards drop.
+		*/
+		function foldReloadNotices(current, args) {
+			const live = new Set(args.liveProviders);
+			const conflicted = new Set(args.conflicted);
+			const next = {};
+			for (const [provider, notice] of Object.entries(current)) {
+				if (!live.has(provider)) continue;
+				if (conflicted.has(provider)) continue;
+				if (notice.kind === "conflict" || notice.kind === "error") continue;
+				next[provider] = notice;
+			}
+			for (const provider of args.conflicted) next[provider] = args.conflictNotice;
+			return next;
+		}
+		function waitUntil(describe, predicate, signal) {
+			if (signal?.aborted) return Promise.resolve(false);
+			if (predicate()) return Promise.resolve(true);
+			return new Promise((resolve) => {
+				let settled = false;
+				const finish = (ok) => {
+					if (settled) return;
+					settled = true;
+					stop();
+					signal?.removeEventListener("abort", onAbort);
+					resolve(ok);
+				};
+				const onAbort = () => {
+					finish(false);
+				};
+				const stop = describe.subscribe(() => {
+					if (predicate()) finish(true);
+				});
+				signal?.addEventListener("abort", onAbort);
+				if (predicate()) finish(true);
+				else if (signal?.aborted) finish(false);
+			});
+		}
+		/** Resolve when the mirror's namespace revision is at least `revision`, or abort. */
+		async function waitForNamespaceRevision(describe, ns, revision, signal) {
+			return await waitUntil(describe, () => {
+				const current = namespaceRevision(describe.getSnapshot(), ns);
+				return current !== void 0 && current >= revision;
+			}, signal) ? "matched" : "aborted";
+		}
+		/** Resolve when the namespace revision differs from `previous`, or abort. */
+		async function waitForNamespaceRevisionChange(describe, ns, previous, signal) {
+			return await waitUntil(describe, () => {
+				const current = namespaceRevision(describe.getSnapshot(), ns);
+				return current !== void 0 && current !== previous;
+			}, signal) ? "changed" : "aborted";
+		}
+		async function assembleDrafts(api, describe, schema) {
 			const mirrored = describe.getSnapshot();
 			if (mirrored.view === void 0) return {
 				writable: false,
@@ -474,6 +679,14 @@ window.__ModuleLoader__.load({
 				drafts
 			};
 		}
+		/**
+		* `ensure`: first paint / idle recovery (official ensure only reads from idle).
+		* `snapshot`: refresh after the mirror revision already moved — do not ensure.
+		*/
+		async function loadDrafts(api, describe, schema, mode = "ensure") {
+			if (mode === "ensure") await describe.ensure();
+			return assembleDrafts(api, describe, schema);
+		}
 		//#endregion
 		//#region src/client/schema-ops.ts
 		/** Wrap a live settingsSchema service as plain callbacks. */
@@ -506,7 +719,7 @@ window.__ModuleLoader__.load({
 		}
 		//#endregion
 		//#region \0dsh-css:C:\Users\zimo\AppData\Roaming\io.github.hairyf.deepseek-harness-desktop\data\dsh\临时目录\dsh-plugin-effort-declare\src\client\effort-declare.module.css.mjs
-		const cssText = ".hYEBUa_section{max-width:720px;color:var(--dsw-alias-label-primary);flex-direction:column;gap:12px;display:flex}.hYEBUa_title{color:var(--dsw-alias-label-primary);margin:0;font-size:16px;font-weight:500;line-height:24px}.hYEBUa_intro{color:var(--dsw-alias-label-tertiary);margin:0;font-size:14px;line-height:22px}.hYEBUa_notice{color:var(--dsw-alias-state-warn-label);margin:0;font-size:12px;line-height:18px}.hYEBUa_savedNotice{color:var(--dsw-alias-state-success-primary);margin:0;font-size:12px;line-height:18px}.hYEBUa_error{color:var(--dsw-alias-state-error-primary);margin:0;font-size:12px;line-height:18px}.hYEBUa_rows{flex-direction:column;gap:8px;margin:12px 0 0;padding:0;list-style:none;display:flex}.hYEBUa_rowCard{border:1px solid var(--dsw-alias-border-l2);border-radius:12px;flex-direction:column;gap:12px;padding:12px 14px;display:flex}.hYEBUa_rowHead{align-items:baseline;gap:8px;display:flex}.hYEBUa_rowName{color:var(--dsw-alias-label-primary);font-size:14px;font-weight:500;line-height:22px}.hYEBUa_rowTag{border:1px solid var(--dsw-alias-border-l3);color:var(--dsw-alias-label-secondary);border-radius:4px;flex:none;padding:1px 6px;font-size:11px;line-height:16px}.hYEBUa_compatSummary{color:var(--dsw-alias-label-tertiary);margin:0;font-size:12px;line-height:18px}.hYEBUa_presetRow,.hYEBUa_actions{flex-wrap:wrap;align-items:center;gap:8px;display:flex}.hYEBUa_fieldLabel{color:var(--dsw-alias-label-secondary);font-size:12px;font-weight:500;line-height:18px}.hYEBUa_primaryButton,.hYEBUa_secondaryButton{box-sizing:border-box;height:36px;font:inherit;cursor:pointer;border-radius:18px;justify-content:center;align-items:center;padding:0 14px;font-size:14px;line-height:22px;display:inline-flex}.hYEBUa_primaryButton{background:var(--dsw-alias-button-primary-fill);color:var(--dsw-alias-label-primary-foreground);border:none}.hYEBUa_primaryButton:hover:not(:disabled){background:var(--dsw-alias-button-primary-hover)}.hYEBUa_secondaryButton{border:1px solid var(--dsw-alias-border-l2);color:var(--dsw-alias-label-primary);background:0 0}.hYEBUa_secondaryButton:hover:not(:disabled){background:var(--dsw-alias-interactive-bg-hover-solid)}.hYEBUa_primaryButton:disabled,.hYEBUa_secondaryButton:disabled,.hYEBUa_linkButton:disabled,.hYEBUa_input:disabled{opacity:.4;cursor:default}.hYEBUa_primaryButton:focus-visible,.hYEBUa_secondaryButton:focus-visible,.hYEBUa_linkButton:focus-visible,.hYEBUa_input:focus-visible{box-shadow:0 0 0 2px var(--dsw-alias-border-l3);outline:none}.hYEBUa_linkButton{box-sizing:border-box;height:28px;color:var(--dsw-alias-label-tertiary);font:inherit;cursor:pointer;background:0 0;border:none;border-radius:14px;align-items:center;padding:0 10px;font-size:12px;line-height:18px;display:inline-flex}.hYEBUa_linkButton:hover:not(:disabled){background:var(--dsw-alias-interactive-bg-hover);color:var(--dsw-alias-label-secondary)}.hYEBUa_modelEntry{border-top:1px solid var(--dsw-alias-border-l2);flex-direction:column;gap:8px;padding:10px 0;display:flex}.hYEBUa_modelHead{flex-wrap:wrap;align-items:baseline;gap:8px;display:flex}.hYEBUa_modelId{font-size:13px;font-weight:500;line-height:20px}.hYEBUa_modelName{color:var(--dsw-alias-label-tertiary);font-size:12px;line-height:18px}.hYEBUa_levels{flex-wrap:wrap;gap:10px 14px;display:flex}.hYEBUa_level{align-items:center;gap:6px;font-size:12px;line-height:18px;display:inline-flex}.hYEBUa_wireRow{flex-wrap:wrap;align-items:center;gap:8px;display:flex}.hYEBUa_input,.hYEBUa_selectInput{box-sizing:border-box;border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-module-platform);height:32px;color:var(--dsw-alias-label-primary);font:inherit;border-radius:8px;padding:0 10px;font-size:13px}.hYEBUa_wireInput{width:7em}.hYEBUa_offGroup{flex-direction:column;gap:6px;display:flex}.hYEBUa_advanced{border-top:1px solid var(--dsw-alias-border-l2);padding-top:8px}.hYEBUa_advanced summary{cursor:pointer;color:var(--dsw-alias-label-secondary);font-size:12px;line-height:18px}.hYEBUa_advancedBody{flex-direction:column;gap:10px;padding-top:10px;display:flex}.hYEBUa_check{align-items:flex-start;gap:8px;font-size:12px;line-height:18px;display:flex}";
+		const cssText = ".hYEBUa_section{max-width:720px;color:var(--dsw-alias-label-primary);flex-direction:column;gap:12px;display:flex}.hYEBUa_title{color:var(--dsw-alias-label-primary);margin:0;font-size:16px;font-weight:500;line-height:24px}.hYEBUa_intro{color:var(--dsw-alias-label-tertiary);margin:0;font-size:14px;line-height:22px}.hYEBUa_notice{color:var(--dsw-alias-state-warn-label);margin:0;font-size:12px;line-height:18px}.hYEBUa_savedNotice{color:var(--dsw-alias-state-success-primary);margin:0;font-size:12px;line-height:18px}.hYEBUa_error{color:var(--dsw-alias-state-error-primary);margin:0;font-size:12px;line-height:18px}.hYEBUa_rows{flex-direction:column;gap:8px;margin:12px 0 0;padding:0;list-style:none;display:flex}.hYEBUa_rowCard{border:1px solid var(--dsw-alias-border-l2);border-radius:12px;flex-direction:column;gap:12px;padding:12px 14px;display:flex}.hYEBUa_rowHead{align-items:baseline;gap:8px;display:flex}.hYEBUa_rowName{color:var(--dsw-alias-label-primary);font-size:14px;font-weight:500;line-height:22px}.hYEBUa_rowTag{border:1px solid var(--dsw-alias-border-l3);color:var(--dsw-alias-label-secondary);border-radius:4px;flex:none;padding:1px 6px;font-size:11px;line-height:16px}.hYEBUa_compatSummary{color:var(--dsw-alias-label-tertiary);margin:0;font-size:12px;line-height:18px}.hYEBUa_presetRow,.hYEBUa_actions{flex-wrap:wrap;align-items:center;gap:8px;display:flex}.hYEBUa_fieldLabel{color:var(--dsw-alias-label-secondary);font-size:12px;font-weight:500;line-height:18px}.hYEBUa_primaryButton,.hYEBUa_secondaryButton{box-sizing:border-box;height:36px;font:inherit;cursor:pointer;border-radius:18px;justify-content:center;align-items:center;padding:0 14px;font-size:14px;line-height:22px;display:inline-flex}.hYEBUa_primaryButton{background:var(--dsw-alias-button-primary-fill);color:var(--dsw-alias-label-primary-foreground);border:none}.hYEBUa_primaryButton:hover:not(:disabled){background:var(--dsw-alias-button-primary-hover)}.hYEBUa_secondaryButton{border:1px solid var(--dsw-alias-border-l2);color:var(--dsw-alias-label-primary);background:0 0}.hYEBUa_secondaryButton:hover:not(:disabled){background:var(--dsw-alias-interactive-bg-hover-solid)}.hYEBUa_primaryButton:disabled,.hYEBUa_secondaryButton:disabled,.hYEBUa_linkButton:disabled,.hYEBUa_input:disabled{opacity:.4;cursor:default}.hYEBUa_primaryButton:focus-visible,.hYEBUa_secondaryButton:focus-visible,.hYEBUa_linkButton:focus-visible,.hYEBUa_input:focus-visible{box-shadow:0 0 0 2px var(--dsw-alias-border-l3);outline:none}.hYEBUa_linkButton{box-sizing:border-box;height:28px;color:var(--dsw-alias-label-tertiary);font:inherit;cursor:pointer;background:0 0;border:none;border-radius:14px;align-items:center;padding:0 10px;font-size:12px;line-height:18px;display:inline-flex}.hYEBUa_linkButton:hover:not(:disabled){background:var(--dsw-alias-interactive-bg-hover);color:var(--dsw-alias-label-secondary)}.hYEBUa_modelEntry{border-top:1px solid var(--dsw-alias-border-l2);flex-direction:column;gap:8px;padding:10px 0;display:flex}.hYEBUa_modelHead{flex-wrap:wrap;align-items:baseline;gap:8px;display:flex}.hYEBUa_modelId{font-size:13px;font-weight:500;line-height:20px}.hYEBUa_modelName{color:var(--dsw-alias-label-tertiary);font-size:12px;line-height:18px}.hYEBUa_levels{flex-wrap:wrap;gap:10px 14px;display:flex}.hYEBUa_level{align-items:center;gap:6px;font-size:12px;line-height:18px;display:inline-flex}.hYEBUa_wireRow{flex-wrap:wrap;align-items:center;gap:8px;display:flex}.hYEBUa_input,.hYEBUa_selectInput{box-sizing:border-box;border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-module-platform);height:32px;color:var(--dsw-alias-label-primary);font:inherit;border-radius:8px;padding:0 10px;font-size:13px}.hYEBUa_wireInput{width:7em}.hYEBUa_offGroup{flex-direction:column;gap:6px;display:flex}.hYEBUa_advanced{border-top:1px solid var(--dsw-alias-border-l2);padding-top:8px}.hYEBUa_advanced summary{cursor:pointer;color:var(--dsw-alias-label-secondary);font-size:12px;line-height:18px}.hYEBUa_advancedBody{flex-direction:column;gap:10px;padding-top:10px;display:flex}.hYEBUa_check{align-items:flex-start;gap:8px;font-size:12px;line-height:18px;display:flex}.hYEBUa_footer{color:var(--dsw-alias-label-tertiary);opacity:.7;margin:16px 0 0;font-size:11px;line-height:16px}";
 		const cssTagId = "dsh-plugin-effort-declare/effort-declare.module.css";
 		var effort_declare_module_css_default = {
 			"actions": "hYEBUa_actions",
@@ -516,6 +729,7 @@ window.__ModuleLoader__.load({
 			"compatSummary": "hYEBUa_compatSummary",
 			"error": "hYEBUa_error",
 			"fieldLabel": "hYEBUa_fieldLabel",
+			"footer": "hYEBUa_footer",
 			"input": "hYEBUa_input",
 			"intro": "hYEBUa_intro",
 			"level": "hYEBUa_level",
@@ -670,10 +884,10 @@ window.__ModuleLoader__.load({
 			});
 		}
 		function RouteCard(props) {
-			const { draft, writable, busy, reloading, t, onChange } = props;
+			const { draft, writable, busy, saveLocked, t, onChange } = props;
 			const noModels = draft.models.length === 0;
 			const editDisabled = !writable || busy || noModels;
-			const saveLocked = editDisabled || reloading;
+			const saveDisabled = saveLocked || noModels;
 			const formats = thinkingFormatChoices(props.formats, draft.compat.thinkingFormat);
 			const summary = compatSummary(draft.compat);
 			const sameWire = draft.compat.supportsReasoningEffort === false;
@@ -857,7 +1071,7 @@ window.__ModuleLoader__.load({
 						}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
 							type: "button",
 							className: effort_declare_module_css_default.primaryButton,
-							disabled: saveLocked || !dirty || clientError !== void 0,
+							disabled: saveDisabled || !dirty || clientError !== void 0,
 							onClick: () => {
 								props.onSave(draft);
 							},
@@ -881,40 +1095,92 @@ window.__ModuleLoader__.load({
 			const [notices, setNotices] = (0, react.useState)({});
 			const generationRef = (0, react.useRef)(0);
 			const draftsRef = (0, react.useRef)(drafts);
+			const echoedRevisionRef = (0, react.useRef)(void 0);
+			const pendingRevisionRef = (0, react.useRef)(void 0);
+			const busyRouteRef = (0, react.useRef)(null);
+			const abortRef = (0, react.useRef)(null);
 			draftsRef.current = drafts;
-			const reload = (0, react.useCallback)((preserveDirty) => {
+			const applyDrafts = (next) => {
+				const resolved = typeof next === "function" ? next(draftsRef.current) : next;
+				draftsRef.current = resolved;
+				setDrafts(resolved);
+			};
+			const snapshotMode = () => describe === void 0 || describe.getSnapshot().status === "idle" ? "ensure" : "snapshot";
+			const beginGeneration = () => {
+				abortRef.current?.abort();
+				const abort = new AbortController();
+				abortRef.current = abort;
+				return {
+					generation: nextGeneration(generationRef),
+					signal: abort.signal
+				};
+			};
+			const failGeneration = (generation, failure) => {
+				if (!generationIsCurrent(generationRef, generation)) return;
+				setStatus("error");
+				setError(failure instanceof Error ? failure.message : t("loadError"));
+			};
+			const settleReload = (generation, preserveDirty, result) => {
+				if (!generationIsCurrent(generationRef, generation)) return;
+				setWritable(result.writable);
+				setFormats(result.formats);
+				if (result.error !== void 0) {
+					setStatus("error");
+					setError(result.error);
+					return;
+				}
+				const merged = mergeLoadedDrafts(draftsRef.current, result.drafts, { preserveDirty });
+				applyDrafts(merged.drafts);
+				setNotices((current) => foldReloadNotices(current, {
+					conflicted: merged.conflicted,
+					conflictNotice: {
+						kind: "conflict",
+						text: t("dirtyConflict")
+					},
+					liveProviders: merged.drafts.map((draft) => draft.provider)
+				}));
+				setStatus("ready");
+			};
+			const loadSnapshotThenSettle = async (generation, preserveDirty) => {
+				if (api === void 0 || describe === void 0 || schema === void 0) return;
+				if (!generationIsCurrent(generationRef, generation)) return;
+				try {
+					const result = await loadDrafts(api, describe, schema, "snapshot");
+					settleReload(generation, preserveDirty, result);
+				} catch (failure) {
+					failGeneration(generation, failure);
+				}
+			};
+			const reload = (0, react.useCallback)((preserveDirty, mode = "ensure") => {
 				if (api === void 0 || describe === void 0 || schema === void 0) {
 					setStatus("error");
 					setError(t("loadError"));
 					return;
 				}
-				const generation = nextGeneration(generationRef);
-				setStatus("loading");
+				const { generation } = beginGeneration();
+				if (draftsRef.current.length === 0) setStatus("loading");
 				setError("");
-				loadDrafts(api, describe, schema).then((result) => {
-					if (!generationIsCurrent(generationRef, generation)) return;
-					setWritable(result.writable);
-					setFormats(result.formats);
-					if (result.error !== void 0) {
-						setStatus("error");
-						setError(result.error);
-						return;
-					}
-					const merged = mergeLoadedDrafts(draftsRef.current, result.drafts, { preserveDirty });
-					setDrafts(merged.drafts);
-					if (merged.conflicted.length > 0) setNotices((current) => {
-						const next = { ...current };
-						for (const provider of merged.conflicted) next[provider] = {
-							kind: "conflict",
-							text: t("dirtyConflict")
-						};
-						return next;
-					});
-					setStatus("ready");
+				loadDrafts(api, describe, schema, mode).then((result) => {
+					settleReload(generation, preserveDirty, result);
 				}, (failure) => {
-					if (!generationIsCurrent(generationRef, generation)) return;
-					setStatus("error");
-					setError(failure instanceof Error ? failure.message : t("loadError"));
+					failGeneration(generation, failure);
+				});
+			}, [
+				api,
+				describe,
+				schema,
+				t
+			]);
+			const refreshAtRevision = (0, react.useCallback)((revision, preserveDirty) => {
+				if (api === void 0 || describe === void 0 || schema === void 0) return;
+				const { generation, signal } = beginGeneration();
+				if (draftsRef.current.length === 0) setStatus("loading");
+				setError("");
+				waitForNamespaceRevision(describe, LLM_PI_AI_NS, revision, signal).then((outcome) => {
+					if (outcome === "aborted" || !generationIsCurrent(generationRef, generation)) return;
+					return loadSnapshotThenSettle(generation, preserveDirty);
+				}, (failure) => {
+					failGeneration(generation, failure);
 				});
 			}, [
 				api,
@@ -922,15 +1188,46 @@ window.__ModuleLoader__.load({
 				schema,
 				t
 			]);
+			const flushPendingSettings = (refresh) => {
+				const pending = pendingRevisionRef.current;
+				pendingRevisionRef.current = void 0;
+				if (pending === void 0) return;
+				if (isOwnDocumentEcho(echoedRevisionRef.current, pending)) return;
+				refresh(pending, true);
+			};
 			(0, react.useEffect)(() => {
-				reload(false);
+				reload(false, "ensure");
 			}, [reload]);
+			(0, react.useEffect)(() => () => {
+				abortRef.current?.abort();
+				nextGeneration(generationRef);
+			}, []);
 			(0, react.useEffect)(() => {
 				if (props.subscribeInvalidate === void 0) return void 0;
-				return props.subscribeInvalidate((source) => {
-					if (source === "settings" || source === "directory") reload(true);
+				return props.subscribeInvalidate((event) => {
+					if (event.source === "writable") {
+						const view = describe?.getSnapshot().view;
+						if (view !== void 0) setWritable(view.writable);
+						return;
+					}
+					if (event.source === "settings") {
+						if (busyRouteRef.current !== null) {
+							pendingRevisionRef.current = event.revision;
+							return;
+						}
+						if (isOwnDocumentEcho(echoedRevisionRef.current, event.revision)) return;
+						refreshAtRevision(event.revision, true);
+						return;
+					}
+					if (event.source === "directory") reload(true, snapshotMode());
+					if (event.source === "reset") reload(true, "ensure");
 				});
-			}, [props.subscribeInvalidate, reload]);
+			}, [
+				describe,
+				props.subscribeInvalidate,
+				refreshAtRevision,
+				reload
+			]);
 			const patchNotice = (provider, notice) => {
 				setNotices((current) => {
 					const copy = { ...current };
@@ -941,7 +1238,13 @@ window.__ModuleLoader__.load({
 			};
 			const save = async (draft) => {
 				if (api === void 0 || describe === void 0 || schema === void 0) return;
-				if (status === "loading" || busyRoute !== null) return;
+				if (status === "loading" || busyRouteRef.current !== null) {
+					patchNotice(draft.provider, {
+						kind: "error",
+						text: t("saveBusy")
+					});
+					return;
+				}
 				const blocking = draft.models.map((row) => errorText(modelEffortError(row), t)).find((text) => text !== void 0);
 				if (blocking !== void 0) {
 					patchNotice(draft.provider, {
@@ -950,6 +1253,7 @@ window.__ModuleLoader__.load({
 					});
 					return;
 				}
+				busyRouteRef.current = draft.provider;
 				setBusyRoute(draft.provider);
 				patchNotice(draft.provider, void 0);
 				try {
@@ -961,7 +1265,7 @@ window.__ModuleLoader__.load({
 						afterCompat: draft.compat
 					});
 					if (ops.length === 0) {
-						setDrafts((current) => current.map((row) => row.provider === draft.provider ? alignDraft(row) : row));
+						applyDrafts((current) => current.map((row) => row.provider === draft.provider ? alignDraft(row) : row));
 						return;
 					}
 					const willWriteCompat = ops.some((op) => op.path.length > draft.settingsPath.length && op.path[draft.settingsPath.length] === "compat");
@@ -995,12 +1299,21 @@ window.__ModuleLoader__.load({
 							kind: conflict ? "conflict" : "error",
 							text: conflict ? t("conflict") : response.result.error.message
 						});
-						if (conflict) reload(true);
+						if (conflict) {
+							const { generation, signal } = beginGeneration();
+							waitForNamespaceRevisionChange(describe, LLM_PI_AI_NS, draft.revision, signal).then((outcome) => {
+								if (outcome === "aborted" || !generationIsCurrent(generationRef, generation)) return;
+								return loadSnapshotThenSettle(generation, true);
+							}, (failure) => {
+								failGeneration(generation, failure);
+							});
+						}
 						return;
 					}
 					const view = response.result.value;
+					echoedRevisionRef.current = view.revision;
 					describe.acceptView(view);
-					setDrafts((current) => applySaveSuccess(current, draft.provider, {
+					applyDrafts(applySaveSuccess(draftsRef.current, draft.provider, {
 						user: view.user ?? {},
 						revision: view.revision
 					}));
@@ -1014,7 +1327,9 @@ window.__ModuleLoader__.load({
 						text: failure instanceof Error ? failure.message : t("loadError")
 					});
 				} finally {
+					busyRouteRef.current = null;
 					setBusyRoute(null);
+					flushPendingSettings(refreshAtRevision);
 				}
 			};
 			const showLoading = status === "loading" && drafts.length === 0;
@@ -1049,7 +1364,7 @@ window.__ModuleLoader__.load({
 						type: "button",
 						className: effort_declare_module_css_default.secondaryButton,
 						onClick: () => {
-							reload(true);
+							reload(true, snapshotMode());
 						},
 						children: t("reload")
 					}) : null,
@@ -1067,26 +1382,30 @@ window.__ModuleLoader__.load({
 							formats: formats.length > 0 ? formats : [],
 							writable,
 							busy: busyRoute === draft.provider,
-							reloading: status === "loading",
+							saveLocked: !writable || busyRoute !== null || status === "loading",
 							notice: notices[draft.provider],
 							t,
 							onChange: (next) => {
 								patchNotice(next.provider, void 0);
-								setDrafts((current) => current.map((row) => row.provider === next.provider ? next : row));
+								applyDrafts((current) => current.map((row) => row.provider === next.provider ? next : row));
 							},
 							onSave: (next) => {
 								save(next);
 							},
 							onCancel: (next) => {
 								patchNotice(next.provider, void 0);
-								setDrafts((current) => current.map((row) => row.provider === next.provider ? {
+								applyDrafts((current) => current.map((row) => row.provider === next.provider ? {
 									...row,
 									models: cloneModels(row.originalModels),
 									compat: cloneObject(row.originalCompat)
 								} : row));
 							}
 						}, draft.provider))
-					}) : null
+					}) : null,
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+						className: effort_declare_module_css_default.footer,
+						children: PLUGIN_FOOTER_TEXT
+					})
 				]
 			});
 		}
@@ -1104,6 +1423,7 @@ window.__ModuleLoader__.load({
 			readOnly: "当前设置为只读，无法保存。",
 			save: "保存",
 			saving: "保存中…",
+			saveBusy: "另有路由正在保存，请稍候。",
 			cancel: "取消",
 			saved: "已保存。对话选择器会按新的能力声明显示 Effort 行。",
 			conflict: "设置已被其他地方改过，请重新加载后再保存。",
@@ -1146,6 +1466,7 @@ window.__ModuleLoader__.load({
 			readOnly: "Settings are read-only; saving is disabled.",
 			save: "Save",
 			saving: "Saving…",
+			saveBusy: "Another route is saving. Wait, then save this card.",
 			cancel: "Cancel",
 			saved: "Saved. The composer Effort row follows this capability declaration.",
 			conflict: "Settings changed elsewhere. Reload, then save again.",
@@ -1222,22 +1543,25 @@ window.__ModuleLoader__.load({
 			const describe = ctx.settingsScope.describe();
 			const invalidation = /* @__PURE__ */ new Set();
 			ctx.effect(() => {
-				const emit = (source) => {
-					for (const listener of invalidation) listener(source);
+				const emit = (event) => {
+					for (const listener of invalidation) listener(event);
 				};
 				const disposers = [
 					describe.subscribe(() => {
-						emit("settings");
+						emit({ source: "writable" });
 					}),
-					ctx.remote.$on("settings/document-updated", (ns) => {
+					ctx.remote.$on("settings/document-updated", (ns, revision) => {
 						if (ns !== "llm-pi-ai") return;
-						emit("settings");
+						emit({
+							source: "settings",
+							revision
+						});
 					}),
 					ctx.remote.$on("llm/adapters-updated", () => {
-						emit("directory");
+						emit({ source: "directory" });
 					}),
 					ctx.on("connection/reset", () => {
-						emit("directory");
+						emit({ source: "reset" });
 					})
 				];
 				return () => {