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

package/dist/commands/publish.js

@@ -12,6 +12,7 @@ import { Query } from '@vltpkg/query';
 import { createHostContextsMap } from "../query-host-contexts.js";
 import { minimatch } from 'minimatch';
 import { resolveRegistry } from "../require-registry.js";
+import { registryErrorMessage } from "../registry-error-message.js";
 export const needsRegistry = true;
 export const usage = () => commandUsage({
     command: 'publish',
@@ -264,15 +265,15 @@ const commandSingle = async (location, conf) => {
             });
         }
         if (response.statusCode !== 200 && response.statusCode !== 201) {
-            let extraMsg = '';
+            let advice = '';
             if (response.statusCode === 409) {
-                extraMsg = `.\n⚠️ ${name}@${version} already exists in the registry. Bump the version and try again.`;
+                advice = `\n⚠️ ${name}@${version} already exists in the registry. Bump the version and try again.`;
             }
             else if (response.statusCode === 404) {
-                extraMsg =
-                    ".\n⚠️ Make sure you're logged in and have access to publish the package.";
+                advice =
+                    "\n⚠️ Make sure you're logged in and have access to publish the package.";
             }
-            throw error(`Failed to publish package${extraMsg}`, {
+            throw error(`Failed to publish package: ${registryErrorMessage(response)}${advice}`, {
                 url: publishUrl,
                 response,
             });

package/dist/commands/query.js

@@ -1,6 +1,7 @@
 import { actual, asNode, humanReadableOutput, jsonOutput, mermaidOutput, GraphModifier, } from '@vltpkg/graph';
-import { error } from '@vltpkg/error-cause';
 import { Query } from '@vltpkg/query';
+import { stdout } from "../output.js";
+import { error } from '@vltpkg/error-cause';
 import { createDiffFilesProvider } from "../query-diff-files.js";
 import { SecurityArchive } from '@vltpkg/security-archive';
 import { commandUsage } from "../config/usage.js";
@@ -154,6 +155,18 @@ export const command = async (conf) => {
             signal: new AbortController().signal,
         });
         scopeNodes = resultNodes;
+        if (scopeNodes.length === 0) {
+            if (conf.values.view === 'human') {
+                stdout('No packages found matching scope query:', scopeQueryString);
+            }
+            return {
+                importers: new Set(),
+                edges: [],
+                nodes: [],
+                highlightSelection: false,
+                queryString: scopeQueryString,
+            };
+        }
     }
     if (scopeQueryString && scopeNodes) {
         // Add all scope nodes to importers Set (treat them as top-level items)
@@ -173,6 +186,18 @@ export const command = async (conf) => {
                 }
             }
         }
+        if (importers.size === 0) {
+            if (conf.values.view === 'human') {
+                stdout('No matching workspaces found:', conf.values.workspace);
+            }
+            return {
+                importers: new Set(),
+                edges: [],
+                nodes: [],
+                highlightSelection: false,
+                queryString: queryString ?? '',
+            };
+        }
     }
     // retrieve the selected nodes and edges
     const edges_ = graph?.edges ?? new Set();
@@ -202,6 +227,21 @@ export const command = async (conf) => {
             wanted: conf.values['expect-results'],
         });
     }
+    if (graph &&
+        nodes.length === 0 &&
+        edges.length === 0 &&
+        !conf.values['expect-results']) {
+        if (conf.values.view === 'human') {
+            stdout('No packages found matching query:', query);
+        }
+        return {
+            importers: new Set(),
+            edges: [],
+            nodes: [],
+            highlightSelection: false,
+            queryString: query,
+        };
+    }
     return {
         importers: importers.size === 0 ?
             new Set(queryResultImporters)

package/dist/commands/view.js

@@ -301,7 +301,7 @@ export const command = async (conf) => {
     const pic = new PackageInfoClient(conf.options);
     // Fetch the full packument (needs time, maintainers) and resolved manifest
     const [packument, resolvedManifest] = await Promise.all([
-        pic.packument(spec, { fullPackument: true }),
+        pic.packument(spec),
         pic.manifest(spec),
     ]);
     const manifest = resolvedManifest;

package/dist/config/definition.d.ts

@@ -21,11 +21,9 @@ export declare const commands: {
     readonly '?': "help";
     readonly info: "view";
     readonly ls: "list";
-    readonly out: "outdated";
     readonly show: "view";
     readonly xc: "exec-cache";
     readonly access: "access";
-    readonly audit: "audit";
     readonly bugs: "bugs";
     readonly build: "build";
     readonly cache: "cache";
@@ -37,14 +35,12 @@ export declare const commands: {
     readonly docs: "docs";
     readonly exec: "exec";
     readonly 'exec-local': "exec-local";
-    readonly fund: "fund";
     readonly help: "help";
     readonly init: "init";
     readonly install: "install";
     readonly login: "login";
     readonly logout: "logout";
     readonly list: "list";
-    readonly outdated: "outdated";
     readonly pack: "pack";
     readonly ping: "ping";
     readonly pkg: "pkg";

package/dist/config/definition.js

@@ -16,7 +16,6 @@ export const defaultEditor = () => process.env.EDITOR ||
         : 'vi');
 const canonicalCommands = {
     access: 'access',
-    audit: 'audit',
     bugs: 'bugs',
     build: 'build',
     cache: 'cache',
@@ -28,7 +27,6 @@ const canonicalCommands = {
     docs: 'docs',
     exec: 'exec',
     'exec-local': 'exec-local',
-    fund: 'fund',
     help: 'help',
     init: 'init',
     install: 'install',
@@ -36,7 +34,6 @@ const canonicalCommands = {
     logout: 'logout',
     list: 'list',
     ls: 'ls',
-    outdated: 'outdated',
     pack: 'pack',
     ping: 'ping',
     pkg: 'pkg',
@@ -75,7 +72,6 @@ const aliases = {
     '?': 'help',
     info: 'view',
     ls: 'list',
-    out: 'outdated',
     show: 'view',
     xc: 'exec-cache',
 };

package/dist/custom-help.js

@@ -1,5 +1,6 @@
 import { loadPackageJson } from 'package-json-from-dist';
 import chalk from 'chalk';
+import { commandAliases } from "./config/definition.js";
 const { version } = loadPackageJson(import.meta.filename, process.env.__VLT_INTERNAL_CLI_PACKAGE_JSON);
 // Custom yellow color: #FFE15D
 const customYellow = chalk.hex('#FFE15D');
@@ -42,243 +43,176 @@ const makeStyler = (colors) => {
         return styledText;
     };
 };
-// Single source of truth for all commands with metadata
-const allCommands = [
-    {
-        name: 'bugs',
-        aliases: [],
+/**
+ * Help metadata for every command target in the command registry. Using a
+ * record keyed by CommandName makes missing or stale entries a type error;
+ * aliases are derived separately from the registry below.
+ */
+const commandHelp = {
+    access: {
+        args: '<command> [<args>]',
+        desc: 'Manage package access and team permissions',
+    },
+    bugs: {
         args: '[<spec>]',
         desc: 'Open the bug tracker for a package',
-        showByDefault: false,
     },
-    {
-        name: 'build',
-        aliases: ['b'],
+    build: {
         args: '<selector>',
         desc: 'Build packages with lifecycle scripts',
-        showByDefault: true,
         defaultOrder: 4,
     },
-    {
-        name: 'cache',
-        aliases: [],
+    cache: {
         args: '[add|ls|info|clean|delete|delete-before|delete-all]',
         desc: 'Manage the package cache',
-        showByDefault: false,
     },
-    {
-        name: 'ci',
-        aliases: [],
+    ci: {
         args: '',
         desc: 'Clean install (frozen lockfile)',
-        showByDefault: false,
     },
-    {
-        name: 'config',
-        aliases: [],
+    config: {
         args: '[get|pick|list|set|delete|edit|location]',
         desc: 'Get or set configuration',
-        showByDefault: false,
     },
-    {
-        name: 'create',
-        aliases: [],
+    create: {
         args: '<initializer> [args...]',
         desc: 'Create a new project from a template',
-        showByDefault: false,
     },
-    {
-        name: 'docs',
-        aliases: [],
+    deprecate: {
+        args: '<pkg>[@<version>] <message>',
+        desc: 'Deprecate a package or version range',
+    },
+    'dist-tag': {
+        args: '[add|rm|ls] [<args>]',
+        desc: 'Manage package distribution tags',
+    },
+    docs: {
         args: '',
         desc: 'Open the docs of the current project',
-        showByDefault: false,
     },
-    {
-        name: 'exec',
-        aliases: ['x'],
+    exec: {
         args: '<executable>',
         desc: 'Execute a package bin',
-        showByDefault: true,
         defaultOrder: 6,
     },
-    {
-        name: 'exec-cache',
-        aliases: ['xc'],
+    'exec-cache': {
         args: '[ls|delete|info|install]',
         desc: 'Manage the exec cache',
-        showByDefault: false,
     },
-    {
-        name: 'exec-local',
-        aliases: ['xl'],
+    'exec-local': {
         args: '<command>',
         desc: 'Execute a local package bin',
-        showByDefault: false,
     },
-    {
-        name: 'help',
-        aliases: ['h', '?'],
+    help: {
         args: '[<command>]',
         desc: 'Show help for a command',
-        showByDefault: false,
     },
-    {
-        name: 'init',
-        aliases: [],
+    init: {
         args: '',
         desc: 'Initialize a new project',
-        showByDefault: true,
         defaultOrder: 1,
     },
-    {
-        name: 'install',
-        aliases: ['i', 'add'],
+    install: {
         args: '[<package>...]',
         desc: 'Install dependencies',
-        showByDefault: true,
         defaultOrder: 2,
     },
-    {
-        name: 'list',
-        aliases: ['ls'],
+    list: {
         args: '',
         desc: 'List installed packages',
-        showByDefault: false,
     },
-    {
-        name: 'login',
-        aliases: [],
+    login: {
         args: '',
         desc: 'Authenticate with a registry',
-        showByDefault: false,
     },
-    {
-        name: 'logout',
-        aliases: [],
+    logout: {
         args: '',
         desc: 'Log out from a registry',
-        showByDefault: false,
     },
-    {
-        name: 'pack',
-        aliases: [],
+    pack: {
         args: '',
         desc: 'Create a tarball from a package',
-        showByDefault: false,
     },
-    {
-        name: 'ping',
-        aliases: [],
+    ping: {
         args: '[<registry-alias>]',
         desc: 'Ping configured registries',
-        showByDefault: false,
     },
-    {
-        name: 'pkg',
-        aliases: ['p'],
+    pkg: {
         args: '<command>',
         desc: 'Manage package metadata',
-        showByDefault: true,
         defaultOrder: 7,
     },
-    {
-        name: 'publish',
-        aliases: ['pub'],
+    profile: {
+        args: '<command> [<args>]',
+        desc: 'Get or set registry profile properties',
+    },
+    publish: {
         args: '',
         desc: 'Publish package to registry',
-        showByDefault: true,
         defaultOrder: 8,
     },
-    {
-        name: 'query',
-        aliases: ['q'],
+    query: {
         args: '<selector>',
         desc: 'Query for packages in the project',
-        showByDefault: true,
         defaultOrder: 3,
     },
-    {
-        name: 'registry',
-        aliases: [],
+    registry: {
         args: '<alias> <command>',
         desc: 'Run an account command against a named registry',
-        showByDefault: true,
         defaultOrder: 9,
     },
-    {
-        name: 'repo',
-        aliases: [],
+    repo: {
         args: '[<spec>]',
         desc: 'Open the repository page for a package',
-        showByDefault: false,
     },
-    {
-        name: 'run',
-        aliases: ['r'],
+    run: {
         args: '<script>',
         desc: 'Run a script defined in package.json',
-        showByDefault: true,
         defaultOrder: 5,
     },
-    {
-        name: 'run-exec',
-        aliases: ['rx'],
+    'run-exec': {
         args: '<script>',
         desc: 'Run a script &/or fallback to executing a binary',
-        showByDefault: false,
     },
-    {
-        name: 'setup',
-        aliases: [],
+    setup: {
         args: '[<account>]',
         desc: 'Configure your vlt.io account registries',
-        showByDefault: true,
         defaultOrder: 0,
     },
-    {
-        name: 'token',
-        aliases: [],
+    token: {
         args: '[add|rm]',
         desc: 'Manage authentication tokens',
-        showByDefault: false,
     },
-    {
-        name: 'uninstall',
-        aliases: ['rm'],
+    uninstall: {
         args: '[<package>...]',
         desc: 'Remove dependencies',
-        showByDefault: false,
     },
-    {
-        name: 'unpublish',
-        aliases: [],
+    unpublish: {
         args: '<pkg>[@<version>]',
         desc: 'Remove a package from the registry',
-        showByDefault: false,
     },
-    {
-        name: 'update',
-        aliases: ['u'],
+    update: {
         args: '',
         desc: 'Update package versions to latest in-range',
-        showByDefault: false,
     },
-    {
-        name: 'version',
-        aliases: [],
+    version: {
         args: '<increment>',
         desc: 'Bump package version',
-        showByDefault: false,
     },
-    {
-        name: 'whoami',
-        aliases: [],
+    view: {
+        args: '<pkg>[@<version>] [<field>]',
+        desc: 'View registry information about a package',
+    },
+    whoami: {
         args: '',
         desc: 'Display the current user',
-        showByDefault: false,
     },
-];
+};
+const allCommands = Object.entries(commandHelp).map(([name, metadata]) => ({
+    name,
+    aliases: commandAliases.get(name) ?? [],
+    ...metadata,
+}));
 /**
  * Generates the custom default help output for vlt
  */
@@ -286,8 +220,8 @@ export const generateDefaultHelp = (colors = false) => {
     const s = makeStyler(colors);
     // Get default commands and sort by defaultOrder
     const defaultCommands = allCommands
-        .filter(cmd => cmd.showByDefault)
-        .sort((a, b) => (a.defaultOrder || 0) - (b.defaultOrder || 0));
+        .filter(cmd => cmd.defaultOrder !== undefined)
+        .sort((a, b) => (a.defaultOrder ?? 0) - (b.defaultOrder ?? 0));
     // Generate commands with tighter alias spacing but proper table structure
     const commandsSection = defaultCommands
         .map(cmd => {
@@ -298,7 +232,7 @@ export const generateDefaultHelp = (colors = false) => {
         const nameColumn = cmd.name.padEnd(10);
         // Consistent args column (14 chars)
         const argsColumn = cmd.args.padEnd(16);
-        return `  ${s('dim', aliasColumn)}${s(['yellow', 'bold'], nameColumn)}${s('dim', argsColumn)}${cmd.desc}`;
+        return `  ${s('dim', aliasColumn)}${s(['yellow', 'bold'], nameColumn)}${s('dim', argsColumn)} ${cmd.desc}`;
     })
         .join('\n');
     return `${s(['bold'], '⚡️ vlt')} ${s('dim', '/vōlt/')} next-gen package management ${s('dim', `v${version}`)}
@@ -334,6 +268,8 @@ export const generateFullHelp = (colors = false) => {
     const s = makeStyler(colors);
     // Use all commands sorted alphabetically
     const commands = [...allCommands].sort((a, b) => a.name.localeCompare(b.name));
+    const aliasLabels = commands.map(cmd => cmd.aliases.length ? `${cmd.aliases.join(', ')},` : '');
+    const aliasWidth = Math.max(...aliasLabels.map(label => label.length));
     // Define only globally applicable flags (alphabetically sorted by long name)
     const flags = [
         {
@@ -388,17 +324,14 @@ export const generateFullHelp = (colors = false) => {
         if (firstLetter !== lastFirstLetter && index > 0) {
             commandsSection += '\n';
         }
-        // Fixed width columns for proper alignment with space after comma
-        const aliasColumn = cmd.aliases.length > 0 ?
-            (cmd.aliases.join(', ') + ', ').padEnd(9)
-            : '         ';
+        const aliasColumn = aliasLabels[index]?.padEnd(aliasWidth) ?? '';
         const nameColumn = cmd.name.padEnd(12);
         // Truncate args if longer than 16 chars and add ellipsis
         const truncatedArgs = cmd.args.length > 16 ?
             cmd.args.substring(0, 13) + '...'
             : cmd.args;
         const argsColumn = truncatedArgs.padEnd(16);
-        commandsSection += `${s('dim', aliasColumn)}${s(['yellow', 'bold'], nameColumn)}${s('dim', argsColumn)}${cmd.desc}`;
+        commandsSection += `  ${s('dim', aliasColumn)} ${s(['yellow', 'bold'], nameColumn)} ${s('dim', argsColumn)} ${cmd.desc}`;
         if (index < commands.length - 1) {
             commandsSection += '\n';
         }

package/dist/registry-error-message.d.ts

@@ -0,0 +1,2 @@
+import type { CacheEntry } from '@vltpkg/registry-client';
+export declare const registryErrorMessage: (response: CacheEntry) => string;

package/dist/registry-error-message.js

@@ -0,0 +1,29 @@
+import { STATUS_CODES } from 'node:http';
+export const registryErrorMessage = (response) => {
+    const statusMessage = STATUS_CODES[response.statusCode];
+    const status = `${response.statusCode}${statusMessage ? ` ${statusMessage}` : ''}`;
+    let text;
+    try {
+        text = response.text().trim();
+    }
+    catch {
+        return status;
+    }
+    if (!text)
+        return status;
+    let detail = text;
+    try {
+        const body = JSON.parse(text);
+        if (body &&
+            typeof body === 'object' &&
+            'error' in body &&
+            typeof body.error === 'string' &&
+            body.error) {
+            detail = body.error;
+        }
+    }
+    catch {
+        // A non-JSON response body is itself the most useful error detail.
+    }
+    return `${status} — ${detail}`;
+};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@vltpkg/cli-sdk",
   "description": "The source for the vlt CLI",
-  "version": "1.0.0-rc.33",
+  "version": "1.0.0-rc.34",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/vltpkg/vltpkg.git",
@@ -14,30 +14,30 @@
   },
   "dependencies": {
     "@resvg/resvg-wasm": "^2.6.2",
-    "@vltpkg/config": "1.0.0-rc.33",
-    "@vltpkg/dep-id": "1.0.0-rc.33",
-    "@vltpkg/dot-prop": "1.0.0-rc.33",
-    "@vltpkg/error-cause": "1.0.0-rc.33",
-    "@vltpkg/git": "1.0.0-rc.33",
-    "@vltpkg/graph": "1.0.0-rc.33",
-    "@vltpkg/graph-run": "1.0.0-rc.33",
-    "@vltpkg/init": "1.0.0-rc.33",
-    "@vltpkg/output": "1.0.0-rc.33",
-    "@vltpkg/package-info": "1.0.0-rc.33",
-    "@vltpkg/package-json": "1.0.0-rc.33",
-    "@vltpkg/promise-spawn": "1.0.0-rc.33",
-    "@vltpkg/query": "1.0.0-rc.33",
-    "@vltpkg/registry-client": "1.0.0-rc.33",
-    "@vltpkg/rollback-remove": "1.0.0-rc.33",
-    "@vltpkg/run": "1.0.0-rc.33",
-    "@vltpkg/security-archive": "1.0.0-rc.33",
-    "@vltpkg/spec": "1.0.0-rc.33",
-    "@vltpkg/types": "1.0.0-rc.33",
-    "@vltpkg/url-open": "1.0.0-rc.33",
-    "@vltpkg/vlt-json": "1.0.0-rc.33",
-    "@vltpkg/vlx": "1.0.0-rc.33",
-    "@vltpkg/workspaces": "1.0.0-rc.33",
-    "@vltpkg/xdg": "1.0.0-rc.33",
+    "@vltpkg/config": "1.0.0-rc.34",
+    "@vltpkg/dep-id": "1.0.0-rc.34",
+    "@vltpkg/dot-prop": "1.0.0-rc.34",
+    "@vltpkg/error-cause": "1.0.0-rc.34",
+    "@vltpkg/git": "1.0.0-rc.34",
+    "@vltpkg/graph": "1.0.0-rc.34",
+    "@vltpkg/graph-run": "1.0.0-rc.34",
+    "@vltpkg/init": "1.0.0-rc.34",
+    "@vltpkg/output": "1.0.0-rc.34",
+    "@vltpkg/package-info": "1.0.0-rc.34",
+    "@vltpkg/package-json": "1.0.0-rc.34",
+    "@vltpkg/promise-spawn": "1.0.0-rc.34",
+    "@vltpkg/query": "1.0.0-rc.34",
+    "@vltpkg/registry-client": "1.0.0-rc.34",
+    "@vltpkg/rollback-remove": "1.0.0-rc.34",
+    "@vltpkg/run": "1.0.0-rc.34",
+    "@vltpkg/security-archive": "1.0.0-rc.34",
+    "@vltpkg/spec": "1.0.0-rc.34",
+    "@vltpkg/types": "1.0.0-rc.34",
+    "@vltpkg/url-open": "1.0.0-rc.34",
+    "@vltpkg/vlt-json": "1.0.0-rc.34",
+    "@vltpkg/vlx": "1.0.0-rc.34",
+    "@vltpkg/workspaces": "1.0.0-rc.34",
+    "@vltpkg/xdg": "1.0.0-rc.34",
     "ansi-to-pre": "^1.0.6",
     "beautiful-mermaid": "^1.1.3",
     "chalk": "^5.6.2",