dsh-harbor-evolution 0.3.0 → 0.3.1

package/README.md

@@ -9,7 +9,7 @@ The package gives DSH four deterministic Harbor tools and bundles the model- and
 Requirements: Docker, Node.js 22+, pnpm, and [uv](https://docs.astral.sh/uv/). Run this from the business Agent workspace:
 
 ```bash
-npx dsh-harbor-evolution@0.3.0 setup --project-root "$PWD"
+npx --yes dsh-harbor-evolution@latest setup --project-root "$PWD"
 ```
 
 The setup command installs both required runtimes:
@@ -22,7 +22,7 @@ It then stores the absolute Harbor executable paths and `projectRoot` in the pro
 The default profile is `web`. Use `--profile headless` only when that is the profile you actually run. See all options with:
 
 ```bash
-npx dsh-harbor-evolution@0.3.0 setup --help
+npx --yes dsh-harbor-evolution@latest setup --help
 ```
 
 Stop any old DSH process and run the exact restart command printed by setup. Then invoke:
@@ -60,9 +60,11 @@ Keep `pythonPath` empty for the published Python package. `candidatePath`, `data
 For source development from the repository:
 
 ```bash
-./hse dsh-install web
+./hse dsh-install-source web
 ```
 
+Do not use `dsh plugin add ./packages/dsh-plugin` directly from a fresh checkout. pnpm records a `link:` dependency, and Node resolves imports from the real checkout path. The source installer first runs the package's locked `npm ci`, then links it and installs the local Python Adapter. Normal users should always use the registry-backed setup command above.
+
 See the [complete DSH Web quickstart](https://github.com/istarwyh/harbor-self-evolving/blob/main/docs/dsh-web-quickstart.md) for UI verification, first evaluation, Candidate comparison, and troubleshooting.
 
 The Plugin never deploys a Candidate or mutates the active Champion. Existing CI/CD remains responsible for building, deploying, and promoting the exact evaluated artifact.

package/lib/setup.js

@@ -2,6 +2,7 @@ import { mkdir, readFile, rename, stat, writeFile } from 'node:fs/promises'
 import os from 'node:os'
 import path from 'node:path'
 import process from 'node:process'
+import { fileURLToPath } from 'node:url'
 
 import { runProcess } from './process.js'
 
@@ -94,6 +95,26 @@ export function resolveSetupOptions(raw = {}, environment = {}) {
   }
 }
 
+export async function resolveLocalPluginDirectory(pluginSpec, cwd = process.cwd()) {
+  let candidate
+  if (pluginSpec.startsWith('file://')) candidate = fileURLToPath(pluginSpec)
+  else if (pluginSpec.startsWith('file:')) candidate = path.resolve(cwd, pluginSpec.slice(5))
+  else if (!pluginSpec.startsWith('github:') && !pluginSpec.startsWith('git+')) {
+    candidate = path.resolve(cwd, pluginSpec)
+  }
+  if (!candidate) return undefined
+
+  try {
+    const details = await stat(candidate)
+    if (!details.isDirectory()) return undefined
+    const manifest = JSON.parse(await readFile(path.join(candidate, 'package.json'), 'utf8'))
+    return manifest.name === 'dsh-harbor-evolution' ? candidate : undefined
+  } catch (error) {
+    if (error.code === 'ENOENT' || error instanceof SyntaxError) return undefined
+    throw error
+  }
+}
+
 function quoted(value) {
   return JSON.stringify(value)
 }
@@ -215,6 +236,19 @@ export async function setupIntegration(raw = {}, dependencies = {}) {
     warnings.push(`Docker is not ready; installation can finish, but Harbor Jobs will fail until it is available. ${processFailure(error)}`)
   }
 
+  const localPluginDir = await resolveLocalPluginDirectory(
+    config.pluginSpec,
+    dependencies.cwd ?? process.cwd(),
+  )
+  if (localPluginDir) {
+    progress('Preparing dependencies for the linked DSH plugin checkout...')
+    await requireCommand(run, 'npm')
+    // Node resolves a symlinked package from its real checkout path. Install
+    // the complete locked graph there so runtime dependencies and host peers
+    // do not disappear behind the profile's `link:` entry.
+    await run('npm', ['ci', '--ignore-scripts'], { cwd: localPluginDir })
+  }
+
   progress('2/4 Installing the Harbor Python runtime...')
   await mkdir(config.runtimeDir, { recursive: true })
   await run('uv', ['venv', '--python', '3.12', '--allow-existing', config.venvDir])
@@ -229,7 +263,7 @@ export async function setupIntegration(raw = {}, dependencies = {}) {
   try {
     await run('pnpm', [
       '--silent', 'dlx', `@deepseek-ai/dsh@${DSH_VERSION}`,
-      'plugin', '--profile', config.profile, 'add', '-w', config.pluginSpec,
+      'plugin', '--profile', config.profile, 'add', '-w', '--save-exact', config.pluginSpec,
     ], { env: { ...env, DSH_HOME: config.dshHome } })
   } catch (error) {
     throw new Error(processFailure(error))
@@ -246,6 +280,7 @@ export async function setupIntegration(raw = {}, dependencies = {}) {
 
   return {
     ...config,
+    localPluginDir,
     patchChanged,
     harborVersion: harborVersion.stdout.trim() || harborVersion.stderr.trim(),
     warnings,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-harbor-evolution",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "DeepSeek Harness plugin and bundled Skill for safely evolving Cordis Candidates with Harbor.",
   "type": "module",
   "main": "index.js",