@rankwrangler/cli 0.12.0 → 0.13.0

package/dist/CHANGELOG.md

@@ -2,6 +2,32 @@
 
 All notable changes to this project will be documented in this file.
 
+## v0.13.0 - 2026-10-28
+
+### Added
+
+- Rebuild the website on HeroUI Pro: Explore and Keywords grids with filter sidebars and counts,
+  KPI bands, BSR sparklines, a pager, and a full Product page.
+- Drive keywords from Brand Analytics searches and keyword themes for every Merch product type,
+  with five relevant keywords selected per product and collection run as gated jobs.
+- Detect Merch products by part number and keep scans Merch-only; the Merch re-check can demote
+  false positives.
+- Push keyword, sync and log changes live over the tRPC WebSocket.
+
+### Changed
+
+- Breaking: public keyword reads replace `state`, `status` and `untrackedReason` with `stage`
+  (`graduated`, `trial`, `dropped`, `untracked`) and `freshness` (`live`, `needsSync`, `syncing`),
+  and add `searchFrequencyRank`.
+- Re-check graduated keywords ahead of trials, tune scan rate and depth with daily provider
+  ceilings, and let live searches win Keepa capacity over background work.
+
+### Fixed
+
+- Answer live catalog searches before saving Product history, and record why failed searches
+  failed.
+- Adapt Ads pacing to 429 responses and drop Keepa's no-category sentinel rank.
+
 ## v0.12.0 - 2026-10-26
 
 ### Added

package/dist/cli-keyword-command.js

@@ -29,6 +29,8 @@ const runKeywordSearch = async (args, client, options, fail) => {
     const text = requireKeyword(args, fail, 'keyword search');
     return await client.keyword.search.query({
         text,
+        stage: keywordChoice(options.stage, KEYWORD_STAGES, 'stage', fail),
+        freshness: keywordChoice(options.freshness, KEYWORD_FRESHNESS, 'freshness', fail),
         cursor: options.cursor ? parseKeywordCursor(options.cursor, fail) : undefined,
         limit: parseIntegerOption({
             value: options.limit,
@@ -46,15 +48,23 @@ const requireKeyword = (args, fail, commandName) => {
     }
     return keyword;
 };
+const KEYWORD_STAGES = ['graduated', 'trial', 'dropped', 'untracked', 'all'];
+const KEYWORD_FRESHNESS = ['live', 'needsSync', 'syncing', 'all'];
+const keywordChoice = (value, choices, name, fail) => {
+    if (value === undefined)
+        return undefined;
+    const match = choices.find(candidate => candidate === value);
+    return match ?? fail('INVALID_INPUT', `--${name} must be ${choices.join(', ')}`);
+};
 const parseKeywordCursor = (value, fail) => {
     try {
         const parsed = JSON.parse(value);
         const key = parsed?.key;
         if (!Array.isArray(key) || key.length !== 7 || !key.slice(0, 6).every(part => typeof part === 'number' && Number.isFinite(part))
-            || typeof key[6] !== 'string' || typeof parsed.asOf !== 'string' || typeof parsed.trialTurn !== 'boolean'
+            || typeof key[6] !== 'string' || typeof parsed.asOf !== 'string'
             || (parsed.sort !== 'work' && parsed.sort !== 'newest'))
             return fail('INVALID_INPUT', '--cursor must be the JSON nextCursor from keyword search');
-        return { key: [key[0], key[1], key[2], key[3], key[4], key[5], key[6]], asOf: parsed.asOf, trialTurn: parsed.trialTurn, sort: parsed.sort };
+        return { key: [key[0], key[1], key[2], key[3], key[4], key[5], key[6]], asOf: parsed.asOf, sort: parsed.sort };
     }
     catch {
         return fail('INVALID_INPUT', '--cursor must be valid JSON');

package/dist/cli-options.d.ts

@@ -11,6 +11,8 @@ export interface CliOptionValues {
     includeOfficialBrands?: boolean;
     merch?: string;
     listingStatus?: string;
+    stage?: string;
+    freshness?: string;
     sort?: string;
     minBsr?: string;
     maxBsr?: string;

package/dist/index.js

@@ -51,6 +51,8 @@ const { positionals, values } = parseArgs({
         includeOfficialBrands: { type: 'boolean' },
         merch: { type: 'string' },
         listingStatus: { type: 'string' },
+        stage: { type: 'string' },
+        freshness: { type: 'string' },
         sort: { type: 'string' },
         minBsr: { type: 'string' },
         maxBsr: { type: 'string' },

package/dist/usage.js

@@ -61,6 +61,8 @@ export const printUsage = (paths) => {
         '  --facet <facet=name>     Repeat for facet filters',
         '  --merch <value>          true,false,unknown,all (default: true)',
         '  --listingStatus <value>  active,deleted,all (default: active)',
+        '  --stage <value>          Keyword search: graduated,trial,dropped,untracked,all (default: graduated)',
+        '  --freshness <value>      Keyword search: live,needsSync,syncing,all (default: all)',
         '  --includeOfficialBrands  Include known official brands in Product search',
         '  --stdin                  Read auth secret from standard input',
         '',
@@ -85,6 +87,7 @@ export const printUsage = (paths) => {
         '  rw product history B0DV53VS61 --bucket week',
         '  rw keyword get "retro gardening shirt"',
         '  rw keyword search "retro gardening" --limit 10',
+        '  rw keyword search "retro gardening" --stage trial',
         '  RR_STORAGE_DIR=~/.config/rankwrangler rw config show',
         '  rw --version',
         '  rw changelog',

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@rankwrangler/cli",
-    "version": "0.12.0",
+    "version": "0.13.0",
     "description": "Official RankWrangler command line interface",
     "repository": {
         "type": "git",
@@ -30,7 +30,7 @@
     },
     "dependencies": {
         "@merchbaseco/access": "0.4.0",
-        "@rankwrangler/http-client": "^0.12.0",
+        "@rankwrangler/http-client": "^0.13.0",
         "keytar": "7.9.0"
     },
     "devDependencies": {