@foggy-projects/deepseek-harness-plugin 0.4.0-beta.8 → 0.4.0-beta.9

package/README.md

@@ -14,7 +14,7 @@ modify `PATH`, or register Python globally. Advanced users may explicitly set
 ## Local beta installation
 
 ```powershell
-dsh plugin --profile web add --workspace-root ./foggy-projects-deepseek-harness-plugin-0.4.0-beta.8.tgz
+dsh plugin --profile web add --workspace-root ./foggy-projects-deepseek-harness-plugin-0.4.0-beta.9.tgz
 ```
 
 Restart `dsh web`, open Settings → Plugins → Foggy Data Analysis, and initialize

package/docs/PUBLIC-BETA-READINESS.md

@@ -1,10 +1,10 @@
-# Public beta readiness: 0.4.0-beta.8
+# Public beta readiness: 0.4.0-beta.9
 
-Assessment date: 2026-09-03
+Assessment date: 2026-09-04
 
 ## Verdict
 
-`0.4.0-beta.8` is suitable for a scoped public beta on Windows 10/11 x64 and
+`0.4.0-beta.9` is suitable for a scoped public beta on Windows 10/11 x64 and
 Linux/WSL2 x64. It is not a general-availability release.
 
 The plugin package stays small and downloads large components only during
@@ -23,10 +23,12 @@ system PATH, registry, or a user's existing Python installation.
 - Linux/WSL2 x64 completed managed Python extraction, initialization, and a live
   DeepSeek Harness `0.1.1-rc.2` UI status check.
 - The UI reported Python 3.12.13 as `Foggy private`, and CLI 0.1.23, Launcher
-  0.1.18, analysis Skill 0.1.17, and onboarding Skill 0.4.0-beta.8 as installed.
+  0.1.18, analysis Skill 0.1.17, and onboarding Skill 0.4.0-beta.9 as installed.
 - Interrupted downloads resume with HTTP Range when the server supports it;
   downloaded artifacts are not trusted until the complete SHA256 matches.
-- Automated regression passed under Node 22.23.2: 15 Node tests and 8 Python
+- Windows progress writes tolerate transient sharing violations without losing
+  the previous valid progress document or leaving temporary files behind.
+- Automated regression passed under Node 22.23.2: 17 Node tests and 10 Python
   tests, plus shell and PowerShell syntax checks.
 
 ## Beta boundaries

package/docs/WINDOWS-BETA-ACCEPTANCE.md

@@ -1,7 +1,7 @@
 # Native Windows Beta acceptance
 
 This runbook validates DeepSeek Harness `0.1.1-rc.2` with Foggy plugin
-`0.4.0-beta.8` on a clean 64-bit Windows 10 or Windows 11 machine. Use a local
+`0.4.0-beta.9` on a clean 64-bit Windows 10 or Windows 11 machine. Use a local
 directory that is not synchronized by OneDrive.
 
 ## Prerequisites
@@ -44,7 +44,7 @@ Expected component state:
 - CLI 0.1.23;
 - Launcher 0.1.18;
 - analysis Skill 0.1.17;
-- onboarding Skill 0.4.0-beta.8;
+- onboarding Skill 0.4.0-beta.9;
 - Java 17+ available;
 - native DSH Skill registration available.
 
@@ -68,4 +68,3 @@ Pass only when Runtime readiness and capabilities succeed, datasource metadata
 can be discovered, TM/QM models validate and publish, the bounded read-only
 query succeeds, diagnostics contain no credentials, and stopping Runtime frees
 port 18066.
-

package/experience/linux/prepare.sh

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

package/lib/atomic-json.js

@@ -0,0 +1,41 @@
+import { randomUUID } from 'node:crypto'
+import { mkdir, rename, rm, writeFile } from 'node:fs/promises'
+import { dirname } from 'node:path'
+
+const TRANSIENT_REPLACE_CODES = new Set(['EACCES', 'EBUSY', 'EPERM'])
+const TRANSIENT_WINERRORS = new Set([5, 32, 33])
+
+function wait(milliseconds) {
+  return new Promise((resolve) => setTimeout(resolve, milliseconds))
+}
+
+function transientReplaceError(error) {
+  return TRANSIENT_REPLACE_CODES.has(error?.code) || TRANSIENT_WINERRORS.has(error?.winerror)
+}
+
+export async function replaceWithRetry(source, destination, {
+  replace = rename,
+  sleep = wait,
+  attempts = 12,
+} = {}) {
+  for (let attempt = 0; attempt < attempts; attempt += 1) {
+    try {
+      await replace(source, destination)
+      return
+    } catch (error) {
+      if (!transientReplaceError(error) || attempt === attempts - 1) throw error
+      await sleep(Math.min(25 * (2 ** attempt), 400))
+    }
+  }
+}
+
+export async function writeJsonAtomic(path, payload, options = {}) {
+  await mkdir(dirname(path), { recursive: true })
+  const temporary = `${path}.${process.pid}.${randomUUID()}.tmp`
+  try {
+    await writeFile(temporary, `${JSON.stringify(payload, null, 2)}\n`, { encoding: 'utf8', mode: 0o600 })
+    await replaceWithRetry(temporary, path, options)
+  } finally {
+    await rm(temporary, { force: true })
+  }
+}

package/lib/index.js

@@ -1,11 +1,12 @@
 import { execFile } from 'node:child_process'
-import { access, mkdir, readFile, rename, writeFile } from 'node:fs/promises'
+import { access, mkdir, readFile, writeFile } from 'node:fs/promises'
 import { constants as fsConstants } from 'node:fs'
 import { dirname, join, delimiter } from 'node:path'
 import { fileURLToPath } from 'node:url'
 import { promisify } from 'node:util'
 import { Remote, TypertRemoteService } from '@deepseek-ai/dsh-typert-protocol'
 import { createFoggySkillProvider } from './skill-provider.js'
+import { writeJsonAtomic } from './atomic-json.js'
 import { ensurePythonRuntime, probePythonRuntime } from './python-runtime.js'
 import { compatible, compatibleNode } from './version.js'
 
@@ -128,13 +129,6 @@ async function assertSystemPrerequisites(kind) {
   }
 }
 
-async function writeJsonAtomic(path, payload) {
-  await mkdir(dirname(path), { recursive: true })
-  const temporary = `${path}.${process.pid}.${Date.now()}.tmp`
-  await writeFile(temporary, `${JSON.stringify(payload, null, 2)}\n`, { encoding: 'utf8', mode: 0o600 })
-  await rename(temporary, path)
-}
-
 function createPythonProgressReporter(operation, path) {
   let pending = Promise.resolve()
   return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@foggy-projects/deepseek-harness-plugin",
-  "version": "0.4.0-beta.8",
+  "version": "0.4.0-beta.9",
   "description": "Foggy Java data analysis engine integration for DeepSeek Harness",
   "type": "module",
   "main": "./lib/index.js",
@@ -57,7 +57,7 @@
     "@deepseek-ai/dsh-typert-protocol": "^0.1.1-rc.2"
   },
   "scripts": {
-    "check": "node --check lib/index.js && node --check lib/python-runtime.js && node --check lib/skill-provider.js && node --check lib/client.js && node --check lib/typert.js && node --check lib/remote.js",
+    "check": "node --check lib/index.js && node --check lib/atomic-json.js && node --check lib/python-runtime.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 && python test/onboarding_unit.py"
   }
 }

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

@@ -1,6 +1,6 @@
 {
   "schemaVersion": "foggy-deepseek-onboarding-versions/v1",
-  "packageVersion": "0.4.0-beta.8",
+  "packageVersion": "0.4.0-beta.9",
   "validatedAt": "2026-09-03",
   "components": {
     "deepseekHarness": {

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

@@ -5,6 +5,7 @@ from __future__ import annotations
 
 import argparse
 import datetime as dt
+import errno
 import hashlib
 import json
 import os
@@ -337,11 +338,39 @@ def venv_cli(install_root: Path) -> Path:
     return install_root / "venv" / ("Scripts/foggy-runtime.exe" if os.name == "nt" else "bin/foggy-runtime")
 
 
+def replace_with_retry(source: Path, destination: Path, attempts: int = 12) -> None:
+    transient_errno = {errno.EACCES, errno.EBUSY, errno.EPERM}
+    transient_winerror = {5, 32, 33}
+    for attempt in range(attempts):
+        try:
+            os.replace(source, destination)
+            return
+        except OSError as exc:
+            transient = exc.errno in transient_errno or getattr(exc, "winerror", None) in transient_winerror
+            if not transient or attempt == attempts - 1:
+                raise
+            time.sleep(min(0.025 * (2 ** attempt), 0.4))
+
+
 def atomic_json(path: Path, payload: dict) -> None:
     path.parent.mkdir(parents=True, exist_ok=True)
-    temporary = path.with_name(path.name + ".tmp")
-    temporary.write_text(json.dumps(payload, indent=2, ensure_ascii=False), encoding="utf-8")
-    os.replace(temporary, path)
+    handle = tempfile.NamedTemporaryFile(
+        mode="w",
+        encoding="utf-8",
+        dir=path.parent,
+        prefix=f".{path.name}.",
+        suffix=".tmp",
+        delete=False,
+    )
+    temporary = Path(handle.name)
+    try:
+        with handle:
+            json.dump(payload, handle, indent=2, ensure_ascii=False)
+            handle.flush()
+            os.fsync(handle.fileno())
+        replace_with_retry(temporary, path)
+    finally:
+        temporary.unlink(missing_ok=True)
 
 
 def skill_tree_digest(root: Path) -> str: