npm - dsh-auto-model-routing - Versions diffs - 0.5.0 → 0.5.2 - Mend

dsh-auto-model-routing 0.5.0 → 0.5.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (7) hide show

package/CHANGELOG.md CHANGED Viewed

@@ -1,5 +1,15 @@
 # Changelog
+## 0.5.2
+- README follows the standard plugin layout: demos side by side, then the architecture diagram, then the introduction; a closing section links the ohmydsh source, the MIT license and the issue tracker.
+- The release workflow now also creates the GitHub Release for each version and attaches the exact npm tarball. No runtime behavior changes.
+## 0.5.1
+- Replace both retired four-tier GIFs with high-resolution recordings of the current AUTO interaction, applied decision distribution and settings/strategy UI, using isolated mock services and synthetic tasks.
+- Show both demos side by side at the top of the English and Chinese READMEs; remove the obsolete demo disclaimer and folded settings recording. No runtime behavior changes.
 ## 0.5.0
 - **Breaking — one AUTO strategy.** The opt-in legacy four-tier chain is removed: the tier router and its rubric, the per-family `mainEfforts` / `childRoutes` mappings and their settings tabs, the reply-bar tier menu and `label` parameter, `judgements.jsonl` writes, `scripts/label-report.mjs` and the `eval/run.mjs` baseline. Default AUTO behavior (main effort, child capability routing, exact-child binding, Magpie transports, caps, allowlists, fork refusal) is unchanged.

package/README.md CHANGED Viewed

@@ -2,11 +2,14 @@
 English · [简体中文](README.zh.md)
-![AUTO interaction: toggle AUTO/MANUAL and inspect the decision](docs/auto-routing.gif)
+<p align="center">
+  <img src="docs/auto-routing.gif" alt="AUTO: switch modes, apply effort and inspect the decision distribution" width="49%">
+  <img src="docs/settings.gif" alt="Settings: decision service, connection test, defaults and strategy details" width="49%">
+</p>
-*Interaction recording from the earlier four-tier UI (isolated mock Host); current decisions use independent capability and depth as described below.*
+*Left: AUTO interaction and applied decision. Right: current settings and strategy details. Recorded from an isolated DSH host with local mock Jev/model responses and synthetic tasks.*
-[Repository](https://github.com/prgrmrwy/dsh-auto-model-routing) · [Releases](https://github.com/prgrmrwy/dsh-auto-model-routing/releases) · [npm](https://www.npmjs.com/package/dsh-auto-model-routing)
+![AUTO architecture — independent judgments, validated requests and allocation feedback](docs/architecture-v2.en.svg)
 <!-- problem -->
 **Add AUTO mode to DSH: automatic effort for the main agent, automatic model + effort for sub-agents.** Stop adjusting reasoning investment every turn or choosing a model for every delegated task.
@@ -90,23 +93,14 @@ AUTO applies the selected effort to the current main request and awaits official
 - **Local state:** configuration is under `$DSH_HOME/plugins/dsh-auto-model-routing/`; mode, child routes and feedback are under `$DSH_HOME/state/auto-model-routing/`. Feedback stores resource metadata, IDs, the strategy family, returned distributions and timestamps—not task/reply text. Request event IDs allow later usage correlation; costs are not fabricated when unavailable. See [feedback and evaluation](docs/feedback-evaluation.md).
 - **No automatic learning.** Human allocation feedback is observational. It does not change routing or prove quality/cost benefits. Old messages without decision bindings are not backfilled; old records with missing evaluation fields remain unknown.
 - **Upgrade to 0.5.0:** there is one AUTO strategy and no version setting. Existing sessions keep their stored mode; new chats still default to MANUAL unless configured otherwise. Retired `policy` / `mainEfforts` / `childRoutes` keys in the plugin configuration are ignored, shown as no longer effective in Settings, and removed on the next save. Child decisions and feedback recorded by 0.4.x stay readable. To go back, pin the published `dsh-auto-model-routing@0.4.2` (see [CHANGELOG](CHANGELOG.md) for the data boundary).
 ## Architecture
 <!-- section: architecture -->
-![AUTO architecture — independent judgments, validated requests and allocation feedback](docs/architecture-v2.en.svg)
-Main failures disable AUTO; child failures stop dispatch. Explicit model/effort constraints are preserved. The diagram shows the AUTO paths; MANUAL makes no new judgments and fork is unsupported. Feedback does not automatically alter routing.
+The diagram at the top shows the AUTO paths. Main failures disable AUTO; child failures stop dispatch. Explicit model/effort constraints are preserved. MANUAL makes no new judgments and fork is unsupported. Feedback does not automatically alter routing.
 Entry: [index.ts](src/index.ts). Enforcement: [policy-host.ts](src/policy-host.ts). Actual rubric: [rubric.json](src/rubric.json). Family strategies (supported models, transports, effort starting points, capability slots): [strategies](src/strategies/index.ts); routing: [routing.ts](src/routing.ts). UI: [client](src/client/index.ts). Coverage and limitations (historical records): [development verification](docs/policy-v2-development.md), [real Magpie acceptance](docs/magpie-live-acceptance.md).
-<details>
-<summary>Earlier four-tier UI demos (removed in 0.5.0)</summary>
-These isolated-host recordings use mock Jev/model responses and show a UI that no longer exists.
-![Earlier four-tier routing settings](docs/settings.gif)
-</details>
 ## Development
 ```sh
@@ -117,9 +111,7 @@ npm run build
 Tests use the official AgentLoop with fake LLM streams and mock/loopback Jev responses, not paid model calls. To observe AUTO decisions and their actual token usage, ask the agent to use the `auto-model-routing-report` skill (on demand only; it runs the read-only `lib/usage-report.js`). It is observational, not a savings measurement. Evaluation schema and deduplication rules are in [feedback-evaluation.md](docs/feedback-evaluation.md).
-Development stays in the source monorepo; this repository is its release mirror. The package builds and loads independently using its declared dependencies, bundled skill and official DSH services; no monorepo checkout or monorepo instruction file is required. External design references are optional background, not runtime inputs.
-The [current specification](https://github.com/prgrmrwy/ohmydsh/blob/main/openspec/specs/auto-model-routing/spec.md) lives in the source monorepo. The bundled [delegation skill](skills/subagent-model-routing/SKILL.md) supplies guidance; enforcement belongs to the official host hooks, not the prompt. No measured task-quality or token-savings claim is made.
+The package builds and loads independently using its declared dependencies, bundled skill and official DSH services; no monorepo checkout or monorepo instruction file is required. External design references are optional background, not runtime inputs. The bundled [delegation skill](skills/subagent-model-routing/SKILL.md) supplies guidance; enforcement belongs to the official host hooks, not the prompt. No measured task-quality or token-savings claim is made.
 ## Removal
 <!-- section: removal -->
@@ -129,3 +121,9 @@ dsh plugin --profile web remove dsh-auto-model-routing
 ```
 Restart DSH and refresh the page. The plugin's skill/tools and request hooks disappear; settings and logs remain. Without the plugin, child replay is no longer enforced and host restoration uses the original creation configuration. In [ohmydsh](https://github.com/prgrmrwy/ohmydsh), disable the local entry and rebuild instead.
+## Source, license and contributing
+This plugin is developed in [ohmydsh](https://github.com/prgrmrwy/ohmydsh) (`packages/auto-model-routing`); [this repository](https://github.com/prgrmrwy/dsh-auto-model-routing) is its release mirror, published automatically to [npm](https://www.npmjs.com/package/dsh-auto-model-routing) and [GitHub Releases](https://github.com/prgrmrwy/dsh-auto-model-routing/releases). The [current specification](https://github.com/prgrmrwy/ohmydsh/blob/main/openspec/specs/auto-model-routing/spec.md) lives there too.
+[MIT](LICENSE). Issues and pull requests are welcome at [prgrmrwy/dsh-auto-model-routing](https://github.com/prgrmrwy/dsh-auto-model-routing/issues) — including support for model families beyond Claude and GPT.

package/README.zh.md CHANGED Viewed

@@ -2,11 +2,14 @@
 [English](README.md) · 简体中文
-![AUTO 交互：切换 AUTO/MANUAL 并查看决策](docs/auto-routing.gif)
+<p align="center">
+  <img src="docs/auto-routing.gif" alt="AUTO：切换模式、应用推理投入并查看决策分布" width="49%">
+  <img src="docs/settings.gif" alt="设置：决策服务、连接测试、默认值与策略说明" width="49%">
+</p>
-*此交互录屏来自早期四档界面（隔离 mock 宿主）；当前策略按下文独立判断能力与投入。*
+*左：AUTO 交互与已应用的决策；右：当前设置页与策略说明。录制来自隔离 DSH 宿主，使用本地模拟 Jev/模型响应与合成任务。*
-[插件仓库](https://github.com/prgrmrwy/dsh-auto-model-routing) · [版本发布](https://github.com/prgrmrwy/dsh-auto-model-routing/releases) · [npm](https://www.npmjs.com/package/dsh-auto-model-routing)
+![AUTO 架构：独立判断、请求校验与分配反馈](docs/architecture-v2.zh.svg)
 <!-- problem -->
 **为 DSH 增加 AUTO 模式：主 Agent 自动调 effort，子 Agent 自动选 model + effort。** 不必每轮手动选择推理投入，也不必为每个子任务手动挑模型。
@@ -94,20 +97,10 @@ AUTO 将选定 effort 应用于本次主请求；effort 改变时，等待官方
 ## 架构
 <!-- section: architecture -->
-![AUTO 架构：独立判断、请求校验与分配反馈](docs/architecture-v2.zh.svg)
-主判断失败停用 AUTO，子失败停止派发；保留显式 model/effort。图示为 AUTO 路径，MANUAL 不做新判断，fork 暂不支持。反馈不会自动改变路由。
+顶部的架构图为 AUTO 路径。主判断失败停用 AUTO，子失败停止派发；保留显式 model/effort。MANUAL 不做新判断，fork 暂不支持。反馈不会自动改变路由。
 入口：[index.ts](src/index.ts)。执行接入：[policy-host.ts](src/policy-host.ts)。实际判据：[rubric.json](src/rubric.json)。家族策略（支持的模型、transport、effort 起点、能力槽）：[strategies](src/strategies/index.ts)；路由计算：[routing.ts](src/routing.ts)。界面：[client](src/client/index.ts)。覆盖边界（历史记录）：[开发验证](docs/policy-v2-development.md)、[真实 Magpie 验收](docs/magpie-live-acceptance.md)。
-<details>
-<summary>早期四档界面演示（已于 0.5.0 删除）</summary>
-下列隔离宿主录屏使用模拟 Jev/模型响应，展示的界面已不存在。
-![早期四档路由设置](docs/settings.gif)
-</details>
 ## 开发验证
 ```sh
@@ -118,9 +111,7 @@ npm run build
 测试使用官方 AgentLoop、假 LLM 流和 mock/回环 Jev，不产生真实模型费用。如需观察 AUTO 决策及实际 token 用量，请明确让 agent 使用 `auto-model-routing-report` skill（仅按需调用，运行只读的 `lib/usage-report.js`）；它是观察统计，不衡量节省；新数据结构与去重口径见[feedback-evaluation.md](docs/feedback-evaluation.md)。
-继续在主仓开发，本仓库仅作发布镜像。插件使用自身声明的依赖、包内 skill 和官方 DSH 服务即可独立构建与加载，不要求检出主仓，也不要求安装主仓环境指令。外部设计链接仅供背景阅读，不是运行输入。
-[当前规范](https://github.com/prgrmrwy/ohmydsh/blob/main/openspec/specs/auto-model-routing/spec.md)在源码 monorepo 中维护。包内[委派 skill](skills/subagent-model-routing/SKILL.md)提供指引，执行保障来自官方宿主钩子，而不是提示词。暂无完整任务质量或 token 节省的量化结论。
+插件使用自身声明的依赖、包内 skill 和官方 DSH 服务即可独立构建与加载，不要求检出主仓，也不要求安装主仓环境指令。外部设计链接仅供背景阅读，不是运行输入。包内[委派 skill](skills/subagent-model-routing/SKILL.md)提供指引，执行保障来自官方宿主钩子，而不是提示词。暂无完整任务质量或 token 节省的量化结论。
 ## 移除
 <!-- section: removal -->
@@ -130,3 +121,9 @@ dsh plugin --profile web remove dsh-auto-model-routing
 ```
 重启 DSH 并刷新页面。插件的 skill、工具和请求钩子撤销，配置与日志保留。关闭插件后不再执行子路由恢复，宿主使用原始创建配置。在 [ohmydsh](https://github.com/prgrmrwy/ohmydsh) 中则禁用 local 条目并重新构建。
+## 来源、许可与参与
+本插件在 [ohmydsh](https://github.com/prgrmrwy/ohmydsh)（`packages/auto-model-routing`）中持续开发，[本仓库](https://github.com/prgrmrwy/dsh-auto-model-routing)是发布镜像，自动发布到 [npm](https://www.npmjs.com/package/dsh-auto-model-routing) 与 [GitHub Releases](https://github.com/prgrmrwy/dsh-auto-model-routing/releases)。[当前规范](https://github.com/prgrmrwy/ohmydsh/blob/main/openspec/specs/auto-model-routing/spec.md)也在主仓维护。
+采用 [MIT](LICENSE) 许可。欢迎到 [prgrmrwy/dsh-auto-model-routing](https://github.com/prgrmrwy/dsh-auto-model-routing/issues) 提 issue 和 PR，包括支持 Claude、GPT 以外的模型家族。

package/docs/SCREENSHOTS.md CHANGED Viewed

@@ -2,5 +2,5 @@
 | file | kind | source | date | reviewer | verdict | note |
 | --- | --- | --- | --- | --- | --- | --- |
-| auto-routing.gif | screenshot | isolated DSH_HOME instance (temp HOME/XDG/DSH_HOME under /tmp, port 3199), synthetic data: local mock model and mock Jev on loopback, demo prompts; recorded with agent-browser, converted with ffmpeg | 2026-10-23 | lead | pass (viewed frames: demo prompts and mock replies only; no hostname, user, path, token or real session) | AUTO chip, decision hint, hover panel, switch to MANUAL |
-| settings.gif | screenshot | same isolated instance and recording run as auto-routing.gif | 2026-10-23 | lead | pass (viewed frames: settings section only; key field empty, source shown as launch environment of the isolated process) | Settings → 自动模型路由, Claude/GPT routing maps |
+| auto-routing.gif | screenshot | isolated DSH_HOME under /tmp, port 3199; current plugin UI with local loopback mock Jev and model streaming responses; Playwright/CDP lossless 2x screenshots, global-palette GIF | 2026-10-28 | lead | pass (reviewed source frames: synthetic task/reply, complete conversation and decision panel; no real credentials or user data) | 1840x1600, 207702 bytes; MANUAL → AUTO, same-model medium → high, applied decision with returned distribution, back to MANUAL |
+| settings.gif | screenshot | same isolated host; lossless 2x screenshots box-filtered to 1137x1070 | 2026-10-28 | lead | pass (reviewed source frames: full settings dialog, empty key input, synthetic loopback endpoint; no real credentials) | 385416 bytes; decision service menu, successful mock connection test, default mode, effort cap, save and expand current strategy details; replaces the retired four-tier demo |

package/docs/auto-routing.gif CHANGED Viewed

Binary file

package/docs/settings.gif CHANGED Viewed

Binary file

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "dsh-auto-model-routing",
-  "version": "0.5.0",
+  "version": "0.5.2",
   "description": "DeepSeek Harness plugin: independent Jev capability and effort decisions, enforced fresh-child routes, decision visibility and allocation feedback",
   "license": "MIT",
   "author": "prgrmrwy",