@foggy-projects/deepseek-harness-plugin 0.4.0-rc.2 → 0.4.1-rc.1

package/README.md

@@ -3,31 +3,55 @@
 This package is the lightweight DeepSeek Harness Bundle for Foggy's Java data
 analysis engine. Installing the Bundle adds a native Foggy tab under **Settings
 → Plugins**. The private Python runtime, Launcher, and isolated CLI environment
-are downloaded only when the user selects **Initialize Foggy**.
+are downloaded only when the user selects **Initialize and start** (or the
+equivalent component action). Existing installations are not silently changed
+when the plugin package is upgraded.
 
-DeepSeek Harness uses a system Node.js (`^22.19.0 || >=24.0.0`) and Foggy's Java
-Launcher uses a system Java 17+. Foggy manages its own pinned Python 3.12 runtime
+The `0.4.1-rc.1` compatibility candidate targets DeepSeek Harness `0.1.5-rc.2`
+and requires a system Node.js `>=24.0.0`. Foggy's Java Launcher uses a system
+Java 17+. Foggy manages its own pinned Python 3.12 runtime
 inside the per-user component directory; it does not require a system Python,
 modify `PATH`, or register Python globally. Advanced users may explicitly set
 `FOGGY_PYTHON` to a compatible Python 3.11+ executable.
 
-## Local beta installation
+## Local release-candidate installation
 
 ```powershell
-dsh plugin --profile web add --workspace-root ./foggy-projects-deepseek-harness-plugin-0.4.0-rc.2.tgz
+dsh plugin --profile web add --workspace-root ./foggy-projects-deepseek-harness-plugin-0.4.1-rc.1.tgz
 ```
 
 Restart `dsh web`, use the browser it opens (or the complete printed URL,
 including `?token=...`), open Settings → Plugins → Foggy Data Analysis, and
 initialize the components from there. Do not share the launch-token URL.
 
-After npm beta publication, the corresponding one-line install is:
+For the DSH 0.1.5-rc.2 compatibility pre-release, install the exact candidate
+so the stable `beta` channel is not changed:
+
+```powershell
+dsh plugin --profile web add --workspace-root @foggy-projects/deepseek-harness-plugin@0.4.1-rc.1
+```
+
+The published candidate is also available through the dedicated `dsh015` npm
+dist-tag:
+
+```powershell
+dsh plugin --profile web add --workspace-root @foggy-projects/deepseek-harness-plugin@dsh015
+```
+
+For the existing stable beta channel, the corresponding one-line install is:
 
 ```powershell
 dsh plugin --profile web add --workspace-root @foggy-projects/deepseek-harness-plugin@beta
 ```
 
-DeepSeek Harness 0.1.2-rc.1 applies pnpm's minimum-release-age policy to its
+After updating the plugin package, open **Settings → Plugins → Foggy Data
+Analysis** and use **Update components** (or **Update and start**) to download
+the pinned CLI, Launcher, and Skills. The settings page shows current and target
+versions. Updates are blocked while Runtime is running so the active Java
+process and the next-launcher state cannot diverge. Component-specific repair
+actions remain available under **Advanced repair**.
+
+DeepSeek Harness 0.1.5-rc.2 applies pnpm's minimum-release-age policy to its
 profile lockfile. An upgrade performed shortly after publication can therefore
 fail while naming either the new plugin or the previously installed Beta. This
 is a DSH profile-policy failure, not a damaged Foggy package. Use the exact
@@ -104,10 +128,21 @@ rollback plan.
 
 See [`docs/PUBLIC-BETA-READINESS.md`](./docs/PUBLIC-BETA-READINESS.md) for the
 tested public Beta scope, release gates, and stable-release blockers.
+The DSH 0.1.5-rc.2 compatibility candidate is documented in
+[`docs/RELEASE-CANDIDATE-0.4.1-DSH-0.1.5-RC.1.md`](./docs/RELEASE-CANDIDATE-0.4.1-DSH-0.1.5-RC.1.md).
 Native Windows acceptance instructions are in
 [`docs/WINDOWS-BETA-ACCEPTANCE.md`](./docs/WINDOWS-BETA-ACCEPTANCE.md); database
 credentials intentionally remain outside the public repository.
 
+## Community discovery
+
+DeepSeek Harness does not currently publish a first-party plugin marketplace.
+For discoverability, this repository is intended to carry the GitHub
+[`dsh-plugin`](https://github.com/topics/dsh-plugin) topic. Independent community
+directories and their submission rules are tracked in
+[`docs/COMMUNITY-MARKETPLACES.md`](./docs/COMMUNITY-MARKETPLACES.md); inclusion in
+any directory is community curation, not an endorsement by DeepSeek or Foggy.
+
 ## Linux and WSL2 experience
 
 Ubuntu and WSL2 users can use the checked-in preflighted installer under

package/docs/COMMUNITY-MARKETPLACES.md

@@ -0,0 +1,64 @@
+# DeepSeek Harness 社区插件目录准备
+
+状态记录：2026-09-06。DeepSeek Harness 官方页面仍标注为开发者预览版，
+官方公开入口是源码、开发者文档、GitHub `dsh-plugin` Topic 和社区讨论，
+目前没有看到官方一方插件市场或官方审核收录入口。
+
+## 推荐顺序
+
+### 1. `awesome-dsh-plugin`（优先提交）
+
+- 目录仓库：<https://github.com/awesome-dsh-plugin/awesome-dsh-plugin>
+- 提交方式：向该仓库提交 PR，只新增一个
+  `data/plugins/foggy-projects__foggy-deepseek-harness-plugin.yml` 文件。
+- 主要要求：真实可用代码、仓库至少存在 1 天、添加 `dsh-plugin` Topic、
+  描述准确且不使用夸张营销语句、根包声明 `dsh.bundle`。
+- 可选增强：在 npm 发布包中保留正确的 `repository` 字段；如提供 GitHub
+  Release `.tgz`，可在条目中声明固定版本的 `tarball`。
+- 评审说明：CI 检查格式和 manifest，维护者会阅读目标仓库；收录不等于
+  安全审计或官方认证。
+
+建议条目草稿：
+
+```yaml
+url: https://github.com/foggy-projects/foggy-deepseek-harness-plugin
+name: foggy-projects/foggy-deepseek-harness-plugin
+category: tools
+description:
+  en: Foggy Java data-analysis integration for DeepSeek Harness with a managed Runtime, CLI, Launcher, onboarding Skills, and semantic-layer workflows.
+  zh: 在 DeepSeek Harness 中管理 Foggy Java 数据分析 Runtime、CLI、Launcher 与 onboarding/语义查询 Skill，支持数据库接入和语义层建模。
+```
+
+### 2. `dsh-market`（市场应用，目录来自上游）
+
+- 项目：<https://github.com/dsh-market/dsh-market>
+- 它是可安装到 DSH 设置页的社区市场应用，本身不是目录数据源。
+- 目录来自 `awesome-dsh-plugin`；其说明要求向上游目录提交 PR，
+  市场会自动同步，通常不需要重复提交到 `dsh-market`。
+- 适合验证“一键安装”体验，但它不是 DeepSeek 官方产品。
+
+### 3. `DSH-Plugins-Marketplace`（Topic 自动聚合）
+
+- 项目：<https://github.com/bradeGithub/DSH-Plugins-Marketplace>
+- 通过 GitHub `dsh-plugin` Topic 自动聚合，项目讨论中说明无需手工 PR，
+  Topic 出现后等待索引刷新即可。
+- 它会安装到 DSH Web profile，适合做第二个发现入口；必须标注为第三方市场。
+
+### 4. `dshplugin.app`（独立目录与证据页）
+
+- 目录：<https://dshplugin.app/>
+- 支持提交公开 GitHub 仓库，随后进行源码、manifest、依赖、安装路径和兼容性
+  信号分析。
+- 页面明确声明其为独立社区项目，不隶属于 DeepSeek；“Indexed”不等于安全认证。
+- 适合补充兼容性说明和安全信号展示，但不应把它描述为官方市场。
+
+## 当前可执行清单
+
+1. 保持当前 npm `rc` 预发布与 GitHub Release，不切换 `latest`。
+2. 给 GitHub 仓库添加 `dsh-plugin` Topic；可同时保留
+   `deepseek-harness`、`data-analysis`、`semantic-layer` 等描述性 Topic。
+3. 确认下一次 npm 发布继续携带 `repository`、`homepage`、`bugs` 和
+   `dsh-plugin` keywords，便于目录把 npm 包与源码仓库关联。
+4. 优先向 `awesome-dsh-plugin` 提交上面的单文件 PR，再等待 `dsh-market`
+   同步；随后向 `dshplugin.app` 提交公开仓库 URL。
+5. 对外文案统一使用“社区目录/第三方市场”，不使用“官方市场/官方认证”。

package/docs/RELEASE-CANDIDATE-0.4.0-RC.3.md

@@ -0,0 +1,18 @@
+# Foggy DeepSeek Harness plugin 0.4.0-rc.3 release candidate
+
+Assessment date: 2026-09-06
+
+## Delta from rc.2
+
+- Add a single **Initialize and start** action for first use.
+- Add **Update components** and **Update and start** actions for managed CLI,
+  Launcher, and Skill assets after a plugin-package upgrade.
+- Show current versus target component versions and an explicit update banner.
+- Block component update/repair while Runtime is running; the active Launcher
+  process must not diverge from the persisted next-launcher version.
+- Keep Refresh, diagnostics, and component-specific repair actions in the
+  secondary/advanced action areas.
+- Add public documentation, plugin repository, release, and Runtime project
+  links to the settings page.
+
+No Java engine or `foggy-runtime-cli` source was changed.

package/docs/RELEASE-CANDIDATE-0.4.1-DSH-0.1.5-RC.1.md

@@ -0,0 +1,60 @@
+# Foggy DeepSeek Harness plugin 0.4.1-rc.1
+
+This release candidate is the compatibility line for DeepSeek Harness
+`0.1.5-rc.2`. It is published as a separate pre-release so the existing
+`0.4.0-rc.3`/`beta` installation path remains unchanged while the new Harness
+client is evaluated.
+
+## Compatibility changes
+
+- Align DSH peer packages with `0.1.5-rc.2` and Cordis `4.0.2`.
+- Remove the obsolete `@deepseek-ai/dsh-client-runtime` injection. DSH
+  `0.1.5-rc.2` does not ship that package and the plugin does not use its API.
+- Require Node.js `>=24.0.0`. DSH 0.1.5 uses modern ESM entry-point behavior;
+  the plugin fails early with a visible prerequisite error on older Node lines.
+- Pin the onboarding manifest to DSH `0.1.5-rc.2` and keep the Foggy CLI,
+  Launcher, and Skills pins unchanged.
+
+The plugin's remote service, native Skill provider, locale registration, and
+Settings → Plugins tab continue to use the same public APIs. The DSH 0.1.5
+web client adds file/sidebar features, but none of those changes are required
+by Foggy's integration.
+
+## Installation
+
+Use Node.js 24 or newer and install the exact candidate in a separate profile:
+
+```powershell
+dsh plugin --profile web add --workspace-root @foggy-projects/deepseek-harness-plugin@0.4.1-rc.1
+dsh web
+```
+
+The npm `dsh015` dist-tag points to this candidate. Existing users of the
+stable `beta` tag are not moved automatically.
+
+## Verification gate
+
+The candidate must pass all of the following before it replaces the stable
+baseline:
+
+1. npm package shape and Node syntax checks;
+2. the repository onboarding/unit test suite;
+3. a clean DSH `0.1.5-rc.2` profile can add the package without an impossible
+   `dsh-client-runtime` peer resolution;
+4. `dsh --version` reports `0.1.5-rc.2` and `dsh web --no-open` starts under
+   Node 24;
+5. the web Settings → Plugins page loads Foggy's tab, native Skills are
+   discoverable, and the plugin status remote responds;
+6. Foggy initialization remains development-only and does not restart a
+   healthy Runtime during datasource/model onboarding.
+
+The candidate does not change Foggy Runtime/Launcher binaries or production
+deployment policy. If a DSH profile reports
+`ERR_PNPM_MINIMUM_RELEASE_AGE_VIOLATION`, rebuild only that profile's lockfile
+and retry the exact add command; do not disable pnpm's policy globally.
+
+## Upstream references
+
+- [DeepSeek Harness v0.1.5-rc.2 release](https://github.com/deepseek-ai/deepseek-harness/releases/tag/dsh-v0.1.5-rc.2)
+- [DeepSeek Harness release history](https://github.com/deepseek-ai/deepseek-harness/releases)
+- [Node entry-point compatibility discussion](https://github.com/deepseek-ai/deepseek-harness/discussions/6124)

package/experience/linux/README.md

@@ -5,7 +5,7 @@ It has been designed for Ubuntu 22.04/24.04 x86_64 and WSL2.
 
 ## Prerequisites
 
-- Node.js `^22.19.0` or `>=24.0.0`
+- Node.js `>=24.0.0` (the DSH 0.1.5-rc.2 compatibility candidate)
 - Java 17 or newer
 - Git, npm, and `tar`
 - At least 4 GiB free disk space and 2 GiB available memory; 4 GiB memory is recommended
@@ -22,7 +22,7 @@ bash experience/linux/prepare.sh --dry-run
 bash experience/linux/prepare.sh
 ```
 
-The script installs pinned pnpm and DeepSeek Harness versions inside
+The script installs pinned pnpm and DeepSeek Harness 0.1.5-rc.2 inside
 `~/.local/share/foggy-deepseek-harness-experience`, clones and packs the public Foggy Bundle, and
 adds it to a clean DSH web profile. It does not use `sudo`, install operating-system packages, write
 model credentials, initialize Foggy components, or start the web process.

package/experience/linux/prepare.sh

@@ -1,9 +1,9 @@
 #!/usr/bin/env bash
 set -euo pipefail
 
-DSH_VERSION="0.1.2-rc.1"
+DSH_VERSION="0.1.5-rc.2"
 PNPM_VERSION="11.7.0"
-PLUGIN_VERSION="0.4.0-rc.1"
+PLUGIN_VERSION="0.4.1-rc.1"
 PLUGIN_REF="v${PLUGIN_VERSION}"
 PLUGIN_REPOSITORY="https://github.com/foggy-projects/foggy-deepseek-harness-plugin.git"
 
@@ -73,8 +73,8 @@ require_command git
 require_command df
 require_command tar
 
-node -e 'const [major, minor] = process.versions.node.split(".").map(Number); if (!((major === 22 && minor >= 19) || major >= 24)) process.exit(1)' \
-  || fail "Node ^22.19.0 or >=24 required; detected $(node --version 2>/dev/null || echo unknown)"
+node -e 'const [major] = process.versions.node.split(".").map(Number); if (major < 24) process.exit(1)' \
+  || fail "Node >=24 required for DeepSeek Harness 0.1.5-rc.2; detected $(node --version 2>/dev/null || echo unknown)"
 
 java_major="$(java -version 2>&1 | awk -F'[\".]' '/version/ { print $2; exit }')"
 [[ "$java_major" =~ ^[0-9]+$ ]] || fail "could not detect Java version"

package/lib/client.js

@@ -35,7 +35,7 @@ window.__ModuleLoader__.load({
       package: '@foggy-projects/deepseek-harness-plugin',
       descriptors: [
         ...[
-        'status', 'plan', 'initialize', 'repair', 'repairPython', 'repairCli', 'repairLauncher', 'repairAnalysisSkill', 'repairSemanticQuerySkill',
+        'status', 'plan', 'initialize', 'initializeAndStart', 'repair', 'updateComponents', 'repairPython', 'repairCli', 'repairLauncher', 'repairAnalysisSkill', 'repairSemanticQuerySkill',
         'migrateProfiles', 'diagnostics', 'runtimeStart', 'runtimeStop',
         ].map((method) => descriptor(method)),
         descriptor('saveRuntimeSettings', [{
@@ -54,7 +54,7 @@ window.__ModuleLoader__.load({
     const zh = {
       tab: 'Foggy 数据分析',
       title: 'Foggy Java 数据分析引擎',
-      intro: '在 DeepSeek Harness 内管理 Foggy 私有 Python、CLI、Launcher、Skills 和本地 Runtime。大型组件在首次初始化时按需下载。',
+      intro: '在 DeepSeek Harness 内管理 Foggy 私有 Python、CLI、Launcher、Skills 和本地 Runtime。大型组件按需下载，插件升级后可在此处一键更新。',
       refresh: '刷新状态',
       loading: '正在读取 Foggy 状态…',
       failed: '暂时无法读取 Foggy 状态。',
@@ -73,11 +73,20 @@ window.__ModuleLoader__.load({
       java: 'Java',
       installed: '已安装',
       missing: '未安装',
+      upToDate: '最新',
+      updateAvailable: '有更新',
+      installedVersion: '当前版本',
+      targetVersion: '目标版本',
       available: '可用',
       unavailable: '不可用',
       initialize: '初始化 Foggy',
-      repair: '重新下载 / 修复',
-      repairTitle: '分组件检查与修复',
+      initializeAndStart: '初始化并启动',
+      initializeAndStartDone: 'Foggy 已初始化，Runtime 已启动。',
+      updateComponents: '更新组件',
+      updateAndStart: '更新并启动',
+      updateAndStartDone: '组件已更新，Runtime 已启动。',
+      repair: '修复组件',
+      repairTitle: '高级修复',
       repairPython: '检查 / 修复私有 Python',
       repairCli: '检查 / 修复 CLI',
       repairLauncher: '检查 / 修复 Launcher',
@@ -87,6 +96,16 @@ window.__ModuleLoader__.load({
       diagnosticsSaved: '诊断报告已保存',
       start: '启动 Runtime',
       stop: '停止 Runtime',
+      updateBlockedRunning: 'Runtime 运行中，停止后才能更新组件。',
+      updateReady: '检测到组件更新；可点击“更新并启动”一次完成更新。',
+      updateNone: '所有托管组件均为当前版本。',
+      operationTimeout: '操作等待超时，请刷新状态或导出诊断报告。',
+      resourceTitle: '文档与项目',
+      docs: '使用文档',
+      project: '插件项目',
+      releases: '版本记录',
+      runtimeProject: 'Runtime 项目',
+      openExternal: '在新标签页打开',
       working: '操作进行中…',
       progressWorking: '正在初始化 Foggy…',
       progressPreflight: '检查运行环境',
@@ -160,7 +179,7 @@ window.__ModuleLoader__.load({
     const en = {
       tab: 'Foggy Data Analysis',
       title: 'Foggy Java Data Analysis Engine',
-      intro: 'Manage Foggy private Python, CLI, Launcher, Skills, and the local Runtime inside DeepSeek Harness. Large components are downloaded on first initialization.',
+      intro: 'Manage Foggy private Python, CLI, Launcher, Skills, and the local Runtime inside DeepSeek Harness. Large components download on demand, and plugin upgrades can be applied here in one step.',
       refresh: 'Refresh status',
       loading: 'Reading Foggy status…',
       failed: 'Foggy status is temporarily unavailable.',
@@ -179,11 +198,20 @@ window.__ModuleLoader__.load({
       java: 'Java',
       installed: 'Installed',
       missing: 'Missing',
+      upToDate: 'Up to date',
+      updateAvailable: 'Update available',
+      installedVersion: 'Current',
+      targetVersion: 'Target',
       available: 'Available',
       unavailable: 'Unavailable',
       initialize: 'Initialize Foggy',
-      repair: 'Re-download / Repair',
-      repairTitle: 'Component checks and repair',
+      initializeAndStart: 'Initialize and start',
+      initializeAndStartDone: 'Foggy was initialized and Runtime started.',
+      updateComponents: 'Update components',
+      updateAndStart: 'Update and start',
+      updateAndStartDone: 'Components were updated and Runtime started.',
+      repair: 'Repair components',
+      repairTitle: 'Advanced repair',
       repairPython: 'Check / repair private Python',
       repairCli: 'Check / repair CLI',
       repairLauncher: 'Check / repair Launcher',
@@ -193,6 +221,16 @@ window.__ModuleLoader__.load({
       diagnosticsSaved: 'Diagnostics saved',
       start: 'Start Runtime',
       stop: 'Stop Runtime',
+      updateBlockedRunning: 'Runtime is running. Stop it before updating components.',
+      updateReady: 'Component updates are available. Use “Update and start” to finish in one step.',
+      updateNone: 'All managed components are up to date.',
+      operationTimeout: 'The operation timed out. Refresh the status or export diagnostics.',
+      resourceTitle: 'Documentation and project',
+      docs: 'User documentation',
+      project: 'Plugin project',
+      releases: 'Releases',
+      runtimeProject: 'Runtime project',
+      openExternal: 'Opens in a new tab',
       working: 'Operation in progress…',
       progressWorking: 'Initializing Foggy…',
       progressPreflight: 'Checking prerequisites',
@@ -267,15 +305,17 @@ window.__ModuleLoader__.load({
       .foggy-settings{width:100%;max-width:820px;color:var(--dsw-alias-label-primary);display:flex;flex-direction:column;gap:16px}
       .foggy-hero{border:1px solid var(--dsw-alias-border-l2);background:linear-gradient(135deg,color-mix(in srgb,var(--dsw-alias-state-business-primary) 10%,var(--dsw-alias-bg-layer-3)),var(--dsw-alias-bg-layer-3));border-radius:12px;padding:18px}
       .foggy-title-row{display:flex;align-items:center;gap:10px}.foggy-title-row h3{margin:0;font-size:18px;line-height:26px}.foggy-beta{font-size:11px;padding:2px 7px;border-radius:999px;background:color-mix(in srgb,var(--dsw-alias-state-business-primary) 14%,transparent);color:var(--dsw-alias-state-business-primary)}
-      .foggy-intro{margin:8px 0 0;color:var(--dsw-alias-label-secondary);font-size:13px;line-height:20px}.foggy-toolbar{display:flex;align-items:center;justify-content:space-between;gap:12px;flex-wrap:wrap}
+      .foggy-intro{margin:8px 0 0;color:var(--dsw-alias-label-secondary);font-size:13px;line-height:20px}.foggy-toolbar{display:flex;align-items:center;justify-content:space-between;gap:12px;flex-wrap:wrap}.foggy-toolbar-main,.foggy-toolbar-secondary{display:flex;gap:8px;flex-wrap:wrap;align-items:center}.foggy-toolbar-secondary{width:100%;padding-top:2px;border-top:1px solid var(--dsw-alias-border-l2)}
       .foggy-state{display:flex;align-items:center;gap:8px;font-size:14px;font-weight:600}.foggy-dot{width:9px;height:9px;border-radius:50%;background:var(--dsw-alias-label-tertiary)}.foggy-dot[data-state=ready],.foggy-dot[data-state=running]{background:var(--dsw-alias-state-success-primary)}.foggy-dot[data-state=degraded]{background:var(--dsw-alias-state-error-primary)}
-      .foggy-actions{display:flex;gap:8px;flex-wrap:wrap}.foggy-button{border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-1);color:var(--dsw-alias-label-primary);font:inherit;border-radius:8px;padding:7px 12px;cursor:pointer}.foggy-button:hover{background:var(--dsw-alias-interactive-bg-hover)}.foggy-button:disabled{opacity:.55;cursor:not-allowed}.foggy-button-primary{border-color:var(--dsw-alias-state-business-primary);background:var(--dsw-alias-state-business-primary);color:white}
+      .foggy-actions{display:flex;gap:8px;flex-wrap:wrap}.foggy-button{border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-1);color:var(--dsw-alias-label-primary);font:inherit;border-radius:8px;padding:7px 12px;cursor:pointer;transition:background-color .15s ease,box-shadow .15s ease,transform .15s ease}.foggy-button:hover{background:var(--dsw-alias-interactive-bg-hover)}.foggy-button:active{transform:translateY(1px)}.foggy-button:focus-visible{outline:2px solid var(--dsw-alias-state-business-primary);outline-offset:2px}.foggy-button:disabled{opacity:.55;cursor:not-allowed}.foggy-button-primary{border-color:var(--dsw-alias-state-business-primary);background:var(--dsw-alias-state-business-primary);color:white}
       .foggy-grid{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:10px}.foggy-card{border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-3);border-radius:10px;padding:13px 14px}.foggy-card-head{display:flex;justify-content:space-between;gap:8px}.foggy-card strong{font-size:13px}.foggy-badge{font-size:11px;color:var(--dsw-alias-label-secondary)}.foggy-card code{display:block;margin-top:8px;color:var(--dsw-alias-label-tertiary);font-size:11px;overflow-wrap:anywhere}
       .foggy-progress{border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-3);border-radius:10px;padding:13px 14px}.foggy-progress-head{display:flex;align-items:center;justify-content:space-between;gap:12px;font-size:13px}.foggy-progress-head strong{font-weight:600}.foggy-progress-percent{color:var(--dsw-alias-label-secondary);font-variant-numeric:tabular-nums}.foggy-progress-track{height:8px;margin-top:10px;border-radius:999px;background:var(--dsw-alias-bg-layer-1);overflow:hidden}.foggy-progress-fill{height:100%;border-radius:inherit;background:var(--dsw-alias-state-business-primary);transition:width .25s ease}.foggy-progress-meta{display:flex;justify-content:space-between;gap:12px;margin-top:8px;color:var(--dsw-alias-label-tertiary);font-size:11px;line-height:16px}.foggy-progress-file{min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
       .foggy-runtime-settings{border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-3);border-radius:10px;padding:14px}.foggy-runtime-settings h4{margin:0;font-size:13px}.foggy-runtime-settings-row{display:grid;grid-template-columns:minmax(150px,220px) minmax(0,1fr) auto;align-items:end;gap:10px;margin-top:10px}.foggy-field{display:flex;flex-direction:column;gap:6px}.foggy-field label{font-size:12px;font-weight:600}.foggy-input{width:100%;box-sizing:border-box;border:1px solid var(--dsw-alias-border-l2);border-radius:8px;background:var(--dsw-alias-bg-layer-1);color:var(--dsw-alias-label-primary);font:inherit;font-variant-numeric:tabular-nums;padding:8px 10px;outline:none}.foggy-input:focus{border-color:var(--dsw-alias-state-business-primary);box-shadow:0 0 0 3px color-mix(in srgb,var(--dsw-alias-state-business-primary) 18%,transparent)}.foggy-input[aria-invalid=true]{border-color:var(--dsw-alias-state-error-primary);box-shadow:0 0 0 3px color-mix(in srgb,var(--dsw-alias-state-error-primary) 14%,transparent)}.foggy-setting-meta{display:flex;flex-direction:column;gap:4px;min-width:0;color:var(--dsw-alias-label-tertiary);font-size:11px}.foggy-setting-meta code{overflow-wrap:anywhere;color:var(--dsw-alias-label-secondary)}
+      .foggy-update-banner{border:1px solid color-mix(in srgb,var(--dsw-alias-state-warning-primary) 55%,var(--dsw-alias-border-l2));background:color-mix(in srgb,var(--dsw-alias-state-warning-primary) 9%,transparent);border-radius:10px;padding:11px 13px;color:var(--dsw-alias-label-primary);font-size:12px;line-height:18px}.foggy-update-banner strong{color:var(--dsw-alias-state-warning-primary)}.foggy-update-list{margin:6px 0 0;padding-left:18px;color:var(--dsw-alias-label-secondary)}
+      .foggy-resources{border-top:1px solid var(--dsw-alias-border-l2);padding-top:14px}.foggy-resources h4{margin:0 0 9px;font-size:13px}.foggy-resource-links{display:flex;gap:8px;flex-wrap:wrap}.foggy-resource-link{display:inline-flex;align-items:center;gap:5px;border:1px solid var(--dsw-alias-border-l2);border-radius:8px;padding:7px 10px;color:var(--dsw-alias-label-secondary);font-size:12px;text-decoration:none}.foggy-resource-link:hover{color:var(--dsw-alias-label-primary);background:var(--dsw-alias-interactive-bg-hover)}.foggy-resource-link:focus-visible{outline:2px solid var(--dsw-alias-state-business-primary);outline-offset:2px}
       .foggy-error-panel{border:2px solid var(--dsw-alias-state-error-primary);background:color-mix(in srgb,var(--dsw-alias-state-error-primary) 10%,var(--dsw-alias-bg-layer-3));border-radius:10px;padding:13px 14px;box-shadow:0 6px 18px color-mix(in srgb,var(--dsw-alias-state-error-primary) 13%,transparent)}.foggy-error-panel-head{display:flex;align-items:center;gap:8px;color:var(--dsw-alias-state-error-primary);font-size:14px;font-weight:700}.foggy-error-icon{display:grid;place-items:center;width:22px;height:22px;border-radius:50%;background:var(--dsw-alias-state-error-primary);color:white;font-size:14px}.foggy-error-panel p{margin:7px 0 0;color:var(--dsw-alias-label-primary);font-size:13px;line-height:20px;overflow-wrap:anywhere}.foggy-error-help{color:var(--dsw-alias-state-error-primary)!important;font-weight:600}
       .foggy-message{margin:0;font-size:13px;line-height:20px;color:var(--dsw-alias-label-secondary)}.foggy-message[data-error=true]{color:var(--dsw-alias-state-error-primary)}.foggy-paths,.foggy-next,.foggy-section{border-top:1px solid var(--dsw-alias-border-l2);padding-top:14px}.foggy-paths h4,.foggy-next h4,.foggy-section h4{margin:0 0 8px;font-size:13px}.foggy-paths dl{display:grid;grid-template-columns:100px minmax(0,1fr);gap:6px 10px;margin:0}.foggy-paths dt{color:var(--dsw-alias-label-tertiary);font-size:12px}.foggy-paths dd{margin:0;min-width:0;overflow-wrap:anywhere;font-family:var(--ds-font-family-code);font-size:11px}.foggy-next p,.foggy-section p{margin:0;color:var(--dsw-alias-label-secondary);font-size:13px;line-height:20px}.foggy-section-actions{display:flex;gap:8px;flex-wrap:wrap;margin-top:10px}.foggy-onboarding-head{display:flex;justify-content:space-between;gap:12px;align-items:start}.foggy-onboarding-head code{font-size:11px;color:var(--dsw-alias-label-tertiary);overflow-wrap:anywhere}.foggy-step-list{display:grid;grid-template-columns:repeat(4,minmax(0,1fr));gap:7px;margin-top:10px}.foggy-step{border:1px solid var(--dsw-alias-border-l2);border-radius:8px;padding:8px;font-size:11px;color:var(--dsw-alias-label-tertiary)}.foggy-step[data-state=completed]{border-color:color-mix(in srgb,var(--dsw-alias-state-success-primary) 45%,var(--dsw-alias-border-l2));color:var(--dsw-alias-state-success-primary)}.foggy-step[data-state=failed],.foggy-step[data-state=invalid]{border-color:var(--dsw-alias-state-error-primary);color:var(--dsw-alias-state-error-primary)}.foggy-warning{border:1px solid color-mix(in srgb,var(--dsw-alias-state-warning-primary) 55%,var(--dsw-alias-border-l2));background:color-mix(in srgb,var(--dsw-alias-state-warning-primary) 8%,transparent);border-radius:10px;padding:12px}.foggy-query-warning{margin-top:10px}.foggy-query-warning p+p{margin-top:5px}.foggy-query-warning code{overflow-wrap:anywhere}
-      @media (width<=680px){.foggy-grid{grid-template-columns:minmax(0,1fr)}.foggy-runtime-settings-row{grid-template-columns:minmax(0,1fr)}.foggy-runtime-settings-row .foggy-button{width:100%}}
+      @media (width<=680px){.foggy-grid{grid-template-columns:minmax(0,1fr)}.foggy-runtime-settings-row{grid-template-columns:minmax(0,1fr)}.foggy-runtime-settings-row .foggy-button{width:100%}.foggy-toolbar-main{width:100%}.foggy-toolbar-main .foggy-button{flex:1}.foggy-resource-link{min-height:36px}}
     `
 
     if (typeof document !== 'undefined' && !document.querySelector('style[data-foggy-settings]')) {
@@ -295,16 +335,23 @@ window.__ModuleLoader__.load({
 
     function componentCard(label, component, kind, t) {
       const available = kind === 'runtime' ? component?.installed : component?.available
-      const stateText = kind === 'runtime'
-        ? t(available ? 'installed' : 'missing')
-        : t(available ? 'available' : 'unavailable')
+      const stateText = component?.updateAvailable
+        ? t('updateAvailable')
+        : kind === 'runtime'
+          ? t(available ? 'installed' : 'missing')
+          : t(available ? 'available' : 'unavailable')
       const source = component?.source === 'managed'
         ? t('managedPrivate')
         : component?.source === 'override'
           ? t('configuredOverride')
           : null
       const detail = [
-        component?.version || component?.output || '—',
+        component?.installedVersion
+          ? `${t('installedVersion')} ${component.installedVersion}`
+          : component?.version || component?.output || '—',
+        component?.targetVersion && component?.targetVersion !== component?.installedVersion
+          ? `${t('targetVersion')} ${component.targetVersion}`
+          : null,
         component?.minimum ? `≥${component.minimum}` : null,
         source,
       ].filter(Boolean).join(' · ')
@@ -321,6 +368,19 @@ window.__ModuleLoader__.load({
       })
     }
 
+    const componentLabels = {
+      cli: 'cli',
+      launcher: 'launcher',
+      analysisSkill: 'analysisSkill',
+      semanticQuerySkill: 'semanticQuerySkill',
+    }
+
+    function updateSummary(status, t) {
+      return Object.entries(status?.components || {})
+        .filter(([key, component]) => componentLabels[key] && component?.updateAvailable)
+        .map(([key, component]) => `${t(componentLabels[key])}: ${component.installedVersion || '—'} → ${component.targetVersion}`)
+    }
+
     function progressPanel(progress, t) {
       if (!progress) return null
       const percent = Math.max(0, Math.min(100, Number(progress.percent) || 0))
@@ -443,6 +503,7 @@ window.__ModuleLoader__.load({
       const [view, setView] = useState({ phase: 'loading', status: null, message: '', error: false, errorCode: null })
       const [portDraft, setPortDraft] = useState('')
       const [portDirty, setPortDirty] = useState(false)
+      const [sequenceBusy, setSequenceBusy] = useState(false)
 
       const refresh = useCallback(async () => {
         setView((current) => ({ ...current, phase: current.status ? 'ready' : 'loading', error: false }))
@@ -469,6 +530,7 @@ window.__ModuleLoader__.load({
       }, [refresh, view.status?.operation?.state])
 
       const run = async (method) => {
+        setSequenceBusy(true)
         setView((current) => ({ ...current, message: t('working'), error: false, errorCode: null }))
         try {
           const result = unwrap(await api[method](), method)
@@ -481,6 +543,44 @@ window.__ModuleLoader__.load({
           await refresh()
         } catch (error) {
           setView((current) => ({ ...current, message: `${t('actionFailed')}: ${String(error.message || error)}`, error: true, errorCode: 'REMOTE_ERROR' }))
+        } finally {
+          setSequenceBusy(false)
+        }
+      }
+
+      const waitForOperation = async (operationId) => {
+        for (let attempt = 0; attempt < 900; attempt += 1) {
+          const status = unwrap(await api.status(), 'status')
+          const operation = status.operation
+          if (operation?.id === operationId && operation.state !== 'running') return status
+          await new Promise((resolve) => setTimeout(resolve, 1000))
+        }
+        throw new Error(t('operationTimeout'))
+      }
+
+      const runSequence = async (methods, successMessage) => {
+        setSequenceBusy(true)
+        setView((current) => ({ ...current, message: t('working'), error: false, errorCode: null }))
+        try {
+          for (const method of methods) {
+            const result = unwrap(await api[method](), method)
+            if (result.success === false) {
+              setView((current) => ({ ...current, message: result.error?.message || t('actionFailed'), error: true, errorCode: result.error?.code || null }))
+              return
+            }
+            if (result.accepted && result.operation?.id) {
+              const completed = await waitForOperation(result.operation.id)
+              if (completed.operation?.state === 'failed') {
+                throw new Error(completed.operation.error || completed.operation.result?.error?.message || t('actionFailed'))
+              }
+            }
+          }
+          setView((current) => ({ ...current, message: successMessage, error: false, errorCode: null }))
+        } catch (error) {
+          setView((current) => ({ ...current, message: `${t('actionFailed')}: ${String(error.message || error)}`, error: true, errorCode: 'REMOTE_ERROR' }))
+        } finally {
+          setSequenceBusy(false)
+          await refresh()
         }
       }
 
@@ -513,7 +613,7 @@ window.__ModuleLoader__.load({
       ] })
 
       const status = view.status
-      const busy = status.operation?.state === 'running'
+      const busy = sequenceBusy || status.operation?.state === 'running'
       const portNumber = Number(portDraft)
       const portValid = Number.isInteger(portNumber) && portNumber >= 1024 && portNumber <= 65535
       const operationError = status.operation?.state === 'failed'
@@ -545,29 +645,57 @@ window.__ModuleLoader__.load({
         ? t('portUnavailableHelp')
         : alertCode === 'RUNTIME_PORT_INVALID'
           ? t('portInvalidHelp')
+          : alertCode === 'RUNTIME_RUNNING_UPDATE_REQUIRES_STOP'
+            ? t('updateBlockedRunning')
           : ''
       const progress = busy ? progressPanel(status.operation?.progress, t) : null
+      const pendingUpdates = updateSummary(status, t)
+      const hasPendingUpdates = pendingUpdates.length > 0
       const stateLabels = { 'not-installed': 'notInstalled', degraded: 'degraded', ready: 'ready', running: 'running' }
       return jsxs('section', { className: 'foggy-settings', children: [
         jsxs('div', { className: 'foggy-hero', children: [
           jsxs('div', { className: 'foggy-title-row', children: [jsx('h3', { children: t('title') }), jsx('span', { className: 'foggy-beta', children: t('beta') })] }),
           jsx('p', { className: 'foggy-intro', children: t('intro') }),
         ] }),
+        jsxs('div', { className: 'foggy-resources', children: [
+          jsx('h4', { children: t('resourceTitle') }),
+          jsxs('div', { className: 'foggy-resource-links', children: [
+            jsx('a', { className: 'foggy-resource-link', href: 'https://github.com/foggy-projects/foggy-deepseek-harness-plugin#readme', target: '_blank', rel: 'noreferrer noopener', title: t('openExternal'), children: t('docs') }),
+            jsx('a', { className: 'foggy-resource-link', href: 'https://github.com/foggy-projects/foggy-deepseek-harness-plugin', target: '_blank', rel: 'noreferrer noopener', title: t('openExternal'), children: t('project') }),
+            jsx('a', { className: 'foggy-resource-link', href: 'https://github.com/foggy-projects/foggy-deepseek-harness-plugin/releases', target: '_blank', rel: 'noreferrer noopener', title: t('openExternal'), children: t('releases') }),
+            jsx('a', { className: 'foggy-resource-link', href: 'https://github.com/f-projects/foggy-data-mcp-bridge', target: '_blank', rel: 'noreferrer noopener', title: t('openExternal'), children: t('runtimeProject') }),
+          ] }),
+        ] }),
         jsxs('div', { className: 'foggy-toolbar', children: [
-          jsxs('div', { className: 'foggy-state', children: [jsx('span', { className: 'foggy-dot', 'data-state': status.state }), jsx('span', { children: t(stateLabels[status.state] || 'notInstalled') })] }),
-          jsxs('div', { className: 'foggy-actions', children: [
+          jsxs('div', { className: 'foggy-state', children: [jsx('span', { className: 'foggy-dot', 'data-state': status.state }), jsx('span', { children: `${t(stateLabels[status.state] || 'notInstalled')}${hasPendingUpdates ? ` · ${t('updateAvailable')}` : ''}` })] }),
+          jsxs('div', { className: 'foggy-toolbar-main', children: [
+            status.state === 'not-installed'
+              ? jsx('button', { className: 'foggy-button foggy-button-primary', type: 'button', disabled: busy, onClick: () => runSequence(['initializeAndStart'], t('initializeAndStartDone')), children: t('initializeAndStart') })
+              : status.running
+                ? jsx('button', { className: 'foggy-button', type: 'button', disabled: busy, onClick: () => run('runtimeStop'), children: t('stop') })
+                : hasPendingUpdates && status.components.java.available
+                  ? jsx('button', { className: 'foggy-button foggy-button-primary', type: 'button', disabled: busy, onClick: () => runSequence(['updateComponents', 'runtimeStart'], t('updateAndStartDone')), children: t('updateAndStart') })
+                  : status.installed && status.components.java.available
+                    ? jsx('button', { className: 'foggy-button foggy-button-primary', type: 'button', disabled: busy, onClick: () => run('runtimeStart'), children: t('start') })
+                    : jsx('button', { className: 'foggy-button foggy-button-primary', type: 'button', disabled: busy, onClick: () => run('updateComponents'), children: t('updateComponents') }),
+          ] }),
+          jsxs('div', { className: 'foggy-toolbar-secondary', children: [
             jsx('button', { className: 'foggy-button', type: 'button', disabled: busy, onClick: refresh, children: t('refresh') }),
             jsx('button', { className: 'foggy-button', type: 'button', disabled: busy, onClick: () => run('diagnostics'), children: t('diagnostics') }),
-            status.state === 'not-installed' ? jsx('button', { className: 'foggy-button foggy-button-primary', type: 'button', disabled: busy, onClick: () => run('initialize'), children: t('initialize') }) : null,
-            status.state !== 'not-installed' ? jsx('button', { className: 'foggy-button', type: 'button', disabled: busy, onClick: () => run('repair'), children: t('repair') }) : null,
-            status.installed && !status.running && status.components.java.available ? jsx('button', { className: 'foggy-button foggy-button-primary', type: 'button', disabled: busy, onClick: () => run('runtimeStart'), children: t('start') }) : null,
-            status.running ? jsx('button', { className: 'foggy-button', type: 'button', disabled: busy, onClick: () => run('runtimeStop'), children: t('stop') }) : null,
+            status.state !== 'not-installed' && !status.running && hasPendingUpdates
+              ? jsx('button', { className: 'foggy-button', type: 'button', disabled: busy, onClick: () => run('updateComponents'), children: t('updateComponents') })
+              : null,
           ] }),
         ] }),
         errorPanel(alertTitle, alertMessage, alertHelp),
         progress,
         busy ? jsx('p', { className: 'foggy-message', children: t('working') }) : null,
         !busy && view.message && !view.error && !operationError ? jsx('p', { className: 'foggy-message', children: view.message }) : null,
+        !busy && hasPendingUpdates ? jsxs('div', { className: 'foggy-update-banner', role: 'status', children: [
+          jsx('strong', { children: t('updateAvailable') }),
+          jsx('span', { children: ` · ${status.running ? t('updateBlockedRunning') : t('updateReady')}` }),
+          jsx('ul', { className: 'foggy-update-list', children: pendingUpdates.map((item) => jsx('li', { children: item }, item)) }),
+        ] }) : null,
         jsxs('div', { className: 'foggy-runtime-settings', children: [
           jsx('h4', { children: t('runtimeSettingsTitle') }),
           jsxs('div', { className: 'foggy-runtime-settings-row', children: [
@@ -617,11 +745,11 @@ window.__ModuleLoader__.load({
         jsxs('div', { className: 'foggy-section', children: [
           jsx('h4', { children: t('repairTitle') }),
           jsx('div', { className: 'foggy-section-actions', children: [
-            jsx('button', { className: 'foggy-button', type: 'button', disabled: busy, onClick: () => run('repairPython'), children: t('repairPython') }),
-            jsx('button', { className: 'foggy-button', type: 'button', disabled: busy, onClick: () => run('repairCli'), children: t('repairCli') }),
-            jsx('button', { className: 'foggy-button', type: 'button', disabled: busy, onClick: () => run('repairLauncher'), children: t('repairLauncher') }),
-            jsx('button', { className: 'foggy-button', type: 'button', disabled: busy, onClick: () => run('repairAnalysisSkill'), children: t('repairAnalysisSkill') }),
-            jsx('button', { className: 'foggy-button', type: 'button', disabled: busy, onClick: () => run('repairSemanticQuerySkill'), children: t('repairSemanticQuerySkill') }),
+            jsx('button', { className: 'foggy-button', type: 'button', disabled: busy || status.running, title: status.running ? t('updateBlockedRunning') : undefined, onClick: () => run('repairPython'), children: t('repairPython') }),
+            jsx('button', { className: 'foggy-button', type: 'button', disabled: busy || status.running, title: status.running ? t('updateBlockedRunning') : undefined, onClick: () => run('repairCli'), children: t('repairCli') }),
+            jsx('button', { className: 'foggy-button', type: 'button', disabled: busy || status.running, title: status.running ? t('updateBlockedRunning') : undefined, onClick: () => run('repairLauncher'), children: t('repairLauncher') }),
+            jsx('button', { className: 'foggy-button', type: 'button', disabled: busy || status.running, title: status.running ? t('updateBlockedRunning') : undefined, onClick: () => run('repairAnalysisSkill'), children: t('repairAnalysisSkill') }),
+            jsx('button', { className: 'foggy-button', type: 'button', disabled: busy || status.running, title: status.running ? t('updateBlockedRunning') : undefined, onClick: () => run('repairSemanticQuerySkill'), children: t('repairSemanticQuerySkill') }),
           ] }),
         ] }),
         status.profileMigration?.pendingCount || status.profileMigration?.conflictCount ? jsxs('div', { className: 'foggy-warning', children: [

package/lib/index.js

@@ -45,6 +45,18 @@ function defaultRoots() {
   }
 }
 
+function componentReleaseState({ installed, installedVersion, targetVersion }) {
+  const normalizedInstalled = installedVersion || null
+  const normalizedTarget = targetVersion || null
+  const updateAvailable = Boolean(installed && normalizedInstalled && normalizedTarget && normalizedInstalled !== normalizedTarget)
+  return {
+    installed: Boolean(installed && !updateAvailable),
+    installedVersion: normalizedInstalled,
+    targetVersion: normalizedTarget,
+    updateAvailable,
+  }
+}
+
 async function exists(path) {
   try {
     await access(path, fsConstants.F_OK)
@@ -66,6 +78,22 @@ async function readOptionalJson(path) {
   }
 }
 
+async function runtimeRunningUpdateGuard() {
+  const roots = defaultRoots()
+  const runtime = await readOptionalJson(join(roots.dataRoot, 'runtime-state.json'))
+  if (runtime && processRunning(Number(runtime.pid))) {
+    return {
+      success: false,
+      accepted: false,
+      error: {
+        code: 'RUNTIME_RUNNING_UPDATE_REQUIRES_STOP',
+        message: 'Stop Foggy Runtime before updating or repairing managed components.',
+      },
+    }
+  }
+  return null
+}
+
 async function commandVersion(command, args) {
   try {
     const { stdout, stderr } = await execFileAsync(command, args, {
@@ -127,7 +155,7 @@ async function runOnboarding(args, timeout = 15 * 60_000, options = {}) {
 
 async function assertSystemPrerequisites(kind) {
   if (kind === 'initialize' && !compatibleNode(process.versions.node)) {
-    throw new Error(`DeepSeek Harness requires Node.js ^22.19.0 or >=24.0.0; detected ${process.versions.node}`)
+    throw new Error(`DeepSeek Harness 0.1.5-rc.2 requires Node.js >=24.0.0; detected ${process.versions.node}`)
   }
   if (kind === 'initialize' || kind === 'runtime-start') {
     const java = compatible(await commandVersion(process.env.JAVA_EXE || 'java', ['-version']), '17.0')
@@ -232,32 +260,50 @@ export class FoggyIntegrationGateway extends TypertRemoteService {
     const onboardingSkillPath = join(packageRoot, 'skills', 'foggy-deepseek-onboarding')
     const analysisMarker = await readOptionalJson(join(analysisSkillPath, '.foggy-managed-skill.json'))
     const semanticQueryMarker = await readOptionalJson(join(semanticQuerySkillPath, '.foggy-managed-skill.json'))
+    const cliPresent = Boolean(cliPath && await exists(cliPath))
+    const launcherPresent = Boolean(launcherPath && await exists(launcherPath))
+    const analysisSkillPresent = await exists(join(analysisSkillPath, 'SKILL.md'))
+      && analysisMarker?.schemaVersion === 'foggy-managed-skill/v1'
+    const semanticQuerySkillPresent = await exists(join(semanticQuerySkillPath, 'SKILL.md'))
+      && semanticQueryMarker?.schemaVersion === 'foggy-managed-skill/v1'
+    const cliRelease = componentReleaseState({
+      installed: cliPresent,
+      installedVersion: state?.cli?.version,
+      targetVersion: manifest.components.cli.version,
+    })
+    const launcherRelease = componentReleaseState({
+      installed: launcherPresent,
+      installedVersion: state?.launcher?.version,
+      targetVersion: manifest.components.launcher.version,
+    })
+    const analysisRelease = componentReleaseState({
+      installed: analysisSkillPresent,
+      installedVersion: analysisMarker?.componentVersion || state?.skills?.analysis?.version,
+      targetVersion: manifest.components.analysisSkill.version,
+    })
+    const semanticQueryRelease = componentReleaseState({
+      installed: semanticQuerySkillPresent,
+      installedVersion: semanticQueryMarker?.componentVersion || state?.skills?.semanticQuery?.version,
+      targetVersion: manifest.components.semanticQuerySkill.version,
+    })
     const components = {
       python,
       java,
       cli: {
-        installed: Boolean(cliPath && await exists(cliPath)),
-        version: state?.cli?.version ?? manifest.components.cli.version,
+        ...cliRelease,
+        version: cliRelease.installedVersion ?? manifest.components.cli.version,
       },
       launcher: {
-        installed: Boolean(launcherPath && await exists(launcherPath)),
-        version: state?.launcher?.version ?? manifest.components.launcher.version,
+        ...launcherRelease,
+        version: launcherRelease.installedVersion ?? manifest.components.launcher.version,
       },
       analysisSkill: {
-        installed: Boolean(
-          await exists(join(analysisSkillPath, 'SKILL.md'))
-          && analysisMarker?.schemaVersion === 'foggy-managed-skill/v1'
-          && analysisMarker?.componentVersion === manifest.components.analysisSkill.version
-        ),
-        version: state?.skills?.analysis?.version ?? manifest.components.analysisSkill.version,
+        ...analysisRelease,
+        version: analysisRelease.installedVersion ?? manifest.components.analysisSkill.version,
       },
       semanticQuerySkill: {
-        installed: Boolean(
-          await exists(join(semanticQuerySkillPath, 'SKILL.md'))
-          && semanticQueryMarker?.schemaVersion === 'foggy-managed-skill/v1'
-          && semanticQueryMarker?.componentVersion === manifest.components.semanticQuerySkill.version
-        ),
-        version: state?.skills?.semanticQuery?.version ?? manifest.components.semanticQuerySkill.version,
+        ...semanticQueryRelease,
+        version: semanticQueryRelease.installedVersion ?? manifest.components.semanticQuerySkill.version,
       },
       onboardingSkill: {
         installed: await exists(join(onboardingSkillPath, 'SKILL.md')),
@@ -271,6 +317,7 @@ export class FoggyIntegrationGateway extends TypertRemoteService {
       && components.analysisSkill.installed
       && components.semanticQuerySkill.installed
       && components.onboardingSkill.installed
+    const updateAvailable = Object.values(components).some((component) => component?.updateAvailable)
     const running = Boolean(runtime && processRunning(Number(runtime.pid)))
     const activePort = running && Number.isInteger(Number(runtime?.port)) ? Number(runtime.port) : null
     const progress = await readOptionalJson(progressPath)
@@ -294,6 +341,7 @@ export class FoggyIntegrationGateway extends TypertRemoteService {
       packageVersion: manifest.packageVersion,
       state: running ? 'running' : installed ? 'ready' : state ? 'degraded' : 'not-installed',
       installed,
+      updateAvailable,
       running,
       runtimeUrl: running ? runtime.runtimeUrl ?? null : null,
       runtimeSettings: {
@@ -309,7 +357,13 @@ export class FoggyIntegrationGateway extends TypertRemoteService {
       operation,
       onboarding,
       profileMigration,
-      next: installed ? (running ? 'configure-database' : 'start-runtime') : 'initialize',
+      next: !state
+        ? 'initialize'
+        : updateAvailable
+          ? 'update-components'
+          : installed
+            ? (running ? 'configure-database' : 'start-runtime')
+            : 'repair',
     }
   }
 
@@ -337,27 +391,96 @@ export class FoggyIntegrationGateway extends TypertRemoteService {
     return this.startOperation('initialize', false)
   }
 
+  async initializeAndStart() {
+    const status = await this.status()
+    if (status.state !== 'not-installed') {
+      return {
+        success: false,
+        accepted: false,
+        error: { code: 'FOGGY_ALREADY_INITIALIZED', message: 'Foggy is already initialized; use Start Runtime or Update components.' },
+      }
+    }
+    return this.startOperation('initialize-and-start', false, undefined, async ({ operation, progressPath, pythonProgress }) => {
+      await assertSystemPrerequisites('initialize')
+      const cacheArgs = (process.env.FOGGY_ASSET_CACHE_DIRS || '').split(delimiter).filter(Boolean)
+        .flatMap((cacheDir) => ['--asset-cache-dir', cacheDir])
+      const install = await runOnboarding([
+        'install', '--progress-file', progressPath, '--operation-id', operation.id, '--operation-kind', 'initialize',
+        ...cacheArgs,
+      ], 15 * 60_000, {
+        ensurePython: true,
+        onPythonProgress: (detail) => pythonProgress?.update(detail),
+        flushPythonProgress: () => pythonProgress?.flush(),
+      })
+      if (install.success === false) return install
+
+      await assertSystemPrerequisites('runtime-start')
+      const roots = defaultRoots()
+      const manifest = await readJson(versionsFile)
+      const settings = await readRuntimeSettings(roots.dataRoot, {
+        defaultPort: manifest.defaults?.port ?? DEFAULT_RUNTIME_PORT,
+      })
+      if (!settings.valid) {
+        return {
+          success: false,
+          error: { code: 'RUNTIME_SETTINGS_INVALID', message: `Runtime settings are invalid: ${settings.error}` },
+        }
+      }
+      return runOnboarding([
+        'runtime-start', '--install-root', roots.installRoot, '--data-root', roots.dataRoot,
+        '--port', String(settings.port), '--progress-file', progressPath, '--operation-id', operation.id,
+        '--operation-kind', 'runtime-start',
+      ], 15 * 60_000, { ensurePython: false })
+    })
+  }
+
   async repair() {
+    const blocked = await runtimeRunningUpdateGuard()
+    if (blocked) return blocked
     return this.startOperation('repair', true)
   }
 
+  async updateComponents() {
+    const blocked = await runtimeRunningUpdateGuard()
+    if (blocked) return blocked
+    const status = await this.status()
+    if (status.state === 'not-installed') {
+      return {
+        success: false,
+        accepted: false,
+        error: { code: 'FOGGY_NOT_INITIALIZED', message: 'Initialize Foggy before updating managed components.' },
+      }
+    }
+    return this.startOperation('update-components', true)
+  }
+
   async repairCli() {
+    const blocked = await runtimeRunningUpdateGuard()
+    if (blocked) return blocked
     return this.startOperation('repair-cli', false, ['install', '--repair-component', 'cli'])
   }
 
   async repairPython() {
+    const blocked = await runtimeRunningUpdateGuard()
+    if (blocked) return blocked
     return this.startOperation('repair-python', false, ['install'])
   }
 
   async repairLauncher() {
+    const blocked = await runtimeRunningUpdateGuard()
+    if (blocked) return blocked
     return this.startOperation('repair-launcher', false, ['install', '--repair-component', 'launcher'])
   }
 
   async repairAnalysisSkill() {
+    const blocked = await runtimeRunningUpdateGuard()
+    if (blocked) return blocked
     return this.startOperation('repair-analysis-skill', true, ['install', '--repair-component', 'analysis-skill'])
   }
 
   async repairSemanticQuerySkill() {
+    const blocked = await runtimeRunningUpdateGuard()
+    if (blocked) return blocked
     return this.startOperation('repair-semantic-query-skill', true, ['install', '--repair-component', 'semantic-query-skill'])
   }
 
@@ -459,22 +582,22 @@ export class FoggyIntegrationGateway extends TypertRemoteService {
     }
   }
 
-  startOperation(kind, replaceSkill, explicitArgs) {
+  startOperation(kind, replaceSkill, explicitArgs, runner = null) {
     if (this.operation?.state === 'running') {
       return { success: false, accepted: false, operation: operationView(this.operation), error: 'another Foggy operation is running' }
     }
     const id = `${Date.now()}-${Math.random().toString(16).slice(2, 10)}`
     const args = explicitArgs ?? ['install']
-    const reportsProgress = args[0] === 'install' || args[0] === 'runtime-start'
+    const reportsProgress = args[0] === 'install' || args[0] === 'runtime-start' || runner !== null
+    const progressPath = reportsProgress ? join(defaultRoots().dataRoot, 'operation-progress.json') : null
     if (reportsProgress) {
-      const roots = defaultRoots()
-      args.push('--progress-file', join(roots.dataRoot, 'operation-progress.json'), '--operation-id', id, '--operation-kind', kind)
+      args.push('--progress-file', progressPath, '--operation-id', id, '--operation-kind', kind)
     }
     if (replaceSkill) args.push('--replace-skill')
     for (const cacheDir of (process.env.FOGGY_ASSET_CACHE_DIRS || '').split(delimiter).filter(Boolean)) {
       args.push('--asset-cache-dir', cacheDir)
     }
-    const runtimeStart = kind === 'runtime-start'
+    const runtimeStart = kind === 'runtime-start' || kind.endsWith('-and-start')
     const operation = {
       id,
       kind,
@@ -497,10 +620,11 @@ export class FoggyIntegrationGateway extends TypertRemoteService {
       promise: null,
     }
     const pythonProgress = reportsProgress
-      ? createPythonProgressReporter(operation, join(defaultRoots().dataRoot, 'operation-progress.json'))
+      ? createPythonProgressReporter(operation, progressPath)
       : null
     operation.promise = (async () => {
       await assertSystemPrerequisites(kind)
+      if (runner) return runner({ operation, progressPath, pythonProgress })
       return runOnboarding(args, 15 * 60_000, {
         ensurePython: true,
         forcePython: kind === 'repair-python',
@@ -545,7 +669,7 @@ export class FoggyIntegrationGateway extends TypertRemoteService {
 
 const markerInitializers = []
 for (const method of [
-  'status', 'plan', 'initialize', 'repair', 'repairPython', 'repairCli', 'repairLauncher', 'repairAnalysisSkill', 'repairSemanticQuerySkill',
+  'status', 'plan', 'initialize', 'initializeAndStart', 'repair', 'updateComponents', 'repairPython', 'repairCli', 'repairLauncher', 'repairAnalysisSkill', 'repairSemanticQuerySkill',
   'migrateProfiles', 'diagnostics', 'runtimeStart', 'runtimeStop',
   'saveRuntimeSettings',
 ]) {

package/lib/remote-descriptor.js

@@ -26,7 +26,9 @@ export const descriptors = [
   descriptor('status'),
   descriptor('plan'),
   descriptor('initialize'),
+  descriptor('initializeAndStart'),
   descriptor('repair'),
+  descriptor('updateComponents'),
   descriptor('repairPython'),
   descriptor('repairSemanticQuerySkill'),
   descriptor('runtimeStart'),

package/lib/version.js

@@ -15,6 +15,6 @@ export function compatible(probe, minimum) {
 }
 
 export function compatibleNode(version) {
-  const [major, minor] = String(version).split('.').map(Number)
-  return (major === 22 && minor >= 19) || major >= 24
+  const [major] = String(version).split('.').map(Number)
+  return major >= 24
 }

package/package.json

@@ -1,7 +1,24 @@
 {
   "name": "@foggy-projects/deepseek-harness-plugin",
-  "version": "0.4.0-rc.2",
+  "version": "0.4.1-rc.1",
   "description": "Foggy Java data analysis engine integration for DeepSeek Harness",
+  "keywords": [
+    "deepseek-harness",
+    "dsh",
+    "dsh-plugin",
+    "foggy",
+    "data-analysis",
+    "semantic-layer",
+    "runtime"
+  ],
+  "homepage": "https://github.com/foggy-projects/foggy-deepseek-harness-plugin#readme",
+  "bugs": {
+    "url": "https://github.com/foggy-projects/foggy-deepseek-harness-plugin/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/foggy-projects/foggy-deepseek-harness-plugin.git"
+  },
   "type": "module",
   "main": "./lib/index.js",
   "exports": {
@@ -21,13 +38,16 @@
     "experience/linux/**",
     "docs/PUBLIC-BETA-READINESS.md",
     "docs/RELEASE-CANDIDATE-0.4.0-RC.2.md",
+    "docs/RELEASE-CANDIDATE-0.4.0-RC.3.md",
+    "docs/RELEASE-CANDIDATE-0.4.1-DSH-0.1.5-RC.1.md",
+    "docs/COMMUNITY-MARKETPLACES.md",
     "docs/WINDOWS-BETA-ACCEPTANCE.md",
     "THIRD-PARTY-RUNTIME-NOTICES.md",
     "README.md"
   ],
   "license": "Apache-2.0",
   "engines": {
-    "node": "^22.19.0 || >=24.0.0"
+    "node": ">=24.0.0"
   },
   "dsh": {
     "bundle": {
@@ -37,7 +57,6 @@
       "platform": "web",
       "inject": [
         "@deepseek-ai/dsh-api-remotes",
-        "@deepseek-ai/dsh-client-runtime",
         "@deepseek-ai/dsh-client-locale",
         "@deepseek-ai/dsh-client-ui-settings",
         "@deepseek-ai/dsh-client-ui-settings-plugins"
@@ -48,14 +67,13 @@
     "zod": "^4.4.3"
   },
   "peerDependencies": {
-    "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-api-remotes": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-client-locale": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-client-runtime": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-client-ui-settings": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-client-ui-settings-plugins": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-skill": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-typert-protocol": "^0.1.2-rc.1"
+    "@deepseek-ai/cordis": "^4.0.2",
+    "@deepseek-ai/dsh-api-remotes": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-client-locale": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-client-ui-settings": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-client-ui-settings-plugins": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-skill": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-typert-protocol": "^0.1.5-rc.2"
   },
   "scripts": {
     "check": "node --check lib/index.js && node --check lib/atomic-json.js && node --check lib/diagnostics.js && node --check lib/python-runtime.js && node --check lib/runtime-settings.js && node --check lib/skill-provider.js && node --check lib/client.js && node --check lib/typert.js && node --check lib/remote.js",

package/skills/foggy-deepseek-onboarding/assets/versions.json

@@ -1,11 +1,11 @@
 {
   "schemaVersion": "foggy-deepseek-onboarding-versions/v1",
-  "packageVersion": "0.4.0-rc.2",
-  "validatedAt": "2026-09-06",
+  "packageVersion": "0.4.1-rc.1",
+  "validatedAt": "2026-09-13",
   "components": {
     "deepseekHarness": {
-      "version": "0.1.2-rc.1",
-      "minimumNodeVersion": "22.19.0"
+      "version": "0.1.5-rc.2",
+      "minimumNodeVersion": "24.0.0"
     },
     "python": {
       "version": "3.12.13",