@dsh-workbench/shared 0.1.16 → 0.1.18

package/dist/api/unit-declaration.d.ts

@@ -0,0 +1,29 @@
+import type { UnitEnvNeeds, UnitHostNeeds, UnitManifest } from './unit.js';
+export declare const WORKBENCH_API_VERSION = 1;
+export declare const SUPPORTED_API_VERSIONS: readonly number[];
+export interface UnitCardDeclaration {
+    readonly titleKey: string;
+    readonly order: number;
+}
+export interface UnitToolDeclaration {
+    readonly name: string;
+    readonly writes: boolean;
+    readonly key?: string;
+}
+export interface UnitDeclaration {
+    readonly apiVersion: number;
+    readonly unit: string;
+    readonly card: UnitCardDeclaration | null;
+    readonly tools: readonly UnitToolDeclaration[];
+    readonly host: UnitHostNeeds;
+    readonly env?: UnitEnvNeeds;
+}
+export declare const DECLARATION_KEYS: readonly string[];
+export declare const DECLARATION_REQUIRED_KEYS: readonly string[];
+export declare function declarationProblemsOf(subject: string, raw: unknown): readonly string[];
+export interface DeclarationRead {
+    readonly declaration?: UnitDeclaration;
+    readonly manifest?: UnitManifest;
+    readonly problems: readonly string[];
+}
+export declare function readDeclaration(subject: string, raw: unknown): DeclarationRead;

package/dist/api/unit-declaration.js

@@ -0,0 +1,189 @@
+export const WORKBENCH_API_VERSION = 1;
+export const SUPPORTED_API_VERSIONS = [WORKBENCH_API_VERSION];
+export const DECLARATION_KEYS = [
+    'apiVersion',
+    'unit',
+    'card',
+    'tools',
+    'host',
+    'env',
+];
+export const DECLARATION_REQUIRED_KEYS = [
+    'apiVersion',
+    'unit',
+    'card',
+    'tools',
+    'host',
+];
+const CARD_KEYS = ['titleKey', 'order'];
+const TOOL_KEYS = ['name', 'writes', 'key'];
+const TOOL_KEY_SHAPE = /^[a-z][a-zA-Z0-9]*$/;
+const HOST_KEYS = ['inject', 'optional'];
+function text(value) {
+    return typeof value === 'string' ? value.trim() : '';
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function outsideKeys(value, allowed) {
+    return Object.keys(value).filter((key) => !allowed.includes(key));
+}
+function listOf(keys) {
+    return keys.map((key) => JSON.stringify(key)).join(' / ');
+}
+function stringArrayProblems(at, value) {
+    if (!Array.isArray(value))
+        return [`${at} 要是一串字符串，现在是 ${JSON.stringify(value)}`];
+    return value.flatMap((item, index) => text(item) === '' ? [`${at}[${index}] 不是非空字符串：${JSON.stringify(item)}`] : []);
+}
+export function declarationProblemsOf(subject, raw) {
+    if (!isRecord(raw))
+        return [`${subject}: dsh.workbench 不是一个对象 —— ${JSON.stringify(raw)}`];
+    const version = raw.apiVersion;
+    if (version === undefined) {
+        return [
+            `${subject}: dsh.workbench 没有 apiVersion —— 协议从 v${WORKBENCH_API_VERSION} 起，` +
+                `写 \`"apiVersion": ${WORKBENCH_API_VERSION}\`。缺它 = 外壳不认这个模块（ADR-0038 §2.3）`,
+        ];
+    }
+    if (!Number.isInteger(version) || !SUPPORTED_API_VERSIONS.includes(version)) {
+        return [
+            `${subject}: dsh.workbench.apiVersion 是 ${JSON.stringify(version)}，这里只认 ` +
+                `${SUPPORTED_API_VERSIONS.join(' / ')}（要整数）`,
+        ];
+    }
+    const problems = [];
+    const unknown = outsideKeys(raw, DECLARATION_KEYS);
+    if (unknown.length > 0) {
+        problems.push(`${subject}: dsh.workbench 里有协议 v${WORKBENCH_API_VERSION} 不认识的键 ${listOf(unknown)} —— ` +
+            `只有 ${listOf(DECLARATION_KEYS)}。（拼错的键会被外壳**静默忽略**：那句声明等于没写）`);
+    }
+    for (const key of DECLARATION_REQUIRED_KEYS) {
+        if (raw[key] === undefined) {
+            problems.push(`${subject}: dsh.workbench 缺 ${key}` +
+                (key === 'card' ? '（这个模块没有卡片就写 `"card": null`）' : ''));
+        }
+    }
+    const card = raw.card;
+    if (card !== undefined && card !== null) {
+        if (!isRecord(card)) {
+            problems.push(`${subject}: dsh.workbench.card 要么是对象、要么是 null，现在是 ${JSON.stringify(card)}`);
+        }
+        else {
+            const extra = outsideKeys(card, CARD_KEYS);
+            if (extra.length > 0) {
+                problems.push(`${subject}: dsh.workbench.card 里有不认的键 ${listOf(extra)} —— card 只有 ${listOf(CARD_KEYS)}` +
+                    `（卡片默认显不显示由运行期的面板配置决定，清单里没有这一位）`);
+            }
+            if (text(card.titleKey) === '') {
+                problems.push(`${subject}: dsh.workbench.card.titleKey 要是非空字符串（面板那一格的文案键）`);
+            }
+            if (typeof card.order !== 'number' || !Number.isFinite(card.order)) {
+                problems.push(`${subject}: dsh.workbench.card.order 要是数字，现在是 ${JSON.stringify(card.order)}`);
+            }
+        }
+    }
+    const tools = raw.tools;
+    if (tools !== undefined) {
+        if (!Array.isArray(tools)) {
+            problems.push(`${subject}: dsh.workbench.tools 要是一串声明，现在是 ${JSON.stringify(tools)}`);
+        }
+        else {
+            const seen = new Set();
+            const seenKeys = new Set();
+            tools.forEach((tool, index) => {
+                const at = `dsh.workbench.tools[${index}]`;
+                if (!isRecord(tool)) {
+                    problems.push(`${subject}: ${at} 要是对象，现在是 ${JSON.stringify(tool)}`);
+                    return;
+                }
+                const extra = outsideKeys(tool, TOOL_KEYS);
+                if (extra.length > 0) {
+                    problems.push(`${subject}: ${at} 里有不认的键 ${listOf(extra)} —— tools 只有 ${listOf(TOOL_KEYS)}`);
+                }
+                const name = text(tool.name);
+                if (name === '') {
+                    problems.push(`${subject}: ${at}.name 要是非空字符串`);
+                }
+                else if (seen.has(name)) {
+                    problems.push(`${subject}: ${at}.name「${name}」与前面那条撞了 —— 工具名会进 dsh 的工具表，不许重`);
+                }
+                else {
+                    seen.add(name);
+                }
+                if (typeof tool.writes !== 'boolean') {
+                    problems.push(`${subject}: ${at}.writes 要是 true / false（它是"这会写"的唯一声明，缺了审批无从认领）`);
+                }
+                if (tool.key !== undefined) {
+                    const key = text(tool.key);
+                    if (!TOOL_KEY_SHAPE.test(key)) {
+                        problems.push(`${subject}: ${at}.key 要是 lowerCamelCase 的标识符（如 \`sync\` / \`podLogs\`），` +
+                            `现在是 ${JSON.stringify(tool.key)} —— 它会变成生成物里的键名，所以不引号、不许带点或横线`);
+                    }
+                    else if (seenKeys.has(key)) {
+                        problems.push(`${subject}: ${at}.key「${key}」与前面那条撞了 —— 生成物里的键只能有一个`);
+                    }
+                    else {
+                        seenKeys.add(key);
+                    }
+                }
+            });
+        }
+    }
+    const host = raw.host;
+    if (host !== undefined) {
+        if (!isRecord(host)) {
+            problems.push(`${subject}: dsh.workbench.host 要是对象，现在是 ${JSON.stringify(host)}`);
+        }
+        else {
+            const extra = outsideKeys(host, HOST_KEYS);
+            if (extra.length > 0) {
+                problems.push(`${subject}: dsh.workbench.host 里有不认的键 ${listOf(extra)} —— host 只有 ${listOf(HOST_KEYS)}`);
+            }
+            if (host.inject === undefined) {
+                problems.push(`${subject}: dsh.workbench.host.inject 没写 —— 它声明这个模块要外壳的哪几个服务，` +
+                    `外壳靠它判"能不能挂"。一个都不要也要写 \`"inject": []\``);
+            }
+            else {
+                problems.push(...stringArrayProblems(`${subject}: dsh.workbench.host.inject`, host.inject));
+            }
+            if (host.optional !== undefined) {
+                problems.push(...stringArrayProblems(`${subject}: dsh.workbench.host.optional`, host.optional));
+            }
+        }
+    }
+    if (raw.env !== undefined && !isRecord(raw.env)) {
+        problems.push(`${subject}: dsh.workbench.env 要是对象（command / plugins / libs）—— ` +
+            `语义由门禁的 env 判据查，这里只查形状`);
+    }
+    return problems;
+}
+export function readDeclaration(subject, raw) {
+    const problems = declarationProblemsOf(subject, raw);
+    if (problems.length > 0)
+        return { problems };
+    const declaration = raw;
+    const card = declaration.card;
+    return {
+        declaration,
+        problems: [],
+        manifest: {
+            id: text(declaration.unit),
+            card: card === null
+                ? null
+                : {
+                    titleKey: text(card.titleKey),
+                    order: card.order,
+                },
+            tools: declaration.tools.map((tool) => ({
+                name: text(tool.name),
+                writes: tool.writes,
+            })),
+            host: {
+                inject: [...(declaration.host.inject ?? [])],
+                ...(declaration.host.optional === undefined ? {} : { optional: [...declaration.host.optional] }),
+            },
+            ...(declaration.env === undefined ? {} : { env: declaration.env }),
+        },
+    };
+}

package/dist/api/unit.d.ts

@@ -1,7 +1,6 @@
 export interface UnitCard {
     readonly titleKey: string;
     readonly order: number;
-    readonly enabledByDefault: boolean;
 }
 export interface UnitTool {
     readonly name: string;
@@ -46,7 +45,6 @@ export interface PluginRelease {
 }
 export interface UnitManifest {
     readonly id: string;
-    readonly kind: 'board' | 'ui';
     readonly card: UnitCard | null;
     readonly tools: readonly UnitTool[];
     readonly host: UnitHostNeeds;

package/dist/api/workbench-contract.d.ts

@@ -1,5 +1,5 @@
 import type { PluginRelease } from '../api/unit.js';
-export type ProvisionAction = 'install' | 'update' | 'uninstall' | 'update-dependency' | 'install-bundle' | 'update-bundle' | 'remove-bundle' | 'cancel-install';
+export type ProvisionAction = 'install' | 'update' | 'uninstall' | 'update-dependency' | 'install-bundle' | 'update-bundle' | 'remove-bundle' | 'cancel-install' | 'update-plugin' | 'uninstall-plugin';
 export interface PluginStatePayload {
     readonly name: string;
     readonly status: 'ok' | 'outdated' | 'missing';

package/dist/components/ApprovalDetail.js

@@ -32,7 +32,7 @@ export function ApprovalDetail(props) {
     const owner = (props.units ?? []).find((face) => face.approval?.tools.includes(input.tool) === true);
     if (owner?.approval !== undefined) {
         const Render = owner.approval.render;
-        return (h(CardBoundary, { unit: owner.manifest.id, resetKey: props.callId ?? '', t: t },
+        return (h(CardBoundary, { unit: owner.unit, resetKey: props.callId ?? '', t: t },
             h(Render, { input: input, t: t })));
     }
     if (command === '')

package/dist/components/board-module.d.ts

@@ -40,12 +40,11 @@ export interface BoardModule {
     readonly id: string;
     readonly titleKey: string;
     readonly order: number;
-    readonly enabledByDefault: boolean;
     readonly View: (props: BoardModuleProps) => ReactNode;
     readonly steps?: Readonly<Record<string, UnitStep>>;
 }
 export interface UnitClientFace {
-    readonly manifest: UnitManifest;
+    readonly unit: string;
     readonly card: (props: BoardModuleProps) => ReactNode;
     readonly steps?: Readonly<Record<string, UnitStep>>;
     readonly messages?: Dictionaries;
@@ -57,6 +56,9 @@ export interface UnitClientFace {
         }) => ReactNode;
     } | undefined;
 }
+export interface UnitOwnedClientFace extends UnitClientFace {
+    readonly manifest: UnitManifest;
+}
 export interface ApprovalInput {
     readonly tool: string;
     readonly args: Readonly<Record<string, unknown>>;

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

@@ -0,0 +1,32 @@
+import type { ModuleStore } from './workspace-store.js';
+export declare const PLUGIN_LEDGER_FILE = "plugins.json";
+export interface PluginLedgerEntry {
+    readonly opencliHome: string;
+    readonly package: string;
+    readonly name?: string;
+    readonly registry?: string;
+    readonly local?: boolean;
+    readonly installedAt: string;
+    readonly releasedAt?: string;
+}
+export declare function ledgerKeyOf(entry: {
+    readonly opencliHome: string;
+    readonly package: string;
+}): string;
+export declare function parsePluginLedger(raw: unknown): PluginLedgerEntry[];
+export declare function readPluginLedger(store: ModuleStore): PluginLedgerEntry[];
+export declare function writePluginLedger(store: ModuleStore, entries: readonly PluginLedgerEntry[]): void;
+export declare function pluginEntriesOfHome(entries: readonly PluginLedgerEntry[], opencliHome: string): PluginLedgerEntry[];
+export declare function isHeldEntry(entry: PluginLedgerEntry): boolean;
+export declare function heldEntriesOfHome(entries: readonly PluginLedgerEntry[], opencliHome: string): PluginLedgerEntry[];
+export declare function heldEntryOfPlugin(entries: readonly PluginLedgerEntry[], opencliHome: string, plugin: string): PluginLedgerEntry | undefined;
+export declare function withReleasedEntry(entries: readonly PluginLedgerEntry[], opencliHome: string, pkg: string, releasedAt: string): PluginLedgerEntry[];
+export type PluginRetention = 'remove' | 'keep-held' | 'keep-claimed' | 'keep-unsure';
+export declare function pluginRetentionOf(options: {
+    readonly held: boolean;
+    readonly claimedBy: readonly string[];
+    readonly trustworthy: boolean;
+}): PluginRetention;
+export declare function pluginEntryOf(entries: readonly PluginLedgerEntry[], opencliHome: string, pkg: string): PluginLedgerEntry | undefined;
+export declare function withPluginEntry(entries: readonly PluginLedgerEntry[], entry: PluginLedgerEntry): PluginLedgerEntry[];
+export declare function withoutPluginEntry(entries: readonly PluginLedgerEntry[], opencliHome: string, pkg: string): PluginLedgerEntry[];

package/dist/host/plugin-ledger.js

@@ -0,0 +1,99 @@
+export const PLUGIN_LEDGER_FILE = 'plugins.json';
+export function ledgerKeyOf(entry) {
+    return `${entry.opencliHome}\u0000${entry.package}`;
+}
+function textOf(value) {
+    if (typeof value !== 'string')
+        return undefined;
+    const trimmed = value.trim();
+    return trimmed === '' ? undefined : trimmed;
+}
+function entryOf(value) {
+    if (typeof value !== 'object' || value === null)
+        return undefined;
+    const box = value;
+    const opencliHome = textOf(box['opencliHome']);
+    const pkg = textOf(box['package']);
+    const installedAt = textOf(box['installedAt']);
+    if (opencliHome === undefined || pkg === undefined || installedAt === undefined)
+        return undefined;
+    const name = textOf(box['name']);
+    const registry = textOf(box['registry']);
+    const releasedAt = textOf(box['releasedAt']);
+    return {
+        opencliHome,
+        package: pkg,
+        installedAt,
+        ...(name === undefined ? {} : { name }),
+        ...(registry === undefined ? {} : { registry }),
+        ...(releasedAt === undefined ? {} : { releasedAt }),
+        ...(box['local'] === true ? { local: true } : {}),
+    };
+}
+export function parsePluginLedger(raw) {
+    if (typeof raw !== 'object' || raw === null)
+        return [];
+    const list = raw['entries'];
+    if (!Array.isArray(list))
+        return [];
+    const entries = [];
+    for (const item of list) {
+        const entry = entryOf(item);
+        if (entry === undefined)
+            continue;
+        if (entries.some((known) => ledgerKeyOf(known) === ledgerKeyOf(entry)))
+            continue;
+        entries.push(entry);
+    }
+    return entries;
+}
+export function readPluginLedger(store) {
+    return parsePluginLedger(store.read(PLUGIN_LEDGER_FILE));
+}
+export function writePluginLedger(store, entries) {
+    if (entries.length === 0) {
+        store.remove(PLUGIN_LEDGER_FILE);
+        return;
+    }
+    store.write(PLUGIN_LEDGER_FILE, { entries });
+}
+export function pluginEntriesOfHome(entries, opencliHome) {
+    return entries.filter((entry) => entry.opencliHome === opencliHome);
+}
+export function isHeldEntry(entry) {
+    return entry.releasedAt === undefined;
+}
+export function heldEntriesOfHome(entries, opencliHome) {
+    return pluginEntriesOfHome(entries, opencliHome).filter(isHeldEntry);
+}
+export function heldEntryOfPlugin(entries, opencliHome, plugin) {
+    const key = plugin.trim();
+    if (key === '')
+        return undefined;
+    return heldEntriesOfHome(entries, opencliHome).find((entry) => entry.name === key || entry.package === key);
+}
+export function withReleasedEntry(entries, opencliHome, pkg, releasedAt) {
+    const entry = pluginEntryOf(entries, opencliHome, pkg);
+    if (entry === undefined || entry.releasedAt !== undefined)
+        return [...entries];
+    return withPluginEntry(entries, { ...entry, releasedAt });
+}
+export function pluginRetentionOf(options) {
+    if (options.held)
+        return 'keep-held';
+    if (!options.trustworthy)
+        return 'keep-unsure';
+    return options.claimedBy.length > 0 ? 'keep-claimed' : 'remove';
+}
+export function pluginEntryOf(entries, opencliHome, pkg) {
+    const key = ledgerKeyOf({ opencliHome, package: pkg });
+    return entries.find((entry) => ledgerKeyOf(entry) === key);
+}
+export function withPluginEntry(entries, entry) {
+    const key = ledgerKeyOf(entry);
+    return [...entries.filter((item) => ledgerKeyOf(item) !== key), entry];
+}
+export function withoutPluginEntry(entries, opencliHome, pkg) {
+    const key = ledgerKeyOf({ opencliHome, package: pkg });
+    return entries.filter((entry) => ledgerKeyOf(entry) !== key);
+}

package/dist/host/provision.d.ts

@@ -1,6 +1,6 @@
 import type { ProvisionAction } from '../api/workbench-contract.js';
 export type { ProvisionAction };
-export declare const PROVISION_ACTIONS: readonly ["install", "update", "uninstall", "install-bundle", "update-bundle", "remove-bundle", "cancel-install", "update-dependency"];
+export declare const PROVISION_ACTIONS: readonly ["install", "update", "uninstall", "install-bundle", "update-bundle", "remove-bundle", "cancel-install", "update-dependency", "update-plugin", "uninstall-plugin"];
 export declare const DEPENDENCY_ACTIONS: readonly ["update-dependency"];
 export declare function isDependencyAction(action: ProvisionAction): action is (typeof DEPENDENCY_ACTIONS)[number];
 export type ProvisionTarget = 'unit' | 'id' | 'spec' | 'name' | 'requestId';

package/dist/host/provision.js

@@ -7,6 +7,8 @@ export const PROVISION_ACTIONS = [
     'remove-bundle',
     'cancel-install',
     'update-dependency',
+    'update-plugin',
+    'uninstall-plugin',
 ];
 export const DEPENDENCY_ACTIONS = ['update-dependency'];
 export function isDependencyAction(action) {
@@ -21,6 +23,8 @@ export function provisionTargetOf(action) {
         return 'spec';
     if (action === 'remove-bundle')
         return 'name';
+    if (action === 'update-plugin' || action === 'uninstall-plugin')
+        return 'name';
     if (action === 'cancel-install')
         return 'requestId';
     return 'unit';
@@ -48,6 +52,8 @@ function requestOf(action, value) {
         return { action, spec: value };
     if (action === 'remove-bundle')
         return { action, name: value };
+    if (action === 'update-plugin' || action === 'uninstall-plugin')
+        return { action, name: value };
     if (action === 'cancel-install')
         return { action, requestId: value };
     return { action, unit: value };

package/dist/host/unit-face.d.ts

@@ -8,12 +8,14 @@ import type { ApprovalCall, ApprovalFacts, ApprovalPolicy } from '../host/tool-a
 import type { ValueHandoff } from '../host/value-handoff.js';
 import type { WorkspaceStore } from '../host/workspace-store.js';
 export interface UnitMountDeps {
+    readonly manifest: UnitManifest;
     readonly ctx: DshHostContext;
     readonly logger?: {
         info?(message: string): void;
         warn?(message: string): void;
     } | undefined;
     readonly manifests: () => readonly UnitManifest[];
+    readonly ownedUnits: () => readonly string[];
     readonly opencliCommand?: string;
     readonly store: WorkspaceStore;
     readonly values?: ValueHandoff | undefined;
@@ -61,7 +63,10 @@ export interface UnitMountResult {
     readonly approvalDetail?: ((call: ApprovalCall) => ApprovalFacts | undefined | Promise<ApprovalFacts | undefined>) | undefined;
     readonly needsApproval?: ApprovalPolicy | undefined;
 }
-export interface UnitHostFace {
-    readonly manifest: UnitManifest;
+export interface UnitModuleFace {
+    readonly unit: string;
     mount(deps: UnitMountDeps): UnitMountResult;
 }
+export interface UnitOwnedFace extends UnitModuleFace {
+    readonly manifest: UnitManifest;
+}

package/dist/host.d.ts

@@ -1,6 +1,7 @@
 export * from './config/constants.js';
 export * from './api/context-ref.js';
 export * from './api/unit.js';
+export * from './api/unit-declaration.js';
 export * from './api/facts.js';
 export * from './api/long-task.js';
 export * from './lib/text.js';
@@ -16,6 +17,7 @@ export * from './host/http.js';
 export * from './host/long-task.js';
 export * from './host/opencli-runtime.js';
 export * from './host/opencli.js';
+export * from './host/plugin-ledger.js';
 export * from './host/plugin-source.js';
 export * from './host/provision.js';
 export * from './host/shell.js';

package/dist/host.js

@@ -1,6 +1,7 @@
 export * from './config/constants.js';
 export * from './api/context-ref.js';
 export * from './api/unit.js';
+export * from './api/unit-declaration.js';
 export * from './api/facts.js';
 export * from './api/long-task.js';
 export * from './lib/text.js';
@@ -16,6 +17,7 @@ export * from './host/http.js';
 export * from './host/long-task.js';
 export * from './host/opencli-runtime.js';
 export * from './host/opencli.js';
+export * from './host/plugin-ledger.js';
 export * from './host/plugin-source.js';
 export * from './host/provision.js';
 export * from './host/shell.js';

package/dist/i18n/en.js

@@ -65,7 +65,7 @@ export const en = {
     'panels.market.missing': 'not installed',
     'panels.market.unchecked': 'unknown',
     'panels.market.checking': 'checking',
-    'panels.market.sectionInstalled': 'Installed',
+    'panels.market.sectionInstalled': 'Installed modules',
     'panels.market.sectionPending': 'Not installed',
     'panels.market.sectionShared': 'Shared dependencies',
     'panels.market.sharedUsedBy': 'Used by {modules}',
@@ -93,11 +93,19 @@ export const en = {
     'panels.market.noSource': 'This module declares no install method — install it yourself',
     'panels.market.badSource': 'The install method is incomplete — install it yourself',
     'panels.market.empty': 'No modules available',
-    'panels.market.installedSection': 'Installed',
-    'panels.market.sectionLocal': 'Linked locally',
+    'panels.market.sectionLocal': 'Local modules',
     'panels.market.sectionUnlisted': 'Not from the market',
+    'panels.market.sectionPlugins': 'Installed opencli plugins',
     'panels.market.moduleOutdated': 'update available',
+    'panels.market.moduleRefused': 'This module was built for an older version of the workbench, so it does not work here. Update it, or uninstall.',
+    'panels.market.moduleRefusedDetail': 'Why it cannot be used: {reason}',
     'panels.market.moduleRestartHint': 'installed but not active — restart dsh once to bring it up',
+    'panels.market.pluginKeptInUse': 'Files kept for now: {names} still uses it.',
+    'panels.market.pluginKeptUnsure': 'Files kept for now: some modules on this machine do not say what they use, so it is unclear who needs it.',
+    'panels.market.pluginKeptHeld': 'Files kept: this one is yours, and a module letting go will not remove it.',
+    'panels.market.pluginKeptUnnamed': 'Files kept for now: this one cannot be identified as a plugin, so it is unclear who needs it.',
+    'panels.market.pluginAlsoKnownAs': 'Its package is {pkg} (updates and uninstall use that)',
+    'panels.market.pluginBroken': 'This install is broken: it cannot be identified as a plugin. Uninstall it, or install it again by package name above.',
     'panels.market.restartNeeded': 'The new version is installed — restart once to pick it up.',
     'panels.market.foot': 'After installing, enable it in the panel page of that project.',
     'panels.market.recheck': 'Check for updates',
@@ -145,7 +153,11 @@ export const en = {
     'panels.market.add.problemInstalled': 'This module is already installed',
     'panels.market.add.problemNotFound': 'No such module found',
     'panels.market.add.problemNotPackage': 'That path does not exist or is not a valid module package',
-    'panels.market.add.problemNotBundle': 'This package declares no bundle, so it cannot be installed as a module: {reason}',
+    'panels.market.add.problemNotBundle': 'This package cannot be installed here: {reason}. If it is actually an opencli plugin, use its package name (for example opencli-plugin-cmdb) or a local folder — a git URL or tarball does not reveal what it is.',
+    'panels.market.add.problemNotWorkbenchModule': 'This package does not match the workbench you are running, so installing it would not work. Pick another version, or ask the module author.',
+    'panels.market.add.problemNotModuleOrPlugin': 'This package is neither a workbench module nor an opencli plugin, so installing it would do nothing. Pick another version, or ask the package author.',
+    'panels.market.add.failureNotModuleOrPlugin': 'This package is neither a workbench module nor an opencli plugin, so installing it would do nothing',
+    'panels.market.add.installedPlugin': 'Installed: the opencli plugin {name}',
     'panels.market.add.problemNetwork': 'Cannot reach the module source; check the network and retry',
     'panels.market.add.problemUnknown': 'Cannot fetch module information: {reason}',
     'panels.market.add.failureNetwork': 'The network connection failed',
@@ -176,6 +188,7 @@ export const en = {
     'panels.market.add.registryPnpm': "pnpm's own registry",
     'panels.market.add.check': 'Check',
     'panels.market.add.checking': 'Checking…',
+    'panels.market.add.classifying': 'Working out what it is…',
     'panels.market.add.change': 'Edit',
     'panels.market.add.previewTitle': 'About to install',
     'panels.market.add.fieldName': 'Package',