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

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.1` 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,31 @@ 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.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.
 
-For the DSH 0.1.5-rc.2 compatibility pre-release, install the exact candidate
+For the DSH 0.1.7-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
+dsh plugin --profile web add --workspace-root @foggy-projects/deepseek-harness-plugin@0.4.2-rc.1
 ```
 
-The published candidate is also available through the dedicated `dsh015` npm
+The published candidate is also available through the dedicated `dsh017` npm
 dist-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 +55,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>"
@@ -128,7 +132,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.1.md`](./docs/RELEASE-CANDIDATE-0.4.2-DSH-0.1.7-RC.1.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/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.

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.1"
 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/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.1",
   "description": "Foggy Java data analysis engine integration for DeepSeek Harness",
   "keywords": [
     "deepseek-harness",
@@ -40,6 +40,7 @@
     "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.1.md",
     "docs/COMMUNITY-MARKETPLACES.md",
     "docs/WINDOWS-BETA-ACCEPTANCE.md",
     "THIRD-PARTY-RUNTIME-NOTICES.md",
@@ -68,12 +69,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/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.1",
+  "validatedAt": "2026-09-25",
   "components": {
     "deepseekHarness": {
-      "version": "0.1.5-rc.2",
+      "version": "0.1.7-rc.2",
       "minimumNodeVersion": "24.0.0"
     },
     "python": {