context-plugins 0.2.0 → 0.3.0

package/README.md

@@ -27,7 +27,7 @@ context-plugins installed                      # what this machine has
 
 | Option | Default | Description |
 | --- | --- | --- |
-| `--repo <owner/repo>` | `context-plugins/plugin-marketplace` | Marketplace repository |
+| `--repo <owner/repo>` | the bundled marketplace | Install from a different marketplace |
 | `--ref <branch\|tag\|sha>` | `main` | Version to install from |
 | `--marketplace <name>` | read from `marketplace.json` | Marketplace name |
 | `--targets <list>` | ask | `claude`, `cursor`, `vscode`, or `all` — skips the prompt |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "context-plugins",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Install a plugin from a plugin marketplace into Claude Code, Cursor, and VS Code with one command.",
   "keywords": [
     "claude-code",

package/src/brand.js

@@ -49,6 +49,13 @@ function resolveBrand({
 } = {}) {
   const rc = readRc(cwd) || readRc(home) || {};
 
+  const displayName = firstSet(
+    env.CP_DISPLAY_NAME,
+    rc.displayName,
+    profile.displayName,
+    DEFAULT_PROFILE.displayName,
+  );
+
   const brand = {
     repo: firstSet(flags.repo, env.CP_REPO, rc.repo, profile.repo, DEFAULT_PROFILE.repo),
     ref: firstSet(flags.ref, env.CP_REF, rc.ref, profile.ref, DEFAULT_PROFILE.ref),
@@ -60,11 +67,14 @@ function resolveBrand({
         profile.id,
         DEFAULT_PROFILE.id,
       ) || null,
-    displayName: firstSet(
-      env.CP_DISPLAY_NAME,
-      rc.displayName,
-      profile.displayName,
-      DEFAULT_PROFILE.displayName,
+    displayName,
+    // What the user sees in place of the repository. The repository is an
+    // implementation detail of where plugins are stored.
+    label: firstSet(
+      env.CP_MARKETPLACE_LABEL,
+      rc.marketplaceLabel,
+      profile.label,
+      `${displayName} Marketplace`,
     ),
     bin: firstSet(profile.bin, DEFAULT_PROFILE.bin),
   };

package/src/catalog.js

@@ -1,6 +1,6 @@
 'use strict';
 
-const { UserError, assertRepo, assertRef, stripBom } = require('./util');
+const { UserError, assertRepo, assertRef, stripBom, suggest } = require('./util');
 
 // Claude Code and Cursor read the same registry shape from different folders.
 // We prefer the Claude one and fall back to Cursor's.
@@ -83,7 +83,9 @@ function sourcePathFor(entry, plugin) {
  * Resolve everything the installers need for one plugin:
  * the marketplace name (derived unless overridden) and the folder inside the repo.
  */
-async function resolvePlugin({ repo, ref, plugin, marketplace = null, deps = {} }) {
+async function resolvePlugin({ repo, ref, plugin, marketplace = null, label, deps = {} }) {
+  // `label` is what the user sees; the repository stays an internal detail.
+  const shown = label || `${repo}@${ref}`;
   const catalog = await loadCatalog({ repo, ref, deps });
   const entry = entryFor(catalog, plugin);
 
@@ -91,14 +93,17 @@ async function resolvePlugin({ repo, ref, plugin, marketplace = null, deps = {}
     const known = catalog.plugins
       .map((p) => (typeof p === 'string' ? p : p && p.name))
       .filter(Boolean);
-    throw new UserError(`Plugin '${plugin}' is not listed in ${repo}@${ref}.`, {
-      hint: known.length ? `Available: ${known.slice(0, 12).join(', ')}` : undefined,
+    const close = suggest(plugin, known);
+    throw new UserError(`Plugin '${plugin}' is not listed in ${shown}.`, {
+      hint: close.length
+        ? `Did you mean: ${close.join(', ')}?  Run 'list' to see all ${known.length}.`
+        : `Run 'list' to see the ${known.length} available plugins.`,
     });
   }
 
   const resolvedMarketplace = marketplace || (catalog && catalog.marketplace);
   if (!resolvedMarketplace) {
-    throw new UserError(`Could not determine the marketplace name for ${repo}@${ref}.`, {
+    throw new UserError(`Could not determine the marketplace name for ${shown}.`, {
       hint: `No 'name' in ${REGISTRY_FILES[0]}. Pass --marketplace <name>.`,
     });
   }

package/src/cli.js

@@ -4,13 +4,16 @@ const log = require('./log');
 const paths = require('./paths');
 const manifest = require('./manifest');
 const { resolveBrand } = require('./brand');
-const { NAMES } = require('./harness');
+const { NAMES, byName } = require('./harness');
 const { UserError } = require('./util');
 const { installPlugin, uninstallPlugin, updateAll, listPlugins } = require('./install');
 const pkg = require('../package.json');
 
 const VALUE_FLAGS = new Set(['repo', 'ref', 'marketplace', 'targets']);
-const BOOL_FLAGS = new Set(['force', 'yes', 'verbose', 'quiet', 'json', 'help', 'version']);
+const BOOL_FLAGS = new Set(['force', 'yes', 'long', 'verbose', 'quiet', 'json', 'help', 'version']);
+
+// A plugin id longer than this is treated as an outlier when sizing the list grid.
+const OUTLIER_NAME = 36;
 
 const camel = (s) => s.replace(/-([a-z])/g, (_m, c) => c.toUpperCase());
 const lowerFirst = (s) => s.charAt(0).toLowerCase() + s.slice(1);
@@ -85,12 +88,13 @@ Usage
   ${bin} installed
 
 Options
-  --repo <owner/repo>   Marketplace repository        (default: ${brand.repo})
+  --repo <owner/repo>   Use a different marketplace   (default: ${brand.label})
   --ref <branch|tag|sha> Version to install from       (default: ${brand.ref})
-  --marketplace <name>  Marketplace name              (default: read from marketplace.json)
+  --marketplace <name>  Marketplace name              (default: read from the marketplace)
   --targets <list>      Comma-separated: ${NAMES.join(', ')}, all   (skips the prompt)
   -y, --yes             Accept every detected harness without asking
   --force               Replace a plugin installed from another marketplace
+  --long                Show plugin descriptions (list)
   --json                Machine-readable output (list, installed)
   --verbose             Show underlying git / CLI detail
   --quiet               Suppress progress output
@@ -196,13 +200,45 @@ async function run(argv = process.argv.slice(2), profile = {}) {
           log.plain(JSON.stringify(result, null, 2));
           return 0;
         }
-        log.banner(`${result.plugins.length} plugin(s) in ${result.repo} (marketplace: ${result.marketplace})`);
-        for (const p of result.plugins) {
-          log.plain(`  ${p.installed ? '*' : ' '} ${p.name}`);
-          if (p.description) log.info(p.description);
+        const plugins = [...result.plugins].sort((a, b) => a.name.localeCompare(b.name));
+        log.banner(`${log.plural(plugins.length, 'plugin')} in ${result.label}`);
+        log.plain('');
+
+        if (flags.long) {
+          // Full detail, one plugin per block.
+          for (const p of plugins) {
+            const mark = p.installed ? log.MARK : ' ';
+            log.plain(`  ${mark} ${log.bold(p.name)}`);
+            if (p.description) log.info(p.description);
+          }
+        } else {
+          // A grid of names. Descriptions in a marketplace are long and largely
+          // boilerplate, so a truncated column of them shows the same prefix on
+          // every row and crowds out the one thing that differs.
+          // Sized to the longest name that is not an outlier. Using the true
+          // maximum lets one very long id set the width for every column and
+          // collapse the grid; using a percentile makes a third of the rows
+          // ragged. Ignoring only the outliers keeps every ordinary row aligned.
+          const lengths = plugins.map((p) => p.name.length);
+          const cell = Math.max(16, ...lengths.filter((l) => l <= OUTLIER_NAME)) + 3;
+          const cols = Math.max(1, Math.floor((log.width(120) - 2) / cell));
+          const rows = Math.ceil(plugins.length / cols);
+          for (let r = 0; r < rows; r += 1) {
+            let line = '  ';
+            for (let c = 0; c < cols; c += 1) {
+              const p = plugins[c * rows + r]; // column-major keeps A-Z reading down
+              if (!p) continue;
+              line += `${p.installed ? log.MARK : ' '} ${p.name.padEnd(cell - 2)}`;
+            }
+            log.plain(line.trimEnd());
+          }
         }
+
         log.plain('');
-        log.info('* = installed on this machine');
+        const count = plugins.filter((p) => p.installed).length;
+        if (count) log.info(`${log.MARK} installed on this machine (${count})`);
+        if (!flags.long) log.info(`Run \`${bin} list --long\` for descriptions.`);
+        log.info(`Install one with \`${bin} install <plugin>\`.`);
         return 0;
       }
       case 'installed': {
@@ -212,14 +248,19 @@ async function run(argv = process.argv.slice(2), profile = {}) {
           return 0;
         }
         if (!entries.length) {
-          log.info('No plugins installed by this tool yet.');
+          log.info('No plugins installed yet.');
+          log.info(`Browse what is available with:  ${bin} list`);
           return 0;
         }
-        log.banner(`${entries.length} plugin(s) installed`);
+        log.banner(`${log.plural(entries.length, 'plugin')} installed`);
+        log.plain('');
+        const idWidth = Math.min(Math.max(...entries.map((e) => e.plugin.length), 4), 42);
         for (const e of entries) {
-          log.plain(`  ${e.plugin}  [${(e.targets || []).join(', ')}]`);
-          log.info(`${e.repo}@${e.ref}  (marketplace: ${e.marketplace})`);
+          const where = (e.targets || []).map((n) => (byName(n) ? byName(n).title : n));
+          log.plain(`    ${e.plugin.padEnd(idWidth)}  ${log.dim(where.join(', '))}`);
+          log.debug(`${e.repo}@${e.ref}  (marketplace: ${e.marketplace})`);
         }
+        log.plain('');
         return 0;
       }
       default:

package/src/fetch.js

@@ -52,7 +52,8 @@ async function materialize({ repo, ref, sourcePath, deps = {} }) {
 async function viaGit({ git, repo, ref, sourcePath, work }) {
   const clone = path.join(work, 'repo');
   const url = `https://github.com/${repo}.git`;
-  log.info(`Fetching marketplace via git (${repo}@${ref}) ...`);
+  log.info('Fetching marketplace via git ...');
+  log.debug(`${url} (${ref}), sparse path ${sourcePath}`);
 
   const base = ['clone', '--quiet', '--depth', '1', '--filter=blob:none', '--sparse'];
 

package/src/harness/cursor.js

@@ -5,7 +5,7 @@ const path = require('path');
 
 const log = require('../log');
 const paths = require('../paths');
-const { replaceDir, rmrf, exists } = require('../util');
+const { replaceDir, rmrf, exists, shortPath } = require('../util');
 
 const name = 'cursor';
 const title = 'Cursor';
@@ -27,7 +27,7 @@ async function install({ plugin, srcDir }, opts) {
   fs.mkdirSync(path.dirname(dest), { recursive: true });
   replaceDir(srcDir, dest);
 
-  log.ok(`Installed -> ${dest}`);
+  log.ok(`Installed -> ${shortPath(dest)}`);
   log.info('Please reload Cursor: Ctrl+Shift+P (Cmd+Shift+P) -> Developer: Reload Window');
   return true;
 }
@@ -35,11 +35,11 @@ async function install({ plugin, srcDir }, opts) {
 async function uninstall({ plugin }, opts) {
   const dest = destFor(plugin, opts);
   if (!exists(dest)) {
-    log.info(`Nothing to remove at ${dest}`);
+    log.info(`Nothing to remove at ${shortPath(dest)}`);
     return false;
   }
   rmrf(dest);
-  log.ok(`Removed -> ${dest}`);
+  log.ok(`Removed -> ${shortPath(dest)}`);
   log.info('Please reload Cursor: Ctrl+Shift+P (Cmd+Shift+P) -> Developer: Reload Window');
   return true;
 }

package/src/harness/vscode.js

@@ -5,7 +5,7 @@ const path = require('path');
 const log = require('../log');
 const paths = require('../paths');
 const { addPluginLocation, removePluginLocation } = require('../settings-merge');
-const { replaceDir, rmrf, exists } = require('../util');
+const { replaceDir, rmrf, exists, shortPath } = require('../util');
 
 // VS Code loads a plugin from anywhere on disk once the folder is listed in
 // `chat.pluginLocations`, so we keep our own copy under the state dir rather
@@ -19,7 +19,7 @@ const destFor = (plugin, opts) => path.join(paths.vscodeStoreDir(opts), plugin);
 
 async function install({ plugin, srcDir }, opts) {
   if (!detect(opts)) {
-    log.warn(`${paths.vscodeUserDir(opts)} not found - VS Code not installed, skipping.`);
+    log.warn(`${shortPath(paths.vscodeUserDir(opts))} not found - VS Code not installed, skipping.`);
     return false;
   }
 
@@ -29,9 +29,9 @@ async function install({ plugin, srcDir }, opts) {
   const settings = paths.vscodeSettingsPath(opts);
   const result = addPluginLocation(settings, dest);
 
-  log.ok(`Installed -> ${dest}`);
-  if (result.action === 'already') log.info(`Already registered in ${settings}`);
-  else log.info(`Registered in chat.pluginLocations (${settings})`);
+  log.ok(`Installed -> ${shortPath(dest)}`);
+  if (result.action === 'already') log.info(`Already registered in ${shortPath(settings)}`);
+  else log.info(`Registered in chat.pluginLocations (${shortPath(settings)})`);
   // The backup always happens; it is only worth mentioning when asked for detail.
   if (result.backup) log.debug(`Backed up settings.json -> ${path.basename(result.backup)}`);
   log.info('Please reload VS Code: Ctrl+Shift+P (Cmd+Shift+P) -> Developer: Reload Window');
@@ -46,11 +46,11 @@ async function uninstall({ plugin }, opts) {
   if (had) rmrf(dest);
 
   if (!had && result.action !== 'removed') {
-    log.info(`Nothing to remove at ${dest}`);
+    log.info(`Nothing to remove at ${shortPath(dest)}`);
     return false;
   }
-  log.ok(`Removed -> ${dest}`);
-  if (result.action === 'removed') log.info(`Unregistered from chat.pluginLocations (${settings})`);
+  log.ok(`Removed -> ${shortPath(dest)}`);
+  if (result.action === 'removed') log.info(`Unregistered from chat.pluginLocations (${shortPath(settings)})`);
   if (result.backup) log.debug(`Backed up settings.json -> ${path.basename(result.backup)}`);
   log.info('Please reload VS Code: Ctrl+Shift+P (Cmd+Shift+P) -> Developer: Reload Window');
   return true;

package/src/install.js

@@ -55,10 +55,9 @@ function assertNoMarketplaceConflict(manifestFile, { plugin, repo }, force) {
     .list(manifestFile)
     .find((p) => p.plugin === plugin && (p.repo || '') !== repo);
   if (clash) {
-    throw new UserError(
-      `'${plugin}' is already installed from a different marketplace (${clash.repo}).`,
-      { hint: `Uninstall it first, or re-run with --force to replace it.` },
-    );
+    throw new UserError(`'${plugin}' is already installed from a different marketplace.`, {
+      hint: 'Uninstall it first, or re-run with --force to replace it.',
+    });
   }
 }
 
@@ -81,13 +80,16 @@ async function installPlugin({
     ref: effectiveRef,
     plugin,
     marketplace: brand.id,
+    label: brand.label,
     deps,
   });
 
   const requested = resolveTargets(targets);
   assertNoMarketplaceConflict(manifestFile, { plugin, repo: brand.repo }, force);
 
-  log.banner(`Installing '${plugin}'  (marketplace: ${resolved.marketplace}, repo: ${brand.repo}@${effectiveRef})`);
+  const from = effectiveRef === 'main' ? brand.label : `${brand.label} (${effectiveRef})`;
+  log.banner(`Installing '${plugin}' from ${from}`);
+  log.debug(`source: ${brand.repo}@${effectiveRef}, marketplace: ${resolved.marketplace}`);
   if (resolved.description) log.info(resolved.description);
   log.rule();
 
@@ -180,7 +182,7 @@ async function uninstallPlugin({ brand, plugin, targets, deps = {}, pathOpts } =
     ).marketplace;
   }
 
-  log.banner(`Uninstalling '${plugin}'  (repo: ${brand.repo})`);
+  log.banner(`Uninstalling '${plugin}' from ${brand.label}`);
   log.info(`Removing from: ${want.map((n) => byName(n).title).join(', ')}`);
   log.rule();
 
@@ -209,13 +211,19 @@ async function updateAll({ brand, force = false, deps = {}, pathOpts } = {}) {
   const manifestFile = paths.manifestPath(pathOpts);
   const entries = manifest.list(manifestFile);
   if (!entries.length) {
-    log.warn(`Nothing recorded in ${manifestFile} - install a plugin first.`);
+    log.warn('No plugins installed yet - nothing to update.');
     return { updated: [], failed: [] };
   }
 
-  log.banner(`Updating ${entries.length} plugin(s) from ${manifestFile}`);
+  log.banner(`Updating ${log.plural(entries.length, 'plugin')}`);
+  log.plain('');
   const updated = [];
   const failed = [];
+  // Each plugin would otherwise print a full install report; at five plugins
+  // that is sixty lines of scrollback to find one failure in. Collapse to a
+  // line each unless --verbose asked for the detail.
+  const collapse = !log.isVerbose && !log.isQuiet;
+  const idWidth = Math.min(Math.max(...entries.map((e) => e.plugin.length), 4), 42);
 
   for (const entry of entries) {
     const entryBrand = Object.freeze({
@@ -224,8 +232,9 @@ async function updateAll({ brand, force = false, deps = {}, pathOpts } = {}) {
       ref: entry.ref || brand.ref,
       id: entry.marketplace || brand.id,
     });
+    if (collapse) log.setQuiet(true);
     try {
-      await installPlugin({
+      const result = await installPlugin({
         brand: entryBrand,
         plugin: entry.plugin,
         ref: entry.ref,
@@ -235,23 +244,32 @@ async function updateAll({ brand, force = false, deps = {}, pathOpts } = {}) {
         deps,
         pathOpts,
       });
+      if (collapse) log.setQuiet(false);
       updated.push(entry.plugin);
+      const where = (result.targets || []).map((n) => byName(n).title).join(', ');
+      if (collapse) log.ok(`${entry.plugin.padEnd(idWidth)}  ${log.dim(where)}`);
     } catch (err) {
+      if (collapse) log.setQuiet(false);
       failed.push({ plugin: entry.plugin, error: err.message });
-      log.error(`${entry.plugin}: ${err.message}`);
+      log.error(`${entry.plugin.padEnd(idWidth)}  ${err.message}`);
     }
   }
 
+  log.plain('');
   log.rule();
-  log.ok(`Updated ${updated.length}/${entries.length}`);
-  if (failed.length) log.warn(`Failed: ${failed.map((f) => f.plugin).join(', ')}`);
+  if (failed.length) {
+    log.warn(`Updated ${updated.length} of ${entries.length}; failed: ${failed.map((f) => f.plugin).join(', ')}`);
+  } else {
+    log.ok(`Updated ${log.plural(updated.length, 'plugin')}`);
+  }
+  log.plain('');
   return { updated, failed };
 }
 
 async function listPlugins({ brand, deps = {}, pathOpts } = {}) {
   const catalog = await loadCatalog({ repo: brand.repo, ref: brand.ref, deps });
   if (!catalog) {
-    throw new UserError(`No marketplace registry found in ${brand.repo}@${brand.ref}.`, {
+    throw new UserError(`Could not read ${brand.label}.`, {
       hint: 'Check --repo, or the branch you pointed at with --ref.',
     });
   }
@@ -262,6 +280,7 @@ async function listPlugins({ brand, deps = {}, pathOpts } = {}) {
       .map((p) => p.plugin),
   );
   return {
+    label: brand.label,
     marketplace: catalog.marketplace,
     repo: brand.repo,
     plugins: catalog.plugins.map((p) => {

package/src/log.js

@@ -20,9 +20,72 @@ function unicodeSupported() {
 }
 
 // Every prefix is padded to the same width so continuation lines line up.
+const INDENT = 6;
 const TICK = unicodeSupported() ? `  ${String.fromCharCode(0x2713)}   ` : '  OK  ';
 const BANG = '  !!  ';
 const CROSS = '  XX  ';
+const MARK = unicodeSupported() ? String.fromCharCode(0x2713) : '*';
+
+/**
+ * Terminal width, clamped: prose past ~78 columns is harder to read, not easier.
+ * COLUMNS is honoured so redirected output and tests can pin a width.
+ */
+function width(max = 78) {
+  const cols = process.stdout.columns || Number(process.env.COLUMNS) || 80;
+  return Math.max(40, Math.min(cols - 1, max));
+}
+
+const ASCII_MAP = {
+  '—': '-', // em dash
+  '–': '-', // en dash
+  '‘': "'",
+  '’': "'",
+  '“': '"',
+  '”': '"',
+  '…': '...',
+  '•': '*',
+  '→': '->',
+  ' ': ' ',
+};
+
+/**
+ * Marketplace descriptions are third-party text and routinely contain em dashes
+ * and smart quotes. On a console that cannot render them they arrive as
+ * mojibake, so downgrade to ASCII rather than print garbage.
+ */
+function toAscii(text) {
+  let out = String(text).replace(/[—–‘’“”…•→ ]/g, (c) => ASCII_MAP[c]);
+  out = out.normalize('NFD').replace(/[̀-ͯ]/g, ''); // strip diacritics
+  // ESC is kept: colour codes must survive, they are not text.
+  return out.replace(/[^\x1b\x20-\x7e\t\r\n]/g, '?');
+}
+
+const ascii = (text) => (unicodeSupported() ? text : toAscii(text));
+
+/** Wrap to the terminal, keeping long unbreakable tokens (paths, URLs) intact. */
+function wrap(text, indent = INDENT, max = width()) {
+  const room = Math.max(20, max - indent);
+  const lines = [];
+  let line = '';
+  for (const word of String(text).split(/\s+/).filter(Boolean)) {
+    if (!line) line = word;
+    else if (line.length + 1 + word.length <= room) line += ` ${word}`;
+    else {
+      lines.push(line);
+      line = word;
+    }
+  }
+  if (line) lines.push(line);
+  return lines.length ? lines : [''];
+}
+
+function truncate(text, max) {
+  const clean = String(text).trim();
+  if (clean.length <= max) return clean;
+  return `${clean.slice(0, Math.max(1, max - 3)).trimEnd()}...`;
+}
+
+const plural = (n, word, suffix = 's') => `${n} ${word}${n === 1 ? '' : suffix}`;
 
 function colorEnabled() {
   if (process.env.NO_COLOR !== undefined) return false;
@@ -44,33 +107,57 @@ const log = {
   get isVerbose() {
     return state.verbose;
   },
+  get isQuiet() {
+    return state.quiet;
+  },
   banner(msg) {
-    if (!state.quiet) console.log(`\n${paint('36', msg)}`);
+    if (!state.quiet) console.log(`\n${paint('36', ascii(msg))}`);
   },
   rule() {
-    if (!state.quiet) console.log(paint('90', '-'.repeat(64)));
+    if (!state.quiet) console.log(paint('90', '-'.repeat(width())));
   },
   step(msg) {
-    if (!state.quiet) console.log(`\n${paint('1', msg)}`);
+    if (!state.quiet) console.log(`\n${paint('1', ascii(msg))}`);
   },
   ok(msg) {
-    if (!state.quiet) console.log(`${paint('32', TICK)}${msg}`);
+    if (!state.quiet) console.log(`${paint('32', TICK)}${ascii(msg)}`);
   },
+  /** Wrapped and indented, so long descriptions stay readable at any width. */
   info(msg) {
-    if (!state.quiet) console.log(paint('90', `      ${msg}`));
+    if (state.quiet) return;
+    for (const line of wrap(ascii(msg))) console.log(paint('90', `      ${line}`));
   },
   warn(msg) {
-    if (!state.quiet) console.log(`${paint('33', BANG)}${msg}`);
+    if (state.quiet) return;
+    const [first, ...rest] = wrap(ascii(msg));
+    console.log(`${paint('33', BANG)}${first}`);
+    for (const line of rest) console.log(paint('33', `      ${line}`));
   },
   error(msg) {
-    console.error(`${paint('31', CROSS)}${msg}`);
+    const [first, ...rest] = wrap(ascii(msg));
+    console.error(`${paint('31', CROSS)}${first}`);
+    for (const line of rest) console.error(paint('31', `      ${line}`));
   },
   debug(msg) {
-    if (state.verbose && !state.quiet) console.log(paint('90', `  ..  ${msg}`));
+    if (state.verbose && !state.quiet) console.log(paint('90', `  ..  ${ascii(msg)}`));
   },
   plain(msg = '') {
-    if (!state.quiet) console.log(msg);
+    if (!state.quiet) console.log(ascii(msg));
+  },
+  dim(msg) {
+    return paint('90', msg);
+  },
+  bold(msg) {
+    return paint('1', msg);
   },
+  MARK,
+  width,
+  wrap,
+  truncate,
+  plural,
+  ascii,
+  toAscii,
+  unicodeSupported,
 };
 
 module.exports = log;

package/src/util.js

@@ -36,7 +36,7 @@ function assertPlugin(id) {
 function assertRepo(repo) {
   if (typeof repo !== 'string' || !REPO_RE.test(repo)) {
     throw new UserError(`Invalid repo: ${JSON.stringify(repo)}`, {
-      hint: 'Expected owner/repo, e.g. context-plugins/plugin-marketplace',
+      hint: 'Expected owner/repo, e.g. acme/plugin-marketplace',
     });
   }
   return repo;
@@ -208,6 +208,63 @@ function timestamp(date = new Date()) {
 
 const stripBom = (s) => (s.charCodeAt(0) === 0xfeff ? s.slice(1) : s);
 
+/** Display form of a path: `~` beats repeating the user's home directory back at them. */
+function shortPath(target, home = require('os').homedir()) {
+  if (!target || !home) return target;
+  const normalized = String(target);
+  if (normalized.toLowerCase().startsWith(home.toLowerCase())) {
+    const rest = normalized.slice(home.length);
+    return `~${rest.startsWith(path.sep) || rest.startsWith('/') ? '' : path.sep}${rest}`;
+  }
+  return normalized;
+}
+
+/** Edit distance, capped work for the short strings we compare (plugin ids). */
+function editDistance(a, b) {
+  const rows = a.length + 1;
+  const cols = b.length + 1;
+  let prev = Array.from({ length: cols }, (_v, i) => i);
+  for (let i = 1; i < rows; i += 1) {
+    const curr = [i];
+    for (let j = 1; j < cols; j += 1) {
+      curr[j] = Math.min(
+        prev[j] + 1,
+        curr[j - 1] + 1,
+        prev[j - 1] + (a[i - 1] === b[j - 1] ? 0 : 1),
+      );
+    }
+    prev = curr;
+  }
+  return prev[cols - 1];
+}
+
+const sharedPrefix = (a, b) => {
+  let i = 0;
+  while (i < a.length && i < b.length && a[i] === b[i]) i += 1;
+  return i;
+};
+
+/**
+ * Closest names to `query`. Substring hits rank first, then names sharing a
+ * substantial prefix - plugin ids in a marketplace tend to share a suffix, so
+ * plain edit distance alone rates `azure-cognitve` as too far from
+ * `azure-cognitive-sdk` to be worth offering.
+ */
+function suggest(query, candidates, limit = 3) {
+  const q = String(query).toLowerCase();
+  const threshold = Math.max(3, Math.ceil(q.length * 0.4));
+  const scored = candidates
+    .map((name) => {
+      const n = String(name).toLowerCase();
+      if (n.includes(q) || q.includes(n)) return { name, score: 0 };
+      if (sharedPrefix(q, n) >= Math.max(4, Math.ceil(q.length * 0.6))) return { name, score: 1 };
+      return { name, score: editDistance(q, n) };
+    })
+    .filter((c) => c.score <= threshold)
+    .sort((a, b) => a.score - b.score || a.name.length - b.name.length);
+  return scored.slice(0, limit).map((c) => c.name);
+}
+
 module.exports = {
   UserError,
   assertPlugin,
@@ -226,4 +283,7 @@ module.exports = {
   pool,
   timestamp,
   stripBom,
+  shortPath,
+  editDistance,
+  suggest,
 };