@dsh-plugin-hub/dsh-plugin 0.1.4 → 0.3.0

package/README.md

@@ -1,11 +1,11 @@
 # @dsh-plugin-hub/dsh-plugin
 
 Agent-facing DSH tools for planning, sharing, applying, and rolling back
-reproducible [DSH Plugin Hub](https://dshpluginhub.ai) Profiles.
+reproducible [DSH Plugin Hub](https://dshpluginhub.ai) Presets.
 
 - Website: [dshpluginhub.ai](https://dshpluginhub.ai)
 - Browse plugins: [dshpluginhub.ai/plugins](https://dshpluginhub.ai/plugins)
-- Explore Profiles: [dshpluginhub.ai/profiles](https://dshpluginhub.ai/profiles)
+- Explore Presets: [dshpluginhub.ai/profiles](https://dshpluginhub.ai/profiles)
 
 Install into a Profile:
 
@@ -13,9 +13,16 @@ Install into a Profile:
 dsh plugin --profile web add @dsh-plugin-hub/dsh-plugin
 ```
 
-The bundle exposes five DSH tools backed by the local `dsh-hub` CLI:
+The bundle exposes read-only discovery and diagnosis tools plus confirmed plan
+application, all backed by the local `dsh-hub` CLI:
 
+- `dsh_hub_search` searches the live catalog.
+- `dsh_hub_plugin_info` reviews exact versions, compatibility and security.
+- `dsh_hub_plugin_plan` creates an exact, preconditioned Plugin install plan.
 - `dsh_hub_profile_plan` creates a read-only, expiring install plan.
+- `dsh_hub_profile_diff` compares Plugin membership, order, versions, sources, and Release identity.
+- `dsh_hub_profile_upgrade_plan` plans an upgrade and returns its full diff.
+- `dsh_hub_profile_doctor` diagnoses local state and release drift.
 - `dsh_hub_profile_share_plan` captures an exact, read-only publication plan.
 - `dsh_hub_profile_rollback_plan` selects a complete recoverable revision.
 - `dsh_hub_operation_apply` applies that plan after explicit confirmation.
@@ -25,6 +32,16 @@ Every machine-triggered mutation uses an expiring, single-use, preconditioned
 plan and the same staging, validation, atomic switch and rollback implementation
 as direct CLI use.
 
+## Telemetry
+
+This adapter does not add a separate telemetry client. Commands it invokes use
+the installed `dsh-hub` CLI preference. On the CLI's first run a notice is
+shown and that run sends no event; later eligible install and Preset lifecycle
+operations report anonymous aggregates unless the user runs `dsh-hub telemetry
+off` or uses one of the documented per-invocation opt-outs. See the
+[`@dsh-plugin-hub/cli` README](https://github.com/pax-beehive/dsh-hub-cli/tree/main/packages/cli#anonymous-cli-telemetry) for the
+exact fields, retention period, debug mode, and controls.
+
 Requires Node.js 22.13 or later, `@deepseek-ai/cordis`, and
 `@deepseek-ai/dsh-tools`.
 

package/index.js

@@ -32,13 +32,57 @@ const output = {
 }
 
 export function apply(ctx) {
+  ctx.tools.register(defineTool({
+    name: 'dsh_hub_search',
+    description: 'Search the live DSH Plugin Hub catalog by name, capability, or natural-language need. This is read-only.',
+    parameters: {
+      query: { type: 'string', required: true, description: 'Plugin name, capability, or task to search for.' },
+    },
+    output,
+    async execute(args, exec) {
+      const events = await run(['search', args.query, '--json'], exec.signal)
+      return events[0] ?? { items: [] }
+    },
+  }))
+
+  ctx.tools.register(defineTool({
+    name: 'dsh_hub_plugin_info',
+    description: 'Inspect one Plugin, its exact selected version, source, compatibility, and published security assessment. This is read-only.',
+    parameters: {
+      packageName: { type: 'string', required: true, description: 'Exact npm package name.' },
+      version: { type: 'string', description: 'Exact version, tag, or range (default latest).' },
+    },
+    output,
+    async execute(args, exec) {
+      const values = ['info', args.packageName, '--version', args.version ?? 'latest', '--json']
+      const events = await run(values, exec.signal)
+      return events[0] ?? {}
+    },
+  }))
+
+  ctx.tools.register(defineTool({
+    name: 'dsh_hub_plugin_plan',
+    description: 'Create a non-mutating, exact and preconditioned plan to install one reviewed Plugin. Present the source, security assessment, target Profile, and exact version before applying it.',
+    parameters: {
+      packageName: { type: 'string', required: true, description: 'Exact npm package name.' },
+      profile: { type: 'string', description: 'Local target Profile name (default web).' },
+      version: { type: 'string', description: 'Exact version, tag, or range (default latest).' },
+    },
+    output,
+    async execute(args, exec) {
+      const values = ['install', args.packageName, '--profile', args.profile ?? 'web', '--version', args.version ?? 'latest', '--plan', '--json']
+      const events = await run(values, exec.signal)
+      return events[0] ?? {}
+    },
+  }))
+
   ctx.tools.register(defineTool({
     name: 'dsh_hub_profile_plan',
-    description: 'Create a non-mutating, exact and preconditioned plan to install or upgrade a public DSH Hub Profile. Present the plan to the user before applying it.',
+    description: 'Create a non-mutating, exact and preconditioned plan to install or upgrade a public DSH Hub Preset. Present the plan to the user before applying it.',
     parameters: {
-      slug: { type: 'string', required: true, description: 'Hub Profile slug.' },
+      slug: { type: 'string', required: true, description: 'Hub Preset slug.' },
       profile: { type: 'string', description: 'Local target Profile name (default web).' },
-      version: { type: 'string', description: 'Profile Release version (default latest).' },
+      version: { type: 'string', description: 'Preset Release version (default latest).' },
     },
     output,
     async execute(args, exec) {
@@ -48,9 +92,63 @@ export function apply(ctx) {
     },
   }))
 
+  ctx.tools.register(defineTool({
+    name: 'dsh_hub_profile_diff',
+    description: 'Compare the current local Profile lock with a public Hub Release, including additions, removals, load-order changes, versions, and immutable sources. This is read-only.',
+    parameters: {
+      slug: { type: 'string', description: 'Hub Preset slug; defaults to the installed Hub Preset.' },
+      profile: { type: 'string', description: 'Local target Profile name (default web).' },
+      version: { type: 'string', description: 'Target Release version (default latest).' },
+    },
+    output,
+    async execute(args, exec) {
+      const values = ['profile', 'diff']
+      if (args.slug) values.push(args.slug)
+      values.push('--profile', args.profile ?? 'web', '--version', args.version ?? 'latest', '--json')
+      const events = await run(values, exec.signal)
+      return events[0] ?? {}
+    },
+  }))
+
+  ctx.tools.register(defineTool({
+    name: 'dsh_hub_profile_upgrade_plan',
+    description: 'Create a reviewed plan to upgrade the installed Profile to a selected Hub Release. Returns an up-to-date result without creating a mutation when no change is needed.',
+    parameters: {
+      slug: { type: 'string', description: 'Hub Preset slug; defaults to the installed Hub Preset.' },
+      profile: { type: 'string', description: 'Local target Profile name (default web).' },
+      version: { type: 'string', description: 'Target Release version (default latest).' },
+    },
+    output,
+    async execute(args, exec) {
+      const values = ['profile', 'upgrade']
+      if (args.slug) values.push(args.slug)
+      values.push('--profile', args.profile ?? 'web', '--version', args.version ?? 'latest', '--plan', '--json')
+      const events = await run(values, exec.signal)
+      return events[0] ?? {}
+    },
+  }))
+
+  ctx.tools.register(defineTool({
+    name: 'dsh_hub_profile_doctor',
+    description: 'Diagnose the local Profile directory, lockfile, bundle order, installed versions, required inputs, and drift from a Hub Release. This is read-only.',
+    parameters: {
+      slug: { type: 'string', description: 'Hub Preset slug; defaults to the installed Hub Preset.' },
+      profile: { type: 'string', description: 'Local Profile name (default web).' },
+      version: { type: 'string', description: 'Release used for drift and input checks (default latest).' },
+    },
+    output,
+    async execute(args, exec) {
+      const values = ['profile', 'doctor']
+      if (args.slug) values.push(args.slug)
+      values.push('--profile', args.profile ?? 'web', '--version', args.version ?? 'latest', '--json')
+      const events = await run(values, exec.signal)
+      return events[0] ?? {}
+    },
+  }))
+
   ctx.tools.register(defineTool({
     name: 'dsh_hub_operation_apply',
-    description: 'Apply a previously reviewed DSH Hub install, share, or rollback plan. Set confirmed=true only after the user explicitly confirms that exact plan.',
+    description: 'Apply a previously reviewed DSH Hub Plugin or Preset mutation plan. Set confirmed=true only after the user explicitly confirms that exact plan.',
     parameters: {
       planId: { type: 'string', required: true, description: 'Plan UUID returned by any DSH Hub planning tool.' },
       confirmed: { type: 'boolean', required: true, description: 'Must reflect explicit user confirmation of this plan.' },
@@ -67,11 +165,11 @@ export function apply(ctx) {
     name: 'dsh_hub_profile_share_plan',
     description: 'Create a non-mutating plan to publish the exact current local Profile as an immutable Hub Release. Review the captured layers and local input contract before applying it.',
     parameters: {
-      slug: { type: 'string', required: true, description: 'New or owned Hub Profile slug.' },
+      slug: { type: 'string', required: true, description: 'New or owned Hub Preset slug.' },
       version: { type: 'string', required: true, description: 'Exact SemVer for the immutable Release.' },
       profile: { type: 'string', description: 'Local source Profile name (default web).' },
-      displayName: { type: 'string', description: 'Public Profile name.' },
-      description: { type: 'string', description: 'Public Profile description.' },
+      displayName: { type: 'string', description: 'Public Preset name.' },
+      description: { type: 'string', description: 'Public Preset description.' },
       runtimeVersion: { type: 'string', description: 'Exact DSH runtime; auto-detected when omitted.' },
     },
     output,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dsh-plugin-hub/dsh-plugin",
-  "version": "0.1.4",
+  "version": "0.3.0",
   "description": "DSH tools for planning and applying reproducible Plugin Hub Profiles through the local dsh-hub CLI",
   "keywords": [
     "dsh-plugin",
@@ -27,7 +27,7 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@dsh-plugin-hub/cli": "0.1.4"
+    "@dsh-plugin-hub/cli": "0.3.0"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",