@purveyors/cli 0.23.0 → 0.25.0

package/README.md

@@ -2,7 +2,7 @@
 
 Coffee intelligence from your terminal.
 
-`purvey` is the official CLI for [purveyors.io](https://purveyors.io). It gives coffee professionals, developers, and AI agents direct access to the Purveyors platform from the terminal: catalog search, price-index snapshots, procurement brief reads, inventory tracking, roast logging, sales records, tasting notes, and Artisan `.alog` import.
+`purvey` is the official CLI for [purveyors.io](https://purveyors.io). It gives coffee professionals, developers, and AI agents direct access to the Purveyors platform from the terminal: catalog search, Market Index intelligence, price-index snapshots, procurement brief reads, inventory tracking, roast logging, sales records, tasting notes, and Artisan `.alog` import.
 
 Use `purvey --help` for quick command discovery, `purvey context` for the dense human-readable operator reference, `purvey manifest` for the preferred machine-readable contract, or `@purveyors/cli/manifest` in-process.
 
@@ -14,6 +14,7 @@ Use `purvey --help` for quick command discovery, `purvey context` for the dense
 - No pre-existing session required: `auth`, `config`, `context`, `manifest`
 - Viewer role required: `catalog` (excluding structured process filters on `catalog search`)
 - Member role required: `price-index`, `procurement`, `inventory`, `roast`, `sales`, `tasting`
+- Mixed public and entitled access: `market` public teaser slices are unauthenticated; filtered slices require Parchment Intelligence access
 - Preferred machine-readable contract: `purvey manifest`
 - Dense human-readable reference: `purvey context`
 - Compatibility JSON alias: `purvey context --json`
@@ -79,16 +80,19 @@ purvey catalog search --origin "Ethiopia" --stocked --pretty
 # Example with structured process filters and proof output
 purvey catalog search --origin "Ethiopia" --processing-base-method "Washed" --include-proof --pretty
 
-# 4. Check inventory (requires member role)
+# 4. Read a public Market Index teaser slice
+purvey market signals --summary --pretty
+
+# 5. Check inventory (requires member role)
 purvey inventory list --stocked --pretty
 
-# 5. Import a roast from Artisan
+# 6. Import a roast from Artisan
 purvey roast import ~/artisan/my-roast.alog --coffee-id 7 --pretty
 
-# 6. Get the machine-readable CLI contract
+# 7. Get the machine-readable CLI contract
 purvey manifest
 
-# 7. Get the dense readable CLI reference
+# 8. Get the dense readable CLI reference
 purvey context
 ```
 
@@ -109,13 +113,13 @@ The npm package is both a binary and a shared TypeScript product surface. `coffe
 | -------------------------- | ------------------------------------------------------------------------------------ |
 | `@purveyors/cli`           | CLI entrypoint package root                                                          |
 | `@purveyors/cli/catalog`   | Catalog search, lookup, stats, premium ranking, supplier aggregates, similar coffees |
+| `@purveyors/cli/market`    | Market Index value signals, movement stats, and metadata trends                      |
 | `@purveyors/cli/inventory` | Green coffee inventory operations                                                    |
 | `@purveyors/cli/roast`     | Roast profile operations                                                             |
 | `@purveyors/cli/sales`     | Sales record operations                                                              |
 | `@purveyors/cli/tasting`   | Tasting note and rating operations                                                   |
 | `@purveyors/cli/lib`       | Shared library helpers                                                               |
 | `@purveyors/cli/manifest`  | Stable machine-readable CLI manifest                                                 |
-| `@purveyors/cli/artisan`   | Artisan `.alog` parsing and import utilities                                         |
 | `@purveyors/cli/ai`        | AI helper surface used by CLI workflows                                              |
 
 Shell integrations should usually start with `purvey manifest`. In-process agent and website integrations should import the smallest relevant subpath instead of shelling out when they are already running in Node.js.
@@ -135,6 +139,7 @@ All remote data commands require a valid authenticated session:
 
 - `catalog` requires the `viewer` role by default
 - `catalog search` structured process filters require the `member` role under the current session-authenticated CLI path
+- `market` has public teaser slices for `signals --summary`, unfiltered retail `stats`, and process/retail/month `metadata`; all filtered or non-public slices require Parchment Intelligence access enforced server-side
 - `price-index`, `procurement`, `inventory`, `roast`, `sales`, and `tasting` require the `member` role under the session-authenticated CLI path
 
 `purvey` uses Google OAuth through purveyors.io.
@@ -179,6 +184,8 @@ Credentials are stored at `~/.config/purvey/credentials.json`.
 | `viewer` | `catalog search`, `catalog get`, `catalog stats`, excluding structured process filters                                                                                                                       |
 | `member` | All viewer commands, `catalog similar`, structured process filters on `catalog search`, plus `price-index`, `procurement`, `inventory`, `roast`, `sales`, `tasting` under the session-authenticated CLI path |
 
+Market Index teaser slices are public. Filtered `market signals`, origin/process/wholesale `market stats`, and non-public `market metadata` slices require Parchment Intelligence access; API-key and session-token denial is enforced by the canonical API.
+
 `auth`, `config`, `context`, and `manifest` remain available without a pre-existing session.
 
 Commands that require a higher role exit with code `3` on auth failure. That includes not being signed in, an expired session, or an insufficient role.
@@ -441,6 +448,58 @@ Notes:
 - Session-token use requires the local `member` role; API-key use is accepted via `PARCHMENT_API_KEY` or `PURVEYORS_API_KEY` and PPI entitlement is enforced server-side.
 - `PARCHMENT_API_BASE_URL` overrides the canonical API base for this SDK-backed command. `PURVEYORS_BASE_URL` is also accepted for shared environment compatibility.
 
+### market
+
+- `purvey market signals`
+- `purvey market stats`
+- `purvey market metadata`
+
+`market signals` filters:
+
+- `--summary`; public counts-only teaser slice
+- `--type <price_drop|below_market|value_quality>`; repeatable or comma-separated
+- `--origin <origin>`
+- `--process <method>`
+- `--market <retail|wholesale|all>`
+- `--min-discount <n>`
+- `--min-score <n>`
+- `--window <7d|30d>`
+- `--limit <n>`
+
+`market stats` filters:
+
+- `--origin <origin>`
+- `--process <method>`
+- `--market <retail|wholesale|all>`
+- `--window <7d|30d>`
+- `--baseline-weeks <n>`; 8-52
+
+`market metadata` filters:
+
+- `--dimension <process|disclosure|score>`
+- `--origin <origin>`
+- `--market <retail|wholesale|all>`
+- `--grain <week|month>`
+- `--from <YYYY-MM-DD>`
+- `--to <YYYY-MM-DD>`
+
+Examples:
+
+```bash
+purvey market signals --summary --pretty
+purvey market signals --type price_drop --origin "Ethiopia" --json
+purvey market stats --pretty
+purvey market metadata --dimension score --origin "Ethiopia" --grain month --json
+PARCHMENT_API_KEY="$PURVEYORS_API_KEY" purvey market signals --market wholesale --json
+```
+
+Notes:
+
+- `market` commands are backed by canonical Parchment API endpoints through `@purveyors/sdk`; the CLI does not compute Market Index intelligence locally.
+- Public teaser slices: `signals --summary`, `stats` with no origin/process and `market=retail`, and `metadata` at dimension=process/no-origin/market=retail/grain=month.
+- Any filtered or non-public market slice requires Parchment Intelligence access, enforced server-side for both API-key and session-token calls.
+- `--json` returns the API response verbatim.
+
 ### procurement
 
 - `purvey procurement list`
@@ -826,7 +885,7 @@ Use the right ID for the right command.
 - `PURVEYORS_BASE_URL`: override the Purveyors web base URL
 - `PURVEYORS_API_KEY`: API-key token used by API-backed catalog proof reads, paid-tier similarity reads, and SDK-backed Parchment commands when you want to call canonical API contracts without relying on the local OAuth session
 - `PARCHMENT_API_KEY`: preferred API-key variable for SDK-backed Parchment commands; also accepted for API-backed proof and paid-tier similarity paths
-- `PARCHMENT_API_BASE_URL`: override the SDK-backed Parchment API base URL for `price-index` and `procurement` commands
+- `PARCHMENT_API_BASE_URL`: override the SDK-backed Parchment API base URL for `market`, `price-index`, and `procurement` commands
 - `PURVEY_DEBUG`: enable verbose error output
 
 ## For AI agents
@@ -859,10 +918,10 @@ Agent integration rules of thumb:
 
 - Discover first with `purvey manifest`, then call the narrowest command or package subpath that fits the job.
 - Use `purvey context` when a human-readable operator summary is useful before tool selection.
-- Prefer OAuth session tokens for normal user workflows; use `PURVEYORS_API_KEY` or `PARCHMENT_API_KEY` only when you intentionally need an API-key-backed Parchment path such as catalog proof, paid-tier similarity, price-index, or procurement reads.
+- Prefer OAuth session tokens for normal user workflows; use `PURVEYORS_API_KEY` or `PARCHMENT_API_KEY` only when you intentionally need an API-key-backed Parchment path such as catalog proof, paid-tier similarity, market intelligence, price-index, or procurement reads.
 - Treat `--include-proof` as API output, not a local scoring feature. If a filter cannot round-trip through `/v1/catalog?include=proof`, the CLI rejects that invocation instead of returning misleading proof data.
 - Treat `catalog similar` as the canonical `/v1/catalog/{id}/similar` contract. Preserve the distinction between `canonical_candidates` and `similar_recommendations`; do not flatten or re-sort grouped results unless you have a specific downstream reason.
-- Treat `price-index` and `procurement` as SDK-backed canonical API reads. Do not add procurement create/write behavior to this command group until the Phase 2 write contract ships.
+- Treat `market`, `price-index`, and `procurement` as SDK-backed canonical API reads. Do not add procurement create/write behavior to this command group until the Phase 2 write contract ships.
 
 ## Troubleshooting
 

package/dist/commands/market.d.ts

@@ -0,0 +1,8 @@
+import { Command } from 'commander';
+/**
+ * `purvey market` — Market Index decision surface reads over the canonical API.
+ * Public teaser slices work unauthenticated; entitled slices require a session
+ * or API key with Parchment Intelligence, enforced server-side.
+ */
+export declare function buildMarketCommand(): Command;
+//# sourceMappingURL=market.d.ts.map

package/dist/commands/market.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"market.d.ts","sourceRoot":"","sources":["../../src/commands/market.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAgFpC;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,OAAO,CAyJ5C"}

package/dist/commands/market.js

@@ -0,0 +1,188 @@
+import { Command } from 'commander';
+import { outputData } from '../lib/output.js';
+import { withErrorHandling, PrvrsError } from '../lib/errors.js';
+import { createOptionalParchmentClient, unwrapParchment } from '../lib/parchment.js';
+const SIGNAL_TYPES = ['price_drop', 'below_market', 'value_quality'];
+const MARKETS = ['retail', 'wholesale', 'all'];
+const WINDOWS = ['7d', '30d'];
+const DIMENSIONS = ['process', 'disclosure', 'score'];
+const GRAINS = ['week', 'month'];
+function parsePositiveInt(rawValue, flag) {
+    const parsed = Number(rawValue.trim());
+    if (!Number.isInteger(parsed) || parsed <= 0) {
+        throw new PrvrsError('INVALID_ARGUMENT', `Invalid ${flag}: "${rawValue}". Must be a positive integer.`);
+    }
+    return parsed;
+}
+function parseIntRange(rawValue, flag, min, max) {
+    const parsed = parsePositiveInt(rawValue, flag);
+    if (parsed < min || parsed > max) {
+        throw new PrvrsError('INVALID_ARGUMENT', `Invalid ${flag}: "${rawValue}". Must be between ${min} and ${max}.`);
+    }
+    return parsed;
+}
+function parseNumber(rawValue, flag) {
+    const parsed = Number(rawValue.trim());
+    if (!Number.isFinite(parsed)) {
+        throw new PrvrsError('INVALID_ARGUMENT', `Invalid ${flag}: "${rawValue}". Must be a number.`);
+    }
+    return parsed;
+}
+function parseEnum(rawValue, flag, values) {
+    const value = rawValue.trim();
+    if (values.includes(value))
+        return value;
+    throw new PrvrsError('INVALID_ARGUMENT', `Invalid ${flag}: "${rawValue}". Must be one of: ${values.join(', ')}.`);
+}
+function parseIsoDate(rawValue, flag) {
+    const value = rawValue.trim();
+    if (!/^\d{4}-\d{2}-\d{2}$/.test(value)) {
+        throw new PrvrsError('INVALID_ARGUMENT', `Invalid ${flag}: "${rawValue}". Must be an ISO date (YYYY-MM-DD).`);
+    }
+    return value;
+}
+/** Repeatable/comma-separated `--type` collector preserving all requested types. */
+function collectSignalTypes(rawValue, previous) {
+    const parts = rawValue
+        .split(',')
+        .map((part) => part.trim())
+        .filter(Boolean);
+    for (const part of parts) {
+        if (!SIGNAL_TYPES.includes(part)) {
+            throw new PrvrsError('INVALID_ARGUMENT', `Invalid --type: "${part}". Must be one of: ${SIGNAL_TYPES.join(', ')}.`);
+        }
+    }
+    return [...previous, ...parts];
+}
+/**
+ * `purvey market` — Market Index decision surface reads over the canonical API.
+ * Public teaser slices work unauthenticated; entitled slices require a session
+ * or API key with Parchment Intelligence, enforced server-side.
+ */
+export function buildMarketCommand() {
+    const market = new Command('market').description('Market Index decision surface: value signals, movement stats, and metadata trends');
+    // market signals
+    market
+        .command('signals')
+        .description('Actionable market value signals (public summary via --summary)')
+        .option('--summary', 'Return the unfiltered public signal summary (counts only; no auth needed)')
+        .option('--type <type>', 'Signal type filter; repeatable or comma-separated (price_drop|below_market|value_quality)', collectSignalTypes, [])
+        .option('--origin <origin>', 'Filter by origin')
+        .option('--process <method>', 'Filter by process bucket')
+        .option('--market <retail|wholesale|all>', 'Market scope')
+        .option('--min-discount <n>', 'Minimum signal magnitude / discount percent')
+        .option('--min-score <n>', 'Minimum score_value')
+        .option('--window <7d|30d>', 'Trailing window')
+        .option('--limit <n>', 'Results per page')
+        .addHelpText('after', `
+Examples:
+  purvey market signals --summary --pretty
+  purvey market signals --type price_drop --type below_market --origin "Ethiopia" --json
+  purvey market signals --market wholesale --min-discount 10 --window 7d --json
+
+Notes:
+  --summary is the only unauthenticated slice; any filter requires Parchment Intelligence access.
+  Related: 'purvey market stats' (movement significance), 'purvey price-index' (aggregate snapshots).
+  Set PARCHMENT_API_KEY or PURVEYORS_API_KEY to use an API key instead of the logged-in session.`)
+        .action(withErrorHandling(async (opts, cmd) => {
+        const globalOpts = cmd.optsWithGlobals();
+        const query = {};
+        if (opts.summary === true)
+            query.summary = 'true';
+        const types = opts.type;
+        if (types.length > 0)
+            query.type = types;
+        if (opts.origin !== undefined)
+            query.origin = opts.origin;
+        if (opts.process !== undefined)
+            query.process = opts.process;
+        if (opts.market !== undefined)
+            query.market = parseEnum(opts.market, '--market', MARKETS);
+        if (opts.minDiscount !== undefined)
+            query.min_discount_pct = parseNumber(opts.minDiscount, '--min-discount');
+        if (opts.minScore !== undefined)
+            query.min_score = parseNumber(opts.minScore, '--min-score');
+        if (opts.window !== undefined)
+            query.window = parseEnum(opts.window, '--window', WINDOWS);
+        if (opts.limit !== undefined)
+            query.limit = parsePositiveInt(opts.limit, '--limit');
+        const client = await createOptionalParchmentClient();
+        const data = unwrapParchment(await client.market.signals(query), 'market signals');
+        outputData(data, globalOpts);
+    }));
+    // market stats
+    market
+        .command('stats')
+        .description('Price movement-significance stats (public retail summary works unauthenticated)')
+        .option('--origin <origin>', 'Filter by origin')
+        .option('--process <method>', 'Filter by process bucket')
+        .option('--market <retail|wholesale|all>', 'Market scope')
+        .option('--window <7d|30d>', 'Move window')
+        .option('--baseline-weeks <n>', 'Baseline weeks (8-52)')
+        .addHelpText('after', `
+Examples:
+  purvey market stats --pretty
+  purvey market stats --origin "Colombia" --window 30d --json
+  purvey market stats --market wholesale --baseline-weeks 12 --json
+
+Notes:
+  The unfiltered retail slice is public; origin/process/wholesale filters require Intelligence access.
+  Related: 'purvey price-index' (aggregate price snapshots the moves are derived from).`)
+        .action(withErrorHandling(async (opts, cmd) => {
+        const globalOpts = cmd.optsWithGlobals();
+        const query = {};
+        if (opts.origin !== undefined)
+            query.origin = opts.origin;
+        if (opts.process !== undefined)
+            query.process = opts.process;
+        if (opts.market !== undefined)
+            query.market = parseEnum(opts.market, '--market', MARKETS);
+        if (opts.window !== undefined)
+            query.window = parseEnum(opts.window, '--window', WINDOWS);
+        if (opts.baselineWeeks !== undefined)
+            query.baseline_weeks = parseIntRange(opts.baselineWeeks, '--baseline-weeks', 8, 52);
+        const client = await createOptionalParchmentClient();
+        const data = unwrapParchment(await client.priceIndex.stats(query), 'market stats');
+        outputData(data, globalOpts);
+    }));
+    // market metadata
+    market
+        .command('metadata')
+        .description('Metadata-trend index (public process/retail/month slice works unauthenticated)')
+        .option('--dimension <process|disclosure|score>', 'Metadata dimension (default process)')
+        .option('--origin <origin>', 'Filter by origin')
+        .option('--market <retail|wholesale|all>', 'Market scope')
+        .option('--grain <week|month>', 'Time grain')
+        .option('--from <date>', 'Include periods on/after this ISO date (YYYY-MM-DD)')
+        .option('--to <date>', 'Include periods on/before this ISO date (YYYY-MM-DD)')
+        .addHelpText('after', `
+Examples:
+  purvey market metadata --pretty
+  purvey market metadata --dimension score --origin "Ethiopia" --grain month --json
+  purvey market metadata --dimension disclosure --from 2026-04-01 --to 2026-07-01 --json
+
+Notes:
+  Public slice is dimension=process, no origin, market=retail, grain=month; anything else requires Intelligence access.
+  cultivar and drying dimensions are out of scope for v1 (await taxonomy normalization).`)
+        .action(withErrorHandling(async (opts, cmd) => {
+        const globalOpts = cmd.optsWithGlobals();
+        const query = {};
+        if (opts.dimension !== undefined)
+            query.dimension = parseEnum(opts.dimension, '--dimension', DIMENSIONS);
+        if (opts.origin !== undefined)
+            query.origin = opts.origin;
+        if (opts.market !== undefined)
+            query.market = parseEnum(opts.market, '--market', MARKETS);
+        if (opts.grain !== undefined)
+            query.grain = parseEnum(opts.grain, '--grain', GRAINS);
+        if (opts.from !== undefined)
+            query.from = parseIsoDate(opts.from, '--from');
+        if (opts.to !== undefined)
+            query.to = parseIsoDate(opts.to, '--to');
+        const client = await createOptionalParchmentClient();
+        const data = unwrapParchment(await client.market.metadataIndex(query), 'market metadata');
+        outputData(data, globalOpts);
+    }));
+    return market;
+}
+//# sourceMappingURL=market.js.map

package/dist/commands/market.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"market.js","sourceRoot":"","sources":["../../src/commands/market.ts"],"names":[],"mappings":"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"}

package/dist/lib/index.d.ts

@@ -1,6 +1,7 @@
 export * from './catalog.js';
 export * from './inventory.js';
 export * from './manifest.js';
+export * from './market.js';
 export * from './roast.js';
 export * from './sales.js';
 export * from './tasting.js';

package/dist/lib/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":"AAMA,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":"AAMA,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC"}

package/dist/lib/index.js

@@ -6,6 +6,7 @@
 export * from './catalog.js';
 export * from './inventory.js';
 export * from './manifest.js';
+export * from './market.js';
 export * from './roast.js';
 export * from './sales.js';
 export * from './tasting.js';

package/dist/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,2EAA2E;AAC3E,qCAAqC;AACrC,2DAA2D;AAC3D,6DAA6D;AAE7D,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,2EAA2E;AAC3E,qCAAqC;AACrC,2DAA2D;AAC3D,6DAA6D;AAE7D,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC"}

package/dist/lib/manifest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/lib/manifest.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/lib/manifest.ts"],"names":[],"mappings":"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"}

package/dist/lib/manifest.js

@@ -859,6 +859,83 @@ const commandGroups = [
             examples: ['purvey manifest', 'purvey manifest --pretty'],
         },
     },
+    {
+        name: 'market',
+        summary: 'Market Index decision surface: value signals, movement stats, and metadata trends via the canonical API',
+        auth: 'mixed',
+        subcommands: [
+            {
+                name: 'signals',
+                summary: 'Actionable market value signals; unfiltered summary is a public teaser',
+                auth: 'none',
+                options: [
+                    { flags: '--summary' },
+                    {
+                        flags: '--type <type>',
+                        notes: ['repeatable or comma-separated: price_drop|below_market|value_quality'],
+                    },
+                    { flags: '--origin <origin>' },
+                    { flags: '--process <method>' },
+                    { flags: '--market <retail|wholesale|all>' },
+                    { flags: '--min-discount <n>' },
+                    { flags: '--min-score <n>' },
+                    { flags: '--window <7d|30d>' },
+                    { flags: '--limit <n>' },
+                ],
+                notes: [
+                    'Backed by the canonical API GET /v1/market/signals via @purveyors/sdk against api.purveyors.io.',
+                    '--summary is the only unauthenticated slice (counts only); any filter requires Parchment Intelligence access, enforced server-side (403 on denial).',
+                    '--json emits the API response verbatim (§3.3 evidence object, §3.4 enums); no client-side reshaping.',
+                ],
+                examples: [
+                    'purvey market signals --summary --pretty',
+                    'purvey market signals --type price_drop --type below_market --origin "Ethiopia" --json',
+                ],
+            },
+            {
+                name: 'stats',
+                summary: 'Price movement-significance stats; unfiltered retail slice is public',
+                auth: 'none',
+                options: [
+                    { flags: '--origin <origin>' },
+                    { flags: '--process <method>' },
+                    { flags: '--market <retail|wholesale|all>' },
+                    { flags: '--window <7d|30d>' },
+                    { flags: '--baseline-weeks <n>' },
+                ],
+                notes: [
+                    'Backed by the canonical API GET /v1/price-index/stats via @purveyors/sdk.',
+                    'The no-origin/no-process retail slice is public; origin/process/wholesale filters require Intelligence access.',
+                ],
+                examples: [
+                    'purvey market stats --pretty',
+                    'purvey market stats --origin "Colombia" --window 30d --json',
+                ],
+            },
+            {
+                name: 'metadata',
+                summary: 'Metadata-trend index; process/retail/month slice is public',
+                auth: 'none',
+                options: [
+                    { flags: '--dimension <process|disclosure|score>' },
+                    { flags: '--origin <origin>' },
+                    { flags: '--market <retail|wholesale|all>' },
+                    { flags: '--grain <week|month>' },
+                    { flags: '--from <date>' },
+                    { flags: '--to <date>' },
+                ],
+                notes: [
+                    'Backed by the canonical API GET /v1/market/metadata-index via @purveyors/sdk.',
+                    'Public slice: dimension=process, no origin, market=retail, grain=month; anything else requires Intelligence access.',
+                    'cultivar and drying dimensions are out of scope for v1 (await taxonomy normalization).',
+                ],
+                examples: [
+                    'purvey market metadata --pretty',
+                    'purvey market metadata --dimension score --origin "Ethiopia" --grain month --json',
+                ],
+            },
+        ],
+    },
     {
         name: 'price-index',
         summary: 'Parchment Price Index aggregate snapshots; requires price-index (PPI) access',
@@ -1106,12 +1183,18 @@ function renderRoles(roleContracts, groups) {
         .filter((group) => group.auth === 'none' && group.name !== 'auth')
         .map((group) => group.name)
         .sort();
+    const mixedAccessCommands = groups
+        .filter((group) => group.auth === 'mixed')
+        .map((group) => group.name)
+        .sort();
     return [
         'ROLES',
         '-----',
         `No pre-existing session required for: ${unauthenticatedCommands.join(', ')}.`,
         `Local-only commands: ${localOnlyCommands.join(', ')}.`,
-        'Commands that talk to purveyors.io require authentication, except for the auth commands that establish or inspect a session.',
+        `Mixed public and entitled access: ${mixedAccessCommands.join(', ')}.`,
+        'Mixed-access public teaser slices can run without a session; filtered or non-public slices require server-side entitlements.',
+        'Commands that talk to purveyors.io generally require authentication unless listed above as public, local-only, or mixed-access teaser slices.',
         ...roleContracts.map((role) => `${role.role.padEnd(7, ' ')} ${role.description}`),
         '',
         'Both roles are granted on sign-in through purveyors.io.',