dsh-plan-completion 0.1.5 → 0.1.7

package/CHANGELOG.md

@@ -3,6 +3,33 @@
 All notable changes to this project are documented here.
 Format: [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), versioning: SemVer.
 
+## [0.1.7] - 2026-11-02
+
+### Fixed
+- Settings page model lists now load per provider (`GET /settings?provider=…`), so third-party
+  providers' models appear after switching Provider; fixed an internal error caused by a
+  provider-scope bug in the settings snapshot.
+
+### Changed
+- Settings page redesign matched to DSH General Settings: flat 66px rows (title + description left,
+  control right), filled controls without borders, DSH-sized toggle, right-aligned save button,
+  unified typography/theme tokens for light and dark themes.
+
+## [0.1.6] - 2026-11-02
+
+### Added
+- Model settings page registered at `settings.plugins.tab` (Settings → Plugins → 计划补全):
+  radio group for `default` / `fixed` / `auto` model policy, Provider/Model ID inputs for fixed
+  mode, a `modelCalls` toggle, current host-default route hint, and save/status feedback.
+- Host settings route `GET/POST /plan-completion/settings` (authenticated) persists the policy to
+  `<storageDir>/settings.json` and loads it on apply; `pickModel` honours `default`/`fixed`/`auto`.
+- Client transport test for the settings page (GET/POST, failure handling).
+- Dev-only suggestion log lives outside the release: `research/suggestion-log-local/` keeps a local
+  copy for tuning; the published plugin does not contain or enable suggestion-content logging.
+
+### Changed
+- `npm test` now reports **138/138** tests.
+
 ## [0.1.5] - 2026-11-02
 
 ### Fixed
@@ -136,3 +163,5 @@ Format: [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), versioning: Se
 - Debug endpoints (`theme`, `experiment`, `autojob`, `steps`, `reset`) are only registered when
   `enableDebugRoutes: true`; production endpoints are `state`, `debug`, `diag`, `replan`, `warm`.
 - No credentials are stored in the plugin; model calls use the host `llm` service.
+
+

package/client.js

@@ -105,7 +105,25 @@ window.__ModuleLoader__.load({
         'verify.clean': '未发现明显差异。',
         'verify.next': '建议：{value}',
         'verify.failed': '核对失败：{value}',
-        'verify.no-session': '当前还没有可用会话'
+        'verify.no-session': '当前还没有可用会话',
+        'settings.title': '计划补全',
+        'settings.model': '模型选择',
+        'settings.policy.default': '跟随宿主默认',
+        'settings.policy.fixed': '固定模型',
+        'settings.policy.auto': '自动（优先非推理）',
+        'settings.provider': 'Provider',
+        'settings.modelId': 'Model ID',
+        'settings.modelCalls': '允许本插件调用模型',
+        'settings.modelDesc': '选择插件生成计划与建议时使用的模型来源',
+        'settings.providerDesc': '固定使用的 provider',
+        'settings.callsDesc': '关闭后插件只使用启发式，不向模型发送内容',
+        'settings.defaultRoute': '宿主默认：{value}',
+        'settings.save': '保存',
+        'settings.saving': '保存中…',
+        'settings.saved': '已保存',
+        'settings.loading': '加载中…',
+        'settings.error': '设置加载失败',
+        'settings.saveError': '保存失败'
       },
       en: {
         'entry.aria': 'Open the session plan panel',
@@ -148,7 +166,25 @@ window.__ModuleLoader__.load({
         'verify.clean': 'No obvious mismatches found.',
         'verify.next': 'Next: {value}',
         'verify.failed': 'Verification failed: {value}',
-        'verify.no-session': 'No session available yet'
+        'verify.no-session': 'No session available yet',
+        'settings.title': 'Plan Completion',
+        'settings.model': 'Model selection',
+        'settings.policy.default': 'Follow host default',
+        'settings.policy.fixed': 'Fixed model',
+        'settings.policy.auto': 'Auto (prefer non-reasoning)',
+        'settings.provider': 'Provider',
+        'settings.modelId': 'Model ID',
+        'settings.modelCalls': 'Allow this plugin to call models',
+        'settings.modelDesc': 'Model source used for plan and suggestion generation',
+        'settings.providerDesc': 'Provider used by the fixed policy',
+        'settings.callsDesc': 'When off, the plugin only uses heuristics and sends nothing',
+        'settings.defaultRoute': 'Host default: {value}',
+        'settings.save': 'Save',
+        'settings.saving': 'Saving…',
+        'settings.saved': 'Saved',
+        'settings.loading': 'Loading…',
+        'settings.error': 'Failed to load settings',
+        'settings.saveError': 'Save failed'
       }
     };
 
@@ -787,6 +823,53 @@ window.__ModuleLoader__.load({
         });
     }
 
+    /**
+     * Host settings used by the settings page (model policy + modelCalls).
+     */
+    function fetchSettings(provider) {
+      try {
+        const query = typeof provider === 'string' && provider ? '?provider=' + encodeURIComponent(provider) : '';
+        return Promise.resolve(fetch('/plan-completion/settings' + query, {
+          method: 'GET',
+          credentials: 'same-origin',
+          headers: { accept: 'application/json' }
+        }))
+          .then(function readResponse(response) {
+            return response && response.ok === true ? Promise.resolve(response.json()) : null;
+          })
+          .then(function parsed(json) {
+            return json && typeof json === 'object' ? json : null;
+          })
+          .catch(function networkError() {
+            return null;
+          });
+      } catch (error) {
+        return Promise.resolve(null);
+      }
+    }
+
+    function saveSettings(payload) {
+      try {
+        return Promise.resolve(fetch('/plan-completion/settings', {
+          method: 'POST',
+          credentials: 'same-origin',
+          headers: { 'content-type': 'application/json' },
+          body: JSON.stringify(payload || {})
+        }))
+          .then(function readResponse(response) {
+            return response && response.ok === true ? Promise.resolve(response.json()) : null;
+          })
+          .then(function parsed(json) {
+            return json && typeof json === 'object' ? json : null;
+          })
+          .catch(function networkError() {
+            return null;
+          });
+      } catch (error) {
+        return Promise.resolve(null);
+      }
+    }
+
     /**
      * P0 boundary: read the current plan state. Keep this signature stable —
      * swapping the transport (HTTP route / projection / wire view) only changes
@@ -2055,6 +2138,146 @@ window.__ModuleLoader__.load({
       );
     }
 
+    // =====================================================================
+    // Settings page (settings.plugins.tab)
+    // =====================================================================
+    const SETTINGS_SLOT = 'settings.plugins.tab';
+    const SETTINGS_ID = 'plan-completion-settings';
+    const SETTINGS_ORDER = 60;
+
+    function settingsCss() {
+      return [
+        '.dpc-settings-page{display:flex;flex-direction:column;padding:8px 24px 20px;max-width:720px;box-sizing:border-box;font-size:13px;line-height:20px;color:var(--dsw-alias-label-primary)}',
+        '.dpc-settings-head{display:flex;flex-direction:column;gap:4px;padding:6px 0 10px}',
+        '.dpc-settings-title{font-size:16px;font-weight:600;line-height:26px}',
+        '.dpc-settings-sub{font-size:12px;line-height:18px;color:var(--dsw-alias-label-tertiary)}',
+        '.dpc-settings-row{display:flex;align-items:center;justify-content:space-between;gap:24px;min-height:66px;padding:12px 0;box-sizing:border-box;border-bottom:1px solid var(--dsw-alias-border-l1)}',
+        '.dpc-settings-row:last-of-type{border-bottom:0}',
+        '.dpc-settings-row-main{display:flex;flex-direction:column;gap:3px;min-width:0}',
+        '.dpc-settings-row-label{font-size:14px;line-height:22px;color:var(--dsw-alias-label-primary)}',
+        '.dpc-settings-row-desc{font-size:12px;line-height:18px;color:var(--dsw-alias-label-tertiary)}',
+        '.dpc-settings-control{flex:none;display:flex;justify-content:flex-end;align-items:center;min-width:132px;max-width:240px}',
+        '.dpc-settings-select{width:100%;border:1px solid transparent;border-radius:8px;padding:7px 12px;font-size:13px;line-height:20px;background:var(--dsw-alias-bg-layer-2,var(--dsw-alias-bg-layer-1));color:var(--dsw-alias-label-primary);cursor:pointer;appearance:auto}',
+        '.dpc-settings-select:hover{background:var(--dsw-alias-bg-layer-1)}',
+        '.dpc-settings-select:focus{outline:none;border-color:var(--dsw-alias-brand-primary,var(--dsw-alias-state-business-primary))}',
+        '.dpc-settings-toggle{width:40px;height:24px;border-radius:999px;border:0;background:var(--dsw-alias-bg-layer-2,var(--dsw-alias-bg-layer-1));position:relative;cursor:pointer;padding:0;flex:none}',
+        '.dpc-settings-toggle[data-on="true"]{background:var(--dsw-alias-brand-primary,var(--dsw-alias-state-business-primary))}',
+        '.dpc-settings-toggle span{position:absolute;top:2px;left:2px;width:20px;height:20px;border-radius:999px;background:#fff;transition:left .12s ease;box-shadow:0 1px 2px rgba(0,0,0,.18)}',
+        '.dpc-settings-toggle[data-on="true"] span{left:18px}',
+        '.dpc-settings-footer{display:flex;align-items:center;justify-content:flex-end;gap:12px;padding-top:18px}',
+        '.dpc-settings-status{font-size:12px;line-height:18px;color:var(--dsw-alias-state-success-primary,var(--dsw-alias-label-secondary));margin-right:auto}',
+        '.dpc-settings-error{font-size:12px;line-height:18px;color:var(--dsw-alias-state-error-primary,var(--dsw-alias-label-secondary));margin-right:auto}',
+        '.dpc-settings-save{border:0;border-radius:8px;padding:7px 16px;font-size:13px;line-height:20px;cursor:pointer;background:var(--dsw-alias-bg-layer-2,var(--dsw-alias-bg-layer-1));color:var(--dsw-alias-label-primary);flex:none}',
+        '.dpc-settings-save:hover{background:var(--dsw-alias-bg-layer-1)}',
+        '.dpc-settings-save:disabled{opacity:.5;cursor:default}',
+        '.dpc-settings-loading{padding:18px 24px;font-size:13px;color:var(--dsw-alias-label-secondary)}'
+      ].join('\n');
+    }
+
+    function PlanSettingsPage(props) {
+      const t = makeT(props);
+      const [settings, setSettings] = React.useState(null);
+      const [status, setStatus] = React.useState('loading');
+      const [saving, setSaving] = React.useState(false);
+      const [error, setError] = React.useState('');
+      const [saved, setSaved] = React.useState(false);
+
+      React.useEffect(function load() {
+        let alive = true;
+        fetchSettings().then(function applied(result) {
+          if (!alive) return;
+          if (!result || result.ok !== true || !result.settings) { setStatus('error'); return; }
+          setSettings(result.settings);
+          setStatus('ready');
+        });
+        return function cleanup() { alive = false; };
+      }, []);
+
+      function patch(next) {
+        setSaved(false);
+        setSettings(function keep(previous) { return previous ? { ...previous, ...next } : previous; });
+      }
+      function chooseProvider(provider) {
+        patch({ fixedProvider: provider, fixedModel: '', models: [] });
+        fetchSettings(provider).then(function applied(result) {
+          if (result && result.ok === true && result.settings) patch({ models: result.settings.models || [] });
+        });
+      }
+      function save() {
+        if (!settings || saving) return;
+        setSaving(true); setError('');
+        saveSettings({
+          modelPolicy: settings.modelPolicy,
+          fixedProvider: settings.fixedProvider || '',
+          fixedModel: settings.fixedModel || '',
+          modelCalls: settings.modelCalls === true
+        }).then(function applied(result) {
+          setSaving(false);
+          if (!result || result.ok !== true) {
+            const detail = result && typeof result.error === 'string' ? result.error : '';
+            setError(detail ? t('settings.saveError') + ': ' + detail : t('settings.saveError'));
+            return;
+          }
+          setSettings(result.settings || settings);
+          setSaved(true); setError('');
+        });
+      }
+
+      const styleTag = h('style', { key: 'style', 'data-plan-completion-style': 'settings' }, settingsCss());
+      if (status === 'loading') return h(React.Fragment, null, styleTag, h('div', { key: 'loading', className: 'dpc-settings-loading' }, t('settings.loading')));
+      if (status === 'error' || !settings) return h(React.Fragment, null, styleTag, h('div', { key: 'error', className: 'dpc-settings-loading dpc-settings-error' }, t('settings.error')));
+
+      const defaultRoute = settings.defaultSelection ? settings.defaultSelection.provider + '/' + settings.defaultSelection.model : '-';
+      const providers = settings.providers || [];
+      const models = settings.models || [];
+      const row = function row(key, label, desc, control) {
+        return h('div', { key: key, className: 'dpc-settings-row' },
+          h('div', { key: 'main', className: 'dpc-settings-row-main' },
+            h('div', { key: 'label', className: 'dpc-settings-row-label' }, label),
+            desc ? h('div', { key: 'desc', className: 'dpc-settings-row-desc' }, desc) : null),
+          h('div', { key: 'control', className: 'dpc-settings-control' }, control));
+      };
+
+      return h(React.Fragment, null, styleTag,
+        h('div', { key: 'page', className: 'dpc-settings-page' },
+          h('div', { key: 'head', className: 'dpc-settings-head' },
+            h('div', { key: 'title', className: 'dpc-settings-title' }, t('settings.title')),
+            h('div', { key: 'sub', className: 'dpc-settings-sub' }, t('settings.defaultRoute', { value: defaultRoute }))),
+          row('policy', t('settings.model'), t('settings.modelDesc'),
+            h('select', { className: 'dpc-settings-select', value: settings.modelPolicy,
+              onChange: function onPolicy(event) { patch({ modelPolicy: event.target.value }); } },
+              [h('option', { key: 'default', value: 'default' }, t('settings.policy.default')),
+               h('option', { key: 'fixed', value: 'fixed' }, t('settings.policy.fixed')),
+               h('option', { key: 'auto', value: 'auto' }, t('settings.policy.auto'))])),
+          settings.modelPolicy === 'fixed'
+            ? row('provider', t('settings.provider'), t('settings.providerDesc'),
+                h('select', { className: 'dpc-settings-select', value: settings.fixedProvider || '',
+                  onChange: function onProvider(event) { chooseProvider(event.target.value); } },
+                  [h('option', { key: 'empty', value: '' }, '—')].concat(providers.map(function option(p) {
+                    return h('option', { key: p.id, value: p.id }, p.name || p.id);
+                  }))))
+            : null,
+          settings.modelPolicy === 'fixed'
+            ? row('model', t('settings.modelId'), t('settings.modelDesc'),
+                h('select', { className: 'dpc-settings-select', value: settings.fixedModel || '',
+                  onChange: function onModel(event) { patch({ fixedModel: event.target.value }); } },
+                  [h('option', { key: 'empty', value: '' }, '—')].concat(models.map(function option(m) {
+                    return h('option', { key: m.id, value: m.id }, m.name || m.id);
+                  }))))
+            : null,
+          row('calls', t('settings.modelCalls'), t('settings.callsDesc'),
+            h('button', { type: 'button', className: 'dpc-settings-toggle', 'data-on': settings.modelCalls === true ? 'true' : 'false',
+              'aria-pressed': settings.modelCalls === true ? 'true' : 'false',
+              onClick: function onCalls() { patch({ modelCalls: settings.modelCalls !== true }); } },
+              h('span', { key: 'knob' }))),
+          h('div', { key: 'footer', className: 'dpc-settings-footer' },
+            error ? h('div', { key: 'e', className: 'dpc-settings-error' }, error)
+              : saved ? h('div', { key: 's', className: 'dpc-settings-status' }, t('settings.saved')) : null,
+            h('button', { key: 'save', type: 'button', className: 'dpc-settings-save', disabled: saving, onClick: save },
+              saving ? t('settings.saving') : t('settings.save')))));
+    }
+
+
     // =====================================================================
     // Plugin entry
     // =====================================================================
@@ -2090,6 +2313,13 @@ window.__ModuleLoader__.load({
           return ctx.slots.register({ name: OVERLAY_SLOT, id: OVERLAY_ID, order: OVERLAY_ORDER }, PlanPopover);
         });
 
+        ctx.slots.inject(SETTINGS_SLOT, function registerSettingsPage() {
+          return ctx.slots.register(
+            { name: SETTINGS_SLOT, id: SETTINGS_ID, order: SETTINGS_ORDER, label: '计划补全' },
+            PlanSettingsPage
+          );
+        });
+
         ctx.effect(function installKeyboard() {
           if (typeof window === 'undefined') return undefined;
           const onKeyDown = function onKeyDown(event) {
@@ -2181,3 +2411,8 @@ window.__ModuleLoader__.load({
 // hot-reload marker 2026-11-01T13:57Z
 
 
+
+
+
+
+

package/docs/publish-assessment.md

@@ -1,7 +1,11 @@
 # GitHub 发布评估 · 会话计划补全插件（2026-11-02）
 
-> 历史文档：以下保留 v0.1.0 的交付/评估/计划记录。**当前最新为 v0.1.4**（建议文本保真 + 核对进度 + 本地计划持久化 + 鉴权/状态一致性/隐私边界修复），详见 [security.md](security.md) 与 [CHANGELOG](../CHANGELOG.md)；旧记录中的“无鉴权”、原始诊断字段与独立评审不代表当前实现。
+> 历史文档：以下保留 v0.1.0 的交付/评估/计划记录。**当前最新为 v0.1.6**（计划停更检测 + 建议文本保真 + 核对进度 + 本地计划持久化 + 鉴权/状态一致性/隐私边界修复），详见 [security.md](security.md) 与 [CHANGELOG](../CHANGELOG.md)；旧记录中的“无鉴权”、原始诊断字段与独立评审不代表当前实现。
 >
+> v0.1.6 发布记录（2026-11-02）：模型设置页（settings.plugins.tab）+ settings 持久化；Tab 建议日志仅本地不发布。tag `v0.1.6`；npm `dsh-plan-completion@0.1.6`；138/138 tests；CI run 41393937067。
+>
+> v0.1.5 发布记录（2026-11-02）：计划停更检测——连续 2 次 op=none 后建议变为 `/replan …` 并标记 stale。tag `v0.1.5` + [Release](https://github.com/Xumi0920/dsh-plan-completion/releases/tag/v0.1.5)；Actions [run 41391402601](https://github.com/Xumi0920/dsh-plan-completion/actions/runs/41391402601)（四 job 全绿，133/133 tests）；npm `dsh-plan-completion@0.1.5`（shasum `c53c6d7ef79d8634913054db79fa9e5b1e86b182`）。
+>
 > v0.1.4 发布记录（2026-11-02）：建议文本保真修复（标识符/路径/命令保留 + 语义化截断）。tag `v0.1.4` + [Release](https://github.com/Xumi0920/dsh-plan-completion/releases/tag/v0.1.4)；GitHub Actions [run 41389845733](https://github.com/Xumi0920/dsh-plan-completion/actions/runs/41389845733)（四 job 全绿，132/132 tests）；npm `dsh-plan-completion@0.1.4`（31 files，shasum `a6f8953445e330081243f9f9d6b429fd4402b341`）。
 >
 > v0.1.3 发布记录（2026-11-02）：tag `v0.1.3` + [Release](https://github.com/Xumi0920/dsh-plan-completion/releases/tag/v0.1.3)；GitHub Actions [run 41368609382](https://github.com/Xumi0920/dsh-plan-completion/actions/runs/41368609382)（Ubuntu/Windows × Node20/22 四 job 全绿，126/126 tests）；npm `dsh-plan-completion@0.1.3`（31 files，shasum `11adee0fe9acff199a180be511ca8bc600afdf6f`）；canary 验证 `/plan-completion/verify` 未认证 401、客户端鉴权请求正常。
@@ -108,3 +112,5 @@ git tag v0.1.0 && git push --tags
 
 
 
+
+

package/index.js

@@ -11,7 +11,7 @@
  * The Client half only talks to this half through `/plan-completion/*`
  * (verified contract: same-origin fetch from the Electron page works and the body is readable).
  */
-import { appendFileSync, mkdirSync, writeFileSync } from 'node:fs'
+import { appendFileSync, mkdirSync, readFileSync, renameSync, writeFileSync } from 'node:fs'
 import { homedir } from 'node:os'
 
 import { DEFAULTS } from './host/config.js'
@@ -63,6 +63,38 @@ function expandStorageDir(value, envValue) {
   return raw
 }
 
+const MODEL_POLICIES = new Set(['default', 'fixed', 'auto'])
+
+function normalizeModelPolicy(value) {
+  const policy = typeof value === 'string' ? value.trim() : ''
+  return MODEL_POLICIES.has(policy) ? policy : 'default'
+}
+
+/** Settings written through the model-settings page (persisted next to the plan store). */
+function readSavedSettings(dir) {
+  if (!dir) return {}
+  try {
+    const data = JSON.parse(readFileSync(join(dir, 'settings.json'), 'utf8'))
+    return data && typeof data === 'object' && !Array.isArray(data) ? data : {}
+  } catch {
+    return {}
+  }
+}
+
+function writeSavedSettings(dir, data) {
+  if (!dir) return false
+  try {
+    mkdirSync(dir, { recursive: true })
+    const target = join(dir, 'settings.json')
+    const tmp = join(dir, `.settings-${process.pid}-${Date.now()}.json.tmp`)
+    writeFileSync(tmp, `${JSON.stringify(data, null, 2)}\n`, 'utf8')
+    renameSync(tmp, target)
+    return true
+  } catch {
+    return false
+  }
+}
+
 function readJsonBody(req) {
   return new Promise(resolve => {
     let size = 0
@@ -154,11 +186,56 @@ function normalizePromptMessages(prompt) {
 /**
  * Use the user's current default route only. Never send session evidence to
  * another configured provider/model just because it may respond faster.
+ *
+ * v0.1.6 model policy:
+ *   default — follow the host's current default model (previous behaviour)
+ *   fixed   — always use `fixedProvider`/`fixedModel` (only if resolvable)
+ *   auto    — within the default provider, prefer a model without reasoning efforts
+ * Without a host default route the generator falls back to heuristics (null).
  */
-async function pickModel(services) {
+async function pickModel(services, policy = null) {
   const llm = services.llm
   const selection = services.agentDefaultModel?.currentSelection?.()
-  if (!llm || !selection?.provider || !selection?.model) return null
+  if (!llm) return null
+  const mode = policy?.modelPolicy === 'fixed' ? 'fixed' : policy?.modelPolicy === 'auto' ? 'auto' : 'default'
+
+  if (mode === 'fixed' && policy?.fixedProvider && policy?.fixedModel) {
+    const route = { provider: policy.fixedProvider, model: policy.fixedModel, source: 'fixed' }
+    try {
+      const info = await llm.resolveModelInfo?.(route.provider, route.model)
+      if (info) {
+        const efforts = info?.reasoning?.efforts
+        if (Array.isArray(efforts) && efforts.length) route.reasoningEffort = efforts[0]?.id
+        return route
+      }
+    } catch {
+      /* fixed route unavailable: fall back to the host default below */
+    }
+  }
+
+  if (!selection?.provider || !selection?.model) return null
+
+  if (mode === 'auto') {
+    try {
+      const models = typeof llm.listModels === 'function' ? await llm.listModels(selection.provider) : []
+      for (const model of Array.isArray(models) ? models : []) {
+        const id = String(model?.id ?? '')
+        if (!id) continue
+        try {
+          const info = await llm.resolveModelInfo?.(selection.provider, id)
+          const efforts = info?.reasoning?.efforts
+          if (!Array.isArray(efforts) || efforts.length === 0) {
+            return { provider: selection.provider, model: id, source: 'auto' }
+          }
+        } catch {
+          /* try the next catalog entry */
+        }
+      }
+    } catch {
+      /* fall back to the host default */
+    }
+  }
+
   const route = { provider: selection.provider, model: selection.model, source: 'session-default' }
   try {
     const info = await llm.resolveModelInfo?.(route.provider, route.model)
@@ -247,14 +324,19 @@ export function apply(ctx, config = {}) {
     return Math.min(max, Math.max(min, number))
   }
   const rawConfig = config && typeof config === 'object' ? config : {}
+  const storageDir = expandStorageDir(rawConfig.storageDir, process.env.DSH_PLAN_COMPLETION_STORE_DIR)
+  const savedSettings = readSavedSettings(storageDir)
   const settings = {
     evidenceChars: readInt(rawConfig.evidenceChars, 1500, 400, 8000),
     maxTokensPatch: readInt(rawConfig.maxTokensPatch, 400, 120, 4000),
     maxTokensRewrite: readInt(rawConfig.maxTokensRewrite, 1200, 400, 8000),
     warmBackfill: rawConfig.warmBackfill !== false,
-    modelCalls: rawConfig.modelCalls !== false,
+    modelCalls: (typeof savedSettings.modelCalls === 'boolean' ? savedSettings.modelCalls : true) && rawConfig.modelCalls !== false,
+    modelPolicy: normalizeModelPolicy(savedSettings.modelPolicy ?? rawConfig.modelPolicy),
+    fixedProvider: typeof savedSettings.fixedProvider === 'string' ? savedSettings.fixedProvider.trim().slice(0, 120) : '',
+    fixedModel: typeof savedSettings.fixedModel === 'string' ? savedSettings.fixedModel.trim().slice(0, 120) : '',
     persistPlans: rawConfig.persistPlans !== false,
-    storageDir: expandStorageDir(rawConfig.storageDir, process.env.DSH_PLAN_COMPLETION_STORE_DIR),
+    storageDir,
     maxTokensVerify: readInt(rawConfig.maxTokensVerify, DEFAULTS.maxTokensVerify, 200, 2000),
     enableDebugRoutes: rawConfig.enableDebugRoutes === true,
     debugDir: typeof rawConfig.debugDir === 'string' && rawConfig.debugDir.trim() !== ''
@@ -337,6 +419,38 @@ export function apply(ctx, config = {}) {
     }
   }
 
+  async function settingsSnapshot(providerHint = '') {
+    const selection = services.agentDefaultModel?.currentSelection?.() ?? null
+    let providers = []
+    try {
+      providers = services.llm?.listProviders?.() ?? []
+    } catch {
+      providers = []
+    }
+    let models = []
+    let modelsProvider = ''
+    try {
+      modelsProvider = providerHint || selection?.provider || (Array.isArray(providers) ? providers[0]?.id : '')
+      if (modelsProvider && typeof services.llm?.listModels === 'function') {
+        models = (await services.llm.listModels(modelsProvider))?.map(m => ({ provider: modelsProvider, id: m?.id ?? '', name: m?.name ?? m?.id ?? '' })) ?? []
+      }
+    } catch { models = [] }
+    return {
+      modelPolicy: settings.modelPolicy,
+      fixedProvider: settings.fixedProvider,
+      fixedModel: settings.fixedModel,
+      modelCalls: settings.modelCalls,
+      defaultSelection: selection && selection.provider && selection.model
+        ? { provider: selection.provider, model: selection.model }
+        : null,
+      models,
+      modelsProvider,
+      providers: Array.isArray(providers)
+        ? providers.map(provider => ({ id: provider?.id ?? '', name: provider?.name ?? provider?.id ?? '' }))
+        : [],
+    }
+  }
+
   function publishState(sessionId, patch) {
     const previous = states.get(sessionId) ?? { plan: null, suggestion: null, stale: false }
     states.set(sessionId, { ...previous, ...patch })
@@ -633,7 +747,7 @@ export function apply(ctx, config = {}) {
           ]
         }
         try {
-          const route = await pickModel(services)
+          const route = await pickModel(services, settings)
           if (!isCurrent()) return
           debug.model = route
           debugLog({ phase: 'model-choice', sessionId, route })
@@ -1009,7 +1123,7 @@ export function apply(ctx, config = {}) {
               jsonResponse(res, 200, { ok: false, error: 'in-progress' })
               return
             }
-            const route = await pickModel(services)
+            const route = await pickModel(services, settings)
             if (!route) {
               jsonResponse(res, 200, { ok: false, error: 'no-model-route' })
               return
@@ -1077,6 +1191,54 @@ export function apply(ctx, config = {}) {
             }
             return
           }
+          if (pathname === `${ROUTE_PREFIX}settings` && method === 'GET') {
+            jsonResponse(res, 200, { ok: true, settings: await settingsSnapshot(url?.searchParams?.get('provider') ?? '') })
+            return
+          }
+          if (pathname === `${ROUTE_PREFIX}settings` && method === 'POST') {
+            const body = (await readJsonBody(req)) ?? {}
+            const next = { ...(await settingsSnapshot()) }
+            if (body.modelPolicy !== undefined) {
+              const policy = normalizeModelPolicy(body.modelPolicy)
+              if (policy !== String(body.modelPolicy).trim()) {
+                jsonResponse(res, 200, { ok: false, error: 'bad-model-policy' })
+                return
+              }
+              next.modelPolicy = policy
+            }
+            if (body.modelCalls !== undefined) {
+              if (typeof body.modelCalls !== 'boolean') {
+                jsonResponse(res, 200, { ok: false, error: 'bad-model-calls' })
+                return
+              }
+              next.modelCalls = body.modelCalls
+            }
+            for (const key of ['fixedProvider', 'fixedModel']) {
+              if (body[key] === undefined) continue
+              if (typeof body[key] !== 'string') {
+                jsonResponse(res, 200, { ok: false, error: 'bad-' + key })
+                return
+              }
+              next[key] = body[key].trim().slice(0, 120)
+            }
+            if (next.modelPolicy === 'fixed' && (!next.fixedProvider || !next.fixedModel)) {
+              jsonResponse(res, 200, { ok: false, error: 'missing-fixed-route' })
+              return
+            }
+            settings.modelPolicy = next.modelPolicy
+            settings.fixedProvider = next.fixedProvider
+            settings.fixedModel = next.fixedModel
+            settings.modelCalls = next.modelCalls
+            const saved = writeSavedSettings(settings.storageDir, {
+              modelPolicy: settings.modelPolicy,
+              fixedProvider: settings.fixedProvider,
+              fixedModel: settings.fixedModel,
+              modelCalls: settings.modelCalls,
+            })
+            debugLog({ phase: 'settings-updated', modelPolicy: settings.modelPolicy, saved })
+            jsonResponse(res, 200, { ok: true, saved, settings: await settingsSnapshot() })
+            return
+          }
           if (pathname === `${ROUTE_PREFIX}state` && method === 'GET') {
             const sessionId = url?.searchParams?.get('sessionId') ?? ''
             await hydrateSession(sessionId)
@@ -1297,7 +1459,7 @@ export function apply(ctx, config = {}) {
             experimentState.error = null
             void (async () => {
               try {
-                const route = await pickModel(services)
+                const route = await pickModel(services, settings)
                 if (!route) throw new Error('no-model-route')
                 const judgeRoute = await pickJudgeRoute(services, route)
                 debugLog({ phase: 'experiment-start', sessionId, route, judgeRoute })
@@ -1390,6 +1552,7 @@ export function apply(ctx, config = {}) {
       `${ROUTE_PREFIX}replan`,
       `${ROUTE_PREFIX}warm`,
       `${ROUTE_PREFIX}verify`,
+      `${ROUTE_PREFIX}settings`,
     ]
     if (settings.enableDebugRoutes) {
       paths.push(
@@ -1494,3 +1657,6 @@ export function apply(ctx, config = {}) {
   })
 }
 
+
+
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-plan-completion",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "private": false,
   "type": "module",
   "description": "Implicit session plans with Tab-completable next-message suggestions for DeepSeek Harness",