Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
64 changes: 64 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,70 @@ adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
The GitHub Release body is extracted from this file: everything between the release's
`## [vX.Y.Z]` heading and the next `## [` heading. Keep that section self-contained.

## [v0.3.4] - 2026-11-13

Console settings release. It refreshes the Console settings experience added around 0.3
without changing the 29-tool MCP surface, graph/event/sync formats, host adapters or stored
data. There is no migration.

### Added

- **Settings v2 shell** — a 760×720 settings modal (760×680 for About device) with a 160px
left rail on desktop, a horizontal tab strip at 900px and below, and a full-screen layout
on narrow screens. The six sections are General, Security, Memory, Integrations, MCP and
Advanced; About device is a separate entry.
- **Memory and integration IA** — the Memory section now owns the memory mode, model source,
runtime status and model status; Integrations owns Agent configuration. Memory mode is a
compact segmented control, with long explanations kept out of the layout.
- **Consistent settings rows** — 40/58px row templates, a 150/1fr/68 field grid, 27px
controls, grouped panels, three 114px security cards, always-visible configured/effective/
reason warning rows, and an About device page with three groups and three folds.
- **Responsive, accessible and bilingual coverage** — layout baselines at 1440/1024/900/390,
English and Chinese copy, reduced-motion behavior, settings deep links, fixed-position
service menu, focus return, and expanded Console UI smoke assertions.
- **CI reliability** — Windows-only bounded test retries, a slower local sidecar health
probe, a regression test for delayed health responses, and retry-safe Windows temp-file
cleanup. These are test/infrastructure changes, not new product capabilities.

### Changed

- Settings tabs now use **集成 / Integrations** (formerly AI 助手 / Assistants) and
**记忆 / Memory** (formerly 记忆运行时 / runtime), while the underlying agent and runtime
configuration remains compatible.
- The settings shell no longer scrolls as a whole: the header and rail stay fixed and only
the content column scrolls. Rows remain single-line at 900px and stack cleanly on mobile.
- Routine settings hints are carried by group/control `title` text; only actionable
warnings, pending restarts and security exceptions stay visible in the layout.
- The public MCP tool count, CLI commands, graph/event/sync formats and data layout are
unchanged. This is a Console-only release.

### Fixed

- **Settings tab overflow** — the expanded English tab set no longer overflows the settings
strip by 5px at 1440/1024.
- **Truthful dormant states** — sidecar tests accept `mcp/degraded` when a clean drain cannot
be confirmed, while still asserting no new writes, no outbox flush, `409 mode_mismatch`
and correct resume behavior.
- **Slow-health false 503s** — a 200ms local health probe could mark a busy sidecar
unavailable; the timeout is now 1000ms and covered by a 300ms regression test.
- **Windows cleanup races** — provisioning harness cleanup is bounded-retry and best-effort,
so a transient file lock no longer fails the suite; Windows timing-sensitive tests retry
at most twice while persistent failures still fail.
- **Settings smoke assertions** — aligned with the current IA (`Integrations`, `Add agent`,
active tab order) and the updated security/about layout.

### Verification

- Main CI run `43376114600` passed Linux build/test/lint (including Console UI smoke),
Windows build/test/lint, DSH E2E, desktop smoke, semantic recall and WAN NAT.
- Packaging dry-run run `43377170059` passed verify, the eight npm tarballs, Hermes bundle,
macOS/Windows/Linux desktop builds and the full DSH E2E matrix. Publish, visibility and
GitHub Release were correctly skipped; no registry or Release mutation occurred.
- `verify:console` passed; the headless Console UI smoke covers the settings v2 layout,
security cards, About device, responsive breakpoints, bilingual copy and reduced motion.
- The formal `release/v0.3.4` run reruns the same gate before publishing. Desktop packages
remain unsigned.

## [v0.3.2] - 2026-11-06

Memory Runtime stability release. It makes lifecycle, local data, detail evidence,
Expand Down
8 changes: 4 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -72,14 +72,14 @@ Memory and tasks stay on your devices; devices sync directly.
<table width="100%">
<thead>
<tr>
<th align="left" width="30%">Desktop app · v0.3.2</th>
<th align="left" width="30%">Desktop app · v0.3.4</th>
<th align="left">Download &amp; first launch</th>
</tr>
</thead>
<tbody>
<tr>
<td><strong>Unsigned release</strong><br><sub>macOS Universal · Windows x64 · Linux x64</sub></td>
<td><a href="https://github.com/Windsander/Mebular/releases/tag/v0.3.2">Download from GitHub Releases</a><br><sub>Verify with <code>SHA256SUMS.txt</code>. macOS: right-click → <strong>Open</strong>. Windows: <strong>More info → Run anyway</strong>. Bundles Electron and its runtime.</sub></td>
<td><a href="https://github.com/Windsander/Mebular/releases/tag/v0.3.4">Download from GitHub Releases</a><br><sub>Verify with <code>SHA256SUMS.txt</code>. macOS: right-click → <strong>Open</strong>. Windows: <strong>More info → Run anyway</strong>. Bundles Electron and its runtime.</sub></td>
</tr>
</tbody>
</table>
Expand Down Expand Up @@ -146,7 +146,7 @@ mebular print-config --client opencode # MCP config

<p align="center"><strong>Use with DSH</strong><br>
Install the plugin from npm into DSH's web profile:<br>
<code>dsh plugin --profile web add @mebular/dsh-plugin@0.3.2</code><br>
<code>dsh plugin --profile web add @mebular/dsh-plugin@0.3.4</code><br>
The App and the DSH Plugin are two equal entries to one local Mebular runtime: the plugin defaults to <code>attach</code> and connects to an existing App/CLI/service without starting or downloading anything. If no runtime exists, the panel explicitly offers a pinned shared-runtime install. The sidebar panel embeds the same Console through <code>?embed=dsh</code> (loopback only), and the official MCP client reaches the same graph. The plugin is an independent adapter with its code isolated in <code>packages/dsh-plugin</code>; it is published by its own npm job, while its version follows the unified release train. For plugin development, install from <code>packages/dsh-plugin</code> instead.<br>
Listed on <a href="https://github.com/awesome-dsh-plugin/awesome-dsh-plugin">awesome-dsh-plugin</a> under <code>memory</code>.<br>
<a href="packages/dsh-plugin/README_EN.md">DSH plugin guide →</a> · <a href="docs/integrations/DSH.md">Integration notes →</a></p>
Expand Down Expand Up @@ -183,6 +183,6 @@ Runnable examples: [`examples/quickstart`](examples/quickstart/index.mjs) writes

<div align="center">

v0.3.2 · early · MIT · © 2026 Sobert Li
v0.3.4 · early · MIT · © 2026 Sobert Li

</div>
8 changes: 4 additions & 4 deletions README_CN.md
Original file line number Diff line number Diff line change
Expand Up @@ -72,14 +72,14 @@
<table width="100%">
<thead>
<tr>
<th align="left" width="30%">桌面 App · v0.3.2</th>
<th align="left" width="30%">桌面 App · v0.3.4</th>
<th align="left">下载与首次打开</th>
</tr>
</thead>
<tbody>
<tr>
<td><strong>未签名发布</strong><br><sub>macOS Universal · Windows x64 · Linux x64</sub></td>
<td><a href="https://github.com/Windsander/Mebular/releases/tag/v0.3.2">从 GitHub Releases 下载</a><br><sub>用 <code>SHA256SUMS.txt</code> 校验。macOS:右键 →「打开」;Windows:「更多信息 → 仍要运行」。自带 Electron 与 runtime。</sub></td>
<td><a href="https://github.com/Windsander/Mebular/releases/tag/v0.3.4">从 GitHub Releases 下载</a><br><sub>用 <code>SHA256SUMS.txt</code> 校验。macOS:右键 →「打开」;Windows:「更多信息 → 仍要运行」。自带 Electron 与 runtime。</sub></td>
</tr>
</tbody>
</table>
Expand Down Expand Up @@ -146,7 +146,7 @@ mebular print-config --client opencode # MCP 配置

<p align="center"><strong>与 DSH 一起使用</strong><br>
从 npm 把插件装入 DSH 的 web profile:<br>
<code>dsh plugin --profile web add @mebular/dsh-plugin@0.3.2</code><br>
<code>dsh plugin --profile web add @mebular/dsh-plugin@0.3.4</code><br>
App 与 DSH Plugin 是同一套本机 Mebular runtime 的两个等权入口:插件默认 <code>attach</code>,已有 App/CLI/service 时直接连接,不会启动或下载任何东西。完全没有 runtime 时,面板会先询问,再按需安装固定版本共享 runtime。侧边栏面板通过 <code>?embed=dsh</code>(仅 loopback)嵌入同一套 Console,官方 MCP client 连接同一张图。插件是独立适配器,代码隔离在 <code>packages/dsh-plugin</code>;它由独立 npm job 发布,版本随统一 release train;开发时仍可从 <code>packages/dsh-plugin</code> 本地安装。<br>
已收录于 <a href="https://github.com/awesome-dsh-plugin/awesome-dsh-plugin">awesome-dsh-plugin</a> 的 <code>memory</code> 分类。<br>
<a href="packages/dsh-plugin/README.md">DSH 插件指南 →</a> · <a href="docs/integrations/DSH_CN.md">集成说明 →</a></p>
Expand Down Expand Up @@ -183,6 +183,6 @@ await mebular.initialize();

<div align="center">

v0.3.2 · early · MIT · © 2026 Sobert Li
v0.3.4 · early · MIT · © 2026 Sobert Li

</div>
4 changes: 2 additions & 2 deletions RELEASE.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,8 +10,8 @@ The release operations for this repository live under `docs/operations/`:
- [Changelog](CHANGELOG.md) — release notes; the `## [vX.Y.Z]` section is the source of the
GitHub Release body.

The current release line is **v0.3.2**: a single-version umbrella with eight npm packages at
`0.3.2` (`core`, `service`, `skill`, `mcp`, `fleet`, `memory-runtime`,
The current release line is **v0.3.4**: a single-version umbrella with eight npm packages at
`0.3.4` (`core`, `service`, `skill`, `mcp`, `fleet`, `memory-runtime`,
`opencode-plugin`, `dsh-plugin`), and unsigned desktop installers for macOS, Windows and
Linux. The DSH plugin is an isolated adapter published by its own npm job, but it follows
the unified release train; no release ships the DSH plugin alone. `bump_version.sh` updates
Expand Down
8 changes: 4 additions & 4 deletions apps/desktop/README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Mebular 桌面 App(apps/desktop)

> v0.3.2:**壳 + 守护托管 + 内嵌控制台 + 发布 tarball 运行时 + 三平台 unsigned 安装包**。
> v0.3.4:**壳 + 守护托管 + 内嵌控制台 + 发布 tarball 运行时 + 三平台 unsigned 安装包**。
> 安装包 runtime 来自与 npm 发布同一批 verify tarball;签名、公证与自动更新留到后续版本。
> 发布操作见 [`docs/operations/DESKTOP_RELEASE.md`](../../docs/operations/DESKTOP_RELEASE.md)。

Expand All @@ -13,7 +13,7 @@ Electron 薄壳:把**既有控制台**(`127.0.0.1:<port>/console`)装进

```
apps/desktop/
├── package.json # private + 0.3.2(与八个 npm 包同版本)
├── package.json # private + 0.3.4(与八个 npm 包同版本)
├── electron-builder.yml # 安装包配置(runtime/node_modules → resources/node_modules)
├── runtime/ # 发布 tarball 安装出的运行时(不入库)
├── src/main/ # Electron 主进程:daemon.mjs(托管逻辑,纯可测)/ index.mjs(壳)/ ipc.mjs / tray-icons.mjs
Expand All @@ -32,7 +32,7 @@ npm run dev -- --home ~/.mebular --port 7331 # 透传参数(可选)
npm run smoke # 无 GUI 有界冒烟(CI 用)
```

## 安装包(v0.3.2,unsigned)
## 安装包(v0.3.4,unsigned)

安装包里的 Mebular 运行时**不来自仓库源码目录**,而是先用 `npm pack` 产出六个发布
tarball,再由 `prepare-runtime` 一次性 `npm install --omit=dev --ignore-scripts` 到
Expand Down Expand Up @@ -98,7 +98,7 @@ npm run verify:desktop:assets -- \
--require-hermes
```

> v0.3.2 产物**未签名、未公证**:macOS Gatekeeper 要求右键 → 打开(或系统设置 → 隐私与
> v0.3.4 产物**未签名、未公证**:macOS Gatekeeper 要求右键 → 打开(或系统设置 → 隐私与
> 安全性 → 仍要打开),Windows SmartScreen 要求「更多信息 → 仍要运行」。发布前先用
> Release 的 `SHA256SUMS.txt` 校验。签名、公证与自动更新留到后续版本;完整说明见
> [`docs/operations/DESKTOP_RELEASE.md`](../../docs/operations/DESKTOP_RELEASE.md)。
Expand Down
4 changes: 2 additions & 2 deletions apps/desktop/package-lock.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion apps/desktop/package.json
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
"name": "@mebular/desktop",
"productName": "Mebular",
"desktopName": "mebular",
"version": "0.3.2",
"version": "0.3.4",
"private": true,
"description": "Mebular 桌面应用(Electron 壳 + 内嵌控制台 + 守护托管)",
"license": "MIT",
Expand Down
2 changes: 1 addition & 1 deletion apps/desktop/src/main/daemon.mjs
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ import { homedir } from 'node:os';
import { dirname, join, resolve } from 'node:path';
import { fileURLToPath, pathToFileURL } from 'node:url';

export const APP_VERSION = '0.3.2';
export const APP_VERSION = '0.3.4';
export const SERVICE_KIND = 'mebular-serve';
/** App 注册到 <cloudRoot>/runtime-providers.json 的能力(只写发现信息,不写 token/身份)。 */
export const APP_RUNTIME_PROVIDER_CAPABILITIES = Object.freeze(['serve']);
Expand Down
4 changes: 3 additions & 1 deletion docs/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -53,7 +53,8 @@ main [`README.md`](../README.md); this index only describes document structure.
[E2a2](console/screens/e2a2/README.md) ·
[security tiers](console/screens/security-tiers/README.md) ·
[U1](console/screens/u1/README.md) ·
[U3](console/screens/u3/README.md)
[U3](console/screens/u3/README.md) ·
[U4 settings v2](console/screens/u4-settings-redesign/README.md)

## Design

Expand All @@ -66,6 +67,7 @@ main [`README.md`](../README.md); this index only describes document structure.

## Quality and release evidence

- [v0.3.4 verification](quality/0.3.4-verification.md) — Console settings redesign scope, SSOT/build/lint/docs checks and release dry-run
- [v0.3.2 verification matrix](quality/0.3.2-verification.md) — final test counts, host boundaries, scale/model evidence and explicit pending items
- [v0.3.2 scale benchmark](quality/0.3.2-scale-benchmark.md) — 1k/2k/10k count audits, performance, resources, failure injection and preserved 10k failure history
- [v0.3.2 real-model canary](quality/0.3.2-model-smoke.md) — Qwen3-4B Q4_K_M on macOS x64 with a test-only mirror; records the default-HF failure and exact boundary
Expand Down
14 changes: 7 additions & 7 deletions docs/integrations/DSH.md
Original file line number Diff line number Diff line change
Expand Up @@ -36,7 +36,7 @@ resolve`/`supervise`) and daemon HTTP endpoints.
Install from npm into the DSH web profile:

```bash
dsh plugin --profile web add @mebular/dsh-plugin@0.3.2
dsh plugin --profile web add @mebular/dsh-plugin@0.3.4
```

For development:
Expand Down Expand Up @@ -371,10 +371,10 @@ panel header displays. If they differ, the header tooltip shows the runtime vers
"runtimeMode": "reused",
"managed": false,
"panel": true,
"version": "0.3.2",
"pluginVersion": "0.3.2",
"version": "0.3.4",
"pluginVersion": "0.3.4",
"profile": { "id": "default", "name": "My Cloud" },
"provider": { "kind": "app", "source": "registry", "version": "0.3.2" },
"provider": { "kind": "app", "source": "registry", "version": "0.3.4" },
"service": { "registered": false, "running": false, "foreign": false },
"downloadRequired": false,
"install": { "state": "idle", "allowed": true },
Expand Down Expand Up @@ -483,13 +483,13 @@ single daemon, service, update locks and upgrade rollback are covered by CI and

## Release and version

- Version: `0.3.2`, on the unified Mebular v0.3.2 release train (seven lockstep npm
- Version: `0.3.4`, on the unified Mebular v0.3.4 release train (seven lockstep npm
packages plus the isolated `dsh-plugin` share the same version).
- npm: `@mebular/dsh-plugin@0.3.2`.
- npm: `@mebular/dsh-plugin@0.3.4`.
- The Plugin is an isolated adapter in `packages/dsh-plugin`, published by its
own npm job. It reads the pinned runtime version from its own `package.json`,
so a release bump needs no Plugin source edit.
- Publish `@mebular/core@0.3.2` before `@mebular/dsh-plugin@0.3.2`; see
- Publish `@mebular/core@0.3.4` before `@mebular/dsh-plugin@0.3.4`; see
[Release SOP](../operations/RELEASE.md).
- Listed in the `memory` category of
[awesome-dsh-plugin](https://awesome-dsh-plugin.com/p/Windsander/Mebular--packages-dsh-plugin/).
Expand Down
14 changes: 7 additions & 7 deletions docs/integrations/DSH_CN.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@ supervisor 的 `runtime resolve`/`supervise` 和 daemon HTTP 端点工作。
从 npm 安装到 DSH 的 Web profile:

```bash
dsh plugin --profile web add @mebular/dsh-plugin@0.3.2
dsh plugin --profile web add @mebular/dsh-plugin@0.3.4
```

开发时从工作树安装:
Expand Down Expand Up @@ -318,10 +318,10 @@ HTTP 请求,不是整个 DSH 插件完全不注册 listener/timer。
"runtimeMode": "reused",
"managed": false,
"panel": true,
"version": "0.3.2",
"pluginVersion": "0.3.2",
"version": "0.3.4",
"pluginVersion": "0.3.4",
"profile": { "id": "default", "name": "我的忆云" },
"provider": { "kind": "app", "source": "registry", "version": "0.3.2" },
"provider": { "kind": "app", "source": "registry", "version": "0.3.4" },
"service": { "registered": false, "running": false, "foreign": false },
"downloadRequired": false,
"install": { "state": "idle", "allowed": true },
Expand Down Expand Up @@ -417,11 +417,11 @@ npm run verify:runtime:coexistence

## 发布与版本

- 版本:`0.3.2`,随统一 Mebular v0.3.2 release train(七个 lockstep npm 包加独立的 `dsh-plugin` 同版本)
- npm:`@mebular/dsh-plugin@0.3.2`
- 版本:`0.3.4`,随统一 Mebular v0.3.4 release train(七个 lockstep npm 包加独立的 `dsh-plugin` 同版本)
- npm:`@mebular/dsh-plugin@0.3.4`
- 插件是独立适配器:代码隔离在 `packages/dsh-plugin`,由独立 npm job 发布;插件运行时从
自己的 `package.json` 读取 pinned runtime 版本,发布 bump 不需要改插件源码。
- 发布先 `@mebular/core@0.3.2`,再 `@mebular/dsh-plugin@0.3.2`;详见
- 发布先 `@mebular/core@0.3.4`,再 `@mebular/dsh-plugin@0.3.4`;详见
[发布 SOP](../operations/RELEASE.md)。
- 插件已收录于
[awesome-dsh-plugin](https://awesome-dsh-plugin.com/zh/p/Windsander/Mebular--packages-dsh-plugin/)
Expand Down
6 changes: 3 additions & 3 deletions docs/integrations/HERMES.md
Original file line number Diff line number Diff line change
Expand Up @@ -97,15 +97,15 @@ when the MCP setting `memoryRuntime.enabled=true` (or when you start it manually
While it is ready, `<home>/memory-runtime.json` exists and contains the sidecar URL
plus `tokenFile` (normally `<home>/memory-runtime/host-token`).

3. Install the provider from the release bundle (available **after** the 0.3.2
3. Install the provider from the release bundle (available **after** the 0.3.4
release; use the source command below before the release). The provider must be
installed as `plugins/mebular`, because Hermes uses the directory name as the value
of `memory.provider`:

```bash
gh release download v0.3.2 -p 'mebular-hermes-plugins-*.tar.gz'
gh release download v0.3.4 -p 'mebular-hermes-plugins-*.tar.gz'
mkdir -p mebular-hermes-plugins
tar -xzf mebular-hermes-plugins-0.3.2.tar.gz -C mebular-hermes-plugins
tar -xzf mebular-hermes-plugins-0.3.4.tar.gz -C mebular-hermes-plugins
cd mebular-hermes-plugins

HERMES_HOME="${HERMES_HOME:-$HOME/.hermes}" ./install.sh
Expand Down
Loading
Loading