@rankwrangler/cli 0.8.0 → 0.10.0

package/README.md

@@ -7,6 +7,7 @@ npm install -g @rankwrangler/cli
 
 rw auth set ak_...
 rw product get B0DV53VS61
+rw product get B0DV53VS61 --shortName
 rw product search "retro gardening shirt"
 rw product history B0DV53VS61 --bucket week
 rw keyword get "retro gardening shirt"
@@ -20,5 +21,7 @@ data and expose no refresh control; Product search retains its separate search c
 data contains `keyword`, `searchedAt`, and compact results with `organicSearchPlacement`. Output is
 a JSON `{ ok, data }` envelope; failures use `{ ok: false, error }` on stderr.
 The CLI does not expose Catalog, Operation, provider status, or polling commands.
+`--shortName` adds a nullable image-informed `listing.shortName` to a single Product get, waiting
+up to 20 seconds for generation and returning `null` if it is still running.
 
 See the [CLI reference](../../docs/reference/cli.md) for options and release workflow.

package/dist/CHANGELOG.md

@@ -2,6 +2,61 @@
 
 All notable changes to this project will be documented in this file.
 
+## v0.10.0 - 2026-10-20
+
+### Added
+
+- Add optional `include` on `product.get` for `marketData`, `shortName`, and `cutoutThumbnail`.
+  The default remains `marketData`.
+- Add image-informed design short names. A Product get that includes `shortName` waits up to 20
+  seconds. `rw product get <asin> --shortName` requests that include together with `marketData`.
+  The response carries `listing.shortName`, or `null` when no name is ready.
+- Add on-demand transparent 128×128 cutout thumbnails through `cutoutThumbnail` on that same
+  `include` list. RankWrangler centers the subject and reuses the cutout until the listing image
+  changes.
+- Advertise the website URL and a 128px icon in hosted MCP server info.
+- Name the stale ingestion check on `GET /api/health` when the service is degraded, and include
+  the deployed commit as `revision` on both health responses.
+
+### Changed
+
+- Breaking: replace `isUnavailable` with `amazonListingStatus` (`active` or `deleted`) on Product
+  listings, search results, and basic `getMany` results. A deleted listing keeps its last-known
+  title and thumbnail. `active` means the Amazon detail page exists. The dashboard marks deleted
+  listings.
+- Return last-known `getMany` listings immediately and refresh stale listings in the background.
+  Short names and cutouts stay on single Product get.
+
+### Fixed
+
+- Show the server error when the dashboard Products read fails, and reserve the empty catalog
+  state for a successful read with no rows.
+- Load the API usage card across the UTC day boundary.
+- Fail an Amazon Catalog read that does not start within 2 minutes with a retryable capacity
+  error.
+- Require a second overdue Product before Keepa or SP-API freshness degrades `GET /api/health`,
+  and wait out a top search terms report that is still pending.
+
+## v0.9.0 - 2026-08-09
+
+### Added
+
+- Add short-lived typed Provider-attempt telemetry for Keepa and SP-API operations, including
+  outcome, latency, and error context for operator diagnostics.
+
+### Changed
+
+- Breaking: replace the `product.getMany` available/unavailable result union with one fixed shape
+  containing identity, nullable title, resolved thumbnail, and `isUnavailable`. Unavailable Amazon
+  listings retain their last-known title and thumbnail data.
+
+### Fixed
+
+- Advertise Claude-compatible MCP Product and keyword schemas so fresh chats can discover and call
+  `getMany` directly, with clear unavailable-listing semantics in the Product tool description.
+- Stop unavailable Products from triggering automatic Keepa synchronization when their dashboard
+  drawer opens.
+
 ## v0.8.0 - 2026-08-09
 
 ### Added

package/dist/cli-options.d.ts

@@ -13,6 +13,7 @@ export interface CliOptionValues {
     bucket?: string;
     cursor?: string;
     refresh?: boolean;
+    shortName?: boolean;
     help?: boolean;
     version?: boolean;
 }

package/dist/cli-product-command.js

@@ -3,6 +3,9 @@ export const runProductCommand = async (command, client, config, options, fail)
     if (command.verb !== 'search' && options.refresh) {
         fail('INVALID_INPUT', '--refresh is only supported for product search');
     }
+    if (command.verb !== 'get' && options.shortName) {
+        fail('INVALID_INPUT', '--shortName is only supported for product get');
+    }
     if (command.verb === 'get') {
         return await runProductGet(command.args, client, config, options, fail);
     }
@@ -19,10 +22,14 @@ export const runProductCommand = async (command, client, config, options, fail)
 const runProductGet = async (args, client, config, options, fail) => {
     const marketplaceId = requireMarketplaceId(options, config);
     const asins = requireAsins(args, fail);
+    if (asins.length > 1 && options.shortName) {
+        fail('INVALID_INPUT', '--shortName requires exactly one ASIN');
+    }
     if (asins.length === 1) {
         return await client.product.get.mutate({
             marketplaceId,
             asin: asins[0],
+            ...(options.shortName ? { include: ['marketData', 'shortName'] } : {}),
         });
     }
     return await client.product.getMany.mutate({

package/dist/index.js

@@ -42,6 +42,7 @@ const { positionals, values } = parseArgs({
         bucket: { type: 'string' },
         cursor: { type: 'string' },
         refresh: { type: 'boolean' },
+        shortName: { type: 'boolean' },
         stdin: { type: 'boolean' },
     },
     allowPositionals: true,

package/dist/usage.js

@@ -39,6 +39,7 @@ export const printUsage = (paths) => {
         '  --baseUrl <origin>       Override API origin',
         `  -m, --marketplace <id>   Override marketplace (default: ${DEFAULT_MARKETPLACE_ID})`,
         '  --refresh                Product search refresh (separate Search contract)',
+        '  --shortName              Generate a design name for one Merch Product',
         '  --metrics <list>         Product history metrics: salesRank,price (default: salesRank,price)',
         '  --bucket <unit>          Product history buckets: auto,day,week,month (default: auto)',
         '  --days <N>               Product history lookback (30-3650, default: 365)',

package/package.json

@@ -1,7 +1,12 @@
 {
     "name": "@rankwrangler/cli",
-    "version": "0.8.0",
+    "version": "0.10.0",
     "description": "Official RankWrangler command line interface",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/merchbaseco/rankwrangler.git",
+        "directory": "packages/cli"
+    },
     "type": "module",
     "bin": {
         "rw": "dist/index.js",
@@ -24,8 +29,8 @@
         "provenance": true
     },
     "dependencies": {
-        "@merchbaseco/access": "0.3.0",
-        "@rankwrangler/http-client": "^0.8.0",
+        "@merchbaseco/access": "0.4.0",
+        "@rankwrangler/http-client": "^0.10.0",
         "keytar": "7.9.0"
     },
     "devDependencies": {

package/dist/history-response.d.ts

@@ -1,41 +0,0 @@
-export declare const HISTORY_METRIC_ALIASES: readonly ["bsr", "price"];
-export type HistoryMetricAlias = (typeof HISTORY_METRIC_ALIASES)[number];
-type HistoryPointTuple = [string, number | null] | [string, null, 1];
-export type AgentHistorySeries = {
-    bsr?: {
-        unit: 'rank';
-        category: {
-            id: number;
-            name: string | null;
-        } | null;
-        points: HistoryPointTuple[];
-    };
-    price?: {
-        unit: 'minorCurrency';
-        currencyCode: 'USD';
-        valueScale: 100;
-        points: HistoryPointTuple[];
-    };
-};
-export type AgentHistoryResponse = {
-    schemaVersion?: number;
-    status?: string;
-    syncTriggered: boolean;
-    latestImportAt: string | null;
-    series?: AgentHistorySeries;
-};
-export declare const buildCliHistoryResponse: ({ asin, marketplaceId, metrics, response, }: {
-    asin: string;
-    marketplaceId: string;
-    metrics: HistoryMetricAlias[];
-    response: AgentHistoryResponse;
-}) => {
-    schemaVersion: number;
-    asin: string;
-    marketplaceId: string;
-    status: string;
-    latestImportAt: string | null;
-    syncTriggered: boolean;
-    series: AgentHistorySeries;
-};
-export {};

package/dist/history-response.js

@@ -1,26 +0,0 @@
-export const HISTORY_METRIC_ALIASES = ['bsr', 'price'];
-export const buildCliHistoryResponse = ({ asin, marketplaceId, metrics, response, }) => {
-    const series = {
-        ...(metrics.includes('bsr') && response.series?.bsr ? { bsr: response.series.bsr } : {}),
-        ...(metrics.includes('price') && response.series?.price
-            ? { price: response.series.price }
-            : {}),
-    };
-    const hasAnyPoints = Object.values(series).some(metricSeries => metricSeries.points.length > 0);
-    const status = normalizeHistoryStatus(response.status);
-    return {
-        schemaVersion: response.schemaVersion ?? 1,
-        asin,
-        marketplaceId,
-        status: status ?? (response.syncTriggered ? 'collecting' : hasAnyPoints ? 'ready' : 'empty'),
-        latestImportAt: response.latestImportAt,
-        syncTriggered: response.syncTriggered,
-        series,
-    };
-};
-const normalizeHistoryStatus = (status) => {
-    if (status === 'ready' || status === 'collecting' || status === 'empty') {
-        return status;
-    }
-    return null;
-};