@dsh-workbench/adapters-default 0.0.0-stage → 1.0.0-beta.1

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,32 @@
-# Temporary Holding Version
+# @dsh-workbench/adapters-default
 
-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.
+工作台默认适配器集。
+
+## 职责
+
+- 把四个实现包组成一个普通依赖集，暴露六个逻辑适配器 id
+- 让 `@dsh-workbench/core` 只依赖本包，就能获得默认行为
+- 不把适配器变成独立 dsh 插件，也不需要用户额外 enable
+
+## 入口
+
+```ts
+import { DEFAULT_ADAPTERS } from '@dsh-workbench/adapters-default';
+```
+
+## 默认集合
+
+```text
+opencli · browser · supply · profile · probe · data
+```
+
+## 边界
+
+四个实现包都是本包的普通 `dependencies`，不是 optional，也不是 peer；逻辑适配器仍是 opencli / browser / supply / profile / probe / data。
+
+## 验证
+
+```bash
+pnpm --filter @dsh-workbench/adapters-default run build
+pnpm --filter @dsh-workbench/adapters-default run test
+```

package/dist/adapter-set.d.ts

@@ -0,0 +1,11 @@
+import type { DshHostContext, DshShell } from '@dsh-workbench/shared';
+import type { AdapterSet } from '@dsh-workbench/shared/host';
+export declare const DEFAULT_ADAPTER_SET_ID = "@dsh-workbench/adapters-default";
+export interface DefaultAdapterSetOptions {
+    readonly shell?: DshShell | undefined;
+    readonly logger?: {
+        info?(message: string): void;
+        warn?(message: string): void;
+    } | undefined;
+}
+export declare function createAdapterSet(ctx: DshHostContext, options?: DefaultAdapterSetOptions): AdapterSet;

package/dist/adapter-set.js

@@ -0,0 +1,45 @@
+import { ADAPTER_SET_API_VERSION, runningVersionOf } from '@dsh-workbench/shared/host';
+import { createCommandReader, createDataReader, createGitReader, createLibReader, opencliCommandOf } from '@dsh-workbench/adapter-runtime';
+import { dshPluginsHandler, profileDirOf } from '@dsh-workbench/adapter-supply';
+import { readSelfUpdateView } from '@dsh-workbench/adapter-probe';
+import { createHostActions } from './host-actions.js';
+import { createPluginSurface } from './plugin-surface.js';
+import { createProbePort } from './probe-port.js';
+import { createRuntimePort } from './runtime-port.js';
+import { createSupplyPort } from './supply-port.js';
+export const DEFAULT_ADAPTER_SET_ID = '@dsh-workbench/adapters-default';
+export function createAdapterSet(ctx, options = {}) {
+    const shell = options.shell ?? ctx.get('shell');
+    const logger = options.logger ?? ctx.logger;
+    const runtime = createRuntimePort();
+    const opencli = opencliCommandOf(ctx);
+    const supply = createSupplyPort();
+    return {
+        apiVersion: ADAPTER_SET_API_VERSION,
+        id: DEFAULT_ADAPTER_SET_ID,
+        version: runningVersionOf(import.meta.url) ?? '0.0.0',
+        data: createDataReader({ shell, command: opencli.command }),
+        libs: createLibReader(),
+        ...(shell === undefined
+            ? {}
+            : {
+                git: createGitReader({ shell, ...(logger === undefined ? {} : { logger }) }),
+                commands: createCommandReader({ shell }),
+            }),
+        supply,
+        modules: supply,
+        profile: {
+            dirOf: profileDirOf,
+            dshPlugins: dshPluginsHandler,
+            selfUpdateView: readSelfUpdateView,
+        },
+        probe: createProbePort(),
+        runtime,
+        plugins: createPluginSurface({
+            shell,
+            command: opencli.command,
+            ...(logger === undefined ? {} : { logger }),
+        }),
+        actions: createHostActions(),
+    };
+}

package/dist/host-actions.d.ts

@@ -0,0 +1,2 @@
+import type { HostActions } from '@dsh-workbench/shared/host';
+export declare function createHostActions(): HostActions;

package/dist/host-actions.js

@@ -0,0 +1,4 @@
+import { configSyncAction, configSyncHandler, profileCreateAction, profileCreateHandler, } from '@dsh-workbench/adapter-profile';
+export function createHostActions() {
+    return { configSyncAction, configSyncHandler, profileCreateAction, profileCreateHandler };
+}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export * from '@dsh-workbench/adapter-runtime';
+export * from '@dsh-workbench/adapter-supply';
+export * from '@dsh-workbench/adapter-profile';
+export * from '@dsh-workbench/adapter-probe';
+export interface AdapterDescriptor {
+    readonly id: 'opencli' | 'browser' | 'supply' | 'profile' | 'probe' | 'data';
+    readonly runtime: 'host';
+}
+export declare const DEFAULT_ADAPTERS: readonly AdapterDescriptor[];
+export { createSupplyPort } from './supply-port.js';
+export { createAdapterSet, DEFAULT_ADAPTER_SET_ID } from './adapter-set.js';

package/dist/index.js

@@ -0,0 +1,14 @@
+export * from '@dsh-workbench/adapter-runtime';
+export * from '@dsh-workbench/adapter-supply';
+export * from '@dsh-workbench/adapter-profile';
+export * from '@dsh-workbench/adapter-probe';
+export const DEFAULT_ADAPTERS = Object.freeze([
+    Object.freeze({ id: 'opencli', runtime: 'host' }),
+    Object.freeze({ id: 'browser', runtime: 'host' }),
+    Object.freeze({ id: 'supply', runtime: 'host' }),
+    Object.freeze({ id: 'profile', runtime: 'host' }),
+    Object.freeze({ id: 'probe', runtime: 'host' }),
+    Object.freeze({ id: 'data', runtime: 'host' }),
+]);
+export { createSupplyPort } from './supply-port.js';
+export { createAdapterSet, DEFAULT_ADAPTER_SET_ID } from './adapter-set.js';

package/dist/plugin-surface.d.ts

@@ -0,0 +1,10 @@
+import type { DshShell } from '@dsh-workbench/shared';
+import type { PluginSurface } from '@dsh-workbench/shared/host';
+export declare function createPluginSurface(options: {
+    readonly shell?: DshShell | undefined;
+    readonly command: string;
+    readonly logger?: {
+        info?(message: string): void;
+        warn?(message: string): void;
+    } | undefined;
+}): PluginSurface;

package/dist/plugin-surface.js

@@ -0,0 +1,22 @@
+import { createOpencli } from '@dsh-workbench/adapter-runtime';
+import { createDeclarationLookup, createPluginCatalog, createPluginUnits, } from '@dsh-workbench/adapter-supply';
+export function createPluginSurface(options) {
+    return {
+        declarationLookup: createDeclarationLookup,
+        createUnits(input) {
+            const shell = options.shell;
+            if (shell === undefined)
+                throw new Error('没有 shell 服务，插件的命令面起不来。');
+            const catalog = createPluginCatalog({ shell, command: options.command });
+            return createPluginUnits({
+                registry: input.registry,
+                catalog,
+                rows: input.rows,
+                declared: input.declared,
+                opencliFor: (plugin) => createOpencli({ shell, plugin, command: options.command, logger: options.logger }),
+                ...(input.toolNames === undefined ? {} : { toolNames: input.toolNames }),
+                ...(input.logger === undefined ? {} : { logger: input.logger }),
+            });
+        },
+    };
+}

package/dist/probe-port.d.ts

@@ -0,0 +1,2 @@
+import type { ProbePort } from '@dsh-workbench/shared/host';
+export declare function createProbePort(): ProbePort;

package/dist/probe-port.js

@@ -0,0 +1,5 @@
+import { probeUnits, registerPreflight } from '@dsh-workbench/adapter-probe';
+import { declaredPluginCommands } from '@dsh-workbench/adapter-supply';
+export function createProbePort() {
+    return { probeUnits, registerPreflight, declaredPluginCommands };
+}

package/dist/runtime-port.d.ts

@@ -0,0 +1,2 @@
+import type { RuntimePort } from '@dsh-workbench/shared/host';
+export declare function createRuntimePort(): RuntimePort;

package/dist/runtime-port.js

@@ -0,0 +1,32 @@
+import { existsSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { opencliCommandOf } from '@dsh-workbench/adapter-runtime';
+import { isInstalledCopy, packageRootOf, prependPath, runDetached, runtimeSeedPaths, runtimeSeedRootOf, seedRuntimeFiles, seedWorkbenchToolchain, warnUnwritableRoot, workshopSeedPlan, } from '@dsh-workbench/adapter-probe';
+export function createRuntimePort() {
+    return {
+        packageRoot: packageRootOf,
+        opencliCommand: opencliCommandOf,
+        warnUnwritableRoot,
+        seed(ctx, options) {
+            const root = runtimeSeedRootOf(ctx);
+            if (root === null)
+                return;
+            const home = dirname(root);
+            const packageRoot = packageRootOf(options.corePackageUrl);
+            const paths = runtimeSeedPaths(root);
+            const log = options.log;
+            for (const file of seedRuntimeFiles({ root, home, packageRoot, log }))
+                log(`自举写下 ${file}`);
+            if (prependPath(paths.entryDir))
+                log(`PATH 前插 ${paths.entryDir}`);
+            seedWorkbenchToolchain(root, log);
+            const plan = workshopSeedPlan(packageRoot, home, root);
+            runDetached(plan.entry, log);
+            const workshopReady = existsSync(paths.workshopManifest) && existsSync(join(paths.workshop, 'node_modules'));
+            if (isInstalledCopy(packageRoot) && !workshopReady) {
+                log('DIY 工坊骨架不在：后台建起来（第一次会下载依赖，几百 MB）');
+                runDetached(plan.full, log);
+            }
+        },
+    };
+}

package/dist/supply-port.d.ts

@@ -0,0 +1,2 @@
+import type { SupplyPort } from '@dsh-workbench/shared/host';
+export declare function createSupplyPort(): SupplyPort;

package/dist/supply-port.js

@@ -0,0 +1,35 @@
+import { cliCatalogPath, isolatedHome, libInstallCommand, vendorPluginsDir } from '@dsh-workbench/adapter-runtime';
+import { createRegistryNotebook, isNewerVersion, latestVersion, missingReleaseParts, probeRelease } from '@dsh-workbench/adapter-profile';
+import { opencliInstallCommand, startSelfUpdate } from '@dsh-workbench/adapter-probe';
+import { declarationGaps, declarationRefusalOf, moduleDeclarationOf, packageRouteOf, pathDeclarationOf, pluginInstallPlan, profileDirOf, profileModules, readBundleManager, readInstalledModule, readProfilePackage, refusalReason, registryDeclarationOf, resolvePluginSource, splitNpmSpec, } from '@dsh-workbench/adapter-supply';
+export function createSupplyPort() {
+    const port = {
+        isolatedHome,
+        cliCatalogPath,
+        vendorPluginsDir,
+        opencliInstallCommand,
+        profileDirOf,
+        profileModules,
+        readInstalledModule,
+        readProfilePackage,
+        readBundleManager,
+        createRegistryNotebook,
+        declarationGaps,
+        moduleDeclarationOf,
+        registryDeclarationOf,
+        pathDeclarationOf,
+        declarationRefusalOf,
+        refusalReason,
+        latestVersion,
+        missingReleaseParts,
+        isNewerVersion,
+        pluginInstallPlan,
+        packageRouteOf,
+        probeRelease,
+        resolvePluginSource,
+        splitNpmSpec,
+        libInstallCommand,
+        startSelfUpdate,
+    };
+    return { ...port, env: port, modules: port };
+}

package/package.json

@@ -1,6 +1,43 @@
 {
   "name": "@dsh-workbench/adapters-default",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "1.0.0-beta.1",
+  "description": "Default host adapter set installed with @dsh-workbench/core.",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@dsh-workbench/shared": "1.0.0-beta.1",
+    "@dsh-workbench/adapter-probe": "1.0.0-beta.1",
+    "@dsh-workbench/adapter-profile": "1.0.0-beta.1",
+    "@dsh-workbench/adapter-supply": "1.0.0-beta.1",
+    "@dsh-workbench/adapter-runtime": "1.0.0-beta.1"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/novaeth/dsh-workbench.git",
+    "directory": "packages/adapters-default"
+  },
+  "devDependencies": {
+    "@types/node": "^24.19.0",
+    "vitest": "^5.0.2",
+    "@vitest/coverage-v8": "^5.0.2"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run",
+    "arch": "arch-guard",
+    "check:runtimes": "node ../../scripts/check-adapter-package.mjs --runtime",
+    "coverage": "vitest run --coverage --coverage.reporter=text-summary --testTimeout=20000"
+  }
 }