@rankwrangler/cli 0.4.0 → 0.4.1

package/README.md

@@ -12,6 +12,8 @@ npm install -g @rankwrangler/cli
 
 ```bash
 export RR_LICENSE_KEY=rrk_...
+rw --version
+rw changelog
 rw config set storage-dir ~/.config/rankwrangler
 rw products get B0DV53VS61
 rw products history B0DV53VS61 --metrics bsr,price
@@ -22,6 +24,8 @@ rw products history B0DV53VS61 --metrics bsr,price
 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 --version` prints the installed CLI version. `rw changelog` prints the latest bundled release
+notes shipped with the package.
 
 ## Development
 
@@ -46,6 +50,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,187 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## 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-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[];

package/dist/index.js

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 import { parseArgs } from 'node:util';
 import { createRankWranglerClient, DEFAULT_API_BASE_URL } from '@rankwrangler/http-client';
+import { printBundledChangelog, printCliVersion } from './cli-metadata.js';
 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 { fail, printSuccess, resolveError } from './cli-output.js';
@@ -19,6 +20,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 +34,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', {
@@ -162,6 +175,12 @@ const buildConfigResponse = (paths, config) => {
         config,
     };
 };
+const resolveMetaCommand = (inputPositionals) => {
+    if (inputPositionals.length === 1 && inputPositionals[0] === 'changelog') {
+        return { name: 'changelog' };
+    }
+    return null;
+};
 const resolveCommand = (inputPositionals) => {
     const [first, second, ...rest] = inputPositionals;
     if (!first || !second) {

package/dist/usage.js

@@ -5,10 +5,15 @@ 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',
@@ -21,6 +26,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)',
@@ -46,6 +52,8 @@ export const printUsage = (paths) => {
         'EXAMPLES',
         '  RR_LICENSE_KEY=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.4.1",
     "description": "Official RankWrangler command line interface",
     "type": "module",
     "bin": {
@@ -14,14 +14,16 @@
         "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.4.1"
     },
     "devDependencies": {
         "@types/node": "^24.3.0",