@vltpkg/cli-sdk 1.0.0-rc.31 → 1.0.0-rc.33

package/dist/commands/access.d.ts

@@ -1,4 +1,5 @@
 import type { CommandFn, CommandUsage } from '../index.ts';
+export declare const needsRegistry = true;
 export declare const usage: CommandUsage;
 export type AccessResult = {
     package: string;

package/dist/commands/access.js

@@ -1,11 +1,16 @@
 import { error } from '@vltpkg/error-cause';
 import { RegistryClient } from '@vltpkg/registry-client';
 import { commandUsage } from "../config/usage.js";
+import { resolveRegistry } from "../require-registry.js";
+export const needsRegistry = true;
 export const usage = () => commandUsage({
     command: 'access',
     usage: '<command> [<args>]',
     description: `Set or get access levels for published packages
-                  and manage team-based package permissions.`,
+                  and manage team-based package permissions.
+
+                  Target a specific configured registry by alias with
+                  \`vlt registry <alias> access <subcommand>\`.`,
     subcommands: {
         'list packages': {
             usage: '[<scope|user|org>]',
@@ -93,7 +98,7 @@ const listPackages = async (conf, args) => {
         });
     }
     const rc = new RegistryClient(conf.options);
-    const registryUrl = new URL(conf.options.registry);
+    const registryUrl = new URL(await resolveRegistry(conf));
     // Determine who to list for — use entity arg or fall back to scope from package.json
     const scope = entity ?? getDefaultScope(conf);
     const url = new URL(`-/org/${encodeURIComponent(scope)}/package`, registryUrl);
@@ -115,7 +120,7 @@ const getStatus = async (conf, args) => {
         });
     }
     const rc = new RegistryClient(conf.options);
-    const registryUrl = new URL(conf.options.registry);
+    const registryUrl = new URL(await resolveRegistry(conf));
     const url = new URL(`-/package/${encodePkgName(pkg)}/access`, registryUrl);
     const response = await rc.request(url, { useCache: false });
     const data = response.json();
@@ -141,7 +146,7 @@ const setStatus = async (conf, args) => {
         });
     }
     const rc = new RegistryClient(conf.options);
-    const registryUrl = new URL(conf.options.registry);
+    const registryUrl = new URL(await resolveRegistry(conf));
     const url = new URL(`-/package/${encodePkgName(pkg)}/access`, registryUrl);
     await rc.request(url, {
         method: 'PUT',
@@ -177,7 +182,7 @@ const grant = async (conf, args) => {
     }
     const pkgName = pkg ?? getDefaultPkgName(conf);
     const rc = new RegistryClient(conf.options);
-    const registryUrl = new URL(conf.options.registry);
+    const registryUrl = new URL(await resolveRegistry(conf));
     const url = new URL(`-/team/${encodeURIComponent(scope)}/${encodeURIComponent(team)}/package`, registryUrl);
     await rc.request(url, {
         method: 'PUT',
@@ -214,7 +219,7 @@ const revoke = async (conf, args) => {
     }
     const pkgName = pkg ?? getDefaultPkgName(conf);
     const rc = new RegistryClient(conf.options);
-    const registryUrl = new URL(conf.options.registry);
+    const registryUrl = new URL(await resolveRegistry(conf));
     const url = new URL(`-/team/${encodeURIComponent(scope)}/${encodeURIComponent(team)}/package`, registryUrl);
     await rc.request(url, {
         method: 'DELETE',

package/dist/commands/build.d.ts

@@ -16,6 +16,7 @@ export declare const views: {
         message: string;
     };
 };
+export declare const needsRegistry = true;
 export declare const usage: CommandUsage;
 /**
  * Build command implementation. Runs any required "postinstall"

package/dist/commands/build.js

@@ -38,6 +38,7 @@ export const views = {
         };
     },
 };
+export const needsRegistry = true;
 export const usage = () => commandUsage({
     command: 'build',
     usage: ['[query]', '[--target=<query>]'],

package/dist/commands/cache.d.ts

@@ -59,6 +59,7 @@ declare const usageDef: {
         };
     };
 };
+export declare const needsRegistry = true;
 export declare const usage: CommandUsage;
 export declare const command: CommandFn<void | CacheMap>;
 export {};

package/dist/commands/cache.js

@@ -80,6 +80,7 @@ const usageDef = {
         },
     },
 };
+export const needsRegistry = true;
 export const usage = () => commandUsage(usageDef);
 export const command = async (conf) => {
     const [sub, ...args] = conf.positionals;

package/dist/commands/ci.d.ts

@@ -2,6 +2,7 @@ import { InstallReporter } from './install/reporter.ts';
 import type { CommandFn, CommandUsage } from '../index.ts';
 import type { InstallResult } from './install.ts';
 export type CIResult = Omit<InstallResult, 'buildQueue'>;
+export declare const needsRegistry = true;
 export declare const usage: CommandUsage;
 export declare const views: {
     readonly json: (i: CIResult) => import("@vltpkg/graph").LockfileData;

package/dist/commands/ci.js

@@ -1,6 +1,7 @@
 import { install } from '@vltpkg/graph';
 import { commandUsage } from "../config/usage.js";
 import { InstallReporter } from "./install/reporter.js";
+export const needsRegistry = true;
 export const usage = () => commandUsage({
     command: 'ci',
     usage: '',

package/dist/commands/create.d.ts

@@ -2,6 +2,7 @@ import type { PromptFn } from '@vltpkg/vlx';
 import type { ExecResult } from '../exec-command.ts';
 import type { CommandFn, CommandUsage } from '../index.ts';
 export { views } from '../exec-command.ts';
+export declare const needsRegistry = true;
 export declare const usage: CommandUsage;
 export declare const prettyPath: (path: string) => string;
 export declare const promptFn: PromptFn;

package/dist/commands/create.js

@@ -6,6 +6,7 @@ import { commandUsage } from "../config/usage.js";
 import { ExecCommand } from "../exec-command.js";
 import { styleTextStdout } from "../output.js";
 export { views } from "../exec-command.js";
+export const needsRegistry = true;
 export const usage = () => commandUsage({
     command: 'create',
     usage: '<initializer> [args...]',

package/dist/commands/deprecate.d.ts

@@ -1,4 +1,5 @@
 import type { CommandFn, CommandUsage } from '../index.ts';
+export declare const needsRegistry = true;
 export declare const usage: CommandUsage;
 export type CommandResult = {
     name: string;

package/dist/commands/deprecate.js

@@ -5,6 +5,8 @@ import { Spec } from '@vltpkg/spec';
 import { satisfies } from '@vltpkg/semver';
 import { asError } from '@vltpkg/types';
 import { commandUsage } from "../config/usage.js";
+import { resolveRegistry } from "../require-registry.js";
+export const needsRegistry = true;
 export const usage = () => commandUsage({
     command: 'deprecate',
     usage: '<pkg>[@<version>] <message>',
@@ -66,7 +68,8 @@ export const command = async (conf) => {
             found: specArg,
         });
     }
-    const { registry, otp } = conf.options;
+    const { otp } = conf.options;
+    const registry = await resolveRegistry(conf);
     const registryUrl = new URL(registry);
     // Fetch the current packument
     const pic = new PackageInfoClient(conf.options);

package/dist/commands/dist-tag.d.ts

@@ -1,4 +1,5 @@
 import type { CommandFn, CommandUsage } from '../index.ts';
+export declare const needsRegistry = true;
 export declare const usage: CommandUsage;
 export type DistTagLsResult = {
     id: string;

package/dist/commands/dist-tag.js

@@ -2,6 +2,8 @@ import { error } from '@vltpkg/error-cause';
 import { RegistryClient } from '@vltpkg/registry-client';
 import { Spec } from '@vltpkg/spec';
 import { commandUsage } from "../config/usage.js";
+import { resolveRegistry } from "../require-registry.js";
+export const needsRegistry = true;
 export const usage = () => commandUsage({
     command: 'dist-tag',
     usage: [
@@ -91,7 +93,7 @@ export const command = async (conf) => {
         });
     }
     const rc = new RegistryClient(conf.options);
-    const registry = conf.options.registry;
+    const registry = await resolveRegistry(conf);
     switch (sub) {
         case 'add': {
             const specArg = args[0];

package/dist/commands/exec-cache.d.ts

@@ -43,6 +43,7 @@ declare const usageDef: {
         };
     };
 };
+export declare const needsRegistry = true;
 export declare const usage: CommandUsage;
 export declare const command: CommandFn<string[] | VlxInfo[]>;
 export {};

package/dist/commands/exec-cache.js

@@ -60,6 +60,7 @@ const usageDef = {
         },
     },
 };
+export const needsRegistry = true;
 export const usage = () => commandUsage(usageDef);
 export const command = async (conf) => {
     const [sub, ...args] = conf.positionals;

package/dist/commands/exec.d.ts

@@ -2,6 +2,7 @@ import type { PromptFn } from '@vltpkg/vlx';
 import type { ExecResult } from '../exec-command.ts';
 import type { CommandFn, CommandUsage } from '../index.ts';
 export { views } from '../exec-command.ts';
+export declare const needsRegistry = true;
 export declare const usage: CommandUsage;
 export declare const prettyPath: (path: string) => string;
 export declare const promptFn: PromptFn;

package/dist/commands/exec.js

@@ -7,6 +7,7 @@ import { commandUsage } from "../config/usage.js";
 import { ExecCommand } from "../exec-command.js";
 import { styleTextStdout } from "../output.js";
 export { views } from "../exec-command.js";
+export const needsRegistry = true;
 export const usage = () => commandUsage({
     command: 'exec',
     usage: '[--package=<pkg>] [--call=<cmd>] [command...]',

package/dist/commands/install.d.ts

@@ -19,6 +19,7 @@ export type InstallResult = {
      */
     diff?: Diff;
 };
+export declare const needsRegistry = true;
 export declare const usage: CommandUsage;
 export declare const views: {
     readonly json: (i: InstallResult) => {

package/dist/commands/install.js

@@ -3,6 +3,7 @@ import { install } from '@vltpkg/graph';
 import { parseAddArgs } from "../parse-add-remove-args.js";
 import { InstallReporter } from "./install/reporter.js";
 import { trackInstall } from "../telemetry.js";
+export const needsRegistry = true;
 export const usage = () => commandUsage({
     command: 'install',
     usage: '[packages ...]',
@@ -12,6 +13,13 @@ export const usage = () => commandUsage({
         'save-dev': {
             description: 'Save installed packages to package.json as devDependencies.',
         },
+        'save-exact': {
+            description: 'Save installed packages with exact versions instead of a semver range.',
+        },
+        'save-prefix': {
+            value: '<prefix>',
+            description: 'The version prefix to use when saving dependencies (e.g. ^, ~, >=, or empty string).',
+        },
         'save-optional': {
             description: 'Save installed packages to package.json as optionalDependencies.',
         },
@@ -115,6 +123,8 @@ export const command = async (conf) => {
     const frozenLockfile = conf.options['frozen-lockfile'];
     const expectLockfile = conf.options['expect-lockfile'];
     const lockfileOnly = conf.options['lockfile-only'];
+    const saveExact = conf.values['save-exact'];
+    const savePrefix = conf.values['save-prefix'];
     /* c8 ignore start */
     const allowScripts = conf.get('allow-scripts') ?
         String(conf.get('allow-scripts'))
@@ -127,6 +137,8 @@ export const command = async (conf) => {
         expectLockfile,
         allowScripts,
         lockfileOnly,
+        saveExact,
+        savePrefix,
     }, add);
     /* c8 ignore next 9 - telemetry is best-effort */
     try {

package/dist/commands/list.d.ts

@@ -2,6 +2,7 @@ import { humanReadableOutput, jsonOutput, mermaidOutput } from '@vltpkg/graph';
 import type { HumanReadableOutputGraph, JSONOutputGraph, MermaidOutputGraph } from '@vltpkg/graph';
 import { MermaidImageView } from '../mermaid-image-view.ts';
 import type { CommandFn, CommandUsage } from '../index.ts';
+export declare const needsRegistry = true;
 export declare const usage: CommandUsage;
 export type ListResult = JSONOutputGraph & MermaidOutputGraph & HumanReadableOutputGraph & {
     queryString: string;

package/dist/commands/list.js

@@ -5,6 +5,7 @@ import { error } from '@vltpkg/error-cause';
 import { commandUsage } from "../config/usage.js";
 import { createHostContextsMap } from "../query-host-contexts.js";
 import { MermaidImageView } from "../mermaid-image-view.js";
+export const needsRegistry = true;
 export const usage = () => commandUsage({
     command: 'ls',
     usage: [

package/dist/commands/login.js

@@ -1,14 +1,20 @@
 import { RegistryClient } from '@vltpkg/registry-client';
 import { commandUsage } from "../config/usage.js";
+import { missingRegistryError } from "../require-registry.js";
 export const usage = () => commandUsage({
     command: 'login',
     usage: [''],
     description: `Authenticate against a registry, and store the token in
-                  the appropriate config file for later use.`,
+                  the appropriate config file for later use.
+
+                  There is no default registry, so a registry must either
+                  already be configured or be provided with
+                  \`--registry=<url>\`. On success the registry is written to
+                  the project's \`vlt.json\`.`,
     options: {
         registry: {
             value: '<url>',
-            description: 'Registry URL to authenticate against.',
+            description: 'Registry URL to authenticate against. Saved to vlt.json.',
         },
         identity: {
             value: '<name>',
@@ -17,6 +23,13 @@ export const usage = () => commandUsage({
     },
 });
 export const command = async (conf) => {
+    const { registry } = conf.options;
+    // login is exempt from the needsRegistry pre-check, since it is the
+    // guided way out of it -- but it still needs a target.
+    if (!registry)
+        throw missingRegistryError();
     const rc = new RegistryClient(conf.options);
-    await rc.login(conf.options.registry);
+    await rc.login(registry);
+    // persist the registry so subsequent commands are configured
+    await conf.addConfigToFile('project', { registry });
 };

package/dist/commands/logout.d.ts

@@ -1,3 +1,4 @@
 import type { CommandFn, CommandUsage } from '../index.ts';
+export declare const needsRegistry = true;
 export declare const usage: CommandUsage;
 export declare const command: CommandFn<void>;

package/dist/commands/logout.js

@@ -1,10 +1,15 @@
 import { RegistryClient } from '@vltpkg/registry-client';
 import { commandUsage } from "../config/usage.js";
+import { resolveRegistry } from "../require-registry.js";
+export const needsRegistry = true;
 export const usage = () => commandUsage({
     command: 'logout',
     usage: [''],
     description: `Log out of the default registry, deleting the token from
-                  the local keychain, as well as destroying it on the server.`,
+                  the local keychain, as well as destroying it on the server.
+
+                  Target a specific configured registry by alias with
+                  \`vlt registry <alias> logout\`.`,
     options: {
         registry: {
             value: '<url>',
@@ -18,5 +23,5 @@ export const usage = () => commandUsage({
 });
 export const command = async (conf) => {
     const rc = new RegistryClient(conf.options);
-    await rc.logout(conf.options.registry);
+    await rc.logout(await resolveRegistry(conf));
 };

package/dist/commands/pack.d.ts

@@ -1,5 +1,6 @@
 import type { CommandFn, CommandUsage } from '../index.ts';
 import type { LoadedConfig } from '../config/index.ts';
+export declare const needsRegistry = true;
 export declare const usage: CommandUsage;
 export type CommandResultSingle = {
     id: string;

package/dist/commands/pack.js

@@ -10,6 +10,7 @@ import { Query } from '@vltpkg/query';
 import { error } from '@vltpkg/error-cause';
 import { createHostContextsMap } from "../query-host-contexts.js";
 import { minimatch } from 'minimatch';
+export const needsRegistry = true;
 export const usage = () => commandUsage({
     command: 'pack',
     usage: '',

package/dist/commands/ping.d.ts

@@ -1,4 +1,5 @@
 import type { CommandFn, CommandUsage } from '../index.ts';
+export declare const needsRegistry = true;
 export declare const usage: CommandUsage;
 type PingResult = {
     registry: string;

package/dist/commands/ping.js

@@ -1,6 +1,8 @@
 import { RegistryClient } from '@vltpkg/registry-client';
 import { error } from '@vltpkg/error-cause';
 import { commandUsage } from "../config/usage.js";
+import { requireRegistry } from "../require-registry.js";
+export const needsRegistry = true;
 export const usage = () => commandUsage({
     command: 'ping',
     usage: ['', '[<registry-alias>]'],
@@ -99,13 +101,14 @@ export const command = async (conf) => {
     else {
         // Ping all configured registries
         const registries = conf.options.registries;
+        const defaultRegistry = requireRegistry(conf);
         const results = [];
         // Always ping the default registry first
-        results.push(await pingRegistry(rc, conf.options.registry, 'default'));
+        results.push(await pingRegistry(rc, defaultRegistry, 'default'));
         // Then ping all configured registry aliases
         for (const [alias, registry] of Object.entries(registries)) {
             // Skip if it's the same as the default registry
-            if (registry !== conf.options.registry) {
+            if (registry !== defaultRegistry) {
                 results.push(await pingRegistry(rc, registry, alias));
             }
         }

package/dist/commands/profile.d.ts

@@ -1,5 +1,6 @@
 import type { JSONField } from '@vltpkg/types';
 import type { CommandFn, CommandUsage } from '../index.ts';
+export declare const needsRegistry = true;
 export declare const usage: CommandUsage;
 export type ProfileData = Record<string, JSONField>;
 export type ProfileResult = ProfileData | {

package/dist/commands/profile.js

@@ -1,6 +1,8 @@
 import { error } from '@vltpkg/error-cause';
 import { RegistryClient } from '@vltpkg/registry-client';
 import { commandUsage } from "../config/usage.js";
+import { resolveRegistry } from "../require-registry.js";
+export const needsRegistry = true;
 export const usage = () => commandUsage({
     command: 'profile',
     usage: '<command> [<args>]',
@@ -64,7 +66,7 @@ export const command = async (conf) => {
 };
 const getProfile = async (conf, args) => {
     const rc = new RegistryClient(conf.options);
-    const registryUrl = new URL(conf.options.registry);
+    const registryUrl = new URL(await resolveRegistry(conf));
     const url = new URL('-/npm/v1/user', registryUrl);
     const response = await rc.request(url, { useCache: false });
     const data = response.json();
@@ -90,7 +92,7 @@ const setProfile = async (conf, args) => {
         });
     }
     const rc = new RegistryClient(conf.options);
-    const registryUrl = new URL(conf.options.registry);
+    const registryUrl = new URL(await resolveRegistry(conf));
     const url = new URL('-/npm/v1/user', registryUrl);
     const response = await rc.request(url, {
         method: 'POST',

package/dist/commands/publish.d.ts

@@ -1,4 +1,5 @@
 import type { CommandFn, CommandUsage } from '../index.ts';
+export declare const needsRegistry = true;
 export declare const usage: CommandUsage;
 export type CommandResultSingle = {
     id: string;

package/dist/commands/publish.js

@@ -11,6 +11,8 @@ import { actual } from '@vltpkg/graph';
 import { Query } from '@vltpkg/query';
 import { createHostContextsMap } from "../query-host-contexts.js";
 import { minimatch } from 'minimatch';
+import { resolveRegistry } from "../require-registry.js";
+export const needsRegistry = true;
 export const usage = () => commandUsage({
     command: 'publish',
     usage: '',
@@ -164,7 +166,7 @@ const commandSingle = async (location, conf) => {
     const publishConfig = getPublishConfig(manifest);
     const tag = publishConfig?.tag ?? conf.options.tag;
     const access = publishConfig?.access ?? conf.options.access;
-    const registry = publishConfig?.registry ?? conf.options.registry;
+    const registry = publishConfig?.registry ?? (await resolveRegistry(conf));
     const registryUrl = new URL(registryBase(registry));
     const runOptions = {
         cwd: manifestDir,

package/dist/commands/query.d.ts

@@ -2,6 +2,7 @@ import { humanReadableOutput, jsonOutput, mermaidOutput } from '@vltpkg/graph';
 import type { HumanReadableOutputGraph, JSONOutputGraph, MermaidOutputGraph } from '@vltpkg/graph';
 import { MermaidImageView } from '../mermaid-image-view.ts';
 import type { CommandFn, CommandUsage } from '../index.ts';
+export declare const needsRegistry = true;
 export declare const usage: CommandUsage;
 type QueryResult = JSONOutputGraph & MermaidOutputGraph & HumanReadableOutputGraph & {
     queryString: string;

package/dist/commands/query.js

@@ -6,6 +6,7 @@ import { SecurityArchive } from '@vltpkg/security-archive';
 import { commandUsage } from "../config/usage.js";
 import { createHostContextsMap } from "../query-host-contexts.js";
 import { MermaidImageView } from "../mermaid-image-view.js";
+export const needsRegistry = true;
 export const usage = () => commandUsage({
     command: 'query',
     usage: [

package/dist/commands/registry.d.ts

@@ -0,0 +1,26 @@
+import type { LoadedConfig } from '../config/index.ts';
+import type { CommandFn, CommandUsage } from '../index.ts';
+/**
+ * The account/auth commands that can be scoped to a named registry
+ * alias via `vlt registry <alias> <command>`.
+ */
+export declare const registrySubcommands: ["whoami", "logout", "login", "token", "access", "publish", "unpublish", "deprecate", "dist-tag", "profile", "ping"];
+export declare const usage: CommandUsage;
+export declare const views: {
+    readonly human: () => void;
+};
+/**
+ * Resolve `vlt registry <alias> <command>` in place: determine the
+ * target subcommand and registry, then rewrite `conf` so the outer
+ * runner dispatches the real command with the resolved registry
+ * injected. When invoked with `--help` or without a subcommand, `conf`
+ * is left untouched so the `registry` usage/error is shown instead.
+ *
+ * Streams / interactivity are injectable for tests.
+ */
+export declare const dispatchRegistry: (conf: LoadedConfig, { interactive, input, output, }?: {
+    interactive?: boolean;
+    input?: NodeJS.ReadableStream;
+    output?: NodeJS.WritableStream;
+}) => Promise<void>;
+export declare const command: CommandFn<void>;

package/dist/commands/registry.js

@@ -0,0 +1,99 @@
+import { error } from '@vltpkg/error-cause';
+import { getCommand } from "../config/definition.js";
+import { commandUsage } from "../config/usage.js";
+import { resolveRegistry } from "../require-registry.js";
+/**
+ * The account/auth commands that can be scoped to a named registry
+ * alias via `vlt registry <alias> <command>`.
+ */
+export const registrySubcommands = [
+    'whoami',
+    'logout',
+    'login',
+    'token',
+    'access',
+    'publish',
+    'unpublish',
+    'deprecate',
+    'dist-tag',
+    'profile',
+    'ping',
+];
+const isRegistrySubcommand = (s) => {
+    const canonical = getCommand(s);
+    return (canonical !== undefined &&
+        registrySubcommands.includes(canonical));
+};
+export const usage = () => commandUsage({
+    command: 'registry',
+    usage: '<alias> <command> [<args>]',
+    description: `Run an account command against a specific configured
+                  registry, selected by its \`registries\` alias instead
+                  of a full URL.
+
+                  For example, \`vlt registry main whoami\` runs \`whoami\`
+                  against the registry configured as \`main\`. Omit the
+                  alias (e.g. \`vlt registry whoami\`) to be prompted to
+                  choose from the configured registries, or to fall back
+                  to \`--default-registry-alias\` when non-interactive.
+
+                  \`<command>\` is one of:
+                  ${registrySubcommands.join(', ')}.`,
+});
+export const views = {
+    human: () => { },
+};
+/**
+ * Resolve `vlt registry <alias> <command>` in place: determine the
+ * target subcommand and registry, then rewrite `conf` so the outer
+ * runner dispatches the real command with the resolved registry
+ * injected. When invoked with `--help` or without a subcommand, `conf`
+ * is left untouched so the `registry` usage/error is shown instead.
+ *
+ * Streams / interactivity are injectable for tests.
+ */
+export const dispatchRegistry = async (conf, { interactive, input, output, } = {}) => {
+    if (conf.get('help'))
+        return;
+    const [first, ...restArgs] = conf.positionals;
+    if (first === undefined)
+        return;
+    let alias;
+    let subRaw;
+    let args;
+    if (isRegistrySubcommand(first)) {
+        subRaw = first;
+        args = restArgs;
+    }
+    else {
+        alias = first;
+        subRaw = restArgs[0];
+        args = restArgs.slice(1);
+    }
+    if (!isRegistrySubcommand(subRaw)) {
+        throw error('Unknown registry subcommand', {
+            found: subRaw,
+            validOptions: [...registrySubcommands],
+            code: 'EUSAGE',
+        });
+    }
+    const registry = await resolveRegistry(conf, {
+        alias,
+        interactive,
+        input,
+        output,
+    });
+    conf.options.registry = registry;
+    conf.values.registry = registry;
+    conf.command = subRaw;
+    conf.positionals = args;
+};
+export const command = async (conf) => {
+    // Reached only when dispatchRegistry did not rewrite conf, i.e. no
+    // subcommand was provided (help is handled by the runner earlier).
+    throw error('Missing registry subcommand', {
+        found: conf.positionals[0],
+        validOptions: [...registrySubcommands],
+        code: 'EUSAGE',
+    });
+};

package/dist/commands/run-exec.d.ts

@@ -1,5 +1,6 @@
 import type { ExecResult } from '../exec-command.ts';
 import type { CommandFn, CommandUsage } from '../index.ts';
 export { views } from '../exec-command.ts';
+export declare const needsRegistry = true;
 export declare const usage: CommandUsage;
 export declare const command: CommandFn<ExecResult>;

package/dist/commands/run-exec.js

@@ -2,6 +2,7 @@ import { runExec, runExecFG } from '@vltpkg/run';
 import { commandUsage } from "../config/usage.js";
 import { ExecCommand } from "../exec-command.js";
 export { views } from "../exec-command.js";
+export const needsRegistry = true;
 export const usage = () => commandUsage({
     command: 'run-exec',
     usage: '[command ...]',