@dsh-workbench/adapter-profile 0.0.0-stage → 1.0.0-beta.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 dsh-workbench contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,29 @@
-# Temporary Holding Version
+# @dsh-workbench/adapter-profile
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+工作台的 profile 适配器。
+
+## 职责
+
+- profile 创建与配置同步
+- registry notebook 与 release 信息
+- 本地 bundle 清单解析
+- 依赖 `adapter-runtime` 的隔离缓存与 vendor 路径
+
+`self-update` 属于 probe（它需要运行时种子与工具链），不在本包。
+
+## 入口
+
+```ts
+import { createRegistryNotebook, profileCreateAction, configSyncAction } from '@dsh-workbench/adapter-profile';
+```
+
+## 边界
+
+只处理 profile 配置、registry 与发布元数据；不复制 probe 的 runtime-seed / toolchain / platform。
+
+## 验证
+
+```bash
+pnpm --filter @dsh-workbench/adapter-profile run build
+pnpm --filter @dsh-workbench/adapter-profile run test
+```

package/dist/config-sync-assets.d.ts

@@ -0,0 +1,32 @@
+import type { ConfigSyncAsset } from '@dsh-workbench/shared/contract/protocol/config-sync';
+export interface CopyPlan {
+    readonly source: string;
+    readonly target: string;
+    readonly path: string;
+    readonly overwrite: boolean;
+}
+export interface AssetBlock {
+    readonly insert: boolean;
+    readonly body: string;
+}
+export declare function assetsOf(block: AssetBlock, sourceDir: string, targetDir: string): readonly ConfigSyncAsset[];
+export declare function assetMapOf(blocks: readonly AssetBlock[], sourceDir: string, targetDir: string): Map<string, ConfigSyncAsset>;
+export declare function planCopies(assets: readonly ConfigSyncAsset[], sourceDir: string, targetDir: string, overwriteAssets: ReadonlySet<string>): {
+    ok: true;
+    plans: readonly CopyPlan[];
+} | {
+    ok: false;
+    text: string;
+};
+export declare function cleanupFiles(created: readonly string[], backups: ReadonlyMap<string, Buffer>): void;
+export declare function copyPlans(plans: readonly CopyPlan[]): {
+    ok: true;
+    files: string[];
+    created: string[];
+    backups: Map<string, Buffer>;
+} | {
+    ok: false;
+    text: string;
+    created: string[];
+    backups: Map<string, Buffer>;
+};

package/dist/config-sync-assets.js

@@ -0,0 +1,290 @@
+import { createHash } from 'node:crypto';
+import { chmodSync, copyFileSync, existsSync, lstatSync, mkdirSync, readFileSync, readdirSync, renameSync, statSync, unlinkSync, writeFileSync, } from 'node:fs';
+import { dirname, isAbsolute, join, relative, resolve, sep } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const NAME_LINE = /^[ \t]*-?[ \t]*name:[ \t]*['"]?([^'"\s#]+)/;
+const INSERT_LINE = /^- insert:[ \t]*$/;
+const ASSET_MAX_BYTES = 8 * 1024 * 1024;
+const ASSET_MAX_TOTAL = 32 * 1024 * 1024;
+const ASSET_MAX_FILES = 500;
+const ASSET_SKIP = new Set(['node_modules', '.git', '.DS_Store']);
+function matched(text, pattern) {
+    const found = pattern.exec(text);
+    return found === null ? undefined : found[1];
+}
+function looksLikeAssetName(value) {
+    return value.startsWith('./') || value.startsWith('../') || value.startsWith('file://') || isAbsolute(value);
+}
+function insertNamesOf(body) {
+    if (!INSERT_LINE.test(body.split('\n')[0] ?? ''))
+        return [];
+    return body
+        .split('\n')
+        .flatMap((line) => {
+        const name = matched(line, NAME_LINE);
+        return name !== undefined && looksLikeAssetName(name) ? [name] : [];
+    });
+}
+function assetLocationOf(name, profileDir) {
+    let abs = null;
+    if (name.startsWith('file://')) {
+        try {
+            abs = fileURLToPath(name);
+        }
+        catch {
+            return null;
+        }
+    }
+    else if (name.startsWith('./') || name.startsWith('../')) {
+        abs = resolve(profileDir, name);
+    }
+    else if (isAbsolute(name)) {
+        abs = resolve(name);
+    }
+    if (abs === null)
+        return null;
+    const rel = relative(profileDir, abs);
+    if (rel === '' || rel === '..' || rel.startsWith(`..${sep}`) || isAbsolute(rel)) {
+        return { kind: 'outside', path: name };
+    }
+    return { kind: 'inside', rel: rel.split(sep).join('/'), abs };
+}
+function hashOf(path) {
+    return createHash('sha1').update(readFileSync(path)).digest('hex');
+}
+function fileStateOf(source, target) {
+    try {
+        const sourceStat = statSync(source);
+        if (sourceStat.size > ASSET_MAX_BYTES)
+            return 'external';
+        let targetStat;
+        try {
+            targetStat = statSync(target);
+        }
+        catch {
+            return 'missing';
+        }
+        if (!targetStat.isFile() || targetStat.size !== sourceStat.size)
+            return 'differs';
+        return hashOf(source) === hashOf(target) ? 'same' : 'differs';
+    }
+    catch {
+        return 'external';
+    }
+}
+function collectDirFiles(dir, profileDir, found, budget) {
+    let entries;
+    try {
+        entries = readdirSync(dir, { withFileTypes: true });
+    }
+    catch {
+        return false;
+    }
+    for (const entry of entries.sort((left, right) => left.name.localeCompare(right.name))) {
+        if (ASSET_SKIP.has(entry.name))
+            continue;
+        const abs = join(dir, entry.name);
+        const rel = relative(profileDir, abs).split(sep).join('/');
+        if (entry.isSymbolicLink())
+            return false;
+        if (entry.isDirectory()) {
+            if (!collectDirFiles(abs, profileDir, found, budget))
+                return false;
+            continue;
+        }
+        if (!entry.isFile())
+            continue;
+        let size;
+        try {
+            size = statSync(abs).size;
+        }
+        catch {
+            return false;
+        }
+        if (size > ASSET_MAX_BYTES)
+            return false;
+        budget.bytes += size;
+        if (budget.bytes > ASSET_MAX_TOTAL || found.length >= ASSET_MAX_FILES)
+            return false;
+        found.push(rel);
+    }
+    return true;
+}
+function aggregateAssetState(files) {
+    if (files.some((file) => file.state === 'external'))
+        return 'external';
+    if (files.some((file) => file.state === 'differs'))
+        return 'differs';
+    if (files.some((file) => file.state === 'missing'))
+        return 'missing';
+    return 'same';
+}
+function externalAsset(path, reason) {
+    return {
+        key: `asset:${path}`,
+        path,
+        kind: 'file',
+        state: 'external',
+        files: [],
+        bytes: 0,
+        reason,
+    };
+}
+function assetOf(name, sourceDir, targetDir) {
+    const location = assetLocationOf(name, sourceDir);
+    if (location === null)
+        return null;
+    if (location.kind === 'outside')
+        return externalAsset(location.path, '这个文件在 profile 外面');
+    let sourceStat;
+    try {
+        sourceStat = lstatSync(location.abs);
+    }
+    catch {
+        return externalAsset(location.rel, '来源里没有这个文件');
+    }
+    if (sourceStat.isSymbolicLink())
+        return externalAsset(location.rel, '符号链接不会跟着搬');
+    if (sourceStat.isDirectory()) {
+        const found = [];
+        if (!collectDirFiles(location.abs, sourceDir, found, { bytes: 0 })) {
+            return externalAsset(location.rel, '目录太大或含符号链接，先手动复制');
+        }
+        const files = found.map((path) => {
+            const source = join(sourceDir, path);
+            const bytes = statSync(source).size;
+            return { path, state: fileStateOf(source, join(targetDir, path)), bytes };
+        });
+        return {
+            key: `asset:${location.rel}`,
+            path: location.rel,
+            kind: 'dir',
+            state: aggregateAssetState(files),
+            files,
+            bytes: files.reduce((sum, file) => sum + (file.bytes ?? 0), 0),
+        };
+    }
+    if (!sourceStat.isFile())
+        return externalAsset(location.rel, '不是普通文件');
+    const state = fileStateOf(location.abs, join(targetDir, location.rel));
+    return {
+        key: `asset:${location.rel}`,
+        path: location.rel,
+        kind: 'file',
+        state,
+        files: [{ path: location.rel, state, bytes: sourceStat.size }],
+        bytes: sourceStat.size,
+    };
+}
+export function assetsOf(block, sourceDir, targetDir) {
+    if (!block.insert)
+        return [];
+    const seen = new Set();
+    const assets = [];
+    for (const name of insertNamesOf(block.body)) {
+        const asset = assetOf(name, sourceDir, targetDir);
+        if (asset === null || seen.has(asset.key))
+            continue;
+        seen.add(asset.key);
+        assets.push(asset);
+    }
+    return assets;
+}
+export function assetMapOf(blocks, sourceDir, targetDir) {
+    const map = new Map();
+    for (const block of blocks) {
+        for (const asset of assetsOf(block, sourceDir, targetDir))
+            map.set(asset.key, asset);
+    }
+    return map;
+}
+function insideTarget(targetDir, path) {
+    const target = resolve(targetDir, path);
+    const rel = relative(targetDir, target);
+    return rel !== '' && rel !== '..' && !rel.startsWith(`..${sep}`) && !isAbsolute(rel);
+}
+export function planCopies(assets, sourceDir, targetDir, overwriteAssets) {
+    const plans = [];
+    let total = 0;
+    for (const asset of assets) {
+        if (asset.state === 'external') {
+            return { ok: false, text: `这个文件搬不过来：${asset.path}${asset.reason === undefined ? '' : `（${asset.reason}）`}` };
+        }
+        for (const file of asset.files) {
+            if (file.state === 'same')
+                continue;
+            if (file.state === 'external') {
+                return { ok: false, text: `这个文件搬不过来：${file.path}${asset.reason === undefined ? '' : `（${asset.reason}）`}` };
+            }
+            const overwrite = file.state === 'differs';
+            if (overwrite && !overwriteAssets.has(asset.key)) {
+                return { ok: false, text: `文件不一样：${file.path}。勾上覆盖再试` };
+            }
+            if (!insideTarget(targetDir, file.path)) {
+                return { ok: false, text: `这个文件会写到 profile 外面：${file.path}` };
+            }
+            total += file.bytes ?? 0;
+            if (total > ASSET_MAX_TOTAL) {
+                return { ok: false, text: `这次要复制的文件太大（超过 ${String(ASSET_MAX_TOTAL / 1024 / 1024)} MB），先手动复制` };
+            }
+            plans.push({
+                source: join(sourceDir, file.path),
+                target: join(targetDir, file.path),
+                path: file.path,
+                overwrite,
+            });
+        }
+    }
+    return { ok: true, plans };
+}
+export function cleanupFiles(created, backups) {
+    for (const file of [...created].reverse()) {
+        try {
+            unlinkSync(file);
+        }
+        catch {
+            continue;
+        }
+    }
+    for (const [file, body] of backups) {
+        try {
+            writeFileSync(file, body);
+        }
+        catch {
+            continue;
+        }
+    }
+}
+export function copyPlans(plans) {
+    const created = [];
+    const backups = new Map();
+    const files = [];
+    for (const plan of plans) {
+        try {
+            mkdirSync(dirname(plan.target), { recursive: true });
+            if (existsSync(plan.target)) {
+                if (!plan.overwrite)
+                    continue;
+                backups.set(plan.target, readFileSync(plan.target));
+            }
+            else {
+                created.push(plan.target);
+            }
+            const mode = statSync(plan.source).mode & 0o777;
+            const tmp = `${plan.target}.wb-sync-${String(process.pid)}-${String(files.length)}`;
+            copyFileSync(plan.source, tmp);
+            chmodSync(tmp, mode);
+            renameSync(tmp, plan.target);
+            files.push(plan.path);
+        }
+        catch (error) {
+            return {
+                ok: false,
+                text: `写不进去：${error instanceof Error ? error.message : String(error)}`,
+                created,
+                backups,
+            };
+        }
+    }
+    return { ok: true, files, created, backups };
+}

package/dist/config-sync.d.ts

@@ -0,0 +1,49 @@
+import type { PostResource, RouteHandler } from '@dsh-workbench/shared/host';
+import type { ConfigSyncAsset, ConfigSyncRow, ConfigSyncSnapshot } from '@dsh-workbench/shared/contract/protocol/config-sync';
+export interface PatchBlock {
+    readonly key: string;
+    readonly id: string;
+    readonly insert: boolean;
+    readonly body: string;
+    readonly names: readonly string[];
+}
+export declare function patchBlocks(text: string): PatchBlock[];
+export declare function normalizeBlock(body: string): string;
+export declare function syncRows(source: readonly PatchBlock[], own: readonly PatchBlock[], missing: (block: PatchBlock) => readonly string[], assets?: (block: PatchBlock) => readonly ConfigSyncAsset[]): ConfigSyncRow[];
+export declare function mergeBlocks(ownText: string, incoming: readonly PatchBlock[], overwrite: ReadonlySet<string>): {
+    ok: true;
+    text: string;
+    written: string[];
+    skipped: string[];
+} | {
+    ok: false;
+    reason: string;
+};
+export declare function readPatchBlocks(path: string): {
+    ok: true;
+    text: string;
+    blocks: PatchBlock[];
+} | {
+    ok: false;
+    reason: string;
+};
+export declare function writePatchFile(path: string, text: string): void;
+export interface ConfigSyncDeps {
+    readonly home: string;
+    readonly self: string;
+    readonly profileDir: string | null;
+    readonly reconcile?: (() => Promise<boolean | void>) | undefined;
+}
+export declare function configSyncHandler(deps: ConfigSyncDeps): RouteHandler;
+export declare function configSyncSnapshot(deps: ConfigSyncDeps, asked?: string): ConfigSyncSnapshot;
+export declare function configSyncApply(deps: ConfigSyncDeps, payload: unknown): Promise<{
+    ok: true;
+    written: string[];
+    skipped: string[];
+    files: string[];
+    verified: boolean;
+} | {
+    ok: false;
+    text: string;
+}>;
+export declare function configSyncAction(deps: ConfigSyncDeps): PostResource;

package/dist/config-sync.js

@@ -0,0 +1,380 @@
+import { existsSync, readFileSync, readdirSync, renameSync, statSync, unlinkSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { CONFIG_SYNC_RESOURCE } from '@dsh-workbench/shared/contract/protocol/config-sync';
+import { assetMapOf, assetsOf, cleanupFiles, copyPlans, planCopies } from './config-sync-assets.js';
+const ID_LINE = /^- id:[ \t]*"?([^"\s#]+)/;
+const INSERT_LINE = /^- insert:[ \t]*$/;
+const NESTED_ID = /^[ \t]+-[ \t]*id:[ \t]*"?([^"\s#]+)/;
+const NAME_LINE = /^[ \t]*-?[ \t]*name:[ \t]*['"]?([^'"\s#]+)/;
+const COMMENT_LINE = /^[ \t]*#/;
+const ISOLATION_IDS = new Set([
+    'session-persistence-jsonl',
+    'storage-json',
+    'attachment-local',
+    'sandbox-policy',
+]);
+function trimmedTail(lines) {
+    let end = lines.length;
+    while (end > 0 && (lines[end - 1] ?? '').trim() === '')
+        end -= 1;
+    return lines.slice(0, end);
+}
+function matched(text, pattern) {
+    const found = pattern.exec(text);
+    return found === null ? undefined : found[1];
+}
+function blockOf(body, index) {
+    const lines = body.split('\n');
+    const first = lines[0] ?? '';
+    const id = matched(first, ID_LINE);
+    const nested = lines.flatMap((line) => {
+        const one = matched(line, NESTED_ID);
+        return one === undefined ? [] : [one];
+    });
+    const insert = id === undefined && INSERT_LINE.test(first);
+    const label = id ?? nested.join(', ');
+    const key = id !== undefined ? `id:${id}` : insert ? `insert:${nested.join(', ')}` : `block:${String(index)}`;
+    const names = lines.flatMap((line) => {
+        const one = matched(line, NAME_LINE);
+        return one === undefined ? [] : [one];
+    });
+    return { key, id: label === '' ? key : label, insert, body, names };
+}
+function spannedBlocks(text) {
+    const lines = text.split('\n');
+    const starts = [];
+    lines.forEach((line, index) => {
+        if (/^- /.test(line) || line === '-')
+            starts.push(index);
+    });
+    const blocks = [];
+    for (let i = 0; i < starts.length; i += 1) {
+        const from = starts[i] ?? 0;
+        const to = i + 1 < starts.length ? (starts[i + 1] ?? lines.length) : lines.length;
+        const body = trimmedTail(lines.slice(from, to)).join('\n');
+        if (body.trim() === '')
+            continue;
+        blocks.push({ ...blockOf(body, blocks.length), from, to });
+    }
+    return blocks;
+}
+export function patchBlocks(text) {
+    return spannedBlocks(text).map(({ from: _from, to: _to, ...block }) => block);
+}
+export function normalizeBlock(body) {
+    return body
+        .split('\n')
+        .map((line) => line.replace(/\s+$/, ''))
+        .filter((line) => line.trim() !== '' && !COMMENT_LINE.test(line))
+        .join('\n');
+}
+function rewriteForTarget(body, self) {
+    if (self === '' || self === 'workbench')
+        return body;
+    return body.replace(/(dshHomePath\(\s*['"])workbench(?=[/'"])/g, `$1${self}`);
+}
+export function syncRows(source, own, missing, assets = () => []) {
+    const mine = new Map(own.map((block) => [block.key, block]));
+    const rows = [];
+    for (const block of source) {
+        const here = mine.get(block.key);
+        const same = here !== undefined && normalizeBlock(here.body) === normalizeBlock(block.body);
+        const found = assets(block);
+        if (same && found.every((asset) => asset.state === 'same'))
+            continue;
+        rows.push({
+            key: block.key,
+            id: block.id,
+            insert: block.insert,
+            state: here === undefined ? 'new' : same ? 'same' : 'differs',
+            body: block.body,
+            ownBody: here === undefined ? null : here.body,
+            missing: missing(block),
+            assets: found,
+        });
+    }
+    return rows;
+}
+function replaceBlocks(text, blocks) {
+    const wanted = new Map(blocks.map((block) => [block.key, block]));
+    const spans = spannedBlocks(text).filter((span) => wanted.has(span.key));
+    const lines = text.split('\n');
+    for (const span of [...spans].reverse()) {
+        const replacement = (wanted.get(span.key)?.body ?? '').split('\n');
+        lines.splice(span.from, span.to - span.from, ...replacement);
+    }
+    return lines.join('\n');
+}
+function appendBlocks(text, blocks) {
+    const kept = text
+        .split('\n')
+        .filter((line) => line.trim() !== '[]')
+        .join('\n')
+        .replace(/\s+$/, '');
+    let out = kept === '' ? '' : `${kept}\n`;
+    for (const block of blocks)
+        out += `\n${block.body}\n`;
+    return out;
+}
+export function mergeBlocks(ownText, incoming, overwrite) {
+    const own = patchBlocks(ownText);
+    const mine = new Set(own.map((block) => block.key));
+    const written = [];
+    const skipped = [];
+    const take = [];
+    for (const block of incoming) {
+        if (!mine.has(block.key) || overwrite.has(block.key)) {
+            take.push(block);
+            written.push(block.id);
+            continue;
+        }
+        skipped.push(block.id);
+    }
+    if (take.length === 0)
+        return { ok: true, text: ownText, written, skipped };
+    const replaced = replaceBlocks(ownText, take.filter((block) => mine.has(block.key)));
+    const text = appendBlocks(replaced, take.filter((block) => !mine.has(block.key)));
+    const check = patchBlocks(text);
+    const expected = new Set([...mine, ...take.map((block) => block.key)]);
+    if (check.length !== expected.size || new Set(check.map((block) => block.key)).size !== expected.size) {
+        return { ok: false, reason: '写入前的自检没过：行的 id 会重复或丢行' };
+    }
+    return { ok: true, text, written, skipped };
+}
+export function readPatchBlocks(path) {
+    try {
+        const text = readFileSync(path, 'utf8');
+        return { ok: true, text, blocks: patchBlocks(text) };
+    }
+    catch (error) {
+        return { ok: false, reason: error instanceof Error ? error.message : String(error) };
+    }
+}
+function patchMode(path) {
+    try {
+        return statSync(path).mode & 0o777;
+    }
+    catch {
+        return 0o644;
+    }
+}
+export function writePatchFile(path, text) {
+    const mode = patchMode(path);
+    const tmp = `${path}.wb-sync-${String(process.pid)}`;
+    writeFileSync(tmp, text, { mode });
+    try {
+        renameSync(tmp, path);
+    }
+    catch (error) {
+        try {
+            unlinkSync(tmp);
+        }
+        catch {
+            throw error;
+        }
+        throw error;
+    }
+}
+export function configSyncHandler(deps) {
+    return (search) => ({ ok: true, ...configSyncSnapshot(deps, search.get('source') ?? undefined) });
+}
+function textOf(value) {
+    return typeof value === 'string' ? value : '';
+}
+function profileDependencies(dir) {
+    try {
+        const manifest = JSON.parse(readFileSync(join(dir, 'package.json'), 'utf8'));
+        return new Set(Object.keys(manifest.dependencies ?? {}));
+    }
+    catch {
+        return new Set();
+    }
+}
+function profileNames(profilesDir) {
+    try {
+        return readdirSync(profilesDir, { withFileTypes: true })
+            .filter((entry) => entry.isDirectory() || entry.isSymbolicLink())
+            .map((entry) => entry.name)
+            .filter((name) => existsSync(join(profilesDir, name, 'package.json')))
+            .sort((a, b) => a.localeCompare(b));
+    }
+    catch {
+        return [];
+    }
+}
+export function configSyncSnapshot(deps, asked) {
+    const profilesDir = join(deps.home, 'profiles');
+    const names = profileNames(profilesDir);
+    const others = names.filter((name) => name !== deps.self);
+    const base = {
+        self: deps.self,
+        home: deps.home,
+    };
+    if (deps.profileDir === null) {
+        return { ...base, source: '', profiles: [], rows: [], emptyProviders: false, reason: '拿不到当前 profile 目录' };
+    }
+    const own = readPatchBlocks(join(deps.profileDir, 'cordis.patch.yml'));
+    const emptyProviders = own.ok && !own.blocks.some((block) => block.key.startsWith('id:llm-'));
+    const ownBlocks = own.ok ? own.blocks : [];
+    const profiles = others.map((name) => {
+        const read = readPatchBlocks(join(profilesDir, name, 'cordis.patch.yml'));
+        const assetsFor = (block) => assetsOf(block, join(profilesDir, name), deps.profileDir ?? '');
+        const blocks = read.ok
+            ? read.blocks
+                .filter((block) => !ISOLATION_IDS.has(block.id))
+                .map((block) => ({ ...block, body: rewriteForTarget(block.body, deps.self) }))
+            : [];
+        return {
+            name,
+            readable: read.ok,
+            candidates: read.ok ? syncRows(blocks, ownBlocks, () => [], assetsFor).length : 0,
+        };
+    });
+    if (others.length === 0) {
+        return {
+            ...base,
+            source: '',
+            profiles,
+            rows: [],
+            emptyProviders,
+            reason: '这台机器上只有当前这个 profile，没有可同步的来源',
+        };
+    }
+    const source = others.includes(asked ?? '') ? (asked ?? '') : others.includes('web') ? 'web' : (others[0] ?? '');
+    const sourceDir = join(profilesDir, source);
+    const read = readPatchBlocks(join(sourceDir, 'cordis.patch.yml'));
+    if (!read.ok) {
+        return { ...base, source, profiles, rows: [], emptyProviders, reason: read.reason };
+    }
+    if (!own.ok) {
+        return { ...base, source, profiles, rows: [], emptyProviders, reason: own.reason };
+    }
+    const declared = profileDependencies(sourceDir);
+    const modulesDir = join(deps.profileDir, 'node_modules');
+    const assetsFor = (block) => assetsOf(block, sourceDir, deps.profileDir ?? '');
+    const sourceBlocks = read.blocks
+        .filter((block) => !ISOLATION_IDS.has(block.id))
+        .map((block) => ({ ...block, body: rewriteForTarget(block.body, deps.self) }));
+    const rows = syncRows(sourceBlocks, own.blocks, (block) => block.names.filter((name) => declared.has(name) && !existsSync(join(modulesDir, name))), assetsFor);
+    return { ...base, source, profiles, rows, emptyProviders };
+}
+export async function configSyncApply(deps, payload) {
+    if (deps.profileDir === null)
+        return { ok: false, text: '拿不到当前 profile 目录，这次没写任何东西' };
+    const body = typeof payload === 'object' && payload !== null ? payload : {};
+    const source = textOf(body['source']);
+    const keys = new Set((Array.isArray(body['keys']) ? body['keys'] : []).map((item) => textOf(item)).filter((item) => item !== ''));
+    const overwrite = new Set((Array.isArray(body['overwrite']) ? body['overwrite'] : []).map((item) => textOf(item)));
+    const assetKeys = new Set((Array.isArray(body['assets']) ? body['assets'] : []).map((item) => textOf(item)).filter((item) => item !== ''));
+    const overwriteAssets = new Set((Array.isArray(body['overwriteAssets']) ? body['overwriteAssets'] : []).map((item) => textOf(item)));
+    if (source === '' || (keys.size === 0 && assetKeys.size === 0)) {
+        return { ok: false, text: '没说清从哪个 profile 搬哪几行' };
+    }
+    const profilesDir = join(deps.home, 'profiles');
+    if (!profileNames(profilesDir).includes(source))
+        return { ok: false, text: `没有这个 profile：${source}` };
+    if (source === deps.self)
+        return { ok: false, text: '来源不能是工作台自己' };
+    const sourceDir = join(profilesDir, source);
+    const read = readPatchBlocks(join(sourceDir, 'cordis.patch.yml'));
+    if (!read.ok)
+        return { ok: false, text: `读不到 ${source} 的配置：${read.reason}` };
+    const own = readPatchBlocks(join(deps.profileDir, 'cordis.patch.yml'));
+    if (!own.ok)
+        return { ok: false, text: `读不到工作台自己的配置：${own.reason}` };
+    const picked = read.blocks
+        .filter((block) => keys.has(block.key) && !ISOLATION_IDS.has(block.id))
+        .map((block) => ({ ...block, body: rewriteForTarget(block.body, deps.self) }));
+    if (keys.size > 0 && picked.length === 0) {
+        return { ok: false, text: '选中的行在来源里已经找不到了，重新读一遍再试' };
+    }
+    const available = assetMapOf(read.blocks, sourceDir, deps.profileDir);
+    const pickedAssets = [];
+    for (const key of assetKeys) {
+        const asset = available.get(key);
+        if (asset === undefined)
+            return { ok: false, text: '选中的文件在来源里已经找不到了，重新读一遍再试' };
+        pickedAssets.push(asset);
+    }
+    const merged = mergeBlocks(own.text, picked, overwrite);
+    if (!merged.ok)
+        return { ok: false, text: merged.reason };
+    const planned = planCopies(pickedAssets, sourceDir, deps.profileDir, overwriteAssets);
+    if (!planned.ok)
+        return { ok: false, text: planned.text };
+    const patchPath = join(deps.profileDir, 'cordis.patch.yml');
+    let copied = null;
+    if (planned.plans.length > 0) {
+        const outcome = copyPlans(planned.plans);
+        if (!outcome.ok) {
+            cleanupFiles(outcome.created, outcome.backups);
+            return { ok: false, text: outcome.text };
+        }
+        copied = { files: outcome.files, created: outcome.created, backups: outcome.backups };
+    }
+    const patchChanged = merged.text !== own.text;
+    try {
+        if (patchChanged)
+            writePatchFile(patchPath, merged.text);
+    }
+    catch (error) {
+        if (copied !== null)
+            cleanupFiles(copied.created, copied.backups);
+        return { ok: false, text: `写不进去：${error instanceof Error ? error.message : String(error)}` };
+    }
+    if (deps.reconcile === undefined) {
+        return {
+            ok: true,
+            written: merged.written,
+            skipped: merged.skipped,
+            files: copied?.files ?? [],
+            verified: false,
+        };
+    }
+    try {
+        const verified = await deps.reconcile();
+        if (verified === false) {
+            return {
+                ok: true,
+                written: merged.written,
+                skipped: merged.skipped,
+                files: copied?.files ?? [],
+                verified: false,
+            };
+        }
+    }
+    catch (error) {
+        if (patchChanged) {
+            try {
+                writePatchFile(patchPath, own.text);
+            }
+            catch {
+                if (copied !== null)
+                    cleanupFiles(copied.created, copied.backups);
+                return { ok: false, text: `写进去了，但启动检查没通过：${error instanceof Error ? error.message : String(error)}。原来的设置没能恢复，手动检查一下` };
+            }
+        }
+        if (copied !== null)
+            cleanupFiles(copied.created, copied.backups);
+        try {
+            await deps.reconcile();
+        }
+        catch {
+            return { ok: false, text: `写进去了，但启动检查没通过：${error instanceof Error ? error.message : String(error)}。已恢复原来的设置` };
+        }
+        return { ok: false, text: `写进去了，但启动检查没通过：${error instanceof Error ? error.message : String(error)}。已恢复原来的设置` };
+    }
+    return {
+        ok: true,
+        written: merged.written,
+        skipped: merged.skipped,
+        files: copied?.files ?? [],
+        verified: true,
+    };
+}
+export function configSyncAction(deps) {
+    return {
+        resource: CONFIG_SYNC_RESOURCE,
+        handle: (payload) => configSyncApply(deps, payload),
+    };
+}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export * from './config-sync.js';
+export * from './profile-registries.js';
+export * from './profile-create.js';
+export * from './config-sync-assets.js';
+export * from './release.js';

package/dist/index.js

@@ -0,0 +1,5 @@
+export * from './config-sync.js';
+export * from './profile-registries.js';
+export * from './profile-create.js';
+export * from './config-sync-assets.js';
+export * from './release.js';

package/dist/profile-create.d.ts

@@ -0,0 +1,18 @@
+import type { PostResource, RouteHandler } from '@dsh-workbench/shared/host';
+import type { ProfileCreateApplied, ProfileCreateSnapshot } from '@dsh-workbench/shared/contract/protocol/profile-create';
+export interface ProfileCreateDeps {
+    readonly home: string;
+    readonly self: string;
+    readonly packageRoot: string;
+    readonly runSetup?: ((env: Readonly<Record<string, string>>) => Promise<{
+        ok: boolean;
+        log: string;
+    }>) | undefined;
+}
+export declare function profileCreateSnapshot(deps: ProfileCreateDeps): ProfileCreateSnapshot;
+export declare function profileCreateHandler(deps: ProfileCreateDeps): RouteHandler;
+export declare function profileCreateApply(deps: ProfileCreateDeps, payload: unknown): Promise<ProfileCreateApplied | {
+    ok: false;
+    text: string;
+}>;
+export declare function profileCreateAction(deps: ProfileCreateDeps): PostResource;

package/dist/profile-create.js

@@ -0,0 +1,165 @@
+import { existsSync, readFileSync, readdirSync, rmSync } from 'node:fs';
+import { join, resolve, sep } from 'node:path';
+import { execa } from 'execa';
+import { quoteShellArg } from '@dsh-workbench/shared/host';
+import { PROFILE_CREATE_RESOURCE } from '@dsh-workbench/shared/contract/protocol/profile-create';
+const PROFILE_NAME = /^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$/;
+const BUNDLE = '@dsh-workbench/core';
+const SETUP_TIMEOUT_MS = 10 * 60 * 1000;
+function textOf(value) {
+    return typeof value === 'string' ? value : '';
+}
+function profileNames(profilesDir) {
+    try {
+        return readdirSync(profilesDir, { withFileTypes: true })
+            .filter((entry) => entry.isDirectory() || entry.isSymbolicLink())
+            .map((entry) => entry.name)
+            .filter((name) => existsSync(join(profilesDir, name, 'package.json')))
+            .sort((a, b) => a.localeCompare(b));
+    }
+    catch {
+        return [];
+    }
+}
+export function profileCreateSnapshot(deps) {
+    const profiles = profileNames(join(deps.home, 'profiles')).map((name) => ({
+        name,
+        current: name === deps.self,
+        readable: true,
+    }));
+    return { current: deps.self, profiles };
+}
+export function profileCreateHandler(deps) {
+    return () => ({ ok: true, ...profileCreateSnapshot(deps) });
+}
+function inside(base, path) {
+    const root = resolve(base);
+    const target = resolve(path);
+    return target === root ? false : target.startsWith(`${root}${sep}`);
+}
+async function defaultRunSetup(packageRoot, env) {
+    const bin = join(packageRoot, 'bin', 'dsh-workbench');
+    let log = '';
+    const collect = (chunk) => {
+        log = `${log}${chunk.toString('utf8')}`.slice(-20_000);
+    };
+    try {
+        const child = execa('bash', [bin, 'setup'], {
+            cwd: packageRoot,
+            env: { ...process.env, ...env },
+            stdio: ['ignore', 'pipe', 'pipe'],
+            timeout: SETUP_TIMEOUT_MS,
+            reject: false,
+            windowsHide: true,
+        });
+        child.stdout?.on('data', collect);
+        child.stderr?.on('data', collect);
+        const result = await child;
+        if (result.timedOut)
+            return { ok: false, log: `${log}\n创建超时` };
+        return { ok: result.exitCode === 0, log };
+    }
+    catch (error) {
+        return { ok: false, log: `${log}\n${error instanceof Error ? error.message : String(error)}` };
+    }
+}
+export async function profileCreateApply(deps, payload) {
+    const body = typeof payload === 'object' && payload !== null ? payload : {};
+    const profile = textOf(body['profile']).trim();
+    const source = textOf(body['source']).trim();
+    const copy = typeof body['copy'] === 'object' && body['copy'] !== null ? body['copy'] : {};
+    const flags = {
+        settings: copy['settings'] === true,
+        plugins: copy['plugins'] === true,
+        projects: copy['projects'] === true,
+        sessions: copy['sessions'] === true,
+    };
+    if (!PROFILE_NAME.test(profile))
+        return { ok: false, text: '新工作台的名字不合法：只用字母、数字、点、下划线或短横线' };
+    if (source === '')
+        return { ok: false, text: '先选一个来源 profile' };
+    if (source === profile)
+        return { ok: false, text: '来源不能是新工作台自己' };
+    const profilesDir = join(deps.home, 'profiles');
+    if (!profileNames(profilesDir).includes(source))
+        return { ok: false, text: `没有这个 profile：${source}` };
+    if (existsSync(join(profilesDir, profile)))
+        return { ok: false, text: `已经有一个叫 ${profile} 的 profile` };
+    const targetHome = join(deps.home, profile);
+    if (existsSync(targetHome))
+        return { ok: false, text: `数据目录已经存在：${targetHome}` };
+    const sourceCandidate = join(deps.home, source);
+    const sourcePatch = (() => {
+        try {
+            return readFileSync(join(profilesDir, source, 'cordis.patch.yml'), 'utf8');
+        }
+        catch {
+            return '';
+        }
+    })();
+    const sourceHasIsolation = /id:\s*session-persistence-jsonl/.test(sourcePatch);
+    const sourceHome = !sourceHasIsolation
+        ? deps.home
+        : sourcePatch.includes('DSH_WORKBENCH_HOME') && source !== 'workbench'
+            ? sourceCandidate
+            : join(deps.home, 'workbench');
+    const env = {
+        DSH_HOME: deps.home,
+        DSH_WORKBENCH_HOME: targetHome,
+        WORKBENCH_PROFILE: profile,
+        WORKBENCH_SOURCE_PROFILE: source,
+        WB_CLONE: '1',
+        WB_SOURCE_HOME: sourceHome,
+        WB_COPY_SETTINGS: flags.settings ? '1' : '0',
+        WB_COPY_PLUGINS: flags.plugins ? '1' : '0',
+        WB_COPY_PROJECTS: flags.projects ? '1' : '0',
+        WB_COPY_SESSIONS: flags.sessions ? '1' : '0',
+    };
+    const setup = deps.runSetup ?? ((next) => defaultRunSetup(deps.packageRoot, next));
+    const cleanup = () => {
+        try {
+            if (inside(profilesDir, join(profilesDir, profile)))
+                rmSync(join(profilesDir, profile), { recursive: true, force: true });
+            if (inside(deps.home, targetHome))
+                rmSync(targetHome, { recursive: true, force: true });
+        }
+        catch {
+            return;
+        }
+    };
+    const result = await setup(env);
+    if (!result.ok) {
+        cleanup();
+        return { ok: false, text: `创建失败：${result.log.trim().slice(-1200) || 'setup 没给出原因'}` };
+    }
+    try {
+        const manifest = JSON.parse(readFileSync(join(profilesDir, profile, 'package.json'), 'utf8'));
+        const bundles = manifest.dsh?.profile?.bundles;
+        if (!Array.isArray(bundles) || !bundles.includes(BUNDLE)) {
+            cleanup();
+            return { ok: false, text: 'profile 建好了，但工作台 bundle 没被选中；先跑一次 setup 修好它' };
+        }
+    }
+    catch (error) {
+        cleanup();
+        return { ok: false, text: `profile 建好了，但读不了清单：${error instanceof Error ? error.message : String(error)}` };
+    }
+    const copied = Object.entries(flags)
+        .filter(([, on]) => on)
+        .map(([name]) => name);
+    const bin = join(deps.packageRoot, 'bin', 'dsh-workbench');
+    return {
+        ok: true,
+        profile,
+        source,
+        home: targetHome,
+        command: `WORKBENCH_PROFILE=${quoteShellArg(profile)} ${quoteShellArg(bin)}`,
+        copied,
+    };
+}
+export function profileCreateAction(deps) {
+    return {
+        resource: PROFILE_CREATE_RESOURCE,
+        handle: (payload) => profileCreateApply(deps, payload),
+    };
+}

package/dist/profile-registries.d.ts

@@ -0,0 +1,30 @@
+export interface BundleChange {
+    readonly pkg?: string;
+    readonly registry?: string;
+    readonly application?: string;
+    readonly packageResult?: {
+        readonly kind?: string;
+        readonly output?: string;
+    };
+    readonly errorDetail?: string;
+}
+export interface RegistryEntry {
+    readonly scope: string;
+    readonly registry: string;
+}
+export interface RegistryNotebook {
+    sources(): readonly RegistryEntry[];
+    remember(entries: readonly RegistryEntry[]): readonly string[];
+}
+export declare const REGISTRY_MARKER = "# dsh-workbench \u5199\u7684\uFF1A\u8FD9\u4E00\u884C\u7684\u5305\u53EA\u5728\u8FD9\u4E2A\u6E90\u4E0A\uFF08dsh \u5378\u8F7D\u6CA1\u6709\u6E90\u53C2\u6570\uFF0Cpnpm \u5F97\u95EE\u5F97\u5230\uFF09";
+export declare function scopeOf(pkg: string): string | null;
+export declare function normalizeRegistry(url: string): string;
+export declare function sameRegistry(a: string | null | undefined, b: string | null | undefined): boolean;
+export declare function sourcesFromLockfile(text: string): readonly RegistryEntry[];
+export interface RegistryConfigMerge {
+    readonly text: string;
+    readonly added: readonly string[];
+}
+export declare function mergeRegistryConfig(text: string, entries: readonly RegistryEntry[]): RegistryConfigMerge;
+export declare function registryFailure(change: BundleChange): boolean;
+export declare function createRegistryNotebook(dir: string | null): RegistryNotebook;

package/dist/profile-registries.js

@@ -0,0 +1,124 @@
+import fs from 'node:fs';
+import path from 'node:path';
+export const REGISTRY_MARKER = '# dsh-workbench 写的：这一行的包只在这个源上（dsh 卸载没有源参数，pnpm 得问得到）';
+export function scopeOf(pkg) {
+    const slash = pkg.indexOf('/');
+    return pkg.startsWith('@') && slash > 1 ? pkg.slice(0, slash) : null;
+}
+export function normalizeRegistry(url) {
+    const trimmed = url.trim();
+    return trimmed.endsWith('/') ? trimmed : `${trimmed}/`;
+}
+export function sameRegistry(a, b) {
+    if (a === null || a === undefined || b === null || b === undefined)
+        return false;
+    if (a.trim() === '' || b.trim() === '')
+        return false;
+    return normalizeRegistry(a) === normalizeRegistry(b);
+}
+function registryRootOf(name, tarball) {
+    const at = tarball.indexOf(`/${name}/-/`);
+    if (at > 0)
+        return normalizeRegistry(tarball.slice(0, at));
+    try {
+        return normalizeRegistry(new URL(tarball).origin);
+    }
+    catch {
+        return null;
+    }
+}
+const PACKAGE_KEY = /^ {2}'?(\S+)'?:\s*$/;
+const PACKAGE_NAME = /^(?:@[^/\s]+\/)?[^/\s@]+$/;
+const TARBALL = /tarball:\s*(\S+?)\}?\s*$/;
+export function sourcesFromLockfile(text) {
+    const found = new Map();
+    let name = null;
+    for (const line of text.split('\n')) {
+        const key = PACKAGE_KEY.exec(line);
+        if (key !== null) {
+            const raw = key[1] ?? '';
+            const at = raw.lastIndexOf('@');
+            const candidate = at > 0 ? raw.slice(0, at) : '';
+            name = PACKAGE_NAME.test(candidate) ? candidate : null;
+            continue;
+        }
+        if (name === null)
+            continue;
+        const tarball = TARBALL.exec(line);
+        if (tarball === null)
+            continue;
+        const scope = scopeOf(name);
+        const root = registryRootOf(name, tarball[1] ?? '');
+        name = null;
+        if (scope === null || root === null)
+            continue;
+        const seen = found.get(scope);
+        if (seen === undefined)
+            found.set(scope, root);
+        else if (!sameRegistry(seen, root))
+            found.set(scope, null);
+    }
+    return [...found.entries()]
+        .filter((entry) => entry[1] !== null)
+        .map(([scope, registry]) => ({ scope, registry }));
+}
+export function mergeRegistryConfig(text, entries) {
+    const lines = text.split('\n');
+    const present = (key) => lines.some((line) => line.trim().startsWith(`${key}=`));
+    const appended = [];
+    const added = [];
+    for (const entry of entries) {
+        const key = `${entry.scope}:registry`;
+        if (entry.registry.trim() === '' || present(key))
+            continue;
+        lines.push(`${key}=${normalizeRegistry(entry.registry)}`);
+        appended.push(`${key}=${normalizeRegistry(entry.registry)}`);
+        added.push(key);
+    }
+    if (appended.length === 0)
+        return { text, added: [] };
+    const base = text === '' ? '' : text.endsWith('\n') ? text : `${text}\n`;
+    const marker = base.includes(REGISTRY_MARKER) ? '' : `${REGISTRY_MARKER}\n`;
+    return { text: `${base}${marker}${appended.join('\n')}\n`, added };
+}
+export function registryFailure(change) {
+    if (change.application !== 'failed')
+        return false;
+    if (change.packageResult?.kind === 'not-found')
+        return true;
+    const output = change.packageResult?.output ?? change.errorDetail ?? '';
+    return /ERR_PNPM_[A-Z_]*FETCH/.test(output);
+}
+export function createRegistryNotebook(dir) {
+    return {
+        sources() {
+            if (dir === null)
+                return [];
+            try {
+                return sourcesFromLockfile(fs.readFileSync(path.join(dir, 'pnpm-lock.yaml'), 'utf8'));
+            }
+            catch {
+                return [];
+            }
+        },
+        remember(entries) {
+            if (dir === null || entries.length === 0)
+                return [];
+            const file = path.join(dir, '.npmrc');
+            let before;
+            try {
+                before = fs.readFileSync(file, 'utf8');
+            }
+            catch {
+                before = '';
+            }
+            const merged = mergeRegistryConfig(before, entries);
+            if (merged.added.length === 0)
+                return [];
+            const temp = `${file}.dsh-workbench.tmp`;
+            fs.writeFileSync(temp, merged.text, { mode: 0o600 });
+            fs.renameSync(temp, file);
+            return merged.added;
+        },
+    };
+}

package/dist/release.d.ts

@@ -0,0 +1,24 @@
+import type { DshShell } from '@dsh-workbench/shared';
+import type { PluginRelease } from '@dsh-workbench/shared';
+export declare function parseLedgerVersion(stdout: string, name: string): string | undefined;
+export declare function compareVersions(a: string, b: string): number | undefined;
+export { isNewerVersion } from '@dsh-workbench/shared/host';
+export declare function latestVersion(options: {
+    shell: DshShell;
+    name: string;
+    registry: string;
+    force?: boolean;
+}): Promise<string | undefined>;
+export declare function missingReleaseParts(options: {
+    shell: DshShell;
+    registry: string;
+    version: string;
+    force?: boolean;
+}): Promise<readonly string[]>;
+export declare function probeRelease(options: {
+    shell: DshShell;
+    package: string;
+    registry?: string | undefined;
+    force?: boolean;
+}): Promise<PluginRelease | undefined>;
+export declare function resetReleaseCache(): void;

package/dist/release.js

@@ -0,0 +1,91 @@
+import { RELEASE_SIBLINGS, VERSION_CHECK_TIMEOUT_MS, VERSION_CHECK_TTL_MS, } from '@dsh-workbench/shared/host';
+import { parseJsonLoose, quoteShellArg } from '@dsh-workbench/shared/host';
+import { npmCacheDir, vendorPrefix } from '@dsh-workbench/adapter-runtime';
+import { runShell } from '@dsh-workbench/shared/host';
+export function parseLedgerVersion(stdout, name) {
+    const parsed = parseJsonLoose(stdout);
+    if (typeof parsed !== "object" || parsed === null)
+        return undefined;
+    const entry = parsed
+        .dependencies?.[name];
+    if (typeof entry !== "object" || entry === null)
+        return undefined;
+    const version = entry.version;
+    return typeof version === "string" && /^\d+\.\d+\.\d+/.test(version.trim())
+        ? version.trim()
+        : undefined;
+}
+export function compareVersions(a, b) {
+    const na = a.split(".").map((part) => Number.parseInt(part, 10));
+    const nb = b.split(".").map((part) => Number.parseInt(part, 10));
+    if (na.some(Number.isNaN) || nb.some(Number.isNaN))
+        return undefined;
+    for (let index = 0; index < Math.max(na.length, nb.length); index += 1) {
+        const left = na[index] ?? 0;
+        const right = nb[index] ?? 0;
+        if (left !== right)
+            return left > right ? 1 : -1;
+    }
+    return 0;
+}
+export { isNewerVersion } from '@dsh-workbench/shared/host';
+function parseVersion(stdout) {
+    const value = stdout.trim();
+    return /^\d+\.\d+\.\d+[^\s]*$/.test(value) ? value : undefined;
+}
+const latestCache = new Map();
+export async function latestVersion(options) {
+    const { shell, name, registry, force = false } = options;
+    const key = `${registry}|${name}`;
+    const hit = latestCache.get(key);
+    if (!force && hit !== undefined && Date.now() - hit.at < VERSION_CHECK_TTL_MS)
+        return hit.value;
+    const result = await runShell(shell, `npm view ${quoteShellArg(name)} version --registry ${quoteShellArg(registry)} --cache ${quoteShellArg(npmCacheDir())}`, { timeoutMs: VERSION_CHECK_TIMEOUT_MS }).catch(() => undefined);
+    const value = result?.exitCode === 0 ? parseVersion(result.stdout) : undefined;
+    latestCache.set(key, { at: Date.now(), value });
+    return value;
+}
+const existsCache = new Map();
+async function versionExists(options) {
+    const { shell, name, version, registry, force = false } = options;
+    const key = `${registry}|${name}@${version}`;
+    const hit = existsCache.get(key);
+    if (!force && hit !== undefined && (hit.value || Date.now() - hit.at < VERSION_CHECK_TTL_MS))
+        return hit.value;
+    const result = await runShell(shell, `npm view ${quoteShellArg(`${name}@${version}`)} version --registry ${quoteShellArg(registry)} --cache ${quoteShellArg(npmCacheDir())}`, { timeoutMs: VERSION_CHECK_TIMEOUT_MS }).catch(() => undefined);
+    const value = result?.exitCode === 0 && parseVersion(result.stdout) !== undefined;
+    existsCache.set(key, { at: Date.now(), value });
+    return value;
+}
+export async function missingReleaseParts(options) {
+    const { shell, registry, version, force = false } = options;
+    const missing = [];
+    for (const name of RELEASE_SIBLINGS) {
+        if (!(await versionExists({ shell, name, version, registry, force })))
+            missing.push(name);
+    }
+    return missing;
+}
+export async function probeRelease(options) {
+    const { shell, package: pkg, registry, force = false } = options;
+    if (pkg === "")
+        return undefined;
+    const ledger = await runShell(shell, `npm ls --prefix ${quoteShellArg(vendorPrefix())} ${quoteShellArg(pkg)} --json --depth=0 --cache ${quoteShellArg(npmCacheDir())}`, { timeoutMs: VERSION_CHECK_TIMEOUT_MS }).catch(() => undefined);
+    const installed = ledger === undefined ? undefined : parseLedgerVersion(ledger.stdout, pkg);
+    if (installed === undefined)
+        return undefined;
+    const source = registry === undefined || registry.trim() === ""
+        ? undefined
+        : registry.trim();
+    const latest = source === undefined
+        ? undefined
+        : await latestVersion({ shell, name: pkg, registry: source, force });
+    return {
+        installed,
+        ...(latest === undefined ? {} : { latest }),
+    };
+}
+export function resetReleaseCache() {
+    latestCache.clear();
+    existsCache.clear();
+}

package/package.json

@@ -1,6 +1,45 @@
 {
   "name": "@dsh-workbench/adapter-profile",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "1.0.0-beta.0",
+  "description": "Workbench profile adapter package.",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/novaeth/dsh-workbench.git",
+    "directory": "packages/adapter-profile"
+  },
+  "devDependencies": {
+    "@types/node": "^24.19.0",
+    "@types/proper-lockfile": "^4.1.4",
+    "@types/write-file-atomic": "^4.0.3",
+    "vitest": "^5.0.2",
+    "@vitest/coverage-v8": "^5.0.2"
+  },
+  "dependencies": {
+    "execa": "^10.2.0",
+    "proper-lockfile": "^4.1.2",
+    "write-file-atomic": "^8.0.0",
+    "@dsh-workbench/adapter-runtime": "1.0.0-beta.0",
+    "@dsh-workbench/shared": "1.0.0-beta.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run --testTimeout=20000",
+    "arch": "arch-guard",
+    "check:runtimes": "node ../../scripts/check-adapter-package.mjs --runtime",
+    "coverage": "vitest run --coverage --coverage.reporter=text-summary --testTimeout=20000"
+  }
 }