@dsh-workbench/core 1.0.1 → 1.1.1

package/dist/types/app/layouts/market/discover-search.d.ts

@@ -0,0 +1,8 @@
+import type { Translate } from '@dsh-workbench/shared';
+export interface DiscoverSearchProps {
+    readonly t: Translate;
+    readonly value: string;
+    readonly disabled: boolean;
+    readonly onChange: (value: string) => void;
+}
+export declare function DiscoverSearch({ t, value, disabled, onChange }: DiscoverSearchProps): JSX.Element;

package/dist/types/app/layouts/market/discover-sources-dialog.d.ts

@@ -4,6 +4,9 @@ export interface DiscoverSourcesDialogProps {
     readonly t: Translate;
     readonly open: boolean;
     readonly sources: readonly DiscoverSourceRow[];
+    readonly selected: string | null;
+    readonly loading: boolean;
+    readonly slow: boolean;
     readonly problem: {
         readonly id: string;
         readonly detail: string;
@@ -13,5 +16,6 @@ export interface DiscoverSourcesDialogProps {
     readonly onClose: () => void;
     readonly onAdd: (url: string) => void;
     readonly onRemove: (id: string) => void;
+    readonly onSelect: (id: string) => void;
 }
 export declare function DiscoverSourcesDialog(props: DiscoverSourcesDialogProps): JSX.Element;

package/dist/types/app/layouts/market/discover-states.d.ts

@@ -5,6 +5,9 @@ export declare function DiscoverSkeleton({ label }: {
 export declare function DiscoverEmptyText({ text }: {
     readonly text: string;
 }): JSX.Element;
+export declare function DiscoverLoading({ label }: {
+    readonly label: string;
+}): JSX.Element;
 export declare function DiscoverFailure({ t, text, onRetry, }: {
     readonly t: Translate;
     readonly text: string;

package/dist/types/app/layouts/market/use-add-module.d.ts

@@ -38,7 +38,6 @@ export interface AddModuleState {
     removeIt(): void;
 }
 export declare function useAddModule(options: {
-    readonly open: boolean;
     readonly onInstalled: () => void;
     readonly failedText: string;
 }): AddModuleState;

package/dist/types/app/layouts/market/use-discover.d.ts

@@ -19,6 +19,7 @@ export interface DiscoverController {
     readonly locale: string;
     readonly payload: DiscoverPayload | null;
     readonly loading: boolean;
+    readonly slow: boolean;
     readonly failure: string | null;
     readonly sources: DiscoverPayload['sources'];
     readonly selected: string | null;

package/dist/types/app/layouts/rightbar/MarketView.d.ts

@@ -4,11 +4,13 @@ import type { CapabilityMap } from '../../../shared/hooks/use-capabilities';
 import type { MarketFreshness } from './market-freshness';
 import type { InstalledPlugin } from '../../../shared/api/installed-plugins';
 import { type InstalledWorkbenchModule } from './market-rows';
+import type { TitleResolve } from './market-names';
 import type { MarketMock } from './market-mock';
 import type { ModuleUpdateMap } from './market-rows';
 import type { WorkbenchSelfUpdate, WorkbenchVersion } from '../../../kernel/contract/bundle-install';
 export interface MarketViewProps {
     readonly t: Translate;
+    readonly titleOf: TitleResolve;
     readonly manifests: readonly UnitManifest[];
     readonly installable?: ReadonlySet<string> | null | undefined;
     readonly capabilities: CapabilityMap | null;
@@ -28,4 +30,4 @@ export interface MarketViewProps {
     readonly defaults?: readonly string[] | undefined;
     readonly changed?: Readonly<Record<string, number>> | undefined;
 }
-export declare function MarketView({ t, manifests, installable, capabilities, freshness, onChanged, onPending, updates, installed, installedRead, workbench, selfUpdate, plugins, settling, mock, defaults, changed, }: MarketViewProps): JSX.Element;
+export declare function MarketView({ t, titleOf, manifests, installable, capabilities, freshness, onChanged, onPending, updates, installed, installedRead, workbench, selfUpdate, plugins, settling, mock, defaults, changed, }: MarketViewProps): JSX.Element;

package/dist/types/app/layouts/rightbar/market-names.d.ts

@@ -0,0 +1,8 @@
+import type { Translate, UnitTitle } from '@dsh-workbench/shared';
+export type MarketNameMap = ReadonlyMap<string, string>;
+export interface NameSource {
+    readonly unit: string;
+    readonly title?: UnitTitle | undefined;
+}
+export type TitleResolve = (title: UnitTitle | undefined) => string;
+export declare function namesOf(t: Translate, modules: readonly NameSource[], titleOf: TitleResolve): MarketNameMap;

package/dist/types/app/layouts/rightbar/market-row-types.d.ts

@@ -1,15 +1,22 @@
-export type MarketRowAction = 'install' | 'update' | 'update-bundle' | 'remove-bundle' | 'uninstall' | 'update-dependency' | 'update-plugin' | 'uninstall-plugin' | 'update-workbench';
-export type MarketState = 'checking' | 'installed' | 'inactive' | 'unusable' | 'broken' | 'outdated' | 'pending-restart' | 'missing' | 'unchecked' | 'unknown';
+import type { ModuleUpdateBlock } from '../../../kernel/contract/bundle-install';
+export type MarketRowAction = 'install' | 'update' | 'update-bundle' | 'remove-bundle' | 'uninstall' | 'update-dependency' | 'update-plugin' | 'uninstall-plugin' | 'update-workbench' | 'migrate-workbench' | 'dismiss-followup';
+export type MarketState = 'checking' | 'installed' | 'inactive' | 'unusable' | 'broken' | 'outdated' | 'pending-restart' | 'pending-followup' | 'missing' | 'unchecked' | 'unknown';
 export interface MarketNote {
     readonly key: 'panels.market.needEnv' | 'panels.market.noSource' | 'panels.market.badSource' | 'panels.market.needCommands' | 'panels.market.needBinary' | 'panels.market.needLib' | 'panels.market.moduleRefused' | 'panels.market.moduleRestartHint' | 'panels.market.pluginAlsoKnownAs' | 'panels.market.pluginBroken';
     readonly params: Readonly<Record<string, string>>;
     readonly tone?: 'plain' | 'alert';
 }
-export type MarketHintKey = 'panels.market.moduleRestartHint' | 'panels.market.uncheckedHint';
+export type MarketHintKey = 'panels.market.moduleRestartHint' | 'panels.market.uncheckedHint' | 'panels.market.migrationHint' | 'panels.market.updateNeedsWorkbench' | 'panels.market.updateIncompatible';
 export interface ModuleUpdate {
     readonly installed: string;
     readonly latest?: string;
     readonly local?: boolean;
+    readonly blocked?: ModuleUpdateBlock;
+}
+export interface MarketFollowUp {
+    readonly id: string;
+    readonly kind: 'data-migration';
+    readonly hard: boolean;
 }
 export interface MarketRow {
     readonly id: string;
@@ -34,4 +41,5 @@ export interface MarketRow {
     readonly defaultShown?: boolean;
     readonly defaultChanged?: number;
     readonly broken?: boolean;
+    readonly followUp?: MarketFollowUp;
 }

package/dist/types/app/layouts/rightbar/market-rows.d.ts

@@ -1,5 +1,6 @@
-import type { ModuleVersion } from '../../../kernel/contract/bundle-install';
-import type { Translate, UnitManifest } from '@dsh-workbench/shared';
+import type { ModuleUpdateBlock, ModuleVersion } from '../../../kernel/contract/bundle-install';
+import type { Translate, UnitManifest, UnitTitle } from '@dsh-workbench/shared';
+import type { MarketNameMap } from './market-names';
 import type { MarketRow, MarketRowAction, MarketState, ModuleUpdate } from './market-row-types';
 import type { SharedRow } from './market-shared-rows';
 import type { CapabilityMap } from '../../../shared/hooks/use-capabilities';
@@ -14,7 +15,9 @@ export interface InstalledWorkbenchModule {
     readonly unit: string;
     readonly pkg: string;
     readonly installed: string;
+    readonly title?: UnitTitle | undefined;
     readonly latest?: string | undefined;
+    readonly latestBlocked?: ModuleUpdateBlock | undefined;
     readonly local?: boolean | undefined;
     readonly refused?: readonly string[] | undefined;
     readonly clientRefused?: readonly string[] | undefined;
@@ -25,9 +28,8 @@ export declare function withClientRefusals(modules: readonly InstalledWorkbenchM
     readonly reasons: readonly string[];
 }[]): readonly InstalledWorkbenchModule[];
 export declare function refusalReasons(host: readonly string[] | undefined, client: readonly string[] | undefined): readonly string[];
-export declare function mergeTitles(known: ReadonlyMap<string, string>, manifests: readonly UnitManifest[]): ReadonlyMap<string, string>;
 export declare function installedIdSet(installed: readonly InstalledWorkbenchModule[] | undefined): ReadonlySet<string> | null;
-export declare function installedRows(modules: readonly InstalledWorkbenchModule[], manifests: readonly UnitManifest[], listed: ReadonlySet<string>, known?: ReadonlyMap<string, string> | undefined, defaults?: ReadonlySet<string>, changed?: Readonly<Record<string, number>>): MarketRow[];
+export declare function installedRows(modules: readonly InstalledWorkbenchModule[], manifests: readonly UnitManifest[], listed: ReadonlySet<string>, names?: MarketNameMap | undefined, defaults?: ReadonlySet<string>, changed?: Readonly<Record<string, number>>): MarketRow[];
 export declare function marketSwitchLocked(row: MarketRow): boolean;
 export declare function marketActions(row: MarketRow): MarketRowAction[];
 export declare function capabilityOutdated(capabilities: CapabilityMap | null, unit: string): boolean;

package/dist/types/app/layouts/rightbar/market-view-text.d.ts

@@ -1,5 +1,6 @@
-import type { UnitManifest } from '@dsh-workbench/shared';
+import type { Translate } from '@dsh-workbench/shared';
 import type { CapabilityMap } from '../../../shared/hooks/use-capabilities';
+import { type MarketNameMap, type NameSource, type TitleResolve } from './market-names';
 import type { MarketRow, MarketRowAction, ModuleUpdateMap } from './market-rows';
 import type { SharedRow } from './market-shared-rows';
 export declare const PROGRESS_KEY: Readonly<Record<MarketRowAction, string>>;
@@ -32,7 +33,7 @@ export declare function heldIdOf(pending: Pending | null, held: HeldRow | undefi
 export declare function pinnedRowOf(pending: Pending | null, held: HeldRow | undefined): MarketRow | undefined;
 export declare function withPinnedRow(rows: readonly MarketRow[], pinned: MarketRow | undefined): MarketRow[];
 export declare function marketFootVisible(shown: readonly MarketRow[], installed: readonly MarketRow[]): boolean;
-export declare function useMarketTitles(manifests: readonly UnitManifest[], mocked: boolean): ReadonlyMap<string, string>;
+export declare function marketNamesOf(t: Translate, modules: readonly NameSource[], titleOf: TitleResolve, mocked: boolean): MarketNameMap;
 export interface HeldRowControl {
     readonly held: HeldRow | undefined;
     hold(next: HeldRow | undefined): void;
@@ -45,5 +46,5 @@ export declare function pendingRowOf(input: {
     readonly pending: Pending | null;
     readonly removing: string | null;
     readonly rows: readonly MarketRow[];
-    readonly titles: ReadonlyMap<string, string>;
+    readonly names: MarketNameMap;
 }): MarketRow | undefined;

package/dist/types/app/units/unit-titles.d.ts

@@ -0,0 +1,3 @@
+import type { MessagesContribution, UnitManifest } from '@dsh-workbench/shared';
+export declare const UNIT_TITLES_OWNER = "dsh-workbench";
+export declare function unitTitlesOf(manifests: readonly UnitManifest[]): MessagesContribution;

package/dist/types/kernel/contract/bundle-install.d.ts

@@ -1,2 +1,2 @@
 export { BUNDLE_REGISTRIES_ROUTE, BUNDLE_INSPECT_ROUTE, BUNDLE_REGISTRY_DEFAULT, MODULE_VERSIONS_ROUTE, SELF_UPDATE_STATES, RESTART_REASONS } from '@dsh-workbench/shared/contract/protocol/bundle-install';
-export type { BundleRegistry, BundleRegistries, BundleInspectProblem, BundleSpecKind, BundleInspectionAccepted, BundleInspectionRefused, BundleInspectionPlugin, BundleInspection, BundleRegistriesPayload, BundleInspectionPayload, BundleApplication, SelfUpdateState, WorkbenchSelfUpdate, RestartReason, BundleChangeStage, BundleFailureKind, BundlePackageResult, BundleChange, BundleInstallRequest, BundleCancellation, BundleSupplyState, BundleModulePayload, BundleSupplyPayload, BundleInstalledPlugin, BundleInstallPayload, BundleRemovePayload, BundleCancellationPayload, ModuleVersion, WorkbenchVersion, ModuleVersionsPayload } from '@dsh-workbench/shared/contract/protocol/bundle-install';
+export type { BundleRegistry, BundleRegistries, BundleInspectProblem, BundleSpecKind, BundleInspectionAccepted, BundleInspectionRefused, BundleInspectionPlugin, BundleInspection, BundleRegistriesPayload, BundleInspectionPayload, BundleApplication, SelfUpdateState, WorkbenchSelfUpdate, RestartReason, BundleChangeStage, BundleFailureKind, BundlePackageResult, BundleChange, BundleInstallRequest, BundleCancellation, BundleSupplyState, BundleModulePayload, BundleSupplyPayload, BundleInstalledPlugin, BundleInstallPayload, BundleRemovePayload, BundleCancellationPayload, ModuleVersion, ModuleUpdateBlock, WorkbenchVersion, ModuleVersionsPayload } from '@dsh-workbench/shared/contract/protocol/bundle-install';

package/dist/types/kernel/contract/market-index.d.ts

@@ -1,2 +1,2 @@
-export { MARKET_DISCOVER_ROUTE, MARKET_DOC_ROUTE, MARKET_INDEX_FORMAT, MARKET_INDEX_PATH, MARKET_PUBLISH_PREVIEW_ROUTE, MARKET_SOURCES_RESOURCE, MARKET_WORKBENCH_LABEL, } from '@dsh-workbench/shared/contract/protocol/market-index';
+export { MARKET_DISCOVER_ROUTE, MARKET_DOC_ROUTE, MARKET_INDEX_FORMAT, MARKET_INDEX_PATH, MARKET_PUBLISH_PREVIEW_ROUTE, MARKET_SOURCES_RESOURCE, MARKET_SOURCES_ROUTE, MARKET_WORKBENCH_LABEL, } from '@dsh-workbench/shared/contract/protocol/market-index';
 export type { DiscoverCompat, DiscoverDoc, DiscoverDocKind, DiscoverEntry, DiscoverFilter, DiscoverInstallState, DiscoverPayload, DiscoverProblem, DiscoverSourceRow, DiscoverState, DiscoverVersionRow, IndexSourceSpec, MarketIndex, MarketIndexCategory, MarketIndexEngines, MarketIndexEntry, MarketIndexEntryMetadata, MarketIndexGitSource, MarketIndexLabel, MarketIndexMetadata, MarketIndexNpmSource, MarketIndexParse, MarketIndexProblem, MarketIndexProblemKind, MarketIndexSortKey, MarketIndexSource, MarketIndexVersion, MarketLocalizedText, MarketPublishDestination, MarketSourceConfig, MarketSourceKind, MarketSourcePolicy, MarketSourcesAction, MarketSourcesPayload, PublishChangelog, PublishPreview, } from '@dsh-workbench/shared/contract/protocol/market-index';

package/dist/types/modules/panels/model/diy-tools.d.ts

@@ -4,4 +4,4 @@ import type { PublishPreview } from '@dsh-workbench/shared/contract/protocol/mar
 import type { MarketService } from './market';
 import type { PanelsService } from './service';
 export declare const PUBLISH_TIMEOUT_MS: number;
-export declare function registerDiyTools(ctx: DshHostContext, market: MarketService, panels: PanelsService, debug: DebugStore, previewOf?: (unit: string) => PublishPreview | null): Array<() => void>;
+export declare function registerDiyTools(ctx: DshHostContext, market: MarketService, panels: PanelsService, debug: DebugStore, previewOf?: (unit: string) => PublishPreview | null, inferredAuthorOf?: (unit: string) => Promise<string | undefined>): Array<() => void>;

package/dist/types/modules/panels/model/market-dispatch.d.ts

@@ -37,6 +37,14 @@ export type ProvisionResult = {
     readonly ok: true;
     readonly action: 'update-workbench';
     readonly change: BundleChange;
+} | {
+    readonly ok: true;
+    readonly action: 'migrate-workbench';
+    readonly added: number;
+    readonly files: number;
+} | {
+    readonly ok: true;
+    readonly action: 'dismiss-followup';
 } | {
     readonly ok: true;
     readonly action: 'uninstall-plugin';

package/dist/types/modules/panels/model/market-follow-up.d.ts

@@ -0,0 +1,16 @@
+import type { ProfilePackage } from '@dsh-workbench/shared/host';
+import { type MigrationRunInput, type MigrationRunResult } from '../../../shared/api/host/migrate-workbench';
+export interface WorkbenchFollowUpDeps {
+    readonly dshHome: (() => string) | undefined;
+    readonly profileName: (() => string | null) | undefined;
+    readonly workbench: ((pkg: string) => ProfilePackage | undefined) | undefined;
+    readonly runMigration?: ((input: MigrationRunInput) => Promise<MigrationRunResult>) | undefined;
+}
+export interface WorkbenchFollowUpActions {
+    migrateWorkbench(): Promise<{
+        readonly added: number;
+        readonly files: number;
+    }>;
+    dismissFollowUp(id: string): Promise<void>;
+}
+export declare function createWorkbenchFollowUps(deps: WorkbenchFollowUpDeps): WorkbenchFollowUpActions;

package/dist/types/modules/panels/model/market-sources-act.d.ts

@@ -1,7 +1,9 @@
 import type { MarketSourcesAction } from '@dsh-workbench/shared/contract/protocol/market-index';
+import type { RouteTable } from '@dsh-workbench/shared/host';
 import type { MarketSourceInitializer } from '../../../shared/api/host/market-source-init';
 import type { MarketSourcesStore } from '../../../shared/api/host/market-sources-store';
 export declare const MARKET_SOURCES_ACTION_RESOURCE = "market-sources";
+export declare function marketSourcesRoutes(store: MarketSourcesStore): RouteTable;
 export declare function parseMarketSourcesAction(payload: unknown): MarketSourcesAction;
 export declare function marketSourcesAction(store: MarketSourcesStore, init?: MarketSourceInitializer | undefined): {
     readonly resource: string;

package/dist/types/modules/panels/model/market-types.d.ts

@@ -59,6 +59,11 @@ export interface MarketService {
     replaceBundle(spec: string, options?: BundleInstallOptions): Promise<BundleInstallOutcome>;
     updateBundle(unit: string): Promise<BundleInstallOutcome | null>;
     updateWorkbench(pkg: string): Promise<BundleInstallOutcome>;
+    migrateWorkbench(): Promise<{
+        readonly added: number;
+        readonly files: number;
+    }>;
+    dismissFollowUp(id: string): Promise<void>;
     removeBundle(pkg: string): Promise<BundleRemoveOutcome>;
     cancelInstall(requestId: string): Promise<BundleCancellation | null>;
     updatePlugin(pkg: string): Promise<PluginUpdateOutcome>;

package/dist/types/modules/panels/model/market.d.ts

@@ -5,6 +5,7 @@ import type { InstalledModule, ProfileModule, ProfilePackage } from '@dsh-workbe
 import type { RegistryNotebook } from '@dsh-workbench/shared/host';
 import { type SupplyPort, type UnitMountDeps } from '@dsh-workbench/shared/host';
 import type { SelfUpdateRequest, SelfUpdateStart } from '@dsh-workbench/shared/host';
+import { type WorkbenchFollowUpDeps } from './market-follow-up';
 import { type PluginReferences } from './plugin-actions';
 import type { PluginLedger } from './plugin-ledger';
 import type { MarketService } from './market-types';
@@ -29,6 +30,7 @@ export declare function createMarketService(options: {
     dshHome?: (() => string) | undefined;
     profileName?: (() => string | null) | undefined;
     selfUpdate?: ((request: SelfUpdateRequest, onError: (message: string) => void) => SelfUpdateStart) | undefined;
+    runMigration?: WorkbenchFollowUpDeps['runMigration'];
     logger?: {
         info?(message: string): void;
         warn?(message: string): void;

package/dist/types/modules/panels/model/publish-preview-routes.d.ts

@@ -1,2 +1,2 @@
 import type { RouteTable } from '@dsh-workbench/shared/host';
-export declare function publishPreviewRoutes(workshop: string | null): RouteTable;
+export declare function publishPreviewRoutes(workshop: string | null, inferredAuthorOf?: (unit: string) => Promise<string | undefined>): RouteTable;

package/dist/types/shared/api/host/diy-publish-preview.d.ts

@@ -1,4 +1,15 @@
+import type { DshShell } from '@dsh-workbench/shared';
 import type { PublishPreview } from '@dsh-workbench/shared/contract/protocol/market-index';
+export interface PublishModuleFact {
+    readonly dir: string;
+    readonly name: string;
+    readonly author: string;
+}
+export declare function moduleFactOf(root: string | null | undefined, unit: string): PublishModuleFact | null;
+export declare function localGitIdentityOf(shell: DshShell | undefined, dir: string): Promise<string | undefined>;
+export declare function lastCommitAuthorOf(shell: DshShell | undefined, dir: string): Promise<string | undefined>;
+export declare function inferredAuthorOf(root: string | null | undefined, unit: string, shell: DshShell | undefined): Promise<string | undefined>;
 export declare function publishPreviewOf(root: string | null | undefined, unit: string, options?: {
     readonly version?: string | undefined;
+    readonly author?: string | undefined;
 }): PublishPreview | null;

package/dist/types/shared/api/host/follow-up-dismiss.d.ts

@@ -0,0 +1,2 @@
+export declare function isFollowUpDismissed(runtimeRoot: string, id: string): boolean;
+export declare function dismissFollowUp(runtimeRoot: string, id: string): void;

package/dist/types/shared/api/host/migrate-workbench.d.ts

@@ -0,0 +1,20 @@
+export interface MigrationRunInput {
+    readonly script: string;
+    readonly env: Readonly<Record<string, string>>;
+}
+export interface MigrationRunResult {
+    readonly exitCode: number;
+    readonly stdout: string;
+    readonly stderr: string;
+}
+export interface MigrateWorkbenchInput {
+    readonly home: string;
+    readonly profile: string;
+    readonly pkg: string;
+    readonly run: (input: MigrationRunInput) => Promise<MigrationRunResult>;
+}
+export interface MigrateWorkbenchResult {
+    readonly added: number;
+    readonly files: number;
+}
+export declare function migrateWorkbench(input: MigrateWorkbenchInput): Promise<MigrateWorkbenchResult>;

package/dist/types/shared/api/host/migration-follow-up.d.ts

@@ -0,0 +1,12 @@
+export interface MigrationFollowUpInput {
+    readonly home: string;
+    readonly profile: string;
+    readonly runtimeRoot?: string | undefined;
+}
+export declare const MIGRATION_FOLLOW_UP_ID = "data-root-migration";
+export interface WorkbenchMigrationFollowUp {
+    readonly id: typeof MIGRATION_FOLLOW_UP_ID;
+    readonly kind: 'data-migration';
+    readonly hard: false;
+}
+export declare function migrationFollowUp(input: MigrationFollowUpInput): WorkbenchMigrationFollowUp | undefined;

package/dist/types/shared/hooks/market-queries.d.ts

@@ -1,11 +1,12 @@
 import type { ApiResponse } from '@dsh-workbench/shared';
-import { type DiscoverDoc, type DiscoverDocKind, type DiscoverPayload, type PublishPreview } from '../../kernel/contract/market-index';
+import { type DiscoverDoc, type DiscoverDocKind, type DiscoverPayload, type MarketSourcesPayload, type PublishPreview } from '../../kernel/contract/market-index';
 export declare function readMarketDiscover(options?: {
     readonly force?: boolean;
 }): Promise<ApiResponse<DiscoverPayload>>;
+export declare function readMarketSources(): Promise<ApiResponse<MarketSourcesPayload>>;
 export declare function readMarketDoc(name: string, version: string, kind: DiscoverDocKind): Promise<ApiResponse<{
     readonly doc: DiscoverDoc;
 }>>;
-export declare function readPublishPreview(unit: string, version?: string): Promise<ApiResponse<{
+export declare function readPublishPreview(unit: string, version?: string, author?: string): Promise<ApiResponse<{
     readonly preview: PublishPreview | null;
 }>>;

package/dist/types/shared/hooks/resource-view.d.ts

@@ -0,0 +1,14 @@
+import type { ApiError } from '@dsh-workbench/shared';
+export interface ResourceState<T> {
+    readonly phase: 'idle' | 'loading' | 'ready' | 'error';
+    readonly value?: T;
+    readonly error?: ApiError;
+    readonly at?: number;
+}
+export declare const IDLE: ResourceState<never>;
+export declare const LOADING: ResourceState<never>;
+export interface TaggedState<T> {
+    readonly identity: string;
+    readonly state: ResourceState<T>;
+}
+export declare function resourceViewOf<T>(enabled: boolean, current: TaggedState<T>, identity: string): ResourceState<T>;

package/dist/types/shared/hooks/use-api-resource.d.ts

@@ -1,15 +1,11 @@
-import type { ApiError, ApiResponse, Query } from '@dsh-workbench/shared';
+import type { ApiResponse, Query } from '@dsh-workbench/shared';
+import { type ResourceState } from './resource-view';
 /**
  * 一次读的状态：`idle` 没开读 · `loading` 在飞 · `ready` 有值 · `error` 失败；`value` 是 `ApiResponse<T>`、
  * `at` 是拿到这个值的时间戳。**身份没变的重取（如点刷新）进 `loading` 时上一次的 `value` 与 `at` 会留着**
  * —— 界面照旧有得画；身份变了、本来就没值、或读到 `error` 时才没有（那时两者都是 `undefined`）。
  */
-export interface ResourceState<T> {
-    readonly phase: 'idle' | 'loading' | 'ready' | 'error';
-    readonly value?: T;
-    readonly error?: ApiError;
-    readonly at?: number;
-}
+export type { ResourceState } from './resource-view';
 /**
  * 这次读的身份：`route` 加排好序的 `query`（排序是为了同一次读只有一个 key）；给了 `override` 就用它。
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dsh-workbench/core",
-  "version": "1.0.1",
+  "version": "1.1.1",
   "description": "个人工作台：Agent 工作台（左栏 + 常驻对话 + 自研右侧数据面板）。",
   "type": "module",
   "icon": "./icon.svg",
@@ -100,8 +100,8 @@
     "proper-lockfile": "^4.1.2",
     "which": "^7.0.0",
     "write-file-atomic": "^8.0.0",
-    "@dsh-workbench/shared": "1.0.1",
-    "@dsh-workbench/adapters-default": "1.0.1"
+    "@dsh-workbench/shared": "1.1.1",
+    "@dsh-workbench/adapters-default": "1.1.1"
   },
   "license": "MIT",
   "repository": {

package/skills/workbench-module-diy/FAMILY.md

@@ -46,5 +46,5 @@
 ## 4 发布
 
 只在用户明确说「帮我发布」后调；先 `_changelog` 把这一版写进 `CHANGELOG.md`。
-出口、署名、标题、安装命令由工具与审批屏处理，不用问、不用补。
+出口、署名、标题、安装命令由工具与审批屏处理，不用问、不用补；没写作者时审批屏显示推断的署名（市集里上次的 / 同工坊的 / 本机 git 身份），用户觉得不对就拒绝后再说，他点名了才传 `author=…`。
 需要用户接管时返回 `needsUser: { step, text, command? }`：把 `text` 说给用户，等「好了」再跑；不向用户要 token。

package/skills/workbench-module-diy/REVIEW.md

@@ -5,12 +5,12 @@
 | 判据 | 检查 | 修法 |
 |---|---|---|
 | `contracts` | 清单 ↔ 代码 ↔ `design.json` 漂移；dsh 组合期不校验清单 | 按报错改：`unit` 重名换名；`dsh.workbenchFaces` 两个源码入口；六个脚本；`private: true`。`dsh.workbench.tools` 与 `registerTools()` 一致；`design.json` 对键名；生成物过期跑 `sync` |
-| `protocol` | `dsh.workbench` 版本 / 形状 / 多余键（外壳静默忽略生字段） | 补 `"apiVersion": 2`；`unit` / `card` / `tools` / `host` 写全（无卡片 `null`、无工具 `[]`）；删协议外键（`faces` 在 `dsh.workbenchFaces`；不写 `scope`） |
+| `protocol` | `dsh.workbench` 版本 / 形状 / 多余键（外壳静默忽略生字段） | 补 `"apiVersion": 3`；`unit` / `title` / `card` / `tools` / `host` 写全（名字是 `{ zh, en }` 字面量；无卡片 `null`、无工具 `[]`）；删协议外键（`faces` 在 `dsh.workbenchFaces`；不写 `scope`） |
 | `bundles` | 运行时互串：浏览器产物含 node 内置 / 宿主产物含 DOM、react | 不 import 对方那侧 |
 | `source` | 非种子 `@deepseek-ai/*`；宿主碰 dsh 浏览器包；`@/` 指外壳；根入口取运行值；客户端引 `/host`；**手写进程 / PATH / 文件锁 / 状态原子写**（import 首选库放行） | 宿主只用 Node 侧；种子词仅在 client 可达文件；`@/` 只指自己 `src/`；运行值：浏览器 `kit`、宿主 `shared/host`；进程/锁/状态写交给外壳 |
 | `primitives` | 声明 `external` 但产物无物证（原语被内联） | `dsh.client.external` 声明；devDependency 精确版对齐；产物中为 `require(...)` |
 | `kit` | 用了 peer 下限外壳没有的成员（首帧 `Element type is invalid`） | 只用 peer 范围内成员；下限抬到实际使用版 |
-| `cards` | 七种外壳侧输入 × `zh` / `en` 下崩溃 / 空白 / 脏值 | 五态可画；外层 `Card`；`titleKey` 与卡片用到的键双语齐。不断言具体态（归 `plugin.test.ts`） |
+| `cards` | 七种外壳侧输入 × `zh` / `en` 下崩溃 / 空白 / 脏值 | 五态可画；外层 `Card`；卡片自己用到的文案键双语齐（名字走清单 `title`，不再是卡片键）。不断言具体态（归 `plugin.test.ts`） |
 | `standalone` | 依赖工作台源码才能构建 | 不引用工作台源码；`tsconfig.paths` 用相对路径 |
 | `markers` | 私有源 / 私网地址 / 内网域名进入公开包 | 不进包；配置落到模块配置面；组织特有的词表由 `DSH_WB_INTERNAL_MARKERS` 提供 |
 | `alias` | `@/` 指向工作台源码 | `@/` 只指自己 `src/` |

package/skills/workbench-module-diy/SKILL.md

@@ -47,6 +47,7 @@ description: 在工作台里把当前面板调明白，或者给它造一块新
    审批项标注「要你真用一次」，不打勾。结论只报：已装、在面板哪一格。
 8. **发布** —— 只在用户说「帮我发布」之后：`workbench_diy_changelog`（`note=…`）记这一版 → `workbench_diy_publish`（`unit=…`）。
    不手改 `package.json`、不补标题/署名、不问出口：工具与审批屏已经处理；他明确点名安装包 / 公开 / git 才传 target。
+   他说要换作者才传 `author="姓名 <邮箱>"`，别自己编一个；没写作者时审批屏显示推断的署名，他拒绝后再说。
    验收没过先 `design accept`；`needsUser` 照 `text` 转述。细节见 [WIRING.md](WIRING.md) §5。
 
 ## 索引

package/skills/workbench-module-diy/TOOLS.md

@@ -118,7 +118,7 @@
   未知 `kind` 或 `source.kind` 判红；need 里未知字段只警告，`x-` 前缀忽略。
 - 未装好文案由模块写：`libInstallCommand({ need, source })`（`@dsh-workbench/shared/host`）拼好源与缓存目录，
   原样输出；放进失败态。
-- `contracts` 判据：`apiVersion` 必须是 2；`needs` 走同一份 `NEED_KINDS` 注册表校验（`purpose` 必填、
+- `contracts` 判据：`apiVersion` 必须是 3；`needs` 走同一份 `NEED_KINDS` 注册表校验（`purpose` 必填、
   `bin`/`env` 不许带 `sources`、`lib` 只认 npm 源）；声明了 `lib` 必须用 `libInstallCommand`。
   未知 `runtime` 不判红：探针会给「这个运行时工作台还不认识」的 `unchecked`，等运行时 provider 补上。
 

package/skills/workbench-module-diy/WIRING.md

@@ -65,5 +65,7 @@ DIY 族仅在选了 DIY 模式的会话出现（按模式，不按工作区）
 
 1. 先把这一版写进 `CHANGELOG.md`（`workbench_diy_changelog`，`note=…`），真卡片验收过（`design accept`）。
    出口、署名、标题、安装命令都由工具与审批屏处理：不用问、不用补；用户没点名出口就不传 target。
+   用户要换署名（或在审批屏上说作者不对）：传 `author="姓名 <邮箱>"`（或只给姓名），别手改 `package.json`，也别自己编。
+   没写作者时审批屏显示推断的署名；他拒绝后说换成谁，再用 `author` 重发。
 2. 工具回 `needsUser` 时照 `text` 转述，不在对话里要 token / OTP；`otp` 交接后 `verify=true` 只核不发。
-3. 只改市集元数据（标题 / 作者 / 说明）不升版本：`refresh=true`。
+3. 只改市集元数据（标题 / 作者 / 说明）不升版本：`refresh=true`（换作者时同时传 `author`）。

package/skills/workbench-module-diy/WRITES.md

@@ -23,7 +23,7 @@
 
 3. **无现成命令 → 让用户录一次**（你准备，用户执行）：
 
-   - `workbench_diy_record_prepare({ unit, url, doing })`：开窗置前（**需审批一次**：站点、录哪一下、落点、
+   - `workbench_diy_record_prepare({ unit, url, doing })`：开窗置前（**需审批一次**：站点、录哪一下、保存到、
      录完不切回），装浮条。用户：① 开始录制 ② 做一次动作 ③ 结束录制。不要让用户点第二次。
      `url` 必须与模块读源同域（`design.json` 声明过读源时跨域当场拒）。
    - 表填好、提交前，请用户按浮条「截图」：不额外审批；产出整页图 + 页面快照（控件 `name` / `id`、