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

package/README.md

@@ -7,7 +7,7 @@ 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.
 
-The `0.4.1-rc.1` compatibility candidate targets DeepSeek Harness `0.1.5-rc.2`
+The `0.4.2-rc.2` compatibility candidate targets DeepSeek Harness `0.1.7-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,
@@ -17,27 +17,32 @@ modify `PATH`, or register Python globally. Advanced users may explicitly set
 ## Local release-candidate installation
 
 ```powershell
-dsh plugin --profile web add --workspace-root ./foggy-projects-deepseek-harness-plugin-0.4.1-rc.1.tgz
+dsh plugin --profile web add --workspace-root ./foggy-projects-deepseek-harness-plugin-0.4.2-rc.2.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.
 
-For the DSH 0.1.5-rc.2 compatibility pre-release, install the exact candidate
+Install the exact DSH 0.1.7-rc.2 compatibility 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
+dsh plugin --profile web add --workspace-root @foggy-projects/deepseek-harness-plugin@0.4.2-rc.2
 ```
 
-The published candidate is also available through the dedicated `dsh015` npm
-dist-tag:
+The `dsh017` npm dist-tag points to the most recently published DSH 0.1.7
+candidate (`0.4.2-rc.2` at this release). Check the resolved version before
+using this moving tag:
 
 ```powershell
-dsh plugin --profile web add --workspace-root @foggy-projects/deepseek-harness-plugin@dsh015
+dsh plugin --profile web add --workspace-root @foggy-projects/deepseek-harness-plugin@dsh017
 ```
 
+The earlier DSH `0.1.5-rc.2` compatibility candidate remains available as
+`@foggy-projects/deepseek-harness-plugin@dsh015`; neither candidate moves the
+existing `beta` channel.
+
 For the existing stable beta channel, the corresponding one-line install is:
 
 ```powershell
@@ -51,12 +56,12 @@ 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
-profile directory printed in the error and rebuild its lockfile, then rerun the
-same `dsh plugin add` command:
+DeepSeek Harness profiles can apply pnpm's minimum-release-age policy to their
+lockfiles. An upgrade performed shortly after publication can therefore fail
+while naming either the new plugin or a previously installed version. This is
+a DSH profile-policy failure, not a damaged Foggy package. Use the exact profile
+directory printed in the error and rebuild its lockfile, then rerun the same
+`dsh plugin add` command:
 
 ```powershell
 Set-Location "<the DSH profile directory printed in the error>"
@@ -87,6 +92,11 @@ The Bundle registers `foggy-deepseek-onboarding` and the downloaded
 are available in every DSH workspace without copying or symlinking `.agents`.
 The current session `cwd` remains the workspace boundary for semantic drafts and
 evidence.
+An existing Harness session keeps its original workspace even if another workspace
+becomes the default. Create a new session in the selected workspace when testing
+model-file isolation; an isolated `DSH_HOME` alone does not change a session's
+`cwd`. The `--workspace-root` option in the plugin install command is a pnpm
+installation option, not a Harness workspace selector.
 
 Opaque CLI profiles remain available for users who prefer them and default to
 the private persistent `<dataRoot>/cli-profiles` directory, but they are not a
@@ -128,7 +138,9 @@ 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
+The DSH 0.1.7-rc.2 compatibility candidate is documented in
+[`docs/RELEASE-CANDIDATE-0.4.2-DSH-0.1.7-RC.2.md`](./docs/RELEASE-CANDIDATE-0.4.2-DSH-0.1.7-RC.2.md).
+The earlier DSH 0.1.5-rc.2 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

package/docs/RELEASE-CANDIDATE-0.4.2-DSH-0.1.7-RC.1.md

@@ -0,0 +1,62 @@
+# Foggy DeepSeek Harness plugin 0.4.2-rc.1
+
+This isolated compatibility candidate targets DeepSeek Harness `0.1.7-rc.2`.
+It requires system Node.js `>=24.0.0`. It is deliberately published under a
+dedicated npm dist-tag so the existing `beta`, `rc`, and `dsh015` installation
+channels remain unchanged.
+
+## Compatibility changes
+
+- Adapt strict Typert codecs to the `create()` schema factory required by DSH
+  `0.1.7`, while retaining the `schema` property used by the earlier `0.1.5`
+  loader.
+- Align DeepSeek Harness peer-package ranges and the onboarding manifest with
+  `0.1.7-rc.2`.
+- Keep Foggy CLI, Launcher, Skills, Runtime behavior, and the development-only
+  product boundary unchanged.
+
+## Installation
+
+Use Node.js 24 or newer and a separate Harness profile:
+
+```powershell
+dsh plugin --profile web add --workspace-root @foggy-projects/deepseek-harness-plugin@0.4.2-rc.1
+dsh web
+```
+
+The same candidate is available through the dedicated `dsh017` npm dist-tag.
+Do not use this candidate to replace a stable `beta` installation unless the
+profile is intended to run DSH `0.1.7-rc.2`.
+
+## Compatibility acceptance (2026-09-25)
+
+- `npm run check`, all 23 Node tests, and all 29 Python tests passed on Node
+  `24.19.0`.
+- Packed and installed this exact candidate into a fresh temporary DSH Web
+  profile running `0.1.7-rc.2`. The package manager completed installation;
+  DSH emitted no plugin/Typert registration error at startup.
+- The authenticated Web boot graph included the Foggy client bundle. Fetching
+  the served bundle returned HTTP 200 and confirmed the `settings.plugins.tab`
+  contribution is present.
+- Invoked Foggy `status` and `plan` through DSH's Remote HTTP transport. Both
+  returned successful structured results with package version `0.4.2-rc.1`.
+- Created a temporary session and called DSH's native `skills/list` Remote. It
+  returned `foggy-deepseek-onboarding` from the installed plugin package and
+  `modelInvocable: true`. The host also exposes separately installed user-level
+  Foggy skills; the package-provided onboarding Skill remained individually
+  discoverable.
+- Used Plugin Manager to disable and re-enable the bundle. Both changes
+  reported `application: applied`; while disabled, the Foggy strict Remote
+  correctly returned `gateway/definition-unavailable`, and after re-enabling
+  `status` succeeded again. The final bundle state is enabled and installed.
+- No Runtime was started, no component update/repair was requested, and no
+  database connection or query was made. The status read observed the host's
+  existing Foggy component state; it did not change it. Full component
+  installation and Runtime behavior remain outside this DSH protocol smoke
+  test.
+
+## Upstream references
+
+- [DeepSeek Harness v0.1.7-rc.2 release](https://github.com/deepseek-ai/deepseek-harness/releases/tag/dsh-v0.1.7-rc.2)
+- [DeepSeek Harness v0.1.7-rc.1 release](https://github.com/deepseek-ai/deepseek-harness/releases/tag/dsh-v0.1.7-rc.1)
+- [DeepSeek Harness release history](https://github.com/deepseek-ai/deepseek-harness/releases)

package/docs/RELEASE-CANDIDATE-0.4.2-DSH-0.1.7-RC.2.md

@@ -0,0 +1,50 @@
+# Foggy DeepSeek Harness plugin 0.4.2-rc.2
+
+This pre-release targets DeepSeek Harness `0.1.7-rc.2` with system Node.js
+`>=24.0.0` and Java 17+. It stays on the dedicated `dsh017` npm channel;
+the existing `beta`, `rc`, and `dsh015` channels are unchanged.
+
+## Changes since 0.4.2-rc.1
+
+- Publish each polled operation state to the settings UI so initialization and
+  Runtime startup progress remain visible while the operation runs. Known
+  progress phases now use the selected UI language instead of raw English
+  backend messages.
+- Use the managed CLI's `wait-ready` response as Doctor's Runtime health check.
+  Process inspection remains diagnostic context, so an unavailable Windows
+  process query does not incorrectly label a healthy Runtime as stale.
+- Clarify workspace behavior: an existing DSH session retains its original
+  `cwd` when the default workspace changes. Create a new session in the chosen
+  workspace to isolate new semantic-model files.
+
+## Acceptance
+
+- On a fresh Windows component/data root, the settings page visibly showed
+  initialization progress during the private Python download (23%, step 2/7).
+  CLI `0.1.23`, Launcher `0.1.21`, and analysis/query Skills `0.1.18` installed.
+- The default Runtime port `18166` was occupied by an earlier acceptance
+  Runtime. The new profile failed promptly at port preflight and displayed an
+  explicit red port-conflict alert. Saving port `18167` in the isolated data
+  root and starting the managed Launcher succeeded. Strict Doctor passed all
+  eight checks; CLI `wait-ready` and `capabilities` reported a healthy Java
+  Runtime at `http://127.0.0.1:18167`.
+- A Harness chat created a separate TM/QM and a bounded 2024 monthly paid
+  amount query against the local demo `fact_order` table. Runtime model
+  describe, query validate, and query execute agreed with the four rows shown
+  in the chat. This remains development/test data, not production deployment.
+- The candidate tarball was installed over the local `0.4.2-rc.1` test profile.
+  pnpm's lockfile policy passed; the installed client matched the packed source,
+  DSH Web restarted without plugin activation errors, and its authenticated
+  page returned HTTP 200. The existing component install state remained intact,
+  with Runtime still healthy on port `18167` and strict Doctor again passing
+  all eight checks.
+
+Install the exact version with:
+
+```powershell
+dsh plugin --profile web add --workspace-root @foggy-projects/deepseek-harness-plugin@0.4.2-rc.2
+```
+
+Publish this pre-release under the `dsh017` dist-tag only, leaving other npm
+channels unchanged. The Linux `experience/linux/prepare.sh` entry is pinned to
+the matching Git tag and becomes usable once that tag is published.

package/docs/WINDOWS-BETA-ACCEPTANCE.md

@@ -1,12 +1,12 @@
 # Native Windows Beta acceptance
 
-This runbook validates DeepSeek Harness `0.1.2-rc.1` with Foggy plugin
-`0.4.0-rc.2` on a clean 64-bit Windows 10 or Windows 11 machine. Use a local
+This runbook validates DeepSeek Harness `0.1.7-rc.2` with Foggy plugin
+`0.4.2-rc.2` on a clean 64-bit Windows 10 or Windows 11 machine. Use a local
 directory that is not synchronized by OneDrive.
 
 ## Prerequisites
 
-Install a system Node.js matching `^22.19.0 || >=24.0.0` and a system Java 17+
+Install a system Node.js `>=24.0.0` and a system Java 17+
 JRE/JDK. Windows must also provide `tar` (included in supported Windows 10/11
 versions). A system Python is neither required nor used by default.
 
@@ -27,11 +27,11 @@ and is not registered as a system Python.
 New-Item -ItemType Directory -Force C:\FoggyAcceptance | Out-Null
 Set-Location C:\FoggyAcceptance
 
-npx --yes --package=@deepseek-ai/dsh@0.1.2-rc.1 --package=pnpm@11.7.0 `
+npx --yes --package=@deepseek-ai/dsh@0.1.7-rc.2 --package=pnpm@11.7.0 `
   dsh plugin --profile web add --workspace-root `
-  "@foggy-projects/deepseek-harness-plugin@beta"
+  "@foggy-projects/deepseek-harness-plugin@0.4.2-rc.2"
 
-npx --yes --package=@deepseek-ai/dsh@0.1.2-rc.1 --package=pnpm@11.7.0 dsh web
+npx --yes --package=@deepseek-ai/dsh@0.1.7-rc.2 --package=pnpm@11.7.0 dsh web
 ```
 
 If an immediate upgrade reports
@@ -49,7 +49,13 @@ token has established its local authentication cookie. Treat the launch URL as
 temporary local access material and do not paste it into chat or diagnostics.
 
 Configure an LLM provider, select the `C:\FoggyAcceptance` workspace, then open
-**Settings → Plugins → Foggy Data Analysis** and choose **Initialize Foggy**.
+**Settings → Built-in plugins → Foggy Data Analysis** and choose
+**Initialize and start**. The settings page displays the current phase and
+step count while initialization runs. If an existing chat was opened before
+selecting this workspace, create a new chat in the selected workspace: changing
+the default workspace does not change an existing chat's working directory.
+`--workspace-root` in the install command is a pnpm resolution option, not a
+DSH workspace selector.
 
 Before starting Runtime, confirm the configured port in **Runtime connection
 settings**. A fresh profile defaults to `18166`. To use another port, enter an
@@ -62,13 +68,15 @@ Expected component state:
 - CLI 0.1.23;
 - Launcher 0.1.21;
 - analysis/query Skills 0.1.18;
-- onboarding Skill 0.4.0-rc.2;
+- onboarding Skill 0.4.2-rc.2;
 - Java 17+ available;
 - native DSH Skill registration available.
 
 Runtime startup shows its current phase, elapsed time, and the 180-second
 readiness deadline. Typical startup is 15–30 seconds on the validated WSL2 host
 and may take up to 60 seconds on Windows with cold JVM or antivirus scanning.
+Initialization downloads a private Python and other managed components and can
+take longer than Runtime startup; follow the live phase/step display.
 The plugin monitors the Launcher PID and fails promptly when Java exits before
 readiness. On failure, export diagnostics before retrying; the report includes
 the startup phase, PID state, evidence directory, Runtime log locations, and

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 `>=24.0.0` (the DSH 0.1.5-rc.2 compatibility candidate)
+- Node.js `>=24.0.0` (the DSH 0.1.7-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 0.1.5-rc.2 inside
+The script installs pinned pnpm and DeepSeek Harness 0.1.7-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.
@@ -33,8 +33,8 @@ Start the prepared profile with:
 ~/.local/share/foggy-deepseek-harness-experience/run.sh
 ```
 
-Open the URL printed by DSH, then choose **Settings → Plugins → Foggy Data Analysis** and select
-**Initialize Foggy**. Private Python, the CLI, Launcher, and analysis Skill are downloaded from their
+Open the URL printed by DSH, then choose **Settings → Built-in plugins → Foggy Data Analysis** and select
+**Initialize and start**. Private Python, the CLI, Launcher, and analysis Skill are downloaded from their
 pinned public Releases and verified before installation. A system Python is not required.
 
 Provider configuration remains a separate DSH setup step. Store API keys in a private environment

package/experience/linux/prepare.sh

@@ -1,9 +1,9 @@
 #!/usr/bin/env bash
 set -euo pipefail
 
-DSH_VERSION="0.1.5-rc.2"
+DSH_VERSION="0.1.7-rc.2"
 PNPM_VERSION="11.7.0"
-PLUGIN_VERSION="0.4.1-rc.1"
+PLUGIN_VERSION="0.4.2-rc.2"
 PLUGIN_REF="v${PLUGIN_VERSION}"
 PLUGIN_REPOSITORY="https://github.com/foggy-projects/foggy-deepseek-harness-plugin.git"
 
@@ -74,7 +74,7 @@ require_command df
 require_command tar
 
 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)"
+  || fail "Node >=24 required for DeepSeek Harness ${DSH_VERSION}; 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

@@ -28,6 +28,7 @@ window.__ModuleLoader__.load({
         mode: 'strict',
         typeSymbol: '@foggy-projects/deepseek-harness-plugin#FoggyIntegrationResult',
         schema: passthroughSchema,
+        create: () => passthroughSchema,
       },
       sourceLocation: { file: 'lib/index.js', line: 1, column: 1 },
     })
@@ -46,6 +47,7 @@ window.__ModuleLoader__.load({
             mode: 'strict',
             typeSymbol: '@foggy-projects/deepseek-harness-plugin#FoggyRuntimeSettingsInput',
             schema: runtimeSettingsInputSchema,
+            create: () => runtimeSettingsInputSchema,
           },
         }]),
       ],
@@ -309,7 +311,7 @@ window.__ModuleLoader__.load({
       .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;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-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:flex-end;gap:12px;margin-top:8px;color:var(--dsw-alias-label-tertiary);font-size:11px;line-height:16px}.foggy-progress-file{justify-content:flex-start;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}
@@ -401,8 +403,9 @@ window.__ModuleLoader__.load({
         'runtime-state': 'progressRuntimeState',
         'runtime-complete': 'progressRuntimeComplete',
       }
-      const phase = t(phaseKeys[progress.phase] || 'progressWorking')
-      const headline = String(progress.phase || '').startsWith('runtime-') ? phase : progress.message || phase
+      const phaseKey = phaseKeys[progress.phase]
+      const phase = t(phaseKey || 'progressWorking')
+      const headline = phaseKey ? phase : progress.message || phase
       const step = progress.step?.index && progress.step?.total
         ? `${progress.step.index}/${progress.step.total}`
         : ''
@@ -414,6 +417,7 @@ window.__ModuleLoader__.load({
       const timing = Number.isFinite(elapsed)
         ? `${t('progressElapsed')} ${elapsed}${t('progressSeconds')}${Number.isFinite(timeout) ? ` / ${t('progressTimeout')} ${timeout}${t('progressSeconds')}` : ''}`
         : ''
+      const meta = [step, files, timing].filter(Boolean).join(' · ')
       return jsxs('div', {
         className: 'foggy-progress',
         role: 'status',
@@ -432,10 +436,7 @@ window.__ModuleLoader__.load({
             'aria-label': phase,
             children: jsx('div', { className: 'foggy-progress-fill', style: { width: `${percent}%` } }),
           }),
-          jsxs('div', { className: 'foggy-progress-meta', children: [
-            jsx('span', { children: phase }),
-            jsx('span', { children: [step, files, timing].filter(Boolean).join(' · ') }),
-          ] }),
+          meta ? jsx('div', { className: 'foggy-progress-meta', children: meta }) : null,
           progress.currentFile ? jsx('div', { className: 'foggy-progress-meta foggy-progress-file', title: progress.currentFile, children: progress.currentFile }) : null,
         ],
       })
@@ -552,7 +553,10 @@ window.__ModuleLoader__.load({
         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
+          if (operation?.id === operationId) {
+            setView((current) => ({ ...current, phase: 'ready', status }))
+            if (operation.state !== 'running') return status
+          }
           await new Promise((resolve) => setTimeout(resolve, 1000))
         }
         throw new Error(t('operationTimeout'))

package/lib/index.js

@@ -155,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 0.1.5-rc.2 requires Node.js >=24.0.0; detected ${process.versions.node}`)
+    throw new Error(`This DeepSeek Harness plugin 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')

package/lib/remote-descriptor.js

@@ -5,6 +5,16 @@ const runtimeSettingsInputSchema = z.object({
   port: z.number().int().min(1024).max(65535),
 }).strict()
 
+function strictCodec(typeSymbol, schema) {
+  return {
+    mode: 'strict',
+    typeSymbol,
+    // DSH 0.1.5 consumes `schema`; DSH 0.1.7 materializes it through `create()`.
+    schema,
+    create: () => schema,
+  }
+}
+
 function descriptor(method, parameters = []) {
   return {
     id: `@foggy-projects/deepseek-harness-plugin#foggyIntegration/${method}`,
@@ -13,11 +23,7 @@ function descriptor(method, parameters = []) {
     method,
     invocation: { kind: 'direct' },
     parameters,
-    result: {
-      mode: 'strict',
-      typeSymbol: '@foggy-projects/deepseek-harness-plugin#FoggyIntegrationResult',
-      schema: resultSchema,
-    },
+    result: strictCodec('@foggy-projects/deepseek-harness-plugin#FoggyIntegrationResult', resultSchema),
     sourceLocation: { file: 'lib/index.js', line: 1, column: 1 },
   }
 }
@@ -37,10 +43,6 @@ export const descriptors = [
     name: 'input',
     wire: 'input',
     source: 'json',
-    codec: {
-      mode: 'strict',
-      typeSymbol: '@foggy-projects/deepseek-harness-plugin#FoggyRuntimeSettingsInput',
-      schema: runtimeSettingsInputSchema,
-    },
+    codec: strictCodec('@foggy-projects/deepseek-harness-plugin#FoggyRuntimeSettingsInput', runtimeSettingsInputSchema),
   }]),
 ]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@foggy-projects/deepseek-harness-plugin",
-  "version": "0.4.1-rc.1",
+  "version": "0.4.2-rc.2",
   "description": "Foggy Java data analysis engine integration for DeepSeek Harness",
   "keywords": [
     "deepseek-harness",
@@ -40,6 +40,8 @@
     "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/RELEASE-CANDIDATE-0.4.2-DSH-0.1.7-RC.2.md",
+    "docs/RELEASE-CANDIDATE-0.4.2-DSH-0.1.7-RC.1.md",
     "docs/COMMUNITY-MARKETPLACES.md",
     "docs/WINDOWS-BETA-ACCEPTANCE.md",
     "THIRD-PARTY-RUNTIME-NOTICES.md",
@@ -68,12 +70,12 @@
   },
   "peerDependencies": {
     "@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"
+    "@deepseek-ai/dsh-api-remotes": "^0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-locale": "^0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-settings": "^0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-settings-plugins": "^0.1.7-rc.2",
+    "@deepseek-ai/dsh-skill": "^0.1.7-rc.2",
+    "@deepseek-ai/dsh-typert-protocol": "^0.1.7-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/SKILL.md

@@ -40,8 +40,9 @@ are authoritative; do not copy the Skill into the current workspace.
 
 ## Development workflow
 
-1. Run `doctor`. Start Runtime only if it is not already healthy; require `wait-ready` and
-   `capabilities` after a new start.
+1. Run `doctor`. Runtime health is established by the managed CLI's read-only `wait-ready` check;
+   process visibility alone does not prove HTTP readiness. Start Runtime only if it is not already
+   healthy; require `wait-ready` and `capabilities` after a new start.
 2. Accept datasource connection details from the user's message, a user-supplied local JSON file, an
    environment variable, or Runtime Console. Direct `password` is supported for local development.
    The wrapper submits it to the public Runtime API without copying it into onboarding state or

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

@@ -1,10 +1,10 @@
 {
   "schemaVersion": "foggy-deepseek-onboarding-versions/v1",
-  "packageVersion": "0.4.1-rc.1",
-  "validatedAt": "2026-09-13",
+  "packageVersion": "0.4.2-rc.2",
+  "validatedAt": "2026-09-27",
   "components": {
     "deepseekHarness": {
-      "version": "0.1.5-rc.2",
+      "version": "0.1.7-rc.2",
       "minimumNodeVersion": "24.0.0"
     },
     "python": {

package/skills/foggy-deepseek-onboarding/scripts/onboarding.py

@@ -1790,8 +1790,9 @@ def onboarding_context(args: argparse.Namespace, require_runtime: bool = False)
     if require_runtime:
         if not runtime_state:
             raise OnboardingError("Runtime is not started; run runtime-start first")
-        if not process_info(int(runtime_state.get("pid", 0)))["running"]:
-            raise OnboardingError("Runtime state is stale; restart Runtime before continuing")
+        health = runtime_health(install_state, runtime_state)
+        if health["status"] != "running":
+            raise OnboardingError("Runtime readiness could not be verified; run doctor and inspect Runtime health before continuing")
     return install_root, install_state, data_root, runtime_state
 
 
@@ -1814,6 +1815,52 @@ def cli_json(install_state: dict, runtime_state: dict, namespace: str, command:
     return payload
 
 
+def runtime_health(install_state: dict, runtime_state: dict) -> dict:
+    """Use Runtime API readiness as the health signal; process inspection is diagnostic only."""
+    pid = runtime_state.get("pid")
+    info = process_info(int(pid or 0))
+    base = {
+        "pid": pid,
+        "runtimeUrl": runtime_state.get("runtimeUrl"),
+        "identity": runtime_state.get("identity"),
+    }
+
+    try:
+        probe = cli_json(
+            install_state,
+            runtime_state,
+            runtime_state.get("namespace") or "default",
+            ["wait-ready", "--timeout-seconds", "2", "--interval-seconds", "1"],
+            "Runtime readiness probe",
+            timeout=5,
+        )
+    except OnboardingError:
+        return {
+            **base,
+            "status": "unverified",
+            "verifiedBy": "none",
+            "processInspection": "confirmed" if info["running"] else "not-confirmed",
+            "readiness": "failed",
+        }
+
+    data = probe.get("data")
+    if isinstance(data, dict) and data.get("ready") is True:
+        return {
+            **base,
+            "status": "running",
+            "verifiedBy": "runtime-api",
+            "processInspection": "confirmed" if info["running"] else "not-confirmed",
+            "readiness": "ready",
+        }
+    return {
+        **base,
+        "status": "unverified",
+        "verifiedBy": "none",
+        "processInspection": "confirmed" if info["running"] else "not-confirmed",
+        "readiness": "not-ready",
+    }
+
+
 TRANSIENT_DATASOURCE_TEST_MARKERS = (
     "connection is not available",
     "connection pool",
@@ -2741,7 +2788,7 @@ def next_onboarding_action(state: dict) -> dict:
 
 def onboarding_status_command(args: argparse.Namespace) -> dict:
     state, _install_state, _data_root, runtime_state = require_profile(args, require_runtime=False)
-    runtime_running = bool(runtime_state and process_info(int(runtime_state.get("pid", 0)))["running"])
+    runtime_running = bool(runtime_state and runtime_health(_install_state, runtime_state)["status"] == "running")
     connection = state["connection"]
     password_env = connection.get("passwordEnv")
     return {
@@ -3356,8 +3403,7 @@ def doctor_command(args: argparse.Namespace) -> dict:
         runtime_state_path = data_root / "runtime-state.json"
         if runtime_state_path.is_file():
             runtime_state = json.loads(runtime_state_path.read_text(encoding="utf-8"))
-            info = process_info(int(runtime_state.get("pid", 0)))
-            runtime = {"status": "running" if info["running"] else "stale", "pid": runtime_state.get("pid"), "runtimeUrl": runtime_state.get("runtimeUrl"), "identity": runtime_state.get("identity")}
+            runtime = runtime_health(state, runtime_state)
     required = {
         "python": python_ok,
         "java": java_ok,