dsh-llm-fallbacks 0.3.0 → 0.3.2

package/dist/commands.d.ts

@@ -11,12 +11,17 @@
  * the command is silently absent when no command registry is composed (no
  * top-level inject pollution — advisor T1 fix).
  *
- * The handler is **read-only**: it never mutates fallback state (no cooldown
- * reset, no pending-switch writes). zh/en copy lives in this file — the
- * client half's `src/client/locales.ts` is a separate client-side dictionary.
- * The host carries no per-session locale signal (the `locale` service is
- * client-side), so the wiring picks a deterministic default (`zh`, this
- * repo's primary language); both dictionaries are unit-tested.
+ * The bare diagnostic and the config readback are **read-only**: they never
+ * mutate fallback state (no cooldown reset, no pending-switch writes). The
+ * `config revert-seed <role-id>` subcommand is the one write action (plan
+ * fallbacks-tui-settings Task 2, AC-3): it delegates to the controller's
+ * `revertSeed` (wired to the seeds service) and prints the outcome — a
+ * web-card action capability the settings seam cannot express. zh/en copy
+ * lives in this file — the client half's `src/client/locales.ts` is a
+ * separate client-side dictionary. The host carries no per-session locale
+ * signal (the `locale` service is client-side), so the wiring picks a
+ * deterministic default (`zh`, this repo's primary language); both
+ * dictionaries are unit-tested.
  *
  * @module dsh-llm-fallbacks/commands
  */
@@ -24,7 +29,8 @@ 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';
+import type { SeedRevertFailReason } from './seeds.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`). */
@@ -90,15 +96,40 @@ export interface FallbacksCommandSnapshot {
  * entities carry id/persona/chain/fallback (NO per-role `model`;
  * `provider`/`model` live on `roles.rules`), so the readback line is id +
  * chain count, never a rules dump.
+ *
+ * Enriched readback (plan fallbacks-tui-settings Task 2, AC-4): timeSlots /
+ * tz / roles.rules join the summary so TUI operators can verify `/settings`
+ * edits. One summarized time-slot row: preset rows carry `{ preset,
+ * chainCount }` (windows are frozen code constants in {@link PRESETS} and
+ * never stored on the row — the render resolves the window text from
+ * PRESETS); custom rows carry `{ start, end, chainCount }`. Rules rows carry
+ * `{ provider, model, role }` — an omitted provider/model (wildcard match at
+ * runtime) is summarized as `''` and rendered as `*`.
  */
 export interface FallbacksConfigSummary {
     readonly enabled: boolean;
     readonly triggerCodes: readonly string[];
     readonly rootChain: readonly string[];
+    /** Summarized time-slot rows (preset rows carry `preset`, custom rows carry `start`/`end`; both may carry a day mask). */
+    readonly timeSlots: readonly {
+        preset?: string;
+        start?: string;
+        end?: string;
+        days?: readonly number[];
+        chainCount: number;
+    }[];
+    /** Config-level timezone for slot matching (default `Asia/Shanghai`). */
+    readonly tz: string;
     readonly roles: readonly {
         id: string;
         chainCount: number;
     }[];
+    /** Summarized role rules: provider/model patterns → declared role (or the built-in `'inherit'`). */
+    readonly rules: readonly {
+        provider: string;
+        model: string;
+        role: string;
+    }[];
     readonly cooldownMs: number;
     readonly revertPolicy: string;
     readonly maxSwitchesPerStep: number;
@@ -122,6 +153,23 @@ export interface FallbacksCommandController {
      * same live config source the runtime reads. Never mutates state.
      */
     getConfig(): FallbacksConfigSummary;
+    /**
+     * Revert one role's persona to its CURRENT declared seed default (AC-3).
+     * Surfaces the outcome as VALUES, not copy (qc1 F-003 / qc2 F-006 / qc3
+     * F-003): `ok: true` when reverted; `ok: false` with the
+     * {@link SeedRevertFailReason} code explaining why not (not a seeded role
+     * / role row absent). The command handler localizes the code per its
+     * registration locale — the controller never pre-localizes. A
+     * settings-write failure propagates loudly as a rejected promise (the
+     * same contract as the seeds service — never swallowed into an
+     * `ok: false`); the handler maps it to a structured error. Implemented by
+     * the wiring against the per-apply seed manager
+     * (`seeds.revert(roleId, seedsIo)`), not the typert gateway.
+     */
+    revertSeed(roleId: string): Promise<{
+        ok: boolean;
+        reason?: SeedRevertFailReason;
+    }>;
 }
 /** zh/en dictionaries for the `/fallbacks` output. */
 export declare const FALLBACKS_COMMAND_LOCALES: {
@@ -129,7 +177,8 @@ export declare const FALLBACKS_COMMAND_LOCALES: {
         readonly title: "当前会话 fallback 诊断（只读）";
         readonly description: "查看当前会话的降级链、最近降级切换与冷却状态（只读）";
         readonly usageConfig: "查看组合后的 fallbacks 配置（设置回读）";
-        readonly usage: "  /fallbacks config   查看组合后的 fallbacks 配置（设置回读）";
+        readonly usageRevertSeed: "将角色的 persona 还原为已声明的 Seed 默认";
+        readonly usage: "  /fallbacks config   查看组合后的 fallbacks 配置（设置回读）\n  /fallbacks config revert-seed <role-id>   将角色的 persona 还原为已声明的 Seed 默认";
         readonly origin: "会话来源";
         readonly role: "角色";
         readonly chain: "链";
@@ -153,22 +202,37 @@ export declare const FALLBACKS_COMMAND_LOCALES: {
         readonly configTriggerCodes: "触发码";
         readonly configRootChain: "根链";
         readonly configEmpty: "（空）";
+        readonly configTimeSlots: "分时槽";
+        readonly configSlotPresetItem: "{preset}（chain: {n}, window {window}）";
+        readonly configSlotPresetBare: "{preset}（chain: {n}）";
+        readonly configSlotCustomItem: "custom {start}-{end}（chain: {n}）";
+        readonly configTz: "时区";
         readonly configRoles: "角色";
         readonly configRoleItem: "{id}（chain: {n}）";
+        readonly configRules: "角色规则";
         readonly configCooldown: "冷却";
         readonly configRevert: "回主策略";
         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 configEdit: "编辑：/settings（TUI 设置界面）或 ~/.dsh/profiles/<profile>/cordis.patch.yml（插件行）/ $DSH_HOME/settings.yaml（fallbacks: 分节）";
+        readonly configEditHint: "TUI 通过 /settings 修改配置；文件编辑仍然可用";
+        readonly revertSeedOk: "角色 {id} 已还原为 Seed 默认";
+        readonly revertSeedFail: "角色 {id} 未还原（{reason}）";
+        readonly revertSeedError: "角色 {id} 还原失败（设置写入失败）";
+        readonly revertSeedReason: {
+            readonly 'not-seeded': "未声明种子";
+            readonly 'row-absent': "角色行不存在";
+            readonly 'settings-unavailable': "设置通道不可用";
+        };
     };
     readonly en: {
         readonly title: "Session fallback diagnostics (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 usageRevertSeed: "revert a role's persona to its declared seed default";
+        readonly usage: "  /fallbacks config   show the composed fallbacks config (settings readback)\n  /fallbacks config revert-seed <role-id>   revert a role's persona to its declared seed default";
         readonly origin: "Session origin";
         readonly role: "Role";
         readonly chain: "Chain";
@@ -192,29 +256,53 @@ export declare const FALLBACKS_COMMAND_LOCALES: {
         readonly configTriggerCodes: "Trigger codes";
         readonly configRootChain: "Root chain";
         readonly configEmpty: "(empty)";
+        readonly configTimeSlots: "Time slots";
+        readonly configSlotPresetItem: "{preset} (chain: {n}, window {window})";
+        readonly configSlotPresetBare: "{preset} (chain: {n})";
+        readonly configSlotCustomItem: "custom {start}-{end} (chain: {n})";
+        readonly configTz: "TZ";
         readonly configRoles: "Roles";
         readonly configRoleItem: "{id} (chain: {n})";
+        readonly configRules: "Rules";
         readonly configCooldown: "Cooldown";
         readonly configRevert: "Revert";
         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";
+        readonly configEdit: "Edit: /settings (TUI settings screen) or ~/.dsh/profiles/<profile>/cordis.patch.yml (plugin row) / $DSH_HOME/settings.yaml (fallbacks: section)";
+        readonly configEditHint: "TUI edits config via /settings; file editing still works";
+        readonly revertSeedOk: "role {id} reverted to its seed default";
+        readonly revertSeedFail: "role {id} not reverted ({reason})";
+        readonly revertSeedError: "role {id} revert failed (settings write failed)";
+        readonly revertSeedReason: {
+            readonly 'not-seeded': "not a seeded role";
+            readonly 'row-absent': "role row absent";
+            readonly 'settings-unavailable': "settings channel unavailable";
+        };
     };
 };
 /** A locale id supported by {@link FALLBACKS_COMMAND_LOCALES}. */
 export type FallbacksCommandLocale = keyof typeof FALLBACKS_COMMAND_LOCALES;
-/** The `/fallbacks` subcommands: `'config'` (composed-config readback) or
- * `''` (the bare session snapshot). */
-export type FallbacksSubcommand = '' | 'config';
+/** The `/fallbacks` subcommands: `'config'` (composed-config readback),
+ * `'revert-seed'` (persona revert action, requires a role id), or `''` (the
+ * bare session snapshot). */
+export type FallbacksSubcommand = '' | 'config' | 'revert-seed';
+/** One parsed subcommand invocation: the kind plus the optional role id
+ * carried by `revert-seed`. */
+export interface FallbacksSubcommandParse {
+    readonly kind: FallbacksSubcommand;
+    /** The role id argument of `revert-seed` (present iff `kind === 'revert-seed'`). */
+    readonly arg?: string;
+}
 /**
  * Map an invocation's rawInput to a subcommand: trimmed `'config'` →
- * `'config'`; everything else (incl. empty) → `''` (bare snapshot). Lenient
- * by design — unknown input keeps today's bare behavior, never errors.
+ * `{ kind: 'config' }`; `'config revert-seed <id>'` → `{ kind: 'revert-seed',
+ * arg: id }`; everything else (incl. empty, a missing id, or an unknown
+ * subcommand under `config`) → `{ kind: '' }` (bare snapshot). Lenient by
+ * design — unknown input keeps today's bare behavior, never errors.
  */
-export declare function parseFallbacksSubcommand(rawInput: string): FallbacksSubcommand;
+export declare function parseFallbacksSubcommand(rawInput: string): FallbacksSubcommandParse;
 /**
  * The newest `limit` `fallbacks/switch` events from a session's raw event
  * log, newest first. Unknown event shapes and malformed `fallbacks/switch`
@@ -248,18 +336,23 @@ export declare function resolveChainForDiagnostic(roles: readonly FallbacksRole[
     readonly inherit: boolean;
 };
 /**
- * Cap for long list lines in the composed-config readback: beyond this many
- * items a line truncates with `…` (the `Roles:` count always stays the FULL
- * count). Same sanity scale as {@link RECENT_SWITCHES_LIMIT}.
+ * Cap for the composed-config readback's LIST lines — Trigger codes, Root
+ * chain, Time slots, Roles, and Rules (qc2 Task-2 Minor): beyond this many
+ * items a line truncates with `…` while its leading count always stays the
+ * FULL count. Same sanity scale as {@link RECENT_SWITCHES_LIMIT}.
  */
 export declare const FALLBACKS_CONFIG_LIST_CAP = 5;
 /**
  * Render the `/fallbacks config` surface (plan fallbacks-tui-client T2,
- * AC-2): the composed `fallbacks` namespace as the runtime reads it + file-only
- * edit hints (TUI has no write surface). The FIRST LINE marks the
- * composed-config readback — distinct from the diagnostic title and never
- * merged into {@link fallbacksCommandText} (two operator surfaces, product
- * lock). Locale defaults to `zh` (the command default); en dictionary tested.
+ * AC-2 + fallbacks-tui-settings Task 2 AC-4): the composed `fallbacks`
+ * namespace as the runtime reads it — enriched with the time-slot rows
+ * (preset rows resolve their frozen window from {@link PRESETS}), the
+ * config timezone, and the role rules — plus edit hints pointing at the
+ * `/settings` TUI edit surface while keeping the file-edit documentation.
+ * The FIRST LINE marks the composed-config readback — distinct from the
+ * diagnostic title and never merged into {@link fallbacksCommandText} (two
+ * operator surfaces, product lock). Locale defaults to `zh` (the command
+ * default); en dictionary tested.
  */
 export declare function fallbacksConfigText(summary: FallbacksConfigSummary, locale?: FallbacksCommandLocale): string;
 /**

package/dist/gateway.d.ts

@@ -214,6 +214,23 @@ export declare class FallbacksConfigGateway extends TypertRemoteService {
      */
     private seedsIo;
 }
+/**
+ * Reject a patch the `Config` schema cannot express: non-object input, unknown
+ * top-level keys (schemastery merges them silently — the settings service
+ * would accept them), and schema type violations — plus the Task 3 semantic
+ * guards the permissive schema deliberately does not carry: nested `roles`
+ * keys, `timeSlots` row shapes (unknown preset ids, duplicate presets, preset
+ * rows carrying windows, non-`HH:mm` custom bounds, out-of-range days, empty
+ * chains), and the all-day `rootChain` head conformance.
+ *
+ * Exported (plan fallbacks-tui-settings Task 1): the TUI settings section's
+ * JSON-field `parse` mirrors the gateway save rules through this single
+ * validator (it internally routes `timeSlots` → {@link validateTimeSlotsPatch}),
+ * so an invalid draft blocks the TUI save exactly like a rejected gateway
+ * patch. No shared-module extraction — the two-keyword diff is the minimal
+ * change.
+ */
+export declare function validateConfigPatch(patch: unknown): void;
 /**
  * The explicit typert contribution for the `fallbacks` gateway endpoints —
  * registered via `ctx.typert.register(...)` (see `apply` in `src/index.ts`).