dsh-plugin-effort-declare 0.1.1 → 0.1.3

package/lib/types/client/locales.d.ts

@@ -1,7 +1,7 @@
 /**
  * Dictionary namespace for the effort-declare settings section.
  */
-export type EffortDeclareKey = 'nav' | 'title' | 'intro' | 'empty' | 'emptyHint' | 'loadError' | 'loading' | 'readOnly' | 'save' | 'saving' | 'cancel' | 'saved' | 'conflict' | 'dirtyConflict' | 'presets' | 'presetDeepSeek' | 'presetOpenAI' | 'presetToggle' | 'presetToggleWarn' | 'model' | 'levels' | 'wire' | 'offMode' | 'offAbsent' | 'offEmpty' | 'offValue' | 'offValuePlaceholder' | 'clear' | 'advanced' | 'thinkingFormat' | 'thinkingFormatDefault' | 'supportsDeveloperRole' | 'supportsReasoningEffort' | 'developerTrueHint' | 'compatSummary' | 'errorEmpty' | 'errorOffOnly' | 'errorBadWire' | 'noModels' | 'reload';
+export type EffortDeclareKey = 'nav' | 'title' | 'intro' | 'empty' | 'emptyHint' | 'loadError' | 'loading' | 'readOnly' | 'save' | 'saving' | 'saveBusy' | 'cancel' | 'saved' | 'conflict' | 'dirtyConflict' | 'presets' | 'presetDeepSeek' | 'presetOpenAI' | 'presetToggle' | 'presetToggleWarn' | 'model' | 'levels' | 'wire' | 'offMode' | 'offAbsent' | 'offEmpty' | 'offValue' | 'offValuePlaceholder' | 'clear' | 'advanced' | 'thinkingFormat' | 'thinkingFormatDefault' | 'supportsDeveloperRole' | 'supportsReasoningEffort' | 'developerTrueHint' | 'compatSummary' | 'errorEmpty' | 'errorOffOnly' | 'errorBadWire' | 'noModels' | 'reload';
 export declare const NS = "plugin-effort-declare";
 export declare const zh: Record<EffortDeclareKey, string>;
 export declare const en: Record<EffortDeclareKey, string>;

package/lib/types/client/locales.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"locales.d.ts","sourceRoot":"","sources":["../../../src/client/locales.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,gBAAgB,GACxB,KAAK,GACL,OAAO,GACP,OAAO,GACP,OAAO,GACP,WAAW,GACX,WAAW,GACX,SAAS,GACT,UAAU,GACV,MAAM,GACN,QAAQ,GACR,QAAQ,GACR,OAAO,GACP,UAAU,GACV,eAAe,GACf,SAAS,GACT,gBAAgB,GAChB,cAAc,GACd,cAAc,GACd,kBAAkB,GAClB,OAAO,GACP,QAAQ,GACR,MAAM,GACN,SAAS,GACT,WAAW,GACX,UAAU,GACV,UAAU,GACV,qBAAqB,GACrB,OAAO,GACP,UAAU,GACV,gBAAgB,GAChB,uBAAuB,GACvB,uBAAuB,GACvB,yBAAyB,GACzB,mBAAmB,GACnB,eAAe,GACf,YAAY,GACZ,cAAc,GACd,cAAc,GACd,UAAU,GACV,QAAQ,CAAA;AAEZ,eAAO,MAAM,EAAE,0BAA0B,CAAA;AAEzC,eAAO,MAAM,EAAE,EAAE,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAyC/C,CAAA;AAED,eAAO,MAAM,EAAE,EAAE,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAyC/C,CAAA"}
+{"version":3,"file":"locales.d.ts","sourceRoot":"","sources":["../../../src/client/locales.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,gBAAgB,GACxB,KAAK,GACL,OAAO,GACP,OAAO,GACP,OAAO,GACP,WAAW,GACX,WAAW,GACX,SAAS,GACT,UAAU,GACV,MAAM,GACN,QAAQ,GACR,UAAU,GACV,QAAQ,GACR,OAAO,GACP,UAAU,GACV,eAAe,GACf,SAAS,GACT,gBAAgB,GAChB,cAAc,GACd,cAAc,GACd,kBAAkB,GAClB,OAAO,GACP,QAAQ,GACR,MAAM,GACN,SAAS,GACT,WAAW,GACX,UAAU,GACV,UAAU,GACV,qBAAqB,GACrB,OAAO,GACP,UAAU,GACV,gBAAgB,GAChB,uBAAuB,GACvB,uBAAuB,GACvB,yBAAyB,GACzB,mBAAmB,GACnB,eAAe,GACf,YAAY,GACZ,cAAc,GACd,cAAc,GACd,UAAU,GACV,QAAQ,CAAA;AAEZ,eAAO,MAAM,EAAE,0BAA0B,CAAA;AAEzC,eAAO,MAAM,EAAE,EAAE,MAAM,CAAC,gBAAgB,EAAE,MAAM,CA0C/C,CAAA;AAED,eAAO,MAAM,EAAE,EAAE,MAAM,CAAC,gBAAgB,EAAE,MAAM,CA0C/C,CAAA"}

package/lib/types/core/attribution.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 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. */
+export declare const COPYRIGHT_FROM = 2026;
+export declare 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.
+ */
+export declare function formatAttribution(version: string, from: number, to: number): string;
+//# sourceMappingURL=attribution.d.ts.map

package/lib/types/core/attribution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attribution.d.ts","sourceRoot":"","sources":["../../../src/core/attribution.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,mEAAmE;AACnE,eAAO,MAAM,cAAc,OAAO,CAAA;AAElC,eAAO,MAAM,gBAAgB,aAAa,CAAA;AAE1C;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CASnF"}

package/lib/types/core/catalog.d.ts

@@ -3,9 +3,11 @@
  *
  * 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. */
 export declare const THINKING_LEVELS: readonly ["off", "minimal", "low", "medium", "high", "xhigh", "max"];

package/lib/types/core/catalog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../../src/core/catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,8DAA8D;AAC9D,eAAO,MAAM,eAAe,sEAQlB,CAAA;AAEV,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAA;AAE5D,yEAAyE;AACzE,eAAO,MAAM,2BAA2B,6DAEvC,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,yBAAyB,gJAW5B,CAAA;AAEV,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,yBAAyB,CAAC,CAAC,MAAM,CAAC,CAAA;AAEvE,sDAAsD;AACtD,eAAO,MAAM,kBAAkB,uBAAuB,CAAA;AAEtD,6CAA6C;AAC7C,eAAO,MAAM,YAAY,cAAc,CAAA;AAEvC,kDAAkD;AAClD,eAAO,MAAM,eAAe,iBAAiB,CAAA;AAE7C,+CAA+C;AAC/C,eAAO,MAAM,iBAAiB,sBAAsB,CAAA;AAEpD,kEAAkE;AAClE,eAAO,MAAM,kBAAkB,YAAgB,CAAA"}
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../../src/core/catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,8DAA8D;AAC9D,eAAO,MAAM,eAAe,sEAQlB,CAAA;AAEV,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAA;AAE5D,yEAAyE;AACzE,eAAO,MAAM,2BAA2B,6DAEvC,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,yBAAyB,gJAW5B,CAAA;AAEV,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,yBAAyB,CAAC,CAAC,MAAM,CAAC,CAAA;AAEvE,sDAAsD;AACtD,eAAO,MAAM,kBAAkB,uBAAuB,CAAA;AAEtD,6CAA6C;AAC7C,eAAO,MAAM,YAAY,cAAc,CAAA;AAEvC,kDAAkD;AAClD,eAAO,MAAM,eAAe,iBAAiB,CAAA;AAE7C,+CAA+C;AAC/C,eAAO,MAAM,iBAAiB,sBAAsB,CAAA;AAEpD,kEAAkE;AAClE,eAAO,MAAM,kBAAkB,YAAgB,CAAA"}

package/lib/types/core/drafts.d.ts

@@ -13,6 +13,10 @@ export interface RouteDraft {
     /** Whether `compat` is present on the user profile (not the effective view). */
     compatPresent: boolean;
 }
+/** JSON-stable equality matching pathOps (key order included). */
+export declare function sliceEqual(left: unknown, right: unknown): boolean;
+/** Whether two settings slices differ. */
+export declare function sliceChanged(before: unknown, after: unknown): boolean;
 /** Build a draft from the stored user subtree (never from effective `value`). */
 export declare function routeDraftFromUserProfile(args: {
     provider: string;
@@ -31,8 +35,36 @@ export declare function applySaveSuccess(drafts: readonly RouteDraft[], savedPro
     revision: number;
 }): RouteDraft[];
 /**
- * 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.
+ * Membership follows the latest user-layer models list (Models page add/delete).
+ * Local unsaved `reasoningEfforts` (including a cleared key) overlay by id.
+ */
+export declare function mergeModelsById(args: {
+    prevModels: readonly Record<string, unknown>[];
+    prevOriginal: readonly Record<string, unknown>[];
+    incomingModels: readonly Record<string, unknown>[];
+    incomingOriginal: readonly Record<string, unknown>[];
+}): {
+    models: Record<string, unknown>[];
+    conflicted: boolean;
+};
+/**
+ * Three-way compat merge: locally changed keys stay local; everything else
+ * follows incoming. Conflict only when a locally dirty key also moved in originals.
+ */
+export declare function mergeCompat(args: {
+    prev: Record<string, unknown>;
+    prevOriginal: Record<string, unknown>;
+    incoming: Record<string, unknown>;
+    incomingOriginal: Record<string, unknown>;
+}): {
+    compat: Record<string, unknown>;
+    conflicted: boolean;
+};
+/**
+ * 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).
  */
 export declare function mergeLoadedDrafts(current: readonly RouteDraft[], incoming: readonly RouteDraft[], options: {
     preserveDirty: boolean;

package/lib/types/core/drafts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"drafts.d.ts","sourceRoot":"","sources":["../../../src/core/drafts.ts"],"names":[],"mappings":"AAQA,iEAAiE;AACjE,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,EAAE,MAAM,CAAA;IACnB,0EAA0E;IAC1E,YAAY,EAAE,SAAS,MAAM,EAAE,CAAA;IAC/B,uEAAuE;IACvE,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAA;IACjC,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAA;IACzC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC/B,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACvC,gFAAgF;IAChF,aAAa,EAAE,OAAO,CAAA;CACvB;AAED,iFAAiF;AACjF,wBAAgB,yBAAyB,CAAC,IAAI,EAAE;IAC9C,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,SAAS,MAAM,EAAE,CAAA;IAC/B,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,EAAE,OAAO,CAAA;CACrB,GAAG,UAAU,CAgBb;AAED,wEAAwE;AACxE,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAQrD;AAED,+EAA+E;AAC/E,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,CAOxD;AAED,4FAA4F;AAC5F,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,SAAS,UAAU,EAAE,EAC7B,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACzC,UAAU,EAAE,CAcd;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,SAAS,UAAU,EAAE,EAC9B,QAAQ,EAAE,SAAS,UAAU,EAAE,EAC/B,OAAO,EAAE;IAAE,aAAa,EAAE,OAAO,CAAA;CAAE,GAClC;IAAE,MAAM,EAAE,UAAU,EAAE,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE,CAkBhD;AAED,+EAA+E;AAC/E,wBAAgB,cAAc,CAAC,MAAM,EAAE;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAGlE;AAED,6DAA6D;AAC7D,wBAAgB,mBAAmB,CAAC,MAAM,EAAE;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAE5F;AAED,gFAAgF;AAChF,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,EAAE,CAK5F"}
+{"version":3,"file":"drafts.d.ts","sourceRoot":"","sources":["../../../src/core/drafts.ts"],"names":[],"mappings":"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"}

package/lib/types/core/efforts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"efforts.d.ts","sourceRoot":"","sources":["../../../src/core/efforts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,aAAa,EAAE,MAAM,cAAc,CAAA;AAElE,uEAAuE;AACvE,MAAM,MAAM,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC,CAAA;AAE5E,mEAAmE;AACnE,MAAM,MAAM,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,OAAO,CAAA;AAElD,MAAM,MAAM,qBAAqB,GAAG,gBAAgB,GAAG,KAAK,GAAG,SAAS,CAAA;AAExE,kDAAkD;AAClD,wBAAgB,OAAO,CAAC,OAAO,EAAE,gBAAgB,GAAG,SAAS,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAM/F;AAED,wEAAwE;AACxE,wBAAgB,QAAQ,CACtB,OAAO,EAAE,gBAAgB,EACzB,IAAI,EAAE,OAAO,EACb,KAAK,EAAE,MAAM,GACZ,gBAAgB,CAMlB;AAED,uEAAuE;AACvE,wBAAgB,QAAQ,CAAC,OAAO,EAAE,gBAAgB,GAAG,SAAS,EAAE,KAAK,EAAE,OAAO,CAAC,aAAa,EAAE,KAAK,CAAC,GAAG,OAAO,CAE7G;AAED,+EAA+E;AAC/E,wBAAgB,WAAW,CACzB,OAAO,EAAE,gBAAgB,EACzB,KAAK,EAAE,OAAO,CAAC,aAAa,EAAE,KAAK,CAAC,EACpC,OAAO,EAAE,OAAO,EAChB,IAAI,CAAC,EAAE,MAAM,GACZ,gBAAgB,CAKlB;AAED,0DAA0D;AAC1D,wBAAgB,eAAe,CAC7B,OAAO,EAAE,gBAAgB,EACzB,KAAK,EAAE,OAAO,CAAC,aAAa,EAAE,KAAK,CAAC,EACpC,IAAI,EAAE,MAAM,GACX,gBAAgB,CAGlB;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,CAwBxG;AAED,sEAAsE;AACtE,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAI3F;AAED,2FAA2F;AAC3F,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,gBAAgB,GAAG,SAAS,CAKtF;AAED,wDAAwD;AACxD,wBAAgB,YAAY,CAC1B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,OAAO,EAAE,gBAAgB,GAAG,SAAS,GACpC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQzB"}
+{"version":3,"file":"efforts.d.ts","sourceRoot":"","sources":["../../../src/core/efforts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,aAAa,EAAE,MAAM,cAAc,CAAA;AAElE,uEAAuE;AACvE,MAAM,MAAM,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC,CAAA;AAE5E,mEAAmE;AACnE,MAAM,MAAM,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,OAAO,CAAA;AAElD,MAAM,MAAM,qBAAqB,GAAG,gBAAgB,GAAG,KAAK,GAAG,SAAS,CAAA;AAExE,kDAAkD;AAClD,wBAAgB,OAAO,CAAC,OAAO,EAAE,gBAAgB,GAAG,SAAS,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAM/F;AAED,wEAAwE;AACxE,wBAAgB,QAAQ,CACtB,OAAO,EAAE,gBAAgB,EACzB,IAAI,EAAE,OAAO,EACb,KAAK,EAAE,MAAM,GACZ,gBAAgB,CASlB;AAED,uEAAuE;AACvE,wBAAgB,QAAQ,CAAC,OAAO,EAAE,gBAAgB,GAAG,SAAS,EAAE,KAAK,EAAE,OAAO,CAAC,aAAa,EAAE,KAAK,CAAC,GAAG,OAAO,CAE7G;AAED,+EAA+E;AAC/E,wBAAgB,WAAW,CACzB,OAAO,EAAE,gBAAgB,EACzB,KAAK,EAAE,OAAO,CAAC,aAAa,EAAE,KAAK,CAAC,EACpC,OAAO,EAAE,OAAO,EAChB,IAAI,CAAC,EAAE,MAAM,GACZ,gBAAgB,CAKlB;AAED,0DAA0D;AAC1D,wBAAgB,eAAe,CAC7B,OAAO,EAAE,gBAAgB,EACzB,KAAK,EAAE,OAAO,CAAC,aAAa,EAAE,KAAK,CAAC,EACpC,IAAI,EAAE,MAAM,GACX,gBAAgB,CAGlB;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,CAwBxG;AAED,sEAAsE;AACtE,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAI3F;AAED,2FAA2F;AAC3F,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,gBAAgB,GAAG,SAAS,CAKtF;AAED,wDAAwD;AACxD,wBAAgB,YAAY,CAC1B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,OAAO,EAAE,gBAAgB,GAAG,SAAS,GACpC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQzB"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-plugin-effort-declare",
   "description": "Settings page to declare per-model reasoningEfforts and openai-completions compat on hand-declared llm-pi-ai routes. Writes the official namespace; does not intercept llm/stream or replace the Models page.",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "private": false,
   "license": "MIT",
   "repository": {

package/src/README.en.md

@@ -16,7 +16,7 @@ Install: [INSTALL.en.md](../INSTALL.en.md). Usage: root [README.en.md](../README
 | Path | Role |
 | --- | --- |
 | [`index.ts`](./index.ts) | Host entry. Exports `name` and `apply`. v1 registers no host services or adapters; the bundle still needs this entry so `dsh plugin add` can load the package. |
-| [`core/`](./core/) | UI-free pure functions: efforts, presets, save ops, draft merge, route filtering. Shared by the client and tests; the v1 host entry does not import them (`tsconfig.host` still compiles `core` for types). |
+| [`core/`](./core/) | UI-free pure functions: efforts, presets, save ops, draft merge, route filtering, footer attribution. Shared by the client and tests; the v1 host entry does not import them (`tsconfig.host` still compiles `core` for types). |
 | [`client/`](./client/) | Browser half: locale, settings page, `settings.mutate` against `llm-pi-ai`. |
 | [`css-modules.d.ts`](./css-modules.d.ts) | Types for `*.module.css` (class map plus `cssText` / `cssTagId`). |
 

package/src/README.md

@@ -16,7 +16,7 @@
 | 路径 | 说明 |
 | --- | --- |
 | [`index.ts`](./index.ts) | Host 入口。导出 `name` 与 `apply`。v1 不注册 host 服务、不挂适配器；组合包仍需要这一入口才能被 `dsh plugin add` 加载。 |
-| [`core/`](./core/) | 与 UI 无关的纯函数：档位、预设、保存 ops、草稿合并、路由过滤。client 与单测共用；Host 入口 v1 不引用这些函数（`tsconfig.host` 仍编译 `core` 以产出类型）。 |
+| [`core/`](./core/) | 与 UI 无关的纯函数：档位、预设、保存 ops、草稿合并、路由过滤、页脚归因格式。client 与单测共用；Host 入口 v1 不引用这些函数（`tsconfig.host` 仍编译 `core` 以产出类型）。 |
 | [`client/`](./client/) | 浏览器半区：locale、设置页、对 `llm-pi-ai` 的 `settings.mutate`。 |
 | [`css-modules.d.ts`](./css-modules.d.ts) | `*.module.css` 模块类型（class map + `cssText` / `cssTagId`）。 |
 

package/src/client/EffortDeclareSection.tsx

@@ -30,18 +30,32 @@ import { applyPresetCompat, applyPresetEfforts, PRESETS, type PresetId } from '.
 import { buildSaveOps } from '../core/path-ops.ts'
 import { cloneModels, cloneObject } from '../core/paths.ts'
 import { modelEffortError } from '../core/validate.ts'
-import { loadDrafts } from './load-drafts.ts'
+import { PLUGIN_FOOTER_TEXT } from './build-info.ts'
+import {
+  foldReloadNotices,
+  isOwnDocumentEcho,
+  loadDrafts,
+  waitForNamespaceRevision,
+  waitForNamespaceRevisionChange,
+  type LoadDraftsMode,
+} from './load-drafts.ts'
 import { validateSaveDraft, type SchemaOps } from './schema-ops.ts'
 import type { EffortDeclareKey } from './locales.ts'
 import css from './effort-declare.module.css'
 
-export type InvalidationSource = 'settings' | 'directory'
+export type InvalidationSource = 'settings' | 'directory' | 'reset' | 'writable'
+
+export type Invalidation =
+  | { source: 'writable' }
+  | { source: 'directory' }
+  | { source: 'reset' }
+  | { source: 'settings'; revision: number }
 
 export interface EffortDeclareSectionInjected {
   api: Pick<IApiClient, 'settings' | 'llm'>
   describe: SettingsDescribeFace
   schema: SchemaOps
-  subscribeInvalidate: (listener: (source: InvalidationSource) => void) => () => void
+  subscribeInvalidate: (listener: (event: Invalidation) => void) => () => void
 }
 
 export interface EffortDeclareSectionProps extends Partial<EffortDeclareSectionInjected> {
@@ -165,18 +179,20 @@ function RouteCard(props: {
   draft: RouteDraft
   formats: readonly string[]
   writable: boolean
+  /** This card is the in-flight mutate — show “Saving…”. */
   busy: boolean
-  reloading: boolean
+  /** Namespace-level lock: any mutate, read-only, or first load. */
+  saveLocked: boolean
   notice: CardNotice | undefined
   t: (key: EffortDeclareKey) => string
   onChange: (draft: RouteDraft) => void
   onSave: (draft: RouteDraft) => void
   onCancel: (draft: RouteDraft) => void
 }): ReactNode {
-  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
@@ -302,7 +318,7 @@ function RouteCard(props: {
         <button
           type="button"
           className={css.primaryButton}
-          disabled={saveLocked || !dirty || clientError !== undefined}
+          disabled={saveDisabled || !dirty || clientError !== undefined}
           onClick={() => { props.onSave(draft) }}
         >
           {busy ? t('saving') : t('save')}
@@ -326,53 +342,133 @@ export function EffortDeclareSection(props: EffortDeclareSectionProps): ReactNod
   const [notices, setNotices] = useState<Record<string, CardNotice>>({})
   const generationRef = useRef(0)
   const draftsRef = useRef(drafts)
+  const echoedRevisionRef = useRef<number | undefined>(undefined)
+  const pendingRevisionRef = useRef<number | undefined>(undefined)
+  const busyRouteRef = useRef<string | null>(null)
+  const abortRef = useRef<AbortController | null>(null)
   draftsRef.current = drafts
 
-  const reload = useCallback((preserveDirty: boolean): void => {
+  const applyDrafts = (next: RouteDraft[] | ((current: RouteDraft[]) => RouteDraft[])): void => {
+    const resolved = typeof next === 'function' ? next(draftsRef.current) : next
+    draftsRef.current = resolved
+    setDrafts(resolved)
+  }
+
+  const snapshotMode = (): LoadDraftsMode => (
+    describe === undefined || describe.getSnapshot().status === 'idle' ? 'ensure' : 'snapshot'
+  )
+
+  const beginGeneration = (): { generation: number; signal: AbortSignal } => {
+    abortRef.current?.abort()
+    const abort = new AbortController()
+    abortRef.current = abort
+    return { generation: nextGeneration(generationRef), signal: abort.signal }
+  }
+
+  const failGeneration = (generation: number, failure: unknown): void => {
+    if (!generationIsCurrent(generationRef, generation)) return
+    setStatus('error')
+    setError(failure instanceof Error ? failure.message : t('loadError'))
+  }
+
+  const settleReload = (
+    generation: number,
+    preserveDirty: boolean,
+    result: Awaited<ReturnType<typeof loadDrafts>>,
+  ): void => {
+    if (!generationIsCurrent(generationRef, generation)) return
+    setWritable(result.writable)
+    setFormats(result.formats)
+    if (result.error !== undefined) {
+      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: number, preserveDirty: boolean): Promise<void> => {
+    if (api === undefined || describe === undefined || schema === undefined) 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 = useCallback((preserveDirty: boolean, mode: LoadDraftsMode = 'ensure'): void => {
     if (api === undefined || describe === undefined || schema === undefined) {
       setStatus('error')
       setError(t('loadError'))
       return
     }
-    const generation = nextGeneration(generationRef)
-    setStatus('loading')
+    const { generation } = beginGeneration()
+    if (draftsRef.current.length === 0) setStatus('loading')
     setError('')
-    void loadDrafts(api, describe, schema).then((result) => {
-      if (!generationIsCurrent(generationRef, generation)) return
-      setWritable(result.writable)
-      setFormats(result.formats)
-      if (result.error !== undefined) {
-        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')
+    void loadDrafts(api, describe, schema, mode).then((result) => {
+      settleReload(generation, preserveDirty, result)
     }, (failure: unknown) => {
-      if (!generationIsCurrent(generationRef, generation)) return
-      setStatus('error')
-      setError(failure instanceof Error ? failure.message : t('loadError'))
+      failGeneration(generation, failure)
     })
   }, [api, describe, schema, t])
 
-  useEffect(() => { reload(false) }, [reload])
+  const refreshAtRevision = useCallback((revision: number, preserveDirty: boolean): void => {
+    if (api === undefined || describe === undefined || schema === undefined) return
+    const { generation, signal } = beginGeneration()
+    if (draftsRef.current.length === 0) setStatus('loading')
+    setError('')
+    void waitForNamespaceRevision(describe, LLM_PI_AI_NS, revision, signal).then((outcome) => {
+      if (outcome === 'aborted' || !generationIsCurrent(generationRef, generation)) return
+      return loadSnapshotThenSettle(generation, preserveDirty)
+    }, (failure: unknown) => {
+      failGeneration(generation, failure)
+    })
+  }, [api, describe, schema, t])
+
+  const flushPendingSettings = (refresh: (revision: number, preserveDirty: boolean) => void): void => {
+    const pending = pendingRevisionRef.current
+    pendingRevisionRef.current = undefined
+    if (pending === undefined) return
+    if (isOwnDocumentEcho(echoedRevisionRef.current, pending)) return
+    refresh(pending, true)
+  }
+
+  useEffect(() => { reload(false, 'ensure') }, [reload])
+  useEffect(() => () => {
+    abortRef.current?.abort()
+    nextGeneration(generationRef)
+  }, [])
 
   useEffect(() => {
     if (props.subscribeInvalidate === undefined) return undefined
-    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 !== undefined) 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: string, notice: CardNotice | undefined): void => {
     setNotices(current => {
@@ -385,7 +481,10 @@ export function EffortDeclareSection(props: EffortDeclareSectionProps): ReactNod
 
   const save = async (draft: RouteDraft): Promise<void> => {
     if (api === undefined || describe === undefined || schema === undefined) 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 !== undefined)
@@ -393,6 +492,7 @@ export function EffortDeclareSection(props: EffortDeclareSectionProps): ReactNod
       patchNotice(draft.provider, { kind: 'error', text: blocking })
       return
     }
+    busyRouteRef.current = draft.provider
     setBusyRoute(draft.provider)
     patchNotice(draft.provider, undefined)
     try {
@@ -404,7 +504,7 @@ export function EffortDeclareSection(props: EffortDeclareSectionProps): ReactNod
         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 => (
@@ -444,12 +544,21 @@ export function EffortDeclareSection(props: EffortDeclareSectionProps): ReactNod
           kind: conflict ? 'conflict' : 'error',
           text: conflict ? t('conflict') : response.result.error.message,
         })
-        if (conflict) reload(true)
+        if (conflict) {
+          const { generation, signal } = beginGeneration()
+          void waitForNamespaceRevisionChange(describe, LLM_PI_AI_NS, draft.revision, signal).then((outcome) => {
+            if (outcome === 'aborted' || !generationIsCurrent(generationRef, generation)) return
+            return loadSnapshotThenSettle(generation, true)
+          }, (failure: unknown) => {
+            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,
       }))
@@ -460,7 +569,9 @@ export function EffortDeclareSection(props: EffortDeclareSectionProps): ReactNod
         text: failure instanceof Error ? failure.message : t('loadError'),
       })
     } finally {
+      busyRouteRef.current = null
       setBusyRoute(null)
+      flushPendingSettings(refreshAtRevision)
     }
   }
 
@@ -481,7 +592,7 @@ export function EffortDeclareSection(props: EffortDeclareSectionProps): ReactNod
       {status === 'error' ? <p className={css.error}>{error}</p> : null}
       {showReload
         ? (
-          <button type="button" className={css.secondaryButton} onClick={() => { reload(true) }}>{t('reload')}</button>
+          <button type="button" className={css.secondaryButton} onClick={() => { reload(true, snapshotMode()) }}>{t('reload')}</button>
         )
         : null}
       {showEmpty
@@ -502,17 +613,17 @@ export function EffortDeclareSection(props: EffortDeclareSectionProps): ReactNod
                 formats={formats.length > 0 ? formats : []}
                 writable={writable}
                 busy={busyRoute === draft.provider}
-                reloading={status === 'loading'}
+                saveLocked={!writable || busyRoute !== null || status === 'loading'}
                 notice={notices[draft.provider]}
                 t={t}
                 onChange={(next) => {
                   patchNotice(next.provider, undefined)
-                  setDrafts(current => current.map(row => row.provider === next.provider ? next : row))
+                  applyDrafts(current => current.map(row => row.provider === next.provider ? next : row))
                 }}
                 onSave={(next) => { void save(next) }}
                 onCancel={(next) => {
                   patchNotice(next.provider, undefined)
-                  setDrafts(current => current.map(row => row.provider === next.provider
+                  applyDrafts(current => current.map(row => row.provider === next.provider
                     ? {
                         ...row,
                         models: cloneModels(row.originalModels),
@@ -525,6 +636,7 @@ export function EffortDeclareSection(props: EffortDeclareSectionProps): ReactNod
           </ul>
         )
         : null}
+      <p className={css.footer}>{PLUGIN_FOOTER_TEXT}</p>
     </div>
   )
 }

package/src/client/README.en.md

@@ -17,9 +17,11 @@ Cross-plugin work uses Cordis services only (`connection`, `settingsScope`, `set
 
 | File | Role |
 | --- | --- |
-| [`index.ts`](./index.ts) | Registers zh/en copy, CSS (`ctx.effect` insert/remove), and `settings.section` (id `effort-declare`, order 12). Subscribes in `apply` to the mirror `describe.subscribe`, `settings/document-updated` (`llm-pi-ai` only), `llm/adapters-updated`, and `connection/reset`. `locale: NS` lets the framework inject `t`; `inject` only returns `api` / `describe` / `schema` / `subscribeInvalidate`. |
-| [`EffortDeclareSection.tsx`](./EffortDeclareSection.tsx) | Route cards, presets, Off tri-state, advanced protocol switches, save and cancel. |
-| [`load-drafts.ts`](./load-drafts.ts) | Builds drafts from `llm.providers` + the settings mirror; drafts come from `user`, protocol classification may use `value`. `thinkingFormat` choices come only from the live schema union. |
+| [`index.ts`](./index.ts) | Registers zh/en copy, CSS (`ctx.effect` insert/remove), and `settings.section` (id `effort-declare`, order 12). `describe.subscribe` only syncs `writable` (it fires for every namespace, including this page’s own `acceptView`). `settings/document-updated` (`llm-pi-ai` only) carries the Host revision; the section skips its own mutate echo, waits until the mirror revision has **caught up**, then `getSnapshot()` — it does not use `ensure()` as refresh. Provider directory changes come from `llm/adapters-updated`; `connection/reset` uses `ensure()` so an in-flight official `load()` is awaited. `locale: NS` lets the framework inject `t`; `inject` only returns `api` / `describe` / `schema` / `subscribeInvalidate`. |
+| [`EffortDeclareSection.tsx`](./EffortDeclareSection.tsx) | Route cards, presets, Off tri-state, advanced protocol switches, save and cancel. Save is exclusive for the whole `llm-pi-ai` namespace (ref-guarded against double-click); `busy` is “Saving…” on the in-flight card, `saveLocked` disables the others. A successful write syncs `draftsRef` immediately and folds `acceptView` + `applySaveSuccess`. External `document-updated` events that arrive during save are replayed afterwards. A reload with no conflict clears that card’s conflict/error notice. Footer shows the version and copyright years frozen at pack time. |
+| [`build-info.ts`](./build-info.ts) | Reads `package.json` version and UTC pack year injected by tsdown `define`, and formats the footer line. |
+| [`globals.d.ts`](./globals.d.ts) | Types for `__PLUGIN_VERSION__` and `__COPYRIGHT_TO__`. |
+| [`load-drafts.ts`](./load-drafts.ts) | Builds drafts from `llm.providers` + the settings mirror; drafts come from `user`, protocol classification may use `value`. `thinkingFormat` choices come only from the live schema union. First paint uses `ensure()`; refresh reads `getSnapshot()` only, with helpers that wait for the namespace revision. |
 | [`locales.ts`](./locales.ts) | Copy namespace `plugin-effort-declare`. |
 | [`effort-declare.module.css`](./effort-declare.module.css) | `--dsw-alias-*` tokens only, so dark theme stays correct. |
 | [`schema-ops.ts`](./schema-ops.ts) | Binds `settingsSchema` as plain callbacks (including `validate`) so the service identity is not passed into React. |

package/src/client/README.md

@@ -17,9 +17,11 @@
 
 | 文件 | 说明 |
 | --- | --- |
-| [`index.ts`](./index.ts) | 注册 zh/en 文案、CSS（`ctx.effect` 插入/移除）与 `settings.section`（id `effort-declare`，order 12）。在 `apply` 里订阅镜像 `describe.subscribe`、`settings/document-updated`（仅 `llm-pi-ai`）、`llm/adapters-updated`、`connection/reset`。`locale: NS` 由框架注入 `t`，inject 只传 `api` / `describe` / `schema` / `subscribeInvalidate`。 |
-| [`EffortDeclareSection.tsx`](./EffortDeclareSection.tsx) | 路由卡片、预设、Off 三态、高级协议开关、保存与取消。 |
-| [`load-drafts.ts`](./load-drafts.ts) | 从 `llm.providers` + 镜像组装草稿；草稿取自 `user`，协议分类可用 `value`。`thinkingFormat` 可选项只来自现场 schema union。 |
+| [`index.ts`](./index.ts) | 注册 zh/en 文案、CSS（`ctx.effect` 插入/移除）与 `settings.section`（id `effort-declare`，order 12）。`describe.subscribe` 只同步 `writable`（任意 namespace 都会触发，含自己的 `acceptView`）。`settings/document-updated`（仅 `llm-pi-ai`）带上 Host 的 revision；设置页跳过自己这次 mutate 的回声，等镜像 revision **追上**后再 `getSnapshot()`，不把 `ensure()` 当刷新。提供方目录来自 `llm/adapters-updated`；`connection/reset` 走 `ensure()` 以便等待官方镜像的 in-flight `load()`。`locale: NS` 由框架注入 `t`，inject 只传 `api` / `describe` / `schema` / `subscribeInvalidate`。 |
+| [`EffortDeclareSection.tsx`](./EffortDeclareSection.tsx) | 路由卡片、预设、Off 三态、高级协议开关、保存与取消。保存互斥到整个 `llm-pi-ai` namespace（以 ref 防连点）；`busy` 只给正在 mutate 的卡显示「保存中」，其它卡 `saveLocked`。自己写入成功立刻同步 `draftsRef` 并走 `acceptView` + `applySaveSuccess`。保存过程中到达的外部 `document-updated` 会在结束后补刷。无冲突的 reload 清掉该卡 conflict/error notice。页脚显示打包时冻结的版本与版权年。 |
+| [`build-info.ts`](./build-info.ts) | 读取 tsdown `define` 注入的 `package.json` version 与 UTC 打包年，拼出页脚文案。 |
+| [`globals.d.ts`](./globals.d.ts) | `__PLUGIN_VERSION__` / `__COPYRIGHT_TO__` 的类型声明。 |
+| [`load-drafts.ts`](./load-drafts.ts) | 从 `llm.providers` + 镜像组装草稿；草稿取自 `user`，协议分类可用 `value`。`thinkingFormat` 可选项只来自现场 schema union。首屏 `ensure()`；刷新只读 `getSnapshot()`，并提供等 namespace revision 的 helper。 |
 | [`locales.ts`](./locales.ts) | 文案 namespace `plugin-effort-declare`。 |
 | [`effort-declare.module.css`](./effort-declare.module.css) | 仅使用 `--dsw-alias-*` 设计令牌，保证暗色主题正确。 |
 | [`schema-ops.ts`](./schema-ops.ts) | 将 `settingsSchema` 收成普通回调（含 `validate`），避免把服务身份带进 React。 |

package/src/client/build-info.ts

@@ -0,0 +1,12 @@
+/**
+ * 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.
+ */
+import { COPYRIGHT_FROM, formatAttribution } from '../core/attribution.ts'
+
+export const PLUGIN_FOOTER_TEXT = formatAttribution(
+  __PLUGIN_VERSION__,
+  COPYRIGHT_FROM,
+  __COPYRIGHT_TO__,
+)

package/src/client/effort-declare.module.css

@@ -276,3 +276,11 @@
   font-size: 12px;
   line-height: 18px;
 }
+
+.footer {
+  margin: 16px 0 0;
+  font-size: 11px;
+  line-height: 16px;
+  color: var(--dsw-alias-label-tertiary);
+  opacity: 0.7;
+}

package/src/client/globals.d.ts

@@ -0,0 +1,5 @@
+/** `package.json` version, substituted by tsdown `define` at pack time. */
+declare const __PLUGIN_VERSION__: string
+
+/** UTC full year at pack time, substituted by tsdown `define`. */
+declare const __COPYRIGHT_TO__: number

package/src/client/index.ts

@@ -8,7 +8,7 @@ import type {} from '@deepseek-ai/dsh-client-ui-settings/client'
 import type {} from '@deepseek-ai/dsh-client-locale/client'
 import type {} from '@deepseek-ai/dsh-api-remotes/client'
 import { EffortDeclareSection } from './EffortDeclareSection.tsx'
-import type { EffortDeclareSectionInjected, InvalidationSource } from './EffortDeclareSection.tsx'
+import type { EffortDeclareSectionInjected, Invalidation } from './EffortDeclareSection.tsx'
 import { bindSchema } from './schema-ops.ts'
 import { LLM_PI_AI_NS } from '../core/catalog.ts'
 import { NS, en, zh, type EffortDeclareKey } from './locales.ts'
@@ -60,20 +60,25 @@ export function apply(ctx: ClientContext): void {
   })
   const t = ctx.locale.bind(NS)
   const describe = ctx.settingsScope.describe()
-  const invalidation = new Set<(source: InvalidationSource) => void>()
+  const invalidation = new Set<(event: Invalidation) => void>()
 
   ctx.effect(() => {
-    const emit = (source: InvalidationSource) => {
-      for (const listener of invalidation) listener(source)
+    const emit = (event: Invalidation) => {
+      for (const listener of invalidation) listener(event)
     }
+    // Mirror subscribe fires on every namespace (theme, locale, own acceptView).
+    // Only fold writable from that. llm-pi-ai document changes come from
+    // settings/document-updated; the section waits until the mirror revision
+    // has caught up instead of calling ensure(), and skips the echo of its
+    // own mutate. connection/reset uses ensure() so an in-flight load is awaited.
     const disposers = [
-      describe.subscribe(() => { emit('settings') }),
-      ctx.remote.$on('settings/document-updated', (ns: string) => {
+      describe.subscribe(() => { emit({ source: 'writable' }) }),
+      ctx.remote.$on('settings/document-updated', (ns: string, revision: number) => {
         if (ns !== LLM_PI_AI_NS) return
-        emit('settings')
+        emit({ source: 'settings', revision })
       }),
-      ctx.remote.$on('llm/adapters-updated', () => { emit('directory') }),
-      ctx.on('connection/reset', () => { emit('directory') }),
+      ctx.remote.$on('llm/adapters-updated', () => { emit({ source: 'directory' }) }),
+      ctx.on('connection/reset', () => { emit({ source: 'reset' }) }),
     ]
     return () => {
       for (const dispose of disposers) dispose()