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

package/dist/host/changelog.js

@@ -0,0 +1,188 @@
+import dayjs from 'dayjs';
+export const CHANGELOG_FILE = 'CHANGELOG.md';
+export const CHANGELOG_KINDS = ['added', 'changed', 'fixed', 'removed', 'security', 'deprecated'];
+const KIND_LABELS = {
+    added: '✨ 新增',
+    changed: '⚡ 改进',
+    fixed: '🐛 修复',
+    removed: '🗑️ 移除',
+    security: '🔒 安全',
+    deprecated: '⚠️ 弃用',
+};
+const VERSION_HEADING = /^##[ \t]+\[?v?(\d+\.\d+\.\d+(?:[-+][0-9A-Za-z.-]+)?)\]?[ \t]*(?:-[ \t]*.*)?$/;
+const ANY_SECTION = /^##[ \t]/;
+const SUBSECTION = /^###[ \t]/;
+export function changelogVersion(value) {
+    return String(value ?? '')
+        .trim()
+        .replace(/^v/, '');
+}
+export function changelogDate(now = new Date()) {
+    return dayjs(now).format('YYYY-MM-DD');
+}
+export function normalizeChangelogText(text) {
+    return String(text ?? '').replace(/\r\n?/g, '\n');
+}
+function linesOf(text) {
+    return normalizeChangelogText(text).split('\n');
+}
+function bodyOf(rows) {
+    return rows.join('\n').trim();
+}
+function sectionRange(rows, version) {
+    const wanted = changelogVersion(version);
+    for (let index = 0; index < rows.length; index += 1) {
+        const row = rows[index] ?? '';
+        if (!ANY_SECTION.test(row))
+            continue;
+        const match = VERSION_HEADING.exec(row);
+        if (match === null || changelogVersion(match[1] ?? '') !== wanted)
+            continue;
+        let end = rows.length;
+        for (let next = index + 1; next < rows.length; next += 1) {
+            if (ANY_SECTION.test(rows[next] ?? '')) {
+                end = next;
+                break;
+            }
+        }
+        return { start: index, end };
+    }
+    return undefined;
+}
+export function changelogSkeleton() {
+    return '# 更新日志\n';
+}
+export function parseChangelog(text) {
+    const rows = linesOf(text);
+    const sections = [];
+    let current;
+    for (let index = 0; index < rows.length; index += 1) {
+        const row = rows[index] ?? '';
+        if (!ANY_SECTION.test(row))
+            continue;
+        if (current !== undefined) {
+            sections.push({ version: current.version, body: bodyOf(rows.slice(current.from, index)) });
+        }
+        const match = VERSION_HEADING.exec(row);
+        current =
+            match === null
+                ? undefined
+                : { version: changelogVersion(match[1] ?? ''), from: index + 1 };
+    }
+    if (current !== undefined) {
+        sections.push({ version: current.version, body: bodyOf(rows.slice(current.from)) });
+    }
+    return sections;
+}
+export function changelogSectionOf(text, version) {
+    const wanted = changelogVersion(version);
+    return parseChangelog(text).find((one) => one.version === wanted)?.body;
+}
+export function changelogHasEntry(text, version) {
+    const body = changelogSectionOf(text, version);
+    if (body === undefined)
+        return false;
+    return body
+        .split('\n')
+        .map((one) => one.trim())
+        .some((one) => one !== '' && !one.startsWith('#') && !one.startsWith('<!--') && !/^`[^`]*`$/.test(one));
+}
+function bulletsOf(note) {
+    return note
+        .split('\n')
+        .map((one) => one.trim())
+        .filter((one) => one !== '')
+        .map((one) => `- ${one}`);
+}
+function blockOf(options, label, bullets) {
+    const date = (options.date ?? '').trim();
+    return [
+        `## v${changelogVersion(options.version)}`,
+        ...(date === '' ? [] : ['', `\`${date}\``]),
+        '',
+        `### ${label}`,
+        '',
+        ...bullets,
+    ];
+}
+function insertBlock(rows, at, block) {
+    const before = rows.slice(0, at);
+    while (before.length > 0 && (before[before.length - 1] ?? '').trim() === '')
+        before.pop();
+    const after = rows.slice(at);
+    while (after.length > 0 && (after[0] ?? '').trim() === '')
+        after.shift();
+    const out = [...before];
+    if (out.length > 0)
+        out.push('');
+    out.push(...block);
+    if (after.length > 0) {
+        out.push('');
+        out.push(...after);
+    }
+    return out;
+}
+function newSectionAt(rows) {
+    for (let index = 0; index < rows.length; index += 1) {
+        if (/^##[ \t]+\[?unreleased\]?[ \t]*$/i.test(rows[index] ?? '')) {
+            for (let next = index + 1; next < rows.length; next += 1) {
+                if (ANY_SECTION.test(rows[next] ?? ''))
+                    return next;
+            }
+            return rows.length;
+        }
+    }
+    for (let index = 0; index < rows.length; index += 1) {
+        if (ANY_SECTION.test(rows[index] ?? ''))
+            return index;
+    }
+    return rows.length;
+}
+export function appendChangelogEntry(text, options) {
+    const kind = options.kind ?? 'changed';
+    const label = KIND_LABELS[kind];
+    const bullets = bulletsOf(options.note);
+    if (bullets.length === 0)
+        return normalizeChangelogText(text);
+    const blocks = blockOf(options, label, bullets);
+    const source = normalizeChangelogText(text).trim() === '' ? changelogSkeleton() : normalizeChangelogText(text);
+    const rows = linesOf(source);
+    const range = sectionRange(rows, options.version);
+    if (range === undefined)
+        return `${insertBlock(rows, newSectionAt(rows), blocks).join('\n').replace(/\n+$/, '')}\n`;
+    let subsection = -1;
+    for (let index = range.start + 1; index < range.end; index += 1) {
+        const heading = (rows[index] ?? '').trim();
+        if (SUBSECTION.test(heading) && heading.includes(label)) {
+            subsection = index;
+            break;
+        }
+    }
+    if (subsection === -1) {
+        const out = [...rows];
+        out.splice(range.end, 0, '', `### ${label}`, '', ...bullets);
+        return `${normalizeWhitespace(out)}\n`;
+    }
+    let end = range.end;
+    for (let index = subsection + 1; index < range.end; index += 1) {
+        if (SUBSECTION.test(rows[index] ?? '')) {
+            end = index;
+            break;
+        }
+    }
+    const out = [...rows];
+    let at = end;
+    while (at > subsection + 1 && (out[at - 1] ?? '').trim() === '')
+        at -= 1;
+    out.splice(at, 0, ...bullets);
+    return `${normalizeWhitespace(out)}\n`;
+}
+function normalizeWhitespace(rows) {
+    const out = [];
+    for (const row of rows) {
+        if (row.trim() === '' && out.length > 0 && (out[out.length - 1] ?? '').trim() === '')
+            continue;
+        out.push(row);
+    }
+    return out.join('\n').replace(/\n+$/, '');
+}

package/dist/host/channel-plugin.d.ts

@@ -0,0 +1,15 @@
+export declare const CHANNEL_PLUGIN_NAME = "opencli-plugin-workbench";
+export declare const CHANNEL_PLUGIN_SITE = "workbench";
+export interface ChannelPluginPlan {
+    readonly dest: string;
+    readonly version: string;
+    readonly commands: readonly string[];
+    readonly line: string;
+}
+export declare function channelVersionOf(dir: string): string | undefined;
+export declare function channelPluginPlan(options: {
+    readonly channelDir: string;
+    readonly command?: string;
+}): ChannelPluginPlan | undefined;
+export declare function channelInstalledVersion(): string | undefined;
+export declare function channelSiteInstalled(): boolean;

package/dist/host/channel-plugin.js

@@ -0,0 +1,42 @@
+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';
+function textOf(value) {
+    return typeof value === 'string' ? value.trim() : '';
+}
+export function channelVersionOf(dir) {
+    try {
+        const parsed = JSON.parse(readFileSync(join(dir, 'opencli-plugin.json'), 'utf8'));
+        if (typeof parsed !== 'object' || parsed === null)
+            return undefined;
+        const version = textOf(parsed['version']);
+        return version === '' ? undefined : version;
+    }
+    catch {
+        return undefined;
+    }
+}
+export function channelPluginPlan(options) {
+    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() {
+    return channelVersionOf(join(vendorPluginsDir(), CHANNEL_PLUGIN_NAME));
+}
+export function channelSiteInstalled() {
+    return existsSync(join(isolatedHome(), '.opencli', 'plugins', CHANNEL_PLUGIN_SITE));
+}

package/dist/host/cli.d.ts

@@ -0,0 +1,4 @@
+import type { DshHostContext } from '../api/dsh.js';
+import type { CliPort } from '../contract/cli.js';
+export declare function cliPortOf(ctx: DshHostContext): CliPort;
+export declare function cliCommandOf(ctx: DshHostContext): string;

package/dist/host/cli.js

@@ -0,0 +1,7 @@
+import { adaptersOf } from './adapters.js';
+export function cliPortOf(ctx) {
+    return { command: adaptersOf(ctx).runtime.opencliCommand(ctx).command };
+}
+export function cliCommandOf(ctx) {
+    return cliPortOf(ctx).command;
+}

package/dist/host/command-name.d.ts

@@ -0,0 +1 @@
+export declare function commandNamesMatch(declared: string, resolved: string): boolean;

package/dist/host/command-name.js

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

package/dist/host/data-error.d.ts

@@ -0,0 +1,13 @@
+export declare 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;
+    });
+}

package/dist/host/data-error.js

@@ -0,0 +1,20 @@
+export class WorkbenchDataError extends Error {
+    code;
+    detail;
+    hint;
+    project;
+    helpUrl;
+    constructor(code, message, extra = {}) {
+        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/dist/host/data-root.js

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

package/dist/host/diy-debug.js

@@ -1,3 +1,4 @@
+import { clockOf } from './time.js';
 /**
  * 把工具入参收成人话动作。
  * @param value - 任意入参值。
@@ -84,5 +85,5 @@ export function createDebugStore() {
  * @returns 形如「会话 x（自 HH:mm:ssZ 起在调试 y）」的中文串。
  */
 export function debugOwnerText(state) {
-    return `会话 ${state.sessionId}（自 ${new Date(state.startedAt).toISOString().slice(11, 19)}Z 起在调试 ${state.unit}）`;
+    return `会话 ${state.sessionId}（自 ${clockOf(state.startedAt)}Z 起在调试 ${state.unit}）`;
 }

package/dist/host/diy-record.js

@@ -1,3 +1,4 @@
+import { clockOf } from './time.js';
 /**
  * 录制约定的有效期（15 分钟，毫秒）：超过它没动静的约定算过期、当场让人。
  */
@@ -157,6 +158,6 @@ export function createRecordStore() {
  * @returns 形如「会话 x（自 HH:mm:ssZ 起在录 y 的「动作」）」的中文串。
  */
 export function recordOwnerText(state) {
-    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/dist/host/facts.d.ts

@@ -1,4 +1,4 @@
-import type { UnitManifest } from '../api/unit.js';
+import type { UnitManifest } from '../contract/unit.js';
 export interface FactChange {
     readonly rev: number;
     readonly facts: readonly string[];

package/dist/host/facts.js

@@ -1,6 +1,7 @@
-import { FACT_SCOPE_SUFFIX } from '../api/facts.js';
+import { randomUUID } from 'node:crypto';
+import { FACT_SCOPE_SUFFIX } from '../contract/facts.js';
 export function createFactLog(options = {}) {
-    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();
     const listeners = new Set();

package/dist/host/git.js

@@ -1,5 +1,5 @@
-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 function createHeadReader(options) {
     const { shell, logger } = options;
     return async function readHead(path) {

package/dist/host/http.js

@@ -2,7 +2,7 @@ import { unitFactScope } from './facts.js';
 import { parseCardsReport, parseCrashReport } from './panel-state.js';
 import { ACTIONS_PREFIX, API_PREFIX, DIY_DEBUG_PATH, DIY_RECORD_PATH, PANEL_STATE_PREFIX, PLUGIN_ID, PREFS_PREFIX, PROVISION_PREFIX } from '../config/constants.js';
 import { parseProvisionBody, } from './provision.js';
-import { WorkbenchDataError } from '../host/opencli.js';
+import { WorkbenchDataError } from './data-error.js';
 import { writeResultForClient } from './write-result.js';
 const MAX_PREFS_BODY_BYTES = 8 * 1024;
 const PROVISION_FACTS = ['capability', 'panels'];

package/dist/host/lib-capabilities.d.ts

@@ -0,0 +1,22 @@
+/**
+ * 跨平台库的「能力 → 首选实现」表：外壳 arch 的 S68 与 DIY 模块的 `source` 判据共用这一份，
+ * 避免两边各写一张表后漂开。
+ *
+ * 能力名是「做什么」，`preferred` 是「用什么」；两者不是同一个层级（类似 datetime → dayjs）。
+ * 手写轮子的指纹只认最常见的直连写法；`importsPreferred()` 负责判断这个文件是否已经在用首选库。
+ */
+export interface LibCapability {
+    readonly capability: string;
+    readonly preferred: string;
+    readonly pattern: RegExp;
+    readonly why: string;
+}
+/** 手写轮子的硬指纹；按能力名稳定排序，方便两边报告与测试对照。 */
+export declare const LIB_CAPABILITIES: readonly LibCapability[];
+/**
+ * 这个文件是否已经 import 了某个首选库（静态或动态 import 都算）。
+ * @param source 文件全文。
+ * @param preferred 首选库包名。
+ * @returns 有 import 就 `true`。
+ */
+export declare function importsPreferred(source: string, preferred: string): boolean;

package/dist/host/lib-capabilities.js

@@ -0,0 +1,37 @@
+/** 手写轮子的硬指纹；按能力名稳定排序，方便两边报告与测试对照。 */
+export const LIB_CAPABILITIES = [
+    {
+        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, preferred) {
+    const escaped = preferred.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    return new RegExp(`(?:from\\s*|import\\s*\\(\\s*)['"]${escaped}['"]`).test(source);
+}

package/dist/host/lib-install.d.ts

@@ -0,0 +1,9 @@
+import type { LibNeed, SupplySource } from '../contract/needs.js';
+export type NpmSource = Extract<SupplySource, {
+    kind: 'npm';
+}>;
+export declare function libInstallCommand(options: {
+    readonly need: LibNeed;
+    readonly source: NpmSource;
+    readonly version?: string | undefined;
+}): string;

package/dist/host/lib-install.js

@@ -0,0 +1,10 @@
+import { npmRegistryOf } from './plugin-source.js';
+import { quoteShellArg } from './shell-text.js';
+import { libsPrefix, npmCacheDir } from './paths.js';
+export function libInstallCommand(options) {
+    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/dist/host/long-task.d.ts

@@ -1,4 +1,4 @@
-import { type LongTaskStatus, type LongTaskStep } from '../api/long-task.js';
+import { type LongTaskStatus, type LongTaskStep } from '../contract/long-task.js';
 export interface LongTaskBase {
     readonly id: string;
     readonly workspace: string;

package/dist/host/long-task.js

@@ -1,4 +1,5 @@
-import { runsRouteOf } from '../api/long-task.js';
+import { epochOf } from './time.js';
+import { runsRouteOf } from '../contract/long-task.js';
 const LIVE = new Set(['running', 'needs-login']);
 const RECENT_MS = 10 * 60 * 1000;
 export function createLongTaskRegistry(deps) {
@@ -43,7 +44,7 @@ export function createLongTaskRegistry(deps) {
             return null;
         },
         current(workspace) {
-            const floor = Date.parse(now()) - recentMs;
+            const floor = epochOf(now()) - recentMs;
             const newest = new Map();
             for (const snapshot of runs.values()) {
                 if (snapshot.workspace !== workspace)
@@ -51,7 +52,7 @@ export function createLongTaskRegistry(deps) {
                 newest.set(snapshot.target, snapshot);
             }
             return [...newest.values()]
-                .filter((snapshot) => LIVE.has(snapshot.status) || Date.parse(snapshot.at) >= floor)
+                .filter((snapshot) => LIVE.has(snapshot.status) || epochOf(snapshot.at) >= floor)
                 .reverse()
                 .map((snapshot) => ({ ...deps.view(snapshot), id: snapshot.id }));
         },

package/dist/host/market-index.d.ts

@@ -0,0 +1,22 @@
+import type { DiscoverFilter, IndexSourceSpec, MarketIndex, MarketIndexEntry, MarketIndexParse, MarketIndexProblem, MarketIndexVersion, MarketSourceConfig } from '../contract/protocol/market-index.js';
+export { marketBranchOk, marketInstallTarget, marketText } from '../lib/market-index.js';
+export declare const MARKET_INDEX_SEED = "{\n  \"format\": 1,\n  \"plugins\": []\n}\n";
+export declare const MARKET_INDEX_README_LINES: readonly string[];
+export declare function compareSemver(left: string, right: string): number | undefined;
+export declare function parseMarketIndex(raw: unknown): MarketIndexParse;
+export declare function parseMarketIndexJson(text: string): MarketIndexParse;
+export declare function sortMarketVersions(versions: readonly MarketIndexVersion[]): MarketIndexVersion[];
+export declare function upsertMarketEntry(index: MarketIndex, entry: MarketIndexEntry): MarketIndex;
+export declare function marketEntryLabels(entry: MarketIndexEntry): readonly string[];
+export declare function filterMarketIndex(index: MarketIndex, filter: DiscoverFilter): readonly MarketIndexEntry[];
+export declare function marketSourceKey(source: IndexSourceSpec): string;
+export type SourceConfigParse = {
+    readonly ok: true;
+    readonly source: MarketSourceConfig;
+} | {
+    readonly ok: false;
+    readonly problem: MarketIndexProblem;
+};
+export declare function parseSourceConfig(raw: unknown): SourceConfigParse;
+export declare function httpUrlProblem(url: string): string | undefined;
+export declare function gitUrlOk(url: string): boolean;