@rankwrangler/cli 0.4.0 → 0.5.0

package/README.md

@@ -11,17 +11,26 @@ npm install -g @rankwrangler/cli
 ## Usage
 
 ```bash
-export RR_LICENSE_KEY=rrk_...
+rw --version
+rw changelog
+rw auth set rrk_...
 rw config set storage-dir ~/.config/rankwrangler
 rw products get B0DV53VS61
 rw products history B0DV53VS61 --metrics bsr,price
+RR_LICENSE_KEY=rrk_... rw license status
 # `rankwrangler` is also supported as an alias
 ```
 
-`RR_LICENSE_KEY` is the API-key source. `rw config set storage-dir <path>` saves the
-active storage directory globally. After that, every CLI command reads and writes its non-secret
-config/data from that directory, while preserving existing config values when switching.
-`RR_STORAGE_DIR`, `RR_API_URL`, and `RR_MARKETPLACE_ID` override saved CLI config when set.
+`rw auth set <licenseKey>` stores the license key in the platform secure store
+(`macOS Keychain` on macOS). `rw auth status` reports whether the CLI will use an env override,
+stored auth, or no auth. `rw auth clear` removes the stored key.
+
+`rw config set storage-dir <path>` saves the active storage directory globally. After that, every
+CLI command reads and writes its non-secret config/data from that directory, while preserving
+existing config values when switching. `RR_LICENSE_KEY`, `RR_STORAGE_DIR`, `RR_API_URL`, and
+`RR_MARKETPLACE_ID` override saved CLI state when set for CI, automation, or agent runtimes.
+`rw --version` prints the installed CLI version. `rw changelog` prints the latest bundled release
+notes shipped with the package.
 
 ## Development
 
@@ -46,6 +55,9 @@ bun run release:check-cli-pack
 
 Then publish:
 
+Publish `packages/http-client` first. `packages/cli` now fails fast on `npm publish` until the
+matching `@rankwrangler/http-client` version is already available on npm.
+
 ```bash
 cd packages/cli
 set -a

package/dist/CHANGELOG.md

@@ -0,0 +1,205 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## v0.5.0 - 2026-03-18
+
+### Added
+
+- Add CLI secure-store auth with `rw auth set`, `rw auth status`, and `rw auth clear`, storing
+  license keys in the platform secure store while keeping `RR_LICENSE_KEY` as an override for
+  CI, automation, and agent runtimes.
+
+### Changed
+
+- Change local development defaults so the app server no longer starts the job runner unless you
+  use the explicit jobs-enabled dev commands.
+
+### Fixed
+
+- Fix top search terms scheduler timestamp handling so due datasets are selected and refreshed
+  reliably.
+
+## v0.4.1 - 2026-03-09
+
+### Added
+
+- Add CLI `rw --version` and `rw changelog` commands, including bundled release notes in the
+  published npm package.
+
+### Changed
+
+- Rotate API key generation by email so creating a new key for the same email replaces older
+  active keys.
+- Remove the remaining PostHog integration from the server runtime, config, and related docs.
+
+### Fixed
+
+- Make CLI publish fail fast until the matching `@rankwrangler/http-client` version is already on
+  npm, reducing release-order mistakes.
+
+## v0.4.0 - 2026-03-09
+
+### Added
+
+- Add `RR_STORAGE_DIR` and document CLI env vars in `.env.example` so local CLI testing can use
+  env-based configuration end to end.
+
+### Changed
+
+- Make CLI environment variables override saved config for storage-dir, API origin, and
+  marketplace values.
+
+### Fixed
+
+- Fix the built CLI package to run under Node after the CLI module split and strengthen release
+  pack validation around the built artifact.
+
+## v0.3.0 - 2026-03-09
+
+### Added
+
+- Add BA Top Search Terms ingestion, trend views, keyword search, and job execution visibility
+  across the dashboard.
+- Add product facet classification, facet metrics, and facet badges to improve dashboard filtering
+  and product detail context.
+- Add persistent CLI storage-directory support so local CLI config/data can move to a custom path.
+- Add `RR_STORAGE_DIR` so CLI storage location can be controlled by environment as well as saved
+  config.
+
+### Changed
+
+- Redesign the search terms dashboard UI with richer toolbar controls, stat sparklines, clearer
+  metric timing, and stronger layout polish.
+- Improve top search terms scheduling, batching, report polling, and status performance so refresh
+  throughput and visibility stay stable as datasets grow.
+- Centralize adaptive SP-API limiter tuning and expose limiter stats for better operational control.
+- Breaking: require `RR_LICENSE_KEY` for CLI auth and stop storing API keys in CLI config.
+
+### Fixed
+
+- Fix weekly top search terms windows to align to Sunday-Saturday boundaries and correct
+  reclassification batch payload handling.
+- Tighten merch keyword filtering and category-slot parsing to reduce seasonal/accessory noise
+  without dropping valid terms.
+- Fix Node runtime imports in the built CLI package and strengthen release pack validation after
+  the CLI module split.
+- Fix facet metrics timestamp anchoring, SQL casting, and drawer badge data flow in dashboard
+  surfaces.
+
+## v0.2.3 - 2026-03-01
+
+### Added
+
+- Add CLI `products history` agent output for BSR and price metric series.
+- Add dashboard logs page and event log pipeline with Keepa queue/poll visibility.
+- Add tiered Keepa scheduling with improved enqueue metrics and status reporting.
+- Add shared history chart usage across website and extension surfaces.
+- Add extension UI preview workflow updates with safer placeholder license key handling.
+
+### Changed
+
+- Handle SP-API no-payload catalog responses as product deletions in sync flows.
+- Refine event logging behavior, server documentation, and Keepa policy labeling.
+
+### Fixed
+
+- Fix product drawer chart skeleton height and sponsored carousel stats placement.
+- Fix Caddy build wiring to include the history-chart workspace dependency.
+- Improve dashboard log view layout behavior and readability.
+
+## v0.2.2 - 2026-02-24
+
+### Added
+
+- Add dashboard-style BSR chart styling to the extension product view.
+- Add Keepa stale sync tests and documentation coverage.
+
+### Changed
+
+- Add bottom border to the appearance settings section for stronger visual separation.
+- Clarify agent guidance for work-in-progress rewrite expectations.
+
+### Fixed
+
+- Clarify history chart date labeling behavior.
+
+## v0.2.1 - 2026-02-22
+
+### Added
+
+- Add fuzzy dashboard product search and stronger filter-driven sidebar workflows.
+- Add extension BSR history graph flow, including history sheet deep-linking from BSR badges.
+- Add admin job runtime observability, queue log browsing, and per-source drilldown stats.
+- Add Keepa sync loading states and richer history date-range controls.
+
+### Changed
+
+- Move product ingest processing to an event-driven queue flow and align Keepa refresh to one-shot
+  enqueue jobs.
+- Rename ingest queue labeling to the SP-API sync queue across admin surfaces.
+- Refine BSR/history chart interactions, sparse-range handling, and loading/empty-state behavior.
+- Improve extension build prebuild dependency handling and dashboard/admin UI polish.
+- Clarify docs for Keepa automatic vs manual behavior.
+
+## v0.2.0 - 2026-02-20
+
+### Added
+
+- Add Keepa history import flow and dashboard history UI.
+- Add Keepa refresh queue processing and Keepa status metrics in the dashboard.
+- Add admin job runtime observability endpoints and dashboard visibility.
+- Add extension BSR history modal with on-demand history loading flow.
+- Add public + app product history query/load procedures for Keepa-backed BSR history.
+- Add public API usage consumption to history query/load endpoints to enforce API key limits.
+
+### Changed
+
+- Align Keepa refresh behavior to a one-shot enqueue model.
+- Redesign dashboard sidebar header/layout, Keepa history panel, filters, and settings modal UX.
+- Standardize external naming to `API key` across public API routes, CLI commands, extension UI
+  copy, and related docs.
+- Rename CLI auth commands from `license status|validate` to `api-key status|validate`.
+- Rename public API auth namespace from `api.public.license.*` to `api.public.apiKey.*` and app
+  namespace from `api.app.license.*` to `api.app.apiKey.*`.
+- Switch CLI environment fallback from `RR_LICENSE_KEY` to `RR_API_KEY`.
+
+### Fixed
+
+- Fix Keepa fetch worker job payload handling.
+
+## v0.1.3 - 2026-02-17
+
+### Changed
+
+- Set `@rankwrangler/cli` to expose both `rw` (primary) and `rankwrangler` binaries.
+- Tighten CLI help output into a concise man-style format and remove principles text from runtime
+  help.
+- Remove legacy CLI command and flag aliases by default (`get-product-info`,
+  `get-product-info-batch`, `products get-batch`, `--licenseKey`, `--url`, `--marketplaceId`,
+  `--asins`).
+- Add explicit CLI policy guidance that legacy aliases/compatibility shims require explicit user
+  direction.
+
+## v0.1.2 - 2026-02-17
+
+### Changed
+
+- Update extension's pinned HTTP client tarball dependency to
+  `rankwrangler-http-client-0.1.2.tgz`.
+- Update release docs to require synchronized versions between `CHANGELOG.md` releases and npm
+  packages.
+
+## v0.1.0 - 2026-02-16
+
+### Added
+
+- Add public batch product endpoint (`api.public.getProductInfoBatch`) to support multi-ASIN workflows.
+- Add CLI multi-ASIN product lookup (`products get <asin...>`) with default marketplace config and per-command override (`--marketplace` / `-m`).
+- Add public license usage endpoints used by CLI/public HTTP clients for status and consume flows.
+
+### Changed
+
+- Rename and standardize the typed npm client package to `@merchbase/rankwrangler-http-client`.
+- Set initial HTTP client package release to `0.1.0` in `packages/http-client/package.json`.
+- Document npm publish and versioning policy for the typed HTTP client in `docs/http-client-spec.md`.

package/dist/cli-auth.d.ts

@@ -0,0 +1,86 @@
+export declare const LICENSE_KEY_ENV_VAR = "RR_LICENSE_KEY";
+export declare const AUTH_SERVICE_NAME = "RankWrangler CLI";
+export declare const AUTH_ACCOUNT_NAME = "license-key";
+type CliFail = (code: string, message: string, details?: unknown) => never;
+type AuthCommand = {
+    verb: string;
+    args: string[];
+};
+export declare class CliAuthError extends Error {
+    readonly code: string;
+    readonly details?: unknown;
+    constructor(code: string, message: string, details?: unknown);
+}
+export declare const resolveApiKey: () => Promise<string | undefined>;
+export declare const runAuthCommand: (command: AuthCommand, fail: CliFail) => Promise<{
+    source: string;
+    envOverride: boolean;
+    secureStore: {
+        backend: string;
+        serviceName: string;
+        accountName: string;
+        available: boolean;
+        hasStoredLicenseKey: boolean;
+        error?: undefined;
+    };
+} | {
+    source: string;
+    envOverride: boolean;
+    secureStore: {
+        backend: string;
+        serviceName: string;
+        accountName: string;
+        available: boolean;
+        hasStoredLicenseKey: null;
+        error: string;
+    };
+} | {
+    saved: boolean;
+    source: string;
+    envOverride: boolean;
+    secureStore: {
+        backend: string;
+        serviceName: string;
+        accountName: string;
+        available: boolean;
+        hasStoredLicenseKey: boolean;
+        error?: undefined;
+    };
+} | {
+    saved: boolean;
+    source: string;
+    envOverride: boolean;
+    secureStore: {
+        backend: string;
+        serviceName: string;
+        accountName: string;
+        available: boolean;
+        hasStoredLicenseKey: null;
+        error: string;
+    };
+} | {
+    cleared: boolean;
+    source: string;
+    envOverride: boolean;
+    secureStore: {
+        backend: string;
+        serviceName: string;
+        accountName: string;
+        available: boolean;
+        hasStoredLicenseKey: boolean;
+        error?: undefined;
+    };
+} | {
+    cleared: boolean;
+    source: string;
+    envOverride: boolean;
+    secureStore: {
+        backend: string;
+        serviceName: string;
+        accountName: string;
+        available: boolean;
+        hasStoredLicenseKey: null;
+        error: string;
+    };
+}>;
+export {};

package/dist/cli-auth.js

@@ -0,0 +1,171 @@
+import { mkdir, readFile, rm, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+export const LICENSE_KEY_ENV_VAR = 'RR_LICENSE_KEY';
+export const AUTH_SERVICE_NAME = 'RankWrangler CLI';
+export const AUTH_ACCOUNT_NAME = 'license-key';
+const INTERNAL_SECRET_STORE_DIR_ENV_VAR = 'RW_INTERNAL_CLI_SECRET_STORE_DIR';
+export class CliAuthError extends Error {
+    code;
+    details;
+    constructor(code, message, details) {
+        super(message);
+        this.name = 'CliAuthError';
+        this.code = code;
+        this.details = details;
+    }
+}
+export const resolveApiKey = async () => {
+    const envLicenseKey = resolveEnvLicenseKey();
+    if (envLicenseKey) {
+        return envLicenseKey;
+    }
+    const secureStore = await createSecureStore();
+    return (await secureStore.get()) ?? undefined;
+};
+export const runAuthCommand = async (command, fail) => {
+    if (command.verb === 'status') {
+        return buildAuthStatus();
+    }
+    if (command.verb === 'set') {
+        const value = resolveAuthSetValue(command.args, fail);
+        const secureStore = await createSecureStore();
+        await secureStore.set(value);
+        return {
+            ...(await buildAuthStatus()),
+            saved: true,
+        };
+    }
+    if (command.verb === 'clear') {
+        const secureStore = await createSecureStore();
+        const cleared = await secureStore.clear();
+        return {
+            ...(await buildAuthStatus()),
+            cleared,
+        };
+    }
+    fail('UNKNOWN_COMMAND', 'Unknown auth command', { verb: command.verb });
+};
+const buildAuthStatus = async () => {
+    const envLicenseKey = resolveEnvLicenseKey();
+    try {
+        const secureStore = await createSecureStore();
+        const storedLicenseKey = await secureStore.get();
+        return {
+            source: envLicenseKey ? 'env' : storedLicenseKey ? 'secure-store' : 'none',
+            envOverride: Boolean(envLicenseKey),
+            secureStore: {
+                backend: secureStore.backend,
+                serviceName: secureStore.serviceName,
+                accountName: secureStore.accountName,
+                available: true,
+                hasStoredLicenseKey: Boolean(storedLicenseKey),
+            },
+        };
+    }
+    catch (error) {
+        return {
+            source: envLicenseKey ? 'env' : 'none',
+            envOverride: Boolean(envLicenseKey),
+            secureStore: {
+                backend: getSecureStoreBackendLabel(),
+                serviceName: AUTH_SERVICE_NAME,
+                accountName: AUTH_ACCOUNT_NAME,
+                available: false,
+                hasStoredLicenseKey: null,
+                error: error instanceof Error ? error.message : 'Unknown secure-store error',
+            },
+        };
+    }
+};
+const resolveAuthSetValue = (args, fail) => {
+    const positionalValue = args.join(' ').trim();
+    if (positionalValue) {
+        return positionalValue;
+    }
+    const envLicenseKey = resolveEnvLicenseKey();
+    if (envLicenseKey) {
+        return envLicenseKey;
+    }
+    fail('INVALID_INPUT', `auth set requires <licenseKey> or ${LICENSE_KEY_ENV_VAR}`);
+};
+const resolveEnvLicenseKey = () => {
+    const value = process.env[LICENSE_KEY_ENV_VAR]?.trim();
+    return value ? value : undefined;
+};
+const createSecureStore = async () => {
+    const internalSecretStoreDir = process.env[INTERNAL_SECRET_STORE_DIR_ENV_VAR]?.trim();
+    if (internalSecretStoreDir) {
+        return createFileSecretStore(path.resolve(internalSecretStoreDir));
+    }
+    const keytar = await loadKeytar();
+    return {
+        backend: getSecureStoreBackendLabel(),
+        serviceName: AUTH_SERVICE_NAME,
+        accountName: AUTH_ACCOUNT_NAME,
+        get: () => keytar.getPassword(AUTH_SERVICE_NAME, AUTH_ACCOUNT_NAME),
+        set: value => keytar.setPassword(AUTH_SERVICE_NAME, AUTH_ACCOUNT_NAME, value),
+        clear: () => keytar.deletePassword(AUTH_SERVICE_NAME, AUTH_ACCOUNT_NAME),
+    };
+};
+const loadKeytar = async () => {
+    try {
+        const imported = (await import('keytar'));
+        return imported.default ?? imported;
+    }
+    catch (error) {
+        throw new CliAuthError('SECURE_STORE_UNAVAILABLE', 'platform secure store is unavailable', error instanceof Error ? { cause: error.message } : undefined);
+    }
+};
+const getSecureStoreBackendLabel = () => {
+    switch (process.platform) {
+        case 'darwin':
+            return 'macos-keychain';
+        case 'win32':
+            return 'windows-credential-manager';
+        default:
+            return 'platform-secure-store';
+    }
+};
+const createFileSecretStore = (secretStoreDir) => {
+    const secretPath = path.join(secretStoreDir, 'license-key.json');
+    return {
+        backend: 'test-file-store',
+        serviceName: AUTH_SERVICE_NAME,
+        accountName: AUTH_ACCOUNT_NAME,
+        get: async () => {
+            try {
+                const raw = await readFile(secretPath, 'utf8');
+                const parsed = JSON.parse(raw);
+                return typeof parsed.licenseKey === 'string' ? parsed.licenseKey : null;
+            }
+            catch (error) {
+                if (error &&
+                    typeof error === 'object' &&
+                    'code' in error &&
+                    error.code === 'ENOENT') {
+                    return null;
+                }
+                throw new CliAuthError('INVALID_CONFIG', 'failed to read secure-store test data');
+            }
+        },
+        set: async (value) => {
+            await mkdir(secretStoreDir, { recursive: true });
+            await writeFile(secretPath, `${JSON.stringify({ licenseKey: value }, null, 2)}\n`, 'utf8');
+        },
+        clear: async () => {
+            try {
+                await rm(secretPath);
+                return true;
+            }
+            catch (error) {
+                if (error &&
+                    typeof error === 'object' &&
+                    'code' in error &&
+                    error.code === 'ENOENT') {
+                    return false;
+                }
+                throw error;
+            }
+        },
+    };
+};

package/dist/cli-config-command.d.ts

@@ -0,0 +1,19 @@
+import { type CliConfig, type CliPaths } from './cli-config';
+type CliFail = (code: string, message: string, details?: unknown) => never;
+type ConfigCommand = {
+    verb: string;
+    args: string[];
+};
+export declare const runConfigCommand: (command: ConfigCommand, config: CliConfig, paths: CliPaths, fail: CliFail) => Promise<{
+    storageDir: string;
+    path: string;
+    globalPath: string;
+    config: CliConfig;
+} | {
+    cleared: boolean;
+    storageDir: string;
+    path: string;
+    globalPath: string;
+    config: CliConfig;
+}>;
+export {};

package/dist/cli-config-command.js

@@ -0,0 +1,56 @@
+import { clearConfig, saveConfig, switchStorageDir } from './cli-config.js';
+import { normalizeBaseUrl } from './cli-options.js';
+export const runConfigCommand = async (command, config, paths, fail) => {
+    if (command.verb === 'show') {
+        return buildConfigResponse(paths, config);
+    }
+    if (command.verb === 'clear') {
+        await clearConfig(paths);
+        return {
+            ...buildConfigResponse(paths, {}),
+            cleared: true,
+        };
+    }
+    if (command.verb !== 'set') {
+        fail('UNKNOWN_COMMAND', 'Unknown config command', { verb: command.verb });
+    }
+    const [key, ...valueParts] = command.args;
+    if (!key || valueParts.length === 0) {
+        fail('INVALID_INPUT', 'config set requires <key> <value>');
+    }
+    const value = valueParts.join(' ').trim();
+    if (!value) {
+        fail('INVALID_INPUT', 'config set value cannot be empty');
+    }
+    if (key === 'storage-dir') {
+        const nextState = await switchStorageDir({
+            currentConfig: config,
+            currentPaths: paths,
+            requestedStorageDir: value,
+        });
+        return buildConfigResponse(nextState.paths, nextState.config);
+    }
+    const nextConfig = { ...config };
+    if (key === 'base-url') {
+        nextConfig.baseUrl = normalizeBaseUrl(value, fail);
+    }
+    else if (key === 'marketplace') {
+        nextConfig.marketplaceId = value;
+    }
+    else {
+        fail('INVALID_INPUT', 'unsupported config key', {
+            key,
+            supportedKeys: ['base-url', 'marketplace', 'storage-dir'],
+        });
+    }
+    await saveConfig(paths, nextConfig);
+    return buildConfigResponse(paths, nextConfig);
+};
+const buildConfigResponse = (paths, config) => {
+    return {
+        storageDir: paths.storageDir,
+        path: paths.configPath,
+        globalPath: paths.globalConfigPath,
+        config,
+    };
+};

package/dist/cli-metadata.d.ts

@@ -0,0 +1,2 @@
+export declare const printCliVersion: () => void;
+export declare const printBundledChangelog: () => void;

package/dist/cli-metadata.js

@@ -0,0 +1,31 @@
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+const PACKAGE_JSON_PATH = fileURLToPath(new URL('../package.json', import.meta.url));
+const CHANGELOG_PATH = fileURLToPath(new URL('./CHANGELOG.md', import.meta.url));
+const RELEASE_HEADING_PATTERN = /^## v\d+\.\d+\.\d+ - \d{4}-\d{2}-\d{2}$/gm;
+export const printCliVersion = () => {
+    const metadata = readPackageMetadata();
+    console.log(metadata.version);
+};
+export const printBundledChangelog = () => {
+    const changelog = readBundledChangelog();
+    const latestEntry = extractLatestReleaseEntry(changelog);
+    console.log(latestEntry);
+};
+const readPackageMetadata = () => {
+    return JSON.parse(readFileSync(PACKAGE_JSON_PATH, 'utf8'));
+};
+const readBundledChangelog = () => {
+    return readFileSync(CHANGELOG_PATH, 'utf8').trim();
+};
+const extractLatestReleaseEntry = (changelog) => {
+    const matches = Array.from(changelog.matchAll(RELEASE_HEADING_PATTERN));
+    if (matches.length === 0) {
+        throw new Error('Bundled changelog is missing a release entry');
+    }
+    const latestMatch = matches[0];
+    const nextMatch = matches[1];
+    const start = latestMatch.index ?? 0;
+    const end = nextMatch?.index ?? changelog.length;
+    return changelog.slice(start, end).trim();
+};

package/dist/cli-options.d.ts

@@ -11,6 +11,7 @@ export type CliOptionValues = {
     days?: string;
     limit?: string;
     help?: boolean;
+    version?: boolean;
 };
 export declare const requireMarketplaceId: (values: CliOptionValues, config: CliConfig) => string;
 export declare const requireAsins: (commandArgs: string[], values: CliOptionValues, fail: CliFail) => string[];
@@ -21,7 +22,6 @@ export declare const resolveHistoryWindow: (values: CliOptionValues, fail: CliFa
     endAt?: string | undefined;
     startAt?: string | undefined;
 };
-export declare const resolveApiKey: () => string | undefined;
 export declare const resolveBaseUrl: (values: CliOptionValues, config: CliConfig, defaultBaseUrl: string, fail: CliFail) => string;
 export declare const normalizeBaseUrl: (value: string, fail: CliFail) => string;
 export declare const parseIntegerOption: ({ value, optionName, min, max, defaultValue, }: {

package/dist/cli-options.js

@@ -56,9 +56,6 @@ export const resolveHistoryWindow = (values, fail) => {
         }, fail),
     };
 };
-export const resolveApiKey = () => {
-    return process.env.RR_LICENSE_KEY;
-};
 export const resolveBaseUrl = (values, config, defaultBaseUrl, fail) => {
     return normalizeBaseUrl(values.baseUrl ?? config.baseUrl ?? process.env.RR_API_URL ?? defaultBaseUrl, fail);
 };

package/dist/cli-output.js

@@ -1,3 +1,4 @@
+import { CliAuthError } from './cli-auth.js';
 import { CliStorageError } from './cli-config.js';
 const OUTPUT_PRETTY = true;
 export const printSuccess = (data) => {
@@ -27,6 +28,13 @@ export const resolveError = (error) => {
             details: error.details,
         };
     }
+    if (error instanceof CliAuthError) {
+        return {
+            code: error.code,
+            message: error.message,
+            details: error.details,
+        };
+    }
     if (error && typeof error === 'object' && 'data' in error) {
         const data = error.data;
         if (data?.code) {

package/dist/index.js

@@ -1,8 +1,11 @@
 #!/usr/bin/env node
 import { parseArgs } from 'node:util';
 import { createRankWranglerClient, DEFAULT_API_BASE_URL } from '@rankwrangler/http-client';
-import { clearConfig, loadCliContext, loadCliPathsOrDefault, saveConfig, switchStorageDir, } from './cli-config.js';
-import { normalizeBaseUrl, parseIntegerOption, requireAsins, requireMarketplaceId, requireSingleAsin, resolveApiKey, resolveBaseUrl, resolveHistoryMetrics, resolveHistoryWindow, } from './cli-options.js';
+import { resolveApiKey, runAuthCommand } from './cli-auth.js';
+import { printBundledChangelog, printCliVersion } from './cli-metadata.js';
+import { runConfigCommand } from './cli-config-command.js';
+import { loadCliContext, loadCliPathsOrDefault } from './cli-config.js';
+import { parseIntegerOption, requireAsins, requireMarketplaceId, requireSingleAsin, resolveBaseUrl, resolveHistoryMetrics, resolveHistoryWindow, } from './cli-options.js';
 import { fail, printSuccess, resolveError } from './cli-output.js';
 import { buildCliHistoryResponse } from './history-response.js';
 import { printUsage } from './usage.js';
@@ -11,6 +14,9 @@ const SUPPORTED_COMMANDS = new Set([
     'products:history',
     'license:status',
     'license:validate',
+    'auth:status',
+    'auth:set',
+    'auth:clear',
     'config:show',
     'config:clear',
     'config:set',
@@ -19,6 +25,7 @@ const { positionals, values } = parseArgs({
     args: process.argv.slice(2),
     options: {
         help: { type: 'boolean', short: 'h' },
+        version: { type: 'boolean' },
         baseUrl: { type: 'string' },
         marketplace: { type: 'string', short: 'm' },
         asin: { type: 'string', multiple: true },
@@ -32,10 +39,21 @@ const { positionals, values } = parseArgs({
 });
 const main = async () => {
     const optionValues = values;
+    if (optionValues.version) {
+        printCliVersion();
+        return;
+    }
     if (values.help || positionals.length === 0) {
         printUsage(await loadCliPathsOrDefault());
         process.exit(values.help ? 0 : 1);
     }
+    const metaCommand = resolveMetaCommand(positionals);
+    if (metaCommand) {
+        if (metaCommand.name === 'changelog') {
+            printBundledChangelog();
+            return;
+        }
+    }
     const command = resolveCommandOrFail(positionals);
     if (!isSupportedCommand(command)) {
         fail('UNKNOWN_COMMAND', 'Unknown command', {
@@ -44,12 +62,16 @@ const main = async () => {
     }
     const { config, paths } = await loadCliContext();
     if (command.resource === 'config') {
-        printSuccess(await runConfigCommand(command, config, paths));
+        printSuccess(await runConfigCommand(command, config, paths, fail));
+        return;
+    }
+    if (command.resource === 'auth') {
+        printSuccess(await runAuthCommand(command, fail));
         return;
     }
-    const apiKey = resolveApiKey();
+    const apiKey = await resolveApiKey();
     if (!apiKey) {
-        fail('MISSING_CONFIG', 'api key is required. set RR_LICENSE_KEY');
+        fail('MISSING_CONFIG', 'license key is required. run `rw auth set <licenseKey>` or set RR_LICENSE_KEY');
     }
     const client = createRankWranglerClient({
         baseUrl: resolveBaseUrl(optionValues, config, DEFAULT_API_BASE_URL, fail),
@@ -108,59 +130,11 @@ const runProductHistoryCommand = async (command, client, config) => {
         response: response,
     });
 };
-const runConfigCommand = async (command, config, paths) => {
-    if (command.verb === 'show') {
-        return buildConfigResponse(paths, config);
-    }
-    if (command.verb === 'clear') {
-        await clearConfig(paths);
-        return {
-            ...buildConfigResponse(paths, {}),
-            cleared: true,
-        };
-    }
-    if (command.verb !== 'set') {
-        fail('UNKNOWN_COMMAND', 'Unknown config command', { verb: command.verb });
-    }
-    const [key, ...valueParts] = command.args;
-    if (!key || valueParts.length === 0) {
-        fail('INVALID_INPUT', 'config set requires <key> <value>');
-    }
-    const value = valueParts.join(' ').trim();
-    if (!value) {
-        fail('INVALID_INPUT', 'config set value cannot be empty');
+const resolveMetaCommand = (inputPositionals) => {
+    if (inputPositionals.length === 1 && inputPositionals[0] === 'changelog') {
+        return { name: 'changelog' };
     }
-    if (key === 'storage-dir') {
-        const nextState = await switchStorageDir({
-            currentConfig: config,
-            currentPaths: paths,
-            requestedStorageDir: value,
-        });
-        return buildConfigResponse(nextState.paths, nextState.config);
-    }
-    const nextConfig = { ...config };
-    if (key === 'base-url') {
-        nextConfig.baseUrl = normalizeBaseUrl(value, fail);
-    }
-    else if (key === 'marketplace') {
-        nextConfig.marketplaceId = value;
-    }
-    else {
-        fail('INVALID_INPUT', 'unsupported config key', {
-            key,
-            supportedKeys: ['base-url', 'marketplace', 'storage-dir'],
-        });
-    }
-    await saveConfig(paths, nextConfig);
-    return buildConfigResponse(paths, nextConfig);
-};
-const buildConfigResponse = (paths, config) => {
-    return {
-        storageDir: paths.storageDir,
-        path: paths.configPath,
-        globalPath: paths.globalConfigPath,
-        config,
-    };
+    return null;
 };
 const resolveCommand = (inputPositionals) => {
     const [first, second, ...rest] = inputPositionals;

package/dist/usage.js

@@ -1,3 +1,4 @@
+import { LICENSE_KEY_ENV_VAR } from './cli-auth.js';
 const DEFAULT_MARKETPLACE_ID = 'ATVPDKIKX0DER';
 export const printUsage = (paths) => {
     const usage = [
@@ -5,14 +6,22 @@ export const printUsage = (paths) => {
         '  rw, rankwrangler - RankWrangler command line interface',
         '',
         'SYNOPSIS',
+        '  rw --version',
+        '  rankwrangler --version',
+        '  rw changelog',
+        '  rankwrangler changelog',
         '  rw <resource> <verb> [args...] [options]',
         '  rankwrangler <resource> <verb> [args...] [options]',
         '',
         'COMMANDS',
+        '  changelog',
         '  products get <ASIN...>',
         '  products history <ASIN>',
         '  license status',
         '  license validate',
+        '  auth status',
+        '  auth set <licenseKey>',
+        '  auth clear',
         '  config show',
         '  config clear',
         '  config set base-url <origin>',
@@ -21,6 +30,7 @@ export const printUsage = (paths) => {
         '',
         'OPTIONS',
         '  -h, --help               Show this help message',
+        '  --version                Print the CLI version',
         '  --baseUrl <origin>       Override API origin',
         `  -m, --marketplace <id>   Override marketplace (default: ${DEFAULT_MARKETPLACE_ID})`,
         '  --asin <ASIN>            Add ASIN (repeatable)',
@@ -35,7 +45,7 @@ export const printUsage = (paths) => {
         `  ${paths.globalConfigPath}           Global CLI settings`,
         '',
         'ENVIRONMENT',
-        '  RR_LICENSE_KEY           API key source',
+        `  ${LICENSE_KEY_ENV_VAR}           License key override for CI/automation`,
         '  RR_API_URL               API origin fallback',
         '  RR_MARKETPLACE_ID        Marketplace fallback',
         '  RR_STORAGE_DIR           Storage directory override',
@@ -44,8 +54,11 @@ export const printUsage = (paths) => {
         '  RR_HISTORY_METRICS       Comma-separated history metrics fallback',
         '',
         'EXAMPLES',
-        '  RR_LICENSE_KEY=rrk_... rw products get B0DV53VS61',
+        '  rw auth set rrk_...',
+        `  ${LICENSE_KEY_ENV_VAR}=rrk_... rw products get B0DV53VS61`,
         '  RR_STORAGE_DIR=~/.config/rankwrangler rw config show',
+        '  rw --version',
+        '  rw changelog',
         '  rw config set storage-dir ~/.config/rankwrangler',
         '  rw products history B0DV53VS61 --metrics bsr,price',
         '  rw products history B0DV53VS61 --startAt 2025-01-01 --endAt 2025-12-31',

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@rankwrangler/cli",
-    "version": "0.4.0",
+    "version": "0.5.0",
     "description": "Official RankWrangler command line interface",
     "type": "module",
     "bin": {
@@ -14,14 +14,17 @@
         "README.md"
     ],
     "scripts": {
-        "build": "tsc -p tsconfig.json && node scripts/fix-dist-imports.mjs",
-        "test:e2e": "bun test test/index.e2e.test.ts"
+        "build": "tsc -p tsconfig.json && node scripts/fix-dist-imports.mjs && node scripts/sync-changelog.mjs",
+        "prepack": "node scripts/sync-changelog.mjs",
+        "test:e2e": "bun test test/index.e2e.test.ts",
+        "prepublishOnly": "node ../../scripts/release/ensure-cli-http-client-published.mjs"
     },
     "publishConfig": {
         "access": "public"
     },
     "dependencies": {
-        "@rankwrangler/http-client": "^0.4.0"
+        "@rankwrangler/http-client": "^0.5.0",
+        "keytar": "^7.9.0"
     },
     "devDependencies": {
         "@types/node": "^24.3.0",