dsh-ptc-plus 0.2.1

package/internal/worker-cwd-virtualization.js

@@ -0,0 +1,155 @@
+import { isAbsolute, parse, resolve, sep } from 'node:path'
+import { promisify } from 'node:util'
+
+const FILE_SYSTEM_PATH_ARGUMENTS = Object.freeze({
+  access: [0], accessSync: [0], appendFile: [0], appendFileSync: [0],
+  chmod: [0], chmodSync: [0], chown: [0], chownSync: [0],
+  copyFile: [0, 1], copyFileSync: [0, 1], cp: [0, 1], cpSync: [0, 1],
+  createReadStream: [0], createWriteStream: [0], exists: [0], existsSync: [0],
+  lchmod: [0], lchmodSync: [0], lchown: [0], lchownSync: [0],
+  link: [0, 1], linkSync: [0, 1], lstat: [0], lstatSync: [0],
+  lutimes: [0], lutimesSync: [0], mkdir: [0], mkdirSync: [0],
+  open: [0], openAsBlob: [0], openSync: [0], opendir: [0], opendirSync: [0],
+  readFile: [0], readFileSync: [0], readdir: [0], readdirSync: [0],
+  readlink: [0], readlinkSync: [0], realpath: [0], realpathSync: [0],
+  rename: [0, 1], renameSync: [0, 1], rm: [0], rmSync: [0],
+  rmdir: [0], rmdirSync: [0], stat: [0], statSync: [0], statfs: [0], statfsSync: [0],
+  symlink: [1], symlinkSync: [1], truncate: [0], truncateSync: [0],
+  unlink: [0], unlinkSync: [0], utimes: [0], utimesSync: [0],
+  watch: [0], watchFile: [0], writeFile: [0], writeFileSync: [0],
+})
+const FILE_SYSTEM_PREFIX_ARGUMENTS = Object.freeze([
+  'mkdtemp', 'mkdtempSync', 'mkdtempDisposable', 'mkdtempDisposableSync',
+])
+const FILE_SYSTEM_PROJECTED_PROPERTIES = Object.freeze({
+  exists: [promisify.custom],
+  realpath: ['native'],
+  realpathSync: ['native'],
+})
+const CHILD_PROCESS_PROJECTED_PROPERTIES = Object.freeze({
+  exec: [promisify.custom],
+  execFile: [promisify.custom],
+})
+
+function wrapBuiltinCallable(original, projectArguments, projectedProperties = []) {
+  const wrapped = {
+    invoke(...args) {
+      return Reflect.apply(original, this, projectArguments(args))
+    },
+  }.invoke
+  const descriptors = Object.getOwnPropertyDescriptors(original)
+  const projected = new Set(projectedProperties)
+  for (const property of Reflect.ownKeys(descriptors)) {
+    const descriptor = descriptors[property]
+    if (descriptor.value === original) {
+      descriptors[property] = { ...descriptor, value: wrapped }
+    } else if (projected.has(property)) {
+      descriptors[property] = {
+        ...descriptor,
+        value: wrapBuiltinCallable(descriptor.value, projectArguments),
+      }
+    }
+  }
+  return Object.defineProperties(wrapped, descriptors)
+}
+
+function wrapBuiltin(owner, name, projectArguments, projectedProperties) {
+  const original = owner?.[name]
+  if (typeof original !== 'function') return
+  owner[name] = wrapBuiltinCallable(original, projectArguments, projectedProperties)
+}
+
+/** Install one session's cwd projection into Node builtins loaded by the worker. */
+export function installWorkerCwdVirtualization(sessionCwd, originalRequire) {
+  if (sessionCwd === undefined) return
+  const nativeResolve = resolve
+  const bufferPrefix = Buffer.from(sessionCwd + (/[\\/]$/.test(sessionCwd) ? '' : sep))
+  const sessionPath = (value) => {
+    if (typeof value === 'string') return isAbsolute(value) ? value : nativeResolve(sessionCwd, value)
+    if (Buffer.isBuffer(value)) {
+      const absolute = isAbsolute(String.fromCharCode(...value.subarray(0, 3)))
+      return absolute ? value : Buffer.concat([bufferPrefix, value])
+    }
+    return value
+  }
+  const sessionPathPrefix = (value) => {
+    if (typeof value !== 'string' || isAbsolute(value) || parse(value).root !== '') return sessionPath(value)
+    return sessionCwd + (/[\\/]$/.test(sessionCwd) ? '' : sep) + value
+  }
+  const projectPaths = (args, indices) => {
+    const next = [...args]
+    for (const index of indices) next[index] = sessionPath(next[index])
+    return next
+  }
+  const projectPrefix = (args) => {
+    const next = [...args]
+    next[0] = sessionPathPrefix(next[0])
+    return next
+  }
+  const sessionChildOptions = options => (
+    options === null || typeof options !== 'object' || options.cwd !== undefined
+      ? options
+      : { ...options, cwd: sessionCwd }
+  )
+  const withDefaultOptions = (args, index) => {
+    const next = [...args]
+    next[index] = sessionChildOptions(next[index]) ?? { cwd: sessionCwd }
+    return next
+  }
+  const childProcessOptions = (name, args) => {
+    if (name === 'exec' || name === 'execSync') {
+      const next = [...args]
+      if (typeof next[1] === 'function') next.splice(1, 0, { cwd: sessionCwd })
+      else next[1] = sessionChildOptions(next[1]) ?? { cwd: sessionCwd }
+      return next
+    }
+    if (name === 'execFile' || name === 'execFileSync') {
+      if (args.length === 1 || typeof args[1] === 'function') {
+        const next = [...args]
+        next.splice(1, 0, { cwd: sessionCwd })
+        return next
+      }
+      if (typeof args[2] === 'function') {
+        if (args[1] !== undefined && !Array.isArray(args[1])) return withDefaultOptions(args, 1)
+        const next = [...args]
+        next.splice(2, 0, { cwd: sessionCwd })
+        return next
+      }
+      if (args[1] !== undefined && !Array.isArray(args[1])) return withDefaultOptions(args, 1)
+      return withDefaultOptions(args, 2)
+    }
+    return args.length === 1 || (args[1] !== undefined && !Array.isArray(args[1]))
+      ? withDefaultOptions(args, 1)
+      : withDefaultOptions(args, 2)
+  }
+  const sessionGlobOptions = (args) => {
+    const next = [...args]
+    if (typeof next[1] === 'function') next.splice(1, 0, { cwd: sessionCwd })
+    else if (next[1] === undefined) next[1] = { cwd: sessionCwd }
+    else if (next[1] !== null && typeof next[1] === 'object' && next[1].cwd === undefined) {
+      next[1] = { ...next[1], cwd: sessionCwd }
+    }
+    return next
+  }
+
+  process.cwd = () => sessionCwd
+  const fs = originalRequire('node:fs')
+  const path = originalRequire('node:path')
+  for (const [name, indices] of Object.entries(FILE_SYSTEM_PATH_ARGUMENTS)) {
+    wrapBuiltin(fs, name, args => projectPaths(args, indices), FILE_SYSTEM_PROJECTED_PROPERTIES[name])
+    wrapBuiltin(fs.promises, name, args => projectPaths(args, indices))
+  }
+  for (const name of FILE_SYSTEM_PREFIX_ARGUMENTS) {
+    wrapBuiltin(fs, name, projectPrefix)
+    wrapBuiltin(fs.promises, name, projectPrefix)
+  }
+  for (const name of ['glob', 'globSync']) {
+    wrapBuiltin(fs, name, sessionGlobOptions)
+    wrapBuiltin(fs.promises, name, sessionGlobOptions)
+  }
+  wrapBuiltin(path, 'resolve', args => [sessionCwd, ...args])
+  const childProcess = originalRequire('node:child_process')
+  for (const name of ['exec', 'execFile', 'execFileSync', 'execSync', 'fork', 'spawn', 'spawnSync']) {
+    wrapBuiltin(childProcess, name, args => childProcessOptions(name, args), CHILD_PROCESS_PROJECTED_PROPERTIES[name])
+  }
+}

package/package.json

@@ -0,0 +1,100 @@
+{
+  "name": "dsh-ptc-plus",
+  "version": "0.2.1",
+  "description": "A session-bound agent-native REPL for DeepSeek Harness PTC mode.",
+  "type": "module",
+  "main": "./index.js",
+  "exports": {
+    ".": "./index.js",
+    "./client": "./client.js",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "index.js",
+    "client.js",
+    "src",
+    "internal",
+    "docs",
+    "assets/dsh-ptc-plus-banner.webp",
+    "assets/ptc-plus-repair.png",
+    "assets/ptc-plus-settings.png",
+    "cordis.patch.yml",
+    "README.md",
+    "README.zh.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": "^22.19.0 || >=24.0.0"
+  },
+  "dependencies": {
+    "@babel/code-frame": "^7.29.7",
+    "@babel/parser": "^7.29.0",
+    "@babel/traverse": "^7.29.0",
+    "@deepseek-ai/schemastery": "^3.18.1",
+    "acorn": "^8.15.0"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/dsh-settings": "next",
+    "@deepseek-ai/dsh-skill-filesystem": "next",
+    "@deepseek-ai/dsh-tool-cordis": "next",
+    "@deepseek-ai/dsh-tools": "next"
+  },
+  "scripts": {
+    "build": "node scripts/client-bundle.mjs build",
+    "build:check": "node scripts/client-bundle.mjs check",
+    "prepack": "npm run build:check",
+    "hooks:install": "node scripts/review-findings.mjs install-hook",
+    "review:new": "node scripts/review-findings.mjs create",
+    "review:validate": "node scripts/review-findings.mjs validate",
+    "review:gate": "node scripts/review-findings.mjs gate",
+    "session:migrate": "node scripts/migrate-session-log.mjs",
+    "coverage": "node --test --experimental-test-module-mocks --experimental-test-coverage --test-concurrency=1 --test-coverage-include=\"index.js\" --test-coverage-include=\"internal/*.js\" --test-coverage-lines=100 --test-coverage-branches=95 --test-coverage-functions=100 \"test/*.test.js\"",
+    "verify": "npm run review:validate && npm run build:check && node --check index.js && node --check internal/kernel-worker.js && node --check scripts/migrate-session-log.mjs && node --check scripts/expensive-headless-acceptance.mjs && node --check scripts/ab-headless-trajectories.mjs && npm run coverage",
+    "check": "node scripts/review-findings.mjs check",
+    "test:expensive": "node scripts/expensive-headless-acceptance.mjs",
+    "test:ab": "node scripts/ab-headless-trajectories.mjs"
+  },
+  "keywords": [
+    "deepseek-harness",
+    "dsh",
+    "dsh-plugin",
+    "ptc",
+    "ptc-mode",
+    "repl"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/muyuanjin/dsh-ptc-plus.git"
+  },
+  "homepage": "https://github.com/muyuanjin/dsh-ptc-plus#readme",
+  "bugs": {
+    "url": "https://github.com/muyuanjin/dsh-ptc-plus/issues"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "external": [
+        "react"
+      ],
+      "inject": [
+        "@deepseek-ai/dsh-client-runtime",
+        "@deepseek-ai/dsh-client-ui-settings",
+        "@deepseek-ai/dsh-client-ui-settings-plugins",
+        "@deepseek-ai/dsh-client-connection",
+        "@deepseek-ai/dsh-client-ui-primitives"
+      ]
+    }
+  },
+  "devDependencies": {
+    "@deepseek-ai/dsh-settings": "next",
+    "@deepseek-ai/dsh-skill-filesystem": "next",
+    "@deepseek-ai/dsh-tool-cordis": "next",
+    "@deepseek-ai/dsh-tools": "next",
+    "esbuild": "0.28.2",
+    "yaml": "^2.9.0"
+  }
+}

package/src/client.js

@@ -0,0 +1,165 @@
+import { CONFIG_FIELDS, SETTINGS_NAMESPACE } from '../internal/config-spec.js'
+
+const CLIENT_STYLE_ID = 'ptc-plus-client-style'
+const CLIENT_CSS = `
+.ptcPlusCard{border:1px solid var(--dsw-alias-border-l2,rgba(0,0,0,.1));background:var(--dsw-alias-bg-layer-3,#fff);border-radius:8px;list-style:none;overflow:hidden}
+.ptcPlusHeader{appearance:none;width:100%;display:flex;align-items:center;gap:12px;padding:14px 16px;border:0;background:transparent;color:inherit;font:inherit;text-align:left;cursor:pointer;transition:background-color .16s ease}
+.ptcPlusHeader:hover{background:var(--dsw-alias-interactive-bg-hover,rgba(38,49,72,.06))}.ptcPlusHeader:focus-visible,.ptcPlusButton:focus-visible,.ptcPlusInput:focus-visible{outline:2px solid var(--dsw-alias-interactive-primary,#4d6bfe);outline-offset:-2px}
+.ptcPlusHeadText{display:flex;flex:1;min-width:0;flex-direction:column;align-items:flex-start;gap:1px}.ptcPlusName{font-size:14px;font-weight:600;line-height:20px}.ptcPlusDescription{color:var(--dsw-alias-label-tertiary,#74777d);font-size:12px;line-height:18px;overflow-wrap:anywhere}.ptcPlusStatus{display:inline-flex;align-items:center;flex:none;padding:2px 8px;border-radius:999px;font-size:11px;font-weight:500;line-height:16px}.ptcPlusStatus[data-enabled=true]{color:var(--dsw-alias-state-success-primary,#16794f);background:var(--dsw-alias-state-success-tertiary,#e7f7ef)}.ptcPlusStatus[data-enabled=false]{color:var(--dsw-alias-label-tertiary,#74777d);background:var(--dsw-alias-interactive-bg-hover,rgba(38,49,72,.06))}
+.ptcPlusChevron{display:flex;color:var(--dsw-alias-label-tertiary,#74777d);transition:transform .18s ease}.ptcPlusChevron[data-open=true]{transform:rotate(180deg)}.ptcPlusBody{display:grid;grid-template-rows:0fr;transition:grid-template-rows .2s ease}.ptcPlusBody[data-open=true]{grid-template-rows:1fr}.ptcPlusBodyInner{min-height:0;overflow:hidden}.ptcPlusFields{margin:0 16px;padding:8px 0 12px;border-top:1px solid var(--dsw-alias-border-l2,rgba(0,0,0,.1))}
+.ptcPlusRow{display:flex;align-items:center;gap:12px;min-height:48px;border-top:1px solid var(--dsw-alias-border-l2,rgba(0,0,0,.1))}.ptcPlusRow:first-child{border-top:0}.ptcPlusMain{flex:1;min-width:0}.ptcPlusLabel{font-size:14px;font-weight:500;line-height:20px}.ptcPlusDetail,.ptcPlusMessage{color:var(--dsw-alias-label-tertiary,#74777d);font-size:12px;line-height:18px;overflow-wrap:anywhere}.ptcPlusInput{box-sizing:border-box;min-width:72px;width:140px;padding:5px 8px;border:1px solid var(--dsw-alias-border-l2,rgba(0,0,0,.1));border-radius:6px;background:var(--dsw-alias-bg-layer-1,#fff);color:inherit;font:12px/18px ui-monospace,SFMono-Regular,Consolas,monospace}.ptcPlusCheck{width:18px;height:18px;accent-color:var(--dsw-alias-interactive-primary,#4d6bfe)}
+.ptcPlusFooter{display:flex;align-items:center;justify-content:space-between;gap:12px;margin-top:8px}.ptcPlusButton{min-height:32px;padding:0 12px;border:1px solid var(--dsw-alias-border-l2,rgba(0,0,0,.1));border-radius:6px;background:transparent;color:inherit;cursor:pointer;font:500 13px/20px inherit;transition:background-color .16s ease,border-color .16s ease}.ptcPlusButton:hover:not(:disabled){background:var(--dsw-alias-interactive-bg-hover,rgba(38,49,72,.06))}.ptcPlusButton:disabled,.ptcPlusInput:disabled,.ptcPlusCheck:disabled{cursor:not-allowed;opacity:.55}.ptcPlusActive{display:inline-flex;align-items:center;gap:5px;color:var(--dsw-alias-state-success-primary,#16794f);font-size:12px;line-height:18px;white-space:nowrap}
+@media(max-width:560px){.ptcPlusHeader{padding:12px}.ptcPlusFields{margin:0 12px}.ptcPlusRow{align-items:flex-start;flex-direction:column;gap:6px;padding:10px 0}.ptcPlusInput{width:100%}.ptcPlusFooter{align-items:stretch;flex-direction:column}.ptcPlusButton{width:100%}}
+@media(prefers-reduced-motion:reduce){.ptcPlusHeader,.ptcPlusChevron,.ptcPlusBody,.ptcPlusButton{transition:none}}
+`
+
+window.__ModuleLoader__.load({
+  // Replaced by the bundle entry with the package name from package.json.
+  id: __PTC_PLUS_CLIENT_MODULE_ID__,
+  factory: (require) => {
+    const React = require('react')
+    const {
+      IconCheckOutline14,
+      IconChevronDownOutline14,
+      IconSettingsOutline16,
+    } = require('@deepseek-ai/dsh-client-ui-primitives')
+    const module = { exports: {} }
+    const h = React.createElement
+
+    function installStyles() {
+      if (document.getElementById(CLIENT_STYLE_ID) !== null) return () => {}
+      const style = document.createElement('style')
+      style.id = CLIENT_STYLE_ID
+      style.textContent = CLIENT_CSS
+      document.head.append(style)
+      return () => style.remove()
+    }
+
+    function fieldInput(field, value, disabled, onChange) {
+      if (field.type === 'boolean') {
+        return h('input', {
+          type: 'checkbox', role: 'switch', className: 'ptcPlusCheck', checked: value === true,
+          disabled, 'aria-label': field.label,
+          onChange: event => onChange(field, event.target.checked),
+        })
+      }
+      return h('input', {
+        type: 'number', className: 'ptcPlusInput',
+        value: Number.isSafeInteger(value) ? String(value) : '',
+        min: field.min, max: field.max, step: 1, disabled, 'aria-label': field.label,
+        onChange: event => {
+          const input = event.target.value
+          const parsed = input === '' ? '' : Number(input)
+          onChange(field, Number.isSafeInteger(parsed) ? parsed : input)
+        },
+      })
+    }
+
+    function apply(ctx) {
+      const preferenceScope = ctx.settingsScope.bind({ namespace: SETTINGS_NAMESPACE })
+      ctx.effect(installStyles, 'ptc-plus: client styles')
+
+      function PTCPlusSettingsCard() {
+        const [open, setOpen] = React.useState(false)
+        const [status, setStatus] = React.useState('')
+        const [pending, setPending] = React.useState(() => new Set())
+        const writeTail = React.useRef(Promise.resolve())
+        const subscribe = React.useCallback(listener => preferenceScope.subscribe(listener), [])
+        const getSnapshot = React.useCallback(() => preferenceScope.getSnapshot(), [])
+        const snapshot = React.useSyncExternalStore(subscribe, getSnapshot, getSnapshot)
+        const value = snapshot.status === 'ready' ? (snapshot.value ?? {}) : {}
+        const enabled = value.enabled === true
+        const unavailable = snapshot.status !== 'ready' || snapshot.writable !== true
+        const persist = (field, nextValue) => {
+          if (unavailable || pending.has(field.key)) return
+          const operation = writeTail.current.then(async () => {
+            const before = preferenceScope.getSnapshot()
+            if (before.status !== 'ready' || before.writable !== true) return
+            if (field.key !== 'enabled' && before.value?.enabled !== true) return
+            if (before.value?.[field.key] === nextValue) return
+            setPending(current => new Set(current).add(field.key))
+            setStatus('')
+            try {
+              await preferenceScope.set(field.key, nextValue)
+              const after = preferenceScope.getSnapshot()
+              if (after.status !== 'ready' || after.value?.[field.key] !== nextValue) {
+                setStatus('设置未生效，请检查设置冲突')
+              } else {
+                setStatus('设置已立即生效')
+              }
+            } catch (error) {
+              setStatus('设置失败：' + (error instanceof Error ? error.message : String(error)))
+            } finally {
+              setPending(current => {
+                const next = new Set(current)
+                next.delete(field.key)
+                return next
+              })
+            }
+          })
+          writeTail.current = operation.catch(() => {})
+        }
+        const fieldDisabled = field => unavailable
+          || pending.has(field.key)
+          || (field.key !== 'enabled' && !enabled)
+        return h('li', { className: 'ptcPlusCard' },
+          h('button', {
+            type: 'button', className: 'ptcPlusHeader', 'aria-expanded': open,
+            'aria-label': open ? '收起 PTC Plus 设置' : '展开 PTC Plus 设置',
+            'aria-controls': 'ptc-plus-settings-body', onClick: () => setOpen(current => !current),
+          },
+          h(IconSettingsOutline16, { size: 16 }),
+          h('span', { className: 'ptcPlusHeadText' },
+            h('span', { className: 'ptcPlusName' }, 'PTC Plus'),
+            h('span', { className: 'ptcPlusDescription' }, 'PTC 模式的会话级 TypeScript REPL。')),
+          h('span', { className: 'ptcPlusStatus', 'data-enabled': enabled }, enabled ? '已启用' : '已停用'),
+          h('span', { className: 'ptcPlusChevron', 'data-open': open, 'aria-hidden': true }, h(IconChevronDownOutline14, { size: 14 }))),
+          h('div', { id: 'ptc-plus-settings-body', className: 'ptcPlusBody', 'data-open': open, 'aria-hidden': !open },
+            h('div', { className: 'ptcPlusBodyInner' }, h('div', { className: 'ptcPlusFields' },
+              snapshot.status === 'loading'
+                ? h('p', { className: 'ptcPlusMessage' }, '正在同步设置...')
+                : snapshot.status === 'unavailable'
+                  ? h('p', { className: 'ptcPlusMessage' }, '当前 DSH 实例未提供设置服务')
+                  : [
+                    ...CONFIG_FIELDS.map(field => h('div', { key: field.key, className: 'ptcPlusRow' },
+                      h('div', { className: 'ptcPlusMain' },
+                        h('div', { className: 'ptcPlusLabel' }, field.label),
+                        field.description === '' ? null : h('div', { className: 'ptcPlusDetail' }, field.description)),
+                      fieldInput(field, value[field.key], fieldDisabled(field), persist))),
+                    h('div', { key: 'footer', className: 'ptcPlusFooter' },
+                      h('span', { className: 'ptcPlusMessage', role: 'status' }, status || (snapshot.writable ? '设置会在修改后立即生效' : '当前设置为只读'))),
+                  ]))),
+        )
+      }
+
+      ctx.slots.inject('settings.plugin.item', () => ctx.slots.register({
+        name: 'settings.plugin.item', key: SETTINGS_NAMESPACE,
+      }, PTCPlusSettingsCard))
+
+      ctx.inject(['slots', 'sessions'], (scope) => {
+        function PTCPlusSessionIndicator({ sessionId }) {
+          const sessions = React.useSyncExternalStore(
+            listener => scope.sessions.list.subscribe(listener),
+            () => scope.sessions.list.getSnapshot(),
+            () => scope.sessions.list.getSnapshot(),
+          )
+          const settings = React.useSyncExternalStore(
+            listener => preferenceScope.subscribe(listener),
+            () => preferenceScope.getSnapshot(),
+            () => preferenceScope.getSnapshot(),
+          )
+          if (sessions.byId?.[sessionId]?.agentPreset !== 'code'
+            || settings.status !== 'ready' || settings.value?.enabled !== true) return null
+          return h('span', { className: 'ptcPlusActive', title: 'PTC Plus 已启用' },
+            h(IconCheckOutline14, { size: 14 }), 'PTC Plus')
+        }
+        scope.slots.inject('conversation.session.header.actions', () => scope.slots.register({
+          name: 'conversation.session.header.actions', id: 'ptc-plus-active', order: -9,
+        }, PTCPlusSessionIndicator))
+      })
+    }
+
+    module.exports = { apply, inject: ['settingsScope', 'slots', 'sessions'] }
+    return module.exports
+  },
+})