@ran-sh/dsh-crew 0.5.1 → 0.5.2

package/src/runtime-identity.mjs

@@ -8,7 +8,7 @@
 // Keep this module pure and dependency-free so Hub, MCP and tests all use the
 // exact same compatibility rules.
 
-export const RUNTIME_VERSION = '0.5.1';
+export const RUNTIME_VERSION = '0.5.2';
 export const HUB_PROTOCOL_VERSION = 1;
 
 export const HUB_CAPABILITIES = Object.freeze([

package/windows/start-dsh-crew.cmd

@@ -0,0 +1,55 @@
+@echo off
+setlocal EnableExtensions
+title DSH Crew Launcher
+
+set "CREW_HOME=%USERPROFILE%\.config\dsh-crew\harness"
+set "OFFICIAL_HOME=%USERPROFILE%\.dsh"
+set "DSH_CLI=%CREW_HOME%\runtime\node_modules\.bin\dsh.cmd"
+set "CREW_URL=http://127.0.0.1:3210"
+set "UI_URL=http://127.0.0.1:3080"
+set "LAUNCH_LOG=%TEMP%\dsh-crew-launcher.log"
+
+if not exist "%DSH_CLI%" goto :not_installed
+if not exist "%CREW_HOME%\profiles\dsh-crew\package.json" goto :not_installed
+if not exist "%OFFICIAL_HOME%\profiles\web\package.json" goto :official_missing
+
+call :ensure_service 3210 dsh-crew "%CREW_HOME%" "%CREW_URL%"
+if errorlevel 1 goto :failed
+call :ensure_service 3080 web "%OFFICIAL_HOME%" "%UI_URL%"
+if errorlevel 1 goto :failed
+exit /b 0
+
+:ensure_service
+set "LAUNCH_PORT=%~1"
+set "LAUNCH_PROFILE=%~2"
+set "LAUNCH_HOME=%~3"
+set "LAUNCH_URL=%~4"
+
+call :health_check "%LAUNCH_URL%"
+if not errorlevel 1 exit /b 0
+
+powershell.exe -NoLogo -NoProfile -NonInteractive -Command "$listener=Get-NetTCPConnection -State Listen -LocalPort $env:LAUNCH_PORT -ErrorAction SilentlyContinue; if ($listener) { exit 0 } else { exit 1 }" >nul 2>&1
+if not errorlevel 1 exit /b 1
+
+powershell.exe -NoLogo -NoProfile -NonInteractive -WindowStyle Hidden -Command "try { $env:DSH_HOME=$env:LAUNCH_HOME; Start-Process -FilePath $env:DSH_CLI -ArgumentList @('--profile',$env:LAUNCH_PROFILE,'--host','127.0.0.1','--port',$env:LAUNCH_PORT,'--no-open') -WindowStyle Hidden -ErrorAction Stop } catch { ('['+(Get-Date -Format s)+'] Failed to start '+$env:LAUNCH_PROFILE+': '+$_.Exception.Message) | Add-Content -LiteralPath $env:LAUNCH_LOG; exit 1 }" >nul 2>&1
+if errorlevel 1 exit /b 1
+
+powershell.exe -NoLogo -NoProfile -NonInteractive -Command "$lastError=$null; $deadline=(Get-Date).AddSeconds(90); do { try { $r=Invoke-RestMethod -Uri ($env:LAUNCH_URL+'/_dsh/dsh-crew/extension') -TimeoutSec 2; if ($r.ok -eq $true -and $r.extension.runtime.runtime_version) { exit 0 } } catch { $lastError=$_.Exception.Message }; Start-Sleep -Milliseconds 500 } while ((Get-Date) -lt $deadline); if (-not $lastError) { $lastError='No healthy response before the startup deadline.' }; ('['+(Get-Date -Format s)+'] '+$env:LAUNCH_PROFILE+' health check failed: '+$lastError) | Add-Content -LiteralPath $env:LAUNCH_LOG; exit 1" >nul 2>&1
+exit /b %ERRORLEVEL%
+
+:health_check
+set "HEALTH_URL=%~1"
+powershell.exe -NoLogo -NoProfile -NonInteractive -Command "try { $r=Invoke-RestMethod -Uri ($env:HEALTH_URL+'/_dsh/dsh-crew/extension') -TimeoutSec 2; if ($r.ok -eq $true -and $r.extension.runtime.runtime_version) { exit 0 } } catch {}; exit 1" >nul 2>&1
+exit /b %ERRORLEVEL%
+
+:not_installed
+echo [%date% %time%] DSH Crew is not installed completely.>>"%LAUNCH_LOG%"
+exit /b 1
+
+:official_missing
+echo [%date% %time%] Official DeepSeek Harness web profile was not found.>>"%LAUNCH_LOG%"
+exit /b 1
+
+:failed
+echo [%date% %time%] DSH Crew startup failed.>>"%LAUNCH_LOG%"
+exit /b 1

package/windows/start-dsh-crew.vbs

@@ -0,0 +1,9 @@
+Option Explicit
+
+Dim shell, launcher, command
+Set shell = CreateObject("WScript.Shell")
+launcher = "__LAUNCHER__"
+command = shell.ExpandEnvironmentStrings("%COMSPEC%") & " /d /c " & _
+  Chr(34) & Chr(34) & launcher & Chr(34) & Chr(34)
+
+shell.Run command, 0, False

package/zcode/AGENTS.md

@@ -0,0 +1,21 @@
+# Global capability-aware delegation policy for ZCode
+
+ZCode is a host adapter for DSH Crew. Use the `dsh-crew` MCP server for Crew
+work only after its live capability and readiness surfaces have been checked.
+
+- Discover the current Crew configuration, capabilities, activation state and
+  readiness before delegating substantial work. Installed, configured, enabled
+  and callable are different states; do not infer one from another.
+- Match a bounded work unit to an available Crew role/model and preserve the
+  repository/worktree and Result Contract boundaries. Keep planning, ambiguous
+  requirements, integration, external side effects and final communication in
+  the host agent.
+- If Crew is selected and any required capability is unavailable, non-callable,
+  or returns an unknown/runtime/configuration/credential/routing/timeout error,
+  pause. Report the evidence and wait for the operator to choose repair Crew or
+  continue locally; never silently fall back or retry blindly.
+- Validate returned evidence, changed scope, tests and completion state before
+  accepting delegated work. Do not expose credentials or raw provider payloads.
+
+This file is installed as a managed block in `~/.zcode/AGENTS.md`; user-authored
+instructions outside the block are preserved.

package/zcode/agents/ds-reviewer.md

@@ -0,0 +1,19 @@
+---
+name: ds-reviewer
+description: Independent DSH Crew reviewer dispatcher. Inspect completed changes read-only and return a structured verdict.
+mcpServers:
+  - dsh-crew
+tools:
+  - mcp__dsh-crew__dsh_run_worker
+  - mcp__dsh-crew__dsh_worker_status
+  - mcp__dsh-crew__dsh_worker_result
+  - mcp__dsh-crew__dsh_worker_cancel
+  - mcp__dsh-crew__dsh_worker_config
+---
+
+You are a thin, read-only dispatcher. Never edit files or implement fixes.
+
+Pass the review request verbatim to `dsh_run_worker` with role `reviewer` and
+the current workspace as `cwd`; omit effort unless explicitly requested. Wait
+for the result and return its Review Findings, Evidence, Risks and Verdict.
+Treat failing tests or incomplete evidence as not approved.

package/zcode/agents/ds-worker.md

@@ -0,0 +1,20 @@
+---
+name: ds-worker
+description: DSH Crew worker dispatcher for implementation, fixes, tests, search and analysis. Never implement locally; return the auditable Crew result.
+mcpServers:
+  - dsh-crew
+tools:
+  - mcp__dsh-crew__dsh_run_worker
+  - mcp__dsh-crew__dsh_spawn_worker
+  - mcp__dsh-crew__dsh_worker_status
+  - mcp__dsh-crew__dsh_worker_result
+  - mcp__dsh-crew__dsh_worker_cancel
+  - mcp__dsh-crew__dsh_worker_config
+---
+
+You are a thin dispatcher. You never do the task yourself.
+
+Pass the task verbatim to `dsh_run_worker` with role `worker` and the current
+workspace as `cwd`; omit effort unless the task explicitly requests it. Wait
+for the result. If it is `done`, return the result and its evidence footer. If
+it is not done, report the error and stop reason clearly and stop.

package/zcode/commands/dsh-config.md

@@ -0,0 +1,6 @@
+Parse arguments after this command as key=value pairs and call the
+`dsh_worker_config` tool. Supported keys include enabled, tier, effort, mode,
+timeout, policy, escalate, collab, main, flash, pro, review and reset. With no
+arguments read the current configuration. Show one compact table including
+hub_reachable, effective flash/pro state, effective policy and routing guidance.
+Name changed fields. Reply in the user's language and do nothing else.

package/zcode/commands/dsh-status.md

@@ -0,0 +1,4 @@
+Call the `dsh_worker_status` tool and show one compact table with job id,
+tier/effort, status and current tool, progress, tokens and task summary. If
+there are no jobs, say so in one line. Reply in the user's language and do
+nothing else.