dsh-llm-fallbacks 0.2.1 → 0.3.0

package/dist/client/locales.d.ts

@@ -37,15 +37,65 @@ export declare const zh: {
     'advanced.label': string;
     'advanced.expand': string;
     'advanced.collapse': string;
+    'roleAutoMatch.label': string;
+    'roleAutoMatch.hint': string;
+    'roleAutoMatch.tooltip': string;
     'rootChain.label': string;
-    'rootChain.hint': string;
     'rootChain.tooltip': string;
-    'rootChain.selector.add': string;
+    'defaultModel.label': string;
     'chains.selector.remove': string;
     'chains.selector.providerPlaceholder': string;
     'chains.selector.modelPlaceholder': string;
     'chains.selector.wildcardLegacy': string;
     'chains.selector.noModelsStrict': string;
+    'mainAgent.label': string;
+    'subagents.label': string;
+    'timeSlots.label': string;
+    'timeSlots.hint': string;
+    'timeSlots.tz.label': string;
+    'timeSlots.drag': string;
+    'timeSlots.name': string;
+    'timeSlots.expand': string;
+    'timeSlots.collapse': string;
+    'timeSlots.tooltip': string;
+    'timeSlots.addPreset': string;
+    'timeSlots.addCustom': string;
+    'timeSlots.presetPlaceholder': string;
+    'timeSlots.remove': string;
+    'timeSlots.moveUp': string;
+    'timeSlots.moveDown': string;
+    'timeSlots.start': string;
+    'timeSlots.end': string;
+    'timeSlots.days': string;
+    'timeSlots.days.hint': string;
+    'timeSlots.preset.name': string;
+    'timeSlots.preset.windowLabel': string;
+    'timeSlots.preset.chainsOnly': string;
+    'timeSlots.preset.liang-peak.label': string;
+    'timeSlots.preset.liang-peak.window': string;
+    'timeSlots.preset.liang-valley.label': string;
+    'timeSlots.preset.liang-valley.window': string;
+    'timeSlots.preset.glm-peak.label': string;
+    'timeSlots.preset.glm-peak.window': string;
+    'timeSlots.preset.glm-valley.label': string;
+    'timeSlots.preset.glm-valley.window': string;
+    'timeSlots.preset.glm.note': string;
+    'timeSlots.preset.highCost': string;
+    'timeSlots.preset.multiplier': string;
+    'timeSlots.active': string;
+    'timeSlots.preset.glm.unconfigured': string;
+    'timeSlots.day.sun': string;
+    'timeSlots.day.mon': string;
+    'timeSlots.day.tue': string;
+    'timeSlots.day.wed': string;
+    'timeSlots.day.thu': string;
+    'timeSlots.day.fri': string;
+    'timeSlots.day.sat': string;
+    'timeSlots.selector.add': string;
+    'allDay.hint': string;
+    'allDay.flash': string;
+    'allDay.pro': string;
+    'allDay.nonconforming': string;
     'roles.list.label': string;
     'roles.list.hint': string;
     'roles.list.tooltip': string;
@@ -63,14 +113,12 @@ export declare const zh: {
     'roles.fallback.none': string;
     'roles.add': string;
     'roles.remove': string;
+    'roles.expand': string;
+    'roles.collapse': string;
     'roles.selector.add': string;
     'roles.rules': string;
     'roles.rules.hint': string;
     'roles.rules.tooltip': string;
-    'roles.rule.origin': string;
-    'roles.rule.origin.any': string;
-    'roles.rule.origin.root': string;
-    'roles.rule.origin.subagent': string;
     'roles.rule.provider': string;
     'roles.rule.provider.any': string;
     'roles.rule.model': string;
@@ -88,6 +136,14 @@ export declare const zh: {
     'validation.ruleRoleUndeclared': string;
     'validation.ruleRoleRequired': string;
     'validation.roleChainRequired': string;
+    'validation.allDayRequired': string;
+    'validation.slotChainRequired': string;
+    'validation.slotWindow': string;
+    'validation.slotDays': string;
+    'validation.slotKind': string;
+    'validation.slotPresetUnknown': string;
+    'validation.slotPresetDuplicate': string;
+    'validation.slotPresetFrozen': string;
     'validation.selector': string;
     'legacy.banner': string;
     'catalog.empty': string;
@@ -98,37 +154,32 @@ export declare const zh: {
     'catalog.outside.short': string;
     'catalog.unconfigured.short': string;
     'status.title': string;
-    'status.effectiveModel.label': string;
-    'status.effectiveModel.unavailable': string;
-    'status.effectiveModel.note': string;
     'status.switches.label': string;
     'status.switches.empty': string;
     'status.switches.error': string;
     'status.switches.compact': string;
+    'status.switches.compact.roleInject': string;
     'status.switches.reason.trigger-code': string;
     'status.switches.reason.always-cap': string;
-    'status.selectionNote': string;
+    'status.switches.reason.role-inject': string;
     'general.title': string;
     'general.enabled': string;
     'general.disabled': string;
     'general.unknown': string;
     'general.unavailable': string;
     'general.switch': string;
+    'general.switch.roleInject': string;
     'general.switch.empty': string;
     'general.error': string;
     'chat.switch.title': string;
     'chat.switch.summary': string;
+    'chat.switch.summary.roleInject': string;
+    'chat.switch.roleMap': string;
     'defaults.prefix': string;
     save: string;
     'save.saving': string;
     'save.error': string;
     close: string;
-    reset: string;
-    'reset.confirmTitle': string;
-    'reset.confirm': string;
-    'reset.confirm.cancel': string;
-    'reset.confirm.action': string;
-    'reset.saving': string;
     loading: string;
     unavailable: string;
     'error.generic': string;
@@ -173,15 +224,65 @@ export declare const en: {
     'advanced.label': string;
     'advanced.expand': string;
     'advanced.collapse': string;
+    'roleAutoMatch.label': string;
+    'roleAutoMatch.hint': string;
+    'roleAutoMatch.tooltip': string;
     'rootChain.label': string;
-    'rootChain.hint': string;
     'rootChain.tooltip': string;
-    'rootChain.selector.add': string;
+    'defaultModel.label': string;
     'chains.selector.remove': string;
     'chains.selector.providerPlaceholder': string;
     'chains.selector.modelPlaceholder': string;
     'chains.selector.wildcardLegacy': string;
     'chains.selector.noModelsStrict': string;
+    'mainAgent.label': string;
+    'subagents.label': string;
+    'timeSlots.label': string;
+    'timeSlots.hint': string;
+    'timeSlots.tz.label': string;
+    'timeSlots.drag': string;
+    'timeSlots.name': string;
+    'timeSlots.expand': string;
+    'timeSlots.collapse': string;
+    'timeSlots.tooltip': string;
+    'timeSlots.addPreset': string;
+    'timeSlots.addCustom': string;
+    'timeSlots.presetPlaceholder': string;
+    'timeSlots.remove': string;
+    'timeSlots.moveUp': string;
+    'timeSlots.moveDown': string;
+    'timeSlots.start': string;
+    'timeSlots.end': string;
+    'timeSlots.days': string;
+    'timeSlots.days.hint': string;
+    'timeSlots.preset.name': string;
+    'timeSlots.preset.windowLabel': string;
+    'timeSlots.preset.chainsOnly': string;
+    'timeSlots.preset.liang-peak.label': string;
+    'timeSlots.preset.liang-peak.window': string;
+    'timeSlots.preset.liang-valley.label': string;
+    'timeSlots.preset.liang-valley.window': string;
+    'timeSlots.preset.glm-peak.label': string;
+    'timeSlots.preset.glm-peak.window': string;
+    'timeSlots.preset.glm-valley.label': string;
+    'timeSlots.preset.glm-valley.window': string;
+    'timeSlots.preset.glm.note': string;
+    'timeSlots.preset.highCost': string;
+    'timeSlots.preset.multiplier': string;
+    'timeSlots.active': string;
+    'timeSlots.preset.glm.unconfigured': string;
+    'timeSlots.day.sun': string;
+    'timeSlots.day.mon': string;
+    'timeSlots.day.tue': string;
+    'timeSlots.day.wed': string;
+    'timeSlots.day.thu': string;
+    'timeSlots.day.fri': string;
+    'timeSlots.day.sat': string;
+    'timeSlots.selector.add': string;
+    'allDay.hint': string;
+    'allDay.flash': string;
+    'allDay.pro': string;
+    'allDay.nonconforming': string;
     'roles.list.label': string;
     'roles.list.hint': string;
     'roles.list.tooltip': string;
@@ -199,14 +300,12 @@ export declare const en: {
     'roles.fallback.none': string;
     'roles.add': string;
     'roles.remove': string;
+    'roles.expand': string;
+    'roles.collapse': string;
     'roles.selector.add': string;
     'roles.rules': string;
     'roles.rules.hint': string;
     'roles.rules.tooltip': string;
-    'roles.rule.origin': string;
-    'roles.rule.origin.any': string;
-    'roles.rule.origin.root': string;
-    'roles.rule.origin.subagent': string;
     'roles.rule.provider': string;
     'roles.rule.provider.any': string;
     'roles.rule.model': string;
@@ -224,6 +323,14 @@ export declare const en: {
     'validation.ruleRoleUndeclared': string;
     'validation.ruleRoleRequired': string;
     'validation.roleChainRequired': string;
+    'validation.allDayRequired': string;
+    'validation.slotChainRequired': string;
+    'validation.slotWindow': string;
+    'validation.slotDays': string;
+    'validation.slotKind': string;
+    'validation.slotPresetUnknown': string;
+    'validation.slotPresetDuplicate': string;
+    'validation.slotPresetFrozen': string;
     'validation.selector': string;
     'legacy.banner': string;
     'catalog.empty': string;
@@ -234,37 +341,32 @@ export declare const en: {
     'catalog.outside.short': string;
     'catalog.unconfigured.short': string;
     'status.title': string;
-    'status.effectiveModel.label': string;
-    'status.effectiveModel.unavailable': string;
-    'status.effectiveModel.note': string;
     'status.switches.label': string;
     'status.switches.empty': string;
     'status.switches.error': string;
     'status.switches.compact': string;
+    'status.switches.compact.roleInject': string;
     'status.switches.reason.trigger-code': string;
     'status.switches.reason.always-cap': string;
-    'status.selectionNote': string;
+    'status.switches.reason.role-inject': string;
     'general.title': string;
     'general.enabled': string;
     'general.disabled': string;
     'general.unknown': string;
     'general.unavailable': string;
     'general.switch': string;
+    'general.switch.roleInject': string;
     'general.switch.empty': string;
     'general.error': string;
     'chat.switch.title': string;
     'chat.switch.summary': string;
+    'chat.switch.summary.roleInject': string;
+    'chat.switch.roleMap': string;
     'defaults.prefix': string;
     save: string;
     'save.saving': string;
     'save.error': string;
     close: string;
-    reset: string;
-    'reset.confirmTitle': string;
-    'reset.confirm': string;
-    'reset.confirm.cancel': string;
-    'reset.confirm.action': string;
-    'reset.saving': string;
     loading: string;
     unavailable: string;
     'error.generic': string;
@@ -279,9 +381,12 @@ declare module '@deepseek-ai/dsh-client-ui-slots' {
 }
 /**
  * Reason → locale key map for switch summaries (S-c; shared by the card's
- * status block and the General page status row). The session log is durable
- * and forward-compatible: a reason value outside the current union (a newer
- * plugin wrote it) renders raw instead of falling into a binary else branch.
+ * status block, the General page status row, and the conversation node). All
+ * reasons resolve from ONE key family (`status.switches.reason.*`) — the
+ * shared reason vocabulary must not mix dictionary families (qc1 F-004). The
+ * session log is durable and forward-compatible: a reason value outside the
+ * current union (a newer plugin wrote it) renders raw instead of falling
+ * into a binary else branch.
  */
 export declare const SWITCH_REASON_KEYS: Readonly<Partial<Record<FallbackSwitchReason, FallbacksKey>>>;
 /** Human-readable trigger-code labels (spec §4 用户直观性). */

package/dist/commands.d.ts

@@ -24,6 +24,7 @@ import type { CommandDefinition } from '@deepseek-ai/dsh-commands';
 import { type FallbacksRole } from './config.ts';
 import type { Origin } from './roles.ts';
 import type { FallbacksSwitchEventData } from './events.ts';
+import type { SlotRowConfig } from './time-slots.ts';
 /** How many recent `fallbacks/switch` events `/fallbacks` shows (newest first). */
 export declare const RECENT_SWITCHES_LIMIT = 5;
 /** Minimal command registry surface (satisfied by the dsh `CommandService`). */
@@ -68,7 +69,15 @@ export interface FallbacksCommandSnapshot {
      * `fallback` is `'inherit-root'` — or the role is unknown — and rootChain
      * is non-empty; the diagnostic annotation source, spec §7.4). */
     readonly inherit: boolean;
-    /** Recent `fallbacks/switch` events, newest first, capped at {@link RECENT_SWITCHES_LIMIT}. */
+    /** Current time-slot winner + display label (P5/P7): the 分时切换 side of
+     * the status strip. The switches section below is the 降级切换 side —
+     * the copy never mixes. */
+    readonly slot: {
+        readonly winner: SlotRowConfig | 'all-day';
+        readonly label: string;
+    };
+    /** Recent `fallbacks/switch` events (failure walks — 降级切换), newest
+     * first, capped at {@link RECENT_SWITCHES_LIMIT}. */
     readonly switches: readonly FallbacksSwitchEventData[];
     /** Active cooldown entries for the agent. */
     readonly cooldown: readonly FallbacksCooldownEntry[];
@@ -95,6 +104,8 @@ export interface FallbacksConfigSummary {
     readonly maxSwitchesPerStep: number;
     readonly alwaysModeRetryCap: number;
     readonly presets: 'bundled' | 'none';
+    /** Dispatch-time LLM role auto-match switch (default true). */
+    readonly roleAutoMatch: boolean;
 }
 /**
  * The session-scoped read-only operations the `/fallbacks` handler drives.
@@ -116,7 +127,7 @@ export interface FallbacksCommandController {
 export declare const FALLBACKS_COMMAND_LOCALES: {
     readonly zh: {
         readonly title: "当前会话 fallback 诊断（只读）";
-        readonly description: "查看当前会话的降级链、最近切换与冷却状态（只读）";
+        readonly description: "查看当前会话的降级链、最近降级切换与冷却状态（只读）";
         readonly usageConfig: "查看组合后的 fallbacks 配置（设置回读）";
         readonly usage: "  /fallbacks config   查看组合后的 fallbacks 配置（设置回读）";
         readonly origin: "会话来源";
@@ -124,7 +135,8 @@ export declare const FALLBACKS_COMMAND_LOCALES: {
         readonly chain: "链";
         readonly inheritRoot: "（inherit-root）";
         readonly chainNone: "未配置";
-        readonly switches: "最近切换";
+        readonly slot: "分时";
+        readonly switches: "最近降级切换";
         readonly switchesNone: "本会话暂无 fallback 切换";
         readonly switchLine: "{from} → {to}（role={role}，reason={reason}）";
         readonly cooldown: "冷却";
@@ -148,12 +160,13 @@ export declare const FALLBACKS_COMMAND_LOCALES: {
         readonly configMaxSwitches: "单步最大切换";
         readonly configAlwaysCap: "always 上限";
         readonly configPresets: "预置";
+        readonly configRoleAutoMatch: "角色自动匹配";
         readonly configEdit: "编辑：~/.dsh/profiles/<profile>/cordis.patch.yml（插件行）或 $DSH_HOME/settings.yaml（fallbacks: 分节）";
         readonly configEditHint: "TUI 无法修改配置——只能编辑文件";
     };
     readonly en: {
         readonly title: "Session fallback diagnostics (read-only)";
-        readonly description: "Inspect fallback chain, recent switches, and cooldown for this session (read-only)";
+        readonly description: "Inspect fallback chain, recent fallback switches, and cooldown for this session (read-only)";
         readonly usageConfig: "show the composed fallbacks config (settings readback)";
         readonly usage: "  /fallbacks config   show the composed fallbacks config (settings readback)";
         readonly origin: "Session origin";
@@ -161,7 +174,8 @@ export declare const FALLBACKS_COMMAND_LOCALES: {
         readonly chain: "Chain";
         readonly inheritRoot: " (inherit-root)";
         readonly chainNone: "not configured";
-        readonly switches: "Recent switches";
+        readonly slot: "Time slot";
+        readonly switches: "Recent fallback switches";
         readonly switchesNone: "No fallback switches in this session";
         readonly switchLine: "{from} → {to} (role={role}, reason={reason})";
         readonly cooldown: "Cooldown";
@@ -185,6 +199,7 @@ export declare const FALLBACKS_COMMAND_LOCALES: {
         readonly configMaxSwitches: "Max switches/step";
         readonly configAlwaysCap: "Always-mode cap";
         readonly configPresets: "Presets";
+        readonly configRoleAutoMatch: "Auto-match";
         readonly configEdit: "Edit: ~/.dsh/profiles/<profile>/cordis.patch.yml (plugin row) or $DSH_HOME/settings.yaml (fallbacks: section)";
         readonly configEditHint: "TUI cannot change config — edit files only";
     };
@@ -249,8 +264,8 @@ export declare const FALLBACKS_CONFIG_LIST_CAP = 5;
 export declare function fallbacksConfigText(summary: FallbacksConfigSummary, locale?: FallbacksCommandLocale): string;
 /**
  * Render the `/fallbacks` status surface for one snapshot. Kept minimal and
- * truthful: origin → role → chain (+ inherit tail) → recent switches →
- * cooldown.
+ * truthful: origin → role → chain (+ inherit tail) → current slot (分时) →
+ * recent switches (降级切换) → cooldown.
  */
 export declare function fallbacksCommandText(snapshot: FallbacksCommandSnapshot, locale?: FallbacksCommandLocale): string;
 /**

package/dist/config.d.ts

@@ -27,10 +27,17 @@
  *
  * @module dsh-llm-fallbacks/config
  */
+import type { SlotRowConfig } from './time-slots.ts';
 /** How a cooled-down model comes back (spec §4). */
 export type RevertPolicy = 'cooldown-expiry' | 'never';
-/** A single role rule: match on origin/provider/model patterns (spec §3). */
+/** A single role rule: match on provider/model patterns (spec §3). */
 export interface FallbacksRoleRule {
+    /**
+     * Legacy persisted wire field (PR #62 feedback): rules are subagent-only,
+     * so this constraint is IGNORED at match time — root requests never
+     * match rules. Kept in the type/schema so pre-feedback `settings.yaml`
+     * files that carry `origin` still parse, validate, and save unchanged.
+     */
     origin?: 'root' | 'subagent';
     provider?: string;
     model?: string;
@@ -91,6 +98,33 @@ export interface FallbacksConfig {
      * every resolved config carries a value via the schema default.
      */
     presets?: 'bundled' | 'none';
+    /**
+     * Dispatch-time LLM role auto-match switch (plan fallbacks-role-automatch
+     * Task 1): when `true` (default), a subagent-origin request with no
+     * explicit/rules-resolved role may have the best-fit declared role picked
+     * by the LLM; `false` reproduces today's behavior exactly. Optional on
+     * purpose, mirroring `presets` — a required field would break library
+     * consumers that construct `FallbacksConfig` literals with the existing
+     * keys (additive, non-breaking). The value domain is guarded by the
+     * schema (`z.boolean().default(true)` in `src/schema.ts`), and the
+     * runtime reads it defensively as `config.roleAutoMatch ?? true` (safe
+     * for direct constructors that omit it).
+     */
+    roleAutoMatch?: boolean;
+    /**
+     * Extra time-slot rows (plan fallbacks-timeslots Task 1, P5): the FIRST
+     * matching row's chain becomes the effective root chain at request time;
+     * `rootChain` (the all-day chain) is always the last row.
+     * Optional on purpose, mirroring `presets` — additive, non-breaking for
+     * library consumers. Malformed rows warn once and are skipped by the
+     * resolver; the gateway rejects them on save (Task 3).
+     */
+    timeSlots?: SlotRowConfig[];
+    /**
+     * Config-level timezone for slot matching (default `Asia/Shanghai`,
+     * UTC+8). Not per-slot.
+     */
+    tz?: string;
 }
 /**
  * Spec §4 defaults — `Config({})` must equal this (no-op install).

package/dist/events.d.ts

@@ -1,15 +1,29 @@
 /**
  * `fallbacks/switch` session event vocabulary (spec §5 table; plan Task 3).
  *
- * The event is appended (never rewrites history — AC-7) at every switch,
- * including the always-mode cap path: "无事件即无切换" (Global Constraint).
+ * Writing is stopped (issue #52): the plugin no longer appends this event —
+ * the apply()-time event-type registration was proven ineffective (module
+ * instance mismatch), and a session containing the event refused to load
+ * after a dsh restart. The event now exists only in history: old logs are
+ * repaired by `scripts/repair-fallbacks-switch-logs.ts`, which marks legacy
+ * events ignorable so affected sessions load again.
  * The module is type-only — the augmentation is erased at runtime; the
  * plugin's runtime behavior lives in `src/index.ts`.
  *
  * @module dsh-llm-fallbacks/events
  */
-/** Why a switch was decided (spec §5.1 `PendingSwitch.reason`). */
-export type FallbackSwitchReason = 'trigger-code' | 'always-cap';
+/**
+ * Why a switch was decided (spec §5.1 `PendingSwitch.reason`).
+ *
+ * `role-inject` is the dispatch-time reason (plan fallbacks-role-automatch
+ * Task 4): a subagent-origin agent's first request was re-routed to its
+ * resolved role's chain head. It is ADDITIVE to the failure-time reasons —
+ * the event shape stays a superset of the pre-feature payload, and existing
+ * renderers show unknown reasons raw (AC-5). Unlike `trigger-code` /
+ * `always-cap`, a `role-inject` event is NOT a failure decision: it carries
+ * no pending switch / cooldown / failure bookkeeping (no `commit()`).
+ */
+export type FallbackSwitchReason = 'trigger-code' | 'always-cap' | 'role-inject';
 /** Durable payload of one provider/model switch (spec §5 table). */
 export interface FallbacksSwitchEventData {
     turn: number;
@@ -30,7 +44,7 @@ export interface FallbacksSwitchEventData {
 }
 declare module '@deepseek-ai/dsh-session/types' {
     interface SessionEventMap {
-        /** Durable, append-only record of one provider/model switch decided by dsh-llm-fallbacks. */
+        /** Historical, append-only record of one provider/model switch decided by dsh-llm-fallbacks (no longer written — issue #52 stop-write). */
         'fallbacks/switch': FallbacksSwitchEventData;
     }
 }

package/dist/index.d.ts

@@ -13,14 +13,17 @@
  *   (**always mode included**) → `next()`; otherwise resolve role + chain,
  *   and when a candidate survives the filter (current / cooldown /
  *   step-failed / `provider/*`-missing-id) write the pending switch +
- *   cooldown + failure bookkeeping + append `fallbacks/switch`, then return
+ *   cooldown + failure bookkeeping, then return
  *   `{ kind: 'retry' }` (own recovery, no `next()`).
  * - `agent/request` waterfall: apply a pending switch after `await next()`
  *   (provider/model override, inherited `reasoningEffort` dropped — the
- *   `installModelSelection` `withoutInheritedEffort` pattern), then the
- *   always-mode cap check (count `llm/retry` events for the current
- *   turn/step/provider; ≥ `alwaysModeRetryCap` → same decision path, reason
- *   `always-cap` — ADR-2).
+ *   `installModelSelection` `withoutInheritedEffort` pattern); a
+ *   root-origin `FallbacksChain/Auto` seed then overrides to the
+ *   effective chain's first exact head (select-is-primary, plan
+ *   fallbacks-virtual-chain Task 2); then the always-mode cap check (count
+ *   `llm/retry` events for the current turn/step/provider; ≥
+ *   `alwaysModeRetryCap` → same decision path, reason `always-cap` —
+ *   ADR-2).
  * - Per-agent state (`FallbackStateStore`): `agent/disposed` removes it,
  *   `agent/status` idle prunes per-step state defensively, plugin dispose
  *   clears everything (spec §6 — no residual state).