@foggy-projects/deepseek-harness-plugin 0.4.0-beta.15 → 0.4.0-beta.16

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.15.tgz
+dsh plugin --profile web add --workspace-root ./foggy-projects-deepseek-harness-plugin-0.4.0-beta.16.tgz
 ```
 
 Restart `dsh web`, use the browser it opens (or the complete printed URL,

package/docs/PUBLIC-BETA-READINESS.md

@@ -1,10 +1,10 @@
-# Public beta readiness: 0.4.0-beta.15
+# Public beta readiness: 0.4.0-beta.16
 
-Assessment date: 2026-09-04
+Assessment date: 2026-09-05
 
 ## Verdict
 
-`0.4.0-beta.15` is suitable for a scoped public beta on Windows 10/11 x64 and
+`0.4.0-beta.16` 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
@@ -40,8 +40,10 @@ system PATH, registry, or a user's existing Python installation.
   inspected a SQLite datasource containing one table. Runtime retained the same
   PID, while the persisted onboarding state and command evidence contained no
   copy of the synthetic password.
-- 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.15 as installed.
+- The package and settings contract report Python 3.12.13 as `Foggy private`,
+  CLI 0.1.23, Launcher 0.1.18, analysis Skill 0.1.17, and onboarding Skill
+  0.4.0-beta.16; the same component display was accepted in the preceding
+  native Windows beta run.
 - Runtime startup now reports the current phase, elapsed/timeout seconds, and a
   bounded progress value. A real Windows launch with Temurin 17 reached readiness
   and passed capabilities in 18.9 seconds. A controlled post-launch Java exit was
@@ -61,10 +63,14 @@ system PATH, registry, or a user's existing Python installation.
   downloaded artifacts are not trusted until the complete SHA256 matches.
 - Windows progress writes tolerate transient sharing violations without losing
   the previous valid progress document or leaving temporary files behind.
-- Current automated regression passes 20 Node tests and 20 Python tests. The
+- Current automated regression passes 20 Node tests and 23 Python tests. The
   new datasource tests cover secret-free persisted state, direct Runtime API
-  submission, CLI bypass for inline development credentials, and output
-  redaction.
+  submission, CLI bypass for inline development credentials, stable inline
+  credential resumption, bounded transient connection retry, and output redaction.
+- A real Java 17 / Launcher 0.1.18 regression resumed the same completed inline
+  datasource composite twice, retained the Runtime PID, and emitted a complete
+  `01` through `06` workspace evidence sequence without falling back to granular
+  commands.
 
 ## Beta boundaries
 

package/docs/WINDOWS-BETA-ACCEPTANCE.md

@@ -1,7 +1,7 @@
 # Native Windows Beta acceptance
 
 This runbook validates DeepSeek Harness `0.1.2-rc.1` with Foggy plugin
-`0.4.0-beta.15` on a clean 64-bit Windows 10 or Windows 11 machine. Use a local
+`0.4.0-beta.16` on a clean 64-bit Windows 10 or Windows 11 machine. Use a local
 directory that is not synchronized by OneDrive.
 
 ## Prerequisites
@@ -54,7 +54,7 @@ Expected component state:
 - CLI 0.1.23;
 - Launcher 0.1.18;
 - analysis Skill 0.1.17;
-- onboarding Skill 0.4.0-beta.15;
+- onboarding Skill 0.4.0-beta.16;
 - Java 17+ available;
 - native DSH Skill registration available.
 

package/experience/linux/prepare.sh

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@foggy-projects/deepseek-harness-plugin",
-  "version": "0.4.0-beta.15",
+  "version": "0.4.0-beta.16",
   "description": "Foggy Java data analysis engine integration for DeepSeek Harness",
   "type": "module",
   "main": "./lib/index.js",

package/skills/foggy-deepseek-onboarding/SKILL.md

@@ -62,6 +62,16 @@ are authoritative; do not copy the Skill into the current workspace.
 7. When the model works, recommend committing the model directory to the user's own Git repository.
    Do not initialize a repository, commit, push, or create a remote unless the user requests it.
 
+For a normal end-to-end request, take the documented composite-command path first. Do not inspect
+`onboarding.py`, enumerate CLI help, search installation directories, load the sales-drop example, or
+fetch online syntax documentation before trying that path. Use those troubleshooting or reference
+sources only when a concrete error or unsupported modeling requirement makes them relevant.
+
+Use the user's business terms to narrow schema discovery with `--pattern` or repeated `--table` when
+there are clear candidates. Otherwise keep the bounded default, then inspect only the few tables and
+columns needed for the requested model. Full results belong in the evidence files; retain concise
+summaries and paths in the conversation instead of repeatedly reading complete JSON artifacts.
+
 Read [references/onboarding-workflow.md](references/onboarding-workflow.md) for the wrapper commands and
 credential shapes. Use `foggy-ai-analysis` references for detailed TM/QM modeling and query tuning.
 

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

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

package/skills/foggy-deepseek-onboarding/references/onboarding-workflow.md

@@ -73,6 +73,14 @@ tables list -> bounded schema inspection
 
 It does not stop or restart Runtime. Repeated calls reuse completed checkpoints when the public
 connection contract is unchanged. Inline password values are excluded from the comparison.
+Transient connection-pool readiness timeouts are retried a small, bounded number of times; invalid
+credentials, invalid URLs, and other configuration errors fail immediately.
+
+When the user's request clearly identifies a business subject or likely tables, add `--pattern` or
+one or more `--table` arguments so discovery remains focused. Do not enumerate CLI help, inspect the
+wrapper source, load unrelated examples, or fetch online documentation on the successful normal path.
+Keep full command payloads in the numbered evidence files and use only their concise result fields in
+the conversation.
 
 After discovery, use `foggy-ai-analysis` to create TM/QM drafts from actual tables, columns, keys,
 small read-only samples when useful, and the user's business questions. Keep the files in the current

package/skills/foggy-deepseek-onboarding/scripts/invoke-onboarding.ps1

@@ -26,5 +26,7 @@ if (-not $pythonCommand -or -not (Test-Path -LiteralPath $pythonCommand)) {
     exit 1
 }
 
+$env:PYTHONUTF8 = '1'
+$env:PYTHONIOENCODING = 'utf-8'
 & $pythonCommand (Join-Path $PSScriptRoot 'onboarding.py') @OnboardingArgs
 exit $LASTEXITCODE

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

@@ -993,12 +993,15 @@ def validate_connection(payload: dict) -> dict:
 def persisted_connection(connection: dict) -> dict:
     """Return the resumable connection contract without an inline development password."""
     persisted = {key: value for key, value in connection.items() if key != "password"}
-    persisted["credentialMode"] = (
-        "inline-development" if connection.get("password") is not None
-        else "agent-environment" if connection.get("passwordEnv")
-        else "opaque-profile" if connection.get("connectionMode") == "opaque-profile"
-        else "none"
-    )
+    credential_mode = connection.get("credentialMode")
+    if credential_mode not in {"inline-development", "agent-environment", "opaque-profile", "none"}:
+        credential_mode = (
+            "inline-development" if connection.get("password") is not None
+            else "agent-environment" if connection.get("passwordEnv")
+            else "opaque-profile" if connection.get("connectionMode") == "opaque-profile"
+            else "none"
+        )
+    persisted["credentialMode"] = credential_mode
     return persisted
 
 
@@ -1797,6 +1800,50 @@ def cli_json(install_state: dict, runtime_state: dict, namespace: str, command:
     return payload
 
 
+TRANSIENT_DATASOURCE_TEST_MARKERS = (
+    "connection is not available",
+    "connection pool",
+    "request timed out",
+    "timeout waiting for connection",
+)
+
+
+def datasource_test_with_retry(
+    install_state: dict,
+    runtime_state: dict,
+    namespace: str,
+    datasource_name: str,
+    *,
+    attempts: int = 3,
+    initial_delay_seconds: float = 1.0,
+) -> dict:
+    """Retry only transient pool/readiness failures; authentication and configuration failures fail fast."""
+    for attempt in range(1, attempts + 1):
+        try:
+            result = cli_json(
+                install_state,
+                runtime_state,
+                namespace,
+                ["datasources", "test", datasource_name],
+                "datasources test",
+            )
+            if attempt > 1:
+                result = {
+                    **result,
+                    "onboardingRetry": {
+                        "attempts": attempt,
+                        "reason": "transient-datasource-readiness",
+                    },
+                }
+            return result
+        except OnboardingError as exc:
+            transient = any(marker in str(exc).lower() for marker in TRANSIENT_DATASOURCE_TEST_MARKERS)
+            if not transient or attempt == attempts:
+                raise
+            time.sleep(initial_delay_seconds * attempt)
+    raise AssertionError("unreachable")
+
+
 def runtime_api_json(
     runtime_state: dict,
     namespace: str,
@@ -2092,9 +2139,8 @@ def datasource_verify_command(args: argparse.Namespace) -> dict:
         raise OnboardingError("Datasource is not configured; run datasource-configure --apply first")
     connection = state["connection"]
     namespace = connection["namespace"]
-    tested = redact_connection_material(cli_json(
-        install_state, runtime_state, namespace,
-        ["datasources", "test", connection["name"]], "datasources test",
+    tested = redact_connection_material(datasource_test_with_retry(
+        install_state, runtime_state, namespace, connection["name"],
     ))
     if not args.bind:
         mark_step(state, "datasourceVerified", "waiting-for-binding", connectionTested=True)
@@ -3425,6 +3471,10 @@ def build_parser() -> argparse.ArgumentParser:
 
 
 def main() -> None:
+    for stream in (sys.stdout, sys.stderr):
+        reconfigure = getattr(stream, "reconfigure", None)
+        if callable(reconfigure):
+            reconfigure(encoding="utf-8", errors="replace")
     args = build_parser().parse_args()
     try:
         result = args.handler(args)