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

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.2-rc.1` compatibility candidate targets DeepSeek Harness `0.1.7-rc.2`
+The `0.4.2-rc.3` 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,22 +17,23 @@ 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.2-rc.1.tgz
+dsh plugin --profile web add --workspace-root ./foggy-projects-deepseek-harness-plugin-0.4.2-rc.3.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.7-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.2-rc.1
+dsh plugin --profile web add --workspace-root @foggy-projects/deepseek-harness-plugin@0.4.2-rc.3
 ```
 
-The published candidate is also available through the dedicated `dsh017` npm
-dist-tag:
+The `dsh017` npm dist-tag points to the most recently published DSH 0.1.7
+candidate (`0.4.2-rc.3` 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@dsh017
@@ -91,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
@@ -124,6 +130,15 @@ same wildcard binding used by the Java server, so a conflicting application or W
 port proxy produces an immediate, high-visibility error instead of a readiness timeout.
 The CLI and Skills resolve the resulting stable Runtime URL from managed state.
 
+For a successful standard QueryModel DSL call made through the native
+`foggy_query` tool, Harness shows a query card with the model, namespace,
+row count, DSL, and execution result. Its **Open DataViewer** action creates
+a local preview URL only when clicked; the query itself does not create one.
+The preview re-executes the DSL against the current model and data rather than
+freezing the original rows. In the lite Runtime the preview cache is bounded,
+process-local, and lost on restart. CTE calls are not included in this first
+DataViewer integration.
+
 This beta remains a local dev/test integration. It does not automatically extend
 local credentials or approvals into a formal environment. Production model
 publication should use a separate manual or dedicated deployment workflow with
@@ -133,7 +148,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.7-rc.2 compatibility candidate is documented in
-[`docs/RELEASE-CANDIDATE-0.4.2-DSH-0.1.7-RC.1.md`](./docs/RELEASE-CANDIDATE-0.4.2-DSH-0.1.7-RC.1.md).
+[`docs/RELEASE-CANDIDATE-0.4.2-DSH-0.1.7-RC.3.md`](./docs/RELEASE-CANDIDATE-0.4.2-DSH-0.1.7-RC.3.md).
+The previous DSH 0.1.7-rc.2 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

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/RELEASE-CANDIDATE-0.4.2-DSH-0.1.7-RC.3.md

@@ -0,0 +1,34 @@
+# Foggy DeepSeek Harness plugin 0.4.2-rc.3
+
+This pre-release targets DeepSeek Harness `0.1.7-rc.2` on the `dsh017` npm
+channel. It keeps the `beta`, `rc`, and `dsh015` channels unchanged.
+
+## Changes since 0.4.2-rc.2
+
+- Add a native `foggy_query` tool for bounded, read-only standard QueryModel DSL
+  validation and execution. Successful calls render a Harness card with the
+  model, namespace, row count, DSL, SQL, and result.
+- Create a DataViewer preview URL only when the card's **Open DataViewer**
+  action is clicked. Links are short-lived local development previews, not
+  frozen result snapshots. An expired link can be regenerated from the card.
+- Update the managed Launcher to `0.1.22`. Its lite profile serves the existing
+  DataViewer UI using a bounded in-memory cache without MongoDB, and its start
+  scripts bind to loopback. Runtime restarts invalidate preview links.
+- Do not claim CTE preview support in this release. Existing CTE execution
+  remains available through its prior CLI path without a DataViewer card.
+
+## Acceptance scope
+
+- Plugin checks: `npm run check`, Node tests, Python onboarding tests, and an
+  isolated DSH `0.1.7-rc.2` web boot with the Foggy settings tab visible.
+- Launcher: formal release gate, default and Analytics Console smokes, six
+  GitHub assets, and SHA-256 verification.
+- End-to-end DSL: an isolated Java Runtime with SQLite demo data validates and
+  executes a QueryModel query. A click-generated DataViewer link shows actual
+  columns and six rows in the browser.
+
+Install the exact version with:
+
+```powershell
+dsh plugin --profile web add --workspace-root @foggy-projects/deepseek-harness-plugin@0.4.2-rc.3
+```

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.3` 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.3"
 
-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
@@ -60,15 +66,17 @@ Expected component state:
 
 - Python 3.12.13, source `Foggy private`;
 - CLI 0.1.23;
-- Launcher 0.1.21;
+- Launcher 0.1.22;
 - analysis/query Skills 0.1.18;
-- onboarding Skill 0.4.0-rc.2;
+- onboarding Skill 0.4.2-rc.3;
 - 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

@@ -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

@@ -3,7 +3,7 @@ set -euo pipefail
 
 DSH_VERSION="0.1.7-rc.2"
 PNPM_VERSION="11.7.0"
-PLUGIN_VERSION="0.4.2-rc.1"
+PLUGIN_VERSION="0.4.2-rc.3"
 PLUGIN_REF="v${PLUGIN_VERSION}"
 PLUGIN_REPOSITORY="https://github.com/foggy-projects/foggy-deepseek-harness-plugin.git"
 

package/lib/client.js

@@ -17,6 +17,15 @@ window.__ModuleLoader__.load({
         return { port }
       },
     }
+    const viewerPreviewInputSchema = {
+      parse: (value) => {
+        if (!value || typeof value.model !== 'string' || typeof value.namespace !== 'string'
+            || !value.payload || typeof value.payload !== 'object' || Array.isArray(value.payload)) {
+          throw new Error('Invalid DataViewer preview request')
+        }
+        return value
+      },
+    }
     const descriptor = (method, parameters = []) => ({
       id: `@foggy-projects/deepseek-harness-plugin#foggyIntegration/${method}`,
       service: 'foggyIntegration',
@@ -28,6 +37,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 +56,16 @@ window.__ModuleLoader__.load({
             mode: 'strict',
             typeSymbol: '@foggy-projects/deepseek-harness-plugin#FoggyRuntimeSettingsInput',
             schema: runtimeSettingsInputSchema,
+            create: () => runtimeSettingsInputSchema,
+          },
+        }]),
+        descriptor('createViewerPreview', [{
+          name: 'input', wire: 'input', source: 'json',
+          codec: {
+            mode: 'strict',
+            typeSymbol: '@foggy-projects/deepseek-harness-plugin#FoggyViewerPreviewInput',
+            schema: viewerPreviewInputSchema,
+            create: () => viewerPreviewInputSchema,
           },
         }]),
       ],
@@ -147,6 +167,16 @@ window.__ModuleLoader__.load({
       queryWarningSummary: 'Runtime 在 WARN 模式下忽略了未知的查询属性，查询仍已执行。请检查告警代码与证据后决定是否修正模型或请求。',
       queryWarningCodes: '告警代码',
       queryWarningEvidence: '证据目录',
+      queryCardTitle: 'Foggy DSL 查询',
+      queryCardRunning: '正在校验并执行…',
+      queryCardDone: '校验与查询成功',
+      queryCardFailed: '查询失败；可展开查看错误',
+      queryCardRows: '返回行数',
+      queryCardDetails: '查看 DSL 与执行结果',
+      queryCardOpen: '打开 DataViewer 数据页',
+      queryCardOpening: '正在生成预览链接…',
+      queryCardPreviewHint: '链接仅在点击时生成，默认有效期 60 分钟；Runtime 重启后失效。这是开发预览，非结果快照。',
+      queryCardUnsupported: '当前查询不支持 DataViewer 预览，可继续查看查询结果。',
       stepPlanned: '规划',
       stepDatasourceConfigured: '数据库连接',
       stepDatasourceVerified: '连接验证',
@@ -272,6 +302,16 @@ window.__ModuleLoader__.load({
       queryWarningSummary: 'In WARN mode, Runtime ignored unknown query properties and continued. Review the warning codes and evidence before deciding whether to change the model or request.',
       queryWarningCodes: 'Warning codes',
       queryWarningEvidence: 'Evidence directory',
+      queryCardTitle: 'Foggy DSL query',
+      queryCardRunning: 'Validating and executing…',
+      queryCardDone: 'Validation and query succeeded',
+      queryCardFailed: 'Query failed; expand for details',
+      queryCardRows: 'Rows',
+      queryCardDetails: 'Show DSL and execution result',
+      queryCardOpen: 'Open DataViewer',
+      queryCardOpening: 'Creating preview link…',
+      queryCardPreviewHint: 'The link is created on click, expires after 60 minutes or a Runtime restart, and is a development preview rather than a result snapshot.',
+      queryCardUnsupported: 'DataViewer preview is unavailable for this query; the query result remains available.',
       stepPlanned: 'Plan',
       stepDatasourceConfigured: 'Database connection',
       stepDatasourceVerified: 'Connection test',
@@ -309,7 +349,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 +441,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 +455,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 +474,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 +591,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'))
@@ -775,6 +817,62 @@ window.__ModuleLoader__.load({
       ] })
     }
 
+    function FoggyQueryCard({ phase, block, api, t }) {
+      const [preview, setPreview] = useState({ loading: false, url: '', expiresAt: 0, error: '' })
+      let args = null
+      let result = null
+      let outputText = ''
+      try {
+        const raw = phase === 'result' ? block.call?.argsRaw : phase === 'start' ? block.argsRaw : null
+        if (raw) args = JSON.parse(raw)
+        if (phase === 'result') {
+          outputText = block.content?.find((item) => item.type === 'text')?.text || ''
+          if (outputText) result = JSON.parse(outputText)
+        }
+      } catch {}
+      const success = phase === 'result' && !block.isError && Boolean(result?.execution?.success)
+      const rows = result?.execution?.data?.items?.length
+      const sql = result?.execution?.data?.debug?.extra?.sql
+      const payload = args?.payload
+      const supported = success && payload && Array.isArray(payload.columns) && payload.columns.length > 0
+        && !('executable_plan' in payload) && !('executablePlan' in payload) && payload.route !== 'DSL_CTE'
+        && Object.keys(payload).every((key) => ['columns', 'slice', 'groupBy', 'orderBy', 'calculatedFields', 'extData', 'start', 'limit', 'returnTotal'].includes(key))
+        && ['slice', 'groupBy', 'orderBy', 'calculatedFields'].every((key) => !payload[key] || Array.isArray(payload[key]) && payload[key].every((item) => item && typeof item === 'object' && !Array.isArray(item)))
+      async function openViewer() {
+        const pendingTab = window.open('about:blank', '_blank')
+        setPreview({ loading: true, url: '', expiresAt: 0, error: '' })
+        try {
+          const value = unwrap(await api.createViewerPreview({ model: args.model, namespace: args.namespace, payload }), 'createViewerPreview')
+          setPreview({ loading: false, url: value.url, expiresAt: Date.now() + value.expiresInMinutes * 60_000, error: '' })
+          if (pendingTab) pendingTab.location.replace(value.url)
+        } catch (error) {
+          if (pendingTab) pendingTab.close()
+          setPreview({ loading: false, url: '', expiresAt: 0, error: String(error?.message || error) })
+        }
+      }
+      const box = { border: '1px solid var(--dsw-alias-border-l2)', borderRadius: 10, padding: 12, margin: '8px 0', fontSize: 13 }
+      return jsxs('section', { style: box, children: [
+        jsx('strong', { children: `${t('queryCardTitle')}${args?.model ? ` · ${args.model}` : ''}` }),
+        jsx('p', { style: { margin: '6px 0', color: 'var(--dsw-alias-label-secondary)' }, children: success ? `${t('queryCardDone')}${Number.isInteger(rows) ? ` · ${t('queryCardRows')} ${rows}` : ''}` : phase === 'result' ? t('queryCardFailed') : t('queryCardRunning') }),
+        args?.namespace ? jsx('code', { children: `namespace: ${args.namespace}` }) : null,
+        success ? jsxs('details', { style: { marginTop: 8 }, children: [
+          jsx('summary', { style: { cursor: 'pointer' }, children: t('queryCardDetails') }),
+          sql ? jsx('pre', { style: { maxHeight: 180, overflow: 'auto', whiteSpace: 'pre-wrap', overflowWrap: 'anywhere' }, children: sql }) : null,
+          jsx('pre', { style: { maxHeight: 260, overflow: 'auto', whiteSpace: 'pre-wrap', overflowWrap: 'anywhere' }, children: JSON.stringify({ dsl: payload, validation: result.validation, execution: result.execution }, null, 2).slice(0, 30000) }),
+        ] }) : null,
+        phase === 'result' && !success ? jsxs('details', { style: { marginTop: 8 }, children: [
+          jsx('summary', { style: { cursor: 'pointer' }, children: t('queryCardFailed') }),
+          jsx('pre', { style: { maxHeight: 260, overflow: 'auto', whiteSpace: 'pre-wrap', overflowWrap: 'anywhere' }, children: (outputText || JSON.stringify(block)).slice(0, 6000) }),
+        ] }) : null,
+        supported ? jsxs('div', { style: { marginTop: 10 }, children: [
+          jsx('button', { type: 'button', disabled: preview.loading, onClick: openViewer, children: preview.loading ? t('queryCardOpening') : t('queryCardOpen') }),
+          jsx('p', { style: { margin: '5px 0', color: 'var(--dsw-alias-label-tertiary)', fontSize: 11 }, children: t('queryCardPreviewHint') }),
+          preview.url && Date.now() < preview.expiresAt ? jsx('a', { href: preview.url, target: '_blank', rel: 'noopener noreferrer', children: preview.url }) : null,
+          preview.error ? jsx('p', { role: 'alert', style: { color: 'var(--dsw-alias-state-error-primary)' }, children: preview.error }) : null,
+        ] }) : success ? jsx('p', { style: { margin: '8px 0 0', color: 'var(--dsw-alias-label-tertiary)' }, children: t('queryCardUnsupported') }) : null,
+      ] })
+    }
+
     const inject = ['slots', 'locale', 'remote']
 
     async function apply(ctx) {
@@ -784,6 +882,11 @@ window.__ModuleLoader__.load({
       const t = ctx.locale.bind(NS)
       ctx.inject(['remote.foggyIntegration'], (remoteCtx) => {
         const api = remoteCtx.remote.foggyIntegration
+        remoteCtx.slots.inject('tool.call.toolview', () => remoteCtx.slots.register({
+          name: 'tool.call.toolview',
+          key: 'foggy_query',
+          inject: () => ({ api, t }),
+        }, FoggyQueryCard))
         remoteCtx.slots.inject('settings.plugins.tab', () => remoteCtx.slots.register({
           name: 'settings.plugins.tab',
           id: 'foggy',

package/lib/index.js

@@ -10,6 +10,8 @@ import { writeJsonAtomic } from './atomic-json.js'
 import { ensurePythonRuntime, probePythonRuntime } from './python-runtime.js'
 import { compatible, compatibleNode } from './version.js'
 import { enrichRuntimeStartFailure } from './diagnostics.js'
+import { createFoggyQueryTool, managedConnection } from './query-tool.js'
+import { createViewerPreview } from './viewer-preview.js'
 import {
   DEFAULT_RUNTIME_PORT,
   readRuntimeSettings,
@@ -210,7 +212,7 @@ function operationView(operation) {
 }
 
 export class FoggyIntegrationGateway extends TypertRemoteService {
-  static inject = ['skills']
+  static inject = ['skills', 'tools']
 
   operation = null
   skillProviderControl = null
@@ -222,9 +224,15 @@ export class FoggyIntegrationGateway extends TypertRemoteService {
       this.skillProviderControl = control
       return createFoggySkillProvider({ installRoot: roots.installRoot, versionsFile })
     })
+    ctx.tools.register(createFoggyQueryTool(roots))
     for (const initialize of markerInitializers) initialize.call(this)
   }
 
+  async createViewerPreview(input) {
+    const { runtimeUrl } = await managedConnection(defaultRoots())
+    return createViewerPreview(input, runtimeUrl)
+  }
+
   async status() {
     const roots = defaultRoots()
     const statePath = join(roots.installRoot, 'install-state.json')
@@ -672,6 +680,7 @@ for (const method of [
   'status', 'plan', 'initialize', 'initializeAndStart', 'repair', 'updateComponents', 'repairPython', 'repairCli', 'repairLauncher', 'repairAnalysisSkill', 'repairSemanticQuerySkill',
   'migrateProfiles', 'diagnostics', 'runtimeStart', 'runtimeStop',
   'saveRuntimeSettings',
+  'createViewerPreview',
 ]) {
   Remote(method)(FoggyIntegrationGateway.prototype[method], {
     kind: 'method',

package/lib/query-tool.js

@@ -0,0 +1,104 @@
+import { execFile } from 'node:child_process'
+import { mkdtemp, readFile, rmdir, unlink, writeFile } from 'node:fs/promises'
+import { tmpdir } from 'node:os'
+import { join } from 'node:path'
+import { promisify } from 'node:util'
+import { defineTool } from '@deepseek-ai/dsh-tools'
+
+const execFileAsync = promisify(execFile)
+const identifier = /^[A-Za-z0-9_.-]{1,128}$/
+
+export function assertStandardDsl(payload) {
+  if (!payload || typeof payload !== 'object' || Array.isArray(payload)) throw new Error('Query DSL must be a JSON object')
+  if (payload.route === 'DSL_CTE' || 'executable_plan' in payload || 'executablePlan' in payload) {
+    throw new Error('CTE preview is not supported in this release; use a standard QM DSL query')
+  }
+  if (!Array.isArray(payload.columns) || payload.columns.length === 0 || !payload.columns.every((item) => typeof item === 'string')) {
+    throw new Error('Standard QM DSL requires non-empty columns')
+  }
+}
+
+export function previewPayload(payload) {
+  assertStandardDsl(payload)
+  const supported = new Set(['columns', 'slice', 'groupBy', 'orderBy', 'calculatedFields', 'extData'])
+  const unsupported = Object.keys(payload).filter((key) => !supported.has(key) && !['start', 'limit', 'returnTotal'].includes(key))
+  if (unsupported.length) throw new Error(`DataViewer preview does not support: ${unsupported.join(', ')}`)
+  for (const key of ['slice', 'groupBy', 'orderBy', 'calculatedFields']) {
+    if (payload[key] !== undefined && (!Array.isArray(payload[key]) || payload[key].some((item) => !item || typeof item !== 'object' || Array.isArray(item)))) {
+      throw new Error(`DataViewer preview requires object-form ${key} entries`)
+    }
+  }
+  return Object.fromEntries([...supported].filter((key) => payload[key] !== undefined).map((key) => [key, payload[key]]))
+}
+
+export function safeRuntimeUrl(value) {
+  const url = new URL(value)
+  if (url.protocol !== 'http:' || !['127.0.0.1', 'localhost', '[::1]'].includes(url.hostname)
+      || url.username || url.password || url.pathname !== '/' || url.search || url.hash) {
+    throw new Error('Managed Runtime URL must be a plain loopback HTTP origin')
+  }
+  return url.origin
+}
+
+export async function managedConnection(roots) {
+  const install = JSON.parse(await readFile(join(roots.installRoot, 'install-state.json'), 'utf8'))
+  const runtime = JSON.parse(await readFile(join(roots.dataRoot, 'runtime-state.json'), 'utf8'))
+  if (!install.cli?.command) throw new Error('Foggy CLI is not installed')
+  return { cli: install.cli.command, runtimeUrl: safeRuntimeUrl(runtime.runtimeUrl) }
+}
+
+async function cliJson(cli, runtimeUrl, namespace, command, signal) {
+  const { stdout } = await execFileAsync(cli, ['--base-url', runtimeUrl, '--namespace', namespace, '--output', 'json', ...command], {
+    signal,
+    windowsHide: true,
+    timeout: 120_000,
+    maxBuffer: 8 * 1024 * 1024,
+  })
+  const value = JSON.parse(stdout.trim())
+  if (value?.success !== true) throw new Error(value?.error?.message || value?.error?.code || 'Foggy query failed')
+  return value
+}
+
+export function createFoggyQueryTool(roots) {
+  return defineTool({
+    name: 'foggy_query',
+    description: 'Validate and execute a bounded, read-only standard Foggy QueryModel DSL query against the managed local Runtime. On success Harness shows a query card; its DataViewer preview link is created only if the user clicks Open DataViewer. CTE is not supported here.',
+    parameters: {
+      model: { type: 'string', required: true, description: 'Published Foggy QueryModel name' },
+      namespace: { type: 'string', required: true, description: 'Foggy namespace' },
+      payload: { type: 'object', additionalProperties: true, required: true, description: 'Standard QueryModel DSL, including explicit columns and bounded limit' },
+    },
+    output: {
+      schema: { type: 'object', additionalProperties: false, properties: {
+        model: { type: 'string', required: true },
+        namespace: { type: 'string', required: true },
+        validation: { type: 'json', required: true },
+        execution: { type: 'json', required: true },
+      } },
+      render: (_args, value) => [{ type: 'text', text: JSON.stringify(value) }],
+    },
+    timeoutMs: 150_000,
+    async execute({ model, namespace, payload }, exec) {
+      if (!identifier.test(model) || !identifier.test(namespace)) throw new Error('Invalid model or namespace')
+      assertStandardDsl(payload)
+      if (!Number.isInteger(payload.limit) || payload.limit < 1 || payload.limit > 100) {
+        throw new Error('Query DSL limit must be an integer from 1 to 100')
+      }
+      const { cli, runtimeUrl } = await managedConnection(roots)
+      const directory = await mkdtemp(join(tmpdir(), 'foggy-dsh-query-'))
+      const payloadPath = join(directory, 'query.json')
+      try {
+        await writeFile(payloadPath, JSON.stringify(payload), { encoding: 'utf8', flag: 'wx' })
+        const validation = await cliJson(cli, runtimeUrl, namespace, ['query', 'validate', model, '--payload', payloadPath], exec.signal)
+        const execution = await cliJson(cli, runtimeUrl, namespace, ['query', 'execute', model, '--payload', payloadPath], exec.signal)
+        return { model, namespace, validation, execution }
+      } finally {
+        await unlink(payloadPath).catch(() => {})
+        await rmdir(directory).catch(() => {})
+      }
+    },
+    presentCall({ model }) {
+      return { card: 'generic', title: `Foggy DSL · ${model}`, kind: 'read' }
+    },
+  })
+}

package/lib/remote-descriptor.js

@@ -4,6 +4,11 @@ const resultSchema = z.unknown()
 const runtimeSettingsInputSchema = z.object({
   port: z.number().int().min(1024).max(65535),
 }).strict()
+const viewerPreviewInputSchema = z.object({
+  model: z.string(),
+  namespace: z.string(),
+  payload: z.record(z.string(), z.unknown()),
+}).strict()
 
 function strictCodec(typeSymbol, schema) {
   return {
@@ -45,4 +50,10 @@ export const descriptors = [
     source: 'json',
     codec: strictCodec('@foggy-projects/deepseek-harness-plugin#FoggyRuntimeSettingsInput', runtimeSettingsInputSchema),
   }]),
+  descriptor('createViewerPreview', [{
+    name: 'input',
+    wire: 'input',
+    source: 'json',
+    codec: strictCodec('@foggy-projects/deepseek-harness-plugin#FoggyViewerPreviewInput', viewerPreviewInputSchema),
+  }]),
 ]

package/lib/viewer-preview.js

@@ -0,0 +1,27 @@
+import { previewPayload, safeRuntimeUrl } from './query-tool.js'
+
+const identifier = /^[A-Za-z0-9_.-]{1,128}$/
+
+export async function createViewerPreview({ model, namespace, payload }, runtimeUrl, fetcher = fetch) {
+  if (!identifier.test(model) || !identifier.test(namespace)) throw new Error('Invalid model or namespace')
+  const origin = safeRuntimeUrl(runtimeUrl)
+  const body = { model, namespace, title: `${model} · Harness preview`, payload: previewPayload(payload) }
+  const response = await fetcher(`${origin}/data-viewer/api/query/create`, {
+    method: 'POST',
+    headers: { 'content-type': 'application/json' },
+    body: JSON.stringify(body),
+    signal: AbortSignal.timeout(12_000),
+  })
+  if (!response.ok) throw new Error(`DataViewer unavailable (HTTP ${response.status}); update and restart the managed Runtime`)
+  const envelope = await response.json()
+  const result = envelope?.data
+  if (envelope?.code !== 200 || result?.success !== true || typeof result.viewerUrl !== 'string') {
+    throw new Error(envelope?.msg || result?.error || 'DataViewer did not return a preview link')
+  }
+  const url = new URL(result.viewerUrl, origin)
+  if (url.origin !== origin || !url.pathname.startsWith(`/data-viewer/view/${encodeURIComponent(model)}/`)
+      || url.username || url.password || url.search || url.hash) {
+    throw new Error('DataViewer returned an unexpected preview URL')
+  }
+  return { success: true, url: url.href, queryId: result.queryId, expiresInMinutes: 60 }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@foggy-projects/deepseek-harness-plugin",
-  "version": "0.4.2-rc.1",
+  "version": "0.4.2-rc.3",
   "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.3.md",
     "docs/RELEASE-CANDIDATE-0.4.2-DSH-0.1.7-RC.1.md",
     "docs/COMMUNITY-MARKETPLACES.md",
     "docs/WINDOWS-BETA-ACCEPTANCE.md",
@@ -60,11 +62,13 @@
         "@deepseek-ai/dsh-api-remotes",
         "@deepseek-ai/dsh-client-locale",
         "@deepseek-ai/dsh-client-ui-settings",
-        "@deepseek-ai/dsh-client-ui-settings-plugins"
+        "@deepseek-ai/dsh-client-ui-settings-plugins",
+        "@deepseek-ai/dsh-client-ui-tool"
       ]
     }
   },
   "dependencies": {
+    "@deepseek-ai/dsh-tools": "0.1.7-rc.2",
     "zod": "^4.4.3"
   },
   "peerDependencies": {
@@ -73,11 +77,12 @@
     "@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-client-ui-tool": "^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",
-    "test": "node --test test/package.test.js && node test/run-onboarding-tests.js"
+    "check": "node --check lib/index.js && node --check lib/query-tool.js && node --check lib/viewer-preview.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",
+    "test": "node --test test/package.test.js test/viewer-preview.test.js && node test/run-onboarding-tests.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
@@ -59,6 +60,12 @@ are authoritative; do not copy the Skill into the current workspace.
 6. Iterate through model validation, Bundle registration/update, model refresh/describe, query
    validation, and bounded query execution. Development publication means making the local model
    directory effective in this local Runtime; it is not a production release.
+   For the final user-facing standard DSL query in Harness, use the native `foggy_query` tool when
+   available (explicit namespace, published QM, `columns`, and `limit` of 1–100). It validates and
+   executes, then displays a query card. The card creates a DataViewer preview link only if the user
+   clicks its button; never pre-create links for every query. This first version does not support
+   `DSL_CTE` or `executable_plan` in the native tool. Continue using the documented CLI route for
+   CTE queries and do not claim they have a DataViewer preview.
    A successful response may still contain Runtime `warnings`. Preserve and report their stable facts
    (`code`, `path`, `message`, `suggestedNextAction`, `safeToAutoRepair`, `normalizedFragment`,
    `docsRef`, and `details.allowedProperties`)

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

@@ -1,7 +1,7 @@
 {
   "schemaVersion": "foggy-deepseek-onboarding-versions/v1",
-  "packageVersion": "0.4.2-rc.1",
-  "validatedAt": "2026-09-25",
+  "packageVersion": "0.4.2-rc.3",
+  "validatedAt": "2026-09-28",
   "components": {
     "deepseekHarness": {
       "version": "0.1.7-rc.2",
@@ -66,39 +66,39 @@
       }
     },
     "launcher": {
-      "version": "0.1.21",
+      "version": "0.1.22",
       "minimumJavaVersion": "17.0.0",
       "runtimeApiContract": "foggy-runtime-api/v1",
       "assets": [
         {
-          "file": "foggy-runtime-launcher-0.1.21.jar",
-          "url": "https://github.com/foggy-projects/foggy-data-mcp-bridge/releases/download/foggy-runtime-launcher-v0.1.21/foggy-runtime-launcher-0.1.21.jar",
-          "sha256": "0b5002e40633f4606b0f5d3adbcd734ad4a11d8204decab162bb53b6ab28b3b3"
+          "file": "foggy-runtime-launcher-0.1.22.jar",
+          "url": "https://github.com/foggy-projects/foggy-data-mcp-bridge/releases/download/foggy-runtime-launcher-v0.1.22/foggy-runtime-launcher-0.1.22.jar",
+          "sha256": "c26d21ff50323d6adc3124e084462f8381407c6f79802cefac90f4ddafa00dca"
         },
         {
           "file": "start-foggy-runtime.ps1",
-          "url": "https://github.com/foggy-projects/foggy-data-mcp-bridge/releases/download/foggy-runtime-launcher-v0.1.21/start-foggy-runtime.ps1",
-          "sha256": "8609f8c60bad9e56460b132e1bd6c699d4ebf47cf591c3e6bc37bc8563d7de5a"
+          "url": "https://github.com/foggy-projects/foggy-data-mcp-bridge/releases/download/foggy-runtime-launcher-v0.1.22/start-foggy-runtime.ps1",
+          "sha256": "dcfaa3d4e512e72f16e6d44dda00ae27f0cfc164763cac73c0ee63fd4b7236bc"
         },
         {
           "file": "start-foggy-runtime.sh",
-          "url": "https://github.com/foggy-projects/foggy-data-mcp-bridge/releases/download/foggy-runtime-launcher-v0.1.21/start-foggy-runtime.sh",
-          "sha256": "fa844f422473ba00a31cf801092b0fe4ef93fe8697656a9063e0ec27dacef715"
+          "url": "https://github.com/foggy-projects/foggy-data-mcp-bridge/releases/download/foggy-runtime-launcher-v0.1.22/start-foggy-runtime.sh",
+          "sha256": "fa304f66679f0323157ea7948fd95fb1082264f115b9b4d688b1995c24b3c1d7"
         },
         {
           "file": "README-foggy-runtime-launcher.md",
-          "url": "https://github.com/foggy-projects/foggy-data-mcp-bridge/releases/download/foggy-runtime-launcher-v0.1.21/README-foggy-runtime-launcher.md",
-          "sha256": "6b63cafe798e19c255a043e15e64109f6fb3252aee3fb9c37ab6a66d9adbf3cf"
+          "url": "https://github.com/foggy-projects/foggy-data-mcp-bridge/releases/download/foggy-runtime-launcher-v0.1.22/README-foggy-runtime-launcher.md",
+          "sha256": "43711229b425f13fa242d58916ef17cbd3dcebe4fc18b951aa9bf4befc056c26"
         },
         {
           "file": "runtime-launcher-manifest.json",
-          "url": "https://github.com/foggy-projects/foggy-data-mcp-bridge/releases/download/foggy-runtime-launcher-v0.1.21/runtime-launcher-manifest.json",
-          "sha256": "1591804035bbf589912907195c74746bf97edff3b9e6ebd7d569ecc0e5aebed7"
+          "url": "https://github.com/foggy-projects/foggy-data-mcp-bridge/releases/download/foggy-runtime-launcher-v0.1.22/runtime-launcher-manifest.json",
+          "sha256": "2b9efb82e8f954f2407f36ae419984068d384e1e0b86796ccfad0981dc7b2a30"
         },
         {
           "file": "SHA256SUMS",
-          "url": "https://github.com/foggy-projects/foggy-data-mcp-bridge/releases/download/foggy-runtime-launcher-v0.1.21/SHA256SUMS",
-          "sha256": "6e03f8861176d73be22c4c7c6f6345a68e49aacfb5375cd5cf2c54f1dc4cbe5d"
+          "url": "https://github.com/foggy-projects/foggy-data-mcp-bridge/releases/download/foggy-runtime-launcher-v0.1.22/SHA256SUMS",
+          "sha256": "51dc530e275bc1c9e9c73e9fce13d236fd0c5e3bfcebd9b03b837c5bc05e59f8"
         }
       ]
     },

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,