dsh-harbor-evolution 0.3.0 → 0.4.0

package/lib/dashboard.js

@@ -0,0 +1,143 @@
+import { access, constants, readdir, readFile, stat } from 'node:fs/promises'
+import path from 'node:path'
+
+import { resolveWithin } from './evolution.js'
+
+const SUMMARY_NAME = 'evaluation-summary.json'
+const PROMOTION_NAME = 'promotion-report.json'
+const MAX_JOBS = 50
+
+async function readJson(file) {
+  try {
+    return JSON.parse(await readFile(file, 'utf8'))
+  } catch (error) {
+    if (error.code === 'ENOENT') return undefined
+    if (error instanceof SyntaxError) return { __readError: `invalid JSON in ${path.basename(file)}` }
+    throw error
+  }
+}
+
+async function directoryCheck(directory, { optional = false } = {}) {
+  try {
+    const details = await stat(directory)
+    if (!details.isDirectory()) return { status: 'error', detail: 'not a directory' }
+    await access(directory, constants.R_OK)
+    return { status: 'ok', detail: 'readable' }
+  } catch (error) {
+    if (optional && error.code === 'ENOENT') return { status: 'warning', detail: 'not created yet' }
+    return { status: 'error', detail: error.code === 'ENOENT' ? 'not found' : error.message }
+  }
+}
+
+async function executableCheck(command) {
+  if (!command) return { status: 'error', detail: 'not configured' }
+  if (!path.isAbsolute(command)) return { status: 'ok', detail: `${command} (resolved from PATH)` }
+  try {
+    await access(command, constants.X_OK)
+    return { status: 'ok', detail: command }
+  } catch (error) {
+    return { status: 'error', detail: error.code === 'ENOENT' ? `${command} not found` : error.message }
+  }
+}
+
+function jobStatus(summary) {
+  if (!summary) return 'pending'
+  if (summary.__readError) return 'failed'
+  const trials = Number(summary.n_trials ?? 0)
+  const exceptions = Number(summary.n_exceptions ?? 0)
+  if (trials > 0 && exceptions >= trials) return 'failed'
+  if (exceptions > 0) return 'partial'
+  return 'completed'
+}
+
+async function readJob(jobsDir, entry, details) {
+  const directory = path.join(jobsDir, entry.name)
+  const summary = await readJson(path.join(directory, SUMMARY_NAME))
+  const promotion = await readJson(path.join(directory, PROMOTION_NAME))
+  return {
+    name: entry.name,
+    path: directory,
+    updatedAt: details.mtime.toISOString(),
+    status: jobStatus(summary),
+    nTrials: Number(summary?.n_trials ?? 0),
+    nExceptions: Number(summary?.n_exceptions ?? 0),
+    metrics: summary?.metrics ?? {},
+    candidate: summary?.candidate ?? undefined,
+    evaluationContext: summary?.evaluation_context ?? undefined,
+    promotion: promotion ? {
+      decision: promotion.decision,
+      reasons: Array.isArray(promotion.reasons) ? promotion.reasons : [],
+      baselineJob: promotion.baseline_job,
+      candidateJob: promotion.candidate_job,
+    } : undefined,
+    readError: summary?.__readError,
+  }
+}
+
+async function listJobs(jobsDir) {
+  let entries
+  try {
+    entries = await readdir(jobsDir, { withFileTypes: true })
+  } catch (error) {
+    if (error.code === 'ENOENT') return []
+    throw error
+  }
+  const recent = await Promise.all(entries
+    .filter(entry => entry.isDirectory())
+    .map(async entry => ({ entry, details: await stat(path.join(jobsDir, entry.name)) })))
+  recent.sort((left, right) => right.details.mtimeMs - left.details.mtimeMs)
+  return Promise.all(recent
+    .slice(0, MAX_JOBS)
+    .map(({ entry, details }) => readJob(jobsDir, entry, details)))
+}
+
+function latestMetric(jobs) {
+  const completed = jobs.find(job => job.status === 'completed' || job.status === 'partial')
+  if (!completed) return undefined
+  const entry = Object.entries(completed.metrics).find(([, value]) => typeof value === 'number')
+  return entry ? { name: entry[0], value: entry[1] } : undefined
+}
+
+export async function readDashboardSnapshot(config, metadata = {}) {
+  const projectRoot = path.resolve(config.projectRoot)
+  const jobsDir = resolveWithin(projectRoot, config.jobsDir, 'jobsDir')
+  const [jobs, projectRootCheck, jobsDirCheck, harborCheck, harborDshCheck] = await Promise.all([
+    listJobs(jobsDir),
+    directoryCheck(projectRoot),
+    directoryCheck(jobsDir, { optional: true }),
+    executableCheck(config.harborBin),
+    executableCheck(config.harborDshBin),
+  ])
+
+  const counts = jobs.reduce((result, job) => {
+    result[job.status] = (result[job.status] ?? 0) + 1
+    return result
+  }, {})
+
+  return {
+    schemaVersion: 1,
+    generatedAt: new Date().toISOString(),
+    pluginVersion: metadata.pluginVersion ?? 'development',
+    config: {
+      projectRoot,
+      jobsDir,
+      dshVersion: config.dshVersion,
+      agentImportPath: config.agentImportPath,
+      pluginImportPath: config.pluginImportPath,
+    },
+    checks: {
+      projectRoot: projectRootCheck,
+      jobsDir: jobsDirCheck,
+      harbor: harborCheck,
+      harborDsh: harborDshCheck,
+    },
+    overview: {
+      totalJobs: jobs.length,
+      completedJobs: (counts.completed ?? 0) + (counts.partial ?? 0),
+      activeJobs: counts.pending ?? 0,
+      failedJobs: counts.failed ?? 0,
+      latestMetric: latestMetric(jobs),
+    },
+    jobs,
+  }
+}

package/lib/service.js

@@ -0,0 +1,30 @@
+import { readDashboardSnapshot } from './dashboard.js'
+import { compareCandidates, readEvaluation, runEvaluation, snapshot } from './evolution.js'
+
+/** One Host-side boundary shared by Agent tools and the Web dashboard. */
+export class EvolutionService {
+  constructor(config, metadata = {}) {
+    this.config = config
+    this.metadata = metadata
+  }
+
+  snapshot(args) {
+    return snapshot(this.config, args)
+  }
+
+  run(args) {
+    return runEvaluation(this.config, args)
+  }
+
+  result(args) {
+    return readEvaluation(this.config, args)
+  }
+
+  compare(args) {
+    return compareCandidates(this.config, args)
+  }
+
+  dashboard() {
+    return readDashboardSnapshot(this.config, this.metadata)
+  }
+}

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,23 @@ 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 })
+    // The browser half is generated from source and embeds its visual asset.
+    // Build explicitly because the locked install above intentionally skips
+    // lifecycle scripts for deterministic source-checkout setup.
+    await run('npm', ['run', 'build'], { 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 +267,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 +284,7 @@ export async function setupIntegration(raw = {}, dependencies = {}) {
 
   return {
     ...config,
+    localPluginDir,
     patchChanged,
     harborVersion: harborVersion.stdout.trim() || harborVersion.stderr.trim(),
     warnings,
@@ -275,7 +314,9 @@ export function renderSetupResult(result) {
     `cd ${shellQuote(result.projectRoot)}`,
     startCommand,
     '',
-    'Then invoke: /evolve-agent-with-harbor',
+    result.profile === 'web'
+      ? 'Open the Harbor tab, or invoke: /evolve-agent-with-harbor'
+      : 'Then invoke: /evolve-agent-with-harbor',
   )
   return lines.join('\n')
 }

package/lib/web.js

@@ -0,0 +1,63 @@
+export const DASHBOARD_ROUTE = '/_dsh/harbor-evolution/dashboard'
+
+function sendJson(response, status, body) {
+  response.writeHead(status, {
+    'cache-control': 'no-store',
+    'content-type': 'application/json; charset=utf-8',
+    'x-content-type-options': 'nosniff',
+  })
+  response.end(JSON.stringify(body))
+}
+
+export function isSameOriginRequest(request) {
+  const fetchSite = request.headers['sec-fetch-site']
+  if (fetchSite && fetchSite !== 'same-origin' && fetchSite !== 'none') return false
+  const origin = request.headers.origin
+  if (!origin) {
+    if (fetchSite === 'same-origin' || fetchSite === 'none') return true
+    const address = request.socket?.remoteAddress ?? ''
+    return address === '::1' || address === '127.0.0.1' || address.startsWith('127.')
+      || address.startsWith('::ffff:127.')
+  }
+  const host = request.headers.host
+  if (!host) return false
+  try {
+    const parsed = new URL(origin)
+    return (parsed.protocol === 'http:' || parsed.protocol === 'https:') && parsed.host === host
+  } catch {
+    return false
+  }
+}
+
+export function createDashboardHandler(service) {
+  return (request, response) => {
+    if (request.method !== 'GET') {
+      response.writeHead(405, { allow: 'GET' })
+      response.end()
+      return
+    }
+    if (!isSameOriginRequest(request)) {
+      sendJson(response, 403, { ok: false, error: { code: 'forbidden', message: 'same-origin request required' } })
+      return
+    }
+    Promise.resolve(service.dashboard()).then(
+      value => sendJson(response, 200, { ok: true, value }),
+      error => sendJson(response, 500, {
+        ok: false,
+        error: { code: 'dashboard-unavailable', message: error instanceof Error ? error.message : String(error) },
+      }),
+    )
+  }
+}
+
+/** Add the dashboard route only in profiles that provide the optional Web service. */
+export function installDashboardWeb(ctx, service) {
+  if (typeof ctx.inject !== 'function') return
+  ctx.inject(['webServer'], (webCtx) => {
+    webCtx.effect(() => webCtx.webServer.register({
+      kind: 'exact',
+      path: DASHBOARD_ROUTE,
+      handler: createDashboardHandler(service),
+    }), 'harbor-evolution: dashboard route')
+  })
+}

package/package.json

@@ -1,10 +1,14 @@
 {
   "name": "dsh-harbor-evolution",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "DeepSeek Harness plugin and bundled Skill for safely evolving Cordis Candidates with Harbor.",
   "type": "module",
   "main": "index.js",
-  "exports": "./index.js",
+  "exports": {
+    ".": "./index.js",
+    "./client": "./lib/client.js",
+    "./package.json": "./package.json"
+  },
   "bin": {
     "dsh-harbor": "bin/dsh-harbor.mjs"
   },
@@ -18,12 +22,24 @@
     "LICENSE"
   ],
   "scripts": {
+    "build": "node scripts/build-client.mjs",
+    "prepack": "npm run build",
     "test": "node --test",
-    "check": "node --check index.js && node --check bin/dsh-harbor.mjs && node --test"
+    "check": "npm run build && node --check index.js && node --check bin/dsh-harbor.mjs && node --test"
   },
   "dsh": {
     "bundle": {
       "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-runtime",
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-ui-conversation",
+        "@deepseek-ai/dsh-client-ui-tool",
+        "@deepseek-ai/dsh-client-ui-settings"
+      ],
+      "platform": "web"
     }
   },
   "peerDependencies": {
@@ -37,7 +53,9 @@
     "@deepseek-ai/cordis": "4.0.1",
     "@deepseek-ai/dsh-skill": "0.1.0-rc.6",
     "@deepseek-ai/dsh-tools": "0.1.0-rc.6",
-    "@deepseek-ai/schemastery": "3.18.1"
+    "@deepseek-ai/schemastery": "3.18.1",
+    "esbuild": "0.28.2",
+    "react": "18.3.1"
   },
   "engines": {
     "node": ">=22"