@dsh-workbench/shared 0.3.10 → 1.0.0-beta.0

package/src/host/channel-plugin.ts

@@ -0,0 +1,55 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { isolatedHome, toolchainOpencliDir, vendorPeerLink, vendorPluginsDir } from './paths.js';
+import { quoteShellArg } from './shell-text.js';
+
+export const CHANNEL_PLUGIN_NAME = 'opencli-plugin-workbench';
+export const CHANNEL_PLUGIN_SITE = 'workbench';
+
+export interface ChannelPluginPlan {
+  readonly dest: string;
+  readonly version: string;
+  readonly commands: readonly string[];
+  readonly line: string;
+}
+
+function textOf(value: unknown): string {
+  return typeof value === 'string' ? value.trim() : '';
+}
+
+export function channelVersionOf(dir: string): string | undefined {
+  try {
+    const parsed: unknown = JSON.parse(readFileSync(join(dir, 'opencli-plugin.json'), 'utf8'));
+    if (typeof parsed !== 'object' || parsed === null) return undefined;
+    const version = textOf((parsed as Record<string, unknown>)['version']);
+    return version === '' ? undefined : version;
+  } catch {
+    return undefined;
+  }
+}
+
+export function channelPluginPlan(options: {
+  readonly channelDir: string;
+  readonly command?: string;
+}): ChannelPluginPlan | undefined {
+  const version = channelVersionOf(options.channelDir);
+  if (version === undefined) return undefined;
+  const command = options.command ?? 'opencli';
+  const dest = join(vendorPluginsDir(), CHANNEL_PLUGIN_NAME);
+  const peer = vendorPeerLink();
+  const commands = [
+    `rm -rf ${quoteShellArg(dest)} && mkdir -p ${quoteShellArg(dest)} && cp -R ${quoteShellArg(options.channelDir)}/. ${quoteShellArg(dest)}/`,
+    `rm -rf ${quoteShellArg(peer.dir)} && mkdir -p ${quoteShellArg(peer.parent)} && ln -s ${quoteShellArg(toolchainOpencliDir())} ${quoteShellArg(peer.dir)}`,
+    `(${quoteShellArg(command)} plugin uninstall ${quoteShellArg(CHANNEL_PLUGIN_SITE)} || true)`,
+    `${quoteShellArg(command)} plugin install ${quoteShellArg(dest)}`,
+  ];
+  return { dest, version, commands, line: commands.join(' && ') };
+}
+
+export function channelInstalledVersion(): string | undefined {
+  return channelVersionOf(join(vendorPluginsDir(), CHANNEL_PLUGIN_NAME));
+}
+
+export function channelSiteInstalled(): boolean {
+  return existsSync(join(isolatedHome(), '.opencli', 'plugins', CHANNEL_PLUGIN_SITE));
+}

package/src/host/cli.ts

@@ -0,0 +1,11 @@
+import type { DshHostContext } from '../api/dsh.js';
+import type { CliPort } from '../contract/cli.js';
+import { adaptersOf } from './adapters.js';
+
+export function cliPortOf(ctx: DshHostContext): CliPort {
+  return { command: adaptersOf(ctx).runtime.opencliCommand(ctx).command };
+}
+
+export function cliCommandOf(ctx: DshHostContext): string {
+  return cliPortOf(ctx).command;
+}

package/src/host/command-name.ts

@@ -0,0 +1,15 @@
+function baseName(value: string): string {
+  const parts = value.trim().split(/[\\/]/);
+  return parts[parts.length - 1] ?? '';
+}
+
+function isOpencli(name: string): boolean {
+  return name === 'opencli' || name === 'opencli.cmd' || name === 'opencli.exe';
+}
+
+export function commandNamesMatch(declared: string, resolved: string): boolean {
+  const left = baseName(declared);
+  const right = baseName(resolved);
+  if (left === '' || right === '') return false;
+  return left === right || (isOpencli(left) && isOpencli(right));
+}

package/src/host/data-error.ts

@@ -0,0 +1,21 @@
+export class WorkbenchDataError extends Error {
+  readonly code: string;
+  readonly detail?: string;
+  readonly hint?: string;
+  readonly project?: unknown;
+  readonly helpUrl?: string;
+
+  constructor(
+    code: string,
+    message: string,
+    extra: { detail?: string; hint?: string; project?: unknown; helpUrl?: string } = {},
+  ) {
+    super(message);
+    this.name = 'WorkbenchDataError';
+    this.code = code;
+    if (extra.detail !== undefined) this.detail = extra.detail;
+    if (extra.hint !== undefined) this.hint = extra.hint;
+    if (extra.project !== undefined) this.project = extra.project;
+    if (extra.helpUrl !== undefined) this.helpUrl = extra.helpUrl;
+  }
+}

package/src/host/data-root.ts

@@ -5,6 +5,8 @@ export function dshHome(): string {
 }
 
 export function workbenchRoot(): string {
+  const configured = process.env.DSH_WORKBENCH_HOME?.trim();
+  if (configured !== undefined && configured !== '') return configured;
   return `${dshHome()}/workbench`;
 }
 

package/src/host/diy-debug.ts

@@ -1,3 +1,4 @@
+import { clockOf } from './time.js';
 /**
  * 调试约定的两个相位：`debugging` 正占着用户的屏，`paused` 已暂停但仍持着约定。
  */
@@ -156,5 +157,5 @@ export function createDebugStore(): DebugStore {
  * @returns 形如「会话 x（自 HH:mm:ssZ 起在调试 y）」的中文串。
  */
 export function debugOwnerText(state: DebugState): string {
-  return `会话 ${state.sessionId}（自 ${new Date(state.startedAt).toISOString().slice(11, 19)}Z 起在调试 ${state.unit}）`;
+  return `会话 ${state.sessionId}（自 ${clockOf(state.startedAt)}Z 起在调试 ${state.unit}）`;
 }

package/src/host/diy-record.ts

@@ -1,3 +1,4 @@
+import { clockOf } from './time.js';
 /**
  * 录制交接的三个相位：`armed` 等用户在外站页面上动手，`recording` 正在录，`finished` 录完待取。
  */
@@ -274,6 +275,6 @@ export function createRecordStore(): RecordStore {
  * @returns 形如「会话 x（自 HH:mm:ssZ 起在录 y 的「动作」）」的中文串。
  */
 export function recordOwnerText(state: RecordState): string {
-  const at = new Date(state.startedAt).toISOString().slice(11, 19);
+  const at = clockOf(state.startedAt);
   return `会话 ${state.sessionId}（自 ${at}Z 起在录 ${state.unit} 的「${state.action}」）`;
 }

package/src/host/facts.ts

@@ -1,5 +1,6 @@
-import type { UnitManifest } from '../api/unit.js';
-import { FACT_SCOPE_SUFFIX } from '../api/facts.js';
+import { randomUUID } from 'node:crypto';
+import type { UnitManifest } from '../contract/unit.js';
+import { FACT_SCOPE_SUFFIX } from '../contract/facts.js';
 
 export interface FactChange {
   readonly rev: number;
@@ -19,7 +20,7 @@ export interface FactLog {
 }
 
 export function createFactLog(options: { readonly epoch?: string } = {}): FactLog {
-  const epoch = options.epoch ?? `e${Date.now().toString(36)}${Math.random().toString(36).slice(2, 8)}`;
+  const epoch = options.epoch ?? `e${randomUUID()}`;
   let rev = 0;
   const last = new Map<string, number>();
   const listeners = new Set<(change: FactChange) => void>();

package/src/host/git.ts

@@ -1,6 +1,6 @@
 import type { DshShell } from '../api/dsh.js';
-import { quoteShellArg, tailLines } from './shell-text.js';
-import { runShell } from './shell.js';
+import { quoteShellArg, tailLines } from '../host/shell-text.js';
+import { runShell } from '../host/shell.js';
 
 export type OriginRead =
   | { readonly kind: 'ok'; readonly remote: string }

package/src/host/http.ts

@@ -7,7 +7,7 @@ import {
   type ProvisionHandler,
   type ProvisionRequest,
 } from './provision.js';
-import { WorkbenchDataError } from '../host/opencli.js';
+import { WorkbenchDataError } from './data-error.js';
 import { writeResultForClient } from './write-result.js';
 
 export type RouteHandler = (search: URLSearchParams) => Promise<unknown> | unknown;

package/src/host/lib-capabilities.ts

@@ -0,0 +1,52 @@
+/**
+ * 跨平台库的「能力 → 首选实现」表：外壳 arch 的 S68 与 DIY 模块的 `source` 判据共用这一份，
+ * 避免两边各写一张表后漂开。
+ *
+ * 能力名是「做什么」，`preferred` 是「用什么」；两者不是同一个层级（类似 datetime → dayjs）。
+ * 手写轮子的指纹只认最常见的直连写法；`importsPreferred()` 负责判断这个文件是否已经在用首选库。
+ */
+export interface LibCapability {
+  readonly capability: string;
+  readonly preferred: string;
+  readonly pattern: RegExp;
+  readonly why: string;
+}
+
+/** 手写轮子的硬指纹；按能力名稳定排序，方便两边报告与测试对照。 */
+export const LIB_CAPABILITIES: readonly LibCapability[] = [
+  {
+    capability: 'process-spawn',
+    preferred: 'execa',
+    pattern: /from\s+['"]node:child_process['"]/,
+    why: '自己起进程要用 execa；同步/跨平台差异交给它',
+  },
+  {
+    capability: 'cli-locate',
+    preferred: 'which',
+    pattern: /\bprocess\.env\.(?:PATH|PATHEXT)\b/,
+    why: '自己扫 PATH/PATHEXT 要用 which（它处理 PATHEXT 与 Path 大小写）',
+  },
+  {
+    capability: 'file-lock',
+    preferred: 'proper-lockfile',
+    pattern: /\bprocess\.kill\([^)]*,\s*0\)|flag:\s*['"]wx['"]/,
+    why: '自己抢文件锁要用 proper-lockfile（stale / 重试 / 跨平台）',
+  },
+  {
+    capability: 'atomic-state',
+    preferred: 'write-file-atomic',
+    pattern: /writeFileSync\([^)]*\.(?:sync\.json|self-update\.json)/,
+    why: '自己直写状态文件要用 write-file-atomic（防写一半）',
+  },
+];
+
+/**
+ * 这个文件是否已经 import 了某个首选库（静态或动态 import 都算）。
+ * @param source 文件全文。
+ * @param preferred 首选库包名。
+ * @returns 有 import 就 `true`。
+ */
+export function importsPreferred(source: string, preferred: string): boolean {
+  const escaped = preferred.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+  return new RegExp(`(?:from\\s*|import\\s*\\(\\s*)['"]${escaped}['"]`).test(source);
+}

package/src/host/lib-install.ts

@@ -0,0 +1,18 @@
+import type { LibNeed, SupplySource } from '../contract/needs.js';
+import { npmRegistryOf } from './plugin-source.js';
+import { quoteShellArg } from './shell-text.js';
+import { libsPrefix, npmCacheDir } from './paths.js';
+
+export type NpmSource = Extract<SupplySource, { kind: 'npm' }>;
+
+export function libInstallCommand(options: {
+  readonly need: LibNeed;
+  readonly source: NpmSource;
+  readonly version?: string | undefined;
+}): string {
+  const { need, source, version } = options;
+  const registry = npmRegistryOf(source, process.env);
+  const spec = version ?? need.version ?? 'latest';
+  const registryFlag = registry.ok ? ` --registry ${quoteShellArg(registry.value)}` : '';
+  return `npm i --prefix ${quoteShellArg(libsPrefix())} ${quoteShellArg(`${need.name}@${spec}`)}${registryFlag} --cache ${quoteShellArg(npmCacheDir())}`;
+}

package/src/host/long-task.ts

@@ -1,4 +1,5 @@
-import { runsRouteOf, type LongTaskStatus, type LongTaskStep } from '../api/long-task.js';
+import { epochOf } from './time.js';
+import { runsRouteOf, type LongTaskStatus, type LongTaskStep } from '../contract/long-task.js';
 
 const LIVE: ReadonlySet<string> = new Set<LongTaskStatus>(['running', 'needs-login']);
 
@@ -104,7 +105,7 @@ export function createLongTaskRegistry<S extends LongTaskBase>(deps: LongTaskDep
     },
 
     current(workspace) {
-      const floor = Date.parse(now()) - recentMs;
+      const floor = epochOf(now()) - recentMs;
       const newest = new Map<string, LongTaskBase>();
       for (const snapshot of runs.values()) {
         if (snapshot.workspace !== workspace) continue;
@@ -112,7 +113,7 @@ export function createLongTaskRegistry<S extends LongTaskBase>(deps: LongTaskDep
       }
       return [...newest.values()]
         .filter(
-          (snapshot) => LIVE.has(snapshot.status) || Date.parse(snapshot.at) >= floor,
+          (snapshot) => LIVE.has(snapshot.status) || epochOf(snapshot.at) >= floor,
         )
         .reverse()
         .map((snapshot) => ({ ...deps.view(snapshot as S), id: snapshot.id }));